@finalai/final-agent-provider 0.10.0 → 0.11.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/harnesses/index.ts"],
-  "sourcesContent": ["export type {\n  RemoteHarnessFactoryConfigIface,\n  RemoteHarnessIface,\n  RemoteOpenArgsIface,\n  RemoteProgramConfigIface,\n} from \"../runtime/remote-host.mjs\";\nexport {\n  ClaudePermissionMode,\n  CodexApprovalPolicy,\n  CodexSandboxMode,\n  PiPermissionMode,\n  ReasoningLevel,\n  type HarnessBindingOutputIface,\n  type SecretRefIface,\n} from \"./config-fields.mjs\";\nexport {\n  SPECIFIER as LOCAL_STDIO_SPECIFIER,\n  localStdio,\n  type LocalStdioConfigInputIface,\n} from \"./local-stdio.mjs\";\nexport { ModelVendor } from \"./model-reference.mjs\";\nexport {\n  SPECIFIER as REMOTE_ACP_SPECIFIER,\n  remoteAcp,\n  type RemoteAcpConfigInputIface,\n} from \"./remote-acp.mjs\";\nexport {\n  SPECIFIER as REMOTE_CLAUDE_CODE_SPECIFIER,\n  remoteClaudeCode,\n  type RemoteClaudeCodeConfigInputIface,\n} from \"./remote-claude-code.mjs\";\nexport type { RemoteClientTlsInputIface } from \"./remote-client-tls.mjs\";\nexport {\n  SPECIFIER as REMOTE_CODEX_SPECIFIER,\n  remoteCodex,\n  type RemoteCodexConfigInputIface,\n} from \"./remote-codex.mjs\";\nexport {\n  SPECIFIER as REMOTE_PI_SPECIFIER,\n  remotePi,\n  type RemotePiConfigInputIface,\n} from \"./remote-pi.mjs\";\nexport {\n  SPECIFIER as SERVERLESS_FINAL_SPECIFIER,\n  serverlessFinal,\n  type ServerlessFinalConfigInputIface,\n} from \"./serverless-final.mjs\";\nexport {\n  SPECIFIER as SERVERLESS_NANOCODE_CLAUDE_SPECIFIER,\n  serverlessNanocodeClaude,\n  type ServerlessNanocodeClaudeConfigInputIface,\n} from \"./serverless-nanocode-claude.mjs\";\nexport {\n  SPECIFIER as SERVERLESS_NANOCODE_CODEX_SPECIFIER,\n  serverlessNanocodeCodex,\n  type ServerlessNanocodeCodexConfigInputIface,\n} from \"./serverless-nanocode-codex.mjs\";\nexport {\n  SPECIFIER as SERVERLESS_PI_SPECIFIER,\n  serverlessPi,\n  type ServerlessPiConfigInputIface,\n} from \"./serverless-pi.mjs\";\n"],
-  "mappings": "AAMA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACe;AAAA,EACb;AAAA,OAEK;AACP,SAAS,mBAAmB;AAC5B;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;AAEP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACe,aAAbA;AAAA,EACA;AAAA,OAEK;",
-  "names": ["SPECIFIER"]
+  "sourcesContent": ["// Final's harness and ACP adapter definitions, and settings builders for its\n// harnesses: each builder returns plain data (`{ harness, configuration,\n// environment? }`) a caller passes as `provide.harness`. The inference sources\n// say how the harness reaches its model and who is charged.\nexport {\n  apiKey,\n  CredentialScope,\n  finalCredits,\n  harnessLogin,\n  InferenceBillTo,\n  InferenceSourceKind,\n  subscription,\n  type InferenceSource,\n} from '@finalai/agent-provider/inference';\nexport type {\n  HarnessEnvironmentIface,\n  HarnessSettingsIface,\n  HarnessUrlEnvironmentIface,\n  ResolvedHarnessSettingsIface,\n} from '@finalai/agent-provider/harness';\nexport { ACP_AGENT_HARNESS, acpAgent } from \"./acp-agent.mjs\";\nexport {\n  CLAUDE_CODE_ACP_ADAPTER,\n  CODEX_ACP_ADAPTER,\n  FINAL_ACP_ADAPTERS,\n  NANOCODE_ACP_ADAPTER,\n  PI_ACP_ADAPTER,\n} from \"./adapters.mjs\";\nexport {\n  CLAUDE_CODE_HARNESS,\n  CLAUDE_CODE_NATIVE_TOOLS,\n  claudeCode,\n  type ClaudeCodeInputIface,\n} from \"./claude-code.mjs\";\nexport {\n  CODEX_APP_SERVER_REASONING_LEVELS,\n  CODEX_HARNESS,\n  codex,\n  type CodexInputIface,\n} from \"./codex.mjs\";\nexport {\n  ApprovalsReviewer,\n  ClaudePermissionMode,\n  CodexApprovalPolicy,\n  CodexSandboxMode,\n  PiPermissionMode,\n  ReasoningLevel,\n  type InferenceInput,\n  type PermissionInput,\n  type SecretRefIface,\n} from \"./config-fields.mjs\";\nexport { FINAL_HARNESS_DEFINITIONS } from \"./definitions.mjs\";\nexport {\n  FINAL_HARNESS,\n  FINAL_REASONING_LEVELS,\n  serverlessFinal,\n  type ServerlessFinalInputIface,\n} from \"./final.mjs\";\nexport { ModelVendor } from \"./model-reference.mjs\";\nexport {\n  atUrl,\n  FINAL_PUBLISHER,\n  FinalAcpAdapter,\n  FinalHarness,\n  FinalHarnessInterface,\n  FinalHarnessName,\n  FinalWorkerProgram,\n  type AtUrlInputIface,\n} from \"./names.mjs\";\nexport {\n  CLAUDE_REASONING_LEVELS,\n  NANOCODE_CLAUDE_HARNESS,\n  serverlessNanocodeClaude,\n  type ServerlessNanocodeClaudeInputIface,\n} from \"./nanocode-claude.mjs\";\nexport {\n  CODEX_REASONING_LEVELS,\n  NANOCODE_CODEX_HARNESS,\n  serverlessNanocodeCodex,\n  type ServerlessNanocodeCodexInputIface,\n} from \"./nanocode-codex.mjs\";\nexport { PI_HARNESS, PI_REASONING_LEVELS, serverlessPi, type ServerlessPiInputIface } from \"./pi.mjs\";\n"],
+  "mappings": "AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAOP,SAAS,mBAAmB,gBAAgB;AAC5C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,iCAAiC;AAC1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,YAAY,qBAAqB,oBAAiD;",
+  "names": []
 }

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

@@ -0,0 +1,43 @@
+import { type HarnessUrlEnvironmentIface } from '@finalai/agent-provider';
+export declare const FINAL_PUBLISHER = "final";
+export declare enum FinalHarnessName {
+    Final = "final",
+    Pi = "pi",
+    NanocodeClaude = "nanocode-claude",
+    NanocodeCodex = "nanocode-codex",
+    ClaudeCode = "claude-code",
+    Codex = "codex",
+    AcpAgent = "acp-agent"
+}
+export declare enum FinalHarness {
+    Final = "final/final",
+    Pi = "final/pi",
+    NanocodeClaude = "final/nanocode-claude",
+    NanocodeCodex = "final/nanocode-codex",
+    ClaudeCode = "final/claude-code",
+    Codex = "final/codex",
+    AcpAgent = "final/acp-agent"
+}
+export declare enum FinalWorkerProgram {
+    Final = "final",
+    Pi = "pi",
+    NanocodeClaude = "nanocode-claude",
+    NanocodeCodex = "nanocode-codex"
+}
+export declare enum FinalAcpAdapter {
+    Pi = "pi-acp",
+    Nanocode = "nanocode-acp",
+    ClaudeCode = "claude-code-acp",
+    Codex = "codex-acp"
+}
+export declare enum FinalHarnessInterface {
+    PiAgent = "pi-agent",
+    Nanocode = "nanocode",
+    ClaudeAgentSdk = "claude-agent-sdk",
+    CodexAppServer = "codex-app-server"
+}
+export interface AtUrlInputIface {
+    url: string;
+    hop?: string;
+}
+export declare const atUrl: (input: AtUrlInputIface) => HarnessUrlEnvironmentIface;

package/dist/modules/harnesses/names.mjs

@@ -0,0 +1,59 @@
+import {
+  harnessUrlEnvironmentSchema
+} from "@finalai/agent-provider";
+const FINAL_PUBLISHER = "final";
+var FinalHarnessName = /* @__PURE__ */ ((FinalHarnessName2) => {
+  FinalHarnessName2["Final"] = "final";
+  FinalHarnessName2["Pi"] = "pi";
+  FinalHarnessName2["NanocodeClaude"] = "nanocode-claude";
+  FinalHarnessName2["NanocodeCodex"] = "nanocode-codex";
+  FinalHarnessName2["ClaudeCode"] = "claude-code";
+  FinalHarnessName2["Codex"] = "codex";
+  FinalHarnessName2["AcpAgent"] = "acp-agent";
+  return FinalHarnessName2;
+})(FinalHarnessName || {});
+var FinalHarness = /* @__PURE__ */ ((FinalHarness2) => {
+  FinalHarness2["Final"] = "final/final";
+  FinalHarness2["Pi"] = "final/pi";
+  FinalHarness2["NanocodeClaude"] = "final/nanocode-claude";
+  FinalHarness2["NanocodeCodex"] = "final/nanocode-codex";
+  FinalHarness2["ClaudeCode"] = "final/claude-code";
+  FinalHarness2["Codex"] = "final/codex";
+  FinalHarness2["AcpAgent"] = "final/acp-agent";
+  return FinalHarness2;
+})(FinalHarness || {});
+var FinalWorkerProgram = /* @__PURE__ */ ((FinalWorkerProgram2) => {
+  FinalWorkerProgram2["Final"] = "final";
+  FinalWorkerProgram2["Pi"] = "pi";
+  FinalWorkerProgram2["NanocodeClaude"] = "nanocode-claude";
+  FinalWorkerProgram2["NanocodeCodex"] = "nanocode-codex";
+  return FinalWorkerProgram2;
+})(FinalWorkerProgram || {});
+var FinalAcpAdapter = /* @__PURE__ */ ((FinalAcpAdapter2) => {
+  FinalAcpAdapter2["Pi"] = "pi-acp";
+  FinalAcpAdapter2["Nanocode"] = "nanocode-acp";
+  FinalAcpAdapter2["ClaudeCode"] = "claude-code-acp";
+  FinalAcpAdapter2["Codex"] = "codex-acp";
+  return FinalAcpAdapter2;
+})(FinalAcpAdapter || {});
+var FinalHarnessInterface = /* @__PURE__ */ ((FinalHarnessInterface2) => {
+  FinalHarnessInterface2["PiAgent"] = "pi-agent";
+  FinalHarnessInterface2["Nanocode"] = "nanocode";
+  FinalHarnessInterface2["ClaudeAgentSdk"] = "claude-agent-sdk";
+  FinalHarnessInterface2["CodexAppServer"] = "codex-app-server";
+  return FinalHarnessInterface2;
+})(FinalHarnessInterface || {});
+const atUrl = (input) => harnessUrlEnvironmentSchema.parse({
+  url: input.url,
+  ...input.hop == null ? {} : { hop: input.hop }
+});
+export {
+  FINAL_PUBLISHER,
+  FinalAcpAdapter,
+  FinalHarness,
+  FinalHarnessInterface,
+  FinalHarnessName,
+  FinalWorkerProgram,
+  atUrl
+};
+//# sourceMappingURL=names.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/harnesses/names.ts"],
+  "sourcesContent": ["import {\n  harnessUrlEnvironmentSchema,\n  type HarnessUrlEnvironmentIface,\n} from '@finalai/agent-provider';\n\n// The publisher handle Final's harnesses, adapters and provider are public under.\nexport const FINAL_PUBLISHER = 'final';\n\n// The names Final's harness definitions are published under in its own project.\nexport enum FinalHarnessName {\n  // Final's own Pi-derived loop.\n  Final = 'final',\n  Pi = 'pi',\n  NanocodeClaude = 'nanocode-claude',\n  NanocodeCodex = 'nanocode-codex',\n  ClaudeCode = 'claude-code',\n  Codex = 'codex',\n  // Any agent already speaking ACP v2 with Final's extensions, at its URL.\n  AcpAgent = 'acp-agent',\n}\n\n// Final's harnesses as harness settings name them from any project: the\n// published name qualified by Final's publisher handle\n// (`{ harness: FinalHarness.Pi, configuration }`).\nexport enum FinalHarness {\n  Final = 'final/final',\n  Pi = 'final/pi',\n  NanocodeClaude = 'final/nanocode-claude',\n  NanocodeCodex = 'final/nanocode-codex',\n  ClaudeCode = 'final/claude-code',\n  Codex = 'final/codex',\n  AcpAgent = 'final/acp-agent',\n}\n\n// The worker programs Final's worker runtime carries, by the name a harness\n// definition's `run.worker.program` gives.\nexport enum FinalWorkerProgram {\n  Final = 'final',\n  Pi = 'pi',\n  NanocodeClaude = 'nanocode-claude',\n  NanocodeCodex = 'nanocode-codex',\n}\n\n// The names Final's ACP adapter definitions are published under.\nexport enum FinalAcpAdapter {\n  // The worker programs mapping Pi and nanocode to ACP v2.\n  Pi = 'pi-acp',\n  Nanocode = 'nanocode-acp',\n  // The process adapters for Claude Code (on the Claude Agent SDK) and the\n  // Codex app-server.\n  ClaudeCode = 'claude-code-acp',\n  Codex = 'codex-acp',\n}\n\n// The native interfaces Final's adapters map to ACP v2.\nexport enum FinalHarnessInterface {\n  PiAgent = 'pi-agent',\n  Nanocode = 'nanocode',\n  ClaudeAgentSdk = 'claude-agent-sdk',\n  CodexAppServer = 'codex-app-server',\n}\n\nexport interface AtUrlInputIface {\n  // Where the ACP v2 endpoint answers (`wss://`, `https://`).\n  url: string;\n  // The project secret holding its bearer token.\n  hop?: string;\n}\n\n// A harness already running elsewhere: an ACP v2 endpoint at a URL. Nothing\n// is started; the endpoint must speak ACP v2 with Final's extensions.\nexport const atUrl = (input: AtUrlInputIface): HarnessUrlEnvironmentIface =>\n  harnessUrlEnvironmentSchema.parse({\n    url: input.url,\n    ...(input.hop == null ? {} : { hop: input.hop }),\n  });\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AAGA,MAAM,kBAAkB;AAGxB,IAAK,mBAAL,kBAAKA,sBAAL;AAEL,EAAAA,kBAAA,WAAQ;AACR,EAAAA,kBAAA,QAAK;AACL,EAAAA,kBAAA,oBAAiB;AACjB,EAAAA,kBAAA,mBAAgB;AAChB,EAAAA,kBAAA,gBAAa;AACb,EAAAA,kBAAA,WAAQ;AAER,EAAAA,kBAAA,cAAW;AATD,SAAAA;AAAA,GAAA;AAeL,IAAK,eAAL,kBAAKC,kBAAL;AACL,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,QAAK;AACL,EAAAA,cAAA,oBAAiB;AACjB,EAAAA,cAAA,mBAAgB;AAChB,EAAAA,cAAA,gBAAa;AACb,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,cAAW;AAPD,SAAAA;AAAA,GAAA;AAYL,IAAK,qBAAL,kBAAKC,wBAAL;AACL,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,QAAK;AACL,EAAAA,oBAAA,oBAAiB;AACjB,EAAAA,oBAAA,mBAAgB;AAJN,SAAAA;AAAA,GAAA;AAQL,IAAK,kBAAL,kBAAKC,qBAAL;AAEL,EAAAA,iBAAA,QAAK;AACL,EAAAA,iBAAA,cAAW;AAGX,EAAAA,iBAAA,gBAAa;AACb,EAAAA,iBAAA,WAAQ;AAPE,SAAAA;AAAA,GAAA;AAWL,IAAK,wBAAL,kBAAKC,2BAAL;AACL,EAAAA,uBAAA,aAAU;AACV,EAAAA,uBAAA,cAAW;AACX,EAAAA,uBAAA,oBAAiB;AACjB,EAAAA,uBAAA,oBAAiB;AAJP,SAAAA;AAAA,GAAA;AAgBL,MAAM,QAAQ,CAAC,UACpB,4BAA4B,MAAM;AAAA,EAChC,KAAK,MAAM;AAAA,EACX,GAAI,MAAM,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,MAAM,IAAI;AAChD,CAAC;",
+  "names": ["FinalHarnessName", "FinalHarness", "FinalWorkerProgram", "FinalAcpAdapter", "FinalHarnessInterface"]
+}

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;
+}>;