@finalai/final-agent-provider 0.10.1 → 0.11.0

package/dist/modules/harnesses/nanocode-claude.d.mts

@@ -0,0 +1,18 @@
+import { type HarnessDefinitionIface, type HarnessEnvironmentIface, type HarnessSettingsIface, type JsonSchema } from '@finalai/agent-provider';
+import { ApprovalsReviewer, ReasoningLevel, type InferenceInput, type PermissionInput } from "./config-fields.mjs";
+export declare const CLAUDE_REASONING_LEVELS: readonly [ReasoningLevel.Low, ReasoningLevel.Medium, ReasoningLevel.High, ReasoningLevel.Max];
+export declare const AUTO_REVIEW_NEEDS_UNATTENDED_MODE: JsonSchema;
+export declare const nanocodeConfigurationJson: (args: {
+    title: string;
+    reasoning: readonly ReasoningLevel[];
+}) => JsonSchema;
+export declare const NANOCODE_CLAUDE_HARNESS: HarnessDefinitionIface;
+export interface ServerlessNanocodeClaudeInputIface {
+    model: string;
+    reasoning?: (typeof CLAUDE_REASONING_LEVELS)[number] | `${(typeof CLAUDE_REASONING_LEVELS)[number]}`;
+    inference?: InferenceInput;
+    permissionMode?: PermissionInput;
+    approvalsReviewer?: ApprovalsReviewer | `${ApprovalsReviewer}`;
+    environment?: HarnessEnvironmentIface;
+}
+export declare const serverlessNanocodeClaude: ({ environment, ...configuration }: ServerlessNanocodeClaudeInputIface) => HarnessSettingsIface;

package/dist/modules/harnesses/nanocode-claude.mjs

@@ -0,0 +1,101 @@
+import { defineHarness } from "@finalai/agent-definition/authoring";
+import {
+  CredentialDelivery,
+  HarnessFeature,
+  HarnessService,
+  InferenceSourceKind,
+  McpTransportKind,
+  PermissionLevel,
+  PromptWhileRunning,
+  SandboxWire
+} from "@finalai/agent-provider";
+import {
+  ApprovalsReviewer,
+  approvalsReviewerJson,
+  configObjectJson,
+  harnessSettings,
+  inferenceJson,
+  modelJson,
+  permissionModeJson,
+  reasoningJson,
+  ReasoningLevel
+} from "./config-fields.mjs";
+import { ModelVendor } from "./model-reference.mjs";
+import { FinalAcpAdapter, FinalHarness, FinalHarnessInterface, FinalWorkerProgram } from "./names.mjs";
+const CLAUDE_REASONING_LEVELS = [
+  ReasoningLevel.Low,
+  ReasoningLevel.Medium,
+  ReasoningLevel.High,
+  ReasoningLevel.Max
+];
+const AUTO_REVIEW_NEEDS_UNATTENDED_MODE = {
+  anyOf: [
+    {
+      not: {
+        required: ["approvalsReviewer"],
+        properties: { approvalsReviewer: { const: ApprovalsReviewer.AutoReview } }
+      }
+    },
+    {
+      required: ["permissionMode"],
+      properties: { permissionMode: { enum: [PermissionLevel.Review, PermissionLevel.Auto] } }
+    }
+  ]
+};
+const nanocodeConfigurationJson = (args) => ({
+  ...configObjectJson({
+    required: ["model"],
+    title: args.title,
+    properties: {
+      model: modelJson(),
+      reasoning: reasoningJson(args.reasoning),
+      inference: inferenceJson(),
+      permissionMode: permissionModeJson(),
+      approvalsReviewer: approvalsReviewerJson()
+    }
+  }),
+  allOf: [AUTO_REVIEW_NEEDS_UNATTENDED_MODE]
+});
+const NANOCODE_CLAUDE_HARNESS = defineHarness({
+  title: "Claude on nanocode",
+  description: "nanocode's Claude engine, run per session on a worker runtime.",
+  configurationSchema: nanocodeConfigurationJson({
+    title: "Claude on nanocode",
+    reasoning: CLAUDE_REASONING_LEVELS
+  }),
+  features: Object.values(HarnessFeature),
+  lowestPermission: PermissionLevel.Ask,
+  // Subscriptions are the Claude setup token, used as a bearer.
+  inference: {
+    vendors: [ModelVendor.Anthropic],
+    kinds: [
+      InferenceSourceKind.Subscription,
+      InferenceSourceKind.ApiKey,
+      InferenceSourceKind.Final
+    ],
+    delivery: CredentialDelivery.PerRequest
+  },
+  interface: FinalHarnessInterface.Nanocode,
+  adapter: FinalAcpAdapter.Nanocode,
+  run: { worker: { program: FinalWorkerProgram.NanocodeClaude } },
+  services: [HarnessService.SessionStore, HarnessService.FrameAttachments],
+  mcp: [McpTransportKind.Acp, McpTransportKind.Http],
+  consumes: [SandboxWire.HandleRpc],
+  supports: { observe: true, resumeReplay: true, authorMeta: true },
+  // A prompt that arrives while a turn runs waits for it. Open approvals are
+  // asked again with new ids after a lost invocation, so no disconnect survival.
+  promptWhileRunning: PromptWhileRunning.Queue,
+  sessionSurvivesDisconnect: false
+});
+const serverlessNanocodeClaude = ({
+  environment,
+  ...configuration
+}) => harnessSettings({ harness: FinalHarness.NanocodeClaude, configuration, environment });
+export {
+  AUTO_REVIEW_NEEDS_UNATTENDED_MODE,
+  CLAUDE_REASONING_LEVELS,
+  NANOCODE_CLAUDE_HARNESS,
+  nanocodeConfigurationJson,
+  serverlessNanocodeClaude
+};
+//# sourceMappingURL=nanocode-claude.mjs.map

package/dist/modules/harnesses/nanocode-claude.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/harnesses/nanocode-claude.ts"],
+  "sourcesContent": ["import { defineHarness } from '@finalai/agent-definition/authoring';\nimport {\n  CredentialDelivery,\n  HarnessFeature,\n  HarnessService,\n  InferenceSourceKind,\n  McpTransportKind,\n  PermissionLevel,\n  PromptWhileRunning,\n  SandboxWire,\n  type HarnessDefinitionIface,\n  type HarnessEnvironmentIface,\n  type HarnessSettingsIface,\n  type JsonSchema,\n} from '@finalai/agent-provider';\nimport {\n  ApprovalsReviewer,\n  approvalsReviewerJson,\n  configObjectJson,\n  harnessSettings,\n  inferenceJson,\n  modelJson,\n  permissionModeJson,\n  reasoningJson,\n  ReasoningLevel,\n  type InferenceInput,\n  type PermissionInput,\n} from \"./config-fields.mjs\";\nimport { ModelVendor } from \"./model-reference.mjs\";\nimport { FinalAcpAdapter, FinalHarness, FinalHarnessInterface, FinalWorkerProgram } from \"./names.mjs\";\n\n// nanocode's Claude engine as a worker program. It drives the sandboxes\n// provided for `files` and `shell` with its own tools (Read, Write, Bash,\n// BashOutput).\n\nexport const CLAUDE_REASONING_LEVELS = [\n  ReasoningLevel.Low,\n  ReasoningLevel.Medium,\n  ReasoningLevel.High,\n  ReasoningLevel.Max,\n] as const;\n\n// A reviewer model answering approvals means no person is asked, so it needs\n// a mode that does not promise one: no auto-review, or review or auto.\nexport const AUTO_REVIEW_NEEDS_UNATTENDED_MODE: JsonSchema = {\n  anyOf: [\n    {\n      not: {\n        required: ['approvalsReviewer'],\n        properties: { approvalsReviewer: { const: ApprovalsReviewer.AutoReview } },\n      },\n    },\n    {\n      required: ['permissionMode'],\n      properties: { permissionMode: { enum: [PermissionLevel.Review, PermissionLevel.Auto] } },\n    },\n  ],\n};\n\nexport const nanocodeConfigurationJson = (args: {\n  title: string;\n  reasoning: readonly ReasoningLevel[];\n}): JsonSchema => ({\n  ...configObjectJson({\n    required: ['model'],\n    title: args.title,\n    properties: {\n      model: modelJson(),\n      reasoning: reasoningJson(args.reasoning),\n      inference: inferenceJson(),\n      permissionMode: permissionModeJson(),\n      approvalsReviewer: approvalsReviewerJson(),\n    },\n  }),\n  allOf: [AUTO_REVIEW_NEEDS_UNATTENDED_MODE],\n});\n\nexport const NANOCODE_CLAUDE_HARNESS: HarnessDefinitionIface = defineHarness({\n  title: 'Claude on nanocode',\n  description: \"nanocode's Claude engine, run per session on a worker runtime.\",\n  configurationSchema: nanocodeConfigurationJson({\n    title: 'Claude on nanocode',\n    reasoning: CLAUDE_REASONING_LEVELS,\n  }),\n  features: Object.values(HarnessFeature),\n  lowestPermission: PermissionLevel.Ask,\n  // Subscriptions are the Claude setup token, used as a bearer.\n  inference: {\n    vendors: [ModelVendor.Anthropic],\n    kinds: [\n      InferenceSourceKind.Subscription,\n      InferenceSourceKind.ApiKey,\n      InferenceSourceKind.Final,\n    ],\n    delivery: CredentialDelivery.PerRequest,\n  },\n  interface: FinalHarnessInterface.Nanocode,\n  adapter: FinalAcpAdapter.Nanocode,\n  run: { worker: { program: FinalWorkerProgram.NanocodeClaude } },\n  services: [HarnessService.SessionStore, HarnessService.FrameAttachments],\n  mcp: [McpTransportKind.Acp, McpTransportKind.Http],\n  consumes: [SandboxWire.HandleRpc],\n  supports: { observe: true, resumeReplay: true, authorMeta: true },\n  // A prompt that arrives while a turn runs waits for it. Open approvals are\n  // asked again with new ids after a lost invocation, so no disconnect survival.\n  promptWhileRunning: PromptWhileRunning.Queue,\n  sessionSurvivesDisconnect: false,\n});\n\nexport interface ServerlessNanocodeClaudeInputIface {\n  model: string;\n  reasoning?:\n    | (typeof CLAUDE_REASONING_LEVELS)[number]\n    | `${(typeof CLAUDE_REASONING_LEVELS)[number]}`;\n  inference?: InferenceInput;\n  permissionMode?: PermissionInput;\n  approvalsReviewer?: ApprovalsReviewer | `${ApprovalsReviewer}`;\n  // The worker-runtime sandbox it runs in; absent: the caller's plan creates one.\n  environment?: HarnessEnvironmentIface;\n}\n\nexport const serverlessNanocodeClaude = ({\n  environment,\n  ...configuration\n}: ServerlessNanocodeClaudeInputIface): HarnessSettingsIface =>\n  harnessSettings({ harness: FinalHarness.NanocodeClaude, configuration, environment });\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB,cAAc,uBAAuB,0BAA0B;AAMlF,MAAM,0BAA0B;AAAA,EACrC,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AACjB;AAIO,MAAM,oCAAgD;AAAA,EAC3D,OAAO;AAAA,IACL;AAAA,MACE,KAAK;AAAA,QACH,UAAU,CAAC,mBAAmB;AAAA,QAC9B,YAAY,EAAE,mBAAmB,EAAE,OAAO,kBAAkB,WAAW,EAAE;AAAA,MAC3E;AAAA,IACF;AAAA,IACA;AAAA,MACE,UAAU,CAAC,gBAAgB;AAAA,MAC3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,QAAQ,gBAAgB,IAAI,EAAE,EAAE;AAAA,IACzF;AAAA,EACF;AACF;AAEO,MAAM,4BAA4B,CAAC,UAGvB;AAAA,EACjB,GAAG,iBAAiB;AAAA,IAClB,UAAU,CAAC,OAAO;AAAA,IAClB,OAAO,KAAK;AAAA,IACZ,YAAY;AAAA,MACV,OAAO,UAAU;AAAA,MACjB,WAAW,cAAc,KAAK,SAAS;AAAA,MACvC,WAAW,cAAc;AAAA,MACzB,gBAAgB,mBAAmB;AAAA,MACnC,mBAAmB,sBAAsB;AAAA,IAC3C;AAAA,EACF,CAAC;AAAA,EACD,OAAO,CAAC,iCAAiC;AAC3C;AAEO,MAAM,0BAAkD,cAAc;AAAA,EAC3E,OAAO;AAAA,EACP,aAAa;AAAA,EACb,qBAAqB,0BAA0B;AAAA,IAC7C,OAAO;AAAA,IACP,WAAW;AAAA,EACb,CAAC;AAAA,EACD,UAAU,OAAO,OAAO,cAAc;AAAA,EACtC,kBAAkB,gBAAgB;AAAA;AAAA,EAElC,WAAW;AAAA,IACT,SAAS,CAAC,YAAY,SAAS;AAAA,IAC/B,OAAO;AAAA,MACL,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,IACtB;AAAA,IACA,UAAU,mBAAmB;AAAA,EAC/B;AAAA,EACA,WAAW,sBAAsB;AAAA,EACjC,SAAS,gBAAgB;AAAA,EACzB,KAAK,EAAE,QAAQ,EAAE,SAAS,mBAAmB,eAAe,EAAE;AAAA,EAC9D,UAAU,CAAC,eAAe,cAAc,eAAe,gBAAgB;AAAA,EACvE,KAAK,CAAC,iBAAiB,KAAK,iBAAiB,IAAI;AAAA,EACjD,UAAU,CAAC,YAAY,SAAS;AAAA,EAChC,UAAU,EAAE,SAAS,MAAM,cAAc,MAAM,YAAY,KAAK;AAAA;AAAA;AAAA,EAGhE,oBAAoB,mBAAmB;AAAA,EACvC,2BAA2B;AAC7B,CAAC;AAcM,MAAM,2BAA2B,CAAC;AAAA,EACvC;AAAA,EACA,GAAG;AACL,MACE,gBAAgB,EAAE,SAAS,aAAa,gBAAgB,eAAe,YAAY,CAAC;",
+  "names": []
+}

package/dist/modules/harnesses/nanocode-codex.d.mts

@@ -0,0 +1,13 @@
+import { type HarnessDefinitionIface, type HarnessEnvironmentIface, type HarnessSettingsIface } from '@finalai/agent-provider';
+import { ReasoningLevel, type ApprovalsReviewer, type InferenceInput, type PermissionInput } from "./config-fields.mjs";
+export declare const CODEX_REASONING_LEVELS: readonly [ReasoningLevel.Low, ReasoningLevel.Medium, ReasoningLevel.High, ReasoningLevel.Max];
+export declare const NANOCODE_CODEX_HARNESS: HarnessDefinitionIface;
+export interface ServerlessNanocodeCodexInputIface {
+    model: string;
+    reasoning?: (typeof CODEX_REASONING_LEVELS)[number] | `${(typeof CODEX_REASONING_LEVELS)[number]}`;
+    inference?: InferenceInput;
+    permissionMode?: PermissionInput;
+    approvalsReviewer?: ApprovalsReviewer | `${ApprovalsReviewer}`;
+    environment?: HarnessEnvironmentIface;
+}
+export declare const serverlessNanocodeCodex: ({ environment, ...configuration }: ServerlessNanocodeCodexInputIface) => HarnessSettingsIface;

package/dist/modules/harnesses/nanocode-codex.mjs

@@ -0,0 +1,64 @@
+import { defineHarness } from "@finalai/agent-definition/authoring";
+import {
+  CredentialDelivery,
+  HarnessFeature,
+  HarnessService,
+  InferenceSourceKind,
+  McpTransportKind,
+  PermissionLevel,
+  PromptWhileRunning,
+  SandboxWire
+} from "@finalai/agent-provider";
+import {
+  ReasoningLevel,
+  harnessSettings
+} from "./config-fields.mjs";
+import { ModelVendor } from "./model-reference.mjs";
+import { FinalAcpAdapter, FinalHarness, FinalHarnessInterface, FinalWorkerProgram } from "./names.mjs";
+import { nanocodeConfigurationJson } from "./nanocode-claude.mjs";
+const CODEX_REASONING_LEVELS = [
+  ReasoningLevel.Low,
+  ReasoningLevel.Medium,
+  ReasoningLevel.High,
+  ReasoningLevel.Max
+];
+const NANOCODE_CODEX_HARNESS = defineHarness({
+  title: "Codex on nanocode",
+  description: "nanocode's Codex engine, run per session on a worker runtime.",
+  configurationSchema: nanocodeConfigurationJson({
+    title: "Codex on nanocode",
+    reasoning: CODEX_REASONING_LEVELS
+  }),
+  features: Object.values(HarnessFeature),
+  lowestPermission: PermissionLevel.Ask,
+  inference: {
+    vendors: [ModelVendor.OpenAI],
+    kinds: [
+      InferenceSourceKind.Subscription,
+      InferenceSourceKind.ApiKey,
+      InferenceSourceKind.Final
+    ],
+    delivery: CredentialDelivery.PerRequest
+  },
+  interface: FinalHarnessInterface.Nanocode,
+  adapter: FinalAcpAdapter.Nanocode,
+  run: { worker: { program: FinalWorkerProgram.NanocodeCodex } },
+  services: [HarnessService.FrameAttachments, HarnessService.SubscriptionRelay],
+  mcp: [McpTransportKind.Acp, McpTransportKind.Http],
+  consumes: [SandboxWire.HandleRpc],
+  supports: { observe: true, resumeReplay: true, authorMeta: true },
+  // A prompt that arrives while a turn runs steers into it; open approvals are
+  // asked again with new ids after a lost invocation, so no disconnect survival.
+  promptWhileRunning: PromptWhileRunning.Inject,
+  sessionSurvivesDisconnect: false
+});
+const serverlessNanocodeCodex = ({
+  environment,
+  ...configuration
+}) => harnessSettings({ harness: FinalHarness.NanocodeCodex, configuration, environment });
+export {
+  CODEX_REASONING_LEVELS,
+  NANOCODE_CODEX_HARNESS,
+  serverlessNanocodeCodex
+};
+//# sourceMappingURL=nanocode-codex.mjs.map

package/dist/modules/harnesses/nanocode-codex.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/harnesses/nanocode-codex.ts"],
+  "sourcesContent": ["import { defineHarness } from '@finalai/agent-definition/authoring';\nimport {\n  CredentialDelivery,\n  HarnessFeature,\n  HarnessService,\n  InferenceSourceKind,\n  McpTransportKind,\n  PermissionLevel,\n  PromptWhileRunning,\n  SandboxWire,\n  type HarnessDefinitionIface,\n  type HarnessEnvironmentIface,\n  type HarnessSettingsIface,\n} from '@finalai/agent-provider';\nimport {\n  ReasoningLevel,\n  harnessSettings,\n  type ApprovalsReviewer,\n  type InferenceInput,\n  type PermissionInput,\n} from \"./config-fields.mjs\";\nimport { ModelVendor } from \"./model-reference.mjs\";\nimport { FinalAcpAdapter, FinalHarness, FinalHarnessInterface, FinalWorkerProgram } from \"./names.mjs\";\nimport { nanocodeConfigurationJson } from \"./nanocode-claude.mjs\";\n\n// nanocode's Codex engine as a worker program, Responses Lite models only. It\n// drives the sandboxes provided for `files` and `shell` with its own tools\n// (apply_patch, view_image, exec_command, write_stdin).\n\n// The final://schemas/reasoning fragment has no xhigh/ultra yet; nanocode's\n// policies accept the rest.\nexport const CODEX_REASONING_LEVELS = [\n  ReasoningLevel.Low,\n  ReasoningLevel.Medium,\n  ReasoningLevel.High,\n  ReasoningLevel.Max,\n] as const;\n\nexport const NANOCODE_CODEX_HARNESS: HarnessDefinitionIface = defineHarness({\n  title: 'Codex on nanocode',\n  description: \"nanocode's Codex engine, run per session on a worker runtime.\",\n  configurationSchema: nanocodeConfigurationJson({\n    title: 'Codex on nanocode',\n    reasoning: CODEX_REASONING_LEVELS,\n  }),\n  features: Object.values(HarnessFeature),\n  lowestPermission: PermissionLevel.Ask,\n  inference: {\n    vendors: [ModelVendor.OpenAI],\n    kinds: [\n      InferenceSourceKind.Subscription,\n      InferenceSourceKind.ApiKey,\n      InferenceSourceKind.Final,\n    ],\n    delivery: CredentialDelivery.PerRequest,\n  },\n  interface: FinalHarnessInterface.Nanocode,\n  adapter: FinalAcpAdapter.Nanocode,\n  run: { worker: { program: FinalWorkerProgram.NanocodeCodex } },\n  services: [HarnessService.FrameAttachments, HarnessService.SubscriptionRelay],\n  mcp: [McpTransportKind.Acp, McpTransportKind.Http],\n  consumes: [SandboxWire.HandleRpc],\n  supports: { observe: true, resumeReplay: true, authorMeta: true },\n  // A prompt that arrives while a turn runs steers into it; open approvals are\n  // asked again with new ids after a lost invocation, so no disconnect survival.\n  promptWhileRunning: PromptWhileRunning.Inject,\n  sessionSurvivesDisconnect: false,\n});\n\nexport interface ServerlessNanocodeCodexInputIface {\n  model: string;\n  reasoning?:\n    | (typeof CODEX_REASONING_LEVELS)[number]\n    | `${(typeof CODEX_REASONING_LEVELS)[number]}`;\n  inference?: InferenceInput;\n  permissionMode?: PermissionInput;\n  approvalsReviewer?: ApprovalsReviewer | `${ApprovalsReviewer}`;\n  // The worker-runtime sandbox it runs in; absent: the caller's plan creates one.\n  environment?: HarnessEnvironmentIface;\n}\n\nexport const serverlessNanocodeCodex = ({\n  environment,\n  ...configuration\n}: ServerlessNanocodeCodexInputIface): HarnessSettingsIface =>\n  harnessSettings({ harness: FinalHarness.NanocodeCodex, configuration, environment });\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB,cAAc,uBAAuB,0BAA0B;AACzF,SAAS,iCAAiC;AAQnC,MAAM,yBAAyB;AAAA,EACpC,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AACjB;AAEO,MAAM,yBAAiD,cAAc;AAAA,EAC1E,OAAO;AAAA,EACP,aAAa;AAAA,EACb,qBAAqB,0BAA0B;AAAA,IAC7C,OAAO;AAAA,IACP,WAAW;AAAA,EACb,CAAC;AAAA,EACD,UAAU,OAAO,OAAO,cAAc;AAAA,EACtC,kBAAkB,gBAAgB;AAAA,EAClC,WAAW;AAAA,IACT,SAAS,CAAC,YAAY,MAAM;AAAA,IAC5B,OAAO;AAAA,MACL,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,IACtB;AAAA,IACA,UAAU,mBAAmB;AAAA,EAC/B;AAAA,EACA,WAAW,sBAAsB;AAAA,EACjC,SAAS,gBAAgB;AAAA,EACzB,KAAK,EAAE,QAAQ,EAAE,SAAS,mBAAmB,cAAc,EAAE;AAAA,EAC7D,UAAU,CAAC,eAAe,kBAAkB,eAAe,iBAAiB;AAAA,EAC5E,KAAK,CAAC,iBAAiB,KAAK,iBAAiB,IAAI;AAAA,EACjD,UAAU,CAAC,YAAY,SAAS;AAAA,EAChC,UAAU,EAAE,SAAS,MAAM,cAAc,MAAM,YAAY,KAAK;AAAA;AAAA;AAAA,EAGhE,oBAAoB,mBAAmB;AAAA,EACvC,2BAA2B;AAC7B,CAAC;AAcM,MAAM,0BAA0B,CAAC;AAAA,EACtC;AAAA,EACA,GAAG;AACL,MACE,gBAAgB,EAAE,SAAS,aAAa,eAAe,eAAe,YAAY,CAAC;",
+  "names": []
+}

package/dist/modules/harnesses/pi.d.mts

@@ -0,0 +1,12 @@
+import { type HarnessDefinitionIface, type HarnessEnvironmentIface, type HarnessSettingsIface } from '@finalai/agent-provider';
+import { ReasoningLevel, type InferenceInput, type PermissionInput } from "./config-fields.mjs";
+export declare const PI_REASONING_LEVELS: readonly [ReasoningLevel.None, ReasoningLevel.Minimal, ReasoningLevel.Low, ReasoningLevel.Medium, ReasoningLevel.High];
+export declare const PI_HARNESS: HarnessDefinitionIface;
+export interface ServerlessPiInputIface {
+    model: string;
+    reasoning?: (typeof PI_REASONING_LEVELS)[number] | `${(typeof PI_REASONING_LEVELS)[number]}`;
+    inference?: InferenceInput;
+    permissionMode?: PermissionInput;
+    environment?: HarnessEnvironmentIface;
+}
+export declare const serverlessPi: ({ environment, ...configuration }: ServerlessPiInputIface) => HarnessSettingsIface;

package/dist/modules/harnesses/pi.mjs

@@ -0,0 +1,71 @@
+import { defineHarness } from "@finalai/agent-definition/authoring";
+import {
+  CredentialDelivery,
+  HarnessFeature,
+  HarnessService,
+  InferenceSourceKind,
+  McpTransportKind,
+  PermissionLevel,
+  PromptWhileRunning,
+  SandboxWire
+} from "@finalai/agent-provider";
+import {
+  configObjectJson,
+  harnessSettings,
+  inferenceJson,
+  modelJson,
+  permissionModeJson,
+  reasoningJson,
+  ReasoningLevel
+} from "./config-fields.mjs";
+import { ModelVendor } from "./model-reference.mjs";
+import { FinalAcpAdapter, FinalHarness, FinalHarnessInterface, FinalWorkerProgram } from "./names.mjs";
+const PI_REASONING_LEVELS = [
+  ReasoningLevel.None,
+  ReasoningLevel.Minimal,
+  ReasoningLevel.Low,
+  ReasoningLevel.Medium,
+  ReasoningLevel.High
+];
+const PI_HARNESS = defineHarness({
+  title: "Pi",
+  description: "The Pi coding agent, run per session on a worker runtime.",
+  configurationSchema: configObjectJson({
+    required: ["model"],
+    title: "Pi",
+    properties: {
+      model: modelJson(),
+      reasoning: reasoningJson(PI_REASONING_LEVELS),
+      inference: inferenceJson(),
+      permissionMode: permissionModeJson()
+    }
+  }),
+  features: Object.values(HarnessFeature),
+  lowestPermission: PermissionLevel.Ask,
+  inference: {
+    vendors: [ModelVendor.OpenRouter, ModelVendor.OpenAI, ModelVendor.Anthropic],
+    kinds: [InferenceSourceKind.ApiKey, InferenceSourceKind.Final],
+    delivery: CredentialDelivery.PerRequest
+  },
+  interface: FinalHarnessInterface.PiAgent,
+  adapter: FinalAcpAdapter.Pi,
+  run: { worker: { program: FinalWorkerProgram.Pi } },
+  services: [HarnessService.FrameAttachments],
+  mcp: [McpTransportKind.Acp, McpTransportKind.Http],
+  consumes: [SandboxWire.HandleRpc],
+  supports: { observe: true, resumeReplay: true, authorMeta: true },
+  // A steer joins the running turn. Across a lost invocation an open ask is
+  // not raised again with its id, so the session does not survive a disconnect.
+  promptWhileRunning: PromptWhileRunning.Inject,
+  sessionSurvivesDisconnect: false
+});
+const serverlessPi = ({
+  environment,
+  ...configuration
+}) => harnessSettings({ harness: FinalHarness.Pi, configuration, environment });
+export {
+  PI_HARNESS,
+  PI_REASONING_LEVELS,
+  serverlessPi
+};
+//# sourceMappingURL=pi.mjs.map

package/dist/modules/harnesses/pi.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/harnesses/pi.ts"],
+  "sourcesContent": ["import { defineHarness } from '@finalai/agent-definition/authoring';\nimport {\n  CredentialDelivery,\n  HarnessFeature,\n  HarnessService,\n  InferenceSourceKind,\n  McpTransportKind,\n  PermissionLevel,\n  PromptWhileRunning,\n  SandboxWire,\n  type HarnessDefinitionIface,\n  type HarnessEnvironmentIface,\n  type HarnessSettingsIface,\n} from '@finalai/agent-provider';\nimport {\n  configObjectJson,\n  harnessSettings,\n  inferenceJson,\n  modelJson,\n  permissionModeJson,\n  reasoningJson,\n  ReasoningLevel,\n  type InferenceInput,\n  type PermissionInput,\n} from \"./config-fields.mjs\";\nimport { ModelVendor } from \"./model-reference.mjs\";\nimport { FinalAcpAdapter, FinalHarness, FinalHarnessInterface, FinalWorkerProgram } from \"./names.mjs\";\n\n// Pi (pi-mono) as a worker program, one durable instance per harness session.\n// It drives the sandboxes provided for `files` and `shell` with its own tools\n// (read, write, edit, grep, find, ls, bash). There is no public process\n// adapter for Pi's interface yet, so Pi runs only as a worker or at a URL.\n\nexport const PI_REASONING_LEVELS = [\n  ReasoningLevel.None,\n  ReasoningLevel.Minimal,\n  ReasoningLevel.Low,\n  ReasoningLevel.Medium,\n  ReasoningLevel.High,\n] as const;\n\nexport const PI_HARNESS: HarnessDefinitionIface = defineHarness({\n  title: 'Pi',\n  description: 'The Pi coding agent, run per session on a worker runtime.',\n  configurationSchema: configObjectJson({\n    required: ['model'],\n    title: 'Pi',\n    properties: {\n      model: modelJson(),\n      reasoning: reasoningJson(PI_REASONING_LEVELS),\n      inference: inferenceJson(),\n      permissionMode: permissionModeJson(),\n    },\n  }),\n  features: Object.values(HarnessFeature),\n  lowestPermission: PermissionLevel.Ask,\n  inference: {\n    vendors: [ModelVendor.OpenRouter, ModelVendor.OpenAI, ModelVendor.Anthropic],\n    kinds: [InferenceSourceKind.ApiKey, InferenceSourceKind.Final],\n    delivery: CredentialDelivery.PerRequest,\n  },\n  interface: FinalHarnessInterface.PiAgent,\n  adapter: FinalAcpAdapter.Pi,\n  run: { worker: { program: FinalWorkerProgram.Pi } },\n  services: [HarnessService.FrameAttachments],\n  mcp: [McpTransportKind.Acp, McpTransportKind.Http],\n  consumes: [SandboxWire.HandleRpc],\n  supports: { observe: true, resumeReplay: true, authorMeta: true },\n  // A steer joins the running turn. Across a lost invocation an open ask is\n  // not raised again with its id, so the session does not survive a disconnect.\n  promptWhileRunning: PromptWhileRunning.Inject,\n  sessionSurvivesDisconnect: false,\n});\n\nexport interface ServerlessPiInputIface {\n  model: string;\n  reasoning?: (typeof PI_REASONING_LEVELS)[number] | `${(typeof PI_REASONING_LEVELS)[number]}`;\n  inference?: InferenceInput;\n  permissionMode?: PermissionInput;\n  // The worker-runtime sandbox it runs in, or an endpoint already running it;\n  // absent: the client creates one the session or conversation owns.\n  environment?: HarnessEnvironmentIface;\n}\n\nexport const serverlessPi = ({\n  environment,\n  ...configuration\n}: ServerlessPiInputIface): HarnessSettingsIface =>\n  harnessSettings({ harness: FinalHarness.Pi, configuration, environment });\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB,cAAc,uBAAuB,0BAA0B;AAOlF,MAAM,sBAAsB;AAAA,EACjC,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AACjB;AAEO,MAAM,aAAqC,cAAc;AAAA,EAC9D,OAAO;AAAA,EACP,aAAa;AAAA,EACb,qBAAqB,iBAAiB;AAAA,IACpC,UAAU,CAAC,OAAO;AAAA,IAClB,OAAO;AAAA,IACP,YAAY;AAAA,MACV,OAAO,UAAU;AAAA,MACjB,WAAW,cAAc,mBAAmB;AAAA,MAC5C,WAAW,cAAc;AAAA,MACzB,gBAAgB,mBAAmB;AAAA,IACrC;AAAA,EACF,CAAC;AAAA,EACD,UAAU,OAAO,OAAO,cAAc;AAAA,EACtC,kBAAkB,gBAAgB;AAAA,EAClC,WAAW;AAAA,IACT,SAAS,CAAC,YAAY,YAAY,YAAY,QAAQ,YAAY,SAAS;AAAA,IAC3E,OAAO,CAAC,oBAAoB,QAAQ,oBAAoB,KAAK;AAAA,IAC7D,UAAU,mBAAmB;AAAA,EAC/B;AAAA,EACA,WAAW,sBAAsB;AAAA,EACjC,SAAS,gBAAgB;AAAA,EACzB,KAAK,EAAE,QAAQ,EAAE,SAAS,mBAAmB,GAAG,EAAE;AAAA,EAClD,UAAU,CAAC,eAAe,gBAAgB;AAAA,EAC1C,KAAK,CAAC,iBAAiB,KAAK,iBAAiB,IAAI;AAAA,EACjD,UAAU,CAAC,YAAY,SAAS;AAAA,EAChC,UAAU,EAAE,SAAS,MAAM,cAAc,MAAM,YAAY,KAAK;AAAA;AAAA;AAAA,EAGhE,oBAAoB,mBAAmB;AAAA,EACvC,2BAA2B;AAC7B,CAAC;AAYM,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA,GAAG;AACL,MACE,gBAAgB,EAAE,SAAS,aAAa,IAAI,eAAe,YAAY,CAAC;",
+  "names": []
+}

package/dist/modules/integrations.d.mts

@@ -0,0 +1,9 @@
+import { type CreateIntegrationRequestIface } from '@finalai/agent-protocol/agent-platform/integrations';
+export declare const FINAL_GATEWAY_URL = "final://mcp";
+export declare const FINAL_GATEWAY_SCOPES: Record<string, string[]>;
+export interface FinalGatewayInputIface {
+    url: string;
+    name?: string;
+    scopes?: Record<string, string[]>;
+}
+export declare const finalGateway: (input: FinalGatewayInputIface) => CreateIntegrationRequestIface;

package/dist/modules/integrations.mjs

@@ -0,0 +1,29 @@
+import {
+  createIntegrationRequestSchema,
+  IntegrationAuthKind
+} from "@finalai/agent-protocol/agent-platform/integrations";
+const FINAL_GATEWAY_URL = "final://mcp";
+const FINAL_GATEWAY_SCOPES = {
+  api: [
+    "session:requirements",
+    "agents:read",
+    "agents:execute",
+    "conversations:read",
+    "conversations:write"
+  ],
+  reach: ["session"]
+};
+const finalGateway = (input) => createIntegrationRequestSchema.parse({
+  name: input.name ?? "final",
+  mcp: { url: input.url },
+  auth: {
+    kind: IntegrationAuthKind.PlatformIdentity,
+    scopes: input.scopes ?? FINAL_GATEWAY_SCOPES
+  }
+});
+export {
+  FINAL_GATEWAY_SCOPES,
+  FINAL_GATEWAY_URL,
+  finalGateway
+};
+//# sourceMappingURL=integrations.mjs.map

package/dist/modules/integrations.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/integrations.ts"],
+  "sourcesContent": ["import {\n  createIntegrationRequestSchema,\n  IntegrationAuthKind,\n  type CreateIntegrationRequestIface,\n} from '@finalai/agent-protocol/agent-platform/integrations';\n\n// Final's MCP gateway as an ordinary integration:\n// `project.integrations.create(finalGateway({ url }))` returns the id a caller\n// provides for an agent's slot. It authenticates with the platform's identity\n// assertion for the calling session, which any server can verify; nothing\n// about it is first-party only, and the platform resolves no special URL.\n\n// Deprecated: the platform resolves no placeholder; pass the gateway's URL.\nexport const FINAL_GATEWAY_URL = 'final://mcp';\n\n// What the gateway's assertion lets it do as the calling session on the\n// platform API (`api`): read the session's requirements and ask for an\n// optional one, read and run agents, and read and write conversations. `reach`\n// confines it to the session's own conversation and its linked children.\nexport const FINAL_GATEWAY_SCOPES: Record<string, string[]> = {\n  api: [\n    'session:requirements',\n    'agents:read',\n    'agents:execute',\n    'conversations:read',\n    'conversations:write',\n  ],\n  reach: ['session'],\n};\n\nexport interface FinalGatewayInputIface {\n  // The gateway's MCP endpoint (https).\n  url: string;\n  // The integration's name in the project; `final` by default.\n  name?: string;\n  scopes?: Record<string, string[]>;\n}\n\nexport const finalGateway = (input: FinalGatewayInputIface): CreateIntegrationRequestIface =>\n  createIntegrationRequestSchema.parse({\n    name: input.name ?? 'final',\n    mcp: { url: input.url },\n    auth: {\n      kind: IntegrationAuthKind.PlatformIdentity,\n      scopes: input.scopes ?? FINAL_GATEWAY_SCOPES,\n    },\n  });\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AASA,MAAM,oBAAoB;AAM1B,MAAM,uBAAiD;AAAA,EAC5D,KAAK;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,OAAO,CAAC,SAAS;AACnB;AAUO,MAAM,eAAe,CAAC,UAC3B,+BAA+B,MAAM;AAAA,EACnC,MAAM,MAAM,QAAQ;AAAA,EACpB,KAAK,EAAE,KAAK,MAAM,IAAI;AAAA,EACtB,MAAM;AAAA,IACJ,MAAM,oBAAoB;AAAA,IAC1B,QAAQ,MAAM,UAAU;AAAA,EAC1B;AACF,CAAC;",
+  "names": []
+}

package/dist/modules/provider/general.bundle.d.mts

@@ -0,0 +1 @@
+export declare const GENERAL_HARNESS_PROVIDER_SOURCE = "var RUNTIME_KINDS=[\"process\",\"worker\"];var ACP_V2_INTERFACE=\"acp-v2\";var PLACEHOLDER=/\\{\\{\\s*([A-Za-z0-9_.-]+)\\s*\\}\\}/gu,HARNESS_COMMAND_PATH=\"harness.command\",runtimesOf=run=>RUNTIME_KINDS.filter(kind=>run[kind]!=null),isRecord=value=>value!=null&&typeof value==\"object\"&&!Array.isArray(value),isJsonValue=value=>value===null||typeof value==\"string\"||typeof value==\"boolean\"?!0:typeof value==\"number\"?Number.isFinite(value):Array.isArray(value)?value.every(isJsonValue):isRecord(value)&&Object.values(value).every(isJsonValue),isJsonObject=value=>isRecord(value)&&isJsonValue(value),valueAt=(context,path)=>{if(path===HARNESS_COMMAND_PATH)return context.harness?.command;let value=context.configuration;for(let key of path.split(\".\").slice(1)){if(!isRecord(value))return;value=value[key]}return value},isSet=value=>value!=null&&value!==!1,textOf=value=>typeof value==\"string\"?value:JSON.stringify(value),render=(template,context,problems)=>template.replace(PLACEHOLDER,(_match,path)=>{let value=valueAt(context,path);return value==null?(problems.push(`{{${path}}} has no value`),\"\"):textOf(value)}),renderProcess=(run,context,problems)=>{let args=[];for(let arg of run.args)if(typeof arg==\"string\")args.push(render(arg,context,problems));else if(\"spread\"in arg)args.push(...context.harness?.args??[]);else if(isSet(valueAt(context,arg.when)))for(let template of arg.args)args.push(render(template,context,problems));let env={};for(let[key,value]of Object.entries(run.env))typeof value==\"string\"?env[key]=render(value,context,problems):isSet(valueAt(context,value.when))&&(env[key]=render(value.value,context,problems));return{command:render(run.command,context,problems),args,env}},harnessStartFor=args=>{let problems=[],{harness,adapter,configuration}=args;if(!isJsonObject(configuration))return{ok:!1,problems:[\"The configuration is not a JSON object\"]};if(args.runtime===\"process\"){let own2=harness.run.process,wrapper2=adapter==null?null:adapter.run.process;if(own2==null||adapter!=null&&wrapper2==null)return{ok:!1,problems:[\"No process entry to start\"]};let started=renderProcess(own2,{configuration,harness:null},problems),outer=wrapper2==null?started:renderProcess(wrapper2,{configuration,harness:{command:started.command,args:started.args}},problems),env=wrapper2==null?started.env:{...started.env,...outer.env};return problems.length>0?{ok:!1,problems}:{ok:!0,start:{runtime:\"process\",command:outer.command,args:outer.args,env}}}let own=harness.run.worker,wrapper=adapter==null?null:adapter.run.worker;return own==null||adapter!=null&&wrapper==null?{ok:!1,problems:[\"No worker entry to start\"]}:{ok:!0,start:{runtime:\"worker\",program:wrapper?.program??own.program,env:{},input:wrapper==null?{configuration}:{harness:{program:own.program},configuration}}}};var REQUIRED_FINAL_EXTENSIONS=[\"observe\",\"authorMeta\",\"resumeReplay\",\"afterSeqReplay\"],refused=problems=>({unsuitable:problems}),listOf=items=>items.length===0?\"nothing\":items.join(\", \"),urlEndpoint=async args=>{if(args.adapter!=null)return refused([`An ACP endpoint at a URL already speaks ACP and takes no adapter (${args.adapter})`]);let protocol;try{protocol=new URL(args.url).protocol}catch{return refused([`${args.url} is not a URL`])}let transport=protocol===\"wss:\"||protocol===\"ws:\"?\"ws\":protocol===\"https:\"||protocol===\"http:\"?\"http\":null;if(transport==null)return refused([`${args.url}: an ACP endpoint answers over ws(s) or http(s)`]);let headers={};if(args.hop!=null){let token=await args.ctx.secrets.get(args.hop);if(token==null||token.length===0)return refused([`The project has no secret ${args.hop} for ${args.url}`]);headers.authorization=`Bearer ${token}`}return{ref:args.ref,transport,url:args.url,headers,extensions:[...REQUIRED_FINAL_EXTENSIONS]}},sandboxEndpoint=(args,ref,sandboxId)=>{let harness=args.harness,adapter=args.adapter,name=harness.name;if(harness.definition.provider!=null)return refused([`${name} is reached by its own harness provider`]);let problems=[];if(adapter==null&&harness.definition.interface!==ACP_V2_INTERFACE&&problems.push(`${name} speaks ${harness.definition.interface}, not ACP v2, and has no adapter`),adapter!=null){adapter.definition.adapts.includes(harness.definition.interface)||problems.push(`ACP adapter ${adapter.name} adapts ${listOf(adapter.definition.adapts)}, not ${harness.definition.interface}`);let missing=REQUIRED_FINAL_EXTENSIONS.filter(extension=>!adapter.definition.extensions.includes(extension));missing.length>0&&problems.push(`ACP adapter ${adapter.name} does not implement Final's ACP extensions ${listOf(missing)}`)}let runtime=args.runtime,harnessRuntimes=runtimesOf(harness.definition.run),adapterRuntimes=adapter==null?null:runtimesOf(adapter.definition.run);if(runtime==null?problems.push(`Sandbox ${sandboxId} runs nothing ${name} has an entry for`):(harnessRuntimes.includes(runtime)||problems.push(`${name} has no ${runtime} entry (it runs as ${listOf(harnessRuntimes)})`),adapter!=null&&adapterRuntimes!=null&&!adapterRuntimes.includes(runtime)&&problems.push(`ACP adapter ${adapter.name} has no ${runtime} entry (it runs as ${listOf(adapterRuntimes)})`)),problems.length>0||runtime==null)return refused(problems);let started=harnessStartFor({harness:harness.definition,adapter:adapter?.definition??null,runtime,configuration:args.settings.configuration});return started.ok?{ref,transport:\"sandbox\",sandboxId,start:started.start,extensions:[...REQUIRED_FINAL_EXTENSIONS]}:refused(started.problems)},endpointFor=(args,ref,ctx)=>{let environment=args.environment;return environment.kind===\"url\"?urlEndpoint({ref,url:environment.url,hop:environment.hop,adapter:args.adapter?.name??null,ctx}):Promise.resolve(sandboxEndpoint(args,ref,environment.sandboxId))},open=(args,ctx)=>endpointFor(args,{harness:args.harness.name,harnessSessionRef:args.harnessSessionId,generation:0},ctx),resume=(args,ctx)=>endpointFor(args,args.ref,ctx),park=async(_args,_ctx)=>{},close=async(_args,_ctx)=>{},health=async(_args,_ctx)=>({ok:!0,detail:\"The session service watches the program it started\"});export{REQUIRED_FINAL_EXTENSIONS,close,health,open,park,resume};\n";

package/dist/modules/provider/general.bundle.mjs

@@ -0,0 +1,5 @@
+const GENERAL_HARNESS_PROVIDER_SOURCE = 'var RUNTIME_KINDS=["process","worker"];var ACP_V2_INTERFACE="acp-v2";var PLACEHOLDER=/\\{\\{\\s*([A-Za-z0-9_.-]+)\\s*\\}\\}/gu,HARNESS_COMMAND_PATH="harness.command",runtimesOf=run=>RUNTIME_KINDS.filter(kind=>run[kind]!=null),isRecord=value=>value!=null&&typeof value=="object"&&!Array.isArray(value),isJsonValue=value=>value===null||typeof value=="string"||typeof value=="boolean"?!0:typeof value=="number"?Number.isFinite(value):Array.isArray(value)?value.every(isJsonValue):isRecord(value)&&Object.values(value).every(isJsonValue),isJsonObject=value=>isRecord(value)&&isJsonValue(value),valueAt=(context,path)=>{if(path===HARNESS_COMMAND_PATH)return context.harness?.command;let value=context.configuration;for(let key of path.split(".").slice(1)){if(!isRecord(value))return;value=value[key]}return value},isSet=value=>value!=null&&value!==!1,textOf=value=>typeof value=="string"?value:JSON.stringify(value),render=(template,context,problems)=>template.replace(PLACEHOLDER,(_match,path)=>{let value=valueAt(context,path);return value==null?(problems.push(`{{${path}}} has no value`),""):textOf(value)}),renderProcess=(run,context,problems)=>{let args=[];for(let arg of run.args)if(typeof arg=="string")args.push(render(arg,context,problems));else if("spread"in arg)args.push(...context.harness?.args??[]);else if(isSet(valueAt(context,arg.when)))for(let template of arg.args)args.push(render(template,context,problems));let env={};for(let[key,value]of Object.entries(run.env))typeof value=="string"?env[key]=render(value,context,problems):isSet(valueAt(context,value.when))&&(env[key]=render(value.value,context,problems));return{command:render(run.command,context,problems),args,env}},harnessStartFor=args=>{let problems=[],{harness,adapter,configuration}=args;if(!isJsonObject(configuration))return{ok:!1,problems:["The configuration is not a JSON object"]};if(args.runtime==="process"){let own2=harness.run.process,wrapper2=adapter==null?null:adapter.run.process;if(own2==null||adapter!=null&&wrapper2==null)return{ok:!1,problems:["No process entry to start"]};let started=renderProcess(own2,{configuration,harness:null},problems),outer=wrapper2==null?started:renderProcess(wrapper2,{configuration,harness:{command:started.command,args:started.args}},problems),env=wrapper2==null?started.env:{...started.env,...outer.env};return problems.length>0?{ok:!1,problems}:{ok:!0,start:{runtime:"process",command:outer.command,args:outer.args,env}}}let own=harness.run.worker,wrapper=adapter==null?null:adapter.run.worker;return own==null||adapter!=null&&wrapper==null?{ok:!1,problems:["No worker entry to start"]}:{ok:!0,start:{runtime:"worker",program:wrapper?.program??own.program,env:{},input:wrapper==null?{configuration}:{harness:{program:own.program},configuration}}}};var REQUIRED_FINAL_EXTENSIONS=["observe","authorMeta","resumeReplay","afterSeqReplay"],refused=problems=>({unsuitable:problems}),listOf=items=>items.length===0?"nothing":items.join(", "),urlEndpoint=async args=>{if(args.adapter!=null)return refused([`An ACP endpoint at a URL already speaks ACP and takes no adapter (${args.adapter})`]);let protocol;try{protocol=new URL(args.url).protocol}catch{return refused([`${args.url} is not a URL`])}let transport=protocol==="wss:"||protocol==="ws:"?"ws":protocol==="https:"||protocol==="http:"?"http":null;if(transport==null)return refused([`${args.url}: an ACP endpoint answers over ws(s) or http(s)`]);let headers={};if(args.hop!=null){let token=await args.ctx.secrets.get(args.hop);if(token==null||token.length===0)return refused([`The project has no secret ${args.hop} for ${args.url}`]);headers.authorization=`Bearer ${token}`}return{ref:args.ref,transport,url:args.url,headers,extensions:[...REQUIRED_FINAL_EXTENSIONS]}},sandboxEndpoint=(args,ref,sandboxId)=>{let harness=args.harness,adapter=args.adapter,name=harness.name;if(harness.definition.provider!=null)return refused([`${name} is reached by its own harness provider`]);let problems=[];if(adapter==null&&harness.definition.interface!==ACP_V2_INTERFACE&&problems.push(`${name} speaks ${harness.definition.interface}, not ACP v2, and has no adapter`),adapter!=null){adapter.definition.adapts.includes(harness.definition.interface)||problems.push(`ACP adapter ${adapter.name} adapts ${listOf(adapter.definition.adapts)}, not ${harness.definition.interface}`);let missing=REQUIRED_FINAL_EXTENSIONS.filter(extension=>!adapter.definition.extensions.includes(extension));missing.length>0&&problems.push(`ACP adapter ${adapter.name} does not implement Final\'s ACP extensions ${listOf(missing)}`)}let runtime=args.runtime,harnessRuntimes=runtimesOf(harness.definition.run),adapterRuntimes=adapter==null?null:runtimesOf(adapter.definition.run);if(runtime==null?problems.push(`Sandbox ${sandboxId} runs nothing ${name} has an entry for`):(harnessRuntimes.includes(runtime)||problems.push(`${name} has no ${runtime} entry (it runs as ${listOf(harnessRuntimes)})`),adapter!=null&&adapterRuntimes!=null&&!adapterRuntimes.includes(runtime)&&problems.push(`ACP adapter ${adapter.name} has no ${runtime} entry (it runs as ${listOf(adapterRuntimes)})`)),problems.length>0||runtime==null)return refused(problems);let started=harnessStartFor({harness:harness.definition,adapter:adapter?.definition??null,runtime,configuration:args.settings.configuration});return started.ok?{ref,transport:"sandbox",sandboxId,start:started.start,extensions:[...REQUIRED_FINAL_EXTENSIONS]}:refused(started.problems)},endpointFor=(args,ref,ctx)=>{let environment=args.environment;return environment.kind==="url"?urlEndpoint({ref,url:environment.url,hop:environment.hop,adapter:args.adapter?.name??null,ctx}):Promise.resolve(sandboxEndpoint(args,ref,environment.sandboxId))},open=(args,ctx)=>endpointFor(args,{harness:args.harness.name,harnessSessionRef:args.harnessSessionId,generation:0},ctx),resume=(args,ctx)=>endpointFor(args,args.ref,ctx),park=async(_args,_ctx)=>{},close=async(_args,_ctx)=>{},health=async(_args,_ctx)=>({ok:!0,detail:"The session service watches the program it started"});export{REQUIRED_FINAL_EXTENSIONS,close,health,open,park,resume};\n';
+export {
+  GENERAL_HARNESS_PROVIDER_SOURCE
+};
+//# sourceMappingURL=general.bundle.mjs.map

package/dist/modules/provider/general.bundle.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/provider/general.bundle.ts"],
+  "sourcesContent": ["// Generated by scripts/bundle-provider.mjs from ./general.ts; do not edit.\nexport const GENERAL_HARNESS_PROVIDER_SOURCE =\n  'var RUNTIME_KINDS=[\"process\",\"worker\"];var ACP_V2_INTERFACE=\"acp-v2\";var PLACEHOLDER=/\\\\{\\\\{\\\\s*([A-Za-z0-9_.-]+)\\\\s*\\\\}\\\\}/gu,HARNESS_COMMAND_PATH=\"harness.command\",runtimesOf=run=>RUNTIME_KINDS.filter(kind=>run[kind]!=null),isRecord=value=>value!=null&&typeof value==\"object\"&&!Array.isArray(value),isJsonValue=value=>value===null||typeof value==\"string\"||typeof value==\"boolean\"?!0:typeof value==\"number\"?Number.isFinite(value):Array.isArray(value)?value.every(isJsonValue):isRecord(value)&&Object.values(value).every(isJsonValue),isJsonObject=value=>isRecord(value)&&isJsonValue(value),valueAt=(context,path)=>{if(path===HARNESS_COMMAND_PATH)return context.harness?.command;let value=context.configuration;for(let key of path.split(\".\").slice(1)){if(!isRecord(value))return;value=value[key]}return value},isSet=value=>value!=null&&value!==!1,textOf=value=>typeof value==\"string\"?value:JSON.stringify(value),render=(template,context,problems)=>template.replace(PLACEHOLDER,(_match,path)=>{let value=valueAt(context,path);return value==null?(problems.push(`{{${path}}} has no value`),\"\"):textOf(value)}),renderProcess=(run,context,problems)=>{let args=[];for(let arg of run.args)if(typeof arg==\"string\")args.push(render(arg,context,problems));else if(\"spread\"in arg)args.push(...context.harness?.args??[]);else if(isSet(valueAt(context,arg.when)))for(let template of arg.args)args.push(render(template,context,problems));let env={};for(let[key,value]of Object.entries(run.env))typeof value==\"string\"?env[key]=render(value,context,problems):isSet(valueAt(context,value.when))&&(env[key]=render(value.value,context,problems));return{command:render(run.command,context,problems),args,env}},harnessStartFor=args=>{let problems=[],{harness,adapter,configuration}=args;if(!isJsonObject(configuration))return{ok:!1,problems:[\"The configuration is not a JSON object\"]};if(args.runtime===\"process\"){let own2=harness.run.process,wrapper2=adapter==null?null:adapter.run.process;if(own2==null||adapter!=null&&wrapper2==null)return{ok:!1,problems:[\"No process entry to start\"]};let started=renderProcess(own2,{configuration,harness:null},problems),outer=wrapper2==null?started:renderProcess(wrapper2,{configuration,harness:{command:started.command,args:started.args}},problems),env=wrapper2==null?started.env:{...started.env,...outer.env};return problems.length>0?{ok:!1,problems}:{ok:!0,start:{runtime:\"process\",command:outer.command,args:outer.args,env}}}let own=harness.run.worker,wrapper=adapter==null?null:adapter.run.worker;return own==null||adapter!=null&&wrapper==null?{ok:!1,problems:[\"No worker entry to start\"]}:{ok:!0,start:{runtime:\"worker\",program:wrapper?.program??own.program,env:{},input:wrapper==null?{configuration}:{harness:{program:own.program},configuration}}}};var REQUIRED_FINAL_EXTENSIONS=[\"observe\",\"authorMeta\",\"resumeReplay\",\"afterSeqReplay\"],refused=problems=>({unsuitable:problems}),listOf=items=>items.length===0?\"nothing\":items.join(\", \"),urlEndpoint=async args=>{if(args.adapter!=null)return refused([`An ACP endpoint at a URL already speaks ACP and takes no adapter (${args.adapter})`]);let protocol;try{protocol=new URL(args.url).protocol}catch{return refused([`${args.url} is not a URL`])}let transport=protocol===\"wss:\"||protocol===\"ws:\"?\"ws\":protocol===\"https:\"||protocol===\"http:\"?\"http\":null;if(transport==null)return refused([`${args.url}: an ACP endpoint answers over ws(s) or http(s)`]);let headers={};if(args.hop!=null){let token=await args.ctx.secrets.get(args.hop);if(token==null||token.length===0)return refused([`The project has no secret ${args.hop} for ${args.url}`]);headers.authorization=`Bearer ${token}`}return{ref:args.ref,transport,url:args.url,headers,extensions:[...REQUIRED_FINAL_EXTENSIONS]}},sandboxEndpoint=(args,ref,sandboxId)=>{let harness=args.harness,adapter=args.adapter,name=harness.name;if(harness.definition.provider!=null)return refused([`${name} is reached by its own harness provider`]);let problems=[];if(adapter==null&&harness.definition.interface!==ACP_V2_INTERFACE&&problems.push(`${name} speaks ${harness.definition.interface}, not ACP v2, and has no adapter`),adapter!=null){adapter.definition.adapts.includes(harness.definition.interface)||problems.push(`ACP adapter ${adapter.name} adapts ${listOf(adapter.definition.adapts)}, not ${harness.definition.interface}`);let missing=REQUIRED_FINAL_EXTENSIONS.filter(extension=>!adapter.definition.extensions.includes(extension));missing.length>0&&problems.push(`ACP adapter ${adapter.name} does not implement Final\\'s ACP extensions ${listOf(missing)}`)}let runtime=args.runtime,harnessRuntimes=runtimesOf(harness.definition.run),adapterRuntimes=adapter==null?null:runtimesOf(adapter.definition.run);if(runtime==null?problems.push(`Sandbox ${sandboxId} runs nothing ${name} has an entry for`):(harnessRuntimes.includes(runtime)||problems.push(`${name} has no ${runtime} entry (it runs as ${listOf(harnessRuntimes)})`),adapter!=null&&adapterRuntimes!=null&&!adapterRuntimes.includes(runtime)&&problems.push(`ACP adapter ${adapter.name} has no ${runtime} entry (it runs as ${listOf(adapterRuntimes)})`)),problems.length>0||runtime==null)return refused(problems);let started=harnessStartFor({harness:harness.definition,adapter:adapter?.definition??null,runtime,configuration:args.settings.configuration});return started.ok?{ref,transport:\"sandbox\",sandboxId,start:started.start,extensions:[...REQUIRED_FINAL_EXTENSIONS]}:refused(started.problems)},endpointFor=(args,ref,ctx)=>{let environment=args.environment;return environment.kind===\"url\"?urlEndpoint({ref,url:environment.url,hop:environment.hop,adapter:args.adapter?.name??null,ctx}):Promise.resolve(sandboxEndpoint(args,ref,environment.sandboxId))},open=(args,ctx)=>endpointFor(args,{harness:args.harness.name,harnessSessionRef:args.harnessSessionId,generation:0},ctx),resume=(args,ctx)=>endpointFor(args,args.ref,ctx),park=async(_args,_ctx)=>{},close=async(_args,_ctx)=>{},health=async(_args,_ctx)=>({ok:!0,detail:\"The session service watches the program it started\"});export{REQUIRED_FINAL_EXTENSIONS,close,health,open,park,resume};\\n';\n"],
+  "mappings": "AACO,MAAM,kCACX;",
+  "names": []
+}

package/dist/modules/provider/general.d.mts

@@ -0,0 +1,11 @@
+import { FinalExtension } from '@finalai/agent-provider/harness-start';
+import type { HarnessProviderCloseArgsIface, HarnessProviderContextIface, HarnessProviderOpenArgsIface, HarnessProviderOpenResultIface, HarnessProviderRefArgsIface, HarnessProviderResumeArgsIface } from '@finalai/agent-provider/harness-provider';
+export declare const REQUIRED_FINAL_EXTENSIONS: readonly FinalExtension[];
+export declare const open: (args: HarnessProviderOpenArgsIface, ctx: HarnessProviderContextIface) => Promise<HarnessProviderOpenResultIface>;
+export declare const resume: (args: HarnessProviderResumeArgsIface, ctx: HarnessProviderContextIface) => Promise<HarnessProviderOpenResultIface>;
+export declare const park: (_args: HarnessProviderRefArgsIface, _ctx: HarnessProviderContextIface) => Promise<void>;
+export declare const close: (_args: HarnessProviderCloseArgsIface, _ctx: HarnessProviderContextIface) => Promise<void>;
+export declare const health: (_args: HarnessProviderRefArgsIface, _ctx: HarnessProviderContextIface) => Promise<{
+    ok: boolean;
+    detail?: string;
+}>;

package/dist/modules/provider/general.mjs

@@ -0,0 +1,130 @@
+import {
+  ACP_V2_INTERFACE,
+  FinalExtension,
+  harnessStartFor,
+  HarnessEnvironmentKind,
+  runtimesOf
+} from "@finalai/agent-provider/harness-start";
+const REQUIRED_FINAL_EXTENSIONS = [
+  FinalExtension.Observe,
+  FinalExtension.AuthorMeta,
+  FinalExtension.ResumeReplay,
+  FinalExtension.AfterSeqReplay
+];
+const refused = (problems) => ({ unsuitable: problems });
+const listOf = (items) => items.length === 0 ? "nothing" : items.join(", ");
+const urlEndpoint = async (args) => {
+  if (args.adapter != null)
+    return refused([
+      `An ACP endpoint at a URL already speaks ACP and takes no adapter (${args.adapter})`
+    ]);
+  let protocol;
+  try {
+    protocol = new URL(args.url).protocol;
+  } catch {
+    return refused([`${args.url} is not a URL`]);
+  }
+  const transport = protocol === "wss:" || protocol === "ws:" ? "ws" : protocol === "https:" || protocol === "http:" ? "http" : null;
+  if (transport == null)
+    return refused([`${args.url}: an ACP endpoint answers over ws(s) or http(s)`]);
+  const headers = {};
+  if (args.hop != null) {
+    const token = await args.ctx.secrets.get(args.hop);
+    if (token == null || token.length === 0)
+      return refused([`The project has no secret ${args.hop} for ${args.url}`]);
+    headers["authorization"] = `Bearer ${token}`;
+  }
+  return {
+    ref: args.ref,
+    transport,
+    url: args.url,
+    headers,
+    extensions: [...REQUIRED_FINAL_EXTENSIONS]
+  };
+};
+const sandboxEndpoint = (args, ref, sandboxId) => {
+  const harness = args.harness;
+  const adapter = args.adapter;
+  const name = harness.name;
+  if (harness.definition.provider != null)
+    return refused([`${name} is reached by its own harness provider`]);
+  const problems = [];
+  if (adapter == null && harness.definition.interface !== ACP_V2_INTERFACE)
+    problems.push(`${name} speaks ${harness.definition.interface}, not ACP v2, and has no adapter`);
+  if (adapter != null) {
+    if (!adapter.definition.adapts.includes(harness.definition.interface))
+      problems.push(
+        `ACP adapter ${adapter.name} adapts ${listOf(adapter.definition.adapts)}, not ${harness.definition.interface}`
+      );
+    const missing = REQUIRED_FINAL_EXTENSIONS.filter(
+      (extension) => !adapter.definition.extensions.includes(extension)
+    );
+    if (missing.length > 0)
+      problems.push(
+        `ACP adapter ${adapter.name} does not implement Final's ACP extensions ${listOf(missing)}`
+      );
+  }
+  const runtime = args.runtime;
+  const harnessRuntimes = runtimesOf(harness.definition.run);
+  const adapterRuntimes = adapter == null ? null : runtimesOf(adapter.definition.run);
+  if (runtime == null) problems.push(`Sandbox ${sandboxId} runs nothing ${name} has an entry for`);
+  else {
+    if (!harnessRuntimes.includes(runtime))
+      problems.push(`${name} has no ${runtime} entry (it runs as ${listOf(harnessRuntimes)})`);
+    if (adapter != null && adapterRuntimes != null && !adapterRuntimes.includes(runtime))
+      problems.push(
+        `ACP adapter ${adapter.name} has no ${runtime} entry (it runs as ${listOf(adapterRuntimes)})`
+      );
+  }
+  if (problems.length > 0 || runtime == null) return refused(problems);
+  const started = harnessStartFor({
+    harness: harness.definition,
+    adapter: adapter?.definition ?? null,
+    runtime,
+    configuration: args.settings.configuration
+  });
+  if (!started.ok) return refused(started.problems);
+  const endpoint = {
+    ref,
+    transport: "sandbox",
+    sandboxId,
+    start: started.start,
+    extensions: [...REQUIRED_FINAL_EXTENSIONS]
+  };
+  return endpoint;
+};
+const endpointFor = (args, ref, ctx) => {
+  const environment = args.environment;
+  if (environment.kind === HarnessEnvironmentKind.Url)
+    return urlEndpoint({
+      ref,
+      url: environment.url,
+      hop: environment.hop,
+      adapter: args.adapter?.name ?? null,
+      ctx
+    });
+  return Promise.resolve(sandboxEndpoint(args, ref, environment.sandboxId));
+};
+const open = (args, ctx) => endpointFor(
+  args,
+  { harness: args.harness.name, harnessSessionRef: args.harnessSessionId, generation: 0 },
+  ctx
+);
+const resume = (args, ctx) => endpointFor(args, args.ref, ctx);
+const park = async (_args, _ctx) => {
+};
+const close = async (_args, _ctx) => {
+};
+const health = async (_args, _ctx) => ({
+  ok: true,
+  detail: "The session service watches the program it started"
+});
+export {
+  REQUIRED_FINAL_EXTENSIONS,
+  close,
+  health,
+  open,
+  park,
+  resume
+};
+//# sourceMappingURL=general.mjs.map

package/dist/modules/provider/general.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/provider/general.ts"],
+  "sourcesContent": ["import type { HarnessSessionRefIface } from '@finalai/agent-provider/harness';\nimport type { ComposedEnvironmentIface } from '@finalai/agent-provider/harness-definition';\nimport {\n  ACP_V2_INTERFACE,\n  FinalExtension,\n  harnessStartFor,\n  HarnessEnvironmentKind,\n  runtimesOf,\n} from '@finalai/agent-provider/harness-start';\nimport type {\n  HarnessProviderCloseArgsIface,\n  HarnessProviderContextIface,\n  HarnessProviderEndpointResultIface,\n  HarnessProviderOpenArgsIface,\n  HarnessProviderOpenResultIface,\n  HarnessProviderRefArgsIface,\n  HarnessProviderResumeArgsIface,\n} from '@finalai/agent-provider/harness-provider';\n\n// The general harness provider: it starts adapter(harness) in the harness's\n// environment from the two definitions' run entries and hands the session\n// service the ACP stream; for an environment at a URL it hands over the URL.\n// Built only on the public harness provider contract and bundled into one\n// self-contained module (./general.bundle.ts), like any third party's\n// provider. It imports values only from dependency-free modules, and writes\n// the contract's transports as the strings they are, to keep that small.\n//\n// The session service starts what a `sandbox` endpoint names over the\n// sandbox's process streams (startSandboxEndpoint) and keeps the program for\n// the session's life, so park, close and health have nothing of their own to\n// stop or watch.\n\n// What every ACP endpoint it hands over must implement and advertise in\n// `initialize`, beyond ACP v2.\nexport const REQUIRED_FINAL_EXTENSIONS: readonly FinalExtension[] = [\n  FinalExtension.Observe,\n  FinalExtension.AuthorMeta,\n  FinalExtension.ResumeReplay,\n  FinalExtension.AfterSeqReplay,\n];\n\nconst refused = (problems: string[]): HarnessProviderOpenResultIface => ({ unsuitable: problems });\n\nconst listOf = (items: readonly string[]): string =>\n  items.length === 0 ? 'nothing' : items.join(', ');\n\nconst urlEndpoint = async (args: {\n  ref: HarnessSessionRefIface;\n  url: string;\n  hop: string | null;\n  adapter: string | null;\n  ctx: HarnessProviderContextIface;\n}): Promise<HarnessProviderOpenResultIface> => {\n  if (args.adapter != null)\n    return refused([\n      `An ACP endpoint at a URL already speaks ACP and takes no adapter (${args.adapter})`,\n    ]);\n  let protocol: string;\n  try {\n    protocol = new URL(args.url).protocol;\n  } catch {\n    return refused([`${args.url} is not a URL`]);\n  }\n  const transport =\n    protocol === 'wss:' || protocol === 'ws:'\n      ? 'ws'\n      : protocol === 'https:' || protocol === 'http:'\n        ? 'http'\n        : null;\n  if (transport == null)\n    return refused([`${args.url}: an ACP endpoint answers over ws(s) or http(s)`]);\n  const headers: Record<string, string> = {};\n  if (args.hop != null) {\n    const token = await args.ctx.secrets.get(args.hop);\n    if (token == null || token.length === 0)\n      return refused([`The project has no secret ${args.hop} for ${args.url}`]);\n    headers['authorization'] = `Bearer ${token}`;\n  }\n  return {\n    ref: args.ref,\n    transport,\n    url: args.url,\n    headers,\n    extensions: [...REQUIRED_FINAL_EXTENSIONS],\n  };\n};\n\nconst sandboxEndpoint = (\n  args: HarnessProviderOpenArgsIface,\n  ref: HarnessSessionRefIface,\n  sandboxId: string,\n): HarnessProviderOpenResultIface => {\n  const harness = args.harness;\n  const adapter = args.adapter;\n  const name = harness.name;\n  if (harness.definition.provider != null)\n    return refused([`${name} is reached by its own harness provider`]);\n  const problems: string[] = [];\n  if (adapter == null && harness.definition.interface !== ACP_V2_INTERFACE)\n    problems.push(`${name} speaks ${harness.definition.interface}, not ACP v2, and has no adapter`);\n  if (adapter != null) {\n    if (!adapter.definition.adapts.includes(harness.definition.interface))\n      problems.push(\n        `ACP adapter ${adapter.name} adapts ${listOf(adapter.definition.adapts)}, not ${harness.definition.interface}`,\n      );\n    const missing = REQUIRED_FINAL_EXTENSIONS.filter(\n      (extension) => !adapter.definition.extensions.includes(extension),\n    );\n    if (missing.length > 0)\n      problems.push(\n        `ACP adapter ${adapter.name} does not implement Final's ACP extensions ${listOf(missing)}`,\n      );\n  }\n  const runtime = args.runtime;\n  const harnessRuntimes = runtimesOf(harness.definition.run);\n  const adapterRuntimes = adapter == null ? null : runtimesOf(adapter.definition.run);\n  if (runtime == null) problems.push(`Sandbox ${sandboxId} runs nothing ${name} has an entry for`);\n  else {\n    if (!harnessRuntimes.includes(runtime))\n      problems.push(`${name} has no ${runtime} entry (it runs as ${listOf(harnessRuntimes)})`);\n    if (adapter != null && adapterRuntimes != null && !adapterRuntimes.includes(runtime))\n      problems.push(\n        `ACP adapter ${adapter.name} has no ${runtime} entry (it runs as ${listOf(adapterRuntimes)})`,\n      );\n  }\n  if (problems.length > 0 || runtime == null) return refused(problems);\n\n  const started = harnessStartFor({\n    harness: harness.definition,\n    adapter: adapter?.definition ?? null,\n    runtime,\n    configuration: args.settings.configuration,\n  });\n  if (!started.ok) return refused(started.problems);\n  const endpoint: HarnessProviderEndpointResultIface = {\n    ref,\n    transport: 'sandbox',\n    sandboxId,\n    start: started.start,\n    extensions: [...REQUIRED_FINAL_EXTENSIONS],\n  };\n  return endpoint;\n};\n\nconst endpointFor = (\n  args: HarnessProviderOpenArgsIface,\n  ref: HarnessSessionRefIface,\n  ctx: HarnessProviderContextIface,\n): Promise<HarnessProviderOpenResultIface> => {\n  const environment: ComposedEnvironmentIface = args.environment;\n  if (environment.kind === HarnessEnvironmentKind.Url)\n    return urlEndpoint({\n      ref,\n      url: environment.url,\n      hop: environment.hop,\n      adapter: args.adapter?.name ?? null,\n      ctx,\n    });\n  return Promise.resolve(sandboxEndpoint(args, ref, environment.sandboxId));\n};\n\nexport const open = (\n  args: HarnessProviderOpenArgsIface,\n  ctx: HarnessProviderContextIface,\n): Promise<HarnessProviderOpenResultIface> =>\n  endpointFor(\n    args,\n    { harness: args.harness.name, harnessSessionRef: args.harnessSessionId, generation: 0 },\n    ctx,\n  );\n\n// The worker runtime finds a harness session's state again by its id; a\n// process starts afresh and the session service resumes it over ACP.\nexport const resume = (\n  args: HarnessProviderResumeArgsIface,\n  ctx: HarnessProviderContextIface,\n): Promise<HarnessProviderOpenResultIface> => endpointFor(args, args.ref, ctx);\n\nexport const park = async (\n  _args: HarnessProviderRefArgsIface,\n  _ctx: HarnessProviderContextIface,\n): Promise<void> => {};\n\nexport const close = async (\n  _args: HarnessProviderCloseArgsIface,\n  _ctx: HarnessProviderContextIface,\n): Promise<void> => {};\n\nexport const health = async (\n  _args: HarnessProviderRefArgsIface,\n  _ctx: HarnessProviderContextIface,\n): Promise<{ ok: boolean; detail?: string }> => ({\n  ok: true,\n  detail: 'The session service watches the program it started',\n});\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,3 @@
+import { type DefinedHarnessProviderIface } from '@finalai/agent-definition/authoring';
+export { REQUIRED_FINAL_EXTENSIONS } from "./general.mjs";
+export declare const GENERAL_HARNESS_PROVIDER: DefinedHarnessProviderIface;