@tangle-network/sandbox 0.11.1-develop.20260718200351.2f5db96 → 0.11.1

package/dist/{sandbox-C0qo2TZO.d.ts → sandbox-BRoxCvpS.d.ts}

@@ -1,5 +1,4 @@
-import { $r as SendSessionMessageRequest, $t as ListMessagesOptions, At as GitBranch, Bi as WriteManyOptions, Bn as RolloutOptions, Bt as GpuLeaseManager, Cn as ProvisionEvent, D as CodeExecutionOptions, Ei as TeeAttestationResponse, Fr as SandboxRuntimeProfileList, Ft as GpuLease, H as CreateTaskSessionOptions, Hn as RolloutStartResult, Ii as WaitForOptions, In as RestoreSnapshotOptions, Ir as SandboxStatus, Jr as SearchMatch, Jt as IntelligenceReportBudget, K as DispatchPromptOptions, Kn as SSHCommandDescriptor, Kr as ScopedToken, Kt as InstalledTool, Li as WaitForRolloutOptions, Ln as ResumeOptions, M as CommitTaskSessionOptions, N as CompletedTurnResult, Nr as SandboxRuntimeHealth, Nt as GitDiff, O as CodeExecutionResult, Oi as TeePublicKeyResponse, Or as SandboxPortBinding, Pt as GitStatus, Q as DriverInfo, Qr as SendSessionMessageOptions, Qt as JsonValue, Ri as WriteFileOptions, Rn as Rollout, Si as TaskSessionInfo, Sn as PromptResult, Tr as SandboxInfo, V as CreateSessionOptions, Vr as SandboxTraceBundle, Wr as SandboxTraceOptions, X as DriveTurnOptions, Yn as SandboxConnection, Yr as SearchOptions, Yt as IntelligenceReportCompareTo, Zn as SandboxEvent, Zt as IntelligenceReportWindow, _i as TaskOptions, ai as SessionListOptions, bi as TaskSessionCommitResult, bn as PromptInputPart, di as SnapshotResult, ei as SentSessionMessage, et as DurablePlan, fn as PreviewLinkManager, gn as ProcessManager, gr as SandboxFleetTraceBundle, ii as SessionInfo, in as MintScopedTokenOptions, it as EventStreamOptions, ji as TurnDriveResult, jr as SandboxResourceUsage, jt as GitCommit, k as CodeLanguage, l as BackendManager, li as SnapshotInfo, mt as FileSystem, ni as SessionEventStreamOptions, oi as SessionMessage, ot as ExecOptions, pi as StartupDiagnostics, q as DispatchedSession, qn as SSHCredentials, qt as IntelligenceReport, ri as SessionForkOptions, s as BackendConfig, sn as NetworkManager, st as ExecResult, tt as EgressManager, ui as SnapshotOptions, un as PermissionsManager, vi as TaskResult, vt as FileWriteResult, w as BranchOptions, wi as TeeAttestationOptions, wn as ProvisionResult, xn as PromptOptions, yi as TaskSessionChanges, zi as WriteManyFile, zr as SandboxTerminalManager } from "./types-DACKEpON.js";
-import { AgentProfile } from "@tangle-network/agent-interface";
+import { $ as DurablePlan, Bn as RolloutStartResult, Cr as SandboxInfo, D as CodeExecutionOptions, Ei as TeePublicKeyResponse, Er as SandboxPortBinding, Fi as WaitForRolloutOptions, Fn as ResumeOptions, G as DispatchPromptOptions, Gn as SSHCredentials, Gt as IntelligenceReport, H as CreateTaskSessionOptions, Hr as SandboxTraceOptions, Ii as WriteFileOptions, In as Rollout, K as DispatchedSession, Kr as SearchMatch, Kt as IntelligenceReportBudget, Li as WriteManyFile, Lr as SandboxTerminalManager, M as CommitTaskSessionOptions, Mt as GitStatus, N as CompletedTurnResult, Nr as SandboxRuntimeProfileList, Nt as GpuLease, O as CodeExecutionResult, Ot as GitBranch, Pi as WaitForOptions, Pn as RestoreSnapshotOptions, Pr as SandboxStatus, Qr as SentSessionMessage, Ri as WriteManyOptions, Rn as RolloutOptions, Rt as GpuLeaseManager, Si as TeeAttestationOptions, Sn as ProvisionResult, V as CreateSessionOptions, Wn as SSHCommandDescriptor, Wr as ScopedToken, Wt as InstalledTool, Xr as SendSessionMessageOptions, Xt as JsonValue, Y as DriveTurnOptions, Yn as SandboxEvent, Yt as IntelligenceReportWindow, Z as DriverInfo, Zr as SendSessionMessageRequest, Zt as ListMessagesOptions, _i as TaskSessionChanges, an as NetworkManager, at as ExecResult, bi as TaskSessionInfo, bn as PromptResult, ci as SnapshotOptions, cn as PermissionsManager, di as StartupDiagnostics, ei as SessionEventStreamOptions, et as EgressManager, ft as FileSystem, gi as TaskResult, gt as FileWriteResult, hi as TaskOptions, ii as SessionMessage, it as ExecOptions, jr as SandboxRuntimeHealth, jt as GitDiff, k as CodeLanguage, ki as TurnDriveResult, kr as SandboxResourceUsage, kt as GitCommit, l as BackendManager, li as SnapshotResult, mn as ProcessManager, mr as SandboxFleetTraceBundle, ni as SessionInfo, nn as MintScopedTokenOptions, nt as EventStreamOptions, qn as SandboxConnection, qr as SearchOptions, qt as IntelligenceReportCompareTo, ri as SessionListOptions, s as BackendConfig, si as SnapshotInfo, ti as SessionForkOptions, un as PreviewLinkManager, vi as TaskSessionCommitResult, vn as PromptInputPart, w as BranchOptions, wi as TeeAttestationResponse, xn as ProvisionEvent, yn as PromptOptions, zr as SandboxTraceBundle } from "./types-D2C72ySk.js";
 
 //#region src/mcp.d.ts
 /**
@@ -113,6 +112,18 @@ declare function buildControlPlaneMcpConfig(options: BuildControlPlaneMcpConfigO
 };
 //#endregion
 //#region src/interactive.d.ts
+/**
+ * Interactive harness sessions on the public SDK.
+ *
+ * `box.session(id).interactive()` returns a handle that spawns a coding
+ * harness's native interactive TUI in the sandbox (start), drives it with
+ * prompts (sendPrompt), and tears it down (stop). The live framebuffer is
+ * streamed over the WebSocket at the returned `streamUrl` (the secured
+ * `/terminals/:id/ws` pixel lane) — open it with your terminal/xterm client.
+ *
+ * This is the public SDK surface of the Session Protocol Gateway; it rides the
+ * same secured runtime routes as the rest of the SDK.
+ */
 /** CLI auth file materialized into the harness's auth home before launch. */
 interface InteractiveAuthFile {
   path: string;
@@ -120,12 +131,7 @@ interface InteractiveAuthFile {
   mode?: number;
 }
 interface StartInteractiveOptions {
-  /**
-   * Harness with a native interactive TUI (bare binary launches it): e.g.
-   * "claude-code", "codex", "opencode", "kimi-code", "factory-droids",
-   * "forge", "pi", "amp", "hermes". The sidecar's harness registry is the
-   * authority; it rejects harnesses without a TUI entrypoint (e.g. "cursor").
-   */
+  /** Harness with a native interactive TUI: "claude-code" | "codex" | "kimi-code". */
   harness: string;
   model?: string;
   apiKey?: string;
@@ -136,20 +142,6 @@ interface StartInteractiveOptions {
   cols?: number;
   rows?: number;
   authFiles?: InteractiveAuthFile[];
-  /**
-   * Canonical agent profile (persona, skills, tool policy, MCP). When set, the
-   * sidecar materializes it into `cwd` before spawning the TUI, so the
-   * interactive session runs AS the configured agent rather than a bare harness.
-   * Omit to launch the harness's default TUI.
-   */
-  profile?: AgentProfile;
-  /**
-   * Opening message the TUI submits on its own once ready (via the harness's
-   * prompt launch arg). Use this to start the agent working immediately instead
-   * of writing keystrokes after start — a TUI drops input sent before it is
-   * ready to read. Omit for a session that opens idle.
-   */
-  initialPrompt?: string;
 }
 interface InteractiveSessionInfo {
   sessionId: string;
@@ -162,28 +154,6 @@ interface InteractiveSessionInfo {
    */
   streamUrl: string;
 }
-/**
- * Snapshot of an interactive session's lifecycle: still running, or exited
- * with its exit code (served from the sidecar's bounded exit tombstone).
- * `status()` returns `null` when the sidecar no longer knows the id — never
- * started, tombstone evicted, or superseded by a restart under the same id.
- */
-type InteractiveSessionStatus = {
-  state: "running";
-  sessionId: string;
-  harness: string;
-  startedAt: string;
-  streamUrl: string;
-} | {
-  state: "exited";
-  sessionId: string;
-  harness: string;
-  startedAt: string;
-  endedAt: string;
-  exitCode?: number;
-  exitSignal?: string; /** "exited" = the process ended on its own; "stopped" = explicit stop(). */
-  reason: "exited" | "stopped";
-};
 /** Decision passed to `respondToPermission`. */
 interface RespondToPermissionOptions {
   /** The human's decision for the awaiting permission interaction. */
@@ -208,13 +178,6 @@ interface InteractiveSessionHost {
   _startInteractive(id: string, options: StartInteractiveOptions): Promise<InteractiveSessionInfo>;
   _sendInteractivePrompt(id: string, prompt: string): Promise<void>;
   _stopInteractive(id: string): Promise<void>;
-  /**
-   * Optional so adding it does not break existing implementers of this exported
-   * interface (a required addition is a breaking change; this is additive). A
-   * host that omits it makes `InteractiveSessionHandle.status()` reject with a
-   * clear "not supported" error instead of failing to compile downstream.
-   */
-  _interactiveStatus?(id: string): Promise<InteractiveSessionStatus | null>;
 }
 /**
  * Handle for one session's interactive harness. Obtained via
@@ -228,19 +191,12 @@ declare class InteractiveSessionHandle {
   /**
    * Spawn the harness's interactive TUI for this session. Returns the
    * `streamUrl` to attach a terminal client to. Throws if the harness has no
-   * interactive entrypoint (e.g. cursor, which is SDK-only), the binary is
-   * not installed, or a session is already running for this id.
+   * interactive entrypoint (e.g. opencode), the binary is not installed, or a
+   * session is already running for this id.
    */
   start(options: StartInteractiveOptions): Promise<InteractiveSessionInfo>;
   /** Inject a prompt as keystrokes into the live harness (submitted on send). */
   sendPrompt(prompt: string): Promise<void>;
-  /**
-   * Observe the session: running, exited (with its exit code), or `null`
-   * when the sidecar no longer knows the id. Poll this to detect completion —
-   * an interactive session has no structured result stream, so the exit
-   * tombstone is the completion signal.
-   */
-  status(): Promise<InteractiveSessionStatus | null>;
   /** Stop the interactive harness and reap its PTY. */
   stop(): Promise<void>;
 }
@@ -256,7 +212,7 @@ interface SandboxSessionHost extends InteractiveSessionHost {
   prompt(message: string | PromptInputPart[], options?: PromptOptions): Promise<PromptResult>;
   _sessionStatus(id: string): Promise<SessionInfo | null>;
   _sessionEvents(id: string, opts?: SessionEventStreamOptions): AsyncGenerator<SandboxEvent>;
-  _sessionResult(id: string, session?: SessionInfo): Promise<PromptResult>;
+  _sessionResult(id: string): Promise<PromptResult>;
   _sessionCancel(id: string): Promise<void>;
   _sessionDelete(id: string): Promise<void>;
   _sessionSendMessage(id: string, request: SendSessionMessageRequest, options?: SendSessionMessageOptions): Promise<SentSessionMessage>;
@@ -307,10 +263,9 @@ declare class SandboxSession {
    */
   events(opts?: SessionEventStreamOptions): AsyncGenerator<SandboxEvent>;
   /**
-   * Await the session's terminal result. Reads status and drains events
-   * from the latest execution until the session reaches a terminal state,
-   * then returns the aggregated `PromptResult`. Event replay makes this safe
-   * to call after the execution has already finished.
+   * Await the session's terminal result. Polls status + drains events
+   * until the session reaches a terminal state, then returns the
+   * aggregated `PromptResult`.
    *
    * Use this to wait for a session that was started by another caller
    * (e.g. `dispatchPrompt`).
@@ -328,10 +283,8 @@ declare class SandboxSession {
    */
   prompt(message: string | PromptInputPart[], opts?: PromptOptions): Promise<PromptResult>;
   /**
-   * Submit a structured message through the session message endpoint. The
-   * returned receipt confirms admission; follow progress with `events()` or
-   * await the terminal response with `result()`. Model and message identifiers
-   * are translated to the runtime's wire names by the SDK.
+   * Send a structured message through the session message endpoint. Model and
+   * message identifiers are translated to the runtime's wire names by the SDK.
    */
   sendMessage(request: SendSessionMessageRequest, options?: SendSessionMessageOptions): Promise<SentSessionMessage>;
   /**
@@ -503,7 +456,6 @@ interface ToolsCapability {
 declare class SandboxInstance {
   private readonly client;
   private info;
-  private refreshInFlight?;
   private readonly defaultRuntimeBackend?;
   private readonly runtime;
   constructor(client: HttpClient, info: SandboxInfo, defaultRuntimeBackend?: BackendConfig);
@@ -604,7 +556,6 @@ declare class SandboxInstance {
    * Refresh sandbox information from the server.
    */
   refresh(): Promise<void>;
-  private refreshInfo;
   /**
    * Fetch fresh TEE attestation evidence for this sandbox.
    *
@@ -1083,7 +1034,6 @@ declare class SandboxInstance {
    * ```
    */
   get process(): ProcessManager;
-  private processEnsureDevServer;
   private processSpawn;
   private processSpawnExact;
   private processRunCode;
@@ -1439,13 +1389,13 @@ declare class SandboxInstance {
    * ```typescript
    * await box.registerSessionMapping({
    *   sessionId: "sess_abc",
-   *   runtimeSessionId: "runtime_abc",
+   *   userId: "user_123",
    * });
    * ```
    */
   registerSessionMapping(opts: {
-    sessionId: string; /** @deprecated Ownership is derived from the Sandbox API key. */
-    userId?: string; /** The runtime (sidecar) session id this agent session routes to. */
+    sessionId: string;
+    userId: string; /** The runtime (sidecar) session id this agent session routes to. */
     runtimeSessionId: string; /** Optional container id for direct routing. */
     sidecarId?: string; /** Optional projectRef so the server can detect a stale sidecar. */
     projectRef?: string;
@@ -1456,8 +1406,8 @@ declare class SandboxInstance {
    * sandbox stays alive.
    */
   unregisterSessionMapping(opts: {
-    sessionId: string; /** @deprecated Ownership is derived from the Sandbox API key. */
-    userId?: string;
+    sessionId: string;
+    userId: string;
   }): Promise<{
     success: boolean;
     sessionId: string;
@@ -1580,7 +1530,7 @@ declare class SandboxInstance {
   /** @internal — invoked by SandboxSession.events(). */
   _sessionEvents(id: string, opts?: SessionEventStreamOptions, stopOnTurnTerminal?: boolean): AsyncGenerator<SandboxEvent>;
   /** @internal — invoked by SandboxSession.result(). */
-  _sessionResult(id: string, knownSession?: SessionInfo): Promise<PromptResult>;
+  _sessionResult(id: string): Promise<PromptResult>;
   /**
    * @internal — invoked by SandboxSession.cancel(). Void-returning alias of
    * `_interrupt`: both abort the in-flight execution via `POST /{id}/abort`
@@ -1593,8 +1543,6 @@ declare class SandboxInstance {
   _startInteractive(id: string, options: StartInteractiveOptions): Promise<InteractiveSessionInfo>;
   /** @internal — invoked by InteractiveSessionHandle.sendPrompt(). */
   _sendInteractivePrompt(id: string, prompt: string): Promise<void>;
-  /** @internal — invoked by InteractiveSessionHandle.status(). */
-  _interactiveStatus(id: string): Promise<InteractiveSessionStatus | null>;
   /** @internal — invoked by InteractiveSessionHandle.stop(). */
   _stopInteractive(id: string): Promise<void>;
   /** @internal — invoked by SandboxSession.respondToPermission(). */
@@ -1619,4 +1567,4 @@ declare class SandboxInstance {
   }): Promise<DurablePlan>;
 }
 //#endregion
-export { SANDBOX_MCP_SERVER_NAME as C, buildControlPlaneMcpConfig as D, SandboxMcpServerEntry as E, buildSandboxMcpConfig as O, CONTROL_PLANE_MCP_SERVER_NAME as S, SandboxMcpEndpoint as T, InterruptResult as _, TraceExportSink as a, BuildControlPlaneMcpConfigOptions as b, otelTraceIdForTangleTrace as c, SandboxSession as d, InteractiveAuthFile as f, InteractiveSessionStatus as g, InteractiveSessionInfo as h, TraceExportResult as i, toOtelJson as l, InteractiveSessionHost as m, SandboxInstance as n, buildTraceExportPayload as o, InteractiveSessionHandle as p, TraceExportFormat as r, exportTraceBundle as s, HttpClient as t, SandboxTaskSession as u, RespondToPermissionOptions as v, SandboxMcpConfig as w, BuildSandboxMcpConfigOptions as x, StartInteractiveOptions as y };
+export { SandboxMcpConfig as C, buildSandboxMcpConfig as D, buildControlPlaneMcpConfig as E, SANDBOX_MCP_SERVER_NAME as S, SandboxMcpServerEntry as T, RespondToPermissionOptions as _, TraceExportSink as a, BuildSandboxMcpConfigOptions as b, otelTraceIdForTangleTrace as c, SandboxSession as d, InteractiveAuthFile as f, InterruptResult as g, InteractiveSessionInfo as h, TraceExportResult as i, toOtelJson as l, InteractiveSessionHost as m, SandboxInstance as n, buildTraceExportPayload as o, InteractiveSessionHandle as p, TraceExportFormat as r, exportTraceBundle as s, HttpClient as t, SandboxTaskSession as u, StartInteractiveOptions as v, SandboxMcpEndpoint as w, CONTROL_PLANE_MCP_SERVER_NAME as x, BuildControlPlaneMcpConfigOptions as y };

package/dist/{sandbox-C8WoMyT0.js → sandbox-DaLPTCRA.js}

@@ -1,5 +1,5 @@
-import { l as normalizeRuntimeBackendConfig, n as normalizeSessionInfo, o as combineAbortSignals, r as uploadChunked, s as encodePromptForWire, t as SandboxRuntimeApi, u as normalizeRuntimeModelOverride } from "./runtime-api-r8vQVMe4.js";
-import { a as NotFoundError, c as SandboxError, d as TimeoutError, f as ValidationError, i as NetworkError, l as ServerError, n as CapabilityError, p as parseErrorResponse, s as QuotaError, t as AuthError, u as StateError } from "./errors-hbpL_-S6.js";
+import { l as normalizeRuntimeBackendConfig, n as normalizeSessionInfo, o as combineAbortSignals, r as uploadChunked, s as encodePromptForWire, t as SandboxRuntimeApi } from "./runtime-api-kukaWPtF.js";
+import { c as SandboxError, d as TimeoutError, f as ValidationError, i as NetworkError, l as ServerError, n as CapabilityError, p as parseErrorResponse, s as QuotaError, t as AuthError, u as StateError } from "./errors-Cbs78OlF.js";
 import { addTokenUsage, readTokenCostUsd, readTokenUsage } from "@tangle-network/agent-core";
 //#region src/lib/sse-parser.ts
 /**
@@ -434,8 +434,8 @@ var InteractiveSessionHandle = class {
 	/**
 	* Spawn the harness's interactive TUI for this session. Returns the
 	* `streamUrl` to attach a terminal client to. Throws if the harness has no
-	* interactive entrypoint (e.g. cursor, which is SDK-only), the binary is
-	* not installed, or a session is already running for this id.
+	* interactive entrypoint (e.g. opencode), the binary is not installed, or a
+	* session is already running for this id.
 	*/
 	start(options) {
 		return this.host._startInteractive(this.sessionId, options);
@@ -444,16 +444,6 @@ var InteractiveSessionHandle = class {
 	sendPrompt(prompt) {
 		return this.host._sendInteractivePrompt(this.sessionId, prompt);
 	}
-	/**
-	* Observe the session: running, exited (with its exit code), or `null`
-	* when the sidecar no longer knows the id. Poll this to detect completion —
-	* an interactive session has no structured result stream, so the exit
-	* tombstone is the completion signal.
-	*/
-	status() {
-		if (!this.host._interactiveStatus) return Promise.reject(/* @__PURE__ */ new Error("Interactive session status is not supported by this host"));
-		return this.host._interactiveStatus(this.sessionId);
-	}
 	/** Stop the interactive harness and reap its PTY. */
 	stop() {
 		return this.host._stopInteractive(this.sessionId);
@@ -519,10 +509,9 @@ var SandboxSession = class SandboxSession {
 		return this.box._sessionEvents(this.id, opts);
 	}
 	/**
-	* Await the session's terminal result. Reads status and drains events
-	* from the latest execution until the session reaches a terminal state,
-	* then returns the aggregated `PromptResult`. Event replay makes this safe
-	* to call after the execution has already finished.
+	* Await the session's terminal result. Polls status + drains events
+	* until the session reaches a terminal state, then returns the
+	* aggregated `PromptResult`.
 	*
 	* Use this to wait for a session that was started by another caller
 	* (e.g. `dispatchPrompt`).
@@ -552,10 +541,8 @@ var SandboxSession = class SandboxSession {
 		});
 	}
 	/**
-	* Submit a structured message through the session message endpoint. The
-	* returned receipt confirms admission; follow progress with `events()` or
-	* await the terminal response with `result()`. Model and message identifiers
-	* are translated to the runtime's wire names by the SDK.
+	* Send a structured message through the session message endpoint. Model and
+	* message identifiers are translated to the runtime's wire names by the SDK.
 	*/
 	async sendMessage(request, options) {
 		return this.box._sessionSendMessage(this.id, request, options);
@@ -748,10 +735,6 @@ const SNAPSHOT_RESTORE_POLL_INTERVAL_MS = 1e3;
 const SNAPSHOT_RESTORE_TIMEOUT_MS = 600 * 1e3;
 const SNAPSHOT_VISIBILITY_POLL_INTERVAL_MS = 1e3;
 const SNAPSHOT_VISIBILITY_TIMEOUT_MS = 120 * 1e3;
-const EXEC_DEFAULT_TIMEOUT_MS = 3e4;
-const EXEC_MIN_TIMEOUT_MS = 100;
-const EXEC_MAX_TIMEOUT_MS = 6e5;
-const EXEC_TRANSPORT_MARGIN_MS = 15e3;
 const SNAPSHOT_CREATE_REQUEST_TIMEOUT_MS = 600 * 1e3;
 function toSnapshotResult(data) {
 	return {
@@ -968,14 +951,6 @@ function parseTextFileReadResponse(body) {
 	return payload.data.content;
 }
 const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-const SANDBOX_STATUS_FRESHNESS_MS = 1e3;
-const sandboxStatusObservedAt = /* @__PURE__ */ new WeakMap();
-const directRuntimeInstances = /* @__PURE__ */ new WeakSet();
-function createSandboxInstanceFromResponse(client, info, defaultRuntimeBackend) {
-	const instance = new SandboxInstance(client, info, defaultRuntimeBackend);
-	sandboxStatusObservedAt.set(instance, Date.now());
-	return instance;
-}
 /** Transient file-write failures worth retrying: rate-limit (quota), 5xx,
 *  transport (network), and request timeouts. A non-transient error (bad path,
 *  auth, validation) fails loud immediately. */
@@ -988,7 +963,6 @@ function isTransientWriteError(err) {
 var SandboxInstance = class SandboxInstance {
 	client;
 	info;
-	refreshInFlight;
 	defaultRuntimeBackend;
 	runtime;
 	constructor(client, info, defaultRuntimeBackend) {
@@ -1121,7 +1095,6 @@ var SandboxInstance = class SandboxInstance {
 			const client = this.client;
 			if (next && typeof client._emitTokenRefresh === "function") client._emitTokenRefresh(this.id, next);
 		}), { ...this.info }, this.defaultRuntimeBackend);
-		directRuntimeInstances.add(directInstance);
 		return directInstance;
 	}
 	/**
@@ -1161,19 +1134,6 @@ var SandboxInstance = class SandboxInstance {
 	* Refresh sandbox information from the server.
 	*/
 	async refresh() {
-		if (this.refreshInFlight) {
-			await this.refreshInFlight;
-			return;
-		}
-		const refresh = this.refreshInfo();
-		this.refreshInFlight = refresh;
-		try {
-			await refresh;
-		} finally {
-			if (this.refreshInFlight === refresh) this.refreshInFlight = void 0;
-		}
-	}
-	async refreshInfo() {
 		const response = await this.client.fetch(`/v1/sandboxes/${this.id}`);
 		if (!response.ok) {
 			const body = await response.text();
@@ -1181,7 +1141,6 @@ var SandboxInstance = class SandboxInstance {
 		}
 		const data = await response.json();
 		this.info = this.parseInfo(data);
-		sandboxStatusObservedAt.set(this, Date.now());
 	}
 	/**
 	* Fetch fresh TEE attestation evidence for this sandbox.
@@ -1311,31 +1270,28 @@ var SandboxInstance = class SandboxInstance {
 	*/
 	async exec(command, options) {
 		await this.ensureRunning();
-		const timeoutMs = options?.timeoutMs ?? EXEC_DEFAULT_TIMEOUT_MS;
-		if (!Number.isInteger(timeoutMs) || timeoutMs < EXEC_MIN_TIMEOUT_MS || timeoutMs > EXEC_MAX_TIMEOUT_MS) throw new ValidationError(`exec timeoutMs must be an integer between ${EXEC_MIN_TIMEOUT_MS} and ${EXEC_MAX_TIMEOUT_MS}`);
 		const headers = {};
 		if (options?.sessionId) headers["X-Session-Id"] = options.sessionId;
-		const response = await this.runtimeFetch("/process/spawn", {
+		const response = await this.runtimeFetch("/terminals/commands", {
 			method: "POST",
 			headers,
 			body: JSON.stringify({
 				command,
 				cwd: options?.cwd,
 				env: options?.env,
-				timeoutMs,
-				blocking: true
+				timeout: options?.timeoutMs
 			})
-		}, { timeoutMs: timeoutMs + EXEC_TRANSPORT_MARGIN_MS });
+		});
 		if (!response.ok) {
 			const body = await response.text();
 			throw parseErrorResponse(response.status, body, void 0, response.headers);
 		}
-		const result = (await response.json()).data;
-		if (!result || typeof result.exitCode !== "number" || typeof result.stdout !== "string" || typeof result.stderr !== "string") throw new ServerError("Sandbox process response was malformed", 502);
+		const data = await response.json();
+		const result = data.result ?? data;
 		return {
-			exitCode: result.exitCode,
-			stdout: result.stdout,
-			stderr: result.stderr
+			exitCode: result.exitCode ?? 0,
+			stdout: result.stdout ?? "",
+			stderr: result.stderr ?? ""
 		};
 	}
 	/**
@@ -1693,8 +1649,7 @@ var SandboxInstance = class SandboxInstance {
 					requireVisibleAssistantOutput: options?.requireVisibleAssistantOutput,
 					...timeoutMs ? { timeoutMs } : {},
 					...options?.detach ? { detach: true } : {},
-					backend: normalizeRuntimeBackendConfig(options?.backend ?? this.defaultRuntimeBackend),
-					...options?.model ? { model: normalizeRuntimeModelOverride(options.model) } : {}
+					backend: normalizeRuntimeBackendConfig(options?.backend ?? this.defaultRuntimeBackend, { model: options?.model })
 				})
 			};
 			response = await this.runtimeFetch(requestEndpoint, request);
@@ -3049,7 +3004,6 @@ var SandboxInstance = class SandboxInstance {
 	*/
 	get process() {
 		return {
-			ensureDevServer: (options) => this.processEnsureDevServer(options),
 			spawn: (command, options) => this.processSpawn(command, options),
 			spawnExact: (executable, args, options) => this.processSpawnExact(executable, args, options),
 			runCode: (code, options) => this.processRunCode(code, options),
@@ -3057,26 +3011,6 @@ var SandboxInstance = class SandboxInstance {
 			get: (pid) => this.processGet(pid)
 		};
 	}
-	async processEnsureDevServer(options) {
-		if (options?.sessionId !== void 0) assertValidSessionId(options.sessionId);
-		if (options?.cwd !== void 0 && (typeof options.cwd !== "string" || options.cwd.trim().length === 0)) throw new ValidationError("Dev server cwd must be a non-empty string");
-		await this.ensureRunning();
-		const headers = options?.sessionId ? { "X-Session-Id": options.sessionId } : void 0;
-		const response = await this.runtimeFetch("/process/ensure-dev-server", {
-			method: "POST",
-			headers,
-			body: JSON.stringify(options?.cwd ? { cwd: options.cwd } : {})
-		});
-		if (!response.ok) {
-			const body = await response.text();
-			throw parseErrorResponse(response.status, body, void 0, response.headers);
-		}
-		const payload = await response.json();
-		return {
-			...payload.data,
-			startedAt: new Date(payload.data.startedAt)
-		};
-	}
 	async processSpawn(command, options) {
 		await this.ensureRunning();
 		const response = await this.runtimeFetch("/process/spawn", {
@@ -3105,7 +3039,6 @@ var SandboxInstance = class SandboxInstance {
 				args,
 				cwd: options?.cwd,
 				env: options?.env,
-				inheritEnv: options?.inheritEnv,
 				timeoutMs: options?.timeoutMs,
 				stdin: options?.stdin,
 				blocking: false
@@ -3896,7 +3829,7 @@ var SandboxInstance = class SandboxInstance {
 			const body = await response.text();
 			throw parseErrorResponse(response.status, body, void 0, response.headers);
 		}
-		return ((await response.json()).children ?? []).map((child) => createSandboxInstanceFromResponse(this.client, this.parseInfo(child), this.defaultRuntimeBackend));
+		return ((await response.json()).children ?? []).map((child) => new SandboxInstance(this.client, this.parseInfo(child), this.defaultRuntimeBackend));
 	}
 	/**
 	* Speculative rollouts: branch this RUNNING sandbox into `n` copy-on-write
@@ -4029,7 +3962,6 @@ var SandboxInstance = class SandboxInstance {
 		}
 		const diagnostics = await this.readLifecycleDiagnostics(response);
 		if (diagnostics) this.info.startupDiagnostics = diagnostics;
-		sandboxStatusObservedAt.delete(this);
 	}
 	/**
 	* Read the per-phase lifecycle breakdown off a stop/resume/delete response
@@ -4238,15 +4170,12 @@ var SandboxInstance = class SandboxInstance {
 		}
 	}
 	async ensureRunning() {
-		const statusObservedAt = sandboxStatusObservedAt.get(this) ?? 0;
-		const statusAgeMs = Date.now() - statusObservedAt;
-		if (directRuntimeInstances.has(this) || statusObservedAt <= 0 || statusAgeMs < 0 || statusAgeMs >= SANDBOX_STATUS_FRESHNESS_MS) await this.refresh();
+		await this.refresh();
 		if (this.status !== "running") throw new StateError(`Sandbox is not running (status: ${this.status})`, this.status, "running");
 	}
-	async runtimeFetch(path, options, fetchOptions) {
+	async runtimeFetch(path, options) {
 		const url = `/v1/sandboxes/${encodeURIComponent(this.id)}/runtime${path}`;
 		try {
-			if (fetchOptions) return await this.client.fetch(url, options, fetchOptions);
 			return options ? await this.client.fetch(url, options) : await this.client.fetch(url);
 		} catch (err) {
 			throw new NetworkError(`Failed to connect to sandbox: ${err instanceof Error ? err.message : String(err)}`, err instanceof Error ? err : void 0, {
@@ -4284,16 +4213,17 @@ var SandboxInstance = class SandboxInstance {
 	* ```typescript
 	* await box.registerSessionMapping({
 	*   sessionId: "sess_abc",
-	*   runtimeSessionId: "runtime_abc",
+	*   userId: "user_123",
 	* });
 	* ```
 	*/
 	async registerSessionMapping(opts) {
 		const response = await this.client.fetch(`/v1/session/${encodeURIComponent(opts.sessionId)}/mapping`, {
 			method: "PUT",
+			headers: { "x-user-id": opts.userId },
 			body: JSON.stringify({
 				sidecarSessionId: opts.runtimeSessionId,
-				sidecarId: opts.sidecarId ?? this.id,
+				...opts.sidecarId ? { sidecarId: opts.sidecarId } : {},
 				...opts.projectRef ? { projectRef: opts.projectRef } : {}
 			})
 		});
@@ -4322,7 +4252,10 @@ var SandboxInstance = class SandboxInstance {
 	* sandbox stays alive.
 	*/
 	async unregisterSessionMapping(opts) {
-		const response = await this.client.fetch(`/v1/session/${encodeURIComponent(opts.sessionId)}/mapping`, { method: "DELETE" });
+		const response = await this.client.fetch(`/v1/session/${encodeURIComponent(opts.sessionId)}/mapping`, {
+			method: "DELETE",
+			headers: { "x-user-id": opts.userId }
+		});
 		if (!response.ok) {
 			const body = await response.text();
 			throw parseErrorResponse(response.status, body, void 0, response.headers);
@@ -4581,11 +4514,7 @@ var SandboxInstance = class SandboxInstance {
 			};
 		}
 		if (info) {
-			if (!info.latestExecutionId) return {
-				state: "failed",
-				error: `session ${opts.sessionId} ${info.status}: no execution result is available`
-			};
-			const result = await this._sessionResult(opts.sessionId, info);
+			const result = await this._sessionResult(opts.sessionId);
 			const settled = settleTurnDrive({ ...result });
 			if (settled.state === "awaiting_plan_decision") return settled;
 			if (!result.success) return {
@@ -4608,14 +4537,12 @@ var SandboxInstance = class SandboxInstance {
 	*/
 	async mintScopedToken(opts) {
 		if ((opts.scope === "session" || opts.scope === "session-runtime") && !opts.sessionId) throw new ValidationError(`${opts.scope} scope requires a sessionId`);
-		if (opts.scope === "session" && !opts.runtimeSessionId) throw new ValidationError("session scope requires the actual runtimeSessionId");
 		const response = await this.client.fetch(`/v1/sandboxes/${encodeURIComponent(this.id)}/scoped-token`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify({
 				scope: opts.scope,
 				...opts.sessionId ? { sessionId: opts.sessionId } : {},
-				...opts.scope === "session" ? { runtimeSessionId: opts.runtimeSessionId } : {},
 				...opts.ttlMinutes ? { ttlMinutes: opts.ttlMinutes } : {}
 			})
 		});
@@ -4663,17 +4590,8 @@ var SandboxInstance = class SandboxInstance {
 		}
 	}
 	/** @internal — invoked by SandboxSession.result(). */
-	async _sessionResult(id, knownSession) {
+	async _sessionResult(id) {
 		const startTime = Date.now();
-		const session = knownSession ?? await this._sessionStatus(id);
-		if (!session) throw new NotFoundError("Session", id, {
-			origin: "runtime",
-			endpoint: `/agents/sessions/${encodeURIComponent(id)}`
-		});
-		if (!session.latestExecutionId) throw new StateError(`Session ${id} has no execution result to await`, session.status, "session with an admitted execution", {
-			origin: "runtime",
-			endpoint: `/agents/sessions/${encodeURIComponent(id)}`
-		}, "SESSION_EXECUTION_MISSING");
 		let response;
 		let runError;
 		let runErrorCode;
@@ -4684,10 +4602,7 @@ var SandboxInstance = class SandboxInstance {
 		let question;
 		let plan;
 		let terminalReached = false;
-		for await (const event of this._sessionEvents(id, {
-			since: "0",
-			executionId: session.latestExecutionId
-		}, true)) {
+		for await (const event of this._sessionEvents(id, void 0, true)) {
 			response = applySandboxEventText(response, event);
 			if (event.type === "result" || event.type === "done") {
 				const data = event.data;
@@ -4777,22 +4692,6 @@ var SandboxInstance = class SandboxInstance {
 			throw parseErrorResponse(response.status, body, void 0, response.headers);
 		}
 	}
-	/** @internal — invoked by InteractiveSessionHandle.status(). */
-	async _interactiveStatus(id) {
-		await this.ensureRunning();
-		const response = await this.runtimeFetch(`/agents/sessions/${encodeURIComponent(id)}/interactive`, { method: "GET" });
-		if (response.status === 404) return null;
-		if (!response.ok) {
-			const body = await response.text();
-			throw parseErrorResponse(response.status, body, void 0, response.headers);
-		}
-		const data = (await response.json())?.data;
-		if (!data || data.state !== "running" && data.state !== "exited") throw new ServerError("Interactive status response missing data", 502, {
-			endpoint: `/agents/sessions/${encodeURIComponent(id)}/interactive`,
-			origin: "runtime"
-		});
-		return data;
-	}
 	/** @internal — invoked by InteractiveSessionHandle.stop(). */
 	async _stopInteractive(id) {
 		await this.ensureRunning();
@@ -5002,4 +4901,4 @@ function quoteForShell(value) {
 	return `'${value.replace(/'/g, "'\\''")}'`;
 }
 //#endregion
-export { SandboxSession as a, collectAgentResponseText as c, buildTraceExportPayload as d, exportTraceBundle as f, parseSSEStream as h, SandboxTaskSession as i, getSandboxEventText as l, toOtelJson as m, createSandboxInstanceFromResponse as n, InteractiveSessionHandle as o, otelTraceIdForTangleTrace as p, normalizeStartupDiagnostics as r, applySandboxEventText as s, SandboxInstance as t, normalizeConnection as u };
+export { InteractiveSessionHandle as a, getSandboxEventText as c, exportTraceBundle as d, otelTraceIdForTangleTrace as f, SandboxSession as i, normalizeConnection as l, parseSSEStream as m, normalizeStartupDiagnostics as n, applySandboxEventText as o, toOtelJson as p, SandboxTaskSession as r, collectAgentResponseText as s, SandboxInstance as t, buildTraceExportPayload as u };