@tangle-network/sandbox 0.60.16-develop.20261006041203.03ae563 → 0.60.16-develop.20261006051703.cde74c0

package/dist/intelligence/index.d.ts

@@ -181,6 +181,66 @@ interface SessionSummaryList {
   items: SessionSummary[];
   nextCursor: string | null;
 }
+/**
+ * One agent session file the platform captured from a cloud sandbox of a run
+ * (`GET /v1/run-sessions/{runId}`). Files outlive the sandbox; the stored
+ * bytes are redacted, and `sourceSha256` names the bytes as captured.
+ */
+interface RunSessionFile {
+  runId: string;
+  sandboxId: string;
+  /** The sidecar session the file was captured from. */
+  sessionId: string;
+  /** `native/<executionId>/<attempt>/<storePath>`, `events/<executionId>.ndjson` or `capture.json`. */
+  path: string;
+  harness: string | null;
+  format: string | null;
+  contentType: string;
+  /** `withheld`: captured but not stored (`unscannable_binary` or `too_large`). */
+  state: "stored" | "withheld";
+  withheldReason: string | null;
+  sourceSha256: string;
+  sourceBytes: number;
+  storedSha256: string | null;
+  storedBytes: number | null;
+  redactionVersion: string | null;
+  redactionCount: number | null;
+  updatedAt: string;
+}
+/** The final capture of one sandbox, sealed before the sandbox was deleted. */
+interface RunSessionSeal {
+  runId: string;
+  sandboxId: string;
+  /** Whether the sandbox was running when its final capture was taken. */
+  runtime: "running" | "not_running";
+  /** True when the final capture named no gap. */
+  complete: boolean;
+  missing: string[];
+  storedFiles: number;
+  withheldFiles: number;
+  storedBytes: number;
+  workspaceSnapshot: string | null;
+  sealedAt: string;
+}
+/**
+ * One page of a run's captured files (`GET /v1/run-sessions/{runId}`), in
+ * sandbox, session and path order. Every sandbox's seal comes with the first
+ * page; later pages carry an empty `seals`.
+ */
+interface RunSessionList {
+  runId: string;
+  files: RunSessionFile[];
+  seals: RunSessionSeal[];
+  /** Pass as `cursor` for the next page; null on the last page. */
+  nextCursor: string | null;
+}
+/** Query params for {@link IntelligenceClient.listRunSessionFiles}. */
+interface ListRunSessionFilesParams {
+  /** Files per page, clamped server-side to `[1, 5000]` (default 1000). */
+  limit?: number;
+  /** Opaque cursor from the prior page's `nextCursor`. */
+  cursor?: string;
+}
 /** Query params for {@link IntelligenceClient.listTraces}. */
 interface ListTracesParams {
   /** Page size, clamped server-side to `[1, 200]` (default 50). */
@@ -260,6 +320,20 @@ interface IntelligenceClient {
   getRun(runId: string): Promise<Run>;
   /** List the spans pivoted to this run (by `run_id`), bounded window. */
   getRunTraces(runId: string): Promise<RunSpanWindow>;
+  /**
+   * List one page of the agent session files the platform captured from this
+   * run's cloud sandboxes; the first page also carries each sandbox's final
+   * seal. A run is the sandbox's create `metadata.run`, or the sandbox id when
+   * the sandbox named no run.
+   */
+  listRunSessionFiles(runId: string, params?: ListRunSessionFilesParams): Promise<RunSessionList>;
+  /**
+   * Async iterator over every captured file of a run, following `nextCursor`
+   * page by page. Seals are on the first page of {@link listRunSessionFiles}.
+   */
+  iterateRunSessionFiles(runId: string, params?: ListRunSessionFilesParams): AsyncGenerator<RunSessionFile, void, unknown>;
+  /** Download one captured file's stored (redacted) bytes. */
+  downloadRunSessionFile(runId: string, file: Pick<RunSessionFile, "sandboxId" | "sessionId" | "path">): Promise<Uint8Array>;
   /** List tenant-wide session summaries (one row per session), newest first. */
   listSessions(params?: ListSessionsParams): Promise<SessionSummaryList>;
   /** List one session's traces as the trace-summary shape, keyset-paginated. */
@@ -289,4 +363,4 @@ interface IntelligenceClient {
  */
 declare function createIntelligenceClient(config: IntelligenceClientConfig): IntelligenceClient;
 //#endregion
-export { DEFAULT_INTELLIGENCE_BASE_URL, GetSessionTracesParams, GetTraceSpansParams, IntelligenceClient, IntelligenceClientConfig, ListRunsParams, ListSessionsParams, ListTracesParams, NanoString, Run, RunList, RunSpanWindow, SerializedSpan, SessionSummary, SessionSummaryList, SpanPage, TraceStatus, TraceSummary, TraceSummaryList, createIntelligenceClient };
+export { DEFAULT_INTELLIGENCE_BASE_URL, GetSessionTracesParams, GetTraceSpansParams, IntelligenceClient, IntelligenceClientConfig, ListRunSessionFilesParams, ListRunsParams, ListSessionsParams, ListTracesParams, NanoString, Run, RunList, RunSessionFile, RunSessionList, RunSessionSeal, RunSpanWindow, SerializedSpan, SessionSummary, SessionSummaryList, SpanPage, TraceStatus, TraceSummary, TraceSummaryList, createIntelligenceClient };

package/dist/intelligence/index.js

@@ -67,37 +67,51 @@ function createIntelligenceClient(config) {
 	* an `AbortController` timeout that surfaces as `TimeoutError`, and a
 	* transport failure wrapped as `NetworkError`. Never reuses the sandbox
 	* `baseUrl` — this is the intelligence host.
+	*
+	* The timeout covers `read` as well, so a server that sends its headers
+	* and then stalls the body still times out. A caller that hands the body
+	* stream on (the NDJSON export) returns the response from `read` and owns
+	* the stream's pace from there.
 	*/
-	async function request(path) {
+	async function request(path, read) {
 		const url = `${baseUrl}${path}`;
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
 		try {
-			return await globalThis.fetch(url, {
-				headers: {
-					Authorization: `Bearer ${apiKey}`,
-					Accept: "application/json"
-				},
-				signal: controller.signal
-			});
+			let response;
+			try {
+				response = await globalThis.fetch(url, {
+					headers: {
+						Authorization: `Bearer ${apiKey}`,
+						Accept: "application/json"
+					},
+					signal: controller.signal
+				});
+			} catch (err) {
+				if (controller.signal.aborted || err instanceof Error && err.name === "AbortError") throw new TimeoutError(timeoutMs);
+				throw new NetworkError(`Failed to connect to Intelligence API: ${err instanceof Error ? err.message : String(err)}`, err instanceof Error ? err : void 0, {
+					endpoint: path,
+					origin: "sandbox-api"
+				});
+			}
+			return await read(response);
 		} catch (err) {
-			if (err instanceof Error && err.name === "AbortError") throw new TimeoutError(timeoutMs);
-			throw new NetworkError(`Failed to connect to Intelligence API: ${err instanceof Error ? err.message : String(err)}`, err instanceof Error ? err : void 0, {
-				endpoint: path,
-				origin: "sandbox-api"
-			});
+			if (controller.signal.aborted && !(err instanceof TimeoutError)) throw new TimeoutError(timeoutMs);
+			throw err;
 		} finally {
 			clearTimeout(timeoutId);
 		}
 	}
 	/** GET a JSON route, raising the SDK's typed error on a non-2xx response. */
 	async function getJson(path) {
-		const response = await request(path);
-		const body = await response.text();
-		if (!response.ok) throw parseErrorResponse(response.status, body, {
-			method: "GET",
-			path
-		}, response.headers);
+		const body = await request(path, async (response) => {
+			const text = await response.text();
+			if (!response.ok) throw parseErrorResponse(response.status, text, {
+				method: "GET",
+				path
+			}, response.headers);
+			return text;
+		});
 		return JSON.parse(body);
 	}
 	async function listTraces(params = {}) {
@@ -121,7 +135,7 @@ function createIntelligenceClient(config) {
 	}
 	async function exportTraceSpansNdjson(traceId) {
 		const path = `/v1/traces/${encodeURIComponent(traceId)}/spans.ndjson`;
-		const response = await request(path);
+		const response = await request(path, async (served) => served);
 		if (!response.ok) {
 			const body = await response.text();
 			throw parseErrorResponse(response.status, body, {
@@ -154,6 +168,40 @@ function createIntelligenceClient(config) {
 	async function getRunTraces(runId) {
 		return getJson(`/v1/runs/${encodeURIComponent(runId)}/traces`);
 	}
+	async function listRunSessionFiles(runId, params = {}) {
+		const search = new URLSearchParams();
+		appendParam(search, "limit", params.limit);
+		appendParam(search, "cursor", params.cursor);
+		const suffix = search.size > 0 ? `?${search}` : "";
+		return getJson(`/v1/run-sessions/${encodeURIComponent(runId)}${suffix}`);
+	}
+	async function* iterateRunSessionFiles(runId, params = {}) {
+		let cursor = params.cursor;
+		for (;;) {
+			const page = await listRunSessionFiles(runId, {
+				...params,
+				cursor
+			});
+			for (const file of page.files) yield file;
+			if (!page.nextCursor) return;
+			cursor = page.nextCursor;
+		}
+	}
+	async function downloadRunSessionFile(runId, file) {
+		const search = new URLSearchParams({
+			sandboxId: file.sandboxId,
+			sessionId: file.sessionId,
+			path: file.path
+		});
+		const path = `/v1/run-sessions/${encodeURIComponent(runId)}/content?${search}`;
+		return request(path, async (response) => {
+			if (!response.ok) throw parseErrorResponse(response.status, await response.text(), {
+				method: "GET",
+				path
+			}, response.headers);
+			return new Uint8Array(await response.arrayBuffer());
+		});
+	}
 	async function listSessions(params = {}) {
 		const search = new URLSearchParams();
 		appendParam(search, "limit", params.limit);
@@ -214,6 +262,9 @@ function createIntelligenceClient(config) {
 		listRuns,
 		getRun,
 		getRunTraces,
+		listRunSessionFiles,
+		iterateRunSessionFiles,
+		downloadRunSessionFile,
 		listSessions,
 		getSessionTraces,
 		iterateTraceSpans,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox",
-  "version": "0.60.16-develop.20261006041203.03ae563",
+  "version": "0.60.16-develop.20261006051703.cde74c0",
   "description": "Client SDK for the Tangle Sandbox platform - build AI agent applications with dev containers",
   "type": "module",
   "sideEffects": [
@@ -151,11 +151,11 @@
     "ws": "^8.20.0",
     "yjs": "13.6.30",
     "@products/sandbox-test-utils": "0.0.0",
-    "@repo/shared": "0.0.0",
-    "@tangle-network/agent-profile-materialize": "0.20.9",
-    "@tangle-network/sdk": "3.3.41",
     "@tangle-network/cli-agent-registry": "0.5.0",
+    "@tangle-network/agent-profile-materialize": "0.20.9",
     "@tangle-network/runtime-contracts": "0.14.0",
+    "@repo/shared": "0.0.0",
+    "@tangle-network/sdk": "3.3.41",
     "@tangle-network/sse-core": "0.0.0"
   },
   "scripts": {