@tangle-network/agent-app 0.62.1 → 0.62.3

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.
@@ -452,6 +452,21 @@ function causeChain(error) {
452
452
  function plannedHostRestart(error) {
453
453
  return causeChain(error).some((cause) => cause.code === "HOST_AGENT_RESTARTING" && cause.status === 503);
454
454
  }
455
+ async function readDuringPlannedHostRestart(read, deadline) {
456
+ let waited = false;
457
+ for (; ; ) {
458
+ try {
459
+ return { value: await read(), waited };
460
+ } catch (error) {
461
+ if (!plannedHostRestart(error)) throw error;
462
+ const hint = error.retryAfterMs;
463
+ const delay = typeof hint === "number" && Number.isFinite(hint) && hint > 0 ? hint : sandboxTransientBackoffMs(1);
464
+ if (Date.now() + delay >= deadline) throw error;
465
+ waited = true;
466
+ await new Promise((resolve) => setTimeout(resolve, delay));
467
+ }
468
+ }
469
+ }
455
470
  function status(value) {
456
471
  if (typeof value === "number") return value;
457
472
  if (typeof value === "string" && /^\d{3}$/.test(value)) return Number(value);
@@ -557,8 +572,9 @@ export {
557
572
  SANDBOX_TRANSIENT_DEADLINE_MS,
558
573
  sandboxTransientBackoffMs,
559
574
  plannedHostRestart,
575
+ readDuringPlannedHostRestart,
560
576
  classifySandboxTransientFailure,
561
577
  SandboxTransientDeadlineError,
562
578
  retrySandboxTransient
563
579
  };
564
- //# sourceMappingURL=chunk-4MD5PS4F.js.map
580
+ //# sourceMappingURL=chunk-PK65B6HP.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/sandbox/recovery.ts","../src/sandbox/diagnostics.ts","../src/sandbox/transient-failure.ts"],"sourcesContent":["/**\n * What an app does after the platform hands back a sandbox it cannot use.\n *\n * `replaceUnbringableBox` (see `./index`) decides whether to abandon a dead box.\n * This decides everything around that: which box key the next attempt uses,\n * whether the old box's snapshot is safe to restore from, whether an owner has\n * to confirm the loss first, and what the person waiting is told. It is\n * bookkeeping, not I/O — the app supplies storage through\n * {@link WorkspaceSandboxRecoveryStore}.\n *\n * ── Why the tables ──────────────────────────────────────────────────────────\n * Every fact about an action or a code lives in ACTIONS/CODES below, and the\n * types are DERIVED from those tables. That is deliberate, and it is the whole\n * reliability argument for this module.\n *\n * The hand-maintained alternative — a union type plus a separate `x === 'a' ||\n * x === 'b' || …` list per question — silently drops anything not on the list.\n * A recovery recorded under an unlisted action is written to storage, read\n * back, discarded as malformed, and the workspace re-provisions the box it just\n * abandoned. Nothing throws. The fix looks correct, ships, and does nothing.\n * That failure was hit twice inside one change before this module existed.\n *\n * With the tables, adding an action or code is a compile error until every\n * question about it is answered. There is no list to forget.\n */\n\n/** The box exists and still holds unsnapshotted state, so discarding it is an\n * owner's decision, not the runtime's. */\nexport const EGRESS_PROXY_RECOVERY_REQUIRED = 'EGRESS_PROXY_RECOVERY_REQUIRED'\nexport const EGRESS_PROXY_RECOVERY_PHASE = 'egress_proxy_recovery'\n/** The platform no longer has the box. Nothing to confirm, delete, or restore. */\nexport const WORKSPACE_SANDBOX_MISSING = 'WORKSPACE_SANDBOX_MISSING'\n/** The box exists but its host has no free slot, so it can never be resumed\n * where it is. A replacement can be placed on a host with room. */\nexport const WORKSPACE_SANDBOX_HOST_EXHAUSTED = 'WORKSPACE_SANDBOX_HOST_EXHAUSTED'\n/** The platform ran its own recovery, failed, and asked for a replacement.\n * Covers every way a box ends up unbringable with no more specific cause. */\nexport const WORKSPACE_SANDBOX_UNRECOVERABLE = 'WORKSPACE_SANDBOX_UNRECOVERABLE'\n\nexport const WORKSPACE_SANDBOX_SNAPSHOT_MAX_AGE_MS = 24 * 60 * 60 * 1000\n\n/**\n * Every recovery cause, and the one thing the runtime must know about each:\n * whether the box it names can still be read from.\n *\n * `snapshotUsable: false` is not a preference. A snapshot is addressed by the\n * sandbox it was taken from, so when that sandbox cannot be started the restore\n * fails exactly the way the resume did — and an app that tried it would turn a\n * recoverable workspace into a stuck one.\n */\nconst CODES = {\n [EGRESS_PROXY_RECOVERY_REQUIRED]: { snapshotUsable: true },\n [WORKSPACE_SANDBOX_MISSING]: { snapshotUsable: false },\n [WORKSPACE_SANDBOX_HOST_EXHAUSTED]: { snapshotUsable: false },\n [WORKSPACE_SANDBOX_UNRECOVERABLE]: { snapshotUsable: false },\n} as const\n\nexport type WorkspaceSandboxRecoveryCode = keyof typeof CODES\n\n/**\n * Every recovery action, and whether it means a replacement box has been\n * CHOSEN — the single question that decides which box key the next provisioning\n * attempt uses.\n *\n * `replacementChosen: false` covers the states where a key may be recorded but\n * must not be used yet: an owner has been asked and has not answered, or has\n * answered no. Handing back a key in those states replaces a box the owner\n * declined to lose.\n */\nconst ACTIONS = {\n confirmation_required: { replacementChosen: false, canDecide: true },\n deletion_declined: { replacementChosen: false, canDecide: true },\n replacement_authorized: { replacementChosen: false },\n snapshot_replacement_authorized: { replacementChosen: false },\n replacement_started: { replacementChosen: true, completedAs: 'replacement_completed' },\n replacement_completed: { replacementChosen: true },\n snapshot_replacement_started: { replacementChosen: true, completedAs: 'snapshot_replacement_completed' },\n snapshot_restore_failed: { replacementChosen: true, completedAs: 'snapshot_replacement_completed' },\n snapshot_replacement_completed: { replacementChosen: true },\n missing_replacement_started: { replacementChosen: true, completedAs: 'missing_replacement_completed' },\n missing_replacement_completed: { replacementChosen: true },\n unrecoverable_replacement_started: { replacementChosen: true, completedAs: 'unrecoverable_replacement_completed' },\n unrecoverable_replacement_completed: { replacementChosen: true },\n} as const\n\nexport type WorkspaceSandboxRecoveryAction = keyof typeof ACTIONS\n\nexport type WorkspaceSandboxSnapshotAvailability = 'available' | 'missing' | 'stale'\nexport type WorkspaceSandboxSnapshotFreshness = 'fresh' | 'stale' | 'unknown'\n\n/** A snapshot the app took of a box, addressed by the box it came from. */\nexport interface WorkspaceSandboxSnapshot {\n fromSandboxId: string\n createdAt: string\n [key: string]: unknown\n}\n\nexport interface WorkspaceSandboxSnapshotAssessment<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n availability: WorkspaceSandboxSnapshotAvailability\n freshness: WorkspaceSandboxSnapshotFreshness\n snapshot?: Snapshot\n}\n\nexport interface WorkspaceSandboxRecoveryState<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n code: WorkspaceSandboxRecoveryCode\n sandboxId: string\n detectedAt: string\n snapshot: WorkspaceSandboxSnapshotAssessment<Snapshot>\n action: WorkspaceSandboxRecoveryAction\n replacementBoxKey?: string\n replacementSandboxId?: string\n confirmedAt?: string\n}\n\nexport type WorkspaceSandboxRecoveryDecision = 'replace' | 'decline'\n\n/** Raised when chat cannot continue until an owner decides about the box. */\nexport class WorkspaceSandboxRecoveryRequiredError extends Error {\n readonly code = EGRESS_PROXY_RECOVERY_REQUIRED\n readonly status = 409\n readonly phase = EGRESS_PROXY_RECOVERY_PHASE\n readonly recovery: WorkspaceSandboxRecoveryState\n\n constructor(recovery: WorkspaceSandboxRecoveryState, cause: Error) {\n super(workspaceSandboxRecoveryMessage(recovery), { cause })\n this.name = 'WorkspaceSandboxRecoveryRequiredError'\n this.recovery = recovery\n }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null\n}\n\nfunction asNonEmptyString(value: unknown): string | undefined {\n return typeof value === 'string' && value.trim().length > 0 ? value : undefined\n}\n\n/** Walk `cause` and `errors` breadth-first, cycle-safe. */\nfunction errorChain(error: unknown): unknown[] {\n const pending = [error]\n const visited = new Set<unknown>()\n const chain: unknown[] = []\n\n while (pending.length > 0) {\n const current = pending.shift()\n if (current === undefined || current === null || visited.has(current)) continue\n visited.add(current)\n chain.push(current)\n if (!isRecord(current)) continue\n if (current.cause !== undefined) pending.push(current.cause)\n if (Array.isArray(current.errors)) pending.push(...current.errors)\n }\n\n return chain\n}\n\nexport function isEgressProxyRecoveryRequiredError(error: unknown): boolean {\n return errorChain(error).some((current) =>\n isRecord(current) && current.code === EGRESS_PROXY_RECOVERY_REQUIRED,\n )\n}\n\nexport function isWorkspaceSandboxSnapshotRestoreError(error: unknown): boolean {\n return errorChain(error).some((current) => {\n const message = current instanceof Error\n ? current.message\n : isRecord(current) && typeof current.message === 'string'\n ? current.message\n : ''\n return /snapshot|fromSnapshot|restore/i.test(message)\n })\n}\n\n/**\n * Judge a snapshot against the box being replaced.\n *\n * Fresh means BOTH that it came from this exact sandbox and that it is inside\n * the age bound — a snapshot from a different box restores someone else's\n * filesystem, which is worse than starting empty.\n */\nexport function assessWorkspaceSandboxSnapshot<Snapshot extends WorkspaceSandboxSnapshot>(\n snapshot: Snapshot | undefined,\n sandboxId: string,\n now = Date.now(),\n): WorkspaceSandboxSnapshotAssessment<Snapshot> {\n if (!snapshot) return { availability: 'missing', freshness: 'unknown' }\n\n const createdAt = Date.parse(snapshot.createdAt)\n const ageMs = now - createdAt\n const isFresh = snapshot.fromSandboxId === sandboxId\n && Number.isFinite(createdAt)\n && ageMs >= 0\n && ageMs <= WORKSPACE_SANDBOX_SNAPSHOT_MAX_AGE_MS\n\n return isFresh\n ? { availability: 'available', freshness: 'fresh', snapshot }\n : { availability: 'stale', freshness: 'stale', snapshot }\n}\n\nfunction isSnapshotAssessment(value: unknown): value is WorkspaceSandboxSnapshotAssessment {\n if (!isRecord(value)) return false\n const availability = value.availability\n const freshness = value.freshness\n return (availability === 'available' || availability === 'missing' || availability === 'stale')\n && (freshness === 'fresh' || freshness === 'stale' || freshness === 'unknown')\n}\n\nexport function isWorkspaceSandboxRecoveryAction(\n value: unknown,\n): value is WorkspaceSandboxRecoveryAction {\n return typeof value === 'string' && Object.hasOwn(ACTIONS, value)\n}\n\nexport function isWorkspaceSandboxRecoveryCode(\n value: unknown,\n): value is WorkspaceSandboxRecoveryCode {\n return typeof value === 'string' && Object.hasOwn(CODES, value)\n}\n\nexport function isWorkspaceSandboxRecoveryState(\n value: unknown,\n): value is WorkspaceSandboxRecoveryState {\n if (!isRecord(value)) return false\n return isWorkspaceSandboxRecoveryCode(value.code)\n && !!asNonEmptyString(value.sandboxId)\n && !!asNonEmptyString(value.detectedAt)\n && isSnapshotAssessment(value.snapshot)\n && isWorkspaceSandboxRecoveryAction(value.action)\n}\n\nexport function workspaceSandboxRecoveryFromError(\n error: unknown,\n): WorkspaceSandboxRecoveryState | undefined {\n for (const current of errorChain(error)) {\n if (!isRecord(current) || !isWorkspaceSandboxRecoveryState(current.recovery)) continue\n return current.recovery\n }\n return undefined\n}\n\n/** What to tell the person waiting. Never names the product, so an app can\n * surface it verbatim. */\nexport function workspaceSandboxRecoveryMessage(recovery: WorkspaceSandboxRecoveryState): string {\n if (recovery.code === WORKSPACE_SANDBOX_MISSING) {\n return 'The sandbox behind this workspace no longer exists on the platform. A replacement is being provisioned and your saved work is restored into it.'\n }\n if (!CODES[recovery.code].snapshotUsable) {\n return 'The sandbox behind this workspace could not be started again. A replacement is being provisioned and your saved work is restored into it.'\n }\n if (recovery.action === 'deletion_declined') {\n return 'Sandbox recovery remains paused because replacement was declined. The stopped sandbox has not been deleted.'\n }\n if (recovery.action === 'confirmation_required') {\n const snapshotReason = recovery.snapshot.availability === 'missing'\n ? 'No restorable sandbox snapshot is available.'\n : 'The available sandbox snapshot is stale.'\n return `Sandbox recovery requires owner confirmation before replacement. ${snapshotReason} The stopped sandbox has not been deleted.`\n }\n if (recovery.action === 'snapshot_restore_failed') {\n return 'Sandbox replacement could not restore its verified snapshot, and an empty fallback was not created because it could lose workspace state.'\n }\n return 'Sandbox recovery is required before chat can continue. The stopped sandbox has not been deleted.'\n}\n\nexport function workspaceSandboxRecoveryRecommendedActions(\n recovery: WorkspaceSandboxRecoveryState,\n): string[] {\n if (!CODES[recovery.code].snapshotUsable) {\n return ['Retry after the replacement sandbox finishes provisioning.']\n }\n if (recovery.action === 'deletion_declined') {\n return ['Keep the stopped sandbox for support or ask a workspace owner to authorize replacement.']\n }\n if (recovery.action === 'confirmation_required') {\n return ['An owner can explicitly replace the sandbox after accepting loss of unsnapshotted sandbox-local changes.']\n }\n if (recovery.action === 'snapshot_restore_failed') {\n return ['Retry snapshot restoration or contact support. An empty replacement is not created automatically.']\n }\n return ['Retry after sandbox recovery completes.']\n}\n\n/** Flat key/value shape for a log line — no nesting, no secrets. */\nexport function workspaceSandboxRecoveryDiagnostic(\n recovery: WorkspaceSandboxRecoveryState,\n): Record<string, string | undefined> {\n return {\n sandboxId: recovery.sandboxId,\n recoveryCode: recovery.code,\n snapshotAvailability: recovery.snapshot.availability,\n snapshotFreshness: recovery.snapshot.freshness,\n selectedRecoveryAction: recovery.action,\n replacementSandboxId: recovery.replacementSandboxId,\n }\n}\n\n/**\n * The box key the next provisioning attempt should use, or undefined to keep\n * using the workspace's own key.\n *\n * Reads {@link ACTIONS} rather than a hand-kept list, because the failure mode\n * of a hand-kept list here is invisible: the key is recorded, silently ignored,\n * and provisioning goes back to the box the app just decided to abandon.\n */\nexport function preferredWorkspaceSandboxRecoveryBoxKey(\n recovery: WorkspaceSandboxRecoveryState | undefined,\n): string | undefined {\n if (!recovery?.replacementBoxKey) return undefined\n return ACTIONS[recovery.action].replacementChosen ? recovery.replacementBoxKey : undefined\n}\n\n/** Whether the replacement should be restored from the old box's snapshot. */\nexport function shouldRestoreWorkspaceSandboxRecovery(\n recovery: WorkspaceSandboxRecoveryState | undefined,\n): boolean {\n if (!recovery) return false\n if (!CODES[recovery.code].snapshotUsable) return false\n return !!preferredWorkspaceSandboxRecoveryBoxKey(recovery)\n && recovery.snapshot.availability === 'available'\n}\n\n/** One current recovery per workspace, stored by the application.\n * Concurrent writers should supply compareAndSet. Legacy write-only stores\n * remain supported but must serialize decisions and completion themselves. */\nexport interface WorkspaceSandboxRecoveryStore<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n read: (workspaceId: string) => Promise<WorkspaceSandboxRecoveryState<Snapshot> | undefined>\n write: (workspaceId: string, recovery: WorkspaceSandboxRecoveryState<Snapshot>) => Promise<void>\n /** Commit a transition only while the exact recovery read above remains current. */\n compareAndSet?: (\n workspaceId: string,\n expected: WorkspaceSandboxRecoveryState<Snapshot>,\n recovery: WorkspaceSandboxRecoveryState<Snapshot>,\n ) => Promise<boolean>\n}\n\nexport interface WorkspaceSandboxRecoveryManager<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n read: WorkspaceSandboxRecoveryStore<Snapshot>['read']\n record: WorkspaceSandboxRecoveryStore<Snapshot>['write']\n /** Only a pending/declined recovery for this sandbox accepts a new decision.\n * Replacement requires a fresh, nonblank key; decline needs no key. */\n decide: (args: {\n workspaceId: string\n sandboxId: string\n } & (\n | { decision: 'replace'; replacementBoxKey: string }\n | { decision: 'decline'; replacementBoxKey?: string }\n )) => Promise<WorkspaceSandboxRecoveryState<Snapshot> | undefined>\n /** Only a started replacement with a chosen key may be completed. */\n complete: (args: {\n workspaceId: string\n replacementSandboxId: string\n /** The key used by this provisioning attempt, not a freshly read successor. */\n replacementBoxKey?: string\n }) => Promise<WorkspaceSandboxRecoveryState<Snapshot> | undefined>\n}\n\n/** Bind canonical recovery policy to the application's existing storage. */\nexport function createWorkspaceSandboxRecoveryManager<Snapshot extends WorkspaceSandboxSnapshot>(\n store: WorkspaceSandboxRecoveryStore<Snapshot>,\n): WorkspaceSandboxRecoveryManager<Snapshot> {\n type State = WorkspaceSandboxRecoveryState<Snapshot>\n async function transition(workspaceId: string, expected: State, next: State): Promise<State> {\n if (store.compareAndSet) {\n if (!await store.compareAndSet(workspaceId, expected, next))\n throw new Error('Sandbox recovery changed; reload before retrying its transition')\n } else {\n await store.write(workspaceId, next)\n }\n return next\n }\n\n return {\n read: workspaceId => store.read(workspaceId),\n record: (workspaceId, recovery) => store.write(workspaceId, recovery),\n async decide({ workspaceId, sandboxId, decision, replacementBoxKey }) {\n const current = await store.read(workspaceId)\n if (!current || current.sandboxId !== sandboxId || !('canDecide' in ACTIONS[current.action])) return undefined\n if (decision === 'replace' && !asNonEmptyString(replacementBoxKey))\n throw new Error('Sandbox replacement authorization requires a fresh replacement box key')\n return transition(workspaceId, current, {\n ...current,\n action: decision === 'replace'\n ? (current.snapshot.availability === 'available' ? 'snapshot_replacement_authorized' : 'replacement_authorized')\n : 'deletion_declined',\n confirmedAt: new Date().toISOString(),\n ...(decision === 'replace' ? { replacementBoxKey } : {}),\n })\n },\n async complete({ workspaceId, replacementSandboxId, replacementBoxKey }) {\n const current = await store.read(workspaceId)\n if (!current || !asNonEmptyString(current.replacementBoxKey)) return undefined\n if (replacementBoxKey !== undefined && current.replacementBoxKey !== replacementBoxKey) return undefined\n const policy = ACTIONS[current.action]\n if (!('completedAs' in policy)) return undefined\n if (!asNonEmptyString(replacementSandboxId)) throw new Error('A replacement sandbox id is required')\n return transition(workspaceId, current, { ...current, action: policy.completedAs, replacementSandboxId })\n },\n }\n}\n\n/** Every declared action, for exhaustiveness tests in apps and here. */\nexport const WORKSPACE_SANDBOX_RECOVERY_ACTIONS = Object.keys(\n ACTIONS,\n) as readonly WorkspaceSandboxRecoveryAction[]\n\n/** Every declared cause. */\nexport const WORKSPACE_SANDBOX_RECOVERY_CODES = Object.keys(\n CODES,\n) as readonly WorkspaceSandboxRecoveryCode[]\n","/**\n * Read a sandbox provisioning failure without leaking what it carries.\n *\n * Provisioning errors arrive as deep `cause` chains from the sandbox API, the\n * runtime sidecar, and the app's own vault code, and they routinely carry\n * bearer tokens and signed URLs in their messages. Every app on this shell\n * needs the same three things from one: a redacted shape it can log, a\n * classification it can act on, and a sentence it can show a person. Before\n * this module each app either wrote its own or — far more often — wrote none,\n * and surfaced the raw error or a generic apology.\n *\n * The classifiers are deliberately narrow. `isSandboxApiSandboxMissingFailure`\n * does not fire on a 404 from inside a live box; `isSandboxHostCapacityFailure`\n * does not fire on capacity wording from any origin but the sandbox API. A\n * classifier that over-matches turns a transient failure into a box deletion.\n */\nimport { EGRESS_PROXY_RECOVERY_REQUIRED } from './recovery'\n\nconst SAFE_ERROR_FIELDS = [\n 'code',\n 'status',\n 'phase',\n 'endpoint',\n 'origin',\n 'retryAfterMs',\n 'sidecarVersion',\n 'containerImage',\n] as const\n\nexport interface SafeSandboxErrorCause {\n name?: string\n message?: string\n code?: string | number\n status?: string | number\n phase?: string\n endpoint?: string\n origin?: string\n retryAfterMs?: number\n sidecarVersion?: string\n containerImage?: string\n}\n\nexport interface SafeSandboxErrorDiagnostics {\n message: string\n causes: SafeSandboxErrorCause[]\n truncated: boolean\n truncatedAtDepth?: number\n cycle: boolean\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null\n}\n\nfunction asSafeScalar(value: unknown): string | number | undefined {\n if (typeof value === 'string' && value.length > 0) return redactDiagnosticText(value)\n if (typeof value === 'number' && Number.isFinite(value)) return value\n return undefined\n}\n\nfunction redactDiagnosticText(value: string): string {\n const secretKeyPattern = '(?:(?:[A-Z0-9]+_)*(?:api_?key|auth_?token|access_?token|refresh_?token|key|token|password|secret|credential)|apiKey|authToken|accessToken|refreshToken)'\n return value\n .replace(/(['\"]authorization['\"]\\s*:\\s*)(['\"])[^'\"]*\\2/gi, '$1$2[REDACTED]$2')\n .replace(/\\b(authorization\\s*[:=]\\s*)(['\"])[^'\"]*\\2/gi, '$1$2[REDACTED]$2')\n .replace(/\\b(authorization\\s*[:=]\\s*)Digest\\b[^;}\\n]*(?:\\r?\\n[ \\t]+[^;}\\n]*)*/gi, '$1[REDACTED]')\n .replace(/\\b(authorization\\s*[:=]\\s*)(?:Basic|Bearer|Negotiate)\\s+[^\\s;,&}\\n]+(?:\\r?\\n[ \\t]+[^\\s;,&}\\n]+)*/gi, '$1[REDACTED]')\n .replace(new RegExp(`\\\\b(authorization\\\\s*[:=]\\\\s*)(?!(?:Basic|Bearer|Digest|Negotiate)\\\\b)([A-Za-z][A-Za-z0-9._-]+)\\\\s+(?!(?:authorization|${secretKeyPattern})\\\\s*[:=]|['\"](?:authorization|${secretKeyPattern})['\"]\\\\s*:)([^}\\\\n]*(?:\\\\r?\\\\n[ \\\\t]+[^}\\\\n]*)*)`, 'gi'), (_match, prefix: string, _scheme: string, valuePart: string) => {\n if (valuePart.includes(';') || /\\r?\\n[ \\t]+/.test(valuePart)) return `${prefix}[REDACTED]`\n const tokenMatch = valuePart.match(/^\\S+(.*)$/)\n return `${prefix}[REDACTED]${tokenMatch?.[1] ?? ''}`\n })\n .replace(/\\b(authorization\\s*[:=]\\s*)[A-Za-z][\\w.-]+\\s+[^\\s;,&}\\n]+(?=[;&}\\n]|$)/gi, '$1[REDACTED]')\n .replace(/\\b(authorization\\s*[:=]\\s*)(?!\\[REDACTED\\])[^'\"\\s&}]+(?:[;,][^'\"\\s&}]+)*/gi, '$1[REDACTED]')\n .replace(/\\bBearer\\s+[A-Za-z0-9._~+/-]+=*/gi, 'Bearer [REDACTED]')\n .replace(/\\bsk-[A-Za-z0-9_-]{6,}\\b/g, 'sk-[REDACTED]')\n .replace(\n /([?&][^=&#\\s]*(?:token|key|secret|password|authorization)[^=&#\\s]*=)[^&#\\s]+/gi,\n '$1[REDACTED]',\n )\n .replace(\n new RegExp(`(['\"])(${secretKeyPattern})\\\\1\\\\s*:\\\\s*(['\"])[^'\"]+\\\\3`, 'gi'),\n '$1$2$1:$3[REDACTED]$3',\n )\n .replace(\n new RegExp(`\\\\b(${secretKeyPattern})\\\\s*([:=])(\\\\s*)(['\"]?)(?!Bearer\\\\b)[^'\"\\\\s;,&}]+(?:[;,]\\\\s*[^'\"\\\\s;,&}]+)*`, 'gi'),\n '$1$2$3$4[REDACTED]',\n )\n}\n\nfunction readMessage(value: unknown): string | undefined {\n if (value instanceof Error) return redactDiagnosticText(value.message)\n if (typeof value === 'string' && value.length > 0) return redactDiagnosticText(value)\n if (typeof value === 'number' && Number.isFinite(value)) return String(value)\n if (typeof value === 'boolean') return String(value)\n if (!isRecord(value)) return undefined\n const message = value.message\n return typeof message === 'string' && message.length > 0 ? redactDiagnosticText(message) : undefined\n}\n\nfunction readName(value: unknown): string | undefined {\n if (value instanceof Error) return redactDiagnosticText(value.name)\n if (!isRecord(value)) return undefined\n const name = value.name\n return typeof name === 'string' && name.length > 0 ? redactDiagnosticText(name) : undefined\n}\n\nfunction readCause(value: unknown): unknown {\n if (!isRecord(value)) return undefined\n return value.cause\n}\n\nexport function serializeSandboxProvisioningError(\n error: unknown,\n options: { maxDepth?: number } = {},\n): SafeSandboxErrorDiagnostics {\n const maxDepth = options.maxDepth ?? 6\n const causes: SafeSandboxErrorCause[] = []\n const seen = new Set<unknown>()\n let truncatedAtDepth: number | undefined\n let cycle = false\n\n let current: unknown = error\n let depth = 0\n for (; depth < maxDepth && current !== undefined && current !== null; depth += 1) {\n if (seen.has(current)) {\n cycle = true\n causes.push({\n name: 'CauseChainCycle',\n message: `cause chain cycle detected after ${depth} entries`,\n })\n break\n }\n if (isRecord(current)) seen.add(current)\n\n const cause: SafeSandboxErrorCause = {}\n const name = readName(current)\n const message = readMessage(current)\n if (name) cause.name = name\n if (message) cause.message = message\n\n if (isRecord(current)) {\n for (const field of SAFE_ERROR_FIELDS) {\n const safeValue = asSafeScalar(current[field])\n if (safeValue !== undefined) {\n Object.assign(cause, { [field]: safeValue })\n }\n }\n }\n\n if (Object.keys(cause).length > 0) causes.push(cause)\n current = readCause(current)\n }\n\n if (!cycle && isRecord(current) && seen.has(current)) {\n cycle = true\n causes.push({\n name: 'CauseChainCycle',\n message: `cause chain cycle detected after ${depth} entries`,\n })\n } else if (current !== undefined && current !== null && depth >= maxDepth) {\n truncatedAtDepth = maxDepth\n causes.push({\n name: 'CauseChainTruncated',\n message: `cause chain truncated after ${maxDepth} entries`,\n })\n }\n\n return {\n message: readMessage(error) ?? 'Sandbox unavailable',\n causes,\n truncated: truncatedAtDepth !== undefined,\n truncatedAtDepth,\n cycle,\n }\n}\n\nexport function formatSandboxProvisioningSupportDetails(\n diagnostics: SafeSandboxErrorDiagnostics,\n): string {\n const actionableCause = diagnostics.causes.find((cause) =>\n cause.code !== undefined\n || cause.status !== undefined\n || cause.phase !== undefined\n || cause.endpoint !== undefined\n || cause.origin !== undefined\n || cause.retryAfterMs !== undefined\n || cause.sidecarVersion !== undefined\n || cause.containerImage !== undefined,\n ) ?? diagnostics.causes[1]\n\n if (!actionableCause) return 'Support details: no nested sandbox cause details were available.'\n\n const details = [\n typeof actionableCause.name === 'string' ? redactDiagnosticText(actionableCause.name) : undefined,\n actionableCause.code !== undefined ? `code=${actionableCause.code}` : undefined,\n actionableCause.status !== undefined ? `status=${actionableCause.status}` : undefined,\n actionableCause.phase !== undefined ? `phase=${redactDiagnosticText(actionableCause.phase)}` : undefined,\n actionableCause.endpoint !== undefined ? `endpoint=${redactDiagnosticText(actionableCause.endpoint)}` : undefined,\n actionableCause.origin !== undefined ? `origin=${redactDiagnosticText(actionableCause.origin)}` : undefined,\n actionableCause.retryAfterMs !== undefined ? `retryAfterMs=${actionableCause.retryAfterMs}` : undefined,\n actionableCause.sidecarVersion !== undefined ? `sidecarVersion=${redactDiagnosticText(actionableCause.sidecarVersion)}` : undefined,\n actionableCause.containerImage !== undefined ? `containerImage=${redactDiagnosticText(actionableCause.containerImage)}` : undefined,\n typeof actionableCause.message === 'string' ? redactDiagnosticText(actionableCause.message) : undefined,\n ].filter(Boolean)\n\n if (details.length === 0) return 'Support details: no nested sandbox cause details were available.'\n return `Support details: ${details.join('; ')}`\n}\n\nexport function isSandboxAuthFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n const code = typeof cause.code === 'string' ? cause.code.toUpperCase() : undefined\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n const name = typeof cause.name === 'string' ? cause.name.toLowerCase() : ''\n const message = typeof cause.message === 'string' ? cause.message.toLowerCase() : ''\n\n return code === 'AUTH_ERROR'\n || status === 401\n || name.includes('autherror')\n || message.includes('missing or invalid authentication')\n })\n}\n\n/**\n * True when the Sandbox API refused the caller's bearer: a 401 from any\n * Sandbox API route, including list and query routes such as\n * `/v1/sandboxes?status=stopped`. The caller should invalidate its cached key\n * and mint a new one once.\n *\n * Runtime routes (`/v1/sandboxes/{id}/runtime/...`) are excluded: the box's\n * runtime authentication answers those, and a new Sandbox API key does not fix\n * it. `isSandboxAuthFailure` covers them.\n */\nexport function isSandboxApiBearerAuthFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n if (status !== 401) return false\n if (cause.origin !== 'sandbox-api') return false\n if (typeof cause.endpoint !== 'string') return false\n const endpointPath = sandboxApiEndpointPath(cause.endpoint)\n if (!endpointPath || !/^\\/v1(?:[/?#]|$)/.test(endpointPath)) return false\n return !/^\\/v1\\/sandboxes\\/[^/?#]+\\/runtime(?:[/?#]|$)/.test(endpointPath)\n })\n}\n\n/** Machine-readable code emitted when resume lost the physical box. */\nexport const SANDBOX_BACKING_CONTAINER_MISSING_CODE = 'BACKING_CONTAINER_MISSING' as const\n\n/**\n * Legacy fallback for Sandbox API releases that only returned the nested host\n * 404 text. New callers must use `SANDBOX_BACKING_CONTAINER_MISSING_CODE`.\n */\nexport function isLegacySandboxBackingContainerMissingMessage(message: string): boolean {\n return /host-agent startcontainer failed \\(404\\):/i.test(message)\n && /container not found/i.test(message)\n && /\"code\"\\s*:\\s*\"not_found\"/i.test(message)\n}\n\n/**\n * True when the sandbox API cannot find a sandbox resource or its backing\n * container. The latter arrives as a 500 from resume with a nested host 404.\n *\n * A sandbox id is a cache of where a workspace's box lives, not the workspace's\n * identity: the platform reaps, suspends, and loses boxes as ordinary lifecycle\n * events. Callers use this to discard the dead id and provision a replacement,\n * so the match is deliberately narrow — a 404 from the runtime sidecar\n * (`/runtime/...`, a missing file or session inside a live box) is NOT this.\n */\nexport function isSandboxApiSandboxMissingFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n if (cause.origin !== 'sandbox-api') return false\n if (typeof cause.endpoint !== 'string') return false\n const endpointPath = sandboxApiEndpointPath(cause.endpoint)\n if (!endpointPath) return false\n const sandboxResource = /^\\/v1\\/sandboxes\\/[^/?#]+(?:\\/(?!runtime(?:[/?#]|$))[^?#]*)?(?:[?#].*)?$/.test(endpointPath)\n if (!sandboxResource) return false\n if (status === 404) return true\n\n if (status !== 500 || !/^\\/v1\\/sandboxes\\/[^/?#]+\\/resume(?:[?#].*)?$/.test(endpointPath)) {\n return false\n }\n const code = typeof cause.code === 'string' ? cause.code.toUpperCase() : undefined\n if (code === SANDBOX_BACKING_CONTAINER_MISSING_CODE) return true\n // Older Sandbox API releases returned only the nested host 404. The SDK\n // represented that response as SERVER_ERROR, so keep this exact fallback\n // until those releases are no longer in service.\n if (code !== undefined && code !== 'SERVER_ERROR') return false\n const message = typeof cause.message === 'string' ? cause.message : ''\n return isLegacySandboxBackingContainerMissingMessage(message)\n })\n}\n\n/**\n * True when a resume failed because the host the box is pinned to cannot seat\n * it — the host's slot budget is exhausted, not the box's fault and not\n * something waiting fixes.\n *\n * A box lives on one host. When that host fills, every future resume for every\n * box on it fails identically and permanently, so a workspace whose box landed\n * on a full host is bricked until it is placed somewhere else. Callers use this\n * the same way they use {@link isSandboxApiSandboxMissingFailure}: discard the\n * dead id and provision a replacement, which the orchestrator is free to place\n * on a host with room. The workspace itself is preserved — it lives in the\n * Vault, not in the box's filesystem.\n *\n * Matched on the message because the sandbox API returns a generic\n * `SERVER_ERROR` for it; a dedicated code upstream would replace this.\n */\nexport function isSandboxHostCapacityFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n if (cause.origin !== 'sandbox-api') return false\n if (typeof cause.message !== 'string') return false\n return /host has no available slot|host capacity reservation failed/i.test(cause.message)\n })\n}\n\n/**\n * True when a resume failed on the box's own configuration rather than on\n * anything a retry can change.\n *\n * These are permanent facts about one box. Its egress policy can be missing,\n * or its verified Platform lineage can differ from the current caller. Neither\n * creation-time fact can change on resume, so the box must be replaced.\n *\n * Narrow on purpose. A bare 500 from the sandbox API is transient far more\n * often than not, and treating one as unbringable would delete a healthy box.\n * Matched on the specific unrecoverable phrasing, and only from `sandbox-api`.\n */\nexport function isSandboxBoxConfigFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n if (cause.origin !== 'sandbox-api') return false\n if (cause.code === 'SANDBOX_ATTRIBUTION_MISMATCH') return true\n if (typeof cause.message !== 'string') return false\n return /has no recorded egress policy|cannot rebuild the proxy config/i.test(cause.message)\n })\n}\n\n/**\n * True when the Sandbox API answered a control-plane call with a server error\n * (500, 502, 503 or 504), such as `A sandbox backend did not answer` or\n * `Failed to resume project: fetch failed`. These clear within seconds, so a\n * caller may retry once before surfacing them.\n *\n * Runtime routes are excluded (the box answers those), and so are the narrow\n * failures that need a different action: a missing box, a box whose creation\n * facts no longer hold, and host capacity.\n */\nexport function isSandboxApiTransientFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n if (isSandboxApiSandboxMissingFailure(diagnostics)\n || isSandboxBoxConfigFailure(diagnostics)\n || isSandboxHostCapacityFailure(diagnostics)) return false\n return diagnostics.causes.some((cause) => {\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n if (status !== 500 && status !== 502 && status !== 503 && status !== 504) return false\n if (cause.origin !== 'sandbox-api' || typeof cause.endpoint !== 'string') return false\n const endpointPath = sandboxApiEndpointPath(cause.endpoint)\n if (!endpointPath || !/^\\/v1(?:[/?#]|$)/.test(endpointPath)) return false\n return !/^\\/v1\\/sandboxes\\/[^/?#]+\\/runtime(?:[/?#]|$)/.test(endpointPath)\n })\n}\n\nfunction sandboxApiEndpointPath(endpoint: string): string | null {\n if (endpoint.startsWith('/')) return endpoint\n try {\n const url = new URL(endpoint)\n return `${url.pathname}${url.search}${url.hash}`\n } catch {\n return null\n }\n}\n\nexport function formatSandboxProvisioningUserMessage(\n diagnostics: SafeSandboxErrorDiagnostics,\n): string {\n if (diagnostics.causes.some((cause) => cause.code === EGRESS_PROXY_RECOVERY_REQUIRED)) {\n return 'Sandbox recovery is required before chat can continue. The stopped sandbox has not been deleted.'\n }\n\n // The sandbox itself is reachable — copying the Vault into it is what did not\n // finish. Saying \"the service is unavailable\" sends people to inspect\n // infrastructure that is healthy.\n if (diagnostics.causes.some((cause) => cause.code === 'vault.hydration_incomplete')) {\n return 'I couldn\\'t finish copying your Vault into the sandbox, so I stopped rather than work from a partial copy. The copy resumes where it left off — try again in a moment.'\n }\n\n if (isSandboxApiTransientFailure(diagnostics)) {\n return 'The sandbox service didn\\'t answer just now. Send your message again in a moment.'\n }\n\n if (isSandboxApiBearerAuthFailure(diagnostics)) {\n return 'I\\'m unable to reconnect to the sandbox because its sandbox API credential was rejected. Another request may have rotated the bearer used for this operation.'\n }\n\n if (isSandboxAuthFailure(diagnostics)) {\n return 'I\\'m unable to reconnect to the sandbox because its runtime authentication failed. This can happen when an existing sandbox is reused with stale credentials.'\n }\n\n if (diagnostics.causes.some((cause) => (\n cause.code === 'PAYLOAD_TOO_LARGE'\n || cause.code === 'FILE_TOO_LARGE'\n || cause.status === 413\n || cause.status === '413'\n ))) {\n // Profile and workspace files reach the box through writeProfileFilesToBox;\n // naming an attachment there sends people looking for one they never sent.\n if (diagnostics.causes.some((cause) => cause.message?.startsWith('writeProfileFilesToBox'))) {\n return 'A workspace file is too large to copy into the sandbox. The support details name the file.'\n }\n return 'An attachment is too large for the sandbox to accept. Use a smaller file and try again.'\n }\n\n // Matched by code, not bare 429: the sidecar's rate limiters also answer\n // 429, and those are not attachment-staging pressure.\n if (diagnostics.causes.some((cause) => cause.code === 'UPLOAD_BUDGET_EXHAUSTED')) {\n return 'Too much attachment data is staged in the sandbox at once. Retry shortly.'\n }\n\n return 'I\\'m unable to connect to the sandbox right now. Send your message again in a moment; if it keeps failing, share the support details with the team.'\n}\n","/**\n * Sandbox failures that clear on their own, and how long to wait them out.\n *\n * Both callers that meet them use this one policy: the run dispatch, which\n * resends the same execution, and the completion Workflow, which observes it.\n * A box restarting under load answers \"filesystem incarnation is not ready\"\n * for minutes (8 minutes for GTM's busiest box on 2026-10-10, 10:37 to 10:45\n * UTC), and its gateway refuses dispatches with 502 or 503 while it does.\n * Failing on the first such answer lost those turns; retrying forever would\n * hold a lock on a box that never comes back. The policy backs off from 5 s\n * to a 60 s ceiling and gives up after 15 minutes.\n */\nimport { isSandboxApiTransientFailure, serializeSandboxProvisioningError } from './diagnostics'\n\nexport type SandboxTransientFailureCode =\n /** The box is running but its filesystem incarnation is not ready yet. */\n | 'sandbox.filesystem_not_ready'\n /** The sandbox gateway answered the run dispatch with 502, 503 or 504. */\n | 'sandbox.dispatch_refused'\n /** A Sandbox API control-plane call failed with a server error. */\n | 'sandbox.control_plane_transient'\n\nexport interface SandboxTransientFailure {\n code: SandboxTransientFailureCode\n message: string\n}\n\n/** How long a transient failure may last before the caller fails. */\nexport const SANDBOX_TRANSIENT_DEADLINE_MS = 15 * 60_000\n\n/** Wait before retry `attempt` (1-based): 5 s doubling to a 60 s ceiling. */\nexport function sandboxTransientBackoffMs(attempt: number): number {\n return Math.min(60_000, 5_000 * 2 ** Math.max(0, attempt - 1))\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === 'object' ? value as Record<string, unknown> : undefined\n}\n\nfunction causeChain(error: unknown): Record<string, unknown>[] {\n const chain: Record<string, unknown>[] = []\n let current = record(error)\n for (let depth = 0; current && depth < 8 && !chain.includes(current); depth += 1) {\n chain.push(current)\n current = record(current.cause)\n }\n return chain\n}\n\n/** A planned host-agent swap leaves the sandbox alive; an ordinary probe failure is not that evidence. */\nexport function plannedHostRestart(error: unknown): boolean {\n return causeChain(error).some(cause => cause.code === 'HOST_AGENT_RESTARTING' && cause.status === 503)\n}\n\nfunction status(value: unknown): number | undefined {\n if (typeof value === 'number') return value\n if (typeof value === 'string' && /^\\d{3}$/.test(value)) return Number(value)\n return undefined\n}\n\nconst FILESYSTEM_NOT_READY = /filesystem incarnation is not ready/i\nconst RUN_DISPATCH_ENDPOINT = /\\/runtime\\/agents\\/run\\/stream(?:[?#]|$)/\nconst RUN_DISPATCH_REFUSAL_MESSAGE = /\\/runtime\\/agents\\/run\\/stream: error code: (50[234])\\b/\n\n/** The typed transient failure `error` carries anywhere in its cause chain, or null. */\nexport function classifySandboxTransientFailure(error: unknown): SandboxTransientFailure | null {\n for (const cause of causeChain(error)) {\n const message = typeof cause.message === 'string' ? cause.message : ''\n if (cause.code === 'FILESYSTEM_INCARNATION_NOT_READY' || FILESYSTEM_NOT_READY.test(message)) {\n return { code: 'sandbox.filesystem_not_ready', message: 'Sandbox filesystem incarnation is not ready' }\n }\n const code = status(cause.status)\n const endpoint = typeof cause.endpoint === 'string' ? cause.endpoint : ''\n const refusal = (code === 502 || code === 503 || code === 504) && RUN_DISPATCH_ENDPOINT.test(endpoint)\n ? code\n : RUN_DISPATCH_REFUSAL_MESSAGE.exec(message)?.[1]\n if (refusal) {\n return { code: 'sandbox.dispatch_refused', message: `The sandbox gateway refused the run dispatch with ${refusal}` }\n }\n }\n if (isSandboxApiTransientFailure(serializeSandboxProvisioningError(error))) {\n return { code: 'sandbox.control_plane_transient', message: 'A Sandbox API call failed with a server error' }\n }\n return null\n}\n\n/** The error a caller raises when a transient failure outlasted the deadline. */\nexport class SandboxTransientDeadlineError extends Error {\n readonly code: SandboxTransientFailureCode\n readonly firstSeenAt: number\n readonly attempts: number\n\n constructor(failure: SandboxTransientFailure, firstSeenAt: number, attempts: number, cause?: unknown) {\n const minutes = Math.round(SANDBOX_TRANSIENT_DEADLINE_MS / 60_000)\n super(`${failure.message}; it persisted for more than ${minutes} minutes over ${attempts} attempts`, cause === undefined ? undefined : { cause })\n this.name = 'SandboxTransientDeadlineError'\n this.code = failure.code\n this.firstSeenAt = firstSeenAt\n this.attempts = attempts\n }\n}\n\nexport interface SandboxTransientRetryOptions {\n /** Defaults to {@link SANDBOX_TRANSIENT_DEADLINE_MS}. */\n deadlineMs?: number\n now?: () => number\n sleep?: (ms: number, signal?: AbortSignal) => Promise<void>\n signal?: AbortSignal\n onRetry?: (failure: SandboxTransientFailure, attempt: number, delayMs: number) => void\n}\n\nconst defaultSleep = (ms: number, signal?: AbortSignal) => new Promise<void>((resolve, reject) => {\n if (signal?.aborted) return reject(signal.reason)\n const timer = setTimeout(resolve, ms)\n signal?.addEventListener('abort', () => {\n clearTimeout(timer)\n reject(signal.reason)\n }, { once: true })\n})\n\n/**\n * Run `attempt` until it succeeds, it fails with something this policy does\n * not consider transient, or a transient failure outlasts the deadline.\n */\nexport async function retrySandboxTransient<T>(\n attempt: () => Promise<T>,\n options: SandboxTransientRetryOptions = {},\n): Promise<T> {\n const now = options.now ?? Date.now\n const sleep = options.sleep ?? defaultSleep\n const deadlineMs = options.deadlineMs ?? SANDBOX_TRANSIENT_DEADLINE_MS\n let firstSeenAt: number | undefined\n for (let attempts = 1; ; attempts += 1) {\n try {\n return await attempt()\n } catch (error) {\n const failure = classifySandboxTransientFailure(error)\n if (!failure) throw error\n const at = now()\n firstSeenAt ??= at\n const delayMs = sandboxTransientBackoffMs(attempts)\n if (at + delayMs - firstSeenAt > deadlineMs) throw new SandboxTransientDeadlineError(failure, firstSeenAt, attempts, error)\n options.onRetry?.(failure, attempts, delayMs)\n await sleep(delayMs, options.signal)\n }\n }\n}\n"],"mappings":"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","names":["isRecord","status"]}
1
+ {"version":3,"sources":["../src/sandbox/recovery.ts","../src/sandbox/diagnostics.ts","../src/sandbox/transient-failure.ts"],"sourcesContent":["/**\n * What an app does after the platform hands back a sandbox it cannot use.\n *\n * `replaceUnbringableBox` (see `./index`) decides whether to abandon a dead box.\n * This decides everything around that: which box key the next attempt uses,\n * whether the old box's snapshot is safe to restore from, whether an owner has\n * to confirm the loss first, and what the person waiting is told. It is\n * bookkeeping, not I/O — the app supplies storage through\n * {@link WorkspaceSandboxRecoveryStore}.\n *\n * ── Why the tables ──────────────────────────────────────────────────────────\n * Every fact about an action or a code lives in ACTIONS/CODES below, and the\n * types are DERIVED from those tables. That is deliberate, and it is the whole\n * reliability argument for this module.\n *\n * The hand-maintained alternative — a union type plus a separate `x === 'a' ||\n * x === 'b' || …` list per question — silently drops anything not on the list.\n * A recovery recorded under an unlisted action is written to storage, read\n * back, discarded as malformed, and the workspace re-provisions the box it just\n * abandoned. Nothing throws. The fix looks correct, ships, and does nothing.\n * That failure was hit twice inside one change before this module existed.\n *\n * With the tables, adding an action or code is a compile error until every\n * question about it is answered. There is no list to forget.\n */\n\n/** The box exists and still holds unsnapshotted state, so discarding it is an\n * owner's decision, not the runtime's. */\nexport const EGRESS_PROXY_RECOVERY_REQUIRED = 'EGRESS_PROXY_RECOVERY_REQUIRED'\nexport const EGRESS_PROXY_RECOVERY_PHASE = 'egress_proxy_recovery'\n/** The platform no longer has the box. Nothing to confirm, delete, or restore. */\nexport const WORKSPACE_SANDBOX_MISSING = 'WORKSPACE_SANDBOX_MISSING'\n/** The box exists but its host has no free slot, so it can never be resumed\n * where it is. A replacement can be placed on a host with room. */\nexport const WORKSPACE_SANDBOX_HOST_EXHAUSTED = 'WORKSPACE_SANDBOX_HOST_EXHAUSTED'\n/** The platform ran its own recovery, failed, and asked for a replacement.\n * Covers every way a box ends up unbringable with no more specific cause. */\nexport const WORKSPACE_SANDBOX_UNRECOVERABLE = 'WORKSPACE_SANDBOX_UNRECOVERABLE'\n\nexport const WORKSPACE_SANDBOX_SNAPSHOT_MAX_AGE_MS = 24 * 60 * 60 * 1000\n\n/**\n * Every recovery cause, and the one thing the runtime must know about each:\n * whether the box it names can still be read from.\n *\n * `snapshotUsable: false` is not a preference. A snapshot is addressed by the\n * sandbox it was taken from, so when that sandbox cannot be started the restore\n * fails exactly the way the resume did — and an app that tried it would turn a\n * recoverable workspace into a stuck one.\n */\nconst CODES = {\n [EGRESS_PROXY_RECOVERY_REQUIRED]: { snapshotUsable: true },\n [WORKSPACE_SANDBOX_MISSING]: { snapshotUsable: false },\n [WORKSPACE_SANDBOX_HOST_EXHAUSTED]: { snapshotUsable: false },\n [WORKSPACE_SANDBOX_UNRECOVERABLE]: { snapshotUsable: false },\n} as const\n\nexport type WorkspaceSandboxRecoveryCode = keyof typeof CODES\n\n/**\n * Every recovery action, and whether it means a replacement box has been\n * CHOSEN — the single question that decides which box key the next provisioning\n * attempt uses.\n *\n * `replacementChosen: false` covers the states where a key may be recorded but\n * must not be used yet: an owner has been asked and has not answered, or has\n * answered no. Handing back a key in those states replaces a box the owner\n * declined to lose.\n */\nconst ACTIONS = {\n confirmation_required: { replacementChosen: false, canDecide: true },\n deletion_declined: { replacementChosen: false, canDecide: true },\n replacement_authorized: { replacementChosen: false },\n snapshot_replacement_authorized: { replacementChosen: false },\n replacement_started: { replacementChosen: true, completedAs: 'replacement_completed' },\n replacement_completed: { replacementChosen: true },\n snapshot_replacement_started: { replacementChosen: true, completedAs: 'snapshot_replacement_completed' },\n snapshot_restore_failed: { replacementChosen: true, completedAs: 'snapshot_replacement_completed' },\n snapshot_replacement_completed: { replacementChosen: true },\n missing_replacement_started: { replacementChosen: true, completedAs: 'missing_replacement_completed' },\n missing_replacement_completed: { replacementChosen: true },\n unrecoverable_replacement_started: { replacementChosen: true, completedAs: 'unrecoverable_replacement_completed' },\n unrecoverable_replacement_completed: { replacementChosen: true },\n} as const\n\nexport type WorkspaceSandboxRecoveryAction = keyof typeof ACTIONS\n\nexport type WorkspaceSandboxSnapshotAvailability = 'available' | 'missing' | 'stale'\nexport type WorkspaceSandboxSnapshotFreshness = 'fresh' | 'stale' | 'unknown'\n\n/** A snapshot the app took of a box, addressed by the box it came from. */\nexport interface WorkspaceSandboxSnapshot {\n fromSandboxId: string\n createdAt: string\n [key: string]: unknown\n}\n\nexport interface WorkspaceSandboxSnapshotAssessment<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n availability: WorkspaceSandboxSnapshotAvailability\n freshness: WorkspaceSandboxSnapshotFreshness\n snapshot?: Snapshot\n}\n\nexport interface WorkspaceSandboxRecoveryState<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n code: WorkspaceSandboxRecoveryCode\n sandboxId: string\n detectedAt: string\n snapshot: WorkspaceSandboxSnapshotAssessment<Snapshot>\n action: WorkspaceSandboxRecoveryAction\n replacementBoxKey?: string\n replacementSandboxId?: string\n confirmedAt?: string\n}\n\nexport type WorkspaceSandboxRecoveryDecision = 'replace' | 'decline'\n\n/** Raised when chat cannot continue until an owner decides about the box. */\nexport class WorkspaceSandboxRecoveryRequiredError extends Error {\n readonly code = EGRESS_PROXY_RECOVERY_REQUIRED\n readonly status = 409\n readonly phase = EGRESS_PROXY_RECOVERY_PHASE\n readonly recovery: WorkspaceSandboxRecoveryState\n\n constructor(recovery: WorkspaceSandboxRecoveryState, cause: Error) {\n super(workspaceSandboxRecoveryMessage(recovery), { cause })\n this.name = 'WorkspaceSandboxRecoveryRequiredError'\n this.recovery = recovery\n }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null\n}\n\nfunction asNonEmptyString(value: unknown): string | undefined {\n return typeof value === 'string' && value.trim().length > 0 ? value : undefined\n}\n\n/** Walk `cause` and `errors` breadth-first, cycle-safe. */\nfunction errorChain(error: unknown): unknown[] {\n const pending = [error]\n const visited = new Set<unknown>()\n const chain: unknown[] = []\n\n while (pending.length > 0) {\n const current = pending.shift()\n if (current === undefined || current === null || visited.has(current)) continue\n visited.add(current)\n chain.push(current)\n if (!isRecord(current)) continue\n if (current.cause !== undefined) pending.push(current.cause)\n if (Array.isArray(current.errors)) pending.push(...current.errors)\n }\n\n return chain\n}\n\nexport function isEgressProxyRecoveryRequiredError(error: unknown): boolean {\n return errorChain(error).some((current) =>\n isRecord(current) && current.code === EGRESS_PROXY_RECOVERY_REQUIRED,\n )\n}\n\nexport function isWorkspaceSandboxSnapshotRestoreError(error: unknown): boolean {\n return errorChain(error).some((current) => {\n const message = current instanceof Error\n ? current.message\n : isRecord(current) && typeof current.message === 'string'\n ? current.message\n : ''\n return /snapshot|fromSnapshot|restore/i.test(message)\n })\n}\n\n/**\n * Judge a snapshot against the box being replaced.\n *\n * Fresh means BOTH that it came from this exact sandbox and that it is inside\n * the age bound — a snapshot from a different box restores someone else's\n * filesystem, which is worse than starting empty.\n */\nexport function assessWorkspaceSandboxSnapshot<Snapshot extends WorkspaceSandboxSnapshot>(\n snapshot: Snapshot | undefined,\n sandboxId: string,\n now = Date.now(),\n): WorkspaceSandboxSnapshotAssessment<Snapshot> {\n if (!snapshot) return { availability: 'missing', freshness: 'unknown' }\n\n const createdAt = Date.parse(snapshot.createdAt)\n const ageMs = now - createdAt\n const isFresh = snapshot.fromSandboxId === sandboxId\n && Number.isFinite(createdAt)\n && ageMs >= 0\n && ageMs <= WORKSPACE_SANDBOX_SNAPSHOT_MAX_AGE_MS\n\n return isFresh\n ? { availability: 'available', freshness: 'fresh', snapshot }\n : { availability: 'stale', freshness: 'stale', snapshot }\n}\n\nfunction isSnapshotAssessment(value: unknown): value is WorkspaceSandboxSnapshotAssessment {\n if (!isRecord(value)) return false\n const availability = value.availability\n const freshness = value.freshness\n return (availability === 'available' || availability === 'missing' || availability === 'stale')\n && (freshness === 'fresh' || freshness === 'stale' || freshness === 'unknown')\n}\n\nexport function isWorkspaceSandboxRecoveryAction(\n value: unknown,\n): value is WorkspaceSandboxRecoveryAction {\n return typeof value === 'string' && Object.hasOwn(ACTIONS, value)\n}\n\nexport function isWorkspaceSandboxRecoveryCode(\n value: unknown,\n): value is WorkspaceSandboxRecoveryCode {\n return typeof value === 'string' && Object.hasOwn(CODES, value)\n}\n\nexport function isWorkspaceSandboxRecoveryState(\n value: unknown,\n): value is WorkspaceSandboxRecoveryState {\n if (!isRecord(value)) return false\n return isWorkspaceSandboxRecoveryCode(value.code)\n && !!asNonEmptyString(value.sandboxId)\n && !!asNonEmptyString(value.detectedAt)\n && isSnapshotAssessment(value.snapshot)\n && isWorkspaceSandboxRecoveryAction(value.action)\n}\n\nexport function workspaceSandboxRecoveryFromError(\n error: unknown,\n): WorkspaceSandboxRecoveryState | undefined {\n for (const current of errorChain(error)) {\n if (!isRecord(current) || !isWorkspaceSandboxRecoveryState(current.recovery)) continue\n return current.recovery\n }\n return undefined\n}\n\n/** What to tell the person waiting. Never names the product, so an app can\n * surface it verbatim. */\nexport function workspaceSandboxRecoveryMessage(recovery: WorkspaceSandboxRecoveryState): string {\n if (recovery.code === WORKSPACE_SANDBOX_MISSING) {\n return 'The sandbox behind this workspace no longer exists on the platform. A replacement is being provisioned and your saved work is restored into it.'\n }\n if (!CODES[recovery.code].snapshotUsable) {\n return 'The sandbox behind this workspace could not be started again. A replacement is being provisioned and your saved work is restored into it.'\n }\n if (recovery.action === 'deletion_declined') {\n return 'Sandbox recovery remains paused because replacement was declined. The stopped sandbox has not been deleted.'\n }\n if (recovery.action === 'confirmation_required') {\n const snapshotReason = recovery.snapshot.availability === 'missing'\n ? 'No restorable sandbox snapshot is available.'\n : 'The available sandbox snapshot is stale.'\n return `Sandbox recovery requires owner confirmation before replacement. ${snapshotReason} The stopped sandbox has not been deleted.`\n }\n if (recovery.action === 'snapshot_restore_failed') {\n return 'Sandbox replacement could not restore its verified snapshot, and an empty fallback was not created because it could lose workspace state.'\n }\n return 'Sandbox recovery is required before chat can continue. The stopped sandbox has not been deleted.'\n}\n\nexport function workspaceSandboxRecoveryRecommendedActions(\n recovery: WorkspaceSandboxRecoveryState,\n): string[] {\n if (!CODES[recovery.code].snapshotUsable) {\n return ['Retry after the replacement sandbox finishes provisioning.']\n }\n if (recovery.action === 'deletion_declined') {\n return ['Keep the stopped sandbox for support or ask a workspace owner to authorize replacement.']\n }\n if (recovery.action === 'confirmation_required') {\n return ['An owner can explicitly replace the sandbox after accepting loss of unsnapshotted sandbox-local changes.']\n }\n if (recovery.action === 'snapshot_restore_failed') {\n return ['Retry snapshot restoration or contact support. An empty replacement is not created automatically.']\n }\n return ['Retry after sandbox recovery completes.']\n}\n\n/** Flat key/value shape for a log line — no nesting, no secrets. */\nexport function workspaceSandboxRecoveryDiagnostic(\n recovery: WorkspaceSandboxRecoveryState,\n): Record<string, string | undefined> {\n return {\n sandboxId: recovery.sandboxId,\n recoveryCode: recovery.code,\n snapshotAvailability: recovery.snapshot.availability,\n snapshotFreshness: recovery.snapshot.freshness,\n selectedRecoveryAction: recovery.action,\n replacementSandboxId: recovery.replacementSandboxId,\n }\n}\n\n/**\n * The box key the next provisioning attempt should use, or undefined to keep\n * using the workspace's own key.\n *\n * Reads {@link ACTIONS} rather than a hand-kept list, because the failure mode\n * of a hand-kept list here is invisible: the key is recorded, silently ignored,\n * and provisioning goes back to the box the app just decided to abandon.\n */\nexport function preferredWorkspaceSandboxRecoveryBoxKey(\n recovery: WorkspaceSandboxRecoveryState | undefined,\n): string | undefined {\n if (!recovery?.replacementBoxKey) return undefined\n return ACTIONS[recovery.action].replacementChosen ? recovery.replacementBoxKey : undefined\n}\n\n/** Whether the replacement should be restored from the old box's snapshot. */\nexport function shouldRestoreWorkspaceSandboxRecovery(\n recovery: WorkspaceSandboxRecoveryState | undefined,\n): boolean {\n if (!recovery) return false\n if (!CODES[recovery.code].snapshotUsable) return false\n return !!preferredWorkspaceSandboxRecoveryBoxKey(recovery)\n && recovery.snapshot.availability === 'available'\n}\n\n/** One current recovery per workspace, stored by the application.\n * Concurrent writers should supply compareAndSet. Legacy write-only stores\n * remain supported but must serialize decisions and completion themselves. */\nexport interface WorkspaceSandboxRecoveryStore<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n read: (workspaceId: string) => Promise<WorkspaceSandboxRecoveryState<Snapshot> | undefined>\n write: (workspaceId: string, recovery: WorkspaceSandboxRecoveryState<Snapshot>) => Promise<void>\n /** Commit a transition only while the exact recovery read above remains current. */\n compareAndSet?: (\n workspaceId: string,\n expected: WorkspaceSandboxRecoveryState<Snapshot>,\n recovery: WorkspaceSandboxRecoveryState<Snapshot>,\n ) => Promise<boolean>\n}\n\nexport interface WorkspaceSandboxRecoveryManager<Snapshot extends WorkspaceSandboxSnapshot = WorkspaceSandboxSnapshot> {\n read: WorkspaceSandboxRecoveryStore<Snapshot>['read']\n record: WorkspaceSandboxRecoveryStore<Snapshot>['write']\n /** Only a pending/declined recovery for this sandbox accepts a new decision.\n * Replacement requires a fresh, nonblank key; decline needs no key. */\n decide: (args: {\n workspaceId: string\n sandboxId: string\n } & (\n | { decision: 'replace'; replacementBoxKey: string }\n | { decision: 'decline'; replacementBoxKey?: string }\n )) => Promise<WorkspaceSandboxRecoveryState<Snapshot> | undefined>\n /** Only a started replacement with a chosen key may be completed. */\n complete: (args: {\n workspaceId: string\n replacementSandboxId: string\n /** The key used by this provisioning attempt, not a freshly read successor. */\n replacementBoxKey?: string\n }) => Promise<WorkspaceSandboxRecoveryState<Snapshot> | undefined>\n}\n\n/** Bind canonical recovery policy to the application's existing storage. */\nexport function createWorkspaceSandboxRecoveryManager<Snapshot extends WorkspaceSandboxSnapshot>(\n store: WorkspaceSandboxRecoveryStore<Snapshot>,\n): WorkspaceSandboxRecoveryManager<Snapshot> {\n type State = WorkspaceSandboxRecoveryState<Snapshot>\n async function transition(workspaceId: string, expected: State, next: State): Promise<State> {\n if (store.compareAndSet) {\n if (!await store.compareAndSet(workspaceId, expected, next))\n throw new Error('Sandbox recovery changed; reload before retrying its transition')\n } else {\n await store.write(workspaceId, next)\n }\n return next\n }\n\n return {\n read: workspaceId => store.read(workspaceId),\n record: (workspaceId, recovery) => store.write(workspaceId, recovery),\n async decide({ workspaceId, sandboxId, decision, replacementBoxKey }) {\n const current = await store.read(workspaceId)\n if (!current || current.sandboxId !== sandboxId || !('canDecide' in ACTIONS[current.action])) return undefined\n if (decision === 'replace' && !asNonEmptyString(replacementBoxKey))\n throw new Error('Sandbox replacement authorization requires a fresh replacement box key')\n return transition(workspaceId, current, {\n ...current,\n action: decision === 'replace'\n ? (current.snapshot.availability === 'available' ? 'snapshot_replacement_authorized' : 'replacement_authorized')\n : 'deletion_declined',\n confirmedAt: new Date().toISOString(),\n ...(decision === 'replace' ? { replacementBoxKey } : {}),\n })\n },\n async complete({ workspaceId, replacementSandboxId, replacementBoxKey }) {\n const current = await store.read(workspaceId)\n if (!current || !asNonEmptyString(current.replacementBoxKey)) return undefined\n if (replacementBoxKey !== undefined && current.replacementBoxKey !== replacementBoxKey) return undefined\n const policy = ACTIONS[current.action]\n if (!('completedAs' in policy)) return undefined\n if (!asNonEmptyString(replacementSandboxId)) throw new Error('A replacement sandbox id is required')\n return transition(workspaceId, current, { ...current, action: policy.completedAs, replacementSandboxId })\n },\n }\n}\n\n/** Every declared action, for exhaustiveness tests in apps and here. */\nexport const WORKSPACE_SANDBOX_RECOVERY_ACTIONS = Object.keys(\n ACTIONS,\n) as readonly WorkspaceSandboxRecoveryAction[]\n\n/** Every declared cause. */\nexport const WORKSPACE_SANDBOX_RECOVERY_CODES = Object.keys(\n CODES,\n) as readonly WorkspaceSandboxRecoveryCode[]\n","/**\n * Read a sandbox provisioning failure without leaking what it carries.\n *\n * Provisioning errors arrive as deep `cause` chains from the sandbox API, the\n * runtime sidecar, and the app's own vault code, and they routinely carry\n * bearer tokens and signed URLs in their messages. Every app on this shell\n * needs the same three things from one: a redacted shape it can log, a\n * classification it can act on, and a sentence it can show a person. Before\n * this module each app either wrote its own or — far more often — wrote none,\n * and surfaced the raw error or a generic apology.\n *\n * The classifiers are deliberately narrow. `isSandboxApiSandboxMissingFailure`\n * does not fire on a 404 from inside a live box; `isSandboxHostCapacityFailure`\n * does not fire on capacity wording from any origin but the sandbox API. A\n * classifier that over-matches turns a transient failure into a box deletion.\n */\nimport { EGRESS_PROXY_RECOVERY_REQUIRED } from './recovery'\n\nconst SAFE_ERROR_FIELDS = [\n 'code',\n 'status',\n 'phase',\n 'endpoint',\n 'origin',\n 'retryAfterMs',\n 'sidecarVersion',\n 'containerImage',\n] as const\n\nexport interface SafeSandboxErrorCause {\n name?: string\n message?: string\n code?: string | number\n status?: string | number\n phase?: string\n endpoint?: string\n origin?: string\n retryAfterMs?: number\n sidecarVersion?: string\n containerImage?: string\n}\n\nexport interface SafeSandboxErrorDiagnostics {\n message: string\n causes: SafeSandboxErrorCause[]\n truncated: boolean\n truncatedAtDepth?: number\n cycle: boolean\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null\n}\n\nfunction asSafeScalar(value: unknown): string | number | undefined {\n if (typeof value === 'string' && value.length > 0) return redactDiagnosticText(value)\n if (typeof value === 'number' && Number.isFinite(value)) return value\n return undefined\n}\n\nfunction redactDiagnosticText(value: string): string {\n const secretKeyPattern = '(?:(?:[A-Z0-9]+_)*(?:api_?key|auth_?token|access_?token|refresh_?token|key|token|password|secret|credential)|apiKey|authToken|accessToken|refreshToken)'\n return value\n .replace(/(['\"]authorization['\"]\\s*:\\s*)(['\"])[^'\"]*\\2/gi, '$1$2[REDACTED]$2')\n .replace(/\\b(authorization\\s*[:=]\\s*)(['\"])[^'\"]*\\2/gi, '$1$2[REDACTED]$2')\n .replace(/\\b(authorization\\s*[:=]\\s*)Digest\\b[^;}\\n]*(?:\\r?\\n[ \\t]+[^;}\\n]*)*/gi, '$1[REDACTED]')\n .replace(/\\b(authorization\\s*[:=]\\s*)(?:Basic|Bearer|Negotiate)\\s+[^\\s;,&}\\n]+(?:\\r?\\n[ \\t]+[^\\s;,&}\\n]+)*/gi, '$1[REDACTED]')\n .replace(new RegExp(`\\\\b(authorization\\\\s*[:=]\\\\s*)(?!(?:Basic|Bearer|Digest|Negotiate)\\\\b)([A-Za-z][A-Za-z0-9._-]+)\\\\s+(?!(?:authorization|${secretKeyPattern})\\\\s*[:=]|['\"](?:authorization|${secretKeyPattern})['\"]\\\\s*:)([^}\\\\n]*(?:\\\\r?\\\\n[ \\\\t]+[^}\\\\n]*)*)`, 'gi'), (_match, prefix: string, _scheme: string, valuePart: string) => {\n if (valuePart.includes(';') || /\\r?\\n[ \\t]+/.test(valuePart)) return `${prefix}[REDACTED]`\n const tokenMatch = valuePart.match(/^\\S+(.*)$/)\n return `${prefix}[REDACTED]${tokenMatch?.[1] ?? ''}`\n })\n .replace(/\\b(authorization\\s*[:=]\\s*)[A-Za-z][\\w.-]+\\s+[^\\s;,&}\\n]+(?=[;&}\\n]|$)/gi, '$1[REDACTED]')\n .replace(/\\b(authorization\\s*[:=]\\s*)(?!\\[REDACTED\\])[^'\"\\s&}]+(?:[;,][^'\"\\s&}]+)*/gi, '$1[REDACTED]')\n .replace(/\\bBearer\\s+[A-Za-z0-9._~+/-]+=*/gi, 'Bearer [REDACTED]')\n .replace(/\\bsk-[A-Za-z0-9_-]{6,}\\b/g, 'sk-[REDACTED]')\n .replace(\n /([?&][^=&#\\s]*(?:token|key|secret|password|authorization)[^=&#\\s]*=)[^&#\\s]+/gi,\n '$1[REDACTED]',\n )\n .replace(\n new RegExp(`(['\"])(${secretKeyPattern})\\\\1\\\\s*:\\\\s*(['\"])[^'\"]+\\\\3`, 'gi'),\n '$1$2$1:$3[REDACTED]$3',\n )\n .replace(\n new RegExp(`\\\\b(${secretKeyPattern})\\\\s*([:=])(\\\\s*)(['\"]?)(?!Bearer\\\\b)[^'\"\\\\s;,&}]+(?:[;,]\\\\s*[^'\"\\\\s;,&}]+)*`, 'gi'),\n '$1$2$3$4[REDACTED]',\n )\n}\n\nfunction readMessage(value: unknown): string | undefined {\n if (value instanceof Error) return redactDiagnosticText(value.message)\n if (typeof value === 'string' && value.length > 0) return redactDiagnosticText(value)\n if (typeof value === 'number' && Number.isFinite(value)) return String(value)\n if (typeof value === 'boolean') return String(value)\n if (!isRecord(value)) return undefined\n const message = value.message\n return typeof message === 'string' && message.length > 0 ? redactDiagnosticText(message) : undefined\n}\n\nfunction readName(value: unknown): string | undefined {\n if (value instanceof Error) return redactDiagnosticText(value.name)\n if (!isRecord(value)) return undefined\n const name = value.name\n return typeof name === 'string' && name.length > 0 ? redactDiagnosticText(name) : undefined\n}\n\nfunction readCause(value: unknown): unknown {\n if (!isRecord(value)) return undefined\n return value.cause\n}\n\nexport function serializeSandboxProvisioningError(\n error: unknown,\n options: { maxDepth?: number } = {},\n): SafeSandboxErrorDiagnostics {\n const maxDepth = options.maxDepth ?? 6\n const causes: SafeSandboxErrorCause[] = []\n const seen = new Set<unknown>()\n let truncatedAtDepth: number | undefined\n let cycle = false\n\n let current: unknown = error\n let depth = 0\n for (; depth < maxDepth && current !== undefined && current !== null; depth += 1) {\n if (seen.has(current)) {\n cycle = true\n causes.push({\n name: 'CauseChainCycle',\n message: `cause chain cycle detected after ${depth} entries`,\n })\n break\n }\n if (isRecord(current)) seen.add(current)\n\n const cause: SafeSandboxErrorCause = {}\n const name = readName(current)\n const message = readMessage(current)\n if (name) cause.name = name\n if (message) cause.message = message\n\n if (isRecord(current)) {\n for (const field of SAFE_ERROR_FIELDS) {\n const safeValue = asSafeScalar(current[field])\n if (safeValue !== undefined) {\n Object.assign(cause, { [field]: safeValue })\n }\n }\n }\n\n if (Object.keys(cause).length > 0) causes.push(cause)\n current = readCause(current)\n }\n\n if (!cycle && isRecord(current) && seen.has(current)) {\n cycle = true\n causes.push({\n name: 'CauseChainCycle',\n message: `cause chain cycle detected after ${depth} entries`,\n })\n } else if (current !== undefined && current !== null && depth >= maxDepth) {\n truncatedAtDepth = maxDepth\n causes.push({\n name: 'CauseChainTruncated',\n message: `cause chain truncated after ${maxDepth} entries`,\n })\n }\n\n return {\n message: readMessage(error) ?? 'Sandbox unavailable',\n causes,\n truncated: truncatedAtDepth !== undefined,\n truncatedAtDepth,\n cycle,\n }\n}\n\nexport function formatSandboxProvisioningSupportDetails(\n diagnostics: SafeSandboxErrorDiagnostics,\n): string {\n const actionableCause = diagnostics.causes.find((cause) =>\n cause.code !== undefined\n || cause.status !== undefined\n || cause.phase !== undefined\n || cause.endpoint !== undefined\n || cause.origin !== undefined\n || cause.retryAfterMs !== undefined\n || cause.sidecarVersion !== undefined\n || cause.containerImage !== undefined,\n ) ?? diagnostics.causes[1]\n\n if (!actionableCause) return 'Support details: no nested sandbox cause details were available.'\n\n const details = [\n typeof actionableCause.name === 'string' ? redactDiagnosticText(actionableCause.name) : undefined,\n actionableCause.code !== undefined ? `code=${actionableCause.code}` : undefined,\n actionableCause.status !== undefined ? `status=${actionableCause.status}` : undefined,\n actionableCause.phase !== undefined ? `phase=${redactDiagnosticText(actionableCause.phase)}` : undefined,\n actionableCause.endpoint !== undefined ? `endpoint=${redactDiagnosticText(actionableCause.endpoint)}` : undefined,\n actionableCause.origin !== undefined ? `origin=${redactDiagnosticText(actionableCause.origin)}` : undefined,\n actionableCause.retryAfterMs !== undefined ? `retryAfterMs=${actionableCause.retryAfterMs}` : undefined,\n actionableCause.sidecarVersion !== undefined ? `sidecarVersion=${redactDiagnosticText(actionableCause.sidecarVersion)}` : undefined,\n actionableCause.containerImage !== undefined ? `containerImage=${redactDiagnosticText(actionableCause.containerImage)}` : undefined,\n typeof actionableCause.message === 'string' ? redactDiagnosticText(actionableCause.message) : undefined,\n ].filter(Boolean)\n\n if (details.length === 0) return 'Support details: no nested sandbox cause details were available.'\n return `Support details: ${details.join('; ')}`\n}\n\nexport function isSandboxAuthFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n const code = typeof cause.code === 'string' ? cause.code.toUpperCase() : undefined\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n const name = typeof cause.name === 'string' ? cause.name.toLowerCase() : ''\n const message = typeof cause.message === 'string' ? cause.message.toLowerCase() : ''\n\n return code === 'AUTH_ERROR'\n || status === 401\n || name.includes('autherror')\n || message.includes('missing or invalid authentication')\n })\n}\n\n/**\n * True when the Sandbox API refused the caller's bearer: a 401 from any\n * Sandbox API route, including list and query routes such as\n * `/v1/sandboxes?status=stopped`. The caller should invalidate its cached key\n * and mint a new one once.\n *\n * Runtime routes (`/v1/sandboxes/{id}/runtime/...`) are excluded: the box's\n * runtime authentication answers those, and a new Sandbox API key does not fix\n * it. `isSandboxAuthFailure` covers them.\n */\nexport function isSandboxApiBearerAuthFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n if (status !== 401) return false\n if (cause.origin !== 'sandbox-api') return false\n if (typeof cause.endpoint !== 'string') return false\n const endpointPath = sandboxApiEndpointPath(cause.endpoint)\n if (!endpointPath || !/^\\/v1(?:[/?#]|$)/.test(endpointPath)) return false\n return !/^\\/v1\\/sandboxes\\/[^/?#]+\\/runtime(?:[/?#]|$)/.test(endpointPath)\n })\n}\n\n/** Machine-readable code emitted when resume lost the physical box. */\nexport const SANDBOX_BACKING_CONTAINER_MISSING_CODE = 'BACKING_CONTAINER_MISSING' as const\n\n/**\n * Legacy fallback for Sandbox API releases that only returned the nested host\n * 404 text. New callers must use `SANDBOX_BACKING_CONTAINER_MISSING_CODE`.\n */\nexport function isLegacySandboxBackingContainerMissingMessage(message: string): boolean {\n return /host-agent startcontainer failed \\(404\\):/i.test(message)\n && /container not found/i.test(message)\n && /\"code\"\\s*:\\s*\"not_found\"/i.test(message)\n}\n\n/**\n * True when the sandbox API cannot find a sandbox resource or its backing\n * container. The latter arrives as a 500 from resume with a nested host 404.\n *\n * A sandbox id is a cache of where a workspace's box lives, not the workspace's\n * identity: the platform reaps, suspends, and loses boxes as ordinary lifecycle\n * events. Callers use this to discard the dead id and provision a replacement,\n * so the match is deliberately narrow — a 404 from the runtime sidecar\n * (`/runtime/...`, a missing file or session inside a live box) is NOT this.\n */\nexport function isSandboxApiSandboxMissingFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n if (cause.origin !== 'sandbox-api') return false\n if (typeof cause.endpoint !== 'string') return false\n const endpointPath = sandboxApiEndpointPath(cause.endpoint)\n if (!endpointPath) return false\n const sandboxResource = /^\\/v1\\/sandboxes\\/[^/?#]+(?:\\/(?!runtime(?:[/?#]|$))[^?#]*)?(?:[?#].*)?$/.test(endpointPath)\n if (!sandboxResource) return false\n if (status === 404) return true\n\n if (status !== 500 || !/^\\/v1\\/sandboxes\\/[^/?#]+\\/resume(?:[?#].*)?$/.test(endpointPath)) {\n return false\n }\n const code = typeof cause.code === 'string' ? cause.code.toUpperCase() : undefined\n if (code === SANDBOX_BACKING_CONTAINER_MISSING_CODE) return true\n // Older Sandbox API releases returned only the nested host 404. The SDK\n // represented that response as SERVER_ERROR, so keep this exact fallback\n // until those releases are no longer in service.\n if (code !== undefined && code !== 'SERVER_ERROR') return false\n const message = typeof cause.message === 'string' ? cause.message : ''\n return isLegacySandboxBackingContainerMissingMessage(message)\n })\n}\n\n/**\n * True when a resume failed because the host the box is pinned to cannot seat\n * it — the host's slot budget is exhausted, not the box's fault and not\n * something waiting fixes.\n *\n * A box lives on one host. When that host fills, every future resume for every\n * box on it fails identically and permanently, so a workspace whose box landed\n * on a full host is bricked until it is placed somewhere else. Callers use this\n * the same way they use {@link isSandboxApiSandboxMissingFailure}: discard the\n * dead id and provision a replacement, which the orchestrator is free to place\n * on a host with room. The workspace itself is preserved — it lives in the\n * Vault, not in the box's filesystem.\n *\n * Matched on the message because the sandbox API returns a generic\n * `SERVER_ERROR` for it; a dedicated code upstream would replace this.\n */\nexport function isSandboxHostCapacityFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n if (cause.origin !== 'sandbox-api') return false\n if (typeof cause.message !== 'string') return false\n return /host has no available slot|host capacity reservation failed/i.test(cause.message)\n })\n}\n\n/**\n * True when a resume failed on the box's own configuration rather than on\n * anything a retry can change.\n *\n * These are permanent facts about one box. Its egress policy can be missing,\n * or its verified Platform lineage can differ from the current caller. Neither\n * creation-time fact can change on resume, so the box must be replaced.\n *\n * Narrow on purpose. A bare 500 from the sandbox API is transient far more\n * often than not, and treating one as unbringable would delete a healthy box.\n * Matched on the specific unrecoverable phrasing, and only from `sandbox-api`.\n */\nexport function isSandboxBoxConfigFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n return diagnostics.causes.some((cause) => {\n if (cause.origin !== 'sandbox-api') return false\n if (cause.code === 'SANDBOX_ATTRIBUTION_MISMATCH') return true\n if (typeof cause.message !== 'string') return false\n return /has no recorded egress policy|cannot rebuild the proxy config/i.test(cause.message)\n })\n}\n\n/**\n * True when the Sandbox API answered a control-plane call with a server error\n * (500, 502, 503 or 504), such as `A sandbox backend did not answer` or\n * `Failed to resume project: fetch failed`. These clear within seconds, so a\n * caller may retry once before surfacing them.\n *\n * Runtime routes are excluded (the box answers those), and so are the narrow\n * failures that need a different action: a missing box, a box whose creation\n * facts no longer hold, and host capacity.\n */\nexport function isSandboxApiTransientFailure(diagnostics: SafeSandboxErrorDiagnostics): boolean {\n if (isSandboxApiSandboxMissingFailure(diagnostics)\n || isSandboxBoxConfigFailure(diagnostics)\n || isSandboxHostCapacityFailure(diagnostics)) return false\n return diagnostics.causes.some((cause) => {\n const status = typeof cause.status === 'number'\n ? cause.status\n : typeof cause.status === 'string'\n ? Number.parseInt(cause.status, 10)\n : undefined\n if (status !== 500 && status !== 502 && status !== 503 && status !== 504) return false\n if (cause.origin !== 'sandbox-api' || typeof cause.endpoint !== 'string') return false\n const endpointPath = sandboxApiEndpointPath(cause.endpoint)\n if (!endpointPath || !/^\\/v1(?:[/?#]|$)/.test(endpointPath)) return false\n return !/^\\/v1\\/sandboxes\\/[^/?#]+\\/runtime(?:[/?#]|$)/.test(endpointPath)\n })\n}\n\nfunction sandboxApiEndpointPath(endpoint: string): string | null {\n if (endpoint.startsWith('/')) return endpoint\n try {\n const url = new URL(endpoint)\n return `${url.pathname}${url.search}${url.hash}`\n } catch {\n return null\n }\n}\n\nexport function formatSandboxProvisioningUserMessage(\n diagnostics: SafeSandboxErrorDiagnostics,\n): string {\n if (diagnostics.causes.some((cause) => cause.code === EGRESS_PROXY_RECOVERY_REQUIRED)) {\n return 'Sandbox recovery is required before chat can continue. The stopped sandbox has not been deleted.'\n }\n\n // The sandbox itself is reachable — copying the Vault into it is what did not\n // finish. Saying \"the service is unavailable\" sends people to inspect\n // infrastructure that is healthy.\n if (diagnostics.causes.some((cause) => cause.code === 'vault.hydration_incomplete')) {\n return 'I couldn\\'t finish copying your Vault into the sandbox, so I stopped rather than work from a partial copy. The copy resumes where it left off — try again in a moment.'\n }\n\n if (isSandboxApiTransientFailure(diagnostics)) {\n return 'The sandbox service didn\\'t answer just now. Send your message again in a moment.'\n }\n\n if (isSandboxApiBearerAuthFailure(diagnostics)) {\n return 'I\\'m unable to reconnect to the sandbox because its sandbox API credential was rejected. Another request may have rotated the bearer used for this operation.'\n }\n\n if (isSandboxAuthFailure(diagnostics)) {\n return 'I\\'m unable to reconnect to the sandbox because its runtime authentication failed. This can happen when an existing sandbox is reused with stale credentials.'\n }\n\n if (diagnostics.causes.some((cause) => (\n cause.code === 'PAYLOAD_TOO_LARGE'\n || cause.code === 'FILE_TOO_LARGE'\n || cause.status === 413\n || cause.status === '413'\n ))) {\n // Profile and workspace files reach the box through writeProfileFilesToBox;\n // naming an attachment there sends people looking for one they never sent.\n if (diagnostics.causes.some((cause) => cause.message?.startsWith('writeProfileFilesToBox'))) {\n return 'A workspace file is too large to copy into the sandbox. The support details name the file.'\n }\n return 'An attachment is too large for the sandbox to accept. Use a smaller file and try again.'\n }\n\n // Matched by code, not bare 429: the sidecar's rate limiters also answer\n // 429, and those are not attachment-staging pressure.\n if (diagnostics.causes.some((cause) => cause.code === 'UPLOAD_BUDGET_EXHAUSTED')) {\n return 'Too much attachment data is staged in the sandbox at once. Retry shortly.'\n }\n\n return 'I\\'m unable to connect to the sandbox right now. Send your message again in a moment; if it keeps failing, share the support details with the team.'\n}\n","/**\n * Sandbox failures that clear on their own, and how long to wait them out.\n *\n * Both callers that meet them use this one policy: the run dispatch, which\n * resends the same execution, and the completion Workflow, which observes it.\n * A box restarting under load answers \"filesystem incarnation is not ready\"\n * for minutes (8 minutes for GTM's busiest box on 2026-10-10, 10:37 to 10:45\n * UTC), and its gateway refuses dispatches with 502 or 503 while it does.\n * Failing on the first such answer lost those turns; retrying forever would\n * hold a lock on a box that never comes back. The policy backs off from 5 s\n * to a 60 s ceiling and gives up after 15 minutes.\n */\nimport { isSandboxApiTransientFailure, serializeSandboxProvisioningError } from './diagnostics'\n\nexport type SandboxTransientFailureCode =\n /** The box is running but its filesystem incarnation is not ready yet. */\n | 'sandbox.filesystem_not_ready'\n /** The sandbox gateway answered the run dispatch with 502, 503 or 504. */\n | 'sandbox.dispatch_refused'\n /** A Sandbox API control-plane call failed with a server error. */\n | 'sandbox.control_plane_transient'\n\nexport interface SandboxTransientFailure {\n code: SandboxTransientFailureCode\n message: string\n}\n\n/** How long a transient failure may last before the caller fails. */\nexport const SANDBOX_TRANSIENT_DEADLINE_MS = 15 * 60_000\n\n/** Wait before retry `attempt` (1-based): 5 s doubling to a 60 s ceiling. */\nexport function sandboxTransientBackoffMs(attempt: number): number {\n return Math.min(60_000, 5_000 * 2 ** Math.max(0, attempt - 1))\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === 'object' ? value as Record<string, unknown> : undefined\n}\n\nfunction causeChain(error: unknown): Record<string, unknown>[] {\n const chain: Record<string, unknown>[] = []\n let current = record(error)\n for (let depth = 0; current && depth < 8 && !chain.includes(current); depth += 1) {\n chain.push(current)\n current = record(current.cause)\n }\n return chain\n}\n\n/** A planned host-agent swap leaves the sandbox alive; an ordinary probe failure is not that evidence. */\nexport function plannedHostRestart(error: unknown): boolean {\n return causeChain(error).some(cause => cause.code === 'HOST_AGENT_RESTARTING' && cause.status === 503)\n}\n\n/** Wait only for the platform typed planned-restart signal, within the caller budget. */\nexport async function readDuringPlannedHostRestart<T>(\n read: () => Promise<T>,\n deadline: number,\n): Promise<{ value: T; waited: boolean }> {\n let waited = false\n for (;;) {\n try {\n return { value: await read(), waited }\n } catch (error) {\n if (!plannedHostRestart(error)) throw error\n const hint = (error as { retryAfterMs?: unknown }).retryAfterMs\n const delay = typeof hint === 'number' && Number.isFinite(hint) && hint > 0\n ? hint : sandboxTransientBackoffMs(1)\n // The existing caller budget bounds retries. Each SDK request\n // settles under its own deadline before another begins. Preserve the refusal and never start a stop on\n // expiry; its code, origin and endpoint remain available to the caller.\n if (Date.now() + delay >= deadline) throw error\n waited = true\n await new Promise(resolve => setTimeout(resolve, delay))\n }\n }\n}\n\n\nfunction status(value: unknown): number | undefined {\n if (typeof value === 'number') return value\n if (typeof value === 'string' && /^\\d{3}$/.test(value)) return Number(value)\n return undefined\n}\n\nconst FILESYSTEM_NOT_READY = /filesystem incarnation is not ready/i\nconst RUN_DISPATCH_ENDPOINT = /\\/runtime\\/agents\\/run\\/stream(?:[?#]|$)/\nconst RUN_DISPATCH_REFUSAL_MESSAGE = /\\/runtime\\/agents\\/run\\/stream: error code: (50[234])\\b/\n\n/** The typed transient failure `error` carries anywhere in its cause chain, or null. */\nexport function classifySandboxTransientFailure(error: unknown): SandboxTransientFailure | null {\n for (const cause of causeChain(error)) {\n const message = typeof cause.message === 'string' ? cause.message : ''\n if (cause.code === 'FILESYSTEM_INCARNATION_NOT_READY' || FILESYSTEM_NOT_READY.test(message)) {\n return { code: 'sandbox.filesystem_not_ready', message: 'Sandbox filesystem incarnation is not ready' }\n }\n const code = status(cause.status)\n const endpoint = typeof cause.endpoint === 'string' ? cause.endpoint : ''\n const refusal = (code === 502 || code === 503 || code === 504) && RUN_DISPATCH_ENDPOINT.test(endpoint)\n ? code\n : RUN_DISPATCH_REFUSAL_MESSAGE.exec(message)?.[1]\n if (refusal) {\n return { code: 'sandbox.dispatch_refused', message: `The sandbox gateway refused the run dispatch with ${refusal}` }\n }\n }\n if (isSandboxApiTransientFailure(serializeSandboxProvisioningError(error))) {\n return { code: 'sandbox.control_plane_transient', message: 'A Sandbox API call failed with a server error' }\n }\n return null\n}\n\n/** The error a caller raises when a transient failure outlasted the deadline. */\nexport class SandboxTransientDeadlineError extends Error {\n readonly code: SandboxTransientFailureCode\n readonly firstSeenAt: number\n readonly attempts: number\n\n constructor(failure: SandboxTransientFailure, firstSeenAt: number, attempts: number, cause?: unknown) {\n const minutes = Math.round(SANDBOX_TRANSIENT_DEADLINE_MS / 60_000)\n super(`${failure.message}; it persisted for more than ${minutes} minutes over ${attempts} attempts`, cause === undefined ? undefined : { cause })\n this.name = 'SandboxTransientDeadlineError'\n this.code = failure.code\n this.firstSeenAt = firstSeenAt\n this.attempts = attempts\n }\n}\n\nexport interface SandboxTransientRetryOptions {\n /** Defaults to {@link SANDBOX_TRANSIENT_DEADLINE_MS}. */\n deadlineMs?: number\n now?: () => number\n sleep?: (ms: number, signal?: AbortSignal) => Promise<void>\n signal?: AbortSignal\n onRetry?: (failure: SandboxTransientFailure, attempt: number, delayMs: number) => void\n}\n\nconst defaultSleep = (ms: number, signal?: AbortSignal) => new Promise<void>((resolve, reject) => {\n if (signal?.aborted) return reject(signal.reason)\n const timer = setTimeout(resolve, ms)\n signal?.addEventListener('abort', () => {\n clearTimeout(timer)\n reject(signal.reason)\n }, { once: true })\n})\n\n/**\n * Run `attempt` until it succeeds, it fails with something this policy does\n * not consider transient, or a transient failure outlasts the deadline.\n */\nexport async function retrySandboxTransient<T>(\n attempt: () => Promise<T>,\n options: SandboxTransientRetryOptions = {},\n): Promise<T> {\n const now = options.now ?? Date.now\n const sleep = options.sleep ?? defaultSleep\n const deadlineMs = options.deadlineMs ?? SANDBOX_TRANSIENT_DEADLINE_MS\n let firstSeenAt: number | undefined\n for (let attempts = 1; ; attempts += 1) {\n try {\n return await attempt()\n } catch (error) {\n const failure = classifySandboxTransientFailure(error)\n if (!failure) throw error\n const at = now()\n firstSeenAt ??= at\n const delayMs = sandboxTransientBackoffMs(attempts)\n if (at + delayMs - firstSeenAt > deadlineMs) throw new SandboxTransientDeadlineError(failure, firstSeenAt, attempts, error)\n options.onRetry?.(failure, attempts, delayMs)\n await sleep(delayMs, options.signal)\n }\n }\n}\n"],"mappings":"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","names":["isRecord","status"]}
@@ -10,7 +10,7 @@ import {
10
10
  SandboxTransientDeadlineError,
11
11
  classifySandboxTransientFailure,
12
12
  sandboxTransientBackoffMs
13
- } from "../chunk-4MD5PS4F.js";
13
+ } from "../chunk-PK65B6HP.js";
14
14
  import {
15
15
  parseRenderUiSchema
16
16
  } from "../chunk-XEAZWJ3W.js";
@@ -101,7 +101,7 @@ import {
101
101
  warmKey,
102
102
  warmReceiptId,
103
103
  warmWeekdayOf
104
- } from "../chunk-MVKMDROU.js";
104
+ } from "../chunk-ISRPOPMM.js";
105
105
  import {
106
106
  createWarmCache
107
107
  } from "../chunk-F4TUZYMX.js";
@@ -135,6 +135,7 @@ import {
135
135
  isWorkspaceSandboxSnapshotRestoreError,
136
136
  plannedHostRestart,
137
137
  preferredWorkspaceSandboxRecoveryBoxKey,
138
+ readDuringPlannedHostRestart,
138
139
  retrySandboxTransient,
139
140
  sandboxTransientBackoffMs,
140
141
  serializeSandboxProvisioningError,
@@ -143,7 +144,7 @@ import {
143
144
  workspaceSandboxRecoveryFromError,
144
145
  workspaceSandboxRecoveryMessage,
145
146
  workspaceSandboxRecoveryRecommendedActions
146
- } from "../chunk-4MD5PS4F.js";
147
+ } from "../chunk-PK65B6HP.js";
147
148
  import "../chunk-DSMGS4IV.js";
148
149
  import "../chunk-5BJHKQ33.js";
149
150
  import "../chunk-6A7MYOUI.js";
@@ -271,6 +272,7 @@ export {
271
272
  plannedHostRestart,
272
273
  predictColdArrival,
273
274
  preferredWorkspaceSandboxRecoveryBoxKey,
275
+ readDuringPlannedHostRestart,
274
276
  readSandboxBinaryBytes,
275
277
  requireTransportableModel,
276
278
  resetClientCache,
@@ -15,6 +15,11 @@ export declare const SANDBOX_TRANSIENT_DEADLINE_MS: number;
15
15
  export declare function sandboxTransientBackoffMs(attempt: number): number;
16
16
  /** A planned host-agent swap leaves the sandbox alive; an ordinary probe failure is not that evidence. */
17
17
  export declare function plannedHostRestart(error: unknown): boolean;
18
+ /** Wait only for the platform typed planned-restart signal, within the caller budget. */
19
+ export declare function readDuringPlannedHostRestart<T>(read: () => Promise<T>, deadline: number): Promise<{
20
+ value: T;
21
+ waited: boolean;
22
+ }>;
18
23
  /** The typed transient failure `error` carries anywhere in its cause chain, or null. */
19
24
  export declare function classifySandboxTransientFailure(error: unknown): SandboxTransientFailure | null;
20
25
  /** The error a caller raises when a transient failure outlasted the deadline. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tangle-network/agent-app",
3
- "version": "0.62.1",
3
+ "version": "0.62.3",
4
4
  "packageManager": "pnpm@11.24.0",
5
5
  "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
6
6
  "keywords": [