@finalai/final-agent-provider 0.2.0 → 0.2.2
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/dist/modules/sandboxes/computer.d.mts +2 -0
- package/dist/modules/sandboxes/computer.mjs +70 -18
- package/dist/modules/sandboxes/computer.mjs.map +3 -3
- package/dist/modules/sandboxes/device.d.mts +2 -0
- package/dist/modules/sandboxes/device.mjs +27 -4
- package/dist/modules/sandboxes/device.mjs.map +2 -2
- package/dist/modules/sandboxes/session.d.mts +1 -1
- package/dist/modules/sandboxes/session.mjs +1 -1
- package/dist/modules/sandboxes/session.mjs.map +2 -2
- package/dist/modules/sandboxes/testing/fake-backends.d.mts +3 -0
- package/dist/modules/sandboxes/testing/fake-backends.mjs +35 -3
- package/dist/modules/sandboxes/testing/fake-backends.mjs.map +2 -2
- package/dist/modules/sandboxes/testing/fake-machine.mjs +8 -0
- package/dist/modules/sandboxes/testing/fake-machine.mjs.map +2 -2
- package/package.json +3 -3
|
@@ -29,6 +29,8 @@ export interface ComputerSandboxProviderConfigIface {
|
|
|
29
29
|
buildPollMs?: number;
|
|
30
30
|
shelveWaitMs?: number;
|
|
31
31
|
shelvePollMs?: number;
|
|
32
|
+
runningWaitMs?: number;
|
|
33
|
+
runningPollMs?: number;
|
|
32
34
|
log?: ComputerSandboxLogIface;
|
|
33
35
|
randomUuid?: () => string;
|
|
34
36
|
now?: () => number;
|
|
@@ -8,14 +8,19 @@ import {
|
|
|
8
8
|
import {
|
|
9
9
|
defineSandboxProvider,
|
|
10
10
|
materializeSandboxSeeds,
|
|
11
|
+
PLATFORM_ENVIRONMENT_NAMES,
|
|
12
|
+
platformProcessEnvironment,
|
|
11
13
|
PortProtocol,
|
|
14
|
+
reportPlatformNetworkPolicy,
|
|
12
15
|
SandboxCapability,
|
|
13
16
|
sandboxSeedArtifact,
|
|
14
17
|
sandboxSeedArtifactSchema,
|
|
15
18
|
sandboxSeedFiles,
|
|
16
19
|
sandboxSeedFilesForStart,
|
|
17
20
|
sandboxSeedIdentity,
|
|
18
|
-
SandboxWorkspace
|
|
21
|
+
SandboxWorkspace,
|
|
22
|
+
withPlatformEgressHosts,
|
|
23
|
+
writePlatformFiles
|
|
19
24
|
} from "@finalai/agent-provider/sandbox";
|
|
20
25
|
import {
|
|
21
26
|
ComputerBaseState,
|
|
@@ -95,6 +100,7 @@ const computerStateSchema = z.object({
|
|
|
95
100
|
});
|
|
96
101
|
const computerSandboxError = (code, message) => Object.assign(new Error(message), { name: "ComputerSandboxError", code });
|
|
97
102
|
const RESERVED_ENV = /* @__PURE__ */ new Set([
|
|
103
|
+
...PLATFORM_ENVIRONMENT_NAMES,
|
|
98
104
|
"DISPLAY",
|
|
99
105
|
"XDG_RUNTIME_DIR",
|
|
100
106
|
"PATH",
|
|
@@ -129,12 +135,12 @@ const CAPTURE_SCRUBBED_PATHS = [
|
|
|
129
135
|
"/home/user/.ssh"
|
|
130
136
|
];
|
|
131
137
|
const BUILDER_IDLE_TIMEOUT_SECONDS = 2 * 60 * 60;
|
|
132
|
-
const
|
|
133
|
-
const policy = spec.parameters.networkPolicy;
|
|
138
|
+
const computerEgressOf = (policy) => {
|
|
134
139
|
if (policy.mode === NetworkPolicy.AllowAll) return { egress: ComputerEgressPolicy.Internet };
|
|
135
140
|
if (policy.mode === NetworkPolicy.DenyAll) return { egress: ComputerEgressPolicy.None };
|
|
136
|
-
return { egress: ComputerEgressPolicy.Allowlist, allow: policy.allow };
|
|
141
|
+
return { egress: ComputerEgressPolicy.Allowlist, allow: policy.allow ?? [] };
|
|
137
142
|
};
|
|
143
|
+
const egressFor = (ctx, requested) => computerEgressOf(withPlatformEgressHosts(ctx, requested));
|
|
138
144
|
const LINEAGE_PREFIX = "lineage:";
|
|
139
145
|
const portOf = (url) => {
|
|
140
146
|
try {
|
|
@@ -152,6 +158,7 @@ const sandboxWorkspaceOf = {
|
|
|
152
158
|
[ComputerWorkspacePolicy.Ephemeral]: SandboxWorkspace.Ephemeral
|
|
153
159
|
};
|
|
154
160
|
const isRunningState = (state) => state === ComputerState.Running || state === ComputerState.Paused || state === ComputerState.Resuming;
|
|
161
|
+
const RUNNING_POLL_MAX_MS = 5e3;
|
|
155
162
|
const createComputerSandboxProvider = (config) => {
|
|
156
163
|
const log = config.log ?? (() => void 0);
|
|
157
164
|
const randomUuid = config.randomUuid ?? (() => crypto.randomUUID());
|
|
@@ -159,6 +166,7 @@ const createComputerSandboxProvider = (config) => {
|
|
|
159
166
|
const sleep = config.sleep ?? defaultSleep;
|
|
160
167
|
const defaultImage = config.defaultImage ?? DEFAULT_COMPUTER_IMAGE;
|
|
161
168
|
const credentials = createComputersApiCredentials(config.computersApi, now);
|
|
169
|
+
const runningWaitMs = config.runningWaitMs ?? 5 * 6e4;
|
|
162
170
|
const clientFor = (organizationId) => createComputersApiClient({ config: config.computersApi, credentials, organizationId });
|
|
163
171
|
const registerImage = (client, reference) => client.registerImage(
|
|
164
172
|
config.registryCredentialId == null ? { reference } : { reference, registryCredentialId: config.registryCredentialId }
|
|
@@ -246,7 +254,7 @@ const createComputerSandboxProvider = (config) => {
|
|
|
246
254
|
${commandHelp}`}`,
|
|
247
255
|
workspaceRoot: WORKSPACE_ROOT,
|
|
248
256
|
transport,
|
|
249
|
-
baseEnv:
|
|
257
|
+
baseEnv: args.env,
|
|
250
258
|
randomUuid,
|
|
251
259
|
network: {
|
|
252
260
|
ports,
|
|
@@ -344,8 +352,7 @@ ${commandHelp}`}`,
|
|
|
344
352
|
setNetworkPolicy: async (policy) => {
|
|
345
353
|
if (args.access === SandboxAccess.Read)
|
|
346
354
|
throw new Error("this sandbox binding is read-only");
|
|
347
|
-
|
|
348
|
-
await client.setNetworkPolicy(info.id, network);
|
|
355
|
+
await client.setNetworkPolicy(info.id, egressFor(args.ctx, policy));
|
|
349
356
|
},
|
|
350
357
|
describe: () => description,
|
|
351
358
|
capabilities
|
|
@@ -397,7 +404,7 @@ ${commandHelp}`}`,
|
|
|
397
404
|
description: `setup of ${args.info.name}`,
|
|
398
405
|
workspaceRoot: WORKSPACE_ROOT,
|
|
399
406
|
transport,
|
|
400
|
-
baseEnv:
|
|
407
|
+
baseEnv: args.env,
|
|
401
408
|
randomUuid,
|
|
402
409
|
network: {
|
|
403
410
|
ports: [],
|
|
@@ -431,6 +438,29 @@ ${commandHelp}`}`,
|
|
|
431
438
|
await sleep(config.buildPollMs ?? 5e3);
|
|
432
439
|
}
|
|
433
440
|
};
|
|
441
|
+
const awaitComputerRunning = async (client, computerId, timeoutMs) => {
|
|
442
|
+
const deadline = now() + timeoutMs;
|
|
443
|
+
let pollMs = config.runningPollMs ?? 250;
|
|
444
|
+
for (; ; ) {
|
|
445
|
+
const computer = await client.getComputer(computerId);
|
|
446
|
+
if (computer == null || computer.state === ComputerState.Deleted)
|
|
447
|
+
throw computerSandboxError("computer_gone", `computer ${computerId} is gone`);
|
|
448
|
+
if (computer.state === ComputerState.Error)
|
|
449
|
+
throw computerSandboxError(
|
|
450
|
+
"computer_gone",
|
|
451
|
+
`computer ${computer.name} is in the Error state`
|
|
452
|
+
);
|
|
453
|
+
if (computer.state === ComputerState.Running) return computer;
|
|
454
|
+
const left = deadline - now();
|
|
455
|
+
if (left <= 0)
|
|
456
|
+
throw computerSandboxError(
|
|
457
|
+
"computer_not_running",
|
|
458
|
+
`computer ${computer.name} was not running within ${Math.round(timeoutMs / 1e3)} s (it is ${ComputerState[computer.state]})`
|
|
459
|
+
);
|
|
460
|
+
await sleep(Math.min(pollMs, left));
|
|
461
|
+
pollMs = Math.min(pollMs * 2, RUNNING_POLL_MAX_MS);
|
|
462
|
+
}
|
|
463
|
+
};
|
|
434
464
|
const awaitShelved = async (client, computerId) => {
|
|
435
465
|
const deadline = now() + (config.shelveWaitMs ?? 5 * 6e4);
|
|
436
466
|
for (; ; ) {
|
|
@@ -471,7 +501,8 @@ ${commandHelp}`}`,
|
|
|
471
501
|
);
|
|
472
502
|
ctx.log?.(`building computer base ${key} on ${builder.name}`);
|
|
473
503
|
try {
|
|
474
|
-
|
|
504
|
+
await awaitComputerRunning(client, builder.id, runningWaitMs);
|
|
505
|
+
const sandbox = setupSession({ client, info: builder, env: async () => ({}) }).sandbox;
|
|
475
506
|
const prepared = await sandbox.run({
|
|
476
507
|
command: "/bin/sh",
|
|
477
508
|
args: ["-c", `mkdir -p ${BUILD_ROOT}
|
|
@@ -569,11 +600,17 @@ ${step.run}`,
|
|
|
569
600
|
sandbox: args.setup.sandbox,
|
|
570
601
|
transport: args.setup.transport,
|
|
571
602
|
template: args.spec.template,
|
|
572
|
-
|
|
603
|
+
// Services run for the computer's life, with the platform's values as they are now.
|
|
604
|
+
env: await args.env(),
|
|
573
605
|
randomUuid,
|
|
574
606
|
log
|
|
575
607
|
});
|
|
576
608
|
};
|
|
609
|
+
const awaitRunning = (ctx, rawState, options2) => awaitComputerRunning(
|
|
610
|
+
clientFor(ctx.session.organizationId),
|
|
611
|
+
computerStateSchema.pick({ computerId: true }).parse(rawState).computerId,
|
|
612
|
+
options2.timeoutMs
|
|
613
|
+
);
|
|
577
614
|
return {
|
|
578
615
|
processes: async (ctx, rawState, request) => {
|
|
579
616
|
const state = computerStateSchema.parse(rawState);
|
|
@@ -672,10 +709,14 @@ ${step.run}`,
|
|
|
672
709
|
base: { kind: "image", image: spec.image, imageVersionId }
|
|
673
710
|
};
|
|
674
711
|
},
|
|
712
|
+
awaitRunning: async (ctx, state, options2) => {
|
|
713
|
+
await awaitRunning(ctx, state, options2);
|
|
714
|
+
},
|
|
675
715
|
start: async (ctx, openOptions, rawArtifact) => {
|
|
676
716
|
const access = computerOpenOptionsSchema.parse(openOptions ?? {}).access;
|
|
677
717
|
const spec = await resolve(ctx.guides);
|
|
678
|
-
const
|
|
718
|
+
const policy = withPlatformEgressHosts(ctx, spec.parameters.networkPolicy);
|
|
719
|
+
const egress = computerEgressOf(policy);
|
|
679
720
|
const artifact = computerArtifactSchema.safeParse(rawArtifact);
|
|
680
721
|
if (!artifact.success) {
|
|
681
722
|
throw computerSandboxError(
|
|
@@ -690,7 +731,7 @@ ${step.run}`,
|
|
|
690
731
|
`computer base ${artifact.data.key} was prepared without its build steps; prepare it again`
|
|
691
732
|
);
|
|
692
733
|
}
|
|
693
|
-
const env = await loadVariables(ctx, spec);
|
|
734
|
+
const env = platformProcessEnvironment(ctx, await loadVariables(ctx, spec));
|
|
694
735
|
const client = clientFor(ctx.session.organizationId);
|
|
695
736
|
const workspace = spec.parameters.workspace;
|
|
696
737
|
const name = workspace === ComputerWorkspacePolicy.Conversation && ctx.session.conversationId != null ? `ac-${(await sha256Hex(`${ctx.session.conversationId}:${ctx.session.target}`)).slice(0, 24)}` : `ab-${compactId(ctx.session.bindingId)}`;
|
|
@@ -731,9 +772,14 @@ ${step.run}`,
|
|
|
731
772
|
const idempotencyKey = `agent-sandbox-${(await sha256Hex(`${ctx.session.bindingId}:${name}:${source.baseId ?? source.imageVersionId}`)).slice(0, 32)}`;
|
|
732
773
|
info = await client.createComputer(body, idempotencyKey);
|
|
733
774
|
}
|
|
734
|
-
|
|
775
|
+
const reused = existing != null && existing.id === info.id;
|
|
776
|
+
log("computer_sandbox.started", { computerId: info.id, reused });
|
|
735
777
|
try {
|
|
778
|
+
info = await awaitRunning(ctx, { computerId: info.id }, { timeoutMs: runningWaitMs });
|
|
779
|
+
if (reused) await client.setNetworkPolicy(info.id, egress);
|
|
780
|
+
await reportPlatformNetworkPolicy(ctx, policy);
|
|
736
781
|
const setup = setupSession({ client, info, env });
|
|
782
|
+
await writePlatformFiles(ctx, setup.sandbox);
|
|
737
783
|
await mountRepositories({
|
|
738
784
|
sandbox: setup.sandbox,
|
|
739
785
|
repositories: spec.parameters.repositories,
|
|
@@ -768,7 +814,7 @@ ${step.run}`,
|
|
|
768
814
|
}
|
|
769
815
|
};
|
|
770
816
|
} catch (error) {
|
|
771
|
-
if (
|
|
817
|
+
if (!reused) {
|
|
772
818
|
try {
|
|
773
819
|
await client.action(info.id, "delete");
|
|
774
820
|
} catch (cleanupError) {
|
|
@@ -790,8 +836,9 @@ ${step.run}`,
|
|
|
790
836
|
"computer_not_running",
|
|
791
837
|
"computer is not running for passive access"
|
|
792
838
|
);
|
|
839
|
+
await awaitRunning(ctx, state, { timeoutMs: runningWaitMs });
|
|
793
840
|
const spec = await resolve(ctx.guides);
|
|
794
|
-
const env = await loadVariables(ctx, spec);
|
|
841
|
+
const env = platformProcessEnvironment(ctx, await loadVariables(ctx, spec));
|
|
795
842
|
return (await buildHandle({ ctx, client, info, spec, access: state.access, env })).handle;
|
|
796
843
|
},
|
|
797
844
|
resume: async (ctx, _artifact, rawState) => {
|
|
@@ -804,15 +851,20 @@ ${step.run}`,
|
|
|
804
851
|
const rebooted = !isRunningState(info.state);
|
|
805
852
|
if (info.state === ComputerState.Paused) await client.action(info.id, "resume");
|
|
806
853
|
else if (rebooted) await client.action(info.id, "start");
|
|
854
|
+
const running = await awaitRunning(ctx, state, { timeoutMs: runningWaitMs });
|
|
807
855
|
const spec = await resolve(ctx.guides);
|
|
808
|
-
const env = await loadVariables(ctx, spec);
|
|
809
|
-
const
|
|
856
|
+
const env = platformProcessEnvironment(ctx, await loadVariables(ctx, spec));
|
|
857
|
+
const policy = withPlatformEgressHosts(ctx, spec.parameters.networkPolicy);
|
|
858
|
+
await client.setNetworkPolicy(running.id, computerEgressOf(policy));
|
|
859
|
+
await reportPlatformNetworkPolicy(ctx, policy);
|
|
860
|
+
const setup = setupSession({ client, info: running, env });
|
|
861
|
+
await writePlatformFiles(ctx, setup.sandbox);
|
|
810
862
|
await installGuideCommands({ sandbox: setup.sandbox, template: spec.template });
|
|
811
863
|
if (rebooted) await startServicesFor({ setup, spec, env });
|
|
812
864
|
const { handle } = await buildHandle({
|
|
813
865
|
ctx,
|
|
814
866
|
client,
|
|
815
|
-
info,
|
|
867
|
+
info: running,
|
|
816
868
|
spec,
|
|
817
869
|
access: state.access,
|
|
818
870
|
env
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../../src/sandboxes/computer.ts"],
|
|
4
|
-
"sourcesContent": ["import { ProcessInspectionOperation } from '@finalai/agent-protocol/process-inspection';\nimport {\n formatProviderRef,\n NetworkPolicy,\n packageRef,\n SandboxAccess,\n type JsonValue,\n} from '@finalai/agent-provider';\nimport {\n defineSandboxProvider,\n materializeSandboxSeeds,\n PortProtocol,\n SandboxCapability,\n sandboxSeedArtifact,\n sandboxSeedArtifactSchema,\n sandboxSeedFiles,\n sandboxSeedFilesForStart,\n sandboxSeedIdentity,\n SandboxWorkspace,\n type NetworkSandboxSessionIface,\n type SandboxGuidesIface,\n type SandboxPrepareContextIface,\n type SandboxProviderHandleIface,\n type SandboxProviderIface,\n type SandboxProviderImplementationIface,\n type SandboxStartContextIface,\n} from '@finalai/agent-provider/sandbox';\nimport {\n ComputerBaseState,\n ComputerCommandMode,\n ComputerEgressPolicy,\n ComputerIdlePolicy,\n ComputerImageState,\n ComputerState,\n type ComputerBaseIface,\n type ComputerImageIface,\n type ComputerInfoIface,\n} from '@finalai/computers';\nimport * as z from 'zod';\nimport {\n HOME_BASELINE_MISSING_EXIT_CODE,\n HOME_BASELINE_ROOT,\n homeBaselineScript,\n homeContentScript,\n} from \"./build-scripts.mjs\";\nimport { sleep as defaultSleep, sha256Hex } from \"./bytes.mjs\";\nimport { computerEditor } from \"./computer-editor.mjs\";\nimport { readComputerSnapshot } from \"./computer-snapshots.mjs\";\nimport {\n createComputersApiClient,\n createComputersApiCredentials,\n isComputersApiStatus,\n type ComputersApiClientIface,\n type ComputersApiConfigIface,\n type CreateComputerBodyIface,\n} from \"./computers-api.mjs\";\nimport { createComputerUseEndpoint } from \"./computers-api-mcp.mjs\";\nimport { createComputersApiTransport } from \"./computers-api-transport.mjs\";\nimport {\n COMPUTER_SANDBOX_SPECIFIER,\n computerEnvironmentSchema,\n computerOpenOptionsSchema,\n ComputerWorkspacePolicy,\n} from \"./environment.mjs\";\nimport {\n computeComputerArtifactKey,\n computerNeedsBuild,\n DEFAULT_COMPUTER_IMAGE,\n resolveComputerSpec,\n type ResolvedComputerSpecIface,\n} from \"./guide.mjs\";\nimport { createTransportSession, sessionForAccess } from \"./session.mjs\";\nimport type { SandboxTransportIface } from \"./transport.mjs\";\nimport {\n guideCommands,\n installGuideCommands,\n mountRepositories,\n repositoryPath,\n runWorkspaceSetup,\n startServices,\n WORKSPACE_ROOT,\n type GuideCommandIface,\n type SetupLogIface,\n} from \"./workspace-setup.mjs\";\n\nexport type { ComputersApiConfigIface, ComputersApiCredentialIface } from \"./computers-api.mjs\";\nexport {\n COMPUTER_SANDBOX_SPECIFIER,\n COMPUTERS_API_KEY_SECRET,\n COMPUTERS_API_TEAM_SECRET,\n} from \"./environment.mjs\";\nexport { computeComputerArtifactKey } from \"./guide.mjs\";\nexport type { ComputerGuideVersionIface } from \"./guide.mjs\";\nexport type { RepositoryCloneSourceIface } from \"./workspace-setup.mjs\";\n\n// The `computer` sandbox: a Final computer from the\n// public Computers API, set up from a computer setup guide, with lifecycle,\n// files and processes all through that API and the organization's own API key,\n// exactly as a third-party provider drives its vendor. Like every\n// provider, it is served by the session service, which runs this handle and\n// serves the handle RPC and MCP projection from it.\n//\n// A guide with build or verify steps is built once on a builder computer and\n// captured as a base (POST /v1/computers/:id/capture); its computers are created\n// from that base. Network and idle policies are create options, as for any\n// API customer.\n//\n// Guides, variables and repository credentials come from the contract's\n// prepare and start contexts (`guides`, `variables`, `repositories`), which the\n// session service serves to every provider alike.\n\nexport interface ComputerSandboxLogIface {\n (message: string, fields?: Record<string, string | number | boolean | null>): void;\n}\n\nexport interface ComputerSandboxProviderConfigIface {\n // The public Computers API, and each organization's credential for it.\n computersApi: ComputersApiConfigIface;\n // A registry credential (`creg_...`) the organization stored for private image references.\n registryCredentialId?: string;\n // Image for an empty environment without an organization default guide.\n defaultImage?: string;\n regionSlug?: string;\n machine?: { vcpu?: number; memoryMb?: number; diskGb?: number };\n idleTimeoutSeconds?: number;\n // How long `start` waits for a registered image version to finish building.\n imageWaitMs?: number;\n imagePollMs?: number;\n // How long `prepare` waits for a guide's base capture to publish.\n buildWaitMs?: number;\n buildPollMs?: number;\n // How long ending a conversation workspace waits for its computer to shelve.\n shelveWaitMs?: number;\n shelvePollMs?: number;\n log?: ComputerSandboxLogIface;\n randomUuid?: () => string;\n now?: () => number;\n sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;\n}\n\n// An `image` base: `imageVersionId` is the registered version (`cimv_...`) of an\n// image reference, registered at prepare; a `lineage:` image resolves its newest\n// version at start. A `captured` base is a guide's build, captured as a base\n// (`part_...`) that computers are created from.\nconst computerArtifactSchema = sandboxSeedArtifactSchema.extend({\n version: z.literal(1),\n key: z.string(),\n image: z.string(),\n diskGb: z.number().nullable(),\n base: z.discriminatedUnion('kind', [\n z.object({\n kind: z.literal('image'),\n image: z.string(),\n imageVersionId: z.string().nullable().default(null),\n }),\n z.object({ kind: z.literal('captured'), baseId: z.string() }),\n ]),\n});\n\nconst computerStateSchema = z.object({\n version: z.literal(1),\n computerId: z.string(),\n computerName: z.string(),\n workspace: z.nativeEnum(ComputerWorkspacePolicy),\n access: z.nativeEnum(SandboxAccess),\n guideVersionId: z.string().nullable(),\n setupHash: z.string().nullable(),\n});\n\n// The provider's own view of a computer while it sets it up.\ninterface SetupSessionIface {\n sandbox: NetworkSandboxSessionIface;\n transport: SandboxTransportIface;\n}\n\nexport type ComputerSandboxArtifact = z.infer<typeof computerArtifactSchema>;\nexport type ComputerSandboxState = z.infer<typeof computerStateSchema>;\n\n// What Build needs to know about a started computer beyond the handle.\nexport interface ComputerSandboxDescriptionIface {\n provider: 'computer';\n computerId: string;\n computerName: string;\n workspaceRoot: string;\n transport: string;\n guide: { slug: string; number: number } | null;\n repositories: { alias: string; path: string; repository: string }[];\n services: { name: string; readyUrl: string | null }[];\n commands: GuideCommandIface[];\n capabilities: SandboxCapability[];\n}\n\nexport interface ComputerSandboxSessionIface extends NetworkSandboxSessionIface {\n describe(): ComputerSandboxDescriptionIface;\n // What this computer's handle offers (the session service reports it).\n readonly capabilities: readonly SandboxCapability[];\n}\n\nexport type ComputerSandboxProviderIface = SandboxProviderIface<\n JsonValue,\n JsonValue,\n ComputerSandboxArtifact,\n ComputerSandboxState,\n ComputerSandboxSessionIface\n>;\n\nexport interface ComputerSandboxErrorIface extends Error {\n code:\n | 'artifact_unavailable'\n | 'computer_gone'\n | 'computer_not_running'\n | 'invalid_environment'\n | 'build_failed';\n}\n\nconst computerSandboxError = (\n code: ComputerSandboxErrorIface['code'],\n message: string,\n): ComputerSandboxErrorIface =>\n Object.assign(new Error(message), { name: 'ComputerSandboxError', code });\n\n// FINAL_NODE_* and the session basics belong to the platform (shared/src/sandbox-templates/reserved.ts).\nconst RESERVED_ENV = new Set([\n 'DISPLAY',\n 'XDG_RUNTIME_DIR',\n 'PATH',\n 'HOME',\n 'USER',\n 'SHELL',\n 'HOSTNAME',\n]);\nconst isReservedEnvName = (name: string): boolean =>\n name.startsWith('FINAL_NODE_') || RESERVED_ENV.has(name);\n\nconst HTTP_TOKEN_LIFETIME_MS = 60 * 60_000;\nconst HTTP_TOKEN_RENEW_MS = 5 * 60_000;\n\n// Builds run from here; the capture scrub removes /tmp/*.\nconst BUILD_ROOT = '/tmp/final-build';\n// Guide publication supplies build inputs in files; agent revisions supply workspace seeds.\nconst seedsFor = (ctx: SandboxPrepareContextIface): Record<string, string> =>\n sandboxSeedFiles({\n files: ctx.resources.guide == null ? ctx.files : {},\n resources: ctx.resources,\n });\n// What the Computers API's capture scrub removes, so the home check skips it.\nconst CAPTURE_SCRUBBED_PATHS = [\n '/home/user/.bash_history',\n '/home/user/.zsh_history',\n '/home/user/.sh_history',\n '/home/user/.git-credentials',\n '/home/user/.config/gh/hosts.yml',\n '/home/user/.npmrc',\n '/home/user/.pypirc',\n '/home/user/.cargo/credentials',\n '/home/user/.cargo/credentials.toml',\n '/home/user/.aws',\n '/home/user/.config/gcloud',\n '/home/user/.azure',\n '/home/user/.docker/config.json',\n '/home/user/.netrc',\n '/home/user/.ssh',\n];\nconst BUILDER_IDLE_TIMEOUT_SECONDS = 2 * 60 * 60;\n\ninterface ComputerEgressConfigIface {\n egress: ComputerEgressPolicy;\n allow?: string[];\n}\n\nconst egressFor = (spec: ResolvedComputerSpecIface): ComputerEgressConfigIface => {\n const policy = spec.parameters.networkPolicy;\n if (policy.mode === NetworkPolicy.AllowAll) return { egress: ComputerEgressPolicy.Internet };\n if (policy.mode === NetworkPolicy.DenyAll) return { egress: ComputerEgressPolicy.None };\n return { egress: ComputerEgressPolicy.Allowlist, allow: policy.allow };\n};\n\nconst LINEAGE_PREFIX = 'lineage:';\n\nconst portOf = (url: string): number | null => {\n try {\n const parsed = new URL(url);\n if (parsed.port !== '') return Number(parsed.port);\n return parsed.protocol === 'https:' ? 443 : 80;\n } catch {\n return null;\n }\n};\n\nconst compactId = (id: string): string => id.replaceAll('-', '');\n\nconst sandboxWorkspaceOf = {\n [ComputerWorkspacePolicy.Session]: SandboxWorkspace.Session,\n [ComputerWorkspacePolicy.Conversation]: SandboxWorkspace.Conversation,\n [ComputerWorkspacePolicy.Ephemeral]: SandboxWorkspace.Ephemeral,\n} satisfies Record<ComputerWorkspacePolicy, SandboxWorkspace>;\n\nconst isRunningState = (state: ComputerState): boolean =>\n state === ComputerState.Running ||\n state === ComputerState.Paused ||\n state === ComputerState.Resuming;\n\nexport const createComputerSandboxProvider = (\n config: ComputerSandboxProviderConfigIface,\n): ComputerSandboxProviderIface => {\n const log: SetupLogIface = config.log ?? (() => undefined);\n const randomUuid = config.randomUuid ?? (() => crypto.randomUUID());\n const now = config.now ?? (() => Date.now());\n const sleep = config.sleep ?? defaultSleep;\n const defaultImage = config.defaultImage ?? DEFAULT_COMPUTER_IMAGE;\n const credentials = createComputersApiCredentials(config.computersApi, now);\n\n const clientFor = (organizationId: string): ComputersApiClientIface =>\n createComputersApiClient({ config: config.computersApi, credentials, organizationId });\n\n const registerImage = (client: ComputersApiClientIface, reference: string) =>\n client.registerImage(\n config.registryCredentialId == null\n ? { reference }\n : { reference, registryCredentialId: config.registryCredentialId },\n );\n\n // Computers are created from registered image versions, as any API customer's are.\n // A `lineage:` image is the newest ready version of that lineage (the\n // organization's or the platform's); a reference is registered once, at prepare,\n // and registered again here when its version expired.\n const readyImageVersion = async (\n client: ComputersApiClientIface,\n base: { image: string; imageVersionId: string | null },\n ): Promise<string> => {\n if (base.image.startsWith(LINEAGE_PREFIX)) {\n const lineage = base.image.slice(LINEAGE_PREFIX.length);\n const [newest] = await client.listImages({ lineage, state: ComputerImageState.Ready });\n if (newest == null) {\n throw computerSandboxError(\n 'artifact_unavailable',\n `the Computers API has no ready image version in lineage ${lineage}`,\n );\n }\n return newest.id;\n }\n let version: ComputerImageIface | null = null;\n if (base.imageVersionId != null) {\n try {\n version = await client.getImage(base.imageVersionId);\n } catch (error) {\n if (!isComputersApiStatus(error, 404)) throw error;\n }\n }\n if (version == null || version.state === ComputerImageState.Expired) {\n version = await registerImage(client, base.image);\n }\n const deadline = now() + (config.imageWaitMs ?? 15 * 60_000);\n while (\n version.state === ComputerImageState.Pending ||\n version.state === ComputerImageState.Building\n ) {\n if (now() >= deadline) throw new Error(`image ${base.image} is still building`);\n await sleep(config.imagePollMs ?? 5_000);\n version = await client.getImage(version.id);\n }\n if (version.state !== ComputerImageState.Ready) {\n throw computerSandboxError(\n 'artifact_unavailable',\n `image ${base.image} is ${version.state}${version.error == null ? '' : `: ${version.error}`}`,\n );\n }\n return version.id;\n };\n\n const loadVariables = async (\n ctx: SandboxStartContextIface,\n spec: ResolvedComputerSpecIface,\n ): Promise<Record<string, string>> => {\n const env: Record<string, string> = {};\n for (const [name, value] of Object.entries(spec.parameters.env)) {\n if (isReservedEnvName(name))\n throw computerSandboxError('invalid_environment', `${name} is reserved`);\n env[name] = value;\n }\n for (const name of spec.parameters.variables) {\n if (isReservedEnvName(name))\n throw computerSandboxError('invalid_environment', `${name} is reserved`);\n const value = await ctx.variables.get(name);\n if (value == null)\n throw computerSandboxError('invalid_environment', `variable ${name} is not set`);\n env[name] = value;\n }\n return env;\n };\n\n const mcpClosers = new Map<string, Set<() => Promise<void>>>();\n const closeComputerMcp = async (computerId: string) => {\n const results = await Promise.allSettled(\n [...(mcpClosers.get(computerId) ?? [])].map((close) => close()),\n );\n for (const result of results) if (result.status === 'rejected') throw result.reason;\n };\n const buildHandle = async (args: {\n ctx: SandboxStartContextIface;\n client: ComputersApiClientIface;\n info: ComputerInfoIface;\n spec: ResolvedComputerSpecIface;\n access: SandboxAccess;\n env: Record<string, string>;\n }): Promise<{ handle: SandboxProviderHandleIface<ComputerSandboxSessionIface> }> => {\n const { client, info, spec } = args;\n const commands = await guideCommands(spec.template);\n const commandHelp = commands\n .map(\n (command) =>\n `Guide command ${command.name}: bash ${command.path}${command.description == null ? '' : ` \u2014 ${command.description}`}`,\n )\n .join('\\n');\n const transport = createComputersApiTransport({ client, computerId: info.id });\n const ports = [\n ...new Set(\n spec.template.services.flatMap((service) => {\n const port = service.ready == null ? null : portOf(service.ready.url);\n return port == null ? [] : [port];\n }),\n ),\n ];\n let httpToken: { token: string; expiresAtMs: number } | null = null;\n const session = createTransportSession({\n id: info.id,\n description: `Final computer ${info.name}${spec.guide == null ? '' : ` (${spec.guide.title} v${spec.guide.number})`}${commands.length === 0 ? '' : `\\n${commandHelp}`}`,\n workspaceRoot: WORKSPACE_ROOT,\n transport,\n baseEnv: () => args.env,\n randomUuid,\n network: {\n ports,\n // The computer's hostname with a preview token, which opens its HTTP ports only.\n getPortEndpoint: async ({ port, protocol }) => {\n const hostname = info.hostname ?? (await client.getComputer(info.id))?.hostname ?? null;\n if (hostname == null) throw new Error(`computer ${info.name} has no public hostname`);\n if (httpToken == null || httpToken.expiresAtMs - now() < HTTP_TOKEN_RENEW_MS) {\n const expiresAtMs = now() + HTTP_TOKEN_LIFETIME_MS;\n const token = await client.createPreviewToken({\n computerId: info.id,\n name: `agent sandbox ${args.ctx.session.bindingId}`,\n expiresAt: new Date(expiresAtMs),\n });\n httpToken = { token, expiresAtMs };\n }\n const scheme = protocol === PortProtocol.Ws ? 'wss' : 'https';\n return {\n url: `${scheme}://${port === 443 ? hostname : `${hostname}:${port}`}`,\n headers: { authorization: `Bearer ${httpToken.token}` },\n };\n },\n stop: async () => {\n await closeComputerMcp(info.id);\n await client.action(info.id, 'stop');\n },\n destroy: async () => {\n await closeComputerMcp(info.id);\n transport.close();\n try {\n await client.action(info.id, 'delete');\n } catch (error) {\n if (!isComputersApiStatus(error, 404)) throw error;\n }\n },\n },\n });\n let computerUseInstalled: boolean | null = null;\n if (args.access !== SandboxAccess.Read) {\n try {\n computerUseInstalled = (await client.computerUseStatus(info.id, AbortSignal.timeout(1000)))\n .installed;\n } catch {\n /* Optional discovery must never fail the sandbox. */\n }\n }\n const computerUse =\n args.access === SandboxAccess.Read || computerUseInstalled === false\n ? null\n : createComputerUseEndpoint({ client, computerId: info.id, cwd: WORKSPACE_ROOT });\n const closeMcp = async () => {\n try {\n await computerUse?.close();\n } catch (error) {\n log('computer_use.close_failed', {\n computerId: info.id,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n const closers = mcpClosers.get(info.id);\n closers?.delete(closeMcp);\n if (closers?.size === 0) mcpClosers.delete(info.id);\n };\n if (computerUse != null) {\n const closers = mcpClosers.get(info.id) ?? new Set<() => Promise<void>>();\n closers.add(closeMcp);\n mcpClosers.set(info.id, closers);\n }\n const capabilities = [SandboxCapability.Files, SandboxCapability.Ports];\n let screenAvailable = false;\n try {\n screenAvailable = (await client.screenStatus(info.id, AbortSignal.timeout(1000))).available;\n } catch {\n /* Optional desktop discovery leaves headless computers usable. */\n }\n if (screenAvailable) capabilities.push(SandboxCapability.Screen);\n if (computerUse != null) capabilities.push(SandboxCapability.ComputerUse);\n if (args.access !== SandboxAccess.Read)\n capabilities.push(SandboxCapability.Process, SandboxCapability.NetworkPolicy);\n const description: ComputerSandboxDescriptionIface = {\n provider: 'computer',\n computerId: info.id,\n computerName: info.name,\n workspaceRoot: WORKSPACE_ROOT,\n transport: transport.kind,\n guide: spec.guide == null ? null : { slug: spec.guide.slug, number: spec.guide.number },\n repositories: spec.parameters.repositories.map((repository) => ({\n alias: repository.alias,\n path: repositoryPath(repository.alias),\n repository: repository.repository,\n })),\n services: spec.template.services.map((service) => ({\n name: service.name,\n readyUrl: service.ready?.url ?? null,\n })),\n commands,\n capabilities,\n };\n const full: ComputerSandboxSessionIface = {\n ...session,\n setNetworkPolicy: async (policy) => {\n if (args.access === SandboxAccess.Read)\n throw new Error('this sandbox binding is read-only');\n const network =\n policy.mode === NetworkPolicy.AllowAll\n ? { egress: ComputerEgressPolicy.Internet }\n : policy.mode === NetworkPolicy.DenyAll\n ? { egress: ComputerEgressPolicy.None }\n : { egress: ComputerEgressPolicy.Allowlist, allow: policy.allow ?? [] };\n await client.setNetworkPolicy(info.id, network);\n },\n describe: () => description,\n capabilities,\n };\n if (computerUse != null) full.computerUse = async () => computerUse.endpoint;\n if (screenAvailable) {\n full.screen = (options) => client.openScreen(info.id, options);\n }\n const sandbox = sessionForAccess(full, args.access);\n return {\n handle: {\n sandbox,\n onSandboxStop: async () => {\n try {\n await closeMcp();\n } finally {\n transport.close();\n }\n },\n onSandboxDelete: async () => {\n try {\n await closeMcp();\n } finally {\n transport.close();\n }\n try {\n await client.action(info.id, 'delete');\n } catch (error) {\n if (!isComputersApiStatus(error, 404)) throw error;\n }\n },\n onRuntimeShutdown: async () => {\n try {\n await closeMcp();\n } finally {\n transport.close();\n }\n },\n },\n };\n };\n\n // Setup (repositories, workspace.setup, services) is the provider's own work, so it\n // runs with the organization's credential, never through the binding's lease: a\n // read binding still gets a set-up computer.\n const setupSession = (args: {\n client: ComputersApiClientIface;\n info: ComputerInfoIface;\n env: Record<string, string>;\n }): SetupSessionIface => {\n const transport = createComputersApiTransport({\n client: args.client,\n computerId: args.info.id,\n });\n const sandbox = createTransportSession({\n id: args.info.id,\n description: `setup of ${args.info.name}`,\n workspaceRoot: WORKSPACE_ROOT,\n transport,\n baseEnv: () => args.env,\n randomUuid,\n network: {\n ports: [],\n getPortEndpoint: async () => {\n throw new Error('setup sessions expose no ports');\n },\n stop: async () => undefined,\n destroy: async () => undefined,\n },\n });\n return { sandbox, transport };\n };\n\n // A captured base, once it is ready; a failed or expired one must be built again.\n const awaitBase = async (\n client: ComputersApiClientIface,\n baseId: string,\n key: string,\n ): Promise<ComputerBaseIface> => {\n const deadline = now() + (config.buildWaitMs ?? 30 * 60_000);\n for (;;) {\n const base = await client.getBase(baseId);\n if (base == null || base.state === ComputerBaseState.Expired) {\n throw computerSandboxError(\n 'artifact_unavailable',\n `computer base ${key} (${baseId}) is ${base == null ? 'gone' : 'expired'}; prepare it again`,\n );\n }\n if (base.state === ComputerBaseState.Ready) return base;\n if (base.state === ComputerBaseState.Failed) {\n throw computerSandboxError(\n 'build_failed',\n `computer base ${key} failed to capture: ${base.error ?? 'unknown error'}`,\n );\n }\n if (now() >= deadline) throw new Error(`computer base ${key} is still capturing`);\n await sleep(config.buildPollMs ?? 5_000);\n }\n };\n\n const awaitShelved = async (client: ComputersApiClientIface, computerId: string) => {\n const deadline = now() + (config.shelveWaitMs ?? 5 * 60_000);\n for (;;) {\n const computer = await client.getComputer(computerId);\n if (\n computer == null ||\n computer.state === ComputerState.Shelved ||\n computer.state === ComputerState.Deleted\n )\n return;\n if (computer.state === ComputerState.Error)\n throw computerSandboxError('computer_gone', `computer ${computerId} failed to shelve`);\n if (now() >= deadline) throw new Error(`computer ${computerId} is still shelving`);\n await sleep(config.shelvePollMs ?? 2_000);\n }\n };\n\n // Run build.steps, then build.verify, on a builder computer of the guide's\n // image, captured as a base its computers are created from.\n const build = async (\n ctx: SandboxPrepareContextIface,\n spec: ResolvedComputerSpecIface,\n key: string,\n ): Promise<ComputerSandboxArtifact> => {\n const client = clientFor(ctx.organizationId);\n const diskGb = config.machine?.diskGb ?? null;\n const imageVersionId = await readyImageVersion(client, {\n image: spec.image,\n imageVersionId: null,\n });\n const body: CreateComputerBodyIface = {\n name: `ag-${key.slice(4, 20)}-${compactId(randomUuid()).slice(0, 8)}`,\n imageVersionId,\n ...config.machine,\n // The base is the root disk; a user volume would keep /home and /workspaces off it.\n userVolumeGb: null,\n // Nothing secret at create: the create env lands in the guest.\n env: {},\n commandMode: ComputerCommandMode.Custom,\n customCommand: 'sleep infinity',\n autoResume: false,\n idleTimeoutSeconds: BUILDER_IDLE_TIMEOUT_SECONDS,\n tags: ['final-agent-sandbox-build'],\n };\n if (config.regionSlug != null) body.regionSlug = config.regionSlug;\n // One builder per attempt: a retry after a failed build starts clean.\n const builder = await client.createComputer(\n body,\n `agent-guide-build-${(await sha256Hex(`${key}:${randomUuid()}`)).slice(0, 32)}`,\n );\n ctx.log?.(`building computer base ${key} on ${builder.name}`);\n try {\n const sandbox = setupSession({ client, info: builder, env: {} }).sandbox;\n const prepared = await sandbox.run({\n command: '/bin/sh',\n args: ['-c', `mkdir -p ${BUILD_ROOT}\\n${homeBaselineScript()}`],\n cwd: '/',\n });\n if (prepared.exitCode !== 0) {\n throw computerSandboxError('build_failed', 'failed to record the pre-build home baseline');\n }\n const steps = [\n ...spec.template.build.steps.map((step) => ({ step, label: 'build step' })),\n ...spec.template.build.verify.map((step) => ({ step, label: 'verify step' })),\n ];\n for (const [index, { step, label }] of steps.entries()) {\n ctx.log?.(`${label} ${index + 1}/${steps.length}`);\n const result = await sandbox.run({\n command: `set -eu\\n${step.run}`,\n shell: true,\n cwd: BUILD_ROOT,\n timeoutMs: step.timeoutMinutes * 60_000,\n });\n if (result.exitCode !== 0) {\n throw computerSandboxError(\n 'build_failed',\n `${label} ${index + 1} failed (exit ${result.exitCode}): ${result.stderr.trim().slice(-2000)}`,\n );\n }\n }\n const homeContent = await sandbox.run({\n command: '/bin/sh',\n args: ['-c', homeContentScript({ excludedPaths: CAPTURE_SCRUBBED_PATHS })],\n cwd: '/',\n });\n if (homeContent.exitCode === HOME_BASELINE_MISSING_EXIT_CODE) {\n throw computerSandboxError(\n 'build_failed',\n `build steps removed ${HOME_BASELINE_ROOT}, which the home content check needs; leave /var/tmp/final-template-build in place.`,\n );\n }\n if (homeContent.exitCode !== 0) {\n const offending = homeContent.stdout\n .trim()\n .split('\\n')\n .filter((line) => line !== '');\n throw computerSandboxError(\n 'build_failed',\n `build steps left content under /home or /workspaces, which each computer's own volume hides: ${offending.join(', ')}. Install tools and configuration to system paths such as /usr/local, or point the tool's home there (for example CARGO_HOME=/usr/local/cargo, RUSTUP_HOME=/usr/local/rustup, NVM_DIR=/usr/local/nvm), put home files in /usr/share/final-vm/home-skel, and use /etc/gitconfig instead of git config --global.`,\n );\n }\n const captured = await client.captureComputer(builder.id, { retained: true });\n if (!captured.retained)\n throw computerSandboxError(\n 'build_failed',\n 'the Computers API did not retain the built base',\n );\n ctx.log?.(`capturing computer base ${key} as ${captured.id}`);\n const base = await awaitBase(client, captured.id, key);\n return {\n version: 1,\n key,\n image: spec.image,\n diskGb: diskGb ?? base.diskGb,\n seedFiles: {},\n base: { kind: 'captured', baseId: base.id },\n };\n } finally {\n // The capture stopped the builder; it is not part of the base.\n try {\n await client.action(builder.id, 'delete');\n } catch (error) {\n log('computer_sandbox.builder_delete_failed', {\n computerId: builder.id,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n }\n };\n\n const environment = (\n rawOptions?: JsonValue,\n ): SandboxProviderImplementationIface<\n JsonValue,\n ComputerSandboxArtifact,\n ComputerSandboxState,\n ComputerSandboxSessionIface\n > => {\n const parsed = computerEnvironmentSchema.safeParse(rawOptions ?? {});\n if (!parsed.success) {\n throw computerSandboxError(\n 'invalid_environment',\n `invalid computer environment: ${parsed.error.message}`,\n );\n }\n const options = parsed.data;\n const resolve = (guides: SandboxGuidesIface): Promise<ResolvedComputerSpecIface> =>\n resolveComputerSpec({ options, guides, defaultImage });\n const keyFor = async (\n spec: ResolvedComputerSpecIface,\n files: Record<string, string>,\n ): Promise<string> => {\n const baseKey = await computeComputerArtifactKey({\n image: spec.image,\n template: spec.template,\n diskGb: config.machine?.diskGb ?? null,\n });\n return Object.keys(files).length === 0\n ? baseKey\n : `${baseKey}-s${await sha256Hex(sandboxSeedIdentity(files))}`;\n };\n\n const startServicesFor = async (args: {\n setup: SetupSessionIface;\n spec: ResolvedComputerSpecIface;\n env: Record<string, string>;\n }): Promise<void> => {\n await startServices({\n sandbox: args.setup.sandbox,\n transport: args.setup.transport,\n template: args.spec.template,\n env: args.env,\n randomUuid,\n log,\n });\n };\n\n return {\n processes: async (ctx, rawState, request) => {\n const state = computerStateSchema.parse(rawState);\n if (\n request.operation === ProcessInspectionOperation.Stop &&\n state.access === SandboxAccess.Read\n )\n throw new Error('stopping processes requires execute access');\n const result = await clientFor(ctx.organizationId).inspectProcesses(\n state.computerId,\n request,\n );\n return request.operation === ProcessInspectionOperation.Available && 'available' in result\n ? { ...result, canStop: state.access !== SandboxAccess.Read }\n : result;\n },\n editor: async (_ctx, rawState, request) => {\n const state = computerStateSchema.parse(rawState);\n if (state.access !== SandboxAccess.Write) {\n if (request.operation === 'available') return { available: false };\n throw new Error('editor requires write access');\n }\n return computerEditor({\n client: clientFor(_ctx.organizationId),\n computerId: state.computerId,\n request,\n randomUuid,\n });\n },\n readSnapshot: async (ctx, rawState, request) => {\n const state = computerStateSchema.parse(rawState);\n return readComputerSnapshot({\n client: clientFor(ctx.organizationId),\n computerId: state.computerId,\n request,\n });\n },\n // The merged parameters' workspace: the binding's, else the saved version's default.\n workspace: async (ctx) =>\n sandboxWorkspaceOf[(await resolve(ctx.guides)).parameters.workspace],\n artifactKey: async (ctx) => keyFor(await resolve(ctx.guides), seedsFor(ctx)),\n // Registers an image reference so its version builds ahead of the first start;\n // a lineage needs nothing until then.\n prepare: async (ctx) => {\n const spec = await resolve(ctx.guides);\n const seedFiles = seedsFor(ctx);\n const key = await keyFor(spec, seedFiles);\n const seedArtifact = await sandboxSeedArtifact(ctx, seedFiles);\n if (computerNeedsBuild(spec)) {\n const baseKey = await keyFor(spec, {});\n const prepared = spec.guide?.preparedArtifact;\n if (\n prepared?.key === baseKey &&\n prepared.providerRef === formatProviderRef(packageRef(COMPUTER_SANDBOX_SPECIFIER))\n ) {\n const cached = computerArtifactSchema.safeParse(prepared.artifact);\n if (\n cached.success &&\n cached.data.key === baseKey &&\n cached.data.base.kind === 'captured'\n ) {\n const base = await clientFor(ctx.organizationId).getBase(cached.data.base.baseId);\n if (base?.state === ComputerBaseState.Ready) {\n if (!base.retained) {\n const retained = await clientFor(ctx.organizationId).setBaseRetention(\n base.id,\n true,\n );\n if (!retained.retained)\n throw computerSandboxError(\n 'build_failed',\n 'the Computers API did not retain the prepared base',\n );\n }\n return { ...cached.data, key, ...seedArtifact };\n }\n }\n }\n const cached = computerArtifactSchema.safeParse(await ctx.artifacts?.get(baseKey));\n if (\n cached.success &&\n cached.data.key === baseKey &&\n cached.data.base.kind === 'captured'\n ) {\n const base = await clientFor(ctx.organizationId).getBase(cached.data.base.baseId);\n if (base?.state === ComputerBaseState.Ready) {\n if (!base.retained) {\n const retained = await clientFor(ctx.organizationId).setBaseRetention(\n base.id,\n true,\n );\n if (!retained.retained)\n throw computerSandboxError(\n 'build_failed',\n 'the Computers API did not retain the prepared base',\n );\n }\n return { ...cached.data, key, ...seedArtifact };\n }\n }\n const built = await build(ctx, spec, baseKey);\n await ctx.artifacts?.put(baseKey, built);\n return { ...built, key, ...seedArtifact };\n }\n const imageVersionId = spec.image.startsWith(LINEAGE_PREFIX)\n ? null\n : (await registerImage(clientFor(ctx.organizationId), spec.image)).id;\n ctx.log?.(`computer base ${key} is image ${spec.image}`);\n return {\n version: 1,\n key,\n image: spec.image,\n diskGb: config.machine?.diskGb ?? null,\n ...seedArtifact,\n base: { kind: 'image', image: spec.image, imageVersionId },\n };\n },\n start: async (ctx, openOptions, rawArtifact) => {\n const access = computerOpenOptionsSchema.parse(openOptions ?? {}).access;\n const spec = await resolve(ctx.guides);\n const egress = egressFor(spec);\n const artifact = computerArtifactSchema.safeParse(rawArtifact);\n if (!artifact.success) {\n throw computerSandboxError(\n 'artifact_unavailable',\n 'this computer base predates the public Computers API provider; prepare it again',\n );\n }\n const base = artifact.data.base;\n if (computerNeedsBuild(spec) && base.kind !== 'captured') {\n throw computerSandboxError(\n 'artifact_unavailable',\n `computer base ${artifact.data.key} was prepared without its build steps; prepare it again`,\n );\n }\n // Variables resolve before anything is created, so a missing one costs nothing.\n const env = await loadVariables(ctx, spec);\n const client = clientFor(ctx.session.organizationId);\n const workspace = spec.parameters.workspace;\n const name =\n workspace === ComputerWorkspacePolicy.Conversation && ctx.session.conversationId != null\n ? `ac-${(await sha256Hex(`${ctx.session.conversationId}:${ctx.session.target}`)).slice(0, 24)}`\n : `ab-${compactId(ctx.session.bindingId)}`;\n const existing = await client.getComputer(name);\n if (existing?.state === ComputerState.Error)\n throw computerSandboxError(\n 'computer_gone',\n `Computer ${existing.id} (${name}) is in the Error state. Recover it through the Computers API before retrying; its workspace is preserved.`,\n );\n let info: ComputerInfoIface;\n let fresh = true;\n if (existing != null && existing.state !== ComputerState.Deleted) {\n info = existing;\n fresh = !isRunningState(existing.state);\n if (existing.state === ComputerState.Paused) await client.action(existing.id, 'resume');\n else if (fresh) await client.action(existing.id, 'start');\n } else {\n const source: Pick<CreateComputerBodyIface, 'baseId' | 'imageVersionId'> =\n base.kind === 'captured'\n ? { baseId: (await awaitBase(client, base.baseId, artifact.data.key)).id }\n : { imageVersionId: await readyImageVersion(client, base) };\n const body: CreateComputerBodyIface = {\n name,\n ...source,\n ...config.machine,\n env: {},\n autoResume: true,\n idleTimeoutSeconds: config.idleTimeoutSeconds ?? 15 * 60,\n // Provider teardown owns deletion; VM-level ephemeral disks cannot be paused.\n ephemeral: false,\n network: egress,\n tags: [\n 'final-agent-sandbox',\n `agent-binding:${ctx.session.bindingId}`,\n 'agent-runtime-attachment:v1',\n 'agent-runtime-role:sandbox',\n ],\n };\n // Session teardown owns deletion, including ephemeral computers. Idle must preserve files.\n body.idlePolicy = ComputerIdlePolicy.Pause;\n if (config.regionSlug != null) body.regionSlug = config.regionSlug;\n // Keyed by the source too: a retry after re-registering is a different request.\n const idempotencyKey = `agent-sandbox-${(await sha256Hex(`${ctx.session.bindingId}:${name}:${source.baseId ?? source.imageVersionId}`)).slice(0, 32)}`;\n info = await client.createComputer(body, idempotencyKey);\n }\n log('computer_sandbox.started', { computerId: info.id, reused: existing != null });\n try {\n const setup = setupSession({ client, info, env });\n await mountRepositories({\n sandbox: setup.sandbox,\n repositories: spec.parameters.repositories,\n resolver: ctx.repositories,\n log,\n });\n await materializeSandboxSeeds({\n sandbox: setup.sandbox,\n root: WORKSPACE_ROOT,\n files: await sandboxSeedFilesForStart(ctx, artifact.data),\n });\n await installGuideCommands({ sandbox: setup.sandbox, template: spec.template });\n const setupHash = await runWorkspaceSetup({\n sandbox: setup.sandbox,\n template: spec.template,\n repositories: spec.parameters.repositories,\n log,\n });\n if (fresh) await startServicesFor({ setup, spec, env });\n const { handle } = await buildHandle({ ctx, client, info, spec, access, env });\n return {\n handle,\n region: info.regionSlug ?? config.regionSlug ?? null,\n state: {\n version: 1,\n computerId: info.id,\n computerName: info.name,\n workspace,\n access,\n guideVersionId: spec.guide?.versionId ?? null,\n setupHash,\n },\n };\n } catch (error) {\n // No state reaches the caller on failure; clean up only this start's new computer.\n if (existing == null || existing.id !== info.id) {\n try {\n await client.action(info.id, 'delete');\n } catch (cleanupError) {\n throw new AggregateError(\n [error, cleanupError],\n `computer ${info.name} setup and cleanup failed`,\n );\n }\n }\n throw error;\n }\n },\n resumePassive: async (ctx, _artifact, rawState) => {\n const state = computerStateSchema.parse(rawState);\n const client = clientFor(ctx.session.organizationId);\n const info = await client.getComputer(state.computerId);\n if (info == null || info.state !== ComputerState.Running)\n throw computerSandboxError(\n 'computer_not_running',\n 'computer is not running for passive access',\n );\n const spec = await resolve(ctx.guides);\n const env = await loadVariables(ctx, spec);\n return (await buildHandle({ ctx, client, info, spec, access: state.access, env })).handle;\n },\n resume: async (ctx, _artifact, rawState) => {\n const state = computerStateSchema.parse(rawState);\n const client = clientFor(ctx.session.organizationId);\n const info = await client.getComputer(state.computerId);\n if (\n info == null ||\n info.state === ComputerState.Deleted ||\n info.state === ComputerState.Error\n ) {\n throw computerSandboxError('computer_gone', `computer ${state.computerName} is gone`);\n }\n // Computers pause when idle, so a resume usually continues in place; one the\n // platform stopped or shelved meanwhile boots again.\n const rebooted = !isRunningState(info.state);\n if (info.state === ComputerState.Paused) await client.action(info.id, 'resume');\n else if (rebooted) await client.action(info.id, 'start');\n const spec = await resolve(ctx.guides);\n const env = await loadVariables(ctx, spec);\n const setup = setupSession({ client, info, env });\n await installGuideCommands({ sandbox: setup.sandbox, template: spec.template });\n // Processes survive a pause; a stopped or shelved computer booted again.\n if (rebooted) await startServicesFor({ setup, spec, env });\n const { handle } = await buildHandle({\n ctx,\n client,\n info,\n spec,\n access: state.access,\n env,\n });\n return handle;\n },\n park: async (ctx, _artifact, rawState) => {\n const state = computerStateSchema.parse(rawState);\n await closeComputerMcp(state.computerId);\n try {\n await clientFor(ctx.session.organizationId).action(state.computerId, 'pause');\n } catch (error) {\n // Already paused or stopped: nothing to do.\n if (!isComputersApiStatus(error, 409)) throw error;\n }\n return state;\n },\n onSessionEnd: async (ctx, _artifact, rawState, { reason }) => {\n const state = computerStateSchema.parse(rawState);\n const client = clientFor(ctx.session.organizationId);\n // A conversation workspace outlives its binding (the conversation was\n // archived, or its workspace replaced): it is shelved, its disk backed up\n // to storage with no host held, and the next binding for the\n // conversation starts it again by name. Session and ephemeral disks end\n // with their binding.\n const action = state.workspace === ComputerWorkspacePolicy.Conversation ? 'stop' : 'delete';\n log('computer_sandbox.session_end', { computerId: state.computerId, reason, action });\n try {\n await client.action(state.computerId, action);\n } catch (error) {\n if (isComputersApiStatus(error, 404)) return;\n if (!isComputersApiStatus(error, 409)) throw error;\n // A conflict is done only when the computer is already where the action\n // takes it; one mid-transition (an idle pause committing) is retried.\n const current = await client.getComputer(state.computerId);\n const settled =\n current == null ||\n current.state === ComputerState.Deleted ||\n (action === 'stop' && current.state === ComputerState.Shelved);\n if (!settled) throw error;\n return;\n }\n // `stop` returns once the shelve is scheduled: the cleanup (and the\n // session service's fence on reusing the workspace) lasts until it is.\n if (action === 'stop') await awaitShelved(client, state.computerId);\n },\n };\n };\n\n return defineSandboxProvider({\n name: 'computer',\n stateProtocolVersion: 1,\n environment,\n });\n};\n"],
|
|
5
|
-
"mappings": "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",
|
|
6
|
-
"names": ["COMPUTER_SANDBOX_SPECIFIER", "computeComputerArtifactKey", "cached"]
|
|
4
|
+
"sourcesContent": ["import { ProcessInspectionOperation } from '@finalai/agent-protocol/process-inspection';\nimport {\n formatProviderRef,\n NetworkPolicy,\n packageRef,\n SandboxAccess,\n type JsonValue,\n} from '@finalai/agent-provider';\nimport {\n defineSandboxProvider,\n materializeSandboxSeeds,\n PLATFORM_ENVIRONMENT_NAMES,\n platformProcessEnvironment,\n PortProtocol,\n reportPlatformNetworkPolicy,\n SandboxCapability,\n sandboxSeedArtifact,\n sandboxSeedArtifactSchema,\n sandboxSeedFiles,\n sandboxSeedFilesForStart,\n sandboxSeedIdentity,\n SandboxWorkspace,\n withPlatformEgressHosts,\n writePlatformFiles,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxGuidesIface,\n type SandboxPrepareContextIface,\n type SandboxProviderHandleIface,\n type SandboxProviderIface,\n type SandboxProviderImplementationIface,\n type SandboxStartContextIface,\n} from '@finalai/agent-provider/sandbox';\nimport {\n ComputerBaseState,\n ComputerCommandMode,\n ComputerEgressPolicy,\n ComputerIdlePolicy,\n ComputerImageState,\n ComputerState,\n type ComputerBaseIface,\n type ComputerImageIface,\n type ComputerInfoIface,\n} from '@finalai/computers';\nimport * as z from 'zod';\nimport {\n HOME_BASELINE_MISSING_EXIT_CODE,\n HOME_BASELINE_ROOT,\n homeBaselineScript,\n homeContentScript,\n} from \"./build-scripts.mjs\";\nimport { sleep as defaultSleep, sha256Hex } from \"./bytes.mjs\";\nimport { computerEditor } from \"./computer-editor.mjs\";\nimport { readComputerSnapshot } from \"./computer-snapshots.mjs\";\nimport {\n createComputersApiClient,\n createComputersApiCredentials,\n isComputersApiStatus,\n type ComputersApiClientIface,\n type ComputersApiConfigIface,\n type CreateComputerBodyIface,\n} from \"./computers-api.mjs\";\nimport { createComputerUseEndpoint } from \"./computers-api-mcp.mjs\";\nimport { createComputersApiTransport } from \"./computers-api-transport.mjs\";\nimport {\n COMPUTER_SANDBOX_SPECIFIER,\n computerEnvironmentSchema,\n computerOpenOptionsSchema,\n ComputerWorkspacePolicy,\n} from \"./environment.mjs\";\nimport {\n computeComputerArtifactKey,\n computerNeedsBuild,\n DEFAULT_COMPUTER_IMAGE,\n resolveComputerSpec,\n type ResolvedComputerSpecIface,\n} from \"./guide.mjs\";\nimport { createTransportSession, sessionForAccess } from \"./session.mjs\";\nimport type { SandboxTransportIface } from \"./transport.mjs\";\nimport {\n guideCommands,\n installGuideCommands,\n mountRepositories,\n repositoryPath,\n runWorkspaceSetup,\n startServices,\n WORKSPACE_ROOT,\n type GuideCommandIface,\n type SetupLogIface,\n} from \"./workspace-setup.mjs\";\n\nexport type { ComputersApiConfigIface, ComputersApiCredentialIface } from \"./computers-api.mjs\";\nexport {\n COMPUTER_SANDBOX_SPECIFIER,\n COMPUTERS_API_KEY_SECRET,\n COMPUTERS_API_TEAM_SECRET,\n} from \"./environment.mjs\";\nexport { computeComputerArtifactKey } from \"./guide.mjs\";\nexport type { ComputerGuideVersionIface } from \"./guide.mjs\";\nexport type { RepositoryCloneSourceIface } from \"./workspace-setup.mjs\";\n\n// The `computer` sandbox: a Final computer from the\n// public Computers API, set up from a computer setup guide, with lifecycle,\n// files and processes all through that API and the organization's own API key,\n// exactly as a third-party provider drives its vendor. Like every\n// provider, it is served by the session service, which runs this handle and\n// serves the handle RPC and MCP projection from it.\n//\n// A guide with build or verify steps is built once on a builder computer and\n// captured as a base (POST /v1/computers/:id/capture); its computers are created\n// from that base. Network and idle policies are create options, as for any\n// API customer.\n//\n// Guides, variables and repository credentials come from the contract's\n// prepare and start contexts (`guides`, `variables`, `repositories`), which the\n// session service serves to every provider alike.\n\nexport interface ComputerSandboxLogIface {\n (message: string, fields?: Record<string, string | number | boolean | null>): void;\n}\n\nexport interface ComputerSandboxProviderConfigIface {\n // The public Computers API, and each organization's credential for it.\n computersApi: ComputersApiConfigIface;\n // A registry credential (`creg_...`) the organization stored for private image references.\n registryCredentialId?: string;\n // Image for an empty environment without an organization default guide.\n defaultImage?: string;\n regionSlug?: string;\n machine?: { vcpu?: number; memoryMb?: number; diskGb?: number };\n idleTimeoutSeconds?: number;\n // How long `start` waits for a registered image version to finish building.\n imageWaitMs?: number;\n imagePollMs?: number;\n // How long `prepare` waits for a guide's base capture to publish.\n buildWaitMs?: number;\n buildPollMs?: number;\n // How long ending a conversation workspace waits for its computer to shelve.\n shelveWaitMs?: number;\n shelvePollMs?: number;\n // How long start, resume and a guide build wait for a computer to run before\n // touching it (default 5 min); polled from runningPollMs (default 250 ms), doubling to 5 s.\n runningWaitMs?: number;\n runningPollMs?: number;\n log?: ComputerSandboxLogIface;\n randomUuid?: () => string;\n now?: () => number;\n sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;\n}\n\n// An `image` base: `imageVersionId` is the registered version (`cimv_...`) of an\n// image reference, registered at prepare; a `lineage:` image resolves its newest\n// version at start. A `captured` base is a guide's build, captured as a base\n// (`part_...`) that computers are created from.\nconst computerArtifactSchema = sandboxSeedArtifactSchema.extend({\n version: z.literal(1),\n key: z.string(),\n image: z.string(),\n diskGb: z.number().nullable(),\n base: z.discriminatedUnion('kind', [\n z.object({\n kind: z.literal('image'),\n image: z.string(),\n imageVersionId: z.string().nullable().default(null),\n }),\n z.object({ kind: z.literal('captured'), baseId: z.string() }),\n ]),\n});\n\nconst computerStateSchema = z.object({\n version: z.literal(1),\n computerId: z.string(),\n computerName: z.string(),\n workspace: z.nativeEnum(ComputerWorkspacePolicy),\n access: z.nativeEnum(SandboxAccess),\n guideVersionId: z.string().nullable(),\n setupHash: z.string().nullable(),\n});\n\n// The provider's own view of a computer while it sets it up.\ninterface SetupSessionIface {\n sandbox: NetworkSandboxSessionIface;\n transport: SandboxTransportIface;\n}\n\nexport type ComputerSandboxArtifact = z.infer<typeof computerArtifactSchema>;\nexport type ComputerSandboxState = z.infer<typeof computerStateSchema>;\n\n// What Build needs to know about a started computer beyond the handle.\nexport interface ComputerSandboxDescriptionIface {\n provider: 'computer';\n computerId: string;\n computerName: string;\n workspaceRoot: string;\n transport: string;\n guide: { slug: string; number: number } | null;\n repositories: { alias: string; path: string; repository: string }[];\n services: { name: string; readyUrl: string | null }[];\n commands: GuideCommandIface[];\n capabilities: SandboxCapability[];\n}\n\nexport interface ComputerSandboxSessionIface extends NetworkSandboxSessionIface {\n describe(): ComputerSandboxDescriptionIface;\n // What this computer's handle offers (the session service reports it).\n readonly capabilities: readonly SandboxCapability[];\n}\n\nexport type ComputerSandboxProviderIface = SandboxProviderIface<\n JsonValue,\n JsonValue,\n ComputerSandboxArtifact,\n ComputerSandboxState,\n ComputerSandboxSessionIface\n>;\n\nexport interface ComputerSandboxErrorIface extends Error {\n code:\n | 'artifact_unavailable'\n | 'computer_gone'\n | 'computer_not_running'\n | 'invalid_environment'\n | 'build_failed';\n}\n\nconst computerSandboxError = (\n code: ComputerSandboxErrorIface['code'],\n message: string,\n): ComputerSandboxErrorIface =>\n Object.assign(new Error(message), { name: 'ComputerSandboxError', code });\n\n// FINAL_NODE_* and the session basics belong to the platform (shared/src/sandbox-templates/reserved.ts),\n// as do the platform environment's variables (the egress proxy and its placeholders).\nconst RESERVED_ENV = new Set([\n ...PLATFORM_ENVIRONMENT_NAMES,\n 'DISPLAY',\n 'XDG_RUNTIME_DIR',\n 'PATH',\n 'HOME',\n 'USER',\n 'SHELL',\n 'HOSTNAME',\n]);\nconst isReservedEnvName = (name: string): boolean =>\n name.startsWith('FINAL_NODE_') || RESERVED_ENV.has(name);\n\nconst HTTP_TOKEN_LIFETIME_MS = 60 * 60_000;\nconst HTTP_TOKEN_RENEW_MS = 5 * 60_000;\n\n// Builds run from here; the capture scrub removes /tmp/*.\nconst BUILD_ROOT = '/tmp/final-build';\n// Guide publication supplies build inputs in files; agent revisions supply workspace seeds.\nconst seedsFor = (ctx: SandboxPrepareContextIface): Record<string, string> =>\n sandboxSeedFiles({\n files: ctx.resources.guide == null ? ctx.files : {},\n resources: ctx.resources,\n });\n// What the Computers API's capture scrub removes, so the home check skips it.\nconst CAPTURE_SCRUBBED_PATHS = [\n '/home/user/.bash_history',\n '/home/user/.zsh_history',\n '/home/user/.sh_history',\n '/home/user/.git-credentials',\n '/home/user/.config/gh/hosts.yml',\n '/home/user/.npmrc',\n '/home/user/.pypirc',\n '/home/user/.cargo/credentials',\n '/home/user/.cargo/credentials.toml',\n '/home/user/.aws',\n '/home/user/.config/gcloud',\n '/home/user/.azure',\n '/home/user/.docker/config.json',\n '/home/user/.netrc',\n '/home/user/.ssh',\n];\nconst BUILDER_IDLE_TIMEOUT_SECONDS = 2 * 60 * 60;\n\ninterface ComputerEgressConfigIface {\n egress: ComputerEgressPolicy;\n allow?: string[];\n}\n\nconst computerEgressOf = (policy: NetworkPolicyIface): ComputerEgressConfigIface => {\n if (policy.mode === NetworkPolicy.AllowAll) return { egress: ComputerEgressPolicy.Internet };\n if (policy.mode === NetworkPolicy.DenyAll) return { egress: ComputerEgressPolicy.None };\n return { egress: ComputerEgressPolicy.Allowlist, allow: policy.allow ?? [] };\n};\n\n// An allowlist also admits the platform's egress hosts, so its proxy stays reachable.\nconst egressFor = (\n ctx: SandboxStartContextIface,\n requested: NetworkPolicyIface,\n): ComputerEgressConfigIface => computerEgressOf(withPlatformEgressHosts(ctx, requested));\n\nconst LINEAGE_PREFIX = 'lineage:';\n\nconst portOf = (url: string): number | null => {\n try {\n const parsed = new URL(url);\n if (parsed.port !== '') return Number(parsed.port);\n return parsed.protocol === 'https:' ? 443 : 80;\n } catch {\n return null;\n }\n};\n\nconst compactId = (id: string): string => id.replaceAll('-', '');\n\nconst sandboxWorkspaceOf = {\n [ComputerWorkspacePolicy.Session]: SandboxWorkspace.Session,\n [ComputerWorkspacePolicy.Conversation]: SandboxWorkspace.Conversation,\n [ComputerWorkspacePolicy.Ephemeral]: SandboxWorkspace.Ephemeral,\n} satisfies Record<ComputerWorkspacePolicy, SandboxWorkspace>;\n\nconst isRunningState = (state: ComputerState): boolean =>\n state === ComputerState.Running ||\n state === ComputerState.Paused ||\n state === ComputerState.Resuming;\n\nconst RUNNING_POLL_MAX_MS = 5_000;\n\nexport const createComputerSandboxProvider = (\n config: ComputerSandboxProviderConfigIface,\n): ComputerSandboxProviderIface => {\n const log: SetupLogIface = config.log ?? (() => undefined);\n const randomUuid = config.randomUuid ?? (() => crypto.randomUUID());\n const now = config.now ?? (() => Date.now());\n const sleep = config.sleep ?? defaultSleep;\n const defaultImage = config.defaultImage ?? DEFAULT_COMPUTER_IMAGE;\n const credentials = createComputersApiCredentials(config.computersApi, now);\n const runningWaitMs = config.runningWaitMs ?? 5 * 60_000;\n\n const clientFor = (organizationId: string): ComputersApiClientIface =>\n createComputersApiClient({ config: config.computersApi, credentials, organizationId });\n\n const registerImage = (client: ComputersApiClientIface, reference: string) =>\n client.registerImage(\n config.registryCredentialId == null\n ? { reference }\n : { reference, registryCredentialId: config.registryCredentialId },\n );\n\n // Computers are created from registered image versions, as any API customer's are.\n // A `lineage:` image is the newest ready version of that lineage (the\n // organization's or the platform's); a reference is registered once, at prepare,\n // and registered again here when its version expired.\n const readyImageVersion = async (\n client: ComputersApiClientIface,\n base: { image: string; imageVersionId: string | null },\n ): Promise<string> => {\n if (base.image.startsWith(LINEAGE_PREFIX)) {\n const lineage = base.image.slice(LINEAGE_PREFIX.length);\n const [newest] = await client.listImages({ lineage, state: ComputerImageState.Ready });\n if (newest == null) {\n throw computerSandboxError(\n 'artifact_unavailable',\n `the Computers API has no ready image version in lineage ${lineage}`,\n );\n }\n return newest.id;\n }\n let version: ComputerImageIface | null = null;\n if (base.imageVersionId != null) {\n try {\n version = await client.getImage(base.imageVersionId);\n } catch (error) {\n if (!isComputersApiStatus(error, 404)) throw error;\n }\n }\n if (version == null || version.state === ComputerImageState.Expired) {\n version = await registerImage(client, base.image);\n }\n const deadline = now() + (config.imageWaitMs ?? 15 * 60_000);\n while (\n version.state === ComputerImageState.Pending ||\n version.state === ComputerImageState.Building\n ) {\n if (now() >= deadline) throw new Error(`image ${base.image} is still building`);\n await sleep(config.imagePollMs ?? 5_000);\n version = await client.getImage(version.id);\n }\n if (version.state !== ComputerImageState.Ready) {\n throw computerSandboxError(\n 'artifact_unavailable',\n `image ${base.image} is ${version.state}${version.error == null ? '' : `: ${version.error}`}`,\n );\n }\n return version.id;\n };\n\n const loadVariables = async (\n ctx: SandboxStartContextIface,\n spec: ResolvedComputerSpecIface,\n ): Promise<Record<string, string>> => {\n const env: Record<string, string> = {};\n for (const [name, value] of Object.entries(spec.parameters.env)) {\n if (isReservedEnvName(name))\n throw computerSandboxError('invalid_environment', `${name} is reserved`);\n env[name] = value;\n }\n for (const name of spec.parameters.variables) {\n if (isReservedEnvName(name))\n throw computerSandboxError('invalid_environment', `${name} is reserved`);\n const value = await ctx.variables.get(name);\n if (value == null)\n throw computerSandboxError('invalid_environment', `variable ${name} is not set`);\n env[name] = value;\n }\n return env;\n };\n\n const mcpClosers = new Map<string, Set<() => Promise<void>>>();\n const closeComputerMcp = async (computerId: string) => {\n const results = await Promise.allSettled(\n [...(mcpClosers.get(computerId) ?? [])].map((close) => close()),\n );\n for (const result of results) if (result.status === 'rejected') throw result.reason;\n };\n const buildHandle = async (args: {\n ctx: SandboxStartContextIface;\n client: ComputersApiClientIface;\n info: ComputerInfoIface;\n spec: ResolvedComputerSpecIface;\n access: SandboxAccess;\n env: () => Promise<Record<string, string>>;\n }): Promise<{ handle: SandboxProviderHandleIface<ComputerSandboxSessionIface> }> => {\n const { client, info, spec } = args;\n const commands = await guideCommands(spec.template);\n const commandHelp = commands\n .map(\n (command) =>\n `Guide command ${command.name}: bash ${command.path}${command.description == null ? '' : ` \u2014 ${command.description}`}`,\n )\n .join('\\n');\n const transport = createComputersApiTransport({ client, computerId: info.id });\n const ports = [\n ...new Set(\n spec.template.services.flatMap((service) => {\n const port = service.ready == null ? null : portOf(service.ready.url);\n return port == null ? [] : [port];\n }),\n ),\n ];\n let httpToken: { token: string; expiresAtMs: number } | null = null;\n const session = createTransportSession({\n id: info.id,\n description: `Final computer ${info.name}${spec.guide == null ? '' : ` (${spec.guide.title} v${spec.guide.number})`}${commands.length === 0 ? '' : `\\n${commandHelp}`}`,\n workspaceRoot: WORKSPACE_ROOT,\n transport,\n baseEnv: args.env,\n randomUuid,\n network: {\n ports,\n // The computer's hostname with a preview token, which opens its HTTP ports only.\n getPortEndpoint: async ({ port, protocol }) => {\n const hostname = info.hostname ?? (await client.getComputer(info.id))?.hostname ?? null;\n if (hostname == null) throw new Error(`computer ${info.name} has no public hostname`);\n if (httpToken == null || httpToken.expiresAtMs - now() < HTTP_TOKEN_RENEW_MS) {\n const expiresAtMs = now() + HTTP_TOKEN_LIFETIME_MS;\n const token = await client.createPreviewToken({\n computerId: info.id,\n name: `agent sandbox ${args.ctx.session.bindingId}`,\n expiresAt: new Date(expiresAtMs),\n });\n httpToken = { token, expiresAtMs };\n }\n const scheme = protocol === PortProtocol.Ws ? 'wss' : 'https';\n return {\n url: `${scheme}://${port === 443 ? hostname : `${hostname}:${port}`}`,\n headers: { authorization: `Bearer ${httpToken.token}` },\n };\n },\n stop: async () => {\n await closeComputerMcp(info.id);\n await client.action(info.id, 'stop');\n },\n destroy: async () => {\n await closeComputerMcp(info.id);\n transport.close();\n try {\n await client.action(info.id, 'delete');\n } catch (error) {\n if (!isComputersApiStatus(error, 404)) throw error;\n }\n },\n },\n });\n let computerUseInstalled: boolean | null = null;\n if (args.access !== SandboxAccess.Read) {\n try {\n computerUseInstalled = (await client.computerUseStatus(info.id, AbortSignal.timeout(1000)))\n .installed;\n } catch {\n /* Optional discovery must never fail the sandbox. */\n }\n }\n const computerUse =\n args.access === SandboxAccess.Read || computerUseInstalled === false\n ? null\n : createComputerUseEndpoint({ client, computerId: info.id, cwd: WORKSPACE_ROOT });\n const closeMcp = async () => {\n try {\n await computerUse?.close();\n } catch (error) {\n log('computer_use.close_failed', {\n computerId: info.id,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n const closers = mcpClosers.get(info.id);\n closers?.delete(closeMcp);\n if (closers?.size === 0) mcpClosers.delete(info.id);\n };\n if (computerUse != null) {\n const closers = mcpClosers.get(info.id) ?? new Set<() => Promise<void>>();\n closers.add(closeMcp);\n mcpClosers.set(info.id, closers);\n }\n const capabilities = [SandboxCapability.Files, SandboxCapability.Ports];\n let screenAvailable = false;\n try {\n screenAvailable = (await client.screenStatus(info.id, AbortSignal.timeout(1000))).available;\n } catch {\n /* Optional desktop discovery leaves headless computers usable. */\n }\n if (screenAvailable) capabilities.push(SandboxCapability.Screen);\n if (computerUse != null) capabilities.push(SandboxCapability.ComputerUse);\n if (args.access !== SandboxAccess.Read)\n capabilities.push(SandboxCapability.Process, SandboxCapability.NetworkPolicy);\n const description: ComputerSandboxDescriptionIface = {\n provider: 'computer',\n computerId: info.id,\n computerName: info.name,\n workspaceRoot: WORKSPACE_ROOT,\n transport: transport.kind,\n guide: spec.guide == null ? null : { slug: spec.guide.slug, number: spec.guide.number },\n repositories: spec.parameters.repositories.map((repository) => ({\n alias: repository.alias,\n path: repositoryPath(repository.alias),\n repository: repository.repository,\n })),\n services: spec.template.services.map((service) => ({\n name: service.name,\n readyUrl: service.ready?.url ?? null,\n })),\n commands,\n capabilities,\n };\n const full: ComputerSandboxSessionIface = {\n ...session,\n setNetworkPolicy: async (policy) => {\n if (args.access === SandboxAccess.Read)\n throw new Error('this sandbox binding is read-only');\n await client.setNetworkPolicy(info.id, egressFor(args.ctx, policy));\n },\n describe: () => description,\n capabilities,\n };\n if (computerUse != null) full.computerUse = async () => computerUse.endpoint;\n if (screenAvailable) {\n full.screen = (options) => client.openScreen(info.id, options);\n }\n const sandbox = sessionForAccess(full, args.access);\n return {\n handle: {\n sandbox,\n onSandboxStop: async () => {\n try {\n await closeMcp();\n } finally {\n transport.close();\n }\n },\n onSandboxDelete: async () => {\n try {\n await closeMcp();\n } finally {\n transport.close();\n }\n try {\n await client.action(info.id, 'delete');\n } catch (error) {\n if (!isComputersApiStatus(error, 404)) throw error;\n }\n },\n onRuntimeShutdown: async () => {\n try {\n await closeMcp();\n } finally {\n transport.close();\n }\n },\n },\n };\n };\n\n // Setup (repositories, workspace.setup, services) is the provider's own work, so it\n // runs with the organization's credential, never through the binding's lease: a\n // read binding still gets a set-up computer.\n const setupSession = (args: {\n client: ComputersApiClientIface;\n info: ComputerInfoIface;\n env: () => Promise<Record<string, string>>;\n }): SetupSessionIface => {\n const transport = createComputersApiTransport({\n client: args.client,\n computerId: args.info.id,\n });\n const sandbox = createTransportSession({\n id: args.info.id,\n description: `setup of ${args.info.name}`,\n workspaceRoot: WORKSPACE_ROOT,\n transport,\n baseEnv: args.env,\n randomUuid,\n network: {\n ports: [],\n getPortEndpoint: async () => {\n throw new Error('setup sessions expose no ports');\n },\n stop: async () => undefined,\n destroy: async () => undefined,\n },\n });\n return { sandbox, transport };\n };\n\n // A captured base, once it is ready; a failed or expired one must be built again.\n const awaitBase = async (\n client: ComputersApiClientIface,\n baseId: string,\n key: string,\n ): Promise<ComputerBaseIface> => {\n const deadline = now() + (config.buildWaitMs ?? 30 * 60_000);\n for (;;) {\n const base = await client.getBase(baseId);\n if (base == null || base.state === ComputerBaseState.Expired) {\n throw computerSandboxError(\n 'artifact_unavailable',\n `computer base ${key} (${baseId}) is ${base == null ? 'gone' : 'expired'}; prepare it again`,\n );\n }\n if (base.state === ComputerBaseState.Ready) return base;\n if (base.state === ComputerBaseState.Failed) {\n throw computerSandboxError(\n 'build_failed',\n `computer base ${key} failed to capture: ${base.error ?? 'unknown error'}`,\n );\n }\n if (now() >= deadline) throw new Error(`computer base ${key} is still capturing`);\n await sleep(config.buildPollMs ?? 5_000);\n }\n };\n\n // The Computers API answers a computer it created or started before the\n // computer has a host, and refuses commands and file writes until it runs\n // (`autoResume: false`), so nothing touches it before this resolves. Only\n // Running counts: a paused computer still refuses them.\n const awaitComputerRunning = async (\n client: ComputersApiClientIface,\n computerId: string,\n timeoutMs: number,\n ): Promise<ComputerInfoIface> => {\n const deadline = now() + timeoutMs;\n let pollMs = config.runningPollMs ?? 250;\n for (;;) {\n const computer = await client.getComputer(computerId);\n if (computer == null || computer.state === ComputerState.Deleted)\n throw computerSandboxError('computer_gone', `computer ${computerId} is gone`);\n if (computer.state === ComputerState.Error)\n throw computerSandboxError(\n 'computer_gone',\n `computer ${computer.name} is in the Error state`,\n );\n if (computer.state === ComputerState.Running) return computer;\n const left = deadline - now();\n if (left <= 0)\n throw computerSandboxError(\n 'computer_not_running',\n `computer ${computer.name} was not running within ${Math.round(timeoutMs / 1000)} s (it is ${ComputerState[computer.state]})`,\n );\n await sleep(Math.min(pollMs, left));\n pollMs = Math.min(pollMs * 2, RUNNING_POLL_MAX_MS);\n }\n };\n\n const awaitShelved = async (client: ComputersApiClientIface, computerId: string) => {\n const deadline = now() + (config.shelveWaitMs ?? 5 * 60_000);\n for (;;) {\n const computer = await client.getComputer(computerId);\n if (\n computer == null ||\n computer.state === ComputerState.Shelved ||\n computer.state === ComputerState.Deleted\n )\n return;\n if (computer.state === ComputerState.Error)\n throw computerSandboxError('computer_gone', `computer ${computerId} failed to shelve`);\n if (now() >= deadline) throw new Error(`computer ${computerId} is still shelving`);\n await sleep(config.shelvePollMs ?? 2_000);\n }\n };\n\n // Run build.steps, then build.verify, on a builder computer of the guide's\n // image, captured as a base its computers are created from.\n const build = async (\n ctx: SandboxPrepareContextIface,\n spec: ResolvedComputerSpecIface,\n key: string,\n ): Promise<ComputerSandboxArtifact> => {\n const client = clientFor(ctx.organizationId);\n const diskGb = config.machine?.diskGb ?? null;\n const imageVersionId = await readyImageVersion(client, {\n image: spec.image,\n imageVersionId: null,\n });\n const body: CreateComputerBodyIface = {\n name: `ag-${key.slice(4, 20)}-${compactId(randomUuid()).slice(0, 8)}`,\n imageVersionId,\n ...config.machine,\n // The base is the root disk; a user volume would keep /home and /workspaces off it.\n userVolumeGb: null,\n // Nothing secret at create: the create env lands in the guest.\n env: {},\n commandMode: ComputerCommandMode.Custom,\n customCommand: 'sleep infinity',\n autoResume: false,\n idleTimeoutSeconds: BUILDER_IDLE_TIMEOUT_SECONDS,\n tags: ['final-agent-sandbox-build'],\n };\n if (config.regionSlug != null) body.regionSlug = config.regionSlug;\n // One builder per attempt: a retry after a failed build starts clean.\n const builder = await client.createComputer(\n body,\n `agent-guide-build-${(await sha256Hex(`${key}:${randomUuid()}`)).slice(0, 32)}`,\n );\n ctx.log?.(`building computer base ${key} on ${builder.name}`);\n try {\n await awaitComputerRunning(client, builder.id, runningWaitMs);\n const sandbox = setupSession({ client, info: builder, env: async () => ({}) }).sandbox;\n const prepared = await sandbox.run({\n command: '/bin/sh',\n args: ['-c', `mkdir -p ${BUILD_ROOT}\\n${homeBaselineScript()}`],\n cwd: '/',\n });\n if (prepared.exitCode !== 0) {\n throw computerSandboxError('build_failed', 'failed to record the pre-build home baseline');\n }\n const steps = [\n ...spec.template.build.steps.map((step) => ({ step, label: 'build step' })),\n ...spec.template.build.verify.map((step) => ({ step, label: 'verify step' })),\n ];\n for (const [index, { step, label }] of steps.entries()) {\n ctx.log?.(`${label} ${index + 1}/${steps.length}`);\n const result = await sandbox.run({\n command: `set -eu\\n${step.run}`,\n shell: true,\n cwd: BUILD_ROOT,\n timeoutMs: step.timeoutMinutes * 60_000,\n });\n if (result.exitCode !== 0) {\n throw computerSandboxError(\n 'build_failed',\n `${label} ${index + 1} failed (exit ${result.exitCode}): ${result.stderr.trim().slice(-2000)}`,\n );\n }\n }\n const homeContent = await sandbox.run({\n command: '/bin/sh',\n args: ['-c', homeContentScript({ excludedPaths: CAPTURE_SCRUBBED_PATHS })],\n cwd: '/',\n });\n if (homeContent.exitCode === HOME_BASELINE_MISSING_EXIT_CODE) {\n throw computerSandboxError(\n 'build_failed',\n `build steps removed ${HOME_BASELINE_ROOT}, which the home content check needs; leave /var/tmp/final-template-build in place.`,\n );\n }\n if (homeContent.exitCode !== 0) {\n const offending = homeContent.stdout\n .trim()\n .split('\\n')\n .filter((line) => line !== '');\n throw computerSandboxError(\n 'build_failed',\n `build steps left content under /home or /workspaces, which each computer's own volume hides: ${offending.join(', ')}. Install tools and configuration to system paths such as /usr/local, or point the tool's home there (for example CARGO_HOME=/usr/local/cargo, RUSTUP_HOME=/usr/local/rustup, NVM_DIR=/usr/local/nvm), put home files in /usr/share/final-vm/home-skel, and use /etc/gitconfig instead of git config --global.`,\n );\n }\n const captured = await client.captureComputer(builder.id, { retained: true });\n if (!captured.retained)\n throw computerSandboxError(\n 'build_failed',\n 'the Computers API did not retain the built base',\n );\n ctx.log?.(`capturing computer base ${key} as ${captured.id}`);\n const base = await awaitBase(client, captured.id, key);\n return {\n version: 1,\n key,\n image: spec.image,\n diskGb: diskGb ?? base.diskGb,\n seedFiles: {},\n base: { kind: 'captured', baseId: base.id },\n };\n } finally {\n // The capture stopped the builder; it is not part of the base.\n try {\n await client.action(builder.id, 'delete');\n } catch (error) {\n log('computer_sandbox.builder_delete_failed', {\n computerId: builder.id,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n }\n };\n\n const environment = (\n rawOptions?: JsonValue,\n ): SandboxProviderImplementationIface<\n JsonValue,\n ComputerSandboxArtifact,\n ComputerSandboxState,\n ComputerSandboxSessionIface\n > => {\n const parsed = computerEnvironmentSchema.safeParse(rawOptions ?? {});\n if (!parsed.success) {\n throw computerSandboxError(\n 'invalid_environment',\n `invalid computer environment: ${parsed.error.message}`,\n );\n }\n const options = parsed.data;\n const resolve = (guides: SandboxGuidesIface): Promise<ResolvedComputerSpecIface> =>\n resolveComputerSpec({ options, guides, defaultImage });\n const keyFor = async (\n spec: ResolvedComputerSpecIface,\n files: Record<string, string>,\n ): Promise<string> => {\n const baseKey = await computeComputerArtifactKey({\n image: spec.image,\n template: spec.template,\n diskGb: config.machine?.diskGb ?? null,\n });\n return Object.keys(files).length === 0\n ? baseKey\n : `${baseKey}-s${await sha256Hex(sandboxSeedIdentity(files))}`;\n };\n\n const startServicesFor = async (args: {\n setup: SetupSessionIface;\n spec: ResolvedComputerSpecIface;\n env: () => Promise<Record<string, string>>;\n }): Promise<void> => {\n await startServices({\n sandbox: args.setup.sandbox,\n transport: args.setup.transport,\n template: args.spec.template,\n // Services run for the computer's life, with the platform's values as they are now.\n env: await args.env(),\n randomUuid,\n log,\n });\n };\n\n const awaitRunning = (\n ctx: SandboxStartContextIface,\n rawState: Pick<ComputerSandboxState, 'computerId'>,\n options: { timeoutMs: number },\n ): Promise<ComputerInfoIface> =>\n awaitComputerRunning(\n clientFor(ctx.session.organizationId),\n computerStateSchema.pick({ computerId: true }).parse(rawState).computerId,\n options.timeoutMs,\n );\n\n return {\n processes: async (ctx, rawState, request) => {\n const state = computerStateSchema.parse(rawState);\n if (\n request.operation === ProcessInspectionOperation.Stop &&\n state.access === SandboxAccess.Read\n )\n throw new Error('stopping processes requires execute access');\n const result = await clientFor(ctx.organizationId).inspectProcesses(\n state.computerId,\n request,\n );\n return request.operation === ProcessInspectionOperation.Available && 'available' in result\n ? { ...result, canStop: state.access !== SandboxAccess.Read }\n : result;\n },\n editor: async (_ctx, rawState, request) => {\n const state = computerStateSchema.parse(rawState);\n if (state.access !== SandboxAccess.Write) {\n if (request.operation === 'available') return { available: false };\n throw new Error('editor requires write access');\n }\n return computerEditor({\n client: clientFor(_ctx.organizationId),\n computerId: state.computerId,\n request,\n randomUuid,\n });\n },\n readSnapshot: async (ctx, rawState, request) => {\n const state = computerStateSchema.parse(rawState);\n return readComputerSnapshot({\n client: clientFor(ctx.organizationId),\n computerId: state.computerId,\n request,\n });\n },\n // The merged parameters' workspace: the binding's, else the saved version's default.\n workspace: async (ctx) =>\n sandboxWorkspaceOf[(await resolve(ctx.guides)).parameters.workspace],\n artifactKey: async (ctx) => keyFor(await resolve(ctx.guides), seedsFor(ctx)),\n // Registers an image reference so its version builds ahead of the first start;\n // a lineage needs nothing until then.\n prepare: async (ctx) => {\n const spec = await resolve(ctx.guides);\n const seedFiles = seedsFor(ctx);\n const key = await keyFor(spec, seedFiles);\n const seedArtifact = await sandboxSeedArtifact(ctx, seedFiles);\n if (computerNeedsBuild(spec)) {\n const baseKey = await keyFor(spec, {});\n const prepared = spec.guide?.preparedArtifact;\n if (\n prepared?.key === baseKey &&\n prepared.providerRef === formatProviderRef(packageRef(COMPUTER_SANDBOX_SPECIFIER))\n ) {\n const cached = computerArtifactSchema.safeParse(prepared.artifact);\n if (\n cached.success &&\n cached.data.key === baseKey &&\n cached.data.base.kind === 'captured'\n ) {\n const base = await clientFor(ctx.organizationId).getBase(cached.data.base.baseId);\n if (base?.state === ComputerBaseState.Ready) {\n if (!base.retained) {\n const retained = await clientFor(ctx.organizationId).setBaseRetention(\n base.id,\n true,\n );\n if (!retained.retained)\n throw computerSandboxError(\n 'build_failed',\n 'the Computers API did not retain the prepared base',\n );\n }\n return { ...cached.data, key, ...seedArtifact };\n }\n }\n }\n const cached = computerArtifactSchema.safeParse(await ctx.artifacts?.get(baseKey));\n if (\n cached.success &&\n cached.data.key === baseKey &&\n cached.data.base.kind === 'captured'\n ) {\n const base = await clientFor(ctx.organizationId).getBase(cached.data.base.baseId);\n if (base?.state === ComputerBaseState.Ready) {\n if (!base.retained) {\n const retained = await clientFor(ctx.organizationId).setBaseRetention(\n base.id,\n true,\n );\n if (!retained.retained)\n throw computerSandboxError(\n 'build_failed',\n 'the Computers API did not retain the prepared base',\n );\n }\n return { ...cached.data, key, ...seedArtifact };\n }\n }\n const built = await build(ctx, spec, baseKey);\n await ctx.artifacts?.put(baseKey, built);\n return { ...built, key, ...seedArtifact };\n }\n const imageVersionId = spec.image.startsWith(LINEAGE_PREFIX)\n ? null\n : (await registerImage(clientFor(ctx.organizationId), spec.image)).id;\n ctx.log?.(`computer base ${key} is image ${spec.image}`);\n return {\n version: 1,\n key,\n image: spec.image,\n diskGb: config.machine?.diskGb ?? null,\n ...seedArtifact,\n base: { kind: 'image', image: spec.image, imageVersionId },\n };\n },\n awaitRunning: async (ctx, state, options) => {\n await awaitRunning(ctx, state, options);\n },\n start: async (ctx, openOptions, rawArtifact) => {\n const access = computerOpenOptionsSchema.parse(openOptions ?? {}).access;\n const spec = await resolve(ctx.guides);\n const policy = withPlatformEgressHosts(ctx, spec.parameters.networkPolicy);\n const egress = computerEgressOf(policy);\n const artifact = computerArtifactSchema.safeParse(rawArtifact);\n if (!artifact.success) {\n throw computerSandboxError(\n 'artifact_unavailable',\n 'this computer base predates the public Computers API provider; prepare it again',\n );\n }\n const base = artifact.data.base;\n if (computerNeedsBuild(spec) && base.kind !== 'captured') {\n throw computerSandboxError(\n 'artifact_unavailable',\n `computer base ${artifact.data.key} was prepared without its build steps; prepare it again`,\n );\n }\n // Variables resolve before anything is created, so a missing one costs nothing.\n const env = platformProcessEnvironment(ctx, await loadVariables(ctx, spec));\n const client = clientFor(ctx.session.organizationId);\n const workspace = spec.parameters.workspace;\n const name =\n workspace === ComputerWorkspacePolicy.Conversation && ctx.session.conversationId != null\n ? `ac-${(await sha256Hex(`${ctx.session.conversationId}:${ctx.session.target}`)).slice(0, 24)}`\n : `ab-${compactId(ctx.session.bindingId)}`;\n const existing = await client.getComputer(name);\n if (existing?.state === ComputerState.Error)\n throw computerSandboxError(\n 'computer_gone',\n `Computer ${existing.id} (${name}) is in the Error state. Recover it through the Computers API before retrying; its workspace is preserved.`,\n );\n let info: ComputerInfoIface;\n let fresh = true;\n if (existing != null && existing.state !== ComputerState.Deleted) {\n info = existing;\n fresh = !isRunningState(existing.state);\n if (existing.state === ComputerState.Paused) await client.action(existing.id, 'resume');\n else if (fresh) await client.action(existing.id, 'start');\n } else {\n const source: Pick<CreateComputerBodyIface, 'baseId' | 'imageVersionId'> =\n base.kind === 'captured'\n ? { baseId: (await awaitBase(client, base.baseId, artifact.data.key)).id }\n : { imageVersionId: await readyImageVersion(client, base) };\n const body: CreateComputerBodyIface = {\n name,\n ...source,\n ...config.machine,\n env: {},\n autoResume: true,\n idleTimeoutSeconds: config.idleTimeoutSeconds ?? 15 * 60,\n // Provider teardown owns deletion; VM-level ephemeral disks cannot be paused.\n ephemeral: false,\n network: egress,\n tags: [\n 'final-agent-sandbox',\n `agent-binding:${ctx.session.bindingId}`,\n 'agent-runtime-attachment:v1',\n 'agent-runtime-role:sandbox',\n ],\n };\n // Session teardown owns deletion, including ephemeral computers. Idle must preserve files.\n body.idlePolicy = ComputerIdlePolicy.Pause;\n if (config.regionSlug != null) body.regionSlug = config.regionSlug;\n // Keyed by the source too: a retry after re-registering is a different request.\n const idempotencyKey = `agent-sandbox-${(await sha256Hex(`${ctx.session.bindingId}:${name}:${source.baseId ?? source.imageVersionId}`)).slice(0, 32)}`;\n info = await client.createComputer(body, idempotencyKey);\n }\n const reused = existing != null && existing.id === info.id;\n log('computer_sandbox.started', { computerId: info.id, reused });\n try {\n info = await awaitRunning(ctx, { computerId: info.id }, { timeoutMs: runningWaitMs });\n // A reused computer keeps whatever policy it last ran under; it gets the spec's again.\n if (reused) await client.setNetworkPolicy(info.id, egress);\n await reportPlatformNetworkPolicy(ctx, policy);\n const setup = setupSession({ client, info, env });\n await writePlatformFiles(ctx, setup.sandbox);\n await mountRepositories({\n sandbox: setup.sandbox,\n repositories: spec.parameters.repositories,\n resolver: ctx.repositories,\n log,\n });\n await materializeSandboxSeeds({\n sandbox: setup.sandbox,\n root: WORKSPACE_ROOT,\n files: await sandboxSeedFilesForStart(ctx, artifact.data),\n });\n await installGuideCommands({ sandbox: setup.sandbox, template: spec.template });\n const setupHash = await runWorkspaceSetup({\n sandbox: setup.sandbox,\n template: spec.template,\n repositories: spec.parameters.repositories,\n log,\n });\n if (fresh) await startServicesFor({ setup, spec, env });\n const { handle } = await buildHandle({ ctx, client, info, spec, access, env });\n return {\n handle,\n region: info.regionSlug ?? config.regionSlug ?? null,\n state: {\n version: 1,\n computerId: info.id,\n computerName: info.name,\n workspace,\n access,\n guideVersionId: spec.guide?.versionId ?? null,\n setupHash,\n },\n };\n } catch (error) {\n // No state reaches the caller on failure; clean up only this start's new computer.\n if (!reused) {\n try {\n await client.action(info.id, 'delete');\n } catch (cleanupError) {\n throw new AggregateError(\n [error, cleanupError],\n `computer ${info.name} setup and cleanup failed`,\n );\n }\n }\n throw error;\n }\n },\n resumePassive: async (ctx, _artifact, rawState) => {\n const state = computerStateSchema.parse(rawState);\n const client = clientFor(ctx.session.organizationId);\n const info = await client.getComputer(state.computerId);\n if (info == null || info.state !== ComputerState.Running)\n throw computerSandboxError(\n 'computer_not_running',\n 'computer is not running for passive access',\n );\n await awaitRunning(ctx, state, { timeoutMs: runningWaitMs });\n const spec = await resolve(ctx.guides);\n const env = platformProcessEnvironment(ctx, await loadVariables(ctx, spec));\n return (await buildHandle({ ctx, client, info, spec, access: state.access, env })).handle;\n },\n resume: async (ctx, _artifact, rawState) => {\n const state = computerStateSchema.parse(rawState);\n const client = clientFor(ctx.session.organizationId);\n const info = await client.getComputer(state.computerId);\n if (\n info == null ||\n info.state === ComputerState.Deleted ||\n info.state === ComputerState.Error\n ) {\n throw computerSandboxError('computer_gone', `computer ${state.computerName} is gone`);\n }\n // Computers pause when idle, so a resume usually continues in place; one the\n // platform stopped or shelved meanwhile boots again.\n const rebooted = !isRunningState(info.state);\n if (info.state === ComputerState.Paused) await client.action(info.id, 'resume');\n else if (rebooted) await client.action(info.id, 'start');\n const running = await awaitRunning(ctx, state, { timeoutMs: runningWaitMs });\n const spec = await resolve(ctx.guides);\n const env = platformProcessEnvironment(ctx, await loadVariables(ctx, spec));\n // The spec's policy again, whatever the computer last ran under.\n const policy = withPlatformEgressHosts(ctx, spec.parameters.networkPolicy);\n await client.setNetworkPolicy(running.id, computerEgressOf(policy));\n await reportPlatformNetworkPolicy(ctx, policy);\n const setup = setupSession({ client, info: running, env });\n await writePlatformFiles(ctx, setup.sandbox);\n await installGuideCommands({ sandbox: setup.sandbox, template: spec.template });\n // Processes survive a pause; a stopped or shelved computer booted again.\n if (rebooted) await startServicesFor({ setup, spec, env });\n const { handle } = await buildHandle({\n ctx,\n client,\n info: running,\n spec,\n access: state.access,\n env,\n });\n return handle;\n },\n park: async (ctx, _artifact, rawState) => {\n const state = computerStateSchema.parse(rawState);\n await closeComputerMcp(state.computerId);\n try {\n await clientFor(ctx.session.organizationId).action(state.computerId, 'pause');\n } catch (error) {\n // Already paused or stopped: nothing to do.\n if (!isComputersApiStatus(error, 409)) throw error;\n }\n return state;\n },\n onSessionEnd: async (ctx, _artifact, rawState, { reason }) => {\n const state = computerStateSchema.parse(rawState);\n const client = clientFor(ctx.session.organizationId);\n // A conversation workspace outlives its binding (the conversation was\n // archived, or its workspace replaced): it is shelved, its disk backed up\n // to storage with no host held, and the next binding for the\n // conversation starts it again by name. Session and ephemeral disks end\n // with their binding.\n const action = state.workspace === ComputerWorkspacePolicy.Conversation ? 'stop' : 'delete';\n log('computer_sandbox.session_end', { computerId: state.computerId, reason, action });\n try {\n await client.action(state.computerId, action);\n } catch (error) {\n if (isComputersApiStatus(error, 404)) return;\n if (!isComputersApiStatus(error, 409)) throw error;\n // A conflict is done only when the computer is already where the action\n // takes it; one mid-transition (an idle pause committing) is retried.\n const current = await client.getComputer(state.computerId);\n const settled =\n current == null ||\n current.state === ComputerState.Deleted ||\n (action === 'stop' && current.state === ComputerState.Shelved);\n if (!settled) throw error;\n return;\n }\n // `stop` returns once the shelve is scheduled: the cleanup (and the\n // session service's fence on reusing the workspace) lasts until it is.\n if (action === 'stop') await awaitShelved(client, state.computerId);\n },\n };\n };\n\n return defineSandboxProvider({\n name: 'computer',\n stateProtocolVersion: 1,\n environment,\n });\n};\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["COMPUTER_SANDBOX_SPECIFIER", "computeComputerArtifactKey", "options", "cached"]
|
|
7
7
|
}
|
|
@@ -10,6 +10,8 @@ export interface DeviceSandboxProviderConfigIface {
|
|
|
10
10
|
api: DeviceApiConfigIface;
|
|
11
11
|
fetch?: DeviceApiFetchIface;
|
|
12
12
|
leaseTtlMs?: number;
|
|
13
|
+
onlineWaitMs?: number;
|
|
14
|
+
sleep?: (ms: number) => Promise<void>;
|
|
13
15
|
log?: (message: string, fields?: Record<string, string | number | boolean | null>) => void;
|
|
14
16
|
randomUuid?: () => string;
|
|
15
17
|
now?: () => number;
|