@tangle-network/sandbox 0.31.1 → 0.32.0-develop.20260825065945.0d55d7c

package/dist/agent/index.js

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

package/dist/{client-BfnJ44gF.js → client-BRegsZuj.js}

@@ -1,7 +1,7 @@
-import { c as encodePromptForWire, d as assertCurrentBackendType, f as normalizeRuntimeBackendConfig, g as backendTypeSchema, l as encodeTextForWire, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, u as applyRequestedModel } from "./runtime-api-B0tx7NJM.js";
+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-paApH4-W.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 { C as normalizeConnection, O as parseSSEStream, T as exportTraceBundle, _ as requestInteractiveSessionToken, i as normalizeStartupDiagnostics, n as createSandboxInstanceFromResponse, r as normalizeSandboxCreateReceipt } from "./sandbox-AUHcCJe1.js";
+import { C as normalizeConnection, T as exportTraceBundle, _ as requestInteractiveSessionToken, i as normalizeStartupDiagnostics, n as createSandboxInstanceFromResponse, r as normalizeSandboxCreateReceipt } from "./sandbox-CyP8CXaF.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 parseBackendRegistryResponseBody, d as backendRegistryCapabilitiesSchema, f as backendRegistryEntrySchema, g as parseBackendRegistryResponse, h as isBackendRegistryInteractionKind, m as backendRegistryResponseSchema, n as Sandbox, p as backendRegistryInteractionKindSchema } from "./client-BfnJ44gF.js";
-import { a as WorkspaceImages, t as SandboxInstance } from "./sandbox-AUHcCJe1.js";
+import { _ as parseBackendRegistryResponseBody, d as backendRegistryCapabilitiesSchema, f as backendRegistryEntrySchema, g as parseBackendRegistryResponse, h as isBackendRegistryInteractionKind, m as backendRegistryResponseSchema, n as Sandbox, p as backendRegistryInteractionKindSchema } from "./client-BRegsZuj.js";
+import { a as WorkspaceImages, t as SandboxInstance } from "./sandbox-CyP8CXaF.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 parseBackendType, f as normalizeRuntimeBackendConfig, g as backendTypeSchema, h as deriveAgentRunOutcome, m as deriveAgentResultOutcome, p as createAgentRunOutcomeTracker } from "./runtime-api-B0tx7NJM.js";
+import { _ as backendTypeSchema, g as deriveAgentRunOutcome, h as deriveAgentResultOutcome, m as createAgentRunOutcomeTracker, p as normalizeRuntimeBackendConfig, u as parseSSEStream, v as parseBackendType } from "./runtime-api-paApH4-W.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 parseBackendRegistryResponseBody, a as splitInlineProfileSkills, c as SandboxFleetClient, d as backendRegistryCapabilitiesSchema, f as backendRegistryEntrySchema, g as parseBackendRegistryResponse, h as isBackendRegistryInteractionKind, i as splitInlineProfileFileMounts, l as createBatchResultAccumulator, m as backendRegistryResponseSchema, n as Sandbox, o as validateDeferredProfileFileMounts, p as backendRegistryInteractionKindSchema, r as materializeProfileFileMounts, s as SandboxFleet, t as IntelligenceClient, u as validateBatchRunRequest } from "./client-BfnJ44gF.js";
+import { _ as parseBackendRegistryResponseBody, a as splitInlineProfileSkills, c as SandboxFleetClient, d as backendRegistryCapabilitiesSchema, f as backendRegistryEntrySchema, g as parseBackendRegistryResponse, h as isBackendRegistryInteractionKind, i as splitInlineProfileFileMounts, l as createBatchResultAccumulator, m as backendRegistryResponseSchema, n as Sandbox, o as validateDeferredProfileFileMounts, p as backendRegistryInteractionKindSchema, r as materializeProfileFileMounts, s as SandboxFleet, t as IntelligenceClient, u as validateBatchRunRequest } from "./client-BRegsZuj.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-wXQ7W5pT.js";
-import { D as toOtelJson, E as otelTraceIdForTangleTrace, O as parseSSEStream, S as isToolBearingEvent, T as exportTraceBundle, a as WorkspaceImages, b as collectAgentResponseText, c as SandboxTaskSession, d as agentInteractiveSessionPromptRequestDigest, f as BrowserInteractiveSessionController, g as TERMINAL_WS_ECHO_SUBPROTOCOL, h as TerminalStreamError, l as SandboxSession, m as TerminalStream, o as GPU_LEASE_PROVIDER_NAMES, p as InteractiveSessionController, s as MAX_EGRESS_DENIALS_LIMIT, t as SandboxInstance, u as InteractiveSessionHandle, v as applySandboxEventText, w as buildTraceExportPayload, x as getSandboxEventText, y as collectAgentFinalMessageText } from "./sandbox-AUHcCJe1.js";
+import { D as toOtelJson, E as otelTraceIdForTangleTrace, S as isToolBearingEvent, T as exportTraceBundle, a as WorkspaceImages, b as collectAgentResponseText, c as SandboxTaskSession, d as agentInteractiveSessionPromptRequestDigest, f as BrowserInteractiveSessionController, g as TERMINAL_WS_ECHO_SUBPROTOCOL, h as TerminalStreamError, l as SandboxSession, m as TerminalStream, o as GPU_LEASE_PROVIDER_NAMES, p as InteractiveSessionController, s as MAX_EGRESS_DENIALS_LIMIT, t as SandboxInstance, u as InteractiveSessionHandle, v as applySandboxEventText, w as buildTraceExportPayload, x as getSandboxEventText, y as collectAgentFinalMessageText } from "./sandbox-CyP8CXaF.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-iDk_s8vt.js";
+import { t as TangleSandboxClient } from "./tangle-DcZBrAGY.js";
 import { SANDBOX_SIZE_PRESET_NAMES, agentProfileConfidentialSchema, agentProfileSchema } from "@tangle-network/agent-interface";
 import { z } from "zod";
 //#region src/confidential.ts

package/dist/{runtime-api-B0tx7NJM.js → runtime-api-paApH4-W.js}

@@ -495,6 +495,197 @@ function normalizeRuntimeBackendConfig(backend) {
 	};
 }
 //#endregion
+//#region ../../../packages/sse-core/dist/index.js
+/**
+* Incremental SSE frame parser. Feed decoded text via `push()`; call
+* `flush()` when the stream ends.
+*/
+var SSEFrameParser = class {
+	buffer = "";
+	frameEvent = "";
+	frameId;
+	frameDataLines = null;
+	bomChecked = false;
+	/**
+	* Append a decoded text chunk and return every frame the chunk
+	* completes. Frame state survives across calls: one frame can
+	* straddle any number of chunks.
+	*/
+	push(chunk) {
+		let text = chunk;
+		if (!this.bomChecked && text.length > 0) {
+			this.bomChecked = true;
+			if (text.charCodeAt(0) === 65279) text = text.slice(1);
+		}
+		this.buffer += text;
+		const lines = this.buffer.split("\n");
+		this.buffer = lines.pop() ?? "";
+		return this.processLines(lines);
+	}
+	/**
+	* End-of-stream: process the unterminated trailing line, then
+	* dispatch a dangling frame that never got its blank line.
+	* Well-behaved servers end frames with "\n\n", but some close early.
+	*/
+	flush() {
+		const rest = this.buffer;
+		this.buffer = "";
+		const frames = rest.length > 0 ? this.processLines([rest]) : [];
+		const dangling = this.dispatch();
+		if (dangling) frames.push(dangling);
+		return frames;
+	}
+	processLines(lines) {
+		const frames = [];
+		for (const rawLine of lines) {
+			const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+			if (line === "") {
+				const frame = this.dispatch();
+				if (frame) frames.push(frame);
+				continue;
+			}
+			if (line.startsWith(":")) continue;
+			if (line.startsWith("data:")) {
+				let value = line.slice(5);
+				if (value.startsWith(" ")) value = value.slice(1);
+				if (this.frameDataLines === null) this.frameDataLines = [];
+				this.frameDataLines.push(value);
+				continue;
+			}
+			if (line.startsWith("event:")) {
+				this.frameEvent = line.slice(6).trim();
+				continue;
+			}
+			if (line.startsWith("id:")) this.frameId = line.slice(3).trim();
+		}
+		return frames;
+	}
+	/**
+	* Dispatch the accumulated frame. A frame with no `data:` field (an
+	* `event:`/`id:`-only frame, or a bare comment) produces nothing, and
+	* its field state is consumed and reset either way.
+	*/
+	dispatch() {
+		const dataLines = this.frameDataLines;
+		const frame = dataLines ? {
+			event: this.frameEvent,
+			data: dataLines.join("\n"),
+			id: this.frameId || void 0
+		} : null;
+		this.frameEvent = "";
+		this.frameId = void 0;
+		this.frameDataLines = null;
+		return frame;
+	}
+};
+/**
+* Read a streaming SSE response body into parsed frames.
+*
+* @throws `TypeError` when the body is missing.
+* @throws `DOMException` with `name === "AbortError"` on cancellation —
+*   including the WHATWG-fetch variant where an aborted body resolves
+*   `done: true` instead of rejecting the read.
+*/
+async function* streamSSEFrames(body, options) {
+	if (!body) throw new TypeError("SSE stream has no response body");
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	const parser = new SSEFrameParser();
+	const { signal } = options ?? {};
+	let completed = false;
+	try {
+		for (;;) {
+			if (signal?.aborted) throw new DOMException("SSE stream aborted", "AbortError");
+			const { done, value } = await reader.read();
+			if (done) {
+				if (signal?.aborted) throw new DOMException("SSE stream aborted", "AbortError");
+				break;
+			}
+			for (const frame of parser.push(decoder.decode(value, { stream: true }))) yield frame;
+		}
+		for (const frame of parser.push(decoder.decode())) yield frame;
+		for (const frame of parser.flush()) yield frame;
+		completed = true;
+	} finally {
+		if (!completed) await reader.cancel().catch(() => void 0);
+		reader.releaseLock();
+	}
+}
+//#endregion
+//#region src/lib/sse-parser.ts
+/**
+* SSE Stream Parser
+*
+* EventSource stream parsing for SDK consumers. Framing — buffering
+* chunk-straddling frames, LF/CRLF terminators, multi-line `data:` joins,
+* comment heartbeats, BOM — lives in `@tangle-network/sse-core`, the one
+* wire-format implementation shared across the repo (bundled into this
+* package's dist, so the SDK stays dependency-free at runtime). This
+* module owns the SDK's payload contract on top of it: JSON parsing, the
+* `"message"` default event type, and the malformed-frame policy. Used by
+* `Sandbox.streamBatch` and by the web dashboard's batch page; exported
+* so downstream surfaces don't maintain their own copies.
+*
+* Guarantees:
+*   - Correctly buffers frames that straddle chunk boundaries.
+*   - Accepts LF- and CRLF-terminated streams interchangeably.
+*   - Joins multi-line `data:` per the spec (dispatch joins with
+*     "\n" before JSON parse).
+*   - Defaults event type to `"message"` when a frame carries
+*     `data:` but no `event:` field (SSE spec §9.2.6 step 3).
+*   - Surfaces optional `id:` so callers can implement reconnection.
+*   - Flushes a dangling event when the stream closes without a
+*     terminating blank line (well-behaved servers emit `\n\n`, but
+*     some close early).
+*   - Throws `AbortError` when the caller-supplied signal fires, so
+*     consumers can distinguish "ran to completion" from "cancelled"
+*     without peeking at signal state.
+*   - Rejects malformed JSON by default. Callers handling recoverable output
+*     streams can explicitly warn and skip one invalid frame.
+*
+* What it does NOT do:
+*   - CR-only (legacy Mac) line terminators. No known emitter uses
+*     them; supporting them would risk splitting payloads that
+*     legitimately contain CR.
+*   - Retry/reconnect (caller's responsibility).
+*   - Event-type filtering (caller's responsibility).
+*/
+/**
+* Parse a streaming SSE response body into an async iterable of
+* structured events.
+*
+* @throws `TypeError` when the response has no body.
+* @throws `DOMException` with `name === "AbortError"` on cancellation.
+*/
+async function* parseSSEStream(body, options) {
+	const { signal, invalidEvent = "throw" } = options ?? {};
+	for await (const frame of streamSSEFrames(body, { signal })) {
+		const effectiveEvent = frame.event || "message";
+		let data;
+		try {
+			data = JSON.parse(frame.data);
+		} catch (error) {
+			if (invalidEvent === "warn-and-skip") {
+				console.warn(`[sandbox-sdk] Malformed SSE JSON for event "${effectiveEvent}": ${frame.data.slice(0, 200)}`);
+				continue;
+			}
+			throw new SyntaxError(`Malformed SSE JSON for event "${effectiveEvent}"`, { cause: error });
+		}
+		if (typeof data !== "object" || data === null || Array.isArray(data)) {
+			if (invalidEvent === "warn-and-skip") {
+				console.warn(`[sandbox-sdk] SSE event "${effectiveEvent}" data must be a JSON object`);
+				continue;
+			}
+			throw new TypeError(`SSE event "${effectiveEvent}" data must be a JSON object`);
+		}
+		yield {
+			type: effectiveEvent,
+			data,
+			id: frame.id
+		};
+	}
+}
+//#endregion
 //#region src/lib/wire-encoding.ts
 /**
 * Encode a prompt text part for the wire. Server decodes at the route
@@ -851,6 +1042,51 @@ var SandboxRuntimeApi = class {
 		await this.transport.ensureRunning();
 		return (await this.json("/ports", { method: "GET" })).data?.ports ?? [];
 	}
+	/**
+	* Subscribe to a session's agent event stream (`/agents/events`).
+	*
+	* The consume half of the supervisor pattern: construct the client from a
+	* `read-only` or `session-runtime` scoped token
+	* (`SandboxInstance.mintScopedToken`) and a parent agent observes a child
+	* sandbox's stream while holding no credential that can mutate the child.
+	* With `executionId` set, the stream ends at that turn's terminal
+	* `done`/`error` event; a stream that dies before the terminal throws
+	* instead of reading like a finished turn. Aborting `options.signal` ends
+	* the generator cleanly, matching every other SDK stream. Events carry no
+	* `data.sandboxId` stamp here: a scoped-token client knows only its own
+	* runtime URL, and the subscriber already knows which sandbox it minted
+	* the token for.
+	*/
+	async *events(sessionId, options = {}) {
+		await this.transport.ensureRunning();
+		const search = new URLSearchParams();
+		search.set("sessionId", sessionId);
+		if (options.since) search.set("since", options.since);
+		if (options.executionId) search.set("executionId", options.executionId);
+		const response = await this.request(`/agents/events?${search.toString()}`, { signal: options.signal });
+		if (!response.body) throw new NetworkError("event stream has no response body");
+		let sawTerminal = false;
+		try {
+			for await (const event of parseSSEStream(response.body, {
+				signal: options.signal,
+				invalidEvent: "warn-and-skip"
+			})) {
+				yield {
+					type: event.type,
+					data: event.data,
+					...event.id !== void 0 ? { id: event.id } : {}
+				};
+				if (options.executionId !== void 0 && (event.type === "done" || event.type === "error")) {
+					sawTerminal = true;
+					return;
+				}
+			}
+		} catch (err) {
+			if (err instanceof DOMException && err.name === "AbortError") return;
+			throw err;
+		}
+		if (options.executionId !== void 0 && !sawTerminal) throw new NetworkError("event stream ended before a terminal event — the connection dropped mid-turn");
+	}
 	async readFiles(paths, options = {}) {
 		const params = new URLSearchParams();
 		appendSessionIdQuery(params, options.sessionId);
@@ -1207,4 +1443,4 @@ function normalizeSessionInfo(raw) {
 	};
 }
 //#endregion
-export { parseBackendType as _, uploadChunked as a, encodePromptForWire as c, assertCurrentBackendType as d, normalizeRuntimeBackendConfig as f, backendTypeSchema as g, deriveAgentRunOutcome as h, sessionHeaders as i, encodeTextForWire as l, deriveAgentResultOutcome as m, normalizeSessionInfo as n, SANDBOX_PROXY_REQUEST_MAX_BYTES as o, createAgentRunOutcomeTracker as p, appendSessionIdQuery as r, FILE_DECODED_WRITE_MAX_BYTES as s, SandboxRuntimeApi as t, applyRequestedModel as u };
+export { backendTypeSchema as _, uploadChunked as a, encodePromptForWire as c, applyRequestedModel as d, assertCurrentBackendType as f, deriveAgentRunOutcome as g, deriveAgentResultOutcome as h, sessionHeaders as i, encodeTextForWire as l, createAgentRunOutcomeTracker as m, normalizeSessionInfo as n, SANDBOX_PROXY_REQUEST_MAX_BYTES as o, normalizeRuntimeBackendConfig as p, appendSessionIdQuery as r, FILE_DECODED_WRITE_MAX_BYTES as s, SandboxRuntimeApi as t, parseSSEStream as u, parseBackendType as v };

package/dist/runtime.d.ts

@@ -1,4 +1,4 @@
-import { C as ChunkedUploadResult, Fi as TaskSessionCommitResult, Gn as RenameOptions, Kr as SandboxRuntimeHealth, L as CreateSessionOptions, Li as TaskSessionInfo, O as CommitTaskSessionOptions, Pi as TaskSessionChanges, Qr as SandboxTerminalRequestOptions, R as CreateTaskSessionOptions, S as ChunkedUploadOptions, St as FileWriteResult, Vr as SandboxPortBinding, Xr as SandboxTerminalInfo, Yi as UploadProgress, Yr as SandboxTerminalCreateOptions, Zr as SandboxTerminalManager, bt as FileUsageOptions, di as SentSessionMessage, dt as FileReadBatchOptions, ea as WriteFileOptions, ft as FileReadBatchResult, gi as SessionInfo, ht as FileRenameResult, li as SendSessionMessageOptions, sn as ListMessagesOptions, ui as SendSessionMessageRequest, vt as FileTreeOptions, xt as FileUsageResult, yi as SessionMessage, yt as FileTreeResult } from "./types-BwYLVqxX.js";
+import { C as ChunkedUploadResult, Fi as TaskSessionCommitResult, Gn as RenameOptions, Kr as SandboxRuntimeHealth, L as CreateSessionOptions, Li as TaskSessionInfo, O as CommitTaskSessionOptions, Pi as TaskSessionChanges, Qr as SandboxTerminalRequestOptions, R as CreateTaskSessionOptions, S as ChunkedUploadOptions, St as FileWriteResult, Vr as SandboxPortBinding, Xr as SandboxTerminalInfo, Yi as UploadProgress, Yr as SandboxTerminalCreateOptions, Zr as SandboxTerminalManager, bt as FileUsageOptions, di as SentSessionMessage, dt as FileReadBatchOptions, ea as WriteFileOptions, ft as FileReadBatchResult, gi as SessionInfo, ht as FileRenameResult, li as SendSessionMessageOptions, pi as SessionEventStreamOptions, sn as ListMessagesOptions, ui as SendSessionMessageRequest, ur as SandboxEvent, vt as FileTreeOptions, xt as FileUsageResult, yi as SessionMessage, yt as FileTreeResult } from "./types-BwYLVqxX.js";
 import { a as NetworkError, c as QuotaError, d as SandboxFailureDetail, f as ServerError, h as ValidationError, i as FileWriteConflictError, l as SandboxError, m as TimeoutError, n as CapabilityError, o as NotFoundError, p as StateError, s as PartialFailureError, t as AuthError, u as SandboxErrorJson } from "./errors-CQOvGddH.js";
 import { a as deriveAgentRunOutcome, i as deriveAgentResultOutcome, n as AgentRunOutcomeTracker, r as createAgentRunOutcomeTracker, t as AgentRunOutcome } from "./agent-run-outcome-CM7xD7Mg.js";
 
@@ -39,6 +39,22 @@ declare class SandboxRuntimeApi {
   constructor(transport: RuntimeTransport);
   health(): Promise<SandboxRuntimeHealth>;
   ports(): Promise<SandboxPortBinding[]>;
+  /**
+   * Subscribe to a session's agent event stream (`/agents/events`).
+   *
+   * The consume half of the supervisor pattern: construct the client from a
+   * `read-only` or `session-runtime` scoped token
+   * (`SandboxInstance.mintScopedToken`) and a parent agent observes a child
+   * sandbox's stream while holding no credential that can mutate the child.
+   * With `executionId` set, the stream ends at that turn's terminal
+   * `done`/`error` event; a stream that dies before the terminal throws
+   * instead of reading like a finished turn. Aborting `options.signal` ends
+   * the generator cleanly, matching every other SDK stream. Events carry no
+   * `data.sandboxId` stamp here: a scoped-token client knows only its own
+   * runtime URL, and the subscriber already knows which sandbox it minted
+   * the token for.
+   */
+  events(sessionId: string, options?: SessionEventStreamOptions): AsyncGenerator<SandboxEvent>;
   readFiles(paths: string[], options?: FileReadBatchOptions): Promise<FileReadBatchResult>;
   writeFile(path: string, content: string, options?: WriteFileOptions): Promise<FileWriteResult>;
   /**
@@ -104,4 +120,4 @@ declare class SandboxRuntimeClient extends SandboxRuntimeApi {
 }
 declare function createSandboxRuntimeClient(config: SandboxRuntimeClientConfig): SandboxRuntimeClient;
 //#endregion
-export { type AgentRunOutcome, type AgentRunOutcomeTracker, AuthError, CapabilityError, type ChunkedUploadOptions, type ChunkedUploadResult, type ChunkedUploadTransport, type FileReadBatchOptions, type FileReadBatchResult, type FileRenameResult, type FileTreeOptions, type FileTreeResult, FileWriteConflictError, type FileWriteResult, type ListMessagesOptions, NetworkError, NotFoundError, PartialFailureError, QuotaError, type RenameOptions, SandboxError, type SandboxErrorJson, type SandboxFailureDetail, SandboxRuntimeClient, type SandboxRuntimeClientConfig, type SandboxRuntimeHealth, type SandboxTerminalCreateOptions, type SandboxTerminalInfo, type SandboxTerminalManager, type SandboxTerminalRequestOptions, ServerError, type SessionMessage, StateError, TimeoutError, type UploadProgress, ValidationError, type WriteFileOptions, createAgentRunOutcomeTracker, createSandboxRuntimeClient, deriveAgentResultOutcome, deriveAgentRunOutcome, uploadChunked };
+export { type AgentRunOutcome, type AgentRunOutcomeTracker, AuthError, CapabilityError, type ChunkedUploadOptions, type ChunkedUploadResult, type ChunkedUploadTransport, type FileReadBatchOptions, type FileReadBatchResult, type FileRenameResult, type FileTreeOptions, type FileTreeResult, FileWriteConflictError, type FileWriteResult, type ListMessagesOptions, NetworkError, NotFoundError, PartialFailureError, QuotaError, type RenameOptions, SandboxError, type SandboxErrorJson, type SandboxEvent, type SandboxFailureDetail, SandboxRuntimeClient, type SandboxRuntimeClientConfig, type SandboxRuntimeHealth, type SandboxTerminalCreateOptions, type SandboxTerminalInfo, type SandboxTerminalManager, type SandboxTerminalRequestOptions, ServerError, type SessionEventStreamOptions, type SessionMessage, StateError, TimeoutError, type UploadProgress, ValidationError, type WriteFileOptions, createAgentRunOutcomeTracker, createSandboxRuntimeClient, deriveAgentResultOutcome, deriveAgentRunOutcome, uploadChunked };

package/dist/runtime.js

@@ -1,4 +1,4 @@
-import { a as uploadChunked, h as deriveAgentRunOutcome, m as deriveAgentResultOutcome, p as createAgentRunOutcomeTracker, t as SandboxRuntimeApi } from "./runtime-api-B0tx7NJM.js";
+import { a as uploadChunked, g as deriveAgentRunOutcome, h as deriveAgentResultOutcome, m as createAgentRunOutcomeTracker, t as SandboxRuntimeApi } from "./runtime-api-paApH4-W.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, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.js";
 import { n as combineAbortSignals } from "./abort-signal-si1WMfJb.js";
 //#region src/runtime-client.ts

package/dist/{sandbox-AUHcCJe1.js → sandbox-CyP8CXaF.js}

@@ -1,4 +1,4 @@
-import { a as uploadChunked, c as encodePromptForWire, d as assertCurrentBackendType, f as normalizeRuntimeBackendConfig, i as sessionHeaders, m as deriveAgentResultOutcome, n as normalizeSessionInfo, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as createAgentRunOutcomeTracker, r as appendSessionIdQuery, t as SandboxRuntimeApi, u as applyRequestedModel } from "./runtime-api-B0tx7NJM.js";
+import { a as uploadChunked, c as encodePromptForWire, d as applyRequestedModel, f as assertCurrentBackendType, h as deriveAgentResultOutcome, i as sessionHeaders, m as createAgentRunOutcomeTracker, n as normalizeSessionInfo, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as normalizeRuntimeBackendConfig, r as appendSessionIdQuery, t as SandboxRuntimeApi, u as parseSSEStream } from "./runtime-api-paApH4-W.js";
 import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, n as CapabilityError, o as NotFoundError, p as ValidationError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.js";
 import { c as createInteractiveControlHolderId, d as interactiveSessionControlReleaseResponseSchema, f as interactiveSessionStatusResponseSchema, i as createBrowserInteractiveSessionControlTransport, o as InteractiveSessionControlController, r as browserInteractiveTerminalEndpoint, s as assertInteractiveSessionRef, u as interactiveSessionControlClaimResponseSchema } from "./browser-interactive-control-controller-wXQ7W5pT.js";
 import { n as combineAbortSignals, t as awaitWithAbort } from "./abort-signal-si1WMfJb.js";
@@ -6,197 +6,6 @@ import { AgentExactRunControlRefSchema, AgentInteractiveSessionAttachSchema, Age
 import { z } from "zod";
 import { AgentInteractiveSessionControlClaimSchema as AgentInteractiveSessionControlClaimSchema$1, AgentInteractiveSessionPromptAcknowledgementSchema as AgentInteractiveSessionPromptAcknowledgementSchema$1, AgentInteractiveSessionRefSchema as AgentInteractiveSessionRefSchema$1, AgentInteractiveSessionStatusSchema, AgentInteractiveSessionStopAcknowledgementSchema as AgentInteractiveSessionStopAcknowledgementSchema$1 } from "@tangle-network/agent-interface/environment-interactive-control";
 import { readTokenCostUsd, readTokenUsage } from "@tangle-network/agent-core";
-//#region ../../../packages/sse-core/dist/index.js
-/**
-* Incremental SSE frame parser. Feed decoded text via `push()`; call
-* `flush()` when the stream ends.
-*/
-var SSEFrameParser = class {
-	buffer = "";
-	frameEvent = "";
-	frameId;
-	frameDataLines = null;
-	bomChecked = false;
-	/**
-	* Append a decoded text chunk and return every frame the chunk
-	* completes. Frame state survives across calls: one frame can
-	* straddle any number of chunks.
-	*/
-	push(chunk) {
-		let text = chunk;
-		if (!this.bomChecked && text.length > 0) {
-			this.bomChecked = true;
-			if (text.charCodeAt(0) === 65279) text = text.slice(1);
-		}
-		this.buffer += text;
-		const lines = this.buffer.split("\n");
-		this.buffer = lines.pop() ?? "";
-		return this.processLines(lines);
-	}
-	/**
-	* End-of-stream: process the unterminated trailing line, then
-	* dispatch a dangling frame that never got its blank line.
-	* Well-behaved servers end frames with "\n\n", but some close early.
-	*/
-	flush() {
-		const rest = this.buffer;
-		this.buffer = "";
-		const frames = rest.length > 0 ? this.processLines([rest]) : [];
-		const dangling = this.dispatch();
-		if (dangling) frames.push(dangling);
-		return frames;
-	}
-	processLines(lines) {
-		const frames = [];
-		for (const rawLine of lines) {
-			const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
-			if (line === "") {
-				const frame = this.dispatch();
-				if (frame) frames.push(frame);
-				continue;
-			}
-			if (line.startsWith(":")) continue;
-			if (line.startsWith("data:")) {
-				let value = line.slice(5);
-				if (value.startsWith(" ")) value = value.slice(1);
-				if (this.frameDataLines === null) this.frameDataLines = [];
-				this.frameDataLines.push(value);
-				continue;
-			}
-			if (line.startsWith("event:")) {
-				this.frameEvent = line.slice(6).trim();
-				continue;
-			}
-			if (line.startsWith("id:")) this.frameId = line.slice(3).trim();
-		}
-		return frames;
-	}
-	/**
-	* Dispatch the accumulated frame. A frame with no `data:` field (an
-	* `event:`/`id:`-only frame, or a bare comment) produces nothing, and
-	* its field state is consumed and reset either way.
-	*/
-	dispatch() {
-		const dataLines = this.frameDataLines;
-		const frame = dataLines ? {
-			event: this.frameEvent,
-			data: dataLines.join("\n"),
-			id: this.frameId || void 0
-		} : null;
-		this.frameEvent = "";
-		this.frameId = void 0;
-		this.frameDataLines = null;
-		return frame;
-	}
-};
-/**
-* Read a streaming SSE response body into parsed frames.
-*
-* @throws `TypeError` when the body is missing.
-* @throws `DOMException` with `name === "AbortError"` on cancellation —
-*   including the WHATWG-fetch variant where an aborted body resolves
-*   `done: true` instead of rejecting the read.
-*/
-async function* streamSSEFrames(body, options) {
-	if (!body) throw new TypeError("SSE stream has no response body");
-	const reader = body.getReader();
-	const decoder = new TextDecoder();
-	const parser = new SSEFrameParser();
-	const { signal } = options ?? {};
-	let completed = false;
-	try {
-		for (;;) {
-			if (signal?.aborted) throw new DOMException("SSE stream aborted", "AbortError");
-			const { done, value } = await reader.read();
-			if (done) {
-				if (signal?.aborted) throw new DOMException("SSE stream aborted", "AbortError");
-				break;
-			}
-			for (const frame of parser.push(decoder.decode(value, { stream: true }))) yield frame;
-		}
-		for (const frame of parser.push(decoder.decode())) yield frame;
-		for (const frame of parser.flush()) yield frame;
-		completed = true;
-	} finally {
-		if (!completed) await reader.cancel().catch(() => void 0);
-		reader.releaseLock();
-	}
-}
-//#endregion
-//#region src/lib/sse-parser.ts
-/**
-* SSE Stream Parser
-*
-* EventSource stream parsing for SDK consumers. Framing — buffering
-* chunk-straddling frames, LF/CRLF terminators, multi-line `data:` joins,
-* comment heartbeats, BOM — lives in `@tangle-network/sse-core`, the one
-* wire-format implementation shared across the repo (bundled into this
-* package's dist, so the SDK stays dependency-free at runtime). This
-* module owns the SDK's payload contract on top of it: JSON parsing, the
-* `"message"` default event type, and the malformed-frame policy. Used by
-* `Sandbox.streamBatch` and by the web dashboard's batch page; exported
-* so downstream surfaces don't maintain their own copies.
-*
-* Guarantees:
-*   - Correctly buffers frames that straddle chunk boundaries.
-*   - Accepts LF- and CRLF-terminated streams interchangeably.
-*   - Joins multi-line `data:` per the spec (dispatch joins with
-*     "\n" before JSON parse).
-*   - Defaults event type to `"message"` when a frame carries
-*     `data:` but no `event:` field (SSE spec §9.2.6 step 3).
-*   - Surfaces optional `id:` so callers can implement reconnection.
-*   - Flushes a dangling event when the stream closes without a
-*     terminating blank line (well-behaved servers emit `\n\n`, but
-*     some close early).
-*   - Throws `AbortError` when the caller-supplied signal fires, so
-*     consumers can distinguish "ran to completion" from "cancelled"
-*     without peeking at signal state.
-*   - Rejects malformed JSON by default. Callers handling recoverable output
-*     streams can explicitly warn and skip one invalid frame.
-*
-* What it does NOT do:
-*   - CR-only (legacy Mac) line terminators. No known emitter uses
-*     them; supporting them would risk splitting payloads that
-*     legitimately contain CR.
-*   - Retry/reconnect (caller's responsibility).
-*   - Event-type filtering (caller's responsibility).
-*/
-/**
-* Parse a streaming SSE response body into an async iterable of
-* structured events.
-*
-* @throws `TypeError` when the response has no body.
-* @throws `DOMException` with `name === "AbortError"` on cancellation.
-*/
-async function* parseSSEStream(body, options) {
-	const { signal, invalidEvent = "throw" } = options ?? {};
-	for await (const frame of streamSSEFrames(body, { signal })) {
-		const effectiveEvent = frame.event || "message";
-		let data;
-		try {
-			data = JSON.parse(frame.data);
-		} catch (error) {
-			if (invalidEvent === "warn-and-skip") {
-				console.warn(`[sandbox-sdk] Malformed SSE JSON for event "${effectiveEvent}": ${frame.data.slice(0, 200)}`);
-				continue;
-			}
-			throw new SyntaxError(`Malformed SSE JSON for event "${effectiveEvent}"`, { cause: error });
-		}
-		if (typeof data !== "object" || data === null || Array.isArray(data)) {
-			if (invalidEvent === "warn-and-skip") {
-				console.warn(`[sandbox-sdk] SSE event "${effectiveEvent}" data must be a JSON object`);
-				continue;
-			}
-			throw new TypeError(`SSE event "${effectiveEvent}" data must be a JSON object`);
-		}
-		yield {
-			type: effectiveEvent,
-			data,
-			id: frame.id
-		};
-	}
-}
-//#endregion
 //#region src/trace-exporter.ts
 function buildTraceExportPayload(bundle, format = "tangle", serviceName = "tangle-sandbox") {
 	if (format === "tangle") return bundle;
@@ -7584,4 +7393,4 @@ function quoteForShell(value) {
 	return `'${value.replace(/'/g, "'\\''")}'`;
 }
 //#endregion
-export { normalizeConnection as C, toOtelJson as D, otelTraceIdForTangleTrace as E, parseSSEStream as O, isToolBearingEvent as S, exportTraceBundle as T, requestInteractiveSessionToken as _, WorkspaceImages as a, collectAgentResponseText as b, SandboxTaskSession as c, agentInteractiveSessionPromptRequestDigest as d, BrowserInteractiveSessionController as f, TERMINAL_WS_ECHO_SUBPROTOCOL as g, TerminalStreamError as h, normalizeStartupDiagnostics as i, SandboxSession as l, TerminalStream as m, createSandboxInstanceFromResponse as n, GPU_LEASE_PROVIDER_NAMES as o, InteractiveSessionController as p, normalizeSandboxCreateReceipt as r, MAX_EGRESS_DENIALS_LIMIT as s, SandboxInstance as t, InteractiveSessionHandle as u, applySandboxEventText as v, buildTraceExportPayload as w, getSandboxEventText as x, collectAgentFinalMessageText as y };
+export { normalizeConnection as C, toOtelJson as D, otelTraceIdForTangleTrace as E, isToolBearingEvent as S, exportTraceBundle as T, requestInteractiveSessionToken as _, WorkspaceImages as a, collectAgentResponseText as b, SandboxTaskSession as c, agentInteractiveSessionPromptRequestDigest as d, BrowserInteractiveSessionController as f, TERMINAL_WS_ECHO_SUBPROTOCOL as g, TerminalStreamError as h, normalizeStartupDiagnostics as i, SandboxSession as l, TerminalStream as m, createSandboxInstanceFromResponse as n, GPU_LEASE_PROVIDER_NAMES as o, InteractiveSessionController as p, normalizeSandboxCreateReceipt as r, MAX_EGRESS_DENIALS_LIMIT as s, SandboxInstance as t, InteractiveSessionHandle as u, applySandboxEventText as v, buildTraceExportPayload as w, getSandboxEventText as x, collectAgentFinalMessageText as y };

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-iDk_s8vt.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-DcZBrAGY.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-iDk_s8vt.js → tangle-DcZBrAGY.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox",
-  "version": "0.31.1",
+  "version": "0.32.0-develop.20260825065945.0d55d7c",
   "description": "Client SDK for the Tangle Sandbox platform - build AI agent applications with dev containers",
   "type": "module",
   "sideEffects": [
@@ -137,8 +137,8 @@
     "yjs": "13.6.30",
     "@repo/shared": "0.0.0",
     "@tangle-network/cli-agent-registry": "0.3.11",
-    "@tangle-network/sse-core": "0.0.0",
-    "@tangle-network/runtime-contracts": "0.6.2"
+    "@tangle-network/runtime-contracts": "0.6.2",
+    "@tangle-network/sse-core": "0.0.0"
   },
   "scripts": {
     "build": "node scripts/build-dist.mjs",