@tangle-network/sandbox 0.36.3 → 0.36.4

package/dist/agent/index.js

@@ -1,7 +1,7 @@
 import { f as assertCurrentBackendType } from "../runtime-api-ClXF8k_q.js";
 import { d as StateError, o as NotFoundError, p as ValidationError } from "../errors-C6kn-3zt.js";
-import { n as Sandbox } from "../client-4KbDo0dU.js";
-import { t as SandboxInstance } from "../sandbox-DsnIsKUL.js";
+import { n as Sandbox } from "../client-DG0Pwadv.js";
+import { t as SandboxInstance } from "../sandbox--QhO618M.js";
 import { createRequire } from "node:module";
 //#region src/agent/instances.ts
 const managers = /* @__PURE__ */ new WeakMap();

package/dist/{client-4KbDo0dU.js → client-DG0Pwadv.js}

@@ -1,7 +1,7 @@
 import { _ as backendTypeSchema, c as encodePromptForWire, d as applyRequestedModel, f as assertCurrentBackendType, l as encodeTextForWire, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as normalizeRuntimeBackendConfig, u as parseSSEStream } from "./runtime-api-ClXF8k_q.js";
 import { a as NetworkError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.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-DsnIsKUL.js";
+import { E as normalizeConnection, O as exportTraceBundle, b as requestInteractiveSessionToken, i as normalizeStartupDiagnostics, n as createSandboxInstanceFromResponse, r as normalizeSandboxCreateReceipt } from "./sandbox--QhO618M.js";
 import { agentProfileSchema } from "@tangle-network/agent-interface";
 import { z } from "zod";
 //#region src/backend-registry.ts

package/dist/core.js

@@ -1,4 +1,4 @@
 import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.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-4KbDo0dU.js";
-import { a as WorkspaceImages, t as SandboxInstance } from "./sandbox-DsnIsKUL.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-DG0Pwadv.js";
+import { a as WorkspaceImages, t as SandboxInstance } from "./sandbox--QhO618M.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/index.js

@@ -1,10 +1,10 @@
 import { _ as backendTypeSchema, g as deriveAgentRunOutcome, h as deriveAgentResultOutcome, m as createAgentRunOutcomeTracker, p as normalizeRuntimeBackendConfig, u as parseSSEStream, v as parseBackendType } from "./runtime-api-ClXF8k_q.js";
 import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, r as EgressProxyRecoveryError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.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-4KbDo0dU.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-DG0Pwadv.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-DsnIsKUL.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--QhO618M.js";
 import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "./collaboration-DQD9kCdN.js";
-import { t as TangleSandboxClient } from "./tangle-BbYJI8g_.js";
+import { t as TangleSandboxClient } from "./tangle-CaYKcNaS.js";
 import { SANDBOX_SIZE_PRESET_NAMES, agentProfileConfidentialSchema, agentProfileSchema } from "@tangle-network/agent-interface";
 import { z } from "zod";
 //#region src/confidential.ts

package/dist/{sandbox-DsnIsKUL.js → sandbox--QhO618M.js}

@@ -3455,6 +3455,65 @@ const delayUntilAborted = (ms, signal) => new Promise((resolve, reject) => {
 	}
 	signal?.addEventListener("abort", onAbort, { once: true });
 });
+/**
+* The platform's typed refusal when one sandbox already has a lifecycle
+* operation in flight: HTTP 409 from `withSandboxLifecycleClaim`
+* (products/sandbox/api/src/routes/sandbox-lifecycle-claim.ts).
+*/
+const LIFECYCLE_CONFLICT_CODE = "SANDBOX_LIFECYCLE_IN_PROGRESS";
+/**
+* How long a lifecycle call re-attempts that refusal before it surfaces.
+*
+* MEASURED MOTIVE. `resume`, `stop` and `delete` are the only three routes the
+* API guards, and they share one lease per sandbox, `lifecycle-<id>`. That
+* lease outlives the response of the call that took it: the delete handler
+* registers deferred key-revoke and meta-delete work through
+* `deferSandboxLifecycleWork`, and the release is chained after that work
+* through `executionCtx.waitUntil`. So a second lifecycle call landing inside
+* that window is refused even though nothing is wrong and the caller only has
+* to wait. The platform's own workflow smoke already hand-rolls this retry and
+* says why (scripts/platform-workflow-deploy-smoke.mjs: "the worker can still
+* hold the sandbox lifecycle claim while its final action cleanup completes,
+* so sandbox-api returns a typed 409 for a short, valid window").
+*
+* The number: 2 of 2 provider-seam runs on 2026-09-01 (tangle-network/agent-sdk#280)
+* lost a completed agent turn to this refusal. `agent-runtime`'s provider
+* executor destroys one environment twice — once when the stream settles and
+* once from `teardown()` — and the second DELETE was refused, which discarded
+* the first one's result. Nothing about the sandbox document tells a client the
+* lease is held (the response schema is `.strict()` and carries no lifecycle
+* field), so a status poll cannot replace this retry.
+*
+* The ceiling is short on purpose. The lease TTL is 360 s, but the window this
+* closes is the deferred-cleanup tail of an operation that already answered;
+* a conflict that outlives ~11 s is a genuinely concurrent operation and
+* belongs to the caller, not to a longer sleep here.
+*/
+const LIFECYCLE_CONFLICT_MAX_ATTEMPTS = 6;
+const LIFECYCLE_CONFLICT_BASE_DELAY_MS = 500;
+const LIFECYCLE_CONFLICT_MAX_DELAY_MS = 4e3;
+function isLifecycleConflict(cause) {
+	return cause instanceof SandboxError && cause.status === 409 && cause.code === LIFECYCLE_CONFLICT_CODE;
+}
+function lifecycleConflictDelayMs(cause, failedAttempt) {
+	if (cause instanceof SandboxError && cause.retryAfterMs !== void 0) return cause.retryAfterMs;
+	return Math.min(LIFECYCLE_CONFLICT_BASE_DELAY_MS * 2 ** Math.max(0, failedAttempt - 1), LIFECYCLE_CONFLICT_MAX_DELAY_MS);
+}
+/**
+* Run one lifecycle mutation, re-attempting only the platform's typed
+* "already in progress" refusal.
+*
+* Every other failure keeps its identity and its stack: this widens no other
+* error class, and a caller abort ends the wait immediately.
+*/
+async function withLifecycleConflictRetry(run, options) {
+	for (let attempt = 1;; attempt += 1) try {
+		return await run();
+	} catch (error) {
+		if (!isLifecycleConflict(error) || attempt >= LIFECYCLE_CONFLICT_MAX_ATTEMPTS || options?.signal?.aborted) throw error;
+		await delayUntilAborted(lifecycleConflictDelayMs(error, attempt), options?.signal);
+	}
+}
 const SANDBOX_STATUS_FRESHNESS_MS = 1e3;
 const sandboxStatusObservedAt = /* @__PURE__ */ new WeakMap();
 const directRuntimeInstances = /* @__PURE__ */ new WeakSet();
@@ -6820,11 +6879,14 @@ var SandboxInstance = class SandboxInstance {
 	* returns it (replacing the create breakdown).
 	*/
 	async stop() {
-		const response = await this.client.fetch(`/v1/sandboxes/${this.id}/stop`, { method: "POST" });
-		if (!response.ok) {
-			const body = await response.text();
-			throw parseErrorResponse(response.status, body, void 0, response.headers);
-		}
+		const response = await withLifecycleConflictRetry(async () => {
+			const attempt = await this.client.fetch(`/v1/sandboxes/${this.id}/stop`, { method: "POST" });
+			if (!attempt.ok) {
+				const body = await attempt.text();
+				throw parseErrorResponse(attempt.status, body, void 0, attempt.headers);
+			}
+			return attempt;
+		});
 		const data = await this.readLifecycleResponse(response);
 		if (!this.applyLifecycleResponse(data)) await this.refresh();
 		const diagnostics = data ? normalizeStartupDiagnostics(data.startupDiagnostics) : null;
@@ -6837,14 +6899,17 @@ var SandboxInstance = class SandboxInstance {
 		if (options.timeoutMs !== void 0 && (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0)) throw new ValidationError("resume timeoutMs must be a positive number");
 		const timeoutSignal = options.timeoutMs ? AbortSignal.timeout(options.timeoutMs) : void 0;
 		const signal = timeoutSignal ? options.signal ? combineAbortSignals([options.signal, timeoutSignal]) : timeoutSignal : options.signal;
-		const response = await this.client.fetch(`/v1/sandboxes/${this.id}/resume`, {
-			method: "POST",
-			...signal ? { signal } : {}
-		}, usableTimeoutMs(options.timeoutMs));
-		if (!response.ok) {
-			const body = await response.text();
-			throw parseErrorResponse(response.status, body, void 0, response.headers);
-		}
+		const response = await withLifecycleConflictRetry(async () => {
+			const attempt = await this.client.fetch(`/v1/sandboxes/${this.id}/resume`, {
+				method: "POST",
+				...signal ? { signal } : {}
+			}, usableTimeoutMs(options.timeoutMs));
+			if (!attempt.ok) {
+				const body = await attempt.text();
+				throw parseErrorResponse(attempt.status, body, void 0, attempt.headers);
+			}
+			return attempt;
+		}, signal ? { signal } : {});
 		const data = await this.readLifecycleResponse(response);
 		if (!this.applyLifecycleResponse(data)) await this.refresh();
 		const diagnostics = data ? normalizeStartupDiagnostics(data.startupDiagnostics) : null;
@@ -6863,10 +6928,26 @@ var SandboxInstance = class SandboxInstance {
 	* now-gone sandbox.
 	*/
 	async delete() {
-		const response = await this.client.fetch(`/v1/sandboxes/${this.id}`, { method: "DELETE" });
-		if (!response.ok) {
-			const body = await response.text();
-			throw parseErrorResponse(response.status, body, void 0, response.headers);
+		let sawLifecycleConflict = false;
+		let response;
+		try {
+			response = await withLifecycleConflictRetry(async () => {
+				const attempt = await this.client.fetch(`/v1/sandboxes/${this.id}`, { method: "DELETE" });
+				if (!attempt.ok) {
+					const body = await attempt.text();
+					const refusal = parseErrorResponse(attempt.status, body, void 0, attempt.headers);
+					if (isLifecycleConflict(refusal)) sawLifecycleConflict = true;
+					throw refusal;
+				}
+				return attempt;
+			});
+		} catch (caught) {
+			if (!sawLifecycleConflict || !(caught instanceof NotFoundError)) throw caught;
+			sandboxStatusObservedAt.delete(this);
+			return {
+				sandboxId: this.id,
+				outcome: "already_absent"
+			};
 		}
 		const data = await response.json().catch(() => null);
 		const diagnostics = data ? normalizeStartupDiagnostics(data.startupDiagnostics) : null;

package/dist/tangle/index.js

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

package/dist/{tangle-BbYJI8g_.js → tangle-CaYKcNaS.js}

@@ -1,5 +1,5 @@
 import { m as parseErrorResponse } from "./errors-C6kn-3zt.js";
-import { n as createSandboxInstanceFromResponse } from "./sandbox-DsnIsKUL.js";
+import { n as createSandboxInstanceFromResponse } from "./sandbox--QhO618M.js";
 //#region src/tangle/abi.ts
 /**
 * Tangle Contract ABI Definitions

package/package.json

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