@aexhq/sdk 0.40.8 → 0.40.10

package/dist/_contracts/operations.d.ts

@@ -224,12 +224,12 @@ export declare function download(http: HttpClient, runId: string): Promise<Uint8
 export declare function downloadOutputs(http: HttpClient, runId: string, options?: OutputTransferOptions): Promise<Uint8Array>;
 /**
  * Download only the event archive (the `events` namespace). Always includes
- * typed `events.jsonl`.
+ * typed `events.jsonl` plus `manifest.json`.
  */
 export declare function downloadEvents(http: HttpClient, runId: string): Promise<Uint8Array>;
 /**
  * Download only the run record (the `metadata` namespace) as a zip
- * containing `run.json`.
+ * containing `run.json` plus `manifest.json`.
  */
 export declare function downloadMetadata(http: HttpClient, runId: string): Promise<Uint8Array>;
 export declare function submitRun(http: HttpClient, request: PlatformRunSubmissionInput): Promise<Run>;

package/dist/_contracts/operations.js

@@ -419,7 +419,7 @@ async function readOutputTextWithRetry(http, path, maxBytes, timeoutMs) {
 }
 async function downloadOutputResponse(http, path, timeoutMs) {
     const controller = new AbortController();
-    const { response } = await withOutputTransferTimeout(http.download(path, { signal: controller.signal }), timeoutMs, () => controller.abort(), "output response");
+    const { response } = await withOutputTransferTimeout(http.download(path, { signal: controller.signal }), timeoutMs, () => controller.abort(), "download-open");
     return response;
 }
 async function outputTransferWithRetry(path, timeoutMs, action) {
@@ -439,7 +439,7 @@ async function outputTransferWithRetry(path, timeoutMs, action) {
         method: "GET",
         host: "",
         path,
-        cause: lastTimeout ?? new OutputTransferTimeoutError("output transfer", timeoutMs),
+        cause: lastTimeout ?? new OutputTransferTimeoutError("unknown", timeoutMs),
         attempts: OUTPUT_FILE_TRANSFER_ATTEMPTS,
         elapsedMs: Date.now() - startedMs
     });
@@ -456,18 +456,20 @@ function normalizeOutputTransferTimeoutMs(value) {
 }
 class OutputTransferTimeoutError extends Error {
     code = "ETIMEDOUT";
-    constructor(label, timeoutMs) {
-        super(`${label} timed out after ${timeoutMs}ms`);
+    phase;
+    constructor(phase, timeoutMs) {
+        super(`output transfer phase=${phase} timed out after ${timeoutMs}ms`);
         this.name = "OutputTransferTimeoutError";
+        this.phase = phase;
     }
 }
-async function withOutputTransferTimeout(promise, timeoutMs, abort, label) {
+async function withOutputTransferTimeout(promise, timeoutMs, abort, phase) {
     let timedOut = false;
     let timeout;
     const timeoutPromise = new Promise((_, reject) => {
         timeout = setTimeout(() => {
             timedOut = true;
-            reject(new OutputTransferTimeoutError(label, timeoutMs));
+            reject(new OutputTransferTimeoutError(phase, timeoutMs));
             queueMicrotask(() => {
                 try {
                     abort();
@@ -483,7 +485,7 @@ async function withOutputTransferTimeout(promise, timeoutMs, abort, label) {
     }
     catch (err) {
         if (timedOut && isAbortLikeError(err))
-            throw new OutputTransferTimeoutError(label, timeoutMs);
+            throw new OutputTransferTimeoutError(phase, timeoutMs);
         throw err;
     }
     finally {
@@ -498,7 +500,7 @@ function isAbortLikeError(err) {
 async function readResponseBytes(response, timeoutMs) {
     const body = response.body;
     if (!body) {
-        const buffer = await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => { }, "output body");
+        const buffer = await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => { }, "body-read");
         return new Uint8Array(buffer);
     }
     const reader = body.getReader();
@@ -507,7 +509,7 @@ async function readResponseBytes(response, timeoutMs) {
         while (true) {
             const { done, value } = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
                 void reader.cancel().catch(() => { });
-            }, "output body");
+            }, "body-read");
             if (done)
                 break;
             if (value && value.byteLength > 0)
@@ -532,7 +534,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
     const body = response.body;
     if (!body) {
         // No streaming body (some fetch polyfills) — buffer, then slice to the cap.
-        const buf = new Uint8Array(await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => { }, "output body"));
+        const buf = new Uint8Array(await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => { }, "body-read"));
         const total = declared ?? buf.byteLength;
         return {
             text: decoder.decode(buf.subarray(0, maxBytes)),
@@ -548,7 +550,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
         while (read < maxBytes) {
             const { done, value } = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
                 void reader.cancel().catch(() => { });
-            }, "output body");
+            }, "body-read");
             if (done)
                 break;
             if (value && value.byteLength > 0) {
@@ -560,7 +562,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
             // We hit the cap; peek once more to learn whether bytes remain, then stop.
             const next = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
                 void reader.cancel().catch(() => { });
-            }, "output body");
+            }, "body-read");
             if (!next.done && next.value && next.value.byteLength > 0)
                 sawMore = true;
         }
@@ -978,19 +980,35 @@ export async function downloadOutputs(http, runId, options) {
 }
 /**
  * Download only the event archive (the `events` namespace). Always includes
- * typed `events.jsonl`.
+ * typed `events.jsonl` plus `manifest.json`.
  */
 export async function downloadEvents(http, runId) {
     const events = await listRunEvents(http, runId);
-    return zipEntries([jsonlEntry("events.jsonl", events)]);
+    return zipEntries([
+        jsonlEntry("events.jsonl", events),
+        jsonEntry("manifest.json", {
+            runId,
+            namespace: "events",
+            files: [{ path: "events.jsonl", role: "typed_events", status: "present", recordCount: events.length }],
+            errors: []
+        })
+    ]);
 }
 /**
  * Download only the run record (the `metadata` namespace) as a zip
- * containing `run.json`.
+ * containing `run.json` plus `manifest.json`.
  */
 export async function downloadMetadata(http, runId) {
     const run = await getRun(http, runId);
-    return zipEntries([jsonEntry("run.json", run)]);
+    return zipEntries([
+        jsonEntry("run.json", run),
+        jsonEntry("manifest.json", {
+            runId,
+            namespace: "metadata",
+            files: [{ path: "run.json", role: "run_metadata", status: "present" }],
+            errors: []
+        })
+    ]);
 }
 function zipEntries(entries) {
     assertRunRecordArchivePublicSafeV1(entries);

package/dist/cli.mjs

@@ -3357,7 +3357,7 @@ async function readOutputTextWithRetry(http, path, maxBytes, timeoutMs) {
 }
 async function downloadOutputResponse(http, path, timeoutMs) {
   const controller = new AbortController();
-  const { response } = await withOutputTransferTimeout(http.download(path, { signal: controller.signal }), timeoutMs, () => controller.abort(), "output response");
+  const { response } = await withOutputTransferTimeout(http.download(path, { signal: controller.signal }), timeoutMs, () => controller.abort(), "download-open");
   return response;
 }
 async function outputTransferWithRetry(path, timeoutMs, action) {
@@ -3376,7 +3376,7 @@ async function outputTransferWithRetry(path, timeoutMs, action) {
     method: "GET",
     host: "",
     path,
-    cause: lastTimeout ?? new OutputTransferTimeoutError("output transfer", timeoutMs),
+    cause: lastTimeout ?? new OutputTransferTimeoutError("unknown", timeoutMs),
     attempts: OUTPUT_FILE_TRANSFER_ATTEMPTS,
     elapsedMs: Date.now() - startedMs
   });
@@ -3393,18 +3393,20 @@ function normalizeOutputTransferTimeoutMs(value) {
 }
 var OutputTransferTimeoutError = class extends Error {
   code = "ETIMEDOUT";
-  constructor(label, timeoutMs) {
-    super(`${label} timed out after ${timeoutMs}ms`);
+  phase;
+  constructor(phase, timeoutMs) {
+    super(`output transfer phase=${phase} timed out after ${timeoutMs}ms`);
     this.name = "OutputTransferTimeoutError";
+    this.phase = phase;
   }
 };
-async function withOutputTransferTimeout(promise, timeoutMs, abort, label) {
+async function withOutputTransferTimeout(promise, timeoutMs, abort, phase) {
   let timedOut = false;
   let timeout;
   const timeoutPromise = new Promise((_, reject) => {
     timeout = setTimeout(() => {
       timedOut = true;
-      reject(new OutputTransferTimeoutError(label, timeoutMs));
+      reject(new OutputTransferTimeoutError(phase, timeoutMs));
       queueMicrotask(() => {
         try {
           abort();
@@ -3417,7 +3419,7 @@ async function withOutputTransferTimeout(promise, timeoutMs, abort, label) {
     return await Promise.race([promise, timeoutPromise]);
   } catch (err2) {
     if (timedOut && isAbortLikeError(err2))
-      throw new OutputTransferTimeoutError(label, timeoutMs);
+      throw new OutputTransferTimeoutError(phase, timeoutMs);
     throw err2;
   } finally {
     if (timeout !== void 0)
@@ -3432,7 +3434,7 @@ async function readResponseBytes(response, timeoutMs) {
   const body = response.body;
   if (!body) {
     const buffer = await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => {
-    }, "output body");
+    }, "body-read");
     return new Uint8Array(buffer);
   }
   const reader = body.getReader();
@@ -3442,7 +3444,7 @@ async function readResponseBytes(response, timeoutMs) {
       const { done, value } = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
         void reader.cancel().catch(() => {
         });
-      }, "output body");
+      }, "body-read");
       if (done)
         break;
       if (value && value.byteLength > 0)
@@ -3461,7 +3463,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
   const body = response.body;
   if (!body) {
     const buf = new Uint8Array(await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => {
-    }, "output body"));
+    }, "body-read"));
     const total = declared ?? buf.byteLength;
     return {
       text: decoder.decode(buf.subarray(0, maxBytes)),
@@ -3478,7 +3480,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
       const { done, value } = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
         void reader.cancel().catch(() => {
         });
-      }, "output body");
+      }, "body-read");
       if (done)
         break;
       if (value && value.byteLength > 0) {
@@ -3490,7 +3492,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
       const next = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
         void reader.cancel().catch(() => {
         });
-      }, "output body");
+      }, "body-read");
       if (!next.done && next.value && next.value.byteLength > 0)
         sawMore = true;
     }
@@ -3814,11 +3816,27 @@ async function downloadOutputs(http, runId, options) {
 }
 async function downloadEvents(http, runId) {
   const events = await listRunEvents(http, runId);
-  return zipEntries([jsonlEntry("events.jsonl", events)]);
+  return zipEntries([
+    jsonlEntry("events.jsonl", events),
+    jsonEntry("manifest.json", {
+      runId,
+      namespace: "events",
+      files: [{ path: "events.jsonl", role: "typed_events", status: "present", recordCount: events.length }],
+      errors: []
+    })
+  ]);
 }
 async function downloadMetadata(http, runId) {
   const run = await getRun(http, runId);
-  return zipEntries([jsonEntry("run.json", run)]);
+  return zipEntries([
+    jsonEntry("run.json", run),
+    jsonEntry("manifest.json", {
+      runId,
+      namespace: "metadata",
+      files: [{ path: "run.json", role: "run_metadata", status: "present" }],
+      errors: []
+    })
+  ]);
 }
 function zipEntries(entries) {
   assertRunRecordArchivePublicSafeV1(entries);

package/dist/cli.mjs.sha256

@@ -1 +1 @@
-cdab07311ba092bc586f1d536208b0ca762c2014ddfb8f4219beb21a6302b59b  cli.mjs
+feca3311d49affc9dd305e9c1a8da4faee1c604662ebb34abc142c8f1276635c  cli.mjs

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  *
  * Used by the (future) User-Agent header on outbound SDK requests.
  */
-export declare const SDK_VERSION = "0.40.8";
+export declare const SDK_VERSION = "0.40.10";

package/dist/version.js

@@ -6,5 +6,5 @@
  *
  * Used by the (future) User-Agent header on outbound SDK requests.
  */
-export const SDK_VERSION = "0.40.8";
+export const SDK_VERSION = "0.40.10";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC"}

package/docs/outputs.md

@@ -38,8 +38,8 @@ A session's downloadable content is organised into three logical namespaces, eac
 | Namespace | What it holds | Verb | CLI |
 | --- | --- | --- | --- |
 | `outputs` | The session's real deliverables. | `session.outputs().download()` | `download <id> --only outputs` |
-| `events` | Typed event-channel records (`events.jsonl`). | `session.events().download()` | `download <id> --only events` |
-| `metadata` | The session record (`run.json`). | `session.downloadMetadata()` | `download <id> --only metadata` |
+| `events` | Typed event-channel records (`events.jsonl`) plus a namespace manifest. | `session.events().download()` | `download <id> --only events` |
+| `metadata` | The session record (`run.json`) plus a namespace manifest. | `session.downloadMetadata()` | `download <id> --only metadata` |
 
 Platform diagnostics are stored outside the public archive under `runs/<runId>/internal/logs/` for internal/admin access only. They are not exposed by the SDK download helpers or the public CLI.
 
@@ -66,7 +66,7 @@ manifest.json         # RunRecordManifestV1
 | `outputs[]` | `{ id, filename, sizeBytes?, contentType? }` — one row per file successfully written under `outputs/`. |
 | `errors[]` | `{ namespace, id, filename, message }` — per-artifact byte fetches that failed during assembly. Best-effort: a failure records an entry here and is skipped from the tree rather than aborting the whole zip. |
 
-The single-namespace verbs return the same per-file bytes at the zip root (e.g. `session.outputs().download()` -> `report.txt` + a `manifest.json`; `session.events().download()` -> `events.jsonl`).
+The single-namespace verbs return the same per-file bytes at the zip root (e.g. `session.outputs().download()` -> `report.txt` + `manifest.json`; `session.events().download()` -> `events.jsonl` + `manifest.json`; `session.downloadMetadata()` -> `run.json` + `manifest.json`).
 
 ## Downloading one output
 
@@ -253,7 +253,7 @@ Capture notes:
 
 ## Runs without explicit `outputs.allowedDirs`
 
-Metadata still gets the full treatment. aex captures every regular file the run created or modified outside mandatory platform excludes. A run that produces no files still returns a zip with `run.json`, `events.jsonl`, and an empty `outputs/` directory (manifest `outputs: []`).
+Metadata still gets the full treatment. aex captures every regular file the run created or modified outside mandatory platform excludes. A run that produces no files still returns a whole-session zip with `metadata/run.json`, `events/events.jsonl`, and `manifest.json` (manifest `outputs: []`).
 
 ## Mid-session download semantics
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.40.8",
+  "version": "0.40.10",
   "description": "TypeScript SDK for running autonomous agent sessions across providers (Anthropic, OpenAI, DeepSeek, Gemini, Mistral) behind one interface.",
   "license": "Apache-2.0",
   "repository": {