@agent-compose/sdk 0.6.0 → 0.8.0

package/dist/runtimes/opencode.d.ts

@@ -0,0 +1,25 @@
+/**
+ * OpenCode CLI runtime — drives sst's `opencode` agentic CLI inside the sandbox.
+ * OpenCode speaks ACP natively (`opencode acp`, protocolVersion 1 — verified
+ * live on E2B), so the runner drives it over ACP; the JSONL members below are
+ * only the version-mismatch fallback (vestigial for a v1 agent).
+ *
+ * Auth + model via OpenRouter: set OPENROUTER_API_KEY (a factory/workflow
+ * secret) and use a model id like `openrouter/z-ai/glm-5.2`. The runtime
+ * installs the `opencode-ai` CLI on demand; pair with
+ * `snapshots: { bootFrom: "reuse" }` to install once and boot from the capture.
+ *
+ * Verified live on E2B (2026-06-30): `npm i -g opencode-ai` (v1.17.12);
+ * `opencode run --model openrouter/z-ai/glm-5.2` drove a GLM-5.2 turn through
+ * OpenRouter; `opencode acp` answered the ACP `initialize` handshake with
+ * protocolVersion 1.
+ */
+import { type CliAgentSpec } from "./_cli-agent.js";
+export declare const opencodeSpec: CliAgentSpec;
+export interface OpencodeRuntimeConfig {
+    /** OpenRouter-prefixed model id (default `openrouter/z-ai/glm-5.2`). */
+    model?: string;
+}
+export declare function createOpencodeRuntime(config?: OpencodeRuntimeConfig): import("../index.js").AgentRuntime<import("../sandbox.js").SandboxProvider>;
+declare const _default: import("../index.js").AgentRuntime<import("../sandbox.js").SandboxProvider>;
+export default _default;

package/dist/runtimes/vercel.js

@@ -717,7 +717,28 @@ async function corePause(req, coord, kind = "custom") {
 
 // src/utils/errors.ts
 function formatError(err) {
-  return err instanceof Error ? err.message : String(err);
+  if (!(err instanceof Error)) {
+    if (typeof err === "object" && err !== null) {
+      const msg = err.message;
+      if (typeof msg === "string" && msg.length > 0)
+        return msg;
+      try {
+        return JSON.stringify(err) ?? String(err);
+      } catch {
+        return String(err);
+      }
+    }
+    return String(err);
+  }
+  const parts = [err.message];
+  const seen = new Set([err]);
+  let cause = err.cause;
+  while (cause != null && !seen.has(cause)) {
+    seen.add(cause);
+    parts.push(cause instanceof Error ? cause.message : String(cause));
+    cause = cause instanceof Error ? cause.cause : undefined;
+  }
+  return parts.join(": ");
 }
 
 // src/runtimes/vercel.ts

package/dist/sandbox/devbox.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The devbox — ADR-0038's "Computer": one persistent E2B **desktop** machine per
+ * member, paused by default, resumed on attach (~100ms).
+ *
+ * This module is the SINGLE SOURCE for the machine's template identity: the
+ * recipe lives in `infra/e2b-template/devbox.ts`, `infra/e2b-template/build.ts`
+ * bakes it under the alias below, and the server imports the alias from here to
+ * provision a machine (exactly how `e2bBaseTemplate` reaches the E2B provider —
+ * a stable ALIAS, never a snapshot id, so the same string resolves in whichever
+ * E2B account a deployment uses).
+ *
+ * Interactive only. Workflow RUNS never execute on a devbox (ADR-0038 §2.6):
+ * runs boot the clean per-size `agent-compose-base-<size>` / `agent-env-<size>`
+ * templates so reproducibility never inherits hand-configured drift.
+ */
+/** Stable E2B template ALIAS for the per-member desktop machine. Baked by
+ *  `infra/e2b-template/build.ts` from `infra/e2b-template/devbox.ts`; CI rebakes
+ *  it on any master push that touches the recipe (.github/workflows/sandbox-images.yml).
+ *  Boot it with `@e2b/desktop`'s `Sandbox.create(E2B_DEVBOX_TEMPLATE, …)`. */
+export declare const E2B_DEVBOX_TEMPLATE = "agent-compose-devbox";
+/** Machine spec the devbox alias is stamped with. E2B sizing is TEMPLATE-baked
+ *  (no create-time cpu/mem knob), so this is the machine every member gets.
+ *
+ *  8 vCPU / 8192 MB matches E2B's stock `desktop` template — the exact shape the
+ *  ADR-0038 spike measured (pause 456ms / resume 99ms, RAM + desktop + dockerd
+ *  preserved). 8192 MB is also the E2B account's hard memory ceiling
+ *  (`Template.build` 400s above it), so this is the largest machine we can bake
+ *  today; raising it needs a plan change first. */
+export declare const E2B_DEVBOX_SPEC: {
+    readonly cpuCount: number;
+    readonly memoryMB: number;
+};
+/** Recipe version of the baked devbox image. The alias is stable across
+ *  rebuilds (it re-points at the new build), so the alias alone can't tell you
+ *  WHICH recipe a machine was provisioned from — the server stamps
+ *  `dev_machines.template` with `e2bDevboxTemplateRef()` for that lineage.
+ *  BUMP whenever `infra/e2b-template/devbox.ts` changes what it bakes. */
+export declare const E2B_DEVBOX_RECIPE_VERSION = "1";
+/** Versioned, human-readable ref for the image a machine was provisioned from
+ *  (`agent-compose-devbox@1`) — what ADR-0038 §6's `dev_machines.template`
+ *  stores. NOT a boot target: boot from `E2B_DEVBOX_TEMPLATE`. */
+export declare function e2bDevboxTemplateRef(): string;

package/dist/sandbox/exec-stream.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SSE exec-stream parser — used by the agent sandbox broker clients in
+ * runner.ts to consume a streamed command execution.
+ */
+import type { SandboxCommandResult } from "../types/sandbox.js";
+export interface ParseSseExecStreamOptions {
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+}
+/**
+ * Parse an SSE exec stream from a ReadableStream.
+ * Used by the agent sandbox broker in runner.ts.
+ */
+export declare function parseSseExecStream(body: ReadableStream<Uint8Array>, opts?: ParseSseExecStreamOptions): Promise<SandboxCommandResult>;

package/dist/sandbox/network-policy.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Sandbox egress network policy — ONE shape for every provider, plus the
+ * translators into each provider's native enforcement config
+ * (`toVercelNetworkPolicy` / `toE2bNetwork`) and the dot-segment path guards.
+ */
+import type { SandboxNetworkOpts as E2bNetworkOpts } from "e2b";
+import type { ConnectorRequestRules } from "../types/workflow-metadata.js";
+import type { NetworkPolicy as VercelNetworkPolicy } from "@vercel/sandbox";
+/**
+ * Network policy for outbound HTTPS requests — ONE shape for every provider;
+ * only the enforcement point differs. When a sandbox makes a request matching
+ * a domain in `allow`, the egress layer injects the specified headers before
+ * forwarding — credentials never exist inside the VM. Both providers enforce
+ * this natively at the platform edge from the resolved policy passed at
+ * create: Vercel via its firewall (`requestRules` translate to native `match`
+ * rules), E2B via its native network firewall (`toE2bNetwork` →
+ * `allowOut`/`denyOut`/`rules`). See `toVercelNetworkPolicy` / `toE2bNetwork`.
+ */
+export interface SandboxNetworkHeaderTransform {
+    headers?: Record<string, string>;
+}
+export interface SandboxNetworkAllowRule {
+    transform?: SandboxNetworkHeaderTransform[];
+    /** Tier-2 request gate (method/path) — the transform only applies when the
+     *  request matches. Honoured on Vercel (translated to native `match` rules).
+     *  NOT honoured on E2B: its native rules carry only a `transform`, no
+     *  method/path matcher, so a brokered credential rides ALL requests to an
+     *  allowed host there (see `toE2bNetwork`). Present on connector-auth rules;
+     *  see `ConnectorRequestRules`. */
+    requestRules?: ConnectorRequestRules;
+}
+export interface SandboxNetworkSubnetPolicy {
+    allow?: string[];
+    deny?: string[];
+}
+export type SandboxNetworkPolicy = "allow-all" | "deny-all" | {
+    allow?: string[] | Record<string, SandboxNetworkAllowRule[]>;
+    subnets?: SandboxNetworkSubnetPolicy;
+};
+/** Matches a path containing a dot-dot segment — literal (`/../`) or
+ *  percent-encoded (`%2e%2e`, `%2f` boundaries). `DOT_SEGMENT_PATH_RE2` is
+ *  the RE2 form handed to Vercel's matcher: wrapped in `.*` so it behaves
+ *  identically under search and full-match semantics (RE2 has no lookaround,
+ *  so the guard is a positive match on the traversal pattern, used as a
+ *  credential-stripping first rule). `DOT_SEGMENT_RE` is the local JS twin
+ *  used to validate DECLARED prefixes. */
+export declare const DOT_SEGMENT_PATH_RE2 = ".*(?:^|/|%2[fF])(?:\\.|%2[eE]){2}(?:/|%2[fF]|$).*";
+/**
+ * Translate our policy shape into Vercel's native `NetworkPolicy`.
+ *
+ * The shapes are identical except for Tier-2: our `requestRules`
+ * (`{ methods, pathPrefixes }`) become Vercel `match` rules
+ * (`{ method, path: { startsWith } }`) — one rule per path prefix, since a
+ * Vercel matcher carries a single path.
+ *
+ * Dot-segment defense: prefix matching is raw — `/repos/acme/../../user`
+ * starts with `/repos/acme/` but the origin normalizes it to `/user`, riding
+ * the credential outside its declared scope. We don't get to assume the
+ * enforcer RFC-3986-normalizes before matching, so every domain with a path
+ * gate gets a transform-free FIRST rule matching dot-segment paths
+ * (first-match-wins ⇒ such requests go out credential-free), and declared
+ * prefixes themselves are validated (must start with "/", no dot-segments).
+ *
+ * Accepted divergence from iron-proxy (E2B): off-gate requests to an allowed
+ * domain pass WITHOUT the transform (Vercel terminates TLS only for
+ * transform-bearing domains and applies first-match-wins) — iron-proxy
+ * REFUSES them instead. Reachability differs; the property that matters is
+ * preserved on both substrates: the brokered credential rides only declared
+ * method/path combinations. Pinned by vercel-network-policy.test.ts.
+ */
+export declare function toVercelNetworkPolicy(policy: SandboxNetworkPolicy): VercelNetworkPolicy;
+/**
+ * Translate our policy shape into E2B's native `network` config
+ * (`SandboxNetworkOpts`) — the E2B analogue of `toVercelNetworkPolicy`.
+ *
+ *   - `allowOut`: the set of allowed egress targets — every host named in
+ *     `allow` PLUS every CIDR in `subnets.allow`. The Archil raw-TCP
+ *     data-plane CIDRs ride here as FIRST-CLASS allow entries (E2B has no
+ *     root-exemption to lean on, unlike the old in-VM iptables model).
+ *   - `denyOut`: the all-traffic sentinel (`0.0.0.0/0`) so the policy is
+ *     DEFAULT-DENY — only `allowOut` targets pass. E2B applies allow before
+ *     deny, so a host in both lists is allowed.
+ *   - `rules`: per-host header injection. For each host carrying transform(s),
+ *     emit one rule per transform with `{ transform: { headers } }`. A host
+ *     with a rule MUST also be in `allowOut` (registering a rule does not
+ *     grant egress on its own — E2B's API requires the host in `allowOut`).
+ *
+ * BEHAVIOURAL DIVERGENCE FROM iron-proxy / Vercel — path/method gating is NOT
+ * available on E2B native rules. An `SandboxNetworkRule` carries only a
+ * `transform` (header injection); there is no method/path matcher. So our
+ * Tier-2 `requestRules` (`{ methods, pathPrefixes }`) cannot be enforced here:
+ * a brokered credential rides EVERY request to an allowed host on E2B, whereas
+ * Vercel (native `match`) and the old iron-proxy gated it to the declared
+ * method+path. The host allowlist still confines WHICH hosts the credential
+ * can reach; it just can't narrow to a method/path within an allowed host.
+ *
+ * String policies map straight through: "allow-all" → no restriction (omit
+ * `allowOut`/`denyOut`), "deny-all" → block all egress.
+ */
+export declare function toE2bNetwork(policy: SandboxNetworkPolicy): E2bNetworkOpts;

package/dist/sandbox/provider-def.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The contract a sandbox provider implements (`SandboxProviderDef`), the
+ * create-time options every provider receives, and the fleet tag that scopes
+ * a deployment's sandboxes on the provider side. Providers implement this;
+ * the registry consumes it.
+ */
+import type { SandboxProvider } from "../types/sandbox.js";
+import type { SandboxNetworkPolicy } from "./network-policy.js";
+import type { SandboxSize } from "./sizes.js";
+export declare const AGENT_COMPOSE_TAG: string;
+export interface SandboxCreateOpts {
+    envs: Record<string, string>;
+    metadata: Record<string, string>;
+    timeoutMs: number;
+    /** Provider-specific template/snapshot identifier. E2B: template id or
+     *  snapshot id (omit → E2B's default base). Vercel: snapshot id (omit → node24). */
+    template?: string;
+    /** Machine size. Vercel maps it to `resources.vcpus`; E2B ignores it
+     *  (size is template-defined). Omit → `DEFAULT_SANDBOX_SIZE`. */
+    size?: SandboxSize;
+    /** Outbound request policy with header transforms — ONE shape for every
+     *  provider; only the enforcement point differs. Both providers enforce +
+     *  inject natively at create from this value: Vercel via its firewall
+     *  (`toVercelNetworkPolicy`), E2B via its native network firewall
+     *  (`toE2bNetwork` → `network: { allowOut, denyOut, rules }`). */
+    networkPolicy?: SandboxNetworkPolicy;
+}
+/**
+ * What the provider reports as "currently alive" — the single input to orphan
+ * reconciliation. `metadata` is best-effort: E2B populates it from sandbox
+ * labels, Vercel from sandbox tags (max 5, stamped at create). Callers
+ * that need runId correlation cross-reference `sandboxId` against their own
+ * state (server: `workflow_runs.sandbox_id` + `run_agent_sandboxes.provider_sandbox_id`).
+ */
+export interface OwnedSandbox {
+    sandboxId: string;
+    createdAt: Date;
+    metadata: Record<string, string>;
+}
+export interface SandboxProviderDef {
+    requiredEnv: Record<string, string>;
+    create: (opts: SandboxCreateOpts, env: Record<string, string>) => Promise<SandboxProvider>;
+    reconnect?: (sandboxId: string) => Promise<SandboxProvider>;
+    killAll?: (env: Record<string, string>) => Promise<void>;
+    /**
+     * Returns the number of sandboxes currently running against this provider.
+     * Used for quota observability — account-wide, not per-instance.
+     *
+     * Both providers scope by our AGENT_COMPOSE_TAG (E2B metadata labels,
+     * Vercel tags) so each fleet only reports its own sandboxes; DD aggregates
+     * across instances with `sum by {provider}`.
+     */
+    getActiveCount?: (env: Record<string, string>) => Promise<number>;
+    /**
+     * Provider's view of what's currently alive for our account/fleet.
+     * The reconciliation SoT — a sandbox missing from this list IS dead,
+     * regardless of what our DB says. Implemented by listing the provider's
+     * running sandboxes; E2B filters by metadata tag, Vercel by the `executor`
+     * sandbox tag.
+     */
+    listOwned?: (env: Record<string, string>) => Promise<OwnedSandbox[]>;
+    /**
+     * Delete a snapshot by id. Called from the customer-initiated
+     * `DELETE /workflows/:runId/snapshot` route. Best-effort — the DB is
+     * source of truth; an orphan on the provider side is benign and cleaned
+     * up eventually by the provider's own retention.
+     */
+    deleteSnapshot?: (snapshotId: string, env: Record<string, string>) => Promise<void>;
+    /**
+     * Does this snapshot id resolve on the provider for this account? A cheap
+     * metadata lookup — NEVER provisions a sandbox. Used at server boot to
+     * validate that the platform base snapshots the default templates boot from
+     * actually exist for this deployment (catching e.g. a dev-account snapshot
+     * baked into prod). Returns true if it resolves, false if the provider
+     * reports it does not exist. Transport/credential errors PROPAGATE — an
+     * indeterminate result must not be reported as "missing".
+     */
+    snapshotExists?: (snapshotId: string, env: Record<string, string>) => Promise<boolean>;
+}

package/dist/sandbox/providers/desktop.d.ts

@@ -0,0 +1,10 @@
+/**
+ * E2B Desktop sandbox provider — the base E2B wrapper plus mouse/keyboard/
+ * screenshot control, and the "e2b-desktop" registry entry. Registry-only:
+ * never a workflow's runtime (see `workflow-metadata.ts`).
+ */
+import { Sandbox as Desktop } from "@e2b/desktop";
+import type { DesktopSandboxProvider } from "../../types/sandbox.js";
+import type { SandboxProviderDef } from "../provider-def.js";
+export declare function makeDesktopSandboxProvider(sb: Desktop): DesktopSandboxProvider;
+export declare const e2bDesktopProviderDef: SandboxProviderDef;

package/dist/sandbox/providers/e2b.d.ts

@@ -0,0 +1,17 @@
+/**
+ * E2B sandbox provider — the generic E2B command/file wrapper
+ * (`makeSandboxProvider`, shared with the desktop provider), the E2B-specific
+ * provider with background launch + native VM-suspend, and the "e2b"
+ * registry entry.
+ */
+import { Sandbox } from "e2b";
+import type { Sandbox as Desktop } from "@e2b/desktop";
+import type { SandboxProvider } from "../../types/sandbox.js";
+import type { SandboxProviderDef } from "../provider-def.js";
+export declare function makeSandboxProvider(sb: Sandbox | Desktop): SandboxProvider;
+/** E2B caps a sandbox's lifetime per plan (Hobby 1h, Pro 24h) and 400s when the
+ *  create timeout exceeds it — and our `AC_SANDBOX_DEADLINE` (4.5h) tops Hobby.
+ *  Clamp the E2B create timeout to this max (raise on Pro via `E2B_MAX_SANDBOX_MS`).
+ *  Read at call time so the workflow bundle stays env-free. */
+export declare function e2bMaxSandboxMs(): number;
+export declare const e2bProviderDef: SandboxProviderDef;

package/dist/sandbox/providers/local.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Local provider (runner's own VM).
+ */
+import type { SandboxProvider } from "../../types/sandbox.js";
+/** Minimal SandboxProvider that targets the current process's host VM.
+ *  `commands.run` → `child_process.spawn`; `files.write` → `fs.writeFile`;
+ *  `kill` is a no-op because the caller IS the VM. Used by
+ *  `defineSandboxEnvironment` so setup recipes read like imperative
+ *  provisioning scripts. Uses `node:child_process` — works under both Node
+ *  (the runner executes `node /tmp/runner.bundle.js`) and Bun. */
+export declare function makeLocalSandboxProvider(): SandboxProvider;

package/dist/sandbox/providers/vercel.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Vercel sandbox provider (@vercel/sandbox 2.x) — tag building, the provider
+ * wrapper, and the "vercel" registry entry.
+ *
+ * CRITICAL: every VALUE import of @vercel/sandbox in this file is dynamic
+ * (`await import(...)`) so the package stays out of runner.bundle.js — the
+ * runner never calls these paths. Top-level imports are type-only (erased).
+ */
+import type { SandboxProviderDef } from "../provider-def.js";
+/** Vercel caps sandbox tags at 5. Build the tag set with the fleet `executor`
+ *  tag always present and always winning over caller metadata — `listOwned` /
+ *  orphan reconciliation scope on it, so a clobbered or dropped executor tag
+ *  makes the sandbox invisible to cleanup. When metadata overflows the cap,
+ *  keep executor + the lexicographically-first 4 metadata keys, so what gets
+ *  dropped is deterministic rather than dependent on object insertion order. */
+export declare const VERCEL_MAX_TAGS = 5;
+export declare function buildVercelTags(metadata: Record<string, string>): Record<string, string>;
+export declare const vercelProviderDef: SandboxProviderDef;

package/dist/sandbox/registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Sandbox provider registry — creates and manages isolated execution
+ * environments across every registered provider, and owns the ONE sandbox
+ * retry policy. Providers: "vercel" (Vercel Sandbox), "e2b" (E2B),
+ * "e2b-desktop" (E2B Desktop). Each provider validates its required env vars
+ * at creation time.
+ */
+import type { SandboxProvider } from "../types/sandbox.js";
+import type { SandboxCreateOpts, SandboxProviderDef, OwnedSandbox } from "./provider-def.js";
+export type SandboxProviderName = "vercel" | "e2b" | "e2b-desktop";
+export declare const SANDBOX_PROVIDERS: Record<string, SandboxProviderDef>;
+/** Provision a sandbox for the named provider. */
+export declare function createSandbox(provider: SandboxProviderName, opts: SandboxCreateOpts): Promise<SandboxProvider>;
+/** Reconnect to an existing sandbox by provider + provider-native sandbox ID. */
+export declare function reconnectSandbox(provider: SandboxProviderName, sandboxId: string): Promise<SandboxProvider>;
+/** Delete a snapshot by id on the named provider. No live sandbox needed. */
+export declare function deleteSandboxSnapshot(provider: SandboxProviderName, snapshotId: string): Promise<void>;
+/**
+ * Does `snapshotId` resolve on the named provider for this account? A cheap
+ * metadata lookup — never provisions a sandbox. `true` = resolves, `false` =
+ * provider says it does not exist. Transport/credential errors propagate (an
+ * indeterminate result is not "missing"). Used at server boot to validate the
+ * platform base snapshots the default templates boot from.
+ */
+export declare function snapshotResolves(provider: SandboxProviderName, snapshotId: string): Promise<boolean>;
+/**
+ * Current active-sandbox count per configured provider, for quota gauges.
+ * Skips providers whose required env isn't set or which don't implement
+ * `getActiveCount`. Errors are surfaced per-provider so one flaky provider
+ * doesn't silence the rest.
+ */
+export type SandboxQuotaResult = Partial<Record<SandboxProviderName, number | Error>>;
+export declare function getSandboxQuotas(): Promise<SandboxQuotaResult>;
+/**
+ * List every alive sandbox owned by this fleet, across all configured
+ * providers — the orphan-reconciler SoT. Providers without `listOwned`
+ * or missing env are skipped. Errors propagate per-provider so one flaky
+ * provider doesn't silence the rest.
+ */
+export type OwnedSandboxResult = Partial<Record<SandboxProviderName, OwnedSandbox[] | Error>>;
+export declare function listOwnedSandboxes(): Promise<OwnedSandboxResult>;
+/** Kill a sandbox by provider + native ID. Used by the orphan reconciler. */
+export declare function killSandboxById(provider: SandboxProviderName, sandboxId: string): Promise<void>;
+/** Kill all sandboxes across all registered providers. Call at startup to clean up after crashes. */
+export declare function killAllSandboxes(onError?: (provider: SandboxProviderName, err: unknown) => void): Promise<void>;

package/dist/sandbox/sizes.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Sandbox machine sizes + the E2B template aliases derived from them.
+ *
+ * A coarse hardware knob that maps to provider machine specs at create time:
+ * Vercel honours it natively via `resources.vcpus`; E2B sizing is baked into
+ * the template, so on E2B a size resolves to a pre-built per-size template.
+ */
+/** Sandbox hardware SKU. Named for the actual machine spec (vCPU + RAM) rather
+ *  than abstract t-shirt sizes. Memory is always 2048 MB per vCPU:
+ *    2vcpu-4gb   =  2 vCPU /  4 GiB  (Vercel's own default machine)
+ *    4vcpu-8gb   =  4 vCPU /  8 GiB
+ *    8vcpu-16gb  =  8 vCPU / 16 GiB  (per-sandbox ceiling on STANDARD accounts —
+ *                                     probed live: 16 & 32 vCPU 400 on dev)
+ *    32vcpu-64gb = 32 vCPU / 64 GiB  (ENTERPRISE ONLY — standard accounts reject >8 vCPU) */
+export type SandboxSize = "2vcpu-4gb" | "4vcpu-8gb" | "8vcpu-16gb" | "32vcpu-64gb";
+/** SKU → Vercel vCPU count (RAM follows at 2048 MB/vCPU). */
+export declare const SANDBOX_VCPUS: Record<SandboxSize, number>;
+/** SDK fallback size when neither the caller nor the deployment specifies one.
+ *  Deliberately conservative — the OPERATIONAL default is the server's
+ *  `SANDBOX_DEFAULT_SIZE` env var (now also `2vcpu-4gb`). Keeping the default
+ *  small matters because Vercel rate-limits creation by vCPUs-per-window
+ *  (`api-sandboxes-vcpus-creation`); a large default 429s bursty/simultaneous
+ *  creates. Workloads that need more RAM/CPU declare `resources.size` on the
+ *  workflow rather than inflating the default for everyone. */
+export declare const DEFAULT_SANDBOX_SIZE: SandboxSize;
+/** The E2B sizes we pre-build a template for. E2B sizing is template-baked
+ *  (no per-create cpu/mem knob), so honouring `resources.size` on E2B means
+ *  ONE pre-built template per size. `32vcpu-64gb` is absent (E2B has no
+ *  >8-vCPU equivalent). `8vcpu-16gb` is also absent: it needs 16 GiB RAM, but
+ *  the E2B account caps memory at 8 GiB (`Template.build` 400s with
+ *  "Memory can't be higher than 8192 MiB"). Add it back here (and rebuild the
+ *  templates) only once the account's memory limit is raised. The register/
+ *  invoke guards reject an unsupported E2B size before it can reach here. */
+export declare const E2B_TEMPLATE_SIZES: readonly SandboxSize[];
+/** Is `size` one E2B can be built/booted at? `32vcpu-64gb` (no >8-vCPU E2B
+ *  equivalent) and `8vcpu-16gb` (exceeds the account's 8 GiB memory cap) are
+ *  not — the guards lean on this so the "no E2B equivalent" decision lives in
+ *  exactly one place. */
+export declare function isE2bSupportedSize(size: SandboxSize): boolean;
+/** Machine spec for a SandboxSize, in the shape `Template.build` wants. RAM is
+ *  always 2048 MB/vCPU, matching the size name + Vercel parity
+ *  (`SANDBOX_VCPUS` × 2048). Used by `infra/e2b-template/build.ts` to stamp the
+ *  per-size base + agent-env templates. */
+export declare function e2bMachineSpec(size: SandboxSize): {
+    cpuCount: number;
+    memoryMB: number;
+};
+/** Stable E2B template ALIAS for the platform base at a given size
+ *  (`agent-compose-base-<size>`). Aliases — not snapshot ids — so the refs are
+ *  multi-account-clean: the same string resolves in any E2B account that built
+ *  the templates. Built by `infra/e2b-template/build.ts`; the E2B provider
+ *  boots this when a run on E2B declares no explicit `bootFrom`/template. */
+export declare function e2bBaseTemplate(size: SandboxSize): string;
+/** Stable E2B template ALIAS for the agent runtime (base + claude binary) at a
+ *  given size (`agent-env-<size>`). The agent default templates boot from this
+ *  via `bootFrom: { snapshotId: e2bAgentEnvTemplate(size) }`. Multi-account-clean
+ *  for the same reason as `e2bBaseTemplate`. */
+export declare function e2bAgentEnvTemplate(size: SandboxSize): string;
+/** Is `id` one of the platform-managed E2B template aliases — a
+ *  `agent-compose-base-<size>` or `agent-env-<size>` for a supported size?
+ *
+ *  These are stable, platform-built, multi-account-clean strings (NOT tenant
+ *  captures), so any workflow may boot from them: the same alias resolves to
+ *  the same platform base in every account, and there is no tenant data behind
+ *  it to leak. The dispatch snapshot gate uses this to vouch a platform E2B
+ *  boot alias without it having to be a team-owned capture or a published
+ *  template's bootFrom. */
+export declare function isPlatformE2bTemplateAlias(id: string): boolean;