@cursor/july 0.1.108 → 0.1.111

package/dist/internal/framework-file-storage.js

@@ -21,9 +21,8 @@
  * `continuation` go to the framework file store (file-shaped; the store
  * accepts values up to 64 MiB per
  * object without chunking, versus the KV proxy's 1 MiB row cap), while
- * author `kv`, eval runs, A/B samples, and conditional writes stay on the
- * control-plane KV proxy (the dashboard reads them there, and CAS needs a
- * database).
+ * author `kv`, eval runs, and conditional writes stay on the control-plane
+ * KV proxy (the dashboard reads them there, and CAS needs a database).
  *
  * v2 only, by construction: the composite is selected in
  * framework-storage-selection.ts, which v1 never reaches with a
@@ -82,7 +81,7 @@ const LIST_READ_CONCURRENCY = 8;
 function isUnrepresentableFileKey(key) {
     return key
         .split("/")
-        .some((segment) => segment === "" || segment === "." || segment === "..");
+        .some(segment => segment === "" || segment === "." || segment === "..");
 }
 /**
  * Adapt a {@link FileSink} to the `defineStorage` KV core. Storage keys are
@@ -105,6 +104,59 @@ export function fileSinkStorageCore(sink) {
                 yield sink.put(key, encodeDocument(key, value));
             });
         },
+        putMany(entries) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const results = entries.map(entry => ({ key: entry.key }));
+                const writable = [];
+                for (let index = 0; index < entries.length; index += 1) {
+                    const entry = entries[index];
+                    if (entry === undefined) {
+                        continue;
+                    }
+                    if (isUnrepresentableFileKey(entry.key)) {
+                        results[index] = {
+                            key: entry.key,
+                            error: new Error(`framework file storage: key "${entry.key}" has a path segment the store cannot represent`),
+                        };
+                        continue;
+                    }
+                    writable.push({
+                        index,
+                        key: entry.key,
+                        body: encodeDocument(entry.key, entry.value),
+                    });
+                }
+                if (writable.length === 0) {
+                    return results;
+                }
+                if (sink.putMany !== undefined) {
+                    // The point of the batch: one backend round trip for the flush.
+                    const settled = yield sink.putMany(writable.map(({ key, body }) => ({ key, body })));
+                    for (let i = 0; i < writable.length; i += 1) {
+                        const target = writable[i];
+                        const outcome = settled[i];
+                        if (target === undefined) {
+                            continue;
+                        }
+                        if ((outcome === null || outcome === void 0 ? void 0 : outcome.status) === "rejected") {
+                            results[target.index] = { key: target.key, error: outcome.reason };
+                        }
+                    }
+                    return results;
+                }
+                // No batch support: sequential puts, preserving the sink's strict
+                // one-at-a-time ordering contract.
+                for (const target of writable) {
+                    try {
+                        yield sink.put(target.key, target.body);
+                    }
+                    catch (error) {
+                        results[target.index] = { key: target.key, error };
+                    }
+                }
+                return results;
+            });
+        },
         get(key) {
             return __awaiter(this, void 0, void 0, function* () {
                 if (isUnrepresentableFileKey(key)) {
@@ -130,7 +182,7 @@ export function fileSinkStorageCore(sink) {
                 const entries = yield sink.list(prefix);
                 // FileSink.list returns metadata only, so each value is its own
                 // read; bound the fan-out — a bulk read here sits on restore paths.
-                const bodies = yield mapBounded(entries, LIST_READ_CONCURRENCY, (entry) => sink.get(entry.key));
+                const bodies = yield mapBounded(entries, LIST_READ_CONCURRENCY, entry => sink.get(entry.key));
                 const out = [];
                 for (let index = 0; index < entries.length; index += 1) {
                     const entry = entries[index];
@@ -188,14 +240,50 @@ function decodeDocument(key, bytes) {
 /**
  * Split one storage core by key kind: framework session state to `files`,
  * everything else to `kv`. Spread over the KV backend when building the
- * full definition so its `evals` / `abs` groups (and the cursor-hosted
- * marker) ride along untouched; wrap the KV `cas` group with
+ * full definition so its `evals` group (and the cursor-hosted marker)
+ * rides along untouched; wrap the KV `cas` group with
  * {@link frameworkGuardedCas} rather than spreading it as-is.
  */
 export function composeFrameworkStorage(input) {
     const route = (key) => isFrameworkFileKey(key) ? input.files : input.kv;
     return {
         put: (key, value, ctx) => route(key).put(key, value, ctx),
+        putMany(entries, ctx) {
+            return __awaiter(this, void 0, void 0, function* () {
+                // Partition by destination store, batch each side, and reassemble
+                // per-entry outcomes in input order.
+                const indexed = entries.map((entry, index) => ({ entry, index }));
+                const results = entries.map(entry => ({ key: entry.key }));
+                for (const core of [input.files, input.kv]) {
+                    const side = indexed.filter(({ entry }) => route(entry.key) === core);
+                    if (side.length === 0) {
+                        continue;
+                    }
+                    if (core.putMany === undefined) {
+                        // No batch write on this side (the KV proxy): sequential puts,
+                        // preserving the strict one-at-a-time ordering it promises.
+                        for (const { entry, index } of side) {
+                            try {
+                                yield core.put(entry.key, entry.value, ctx);
+                            }
+                            catch (error) {
+                                results[index] = { key: entry.key, error };
+                            }
+                        }
+                        continue;
+                    }
+                    const settled = yield core.putMany(side.map(({ entry }) => entry), ctx);
+                    for (let i = 0; i < side.length; i += 1) {
+                        const target = side[i];
+                        const outcome = settled[i];
+                        if (target !== undefined && outcome !== undefined) {
+                            results[target.index] = outcome;
+                        }
+                    }
+                }
+                return results;
+            });
+        },
         get: (key, ctx) => route(key).get(key, ctx),
         delete: (key, ctx) => route(key).delete(key, ctx),
         list: (prefix, ctx) => route(prefix).list(prefix, ctx),

package/dist/internal/framework-storage-selection.d.ts

@@ -24,8 +24,8 @@
  *   (`AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID`, bound at task time) holds
  *   session records, event transcripts, and the continuation index —
  *   file-shaped state on file storage, apart from the author-facing user
- *   store. Author `host.kv`, eval runs, A/B samples, and conditional writes
- *   ride the AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
+ *   store. Author `host.kv`, eval runs, and conditional writes ride the
+ *   AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
  *   pod service account to the factorydb deployment row (the v1 Bugbot
  *   proxy cannot resolve v2 pods at all). Framework session state never
  *   routes to the KV proxy — the composite splits by key kind — so
@@ -48,12 +48,6 @@
  */
 import { type StorageDefinition } from "../storage.js";
 import type { AgentArchitecture } from "../types.js";
-/**
- * Hosted v2 event-chunk flush debounce. Matches the session view's live poll
- * cadence; a streaming turn still caps each chunk at the coordinator's batch
- * limit, so a long turn writes a few dozen chunks rather than one per event.
- */
-export declare const HOSTED_V2_EVENT_FLUSH_DEBOUNCE_MS = 2000;
 export interface FrameworkStorageSelectionInput {
     /** `agent/storage.ts`, when the author wrote one (v1 only: discovery rejects it on v2). */
     readonly authored: StorageDefinition | undefined;

package/dist/internal/framework-storage-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-storage-selection.d.ts","sourceRoot":"","sources":["../../src/internal/framework-storage-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD,MAAM,WAAW,8BAA8B;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GACpC,iBAAiB,GAAG,SAAS,CA6E/B"}
+{"version":3,"file":"framework-storage-selection.d.ts","sourceRoot":"","sources":["../../src/internal/framework-storage-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,MAAM,WAAW,8BAA8B;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GACpC,iBAAiB,GAAG,SAAS,CA0E/B"}

package/dist/internal/framework-storage-selection.js

@@ -24,8 +24,8 @@
  *   (`AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID`, bound at task time) holds
  *   session records, event transcripts, and the continuation index —
  *   file-shaped state on file storage, apart from the author-facing user
- *   store. Author `host.kv`, eval runs, A/B samples, and conditional writes
- *   ride the AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
+ *   store. Author `host.kv`, eval runs, and conditional writes ride the
+ *   AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
  *   pod service account to the factorydb deployment row (the v1 Bugbot
  *   proxy cannot resolve v2 pods at all). Framework session state never
  *   routes to the KV proxy — the composite splits by key kind — so
@@ -53,12 +53,6 @@ import { cursorHostedStorageV2 } from "../storage-backends/cursor-hosted-v2.js";
 import { resolveApiKeySync } from "./cursor/credentials.js";
 import { composeFrameworkStorage, fileSinkStorageCore, frameworkGuardedCas, } from "./framework-file-storage.js";
 import { resolveAgentV2Hosting } from "./v2-hosting.js";
-/**
- * Hosted v2 event-chunk flush debounce. Matches the session view's live poll
- * cadence; a streaming turn still caps each chunk at the coordinator's batch
- * limit, so a long turn writes a few dozen chunks rather than one per event.
- */
-export const HOSTED_V2_EVENT_FLUSH_DEBOUNCE_MS = 2000;
 /**
  * Pick the backend for framework session state.
  *
@@ -100,13 +94,10 @@ export function selectFrameworkStorageDefinition(input) {
     // comes up). Follow-ups restore lazily by continuation or session id;
     // GET /v1/sessions lists from the sink either way.
     //
-    // Events flush on a quiet-period debounce rather than only at turn end so
-    // the read-only session view and dashboard trace (which have no resident
-    // engine to ask) see steps mid-turn. The turn-end record still lands
-    // before the execution reply: drainSessionDurability forces the flush.
+    // Events flush at turn end. drainSessionDurability still forces the
+    // record onto the sink before the execution reply.
     const policy = {
         restore: "off",
-        debounceMs: HOSTED_V2_EVENT_FLUSH_DEBOUNCE_MS,
     };
     // Full chain (env → bind file → stored login): frozen engines listen
     // unsigned and bind store ids + CURSOR_API_KEY at task time, after this

package/dist/internal/github-fanout.js

@@ -58,7 +58,7 @@ function handleFanoutRequest(req, res, targets, options) {
     });
     req.on("end", () => {
         void fanoutDelivery(Buffer.concat(chunks), req.headers, targets, options)
-            .then((delivered) => {
+            .then(delivered => {
             res.writeHead(200, { "content-type": "application/json" });
             res.end(JSON.stringify({ ok: true, delivered }));
         })
@@ -79,7 +79,7 @@ function handleFanoutRequest(req, res, targets, options) {
 export function fanoutDelivery(body_1, headers_1, targets_1) {
     return __awaiter(this, arguments, void 0, function* (body, headers, targets, options = {}) {
         var _a;
-        const log = (_a = options.logger) !== null && _a !== void 0 ? _a : ((line) => process.stderr.write(line));
+        const log = (_a = options.logger) !== null && _a !== void 0 ? _a : (line => process.stderr.write(line));
         const event = typeof headers["x-github-event"] === "string"
             ? headers["x-github-event"]
             : undefined;
@@ -90,7 +90,7 @@ export function fanoutDelivery(body_1, headers_1, targets_1) {
                 outbound[name] = value;
             }
         }
-        const recipients = targets.filter((target) => event === undefined || target.events.includes(event));
+        const recipients = targets.filter(target => event === undefined || target.events.includes(event));
         // Reuse one Uint8Array view across recipients (Buffer isn't a BodyInit).
         const payload = new Uint8Array(body);
         const delivered = [];

package/dist/internal/guest-network.js

@@ -125,7 +125,7 @@ function hasCodeAtDepth(error, depth, codes) {
         return true;
     }
     if (error instanceof AggregateError &&
-        error.errors.some((inner) => hasCodeAtDepth(inner, depth + 1, codes))) {
+        error.errors.some(inner => hasCodeAtDepth(inner, depth + 1, codes))) {
         return true;
     }
     return hasCodeAtDepth(error.cause, depth + 1, codes);
@@ -146,7 +146,7 @@ function isQuietSignatureAtDepth(error, depth) {
         return true;
     }
     if (error instanceof AggregateError &&
-        error.errors.some((inner) => isQuietSignatureAtDepth(inner, depth + 1))) {
+        error.errors.some(inner => isQuietSignatureAtDepth(inner, depth + 1))) {
         return true;
     }
     return isQuietSignatureAtDepth(error.cause, depth + 1);
@@ -175,7 +175,7 @@ function isTransientAtDepth(error, depth) {
         return true;
     }
     if (error instanceof AggregateError &&
-        error.errors.some((inner) => isTransientAtDepth(inner, depth + 1))) {
+        error.errors.some(inner => isTransientAtDepth(inner, depth + 1))) {
         return true;
     }
     return isTransientAtDepth(error.cause, depth + 1);
@@ -185,7 +185,7 @@ const DEFAULT_PROBE_TIMEOUT_MS = 2000;
 export const DEFAULT_WAIT_TIMEOUT_MS = 8000;
 const DEFAULT_POLL_MS = 250;
 function defaultSleep(ms) {
-    return new Promise((resolve) => {
+    return new Promise(resolve => {
         setTimeout(resolve, ms);
     });
 }

package/dist/internal/host-files.js

@@ -160,7 +160,7 @@ function statKey(sink, key) {
             return yield sink.stat(key);
         }
         const entries = yield sink.list(key);
-        return entries.find((entry) => entry.key === key);
+        return entries.find(entry => entry.key === key);
     });
 }
 // ============================================================================

package/dist/internal/host-kv.js

@@ -23,9 +23,9 @@ export function createHostKvApi(options) {
     const storage = options.storage;
     if ((storage === null || storage === void 0 ? void 0 : storage.supportsAuthorKv) === true) {
         return {
-            get: (key) => storage.kvGet(normalizeAuthorKey(key)),
+            get: key => storage.kvGet(normalizeAuthorKey(key)),
             put: (key, value) => storage.kvPut(normalizeAuthorKey(key), value),
-            delete: (key) => storage.kvDelete(normalizeAuthorKey(key)),
+            delete: key => storage.kvDelete(normalizeAuthorKey(key)),
         };
     }
     return createFilesystemKvApi({

package/dist/internal/hosted-admission-adapter.d.ts

@@ -24,6 +24,8 @@ export type HostedAdmissionAdapter = {
         payload: unknown;
         deliveryId: string;
         args: ChannelHandlerArgs;
+        /** Mailbox key the control plane already allocated for this admission. */
+        mailboxContinuationKey?: string;
     }): Promise<Response>;
 };
 export declare function attachHostedAdmissionAdapter(definition: object, adapter: HostedAdmissionAdapter): void;

package/dist/internal/hosted-admission-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-admission-adapter.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-admission-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE;QACd,iFAAiF;QACjF,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,kBAAkB,CAAC;KAC1B,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvB,CAAC;AAIF,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAEN;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,GACjB,sBAAsB,GAAG,SAAS,CAEpC"}
+{"version":3,"file":"hosted-admission-adapter.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-admission-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE;QACd,iFAAiF;QACjF,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,kBAAkB,CAAC;QACzB,0EAA0E;QAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvB,CAAC;AAIF,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAEN;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,GACjB,sBAAsB,GAAG,SAAS,CAEpC"}

package/dist/internal/hosted-catch-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-catch-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-catch-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,eAAO,MAAM,6BAA6B,WAAW,CAAC;AACtD,eAAO,MAAM,4BAA4B,qBAAqB,CAAC;AAC/D,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAClD,eAAO,MAAM,mCAAmC,kBAAkB,CAAC;AACnE,eAAO,MAAM,8BAA8B,EAAE,MAAmB,CAAC;AAEjE,eAAO,MAAM,6BAA6B,YACxC,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,QAAQ,CACA,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG;IACjC,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,gBAAgB,CAAC;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEtE;AAqBD,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,oBAAoB,GAAG,SAAS,CA2ClC;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,MAAM,CAK1E"}
+{"version":3,"file":"hosted-catch-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-catch-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,eAAO,MAAM,6BAA6B,WAAW,CAAC;AACtD,eAAO,MAAM,4BAA4B,qBAAqB,CAAC;AAC/D,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAClD,eAAO,MAAM,mCAAmC,kBAAkB,CAAC;AACnE,eAAO,MAAM,8BAA8B,EAAE,MAAmB,CAAC;AAEjE,eAAO,MAAM,6BAA6B,YACxC,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,QAAQ,CACA,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG;IACjC,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,gBAAgB,CAAC;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEtE;AAiBD,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,oBAAoB,GAAG,SAAS,CA2ClC;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,MAAM,CAK1E"}

package/dist/internal/hosted-catch-protocol.js

@@ -12,6 +12,7 @@
  * secret. July replays it into the authored route handler; the control
  * plane never runs channel code.
  */
+import { isRecord } from "./is-record.js";
 export const AGENT_SDK_CATCH_ENVELOPE_VERSION = 1;
 export const AGENT_SDK_CATCH_EVENT_TYPE = "http.request";
 export const AGENT_SDK_CUSTOM_CHANNEL_KIND = "custom";
@@ -50,15 +51,12 @@ const MAX_PATH_CHARS = 1024;
 const MAX_QUERY_CHARS = 4096;
 const MAX_HEADER_COUNT = 64;
 const MAX_HEADER_BYTES = 16 * 1024;
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 /** Strict parse of a claim-checked catch envelope; anything else is undefined. */
 export function parseCatchRequestEnvelope(value) {
     if (!isRecord(value)) {
         return undefined;
     }
-    if (Object.keys(value).some((key) => !ENVELOPE_KEYS.has(key)) ||
+    if (Object.keys(value).some(key => !ENVELOPE_KEYS.has(key)) ||
         value.v !== AGENT_SDK_CATCH_ENVELOPE_VERSION ||
         typeof value.method !== "string" ||
         !METHODS.has(value.method) ||

package/dist/internal/hosted-catch.js

@@ -70,7 +70,7 @@ export function replayCatchRequest(input) {
             });
         }
         const matched = router.match(envelope.method, envelope.path);
-        const route = input.routes.find((candidate) => candidate.method === (matched === null || matched === void 0 ? void 0 : matched.route.method) &&
+        const route = input.routes.find(candidate => candidate.method === (matched === null || matched === void 0 ? void 0 : matched.route.method) &&
             candidate.path === matched.route.pattern);
         if (matched === undefined || route === undefined) {
             // The control plane routes from the same pinned manifest this VM was

package/dist/internal/hosted-delivery-protocol.d.ts

@@ -119,18 +119,47 @@ export type HostedAdmissionOutcome = {
     outcome: "send";
     admissionToken: string;
 };
+/**
+ * Cap on delivery IDs an owner execute may report as consumed (primary +
+ * accepted active-guest enqueues). Enqueue requests beyond this return
+ * `not_active`.
+ */
+export declare const HOSTED_MAX_CONSUMED_DELIVERY_IDS = 16;
+/** Hosted-execution run mode. Omitted/`execute` is the legacy wait path. */
+export type HostedExecutionMode = "execute" | "enqueue";
 export type HostedExecution = {
     v: 2;
     admissionToken: string;
     sessionPublicId: string;
+    /**
+     * `execute` (default when omitted) runs the owner send and waits for the
+     * coalesce chain. `enqueue` injects into an accepting owner or returns
+     * `not_active`.
+     */
+    mode?: HostedExecutionMode;
 };
 export type HostedExecutionOutcome = {
     ok: true;
     v: 2;
     outcome: "send";
+    /**
+     * Primary delivery id then accepted enqueue ids; length 1..16.
+     * Optional for old-guest compatibility; callers must normalize absent
+     * lists to `[primaryDeliveryId]`.
+     */
+    consumedDeliveryIds?: string[];
+} | {
+    ok: true;
+    v: 2;
+    outcome: "enqueued";
+} | {
+    ok: true;
+    v: 2;
+    outcome: "not_active";
 };
 export declare function parseHostedAdmission(value: unknown): HostedAdmission | undefined;
 export declare function parseHostedExecution(value: unknown): HostedExecution | undefined;
+export declare function parseHostedExecutionOutcome(value: unknown): HostedExecutionOutcome | undefined;
 /**
  * True when the admission envelope is the reserved internal reminder fire
  * path (not an authored channel event).

package/dist/internal/hosted-delivery-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-delivery-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery-protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hosted-delivery-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery-protocol.ts"],"names":[],"mappings":"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"}

package/dist/internal/hosted-delivery-protocol.js

@@ -107,6 +107,12 @@ export const HOSTED_REMINDER_CHANNEL_KIND = "agent-sdk:reminder";
  * Payload is {@link HostedReminderFirePayload}.
  */
 export const HOSTED_REMINDER_EVENT_TYPE = "agent-sdk.reminder/fire";
+/**
+ * Cap on delivery IDs an owner execute may report as consumed (primary +
+ * accepted active-guest enqueues). Enqueue requests beyond this return
+ * `not_active`.
+ */
+export const HOSTED_MAX_CONSUMED_DELIVERY_IDS = 16;
 const DELIVERY_KEYS = new Set([
     "v",
     "channelId",
@@ -127,7 +133,12 @@ const MANAGED_AUTOMATION_KEYS = new Set([
 const MANAGED_AUTOMATION_MAX_SERVERS = 64;
 /** More channels than the dashboard picker allows is a malformed envelope. */
 const MANAGED_AUTOMATION_MAX_SLACK_CHANNELS = 64;
-const EXECUTION_KEYS = new Set(["v", "admissionToken", "sessionPublicId"]);
+const EXECUTION_KEYS = new Set([
+    "v",
+    "admissionToken",
+    "sessionPublicId",
+    "mode",
+]);
 function boundedString(value, max) {
     return typeof value === "string" && value.length > 0 && value.length <= max;
 }
@@ -144,18 +155,18 @@ function parseManagedAutomation(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some((key) => !MANAGED_AUTOMATION_KEYS.has(key)) ||
+    if (Object.keys(body).some(key => !MANAGED_AUTOMATION_KEYS.has(key)) ||
         !boundedString(body.automationUuid, 128) ||
         !Array.isArray(body.mcpServerNames) ||
         body.mcpServerNames.length > MANAGED_AUTOMATION_MAX_SERVERS ||
-        !body.mcpServerNames.every((name) => boundedString(name, 256))) {
+        !body.mcpServerNames.every(name => boundedString(name, 256))) {
         return undefined;
     }
     if (body.slackChannels !== undefined) {
         if (!Array.isArray(body.slackChannels) ||
             body.slackChannels.length === 0 ||
             body.slackChannels.length > MANAGED_AUTOMATION_MAX_SLACK_CHANNELS ||
-            !body.slackChannels.every((channel) => boundedString(channel, 64))) {
+            !body.slackChannels.every(channel => boundedString(channel, 64))) {
             return undefined;
         }
     }
@@ -170,7 +181,7 @@ export function parseHostedAdmission(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some((key) => !DELIVERY_KEYS.has(key)) ||
+    if (Object.keys(body).some(key => !DELIVERY_KEYS.has(key)) ||
         !Object.hasOwn(body, "payload") ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
         !boundedString(body.channelId, 128) ||
@@ -192,15 +203,72 @@ export function parseHostedExecution(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some((key) => !EXECUTION_KEYS.has(key)) ||
+    if (Object.keys(body).some(key => !EXECUTION_KEYS.has(key)) ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
         !boundedString(body.admissionToken, 128) ||
         typeof body.sessionPublicId !== "string" ||
         !/^ses_[a-f0-9]{24}$/.test(body.sessionPublicId)) {
         return undefined;
     }
+    if (body.mode !== undefined &&
+        body.mode !== "execute" &&
+        body.mode !== "enqueue") {
+        return undefined;
+    }
     return body;
 }
+const HOSTED_EXECUTION_OUTCOME_KEYS = new Set([
+    "ok",
+    "v",
+    "outcome",
+    "consumedDeliveryIds",
+]);
+function parseConsumedDeliveryIds(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        return undefined;
+    }
+    if (value.length > HOSTED_MAX_CONSUMED_DELIVERY_IDS) {
+        return undefined;
+    }
+    if (!value.every(id => boundedString(id, 256))) {
+        return undefined;
+    }
+    return value;
+}
+export function parseHostedExecutionOutcome(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const body = value;
+    if (Object.keys(body).some(key => !HOSTED_EXECUTION_OUTCOME_KEYS.has(key)) ||
+        body.ok !== true ||
+        body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION) {
+        return undefined;
+    }
+    if (body.outcome === "enqueued" || body.outcome === "not_active") {
+        if (body.consumedDeliveryIds !== undefined) {
+            return undefined;
+        }
+        return body;
+    }
+    if (body.outcome !== "send") {
+        return undefined;
+    }
+    // Old guests omit consumedDeliveryIds; accept and let callers normalize.
+    if (body.consumedDeliveryIds === undefined) {
+        return { ok: true, v: 2, outcome: "send" };
+    }
+    const consumedDeliveryIds = parseConsumedDeliveryIds(body.consumedDeliveryIds);
+    if (consumedDeliveryIds === undefined) {
+        return undefined;
+    }
+    return {
+        ok: true,
+        v: 2,
+        outcome: "send",
+        consumedDeliveryIds,
+    };
+}
 /**
  * True when the admission envelope is the reserved internal reminder fire
  * path (not an authored channel event).
@@ -285,7 +353,7 @@ function isJsonSafeValue(value, depth) {
         return false;
     }
     if (Array.isArray(value)) {
-        return value.every((entry) => isJsonSafeValue(entry, depth + 1));
+        return value.every(entry => isJsonSafeValue(entry, depth + 1));
     }
     const proto = Object.getPrototypeOf(value);
     if (proto !== Object.prototype && proto !== null) {
@@ -335,7 +403,7 @@ export function parseHostedReminderFireDescriptorPayload(value) {
         return undefined;
     }
     const body = value;
-    if (Object.keys(body).some((key) => !HOSTED_REMINDER_FIRE_DESCRIPTOR_KEYS.has(key))) {
+    if (Object.keys(body).some(key => !HOSTED_REMINDER_FIRE_DESCRIPTOR_KEYS.has(key))) {
         return undefined;
     }
     if (body.protocolVersion !== 1 ||

package/dist/internal/hosted-delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hosted-delivery.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-delivery.ts"],"names":[],"mappings":"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"}