@cursor/bdk 0.2.6 → 0.2.8

package/dist/internal/session-run-log.js

@@ -1,22 +1,9 @@
 /**
- * Durable hosted-execution run log on the framework file store. **v2 only.**
+ * Durable execution history for hosted architecture-v2 sessions.
  *
- * One JSON document per factory session (`ses_…`), with per-execution
- * entries inside. The later customer UI is session-scoped ("why did this
- * session fail?") so a single GET is the read path; continuations are FIFO
- * so last-write-wins merge is safe. Guest-local `hosted-execution.json` and
- * factorydb `last_error` are lossy: the on-disk diag dies with the pod, and
- * the session row only keeps the first 1024 characters of a generic HTTP
- * 500.
- *
- * Process death: persist `running` at turn start so SIGKILL / OOM still
- * leaves a durable leftover. `uncaughtException` / SIGTERM flush the same
- * session key with `processDeath: true` and the real throw. Soft-fail on
- * persist so a store outage never changes the hosted-execution HTTP reply.
- *
- * Same flush moments as `hosted-execution.json` and the start.log tee —
- * see `hosted-execution-flush.ts`. Keys:
- * {@link agentSdkStorageKeys.sessionRun}.
+ * Entries are session-scoped and bounded. The host writes a running entry at
+ * turn start, then records completion or process failure. Persistence errors
+ * never change the hosted execution response.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -47,8 +34,8 @@ const MAX_DOCUMENT_CHARS = 512 * 1024;
 export const SESSION_RUN_FATAL_FLUSH_TIMEOUT_MS = 2000;
 let fatalFlush;
 /**
- * Install the crash-handler flush used by `bin/agent-serve` on
- * `uncaughtException`. One process, one active hosted serve.
+ * Install the process-level crash flush. One process has one active hosted
+ * server.
  */
 export function registerSessionRunFatalFlush(flush) {
     fatalFlush = flush;
@@ -249,7 +236,7 @@ export function createSessionRunLogStore(input) {
             return parseSessionRunLogDocument(JSON.parse(new TextDecoder().decode(decodeSinkBody(body))));
         }
         catch (error) {
-            logger(`[agent-sdk] session-run log: skip unreadable ${key} (${describeError(error)})`);
+            logger(`[bdk] session-run log: skip unreadable ${key} (${describeError(error)})`);
             return undefined;
         }
     });
@@ -261,7 +248,7 @@ export function createSessionRunLogStore(input) {
             existing = yield readDocument(write.sessionPublicId);
         }
         catch (error) {
-            logger(`[agent-sdk] session-run log: persist failed for ${fitted.executionId} (${describeError(error)})`);
+            logger(`[bdk] session-run log: persist failed for ${fitted.executionId} (${describeError(error)})`);
             return;
         }
         const executions = upsertExecution((_a = existing === null || existing === void 0 ? void 0 : existing.executions) !== null && _a !== void 0 ? _a : [], fitted);
@@ -276,7 +263,7 @@ export function createSessionRunLogStore(input) {
             yield sink.put(key, new TextEncoder().encode(JSON.stringify(document)));
         }
         catch (error) {
-            logger(`[agent-sdk] session-run log: persist failed for ${fitted.executionId} (${describeError(error)})`);
+            logger(`[bdk] session-run log: persist failed for ${fitted.executionId} (${describeError(error)})`);
             return;
         }
         if (fitted.turnStatus === "running") {
@@ -300,7 +287,7 @@ export function createSessionRunLogStore(input) {
                     return yield readDocument(sessionPublicId);
                 }
                 catch (error) {
-                    logger(`[agent-sdk] session-run log: read failed for ${sessionPublicId} (${describeError(error)})`);
+                    logger(`[bdk] session-run log: read failed for ${sessionPublicId} (${describeError(error)})`);
                     return undefined;
                 }
             });
@@ -325,10 +312,9 @@ export function createSessionRunLogStore(input) {
     };
 }
 /**
- * Same selection as the conversation mirror: architecture-v2 hosted
- * engines (generation env set). Store ids resolve lazily from env or the
- * task-bind files under `/run/cursor/secrets`. Self-hosted and v1 stay on
- * local disk / today's behavior.
+ * Enable durable execution history for architecture-v2 agents on
+ * Cursor-managed hosting. Self-hosted and architecture-v1 agents keep local
+ * behavior.
  */
 export function selectSessionRunLogStore(input) {
     const hosting = resolveAgentV2Hosting({

package/dist/internal/sessions-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessions-client.d.ts","sourceRoot":"","sources":["../../src/internal/sessions-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEpF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B5F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAmE1B;AAkCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,GAAG,SAAS,CAQ5B;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAIzE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACvC,MAAM,CAgBR"}
+{"version":3,"file":"sessions-client.d.ts","sourceRoot":"","sources":["../../src/internal/sessions-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEpF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B5F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAqE1B;AAkCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,GAAG,SAAS,CAQ5B;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAIzE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACvC,MAAM,CAgBR"}

package/dist/internal/sessions-client.js

@@ -53,9 +53,10 @@ 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`, {
@@ -76,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;
             }
@@ -104,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"}