@finalai/agent-provider 0.1.0

package/dist/modules/sandbox/workspace-root.mjs

@@ -0,0 +1,79 @@
+import { createConfinedFileReader } from "./confined-files.mjs";
+import { normalizePosixPath, relativeTo } from "./paths.mjs";
+const WINDOWS_ROOT = /^(?:[A-Za-z]:[\\/]|[\\/]{2})/;
+const segmentsOf = (path) => path.split("/").filter((segment) => segment !== "" && segment !== ".");
+const namesSessionRoot = (sessionRoot, path) => {
+  const base = segmentsOf(sessionRoot);
+  const written = segmentsOf(path);
+  return base.every((segment, index) => written[index] === segment);
+};
+const escapeError = (path) => new Error(`${path} climbs out of the sandbox workspace root`);
+const joinUnder = (root, segments, separator) => {
+  if (segments.length === 0) return root;
+  const trimmed = separator === "\\" ? root.replace(/[\\/]+$/, "") : root.replace(/\/+$/, "");
+  return `${trimmed}${separator}${segments.join(separator)}`;
+};
+const mapSessionPath = (args) => {
+  const { path } = args;
+  if (!path.startsWith("/")) return path;
+  const windows = WINDOWS_ROOT.test(args.workspaceRoot);
+  if (!windows) {
+    const root = normalizePosixPath(args.workspaceRoot);
+    if (root === normalizePosixPath(args.sessionRoot) || relativeTo(root, path) != null)
+      return path;
+  }
+  const written = windows ? path.replaceAll("\\", "/") : path;
+  const remainder = relativeTo(args.sessionRoot, written);
+  if (remainder == null) {
+    if (namesSessionRoot(args.sessionRoot, written)) throw escapeError(path);
+    return path;
+  }
+  const segments = segmentsOf(remainder);
+  return windows ? joinUnder(args.workspaceRoot, segments, "\\") : joinUnder(normalizePosixPath(args.workspaceRoot), segments, "/");
+};
+const withSessionWorkspaceRoot = (sandbox, sessionRoot) => {
+  const map = (path) => mapSessionPath({ sessionRoot, workspaceRoot: sandbox.defaultWorkingDirectory, path });
+  const mapPath = (options) => ({
+    ...options,
+    path: map(options.path)
+  });
+  const mapConfined = (options) => ({
+    ...options,
+    path: map(options.path),
+    root: map(options.root)
+  });
+  const mapScoped = (options) => {
+    const mapped = mapPath(options);
+    return options.root == null ? mapped : { ...mapped, root: map(options.root) };
+  };
+  const mapProcess = (options) => ({
+    ...options,
+    cwd: map(options.cwd ?? sandbox.defaultWorkingDirectory)
+  });
+  const confined = sandbox.confinedFileReader ?? createConfinedFileReader(sandbox);
+  return {
+    ...sandbox,
+    confinedFileReader: {
+      readFile: async (options) => confined.readFile(mapConfined(options)),
+      stat: async (options) => confined.stat(mapConfined(options)),
+      readDir: async (options) => confined.readDir(mapConfined(options))
+    },
+    resolvePath: (path) => sandbox.resolvePath(map(path)),
+    readFile: async (options) => sandbox.readFile(mapScoped(options)),
+    readBinaryFile: async (options) => sandbox.readBinaryFile(mapPath(options)),
+    readTextFile: async (options) => sandbox.readTextFile(mapPath(options)),
+    writeFile: async (options) => sandbox.writeFile(mapPath(options)),
+    writeBinaryFile: async (options) => sandbox.writeBinaryFile(mapPath(options)),
+    writeTextFile: async (options) => sandbox.writeTextFile(mapPath(options)),
+    spawn: async (options) => sandbox.spawn(mapProcess(options)),
+    run: async (options) => sandbox.run(mapProcess(options)),
+    stat: async (options) => sandbox.stat(mapScoped(options)),
+    readDir: async (options) => sandbox.readDir(mapScoped(options)),
+    removePath: async (options) => sandbox.removePath(mapPath(options))
+  };
+};
+export {
+  mapSessionPath,
+  withSessionWorkspaceRoot
+};
+//# sourceMappingURL=workspace-root.mjs.map

package/dist/modules/sandbox/workspace-root.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/sandbox/workspace-root.ts"],
+  "sourcesContent": ["import { createConfinedFileReader } from \"./confined-files.mjs\";\nimport { normalizePosixPath, relativeTo } from \"./paths.mjs\";\nimport type {\n  ConfinedSandboxFilesIface,\n  NetworkSandboxSessionIface,\n  SandboxProcessOptionsIface,\n} from \"./types.mjs\";\n\n// A session addresses every sandbox under one POSIX root (the session service\n// gives each ACP session `/workspaces`), while each sandbox reports its own\n// working root as `defaultWorkingDirectory`: `/workspaces` on a computer, a real\n// folder on a Device, the provider's work directory elsewhere. A path at or\n// under the session root lands on the sandbox's root, in the sandbox's own path\n// flavour; every other path passes through as it is. Results keep the sandbox's\n// real paths.\n\n// Drive (`C:\\`, `c:/`) and UNC roots: a Windows Device.\nconst WINDOWS_ROOT = /^(?:[A-Za-z]:[\\\\/]|[\\\\/]{2})/;\n\nconst segmentsOf = (path: string): string[] =>\n  path.split('/').filter((segment) => segment !== '' && segment !== '.');\n\n// Whether the path, as written, starts with the session root's segments.\nconst namesSessionRoot = (sessionRoot: string, path: string): boolean => {\n  const base = segmentsOf(sessionRoot);\n  const written = segmentsOf(path);\n  return base.every((segment, index) => written[index] === segment);\n};\n\nconst escapeError = (path: string): Error =>\n  new Error(`${path} climbs out of the sandbox workspace root`);\n\nconst joinUnder = (root: string, segments: readonly string[], separator: string): string => {\n  if (segments.length === 0) return root;\n  const trimmed = separator === '\\\\' ? root.replace(/[\\\\/]+$/, '') : root.replace(/\\/+$/, '');\n  return `${trimmed}${separator}${segments.join(separator)}`;\n};\n\nexport interface MapSessionPathArgsIface {\n  // The root the session's harness was given (POSIX, absolute).\n  sessionRoot: string;\n  // The sandbox's own working root (its defaultWorkingDirectory).\n  workspaceRoot: string;\n  path: string;\n}\n\n// `path` as the sandbox should see it. Relative paths and absolute paths outside\n// the session root are unchanged; a path that names the session root and then\n// climbs out of it with `..` is refused.\nexport const mapSessionPath = (args: MapSessionPathArgsIface): string => {\n  const { path } = args;\n  if (!path.startsWith('/')) return path;\n  const windows = WINDOWS_ROOT.test(args.workspaceRoot);\n  if (!windows) {\n    const root = normalizePosixPath(args.workspaceRoot);\n    // The session root is the sandbox's own (a computer), or the path is\n    // already under the sandbox's root: nothing to map.\n    if (root === normalizePosixPath(args.sessionRoot) || relativeTo(root, path) != null)\n      return path;\n  }\n  // Windows reads `\\` as a separator too: split on it before resolving `..`.\n  const written = windows ? path.replaceAll('\\\\', '/') : path;\n  const remainder = relativeTo(args.sessionRoot, written);\n  if (remainder == null) {\n    if (namesSessionRoot(args.sessionRoot, written)) throw escapeError(path);\n    return path;\n  }\n  const segments = segmentsOf(remainder);\n  return windows\n    ? joinUnder(args.workspaceRoot, segments, '\\\\')\n    : joinUnder(normalizePosixPath(args.workspaceRoot), segments, '/');\n};\n\n// The handle with every path and working directory it is given mapped onto its\n// own working root (mapSessionPath). A call without a cwd runs in that root; a\n// refused path rejects the call.\nexport const withSessionWorkspaceRoot = <S extends NetworkSandboxSessionIface>(\n  sandbox: S,\n  sessionRoot: string,\n): S => {\n  const map = (path: string): string =>\n    mapSessionPath({ sessionRoot, workspaceRoot: sandbox.defaultWorkingDirectory, path });\n  const mapPath = <T extends { path: string }>(options: T): T => ({\n    ...options,\n    path: map(options.path),\n  });\n  const mapConfined = <T extends { path: string; root: string }>(options: T): T => ({\n    ...options,\n    path: map(options.path),\n    root: map(options.root),\n  });\n  const mapScoped = <T extends { path: string; root?: string }>(options: T): T => {\n    const mapped = mapPath(options);\n    return options.root == null ? mapped : { ...mapped, root: map(options.root) };\n  };\n  const mapProcess = (options: SandboxProcessOptionsIface): SandboxProcessOptionsIface => ({\n    ...options,\n    cwd: map(options.cwd ?? sandbox.defaultWorkingDirectory),\n  });\n  // The handle RPC falls back to the same reader over the handle when a\n  // provider has none; binding it here maps its paths too.\n  const confined: ConfinedSandboxFilesIface =\n    sandbox.confinedFileReader ?? createConfinedFileReader(sandbox);\n  return {\n    ...sandbox,\n    confinedFileReader: {\n      readFile: async (options) => confined.readFile(mapConfined(options)),\n      stat: async (options) => confined.stat(mapConfined(options)),\n      readDir: async (options) => confined.readDir(mapConfined(options)),\n    },\n    resolvePath: (path) => sandbox.resolvePath(map(path)),\n    readFile: async (options) => sandbox.readFile(mapScoped(options)),\n    readBinaryFile: async (options) => sandbox.readBinaryFile(mapPath(options)),\n    readTextFile: async (options) => sandbox.readTextFile(mapPath(options)),\n    writeFile: async (options) => sandbox.writeFile(mapPath(options)),\n    writeBinaryFile: async (options) => sandbox.writeBinaryFile(mapPath(options)),\n    writeTextFile: async (options) => sandbox.writeTextFile(mapPath(options)),\n    spawn: async (options) => sandbox.spawn(mapProcess(options)),\n    run: async (options) => sandbox.run(mapProcess(options)),\n    stat: async (options) => sandbox.stat(mapScoped(options)),\n    readDir: async (options) => sandbox.readDir(mapScoped(options)),\n    removePath: async (options) => sandbox.removePath(mapPath(options)),\n  };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/schemas.d.mts

@@ -0,0 +1,121 @@
+import type { JsonSchema } from "./json.mjs";
+export declare const SCHEMA_IDS: {
+    readonly modelPicker: "final://schemas/model-picker";
+    readonly credentialPolicy: "final://schemas/credential-policy";
+    readonly permissionMode: "final://schemas/permission-mode";
+    readonly instructions: "final://schemas/instructions";
+    readonly skills: "final://schemas/skills";
+    readonly reasoning: "final://schemas/reasoning";
+    readonly secretRef: "final://schemas/secret-ref";
+};
+export declare const SHARED_SCHEMAS: {
+    "final://schemas/model-picker": {
+        $id: "final://schemas/model-picker";
+        title: string;
+        type: string;
+        'x-final-widget': string;
+    };
+    "final://schemas/reasoning": {
+        $id: "final://schemas/reasoning";
+        title: string;
+        enum: string[];
+        'x-final-widget': string;
+    };
+    "final://schemas/credential-policy": {
+        $id: "final://schemas/credential-policy";
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            payer: {
+                enum: string[];
+            };
+            tryInOrder: {
+                type: string;
+                minItems: number;
+                items: import("./json.mjs").JsonObject;
+            };
+        };
+        'x-final-widget': string;
+    };
+    "final://schemas/permission-mode": {
+        $id: "final://schemas/permission-mode";
+        title: string;
+        type: string;
+        'x-final-widget': string;
+    };
+    "final://schemas/instructions": {
+        $id: "final://schemas/instructions";
+        title: string;
+        type: string;
+        items: {
+            anyOf: (import("./json.mjs").JsonObject | {
+                type: string;
+                required: string[];
+                properties: {
+                    role: {
+                        enum: string[];
+                    };
+                    content: {
+                        type: string;
+                    };
+                    source: {
+                        type: string;
+                    };
+                };
+            })[];
+        };
+        'x-final-widget': string;
+    };
+    "final://schemas/skills": {
+        $id: "final://schemas/skills";
+        title: string;
+        type: string;
+        items: {
+            anyOf: (import("./json.mjs").JsonObject | {
+                type: string;
+                required: string[];
+                properties: {
+                    key: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    files: {
+                        type: string;
+                        items: {
+                            type: string;
+                            required: string[];
+                            properties: {
+                                path: {
+                                    type: string;
+                                };
+                                content: {
+                                    type: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            })[];
+        };
+        'x-final-widget': string;
+    };
+    "final://schemas/secret-ref": {
+        $id: "final://schemas/secret-ref";
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            secretKey: {
+                type: string;
+            };
+        };
+        'x-final-widget': string;
+    };
+};
+export interface SharedSchemaReferencesIface {
+    [field: string]: string;
+}
+export declare const referencedSharedSchemas: (configSchema: JsonSchema) => SharedSchemaReferencesIface;

package/dist/modules/schemas.mjs

@@ -0,0 +1,146 @@
+import * as z from "zod";
+const SCHEMA_IDS = {
+  modelPicker: "final://schemas/model-picker",
+  credentialPolicy: "final://schemas/credential-policy",
+  permissionMode: "final://schemas/permission-mode",
+  instructions: "final://schemas/instructions",
+  skills: "final://schemas/skills",
+  reasoning: "final://schemas/reasoning",
+  secretRef: "final://schemas/secret-ref"
+};
+const dynamicSlotJsonSchema = {
+  type: "object",
+  required: ["$dynamic"],
+  properties: {
+    $dynamic: {
+      type: "object",
+      required: ["resolver", "events"],
+      properties: {
+        resolver: { type: "string" },
+        events: { type: "array", items: { enum: ["session.started", "turn.started"] } },
+        description: { type: "string" },
+        preview: { type: "string" }
+      }
+    }
+  }
+};
+const credentialNodeJsonSchema = {
+  type: "object",
+  required: ["kind"],
+  properties: {
+    kind: { enum: ["subscription", "api-key", "platform", "harness-owned", "custom"] },
+    owner: { enum: ["payer", "organization"] },
+    vendor: { type: "string" },
+    pin: { type: "string" },
+    secret: { type: "string" },
+    baseUrl: { type: "string", format: "uri" },
+    budget: { type: "string" },
+    resolver: { type: "string" }
+  }
+};
+const SHARED_SCHEMAS = {
+  [SCHEMA_IDS.modelPicker]: {
+    $id: SCHEMA_IDS.modelPicker,
+    title: "Model",
+    // The harness supplies the enum: { $ref: model-picker, enum: [...] }.
+    type: "string",
+    "x-final-widget": "model-picker"
+  },
+  [SCHEMA_IDS.reasoning]: {
+    $id: SCHEMA_IDS.reasoning,
+    title: "Reasoning",
+    enum: ["none", "minimal", "low", "medium", "high", "max"],
+    "x-final-widget": "reasoning-picker"
+  },
+  [SCHEMA_IDS.credentialPolicy]: {
+    $id: SCHEMA_IDS.credentialPolicy,
+    title: "Credentials",
+    type: "object",
+    required: ["payer", "tryInOrder"],
+    properties: {
+      payer: { enum: ["agent-owner", "organization", "prompting-user", "conversation-owner"] },
+      tryInOrder: { type: "array", minItems: 1, items: credentialNodeJsonSchema }
+    },
+    "x-final-widget": "credential-policy"
+  },
+  [SCHEMA_IDS.permissionMode]: {
+    $id: SCHEMA_IDS.permissionMode,
+    title: "Permission mode",
+    // The harness supplies the enum of its own modes.
+    type: "string",
+    "x-final-widget": "permission-mode"
+  },
+  [SCHEMA_IDS.instructions]: {
+    $id: SCHEMA_IDS.instructions,
+    title: "Instructions",
+    type: "array",
+    items: {
+      anyOf: [
+        {
+          type: "object",
+          required: ["role", "content"],
+          properties: {
+            role: { enum: ["system", "user"] },
+            content: { type: "string" },
+            source: { type: "string" }
+          }
+        },
+        dynamicSlotJsonSchema
+      ]
+    },
+    "x-final-widget": "instructions"
+  },
+  [SCHEMA_IDS.skills]: {
+    $id: SCHEMA_IDS.skills,
+    title: "Skills",
+    type: "array",
+    items: {
+      anyOf: [
+        {
+          type: "object",
+          required: ["key", "files"],
+          properties: {
+            key: { type: "string" },
+            description: { type: "string" },
+            files: {
+              type: "array",
+              items: {
+                type: "object",
+                required: ["path", "content"],
+                properties: { path: { type: "string" }, content: { type: "string" } }
+              }
+            }
+          }
+        },
+        dynamicSlotJsonSchema
+      ]
+    },
+    "x-final-widget": "skills"
+  },
+  [SCHEMA_IDS.secretRef]: {
+    $id: SCHEMA_IDS.secretRef,
+    title: "Secret",
+    type: "object",
+    required: ["secretKey"],
+    properties: { secretKey: { type: "string" } },
+    "x-final-widget": "secret-picker"
+  }
+};
+const fieldRefSchema = z.object({ $ref: z.string().startsWith("final://schemas/") });
+const propertiesSchema = z.object({ properties: z.record(z.string(), z.json()) });
+const referencedSharedSchemas = (configSchema) => {
+  const parsed = propertiesSchema.safeParse(configSchema);
+  const out = {};
+  if (!parsed.success) return out;
+  for (const [field, fieldSchema] of Object.entries(parsed.data.properties)) {
+    const ref = fieldRefSchema.safeParse(fieldSchema);
+    if (ref.success) out[field] = ref.data.$ref;
+  }
+  return out;
+};
+export {
+  SCHEMA_IDS,
+  SHARED_SCHEMAS,
+  referencedSharedSchemas
+};
+//# sourceMappingURL=schemas.mjs.map

package/dist/modules/schemas.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/schemas.ts"],
+  "sourcesContent": ["import * as z from 'zod';\nimport type { JsonSchema } from \"./json.mjs\";\n\n// Shared JSON Schema fragments harness config schemas may $ref so Build renders\n// the familiar pickers. A harness with none of these\n// fields leaves them out.\n\nexport const SCHEMA_IDS = {\n  modelPicker: 'final://schemas/model-picker',\n  credentialPolicy: 'final://schemas/credential-policy',\n  permissionMode: 'final://schemas/permission-mode',\n  instructions: 'final://schemas/instructions',\n  skills: 'final://schemas/skills',\n  reasoning: 'final://schemas/reasoning',\n  secretRef: 'final://schemas/secret-ref',\n} as const;\n\nconst dynamicSlotJsonSchema: JsonSchema = {\n  type: 'object',\n  required: ['$dynamic'],\n  properties: {\n    $dynamic: {\n      type: 'object',\n      required: ['resolver', 'events'],\n      properties: {\n        resolver: { type: 'string' },\n        events: { type: 'array', items: { enum: ['session.started', 'turn.started'] } },\n        description: { type: 'string' },\n        preview: { type: 'string' },\n      },\n    },\n  },\n};\n\nconst credentialNodeJsonSchema: JsonSchema = {\n  type: 'object',\n  required: ['kind'],\n  properties: {\n    kind: { enum: ['subscription', 'api-key', 'platform', 'harness-owned', 'custom'] },\n    owner: { enum: ['payer', 'organization'] },\n    vendor: { type: 'string' },\n    pin: { type: 'string' },\n    secret: { type: 'string' },\n    baseUrl: { type: 'string', format: 'uri' },\n    budget: { type: 'string' },\n    resolver: { type: 'string' },\n  },\n};\n\nexport const SHARED_SCHEMAS = {\n  [SCHEMA_IDS.modelPicker]: {\n    $id: SCHEMA_IDS.modelPicker,\n    title: 'Model',\n    // The harness supplies the enum: { $ref: model-picker, enum: [...] }.\n    type: 'string',\n    'x-final-widget': 'model-picker',\n  },\n  [SCHEMA_IDS.reasoning]: {\n    $id: SCHEMA_IDS.reasoning,\n    title: 'Reasoning',\n    enum: ['none', 'minimal', 'low', 'medium', 'high', 'max'],\n    'x-final-widget': 'reasoning-picker',\n  },\n  [SCHEMA_IDS.credentialPolicy]: {\n    $id: SCHEMA_IDS.credentialPolicy,\n    title: 'Credentials',\n    type: 'object',\n    required: ['payer', 'tryInOrder'],\n    properties: {\n      payer: { enum: ['agent-owner', 'organization', 'prompting-user', 'conversation-owner'] },\n      tryInOrder: { type: 'array', minItems: 1, items: credentialNodeJsonSchema },\n    },\n    'x-final-widget': 'credential-policy',\n  },\n  [SCHEMA_IDS.permissionMode]: {\n    $id: SCHEMA_IDS.permissionMode,\n    title: 'Permission mode',\n    // The harness supplies the enum of its own modes.\n    type: 'string',\n    'x-final-widget': 'permission-mode',\n  },\n  [SCHEMA_IDS.instructions]: {\n    $id: SCHEMA_IDS.instructions,\n    title: 'Instructions',\n    type: 'array',\n    items: {\n      anyOf: [\n        {\n          type: 'object',\n          required: ['role', 'content'],\n          properties: {\n            role: { enum: ['system', 'user'] },\n            content: { type: 'string' },\n            source: { type: 'string' },\n          },\n        },\n        dynamicSlotJsonSchema,\n      ],\n    },\n    'x-final-widget': 'instructions',\n  },\n  [SCHEMA_IDS.skills]: {\n    $id: SCHEMA_IDS.skills,\n    title: 'Skills',\n    type: 'array',\n    items: {\n      anyOf: [\n        {\n          type: 'object',\n          required: ['key', 'files'],\n          properties: {\n            key: { type: 'string' },\n            description: { type: 'string' },\n            files: {\n              type: 'array',\n              items: {\n                type: 'object',\n                required: ['path', 'content'],\n                properties: { path: { type: 'string' }, content: { type: 'string' } },\n              },\n            },\n          },\n        },\n        dynamicSlotJsonSchema,\n      ],\n    },\n    'x-final-widget': 'skills',\n  },\n  [SCHEMA_IDS.secretRef]: {\n    $id: SCHEMA_IDS.secretRef,\n    title: 'Secret',\n    type: 'object',\n    required: ['secretKey'],\n    properties: { secretKey: { type: 'string' } },\n    'x-final-widget': 'secret-picker',\n  },\n} satisfies Record<string, JsonSchema>;\n\n// Which shared fragments a config schema references at its top level, e.g.\n// to decide whether the directory's instructions/skills apply to a harness.\nconst fieldRefSchema = z.object({ $ref: z.string().startsWith('final://schemas/') });\nconst propertiesSchema = z.object({ properties: z.record(z.string(), z.json()) });\n\nexport interface SharedSchemaReferencesIface {\n  [field: string]: string;\n}\n\nexport const referencedSharedSchemas = (configSchema: JsonSchema): SharedSchemaReferencesIface => {\n  const parsed = propertiesSchema.safeParse(configSchema);\n  const out: SharedSchemaReferencesIface = {};\n  if (!parsed.success) return out;\n  for (const [field, fieldSchema] of Object.entries(parsed.data.properties)) {\n    const ref = fieldRefSchema.safeParse(fieldSchema);\n    if (ref.success) out[field] = ref.data.$ref;\n  }\n  return out;\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/semantic-events.d.mts

@@ -0,0 +1,31 @@
+import * as z from 'zod';
+import { type JsonObject } from "./json.mjs";
+export declare enum SemanticChannelEventKind {
+    MessageDelta = "message.delta",
+    MessageCompleted = "message.completed",
+    TurnStarted = "turn.started",
+    TurnCompleted = "turn.completed"
+}
+export declare const channelMessageCompletedSchema: z.ZodObject<{
+    message: z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodArray<z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>>;
+    }, z.core.$strip>;
+    finishReason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ChannelMessageCompletedDataIface = z.infer<typeof channelMessageCompletedSchema>;
+export interface ChannelMessageDeltaDataIface {
+    messageId: string;
+    delta: JsonObject;
+}
+export declare const channelTurnEventSchema: z.ZodObject<{
+    turnId: z.ZodString;
+    stopReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ChannelTurnEventDataIface = z.infer<typeof channelTurnEventSchema>;
+export interface ChannelSemanticDataByKindIface {
+    'message.delta': ChannelMessageDeltaDataIface;
+    'message.completed': ChannelMessageCompletedDataIface;
+    'turn.started': ChannelTurnEventDataIface;
+    'turn.completed': ChannelTurnEventDataIface;
+}

package/dist/modules/semantic-events.mjs

@@ -0,0 +1,23 @@
+import * as z from "zod";
+import { jsonObjectSchema } from "./json.mjs";
+var SemanticChannelEventKind = /* @__PURE__ */ ((SemanticChannelEventKind2) => {
+  SemanticChannelEventKind2["MessageDelta"] = "message.delta";
+  SemanticChannelEventKind2["MessageCompleted"] = "message.completed";
+  SemanticChannelEventKind2["TurnStarted"] = "turn.started";
+  SemanticChannelEventKind2["TurnCompleted"] = "turn.completed";
+  return SemanticChannelEventKind2;
+})(SemanticChannelEventKind || {});
+const channelMessageCompletedSchema = z.object({
+  message: z.object({ id: z.string(), content: z.array(jsonObjectSchema) }),
+  finishReason: z.string().nullable()
+});
+const channelTurnEventSchema = z.object({
+  turnId: z.string(),
+  stopReason: z.string().nullable().optional()
+});
+export {
+  SemanticChannelEventKind,
+  channelMessageCompletedSchema,
+  channelTurnEventSchema
+};
+//# sourceMappingURL=semantic-events.mjs.map

package/dist/modules/semantic-events.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/semantic-events.ts"],
+  "sourcesContent": ["import * as z from 'zod';\nimport { jsonObjectSchema, type JsonObject } from \"./json.mjs\";\n\nexport enum SemanticChannelEventKind {\n  MessageDelta = 'message.delta',\n  MessageCompleted = 'message.completed',\n  TurnStarted = 'turn.started',\n  TurnCompleted = 'turn.completed',\n}\n\nexport const channelMessageCompletedSchema = z.object({\n  message: z.object({ id: z.string(), content: z.array(jsonObjectSchema) }),\n  finishReason: z.string().nullable(),\n});\nexport type ChannelMessageCompletedDataIface = z.infer<typeof channelMessageCompletedSchema>;\nexport interface ChannelMessageDeltaDataIface {\n  messageId: string;\n  delta: JsonObject;\n}\nexport const channelTurnEventSchema = z.object({\n  turnId: z.string(),\n  stopReason: z.string().nullable().optional(),\n});\nexport type ChannelTurnEventDataIface = z.infer<typeof channelTurnEventSchema>;\nexport interface ChannelSemanticDataByKindIface {\n  'message.delta': ChannelMessageDeltaDataIface;\n  'message.completed': ChannelMessageCompletedDataIface;\n  'turn.started': ChannelTurnEventDataIface;\n  'turn.completed': ChannelTurnEventDataIface;\n}\n"],
+  "mappings": "AAAA,YAAY,OAAO;AACnB,SAAS,wBAAyC;AAE3C,IAAK,2BAAL,kBAAKA,8BAAL;AACL,EAAAA,0BAAA,kBAAe;AACf,EAAAA,0BAAA,sBAAmB;AACnB,EAAAA,0BAAA,iBAAc;AACd,EAAAA,0BAAA,mBAAgB;AAJN,SAAAA;AAAA,GAAA;AAOL,MAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,gBAAgB,EAAE,CAAC;AAAA,EACxE,cAAc,EAAE,OAAO,EAAE,SAAS;AACpC,CAAC;AAMM,MAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,QAAQ,EAAE,OAAO;AAAA,EACjB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAC7C,CAAC;",
+  "names": ["SemanticChannelEventKind"]
+}

package/package.json

@@ -0,0 +1,199 @@
+{
+  "name": "@finalai/agent-provider",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Provider contracts for the agent stack: harnesses, sandboxes (handle, wire, MCP projection), channels, credential policies, and the conformance kit.",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/modules/index.d.mts",
+      "import": "./dist/modules/index.mjs",
+      "default": "./dist/modules/index.mjs"
+    },
+    "./harness": {
+      "types": "./dist/modules/harness.d.mts",
+      "import": "./dist/modules/harness.mjs",
+      "default": "./dist/modules/harness.mjs"
+    },
+    "./credential-routes": {
+      "types": "./dist/modules/credential-routes.d.mts",
+      "import": "./dist/modules/credential-routes.mjs",
+      "default": "./dist/modules/credential-routes.mjs"
+    },
+    "./channel": {
+      "types": "./dist/modules/channel.d.mts",
+      "import": "./dist/modules/channel.mjs",
+      "default": "./dist/modules/channel.mjs"
+    },
+    "./credentials": {
+      "types": "./dist/modules/credentials.d.mts",
+      "import": "./dist/modules/credentials.mjs",
+      "default": "./dist/modules/credentials.mjs"
+    },
+    "./schemas": {
+      "types": "./dist/modules/schemas.d.mts",
+      "import": "./dist/modules/schemas.mjs",
+      "default": "./dist/modules/schemas.mjs"
+    },
+    "./sandbox": {
+      "types": "./dist/modules/sandbox/index.d.mts",
+      "import": "./dist/modules/sandbox/index.mjs",
+      "default": "./dist/modules/sandbox/index.mjs"
+    },
+    "./sandbox/wire": {
+      "types": "./dist/modules/sandbox/wire.d.mts",
+      "import": "./dist/modules/sandbox/wire.mjs",
+      "default": "./dist/modules/sandbox/wire.mjs"
+    },
+    "./sandbox/client": {
+      "types": "./dist/modules/sandbox/client.d.mts",
+      "import": "./dist/modules/sandbox/client.mjs",
+      "default": "./dist/modules/sandbox/client.mjs"
+    },
+    "./sandbox/server": {
+      "types": "./dist/modules/sandbox/server.d.mts",
+      "import": "./dist/modules/sandbox/server.mjs",
+      "default": "./dist/modules/sandbox/server.mjs"
+    },
+    "./sandbox/mcp": {
+      "types": "./dist/modules/sandbox/mcp.d.mts",
+      "import": "./dist/modules/sandbox/mcp.mjs",
+      "default": "./dist/modules/sandbox/mcp.mjs"
+    },
+    "./sandbox/bytes": {
+      "types": "./dist/modules/sandbox/bytes.d.mts",
+      "import": "./dist/modules/sandbox/bytes.mjs",
+      "default": "./dist/modules/sandbox/bytes.mjs"
+    },
+    "./sandbox/convenience": {
+      "types": "./dist/modules/sandbox/convenience.d.mts",
+      "import": "./dist/modules/sandbox/convenience.mjs",
+      "default": "./dist/modules/sandbox/convenience.mjs"
+    },
+    "./sandbox/workspace-root": {
+      "types": "./dist/modules/sandbox/workspace-root.d.mts",
+      "import": "./dist/modules/sandbox/workspace-root.mjs",
+      "default": "./dist/modules/sandbox/workspace-root.mjs"
+    },
+    "./sandbox/open-scope-node": {
+      "types": "./dist/modules/sandbox/open-scope-node.d.mts",
+      "import": "./dist/modules/sandbox/open-scope-node.mjs",
+      "default": "./dist/modules/sandbox/open-scope-node.mjs"
+    },
+    "./conformance": {
+      "types": "./dist/modules/conformance/index.d.mts",
+      "import": "./dist/modules/conformance/index.mjs",
+      "default": "./dist/modules/conformance/index.mjs"
+    },
+    "./conformance/scripted-model": {
+      "types": "./dist/modules/conformance/scripted-model/index.d.mts",
+      "import": "./dist/modules/conformance/scripted-model/index.mjs",
+      "default": "./dist/modules/conformance/scripted-model/index.mjs"
+    },
+    "./json": {
+      "types": "./dist/modules/json.d.mts",
+      "import": "./dist/modules/json.mjs",
+      "default": "./dist/modules/json.mjs"
+    },
+    "./package.json": "./package.json",
+    "./mcp-content": {
+      "types": "./dist/modules/mcp-content.d.mts",
+      "import": "./dist/modules/mcp-content.mjs",
+      "default": "./dist/modules/mcp-content.mjs"
+    },
+    "./provider-ref": {
+      "types": "./dist/modules/provider-ref.d.mts",
+      "import": "./dist/modules/provider-ref.mjs",
+      "default": "./dist/modules/provider-ref.mjs"
+    },
+    "./manifest": {
+      "types": "./dist/modules/manifest.d.mts",
+      "import": "./dist/modules/manifest.mjs",
+      "default": "./dist/modules/manifest.mjs"
+    },
+    "./dynamic": {
+      "types": "./dist/modules/dynamic.d.mts",
+      "import": "./dist/modules/dynamic.mjs",
+      "default": "./dist/modules/dynamic.mjs"
+    },
+    "./semantic-events": {
+      "types": "./dist/modules/semantic-events.d.mts",
+      "import": "./dist/modules/semantic-events.mjs",
+      "default": "./dist/modules/semantic-events.mjs"
+    },
+    "./channel-context": {
+      "types": "./dist/modules/channel-context.d.mts",
+      "import": "./dist/modules/channel-context.mjs",
+      "default": "./dist/modules/channel-context.mjs"
+    },
+    "./sandbox/types": {
+      "types": "./dist/modules/sandbox/types.d.mts",
+      "import": "./dist/modules/sandbox/types.mjs",
+      "default": "./dist/modules/sandbox/types.mjs"
+    },
+    "./sandbox/snapshots": {
+      "types": "./dist/modules/sandbox/snapshots.d.mts",
+      "import": "./dist/modules/sandbox/snapshots.mjs",
+      "default": "./dist/modules/sandbox/snapshots.mjs"
+    },
+    "./sandbox/open-scope": {
+      "types": "./dist/modules/sandbox/open-scope.d.mts",
+      "import": "./dist/modules/sandbox/open-scope.mjs",
+      "default": "./dist/modules/sandbox/open-scope.mjs"
+    },
+    "./sandbox/frame-channel": {
+      "types": "./dist/modules/sandbox/frame-channel.d.mts",
+      "import": "./dist/modules/sandbox/frame-channel.mjs",
+      "default": "./dist/modules/sandbox/frame-channel.mjs"
+    },
+    "./sandbox/rpc-peer": {
+      "types": "./dist/modules/sandbox/rpc-peer.d.mts",
+      "import": "./dist/modules/sandbox/rpc-peer.mjs",
+      "default": "./dist/modules/sandbox/rpc-peer.mjs"
+    },
+    "./sandbox/stream-mux": {
+      "types": "./dist/modules/sandbox/stream-mux.d.mts",
+      "import": "./dist/modules/sandbox/stream-mux.mjs",
+      "default": "./dist/modules/sandbox/stream-mux.mjs"
+    },
+    "./channel-socket": {
+      "types": "./dist/modules/channel-socket.d.mts",
+      "import": "./dist/modules/channel-socket.mjs",
+      "default": "./dist/modules/channel-socket.mjs"
+    },
+    "./local-channel-socket": {
+      "types": "./dist/modules/local-channel-socket.d.mts",
+      "import": "./dist/modules/local-channel-socket.mjs",
+      "default": "./dist/modules/local-channel-socket.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "1.8.0",
+    "@finalai/acp-session": "0.1.0",
+    "@finalai/agent-protocol": "0.1.0",
+    "@modelcontextprotocol/client": "^2.1.0",
+    "@modelcontextprotocol/core": "^2.1.0",
+    "@modelcontextprotocol/server": "^2.1.0",
+    "re2js": "2.8.6",
+    "zod": "4.6.5"
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/final-company/packages-typescript.git",
+    "directory": "packages/@finalai/agent-provider"
+  }
+}