@finalai/agent-provider 0.11.0 → 0.12.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 (34) hide show
  1. package/README.md +9 -28
  2. package/dist/modules/channel.d.mts +2 -0
  3. package/dist/modules/channel.mjs.map +2 -2
  4. package/dist/modules/sandbox/client.mjs +0 -3
  5. package/dist/modules/sandbox/client.mjs.map +2 -2
  6. package/dist/modules/sandbox/execution-guard.d.mts +0 -1
  7. package/dist/modules/sandbox/execution-guard.mjs +0 -9
  8. package/dist/modules/sandbox/execution-guard.mjs.map +2 -2
  9. package/dist/modules/sandbox/grant.d.mts +0 -1
  10. package/dist/modules/sandbox/grant.mjs +0 -4
  11. package/dist/modules/sandbox/grant.mjs.map +2 -2
  12. package/dist/modules/sandbox/index.d.mts +0 -2
  13. package/dist/modules/sandbox/index.mjs +1 -10
  14. package/dist/modules/sandbox/index.mjs.map +2 -2
  15. package/dist/modules/sandbox/mcp-hosted.d.mts +0 -1
  16. package/dist/modules/sandbox/mcp-hosted.mjs +1 -8
  17. package/dist/modules/sandbox/mcp-hosted.mjs.map +2 -2
  18. package/dist/modules/sandbox/mcp.d.mts +2 -4
  19. package/dist/modules/sandbox/mcp.mjs +6 -52
  20. package/dist/modules/sandbox/mcp.mjs.map +2 -2
  21. package/dist/modules/sandbox/server.mjs +0 -14
  22. package/dist/modules/sandbox/server.mjs.map +2 -2
  23. package/dist/modules/sandbox/tool-policy.mjs +1 -19
  24. package/dist/modules/sandbox/tool-policy.mjs.map +2 -2
  25. package/dist/modules/sandbox/types.d.mts +2 -4
  26. package/dist/modules/sandbox/types.mjs +3 -6
  27. package/dist/modules/sandbox/types.mjs.map +3 -3
  28. package/dist/modules/sandbox/wire.d.mts +0 -17
  29. package/dist/modules/sandbox/wire.mjs +0 -12
  30. package/dist/modules/sandbox/wire.mjs.map +2 -2
  31. package/package.json +3 -3
  32. package/dist/modules/sandbox/networking.d.mts +0 -73
  33. package/dist/modules/sandbox/networking.mjs +0 -157
  34. package/dist/modules/sandbox/networking.mjs.map +0 -7
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/server.ts"],
4
- "sourcesContent": ["import * as z from 'zod';\nimport { WorkspaceEgressAction } from '@finalai/agent-protocol/device-egress';\nimport type { JsonValue } from \"../json.mjs\";\nimport { base64ToBytes, bytesToStream } from \"./bytes.mjs\";\nimport { confinedReadDir, confinedReadFile, confinedStat } from \"./confined-files.mjs\";\nimport { hasSandboxExecutionGuard } from \"./execution-guard.mjs\";\nimport {\n FULL_SANDBOX_GRANT,\n handleMethodRefusal,\n narrowerGrant,\n type HandleAccessPolicyIface,\n} from \"./grant.mjs\";\nimport { hasHostedMcpEndpoints } from \"./mcp-hosted-marker.mjs\";\nimport { createRpcPeer, type RpcPeerIface, type RpcRequestContextIface } from \"./rpc-peer.mjs\";\nimport {\n isMcpChannelEndpoint,\n isSandboxWorkerEndpoint,\n SandboxCapability,\n type McpChannelEndpointIface,\n type McpChannelIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProviderHandleIface,\n} from \"./types.mjs\";\nimport {\n createFrameChannelPair,\n frameChannelFromStream,\n frameChannelFromWebSocket,\n HANDLE_RPC_VERSION,\n HandleRpcCloseCode,\n handleRpcError,\n HandleRpcErrorCode,\n HandleRpcMethod,\n handleRpcMethodSchemas,\n parseHandleRpcMethod,\n type DescribeResultIface,\n type FrameChannelIface,\n type FrameStreamIface,\n type HandleRpcResult,\n type WebSocketLikeIface,\n type WireFrame,\n} from \"./wire.mjs\";\n\n// Serves the handle RPC (wire.ts) for a NetworkSandboxSessionIface. The session\n// service runs it for every provider at its stable per-binding endpoint, which\n// may lazily start the sandbox (through the provider) on the first call.\n\nexport type { HandleAccessPolicyIface } from \"./grant.mjs\";\n\n// Each method is gated by the connection's per-capability grant\n// (grant.ts HANDLE_METHOD_GATES) before it is dispatched.\nexport const DEFAULT_HANDLE_ACCESS: HandleAccessPolicyIface = {\n grant: FULL_SANDBOX_GRANT,\n lifecycle: false,\n};\n\nexport interface HandleAuthorizationIface {\n // When the credential expires; the server closes the connection then unless\n // the client refreshed it.\n expiresAt: string | null;\n // Narrows the server's access policy for this connection.\n access?: HandleAccessPolicyIface;\n}\n\n// Returns null to reject. `token` is null when the client sent none;\n// `identity` is the platform-identity assertion a sandbox provider's attach\n// socket presents (`initialize { identity }`, `identity/refresh`), else null.\nexport type HandleAuthorizeFn = (args: {\n token: string | null;\n identity?: string | null;\n}) => Promise<HandleAuthorizationIface | null>;\n\nexport type HandleLifecycle = Pick<\n SandboxProviderHandleIface<NetworkSandboxSessionIface>,\n 'onSandboxStop' | 'onSandboxDelete' | 'onRuntimeShutdown'\n>;\n\nexport interface HandleResolutionIface {\n sandbox: NetworkSandboxSessionIface;\n handle?: HandleLifecycle;\n access?: HandleAccessPolicyIface;\n}\n\nexport interface HandleRpcMessageHandlerOptionsIface {\n send: (frame: WireFrame) => void;\n close: (code: number, reason: string) => void;\n authorize: HandleAuthorizeFn;\n // Called once per connection, after `initialize` is authorized. The session\n // service's stable endpoint starts the sandbox here through its provider.\n resolve: (authorization: HandleAuthorizationIface) => Promise<HandleResolutionIface>;\n access?: HandleAccessPolicyIface;\n // Token presented in the connection request, used when `initialize` has none.\n connectionToken?: string | null;\n // Send stream chunks as binary frames (default true).\n binary?: boolean;\n // The outer host applies hosted-tool policy before exposing this transport.\n mcpChannels?: boolean;\n now?: () => number;\n // Runs for each validated operation, after binding access checks.\n authorizeOperation?: (context: RpcRequestContextIface) => Promise<void>;\n}\n\nexport interface HandleRpcMessageHandlerIface {\n onFrame(frame: WireFrame): void;\n onClose(code?: number, reason?: string): void;\n}\n\n// Computer use counts only when `sandbox/computerUse` can answer it: an MCP\n// channel endpoint does not cross this wire (its host re-addresses it, as the\n// session service does with withHostedMcpEndpoints).\nconst needsMcpChannels = (sandbox: NetworkSandboxSessionIface) =>\n hasSandboxExecutionGuard(sandbox) && !hasHostedMcpEndpoints(sandbox);\n\nconst servesComputerUse = async (sandbox: NetworkSandboxSessionIface): Promise<boolean> => {\n if (sandbox.computerUse == null || needsMcpChannels(sandbox)) return false;\n try {\n return !isMcpChannelEndpoint(await sandbox.computerUse());\n } catch {\n return false;\n }\n};\n\nconst capabilitiesOf = async (\n sandbox: NetworkSandboxSessionIface,\n mcpChannels = false,\n): Promise<SandboxCapability[]> => {\n const capabilities = [SandboxCapability.Files, SandboxCapability.Process];\n if (sandbox.ports.length > 0) capabilities.push(SandboxCapability.Ports);\n if (sandbox.setNetworkPolicy != null) capabilities.push(SandboxCapability.NetworkPolicy);\n if (sandbox.egress != null) capabilities.push(SandboxCapability.Egress);\n if (mcpChannels ? sandbox.computerUse != null : await servesComputerUse(sandbox))\n capabilities.push(SandboxCapability.ComputerUse);\n if (sandbox.screen != null) capabilities.push(SandboxCapability.Screen);\n if (sandbox.localMcp != null && (mcpChannels || !needsMcpChannels(sandbox)))\n capabilities.push(SandboxCapability.LocalMcp);\n if (sandbox.attachProcess != null) capabilities.push(SandboxCapability.DurableProcesses);\n if (sandbox.startWorker != null) capabilities.push(SandboxCapability.Workers);\n return capabilities;\n};\n\nexport const describeSandboxHandle = async (\n sandbox: NetworkSandboxSessionIface,\n mcpChannels = false,\n): Promise<DescribeResultIface> => ({\n handleRpcVersion: HANDLE_RPC_VERSION,\n id: sandbox.id,\n defaultWorkingDirectory: sandbox.defaultWorkingDirectory,\n ports: [...sandbox.ports],\n capabilities: await capabilitiesOf(sandbox, mcpChannels),\n description: sandbox.description,\n});\n\nconst narrowAccess = (\n base: HandleAccessPolicyIface,\n narrower: HandleAccessPolicyIface | undefined,\n): HandleAccessPolicyIface =>\n narrower == null\n ? base\n : {\n grant: narrowerGrant(base.grant, narrower.grant),\n lifecycle: base.lifecycle && narrower.lifecycle,\n };\n\nconst parseParams = <S extends z.ZodType>(schema: S, params: JsonValue): z.output<S> => {\n const parsed = schema.safeParse(params);\n if (!parsed.success) {\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: z.prettifyError(parsed.error),\n });\n }\n return parsed.data;\n};\n\n// The upload stream ids a request names, read before full validation.\nconst uploadStreamIdsSchema = z.object({\n streamId: z.number().int().nonnegative().optional(),\n stdinStreamId: z.number().int().nonnegative().nullable().optional(),\n});\n\nconst PROCESS_CONTROL_METHODS: ReadonlySet<string> = new Set([\n HandleRpcMethod.ProcessWait,\n HandleRpcMethod.ProcessKill,\n HandleRpcMethod.ProcessDetach,\n]);\n\nconst processIdOf = (params: JsonValue): string | null => {\n const parsed = z.object({ processId: z.string() }).safeParse(params);\n return parsed.success ? parsed.data.processId : null;\n};\n\n// A worker's input stream: what the client writes, until it ends.\nconst pipeInto = async (\n source: ReadableStream<Uint8Array>,\n target: Pick<SandboxProcessIface, 'write'>,\n): Promise<void> => {\n const reader = source.getReader();\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n await target.write(new Uint8Array(), { end: true });\n return;\n }\n await target.write(value);\n }\n};\n\nconst unsupported = (what: string) =>\n handleRpcError({ code: HandleRpcErrorCode.Unsupported, message: `this sandbox has no ${what}` });\n\n// Byte-range slice of a stream.\nconst sliceStream = (\n source: ReadableStream<Uint8Array>,\n offset: number,\n length: number | undefined,\n): ReadableStream<Uint8Array> => {\n let position = 0;\n const end = length == null ? Number.POSITIVE_INFINITY : offset + length;\n const reader = source.getReader();\n return new ReadableStream<Uint8Array>({\n pull: async (controller) => {\n for (;;) {\n if (position >= end) {\n controller.close();\n await reader.cancel().catch(() => undefined);\n return;\n }\n const { done, value } = await reader.read();\n if (done) {\n controller.close();\n return;\n }\n const chunkStart = position;\n position += value.byteLength;\n const from = Math.max(0, offset - chunkStart);\n const to = Math.min(value.byteLength, end - chunkStart);\n if (to > from) {\n controller.enqueue(value.subarray(from, to));\n return;\n }\n }\n },\n cancel: (reason) => reader.cancel(reason),\n });\n};\n\n// Low-level, transport-agnostic handler: feed it frames, it calls `send` and\n// `close`. Use it where the host owns the socket (Hono upgradeWebSocket, a\n// Durable Object's hibernation handlers, a relay).\nexport const createHandleRpcMessageHandler = (\n options: HandleRpcMessageHandlerOptionsIface,\n): HandleRpcMessageHandlerIface => {\n const now = options.now ?? Date.now;\n const [local, remote] = createFrameChannelPair();\n let ended = false;\n // `remote` is our side; frames the peer writes to it go out through `send`.\n remote.listen({\n frame: (frame) => options.send(frame),\n close: (info) => {\n if (!ended) {\n ended = true;\n options.close(info.code, info.reason);\n }\n },\n });\n const peerChannel: FrameChannelIface = local;\n const connection = createServerConnection({\n channel: peerChannel,\n authorize: options.authorize,\n resolve: options.resolve,\n access: options.access ?? DEFAULT_HANDLE_ACCESS,\n connectionToken: options.connectionToken ?? null,\n binary: options.binary ?? true,\n mcpChannels: options.mcpChannels,\n now,\n authorizeOperation: options.authorizeOperation,\n });\n return {\n onFrame: (frame) => remote.send(frame),\n onClose: (code, reason) => {\n ended = true;\n connection.close(code ?? 1000, reason ?? '');\n },\n };\n};\n\ninterface ServerConnectionIface {\n close(code: number, reason: string): void;\n}\n\n// A process served on one connection. `detach` is set for a durable process:\n// aborting it releases the handle and leaves the process running.\ninterface ServedProcessIface {\n process: Pick<SandboxProcessIface, 'wait' | 'kill'>;\n detach: AbortController | null;\n}\n\n// Ends a connection's hold on a process: detaches a durable one, kills any other.\nconst releaseProcess = async (served: ServedProcessIface): Promise<void> => {\n if (served.detach == null) await served.process.kill();\n else served.detach.abort(new Error('process handle released'));\n};\n\ninterface ServerConnectionArgsIface {\n channel: FrameChannelIface;\n authorize: HandleAuthorizeFn;\n resolve: (authorization: HandleAuthorizationIface) => Promise<HandleResolutionIface>;\n access: HandleAccessPolicyIface;\n connectionToken: string | null;\n binary: boolean;\n mcpChannels?: boolean;\n now: () => number;\n authorizeOperation?: (context: RpcRequestContextIface) => Promise<void>;\n}\n\nconst createServerConnection = (args: ServerConnectionArgsIface): ServerConnectionIface => {\n let sandbox: NetworkSandboxSessionIface | null = null;\n let access = args.access;\n let initializing = false;\n let handle: HandleLifecycle | null = null;\n let expiryTimer: ReturnType<typeof setTimeout> | null = null;\n const processes = new Map<string, ServedProcessIface>();\n // Process ids of worker programs, controlled as starting them is gated.\n const workers = new Set<string>();\n const mcpEndpoints = new Map<string, McpChannelEndpointIface>();\n const mcpConnections = new Map<string, McpChannelIface>();\n let nextMcpChannelId = 0;\n let shutdown: Promise<void> | null = null;\n // Incoming streams registered in beforeRequest, keyed by request id.\n const incomingByRequest = new Map<\n string | number,\n { streamId: number; stream: ReadableStream<Uint8Array> }\n >();\n\n const scheduleExpiry = (expiresAt: string | null) => {\n if (expiryTimer != null) clearTimeout(expiryTimer);\n expiryTimer = null;\n if (expiresAt == null) return;\n const delay = Date.parse(expiresAt) - args.now();\n if (Number.isNaN(delay)) return;\n expiryTimer = setTimeout(\n () =>\n delay > 2_147_483_647\n ? scheduleExpiry(expiresAt)\n : peer.close(HandleRpcCloseCode.Unauthorized, 'credential expired'),\n Math.max(0, Math.min(2_147_483_647, delay)),\n );\n };\n\n const requireSandbox = (): NetworkSandboxSessionIface => {\n if (sandbox == null) {\n throw handleRpcError({\n code: HandleRpcErrorCode.NotInitialized,\n message: 'initialize first',\n });\n }\n return sandbox;\n };\n\n const checkAccess = (method: HandleRpcMethod, params: JsonValue) => {\n const processId = processIdOf(params);\n const gated =\n PROCESS_CONTROL_METHODS.has(method) && processId != null && workers.has(processId)\n ? HandleRpcMethod.StartWorker\n : method;\n const refusal = handleMethodRefusal({ access, method: gated, params });\n if (refusal != null)\n throw handleRpcError({ code: HandleRpcErrorCode.Forbidden, message: refusal });\n };\n\n const featureFlags = (): Pick<DescribeResultIface, 'providerHooks' | 'mcpChannels'> => {\n const flags: Pick<DescribeResultIface, 'providerHooks' | 'mcpChannels'> = {};\n if (handle != null) flags.providerHooks = true;\n if (args.mcpChannels === true) flags.mcpChannels = true;\n return flags;\n };\n\n const initialize = async (\n params: JsonValue,\n ): Promise<HandleRpcResult<HandleRpcMethod.Initialize>> => {\n const parsed = parseParams(handleRpcMethodSchemas[HandleRpcMethod.Initialize].params, params);\n if (sandbox != null || initializing) {\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidRequest,\n message: 'already initialized',\n });\n }\n initializing = true;\n try {\n const token = parsed.token ?? args.connectionToken;\n const authorization = await args.authorize({ token, identity: parsed.identity ?? null });\n if (authorization == null) {\n setTimeout(() => peer.close(HandleRpcCloseCode.Unauthorized, 'unauthorized'), 0);\n throw handleRpcError({ code: HandleRpcErrorCode.Unauthorized, message: 'unauthorized' });\n }\n const resolution = await args.resolve(authorization);\n access = narrowAccess(narrowAccess(access, resolution.access), authorization.access);\n sandbox = resolution.sandbox;\n handle = resolution.handle ?? null;\n scheduleExpiry(authorization.expiresAt);\n return {\n ...(await describeSandboxHandle(sandbox, args.mcpChannels)),\n confinedFiles: true,\n ...featureFlags(),\n expiresAt: authorization.expiresAt,\n };\n } finally {\n initializing = false;\n }\n };\n\n const pump = (streamId: number, source: ReadableStream<Uint8Array>) => {\n peer.streams.openOutgoing(streamId, source).catch(() => undefined);\n };\n\n // Registers a process the provider just returned, unless the request was\n // cancelled or the connection closed or shut down meanwhile: then it is\n // released at once.\n const serve = (args: {\n processId: string;\n served: ServedProcessIface;\n signal: AbortSignal;\n stdout: { streamId: number; stream: ReadableStream<Uint8Array> };\n stderr: { streamId: number; stream: ReadableStream<Uint8Array> };\n }) => {\n if (args.signal.aborted || shutdown != null) {\n void releaseProcess(args.served).catch(() => undefined);\n throw handleRpcError({ code: HandleRpcErrorCode.Cancelled, message: 'request cancelled' });\n }\n processes.set(args.processId, args.served);\n pump(args.stdout.streamId, args.stdout.stream);\n pump(args.stderr.streamId, args.stderr.stream);\n };\n const servedProcess = (processId: string): ServedProcessIface => {\n const served = processes.get(processId);\n if (served == null)\n throw handleRpcError({ code: HandleRpcErrorCode.NotFound, message: 'no such process' });\n return served;\n };\n\n const mcpDescriptor = (endpoint: SandboxMcpEndpoint, key: string) => {\n if (!isMcpChannelEndpoint(endpoint)) return endpoint;\n if (args.mcpChannels !== true) throw unsupported('MCP channels over the handle RPC');\n mcpEndpoints.set(key, endpoint);\n return { name: endpoint.name, endpointKey: key };\n };\n const mcpConnection = (id: string): McpChannelIface => {\n const channel = mcpConnections.get(id);\n if (channel == null)\n throw handleRpcError({\n code: HandleRpcErrorCode.NotFound,\n message: 'MCP channel not found on this connection',\n });\n return channel;\n };\n\n // Fails a request's upload stream when the request fails, so the client\n // stops sending.\n const dispatch = async (context: RpcRequestContextIface): Promise<object> => {\n try {\n return await dispatchMethod(context);\n } catch (error) {\n const entry = incomingByRequest.get(context.id);\n incomingByRequest.delete(context.id);\n if (entry != null) peer.streams.cancelIncoming(entry.streamId, 'request failed');\n throw error;\n }\n };\n\n const dispatchMethod = async (context: RpcRequestContextIface): Promise<object> => {\n const method = parseHandleRpcMethod(context.method);\n if (method == null) {\n throw handleRpcError({\n code: HandleRpcErrorCode.MethodNotFound,\n message: `unknown method ${context.method}`,\n });\n }\n if (method === HandleRpcMethod.Initialize) return initialize(context.params);\n const target = requireSandbox();\n if (shutdown != null && method !== HandleRpcMethod.OnRuntimeShutdown)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'Provider handle is shutting down',\n });\n checkAccess(method, context.params);\n parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (\n method === HandleRpcMethod.Egress &&\n parseParams(handleRpcMethodSchemas[HandleRpcMethod.Egress].params, context.params).action !==\n WorkspaceEgressAction.Status &&\n args.authorizeOperation == null\n )\n throw handleRpcError({\n code: HandleRpcErrorCode.Forbidden,\n message: 'Device egress changes require an operation authorization hook',\n });\n await args.authorizeOperation?.(context);\n if (context.signal.aborted)\n throw handleRpcError({ code: HandleRpcErrorCode.Cancelled, message: 'request cancelled' });\n const abortSignal = context.signal;\n switch (method) {\n case HandleRpcMethod.Describe:\n return {\n ...(await describeSandboxHandle(target, args.mcpChannels)),\n confinedFiles: true,\n ...featureFlags(),\n };\n case HandleRpcMethod.AuthRefresh: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const authorization = await args.authorize({ token: params.token });\n if (authorization == null)\n throw handleRpcError({ code: HandleRpcErrorCode.Unauthorized, message: 'unauthorized' });\n access = narrowAccess(access, authorization.access);\n scheduleExpiry(authorization.expiresAt);\n return { expiresAt: authorization.expiresAt };\n }\n case HandleRpcMethod.IdentityRefresh: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const authorization = await args.authorize({ token: null, identity: params.assertion });\n if (authorization == null)\n throw handleRpcError({ code: HandleRpcErrorCode.Unauthorized, message: 'unauthorized' });\n access = narrowAccess(access, authorization.access);\n scheduleExpiry(authorization.expiresAt);\n return { expiresAt: authorization.expiresAt };\n }\n case HandleRpcMethod.ReadFile: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const stream =\n params.root == null\n ? await target.readFile({ path: params.path, abortSignal })\n : await (\n target.confinedFileReader?.readFile ??\n ((options) => confinedReadFile(target, options))\n )({ path: params.path, root: params.root, abortSignal });\n if (stream == null) return { found: false };\n const ranged =\n params.offset != null || params.length != null\n ? sliceStream(stream, params.offset ?? 0, params.length)\n : stream;\n // The client registered the stream before asking, so start right away.\n pump(params.streamId, ranged);\n return { found: true };\n }\n case HandleRpcMethod.ReadTextFile: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const text = await target.readTextFile({ ...params, abortSignal });\n return { text };\n }\n case HandleRpcMethod.WriteFile: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const incoming = incomingByRequest.get(context.id)?.stream ?? null;\n const content =\n incoming ??\n bytesToStream(\n params.contentBase64 == null ? new Uint8Array() : base64ToBytes(params.contentBase64),\n );\n await target.writeFile({ path: params.path, content, abortSignal });\n incomingByRequest.delete(context.id);\n return {};\n }\n case HandleRpcMethod.Spawn: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const stdin = incomingByRequest.get(context.id)?.stream ?? null;\n if (processes.has(params.processId)) {\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: 'processId already in use',\n });\n }\n const detach = params.durable === true ? new AbortController() : null;\n const child = await target.spawn({\n command: params.command,\n args: params.args,\n cwd: params.cwd,\n env: params.env,\n shell: params.shell,\n timeoutMs: params.timeoutMs,\n // A closed stdin is an empty stream.\n stdin: stdin ?? '',\n ...(detach == null ? {} : { durable: true, abortSignal: detach.signal }),\n });\n incomingByRequest.delete(context.id);\n const ref = child.ref ?? null;\n serve({\n processId: params.processId,\n // A sandbox that ignored `durable` gave an ordinary process.\n served: { process: child, detach: ref == null ? null : detach },\n signal: abortSignal,\n stdout: { streamId: params.stdoutStreamId, stream: child.stdout },\n stderr: { streamId: params.stderrStreamId, stream: child.stderr },\n });\n return { pid: child.pid, ref };\n }\n case HandleRpcMethod.StartWorker: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (target.startWorker == null) throw unsupported('worker programs');\n const stdin = incomingByRequest.get(context.id)?.stream ?? null;\n if (processes.has(params.processId))\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: 'processId already in use',\n });\n const detach = params.durable === true ? new AbortController() : null;\n const started = await target.startWorker({\n program: params.program,\n env: params.env,\n input: params.input,\n ...(params.identity == null ? {} : { identity: params.identity }),\n ...(detach == null ? {} : { durable: true, abortSignal: detach.signal }),\n });\n const upload = incomingByRequest.get(context.id);\n incomingByRequest.delete(context.id);\n // The program serves its own endpoint: nothing flows on the request's streams.\n if (isSandboxWorkerEndpoint(started)) {\n if (upload != null) peer.streams.cancelIncoming(upload.streamId, 'worker endpoint');\n return { endpoint: started.endpoint };\n }\n const worker = started;\n if (stdin != null) void pipeInto(stdin, worker).catch(() => undefined);\n const ref = worker.ref ?? null;\n workers.add(params.processId);\n serve({\n processId: params.processId,\n served: { process: worker, detach: ref == null ? null : detach },\n signal: abortSignal,\n stdout: { streamId: params.stdoutStreamId, stream: worker.stdout },\n stderr: { streamId: params.stderrStreamId, stream: worker.stderr },\n });\n return { pid: worker.pid, ref };\n }\n case HandleRpcMethod.ProcessAttach: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (target.attachProcess == null) throw unsupported('durable processes');\n if (processes.has(params.processId))\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: 'processId already in use',\n });\n const detach = new AbortController();\n // Until it is served, cancelling the request (or closing the connection)\n // cancels the attach; afterwards the handle lives until released.\n const cancelAttach = () => detach.abort(abortSignal.reason);\n abortSignal.addEventListener('abort', cancelAttach, { once: true });\n let attached: Awaited<ReturnType<NonNullable<typeof target.attachProcess>>>;\n try {\n attached = await target.attachProcess({\n ref: params.ref,\n stdoutOffset: params.stdoutOffset,\n stderrOffset: params.stderrOffset,\n abortSignal: detach.signal,\n });\n } finally {\n abortSignal.removeEventListener('abort', cancelAttach);\n }\n if (attached == null)\n return {\n found: false,\n stdoutOffset: params.stdoutOffset,\n stderrOffset: params.stderrOffset,\n };\n serve({\n processId: params.processId,\n served: { process: attached, detach },\n signal: abortSignal,\n stdout: { streamId: params.stdoutStreamId, stream: attached.stdout },\n stderr: { streamId: params.stderrStreamId, stream: attached.stderr },\n });\n return {\n found: true,\n stdoutOffset: attached.stdoutOffset,\n stderrOffset: attached.stderrOffset,\n };\n }\n case HandleRpcMethod.ProcessWait: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const child = servedProcess(params.processId).process;\n const result = await new Promise<{ exitCode: number }>((resolve, reject) => {\n const onAbort = () =>\n reject(handleRpcError({ code: HandleRpcErrorCode.Cancelled, message: 'cancelled' }));\n abortSignal.addEventListener('abort', onAbort, { once: true });\n child.wait().then(\n (value) => {\n abortSignal.removeEventListener('abort', onAbort);\n resolve(value);\n },\n (cause: unknown) => {\n abortSignal.removeEventListener('abort', onAbort);\n reject(cause);\n },\n );\n });\n processes.delete(params.processId);\n workers.delete(params.processId);\n return result;\n }\n case HandleRpcMethod.ProcessDetach: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const served = processes.get(params.processId);\n // Detaching what is already gone (exited and released, or never known) is done.\n if (served == null) return {};\n if (served.detach == null) throw unsupported('detaching an ordinary process');\n processes.delete(params.processId);\n workers.delete(params.processId);\n await releaseProcess(served);\n return {};\n }\n case HandleRpcMethod.ProcessKill: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await servedProcess(params.processId).process.kill(params.signal);\n return {};\n }\n case HandleRpcMethod.Run: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return target.run({ ...params, abortSignal });\n }\n case HandleRpcMethod.Stat: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return {\n stat:\n params.root == null\n ? await target.stat({ path: params.path, abortSignal })\n : await (\n target.confinedFileReader?.stat ?? ((options) => confinedStat(target, options))\n )({\n path: params.path,\n root: params.root,\n abortSignal,\n }),\n };\n }\n case HandleRpcMethod.ReadDir: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return {\n entries:\n params.root == null\n ? await target.readDir({ path: params.path, abortSignal })\n : await (\n target.confinedFileReader?.readDir ??\n ((options) => confinedReadDir(target, options))\n )({\n path: params.path,\n root: params.root,\n abortSignal,\n }),\n };\n }\n case HandleRpcMethod.RemovePath: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await target.removePath({ ...params, abortSignal });\n return {};\n }\n case HandleRpcMethod.GetPortEndpoint: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return target.getPortEndpoint(params);\n }\n case HandleRpcMethod.Stop:\n await target.stop();\n return {};\n case HandleRpcMethod.Destroy:\n await target.destroy();\n return {};\n case HandleRpcMethod.OnRuntimeShutdown: {\n if (handle == null) throw unsupported('provider lifecycle hooks');\n const shutdownHandle = handle;\n shutdown ??= (async () => {\n await Promise.allSettled([...processes.values()].map(releaseProcess));\n await Promise.allSettled([...mcpConnections.values()].map((channel) => channel.close()));\n processes.clear();\n mcpConnections.clear();\n mcpEndpoints.clear();\n await shutdownHandle.onRuntimeShutdown();\n })();\n await shutdown;\n return {};\n }\n case HandleRpcMethod.OnSandboxStop:\n if (handle == null) throw unsupported('provider lifecycle hooks');\n await handle.onSandboxStop();\n return {};\n case HandleRpcMethod.OnSandboxDelete: {\n if (handle == null) throw unsupported('provider lifecycle hooks');\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await handle.onSandboxDelete(params);\n return {};\n }\n case HandleRpcMethod.SetNetworkPolicy: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (target.setNetworkPolicy == null) throw unsupported('network policy');\n await target.setNetworkPolicy(params);\n return {};\n }\n case HandleRpcMethod.Egress: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (target.egress == null) throw unsupported('Device egress');\n return handleRpcMethodSchemas[HandleRpcMethod.Egress].result.parse(\n await target.egress(params),\n );\n }\n case HandleRpcMethod.ComputerUse: {\n if (target.computerUse == null) throw unsupported('computer use');\n if (needsMcpChannels(target) && args.mcpChannels !== true)\n throw unsupported('guarded MCP transport; negotiate mcpChannels');\n const endpoint = await target.computerUse();\n return mcpDescriptor(endpoint, 'computerUse');\n }\n case HandleRpcMethod.McpOpen: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const endpoint = mcpEndpoints.get(params.endpointKey);\n if (args.mcpChannels !== true || endpoint == null)\n throw unsupported('MCP channel endpoint');\n const channel = await endpoint.connect({ abortSignal });\n if (abortSignal.aborted) {\n await channel.close();\n abortSignal.throwIfAborted();\n }\n const channelId = String(++nextMcpChannelId);\n mcpConnections.set(channelId, channel);\n return { channelId };\n }\n case HandleRpcMethod.McpSend: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await mcpConnection(params.channelId).send(params.message, { abortSignal });\n return {};\n }\n case HandleRpcMethod.McpReceive: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return { messages: await mcpConnection(params.channelId).receive({ abortSignal }) };\n }\n case HandleRpcMethod.McpClose: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const channel = mcpConnection(params.channelId);\n await channel.close();\n mcpConnections.delete(params.channelId);\n return {};\n }\n case HandleRpcMethod.Screen: {\n if (target.screen == null) throw unsupported('screen');\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return target.screen(params);\n }\n case HandleRpcMethod.LocalMcp:\n if (target.localMcp == null) throw unsupported('local MCP servers');\n if (needsMcpChannels(target) && args.mcpChannels !== true)\n throw unsupported('guarded MCP transport; negotiate mcpChannels');\n return {\n endpoints: (await target.localMcp()).flatMap((endpoint, index) =>\n args.mcpChannels !== true && isMcpChannelEndpoint(endpoint)\n ? []\n : [mcpDescriptor(endpoint, `localMcp:${index}:${endpoint.name}`)],\n ),\n };\n }\n };\n\n // Registers client-to-server streams synchronously, before their chunks.\n const beforeRequest = (context: RpcRequestContextIface) => {\n if (\n context.method !== HandleRpcMethod.WriteFile &&\n context.method !== HandleRpcMethod.Spawn &&\n context.method !== HandleRpcMethod.StartWorker\n )\n return;\n const ids = uploadStreamIdsSchema.safeParse(context.params);\n if (!ids.success) return;\n const streamId =\n context.method === HandleRpcMethod.WriteFile ? ids.data.streamId : ids.data.stdinStreamId;\n if (streamId == null) return;\n const stream = peer.streams.openIncoming(streamId);\n // Reject unauthorized or disallowed uploads before buffering their data.\n if (\n sandbox == null ||\n handleMethodRefusal({\n access,\n method:\n context.method === HandleRpcMethod.WriteFile ||\n context.method === HandleRpcMethod.StartWorker\n ? context.method\n : HandleRpcMethod.Spawn,\n params: context.params,\n }) != null\n ) {\n peer.streams.cancelIncoming(streamId, 'rejected');\n return;\n }\n incomingByRequest.set(context.id, { streamId, stream });\n };\n\n const onClose = () => {\n if (expiryTimer != null) clearTimeout(expiryTimer);\n for (const served of processes.values()) releaseProcess(served).catch(() => undefined);\n for (const channel of mcpConnections.values()) void channel.close().catch(() => undefined);\n mcpConnections.clear();\n mcpEndpoints.clear();\n processes.clear();\n incomingByRequest.clear();\n };\n\n const peer: RpcPeerIface = createRpcPeer({\n channel: args.channel,\n binary: args.binary,\n onRequest: dispatch,\n beforeRequest,\n onClose,\n });\n\n return { close: (code, reason) => peer.close(code, reason) };\n};\n\nexport interface ServeSandboxHandleArgsIface {\n sandbox: NetworkSandboxSessionIface;\n handle?: HandleLifecycle;\n authorize: HandleAuthorizeFn;\n authorizeOperation?: HandleRpcMessageHandlerOptionsIface['authorizeOperation'];\n access?: HandleAccessPolicyIface;\n binary?: boolean;\n // The outer host applies hosted-tool policy before exposing this transport.\n mcpChannels?: boolean;\n now?: () => number;\n}\n\nexport interface SandboxHandleServerIface {\n // Attaches a connection; returns a function that closes it.\n attach(channel: FrameChannelIface, context?: { token?: string | null }): () => void;\n attachWebSocket(socket: WebSocketLikeIface, context?: { token?: string | null }): () => void;\n attachStream(stream: FrameStreamIface, context?: { token?: string | null }): () => void;\n messageHandler(args: {\n send: (frame: WireFrame) => void;\n close: (code: number, reason: string) => void;\n token?: string | null;\n }): HandleRpcMessageHandlerIface;\n}\n\nexport const serveSandboxHandle = (args: ServeSandboxHandleArgsIface): SandboxHandleServerIface => {\n const access = args.access ?? DEFAULT_HANDLE_ACCESS;\n const resolve = async (): Promise<HandleResolutionIface> => ({\n sandbox: args.sandbox,\n handle: args.handle,\n });\n const attach = (channel: FrameChannelIface, context?: { token?: string | null }) => {\n const connection = createServerConnection({\n channel,\n authorize: args.authorize,\n authorizeOperation: args.authorizeOperation,\n resolve,\n access,\n connectionToken: context?.token ?? null,\n binary: args.binary ?? true,\n mcpChannels: args.mcpChannels,\n now: args.now ?? Date.now,\n });\n return () => connection.close(HandleRpcCloseCode.Normal, 'closed');\n };\n return {\n attach,\n attachWebSocket: (socket, context) =>\n attach(frameChannelFromWebSocket(socket).channel, context),\n attachStream: (stream, context) => attach(frameChannelFromStream(stream), context),\n messageHandler: (handlerArgs) =>\n createHandleRpcMessageHandler({\n send: handlerArgs.send,\n close: handlerArgs.close,\n authorize: args.authorize,\n authorizeOperation: args.authorizeOperation,\n resolve,\n access,\n connectionToken: handlerArgs.token ?? null,\n binary: args.binary,\n mcpChannels: args.mcpChannels,\n now: args.now,\n }),\n };\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import * as z from 'zod';\nimport type { JsonValue } from \"../json.mjs\";\nimport { base64ToBytes, bytesToStream } from \"./bytes.mjs\";\nimport { confinedReadDir, confinedReadFile, confinedStat } from \"./confined-files.mjs\";\nimport { hasSandboxExecutionGuard } from \"./execution-guard.mjs\";\nimport {\n FULL_SANDBOX_GRANT,\n handleMethodRefusal,\n narrowerGrant,\n type HandleAccessPolicyIface,\n} from \"./grant.mjs\";\nimport { hasHostedMcpEndpoints } from \"./mcp-hosted-marker.mjs\";\nimport { createRpcPeer, type RpcPeerIface, type RpcRequestContextIface } from \"./rpc-peer.mjs\";\nimport {\n isMcpChannelEndpoint,\n isSandboxWorkerEndpoint,\n SandboxCapability,\n type McpChannelEndpointIface,\n type McpChannelIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProviderHandleIface,\n} from \"./types.mjs\";\nimport {\n createFrameChannelPair,\n frameChannelFromStream,\n frameChannelFromWebSocket,\n HANDLE_RPC_VERSION,\n HandleRpcCloseCode,\n handleRpcError,\n HandleRpcErrorCode,\n HandleRpcMethod,\n handleRpcMethodSchemas,\n parseHandleRpcMethod,\n type DescribeResultIface,\n type FrameChannelIface,\n type FrameStreamIface,\n type HandleRpcResult,\n type WebSocketLikeIface,\n type WireFrame,\n} from \"./wire.mjs\";\n\n// Serves the handle RPC (wire.ts) for a NetworkSandboxSessionIface. The session\n// service runs it for every provider at its stable per-binding endpoint, which\n// may lazily start the sandbox (through the provider) on the first call.\n\nexport type { HandleAccessPolicyIface } from \"./grant.mjs\";\n\n// Each method is gated by the connection's per-capability grant\n// (grant.ts HANDLE_METHOD_GATES) before it is dispatched.\nexport const DEFAULT_HANDLE_ACCESS: HandleAccessPolicyIface = {\n grant: FULL_SANDBOX_GRANT,\n lifecycle: false,\n};\n\nexport interface HandleAuthorizationIface {\n // When the credential expires; the server closes the connection then unless\n // the client refreshed it.\n expiresAt: string | null;\n // Narrows the server's access policy for this connection.\n access?: HandleAccessPolicyIface;\n}\n\n// Returns null to reject. `token` is null when the client sent none;\n// `identity` is the platform-identity assertion a sandbox provider's attach\n// socket presents (`initialize { identity }`, `identity/refresh`), else null.\nexport type HandleAuthorizeFn = (args: {\n token: string | null;\n identity?: string | null;\n}) => Promise<HandleAuthorizationIface | null>;\n\nexport type HandleLifecycle = Pick<\n SandboxProviderHandleIface<NetworkSandboxSessionIface>,\n 'onSandboxStop' | 'onSandboxDelete' | 'onRuntimeShutdown'\n>;\n\nexport interface HandleResolutionIface {\n sandbox: NetworkSandboxSessionIface;\n handle?: HandleLifecycle;\n access?: HandleAccessPolicyIface;\n}\n\nexport interface HandleRpcMessageHandlerOptionsIface {\n send: (frame: WireFrame) => void;\n close: (code: number, reason: string) => void;\n authorize: HandleAuthorizeFn;\n // Called once per connection, after `initialize` is authorized. The session\n // service's stable endpoint starts the sandbox here through its provider.\n resolve: (authorization: HandleAuthorizationIface) => Promise<HandleResolutionIface>;\n access?: HandleAccessPolicyIface;\n // Token presented in the connection request, used when `initialize` has none.\n connectionToken?: string | null;\n // Send stream chunks as binary frames (default true).\n binary?: boolean;\n // The outer host applies hosted-tool policy before exposing this transport.\n mcpChannels?: boolean;\n now?: () => number;\n // Runs for each validated operation, after binding access checks.\n authorizeOperation?: (context: RpcRequestContextIface) => Promise<void>;\n}\n\nexport interface HandleRpcMessageHandlerIface {\n onFrame(frame: WireFrame): void;\n onClose(code?: number, reason?: string): void;\n}\n\n// Computer use counts only when `sandbox/computerUse` can answer it: an MCP\n// channel endpoint does not cross this wire (its host re-addresses it, as the\n// session service does with withHostedMcpEndpoints).\nconst needsMcpChannels = (sandbox: NetworkSandboxSessionIface) =>\n hasSandboxExecutionGuard(sandbox) && !hasHostedMcpEndpoints(sandbox);\n\nconst servesComputerUse = async (sandbox: NetworkSandboxSessionIface): Promise<boolean> => {\n if (sandbox.computerUse == null || needsMcpChannels(sandbox)) return false;\n try {\n return !isMcpChannelEndpoint(await sandbox.computerUse());\n } catch {\n return false;\n }\n};\n\nconst capabilitiesOf = async (\n sandbox: NetworkSandboxSessionIface,\n mcpChannels = false,\n): Promise<SandboxCapability[]> => {\n const capabilities = [SandboxCapability.Files, SandboxCapability.Process];\n if (sandbox.ports.length > 0) capabilities.push(SandboxCapability.Ports);\n if (sandbox.setNetworkPolicy != null) capabilities.push(SandboxCapability.NetworkPolicy);\n if (mcpChannels ? sandbox.computerUse != null : await servesComputerUse(sandbox))\n capabilities.push(SandboxCapability.ComputerUse);\n if (sandbox.screen != null) capabilities.push(SandboxCapability.Screen);\n if (sandbox.localMcp != null && (mcpChannels || !needsMcpChannels(sandbox)))\n capabilities.push(SandboxCapability.LocalMcp);\n if (sandbox.attachProcess != null) capabilities.push(SandboxCapability.DurableProcesses);\n if (sandbox.startWorker != null) capabilities.push(SandboxCapability.Workers);\n return capabilities;\n};\n\nexport const describeSandboxHandle = async (\n sandbox: NetworkSandboxSessionIface,\n mcpChannels = false,\n): Promise<DescribeResultIface> => ({\n handleRpcVersion: HANDLE_RPC_VERSION,\n id: sandbox.id,\n defaultWorkingDirectory: sandbox.defaultWorkingDirectory,\n ports: [...sandbox.ports],\n capabilities: await capabilitiesOf(sandbox, mcpChannels),\n description: sandbox.description,\n});\n\nconst narrowAccess = (\n base: HandleAccessPolicyIface,\n narrower: HandleAccessPolicyIface | undefined,\n): HandleAccessPolicyIface =>\n narrower == null\n ? base\n : {\n grant: narrowerGrant(base.grant, narrower.grant),\n lifecycle: base.lifecycle && narrower.lifecycle,\n };\n\nconst parseParams = <S extends z.ZodType>(schema: S, params: JsonValue): z.output<S> => {\n const parsed = schema.safeParse(params);\n if (!parsed.success) {\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: z.prettifyError(parsed.error),\n });\n }\n return parsed.data;\n};\n\n// The upload stream ids a request names, read before full validation.\nconst uploadStreamIdsSchema = z.object({\n streamId: z.number().int().nonnegative().optional(),\n stdinStreamId: z.number().int().nonnegative().nullable().optional(),\n});\n\nconst PROCESS_CONTROL_METHODS: ReadonlySet<string> = new Set([\n HandleRpcMethod.ProcessWait,\n HandleRpcMethod.ProcessKill,\n HandleRpcMethod.ProcessDetach,\n]);\n\nconst processIdOf = (params: JsonValue): string | null => {\n const parsed = z.object({ processId: z.string() }).safeParse(params);\n return parsed.success ? parsed.data.processId : null;\n};\n\n// A worker's input stream: what the client writes, until it ends.\nconst pipeInto = async (\n source: ReadableStream<Uint8Array>,\n target: Pick<SandboxProcessIface, 'write'>,\n): Promise<void> => {\n const reader = source.getReader();\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n await target.write(new Uint8Array(), { end: true });\n return;\n }\n await target.write(value);\n }\n};\n\nconst unsupported = (what: string) =>\n handleRpcError({ code: HandleRpcErrorCode.Unsupported, message: `this sandbox has no ${what}` });\n\n// Byte-range slice of a stream.\nconst sliceStream = (\n source: ReadableStream<Uint8Array>,\n offset: number,\n length: number | undefined,\n): ReadableStream<Uint8Array> => {\n let position = 0;\n const end = length == null ? Number.POSITIVE_INFINITY : offset + length;\n const reader = source.getReader();\n return new ReadableStream<Uint8Array>({\n pull: async (controller) => {\n for (;;) {\n if (position >= end) {\n controller.close();\n await reader.cancel().catch(() => undefined);\n return;\n }\n const { done, value } = await reader.read();\n if (done) {\n controller.close();\n return;\n }\n const chunkStart = position;\n position += value.byteLength;\n const from = Math.max(0, offset - chunkStart);\n const to = Math.min(value.byteLength, end - chunkStart);\n if (to > from) {\n controller.enqueue(value.subarray(from, to));\n return;\n }\n }\n },\n cancel: (reason) => reader.cancel(reason),\n });\n};\n\n// Low-level, transport-agnostic handler: feed it frames, it calls `send` and\n// `close`. Use it where the host owns the socket (Hono upgradeWebSocket, a\n// Durable Object's hibernation handlers, a relay).\nexport const createHandleRpcMessageHandler = (\n options: HandleRpcMessageHandlerOptionsIface,\n): HandleRpcMessageHandlerIface => {\n const now = options.now ?? Date.now;\n const [local, remote] = createFrameChannelPair();\n let ended = false;\n // `remote` is our side; frames the peer writes to it go out through `send`.\n remote.listen({\n frame: (frame) => options.send(frame),\n close: (info) => {\n if (!ended) {\n ended = true;\n options.close(info.code, info.reason);\n }\n },\n });\n const peerChannel: FrameChannelIface = local;\n const connection = createServerConnection({\n channel: peerChannel,\n authorize: options.authorize,\n resolve: options.resolve,\n access: options.access ?? DEFAULT_HANDLE_ACCESS,\n connectionToken: options.connectionToken ?? null,\n binary: options.binary ?? true,\n mcpChannels: options.mcpChannels,\n now,\n authorizeOperation: options.authorizeOperation,\n });\n return {\n onFrame: (frame) => remote.send(frame),\n onClose: (code, reason) => {\n ended = true;\n connection.close(code ?? 1000, reason ?? '');\n },\n };\n};\n\ninterface ServerConnectionIface {\n close(code: number, reason: string): void;\n}\n\n// A process served on one connection. `detach` is set for a durable process:\n// aborting it releases the handle and leaves the process running.\ninterface ServedProcessIface {\n process: Pick<SandboxProcessIface, 'wait' | 'kill'>;\n detach: AbortController | null;\n}\n\n// Ends a connection's hold on a process: detaches a durable one, kills any other.\nconst releaseProcess = async (served: ServedProcessIface): Promise<void> => {\n if (served.detach == null) await served.process.kill();\n else served.detach.abort(new Error('process handle released'));\n};\n\ninterface ServerConnectionArgsIface {\n channel: FrameChannelIface;\n authorize: HandleAuthorizeFn;\n resolve: (authorization: HandleAuthorizationIface) => Promise<HandleResolutionIface>;\n access: HandleAccessPolicyIface;\n connectionToken: string | null;\n binary: boolean;\n mcpChannels?: boolean;\n now: () => number;\n authorizeOperation?: (context: RpcRequestContextIface) => Promise<void>;\n}\n\nconst createServerConnection = (args: ServerConnectionArgsIface): ServerConnectionIface => {\n let sandbox: NetworkSandboxSessionIface | null = null;\n let access = args.access;\n let initializing = false;\n let handle: HandleLifecycle | null = null;\n let expiryTimer: ReturnType<typeof setTimeout> | null = null;\n const processes = new Map<string, ServedProcessIface>();\n // Process ids of worker programs, controlled as starting them is gated.\n const workers = new Set<string>();\n const mcpEndpoints = new Map<string, McpChannelEndpointIface>();\n const mcpConnections = new Map<string, McpChannelIface>();\n let nextMcpChannelId = 0;\n let shutdown: Promise<void> | null = null;\n // Incoming streams registered in beforeRequest, keyed by request id.\n const incomingByRequest = new Map<\n string | number,\n { streamId: number; stream: ReadableStream<Uint8Array> }\n >();\n\n const scheduleExpiry = (expiresAt: string | null) => {\n if (expiryTimer != null) clearTimeout(expiryTimer);\n expiryTimer = null;\n if (expiresAt == null) return;\n const delay = Date.parse(expiresAt) - args.now();\n if (Number.isNaN(delay)) return;\n expiryTimer = setTimeout(\n () =>\n delay > 2_147_483_647\n ? scheduleExpiry(expiresAt)\n : peer.close(HandleRpcCloseCode.Unauthorized, 'credential expired'),\n Math.max(0, Math.min(2_147_483_647, delay)),\n );\n };\n\n const requireSandbox = (): NetworkSandboxSessionIface => {\n if (sandbox == null) {\n throw handleRpcError({\n code: HandleRpcErrorCode.NotInitialized,\n message: 'initialize first',\n });\n }\n return sandbox;\n };\n\n const checkAccess = (method: HandleRpcMethod, params: JsonValue) => {\n const processId = processIdOf(params);\n const gated =\n PROCESS_CONTROL_METHODS.has(method) && processId != null && workers.has(processId)\n ? HandleRpcMethod.StartWorker\n : method;\n const refusal = handleMethodRefusal({ access, method: gated, params });\n if (refusal != null)\n throw handleRpcError({ code: HandleRpcErrorCode.Forbidden, message: refusal });\n };\n\n const featureFlags = (): Pick<DescribeResultIface, 'providerHooks' | 'mcpChannels'> => {\n const flags: Pick<DescribeResultIface, 'providerHooks' | 'mcpChannels'> = {};\n if (handle != null) flags.providerHooks = true;\n if (args.mcpChannels === true) flags.mcpChannels = true;\n return flags;\n };\n\n const initialize = async (\n params: JsonValue,\n ): Promise<HandleRpcResult<HandleRpcMethod.Initialize>> => {\n const parsed = parseParams(handleRpcMethodSchemas[HandleRpcMethod.Initialize].params, params);\n if (sandbox != null || initializing) {\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidRequest,\n message: 'already initialized',\n });\n }\n initializing = true;\n try {\n const token = parsed.token ?? args.connectionToken;\n const authorization = await args.authorize({ token, identity: parsed.identity ?? null });\n if (authorization == null) {\n setTimeout(() => peer.close(HandleRpcCloseCode.Unauthorized, 'unauthorized'), 0);\n throw handleRpcError({ code: HandleRpcErrorCode.Unauthorized, message: 'unauthorized' });\n }\n const resolution = await args.resolve(authorization);\n access = narrowAccess(narrowAccess(access, resolution.access), authorization.access);\n sandbox = resolution.sandbox;\n handle = resolution.handle ?? null;\n scheduleExpiry(authorization.expiresAt);\n return {\n ...(await describeSandboxHandle(sandbox, args.mcpChannels)),\n confinedFiles: true,\n ...featureFlags(),\n expiresAt: authorization.expiresAt,\n };\n } finally {\n initializing = false;\n }\n };\n\n const pump = (streamId: number, source: ReadableStream<Uint8Array>) => {\n peer.streams.openOutgoing(streamId, source).catch(() => undefined);\n };\n\n // Registers a process the provider just returned, unless the request was\n // cancelled or the connection closed or shut down meanwhile: then it is\n // released at once.\n const serve = (args: {\n processId: string;\n served: ServedProcessIface;\n signal: AbortSignal;\n stdout: { streamId: number; stream: ReadableStream<Uint8Array> };\n stderr: { streamId: number; stream: ReadableStream<Uint8Array> };\n }) => {\n if (args.signal.aborted || shutdown != null) {\n void releaseProcess(args.served).catch(() => undefined);\n throw handleRpcError({ code: HandleRpcErrorCode.Cancelled, message: 'request cancelled' });\n }\n processes.set(args.processId, args.served);\n pump(args.stdout.streamId, args.stdout.stream);\n pump(args.stderr.streamId, args.stderr.stream);\n };\n const servedProcess = (processId: string): ServedProcessIface => {\n const served = processes.get(processId);\n if (served == null)\n throw handleRpcError({ code: HandleRpcErrorCode.NotFound, message: 'no such process' });\n return served;\n };\n\n const mcpDescriptor = (endpoint: SandboxMcpEndpoint, key: string) => {\n if (!isMcpChannelEndpoint(endpoint)) return endpoint;\n if (args.mcpChannels !== true) throw unsupported('MCP channels over the handle RPC');\n mcpEndpoints.set(key, endpoint);\n return { name: endpoint.name, endpointKey: key };\n };\n const mcpConnection = (id: string): McpChannelIface => {\n const channel = mcpConnections.get(id);\n if (channel == null)\n throw handleRpcError({\n code: HandleRpcErrorCode.NotFound,\n message: 'MCP channel not found on this connection',\n });\n return channel;\n };\n\n // Fails a request's upload stream when the request fails, so the client\n // stops sending.\n const dispatch = async (context: RpcRequestContextIface): Promise<object> => {\n try {\n return await dispatchMethod(context);\n } catch (error) {\n const entry = incomingByRequest.get(context.id);\n incomingByRequest.delete(context.id);\n if (entry != null) peer.streams.cancelIncoming(entry.streamId, 'request failed');\n throw error;\n }\n };\n\n const dispatchMethod = async (context: RpcRequestContextIface): Promise<object> => {\n const method = parseHandleRpcMethod(context.method);\n if (method == null) {\n throw handleRpcError({\n code: HandleRpcErrorCode.MethodNotFound,\n message: `unknown method ${context.method}`,\n });\n }\n if (method === HandleRpcMethod.Initialize) return initialize(context.params);\n const target = requireSandbox();\n if (shutdown != null && method !== HandleRpcMethod.OnRuntimeShutdown)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'Provider handle is shutting down',\n });\n checkAccess(method, context.params);\n parseParams(handleRpcMethodSchemas[method].params, context.params);\n await args.authorizeOperation?.(context);\n if (context.signal.aborted)\n throw handleRpcError({ code: HandleRpcErrorCode.Cancelled, message: 'request cancelled' });\n const abortSignal = context.signal;\n switch (method) {\n case HandleRpcMethod.Describe:\n return {\n ...(await describeSandboxHandle(target, args.mcpChannels)),\n confinedFiles: true,\n ...featureFlags(),\n };\n case HandleRpcMethod.AuthRefresh: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const authorization = await args.authorize({ token: params.token });\n if (authorization == null)\n throw handleRpcError({ code: HandleRpcErrorCode.Unauthorized, message: 'unauthorized' });\n access = narrowAccess(access, authorization.access);\n scheduleExpiry(authorization.expiresAt);\n return { expiresAt: authorization.expiresAt };\n }\n case HandleRpcMethod.IdentityRefresh: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const authorization = await args.authorize({ token: null, identity: params.assertion });\n if (authorization == null)\n throw handleRpcError({ code: HandleRpcErrorCode.Unauthorized, message: 'unauthorized' });\n access = narrowAccess(access, authorization.access);\n scheduleExpiry(authorization.expiresAt);\n return { expiresAt: authorization.expiresAt };\n }\n case HandleRpcMethod.ReadFile: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const stream =\n params.root == null\n ? await target.readFile({ path: params.path, abortSignal })\n : await (\n target.confinedFileReader?.readFile ??\n ((options) => confinedReadFile(target, options))\n )({ path: params.path, root: params.root, abortSignal });\n if (stream == null) return { found: false };\n const ranged =\n params.offset != null || params.length != null\n ? sliceStream(stream, params.offset ?? 0, params.length)\n : stream;\n // The client registered the stream before asking, so start right away.\n pump(params.streamId, ranged);\n return { found: true };\n }\n case HandleRpcMethod.ReadTextFile: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const text = await target.readTextFile({ ...params, abortSignal });\n return { text };\n }\n case HandleRpcMethod.WriteFile: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const incoming = incomingByRequest.get(context.id)?.stream ?? null;\n const content =\n incoming ??\n bytesToStream(\n params.contentBase64 == null ? new Uint8Array() : base64ToBytes(params.contentBase64),\n );\n await target.writeFile({ path: params.path, content, abortSignal });\n incomingByRequest.delete(context.id);\n return {};\n }\n case HandleRpcMethod.Spawn: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const stdin = incomingByRequest.get(context.id)?.stream ?? null;\n if (processes.has(params.processId)) {\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: 'processId already in use',\n });\n }\n const detach = params.durable === true ? new AbortController() : null;\n const child = await target.spawn({\n command: params.command,\n args: params.args,\n cwd: params.cwd,\n env: params.env,\n shell: params.shell,\n timeoutMs: params.timeoutMs,\n // A closed stdin is an empty stream.\n stdin: stdin ?? '',\n ...(detach == null ? {} : { durable: true, abortSignal: detach.signal }),\n });\n incomingByRequest.delete(context.id);\n const ref = child.ref ?? null;\n serve({\n processId: params.processId,\n // A sandbox that ignored `durable` gave an ordinary process.\n served: { process: child, detach: ref == null ? null : detach },\n signal: abortSignal,\n stdout: { streamId: params.stdoutStreamId, stream: child.stdout },\n stderr: { streamId: params.stderrStreamId, stream: child.stderr },\n });\n return { pid: child.pid, ref };\n }\n case HandleRpcMethod.StartWorker: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (target.startWorker == null) throw unsupported('worker programs');\n const stdin = incomingByRequest.get(context.id)?.stream ?? null;\n if (processes.has(params.processId))\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: 'processId already in use',\n });\n const detach = params.durable === true ? new AbortController() : null;\n const started = await target.startWorker({\n program: params.program,\n env: params.env,\n input: params.input,\n ...(params.identity == null ? {} : { identity: params.identity }),\n ...(detach == null ? {} : { durable: true, abortSignal: detach.signal }),\n });\n const upload = incomingByRequest.get(context.id);\n incomingByRequest.delete(context.id);\n // The program serves its own endpoint: nothing flows on the request's streams.\n if (isSandboxWorkerEndpoint(started)) {\n if (upload != null) peer.streams.cancelIncoming(upload.streamId, 'worker endpoint');\n return { endpoint: started.endpoint };\n }\n const worker = started;\n if (stdin != null) void pipeInto(stdin, worker).catch(() => undefined);\n const ref = worker.ref ?? null;\n workers.add(params.processId);\n serve({\n processId: params.processId,\n served: { process: worker, detach: ref == null ? null : detach },\n signal: abortSignal,\n stdout: { streamId: params.stdoutStreamId, stream: worker.stdout },\n stderr: { streamId: params.stderrStreamId, stream: worker.stderr },\n });\n return { pid: worker.pid, ref };\n }\n case HandleRpcMethod.ProcessAttach: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (target.attachProcess == null) throw unsupported('durable processes');\n if (processes.has(params.processId))\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: 'processId already in use',\n });\n const detach = new AbortController();\n // Until it is served, cancelling the request (or closing the connection)\n // cancels the attach; afterwards the handle lives until released.\n const cancelAttach = () => detach.abort(abortSignal.reason);\n abortSignal.addEventListener('abort', cancelAttach, { once: true });\n let attached: Awaited<ReturnType<NonNullable<typeof target.attachProcess>>>;\n try {\n attached = await target.attachProcess({\n ref: params.ref,\n stdoutOffset: params.stdoutOffset,\n stderrOffset: params.stderrOffset,\n abortSignal: detach.signal,\n });\n } finally {\n abortSignal.removeEventListener('abort', cancelAttach);\n }\n if (attached == null)\n return {\n found: false,\n stdoutOffset: params.stdoutOffset,\n stderrOffset: params.stderrOffset,\n };\n serve({\n processId: params.processId,\n served: { process: attached, detach },\n signal: abortSignal,\n stdout: { streamId: params.stdoutStreamId, stream: attached.stdout },\n stderr: { streamId: params.stderrStreamId, stream: attached.stderr },\n });\n return {\n found: true,\n stdoutOffset: attached.stdoutOffset,\n stderrOffset: attached.stderrOffset,\n };\n }\n case HandleRpcMethod.ProcessWait: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const child = servedProcess(params.processId).process;\n const result = await new Promise<{ exitCode: number }>((resolve, reject) => {\n const onAbort = () =>\n reject(handleRpcError({ code: HandleRpcErrorCode.Cancelled, message: 'cancelled' }));\n abortSignal.addEventListener('abort', onAbort, { once: true });\n child.wait().then(\n (value) => {\n abortSignal.removeEventListener('abort', onAbort);\n resolve(value);\n },\n (cause: unknown) => {\n abortSignal.removeEventListener('abort', onAbort);\n reject(cause);\n },\n );\n });\n processes.delete(params.processId);\n workers.delete(params.processId);\n return result;\n }\n case HandleRpcMethod.ProcessDetach: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const served = processes.get(params.processId);\n // Detaching what is already gone (exited and released, or never known) is done.\n if (served == null) return {};\n if (served.detach == null) throw unsupported('detaching an ordinary process');\n processes.delete(params.processId);\n workers.delete(params.processId);\n await releaseProcess(served);\n return {};\n }\n case HandleRpcMethod.ProcessKill: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await servedProcess(params.processId).process.kill(params.signal);\n return {};\n }\n case HandleRpcMethod.Run: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return target.run({ ...params, abortSignal });\n }\n case HandleRpcMethod.Stat: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return {\n stat:\n params.root == null\n ? await target.stat({ path: params.path, abortSignal })\n : await (\n target.confinedFileReader?.stat ?? ((options) => confinedStat(target, options))\n )({\n path: params.path,\n root: params.root,\n abortSignal,\n }),\n };\n }\n case HandleRpcMethod.ReadDir: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return {\n entries:\n params.root == null\n ? await target.readDir({ path: params.path, abortSignal })\n : await (\n target.confinedFileReader?.readDir ??\n ((options) => confinedReadDir(target, options))\n )({\n path: params.path,\n root: params.root,\n abortSignal,\n }),\n };\n }\n case HandleRpcMethod.RemovePath: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await target.removePath({ ...params, abortSignal });\n return {};\n }\n case HandleRpcMethod.GetPortEndpoint: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return target.getPortEndpoint(params);\n }\n case HandleRpcMethod.Stop:\n await target.stop();\n return {};\n case HandleRpcMethod.Destroy:\n await target.destroy();\n return {};\n case HandleRpcMethod.OnRuntimeShutdown: {\n if (handle == null) throw unsupported('provider lifecycle hooks');\n const shutdownHandle = handle;\n shutdown ??= (async () => {\n await Promise.allSettled([...processes.values()].map(releaseProcess));\n await Promise.allSettled([...mcpConnections.values()].map((channel) => channel.close()));\n processes.clear();\n mcpConnections.clear();\n mcpEndpoints.clear();\n await shutdownHandle.onRuntimeShutdown();\n })();\n await shutdown;\n return {};\n }\n case HandleRpcMethod.OnSandboxStop:\n if (handle == null) throw unsupported('provider lifecycle hooks');\n await handle.onSandboxStop();\n return {};\n case HandleRpcMethod.OnSandboxDelete: {\n if (handle == null) throw unsupported('provider lifecycle hooks');\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await handle.onSandboxDelete(params);\n return {};\n }\n case HandleRpcMethod.SetNetworkPolicy: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n if (target.setNetworkPolicy == null) throw unsupported('network policy');\n await target.setNetworkPolicy(params);\n return {};\n }\n case HandleRpcMethod.ComputerUse: {\n if (target.computerUse == null) throw unsupported('computer use');\n if (needsMcpChannels(target) && args.mcpChannels !== true)\n throw unsupported('guarded MCP transport; negotiate mcpChannels');\n const endpoint = await target.computerUse();\n return mcpDescriptor(endpoint, 'computerUse');\n }\n case HandleRpcMethod.McpOpen: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const endpoint = mcpEndpoints.get(params.endpointKey);\n if (args.mcpChannels !== true || endpoint == null)\n throw unsupported('MCP channel endpoint');\n const channel = await endpoint.connect({ abortSignal });\n if (abortSignal.aborted) {\n await channel.close();\n abortSignal.throwIfAborted();\n }\n const channelId = String(++nextMcpChannelId);\n mcpConnections.set(channelId, channel);\n return { channelId };\n }\n case HandleRpcMethod.McpSend: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n await mcpConnection(params.channelId).send(params.message, { abortSignal });\n return {};\n }\n case HandleRpcMethod.McpReceive: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return { messages: await mcpConnection(params.channelId).receive({ abortSignal }) };\n }\n case HandleRpcMethod.McpClose: {\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n const channel = mcpConnection(params.channelId);\n await channel.close();\n mcpConnections.delete(params.channelId);\n return {};\n }\n case HandleRpcMethod.Screen: {\n if (target.screen == null) throw unsupported('screen');\n const params = parseParams(handleRpcMethodSchemas[method].params, context.params);\n return target.screen(params);\n }\n case HandleRpcMethod.LocalMcp:\n if (target.localMcp == null) throw unsupported('local MCP servers');\n if (needsMcpChannels(target) && args.mcpChannels !== true)\n throw unsupported('guarded MCP transport; negotiate mcpChannels');\n return {\n endpoints: (await target.localMcp()).flatMap((endpoint, index) =>\n args.mcpChannels !== true && isMcpChannelEndpoint(endpoint)\n ? []\n : [mcpDescriptor(endpoint, `localMcp:${index}:${endpoint.name}`)],\n ),\n };\n }\n };\n\n // Registers client-to-server streams synchronously, before their chunks.\n const beforeRequest = (context: RpcRequestContextIface) => {\n if (\n context.method !== HandleRpcMethod.WriteFile &&\n context.method !== HandleRpcMethod.Spawn &&\n context.method !== HandleRpcMethod.StartWorker\n )\n return;\n const ids = uploadStreamIdsSchema.safeParse(context.params);\n if (!ids.success) return;\n const streamId =\n context.method === HandleRpcMethod.WriteFile ? ids.data.streamId : ids.data.stdinStreamId;\n if (streamId == null) return;\n const stream = peer.streams.openIncoming(streamId);\n // Reject unauthorized or disallowed uploads before buffering their data.\n if (\n sandbox == null ||\n handleMethodRefusal({\n access,\n method:\n context.method === HandleRpcMethod.WriteFile ||\n context.method === HandleRpcMethod.StartWorker\n ? context.method\n : HandleRpcMethod.Spawn,\n params: context.params,\n }) != null\n ) {\n peer.streams.cancelIncoming(streamId, 'rejected');\n return;\n }\n incomingByRequest.set(context.id, { streamId, stream });\n };\n\n const onClose = () => {\n if (expiryTimer != null) clearTimeout(expiryTimer);\n for (const served of processes.values()) releaseProcess(served).catch(() => undefined);\n for (const channel of mcpConnections.values()) void channel.close().catch(() => undefined);\n mcpConnections.clear();\n mcpEndpoints.clear();\n processes.clear();\n incomingByRequest.clear();\n };\n\n const peer: RpcPeerIface = createRpcPeer({\n channel: args.channel,\n binary: args.binary,\n onRequest: dispatch,\n beforeRequest,\n onClose,\n });\n\n return { close: (code, reason) => peer.close(code, reason) };\n};\n\nexport interface ServeSandboxHandleArgsIface {\n sandbox: NetworkSandboxSessionIface;\n handle?: HandleLifecycle;\n authorize: HandleAuthorizeFn;\n authorizeOperation?: HandleRpcMessageHandlerOptionsIface['authorizeOperation'];\n access?: HandleAccessPolicyIface;\n binary?: boolean;\n // The outer host applies hosted-tool policy before exposing this transport.\n mcpChannels?: boolean;\n now?: () => number;\n}\n\nexport interface SandboxHandleServerIface {\n // Attaches a connection; returns a function that closes it.\n attach(channel: FrameChannelIface, context?: { token?: string | null }): () => void;\n attachWebSocket(socket: WebSocketLikeIface, context?: { token?: string | null }): () => void;\n attachStream(stream: FrameStreamIface, context?: { token?: string | null }): () => void;\n messageHandler(args: {\n send: (frame: WireFrame) => void;\n close: (code: number, reason: string) => void;\n token?: string | null;\n }): HandleRpcMessageHandlerIface;\n}\n\nexport const serveSandboxHandle = (args: ServeSandboxHandleArgsIface): SandboxHandleServerIface => {\n const access = args.access ?? DEFAULT_HANDLE_ACCESS;\n const resolve = async (): Promise<HandleResolutionIface> => ({\n sandbox: args.sandbox,\n handle: args.handle,\n });\n const attach = (channel: FrameChannelIface, context?: { token?: string | null }) => {\n const connection = createServerConnection({\n channel,\n authorize: args.authorize,\n authorizeOperation: args.authorizeOperation,\n resolve,\n access,\n connectionToken: context?.token ?? null,\n binary: args.binary ?? true,\n mcpChannels: args.mcpChannels,\n now: args.now ?? Date.now,\n });\n return () => connection.close(HandleRpcCloseCode.Normal, 'closed');\n };\n return {\n attach,\n attachWebSocket: (socket, context) =>\n attach(frameChannelFromWebSocket(socket).channel, context),\n attachStream: (stream, context) => attach(frameChannelFromStream(stream), context),\n messageHandler: (handlerArgs) =>\n createHandleRpcMessageHandler({\n send: handlerArgs.send,\n close: handlerArgs.close,\n authorize: args.authorize,\n authorizeOperation: args.authorizeOperation,\n resolve,\n access,\n connectionToken: handlerArgs.token ?? null,\n binary: args.binary,\n mcpChannels: args.mcpChannels,\n now: args.now,\n }),\n };\n};\n"],
5
+ "mappings": "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",
6
6
  "names": ["args"]
7
7
  }
@@ -17,7 +17,6 @@ const nativePolicyKeys = /* @__PURE__ */ new Set([
17
17
  "process",
18
18
  "ports",
19
19
  "networkPolicy",
20
- "egress",
21
20
  "computerUse",
22
21
  "screen",
23
22
  "localMcp",
@@ -26,27 +25,10 @@ const nativePolicyKeys = /* @__PURE__ */ new Set([
26
25
  "files.read",
27
26
  "files.write",
28
27
  "lifecycle",
29
- "network",
30
- "network.egress",
31
- "network.egress.configure",
32
- "network.egress.disable",
33
- "network.egress.status"
28
+ "network"
34
29
  ]);
35
30
  const resolveSandboxToolPolicy = (policy, keys) => {
36
31
  const valueOf = (key) => Object.hasOwn(policy, key) ? policy[key] : void 0;
37
- const egress = keys.includes("egress") && keys.includes("network.egress");
38
- if (egress) {
39
- const key = keys.find((candidate) => valueOf(candidate) === ToolApproval.Ask);
40
- if (key != null) return { key, decision: ToolApproval.Ask };
41
- }
42
- if (egress && (keys.includes("network.egress.configure") || keys.includes("network.egress.disable"))) {
43
- const actionKey = keys.includes("network.egress.configure") ? "network.egress.configure" : "network.egress.disable";
44
- const key = valueOf(actionKey) === ToolApproval.Allow ? actionKey : void 0;
45
- return {
46
- key: key ?? actionKey,
47
- decision: key == null ? ToolApproval.Ask : ToolApproval.Allow
48
- };
49
- }
50
32
  const hosted = keys.length > 1 && (keys.includes("localMcp") || keys.includes("computerUse"));
51
33
  for (const [index, key] of keys.entries()) {
52
34
  const decision = valueOf(key);
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/tool-policy.ts"],
4
- "sourcesContent": ["import { ToolApprovalMode as ToolApproval } from \"../document.mjs\";\n\n// Native names remain eligible for Ask, but cannot lend an Allow to a hosted tool.\nconst nativePolicyKeys = new Set([\n 'run',\n 'spawn',\n 'process_output',\n 'process_input',\n 'process_terminate',\n 'read_file',\n 'write_file',\n 'edit_file',\n 'list_dir',\n 'stat',\n 'grep',\n 'glob',\n 'get_host',\n 'files',\n 'process',\n 'ports',\n 'networkPolicy',\n 'egress',\n 'computerUse',\n 'screen',\n 'localMcp',\n 'browser',\n 'shell',\n 'files.read',\n 'files.write',\n 'lifecycle',\n 'network',\n 'network.egress',\n 'network.egress.configure',\n 'network.egress.disable',\n 'network.egress.status',\n]);\n\n// Network and lifecycle consent both apply to egress mutations; neither Allow can waive an Ask.\nexport const resolveSandboxToolPolicy = (\n policy: Record<string, ToolApproval>,\n keys: readonly string[],\n): { key: string; decision: ToolApproval } | null => {\n const valueOf = (key: string) => (Object.hasOwn(policy, key) ? policy[key] : undefined);\n const egress = keys.includes('egress') && keys.includes('network.egress');\n if (egress) {\n const key = keys.find((candidate) => valueOf(candidate) === ToolApproval.Ask);\n if (key != null) return { key, decision: ToolApproval.Ask };\n }\n if (\n egress &&\n (keys.includes('network.egress.configure') || keys.includes('network.egress.disable'))\n ) {\n const actionKey = keys.includes('network.egress.configure')\n ? 'network.egress.configure'\n : 'network.egress.disable';\n const key = valueOf(actionKey) === ToolApproval.Allow ? actionKey : undefined;\n return {\n key: key ?? actionKey,\n decision: key == null ? ToolApproval.Ask : ToolApproval.Allow,\n };\n }\n const hosted = keys.length > 1 && (keys.includes('localMcp') || keys.includes('computerUse'));\n for (const [index, key] of keys.entries()) {\n const decision = valueOf(key);\n if (hosted && index === 0 && nativePolicyKeys.has(key) && decision === ToolApproval.Allow)\n continue;\n if (decision === ToolApproval.Ask || decision === ToolApproval.Allow) return { key, decision };\n }\n return null;\n};\n"],
5
- "mappings": "AAAA,SAAS,oBAAoB,oBAAoB;AAGjD,MAAM,mBAAmB,oBAAI,IAAI;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,MAAM,2BAA2B,CACtC,QACA,SACmD;AACnD,QAAM,UAAU,CAAC,QAAiB,OAAO,OAAO,QAAQ,GAAG,IAAI,OAAO,GAAG,IAAI;AAC7E,QAAM,SAAS,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,gBAAgB;AACxE,MAAI,QAAQ;AACV,UAAM,MAAM,KAAK,KAAK,CAAC,cAAc,QAAQ,SAAS,MAAM,aAAa,GAAG;AAC5E,QAAI,OAAO,KAAM,QAAO,EAAE,KAAK,UAAU,aAAa,IAAI;AAAA,EAC5D;AACA,MACE,WACC,KAAK,SAAS,0BAA0B,KAAK,KAAK,SAAS,wBAAwB,IACpF;AACA,UAAM,YAAY,KAAK,SAAS,0BAA0B,IACtD,6BACA;AACJ,UAAM,MAAM,QAAQ,SAAS,MAAM,aAAa,QAAQ,YAAY;AACpE,WAAO;AAAA,MACL,KAAK,OAAO;AAAA,MACZ,UAAU,OAAO,OAAO,aAAa,MAAM,aAAa;AAAA,IAC1D;AAAA,EACF;AACA,QAAM,SAAS,KAAK,SAAS,MAAM,KAAK,SAAS,UAAU,KAAK,KAAK,SAAS,aAAa;AAC3F,aAAW,CAAC,OAAO,GAAG,KAAK,KAAK,QAAQ,GAAG;AACzC,UAAM,WAAW,QAAQ,GAAG;AAC5B,QAAI,UAAU,UAAU,KAAK,iBAAiB,IAAI,GAAG,KAAK,aAAa,aAAa;AAClF;AACF,QAAI,aAAa,aAAa,OAAO,aAAa,aAAa,MAAO,QAAO,EAAE,KAAK,SAAS;AAAA,EAC/F;AACA,SAAO;AACT;",
4
+ "sourcesContent": ["import { ToolApprovalMode as ToolApproval } from \"../document.mjs\";\n\n// Native names remain eligible for Ask, but cannot lend an Allow to a hosted tool.\nconst nativePolicyKeys = new Set([\n 'run',\n 'spawn',\n 'process_output',\n 'process_input',\n 'process_terminate',\n 'read_file',\n 'write_file',\n 'edit_file',\n 'list_dir',\n 'stat',\n 'grep',\n 'glob',\n 'get_host',\n 'files',\n 'process',\n 'ports',\n 'networkPolicy',\n 'computerUse',\n 'screen',\n 'localMcp',\n 'browser',\n 'shell',\n 'files.read',\n 'files.write',\n 'lifecycle',\n 'network',\n]);\n\n// The first key the policy decides, most specific first. A hosted tool cannot\n// borrow an Allow from a native name it shadows.\nexport const resolveSandboxToolPolicy = (\n policy: Record<string, ToolApproval>,\n keys: readonly string[],\n): { key: string; decision: ToolApproval } | null => {\n const valueOf = (key: string) => (Object.hasOwn(policy, key) ? policy[key] : undefined);\n const hosted = keys.length > 1 && (keys.includes('localMcp') || keys.includes('computerUse'));\n for (const [index, key] of keys.entries()) {\n const decision = valueOf(key);\n if (hosted && index === 0 && nativePolicyKeys.has(key) && decision === ToolApproval.Allow)\n continue;\n if (decision === ToolApproval.Ask || decision === ToolApproval.Allow) return { key, decision };\n }\n return null;\n};\n"],
5
+ "mappings": "AAAA,SAAS,oBAAoB,oBAAoB;AAGjD,MAAM,mBAAmB,oBAAI,IAAI;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAIM,MAAM,2BAA2B,CACtC,QACA,SACmD;AACnD,QAAM,UAAU,CAAC,QAAiB,OAAO,OAAO,QAAQ,GAAG,IAAI,OAAO,GAAG,IAAI;AAC7E,QAAM,SAAS,KAAK,SAAS,MAAM,KAAK,SAAS,UAAU,KAAK,KAAK,SAAS,aAAa;AAC3F,aAAW,CAAC,OAAO,GAAG,KAAK,KAAK,QAAQ,GAAG;AACzC,UAAM,WAAW,QAAQ,GAAG;AAC5B,QAAI,UAAU,UAAU,KAAK,iBAAiB,IAAI,GAAG,KAAK,aAAa,aAAa;AAClF;AACF,QAAI,aAAa,aAAa,OAAO,aAAa,aAAa,MAAO,QAAO,EAAE,KAAK,SAAS;AAAA,EAC/F;AACA,SAAO;AACT;",
6
6
  "names": []
7
7
  }
@@ -3,8 +3,8 @@ import * as z from 'zod';
3
3
  import { SandboxEntryType } from "./file-kind.mjs";
4
4
  export { SandboxEntryType } from "./file-kind.mjs";
5
5
  import { type SandboxExecutionPolicyIface } from "./handle.mjs";
6
- import type { WorkspaceEgressRequestIface, WorkspaceEgressStatusIface, WorkspaceNetworkPolicyIface as NetworkPolicyIface } from '@finalai/agent-protocol/device-egress';
7
- export { WorkspaceNetworkPolicy as NetworkPolicy, type WorkspaceNetworkPolicyIface as NetworkPolicyIface, } from '@finalai/agent-protocol/device-egress';
6
+ import { type NetworkPolicyIface } from '@finalai/agent-protocol/network-policy';
7
+ export { NetworkPolicy, type NetworkPolicyIface } from '@finalai/agent-protocol/network-policy';
8
8
  import type { ProcessInspectionRequestIface, ProcessInspectionResultIface } from '@finalai/agent-protocol/process-inspection';
9
9
  import type { JsonValue } from "../json.mjs";
10
10
  import type { ToolDescriptorIface } from "../tool-descriptor.mjs";
@@ -210,7 +210,6 @@ export interface NetworkSandboxSessionIface extends SandboxSessionIface {
210
210
  stop(): Promise<void>;
211
211
  destroy(): Promise<void>;
212
212
  setNetworkPolicy?(policy: NetworkPolicyIface): Promise<void>;
213
- egress?(request: WorkspaceEgressRequestIface): Promise<WorkspaceEgressStatusIface>;
214
213
  computerUse?(): Promise<SandboxMcpEndpoint>;
215
214
  startWorker?(options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType>;
216
215
  screen?(options?: ScreenOptionsIface): Promise<ScreenSessionIface>;
@@ -221,7 +220,6 @@ export declare enum SandboxCapability {
221
220
  Process = "process",
222
221
  Ports = "ports",
223
222
  NetworkPolicy = "networkPolicy",
224
- Egress = "egress",
225
223
  ComputerUse = "computerUse",
226
224
  Screen = "screen",
227
225
  LocalMcp = "localMcp",
@@ -4,10 +4,8 @@ import { SandboxEntryType } from "./file-kind.mjs";
4
4
  import { SandboxEntryType as SandboxEntryType2 } from "./file-kind.mjs";
5
5
  import { createSandboxHandle } from "./handle.mjs";
6
6
  import { withSandboxOverrides } from "./overrides.mjs";
7
- import { WorkspaceNetworkPolicy as NetworkPolicy } from "@finalai/agent-protocol/device-egress";
8
- import {
9
- WorkspaceNetworkPolicy
10
- } from "@finalai/agent-protocol/device-egress";
7
+ import { NetworkPolicy } from "@finalai/agent-protocol/network-policy";
8
+ import { NetworkPolicy as NetworkPolicy2 } from "@finalai/agent-protocol/network-policy";
11
9
  import {
12
10
  SandboxEditorOperation
13
11
  } from "./editor.mjs";
@@ -31,7 +29,6 @@ var SandboxCapability = /* @__PURE__ */ ((SandboxCapability2) => {
31
29
  SandboxCapability2["Process"] = "process";
32
30
  SandboxCapability2["Ports"] = "ports";
33
31
  SandboxCapability2["NetworkPolicy"] = "networkPolicy";
34
- SandboxCapability2["Egress"] = "egress";
35
32
  SandboxCapability2["ComputerUse"] = "computerUse";
36
33
  SandboxCapability2["Screen"] = "screen";
37
34
  SandboxCapability2["LocalMcp"] = "localMcp";
@@ -136,7 +133,7 @@ var SandboxEventKind = /* @__PURE__ */ ((SandboxEventKind2) => {
136
133
  return SandboxEventKind2;
137
134
  })(SandboxEventKind || {});
138
135
  export {
139
- WorkspaceNetworkPolicy as NetworkPolicy,
136
+ NetworkPolicy2 as NetworkPolicy,
140
137
  PLATFORM_ENVIRONMENT_NAMES,
141
138
  PortProtocol,
142
139
  SandboxCapability,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/types.ts"],
4
- "sourcesContent": ["import { Capability, RuntimeKind, type CapabilityAccess } from '@finalai/agent-protocol';\nimport * as z from 'zod';\nimport { SandboxEntryType } from \"./file-kind.mjs\";\nexport { SandboxEntryType } from \"./file-kind.mjs\";\nimport { createSandboxHandle, type SandboxExecutionPolicyIface } from \"./handle.mjs\";\nimport { withSandboxOverrides } from \"./overrides.mjs\";\nimport { WorkspaceNetworkPolicy as NetworkPolicy } from '@finalai/agent-protocol/device-egress';\nimport type {\n WorkspaceEgressRequestIface,\n WorkspaceEgressStatusIface,\n WorkspaceNetworkPolicyIface as NetworkPolicyIface,\n} from '@finalai/agent-protocol/device-egress';\nexport {\n WorkspaceNetworkPolicy as NetworkPolicy,\n type WorkspaceNetworkPolicyIface as NetworkPolicyIface,\n} from '@finalai/agent-protocol/device-egress';\nimport type {\n ProcessInspectionRequestIface,\n ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nimport type { JsonValue } from \"../json.mjs\";\nimport type { ToolDescriptorIface } from \"../tool-descriptor.mjs\";\nimport {\n SandboxEditorOperation,\n type SandboxEditorRequestIface,\n type SandboxEditorResultIface,\n} from \"./editor.mjs\";\nimport { SandboxExecutionOperation } from \"./execution-guard.mjs\";\nimport type { SandboxSetupIface } from \"./setup/schema.mjs\";\nimport type { SandboxSnapshotRequestIface, SandboxSnapshotResponseIface } from \"./snapshots.mjs\";\n\n// Sandbox providers and consumers share the streaming session contract.\n\nexport interface AbortableIface {\n abortSignal?: AbortSignal;\n}\n\nexport interface SandboxProcessOptionsIface extends AbortableIface {\n command: string;\n args?: string[];\n cwd?: string;\n env?: Record<string, string>;\n // Run through the sandbox's login shell (`bash -lc`) instead of exec'ing.\n shell?: boolean;\n stdin?: ReadableStream<Uint8Array> | string;\n timeoutMs?: number;\n // Spawn only (`run` ignores it): ask for a durable process on a sandbox with\n // SandboxCapability.DurableProcesses; ignored elsewhere (the handle's `ref`\n // is then null). A durable process ends only on its own exit, `kill`,\n // `timeoutMs` (enforced inside the sandbox, not by a provider-side timer) or\n // sandbox stop/destroy. Dropping its handle (connection close, runtime\n // shutdown, `abortSignal`) detaches without killing: the handle's streams\n // fail and `wait` rejects, and `attachProcess` finds the process again.\n durable?: boolean;\n}\n\nexport interface SandboxProcessIface {\n readonly pid: string | null;\n // Opaque, provider-encoded (versioned) reference for `attachProcess`; non-null\n // only for a durable process on a sandbox with durable processes. Optional so\n // implementations without them need not set it.\n readonly ref?: string | null;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n // Writes to the process's stdin; closes stdin when `end` is true.\n write(data: Uint8Array | string, options?: { end?: boolean }): Promise<void>;\n wait(): Promise<{ exitCode: number }>;\n kill(signal?: string): Promise<void>;\n}\n\n// A program built for the sandbox's worker runtime, started for one harness\n// session. Its handle is a process's: what is written to it is its input\n// stream, stdout its output stream, stderr its diagnostics.\nexport interface SandboxWorkerOptionsIface extends AbortableIface {\n program: string;\n env?: Record<string, string>;\n // Handed to the program when it starts.\n input?: JsonValue;\n // As for spawn: survives the handle on a sandbox with durable processes.\n durable?: boolean;\n // A platform-identity assertion for the program's run (variant `harness-run`),\n // for a runtime that authenticates the programs it starts.\n identity?: string;\n}\n\nexport enum SandboxWorkerEndpointTransport {\n Ws = 'ws',\n Http = 'http',\n Relay = 'relay',\n}\n\n// Where a started worker program serves its stream itself, for the caller to\n// dial directly: an ACP endpoint by URL, or a relay channel.\nexport type SandboxWorkerEndpointType =\n | {\n transport: SandboxWorkerEndpointTransport.Ws | SandboxWorkerEndpointTransport.Http;\n url: string;\n headers: Record<string, string>;\n }\n | { transport: SandboxWorkerEndpointTransport.Relay; channel: string; token: string };\n\nexport interface SandboxWorkerEndpointIface {\n readonly endpoint: SandboxWorkerEndpointType;\n}\n\n// A started worker program: a process whose streams carry its stream, or an\n// endpoint it serves.\nexport type SandboxWorkerStartType = SandboxProcessIface | SandboxWorkerEndpointIface;\n\nexport const isSandboxWorkerEndpoint = (\n started: SandboxWorkerStartType,\n): started is SandboxWorkerEndpointIface => 'endpoint' in started;\n\nexport interface SandboxAttachProcessOptionsIface extends AbortableIface {\n ref: string;\n // Bytes of each stream the caller already has; output resumes there.\n stdoutOffset: number;\n stderrOffset: number;\n}\n\n// A durable process found again by its ref. Its output is read from the\n// provider, which is the source of truth for output and exit; aborting\n// `abortSignal` detaches this handle as it does a spawned durable one.\n//\n// Limitation: stdin belongs to the spawning handle only. A re-attached\n// process can be watched, waited for and killed, but not written to; a process\n// that needs input after a re-attach must read it from somewhere else (a file).\nexport interface SandboxAttachedProcessIface {\n readonly ref: string;\n // Where the streams actually start: the requested offsets, or later when the\n // provider no longer retains the earlier bytes (see each provider's retention).\n readonly stdoutOffset: number;\n readonly stderrOffset: number;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n wait(): Promise<{ exitCode: number }>;\n kill(signal?: string): Promise<void>;\n}\n\nexport interface SandboxRunResultIface {\n exitCode: number;\n stdout: string;\n stderr: string;\n}\n\nexport interface StatIface {\n path: string;\n type: SandboxEntryType;\n size: number;\n modifiedAt: string | null;\n mode: number | null;\n}\n\nexport interface DirEntryIface {\n name: string;\n path: string;\n type: SandboxEntryType;\n size: number | null;\n}\n\nexport interface ConfinedSandboxFilesIface {\n readFile(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n stat(options: { path: string; root: string } & AbortableIface): Promise<StatIface | null>;\n readDir(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<DirEntryIface[] | null>;\n}\n\nexport interface SandboxSessionIface {\n readonly description: string;\n readonly confinedFileReader?: ConfinedSandboxFilesIface;\n // On the RPC surface, root confines viewer reads to this directory, rejects\n // symlink ancestors and requires Python 3 in the sandbox (confinedFiles feature).\n readFile(\n options: { path: string; root?: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n readBinaryFile(options: { path: string } & AbortableIface): Promise<Uint8Array | null>;\n readTextFile(\n options: {\n path: string;\n encoding?: string;\n startLine?: number;\n endLine?: number;\n } & AbortableIface,\n ): Promise<string | null>;\n writeFile(\n options: { path: string; content: ReadableStream<Uint8Array> } & AbortableIface,\n ): Promise<void>;\n writeBinaryFile(options: { path: string; content: Uint8Array } & AbortableIface): Promise<void>;\n // Writes create missing parent directories.\n writeTextFile(\n options: { path: string; content: string; encoding?: string } & AbortableIface,\n ): Promise<void>;\n spawn(options: SandboxProcessOptionsIface): Promise<SandboxProcessIface>;\n // Present on sandboxes with durable processes. Null when the process is\n // unknown: the sandbox restarted or was deleted, or the ref expired, is\n // malformed or belongs to another sandbox. Attaching after the process\n // exited still yields its retained output and exit code.\n attachProcess?(\n options: SandboxAttachProcessOptionsIface,\n ): Promise<SandboxAttachedProcessIface | null>;\n run(options: SandboxProcessOptionsIface): Promise<SandboxRunResultIface>;\n stat(options: { path: string; root?: string } & AbortableIface): Promise<StatIface | null>;\n readDir(options: { path: string; root?: string } & AbortableIface): Promise<DirEntryIface[]>;\n resolvePath(path: string): string;\n removePath(\n options: { path: string; recursive?: boolean; force?: boolean } & AbortableIface,\n ): Promise<void>;\n}\n\nexport enum PortProtocol {\n Http = 'http',\n Https = 'https',\n Ws = 'ws',\n}\n\n// An MCP transport the sandbox serves for an optional capability: an HTTP MCP\n// endpoint the harness (or the host) can dial.\nexport interface McpEndpointIface {\n name: string;\n url: string;\n headers: Record<string, string>;\n}\n\n// A JSON-RPC message channel to an MCP server the sandbox hosts, for backends\n// whose API reaches it some other way than HTTP MCP (a byte pipe, a socket).\n// Messages are JSON-RPC objects, in order.\nexport interface McpChannelIface {\n send(message: JsonValue, options?: AbortableIface): Promise<void>;\n // The messages that arrived since the last call; [] when none did.\n receive(options?: AbortableIface): Promise<JsonValue[]>;\n close(): Promise<void>;\n}\n\n// An MCP server the sandbox hosts, opened in process by whoever runs the handle.\n// It cannot cross the handle RPC wire.\nexport interface McpChannelEndpointIface {\n name: string;\n connect(options?: AbortableIface): Promise<McpChannelIface>;\n}\n\nexport type SandboxMcpEndpoint = McpEndpointIface | McpChannelEndpointIface;\n\n// The tools of a sandbox's hosted MCP servers, as far as they are known without\n// starting it. Null: unknown until the sandbox is attached and asked.\nexport interface SandboxMcpCatalogIface {\n computerUse: ToolDescriptorIface[] | null;\n // Local MCP server name \u2192 its tools.\n localMcp: Record<string, ToolDescriptorIface[]> | null;\n // Partial discovery retains known tools and must be retried, including after caching.\n localMcpIncomplete?: boolean;\n}\n\nexport const isMcpChannelEndpoint = (\n endpoint: SandboxMcpEndpoint,\n): endpoint is McpChannelEndpointIface => 'connect' in endpoint;\n\nexport interface ScreenOptionsIface {\n // View-only by default; explicit input control requires execute access.\n viewOnly?: boolean;\n}\n\nexport interface ScreenSessionIface {\n // A short-lived viewer grant; providers enforce the requested input access.\n url: string;\n token: string;\n expiresAt: string;\n}\n\nexport interface NetworkSandboxSessionIface extends SandboxSessionIface {\n readonly id: string;\n readonly defaultWorkingDirectory: string;\n readonly ports: readonly number[];\n getPortEndpoint(options: {\n port: number;\n protocol?: PortProtocol;\n }): Promise<{ url: string; headers?: Record<string, string> }>;\n getPortUrl(options: { port: number; protocol?: PortProtocol }): Promise<string>;\n stop(): Promise<void>;\n destroy(): Promise<void>;\n setNetworkPolicy?(policy: NetworkPolicyIface): Promise<void>;\n egress?(request: WorkspaceEgressRequestIface): Promise<WorkspaceEgressStatusIface>;\n computerUse?(): Promise<SandboxMcpEndpoint>;\n // Present on sandboxes whose provider offers RuntimeKind.Worker.\n startWorker?(options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType>;\n screen?(options?: ScreenOptionsIface): Promise<ScreenSessionIface>;\n localMcp?(): Promise<SandboxMcpEndpoint[]>;\n}\n\n// Features a live sandbox handle advertises over the handle RPC (`describe`).\n// Finer than the model's capabilities (`Capability`): `files` is served by the\n// file methods, `shell` by processes and ports, `computerUse` by computer use\n// and the screen; the rest are handle extensions a capability may use.\nexport enum SandboxCapability {\n Files = 'files',\n Process = 'process',\n Ports = 'ports',\n NetworkPolicy = 'networkPolicy',\n Egress = 'egress',\n ComputerUse = 'computerUse',\n Screen = 'screen',\n LocalMcp = 'localMcp',\n Browser = 'browser',\n // `spawn({ durable: true })` and `attachProcess` (see SandboxProcessOptionsIface.durable).\n DurableProcesses = 'durableProcesses',\n // `startWorker`: the sandbox runs worker programs.\n Workers = 'workers',\n}\n\n// The capabilities a provider's sandboxes serve, each with the most access a\n// session can be granted on it. A capability left out is not served.\nexport type SandboxCapabilityOffer = Partial<Record<Capability, CapabilityAccess>>;\n\nexport interface SandboxProviderHandleIface<S extends SandboxSessionIface> {\n readonly sandbox: S;\n // Pending policy; the generic handle constructor consumes it before exposing execution.\n readonly executionPolicy?: SandboxExecutionPolicyIface;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n}\n\n// The person a sandbox acts for on this call: the author of the running turn,\n// else whoever opened the sandbox's viewer. Null when it acts for no person\n// (an unprompted turn, a preparation). Read on each call: it changes between\n// turns and between callers.\nexport interface SandboxActingUserIface {\n current(): Promise<string | null>;\n}\n\nexport const noSandboxActingUser: SandboxActingUserIface = { current: async () => null };\n\n// Credentials the host supplies to a provider. A provider reads no secrets of\n// its own and names no project: it gets the value of the secret its\n// environment's `credential.secretRef` names, resolved in the sandbox's project.\nexport interface SandboxCredentialsIface {\n secret(args: { secretRef: string }): Promise<string | null>;\n}\n\nexport const noSandboxCredentials: SandboxCredentialsIface = { secret: async () => null };\n\n// A provider's credential by reference, in its environment options: the name\n// of a project secret, never its value.\nexport const sandboxCredentialRefSchema = z.strictObject({\n secretRef: z.string().min(1).max(256),\n});\n\nexport type SandboxCredentialRefIface = z.infer<typeof sandboxCredentialRefSchema>;\n\n// A platform-identity assertion (`@finalai/agent-protocol/identity`) for one\n// backend audience, valid until `expiresAt`.\nexport interface SandboxIdentityTokenIface {\n token: string;\n expiresAt: string;\n}\n\n// How a provider authenticates to a backend it needs (its vendor's API): an\n// assertion for `audience`, which the platform issues only for audiences the\n// provider's registration was granted. It names the sandbox's organization,\n// project and sandbox, and the acting user at the time it was issued. Ask\n// before each backend call (hosts cache it); `refresh` asks for a new one\n// after the backend rejected the last.\nexport type SandboxIdentityFn = (args: {\n audience: string;\n refresh?: boolean;\n}) => Promise<SandboxIdentityTokenIface>;\n\nexport const noSandboxIdentity: SandboxIdentityFn = async ({ audience }) => {\n throw new Error(`no identity was granted for ${audience}`);\n};\n\n// What every provider call is given: the project the sandbox belongs to, the\n// host's credentials and the provider's identity for the backends it was\n// granted.\nexport interface SandboxProviderContextIface {\n organizationId: string;\n projectId: string;\n credentials: SandboxCredentialsIface;\n actingUser: SandboxActingUserIface;\n identity: SandboxIdentityFn;\n log?: (message: string, fields?: Record<string, string | number | boolean | null>) => void;\n}\n\n// How the platform runs a sandbox's lifecycle, for the provider to align its\n// backend with: after `parkAfterIdleMs` of idleness the platform parks the\n// sandbox (null: the provider's own default), so a backend idle timeout\n// should be longer.\nexport interface SandboxLifecycleIface {\n parkAfterIdleMs: number | null;\n}\n\n// What reads that start nothing are given (capabilities, catalogs, snapshots,\n// process inspection, the editor). `sandboxId` is set for reads about an\n// existing sandbox.\nexport interface SandboxOfferContextIface extends SandboxProviderContextIface {\n sandboxId?: string;\n executionPolicy?: SandboxExecutionPolicyIface;\n platformNetworkPolicy?: (policy: NetworkPolicyIface) => Promise<void>;\n // Retain platform transport access when an extension restores an allowlist.\n platformEgressHosts?: string[];\n}\n\n// Scoped by the host to this project and provider. Providers can retain\n// reusable intermediate artifacts independently of a sandbox's seed files.\nexport interface SandboxArtifactsIface {\n get(key: string): Promise<JsonValue | null>;\n put(key: string, artifact: JsonValue): Promise<void>;\n}\n\nexport interface SandboxPreparationSourceIface {\n sourceRevision: string;\n read(): Promise<{ files: Record<string, string>; resources: Record<string, JsonValue> }>;\n}\n\n// A preparation builds what an environment's sandboxes start from (an image\n// built into a base, a snapshot). It depends on the environment's options and\n// the seed files only, never on a sandbox setup.\nexport interface SandboxPrepareContextIface extends SandboxProviderContextIface {\n // A host-persisted resource source; artifacts may retain its identity instead of seed contents.\n preparation?: SandboxPreparationSourceIface;\n artifacts?: SandboxArtifactsIface;\n // Workspace-relative seed files and named resources.\n files: Record<string, string>;\n resources: Record<string, JsonValue>;\n sourceRevision: string;\n storagePath: string;\n}\n\n// What a provider is given for one sandbox: its create, attach, detach, park\n// and delete calls.\nexport interface SandboxResourceContextIface extends SandboxProviderContextIface {\n // The platform's id for the sandbox, stable for its whole life.\n sandboxId: string;\n lifecycle: SandboxLifecycleIface;\n // Host policy composes before the provider's policy, on every exposed execution path.\n executionPolicy?: SandboxExecutionPolicyIface;\n preparation?: SandboxPreparationSourceIface;\n storagePath: string;\n // Variables the platform sets in every process of this sandbox: the egress\n // proxy, trust for its CA, one placeholder per bound secret and the sandbox\n // setup's variables. Evaluated again for every spawn/run, never once per\n // attach: a secret bound later must reach the next command. May resolve to\n // {}. Platform values override the environment's own.\n platformEnvironment?: () => Promise<Record<string, string>>;\n // Hosts the sandbox must be able to reach for the proxy to work, appended\n // to any allowlist network policy.\n platformEgressHosts?: string[];\n // Reports the network policy now in force, exactly as the provider applied\n // it to its backend (after withPlatformEgressHosts); the platform permits\n // only those destinations. Called on every attach after awaitRunning and\n // before platformFiles or any command; never for a session's own\n // setNetworkPolicy. A rejection fails the attach.\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>;\n // Files the platform needs before any command runs: written right after the\n // sandbox is running, on every attach. Paths are absolute; missing parent\n // directories are created.\n platformFiles?: () => Promise<Record<string, string>>;\n}\n\n// The variables `platformEnvironment` owns. An environment that sets one is\n// refused at create.\nexport const PLATFORM_ENVIRONMENT_NAMES: ReadonlySet<string> = new Set([\n 'HTTPS_PROXY',\n 'HTTP_PROXY',\n 'NO_PROXY',\n 'NODE_USE_ENV_PROXY',\n 'SSL_CERT_FILE',\n 'CURL_CA_BUNDLE',\n 'REQUESTS_CA_BUNDLE',\n 'GIT_SSL_CAINFO',\n 'CARGO_HTTP_CAINFO',\n 'DENO_CERT',\n 'NODE_EXTRA_CA_CERTS',\n 'FINAL_EGRESS_URL',\n 'FINAL_EGRESS_TOKEN',\n]);\n\n// A process's base environment: the environment's variables under the\n// platform's, read again on every call.\nexport const platformProcessEnvironment =\n (\n ctx: Pick<SandboxResourceContextIface, 'platformEnvironment'>,\n specEnv: Record<string, string>,\n ): (() => Promise<Record<string, string>>) =>\n async () => ({ ...specEnv, ...(await ctx.platformEnvironment?.()) });\n\n// Writes `platformFiles` into a sandbox that is now running, before it runs anything.\n// Relies on writeTextFile creating missing parent directories.\nexport const writePlatformFiles = async (\n ctx: Pick<SandboxResourceContextIface, 'platformFiles'>,\n sandbox: Pick<SandboxSessionIface, 'writeTextFile'>,\n): Promise<void> => {\n for (const [path, content] of Object.entries((await ctx.platformFiles?.()) ?? {}))\n await sandbox.writeTextFile({ path, content });\n};\n\n// Reports the policy a provider just applied to its backend: `allow` only for an\n// allowlist, its entries (hosts, `*.suffix` patterns, CIDRs) unchanged.\nexport const reportPlatformNetworkPolicy = async (\n ctx: Pick<SandboxResourceContextIface, 'platformNetworkPolicy'>,\n policy: NetworkPolicyIface,\n): Promise<void> =>\n ctx.platformNetworkPolicy(\n policy.mode === NetworkPolicy.Allowlist\n ? { mode: policy.mode, allow: [...(policy.allow ?? [])] }\n : { mode: policy.mode },\n );\n\n// An allowlist policy with the platform's egress hosts appended; any other\n// policy unchanged.\nexport const withPlatformEgressHosts = (\n ctx: Pick<SandboxResourceContextIface, 'platformEgressHosts'>,\n policy: NetworkPolicyIface,\n): NetworkPolicyIface => {\n const hosts = ctx.platformEgressHosts ?? [];\n if (policy.mode !== NetworkPolicy.Allowlist || hosts.length === 0) return policy;\n return { ...policy, allow: [...new Set([...(policy.allow ?? []), ...hosts])] };\n};\n\n// One attach of a sandbox: the live handle, and what the attach lost, so the\n// platform knows which phases of the sandbox setup to redo.\nexport interface SandboxAttachmentIface<\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n handle: SandboxProviderHandleIface<S>;\n // The state to keep for the next call (a resumed backend may change ids).\n state: State;\n // The disk is new: nothing written by a setup, the workspace seeds or a\n // session survives on it (first attach, or a backend that lost it).\n fresh: boolean;\n // The machine started on this attach: no process from before is running.\n booted: boolean;\n // Where the backend runs the sandbox (its own region name), so the host can\n // place the harness near it; null when unknown.\n region?: string | null;\n}\n\n// One environment of a provider, as the host drives it. A sandbox is a\n// resource the platform owns: `create` makes it (nothing need boot), `attach`\n// makes it reachable for a while, `detach` lets it go idle, `park` makes it as\n// cheap as the provider can while keeping its disk, `delete` destroys it.\n//\n// Order on attach: attach (boot or resume) \u2192 awaitRunning \u2192\n// platformNetworkPolicy \u2192 platformFiles \u2192 handle; the platform then applies\n// the sandbox setup through the handle (./setup). A provider never runs a\n// setup's steps itself.\nexport interface SandboxEnvironmentImplementationIface<\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n // The capabilities this environment's sandboxes serve and the most access\n // each grants, known without creating one.\n capabilities(ctx: SandboxOfferContextIface): Promise<SandboxCapabilityOffer>;\n // What a harness can run in this environment's sandboxes: processes, worker\n // programs (`startWorker`), or both. Absent: processes when it offers `shell`.\n runtimes?(ctx: SandboxOfferContextIface): Promise<RuntimeKind[]>;\n // Handle features this environment's sandboxes advertise, read before\n // anything starts. Absent or null: unknown until attached; local MCP is then\n // not projected.\n features?(ctx: SandboxOfferContextIface): Promise<SandboxCapability[] | null>;\n // Known positive features when the rest of the pre-attach set is unknown.\n additionalFeatures?(ctx: SandboxOfferContextIface): Promise<SandboxCapability[]>;\n // The hosted MCP servers' tool catalogs the backend can give without\n // attaching, so the MCP projection lists them from the first `tools/list`.\n // A catalog left unknown can only be learned from a live sandbox, so the\n // first `tools/list` that finds it unknown attaches in the background.\n mcpCatalog?(ctx: SandboxOfferContextIface): Promise<SandboxMcpCatalogIface | null>;\n // Reads committed files without attaching. Null means the backend is live\n // or offers no snapshot. An unavailable sleeping snapshot must throw, never\n // fall through to a read that wakes it. Pin later ranges by snapshotId.\n readSnapshot?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxSnapshotRequestIface,\n ): Promise<SandboxSnapshotResponseIface | null>;\n // Inspect retained backend processes without attaching or extending a sandbox.\n // Stopping one requires shell access; the provider also enforces backend ownership.\n processes?(\n ctx: SandboxOfferContextIface & { sandboxId: string },\n state: State,\n request: ProcessInspectionRequestIface,\n ): Promise<ProcessInspectionResultIface>;\n // Browser editor for an existing sandbox. The host checks write\n // authorization; this hook never creates or wakes a backend. Credentials stay\n // in the authentication form, never the editor URL or stored provider state.\n editor?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxEditorRequestIface,\n ): Promise<SandboxEditorResultIface>;\n // Content-addressed by `artifactKey`; the host caches artifacts and calls\n // prepare only on a miss.\n artifactKey(ctx: SandboxPrepareContextIface): Promise<string>;\n prepare(ctx: SandboxPrepareContextIface): Promise<Artifact>;\n // Makes the sandbox's backend resource. The setup is given so the\n // provider enforces its network policy from the first boot (or refuses);\n // its repositories, steps and services are applied by the platform.\n create(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; setup: SandboxSetupIface | null },\n ): Promise<{ state: State; region?: string | null }>;\n // Resolves once the backend named by `state` is running and will accept a\n // command or a file write; rejects with a clear error after `timeoutMs`.\n // The provider chooses the readiness signal and backoff; the platform never\n // polls a backend itself.\n awaitRunning(\n ctx: SandboxResourceContextIface,\n state: State,\n options: { timeoutMs: number },\n ): Promise<void>;\n // Boots or resumes the sandbox and returns a live handle.\n attach(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; state: State },\n ): Promise<SandboxAttachmentIface<State, S>>;\n // Reconnects to an already running backend for a read-only viewer: never\n // boots, creates, seeds or restarts anything. Absent: viewers use a live\n // handle or nothing.\n attachPassive?(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; state: State },\n ): Promise<SandboxProviderHandleIface<S>>;\n // The host is done with its handle for now; the sandbox may go idle on the\n // provider's own policy. Returns the state the next attach needs.\n detach(ctx: SandboxResourceContextIface, args: { state: State }): Promise<State>;\n // Pauses or stops the sandbox, keeping its disk. Returns the state the next attach needs.\n park(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; state: State },\n ): Promise<State>;\n // Destroys the backend resource and its disk. Deleting one already gone succeeds.\n delete(ctx: SandboxResourceContextIface, args: { state: State }): Promise<void>;\n}\n\nexport interface SandboxProviderDefinitionIface<\n EnvOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n name: string;\n // The version of `State`'s shape. The host records it with each sandbox and\n // refuses to attach a state written under another version.\n stateProtocolVersion?: number;\n // Validates the options and returns the environment they describe.\n environment(options?: EnvOptions): SandboxEnvironmentImplementationIface<Artifact, State, S>;\n}\n\n// What `project.sandboxes.create(environment, \u2026)` takes: a provider by name\n// and that provider's own environment options, as plain data.\nexport interface SandboxEnvironmentValueIface<EnvOptions = JsonValue> {\n provider: string;\n environment: EnvOptions;\n}\n\n// A defined provider: the definition the host drives, and `environment(opts)`\n// returning the plain value a caller creates sandboxes from.\nexport interface SandboxProviderIface<\n EnvOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n readonly definition: SandboxProviderDefinitionIface<EnvOptions, Artifact, State, S>;\n readonly name: string;\n environment(options: EnvOptions): SandboxEnvironmentValueIface<EnvOptions>;\n}\n\nexport const defineSandboxProvider = <\n EnvOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n>(\n definition: SandboxProviderDefinitionIface<EnvOptions, Artifact, State, S>,\n): SandboxProviderIface<EnvOptions, Artifact, State, S> => ({\n definition: withSandboxOverrides(definition, {\n environment: (options?: EnvOptions) => {\n const implementation = definition.environment(options);\n for (const method of [\n 'create',\n 'attach',\n 'detach',\n 'park',\n 'delete',\n 'awaitRunning',\n ] as const)\n if (typeof implementation[method] !== 'function')\n throw new Error(`sandbox provider ${definition.name} does not implement ${method}`);\n const overrides: Partial<typeof implementation> = {\n attach: async (ctx, args) => {\n const attached = await implementation.attach(ctx, args);\n return {\n ...attached,\n handle: createSandboxHandle({\n handle: attached.handle,\n executionPolicy: ctx.executionPolicy,\n }),\n };\n },\n };\n if (implementation.editor != null) {\n const editor = implementation.editor.bind(implementation);\n overrides.editor = async (ctx, state, request) => {\n if (\n request.operation === SandboxEditorOperation.Open ||\n request.operation === SandboxEditorOperation.Refresh\n )\n await ctx.executionPolicy?.beforeExecution({\n operation: SandboxExecutionOperation.Editor,\n background: false,\n });\n return editor(ctx, state, request);\n };\n }\n if (implementation.attachPassive != null) {\n const attachPassive = implementation.attachPassive.bind(implementation);\n overrides.attachPassive = async (ctx, args) =>\n createSandboxHandle({\n handle: await attachPassive(ctx, args),\n executionPolicy: ctx.executionPolicy,\n });\n }\n return withSandboxOverrides(implementation, overrides);\n },\n }),\n name: definition.name,\n environment: (options) => ({ provider: definition.name, environment: options }),\n});\n\n// The runtime kinds an environment declares, or its default.\nexport const sandboxRuntimesOf = async (\n environment: Pick<\n SandboxEnvironmentImplementationIface<JsonValue, JsonValue, NetworkSandboxSessionIface>,\n 'capabilities' | 'runtimes'\n >,\n ctx: SandboxOfferContextIface,\n): Promise<RuntimeKind[]> => {\n if (environment.runtimes != null) return environment.runtimes(ctx);\n const offer = await environment.capabilities(ctx);\n return offer[Capability.Shell] == null ? [] : [RuntimeKind.Process];\n};\n\n// Erased form a host stores in its provider registry.\nexport type AnySandboxProviderIface = SandboxProviderIface<\n JsonValue,\n JsonValue,\n JsonValue,\n NetworkSandboxSessionIface\n>;\n\n// Events emitted through a sandbox provider's process lifecycle.\nexport enum SandboxEventKind {\n ProcessExited = 'process_exited',\n}\n"],
5
- "mappings": "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",
6
- "names": ["SandboxEntryType", "SandboxWorkerEndpointTransport", "PortProtocol", "SandboxCapability", "SandboxEventKind"]
4
+ "sourcesContent": ["import { Capability, RuntimeKind, type CapabilityAccess } from '@finalai/agent-protocol';\nimport * as z from 'zod';\nimport { SandboxEntryType } from \"./file-kind.mjs\";\nexport { SandboxEntryType } from \"./file-kind.mjs\";\nimport { createSandboxHandle, type SandboxExecutionPolicyIface } from \"./handle.mjs\";\nimport { withSandboxOverrides } from \"./overrides.mjs\";\nimport { NetworkPolicy, type NetworkPolicyIface } from '@finalai/agent-protocol/network-policy';\nexport { NetworkPolicy, type NetworkPolicyIface } from '@finalai/agent-protocol/network-policy';\nimport type {\n ProcessInspectionRequestIface,\n ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nimport type { JsonValue } from \"../json.mjs\";\nimport type { ToolDescriptorIface } from \"../tool-descriptor.mjs\";\nimport {\n SandboxEditorOperation,\n type SandboxEditorRequestIface,\n type SandboxEditorResultIface,\n} from \"./editor.mjs\";\nimport { SandboxExecutionOperation } from \"./execution-guard.mjs\";\nimport type { SandboxSetupIface } from \"./setup/schema.mjs\";\nimport type { SandboxSnapshotRequestIface, SandboxSnapshotResponseIface } from \"./snapshots.mjs\";\n\n// Sandbox providers and consumers share the streaming session contract.\n\nexport interface AbortableIface {\n abortSignal?: AbortSignal;\n}\n\nexport interface SandboxProcessOptionsIface extends AbortableIface {\n command: string;\n args?: string[];\n cwd?: string;\n env?: Record<string, string>;\n // Run through the sandbox's login shell (`bash -lc`) instead of exec'ing.\n shell?: boolean;\n stdin?: ReadableStream<Uint8Array> | string;\n timeoutMs?: number;\n // Spawn only (`run` ignores it): ask for a durable process on a sandbox with\n // SandboxCapability.DurableProcesses; ignored elsewhere (the handle's `ref`\n // is then null). A durable process ends only on its own exit, `kill`,\n // `timeoutMs` (enforced inside the sandbox, not by a provider-side timer) or\n // sandbox stop/destroy. Dropping its handle (connection close, runtime\n // shutdown, `abortSignal`) detaches without killing: the handle's streams\n // fail and `wait` rejects, and `attachProcess` finds the process again.\n durable?: boolean;\n}\n\nexport interface SandboxProcessIface {\n readonly pid: string | null;\n // Opaque, provider-encoded (versioned) reference for `attachProcess`; non-null\n // only for a durable process on a sandbox with durable processes. Optional so\n // implementations without them need not set it.\n readonly ref?: string | null;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n // Writes to the process's stdin; closes stdin when `end` is true.\n write(data: Uint8Array | string, options?: { end?: boolean }): Promise<void>;\n wait(): Promise<{ exitCode: number }>;\n kill(signal?: string): Promise<void>;\n}\n\n// A program built for the sandbox's worker runtime, started for one harness\n// session. Its handle is a process's: what is written to it is its input\n// stream, stdout its output stream, stderr its diagnostics.\nexport interface SandboxWorkerOptionsIface extends AbortableIface {\n program: string;\n env?: Record<string, string>;\n // Handed to the program when it starts.\n input?: JsonValue;\n // As for spawn: survives the handle on a sandbox with durable processes.\n durable?: boolean;\n // A platform-identity assertion for the program's run (variant `harness-run`),\n // for a runtime that authenticates the programs it starts.\n identity?: string;\n}\n\nexport enum SandboxWorkerEndpointTransport {\n Ws = 'ws',\n Http = 'http',\n Relay = 'relay',\n}\n\n// Where a started worker program serves its stream itself, for the caller to\n// dial directly: an ACP endpoint by URL, or a relay channel.\nexport type SandboxWorkerEndpointType =\n | {\n transport: SandboxWorkerEndpointTransport.Ws | SandboxWorkerEndpointTransport.Http;\n url: string;\n headers: Record<string, string>;\n }\n | { transport: SandboxWorkerEndpointTransport.Relay; channel: string; token: string };\n\nexport interface SandboxWorkerEndpointIface {\n readonly endpoint: SandboxWorkerEndpointType;\n}\n\n// A started worker program: a process whose streams carry its stream, or an\n// endpoint it serves.\nexport type SandboxWorkerStartType = SandboxProcessIface | SandboxWorkerEndpointIface;\n\nexport const isSandboxWorkerEndpoint = (\n started: SandboxWorkerStartType,\n): started is SandboxWorkerEndpointIface => 'endpoint' in started;\n\nexport interface SandboxAttachProcessOptionsIface extends AbortableIface {\n ref: string;\n // Bytes of each stream the caller already has; output resumes there.\n stdoutOffset: number;\n stderrOffset: number;\n}\n\n// A durable process found again by its ref. Its output is read from the\n// provider, which is the source of truth for output and exit; aborting\n// `abortSignal` detaches this handle as it does a spawned durable one.\n//\n// Limitation: stdin belongs to the spawning handle only. A re-attached\n// process can be watched, waited for and killed, but not written to; a process\n// that needs input after a re-attach must read it from somewhere else (a file).\nexport interface SandboxAttachedProcessIface {\n readonly ref: string;\n // Where the streams actually start: the requested offsets, or later when the\n // provider no longer retains the earlier bytes (see each provider's retention).\n readonly stdoutOffset: number;\n readonly stderrOffset: number;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n wait(): Promise<{ exitCode: number }>;\n kill(signal?: string): Promise<void>;\n}\n\nexport interface SandboxRunResultIface {\n exitCode: number;\n stdout: string;\n stderr: string;\n}\n\nexport interface StatIface {\n path: string;\n type: SandboxEntryType;\n size: number;\n modifiedAt: string | null;\n mode: number | null;\n}\n\nexport interface DirEntryIface {\n name: string;\n path: string;\n type: SandboxEntryType;\n size: number | null;\n}\n\nexport interface ConfinedSandboxFilesIface {\n readFile(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n stat(options: { path: string; root: string } & AbortableIface): Promise<StatIface | null>;\n readDir(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<DirEntryIface[] | null>;\n}\n\nexport interface SandboxSessionIface {\n readonly description: string;\n readonly confinedFileReader?: ConfinedSandboxFilesIface;\n // On the RPC surface, root confines viewer reads to this directory, rejects\n // symlink ancestors and requires Python 3 in the sandbox (confinedFiles feature).\n readFile(\n options: { path: string; root?: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n readBinaryFile(options: { path: string } & AbortableIface): Promise<Uint8Array | null>;\n readTextFile(\n options: {\n path: string;\n encoding?: string;\n startLine?: number;\n endLine?: number;\n } & AbortableIface,\n ): Promise<string | null>;\n writeFile(\n options: { path: string; content: ReadableStream<Uint8Array> } & AbortableIface,\n ): Promise<void>;\n writeBinaryFile(options: { path: string; content: Uint8Array } & AbortableIface): Promise<void>;\n // Writes create missing parent directories.\n writeTextFile(\n options: { path: string; content: string; encoding?: string } & AbortableIface,\n ): Promise<void>;\n spawn(options: SandboxProcessOptionsIface): Promise<SandboxProcessIface>;\n // Present on sandboxes with durable processes. Null when the process is\n // unknown: the sandbox restarted or was deleted, or the ref expired, is\n // malformed or belongs to another sandbox. Attaching after the process\n // exited still yields its retained output and exit code.\n attachProcess?(\n options: SandboxAttachProcessOptionsIface,\n ): Promise<SandboxAttachedProcessIface | null>;\n run(options: SandboxProcessOptionsIface): Promise<SandboxRunResultIface>;\n stat(options: { path: string; root?: string } & AbortableIface): Promise<StatIface | null>;\n readDir(options: { path: string; root?: string } & AbortableIface): Promise<DirEntryIface[]>;\n resolvePath(path: string): string;\n removePath(\n options: { path: string; recursive?: boolean; force?: boolean } & AbortableIface,\n ): Promise<void>;\n}\n\nexport enum PortProtocol {\n Http = 'http',\n Https = 'https',\n Ws = 'ws',\n}\n\n// An MCP transport the sandbox serves for an optional capability: an HTTP MCP\n// endpoint the harness (or the host) can dial.\nexport interface McpEndpointIface {\n name: string;\n url: string;\n headers: Record<string, string>;\n}\n\n// A JSON-RPC message channel to an MCP server the sandbox hosts, for backends\n// whose API reaches it some other way than HTTP MCP (a byte pipe, a socket).\n// Messages are JSON-RPC objects, in order.\nexport interface McpChannelIface {\n send(message: JsonValue, options?: AbortableIface): Promise<void>;\n // The messages that arrived since the last call; [] when none did.\n receive(options?: AbortableIface): Promise<JsonValue[]>;\n close(): Promise<void>;\n}\n\n// An MCP server the sandbox hosts, opened in process by whoever runs the handle.\n// It cannot cross the handle RPC wire.\nexport interface McpChannelEndpointIface {\n name: string;\n connect(options?: AbortableIface): Promise<McpChannelIface>;\n}\n\nexport type SandboxMcpEndpoint = McpEndpointIface | McpChannelEndpointIface;\n\n// The tools of a sandbox's hosted MCP servers, as far as they are known without\n// starting it. Null: unknown until the sandbox is attached and asked.\nexport interface SandboxMcpCatalogIface {\n computerUse: ToolDescriptorIface[] | null;\n // Local MCP server name \u2192 its tools.\n localMcp: Record<string, ToolDescriptorIface[]> | null;\n // Partial discovery retains known tools and must be retried, including after caching.\n localMcpIncomplete?: boolean;\n}\n\nexport const isMcpChannelEndpoint = (\n endpoint: SandboxMcpEndpoint,\n): endpoint is McpChannelEndpointIface => 'connect' in endpoint;\n\nexport interface ScreenOptionsIface {\n // View-only by default; explicit input control requires execute access.\n viewOnly?: boolean;\n}\n\nexport interface ScreenSessionIface {\n // A short-lived viewer grant; providers enforce the requested input access.\n url: string;\n token: string;\n expiresAt: string;\n}\n\nexport interface NetworkSandboxSessionIface extends SandboxSessionIface {\n readonly id: string;\n readonly defaultWorkingDirectory: string;\n readonly ports: readonly number[];\n getPortEndpoint(options: {\n port: number;\n protocol?: PortProtocol;\n }): Promise<{ url: string; headers?: Record<string, string> }>;\n getPortUrl(options: { port: number; protocol?: PortProtocol }): Promise<string>;\n stop(): Promise<void>;\n destroy(): Promise<void>;\n setNetworkPolicy?(policy: NetworkPolicyIface): Promise<void>;\n computerUse?(): Promise<SandboxMcpEndpoint>;\n // Present on sandboxes whose provider offers RuntimeKind.Worker.\n startWorker?(options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType>;\n screen?(options?: ScreenOptionsIface): Promise<ScreenSessionIface>;\n localMcp?(): Promise<SandboxMcpEndpoint[]>;\n}\n\n// Features a live sandbox handle advertises over the handle RPC (`describe`).\n// Finer than the model's capabilities (`Capability`): `files` is served by the\n// file methods, `shell` by processes and ports, `computerUse` by computer use\n// and the screen; the rest are handle extensions a capability may use.\nexport enum SandboxCapability {\n Files = 'files',\n Process = 'process',\n Ports = 'ports',\n NetworkPolicy = 'networkPolicy',\n ComputerUse = 'computerUse',\n Screen = 'screen',\n LocalMcp = 'localMcp',\n Browser = 'browser',\n // `spawn({ durable: true })` and `attachProcess` (see SandboxProcessOptionsIface.durable).\n DurableProcesses = 'durableProcesses',\n // `startWorker`: the sandbox runs worker programs.\n Workers = 'workers',\n}\n\n// The capabilities a provider's sandboxes serve, each with the most access a\n// session can be granted on it. A capability left out is not served.\nexport type SandboxCapabilityOffer = Partial<Record<Capability, CapabilityAccess>>;\n\nexport interface SandboxProviderHandleIface<S extends SandboxSessionIface> {\n readonly sandbox: S;\n // Pending policy; the generic handle constructor consumes it before exposing execution.\n readonly executionPolicy?: SandboxExecutionPolicyIface;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n}\n\n// The person a sandbox acts for on this call: the author of the running turn,\n// else whoever opened the sandbox's viewer. Null when it acts for no person\n// (an unprompted turn, a preparation). Read on each call: it changes between\n// turns and between callers.\nexport interface SandboxActingUserIface {\n current(): Promise<string | null>;\n}\n\nexport const noSandboxActingUser: SandboxActingUserIface = { current: async () => null };\n\n// Credentials the host supplies to a provider. A provider reads no secrets of\n// its own and names no project: it gets the value of the secret its\n// environment's `credential.secretRef` names, resolved in the sandbox's project.\nexport interface SandboxCredentialsIface {\n secret(args: { secretRef: string }): Promise<string | null>;\n}\n\nexport const noSandboxCredentials: SandboxCredentialsIface = { secret: async () => null };\n\n// A provider's credential by reference, in its environment options: the name\n// of a project secret, never its value.\nexport const sandboxCredentialRefSchema = z.strictObject({\n secretRef: z.string().min(1).max(256),\n});\n\nexport type SandboxCredentialRefIface = z.infer<typeof sandboxCredentialRefSchema>;\n\n// A platform-identity assertion (`@finalai/agent-protocol/identity`) for one\n// backend audience, valid until `expiresAt`.\nexport interface SandboxIdentityTokenIface {\n token: string;\n expiresAt: string;\n}\n\n// How a provider authenticates to a backend it needs (its vendor's API): an\n// assertion for `audience`, which the platform issues only for audiences the\n// provider's registration was granted. It names the sandbox's organization,\n// project and sandbox, and the acting user at the time it was issued. Ask\n// before each backend call (hosts cache it); `refresh` asks for a new one\n// after the backend rejected the last.\nexport type SandboxIdentityFn = (args: {\n audience: string;\n refresh?: boolean;\n}) => Promise<SandboxIdentityTokenIface>;\n\nexport const noSandboxIdentity: SandboxIdentityFn = async ({ audience }) => {\n throw new Error(`no identity was granted for ${audience}`);\n};\n\n// What every provider call is given: the project the sandbox belongs to, the\n// host's credentials and the provider's identity for the backends it was\n// granted.\nexport interface SandboxProviderContextIface {\n organizationId: string;\n projectId: string;\n credentials: SandboxCredentialsIface;\n actingUser: SandboxActingUserIface;\n identity: SandboxIdentityFn;\n log?: (message: string, fields?: Record<string, string | number | boolean | null>) => void;\n}\n\n// How the platform runs a sandbox's lifecycle, for the provider to align its\n// backend with: after `parkAfterIdleMs` of idleness the platform parks the\n// sandbox (null: the provider's own default), so a backend idle timeout\n// should be longer.\nexport interface SandboxLifecycleIface {\n parkAfterIdleMs: number | null;\n}\n\n// What reads that start nothing are given (capabilities, catalogs, snapshots,\n// process inspection, the editor). `sandboxId` is set for reads about an\n// existing sandbox.\nexport interface SandboxOfferContextIface extends SandboxProviderContextIface {\n sandboxId?: string;\n executionPolicy?: SandboxExecutionPolicyIface;\n platformNetworkPolicy?: (policy: NetworkPolicyIface) => Promise<void>;\n // Retain platform transport access when an extension restores an allowlist.\n platformEgressHosts?: string[];\n}\n\n// Scoped by the host to this project and provider. Providers can retain\n// reusable intermediate artifacts independently of a sandbox's seed files.\nexport interface SandboxArtifactsIface {\n get(key: string): Promise<JsonValue | null>;\n put(key: string, artifact: JsonValue): Promise<void>;\n}\n\nexport interface SandboxPreparationSourceIface {\n sourceRevision: string;\n read(): Promise<{ files: Record<string, string>; resources: Record<string, JsonValue> }>;\n}\n\n// A preparation builds what an environment's sandboxes start from (an image\n// built into a base, a snapshot). It depends on the environment's options and\n// the seed files only, never on a sandbox setup.\nexport interface SandboxPrepareContextIface extends SandboxProviderContextIface {\n // A host-persisted resource source; artifacts may retain its identity instead of seed contents.\n preparation?: SandboxPreparationSourceIface;\n artifacts?: SandboxArtifactsIface;\n // Workspace-relative seed files and named resources.\n files: Record<string, string>;\n resources: Record<string, JsonValue>;\n sourceRevision: string;\n storagePath: string;\n}\n\n// What a provider is given for one sandbox: its create, attach, detach, park\n// and delete calls.\nexport interface SandboxResourceContextIface extends SandboxProviderContextIface {\n // The platform's id for the sandbox, stable for its whole life.\n sandboxId: string;\n lifecycle: SandboxLifecycleIface;\n // Host policy composes before the provider's policy, on every exposed execution path.\n executionPolicy?: SandboxExecutionPolicyIface;\n preparation?: SandboxPreparationSourceIface;\n storagePath: string;\n // Variables the platform sets in every process of this sandbox: the egress\n // proxy, trust for its CA, one placeholder per bound secret and the sandbox\n // setup's variables. Evaluated again for every spawn/run, never once per\n // attach: a secret bound later must reach the next command. May resolve to\n // {}. Platform values override the environment's own.\n platformEnvironment?: () => Promise<Record<string, string>>;\n // Hosts the sandbox must be able to reach for the proxy to work, appended\n // to any allowlist network policy.\n platformEgressHosts?: string[];\n // Reports the network policy now in force, exactly as the provider applied\n // it to its backend (after withPlatformEgressHosts); the platform permits\n // only those destinations. Called on every attach after awaitRunning and\n // before platformFiles or any command; never for a session's own\n // setNetworkPolicy. A rejection fails the attach.\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>;\n // Files the platform needs before any command runs: written right after the\n // sandbox is running, on every attach. Paths are absolute; missing parent\n // directories are created.\n platformFiles?: () => Promise<Record<string, string>>;\n}\n\n// The variables `platformEnvironment` owns. An environment that sets one is\n// refused at create.\nexport const PLATFORM_ENVIRONMENT_NAMES: ReadonlySet<string> = new Set([\n 'HTTPS_PROXY',\n 'HTTP_PROXY',\n 'NO_PROXY',\n 'NODE_USE_ENV_PROXY',\n 'SSL_CERT_FILE',\n 'CURL_CA_BUNDLE',\n 'REQUESTS_CA_BUNDLE',\n 'GIT_SSL_CAINFO',\n 'CARGO_HTTP_CAINFO',\n 'DENO_CERT',\n 'NODE_EXTRA_CA_CERTS',\n 'FINAL_EGRESS_URL',\n 'FINAL_EGRESS_TOKEN',\n]);\n\n// A process's base environment: the environment's variables under the\n// platform's, read again on every call.\nexport const platformProcessEnvironment =\n (\n ctx: Pick<SandboxResourceContextIface, 'platformEnvironment'>,\n specEnv: Record<string, string>,\n ): (() => Promise<Record<string, string>>) =>\n async () => ({ ...specEnv, ...(await ctx.platformEnvironment?.()) });\n\n// Writes `platformFiles` into a sandbox that is now running, before it runs anything.\n// Relies on writeTextFile creating missing parent directories.\nexport const writePlatformFiles = async (\n ctx: Pick<SandboxResourceContextIface, 'platformFiles'>,\n sandbox: Pick<SandboxSessionIface, 'writeTextFile'>,\n): Promise<void> => {\n for (const [path, content] of Object.entries((await ctx.platformFiles?.()) ?? {}))\n await sandbox.writeTextFile({ path, content });\n};\n\n// Reports the policy a provider just applied to its backend: `allow` only for an\n// allowlist, its entries (hosts, `*.suffix` patterns, CIDRs) unchanged.\nexport const reportPlatformNetworkPolicy = async (\n ctx: Pick<SandboxResourceContextIface, 'platformNetworkPolicy'>,\n policy: NetworkPolicyIface,\n): Promise<void> =>\n ctx.platformNetworkPolicy(\n policy.mode === NetworkPolicy.Allowlist\n ? { mode: policy.mode, allow: [...(policy.allow ?? [])] }\n : { mode: policy.mode },\n );\n\n// An allowlist policy with the platform's egress hosts appended; any other\n// policy unchanged.\nexport const withPlatformEgressHosts = (\n ctx: Pick<SandboxResourceContextIface, 'platformEgressHosts'>,\n policy: NetworkPolicyIface,\n): NetworkPolicyIface => {\n const hosts = ctx.platformEgressHosts ?? [];\n if (policy.mode !== NetworkPolicy.Allowlist || hosts.length === 0) return policy;\n return { ...policy, allow: [...new Set([...(policy.allow ?? []), ...hosts])] };\n};\n\n// One attach of a sandbox: the live handle, and what the attach lost, so the\n// platform knows which phases of the sandbox setup to redo.\nexport interface SandboxAttachmentIface<\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n handle: SandboxProviderHandleIface<S>;\n // The state to keep for the next call (a resumed backend may change ids).\n state: State;\n // The disk is new: nothing written by a setup, the workspace seeds or a\n // session survives on it (first attach, or a backend that lost it).\n fresh: boolean;\n // The machine started on this attach: no process from before is running.\n booted: boolean;\n // Where the backend runs the sandbox (its own region name), so the host can\n // place the harness near it; null when unknown.\n region?: string | null;\n}\n\n// One environment of a provider, as the host drives it. A sandbox is a\n// resource the platform owns: `create` makes it (nothing need boot), `attach`\n// makes it reachable for a while, `detach` lets it go idle, `park` makes it as\n// cheap as the provider can while keeping its disk, `delete` destroys it.\n//\n// Order on attach: attach (boot or resume) \u2192 awaitRunning \u2192\n// platformNetworkPolicy \u2192 platformFiles \u2192 handle; the platform then applies\n// the sandbox setup through the handle (./setup). A provider never runs a\n// setup's steps itself.\nexport interface SandboxEnvironmentImplementationIface<\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n // The capabilities this environment's sandboxes serve and the most access\n // each grants, known without creating one.\n capabilities(ctx: SandboxOfferContextIface): Promise<SandboxCapabilityOffer>;\n // What a harness can run in this environment's sandboxes: processes, worker\n // programs (`startWorker`), or both. Absent: processes when it offers `shell`.\n runtimes?(ctx: SandboxOfferContextIface): Promise<RuntimeKind[]>;\n // Handle features this environment's sandboxes advertise, read before\n // anything starts. Absent or null: unknown until attached; local MCP is then\n // not projected.\n features?(ctx: SandboxOfferContextIface): Promise<SandboxCapability[] | null>;\n // Known positive features when the rest of the pre-attach set is unknown.\n additionalFeatures?(ctx: SandboxOfferContextIface): Promise<SandboxCapability[]>;\n // The hosted MCP servers' tool catalogs the backend can give without\n // attaching, so the MCP projection lists them from the first `tools/list`.\n // A catalog left unknown can only be learned from a live sandbox, so the\n // first `tools/list` that finds it unknown attaches in the background.\n mcpCatalog?(ctx: SandboxOfferContextIface): Promise<SandboxMcpCatalogIface | null>;\n // Reads committed files without attaching. Null means the backend is live\n // or offers no snapshot. An unavailable sleeping snapshot must throw, never\n // fall through to a read that wakes it. Pin later ranges by snapshotId.\n readSnapshot?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxSnapshotRequestIface,\n ): Promise<SandboxSnapshotResponseIface | null>;\n // Inspect retained backend processes without attaching or extending a sandbox.\n // Stopping one requires shell access; the provider also enforces backend ownership.\n processes?(\n ctx: SandboxOfferContextIface & { sandboxId: string },\n state: State,\n request: ProcessInspectionRequestIface,\n ): Promise<ProcessInspectionResultIface>;\n // Browser editor for an existing sandbox. The host checks write\n // authorization; this hook never creates or wakes a backend. Credentials stay\n // in the authentication form, never the editor URL or stored provider state.\n editor?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxEditorRequestIface,\n ): Promise<SandboxEditorResultIface>;\n // Content-addressed by `artifactKey`; the host caches artifacts and calls\n // prepare only on a miss.\n artifactKey(ctx: SandboxPrepareContextIface): Promise<string>;\n prepare(ctx: SandboxPrepareContextIface): Promise<Artifact>;\n // Makes the sandbox's backend resource. The setup is given so the\n // provider enforces its network policy from the first boot (or refuses);\n // its repositories, steps and services are applied by the platform.\n create(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; setup: SandboxSetupIface | null },\n ): Promise<{ state: State; region?: string | null }>;\n // Resolves once the backend named by `state` is running and will accept a\n // command or a file write; rejects with a clear error after `timeoutMs`.\n // The provider chooses the readiness signal and backoff; the platform never\n // polls a backend itself.\n awaitRunning(\n ctx: SandboxResourceContextIface,\n state: State,\n options: { timeoutMs: number },\n ): Promise<void>;\n // Boots or resumes the sandbox and returns a live handle.\n attach(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; state: State },\n ): Promise<SandboxAttachmentIface<State, S>>;\n // Reconnects to an already running backend for a read-only viewer: never\n // boots, creates, seeds or restarts anything. Absent: viewers use a live\n // handle or nothing.\n attachPassive?(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; state: State },\n ): Promise<SandboxProviderHandleIface<S>>;\n // The host is done with its handle for now; the sandbox may go idle on the\n // provider's own policy. Returns the state the next attach needs.\n detach(ctx: SandboxResourceContextIface, args: { state: State }): Promise<State>;\n // Pauses or stops the sandbox, keeping its disk. Returns the state the next attach needs.\n park(\n ctx: SandboxResourceContextIface,\n args: { artifact: Artifact; state: State },\n ): Promise<State>;\n // Destroys the backend resource and its disk. Deleting one already gone succeeds.\n delete(ctx: SandboxResourceContextIface, args: { state: State }): Promise<void>;\n}\n\nexport interface SandboxProviderDefinitionIface<\n EnvOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n name: string;\n // The version of `State`'s shape. The host records it with each sandbox and\n // refuses to attach a state written under another version.\n stateProtocolVersion?: number;\n // Validates the options and returns the environment they describe.\n environment(options?: EnvOptions): SandboxEnvironmentImplementationIface<Artifact, State, S>;\n}\n\n// What `project.sandboxes.create(environment, \u2026)` takes: a provider by name\n// and that provider's own environment options, as plain data.\nexport interface SandboxEnvironmentValueIface<EnvOptions = JsonValue> {\n provider: string;\n environment: EnvOptions;\n}\n\n// A defined provider: the definition the host drives, and `environment(opts)`\n// returning the plain value a caller creates sandboxes from.\nexport interface SandboxProviderIface<\n EnvOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n readonly definition: SandboxProviderDefinitionIface<EnvOptions, Artifact, State, S>;\n readonly name: string;\n environment(options: EnvOptions): SandboxEnvironmentValueIface<EnvOptions>;\n}\n\nexport const defineSandboxProvider = <\n EnvOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n>(\n definition: SandboxProviderDefinitionIface<EnvOptions, Artifact, State, S>,\n): SandboxProviderIface<EnvOptions, Artifact, State, S> => ({\n definition: withSandboxOverrides(definition, {\n environment: (options?: EnvOptions) => {\n const implementation = definition.environment(options);\n for (const method of [\n 'create',\n 'attach',\n 'detach',\n 'park',\n 'delete',\n 'awaitRunning',\n ] as const)\n if (typeof implementation[method] !== 'function')\n throw new Error(`sandbox provider ${definition.name} does not implement ${method}`);\n const overrides: Partial<typeof implementation> = {\n attach: async (ctx, args) => {\n const attached = await implementation.attach(ctx, args);\n return {\n ...attached,\n handle: createSandboxHandle({\n handle: attached.handle,\n executionPolicy: ctx.executionPolicy,\n }),\n };\n },\n };\n if (implementation.editor != null) {\n const editor = implementation.editor.bind(implementation);\n overrides.editor = async (ctx, state, request) => {\n if (\n request.operation === SandboxEditorOperation.Open ||\n request.operation === SandboxEditorOperation.Refresh\n )\n await ctx.executionPolicy?.beforeExecution({\n operation: SandboxExecutionOperation.Editor,\n background: false,\n });\n return editor(ctx, state, request);\n };\n }\n if (implementation.attachPassive != null) {\n const attachPassive = implementation.attachPassive.bind(implementation);\n overrides.attachPassive = async (ctx, args) =>\n createSandboxHandle({\n handle: await attachPassive(ctx, args),\n executionPolicy: ctx.executionPolicy,\n });\n }\n return withSandboxOverrides(implementation, overrides);\n },\n }),\n name: definition.name,\n environment: (options) => ({ provider: definition.name, environment: options }),\n});\n\n// The runtime kinds an environment declares, or its default.\nexport const sandboxRuntimesOf = async (\n environment: Pick<\n SandboxEnvironmentImplementationIface<JsonValue, JsonValue, NetworkSandboxSessionIface>,\n 'capabilities' | 'runtimes'\n >,\n ctx: SandboxOfferContextIface,\n): Promise<RuntimeKind[]> => {\n if (environment.runtimes != null) return environment.runtimes(ctx);\n const offer = await environment.capabilities(ctx);\n return offer[Capability.Shell] == null ? [] : [RuntimeKind.Process];\n};\n\n// Erased form a host stores in its provider registry.\nexport type AnySandboxProviderIface = SandboxProviderIface<\n JsonValue,\n JsonValue,\n JsonValue,\n NetworkSandboxSessionIface\n>;\n\n// Events emitted through a sandbox provider's process lifecycle.\nexport enum SandboxEventKind {\n ProcessExited = 'process_exited',\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["SandboxEntryType", "NetworkPolicy", "SandboxWorkerEndpointTransport", "PortProtocol", "SandboxCapability", "SandboxEventKind"]
7
7
  }