@finalai/agent-provider 0.19.0 → 0.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  import { spawn } from "node:child_process";
2
2
  import { createServer } from "node:http";
3
- import { ndJsonStream } from "@agentclientprotocol/sdk/experimental/v2";
3
+ import { ndJsonStream } from "@agentclientprotocol/sdk/experimental/v2/unstable";
4
4
  import { InferenceSourceKind, PermissionLevel } from "@finalai/agent-protocol/agent-platform";
5
5
  import {
6
6
  AcpTransport,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/conformance/stdio.ts"],
4
- "sourcesContent": ["import { spawn, type ChildProcess } from 'node:child_process';\nimport { createServer, type IncomingMessage, type ServerResponse } from 'node:http';\nimport type { AddressInfo } from 'node:net';\n\nimport { ndJsonStream } from '@agentclientprotocol/sdk/experimental/v2';\nimport { InferenceSourceKind, PermissionLevel } from '@finalai/agent-protocol/agent-platform';\n\nimport {\n AcpTransport,\n CredentialDelivery,\n PromptWhileRunning,\n type HarnessEndpointIface,\n type HarnessIface,\n type HarnessSessionRefIface,\n type McpTransportKind,\n} from \"../harness.mjs\";\nimport { harnessDefinitionSchema } from \"../harness-definition.mjs\";\nimport type { ConformanceStreamIface } from \"./harness-kit.mjs\";\n\n// Node helpers for running the harness kit against an ACP agent that is a command speaking ACP\n// on stdio, such as an ACP adapter (`@finalai/agent-provider/conformance/stdio`). Each dial\n// starts the command afresh, as a process per connection: a resumed session is found again\n// through the agent's own state. Run them with the `final-required` profile, which reads the\n// agent's capabilities from its `initialize` advertisement.\n\nexport interface StdioConformanceHarnessArgsIface {\n command: string;\n args: string[];\n env?: Record<string, string>;\n cwd?: string;\n // MCP transports the agent takes in session/new.\n mcp: McpTransportKind[];\n // What a prompt sent while a turn runs does (default queue).\n promptWhileRunning?: PromptWhileRunning;\n}\n\nexport interface StdioConformanceHarnessIface {\n harness: HarnessIface;\n dial: (endpoint: HarnessEndpointIface) => Promise<ConformanceStreamIface>;\n // The agent processes' stderr, in order (for diagnosing a failed case).\n stderr: () => string;\n}\n\nconst MAX_STDERR_CHARS = 256 * 1024;\n\nexport const stdioConformanceHarness = (\n args: StdioConformanceHarnessArgsIface,\n): StdioConformanceHarnessIface => {\n // The previous process of a harness session exits before the next one starts.\n const exits = new Map<string, Promise<void>>();\n let stderr = '';\n\n // A program speaking ACP v2 on stdio, run as a process.\n const definition = harnessDefinitionSchema.parse({\n configurationSchema: { type: 'object' },\n features: [],\n lowestPermission: PermissionLevel.Ask,\n inference: { kinds: [InferenceSourceKind.Harness], delivery: CredentialDelivery.PerRequest },\n run: { process: { command: args.command, args: args.args } },\n mcp: args.mcp,\n promptWhileRunning: args.promptWhileRunning ?? PromptWhileRunning.Queue,\n });\n\n const endpointFor = (ref: HarnessSessionRefIface): HarnessEndpointIface => ({\n ref,\n transport: AcpTransport.Stdio,\n command: args.command,\n args: args.args,\n env: args.env ?? {},\n });\n\n const harness: HarnessIface = {\n definition,\n open: async () =>\n endpointFor({ harness: 'stdio', harnessSessionRef: crypto.randomUUID(), generation: 0 }),\n resume: async ({ ref }) => endpointFor(ref),\n park: async () => undefined,\n close: async () => undefined,\n health: async () => ({ ok: true, checkedAt: new Date().toISOString() }),\n };\n\n const dial = async (endpoint: HarnessEndpointIface): Promise<ConformanceStreamIface> => {\n if (endpoint.transport !== AcpTransport.Stdio) {\n throw new Error(`the stdio conformance harness cannot dial ${endpoint.transport}`);\n }\n const key = endpoint.ref.harnessSessionRef;\n await exits.get(key);\n const child: ChildProcess = spawn(endpoint.command, endpoint.args, {\n cwd: args.cwd,\n env: endpoint.env,\n stdio: ['pipe', 'pipe', 'pipe'],\n });\n exits.set(\n key,\n new Promise<void>((resolve) => {\n child.once('close', () => resolve());\n child.once('error', () => resolve());\n }),\n );\n child.stderr?.on('data', (chunk: Buffer) => {\n stderr = `${stderr}${chunk.toString('utf8')}`.slice(-MAX_STDERR_CHARS);\n });\n child.stdin?.on('error', () => undefined);\n let open = true;\n const input = new ReadableStream<Uint8Array>({\n start: (controller) => {\n child.stdout?.on('data', (chunk: Buffer) => {\n if (open) controller.enqueue(new Uint8Array(chunk));\n });\n child.stdout?.on('end', () => {\n if (!open) return;\n open = false;\n controller.close();\n });\n child.on('error', (error) => {\n if (!open) return;\n open = false;\n controller.error(error);\n });\n },\n cancel: () => {\n open = false;\n child.stdout?.destroy();\n },\n });\n const output = new WritableStream<Uint8Array>({\n write: (chunk) =>\n new Promise<void>((resolve, reject) => {\n child.stdin?.write(chunk, (error) => (error == null ? resolve() : reject(error)));\n }),\n close: () => {\n child.stdin?.end();\n },\n });\n return { ...ndJsonStream(output, input), close: () => child.kill('SIGTERM') };\n };\n\n return { harness, dial, stderr: () => stderr };\n};\n\nconst headersOf = (request: IncomingMessage): Headers => {\n const headers = new Headers();\n for (const [name, value] of Object.entries(request.headers)) {\n if (Array.isArray(value)) for (const entry of value) headers.append(name, entry);\n else if (value != null) headers.set(name, value);\n }\n return headers;\n};\n\nconst readBody = async (request: IncomingMessage): Promise<Uint8Array<ArrayBuffer>> => {\n const chunks: Buffer[] = [];\n for await (const chunk of request) {\n if (Buffer.isBuffer(chunk)) chunks.push(chunk);\n }\n const joined = Buffer.concat(chunks);\n const body = new Uint8Array(joined.length);\n body.set(joined);\n return body;\n};\n\n// Streams the body (server-sent events included) as it is produced.\nconst writeResponse = async (response: Response, target: ServerResponse) => {\n target.writeHead(response.status, Object.fromEntries(response.headers.entries()));\n target.flushHeaders();\n const reader = response.body?.getReader();\n if (reader != null) {\n target.once('close', () => void reader.cancel().catch(() => undefined));\n while (true) {\n const chunk = await reader.read();\n if (chunk.done) break;\n target.write(chunk.value);\n }\n }\n target.end();\n};\n\n// Serves a fetch handler on a loopback port, for a model or MCP fixture a separate process\n// must reach (the kit's `httpMcp.serve`, the scripted model).\nexport const serveFetchOnLoopback = async (\n handler: (request: Request) => Promise<Response>,\n): Promise<{ url: string; headers: Record<string, string>; close: () => Promise<void> }> => {\n const server = createServer((request, response) => {\n void (async () => {\n const body =\n request.method === 'GET' || request.method === 'HEAD' ? null : await readBody(request);\n const forwarded = new Request(`http://127.0.0.1${request.url ?? '/'}`, {\n method: request.method,\n headers: headersOf(request),\n body: body == null || body.length === 0 ? undefined : body,\n });\n await writeResponse(await handler(forwarded), response);\n })().catch(() => {\n if (!response.headersSent) response.writeHead(500);\n response.end();\n });\n });\n await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve));\n const address = server.address();\n const port =\n address != null && typeof address === 'object' ? (address satisfies AddressInfo).port : 0;\n return {\n url: `http://127.0.0.1:${port}`,\n headers: {},\n close: () =>\n new Promise<void>((resolve) => {\n server.close(() => resolve());\n server.closeAllConnections();\n }),\n };\n};\n"],
4
+ "sourcesContent": ["import { spawn, type ChildProcess } from 'node:child_process';\nimport { createServer, type IncomingMessage, type ServerResponse } from 'node:http';\nimport type { AddressInfo } from 'node:net';\n\nimport { ndJsonStream } from '@agentclientprotocol/sdk/experimental/v2/unstable';\nimport { InferenceSourceKind, PermissionLevel } from '@finalai/agent-protocol/agent-platform';\n\nimport {\n AcpTransport,\n CredentialDelivery,\n PromptWhileRunning,\n type HarnessEndpointIface,\n type HarnessIface,\n type HarnessSessionRefIface,\n type McpTransportKind,\n} from \"../harness.mjs\";\nimport { harnessDefinitionSchema } from \"../harness-definition.mjs\";\nimport type { ConformanceStreamIface } from \"./harness-kit.mjs\";\n\n// Node helpers for running the harness kit against an ACP agent that is a command speaking ACP\n// on stdio, such as an ACP adapter (`@finalai/agent-provider/conformance/stdio`). Each dial\n// starts the command afresh, as a process per connection: a resumed session is found again\n// through the agent's own state. Run them with the `final-required` profile, which reads the\n// agent's capabilities from its `initialize` advertisement.\n\nexport interface StdioConformanceHarnessArgsIface {\n command: string;\n args: string[];\n env?: Record<string, string>;\n cwd?: string;\n // MCP transports the agent takes in session/new.\n mcp: McpTransportKind[];\n // What a prompt sent while a turn runs does (default queue).\n promptWhileRunning?: PromptWhileRunning;\n}\n\nexport interface StdioConformanceHarnessIface {\n harness: HarnessIface;\n dial: (endpoint: HarnessEndpointIface) => Promise<ConformanceStreamIface>;\n // The agent processes' stderr, in order (for diagnosing a failed case).\n stderr: () => string;\n}\n\nconst MAX_STDERR_CHARS = 256 * 1024;\n\nexport const stdioConformanceHarness = (\n args: StdioConformanceHarnessArgsIface,\n): StdioConformanceHarnessIface => {\n // The previous process of a harness session exits before the next one starts.\n const exits = new Map<string, Promise<void>>();\n let stderr = '';\n\n // A program speaking ACP v2 on stdio, run as a process.\n const definition = harnessDefinitionSchema.parse({\n configurationSchema: { type: 'object' },\n features: [],\n lowestPermission: PermissionLevel.Ask,\n inference: { kinds: [InferenceSourceKind.Harness], delivery: CredentialDelivery.PerRequest },\n run: { process: { command: args.command, args: args.args } },\n mcp: args.mcp,\n promptWhileRunning: args.promptWhileRunning ?? PromptWhileRunning.Queue,\n });\n\n const endpointFor = (ref: HarnessSessionRefIface): HarnessEndpointIface => ({\n ref,\n transport: AcpTransport.Stdio,\n command: args.command,\n args: args.args,\n env: args.env ?? {},\n });\n\n const harness: HarnessIface = {\n definition,\n open: async () =>\n endpointFor({ harness: 'stdio', harnessSessionRef: crypto.randomUUID(), generation: 0 }),\n resume: async ({ ref }) => endpointFor(ref),\n park: async () => undefined,\n close: async () => undefined,\n health: async () => ({ ok: true, checkedAt: new Date().toISOString() }),\n };\n\n const dial = async (endpoint: HarnessEndpointIface): Promise<ConformanceStreamIface> => {\n if (endpoint.transport !== AcpTransport.Stdio) {\n throw new Error(`the stdio conformance harness cannot dial ${endpoint.transport}`);\n }\n const key = endpoint.ref.harnessSessionRef;\n await exits.get(key);\n const child: ChildProcess = spawn(endpoint.command, endpoint.args, {\n cwd: args.cwd,\n env: endpoint.env,\n stdio: ['pipe', 'pipe', 'pipe'],\n });\n exits.set(\n key,\n new Promise<void>((resolve) => {\n child.once('close', () => resolve());\n child.once('error', () => resolve());\n }),\n );\n child.stderr?.on('data', (chunk: Buffer) => {\n stderr = `${stderr}${chunk.toString('utf8')}`.slice(-MAX_STDERR_CHARS);\n });\n child.stdin?.on('error', () => undefined);\n let open = true;\n const input = new ReadableStream<Uint8Array>({\n start: (controller) => {\n child.stdout?.on('data', (chunk: Buffer) => {\n if (open) controller.enqueue(new Uint8Array(chunk));\n });\n child.stdout?.on('end', () => {\n if (!open) return;\n open = false;\n controller.close();\n });\n child.on('error', (error) => {\n if (!open) return;\n open = false;\n controller.error(error);\n });\n },\n cancel: () => {\n open = false;\n child.stdout?.destroy();\n },\n });\n const output = new WritableStream<Uint8Array>({\n write: (chunk) =>\n new Promise<void>((resolve, reject) => {\n child.stdin?.write(chunk, (error) => (error == null ? resolve() : reject(error)));\n }),\n close: () => {\n child.stdin?.end();\n },\n });\n return { ...ndJsonStream(output, input), close: () => child.kill('SIGTERM') };\n };\n\n return { harness, dial, stderr: () => stderr };\n};\n\nconst headersOf = (request: IncomingMessage): Headers => {\n const headers = new Headers();\n for (const [name, value] of Object.entries(request.headers)) {\n if (Array.isArray(value)) for (const entry of value) headers.append(name, entry);\n else if (value != null) headers.set(name, value);\n }\n return headers;\n};\n\nconst readBody = async (request: IncomingMessage): Promise<Uint8Array<ArrayBuffer>> => {\n const chunks: Buffer[] = [];\n for await (const chunk of request) {\n if (Buffer.isBuffer(chunk)) chunks.push(chunk);\n }\n const joined = Buffer.concat(chunks);\n const body = new Uint8Array(joined.length);\n body.set(joined);\n return body;\n};\n\n// Streams the body (server-sent events included) as it is produced.\nconst writeResponse = async (response: Response, target: ServerResponse) => {\n target.writeHead(response.status, Object.fromEntries(response.headers.entries()));\n target.flushHeaders();\n const reader = response.body?.getReader();\n if (reader != null) {\n target.once('close', () => void reader.cancel().catch(() => undefined));\n while (true) {\n const chunk = await reader.read();\n if (chunk.done) break;\n target.write(chunk.value);\n }\n }\n target.end();\n};\n\n// Serves a fetch handler on a loopback port, for a model or MCP fixture a separate process\n// must reach (the kit's `httpMcp.serve`, the scripted model).\nexport const serveFetchOnLoopback = async (\n handler: (request: Request) => Promise<Response>,\n): Promise<{ url: string; headers: Record<string, string>; close: () => Promise<void> }> => {\n const server = createServer((request, response) => {\n void (async () => {\n const body =\n request.method === 'GET' || request.method === 'HEAD' ? null : await readBody(request);\n const forwarded = new Request(`http://127.0.0.1${request.url ?? '/'}`, {\n method: request.method,\n headers: headersOf(request),\n body: body == null || body.length === 0 ? undefined : body,\n });\n await writeResponse(await handler(forwarded), response);\n })().catch(() => {\n if (!response.headersSent) response.writeHead(500);\n response.end();\n });\n });\n await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve));\n const address = server.address();\n const port =\n address != null && typeof address === 'object' ? (address satisfies AddressInfo).port : 0;\n return {\n url: `http://127.0.0.1:${port}`,\n headers: {},\n close: () =>\n new Promise<void>((resolve) => {\n server.close(() => resolve());\n server.closeAllConnections();\n }),\n };\n};\n"],
5
5
  "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,4 +1,4 @@
1
- import type { Stream } from '@agentclientprotocol/sdk/experimental/v2';
1
+ import type { Stream } from '@agentclientprotocol/sdk/experimental/v2/unstable';
2
2
  export declare const V1_INITIALIZE_RESULT: {
3
3
  protocolVersion: number;
4
4
  agentCapabilities: {
@@ -15,19 +15,17 @@ const createLegacyProtocolAgent = () => {
15
15
  const toClient = new TransformStream();
16
16
  const writer = toClient.writable.getWriter();
17
17
  const writable = new WritableStream({
18
- write: async (wire) => {
19
- for (const message of Array.isArray(wire) ? wire : [wire]) {
20
- const request = requestSchema.safeParse(message);
21
- if (!request.success) continue;
22
- received.push(request.data.method);
23
- await writer.write(
24
- request.data.method === "initialize" ? { jsonrpc: "2.0", id: request.data.id, result: V1_INITIALIZE_RESULT } : {
25
- jsonrpc: "2.0",
26
- id: request.data.id,
27
- error: { code: -32601, message: "this agent speaks ACP v1 only" }
28
- }
29
- );
30
- }
18
+ write: async (message) => {
19
+ const request = requestSchema.safeParse(message);
20
+ if (!request.success) return;
21
+ received.push(request.data.method);
22
+ await writer.write(
23
+ request.data.method === "initialize" ? { jsonrpc: "2.0", id: request.data.id, result: V1_INITIALIZE_RESULT } : {
24
+ jsonrpc: "2.0",
25
+ id: request.data.id,
26
+ error: { code: -32601, message: "this agent speaks ACP v1 only" }
27
+ }
28
+ );
31
29
  },
32
30
  close: () => writer.close().catch(() => void 0)
33
31
  });
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/conformance/v1-agent.ts"],
4
- "sourcesContent": ["import type { AnyWireMessage, Stream } from '@agentclientprotocol/sdk/experimental/v2';\nimport * as z from 'zod';\n\n// An ACP v1 agent as a v2 client meets it: it answers `initialize` with the\n// latest version it speaks (1) in v1's shape (`agentCapabilities`,\n// `agentInfo`, no `info`) and errors every other request. Every party in the\n// plane must refuse it at `initialize` with `unsupported_protocol_version`; nothing negotiates or converts v1.\n\nexport const V1_INITIALIZE_RESULT = {\n protocolVersion: 1,\n agentCapabilities: {\n loadSession: true,\n promptCapabilities: { image: true, embeddedContext: true },\n mcpCapabilities: { http: true },\n },\n agentInfo: { name: 'acp-v1-fixture', version: '0.9.0' },\n authMethods: [],\n};\n\nconst requestSchema = z.object({ id: z.union([z.string(), z.number()]), method: z.string() });\n\nexport interface LegacyProtocolAgentIface {\n // The client side of the connection: what a dialer would get.\n stream: Stream;\n // Methods the agent received, in order.\n received: string[];\n}\n\nexport const createLegacyProtocolAgent = (): LegacyProtocolAgentIface => {\n const received: string[] = [];\n const toClient = new TransformStream<AnyWireMessage, AnyWireMessage>();\n const writer = toClient.writable.getWriter();\n const writable = new WritableStream<AnyWireMessage>({\n write: async (wire) => {\n for (const message of Array.isArray(wire) ? wire : [wire]) {\n const request = requestSchema.safeParse(message);\n if (!request.success) continue;\n received.push(request.data.method);\n await writer.write(\n request.data.method === 'initialize'\n ? { jsonrpc: '2.0', id: request.data.id, result: V1_INITIALIZE_RESULT }\n : {\n jsonrpc: '2.0',\n id: request.data.id,\n error: { code: -32601, message: 'this agent speaks ACP v1 only' },\n },\n );\n }\n },\n close: () => writer.close().catch(() => undefined),\n });\n return { stream: { readable: toClient.readable, writable }, received };\n};\n"],
5
- "mappings": "AACA,YAAY,OAAO;AAOZ,MAAM,uBAAuB;AAAA,EAClC,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,IACjB,aAAa;AAAA,IACb,oBAAoB,EAAE,OAAO,MAAM,iBAAiB,KAAK;AAAA,IACzD,iBAAiB,EAAE,MAAM,KAAK;AAAA,EAChC;AAAA,EACA,WAAW,EAAE,MAAM,kBAAkB,SAAS,QAAQ;AAAA,EACtD,aAAa,CAAC;AAChB;AAEA,MAAM,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,CAAC;AASrF,MAAM,4BAA4B,MAAgC;AACvE,QAAM,WAAqB,CAAC;AAC5B,QAAM,WAAW,IAAI,gBAAgD;AACrE,QAAM,SAAS,SAAS,SAAS,UAAU;AAC3C,QAAM,WAAW,IAAI,eAA+B;AAAA,IAClD,OAAO,OAAO,SAAS;AACrB,iBAAW,WAAW,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG;AACzD,cAAM,UAAU,cAAc,UAAU,OAAO;AAC/C,YAAI,CAAC,QAAQ,QAAS;AACtB,iBAAS,KAAK,QAAQ,KAAK,MAAM;AACjC,cAAM,OAAO;AAAA,UACX,QAAQ,KAAK,WAAW,eACpB,EAAE,SAAS,OAAO,IAAI,QAAQ,KAAK,IAAI,QAAQ,qBAAqB,IACpE;AAAA,YACE,SAAS;AAAA,YACT,IAAI,QAAQ,KAAK;AAAA,YACjB,OAAO,EAAE,MAAM,QAAQ,SAAS,gCAAgC;AAAA,UAClE;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,IACA,OAAO,MAAM,OAAO,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EACnD,CAAC;AACD,SAAO,EAAE,QAAQ,EAAE,UAAU,SAAS,UAAU,SAAS,GAAG,SAAS;AACvE;",
4
+ "sourcesContent": ["import type { AnyMessage, Stream } from '@agentclientprotocol/sdk/experimental/v2/unstable';\nimport * as z from 'zod';\n\n// An ACP v1 agent as a v2 client meets it: it answers `initialize` with the\n// latest version it speaks (1) in v1's shape (`agentCapabilities`,\n// `agentInfo`, no `info`) and errors every other request. Every party in the\n// plane must refuse it at `initialize` with `unsupported_protocol_version`; nothing negotiates or converts v1.\n\nexport const V1_INITIALIZE_RESULT = {\n protocolVersion: 1,\n agentCapabilities: {\n loadSession: true,\n promptCapabilities: { image: true, embeddedContext: true },\n mcpCapabilities: { http: true },\n },\n agentInfo: { name: 'acp-v1-fixture', version: '0.9.0' },\n authMethods: [],\n};\n\nconst requestSchema = z.object({ id: z.union([z.string(), z.number()]), method: z.string() });\n\nexport interface LegacyProtocolAgentIface {\n // The client side of the connection: what a dialer would get.\n stream: Stream;\n // Methods the agent received, in order.\n received: string[];\n}\n\nexport const createLegacyProtocolAgent = (): LegacyProtocolAgentIface => {\n const received: string[] = [];\n const toClient = new TransformStream<AnyMessage, AnyMessage>();\n const writer = toClient.writable.getWriter();\n const writable = new WritableStream<AnyMessage>({\n write: async (message) => {\n const request = requestSchema.safeParse(message);\n if (!request.success) return;\n received.push(request.data.method);\n await writer.write(\n request.data.method === 'initialize'\n ? { jsonrpc: '2.0', id: request.data.id, result: V1_INITIALIZE_RESULT }\n : {\n jsonrpc: '2.0',\n id: request.data.id,\n error: { code: -32601, message: 'this agent speaks ACP v1 only' },\n },\n );\n },\n close: () => writer.close().catch(() => undefined),\n });\n return { stream: { readable: toClient.readable, writable }, received };\n};\n"],
5
+ "mappings": "AACA,YAAY,OAAO;AAOZ,MAAM,uBAAuB;AAAA,EAClC,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,IACjB,aAAa;AAAA,IACb,oBAAoB,EAAE,OAAO,MAAM,iBAAiB,KAAK;AAAA,IACzD,iBAAiB,EAAE,MAAM,KAAK;AAAA,EAChC;AAAA,EACA,WAAW,EAAE,MAAM,kBAAkB,SAAS,QAAQ;AAAA,EACtD,aAAa,CAAC;AAChB;AAEA,MAAM,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,CAAC;AASrF,MAAM,4BAA4B,MAAgC;AACvE,QAAM,WAAqB,CAAC;AAC5B,QAAM,WAAW,IAAI,gBAAwC;AAC7D,QAAM,SAAS,SAAS,SAAS,UAAU;AAC3C,QAAM,WAAW,IAAI,eAA2B;AAAA,IAC9C,OAAO,OAAO,YAAY;AACxB,YAAM,UAAU,cAAc,UAAU,OAAO;AAC/C,UAAI,CAAC,QAAQ,QAAS;AACtB,eAAS,KAAK,QAAQ,KAAK,MAAM;AACjC,YAAM,OAAO;AAAA,QACX,QAAQ,KAAK,WAAW,eACpB,EAAE,SAAS,OAAO,IAAI,QAAQ,KAAK,IAAI,QAAQ,qBAAqB,IACpE;AAAA,UACE,SAAS;AAAA,UACT,IAAI,QAAQ,KAAK;AAAA,UACjB,OAAO,EAAE,MAAM,QAAQ,SAAS,gCAAgC;AAAA,QAClE;AAAA,MACN;AAAA,IACF;AAAA,IACA,OAAO,MAAM,OAAO,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EACnD,CAAC;AACD,SAAO,EAAE,QAAQ,EAAE,UAAU,SAAS,UAAU,SAAS,GAAG,SAAS;AACvE;",
6
6
  "names": []
7
7
  }
@@ -1,4 +1,4 @@
1
- import { type McpServer, type Stream } from '@agentclientprotocol/sdk/experimental/v2';
1
+ import { type McpServer, type Stream } from '@agentclientprotocol/sdk/experimental/v2/unstable';
2
2
  import { type InitializeMetaHolderIface } from '@finalai/acp-session';
3
3
  import { RuntimeKind, type Capability } from '@finalai/agent-protocol';
4
4
  import type { ResolvedHarnessSettingsIface } from '@finalai/agent-protocol/agent-platform';
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  ndJsonStream
3
- } from "@agentclientprotocol/sdk/experimental/v2";
3
+ } from "@agentclientprotocol/sdk/experimental/v2/unstable";
4
4
  import { advertisedFinalExtensions } from "@finalai/acp-session";
5
5
  import { RuntimeKind } from "@finalai/agent-protocol";
6
6
  import * as z from "zod";
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/harness-provider.ts"],
4
- "sourcesContent": ["import {\n ndJsonStream,\n type McpServer,\n type Stream,\n} from '@agentclientprotocol/sdk/experimental/v2';\nimport { advertisedFinalExtensions, type InitializeMetaHolderIface } from '@finalai/acp-session';\nimport { RuntimeKind, type Capability } from '@finalai/agent-protocol';\nimport type { ResolvedHarnessSettingsIface } from '@finalai/agent-protocol/agent-platform';\nimport * as z from 'zod';\nimport type { AgentDocumentIface } from \"./document.mjs\";\nimport type { JsonValue } from \"./json.mjs\";\nimport {\n AcpTransport,\n harnessSessionRefSchema,\n sandboxStartSchema,\n type CredentialGrantIface,\n type SandboxStartIface,\n type HarnessHealthIface,\n type HarnessObserverIface,\n type HarnessSessionContextIface,\n type HarnessSessionRefIface,\n type SandboxEndpointIface,\n type SecretReaderIface,\n type TraceContextIface,\n} from \"./harness.mjs\";\nimport {\n FinalExtension,\n type AcpAdapterDefinitionIface,\n type ComposedEnvironmentIface,\n type HarnessDefinitionIface,\n} from \"./harness-definition.mjs\";\nimport {\n isSandboxWorkerEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxWorkerOptionsIface,\n type SandboxWorkerStartType,\n} from \"./sandbox/types.mjs\";\n\n// A harness provider is the code that reaches a harness: one self-contained ES\n// module, run on the serverless runtime, exporting the functions of\n// HarnessProviderIface by name. The platform's general provider starts\n// adapter(harness) in its environment from the definitions' run entries and\n// is built on this same contract; a harness definition that carries its own\n// `provider` is reached by that code instead (a hosted fleet, a vendor API).\n//\n// Everything crossing the boundary is JSON: arguments in, endpoints out.\n\nexport const HARNESS_PROVIDER_EXPORTS = ['open', 'resume', 'park', 'close', 'health'] as const;\n\nexport type HarnessProviderExport = (typeof HARNESS_PROVIDER_EXPORTS)[number];\n\nexport interface PublishedDefinitionIface<Definition> {\n name: string;\n hash: string;\n definition: Definition;\n}\n\nexport interface HarnessProviderOpenArgsIface {\n session: HarnessSessionContextIface;\n // The session service's id for this harness session; key runtime state by it.\n harnessSessionId: string;\n harness: PublishedDefinitionIface<HarnessDefinitionIface>;\n // The adapter it runs behind; null when it speaks ACP v2 itself or runs at a URL.\n adapter: PublishedDefinitionIface<AcpAdapterDefinitionIface> | null;\n // Where it runs (composeHarness).\n environment: ComposedEnvironmentIface;\n // What the environment runs it as; null at a URL or without a run entry.\n runtime: RuntimeKind | null;\n // The caller's settings, defaults applied.\n settings: ResolvedHarnessSettingsIface;\n document: AgentDocumentIface;\n // ACP MCP server entries for `session/new`: the agent's tools, the provided\n // integrations, sandbox MCP projections where applicable.\n mcpServers: McpServer[];\n // The sandbox provided for each capability the harness drives on one.\n compute: Partial<Record<Capability, SandboxEndpointIface>>;\n credentials: CredentialGrantIface;\n trace: TraceContextIface;\n forkSource?: { ref: HarnessSessionRefIface; acpSessionId: string };\n}\n\nexport interface HarnessProviderResumeArgsIface extends HarnessProviderOpenArgsIface {\n ref: HarnessSessionRefIface;\n // Last log seq the session service holds; the harness replays anything newer.\n lastSeq: number;\n}\n\nexport interface HarnessProviderRefArgsIface {\n ref: HarnessSessionRefIface;\n environment: ComposedEnvironmentIface;\n}\n\nexport interface HarnessProviderCloseArgsIface extends HarnessProviderRefArgsIface {\n // Skip the graceful wait: the program did not settle ACP `session/close` in time.\n force: boolean;\n}\n\n// What every call gets besides its arguments.\nexport interface HarnessProviderContextIface {\n // The project's secrets the provider may read, by name.\n secrets: SecretReaderIface;\n // Lifecycle signals, recorded and never relied on.\n observer: HarnessObserverIface;\n}\n\n// The endpoint a provider returns: an ACP v2 endpoint the session service\n// dials, or a program it starts in the environment sandbox (ACP on stdio or\n// the worker's stream; nothing listens on a port). `extensions` are the Final\n// ACP extensions its `initialize` must advertise: the session service refuses\n// an endpoint missing any (missingFinalExtensions) as unsuitable, naming them.\nconst extensionsSchema = z.array(z.nativeEnum(FinalExtension)).default([]);\n\nexport const harnessProviderEndpointSchema = z.discriminatedUnion('transport', [\n z.strictObject({\n ref: harnessSessionRefSchema,\n transport: z.literal(AcpTransport.Ws),\n url: z.string().url(),\n headers: z.record(z.string(), z.string()).default({}),\n extensions: extensionsSchema,\n }),\n z.strictObject({\n ref: harnessSessionRefSchema,\n transport: z.literal(AcpTransport.Http),\n url: z.string().url(),\n headers: z.record(z.string(), z.string()).default({}),\n extensions: extensionsSchema,\n }),\n z.strictObject({\n ref: harnessSessionRefSchema,\n transport: z.literal(AcpTransport.Sandbox),\n sandboxId: z.string().min(1),\n start: sandboxStartSchema,\n extensions: extensionsSchema,\n }),\n]);\n\n// A provider that cannot reach the harness under these settings says why; the\n// session service reports it as an unsuitable harness requirement.\nexport const harnessProviderRefusalSchema = z.strictObject({\n unsuitable: z.array(z.string().min(1)).min(1),\n});\n\nexport type HarnessProviderRefusalIface = z.output<typeof harnessProviderRefusalSchema>;\n\n// What open and resume answer.\nexport const harnessProviderOpenResultSchema = z.union([\n harnessProviderEndpointSchema,\n harnessProviderRefusalSchema,\n]);\n\n// The extensions of `required` an `initialize` response does not advertise.\nexport const missingFinalExtensions = (\n initialize: InitializeMetaHolderIface,\n required: readonly FinalExtension[],\n): FinalExtension[] => {\n const advertised = advertisedFinalExtensions(initialize);\n const has: Record<FinalExtension, boolean> = {\n [FinalExtension.Observe]: advertised.observe,\n [FinalExtension.AuthorMeta]: advertised.authorMeta,\n [FinalExtension.ResumeReplay]: advertised.resumeReplay === true,\n [FinalExtension.Fork]: advertised.fork === true,\n [FinalExtension.AfterSeqReplay]: advertised.afterSeqReplay,\n };\n return required.filter((extension) => !has[extension]);\n};\n\nexport type HarnessProviderEndpointIface = z.output<typeof harnessProviderEndpointSchema>;\nexport type HarnessProviderEndpointInputIface = z.input<typeof harnessProviderEndpointSchema>;\n\n// What provider code returns. Its source cannot import the contract's enums,\n// so their values may be written as the strings they are.\ntype EnumLiteral<E extends string> = E | `${E}`;\n\ninterface ExtensionsResultIface {\n extensions?: EnumLiteral<FinalExtension>[];\n}\n\nexport type HarnessProviderEndpointResultIface =\n | (ExtensionsResultIface & {\n ref: HarnessSessionRefIface;\n transport: EnumLiteral<AcpTransport.Ws> | EnumLiteral<AcpTransport.Http>;\n url: string;\n headers?: Record<string, string>;\n })\n | (ExtensionsResultIface & {\n ref: HarnessSessionRefIface;\n transport: EnumLiteral<AcpTransport.Sandbox>;\n sandboxId: string;\n start:\n | {\n runtime: EnumLiteral<RuntimeKind.Process>;\n command: string;\n args?: string[];\n env?: Record<string, string>;\n cwd?: string;\n }\n | {\n runtime: EnumLiteral<RuntimeKind.Worker>;\n program: string;\n env?: Record<string, string>;\n input?: JsonValue;\n };\n });\n\nexport type HarnessProviderOpenResultIface =\n | HarnessProviderEndpointResultIface\n | HarnessProviderRefusalIface;\n\n// What starting a `sandbox` endpoint needs of its sandbox: a process\n// environment spawns, a worker runtime starts worker programs.\nexport interface SandboxEndpointHostIface {\n spawn(options: SandboxProcessOptionsIface): Promise<SandboxProcessIface>;\n startWorker?(options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType>;\n}\n\n// Starts what a `sandbox` endpoint names in its environment sandbox and\n// returns the ACP stream on its stdio (a process) or its stream (a worker\n// program), over the sandbox's own process streams: nothing listens on a port.\nexport const startSandboxEndpoint = async (args: {\n sandbox: SandboxEndpointHostIface;\n start: SandboxStartIface;\n abortSignal?: AbortSignal;\n}): Promise<{ process: SandboxProcessIface; stream: Stream }> => {\n const { start, sandbox } = args;\n let process: SandboxProcessIface;\n if (start.runtime === RuntimeKind.Process)\n process = await sandbox.spawn({\n command: start.command,\n args: start.args,\n env: start.env,\n ...(start.cwd == null ? {} : { cwd: start.cwd }),\n ...(args.abortSignal == null ? {} : { abortSignal: args.abortSignal }),\n });\n else {\n if (sandbox.startWorker == null)\n throw new Error(`The sandbox runs no worker programs (${start.program})`);\n const started = await sandbox.startWorker({\n program: start.program,\n env: start.env,\n input: start.input,\n ...(args.abortSignal == null ? {} : { abortSignal: args.abortSignal }),\n });\n // A program serving an endpoint of its own is dialed there, not over its streams.\n if (isSandboxWorkerEndpoint(started))\n throw new Error(\n `The worker program ${start.program} serves its own endpoint; dial it instead of its streams`,\n );\n process = started;\n }\n const input = new WritableStream<Uint8Array>({\n write: (chunk) => process.write(chunk),\n close: () => process.write(new Uint8Array(), { end: true }),\n });\n return { process, stream: ndJsonStream(input, process.stdout) };\n};\n\nexport const harnessProviderHealthSchema = z.object({\n ok: z.boolean(),\n detail: z.string().optional(),\n // Defaults to when the check returned.\n checkedAt: z.string().optional(),\n});\n\nexport interface HarnessProviderIface {\n open(\n args: HarnessProviderOpenArgsIface,\n ctx: HarnessProviderContextIface,\n ): Promise<HarnessProviderOpenResultIface>;\n resume(\n args: HarnessProviderResumeArgsIface,\n ctx: HarnessProviderContextIface,\n ): Promise<HarnessProviderOpenResultIface>;\n park(args: HarnessProviderRefArgsIface, ctx: HarnessProviderContextIface): Promise<void>;\n // Graceful unless `force`: the harness's state is durable before it stops.\n close(args: HarnessProviderCloseArgsIface, ctx: HarnessProviderContextIface): Promise<void>;\n health(\n args: HarnessProviderRefArgsIface,\n ctx: HarnessProviderContextIface,\n ): Promise<Omit<HarnessHealthIface, 'checkedAt'> & { checkedAt?: string }>;\n}\n"],
4
+ "sourcesContent": ["import {\n ndJsonStream,\n type McpServer,\n type Stream,\n} from '@agentclientprotocol/sdk/experimental/v2/unstable';\nimport { advertisedFinalExtensions, type InitializeMetaHolderIface } from '@finalai/acp-session';\nimport { RuntimeKind, type Capability } from '@finalai/agent-protocol';\nimport type { ResolvedHarnessSettingsIface } from '@finalai/agent-protocol/agent-platform';\nimport * as z from 'zod';\nimport type { AgentDocumentIface } from \"./document.mjs\";\nimport type { JsonValue } from \"./json.mjs\";\nimport {\n AcpTransport,\n harnessSessionRefSchema,\n sandboxStartSchema,\n type CredentialGrantIface,\n type SandboxStartIface,\n type HarnessHealthIface,\n type HarnessObserverIface,\n type HarnessSessionContextIface,\n type HarnessSessionRefIface,\n type SandboxEndpointIface,\n type SecretReaderIface,\n type TraceContextIface,\n} from \"./harness.mjs\";\nimport {\n FinalExtension,\n type AcpAdapterDefinitionIface,\n type ComposedEnvironmentIface,\n type HarnessDefinitionIface,\n} from \"./harness-definition.mjs\";\nimport {\n isSandboxWorkerEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxWorkerOptionsIface,\n type SandboxWorkerStartType,\n} from \"./sandbox/types.mjs\";\n\n// A harness provider is the code that reaches a harness: one self-contained ES\n// module, run on the serverless runtime, exporting the functions of\n// HarnessProviderIface by name. The platform's general provider starts\n// adapter(harness) in its environment from the definitions' run entries and\n// is built on this same contract; a harness definition that carries its own\n// `provider` is reached by that code instead (a hosted fleet, a vendor API).\n//\n// Everything crossing the boundary is JSON: arguments in, endpoints out.\n\nexport const HARNESS_PROVIDER_EXPORTS = ['open', 'resume', 'park', 'close', 'health'] as const;\n\nexport type HarnessProviderExport = (typeof HARNESS_PROVIDER_EXPORTS)[number];\n\nexport interface PublishedDefinitionIface<Definition> {\n name: string;\n hash: string;\n definition: Definition;\n}\n\nexport interface HarnessProviderOpenArgsIface {\n session: HarnessSessionContextIface;\n // The session service's id for this harness session; key runtime state by it.\n harnessSessionId: string;\n harness: PublishedDefinitionIface<HarnessDefinitionIface>;\n // The adapter it runs behind; null when it speaks ACP v2 itself or runs at a URL.\n adapter: PublishedDefinitionIface<AcpAdapterDefinitionIface> | null;\n // Where it runs (composeHarness).\n environment: ComposedEnvironmentIface;\n // What the environment runs it as; null at a URL or without a run entry.\n runtime: RuntimeKind | null;\n // The caller's settings, defaults applied.\n settings: ResolvedHarnessSettingsIface;\n document: AgentDocumentIface;\n // ACP MCP server entries for `session/new`: the agent's tools, the provided\n // integrations, sandbox MCP projections where applicable.\n mcpServers: McpServer[];\n // The sandbox provided for each capability the harness drives on one.\n compute: Partial<Record<Capability, SandboxEndpointIface>>;\n credentials: CredentialGrantIface;\n trace: TraceContextIface;\n forkSource?: { ref: HarnessSessionRefIface; acpSessionId: string };\n}\n\nexport interface HarnessProviderResumeArgsIface extends HarnessProviderOpenArgsIface {\n ref: HarnessSessionRefIface;\n // Last log seq the session service holds; the harness replays anything newer.\n lastSeq: number;\n}\n\nexport interface HarnessProviderRefArgsIface {\n ref: HarnessSessionRefIface;\n environment: ComposedEnvironmentIface;\n}\n\nexport interface HarnessProviderCloseArgsIface extends HarnessProviderRefArgsIface {\n // Skip the graceful wait: the program did not settle ACP `session/close` in time.\n force: boolean;\n}\n\n// What every call gets besides its arguments.\nexport interface HarnessProviderContextIface {\n // The project's secrets the provider may read, by name.\n secrets: SecretReaderIface;\n // Lifecycle signals, recorded and never relied on.\n observer: HarnessObserverIface;\n}\n\n// The endpoint a provider returns: an ACP v2 endpoint the session service\n// dials, or a program it starts in the environment sandbox (ACP on stdio or\n// the worker's stream; nothing listens on a port). `extensions` are the Final\n// ACP extensions its `initialize` must advertise: the session service refuses\n// an endpoint missing any (missingFinalExtensions) as unsuitable, naming them.\nconst extensionsSchema = z.array(z.nativeEnum(FinalExtension)).default([]);\n\nexport const harnessProviderEndpointSchema = z.discriminatedUnion('transport', [\n z.strictObject({\n ref: harnessSessionRefSchema,\n transport: z.literal(AcpTransport.Ws),\n url: z.string().url(),\n headers: z.record(z.string(), z.string()).default({}),\n extensions: extensionsSchema,\n }),\n z.strictObject({\n ref: harnessSessionRefSchema,\n transport: z.literal(AcpTransport.Http),\n url: z.string().url(),\n headers: z.record(z.string(), z.string()).default({}),\n extensions: extensionsSchema,\n }),\n z.strictObject({\n ref: harnessSessionRefSchema,\n transport: z.literal(AcpTransport.Sandbox),\n sandboxId: z.string().min(1),\n start: sandboxStartSchema,\n extensions: extensionsSchema,\n }),\n]);\n\n// A provider that cannot reach the harness under these settings says why; the\n// session service reports it as an unsuitable harness requirement.\nexport const harnessProviderRefusalSchema = z.strictObject({\n unsuitable: z.array(z.string().min(1)).min(1),\n});\n\nexport type HarnessProviderRefusalIface = z.output<typeof harnessProviderRefusalSchema>;\n\n// What open and resume answer.\nexport const harnessProviderOpenResultSchema = z.union([\n harnessProviderEndpointSchema,\n harnessProviderRefusalSchema,\n]);\n\n// The extensions of `required` an `initialize` response does not advertise.\nexport const missingFinalExtensions = (\n initialize: InitializeMetaHolderIface,\n required: readonly FinalExtension[],\n): FinalExtension[] => {\n const advertised = advertisedFinalExtensions(initialize);\n const has: Record<FinalExtension, boolean> = {\n [FinalExtension.Observe]: advertised.observe,\n [FinalExtension.AuthorMeta]: advertised.authorMeta,\n [FinalExtension.ResumeReplay]: advertised.resumeReplay === true,\n [FinalExtension.Fork]: advertised.fork === true,\n [FinalExtension.AfterSeqReplay]: advertised.afterSeqReplay,\n };\n return required.filter((extension) => !has[extension]);\n};\n\nexport type HarnessProviderEndpointIface = z.output<typeof harnessProviderEndpointSchema>;\nexport type HarnessProviderEndpointInputIface = z.input<typeof harnessProviderEndpointSchema>;\n\n// What provider code returns. Its source cannot import the contract's enums,\n// so their values may be written as the strings they are.\ntype EnumLiteral<E extends string> = E | `${E}`;\n\ninterface ExtensionsResultIface {\n extensions?: EnumLiteral<FinalExtension>[];\n}\n\nexport type HarnessProviderEndpointResultIface =\n | (ExtensionsResultIface & {\n ref: HarnessSessionRefIface;\n transport: EnumLiteral<AcpTransport.Ws> | EnumLiteral<AcpTransport.Http>;\n url: string;\n headers?: Record<string, string>;\n })\n | (ExtensionsResultIface & {\n ref: HarnessSessionRefIface;\n transport: EnumLiteral<AcpTransport.Sandbox>;\n sandboxId: string;\n start:\n | {\n runtime: EnumLiteral<RuntimeKind.Process>;\n command: string;\n args?: string[];\n env?: Record<string, string>;\n cwd?: string;\n }\n | {\n runtime: EnumLiteral<RuntimeKind.Worker>;\n program: string;\n env?: Record<string, string>;\n input?: JsonValue;\n };\n });\n\nexport type HarnessProviderOpenResultIface =\n | HarnessProviderEndpointResultIface\n | HarnessProviderRefusalIface;\n\n// What starting a `sandbox` endpoint needs of its sandbox: a process\n// environment spawns, a worker runtime starts worker programs.\nexport interface SandboxEndpointHostIface {\n spawn(options: SandboxProcessOptionsIface): Promise<SandboxProcessIface>;\n startWorker?(options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType>;\n}\n\n// Starts what a `sandbox` endpoint names in its environment sandbox and\n// returns the ACP stream on its stdio (a process) or its stream (a worker\n// program), over the sandbox's own process streams: nothing listens on a port.\nexport const startSandboxEndpoint = async (args: {\n sandbox: SandboxEndpointHostIface;\n start: SandboxStartIface;\n abortSignal?: AbortSignal;\n}): Promise<{ process: SandboxProcessIface; stream: Stream }> => {\n const { start, sandbox } = args;\n let process: SandboxProcessIface;\n if (start.runtime === RuntimeKind.Process)\n process = await sandbox.spawn({\n command: start.command,\n args: start.args,\n env: start.env,\n ...(start.cwd == null ? {} : { cwd: start.cwd }),\n ...(args.abortSignal == null ? {} : { abortSignal: args.abortSignal }),\n });\n else {\n if (sandbox.startWorker == null)\n throw new Error(`The sandbox runs no worker programs (${start.program})`);\n const started = await sandbox.startWorker({\n program: start.program,\n env: start.env,\n input: start.input,\n ...(args.abortSignal == null ? {} : { abortSignal: args.abortSignal }),\n });\n // A program serving an endpoint of its own is dialed there, not over its streams.\n if (isSandboxWorkerEndpoint(started))\n throw new Error(\n `The worker program ${start.program} serves its own endpoint; dial it instead of its streams`,\n );\n process = started;\n }\n const input = new WritableStream<Uint8Array>({\n write: (chunk) => process.write(chunk),\n close: () => process.write(new Uint8Array(), { end: true }),\n });\n return { process, stream: ndJsonStream(input, process.stdout) };\n};\n\nexport const harnessProviderHealthSchema = z.object({\n ok: z.boolean(),\n detail: z.string().optional(),\n // Defaults to when the check returned.\n checkedAt: z.string().optional(),\n});\n\nexport interface HarnessProviderIface {\n open(\n args: HarnessProviderOpenArgsIface,\n ctx: HarnessProviderContextIface,\n ): Promise<HarnessProviderOpenResultIface>;\n resume(\n args: HarnessProviderResumeArgsIface,\n ctx: HarnessProviderContextIface,\n ): Promise<HarnessProviderOpenResultIface>;\n park(args: HarnessProviderRefArgsIface, ctx: HarnessProviderContextIface): Promise<void>;\n // Graceful unless `force`: the harness's state is durable before it stops.\n close(args: HarnessProviderCloseArgsIface, ctx: HarnessProviderContextIface): Promise<void>;\n health(\n args: HarnessProviderRefArgsIface,\n ctx: HarnessProviderContextIface,\n ): Promise<Omit<HarnessHealthIface, 'checkedAt'> & { checkedAt?: string }>;\n}\n"],
5
5
  "mappings": "AAAA;AAAA,EACE;AAAA,OAGK;AACP,SAAS,iCAAiE;AAC1E,SAAS,mBAAoC;AAE7C,YAAY,OAAO;AAGnB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAUK;AACP;AAAA,EACE;AAAA,OAIK;AACP;AAAA,EACE;AAAA,OAKK;AAWA,MAAM,2BAA2B,CAAC,QAAQ,UAAU,QAAQ,SAAS,QAAQ;AA+DpF,MAAM,mBAAmB,EAAE,MAAM,EAAE,WAAW,cAAc,CAAC,EAAE,QAAQ,CAAC,CAAC;AAElE,MAAM,gCAAgC,EAAE,mBAAmB,aAAa;AAAA,EAC7E,EAAE,aAAa;AAAA,IACb,KAAK;AAAA,IACL,WAAW,EAAE,QAAQ,aAAa,EAAE;AAAA,IACpC,KAAK,EAAE,OAAO,EAAE,IAAI;AAAA,IACpB,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,IACpD,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,aAAa;AAAA,IACb,KAAK;AAAA,IACL,WAAW,EAAE,QAAQ,aAAa,IAAI;AAAA,IACtC,KAAK,EAAE,OAAO,EAAE,IAAI;AAAA,IACpB,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,IACpD,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,aAAa;AAAA,IACb,KAAK;AAAA,IACL,WAAW,EAAE,QAAQ,aAAa,OAAO;AAAA,IACzC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IAC3B,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AACH,CAAC;AAIM,MAAM,+BAA+B,EAAE,aAAa;AAAA,EACzD,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;AAC9C,CAAC;AAKM,MAAM,kCAAkC,EAAE,MAAM;AAAA,EACrD;AAAA,EACA;AACF,CAAC;AAGM,MAAM,yBAAyB,CACpC,YACA,aACqB;AACrB,QAAM,aAAa,0BAA0B,UAAU;AACvD,QAAM,MAAuC;AAAA,IAC3C,CAAC,eAAe,OAAO,GAAG,WAAW;AAAA,IACrC,CAAC,eAAe,UAAU,GAAG,WAAW;AAAA,IACxC,CAAC,eAAe,YAAY,GAAG,WAAW,iBAAiB;AAAA,IAC3D,CAAC,eAAe,IAAI,GAAG,WAAW,SAAS;AAAA,IAC3C,CAAC,eAAe,cAAc,GAAG,WAAW;AAAA,EAC9C;AACA,SAAO,SAAS,OAAO,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;AACvD;AAsDO,MAAM,uBAAuB,OAAO,SAIsB;AAC/D,QAAM,EAAE,OAAO,QAAQ,IAAI;AAC3B,MAAI;AACJ,MAAI,MAAM,YAAY,YAAY;AAChC,cAAU,MAAM,QAAQ,MAAM;AAAA,MAC5B,SAAS,MAAM;AAAA,MACf,MAAM,MAAM;AAAA,MACZ,KAAK,MAAM;AAAA,MACX,GAAI,MAAM,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,MAAM,IAAI;AAAA,MAC9C,GAAI,KAAK,eAAe,OAAO,CAAC,IAAI,EAAE,aAAa,KAAK,YAAY;AAAA,IACtE,CAAC;AAAA,OACE;AACH,QAAI,QAAQ,eAAe;AACzB,YAAM,IAAI,MAAM,wCAAwC,MAAM,OAAO,GAAG;AAC1E,UAAM,UAAU,MAAM,QAAQ,YAAY;AAAA,MACxC,SAAS,MAAM;AAAA,MACf,KAAK,MAAM;AAAA,MACX,OAAO,MAAM;AAAA,MACb,GAAI,KAAK,eAAe,OAAO,CAAC,IAAI,EAAE,aAAa,KAAK,YAAY;AAAA,IACtE,CAAC;AAED,QAAI,wBAAwB,OAAO;AACjC,YAAM,IAAI;AAAA,QACR,sBAAsB,MAAM,OAAO;AAAA,MACrC;AACF,cAAU;AAAA,EACZ;AACA,QAAM,QAAQ,IAAI,eAA2B;AAAA,IAC3C,OAAO,CAAC,UAAU,QAAQ,MAAM,KAAK;AAAA,IACrC,OAAO,MAAM,QAAQ,MAAM,IAAI,WAAW,GAAG,EAAE,KAAK,KAAK,CAAC;AAAA,EAC5D,CAAC;AACD,SAAO,EAAE,SAAS,QAAQ,aAAa,OAAO,QAAQ,MAAM,EAAE;AAChE;AAEO,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,IAAI,EAAE,QAAQ;AAAA,EACd,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA;AAAA,EAE5B,WAAW,EAAE,OAAO,EAAE,SAAS;AACjC,CAAC;",
6
6
  "names": []
7
7
  }
@@ -1,4 +1,4 @@
1
- import type { McpServer } from '@agentclientprotocol/sdk/experimental/v2';
1
+ import type { McpServer } from '@agentclientprotocol/sdk/experimental/v2/unstable';
2
2
  import { Capability } from '@finalai/agent-protocol';
3
3
  import { InferenceSourceKind, type ResolvedHarnessSettingsIface } from '@finalai/agent-protocol/agent-platform';
4
4
  import { RuntimeKind } from '@finalai/agent-protocol';
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/harness.ts"],
4
- "sourcesContent": ["import type { McpServer } from '@agentclientprotocol/sdk/experimental/v2';\nimport { Capability } from '@finalai/agent-protocol';\nimport {\n InferenceSourceKind,\n type ResolvedHarnessSettingsIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { RuntimeKind } from '@finalai/agent-protocol';\nimport * as z from 'zod';\nimport { CredentialRoute, routeGrantSchema, type RouteGrantIface } from \"./credential-routes.mjs\";\nimport type { AgentDocumentIface } from \"./document.mjs\";\nimport type { JsonValue } from \"./json.mjs\";\nimport { jsonValueSchema } from \"./json.mjs\";\nimport type { HarnessDefinitionIface } from \"./harness-definition.mjs\";\nimport { sandboxGrantSchema, type SandboxGrantIface } from \"./sandbox/grant.mjs\";\n\n// The runtime side of a harness: what reaching one looks like to the session\n// service. A caller names a harness definition in its harness settings\n// (`{ harness, adapter?, configuration, environment? }`, plain data); the\n// platform starts a fresh one per session through a harness provider\n// (./harness-provider.ts) and speaks only ACP v2 to it. Harness and ACP\n// adapter definitions are ./harness-definition.ts.\n\nexport {\n HarnessComputeStatus,\n harnessEnvironmentSchema,\n harnessSettingsSchema,\n harnessUrlEnvironmentSchema,\n isUrlEnvironment,\n type HarnessEnvironmentIface,\n type HarnessSettingsIface,\n type HarnessUrlEnvironmentIface,\n type ResolvedHarnessSettingsIface,\n} from '@finalai/agent-protocol/agent-platform';\n\nexport enum AcpTransport {\n Relay = 'relay',\n Ws = 'ws',\n Http = 'http',\n Stdio = 'stdio',\n // A program the session service starts in a sandbox over the sandbox handle\n // RPC: ACP on its stdio, nothing listening on a port.\n Sandbox = 'sandbox',\n}\n\nexport enum McpTransportKind {\n Acp = 'acp',\n Http = 'http',\n Stdio = 'stdio',\n}\n\n// Wires a harness speaks to reach a provided sandbox.\nexport enum SandboxWire {\n HandleRpc = 'handle-rpc',\n Mcp = 'mcp',\n}\n\n// How a harness's model credential reaches it.\nexport enum CredentialDelivery {\n // Fetched from the broker's `model` route on every request.\n PerRequest = 'per-request',\n // Resolved once when the session opens and renewed through the grant's refresh route.\n AtOpen = 'at-open',\n}\n\n// What an accepted session/prompt does while the session is running. Both are valid; refusing one is a conformance failure.\nexport enum PromptWhileRunning {\n // Joins the running work: the model sees it at its next step.\n Inject = 'inject',\n // Runs after the current work goes idle; dropped by session/cancel if not started.\n Queue = 'queue',\n}\n\n// Defaults for a description that does not declare the hosting profile: the\n// session service then assumes nothing survives a dropped connection and that\n// a prompt while running waits for idle.\nexport const DEFAULT_PROMPT_WHILE_RUNNING = PromptWhileRunning.Queue;\nexport const DEFAULT_SESSION_SURVIVES_DISCONNECT = false;\n\nexport const harnessSessionRefSchema = z.object({\n // The harness's name, as harness settings name it.\n harness: z.string().min(1),\n // Opaque to the session service; the harness's own id for the session.\n harnessSessionRef: z.string().min(1),\n // Bumped whenever the harness loses state; a mismatch on resume means the\n // session service must re-seed with session/new.\n generation: z.number().int().nonnegative(),\n});\n\nexport type HarnessSessionRefIface = z.infer<typeof harnessSessionRefSchema>;\n\n// Route-scoped, short-lived grants: credential-routes.ts.\nexport {\n credentialRefreshRequestSchema,\n CredentialRoute,\n routeGrantSchema,\n type CredentialRefreshRequestIface,\n type RouteGrantIface,\n} from \"./credential-routes.mjs\";\n\nexport interface CredentialGrantIface {\n // Base URL of the broker routes (`<base>/model`, `<base>/refresh`, ...).\n brokerUrl: string;\n grants: RouteGrantIface[];\n // What the model grant resolved to, for harnesses that hand credentials over\n // at open (delivery 'at-open'). Null for per-request harnesses.\n atOpen: AtOpenModelCredentialIface | null;\n // How to renew this grant; null only when it carries no route grant.\n refresh: CredentialGrantRefreshIface | null;\n}\n\n// Renewal is pulled, never pushed. Per-request harnesses fetch\n// `<brokerUrl>/model` on every request. At-open harnesses (or their host)\n// POST `url` with `authorization: Bearer <token>` and a\n// `credentialRefreshRequestSchema` body before `expiresAt` and once after a\n// vendor 401; the answer is the grant's next generation (a\n// `credentialRefreshResultSchema` body with its own `refresh`), which replaces\n// this one. The broker resolves the policy again for it, so a disconnected\n// credential falls through; a revoked grant (every open revokes the previous\n// open's grants) or a closed harness session is refused (401).\nexport interface CredentialGrantRefreshIface {\n // `<brokerUrl>/refresh`.\n url: string;\n // One of this grant's own route grants (the model route's).\n token: string;\n harnessSessionId: string;\n // When `token` expires; a refresh after it is refused.\n expiresAt: string;\n}\n\nexport interface AtOpenModelCredentialIface {\n vendor: string;\n kind: InferenceSourceKind;\n // Base URL and bearer for an OpenAI- or Anthropic-compatible endpoint (the\n // platform proxy, a corporate gateway) or the vendor itself.\n baseUrl: string | null;\n apiKey: string | null;\n // Subscription material for Final-managed harnesses only (Claude setup token,\n // Codex app-server chatgptAuthTokens); renewed through the grant's refresh route.\n subscription: { format: 'claude-setup-token' | 'chatgpt-auth-tokens'; value: string } | null;\n fingerprint: string;\n}\n\nexport const atOpenModelCredentialSchema = z.object({\n vendor: z.string(),\n kind: z.nativeEnum(InferenceSourceKind),\n baseUrl: z.string().min(1).nullable(),\n apiKey: z.string().min(1).nullable(),\n subscription: z\n .object({\n format: z.union([z.literal('claude-setup-token'), z.literal('chatgpt-auth-tokens')]),\n value: z.string().min(1),\n })\n .nullable(),\n fingerprint: z.string(),\n}) satisfies z.ZodType<AtOpenModelCredentialIface>;\n\nexport const credentialGrantRefreshSchema = z.object({\n url: z.string().min(1),\n token: z.string().min(1),\n harnessSessionId: z.string().min(1),\n expiresAt: z.string(),\n}) satisfies z.ZodType<CredentialGrantRefreshIface>;\n\nexport const credentialGrantSchema = z.object({\n brokerUrl: z.string().min(1),\n grants: z.array(routeGrantSchema),\n atOpen: atOpenModelCredentialSchema.nullable(),\n refresh: credentialGrantRefreshSchema.nullable(),\n}) satisfies z.ZodType<CredentialGrantIface>;\n\n// An `http` MCP server entry the harness was handed in `session/new`\n// (`mcpServers`), with fresh headers. Same name and url; the harness swaps the\n// headers of the entry with that url.\nexport interface RenewedMcpServerIface {\n name: string;\n url: string;\n headers: { name: string; value: string }[];\n}\n\n// What a refresh answers: the grant's next generation, plus fresh copies of the\n// other short-lived material the harness was handed at open. Renewing the\n// `mcp` route renews the session's `http` MCP server headers; renewing\n// `sandbox` renews the compute endpoints' tokens.\nexport interface CredentialRefreshResultIface extends CredentialGrantIface {\n mcpServers: RenewedMcpServerIface[];\n compute: Partial<Record<Capability, SandboxEndpointIface>>;\n}\n\nconst endpointTokenSchema = z.object({\n url: z.string().min(1),\n token: z.string(),\n expiresAt: z.string(),\n});\n\nexport const sandboxEndpointSchema = z.object({\n sandboxId: z.string().min(1),\n bindingId: z.string().min(1),\n grant: sandboxGrantSchema,\n features: z.array(z.string()),\n rpc: endpointTokenSchema.nullable(),\n mcp: endpointTokenSchema.nullable(),\n}) satisfies z.ZodType<SandboxEndpointIface>;\n\nexport const renewedMcpServerSchema = z.object({\n name: z.string().min(1),\n url: z.string().min(1),\n headers: z.array(z.object({ name: z.string().min(1), value: z.string() })),\n}) satisfies z.ZodType<RenewedMcpServerIface>;\n\n// Absent renewals parse as none, so an answer without them still parses.\nexport const credentialRefreshResultSchema = credentialGrantSchema.extend({\n mcpServers: z.array(renewedMcpServerSchema).default([]),\n compute: z.partialRecord(z.nativeEnum(Capability), sandboxEndpointSchema).default({}),\n}) satisfies z.ZodType<CredentialRefreshResultIface, unknown>;\n\n// The refresh descriptor for a set of route grants: authenticated by the model\n// grant (else the first), due when that token expires.\nexport const grantRefreshFor = (args: {\n brokerUrl: string;\n harnessSessionId: string;\n grants: readonly RouteGrantIface[];\n}): CredentialGrantRefreshIface | null => {\n const grant =\n args.grants.find((candidate) => candidate.route === CredentialRoute.Model) ?? args.grants[0];\n if (grant == null) return null;\n return {\n url: `${args.brokerUrl.replace(/\\/+$/, '')}/refresh`,\n token: grant.token,\n harnessSessionId: args.harnessSessionId,\n expiresAt: grant.expiresAt,\n };\n};\n\nexport interface SecretReaderIface {\n get(name: string): Promise<string | null>;\n}\n\nexport interface TraceContextIface {\n traceparent: string | null;\n tracestate: string | null;\n}\n\n// A provided sandbox as the session service hands it to a harness, for one\n// capability: a stable per-session address that attaches the sandbox on the\n// first call, and the grant every call on it is held to. `files` and `shell`\n// share one sandbox and so one endpoint. Never a lease, a data-plane token for\n// a live machine, or provider code.\nexport interface SandboxEndpointIface {\n sandboxId: string;\n bindingId: string;\n grant: SandboxGrantIface;\n // Handle features the sandbox advertises (SandboxCapability), when known.\n features: string[];\n rpc: { url: string; token: string; expiresAt: string } | null;\n mcp: { url: string; token: string; expiresAt: string } | null;\n}\n\nexport interface HarnessSessionContextIface {\n sessionId: string;\n organizationId: string;\n projectId: string;\n // The agent document's content hash the session pins.\n agent: string;\n // The published agent it was started as; null for an agent passed as a value.\n definitionId: string | null;\n // Public base URL of the session service for this session (MCP over HTTP,\n // sandbox endpoints, the broker).\n sessionServiceUrl: string;\n // The region of the session service serving the session, so a harness can\n // run near it; null when unknown.\n sessionServiceRegion?: string | null;\n}\n\n// Lifecycle signals a harness implementation may report about the runtime\n// hosting a session (invocations, metering, traces). Informational: the\n// session service records them and never depends on them for correctness.\nexport interface HarnessObserverIface {\n // The runtime accepted the invocation request (its response began).\n invocationAccepted?(event: { invocationRef: string; at: string }): void;\n invocationStarted?(event: {\n invocationRef: string;\n at: string;\n bootMs: number | null;\n // The runtime's deployed version, for rollouts.\n versionId?: string | null;\n commitSha?: string | null;\n }): void;\n invocationKeepalive?(event: { invocationRef: string; at: string; activeWork: number }): void;\n invocationEnded?(event: {\n invocationRef: string;\n at: string;\n reason: string;\n error: string | null;\n metering: Record<string, number>;\n }): void;\n trace?(event: { name: string; at: string; fields: Record<string, JsonValue> }): void;\n}\n\nexport interface OpenHarnessSessionArgsIface {\n session: HarnessSessionContextIface;\n // The session service's id for this harness session; implementations key\n // their runtime state and route grants by it.\n harnessSessionId: string;\n // Hosting may authorize the child endpoint to fork this source through ACP.\n forkSource?: { ref: HarnessSessionRefIface; acpSessionId: string };\n observer?: HarnessObserverIface;\n // The agent: instructions, skills, tool policy and requirements.\n document: AgentDocumentIface;\n // The caller's harness settings, accepted by `accepts`, defaults applied.\n settings: ResolvedHarnessSettingsIface;\n // Already materialized ACP MCP server entries: the agent's own tools, the\n // provided integrations, sandbox MCP projections where applicable.\n mcpServers: McpServer[];\n // The provided sandbox for each capability the harness drives on one; a\n // capability served natively, or not provided, is absent.\n compute: Partial<Record<Capability, SandboxEndpointIface>>;\n credentials: CredentialGrantIface;\n secrets: SecretReaderIface;\n trace: TraceContextIface;\n}\n\nexport interface ResumeHarnessSessionArgsIface extends OpenHarnessSessionArgsIface {\n ref: HarnessSessionRefIface;\n // Last log seq the session service holds from this harness session; the\n // harness replays anything newer after session/resume.\n lastSeq: number;\n}\n\n// What the session service starts in a harness's environment sandbox: a\n// process, speaking ACP on its stdin and stdout, or a worker program, speaking\n// ACP on its stream. Both run over the sandbox handle RPC; nothing listens on\n// a port.\nexport const sandboxProcessStartSchema = z.strictObject({\n runtime: z.literal(RuntimeKind.Process),\n command: z.string().min(1),\n args: z.array(z.string()).default([]),\n env: z.record(z.string(), z.string()).default({}),\n cwd: z.string().min(1).optional(),\n});\n\nexport const sandboxWorkerStartSchema = z.strictObject({\n runtime: z.literal(RuntimeKind.Worker),\n program: z.string().min(1),\n env: z.record(z.string(), z.string()).default({}),\n // Handed to the program when it starts.\n input: jsonValueSchema.default(null),\n});\n\nexport const sandboxStartSchema = z.discriminatedUnion('runtime', [\n sandboxProcessStartSchema,\n sandboxWorkerStartSchema,\n]);\n\nexport type SandboxStartIface = z.output<typeof sandboxStartSchema>;\nexport type SandboxStartInputIface = z.input<typeof sandboxStartSchema>;\n\n// Resolved only in memory; refs retain secret names, never TLS keys.\nexport interface HarnessClientTlsIface {\n cert: string;\n key: string;\n ca?: string;\n}\n\nexport type HarnessEndpointIface =\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Ws;\n url: string;\n headers: Record<string, string>;\n resolveHeaders?: () => Promise<Record<string, string>>;\n tls?: HarnessClientTlsIface;\n }\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Http;\n url: string;\n headers: Record<string, string>;\n resolveHeaders?: () => Promise<Record<string, string>>;\n tls?: HarnessClientTlsIface;\n }\n // A relay channel the runtime answers on.\n | { ref: HarnessSessionRefIface; transport: AcpTransport.Relay; channel: string; token: string }\n // A program the session service starts in a sandbox; ACP on its stdio.\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Sandbox;\n sandboxId: string;\n start: SandboxStartIface;\n }\n // Local development, CI and conformance only.\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Stdio;\n command: string;\n args: string[];\n env: Record<string, string>;\n };\n\nexport interface HarnessHealthIface {\n ok: boolean;\n detail?: string;\n checkedAt: string;\n}\n\n// The settings a call is about and the project's secrets (a remote harness's\n// client certificate, by name).\nexport interface HarnessCallContextIface {\n settings: ResolvedHarnessSettingsIface;\n secrets: SecretReaderIface;\n}\n\n// A harness as a driver reaches it (the session service, the conformance\n// kit): what it is, as its definition says (configuration schema, features,\n// MCP transports, prompt-while-running, session survival), and its session\n// lifecycle.\nexport interface HarnessIface {\n definition: HarnessDefinitionIface;\n open(args: OpenHarnessSessionArgsIface): Promise<HarnessEndpointIface>;\n resume(args: ResumeHarnessSessionArgsIface): Promise<HarnessEndpointIface>;\n park(ref: HarnessSessionRefIface): Promise<void>;\n // Graceful by default: the program's state is durable (resumable) before it\n // stops, bounded by the implementation's timeout, then forced. `force` skips\n // the wait; the session service passes it when the program did not settle\n // ACP `session/close` within its bound.\n close(ref: HarnessSessionRefIface, opts?: CloseHarnessSessionOptsIface): Promise<void>;\n health(\n ref: HarnessSessionRefIface,\n context?: HarnessCallContextIface,\n ): Promise<HarnessHealthIface>;\n}\n\nexport interface CloseHarnessSessionOptsIface {\n force?: boolean;\n // As with health, retained refs can resolve current client TLS without storing keys in the ref.\n context?: HarnessCallContextIface;\n}\n"],
4
+ "sourcesContent": ["import type { McpServer } from '@agentclientprotocol/sdk/experimental/v2/unstable';\nimport { Capability } from '@finalai/agent-protocol';\nimport {\n InferenceSourceKind,\n type ResolvedHarnessSettingsIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { RuntimeKind } from '@finalai/agent-protocol';\nimport * as z from 'zod';\nimport { CredentialRoute, routeGrantSchema, type RouteGrantIface } from \"./credential-routes.mjs\";\nimport type { AgentDocumentIface } from \"./document.mjs\";\nimport type { JsonValue } from \"./json.mjs\";\nimport { jsonValueSchema } from \"./json.mjs\";\nimport type { HarnessDefinitionIface } from \"./harness-definition.mjs\";\nimport { sandboxGrantSchema, type SandboxGrantIface } from \"./sandbox/grant.mjs\";\n\n// The runtime side of a harness: what reaching one looks like to the session\n// service. A caller names a harness definition in its harness settings\n// (`{ harness, adapter?, configuration, environment? }`, plain data); the\n// platform starts a fresh one per session through a harness provider\n// (./harness-provider.ts) and speaks only ACP v2 to it. Harness and ACP\n// adapter definitions are ./harness-definition.ts.\n\nexport {\n HarnessComputeStatus,\n harnessEnvironmentSchema,\n harnessSettingsSchema,\n harnessUrlEnvironmentSchema,\n isUrlEnvironment,\n type HarnessEnvironmentIface,\n type HarnessSettingsIface,\n type HarnessUrlEnvironmentIface,\n type ResolvedHarnessSettingsIface,\n} from '@finalai/agent-protocol/agent-platform';\n\nexport enum AcpTransport {\n Relay = 'relay',\n Ws = 'ws',\n Http = 'http',\n Stdio = 'stdio',\n // A program the session service starts in a sandbox over the sandbox handle\n // RPC: ACP on its stdio, nothing listening on a port.\n Sandbox = 'sandbox',\n}\n\nexport enum McpTransportKind {\n Acp = 'acp',\n Http = 'http',\n Stdio = 'stdio',\n}\n\n// Wires a harness speaks to reach a provided sandbox.\nexport enum SandboxWire {\n HandleRpc = 'handle-rpc',\n Mcp = 'mcp',\n}\n\n// How a harness's model credential reaches it.\nexport enum CredentialDelivery {\n // Fetched from the broker's `model` route on every request.\n PerRequest = 'per-request',\n // Resolved once when the session opens and renewed through the grant's refresh route.\n AtOpen = 'at-open',\n}\n\n// What an accepted session/prompt does while the session is running. Both are valid; refusing one is a conformance failure.\nexport enum PromptWhileRunning {\n // Joins the running work: the model sees it at its next step.\n Inject = 'inject',\n // Runs after the current work goes idle; dropped by session/cancel if not started.\n Queue = 'queue',\n}\n\n// Defaults for a description that does not declare the hosting profile: the\n// session service then assumes nothing survives a dropped connection and that\n// a prompt while running waits for idle.\nexport const DEFAULT_PROMPT_WHILE_RUNNING = PromptWhileRunning.Queue;\nexport const DEFAULT_SESSION_SURVIVES_DISCONNECT = false;\n\nexport const harnessSessionRefSchema = z.object({\n // The harness's name, as harness settings name it.\n harness: z.string().min(1),\n // Opaque to the session service; the harness's own id for the session.\n harnessSessionRef: z.string().min(1),\n // Bumped whenever the harness loses state; a mismatch on resume means the\n // session service must re-seed with session/new.\n generation: z.number().int().nonnegative(),\n});\n\nexport type HarnessSessionRefIface = z.infer<typeof harnessSessionRefSchema>;\n\n// Route-scoped, short-lived grants: credential-routes.ts.\nexport {\n credentialRefreshRequestSchema,\n CredentialRoute,\n routeGrantSchema,\n type CredentialRefreshRequestIface,\n type RouteGrantIface,\n} from \"./credential-routes.mjs\";\n\nexport interface CredentialGrantIface {\n // Base URL of the broker routes (`<base>/model`, `<base>/refresh`, ...).\n brokerUrl: string;\n grants: RouteGrantIface[];\n // What the model grant resolved to, for harnesses that hand credentials over\n // at open (delivery 'at-open'). Null for per-request harnesses.\n atOpen: AtOpenModelCredentialIface | null;\n // How to renew this grant; null only when it carries no route grant.\n refresh: CredentialGrantRefreshIface | null;\n}\n\n// Renewal is pulled, never pushed. Per-request harnesses fetch\n// `<brokerUrl>/model` on every request. At-open harnesses (or their host)\n// POST `url` with `authorization: Bearer <token>` and a\n// `credentialRefreshRequestSchema` body before `expiresAt` and once after a\n// vendor 401; the answer is the grant's next generation (a\n// `credentialRefreshResultSchema` body with its own `refresh`), which replaces\n// this one. The broker resolves the policy again for it, so a disconnected\n// credential falls through; a revoked grant (every open revokes the previous\n// open's grants) or a closed harness session is refused (401).\nexport interface CredentialGrantRefreshIface {\n // `<brokerUrl>/refresh`.\n url: string;\n // One of this grant's own route grants (the model route's).\n token: string;\n harnessSessionId: string;\n // When `token` expires; a refresh after it is refused.\n expiresAt: string;\n}\n\nexport interface AtOpenModelCredentialIface {\n vendor: string;\n kind: InferenceSourceKind;\n // Base URL and bearer for an OpenAI- or Anthropic-compatible endpoint (the\n // platform proxy, a corporate gateway) or the vendor itself.\n baseUrl: string | null;\n apiKey: string | null;\n // Subscription material for Final-managed harnesses only (Claude setup token,\n // Codex app-server chatgptAuthTokens); renewed through the grant's refresh route.\n subscription: { format: 'claude-setup-token' | 'chatgpt-auth-tokens'; value: string } | null;\n fingerprint: string;\n}\n\nexport const atOpenModelCredentialSchema = z.object({\n vendor: z.string(),\n kind: z.nativeEnum(InferenceSourceKind),\n baseUrl: z.string().min(1).nullable(),\n apiKey: z.string().min(1).nullable(),\n subscription: z\n .object({\n format: z.union([z.literal('claude-setup-token'), z.literal('chatgpt-auth-tokens')]),\n value: z.string().min(1),\n })\n .nullable(),\n fingerprint: z.string(),\n}) satisfies z.ZodType<AtOpenModelCredentialIface>;\n\nexport const credentialGrantRefreshSchema = z.object({\n url: z.string().min(1),\n token: z.string().min(1),\n harnessSessionId: z.string().min(1),\n expiresAt: z.string(),\n}) satisfies z.ZodType<CredentialGrantRefreshIface>;\n\nexport const credentialGrantSchema = z.object({\n brokerUrl: z.string().min(1),\n grants: z.array(routeGrantSchema),\n atOpen: atOpenModelCredentialSchema.nullable(),\n refresh: credentialGrantRefreshSchema.nullable(),\n}) satisfies z.ZodType<CredentialGrantIface>;\n\n// An `http` MCP server entry the harness was handed in `session/new`\n// (`mcpServers`), with fresh headers. Same name and url; the harness swaps the\n// headers of the entry with that url.\nexport interface RenewedMcpServerIface {\n name: string;\n url: string;\n headers: { name: string; value: string }[];\n}\n\n// What a refresh answers: the grant's next generation, plus fresh copies of the\n// other short-lived material the harness was handed at open. Renewing the\n// `mcp` route renews the session's `http` MCP server headers; renewing\n// `sandbox` renews the compute endpoints' tokens.\nexport interface CredentialRefreshResultIface extends CredentialGrantIface {\n mcpServers: RenewedMcpServerIface[];\n compute: Partial<Record<Capability, SandboxEndpointIface>>;\n}\n\nconst endpointTokenSchema = z.object({\n url: z.string().min(1),\n token: z.string(),\n expiresAt: z.string(),\n});\n\nexport const sandboxEndpointSchema = z.object({\n sandboxId: z.string().min(1),\n bindingId: z.string().min(1),\n grant: sandboxGrantSchema,\n features: z.array(z.string()),\n rpc: endpointTokenSchema.nullable(),\n mcp: endpointTokenSchema.nullable(),\n}) satisfies z.ZodType<SandboxEndpointIface>;\n\nexport const renewedMcpServerSchema = z.object({\n name: z.string().min(1),\n url: z.string().min(1),\n headers: z.array(z.object({ name: z.string().min(1), value: z.string() })),\n}) satisfies z.ZodType<RenewedMcpServerIface>;\n\n// Absent renewals parse as none, so an answer without them still parses.\nexport const credentialRefreshResultSchema = credentialGrantSchema.extend({\n mcpServers: z.array(renewedMcpServerSchema).default([]),\n compute: z.partialRecord(z.nativeEnum(Capability), sandboxEndpointSchema).default({}),\n}) satisfies z.ZodType<CredentialRefreshResultIface, unknown>;\n\n// The refresh descriptor for a set of route grants: authenticated by the model\n// grant (else the first), due when that token expires.\nexport const grantRefreshFor = (args: {\n brokerUrl: string;\n harnessSessionId: string;\n grants: readonly RouteGrantIface[];\n}): CredentialGrantRefreshIface | null => {\n const grant =\n args.grants.find((candidate) => candidate.route === CredentialRoute.Model) ?? args.grants[0];\n if (grant == null) return null;\n return {\n url: `${args.brokerUrl.replace(/\\/+$/, '')}/refresh`,\n token: grant.token,\n harnessSessionId: args.harnessSessionId,\n expiresAt: grant.expiresAt,\n };\n};\n\nexport interface SecretReaderIface {\n get(name: string): Promise<string | null>;\n}\n\nexport interface TraceContextIface {\n traceparent: string | null;\n tracestate: string | null;\n}\n\n// A provided sandbox as the session service hands it to a harness, for one\n// capability: a stable per-session address that attaches the sandbox on the\n// first call, and the grant every call on it is held to. `files` and `shell`\n// share one sandbox and so one endpoint. Never a lease, a data-plane token for\n// a live machine, or provider code.\nexport interface SandboxEndpointIface {\n sandboxId: string;\n bindingId: string;\n grant: SandboxGrantIface;\n // Handle features the sandbox advertises (SandboxCapability), when known.\n features: string[];\n rpc: { url: string; token: string; expiresAt: string } | null;\n mcp: { url: string; token: string; expiresAt: string } | null;\n}\n\nexport interface HarnessSessionContextIface {\n sessionId: string;\n organizationId: string;\n projectId: string;\n // The agent document's content hash the session pins.\n agent: string;\n // The published agent it was started as; null for an agent passed as a value.\n definitionId: string | null;\n // Public base URL of the session service for this session (MCP over HTTP,\n // sandbox endpoints, the broker).\n sessionServiceUrl: string;\n // The region of the session service serving the session, so a harness can\n // run near it; null when unknown.\n sessionServiceRegion?: string | null;\n}\n\n// Lifecycle signals a harness implementation may report about the runtime\n// hosting a session (invocations, metering, traces). Informational: the\n// session service records them and never depends on them for correctness.\nexport interface HarnessObserverIface {\n // The runtime accepted the invocation request (its response began).\n invocationAccepted?(event: { invocationRef: string; at: string }): void;\n invocationStarted?(event: {\n invocationRef: string;\n at: string;\n bootMs: number | null;\n // The runtime's deployed version, for rollouts.\n versionId?: string | null;\n commitSha?: string | null;\n }): void;\n invocationKeepalive?(event: { invocationRef: string; at: string; activeWork: number }): void;\n invocationEnded?(event: {\n invocationRef: string;\n at: string;\n reason: string;\n error: string | null;\n metering: Record<string, number>;\n }): void;\n trace?(event: { name: string; at: string; fields: Record<string, JsonValue> }): void;\n}\n\nexport interface OpenHarnessSessionArgsIface {\n session: HarnessSessionContextIface;\n // The session service's id for this harness session; implementations key\n // their runtime state and route grants by it.\n harnessSessionId: string;\n // Hosting may authorize the child endpoint to fork this source through ACP.\n forkSource?: { ref: HarnessSessionRefIface; acpSessionId: string };\n observer?: HarnessObserverIface;\n // The agent: instructions, skills, tool policy and requirements.\n document: AgentDocumentIface;\n // The caller's harness settings, accepted by `accepts`, defaults applied.\n settings: ResolvedHarnessSettingsIface;\n // Already materialized ACP MCP server entries: the agent's own tools, the\n // provided integrations, sandbox MCP projections where applicable.\n mcpServers: McpServer[];\n // The provided sandbox for each capability the harness drives on one; a\n // capability served natively, or not provided, is absent.\n compute: Partial<Record<Capability, SandboxEndpointIface>>;\n credentials: CredentialGrantIface;\n secrets: SecretReaderIface;\n trace: TraceContextIface;\n}\n\nexport interface ResumeHarnessSessionArgsIface extends OpenHarnessSessionArgsIface {\n ref: HarnessSessionRefIface;\n // Last log seq the session service holds from this harness session; the\n // harness replays anything newer after session/resume.\n lastSeq: number;\n}\n\n// What the session service starts in a harness's environment sandbox: a\n// process, speaking ACP on its stdin and stdout, or a worker program, speaking\n// ACP on its stream. Both run over the sandbox handle RPC; nothing listens on\n// a port.\nexport const sandboxProcessStartSchema = z.strictObject({\n runtime: z.literal(RuntimeKind.Process),\n command: z.string().min(1),\n args: z.array(z.string()).default([]),\n env: z.record(z.string(), z.string()).default({}),\n cwd: z.string().min(1).optional(),\n});\n\nexport const sandboxWorkerStartSchema = z.strictObject({\n runtime: z.literal(RuntimeKind.Worker),\n program: z.string().min(1),\n env: z.record(z.string(), z.string()).default({}),\n // Handed to the program when it starts.\n input: jsonValueSchema.default(null),\n});\n\nexport const sandboxStartSchema = z.discriminatedUnion('runtime', [\n sandboxProcessStartSchema,\n sandboxWorkerStartSchema,\n]);\n\nexport type SandboxStartIface = z.output<typeof sandboxStartSchema>;\nexport type SandboxStartInputIface = z.input<typeof sandboxStartSchema>;\n\n// Resolved only in memory; refs retain secret names, never TLS keys.\nexport interface HarnessClientTlsIface {\n cert: string;\n key: string;\n ca?: string;\n}\n\nexport type HarnessEndpointIface =\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Ws;\n url: string;\n headers: Record<string, string>;\n resolveHeaders?: () => Promise<Record<string, string>>;\n tls?: HarnessClientTlsIface;\n }\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Http;\n url: string;\n headers: Record<string, string>;\n resolveHeaders?: () => Promise<Record<string, string>>;\n tls?: HarnessClientTlsIface;\n }\n // A relay channel the runtime answers on.\n | { ref: HarnessSessionRefIface; transport: AcpTransport.Relay; channel: string; token: string }\n // A program the session service starts in a sandbox; ACP on its stdio.\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Sandbox;\n sandboxId: string;\n start: SandboxStartIface;\n }\n // Local development, CI and conformance only.\n | {\n ref: HarnessSessionRefIface;\n transport: AcpTransport.Stdio;\n command: string;\n args: string[];\n env: Record<string, string>;\n };\n\nexport interface HarnessHealthIface {\n ok: boolean;\n detail?: string;\n checkedAt: string;\n}\n\n// The settings a call is about and the project's secrets (a remote harness's\n// client certificate, by name).\nexport interface HarnessCallContextIface {\n settings: ResolvedHarnessSettingsIface;\n secrets: SecretReaderIface;\n}\n\n// A harness as a driver reaches it (the session service, the conformance\n// kit): what it is, as its definition says (configuration schema, features,\n// MCP transports, prompt-while-running, session survival), and its session\n// lifecycle.\nexport interface HarnessIface {\n definition: HarnessDefinitionIface;\n open(args: OpenHarnessSessionArgsIface): Promise<HarnessEndpointIface>;\n resume(args: ResumeHarnessSessionArgsIface): Promise<HarnessEndpointIface>;\n park(ref: HarnessSessionRefIface): Promise<void>;\n // Graceful by default: the program's state is durable (resumable) before it\n // stops, bounded by the implementation's timeout, then forced. `force` skips\n // the wait; the session service passes it when the program did not settle\n // ACP `session/close` within its bound.\n close(ref: HarnessSessionRefIface, opts?: CloseHarnessSessionOptsIface): Promise<void>;\n health(\n ref: HarnessSessionRefIface,\n context?: HarnessCallContextIface,\n ): Promise<HarnessHealthIface>;\n}\n\nexport interface CloseHarnessSessionOptsIface {\n force?: boolean;\n // As with health, retained refs can resolve current client TLS without storing keys in the ref.\n context?: HarnessCallContextIface;\n}\n"],
5
5
  "mappings": "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",
6
6
  "names": ["AcpTransport", "McpTransportKind", "SandboxWire", "CredentialDelivery", "PromptWhileRunning", "CredentialRoute", "routeGrantSchema"]
7
7
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@finalai/agent-provider",
3
- "version": "0.19.0",
3
+ "version": "0.20.1",
4
4
  "private": false,
5
5
  "description": "Provider contracts for the agent stack: the agent document, requirements and inference, harnesses, sandboxes (handle, wire, grants, setups, MCP projection), the code host, channels, and the conformance kit.",
6
6
  "license": "Apache-2.0",
@@ -241,12 +241,12 @@
241
241
  "registry": "https://registry.npmjs.org/"
242
242
  },
243
243
  "dependencies": {
244
- "@agentclientprotocol/sdk": "1.8.0",
245
- "@finalai/acp-session": "0.9.2",
246
- "@finalai/agent-protocol": "0.22.0",
244
+ "@agentclientprotocol/sdk": "2.7.0",
245
+ "@finalai/acp-session": "0.10.1",
246
+ "@finalai/agent-protocol": "0.23.0",
247
247
  "@modelcontextprotocol/client": "^2.1.0",
248
248
  "@modelcontextprotocol/core": "^2.1.0",
249
- "@modelcontextprotocol/server": "^2.1.0",
249
+ "@modelcontextprotocol/server": "^2.4.0",
250
250
  "json-schema-library": "11.6.5",
251
251
  "re2js": "2.8.6",
252
252
  "zod": "4.6.6"