@finalai/agent-provider 0.6.0 → 0.8.0

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.
Files changed (38) hide show
  1. package/HOSTING.md +3 -3
  2. package/README.md +47 -14
  3. package/dist/modules/channel.d.mts +102 -40
  4. package/dist/modules/channel.mjs +29 -1
  5. package/dist/modules/channel.mjs.map +3 -3
  6. package/dist/modules/conformance/sandbox-kit.d.mts +1 -0
  7. package/dist/modules/conformance/sandbox-kit.mjs +174 -0
  8. package/dist/modules/conformance/sandbox-kit.mjs.map +3 -3
  9. package/dist/modules/index.d.mts +1 -0
  10. package/dist/modules/index.mjs +1 -0
  11. package/dist/modules/index.mjs.map +2 -2
  12. package/dist/modules/local-channel-context.d.mts +3 -3
  13. package/dist/modules/local-channel-context.mjs +25 -14
  14. package/dist/modules/local-channel-context.mjs.map +2 -2
  15. package/dist/modules/manifest.d.mts +18 -14
  16. package/dist/modules/manifest.mjs +11 -5
  17. package/dist/modules/manifest.mjs.map +2 -2
  18. package/dist/modules/room-surface.d.mts +17 -32
  19. package/dist/modules/room-surface.mjs +12 -12
  20. package/dist/modules/room-surface.mjs.map +3 -3
  21. package/dist/modules/sandbox/client.mjs +108 -27
  22. package/dist/modules/sandbox/client.mjs.map +3 -3
  23. package/dist/modules/sandbox/convenience.mjs +1 -1
  24. package/dist/modules/sandbox/convenience.mjs.map +2 -2
  25. package/dist/modules/sandbox/execution-guard.d.mts +1 -0
  26. package/dist/modules/sandbox/execution-guard.mjs +9 -0
  27. package/dist/modules/sandbox/execution-guard.mjs.map +2 -2
  28. package/dist/modules/sandbox/memory-sandbox.mjs +8 -0
  29. package/dist/modules/sandbox/memory-sandbox.mjs.map +2 -2
  30. package/dist/modules/sandbox/server.mjs +87 -14
  31. package/dist/modules/sandbox/server.mjs.map +3 -3
  32. package/dist/modules/sandbox/types.d.mts +21 -1
  33. package/dist/modules/sandbox/types.mjs +1 -0
  34. package/dist/modules/sandbox/types.mjs.map +2 -2
  35. package/dist/modules/sandbox/wire.d.mts +40 -0
  36. package/dist/modules/sandbox/wire.mjs +32 -2
  37. package/dist/modules/sandbox/wire.mjs.map +2 -2
  38. package/package.json +2 -2
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/conformance/sandbox-kit.ts"],
4
- "sourcesContent": ["import type { JsonValue } from \"../json.mjs\";\nimport { SandboxAccess } from \"../manifest.mjs\";\nimport { readAllBytes } from \"../sandbox/bytes.mjs\";\nimport { streamToString } from \"../sandbox/convenience.mjs\";\nimport { createInMemoryHandleNetwork } from \"../sandbox/testing.mjs\";\nimport {\n NetworkPolicy,\n noSandboxActingUser,\n noSandboxGuides,\n noSandboxRepositories,\n noSandboxVariables,\n SandboxEntryType,\n type AnySandboxProviderIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxPrepareContextIface,\n type SandboxProviderHandleIface,\n type SandboxStartContextIface,\n} from \"../sandbox/types.mjs\";\nimport { HandleRpcErrorCode, isHandleRpcError } from \"../sandbox/wire.mjs\";\nimport { ConformanceCaseStatus, type ConformanceCaseResultIface } from \"./harness-kit.mjs\";\n\n// Sandbox conformance: files, streams with\n// multi-megabyte content, ranged reads, process I/O and kill, run directly on\n// the handle and again through the handle RPC (client and server over an\n// in-memory connection), plus the server's read-only access policy. Commands\n// used: echo, cat, sleep and `exit` under `shell: true`, and printenv for the\n// platform environment cases. A provider start also checks that awaitRunning\n// resolves for the sandbox it started.\n\nexport interface RunSandboxConformanceArgsIface {\n // Either a started handle, or a provider the kit prepares and starts.\n handle?: NetworkSandboxSessionIface;\n provider?: AnySandboxProviderIface;\n environmentOptions?: JsonValue;\n openOptions?: JsonValue;\n prepareContext?: Partial<SandboxPrepareContextIface>;\n startContext?: Partial<SandboxStartContextIface>;\n // Also run the cases through the handle RPC (default true).\n viaWire?: boolean;\n largeFileBytes?: number;\n timeoutMs?: number;\n // Also run the platform environment cases, on sandboxes of their own (needs `provider`).\n platform?: SandboxPlatformConformanceIface;\n}\n\n// How the platform environment cases declare a spec for the provider under test.\nexport interface SandboxPlatformConformanceIface {\n // Environment options whose spec sets `env` as plain variables for every\n // process and, when `allow` is given, an allowlist egress policy of those hosts.\n environmentOptions(args: { env: Record<string, string>; allow?: string[] }): JsonValue;\n // The allowlist the provider gave its backend for this sandbox. Absent: the\n // egress hosts and network policy report cases are skipped.\n observedAllowlist?(sandbox: NetworkSandboxSessionIface): Promise<readonly string[] | null>;\n}\n\nexport interface SandboxConformanceReportIface {\n passed: boolean;\n cases: ConformanceCaseResultIface[];\n}\n\ninterface StartedProviderIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface> | null;\n // The provider's awaitRunning for the sandbox it started.\n awaitRunning?: (timeoutMs: number) => Promise<void>;\n}\n\ninterface ProviderStartIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface>;\n awaitRunning: (timeoutMs: number) => Promise<void>;\n}\n\nconst check = (condition: boolean, message: string) => {\n if (!condition) throw new Error(message);\n};\n\nconst patternBytes = (size: number, seed: number): Uint8Array => {\n const bytes = new Uint8Array(size);\n let state = seed >>> 0;\n for (let i = 0; i < size; i += 1) {\n state = (Math.imul(state, 1664525) + 1013904223) >>> 0;\n bytes[i] = state >>> 24;\n }\n return bytes;\n};\n\nconst chunked = (bytes: Uint8Array, chunk: number): ReadableStream<Uint8Array> => {\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= bytes.byteLength) {\n controller.close();\n return;\n }\n controller.enqueue(bytes.slice(offset, offset + chunk));\n offset += chunk;\n },\n });\n};\n\nconst sameBytes = (a: Uint8Array, b: Uint8Array) =>\n a.byteLength === b.byteLength && a.every((value, i) => value === b[i]);\n\nconst withTimeout = async <T>(promise: Promise<T>, ms: number, what: string): Promise<T> => {\n let timer: ReturnType<typeof setTimeout> | null = null;\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error(`${what} timed out after ${ms} ms`)), ms);\n }),\n ]);\n } finally {\n if (timer != null) clearTimeout(timer);\n }\n};\n\ntype SandboxCase = {\n name: string;\n run: (sandbox: NetworkSandboxSessionIface, root: string) => Promise<string | void>;\n};\n\nconst sandboxCases = (largeFileBytes: number): SandboxCase[] => [\n {\n name: 'describe',\n run: async (sandbox) => {\n check(sandbox.id.length > 0, 'empty id');\n check(\n sandbox.defaultWorkingDirectory.startsWith('/'),\n 'defaultWorkingDirectory is not absolute',\n );\n check(\n sandbox.resolvePath('a/b') === `${sandbox.defaultWorkingDirectory.replace(/\\/$/, '')}/a/b`,\n 'resolvePath',\n );\n },\n },\n {\n name: 'text files',\n run: async (sandbox, root) => {\n const path = `${root}/nested/dir/a.txt`;\n await sandbox.writeTextFile({ path, content: 'first' });\n await sandbox.writeTextFile({ path, content: 'h\u00E9llo\\n' });\n check((await sandbox.readTextFile({ path })) === 'h\u00E9llo\\n', 'text round trip');\n check(\n (await sandbox.readTextFile({ path: `${root}/missing.txt` })) == null,\n 'missing text file is not null',\n );\n check(\n (await sandbox.readFile({ path: `${root}/missing.txt` })) == null,\n 'missing file stream is not null',\n );\n },\n },\n {\n name: 'ranged reads',\n run: async (sandbox, root) => {\n const path = `${root}/lines.txt`;\n await sandbox.writeTextFile({ path, content: 'l1\\nl2\\nl3\\nl4\\n' });\n check(\n (await sandbox.readTextFile({ path, startLine: 2, endLine: 3 })) === 'l2\\nl3\\n',\n 'lines 2-3',\n );\n check(\n (await sandbox.readTextFile({ path, startLine: 4, endLine: 99 })) === 'l4\\n',\n 'endLine past EOF',\n );\n },\n },\n {\n name: 'multi-megabyte streams',\n run: async (sandbox, root) => {\n const path = `${root}/large.bin`;\n const content = patternBytes(largeFileBytes, largeFileBytes);\n await sandbox.writeFile({ path, content: chunked(content, 300_000) });\n const stream = await sandbox.readFile({ path });\n check(stream != null, 'large file not found');\n if (stream == null) return;\n check(sameBytes(await readAllBytes(stream), content), 'streamed bytes differ');\n const binary = await sandbox.readBinaryFile({ path });\n check(binary != null && sameBytes(binary, content), 'readBinaryFile differs');\n const small = patternBytes(1000, 7);\n await sandbox.writeBinaryFile({ path: `${root}/small.bin`, content: small });\n const back = await sandbox.readBinaryFile({ path: `${root}/small.bin` });\n check(back != null && sameBytes(back, small), 'binary round trip');\n return `${largeFileBytes} bytes`;\n },\n },\n {\n name: 'stat, readDir, removePath',\n run: async (sandbox, root) => {\n await sandbox.writeTextFile({ path: `${root}/tree/x.txt`, content: 'xyz' });\n await sandbox.writeTextFile({ path: `${root}/tree/sub/y.txt`, content: 'y' });\n const stat = await sandbox.stat({ path: `${root}/tree/x.txt` });\n check(stat?.type === SandboxEntryType.File && stat.size === 3, 'file stat');\n check(\n (await sandbox.stat({ path: `${root}/tree` }))?.type === SandboxEntryType.Directory,\n 'directory stat',\n );\n check(\n (await sandbox.stat({ path: `${root}/tree/none` })) == null,\n 'missing stat is not null',\n );\n const names = (await sandbox.readDir({ path: `${root}/tree` }))\n .map((entry) => entry.name)\n .sort();\n check(\n JSON.stringify(names) === JSON.stringify(['sub', 'x.txt']),\n `readDir returned ${names.join(',')}`,\n );\n await sandbox.removePath({ path: `${root}/tree/none`, force: true });\n await sandbox.removePath({ path: `${root}/tree`, recursive: true });\n check(\n (await sandbox.stat({ path: `${root}/tree/x.txt` })) == null,\n 'recursive remove left files',\n );\n },\n },\n {\n name: 'process output and exit codes',\n run: async (sandbox) => {\n const echo = await sandbox.run({ command: 'echo', args: ['hello', 'world'] });\n check(\n echo.exitCode === 0 && echo.stdout === 'hello world\\n',\n `echo: ${JSON.stringify(echo)}`,\n );\n const shell = await sandbox.run({ command: 'echo out; echo err >&2; exit 3', shell: true });\n check(\n shell.exitCode === 3 && shell.stdout === 'out\\n' && shell.stderr === 'err\\n',\n `shell: ${JSON.stringify(shell)}`,\n );\n },\n },\n {\n name: 'process stdin',\n run: async (sandbox) => {\n const piped = await sandbox.run({ command: 'cat', stdin: 'from stdin' });\n check(piped.stdout === 'from stdin', `run stdin: ${JSON.stringify(piped)}`);\n const cat = await sandbox.spawn({ command: 'cat' });\n const output = streamToString(cat.stdout);\n await cat.write('a');\n await cat.write('b', { end: true });\n check((await output) === 'ab', 'spawned cat echoed wrong data');\n check((await cat.wait()).exitCode === 0, 'cat exit code');\n },\n },\n {\n name: 'process kill',\n run: async (sandbox) => {\n const sleeper = await sandbox.spawn({ command: 'sleep', args: ['30'] });\n await sleeper.kill();\n const result = await withTimeout(sleeper.wait(), 5_000, 'wait after kill');\n check(result.exitCode !== 0, 'killed process exited 0');\n },\n },\n];\n\nconst startFromProvider = async (\n args: RunSandboxConformanceArgsIface,\n provider: AnySandboxProviderIface,\n overrides: {\n environmentOptions?: JsonValue;\n startContext?: Partial<SandboxStartContextIface>;\n // A binding (and so a sandbox) of its own, whatever session the caller's context names.\n ownBinding?: boolean;\n } = {},\n): Promise<ProviderStartIface> => {\n const implementation = provider.definition.environment(\n overrides.environmentOptions ?? args.environmentOptions,\n );\n const prepareContext: SandboxPrepareContextIface = {\n files: {},\n resources: {},\n sourceRevision: 'conformance',\n storagePath: '/tmp/final-conformance',\n organizationId: 'conformance',\n guides: noSandboxGuides,\n actingUser: noSandboxActingUser,\n ...args.prepareContext,\n };\n const artifact = await implementation.prepare(prepareContext);\n const startContext: SandboxStartContextIface = {\n session: {\n id: crypto.randomUUID(),\n organizationId: 'conformance',\n conversationId: null,\n definitionId: 'conformance',\n bindingId: crypto.randomUUID(),\n target: 'conformance',\n },\n storagePath: '/tmp/final-conformance',\n guides: noSandboxGuides,\n variables: noSandboxVariables,\n repositories: noSandboxRepositories,\n actingUser: noSandboxActingUser,\n platformNetworkPolicy: async () => undefined,\n ...args.startContext,\n ...overrides.startContext,\n };\n if (overrides.ownBinding === true) {\n startContext.session = {\n ...startContext.session,\n id: crypto.randomUUID(),\n bindingId: crypto.randomUUID(),\n conversationId: null,\n };\n }\n const { handle, state } = await implementation.start(startContext, args.openOptions, artifact);\n return {\n handle,\n awaitRunning: (timeoutMs) => implementation.awaitRunning(startContext, state, { timeoutMs }),\n };\n};\n\nconst PLATFORM_VARIABLE = 'FINAL_CONFORMANCE_PLATFORM';\nconst SPEC_VARIABLE = 'FINAL_CONFORMANCE_SPEC';\nconst SHARED_VARIABLE = 'FINAL_CONFORMANCE_SHARED';\nconst SPEC_ENV = { [SPEC_VARIABLE]: 'spec', [SHARED_VARIABLE]: 'spec' };\nconst SPEC_ALLOW = ['conformance.example.com'];\nconst PLATFORM_EGRESS_HOSTS = ['egress.conformance.example.com'];\n\n// A variable as a spawned process sees it; null when unset.\nconst variableIn = async (\n sandbox: NetworkSandboxSessionIface,\n name: string,\n): Promise<string | null> => {\n const process = await sandbox.spawn({ command: 'printenv', args: [name] });\n const [stdout, { exitCode }] = await Promise.all([\n streamToString(process.stdout),\n process.wait(),\n ]);\n return exitCode === 0 ? stdout.replace(/\\n$/, '') : null;\n};\n\nconst expectVariables = async (\n sandbox: NetworkSandboxSessionIface,\n expected: Record<string, string | null>,\n) => {\n for (const [name, value] of Object.entries(expected)) {\n const actual = await variableIn(sandbox, name);\n check(\n actual === value,\n `${name} is ${JSON.stringify(actual)}, expected ${JSON.stringify(value)}`,\n );\n }\n};\n\ntype RecordCase = (name: string, run: () => Promise<string | void>) => Promise<void>;\n\n// The start context's platformFiles are written before any process runs;\n// platformEnvironment reaches every process, read again for each one and over\n// the spec's env; platformEgressHosts join an allowlist, and the policy is\n// reported through platformNetworkPolicy before platformFiles are written (a\n// rejected report fails the start); a spec naming a platform variable is refused.\nconst runPlatformCases = async (args: {\n kit: RunSandboxConformanceArgsIface;\n provider: AnySandboxProviderIface;\n platform: SandboxPlatformConformanceIface;\n record: RecordCase;\n skip: (name: string, detail: string) => void;\n}) => {\n const { kit, provider, platform, record } = args;\n let platformValues: Record<string, string> = {\n [PLATFORM_VARIABLE]: 'first',\n [SHARED_VARIABLE]: 'platform',\n };\n const filePath = `/tmp/final-conformance-${crypto.randomUUID().slice(0, 8)}/platform/ca.pem`;\n const order: string[] = [];\n const withPlatform: StartedProviderIface = { handle: null };\n await record('platform environment: provider start', async () => {\n ({ handle: withPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV }),\n startContext: {\n platformFiles: async () => {\n order.push('files');\n return { [filePath]: 'conformance CA\\n' };\n },\n platformEnvironment: async () => {\n order.push('environment');\n return { ...platformValues };\n },\n },\n ownBinding: true,\n }));\n });\n const sandbox = withPlatform.handle?.sandbox;\n if (sandbox != null) {\n try {\n await record('platform files: written before any process', async () => {\n check(\n order.indexOf('files') === 0,\n `platformEnvironment was read before platformFiles: ${order.join(', ')}`,\n );\n const content = await sandbox.readTextFile({ path: filePath });\n check(content === 'conformance CA\\n', `${filePath} holds ${JSON.stringify(content)}`);\n });\n await record('platform environment: reaches spawned processes', async () => {\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'first' });\n const run = await sandbox.run({ command: 'printenv', args: [PLATFORM_VARIABLE] });\n check(run.stdout === 'first\\n', `run saw ${JSON.stringify(run.stdout)}`);\n });\n await record('platform environment: read again for every process', async () => {\n platformValues = { ...platformValues, [PLATFORM_VARIABLE]: 'second' };\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'second' });\n });\n await record('platform environment: overrides the spec env', async () => {\n await expectVariables(sandbox, { [SHARED_VARIABLE]: 'platform', [SPEC_VARIABLE]: 'spec' });\n });\n await record('platform environment: {} leaves the spec env', async () => {\n platformValues = {};\n await expectVariables(sandbox, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n });\n });\n } finally {\n await withPlatform.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n }\n }\n\n const withoutPlatform: StartedProviderIface = { handle: null };\n const reported: NetworkPolicyIface[] = [];\n const reportOrder: string[] = [];\n const allowlistContext = (\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>,\n ): Partial<SandboxStartContextIface> => ({\n platformEnvironment: undefined,\n platformEgressHosts: PLATFORM_EGRESS_HOSTS,\n platformNetworkPolicy,\n platformFiles: async () => {\n reportOrder.push('files');\n return {};\n },\n });\n await record('platform environment: provider start without it', async () => {\n ({ handle: withoutPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async (policy) => {\n reportOrder.push('policy');\n reported.push(policy);\n }),\n ownBinding: true,\n }));\n });\n const plain = withoutPlatform.handle?.sandbox;\n if (plain != null) {\n try {\n await record('platform environment: absent leaves the spec env', () =>\n expectVariables(plain, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n }),\n );\n const observe = platform.observedAllowlist;\n if (observe == null) {\n args.skip('platform egress hosts: appended to an allowlist', 'no observedAllowlist');\n args.skip('platform network policy: reported as applied', 'no observedAllowlist');\n } else {\n await record('platform egress hosts: appended to an allowlist', async () => {\n const allow = (await observe(plain)) ?? [];\n for (const host of [...SPEC_ALLOW, ...PLATFORM_EGRESS_HOSTS])\n check(allow.includes(host), `allowlist ${JSON.stringify(allow)} lacks ${host}`);\n });\n await record('platform network policy: reported as applied', async () => {\n const last = reported.at(-1);\n check(\n last?.mode === NetworkPolicy.Allowlist,\n `reported ${JSON.stringify(reported)}, expected an allowlist`,\n );\n const applied = [...((await observe(plain)) ?? [])].sort();\n const allow = [...(last?.allow ?? [])].sort();\n check(\n JSON.stringify(allow) === JSON.stringify(applied),\n `reported ${JSON.stringify(allow)}, applied ${JSON.stringify(applied)}`,\n );\n check(\n reportOrder.indexOf('policy') < reportOrder.indexOf('files'),\n `platformFiles were written before the policy was reported: ${reportOrder.join(', ')}`,\n );\n });\n }\n } finally {\n await withoutPlatform.handle\n ?.onSandboxDelete({ reason: 'conformance' })\n .catch(() => undefined);\n }\n }\n\n if (platform.observedAllowlist == null) {\n args.skip('platform network policy: a rejected report fails the start', 'no observedAllowlist');\n } else {\n await record('platform network policy: a rejected report fails the start', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async () => {\n throw new Error('conformance: the policy was not recorded');\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a start whose policy report failed returned a sandbox');\n });\n }\n\n await record('platform environment: reserved names refused', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({\n env: { HTTPS_PROXY: 'http://spec.example.com' },\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a spec setting HTTPS_PROXY started');\n });\n};\n\nexport const runSandboxConformance = async (\n args: RunSandboxConformanceArgsIface,\n): Promise<SandboxConformanceReportIface> => {\n const timeoutMs = args.timeoutMs ?? 30_000;\n const cases: ConformanceCaseResultIface[] = [];\n const record: RecordCase = async (name, run) => {\n const started = Date.now();\n try {\n const detail = await withTimeout(run(), timeoutMs, name);\n cases.push({\n name,\n status: ConformanceCaseStatus.Passed,\n durationMs: Date.now() - started,\n error: null,\n detail: detail ?? null,\n });\n } catch (error) {\n cases.push({\n name,\n status: ConformanceCaseStatus.Failed,\n durationMs: Date.now() - started,\n error: error instanceof Error ? error.message : String(error),\n detail: null,\n });\n }\n };\n\n // A holder, so the assignment inside the closure is visible to the narrowing.\n const started: StartedProviderIface = { handle: null };\n let sandbox = args.handle ?? null;\n if (sandbox == null) {\n if (args.provider == null)\n throw new Error('runSandboxConformance needs a handle or a provider');\n const provider = args.provider;\n await record('provider start', async () => {\n ({ handle: started.handle, awaitRunning: started.awaitRunning } = await startFromProvider(\n args,\n provider,\n ));\n });\n const awaitRunning = started.awaitRunning;\n if (awaitRunning != null)\n await record('provider awaitRunning: resolves for a started sandbox', () =>\n awaitRunning(timeoutMs),\n );\n sandbox = started.handle?.sandbox ?? null;\n }\n if (sandbox == null) return { passed: false, cases };\n const target = sandbox;\n\n const root = target.resolvePath(`conformance-${crypto.randomUUID().slice(0, 8)}`);\n const list = sandboxCases(args.largeFileBytes ?? 5 * 1024 * 1024);\n for (const entry of list) await record(entry.name, () => entry.run(target, root));\n\n if (args.viaWire !== false) {\n const network = createInMemoryHandleNetwork();\n network.serve({ url: 'mem://conformance', sandbox: target });\n network.serve({\n url: 'mem://conformance-read',\n sandbox: target,\n access: { mode: SandboxAccess.Read, lifecycle: false },\n });\n const client = await network.connect({ url: 'mem://conformance', token: 'conformance' });\n try {\n const wireRoot = `${root}-wire`;\n for (const entry of list)\n await record(`handle rpc: ${entry.name}`, () => entry.run(client, wireRoot));\n await record('handle rpc: read-only access policy', async () => {\n const readOnly = await network.connect({\n url: 'mem://conformance-read',\n token: 'conformance',\n });\n try {\n await target.writeTextFile({ path: `${root}/ro.txt`, content: 'visible' });\n check(\n (await readOnly.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'read failed on a read binding',\n );\n const attempts: [string, Promise<unknown>][] = [\n [\n 'writeTextFile',\n readOnly.writeTextFile({ path: `${root}/ro.txt`, content: 'changed' }),\n ],\n ['run', readOnly.run({ command: 'echo' })],\n ['spawn', readOnly.spawn({ command: 'echo' })],\n ['removePath', readOnly.removePath({ path: `${root}/ro.txt` })],\n ];\n for (const [what, attempt] of attempts) {\n const error = await attempt.then(\n () => null,\n (cause: unknown) => cause,\n );\n check(\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Forbidden,\n `${what} was not rejected`,\n );\n }\n check(\n (await target.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'a read binding changed the file',\n );\n } finally {\n readOnly.close();\n }\n });\n } finally {\n client.close();\n await target\n .removePath({ path: `${root}-wire`, recursive: true, force: true })\n .catch(() => undefined);\n }\n }\n\n await target.removePath({ path: root, recursive: true, force: true }).catch(() => undefined);\n await started.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n\n if (args.platform != null && args.provider != null) {\n await runPlatformCases({\n kit: args,\n provider: args.provider,\n platform: args.platform,\n record,\n skip: (name, detail) =>\n cases.push({\n name,\n status: ConformanceCaseStatus.Skipped,\n durationMs: 0,\n error: null,\n detail,\n }),\n });\n }\n return { passed: cases.every((entry) => entry.status !== ConformanceCaseStatus.Failed), cases };\n};\n"],
5
- "mappings": "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",
6
- "names": ["started"]
4
+ "sourcesContent": ["import type { JsonValue } from \"../json.mjs\";\nimport { SandboxAccess } from \"../manifest.mjs\";\nimport { readAllBytes } from \"../sandbox/bytes.mjs\";\nimport { streamToString } from \"../sandbox/convenience.mjs\";\nimport type { SandboxClientIface } from \"../sandbox/client.mjs\";\nimport { createInMemoryHandleNetwork } from \"../sandbox/testing.mjs\";\nimport {\n NetworkPolicy,\n noSandboxActingUser,\n noSandboxGuides,\n noSandboxRepositories,\n noSandboxVariables,\n SandboxEntryType,\n type AnySandboxProviderIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxPrepareContextIface,\n type SandboxProviderHandleIface,\n type SandboxStartContextIface,\n} from \"../sandbox/types.mjs\";\nimport { HandleRpcErrorCode, isHandleRpcError } from \"../sandbox/wire.mjs\";\nimport { ConformanceCaseStatus, type ConformanceCaseResultIface } from \"./harness-kit.mjs\";\n\n// Sandbox conformance: files, streams with\n// multi-megabyte content, ranged reads, process I/O and kill, run directly on\n// the handle and again through the handle RPC (client and server over an\n// in-memory connection), plus the server's read-only access policy. Commands\n// used: echo, cat, sleep and `exit` under `shell: true`, and printenv for the\n// platform environment cases. A provider start also checks that awaitRunning\n// resolves for the sandbox it started. A sandbox with durable processes\n// (`attachProcess`) also runs the durable cases, directly (dropping a handle by\n// aborting its signal) and through the handle RPC (by closing the connection);\n// they use DURABLE_CONFORMANCE_SCRIPT and `sleep 30` under `shell: true`.\n\nexport interface RunSandboxConformanceArgsIface {\n // Either a started handle, or a provider the kit prepares and starts.\n handle?: NetworkSandboxSessionIface;\n provider?: AnySandboxProviderIface;\n environmentOptions?: JsonValue;\n openOptions?: JsonValue;\n prepareContext?: Partial<SandboxPrepareContextIface>;\n startContext?: Partial<SandboxStartContextIface>;\n // Also run the cases through the handle RPC (default true).\n viaWire?: boolean;\n largeFileBytes?: number;\n timeoutMs?: number;\n // Also run the platform environment cases, on sandboxes of their own (needs `provider`).\n platform?: SandboxPlatformConformanceIface;\n}\n\n// How the platform environment cases declare a spec for the provider under test.\nexport interface SandboxPlatformConformanceIface {\n // Environment options whose spec sets `env` as plain variables for every\n // process and, when `allow` is given, an allowlist egress policy of those hosts.\n environmentOptions(args: { env: Record<string, string>; allow?: string[] }): JsonValue;\n // The allowlist the provider gave its backend for this sandbox. Absent: the\n // egress hosts and network policy report cases are skipped.\n observedAllowlist?(sandbox: NetworkSandboxSessionIface): Promise<readonly string[] | null>;\n}\n\nexport interface SandboxConformanceReportIface {\n passed: boolean;\n cases: ConformanceCaseResultIface[];\n}\n\ninterface StartedProviderIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface> | null;\n // The provider's awaitRunning for the sandbox it started.\n awaitRunning?: (timeoutMs: number) => Promise<void>;\n}\n\ninterface ProviderStartIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface>;\n awaitRunning: (timeoutMs: number) => Promise<void>;\n}\n\nconst check = (condition: boolean, message: string) => {\n if (!condition) throw new Error(message);\n};\n\nconst patternBytes = (size: number, seed: number): Uint8Array => {\n const bytes = new Uint8Array(size);\n let state = seed >>> 0;\n for (let i = 0; i < size; i += 1) {\n state = (Math.imul(state, 1664525) + 1013904223) >>> 0;\n bytes[i] = state >>> 24;\n }\n return bytes;\n};\n\nconst chunked = (bytes: Uint8Array, chunk: number): ReadableStream<Uint8Array> => {\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= bytes.byteLength) {\n controller.close();\n return;\n }\n controller.enqueue(bytes.slice(offset, offset + chunk));\n offset += chunk;\n },\n });\n};\n\nconst sameBytes = (a: Uint8Array, b: Uint8Array) =>\n a.byteLength === b.byteLength && a.every((value, i) => value === b[i]);\n\nconst withTimeout = async <T>(promise: Promise<T>, ms: number, what: string): Promise<T> => {\n let timer: ReturnType<typeof setTimeout> | null = null;\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error(`${what} timed out after ${ms} ms`)), ms);\n }),\n ]);\n } finally {\n if (timer != null) clearTimeout(timer);\n }\n};\n\ntype SandboxCase = {\n name: string;\n run: (sandbox: NetworkSandboxSessionIface, root: string) => Promise<string | void>;\n};\n\nconst sandboxCases = (largeFileBytes: number): SandboxCase[] => [\n {\n name: 'describe',\n run: async (sandbox) => {\n check(sandbox.id.length > 0, 'empty id');\n check(\n sandbox.defaultWorkingDirectory.startsWith('/'),\n 'defaultWorkingDirectory is not absolute',\n );\n check(\n sandbox.resolvePath('a/b') === `${sandbox.defaultWorkingDirectory.replace(/\\/$/, '')}/a/b`,\n 'resolvePath',\n );\n },\n },\n {\n name: 'text files',\n run: async (sandbox, root) => {\n const path = `${root}/nested/dir/a.txt`;\n await sandbox.writeTextFile({ path, content: 'first' });\n await sandbox.writeTextFile({ path, content: 'h\u00E9llo\\n' });\n check((await sandbox.readTextFile({ path })) === 'h\u00E9llo\\n', 'text round trip');\n check(\n (await sandbox.readTextFile({ path: `${root}/missing.txt` })) == null,\n 'missing text file is not null',\n );\n check(\n (await sandbox.readFile({ path: `${root}/missing.txt` })) == null,\n 'missing file stream is not null',\n );\n },\n },\n {\n name: 'ranged reads',\n run: async (sandbox, root) => {\n const path = `${root}/lines.txt`;\n await sandbox.writeTextFile({ path, content: 'l1\\nl2\\nl3\\nl4\\n' });\n check(\n (await sandbox.readTextFile({ path, startLine: 2, endLine: 3 })) === 'l2\\nl3\\n',\n 'lines 2-3',\n );\n check(\n (await sandbox.readTextFile({ path, startLine: 4, endLine: 99 })) === 'l4\\n',\n 'endLine past EOF',\n );\n },\n },\n {\n name: 'multi-megabyte streams',\n run: async (sandbox, root) => {\n const path = `${root}/large.bin`;\n const content = patternBytes(largeFileBytes, largeFileBytes);\n await sandbox.writeFile({ path, content: chunked(content, 300_000) });\n const stream = await sandbox.readFile({ path });\n check(stream != null, 'large file not found');\n if (stream == null) return;\n check(sameBytes(await readAllBytes(stream), content), 'streamed bytes differ');\n const binary = await sandbox.readBinaryFile({ path });\n check(binary != null && sameBytes(binary, content), 'readBinaryFile differs');\n const small = patternBytes(1000, 7);\n await sandbox.writeBinaryFile({ path: `${root}/small.bin`, content: small });\n const back = await sandbox.readBinaryFile({ path: `${root}/small.bin` });\n check(back != null && sameBytes(back, small), 'binary round trip');\n return `${largeFileBytes} bytes`;\n },\n },\n {\n name: 'stat, readDir, removePath',\n run: async (sandbox, root) => {\n await sandbox.writeTextFile({ path: `${root}/tree/x.txt`, content: 'xyz' });\n await sandbox.writeTextFile({ path: `${root}/tree/sub/y.txt`, content: 'y' });\n const stat = await sandbox.stat({ path: `${root}/tree/x.txt` });\n check(stat?.type === SandboxEntryType.File && stat.size === 3, 'file stat');\n check(\n (await sandbox.stat({ path: `${root}/tree` }))?.type === SandboxEntryType.Directory,\n 'directory stat',\n );\n check(\n (await sandbox.stat({ path: `${root}/tree/none` })) == null,\n 'missing stat is not null',\n );\n const names = (await sandbox.readDir({ path: `${root}/tree` }))\n .map((entry) => entry.name)\n .sort();\n check(\n JSON.stringify(names) === JSON.stringify(['sub', 'x.txt']),\n `readDir returned ${names.join(',')}`,\n );\n await sandbox.removePath({ path: `${root}/tree/none`, force: true });\n await sandbox.removePath({ path: `${root}/tree`, recursive: true });\n check(\n (await sandbox.stat({ path: `${root}/tree/x.txt` })) == null,\n 'recursive remove left files',\n );\n },\n },\n {\n name: 'process output and exit codes',\n run: async (sandbox) => {\n const echo = await sandbox.run({ command: 'echo', args: ['hello', 'world'] });\n check(\n echo.exitCode === 0 && echo.stdout === 'hello world\\n',\n `echo: ${JSON.stringify(echo)}`,\n );\n const shell = await sandbox.run({ command: 'echo out; echo err >&2; exit 3', shell: true });\n check(\n shell.exitCode === 3 && shell.stdout === 'out\\n' && shell.stderr === 'err\\n',\n `shell: ${JSON.stringify(shell)}`,\n );\n },\n },\n {\n name: 'process stdin',\n run: async (sandbox) => {\n const piped = await sandbox.run({ command: 'cat', stdin: 'from stdin' });\n check(piped.stdout === 'from stdin', `run stdin: ${JSON.stringify(piped)}`);\n const cat = await sandbox.spawn({ command: 'cat' });\n const output = streamToString(cat.stdout);\n await cat.write('a');\n await cat.write('b', { end: true });\n check((await output) === 'ab', 'spawned cat echoed wrong data');\n check((await cat.wait()).exitCode === 0, 'cat exit code');\n },\n },\n {\n name: 'process kill',\n run: async (sandbox) => {\n const sleeper = await sandbox.spawn({ command: 'sleep', args: ['30'] });\n await sleeper.kill();\n const result = await withTimeout(sleeper.wait(), 5_000, 'wait after kill');\n check(result.exitCode !== 0, 'killed process exited 0');\n },\n },\n];\n\n// Prints a first line on each stream, pauses (the kit drops its handle then),\n// prints a second one and exits 7. Fake backends script exactly this text.\nexport const DURABLE_CONFORMANCE_SCRIPT =\n 'echo one; echo err-one >&2; sleep 2; echo two; echo err-two >&2; exit 7';\n\nconst textOf = (chunks: Uint8Array[]) => new TextDecoder().decode(concatChunks(chunks));\nconst concatChunks = (chunks: Uint8Array[]): Uint8Array => {\n const out = new Uint8Array(chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0));\n let offset = 0;\n for (const chunk of chunks) {\n out.set(chunk, offset);\n offset += chunk.byteLength;\n }\n return out;\n};\n\n// Reads until the text read so far contains `text` (a provider may deliver\n// more in the same chunk); returns the bytes read. The reader stays locked,\n// so nothing more is consumed.\nconst readThrough = async (\n stream: ReadableStream<Uint8Array>,\n text: string,\n): Promise<Uint8Array> => {\n const reader = stream.getReader();\n const chunks: Uint8Array[] = [];\n while (!textOf(chunks).includes(text)) {\n const next = await reader.read();\n if (next.done) throw new Error(`stream ended before ${JSON.stringify(text)}`);\n chunks.push(next.value);\n }\n return concatChunks(chunks);\n};\n\nconst DURABLE_STDOUT = 'one\\ntwo\\n';\nconst DURABLE_STDERR = 'err-one\\nerr-two\\n';\n// The output after `offset` bytes (the script's output is ASCII).\nconst after = (text: string, offset: number) => text.slice(offset);\n\ninterface DurableTargetsIface {\n // Where a process is spawned, and where it is attached again.\n spawnOn: () => Promise<NetworkSandboxSessionIface>;\n attachOn: () => Promise<NetworkSandboxSessionIface>;\n // Drops the spawning handle: aborts its signal, or closes its connection.\n drop: (args: { controller: AbortController; sandbox: NetworkSandboxSessionIface }) => void;\n}\n\nconst attachOrFail = async (\n sandbox: NetworkSandboxSessionIface,\n options: { ref: string; stdoutOffset: number; stderrOffset: number },\n) => {\n check(sandbox.attachProcess != null, 'attachProcess is missing');\n const attached = await sandbox.attachProcess?.(options);\n if (attached == null) throw new Error('attachProcess found no process for a durable ref');\n return attached;\n};\n\nconst durableCases = async (targets: DurableTargetsIface, record: RecordCase, prefix: string) => {\n const state: { spawned: { ref: string; stdoutOffset: number; stderrOffset: number } | null } = {\n spawned: null,\n };\n await record(\n `${prefix}durable processes: re-attach resumes at the delivered offsets`,\n async () => {\n const controller = new AbortController();\n const sandbox = await targets.spawnOn();\n const process = await sandbox.spawn({\n command: DURABLE_CONFORMANCE_SCRIPT,\n shell: true,\n durable: true,\n abortSignal: controller.signal,\n });\n const ref = process.ref;\n check(typeof ref === 'string' && ref.length > 0, 'a durable process has no ref');\n if (ref == null) return;\n const [stdout, stderr] = await Promise.all([\n readThrough(process.stdout, 'one\\n'),\n readThrough(process.stderr, 'err-one\\n'),\n ]);\n targets.drop({ controller, sandbox });\n const options = { ref, stdoutOffset: stdout.byteLength, stderrOffset: stderr.byteLength };\n const attached = await attachOrFail(await targets.attachOn(), options);\n check(\n attached.stdoutOffset === options.stdoutOffset &&\n attached.stderrOffset === options.stderrOffset,\n `attached at ${attached.stdoutOffset}/${attached.stderrOffset}, asked ${options.stdoutOffset}/${options.stderrOffset}`,\n );\n const [restOut, restErr, exit] = await Promise.all([\n streamToString(attached.stdout),\n streamToString(attached.stderr),\n attached.wait(),\n ]);\n const out = textOf([stdout]) + restOut;\n const err = textOf([stderr]) + restErr;\n check(out === DURABLE_STDOUT, `stdout across the re-attach: ${JSON.stringify(out)}`);\n check(err === DURABLE_STDERR, `stderr across the re-attach: ${JSON.stringify(err)}`);\n check(exit.exitCode === 7, `exit code ${exit.exitCode}`);\n state.spawned = options;\n },\n );\n await record(\n `${prefix}durable processes: attach after exit keeps output and exit code`,\n async () => {\n const options = state.spawned;\n if (options == null) throw new Error('the re-attach case failed');\n const attached = await attachOrFail(await targets.attachOn(), options);\n const [out, err, exit] = await Promise.all([\n streamToString(attached.stdout),\n streamToString(attached.stderr),\n attached.wait(),\n ]);\n check(\n out === after(DURABLE_STDOUT, options.stdoutOffset) &&\n err === after(DURABLE_STDERR, options.stderrOffset),\n `after exit: ${JSON.stringify([out, err])}`,\n );\n check(exit.exitCode === 7, `exit code after exit ${exit.exitCode}`);\n },\n );\n await record(`${prefix}durable processes: kill through an attached handle`, async () => {\n const controller = new AbortController();\n const sandbox = await targets.spawnOn();\n const process = await sandbox.spawn({\n command: 'sleep 30',\n shell: true,\n durable: true,\n abortSignal: controller.signal,\n });\n const ref = process.ref;\n if (ref == null) throw new Error('a durable process has no ref');\n targets.drop({ controller, sandbox });\n const attached = await attachOrFail(await targets.attachOn(), {\n ref,\n stdoutOffset: 0,\n stderrOffset: 0,\n });\n void streamToString(attached.stdout).catch(() => undefined);\n void streamToString(attached.stderr).catch(() => undefined);\n await attached.kill();\n const result = await withTimeout(attached.wait(), 10_000, 'wait after kill');\n check(result.exitCode !== 0, 'killed process exited 0');\n });\n await record(`${prefix}durable processes: unknown refs and ordinary processes`, async () => {\n const sandbox = await targets.attachOn();\n const unknown = await sandbox.attachProcess?.({\n ref: 'conformance-unknown-ref',\n stdoutOffset: 0,\n stderrOffset: 0,\n });\n check(unknown === null, 'an unknown ref attached to a process');\n const ordinary = await (await targets.spawnOn()).spawn({ command: 'echo', args: ['ordinary'] });\n check(ordinary.ref == null, 'an ordinary process has a ref');\n await Promise.all([\n streamToString(ordinary.stdout),\n streamToString(ordinary.stderr),\n ordinary.wait(),\n ]);\n });\n};\n\nconst startFromProvider = async (\n args: RunSandboxConformanceArgsIface,\n provider: AnySandboxProviderIface,\n overrides: {\n environmentOptions?: JsonValue;\n startContext?: Partial<SandboxStartContextIface>;\n // A binding (and so a sandbox) of its own, whatever session the caller's context names.\n ownBinding?: boolean;\n } = {},\n): Promise<ProviderStartIface> => {\n const implementation = provider.definition.environment(\n overrides.environmentOptions ?? args.environmentOptions,\n );\n const prepareContext: SandboxPrepareContextIface = {\n files: {},\n resources: {},\n sourceRevision: 'conformance',\n storagePath: '/tmp/final-conformance',\n organizationId: 'conformance',\n guides: noSandboxGuides,\n actingUser: noSandboxActingUser,\n ...args.prepareContext,\n };\n const artifact = await implementation.prepare(prepareContext);\n const startContext: SandboxStartContextIface = {\n session: {\n id: crypto.randomUUID(),\n organizationId: 'conformance',\n conversationId: null,\n definitionId: 'conformance',\n bindingId: crypto.randomUUID(),\n target: 'conformance',\n },\n storagePath: '/tmp/final-conformance',\n guides: noSandboxGuides,\n variables: noSandboxVariables,\n repositories: noSandboxRepositories,\n actingUser: noSandboxActingUser,\n platformNetworkPolicy: async () => undefined,\n ...args.startContext,\n ...overrides.startContext,\n };\n if (overrides.ownBinding === true) {\n startContext.session = {\n ...startContext.session,\n id: crypto.randomUUID(),\n bindingId: crypto.randomUUID(),\n conversationId: null,\n };\n }\n const { handle, state } = await implementation.start(startContext, args.openOptions, artifact);\n return {\n handle,\n awaitRunning: (timeoutMs) => implementation.awaitRunning(startContext, state, { timeoutMs }),\n };\n};\n\nconst PLATFORM_VARIABLE = 'FINAL_CONFORMANCE_PLATFORM';\nconst SPEC_VARIABLE = 'FINAL_CONFORMANCE_SPEC';\nconst SHARED_VARIABLE = 'FINAL_CONFORMANCE_SHARED';\nconst SPEC_ENV = { [SPEC_VARIABLE]: 'spec', [SHARED_VARIABLE]: 'spec' };\nconst SPEC_ALLOW = ['conformance.example.com'];\nconst PLATFORM_EGRESS_HOSTS = ['egress.conformance.example.com'];\n\n// A variable as a spawned process sees it; null when unset.\nconst variableIn = async (\n sandbox: NetworkSandboxSessionIface,\n name: string,\n): Promise<string | null> => {\n const process = await sandbox.spawn({ command: 'printenv', args: [name] });\n const [stdout, { exitCode }] = await Promise.all([\n streamToString(process.stdout),\n process.wait(),\n ]);\n return exitCode === 0 ? stdout.replace(/\\n$/, '') : null;\n};\n\nconst expectVariables = async (\n sandbox: NetworkSandboxSessionIface,\n expected: Record<string, string | null>,\n) => {\n for (const [name, value] of Object.entries(expected)) {\n const actual = await variableIn(sandbox, name);\n check(\n actual === value,\n `${name} is ${JSON.stringify(actual)}, expected ${JSON.stringify(value)}`,\n );\n }\n};\n\ntype RecordCase = (name: string, run: () => Promise<string | void>) => Promise<void>;\n\n// The start context's platformFiles are written before any process runs;\n// platformEnvironment reaches every process, read again for each one and over\n// the spec's env; platformEgressHosts join an allowlist, and the policy is\n// reported through platformNetworkPolicy before platformFiles are written (a\n// rejected report fails the start); a spec naming a platform variable is refused.\nconst runPlatformCases = async (args: {\n kit: RunSandboxConformanceArgsIface;\n provider: AnySandboxProviderIface;\n platform: SandboxPlatformConformanceIface;\n record: RecordCase;\n skip: (name: string, detail: string) => void;\n}) => {\n const { kit, provider, platform, record } = args;\n let platformValues: Record<string, string> = {\n [PLATFORM_VARIABLE]: 'first',\n [SHARED_VARIABLE]: 'platform',\n };\n const filePath = `/tmp/final-conformance-${crypto.randomUUID().slice(0, 8)}/platform/ca.pem`;\n const order: string[] = [];\n const withPlatform: StartedProviderIface = { handle: null };\n await record('platform environment: provider start', async () => {\n ({ handle: withPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV }),\n startContext: {\n platformFiles: async () => {\n order.push('files');\n return { [filePath]: 'conformance CA\\n' };\n },\n platformEnvironment: async () => {\n order.push('environment');\n return { ...platformValues };\n },\n },\n ownBinding: true,\n }));\n });\n const sandbox = withPlatform.handle?.sandbox;\n if (sandbox != null) {\n try {\n await record('platform files: written before any process', async () => {\n check(\n order.indexOf('files') === 0,\n `platformEnvironment was read before platformFiles: ${order.join(', ')}`,\n );\n const content = await sandbox.readTextFile({ path: filePath });\n check(content === 'conformance CA\\n', `${filePath} holds ${JSON.stringify(content)}`);\n });\n await record('platform environment: reaches spawned processes', async () => {\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'first' });\n const run = await sandbox.run({ command: 'printenv', args: [PLATFORM_VARIABLE] });\n check(run.stdout === 'first\\n', `run saw ${JSON.stringify(run.stdout)}`);\n });\n await record('platform environment: read again for every process', async () => {\n platformValues = { ...platformValues, [PLATFORM_VARIABLE]: 'second' };\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'second' });\n });\n await record('platform environment: overrides the spec env', async () => {\n await expectVariables(sandbox, { [SHARED_VARIABLE]: 'platform', [SPEC_VARIABLE]: 'spec' });\n });\n await record('platform environment: {} leaves the spec env', async () => {\n platformValues = {};\n await expectVariables(sandbox, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n });\n });\n } finally {\n await withPlatform.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n }\n }\n\n const withoutPlatform: StartedProviderIface = { handle: null };\n const reported: NetworkPolicyIface[] = [];\n const reportOrder: string[] = [];\n const allowlistContext = (\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>,\n ): Partial<SandboxStartContextIface> => ({\n platformEnvironment: undefined,\n platformEgressHosts: PLATFORM_EGRESS_HOSTS,\n platformNetworkPolicy,\n platformFiles: async () => {\n reportOrder.push('files');\n return {};\n },\n });\n await record('platform environment: provider start without it', async () => {\n ({ handle: withoutPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async (policy) => {\n reportOrder.push('policy');\n reported.push(policy);\n }),\n ownBinding: true,\n }));\n });\n const plain = withoutPlatform.handle?.sandbox;\n if (plain != null) {\n try {\n await record('platform environment: absent leaves the spec env', () =>\n expectVariables(plain, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n }),\n );\n const observe = platform.observedAllowlist;\n if (observe == null) {\n args.skip('platform egress hosts: appended to an allowlist', 'no observedAllowlist');\n args.skip('platform network policy: reported as applied', 'no observedAllowlist');\n } else {\n await record('platform egress hosts: appended to an allowlist', async () => {\n const allow = (await observe(plain)) ?? [];\n for (const host of [...SPEC_ALLOW, ...PLATFORM_EGRESS_HOSTS])\n check(allow.includes(host), `allowlist ${JSON.stringify(allow)} lacks ${host}`);\n });\n await record('platform network policy: reported as applied', async () => {\n const last = reported.at(-1);\n check(\n last?.mode === NetworkPolicy.Allowlist,\n `reported ${JSON.stringify(reported)}, expected an allowlist`,\n );\n const applied = [...((await observe(plain)) ?? [])].sort();\n const allow = [...(last?.allow ?? [])].sort();\n check(\n JSON.stringify(allow) === JSON.stringify(applied),\n `reported ${JSON.stringify(allow)}, applied ${JSON.stringify(applied)}`,\n );\n check(\n reportOrder.indexOf('policy') < reportOrder.indexOf('files'),\n `platformFiles were written before the policy was reported: ${reportOrder.join(', ')}`,\n );\n });\n }\n } finally {\n await withoutPlatform.handle\n ?.onSandboxDelete({ reason: 'conformance' })\n .catch(() => undefined);\n }\n }\n\n if (platform.observedAllowlist == null) {\n args.skip('platform network policy: a rejected report fails the start', 'no observedAllowlist');\n } else {\n await record('platform network policy: a rejected report fails the start', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async () => {\n throw new Error('conformance: the policy was not recorded');\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a start whose policy report failed returned a sandbox');\n });\n }\n\n await record('platform environment: reserved names refused', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({\n env: { HTTPS_PROXY: 'http://spec.example.com' },\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a spec setting HTTPS_PROXY started');\n });\n};\n\nexport const runSandboxConformance = async (\n args: RunSandboxConformanceArgsIface,\n): Promise<SandboxConformanceReportIface> => {\n const timeoutMs = args.timeoutMs ?? 30_000;\n const cases: ConformanceCaseResultIface[] = [];\n const record: RecordCase = async (name, run) => {\n const started = Date.now();\n try {\n const detail = await withTimeout(run(), timeoutMs, name);\n cases.push({\n name,\n status: ConformanceCaseStatus.Passed,\n durationMs: Date.now() - started,\n error: null,\n detail: detail ?? null,\n });\n } catch (error) {\n cases.push({\n name,\n status: ConformanceCaseStatus.Failed,\n durationMs: Date.now() - started,\n error: error instanceof Error ? error.message : String(error),\n detail: null,\n });\n }\n };\n\n // A holder, so the assignment inside the closure is visible to the narrowing.\n const started: StartedProviderIface = { handle: null };\n let sandbox = args.handle ?? null;\n if (sandbox == null) {\n if (args.provider == null)\n throw new Error('runSandboxConformance needs a handle or a provider');\n const provider = args.provider;\n await record('provider start', async () => {\n ({ handle: started.handle, awaitRunning: started.awaitRunning } = await startFromProvider(\n args,\n provider,\n ));\n });\n const awaitRunning = started.awaitRunning;\n if (awaitRunning != null)\n await record('provider awaitRunning: resolves for a started sandbox', () =>\n awaitRunning(timeoutMs),\n );\n sandbox = started.handle?.sandbox ?? null;\n }\n if (sandbox == null) return { passed: false, cases };\n const target = sandbox;\n\n const root = target.resolvePath(`conformance-${crypto.randomUUID().slice(0, 8)}`);\n const list = sandboxCases(args.largeFileBytes ?? 5 * 1024 * 1024);\n for (const entry of list) await record(entry.name, () => entry.run(target, root));\n const durable = target.attachProcess != null;\n if (durable)\n await durableCases(\n {\n spawnOn: async () => target,\n attachOn: async () => target,\n drop: ({ controller }) => controller.abort(),\n },\n record,\n '',\n );\n else\n cases.push({\n name: 'durable processes',\n status: ConformanceCaseStatus.Skipped,\n durationMs: 0,\n error: null,\n detail: 'the sandbox has no attachProcess',\n });\n\n if (args.viaWire !== false) {\n const network = createInMemoryHandleNetwork();\n network.serve({ url: 'mem://conformance', sandbox: target });\n network.serve({\n url: 'mem://conformance-read',\n sandbox: target,\n access: { mode: SandboxAccess.Read, lifecycle: false },\n });\n const client = await network.connect({ url: 'mem://conformance', token: 'conformance' });\n try {\n const wireRoot = `${root}-wire`;\n for (const entry of list)\n await record(`handle rpc: ${entry.name}`, () => entry.run(client, wireRoot));\n await record('handle rpc: read-only access policy', async () => {\n const readOnly = await network.connect({\n url: 'mem://conformance-read',\n token: 'conformance',\n });\n try {\n await target.writeTextFile({ path: `${root}/ro.txt`, content: 'visible' });\n check(\n (await readOnly.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'read failed on a read binding',\n );\n const attempts: [string, Promise<unknown>][] = [\n [\n 'writeTextFile',\n readOnly.writeTextFile({ path: `${root}/ro.txt`, content: 'changed' }),\n ],\n ['run', readOnly.run({ command: 'echo' })],\n ['spawn', readOnly.spawn({ command: 'echo' })],\n ['removePath', readOnly.removePath({ path: `${root}/ro.txt` })],\n ];\n for (const [what, attempt] of attempts) {\n const error = await attempt.then(\n () => null,\n (cause: unknown) => cause,\n );\n check(\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Forbidden,\n `${what} was not rejected`,\n );\n }\n check(\n (await target.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'a read binding changed the file',\n );\n } finally {\n readOnly.close();\n }\n });\n if (durable) {\n // Each spawn gets a connection of its own, which dropping closes.\n const connections: SandboxClientIface[] = [];\n const open = async () => {\n const connection = await network.connect({\n url: 'mem://conformance',\n token: 'conformance',\n });\n connections.push(connection);\n return connection;\n };\n try {\n await durableCases(\n {\n spawnOn: open,\n attachOn: open,\n drop: ({ sandbox }) => connections.find((entry) => entry === sandbox)?.close(),\n },\n record,\n 'handle rpc: ',\n );\n } finally {\n for (const connection of connections) connection.close();\n }\n }\n } finally {\n client.close();\n await target\n .removePath({ path: `${root}-wire`, recursive: true, force: true })\n .catch(() => undefined);\n }\n }\n\n await target.removePath({ path: root, recursive: true, force: true }).catch(() => undefined);\n await started.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n\n if (args.platform != null && args.provider != null) {\n await runPlatformCases({\n kit: args,\n provider: args.provider,\n platform: args.platform,\n record,\n skip: (name, detail) =>\n cases.push({\n name,\n status: ConformanceCaseStatus.Skipped,\n durationMs: 0,\n error: null,\n detail,\n }),\n });\n }\n return { passed: cases.every((entry) => entry.status !== ConformanceCaseStatus.Failed), cases };\n};\n"],
5
+ "mappings": "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",
6
+ "names": ["started", "sandbox"]
7
7
  }
@@ -7,6 +7,7 @@ export * from "./hosted-bindings.mjs";
7
7
  export * from "./json.mjs";
8
8
  export * from "./manifest.mjs";
9
9
  export * from "./provider-ref.mjs";
10
+ export * from "./room-surface.mjs";
10
11
  export * from "./sandbox/open-scope.mjs";
11
12
  export * from "./sandbox/types.mjs";
12
13
  export * from "./schemas.mjs";
@@ -14,6 +14,7 @@ export * from "./hosted-bindings.mjs";
14
14
  export * from "./json.mjs";
15
15
  export * from "./manifest.mjs";
16
16
  export * from "./provider-ref.mjs";
17
+ export * from "./room-surface.mjs";
17
18
  export * from "./sandbox/open-scope.mjs";
18
19
  export * from "./sandbox/types.mjs";
19
20
  export * from "./schemas.mjs";
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/index.ts"],
4
- "sourcesContent": ["export {\n ProcessInspectionOperation,\n inspectedProcessSchema,\n processInspectionDetailSchema,\n processInspectionPageSchema,\n processInspectionRequestSchema,\n processInspectionResultSchema,\n type InspectedProcessIface,\n type ProcessInspectionDetailIface,\n type ProcessInspectionPageIface,\n type ProcessInspectionRequestIface,\n type ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nexport * from \"./channel.mjs\";\nexport * from \"./credentials.mjs\";\nexport * from \"./dynamic.mjs\";\nexport * from \"./harness.mjs\";\nexport * from \"./hosted-bindings.mjs\";\nexport * from \"./json.mjs\";\nexport * from \"./manifest.mjs\";\nexport * from \"./provider-ref.mjs\";\nexport * from \"./sandbox/open-scope.mjs\";\nexport * from \"./sandbox/types.mjs\";\nexport * from \"./schemas.mjs\";\nexport * from \"./tool-annotations.mjs\";\nexport * from \"./tool-patterns.mjs\";\n\nexport * from \"./semantic-events.mjs\";\n\nexport * from \"./sandbox/snapshots.mjs\";\n\nexport {\n SandboxEditorOperation,\n sandboxEditorRequestSchema,\n sandboxEditorResultSchema,\n sandboxEditorSessionSchema,\n type SandboxEditorRequestIface,\n type SandboxEditorResultIface,\n type SandboxEditorSessionIface,\n} from \"./sandbox/editor.mjs\";\n"],
5
- "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AAEd,cAAc;AAEd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;",
4
+ "sourcesContent": ["export {\n ProcessInspectionOperation,\n inspectedProcessSchema,\n processInspectionDetailSchema,\n processInspectionPageSchema,\n processInspectionRequestSchema,\n processInspectionResultSchema,\n type InspectedProcessIface,\n type ProcessInspectionDetailIface,\n type ProcessInspectionPageIface,\n type ProcessInspectionRequestIface,\n type ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nexport * from \"./channel.mjs\";\nexport * from \"./credentials.mjs\";\nexport * from \"./dynamic.mjs\";\nexport * from \"./harness.mjs\";\nexport * from \"./hosted-bindings.mjs\";\nexport * from \"./json.mjs\";\nexport * from \"./manifest.mjs\";\nexport * from \"./provider-ref.mjs\";\nexport * from \"./room-surface.mjs\";\nexport * from \"./sandbox/open-scope.mjs\";\nexport * from \"./sandbox/types.mjs\";\nexport * from \"./schemas.mjs\";\nexport * from \"./tool-annotations.mjs\";\nexport * from \"./tool-patterns.mjs\";\n\nexport * from \"./semantic-events.mjs\";\n\nexport * from \"./sandbox/snapshots.mjs\";\n\nexport {\n SandboxEditorOperation,\n sandboxEditorRequestSchema,\n sandboxEditorResultSchema,\n sandboxEditorSessionSchema,\n type SandboxEditorRequestIface,\n type SandboxEditorResultIface,\n type SandboxEditorSessionIface,\n} from \"./sandbox/editor.mjs\";\n"],
5
+ "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AAEd,cAAc;AAEd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;",
6
6
  "names": []
7
7
  }
@@ -1,10 +1,10 @@
1
- import type { ChannelReceiveContextIface, InstalledAppCredential, InstalledAppInfoIface } from "./channel.mjs";
1
+ import type { ChannelReceiveContextIface, ChannelCredentialsIface } from "./channel.mjs";
2
2
  import type { JsonObject } from "./json.mjs";
3
3
  export interface LocalChannelContextOptionsIface {
4
4
  config?: JsonObject;
5
5
  secret(name: string): Promise<string | null>;
6
- app?: InstalledAppCredential;
7
- appInfo?: InstalledAppInfoIface;
6
+ credentials?: ChannelCredentialsIface;
7
+ url?: string;
8
8
  fetch?: typeof fetch;
9
9
  }
10
10
  export declare const createLocalChannelContext: (options: LocalChannelContextOptionsIface) => ChannelReceiveContextIface;
@@ -5,21 +5,31 @@ const createLocalChannelContext = (options) => {
5
5
  const noStream = () => ({
6
6
  [Symbol.asyncIterator]: () => ({ next: async () => unavailable() })
7
7
  });
8
+ const credentials = options.credentials ?? {
9
+ client: async () => unavailable(),
10
+ verify: async () => unavailable(),
11
+ exchange: async () => unavailable(),
12
+ connect: async () => unavailable(),
13
+ secret: options.secret,
14
+ fetch: async (input, init) => {
15
+ if (init?.credential != null && init.credential.kind !== "none") return unavailable();
16
+ return (options.fetch ?? globalThis.fetch)(input, { ...init, redirect: "manual" });
17
+ }
18
+ };
8
19
  return {
9
- binding: { id: "local", owner: { kind: "agent", definitionId: "local" } },
20
+ binding: {
21
+ id: "local",
22
+ url: options.url ?? "http://localhost",
23
+ owner: { kind: "agent", definitionId: "local" }
24
+ },
10
25
  config: options.config ?? {},
11
26
  credentials: {
12
- appInfo: async () => {
13
- const app = options.appInfo ?? options.app ?? unavailable();
14
- return {
15
- clientId: app.clientId,
16
- clientSecret: app.clientSecret,
17
- ...app.signingSecret == null ? {} : { signingSecret: app.signingSecret }
18
- };
19
- },
20
- app: async () => options.app ?? unavailable(),
21
- secret: options.secret,
22
- fetch: options.fetch ?? globalThis.fetch
27
+ client: () => credentials.client(),
28
+ verify: (value) => credentials.verify(value),
29
+ exchange: (value) => credentials.exchange(value),
30
+ connect: (value) => credentials.connect(value),
31
+ fetch: (input, init) => credentials.fetch(input, init),
32
+ secret: options.secret
23
33
  },
24
34
  people: {
25
35
  resolve: async () => unavailable(),
@@ -31,7 +41,9 @@ const createLocalChannelContext = (options) => {
31
41
  resolve: async () => unavailable(),
32
42
  observers: async () => unavailable(),
33
43
  connect: async () => unavailable(),
34
- disconnect: async () => unavailable()
44
+ disconnect: async () => unavailable(),
45
+ follow: async () => unavailable(),
46
+ unfollow: async () => unavailable()
35
47
  },
36
48
  conversation: () => ({
37
49
  post: async () => unavailable(),
@@ -42,7 +54,6 @@ const createLocalChannelContext = (options) => {
42
54
  react: async () => unavailable()
43
55
  }),
44
56
  observe: noStream,
45
- media: { transcribe: noStream, synthesize: noStream },
46
57
  decisions: { resolve: async () => unavailable() },
47
58
  turns: { cancel: async () => unavailable() },
48
59
  store: { get: async () => unavailable(), set: async () => unavailable() },
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/local-channel-context.ts"],
4
- "sourcesContent": ["import type {\n ChannelReceiveContextIface,\n InstalledAppCredential,\n InstalledAppInfoIface,\n} from \"./channel.mjs\";\nimport type { JsonObject } from \"./json.mjs\";\nexport interface LocalChannelContextOptionsIface {\n config?: JsonObject;\n secret(name: string): Promise<string | null>;\n app?: InstalledAppCredential;\n appInfo?: InstalledAppInfoIface;\n fetch?: typeof fetch;\n}\n// Local route previews can validate and log ingress; authenticated platform operations require a host.\nexport const createLocalChannelContext = (\n options: LocalChannelContextOptionsIface,\n): ChannelReceiveContextIface => {\n const unavailable = (): never => {\n throw new Error('This channel operation needs an authenticated Final host.');\n };\n const noStream = (): AsyncIterable<never> => ({\n [Symbol.asyncIterator]: () => ({ next: async () => unavailable() }),\n });\n return {\n binding: { id: 'local', owner: { kind: 'agent', definitionId: 'local' } },\n config: options.config ?? {},\n credentials: {\n appInfo: async () => {\n const app = options.appInfo ?? options.app ?? unavailable();\n return {\n clientId: app.clientId,\n clientSecret: app.clientSecret,\n ...(app.signingSecret == null ? {} : { signingSecret: app.signingSecret }),\n };\n },\n app: async () => options.app ?? unavailable(),\n secret: options.secret,\n fetch: options.fetch ?? globalThis.fetch,\n },\n people: {\n resolve: async () => unavailable(),\n identify: async () => unavailable(),\n confirm: async () => unavailable(),\n revoke: async () => unavailable(),\n },\n places: {\n resolve: async () => unavailable(),\n observers: async () => unavailable(),\n connect: async () => unavailable(),\n disconnect: async () => unavailable(),\n },\n conversation: () => ({\n post: async () => unavailable(),\n input: async () => unavailable(),\n attach: async () => unavailable(),\n edit: async () => unavailable(),\n remove: async () => unavailable(),\n react: async () => unavailable(),\n }),\n observe: noStream,\n media: { transcribe: noStream, synthesize: noStream },\n decisions: { resolve: async () => unavailable() },\n turns: { cancel: async () => unavailable() },\n store: { get: async () => unavailable(), set: async () => unavailable() },\n log: () => undefined,\n };\n};\n"],
5
- "mappings": "AAcO,MAAM,4BAA4B,CACvC,YAC+B;AAC/B,QAAM,cAAc,MAAa;AAC/B,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,QAAM,WAAW,OAA6B;AAAA,IAC5C,CAAC,OAAO,aAAa,GAAG,OAAO,EAAE,MAAM,YAAY,YAAY,EAAE;AAAA,EACnE;AACA,SAAO;AAAA,IACL,SAAS,EAAE,IAAI,SAAS,OAAO,EAAE,MAAM,SAAS,cAAc,QAAQ,EAAE;AAAA,IACxE,QAAQ,QAAQ,UAAU,CAAC;AAAA,IAC3B,aAAa;AAAA,MACX,SAAS,YAAY;AACnB,cAAM,MAAM,QAAQ,WAAW,QAAQ,OAAO,YAAY;AAC1D,eAAO;AAAA,UACL,UAAU,IAAI;AAAA,UACd,cAAc,IAAI;AAAA,UAClB,GAAI,IAAI,iBAAiB,OAAO,CAAC,IAAI,EAAE,eAAe,IAAI,cAAc;AAAA,QAC1E;AAAA,MACF;AAAA,MACA,KAAK,YAAY,QAAQ,OAAO,YAAY;AAAA,MAC5C,QAAQ,QAAQ;AAAA,MAChB,OAAO,QAAQ,SAAS,WAAW;AAAA,IACrC;AAAA,IACA,QAAQ;AAAA,MACN,SAAS,YAAY,YAAY;AAAA,MACjC,UAAU,YAAY,YAAY;AAAA,MAClC,SAAS,YAAY,YAAY;AAAA,MACjC,QAAQ,YAAY,YAAY;AAAA,IAClC;AAAA,IACA,QAAQ;AAAA,MACN,SAAS,YAAY,YAAY;AAAA,MACjC,WAAW,YAAY,YAAY;AAAA,MACnC,SAAS,YAAY,YAAY;AAAA,MACjC,YAAY,YAAY,YAAY;AAAA,IACtC;AAAA,IACA,cAAc,OAAO;AAAA,MACnB,MAAM,YAAY,YAAY;AAAA,MAC9B,OAAO,YAAY,YAAY;AAAA,MAC/B,QAAQ,YAAY,YAAY;AAAA,MAChC,MAAM,YAAY,YAAY;AAAA,MAC9B,QAAQ,YAAY,YAAY;AAAA,MAChC,OAAO,YAAY,YAAY;AAAA,IACjC;AAAA,IACA,SAAS;AAAA,IACT,OAAO,EAAE,YAAY,UAAU,YAAY,SAAS;AAAA,IACpD,WAAW,EAAE,SAAS,YAAY,YAAY,EAAE;AAAA,IAChD,OAAO,EAAE,QAAQ,YAAY,YAAY,EAAE;AAAA,IAC3C,OAAO,EAAE,KAAK,YAAY,YAAY,GAAG,KAAK,YAAY,YAAY,EAAE;AAAA,IACxE,KAAK,MAAM;AAAA,EACb;AACF;",
4
+ "sourcesContent": ["import type { ChannelReceiveContextIface, ChannelCredentialsIface } from \"./channel.mjs\";\nimport type { JsonObject } from \"./json.mjs\";\nexport interface LocalChannelContextOptionsIface {\n config?: JsonObject;\n secret(name: string): Promise<string | null>;\n credentials?: ChannelCredentialsIface;\n url?: string;\n fetch?: typeof fetch;\n}\n// Local route previews can validate and log ingress; authenticated platform operations require a host.\nexport const createLocalChannelContext = (\n options: LocalChannelContextOptionsIface,\n): ChannelReceiveContextIface => {\n const unavailable = (): never => {\n throw new Error('This channel operation needs an authenticated Final host.');\n };\n const noStream = (): AsyncIterable<never> => ({\n [Symbol.asyncIterator]: () => ({ next: async () => unavailable() }),\n });\n const credentials: ChannelCredentialsIface = options.credentials ?? {\n client: async () => unavailable(),\n verify: async () => unavailable(),\n exchange: async () => unavailable(),\n connect: async () => unavailable(),\n secret: options.secret,\n fetch: async (input, init) => {\n if (init?.credential != null && init.credential.kind !== 'none') return unavailable();\n return (options.fetch ?? globalThis.fetch)(input, { ...init, redirect: 'manual' });\n },\n };\n return {\n binding: {\n id: 'local',\n url: options.url ?? 'http://localhost',\n owner: { kind: 'agent', definitionId: 'local' },\n },\n config: options.config ?? {},\n credentials: {\n client: () => credentials.client(),\n verify: (value) => credentials.verify(value),\n exchange: (value) => credentials.exchange(value),\n connect: (value) => credentials.connect(value),\n fetch: (input, init) => credentials.fetch(input, init),\n secret: options.secret,\n },\n people: {\n resolve: async () => unavailable(),\n identify: async () => unavailable(),\n confirm: async () => unavailable(),\n revoke: async () => unavailable(),\n },\n places: {\n resolve: async () => unavailable(),\n observers: async () => unavailable(),\n connect: async () => unavailable(),\n disconnect: async () => unavailable(),\n follow: async () => unavailable(),\n unfollow: async () => unavailable(),\n },\n conversation: () => ({\n post: async () => unavailable(),\n input: async () => unavailable(),\n attach: async () => unavailable(),\n edit: async () => unavailable(),\n remove: async () => unavailable(),\n react: async () => unavailable(),\n }),\n observe: noStream,\n decisions: { resolve: async () => unavailable() },\n turns: { cancel: async () => unavailable() },\n store: { get: async () => unavailable(), set: async () => unavailable() },\n log: () => undefined,\n };\n};\n"],
5
+ "mappings": "AAUO,MAAM,4BAA4B,CACvC,YAC+B;AAC/B,QAAM,cAAc,MAAa;AAC/B,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,QAAM,WAAW,OAA6B;AAAA,IAC5C,CAAC,OAAO,aAAa,GAAG,OAAO,EAAE,MAAM,YAAY,YAAY,EAAE;AAAA,EACnE;AACA,QAAM,cAAuC,QAAQ,eAAe;AAAA,IAClE,QAAQ,YAAY,YAAY;AAAA,IAChC,QAAQ,YAAY,YAAY;AAAA,IAChC,UAAU,YAAY,YAAY;AAAA,IAClC,SAAS,YAAY,YAAY;AAAA,IACjC,QAAQ,QAAQ;AAAA,IAChB,OAAO,OAAO,OAAO,SAAS;AAC5B,UAAI,MAAM,cAAc,QAAQ,KAAK,WAAW,SAAS,OAAQ,QAAO,YAAY;AACpF,cAAQ,QAAQ,SAAS,WAAW,OAAO,OAAO,EAAE,GAAG,MAAM,UAAU,SAAS,CAAC;AAAA,IACnF;AAAA,EACF;AACA,SAAO;AAAA,IACL,SAAS;AAAA,MACP,IAAI;AAAA,MACJ,KAAK,QAAQ,OAAO;AAAA,MACpB,OAAO,EAAE,MAAM,SAAS,cAAc,QAAQ;AAAA,IAChD;AAAA,IACA,QAAQ,QAAQ,UAAU,CAAC;AAAA,IAC3B,aAAa;AAAA,MACX,QAAQ,MAAM,YAAY,OAAO;AAAA,MACjC,QAAQ,CAAC,UAAU,YAAY,OAAO,KAAK;AAAA,MAC3C,UAAU,CAAC,UAAU,YAAY,SAAS,KAAK;AAAA,MAC/C,SAAS,CAAC,UAAU,YAAY,QAAQ,KAAK;AAAA,MAC7C,OAAO,CAAC,OAAO,SAAS,YAAY,MAAM,OAAO,IAAI;AAAA,MACrD,QAAQ,QAAQ;AAAA,IAClB;AAAA,IACA,QAAQ;AAAA,MACN,SAAS,YAAY,YAAY;AAAA,MACjC,UAAU,YAAY,YAAY;AAAA,MAClC,SAAS,YAAY,YAAY;AAAA,MACjC,QAAQ,YAAY,YAAY;AAAA,IAClC;AAAA,IACA,QAAQ;AAAA,MACN,SAAS,YAAY,YAAY;AAAA,MACjC,WAAW,YAAY,YAAY;AAAA,MACnC,SAAS,YAAY,YAAY;AAAA,MACjC,YAAY,YAAY,YAAY;AAAA,MACpC,QAAQ,YAAY,YAAY;AAAA,MAChC,UAAU,YAAY,YAAY;AAAA,IACpC;AAAA,IACA,cAAc,OAAO;AAAA,MACnB,MAAM,YAAY,YAAY;AAAA,MAC9B,OAAO,YAAY,YAAY;AAAA,MAC/B,QAAQ,YAAY,YAAY;AAAA,MAChC,MAAM,YAAY,YAAY;AAAA,MAC9B,QAAQ,YAAY,YAAY;AAAA,MAChC,OAAO,YAAY,YAAY;AAAA,IACjC;AAAA,IACA,SAAS;AAAA,IACT,WAAW,EAAE,SAAS,YAAY,YAAY,EAAE;AAAA,IAChD,OAAO,EAAE,QAAQ,YAAY,YAAY,EAAE;AAAA,IAC3C,OAAO,EAAE,KAAK,YAAY,YAAY,GAAG,KAAK,YAAY,YAAY,EAAE;AAAA,IACxE,KAAK,MAAM;AAAA,EACb;AACF;",
6
6
  "names": []
7
7
  }
@@ -283,6 +283,7 @@ export declare const channelSurfaceSchema: z.ZodObject<{
283
283
  }, z.core.$strip>>;
284
284
  listeners: z.ZodArray<z.ZodString>;
285
285
  placeKinds: z.ZodArray<z.ZodString>;
286
+ resourceResolver: z.ZodDefault<z.ZodBoolean>;
286
287
  }, z.core.$strip>;
287
288
  export declare const roomSurfaceBindingSchema: z.ZodObject<{
288
289
  channel: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -306,18 +307,19 @@ export declare const channelBindingSchema: z.ZodObject<{
306
307
  config: z.ZodDefault<z.ZodType<import("./json.mjs").JsonObject, unknown, z.core.$ZodTypeInternals<import("./json.mjs").JsonObject, unknown>>>;
307
308
  source: z.ZodOptional<z.ZodString>;
308
309
  key: z.ZodString;
309
- credentials: z.ZodObject<{
310
+ credentials: z.ZodDefault<z.ZodObject<{
310
311
  app: z.ZodNullable<z.ZodString>;
311
312
  secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
312
- }, z.core.$strip>;
313
- surface: z.ZodObject<{
313
+ }, z.core.$strip>>;
314
+ surface: z.ZodDefault<z.ZodObject<{
314
315
  routes: z.ZodArray<z.ZodObject<{
315
316
  method: z.ZodString;
316
317
  path: z.ZodString;
317
318
  }, z.core.$strip>>;
318
319
  listeners: z.ZodArray<z.ZodString>;
319
320
  placeKinds: z.ZodArray<z.ZodString>;
320
- }, z.core.$strip>;
321
+ resourceResolver: z.ZodDefault<z.ZodBoolean>;
322
+ }, z.core.$strip>>;
321
323
  install: z.ZodOptional<z.ZodString>;
322
324
  }, z.core.$strip>;
323
325
  export declare const hookBindingSchema: z.ZodObject<{
@@ -362,7 +364,7 @@ export declare const harnessBindingSchema: z.ZodObject<{
362
364
  }, z.core.$strip>, z.ZodType<import("./json.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./json.mjs").JsonValue, unknown>>]>;
363
365
  }, z.core.$strip>;
364
366
  export declare const agentManifestSchema: z.ZodObject<{
365
- version: z.ZodLiteral<4>;
367
+ version: z.ZodUnion<readonly [z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>;
366
368
  identity: z.ZodObject<{
367
369
  name: z.ZodString;
368
370
  description: z.ZodNullable<z.ZodString>;
@@ -521,18 +523,19 @@ export declare const agentManifestSchema: z.ZodObject<{
521
523
  config: z.ZodDefault<z.ZodType<import("./json.mjs").JsonObject, unknown, z.core.$ZodTypeInternals<import("./json.mjs").JsonObject, unknown>>>;
522
524
  source: z.ZodOptional<z.ZodString>;
523
525
  key: z.ZodString;
524
- credentials: z.ZodObject<{
526
+ credentials: z.ZodDefault<z.ZodObject<{
525
527
  app: z.ZodNullable<z.ZodString>;
526
528
  secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
527
- }, z.core.$strip>;
528
- surface: z.ZodObject<{
529
+ }, z.core.$strip>>;
530
+ surface: z.ZodDefault<z.ZodObject<{
529
531
  routes: z.ZodArray<z.ZodObject<{
530
532
  method: z.ZodString;
531
533
  path: z.ZodString;
532
534
  }, z.core.$strip>>;
533
535
  listeners: z.ZodArray<z.ZodString>;
534
536
  placeKinds: z.ZodArray<z.ZodString>;
535
- }, z.core.$strip>;
537
+ resourceResolver: z.ZodDefault<z.ZodBoolean>;
538
+ }, z.core.$strip>>;
536
539
  install: z.ZodOptional<z.ZodString>;
537
540
  }, z.core.$strip>>;
538
541
  roomSurface: z.ZodOptional<z.ZodObject<{
@@ -573,7 +576,7 @@ export declare const agentManifestSchema: z.ZodObject<{
573
576
  }, z.core.$strip>>;
574
577
  }, z.core.$strip>;
575
578
  export declare const resolvedAgentManifestSchema: z.ZodObject<{
576
- version: z.ZodLiteral<4>;
579
+ version: z.ZodUnion<readonly [z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>;
577
580
  identity: z.ZodObject<{
578
581
  name: z.ZodString;
579
582
  description: z.ZodNullable<z.ZodString>;
@@ -598,18 +601,19 @@ export declare const resolvedAgentManifestSchema: z.ZodObject<{
598
601
  config: z.ZodDefault<z.ZodType<import("./json.mjs").JsonObject, unknown, z.core.$ZodTypeInternals<import("./json.mjs").JsonObject, unknown>>>;
599
602
  source: z.ZodOptional<z.ZodString>;
600
603
  key: z.ZodString;
601
- credentials: z.ZodObject<{
604
+ credentials: z.ZodDefault<z.ZodObject<{
602
605
  app: z.ZodNullable<z.ZodString>;
603
606
  secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
604
- }, z.core.$strip>;
605
- surface: z.ZodObject<{
607
+ }, z.core.$strip>>;
608
+ surface: z.ZodDefault<z.ZodObject<{
606
609
  routes: z.ZodArray<z.ZodObject<{
607
610
  method: z.ZodString;
608
611
  path: z.ZodString;
609
612
  }, z.core.$strip>>;
610
613
  listeners: z.ZodArray<z.ZodString>;
611
614
  placeKinds: z.ZodArray<z.ZodString>;
612
- }, z.core.$strip>;
615
+ resourceResolver: z.ZodDefault<z.ZodBoolean>;
616
+ }, z.core.$strip>>;
613
617
  install: z.ZodOptional<z.ZodString>;
614
618
  }, z.core.$strip>>;
615
619
  roomSurface: z.ZodOptional<z.ZodObject<{
@@ -163,7 +163,8 @@ const channelCredentialsSchema = z.object({
163
163
  const channelSurfaceSchema = z.object({
164
164
  routes: z.array(z.object({ method: z.string(), path: z.string() })),
165
165
  listeners: z.array(z.string()),
166
- placeKinds: z.array(z.string())
166
+ placeKinds: z.array(z.string()),
167
+ resourceResolver: z.boolean().default(false)
167
168
  });
168
169
  const roomSurfaceBindingSchema = z.object({
169
170
  channel: providerRefSchema,
@@ -172,8 +173,13 @@ const roomSurfaceBindingSchema = z.object({
172
173
  });
173
174
  const channelBindingSchema = roomSurfaceBindingSchema.extend({
174
175
  key: z.string().min(1),
175
- credentials: channelCredentialsSchema,
176
- surface: channelSurfaceSchema,
176
+ credentials: channelCredentialsSchema.default({ app: null }),
177
+ surface: channelSurfaceSchema.default({
178
+ routes: [],
179
+ listeners: [],
180
+ placeKinds: [],
181
+ resourceResolver: false
182
+ }),
177
183
  install: z.string().optional()
178
184
  });
179
185
  const hookBindingSchema = z.object({
@@ -205,8 +211,8 @@ const harnessBindingSchema = z.object({
205
211
  config: maybeDynamic(jsonValueSchema)
206
212
  });
207
213
  const agentManifestSchema = z.object({
208
- // v4 external-channel writers require a host supporting scoped people and places.
209
- version: z.literal(MANIFEST_VERSION),
214
+ // Earlier versions stay readable: their channel entries take the defaults below.
215
+ version: z.union([z.literal(2), z.literal(3), z.literal(MANIFEST_VERSION)]),
210
216
  identity: identitySchema,
211
217
  harness: harnessBindingSchema,
212
218
  mcpServers: maybeDynamic(z.array(mcpServerBindingSchema)),