@finalai/agent-provider 0.8.0 → 0.10.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 (200) hide show
  1. package/HOSTING.md +334 -245
  2. package/README.md +93 -14
  3. package/dist/modules/canonical-json.d.mts +4 -0
  4. package/dist/modules/canonical-json.mjs +33 -0
  5. package/dist/modules/canonical-json.mjs.map +7 -0
  6. package/dist/modules/channel.d.mts +9 -3
  7. package/dist/modules/channel.mjs.map +2 -2
  8. package/dist/modules/code-host/host.d.mts +10 -0
  9. package/dist/modules/code-host/host.mjs +88 -0
  10. package/dist/modules/code-host/host.mjs.map +7 -0
  11. package/dist/modules/code-host/in-process.d.mts +24 -0
  12. package/dist/modules/code-host/in-process.mjs +89 -0
  13. package/dist/modules/code-host/in-process.mjs.map +7 -0
  14. package/dist/modules/code-host/index.d.mts +4 -0
  15. package/dist/modules/code-host/index.mjs +5 -0
  16. package/dist/modules/code-host/index.mjs.map +7 -0
  17. package/dist/modules/code-host/serverless.d.mts +63 -0
  18. package/dist/modules/code-host/serverless.mjs +27 -0
  19. package/dist/modules/code-host/serverless.mjs.map +7 -0
  20. package/dist/modules/code-host/types.d.mts +152 -0
  21. package/dist/modules/code-host/types.mjs +85 -0
  22. package/dist/modules/code-host/types.mjs.map +7 -0
  23. package/dist/modules/conformance/agent.mjs +72 -6
  24. package/dist/modules/conformance/agent.mjs.map +2 -2
  25. package/dist/modules/conformance/harness-kit.d.mts +9 -2
  26. package/dist/modules/conformance/harness-kit.mjs +224 -63
  27. package/dist/modules/conformance/harness-kit.mjs.map +3 -3
  28. package/dist/modules/conformance/local-harness.d.mts +1 -4
  29. package/dist/modules/conformance/local-harness.mjs +21 -22
  30. package/dist/modules/conformance/local-harness.mjs.map +2 -2
  31. package/dist/modules/conformance/protocol.d.mts +1 -0
  32. package/dist/modules/conformance/protocol.mjs +2 -0
  33. package/dist/modules/conformance/protocol.mjs.map +2 -2
  34. package/dist/modules/conformance/sandbox-kit.d.mts +12 -4
  35. package/dist/modules/conformance/sandbox-kit.mjs +189 -103
  36. package/dist/modules/conformance/sandbox-kit.mjs.map +2 -2
  37. package/dist/modules/conformance/scripted-model/chat-completions.mjs +1 -0
  38. package/dist/modules/conformance/scripted-model/chat-completions.mjs.map +2 -2
  39. package/dist/modules/conformance/scripted-model/directives.d.mts +3 -0
  40. package/dist/modules/conformance/scripted-model/directives.mjs +26 -10
  41. package/dist/modules/conformance/scripted-model/directives.mjs.map +2 -2
  42. package/dist/modules/conformance/scripted-model/messages.mjs +1 -0
  43. package/dist/modules/conformance/scripted-model/messages.mjs.map +2 -2
  44. package/dist/modules/conformance/scripted-model/responses.mjs +2 -0
  45. package/dist/modules/conformance/scripted-model/responses.mjs.map +2 -2
  46. package/dist/modules/conformance/stdio.d.mts +21 -0
  47. package/dist/modules/conformance/stdio.mjs +158 -0
  48. package/dist/modules/conformance/stdio.mjs.map +7 -0
  49. package/dist/modules/credential-routes.d.mts +2 -0
  50. package/dist/modules/credential-routes.mjs +2 -0
  51. package/dist/modules/credential-routes.mjs.map +2 -2
  52. package/dist/modules/document.d.mts +376 -0
  53. package/dist/modules/document.mjs +208 -0
  54. package/dist/modules/document.mjs.map +7 -0
  55. package/dist/modules/harness-configuration.d.mts +16 -0
  56. package/dist/modules/harness-configuration.mjs +83 -0
  57. package/dist/modules/harness-configuration.mjs.map +7 -0
  58. package/dist/modules/harness-definition.d.mts +280 -0
  59. package/dist/modules/harness-definition.mjs +430 -0
  60. package/dist/modules/harness-definition.mjs.map +7 -0
  61. package/dist/modules/harness-provider.d.mts +197 -0
  62. package/dist/modules/harness-provider.mjs +108 -0
  63. package/dist/modules/harness-provider.mjs.map +7 -0
  64. package/dist/modules/harness-requirements.d.mts +19 -0
  65. package/dist/modules/harness-requirements.mjs +40 -0
  66. package/dist/modules/harness-requirements.mjs.map +7 -0
  67. package/dist/modules/harness-start.d.mts +33 -0
  68. package/dist/modules/harness-start.mjs +107 -0
  69. package/dist/modules/harness-start.mjs.map +7 -0
  70. package/dist/modules/harness.d.mts +84 -109
  71. package/dist/modules/harness.mjs +56 -111
  72. package/dist/modules/harness.mjs.map +3 -3
  73. package/dist/modules/identity.d.mts +1 -0
  74. package/dist/modules/identity.mjs +2 -0
  75. package/dist/modules/identity.mjs.map +7 -0
  76. package/dist/modules/index.d.mts +12 -6
  77. package/dist/modules/index.mjs +12 -6
  78. package/dist/modules/index.mjs.map +2 -2
  79. package/dist/modules/inference.d.mts +35 -0
  80. package/dist/modules/inference.mjs +74 -0
  81. package/dist/modules/inference.mjs.map +7 -0
  82. package/dist/modules/local-channel-context.mjs +3 -1
  83. package/dist/modules/local-channel-context.mjs.map +2 -2
  84. package/dist/modules/requirements-check.d.mts +30 -0
  85. package/dist/modules/requirements-check.mjs +164 -0
  86. package/dist/modules/requirements-check.mjs.map +7 -0
  87. package/dist/modules/room-surface.d.mts +0 -5
  88. package/dist/modules/room-surface.mjs.map +2 -2
  89. package/dist/modules/sandbox/client.d.mts +3 -0
  90. package/dist/modules/sandbox/client.mjs +101 -18
  91. package/dist/modules/sandbox/client.mjs.map +2 -2
  92. package/dist/modules/sandbox/grant.d.mts +78 -0
  93. package/dist/modules/sandbox/grant.mjs +134 -0
  94. package/dist/modules/sandbox/grant.mjs.map +7 -0
  95. package/dist/modules/sandbox/index.d.mts +3 -3
  96. package/dist/modules/sandbox/index.mjs +4 -5
  97. package/dist/modules/sandbox/index.mjs.map +2 -2
  98. package/dist/modules/sandbox/mcp-hosted.d.mts +1 -1
  99. package/dist/modules/sandbox/mcp-hosted.mjs +4 -7
  100. package/dist/modules/sandbox/mcp-hosted.mjs.map +2 -2
  101. package/dist/modules/sandbox/mcp.d.mts +4 -2
  102. package/dist/modules/sandbox/mcp.mjs +14 -7
  103. package/dist/modules/sandbox/mcp.mjs.map +2 -2
  104. package/dist/modules/sandbox/memory-sandbox.d.mts +2 -1
  105. package/dist/modules/sandbox/memory-sandbox.mjs +71 -41
  106. package/dist/modules/sandbox/memory-sandbox.mjs.map +2 -2
  107. package/dist/modules/sandbox/networking.d.mts +7 -7
  108. package/dist/modules/sandbox/networking.mjs +16 -9
  109. package/dist/modules/sandbox/networking.mjs.map +2 -2
  110. package/dist/modules/sandbox/remote/adapter.d.mts +30 -0
  111. package/dist/modules/sandbox/remote/adapter.mjs +381 -0
  112. package/dist/modules/sandbox/remote/adapter.mjs.map +7 -0
  113. package/dist/modules/sandbox/remote/errors.d.mts +10 -0
  114. package/dist/modules/sandbox/remote/errors.mjs +62 -0
  115. package/dist/modules/sandbox/remote/errors.mjs.map +7 -0
  116. package/dist/modules/sandbox/remote/index.d.mts +5 -0
  117. package/dist/modules/sandbox/remote/index.mjs +6 -0
  118. package/dist/modules/sandbox/remote/index.mjs.map +7 -0
  119. package/dist/modules/sandbox/remote/ndjson.d.mts +6 -0
  120. package/dist/modules/sandbox/remote/ndjson.mjs +80 -0
  121. package/dist/modules/sandbox/remote/ndjson.mjs.map +7 -0
  122. package/dist/modules/sandbox/remote/platform-api.d.mts +8 -0
  123. package/dist/modules/sandbox/remote/platform-api.mjs +15 -0
  124. package/dist/modules/sandbox/remote/platform-api.mjs.map +7 -0
  125. package/dist/modules/sandbox/remote/preamble.d.mts +7 -0
  126. package/dist/modules/sandbox/remote/preamble.mjs +51 -0
  127. package/dist/modules/sandbox/remote/preamble.mjs.map +7 -0
  128. package/dist/modules/sandbox/remote/serve.d.mts +34 -0
  129. package/dist/modules/sandbox/remote/serve.mjs +519 -0
  130. package/dist/modules/sandbox/remote/serve.mjs.map +7 -0
  131. package/dist/modules/sandbox/remote/testing.d.mts +34 -0
  132. package/dist/modules/sandbox/remote/testing.mjs +275 -0
  133. package/dist/modules/sandbox/remote/testing.mjs.map +7 -0
  134. package/dist/modules/sandbox/seeds.d.mts +2 -2
  135. package/dist/modules/sandbox/seeds.mjs +2 -2
  136. package/dist/modules/sandbox/seeds.mjs.map +2 -2
  137. package/dist/modules/sandbox/server.d.mts +4 -6
  138. package/dist/modules/sandbox/server.mjs +93 -49
  139. package/dist/modules/sandbox/server.mjs.map +2 -2
  140. package/dist/modules/sandbox/setup/apply.d.mts +41 -0
  141. package/dist/modules/sandbox/setup/apply.mjs +204 -0
  142. package/dist/modules/sandbox/setup/apply.mjs.map +7 -0
  143. package/dist/modules/sandbox/setup/describe.d.mts +10 -0
  144. package/dist/modules/sandbox/setup/describe.mjs +62 -0
  145. package/dist/modules/sandbox/setup/describe.mjs.map +7 -0
  146. package/dist/modules/sandbox/setup/index.d.mts +6 -0
  147. package/dist/modules/sandbox/setup/index.mjs +17 -0
  148. package/dist/modules/sandbox/setup/index.mjs.map +7 -0
  149. package/dist/modules/sandbox/setup/paths.d.mts +8 -0
  150. package/dist/modules/sandbox/setup/paths.mjs +18 -0
  151. package/dist/modules/sandbox/setup/paths.mjs.map +7 -0
  152. package/dist/modules/sandbox/setup/schema.d.mts +42 -0
  153. package/dist/modules/sandbox/setup/schema.mjs +58 -0
  154. package/dist/modules/sandbox/setup/schema.mjs.map +7 -0
  155. package/dist/modules/sandbox/tool-policy.d.mts +1 -1
  156. package/dist/modules/sandbox/tool-policy.mjs +1 -1
  157. package/dist/modules/sandbox/tool-policy.mjs.map +2 -2
  158. package/dist/modules/sandbox/types.d.mts +117 -130
  159. package/dist/modules/sandbox/types.mjs +46 -50
  160. package/dist/modules/sandbox/types.mjs.map +3 -3
  161. package/dist/modules/sandbox/wire.d.mts +93 -6
  162. package/dist/modules/sandbox/wire.mjs +61 -38
  163. package/dist/modules/sandbox/wire.mjs.map +2 -2
  164. package/dist/modules/schemas.d.mts +5 -76
  165. package/dist/modules/schemas.mjs +18 -85
  166. package/dist/modules/schemas.mjs.map +2 -2
  167. package/dist/modules/tool-annotations.d.mts +15 -6
  168. package/dist/modules/tool-annotations.mjs +9 -3
  169. package/dist/modules/tool-annotations.mjs.map +2 -2
  170. package/dist/modules/tool-descriptor.d.mts +16 -0
  171. package/dist/modules/tool-descriptor.mjs +19 -0
  172. package/dist/modules/tool-descriptor.mjs.map +7 -0
  173. package/dist/modules/tool-patterns.d.mts +7 -7
  174. package/dist/modules/tool-patterns.mjs +10 -9
  175. package/dist/modules/tool-patterns.mjs.map +2 -2
  176. package/package.json +86 -36
  177. package/dist/modules/credentials.d.mts +0 -206
  178. package/dist/modules/credentials.mjs +0 -207
  179. package/dist/modules/credentials.mjs.map +0 -7
  180. package/dist/modules/dynamic.d.mts +0 -40
  181. package/dist/modules/dynamic.mjs +0 -79
  182. package/dist/modules/dynamic.mjs.map +0 -7
  183. package/dist/modules/hosted-bindings.d.mts +0 -15
  184. package/dist/modules/hosted-bindings.mjs +0 -21
  185. package/dist/modules/hosted-bindings.mjs.map +0 -7
  186. package/dist/modules/manifest.d.mts +0 -787
  187. package/dist/modules/manifest.mjs +0 -320
  188. package/dist/modules/manifest.mjs.map +0 -7
  189. package/dist/modules/provider-ref.d.mts +0 -29
  190. package/dist/modules/provider-ref.mjs +0 -55
  191. package/dist/modules/provider-ref.mjs.map +0 -7
  192. package/dist/modules/sandbox/open-scope-node.d.mts +0 -4
  193. package/dist/modules/sandbox/open-scope-node.mjs +0 -19
  194. package/dist/modules/sandbox/open-scope-node.mjs.map +0 -7
  195. package/dist/modules/sandbox/open-scope.d.mts +0 -16
  196. package/dist/modules/sandbox/open-scope.mjs +0 -66
  197. package/dist/modules/sandbox/open-scope.mjs.map +0 -7
  198. package/dist/modules/sandbox/workspace-identity.d.mts +0 -5
  199. package/dist/modules/sandbox/workspace-identity.mjs +0 -14
  200. package/dist/modules/sandbox/workspace-identity.mjs.map +0 -7
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/memory-sandbox.ts"],
4
- "sourcesContent": ["import * as z from 'zod';\nimport type { JsonValue } from \"../json.mjs\";\nimport { encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { runMemoryArgv, runMemoryScript, type MemoryShellFsIface } from \"./memory-shell.mjs\";\nimport { normalizePosixPath, posixDirname, resolvePosixPath } from \"./paths.mjs\";\nimport {\n defineSandboxProvider,\n NetworkPolicy,\n PLATFORM_ENVIRONMENT_NAMES,\n platformProcessEnvironment,\n PortProtocol,\n reportPlatformNetworkPolicy,\n SandboxEntryType,\n withPlatformEgressHosts,\n writePlatformFiles,\n type DirEntryIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxProviderHandleIface,\n type SandboxStartContextIface,\n type StatIface,\n} from \"./types.mjs\";\n\n// An in-memory reference sandbox: a virtual filesystem plus a tiny command\n// interpreter (memory-shell.ts). Used by tests and the conformance kit, and as\n// the smallest complete example of the sandbox contract.\n\nexport interface MemorySandboxIface extends NetworkSandboxSessionIface {\n readonly networkPolicy: NetworkPolicyIface;\n readonly stopped: boolean;\n}\n\nexport interface CreateMemorySandboxArgsIface {\n id?: string;\n files?: Record<string, string | Uint8Array>;\n cwd?: string;\n ports?: number[];\n portUrl?: (args: { port: number; protocol: PortProtocol }) => string;\n // Optional capabilities; present only when given.\n computerUse?: () => Promise<SandboxMcpEndpoint>;\n screen?: NetworkSandboxSessionIface['screen'];\n localMcp?: () => Promise<SandboxMcpEndpoint[]>;\n networkPolicy?: boolean;\n // Every process's environment, under per-call env; read again for each process.\n baseEnv?: () => Promise<Record<string, string>>;\n now?: () => Date;\n}\n\ntype MemoryEntry =\n | { type: 'file'; data: Uint8Array; modifiedAt: Date }\n | { type: 'directory'; modifiedAt: Date };\n\ninterface ProcessOutputsIface {\n stdout: ReadableStreamDefaultController<Uint8Array> | null;\n stderr: ReadableStreamDefaultController<Uint8Array> | null;\n}\n\nconst fsError = (code: string, message: string) =>\n Object.assign(new Error(`${code}: ${message}`), { code });\n\nconst abortableSleep = (ms: number, signal: AbortSignal): Promise<void> =>\n new Promise<void>((resolve, reject) => {\n if (signal.aborted) {\n reject(signal.reason);\n return;\n }\n const timer = setTimeout(() => {\n signal.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n const onAbort = () => {\n clearTimeout(timer);\n reject(signal.reason);\n };\n signal.addEventListener('abort', onAbort, { once: true });\n });\n\nconst signalExitCode = (signal: string | undefined): number => {\n if (signal === 'SIGKILL' || signal === 'KILL' || signal === '9') return 137;\n if (signal === 'SIGINT' || signal === 'INT') return 130;\n return 143;\n};\n\nexport const createMemorySandbox = (\n args: CreateMemorySandboxArgsIface = {},\n): MemorySandboxIface => {\n const id = args.id ?? `memory-${crypto.randomUUID()}`;\n const cwd = normalizePosixPath(args.cwd ?? '/workspace');\n const now = args.now ?? (() => new Date());\n const entries = new Map<string, MemoryEntry>();\n const processes = new Set<SandboxProcessIface>();\n let networkPolicy: NetworkPolicyIface = { mode: NetworkPolicy.AllowAll };\n let stopped = false;\n\n const resolve = (path: string) => resolvePosixPath(cwd, path);\n\n const ensureDirectory = (path: string) => {\n const normalized = normalizePosixPath(path);\n const existing = entries.get(normalized);\n if (existing?.type === 'directory') return;\n if (existing?.type === 'file') throw fsError('ENOTDIR', `${normalized} is a file`);\n if (normalized !== '/') ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'directory', modifiedAt: now() });\n };\n\n const putFile = (path: string, data: Uint8Array) => {\n const normalized = normalizePosixPath(path);\n if (entries.get(normalized)?.type === 'directory')\n throw fsError('EISDIR', `${normalized} is a directory`);\n ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'file', data, modifiedAt: now() });\n };\n\n const children = (path: string): string[] => {\n const prefix = path === '/' ? '/' : `${path}/`;\n const names: string[] = [];\n for (const key of entries.keys()) {\n if (key !== path && key.startsWith(prefix) && !key.slice(prefix.length).includes('/')) {\n names.push(key.slice(prefix.length));\n }\n }\n return names.sort();\n };\n\n ensureDirectory('/');\n ensureDirectory(cwd);\n for (const [path, content] of Object.entries(args.files ?? {})) {\n putFile(resolve(path), content instanceof Uint8Array ? content : utf8Encode(content));\n }\n\n const shellFs: MemoryShellFsIface = {\n readFile: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry?.type === 'file' ? entry.data : null;\n },\n writeFile: (path, data, options) => {\n const entry = entries.get(normalizePosixPath(path));\n if (options.append && entry?.type === 'file') {\n const merged = new Uint8Array(entry.data.byteLength + data.byteLength);\n merged.set(entry.data, 0);\n merged.set(data, entry.data.byteLength);\n putFile(path, merged);\n return;\n }\n putFile(path, data);\n },\n kind: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry == null ? null : entry.type;\n },\n list: (path) => {\n const normalized = normalizePosixPath(path);\n return entries.get(normalized)?.type === 'directory' ? children(normalized) : null;\n },\n mkdir: (path, options) => {\n const normalized = normalizePosixPath(path);\n if (!options.parents && entries.get(posixDirname(normalized))?.type !== 'directory') {\n throw fsError('ENOENT', 'No such file or directory');\n }\n if (!options.parents && entries.has(normalized)) throw fsError('EEXIST', 'File exists');\n ensureDirectory(normalized);\n },\n };\n\n const statOf = (path: string): StatIface | null => {\n const entry = entries.get(path);\n if (entry == null) return null;\n return {\n path,\n type: entry.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: entry.type === 'file' ? entry.data.byteLength : 0,\n modifiedAt: entry.modifiedAt.toISOString(),\n mode: entry.type === 'file' ? 0o644 : 0o755,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const env = { ...(await args.baseEnv?.()), ...options.env };\n const controller = new AbortController();\n let killedWith: string | null = null;\n const outputs: ProcessOutputsIface = { stdout: null, stderr: null };\n const stdout = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stdout = c;\n },\n // A cancelled stream takes no more output.\n cancel: () => {\n outputs.stdout = null;\n },\n });\n const stderr = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stderr = c;\n },\n // A cancelled stream takes no more output.\n cancel: () => {\n outputs.stderr = null;\n },\n });\n let self: SandboxProcessIface | null = null;\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (options.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (options.stdin instanceof ReadableStream) {\n stdinSource = options.stdin;\n } else {\n const bytes = utf8Encode(options.stdin);\n stdinSource = new ReadableStream<Uint8Array>({\n start: (c) => {\n if (bytes.byteLength > 0) c.enqueue(bytes);\n c.close();\n },\n });\n }\n const stdinReader = stdinSource.getReader();\n const abortPromise = new Promise<null>((resolveAbort) =>\n controller.signal.addEventListener('abort', () => resolveAbort(null), { once: true }),\n );\n const readStdin = async (): Promise<Uint8Array | null> => {\n const result = await Promise.race([stdinReader.read(), abortPromise]);\n if (result == null) throw controller.signal.reason;\n return result.done ? null : result.value;\n };\n const emit = (\n target: ReadableStreamDefaultController<Uint8Array> | null,\n bytes: Uint8Array,\n ) => {\n if (bytes.byteLength > 0) target?.enqueue(bytes.slice());\n };\n const context = {\n fs: shellFs,\n io: {\n readStdin,\n stdout: (bytes: Uint8Array) => emit(outputs.stdout, bytes),\n stderr: (bytes: Uint8Array) => emit(outputs.stderr, bytes),\n signal: controller.signal,\n },\n cwd: options.cwd == null ? cwd : resolve(options.cwd),\n env,\n sleep: abortableSleep,\n };\n const timeout =\n options.timeoutMs == null\n ? null\n : setTimeout(() => {\n killedWith = 'timeout';\n controller.abort(new Error('timed out'));\n }, options.timeoutMs);\n const onAbortSignal = () => {\n killedWith ??= 'SIGTERM';\n controller.abort(new Error('aborted'));\n };\n options.abortSignal?.addEventListener('abort', onAbortSignal, { once: true });\n const exited = (async (): Promise<{ exitCode: number }> => {\n let exitCode: number;\n try {\n if (context.fs.kind(context.cwd) !== 'directory') {\n context.io.stderr(utf8Encode(`cd: ${context.cwd}: No such file or directory\\n`));\n exitCode = 1;\n } else if (options.shell === true) {\n const script = [options.command, ...(options.args ?? [])].join(' ');\n exitCode = await runMemoryScript({ ...context, script });\n } else {\n exitCode = await runMemoryArgv({\n ...context,\n argv: [options.command, ...(options.args ?? [])],\n });\n }\n } catch (error) {\n if (!controller.signal.aborted) {\n context.io.stderr(\n utf8Encode(`${error instanceof Error ? error.message : String(error)}\\n`),\n );\n exitCode = 1;\n } else {\n exitCode = killedWith === 'timeout' ? 124 : signalExitCode(killedWith ?? undefined);\n }\n }\n if (timeout != null) clearTimeout(timeout);\n options.abortSignal?.removeEventListener('abort', onAbortSignal);\n stdinReader.cancel().catch(() => undefined);\n outputs.stdout?.close();\n outputs.stderr?.close();\n if (self != null) processes.delete(self);\n return { exitCode };\n })();\n const child: SandboxProcessIface = {\n pid: null,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n wait: () => exited,\n kill: async (signal) => {\n killedWith ??= signal ?? 'SIGTERM';\n controller.abort(new Error(`killed (${signal ?? 'SIGTERM'})`));\n await exited;\n },\n };\n self = child;\n processes.add(child);\n return child;\n };\n\n const sandbox: MemorySandboxIface = {\n id,\n defaultWorkingDirectory: cwd,\n ports: args.ports ?? [],\n get description() {\n return `In-memory sandbox ${id}. Working directory ${cwd}. Commands: echo, cat, ls, pwd, cd, true, false, sleep, exit, mkdir, sh -c.`;\n },\n get networkPolicy() {\n return networkPolicy;\n },\n get stopped() {\n return stopped;\n },\n readFile: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) return null;\n if (entry.type === 'directory') throw fsError('EISDIR', `${path} is a directory`);\n const data = entry.data;\n const chunkBytes = 64 * 1024;\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= data.byteLength) {\n controller.close();\n return;\n }\n const end = Math.min(data.byteLength, offset + chunkBytes);\n controller.enqueue(data.slice(offset, end));\n offset = end;\n },\n });\n },\n readBinaryFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile: async (options) => {\n const data = await readAllBytes(options.content);\n putFile(resolve(options.path), data);\n },\n writeBinaryFile: async (options) => {\n putFile(resolve(options.path), options.content.slice());\n },\n writeTextFile: async (options) => {\n putFile(resolve(options.path), encodeSandboxText(options.content, options.encoding));\n },\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options) => statOf(resolve(options.path)),\n readDir: async (options): Promise<DirEntryIface[]> => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) throw fsError('ENOENT', `${path}: No such file or directory`);\n if (entry.type !== 'directory') throw fsError('ENOTDIR', `${path} is not a directory`);\n return children(path).map((name) => {\n const childPath = path === '/' ? `/${name}` : `${path}/${name}`;\n const child = entries.get(childPath);\n return {\n name,\n path: childPath,\n type: child?.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: child?.type === 'file' ? child.data.byteLength : null,\n };\n });\n },\n resolvePath: resolve,\n removePath: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) {\n if (options.force === true) return;\n throw fsError('ENOENT', `${path}: No such file or directory`);\n }\n if (path === '/') throw fsError('EPERM', 'refusing to remove /');\n if (entry.type === 'directory') {\n const prefix = `${path}/`;\n const nested = [...entries.keys()].filter((key) => key.startsWith(prefix));\n if (nested.length > 0 && options.recursive !== true)\n throw fsError('ENOTEMPTY', `${path}: Directory not empty`);\n for (const key of nested) entries.delete(key);\n }\n entries.delete(path);\n },\n getPortEndpoint: async (options) => {\n const protocol = options.protocol ?? PortProtocol.Http;\n return {\n url:\n args.portUrl?.({ port: options.port, protocol }) ??\n `${protocol}://127.0.0.1:${options.port}`,\n };\n },\n getPortUrl: async (options) => (await sandbox.getPortEndpoint(options)).url,\n stop: async () => {\n stopped = true;\n await Promise.all([...processes].map((child) => child.kill()));\n },\n destroy: async () => {\n await sandbox.stop();\n entries.clear();\n ensureDirectory('/');\n },\n };\n if (args.networkPolicy === true) {\n sandbox.setNetworkPolicy = async (policy) => {\n networkPolicy = policy;\n };\n }\n if (args.computerUse != null) sandbox.computerUse = args.computerUse;\n if (args.screen != null) sandbox.screen = args.screen;\n if (args.localMcp != null) sandbox.localMcp = args.localMcp;\n return sandbox;\n};\n\n// Every file of a memory sandbox as path \u2192 base64-free UTF-8 text (binary\n// files are skipped); handy for assertions.\nexport const memorySandboxTextFiles = async (\n sandbox: NetworkSandboxSessionIface,\n root = '/',\n): Promise<Record<string, string>> => {\n const out: Record<string, string> = {};\n const walk = async (path: string) => {\n for (const entry of await sandbox.readDir({ path })) {\n if (entry.type === SandboxEntryType.Directory) await walk(entry.path);\n else {\n const text = await sandbox.readTextFile({ path: entry.path });\n if (text != null) out[entry.path] = text;\n }\n }\n };\n await walk(root);\n return out;\n};\n\nconst memoryEnvironmentSchema = z\n .object({\n files: z.record(z.string(), z.string()).optional(),\n cwd: z.string().optional(),\n ports: z.array(z.number().int()).optional(),\n // Plain variables for every process, under the platform's.\n env: z.record(z.string(), z.string()).optional(),\n // Recorded, not enforced: the memory sandbox has no network.\n networkPolicy: z\n .object({ mode: z.nativeEnum(NetworkPolicy), allow: z.array(z.string()).optional() })\n .optional(),\n })\n .nullable()\n .optional();\n\nexport type MemorySandboxArtifact = { files: Record<string, string>; cwd: string; ports: number[] };\nexport type MemorySandboxState = { id: string };\n\nconst fingerprint = (value: string): string => {\n // FNV-1a, enough for a content key in an example provider.\n let hash = 0x811c9dc5;\n for (let i = 0; i < value.length; i += 1) {\n hash ^= value.charCodeAt(i);\n hash = Math.imul(hash, 0x01000193) >>> 0;\n }\n return hash.toString(16).padStart(8, '0');\n};\n\nconst memoryHandle = (\n sandbox: MemorySandboxIface,\n): SandboxProviderHandleIface<MemorySandboxIface> => ({\n sandbox,\n onSandboxStop: () => sandbox.stop(),\n onSandboxDelete: () => sandbox.destroy(),\n onRuntimeShutdown: () => sandbox.stop(),\n});\n\n// Example provider over the memory sandbox. Ephemeral: `resume` starts again\n// from the prepared artifact, so files written before a park are lost.\nexport const memorySandboxProvider = defineSandboxProvider<\n JsonValue,\n JsonValue,\n MemorySandboxArtifact,\n MemorySandboxState,\n MemorySandboxIface\n>({\n name: 'memory',\n environment: (rawOptions) => {\n const options = memoryEnvironmentSchema.parse(rawOptions) ?? {};\n const artifactFor = (files: Record<string, string>): MemorySandboxArtifact => ({\n files: { ...options.files, ...files },\n cwd: options.cwd ?? '/workspace',\n ports: options.ports ?? [],\n });\n const specEnv = options.env ?? {};\n const open = async (\n ctx: SandboxStartContextIface,\n bindingId: string,\n artifact: MemorySandboxArtifact,\n ) => {\n for (const name of Object.keys(specEnv))\n if (PLATFORM_ENVIRONMENT_NAMES.has(name)) throw new Error(`${name} is reserved`);\n const sandbox = createMemorySandbox({\n id: bindingId,\n files: artifact.files,\n cwd: artifact.cwd,\n ports: artifact.ports,\n networkPolicy: options.networkPolicy != null,\n baseEnv: platformProcessEnvironment(ctx, specEnv),\n });\n if (options.networkPolicy != null) {\n const policy = withPlatformEgressHosts(ctx, options.networkPolicy);\n await sandbox.setNetworkPolicy?.(policy);\n await reportPlatformNetworkPolicy(ctx, policy);\n }\n await writePlatformFiles(ctx, sandbox);\n return sandbox;\n };\n return {\n artifactKey: async (ctx) => `memory:${fingerprint(JSON.stringify(artifactFor(ctx.files)))}`,\n prepare: async (ctx) => artifactFor(ctx.files),\n // An in-memory sandbox runs from the moment it exists.\n awaitRunning: async () => undefined,\n start: async (ctx, _openOptions, artifact) => ({\n handle: memoryHandle(await open(ctx, ctx.session.bindingId, artifact)),\n state: { id: ctx.session.bindingId },\n }),\n resume: async (ctx, artifact, state) => memoryHandle(await open(ctx, state.id, artifact)),\n park: async (_ctx, _artifact, state) => state,\n };\n },\n});\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import { Capability, FilesAccess, ShellAccess } from '@finalai/agent-protocol';\nimport * as z from 'zod';\nimport type { JsonValue } from \"../json.mjs\";\nimport { encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { runMemoryArgv, runMemoryScript, type MemoryShellFsIface } from \"./memory-shell.mjs\";\nimport { normalizePosixPath, posixDirname, resolvePosixPath } from \"./paths.mjs\";\nimport {\n defineSandboxProvider,\n NetworkPolicy,\n PLATFORM_ENVIRONMENT_NAMES,\n platformProcessEnvironment,\n PortProtocol,\n reportPlatformNetworkPolicy,\n SandboxEntryType,\n withPlatformEgressHosts,\n writePlatformFiles,\n type DirEntryIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxProviderHandleIface,\n type SandboxResourceContextIface,\n type StatIface,\n} from \"./types.mjs\";\n\n// An in-memory reference sandbox: a virtual filesystem plus a tiny command\n// interpreter (memory-shell.ts). Used by tests and the conformance kit, and as\n// the smallest complete example of the sandbox contract.\n\nexport interface MemorySandboxIface extends NetworkSandboxSessionIface {\n readonly networkPolicy: NetworkPolicyIface;\n readonly stopped: boolean;\n}\n\nexport interface CreateMemorySandboxArgsIface {\n id?: string;\n files?: Record<string, string | Uint8Array>;\n cwd?: string;\n ports?: number[];\n portUrl?: (args: { port: number; protocol: PortProtocol }) => string;\n // Optional capabilities; present only when given.\n computerUse?: () => Promise<SandboxMcpEndpoint>;\n screen?: NetworkSandboxSessionIface['screen'];\n localMcp?: () => Promise<SandboxMcpEndpoint[]>;\n networkPolicy?: boolean;\n // Every process's environment, under per-call env; read again for each process.\n baseEnv?: () => Promise<Record<string, string>>;\n now?: () => Date;\n}\n\ntype MemoryEntry =\n | { type: 'file'; data: Uint8Array; modifiedAt: Date }\n | { type: 'directory'; modifiedAt: Date };\n\ninterface ProcessOutputsIface {\n stdout: ReadableStreamDefaultController<Uint8Array> | null;\n stderr: ReadableStreamDefaultController<Uint8Array> | null;\n}\n\nconst fsError = (code: string, message: string) =>\n Object.assign(new Error(`${code}: ${message}`), { code });\n\nconst abortableSleep = (ms: number, signal: AbortSignal): Promise<void> =>\n new Promise<void>((resolve, reject) => {\n if (signal.aborted) {\n reject(signal.reason);\n return;\n }\n const timer = setTimeout(() => {\n signal.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n const onAbort = () => {\n clearTimeout(timer);\n reject(signal.reason);\n };\n signal.addEventListener('abort', onAbort, { once: true });\n });\n\nconst signalExitCode = (signal: string | undefined): number => {\n if (signal === 'SIGKILL' || signal === 'KILL' || signal === '9') return 137;\n if (signal === 'SIGINT' || signal === 'INT') return 130;\n return 143;\n};\n\nexport const createMemorySandbox = (\n args: CreateMemorySandboxArgsIface = {},\n): MemorySandboxIface => {\n const id = args.id ?? `memory-${crypto.randomUUID()}`;\n const cwd = normalizePosixPath(args.cwd ?? '/workspace');\n const now = args.now ?? (() => new Date());\n const entries = new Map<string, MemoryEntry>();\n const processes = new Set<SandboxProcessIface>();\n let networkPolicy: NetworkPolicyIface = { mode: NetworkPolicy.AllowAll };\n let stopped = false;\n\n const resolve = (path: string) => resolvePosixPath(cwd, path);\n\n const ensureDirectory = (path: string) => {\n const normalized = normalizePosixPath(path);\n const existing = entries.get(normalized);\n if (existing?.type === 'directory') return;\n if (existing?.type === 'file') throw fsError('ENOTDIR', `${normalized} is a file`);\n if (normalized !== '/') ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'directory', modifiedAt: now() });\n };\n\n const putFile = (path: string, data: Uint8Array) => {\n const normalized = normalizePosixPath(path);\n if (entries.get(normalized)?.type === 'directory')\n throw fsError('EISDIR', `${normalized} is a directory`);\n ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'file', data, modifiedAt: now() });\n };\n\n const children = (path: string): string[] => {\n const prefix = path === '/' ? '/' : `${path}/`;\n const names: string[] = [];\n for (const key of entries.keys()) {\n if (key !== path && key.startsWith(prefix) && !key.slice(prefix.length).includes('/')) {\n names.push(key.slice(prefix.length));\n }\n }\n return names.sort();\n };\n\n ensureDirectory('/');\n ensureDirectory(cwd);\n for (const [path, content] of Object.entries(args.files ?? {})) {\n putFile(resolve(path), content instanceof Uint8Array ? content : utf8Encode(content));\n }\n\n const shellFs: MemoryShellFsIface = {\n readFile: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry?.type === 'file' ? entry.data : null;\n },\n writeFile: (path, data, options) => {\n const entry = entries.get(normalizePosixPath(path));\n if (options.append && entry?.type === 'file') {\n const merged = new Uint8Array(entry.data.byteLength + data.byteLength);\n merged.set(entry.data, 0);\n merged.set(data, entry.data.byteLength);\n putFile(path, merged);\n return;\n }\n putFile(path, data);\n },\n kind: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry == null ? null : entry.type;\n },\n list: (path) => {\n const normalized = normalizePosixPath(path);\n return entries.get(normalized)?.type === 'directory' ? children(normalized) : null;\n },\n mkdir: (path, options) => {\n const normalized = normalizePosixPath(path);\n if (!options.parents && entries.get(posixDirname(normalized))?.type !== 'directory') {\n throw fsError('ENOENT', 'No such file or directory');\n }\n if (!options.parents && entries.has(normalized)) throw fsError('EEXIST', 'File exists');\n ensureDirectory(normalized);\n },\n };\n\n const statOf = (path: string): StatIface | null => {\n const entry = entries.get(path);\n if (entry == null) return null;\n return {\n path,\n type: entry.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: entry.type === 'file' ? entry.data.byteLength : 0,\n modifiedAt: entry.modifiedAt.toISOString(),\n mode: entry.type === 'file' ? 0o644 : 0o755,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const env = { ...(await args.baseEnv?.()), ...options.env };\n const controller = new AbortController();\n let killedWith: string | null = null;\n const outputs: ProcessOutputsIface = { stdout: null, stderr: null };\n const stdout = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stdout = c;\n },\n // A cancelled stream takes no more output.\n cancel: () => {\n outputs.stdout = null;\n },\n });\n const stderr = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stderr = c;\n },\n // A cancelled stream takes no more output.\n cancel: () => {\n outputs.stderr = null;\n },\n });\n let self: SandboxProcessIface | null = null;\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (options.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (options.stdin instanceof ReadableStream) {\n stdinSource = options.stdin;\n } else {\n const bytes = utf8Encode(options.stdin);\n stdinSource = new ReadableStream<Uint8Array>({\n start: (c) => {\n if (bytes.byteLength > 0) c.enqueue(bytes);\n c.close();\n },\n });\n }\n const stdinReader = stdinSource.getReader();\n const abortPromise = new Promise<null>((resolveAbort) =>\n controller.signal.addEventListener('abort', () => resolveAbort(null), { once: true }),\n );\n const readStdin = async (): Promise<Uint8Array | null> => {\n const result = await Promise.race([stdinReader.read(), abortPromise]);\n if (result == null) throw controller.signal.reason;\n return result.done ? null : result.value;\n };\n const emit = (\n target: ReadableStreamDefaultController<Uint8Array> | null,\n bytes: Uint8Array,\n ) => {\n if (bytes.byteLength > 0) target?.enqueue(bytes.slice());\n };\n const context = {\n fs: shellFs,\n io: {\n readStdin,\n stdout: (bytes: Uint8Array) => emit(outputs.stdout, bytes),\n stderr: (bytes: Uint8Array) => emit(outputs.stderr, bytes),\n signal: controller.signal,\n },\n cwd: options.cwd == null ? cwd : resolve(options.cwd),\n env,\n sleep: abortableSleep,\n };\n const timeout =\n options.timeoutMs == null\n ? null\n : setTimeout(() => {\n killedWith = 'timeout';\n controller.abort(new Error('timed out'));\n }, options.timeoutMs);\n const onAbortSignal = () => {\n killedWith ??= 'SIGTERM';\n controller.abort(new Error('aborted'));\n };\n options.abortSignal?.addEventListener('abort', onAbortSignal, { once: true });\n const exited = (async (): Promise<{ exitCode: number }> => {\n let exitCode: number;\n try {\n if (context.fs.kind(context.cwd) !== 'directory') {\n context.io.stderr(utf8Encode(`cd: ${context.cwd}: No such file or directory\\n`));\n exitCode = 1;\n } else if (options.shell === true) {\n const script = [options.command, ...(options.args ?? [])].join(' ');\n exitCode = await runMemoryScript({ ...context, script });\n } else {\n exitCode = await runMemoryArgv({\n ...context,\n argv: [options.command, ...(options.args ?? [])],\n });\n }\n } catch (error) {\n if (!controller.signal.aborted) {\n context.io.stderr(\n utf8Encode(`${error instanceof Error ? error.message : String(error)}\\n`),\n );\n exitCode = 1;\n } else {\n exitCode = killedWith === 'timeout' ? 124 : signalExitCode(killedWith ?? undefined);\n }\n }\n if (timeout != null) clearTimeout(timeout);\n options.abortSignal?.removeEventListener('abort', onAbortSignal);\n stdinReader.cancel().catch(() => undefined);\n outputs.stdout?.close();\n outputs.stderr?.close();\n if (self != null) processes.delete(self);\n return { exitCode };\n })();\n const child: SandboxProcessIface = {\n pid: null,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n wait: () => exited,\n kill: async (signal) => {\n killedWith ??= signal ?? 'SIGTERM';\n controller.abort(new Error(`killed (${signal ?? 'SIGTERM'})`));\n await exited;\n },\n };\n self = child;\n processes.add(child);\n return child;\n };\n\n const sandbox: MemorySandboxIface = {\n id,\n defaultWorkingDirectory: cwd,\n ports: args.ports ?? [],\n get description() {\n return `In-memory sandbox ${id}. Working directory ${cwd}. Commands: echo, cat, ls, pwd, cd, true, false, sleep, exit, mkdir, sh -c.`;\n },\n get networkPolicy() {\n return networkPolicy;\n },\n get stopped() {\n return stopped;\n },\n readFile: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) return null;\n if (entry.type === 'directory') throw fsError('EISDIR', `${path} is a directory`);\n const data = entry.data;\n const chunkBytes = 64 * 1024;\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= data.byteLength) {\n controller.close();\n return;\n }\n const end = Math.min(data.byteLength, offset + chunkBytes);\n controller.enqueue(data.slice(offset, end));\n offset = end;\n },\n });\n },\n readBinaryFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile: async (options) => {\n const data = await readAllBytes(options.content);\n putFile(resolve(options.path), data);\n },\n writeBinaryFile: async (options) => {\n putFile(resolve(options.path), options.content.slice());\n },\n writeTextFile: async (options) => {\n putFile(resolve(options.path), encodeSandboxText(options.content, options.encoding));\n },\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options) => statOf(resolve(options.path)),\n readDir: async (options): Promise<DirEntryIface[]> => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) throw fsError('ENOENT', `${path}: No such file or directory`);\n if (entry.type !== 'directory') throw fsError('ENOTDIR', `${path} is not a directory`);\n return children(path).map((name) => {\n const childPath = path === '/' ? `/${name}` : `${path}/${name}`;\n const child = entries.get(childPath);\n return {\n name,\n path: childPath,\n type: child?.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: child?.type === 'file' ? child.data.byteLength : null,\n };\n });\n },\n resolvePath: resolve,\n removePath: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) {\n if (options.force === true) return;\n throw fsError('ENOENT', `${path}: No such file or directory`);\n }\n if (path === '/') throw fsError('EPERM', 'refusing to remove /');\n if (entry.type === 'directory') {\n const prefix = `${path}/`;\n const nested = [...entries.keys()].filter((key) => key.startsWith(prefix));\n if (nested.length > 0 && options.recursive !== true)\n throw fsError('ENOTEMPTY', `${path}: Directory not empty`);\n for (const key of nested) entries.delete(key);\n }\n entries.delete(path);\n },\n getPortEndpoint: async (options) => {\n const protocol = options.protocol ?? PortProtocol.Http;\n return {\n url:\n args.portUrl?.({ port: options.port, protocol }) ??\n `${protocol}://127.0.0.1:${options.port}`,\n };\n },\n getPortUrl: async (options) => (await sandbox.getPortEndpoint(options)).url,\n stop: async () => {\n stopped = true;\n await Promise.all([...processes].map((child) => child.kill()));\n },\n destroy: async () => {\n await sandbox.stop();\n entries.clear();\n ensureDirectory('/');\n },\n };\n if (args.networkPolicy === true) {\n sandbox.setNetworkPolicy = async (policy) => {\n networkPolicy = policy;\n };\n }\n if (args.computerUse != null) sandbox.computerUse = args.computerUse;\n if (args.screen != null) sandbox.screen = args.screen;\n if (args.localMcp != null) sandbox.localMcp = args.localMcp;\n return sandbox;\n};\n\n// Every file of a memory sandbox as path \u2192 base64-free UTF-8 text (binary\n// files are skipped); handy for assertions.\nexport const memorySandboxTextFiles = async (\n sandbox: NetworkSandboxSessionIface,\n root = '/',\n): Promise<Record<string, string>> => {\n const out: Record<string, string> = {};\n const walk = async (path: string) => {\n for (const entry of await sandbox.readDir({ path })) {\n if (entry.type === SandboxEntryType.Directory) await walk(entry.path);\n else {\n const text = await sandbox.readTextFile({ path: entry.path });\n if (text != null) out[entry.path] = text;\n }\n }\n };\n await walk(root);\n return out;\n};\n\nconst memoryEnvironmentSchema = z\n .object({\n files: z.record(z.string(), z.string()).optional(),\n cwd: z.string().optional(),\n ports: z.array(z.number().int()).optional(),\n // Plain variables for every process, under the platform's.\n env: z.record(z.string(), z.string()).optional(),\n // Recorded, not enforced: the memory sandbox has no network.\n networkPolicy: z\n .object({ mode: z.nativeEnum(NetworkPolicy), allow: z.array(z.string()).optional() })\n .optional(),\n })\n .nullable()\n .optional();\n\nexport type MemorySandboxArtifact = { files: Record<string, string>; cwd: string; ports: number[] };\nexport type MemorySandboxState = { id: string };\n\nconst fingerprint = (value: string): string => {\n // FNV-1a, enough for a content key in an example provider.\n let hash = 0x811c9dc5;\n for (let i = 0; i < value.length; i += 1) {\n hash ^= value.charCodeAt(i);\n hash = Math.imul(hash, 0x01000193) >>> 0;\n }\n return hash.toString(16).padStart(8, '0');\n};\n\nconst memoryHandle = (\n sandbox: MemorySandboxIface,\n): SandboxProviderHandleIface<MemorySandboxIface> => ({\n sandbox,\n onSandboxStop: () => sandbox.stop(),\n onSandboxDelete: () => sandbox.destroy(),\n onRuntimeShutdown: () => sandbox.stop(),\n});\n\ninterface MemoryRecordIface {\n sandbox: MemorySandboxIface;\n // False after a park: the disk is kept, its processes are gone.\n running: boolean;\n}\n\n// Example provider over the memory sandbox. Each provider keeps its sandboxes\n// in memory: detach keeps one running, park stops its processes and keeps its\n// files, delete forgets it. Attaching one the process no longer holds starts\n// again from the prepared artifact, as a fresh disk.\nexport const createMemorySandboxProvider = () => {\n const records = new Map<string, MemoryRecordIface>();\n return defineSandboxProvider<\n JsonValue,\n MemorySandboxArtifact,\n MemorySandboxState,\n MemorySandboxIface\n >({\n name: 'memory',\n environment: (rawOptions) => {\n const options = memoryEnvironmentSchema.parse(rawOptions) ?? {};\n const artifactFor = (files: Record<string, string>): MemorySandboxArtifact => ({\n files: { ...options.files, ...files },\n cwd: options.cwd ?? '/workspace',\n ports: options.ports ?? [],\n });\n const specEnv = options.env ?? {};\n for (const name of Object.keys(specEnv))\n if (PLATFORM_ENVIRONMENT_NAMES.has(name)) throw new Error(`${name} is reserved`);\n // Each attach reports and applies the policy, then writes the platform's files.\n const ready = async (ctx: SandboxResourceContextIface, sandbox: MemorySandboxIface) => {\n if (options.networkPolicy != null) {\n const policy = withPlatformEgressHosts(ctx, options.networkPolicy);\n await sandbox.setNetworkPolicy?.(policy);\n await reportPlatformNetworkPolicy(ctx, policy);\n }\n await writePlatformFiles(ctx, sandbox);\n };\n return {\n capabilities: async () => ({\n [Capability.Files]: FilesAccess.Write,\n [Capability.Shell]: ShellAccess.Execute,\n }),\n artifactKey: async (ctx) => `memory:${fingerprint(JSON.stringify(artifactFor(ctx.files)))}`,\n prepare: async (ctx) => artifactFor(ctx.files),\n create: async (ctx) => ({ state: { id: ctx.sandboxId } }),\n // An in-memory sandbox runs from the moment it exists.\n awaitRunning: async () => undefined,\n attach: async (ctx, { artifact, state }) => {\n const existing = records.get(state.id);\n if (existing != null) {\n const booted = !existing.running;\n existing.running = true;\n await ready(ctx, existing.sandbox);\n return { handle: memoryHandle(existing.sandbox), state, fresh: false, booted };\n }\n const sandbox = createMemorySandbox({\n id: state.id,\n files: artifact.files,\n cwd: artifact.cwd,\n ports: artifact.ports,\n networkPolicy: options.networkPolicy != null,\n baseEnv: platformProcessEnvironment(ctx, specEnv),\n });\n records.set(state.id, { sandbox, running: true });\n await ready(ctx, sandbox);\n return { handle: memoryHandle(sandbox), state, fresh: true, booted: true };\n },\n detach: async (_ctx, { state }) => state,\n park: async (_ctx, { state }) => {\n const record = records.get(state.id);\n if (record != null && record.running) {\n await record.sandbox.stop();\n record.running = false;\n }\n return state;\n },\n delete: async (_ctx, { state }) => {\n const record = records.get(state.id);\n records.delete(state.id);\n await record?.sandbox.destroy();\n },\n };\n },\n });\n};\n\nexport const memorySandboxProvider = createMemorySandboxProvider();\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,15 +1,15 @@
1
1
  import type { SandboxExecutionPolicyIface } from "./handle.mjs";
2
- import { SandboxAccess } from "../manifest.mjs";
3
2
  import { type SandboxExecutionContextIface } from "./execution-guard.mjs";
4
- import { type NetworkPolicyIface, type NetworkSandboxSessionIface, type SandboxCapability, type SandboxOfferContextIface, type SandboxProviderHandleIface, type SandboxRunResultIface, type SandboxStartContextIface } from "./types.mjs";
3
+ import { type SandboxGrantIface } from "./grant.mjs";
4
+ import { type NetworkPolicyIface, type NetworkSandboxSessionIface, type SandboxCapability, type SandboxOfferContextIface, type SandboxProviderHandleIface, type SandboxRunResultIface, type SandboxResourceContextIface } from "./types.mjs";
5
5
  export interface SandboxNetworkingContextIface {
6
- access?: SandboxAccess;
6
+ grant?: SandboxGrantIface;
7
7
  ctx: SandboxOfferContextIface;
8
8
  workspaceId: string;
9
9
  }
10
10
  export interface SandboxNetworkingControllerOptionsIface extends SandboxNetworkingContextIface {
11
11
  sandbox: NetworkSandboxSessionIface;
12
- access: SandboxAccess;
12
+ grant: SandboxGrantIface;
13
13
  initialNetworkPolicy: NetworkPolicyIface;
14
14
  privilegedRun?: (request: {
15
15
  source: string;
@@ -48,7 +48,7 @@ export interface SandboxNetworkingExtensionIface {
48
48
  }
49
49
  export interface WithSandboxNetworkingOptionsIface<S extends NetworkSandboxSessionIface> {
50
50
  handle: SandboxProviderHandleIface<S>;
51
- access: SandboxAccess;
51
+ grant: SandboxGrantIface;
52
52
  controller?: SandboxNetworkingControllerIface;
53
53
  admission?: () => Promise<void>;
54
54
  beforeUse?: () => Promise<void>;
@@ -59,9 +59,9 @@ export interface WithSandboxNetworkingOptionsIface<S extends NetworkSandboxSessi
59
59
  export declare const withSandboxNetworking: <S extends NetworkSandboxSessionIface>(options: WithSandboxNetworkingOptionsIface<S>) => Promise<SandboxProviderHandleIface<S>>;
60
60
  export interface AttachSandboxNetworkingOptionsIface<S extends NetworkSandboxSessionIface> {
61
61
  extension: SandboxNetworkingExtensionIface;
62
- ctx: SandboxStartContextIface;
62
+ ctx: SandboxResourceContextIface;
63
63
  handle: SandboxProviderHandleIface<S>;
64
- access: SandboxAccess;
64
+ grant: SandboxGrantIface;
65
65
  workspaceId: string;
66
66
  initialNetworkPolicy: NetworkPolicyIface;
67
67
  restoreNetwork: (policy?: NetworkPolicyIface) => Promise<void>;
@@ -1,10 +1,13 @@
1
1
  import { createSandboxHandle } from "./handle.mjs";
2
2
  import { withSandboxOverrides } from "./overrides.mjs";
3
- import { SandboxAccess } from "../manifest.mjs";
3
+ import { Capability, FilesAccess, ShellAccess } from "@finalai/agent-protocol";
4
4
  import { WorkspaceEgressAction } from "@finalai/agent-protocol/device-egress";
5
5
  import { SandboxExecutionOperation } from "./execution-guard.mjs";
6
+ import { grantAllows } from "./grant.mjs";
6
7
  import {
7
8
  } from "./types.mjs";
9
+ const grantRuns = (grant) => grantAllows(grant, Capability.Shell, ShellAccess.Execute);
10
+ const grantConfiguresEgress = (grant) => grantRuns(grant) && grantAllows(grant, Capability.Files, FilesAccess.Write);
8
11
  const finishNetworking = async (args) => {
9
12
  const failures = [];
10
13
  try {
@@ -23,7 +26,7 @@ const finishNetworking = async (args) => {
23
26
  };
24
27
  const withSandboxNetworking = async (options) => {
25
28
  const { handle, controller } = options;
26
- if (options.access === SandboxAccess.Read) return handle;
29
+ if (!grantRuns(options.grant)) return handle;
27
30
  if (controller != null && options.initialized !== true) {
28
31
  try {
29
32
  await controller.initialize();
@@ -39,10 +42,12 @@ const withSandboxNetworking = async (options) => {
39
42
  const source = handle.sandbox;
40
43
  const extended = controller?.extendSandbox(source) ?? source;
41
44
  const egress = extended.egress?.bind(extended);
42
- const sandbox = options.access === SandboxAccess.Execute && egress != null ? withSandboxOverrides(extended, {
45
+ const sandbox = !grantConfiguresEgress(options.grant) && egress != null ? withSandboxOverrides(extended, {
43
46
  egress: async (request) => {
44
47
  if (request.action !== WorkspaceEgressAction.Status)
45
- throw new Error("Workspace egress configuration requires write access");
48
+ throw new Error(
49
+ "Workspace egress configuration requires files write and shell access"
50
+ );
46
51
  return egress(request);
47
52
  }
48
53
  }) : extended;
@@ -88,19 +93,21 @@ const withSandboxNetworking = async (options) => {
88
93
  });
89
94
  };
90
95
  const attachSandboxNetworking = async (options) => {
91
- if (options.access === SandboxAccess.Read) return options.handle;
96
+ if (!grantRuns(options.grant)) return options.handle;
92
97
  if (options.extension.attach != null) return options.extension.attach(options);
93
98
  const controller = options.extension.controller({
94
99
  ctx: {
95
- organizationId: options.ctx.session.organizationId,
100
+ organizationId: options.ctx.organizationId,
101
+ projectId: options.ctx.projectId,
102
+ sandboxId: options.ctx.sandboxId,
96
103
  credentials: options.ctx.credentials,
97
104
  platformEgressHosts: options.ctx.platformEgressHosts,
98
105
  platformNetworkPolicy: options.ctx.platformNetworkPolicy,
99
106
  actingUser: options.ctx.actingUser,
100
- bindings: options.ctx.bindings
107
+ identity: options.ctx.identity
101
108
  },
102
109
  sandbox: options.handle.sandbox,
103
- access: options.access,
110
+ grant: options.grant,
104
111
  workspaceId: options.workspaceId,
105
112
  initialNetworkPolicy: options.initialNetworkPolicy,
106
113
  afterGuard: options.restoreNetwork,
@@ -127,7 +134,7 @@ const attachSandboxNetworking = async (options) => {
127
134
  return await withSandboxNetworking({
128
135
  handle: options.handle,
129
136
  controller,
130
- access: options.access,
137
+ grant: options.grant,
131
138
  beforeUse: options.beforeUse,
132
139
  initialized: true,
133
140
  fetch: options.extension.fetch,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/networking.ts"],
4
- "sourcesContent": ["import { createSandboxHandle } from \"./handle.mjs\";\nimport type { SandboxExecutionPolicyIface } from \"./handle.mjs\";\nimport { withSandboxOverrides } from \"./overrides.mjs\";\nimport { SandboxAccess } from \"../manifest.mjs\";\nimport { WorkspaceEgressAction } from '@finalai/agent-protocol/device-egress';\nimport { SandboxExecutionOperation, type SandboxExecutionContextIface } from \"./execution-guard.mjs\";\nimport {\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxCapability,\n type SandboxOfferContextIface,\n type SandboxProviderHandleIface,\n type SandboxRunResultIface,\n type SandboxStartContextIface,\n} from \"./types.mjs\";\n\nexport interface SandboxNetworkingContextIface {\n access?: SandboxAccess;\n ctx: SandboxOfferContextIface;\n workspaceId: string;\n}\n\nexport interface SandboxNetworkingControllerOptionsIface extends SandboxNetworkingContextIface {\n sandbox: NetworkSandboxSessionIface;\n access: SandboxAccess;\n initialNetworkPolicy: NetworkPolicyIface;\n // Executes inside the sandbox's network namespace with its required privileges.\n privilegedRun?: (request: { source: string; input: string }) => Promise<SandboxRunResultIface>;\n afterGuard: (policy?: NetworkPolicyIface) => Promise<void>;\n afterBlock?: () => Promise<void>;\n namespaceExists?: () => Promise<boolean>;\n onClose?: () => void;\n allowOwnerChange?: boolean;\n log?: (message: string, fields?: Record<string, string | number | boolean | null>) => void;\n}\n\nexport interface SandboxNetworkingControllerIface {\n initialize(): Promise<void>;\n guard(context?: SandboxExecutionContextIface): Promise<void>;\n close(stop?: boolean): Promise<void>;\n closeOnFailure(): Promise<void>;\n // Extensions may expose networking operations; ordinary execution is guarded afterwards.\n extendSandbox<S extends NetworkSandboxSessionIface>(sandbox: S): S;\n authorizeExternalAccess(): Promise<{ expiresAtMs: number | null }>;\n}\n\n// A host composes an opinionated networking implementation with any compatible provider.\nexport interface SandboxNetworkingExtensionIface {\n readonly capabilities: readonly SandboxCapability[];\n readonly fetch?: typeof globalThis.fetch;\n validateWorkspaceId?(workspaceId: string): void;\n enabled(args: SandboxNetworkingContextIface & { teardown?: boolean }): Promise<boolean>;\n // Return the retained logical policy when it differs from the supplied provider snapshot.\n prepare(\n args: SandboxNetworkingContextIface & { policy: NetworkPolicyIface },\n ): Promise<NetworkPolicyIface | void>;\n suspend(args: SandboxNetworkingContextIface): Promise<void>;\n controller(args: SandboxNetworkingControllerOptionsIface): SandboxNetworkingControllerIface;\n // Custom attachment may coordinate provider setup; it owns admission and failure cleanup.\n attach?<S extends NetworkSandboxSessionIface>(\n args: Omit<AttachSandboxNetworkingOptionsIface<S>, 'extension'>,\n ): Promise<SandboxProviderHandleIface<S>>;\n}\n\nconst finishNetworking = async (args: {\n close: () => Promise<void>;\n finish: () => Promise<void>;\n}): Promise<void> => {\n const failures: unknown[] = [];\n try {\n await args.close();\n } catch (cause) {\n failures.push(cause);\n }\n try {\n await args.finish();\n } catch (cause) {\n failures.push(cause);\n }\n if (failures.length === 1) throw failures[0];\n if (failures.length > 1)\n throw new AggregateError(failures, 'Sandbox networking and cleanup failed');\n};\n\nexport interface WithSandboxNetworkingOptionsIface<S extends NetworkSandboxSessionIface> {\n handle: SandboxProviderHandleIface<S>;\n access: SandboxAccess;\n controller?: SandboxNetworkingControllerIface;\n admission?: () => Promise<void>;\n beforeUse?: () => Promise<void>;\n initialized?: boolean;\n fetch?: typeof globalThis.fetch;\n executionPolicy?: SandboxExecutionPolicyIface;\n}\n\nexport const withSandboxNetworking = async <S extends NetworkSandboxSessionIface>(\n options: WithSandboxNetworkingOptionsIface<S>,\n): Promise<SandboxProviderHandleIface<S>> => {\n const { handle, controller } = options;\n if (options.access === SandboxAccess.Read) return handle;\n if (controller != null && options.initialized !== true) {\n try {\n await controller.initialize();\n } catch (cause) {\n await finishNetworking({\n close: () => controller.closeOnFailure(),\n finish: async () => {\n throw cause;\n },\n });\n }\n }\n const source = handle.sandbox;\n const extended = controller?.extendSandbox(source) ?? source;\n const egress = extended.egress?.bind(extended);\n const sandbox =\n options.access === SandboxAccess.Execute && egress != null\n ? withSandboxOverrides(extended, {\n egress: async (request: Parameters<typeof egress>[0]) => {\n if (request.action !== WorkspaceEgressAction.Status)\n throw new Error('Workspace egress configuration requires write access');\n return egress(request);\n },\n })\n : extended;\n return createSandboxHandle({\n executionPolicy: options.executionPolicy,\n handle: withSandboxOverrides(handle, {\n sandbox: withSandboxOverrides(sandbox, {\n stop: () =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => source.stop(),\n }),\n destroy: () =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => source.destroy(),\n }),\n }),\n executionPolicy: {\n fetch: handle.executionPolicy?.fetch ?? options.fetch ?? options.executionPolicy?.fetch,\n beforeExecution: async (context: SandboxExecutionContextIface) => {\n await handle.executionPolicy?.beforeExecution(context);\n await options.admission?.();\n await controller?.guard(context);\n if (\n !context.background &&\n ![\n SandboxExecutionOperation.SetNetworkPolicy,\n SandboxExecutionOperation.Egress,\n ].includes(context.operation)\n )\n await options.beforeUse?.();\n },\n },\n onRuntimeShutdown: () =>\n finishNetworking({\n close: () => controller?.close(false) ?? Promise.resolve(),\n finish: () => handle.onRuntimeShutdown(),\n }),\n onSandboxStop: () =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => handle.onSandboxStop(),\n }),\n onSandboxDelete: (args: Parameters<typeof handle.onSandboxDelete>[0]) =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => handle.onSandboxDelete(args),\n }),\n }),\n });\n};\n\nexport interface AttachSandboxNetworkingOptionsIface<S extends NetworkSandboxSessionIface> {\n extension: SandboxNetworkingExtensionIface;\n ctx: SandboxStartContextIface;\n handle: SandboxProviderHandleIface<S>;\n access: SandboxAccess;\n workspaceId: string;\n initialNetworkPolicy: NetworkPolicyIface;\n restoreNetwork: (policy?: NetworkPolicyIface) => Promise<void>;\n blockNetwork?: () => Promise<void>;\n namespaceExists?: () => Promise<boolean>;\n beforeUse: () => Promise<void>;\n log?: SandboxNetworkingControllerOptionsIface['log'];\n}\n\nexport const attachSandboxNetworking = async <S extends NetworkSandboxSessionIface>(\n options: AttachSandboxNetworkingOptionsIface<S>,\n): Promise<SandboxProviderHandleIface<S>> => {\n if (options.access === SandboxAccess.Read) return options.handle;\n if (options.extension.attach != null) return options.extension.attach(options);\n const controller = options.extension.controller({\n ctx: {\n organizationId: options.ctx.session.organizationId,\n credentials: options.ctx.credentials,\n platformEgressHosts: options.ctx.platformEgressHosts,\n platformNetworkPolicy: options.ctx.platformNetworkPolicy,\n actingUser: options.ctx.actingUser,\n bindings: options.ctx.bindings,\n },\n sandbox: options.handle.sandbox,\n access: options.access,\n workspaceId: options.workspaceId,\n initialNetworkPolicy: options.initialNetworkPolicy,\n afterGuard: options.restoreNetwork,\n afterBlock: options.blockNetwork,\n namespaceExists: options.namespaceExists,\n log: options.log,\n });\n try {\n await controller.initialize();\n let ready = true;\n try {\n const setupContext = { operation: SandboxExecutionOperation.Run, background: false };\n await options.ctx.executionPolicy?.beforeExecution(setupContext);\n await options.handle.executionPolicy?.beforeExecution(setupContext);\n await controller.guard();\n } catch (cause) {\n ready = false;\n options.log?.('workspace_networking.setup_deferred', {\n workspaceId: options.workspaceId,\n reason: cause instanceof Error ? cause.name : 'UnknownError',\n });\n }\n if (ready) await options.beforeUse();\n return await withSandboxNetworking({\n handle: options.handle,\n controller,\n access: options.access,\n beforeUse: options.beforeUse,\n initialized: true,\n fetch: options.extension.fetch,\n executionPolicy: options.ctx.executionPolicy,\n });\n } catch (cause) {\n await finishNetworking({\n close: () => controller.closeOnFailure(),\n finish: async () => {\n throw cause;\n },\n });\n throw cause;\n }\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import { createSandboxHandle } from \"./handle.mjs\";\nimport type { SandboxExecutionPolicyIface } from \"./handle.mjs\";\nimport { withSandboxOverrides } from \"./overrides.mjs\";\nimport { Capability, FilesAccess, ShellAccess } from '@finalai/agent-protocol';\nimport { WorkspaceEgressAction } from '@finalai/agent-protocol/device-egress';\nimport { SandboxExecutionOperation, type SandboxExecutionContextIface } from \"./execution-guard.mjs\";\nimport { grantAllows, type SandboxGrantIface } from \"./grant.mjs\";\nimport {\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxCapability,\n type SandboxOfferContextIface,\n type SandboxProviderHandleIface,\n type SandboxRunResultIface,\n type SandboxResourceContextIface,\n} from \"./types.mjs\";\n\n// Networking guards what runs on a sandbox: a grant without `shell` runs\n// nothing that could reach the network, and only a grant that also writes\n// files may reconfigure egress.\nconst grantRuns = (grant: SandboxGrantIface): boolean =>\n grantAllows(grant, Capability.Shell, ShellAccess.Execute);\nconst grantConfiguresEgress = (grant: SandboxGrantIface): boolean =>\n grantRuns(grant) && grantAllows(grant, Capability.Files, FilesAccess.Write);\n\nexport interface SandboxNetworkingContextIface {\n grant?: SandboxGrantIface;\n ctx: SandboxOfferContextIface;\n workspaceId: string;\n}\n\nexport interface SandboxNetworkingControllerOptionsIface extends SandboxNetworkingContextIface {\n sandbox: NetworkSandboxSessionIface;\n grant: SandboxGrantIface;\n initialNetworkPolicy: NetworkPolicyIface;\n // Executes inside the sandbox's network namespace with its required privileges.\n privilegedRun?: (request: { source: string; input: string }) => Promise<SandboxRunResultIface>;\n afterGuard: (policy?: NetworkPolicyIface) => Promise<void>;\n afterBlock?: () => Promise<void>;\n namespaceExists?: () => Promise<boolean>;\n onClose?: () => void;\n allowOwnerChange?: boolean;\n log?: (message: string, fields?: Record<string, string | number | boolean | null>) => void;\n}\n\nexport interface SandboxNetworkingControllerIface {\n initialize(): Promise<void>;\n guard(context?: SandboxExecutionContextIface): Promise<void>;\n close(stop?: boolean): Promise<void>;\n closeOnFailure(): Promise<void>;\n // Extensions may expose networking operations; ordinary execution is guarded afterwards.\n extendSandbox<S extends NetworkSandboxSessionIface>(sandbox: S): S;\n authorizeExternalAccess(): Promise<{ expiresAtMs: number | null }>;\n}\n\n// A host composes an opinionated networking implementation with any compatible provider.\nexport interface SandboxNetworkingExtensionIface {\n readonly capabilities: readonly SandboxCapability[];\n readonly fetch?: typeof globalThis.fetch;\n validateWorkspaceId?(workspaceId: string): void;\n enabled(args: SandboxNetworkingContextIface & { teardown?: boolean }): Promise<boolean>;\n // Return the retained logical policy when it differs from the supplied provider snapshot.\n prepare(\n args: SandboxNetworkingContextIface & { policy: NetworkPolicyIface },\n ): Promise<NetworkPolicyIface | void>;\n suspend(args: SandboxNetworkingContextIface): Promise<void>;\n controller(args: SandboxNetworkingControllerOptionsIface): SandboxNetworkingControllerIface;\n // Custom attachment may coordinate provider setup; it owns admission and failure cleanup.\n attach?<S extends NetworkSandboxSessionIface>(\n args: Omit<AttachSandboxNetworkingOptionsIface<S>, 'extension'>,\n ): Promise<SandboxProviderHandleIface<S>>;\n}\n\nconst finishNetworking = async (args: {\n close: () => Promise<void>;\n finish: () => Promise<void>;\n}): Promise<void> => {\n const failures: unknown[] = [];\n try {\n await args.close();\n } catch (cause) {\n failures.push(cause);\n }\n try {\n await args.finish();\n } catch (cause) {\n failures.push(cause);\n }\n if (failures.length === 1) throw failures[0];\n if (failures.length > 1)\n throw new AggregateError(failures, 'Sandbox networking and cleanup failed');\n};\n\nexport interface WithSandboxNetworkingOptionsIface<S extends NetworkSandboxSessionIface> {\n handle: SandboxProviderHandleIface<S>;\n grant: SandboxGrantIface;\n controller?: SandboxNetworkingControllerIface;\n admission?: () => Promise<void>;\n beforeUse?: () => Promise<void>;\n initialized?: boolean;\n fetch?: typeof globalThis.fetch;\n executionPolicy?: SandboxExecutionPolicyIface;\n}\n\nexport const withSandboxNetworking = async <S extends NetworkSandboxSessionIface>(\n options: WithSandboxNetworkingOptionsIface<S>,\n): Promise<SandboxProviderHandleIface<S>> => {\n const { handle, controller } = options;\n if (!grantRuns(options.grant)) return handle;\n if (controller != null && options.initialized !== true) {\n try {\n await controller.initialize();\n } catch (cause) {\n await finishNetworking({\n close: () => controller.closeOnFailure(),\n finish: async () => {\n throw cause;\n },\n });\n }\n }\n const source = handle.sandbox;\n const extended = controller?.extendSandbox(source) ?? source;\n const egress = extended.egress?.bind(extended);\n const sandbox =\n !grantConfiguresEgress(options.grant) && egress != null\n ? withSandboxOverrides(extended, {\n egress: async (request: Parameters<typeof egress>[0]) => {\n if (request.action !== WorkspaceEgressAction.Status)\n throw new Error(\n 'Workspace egress configuration requires files write and shell access',\n );\n return egress(request);\n },\n })\n : extended;\n return createSandboxHandle({\n executionPolicy: options.executionPolicy,\n handle: withSandboxOverrides(handle, {\n sandbox: withSandboxOverrides(sandbox, {\n stop: () =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => source.stop(),\n }),\n destroy: () =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => source.destroy(),\n }),\n }),\n executionPolicy: {\n fetch: handle.executionPolicy?.fetch ?? options.fetch ?? options.executionPolicy?.fetch,\n beforeExecution: async (context: SandboxExecutionContextIface) => {\n await handle.executionPolicy?.beforeExecution(context);\n await options.admission?.();\n await controller?.guard(context);\n if (\n !context.background &&\n ![\n SandboxExecutionOperation.SetNetworkPolicy,\n SandboxExecutionOperation.Egress,\n ].includes(context.operation)\n )\n await options.beforeUse?.();\n },\n },\n onRuntimeShutdown: () =>\n finishNetworking({\n close: () => controller?.close(false) ?? Promise.resolve(),\n finish: () => handle.onRuntimeShutdown(),\n }),\n onSandboxStop: () =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => handle.onSandboxStop(),\n }),\n onSandboxDelete: (args: Parameters<typeof handle.onSandboxDelete>[0]) =>\n finishNetworking({\n close: () => controller?.close(true) ?? Promise.resolve(),\n finish: () => handle.onSandboxDelete(args),\n }),\n }),\n });\n};\n\nexport interface AttachSandboxNetworkingOptionsIface<S extends NetworkSandboxSessionIface> {\n extension: SandboxNetworkingExtensionIface;\n ctx: SandboxResourceContextIface;\n handle: SandboxProviderHandleIface<S>;\n grant: SandboxGrantIface;\n workspaceId: string;\n initialNetworkPolicy: NetworkPolicyIface;\n restoreNetwork: (policy?: NetworkPolicyIface) => Promise<void>;\n blockNetwork?: () => Promise<void>;\n namespaceExists?: () => Promise<boolean>;\n beforeUse: () => Promise<void>;\n log?: SandboxNetworkingControllerOptionsIface['log'];\n}\n\nexport const attachSandboxNetworking = async <S extends NetworkSandboxSessionIface>(\n options: AttachSandboxNetworkingOptionsIface<S>,\n): Promise<SandboxProviderHandleIface<S>> => {\n if (!grantRuns(options.grant)) return options.handle;\n if (options.extension.attach != null) return options.extension.attach(options);\n const controller = options.extension.controller({\n ctx: {\n organizationId: options.ctx.organizationId,\n projectId: options.ctx.projectId,\n sandboxId: options.ctx.sandboxId,\n credentials: options.ctx.credentials,\n platformEgressHosts: options.ctx.platformEgressHosts,\n platformNetworkPolicy: options.ctx.platformNetworkPolicy,\n actingUser: options.ctx.actingUser,\n identity: options.ctx.identity,\n },\n sandbox: options.handle.sandbox,\n grant: options.grant,\n workspaceId: options.workspaceId,\n initialNetworkPolicy: options.initialNetworkPolicy,\n afterGuard: options.restoreNetwork,\n afterBlock: options.blockNetwork,\n namespaceExists: options.namespaceExists,\n log: options.log,\n });\n try {\n await controller.initialize();\n let ready = true;\n try {\n const setupContext = { operation: SandboxExecutionOperation.Run, background: false };\n await options.ctx.executionPolicy?.beforeExecution(setupContext);\n await options.handle.executionPolicy?.beforeExecution(setupContext);\n await controller.guard();\n } catch (cause) {\n ready = false;\n options.log?.('workspace_networking.setup_deferred', {\n workspaceId: options.workspaceId,\n reason: cause instanceof Error ? cause.name : 'UnknownError',\n });\n }\n if (ready) await options.beforeUse();\n return await withSandboxNetworking({\n handle: options.handle,\n controller,\n grant: options.grant,\n beforeUse: options.beforeUse,\n initialized: true,\n fetch: options.extension.fetch,\n executionPolicy: options.ctx.executionPolicy,\n });\n } catch (cause) {\n await finishNetworking({\n close: () => controller.closeOnFailure(),\n finish: async () => {\n throw cause;\n },\n });\n throw cause;\n }\n};\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,30 @@
1
+ import { type SandboxProviderFeaturesIface } from '@finalai/agent-protocol/sandbox-provider-wire';
2
+ import { type AnySandboxProviderIface } from "../types.mjs";
3
+ import { type WebSocketConstructorIface, type WebSocketLikeIface } from "../wire.mjs";
4
+ export interface SandboxProviderAssertionArgsIface {
5
+ providerId: string;
6
+ audience: string;
7
+ organizationId: string;
8
+ projectId: string;
9
+ sandboxId: string | null;
10
+ userId: string | null;
11
+ }
12
+ export interface RemoteSandboxProviderRegistrationIface {
13
+ id: string;
14
+ name: string;
15
+ url: string;
16
+ stateProtocolVersion: number | null;
17
+ features: SandboxProviderFeaturesIface;
18
+ }
19
+ export interface RemoteSandboxProviderArgsIface {
20
+ registration: RemoteSandboxProviderRegistrationIface;
21
+ mintAssertion: (claims: SandboxProviderAssertionArgsIface) => Promise<string>;
22
+ forwardedSecrets: (scope: {
23
+ organizationId: string;
24
+ projectId: string;
25
+ }) => Promise<Record<string, string>>;
26
+ fetch?: typeof fetch;
27
+ WebSocket?: WebSocketConstructorIface;
28
+ openSocket?: (url: string, protocols: string[]) => WebSocketLikeIface;
29
+ }
30
+ export declare const remoteSandboxProvider: (args: RemoteSandboxProviderArgsIface) => AnySandboxProviderIface;