src/metadata.ts

import process from 'node:process';

export const TEMPLATE_AGENT_ID = 'sin-backend';
export const TEMPLATE_AGENT_NAME = 'SIN-Backend';
export const TEMPLATE_AGENT_DESCRIPTION = 'Structural backend implementation and service delivery agent.';
export const TEMPLATE_AGENT_VERSION = '2026.03.09';
export const TEMPLATE_AGENT_DEFAULT_HOST = '127.0.0.1';
export const TEMPLATE_AGENT_DEFAULT_PORT = 47108;

export const TEMPLATE_AGENT_SKILLS = [
  {
    id: 'sin.backend.health',
    name: 'Health',
    description: 'Check base agent readiness and identity.',
  },
  {
    id: 'sin.backend.onboarding.status',
    name: 'Onboarding Status',
    description: 'Read persisted onboarding state.',
  },
  {
    id: 'sin.backend.onboarding.save',
    name: 'Onboarding Save',
    description: 'Persist onboarding defaults for future autonomous runs.',
  },
] as const;

export function resolveTemplateAgentConfig() {
  const host =
    process.env.SIN_BACKEND_HOST?.trim() ||
    (process.env.PORT ? '0.0.0.0' : process.env.HOST?.trim() || TEMPLATE_AGENT_DEFAULT_HOST);
  const port = parseInteger(process.env.SIN_BACKEND_PORT, parseInteger(process.env.PORT, TEMPLATE_AGENT_DEFAULT_PORT));
  const fallbackPublicHost = host === '0.0.0.0' ? '127.0.0.1' : host;
  const publicBaseUrl =
    process.env.SIN_BACKEND_PUBLIC_BASE_URL?.trim() ||
    (process.env.SPACE_HOST?.trim() ? `https://${process.env.SPACE_HOST.trim()}` : `http://${fallbackPublicHost}:${port}`);
  return { host, port, publicBaseUrl: publicBaseUrl.replace(/\/+$/, '') };
}

export function buildAgentCard(baseUrl: string) {
  const normalizedBaseUrl = baseUrl.replace(/\/+$/, '');
  const rpcUrl = `${normalizedBaseUrl}/a2a/v1`;
  return {
    name: TEMPLATE_AGENT_NAME,
    description: TEMPLATE_AGENT_DESCRIPTION,
    version: TEMPLATE_AGENT_VERSION,
    documentationUrl: normalizedBaseUrl,
    url: rpcUrl,
    capabilities: { streaming: false, pushNotifications: false },
    defaultInputModes: ['text/plain', 'application/json'],
    defaultOutputModes: ['text/plain', 'application/json'],
    skills: [...TEMPLATE_AGENT_SKILLS],
    supportedInterfaces: [{ url: rpcUrl, protocolBinding: 'JSONRPC', protocolVersion: '1.0' }],
  };
}

function parseInteger(input: string | undefined, fallback: number) {
  const parsed = Number.parseInt(String(input || '').trim(), 10);
  return Number.isFinite(parsed) ? parsed : fallback;
}