@finalai/agent-provider 0.9.0 → 0.11.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.
- package/HOSTING.md +334 -245
- package/README.md +106 -20
- package/dist/modules/canonical-json.d.mts +4 -0
- package/dist/modules/canonical-json.mjs +33 -0
- package/dist/modules/canonical-json.mjs.map +7 -0
- package/dist/modules/channel.d.mts +51 -15
- package/dist/modules/channel.mjs +1 -0
- package/dist/modules/channel.mjs.map +2 -2
- package/dist/modules/code-host/host.d.mts +10 -0
- package/dist/modules/code-host/host.mjs +88 -0
- package/dist/modules/code-host/host.mjs.map +7 -0
- package/dist/modules/code-host/in-process.d.mts +24 -0
- package/dist/modules/code-host/in-process.mjs +89 -0
- package/dist/modules/code-host/in-process.mjs.map +7 -0
- package/dist/modules/code-host/index.d.mts +4 -0
- package/dist/modules/code-host/index.mjs +5 -0
- package/dist/modules/code-host/index.mjs.map +7 -0
- package/dist/modules/code-host/serverless.d.mts +63 -0
- package/dist/modules/code-host/serverless.mjs +27 -0
- package/dist/modules/code-host/serverless.mjs.map +7 -0
- package/dist/modules/code-host/types.d.mts +152 -0
- package/dist/modules/code-host/types.mjs +85 -0
- package/dist/modules/code-host/types.mjs.map +7 -0
- package/dist/modules/conformance/agent.mjs +72 -6
- package/dist/modules/conformance/agent.mjs.map +2 -2
- package/dist/modules/conformance/harness-kit.d.mts +9 -2
- package/dist/modules/conformance/harness-kit.mjs +224 -63
- package/dist/modules/conformance/harness-kit.mjs.map +3 -3
- package/dist/modules/conformance/local-harness.d.mts +1 -4
- package/dist/modules/conformance/local-harness.mjs +21 -22
- package/dist/modules/conformance/local-harness.mjs.map +2 -2
- package/dist/modules/conformance/protocol.d.mts +1 -0
- package/dist/modules/conformance/protocol.mjs +2 -0
- package/dist/modules/conformance/protocol.mjs.map +2 -2
- package/dist/modules/conformance/sandbox-kit.d.mts +12 -4
- package/dist/modules/conformance/sandbox-kit.mjs +189 -103
- package/dist/modules/conformance/sandbox-kit.mjs.map +2 -2
- package/dist/modules/conformance/scripted-model/chat-completions.mjs +1 -0
- package/dist/modules/conformance/scripted-model/chat-completions.mjs.map +2 -2
- package/dist/modules/conformance/scripted-model/directives.d.mts +3 -0
- package/dist/modules/conformance/scripted-model/directives.mjs +26 -10
- package/dist/modules/conformance/scripted-model/directives.mjs.map +2 -2
- package/dist/modules/conformance/scripted-model/messages.mjs +1 -0
- package/dist/modules/conformance/scripted-model/messages.mjs.map +2 -2
- package/dist/modules/conformance/scripted-model/responses.mjs +2 -0
- package/dist/modules/conformance/scripted-model/responses.mjs.map +2 -2
- package/dist/modules/conformance/stdio.d.mts +21 -0
- package/dist/modules/conformance/stdio.mjs +158 -0
- package/dist/modules/conformance/stdio.mjs.map +7 -0
- package/dist/modules/credential-routes.d.mts +3 -3
- package/dist/modules/credential-routes.mjs +2 -2
- package/dist/modules/credential-routes.mjs.map +2 -2
- package/dist/modules/document.d.mts +358 -0
- package/dist/modules/document.mjs +193 -0
- package/dist/modules/document.mjs.map +7 -0
- package/dist/modules/harness-configuration.d.mts +16 -0
- package/dist/modules/harness-configuration.mjs +83 -0
- package/dist/modules/harness-configuration.mjs.map +7 -0
- package/dist/modules/harness-definition.d.mts +280 -0
- package/dist/modules/harness-definition.mjs +430 -0
- package/dist/modules/harness-definition.mjs.map +7 -0
- package/dist/modules/harness-provider.d.mts +197 -0
- package/dist/modules/harness-provider.mjs +108 -0
- package/dist/modules/harness-provider.mjs.map +7 -0
- package/dist/modules/harness-requirements.d.mts +19 -0
- package/dist/modules/harness-requirements.mjs +40 -0
- package/dist/modules/harness-requirements.mjs.map +7 -0
- package/dist/modules/harness-start.d.mts +33 -0
- package/dist/modules/harness-start.mjs +107 -0
- package/dist/modules/harness-start.mjs.map +7 -0
- package/dist/modules/harness.d.mts +84 -109
- package/dist/modules/harness.mjs +56 -111
- package/dist/modules/harness.mjs.map +3 -3
- package/dist/modules/identity.d.mts +1 -0
- package/dist/modules/identity.mjs +2 -0
- package/dist/modules/identity.mjs.map +7 -0
- package/dist/modules/index.d.mts +12 -7
- package/dist/modules/index.mjs +12 -7
- package/dist/modules/index.mjs.map +2 -2
- package/dist/modules/inference.d.mts +35 -0
- package/dist/modules/inference.mjs +74 -0
- package/dist/modules/inference.mjs.map +7 -0
- package/dist/modules/local-channel-context.d.mts +1 -1
- package/dist/modules/local-channel-context.mjs +1 -1
- package/dist/modules/local-channel-context.mjs.map +2 -2
- package/dist/modules/requirements-check.d.mts +30 -0
- package/dist/modules/requirements-check.mjs +164 -0
- package/dist/modules/requirements-check.mjs.map +7 -0
- package/dist/modules/sandbox/client.d.mts +3 -0
- package/dist/modules/sandbox/client.mjs +101 -18
- package/dist/modules/sandbox/client.mjs.map +2 -2
- package/dist/modules/sandbox/grant.d.mts +78 -0
- package/dist/modules/sandbox/grant.mjs +134 -0
- package/dist/modules/sandbox/grant.mjs.map +7 -0
- package/dist/modules/sandbox/index.d.mts +3 -3
- package/dist/modules/sandbox/index.mjs +4 -5
- package/dist/modules/sandbox/index.mjs.map +2 -2
- package/dist/modules/sandbox/mcp-hosted.d.mts +1 -1
- package/dist/modules/sandbox/mcp-hosted.mjs +4 -7
- package/dist/modules/sandbox/mcp-hosted.mjs.map +2 -2
- package/dist/modules/sandbox/mcp.d.mts +4 -2
- package/dist/modules/sandbox/mcp.mjs +14 -7
- package/dist/modules/sandbox/mcp.mjs.map +2 -2
- package/dist/modules/sandbox/memory-sandbox.d.mts +2 -1
- package/dist/modules/sandbox/memory-sandbox.mjs +71 -41
- package/dist/modules/sandbox/memory-sandbox.mjs.map +2 -2
- package/dist/modules/sandbox/networking.d.mts +7 -7
- package/dist/modules/sandbox/networking.mjs +16 -9
- package/dist/modules/sandbox/networking.mjs.map +2 -2
- package/dist/modules/sandbox/remote/adapter.d.mts +30 -0
- package/dist/modules/sandbox/remote/adapter.mjs +381 -0
- package/dist/modules/sandbox/remote/adapter.mjs.map +7 -0
- package/dist/modules/sandbox/remote/body.d.mts +1 -0
- package/dist/modules/sandbox/remote/body.mjs +27 -0
- package/dist/modules/sandbox/remote/body.mjs.map +7 -0
- package/dist/modules/sandbox/remote/errors.d.mts +10 -0
- package/dist/modules/sandbox/remote/errors.mjs +62 -0
- package/dist/modules/sandbox/remote/errors.mjs.map +7 -0
- package/dist/modules/sandbox/remote/index.d.mts +5 -0
- package/dist/modules/sandbox/remote/index.mjs +6 -0
- package/dist/modules/sandbox/remote/index.mjs.map +7 -0
- package/dist/modules/sandbox/remote/ndjson.d.mts +6 -0
- package/dist/modules/sandbox/remote/ndjson.mjs +80 -0
- package/dist/modules/sandbox/remote/ndjson.mjs.map +7 -0
- package/dist/modules/sandbox/remote/platform-api.d.mts +8 -0
- package/dist/modules/sandbox/remote/platform-api.mjs +15 -0
- package/dist/modules/sandbox/remote/platform-api.mjs.map +7 -0
- package/dist/modules/sandbox/remote/preamble.d.mts +7 -0
- package/dist/modules/sandbox/remote/preamble.mjs +51 -0
- package/dist/modules/sandbox/remote/preamble.mjs.map +7 -0
- package/dist/modules/sandbox/remote/serve.d.mts +34 -0
- package/dist/modules/sandbox/remote/serve.mjs +520 -0
- package/dist/modules/sandbox/remote/serve.mjs.map +7 -0
- package/dist/modules/sandbox/remote/testing.d.mts +34 -0
- package/dist/modules/sandbox/remote/testing.mjs +275 -0
- package/dist/modules/sandbox/remote/testing.mjs.map +7 -0
- package/dist/modules/sandbox/seeds.d.mts +2 -2
- package/dist/modules/sandbox/seeds.mjs +2 -2
- package/dist/modules/sandbox/seeds.mjs.map +2 -2
- package/dist/modules/sandbox/server.d.mts +4 -6
- package/dist/modules/sandbox/server.mjs +93 -49
- package/dist/modules/sandbox/server.mjs.map +2 -2
- package/dist/modules/sandbox/setup/apply.d.mts +40 -0
- package/dist/modules/sandbox/setup/apply.mjs +190 -0
- package/dist/modules/sandbox/setup/apply.mjs.map +7 -0
- package/dist/modules/sandbox/setup/describe.d.mts +10 -0
- package/dist/modules/sandbox/setup/describe.mjs +62 -0
- package/dist/modules/sandbox/setup/describe.mjs.map +7 -0
- package/dist/modules/sandbox/setup/index.d.mts +6 -0
- package/dist/modules/sandbox/setup/index.mjs +17 -0
- package/dist/modules/sandbox/setup/index.mjs.map +7 -0
- package/dist/modules/sandbox/setup/paths.d.mts +8 -0
- package/dist/modules/sandbox/setup/paths.mjs +18 -0
- package/dist/modules/sandbox/setup/paths.mjs.map +7 -0
- package/dist/modules/sandbox/setup/schema.d.mts +43 -0
- package/dist/modules/sandbox/setup/schema.mjs +58 -0
- package/dist/modules/sandbox/setup/schema.mjs.map +7 -0
- package/dist/modules/sandbox/tool-policy.d.mts +1 -1
- package/dist/modules/sandbox/tool-policy.mjs +1 -1
- package/dist/modules/sandbox/tool-policy.mjs.map +2 -2
- package/dist/modules/sandbox/types.d.mts +117 -142
- package/dist/modules/sandbox/types.mjs +47 -57
- package/dist/modules/sandbox/types.mjs.map +3 -3
- package/dist/modules/sandbox/wire.d.mts +93 -6
- package/dist/modules/sandbox/wire.mjs +61 -38
- package/dist/modules/sandbox/wire.mjs.map +2 -2
- package/dist/modules/schemas.d.mts +5 -76
- package/dist/modules/schemas.mjs +18 -85
- package/dist/modules/schemas.mjs.map +2 -2
- package/dist/modules/tool-annotations.d.mts +15 -6
- package/dist/modules/tool-annotations.mjs +9 -3
- package/dist/modules/tool-annotations.mjs.map +2 -2
- package/dist/modules/tool-descriptor.d.mts +16 -0
- package/dist/modules/tool-descriptor.mjs +19 -0
- package/dist/modules/tool-descriptor.mjs.map +7 -0
- package/dist/modules/tool-patterns.d.mts +7 -7
- package/dist/modules/tool-patterns.mjs +10 -9
- package/dist/modules/tool-patterns.mjs.map +2 -2
- package/package.json +86 -41
- package/dist/modules/credentials.d.mts +0 -206
- package/dist/modules/credentials.mjs +0 -207
- package/dist/modules/credentials.mjs.map +0 -7
- package/dist/modules/dynamic.d.mts +0 -40
- package/dist/modules/dynamic.mjs +0 -79
- package/dist/modules/dynamic.mjs.map +0 -7
- package/dist/modules/hosted-bindings.d.mts +0 -15
- package/dist/modules/hosted-bindings.mjs +0 -21
- package/dist/modules/hosted-bindings.mjs.map +0 -7
- package/dist/modules/manifest.d.mts +0 -791
- package/dist/modules/manifest.mjs +0 -322
- package/dist/modules/manifest.mjs.map +0 -7
- package/dist/modules/provider-ref.d.mts +0 -29
- package/dist/modules/provider-ref.mjs +0 -55
- package/dist/modules/provider-ref.mjs.map +0 -7
- package/dist/modules/room-surface.d.mts +0 -355
- package/dist/modules/room-surface.mjs +0 -156
- package/dist/modules/room-surface.mjs.map +0 -7
- package/dist/modules/sandbox/open-scope-node.d.mts +0 -4
- package/dist/modules/sandbox/open-scope-node.mjs +0 -19
- package/dist/modules/sandbox/open-scope-node.mjs.map +0 -7
- package/dist/modules/sandbox/open-scope.d.mts +0 -16
- package/dist/modules/sandbox/open-scope.mjs +0 -66
- package/dist/modules/sandbox/open-scope.mjs.map +0 -7
- package/dist/modules/sandbox/workspace-identity.d.mts +0 -5
- package/dist/modules/sandbox/workspace-identity.mjs +0 -14
- package/dist/modules/sandbox/workspace-identity.mjs.map +0 -7
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../../../src/requirements-check.ts"],
|
|
4
|
+
"sourcesContent": ["import {\n Capability,\n capabilityAccessCovers,\n DEFAULT_CAPABILITY_ACCESS as FULL_ACCESS,\n type CapabilityAccess,\n} from '@finalai/agent-protocol';\nimport {\n HarnessComputeStatus,\n RequirementKind,\n RequirementProblem,\n type ResolvedProvideDocumentIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { computeRequirementsOf, inProcessCodeOf, type AgentDocumentIface } from \"./document.mjs\";\nimport { harnessUnsuitability, type HarnessSuitabilityArgsIface } from \"./harness-requirements.mjs\";\n\n// One check, run by every call that can start work: every requirement not\n// marked optional is provided and suitable, or nothing starts. The platform\n// runs it with what it knows about each provided resource; the SDK runs the\n// same function before sending so a caller sees the same list either way.\n\nexport interface UnmetIface {\n kind: RequirementKind;\n name: string;\n description: string | null;\n problem: RequirementProblem;\n detail: string | null;\n}\n\n// What the checker knows about one provided sandbox.\nexport interface ProvidedSandboxIface {\n // Capabilities the sandbox's provider serves, with the most access it grants.\n capabilities: Partial<Record<Capability, CapabilityAccess>>;\n}\n\n// What the check needs to know about the harness the settings name: its\n// definition composed with its adapter and environment (harnessCheckInputOf,\n// ./harness-definition.ts).\nexport interface HarnessCheckInputIface extends Omit<HarnessSuitabilityArgsIface, 'document'> {\n // Per capability: whether the harness serves it natively on the machine it\n // runs on, drives a provided sandbox, or cannot use it. Absent: sandbox.\n compute: Partial<Record<Capability, HarnessComputeStatus>>;\n // The sandbox the harness runs in; its native capabilities are that\n // sandbox's, so only it may be provided for them. Null: it runs at a URL,\n // whose machine serves them.\n environment?: string | null;\n // It runs in the sandbox provided for `shell`, and none was.\n awaitsEnvironment?: boolean;\n // Per native capability, the access levels below full the harness can\n // hold the model to. Absent: it can enforce any.\n enforces?: Partial<Record<Capability, readonly CapabilityAccess[]>>;\n // Why the harness, its adapter and its environment do not compose.\n problems?: readonly string[];\n}\n\nexport interface RequirementsCheckArgsIface {\n document: AgentDocumentIface;\n provide: ResolvedProvideDocumentIface;\n // Null when no harness was provided or its name is unknown.\n harness: HarnessCheckInputIface | null;\n // Looked up by id; null for an id that names nothing in the session's project.\n sandbox: (id: string) => ProvidedSandboxIface | null;\n integrationExists: (id: string) => boolean;\n // Whether a connected client holds the in-process code; absent means none does.\n inProcessCodeAvailable?: boolean;\n}\n\nconst describe = (text: string | undefined): string | null => text ?? null;\n\nexport const unmetRequirements = (args: RequirementsCheckArgsIface): UnmetIface[] => {\n const { document, provide } = args;\n const unmet: UnmetIface[] = [];\n\n if (provide.harness == null || args.harness == null) {\n unmet.push({\n kind: RequirementKind.Harness,\n name: 'harness',\n description: null,\n problem:\n provide.harness == null ? RequirementProblem.NotProvided : RequirementProblem.NotFound,\n detail: provide.harness == null ? null : `Unknown harness ${provide.harness.harness}`,\n });\n } else {\n const unsuitable = harnessUnsuitability({ ...args.harness, document });\n const details: string[] = [...(args.harness.problems ?? [])];\n if (unsuitable != null) {\n if (unsuitable.missingFeatures.length > 0)\n details.push(`does not support ${unsuitable.missingFeatures.join(', ')}`);\n if (unsuitable.permission != null)\n details.push(\n `runs at ${unsuitable.permission.offered}, above the agent's ceiling of ${unsuitable.permission.ceiling}`,\n );\n }\n if (details.length > 0)\n unmet.push({\n kind: RequirementKind.Harness,\n name: 'harness',\n description: null,\n problem: RequirementProblem.Unsuitable,\n detail: `${provide.harness.harness} ${details.join('; ')}`,\n });\n }\n const harnessName = provide.harness?.harness ?? 'The harness';\n\n // A harness placed by `shell` runs nowhere until a sandbox provides it.\n if (args.harness?.awaitsEnvironment === true)\n unmet.push({\n kind: RequirementKind.Compute,\n name: Capability.Shell,\n description: null,\n problem: RequirementProblem.NotProvided,\n detail: `${harnessName} runs in the sandbox provided for shell`,\n });\n\n const compute = provide.compute ?? {};\n const files = compute[Capability.Files];\n const shell = compute[Capability.Shell];\n if (files != null && shell != null && files !== shell)\n unmet.push({\n kind: RequirementKind.Compute,\n name: Capability.Shell,\n description: null,\n problem: RequirementProblem.DifferentSandboxes,\n detail: '`files` and `shell` must be provided by the same sandbox',\n });\n\n const insufficientAccess = (\n capability: Capability,\n sandboxId: string,\n required: CapabilityAccess,\n ): string | null => {\n const sandbox = args.sandbox(sandboxId);\n if (sandbox == null) return null;\n const granted = sandbox.capabilities[capability];\n if (granted == null) return `Sandbox ${sandboxId} does not offer ${capability}`;\n if (!capabilityAccessCovers(granted, required))\n return `Sandbox ${sandboxId} grants ${granted}; the agent requires ${required}`;\n return null;\n };\n\n for (const [capability, requirement] of computeRequirementsOf(document)) {\n const sandboxId = compute[capability];\n const description = describe(requirement.description);\n const served = args.harness?.compute[capability];\n const fail = (problem: RequirementProblem, detail: string | null): void => {\n unmet.push({ kind: RequirementKind.Compute, name: capability, description, problem, detail });\n };\n if (served === HarnessComputeStatus.Unavailable) {\n if (sandboxId != null || !requirement.optional)\n fail(RequirementProblem.Unsuitable, `${harnessName} cannot use ${capability}`);\n continue;\n }\n if (served === HarnessComputeStatus.Harness) {\n if (args.harness?.awaitsEnvironment === true) continue;\n const environment = args.harness?.environment ?? null;\n if (sandboxId != null && sandboxId !== environment) {\n fail(\n RequirementProblem.Unsuitable,\n environment == null\n ? `${harnessName} uses ${capability} on its own machine and cannot use a provided sandbox for it`\n : `${harnessName} uses ${capability} natively in sandbox ${environment}; provide that sandbox for it`,\n );\n continue;\n }\n if (environment != null) {\n if (args.sandbox(environment) == null) {\n fail(RequirementProblem.NotFound, `No sandbox ${environment} in this project`);\n continue;\n }\n const access = insufficientAccess(capability, environment, requirement.access);\n if (access != null) {\n fail(RequirementProblem.Unsuitable, access);\n continue;\n }\n }\n // Its own tools bypass any sandbox grant: anything below full access\n // must be a level the harness itself can hold the model to.\n const enforced = args.harness?.enforces?.[capability];\n const full = capabilityAccessCovers(requirement.access, FULL_ACCESS[capability]);\n if (enforced != null && !full && !enforced.includes(requirement.access))\n fail(\n RequirementProblem.Unsuitable,\n `${harnessName} cannot hold ${capability} to ${requirement.access} with its own tools`,\n );\n continue;\n }\n if (sandboxId == null) {\n if (!requirement.optional) fail(RequirementProblem.NotProvided, null);\n continue;\n }\n if (args.sandbox(sandboxId) == null) {\n fail(RequirementProblem.NotFound, `No sandbox ${sandboxId} in this project`);\n continue;\n }\n const access = insufficientAccess(capability, sandboxId, requirement.access);\n if (access != null) fail(RequirementProblem.Unsuitable, access);\n }\n\n const integrations = provide.integrations ?? {};\n for (const [slot, requirement] of Object.entries(document.require.integrations)) {\n const integrationId = integrations[slot];\n if (integrationId == null) {\n if (!requirement.optional)\n unmet.push({\n kind: RequirementKind.Integration,\n name: slot,\n description: requirement.description,\n problem: RequirementProblem.NotProvided,\n detail: null,\n });\n continue;\n }\n if (!args.integrationExists(integrationId))\n unmet.push({\n kind: RequirementKind.Integration,\n name: slot,\n description: requirement.description,\n problem: RequirementProblem.NotFound,\n detail: `No integration ${integrationId} in this project`,\n });\n }\n\n if (args.inProcessCodeAvailable !== true)\n for (const name of inProcessCodeOf(document))\n unmet.push({\n kind: RequirementKind.Code,\n name,\n description: null,\n problem: RequirementProblem.CodeUnavailable,\n detail: `${name} only runs in the process that holds its code`,\n });\n\n return unmet;\n};\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["access"]
|
|
7
|
+
}
|
|
@@ -3,6 +3,7 @@ import { readTextFileStream, runCollect } from "./convenience.mjs";
|
|
|
3
3
|
import { resolvePosixPath } from "./paths.mjs";
|
|
4
4
|
import { createRpcPeer } from "./rpc-peer.mjs";
|
|
5
5
|
import {
|
|
6
|
+
isSandboxWorkerEndpoint,
|
|
6
7
|
SandboxCapability
|
|
7
8
|
} from "./types.mjs";
|
|
8
9
|
import {
|
|
@@ -96,6 +97,36 @@ const connectSandboxClient = async (args) => {
|
|
|
96
97
|
if (current === connection) current = null;
|
|
97
98
|
await getConnection();
|
|
98
99
|
};
|
|
100
|
+
const syncIdentity = (connection, renew) => {
|
|
101
|
+
const identity = args.identity;
|
|
102
|
+
if (identity == null) return Promise.resolve();
|
|
103
|
+
const run = connection.identitySync.then(async () => {
|
|
104
|
+
const assertion = await identity({ renew });
|
|
105
|
+
if (assertion === connection.identity || connection.peer.isClosed()) return;
|
|
106
|
+
const raw = await connection.peer.request(HandleRpcMethod.IdentityRefresh, { assertion });
|
|
107
|
+
connection.identity = assertion;
|
|
108
|
+
scheduleIdentityRenewal(
|
|
109
|
+
connection,
|
|
110
|
+
parseHandleRpcResult(HandleRpcMethod.IdentityRefresh, raw).expiresAt
|
|
111
|
+
);
|
|
112
|
+
});
|
|
113
|
+
connection.identitySync = run.catch(() => void 0);
|
|
114
|
+
return run;
|
|
115
|
+
};
|
|
116
|
+
const scheduleIdentityRenewal = (connection, expiresAt) => {
|
|
117
|
+
if (connection.identityTimer != null) clearTimeout(connection.identityTimer);
|
|
118
|
+
connection.identityTimer = null;
|
|
119
|
+
if (expiresAt == null || args.identity == null || closedByUser) return;
|
|
120
|
+
const remaining = Date.parse(expiresAt) - now();
|
|
121
|
+
if (Number.isNaN(remaining)) return;
|
|
122
|
+
const delay = Math.max(0, Math.min(remaining - refreshMarginMs, remaining / 2));
|
|
123
|
+
connection.identityTimer = setTimeout(
|
|
124
|
+
() => {
|
|
125
|
+
void syncIdentity(connection, true).catch(() => void 0);
|
|
126
|
+
},
|
|
127
|
+
Math.min(2147483647, delay)
|
|
128
|
+
);
|
|
129
|
+
};
|
|
99
130
|
const initialize = async (target) => {
|
|
100
131
|
const channel = await openChannel({ url: target.url, token: target.token });
|
|
101
132
|
let connection = null;
|
|
@@ -104,19 +135,31 @@ const connectSandboxClient = async (args) => {
|
|
|
104
135
|
binary,
|
|
105
136
|
onClose: () => {
|
|
106
137
|
if (connection == null) return;
|
|
138
|
+
if (connection.identityTimer != null) clearTimeout(connection.identityTimer);
|
|
107
139
|
live.delete(connection);
|
|
108
140
|
if (current === connection) current = null;
|
|
109
141
|
}
|
|
110
142
|
});
|
|
111
143
|
try {
|
|
144
|
+
const identity = args.identity == null ? null : await args.identity({ renew: false });
|
|
112
145
|
const raw = await peer.request(HandleRpcMethod.Initialize, {
|
|
113
146
|
handleRpcVersion: HANDLE_RPC_VERSION,
|
|
114
147
|
token: target.token,
|
|
148
|
+
...identity == null ? {} : { identity },
|
|
115
149
|
client: args.clientInfo
|
|
116
150
|
});
|
|
117
151
|
const info = handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw);
|
|
118
|
-
connection = {
|
|
152
|
+
connection = {
|
|
153
|
+
peer,
|
|
154
|
+
target,
|
|
155
|
+
info,
|
|
156
|
+
nextStreamId: 1,
|
|
157
|
+
identity,
|
|
158
|
+
identitySync: Promise.resolve(),
|
|
159
|
+
identityTimer: null
|
|
160
|
+
};
|
|
119
161
|
live.add(connection);
|
|
162
|
+
if (identity != null) scheduleIdentityRenewal(connection, info.expiresAt);
|
|
120
163
|
return connection;
|
|
121
164
|
} catch (error) {
|
|
122
165
|
peer.close(HandleRpcCloseCode.Normal, "initialize failed");
|
|
@@ -158,13 +201,18 @@ const connectSandboxClient = async (args) => {
|
|
|
158
201
|
}
|
|
159
202
|
}
|
|
160
203
|
};
|
|
161
|
-
const
|
|
204
|
+
const liveConnection = () => {
|
|
162
205
|
if (current != null && !current.peer.isClosed()) return Promise.resolve(current);
|
|
163
206
|
connecting ??= establish().finally(() => {
|
|
164
207
|
connecting = null;
|
|
165
208
|
});
|
|
166
209
|
return connecting;
|
|
167
210
|
};
|
|
211
|
+
const getConnection = async () => {
|
|
212
|
+
const connection = await liveConnection();
|
|
213
|
+
await syncIdentity(connection, false);
|
|
214
|
+
return connection;
|
|
215
|
+
};
|
|
168
216
|
const requestOn = async (connection, method, params, options) => {
|
|
169
217
|
const raw = await connection.peer.request(method, params, { signal: options?.signal });
|
|
170
218
|
return parseHandleRpcResult(method, raw);
|
|
@@ -293,7 +341,7 @@ const connectSandboxClient = async (args) => {
|
|
|
293
341
|
kill
|
|
294
342
|
};
|
|
295
343
|
};
|
|
296
|
-
const
|
|
344
|
+
const startProcess = async (args2) => {
|
|
297
345
|
const connection = await getConnection();
|
|
298
346
|
const processId = randomId();
|
|
299
347
|
const stdoutStreamId = allocateStreamId(connection);
|
|
@@ -303,27 +351,21 @@ const connectSandboxClient = async (args) => {
|
|
|
303
351
|
const stderr = connection.peer.streams.openIncoming(stderrStreamId);
|
|
304
352
|
let stdinWriter = null;
|
|
305
353
|
let stdinSource;
|
|
306
|
-
if (
|
|
354
|
+
if (args2.stdin == null) {
|
|
307
355
|
const pipe = new TransformStream();
|
|
308
356
|
stdinWriter = pipe.writable.getWriter();
|
|
309
357
|
stdinSource = pipe.readable;
|
|
310
|
-
} else if (
|
|
311
|
-
stdinSource =
|
|
358
|
+
} else if (args2.stdin instanceof ReadableStream) {
|
|
359
|
+
stdinSource = args2.stdin;
|
|
312
360
|
} else {
|
|
313
|
-
stdinSource = bytesToStream(utf8Encode(
|
|
361
|
+
stdinSource = bytesToStream(utf8Encode(args2.stdin));
|
|
314
362
|
}
|
|
315
363
|
connection.peer.streams.openOutgoing(stdinStreamId, stdinSource).catch(() => void 0);
|
|
316
|
-
const durable =
|
|
364
|
+
const durable = args2.durable === true && connection.info.capabilities.includes(SandboxCapability.DurableProcesses);
|
|
317
365
|
let result;
|
|
318
366
|
try {
|
|
319
|
-
result = await
|
|
367
|
+
result = await args2.request(connection, {
|
|
320
368
|
processId,
|
|
321
|
-
command: options.command,
|
|
322
|
-
args: options.args,
|
|
323
|
-
cwd: options.cwd,
|
|
324
|
-
env: options.env,
|
|
325
|
-
shell: options.shell,
|
|
326
|
-
timeoutMs: options.timeoutMs,
|
|
327
369
|
stdinStreamId,
|
|
328
370
|
stdoutStreamId,
|
|
329
371
|
stderrStreamId,
|
|
@@ -332,16 +374,22 @@ const connectSandboxClient = async (args) => {
|
|
|
332
374
|
} catch (error) {
|
|
333
375
|
connection.peer.streams.discardIncoming(stdoutStreamId);
|
|
334
376
|
connection.peer.streams.discardIncoming(stderrStreamId);
|
|
335
|
-
connection.peer.streams.abortOutgoing(stdinStreamId, "
|
|
377
|
+
connection.peer.streams.abortOutgoing(stdinStreamId, "start failed");
|
|
336
378
|
throw error;
|
|
337
379
|
}
|
|
380
|
+
if ("endpoint" in result) {
|
|
381
|
+
connection.peer.streams.discardIncoming(stdoutStreamId);
|
|
382
|
+
connection.peer.streams.discardIncoming(stderrStreamId);
|
|
383
|
+
connection.peer.streams.abortOutgoing(stdinStreamId, "worker endpoint");
|
|
384
|
+
return { endpoint: result.endpoint };
|
|
385
|
+
}
|
|
338
386
|
const ref = result.ref ?? null;
|
|
339
387
|
const controls = processControls({
|
|
340
388
|
connection,
|
|
341
389
|
processId,
|
|
342
390
|
durable: ref != null,
|
|
343
391
|
streamIds: [stdoutStreamId, stderrStreamId],
|
|
344
|
-
abortSignal:
|
|
392
|
+
abortSignal: args2.abortSignal
|
|
345
393
|
});
|
|
346
394
|
return {
|
|
347
395
|
pid: result.pid,
|
|
@@ -350,7 +398,7 @@ const connectSandboxClient = async (args) => {
|
|
|
350
398
|
stderr,
|
|
351
399
|
write: async (data, writeOptions) => {
|
|
352
400
|
if (stdinWriter == null) throw new Error("stdin was provided at spawn");
|
|
353
|
-
if (ref != null)
|
|
401
|
+
if (ref != null) args2.abortSignal?.throwIfAborted();
|
|
354
402
|
const bytes = data instanceof Uint8Array ? data : utf8Encode(data);
|
|
355
403
|
if (bytes.byteLength > 0) await stdinWriter.write(bytes);
|
|
356
404
|
if (writeOptions?.end === true) await stdinWriter.close();
|
|
@@ -358,6 +406,40 @@ const connectSandboxClient = async (args) => {
|
|
|
358
406
|
...controls
|
|
359
407
|
};
|
|
360
408
|
};
|
|
409
|
+
const spawn = async (options) => {
|
|
410
|
+
const started = await startProcess({
|
|
411
|
+
stdin: options.stdin,
|
|
412
|
+
durable: options.durable,
|
|
413
|
+
abortSignal: options.abortSignal,
|
|
414
|
+
request: (connection, streams) => requestOn(connection, HandleRpcMethod.Spawn, {
|
|
415
|
+
command: options.command,
|
|
416
|
+
args: options.args,
|
|
417
|
+
cwd: options.cwd,
|
|
418
|
+
env: options.env,
|
|
419
|
+
shell: options.shell,
|
|
420
|
+
timeoutMs: options.timeoutMs,
|
|
421
|
+
...streams
|
|
422
|
+
})
|
|
423
|
+
});
|
|
424
|
+
if (isSandboxWorkerEndpoint(started))
|
|
425
|
+
throw handleRpcError({
|
|
426
|
+
code: HandleRpcErrorCode.InvalidRequest,
|
|
427
|
+
message: "sandbox/spawn answered with an endpoint"
|
|
428
|
+
});
|
|
429
|
+
return started;
|
|
430
|
+
};
|
|
431
|
+
const startWorker = (options) => startProcess({
|
|
432
|
+
stdin: void 0,
|
|
433
|
+
durable: options.durable,
|
|
434
|
+
abortSignal: options.abortSignal,
|
|
435
|
+
request: (connection, streams) => requestOn(connection, HandleRpcMethod.StartWorker, {
|
|
436
|
+
program: options.program,
|
|
437
|
+
env: options.env,
|
|
438
|
+
input: options.input,
|
|
439
|
+
...options.identity == null ? {} : { identity: options.identity },
|
|
440
|
+
...streams
|
|
441
|
+
})
|
|
442
|
+
});
|
|
361
443
|
const attachProcess = async (options) => {
|
|
362
444
|
const connection = await getConnection();
|
|
363
445
|
const processId = randomId();
|
|
@@ -561,6 +643,7 @@ const connectSandboxClient = async (args) => {
|
|
|
561
643
|
}
|
|
562
644
|
if (capabilities.includes(SandboxCapability.DurableProcesses))
|
|
563
645
|
client.attachProcess = attachProcess;
|
|
646
|
+
if (capabilities.includes(SandboxCapability.Workers)) client.startWorker = startWorker;
|
|
564
647
|
if (capabilities.includes(SandboxCapability.ComputerUse)) {
|
|
565
648
|
client.computerUse = async () => {
|
|
566
649
|
const { connection, result } = await callOnConnection(HandleRpcMethod.ComputerUse, {});
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../../src/sandbox/client.ts"],
|
|
4
|
-
"sourcesContent": ["import { bytesToBase64, bytesToStream, encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { resolvePosixPath } from \"./paths.mjs\";\nimport { createRpcPeer, type RpcPeerIface } from \"./rpc-peer.mjs\";\nimport {\n SandboxCapability,\n type AbortableIface,\n type DirEntryIface,\n type McpChannelIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxAttachedProcessIface,\n type SandboxAttachProcessOptionsIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type ScreenSessionIface,\n type StatIface,\n} from \"./types.mjs\";\nimport {\n frameChannelFromWebSocket,\n HANDLE_RPC_IDEMPOTENT_METHODS,\n HANDLE_RPC_VERSION,\n handleRpcClientProtocols,\n HandleRpcCloseCode,\n handleRpcError,\n HandleRpcErrorCode,\n HandleRpcMethod,\n handleRpcMethodSchemas,\n isHandleRpcError,\n MAX_INLINE_WRITE_BYTES,\n parseHandleRpcResult,\n type FrameChannelIface,\n type HandleRpcParams,\n type HandleRpcResult,\n type InitializeResultIface,\n type WebSocketConstructorIface,\n} from \"./wire.mjs\";\n\n// NetworkSandboxSessionIface implemented purely over the handle RPC: no\n// provider code, only the wire. Works wherever a WebSocket exists (Workers,\n// browsers, Node 22+) or over any frame channel through `openChannel`.\n\nexport interface SandboxClientIface extends NetworkSandboxSessionIface {\n readonly confinedFiles: boolean;\n readonly providerHooks: boolean;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n readonly capabilities: readonly SandboxCapability[];\n // A byte range of a file, streamed; null when the file does not exist.\n readFileRange(options: {\n path: string;\n root?: string;\n offset: number;\n length?: number;\n abortSignal?: AbortSignal;\n }): Promise<ReadableStream<Uint8Array> | null>;\n // Closes every connection and fails in-flight calls.\n close(): void;\n}\n\nexport interface SandboxClientCredentialIface {\n token: string;\n expiresAt: string | null;\n // A new stable endpoint URL, when the issuer moved it.\n url?: string;\n}\n\nexport interface ConnectSandboxClientArgsIface {\n // The session service's stable per-binding address; the first call to reach\n // it attaches the sandbox, and every call is served there.\n url: string;\n token: string;\n expiresAt?: string | null;\n // Defaults to the global WebSocket.\n WebSocket?: WebSocketConstructorIface;\n // Replaces WebSocket dialing entirely (relays, tests).\n openChannel?: (target: { url: string; token: string }) => Promise<FrameChannelIface>;\n // Returns a fresh credential for the stable endpoint (`url`), e.g. from the\n // broker's `sandbox` route.\n refreshToken?: () => Promise<SandboxClientCredentialIface>;\n // Send stream chunks as binary frames (default true).\n binary?: boolean;\n reconnect?: { attempts?: number; baseDelayMs?: number; maxDelayMs?: number };\n // How long before expiry to refresh the credential (default 60 s).\n refreshMarginMs?: number;\n clientInfo?: { name: string; version: string };\n now?: () => number;\n sleep?: (ms: number) => Promise<void>;\n randomId?: () => string;\n}\n\ninterface TargetIface {\n url: string;\n token: string;\n expiresAt: string | null;\n}\n\ninterface ConnectionIface {\n peer: RpcPeerIface;\n target: TargetIface;\n info: InitializeResultIface;\n nextStreamId: number;\n}\n\nconst defaultSleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\nconst defaultOpenChannel =\n (WebSocketImpl: WebSocketConstructorIface | undefined) =>\n async (target: { url: string; token: string }): Promise<FrameChannelIface> => {\n const Impl = WebSocketImpl ?? globalThis.WebSocket;\n if (Impl == null)\n throw new Error('no WebSocket implementation available; pass WebSocket or openChannel');\n const { channel, opened } = frameChannelFromWebSocket(\n new Impl(target.url, handleRpcClientProtocols(target.token)),\n );\n await opened;\n return channel;\n };\n\nconst isRetryable = (cause: unknown): boolean => isHandleRpcError(cause) && cause.retryable;\n\nexport const connectSandboxClient = async (\n args: ConnectSandboxClientArgsIface,\n): Promise<SandboxClientIface> => {\n const now = args.now ?? Date.now;\n const sleep = args.sleep ?? defaultSleep;\n const randomId = args.randomId ?? (() => crypto.randomUUID());\n const openChannel = args.openChannel ?? defaultOpenChannel(args.WebSocket);\n const attempts = args.reconnect?.attempts ?? 5;\n const baseDelayMs = args.reconnect?.baseDelayMs ?? 100;\n const maxDelayMs = args.reconnect?.maxDelayMs ?? 5_000;\n const refreshMarginMs = args.refreshMarginMs ?? 60_000;\n const binary = args.binary ?? true;\n\n let origin: TargetIface = {\n url: args.url,\n token: args.token,\n expiresAt: args.expiresAt ?? null,\n };\n let current: ConnectionIface | null = null;\n let connecting: Promise<ConnectionIface> | null = null;\n let closedByUser = false;\n let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n const live = new Set<ConnectionIface>();\n let lastInfo: InitializeResultIface | null = null;\n\n const refreshOrigin = async (): Promise<boolean> => {\n if (args.refreshToken == null) return false;\n const fresh = await args.refreshToken();\n origin = {\n url: fresh.url ?? origin.url,\n token: fresh.token,\n expiresAt: fresh.expiresAt,\n };\n return true;\n };\n\n const scheduleRefresh = (connection: ConnectionIface) => {\n if (refreshTimer != null) clearTimeout(refreshTimer);\n refreshTimer = null;\n const expiresAt = connection.info.expiresAt ?? connection.target.expiresAt;\n if (expiresAt == null || args.refreshToken == null || closedByUser) return;\n const remaining = Date.parse(expiresAt) - now();\n if (Number.isNaN(remaining)) return;\n const delay = Math.max(0, Math.min(remaining - refreshMarginMs, remaining / 2));\n refreshTimer = setTimeout(\n () => {\n void refreshConnection(connection).catch(() => undefined);\n },\n Math.min(2_147_483_647, delay),\n );\n };\n\n // The connection takes the new token in place; in-flight calls continue.\n // A moved endpoint (a new `url`) is dialed fresh instead, and in-flight\n // calls finish on the old connection.\n const refreshConnection = async (connection: ConnectionIface) => {\n if (closedByUser || connection.peer.isClosed()) return;\n await refreshOrigin();\n if (origin.url === connection.target.url) {\n const result = await requestOn(connection, HandleRpcMethod.AuthRefresh, {\n token: origin.token,\n });\n connection.target = {\n ...connection.target,\n token: origin.token,\n expiresAt: result.expiresAt,\n };\n connection.info = { ...connection.info, expiresAt: result.expiresAt };\n scheduleRefresh(connection);\n return;\n }\n if (current === connection) current = null;\n await getConnection();\n };\n\n const initialize = async (target: TargetIface): Promise<ConnectionIface> => {\n const channel = await openChannel({ url: target.url, token: target.token });\n let connection: ConnectionIface | null = null;\n const peer = createRpcPeer({\n channel,\n binary,\n onClose: () => {\n if (connection == null) return;\n live.delete(connection);\n if (current === connection) current = null;\n },\n });\n try {\n const raw = await peer.request(HandleRpcMethod.Initialize, {\n handleRpcVersion: HANDLE_RPC_VERSION,\n token: target.token,\n client: args.clientInfo,\n });\n const info = handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw);\n connection = { peer, target, info, nextStreamId: 1 };\n live.add(connection);\n return connection;\n } catch (error) {\n peer.close(HandleRpcCloseCode.Normal, 'initialize failed');\n throw error;\n }\n };\n\n const establish = async (): Promise<ConnectionIface> => {\n let failures = 0;\n let refreshed = false;\n for (;;) {\n if (closedByUser)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'client closed',\n });\n try {\n const connection = await initialize(origin);\n current = connection;\n lastInfo = connection.info;\n scheduleRefresh(connection);\n return connection;\n } catch (error) {\n if (closedByUser) throw error;\n const unauthorized =\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Unauthorized;\n if (unauthorized && !refreshed && (await refreshOrigin().catch(() => false))) {\n refreshed = true;\n continue;\n }\n if (unauthorized) throw error;\n failures += 1;\n if (failures >= attempts) {\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: `could not connect to the sandbox: ${error instanceof Error ? error.message : String(error)}`,\n retryable: true,\n });\n }\n await sleep(Math.min(maxDelayMs, baseDelayMs * 2 ** (failures - 1)));\n }\n }\n };\n\n const getConnection = (): Promise<ConnectionIface> => {\n if (current != null && !current.peer.isClosed()) return Promise.resolve(current);\n connecting ??= establish().finally(() => {\n connecting = null;\n });\n return connecting;\n };\n\n const requestOn = async <M extends HandleRpcMethod>(\n connection: ConnectionIface,\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => {\n const raw = await connection.peer.request(method, params, { signal: options?.signal });\n return parseHandleRpcResult(method, raw);\n };\n\n const callOnConnection = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<{ connection: ConnectionIface; result: HandleRpcResult<M> }> => {\n const idempotent = HANDLE_RPC_IDEMPOTENT_METHODS.includes(method);\n for (let attempt = 0; ; attempt += 1) {\n const connection = await getConnection();\n try {\n return { connection, result: await requestOn(connection, method, params, options) };\n } catch (error) {\n if (attempt === 0 && idempotent && isRetryable(error)) continue;\n throw error;\n }\n }\n };\n\n const call = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => (await callOnConnection(method, params, options)).result;\n\n const allocateStreamId = (connection: ConnectionIface): number => {\n const id = connection.nextStreamId;\n connection.nextStreamId += 1;\n return id;\n };\n\n const first = await getConnection();\n const describe = (): InitializeResultIface => current?.info ?? lastInfo ?? first.info;\n\n const readFile = async (options: {\n path: string;\n root?: string;\n offset?: number;\n length?: number;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const stream = connection.peer.streams.openIncoming(streamId);\n try {\n const result = await requestOn(\n connection,\n HandleRpcMethod.ReadFile,\n {\n path: options.path,\n root: options.root,\n streamId,\n offset: options.offset,\n length: options.length,\n },\n { signal: options.abortSignal },\n );\n if (!result.found) {\n connection.peer.streams.discardIncoming(streamId);\n return null;\n }\n } catch (error) {\n connection.peer.streams.discardIncoming(streamId);\n throw error;\n }\n options.abortSignal?.addEventListener(\n 'abort',\n () => connection.peer.streams.cancelIncoming(streamId, 'aborted'),\n {\n once: true,\n },\n );\n return stream;\n };\n\n const writeFile = async (options: {\n path: string;\n content: ReadableStream<Uint8Array>;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const sending = connection.peer.streams.openOutgoing(streamId, options.content);\n sending.catch(() => undefined);\n try {\n await requestOn(\n connection,\n HandleRpcMethod.WriteFile,\n { path: options.path, streamId },\n { signal: options.abortSignal },\n );\n } catch (error) {\n connection.peer.streams.abortOutgoing(streamId, 'request failed');\n throw error;\n }\n };\n\n const writeBinaryFile = async (options: {\n path: string;\n content: Uint8Array;\n abortSignal?: AbortSignal;\n }) => {\n if (options.content.byteLength > MAX_INLINE_WRITE_BYTES) {\n await writeFile({\n path: options.path,\n content: bytesToStream(options.content),\n abortSignal: options.abortSignal,\n });\n return;\n }\n await call(\n HandleRpcMethod.WriteFile,\n { path: options.path, contentBase64: bytesToBase64(options.content) },\n { signal: options.abortSignal },\n );\n };\n\n // process/wait and process/kill for a served process. Aborting `abortSignal`\n // kills an ordinary process; a durable one is detached instead (process/detach):\n // its streams fail here and stop on the server, and it keeps running.\n const processControls = (args: {\n connection: ConnectionIface;\n processId: string;\n durable: boolean;\n streamIds: number[];\n abortSignal?: AbortSignal;\n }): Pick<SandboxProcessIface, 'wait' | 'kill'> => {\n const { connection, processId } = args;\n let waiting: Promise<{ exitCode: number }> | null = null;\n const kill = async (signal?: string) => {\n try {\n await requestOn(connection, HandleRpcMethod.ProcessKill, { processId, signal });\n } catch (error) {\n // Already exited and reaped, or the connection (and so the process) is gone.\n if (\n isHandleRpcError(error) &&\n (error.code === HandleRpcErrorCode.NotFound || error.retryable)\n )\n return;\n throw error;\n }\n };\n const onAbort = () => {\n if (!args.durable) {\n void kill().catch(() => undefined);\n return;\n }\n for (const streamId of args.streamIds)\n connection.peer.streams.cancelIncoming(streamId, 'process handle detached');\n // Best effort: a closed connection already released it on the server.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n };\n args.abortSignal?.addEventListener('abort', onAbort, { once: true });\n if (args.abortSignal?.aborted === true) onAbort();\n return {\n wait: () => {\n waiting ??= requestOn(\n connection,\n HandleRpcMethod.ProcessWait,\n { processId },\n { signal: args.abortSignal },\n );\n return waiting;\n },\n kill,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdinStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (options.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (options.stdin instanceof ReadableStream) {\n stdinSource = options.stdin;\n } else {\n stdinSource = bytesToStream(utf8Encode(options.stdin));\n }\n connection.peer.streams.openOutgoing(stdinStreamId, stdinSource).catch(() => undefined);\n // Servers without the capability would ignore it; older ones do not know it.\n const durable =\n options.durable === true &&\n connection.info.capabilities.includes(SandboxCapability.DurableProcesses);\n let result: HandleRpcResult<HandleRpcMethod.Spawn>;\n try {\n result = await requestOn(connection, HandleRpcMethod.Spawn, {\n processId,\n command: options.command,\n args: options.args,\n cwd: options.cwd,\n env: options.env,\n shell: options.shell,\n timeoutMs: options.timeoutMs,\n stdinStreamId,\n stdoutStreamId,\n stderrStreamId,\n ...(durable ? { durable: true } : {}),\n });\n } catch (error) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'spawn failed');\n throw error;\n }\n const ref = result.ref ?? null;\n const controls = processControls({\n connection,\n processId,\n durable: ref != null,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: options.abortSignal,\n });\n return {\n pid: result.pid,\n ref,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n // A detached handle is done with the process.\n if (ref != null) options.abortSignal?.throwIfAborted();\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n ...controls,\n };\n };\n\n const attachProcess = async (\n options: SandboxAttachProcessOptionsIface,\n ): Promise<SandboxAttachedProcessIface | null> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n const discard = () => {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n };\n let result: HandleRpcResult<HandleRpcMethod.ProcessAttach>;\n try {\n result = await requestOn(\n connection,\n HandleRpcMethod.ProcessAttach,\n {\n processId,\n ref: options.ref,\n stdoutOffset: options.stdoutOffset,\n stderrOffset: options.stderrOffset,\n stdoutStreamId,\n stderrStreamId,\n },\n { signal: options.abortSignal },\n );\n } catch (error) {\n discard();\n // The server may have attached it before the cancellation reached it.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n throw error;\n }\n if (!result.found) {\n discard();\n return null;\n }\n return {\n ref: options.ref,\n stdoutOffset: result.stdoutOffset,\n stderrOffset: result.stderrOffset,\n stdout,\n stderr,\n ...processControls({\n connection,\n processId,\n durable: true,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: options.abortSignal,\n }),\n };\n };\n\n const client: SandboxClientIface = {\n get id() {\n return describe().id;\n },\n get defaultWorkingDirectory() {\n return describe().defaultWorkingDirectory;\n },\n get ports() {\n return describe().ports;\n },\n get description() {\n return describe().description;\n },\n get capabilities() {\n return describe().capabilities;\n },\n confinedFiles: describe().confinedFiles === true,\n providerHooks: describe().providerHooks === true,\n onRuntimeShutdown: async () => {\n await call(HandleRpcMethod.OnRuntimeShutdown, {});\n },\n onSandboxStop: async () => {\n await call(HandleRpcMethod.OnSandboxStop, {});\n },\n onSandboxDelete: async (options) => {\n await call(HandleRpcMethod.OnSandboxDelete, options ?? {});\n },\n readFile: (options) => readFile(options),\n readFileRange: readFile,\n readBinaryFile: async (options) => {\n const stream = await readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const { abortSignal: _abortSignal, ...params } = options;\n const parsed = handleRpcMethodSchemas[HandleRpcMethod.ReadTextFile].params.safeParse(params);\n if (!parsed.success)\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: parsed.error.message,\n });\n const stream = await readFile({ path: options.path, abortSignal: options.abortSignal });\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile,\n writeBinaryFile,\n writeTextFile: async (options) =>\n writeBinaryFile({\n path: options.path,\n content: encodeSandboxText(options.content, options.encoding),\n abortSignal: options.abortSignal,\n }),\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options): Promise<StatIface | null> =>\n (\n await call(\n HandleRpcMethod.Stat,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).stat,\n readDir: async (options): Promise<DirEntryIface[]> =>\n (\n await call(\n HandleRpcMethod.ReadDir,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).entries,\n resolvePath: (path) => resolvePosixPath(describe().defaultWorkingDirectory, path),\n removePath: async (options) => {\n const { abortSignal, ...params } = options;\n await call(HandleRpcMethod.RemovePath, params, { signal: abortSignal });\n },\n getPortEndpoint: (options) => call(HandleRpcMethod.GetPortEndpoint, options),\n getPortUrl: async (options) => (await call(HandleRpcMethod.GetPortEndpoint, options)).url,\n stop: async () => {\n await call(HandleRpcMethod.Stop, {});\n },\n destroy: async () => {\n await call(HandleRpcMethod.Destroy, {});\n },\n close: () => {\n closedByUser = true;\n if (refreshTimer != null) clearTimeout(refreshTimer);\n for (const connection of live)\n connection.peer.close(HandleRpcCloseCode.Normal, 'client closed');\n live.clear();\n current = null;\n },\n };\n\n const mcpEndpoint = (\n connection: ConnectionIface,\n endpoint: HandleRpcResult<HandleRpcMethod.ComputerUse>,\n ): SandboxMcpEndpoint => {\n if ('url' in endpoint) return endpoint;\n return {\n name: endpoint.name,\n connect: async (options?: AbortableIface): Promise<McpChannelIface> => {\n const opened = await requestOn(\n connection,\n HandleRpcMethod.McpOpen,\n { endpointKey: endpoint.endpointKey },\n { signal: options?.abortSignal },\n );\n let closed = false;\n const requireOpen = (): void => {\n if (closed)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'MCP channel closed',\n });\n };\n const channel: McpChannelIface = {\n send: async (message, sendOptions) => {\n requireOpen();\n await requestOn(\n connection,\n HandleRpcMethod.McpSend,\n { channelId: opened.channelId, message },\n { signal: sendOptions?.abortSignal },\n );\n },\n receive: async (receiveOptions) => {\n requireOpen();\n return (\n await requestOn(\n connection,\n HandleRpcMethod.McpReceive,\n { channelId: opened.channelId },\n { signal: receiveOptions?.abortSignal },\n )\n ).messages;\n },\n close: async () => {\n if (closed) return;\n closed = true;\n if (!connection.peer.isClosed())\n await requestOn(connection, HandleRpcMethod.McpClose, {\n channelId: opened.channelId,\n });\n },\n };\n if (options?.abortSignal?.aborted === true) {\n await channel.close().catch(() => undefined);\n options.abortSignal.throwIfAborted();\n }\n return channel;\n },\n };\n };\n\n const capabilities = first.info.capabilities;\n if (capabilities.includes(SandboxCapability.NetworkPolicy)) {\n client.setNetworkPolicy = async (policy: NetworkPolicyIface) => {\n await call(HandleRpcMethod.SetNetworkPolicy, policy);\n };\n }\n if (capabilities.includes(SandboxCapability.Egress)) {\n client.egress = (request) => call(HandleRpcMethod.Egress, request);\n }\n if (capabilities.includes(SandboxCapability.DurableProcesses))\n client.attachProcess = attachProcess;\n if (capabilities.includes(SandboxCapability.ComputerUse)) {\n client.computerUse = async (): Promise<SandboxMcpEndpoint> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.ComputerUse, {});\n return mcpEndpoint(connection, result);\n };\n }\n if (capabilities.includes(SandboxCapability.Screen)) {\n client.screen = (options): Promise<ScreenSessionIface> =>\n call(HandleRpcMethod.Screen, options ?? {});\n }\n if (capabilities.includes(SandboxCapability.LocalMcp)) {\n client.localMcp = async (): Promise<SandboxMcpEndpoint[]> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.LocalMcp, {});\n return result.endpoints.map((endpoint) => mcpEndpoint(connection, endpoint));\n };\n }\n return client;\n};\n"],
|
|
5
|
-
"mappings": "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",
|
|
4
|
+
"sourcesContent": ["import { bytesToBase64, bytesToStream, encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { resolvePosixPath } from \"./paths.mjs\";\nimport { createRpcPeer, type RpcPeerIface } from \"./rpc-peer.mjs\";\nimport {\n isSandboxWorkerEndpoint,\n SandboxCapability,\n type AbortableIface,\n type DirEntryIface,\n type McpChannelIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxAttachedProcessIface,\n type SandboxAttachProcessOptionsIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxWorkerOptionsIface,\n type SandboxWorkerStartType,\n type ScreenSessionIface,\n type StatIface,\n} from \"./types.mjs\";\nimport {\n frameChannelFromWebSocket,\n HANDLE_RPC_IDEMPOTENT_METHODS,\n HANDLE_RPC_VERSION,\n handleRpcClientProtocols,\n HandleRpcCloseCode,\n handleRpcError,\n HandleRpcErrorCode,\n HandleRpcMethod,\n handleRpcMethodSchemas,\n isHandleRpcError,\n MAX_INLINE_WRITE_BYTES,\n parseHandleRpcResult,\n type FrameChannelIface,\n type HandleRpcParams,\n type HandleRpcResult,\n type InitializeResultIface,\n type WebSocketConstructorIface,\n} from \"./wire.mjs\";\n\n// NetworkSandboxSessionIface implemented purely over the handle RPC: no\n// provider code, only the wire. Works wherever a WebSocket exists (Workers,\n// browsers, Node 22+) or over any frame channel through `openChannel`.\n\nexport interface SandboxClientIface extends NetworkSandboxSessionIface {\n readonly confinedFiles: boolean;\n readonly providerHooks: boolean;\n onSandboxStop(): Promise<void>;\n onSandboxDelete(options?: { reason?: string }): Promise<void>;\n onRuntimeShutdown(): Promise<void>;\n readonly capabilities: readonly SandboxCapability[];\n // A byte range of a file, streamed; null when the file does not exist.\n readFileRange(options: {\n path: string;\n root?: string;\n offset: number;\n length?: number;\n abortSignal?: AbortSignal;\n }): Promise<ReadableStream<Uint8Array> | null>;\n // Closes every connection and fails in-flight calls.\n close(): void;\n}\n\nexport interface SandboxClientCredentialIface {\n token: string;\n expiresAt: string | null;\n // A new stable endpoint URL, when the issuer moved it.\n url?: string;\n}\n\nexport interface ConnectSandboxClientArgsIface {\n // The session service's stable per-binding address; the first call to reach\n // it attaches the sandbox, and every call is served there.\n url: string;\n token: string;\n expiresAt?: string | null;\n // Defaults to the global WebSocket.\n WebSocket?: WebSocketConstructorIface;\n // Replaces WebSocket dialing entirely (relays, tests).\n openChannel?: (target: { url: string; token: string }) => Promise<FrameChannelIface>;\n // Returns a fresh credential for the stable endpoint (`url`), e.g. from the\n // broker's `sandbox` route.\n refreshToken?: () => Promise<SandboxClientCredentialIface>;\n // Send stream chunks as binary frames (default true).\n binary?: boolean;\n reconnect?: { attempts?: number; baseDelayMs?: number; maxDelayMs?: number };\n // How long before expiry to refresh the credential (default 60 s).\n refreshMarginMs?: number;\n // On a sandbox provider's attach socket: the platform-identity assertion the\n // connection presents, sent in `initialize`. Asked again before every call;\n // when the answer changed, `identity/refresh` goes out first. `renew` asks\n // for a new one before the one in force expires.\n identity?: (args: { renew: boolean }) => Promise<string>;\n clientInfo?: { name: string; version: string };\n now?: () => number;\n sleep?: (ms: number) => Promise<void>;\n randomId?: () => string;\n}\n\ninterface TargetIface {\n url: string;\n token: string;\n expiresAt: string | null;\n}\n\ninterface ConnectionIface {\n peer: RpcPeerIface;\n target: TargetIface;\n info: InitializeResultIface;\n nextStreamId: number;\n // The assertion in force (`identity`), and the last identity sync, which calls wait on.\n identity: string | null;\n identitySync: Promise<void>;\n identityTimer: ReturnType<typeof setTimeout> | null;\n}\n\nconst defaultSleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\nconst defaultOpenChannel =\n (WebSocketImpl: WebSocketConstructorIface | undefined) =>\n async (target: { url: string; token: string }): Promise<FrameChannelIface> => {\n const Impl = WebSocketImpl ?? globalThis.WebSocket;\n if (Impl == null)\n throw new Error('no WebSocket implementation available; pass WebSocket or openChannel');\n const { channel, opened } = frameChannelFromWebSocket(\n new Impl(target.url, handleRpcClientProtocols(target.token)),\n );\n await opened;\n return channel;\n };\n\nconst isRetryable = (cause: unknown): boolean => isHandleRpcError(cause) && cause.retryable;\n\nexport const connectSandboxClient = async (\n args: ConnectSandboxClientArgsIface,\n): Promise<SandboxClientIface> => {\n const now = args.now ?? Date.now;\n const sleep = args.sleep ?? defaultSleep;\n const randomId = args.randomId ?? (() => crypto.randomUUID());\n const openChannel = args.openChannel ?? defaultOpenChannel(args.WebSocket);\n const attempts = args.reconnect?.attempts ?? 5;\n const baseDelayMs = args.reconnect?.baseDelayMs ?? 100;\n const maxDelayMs = args.reconnect?.maxDelayMs ?? 5_000;\n const refreshMarginMs = args.refreshMarginMs ?? 60_000;\n const binary = args.binary ?? true;\n\n let origin: TargetIface = {\n url: args.url,\n token: args.token,\n expiresAt: args.expiresAt ?? null,\n };\n let current: ConnectionIface | null = null;\n let connecting: Promise<ConnectionIface> | null = null;\n let closedByUser = false;\n let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n const live = new Set<ConnectionIface>();\n let lastInfo: InitializeResultIface | null = null;\n\n const refreshOrigin = async (): Promise<boolean> => {\n if (args.refreshToken == null) return false;\n const fresh = await args.refreshToken();\n origin = {\n url: fresh.url ?? origin.url,\n token: fresh.token,\n expiresAt: fresh.expiresAt,\n };\n return true;\n };\n\n const scheduleRefresh = (connection: ConnectionIface) => {\n if (refreshTimer != null) clearTimeout(refreshTimer);\n refreshTimer = null;\n const expiresAt = connection.info.expiresAt ?? connection.target.expiresAt;\n if (expiresAt == null || args.refreshToken == null || closedByUser) return;\n const remaining = Date.parse(expiresAt) - now();\n if (Number.isNaN(remaining)) return;\n const delay = Math.max(0, Math.min(remaining - refreshMarginMs, remaining / 2));\n refreshTimer = setTimeout(\n () => {\n void refreshConnection(connection).catch(() => undefined);\n },\n Math.min(2_147_483_647, delay),\n );\n };\n\n // The connection takes the new token in place; in-flight calls continue.\n // A moved endpoint (a new `url`) is dialed fresh instead, and in-flight\n // calls finish on the old connection.\n const refreshConnection = async (connection: ConnectionIface) => {\n if (closedByUser || connection.peer.isClosed()) return;\n await refreshOrigin();\n if (origin.url === connection.target.url) {\n const result = await requestOn(connection, HandleRpcMethod.AuthRefresh, {\n token: origin.token,\n });\n connection.target = {\n ...connection.target,\n token: origin.token,\n expiresAt: result.expiresAt,\n };\n connection.info = { ...connection.info, expiresAt: result.expiresAt };\n scheduleRefresh(connection);\n return;\n }\n if (current === connection) current = null;\n await getConnection();\n };\n\n // Sends `identity/refresh` when the assertion the caller hands out changed\n // (or, with `renew`, for a new one), one sync at a time per connection.\n // Calls on a process or MCP channel already open reuse the identity in force.\n const syncIdentity = (connection: ConnectionIface, renew: boolean): Promise<void> => {\n const identity = args.identity;\n if (identity == null) return Promise.resolve();\n const run = connection.identitySync.then(async () => {\n const assertion = await identity({ renew });\n if (assertion === connection.identity || connection.peer.isClosed()) return;\n const raw = await connection.peer.request(HandleRpcMethod.IdentityRefresh, { assertion });\n connection.identity = assertion;\n scheduleIdentityRenewal(\n connection,\n parseHandleRpcResult(HandleRpcMethod.IdentityRefresh, raw).expiresAt,\n );\n });\n connection.identitySync = run.catch(() => undefined);\n return run;\n };\n\n const scheduleIdentityRenewal = (connection: ConnectionIface, expiresAt: string | null) => {\n if (connection.identityTimer != null) clearTimeout(connection.identityTimer);\n connection.identityTimer = null;\n if (expiresAt == null || args.identity == null || closedByUser) return;\n const remaining = Date.parse(expiresAt) - now();\n if (Number.isNaN(remaining)) return;\n const delay = Math.max(0, Math.min(remaining - refreshMarginMs, remaining / 2));\n connection.identityTimer = setTimeout(\n () => {\n void syncIdentity(connection, true).catch(() => undefined);\n },\n Math.min(2_147_483_647, delay),\n );\n };\n\n const initialize = async (target: TargetIface): Promise<ConnectionIface> => {\n const channel = await openChannel({ url: target.url, token: target.token });\n let connection: ConnectionIface | null = null;\n const peer = createRpcPeer({\n channel,\n binary,\n onClose: () => {\n if (connection == null) return;\n if (connection.identityTimer != null) clearTimeout(connection.identityTimer);\n live.delete(connection);\n if (current === connection) current = null;\n },\n });\n try {\n const identity = args.identity == null ? null : await args.identity({ renew: false });\n const raw = await peer.request(HandleRpcMethod.Initialize, {\n handleRpcVersion: HANDLE_RPC_VERSION,\n token: target.token,\n ...(identity == null ? {} : { identity }),\n client: args.clientInfo,\n });\n const info = handleRpcMethodSchemas[HandleRpcMethod.Initialize].result.parse(raw);\n connection = {\n peer,\n target,\n info,\n nextStreamId: 1,\n identity,\n identitySync: Promise.resolve(),\n identityTimer: null,\n };\n live.add(connection);\n if (identity != null) scheduleIdentityRenewal(connection, info.expiresAt);\n return connection;\n } catch (error) {\n peer.close(HandleRpcCloseCode.Normal, 'initialize failed');\n throw error;\n }\n };\n\n const establish = async (): Promise<ConnectionIface> => {\n let failures = 0;\n let refreshed = false;\n for (;;) {\n if (closedByUser)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'client closed',\n });\n try {\n const connection = await initialize(origin);\n current = connection;\n lastInfo = connection.info;\n scheduleRefresh(connection);\n return connection;\n } catch (error) {\n if (closedByUser) throw error;\n const unauthorized =\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Unauthorized;\n if (unauthorized && !refreshed && (await refreshOrigin().catch(() => false))) {\n refreshed = true;\n continue;\n }\n if (unauthorized) throw error;\n failures += 1;\n if (failures >= attempts) {\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: `could not connect to the sandbox: ${error instanceof Error ? error.message : String(error)}`,\n retryable: true,\n });\n }\n await sleep(Math.min(maxDelayMs, baseDelayMs * 2 ** (failures - 1)));\n }\n }\n };\n\n const liveConnection = (): Promise<ConnectionIface> => {\n if (current != null && !current.peer.isClosed()) return Promise.resolve(current);\n connecting ??= establish().finally(() => {\n connecting = null;\n });\n return connecting;\n };\n\n // The connection for the next call, its identity brought up to date first\n // (before the call opens any stream, so stream chunks never precede it).\n const getConnection = async (): Promise<ConnectionIface> => {\n const connection = await liveConnection();\n await syncIdentity(connection, false);\n return connection;\n };\n\n const requestOn = async <M extends HandleRpcMethod>(\n connection: ConnectionIface,\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => {\n const raw = await connection.peer.request(method, params, { signal: options?.signal });\n return parseHandleRpcResult(method, raw);\n };\n\n const callOnConnection = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<{ connection: ConnectionIface; result: HandleRpcResult<M> }> => {\n const idempotent = HANDLE_RPC_IDEMPOTENT_METHODS.includes(method);\n for (let attempt = 0; ; attempt += 1) {\n const connection = await getConnection();\n try {\n return { connection, result: await requestOn(connection, method, params, options) };\n } catch (error) {\n if (attempt === 0 && idempotent && isRetryable(error)) continue;\n throw error;\n }\n }\n };\n\n const call = async <M extends HandleRpcMethod>(\n method: M,\n params: HandleRpcParams<M>,\n options?: { signal?: AbortSignal },\n ): Promise<HandleRpcResult<M>> => (await callOnConnection(method, params, options)).result;\n\n const allocateStreamId = (connection: ConnectionIface): number => {\n const id = connection.nextStreamId;\n connection.nextStreamId += 1;\n return id;\n };\n\n const first = await getConnection();\n const describe = (): InitializeResultIface => current?.info ?? lastInfo ?? first.info;\n\n const readFile = async (options: {\n path: string;\n root?: string;\n offset?: number;\n length?: number;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const stream = connection.peer.streams.openIncoming(streamId);\n try {\n const result = await requestOn(\n connection,\n HandleRpcMethod.ReadFile,\n {\n path: options.path,\n root: options.root,\n streamId,\n offset: options.offset,\n length: options.length,\n },\n { signal: options.abortSignal },\n );\n if (!result.found) {\n connection.peer.streams.discardIncoming(streamId);\n return null;\n }\n } catch (error) {\n connection.peer.streams.discardIncoming(streamId);\n throw error;\n }\n options.abortSignal?.addEventListener(\n 'abort',\n () => connection.peer.streams.cancelIncoming(streamId, 'aborted'),\n {\n once: true,\n },\n );\n return stream;\n };\n\n const writeFile = async (options: {\n path: string;\n content: ReadableStream<Uint8Array>;\n abortSignal?: AbortSignal;\n }) => {\n const connection = await getConnection();\n const streamId = allocateStreamId(connection);\n const sending = connection.peer.streams.openOutgoing(streamId, options.content);\n sending.catch(() => undefined);\n try {\n await requestOn(\n connection,\n HandleRpcMethod.WriteFile,\n { path: options.path, streamId },\n { signal: options.abortSignal },\n );\n } catch (error) {\n connection.peer.streams.abortOutgoing(streamId, 'request failed');\n throw error;\n }\n };\n\n const writeBinaryFile = async (options: {\n path: string;\n content: Uint8Array;\n abortSignal?: AbortSignal;\n }) => {\n if (options.content.byteLength > MAX_INLINE_WRITE_BYTES) {\n await writeFile({\n path: options.path,\n content: bytesToStream(options.content),\n abortSignal: options.abortSignal,\n });\n return;\n }\n await call(\n HandleRpcMethod.WriteFile,\n { path: options.path, contentBase64: bytesToBase64(options.content) },\n { signal: options.abortSignal },\n );\n };\n\n // process/wait and process/kill for a served process. Aborting `abortSignal`\n // kills an ordinary process; a durable one is detached instead (process/detach):\n // its streams fail here and stop on the server, and it keeps running.\n const processControls = (args: {\n connection: ConnectionIface;\n processId: string;\n durable: boolean;\n streamIds: number[];\n abortSignal?: AbortSignal;\n }): Pick<SandboxProcessIface, 'wait' | 'kill'> => {\n const { connection, processId } = args;\n let waiting: Promise<{ exitCode: number }> | null = null;\n const kill = async (signal?: string) => {\n try {\n await requestOn(connection, HandleRpcMethod.ProcessKill, { processId, signal });\n } catch (error) {\n // Already exited and reaped, or the connection (and so the process) is gone.\n if (\n isHandleRpcError(error) &&\n (error.code === HandleRpcErrorCode.NotFound || error.retryable)\n )\n return;\n throw error;\n }\n };\n const onAbort = () => {\n if (!args.durable) {\n void kill().catch(() => undefined);\n return;\n }\n for (const streamId of args.streamIds)\n connection.peer.streams.cancelIncoming(streamId, 'process handle detached');\n // Best effort: a closed connection already released it on the server.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n };\n args.abortSignal?.addEventListener('abort', onAbort, { once: true });\n if (args.abortSignal?.aborted === true) onAbort();\n return {\n wait: () => {\n waiting ??= requestOn(\n connection,\n HandleRpcMethod.ProcessWait,\n { processId },\n { signal: args.abortSignal },\n );\n return waiting;\n },\n kill,\n };\n };\n\n // A served process: `sandbox/spawn` or `sandbox/startWorker`, with the\n // streams and controls they share.\n const startProcess = async (args: {\n stdin: ReadableStream<Uint8Array> | string | undefined;\n durable: boolean | undefined;\n abortSignal: AbortSignal | undefined;\n request: (\n connection: ConnectionIface,\n streams: {\n processId: string;\n stdinStreamId: number;\n stdoutStreamId: number;\n stderrStreamId: number;\n durable?: true;\n },\n ) => Promise<HandleRpcResult<HandleRpcMethod.StartWorker>>;\n }): Promise<SandboxWorkerStartType> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdinStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (args.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (args.stdin instanceof ReadableStream) {\n stdinSource = args.stdin;\n } else {\n stdinSource = bytesToStream(utf8Encode(args.stdin));\n }\n connection.peer.streams.openOutgoing(stdinStreamId, stdinSource).catch(() => undefined);\n // Servers without the capability would ignore it; older ones do not know it.\n const durable =\n args.durable === true &&\n connection.info.capabilities.includes(SandboxCapability.DurableProcesses);\n let result: HandleRpcResult<HandleRpcMethod.StartWorker>;\n try {\n result = await args.request(connection, {\n processId,\n stdinStreamId,\n stdoutStreamId,\n stderrStreamId,\n ...(durable ? { durable: true } : {}),\n });\n } catch (error) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'start failed');\n throw error;\n }\n // A worker program serving its own endpoint: its streams carry nothing.\n if ('endpoint' in result) {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n connection.peer.streams.abortOutgoing(stdinStreamId, 'worker endpoint');\n return { endpoint: result.endpoint };\n }\n const ref = result.ref ?? null;\n const controls = processControls({\n connection,\n processId,\n durable: ref != null,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: args.abortSignal,\n });\n return {\n pid: result.pid,\n ref,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n // A detached handle is done with the process.\n if (ref != null) args.abortSignal?.throwIfAborted();\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n ...controls,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const started = await startProcess({\n stdin: options.stdin,\n durable: options.durable,\n abortSignal: options.abortSignal,\n request: (connection, streams) =>\n requestOn(connection, HandleRpcMethod.Spawn, {\n command: options.command,\n args: options.args,\n cwd: options.cwd,\n env: options.env,\n shell: options.shell,\n timeoutMs: options.timeoutMs,\n ...streams,\n }),\n });\n if (isSandboxWorkerEndpoint(started))\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidRequest,\n message: 'sandbox/spawn answered with an endpoint',\n });\n return started;\n };\n\n const startWorker = (options: SandboxWorkerOptionsIface): Promise<SandboxWorkerStartType> =>\n startProcess({\n stdin: undefined,\n durable: options.durable,\n abortSignal: options.abortSignal,\n request: (connection, streams) =>\n requestOn(connection, HandleRpcMethod.StartWorker, {\n program: options.program,\n env: options.env,\n input: options.input,\n ...(options.identity == null ? {} : { identity: options.identity }),\n ...streams,\n }),\n });\n\n const attachProcess = async (\n options: SandboxAttachProcessOptionsIface,\n ): Promise<SandboxAttachedProcessIface | null> => {\n const connection = await getConnection();\n const processId = randomId();\n const stdoutStreamId = allocateStreamId(connection);\n const stderrStreamId = allocateStreamId(connection);\n const stdout = connection.peer.streams.openIncoming(stdoutStreamId);\n const stderr = connection.peer.streams.openIncoming(stderrStreamId);\n const discard = () => {\n connection.peer.streams.discardIncoming(stdoutStreamId);\n connection.peer.streams.discardIncoming(stderrStreamId);\n };\n let result: HandleRpcResult<HandleRpcMethod.ProcessAttach>;\n try {\n result = await requestOn(\n connection,\n HandleRpcMethod.ProcessAttach,\n {\n processId,\n ref: options.ref,\n stdoutOffset: options.stdoutOffset,\n stderrOffset: options.stderrOffset,\n stdoutStreamId,\n stderrStreamId,\n },\n { signal: options.abortSignal },\n );\n } catch (error) {\n discard();\n // The server may have attached it before the cancellation reached it.\n void requestOn(connection, HandleRpcMethod.ProcessDetach, { processId }).catch(\n () => undefined,\n );\n throw error;\n }\n if (!result.found) {\n discard();\n return null;\n }\n return {\n ref: options.ref,\n stdoutOffset: result.stdoutOffset,\n stderrOffset: result.stderrOffset,\n stdout,\n stderr,\n ...processControls({\n connection,\n processId,\n durable: true,\n streamIds: [stdoutStreamId, stderrStreamId],\n abortSignal: options.abortSignal,\n }),\n };\n };\n\n const client: SandboxClientIface = {\n get id() {\n return describe().id;\n },\n get defaultWorkingDirectory() {\n return describe().defaultWorkingDirectory;\n },\n get ports() {\n return describe().ports;\n },\n get description() {\n return describe().description;\n },\n get capabilities() {\n return describe().capabilities;\n },\n confinedFiles: describe().confinedFiles === true,\n providerHooks: describe().providerHooks === true,\n onRuntimeShutdown: async () => {\n await call(HandleRpcMethod.OnRuntimeShutdown, {});\n },\n onSandboxStop: async () => {\n await call(HandleRpcMethod.OnSandboxStop, {});\n },\n onSandboxDelete: async (options) => {\n await call(HandleRpcMethod.OnSandboxDelete, options ?? {});\n },\n readFile: (options) => readFile(options),\n readFileRange: readFile,\n readBinaryFile: async (options) => {\n const stream = await readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const { abortSignal: _abortSignal, ...params } = options;\n const parsed = handleRpcMethodSchemas[HandleRpcMethod.ReadTextFile].params.safeParse(params);\n if (!parsed.success)\n throw handleRpcError({\n code: HandleRpcErrorCode.InvalidParams,\n message: parsed.error.message,\n });\n const stream = await readFile({ path: options.path, abortSignal: options.abortSignal });\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile,\n writeBinaryFile,\n writeTextFile: async (options) =>\n writeBinaryFile({\n path: options.path,\n content: encodeSandboxText(options.content, options.encoding),\n abortSignal: options.abortSignal,\n }),\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options): Promise<StatIface | null> =>\n (\n await call(\n HandleRpcMethod.Stat,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).stat,\n readDir: async (options): Promise<DirEntryIface[]> =>\n (\n await call(\n HandleRpcMethod.ReadDir,\n { path: options.path, root: options.root },\n { signal: options.abortSignal },\n )\n ).entries,\n resolvePath: (path) => resolvePosixPath(describe().defaultWorkingDirectory, path),\n removePath: async (options) => {\n const { abortSignal, ...params } = options;\n await call(HandleRpcMethod.RemovePath, params, { signal: abortSignal });\n },\n getPortEndpoint: (options) => call(HandleRpcMethod.GetPortEndpoint, options),\n getPortUrl: async (options) => (await call(HandleRpcMethod.GetPortEndpoint, options)).url,\n stop: async () => {\n await call(HandleRpcMethod.Stop, {});\n },\n destroy: async () => {\n await call(HandleRpcMethod.Destroy, {});\n },\n close: () => {\n closedByUser = true;\n if (refreshTimer != null) clearTimeout(refreshTimer);\n for (const connection of live)\n connection.peer.close(HandleRpcCloseCode.Normal, 'client closed');\n live.clear();\n current = null;\n },\n };\n\n const mcpEndpoint = (\n connection: ConnectionIface,\n endpoint: HandleRpcResult<HandleRpcMethod.ComputerUse>,\n ): SandboxMcpEndpoint => {\n if ('url' in endpoint) return endpoint;\n return {\n name: endpoint.name,\n connect: async (options?: AbortableIface): Promise<McpChannelIface> => {\n const opened = await requestOn(\n connection,\n HandleRpcMethod.McpOpen,\n { endpointKey: endpoint.endpointKey },\n { signal: options?.abortSignal },\n );\n let closed = false;\n const requireOpen = (): void => {\n if (closed)\n throw handleRpcError({\n code: HandleRpcErrorCode.ConnectionClosed,\n message: 'MCP channel closed',\n });\n };\n const channel: McpChannelIface = {\n send: async (message, sendOptions) => {\n requireOpen();\n await requestOn(\n connection,\n HandleRpcMethod.McpSend,\n { channelId: opened.channelId, message },\n { signal: sendOptions?.abortSignal },\n );\n },\n receive: async (receiveOptions) => {\n requireOpen();\n return (\n await requestOn(\n connection,\n HandleRpcMethod.McpReceive,\n { channelId: opened.channelId },\n { signal: receiveOptions?.abortSignal },\n )\n ).messages;\n },\n close: async () => {\n if (closed) return;\n closed = true;\n if (!connection.peer.isClosed())\n await requestOn(connection, HandleRpcMethod.McpClose, {\n channelId: opened.channelId,\n });\n },\n };\n if (options?.abortSignal?.aborted === true) {\n await channel.close().catch(() => undefined);\n options.abortSignal.throwIfAborted();\n }\n return channel;\n },\n };\n };\n\n const capabilities = first.info.capabilities;\n if (capabilities.includes(SandboxCapability.NetworkPolicy)) {\n client.setNetworkPolicy = async (policy: NetworkPolicyIface) => {\n await call(HandleRpcMethod.SetNetworkPolicy, policy);\n };\n }\n if (capabilities.includes(SandboxCapability.Egress)) {\n client.egress = (request) => call(HandleRpcMethod.Egress, request);\n }\n if (capabilities.includes(SandboxCapability.DurableProcesses))\n client.attachProcess = attachProcess;\n if (capabilities.includes(SandboxCapability.Workers)) client.startWorker = startWorker;\n if (capabilities.includes(SandboxCapability.ComputerUse)) {\n client.computerUse = async (): Promise<SandboxMcpEndpoint> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.ComputerUse, {});\n return mcpEndpoint(connection, result);\n };\n }\n if (capabilities.includes(SandboxCapability.Screen)) {\n client.screen = (options): Promise<ScreenSessionIface> =>\n call(HandleRpcMethod.Screen, options ?? {});\n }\n if (capabilities.includes(SandboxCapability.LocalMcp)) {\n client.localMcp = async (): Promise<SandboxMcpEndpoint[]> => {\n const { connection, result } = await callOnConnection(HandleRpcMethod.LocalMcp, {});\n return result.endpoints.map((endpoint) => mcpEndpoint(connection, endpoint));\n };\n }\n return client;\n};\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["args"]
|
|
7
7
|
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { Capability, FilesAccess, ScreenAccess, ShellAccess, type CapabilityAccess } from '@finalai/agent-protocol';
|
|
2
|
+
import * as z from 'zod';
|
|
3
|
+
import type { JsonValue } from "../json.mjs";
|
|
4
|
+
import { HandleRpcMethod } from "./wire.mjs";
|
|
5
|
+
export interface SandboxGrantIface {
|
|
6
|
+
[Capability.Files]?: FilesAccess;
|
|
7
|
+
[Capability.Shell]?: ShellAccess;
|
|
8
|
+
[Capability.ComputerUse]?: ScreenAccess;
|
|
9
|
+
[Capability.BrowserUse]?: ScreenAccess;
|
|
10
|
+
}
|
|
11
|
+
export declare const sandboxGrantSchema: z.ZodObject<{
|
|
12
|
+
files: z.ZodOptional<z.ZodEnum<typeof FilesAccess>>;
|
|
13
|
+
shell: z.ZodOptional<z.ZodEnum<typeof ShellAccess>>;
|
|
14
|
+
computerUse: z.ZodOptional<z.ZodEnum<typeof ScreenAccess>>;
|
|
15
|
+
browserUse: z.ZodOptional<z.ZodEnum<typeof ScreenAccess>>;
|
|
16
|
+
}, z.core.$strict>;
|
|
17
|
+
export declare const FULL_SANDBOX_GRANT: Readonly<SandboxGrantIface>;
|
|
18
|
+
export declare const grantAllows: (grant: SandboxGrantIface, capability: Capability, access: CapabilityAccess) => boolean;
|
|
19
|
+
export declare const narrowerGrant: (a: SandboxGrantIface, b: SandboxGrantIface) => SandboxGrantIface;
|
|
20
|
+
export declare const sandboxGrantFor: (args: {
|
|
21
|
+
capabilities: readonly Capability[];
|
|
22
|
+
required: Partial<Record<Capability, {
|
|
23
|
+
access: CapabilityAccess;
|
|
24
|
+
}>>;
|
|
25
|
+
}) => SandboxGrantIface;
|
|
26
|
+
export interface HandleMethodNeedIface {
|
|
27
|
+
capability: Capability;
|
|
28
|
+
access: CapabilityAccess;
|
|
29
|
+
}
|
|
30
|
+
export interface HandleMethodGateIface {
|
|
31
|
+
needs: HandleMethodNeedIface | null;
|
|
32
|
+
lifecycle: boolean;
|
|
33
|
+
channel: boolean;
|
|
34
|
+
}
|
|
35
|
+
export declare const HANDLE_METHOD_GATES: {
|
|
36
|
+
readonly initialize: HandleMethodGateIface;
|
|
37
|
+
readonly "sandbox/describe": HandleMethodGateIface;
|
|
38
|
+
readonly "auth/refresh": HandleMethodGateIface;
|
|
39
|
+
readonly "identity/refresh": HandleMethodGateIface;
|
|
40
|
+
readonly "sandbox/readFile": HandleMethodGateIface;
|
|
41
|
+
readonly "sandbox/readTextFile": HandleMethodGateIface;
|
|
42
|
+
readonly "sandbox/stat": HandleMethodGateIface;
|
|
43
|
+
readonly "sandbox/readDir": HandleMethodGateIface;
|
|
44
|
+
readonly "sandbox/writeFile": HandleMethodGateIface;
|
|
45
|
+
readonly "sandbox/removePath": HandleMethodGateIface;
|
|
46
|
+
readonly "sandbox/spawn": HandleMethodGateIface;
|
|
47
|
+
readonly "sandbox/run": HandleMethodGateIface;
|
|
48
|
+
readonly "sandbox/startWorker": HandleMethodGateIface;
|
|
49
|
+
readonly "process/wait": HandleMethodGateIface;
|
|
50
|
+
readonly "process/kill": HandleMethodGateIface;
|
|
51
|
+
readonly "process/attach": HandleMethodGateIface;
|
|
52
|
+
readonly "process/detach": HandleMethodGateIface;
|
|
53
|
+
readonly "sandbox/getPortEndpoint": HandleMethodGateIface;
|
|
54
|
+
readonly "sandbox/localMcp": HandleMethodGateIface;
|
|
55
|
+
readonly "sandbox/computerUse": HandleMethodGateIface;
|
|
56
|
+
readonly "sandbox/screen": HandleMethodGateIface;
|
|
57
|
+
readonly "mcp/open": HandleMethodGateIface;
|
|
58
|
+
readonly "mcp/send": HandleMethodGateIface;
|
|
59
|
+
readonly "mcp/receive": HandleMethodGateIface;
|
|
60
|
+
readonly "mcp/close": HandleMethodGateIface;
|
|
61
|
+
readonly "sandbox/egress": HandleMethodGateIface;
|
|
62
|
+
readonly "sandbox/setNetworkPolicy": HandleMethodGateIface;
|
|
63
|
+
readonly "sandbox/stop": HandleMethodGateIface;
|
|
64
|
+
readonly "sandbox/destroy": HandleMethodGateIface;
|
|
65
|
+
readonly "handle/onSandboxStop": HandleMethodGateIface;
|
|
66
|
+
readonly "handle/onSandboxDelete": HandleMethodGateIface;
|
|
67
|
+
readonly "handle/onRuntimeShutdown": HandleMethodGateIface;
|
|
68
|
+
};
|
|
69
|
+
export declare const handleMethodGate: (method: HandleRpcMethod, params: JsonValue | undefined) => HandleMethodGateIface;
|
|
70
|
+
export interface HandleAccessPolicyIface {
|
|
71
|
+
grant: SandboxGrantIface;
|
|
72
|
+
lifecycle: boolean;
|
|
73
|
+
}
|
|
74
|
+
export declare const handleMethodRefusal: (args: {
|
|
75
|
+
access: HandleAccessPolicyIface;
|
|
76
|
+
method: HandleRpcMethod;
|
|
77
|
+
params?: JsonValue;
|
|
78
|
+
}) => string | null;
|