@finalai/agents 0.8.0

package/dist/modules/cli/output.mjs

@@ -0,0 +1,94 @@
+import {
+  findDynamicSlots,
+  formatProviderRef,
+  isDynamicSlot
+} from "@finalai/agent-provider";
+import * as z from "zod";
+import { isClientError } from "../agent-client/errors.mjs";
+import { diagnosticSchema } from "../agent-client/index.mjs";
+const listOrNone = (items) => items.length === 0 ? "none" : items.join(", ");
+const manifestSummaryLines = (manifest) => {
+  const lines = [`agent: ${manifest.identity.name}`];
+  if (manifest.identity.description != null)
+    lines.push(`description: ${manifest.identity.description}`);
+  lines.push(`harness: ${formatProviderRef(manifest.harness.harness)}`);
+  lines.push(
+    `mcp servers: ${isDynamicSlot(manifest.mcpServers) ? "dynamic" : listOrNone(manifest.mcpServers.map((server) => `${server.key} (${server.kind})`))}`
+  );
+  lines.push(
+    `sandboxes: ${isDynamicSlot(manifest.sandboxes) ? "dynamic" : listOrNone(Object.keys(manifest.sandboxes))}`
+  );
+  lines.push(
+    `base tools: ${listOrNone(
+      Object.entries(manifest.tools.base).map(
+        ([capability, binding]) => `${capability} \u2192 ${binding?.target ?? "?"}`
+      )
+    )}`
+  );
+  lines.push(`channels: ${listOrNone(manifest.channels.map((channel) => channel.key))}`);
+  lines.push(
+    `schedules: ${listOrNone(
+      manifest.schedules.map(
+        (schedule) => `${schedule.key} (${schedule.cron}, ${schedule.timezone})`
+      )
+    )}`
+  );
+  lines.push(`secrets: ${listOrNone(manifest.secrets)}`);
+  lines.push(`dynamic slots: ${listOrNone(findDynamicSlots(manifest).map((slot) => slot.path))}`);
+  lines.push(`bundle: ${manifest.bundle?.hash ?? "none"}`);
+  return lines;
+};
+const hookLines = (manifest) => manifest.hooks.length === 0 ? ["hooks: none"] : [
+  "hooks:",
+  ...manifest.hooks.map(
+    (hook) => `  ${hook.slug} (${hook.export}): ${hook.events.join(", ")}`
+  )
+];
+const reportLines = (report) => [
+  `compatibility with ${formatProviderRef(report.harness)}: ${report.ok ? "ok" : "incompatible"}`,
+  ...report.rows.map((row) => `  ${row.item}: ${row.result} (${row.why})`)
+];
+const diagnosticLine = (item) => `${item.severity}: ${item.path == null ? "" : `${item.path}: `}${item.message} [${item.code}]`;
+const errorDiagnosticsSchema = z.object({
+  error: z.object({
+    details: z.object({ diagnostics: z.array(diagnosticSchema) }).nullable()
+  })
+});
+const errorLines = (cause) => {
+  if (!isClientError(cause))
+    return [`error: ${cause instanceof Error ? cause.message : String(cause)}`];
+  const lines = [`error: ${cause.message}${cause.status === 0 ? "" : ` (HTTP ${cause.status})`}`];
+  const parsed = errorDiagnosticsSchema.safeParse(cause.body);
+  for (const item of parsed.success ? parsed.data.error.details?.diagnostics ?? [] : []) {
+    lines.push(`  ${item.severity}: ${item.file == null ? "" : `${item.file}: `}${item.message}`);
+  }
+  return lines;
+};
+const publishResultLines = (result) => {
+  const revision = result.revision;
+  const lines = [
+    `${result.created ? "published" : "already current"}: revision ${revision.number} (${revision.id})`,
+    `commit: ${revision.commitSha ?? "unknown"}`,
+    `bundle: ${revision.bundleHash ?? "none"}`
+  ];
+  for (const item of result.diagnostics) lines.push(`${item.severity}: ${item.message}`);
+  for (const channel of result.channels) {
+    lines.push(`channel ${channel.key} (${channel.bindingId}):`);
+    for (const route of channel.routes) {
+      lines.push(`  ${route.method} ${route.url ?? route.aliasUrl}`);
+      if (route.url != null) lines.push(`    alias: ${route.aliasUrl}`);
+    }
+    if (channel.webhookSecret != null)
+      lines.push(`  signing secret (shown once): ${channel.webhookSecret}`);
+  }
+  return lines;
+};
+export {
+  diagnosticLine,
+  errorLines,
+  hookLines,
+  manifestSummaryLines,
+  publishResultLines,
+  reportLines
+};
+//# sourceMappingURL=output.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/output.ts"],
+  "sourcesContent": ["import type { CompatibilityReportIface } from '@finalai/agent-definition/compatibility';\nimport type { DiagnosticIface } from '@finalai/agent-definition/compiler';\nimport {\n  findDynamicSlots,\n  formatProviderRef,\n  isDynamicSlot,\n  type AgentManifestIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { isClientError } from \"../agent-client/errors.mjs\";\nimport { diagnosticSchema, type PublishResultIface } from \"../agent-client/index.mjs\";\n\nexport interface OutputIface {\n  stdout: (line: string) => void;\n  stderr: (line: string) => void;\n}\n\nconst listOrNone = (items: readonly string[]): string =>\n  items.length === 0 ? 'none' : items.join(', ');\n\nexport const manifestSummaryLines = (manifest: AgentManifestIface): string[] => {\n  const lines = [`agent: ${manifest.identity.name}`];\n  if (manifest.identity.description != null)\n    lines.push(`description: ${manifest.identity.description}`);\n  lines.push(`harness: ${formatProviderRef(manifest.harness.harness)}`);\n  lines.push(\n    `mcp servers: ${\n      isDynamicSlot(manifest.mcpServers)\n        ? 'dynamic'\n        : listOrNone(manifest.mcpServers.map((server) => `${server.key} (${server.kind})`))\n    }`,\n  );\n  lines.push(\n    `sandboxes: ${\n      isDynamicSlot(manifest.sandboxes) ? 'dynamic' : listOrNone(Object.keys(manifest.sandboxes))\n    }`,\n  );\n  lines.push(\n    `base tools: ${listOrNone(\n      Object.entries(manifest.tools.base).map(\n        ([capability, binding]) => `${capability} \u2192 ${binding?.target ?? '?'}`,\n      ),\n    )}`,\n  );\n  lines.push(`channels: ${listOrNone(manifest.channels.map((channel) => channel.key))}`);\n  lines.push(\n    `schedules: ${listOrNone(\n      manifest.schedules.map(\n        (schedule) => `${schedule.key} (${schedule.cron}, ${schedule.timezone})`,\n      ),\n    )}`,\n  );\n  lines.push(`secrets: ${listOrNone(manifest.secrets)}`);\n  lines.push(`dynamic slots: ${listOrNone(findDynamicSlots(manifest).map((slot) => slot.path))}`);\n  lines.push(`bundle: ${manifest.bundle?.hash ?? 'none'}`);\n  return lines;\n};\n\nexport const hookLines = (manifest: AgentManifestIface): string[] =>\n  manifest.hooks.length === 0\n    ? ['hooks: none']\n    : [\n        'hooks:',\n        ...manifest.hooks.map(\n          (hook) => `  ${hook.slug} (${hook.export}): ${hook.events.join(', ')}`,\n        ),\n      ];\n\nexport const reportLines = (report: CompatibilityReportIface): string[] => [\n  `compatibility with ${formatProviderRef(report.harness)}: ${report.ok ? 'ok' : 'incompatible'}`,\n  ...report.rows.map((row) => `  ${row.item}: ${row.result} (${row.why})`),\n];\n\nexport const diagnosticLine = (item: DiagnosticIface): string =>\n  `${item.severity}: ${item.path == null ? '' : `${item.path}: `}${item.message} [${item.code}]`;\n\nconst errorDiagnosticsSchema = z.object({\n  error: z.object({\n    details: z.object({ diagnostics: z.array(diagnosticSchema) }).nullable(),\n  }),\n});\n\n// SDK errors with the server's compile diagnostics, when it sent any.\nexport const errorLines = (cause: unknown): string[] => {\n  if (!isClientError(cause))\n    return [`error: ${cause instanceof Error ? cause.message : String(cause)}`];\n  const lines = [`error: ${cause.message}${cause.status === 0 ? '' : ` (HTTP ${cause.status})`}`];\n  const parsed = errorDiagnosticsSchema.safeParse(cause.body);\n  for (const item of parsed.success ? (parsed.data.error.details?.diagnostics ?? []) : []) {\n    lines.push(`  ${item.severity}: ${item.file == null ? '' : `${item.file}: `}${item.message}`);\n  }\n  return lines;\n};\n\nexport const publishResultLines = (result: PublishResultIface): string[] => {\n  const revision = result.revision;\n  const lines = [\n    `${result.created ? 'published' : 'already current'}: revision ${revision.number} (${revision.id})`,\n    `commit: ${revision.commitSha ?? 'unknown'}`,\n    `bundle: ${revision.bundleHash ?? 'none'}`,\n  ];\n  for (const item of result.diagnostics) lines.push(`${item.severity}: ${item.message}`);\n  for (const channel of result.channels) {\n    lines.push(`channel ${channel.key} (${channel.bindingId}):`);\n    for (const route of channel.routes) {\n      lines.push(`  ${route.method} ${route.url ?? route.aliasUrl}`);\n      if (route.url != null) lines.push(`    alias: ${route.aliasUrl}`);\n    }\n    if (channel.webhookSecret != null)\n      lines.push(`  signing secret (shown once): ${channel.webhookSecret}`);\n  }\n  return lines;\n};\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,14 @@
+import type { AgentClientIface } from "../agent-client/client.mjs";
+import { type ListFiles } from "./files.mjs";
+import { type OutputIface } from "./output.mjs";
+export interface PublishArgsIface {
+    dir: string;
+    agent: string;
+    ref: string | null;
+    message: string;
+    note: string | null;
+    client: AgentClientIface;
+    listFiles: ListFiles;
+    output: OutputIface;
+}
+export declare const runPublish: (args: PublishArgsIface) => Promise<number>;

package/dist/modules/cli/publish.mjs

@@ -0,0 +1,89 @@
+import { isClientError } from "../agent-client/errors.mjs";
+import { DefinitionRepositoryKind } from "../agent-client/index.mjs";
+import { compileAndPrint } from "./build.mjs";
+import { fileChanges, readLocalFiles } from "./files.mjs";
+import { errorLines, publishResultLines } from "./output.mjs";
+const remoteFiles = async (args) => {
+  try {
+    const listing = await args.client.definitions.files({
+      definition: args.definition.id,
+      ref: args.branch
+    });
+    return {
+      commitSha: listing.commitSha,
+      files: Object.fromEntries(listing.files.map((file) => [file.path, file.content]))
+    };
+  } catch (cause) {
+    if (isClientError(cause) && cause.status === 404) return { commitSha: null, files: {} };
+    throw cause;
+  }
+};
+const commitCheckout = async (args) => {
+  const { client, output, message } = args.publish;
+  const remote = await remoteFiles({ client, definition: args.definition, branch: args.branch });
+  const changes = fileChanges({ local: args.local, remote: remote.files });
+  if (changes.length === 0 && remote.commitSha != null) {
+    output.stdout(`no changes; publishing ${args.branch} at ${remote.commitSha}`);
+    return remote.commitSha;
+  }
+  const request = {
+    definition: args.definition.id,
+    files: changes,
+    message,
+    branch: args.branch
+  };
+  if (remote.commitSha != null) request.parentSha = remote.commitSha;
+  const committed = await client.definitions.commit(request);
+  const deleted = changes.filter((change) => change.content == null).length;
+  output.stdout(
+    `committed ${committed.commitSha} to ${committed.branch} (${changes.length - deleted} written, ${deleted} deleted)`
+  );
+  return committed.commitSha;
+};
+const runPublish = async (args) => {
+  const { client, output } = args;
+  try {
+    const local = await readLocalFiles({ dir: args.dir, listFiles: args.listFiles });
+    for (const problem of local.problems) output.stderr(`error: ${problem}`);
+    if (local.problems.length > 0) return 1;
+    const compiled = await compileAndPrint({ source: { files: local.files }, client, output });
+    if (!compiled.ok) {
+      output.stderr("error: the agent did not compile; nothing was published");
+      return 1;
+    }
+    const definition = await client.definitions.get({ definition: args.agent });
+    const repository = definition.repository;
+    const kind = repository?.kind ?? DefinitionRepositoryKind.CodeStorage;
+    const branch = repository?.defaultBranch ?? "main";
+    let ref;
+    if (kind === DefinitionRepositoryKind.GitHub) {
+      ref = args.ref ?? branch;
+    } else if (kind === DefinitionRepositoryKind.CodeStorage) {
+      if (args.ref != null) {
+        output.stderr(
+          "error: --ref applies to GitHub-backed agents; this agent is published from the checkout"
+        );
+        return 1;
+      }
+      ref = await commitCheckout({ publish: args, definition, branch, local: local.files });
+    } else {
+      output.stderr(`error: ${args.agent} uses a repository kind this CLI does not know`);
+      return 1;
+    }
+    const request = {
+      definition: definition.id,
+      ref
+    };
+    if (args.note != null) request.note = args.note;
+    const result = await client.definitions.publish(request);
+    for (const line of publishResultLines(result)) output.stdout(line);
+    return 0;
+  } catch (cause) {
+    for (const line of errorLines(cause)) output.stderr(line);
+    return 1;
+  }
+};
+export {
+  runPublish
+};
+//# sourceMappingURL=publish.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/publish.ts"],
+  "sourcesContent": ["import type { AgentClientIface } from \"../agent-client/client.mjs\";\nimport { isClientError } from \"../agent-client/errors.mjs\";\nimport { DefinitionRepositoryKind, type DefinitionIface } from \"../agent-client/index.mjs\";\nimport { compileAndPrint } from \"./build.mjs\";\nimport { fileChanges, readLocalFiles, type ListFiles } from \"./files.mjs\";\nimport { errorLines, publishResultLines, type OutputIface } from \"./output.mjs\";\n\n// `final agents publish`: compiles the checkout\n// locally, commits it to the agent's default branch, and publishes that\n// commit. A GitHub-backed definition is not committed to; its ref (the\n// default branch unless given) is published as-is.\n\nexport interface PublishArgsIface {\n  dir: string;\n  // Definition slug or id.\n  agent: string;\n  // GitHub-backed definitions only.\n  ref: string | null;\n  message: string;\n  note: string | null;\n  client: AgentClientIface;\n  listFiles: ListFiles;\n  output: OutputIface;\n}\n\n// The default branch's files and head; an empty repository has neither.\nconst remoteFiles = async (args: {\n  client: AgentClientIface;\n  definition: DefinitionIface;\n  branch: string;\n}): Promise<{ commitSha: string | null; files: Record<string, string> }> => {\n  try {\n    const listing = await args.client.definitions.files({\n      definition: args.definition.id,\n      ref: args.branch,\n    });\n    return {\n      commitSha: listing.commitSha,\n      files: Object.fromEntries(listing.files.map((file) => [file.path, file.content])),\n    };\n  } catch (cause) {\n    if (isClientError(cause) && cause.status === 404) return { commitSha: null, files: {} };\n    throw cause;\n  }\n};\n\nconst commitCheckout = async (args: {\n  publish: PublishArgsIface;\n  definition: DefinitionIface;\n  branch: string;\n  local: Record<string, string>;\n}): Promise<string> => {\n  const { client, output, message } = args.publish;\n  const remote = await remoteFiles({ client, definition: args.definition, branch: args.branch });\n  const changes = fileChanges({ local: args.local, remote: remote.files });\n  if (changes.length === 0 && remote.commitSha != null) {\n    output.stdout(`no changes; publishing ${args.branch} at ${remote.commitSha}`);\n    return remote.commitSha;\n  }\n  const request: Parameters<AgentClientIface['definitions']['commit']>[0] = {\n    definition: args.definition.id,\n    files: changes,\n    message,\n    branch: args.branch,\n  };\n  // The commit fails if the branch moved since it was read.\n  if (remote.commitSha != null) request.parentSha = remote.commitSha;\n  const committed = await client.definitions.commit(request);\n  const deleted = changes.filter((change) => change.content == null).length;\n  output.stdout(\n    `committed ${committed.commitSha} to ${committed.branch} (${changes.length - deleted} written, ${deleted} deleted)`,\n  );\n  return committed.commitSha;\n};\n\nexport const runPublish = async (args: PublishArgsIface): Promise<number> => {\n  const { client, output } = args;\n  try {\n    const local = await readLocalFiles({ dir: args.dir, listFiles: args.listFiles });\n    for (const problem of local.problems) output.stderr(`error: ${problem}`);\n    if (local.problems.length > 0) return 1;\n\n    // What the platform compiles is the committed files, so compile those.\n    const compiled = await compileAndPrint({ source: { files: local.files }, client, output });\n    if (!compiled.ok) {\n      output.stderr('error: the agent did not compile; nothing was published');\n      return 1;\n    }\n\n    const definition = await client.definitions.get({ definition: args.agent });\n    const repository = definition.repository;\n    const kind = repository?.kind ?? DefinitionRepositoryKind.CodeStorage;\n    const branch = repository?.defaultBranch ?? 'main';\n    let ref: string;\n    if (kind === DefinitionRepositoryKind.GitHub) {\n      ref = args.ref ?? branch;\n    } else if (kind === DefinitionRepositoryKind.CodeStorage) {\n      if (args.ref != null) {\n        output.stderr(\n          'error: --ref applies to GitHub-backed agents; this agent is published from the checkout',\n        );\n        return 1;\n      }\n      ref = await commitCheckout({ publish: args, definition, branch, local: local.files });\n    } else {\n      output.stderr(`error: ${args.agent} uses a repository kind this CLI does not know`);\n      return 1;\n    }\n\n    const request: Parameters<AgentClientIface['definitions']['publish']>[0] = {\n      definition: definition.id,\n      ref,\n    };\n    if (args.note != null) request.note = args.note;\n    const result = await client.definitions.publish(request);\n    for (const line of publishResultLines(result)) output.stdout(line);\n    return 0;\n  } catch (cause) {\n    for (const line of errorLines(cause)) output.stderr(line);\n    return 1;\n  }\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/compile.d.mts

@@ -0,0 +1,3 @@
+import type { CompileOptionsIface, CompileResultIface } from '@finalai/agent-definition/compiler';
+export declare const compile: (options: CompileOptionsIface) => Promise<CompileResultIface>;
+export type { CompatibilityReportIface, CompiledBundleIface, CompileOptionsIface, CompileResultIface, DiagnosticCode, DiagnosticIface, DiagnosticSeverity, HarnessDescriptionContextIface, } from '@finalai/agent-definition/compiler';

package/dist/modules/compile.mjs

@@ -0,0 +1,62 @@
+import { fileURLToPath } from "node:url";
+const compile = async (options) => {
+  const finalAuthoringModules = [
+    "harnesses",
+    "harnesses/models",
+    "harnesses/config-fields",
+    "harnesses/serverless-final",
+    "harnesses/serverless-pi",
+    "harnesses/serverless-nanocode-codex",
+    "harnesses/serverless-nanocode-claude",
+    "harnesses/remote-pi",
+    "harnesses/remote-codex",
+    "harnesses/remote-claude-code",
+    "harnesses/remote-acp",
+    "harnesses/local-stdio",
+    "sandboxes",
+    "sandboxes/computer",
+    "sandboxes/device",
+    "sandboxes/environment",
+    "connections",
+    "channels/final",
+    "channel-factories"
+  ].map((path) => "@finalai/final-agent-provider/" + path);
+  const providerModules = {
+    ...Object.fromEntries(
+      finalAuthoringModules.map((specifier) => [
+        specifier,
+        fileURLToPath(import.meta.resolve(specifier))
+      ])
+    ),
+    "@finalai/agents": fileURLToPath(import.meta.resolve("@finalai/agents/authoring")),
+    "@finalai/agents/harnesses": fileURLToPath(
+      import.meta.resolve("@finalai/final-agent-provider/harnesses")
+    ),
+    "@finalai/agents/models": fileURLToPath(
+      import.meta.resolve("@finalai/final-agent-provider/harnesses/models")
+    ),
+    "@finalai/agents/sandboxes": fileURLToPath(
+      import.meta.resolve("@finalai/final-agent-provider/sandboxes")
+    ),
+    "@finalai/agents/channels/final": fileURLToPath(
+      import.meta.resolve("@finalai/final-agent-provider/channels/final")
+    ),
+    ...options.providerModules
+  };
+  return (await import("@finalai/agent-definition/compiler")).compile({
+    defaultFiles: {
+      "channels/final.ts": "import { finalChannel } from '@finalai/agents/channels/final'; export default finalChannel();"
+    },
+    ...options,
+    providerModules,
+    installedSandboxProviders: {
+      computer: "@finalai/final-agent-provider/sandboxes/computer",
+      device: "@finalai/final-agent-provider/sandboxes/device",
+      ...options.installedSandboxProviders
+    }
+  });
+};
+export {
+  compile
+};
+//# sourceMappingURL=compile.mjs.map

package/dist/modules/compile.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/compile.ts"],
+  "sourcesContent": ["import type { CompileOptionsIface, CompileResultIface } from '@finalai/agent-definition/compiler';\nimport { fileURLToPath } from 'node:url';\nexport const compile = async (options: CompileOptionsIface): Promise<CompileResultIface> => {\n  const finalAuthoringModules = [\n    'harnesses',\n    'harnesses/models',\n    'harnesses/config-fields',\n    'harnesses/serverless-final',\n    'harnesses/serverless-pi',\n    'harnesses/serverless-nanocode-codex',\n    'harnesses/serverless-nanocode-claude',\n    'harnesses/remote-pi',\n    'harnesses/remote-codex',\n    'harnesses/remote-claude-code',\n    'harnesses/remote-acp',\n    'harnesses/local-stdio',\n    'sandboxes',\n    'sandboxes/computer',\n    'sandboxes/device',\n    'sandboxes/environment',\n    'connections',\n    'channels/final',\n    'channel-factories',\n  ].map((path) => '@finalai/final-agent-provider/' + path);\n  const providerModules = {\n    ...Object.fromEntries(\n      finalAuthoringModules.map((specifier) => [\n        specifier,\n        fileURLToPath(import.meta.resolve(specifier)),\n      ]),\n    ),\n    '@finalai/agents': fileURLToPath(import.meta.resolve('@finalai/agents/authoring')),\n    '@finalai/agents/harnesses': fileURLToPath(\n      import.meta.resolve('@finalai/final-agent-provider/harnesses'),\n    ),\n    '@finalai/agents/models': fileURLToPath(\n      import.meta.resolve('@finalai/final-agent-provider/harnesses/models'),\n    ),\n    '@finalai/agents/sandboxes': fileURLToPath(\n      import.meta.resolve('@finalai/final-agent-provider/sandboxes'),\n    ),\n    '@finalai/agents/channels/final': fileURLToPath(\n      import.meta.resolve('@finalai/final-agent-provider/channels/final'),\n    ),\n    ...options.providerModules,\n  };\n  return (await import('@finalai/agent-definition/compiler')).compile({\n    defaultFiles: {\n      'channels/final.ts':\n        \"import { finalChannel } from '@finalai/agents/channels/final'; export default finalChannel();\",\n    },\n    ...options,\n    providerModules,\n    installedSandboxProviders: {\n      computer: '@finalai/final-agent-provider/sandboxes/computer',\n      device: '@finalai/final-agent-provider/sandboxes/device',\n      ...options.installedSandboxProviders,\n    },\n  });\n};\nexport type {\n  CompatibilityReportIface,\n  CompiledBundleIface,\n  CompileOptionsIface,\n  CompileResultIface,\n  DiagnosticCode,\n  DiagnosticIface,\n  DiagnosticSeverity,\n  HarnessDescriptionContextIface,\n} from '@finalai/agent-definition/compiler';\n"],
+  "mappings": "AACA,SAAS,qBAAqB;AACvB,MAAM,UAAU,OAAO,YAA8D;AAC1F,QAAM,wBAAwB;AAAA,IAC5B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,IAAI,CAAC,SAAS,mCAAmC,IAAI;AACvD,QAAM,kBAAkB;AAAA,IACtB,GAAG,OAAO;AAAA,MACR,sBAAsB,IAAI,CAAC,cAAc;AAAA,QACvC;AAAA,QACA,cAAc,YAAY,QAAQ,SAAS,CAAC;AAAA,MAC9C,CAAC;AAAA,IACH;AAAA,IACA,mBAAmB,cAAc,YAAY,QAAQ,2BAA2B,CAAC;AAAA,IACjF,6BAA6B;AAAA,MAC3B,YAAY,QAAQ,yCAAyC;AAAA,IAC/D;AAAA,IACA,0BAA0B;AAAA,MACxB,YAAY,QAAQ,gDAAgD;AAAA,IACtE;AAAA,IACA,6BAA6B;AAAA,MAC3B,YAAY,QAAQ,yCAAyC;AAAA,IAC/D;AAAA,IACA,kCAAkC;AAAA,MAChC,YAAY,QAAQ,8CAA8C;AAAA,IACpE;AAAA,IACA,GAAG,QAAQ;AAAA,EACb;AACA,UAAQ,MAAM,OAAO,oCAAoC,GAAG,QAAQ;AAAA,IAClE,cAAc;AAAA,MACZ,qBACE;AAAA,IACJ;AAAA,IACA,GAAG;AAAA,IACH;AAAA,IACA,2BAA2B;AAAA,MACzB,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,GAAG,QAAQ;AAAA,IACb;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/modules/harnesses.d.mts

@@ -0,0 +1 @@
+export * from '@finalai/final-agent-provider/harnesses';

package/dist/modules/harnesses.mjs

@@ -0,0 +1,2 @@
+export * from "@finalai/final-agent-provider/harnesses";
+//# sourceMappingURL=harnesses.mjs.map

package/dist/modules/harnesses.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/harnesses.ts"],
+  "sourcesContent": ["export * from '@finalai/final-agent-provider/harnesses';\n"],
+  "mappings": "AAAA,cAAc;",
+  "names": []
+}

package/dist/modules/index.browser.d.mts

@@ -0,0 +1,4 @@
+export type { CompatibilityReportIface, CompiledBundleIface, CompileOptionsIface, CompileResultIface, DiagnosticCode, DiagnosticIface, DiagnosticSeverity, HarnessDescriptionContextIface, } from "./compile.mjs";
+export * from "./public.mjs";
+import type { CompileOptionsIface, CompileResultIface } from "./compile.mjs";
+export declare const compile: (_options: CompileOptionsIface) => Promise<CompileResultIface>;

package/dist/modules/index.browser.mjs

@@ -0,0 +1,8 @@
+export * from "./public.mjs";
+const compile = async (_options) => {
+  throw new Error("Agent directory compilation requires Node.js.");
+};
+export {
+  compile
+};
+//# sourceMappingURL=index.browser.mjs.map

package/dist/modules/index.browser.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/index.browser.ts"],
+  "sourcesContent": ["export type {\n  CompatibilityReportIface,\n  CompiledBundleIface,\n  CompileOptionsIface,\n  CompileResultIface,\n  DiagnosticCode,\n  DiagnosticIface,\n  DiagnosticSeverity,\n  HarnessDescriptionContextIface,\n} from \"./compile.mjs\";\nexport * from \"./public.mjs\";\nimport type { CompileOptionsIface, CompileResultIface } from \"./compile.mjs\";\n\nexport const compile = async (_options: CompileOptionsIface): Promise<CompileResultIface> => {\n  throw new Error('Agent directory compilation requires Node.js.');\n};\n"],
+  "mappings": "AAUA,cAAc;AAGP,MAAM,UAAU,OAAO,aAA+D;AAC3F,QAAM,IAAI,MAAM,+CAA+C;AACjE;",
+  "names": []
+}

package/dist/modules/index.d.mts

@@ -0,0 +1,3 @@
+export * from "./public.mjs";
+export { compile } from "./compile.mjs";
+export type { CompatibilityReportIface, CompileOptionsIface, CompileResultIface, CompiledBundleIface, DiagnosticCode, DiagnosticIface, DiagnosticSeverity, HarnessDescriptionContextIface, } from "./compile.mjs";

package/dist/modules/index.mjs

@@ -0,0 +1,6 @@
+export * from "./public.mjs";
+import { compile } from "./compile.mjs";
+export {
+  compile
+};
+//# sourceMappingURL=index.mjs.map

package/dist/modules/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/index.ts"],
+  "sourcesContent": ["export * from \"./public.mjs\";\n\n// Node compiler entrypoint.\nexport { compile } from \"./compile.mjs\";\nexport type {\n  CompatibilityReportIface,\n  CompileOptionsIface,\n  CompileResultIface,\n  CompiledBundleIface,\n  DiagnosticCode,\n  DiagnosticIface,\n  DiagnosticSeverity,\n  HarnessDescriptionContextIface,\n} from \"./compile.mjs\";\n"],
+  "mappings": "AAAA,cAAc;AAGd,SAAS,eAAe;",
+  "names": []
+}

package/dist/modules/models.d.mts

@@ -0,0 +1 @@
+export * from '@finalai/final-agent-provider/harnesses/models';

package/dist/modules/models.mjs

@@ -0,0 +1,2 @@
+export * from "@finalai/final-agent-provider/harnesses/models";
+//# sourceMappingURL=models.mjs.map

package/dist/modules/models.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/models.ts"],
+  "sourcesContent": ["export * from '@finalai/final-agent-provider/harnesses/models';\n"],
+  "mappings": "AAAA,cAAc;",
+  "names": []
+}

package/dist/modules/public.d.mts

@@ -0,0 +1,6 @@
+export { CredentialOwner, CredentialPayer, DELETE, GET, HookEvent, POST, PUT, SandboxWire, WS, always, baseTools, credentials, defineAgent, defineChannel, disableChannel, defineProviderChannel, defineDynamic, defineHarness, defineHook, defineInstructions, defineMcpClientConnection, defineSandbox, defineSandboxProvider, defineSchedule, defineSkill, defineTool, harnessHost, never, toolResultFrom, whenInput, } from "./authoring/index.mjs";
+export type { AgentDefinitionInputIface, AgentSessionInfoIface, ApprovalPolicyIface, AuthoredChannelDefinitionIface, AuthoredHarnessCloseContextIface, AuthoredHarnessDescriptionIface, AuthoredHarnessEndpointIface, AuthoredHarnessHealthIface, AuthoredHarnessIface, AuthoredHarnessOpenArgsIface, AuthoredHarnessRefContextIface, AuthoredHarnessResumeArgsIface, BaseToolsValueIface, ConversationInfoIface, CredentialNode, CredentialPolicyIface, DefinedAuthoredHarnessIface, DefinedToolIface, DynamicDefinitionIface, DynamicResolveContextIface, DynamicSentinelIface, FinalPlatformClientIface, HarnessHostIface, HookContextIface, HookDefinitionIface, HookEventIface, McpClientConnectionDefinitionIface, SandboxSelectorContextIface, ScheduleInputIface, SkillDefinitionIface, ToolContextIface, ToolDefinitionIface, } from "./authoring/index.mjs";
+export * from "./authoring/providers.mjs";
+export type { AgentManifestIface, ChannelDefinitionIface, ChannelPlatformIface, ChannelSocketIface, HarnessDescriptionIface, HarnessEndpointIface, HarnessIface, HarnessSessionRefIface, McpChannelIface, NetworkSandboxSessionIface, ResolvedAgentManifestIface, RouteDefinitionIface, SandboxMcpEndpoint, SandboxPrepareContextIface, SandboxProcessIface, SandboxProviderHandleIface, SandboxProviderIface, SandboxProviderImplementationIface, SandboxSessionIface, SandboxStartContextIface, ScreenSessionIface, } from '@finalai/agent-provider';
+export { defineFinalConnection } from '@finalai/final-agent-provider/connections';
+export type { FinalConnectionDefinitionIface } from '@finalai/final-agent-provider/connections';

package/dist/modules/public.mjs

@@ -0,0 +1,68 @@
+import {
+  CredentialOwner,
+  CredentialPayer,
+  DELETE,
+  GET,
+  HookEvent,
+  POST,
+  PUT,
+  SandboxWire,
+  WS,
+  always,
+  baseTools,
+  credentials,
+  defineAgent,
+  defineChannel,
+  disableChannel,
+  defineProviderChannel,
+  defineDynamic,
+  defineHarness,
+  defineHook,
+  defineInstructions,
+  defineMcpClientConnection,
+  defineSandbox,
+  defineSandboxProvider,
+  defineSchedule,
+  defineSkill,
+  defineTool,
+  harnessHost,
+  never,
+  toolResultFrom,
+  whenInput
+} from "./authoring/index.mjs";
+export * from "./authoring/providers.mjs";
+import { defineFinalConnection } from "@finalai/final-agent-provider/connections";
+export {
+  CredentialOwner,
+  CredentialPayer,
+  DELETE,
+  GET,
+  HookEvent,
+  POST,
+  PUT,
+  SandboxWire,
+  WS,
+  always,
+  baseTools,
+  credentials,
+  defineAgent,
+  defineChannel,
+  defineDynamic,
+  defineFinalConnection,
+  defineHarness,
+  defineHook,
+  defineInstructions,
+  defineMcpClientConnection,
+  defineProviderChannel,
+  defineSandbox,
+  defineSandboxProvider,
+  defineSchedule,
+  defineSkill,
+  defineTool,
+  disableChannel,
+  harnessHost,
+  never,
+  toolResultFrom,
+  whenInput
+};
+//# sourceMappingURL=public.mjs.map

package/dist/modules/public.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/public.ts"],
+  "sourcesContent": ["// Agent authoring.\nexport {\n  CredentialOwner,\n  CredentialPayer,\n  DELETE,\n  GET,\n  HookEvent,\n  POST,\n  PUT,\n  SandboxWire,\n  WS,\n  always,\n  baseTools,\n  credentials,\n  defineAgent,\n  defineChannel,\n  disableChannel,\n  defineProviderChannel,\n  defineDynamic,\n  defineHarness,\n  defineHook,\n  defineInstructions,\n  defineMcpClientConnection,\n  defineSandbox,\n  defineSandboxProvider,\n  defineSchedule,\n  defineSkill,\n  defineTool,\n  harnessHost,\n  never,\n  toolResultFrom,\n  whenInput,\n} from \"./authoring/index.mjs\";\nexport type {\n  AgentDefinitionInputIface,\n  AgentSessionInfoIface,\n  ApprovalPolicyIface,\n  AuthoredChannelDefinitionIface,\n  AuthoredHarnessCloseContextIface,\n  AuthoredHarnessDescriptionIface,\n  AuthoredHarnessEndpointIface,\n  AuthoredHarnessHealthIface,\n  AuthoredHarnessIface,\n  AuthoredHarnessOpenArgsIface,\n  AuthoredHarnessRefContextIface,\n  AuthoredHarnessResumeArgsIface,\n  BaseToolsValueIface,\n  ConversationInfoIface,\n  CredentialNode,\n  CredentialPolicyIface,\n  DefinedAuthoredHarnessIface,\n  DefinedToolIface,\n  DynamicDefinitionIface,\n  DynamicResolveContextIface,\n  DynamicSentinelIface,\n  FinalPlatformClientIface,\n  HarnessHostIface,\n  HookContextIface,\n  HookDefinitionIface,\n  HookEventIface,\n  McpClientConnectionDefinitionIface,\n  SandboxSelectorContextIface,\n  ScheduleInputIface,\n  SkillDefinitionIface,\n  ToolContextIface,\n  ToolDefinitionIface,\n} from \"./authoring/index.mjs\";\nexport * from \"./authoring/providers.mjs\";\n\nexport type {\n  AgentManifestIface,\n  ChannelDefinitionIface,\n  ChannelPlatformIface,\n  ChannelSocketIface,\n  HarnessDescriptionIface,\n  HarnessEndpointIface,\n  HarnessIface,\n  HarnessSessionRefIface,\n  McpChannelIface,\n  NetworkSandboxSessionIface,\n  ResolvedAgentManifestIface,\n  RouteDefinitionIface,\n  SandboxMcpEndpoint,\n  SandboxPrepareContextIface,\n  SandboxProcessIface,\n  SandboxProviderHandleIface,\n  SandboxProviderIface,\n  SandboxProviderImplementationIface,\n  SandboxSessionIface,\n  SandboxStartContextIface,\n  ScreenSessionIface,\n} from '@finalai/agent-provider';\n\nexport { defineFinalConnection } from '@finalai/final-agent-provider/connections';\nexport type { FinalConnectionDefinitionIface } from '@finalai/final-agent-provider/connections';\n"],
+  "mappings": "AACA;AAAA,EACE;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;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;AAAA,EACA;AAAA,OACK;AAmCP,cAAc;AA0Bd,SAAS,6BAA6B;",
+  "names": []
+}

package/dist/modules/sandboxes.d.mts

@@ -0,0 +1 @@
+export * from '@finalai/final-agent-provider/sandboxes';

package/dist/modules/sandboxes.mjs

@@ -0,0 +1,2 @@
+export * from "@finalai/final-agent-provider/sandboxes";
+//# sourceMappingURL=sandboxes.mjs.map

package/dist/modules/sandboxes.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/sandboxes.ts"],
+  "sourcesContent": ["export * from '@finalai/final-agent-provider/sandboxes';\n"],
+  "mappings": "AAAA,cAAc;",
+  "names": []
+}

package/examples/custom-harness/README.md

@@ -0,0 +1,16 @@
+# Custom harness fleet
+
+`agent.ts` demonstrates binding an agent to a custom harness fleet. Replace the sample fleet origin with your fleet and implement its API before publishing. The named `acmeFleet` export lets another definition import the same binding.
+
+The sample fleet uses its own model login. Billing policy is explicit in definition source; Final MCP and other tool credentials remain independently owned at their MCP hosts. The `acme-fleet-key` secret authenticates hosting operations and must be declared and supplied before publication.
+
+The fleet API contract is:
+
+- `POST /sessions`: create or recover by `idempotencyKey`, accepting `sessionId`, `region`, `program` and materialized `mcpServers`.
+- `POST /sessions/:id/resume`: accept the saved `generation`, `lastSeq` and fresh `mcpServers`, then return an endpoint for the existing session.
+- Both return `{ id, generation, wsUrl, token }`. The WebSocket must be on the fleet's origin and speak ACP v2. Session IDs remain stable, generations are nonnegative, and the native runtime preserves running work and open requests through reconnect. Replay must agree with the declared `resumeReplay` capability.
+- `POST /sessions/:id/pause`: persist state before parking; retries are idempotent.
+- `DELETE /sessions/:id`: accept `generation` and `force`; persist state on graceful close, abort promptly when forced, and succeed for an already closed session.
+- `GET /sessions/:id/health`: return `{ ok, detail? }` from the actual runtime state.
+
+All routes require a bearer hosting secret. Endpoint tokens authorize only the returned ACP session. The fleet must pass the MCP servers through the installed program's public surface, retain its own settings/login, accept prompts while running under its queue policy, and implement the public conformance cases before use. This example supplies every lifecycle callback; it does not provision that external fleet.