@cursor/bdk 0.2.5 → 0.2.7

package/dist/internal/sessions-client.js

@@ -53,13 +53,15 @@ export function listSessionsWithSource(args) {
 }
 export function fetchSessionEvents(args) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a;
+        var _a, _b;
+        var _c;
         const baseUrl = args.baseUrl.replace(/\/$/, "");
-        const fetchImpl = (_a = args.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
+        const fetchImpl = (_c = args.fetchImpl) !== null && _c !== void 0 ? _c : fetch;
         const path = `/v1/session/${encodeURIComponent(args.sessionId)}/events`;
         try {
             const jsonResp = yield fetchImpl(`${baseUrl}${path}?format=json`, {
                 headers: mergeRequestHeaders(args.auth),
+                signal: args.signal,
             });
             if (jsonResp.ok) {
                 const body = (yield jsonResp.json());
@@ -75,6 +77,7 @@ export function fetchSessionEvents(args) {
             }
         }
         catch (error) {
+            (_a = args.signal) === null || _a === void 0 ? void 0 : _a.throwIfAborted();
             if (error instanceof Error && error.message.startsWith("Session ")) {
                 throw error;
             }
@@ -83,6 +86,7 @@ export function fetchSessionEvents(args) {
         try {
             const resp = yield fetchImpl(`${baseUrl}${path}`, {
                 headers: mergeRequestHeaders(args.auth),
+                signal: args.signal,
             });
             if (resp.status === 404) {
                 throw new Error(`Session ${args.sessionId} not found.`);
@@ -102,13 +106,14 @@ export function fetchSessionEvents(args) {
                 try {
                     events.push(JSON.parse(line));
                 }
-                catch (_b) {
+                catch (_d) {
                     // skip malformed lines
                 }
             }
             return events;
         }
         catch (error) {
+            (_b = args.signal) === null || _b === void 0 ? void 0 : _b.throwIfAborted();
             if (error instanceof Error && error.message.startsWith("Session ")) {
                 throw error;
             }

package/dist/internal/skills-sync.d.ts

@@ -1,9 +1,7 @@
 /**
- * Sync authored skills onto an Agent Store so cloud-runtime turns discover
- * them natively. Hosted deployments write store-root `skills/<name>/…` (the
- * VM's `--agent-store-skills-dir /cursor/stores/deployment/skills`). Local
- * `serve`/`run` with `runtime: "cloud"` writes
- * `agent-serve/<agent>/skills/<name>/…` on the USER store.
+ * Sync authored skills to cloud-turn storage for native discovery. Managed
+ * deployments use deployment-scoped storage; local cloud turns use
+ * user-scoped storage namespaced by agent.
  */
 import { type FileSink } from "../files.js";
 import type { DiscoveredSkill } from "../types.js";

package/dist/internal/skills-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-sync.d.ts","sourceRoot":"","sources":["../../src/internal/skills-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,aAAa,CAAC;AASpE;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB"}
+{"version":3,"file":"skills-sync.d.ts","sourceRoot":"","sources":["../../src/internal/skills-sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,aAAa,CAAC;AASpE;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB"}

package/dist/internal/skills-sync.js

@@ -1,9 +1,7 @@
 /**
- * Sync authored skills onto an Agent Store so cloud-runtime turns discover
- * them natively. Hosted deployments write store-root `skills/<name>/…` (the
- * VM's `--agent-store-skills-dir /cursor/stores/deployment/skills`). Local
- * `serve`/`run` with `runtime: "cloud"` writes
- * `agent-serve/<agent>/skills/<name>/…` on the USER store.
+ * Sync authored skills to cloud-turn storage for native discovery. Managed
+ * deployments use deployment-scoped storage; local cloud turns use
+ * user-scoped storage namespaced by agent.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }

package/dist/internal/start-log-store.d.ts

@@ -1,25 +1,14 @@
 /**
- * Durable hosted `start.log` on the framework file store. **v2 only.**
+ * Durable process output for managed architecture-v2 agents.
  *
- * The engine tees stdout/stderr to a local file. That file is the v2
- * customer log (errors, traces, debug). It is NOT written to S3 per line:
- * callers snapshot the local buffer and PUT once. The Temporal host does
- * a last catch-up at the end of the delivery so the object is complete
- * after park/discard.
- *
- * Same flush moments as `hosted-execution.json` and session-runs —
- * see `hosted-execution-flush.ts`. Keys: {@link agentSdkStorageKeys.log}.
- * Values are raw UTF-8, not JSON.
+ * The host persists a bounded snapshot of stdout and stderr after masking
+ * credential tokens. Writes happen at flush boundaries rather than per line.
  */
 import type { FileSink } from "../files.js";
 import type { AgentProject } from "../types.js";
-/**
- * Last N bytes flushed to the store. Matches the Temporal catch-up cap
- * so guest snapshots and host catch-up stay interchangeable. The store
- * allows 64 MiB; this keeps the dashboard snapshot bounded.
- */
+/** Maximum bytes retained in each persisted output snapshot. */
 export declare const START_LOG_STORE_MAX_BYTES: number;
-/** Same path the hosted start command tees. Overridable in tests. */
+/** Default local output path. */
 export declare const DEFAULT_ENGINE_START_LOG_PATH = "/workspace/.agent-serve/start.log";
 export interface StartLogStore {
     persist(startLogId: string, contents: string): Promise<void>;
@@ -49,8 +38,8 @@ export declare function selectStartLogStore(input: {
     env?: Record<string, string | undefined>;
 }): StartLogStore | undefined;
 /**
- * Snapshot the local tee into the store. No-op when the file is missing
- * or empty. Soft-fail inside {@link StartLogStore.persist}.
+ * Flushes on one store run one at a time, each reading the tee when its turn
+ * comes, so a slow earlier put cannot land over a later, longer snapshot.
  */
 export declare function flushLocalStartLog(args: {
     store: StartLogStore;

package/dist/internal/start-log-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-log-store.d.ts","sourceRoot":"","sources":["../../src/internal/start-log-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAwB,CAAC;AAEjE,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,sCAAsC,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKtF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB9B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,aAAa,CA8BhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C,GAAG,aAAa,GAAG,SAAS,CAgB5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}
+{"version":3,"file":"start-log-store.d.ts","sourceRoot":"","sources":["../../src/internal/start-log-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,EAAE,MAAwB,CAAC;AAEjE,iCAAiC;AACjC,eAAO,MAAM,6BAA6B,sCAAsC,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AA0BD,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKtF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB9B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,aAAa,CAqChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C,GAAG,aAAa,GAAG,SAAS,CAgB5B;AAQD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAchB"}

package/dist/internal/start-log-store.js

@@ -1,15 +1,8 @@
 /**
- * Durable hosted `start.log` on the framework file store. **v2 only.**
+ * Durable process output for managed architecture-v2 agents.
  *
- * The engine tees stdout/stderr to a local file. That file is the v2
- * customer log (errors, traces, debug). It is NOT written to S3 per line:
- * callers snapshot the local buffer and PUT once. The Temporal host does
- * a last catch-up at the end of the delivery so the object is complete
- * after park/discard.
- *
- * Same flush moments as `hosted-execution.json` and session-runs —
- * see `hosted-execution-flush.ts`. Keys: {@link agentSdkStorageKeys.log}.
- * Values are raw UTF-8, not JSON.
+ * The host persists a bounded snapshot of stdout and stderr after masking
+ * credential tokens. Writes happen at flush boundaries rather than per line.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -26,13 +19,9 @@ import { agentSdkStorageKeys } from "../storage-protocol.js";
 import { resolveApiKeySync } from "./cursor/credentials.js";
 import { describeError } from "./describe-error.js";
 import { resolveAgentV2Hosting } from "./v2-hosting.js";
-/**
- * Last N bytes flushed to the store. Matches the Temporal catch-up cap
- * so guest snapshots and host catch-up stay interchangeable. The store
- * allows 64 MiB; this keeps the dashboard snapshot bounded.
- */
+/** Maximum bytes retained in each persisted output snapshot. */
 export const START_LOG_STORE_MAX_BYTES = 2 * 1024 * 1024;
-/** Same path the hosted start command tees. Overridable in tests. */
+/** Default local output path. */
 export const DEFAULT_ENGINE_START_LOG_PATH = "/workspace/.agent-serve/start.log";
 function decodeSinkBody(body) {
     return body instanceof Uint8Array ? body : body.body;
@@ -44,6 +33,26 @@ export function tailStartLogText(raw, maxBytes) {
     }
     return new TextDecoder().decode(encoded.subarray(encoded.byteLength - maxBytes));
 }
+/** Each character literally or percent-encoded, as tokens appear in URLs. */
+function encodable(text) {
+    return Array.from(text, char => {
+        const lower = char.charCodeAt(0).toString(16).padStart(2, "0");
+        const upper = char.toUpperCase().charCodeAt(0).toString(16).padStart(2, "0");
+        return lower === upper ? `(?:${char}|%${lower})` : `(?:${char}|%${lower}|%${upper})`;
+    }).join("");
+}
+const HEX = String.raw `(?:[a-f0-9]|%(?:3[0-9]|[46][1-6]))`;
+const TOKEN_MASKS = [
+    [new RegExp(`${encodable("grok_")}${HEX}{32}${encodable("_")}${HEX}{64}`, "gi"), "grok_…"],
+    [new RegExp(`${encodable("crsr_")}(?:[a-z0-9_-]|%[0-9a-f]{2})+`, "gi"), "crsr_…"],
+    [/\bghs_[A-Za-z0-9_]+\b/g, "ghs_…"],
+    [/\bgho_[A-Za-z0-9_]+\b/g, "gho_…"],
+    [/\bxox[baprs]-[A-Za-z0-9-]+\b/g, "xox…"],
+];
+/** Mask credential tokens before persisting a snapshot. */
+function maskStartLogTokens(text) {
+    return TOKEN_MASKS.reduce((masked, [pattern, mask]) => masked.replace(pattern, mask), text);
+}
 export function resolveEngineStartLogPath(env = process.env) {
     var _a;
     const configured = (_a = env.AGENT_SERVE_ENGINE_START_LOG_PATH) === null || _a === void 0 ? void 0 : _a.trim();
@@ -82,16 +91,23 @@ export function createStartLogStore(input) {
     var _a;
     const { sink, agentName } = input;
     const logger = (_a = input.logger) !== null && _a !== void 0 ? _a : (() => { });
+    // Flush moments often find the tee unchanged (a quiet turn, the claim then
+    // the stamp); skip a put that would store the same bytes again.
+    let stored;
     return {
         persist(startLogId, contents) {
             return __awaiter(this, void 0, void 0, function* () {
                 const key = agentSdkStorageKeys.log(agentName, startLogId);
-                const body = tailStartLogText(contents, START_LOG_STORE_MAX_BYTES);
+                const body = maskStartLogTokens(tailStartLogText(contents, START_LOG_STORE_MAX_BYTES));
+                if ((stored === null || stored === void 0 ? void 0 : stored.key) === key && stored.body === body) {
+                    return;
+                }
                 try {
                     yield sink.put(key, new TextEncoder().encode(body));
+                    stored = { key, body };
                 }
                 catch (error) {
-                    logger(`[agent-sdk] start-log: persist failed for ${startLogId} (${describeError(error)})`);
+                    logger(`[bdk] start-log: persist failed for ${startLogId} (${describeError(error)})`);
                 }
             });
         },
@@ -107,7 +123,7 @@ export function createStartLogStore(input) {
                     return text.length === 0 ? undefined : text;
                 }
                 catch (error) {
-                    logger(`[agent-sdk] start-log: read failed for ${startLogId} (${describeError(error)})`);
+                    logger(`[bdk] start-log: read failed for ${startLogId} (${describeError(error)})`);
                     return undefined;
                 }
             });
@@ -138,12 +154,19 @@ export function selectStartLogStore(input) {
  * Snapshot the local tee into the store. No-op when the file is missing
  * or empty. Soft-fail inside {@link StartLogStore.persist}.
  */
+const flushing = new WeakMap();
+/**
+ * Flushes on one store run one at a time, each reading the tee when its turn
+ * comes, so a slow earlier put cannot land over a later, longer snapshot.
+ */
 export function flushLocalStartLog(args) {
-    return __awaiter(this, void 0, void 0, function* () {
+    var _a;
+    const run = ((_a = flushing.get(args.store)) !== null && _a !== void 0 ? _a : Promise.resolve()).then(() => __awaiter(this, void 0, void 0, function* () {
         const contents = yield readLocalStartLogText(args.path === undefined ? undefined : { path: args.path });
-        if (contents === undefined) {
-            return;
+        if (contents !== undefined) {
+            yield args.store.persist(args.startLogId, contents);
         }
-        yield args.store.persist(args.startLogId, contents);
-    });
+    }));
+    flushing.set(args.store, run.catch(() => undefined));
+    return run;
 }

package/dist/internal/storage-coordinator.d.ts

@@ -10,9 +10,7 @@
  * failures — a throwing sink is logged and its write dropped; storage
  * must never stall or fail a turn.
  *
- * Scaling shape: sessions reduce to keyed puts on the KV sink; eval runs
- * go to their dedicated `evals` table. Reminder documents live on the
- * control plane. Everything shares one bounded, serialized queue.
+ * Session and eval writes share one bounded, serialized queue.
  *
  * It does three unrelated jobs, declared separately as
  * {@link FrameworkSessionStore}, {@link AuthorKvStore}, and
@@ -95,12 +93,12 @@ export declare class StorageCoordinator implements FrameworkSessionStore, Author
     eventDispatched(event: SessionEvent): void;
     /** Flush everything buffered for one session (ordered: events, record). */
     flushSession(sessionId: string, reason?: StorageContext["reason"]): void;
+    flushSessionExact(sessionId: string): void;
     private flushSessionInternal;
     /**
      * One queued op covering every put of a flush. When the sink offers
-     * `putMany`, the whole flush is one backend round trip (on the hosted
-     * file store: one presign call instead of one per key); otherwise the
-     * puts run sequentially, exactly as before. Failures stay per-key —
+     * `putMany`, the whole flush is one backend round trip; otherwise the
+     * puts run sequentially. Failures stay per-key,
      * logged and dropped (at-most-once), never failing batch siblings.
      */
     private putsOp;
@@ -116,8 +114,8 @@ export declare class StorageCoordinator implements FrameworkSessionStore, Author
     /** Whether the sink can serve the startup bulk restore (`list`). */
     get canBulkRestore(): boolean;
     /**
-     * True when the authored sink is `cursorHostedStorage` (Bugbot via the
-     * control-plane proxy). `GET /v1/sessions` prefers this durable list.
+     * True when the configured sink uses Cursor-managed durable storage.
+     * `GET /v1/sessions` prefers this durable list.
      */
     get isCursorHosted(): boolean;
     /**
@@ -187,8 +185,7 @@ export declare class StorageCoordinator implements FrameworkSessionStore, Author
     evalRuns(): EvalRunStorage | undefined;
     /**
      * Flush all buffers and drain the queue, giving the sink at most
-     * {@link CLOSE_DRAIN_TIMEOUT_MS} — a hung sink must not stall shutdown
-     * past the pod grace period. Called from engine close.
+     * {@link CLOSE_DRAIN_TIMEOUT_MS}. Called from engine close.
      */
     close(): Promise<void>;
     /** Pending deliveries (exposed for tests and drain instrumentation). */

package/dist/internal/storage-coordinator.d.ts.map

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

package/dist/internal/storage-coordinator.js

@@ -10,9 +10,7 @@
  * failures — a throwing sink is logged and its write dropped; storage
  * must never stall or fail a turn.
  *
- * Scaling shape: sessions reduce to keyed puts on the KV sink; eval runs
- * go to their dedicated `evals` table. Reminder documents live on the
- * control plane. Everything shares one bounded, serialized queue.
+ * Session and eval writes share one bounded, serialized queue.
  *
  * It does three unrelated jobs, declared separately as
  * {@link FrameworkSessionStore}, {@link AuthorKvStore}, and
@@ -57,8 +55,7 @@ const TERMINAL_SESSION_EVENTS = new Set([
 const MAX_PENDING_OPS = 1000;
 /**
  * How long {@link StorageCoordinator.close} waits for the sink to
- * drain before giving up. Keeps a hung sink from stalling shutdown past
- * the pod grace period (where a SIGKILL would lose the flush anyway).
+ * drain before giving up. Keeps a hung sink within the shutdown budget.
  */
 const CLOSE_DRAIN_TIMEOUT_MS = 10000;
 /** Debounced event batching flushes early past this many buffered events. */
@@ -182,6 +179,9 @@ export class StorageCoordinator {
         // volatile-only diff.
         this.flushSessionInternal(sessionId, reason, reason !== "policy");
     }
+    flushSessionExact(sessionId) {
+        this.flushSessionInternal(sessionId, "policy", true);
+    }
     flushSessionInternal(sessionId, reason, exactRecord) {
         var _a, _b;
         const buffer = this.buffers.get(sessionId);
@@ -253,9 +253,8 @@ export class StorageCoordinator {
     }
     /**
      * One queued op covering every put of a flush. When the sink offers
-     * `putMany`, the whole flush is one backend round trip (on the hosted
-     * file store: one presign call instead of one per key); otherwise the
-     * puts run sequentially, exactly as before. Failures stay per-key —
+     * `putMany`, the whole flush is one backend round trip; otherwise the
+     * puts run sequentially. Failures stay per-key,
      * logged and dropped (at-most-once), never failing batch siblings.
      */
     putsOp(puts, recordAck) {
@@ -295,7 +294,7 @@ export class StorageCoordinator {
                         if (result.key === recordKey) {
                             recordFailed = true;
                         }
-                        this.logger(`[agent-sdk] storage put(${result.key}) failed: ${describeError(result.error)}`);
+                        this.logger(`[bdk] storage put(${result.key}) failed: ${describeError(result.error)}`);
                     }
                     settleRecord(recordFailed);
                 }),
@@ -313,7 +312,7 @@ export class StorageCoordinator {
                         if (entry.key === recordKey) {
                             recordFailed = true;
                         }
-                        this.logger(`[agent-sdk] storage put(${entry.key}) failed: ${describeError(error)}`);
+                        this.logger(`[bdk] storage put(${entry.key}) failed: ${describeError(error)}`);
                     }
                 }
                 settleRecord(recordFailed);
@@ -364,8 +363,8 @@ export class StorageCoordinator {
         return this.definition.list !== undefined;
     }
     /**
-     * True when the authored sink is `cursorHostedStorage` (Bugbot via the
-     * control-plane proxy). `GET /v1/sessions` prefers this durable list.
+     * True when the configured sink uses Cursor-managed durable storage.
+     * `GET /v1/sessions` prefers this durable list.
      */
     get isCursorHosted() {
         return isCursorHostedStorage(this.definition);
@@ -492,7 +491,7 @@ export class StorageCoordinator {
                 // Index entry without its record (e.g. the record write was shed
                 // under at-most-once). The session is unrecoverable; treat as a miss
                 // so the conversation can continue rather than failing forever.
-                this.logger(`[agent-sdk] storage continuation entry points at missing session ${sessionId}; treating as a miss`);
+                this.logger(`[bdk] storage continuation entry points at missing session ${sessionId}; treating as a miss`);
                 return undefined;
             }
             // The sink must answer for the exact key it was asked about — a
@@ -586,7 +585,7 @@ export class StorageCoordinator {
                     return Array.isArray(runs) ? runs : [];
                 }
                 catch (error) {
-                    this.logger(`[agent-sdk] storage evals.list() failed: ${describeError(error)}`);
+                    this.logger(`[bdk] storage evals.list() failed: ${describeError(error)}`);
                     return [];
                 }
             }),
@@ -597,8 +596,7 @@ export class StorageCoordinator {
     // ==========================================================================
     /**
      * Flush all buffers and drain the queue, giving the sink at most
-     * {@link CLOSE_DRAIN_TIMEOUT_MS} — a hung sink must not stall shutdown
-     * past the pod grace period. Called from engine close.
+     * {@link CLOSE_DRAIN_TIMEOUT_MS}. Called from engine close.
      */
     close() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -627,7 +625,7 @@ export class StorageCoordinator {
             ]);
             clearTimeout(timer);
             if (!drained) {
-                this.logger(`[agent-sdk] storage shutdown drain timed out after ${CLOSE_DRAIN_TIMEOUT_MS}ms with ${this.pending} write(s) undelivered`);
+                this.logger(`[bdk] storage shutdown drain timed out after ${CLOSE_DRAIN_TIMEOUT_MS}ms with ${this.pending} write(s) undelivered`);
             }
         });
     }
@@ -667,7 +665,7 @@ export class StorageCoordinator {
                 return Array.isArray(entries) ? entries : [];
             }
             catch (error) {
-                this.logger(`[agent-sdk] storage list(${prefix}) failed: ${describeError(error)}`);
+                this.logger(`[bdk] storage list(${prefix}) failed: ${describeError(error)}`);
                 return [];
             }
         });
@@ -679,7 +677,7 @@ export class StorageCoordinator {
         if (this.pending + ops.length > MAX_PENDING_OPS) {
             this.dropped += ops.length;
             if (this.dropped <= ops.length || this.dropped % 1000 < ops.length) {
-                this.logger(`[agent-sdk] storage queue full (${MAX_PENDING_OPS} pending writes); dropped ${this.dropped} write(s) so far — the sink is too slow for the traffic`);
+                this.logger(`[bdk] storage queue full (${MAX_PENDING_OPS} pending writes); dropped ${this.dropped} write(s) so far — the sink is too slow for the traffic`);
             }
             return;
         }
@@ -691,7 +689,7 @@ export class StorageCoordinator {
                     yield op.run(ctx);
                 }
                 catch (error) {
-                    this.logger(`[agent-sdk] storage ${op.label} failed: ${describeError(error)}`);
+                    this.logger(`[bdk] storage ${op.label} failed: ${describeError(error)}`);
                 }
                 finally {
                     this.pending -= 1;

package/dist/internal/storage-roles.d.ts

@@ -42,6 +42,11 @@ export interface FrameworkSessionStore {
     eventDispatched(event: SessionEvent): void;
     /** Flush everything buffered for one session (ordered: events, record). */
     flushSession(sessionId: string, reason?: StorageContext["reason"]): void;
+    /**
+     * {@link flushSession} that writes the exact record, repairing volatile-only
+     * skips. For a lifecycle edge the process may not outlive.
+     */
+    flushSessionExact(sessionId: string): void;
     /** True when the backend can list every session in one bulk read. */
     readonly canBulkRestore: boolean;
     /** True when the backend is the Cursor-hosted one rather than an authored sink. */

package/dist/internal/storage-roles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-roles.d.ts","sourceRoot":"","sources":["../../src/internal/storage-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3C,uEAAuE;IACvE,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,kEAAkE;IAClE,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,2EAA2E;IAC3E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAEzE,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzC,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjD;;;OAGG;IACH,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC,CAAC;IAChF,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IACtE,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACzD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,QAAQ,IAAI,cAAc,GAAG,SAAS,CAAC;CACxC"}
+{"version":3,"file":"storage-roles.d.ts","sourceRoot":"","sources":["../../src/internal/storage-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3C,uEAAuE;IACvE,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,kEAAkE;IAClE,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,2EAA2E;IAC3E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACzE;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3C,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzC,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjD;;;OAGG;IACH,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC,CAAC;IAChF,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IACtE,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACzD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,QAAQ,IAAI,cAAc,GAAG,SAAS,CAAC;CACxC"}

package/dist/internal/store-api-protocol.d.ts

@@ -1,19 +1,5 @@
 /**
- * Domain-call wire contract for the factory store API:
- * `POST /internal/agentsdk/store/api/<call>` carrying a versioned JSON
- * envelope `{ v, call, payload }`. This is the lane where the **server** owns
- * the storage pattern (journal sharding, rotation, compaction), so a
- * pathological pattern is fixable in a backend deploy instead of a July
- * release plus a rebake of every deployment. The verb lane (`/flush`,
- * `/read`, `/list`) keeps carrying bulk presigned file IO.
- *
- * Deliberately duplicated on the backend
- * (`backend/server/src/factory/agent-sdk/agentsdkStoreApiProtocol.ts`): this
- * package is published to npm, so the backend cannot depend on it and it
- * cannot depend on backend packages. A backend drift test compares the two
- * sources — same shape as the hosted-delivery protocol twins — which is why
- * every exported constant here stays a single `export const NAME = <literal>;`
- * line and every schema field stays on its own line.
+ * Versioned wire contract for Cursor-managed store operations.
  *
  * Evolution rules (the compat contract): additive optional fields only; no
  * renames, no retypes, no semantic reuse of an old field; unknown fields are
@@ -23,26 +9,23 @@
  */
 import { z } from "zod";
 export declare const STORE_API_PROTOCOL_VERSION = 1;
-/** Path family on the factory surface; one segment per call. */
+/** Managed storage endpoint, with one trailing segment per call. */
 export declare const STORE_API_PATH = "/internal/agentsdk/store/api";
 export declare const STORE_API_MEMORY_APPEND_CALL = "memory.append";
 /**
  * Semantic cap on one serialized memory record. Text fields are truncated
  * client-side (`memoryHook` default 2000 chars per field), so a well-formed
  * record is a few KiB; 16 KiB is generous headroom, not a target. The cap is
- * part of the wire contract but rides the layers, not the schema: the
- * backend's store controller enforces it as a typed 4xx, and the store API
- * client (`cursor/store-api-client.ts`) pre-checks it before spending a
- * doomed request.
+ * part of the wire contract but not the schema. The service enforces it as a
+ * typed 4xx, and the client checks it before sending a request.
  */
 export declare const MEMORY_APPEND_MAX_RECORD_BYTES: number;
 /** Serialized size of a record, as counted against the byte cap. */
 export declare function serializedRecordBytes(record: unknown): number;
 /**
- * One turn's memory record as it crosses the wire — July's
- * `TurnMemoryRecord` (memory.ts). The extra-key record mirrors the schema's
- * `.passthrough()`: a newer client's additive optional fields are journaled
- * verbatim rather than stripped by an older server.
+ * One turn's memory record as it crosses the wire. The extra-key record
+ * mirrors the schema's `.passthrough()`: a newer client's additive optional
+ * fields are journaled verbatim rather than stripped by an older server.
  */
 export type TurnMemoryRecordWire = {
     at: string;
@@ -69,8 +52,8 @@ export type MemoryAppendPayload = {
 /**
  * `memory.append` payload shape. The agent name becomes a store key segment
  * on the server, so it must be exactly one segment. Unknown payload fields
- * are stripped (= ignored), per the evolution rules. The byte cap is
- * semantics, not shape — the backend's store controller owns it.
+ * are stripped (= ignored), per the evolution rules. The service owns the
+ * byte cap because it is a semantic limit rather than part of the shape.
  */
 export declare const memoryAppendPayloadSchema: z.ZodType<MemoryAppendPayload>;
 /** The versioned request body for the `memory.append` call. */
@@ -110,13 +93,9 @@ export type MemoryReadEnvelope = {
 /** The whole request body. Unknown envelope fields are stripped (= ignored). */
 export declare const memoryReadEnvelopeSchema: z.ZodType<MemoryReadEnvelope>;
 /**
- * `memory.read` success body. The call is flush-on-read: the server drains
- * the agent's pending append buffer before presigning. Best-effort: when
- * the drain succeeds the journal includes every append that preceded the
- * read; a busy flush lock, a buffer outage, or an oversized backlog
- * degrades to the already-flushed state (callers must not regress their
- * local view on a shorter download). `journal` is null while the agent has
- * no journal at all.
+ * `memory.read` success body. The snapshot is best-effort and may lag
+ * accepted appends, so callers retain a longer local view. `journal` is null
+ * while the agent has no journal.
  */
 export type MemoryReadResponse = {
     v: typeof STORE_API_PROTOCOL_VERSION;

package/dist/internal/store-api-protocol.d.ts.map

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

package/dist/internal/store-api-protocol.js

@@ -1,19 +1,5 @@
 /**
- * Domain-call wire contract for the factory store API:
- * `POST /internal/agentsdk/store/api/<call>` carrying a versioned JSON
- * envelope `{ v, call, payload }`. This is the lane where the **server** owns
- * the storage pattern (journal sharding, rotation, compaction), so a
- * pathological pattern is fixable in a backend deploy instead of a July
- * release plus a rebake of every deployment. The verb lane (`/flush`,
- * `/read`, `/list`) keeps carrying bulk presigned file IO.
- *
- * Deliberately duplicated on the backend
- * (`backend/server/src/factory/agent-sdk/agentsdkStoreApiProtocol.ts`): this
- * package is published to npm, so the backend cannot depend on it and it
- * cannot depend on backend packages. A backend drift test compares the two
- * sources — same shape as the hosted-delivery protocol twins — which is why
- * every exported constant here stays a single `export const NAME = <literal>;`
- * line and every schema field stays on its own line.
+ * Versioned wire contract for Cursor-managed store operations.
  *
  * Evolution rules (the compat contract): additive optional fields only; no
  * renames, no retypes, no semantic reuse of an old field; unknown fields are
@@ -23,17 +9,15 @@
  */
 import { z } from "zod";
 export const STORE_API_PROTOCOL_VERSION = 1;
-/** Path family on the factory surface; one segment per call. */
+/** Managed storage endpoint, with one trailing segment per call. */
 export const STORE_API_PATH = "/internal/agentsdk/store/api";
 export const STORE_API_MEMORY_APPEND_CALL = "memory.append";
 /**
  * Semantic cap on one serialized memory record. Text fields are truncated
  * client-side (`memoryHook` default 2000 chars per field), so a well-formed
  * record is a few KiB; 16 KiB is generous headroom, not a target. The cap is
- * part of the wire contract but rides the layers, not the schema: the
- * backend's store controller enforces it as a typed 4xx, and the store API
- * client (`cursor/store-api-client.ts`) pre-checks it before spending a
- * doomed request.
+ * part of the wire contract but not the schema. The service enforces it as a
+ * typed 4xx, and the client checks it before sending a request.
  */
 export const MEMORY_APPEND_MAX_RECORD_BYTES = 16 * 1024;
 /** Serialized size of a record, as counted against the byte cap. */
@@ -61,8 +45,8 @@ export const turnMemoryRecordWireSchema = z
 /**
  * `memory.append` payload shape. The agent name becomes a store key segment
  * on the server, so it must be exactly one segment. Unknown payload fields
- * are stripped (= ignored), per the evolution rules. The byte cap is
- * semantics, not shape — the backend's store controller owns it.
+ * are stripped (= ignored), per the evolution rules. The service owns the
+ * byte cap because it is a semantic limit rather than part of the shape.
  */
 export const memoryAppendPayloadSchema = z.object({
     agent: z