@finalai/agent-provider 0.2.2 → 0.4.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 (60) hide show
  1. package/README.md +61 -0
  2. package/dist/modules/sandbox/client.mjs +3 -0
  3. package/dist/modules/sandbox/client.mjs.map +2 -2
  4. package/dist/modules/sandbox/confined-files.d.mts +2 -2
  5. package/dist/modules/sandbox/confined-files.mjs +5 -2
  6. package/dist/modules/sandbox/confined-files.mjs.map +2 -2
  7. package/dist/modules/sandbox/execution-guard.d.mts +36 -0
  8. package/dist/modules/sandbox/execution-guard.mjs +322 -0
  9. package/dist/modules/sandbox/execution-guard.mjs.map +7 -0
  10. package/dist/modules/sandbox/file-kind.d.mts +6 -0
  11. package/dist/modules/sandbox/file-kind.mjs +11 -0
  12. package/dist/modules/sandbox/file-kind.mjs.map +7 -0
  13. package/dist/modules/sandbox/file-schemas.d.mts +15 -0
  14. package/dist/modules/sandbox/file-schemas.mjs +22 -0
  15. package/dist/modules/sandbox/file-schemas.mjs.map +7 -0
  16. package/dist/modules/sandbox/handle.d.mts +15 -0
  17. package/dist/modules/sandbox/handle.mjs +47 -0
  18. package/dist/modules/sandbox/handle.mjs.map +7 -0
  19. package/dist/modules/sandbox/index.d.mts +8 -0
  20. package/dist/modules/sandbox/index.mjs +30 -1
  21. package/dist/modules/sandbox/index.mjs.map +2 -2
  22. package/dist/modules/sandbox/mcp-channel.d.mts +8 -1
  23. package/dist/modules/sandbox/mcp-channel.mjs +217 -15
  24. package/dist/modules/sandbox/mcp-channel.mjs.map +3 -3
  25. package/dist/modules/sandbox/mcp-hosted-marker.d.mts +3 -0
  26. package/dist/modules/sandbox/mcp-hosted-marker.mjs +10 -0
  27. package/dist/modules/sandbox/mcp-hosted-marker.mjs.map +7 -0
  28. package/dist/modules/sandbox/mcp-hosted.d.mts +6 -1
  29. package/dist/modules/sandbox/mcp-hosted.mjs +127 -41
  30. package/dist/modules/sandbox/mcp-hosted.mjs.map +2 -2
  31. package/dist/modules/sandbox/mcp-shell.mjs +14 -4
  32. package/dist/modules/sandbox/mcp-shell.mjs.map +2 -2
  33. package/dist/modules/sandbox/mcp.d.mts +5 -2
  34. package/dist/modules/sandbox/mcp.mjs +102 -27
  35. package/dist/modules/sandbox/mcp.mjs.map +2 -2
  36. package/dist/modules/sandbox/networking.d.mts +73 -0
  37. package/dist/modules/sandbox/networking.mjs +149 -0
  38. package/dist/modules/sandbox/networking.mjs.map +7 -0
  39. package/dist/modules/sandbox/overrides.d.mts +2 -0
  40. package/dist/modules/sandbox/overrides.mjs +44 -0
  41. package/dist/modules/sandbox/overrides.mjs.map +7 -0
  42. package/dist/modules/sandbox/server.d.mts +1 -0
  43. package/dist/modules/sandbox/server.mjs +38 -2
  44. package/dist/modules/sandbox/server.mjs.map +2 -2
  45. package/dist/modules/sandbox/testing.d.mts +1 -0
  46. package/dist/modules/sandbox/testing.mjs +1 -0
  47. package/dist/modules/sandbox/testing.mjs.map +2 -2
  48. package/dist/modules/sandbox/tool-policy.d.mts +5 -0
  49. package/dist/modules/sandbox/tool-policy.mjs +62 -0
  50. package/dist/modules/sandbox/tool-policy.mjs.map +7 -0
  51. package/dist/modules/sandbox/types.d.mts +17 -16
  52. package/dist/modules/sandbox/types.mjs +54 -23
  53. package/dist/modules/sandbox/types.mjs.map +3 -3
  54. package/dist/modules/sandbox/wire.d.mts +23 -18
  55. package/dist/modules/sandbox/wire.mjs +21 -20
  56. package/dist/modules/sandbox/wire.mjs.map +3 -3
  57. package/dist/modules/sandbox/workspace-identity.d.mts +5 -0
  58. package/dist/modules/sandbox/workspace-identity.mjs +14 -0
  59. package/dist/modules/sandbox/workspace-identity.mjs.map +7 -0
  60. package/package.json +3 -3
package/README.md CHANGED
@@ -3,6 +3,24 @@
3
3
  Contracts for custom harnesses, sandboxes, channels, and credential policies, plus
4
4
  RPC/MCP projections and conformance tools for integration authors.
5
5
 
6
+ Sandbox networking is a composable extension. `SandboxNetworkingExtensionIface`
7
+ owns policy persistence, controller setup, readiness and suspension; the sandbox
8
+ provider supplies its Linux executor and provider firewall/lifecycle operations.
9
+ `attachSandboxNetworking` installs an extension on a handle and defers workspace
10
+ setup until admission succeeds. `withSandboxNetworking` supports providers that
11
+ need to initialize the controller earlier. Both preserve host/provider execution
12
+ policies and distinguish runtime detach from physical stop/delete. Reads and
13
+ passive attachments never recover networking. A running handle can remain blocked
14
+ for execution while its networking configuration is repaired.
15
+
16
+ Validate extension workspace identities before changing provider policy. Save the
17
+ original policy before fencing or booting, initialize the controller in the same
18
+ namespace used by commands, then restore the outer policy through `afterGuard`.
19
+ The extension must authorize every ongoing operation, including cached MCP access;
20
+ a one-time startup check is insufficient. Custom `attach` implementations own
21
+ equivalent admission, deferred setup and failure cleanup. Namespace-only adapters
22
+ must disclose the startup traffic window when their provider cannot fence boot.
23
+
6
24
  Implement the public provider interfaces and use `/conformance` to exercise them.
7
25
  Use leaf entrypoints for sandbox wire clients, servers, MCP adapters, and local
8
26
  channel sockets. These helpers adapt your integration to the provider contracts.
@@ -10,3 +28,46 @@ channel sockets. These helpers adapt your integration to the provider contracts.
10
28
  `/conformance` provides harness and sandbox checks, profiles, and a reference harness.
11
29
  `/conformance/scripted-model` provides deterministic model handlers for exercising
12
30
  your integration. The `final-agents conformance` CLI runs the harness checks.
31
+
32
+ Declare `executionPolicy: { beforeExecution }` on a provider handle, or supply it
33
+ in `SandboxStartContextIface` from the host. `defineSandboxProvider` automatically
34
+ applies both policies to handles returned by start, resume and passive recovery;
35
+ the host policy runs first. Construction consumes the policy declaration so later
36
+ composition does not reinstall it. Providers do not need to wrap execution methods.
37
+ An ordinary provider without either policy retains its existing behavior.
38
+
39
+ Admission covers commands, process stdin, file mutations, network-policy updates,
40
+ screen acquisition and cached MCP channels. The callback receives the operation
41
+ and a `background` flag for protocol maintenance; the flag is not an authorization
42
+ grant. Reads and lifecycle cleanup remain available when execution is refused.
43
+ Hosts must explicitly authorize SetNetworkPolicy and Egress operations to allow
44
+ network repair while other execution is refused. Policies choose authorization; the generic SDK implements no Device
45
+ or tunnel policy. Already-running processes and port grants need separate controls.
46
+
47
+ Keep the raw session internal for trusted setup/controller work. Low-level hosts
48
+ that construct handles without `defineSandboxProvider` use `createSandboxHandle`.
49
+ `mapSandboxHandle` preserves admission when narrowing or decorating an existing handle,
50
+ including replacement executors. Its mapping callback is trusted structural composition: it receives raw methods to avoid duplicate admission on delegation. Expose only the returned handle to consumers. `withSandboxExecutionGuard` remains available as the underlying composable adapter.
51
+ Custom execution capabilities must invoke admission themselves; the SDK only
52
+ intercepts the standard sandbox operations. Policies must not invoke guarded
53
+ execution recursively.
54
+
55
+ Streamed stdin is checked before every chunk, including EOF because it can execute buffered input. After a refused or failed stdin write, later writes are refused until the process is restarted, preventing fragments from joining across a dropped chunk. Killing a process and closing its transport remain available after denial. A policy may supply `fetch` for
56
+ URL-backed MCP endpoints served through a host-owned transport; the provider's fetch
57
+ retains ownership of its endpoints, with the host transport as a fallback. Pass the same transport to the MCP projection.
58
+
59
+ Pass the complete keys from `sandboxMcpToolPolicyKeys` to `resolveSandboxToolPolicy`.
60
+ Egress consent requires its canonical capability/action keys; arbitrary hosted
61
+ tools can use the same display name and must retain their ordinary tool policy.
62
+ When the builtin egress capability is exposed, conflicting hosted names are prefixed rather than hidden. Configure/Disable preauthorization requires its exact action key; a legacy hosted-tool `egress: Allow` cannot waive consent. Read bindings cannot change network policy, including with lifecycle authority. Handle RPC
63
+ hosts must supply `authorizeOperation` for Configure/Disable; without it mutations
64
+ are refused. The host owns approval policy, including any explicit preauthorization.
65
+
66
+ Policies turn URL-backed MCP into checked message channels. Handle RPC servers
67
+ serving policy-protected sessions must enable `mcpChannels`; clients must support
68
+ the channel protocol, or use the MCP projection. Legacy RPC clients do not get
69
+ unguarded URL endpoints; attempts receive an explicit negotiation error.
70
+
71
+ Confined reads require a trusted system `python3` in `/usr/bin` or `/usr/local/bin`. Images with only conda, pyenv or nix Python must provide that prerequisite. Hosts supplying `authorizeOperation` own the complete RPC authorization decision, including Egress consent; audit-only hooks must delegate to an authorization policy. Egress capabilities are offered only when a host explicitly composes networking.
72
+
73
+ Acquiring a hosted MCP endpoint or channel is foreground work: it may start a server and perform deferred workspace setup. Catalog polling on an acquired channel is background maintenance and does not start setup. Abortable operations pass their signal to admission; cancellation rejects pending admission and prevents dispatch even if a host policy settles later.
@@ -477,6 +477,9 @@ const connectSandboxClient = async (args) => {
477
477
  await call(HandleRpcMethod.SetNetworkPolicy, policy);
478
478
  };
479
479
  }
480
+ if (capabilities.includes(SandboxCapability.Egress)) {
481
+ client.egress = (request) => call(HandleRpcMethod.Egress, request);
482
+ }
480
483
  if (capabilities.includes(SandboxCapability.ComputerUse)) {
481
484
  client.computerUse = async () => {
482
485
  const { connection, result } = await callOnConnection(HandleRpcMethod.ComputerUse, {});
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/client.ts"],
4
- "sourcesContent": ["import { bytesToBase64, bytesToStream, encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { resolvePosixPath } from \"./paths.mjs\";\nimport { createRpcPeer, type RpcPeerIface } from \"./rpc-peer.mjs\";\nimport {\n SandboxCapability,\n type AbortableIface,\n type DirEntryIface,\n type McpChannelIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type ScreenSessionIface,\n type StatIface,\n} from \"./types.mjs\";\nimport {\n frameChannelFromWebSocket,\n HANDLE_RPC_IDEMPOTENT_METHODS,\n HANDLE_RPC_VERSION,\n handleRpcClientProtocols,\n HandleRpcCloseCode,\n handleRpcError,\n HandleRpcErrorCode,\n HandleRpcMethod,\n handleRpcMethodSchemas,\n isHandleRpcError,\n MAX_INLINE_WRITE_BYTES,\n parseHandleRpcResult,\n type FrameChannelIface,\n type HandleRpcParams,\n type HandleRpcResult,\n type InitializeResultIface,\n type WebSocketConstructorIface,\n} from \"./wire.mjs\";\n\n// NetworkSandboxSessionIface implemented purely over the handle RPC: no\n// provider code, only the wire. Works wherever a WebSocket exists (Workers,\n// browsers, Node 22+) or over any frame channel through `openChannel`.\n\nexport interface SandboxClientIface extends NetworkSandboxSessionIface {\n readonly confinedFiles: boolean;\n readonly providerHooks: boolean;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n readonly capabilities: readonly SandboxCapability[];\n // A byte range of a file, streamed; null when the file does not exist.\n readFileRange(options: {\n path: string;\n root?: string;\n offset: number;\n length?: number;\n abortSignal?: AbortSignal;\n }): Promise<ReadableStream<Uint8Array> | null>;\n // Closes every connection and fails in-flight calls.\n close(): void;\n}\n\nexport interface SandboxClientCredentialIface {\n token: string;\n expiresAt: string | null;\n // A new stable endpoint URL, when the issuer moved it.\n url?: string;\n}\n\nexport interface ConnectSandboxClientArgsIface {\n // The session service's stable per-binding address; the first call to reach\n // it attaches the sandbox, and every call is served there.\n url: string;\n token: string;\n expiresAt?: string | null;\n // Defaults to the global WebSocket.\n WebSocket?: WebSocketConstructorIface;\n // Replaces WebSocket dialing entirely (relays, tests).\n openChannel?: (target: { url: string; token: string }) => Promise<FrameChannelIface>;\n // Returns a fresh credential for the stable endpoint (`url`), e.g. from the\n // broker's `sandbox` route.\n refreshToken?: () => Promise<SandboxClientCredentialIface>;\n // Send stream chunks as binary frames (default true).\n binary?: boolean;\n reconnect?: { attempts?: number; baseDelayMs?: number; maxDelayMs?: number };\n // How long before expiry to refresh the credential (default 60 s).\n refreshMarginMs?: number;\n clientInfo?: { name: string; version: string };\n now?: () => number;\n sleep?: (ms: number) => Promise<void>;\n randomId?: () => string;\n}\n\ninterface TargetIface {\n url: string;\n token: string;\n expiresAt: string | null;\n}\n\ninterface ConnectionIface {\n peer: RpcPeerIface;\n target: TargetIface;\n info: InitializeResultIface;\n nextStreamId: number;\n}\n\nconst defaultSleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\nconst defaultOpenChannel =\n (WebSocketImpl: WebSocketConstructorIface | undefined) =>\n async (target: { url: string; token: string }): Promise<FrameChannelIface> => {\n const Impl = WebSocketImpl ?? globalThis.WebSocket;\n if (Impl == null)\n throw new Error('no WebSocket implementation available; pass WebSocket or openChannel');\n const { channel, opened } = frameChannelFromWebSocket(\n new Impl(target.url, handleRpcClientProtocols(target.token)),\n );\n await opened;\n return channel;\n };\n\nconst isRetryable = (cause: unknown): boolean => isHandleRpcError(cause) && cause.retryable;\n\nexport const connectSandboxClient = async (\n args: ConnectSandboxClientArgsIface,\n): Promise<SandboxClientIface> => {\n const now = args.now ?? Date.now;\n const sleep = args.sleep ?? defaultSleep;\n const randomId = args.randomId ?? (() => crypto.randomUUID());\n const openChannel = args.openChannel ?? defaultOpenChannel(args.WebSocket);\n const attempts = args.reconnect?.attempts ?? 5;\n const baseDelayMs = args.reconnect?.baseDelayMs ?? 100;\n const maxDelayMs = args.reconnect?.maxDelayMs ?? 5_000;\n const refreshMarginMs = args.refreshMarginMs ?? 60_000;\n const binary = args.binary ?? true;\n\n let origin: TargetIface = {\n url: args.url,\n token: args.token,\n expiresAt: args.expiresAt ?? null,\n };\n let current: ConnectionIface | null = null;\n let connecting: Promise<ConnectionIface> | null = null;\n let closedByUser = false;\n let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n const live = new Set<ConnectionIface>();\n let lastInfo: InitializeResultIface | null = null;\n\n const refreshOrigin = async (): Promise<boolean> => {\n if (args.refreshToken == null) return false;\n const fresh = await args.refreshToken();\n origin = {\n url: fresh.url ?? origin.url,\n token: fresh.token,\n expiresAt: fresh.expiresAt,\n };\n return true;\n };\n\n const scheduleRefresh = (connection: ConnectionIface) => {\n if (refreshTimer != null) clearTimeout(refreshTimer);\n refreshTimer = null;\n const expiresAt = connection.info.expiresAt ?? connection.target.expiresAt;\n if (expiresAt == null || args.refreshToken == null || closedByUser) return;\n const remaining = Date.parse(expiresAt) - now();\n if (Number.isNaN(remaining)) return;\n const delay = Math.max(0, Math.min(remaining - refreshMarginMs, remaining / 2));\n refreshTimer = setTimeout(\n () => {\n void refreshConnection(connection).catch(() => undefined);\n },\n Math.min(2_147_483_647, delay),\n );\n };\n\n // The connection takes the new token in place; in-flight calls continue.\n // A moved endpoint (a new `url`) is dialed fresh instead, and in-flight\n // calls finish on the old connection.\n const refreshConnection = async (connection: ConnectionIface) => {\n if (closedByUser || connection.peer.isClosed()) return;\n await refreshOrigin();\n if (origin.url === connection.target.url) {\n const result = await requestOn(connection, HandleRpcMethod.AuthRefresh, {\n token: origin.token,\n });\n connection.target = {\n ...connection.target,\n token: origin.token,\n expiresAt: result.expiresAt,\n };\n connection.info = { ...connection.info, expiresAt: result.expiresAt };\n scheduleRefresh(connection);\n return;\n }\n if (current === connection) current = null;\n await getConnection();\n };\n\n const initialize = async (target: TargetIface): Promise<ConnectionIface> => {\n const channel = await openChannel({ url: target.url, token: target.token });\n let connection: ConnectionIface | null = null;\n const peer = createRpcPeer({\n channel,\n binary,\n onClose: () => {\n if (connection == null) return;\n live.delete(connection);\n if (current === connection) current = null;\n },\n });\n try {\n const raw = await peer.request(HandleRpcMethod.Initialize, {\n handleRpcVersion: HANDLE_RPC_VERSION,\n token: target.token,\n client: args.clientInfo,\n });\n const info = handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw);\n connection = { peer, target, info, nextStreamId: 1 };\n live.add(connection);\n return connection;\n } catch (error) {\n peer.close(HandleRpcCloseCode.Normal, 'initialize failed');\n throw error;\n }\n };\n\n const establish = async (): Promise<ConnectionIface> => {\n let failures = 0;\n let refreshed = false;\n for (;;) {\n if (closedByUser)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'client closed',\n });\n try {\n const connection = await initialize(origin);\n current = connection;\n lastInfo = connection.info;\n scheduleRefresh(connection);\n return connection;\n } catch (error) {\n if (closedByUser) throw error;\n const unauthorized =\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Unauthorized;\n if (unauthorized && !refreshed && (await refreshOrigin().catch(() => false))) {\n refreshed = true;\n continue;\n }\n if (unauthorized) throw error;\n failures += 1;\n if (failures >= attempts) {\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: `could not connect to the sandbox: ${error instanceof Error ? error.message : String(error)}`,\n retryable: true,\n });\n }\n await sleep(Math.min(maxDelayMs, baseDelayMs * 2 ** (failures - 1)));\n }\n }\n };\n\n const getConnection = (): Promise<ConnectionIface> => {\n if (current != null && !current.peer.isClosed()) return Promise.resolve(current);\n connecting ??= establish().finally(() => {\n connecting = null;\n });\n return connecting;\n };\n\n const requestOn = async <M extends HandleRpcMethod>(\n connection: ConnectionIface,\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => {\n const raw = await connection.peer.request(method, params, { signal: options?.signal });\n return parseHandleRpcResult(method, raw);\n };\n\n const callOnConnection = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<{ connection: ConnectionIface; result: HandleRpcResult<M> }> => {\n const idempotent = HANDLE_RPC_IDEMPOTENT_METHODS.includes(method);\n for (let attempt = 0; ; attempt += 1) {\n const connection = await getConnection();\n try {\n return { connection, result: await requestOn(connection, method, params, options) };\n } catch (error) {\n if (attempt === 0 && idempotent && isRetryable(error)) continue;\n throw error;\n }\n }\n };\n\n const call = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => (await callOnConnection(method, params, options)).result;\n\n const allocateStreamId = (connection: ConnectionIface): number => {\n const id = connection.nextStreamId;\n connection.nextStreamId += 1;\n return id;\n };\n\n const first = await getConnection();\n const describe = (): InitializeResultIface => current?.info ?? lastInfo ?? first.info;\n\n const readFile = async (options: {\n path: string;\n root?: string;\n offset?: number;\n length?: number;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const stream = connection.peer.streams.openIncoming(streamId);\n try {\n const result = await requestOn(\n connection,\n HandleRpcMethod.ReadFile,\n {\n path: options.path,\n root: options.root,\n streamId,\n offset: options.offset,\n length: options.length,\n },\n { signal: options.abortSignal },\n );\n if (!result.found) {\n connection.peer.streams.discardIncoming(streamId);\n return null;\n }\n } catch (error) {\n connection.peer.streams.discardIncoming(streamId);\n throw error;\n }\n options.abortSignal?.addEventListener(\n 'abort',\n () => connection.peer.streams.cancelIncoming(streamId, 'aborted'),\n {\n once: true,\n },\n );\n return stream;\n };\n\n const writeFile = async (options: {\n path: string;\n content: ReadableStream<Uint8Array>;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const sending = connection.peer.streams.openOutgoing(streamId, options.content);\n sending.catch(() => undefined);\n try {\n await requestOn(\n connection,\n HandleRpcMethod.WriteFile,\n { path: options.path, streamId },\n { signal: options.abortSignal },\n );\n } catch (error) {\n connection.peer.streams.abortOutgoing(streamId, 'request failed');\n throw error;\n }\n };\n\n const writeBinaryFile = async (options: {\n path: string;\n content: Uint8Array;\n abortSignal?: AbortSignal;\n }) => {\n if (options.content.byteLength > MAX_INLINE_WRITE_BYTES) {\n await writeFile({\n path: options.path,\n content: bytesToStream(options.content),\n abortSignal: options.abortSignal,\n });\n return;\n }\n await call(\n HandleRpcMethod.WriteFile,\n { path: options.path, contentBase64: bytesToBase64(options.content) },\n { signal: options.abortSignal },\n );\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdinStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (options.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (options.stdin instanceof ReadableStream) {\n stdinSource = options.stdin;\n } else {\n stdinSource = bytesToStream(utf8Encode(options.stdin));\n }\n connection.peer.streams.openOutgoing(stdinStreamId, stdinSource).catch(() => undefined);\n let pid: string | null;\n try {\n const result = await requestOn(connection, HandleRpcMethod.Spawn, {\n processId,\n command: options.command,\n args: options.args,\n cwd: options.cwd,\n env: options.env,\n shell: options.shell,\n timeoutMs: options.timeoutMs,\n stdinStreamId,\n stdoutStreamId,\n stderrStreamId,\n });\n pid = result.pid;\n } catch (error) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'spawn failed');\n throw error;\n }\n let waiting: Promise<{ exitCode: number }> | null = null;\n const kill = async (signal?: string) => {\n try {\n await requestOn(connection, HandleRpcMethod.ProcessKill, { processId, signal });\n } catch (error) {\n // Already exited and reaped, or the connection (and so the process) is gone.\n if (\n isHandleRpcError(error) &&\n (error.code === HandleRpcErrorCode.NotFound || error.retryable)\n )\n return;\n throw error;\n }\n };\n options.abortSignal?.addEventListener('abort', () => void kill().catch(() => undefined), {\n once: true,\n });\n return {\n pid,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n wait: () => {\n waiting ??= requestOn(\n connection,\n HandleRpcMethod.ProcessWait,\n { processId },\n { signal: options.abortSignal },\n );\n return waiting;\n },\n kill,\n };\n };\n\n const client: SandboxClientIface = {\n get id() {\n return describe().id;\n },\n get defaultWorkingDirectory() {\n return describe().defaultWorkingDirectory;\n },\n get ports() {\n return describe().ports;\n },\n get description() {\n return describe().description;\n },\n get capabilities() {\n return describe().capabilities;\n },\n confinedFiles: describe().confinedFiles === true,\n providerHooks: describe().providerHooks === true,\n onRuntimeShutdown: async () => {\n await call(HandleRpcMethod.OnRuntimeShutdown, {});\n },\n onSandboxStop: async () => {\n await call(HandleRpcMethod.OnSandboxStop, {});\n },\n onSandboxDelete: async (options) => {\n await call(HandleRpcMethod.OnSandboxDelete, options ?? {});\n },\n readFile: (options) => readFile(options),\n readFileRange: readFile,\n readBinaryFile: async (options) => {\n const stream = await readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const { abortSignal: _abortSignal, ...params } = options;\n const parsed = handleRpcMethodSchemas[HandleRpcMethod.ReadTextFile].params.safeParse(params);\n if (!parsed.success)\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: parsed.error.message,\n });\n const stream = await readFile({ path: options.path, abortSignal: options.abortSignal });\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile,\n writeBinaryFile,\n writeTextFile: async (options) =>\n writeBinaryFile({\n path: options.path,\n content: encodeSandboxText(options.content, options.encoding),\n abortSignal: options.abortSignal,\n }),\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options): Promise<StatIface | null> =>\n (\n await call(\n HandleRpcMethod.Stat,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).stat,\n readDir: async (options): Promise<DirEntryIface[]> =>\n (\n await call(\n HandleRpcMethod.ReadDir,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).entries,\n resolvePath: (path) => resolvePosixPath(describe().defaultWorkingDirectory, path),\n removePath: async (options) => {\n const { abortSignal, ...params } = options;\n await call(HandleRpcMethod.RemovePath, params, { signal: abortSignal });\n },\n getPortEndpoint: (options) => call(HandleRpcMethod.GetPortEndpoint, options),\n getPortUrl: async (options) => (await call(HandleRpcMethod.GetPortEndpoint, options)).url,\n stop: async () => {\n await call(HandleRpcMethod.Stop, {});\n },\n destroy: async () => {\n await call(HandleRpcMethod.Destroy, {});\n },\n close: () => {\n closedByUser = true;\n if (refreshTimer != null) clearTimeout(refreshTimer);\n for (const connection of live)\n connection.peer.close(HandleRpcCloseCode.Normal, 'client closed');\n live.clear();\n current = null;\n },\n };\n\n const mcpEndpoint = (\n connection: ConnectionIface,\n endpoint: HandleRpcResult<HandleRpcMethod.ComputerUse>,\n ): SandboxMcpEndpoint => {\n if ('url' in endpoint) return endpoint;\n return {\n name: endpoint.name,\n connect: async (options?: AbortableIface): Promise<McpChannelIface> => {\n const opened = await requestOn(\n connection,\n HandleRpcMethod.McpOpen,\n { endpointKey: endpoint.endpointKey },\n { signal: options?.abortSignal },\n );\n let closed = false;\n const requireOpen = (): void => {\n if (closed)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'MCP channel closed',\n });\n };\n const channel: McpChannelIface = {\n send: async (message, sendOptions) => {\n requireOpen();\n await requestOn(\n connection,\n HandleRpcMethod.McpSend,\n { channelId: opened.channelId, message },\n { signal: sendOptions?.abortSignal },\n );\n },\n receive: async (receiveOptions) => {\n requireOpen();\n return (\n await requestOn(\n connection,\n HandleRpcMethod.McpReceive,\n { channelId: opened.channelId },\n { signal: receiveOptions?.abortSignal },\n )\n ).messages;\n },\n close: async () => {\n if (closed) return;\n closed = true;\n if (!connection.peer.isClosed())\n await requestOn(connection, HandleRpcMethod.McpClose, {\n channelId: opened.channelId,\n });\n },\n };\n if (options?.abortSignal?.aborted === true) {\n await channel.close().catch(() => undefined);\n options.abortSignal.throwIfAborted();\n }\n return channel;\n },\n };\n };\n\n const capabilities = first.info.capabilities;\n if (capabilities.includes(SandboxCapability.NetworkPolicy)) {\n client.setNetworkPolicy = async (policy: NetworkPolicyIface) => {\n await call(HandleRpcMethod.SetNetworkPolicy, policy);\n };\n }\n if (capabilities.includes(SandboxCapability.ComputerUse)) {\n client.computerUse = async (): Promise<SandboxMcpEndpoint> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.ComputerUse, {});\n return mcpEndpoint(connection, result);\n };\n }\n if (capabilities.includes(SandboxCapability.Screen)) {\n client.screen = (options): Promise<ScreenSessionIface> =>\n call(HandleRpcMethod.Screen, options ?? {});\n }\n if (capabilities.includes(SandboxCapability.LocalMcp)) {\n client.localMcp = async (): Promise<SandboxMcpEndpoint[]> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.LocalMcp, {});\n return result.endpoints.map((endpoint) => mcpEndpoint(connection, endpoint));\n };\n }\n return client;\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import { bytesToBase64, bytesToStream, encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { resolvePosixPath } from \"./paths.mjs\";\nimport { createRpcPeer, type RpcPeerIface } from \"./rpc-peer.mjs\";\nimport {\n SandboxCapability,\n type AbortableIface,\n type DirEntryIface,\n type McpChannelIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type ScreenSessionIface,\n type StatIface,\n} from \"./types.mjs\";\nimport {\n frameChannelFromWebSocket,\n HANDLE_RPC_IDEMPOTENT_METHODS,\n HANDLE_RPC_VERSION,\n handleRpcClientProtocols,\n HandleRpcCloseCode,\n handleRpcError,\n HandleRpcErrorCode,\n HandleRpcMethod,\n handleRpcMethodSchemas,\n isHandleRpcError,\n MAX_INLINE_WRITE_BYTES,\n parseHandleRpcResult,\n type FrameChannelIface,\n type HandleRpcParams,\n type HandleRpcResult,\n type InitializeResultIface,\n type WebSocketConstructorIface,\n} from \"./wire.mjs\";\n\n// NetworkSandboxSessionIface implemented purely over the handle RPC: no\n// provider code, only the wire. Works wherever a WebSocket exists (Workers,\n// browsers, Node 22+) or over any frame channel through `openChannel`.\n\nexport interface SandboxClientIface extends NetworkSandboxSessionIface {\n readonly confinedFiles: boolean;\n readonly providerHooks: boolean;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n readonly capabilities: readonly SandboxCapability[];\n // A byte range of a file, streamed; null when the file does not exist.\n readFileRange(options: {\n path: string;\n root?: string;\n offset: number;\n length?: number;\n abortSignal?: AbortSignal;\n }): Promise<ReadableStream<Uint8Array> | null>;\n // Closes every connection and fails in-flight calls.\n close(): void;\n}\n\nexport interface SandboxClientCredentialIface {\n token: string;\n expiresAt: string | null;\n // A new stable endpoint URL, when the issuer moved it.\n url?: string;\n}\n\nexport interface ConnectSandboxClientArgsIface {\n // The session service's stable per-binding address; the first call to reach\n // it attaches the sandbox, and every call is served there.\n url: string;\n token: string;\n expiresAt?: string | null;\n // Defaults to the global WebSocket.\n WebSocket?: WebSocketConstructorIface;\n // Replaces WebSocket dialing entirely (relays, tests).\n openChannel?: (target: { url: string; token: string }) => Promise<FrameChannelIface>;\n // Returns a fresh credential for the stable endpoint (`url`), e.g. from the\n // broker's `sandbox` route.\n refreshToken?: () => Promise<SandboxClientCredentialIface>;\n // Send stream chunks as binary frames (default true).\n binary?: boolean;\n reconnect?: { attempts?: number; baseDelayMs?: number; maxDelayMs?: number };\n // How long before expiry to refresh the credential (default 60 s).\n refreshMarginMs?: number;\n clientInfo?: { name: string; version: string };\n now?: () => number;\n sleep?: (ms: number) => Promise<void>;\n randomId?: () => string;\n}\n\ninterface TargetIface {\n url: string;\n token: string;\n expiresAt: string | null;\n}\n\ninterface ConnectionIface {\n peer: RpcPeerIface;\n target: TargetIface;\n info: InitializeResultIface;\n nextStreamId: number;\n}\n\nconst defaultSleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\nconst defaultOpenChannel =\n (WebSocketImpl: WebSocketConstructorIface | undefined) =>\n async (target: { url: string; token: string }): Promise<FrameChannelIface> => {\n const Impl = WebSocketImpl ?? globalThis.WebSocket;\n if (Impl == null)\n throw new Error('no WebSocket implementation available; pass WebSocket or openChannel');\n const { channel, opened } = frameChannelFromWebSocket(\n new Impl(target.url, handleRpcClientProtocols(target.token)),\n );\n await opened;\n return channel;\n };\n\nconst isRetryable = (cause: unknown): boolean => isHandleRpcError(cause) && cause.retryable;\n\nexport const connectSandboxClient = async (\n args: ConnectSandboxClientArgsIface,\n): Promise<SandboxClientIface> => {\n const now = args.now ?? Date.now;\n const sleep = args.sleep ?? defaultSleep;\n const randomId = args.randomId ?? (() => crypto.randomUUID());\n const openChannel = args.openChannel ?? defaultOpenChannel(args.WebSocket);\n const attempts = args.reconnect?.attempts ?? 5;\n const baseDelayMs = args.reconnect?.baseDelayMs ?? 100;\n const maxDelayMs = args.reconnect?.maxDelayMs ?? 5_000;\n const refreshMarginMs = args.refreshMarginMs ?? 60_000;\n const binary = args.binary ?? true;\n\n let origin: TargetIface = {\n url: args.url,\n token: args.token,\n expiresAt: args.expiresAt ?? null,\n };\n let current: ConnectionIface | null = null;\n let connecting: Promise<ConnectionIface> | null = null;\n let closedByUser = false;\n let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n const live = new Set<ConnectionIface>();\n let lastInfo: InitializeResultIface | null = null;\n\n const refreshOrigin = async (): Promise<boolean> => {\n if (args.refreshToken == null) return false;\n const fresh = await args.refreshToken();\n origin = {\n url: fresh.url ?? origin.url,\n token: fresh.token,\n expiresAt: fresh.expiresAt,\n };\n return true;\n };\n\n const scheduleRefresh = (connection: ConnectionIface) => {\n if (refreshTimer != null) clearTimeout(refreshTimer);\n refreshTimer = null;\n const expiresAt = connection.info.expiresAt ?? connection.target.expiresAt;\n if (expiresAt == null || args.refreshToken == null || closedByUser) return;\n const remaining = Date.parse(expiresAt) - now();\n if (Number.isNaN(remaining)) return;\n const delay = Math.max(0, Math.min(remaining - refreshMarginMs, remaining / 2));\n refreshTimer = setTimeout(\n () => {\n void refreshConnection(connection).catch(() => undefined);\n },\n Math.min(2_147_483_647, delay),\n );\n };\n\n // The connection takes the new token in place; in-flight calls continue.\n // A moved endpoint (a new `url`) is dialed fresh instead, and in-flight\n // calls finish on the old connection.\n const refreshConnection = async (connection: ConnectionIface) => {\n if (closedByUser || connection.peer.isClosed()) return;\n await refreshOrigin();\n if (origin.url === connection.target.url) {\n const result = await requestOn(connection, HandleRpcMethod.AuthRefresh, {\n token: origin.token,\n });\n connection.target = {\n ...connection.target,\n token: origin.token,\n expiresAt: result.expiresAt,\n };\n connection.info = { ...connection.info, expiresAt: result.expiresAt };\n scheduleRefresh(connection);\n return;\n }\n if (current === connection) current = null;\n await getConnection();\n };\n\n const initialize = async (target: TargetIface): Promise<ConnectionIface> => {\n const channel = await openChannel({ url: target.url, token: target.token });\n let connection: ConnectionIface | null = null;\n const peer = createRpcPeer({\n channel,\n binary,\n onClose: () => {\n if (connection == null) return;\n live.delete(connection);\n if (current === connection) current = null;\n },\n });\n try {\n const raw = await peer.request(HandleRpcMethod.Initialize, {\n handleRpcVersion: HANDLE_RPC_VERSION,\n token: target.token,\n client: args.clientInfo,\n });\n const info = handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw);\n connection = { peer, target, info, nextStreamId: 1 };\n live.add(connection);\n return connection;\n } catch (error) {\n peer.close(HandleRpcCloseCode.Normal, 'initialize failed');\n throw error;\n }\n };\n\n const establish = async (): Promise<ConnectionIface> => {\n let failures = 0;\n let refreshed = false;\n for (;;) {\n if (closedByUser)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'client closed',\n });\n try {\n const connection = await initialize(origin);\n current = connection;\n lastInfo = connection.info;\n scheduleRefresh(connection);\n return connection;\n } catch (error) {\n if (closedByUser) throw error;\n const unauthorized =\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Unauthorized;\n if (unauthorized && !refreshed && (await refreshOrigin().catch(() => false))) {\n refreshed = true;\n continue;\n }\n if (unauthorized) throw error;\n failures += 1;\n if (failures >= attempts) {\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: `could not connect to the sandbox: ${error instanceof Error ? error.message : String(error)}`,\n retryable: true,\n });\n }\n await sleep(Math.min(maxDelayMs, baseDelayMs * 2 ** (failures - 1)));\n }\n }\n };\n\n const getConnection = (): Promise<ConnectionIface> => {\n if (current != null && !current.peer.isClosed()) return Promise.resolve(current);\n connecting ??= establish().finally(() => {\n connecting = null;\n });\n return connecting;\n };\n\n const requestOn = async <M extends HandleRpcMethod>(\n connection: ConnectionIface,\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => {\n const raw = await connection.peer.request(method, params, { signal: options?.signal });\n return parseHandleRpcResult(method, raw);\n };\n\n const callOnConnection = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<{ connection: ConnectionIface; result: HandleRpcResult<M> }> => {\n const idempotent = HANDLE_RPC_IDEMPOTENT_METHODS.includes(method);\n for (let attempt = 0; ; attempt += 1) {\n const connection = await getConnection();\n try {\n return { connection, result: await requestOn(connection, method, params, options) };\n } catch (error) {\n if (attempt === 0 && idempotent && isRetryable(error)) continue;\n throw error;\n }\n }\n };\n\n const call = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => (await callOnConnection(method, params, options)).result;\n\n const allocateStreamId = (connection: ConnectionIface): number => {\n const id = connection.nextStreamId;\n connection.nextStreamId += 1;\n return id;\n };\n\n const first = await getConnection();\n const describe = (): InitializeResultIface => current?.info ?? lastInfo ?? first.info;\n\n const readFile = async (options: {\n path: string;\n root?: string;\n offset?: number;\n length?: number;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const stream = connection.peer.streams.openIncoming(streamId);\n try {\n const result = await requestOn(\n connection,\n HandleRpcMethod.ReadFile,\n {\n path: options.path,\n root: options.root,\n streamId,\n offset: options.offset,\n length: options.length,\n },\n { signal: options.abortSignal },\n );\n if (!result.found) {\n connection.peer.streams.discardIncoming(streamId);\n return null;\n }\n } catch (error) {\n connection.peer.streams.discardIncoming(streamId);\n throw error;\n }\n options.abortSignal?.addEventListener(\n 'abort',\n () => connection.peer.streams.cancelIncoming(streamId, 'aborted'),\n {\n once: true,\n },\n );\n return stream;\n };\n\n const writeFile = async (options: {\n path: string;\n content: ReadableStream<Uint8Array>;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const sending = connection.peer.streams.openOutgoing(streamId, options.content);\n sending.catch(() => undefined);\n try {\n await requestOn(\n connection,\n HandleRpcMethod.WriteFile,\n { path: options.path, streamId },\n { signal: options.abortSignal },\n );\n } catch (error) {\n connection.peer.streams.abortOutgoing(streamId, 'request failed');\n throw error;\n }\n };\n\n const writeBinaryFile = async (options: {\n path: string;\n content: Uint8Array;\n abortSignal?: AbortSignal;\n }) => {\n if (options.content.byteLength > MAX_INLINE_WRITE_BYTES) {\n await writeFile({\n path: options.path,\n content: bytesToStream(options.content),\n abortSignal: options.abortSignal,\n });\n return;\n }\n await call(\n HandleRpcMethod.WriteFile,\n { path: options.path, contentBase64: bytesToBase64(options.content) },\n { signal: options.abortSignal },\n );\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdinStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (options.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (options.stdin instanceof ReadableStream) {\n stdinSource = options.stdin;\n } else {\n stdinSource = bytesToStream(utf8Encode(options.stdin));\n }\n connection.peer.streams.openOutgoing(stdinStreamId, stdinSource).catch(() => undefined);\n let pid: string | null;\n try {\n const result = await requestOn(connection, HandleRpcMethod.Spawn, {\n processId,\n command: options.command,\n args: options.args,\n cwd: options.cwd,\n env: options.env,\n shell: options.shell,\n timeoutMs: options.timeoutMs,\n stdinStreamId,\n stdoutStreamId,\n stderrStreamId,\n });\n pid = result.pid;\n } catch (error) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'spawn failed');\n throw error;\n }\n let waiting: Promise<{ exitCode: number }> | null = null;\n const kill = async (signal?: string) => {\n try {\n await requestOn(connection, HandleRpcMethod.ProcessKill, { processId, signal });\n } catch (error) {\n // Already exited and reaped, or the connection (and so the process) is gone.\n if (\n isHandleRpcError(error) &&\n (error.code === HandleRpcErrorCode.NotFound || error.retryable)\n )\n return;\n throw error;\n }\n };\n options.abortSignal?.addEventListener('abort', () => void kill().catch(() => undefined), {\n once: true,\n });\n return {\n pid,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n wait: () => {\n waiting ??= requestOn(\n connection,\n HandleRpcMethod.ProcessWait,\n { processId },\n { signal: options.abortSignal },\n );\n return waiting;\n },\n kill,\n };\n };\n\n const client: SandboxClientIface = {\n get id() {\n return describe().id;\n },\n get defaultWorkingDirectory() {\n return describe().defaultWorkingDirectory;\n },\n get ports() {\n return describe().ports;\n },\n get description() {\n return describe().description;\n },\n get capabilities() {\n return describe().capabilities;\n },\n confinedFiles: describe().confinedFiles === true,\n providerHooks: describe().providerHooks === true,\n onRuntimeShutdown: async () => {\n await call(HandleRpcMethod.OnRuntimeShutdown, {});\n },\n onSandboxStop: async () => {\n await call(HandleRpcMethod.OnSandboxStop, {});\n },\n onSandboxDelete: async (options) => {\n await call(HandleRpcMethod.OnSandboxDelete, options ?? {});\n },\n readFile: (options) => readFile(options),\n readFileRange: readFile,\n readBinaryFile: async (options) => {\n const stream = await readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const { abortSignal: _abortSignal, ...params } = options;\n const parsed = handleRpcMethodSchemas[HandleRpcMethod.ReadTextFile].params.safeParse(params);\n if (!parsed.success)\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: parsed.error.message,\n });\n const stream = await readFile({ path: options.path, abortSignal: options.abortSignal });\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile,\n writeBinaryFile,\n writeTextFile: async (options) =>\n writeBinaryFile({\n path: options.path,\n content: encodeSandboxText(options.content, options.encoding),\n abortSignal: options.abortSignal,\n }),\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options): Promise<StatIface | null> =>\n (\n await call(\n HandleRpcMethod.Stat,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).stat,\n readDir: async (options): Promise<DirEntryIface[]> =>\n (\n await call(\n HandleRpcMethod.ReadDir,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).entries,\n resolvePath: (path) => resolvePosixPath(describe().defaultWorkingDirectory, path),\n removePath: async (options) => {\n const { abortSignal, ...params } = options;\n await call(HandleRpcMethod.RemovePath, params, { signal: abortSignal });\n },\n getPortEndpoint: (options) => call(HandleRpcMethod.GetPortEndpoint, options),\n getPortUrl: async (options) => (await call(HandleRpcMethod.GetPortEndpoint, options)).url,\n stop: async () => {\n await call(HandleRpcMethod.Stop, {});\n },\n destroy: async () => {\n await call(HandleRpcMethod.Destroy, {});\n },\n close: () => {\n closedByUser = true;\n if (refreshTimer != null) clearTimeout(refreshTimer);\n for (const connection of live)\n connection.peer.close(HandleRpcCloseCode.Normal, 'client closed');\n live.clear();\n current = null;\n },\n };\n\n const mcpEndpoint = (\n connection: ConnectionIface,\n endpoint: HandleRpcResult<HandleRpcMethod.ComputerUse>,\n ): SandboxMcpEndpoint => {\n if ('url' in endpoint) return endpoint;\n return {\n name: endpoint.name,\n connect: async (options?: AbortableIface): Promise<McpChannelIface> => {\n const opened = await requestOn(\n connection,\n HandleRpcMethod.McpOpen,\n { endpointKey: endpoint.endpointKey },\n { signal: options?.abortSignal },\n );\n let closed = false;\n const requireOpen = (): void => {\n if (closed)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'MCP channel closed',\n });\n };\n const channel: McpChannelIface = {\n send: async (message, sendOptions) => {\n requireOpen();\n await requestOn(\n connection,\n HandleRpcMethod.McpSend,\n { channelId: opened.channelId, message },\n { signal: sendOptions?.abortSignal },\n );\n },\n receive: async (receiveOptions) => {\n requireOpen();\n return (\n await requestOn(\n connection,\n HandleRpcMethod.McpReceive,\n { channelId: opened.channelId },\n { signal: receiveOptions?.abortSignal },\n )\n ).messages;\n },\n close: async () => {\n if (closed) return;\n closed = true;\n if (!connection.peer.isClosed())\n await requestOn(connection, HandleRpcMethod.McpClose, {\n channelId: opened.channelId,\n });\n },\n };\n if (options?.abortSignal?.aborted === true) {\n await channel.close().catch(() => undefined);\n options.abortSignal.throwIfAborted();\n }\n return channel;\n },\n };\n };\n\n const capabilities = first.info.capabilities;\n if (capabilities.includes(SandboxCapability.NetworkPolicy)) {\n client.setNetworkPolicy = async (policy: NetworkPolicyIface) => {\n await call(HandleRpcMethod.SetNetworkPolicy, policy);\n };\n }\n if (capabilities.includes(SandboxCapability.Egress)) {\n client.egress = (request) => call(HandleRpcMethod.Egress, request);\n }\n if (capabilities.includes(SandboxCapability.ComputerUse)) {\n client.computerUse = async (): Promise<SandboxMcpEndpoint> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.ComputerUse, {});\n return mcpEndpoint(connection, result);\n };\n }\n if (capabilities.includes(SandboxCapability.Screen)) {\n client.screen = (options): Promise<ScreenSessionIface> =>\n call(HandleRpcMethod.Screen, options ?? {});\n }\n if (capabilities.includes(SandboxCapability.LocalMcp)) {\n client.localMcp = async (): Promise<SandboxMcpEndpoint[]> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.LocalMcp, {});\n return result.endpoints.map((endpoint) => mcpEndpoint(connection, endpoint));\n };\n }\n return client;\n};\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -6,7 +6,7 @@ interface ConfinedPathIface extends AbortableIface {
6
6
  }
7
7
  export declare const confinedStat: (sandbox: Pick<SandboxSessionIface, "run" | "spawn">, options: ConfinedPathIface) => Promise<{
8
8
  path: string;
9
- type: import("./types.mjs").SandboxEntryType;
9
+ type: import("./file-kind.mjs").SandboxEntryType;
10
10
  size: number;
11
11
  modifiedAt: string | null;
12
12
  mode: number | null;
@@ -14,7 +14,7 @@ export declare const confinedStat: (sandbox: Pick<SandboxSessionIface, "run" | "
14
14
  export declare const confinedReadDir: (sandbox: Pick<SandboxSessionIface, "run" | "spawn">, options: ConfinedPathIface) => Promise<{
15
15
  name: string;
16
16
  path: string;
17
- type: import("./types.mjs").SandboxEntryType;
17
+ type: import("./file-kind.mjs").SandboxEntryType;
18
18
  size: number | null;
19
19
  }[]>;
20
20
  export declare const confinedReadFile: (sandbox: Pick<SandboxSessionIface, "run" | "spawn">, options: ConfinedPathIface) => Promise<ReadableStream<Uint8Array<ArrayBufferLike>> | null>;
@@ -1,6 +1,6 @@
1
1
  import * as z from "zod";
2
2
  import { concatBytes, readAllBytes } from "./bytes.mjs";
3
- import { dirEntrySchema, statSchema } from "./wire.mjs";
3
+ import { dirEntrySchema, statSchema } from "./file-schemas.mjs";
4
4
  const CONFINED_FILES_SCRIPT = `import json, os, stat, sys, datetime
5
5
  p = json.loads(sys.argv[1])
6
6
  root = os.path.normpath(p['root'])
@@ -50,8 +50,11 @@ finally:
50
50
  os.close(fd)
51
51
  `;
52
52
  const invocation = (options, operation) => ({
53
- command: "python3",
53
+ command: "/usr/bin/env",
54
54
  args: [
55
+ "PATH=/usr/bin:/usr/local/bin",
56
+ "python3",
57
+ "-I",
55
58
  "-c",
56
59
  CONFINED_FILES_SCRIPT,
57
60
  JSON.stringify({ root: options.root, path: options.path, operation })
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/confined-files.ts"],
4
- "sourcesContent": ["import * as z from 'zod';\nimport { concatBytes, readAllBytes } from \"./bytes.mjs\";\nimport type { AbortableIface, ConfinedSandboxFilesIface, SandboxSessionIface } from \"./types.mjs\";\nimport { dirEntrySchema, statSchema } from \"./wire.mjs\";\n\n// Pin each ancestor with openat(O_NOFOLLOW). A concurrent rename cannot redirect\n// a read outside the opened directory. Missing Python support fails closed.\nexport const CONFINED_FILES_SCRIPT = `import json, os, stat, sys, datetime\np = json.loads(sys.argv[1])\nroot = os.path.normpath(p['root'])\npath = os.path.normpath(p['path'])\nif not root.startswith('/') or not path.startswith('/') or os.path.commonpath([root, path]) != root:\n raise ValueError('path outside workspace')\nfd = os.open('/', os.O_RDONLY | os.O_DIRECTORY)\ntry:\n parts = [x for x in path.split('/') if x]\n for i, part in enumerate(parts):\n flags = os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK\n if i < len(parts) - 1 or p['operation'] == 'directory':\n flags |= os.O_DIRECTORY\n next_fd = os.open(part, flags, dir_fd=fd)\n os.close(fd)\n fd = next_fd\n info = os.fstat(fd)\n def kind(s):\n return 'directory' if stat.S_ISDIR(s.st_mode) else 'file' if stat.S_ISREG(s.st_mode) else 'symlink' if stat.S_ISLNK(s.st_mode) else 'other'\n if p['operation'] == 'stat':\n print(json.dumps({'path': path, 'type': kind(info), 'size': info.st_size, 'modifiedAt': datetime.datetime.fromtimestamp(info.st_mtime, datetime.timezone.utc).isoformat(), 'mode': stat.S_IMODE(info.st_mode)}))\n elif p['operation'] == 'directory':\n entries = []\n for name in os.listdir(fd):\n try:\n s = os.stat(name, dir_fd=fd, follow_symlinks=False)\n except FileNotFoundError:\n continue\n entries.append({'name': name, 'path': os.path.join(path, name), 'type': kind(s), 'size': s.st_size})\n print(json.dumps(entries))\n else:\n if not stat.S_ISREG(info.st_mode):\n raise ValueError('not a regular file')\n sys.stdout.buffer.write(b'OK\\\\n')\n sys.stdout.buffer.flush()\n while True:\n chunk = os.read(fd, 65536)\n if not chunk:\n break\n sys.stdout.buffer.write(chunk)\nexcept FileNotFoundError:\n if p['operation'] == 'read':\n sys.stdout.buffer.write(b'MISSING\\\\n')\n else:\n print('null')\nfinally:\n os.close(fd)\n`;\n\ninterface ConfinedPathIface extends AbortableIface {\n path: string;\n root: string;\n}\n\nconst invocation = (options: ConfinedPathIface, operation: string) => ({\n command: 'python3',\n args: [\n '-c',\n CONFINED_FILES_SCRIPT,\n JSON.stringify({ root: options.root, path: options.path, operation }),\n ],\n abortSignal: options.abortSignal,\n});\n\nexport const confinedStat = async (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n options: ConfinedPathIface,\n) => {\n const result = await sandbox.run(invocation(options, 'stat'));\n if (result.exitCode !== 0) throw new Error('Confined file stat failed');\n return statSchema.nullable().parse(JSON.parse(result.stdout));\n};\n\nexport const confinedReadDir = async (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n options: ConfinedPathIface,\n) => {\n const result = await sandbox.run(invocation(options, 'directory'));\n if (result.exitCode !== 0) throw new Error('Confined directory read failed');\n return z.array(dirEntrySchema).parse(JSON.parse(result.stdout));\n};\n\nexport const confinedReadFile = async (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n options: ConfinedPathIface,\n) => {\n const process = await sandbox.spawn(invocation(options, 'read'));\n const stderr = readAllBytes(process.stderr);\n void stderr.catch(() => undefined);\n const reader = process.stdout.getReader();\n let buffered: Uint8Array = new Uint8Array(0);\n let newline = -1;\n try {\n while (newline === -1) {\n const next = await reader.read();\n if (next.done) throw new Error('Confined file read failed');\n buffered = concatBytes([buffered, next.value]);\n newline = buffered.indexOf(10);\n if (newline === -1 && buffered.length > 128) throw new Error('Invalid confined file header');\n }\n const header = new TextDecoder().decode(buffered.subarray(0, newline));\n if (header === 'MISSING') {\n await reader.cancel();\n await process.wait();\n await stderr;\n return null;\n }\n if (header !== 'OK') throw new Error('Invalid confined file header');\n } catch (cause) {\n await reader.cancel().catch(() => undefined);\n await process.kill().catch(() => undefined);\n await stderr.catch(() => undefined);\n throw cause;\n }\n const first = buffered.subarray(newline + 1);\n return new ReadableStream<Uint8Array>({\n start: (controller) => {\n if (first.length > 0) controller.enqueue(first);\n },\n pull: async (controller) => {\n try {\n const next = await reader.read();\n if (!next.done) {\n controller.enqueue(next.value);\n return;\n }\n const result = await process.wait();\n await stderr;\n if (result.exitCode !== 0) controller.error(new Error('Confined file read failed'));\n else controller.close();\n } catch (cause) {\n await reader.cancel().catch(() => undefined);\n await process.kill().catch(() => undefined);\n await stderr.catch(() => undefined);\n controller.error(cause);\n }\n },\n cancel: async () => {\n await reader.cancel().catch(() => undefined);\n await process.kill().catch(() => undefined);\n await stderr.catch(() => undefined);\n },\n });\n};\n\n// Bind the fixed read scripts before narrowing the public process capability.\nexport const createConfinedFileReader = (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n): ConfinedSandboxFilesIface => ({\n readFile: (options) => confinedReadFile(sandbox, options),\n stat: (options) => confinedStat(sandbox, options),\n readDir: (options) => confinedReadDir(sandbox, options),\n});\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import * as z from 'zod';\nimport { concatBytes, readAllBytes } from \"./bytes.mjs\";\nimport type { AbortableIface, ConfinedSandboxFilesIface, SandboxSessionIface } from \"./types.mjs\";\nimport { dirEntrySchema, statSchema } from \"./file-schemas.mjs\";\n\n// Pin each ancestor with openat(O_NOFOLLOW). A concurrent rename cannot redirect\n// a read outside the opened directory. Missing Python support fails closed.\nexport const CONFINED_FILES_SCRIPT = `import json, os, stat, sys, datetime\np = json.loads(sys.argv[1])\nroot = os.path.normpath(p['root'])\npath = os.path.normpath(p['path'])\nif not root.startswith('/') or not path.startswith('/') or os.path.commonpath([root, path]) != root:\n raise ValueError('path outside workspace')\nfd = os.open('/', os.O_RDONLY | os.O_DIRECTORY)\ntry:\n parts = [x for x in path.split('/') if x]\n for i, part in enumerate(parts):\n flags = os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK\n if i < len(parts) - 1 or p['operation'] == 'directory':\n flags |= os.O_DIRECTORY\n next_fd = os.open(part, flags, dir_fd=fd)\n os.close(fd)\n fd = next_fd\n info = os.fstat(fd)\n def kind(s):\n return 'directory' if stat.S_ISDIR(s.st_mode) else 'file' if stat.S_ISREG(s.st_mode) else 'symlink' if stat.S_ISLNK(s.st_mode) else 'other'\n if p['operation'] == 'stat':\n print(json.dumps({'path': path, 'type': kind(info), 'size': info.st_size, 'modifiedAt': datetime.datetime.fromtimestamp(info.st_mtime, datetime.timezone.utc).isoformat(), 'mode': stat.S_IMODE(info.st_mode)}))\n elif p['operation'] == 'directory':\n entries = []\n for name in os.listdir(fd):\n try:\n s = os.stat(name, dir_fd=fd, follow_symlinks=False)\n except FileNotFoundError:\n continue\n entries.append({'name': name, 'path': os.path.join(path, name), 'type': kind(s), 'size': s.st_size})\n print(json.dumps(entries))\n else:\n if not stat.S_ISREG(info.st_mode):\n raise ValueError('not a regular file')\n sys.stdout.buffer.write(b'OK\\\\n')\n sys.stdout.buffer.flush()\n while True:\n chunk = os.read(fd, 65536)\n if not chunk:\n break\n sys.stdout.buffer.write(chunk)\nexcept FileNotFoundError:\n if p['operation'] == 'read':\n sys.stdout.buffer.write(b'MISSING\\\\n')\n else:\n print('null')\nfinally:\n os.close(fd)\n`;\n\ninterface ConfinedPathIface extends AbortableIface {\n path: string;\n root: string;\n}\n\nconst invocation = (options: ConfinedPathIface, operation: string) => ({\n command: '/usr/bin/env',\n args: [\n 'PATH=/usr/bin:/usr/local/bin',\n 'python3',\n '-I',\n '-c',\n CONFINED_FILES_SCRIPT,\n JSON.stringify({ root: options.root, path: options.path, operation }),\n ],\n abortSignal: options.abortSignal,\n});\n\nexport const confinedStat = async (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n options: ConfinedPathIface,\n) => {\n const result = await sandbox.run(invocation(options, 'stat'));\n if (result.exitCode !== 0) throw new Error('Confined file stat failed');\n return statSchema.nullable().parse(JSON.parse(result.stdout));\n};\n\nexport const confinedReadDir = async (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n options: ConfinedPathIface,\n) => {\n const result = await sandbox.run(invocation(options, 'directory'));\n if (result.exitCode !== 0) throw new Error('Confined directory read failed');\n return z.array(dirEntrySchema).parse(JSON.parse(result.stdout));\n};\n\nexport const confinedReadFile = async (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n options: ConfinedPathIface,\n) => {\n const process = await sandbox.spawn(invocation(options, 'read'));\n const stderr = readAllBytes(process.stderr);\n void stderr.catch(() => undefined);\n const reader = process.stdout.getReader();\n let buffered: Uint8Array = new Uint8Array(0);\n let newline = -1;\n try {\n while (newline === -1) {\n const next = await reader.read();\n if (next.done) throw new Error('Confined file read failed');\n buffered = concatBytes([buffered, next.value]);\n newline = buffered.indexOf(10);\n if (newline === -1 && buffered.length > 128) throw new Error('Invalid confined file header');\n }\n const header = new TextDecoder().decode(buffered.subarray(0, newline));\n if (header === 'MISSING') {\n await reader.cancel();\n await process.wait();\n await stderr;\n return null;\n }\n if (header !== 'OK') throw new Error('Invalid confined file header');\n } catch (cause) {\n await reader.cancel().catch(() => undefined);\n await process.kill().catch(() => undefined);\n await stderr.catch(() => undefined);\n throw cause;\n }\n const first = buffered.subarray(newline + 1);\n return new ReadableStream<Uint8Array>({\n start: (controller) => {\n if (first.length > 0) controller.enqueue(first);\n },\n pull: async (controller) => {\n try {\n const next = await reader.read();\n if (!next.done) {\n controller.enqueue(next.value);\n return;\n }\n const result = await process.wait();\n await stderr;\n if (result.exitCode !== 0) controller.error(new Error('Confined file read failed'));\n else controller.close();\n } catch (cause) {\n await reader.cancel().catch(() => undefined);\n await process.kill().catch(() => undefined);\n await stderr.catch(() => undefined);\n controller.error(cause);\n }\n },\n cancel: async () => {\n await reader.cancel().catch(() => undefined);\n await process.kill().catch(() => undefined);\n await stderr.catch(() => undefined);\n },\n });\n};\n\n// Bind the fixed read scripts before narrowing the public process capability.\nexport const createConfinedFileReader = (\n sandbox: Pick<SandboxSessionIface, 'run' | 'spawn'>,\n): ConfinedSandboxFilesIface => ({\n readFile: (options) => confinedReadFile(sandbox, options),\n stat: (options) => confinedStat(sandbox, options),\n readDir: (options) => confinedReadDir(sandbox, options),\n});\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,36 @@
1
+ import type { NetworkSandboxSessionIface } from "./types.mjs";
2
+ export declare const hasSandboxExecutionGuard: (sandbox: NetworkSandboxSessionIface) => boolean;
3
+ export declare enum SandboxExecutionOperation {
4
+ Run = "run",
5
+ Spawn = "spawn",
6
+ ProcessInput = "processInput",
7
+ WriteFile = "writeFile",
8
+ WriteTextFile = "writeTextFile",
9
+ WriteBinaryFile = "writeBinaryFile",
10
+ RemovePath = "removePath",
11
+ SetNetworkPolicy = "setNetworkPolicy",
12
+ Egress = "egress",
13
+ PortEndpoint = "portEndpoint",
14
+ Screen = "screen",
15
+ ComputerUse = "computerUse",
16
+ LocalMcp = "localMcp",
17
+ Mcp = "mcp",
18
+ Editor = "editor"
19
+ }
20
+ export interface SandboxExecutionContextIface {
21
+ operation: SandboxExecutionOperation;
22
+ background: boolean;
23
+ abortSignal?: AbortSignal;
24
+ }
25
+ export interface SandboxExecutionGuardOptionsIface<S extends NetworkSandboxSessionIface> {
26
+ sandbox: S;
27
+ fetch?: typeof globalThis.fetch;
28
+ beforeExecution: (context: SandboxExecutionContextIface) => Promise<void>;
29
+ }
30
+ export declare const sandboxForExecutionMapping: <S extends NetworkSandboxSessionIface>(sandbox: S) => S;
31
+ export declare const withSandboxExecutionGuard: <S extends NetworkSandboxSessionIface>(options: SandboxExecutionGuardOptionsIface<S>) => S;
32
+ export declare const mapSandboxExecutionGuard: <S extends NetworkSandboxSessionIface>(options: {
33
+ sandbox: S;
34
+ original: S;
35
+ fetch?: typeof globalThis.fetch;
36
+ }) => S;