@finalai/final-agent-provider 0.10.1 → 0.11.0

package/dist/modules/harnesses/codex.mjs

@@ -0,0 +1,90 @@
+import { defineHarness } from "@finalai/agent-definition/authoring";
+import {
+  CredentialDelivery,
+  HarnessFeature,
+  InferenceSourceKind,
+  McpTransportKind,
+  PermissionLevel,
+  PromptWhileRunning,
+  SandboxWire
+} from "@finalai/agent-provider";
+import {
+  configObjectJson,
+  harnessSettings,
+  inferenceJson,
+  permissionModeJson,
+  reasoningJson,
+  ReasoningLevel
+} from "./config-fields.mjs";
+import { ModelVendor } from "./model-reference.mjs";
+import { FinalAcpAdapter, FinalHarness, FinalHarnessInterface } from "./names.mjs";
+const CODEX_APP_SERVER_REASONING_LEVELS = [
+  ReasoningLevel.Minimal,
+  ReasoningLevel.Low,
+  ReasoningLevel.Medium,
+  ReasoningLevel.High
+];
+const CODEX_HARNESS = defineHarness({
+  title: "Codex",
+  description: "The Codex app-server, run as a process on the machine it works on.",
+  configurationSchema: configObjectJson({
+    title: "Codex",
+    properties: {
+      model: { $ref: "final://schemas/model-picker", type: "string", minLength: 1 },
+      reasoning: reasoningJson(CODEX_APP_SERVER_REASONING_LEVELS),
+      inference: inferenceJson(),
+      permissionMode: permissionModeJson()
+    }
+  }),
+  // The app-server's approvals cannot carry an agent's per-tool policy.
+  features: [HarnessFeature.Skills, HarnessFeature.McpTools, HarnessFeature.SystemInstructions],
+  lowestPermission: PermissionLevel.Ask,
+  inference: {
+    vendors: [ModelVendor.OpenAI],
+    kinds: [
+      InferenceSourceKind.Harness,
+      InferenceSourceKind.Subscription,
+      InferenceSourceKind.ApiKey,
+      InferenceSourceKind.Final
+    ],
+    delivery: CredentialDelivery.AtOpen
+  },
+  native: {
+    files: { tools: ["apply_patch"] },
+    shell: { tools: ["exec_command", "write_stdin"] }
+  },
+  interface: FinalHarnessInterface.CodexAppServer,
+  adapter: FinalAcpAdapter.Codex,
+  run: {
+    process: {
+      command: "codex",
+      args: [
+        "app-server",
+        { when: "configuration.model", args: ["-c", "model={{configuration.model}}"] },
+        {
+          when: "configuration.reasoning",
+          args: ["-c", "model_reasoning_effort={{configuration.reasoning}}"]
+        }
+      ]
+    }
+  },
+  // The adapter proxies every MCP server it is handed (acp ones over the ACP connection)
+  // and reports full tool results.
+  mcp: [McpTransportKind.Acp, McpTransportKind.Http, McpTransportKind.Stdio],
+  consumes: [SandboxWire.Mcp],
+  supports: { observe: true, resumeReplay: true, fork: true, authorMeta: true },
+  // The adapter steers it into the running turn (turn/steer); one idle ends both.
+  promptWhileRunning: PromptWhileRunning.Inject,
+  // Its stdio belongs to the session service's connection to the sandbox.
+  sessionSurvivesDisconnect: false
+});
+const codex = ({
+  environment,
+  ...configuration
+} = {}) => harnessSettings({ harness: FinalHarness.Codex, configuration, environment });
+export {
+  CODEX_APP_SERVER_REASONING_LEVELS,
+  CODEX_HARNESS,
+  codex
+};
+//# sourceMappingURL=codex.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/harnesses/codex.ts"],
+  "sourcesContent": ["import { defineHarness } from '@finalai/agent-definition/authoring';\nimport {\n  CredentialDelivery,\n  HarnessFeature,\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  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 } from \"./names.mjs\";\n\n// The Codex app-server as a process on a machine, behind Final's ACP adapter.\n// Its own file and shell tools work on the machine it runs on, which is\n// therefore the sandbox provided for `files` and `shell`.\n\n// What the app-server takes as model_reasoning_effort.\nexport const CODEX_APP_SERVER_REASONING_LEVELS = [\n  ReasoningLevel.Minimal,\n  ReasoningLevel.Low,\n  ReasoningLevel.Medium,\n  ReasoningLevel.High,\n] as const;\n\nexport const CODEX_HARNESS: HarnessDefinitionIface = defineHarness({\n  title: 'Codex',\n  description: 'The Codex app-server, run as a process on the machine it works on.',\n  configurationSchema: configObjectJson({\n    title: 'Codex',\n    properties: {\n      model: { $ref: 'final://schemas/model-picker', type: 'string', minLength: 1 },\n      reasoning: reasoningJson(CODEX_APP_SERVER_REASONING_LEVELS),\n      inference: inferenceJson(),\n      permissionMode: permissionModeJson(),\n    },\n  }),\n  // The app-server's approvals cannot carry an agent's per-tool policy.\n  features: [HarnessFeature.Skills, HarnessFeature.McpTools, HarnessFeature.SystemInstructions],\n  lowestPermission: PermissionLevel.Ask,\n  inference: {\n    vendors: [ModelVendor.OpenAI],\n    kinds: [\n      InferenceSourceKind.Harness,\n      InferenceSourceKind.Subscription,\n      InferenceSourceKind.ApiKey,\n      InferenceSourceKind.Final,\n    ],\n    delivery: CredentialDelivery.AtOpen,\n  },\n  native: {\n    files: { tools: ['apply_patch'] },\n    shell: { tools: ['exec_command', 'write_stdin'] },\n  },\n  interface: FinalHarnessInterface.CodexAppServer,\n  adapter: FinalAcpAdapter.Codex,\n  run: {\n    process: {\n      command: 'codex',\n      args: [\n        'app-server',\n        { when: 'configuration.model', args: ['-c', 'model={{configuration.model}}'] },\n        {\n          when: 'configuration.reasoning',\n          args: ['-c', 'model_reasoning_effort={{configuration.reasoning}}'],\n        },\n      ],\n    },\n  },\n  // The adapter proxies every MCP server it is handed (acp ones over the ACP connection)\n  // and reports full tool results.\n  mcp: [McpTransportKind.Acp, McpTransportKind.Http, McpTransportKind.Stdio],\n  consumes: [SandboxWire.Mcp],\n  supports: { observe: true, resumeReplay: true, fork: true, authorMeta: true },\n  // The adapter steers it into the running turn (turn/steer); one idle ends both.\n  promptWhileRunning: PromptWhileRunning.Inject,\n  // Its stdio belongs to the session service's connection to the sandbox.\n  sessionSurvivesDisconnect: false,\n});\n\nexport interface CodexInputIface {\n  model?: string;\n  reasoning?:\n    | (typeof CODEX_APP_SERVER_REASONING_LEVELS)[number]\n    | `${(typeof CODEX_APP_SERVER_REASONING_LEVELS)[number]}`;\n  // Absent: only the CLI's own login on the machine.\n  inference?: InferenceInput;\n  permissionMode?: PermissionInput;\n  // The sandbox it runs in (absent: the one provided for `shell`), or an ACP\n  // endpoint already running it: `atUrl({ url, hop })`.\n  environment?: HarnessEnvironmentIface;\n}\n\nexport const codex = ({\n  environment,\n  ...configuration\n}: CodexInputIface = {}): HarnessSettingsIface =>\n  harnessSettings({ harness: FinalHarness.Codex, configuration, environment });\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAC9B;AAAA,EACE;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,OAGK;AACP,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB,cAAc,6BAA6B;AAO9D,MAAM,oCAAoC;AAAA,EAC/C,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AACjB;AAEO,MAAM,gBAAwC,cAAc;AAAA,EACjE,OAAO;AAAA,EACP,aAAa;AAAA,EACb,qBAAqB,iBAAiB;AAAA,IACpC,OAAO;AAAA,IACP,YAAY;AAAA,MACV,OAAO,EAAE,MAAM,gCAAgC,MAAM,UAAU,WAAW,EAAE;AAAA,MAC5E,WAAW,cAAc,iCAAiC;AAAA,MAC1D,WAAW,cAAc;AAAA,MACzB,gBAAgB,mBAAmB;AAAA,IACrC;AAAA,EACF,CAAC;AAAA;AAAA,EAED,UAAU,CAAC,eAAe,QAAQ,eAAe,UAAU,eAAe,kBAAkB;AAAA,EAC5F,kBAAkB,gBAAgB;AAAA,EAClC,WAAW;AAAA,IACT,SAAS,CAAC,YAAY,MAAM;AAAA,IAC5B,OAAO;AAAA,MACL,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,IACtB;AAAA,IACA,UAAU,mBAAmB;AAAA,EAC/B;AAAA,EACA,QAAQ;AAAA,IACN,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;AAAA,IAChC,OAAO,EAAE,OAAO,CAAC,gBAAgB,aAAa,EAAE;AAAA,EAClD;AAAA,EACA,WAAW,sBAAsB;AAAA,EACjC,SAAS,gBAAgB;AAAA,EACzB,KAAK;AAAA,IACH,SAAS;AAAA,MACP,SAAS;AAAA,MACT,MAAM;AAAA,QACJ;AAAA,QACA,EAAE,MAAM,uBAAuB,MAAM,CAAC,MAAM,+BAA+B,EAAE;AAAA,QAC7E;AAAA,UACE,MAAM;AAAA,UACN,MAAM,CAAC,MAAM,oDAAoD;AAAA,QACnE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA,EAGA,KAAK,CAAC,iBAAiB,KAAK,iBAAiB,MAAM,iBAAiB,KAAK;AAAA,EACzE,UAAU,CAAC,YAAY,GAAG;AAAA,EAC1B,UAAU,EAAE,SAAS,MAAM,cAAc,MAAM,MAAM,MAAM,YAAY,KAAK;AAAA;AAAA,EAE5E,oBAAoB,mBAAmB;AAAA;AAAA,EAEvC,2BAA2B;AAC7B,CAAC;AAeM,MAAM,QAAQ,CAAC;AAAA,EACpB;AAAA,EACA,GAAG;AACL,IAAqB,CAAC,MACpB,gBAAgB,EAAE,SAAS,aAAa,OAAO,eAAe,YAAY,CAAC;",
+  "names": []
+}

package/dist/modules/harnesses/config-fields.d.mts

@@ -1,4 +1,4 @@
-import { type CredentialPolicyIface, type DynamicSlotIface, type InstructionFragmentIface, type JsonObject, type JsonSchema, type JsonValue, type PackageProviderRefIface, type SkillBundleIface } from '@finalai/agent-provider';
+import { PermissionLevel, type HarnessSettingsIface, type InferenceSource, type JsonObject, type JsonSchema, type JsonValue, type HarnessEnvironmentIface } from '@finalai/agent-provider';
 import * as z from 'zod';
 export { MODEL_REFERENCE_PATTERN } from "./model-reference.mjs";
 export declare enum ReasoningLevel {
@@ -27,7 +27,7 @@ export declare enum CodexApprovalPolicy {
     OnFailure = "on-failure",
     Never = "never"
 }
-export declare enum CodexApprovalsReviewer {
+export declare enum ApprovalsReviewer {
     User = "user",
     AutoReview = "auto-review"
 }
@@ -39,8 +39,11 @@ export declare enum CodexSandboxMode {
 export interface SecretRefIface {
     secretKey: string;
 }
-export type InstructionInput = InstructionFragmentIface | DynamicSlotIface;
-export type SkillInput = SkillBundleIface | DynamicSlotIface;
+export type PermissionInput = PermissionLevel | `${PermissionLevel}`;
+export type InferenceInput = InferenceSource | readonly InferenceSource[];
+export declare const piPermissionModeFor: (level: PermissionLevel) => PiPermissionMode;
+export declare const claudePermissionModeFor: (level: PermissionLevel, reviewer?: ApprovalsReviewer) => ClaudePermissionMode;
+export declare const codexApprovalPolicyFor: (level: PermissionLevel) => CodexApprovalPolicy;
 export declare const configObjectJson: (args: {
     title: string;
     properties: Record<string, JsonSchema>;
@@ -48,71 +51,109 @@ export declare const configObjectJson: (args: {
 }) => JsonSchema;
 export declare const modelJson: (ids?: readonly string[], defaultId?: string) => JsonSchema;
 export declare const reasoningJson: (levels: readonly ReasoningLevel[]) => JsonSchema;
-export declare const credentialsJson: () => JsonSchema;
-export declare const permissionModeJson: (modes: readonly string[], defaultMode?: string) => JsonSchema;
-export declare const instructionsJson: () => JsonSchema;
-export declare const skillsJson: () => JsonSchema;
+export declare const inferenceJson: () => JsonSchema;
+export declare const permissionModeJson: () => JsonSchema;
+export declare const approvalsReviewerJson: () => JsonSchema;
 export declare const secretRefJson: () => JsonSchema;
 export declare const urlJson: (title: string, schemes: readonly string[]) => JsonSchema;
 export declare const absolutePathJson: (title: string) => JsonSchema;
 export declare const modelZod: (ids?: readonly string[]) => z.ZodString;
 export declare const reasoningZod: (levels: readonly ReasoningLevel[]) => z.ZodEnum<typeof ReasoningLevel>;
-export declare const credentialsZod: () => z.ZodObject<{
-    payer: z.ZodEnum<typeof import("@finalai/agent-provider").CredentialPayer>;
-    tryInOrder: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        kind: z.ZodLiteral<import("@finalai/agent-provider").CredentialNodeKind.Subscription>;
-        owner: z.ZodEnum<typeof import("@finalai/agent-provider").CredentialOwner>;
-        vendor: z.ZodOptional<z.ZodString>;
-        pin: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<import("@finalai/agent-provider").CredentialNodeKind.ApiKey>;
-        secret: z.ZodString;
-        baseUrl: z.ZodOptional<z.ZodString>;
-        vendor: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        pin: z.ZodOptional<z.ZodString>;
-        kind: z.ZodLiteral<import("@finalai/agent-provider").CredentialNodeKind.ApiKey>;
-        owner: z.ZodEnum<typeof import("@finalai/agent-provider").CredentialOwner>;
-        vendor: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<import("@finalai/agent-provider").CredentialNodeKind.Platform>;
-        budget: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<import("@finalai/agent-provider").CredentialNodeKind.HarnessOwned>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<import("@finalai/agent-provider").CredentialNodeKind.Custom>;
-        resolver: z.ZodString;
-        events: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof import("@finalai/agent-provider").DynamicEvent>>>;
-    }, z.core.$strip>]>>;
-}, z.core.$strip>;
-export declare const instructionsZod: () => z.ZodDefault<z.ZodArray<z.ZodObject<{
-    role: z.ZodEnum<typeof import("@finalai/agent-provider").InstructionRole>;
-    content: z.ZodString;
-    source: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>>>;
-export declare const skillsZod: () => z.ZodDefault<z.ZodArray<z.ZodObject<{
-    key: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    files: z.ZodArray<z.ZodObject<{
-        path: z.ZodString;
-        content: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>>>;
+export declare const inferenceZod: () => z.ZodPipe<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.Subscription>;
+    credential: z.ZodDefault<z.ZodEnum<typeof import("@finalai/agent-provider").CredentialScope>>;
+    vendor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.ApiKey>;
+    secret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    vendor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.Final>;
+    billTo: z.ZodDefault<z.ZodEnum<typeof import("@finalai/agent-provider").InferenceBillTo>>;
+    budget: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.Harness>;
+}, z.core.$strict>], "source">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.Subscription>;
+    credential: z.ZodDefault<z.ZodEnum<typeof import("@finalai/agent-provider").CredentialScope>>;
+    vendor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.ApiKey>;
+    secret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    vendor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.Final>;
+    billTo: z.ZodDefault<z.ZodEnum<typeof import("@finalai/agent-provider").InferenceBillTo>>;
+    budget: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodLiteral<import("@finalai/agent-provider").InferenceSourceKind.Harness>;
+}, z.core.$strict>], "source">>]>, z.ZodTransform<({
+    source: import("@finalai/agent-provider").InferenceSourceKind.Subscription;
+    credential: import("@finalai/agent-provider").CredentialScope;
+    vendor?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.ApiKey;
+    secret: string;
+    baseUrl?: string | undefined;
+    vendor?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.Final;
+    billTo: import("@finalai/agent-provider").InferenceBillTo;
+    budget?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.Harness;
+})[], {
+    source: import("@finalai/agent-provider").InferenceSourceKind.Subscription;
+    credential: import("@finalai/agent-provider").CredentialScope;
+    vendor?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.ApiKey;
+    secret: string;
+    baseUrl?: string | undefined;
+    vendor?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.Final;
+    billTo: import("@finalai/agent-provider").InferenceBillTo;
+    budget?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.Harness;
+} | ({
+    source: import("@finalai/agent-provider").InferenceSourceKind.Subscription;
+    credential: import("@finalai/agent-provider").CredentialScope;
+    vendor?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.ApiKey;
+    secret: string;
+    baseUrl?: string | undefined;
+    vendor?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.Final;
+    billTo: import("@finalai/agent-provider").InferenceBillTo;
+    budget?: string | undefined;
+} | {
+    source: import("@finalai/agent-provider").InferenceSourceKind.Harness;
+})[]>>;
+export declare const permissionModeZod: () => z.ZodEnum<typeof PermissionLevel>;
+export declare const approvalsReviewerZod: () => z.ZodEnum<typeof ApprovalsReviewer>;
 export declare const secretRefZod: () => z.ZodObject<{
     secretKey: z.ZodString;
 }, z.core.$strip>;
 export declare const urlZod: (schemes: readonly string[]) => z.ZodString;
 export declare const absolutePathZod: () => z.ZodString;
 export declare const parseHarnessConfig: <T extends z.ZodType>(args: {
-    specifier: string;
+    harness: string;
     schema: T;
-    config: JsonValue;
+    config: unknown;
 }) => z.output<T>;
 export declare const toJsonValue: <Value>(value: Value) => JsonValue;
 export declare const toJsonObject: <Value>(value: Value) => JsonObject;
-export type CredentialsInput = CredentialPolicyIface;
-export interface HarnessBindingOutputIface {
-    harness: PackageProviderRefIface;
-    config: object;
-}
-export declare const harnessBinding: <Config extends object>(specifier: string, config: Config) => HarnessBindingOutputIface;
+export declare const harnessSettings: (args: {
+    harness: string;
+    adapter?: string;
+    configuration: {
+        inference?: InferenceInput;
+    } & Record<string, unknown>;
+    environment?: HarnessEnvironmentIface;
+}) => HarnessSettingsIface;

package/dist/modules/harnesses/config-fields.mjs

@@ -1,14 +1,12 @@
-import { MODEL_REFERENCE_PATTERN } from "./model-reference.mjs";
 import {
-  credentialPolicySchema,
-  instructionFragmentSchema,
+  inferenceSchema,
   jsonObjectSchema,
   jsonValueSchema,
-  packageRef,
-  SCHEMA_IDS,
-  skillBundleSchema
+  PermissionLevel,
+  SCHEMA_IDS
 } from "@finalai/agent-provider";
 import * as z from "zod";
+import { MODEL_REFERENCE_PATTERN } from "./model-reference.mjs";
 import { MODEL_REFERENCE_PATTERN as MODEL_REFERENCE_PATTERN2 } from "./model-reference.mjs";
 var ReasoningLevel = /* @__PURE__ */ ((ReasoningLevel2) => {
   ReasoningLevel2["None"] = "none";
@@ -40,17 +38,24 @@ var CodexApprovalPolicy = /* @__PURE__ */ ((CodexApprovalPolicy2) => {
   CodexApprovalPolicy2["Never"] = "never";
   return CodexApprovalPolicy2;
 })(CodexApprovalPolicy || {});
-var CodexApprovalsReviewer = /* @__PURE__ */ ((CodexApprovalsReviewer2) => {
-  CodexApprovalsReviewer2["User"] = "user";
-  CodexApprovalsReviewer2["AutoReview"] = "auto-review";
-  return CodexApprovalsReviewer2;
-})(CodexApprovalsReviewer || {});
+var ApprovalsReviewer = /* @__PURE__ */ ((ApprovalsReviewer2) => {
+  ApprovalsReviewer2["User"] = "user";
+  ApprovalsReviewer2["AutoReview"] = "auto-review";
+  return ApprovalsReviewer2;
+})(ApprovalsReviewer || {});
 var CodexSandboxMode = /* @__PURE__ */ ((CodexSandboxMode2) => {
   CodexSandboxMode2["ReadOnly"] = "read-only";
   CodexSandboxMode2["WorkspaceWrite"] = "workspace-write";
   CodexSandboxMode2["DangerFullAccess"] = "danger-full-access";
   return CodexSandboxMode2;
 })(CodexSandboxMode || {});
+const piPermissionModeFor = (level) => level === PermissionLevel.Auto ? "auto" /* Auto */ : "ask" /* Ask */;
+const claudePermissionModeFor = (level, reviewer = "user" /* User */) => {
+  if (level === PermissionLevel.Auto) return "bypass" /* Bypass */;
+  if (reviewer === "auto-review" /* AutoReview */) return "auto" /* Auto */;
+  return level === PermissionLevel.Review ? "accept-edits" /* AcceptEdits */ : "default" /* Default */;
+};
+const codexApprovalPolicyFor = (level) => level === PermissionLevel.Auto ? "never" /* Never */ : level === PermissionLevel.Review ? "on-request" /* OnRequest */ : "untrusted" /* Untrusted */;
 const configObjectJson = (args) => ({
   type: "object",
   title: args.title,
@@ -68,14 +73,17 @@ const reasoningJson = (levels) => ({
   $ref: SCHEMA_IDS.reasoning,
   enum: [...levels]
 });
-const credentialsJson = () => ({ $ref: SCHEMA_IDS.credentialPolicy });
-const permissionModeJson = (modes, defaultMode) => {
-  const schema = { $ref: SCHEMA_IDS.permissionMode, enum: [...modes] };
-  if (defaultMode != null) schema.default = defaultMode;
-  return schema;
-};
-const instructionsJson = () => ({ $ref: SCHEMA_IDS.instructions });
-const skillsJson = () => ({ $ref: SCHEMA_IDS.skills });
+const inferenceJson = () => ({ $ref: SCHEMA_IDS.inference });
+const permissionModeJson = () => ({
+  $ref: SCHEMA_IDS.permissionMode,
+  enum: Object.values(PermissionLevel)
+});
+const approvalsReviewerJson = () => ({
+  type: "string",
+  title: "Approvals reviewer",
+  enum: Object.values(ApprovalsReviewer),
+  default: "user" /* User */
+});
 const secretRefJson = () => ({ $ref: SCHEMA_IDS.secretRef });
 const urlJson = (title, schemes) => ({
   type: "string",
@@ -101,9 +109,9 @@ const modelZod = (ids) => {
 const reasoningZod = (levels) => z.nativeEnum(ReasoningLevel).refine((level) => levels.includes(level), {
   message: `reasoning must be one of: ${levels.join(", ")}`
 });
-const credentialsZod = () => credentialPolicySchema;
-const instructionsZod = () => z.array(instructionFragmentSchema).default([]);
-const skillsZod = () => z.array(skillBundleSchema).default([]);
+const inferenceZod = () => inferenceSchema;
+const permissionModeZod = () => z.nativeEnum(PermissionLevel);
+const approvalsReviewerZod = () => z.nativeEnum(ApprovalsReviewer);
 const secretRefZod = () => z.object({ secretKey: z.string().min(1) });
 const urlZod = (schemes) => z.string().url().refine((value) => schemes.some((scheme) => value.startsWith(`${scheme}://`)), {
   message: `url must use one of: ${schemes.join(", ")}`
@@ -113,40 +121,55 @@ const parseHarnessConfig = (args) => {
   const parsed = args.schema.safeParse(args.config);
   if (parsed.success) return parsed.data;
   const issues = parsed.error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`).join("; ");
-  throw new Error(`invalid config for ${args.specifier}: ${issues}`);
+  throw new Error(`invalid configuration for ${args.harness}: ${issues}`);
 };
 const toJsonValue = (value) => jsonValueSchema.parse(JSON.parse(JSON.stringify(value)));
 const toJsonObject = (value) => jsonObjectSchema.parse(JSON.parse(JSON.stringify(value)));
-const harnessBinding = (specifier, config) => ({
-  harness: packageRef(specifier),
-  config: { ...config }
-});
+const inferenceList = (inference) => {
+  if (inference == null) return void 0;
+  const list = Array.isArray(inference) ? [...inference] : [inference];
+  if (list.length === 0) throw new Error("inference lists at least one source");
+  return list;
+};
+const harnessSettings = (args) => {
+  const { inference, ...rest } = args.configuration;
+  const list = inferenceList(inference);
+  const environment = args.environment;
+  return {
+    harness: args.harness,
+    ...args.adapter == null ? {} : { adapter: args.adapter },
+    configuration: toJsonObject({ ...rest, ...list == null ? {} : { inference: list } }),
+    ...environment == null ? {} : { environment: typeof environment === "string" ? environment : { ...environment } }
+  };
+};
 export {
+  ApprovalsReviewer,
   ClaudePermissionMode,
   CodexApprovalPolicy,
-  CodexApprovalsReviewer,
   CodexSandboxMode,
   MODEL_REFERENCE_PATTERN2 as MODEL_REFERENCE_PATTERN,
   PiPermissionMode,
   ReasoningLevel,
   absolutePathJson,
   absolutePathZod,
+  approvalsReviewerJson,
+  approvalsReviewerZod,
+  claudePermissionModeFor,
+  codexApprovalPolicyFor,
   configObjectJson,
-  credentialsJson,
-  credentialsZod,
-  harnessBinding,
-  instructionsJson,
-  instructionsZod,
+  harnessSettings,
+  inferenceJson,
+  inferenceZod,
   modelJson,
   modelZod,
   parseHarnessConfig,
   permissionModeJson,
+  permissionModeZod,
+  piPermissionModeFor,
   reasoningJson,
   reasoningZod,
   secretRefJson,
   secretRefZod,
-  skillsJson,
-  skillsZod,
   toJsonObject,
   toJsonValue,
   urlJson,

package/dist/modules/harnesses/config-fields.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/harnesses/config-fields.ts"],
-  "sourcesContent": ["import { MODEL_REFERENCE_PATTERN } from \"./model-reference.mjs\";\nimport {\n  credentialPolicySchema,\n  instructionFragmentSchema,\n  jsonObjectSchema,\n  jsonValueSchema,\n  packageRef,\n  SCHEMA_IDS,\n  skillBundleSchema,\n  type CredentialPolicyIface,\n  type DynamicSlotIface,\n  type InstructionFragmentIface,\n  type JsonObject,\n  type JsonSchema,\n  type JsonValue,\n  type PackageProviderRefIface,\n  type SkillBundleIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\n\nexport { MODEL_REFERENCE_PATTERN } from \"./model-reference.mjs\";\n\n// Config-schema building blocks shared by the harness modules. Each harness\n// writes its JSON Schema (what Build renders, $ref-ing the shared\n// final://schemas/* fragments) and a zod mirror (what open() validates the\n// resolved config with) from these, and a test keeps the two aligned.\n\n// Mirrors the final://schemas/reasoning fragment's enum.\nexport enum ReasoningLevel {\n  None = 'none',\n  Minimal = 'minimal',\n  Low = 'low',\n  Medium = 'medium',\n  High = 'high',\n  Max = 'max',\n}\n\n// Pi and the Final harness.\nexport enum PiPermissionMode {\n  Auto = 'auto',\n  Ask = 'ask',\n  Readonly = 'readonly',\n}\n\n// Claude Code and the nanocode Claude engine.\nexport enum ClaudePermissionMode {\n  Default = 'default',\n  AcceptEdits = 'accept-edits',\n  Plan = 'plan',\n  Bypass = 'bypass',\n  // The nanocode Claude engine only: a reviewer model answers what `default` would ask,\n  // as Claude Code's auto mode does.\n  Auto = 'auto',\n}\n\n// Codex and the nanocode Codex engine.\nexport enum CodexApprovalPolicy {\n  Untrusted = 'untrusted',\n  OnRequest = 'on-request',\n  OnFailure = 'on-failure',\n  Never = 'never',\n}\n\n// Who answers what the nanocode Codex engine's approval policy would ask, as the Codex\n// CLI's approvals_reviewer: the person, or a reviewer model.\nexport enum CodexApprovalsReviewer {\n  User = 'user',\n  AutoReview = 'auto-review',\n}\n\n// The Codex CLI's OS sandbox on a host you run.\nexport enum CodexSandboxMode {\n  ReadOnly = 'read-only',\n  WorkspaceWrite = 'workspace-write',\n  DangerFullAccess = 'danger-full-access',\n}\n\nexport interface SecretRefIface {\n  secretKey: string;\n}\n\nexport type InstructionInput = InstructionFragmentIface | DynamicSlotIface;\nexport type SkillInput = SkillBundleIface | DynamicSlotIface;\n\nexport const configObjectJson = (args: {\n  title: string;\n  properties: Record<string, JsonSchema>;\n  required?: string[];\n}): JsonSchema => ({\n  type: 'object',\n  title: args.title,\n  additionalProperties: false,\n  properties: args.properties,\n  required: args.required ?? [],\n});\n\n// Hosted harnesses leave choices and defaults to the platform; explicit lists stay restricted.\nexport const modelJson = (ids?: readonly string[], defaultId?: string): JsonSchema => ({\n  $ref: SCHEMA_IDS.modelPicker,\n  type: 'string',\n  ...(ids == null\n    ? { minLength: 1, maxLength: 200, pattern: MODEL_REFERENCE_PATTERN }\n    : { enum: [...ids] }),\n  ...(defaultId == null ? {} : { default: defaultId }),\n});\n\nexport const reasoningJson = (levels: readonly ReasoningLevel[]): JsonSchema => ({\n  $ref: SCHEMA_IDS.reasoning,\n  enum: [...levels],\n});\n\nexport const credentialsJson = (): JsonSchema => ({ $ref: SCHEMA_IDS.credentialPolicy });\n\nexport const permissionModeJson = (modes: readonly string[], defaultMode?: string): JsonSchema => {\n  const schema: JsonSchema = { $ref: SCHEMA_IDS.permissionMode, enum: [...modes] };\n  if (defaultMode != null) schema.default = defaultMode;\n  return schema;\n};\n\nexport const instructionsJson = (): JsonSchema => ({ $ref: SCHEMA_IDS.instructions });\nexport const skillsJson = (): JsonSchema => ({ $ref: SCHEMA_IDS.skills });\nexport const secretRefJson = (): JsonSchema => ({ $ref: SCHEMA_IDS.secretRef });\n\nexport const urlJson = (title: string, schemes: readonly string[]): JsonSchema => ({\n  type: 'string',\n  title,\n  format: 'uri',\n  pattern: `^(${schemes.join('|')})://`,\n});\n\nexport const absolutePathJson = (title: string): JsonSchema => ({\n  type: 'string',\n  title,\n  pattern: '^/',\n});\n\nexport const modelZod = (ids?: readonly string[]) => {\n  if (ids != null)\n    return z.string().refine((id) => ids.includes(id), {\n      message: `model must be one of: ${ids.join(', ')}`,\n    });\n  const pattern = new RegExp(MODEL_REFERENCE_PATTERN);\n  return z.string().min(1).max(200).regex(pattern, {\n    message: 'model must be a printable ASCII reference without empty path segments',\n  });\n};\n\nexport const reasoningZod = (levels: readonly ReasoningLevel[]) =>\n  z.nativeEnum(ReasoningLevel).refine((level) => levels.includes(level), {\n    message: `reasoning must be one of: ${levels.join(', ')}`,\n  });\n\nexport const credentialsZod = () => credentialPolicySchema;\nexport const instructionsZod = () => z.array(instructionFragmentSchema).default([]);\nexport const skillsZod = () => z.array(skillBundleSchema).default([]);\nexport const secretRefZod = () => z.object({ secretKey: z.string().min(1) });\n\nexport const urlZod = (schemes: readonly string[]) =>\n  z\n    .string()\n    .url()\n    .refine((value) => schemes.some((scheme) => value.startsWith(`${scheme}://`)), {\n      message: `url must use one of: ${schemes.join(', ')}`,\n    });\n\nexport const absolutePathZod = () => z.string().startsWith('/');\n\n// Throws a readable error naming the harness; open() surfaces it as the\n// session's open failure.\nexport const parseHarnessConfig = <T extends z.ZodType>(args: {\n  specifier: string;\n  schema: T;\n  config: JsonValue;\n}): z.output<T> => {\n  const parsed = args.schema.safeParse(args.config);\n  if (parsed.success) return parsed.data;\n  const issues = parsed.error.issues\n    .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)\n    .join('; ');\n  throw new Error(`invalid config for ${args.specifier}: ${issues}`);\n};\n\n// Authoring input and provider-private payloads are typed objects; a JSON\n// round trip drops undefined fields and the schema proves the result is JSON.\nexport const toJsonValue = <Value>(value: Value): JsonValue =>\n  jsonValueSchema.parse(JSON.parse(JSON.stringify(value)));\n\nexport const toJsonObject = <Value>(value: Value): JsonObject =>\n  jsonObjectSchema.parse(JSON.parse(JSON.stringify(value)));\n\nexport type CredentialsInput = CredentialPolicyIface;\n\n// What an authoring helper (`serverlessPi({...})`) returns: the manifest's\n// harness binding.\nexport interface HarnessBindingOutputIface {\n  harness: PackageProviderRefIface;\n  config: object;\n}\n\nexport const harnessBinding = <Config extends object>(\n  specifier: string,\n  config: Config,\n): HarnessBindingOutputIface => ({\n  harness: packageRef(specifier),\n  config: { ...config },\n});\n"],
-  "mappings": "AAAA,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OASK;AACP,YAAY,OAAO;AAEnB,SAAS,2BAAAA,gCAA+B;AAQjC,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,SAAM;AACN,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,SAAM;AANI,SAAAA;AAAA,GAAA;AAUL,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,UAAO;AACP,EAAAA,kBAAA,SAAM;AACN,EAAAA,kBAAA,cAAW;AAHD,SAAAA;AAAA,GAAA;AAOL,IAAK,uBAAL,kBAAKC,0BAAL;AACL,EAAAA,sBAAA,aAAU;AACV,EAAAA,sBAAA,iBAAc;AACd,EAAAA,sBAAA,UAAO;AACP,EAAAA,sBAAA,YAAS;AAGT,EAAAA,sBAAA,UAAO;AAPG,SAAAA;AAAA,GAAA;AAWL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,WAAQ;AAJE,SAAAA;AAAA,GAAA;AASL,IAAK,yBAAL,kBAAKC,4BAAL;AACL,EAAAA,wBAAA,UAAO;AACP,EAAAA,wBAAA,gBAAa;AAFH,SAAAA;AAAA,GAAA;AAML,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,oBAAiB;AACjB,EAAAA,kBAAA,sBAAmB;AAHT,SAAAA;AAAA,GAAA;AAaL,MAAM,mBAAmB,CAAC,UAId;AAAA,EACjB,MAAM;AAAA,EACN,OAAO,KAAK;AAAA,EACZ,sBAAsB;AAAA,EACtB,YAAY,KAAK;AAAA,EACjB,UAAU,KAAK,YAAY,CAAC;AAC9B;AAGO,MAAM,YAAY,CAAC,KAAyB,eAAoC;AAAA,EACrF,MAAM,WAAW;AAAA,EACjB,MAAM;AAAA,EACN,GAAI,OAAO,OACP,EAAE,WAAW,GAAG,WAAW,KAAK,SAAS,wBAAwB,IACjE,EAAE,MAAM,CAAC,GAAG,GAAG,EAAE;AAAA,EACrB,GAAI,aAAa,OAAO,CAAC,IAAI,EAAE,SAAS,UAAU;AACpD;AAEO,MAAM,gBAAgB,CAAC,YAAmD;AAAA,EAC/E,MAAM,WAAW;AAAA,EACjB,MAAM,CAAC,GAAG,MAAM;AAClB;AAEO,MAAM,kBAAkB,OAAmB,EAAE,MAAM,WAAW,iBAAiB;AAE/E,MAAM,qBAAqB,CAAC,OAA0B,gBAAqC;AAChG,QAAM,SAAqB,EAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE;AAC/E,MAAI,eAAe,KAAM,QAAO,UAAU;AAC1C,SAAO;AACT;AAEO,MAAM,mBAAmB,OAAmB,EAAE,MAAM,WAAW,aAAa;AAC5E,MAAM,aAAa,OAAmB,EAAE,MAAM,WAAW,OAAO;AAChE,MAAM,gBAAgB,OAAmB,EAAE,MAAM,WAAW,UAAU;AAEtE,MAAM,UAAU,CAAC,OAAe,aAA4C;AAAA,EACjF,MAAM;AAAA,EACN;AAAA,EACA,QAAQ;AAAA,EACR,SAAS,KAAK,QAAQ,KAAK,GAAG,CAAC;AACjC;AAEO,MAAM,mBAAmB,CAAC,WAA+B;AAAA,EAC9D,MAAM;AAAA,EACN;AAAA,EACA,SAAS;AACX;AAEO,MAAM,WAAW,CAAC,QAA4B;AACnD,MAAI,OAAO;AACT,WAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE,GAAG;AAAA,MACjD,SAAS,yBAAyB,IAAI,KAAK,IAAI,CAAC;AAAA,IAClD,CAAC;AACH,QAAM,UAAU,IAAI,OAAO,uBAAuB;AAClD,SAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,MAAM,SAAS;AAAA,IAC/C,SAAS;AAAA,EACX,CAAC;AACH;AAEO,MAAM,eAAe,CAAC,WAC3B,EAAE,WAAW,cAAc,EAAE,OAAO,CAAC,UAAU,OAAO,SAAS,KAAK,GAAG;AAAA,EACrE,SAAS,6BAA6B,OAAO,KAAK,IAAI,CAAC;AACzD,CAAC;AAEI,MAAM,iBAAiB,MAAM;AAC7B,MAAM,kBAAkB,MAAM,EAAE,MAAM,yBAAyB,EAAE,QAAQ,CAAC,CAAC;AAC3E,MAAM,YAAY,MAAM,EAAE,MAAM,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAC7D,MAAM,eAAe,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;AAEpE,MAAM,SAAS,CAAC,YACrB,EACG,OAAO,EACP,IAAI,EACJ,OAAO,CAAC,UAAU,QAAQ,KAAK,CAAC,WAAW,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,GAAG;AAAA,EAC7E,SAAS,wBAAwB,QAAQ,KAAK,IAAI,CAAC;AACrD,CAAC;AAEE,MAAM,kBAAkB,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG;AAIvD,MAAM,qBAAqB,CAAsB,SAIrC;AACjB,QAAM,SAAS,KAAK,OAAO,UAAU,KAAK,MAAM;AAChD,MAAI,OAAO,QAAS,QAAO,OAAO;AAClC,QAAM,SAAS,OAAO,MAAM,OACzB,IAAI,CAAC,UAAU,GAAG,MAAM,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAK,MAAM,OAAO,EAAE,EACtE,KAAK,IAAI;AACZ,QAAM,IAAI,MAAM,sBAAsB,KAAK,SAAS,KAAK,MAAM,EAAE;AACnE;AAIO,MAAM,cAAc,CAAQ,UACjC,gBAAgB,MAAM,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC,CAAC;AAElD,MAAM,eAAe,CAAQ,UAClC,iBAAiB,MAAM,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC,CAAC;AAWnD,MAAM,iBAAiB,CAC5B,WACA,YAC+B;AAAA,EAC/B,SAAS,WAAW,SAAS;AAAA,EAC7B,QAAQ,EAAE,GAAG,OAAO;AACtB;",
-  "names": ["MODEL_REFERENCE_PATTERN", "ReasoningLevel", "PiPermissionMode", "ClaudePermissionMode", "CodexApprovalPolicy", "CodexApprovalsReviewer", "CodexSandboxMode"]
+  "sourcesContent": ["import {\n  inferenceSchema,\n  jsonObjectSchema,\n  jsonValueSchema,\n  PermissionLevel,\n  SCHEMA_IDS,\n  type HarnessSettingsIface,\n  type InferenceSource,\n  type JsonObject,\n  type JsonSchema,\n  type JsonValue,\n  type HarnessEnvironmentIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { MODEL_REFERENCE_PATTERN } from \"./model-reference.mjs\";\n\nexport { MODEL_REFERENCE_PATTERN } from \"./model-reference.mjs\";\n\n// Configuration building blocks shared by the harness definitions: each\n// writes its configuration's JSON Schema (what a picker renders and the\n// platform validates settings with, $ref-ing the shared final://schemas/*\n// fragments) from these. The Zod helpers are for programs that read a\n// configuration they were handed.\n\n// Mirrors the final://schemas/reasoning fragment's enum.\nexport enum ReasoningLevel {\n  None = 'none',\n  Minimal = 'minimal',\n  Low = 'low',\n  Medium = 'medium',\n  High = 'high',\n  Max = 'max',\n}\n\n// The native modes each program understands. Settings carry a `PermissionLevel`;\n// each harness maps it onto its program's own mode.\n\n// Pi and the Final harness.\nexport enum PiPermissionMode {\n  Auto = 'auto',\n  Ask = 'ask',\n  Readonly = 'readonly',\n}\n\n// Claude Code and the nanocode Claude engine.\nexport enum ClaudePermissionMode {\n  Default = 'default',\n  AcceptEdits = 'accept-edits',\n  Plan = 'plan',\n  Bypass = 'bypass',\n  // The nanocode Claude engine only: a reviewer model answers what `default` would ask.\n  Auto = 'auto',\n}\n\n// Codex and the nanocode Codex engine.\nexport enum CodexApprovalPolicy {\n  Untrusted = 'untrusted',\n  OnRequest = 'on-request',\n  OnFailure = 'on-failure',\n  Never = 'never',\n}\n\n// Who answers what a nanocode engine would ask: the person, or a reviewer model.\nexport enum ApprovalsReviewer {\n  User = 'user',\n  AutoReview = 'auto-review',\n}\n\n// The Codex CLI's OS sandbox on a host you run.\nexport enum CodexSandboxMode {\n  ReadOnly = 'read-only',\n  WorkspaceWrite = 'workspace-write',\n  DangerFullAccess = 'danger-full-access',\n}\n\nexport interface SecretRefIface {\n  secretKey: string;\n}\n\n// A permission level as the caller wrote it, enum or string.\nexport type PermissionInput = PermissionLevel | `${PermissionLevel}`;\n\n// One inference source or an ordered list of them; the first available wins.\nexport type InferenceInput = InferenceSource | readonly InferenceSource[];\n\nexport const piPermissionModeFor = (level: PermissionLevel): PiPermissionMode =>\n  level === PermissionLevel.Auto ? PiPermissionMode.Auto : PiPermissionMode.Ask;\n\nexport const claudePermissionModeFor = (\n  level: PermissionLevel,\n  reviewer: ApprovalsReviewer = ApprovalsReviewer.User,\n): ClaudePermissionMode => {\n  if (level === PermissionLevel.Auto) return ClaudePermissionMode.Bypass;\n  if (reviewer === ApprovalsReviewer.AutoReview) return ClaudePermissionMode.Auto;\n  return level === PermissionLevel.Review\n    ? ClaudePermissionMode.AcceptEdits\n    : ClaudePermissionMode.Default;\n};\n\nexport const codexApprovalPolicyFor = (level: PermissionLevel): CodexApprovalPolicy =>\n  level === PermissionLevel.Auto\n    ? CodexApprovalPolicy.Never\n    : level === PermissionLevel.Review\n      ? CodexApprovalPolicy.OnRequest\n      : CodexApprovalPolicy.Untrusted;\n\nexport const configObjectJson = (args: {\n  title: string;\n  properties: Record<string, JsonSchema>;\n  required?: string[];\n}): JsonSchema => ({\n  type: 'object',\n  title: args.title,\n  additionalProperties: false,\n  properties: args.properties,\n  required: args.required ?? [],\n});\n\n// Open model references; an explicit list restricts them.\nexport const modelJson = (ids?: readonly string[], defaultId?: string): JsonSchema => ({\n  $ref: SCHEMA_IDS.modelPicker,\n  type: 'string',\n  ...(ids == null\n    ? { minLength: 1, maxLength: 200, pattern: MODEL_REFERENCE_PATTERN }\n    : { enum: [...ids] }),\n  ...(defaultId == null ? {} : { default: defaultId }),\n});\n\nexport const reasoningJson = (levels: readonly ReasoningLevel[]): JsonSchema => ({\n  $ref: SCHEMA_IDS.reasoning,\n  enum: [...levels],\n});\n\nexport const inferenceJson = (): JsonSchema => ({ $ref: SCHEMA_IDS.inference });\n\nexport const permissionModeJson = (): JsonSchema => ({\n  $ref: SCHEMA_IDS.permissionMode,\n  enum: Object.values(PermissionLevel),\n});\n\nexport const approvalsReviewerJson = (): JsonSchema => ({\n  type: 'string',\n  title: 'Approvals reviewer',\n  enum: Object.values(ApprovalsReviewer),\n  default: ApprovalsReviewer.User,\n});\n\nexport const secretRefJson = (): JsonSchema => ({ $ref: SCHEMA_IDS.secretRef });\n\nexport const urlJson = (title: string, schemes: readonly string[]): JsonSchema => ({\n  type: 'string',\n  title,\n  format: 'uri',\n  pattern: `^(${schemes.join('|')})://`,\n});\n\nexport const absolutePathJson = (title: string): JsonSchema => ({\n  type: 'string',\n  title,\n  pattern: '^/',\n});\n\nexport const modelZod = (ids?: readonly string[]) => {\n  if (ids != null)\n    return z.string().refine((id) => ids.includes(id), {\n      message: `model must be one of: ${ids.join(', ')}`,\n    });\n  const pattern = new RegExp(MODEL_REFERENCE_PATTERN);\n  return z.string().min(1).max(200).regex(pattern, {\n    message: 'model must be a printable ASCII reference without empty path segments',\n  });\n};\n\nexport const reasoningZod = (levels: readonly ReasoningLevel[]) =>\n  z.nativeEnum(ReasoningLevel).refine((level) => levels.includes(level), {\n    message: `reasoning must be one of: ${levels.join(', ')}`,\n  });\n\nexport const inferenceZod = () => inferenceSchema;\nexport const permissionModeZod = () => z.nativeEnum(PermissionLevel);\nexport const approvalsReviewerZod = () => z.nativeEnum(ApprovalsReviewer);\nexport const secretRefZod = () => z.object({ secretKey: z.string().min(1) });\n\nexport const urlZod = (schemes: readonly string[]) =>\n  z\n    .string()\n    .url()\n    .refine((value) => schemes.some((scheme) => value.startsWith(`${scheme}://`)), {\n      message: `url must use one of: ${schemes.join(', ')}`,\n    });\n\nexport const absolutePathZod = () => z.string().startsWith('/');\n\n// Throws a readable error naming the harness; open() surfaces it as the\n// session's open failure.\nexport const parseHarnessConfig = <T extends z.ZodType>(args: {\n  harness: string;\n  schema: T;\n  config: unknown;\n}): z.output<T> => {\n  const parsed = args.schema.safeParse(args.config);\n  if (parsed.success) return parsed.data;\n  const issues = parsed.error.issues\n    .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)\n    .join('; ');\n  throw new Error(`invalid configuration for ${args.harness}: ${issues}`);\n};\n\n// Typed objects to JSON: a round trip drops undefined fields and the schema\n// proves the result is JSON.\nexport const toJsonValue = <Value>(value: Value): JsonValue =>\n  jsonValueSchema.parse(JSON.parse(JSON.stringify(value)));\n\nexport const toJsonObject = <Value>(value: Value): JsonObject =>\n  jsonObjectSchema.parse(JSON.parse(JSON.stringify(value)));\n\nconst inferenceList = (inference: InferenceInput | undefined): InferenceSource[] | undefined => {\n  if (inference == null) return undefined;\n  const list = Array.isArray(inference) ? [...inference] : [inference];\n  if (list.length === 0) throw new Error('inference lists at least one source');\n  return list;\n};\n\n// What every settings builder returns: plain harness settings, the wire form\n// a caller passes as `provide.harness`. A single inference source becomes a\n// one-item list, as it is stored.\nexport const harnessSettings = (args: {\n  harness: string;\n  adapter?: string;\n  configuration: { inference?: InferenceInput } & Record<string, unknown>;\n  environment?: HarnessEnvironmentIface;\n}): HarnessSettingsIface => {\n  const { inference, ...rest } = args.configuration;\n  const list = inferenceList(inference);\n  const environment = args.environment;\n  return {\n    harness: args.harness,\n    ...(args.adapter == null ? {} : { adapter: args.adapter }),\n    configuration: toJsonObject({ ...rest, ...(list == null ? {} : { inference: list }) }),\n    ...(environment == null\n      ? {}\n      : { environment: typeof environment === 'string' ? environment : { ...environment } }),\n  };\n};\n"],
+  "mappings": "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",
+  "names": ["MODEL_REFERENCE_PATTERN", "ReasoningLevel", "PiPermissionMode", "ClaudePermissionMode", "CodexApprovalPolicy", "ApprovalsReviewer", "CodexSandboxMode"]
 }

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

@@ -0,0 +1,3 @@
+import type { HarnessDefinitionIface } from '@finalai/agent-provider';
+import { FinalHarness } from "./names.mjs";
+export declare const FINAL_HARNESS_DEFINITIONS: Record<FinalHarness, HarnessDefinitionIface>;

package/dist/modules/harnesses/definitions.mjs

@@ -0,0 +1,21 @@
+import { ACP_AGENT_HARNESS } from "./acp-agent.mjs";
+import { CLAUDE_CODE_HARNESS } from "./claude-code.mjs";
+import { CODEX_HARNESS } from "./codex.mjs";
+import { FINAL_HARNESS } from "./final.mjs";
+import { FinalHarness } from "./names.mjs";
+import { NANOCODE_CLAUDE_HARNESS } from "./nanocode-claude.mjs";
+import { NANOCODE_CODEX_HARNESS } from "./nanocode-codex.mjs";
+import { PI_HARNESS } from "./pi.mjs";
+const FINAL_HARNESS_DEFINITIONS = {
+  [FinalHarness.Final]: FINAL_HARNESS,
+  [FinalHarness.Pi]: PI_HARNESS,
+  [FinalHarness.NanocodeClaude]: NANOCODE_CLAUDE_HARNESS,
+  [FinalHarness.NanocodeCodex]: NANOCODE_CODEX_HARNESS,
+  [FinalHarness.ClaudeCode]: CLAUDE_CODE_HARNESS,
+  [FinalHarness.Codex]: CODEX_HARNESS,
+  [FinalHarness.AcpAgent]: ACP_AGENT_HARNESS
+};
+export {
+  FINAL_HARNESS_DEFINITIONS
+};
+//# sourceMappingURL=definitions.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/harnesses/definitions.ts"],
+  "sourcesContent": ["import type { HarnessDefinitionIface } from '@finalai/agent-provider';\nimport { ACP_AGENT_HARNESS } from \"./acp-agent.mjs\";\nimport { CLAUDE_CODE_HARNESS } from \"./claude-code.mjs\";\nimport { CODEX_HARNESS } from \"./codex.mjs\";\nimport { FINAL_HARNESS } from \"./final.mjs\";\nimport { FinalHarness } from \"./names.mjs\";\nimport { NANOCODE_CLAUDE_HARNESS } from \"./nanocode-claude.mjs\";\nimport { NANOCODE_CODEX_HARNESS } from \"./nanocode-codex.mjs\";\nimport { PI_HARNESS } from \"./pi.mjs\";\n\n// Every Final harness definition by the qualified name harness settings give it.\nexport const FINAL_HARNESS_DEFINITIONS: Record<FinalHarness, HarnessDefinitionIface> = {\n  [FinalHarness.Final]: FINAL_HARNESS,\n  [FinalHarness.Pi]: PI_HARNESS,\n  [FinalHarness.NanocodeClaude]: NANOCODE_CLAUDE_HARNESS,\n  [FinalHarness.NanocodeCodex]: NANOCODE_CODEX_HARNESS,\n  [FinalHarness.ClaudeCode]: CLAUDE_CODE_HARNESS,\n  [FinalHarness.Codex]: CODEX_HARNESS,\n  [FinalHarness.AcpAgent]: ACP_AGENT_HARNESS,\n};\n"],
+  "mappings": "AACA,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AACvC,SAAS,kBAAkB;AAGpB,MAAM,4BAA0E;AAAA,EACrF,CAAC,aAAa,KAAK,GAAG;AAAA,EACtB,CAAC,aAAa,EAAE,GAAG;AAAA,EACnB,CAAC,aAAa,cAAc,GAAG;AAAA,EAC/B,CAAC,aAAa,aAAa,GAAG;AAAA,EAC9B,CAAC,aAAa,UAAU,GAAG;AAAA,EAC3B,CAAC,aAAa,KAAK,GAAG;AAAA,EACtB,CAAC,aAAa,QAAQ,GAAG;AAC3B;",
+  "names": []
+}

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

@@ -38,7 +38,7 @@ export declare const NANOCODE_HARNESS_OF: {
     codex: string;
     claude: string;
 };
-export declare const REMOTE_HARNESS_OF: {
+export declare const PROCESS_HARNESS_OF: {
     codex: string;
     claude: string;
 };