@tangle-network/sandbox 0.40.0 → 0.40.2

package/README.md

@@ -299,6 +299,15 @@ This evidence does not exclude a sandbox from an earlier call with that key.
 Cleanup may skip same-key recovery after `"not-admitted"` only when the key was fresh for this call.
 Transport failures and unclassified responses remain uncertain; keep their recovery path.
 
+Read `SandboxError.etaSeconds` when the control plane publishes one.
+A capacity refusal can carry the cell's own estimate of when it expects to place a create again, measured from the host add already in flight.
+Use it to schedule your next attempt.
+It says nothing about whether this call admitted a sandbox, and it is not a retry hint: `retryAfterMs` alone paces the SDK's own attempts.
+An absent value means the cell published no estimate, not that the wait is short.
+
+`TimeoutError.timeoutMs` is the budget you set, not how long the call ran.
+Read `TimeoutError.elapsedMs` for the duration: `create()` ends before its budget when a server-supplied `Retry-After` outlasts the remainder, because no attempt can follow that sleep.
+
 ## Commands and files
 
 `exec()` returns the exit code, standard output, standard error, and timing data.

package/dist/agent/index.js

@@ -1,7 +1,7 @@
-import { f as assertCurrentBackendType } from "../runtime-api-CphOtyu8.js";
-import { f as StateError, m as ValidationError, s as NotFoundError } from "../errors-V6uPkjfJ.js";
-import { n as Sandbox } from "../client-BcIFgcPD.js";
-import { t as SandboxInstance } from "../sandbox-ag2J5VWe.js";
+import { f as assertCurrentBackendType } from "../runtime-api-BWVLRX-H.js";
+import { f as StateError, m as ValidationError, s as NotFoundError } from "../errors-yyl3f2Fc.js";
+import { n as Sandbox } from "../client-Cms_WYuk.js";
+import { t as SandboxInstance } from "../sandbox-CYpk0k3s.js";
 import { createRequire } from "node:module";
 //#region src/agent/instances.ts
 const managers = /* @__PURE__ */ new WeakMap();

package/dist/{client-BcIFgcPD.js → client-Cms_WYuk.js}

@@ -1,7 +1,7 @@
-import { c as encodePromptForWire, d as applyRequestedModel, f as assertCurrentBackendType, l as encodeTextForWire, m as normalizeRuntimeBackendConfig, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, u as parseSSEStream, y as backendTypeSchema } from "./runtime-api-CphOtyu8.js";
-import { c as PartialFailureError, d as ServerError, h as parseErrorResponse, m as ValidationError, o as NetworkError, p as TimeoutError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-V6uPkjfJ.js";
+import { c as encodePromptForWire, d as applyRequestedModel, f as assertCurrentBackendType, l as encodeTextForWire, m as normalizeRuntimeBackendConfig, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, u as parseSSEStream, y as backendTypeSchema } from "./runtime-api-BWVLRX-H.js";
+import { c as PartialFailureError, d as ServerError, h as parseErrorResponse, m as ValidationError, o as NetworkError, p as TimeoutError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-yyl3f2Fc.js";
 import { n as combineAbortSignals } from "./abort-signal-si1WMfJb.js";
-import { E as normalizeConnection, O as exportTraceBundle, b as requestInteractiveSessionToken, i as normalizeStartupDiagnostics, n as createSandboxInstanceFromResponse, r as normalizeSandboxCreateReceipt } from "./sandbox-ag2J5VWe.js";
+import { E as normalizeConnection, O as exportTraceBundle, b as requestInteractiveSessionToken, i as normalizeStartupDiagnostics, n as createSandboxInstanceFromResponse, r as normalizeSandboxCreateReceipt } from "./sandbox-CYpk0k3s.js";
 import { agentProfileSchema } from "@tangle-network/agent-interface";
 import { z } from "zod";
 //#region src/backend-registry.ts
@@ -2820,7 +2820,17 @@ var Sandbox = class {
 		});
 		let lastServerError;
 		let allPreviousCreateAttemptsRefused = true;
-		const createTimeoutError = () => new TimeoutError(timeoutMs, `Sandbox create did not complete within ${timeoutMs}ms. ` + (lastServerError ? `The last attempt failed with ${lastServerError.code}${lastServerError.status === void 0 ? "" : ` (HTTP ${lastServerError.status})`}: ${lastServerError.message}. ` : "") + `The provision may still be running server-side; retry create() with idempotencyKey="${idempotencyKey}" to join it.`, allPreviousCreateAttemptsRefused && lastServerError?.createFailureDisposition === "not-admitted" ? { createFailureDisposition: "not-admitted" } : void 0, lastServerError);
+		const createTimeoutError = () => {
+			const etaSeconds = lastServerError?.etaSeconds;
+			const elapsedMs = Date.now() - startedAt;
+			const metadata = { elapsedMs };
+			if (allPreviousCreateAttemptsRefused && lastServerError?.createFailureDisposition === "not-admitted") metadata.createFailureDisposition = "not-admitted";
+			if (etaSeconds !== void 0) metadata.etaSeconds = etaSeconds;
+			const spentBudget = elapsedMs >= timeoutMs;
+			const preamble = spentBudget ? `Sandbox create did not complete within ${timeoutMs}ms. ` : `Sandbox create ended after ${elapsedMs}ms of its ${timeoutMs}ms budget. `;
+			const earlyExit = spentBudget || lastServerError?.retryAfterMs === void 0 ? "" : `The server asked for a ${Math.ceil(lastServerError.retryAfterMs / 1e3)}s wait, which the remaining budget cannot cover. `;
+			return new TimeoutError(timeoutMs, preamble + (lastServerError ? `The last attempt failed with ${lastServerError.code}${lastServerError.status === void 0 ? "" : ` (HTTP ${lastServerError.status})`}: ${lastServerError.message}. ` : "") + earlyExit + `The provision may still be running server-side; retry create() with idempotencyKey="${idempotencyKey}" to join it.` + (etaSeconds === void 0 ? "" : ` The cell expects capacity in about ${etaSeconds}s.`), metadata, lastServerError);
+		};
 		const sleepBeforeRetry = async (delayMs) => {
 			try {
 				await waitForCreateRetry(delayMs, postSignal);

package/dist/collaboration/index.js

@@ -1,2 +1,2 @@
-import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "../collaboration-CDvc5Hxk.js";
+import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "../collaboration-g2l-dEXt.js";
 export { CollaborationClient, CollaborationFileBridge, buildCollaborationDocumentId, normalizeCollaborationPath, parseCollaborationDocumentId };

package/dist/{collaboration-CDvc5Hxk.js → collaboration-g2l-dEXt.js}

@@ -1,4 +1,4 @@
-import { h as parseErrorResponse, o as NetworkError, p as TimeoutError } from "./errors-V6uPkjfJ.js";
+import { h as parseErrorResponse, o as NetworkError, p as TimeoutError } from "./errors-yyl3f2Fc.js";
 //#region src/collaboration/client.ts
 const DEFAULT_TIMEOUT_MS = 3e4;
 function normalizeBaseUrl(url) {

package/dist/core.d.ts

@@ -1,5 +1,5 @@
 import { a as WorkspaceImagePublishRequestOptions, i as WorkspaceImagePublishInput, o as WorkspaceImagePublishResult, r as SandboxInstance, s as WorkspaceImages } from "./sandbox-D0AkGWdW.js";
 import { Cn as PreviewLinkWaitOptions, Mn as PromptInputPart, R as CreateSandboxOptions, Sn as PreviewLinkManager, Vr as SandboxInfo, Yr as SandboxStatus, ar as SandboxConfig, dt as ExecResult, gn as NetworkConfig, ut as ExecOptions, xn as PreviewLinkInfo } from "./types-BzoZ0J0y.js";
 import { C as isBackendRegistryInteractionKind, S as backendRegistryResponseSchema, T as parseBackendRegistryResponseBody, _ as BackendRegistryInteractionKind, b as backendRegistryEntrySchema, g as BackendRegistryEntry, h as BackendRegistryCapabilities, i as Sandbox, v as BackendRegistryResponse, w as parseBackendRegistryResponse, x as backendRegistryInteractionKindSchema, y as backendRegistryCapabilitiesSchema } from "./client-DrnwHShd.js";
-import { a as FileWriteConflictError, c as PartialFailureError, d as SandboxErrorJson, f as SandboxFailureDetail, g as ValidationError, h as TimeoutError, l as QuotaError, m as StateError, n as CapabilityError, o as NetworkError, p as ServerError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-Cv3Td7LB.js";
+import { a as FileWriteConflictError, c as PartialFailureError, d as SandboxErrorJson, f as SandboxFailureDetail, g as ValidationError, h as TimeoutError, l as QuotaError, m as StateError, n as CapabilityError, o as NetworkError, p as ServerError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-A7Quee1Y.js";
 export { AuthError, type BackendRegistryCapabilities, type BackendRegistryEntry, type BackendRegistryInteractionKind, type BackendRegistryResponse, CapabilityError, type CreateSandboxOptions, type ExecOptions, type ExecResult, FileWriteConflictError, type NetworkConfig, NetworkError, NotFoundError, PartialFailureError, type PreviewLinkInfo, type PreviewLinkManager, type PreviewLinkWaitOptions, type PromptInputPart, QuotaError, Sandbox, type SandboxConfig, SandboxError, type SandboxErrorJson, type SandboxFailureDetail, type SandboxInfo, SandboxInstance, type SandboxStatus, ServerError, StateError, TimeoutError, ValidationError, type WorkspaceImagePublishInput, type WorkspaceImagePublishRequestOptions, type WorkspaceImagePublishResult, WorkspaceImages, backendRegistryCapabilitiesSchema, backendRegistryEntrySchema, backendRegistryInteractionKindSchema, backendRegistryResponseSchema, isBackendRegistryInteractionKind, parseBackendRegistryResponse, parseBackendRegistryResponseBody };

package/dist/core.js

@@ -1,4 +1,4 @@
-import { a as FileWriteConflictError, c as PartialFailureError, d as ServerError, f as StateError, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-V6uPkjfJ.js";
-import { _ as parseBackendRegistryResponse, f as backendRegistryCapabilitiesSchema, g as isBackendRegistryInteractionKind, h as backendRegistryResponseSchema, m as backendRegistryInteractionKindSchema, n as Sandbox, p as backendRegistryEntrySchema, v as parseBackendRegistryResponseBody } from "./client-BcIFgcPD.js";
-import { a as WorkspaceImages, t as SandboxInstance } from "./sandbox-ag2J5VWe.js";
+import { a as FileWriteConflictError, c as PartialFailureError, d as ServerError, f as StateError, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-yyl3f2Fc.js";
+import { _ as parseBackendRegistryResponse, f as backendRegistryCapabilitiesSchema, g as isBackendRegistryInteractionKind, h as backendRegistryResponseSchema, m as backendRegistryInteractionKindSchema, n as Sandbox, p as backendRegistryEntrySchema, v as parseBackendRegistryResponseBody } from "./client-Cms_WYuk.js";
+import { a as WorkspaceImages, t as SandboxInstance } from "./sandbox-CYpk0k3s.js";
 export { AuthError, CapabilityError, FileWriteConflictError, NetworkError, NotFoundError, PartialFailureError, QuotaError, Sandbox, SandboxError, SandboxInstance, ServerError, StateError, TimeoutError, ValidationError, WorkspaceImages, backendRegistryCapabilitiesSchema, backendRegistryEntrySchema, backendRegistryInteractionKindSchema, backendRegistryResponseSchema, isBackendRegistryInteractionKind, parseBackendRegistryResponse, parseBackendRegistryResponseBody };

package/dist/{errors-Cv3Td7LB.d.ts → errors-A7Quee1Y.d.ts}

@@ -22,6 +22,15 @@ declare class SandboxError extends Error {
   readonly sidecarVersion?: string;
   /** Sidecar image/tag/sha when the runtime emitted it */
   readonly containerImage?: string;
+  /**
+   * Seconds the control plane expects to need before it can serve this
+   * request, when it published one. Today only a capacity refusal on create
+   * carries it: the cell sizes it from the host add already in flight plus
+   * the measured p95 host-birth time, so it is a real wait, not a backoff
+   * hint. `retryAfterMs` paces the SDK's own retry; this is the number to
+   * show a human or feed to a scheduler.
+   */
+  readonly etaSeconds?: number;
   /**
    * On create's top-level error, proves this call's attempts admitted no
    * sandbox. Absence is unknown. Earlier errors in `cause` describe only
@@ -38,6 +47,9 @@ interface SandboxErrorMetadata {
   retryAfterMs?: number;
   sidecarVersion?: string;
   containerImage?: string;
+  etaSeconds?: number;
+  /** How long the operation ran, for a TimeoutError that measured it. */
+  elapsedMs?: number;
   createFailureDisposition?: "not-admitted";
 }
 type SandboxErrorJson = string | number | boolean | null | {
@@ -134,8 +146,19 @@ declare class EgressProxyRecoveryError extends SandboxError {
  * The request timed out.
  */
 declare class TimeoutError extends SandboxError {
-  /** Timeout duration in milliseconds */
+  /** The operation's configured budget, in milliseconds. NOT how long it ran. */
   readonly timeoutMs: number;
+  /**
+   * How long the operation actually ran before this error, in milliseconds,
+   * when the thrower measured it.
+   *
+   * `create()` can end before its budget: when a server-supplied `Retry-After`
+   * outlasts the remaining budget, no further attempt can follow that sleep,
+   * so the create ends there rather than idling. Reading `timeoutMs` as the
+   * duration would record a two-minute timeout for a three-second refusal.
+   * Absent means the thrower did not measure it; it never means `timeoutMs`.
+   */
+  readonly elapsedMs?: number;
   /**
    * The last typed failure the operation had already received when the
    * deadline fired, when there was one.

package/dist/{errors-V6uPkjfJ.js → errors-yyl3f2Fc.js}

@@ -23,6 +23,15 @@ var SandboxError = class extends Error {
 	/** Sidecar image/tag/sha when the runtime emitted it */
 	containerImage;
 	/**
+	* Seconds the control plane expects to need before it can serve this
+	* request, when it published one. Today only a capacity refusal on create
+	* carries it: the cell sizes it from the host add already in flight plus
+	* the measured p95 host-birth time, so it is a real wait, not a backoff
+	* hint. `retryAfterMs` paces the SDK's own retry; this is the number to
+	* show a human or feed to a scheduler.
+	*/
+	etaSeconds;
+	/**
 	* On create's top-level error, proves this call's attempts admitted no
 	* sandbox. Absence is unknown. Earlier errors in `cause` describe only
 	* their attempt prefix, not subsequent attempts or earlier calls using
@@ -39,6 +48,7 @@ var SandboxError = class extends Error {
 		this.retryAfterMs = metadata?.retryAfterMs;
 		this.sidecarVersion = metadata?.sidecarVersion;
 		this.containerImage = metadata?.containerImage;
+		this.etaSeconds = metadata?.etaSeconds;
 		this.createFailureDisposition = metadata?.createFailureDisposition;
 	}
 };
@@ -174,9 +184,20 @@ var EgressProxyRecoveryError = class extends SandboxError {
 * The request timed out.
 */
 var TimeoutError = class extends SandboxError {
-	/** Timeout duration in milliseconds */
+	/** The operation's configured budget, in milliseconds. NOT how long it ran. */
 	timeoutMs;
 	/**
+	* How long the operation actually ran before this error, in milliseconds,
+	* when the thrower measured it.
+	*
+	* `create()` can end before its budget: when a server-supplied `Retry-After`
+	* outlasts the remaining budget, no further attempt can follow that sleep,
+	* so the create ends there rather than idling. Reading `timeoutMs` as the
+	* duration would record a two-minute timeout for a three-second refusal.
+	* Absent means the thrower did not measure it; it never means `timeoutMs`.
+	*/
+	elapsedMs;
+	/**
 	* The last typed failure the operation had already received when the
 	* deadline fired, when there was one.
 	*
@@ -192,6 +213,7 @@ var TimeoutError = class extends SandboxError {
 		super(message ?? `Request timed out after ${timeoutMs}ms`, "TIMEOUT", 408, metadata);
 		this.name = "TimeoutError";
 		this.timeoutMs = timeoutMs;
+		this.elapsedMs = metadata?.elapsedMs;
 		this.cause = cause;
 	}
 };
@@ -228,6 +250,17 @@ function parseRetryAfterMs(rawValue, data) {
 	const targetTs = Date.parse(trimmed);
 	if (!Number.isNaN(targetTs)) return Math.max(0, targetTs - Date.now());
 }
+/**
+* The server's published wait, in seconds. Only a positive finite number is
+* a wait; anything else is absent. Never derived from `Retry-After` — that
+* header is a pacing hint every refusal carries, while `etaSeconds` is a
+* measurement the cell only publishes when it has one.
+*/
+function parseEtaSeconds(data) {
+	const raw = data.etaSeconds;
+	if (typeof raw !== "number" || !Number.isFinite(raw) || raw <= 0) return;
+	return raw;
+}
 function inferOrigin(headers, context) {
 	const derivedPath = context?.path ?? headers?.get("x-tangle-request-path") ?? void 0;
 	if (!headers) return context?.path ? "sandbox-api" : void 0;
@@ -317,6 +350,7 @@ function parseErrorResponse(status, body, context, headers) {
 		origin: inferOrigin(headers, context),
 		endpoint: context?.path ?? headers?.get("x-tangle-request-path") ?? void 0,
 		retryAfterMs: parseRetryAfterMs(headers?.get("retry-after") ?? void 0, data),
+		etaSeconds: parseEtaSeconds(data),
 		sidecarVersion: headers?.get("x-sidecar-version") ?? void 0,
 		containerImage: headers?.get("x-sidecar-image") ?? headers?.get("x-sidecar-image-tag") ?? void 0,
 		createFailureDisposition: context?.allPreviousCreateAttemptsRefused === true && (context.method ?? headers?.get("x-tangle-request-method")) === "POST" && (context.path ?? headers?.get("x-tangle-request-path")) === "/v1/sandboxes" && status === 429 && (code === "RATE_LIMIT_EXCEEDED" || code === "QUOTA_EXCEEDED" || code === "PLATFORM_RATE_LIMITED") ? "not-admitted" : void 0

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { $ as DurablePlanDecisionResult, $i as UploadProgress, $n as RolloutScor
 import { C as isBackendRegistryInteractionKind, S as backendRegistryResponseSchema, T as parseBackendRegistryResponseBody, _ as BackendRegistryInteractionKind, a as Team, b as backendRegistryEntrySchema, c as SessionBroadcastEvent, d as SandboxFleetClient, f as ParseSSEStreamOptions, g as BackendRegistryEntry, h as BackendRegistryCapabilities, i as Sandbox, l as SessionBroadcastResult, m as parseSSEStream, n as IntelligenceClient, o as TeamInvitation, p as ParsedSSEEvent, r as InviteTeamMemberOptions, s as TeamMember, t as CreateTeamOptions, u as SandboxFleet, v as BackendRegistryResponse, w as parseBackendRegistryResponse, x as backendRegistryInteractionKindSchema, y as backendRegistryCapabilitiesSchema } from "./client-DrnwHShd.js";
 import { d as AnyTokenPayload, h as IssueCollaborationTokenOptions, m as CollaborationTokenPayload, p as CollaborationAccess } from "./index-CS-t6tPU.js";
 import { _ as CollaborationTransportConfig, a as CollaborationClient, c as CollaborationClientConfig, d as CollaborationDocumentRef, f as CollaborationFileBridgeOptions, g as CollaborationTokenRefreshResponse, h as CollaborationTokenRefreshRequest, i as parseCollaborationDocumentId, l as CollaborationDocumentAdapter, m as CollaborationPermissions, n as buildCollaborationDocumentId, o as CollaborationBootstrapRequest, p as CollaborationFileEvent, r as normalizeCollaborationPath, s as CollaborationBootstrapResponse, t as CollaborationFileBridge, u as CollaborationDocumentChange, v as SaveCollaborationSnapshotRequest, y as SaveCollaborationSnapshotResponse } from "./index-BzAxTiqF.js";
-import { a as FileWriteConflictError, c as PartialFailureError, d as SandboxErrorJson, f as SandboxFailureDetail, g as ValidationError, h as TimeoutError, i as EgressProxyRecoveryError, l as QuotaError, m as StateError, n as CapabilityError, o as NetworkError, p as ServerError, r as EdgeNotReadyError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-Cv3Td7LB.js";
+import { a as FileWriteConflictError, c as PartialFailureError, d as SandboxErrorJson, f as SandboxFailureDetail, g as ValidationError, h as TimeoutError, i as EgressProxyRecoveryError, l as QuotaError, m as StateError, n as CapabilityError, o as NetworkError, p as ServerError, r as EdgeNotReadyError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-A7Quee1Y.js";
 import { a as deriveAgentRunOutcome, i as deriveAgentResultOutcome, n as AgentRunOutcomeTracker, r as createAgentRunOutcomeTracker, t as AgentRunOutcome } from "./agent-run-outcome-BurKaZq4.js";
 import { o as TangleSandboxClientConfig, t as TangleSandboxClient } from "./index-BpaR6oyX.js";
 import * as _$_tangle_network_agent_interface0 from "@tangle-network/agent-interface";

package/dist/index.js

@@ -1,10 +1,10 @@
-import { _ as deriveAgentRunOutcome, b as parseBackendType, g as deriveAgentResultOutcome, h as createAgentRunOutcomeTracker, m as normalizeRuntimeBackendConfig, u as parseSSEStream, v as ALL_BACKEND_TYPES, y as backendTypeSchema } from "./runtime-api-CphOtyu8.js";
-import { a as FileWriteConflictError, c as PartialFailureError, d as ServerError, f as StateError, i as EgressProxyRecoveryError, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, r as EdgeNotReadyError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-V6uPkjfJ.js";
-import { _ as parseBackendRegistryResponse, a as splitInlineProfileSkills, c as SandboxFleetClient, d as validateBatchRunRequest, f as backendRegistryCapabilitiesSchema, g as isBackendRegistryInteractionKind, h as backendRegistryResponseSchema, i as splitInlineProfileFileMounts, l as runtimeWorkspaceCwdSchema, m as backendRegistryInteractionKindSchema, n as Sandbox, o as validateDeferredProfileFileMounts, p as backendRegistryEntrySchema, r as materializeProfileFileMounts, s as SandboxFleet, t as IntelligenceClient, u as createBatchResultAccumulator, v as parseBackendRegistryResponseBody } from "./client-BcIFgcPD.js";
+import { _ as deriveAgentRunOutcome, b as parseBackendType, g as deriveAgentResultOutcome, h as createAgentRunOutcomeTracker, m as normalizeRuntimeBackendConfig, u as parseSSEStream, v as ALL_BACKEND_TYPES, y as backendTypeSchema } from "./runtime-api-BWVLRX-H.js";
+import { a as FileWriteConflictError, c as PartialFailureError, d as ServerError, f as StateError, i as EgressProxyRecoveryError, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, r as EdgeNotReadyError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-yyl3f2Fc.js";
+import { _ as parseBackendRegistryResponse, a as splitInlineProfileSkills, c as SandboxFleetClient, d as validateBatchRunRequest, f as backendRegistryCapabilitiesSchema, g as isBackendRegistryInteractionKind, h as backendRegistryResponseSchema, i as splitInlineProfileFileMounts, l as runtimeWorkspaceCwdSchema, m as backendRegistryInteractionKindSchema, n as Sandbox, o as validateDeferredProfileFileMounts, p as backendRegistryEntrySchema, r as materializeProfileFileMounts, s as SandboxFleet, t as IntelligenceClient, u as createBatchResultAccumulator, v as parseBackendRegistryResponseBody } from "./client-Cms_WYuk.js";
 import { a as INTERACTIVE_CONTROL_CLEANUP_TIMEOUT_MS, c as createInteractiveControlHolderId, l as interactiveSessionIdentityDigest, n as browserInteractiveControlHolderId, o as InteractiveSessionControlController, t as BrowserInteractiveSessionControlController } from "./browser-interactive-control-controller-Dv0gbFMu.js";
-import { A as toOtelJson, C as collectAgentResponseText, D as buildTraceExportPayload, O as exportTraceBundle, S as collectAgentFinalMessageText, T as isToolBearingEvent, _ as TerminalStream, a as WorkspaceImages, c as SandboxTaskSession, d as agentInteractiveSessionPromptRequestDigest, f as InteractiveTerminalFrameLog, g as InteractiveSessionController, h as BrowserInteractiveSessionController, k as otelTraceIdForTangleTrace, l as SandboxSession, m as createInteractiveTerminalSession, o as GPU_LEASE_PROVIDER_NAMES, p as createInteractiveTerminalCapture, s as MAX_EGRESS_DENIALS_LIMIT, t as SandboxInstance, u as InteractiveSessionHandle, v as TerminalStreamError, w as getSandboxEventText, x as applySandboxEventText, y as TERMINAL_WS_ECHO_SUBPROTOCOL } from "./sandbox-ag2J5VWe.js";
-import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "./collaboration-CDvc5Hxk.js";
-import { t as TangleSandboxClient } from "./tangle-CihgWU1K.js";
+import { A as toOtelJson, C as collectAgentResponseText, D as buildTraceExportPayload, O as exportTraceBundle, S as collectAgentFinalMessageText, T as isToolBearingEvent, _ as TerminalStream, a as WorkspaceImages, c as SandboxTaskSession, d as agentInteractiveSessionPromptRequestDigest, f as InteractiveTerminalFrameLog, g as InteractiveSessionController, h as BrowserInteractiveSessionController, k as otelTraceIdForTangleTrace, l as SandboxSession, m as createInteractiveTerminalSession, o as GPU_LEASE_PROVIDER_NAMES, p as createInteractiveTerminalCapture, s as MAX_EGRESS_DENIALS_LIMIT, t as SandboxInstance, u as InteractiveSessionHandle, v as TerminalStreamError, w as getSandboxEventText, x as applySandboxEventText, y as TERMINAL_WS_ECHO_SUBPROTOCOL } from "./sandbox-CYpk0k3s.js";
+import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "./collaboration-g2l-dEXt.js";
+import { t as TangleSandboxClient } from "./tangle-azrClJHf.js";
 import { SANDBOX_SIZE_PRESET_NAMES, agentProfileConfidentialSchema, agentProfileSchema } from "@tangle-network/agent-interface";
 import { z } from "zod";
 //#region src/confidential.ts

package/dist/intelligence/index.js

@@ -1,4 +1,4 @@
-import { h as parseErrorResponse, o as NetworkError, p as TimeoutError } from "../errors-V6uPkjfJ.js";
+import { h as parseErrorResponse, o as NetworkError, p as TimeoutError } from "../errors-yyl3f2Fc.js";
 //#region src/intelligence/index.ts
 /**
 * `@tangle-network/sandbox/intelligence` — browser-safe typed client for the

package/dist/{runtime-api-CphOtyu8.js → runtime-api-BWVLRX-H.js}

@@ -1,4 +1,4 @@
-import { d as ServerError, h as parseErrorResponse, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, u as SandboxError } from "./errors-V6uPkjfJ.js";
+import { d as ServerError, h as parseErrorResponse, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, u as SandboxError } from "./errors-yyl3f2Fc.js";
 import { n as combineAbortSignals } from "./abort-signal-si1WMfJb.js";
 import { AgentExactRunControlRefSchema, AgentExecutionOutcomeSchema, AgentRuntimeAttachmentsSchema, DurablePlanSchema, InteractionRequestSchema, agentProfileSchema, harnessTypeSchema } from "@tangle-network/agent-interface";
 import { z } from "zod";

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
 import { $i as UploadProgress, $r as SandboxTerminalManager, A as CommitTaskSessionOptions, B as CreateTaskSessionOptions, Ci as SessionMessage, Ct as FileUsageResult, Jr as SandboxRuntimeHealth, Qr as SandboxTerminalInfo, Ri as TaskSessionChanges, St as FileUsageOptions, T as ChunkedUploadResult, Ur as SandboxPortBinding, Vi as TaskSessionInfo, Zr as SandboxTerminalCreateOptions, _i as SessionExecutionStatus, _t as FileRenameResult, bi as SessionInfo, bt as FileTreeOptions, di as SendSessionMessageOptions, ei as SandboxTerminalRequestOptions, fi as SendSessionMessageRequest, fr as SandboxEvent, gi as SessionExecutionInfo, hi as SessionEventStreamOptions, ia as WriteFileOptions, ln as ListMessagesOptions, mt as FileReadBatchResult, pi as SentSessionMessage, pt as FileReadBatchOptions, qn as RenameOptions, w as ChunkedUploadOptions, wt as FileWriteResult, xt as FileTreeResult, z as CreateSessionOptions, zi as TaskSessionCommitResult } from "./types-BzoZ0J0y.js";
-import { a as FileWriteConflictError, c as PartialFailureError, d as SandboxErrorJson, f as SandboxFailureDetail, g as ValidationError, h as TimeoutError, l as QuotaError, m as StateError, n as CapabilityError, o as NetworkError, p as ServerError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-Cv3Td7LB.js";
+import { a as FileWriteConflictError, c as PartialFailureError, d as SandboxErrorJson, f as SandboxFailureDetail, g as ValidationError, h as TimeoutError, l as QuotaError, m as StateError, n as CapabilityError, o as NetworkError, p as ServerError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-A7Quee1Y.js";
 import { a as deriveAgentRunOutcome, i as deriveAgentResultOutcome, n as AgentRunOutcomeTracker, r as createAgentRunOutcomeTracker, t as AgentRunOutcome } from "./agent-run-outcome-BurKaZq4.js";
 
 //#region src/lib/chunked-upload.d.ts

package/dist/runtime.js

@@ -1,5 +1,5 @@
-import { _ as deriveAgentRunOutcome, a as uploadChunked, g as deriveAgentResultOutcome, h as createAgentRunOutcomeTracker, t as SandboxRuntimeApi } from "./runtime-api-CphOtyu8.js";
-import { a as FileWriteConflictError, c as PartialFailureError, d as ServerError, f as StateError, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-V6uPkjfJ.js";
+import { _ as deriveAgentRunOutcome, a as uploadChunked, g as deriveAgentResultOutcome, h as createAgentRunOutcomeTracker, t as SandboxRuntimeApi } from "./runtime-api-BWVLRX-H.js";
+import { a as FileWriteConflictError, c as PartialFailureError, d as ServerError, f as StateError, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-yyl3f2Fc.js";
 import { n as combineAbortSignals } from "./abort-signal-si1WMfJb.js";
 //#region src/runtime-client.ts
 const DEFAULT_RUNTIME_TIMEOUT_MS = 3e4;

package/dist/{sandbox-ag2J5VWe.js → sandbox-CYpk0k3s.js}

@@ -1,5 +1,5 @@
-import { a as uploadChunked, c as encodePromptForWire, d as applyRequestedModel, f as assertCurrentBackendType, g as deriveAgentResultOutcome, h as createAgentRunOutcomeTracker, i as sessionHeaders, m as normalizeRuntimeBackendConfig, n as normalizeSessionInfo, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as mergeRuntimeBackendConfig, r as appendSessionIdQuery, t as SandboxRuntimeApi, u as parseSSEStream } from "./runtime-api-CphOtyu8.js";
-import { d as ServerError, f as StateError, h as parseErrorResponse, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, r as EdgeNotReadyError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-V6uPkjfJ.js";
+import { a as uploadChunked, c as encodePromptForWire, d as applyRequestedModel, f as assertCurrentBackendType, g as deriveAgentResultOutcome, h as createAgentRunOutcomeTracker, i as sessionHeaders, m as normalizeRuntimeBackendConfig, n as normalizeSessionInfo, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as mergeRuntimeBackendConfig, r as appendSessionIdQuery, t as SandboxRuntimeApi, u as parseSSEStream } from "./runtime-api-BWVLRX-H.js";
+import { d as ServerError, f as StateError, h as parseErrorResponse, l as QuotaError, m as ValidationError, n as CapabilityError, o as NetworkError, p as TimeoutError, r as EdgeNotReadyError, s as NotFoundError, t as AuthError, u as SandboxError } from "./errors-yyl3f2Fc.js";
 import { c as createInteractiveControlHolderId, d as interactiveSessionControlReleaseResponseSchema, f as interactiveSessionControlValidationResponseSchema, i as createBrowserInteractiveSessionControlTransport, o as InteractiveSessionControlController, p as interactiveSessionStatusResponseSchema, r as browserInteractiveTerminalEndpoint, s as assertInteractiveSessionRef, u as interactiveSessionControlClaimResponseSchema } from "./browser-interactive-control-controller-Dv0gbFMu.js";
 import { n as combineAbortSignals, t as awaitWithAbort } from "./abort-signal-si1WMfJb.js";
 import { AgentExactRunControlRefSchema, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentRunCancellationAcknowledgementSchema, AgentRunCancellationRequestSchema, InteractionAcknowledgementSchema, InteractionBindingSchema, InteractionRequestSchema, InteractionResponseCommandSchema, InteractionResponseSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionStatusMatchesRef, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentRunCancellationAcknowledgementMatchesRequest, canonicalCandidateDigest, exactAgentInteractiveSessionStart, sha256DigestSchema, terminalSessionUsable } from "@tangle-network/agent-interface";
@@ -6586,6 +6586,7 @@ var SandboxInstance = class SandboxInstance {
 			const status = await response.json();
 			if (status.status === "failed" || status.result?.success === false) throw new ServerError(status.result?.error ?? `Snapshot restore job ${accepted.jobId} failed`);
 			if (status.status === "completed") {
+				this.applyLifecycleResponse(status.sandbox ?? null);
 				const restored = status.result?.snapshot;
 				if (restored) return {
 					snapshotId: restored.snapshotId,

package/dist/tangle/index.js

@@ -1,2 +1,2 @@
-import { a as TANGLE_JOBS_CONTRACT, c as JsonResponseParamTypes, d as SandboxIdParamTypes, i as TANGLE_CHAIN_ID, l as SandboxCreateParamTypes, n as JOB_SANDBOX_CREATE, o as AgentSandboxBlueprintAbi, r as JOB_SANDBOX_DELETE, s as ITangleJobsAbi, t as TangleSandboxClient, u as SandboxCreateResponseParamTypes } from "../tangle-CihgWU1K.js";
+import { a as TANGLE_JOBS_CONTRACT, c as JsonResponseParamTypes, d as SandboxIdParamTypes, i as TANGLE_CHAIN_ID, l as SandboxCreateParamTypes, n as JOB_SANDBOX_CREATE, o as AgentSandboxBlueprintAbi, r as JOB_SANDBOX_DELETE, s as ITangleJobsAbi, t as TangleSandboxClient, u as SandboxCreateResponseParamTypes } from "../tangle-azrClJHf.js";
 export { AgentSandboxBlueprintAbi, ITangleJobsAbi, JOB_SANDBOX_CREATE, JOB_SANDBOX_DELETE, JsonResponseParamTypes, SandboxCreateParamTypes, SandboxCreateResponseParamTypes, SandboxIdParamTypes, TANGLE_CHAIN_ID, TANGLE_JOBS_CONTRACT, TangleSandboxClient };

package/dist/{tangle-CihgWU1K.js → tangle-azrClJHf.js}

@@ -1,5 +1,5 @@
-import { h as parseErrorResponse } from "./errors-V6uPkjfJ.js";
-import { n as createSandboxInstanceFromResponse } from "./sandbox-ag2J5VWe.js";
+import { h as parseErrorResponse } from "./errors-yyl3f2Fc.js";
+import { n as createSandboxInstanceFromResponse } from "./sandbox-CYpk0k3s.js";
 //#region src/tangle/abi.ts
 /**
 * Tangle Contract ABI Definitions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox",
-  "version": "0.40.0",
+  "version": "0.40.2",
   "description": "Client SDK for the Tangle Sandbox platform - build AI agent applications with dev containers",
   "type": "module",
   "sideEffects": [