@finalai/agent-provider 0.2.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/README.md +61 -0
  2. package/dist/modules/sandbox/client.mjs +3 -0
  3. package/dist/modules/sandbox/client.mjs.map +2 -2
  4. package/dist/modules/sandbox/confined-files.d.mts +2 -2
  5. package/dist/modules/sandbox/confined-files.mjs +5 -2
  6. package/dist/modules/sandbox/confined-files.mjs.map +2 -2
  7. package/dist/modules/sandbox/execution-guard.d.mts +36 -0
  8. package/dist/modules/sandbox/execution-guard.mjs +322 -0
  9. package/dist/modules/sandbox/execution-guard.mjs.map +7 -0
  10. package/dist/modules/sandbox/file-kind.d.mts +6 -0
  11. package/dist/modules/sandbox/file-kind.mjs +11 -0
  12. package/dist/modules/sandbox/file-kind.mjs.map +7 -0
  13. package/dist/modules/sandbox/file-schemas.d.mts +15 -0
  14. package/dist/modules/sandbox/file-schemas.mjs +22 -0
  15. package/dist/modules/sandbox/file-schemas.mjs.map +7 -0
  16. package/dist/modules/sandbox/handle.d.mts +15 -0
  17. package/dist/modules/sandbox/handle.mjs +47 -0
  18. package/dist/modules/sandbox/handle.mjs.map +7 -0
  19. package/dist/modules/sandbox/index.d.mts +8 -0
  20. package/dist/modules/sandbox/index.mjs +30 -1
  21. package/dist/modules/sandbox/index.mjs.map +2 -2
  22. package/dist/modules/sandbox/mcp-channel.d.mts +8 -1
  23. package/dist/modules/sandbox/mcp-channel.mjs +217 -15
  24. package/dist/modules/sandbox/mcp-channel.mjs.map +3 -3
  25. package/dist/modules/sandbox/mcp-hosted-marker.d.mts +3 -0
  26. package/dist/modules/sandbox/mcp-hosted-marker.mjs +10 -0
  27. package/dist/modules/sandbox/mcp-hosted-marker.mjs.map +7 -0
  28. package/dist/modules/sandbox/mcp-hosted.d.mts +6 -1
  29. package/dist/modules/sandbox/mcp-hosted.mjs +127 -41
  30. package/dist/modules/sandbox/mcp-hosted.mjs.map +2 -2
  31. package/dist/modules/sandbox/mcp-shell.mjs +14 -4
  32. package/dist/modules/sandbox/mcp-shell.mjs.map +2 -2
  33. package/dist/modules/sandbox/mcp.d.mts +5 -2
  34. package/dist/modules/sandbox/mcp.mjs +102 -27
  35. package/dist/modules/sandbox/mcp.mjs.map +2 -2
  36. package/dist/modules/sandbox/networking.d.mts +73 -0
  37. package/dist/modules/sandbox/networking.mjs +149 -0
  38. package/dist/modules/sandbox/networking.mjs.map +7 -0
  39. package/dist/modules/sandbox/overrides.d.mts +2 -0
  40. package/dist/modules/sandbox/overrides.mjs +44 -0
  41. package/dist/modules/sandbox/overrides.mjs.map +7 -0
  42. package/dist/modules/sandbox/server.d.mts +1 -0
  43. package/dist/modules/sandbox/server.mjs +38 -2
  44. package/dist/modules/sandbox/server.mjs.map +2 -2
  45. package/dist/modules/sandbox/testing.d.mts +1 -0
  46. package/dist/modules/sandbox/testing.mjs +1 -0
  47. package/dist/modules/sandbox/testing.mjs.map +2 -2
  48. package/dist/modules/sandbox/tool-policy.d.mts +5 -0
  49. package/dist/modules/sandbox/tool-policy.mjs +62 -0
  50. package/dist/modules/sandbox/tool-policy.mjs.map +7 -0
  51. package/dist/modules/sandbox/types.d.mts +17 -16
  52. package/dist/modules/sandbox/types.mjs +54 -23
  53. package/dist/modules/sandbox/types.mjs.map +3 -3
  54. package/dist/modules/sandbox/wire.d.mts +23 -18
  55. package/dist/modules/sandbox/wire.mjs +21 -20
  56. package/dist/modules/sandbox/wire.mjs.map +3 -3
  57. package/dist/modules/sandbox/workspace-identity.d.mts +5 -0
  58. package/dist/modules/sandbox/workspace-identity.mjs +14 -0
  59. package/dist/modules/sandbox/workspace-identity.mjs.map +7 -0
  60. package/package.json +2 -2
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/types.ts"],
4
- "sourcesContent": ["import type { HostedBindingsIface } from \"../hosted-bindings.mjs\";\nimport type {\n ProcessInspectionRequestIface,\n ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nimport type { JsonValue } from \"../json.mjs\";\nimport type { ToolDescriptorIface } from \"../manifest.mjs\";\nimport type { SandboxEditorRequestIface, SandboxEditorResultIface } from \"./editor.mjs\";\nimport { awaitableOpenRequest, type AwaitableSandboxOpenRequestIface } from \"./open-scope.mjs\";\nimport type { SandboxSnapshotRequestIface, SandboxSnapshotResponseIface } from \"./snapshots.mjs\";\n\n// Sandbox providers and consumers share the streaming session contract.\n\nexport interface AbortableIface {\n abortSignal?: AbortSignal;\n}\n\nexport interface SandboxProcessOptionsIface extends AbortableIface {\n command: string;\n args?: string[];\n cwd?: string;\n env?: Record<string, string>;\n // Run through the sandbox's login shell (`bash -lc`) instead of exec'ing.\n shell?: boolean;\n stdin?: ReadableStream<Uint8Array> | string;\n timeoutMs?: number;\n}\n\nexport interface SandboxProcessIface {\n readonly pid: string | null;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n // Writes to the process's stdin; closes stdin when `end` is true.\n write(data: Uint8Array | string, options?: { end?: boolean }): Promise<void>;\n wait(): Promise<{ exitCode: number }>;\n kill(signal?: string): Promise<void>;\n}\n\nexport interface SandboxRunResultIface {\n exitCode: number;\n stdout: string;\n stderr: string;\n}\n\nexport enum SandboxEntryType {\n File = 'file',\n Directory = 'directory',\n Symlink = 'symlink',\n Other = 'other',\n}\n\nexport interface StatIface {\n path: string;\n type: SandboxEntryType;\n size: number;\n modifiedAt: string | null;\n mode: number | null;\n}\n\nexport interface DirEntryIface {\n name: string;\n path: string;\n type: SandboxEntryType;\n size: number | null;\n}\n\nexport interface ConfinedSandboxFilesIface {\n readFile(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n stat(options: { path: string; root: string } & AbortableIface): Promise<StatIface | null>;\n readDir(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<DirEntryIface[] | null>;\n}\n\nexport interface SandboxSessionIface {\n readonly description: string;\n readonly confinedFileReader?: ConfinedSandboxFilesIface;\n // On the RPC surface, root confines viewer reads to this directory, rejects\n // symlink ancestors and requires Python 3 in the sandbox (confinedFiles feature).\n readFile(\n options: { path: string; root?: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n readBinaryFile(options: { path: string } & AbortableIface): Promise<Uint8Array | null>;\n readTextFile(\n options: {\n path: string;\n encoding?: string;\n startLine?: number;\n endLine?: number;\n } & AbortableIface,\n ): Promise<string | null>;\n writeFile(\n options: { path: string; content: ReadableStream<Uint8Array> } & AbortableIface,\n ): Promise<void>;\n writeBinaryFile(options: { path: string; content: Uint8Array } & AbortableIface): Promise<void>;\n // Writes create missing parent directories.\n writeTextFile(\n options: { path: string; content: string; encoding?: string } & AbortableIface,\n ): Promise<void>;\n spawn(options: SandboxProcessOptionsIface): Promise<SandboxProcessIface>;\n run(options: SandboxProcessOptionsIface): Promise<SandboxRunResultIface>;\n stat(options: { path: string; root?: string } & AbortableIface): Promise<StatIface | null>;\n readDir(options: { path: string; root?: string } & AbortableIface): Promise<DirEntryIface[]>;\n resolvePath(path: string): string;\n removePath(\n options: { path: string; recursive?: boolean; force?: boolean } & AbortableIface,\n ): Promise<void>;\n}\n\nexport enum NetworkPolicy {\n AllowAll = 'allow-all',\n DenyAll = 'deny-all',\n Allowlist = 'allowlist',\n}\n\nexport interface NetworkPolicyIface {\n mode: NetworkPolicy;\n allow?: string[];\n}\n\nexport enum PortProtocol {\n Http = 'http',\n Https = 'https',\n Ws = 'ws',\n}\n\n// An MCP transport the sandbox serves for an optional capability: an HTTP MCP\n// endpoint the harness (or the session service) can dial.\nexport interface McpEndpointIface {\n name: string;\n url: string;\n headers: Record<string, string>;\n}\n\n// A JSON-RPC message channel to an MCP server the sandbox hosts, for backends\n// whose API reaches it some other way than HTTP MCP (a byte pipe, a socket).\n// Messages are JSON-RPC objects, in order.\nexport interface McpChannelIface {\n send(message: JsonValue, options?: AbortableIface): Promise<void>;\n // The messages that arrived since the last call; [] when none did.\n receive(options?: AbortableIface): Promise<JsonValue[]>;\n close(): Promise<void>;\n}\n\n// An MCP server the sandbox hosts, opened in process by whoever runs the handle.\n// It cannot cross the handle RPC wire.\nexport interface McpChannelEndpointIface {\n name: string;\n connect(options?: AbortableIface): Promise<McpChannelIface>;\n}\n\nexport type SandboxMcpEndpoint = McpEndpointIface | McpChannelEndpointIface;\n\n// The tools of a sandbox's hosted MCP servers, as far as they are known without\n// starting it. Null: unknown until the sandbox is attached and asked.\nexport interface SandboxMcpCatalogIface {\n computerUse: ToolDescriptorIface[] | null;\n // Local MCP server name \u2192 its tools.\n localMcp: Record<string, ToolDescriptorIface[]> | null;\n}\n\nexport const isMcpChannelEndpoint = (\n endpoint: SandboxMcpEndpoint,\n): endpoint is McpChannelEndpointIface => 'connect' in endpoint;\n\nexport interface ScreenOptionsIface {\n // View-only by default; explicit input control requires execute access.\n viewOnly?: boolean;\n}\n\nexport interface ScreenSessionIface {\n // A short-lived viewer grant; providers enforce the requested input access.\n url: string;\n token: string;\n expiresAt: string;\n}\n\nexport interface NetworkSandboxSessionIface extends SandboxSessionIface {\n readonly id: string;\n readonly defaultWorkingDirectory: string;\n readonly ports: readonly number[];\n getPortEndpoint(options: {\n port: number;\n protocol?: PortProtocol;\n }): Promise<{ url: string; headers?: Record<string, string> }>;\n getPortUrl(options: { port: number; protocol?: PortProtocol }): Promise<string>;\n stop(): Promise<void>;\n destroy(): Promise<void>;\n setNetworkPolicy?(policy: NetworkPolicyIface): Promise<void>;\n computerUse?(): Promise<SandboxMcpEndpoint>;\n screen?(options?: ScreenOptionsIface): Promise<ScreenSessionIface>;\n localMcp?(): Promise<SandboxMcpEndpoint[]>;\n}\n\n// Capabilities a started sandbox advertises (and the handle RPC exposes).\nexport enum SandboxCapability {\n Files = 'files',\n Process = 'process',\n Ports = 'ports',\n NetworkPolicy = 'networkPolicy',\n ComputerUse = 'computerUse',\n Screen = 'screen',\n LocalMcp = 'localMcp',\n Browser = 'browser',\n}\n\nexport interface SandboxProviderHandleIface<S extends SandboxSessionIface> {\n readonly sandbox: S;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n}\n\n// A saved computer setup guide version: Build's versioned build-\n// and start-time inputs for a sandbox, as the session service serves them.\nexport interface SandboxGuideVersionIface {\n guideId: string;\n versionId: string;\n slug: string;\n title: string;\n number: number;\n image: string;\n // `.final/sandbox-template.yaml` v2 as JSON.\n templateConfig: JsonValue;\n // The start-time parameters this version defaults to.\n defaultParameters: JsonValue;\n instructionsMarkdown: string | null;\n // A ready build from the guide's provider, reusable independently of workspace seeds.\n preparedArtifact?: { providerRef: string; key: string; artifact: JsonValue };\n}\n\n// The organization's computer setup guides, read through the session service.\n// Every provider gets the same reader; a provider whose\n// environments name no guide never calls it.\nexport interface SandboxGuidesIface {\n get(args: { ref: string; version: number | 'latest' }): Promise<SandboxGuideVersionIface | null>;\n // The organization's default guide; null when it has none.\n default(): Promise<SandboxGuideVersionIface | null>;\n}\n\n// Where to clone a repository from, with a short-lived read credential that\n// must reach only the clone process (never a repository's git config).\nexport interface SandboxRepositoryCloneSourceIface {\n url: string;\n // Checked out after the clone; null keeps the default branch.\n ref: string | null;\n // An HTTP Authorization header value for the clone, or null.\n authorization: string | null;\n}\n\n// Repository credentials for the repositories an environment names (a Code\n// Storage id, a GitHub owner/name), resolved by the session service for the\n// session's organization only. Null: not a repository it can resolve.\nexport interface SandboxRepositoriesIface {\n cloneSource(args: {\n repository: string;\n ref: string | null;\n }): Promise<SandboxRepositoryCloneSourceIface | null>;\n}\n\n// Reads a named organization variable (managed in Build) for the session's\n// organization. Values are injected into the sandbox only, never stored in a\n// manifest, a state or the log.\nexport interface SandboxVariablesIface {\n get(name: string): Promise<string | null>;\n}\n\nexport const noSandboxGuides: SandboxGuidesIface = {\n get: async () => null,\n default: async () => null,\n};\n\nexport const noSandboxRepositories: SandboxRepositoriesIface = {\n cloneSource: async () => null,\n};\n\nexport const noSandboxVariables: SandboxVariablesIface = { get: async () => null };\n\n// The user a session acts for: the author of its running turn, else its owner,\n// else the user whose Home its conversation is. A call a person makes through\n// the platform's sandbox viewer acts for that person instead. Null when it acts\n// for no user (a turn nobody prompted in a shared conversation) and outside any\n// session (a guide build). Read on each call, because it changes between turns\n// and between callers.\nexport interface SandboxActingUserIface {\n current(): Promise<string | null>;\n}\n\nexport const noSandboxActingUser: SandboxActingUserIface = { current: async () => null };\n\n// What an environment's pre-start reads (capabilities, mcpCatalog) are given.\nexport interface SandboxOfferContextIface {\n bindings?: HostedBindingsIface;\n organizationId: string;\n actingUser: SandboxActingUserIface;\n}\n\n// What an environment's hooks are given before anything starts.\nexport interface SandboxEnvironmentContextIface {\n bindings?: HostedBindingsIface;\n organizationId: string;\n guides: SandboxGuidesIface;\n}\n\n// Scoped by the host to this organization and provider. Providers can retain\n// reusable intermediate artifacts independently of a revision's seed files.\nexport interface SandboxArtifactsIface {\n get(key: string): Promise<JsonValue | null>;\n put(key: string, artifact: JsonValue): Promise<void>;\n}\n\nexport interface SandboxPreparationSourceIface {\n sourceRevision: string;\n read(): Promise<{ files: Record<string, string>; resources: Record<string, JsonValue> }>;\n}\n\nexport interface SandboxPrepareContextIface {\n bindings?: HostedBindingsIface;\n // A host-persisted resource source; artifacts may retain its identity instead of seed contents.\n preparation?: SandboxPreparationSourceIface;\n artifacts?: SandboxArtifactsIface;\n // Agent revisions supply workspace-relative seeds; setup-guide builds supply\n // guide.json and optional instructions.md. Resources name workspace, skills or guide.\n // Model instructions remain harness config.\n files: Record<string, string>;\n resources: Record<string, JsonValue>;\n sourceRevision: string;\n storagePath: string;\n organizationId: string;\n // The guide inputs (build-time) an environment names, resolved by the platform.\n guides: SandboxGuidesIface;\n // Who the session the artifact is prepared for acts for, for environments that\n // name a backend resource relative to that user; the key must then name it.\n actingUser: SandboxActingUserIface;\n log?: (message: string) => void;\n}\n\nexport interface SandboxStartContextIface {\n bindings?: HostedBindingsIface;\n /** Passive recovery only: never wake, create, seed, or restart backend services. */\n passive?: boolean;\n preparation?: SandboxPreparationSourceIface;\n session: {\n id: string;\n organizationId: string;\n conversationId: string | null;\n definitionId: string;\n bindingId: string;\n target: string;\n };\n storagePath: string;\n // Start-time inputs: guides, the variables to inject, repository credentials.\n guides: SandboxGuidesIface;\n variables: SandboxVariablesIface;\n repositories: SandboxRepositoriesIface;\n actingUser: SandboxActingUserIface;\n // Variables the platform sets in every process of this sandbox: the egress\n // proxy, trust for its CA, and one placeholder per bound secret. Evaluated\n // again for every spawn/run, never once per session: a secret bound\n // mid-session must reach the next command. May resolve to {} (no proxy\n // configured, or not ready yet). Platform values override the spec's env.\n platformEnvironment?: () => Promise<Record<string, string>>;\n // Hosts the sandbox must be able to reach for the proxy to work, to append\n // to any allowlist-mode network policy the spec declares.\n platformEgressHosts?: string[];\n // Reports the network policy now in force on the sandbox, exactly as the\n // provider applied it to its backend (after withPlatformEgressHosts). The\n // platform records it so the egress proxy serves only those destinations.\n // Called after awaitRunning and before platformFiles or any command, on start,\n // resume and a reused sandbox; never for a session's own setNetworkPolicy,\n // which the platform records itself. A rejection fails the start or resume.\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>;\n // Files the platform needs in the sandbox before any clone, setup step or\n // service runs: written right after the sandbox exists, on start and resume.\n // Paths are absolute; missing parent directories are created.\n platformFiles?: () => Promise<Record<string, string>>;\n}\n\n// The variables `platformEnvironment` owns. A spec that sets one (as a plain\n// value or an organization variable) is refused at start.\nexport const PLATFORM_ENVIRONMENT_NAMES: ReadonlySet<string> = new Set([\n 'HTTPS_PROXY',\n 'HTTP_PROXY',\n 'NO_PROXY',\n 'NODE_USE_ENV_PROXY',\n 'SSL_CERT_FILE',\n 'CURL_CA_BUNDLE',\n 'REQUESTS_CA_BUNDLE',\n 'GIT_SSL_CAINFO',\n 'CARGO_HTTP_CAINFO',\n 'DENO_CERT',\n 'NODE_EXTRA_CA_CERTS',\n 'FINAL_EGRESS_URL',\n 'FINAL_EGRESS_TOKEN',\n 'GH_TOKEN',\n 'GITHUB_TOKEN',\n]);\n\n// A process's base environment: the spec's variables under the platform's,\n// read again on every call.\nexport const platformProcessEnvironment =\n (\n ctx: Pick<SandboxStartContextIface, 'platformEnvironment'>,\n specEnv: Record<string, string>,\n ): (() => Promise<Record<string, string>>) =>\n async () => ({ ...specEnv, ...(await ctx.platformEnvironment?.()) });\n\n// Writes `platformFiles` into a sandbox that now exists, before it runs anything.\n// Relies on writeTextFile creating missing parent directories.\nexport const writePlatformFiles = async (\n ctx: Pick<SandboxStartContextIface, 'platformFiles'>,\n sandbox: Pick<SandboxSessionIface, 'writeTextFile'>,\n): Promise<void> => {\n for (const [path, content] of Object.entries((await ctx.platformFiles?.()) ?? {}))\n await sandbox.writeTextFile({ path, content });\n};\n\n// Reports the policy a provider just applied to its backend: `allow` only for an\n// allowlist, its entries (hosts, `*.suffix` patterns, CIDRs) unchanged.\nexport const reportPlatformNetworkPolicy = async (\n ctx: Pick<SandboxStartContextIface, 'platformNetworkPolicy'>,\n policy: NetworkPolicyIface,\n): Promise<void> =>\n ctx.platformNetworkPolicy(\n policy.mode === NetworkPolicy.Allowlist\n ? { mode: policy.mode, allow: [...(policy.allow ?? [])] }\n : { mode: policy.mode },\n );\n\n// An allowlist policy with the platform's egress hosts appended; any other\n// policy unchanged.\nexport const withPlatformEgressHosts = (\n ctx: Pick<SandboxStartContextIface, 'platformEgressHosts'>,\n policy: NetworkPolicyIface,\n): NetworkPolicyIface => {\n const hosts = ctx.platformEgressHosts ?? [];\n if (policy.mode !== NetworkPolicy.Allowlist || hosts.length === 0) return policy;\n return { ...policy, allow: [...new Set([...(policy.allow ?? []), ...hosts])] };\n};\n\nexport enum SandboxSessionEndReason {\n Completed = 'completed',\n Expired = 'expired',\n Failed = 'failed',\n}\n\n// How long an environment's sandbox outlives a session: `session`\n// keeps it for the session's life; `conversation` gives every session in the\n// conversation one shared sandbox per target, surviving session resets;\n// `ephemeral` discards it when released.\nexport enum SandboxWorkspace {\n Session = 'session',\n Conversation = 'conversation',\n Ephemeral = 'ephemeral',\n}\n\nexport interface SandboxProviderImplementationIface<\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n // The workspace this environment declares, read before anything starts so the\n // session service knows which sessions share a binding. Absent or null: session.\n workspace?(ctx: SandboxEnvironmentContextIface): Promise<SandboxWorkspace | null>;\n // The capabilities this environment's sandboxes offer, read before anything\n // starts through the backend's own API. Absent or null: unknown\n // until started; local MCP is then not projected.\n capabilities?(ctx: SandboxOfferContextIface): Promise<SandboxCapability[] | null>;\n // The hosted MCP servers' tool catalogs the backend can give without starting\n // a sandbox (from its own records), so the MCP projection lists them from the\n // first `tools/list`. The projection checks a server's catalog against the\n // live server when a call first opens that server (servers a session never\n // uses stay closed) and announces a change with\n // `notifications/tools/list_changed`.\n //\n // Trade-off: a catalog left unknown (absent hook, null, or a null field) can\n // only be learned from the live sandbox, so the first `tools/list` that finds\n // it unknown starts the sandbox in the background, at session start rather\n // than on the first tool call. Otherwise those tools would never be listed,\n // and nothing would ever call them. Providers that can give the catalog keep\n // attach lazy.\n mcpCatalog?(ctx: SandboxOfferContextIface): Promise<SandboxMcpCatalogIface | null>;\n // Reads committed files without starting/resuming a sandbox. Null means the backend\n // is live or offers no snapshot. An unavailable sleeping snapshot must throw,\n // never fall through to a read that wakes it. Pin subsequent ranges by snapshotId.\n readSnapshot?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxSnapshotRequestIface,\n ): Promise<SandboxSnapshotResponseIface | null>;\n // Inspect retained backend processes without opening, resuming or extending a sandbox.\n // Stop requires execute access; the provider also enforces backend ownership.\n processes?(\n ctx: SandboxOfferContextIface & { bindingId: string },\n state: State,\n request: ProcessInspectionRequestIface,\n ): Promise<ProcessInspectionResultIface>;\n // Browser editor for this provider's existing workspace. The host checks write\n // authorization; this hook never creates or wakes a backend. Credentials stay\n // in the authentication form, never the editor URL or stored provider state.\n editor?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxEditorRequestIface,\n ): Promise<SandboxEditorResultIface>;\n // Content-addressed by `artifactKey`; the session service caches artifacts in\n // agent.sandbox_artifacts and calls prepare only on a miss.\n artifactKey(ctx: SandboxPrepareContextIface): Promise<string>;\n prepare(ctx: SandboxPrepareContextIface): Promise<Artifact>;\n // Resolves once the backend sandbox named by `state` is running and will\n // accept a command or a file write; rejects with a clear error after\n // `timeoutMs`. Backend-specific: the provider chooses the readiness signal,\n // the polling cadence and the backoff for its API's rate limits. The\n // platform never polls a backend itself.\n //\n // `start`, `resume` and `resumePassive` call it on the sandbox they just\n // created, started or reused, before anything touches it: create or start \u2192\n // state \u2192 awaitRunning \u2192 platformNetworkPolicy \u2192 platformFiles \u2192 repositories,\n // seeds, setup, services \u2192 handle. On timeout `start` fails and tears down.\n awaitRunning(\n ctx: SandboxStartContextIface,\n state: State,\n options: { timeoutMs: number },\n ): Promise<void>;\n // `region`: where the backend placed the sandbox (its own region name), so the\n // session service can place the harness near it; null when unknown.\n start(\n ctx: SandboxStartContextIface,\n options: OpenOptions | undefined,\n artifact: Artifact,\n ): Promise<{ handle: SandboxProviderHandleIface<S>; state: State; region?: string | null }>;\n resume(\n ctx: SandboxStartContextIface,\n artifact: Artifact,\n state: State,\n ): Promise<SandboxProviderHandleIface<S>>;\n // Reconnect to an already running backend after host restart for a read-only viewer.\n // Absent: viewers can use a retained live handle but cannot trigger resume.\n resumePassive?(\n ctx: SandboxStartContextIface,\n artifact: Artifact,\n state: State,\n ): Promise<SandboxProviderHandleIface<S>>;\n // Park: pause or stop the sandbox, returning the state resume needs.\n park?(ctx: SandboxStartContextIface, artifact: Artifact, state: State): Promise<State>;\n onSessionEnd?(\n ctx: SandboxStartContextIface,\n artifact: Artifact,\n state: State,\n options: { reason: SandboxSessionEndReason },\n ): Promise<void>;\n}\n\nexport interface SandboxProviderDefinitionIface<\n EnvOptions,\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n name: string;\n // The version of `State`'s shape. The session service records it with each\n // binding and refuses to resume a state written under another version (the\n // next call starts the sandbox again instead).\n stateProtocolVersion?: number;\n environment(\n options?: EnvOptions,\n ): SandboxProviderImplementationIface<OpenOptions, Artifact, State, S>;\n}\n\n// A defined provider: the definition plus authoring sugar. `environment(opts)`\n// returns an environment whose `.open(openOptions)` records a sandbox binding\n// target when authored, and is what the session service drives at run time.\nexport interface SandboxProviderIface<\n EnvOptions,\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n readonly definition: SandboxProviderDefinitionIface<EnvOptions, OpenOptions, Artifact, State, S>;\n readonly name: string;\n environment(options?: EnvOptions): AwaitableSandboxEnvironmentIface<EnvOptions, OpenOptions>;\n}\n\nexport interface SandboxEnvironmentIface<EnvOptions, OpenOptions> {\n readonly providerName: string;\n readonly options: EnvOptions | undefined;\n // Provider-authored notices shown by the compiler and Build before publication.\n readonly authoringWarnings?: readonly string[];\n // Authoring: records the open options (access, ...) for this target.\n open(options?: OpenOptions): SandboxOpenRequestIface<EnvOptions, OpenOptions>;\n}\n\n// An environment whose open request a sandbox.ts selector can await to get\n// the live session (open-scope.ts); what defineSandboxProvider and the\n// installed helpers return.\nexport interface AwaitableSandboxEnvironmentIface<\n EnvOptions,\n OpenOptions,\n> extends SandboxEnvironmentIface<EnvOptions, OpenOptions> {\n open(options?: OpenOptions): AwaitableSandboxOpenRequestIface<EnvOptions, OpenOptions>;\n}\n\nexport interface SandboxOpenRequestIface<EnvOptions, OpenOptions> {\n readonly providerName: string;\n readonly environmentOptions: EnvOptions | undefined;\n readonly openOptions: OpenOptions | undefined;\n readonly authoringWarnings?: readonly string[];\n}\n\nexport const defineSandboxProvider = <\n EnvOptions,\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n>(\n definition: SandboxProviderDefinitionIface<EnvOptions, OpenOptions, Artifact, State, S>,\n): SandboxProviderIface<EnvOptions, OpenOptions, Artifact, State, S> => ({\n // An implementation exists only once its options are given, so awaitRunning is\n // checked as each environment is defined, before anything can start from it.\n definition: {\n ...definition,\n environment: (options) => {\n const implementation = definition.environment(options);\n if (typeof implementation.awaitRunning !== 'function')\n throw new Error(`sandbox provider ${definition.name} does not implement awaitRunning`);\n return implementation;\n },\n },\n name: definition.name,\n environment: (options) => ({\n providerName: definition.name,\n options,\n open: (openOptions) =>\n awaitableOpenRequest({\n providerName: definition.name,\n environmentOptions: options,\n openOptions,\n }),\n }),\n});\n\n// Erased form the session service stores in its provider registry.\nexport type AnySandboxProviderIface = SandboxProviderIface<\n JsonValue,\n JsonValue,\n JsonValue,\n JsonValue,\n NetworkSandboxSessionIface\n>;\n\n// Events emitted through a sandbox provider's process lifecycle.\nexport enum SandboxEventKind {\n ProcessExited = 'process_exited',\n}\n"],
5
- "mappings": "AAQA,SAAS,4BAAmE;AAoCrE,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,UAAO;AACP,EAAAA,kBAAA,eAAY;AACZ,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,WAAQ;AAJE,SAAAA;AAAA,GAAA;AAmEL,IAAK,gBAAL,kBAAKC,mBAAL;AACL,EAAAA,eAAA,cAAW;AACX,EAAAA,eAAA,aAAU;AACV,EAAAA,eAAA,eAAY;AAHF,SAAAA;AAAA,GAAA;AAWL,IAAK,eAAL,kBAAKC,kBAAL;AACL,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,QAAK;AAHK,SAAAA;AAAA,GAAA;AAyCL,MAAM,uBAAuB,CAClC,aACwC,aAAa;AAgChD,IAAK,oBAAL,kBAAKC,uBAAL;AACL,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,mBAAgB;AAChB,EAAAA,mBAAA,iBAAc;AACd,EAAAA,mBAAA,YAAS;AACT,EAAAA,mBAAA,cAAW;AACX,EAAAA,mBAAA,aAAU;AARA,SAAAA;AAAA,GAAA;AAwEL,MAAM,kBAAsC;AAAA,EACjD,KAAK,YAAY;AAAA,EACjB,SAAS,YAAY;AACvB;AAEO,MAAM,wBAAkD;AAAA,EAC7D,aAAa,YAAY;AAC3B;AAEO,MAAM,qBAA4C,EAAE,KAAK,YAAY,KAAK;AAY1E,MAAM,sBAA8C,EAAE,SAAS,YAAY,KAAK;AA4FhF,MAAM,6BAAkD,oBAAI,IAAI;AAAA,EACrE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAIM,MAAM,6BACX,CACE,KACA,YAEF,aAAa,EAAE,GAAG,SAAS,GAAI,MAAM,IAAI,sBAAsB,EAAG;AAI7D,MAAM,qBAAqB,OAChC,KACA,YACkB;AAClB,aAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAS,MAAM,IAAI,gBAAgB,KAAM,CAAC,CAAC;AAC9E,UAAM,QAAQ,cAAc,EAAE,MAAM,QAAQ,CAAC;AACjD;AAIO,MAAM,8BAA8B,OACzC,KACA,WAEA,IAAI;AAAA,EACF,OAAO,SAAS,8BACZ,EAAE,MAAM,OAAO,MAAM,OAAO,CAAC,GAAI,OAAO,SAAS,CAAC,CAAE,EAAE,IACtD,EAAE,MAAM,OAAO,KAAK;AAC1B;AAIK,MAAM,0BAA0B,CACrC,KACA,WACuB;AACvB,QAAM,QAAQ,IAAI,uBAAuB,CAAC;AAC1C,MAAI,OAAO,SAAS,+BAA2B,MAAM,WAAW,EAAG,QAAO;AAC1E,SAAO,EAAE,GAAG,QAAQ,OAAO,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAI,OAAO,SAAS,CAAC,GAAI,GAAG,KAAK,CAAC,CAAC,EAAE;AAC/E;AAEO,IAAK,0BAAL,kBAAKC,6BAAL;AACL,EAAAA,yBAAA,eAAY;AACZ,EAAAA,yBAAA,aAAU;AACV,EAAAA,yBAAA,YAAS;AAHC,SAAAA;AAAA,GAAA;AAUL,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,kBAAe;AACf,EAAAA,kBAAA,eAAY;AAHF,SAAAA;AAAA,GAAA;AAkKL,MAAM,wBAAwB,CAOnC,gBACuE;AAAA;AAAA;AAAA,EAGvE,YAAY;AAAA,IACV,GAAG;AAAA,IACH,aAAa,CAAC,YAAY;AACxB,YAAM,iBAAiB,WAAW,YAAY,OAAO;AACrD,UAAI,OAAO,eAAe,iBAAiB;AACzC,cAAM,IAAI,MAAM,oBAAoB,WAAW,IAAI,kCAAkC;AACvF,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EACA,MAAM,WAAW;AAAA,EACjB,aAAa,CAAC,aAAa;AAAA,IACzB,cAAc,WAAW;AAAA,IACzB;AAAA,IACA,MAAM,CAAC,gBACL,qBAAqB;AAAA,MACnB,cAAc,WAAW;AAAA,MACzB,oBAAoB;AAAA,MACpB;AAAA,IACF,CAAC;AAAA,EACL;AACF;AAYO,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,mBAAgB;AADN,SAAAA;AAAA,GAAA;",
6
- "names": ["SandboxEntryType", "NetworkPolicy", "PortProtocol", "SandboxCapability", "SandboxSessionEndReason", "SandboxWorkspace", "SandboxEventKind"]
4
+ "sourcesContent": ["import { SandboxEntryType } from \"./file-kind.mjs\";\nexport { SandboxEntryType } from \"./file-kind.mjs\";\nimport type { HostedBindingsIface } from \"../hosted-bindings.mjs\";\nimport { createSandboxHandle, type SandboxExecutionPolicyIface } from \"./handle.mjs\";\nimport { withSandboxOverrides } from \"./overrides.mjs\";\nimport { WorkspaceNetworkPolicy as NetworkPolicy } from '@finalai/agent-protocol/device-egress';\nimport type {\n WorkspaceEgressRequestIface,\n WorkspaceEgressStatusIface,\n WorkspaceNetworkPolicyIface as NetworkPolicyIface,\n} from '@finalai/agent-protocol/device-egress';\nexport {\n WorkspaceNetworkPolicy as NetworkPolicy,\n type WorkspaceNetworkPolicyIface as NetworkPolicyIface,\n} from '@finalai/agent-protocol/device-egress';\nimport type {\n ProcessInspectionRequestIface,\n ProcessInspectionResultIface,\n} from '@finalai/agent-protocol/process-inspection';\nimport type { JsonValue } from \"../json.mjs\";\nimport type { ToolDescriptorIface } from \"../manifest.mjs\";\nimport {\n SandboxEditorOperation,\n type SandboxEditorRequestIface,\n type SandboxEditorResultIface,\n} from \"./editor.mjs\";\nimport { SandboxExecutionOperation } from \"./execution-guard.mjs\";\nimport { awaitableOpenRequest, type AwaitableSandboxOpenRequestIface } from \"./open-scope.mjs\";\nimport type { SandboxSnapshotRequestIface, SandboxSnapshotResponseIface } from \"./snapshots.mjs\";\n\n// Sandbox providers and consumers share the streaming session contract.\n\nexport interface AbortableIface {\n abortSignal?: AbortSignal;\n}\n\nexport interface SandboxProcessOptionsIface extends AbortableIface {\n command: string;\n args?: string[];\n cwd?: string;\n env?: Record<string, string>;\n // Run through the sandbox's login shell (`bash -lc`) instead of exec'ing.\n shell?: boolean;\n stdin?: ReadableStream<Uint8Array> | string;\n timeoutMs?: number;\n}\n\nexport interface SandboxProcessIface {\n readonly pid: string | null;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n // Writes to the process's stdin; closes stdin when `end` is true.\n write(data: Uint8Array | string, options?: { end?: boolean }): Promise<void>;\n wait(): Promise<{ exitCode: number }>;\n kill(signal?: string): Promise<void>;\n}\n\nexport interface SandboxRunResultIface {\n exitCode: number;\n stdout: string;\n stderr: string;\n}\n\nexport interface StatIface {\n path: string;\n type: SandboxEntryType;\n size: number;\n modifiedAt: string | null;\n mode: number | null;\n}\n\nexport interface DirEntryIface {\n name: string;\n path: string;\n type: SandboxEntryType;\n size: number | null;\n}\n\nexport interface ConfinedSandboxFilesIface {\n readFile(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n stat(options: { path: string; root: string } & AbortableIface): Promise<StatIface | null>;\n readDir(\n options: { path: string; root: string } & AbortableIface,\n ): Promise<DirEntryIface[] | null>;\n}\n\nexport interface SandboxSessionIface {\n readonly description: string;\n readonly confinedFileReader?: ConfinedSandboxFilesIface;\n // On the RPC surface, root confines viewer reads to this directory, rejects\n // symlink ancestors and requires Python 3 in the sandbox (confinedFiles feature).\n readFile(\n options: { path: string; root?: string } & AbortableIface,\n ): Promise<ReadableStream<Uint8Array> | null>;\n readBinaryFile(options: { path: string } & AbortableIface): Promise<Uint8Array | null>;\n readTextFile(\n options: {\n path: string;\n encoding?: string;\n startLine?: number;\n endLine?: number;\n } & AbortableIface,\n ): Promise<string | null>;\n writeFile(\n options: { path: string; content: ReadableStream<Uint8Array> } & AbortableIface,\n ): Promise<void>;\n writeBinaryFile(options: { path: string; content: Uint8Array } & AbortableIface): Promise<void>;\n // Writes create missing parent directories.\n writeTextFile(\n options: { path: string; content: string; encoding?: string } & AbortableIface,\n ): Promise<void>;\n spawn(options: SandboxProcessOptionsIface): Promise<SandboxProcessIface>;\n run(options: SandboxProcessOptionsIface): Promise<SandboxRunResultIface>;\n stat(options: { path: string; root?: string } & AbortableIface): Promise<StatIface | null>;\n readDir(options: { path: string; root?: string } & AbortableIface): Promise<DirEntryIface[]>;\n resolvePath(path: string): string;\n removePath(\n options: { path: string; recursive?: boolean; force?: boolean } & AbortableIface,\n ): Promise<void>;\n}\n\nexport enum PortProtocol {\n Http = 'http',\n Https = 'https',\n Ws = 'ws',\n}\n\n// An MCP transport the sandbox serves for an optional capability: an HTTP MCP\n// endpoint the harness (or the session service) can dial.\nexport interface McpEndpointIface {\n name: string;\n url: string;\n headers: Record<string, string>;\n}\n\n// A JSON-RPC message channel to an MCP server the sandbox hosts, for backends\n// whose API reaches it some other way than HTTP MCP (a byte pipe, a socket).\n// Messages are JSON-RPC objects, in order.\nexport interface McpChannelIface {\n send(message: JsonValue, options?: AbortableIface): Promise<void>;\n // The messages that arrived since the last call; [] when none did.\n receive(options?: AbortableIface): Promise<JsonValue[]>;\n close(): Promise<void>;\n}\n\n// An MCP server the sandbox hosts, opened in process by whoever runs the handle.\n// It cannot cross the handle RPC wire.\nexport interface McpChannelEndpointIface {\n name: string;\n connect(options?: AbortableIface): Promise<McpChannelIface>;\n}\n\nexport type SandboxMcpEndpoint = McpEndpointIface | McpChannelEndpointIface;\n\n// The tools of a sandbox's hosted MCP servers, as far as they are known without\n// starting it. Null: unknown until the sandbox is attached and asked.\nexport interface SandboxMcpCatalogIface {\n computerUse: ToolDescriptorIface[] | null;\n // Local MCP server name \u2192 its tools.\n localMcp: Record<string, ToolDescriptorIface[]> | null;\n // Partial discovery retains known tools and must be retried, including after caching.\n localMcpIncomplete?: boolean;\n}\n\nexport const isMcpChannelEndpoint = (\n endpoint: SandboxMcpEndpoint,\n): endpoint is McpChannelEndpointIface => 'connect' in endpoint;\n\nexport interface ScreenOptionsIface {\n // View-only by default; explicit input control requires execute access.\n viewOnly?: boolean;\n}\n\nexport interface ScreenSessionIface {\n // A short-lived viewer grant; providers enforce the requested input access.\n url: string;\n token: string;\n expiresAt: string;\n}\n\nexport interface NetworkSandboxSessionIface extends SandboxSessionIface {\n readonly id: string;\n readonly defaultWorkingDirectory: string;\n readonly ports: readonly number[];\n getPortEndpoint(options: {\n port: number;\n protocol?: PortProtocol;\n }): Promise<{ url: string; headers?: Record<string, string> }>;\n getPortUrl(options: { port: number; protocol?: PortProtocol }): Promise<string>;\n stop(): Promise<void>;\n destroy(): Promise<void>;\n setNetworkPolicy?(policy: NetworkPolicyIface): Promise<void>;\n egress?(request: WorkspaceEgressRequestIface): Promise<WorkspaceEgressStatusIface>;\n computerUse?(): Promise<SandboxMcpEndpoint>;\n screen?(options?: ScreenOptionsIface): Promise<ScreenSessionIface>;\n localMcp?(): Promise<SandboxMcpEndpoint[]>;\n}\n\n// Capabilities a started sandbox advertises (and the handle RPC exposes).\nexport enum SandboxCapability {\n Files = 'files',\n Process = 'process',\n Ports = 'ports',\n NetworkPolicy = 'networkPolicy',\n Egress = 'egress',\n ComputerUse = 'computerUse',\n Screen = 'screen',\n LocalMcp = 'localMcp',\n Browser = 'browser',\n}\n\nexport interface SandboxProviderHandleIface<S extends SandboxSessionIface> {\n readonly sandbox: S;\n // Pending policy; the generic handle constructor consumes it before exposing execution.\n readonly executionPolicy?: SandboxExecutionPolicyIface;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n}\n\n// A saved computer setup guide version: Build's versioned build-\n// and start-time inputs for a sandbox, as the session service serves them.\nexport interface SandboxGuideVersionIface {\n guideId: string;\n versionId: string;\n slug: string;\n title: string;\n number: number;\n image: string;\n // `.final/sandbox-template.yaml` v2 as JSON.\n templateConfig: JsonValue;\n // The start-time parameters this version defaults to.\n defaultParameters: JsonValue;\n instructionsMarkdown: string | null;\n // A ready build from the guide's provider, reusable independently of workspace seeds.\n preparedArtifact?: { providerRef: string; key: string; artifact: JsonValue };\n}\n\n// The organization's computer setup guides, read through the session service.\n// Every provider gets the same reader; a provider whose\n// environments name no guide never calls it.\nexport interface SandboxGuidesIface {\n get(args: { ref: string; version: number | 'latest' }): Promise<SandboxGuideVersionIface | null>;\n // The organization's default guide; null when it has none.\n default(): Promise<SandboxGuideVersionIface | null>;\n}\n\n// Where to clone a repository from, with a short-lived read credential that\n// must reach only the clone process (never a repository's git config).\nexport interface SandboxRepositoryCloneSourceIface {\n url: string;\n // Checked out after the clone; null keeps the default branch.\n ref: string | null;\n // An HTTP Authorization header value for the clone, or null.\n authorization: string | null;\n}\n\n// Repository credentials for the repositories an environment names (a Code\n// Storage id, a GitHub owner/name), resolved by the session service for the\n// session's organization only. Null: not a repository it can resolve.\nexport interface SandboxRepositoriesIface {\n cloneSource(args: {\n repository: string;\n ref: string | null;\n }): Promise<SandboxRepositoryCloneSourceIface | null>;\n}\n\n// Reads a named organization variable (managed in Build) for the session's\n// organization. Values are injected into the sandbox only, never stored in a\n// manifest, a state or the log.\nexport interface SandboxVariablesIface {\n get(name: string): Promise<string | null>;\n}\n\nexport const noSandboxGuides: SandboxGuidesIface = {\n get: async () => null,\n default: async () => null,\n};\n\nexport const noSandboxRepositories: SandboxRepositoriesIface = {\n cloneSource: async () => null,\n};\n\nexport const noSandboxVariables: SandboxVariablesIface = { get: async () => null };\n\n// The user a session acts for: the author of its running turn, else its owner,\n// else the user whose Home its conversation is. A call a person makes through\n// the platform's sandbox viewer acts for that person instead. Null when it acts\n// for no user (a turn nobody prompted in a shared conversation) and outside any\n// session (a guide build). Read on each call, because it changes between turns\n// and between callers.\nexport interface SandboxActingUserIface {\n current(): Promise<string | null>;\n}\n\nexport const noSandboxActingUser: SandboxActingUserIface = { current: async () => null };\n\n// What an environment's pre-start reads (capabilities, mcpCatalog) are given.\nexport interface SandboxOfferContextIface {\n executionPolicy?: SandboxExecutionPolicyIface;\n platformNetworkPolicy?: (policy: NetworkPolicyIface) => Promise<void>;\n // Retain platform transport access when an extension restores an allowlist.\n platformEgressHosts?: string[];\n // Logical identity when inspecting an existing workspace or opening an execution extension.\n workspaceId?: string;\n bindings?: HostedBindingsIface;\n organizationId: string;\n actingUser: SandboxActingUserIface;\n}\n\n// What an environment's hooks are given before anything starts.\nexport interface SandboxEnvironmentContextIface {\n bindings?: HostedBindingsIface;\n organizationId: string;\n guides: SandboxGuidesIface;\n}\n\n// Scoped by the host to this organization and provider. Providers can retain\n// reusable intermediate artifacts independently of a revision's seed files.\nexport interface SandboxArtifactsIface {\n get(key: string): Promise<JsonValue | null>;\n put(key: string, artifact: JsonValue): Promise<void>;\n}\n\nexport interface SandboxPreparationSourceIface {\n sourceRevision: string;\n read(): Promise<{ files: Record<string, string>; resources: Record<string, JsonValue> }>;\n}\n\nexport interface SandboxPrepareContextIface {\n bindings?: HostedBindingsIface;\n // A host-persisted resource source; artifacts may retain its identity instead of seed contents.\n preparation?: SandboxPreparationSourceIface;\n artifacts?: SandboxArtifactsIface;\n // Agent revisions supply workspace-relative seeds; setup-guide builds supply\n // guide.json and optional instructions.md. Resources name workspace, skills or guide.\n // Model instructions remain harness config.\n files: Record<string, string>;\n resources: Record<string, JsonValue>;\n sourceRevision: string;\n storagePath: string;\n organizationId: string;\n // The guide inputs (build-time) an environment names, resolved by the platform.\n guides: SandboxGuidesIface;\n // Who the session the artifact is prepared for acts for, for environments that\n // name a backend resource relative to that user; the key must then name it.\n actingUser: SandboxActingUserIface;\n log?: (message: string) => void;\n}\n\nexport interface SandboxStartContextIface {\n // Host policy composes before the provider's policy, on every exposed execution path.\n executionPolicy?: SandboxExecutionPolicyIface;\n bindings?: HostedBindingsIface;\n /** Passive recovery only: never wake, create, seed, or restart backend services. */\n passive?: boolean;\n preparation?: SandboxPreparationSourceIface;\n session: {\n id: string;\n organizationId: string;\n conversationId: string | null;\n definitionId: string;\n bindingId: string;\n // Stable logical identity supplied by the host, independent of provider resource names.\n workspaceId?: string;\n target: string;\n };\n storagePath: string;\n // Start-time inputs: guides, the variables to inject, repository credentials.\n guides: SandboxGuidesIface;\n variables: SandboxVariablesIface;\n repositories: SandboxRepositoriesIface;\n actingUser: SandboxActingUserIface;\n // Variables the platform sets in every process of this sandbox: the egress\n // proxy, trust for its CA, and one placeholder per bound secret. Evaluated\n // again for every spawn/run, never once per session: a secret bound\n // mid-session must reach the next command. May resolve to {} (no proxy\n // configured, or not ready yet). Platform values override the spec's env.\n platformEnvironment?: () => Promise<Record<string, string>>;\n // Hosts the sandbox must be able to reach for the proxy to work, to append\n // to any allowlist-mode network policy the spec declares.\n platformEgressHosts?: string[];\n // Reports the network policy now in force on the sandbox, exactly as the\n // provider applied it to its backend (after withPlatformEgressHosts). The\n // platform records it so the egress proxy serves only those destinations.\n // Called after awaitRunning and before platformFiles or any command, on start,\n // resume and a reused sandbox; never for a session's own setNetworkPolicy,\n // which the platform records itself. A rejection fails the start or resume.\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>;\n // Files the platform needs in the sandbox before any clone, setup step or\n // service runs: written right after the sandbox exists, on start and resume.\n // Paths are absolute; missing parent directories are created.\n platformFiles?: () => Promise<Record<string, string>>;\n}\n\n// The variables `platformEnvironment` owns. A spec that sets one (as a plain\n// value or an organization variable) is refused at start.\nexport const PLATFORM_ENVIRONMENT_NAMES: ReadonlySet<string> = new Set([\n 'HTTPS_PROXY',\n 'HTTP_PROXY',\n 'NO_PROXY',\n 'NODE_USE_ENV_PROXY',\n 'SSL_CERT_FILE',\n 'CURL_CA_BUNDLE',\n 'REQUESTS_CA_BUNDLE',\n 'GIT_SSL_CAINFO',\n 'CARGO_HTTP_CAINFO',\n 'DENO_CERT',\n 'NODE_EXTRA_CA_CERTS',\n 'FINAL_EGRESS_URL',\n 'FINAL_EGRESS_TOKEN',\n 'GH_TOKEN',\n 'GITHUB_TOKEN',\n]);\n\n// A process's base environment: the spec's variables under the platform's,\n// read again on every call.\nexport const platformProcessEnvironment =\n (\n ctx: Pick<SandboxStartContextIface, 'platformEnvironment'>,\n specEnv: Record<string, string>,\n ): (() => Promise<Record<string, string>>) =>\n async () => ({ ...specEnv, ...(await ctx.platformEnvironment?.()) });\n\n// Writes `platformFiles` into a sandbox that now exists, before it runs anything.\n// Relies on writeTextFile creating missing parent directories.\nexport const writePlatformFiles = async (\n ctx: Pick<SandboxStartContextIface, 'platformFiles'>,\n sandbox: Pick<SandboxSessionIface, 'writeTextFile'>,\n): Promise<void> => {\n for (const [path, content] of Object.entries((await ctx.platformFiles?.()) ?? {}))\n await sandbox.writeTextFile({ path, content });\n};\n\n// Reports the policy a provider just applied to its backend: `allow` only for an\n// allowlist, its entries (hosts, `*.suffix` patterns, CIDRs) unchanged.\nexport const reportPlatformNetworkPolicy = async (\n ctx: Pick<SandboxStartContextIface, 'platformNetworkPolicy'>,\n policy: NetworkPolicyIface,\n): Promise<void> =>\n ctx.platformNetworkPolicy(\n policy.mode === NetworkPolicy.Allowlist\n ? { mode: policy.mode, allow: [...(policy.allow ?? [])] }\n : { mode: policy.mode },\n );\n\n// An allowlist policy with the platform's egress hosts appended; any other\n// policy unchanged.\nexport const withPlatformEgressHosts = (\n ctx: Pick<SandboxStartContextIface, 'platformEgressHosts'>,\n policy: NetworkPolicyIface,\n): NetworkPolicyIface => {\n const hosts = ctx.platformEgressHosts ?? [];\n if (policy.mode !== NetworkPolicy.Allowlist || hosts.length === 0) return policy;\n return { ...policy, allow: [...new Set([...(policy.allow ?? []), ...hosts])] };\n};\n\nexport enum SandboxSessionEndReason {\n Completed = 'completed',\n Expired = 'expired',\n Failed = 'failed',\n}\n\n// How long an environment's sandbox outlives a session: `session`\n// keeps it for the session's life; `conversation` gives every session in the\n// conversation one shared sandbox per target, surviving session resets;\n// `ephemeral` discards it when released.\nexport enum SandboxWorkspace {\n Session = 'session',\n Conversation = 'conversation',\n Ephemeral = 'ephemeral',\n}\n\nexport interface SandboxProviderImplementationIface<\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n // The workspace this environment declares, read before anything starts so the\n // session service knows which sessions share a binding. Absent or null: session.\n workspace?(ctx: SandboxEnvironmentContextIface): Promise<SandboxWorkspace | null>;\n // The capabilities this environment's sandboxes offer, read before anything\n // starts through the backend's own API. Absent or null: unknown\n // until started; local MCP is then not projected.\n capabilities?(ctx: SandboxOfferContextIface): Promise<SandboxCapability[] | null>;\n // Known positive offers when the rest of the pre-start capability set is unknown.\n additionalCapabilities?(ctx: SandboxOfferContextIface): Promise<SandboxCapability[]>;\n // The hosted MCP servers' tool catalogs the backend can give without starting\n // a sandbox (from its own records), so the MCP projection lists them from the\n // first `tools/list`. The projection checks a server's catalog against the\n // live server when a call first opens that server (servers a session never\n // uses stay closed) and announces a change with\n // `notifications/tools/list_changed`.\n //\n // Trade-off: a catalog left unknown (absent hook, null, or a null field) can\n // only be learned from the live sandbox, so the first `tools/list` that finds\n // it unknown starts the sandbox in the background, at session start rather\n // than on the first tool call. Otherwise those tools would never be listed,\n // and nothing would ever call them. Providers that can give the catalog keep\n // attach lazy.\n mcpCatalog?(ctx: SandboxOfferContextIface): Promise<SandboxMcpCatalogIface | null>;\n // Reads committed files without starting/resuming a sandbox. Null means the backend\n // is live or offers no snapshot. An unavailable sleeping snapshot must throw,\n // never fall through to a read that wakes it. Pin subsequent ranges by snapshotId.\n readSnapshot?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxSnapshotRequestIface,\n ): Promise<SandboxSnapshotResponseIface | null>;\n // Inspect retained backend processes without opening, resuming or extending a sandbox.\n // Stop requires execute access; the provider also enforces backend ownership.\n processes?(\n ctx: SandboxOfferContextIface & { bindingId: string },\n state: State,\n request: ProcessInspectionRequestIface,\n ): Promise<ProcessInspectionResultIface>;\n // Browser editor for this provider's existing workspace. The host checks write\n // authorization; this hook never creates or wakes a backend. Credentials stay\n // in the authentication form, never the editor URL or stored provider state.\n editor?(\n ctx: SandboxOfferContextIface,\n state: State,\n request: SandboxEditorRequestIface,\n ): Promise<SandboxEditorResultIface>;\n // Content-addressed by `artifactKey`; the session service caches artifacts in\n // agent.sandbox_artifacts and calls prepare only on a miss.\n artifactKey(ctx: SandboxPrepareContextIface): Promise<string>;\n prepare(ctx: SandboxPrepareContextIface): Promise<Artifact>;\n // Resolves once the backend sandbox named by `state` is running and will\n // accept a command or a file write; rejects with a clear error after\n // `timeoutMs`. Backend-specific: the provider chooses the readiness signal,\n // the polling cadence and the backoff for its API's rate limits. The\n // platform never polls a backend itself.\n //\n // `start`, `resume` and `resumePassive` call it on the sandbox they just\n // created, started or reused, before anything touches it: create or start \u2192\n // state \u2192 awaitRunning \u2192 platformNetworkPolicy \u2192 platformFiles \u2192 repositories,\n // seeds, setup, services \u2192 handle. On timeout `start` fails and tears down.\n awaitRunning(\n ctx: SandboxStartContextIface,\n state: State,\n options: { timeoutMs: number },\n ): Promise<void>;\n // `region`: where the backend placed the sandbox (its own region name), so the\n // session service can place the harness near it; null when unknown.\n start(\n ctx: SandboxStartContextIface,\n options: OpenOptions | undefined,\n artifact: Artifact,\n ): Promise<{ handle: SandboxProviderHandleIface<S>; state: State; region?: string | null }>;\n resume(\n ctx: SandboxStartContextIface,\n artifact: Artifact,\n state: State,\n ): Promise<SandboxProviderHandleIface<S>>;\n // Reconnect to an already running backend after host restart for a read-only viewer.\n // Absent: viewers can use a retained live handle but cannot trigger resume.\n resumePassive?(\n ctx: SandboxStartContextIface,\n artifact: Artifact,\n state: State,\n ): Promise<SandboxProviderHandleIface<S>>;\n // Park: pause or stop the sandbox, returning the state resume needs.\n park?(ctx: SandboxStartContextIface, artifact: Artifact, state: State): Promise<State>;\n onSessionEnd?(\n ctx: SandboxStartContextIface,\n artifact: Artifact,\n state: State,\n options: { reason: SandboxSessionEndReason },\n ): Promise<void>;\n}\n\nexport interface SandboxProviderDefinitionIface<\n EnvOptions,\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n name: string;\n // The version of `State`'s shape. The session service records it with each\n // binding and refuses to resume a state written under another version (the\n // next call starts the sandbox again instead).\n stateProtocolVersion?: number;\n environment(\n options?: EnvOptions,\n ): SandboxProviderImplementationIface<OpenOptions, Artifact, State, S>;\n}\n\n// A defined provider: the definition plus authoring sugar. `environment(opts)`\n// returns an environment whose `.open(openOptions)` records a sandbox binding\n// target when authored, and is what the session service drives at run time.\nexport interface SandboxProviderIface<\n EnvOptions,\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n> {\n readonly definition: SandboxProviderDefinitionIface<EnvOptions, OpenOptions, Artifact, State, S>;\n readonly name: string;\n environment(options?: EnvOptions): AwaitableSandboxEnvironmentIface<EnvOptions, OpenOptions>;\n}\n\nexport interface SandboxEnvironmentIface<EnvOptions, OpenOptions> {\n readonly providerName: string;\n readonly options: EnvOptions | undefined;\n // Provider-authored notices shown by the compiler and Build before publication.\n readonly authoringWarnings?: readonly string[];\n // Authoring: records the open options (access, ...) for this target.\n open(options?: OpenOptions): SandboxOpenRequestIface<EnvOptions, OpenOptions>;\n}\n\n// An environment whose open request a sandbox.ts selector can await to get\n// the live session (open-scope.ts); what defineSandboxProvider and the\n// installed helpers return.\nexport interface AwaitableSandboxEnvironmentIface<\n EnvOptions,\n OpenOptions,\n> extends SandboxEnvironmentIface<EnvOptions, OpenOptions> {\n open(options?: OpenOptions): AwaitableSandboxOpenRequestIface<EnvOptions, OpenOptions>;\n}\n\nexport interface SandboxOpenRequestIface<EnvOptions, OpenOptions> {\n readonly providerName: string;\n readonly environmentOptions: EnvOptions | undefined;\n readonly openOptions: OpenOptions | undefined;\n readonly authoringWarnings?: readonly string[];\n}\n\nexport const defineSandboxProvider = <\n EnvOptions,\n OpenOptions,\n Artifact extends JsonValue,\n State extends JsonValue,\n S extends NetworkSandboxSessionIface,\n>(\n definition: SandboxProviderDefinitionIface<EnvOptions, OpenOptions, Artifact, State, S>,\n): SandboxProviderIface<EnvOptions, OpenOptions, Artifact, State, S> => ({\n definition: withSandboxOverrides(definition, {\n environment: (options?: EnvOptions) => {\n const implementation = definition.environment(options);\n if (typeof implementation.awaitRunning !== 'function')\n throw new Error(`sandbox provider ${definition.name} does not implement awaitRunning`);\n const overrides: Partial<typeof implementation> = {\n start: async (ctx, openOptions, artifact) => {\n const started = await implementation.start(ctx, openOptions, artifact);\n return {\n ...started,\n handle: createSandboxHandle({\n handle: started.handle,\n executionPolicy: ctx.executionPolicy,\n }),\n };\n },\n resume: async (ctx, artifact, state) =>\n createSandboxHandle({\n handle: await implementation.resume(ctx, artifact, state),\n executionPolicy: ctx.executionPolicy,\n }),\n };\n if (implementation.editor != null) {\n const editor = implementation.editor.bind(implementation);\n overrides.editor = async (ctx, state, request) => {\n if (\n request.operation === SandboxEditorOperation.Open ||\n request.operation === SandboxEditorOperation.Refresh\n )\n await ctx.executionPolicy?.beforeExecution({\n operation: SandboxExecutionOperation.Editor,\n background: false,\n });\n return editor(ctx, state, request);\n };\n }\n if (implementation.resumePassive != null) {\n const resumePassive = implementation.resumePassive.bind(implementation);\n overrides.resumePassive = async (ctx, artifact, state) =>\n createSandboxHandle({\n handle: await resumePassive(ctx, artifact, state),\n executionPolicy: ctx.executionPolicy,\n });\n }\n return withSandboxOverrides(implementation, overrides);\n },\n }),\n name: definition.name,\n environment: (options) => ({\n providerName: definition.name,\n options,\n open: (openOptions) =>\n awaitableOpenRequest({\n providerName: definition.name,\n environmentOptions: options,\n openOptions,\n }),\n }),\n});\n\n// Erased form the session service stores in its provider registry.\nexport type AnySandboxProviderIface = SandboxProviderIface<\n JsonValue,\n JsonValue,\n JsonValue,\n JsonValue,\n NetworkSandboxSessionIface\n>;\n\n// Events emitted through a sandbox provider's process lifecycle.\nexport enum SandboxEventKind {\n ProcessExited = 'process_exited',\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["SandboxEntryType", "PortProtocol", "SandboxCapability", "SandboxSessionEndReason", "SandboxWorkspace", "SandboxEventKind"]
7
7
  }
@@ -1,6 +1,8 @@
1
+ export { statSchema, dirEntrySchema } from "./file-schemas.mjs";
1
2
  import * as z from 'zod';
3
+ import { workspaceEgressRequestSchema, workspaceEgressStatusSchema } from '@finalai/agent-protocol/device-egress';
2
4
  import { type JsonValue } from "../json.mjs";
3
- import { NetworkPolicy, PortProtocol, SandboxCapability, SandboxEntryType } from "./types.mjs";
5
+ import { NetworkPolicy, PortProtocol, SandboxCapability } from "./types.mjs";
4
6
  export declare const HANDLE_RPC_VERSION = 1;
5
7
  export declare const HANDLE_RPC_SUBPROTOCOL = "final.handle-rpc.v1";
6
8
  export declare const HANDLE_RPC_BEARER_PROTOCOL_PREFIX = "bearer.";
@@ -47,6 +49,7 @@ export declare enum HandleRpcMethod {
47
49
  Stop = "sandbox/stop",
48
50
  Destroy = "sandbox/destroy",
49
51
  SetNetworkPolicy = "sandbox/setNetworkPolicy",
52
+ Egress = "sandbox/egress",
50
53
  OnSandboxStop = "handle/onSandboxStop",
51
54
  OnSandboxDelete = "handle/onSandboxDelete",
52
55
  OnRuntimeShutdown = "handle/onRuntimeShutdown",
@@ -124,19 +127,6 @@ export declare const handleRpcErrorDataSchema: z.ZodObject<{
124
127
  retryable: z.ZodOptional<z.ZodBoolean>;
125
128
  }, z.core.$strip>;
126
129
  export declare const sandboxCapabilitiesSchema: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<SandboxCapability[], string[]>>;
127
- export declare const statSchema: z.ZodObject<{
128
- path: z.ZodString;
129
- type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
130
- size: z.ZodNumber;
131
- modifiedAt: z.ZodNullable<z.ZodString>;
132
- mode: z.ZodNullable<z.ZodNumber>;
133
- }, z.core.$strip>;
134
- export declare const dirEntrySchema: z.ZodObject<{
135
- name: z.ZodString;
136
- path: z.ZodString;
137
- type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
138
- size: z.ZodNullable<z.ZodNumber>;
139
- }, z.core.$strip>;
140
130
  export declare const mcpEndpointSchema: z.ZodObject<{
141
131
  name: z.ZodString;
142
132
  url: z.ZodString;
@@ -253,7 +243,7 @@ export declare const pathParamsSchema: z.ZodObject<{
253
243
  export declare const statResultSchema: z.ZodObject<{
254
244
  stat: z.ZodNullable<z.ZodObject<{
255
245
  path: z.ZodString;
256
- type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
246
+ type: z.ZodPipe<z.ZodString, z.ZodTransform<import("./file-kind.mjs").SandboxEntryType, string>>;
257
247
  size: z.ZodNumber;
258
248
  modifiedAt: z.ZodNullable<z.ZodString>;
259
249
  mode: z.ZodNullable<z.ZodNumber>;
@@ -263,7 +253,7 @@ export declare const readDirResultSchema: z.ZodObject<{
263
253
  entries: z.ZodArray<z.ZodObject<{
264
254
  name: z.ZodString;
265
255
  path: z.ZodString;
266
- type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
256
+ type: z.ZodPipe<z.ZodString, z.ZodTransform<import("./file-kind.mjs").SandboxEntryType, string>>;
267
257
  size: z.ZodNullable<z.ZodNumber>;
268
258
  }, z.core.$strip>>;
269
259
  }, z.core.$strip>;
@@ -464,7 +454,7 @@ export declare const handleRpcMethodSchemas: {
464
454
  readonly result: z.ZodObject<{
465
455
  stat: z.ZodNullable<z.ZodObject<{
466
456
  path: z.ZodString;
467
- type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
457
+ type: z.ZodPipe<z.ZodString, z.ZodTransform<import("./file-kind.mjs").SandboxEntryType, string>>;
468
458
  size: z.ZodNumber;
469
459
  modifiedAt: z.ZodNullable<z.ZodString>;
470
460
  mode: z.ZodNullable<z.ZodNumber>;
@@ -480,7 +470,7 @@ export declare const handleRpcMethodSchemas: {
480
470
  entries: z.ZodArray<z.ZodObject<{
481
471
  name: z.ZodString;
482
472
  path: z.ZodString;
483
- type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
473
+ type: z.ZodPipe<z.ZodString, z.ZodTransform<import("./file-kind.mjs").SandboxEntryType, string>>;
484
474
  size: z.ZodNullable<z.ZodNumber>;
485
475
  }, z.core.$strip>>;
486
476
  }, z.core.$strip>;
@@ -532,6 +522,20 @@ export declare const handleRpcMethodSchemas: {
532
522
  }, z.core.$strip>;
533
523
  readonly result: z.ZodObject<{}, z.core.$loose>;
534
524
  };
525
+ readonly "sandbox/egress": {
526
+ readonly params: z.ZodObject<{
527
+ action: z.ZodEnum<typeof import("@finalai/agent-protocol").WorkspaceEgressAction>;
528
+ deviceIds: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodUUID, z.ZodTransform<string, string>>>>;
529
+ dnsResolvers: z.ZodOptional<z.ZodArray<z.ZodIPv4>>;
530
+ }, z.core.$strip>;
531
+ readonly result: z.ZodObject<{
532
+ mode: z.ZodString;
533
+ leaseId: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
534
+ expiresAtMs: z.ZodNullable<z.ZodNumber>;
535
+ deviceId: z.ZodNullable<z.ZodString>;
536
+ path: z.ZodNullable<z.ZodString>;
537
+ }, z.core.$strip>;
538
+ };
535
539
  readonly "sandbox/computerUse": {
536
540
  readonly params: z.ZodObject<{}, z.core.$loose>;
537
541
  readonly result: z.ZodUnion<readonly [z.ZodObject<{
@@ -669,3 +673,4 @@ export declare const encodeJsonRpc: (message: JsonValue) => string;
669
673
  export declare const handleRpcTokenFromRequest: (request: Request) => string | null;
670
674
  export declare const handleRpcClientProtocols: (token: string) => string[];
671
675
  export * from "./frame-channel.mjs";
676
+ export { workspaceEgressRequestSchema, workspaceEgressStatusSchema };
@@ -1,6 +1,12 @@
1
+ import { statSchema, dirEntrySchema } from "./file-schemas.mjs";
2
+ import { statSchema as statSchema2, dirEntrySchema as dirEntrySchema2 } from "./file-schemas.mjs";
1
3
  import * as z from "zod";
4
+ import {
5
+ workspaceEgressRequestSchema,
6
+ workspaceEgressStatusSchema
7
+ } from "@finalai/agent-protocol/device-egress";
2
8
  import { jsonValueSchema } from "../json.mjs";
3
- import { NetworkPolicy, PortProtocol, SandboxCapability, SandboxEntryType } from "./types.mjs";
9
+ import { NetworkPolicy, PortProtocol, SandboxCapability } from "./types.mjs";
4
10
  const HANDLE_RPC_VERSION = 1;
5
11
  const HANDLE_RPC_SUBPROTOCOL = "final.handle-rpc.v1";
6
12
  const HANDLE_RPC_BEARER_PROTOCOL_PREFIX = "bearer.";
@@ -51,6 +57,7 @@ var HandleRpcMethod = /* @__PURE__ */ ((HandleRpcMethod2) => {
51
57
  HandleRpcMethod2["Stop"] = "sandbox/stop";
52
58
  HandleRpcMethod2["Destroy"] = "sandbox/destroy";
53
59
  HandleRpcMethod2["SetNetworkPolicy"] = "sandbox/setNetworkPolicy";
60
+ HandleRpcMethod2["Egress"] = "sandbox/egress";
54
61
  HandleRpcMethod2["OnSandboxStop"] = "handle/onSandboxStop";
55
62
  HandleRpcMethod2["OnSandboxDelete"] = "handle/onSandboxDelete";
56
63
  HandleRpcMethod2["OnRuntimeShutdown"] = "handle/onRuntimeShutdown";
@@ -126,21 +133,6 @@ const streamIdSchema = z.number().int().min(0).max(MAX_STREAM_ID);
126
133
  const pathSchema = z.string().min(1);
127
134
  const isSandboxCapability = (value) => Object.values(SandboxCapability).some((capability) => capability === value);
128
135
  const sandboxCapabilitiesSchema = z.array(z.string()).transform((values) => values.filter(isSandboxCapability));
129
- const isSandboxEntryType = (value) => Object.values(SandboxEntryType).some((entryType) => entryType === value);
130
- const entryTypeSchema = z.string().transform((value) => isSandboxEntryType(value) ? value : SandboxEntryType.Other);
131
- const statSchema = z.object({
132
- path: z.string(),
133
- type: entryTypeSchema,
134
- size: z.number().nonnegative(),
135
- modifiedAt: z.string().nullable(),
136
- mode: z.number().int().nullable()
137
- });
138
- const dirEntrySchema = z.object({
139
- name: z.string(),
140
- path: z.string(),
141
- type: entryTypeSchema,
142
- size: z.number().nonnegative().nullable()
143
- });
144
136
  const mcpEndpointSchema = z.object({
145
137
  name: z.string(),
146
138
  url: z.string(),
@@ -313,6 +305,10 @@ const handleRpcMethodSchemas = {
313
305
  params: setNetworkPolicyParamsSchema,
314
306
  result: emptyResultSchema
315
307
  },
308
+ ["sandbox/egress" /* Egress */]: {
309
+ params: workspaceEgressRequestSchema,
310
+ result: workspaceEgressStatusSchema
311
+ },
316
312
  ["sandbox/computerUse" /* ComputerUse */]: { params: emptySchema, result: sandboxMcpEndpointSchema },
317
313
  ["sandbox/screen" /* Screen */]: { params: screenOptionsSchema, result: screenSessionSchema },
318
314
  ["sandbox/localMcp" /* LocalMcp */]: { params: emptySchema, result: localMcpResultSchema },
@@ -353,6 +349,7 @@ const handleRpcResultParsers = {
353
349
  ["handle/onSandboxStop" /* OnSandboxStop */]: (raw) => handleRpcMethodSchemas["handle/onSandboxStop" /* OnSandboxStop */].result.parse(raw),
354
350
  ["handle/onSandboxDelete" /* OnSandboxDelete */]: (raw) => handleRpcMethodSchemas["handle/onSandboxDelete" /* OnSandboxDelete */].result.parse(raw),
355
351
  ["sandbox/setNetworkPolicy" /* SetNetworkPolicy */]: (raw) => handleRpcMethodSchemas["sandbox/setNetworkPolicy" /* SetNetworkPolicy */].result.parse(raw),
352
+ ["sandbox/egress" /* Egress */]: (raw) => handleRpcMethodSchemas["sandbox/egress" /* Egress */].result.parse(raw),
356
353
  ["sandbox/computerUse" /* ComputerUse */]: (raw) => handleRpcMethodSchemas["sandbox/computerUse" /* ComputerUse */].result.parse(raw),
357
354
  ["sandbox/screen" /* Screen */]: (raw) => handleRpcMethodSchemas["sandbox/screen" /* Screen */].result.parse(raw),
358
355
  ["sandbox/localMcp" /* LocalMcp */]: (raw) => handleRpcMethodSchemas["sandbox/localMcp" /* LocalMcp */].result.parse(raw),
@@ -385,7 +382,8 @@ const HANDLE_RPC_EXECUTE_METHODS = [
385
382
  ];
386
383
  const HANDLE_RPC_WRITE_METHODS = [
387
384
  ...HANDLE_RPC_FILE_WRITE_METHODS,
388
- ...HANDLE_RPC_EXECUTE_METHODS
385
+ ...HANDLE_RPC_EXECUTE_METHODS,
386
+ "sandbox/egress" /* Egress */
389
387
  ];
390
388
  const HANDLE_RPC_LIFECYCLE_METHODS = [
391
389
  "handle/onSandboxStop" /* OnSandboxStop */,
@@ -393,7 +391,8 @@ const HANDLE_RPC_LIFECYCLE_METHODS = [
393
391
  "handle/onRuntimeShutdown" /* OnRuntimeShutdown */,
394
392
  "sandbox/stop" /* Stop */,
395
393
  "sandbox/destroy" /* Destroy */,
396
- "sandbox/setNetworkPolicy" /* SetNetworkPolicy */
394
+ "sandbox/setNetworkPolicy" /* SetNetworkPolicy */,
395
+ "sandbox/egress" /* Egress */
397
396
  ];
398
397
  const HANDLE_RPC_IDEMPOTENT_METHODS = [
399
398
  "sandbox/describe" /* Describe */,
@@ -474,7 +473,7 @@ export {
474
473
  cancelRequestParamsSchema,
475
474
  decodeBinaryFrame,
476
475
  describeResultSchema,
477
- dirEntrySchema,
476
+ dirEntrySchema2 as dirEntrySchema,
478
477
  encodeChunkFrame,
479
478
  encodeJsonRpc,
480
479
  errnoOf,
@@ -526,12 +525,14 @@ export {
526
525
  spawnParamsSchema,
527
526
  spawnResultSchema,
528
527
  statResultSchema,
529
- statSchema,
528
+ statSchema2 as statSchema,
530
529
  streamCancelParamsSchema,
531
530
  streamChunkParamsSchema,
532
531
  streamCreditParamsSchema,
533
532
  streamEndParamsSchema,
534
533
  streamErrorParamsSchema,
534
+ workspaceEgressRequestSchema,
535
+ workspaceEgressStatusSchema,
535
536
  writeFileParamsSchema
536
537
  };
537
538
  //# sourceMappingURL=wire.mjs.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/wire.ts"],
4
- "sourcesContent": ["import * as z from 'zod';\nimport { jsonValueSchema, type JsonValue } from \"../json.mjs\";\nimport { NetworkPolicy, PortProtocol, SandboxCapability, SandboxEntryType } from \"./types.mjs\";\n\n// The sandbox handle RPC: an SDK-defined,\n// provider-neutral wire with one method per NetworkSandboxSessionIface method,\n// carried over one persistent WebSocket (or any ordered message stream).\n//\n// Framing\n// - Text frames are JSON-RPC 2.0 messages (single messages, no batches).\n// - Binary frames carry stream data: a 6-byte header followed by the payload.\n// byte 0 magic 0xF1\n// byte 1 BinaryFrameKind (1 = chunk)\n// bytes 2-5 stream id, uint32 big-endian\n// A peer that cannot send binary frames sends `stream/chunk` notifications\n// with base64 data instead; every peer accepts both forms.\n//\n// Connection\n// - The client authenticates in the connection request (WebSocket\n// subprotocol `bearer.<token>` next to HANDLE_RPC_SUBPROTOCOL, or an\n// `Authorization: Bearer` header where the runtime allows headers) and again\n// in the first message, `initialize { handleRpcVersion: 1, token }`, which is\n// the only authentication on transports without a connection request.\n// - Nothing but `initialize` is accepted before initialization.\n// - `initialize` returns what `sandbox/describe` returns.\n// - Lazy attach: the session service's stable per-binding address may start\n// the sandbox (through its provider) while handling the first call, and\n// serves every call on that connection itself; there is no redirect.\n// - `auth/refresh { token }` replaces the connection's credential before it\n// expires; a server closes a connection whose credential expired with\n// HandleRpcCloseCode.Unauthorized, and the client reconnects with a fresh one.\n// - `$/cancel_request { requestId }` cancels an in-flight request.\n//\n// Streams\n// - Every stream id is allocated by the client (uint32, unique per connection)\n// and named in the request that uses it: `sandbox/readFile.streamId` and\n// `sandbox/spawn.stdoutStreamId/stderrStreamId` flow server to client,\n// `sandbox/writeFile.streamId` and `sandbox/spawn.stdinStreamId` flow client\n// to server. The receiver registers a stream before the first chunk can\n// arrive (the client before sending the request, the server when it receives\n// it), so chunks are never orphaned.\n// - Flow control is credit based: a sender may have at most\n// INITIAL_STREAM_WINDOW_BYTES unacknowledged bytes per stream; the receiver\n// returns credit with `stream/credit { streamId, bytes }` as its consumer\n// reads. Chunks are at most MAX_CHUNK_BYTES.\n// - `stream/end` closes a stream, `stream/error` fails it, and\n// `stream/cancel` (receiver to sender) stops it.\n// - Streams and process handles are scoped to one connection: if the\n// connection closes, the server kills that connection's processes and both\n// sides fail its open streams.\n\nexport const HANDLE_RPC_VERSION = 1;\nexport const HANDLE_RPC_SUBPROTOCOL = 'final.handle-rpc.v1';\nexport const HANDLE_RPC_BEARER_PROTOCOL_PREFIX = 'bearer.';\nexport const MAX_CHUNK_BYTES = 256 * 1024;\nexport const INITIAL_STREAM_WINDOW_BYTES = 1024 * 1024;\n// Inline (base64) file writes up to this size skip the stream round trip.\nexport const MAX_INLINE_WRITE_BYTES = 64 * 1024;\nexport const BINARY_FRAME_MAGIC = 0xf1;\nexport const BINARY_FRAME_HEADER_BYTES = 6;\nconst MAX_STREAM_ID = 0xffffffff;\n\nexport enum BinaryFrameKind {\n Chunk = 1,\n}\n\nexport enum HandleRpcCloseCode {\n Normal = 1000,\n ProtocolError = 4400,\n Unauthorized = 4401,\n}\n\nexport enum HandleRpcErrorCode {\n ParseError = -32700,\n InvalidRequest = -32600,\n MethodNotFound = -32601,\n InvalidParams = -32602,\n Internal = -32603,\n Unauthorized = -32001,\n NotInitialized = -32002,\n // Rejected by the binding's access policy (a read-only binding writing).\n Forbidden = -32010,\n NotFound = -32011,\n // The sandbox does not have the capability.\n Unsupported = -32012,\n // Client side: the connection closed before the request was answered.\n ConnectionClosed = -32013,\n Timeout = -32014,\n Cancelled = -32800,\n}\n\nexport enum HandleRpcMethod {\n Initialize = 'initialize',\n Describe = 'sandbox/describe',\n ReadFile = 'sandbox/readFile',\n ReadTextFile = 'sandbox/readTextFile',\n WriteFile = 'sandbox/writeFile',\n Spawn = 'sandbox/spawn',\n Run = 'sandbox/run',\n Stat = 'sandbox/stat',\n ReadDir = 'sandbox/readDir',\n RemovePath = 'sandbox/removePath',\n GetPortEndpoint = 'sandbox/getPortEndpoint',\n Stop = 'sandbox/stop',\n Destroy = 'sandbox/destroy',\n SetNetworkPolicy = 'sandbox/setNetworkPolicy',\n OnSandboxStop = 'handle/onSandboxStop',\n OnSandboxDelete = 'handle/onSandboxDelete',\n OnRuntimeShutdown = 'handle/onRuntimeShutdown',\n ComputerUse = 'sandbox/computerUse',\n Screen = 'sandbox/screen',\n LocalMcp = 'sandbox/localMcp',\n McpOpen = 'mcp/open',\n McpSend = 'mcp/send',\n McpReceive = 'mcp/receive',\n McpClose = 'mcp/close',\n ProcessWait = 'process/wait',\n ProcessKill = 'process/kill',\n AuthRefresh = 'auth/refresh',\n}\n\nexport enum HandleRpcNotification {\n CancelRequest = '$/cancel_request',\n StreamChunk = 'stream/chunk',\n StreamEnd = 'stream/end',\n StreamError = 'stream/error',\n StreamCredit = 'stream/credit',\n StreamCancel = 'stream/cancel',\n}\n\n// Errors carry a numeric HandleRpcErrorCode plus the sandbox's errno-style code\n// (ENOENT, ENOTDIR, ...) when it had one.\nexport interface HandleRpcErrorIface extends Error {\n readonly code: HandleRpcErrorCode;\n readonly retryable: boolean;\n readonly errno: string | null;\n readonly data: JsonValue | null;\n}\n\nexport const handleRpcError = (args: {\n code: HandleRpcErrorCode;\n message: string;\n retryable?: boolean;\n errno?: string | null;\n data?: JsonValue | null;\n}): HandleRpcErrorIface =>\n Object.assign(new Error(args.message), {\n name: 'HandleRpcError',\n code: args.code,\n retryable: args.retryable ?? false,\n errno: args.errno ?? null,\n data: args.data ?? null,\n });\n\nconst handleRpcErrorFieldsSchema = z.object({ code: z.number(), retryable: z.boolean() });\nconst errnoFieldsSchema = z.object({ code: z.string() });\n\nexport const isHandleRpcError = (cause: unknown): cause is HandleRpcErrorIface =>\n cause instanceof Error && handleRpcErrorFieldsSchema.safeParse(cause).success;\n\n// The errno-style string code of a sandbox error (`ENOENT`), if any.\nexport const errnoOf = (cause: unknown): string | null => {\n if (isHandleRpcError(cause)) return cause.errno;\n if (!(cause instanceof Error)) return null;\n const parsed = errnoFieldsSchema.safeParse(cause);\n return parsed.success ? parsed.data.code : null;\n};\n\nconst jsonRpcIdSchema = z.union([z.string(), z.number().int()]);\nexport type JsonRpcId = z.infer<typeof jsonRpcIdSchema>;\n\nexport const jsonRpcRequestSchema = z.object({\n jsonrpc: z.literal('2.0'),\n id: jsonRpcIdSchema,\n method: z.string().min(1),\n params: jsonValueSchema.optional(),\n});\n\nexport const jsonRpcNotificationSchema = z.object({\n jsonrpc: z.literal('2.0'),\n method: z.string().min(1),\n params: jsonValueSchema.optional(),\n});\n\nexport const jsonRpcErrorObjectSchema = z.object({\n code: z.number().int(),\n message: z.string(),\n data: jsonValueSchema.optional(),\n});\n\nexport const jsonRpcSuccessSchema = z.object({\n jsonrpc: z.literal('2.0'),\n id: jsonRpcIdSchema,\n result: jsonValueSchema,\n});\n\nexport const jsonRpcErrorResponseSchema = z.object({\n jsonrpc: z.literal('2.0'),\n id: jsonRpcIdSchema.nullable(),\n error: jsonRpcErrorObjectSchema,\n});\n\nexport type JsonRpcRequestIface = z.infer<typeof jsonRpcRequestSchema>;\nexport type JsonRpcNotificationIface = z.infer<typeof jsonRpcNotificationSchema>;\nexport type JsonRpcErrorObjectIface = z.infer<typeof jsonRpcErrorObjectSchema>;\n\n// Data in error responses: { errno, retryable } when known.\nexport const handleRpcErrorDataSchema = z.object({\n errno: z.string().nullable().optional(),\n retryable: z.boolean().optional(),\n});\n\nconst streamIdSchema = z.number().int().min(0).max(MAX_STREAM_ID);\nconst pathSchema = z.string().min(1);\n\n// Tolerant on read: capabilities this build does not know are dropped.\nconst isSandboxCapability = (value: string): value is SandboxCapability =>\n Object.values(SandboxCapability).some((capability) => capability === value);\nexport const sandboxCapabilitiesSchema = z\n .array(z.string())\n .transform((values) => values.filter(isSandboxCapability));\n\nconst isSandboxEntryType = (value: string): value is SandboxEntryType =>\n Object.values(SandboxEntryType).some((entryType) => entryType === value);\nconst entryTypeSchema = z\n .string()\n .transform((value) => (isSandboxEntryType(value) ? value : SandboxEntryType.Other));\n\nexport const statSchema = z.object({\n path: z.string(),\n type: entryTypeSchema,\n size: z.number().nonnegative(),\n modifiedAt: z.string().nullable(),\n mode: z.number().int().nullable(),\n});\n\nexport const dirEntrySchema = z.object({\n name: z.string(),\n path: z.string(),\n type: entryTypeSchema,\n size: z.number().nonnegative().nullable(),\n});\n\nexport const mcpEndpointSchema = z.object({\n name: z.string(),\n url: z.string(),\n headers: z.record(z.string(), z.string()),\n});\n\n// In-process channels are advertised only by hosts enabling the channel bridge.\nexport const mcpChannelEndpointSchema = z.object({\n name: z.string(),\n endpointKey: z.string().min(1),\n});\nexport const sandboxMcpEndpointSchema = z.union([mcpEndpointSchema, mcpChannelEndpointSchema]);\n\nexport const screenOptionsSchema = z.strictObject({ viewOnly: z.boolean().default(true) });\n\nexport const screenSessionSchema = z.object({\n url: z.string(),\n token: z.string(),\n expiresAt: z.string(),\n});\n\nexport const describeResultSchema = z.object({\n handleRpcVersion: z.literal(HANDLE_RPC_VERSION),\n id: z.string(),\n defaultWorkingDirectory: z.string(),\n ports: z.array(z.number().int()),\n capabilities: sandboxCapabilitiesSchema,\n description: z.string(),\n confinedFiles: z.boolean().optional(),\n providerHooks: z.boolean().optional(),\n mcpChannels: z.boolean().optional(),\n});\n\nexport const initializeParamsSchema = z.object({\n handleRpcVersion: z.literal(HANDLE_RPC_VERSION),\n token: z.string().nullable().optional(),\n client: z.object({ name: z.string(), version: z.string() }).optional(),\n});\n\nexport const initializeResultSchema = describeResultSchema.extend({\n // When the connection's credential expires (null: never).\n expiresAt: z.string().nullable(),\n});\n\nconst emptySchema = z.object({}).passthrough();\nconst emptyResultSchema = z.object({}).passthrough();\n\nconst processOptionFields = {\n command: z.string().min(1),\n args: z.array(z.string()).optional(),\n cwd: z.string().optional(),\n env: z.record(z.string(), z.string()).optional(),\n shell: z.boolean().optional(),\n timeoutMs: z.number().int().positive().optional(),\n};\n\nexport const readFileParamsSchema = z.object({\n root: pathSchema.optional(),\n path: pathSchema,\n streamId: streamIdSchema,\n // Byte range; omitted reads the whole file.\n offset: z.number().int().nonnegative().optional(),\n length: z.number().int().nonnegative().optional(),\n});\n\nexport const readFileResultSchema = z.object({\n found: z.boolean(),\n});\n\nexport const readTextFileParamsSchema = z.object({\n path: pathSchema,\n encoding: z.string().optional(),\n startLine: z.number().int().positive().optional(),\n endLine: z.number().int().positive().optional(),\n});\n\nexport const readTextFileResultSchema = z.object({ text: z.string().nullable() });\n\nexport const writeFileParamsSchema = z\n .object({\n path: pathSchema,\n streamId: streamIdSchema.optional(),\n contentBase64: z.string().optional(),\n })\n .refine((params) => (params.streamId == null) !== (params.contentBase64 == null), {\n message: 'exactly one of streamId and contentBase64 is required',\n });\n\nexport const spawnParamsSchema = z.object({\n ...processOptionFields,\n // Client-chosen handle for process/wait and process/kill.\n processId: z.string().min(1),\n // Null means stdin is closed from the start.\n stdinStreamId: streamIdSchema.nullable(),\n stdoutStreamId: streamIdSchema,\n stderrStreamId: streamIdSchema,\n});\n\nexport const spawnResultSchema = z.object({ pid: z.string().nullable() });\n\nexport const runParamsSchema = z.object({\n ...processOptionFields,\n stdin: z.string().optional(),\n});\n\nexport const runResultSchema = z.object({\n exitCode: z.number().int(),\n stdout: z.string(),\n stderr: z.string(),\n});\n\nexport const pathParamsSchema = z.object({ path: pathSchema, root: pathSchema.optional() });\nexport const statResultSchema = z.object({ stat: statSchema.nullable() });\nexport const readDirResultSchema = z.object({ entries: z.array(dirEntrySchema) });\n\nexport const removePathParamsSchema = z.object({\n path: pathSchema,\n recursive: z.boolean().optional(),\n force: z.boolean().optional(),\n});\n\nexport const getPortEndpointParamsSchema = z.object({\n port: z.number().int().min(1).max(65535),\n protocol: z.nativeEnum(PortProtocol).optional(),\n});\n\nexport const getPortEndpointResultSchema = z.object({\n url: z.string(),\n headers: z.record(z.string(), z.string()).optional(),\n});\n\nexport const setNetworkPolicyParamsSchema = z.object({\n mode: z.nativeEnum(NetworkPolicy),\n allow: z.array(z.string()).optional(),\n});\n\nexport const sandboxDeleteHookParamsSchema = z.object({ reason: z.string().optional() });\n\nexport const localMcpResultSchema = z.object({ endpoints: z.array(sandboxMcpEndpointSchema) });\nexport const mcpOpenParamsSchema = z.object({ endpointKey: z.string().min(1) });\nexport const mcpChannelParamsSchema = z.object({ channelId: z.string().min(1) });\nexport const mcpSendParamsSchema = mcpChannelParamsSchema.extend({ message: jsonValueSchema });\nexport const mcpOpenResultSchema = mcpChannelParamsSchema;\nexport const mcpReceiveResultSchema = z.object({ messages: z.array(jsonValueSchema) });\n\nexport const processIdParamsSchema = z.object({ processId: z.string().min(1) });\nexport const processWaitResultSchema = z.object({ exitCode: z.number().int() });\nexport const processKillParamsSchema = z.object({\n processId: z.string().min(1),\n signal: z.string().optional(),\n});\n\nexport const authRefreshParamsSchema = z.object({ token: z.string().min(1) });\nexport const authRefreshResultSchema = z.object({ expiresAt: z.string().nullable() });\n\nexport const cancelRequestParamsSchema = z.object({ requestId: jsonRpcIdSchema });\nexport const streamChunkParamsSchema = z.object({ streamId: streamIdSchema, data: z.string() });\nexport const streamEndParamsSchema = z.object({ streamId: streamIdSchema });\nexport const streamErrorParamsSchema = z.object({\n streamId: streamIdSchema,\n message: z.string(),\n code: z.number().int().optional(),\n errno: z.string().nullable().optional(),\n});\nexport const streamCreditParamsSchema = z.object({\n streamId: streamIdSchema,\n bytes: z.number().int().positive(),\n});\nexport const streamCancelParamsSchema = z.object({\n streamId: streamIdSchema,\n reason: z.string().optional(),\n});\n\nexport type DescribeResultIface = z.infer<typeof describeResultSchema>;\nexport type InitializeResultIface = z.infer<typeof initializeResultSchema>;\n\n// Params and result schema for every request method: the single source of\n// truth for both ends.\nexport const handleRpcMethodSchemas = {\n [HandleRpcMethod.Initialize]: { params: initializeParamsSchema, result: initializeResultSchema },\n [HandleRpcMethod.Describe]: { params: emptySchema, result: describeResultSchema },\n [HandleRpcMethod.ReadFile]: { params: readFileParamsSchema, result: readFileResultSchema },\n [HandleRpcMethod.ReadTextFile]: {\n params: readTextFileParamsSchema,\n result: readTextFileResultSchema,\n },\n [HandleRpcMethod.WriteFile]: { params: writeFileParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.Spawn]: { params: spawnParamsSchema, result: spawnResultSchema },\n [HandleRpcMethod.Run]: { params: runParamsSchema, result: runResultSchema },\n [HandleRpcMethod.Stat]: { params: pathParamsSchema, result: statResultSchema },\n [HandleRpcMethod.ReadDir]: { params: pathParamsSchema, result: readDirResultSchema },\n [HandleRpcMethod.RemovePath]: { params: removePathParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.GetPortEndpoint]: {\n params: getPortEndpointParamsSchema,\n result: getPortEndpointResultSchema,\n },\n [HandleRpcMethod.Stop]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.Destroy]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.OnSandboxStop]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.OnSandboxDelete]: {\n params: sandboxDeleteHookParamsSchema,\n result: emptyResultSchema,\n },\n [HandleRpcMethod.OnRuntimeShutdown]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.SetNetworkPolicy]: {\n params: setNetworkPolicyParamsSchema,\n result: emptyResultSchema,\n },\n [HandleRpcMethod.ComputerUse]: { params: emptySchema, result: sandboxMcpEndpointSchema },\n [HandleRpcMethod.Screen]: { params: screenOptionsSchema, result: screenSessionSchema },\n [HandleRpcMethod.LocalMcp]: { params: emptySchema, result: localMcpResultSchema },\n [HandleRpcMethod.McpOpen]: { params: mcpOpenParamsSchema, result: mcpOpenResultSchema },\n [HandleRpcMethod.McpSend]: { params: mcpSendParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.McpReceive]: { params: mcpChannelParamsSchema, result: mcpReceiveResultSchema },\n [HandleRpcMethod.McpClose]: { params: mcpChannelParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.ProcessWait]: { params: processIdParamsSchema, result: processWaitResultSchema },\n [HandleRpcMethod.ProcessKill]: { params: processKillParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.AuthRefresh]: {\n params: authRefreshParamsSchema,\n result: authRefreshResultSchema,\n },\n} as const satisfies Record<HandleRpcMethod, { params: z.ZodType; result: z.ZodType }>;\n\nexport const handleRpcNotificationSchemas = {\n [HandleRpcNotification.CancelRequest]: cancelRequestParamsSchema,\n [HandleRpcNotification.StreamChunk]: streamChunkParamsSchema,\n [HandleRpcNotification.StreamEnd]: streamEndParamsSchema,\n [HandleRpcNotification.StreamError]: streamErrorParamsSchema,\n [HandleRpcNotification.StreamCredit]: streamCreditParamsSchema,\n [HandleRpcNotification.StreamCancel]: streamCancelParamsSchema,\n} as const satisfies Record<HandleRpcNotification, z.ZodType>;\n\nexport type HandleRpcParams<M extends HandleRpcMethod> = z.input<\n (typeof handleRpcMethodSchemas)[M]['params']\n>;\nexport type HandleRpcResult<M extends HandleRpcMethod> = z.output<\n (typeof handleRpcMethodSchemas)[M]['result']\n>;\nexport type HandleRpcNotificationParams<N extends HandleRpcNotification> = z.input<\n (typeof handleRpcNotificationSchemas)[N]\n>;\n\n// Typed result parsers, so generic callers get HandleRpcResult<M>.\nexport type HandleRpcResultParsers = {\n [M in HandleRpcMethod]: (raw: JsonValue) => HandleRpcResult<M>;\n};\n\nexport const handleRpcResultParsers: HandleRpcResultParsers = {\n [HandleRpcMethod.Initialize]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw),\n [HandleRpcMethod.Describe]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Describe].result.parse(raw),\n [HandleRpcMethod.ReadFile]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ReadFile].result.parse(raw),\n [HandleRpcMethod.ReadTextFile]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ReadTextFile].result.parse(raw),\n [HandleRpcMethod.WriteFile]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.WriteFile].result.parse(raw),\n [HandleRpcMethod.Spawn]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Spawn].result.parse(raw),\n [HandleRpcMethod.Run]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Run].result.parse(raw),\n [HandleRpcMethod.Stat]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Stat].result.parse(raw),\n [HandleRpcMethod.ReadDir]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ReadDir].result.parse(raw),\n [HandleRpcMethod.RemovePath]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.RemovePath].result.parse(raw),\n [HandleRpcMethod.GetPortEndpoint]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.GetPortEndpoint].result.parse(raw),\n [HandleRpcMethod.Stop]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Stop].result.parse(raw),\n [HandleRpcMethod.Destroy]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Destroy].result.parse(raw),\n [HandleRpcMethod.OnRuntimeShutdown]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.OnRuntimeShutdown].result.parse(raw),\n [HandleRpcMethod.OnSandboxStop]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.OnSandboxStop].result.parse(raw),\n [HandleRpcMethod.OnSandboxDelete]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.OnSandboxDelete].result.parse(raw),\n [HandleRpcMethod.SetNetworkPolicy]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.SetNetworkPolicy].result.parse(raw),\n [HandleRpcMethod.ComputerUse]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ComputerUse].result.parse(raw),\n [HandleRpcMethod.Screen]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Screen].result.parse(raw),\n [HandleRpcMethod.LocalMcp]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.LocalMcp].result.parse(raw),\n [HandleRpcMethod.McpOpen]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpOpen].result.parse(raw),\n [HandleRpcMethod.McpSend]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpSend].result.parse(raw),\n [HandleRpcMethod.McpReceive]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpReceive].result.parse(raw),\n [HandleRpcMethod.McpClose]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpClose].result.parse(raw),\n [HandleRpcMethod.ProcessWait]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ProcessWait].result.parse(raw),\n [HandleRpcMethod.ProcessKill]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ProcessKill].result.parse(raw),\n [HandleRpcMethod.AuthRefresh]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.AuthRefresh].result.parse(raw),\n};\n\nexport const parseHandleRpcResult = <M extends HandleRpcMethod>(\n method: M,\n raw: JsonValue,\n): HandleRpcResult<M> => handleRpcResultParsers[method](raw);\n\nconst isHandleRpcMethod = (value: string): value is HandleRpcMethod =>\n Object.values(HandleRpcMethod).some((method) => method === value);\n\nexport const parseHandleRpcMethod = (method: string): HandleRpcMethod | null =>\n isHandleRpcMethod(method) ? method : null;\n\n// Methods that write files; rejected below write access.\nexport const HANDLE_RPC_FILE_WRITE_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.WriteFile,\n HandleRpcMethod.RemovePath,\n];\n\n// Methods that run processes or act on the machine; rejected below execute access.\nexport const HANDLE_RPC_EXECUTE_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.Spawn,\n HandleRpcMethod.Run,\n HandleRpcMethod.ProcessWait,\n HandleRpcMethod.ProcessKill,\n HandleRpcMethod.ComputerUse,\n HandleRpcMethod.LocalMcp,\n HandleRpcMethod.McpOpen,\n HandleRpcMethod.McpSend,\n HandleRpcMethod.McpReceive,\n HandleRpcMethod.McpClose,\n];\n\n// Methods that change the sandbox; rejected on read-only bindings.\nexport const HANDLE_RPC_WRITE_METHODS: readonly HandleRpcMethod[] = [\n ...HANDLE_RPC_FILE_WRITE_METHODS,\n ...HANDLE_RPC_EXECUTE_METHODS,\n];\n\n// Lifecycle and policy methods; rejected unless the binding allows lifecycle.\nexport const HANDLE_RPC_LIFECYCLE_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.OnSandboxStop,\n HandleRpcMethod.OnSandboxDelete,\n HandleRpcMethod.OnRuntimeShutdown,\n HandleRpcMethod.Stop,\n HandleRpcMethod.Destroy,\n HandleRpcMethod.SetNetworkPolicy,\n];\n\n// Safe to re-issue after a connection loss.\nexport const HANDLE_RPC_IDEMPOTENT_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.Describe,\n HandleRpcMethod.ReadTextFile,\n HandleRpcMethod.Stat,\n HandleRpcMethod.ReadDir,\n HandleRpcMethod.GetPortEndpoint,\n HandleRpcMethod.Screen,\n HandleRpcMethod.ComputerUse,\n HandleRpcMethod.LocalMcp,\n];\n\nexport const encodeChunkFrame = (streamId: number, payload: Uint8Array): Uint8Array => {\n const frame = new Uint8Array(BINARY_FRAME_HEADER_BYTES + payload.byteLength);\n frame[0] = BINARY_FRAME_MAGIC;\n frame[1] = BinaryFrameKind.Chunk;\n new DataView(frame.buffer, frame.byteOffset, frame.byteLength).setUint32(2, streamId, false);\n frame.set(payload, BINARY_FRAME_HEADER_BYTES);\n return frame;\n};\n\nexport const decodeBinaryFrame = (\n frame: Uint8Array,\n): { kind: BinaryFrameKind; streamId: number; payload: Uint8Array } | null => {\n if (frame.byteLength < BINARY_FRAME_HEADER_BYTES || frame[0] !== BINARY_FRAME_MAGIC) return null;\n if (frame[1] !== BinaryFrameKind.Chunk) return null;\n const streamId = new DataView(frame.buffer, frame.byteOffset, frame.byteLength).getUint32(\n 2,\n false,\n );\n return {\n kind: BinaryFrameKind.Chunk,\n streamId,\n payload: frame.subarray(BINARY_FRAME_HEADER_BYTES),\n };\n};\n\nexport const encodeJsonRpc = (message: JsonValue): string => JSON.stringify(message);\n\n// Extracts the bearer token from an upgrade request: `Authorization: Bearer`\n// first, then a `bearer.<token>` entry in Sec-WebSocket-Protocol.\nexport const handleRpcTokenFromRequest = (request: Request): string | null => {\n const authorization = request.headers.get('authorization');\n if (authorization != null) {\n const match = /^Bearer\\s+(.+)$/i.exec(authorization.trim());\n if (match?.[1] != null) return match[1];\n }\n const protocols = request.headers.get('sec-websocket-protocol');\n if (protocols != null) {\n for (const entry of protocols.split(',')) {\n const value = entry.trim();\n if (value.startsWith(HANDLE_RPC_BEARER_PROTOCOL_PREFIX)) {\n const token = value.slice(HANDLE_RPC_BEARER_PROTOCOL_PREFIX.length);\n if (token.length > 0) return token;\n }\n }\n }\n return null;\n};\n\n// Subprotocols a client offers; the server answers HANDLE_RPC_SUBPROTOCOL.\nexport const handleRpcClientProtocols = (token: string): string[] => [\n HANDLE_RPC_SUBPROTOCOL,\n `${HANDLE_RPC_BEARER_PROTOCOL_PREFIX}${token}`,\n];\n\nexport * from \"./frame-channel.mjs\";\n"],
5
- "mappings": "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",
6
- "names": ["BinaryFrameKind", "HandleRpcCloseCode", "HandleRpcErrorCode", "HandleRpcMethod", "HandleRpcNotification"]
4
+ "sourcesContent": ["import { statSchema, dirEntrySchema } from \"./file-schemas.mjs\";\nexport { statSchema, dirEntrySchema } from \"./file-schemas.mjs\";\nimport * as z from 'zod';\nimport {\n workspaceEgressRequestSchema,\n workspaceEgressStatusSchema,\n} from '@finalai/agent-protocol/device-egress';\nimport { jsonValueSchema, type JsonValue } from \"../json.mjs\";\nimport { NetworkPolicy, PortProtocol, SandboxCapability } from \"./types.mjs\";\n\n// The sandbox handle RPC: an SDK-defined,\n// provider-neutral wire with one method per NetworkSandboxSessionIface method,\n// carried over one persistent WebSocket (or any ordered message stream).\n//\n// Framing\n// - Text frames are JSON-RPC 2.0 messages (single messages, no batches).\n// - Binary frames carry stream data: a 6-byte header followed by the payload.\n// byte 0 magic 0xF1\n// byte 1 BinaryFrameKind (1 = chunk)\n// bytes 2-5 stream id, uint32 big-endian\n// A peer that cannot send binary frames sends `stream/chunk` notifications\n// with base64 data instead; every peer accepts both forms.\n//\n// Connection\n// - The client authenticates in the connection request (WebSocket\n// subprotocol `bearer.<token>` next to HANDLE_RPC_SUBPROTOCOL, or an\n// `Authorization: Bearer` header where the runtime allows headers) and again\n// in the first message, `initialize { handleRpcVersion: 1, token }`, which is\n// the only authentication on transports without a connection request.\n// - Nothing but `initialize` is accepted before initialization.\n// - `initialize` returns what `sandbox/describe` returns.\n// - Lazy attach: the session service's stable per-binding address may start\n// the sandbox (through its provider) while handling the first call, and\n// serves every call on that connection itself; there is no redirect.\n// - `auth/refresh { token }` replaces the connection's credential before it\n// expires; a server closes a connection whose credential expired with\n// HandleRpcCloseCode.Unauthorized, and the client reconnects with a fresh one.\n// - `$/cancel_request { requestId }` cancels an in-flight request.\n//\n// Streams\n// - Every stream id is allocated by the client (uint32, unique per connection)\n// and named in the request that uses it: `sandbox/readFile.streamId` and\n// `sandbox/spawn.stdoutStreamId/stderrStreamId` flow server to client,\n// `sandbox/writeFile.streamId` and `sandbox/spawn.stdinStreamId` flow client\n// to server. The receiver registers a stream before the first chunk can\n// arrive (the client before sending the request, the server when it receives\n// it), so chunks are never orphaned.\n// - Flow control is credit based: a sender may have at most\n// INITIAL_STREAM_WINDOW_BYTES unacknowledged bytes per stream; the receiver\n// returns credit with `stream/credit { streamId, bytes }` as its consumer\n// reads. Chunks are at most MAX_CHUNK_BYTES.\n// - `stream/end` closes a stream, `stream/error` fails it, and\n// `stream/cancel` (receiver to sender) stops it.\n// - Streams and process handles are scoped to one connection: if the\n// connection closes, the server kills that connection's processes and both\n// sides fail its open streams.\n\nexport const HANDLE_RPC_VERSION = 1;\nexport const HANDLE_RPC_SUBPROTOCOL = 'final.handle-rpc.v1';\nexport const HANDLE_RPC_BEARER_PROTOCOL_PREFIX = 'bearer.';\nexport const MAX_CHUNK_BYTES = 256 * 1024;\nexport const INITIAL_STREAM_WINDOW_BYTES = 1024 * 1024;\n// Inline (base64) file writes up to this size skip the stream round trip.\nexport const MAX_INLINE_WRITE_BYTES = 64 * 1024;\nexport const BINARY_FRAME_MAGIC = 0xf1;\nexport const BINARY_FRAME_HEADER_BYTES = 6;\nconst MAX_STREAM_ID = 0xffffffff;\n\nexport enum BinaryFrameKind {\n Chunk = 1,\n}\n\nexport enum HandleRpcCloseCode {\n Normal = 1000,\n ProtocolError = 4400,\n Unauthorized = 4401,\n}\n\nexport enum HandleRpcErrorCode {\n ParseError = -32700,\n InvalidRequest = -32600,\n MethodNotFound = -32601,\n InvalidParams = -32602,\n Internal = -32603,\n Unauthorized = -32001,\n NotInitialized = -32002,\n // Rejected by the binding's access policy (a read-only binding writing).\n Forbidden = -32010,\n NotFound = -32011,\n // The sandbox does not have the capability.\n Unsupported = -32012,\n // Client side: the connection closed before the request was answered.\n ConnectionClosed = -32013,\n Timeout = -32014,\n Cancelled = -32800,\n}\n\nexport enum HandleRpcMethod {\n Initialize = 'initialize',\n Describe = 'sandbox/describe',\n ReadFile = 'sandbox/readFile',\n ReadTextFile = 'sandbox/readTextFile',\n WriteFile = 'sandbox/writeFile',\n Spawn = 'sandbox/spawn',\n Run = 'sandbox/run',\n Stat = 'sandbox/stat',\n ReadDir = 'sandbox/readDir',\n RemovePath = 'sandbox/removePath',\n GetPortEndpoint = 'sandbox/getPortEndpoint',\n Stop = 'sandbox/stop',\n Destroy = 'sandbox/destroy',\n SetNetworkPolicy = 'sandbox/setNetworkPolicy',\n Egress = 'sandbox/egress',\n OnSandboxStop = 'handle/onSandboxStop',\n OnSandboxDelete = 'handle/onSandboxDelete',\n OnRuntimeShutdown = 'handle/onRuntimeShutdown',\n ComputerUse = 'sandbox/computerUse',\n Screen = 'sandbox/screen',\n LocalMcp = 'sandbox/localMcp',\n McpOpen = 'mcp/open',\n McpSend = 'mcp/send',\n McpReceive = 'mcp/receive',\n McpClose = 'mcp/close',\n ProcessWait = 'process/wait',\n ProcessKill = 'process/kill',\n AuthRefresh = 'auth/refresh',\n}\n\nexport enum HandleRpcNotification {\n CancelRequest = '$/cancel_request',\n StreamChunk = 'stream/chunk',\n StreamEnd = 'stream/end',\n StreamError = 'stream/error',\n StreamCredit = 'stream/credit',\n StreamCancel = 'stream/cancel',\n}\n\n// Errors carry a numeric HandleRpcErrorCode plus the sandbox's errno-style code\n// (ENOENT, ENOTDIR, ...) when it had one.\nexport interface HandleRpcErrorIface extends Error {\n readonly code: HandleRpcErrorCode;\n readonly retryable: boolean;\n readonly errno: string | null;\n readonly data: JsonValue | null;\n}\n\nexport const handleRpcError = (args: {\n code: HandleRpcErrorCode;\n message: string;\n retryable?: boolean;\n errno?: string | null;\n data?: JsonValue | null;\n}): HandleRpcErrorIface =>\n Object.assign(new Error(args.message), {\n name: 'HandleRpcError',\n code: args.code,\n retryable: args.retryable ?? false,\n errno: args.errno ?? null,\n data: args.data ?? null,\n });\n\nconst handleRpcErrorFieldsSchema = z.object({ code: z.number(), retryable: z.boolean() });\nconst errnoFieldsSchema = z.object({ code: z.string() });\n\nexport const isHandleRpcError = (cause: unknown): cause is HandleRpcErrorIface =>\n cause instanceof Error && handleRpcErrorFieldsSchema.safeParse(cause).success;\n\n// The errno-style string code of a sandbox error (`ENOENT`), if any.\nexport const errnoOf = (cause: unknown): string | null => {\n if (isHandleRpcError(cause)) return cause.errno;\n if (!(cause instanceof Error)) return null;\n const parsed = errnoFieldsSchema.safeParse(cause);\n return parsed.success ? parsed.data.code : null;\n};\n\nconst jsonRpcIdSchema = z.union([z.string(), z.number().int()]);\nexport type JsonRpcId = z.infer<typeof jsonRpcIdSchema>;\n\nexport const jsonRpcRequestSchema = z.object({\n jsonrpc: z.literal('2.0'),\n id: jsonRpcIdSchema,\n method: z.string().min(1),\n params: jsonValueSchema.optional(),\n});\n\nexport const jsonRpcNotificationSchema = z.object({\n jsonrpc: z.literal('2.0'),\n method: z.string().min(1),\n params: jsonValueSchema.optional(),\n});\n\nexport const jsonRpcErrorObjectSchema = z.object({\n code: z.number().int(),\n message: z.string(),\n data: jsonValueSchema.optional(),\n});\n\nexport const jsonRpcSuccessSchema = z.object({\n jsonrpc: z.literal('2.0'),\n id: jsonRpcIdSchema,\n result: jsonValueSchema,\n});\n\nexport const jsonRpcErrorResponseSchema = z.object({\n jsonrpc: z.literal('2.0'),\n id: jsonRpcIdSchema.nullable(),\n error: jsonRpcErrorObjectSchema,\n});\n\nexport type JsonRpcRequestIface = z.infer<typeof jsonRpcRequestSchema>;\nexport type JsonRpcNotificationIface = z.infer<typeof jsonRpcNotificationSchema>;\nexport type JsonRpcErrorObjectIface = z.infer<typeof jsonRpcErrorObjectSchema>;\n\n// Data in error responses: { errno, retryable } when known.\nexport const handleRpcErrorDataSchema = z.object({\n errno: z.string().nullable().optional(),\n retryable: z.boolean().optional(),\n});\n\nconst streamIdSchema = z.number().int().min(0).max(MAX_STREAM_ID);\nconst pathSchema = z.string().min(1);\n\n// Tolerant on read: capabilities this build does not know are dropped.\nconst isSandboxCapability = (value: string): value is SandboxCapability =>\n Object.values(SandboxCapability).some((capability) => capability === value);\nexport const sandboxCapabilitiesSchema = z\n .array(z.string())\n .transform((values) => values.filter(isSandboxCapability));\n\nexport const mcpEndpointSchema = z.object({\n name: z.string(),\n url: z.string(),\n headers: z.record(z.string(), z.string()),\n});\n\n// In-process channels are advertised only by hosts enabling the channel bridge.\nexport const mcpChannelEndpointSchema = z.object({\n name: z.string(),\n endpointKey: z.string().min(1),\n});\nexport const sandboxMcpEndpointSchema = z.union([mcpEndpointSchema, mcpChannelEndpointSchema]);\n\nexport const screenOptionsSchema = z.strictObject({ viewOnly: z.boolean().default(true) });\n\nexport const screenSessionSchema = z.object({\n url: z.string(),\n token: z.string(),\n expiresAt: z.string(),\n});\n\nexport const describeResultSchema = z.object({\n handleRpcVersion: z.literal(HANDLE_RPC_VERSION),\n id: z.string(),\n defaultWorkingDirectory: z.string(),\n ports: z.array(z.number().int()),\n capabilities: sandboxCapabilitiesSchema,\n description: z.string(),\n confinedFiles: z.boolean().optional(),\n providerHooks: z.boolean().optional(),\n mcpChannels: z.boolean().optional(),\n});\n\nexport const initializeParamsSchema = z.object({\n handleRpcVersion: z.literal(HANDLE_RPC_VERSION),\n token: z.string().nullable().optional(),\n client: z.object({ name: z.string(), version: z.string() }).optional(),\n});\n\nexport const initializeResultSchema = describeResultSchema.extend({\n // When the connection's credential expires (null: never).\n expiresAt: z.string().nullable(),\n});\n\nconst emptySchema = z.object({}).passthrough();\nconst emptyResultSchema = z.object({}).passthrough();\n\nconst processOptionFields = {\n command: z.string().min(1),\n args: z.array(z.string()).optional(),\n cwd: z.string().optional(),\n env: z.record(z.string(), z.string()).optional(),\n shell: z.boolean().optional(),\n timeoutMs: z.number().int().positive().optional(),\n};\n\nexport const readFileParamsSchema = z.object({\n root: pathSchema.optional(),\n path: pathSchema,\n streamId: streamIdSchema,\n // Byte range; omitted reads the whole file.\n offset: z.number().int().nonnegative().optional(),\n length: z.number().int().nonnegative().optional(),\n});\n\nexport const readFileResultSchema = z.object({\n found: z.boolean(),\n});\n\nexport const readTextFileParamsSchema = z.object({\n path: pathSchema,\n encoding: z.string().optional(),\n startLine: z.number().int().positive().optional(),\n endLine: z.number().int().positive().optional(),\n});\n\nexport const readTextFileResultSchema = z.object({ text: z.string().nullable() });\n\nexport const writeFileParamsSchema = z\n .object({\n path: pathSchema,\n streamId: streamIdSchema.optional(),\n contentBase64: z.string().optional(),\n })\n .refine((params) => (params.streamId == null) !== (params.contentBase64 == null), {\n message: 'exactly one of streamId and contentBase64 is required',\n });\n\nexport const spawnParamsSchema = z.object({\n ...processOptionFields,\n // Client-chosen handle for process/wait and process/kill.\n processId: z.string().min(1),\n // Null means stdin is closed from the start.\n stdinStreamId: streamIdSchema.nullable(),\n stdoutStreamId: streamIdSchema,\n stderrStreamId: streamIdSchema,\n});\n\nexport const spawnResultSchema = z.object({ pid: z.string().nullable() });\n\nexport const runParamsSchema = z.object({\n ...processOptionFields,\n stdin: z.string().optional(),\n});\n\nexport const runResultSchema = z.object({\n exitCode: z.number().int(),\n stdout: z.string(),\n stderr: z.string(),\n});\n\nexport const pathParamsSchema = z.object({ path: pathSchema, root: pathSchema.optional() });\nexport const statResultSchema = z.object({ stat: statSchema.nullable() });\nexport const readDirResultSchema = z.object({ entries: z.array(dirEntrySchema) });\n\nexport const removePathParamsSchema = z.object({\n path: pathSchema,\n recursive: z.boolean().optional(),\n force: z.boolean().optional(),\n});\n\nexport const getPortEndpointParamsSchema = z.object({\n port: z.number().int().min(1).max(65535),\n protocol: z.nativeEnum(PortProtocol).optional(),\n});\n\nexport const getPortEndpointResultSchema = z.object({\n url: z.string(),\n headers: z.record(z.string(), z.string()).optional(),\n});\n\nexport const setNetworkPolicyParamsSchema = z.object({\n mode: z.nativeEnum(NetworkPolicy),\n allow: z.array(z.string()).optional(),\n});\n\nexport const sandboxDeleteHookParamsSchema = z.object({ reason: z.string().optional() });\n\nexport const localMcpResultSchema = z.object({ endpoints: z.array(sandboxMcpEndpointSchema) });\nexport const mcpOpenParamsSchema = z.object({ endpointKey: z.string().min(1) });\nexport const mcpChannelParamsSchema = z.object({ channelId: z.string().min(1) });\nexport const mcpSendParamsSchema = mcpChannelParamsSchema.extend({ message: jsonValueSchema });\nexport const mcpOpenResultSchema = mcpChannelParamsSchema;\nexport const mcpReceiveResultSchema = z.object({ messages: z.array(jsonValueSchema) });\n\nexport const processIdParamsSchema = z.object({ processId: z.string().min(1) });\nexport const processWaitResultSchema = z.object({ exitCode: z.number().int() });\nexport const processKillParamsSchema = z.object({\n processId: z.string().min(1),\n signal: z.string().optional(),\n});\n\nexport const authRefreshParamsSchema = z.object({ token: z.string().min(1) });\nexport const authRefreshResultSchema = z.object({ expiresAt: z.string().nullable() });\n\nexport const cancelRequestParamsSchema = z.object({ requestId: jsonRpcIdSchema });\nexport const streamChunkParamsSchema = z.object({ streamId: streamIdSchema, data: z.string() });\nexport const streamEndParamsSchema = z.object({ streamId: streamIdSchema });\nexport const streamErrorParamsSchema = z.object({\n streamId: streamIdSchema,\n message: z.string(),\n code: z.number().int().optional(),\n errno: z.string().nullable().optional(),\n});\nexport const streamCreditParamsSchema = z.object({\n streamId: streamIdSchema,\n bytes: z.number().int().positive(),\n});\nexport const streamCancelParamsSchema = z.object({\n streamId: streamIdSchema,\n reason: z.string().optional(),\n});\n\nexport type DescribeResultIface = z.infer<typeof describeResultSchema>;\nexport type InitializeResultIface = z.infer<typeof initializeResultSchema>;\n\n// Params and result schema for every request method: the single source of\n// truth for both ends.\nexport const handleRpcMethodSchemas = {\n [HandleRpcMethod.Initialize]: { params: initializeParamsSchema, result: initializeResultSchema },\n [HandleRpcMethod.Describe]: { params: emptySchema, result: describeResultSchema },\n [HandleRpcMethod.ReadFile]: { params: readFileParamsSchema, result: readFileResultSchema },\n [HandleRpcMethod.ReadTextFile]: {\n params: readTextFileParamsSchema,\n result: readTextFileResultSchema,\n },\n [HandleRpcMethod.WriteFile]: { params: writeFileParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.Spawn]: { params: spawnParamsSchema, result: spawnResultSchema },\n [HandleRpcMethod.Run]: { params: runParamsSchema, result: runResultSchema },\n [HandleRpcMethod.Stat]: { params: pathParamsSchema, result: statResultSchema },\n [HandleRpcMethod.ReadDir]: { params: pathParamsSchema, result: readDirResultSchema },\n [HandleRpcMethod.RemovePath]: { params: removePathParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.GetPortEndpoint]: {\n params: getPortEndpointParamsSchema,\n result: getPortEndpointResultSchema,\n },\n [HandleRpcMethod.Stop]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.Destroy]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.OnSandboxStop]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.OnSandboxDelete]: {\n params: sandboxDeleteHookParamsSchema,\n result: emptyResultSchema,\n },\n [HandleRpcMethod.OnRuntimeShutdown]: { params: emptySchema, result: emptyResultSchema },\n [HandleRpcMethod.SetNetworkPolicy]: {\n params: setNetworkPolicyParamsSchema,\n result: emptyResultSchema,\n },\n [HandleRpcMethod.Egress]: {\n params: workspaceEgressRequestSchema,\n result: workspaceEgressStatusSchema,\n },\n [HandleRpcMethod.ComputerUse]: { params: emptySchema, result: sandboxMcpEndpointSchema },\n [HandleRpcMethod.Screen]: { params: screenOptionsSchema, result: screenSessionSchema },\n [HandleRpcMethod.LocalMcp]: { params: emptySchema, result: localMcpResultSchema },\n [HandleRpcMethod.McpOpen]: { params: mcpOpenParamsSchema, result: mcpOpenResultSchema },\n [HandleRpcMethod.McpSend]: { params: mcpSendParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.McpReceive]: { params: mcpChannelParamsSchema, result: mcpReceiveResultSchema },\n [HandleRpcMethod.McpClose]: { params: mcpChannelParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.ProcessWait]: { params: processIdParamsSchema, result: processWaitResultSchema },\n [HandleRpcMethod.ProcessKill]: { params: processKillParamsSchema, result: emptyResultSchema },\n [HandleRpcMethod.AuthRefresh]: {\n params: authRefreshParamsSchema,\n result: authRefreshResultSchema,\n },\n} as const satisfies Record<HandleRpcMethod, { params: z.ZodType; result: z.ZodType }>;\n\nexport const handleRpcNotificationSchemas = {\n [HandleRpcNotification.CancelRequest]: cancelRequestParamsSchema,\n [HandleRpcNotification.StreamChunk]: streamChunkParamsSchema,\n [HandleRpcNotification.StreamEnd]: streamEndParamsSchema,\n [HandleRpcNotification.StreamError]: streamErrorParamsSchema,\n [HandleRpcNotification.StreamCredit]: streamCreditParamsSchema,\n [HandleRpcNotification.StreamCancel]: streamCancelParamsSchema,\n} as const satisfies Record<HandleRpcNotification, z.ZodType>;\n\nexport type HandleRpcParams<M extends HandleRpcMethod> = z.input<\n (typeof handleRpcMethodSchemas)[M]['params']\n>;\nexport type HandleRpcResult<M extends HandleRpcMethod> = z.output<\n (typeof handleRpcMethodSchemas)[M]['result']\n>;\nexport type HandleRpcNotificationParams<N extends HandleRpcNotification> = z.input<\n (typeof handleRpcNotificationSchemas)[N]\n>;\n\n// Typed result parsers, so generic callers get HandleRpcResult<M>.\nexport type HandleRpcResultParsers = {\n [M in HandleRpcMethod]: (raw: JsonValue) => HandleRpcResult<M>;\n};\n\nexport const handleRpcResultParsers: HandleRpcResultParsers = {\n [HandleRpcMethod.Initialize]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw),\n [HandleRpcMethod.Describe]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Describe].result.parse(raw),\n [HandleRpcMethod.ReadFile]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ReadFile].result.parse(raw),\n [HandleRpcMethod.ReadTextFile]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ReadTextFile].result.parse(raw),\n [HandleRpcMethod.WriteFile]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.WriteFile].result.parse(raw),\n [HandleRpcMethod.Spawn]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Spawn].result.parse(raw),\n [HandleRpcMethod.Run]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Run].result.parse(raw),\n [HandleRpcMethod.Stat]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Stat].result.parse(raw),\n [HandleRpcMethod.ReadDir]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ReadDir].result.parse(raw),\n [HandleRpcMethod.RemovePath]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.RemovePath].result.parse(raw),\n [HandleRpcMethod.GetPortEndpoint]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.GetPortEndpoint].result.parse(raw),\n [HandleRpcMethod.Stop]: (raw) => handleRpcMethodSchemas[HandleRpcMethod.Stop].result.parse(raw),\n [HandleRpcMethod.Destroy]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Destroy].result.parse(raw),\n [HandleRpcMethod.OnRuntimeShutdown]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.OnRuntimeShutdown].result.parse(raw),\n [HandleRpcMethod.OnSandboxStop]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.OnSandboxStop].result.parse(raw),\n [HandleRpcMethod.OnSandboxDelete]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.OnSandboxDelete].result.parse(raw),\n [HandleRpcMethod.SetNetworkPolicy]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.SetNetworkPolicy].result.parse(raw),\n [HandleRpcMethod.Egress]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Egress].result.parse(raw),\n [HandleRpcMethod.ComputerUse]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ComputerUse].result.parse(raw),\n [HandleRpcMethod.Screen]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.Screen].result.parse(raw),\n [HandleRpcMethod.LocalMcp]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.LocalMcp].result.parse(raw),\n [HandleRpcMethod.McpOpen]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpOpen].result.parse(raw),\n [HandleRpcMethod.McpSend]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpSend].result.parse(raw),\n [HandleRpcMethod.McpReceive]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpReceive].result.parse(raw),\n [HandleRpcMethod.McpClose]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.McpClose].result.parse(raw),\n [HandleRpcMethod.ProcessWait]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ProcessWait].result.parse(raw),\n [HandleRpcMethod.ProcessKill]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.ProcessKill].result.parse(raw),\n [HandleRpcMethod.AuthRefresh]: (raw) =>\n handleRpcMethodSchemas[HandleRpcMethod.AuthRefresh].result.parse(raw),\n};\n\nexport const parseHandleRpcResult = <M extends HandleRpcMethod>(\n method: M,\n raw: JsonValue,\n): HandleRpcResult<M> => handleRpcResultParsers[method](raw);\n\nconst isHandleRpcMethod = (value: string): value is HandleRpcMethod =>\n Object.values(HandleRpcMethod).some((method) => method === value);\n\nexport const parseHandleRpcMethod = (method: string): HandleRpcMethod | null =>\n isHandleRpcMethod(method) ? method : null;\n\n// Methods that write files; rejected below write access.\nexport const HANDLE_RPC_FILE_WRITE_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.WriteFile,\n HandleRpcMethod.RemovePath,\n];\n\n// Methods that run processes or act on the machine; rejected below execute access.\nexport const HANDLE_RPC_EXECUTE_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.Spawn,\n HandleRpcMethod.Run,\n HandleRpcMethod.ProcessWait,\n HandleRpcMethod.ProcessKill,\n HandleRpcMethod.ComputerUse,\n HandleRpcMethod.LocalMcp,\n HandleRpcMethod.McpOpen,\n HandleRpcMethod.McpSend,\n HandleRpcMethod.McpReceive,\n HandleRpcMethod.McpClose,\n];\n\n// Methods that change the sandbox; rejected on read-only bindings.\n// Egress consent is action-aware and enforced separately; the capability requires write/lifecycle access.\nexport const HANDLE_RPC_WRITE_METHODS: readonly HandleRpcMethod[] = [\n ...HANDLE_RPC_FILE_WRITE_METHODS,\n ...HANDLE_RPC_EXECUTE_METHODS,\n HandleRpcMethod.Egress,\n];\n\n// Lifecycle and policy methods; rejected unless the binding allows lifecycle.\nexport const HANDLE_RPC_LIFECYCLE_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.OnSandboxStop,\n HandleRpcMethod.OnSandboxDelete,\n HandleRpcMethod.OnRuntimeShutdown,\n HandleRpcMethod.Stop,\n HandleRpcMethod.Destroy,\n HandleRpcMethod.SetNetworkPolicy,\n HandleRpcMethod.Egress,\n];\n\n// Safe to re-issue after a connection loss.\nexport const HANDLE_RPC_IDEMPOTENT_METHODS: readonly HandleRpcMethod[] = [\n HandleRpcMethod.Describe,\n HandleRpcMethod.ReadTextFile,\n HandleRpcMethod.Stat,\n HandleRpcMethod.ReadDir,\n HandleRpcMethod.GetPortEndpoint,\n HandleRpcMethod.Screen,\n HandleRpcMethod.ComputerUse,\n HandleRpcMethod.LocalMcp,\n];\n\nexport const encodeChunkFrame = (streamId: number, payload: Uint8Array): Uint8Array => {\n const frame = new Uint8Array(BINARY_FRAME_HEADER_BYTES + payload.byteLength);\n frame[0] = BINARY_FRAME_MAGIC;\n frame[1] = BinaryFrameKind.Chunk;\n new DataView(frame.buffer, frame.byteOffset, frame.byteLength).setUint32(2, streamId, false);\n frame.set(payload, BINARY_FRAME_HEADER_BYTES);\n return frame;\n};\n\nexport const decodeBinaryFrame = (\n frame: Uint8Array,\n): { kind: BinaryFrameKind; streamId: number; payload: Uint8Array } | null => {\n if (frame.byteLength < BINARY_FRAME_HEADER_BYTES || frame[0] !== BINARY_FRAME_MAGIC) return null;\n if (frame[1] !== BinaryFrameKind.Chunk) return null;\n const streamId = new DataView(frame.buffer, frame.byteOffset, frame.byteLength).getUint32(\n 2,\n false,\n );\n return {\n kind: BinaryFrameKind.Chunk,\n streamId,\n payload: frame.subarray(BINARY_FRAME_HEADER_BYTES),\n };\n};\n\nexport const encodeJsonRpc = (message: JsonValue): string => JSON.stringify(message);\n\n// Extracts the bearer token from an upgrade request: `Authorization: Bearer`\n// first, then a `bearer.<token>` entry in Sec-WebSocket-Protocol.\nexport const handleRpcTokenFromRequest = (request: Request): string | null => {\n const authorization = request.headers.get('authorization');\n if (authorization != null) {\n const match = /^Bearer\\s+(.+)$/i.exec(authorization.trim());\n if (match?.[1] != null) return match[1];\n }\n const protocols = request.headers.get('sec-websocket-protocol');\n if (protocols != null) {\n for (const entry of protocols.split(',')) {\n const value = entry.trim();\n if (value.startsWith(HANDLE_RPC_BEARER_PROTOCOL_PREFIX)) {\n const token = value.slice(HANDLE_RPC_BEARER_PROTOCOL_PREFIX.length);\n if (token.length > 0) return token;\n }\n }\n }\n return null;\n};\n\n// Subprotocols a client offers; the server answers HANDLE_RPC_SUBPROTOCOL.\nexport const handleRpcClientProtocols = (token: string): string[] => [\n HANDLE_RPC_SUBPROTOCOL,\n `${HANDLE_RPC_BEARER_PROTOCOL_PREFIX}${token}`,\n];\n\nexport * from \"./frame-channel.mjs\";\n\nexport { workspaceEgressRequestSchema, workspaceEgressStatusSchema };\n"],
5
+ "mappings": "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",
6
+ "names": ["statSchema", "dirEntrySchema", "BinaryFrameKind", "HandleRpcCloseCode", "HandleRpcErrorCode", "HandleRpcMethod", "HandleRpcNotification"]
7
7
  }
@@ -0,0 +1,5 @@
1
+ import { SandboxWorkspace, type SandboxStartContextIface } from "./types.mjs";
2
+ export declare const sandboxWorkspaceId: (args: {
3
+ session: Pick<SandboxStartContextIface["session"], "bindingId" | "conversationId" | "target" | "workspaceId">;
4
+ workspace: SandboxWorkspace;
5
+ }) => string;
@@ -0,0 +1,14 @@
1
+ import { SandboxWorkspace } from "./types.mjs";
2
+ const encodeIdentityPart = (value) => {
3
+ if (!value.isWellFormed()) throw new Error("Workspace identity must contain valid Unicode");
4
+ return encodeURIComponent(value);
5
+ };
6
+ const sandboxWorkspaceId = (args) => {
7
+ const id = args.session.workspaceId ?? (args.workspace === SandboxWorkspace.Conversation && args.session.conversationId != null ? `conversation:${encodeIdentityPart(args.session.conversationId)}:${encodeIdentityPart(args.session.target)}` : `binding:${encodeIdentityPart(args.session.bindingId)}`);
8
+ if (id.length === 0) throw new Error("Supply a nonempty stable workspaceId");
9
+ return id;
10
+ };
11
+ export {
12
+ sandboxWorkspaceId
13
+ };
14
+ //# sourceMappingURL=workspace-identity.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../src/sandbox/workspace-identity.ts"],
4
+ "sourcesContent": ["import { SandboxWorkspace, type SandboxStartContextIface } from \"./types.mjs\";\n\nconst encodeIdentityPart = (value: string): string => {\n if (!value.isWellFormed()) throw new Error('Workspace identity must contain valid Unicode');\n return encodeURIComponent(value);\n};\n\n// Conversation workspaces survive replacement bindings; other workspaces belong to their binding.\nexport const sandboxWorkspaceId = (args: {\n session: Pick<\n SandboxStartContextIface['session'],\n 'bindingId' | 'conversationId' | 'target' | 'workspaceId'\n >;\n workspace: SandboxWorkspace;\n}): string => {\n const id =\n args.session.workspaceId ??\n (args.workspace === SandboxWorkspace.Conversation && args.session.conversationId != null\n ? `conversation:${encodeIdentityPart(args.session.conversationId)}:${encodeIdentityPart(args.session.target)}`\n : `binding:${encodeIdentityPart(args.session.bindingId)}`);\n if (id.length === 0) throw new Error('Supply a nonempty stable workspaceId');\n return id;\n};\n"],
5
+ "mappings": "AAAA,SAAS,wBAAuD;AAEhE,MAAM,qBAAqB,CAAC,UAA0B;AACpD,MAAI,CAAC,MAAM,aAAa,EAAG,OAAM,IAAI,MAAM,+CAA+C;AAC1F,SAAO,mBAAmB,KAAK;AACjC;AAGO,MAAM,qBAAqB,CAAC,SAMrB;AACZ,QAAM,KACJ,KAAK,QAAQ,gBACZ,KAAK,cAAc,iBAAiB,gBAAgB,KAAK,QAAQ,kBAAkB,OAChF,gBAAgB,mBAAmB,KAAK,QAAQ,cAAc,CAAC,IAAI,mBAAmB,KAAK,QAAQ,MAAM,CAAC,KAC1G,WAAW,mBAAmB,KAAK,QAAQ,SAAS,CAAC;AAC3D,MAAI,GAAG,WAAW,EAAG,OAAM,IAAI,MAAM,sCAAsC;AAC3E,SAAO;AACT;",
6
+ "names": []
7
+ }