@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.
@@ -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 egressFor = (spec) => {
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: () => args.env,
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
- const network = policy.mode === NetworkPolicy.AllowAll ? { egress: ComputerEgressPolicy.Internet } : policy.mode === NetworkPolicy.DenyAll ? { egress: ComputerEgressPolicy.None } : { egress: ComputerEgressPolicy.Allowlist, allow: policy.allow ?? [] };
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: () => args.env,
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
- const sandbox = setupSession({ client, info: builder, env: {} }).sandbox;
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
- env: args.env,
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 egress = egressFor(spec);
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
- log("computer_sandbox.started", { computerId: info.id, reused: existing != null });
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 (existing == null || existing.id !== info.id) {
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 setup = setupSession({ client, info, env });
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;