@finalai/agents 0.11.0 → 0.12.0

package/dist/modules/cli/cli.mjs

@@ -1,60 +1,42 @@
-import { resolve } from "node:path";
 import { parseArgs } from "node:util";
+import { documentOf } from "@finalai/agent-definition";
 import * as z from "zod";
-import { createClient } from "../agent-client/client.mjs";
-import { runChannelInstall } from "./channel-install.mjs";
-import { runBuild } from "./build.mjs";
+import { createClient, DEFAULT_AGENTS_HOST } from "../agent-client/client.mjs";
+import { DefinitionKind, loadDefinitionModule } from "./agent-module.mjs";
 import { runConformance } from "./conformance.mjs";
-import { DEFAULT_DEV_PORT, runDev } from "./dev.mjs";
-import { gitListFiles } from "./files.mjs";
-import { runPublish } from "./publish.mjs";
-const DEFAULT_AGENTS_HOST = "https://agent-session.final.ai/api";
-const DEFAULT_COMMIT_MESSAGE = "Publish with final agents publish";
+import { errorLines } from "./output.mjs";
 const USAGE = [
   "usage: final-agents <command> [options]",
   "",
   "commands:",
-  "  build [dir]                       compile the agent directory and report on its harness",
-  "  dev [dir]                         serve its channel routes at http://localhost:<port>/<channel><path>",
-  "  publish [dir] --agent <slug>      commit the checkout to the agent and publish it",
-  "  channel install <key> --revision <id> --project <id> --install <id> [--replace]   install or explicitly update a published channel",
+  "  print <module>                    write the document of the agent, harness or ACP adapter",
+  "                                    the module exports, as JSON",
+  "  publish <module> --name <name>    store it and point <name> at it in a project",
   "  conformance <module>              run the harness conformance kit against a harness the module exports",
   "",
   "options:",
-  "  --host <url>        agent platform API (overrides FINAL_API_HOST; default " + DEFAULT_AGENTS_HOST + ")",
-  "  --agent <slug>      publish: the agent definition (slug or id)",
-  "  --ref <ref>         publish: the ref to publish (GitHub-backed agents)",
-  "  --message <text>    publish: commit message",
-  "  --note <text>       publish: revision note",
-  "  --no-activate       publish: store approved source without changing the live agent",
-  "  --replace           channel install: explicitly update the existing binding",
-  `  --port <port>       dev: port to listen on (default ${DEFAULT_DEV_PORT})`,
-  '  --export <name>     conformance: the export to test (default "default"): a HarnessIface or { harness, dial }',
-  "  --profile <name>    conformance: final (default) or plain-acp-v2",
+  "  --export <name>     the export to use (print and publish: an agent, a harness or an ACP adapter,",
+  "                      found by itself when omitted;",
+  '                      conformance: a HarnessIface or { harness, dial }, default "default")',
+  "  --name <name>       publish: the name to point at it",
+  "  --project <id>      publish: the project (overrides FINAL_PROJECT_ID)",
+  "  --host <url>        agents API (overrides FINAL_API_HOST; default " + DEFAULT_AGENTS_HOST + ")",
+  "  --profile <name>    conformance: final (default), final-required (ACP adapters) or plain-acp-v2",
   "  --timeout <ms>      conformance: per-case timeout",
   "  --json              conformance: print the report as JSON",
   "",
-  "FINAL_API_KEY authenticates. build checks compatibility only with it.",
-  "FINAL_API_HOST selects the deployment for build and publish; it does not rewrite authored URLs.",
-  `dev reads route secrets from AGENT_LOCAL_SECRETS_JSON ({"name": "value"}), limited to the manifest's secrets.`
+  "publish authenticates with FINAL_API_KEY. print calls nothing."
 ].join("\n");
 const envSchema = z.object({
   FINAL_API_KEY: z.string().min(1).optional(),
-  FINAL_API_HOST: z.string().url().optional()
+  FINAL_API_HOST: z.string().url().optional(),
+  FINAL_PROJECT_ID: z.string().min(1).optional()
 });
 const optionsConfig = {
-  host: { type: "string" },
-  agent: { type: "string" },
-  ref: { type: "string" },
-  message: { type: "string" },
-  note: { type: "string" },
-  "no-activate": { type: "boolean" },
-  port: { type: "string" },
-  project: { type: "string" },
-  install: { type: "string" },
-  replace: { type: "boolean" },
-  revision: { type: "string" },
   export: { type: "string" },
+  name: { type: "string" },
+  project: { type: "string" },
+  host: { type: "string" },
   profile: { type: "string" },
   timeout: { type: "string" },
   json: { type: "boolean" },
@@ -77,101 +59,32 @@ const runAgentsCommand = async (deps) => {
     return 2;
   }
   const { values, positionals } = parsedArgs.parsed;
-  const [command, dirArg, ...extra] = positionals;
+  const [command, moduleArg, ...extra] = positionals;
   if (values.help === true || command == null || command === "help") {
     (command == null && values.help !== true ? output.stderr : output.stdout)(USAGE);
     return command == null && values.help !== true ? 2 : 0;
   }
-  if (extra.length > 0 && !(command === "channel" && dirArg === "install" && extra.length === 1)) {
+  if (extra.length > 0) {
     output.stderr(`error: unexpected arguments: ${extra.join(" ")}`);
     return 2;
   }
-  const env = envSchema.safeParse(deps.env);
-  if (!env.success) {
-    output.stderr(
-      "error: FINAL_API_KEY must be nonempty and FINAL_API_HOST must be an absolute URL"
-    );
+  if (command !== "print" && command !== "publish" && command !== "conformance") {
+    output.stderr(`error: unknown command ${command}`);
+    output.stderr(USAGE);
     return 2;
   }
-  const apiKey = env.success ? env.data.FINAL_API_KEY ?? null : null;
-  const dir = resolve(deps.cwd, dirArg ?? ".");
-  const client = (key) => createClient({
-    host: values.host ?? env.data.FINAL_API_HOST ?? DEFAULT_AGENTS_HOST,
-    auth: { apiKey: key },
-    fetch: deps.fetch
-  });
-  if (command === "channel") {
-    const channelKey = extra[0];
-    if (dirArg !== "install" || channelKey == null || values.revision == null || values.project == null || values.install == null) {
-      output.stderr(
-        "error: channel install needs <key> --revision <id> --project <id> --install <id>"
-      );
-      return 2;
-    }
-    if (apiKey == null) {
-      output.stderr("error: set FINAL_API_KEY to a Final API key");
-      return 2;
-    }
-    return runChannelInstall({
-      channelKey,
-      revisionId: values.revision,
-      replace: values.replace,
-      projectId: values.project,
-      connectorInstallId: values.install,
-      client: client(apiKey),
-      output
-    });
-  }
-  if (command === "build") {
-    return runBuild({ dir, client: apiKey == null ? null : client(apiKey), output });
-  }
-  if (command === "dev") {
-    const port = values.port == null ? DEFAULT_DEV_PORT : Number(values.port);
-    if (!Number.isInteger(port) || port < 0 || port > 65535) {
-      output.stderr(`error: --port must be a port number`);
-      return 2;
-    }
-    return runDev({
-      dir,
-      port,
-      env: deps.env,
-      output,
-      signal: deps.signal ?? new AbortController().signal
-    });
-  }
-  if (command === "publish") {
-    if (values.agent == null) {
-      output.stderr("error: publish needs --agent <slug>");
-      return 2;
-    }
-    if (apiKey == null) {
-      output.stderr("error: set FINAL_API_KEY to a Final API key");
-      return 2;
-    }
-    return runPublish({
-      dir,
-      agent: values.agent,
-      ref: values.ref ?? null,
-      message: values.message ?? DEFAULT_COMMIT_MESSAGE,
-      note: values.note ?? null,
-      activate: values["no-activate"] === true ? false : void 0,
-      client: client(apiKey),
-      listFiles: deps.listFiles ?? gitListFiles,
-      output
-    });
+  if (moduleArg == null) {
+    output.stderr(`error: ${command} needs <module>`);
+    return 2;
   }
   if (command === "conformance") {
-    if (dirArg == null) {
-      output.stderr("error: conformance needs <module>");
-      return 2;
-    }
     const timeoutMs = values.timeout == null ? null : Number(values.timeout);
     if (timeoutMs != null && (!Number.isInteger(timeoutMs) || timeoutMs <= 0)) {
       output.stderr("error: --timeout must be a positive number of milliseconds");
       return 2;
     }
     return runConformance({
-      module: dirArg,
+      module: moduleArg,
       exportName: values.export ?? "default",
       profile: values.profile ?? "final",
       timeoutMs,
@@ -182,12 +95,73 @@ const runAgentsCommand = async (deps) => {
       signal: deps.signal
     });
   }
-  output.stderr(`error: unknown command ${command}`);
-  output.stderr(USAGE);
-  return 2;
+  const env = envSchema.safeParse(deps.env);
+  if (!env.success) {
+    output.stderr(
+      "error: FINAL_API_KEY must be nonempty and FINAL_API_HOST must be an absolute URL"
+    );
+    return 2;
+  }
+  const loaded = await loadDefinitionModule({
+    module: moduleArg,
+    exportName: values.export ?? null,
+    cwd: deps.cwd,
+    importModule: deps.importModule,
+    documentOf: deps.documentOf ?? documentOf
+  });
+  if (!loaded.ok) {
+    output.stderr(`error: ${loaded.message}`);
+    return 1;
+  }
+  if (command === "print") {
+    output.stdout(JSON.stringify(loaded.document, null, 2));
+    return 0;
+  }
+  if (values.name == null) {
+    output.stderr("error: publish needs --name <name>");
+    return 2;
+  }
+  const projectId = values.project ?? env.data.FINAL_PROJECT_ID;
+  if (projectId == null) {
+    output.stderr("error: publish needs --project <id> or FINAL_PROJECT_ID");
+    return 2;
+  }
+  const apiKey = env.data.FINAL_API_KEY;
+  if (apiKey == null) {
+    output.stderr("error: set FINAL_API_KEY to a Final API key");
+    return 2;
+  }
+  const agentDocument = loaded.kind === DefinitionKind.Agent ? loaded.document : null;
+  const client = createClient({
+    host: values.host ?? env.data.FINAL_API_HOST ?? DEFAULT_AGENTS_HOST,
+    auth: { apiKey },
+    fetch: deps.fetch,
+    localCompute: false,
+    // The document is already made; publishing sends exactly it.
+    agentCodec: {
+      documentOf: () => {
+        if (agentDocument == null) throw new Error("Only an agent has an agent document");
+        return agentDocument;
+      },
+      inProcessCodeOf: () => ({ tools: {}, hooks: {}, approvals: {} })
+    }
+  });
+  try {
+    const project = client.project({ id: projectId });
+    const name = values.name;
+    const signal = deps.signal;
+    const published = loaded.kind === DefinitionKind.Agent ? await project.agents.publish({ agent: loaded.agent, name, signal }) : loaded.kind === DefinitionKind.Harness ? await project.harnesses.publish({ harness: loaded.document, name, signal }) : await project.acpAdapters.publish({ adapter: loaded.document, name, signal });
+    output.stdout(`published ${published.name}: ${published.hash}`);
+    if ("id" in published && published.id != null) output.stdout(`id: ${published.id}`);
+    return 0;
+  } catch (cause) {
+    for (const line of errorLines(cause)) output.stderr(line);
+    return 1;
+  } finally {
+    client.close();
+  }
 };
 export {
-  DEFAULT_AGENTS_HOST,
   runAgentsCommand
 };
 //# sourceMappingURL=cli.mjs.map

package/dist/modules/cli/cli.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/cli.ts"],
-  "sourcesContent": ["import { resolve } from 'node:path';\nimport { parseArgs } from 'node:util';\nimport * as z from 'zod';\nimport { createClient, type AgentClientIface } from \"../agent-client/client.mjs\";\nimport type { FetchIface } from \"../agent-client/http.mjs\";\nimport { runChannelInstall } from \"./channel-install.mjs\";\nimport { runBuild } from \"./build.mjs\";\nimport { runConformance, type ImportModule } from \"./conformance.mjs\";\nimport { DEFAULT_DEV_PORT, runDev } from \"./dev.mjs\";\nimport { gitListFiles, type ListFiles } from \"./files.mjs\";\nimport type { OutputIface } from \"./output.mjs\";\nimport { runPublish } from \"./publish.mjs\";\n\n// Agent CLI commands:\n// `build` and `publish`, plus `dev` and `conformance`. Shipped as the `final-agents` bin until a general\n// `final` CLI exists; `runAgentsCommand` is what `final agents` would mount.\n\n// The agents API, authenticated with FINAL_API_KEY.\nexport const DEFAULT_AGENTS_HOST = 'https://agent-session.final.ai/api';\n\nconst DEFAULT_COMMIT_MESSAGE = 'Publish with final agents publish';\n\nconst USAGE = [\n  'usage: final-agents <command> [options]',\n  '',\n  'commands:',\n  '  build [dir]                       compile the agent directory and report on its harness',\n  '  dev [dir]                         serve its channel routes at http://localhost:<port>/<channel><path>',\n  '  publish [dir] --agent <slug>      commit the checkout to the agent and publish it',\n  '  channel install <key> --revision <id> --project <id> --install <id> [--replace]   install or explicitly update a published channel',\n  '  conformance <module>              run the harness conformance kit against a harness the module exports',\n  '',\n  'options:',\n  '  --host <url>        agent platform API (overrides FINAL_API_HOST; default ' +\n    DEFAULT_AGENTS_HOST +\n    ')',\n  '  --agent <slug>      publish: the agent definition (slug or id)',\n  '  --ref <ref>         publish: the ref to publish (GitHub-backed agents)',\n  '  --message <text>    publish: commit message',\n  '  --note <text>       publish: revision note',\n  '  --no-activate       publish: store approved source without changing the live agent',\n  '  --replace           channel install: explicitly update the existing binding',\n  `  --port <port>       dev: port to listen on (default ${DEFAULT_DEV_PORT})`,\n  '  --export <name>     conformance: the export to test (default \"default\"): a HarnessIface or { harness, dial }',\n  '  --profile <name>    conformance: final (default) or plain-acp-v2',\n  '  --timeout <ms>      conformance: per-case timeout',\n  '  --json              conformance: print the report as JSON',\n  '',\n  'FINAL_API_KEY authenticates. build checks compatibility only with it.',\n  'FINAL_API_HOST selects the deployment for build and publish; it does not rewrite authored URLs.',\n  'dev reads route secrets from AGENT_LOCAL_SECRETS_JSON ({\"name\": \"value\"}), limited to the manifest\\'s secrets.',\n].join('\\n');\n\nconst envSchema = z.object({\n  FINAL_API_KEY: z.string().min(1).optional(),\n  FINAL_API_HOST: z.string().url().optional(),\n});\n\nexport interface AgentsCliDepsIface {\n  argv: string[];\n  env: Record<string, string | undefined>;\n  cwd: string;\n  output: OutputIface;\n  // Seams: API requests and the checkout's file listing.\n  fetch?: FetchIface;\n  listFiles?: ListFiles;\n  // Ends long-running commands (dev); main.ts aborts it on SIGINT and SIGTERM.\n  signal?: AbortSignal;\n  // Seam: loads the conformance module (dynamic import by file URL).\n  importModule?: ImportModule;\n}\n\nconst optionsConfig = {\n  host: { type: 'string' },\n  agent: { type: 'string' },\n  ref: { type: 'string' },\n  message: { type: 'string' },\n  note: { type: 'string' },\n  'no-activate': { type: 'boolean' },\n  port: { type: 'string' },\n  project: { type: 'string' },\n  install: { type: 'string' },\n  replace: { type: 'boolean' },\n  revision: { type: 'string' },\n  export: { type: 'string' },\n  profile: { type: 'string' },\n  timeout: { type: 'string' },\n  json: { type: 'boolean' },\n  help: { type: 'boolean', short: 'h' },\n} as const;\n\nconst parseCommandLine = (argv: string[]) =>\n  parseArgs({ args: argv, options: optionsConfig, allowPositionals: true });\n\ntype ParsedResult =\n  | { ok: true; parsed: ReturnType<typeof parseCommandLine> }\n  | { ok: false; message: string };\n\nconst parse = (argv: string[]): ParsedResult => {\n  try {\n    return { ok: true, parsed: parseCommandLine(argv) };\n  } catch (cause) {\n    return { ok: false, message: cause instanceof Error ? cause.message : String(cause) };\n  }\n};\n\nexport const runAgentsCommand = async (deps: AgentsCliDepsIface): Promise<number> => {\n  const { output } = deps;\n  const parsedArgs = parse(deps.argv);\n  if (!parsedArgs.ok) {\n    output.stderr(`error: ${parsedArgs.message}`);\n    output.stderr(USAGE);\n    return 2;\n  }\n  const { values, positionals } = parsedArgs.parsed;\n  const [command, dirArg, ...extra] = positionals;\n  if (values.help === true || command == null || command === 'help') {\n    (command == null && values.help !== true ? output.stderr : output.stdout)(USAGE);\n    return command == null && values.help !== true ? 2 : 0;\n  }\n  if (extra.length > 0 && !(command === 'channel' && dirArg === 'install' && extra.length === 1)) {\n    output.stderr(`error: unexpected arguments: ${extra.join(' ')}`);\n    return 2;\n  }\n  const env = envSchema.safeParse(deps.env);\n  if (!env.success) {\n    output.stderr(\n      'error: FINAL_API_KEY must be nonempty and FINAL_API_HOST must be an absolute URL',\n    );\n    return 2;\n  }\n  const apiKey = env.success ? (env.data.FINAL_API_KEY ?? null) : null;\n  const dir = resolve(deps.cwd, dirArg ?? '.');\n  const client = (key: string): AgentClientIface =>\n    createClient({\n      host: values.host ?? env.data.FINAL_API_HOST ?? DEFAULT_AGENTS_HOST,\n      auth: { apiKey: key },\n      fetch: deps.fetch,\n    });\n\n  if (command === 'channel') {\n    const channelKey = extra[0];\n    if (\n      dirArg !== 'install' ||\n      channelKey == null ||\n      values.revision == null ||\n      values.project == null ||\n      values.install == null\n    ) {\n      output.stderr(\n        'error: channel install needs <key> --revision <id> --project <id> --install <id>',\n      );\n      return 2;\n    }\n    if (apiKey == null) {\n      output.stderr('error: set FINAL_API_KEY to a Final API key');\n      return 2;\n    }\n    return runChannelInstall({\n      channelKey,\n      revisionId: values.revision,\n      replace: values.replace,\n      projectId: values.project,\n      connectorInstallId: values.install,\n      client: client(apiKey),\n      output,\n    });\n  }\n  if (command === 'build') {\n    return runBuild({ dir, client: apiKey == null ? null : client(apiKey), output });\n  }\n  if (command === 'dev') {\n    const port = values.port == null ? DEFAULT_DEV_PORT : Number(values.port);\n    if (!Number.isInteger(port) || port < 0 || port > 65_535) {\n      output.stderr(`error: --port must be a port number`);\n      return 2;\n    }\n    return runDev({\n      dir,\n      port,\n      env: deps.env,\n      output,\n      signal: deps.signal ?? new AbortController().signal,\n    });\n  }\n  if (command === 'publish') {\n    if (values.agent == null) {\n      output.stderr('error: publish needs --agent <slug>');\n      return 2;\n    }\n    if (apiKey == null) {\n      output.stderr('error: set FINAL_API_KEY to a Final API key');\n      return 2;\n    }\n    return runPublish({\n      dir,\n      agent: values.agent,\n      ref: values.ref ?? null,\n      message: values.message ?? DEFAULT_COMMIT_MESSAGE,\n      note: values.note ?? null,\n      activate: values['no-activate'] === true ? false : undefined,\n      client: client(apiKey),\n      listFiles: deps.listFiles ?? gitListFiles,\n      output,\n    });\n  }\n  if (command === 'conformance') {\n    if (dirArg == null) {\n      output.stderr('error: conformance needs <module>');\n      return 2;\n    }\n    const timeoutMs = values.timeout == null ? null : Number(values.timeout);\n    if (timeoutMs != null && (!Number.isInteger(timeoutMs) || timeoutMs <= 0)) {\n      output.stderr('error: --timeout must be a positive number of milliseconds');\n      return 2;\n    }\n    return runConformance({\n      module: dirArg,\n      exportName: values.export ?? 'default',\n      profile: values.profile ?? 'final',\n      timeoutMs,\n      json: values.json === true,\n      cwd: deps.cwd,\n      output,\n      importModule: deps.importModule,\n      signal: deps.signal,\n    });\n  }\n  output.stderr(`error: unknown command ${command}`);\n  output.stderr(USAGE);\n  return 2;\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { parseArgs } from 'node:util';\nimport { documentOf, type AgentIface } from '@finalai/agent-definition';\nimport type { AgentDocumentIface } from '@finalai/agent-provider/document';\nimport * as z from 'zod';\nimport { createClient, DEFAULT_AGENTS_HOST, type AgentClientIface } from \"../agent-client/client.mjs\";\nimport type { FetchIface } from \"../agent-client/http.mjs\";\nimport { DefinitionKind, loadDefinitionModule, type ImportModule } from \"./agent-module.mjs\";\nimport { runConformance } from \"./conformance.mjs\";\nimport { errorLines, type OutputIface } from \"./output.mjs\";\n\n// `final-agents`: `print` writes the document of an agent, a harness or an\n// ACP adapter, `publish` gives it a name in a project, `conformance` checks a\n// harness implementation. Nothing is built or deployed: each is data.\n\nconst USAGE = [\n  'usage: final-agents <command> [options]',\n  '',\n  'commands:',\n  '  print <module>                    write the document of the agent, harness or ACP adapter',\n  '                                    the module exports, as JSON',\n  '  publish <module> --name <name>    store it and point <name> at it in a project',\n  '  conformance <module>              run the harness conformance kit against a harness the module exports',\n  '',\n  'options:',\n  '  --export <name>     the export to use (print and publish: an agent, a harness or an ACP adapter,',\n  '                      found by itself when omitted;',\n  '                      conformance: a HarnessIface or { harness, dial }, default \"default\")',\n  '  --name <name>       publish: the name to point at it',\n  '  --project <id>      publish: the project (overrides FINAL_PROJECT_ID)',\n  '  --host <url>        agents API (overrides FINAL_API_HOST; default ' +\n    DEFAULT_AGENTS_HOST +\n    ')',\n  '  --profile <name>    conformance: final (default), final-required (ACP adapters) or plain-acp-v2',\n  '  --timeout <ms>      conformance: per-case timeout',\n  '  --json              conformance: print the report as JSON',\n  '',\n  'publish authenticates with FINAL_API_KEY. print calls nothing.',\n].join('\\n');\n\nconst envSchema = z.object({\n  FINAL_API_KEY: z.string().min(1).optional(),\n  FINAL_API_HOST: z.string().url().optional(),\n  FINAL_PROJECT_ID: z.string().min(1).optional(),\n});\n\nexport interface AgentsCliDepsIface {\n  argv: string[];\n  env: Record<string, string | undefined>;\n  cwd: string;\n  output: OutputIface;\n  // Seams: API requests, module loading and document making.\n  fetch?: FetchIface;\n  importModule?: ImportModule;\n  documentOf?: (agent: AgentIface) => AgentDocumentIface;\n  // Ends long-running commands; main.ts aborts it on SIGINT and SIGTERM.\n  signal?: AbortSignal;\n}\n\nconst optionsConfig = {\n  export: { type: 'string' },\n  name: { type: 'string' },\n  project: { type: 'string' },\n  host: { type: 'string' },\n  profile: { type: 'string' },\n  timeout: { type: 'string' },\n  json: { type: 'boolean' },\n  help: { type: 'boolean', short: 'h' },\n} as const;\n\nconst parseCommandLine = (argv: string[]) =>\n  parseArgs({ args: argv, options: optionsConfig, allowPositionals: true });\n\ntype ParsedResult =\n  | { ok: true; parsed: ReturnType<typeof parseCommandLine> }\n  | { ok: false; message: string };\n\nconst parse = (argv: string[]): ParsedResult => {\n  try {\n    return { ok: true, parsed: parseCommandLine(argv) };\n  } catch (cause) {\n    return { ok: false, message: cause instanceof Error ? cause.message : String(cause) };\n  }\n};\n\nexport const runAgentsCommand = async (deps: AgentsCliDepsIface): Promise<number> => {\n  const { output } = deps;\n  const parsedArgs = parse(deps.argv);\n  if (!parsedArgs.ok) {\n    output.stderr(`error: ${parsedArgs.message}`);\n    output.stderr(USAGE);\n    return 2;\n  }\n  const { values, positionals } = parsedArgs.parsed;\n  const [command, moduleArg, ...extra] = positionals;\n  if (values.help === true || command == null || command === 'help') {\n    (command == null && values.help !== true ? output.stderr : output.stdout)(USAGE);\n    return command == null && values.help !== true ? 2 : 0;\n  }\n  if (extra.length > 0) {\n    output.stderr(`error: unexpected arguments: ${extra.join(' ')}`);\n    return 2;\n  }\n  if (command !== 'print' && command !== 'publish' && command !== 'conformance') {\n    output.stderr(`error: unknown command ${command}`);\n    output.stderr(USAGE);\n    return 2;\n  }\n  if (moduleArg == null) {\n    output.stderr(`error: ${command} needs <module>`);\n    return 2;\n  }\n\n  if (command === 'conformance') {\n    const timeoutMs = values.timeout == null ? null : Number(values.timeout);\n    if (timeoutMs != null && (!Number.isInteger(timeoutMs) || timeoutMs <= 0)) {\n      output.stderr('error: --timeout must be a positive number of milliseconds');\n      return 2;\n    }\n    return runConformance({\n      module: moduleArg,\n      exportName: values.export ?? 'default',\n      profile: values.profile ?? 'final',\n      timeoutMs,\n      json: values.json === true,\n      cwd: deps.cwd,\n      output,\n      importModule: deps.importModule,\n      signal: deps.signal,\n    });\n  }\n\n  const env = envSchema.safeParse(deps.env);\n  if (!env.success) {\n    output.stderr(\n      'error: FINAL_API_KEY must be nonempty and FINAL_API_HOST must be an absolute URL',\n    );\n    return 2;\n  }\n  const loaded = await loadDefinitionModule({\n    module: moduleArg,\n    exportName: values.export ?? null,\n    cwd: deps.cwd,\n    importModule: deps.importModule,\n    documentOf: deps.documentOf ?? documentOf,\n  });\n  if (!loaded.ok) {\n    output.stderr(`error: ${loaded.message}`);\n    return 1;\n  }\n\n  if (command === 'print') {\n    output.stdout(JSON.stringify(loaded.document, null, 2));\n    return 0;\n  }\n\n  if (values.name == null) {\n    output.stderr('error: publish needs --name <name>');\n    return 2;\n  }\n  const projectId = values.project ?? env.data.FINAL_PROJECT_ID;\n  if (projectId == null) {\n    output.stderr('error: publish needs --project <id> or FINAL_PROJECT_ID');\n    return 2;\n  }\n  const apiKey = env.data.FINAL_API_KEY;\n  if (apiKey == null) {\n    output.stderr('error: set FINAL_API_KEY to a Final API key');\n    return 2;\n  }\n  const agentDocument = loaded.kind === DefinitionKind.Agent ? loaded.document : null;\n  const client: AgentClientIface = createClient({\n    host: values.host ?? env.data.FINAL_API_HOST ?? DEFAULT_AGENTS_HOST,\n    auth: { apiKey },\n    fetch: deps.fetch,\n    localCompute: false,\n    // The document is already made; publishing sends exactly it.\n    agentCodec: {\n      documentOf: () => {\n        if (agentDocument == null) throw new Error('Only an agent has an agent document');\n        return agentDocument;\n      },\n      inProcessCodeOf: () => ({ tools: {}, hooks: {}, approvals: {} }),\n    },\n  });\n  try {\n    const project = client.project({ id: projectId });\n    const name = values.name;\n    const signal = deps.signal;\n    const published =\n      loaded.kind === DefinitionKind.Agent\n        ? await project.agents.publish({ agent: loaded.agent, name, signal })\n        : loaded.kind === DefinitionKind.Harness\n          ? await project.harnesses.publish({ harness: loaded.document, name, signal })\n          : await project.acpAdapters.publish({ adapter: loaded.document, name, signal });\n    output.stdout(`published ${published.name}: ${published.hash}`);\n    if ('id' in published && published.id != null) output.stdout(`id: ${published.id}`);\n    return 0;\n  } catch (cause) {\n    for (const line of errorLines(cause)) output.stderr(line);\n    return 1;\n  } finally {\n    client.close();\n  }\n};\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAC1B,SAAS,kBAAmC;AAE5C,YAAY,OAAO;AACnB,SAAS,cAAc,2BAAkD;AAEzE,SAAS,gBAAgB,4BAA+C;AACxE,SAAS,sBAAsB;AAC/B,SAAS,kBAAoC;AAM7C,MAAM,QAAQ;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,yEACE,sBACA;AAAA,EACF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,MAAM,YAAY,EAAE,OAAO;AAAA,EACzB,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EAC1C,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EAC1C,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAC/C,CAAC;AAeD,MAAM,gBAAgB;AAAA,EACpB,QAAQ,EAAE,MAAM,SAAS;AAAA,EACzB,MAAM,EAAE,MAAM,SAAS;AAAA,EACvB,SAAS,EAAE,MAAM,SAAS;AAAA,EAC1B,MAAM,EAAE,MAAM,SAAS;AAAA,EACvB,SAAS,EAAE,MAAM,SAAS;AAAA,EAC1B,SAAS,EAAE,MAAM,SAAS;AAAA,EAC1B,MAAM,EAAE,MAAM,UAAU;AAAA,EACxB,MAAM,EAAE,MAAM,WAAW,OAAO,IAAI;AACtC;AAEA,MAAM,mBAAmB,CAAC,SACxB,UAAU,EAAE,MAAM,MAAM,SAAS,eAAe,kBAAkB,KAAK,CAAC;AAM1E,MAAM,QAAQ,CAAC,SAAiC;AAC9C,MAAI;AACF,WAAO,EAAE,IAAI,MAAM,QAAQ,iBAAiB,IAAI,EAAE;AAAA,EACpD,SAAS,OAAO;AACd,WAAO,EAAE,IAAI,OAAO,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AAAA,EACtF;AACF;AAEO,MAAM,mBAAmB,OAAO,SAA8C;AACnF,QAAM,EAAE,OAAO,IAAI;AACnB,QAAM,aAAa,MAAM,KAAK,IAAI;AAClC,MAAI,CAAC,WAAW,IAAI;AAClB,WAAO,OAAO,UAAU,WAAW,OAAO,EAAE;AAC5C,WAAO,OAAO,KAAK;AACnB,WAAO;AAAA,EACT;AACA,QAAM,EAAE,QAAQ,YAAY,IAAI,WAAW;AAC3C,QAAM,CAAC,SAAS,WAAW,GAAG,KAAK,IAAI;AACvC,MAAI,OAAO,SAAS,QAAQ,WAAW,QAAQ,YAAY,QAAQ;AACjE,KAAC,WAAW,QAAQ,OAAO,SAAS,OAAO,OAAO,SAAS,OAAO,QAAQ,KAAK;AAC/E,WAAO,WAAW,QAAQ,OAAO,SAAS,OAAO,IAAI;AAAA,EACvD;AACA,MAAI,MAAM,SAAS,GAAG;AACpB,WAAO,OAAO,gCAAgC,MAAM,KAAK,GAAG,CAAC,EAAE;AAC/D,WAAO;AAAA,EACT;AACA,MAAI,YAAY,WAAW,YAAY,aAAa,YAAY,eAAe;AAC7E,WAAO,OAAO,0BAA0B,OAAO,EAAE;AACjD,WAAO,OAAO,KAAK;AACnB,WAAO;AAAA,EACT;AACA,MAAI,aAAa,MAAM;AACrB,WAAO,OAAO,UAAU,OAAO,iBAAiB;AAChD,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,eAAe;AAC7B,UAAM,YAAY,OAAO,WAAW,OAAO,OAAO,OAAO,OAAO,OAAO;AACvE,QAAI,aAAa,SAAS,CAAC,OAAO,UAAU,SAAS,KAAK,aAAa,IAAI;AACzE,aAAO,OAAO,4DAA4D;AAC1E,aAAO;AAAA,IACT;AACA,WAAO,eAAe;AAAA,MACpB,QAAQ;AAAA,MACR,YAAY,OAAO,UAAU;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B;AAAA,MACA,MAAM,OAAO,SAAS;AAAA,MACtB,KAAK,KAAK;AAAA,MACV;AAAA,MACA,cAAc,KAAK;AAAA,MACnB,QAAQ,KAAK;AAAA,IACf,CAAC;AAAA,EACH;AAEA,QAAM,MAAM,UAAU,UAAU,KAAK,GAAG;AACxC,MAAI,CAAC,IAAI,SAAS;AAChB,WAAO;AAAA,MACL;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,QAAM,SAAS,MAAM,qBAAqB;AAAA,IACxC,QAAQ;AAAA,IACR,YAAY,OAAO,UAAU;AAAA,IAC7B,KAAK,KAAK;AAAA,IACV,cAAc,KAAK;AAAA,IACnB,YAAY,KAAK,cAAc;AAAA,EACjC,CAAC;AACD,MAAI,CAAC,OAAO,IAAI;AACd,WAAO,OAAO,UAAU,OAAO,OAAO,EAAE;AACxC,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,SAAS;AACvB,WAAO,OAAO,KAAK,UAAU,OAAO,UAAU,MAAM,CAAC,CAAC;AACtD,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,QAAQ,MAAM;AACvB,WAAO,OAAO,oCAAoC;AAClD,WAAO;AAAA,EACT;AACA,QAAM,YAAY,OAAO,WAAW,IAAI,KAAK;AAC7C,MAAI,aAAa,MAAM;AACrB,WAAO,OAAO,yDAAyD;AACvE,WAAO;AAAA,EACT;AACA,QAAM,SAAS,IAAI,KAAK;AACxB,MAAI,UAAU,MAAM;AAClB,WAAO,OAAO,6CAA6C;AAC3D,WAAO;AAAA,EACT;AACA,QAAM,gBAAgB,OAAO,SAAS,eAAe,QAAQ,OAAO,WAAW;AAC/E,QAAM,SAA2B,aAAa;AAAA,IAC5C,MAAM,OAAO,QAAQ,IAAI,KAAK,kBAAkB;AAAA,IAChD,MAAM,EAAE,OAAO;AAAA,IACf,OAAO,KAAK;AAAA,IACZ,cAAc;AAAA;AAAA,IAEd,YAAY;AAAA,MACV,YAAY,MAAM;AAChB,YAAI,iBAAiB,KAAM,OAAM,IAAI,MAAM,qCAAqC;AAChF,eAAO;AAAA,MACT;AAAA,MACA,iBAAiB,OAAO,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,WAAW,CAAC,EAAE;AAAA,IAChE;AAAA,EACF,CAAC;AACD,MAAI;AACF,UAAM,UAAU,OAAO,QAAQ,EAAE,IAAI,UAAU,CAAC;AAChD,UAAM,OAAO,OAAO;AACpB,UAAM,SAAS,KAAK;AACpB,UAAM,YACJ,OAAO,SAAS,eAAe,QAC3B,MAAM,QAAQ,OAAO,QAAQ,EAAE,OAAO,OAAO,OAAO,MAAM,OAAO,CAAC,IAClE,OAAO,SAAS,eAAe,UAC7B,MAAM,QAAQ,UAAU,QAAQ,EAAE,SAAS,OAAO,UAAU,MAAM,OAAO,CAAC,IAC1E,MAAM,QAAQ,YAAY,QAAQ,EAAE,SAAS,OAAO,UAAU,MAAM,OAAO,CAAC;AACpF,WAAO,OAAO,aAAa,UAAU,IAAI,KAAK,UAAU,IAAI,EAAE;AAC9D,QAAI,QAAQ,aAAa,UAAU,MAAM,KAAM,QAAO,OAAO,OAAO,UAAU,EAAE,EAAE;AAClF,WAAO;AAAA,EACT,SAAS,OAAO;AACd,eAAW,QAAQ,WAAW,KAAK,EAAG,QAAO,OAAO,IAAI;AACxD,WAAO;AAAA,EACT,UAAE;AACA,WAAO,MAAM;AAAA,EACf;AACF;",
   "names": []
 }

package/dist/modules/cli/conformance.d.mts

@@ -1,12 +1,9 @@
 import { type HarnessEndpointIface, type HarnessIface } from '@finalai/agent-provider';
 import { type ConformanceStreamIface, type HarnessConformanceReportIface, type RunHarnessConformanceArgsIface } from '@finalai/agent-provider/conformance';
-import * as z from 'zod';
+import { type ImportModule, type ModuleNamespace } from "./agent-module.mjs";
 import type { OutputIface } from "./output.mjs";
-declare const moduleNamespaceSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-/** An imported module's exports, before the conformance export is parsed. */
-export type ModuleNamespace = z.output<typeof moduleNamespaceSchema>;
+export type { ImportModule, ModuleNamespace } from "./agent-module.mjs";
 type ModuleExport = ModuleNamespace[string];
-export type ImportModule = (url: string) => Promise<ModuleNamespace>;
 export interface ConformanceTargetIface {
     harness: HarnessIface;
     dial: RunHarnessConformanceArgsIface['dial'];
@@ -33,4 +30,3 @@ export declare const runConformance: (args: {
     importModule?: ImportModule;
     signal?: AbortSignal;
 }) => Promise<number>;
-export {};

package/dist/modules/cli/conformance.mjs

@@ -19,15 +19,11 @@ import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import WebSocket from "ws";
 import * as z from "zod";
-const moduleNamespaceSchema = z.record(z.string(), z.unknown());
-const importModule = async (url) => moduleNamespaceSchema.parse(await import(
-  /* @vite-ignore */
-  url
-));
+import { importModule } from "./agent-module.mjs";
 const functionCheck = z.function();
 const isFunction = (value) => functionCheck.safeParse(value).success;
 const harnessMethodsSchema = z.looseObject({
-  describe: z.custom(isFunction),
+  definition: z.looseObject({}),
   open: z.custom(isFunction),
   resume: z.custom(isFunction),
   park: z.custom(isFunction),
@@ -120,8 +116,9 @@ const dialHarnessEndpoint = async (endpoint) => {
       return { ...stream, close: () => child.kill("SIGTERM") };
     }
     case AcpTransport.Relay:
+    case AcpTransport.Sandbox:
       throw new Error(
-        "relay endpoints are dialed by the session plane; export { harness, dial } to run them here"
+        `${endpoint.transport} endpoints are dialed by the session plane; export { harness, dial } to run them here`
       );
   }
 };
@@ -163,7 +160,7 @@ const runConformance = async (args) => {
   const profile = z.nativeEnum(ConformanceProfile).safeParse(args.profile);
   if (!profile.success) {
     args.output.stderr(
-      `error: --profile must be ${Object.values(ConformanceProfile).join(" or ")}`
+      `error: --profile must be one of ${Object.values(ConformanceProfile).join(", ")}`
     );
     return 2;
   }

package/dist/modules/cli/conformance.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/conformance.ts"],
-  "sourcesContent": ["import { createHttpStream } from '@agentclientprotocol/sdk/experimental/http-client';\nimport { ndJsonStream } from '@agentclientprotocol/sdk/experimental/v2';\nimport { createWebSocketStream } from '@agentclientprotocol/sdk/experimental/ws-client';\nimport {\n  AcpTransport,\n  type HarnessEndpointIface,\n  type HarnessIface,\n} from '@finalai/agent-provider';\nimport {\n  ConformanceCaseStatus,\n  ConformanceProfile,\n  conformanceOpenArgs,\n  runHarnessConformance,\n  type ConformanceStreamIface,\n  type HarnessConformanceReportIface,\n  type RunHarnessConformanceArgsIface,\n} from '@finalai/agent-provider/conformance';\nimport {\n  configureNodeClientWebSocket,\n  createNodeClientTlsSession,\n} from '@finalai/websockets/node-client-tls';\nimport { spawn } from 'node:child_process';\nimport { resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport WebSocket from 'ws';\nimport * as z from 'zod';\nimport type { OutputIface } from \"./output.mjs\";\n\n// `final-agents conformance <module>` exercises the public lifecycle and ACP\n// contracts of a harness exported by a module. The export is a HarnessIface, or `{ harness, dial }`\n// (with optional `nativeSessionId`) when its endpoints need a dialer of its own.\n\nconst moduleNamespaceSchema = z.record(z.string(), z.unknown());\n/** An imported module's exports, before the conformance export is parsed. */\nexport type ModuleNamespace = z.output<typeof moduleNamespaceSchema>;\ntype ModuleExport = ModuleNamespace[string];\n\nexport type ImportModule = (url: string) => Promise<ModuleNamespace>;\n\nconst importModule: ImportModule = async (url) =>\n  moduleNamespaceSchema.parse(await import(/* @vite-ignore */ url));\n\nexport interface ConformanceTargetIface {\n  harness: HarnessIface;\n  dial: RunHarnessConformanceArgsIface['dial'];\n  nativeSessionId?: RunHarnessConformanceArgsIface['nativeSessionId'];\n}\n\n// zod's function check, so functions from any realm qualify.\nconst functionCheck = z.function();\nconst isFunction = (value: ModuleExport): boolean => functionCheck.safeParse(value).success;\n\nconst harnessMethodsSchema = z.looseObject({\n  describe: z.custom(isFunction),\n  open: z.custom(isFunction),\n  resume: z.custom(isFunction),\n  park: z.custom(isFunction),\n  close: z.custom(isFunction),\n  health: z.custom(isFunction),\n});\n// An object with the methods, or a callable carrying them (what `defineHarness` returns).\nconst harnessSchema = z.custom<HarnessIface>(\n  (value) =>\n    harnessMethodsSchema.safeParse(isFunction(value) ? Object.assign({}, value) : value).success,\n);\nconst dialSchema = z.custom<ConformanceTargetIface['dial']>(\n  isFunction,\n  '`dial` must be a function',\n);\nconst nativeSessionIdSchema = z.custom<NonNullable<ConformanceTargetIface['nativeSessionId']>>(\n  isFunction,\n  '`nativeSessionId` must be a function',\n);\nconst targetFieldsSchema = z.looseObject({\n  harness: harnessSchema,\n  dial: dialSchema.optional(),\n  nativeSessionId: nativeSessionIdSchema.optional(),\n});\n\n// Dials the endpoint kinds a harness outside Final can return: stdio programs,\n// Streamable HTTP and WebSocket, including header authentication and client TLS.\n// Relay endpoints are Final-managed.\nexport const dialHarnessEndpoint = async (\n  endpoint: HarnessEndpointIface,\n): Promise<ConformanceStreamIface> => {\n  switch (endpoint.transport) {\n    case AcpTransport.Http: {\n      const headers = { ...endpoint.headers, ...(await endpoint.resolveHeaders?.()) };\n      const tlsSession =\n        endpoint.tls == null ? null : createNodeClientTlsSession({ tls: endpoint.tls });\n      const stream = createHttpStream(endpoint.url, {\n        headers,\n        cookies: 'omit',\n        fetch: tlsSession?.fetch,\n      });\n      return {\n        ...stream,\n        close: () => {\n          void stream.writable.close().catch(() => undefined);\n          void tlsSession?.close().catch(() => undefined);\n        },\n      };\n    }\n    case AcpTransport.Ws: {\n      const headers = { ...endpoint.headers, ...(await endpoint.resolveHeaders?.()) };\n      const stream = createWebSocketStream(endpoint.url, {\n        cookies: 'omit',\n        headers,\n        WebSocket: configureNodeClientWebSocket({ constructor: WebSocket, tls: endpoint.tls }),\n      });\n      return {\n        ...stream,\n        close: () => void stream.writable.close().catch(() => undefined),\n      };\n    }\n    case AcpTransport.Stdio: {\n      const child = spawn(endpoint.command, endpoint.args, {\n        env: { ...process.env, ...endpoint.env },\n        stdio: ['pipe', 'pipe', 'inherit'],\n      });\n      child.stdin.on('error', () => undefined);\n      let open = true;\n      const input = new ReadableStream<Uint8Array>({\n        start: (controller) => {\n          child.stdout.on('data', (chunk: Buffer) => {\n            if (open) controller.enqueue(new Uint8Array(chunk));\n          });\n          child.stdout.on('end', () => {\n            if (!open) return;\n            open = false;\n            controller.close();\n          });\n          child.on('error', (error) => {\n            if (!open) return;\n            open = false;\n            controller.error(error);\n          });\n        },\n        cancel: () => {\n          open = false;\n          child.stdout.destroy();\n        },\n      });\n      const output = new WritableStream<Uint8Array>({\n        write: (chunk) =>\n          new Promise<void>((done, fail) => {\n            child.stdin.write(chunk, (error) => (error == null ? done() : fail(error)));\n          }),\n        close: () => {\n          child.stdin.end();\n        },\n      });\n      const stream = ndJsonStream(output, input);\n      return { ...stream, close: () => child.kill('SIGTERM') };\n    }\n    case AcpTransport.Relay:\n      throw new Error(\n        'relay endpoints are dialed by the session plane; export { harness, dial } to run them here',\n      );\n  }\n};\n\nexport type ConformanceTargetResult =\n  | { ok: true; target: ConformanceTargetIface }\n  | { ok: false; message: string };\n\n// The export as a conformance target: a HarnessIface (dialed built in), or\n// `{ harness, dial?, nativeSessionId? }`.\nexport const conformanceTargetOf = (value: ModuleExport): ConformanceTargetResult => {\n  const harness = harnessSchema.safeParse(value);\n  if (harness.success)\n    return { ok: true, target: { harness: harness.data, dial: dialHarnessEndpoint } };\n  const fields = targetFieldsSchema.safeParse(value);\n  if (!fields.success) {\n    const issue = fields.error.issues.find((entry) => entry.path[0] !== 'harness');\n    return {\n      ok: false,\n      message:\n        issue?.message ??\n        'the export must be a HarnessIface or { harness, dial?, nativeSessionId? }',\n    };\n  }\n  return {\n    ok: true,\n    target: {\n      harness: fields.data.harness,\n      dial: fields.data.dial ?? dialHarnessEndpoint,\n      nativeSessionId: fields.data.nativeSessionId,\n    },\n  };\n};\n\nconst statusLabel = {\n  [ConformanceCaseStatus.Passed]: 'pass',\n  [ConformanceCaseStatus.Failed]: 'FAIL',\n  [ConformanceCaseStatus.Skipped]: 'skip',\n} satisfies Record<ConformanceCaseStatus, string>;\n\nexport const reportLines = (report: HarnessConformanceReportIface): string[] => [\n  `profile: ${report.profile}`,\n  ...report.cases.map((entry) => {\n    const why = entry.error ?? entry.detail;\n    return `${statusLabel[entry.status]}  ${entry.name}${why == null ? '' : ` (${why})`}`;\n  }),\n  report.passed ? 'conformance: passed' : 'conformance: failed',\n];\n\nexport const runConformance = async (args: {\n  module: string;\n  exportName: string;\n  profile: string;\n  timeoutMs: number | null;\n  json: boolean;\n  cwd: string;\n  output: OutputIface;\n  importModule?: ImportModule;\n  // SIGINT/SIGTERM (main.ts): the kit has no cancellation, so the command stops\n  // waiting for it and the process exits.\n  signal?: AbortSignal;\n}): Promise<number> => {\n  const profile = z.nativeEnum(ConformanceProfile).safeParse(args.profile);\n  if (!profile.success) {\n    args.output.stderr(\n      `error: --profile must be ${Object.values(ConformanceProfile).join(' or ')}`,\n    );\n    return 2;\n  }\n  const url = pathToFileURL(resolve(args.cwd, args.module)).href;\n  let loaded: ModuleNamespace;\n  try {\n    loaded = await (args.importModule ?? importModule)(url);\n  } catch (cause) {\n    args.output.stderr(\n      `error: cannot load ${args.module}: ${cause instanceof Error ? cause.message : String(cause)}`,\n    );\n    return 1;\n  }\n  if (!(args.exportName in loaded)) {\n    args.output.stderr(`error: ${args.module} has no export ${args.exportName}`);\n    return 1;\n  }\n  const parsed = conformanceTargetOf(loaded[args.exportName]);\n  if (!parsed.ok) {\n    args.output.stderr(`error: ${args.module}#${args.exportName}: ${parsed.message}`);\n    return 1;\n  }\n  const target = parsed.target;\n  const run = runHarnessConformance({\n    harness: target.harness,\n    dial: target.dial,\n    nativeSessionId: target.nativeSessionId,\n    profile: profile.data,\n    openArgs: conformanceOpenArgs(),\n    timeoutMs: args.timeoutMs ?? undefined,\n    cwd: args.cwd,\n  });\n  const signal = args.signal;\n  const interrupted =\n    signal == null\n      ? null\n      : new Promise<null>((done) => {\n          if (signal.aborted) done(null);\n          else signal.addEventListener('abort', () => done(null), { once: true });\n        });\n  const report = await (interrupted == null ? run : Promise.race([run, interrupted]));\n  if (report == null) {\n    run.catch(() => undefined);\n    args.output.stderr('conformance: interrupted');\n    return 130;\n  }\n  if (args.json) args.output.stdout(JSON.stringify(report, null, 2));\n  else for (const line of reportLines(report)) args.output.stdout(line);\n  return report.passed ? 0 : 1;\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { createHttpStream } from '@agentclientprotocol/sdk/experimental/http-client';\nimport { ndJsonStream } from '@agentclientprotocol/sdk/experimental/v2';\nimport { createWebSocketStream } from '@agentclientprotocol/sdk/experimental/ws-client';\nimport {\n  AcpTransport,\n  type HarnessEndpointIface,\n  type HarnessIface,\n} from '@finalai/agent-provider';\nimport {\n  ConformanceCaseStatus,\n  ConformanceProfile,\n  conformanceOpenArgs,\n  runHarnessConformance,\n  type ConformanceStreamIface,\n  type HarnessConformanceReportIface,\n  type RunHarnessConformanceArgsIface,\n} from '@finalai/agent-provider/conformance';\nimport {\n  configureNodeClientWebSocket,\n  createNodeClientTlsSession,\n} from '@finalai/websockets/node-client-tls';\nimport { spawn } from 'node:child_process';\nimport { resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport WebSocket from 'ws';\nimport * as z from 'zod';\nimport { importModule, type ImportModule, type ModuleNamespace } from \"./agent-module.mjs\";\nimport type { OutputIface } from \"./output.mjs\";\n\nexport type { ImportModule, ModuleNamespace } from \"./agent-module.mjs\";\n\n// `final-agents conformance <module>` exercises the public lifecycle and ACP\n// contracts of a harness exported by a module. The export is a HarnessIface (its definition\n// and lifecycle), or `{ harness, dial }` (with optional `nativeSessionId`) when its endpoints\n// need a dialer of its own.\n\ntype ModuleExport = ModuleNamespace[string];\n\nexport interface ConformanceTargetIface {\n  harness: HarnessIface;\n  dial: RunHarnessConformanceArgsIface['dial'];\n  nativeSessionId?: RunHarnessConformanceArgsIface['nativeSessionId'];\n}\n\n// zod's function check, so functions from any realm qualify.\nconst functionCheck = z.function();\nconst isFunction = (value: ModuleExport): boolean => functionCheck.safeParse(value).success;\n\nconst harnessMethodsSchema = z.looseObject({\n  definition: z.looseObject({}),\n  open: z.custom(isFunction),\n  resume: z.custom(isFunction),\n  park: z.custom(isFunction),\n  close: z.custom(isFunction),\n  health: z.custom(isFunction),\n});\n// An object with the methods, or a callable carrying them.\nconst harnessSchema = z.custom<HarnessIface>(\n  (value) =>\n    harnessMethodsSchema.safeParse(isFunction(value) ? Object.assign({}, value) : value).success,\n);\nconst dialSchema = z.custom<ConformanceTargetIface['dial']>(\n  isFunction,\n  '`dial` must be a function',\n);\nconst nativeSessionIdSchema = z.custom<NonNullable<ConformanceTargetIface['nativeSessionId']>>(\n  isFunction,\n  '`nativeSessionId` must be a function',\n);\nconst targetFieldsSchema = z.looseObject({\n  harness: harnessSchema,\n  dial: dialSchema.optional(),\n  nativeSessionId: nativeSessionIdSchema.optional(),\n});\n\n// Dials the endpoint kinds a harness outside Final can return: stdio programs,\n// Streamable HTTP and WebSocket, including header authentication and client TLS.\n// Relay endpoints are Final-managed.\nexport const dialHarnessEndpoint = async (\n  endpoint: HarnessEndpointIface,\n): Promise<ConformanceStreamIface> => {\n  switch (endpoint.transport) {\n    case AcpTransport.Http: {\n      const headers = { ...endpoint.headers, ...(await endpoint.resolveHeaders?.()) };\n      const tlsSession =\n        endpoint.tls == null ? null : createNodeClientTlsSession({ tls: endpoint.tls });\n      const stream = createHttpStream(endpoint.url, {\n        headers,\n        cookies: 'omit',\n        fetch: tlsSession?.fetch,\n      });\n      return {\n        ...stream,\n        close: () => {\n          void stream.writable.close().catch(() => undefined);\n          void tlsSession?.close().catch(() => undefined);\n        },\n      };\n    }\n    case AcpTransport.Ws: {\n      const headers = { ...endpoint.headers, ...(await endpoint.resolveHeaders?.()) };\n      const stream = createWebSocketStream(endpoint.url, {\n        cookies: 'omit',\n        headers,\n        WebSocket: configureNodeClientWebSocket({ constructor: WebSocket, tls: endpoint.tls }),\n      });\n      return {\n        ...stream,\n        close: () => void stream.writable.close().catch(() => undefined),\n      };\n    }\n    case AcpTransport.Stdio: {\n      const child = spawn(endpoint.command, endpoint.args, {\n        env: { ...process.env, ...endpoint.env },\n        stdio: ['pipe', 'pipe', 'inherit'],\n      });\n      child.stdin.on('error', () => undefined);\n      let open = true;\n      const input = new ReadableStream<Uint8Array>({\n        start: (controller) => {\n          child.stdout.on('data', (chunk: Buffer) => {\n            if (open) controller.enqueue(new Uint8Array(chunk));\n          });\n          child.stdout.on('end', () => {\n            if (!open) return;\n            open = false;\n            controller.close();\n          });\n          child.on('error', (error) => {\n            if (!open) return;\n            open = false;\n            controller.error(error);\n          });\n        },\n        cancel: () => {\n          open = false;\n          child.stdout.destroy();\n        },\n      });\n      const output = new WritableStream<Uint8Array>({\n        write: (chunk) =>\n          new Promise<void>((done, fail) => {\n            child.stdin.write(chunk, (error) => (error == null ? done() : fail(error)));\n          }),\n        close: () => {\n          child.stdin.end();\n        },\n      });\n      const stream = ndJsonStream(output, input);\n      return { ...stream, close: () => child.kill('SIGTERM') };\n    }\n    case AcpTransport.Relay:\n    case AcpTransport.Sandbox:\n      throw new Error(\n        `${endpoint.transport} endpoints are dialed by the session plane; export { harness, dial } to run them here`,\n      );\n  }\n};\n\nexport type ConformanceTargetResult =\n  | { ok: true; target: ConformanceTargetIface }\n  | { ok: false; message: string };\n\n// The export as a conformance target: a HarnessIface (dialed built in), or\n// `{ harness, dial?, nativeSessionId? }`.\nexport const conformanceTargetOf = (value: ModuleExport): ConformanceTargetResult => {\n  const harness = harnessSchema.safeParse(value);\n  if (harness.success)\n    return { ok: true, target: { harness: harness.data, dial: dialHarnessEndpoint } };\n  const fields = targetFieldsSchema.safeParse(value);\n  if (!fields.success) {\n    const issue = fields.error.issues.find((entry) => entry.path[0] !== 'harness');\n    return {\n      ok: false,\n      message:\n        issue?.message ??\n        'the export must be a HarnessIface or { harness, dial?, nativeSessionId? }',\n    };\n  }\n  return {\n    ok: true,\n    target: {\n      harness: fields.data.harness,\n      dial: fields.data.dial ?? dialHarnessEndpoint,\n      nativeSessionId: fields.data.nativeSessionId,\n    },\n  };\n};\n\nconst statusLabel = {\n  [ConformanceCaseStatus.Passed]: 'pass',\n  [ConformanceCaseStatus.Failed]: 'FAIL',\n  [ConformanceCaseStatus.Skipped]: 'skip',\n} satisfies Record<ConformanceCaseStatus, string>;\n\nexport const reportLines = (report: HarnessConformanceReportIface): string[] => [\n  `profile: ${report.profile}`,\n  ...report.cases.map((entry) => {\n    const why = entry.error ?? entry.detail;\n    return `${statusLabel[entry.status]}  ${entry.name}${why == null ? '' : ` (${why})`}`;\n  }),\n  report.passed ? 'conformance: passed' : 'conformance: failed',\n];\n\nexport const runConformance = async (args: {\n  module: string;\n  exportName: string;\n  profile: string;\n  timeoutMs: number | null;\n  json: boolean;\n  cwd: string;\n  output: OutputIface;\n  importModule?: ImportModule;\n  // SIGINT/SIGTERM (main.ts): the kit has no cancellation, so the command stops\n  // waiting for it and the process exits.\n  signal?: AbortSignal;\n}): Promise<number> => {\n  const profile = z.nativeEnum(ConformanceProfile).safeParse(args.profile);\n  if (!profile.success) {\n    args.output.stderr(\n      `error: --profile must be one of ${Object.values(ConformanceProfile).join(', ')}`,\n    );\n    return 2;\n  }\n  const url = pathToFileURL(resolve(args.cwd, args.module)).href;\n  let loaded: ModuleNamespace;\n  try {\n    loaded = await (args.importModule ?? importModule)(url);\n  } catch (cause) {\n    args.output.stderr(\n      `error: cannot load ${args.module}: ${cause instanceof Error ? cause.message : String(cause)}`,\n    );\n    return 1;\n  }\n  if (!(args.exportName in loaded)) {\n    args.output.stderr(`error: ${args.module} has no export ${args.exportName}`);\n    return 1;\n  }\n  const parsed = conformanceTargetOf(loaded[args.exportName]);\n  if (!parsed.ok) {\n    args.output.stderr(`error: ${args.module}#${args.exportName}: ${parsed.message}`);\n    return 1;\n  }\n  const target = parsed.target;\n  const run = runHarnessConformance({\n    harness: target.harness,\n    dial: target.dial,\n    nativeSessionId: target.nativeSessionId,\n    profile: profile.data,\n    openArgs: conformanceOpenArgs(),\n    timeoutMs: args.timeoutMs ?? undefined,\n    cwd: args.cwd,\n  });\n  const signal = args.signal;\n  const interrupted =\n    signal == null\n      ? null\n      : new Promise<null>((done) => {\n          if (signal.aborted) done(null);\n          else signal.addEventListener('abort', () => done(null), { once: true });\n        });\n  const report = await (interrupted == null ? run : Promise.race([run, interrupted]));\n  if (report == null) {\n    run.catch(() => undefined);\n    args.output.stderr('conformance: interrupted');\n    return 130;\n  }\n  if (args.json) args.output.stdout(JSON.stringify(report, null, 2));\n  else for (const line of reportLines(report)) args.output.stdout(line);\n  return report.passed ? 0 : 1;\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/cli/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/main.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\nimport 'zod/compile';\nimport { runAgentsCommand } from \"./cli.mjs\";\n\n// `final-agents build|dev|publish|conformance`: `final agents \u2026` until a general `final` CLI exists.\n\nconst stop = new AbortController();\nfor (const signal of ['SIGINT', 'SIGTERM'] as const) process.once(signal, () => stop.abort());\n\nprocess.exit(\n  await runAgentsCommand({\n    argv: process.argv.slice(2),\n    env: process.env,\n    cwd: process.cwd(),\n    signal: stop.signal,\n    output: {\n      stdout: (line) => process.stdout.write(`${line}\\n`),\n      stderr: (line) => process.stderr.write(`${line}\\n`),\n    },\n  }),\n);\n"],
+  "sourcesContent": ["#!/usr/bin/env node\nimport 'zod/compile';\nimport { runAgentsCommand } from \"./cli.mjs\";\n\n// `final-agents print|publish|conformance`: `final agents \u2026` until a general `final` CLI exists.\n\nconst stop = new AbortController();\nfor (const signal of ['SIGINT', 'SIGTERM'] as const) process.once(signal, () => stop.abort());\n\nprocess.exit(\n  await runAgentsCommand({\n    argv: process.argv.slice(2),\n    env: process.env,\n    cwd: process.cwd(),\n    signal: stop.signal,\n    output: {\n      stdout: (line) => process.stdout.write(`${line}\\n`),\n      stderr: (line) => process.stderr.write(`${line}\\n`),\n    },\n  }),\n);\n"],
   "mappings": ";AACA,OAAO;AACP,SAAS,wBAAwB;AAIjC,MAAM,OAAO,IAAI,gBAAgB;AACjC,WAAW,UAAU,CAAC,UAAU,SAAS,EAAY,SAAQ,KAAK,QAAQ,MAAM,KAAK,MAAM,CAAC;AAE5F,QAAQ;AAAA,EACN,MAAM,iBAAiB;AAAA,IACrB,MAAM,QAAQ,KAAK,MAAM,CAAC;AAAA,IAC1B,KAAK,QAAQ;AAAA,IACb,KAAK,QAAQ,IAAI;AAAA,IACjB,QAAQ,KAAK;AAAA,IACb,QAAQ;AAAA,MACN,QAAQ,CAAC,SAAS,QAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAAA,MAClD,QAAQ,CAAC,SAAS,QAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAAA,IACpD;AAAA,EACF,CAAC;AACH;",
   "names": []
 }

package/dist/modules/cli/output.d.mts

@@ -1,14 +1,5 @@
-import type { CompatibilityReportIface } from '@finalai/agent-definition/compatibility';
-import type { DiagnosticIface } from '@finalai/agent-definition/compiler';
-import { type AgentManifestIface } from '@finalai/agent-provider';
-import { type PublishResultIface } from "../agent-client/index.mjs";
 export interface OutputIface {
     stdout: (line: string) => void;
     stderr: (line: string) => void;
 }
-export declare const manifestSummaryLines: (manifest: AgentManifestIface) => string[];
-export declare const hookLines: (manifest: AgentManifestIface) => string[];
-export declare const reportLines: (report: CompatibilityReportIface) => string[];
-export declare const diagnosticLine: (item: DiagnosticIface) => string;
 export declare const errorLines: (cause: unknown) => string[];
-export declare const publishResultLines: (result: PublishResultIface) => string[];