@finalai/agents 0.8.0

package/dist/modules/cli/cli.mjs

@@ -0,0 +1,151 @@
+import { resolve } from "node:path";
+import { parseArgs } from "node:util";
+import * as z from "zod";
+import { createClient } from "../agent-client/client.mjs";
+import { runBuild } from "./build.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";
+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",
+  "  conformance <module>              run the harness conformance kit against a harness the module exports",
+  "",
+  "options:",
+  "  --host <url>        agent platform API (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",
+  `  --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",
+  "  --timeout <ms>      conformance: per-case timeout",
+  "  --json              conformance: print the report as JSON",
+  "",
+  "FINAL_API_KEY authenticates (an organization API key). build checks compatibility only with it.",
+  `dev reads route secrets from AGENT_LOCAL_SECRETS_JSON ({"name": "value"}), limited to the manifest's secrets.`
+].join("\n");
+const envSchema = z.object({ FINAL_API_KEY: z.string().min(1).optional() });
+const optionsConfig = {
+  host: { type: "string" },
+  agent: { type: "string" },
+  ref: { type: "string" },
+  message: { type: "string" },
+  note: { type: "string" },
+  port: { type: "string" },
+  export: { type: "string" },
+  profile: { type: "string" },
+  timeout: { type: "string" },
+  json: { type: "boolean" },
+  help: { type: "boolean", short: "h" }
+};
+const parseCommandLine = (argv) => parseArgs({ args: argv, options: optionsConfig, allowPositionals: true });
+const parse = (argv) => {
+  try {
+    return { ok: true, parsed: parseCommandLine(argv) };
+  } catch (cause) {
+    return { ok: false, message: cause instanceof Error ? cause.message : String(cause) };
+  }
+};
+const runAgentsCommand = async (deps) => {
+  const { output } = deps;
+  const parsedArgs = parse(deps.argv);
+  if (!parsedArgs.ok) {
+    output.stderr(`error: ${parsedArgs.message}`);
+    output.stderr(USAGE);
+    return 2;
+  }
+  const { values, positionals } = parsedArgs.parsed;
+  const [command, dirArg, ...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) {
+    output.stderr(`error: unexpected arguments: ${extra.join(" ")}`);
+    return 2;
+  }
+  const env = envSchema.safeParse(deps.env);
+  const apiKey = env.success ? env.data.FINAL_API_KEY ?? null : null;
+  const dir = resolve(deps.cwd, dirArg ?? ".");
+  const client = (key) => createClient({
+    host: values.host ?? DEFAULT_AGENTS_HOST,
+    auth: { apiKey: key },
+    fetch: deps.fetch
+  });
+  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 an organization API key");
+      return 2;
+    }
+    return runPublish({
+      dir,
+      agent: values.agent,
+      ref: values.ref ?? null,
+      message: values.message ?? DEFAULT_COMMIT_MESSAGE,
+      note: values.note ?? null,
+      client: client(apiKey),
+      listFiles: deps.listFiles ?? gitListFiles,
+      output
+    });
+  }
+  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,
+      exportName: values.export ?? "default",
+      profile: values.profile ?? "final",
+      timeoutMs,
+      json: values.json === true,
+      cwd: deps.cwd,
+      output,
+      importModule: deps.importModule,
+      signal: deps.signal
+    });
+  }
+  output.stderr(`error: unknown command ${command}`);
+  output.stderr(USAGE);
+  return 2;
+};
+export {
+  DEFAULT_AGENTS_HOST,
+  runAgentsCommand
+};
+//# sourceMappingURL=cli.mjs.map

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

@@ -0,0 +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 { 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// console-server's proxy to the agent platform API.\n// The session service accepts organization API keys; console-server's proxy is\n// for signed-in users only.\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  '  conformance <module>              run the harness conformance kit against a harness the module exports',\n  '',\n  'options:',\n  '  --host <url>        agent platform API (default ' + DEFAULT_AGENTS_HOST + ')',\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  `  --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 (an organization API key). build checks compatibility only with it.',\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({ FINAL_API_KEY: z.string().min(1).optional() });\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  port: { 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) {\n    output.stderr(`error: unexpected arguments: ${extra.join(' ')}`);\n    return 2;\n  }\n  const env = envSchema.safeParse(deps.env);\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 ?? DEFAULT_AGENTS_HOST,\n      auth: { apiKey: key },\n      fetch: deps.fetch,\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 an organization 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      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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",
+  "names": []
+}

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

@@ -0,0 +1,36 @@
+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 { 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>;
+type ModuleExport = ModuleNamespace[string];
+export type ImportModule = (url: string) => Promise<ModuleNamespace>;
+export interface ConformanceTargetIface {
+    harness: HarnessIface;
+    dial: RunHarnessConformanceArgsIface['dial'];
+    nativeSessionId?: RunHarnessConformanceArgsIface['nativeSessionId'];
+}
+export declare const dialHarnessEndpoint: (endpoint: HarnessEndpointIface) => Promise<ConformanceStreamIface>;
+export type ConformanceTargetResult = {
+    ok: true;
+    target: ConformanceTargetIface;
+} | {
+    ok: false;
+    message: string;
+};
+export declare const conformanceTargetOf: (value: ModuleExport) => ConformanceTargetResult;
+export declare const reportLines: (report: HarnessConformanceReportIface) => string[];
+export declare const runConformance: (args: {
+    module: string;
+    exportName: string;
+    profile: string;
+    timeoutMs: number | null;
+    json: boolean;
+    cwd: string;
+    output: OutputIface;
+    importModule?: ImportModule;
+    signal?: AbortSignal;
+}) => Promise<number>;
+export {};

package/dist/modules/cli/conformance.mjs

@@ -0,0 +1,220 @@
+import { createHttpStream } from "@agentclientprotocol/sdk/experimental/http-client";
+import { ndJsonStream } from "@agentclientprotocol/sdk/experimental/v2";
+import { createWebSocketStream } from "@agentclientprotocol/sdk/experimental/ws-client";
+import {
+  AcpTransport
+} from "@finalai/agent-provider";
+import {
+  ConformanceCaseStatus,
+  ConformanceProfile,
+  conformanceOpenArgs,
+  runHarnessConformance
+} from "@finalai/agent-provider/conformance";
+import {
+  configureNodeClientWebSocket,
+  createNodeClientTlsSession
+} from "@finalai/websockets/node-client-tls";
+import { spawn } from "node:child_process";
+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
+));
+const functionCheck = z.function();
+const isFunction = (value) => functionCheck.safeParse(value).success;
+const harnessMethodsSchema = z.looseObject({
+  describe: z.custom(isFunction),
+  open: z.custom(isFunction),
+  resume: z.custom(isFunction),
+  park: z.custom(isFunction),
+  close: z.custom(isFunction),
+  health: z.custom(isFunction)
+});
+const harnessSchema = z.custom(
+  (value) => harnessMethodsSchema.safeParse(isFunction(value) ? Object.assign({}, value) : value).success
+);
+const dialSchema = z.custom(
+  isFunction,
+  "`dial` must be a function"
+);
+const nativeSessionIdSchema = z.custom(
+  isFunction,
+  "`nativeSessionId` must be a function"
+);
+const targetFieldsSchema = z.looseObject({
+  harness: harnessSchema,
+  dial: dialSchema.optional(),
+  nativeSessionId: nativeSessionIdSchema.optional()
+});
+const dialHarnessEndpoint = async (endpoint) => {
+  switch (endpoint.transport) {
+    case AcpTransport.Http: {
+      const headers = { ...endpoint.headers, ...await endpoint.resolveHeaders?.() };
+      const tlsSession = endpoint.tls == null ? null : createNodeClientTlsSession({ tls: endpoint.tls });
+      const stream = createHttpStream(endpoint.url, {
+        headers,
+        cookies: "omit",
+        fetch: tlsSession?.fetch
+      });
+      return {
+        ...stream,
+        close: () => {
+          void stream.writable.close().catch(() => void 0);
+          void tlsSession?.close().catch(() => void 0);
+        }
+      };
+    }
+    case AcpTransport.Ws: {
+      const headers = { ...endpoint.headers, ...await endpoint.resolveHeaders?.() };
+      const stream = createWebSocketStream(endpoint.url, {
+        cookies: "omit",
+        headers,
+        WebSocket: configureNodeClientWebSocket({ constructor: WebSocket, tls: endpoint.tls })
+      });
+      return {
+        ...stream,
+        close: () => void stream.writable.close().catch(() => void 0)
+      };
+    }
+    case AcpTransport.Stdio: {
+      const child = spawn(endpoint.command, endpoint.args, {
+        env: { ...process.env, ...endpoint.env },
+        stdio: ["pipe", "pipe", "inherit"]
+      });
+      child.stdin.on("error", () => void 0);
+      let open = true;
+      const input = new ReadableStream({
+        start: (controller) => {
+          child.stdout.on("data", (chunk) => {
+            if (open) controller.enqueue(new Uint8Array(chunk));
+          });
+          child.stdout.on("end", () => {
+            if (!open) return;
+            open = false;
+            controller.close();
+          });
+          child.on("error", (error) => {
+            if (!open) return;
+            open = false;
+            controller.error(error);
+          });
+        },
+        cancel: () => {
+          open = false;
+          child.stdout.destroy();
+        }
+      });
+      const output = new WritableStream({
+        write: (chunk) => new Promise((done, fail) => {
+          child.stdin.write(chunk, (error) => error == null ? done() : fail(error));
+        }),
+        close: () => {
+          child.stdin.end();
+        }
+      });
+      const stream = ndJsonStream(output, input);
+      return { ...stream, close: () => child.kill("SIGTERM") };
+    }
+    case AcpTransport.Relay:
+      throw new Error(
+        "relay endpoints are dialed by the session plane; export { harness, dial } to run them here"
+      );
+  }
+};
+const conformanceTargetOf = (value) => {
+  const harness = harnessSchema.safeParse(value);
+  if (harness.success)
+    return { ok: true, target: { harness: harness.data, dial: dialHarnessEndpoint } };
+  const fields = targetFieldsSchema.safeParse(value);
+  if (!fields.success) {
+    const issue = fields.error.issues.find((entry) => entry.path[0] !== "harness");
+    return {
+      ok: false,
+      message: issue?.message ?? "the export must be a HarnessIface or { harness, dial?, nativeSessionId? }"
+    };
+  }
+  return {
+    ok: true,
+    target: {
+      harness: fields.data.harness,
+      dial: fields.data.dial ?? dialHarnessEndpoint,
+      nativeSessionId: fields.data.nativeSessionId
+    }
+  };
+};
+const statusLabel = {
+  [ConformanceCaseStatus.Passed]: "pass",
+  [ConformanceCaseStatus.Failed]: "FAIL",
+  [ConformanceCaseStatus.Skipped]: "skip"
+};
+const reportLines = (report) => [
+  `profile: ${report.profile}`,
+  ...report.cases.map((entry) => {
+    const why = entry.error ?? entry.detail;
+    return `${statusLabel[entry.status]}  ${entry.name}${why == null ? "" : ` (${why})`}`;
+  }),
+  report.passed ? "conformance: passed" : "conformance: failed"
+];
+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 ")}`
+    );
+    return 2;
+  }
+  const url = pathToFileURL(resolve(args.cwd, args.module)).href;
+  let loaded;
+  try {
+    loaded = await (args.importModule ?? importModule)(url);
+  } catch (cause) {
+    args.output.stderr(
+      `error: cannot load ${args.module}: ${cause instanceof Error ? cause.message : String(cause)}`
+    );
+    return 1;
+  }
+  if (!(args.exportName in loaded)) {
+    args.output.stderr(`error: ${args.module} has no export ${args.exportName}`);
+    return 1;
+  }
+  const parsed = conformanceTargetOf(loaded[args.exportName]);
+  if (!parsed.ok) {
+    args.output.stderr(`error: ${args.module}#${args.exportName}: ${parsed.message}`);
+    return 1;
+  }
+  const target = parsed.target;
+  const run = runHarnessConformance({
+    harness: target.harness,
+    dial: target.dial,
+    nativeSessionId: target.nativeSessionId,
+    profile: profile.data,
+    openArgs: conformanceOpenArgs(),
+    timeoutMs: args.timeoutMs ?? void 0,
+    cwd: args.cwd
+  });
+  const signal = args.signal;
+  const interrupted = signal == null ? null : new Promise((done) => {
+    if (signal.aborted) done(null);
+    else signal.addEventListener("abort", () => done(null), { once: true });
+  });
+  const report = await (interrupted == null ? run : Promise.race([run, interrupted]));
+  if (report == null) {
+    run.catch(() => void 0);
+    args.output.stderr("conformance: interrupted");
+    return 130;
+  }
+  if (args.json) args.output.stdout(JSON.stringify(report, null, 2));
+  else for (const line of reportLines(report)) args.output.stdout(line);
+  return report.passed ? 0 : 1;
+};
+export {
+  conformanceTargetOf,
+  dialHarnessEndpoint,
+  reportLines,
+  runConformance
+};
+//# sourceMappingURL=conformance.mjs.map

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

@@ -0,0 +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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",
+  "names": []
+}

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

@@ -0,0 +1,24 @@
+import { type OutputIface } from "./output.mjs";
+export declare const DEFAULT_DEV_PORT = 3000;
+export declare const parseLocalSecrets: (text: string | undefined) => Record<string, string> | null;
+export interface DevServerArgsIface {
+    dir: string;
+    port: number;
+    hostname?: string;
+    secrets: Record<string, string>;
+    output: OutputIface;
+    fetch?: typeof fetch;
+}
+export interface DevServerIface {
+    url: string;
+    reload(): Promise<boolean>;
+    close(): Promise<void>;
+}
+export declare const startDevServer: (args: DevServerArgsIface) => Promise<DevServerIface>;
+export declare const runDev: (args: {
+    dir: string;
+    port: number;
+    env: Record<string, string | undefined>;
+    output: OutputIface;
+    signal: AbortSignal;
+}) => Promise<number>;