@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
package/README.md CHANGED
@@ -64,24 +64,6 @@ so a resumed sandbox redoes only what its attach lost, and passes secrets to
64
64
  process environments only. `describeSandbox` reports the real checkout paths,
65
65
  service URLs and commands.
66
66
 
67
- Sandbox networking is a composable extension. `SandboxNetworkingExtensionIface`
68
- owns policy persistence, controller setup, readiness and suspension; the sandbox
69
- provider supplies its Linux executor and provider firewall/lifecycle operations.
70
- `attachSandboxNetworking` installs an extension on a handle and defers workspace
71
- setup until admission succeeds. `withSandboxNetworking` supports providers that
72
- need to initialize the controller earlier. Both preserve host/provider execution
73
- policies and distinguish runtime detach from physical stop/delete. Reads and
74
- passive attachments never recover networking. A running handle can remain blocked
75
- for execution while its networking configuration is repaired.
76
-
77
- Validate extension workspace identities before changing provider policy. Save the
78
- original policy before fencing or booting, initialize the controller in the same
79
- namespace used by commands, then restore the outer policy through `afterGuard`.
80
- The extension must authorize every ongoing operation, including cached MCP access;
81
- a one-time startup check is insufficient. Custom `attach` implementations own
82
- equivalent admission, deferred setup and failure cleanup. Namespace-only adapters
83
- must disclose the startup traffic window when their provider cannot fence boot.
84
-
85
67
  Hosts pass `credentials` (`SandboxCredentialsIface`) on sandbox contexts:
86
68
  `secret({ secretRef })`, resolved in the sandbox's project. Providers that need a
87
69
  third-party key take `credential: { secretRef }` (`sandboxCredentialRefSchema`) in
@@ -127,9 +109,9 @@ Admission covers commands, process stdin, file mutations, network-policy updates
127
109
  screen acquisition and cached MCP channels. The callback receives the operation
128
110
  and a `background` flag for protocol maintenance; the flag is not an authorization
129
111
  grant. Reads and lifecycle cleanup remain available when execution is refused.
130
- Hosts must explicitly authorize SetNetworkPolicy and Egress operations to allow
131
- network repair while other execution is refused. Policies choose authorization; the generic SDK implements no Device
132
- or tunnel policy. Already-running processes and port grants need separate controls.
112
+ Hosts must explicitly authorize SetNetworkPolicy operations to allow network repair
113
+ while other execution is refused. Policies choose authorization. Already-running
114
+ processes and port grants need separate controls.
133
115
 
134
116
  Keep the raw session internal for trusted setup/controller work. Low-level hosts
135
117
  that construct handles without `defineSandboxProvider` use `createSandboxHandle`.
@@ -144,18 +126,17 @@ URL-backed MCP endpoints served through a host-owned transport; the provider's f
144
126
  retains ownership of its endpoints, with the host transport as a fallback. Pass the same transport to the MCP projection.
145
127
 
146
128
  Pass the complete keys from `sandboxMcpToolPolicyKeys` to `resolveSandboxToolPolicy`.
147
- Egress consent requires its canonical capability/action keys; arbitrary hosted
148
- tools can use the same display name and must retain their ordinary tool policy.
149
- 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. A grant without `shell` cannot change network policy, including with lifecycle authority. Handle RPC
150
- hosts must supply `authorizeOperation` for Configure/Disable; without it mutations
151
- are refused. The host owns approval policy, including any explicit preauthorization.
129
+ Hosted tools that share a built-in name keep their ordinary tool policy and cannot
130
+ borrow a built-in Allow. A grant without `shell` cannot change network policy,
131
+ including with lifecycle authority. The host owns approval policy, including any
132
+ explicit preauthorization.
152
133
 
153
134
  Policies turn URL-backed MCP into checked message channels. Handle RPC servers
154
135
  serving policy-protected sessions must enable `mcpChannels`; clients must support
155
136
  the channel protocol, or use the MCP projection. Legacy RPC clients do not get
156
137
  unguarded URL endpoints; attempts receive an explicit negotiation error.
157
138
 
158
- 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.
139
+ 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; audit-only hooks must delegate to an authorization policy.
159
140
 
160
141
  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.
161
142
 
@@ -196,7 +177,7 @@ belong to harnesses.
196
177
 
197
178
  A channel declares the provider application it needs in `require.app`: an OAuth client and named secret slots (a signing secret, an app-level token). A channel app satisfies it, either the installer's own or one the channel's publisher attached to the publication; an install whose app cannot meet the declaration is refused. App credentials stay with the host in every execution mode. `credentials.client()` exposes only the public client ID; `verify({ secret })` checks a signed payload with a slot's key without returning it. `exchange()` returns an opaque, short-lived OAuth credential handle. Select that handle, a provider tenant's installed token (`{ kind: 'app', tenant }`) or a secret slot (`{ kind: 'secret', slot }`) with `credentials.fetch`'s `credential` option; requests default to no credential. `credentials.connect()` supports host-injected credentials in outgoing JSON socket frames. Hosts enforce the same destination and grant checks for all these operations. `secret(slot)` reads only slots the channel declares. Sockets accept bounded caller-owned headers for provider handshakes. Exchange handles are invocation-scoped and expire; they do not provide durable person-token storage or automatic refresh. An application's authorization callback must use provider APIs that can establish the current person's access.
198
179
 
199
- A provider tenant (a workspace, a server) installs the app through the channel's own code. `tenants.installPath` names a GET route that receives a single-use `ticket`; it calls `credentials.redirect({ path, ticket })`, and the redirect route calls `credentials.exchange({ ..., store: { tenant } })`, which stores the token as that tenant's install. A tenant belongs to one install of an app at a time: a later install takes it over. Routes marked `shared: true` are also served at the app's shared ingress URL, one URL per app registered with the provider once. The publication the app routes its ingress through declares `ingress.tenantOf`, which verifies each request with app-only credentials and returns the tenant, a direct `respond` for app-level handshakes, or null to reject it; the host then runs the shared route of the binding that holds that tenant.
180
+ A provider tenant (a workspace, a server) installs the app through the channel's own code. `tenants.installPath` names a GET route that receives a single-use `ticket`; it calls `credentials.redirect({ path, ticket })`, and the redirect route calls `credentials.exchange({ ..., store: { tenant } })`, which stores the token as that tenant's install (`store: { tenantPath }` reads the tenant from the token response when the provider names it only there). A tenant belongs to one install of an app at a time: a later install takes it over. Routes marked `shared: true` are also served at the app's shared ingress URL, one URL per app registered with the provider once. The publication the app routes its ingress through declares `ingress.tenantOf`, which verifies each request with app-only credentials and returns the tenant, a direct `respond` for app-level handshakes, or null to reject it; the host then runs the shared route of the binding that holds that tenant.
200
181
 
201
182
  `binding.url` is the host's canonical binding base URL for routes. Provider settings must not hold it when an application serves more than one binding. For OAuth, declare the callback route with `redirect: true` and call `credentials.redirect({ path })`: the returned `url` is the same for every binding, so an application registers it once, and `state` returns the person to this binding. Send both unchanged, and use the same `url` in the token exchange. A `redirect` route must be a GET and is reachable only through that URL. A channel is published as one self-contained module; naming an installed implementation does not grant additional authority. `resources.resolve` maps an application URL to a canonical provider place; the required companion `resources.authorize` checks the linked person's current provider access. Hosts repeat that authorization for later observation access. `places.follow` and `unfollow` manage observation under a linked person's authority, while `places.observers` enumerates authorized deliveries.
202
183
 
@@ -159,6 +159,8 @@ export interface ChannelOAuthExchangeOptionsIface {
159
159
  signal?: AbortSignal;
160
160
  store?: {
161
161
  tenant: string;
162
+ } | {
163
+ tenantPath: string[];
162
164
  };
163
165
  }
164
166
  export interface ChannelRedirectOptionsIface {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/channel.ts"],
4
- "sourcesContent": ["import type { ContentBlock } from '@agentclientprotocol/sdk/experimental/v2';\nimport * as z from 'zod';\nimport { jsonObjectSchema, type JsonObject, type JsonValue } from \"./json.mjs\";\nimport type { ChannelSemanticDataByKindIface } from \"./semantic-events.mjs\";\n\n// Handles carry no authority until the platform validates their binding and invocation signature.\nexport const personHandleSchema = z.string().min(1).brand<'ChannelPerson'>();\nexport const conversationHandleSchema = z.string().min(1).brand<'ChannelConversation'>();\nexport type PersonHandle = z.infer<typeof personHandleSchema>;\nexport type ConversationHandle = z.infer<typeof conversationHandleSchema>;\n\nexport const principalRefSchema = z.object({\n id: z.string().min(1),\n tenant: z.string().min(1).optional(),\n displayName: z.string().optional(),\n});\nexport type PrincipalRef = z.infer<typeof principalRefSchema>;\nexport interface PlaceRef {\n kind: string;\n id: string;\n tenant?: string;\n parent?: PlaceRef;\n title?: string;\n}\nexport const placeRefSchema: z.ZodType<PlaceRef> = z.lazy(() =>\n z.object({\n kind: z.string().min(1),\n id: z.string().min(1),\n tenant: z.string().min(1).optional(),\n parent: placeRefSchema.optional(),\n title: z.string().optional(),\n }),\n);\nexport interface OriginIface {\n place: PlaceRef;\n ref?: JsonObject;\n}\nexport const originSchema = z.object({ place: placeRefSchema, ref: jsonObjectSchema.optional() });\n\nexport type PersonResolution =\n | { kind: 'member'; person: PersonHandle; displayName: string }\n // `linkUrl` is the installer's link page for this person, when the install has one; without\n // it, the channel tells the person how to link in its own words.\n | { kind: 'unlinked'; linkUrl?: string }\n | { kind: 'blocked'; reason: 'not-a-member' | 'suspended' };\nexport enum ChannelReplies {\n Origin = 'origin',\n All = 'all',\n}\nexport enum ChannelAudience {\n Members = 'members',\n Anyone = 'anyone',\n}\nexport enum ChannelCreate {\n DirectWithAgent = 'direct-with-agent',\n Group = 'group',\n}\nexport const placePolicySchema = z.object({\n replies: z.nativeEnum(ChannelReplies),\n audience: z.nativeEnum(ChannelAudience),\n});\nexport interface PlacePolicy {\n replies: ChannelReplies | `${ChannelReplies}`;\n audience: ChannelAudience | `${ChannelAudience}`;\n}\nexport interface PlaceDefaultsIface extends PlacePolicy {\n create: ChannelCreate | `${ChannelCreate}`;\n}\nexport type PlaceResolution =\n | { kind: 'connected'; conversation: ConversationHandle; policy: PlacePolicy }\n // `connectUrl` is the installer's connect page for this place, when the install has one.\n | { kind: 'unconnected'; connectUrl?: string; defaults: PlaceDefaultsIface | null };\nexport interface Refusal {\n refused: 'unlinked' | 'no-access' | 'unconnected' | 'not-audience';\n linkUrl?: string;\n connectUrl?: string;\n message: string;\n}\nexport type ChannelReceiveResult =\n | { accepted: true }\n | { accepted: false; refusal: Refusal }\n | { ignored: true; reason: string };\nexport const refusalSchema = z.object({\n refused: z.union([\n z.literal('unlinked'),\n z.literal('no-access'),\n z.literal('unconnected'),\n z.literal('not-audience'),\n ]),\n linkUrl: z.string().optional(),\n connectUrl: z.string().optional(),\n message: z.string(),\n});\nexport const channelReceiveResultSchema = z.union([\n z.object({ accepted: z.literal(true) }),\n z.object({ accepted: z.literal(false), refusal: refusalSchema }),\n z.object({ ignored: z.literal(true), reason: z.string() }),\n]);\nexport enum ChannelCredentialKind {\n // A provider tenant's token, stored when the tenant installed the channel's app.\n App = 'app',\n // A secret slot of the channel's app, injected without the channel reading it.\n Secret = 'secret',\n OAuth = 'oauth',\n None = 'none',\n}\nexport const channelCredentialHandleSchema = z.string().min(1).brand<'ChannelCredential'>();\nexport type ChannelCredentialHandle = z.infer<typeof channelCredentialHandleSchema>;\nexport type ChannelCredentialRef =\n | { kind: ChannelCredentialKind.App; tenant: string }\n // `scheme` is the Authorization scheme the secret is sent with (`Bearer` when omitted). Frame\n // injection writes the bare value.\n | { kind: ChannelCredentialKind.Secret; slot: string; scheme?: string }\n | { kind: ChannelCredentialKind.OAuth; handle: ChannelCredentialHandle }\n | { kind: ChannelCredentialKind.None };\nexport enum ChannelSigningAlgorithm {\n HmacSha256 = 'hmac-sha256',\n HmacSha1 = 'hmac-sha1',\n Ed25519 = 'ed25519',\n}\nexport enum ChannelSignatureEncoding {\n Hex = 'hex',\n Base64 = 'base64',\n}\nexport enum ChannelOAuthClientAuthentication {\n Body = 'body',\n Basic = 'basic',\n None = 'none',\n}\nexport interface ChannelCredentialRequestInitIface extends RequestInit {\n credential?: ChannelCredentialRef;\n}\nexport interface ChannelVerifyOptionsIface {\n // The app secret slot holding the signing secret or public key; its value is never read.\n secret: string;\n algorithm: ChannelSigningAlgorithm;\n encoding: ChannelSignatureEncoding;\n data: string;\n signature: string;\n}\nexport interface ChannelOAuthExchangeOptionsIface {\n url: string;\n parameters: Record<string, string>;\n authentication: ChannelOAuthClientAuthentication;\n clientId?: string;\n signal?: AbortSignal;\n // Stores the token as this provider tenant's install of the channel's app. Honoured only in a\n // redirect route whose state carries an unused tenant-install ticket for this binding.\n store?: { tenant: string };\n}\nexport interface ChannelRedirectOptionsIface {\n // A GET route of this channel declared with `redirect: true`.\n path: string;\n // A tenant-install ticket the install route received; it is bound into the signed state.\n ticket?: string;\n}\nexport interface ChannelRedirectIface {\n url: string;\n state: string;\n}\nexport interface ChannelCredentialConnectOptionsIface {\n url: string;\n signal?: AbortSignal;\n}\nexport interface ChannelCredentialInjectionIface {\n path: string[];\n credential: ChannelCredentialRef;\n}\nexport interface ChannelCredentialSocketIface {\n messages: AsyncIterable<string | Uint8Array>;\n send(\n data: string | Uint8Array,\n options?: { inject?: ChannelCredentialInjectionIface[] },\n ): Promise<void>;\n close(code?: number, reason?: string): Promise<void>;\n closeCode(): number | null;\n}\nexport interface ChannelCredentialsIface {\n // The channel app's credentials stay with the host in every execution mode.\n client(): Promise<{ clientId: string }>;\n verify(args: ChannelVerifyOptionsIface): Promise<boolean>;\n exchange(args: ChannelOAuthExchangeOptionsIface): Promise<ChannelCredentialHandle>;\n // Send `url` as the OAuth redirect URI and `state` unchanged. `url` is the same for every\n // binding, so a provider application registers it once; `state` returns to this binding.\n redirect(args: ChannelRedirectOptionsIface): Promise<ChannelRedirectIface>;\n // Requests without an explicit credential are unauthenticated.\n fetch(input: RequestInfo | URL, init?: ChannelCredentialRequestInitIface): Promise<Response>;\n connect(args: ChannelCredentialConnectOptionsIface): Promise<ChannelCredentialSocketIface>;\n // The value of an app secret slot the channel declares in `require.app.secrets`; null for any\n // other slot.\n secret(slot: string): Promise<string | null>;\n}\nexport interface ChannelPostArgsIface {\n from: PersonHandle;\n content: ContentBlock[];\n context?: string[];\n origin: OriginIface;\n idempotencyKey: string;\n waitForAcceptance?: boolean;\n}\nexport interface ChannelConversationIface {\n post(args: ChannelPostArgsIface): Promise<{ messageId: string; turnId?: string } | Refusal>;\n input(args: {\n label: string;\n principal?: PrincipalRef;\n // The linked person the agent's turn acts for; with nobody, the input waits for the\n // running turn.\n actingAs?: PersonHandle;\n // False when the agent should reply only if it has something to say. Default true.\n replyExpected?: boolean;\n content: ContentBlock[];\n context?: string[];\n origin: OriginIface;\n idempotencyKey: string;\n waitForAcceptance?: boolean;\n }): Promise<{ inputId: string; turnId?: string } | Refusal>;\n attach(args: {\n origin: OriginIface;\n content: ContentBlock[];\n label: string;\n idempotencyKey: string;\n from?: PersonHandle;\n }): Promise<{ messageId: string } | Refusal>;\n edit(args: {\n externalKey: string;\n by: PersonHandle;\n content: ContentBlock[];\n }): Promise<{ messageId: string } | Refusal>;\n remove(args: { externalKey: string; by: PersonHandle }): Promise<{ removed: boolean } | Refusal>;\n react(args: {\n target: { externalKey: string } | { replyOf: { externalKey: string; turnId: string } };\n emoji: string;\n by: PersonHandle;\n op: 'add' | 'remove';\n }): Promise<{ ok: true } | Refusal>;\n}\nexport type SemanticEvent = {\n [Kind in keyof ChannelSemanticDataByKindIface]: {\n type: Kind;\n data: ChannelSemanticDataByKindIface[Kind];\n seq: number;\n };\n}[keyof ChannelSemanticDataByKindIface];\nexport interface ChannelReceiveContextIface<Config = JsonObject> {\n binding: {\n id: string;\n url: string;\n // The project the install belongs to.\n projectId: string;\n };\n config: Config;\n credentials: ChannelCredentialsIface;\n people: {\n resolve(principal: PrincipalRef): Promise<PersonResolution>;\n identify(person: PersonHandle): Promise<PrincipalRef | null>;\n // Tenant-wide uninstall/revocation also disconnects that tenant's places.\n revoke(args: {\n principal?: PrincipalRef;\n tenant?: string;\n reason: 'deactivated' | 'uninstalled' | 'provider-revoked';\n }): Promise<void>;\n confirm(args: { ticket: string; principal: PrincipalRef }): Promise<{ linked: true } | Refusal>;\n };\n places: {\n // Explicit anyone/group defaults may create a Shared chat while resolving a new place.\n resolve(place: PlaceRef): Promise<PlaceResolution>;\n observers(place: PlaceRef): Promise<ConversationHandle[]>;\n connect(\n place: PlaceRef,\n to: {\n by: PersonHandle;\n conversation?: ConversationHandle;\n create?: ChannelCreate | `${ChannelCreate}`;\n },\n ): Promise<ConversationHandle>;\n disconnect(place: PlaceRef, by: PersonHandle): Promise<void>;\n follow(\n place: PlaceRef,\n args: { by: PersonHandle; conversation: ConversationHandle; ttlSeconds?: number },\n ): Promise<void>;\n unfollow(\n place: PlaceRef,\n args: { by: PersonHandle; conversation: ConversationHandle },\n ): Promise<void>;\n };\n conversation(handle: ConversationHandle): ChannelConversationIface;\n observe(\n handle: ConversationHandle,\n args: { turnId: string; signal?: AbortSignal },\n ): AsyncIterable<SemanticEvent>;\n decisions: {\n resolve(args: {\n decisionId: string;\n outcome: JsonValue;\n by: PersonHandle;\n }): Promise<{ resolved: boolean } | Refusal>;\n };\n turns: {\n cancel(args: {\n conversation: ConversationHandle;\n by?: PersonHandle;\n turnId?: string;\n }): Promise<{ accepted: boolean } | Refusal>;\n };\n store: {\n get(key: string): Promise<JsonValue | null>;\n set(key: string, value: JsonValue | null, options?: { ttlSeconds?: number }): Promise<void>;\n };\n log(message: string, details?: JsonObject): void;\n}\nexport interface ChannelSocketIface {\n readonly signal: AbortSignal;\n readonly messages: AsyncIterable<string | Uint8Array>;\n // Authenticate the request before accepting. The selected protocol must have been offered.\n accept(options?: { protocol?: string }): void;\n send(data: string | Uint8Array): void;\n close(code?: number, reason?: string): void;\n}\n// State starts null and persists for the callbacks of one turn.\nexport interface ChannelTurnStateIface<State> {\n get(): State | null;\n set(state: State | null): void;\n}\nexport interface ChannelEventContextIface<Config = JsonObject, State = JsonValue> extends Pick<\n ChannelReceiveContextIface<Config>,\n 'binding' | 'config' | 'credentials' | 'store' | 'log'\n> {\n origin: OriginIface;\n conversation: ConversationHandle;\n turn: { id: string; agent: { displayName: string } };\n state: ChannelTurnStateIface<State>;\n}\nexport interface ChannelRouteContextIface<\n Config = JsonObject,\n> extends ChannelReceiveContextIface<Config> {\n request: Request;\n receive(input: JsonValue): Promise<ChannelReceiveResult>;\n}\nexport interface HttpChannelRouteDefinitionIface<Config = JsonObject> {\n method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n path: string;\n // Served only for a provider returning with `credentials.redirect` state.\n redirect?: boolean;\n // Also served at the app's shared ingress URL, for the binding `ingress.tenantOf` picks.\n shared?: boolean;\n handler(args: ChannelRouteContextIface<Config>): Promise<Response>;\n}\nexport interface WebSocketChannelRouteDefinitionIface<Config = JsonObject> {\n method: 'WS';\n path: string;\n handler(\n args: ChannelRouteContextIface<Config> & { socket: ChannelSocketIface },\n ): Promise<Response | void>;\n}\nexport type RouteDefinitionIface<Config = JsonObject> =\n | HttpChannelRouteDefinitionIface<Config>\n | WebSocketChannelRouteDefinitionIface<Config>;\nexport type ChannelEventHandlersIface<Config, State> = {\n [Kind in keyof ChannelSemanticDataByKindIface]?: (\n data: ChannelSemanticDataByKindIface[Kind],\n ctx: ChannelEventContextIface<Config, State>,\n ) => Promise<void>;\n};\nexport type ChannelEventKind = keyof ChannelSemanticDataByKindIface;\n\n// Provider application credentials the channel needs, satisfied by a channel app: the install's\n// own, or the one the channel's publisher attached.\nexport interface ChannelAppRequirementIface {\n description: string;\n oauthClient?: { description: string; optional?: boolean };\n // Secret slots, by name (a signing secret, an app-level token).\n secrets?: Record<string, { description: string; optional?: boolean }>;\n}\nexport interface ChannelRequireIface {\n app?: ChannelAppRequirementIface;\n}\nexport interface ChannelIngressContextIface {\n app: { id: string };\n credentials: Pick<ChannelCredentialsIface, 'verify' | 'secret' | 'client'>;\n log(message: string, details?: JsonObject): void;\n}\nexport interface ChannelIngressIface {\n // Reads which provider tenant a request to the app's shared ingress URL is for, after verifying\n // it. `respond` answers an app-level request (a URL handshake) with no binding; null rejects it.\n tenantOf(\n request: Request,\n ctx: ChannelIngressContextIface,\n ): Promise<{ tenant: string } | { respond: Response } | null>;\n}\nexport interface ChannelDefinitionIface<\n Config = JsonObject,\n Inbound = JsonValue,\n State = JsonValue,\n> {\n name: string;\n config?: Config;\n configure?(config: Config): ChannelDefinitionIface<Config, Inbound, State>;\n require?: ChannelRequireIface;\n // A GET route that starts the provider's app install for a tenant; it receives `ticket`.\n tenants?: { installPath: string };\n // Present on the publication an app routes its shared ingress through.\n ingress?: ChannelIngressIface;\n identity:\n | {\n kind: 'redirect';\n start(\n args: { ticket: string; principal: PrincipalRef },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<URL>;\n }\n | {\n kind: 'challenge';\n deliver(\n args: { principal: PrincipalRef; code: string },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<void>;\n }\n | { kind: 'none' };\n places: { kinds: readonly string[]; defaults?(place: PlaceRef): PlaceDefaultsIface | null };\n resources?: {\n authorize(\n args: { place: PlaceRef; principal: PrincipalRef },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<boolean>;\n resolve(\n args: { url: string; principal: PrincipalRef },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<PlaceRef | null>;\n };\n routes?: RouteDefinitionIface<Config>[];\n listeners?: {\n key: string;\n run(ctx: ChannelReceiveContextIface<Config> & { signal: AbortSignal }): Promise<void>;\n }[];\n receive(input: Inbound, ctx: ChannelReceiveContextIface<Config>): Promise<ChannelReceiveResult>;\n events?: ChannelEventHandlersIface<Config, State>;\n}\nexport const defineChannel = <Config = JsonObject, Inbound = JsonValue, State = JsonValue>(\n definition: ChannelDefinitionIface<Config, Inbound, State>,\n): ChannelDefinitionIface<Config, Inbound, State> => definition;\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import type { ContentBlock } from '@agentclientprotocol/sdk/experimental/v2';\nimport * as z from 'zod';\nimport { jsonObjectSchema, type JsonObject, type JsonValue } from \"./json.mjs\";\nimport type { ChannelSemanticDataByKindIface } from \"./semantic-events.mjs\";\n\n// Handles carry no authority until the platform validates their binding and invocation signature.\nexport const personHandleSchema = z.string().min(1).brand<'ChannelPerson'>();\nexport const conversationHandleSchema = z.string().min(1).brand<'ChannelConversation'>();\nexport type PersonHandle = z.infer<typeof personHandleSchema>;\nexport type ConversationHandle = z.infer<typeof conversationHandleSchema>;\n\nexport const principalRefSchema = z.object({\n id: z.string().min(1),\n tenant: z.string().min(1).optional(),\n displayName: z.string().optional(),\n});\nexport type PrincipalRef = z.infer<typeof principalRefSchema>;\nexport interface PlaceRef {\n kind: string;\n id: string;\n tenant?: string;\n parent?: PlaceRef;\n title?: string;\n}\nexport const placeRefSchema: z.ZodType<PlaceRef> = z.lazy(() =>\n z.object({\n kind: z.string().min(1),\n id: z.string().min(1),\n tenant: z.string().min(1).optional(),\n parent: placeRefSchema.optional(),\n title: z.string().optional(),\n }),\n);\nexport interface OriginIface {\n place: PlaceRef;\n ref?: JsonObject;\n}\nexport const originSchema = z.object({ place: placeRefSchema, ref: jsonObjectSchema.optional() });\n\nexport type PersonResolution =\n | { kind: 'member'; person: PersonHandle; displayName: string }\n // `linkUrl` is the installer's link page for this person, when the install has one; without\n // it, the channel tells the person how to link in its own words.\n | { kind: 'unlinked'; linkUrl?: string }\n | { kind: 'blocked'; reason: 'not-a-member' | 'suspended' };\nexport enum ChannelReplies {\n Origin = 'origin',\n All = 'all',\n}\nexport enum ChannelAudience {\n Members = 'members',\n Anyone = 'anyone',\n}\nexport enum ChannelCreate {\n DirectWithAgent = 'direct-with-agent',\n Group = 'group',\n}\nexport const placePolicySchema = z.object({\n replies: z.nativeEnum(ChannelReplies),\n audience: z.nativeEnum(ChannelAudience),\n});\nexport interface PlacePolicy {\n replies: ChannelReplies | `${ChannelReplies}`;\n audience: ChannelAudience | `${ChannelAudience}`;\n}\nexport interface PlaceDefaultsIface extends PlacePolicy {\n create: ChannelCreate | `${ChannelCreate}`;\n}\nexport type PlaceResolution =\n | { kind: 'connected'; conversation: ConversationHandle; policy: PlacePolicy }\n // `connectUrl` is the installer's connect page for this place, when the install has one.\n | { kind: 'unconnected'; connectUrl?: string; defaults: PlaceDefaultsIface | null };\nexport interface Refusal {\n refused: 'unlinked' | 'no-access' | 'unconnected' | 'not-audience';\n linkUrl?: string;\n connectUrl?: string;\n message: string;\n}\nexport type ChannelReceiveResult =\n | { accepted: true }\n | { accepted: false; refusal: Refusal }\n | { ignored: true; reason: string };\nexport const refusalSchema = z.object({\n refused: z.union([\n z.literal('unlinked'),\n z.literal('no-access'),\n z.literal('unconnected'),\n z.literal('not-audience'),\n ]),\n linkUrl: z.string().optional(),\n connectUrl: z.string().optional(),\n message: z.string(),\n});\nexport const channelReceiveResultSchema = z.union([\n z.object({ accepted: z.literal(true) }),\n z.object({ accepted: z.literal(false), refusal: refusalSchema }),\n z.object({ ignored: z.literal(true), reason: z.string() }),\n]);\nexport enum ChannelCredentialKind {\n // A provider tenant's token, stored when the tenant installed the channel's app.\n App = 'app',\n // A secret slot of the channel's app, injected without the channel reading it.\n Secret = 'secret',\n OAuth = 'oauth',\n None = 'none',\n}\nexport const channelCredentialHandleSchema = z.string().min(1).brand<'ChannelCredential'>();\nexport type ChannelCredentialHandle = z.infer<typeof channelCredentialHandleSchema>;\nexport type ChannelCredentialRef =\n | { kind: ChannelCredentialKind.App; tenant: string }\n // `scheme` is the Authorization scheme the secret is sent with (`Bearer` when omitted). Frame\n // injection writes the bare value.\n | { kind: ChannelCredentialKind.Secret; slot: string; scheme?: string }\n | { kind: ChannelCredentialKind.OAuth; handle: ChannelCredentialHandle }\n | { kind: ChannelCredentialKind.None };\nexport enum ChannelSigningAlgorithm {\n HmacSha256 = 'hmac-sha256',\n HmacSha1 = 'hmac-sha1',\n Ed25519 = 'ed25519',\n}\nexport enum ChannelSignatureEncoding {\n Hex = 'hex',\n Base64 = 'base64',\n}\nexport enum ChannelOAuthClientAuthentication {\n Body = 'body',\n Basic = 'basic',\n None = 'none',\n}\nexport interface ChannelCredentialRequestInitIface extends RequestInit {\n credential?: ChannelCredentialRef;\n}\nexport interface ChannelVerifyOptionsIface {\n // The app secret slot holding the signing secret or public key; its value is never read.\n secret: string;\n algorithm: ChannelSigningAlgorithm;\n encoding: ChannelSignatureEncoding;\n data: string;\n signature: string;\n}\nexport interface ChannelOAuthExchangeOptionsIface {\n url: string;\n parameters: Record<string, string>;\n authentication: ChannelOAuthClientAuthentication;\n clientId?: string;\n signal?: AbortSignal;\n // Stores the token as this provider tenant's install of the channel's app. Honoured only in a\n // redirect route whose state carries an unused tenant-install ticket for this binding. A\n // provider that names the tenant only in its token response is read at `tenantPath` there.\n store?: { tenant: string } | { tenantPath: string[] };\n}\nexport interface ChannelRedirectOptionsIface {\n // A GET route of this channel declared with `redirect: true`.\n path: string;\n // A tenant-install ticket the install route received; it is bound into the signed state.\n ticket?: string;\n}\nexport interface ChannelRedirectIface {\n url: string;\n state: string;\n}\nexport interface ChannelCredentialConnectOptionsIface {\n url: string;\n signal?: AbortSignal;\n}\nexport interface ChannelCredentialInjectionIface {\n path: string[];\n credential: ChannelCredentialRef;\n}\nexport interface ChannelCredentialSocketIface {\n messages: AsyncIterable<string | Uint8Array>;\n send(\n data: string | Uint8Array,\n options?: { inject?: ChannelCredentialInjectionIface[] },\n ): Promise<void>;\n close(code?: number, reason?: string): Promise<void>;\n closeCode(): number | null;\n}\nexport interface ChannelCredentialsIface {\n // The channel app's credentials stay with the host in every execution mode.\n client(): Promise<{ clientId: string }>;\n verify(args: ChannelVerifyOptionsIface): Promise<boolean>;\n exchange(args: ChannelOAuthExchangeOptionsIface): Promise<ChannelCredentialHandle>;\n // Send `url` as the OAuth redirect URI and `state` unchanged. `url` is the same for every\n // binding, so a provider application registers it once; `state` returns to this binding.\n redirect(args: ChannelRedirectOptionsIface): Promise<ChannelRedirectIface>;\n // Requests without an explicit credential are unauthenticated.\n fetch(input: RequestInfo | URL, init?: ChannelCredentialRequestInitIface): Promise<Response>;\n connect(args: ChannelCredentialConnectOptionsIface): Promise<ChannelCredentialSocketIface>;\n // The value of an app secret slot the channel declares in `require.app.secrets`; null for any\n // other slot.\n secret(slot: string): Promise<string | null>;\n}\nexport interface ChannelPostArgsIface {\n from: PersonHandle;\n content: ContentBlock[];\n context?: string[];\n origin: OriginIface;\n idempotencyKey: string;\n waitForAcceptance?: boolean;\n}\nexport interface ChannelConversationIface {\n post(args: ChannelPostArgsIface): Promise<{ messageId: string; turnId?: string } | Refusal>;\n input(args: {\n label: string;\n principal?: PrincipalRef;\n // The linked person the agent's turn acts for; with nobody, the input waits for the\n // running turn.\n actingAs?: PersonHandle;\n // False when the agent should reply only if it has something to say. Default true.\n replyExpected?: boolean;\n content: ContentBlock[];\n context?: string[];\n origin: OriginIface;\n idempotencyKey: string;\n waitForAcceptance?: boolean;\n }): Promise<{ inputId: string; turnId?: string } | Refusal>;\n attach(args: {\n origin: OriginIface;\n content: ContentBlock[];\n label: string;\n idempotencyKey: string;\n from?: PersonHandle;\n }): Promise<{ messageId: string } | Refusal>;\n edit(args: {\n externalKey: string;\n by: PersonHandle;\n content: ContentBlock[];\n }): Promise<{ messageId: string } | Refusal>;\n remove(args: { externalKey: string; by: PersonHandle }): Promise<{ removed: boolean } | Refusal>;\n react(args: {\n target: { externalKey: string } | { replyOf: { externalKey: string; turnId: string } };\n emoji: string;\n by: PersonHandle;\n op: 'add' | 'remove';\n }): Promise<{ ok: true } | Refusal>;\n}\nexport type SemanticEvent = {\n [Kind in keyof ChannelSemanticDataByKindIface]: {\n type: Kind;\n data: ChannelSemanticDataByKindIface[Kind];\n seq: number;\n };\n}[keyof ChannelSemanticDataByKindIface];\nexport interface ChannelReceiveContextIface<Config = JsonObject> {\n binding: {\n id: string;\n url: string;\n // The project the install belongs to.\n projectId: string;\n };\n config: Config;\n credentials: ChannelCredentialsIface;\n people: {\n resolve(principal: PrincipalRef): Promise<PersonResolution>;\n identify(person: PersonHandle): Promise<PrincipalRef | null>;\n // Tenant-wide uninstall/revocation also disconnects that tenant's places.\n revoke(args: {\n principal?: PrincipalRef;\n tenant?: string;\n reason: 'deactivated' | 'uninstalled' | 'provider-revoked';\n }): Promise<void>;\n confirm(args: { ticket: string; principal: PrincipalRef }): Promise<{ linked: true } | Refusal>;\n };\n places: {\n // Explicit anyone/group defaults may create a Shared chat while resolving a new place.\n resolve(place: PlaceRef): Promise<PlaceResolution>;\n observers(place: PlaceRef): Promise<ConversationHandle[]>;\n connect(\n place: PlaceRef,\n to: {\n by: PersonHandle;\n conversation?: ConversationHandle;\n create?: ChannelCreate | `${ChannelCreate}`;\n },\n ): Promise<ConversationHandle>;\n disconnect(place: PlaceRef, by: PersonHandle): Promise<void>;\n follow(\n place: PlaceRef,\n args: { by: PersonHandle; conversation: ConversationHandle; ttlSeconds?: number },\n ): Promise<void>;\n unfollow(\n place: PlaceRef,\n args: { by: PersonHandle; conversation: ConversationHandle },\n ): Promise<void>;\n };\n conversation(handle: ConversationHandle): ChannelConversationIface;\n observe(\n handle: ConversationHandle,\n args: { turnId: string; signal?: AbortSignal },\n ): AsyncIterable<SemanticEvent>;\n decisions: {\n resolve(args: {\n decisionId: string;\n outcome: JsonValue;\n by: PersonHandle;\n }): Promise<{ resolved: boolean } | Refusal>;\n };\n turns: {\n cancel(args: {\n conversation: ConversationHandle;\n by?: PersonHandle;\n turnId?: string;\n }): Promise<{ accepted: boolean } | Refusal>;\n };\n store: {\n get(key: string): Promise<JsonValue | null>;\n set(key: string, value: JsonValue | null, options?: { ttlSeconds?: number }): Promise<void>;\n };\n log(message: string, details?: JsonObject): void;\n}\nexport interface ChannelSocketIface {\n readonly signal: AbortSignal;\n readonly messages: AsyncIterable<string | Uint8Array>;\n // Authenticate the request before accepting. The selected protocol must have been offered.\n accept(options?: { protocol?: string }): void;\n send(data: string | Uint8Array): void;\n close(code?: number, reason?: string): void;\n}\n// State starts null and persists for the callbacks of one turn.\nexport interface ChannelTurnStateIface<State> {\n get(): State | null;\n set(state: State | null): void;\n}\nexport interface ChannelEventContextIface<Config = JsonObject, State = JsonValue> extends Pick<\n ChannelReceiveContextIface<Config>,\n 'binding' | 'config' | 'credentials' | 'store' | 'log'\n> {\n origin: OriginIface;\n conversation: ConversationHandle;\n turn: { id: string; agent: { displayName: string } };\n state: ChannelTurnStateIface<State>;\n}\nexport interface ChannelRouteContextIface<\n Config = JsonObject,\n> extends ChannelReceiveContextIface<Config> {\n request: Request;\n receive(input: JsonValue): Promise<ChannelReceiveResult>;\n}\nexport interface HttpChannelRouteDefinitionIface<Config = JsonObject> {\n method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n path: string;\n // Served only for a provider returning with `credentials.redirect` state.\n redirect?: boolean;\n // Also served at the app's shared ingress URL, for the binding `ingress.tenantOf` picks.\n shared?: boolean;\n handler(args: ChannelRouteContextIface<Config>): Promise<Response>;\n}\nexport interface WebSocketChannelRouteDefinitionIface<Config = JsonObject> {\n method: 'WS';\n path: string;\n handler(\n args: ChannelRouteContextIface<Config> & { socket: ChannelSocketIface },\n ): Promise<Response | void>;\n}\nexport type RouteDefinitionIface<Config = JsonObject> =\n | HttpChannelRouteDefinitionIface<Config>\n | WebSocketChannelRouteDefinitionIface<Config>;\nexport type ChannelEventHandlersIface<Config, State> = {\n [Kind in keyof ChannelSemanticDataByKindIface]?: (\n data: ChannelSemanticDataByKindIface[Kind],\n ctx: ChannelEventContextIface<Config, State>,\n ) => Promise<void>;\n};\nexport type ChannelEventKind = keyof ChannelSemanticDataByKindIface;\n\n// Provider application credentials the channel needs, satisfied by a channel app: the install's\n// own, or the one the channel's publisher attached.\nexport interface ChannelAppRequirementIface {\n description: string;\n oauthClient?: { description: string; optional?: boolean };\n // Secret slots, by name (a signing secret, an app-level token).\n secrets?: Record<string, { description: string; optional?: boolean }>;\n}\nexport interface ChannelRequireIface {\n app?: ChannelAppRequirementIface;\n}\nexport interface ChannelIngressContextIface {\n app: { id: string };\n credentials: Pick<ChannelCredentialsIface, 'verify' | 'secret' | 'client'>;\n log(message: string, details?: JsonObject): void;\n}\nexport interface ChannelIngressIface {\n // Reads which provider tenant a request to the app's shared ingress URL is for, after verifying\n // it. `respond` answers an app-level request (a URL handshake) with no binding; null rejects it.\n tenantOf(\n request: Request,\n ctx: ChannelIngressContextIface,\n ): Promise<{ tenant: string } | { respond: Response } | null>;\n}\nexport interface ChannelDefinitionIface<\n Config = JsonObject,\n Inbound = JsonValue,\n State = JsonValue,\n> {\n name: string;\n config?: Config;\n configure?(config: Config): ChannelDefinitionIface<Config, Inbound, State>;\n require?: ChannelRequireIface;\n // A GET route that starts the provider's app install for a tenant; it receives `ticket`.\n tenants?: { installPath: string };\n // Present on the publication an app routes its shared ingress through.\n ingress?: ChannelIngressIface;\n identity:\n | {\n kind: 'redirect';\n start(\n args: { ticket: string; principal: PrincipalRef },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<URL>;\n }\n | {\n kind: 'challenge';\n deliver(\n args: { principal: PrincipalRef; code: string },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<void>;\n }\n | { kind: 'none' };\n places: { kinds: readonly string[]; defaults?(place: PlaceRef): PlaceDefaultsIface | null };\n resources?: {\n authorize(\n args: { place: PlaceRef; principal: PrincipalRef },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<boolean>;\n resolve(\n args: { url: string; principal: PrincipalRef },\n ctx: ChannelReceiveContextIface<Config>,\n ): Promise<PlaceRef | null>;\n };\n routes?: RouteDefinitionIface<Config>[];\n listeners?: {\n key: string;\n run(ctx: ChannelReceiveContextIface<Config> & { signal: AbortSignal }): Promise<void>;\n }[];\n receive(input: Inbound, ctx: ChannelReceiveContextIface<Config>): Promise<ChannelReceiveResult>;\n events?: ChannelEventHandlersIface<Config, State>;\n}\nexport const defineChannel = <Config = JsonObject, Inbound = JsonValue, State = JsonValue>(\n definition: ChannelDefinitionIface<Config, Inbound, State>,\n): ChannelDefinitionIface<Config, Inbound, State> => definition;\n"],
5
+ "mappings": "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",
6
6
  "names": ["ChannelReplies", "ChannelAudience", "ChannelCreate", "ChannelCredentialKind", "ChannelSigningAlgorithm", "ChannelSignatureEncoding", "ChannelOAuthClientAuthentication"]
7
7
  }
@@ -638,9 +638,6 @@ const connectSandboxClient = async (args) => {
638
638
  await call(HandleRpcMethod.SetNetworkPolicy, policy);
639
639
  };
640
640
  }
641
- if (capabilities.includes(SandboxCapability.Egress)) {
642
- client.egress = (request) => call(HandleRpcMethod.Egress, request);
643
- }
644
641
  if (capabilities.includes(SandboxCapability.DurableProcesses))
645
642
  client.attachProcess = attachProcess;
646
643
  if (capabilities.includes(SandboxCapability.Workers)) client.startWorker = startWorker;
@@ -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 isSandboxWorkerEndpoint,\n SandboxCapability,\n type AbortableIface,\n type DirEntryIface,\n type McpChannelIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxAttachedProcessIface,\n type SandboxAttachProcessOptionsIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxWorkerOptionsIface,\n type SandboxWorkerStartType,\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 // On a sandbox provider's attach socket: the platform-identity assertion the\n // connection presents, sent in `initialize`. Asked again before every call;\n // when the answer changed, `identity/refresh` goes out first. `renew` asks\n // for a new one before the one in force expires.\n identity?: (args: { renew: boolean }) => Promise<string>;\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 // The assertion in force (`identity`), and the last identity sync, which calls wait on.\n identity: string | null;\n identitySync: Promise<void>;\n identityTimer: ReturnType<typeof setTimeout> | null;\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 // Sends `identity/refresh` when the assertion the caller hands out changed\n // (or, with `renew`, for a new one), one sync at a time per connection.\n // Calls on a process or MCP channel already open reuse the identity in force.\n const syncIdentity = (connection: ConnectionIface, renew: boolean): Promise<void> => {\n const identity = args.identity;\n if (identity == null) return Promise.resolve();\n const run = connection.identitySync.then(async () => {\n const assertion = await identity({ renew });\n if (assertion === connection.identity || connection.peer.isClosed()) return;\n const raw = await connection.peer.request(HandleRpcMethod.IdentityRefresh, { assertion });\n connection.identity = assertion;\n scheduleIdentityRenewal(\n connection,\n parseHandleRpcResult(HandleRpcMethod.IdentityRefresh, raw).expiresAt,\n );\n });\n connection.identitySync = run.catch(() => undefined);\n return run;\n };\n\n const scheduleIdentityRenewal = (connection: ConnectionIface, expiresAt: string | null) => {\n if (connection.identityTimer != null) clearTimeout(connection.identityTimer);\n connection.identityTimer = null;\n if (expiresAt == null || args.identity == 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 connection.identityTimer = setTimeout(\n () => {\n void syncIdentity(connection, true).catch(() => undefined);\n },\n Math.min(2_147_483_647, delay),\n );\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 if (connection.identityTimer != null) clearTimeout(connection.identityTimer);\n live.delete(connection);\n if (current === connection) current = null;\n },\n });\n try {\n const identity = args.identity == null ? null : await args.identity({ renew: false });\n const raw = await peer.request(HandleRpcMethod.Initialize, {\n handleRpcVersion: HANDLE_RPC_VERSION,\n token: target.token,\n ...(identity == null ? {} : { identity }),\n client: args.clientInfo,\n });\n const info = handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw);\n connection = {\n peer,\n target,\n info,\n nextStreamId: 1,\n identity,\n identitySync: Promise.resolve(),\n identityTimer: null,\n };\n live.add(connection);\n if (identity != null) scheduleIdentityRenewal(connection, info.expiresAt);\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 liveConnection = (): 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 // The connection for the next call, its identity brought up to date first\n // (before the call opens any stream, so stream chunks never precede it).\n const getConnection = async (): Promise<ConnectionIface> => {\n const connection = await liveConnection();\n await syncIdentity(connection, false);\n return connection;\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 // process/wait and process/kill for a served process. Aborting `abortSignal`\n // kills an ordinary process; a durable one is detached instead (process/detach):\n // its streams fail here and stop on the server, and it keeps running.\n const processControls = (args: {\n connection: ConnectionIface;\n processId: string;\n durable: boolean;\n streamIds: number[];\n abortSignal?: AbortSignal;\n }): Pick<SandboxProcessIface, 'wait' | 'kill'> => {\n const { connection, processId } = args;\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 const onAbort = () => {\n if (!args.durable) {\n void kill().catch(() => undefined);\n return;\n }\n for (const streamId of args.streamIds)\n connection.peer.streams.cancelIncoming(streamId, 'process handle detached');\n // Best effort: a closed connection already released it on the server.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n };\n args.abortSignal?.addEventListener('abort', onAbort, { once: true });\n if (args.abortSignal?.aborted === true) onAbort();\n return {\n wait: () => {\n waiting ??= requestOn(\n connection,\n HandleRpcMethod.ProcessWait,\n { processId },\n { signal: args.abortSignal },\n );\n return waiting;\n },\n kill,\n };\n };\n\n // A served process: `sandbox/spawn` or `sandbox/startWorker`, with the\n // streams and controls they share.\n const startProcess = async (args: {\n stdin: ReadableStream<Uint8Array> | string | undefined;\n durable: boolean | undefined;\n abortSignal: AbortSignal | undefined;\n request: (\n connection: ConnectionIface,\n streams: {\n processId: string;\n stdinStreamId: number;\n stdoutStreamId: number;\n stderrStreamId: number;\n durable?: true;\n },\n ) => Promise<HandleRpcResult<HandleRpcMethod.StartWorker>>;\n }): Promise<SandboxWorkerStartType> => {\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 (args.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (args.stdin instanceof ReadableStream) {\n stdinSource = args.stdin;\n } else {\n stdinSource = bytesToStream(utf8Encode(args.stdin));\n }\n connection.peer.streams.openOutgoing(stdinStreamId, stdinSource).catch(() => undefined);\n // Servers without the capability would ignore it; older ones do not know it.\n const durable =\n args.durable === true &&\n connection.info.capabilities.includes(SandboxCapability.DurableProcesses);\n let result: HandleRpcResult<HandleRpcMethod.StartWorker>;\n try {\n result = await args.request(connection, {\n processId,\n stdinStreamId,\n stdoutStreamId,\n stderrStreamId,\n ...(durable ? { durable: true } : {}),\n });\n } catch (error) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'start failed');\n throw error;\n }\n // A worker program serving its own endpoint: its streams carry nothing.\n if ('endpoint' in result) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'worker endpoint');\n return { endpoint: result.endpoint };\n }\n const ref = result.ref ?? null;\n const controls = processControls({\n connection,\n processId,\n durable: ref != null,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: args.abortSignal,\n });\n return {\n pid: result.pid,\n ref,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n // A detached handle is done with the process.\n if (ref != null) args.abortSignal?.throwIfAborted();\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 ...controls,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const started = await startProcess({\n stdin: options.stdin,\n durable: options.durable,\n abortSignal: options.abortSignal,\n request: (connection, streams) =>\n requestOn(connection, HandleRpcMethod.Spawn, {\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 ...streams,\n }),\n });\n if (isSandboxWorkerEndpoint(started))\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidRequest,\n message: 'sandbox/spawn answered with an endpoint',\n });\n return started;\n };\n\n const startWorker = (options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType> =>\n startProcess({\n stdin: undefined,\n durable: options.durable,\n abortSignal: options.abortSignal,\n request: (connection, streams) =>\n requestOn(connection, HandleRpcMethod.StartWorker, {\n program: options.program,\n env: options.env,\n input: options.input,\n ...(options.identity == null ? {} : { identity: options.identity }),\n ...streams,\n }),\n });\n\n const attachProcess = async (\n options: SandboxAttachProcessOptionsIface,\n ): Promise<SandboxAttachedProcessIface | null> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n const discard = () => {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n };\n let result: HandleRpcResult<HandleRpcMethod.ProcessAttach>;\n try {\n result = await requestOn(\n connection,\n HandleRpcMethod.ProcessAttach,\n {\n processId,\n ref: options.ref,\n stdoutOffset: options.stdoutOffset,\n stderrOffset: options.stderrOffset,\n stdoutStreamId,\n stderrStreamId,\n },\n { signal: options.abortSignal },\n );\n } catch (error) {\n discard();\n // The server may have attached it before the cancellation reached it.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n throw error;\n }\n if (!result.found) {\n discard();\n return null;\n }\n return {\n ref: options.ref,\n stdoutOffset: result.stdoutOffset,\n stderrOffset: result.stderrOffset,\n stdout,\n stderr,\n ...processControls({\n connection,\n processId,\n durable: true,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: options.abortSignal,\n }),\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.DurableProcesses))\n client.attachProcess = attachProcess;\n if (capabilities.includes(SandboxCapability.Workers)) client.startWorker = startWorker;\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 isSandboxWorkerEndpoint,\n SandboxCapability,\n type AbortableIface,\n type DirEntryIface,\n type McpChannelIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxAttachedProcessIface,\n type SandboxAttachProcessOptionsIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxWorkerOptionsIface,\n type SandboxWorkerStartType,\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 // On a sandbox provider's attach socket: the platform-identity assertion the\n // connection presents, sent in `initialize`. Asked again before every call;\n // when the answer changed, `identity/refresh` goes out first. `renew` asks\n // for a new one before the one in force expires.\n identity?: (args: { renew: boolean }) => Promise<string>;\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 // The assertion in force (`identity`), and the last identity sync, which calls wait on.\n identity: string | null;\n identitySync: Promise<void>;\n identityTimer: ReturnType<typeof setTimeout> | null;\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 // Sends `identity/refresh` when the assertion the caller hands out changed\n // (or, with `renew`, for a new one), one sync at a time per connection.\n // Calls on a process or MCP channel already open reuse the identity in force.\n const syncIdentity = (connection: ConnectionIface, renew: boolean): Promise<void> => {\n const identity = args.identity;\n if (identity == null) return Promise.resolve();\n const run = connection.identitySync.then(async () => {\n const assertion = await identity({ renew });\n if (assertion === connection.identity || connection.peer.isClosed()) return;\n const raw = await connection.peer.request(HandleRpcMethod.IdentityRefresh, { assertion });\n connection.identity = assertion;\n scheduleIdentityRenewal(\n connection,\n parseHandleRpcResult(HandleRpcMethod.IdentityRefresh, raw).expiresAt,\n );\n });\n connection.identitySync = run.catch(() => undefined);\n return run;\n };\n\n const scheduleIdentityRenewal = (connection: ConnectionIface, expiresAt: string | null) => {\n if (connection.identityTimer != null) clearTimeout(connection.identityTimer);\n connection.identityTimer = null;\n if (expiresAt == null || args.identity == 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 connection.identityTimer = setTimeout(\n () => {\n void syncIdentity(connection, true).catch(() => undefined);\n },\n Math.min(2_147_483_647, delay),\n );\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 if (connection.identityTimer != null) clearTimeout(connection.identityTimer);\n live.delete(connection);\n if (current === connection) current = null;\n },\n });\n try {\n const identity = args.identity == null ? null : await args.identity({ renew: false });\n const raw = await peer.request(HandleRpcMethod.Initialize, {\n handleRpcVersion: HANDLE_RPC_VERSION,\n token: target.token,\n ...(identity == null ? {} : { identity }),\n client: args.clientInfo,\n });\n const info = handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw);\n connection = {\n peer,\n target,\n info,\n nextStreamId: 1,\n identity,\n identitySync: Promise.resolve(),\n identityTimer: null,\n };\n live.add(connection);\n if (identity != null) scheduleIdentityRenewal(connection, info.expiresAt);\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 liveConnection = (): 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 // The connection for the next call, its identity brought up to date first\n // (before the call opens any stream, so stream chunks never precede it).\n const getConnection = async (): Promise<ConnectionIface> => {\n const connection = await liveConnection();\n await syncIdentity(connection, false);\n return connection;\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 // process/wait and process/kill for a served process. Aborting `abortSignal`\n // kills an ordinary process; a durable one is detached instead (process/detach):\n // its streams fail here and stop on the server, and it keeps running.\n const processControls = (args: {\n connection: ConnectionIface;\n processId: string;\n durable: boolean;\n streamIds: number[];\n abortSignal?: AbortSignal;\n }): Pick<SandboxProcessIface, 'wait' | 'kill'> => {\n const { connection, processId } = args;\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 const onAbort = () => {\n if (!args.durable) {\n void kill().catch(() => undefined);\n return;\n }\n for (const streamId of args.streamIds)\n connection.peer.streams.cancelIncoming(streamId, 'process handle detached');\n // Best effort: a closed connection already released it on the server.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n };\n args.abortSignal?.addEventListener('abort', onAbort, { once: true });\n if (args.abortSignal?.aborted === true) onAbort();\n return {\n wait: () => {\n waiting ??= requestOn(\n connection,\n HandleRpcMethod.ProcessWait,\n { processId },\n { signal: args.abortSignal },\n );\n return waiting;\n },\n kill,\n };\n };\n\n // A served process: `sandbox/spawn` or `sandbox/startWorker`, with the\n // streams and controls they share.\n const startProcess = async (args: {\n stdin: ReadableStream<Uint8Array> | string | undefined;\n durable: boolean | undefined;\n abortSignal: AbortSignal | undefined;\n request: (\n connection: ConnectionIface,\n streams: {\n processId: string;\n stdinStreamId: number;\n stdoutStreamId: number;\n stderrStreamId: number;\n durable?: true;\n },\n ) => Promise<HandleRpcResult<HandleRpcMethod.StartWorker>>;\n }): Promise<SandboxWorkerStartType> => {\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 (args.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (args.stdin instanceof ReadableStream) {\n stdinSource = args.stdin;\n } else {\n stdinSource = bytesToStream(utf8Encode(args.stdin));\n }\n connection.peer.streams.openOutgoing(stdinStreamId, stdinSource).catch(() => undefined);\n // Servers without the capability would ignore it; older ones do not know it.\n const durable =\n args.durable === true &&\n connection.info.capabilities.includes(SandboxCapability.DurableProcesses);\n let result: HandleRpcResult<HandleRpcMethod.StartWorker>;\n try {\n result = await args.request(connection, {\n processId,\n stdinStreamId,\n stdoutStreamId,\n stderrStreamId,\n ...(durable ? { durable: true } : {}),\n });\n } catch (error) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'start failed');\n throw error;\n }\n // A worker program serving its own endpoint: its streams carry nothing.\n if ('endpoint' in result) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'worker endpoint');\n return { endpoint: result.endpoint };\n }\n const ref = result.ref ?? null;\n const controls = processControls({\n connection,\n processId,\n durable: ref != null,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: args.abortSignal,\n });\n return {\n pid: result.pid,\n ref,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n // A detached handle is done with the process.\n if (ref != null) args.abortSignal?.throwIfAborted();\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 ...controls,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const started = await startProcess({\n stdin: options.stdin,\n durable: options.durable,\n abortSignal: options.abortSignal,\n request: (connection, streams) =>\n requestOn(connection, HandleRpcMethod.Spawn, {\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 ...streams,\n }),\n });\n if (isSandboxWorkerEndpoint(started))\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidRequest,\n message: 'sandbox/spawn answered with an endpoint',\n });\n return started;\n };\n\n const startWorker = (options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType> =>\n startProcess({\n stdin: undefined,\n durable: options.durable,\n abortSignal: options.abortSignal,\n request: (connection, streams) =>\n requestOn(connection, HandleRpcMethod.StartWorker, {\n program: options.program,\n env: options.env,\n input: options.input,\n ...(options.identity == null ? {} : { identity: options.identity }),\n ...streams,\n }),\n });\n\n const attachProcess = async (\n options: SandboxAttachProcessOptionsIface,\n ): Promise<SandboxAttachedProcessIface | null> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n const discard = () => {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n };\n let result: HandleRpcResult<HandleRpcMethod.ProcessAttach>;\n try {\n result = await requestOn(\n connection,\n HandleRpcMethod.ProcessAttach,\n {\n processId,\n ref: options.ref,\n stdoutOffset: options.stdoutOffset,\n stderrOffset: options.stderrOffset,\n stdoutStreamId,\n stderrStreamId,\n },\n { signal: options.abortSignal },\n );\n } catch (error) {\n discard();\n // The server may have attached it before the cancellation reached it.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n throw error;\n }\n if (!result.found) {\n discard();\n return null;\n }\n return {\n ref: options.ref,\n stdoutOffset: result.stdoutOffset,\n stderrOffset: result.stderrOffset,\n stdout,\n stderr,\n ...processControls({\n connection,\n processId,\n durable: true,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: options.abortSignal,\n }),\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.DurableProcesses))\n client.attachProcess = attachProcess;\n if (capabilities.includes(SandboxCapability.Workers)) client.startWorker = startWorker;\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": ["args"]
7
7
  }
@@ -10,7 +10,6 @@ export declare enum SandboxExecutionOperation {
10
10
  WriteBinaryFile = "writeBinaryFile",
11
11
  RemovePath = "removePath",
12
12
  SetNetworkPolicy = "setNetworkPolicy",
13
- Egress = "egress",
14
13
  PortEndpoint = "portEndpoint",
15
14
  Screen = "screen",
16
15
  ComputerUse = "computerUse",
@@ -27,7 +27,6 @@ var SandboxExecutionOperation = /* @__PURE__ */ ((SandboxExecutionOperation2) =>
27
27
  SandboxExecutionOperation2["WriteBinaryFile"] = "writeBinaryFile";
28
28
  SandboxExecutionOperation2["RemovePath"] = "removePath";
29
29
  SandboxExecutionOperation2["SetNetworkPolicy"] = "setNetworkPolicy";
30
- SandboxExecutionOperation2["Egress"] = "egress";
31
30
  SandboxExecutionOperation2["PortEndpoint"] = "portEndpoint";
32
31
  SandboxExecutionOperation2["Screen"] = "screen";
33
32
  SandboxExecutionOperation2["ComputerUse"] = "computerUse";
@@ -47,7 +46,6 @@ const guardedMethods = [
47
46
  "getPortEndpoint",
48
47
  "getPortUrl",
49
48
  "setNetworkPolicy",
50
- "egress",
51
49
  "computerUse",
52
50
  "screen",
53
51
  "localMcp"
@@ -260,13 +258,6 @@ const buildSandboxExecutionGuard = (options, unchangedFrom, checks) => {
260
258
  await setNetworkPolicy(policy);
261
259
  };
262
260
  }
263
- if (source.egress != null) {
264
- const egress = source.egress.bind(source);
265
- overrides.egress = async (request) => {
266
- await guard("egress" /* Egress */);
267
- return egress(request);
268
- };
269
- }
270
261
  if (source.localMcp != null) {
271
262
  const localMcp = source.localMcp.bind(source);
272
263
  overrides.localMcp = async () => {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/execution-guard.ts"],
4
- "sourcesContent": ["import * as z from 'zod';\nimport { createHttpMcpChannelEndpoint } from \"./mcp-channel.mjs\";\nimport { createConfinedFileReader } from \"./confined-files.mjs\";\nimport { sandboxMethodSource, withSandboxOverrides } from \"./overrides.mjs\";\nimport type { NetworkSandboxSessionIface, SandboxMcpEndpoint } from \"./types.mjs\";\n\nconst serialize = <Args extends unknown[], Value>(action: (...args: Args) => Promise<Value>) => {\n let previous = Promise.resolve();\n return (...args: Args): Promise<Value> => {\n const result = previous.then(() => action(...args));\n previous = result.then(\n () => {},\n () => {},\n );\n return result;\n };\n};\n\nconst executionGuardMarker = Symbol('sandboxExecutionGuard');\n\nexport const hasSandboxExecutionGuard = (sandbox: NetworkSandboxSessionIface): boolean =>\n Reflect.get(sandbox, executionGuardMarker) === true;\n\nexport enum SandboxExecutionOperation {\n Run = 'run',\n Spawn = 'spawn',\n // Re-attaching a durable process (see SandboxSessionIface.attachProcess).\n AttachProcess = 'attachProcess',\n ProcessInput = 'processInput',\n WriteFile = 'writeFile',\n WriteTextFile = 'writeTextFile',\n WriteBinaryFile = 'writeBinaryFile',\n RemovePath = 'removePath',\n SetNetworkPolicy = 'setNetworkPolicy',\n Egress = 'egress',\n PortEndpoint = 'portEndpoint',\n Screen = 'screen',\n ComputerUse = 'computerUse',\n LocalMcp = 'localMcp',\n Mcp = 'mcp',\n Editor = 'editor',\n}\n\nexport interface SandboxExecutionContextIface {\n operation: SandboxExecutionOperation;\n // Protocol maintenance can occur between foreground turns; this is not an authorization grant.\n background: boolean;\n abortSignal?: AbortSignal;\n}\n\nexport interface SandboxExecutionGuardOptionsIface<S extends NetworkSandboxSessionIface> {\n sandbox: S;\n fetch?: typeof globalThis.fetch;\n beforeExecution: (context: SandboxExecutionContextIface) => Promise<void>;\n}\n\nconst guardedMethods = [\n 'run',\n 'spawn',\n 'attachProcess',\n 'writeFile',\n 'writeTextFile',\n 'writeBinaryFile',\n 'removePath',\n 'getPortEndpoint',\n 'getPortUrl',\n 'setNetworkPolicy',\n 'egress',\n 'computerUse',\n 'screen',\n 'localMcp',\n] satisfies (keyof NetworkSandboxSessionIface)[];\nconst executionChecks = new WeakMap<\n object,\n readonly ((context: SandboxExecutionContextIface) => Promise<void>)[]\n>();\n\nconst executionSources = new WeakMap<\n object,\n { method: unknown; fetch?: typeof globalThis.fetch }\n>();\n\n// Mapping runs against raw methods; the mapped result receives the retained checks once.\nexport const sandboxForExecutionMapping = <S extends NetworkSandboxSessionIface>(sandbox: S): S => {\n const overrides: Record<string, unknown> = {};\n for (const method of guardedMethods) {\n const original = sandboxMethodSource(sandbox[method]);\n if (typeof original !== 'function') continue;\n const source = executionSources.get(original);\n if (source != null) overrides[method] = source.method;\n }\n return withSandboxOverrides(sandbox, overrides);\n};\n\n// The host supplies admission policy; this adapter knows nothing about users, Devices or tunnels.\nconst buildSandboxExecutionGuard = <S extends NetworkSandboxSessionIface>(\n options: SandboxExecutionGuardOptionsIface<S>,\n unchangedFrom?: S,\n checks?: readonly ((context: SandboxExecutionContextIface) => Promise<void>)[],\n): S => {\n const source = options.sandbox;\n const guard = async (\n operation: SandboxExecutionOperation,\n background = false,\n abortSignal?: AbortSignal,\n ) => {\n abortSignal?.throwIfAborted();\n let aborted: (() => void) | undefined;\n try {\n const admission = options.beforeExecution({ operation, background, abortSignal });\n if (abortSignal == null) await admission;\n else\n await Promise.race([\n admission,\n new Promise<never>((_resolve, reject) => {\n aborted = () => reject(abortSignal.reason);\n abortSignal.addEventListener('abort', aborted, { once: true });\n if (abortSignal.aborted) aborted();\n }),\n ]);\n abortSignal?.throwIfAborted();\n } finally {\n if (aborted != null) abortSignal?.removeEventListener('abort', aborted);\n }\n };\n const stdinFor = (\n stdin: ReadableStream<Uint8Array> | string | undefined,\n abortSignal?: AbortSignal,\n ) => {\n if (stdin == null || typeof stdin === 'string') return stdin;\n let reader: ReadableStreamDefaultReader<Uint8Array> | null = null;\n return new ReadableStream<Uint8Array>(\n {\n pull: async (controller) => {\n try {\n reader ??= stdin.getReader();\n const next = await reader.read();\n await guard(SandboxExecutionOperation.ProcessInput, false, abortSignal);\n if (next.done) {\n reader.releaseLock();\n controller.close();\n return;\n }\n controller.enqueue(next.value);\n } catch (cause) {\n controller.error(cause);\n await reader?.cancel(cause).catch(() => undefined);\n reader?.releaseLock();\n }\n },\n cancel: async (reason) => {\n if (reader == null) await stdin.cancel(reason);\n else {\n try {\n await reader.cancel(reason);\n } finally {\n reader.releaseLock();\n }\n }\n },\n },\n { highWaterMark: 0 },\n );\n };\n const endpoint = (value: SandboxMcpEndpoint): SandboxMcpEndpoint => {\n const channelEndpoint =\n 'connect' in value\n ? value\n : createHttpMcpChannelEndpoint(value, options.fetch, {\n beforeRequest: () => guard(SandboxExecutionOperation.Mcp, true),\n });\n return {\n name: channelEndpoint.name,\n connect: async (args) => {\n await guard(SandboxExecutionOperation.Mcp, false, args?.abortSignal);\n const channel = await channelEndpoint.connect(args);\n const admitSend = serialize(async (...[message, opts]: Parameters<typeof channel.send>) => {\n const parsed = z.object({ method: z.string().optional() }).safeParse(message);\n const method = parsed.success ? parsed.data.method : undefined;\n // SDK catalog refreshes and protocol replies can run between foreground turns.\n const background =\n parsed.success &&\n (method == null ||\n [\n 'initialize',\n 'ping',\n 'tools/list',\n 'subscriptions/listen',\n 'notifications/initialized',\n 'notifications/cancelled',\n 'notifications/subscriptions/acknowledged',\n ].includes(method));\n opts?.abortSignal?.throwIfAborted();\n await guard(SandboxExecutionOperation.Mcp, background, opts?.abortSignal);\n opts?.abortSignal?.throwIfAborted();\n // Preserve dispatch order without waiting for an HTTP tool response.\n return { completion: channel.send(message, opts) };\n });\n const send: typeof channel.send = async (message, opts) =>\n (await admitSend(message, opts)).completion;\n let pending: Awaited<ReturnType<typeof channel.receive>> | null = null;\n let receiving = Promise.resolve();\n const receive: typeof channel.receive = (opts) =>\n new Promise((resolve, reject) => {\n const signal = opts?.abortSignal;\n const aborted = () => reject(signal?.reason);\n signal?.addEventListener('abort', aborted, { once: true });\n if (signal?.aborted === true) {\n signal.removeEventListener('abort', aborted);\n reject(signal.reason);\n return;\n }\n const result = receiving.then(async () => {\n signal?.throwIfAborted();\n pending ??= await channel.receive(opts);\n signal?.throwIfAborted();\n // Retain the batch on denial or cancellation until a receiver accepts it.\n if (pending.length > 0) await guard(SandboxExecutionOperation.Mcp, true);\n signal?.throwIfAborted();\n resolve(pending);\n pending = null;\n });\n receiving = result.then(\n () => {},\n () => {},\n );\n void result.catch(reject).finally(() => signal?.removeEventListener('abort', aborted));\n });\n return withSandboxOverrides(channel, { send, receive });\n },\n };\n };\n const overrides: Partial<NetworkSandboxSessionIface> = {\n confinedFileReader: source.confinedFileReader ?? createConfinedFileReader(source),\n getPortUrl: async (args) => {\n await guard(SandboxExecutionOperation.PortEndpoint);\n return source.getPortUrl(args);\n },\n getPortEndpoint: async (args) => {\n await guard(SandboxExecutionOperation.PortEndpoint);\n return source.getPortEndpoint(args);\n },\n run: async (args) => {\n await guard(SandboxExecutionOperation.Run, false, args.abortSignal);\n return source.run({ ...args, stdin: stdinFor(args.stdin, args.abortSignal) });\n },\n spawn: async (args) => {\n await guard(SandboxExecutionOperation.Spawn, false, args.abortSignal);\n const process = await source.spawn({\n ...args,\n stdin: stdinFor(args.stdin, args.abortSignal),\n });\n let writeFailed = false;\n const write: typeof process.write = async (data, opts) => {\n if (writeFailed)\n throw new Error('Process stdin is unusable after a failed write; restart the process');\n try {\n await guard(SandboxExecutionOperation.ProcessInput);\n await process.write(data, opts);\n } catch (cause) {\n writeFailed = true;\n throw cause;\n }\n };\n return withSandboxOverrides(process, { write: serialize(write) });\n },\n writeFile: async (args) => {\n await guard(SandboxExecutionOperation.WriteFile, false, args.abortSignal);\n return source.writeFile(args);\n },\n writeTextFile: async (args) => {\n await guard(SandboxExecutionOperation.WriteTextFile, false, args.abortSignal);\n return source.writeTextFile(args);\n },\n writeBinaryFile: async (args) => {\n await guard(SandboxExecutionOperation.WriteBinaryFile, false, args.abortSignal);\n return source.writeBinaryFile(args);\n },\n removePath: async (args) => {\n await guard(SandboxExecutionOperation.RemovePath, false, args.abortSignal);\n return source.removePath(args);\n },\n };\n if (source.attachProcess != null) {\n const attachProcess = source.attachProcess.bind(source);\n overrides.attachProcess = async (args) => {\n await guard(SandboxExecutionOperation.AttachProcess, false, args.abortSignal);\n return attachProcess(args);\n };\n }\n if (source.computerUse != null) {\n const computerUse = source.computerUse.bind(source);\n overrides.computerUse = async () => {\n await guard(SandboxExecutionOperation.ComputerUse);\n return endpoint(await computerUse());\n };\n }\n if (source.screen != null) {\n const screen = source.screen.bind(source);\n overrides.screen = async (args) => {\n await guard(SandboxExecutionOperation.Screen);\n return screen(args);\n };\n }\n if (source.setNetworkPolicy != null) {\n const setNetworkPolicy = source.setNetworkPolicy.bind(source);\n overrides.setNetworkPolicy = async (policy) => {\n await guard(SandboxExecutionOperation.SetNetworkPolicy);\n await setNetworkPolicy(policy);\n };\n }\n if (source.egress != null) {\n const egress = source.egress.bind(source);\n overrides.egress = async (request) => {\n await guard(SandboxExecutionOperation.Egress);\n return egress(request);\n };\n }\n if (source.localMcp != null) {\n const localMcp = source.localMcp.bind(source);\n overrides.localMcp = async () => {\n await guard(SandboxExecutionOperation.LocalMcp);\n return (await localMcp()).map(endpoint);\n };\n }\n for (const method of guardedMethods) {\n if (\n unchangedFrom != null &&\n sandboxMethodSource(source[method]) === sandboxMethodSource(unchangedFrom[method])\n )\n delete overrides[method];\n const wrapped = overrides[method];\n const original = sandboxMethodSource(source[method]);\n if (typeof wrapped === 'function') {\n const inherited = typeof original === 'function' ? (executionChecks.get(original) ?? []) : [];\n const value = source[method];\n if (typeof value === 'function')\n executionSources.set(wrapped, {\n method:\n (typeof original === 'function' ? executionSources.get(original)?.method : undefined) ??\n value.bind(source),\n fetch:\n (typeof original === 'function' ? executionSources.get(original)?.fetch : undefined) ??\n options.fetch,\n });\n executionChecks.set(wrapped, [\n ...new Set([...(checks ?? [options.beforeExecution]), ...inherited]),\n ]);\n }\n }\n Object.defineProperty(overrides, executionGuardMarker, { value: true, enumerable: true });\n return withSandboxOverrides(source, overrides);\n};\n\nexport const withSandboxExecutionGuard = <S extends NetworkSandboxSessionIface>(\n options: SandboxExecutionGuardOptionsIface<S>,\n): S => buildSandboxExecutionGuard(options);\n\n// Replacements inherit every original check; identical methods retain their existing wrappers.\nexport const mapSandboxExecutionGuard = <S extends NetworkSandboxSessionIface>(options: {\n sandbox: S;\n original: S;\n fetch?: typeof globalThis.fetch;\n}): S => {\n const checks = new Set<(context: SandboxExecutionContextIface) => Promise<void>>();\n for (const method of guardedMethods) {\n const original = sandboxMethodSource(options.original[method]);\n if (typeof original === 'function')\n for (const check of executionChecks.get(original) ?? []) checks.add(check);\n }\n const layers = [...checks];\n if (layers.length === 0) return options.sandbox;\n const inheritedFetch = guardedMethods\n .map((method) => {\n const original = sandboxMethodSource(options.original[method]);\n return typeof original === 'function' ? executionSources.get(original)?.fetch : undefined;\n })\n .find((fetch) => fetch != null);\n return buildSandboxExecutionGuard(\n {\n sandbox: options.sandbox,\n fetch: inheritedFetch ?? options.fetch,\n beforeExecution: async (context) => {\n for (const check of layers) await check(context);\n },\n },\n options.original,\n layers,\n );\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import * as z from 'zod';\nimport { createHttpMcpChannelEndpoint } from \"./mcp-channel.mjs\";\nimport { createConfinedFileReader } from \"./confined-files.mjs\";\nimport { sandboxMethodSource, withSandboxOverrides } from \"./overrides.mjs\";\nimport type { NetworkSandboxSessionIface, SandboxMcpEndpoint } from \"./types.mjs\";\n\nconst serialize = <Args extends unknown[], Value>(action: (...args: Args) => Promise<Value>) => {\n let previous = Promise.resolve();\n return (...args: Args): Promise<Value> => {\n const result = previous.then(() => action(...args));\n previous = result.then(\n () => {},\n () => {},\n );\n return result;\n };\n};\n\nconst executionGuardMarker = Symbol('sandboxExecutionGuard');\n\nexport const hasSandboxExecutionGuard = (sandbox: NetworkSandboxSessionIface): boolean =>\n Reflect.get(sandbox, executionGuardMarker) === true;\n\nexport enum SandboxExecutionOperation {\n Run = 'run',\n Spawn = 'spawn',\n // Re-attaching a durable process (see SandboxSessionIface.attachProcess).\n AttachProcess = 'attachProcess',\n ProcessInput = 'processInput',\n WriteFile = 'writeFile',\n WriteTextFile = 'writeTextFile',\n WriteBinaryFile = 'writeBinaryFile',\n RemovePath = 'removePath',\n SetNetworkPolicy = 'setNetworkPolicy',\n PortEndpoint = 'portEndpoint',\n Screen = 'screen',\n ComputerUse = 'computerUse',\n LocalMcp = 'localMcp',\n Mcp = 'mcp',\n Editor = 'editor',\n}\n\nexport interface SandboxExecutionContextIface {\n operation: SandboxExecutionOperation;\n // Protocol maintenance can occur between foreground turns; this is not an authorization grant.\n background: boolean;\n abortSignal?: AbortSignal;\n}\n\nexport interface SandboxExecutionGuardOptionsIface<S extends NetworkSandboxSessionIface> {\n sandbox: S;\n fetch?: typeof globalThis.fetch;\n beforeExecution: (context: SandboxExecutionContextIface) => Promise<void>;\n}\n\nconst guardedMethods = [\n 'run',\n 'spawn',\n 'attachProcess',\n 'writeFile',\n 'writeTextFile',\n 'writeBinaryFile',\n 'removePath',\n 'getPortEndpoint',\n 'getPortUrl',\n 'setNetworkPolicy',\n 'computerUse',\n 'screen',\n 'localMcp',\n] satisfies (keyof NetworkSandboxSessionIface)[];\nconst executionChecks = new WeakMap<\n object,\n readonly ((context: SandboxExecutionContextIface) => Promise<void>)[]\n>();\n\nconst executionSources = new WeakMap<\n object,\n { method: unknown; fetch?: typeof globalThis.fetch }\n>();\n\n// Mapping runs against raw methods; the mapped result receives the retained checks once.\nexport const sandboxForExecutionMapping = <S extends NetworkSandboxSessionIface>(sandbox: S): S => {\n const overrides: Record<string, unknown> = {};\n for (const method of guardedMethods) {\n const original = sandboxMethodSource(sandbox[method]);\n if (typeof original !== 'function') continue;\n const source = executionSources.get(original);\n if (source != null) overrides[method] = source.method;\n }\n return withSandboxOverrides(sandbox, overrides);\n};\n\n// The host supplies admission policy; this adapter knows nothing about users, Devices or tunnels.\nconst buildSandboxExecutionGuard = <S extends NetworkSandboxSessionIface>(\n options: SandboxExecutionGuardOptionsIface<S>,\n unchangedFrom?: S,\n checks?: readonly ((context: SandboxExecutionContextIface) => Promise<void>)[],\n): S => {\n const source = options.sandbox;\n const guard = async (\n operation: SandboxExecutionOperation,\n background = false,\n abortSignal?: AbortSignal,\n ) => {\n abortSignal?.throwIfAborted();\n let aborted: (() => void) | undefined;\n try {\n const admission = options.beforeExecution({ operation, background, abortSignal });\n if (abortSignal == null) await admission;\n else\n await Promise.race([\n admission,\n new Promise<never>((_resolve, reject) => {\n aborted = () => reject(abortSignal.reason);\n abortSignal.addEventListener('abort', aborted, { once: true });\n if (abortSignal.aborted) aborted();\n }),\n ]);\n abortSignal?.throwIfAborted();\n } finally {\n if (aborted != null) abortSignal?.removeEventListener('abort', aborted);\n }\n };\n const stdinFor = (\n stdin: ReadableStream<Uint8Array> | string | undefined,\n abortSignal?: AbortSignal,\n ) => {\n if (stdin == null || typeof stdin === 'string') return stdin;\n let reader: ReadableStreamDefaultReader<Uint8Array> | null = null;\n return new ReadableStream<Uint8Array>(\n {\n pull: async (controller) => {\n try {\n reader ??= stdin.getReader();\n const next = await reader.read();\n await guard(SandboxExecutionOperation.ProcessInput, false, abortSignal);\n if (next.done) {\n reader.releaseLock();\n controller.close();\n return;\n }\n controller.enqueue(next.value);\n } catch (cause) {\n controller.error(cause);\n await reader?.cancel(cause).catch(() => undefined);\n reader?.releaseLock();\n }\n },\n cancel: async (reason) => {\n if (reader == null) await stdin.cancel(reason);\n else {\n try {\n await reader.cancel(reason);\n } finally {\n reader.releaseLock();\n }\n }\n },\n },\n { highWaterMark: 0 },\n );\n };\n const endpoint = (value: SandboxMcpEndpoint): SandboxMcpEndpoint => {\n const channelEndpoint =\n 'connect' in value\n ? value\n : createHttpMcpChannelEndpoint(value, options.fetch, {\n beforeRequest: () => guard(SandboxExecutionOperation.Mcp, true),\n });\n return {\n name: channelEndpoint.name,\n connect: async (args) => {\n await guard(SandboxExecutionOperation.Mcp, false, args?.abortSignal);\n const channel = await channelEndpoint.connect(args);\n const admitSend = serialize(async (...[message, opts]: Parameters<typeof channel.send>) => {\n const parsed = z.object({ method: z.string().optional() }).safeParse(message);\n const method = parsed.success ? parsed.data.method : undefined;\n // SDK catalog refreshes and protocol replies can run between foreground turns.\n const background =\n parsed.success &&\n (method == null ||\n [\n 'initialize',\n 'ping',\n 'tools/list',\n 'subscriptions/listen',\n 'notifications/initialized',\n 'notifications/cancelled',\n 'notifications/subscriptions/acknowledged',\n ].includes(method));\n opts?.abortSignal?.throwIfAborted();\n await guard(SandboxExecutionOperation.Mcp, background, opts?.abortSignal);\n opts?.abortSignal?.throwIfAborted();\n // Preserve dispatch order without waiting for an HTTP tool response.\n return { completion: channel.send(message, opts) };\n });\n const send: typeof channel.send = async (message, opts) =>\n (await admitSend(message, opts)).completion;\n let pending: Awaited<ReturnType<typeof channel.receive>> | null = null;\n let receiving = Promise.resolve();\n const receive: typeof channel.receive = (opts) =>\n new Promise((resolve, reject) => {\n const signal = opts?.abortSignal;\n const aborted = () => reject(signal?.reason);\n signal?.addEventListener('abort', aborted, { once: true });\n if (signal?.aborted === true) {\n signal.removeEventListener('abort', aborted);\n reject(signal.reason);\n return;\n }\n const result = receiving.then(async () => {\n signal?.throwIfAborted();\n pending ??= await channel.receive(opts);\n signal?.throwIfAborted();\n // Retain the batch on denial or cancellation until a receiver accepts it.\n if (pending.length > 0) await guard(SandboxExecutionOperation.Mcp, true);\n signal?.throwIfAborted();\n resolve(pending);\n pending = null;\n });\n receiving = result.then(\n () => {},\n () => {},\n );\n void result.catch(reject).finally(() => signal?.removeEventListener('abort', aborted));\n });\n return withSandboxOverrides(channel, { send, receive });\n },\n };\n };\n const overrides: Partial<NetworkSandboxSessionIface> = {\n confinedFileReader: source.confinedFileReader ?? createConfinedFileReader(source),\n getPortUrl: async (args) => {\n await guard(SandboxExecutionOperation.PortEndpoint);\n return source.getPortUrl(args);\n },\n getPortEndpoint: async (args) => {\n await guard(SandboxExecutionOperation.PortEndpoint);\n return source.getPortEndpoint(args);\n },\n run: async (args) => {\n await guard(SandboxExecutionOperation.Run, false, args.abortSignal);\n return source.run({ ...args, stdin: stdinFor(args.stdin, args.abortSignal) });\n },\n spawn: async (args) => {\n await guard(SandboxExecutionOperation.Spawn, false, args.abortSignal);\n const process = await source.spawn({\n ...args,\n stdin: stdinFor(args.stdin, args.abortSignal),\n });\n let writeFailed = false;\n const write: typeof process.write = async (data, opts) => {\n if (writeFailed)\n throw new Error('Process stdin is unusable after a failed write; restart the process');\n try {\n await guard(SandboxExecutionOperation.ProcessInput);\n await process.write(data, opts);\n } catch (cause) {\n writeFailed = true;\n throw cause;\n }\n };\n return withSandboxOverrides(process, { write: serialize(write) });\n },\n writeFile: async (args) => {\n await guard(SandboxExecutionOperation.WriteFile, false, args.abortSignal);\n return source.writeFile(args);\n },\n writeTextFile: async (args) => {\n await guard(SandboxExecutionOperation.WriteTextFile, false, args.abortSignal);\n return source.writeTextFile(args);\n },\n writeBinaryFile: async (args) => {\n await guard(SandboxExecutionOperation.WriteBinaryFile, false, args.abortSignal);\n return source.writeBinaryFile(args);\n },\n removePath: async (args) => {\n await guard(SandboxExecutionOperation.RemovePath, false, args.abortSignal);\n return source.removePath(args);\n },\n };\n if (source.attachProcess != null) {\n const attachProcess = source.attachProcess.bind(source);\n overrides.attachProcess = async (args) => {\n await guard(SandboxExecutionOperation.AttachProcess, false, args.abortSignal);\n return attachProcess(args);\n };\n }\n if (source.computerUse != null) {\n const computerUse = source.computerUse.bind(source);\n overrides.computerUse = async () => {\n await guard(SandboxExecutionOperation.ComputerUse);\n return endpoint(await computerUse());\n };\n }\n if (source.screen != null) {\n const screen = source.screen.bind(source);\n overrides.screen = async (args) => {\n await guard(SandboxExecutionOperation.Screen);\n return screen(args);\n };\n }\n if (source.setNetworkPolicy != null) {\n const setNetworkPolicy = source.setNetworkPolicy.bind(source);\n overrides.setNetworkPolicy = async (policy) => {\n await guard(SandboxExecutionOperation.SetNetworkPolicy);\n await setNetworkPolicy(policy);\n };\n }\n if (source.localMcp != null) {\n const localMcp = source.localMcp.bind(source);\n overrides.localMcp = async () => {\n await guard(SandboxExecutionOperation.LocalMcp);\n return (await localMcp()).map(endpoint);\n };\n }\n for (const method of guardedMethods) {\n if (\n unchangedFrom != null &&\n sandboxMethodSource(source[method]) === sandboxMethodSource(unchangedFrom[method])\n )\n delete overrides[method];\n const wrapped = overrides[method];\n const original = sandboxMethodSource(source[method]);\n if (typeof wrapped === 'function') {\n const inherited = typeof original === 'function' ? (executionChecks.get(original) ?? []) : [];\n const value = source[method];\n if (typeof value === 'function')\n executionSources.set(wrapped, {\n method:\n (typeof original === 'function' ? executionSources.get(original)?.method : undefined) ??\n value.bind(source),\n fetch:\n (typeof original === 'function' ? executionSources.get(original)?.fetch : undefined) ??\n options.fetch,\n });\n executionChecks.set(wrapped, [\n ...new Set([...(checks ?? [options.beforeExecution]), ...inherited]),\n ]);\n }\n }\n Object.defineProperty(overrides, executionGuardMarker, { value: true, enumerable: true });\n return withSandboxOverrides(source, overrides);\n};\n\nexport const withSandboxExecutionGuard = <S extends NetworkSandboxSessionIface>(\n options: SandboxExecutionGuardOptionsIface<S>,\n): S => buildSandboxExecutionGuard(options);\n\n// Replacements inherit every original check; identical methods retain their existing wrappers.\nexport const mapSandboxExecutionGuard = <S extends NetworkSandboxSessionIface>(options: {\n sandbox: S;\n original: S;\n fetch?: typeof globalThis.fetch;\n}): S => {\n const checks = new Set<(context: SandboxExecutionContextIface) => Promise<void>>();\n for (const method of guardedMethods) {\n const original = sandboxMethodSource(options.original[method]);\n if (typeof original === 'function')\n for (const check of executionChecks.get(original) ?? []) checks.add(check);\n }\n const layers = [...checks];\n if (layers.length === 0) return options.sandbox;\n const inheritedFetch = guardedMethods\n .map((method) => {\n const original = sandboxMethodSource(options.original[method]);\n return typeof original === 'function' ? executionSources.get(original)?.fetch : undefined;\n })\n .find((fetch) => fetch != null);\n return buildSandboxExecutionGuard(\n {\n sandbox: options.sandbox,\n fetch: inheritedFetch ?? options.fetch,\n beforeExecution: async (context) => {\n for (const check of layers) await check(context);\n },\n },\n options.original,\n layers,\n );\n};\n"],
5
+ "mappings": "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",
6
6
  "names": ["SandboxExecutionOperation"]
7
7
  }