@cursor/july 0.1.108 → 0.1.111

package/dist/internal/storage-coordinator.js

@@ -11,13 +11,12 @@
  * must never stall or fail a turn.
  *
  * Scaling shape: sessions reduce to keyed puts on the KV sink; eval runs
- * and A/B metrics go to their dedicated tables (`evals` / `abs`).
- * Reminder documents live on the control plane. Everything shares one
- * bounded, serialized queue.
+ * go to their dedicated `evals` table. Reminder documents live on the
+ * control plane. Everything shares one bounded, serialized queue.
  *
  * It does three unrelated jobs, declared separately as
  * {@link FrameworkSessionStore}, {@link AuthorKvStore}, and
- * {@link EvalAbStore} — see `storage-roles.ts` for why they differ and where
+ * {@link EvalStore} — see `storage-roles.ts` for why they differ and where
  * each is headed. The queue stays shared: it is one bounded, serialized chain
  * per agent, and splitting it would change backpressure behavior, which this
  * seam deliberately does not touch.
@@ -56,17 +55,13 @@ const MAX_PENDING_OPS = 1000;
 const CLOSE_DRAIN_TIMEOUT_MS = 10000;
 /** Debounced event batching flushes early past this many buffered events. */
 const DEBOUNCE_MAX_BATCH = 200;
-/**
- * Aggregate A/B snapshots are refreshed at most this often — the
- * playground polls `GET /v1/abs` every few seconds, and the snapshot is a
- * convenience backfill, not a source of truth.
- */
-const AB_SNAPSHOT_MIN_INTERVAL_MS = 60000;
+/** Cap on the per-session acked-record dedupe cache (oldest-out). */
+const MAX_ACKED_RECORDS = 5000;
 /** Session records out of raw sink entries; rows without a usable id are dropped. */
 function sessionRecordsOf(entries) {
     return entries
-        .map((entry) => entry.value)
-        .filter((record) => record != null &&
+        .map(entry => entry.value)
+        .filter(record => record != null &&
         typeof record.sessionId === "string" &&
         record.sessionId !== "");
 }
@@ -80,13 +75,21 @@ export class StorageCoordinator {
          * change emits a delete for the stale index entry alongside the new put.
          */
         this.continuationIndex = new Map();
+        /**
+         * Serialized form of the last session record each session **successfully**
+         * wrote, so a flush whose record is byte-identical skips the rewrite (the
+         * record rides every flush, changed or not). Keyed on acknowledged writes
+         * only: a failed write clears the entry, so at-most-once delivery never
+         * turns into never-delivered. Bounded; eviction only costs a redundant
+         * rewrite.
+         */
+        this.lastAckedRecordJson = new Map();
         /** Single delivery chain: writes reach the sink serialized, in order. */
         this.queue = Promise.resolve();
         /** Ops on the queue not yet delivered (bounded by MAX_PENDING_OPS). */
         this.pending = 0;
         /** Ops dropped because the queue was full. */
         this.dropped = 0;
-        this.lastAbSnapshotAt = 0;
         this.closed = false;
         this.definition = options.definition;
         this.keys = (_a = options.keys) !== null && _a !== void 0 ? _a : storageKeys;
@@ -155,18 +158,107 @@ export class StorageCoordinator {
             clearTimeout(buffer.debounceTimer);
         }
         const ops = [];
+        const puts = [];
         const first = buffer.events[0];
         if (first !== undefined) {
-            ops.push(this.putOp(this.keys.sessionEvents(this.agentName, sessionId, first.index), buffer.events));
+            puts.push({
+                key: this.keys.sessionEvents(this.agentName, sessionId, first.index),
+                value: buffer.events,
+            });
+        }
+        /** Set after the record write is acknowledged; undefined = no record write. */
+        let recordAck;
+        if (buffer.record !== undefined) {
+            const recordJson = JSON.stringify(buffer.record);
+            if (this.lastAckedRecordJson.get(sessionId) === recordJson) {
+                // Byte-identical to the last acknowledged write: rewriting it buys
+                // nothing. Events and continuation index still flush normally.
+            }
+            else {
+                puts.push({
+                    key: this.keys.session(this.agentName, sessionId),
+                    value: JSON.parse(recordJson),
+                });
+                recordAck = { sessionId, json: recordJson };
+            }
+        }
+        if (puts.length > 0) {
+            ops.push(this.putsOp(puts, recordAck));
         }
         if (buffer.record !== undefined) {
-            ops.push(this.putOp(this.keys.session(this.agentName, sessionId), buffer.record));
             ops.push(...this.continuationOps(buffer.record));
         }
         if (ops.length > 0) {
             this.enqueue(ops, reason);
         }
     }
+    /**
+     * 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 —
+     * logged and dropped (at-most-once), never failing batch siblings.
+     */
+    putsOp(puts, recordAck) {
+        var _a;
+        const recordKey = recordAck === undefined
+            ? undefined
+            : this.keys.session(this.agentName, recordAck.sessionId);
+        const settleRecord = (failed) => {
+            if (recordAck === undefined) {
+                return;
+            }
+            if (failed) {
+                this.lastAckedRecordJson.delete(recordAck.sessionId);
+                return;
+            }
+            if (this.lastAckedRecordJson.size >= MAX_ACKED_RECORDS) {
+                const oldest = this.lastAckedRecordJson.keys().next();
+                if (!oldest.done) {
+                    this.lastAckedRecordJson.delete(oldest.value);
+                }
+            }
+            this.lastAckedRecordJson.set(recordAck.sessionId, recordAck.json);
+        };
+        const putMany = (_a = this.definition.putMany) === null || _a === void 0 ? void 0 : _a.bind(this.definition);
+        if (putMany !== undefined) {
+            return {
+                label: `putMany(${puts.map(entry => entry.key).join(", ")})`,
+                run: (ctx) => __awaiter(this, void 0, void 0, function* () {
+                    const results = yield putMany(puts, ctx);
+                    let recordFailed = false;
+                    for (const result of results) {
+                        if (result.error === undefined) {
+                            continue;
+                        }
+                        if (result.key === recordKey) {
+                            recordFailed = true;
+                        }
+                        this.logger(`[agent-sdk] storage put(${result.key}) failed: ${describeError(result.error)}`);
+                    }
+                    settleRecord(recordFailed);
+                }),
+            };
+        }
+        return {
+            label: `put(${puts.map(entry => entry.key).join(", ")})`,
+            run: (ctx) => __awaiter(this, void 0, void 0, function* () {
+                let recordFailed = false;
+                for (const entry of puts) {
+                    try {
+                        yield this.definition.put(entry.key, entry.value, ctx);
+                    }
+                    catch (error) {
+                        if (entry.key === recordKey) {
+                            recordFailed = true;
+                        }
+                        this.logger(`[agent-sdk] storage put(${entry.key}) failed: ${describeError(error)}`);
+                    }
+                }
+                settleRecord(recordFailed);
+            }),
+        };
+    }
     /**
      * Index maintenance for `continuation/{channelId}/{token}` → sessionId:
      * put the current token, delete the previous one when it changed.
@@ -191,14 +283,14 @@ export class StorageCoordinator {
     putOp(key, value) {
         return {
             label: `put(${key})`,
-            run: (ctx) => this.definition.put(key, value, ctx),
+            run: ctx => this.definition.put(key, value, ctx),
         };
     }
     /** KV delete op on the sink's `delete` (skipped when the hook is absent). */
     deleteOp(key) {
         return {
             label: `delete(${key})`,
-            run: (ctx) => { var _a, _b; return (_b = (_a = this.definition).delete) === null || _b === void 0 ? void 0 : _b.call(_a, key, ctx); },
+            run: ctx => { var _a, _b; return (_b = (_a = this.definition).delete) === null || _b === void 0 ? void 0 : _b.call(_a, key, ctx); },
         };
     }
     // ==========================================================================
@@ -224,8 +316,8 @@ export class StorageCoordinator {
         return __awaiter(this, void 0, void 0, function* () {
             const entries = yield this.tryList(this.keys.sessionPrefix(this.agentName));
             return entries
-                .map((entry) => entry.value)
-                .filter((record) => record != null);
+                .map(entry => entry.value)
+                .filter(record => record != null);
         });
     }
     /**
@@ -416,7 +508,7 @@ export class StorageCoordinator {
                 this.enqueue([
                     {
                         label: `evals.put(${run.runId})`,
-                        run: (ctx) => table.put(snapshot, ctx),
+                        run: ctx => table.put(snapshot, ctx),
                     },
                 ], "policy");
             },
@@ -424,7 +516,7 @@ export class StorageCoordinator {
                 this.enqueue([
                     {
                         label: `evals.delete(${runId})`,
-                        run: (ctx) => table.delete(runId, ctx),
+                        run: ctx => table.delete(runId, ctx),
                     },
                 ], "policy");
             },
@@ -441,57 +533,6 @@ export class StorageCoordinator {
         };
     }
     // ==========================================================================
-    // A/Bs (dedicated `abs` table)
-    // ==========================================================================
-    /** Append one metric sample to the `abs` table (no-op without it). */
-    abSample(sample) {
-        const table = this.definition.abs;
-        if (this.closed || table === undefined) {
-            return;
-        }
-        this.enqueue([
-            {
-                label: `abs.putSample(${sample.sessionId})`,
-                run: (ctx) => table.putSample(sample, ctx),
-            },
-        ], "policy");
-    }
-    /**
-     * Refresh the persisted aggregate A/B snapshot, throttled to once per
-     * {@link AB_SNAPSHOT_MIN_INTERVAL_MS} (the playground recomputes the
-     * fold on every `GET /v1/abs` poll). No-op without `abs.putSnapshot`.
-     */
-    abSnapshot(snapshot) {
-        var _a;
-        const putSnapshot = (_a = this.definition.abs) === null || _a === void 0 ? void 0 : _a.putSnapshot;
-        const now = Date.now();
-        if (this.closed ||
-            putSnapshot === undefined ||
-            now - this.lastAbSnapshotAt < AB_SNAPSHOT_MIN_INTERVAL_MS) {
-            return;
-        }
-        this.lastAbSnapshotAt = now;
-        this.enqueue([{ label: "abs.putSnapshot", run: (ctx) => putSnapshot(snapshot, ctx) }], "policy");
-    }
-    /** Latest persisted aggregate A/B snapshot; errors read as absent. */
-    getLatestAbSnapshot() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            const getSnapshot = (_a = this.definition.abs) === null || _a === void 0 ? void 0 : _a.getSnapshot;
-            if (getSnapshot === undefined) {
-                return undefined;
-            }
-            try {
-                const value = yield getSnapshot(this.context("restore"));
-                return value !== null && value !== void 0 ? value : undefined;
-            }
-            catch (error) {
-                this.logger(`[agent-sdk] storage abs.getSnapshot() failed: ${describeError(error)}`);
-                return undefined;
-            }
-        });
-    }
-    // ==========================================================================
     // Delivery
     // ==========================================================================
     /**
@@ -510,7 +551,7 @@ export class StorageCoordinator {
             let timer;
             const drained = yield Promise.race([
                 this.queue.then(() => true),
-                new Promise((resolve) => {
+                new Promise(resolve => {
                     var _a;
                     timer = setTimeout(() => resolve(false), CLOSE_DRAIN_TIMEOUT_MS);
                     (_a = timer.unref) === null || _a === void 0 ? void 0 : _a.call(timer);

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

@@ -14,17 +14,15 @@
  * - {@link AuthorKvStore} is author state: whatever `ctx.host.kv` was handed.
  *   It converges onto the author file plane, which is a different destination
  *   from the one above.
- * - {@link EvalAbStore} is playground/experiment bookkeeping with its own
- *   dedicated tables, and follows neither.
+ * - {@link EvalStore} is playground eval bookkeeping with its own dedicated
+ *   table, and follows neither.
  *
  * Consumers should depend on the narrowest role they use. That is what keeps a
  * later change to framework persistence from silently reaching author KV, and
  * it is why these are interfaces rather than a comment on one class.
  */
-import type { ABMetricSample } from "../ab.js";
 import type { StorageContext } from "../storage.js";
 import type { JsonValue, SessionEvent, SessionRecord } from "../types.js";
-import type { ABSnapshot } from "./ab-snapshot.js";
 import type { EvalRunStorage } from "./eval-run-store.js";
 /**
  * Framework-owned session durability: what has to be true for a session to
@@ -73,11 +71,8 @@ export interface AuthorKvStore {
     kvPut(authorKey: string, value: JsonValue): Promise<void>;
     kvDelete(authorKey: string): Promise<void>;
 }
-/** Playground eval batches and live A/B metrics, on their own tables. */
-export interface EvalAbStore {
+/** Playground eval batches, on their own table. */
+export interface EvalStore {
     evalRuns(): EvalRunStorage | undefined;
-    abSample(sample: ABMetricSample): void;
-    abSnapshot(snapshot: ABSnapshot): void;
-    getLatestAbSnapshot(): Promise<ABSnapshot | undefined>;
 }
 //# sourceMappingURL=storage-roles.d.ts.map

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,UAAU,CAAC;AAC/C,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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,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,CACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC,CAAC;IACxC,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,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,QAAQ,IAAI,cAAc,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,mBAAmB,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CACxD"}
+{"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,CACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC,CAAC;IACxC,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/storage-roles.js

@@ -14,8 +14,8 @@
  * - {@link AuthorKvStore} is author state: whatever `ctx.host.kv` was handed.
  *   It converges onto the author file plane, which is a different destination
  *   from the one above.
- * - {@link EvalAbStore} is playground/experiment bookkeeping with its own
- *   dedicated tables, and follows neither.
+ * - {@link EvalStore} is playground eval bookkeeping with its own dedicated
+ *   table, and follows neither.
  *
  * Consumers should depend on the narrowest role they use. That is what keeps a
  * later change to framework persistence from silently reaching author KV, and

package/dist/internal/storage.d.ts

@@ -0,0 +1,2 @@
+export * from "../storage.js";
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/internal/storage.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/internal/storage.js

@@ -0,0 +1 @@
+export * from "../storage.js";

package/dist/internal/store-mirror.js

@@ -24,11 +24,11 @@ export function mirrorToStore(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         yield Promise.all([...args.desired].map(([key, body]) => putLastWriterWins(args.sink, key, body)));
-        const listed = yield Promise.all([args.prefix, ...((_a = args.legacyPrefixes) !== null && _a !== void 0 ? _a : [])].map((prefix) => args.sink.list(prefix)));
+        const listed = yield Promise.all([args.prefix, ...((_a = args.legacyPrefixes) !== null && _a !== void 0 ? _a : [])].map(prefix => args.sink.list(prefix)));
         yield Promise.all(listed
             .flat()
-            .filter((entry) => !args.desired.has(entry.key))
-            .map((entry) => args.sink.delete(entry.key)));
+            .filter(entry => !args.desired.has(entry.key))
+            .map(entry => args.sink.delete(entry.key)));
     });
 }
 /**
@@ -44,7 +44,7 @@ export function storeRelPath(relPath, what) {
         relPath.includes("\\") ||
         posix.isAbsolute(relPath) ||
         relPath.endsWith("/") ||
-        relPath.split("/").some((seg) => seg === ".." || seg === ".") ||
+        relPath.split("/").some(seg => seg === ".." || seg === ".") ||
         posix.normalize(relPath) !== relPath) {
         throw new Error(`Refusing ${what} path "${relPath}" (must be a normalized relative path)`);
     }

package/dist/internal/terminal-style.js

@@ -70,7 +70,7 @@ export function formatTerminalBox(lines, options) {
     var _a, _b, _c;
     const color = (_a = options === null || options === void 0 ? void 0 : options.color) !== null && _a !== void 0 ? _a : IDENTITY;
     const padding = (_b = options === null || options === void 0 ? void 0 : options.padding) !== null && _b !== void 0 ? _b : 1;
-    const contentWidth = Math.max((_c = options === null || options === void 0 ? void 0 : options.minWidth) !== null && _c !== void 0 ? _c : 0, ...lines.map((line) => visibleWidth(line)), 1);
+    const contentWidth = Math.max((_c = options === null || options === void 0 ? void 0 : options.minWidth) !== null && _c !== void 0 ? _c : 0, ...lines.map(line => visibleWidth(line)), 1);
     const inner = contentWidth + padding * 2;
     const padLine = (line) => {
         const extra = contentWidth - visibleWidth(line);
@@ -79,7 +79,7 @@ export function formatTerminalBox(lines, options) {
     const paint = (line) => color(line);
     const box = [
         paint(`╭${"─".repeat(inner)}╮`),
-        ...lines.map((line) => paint(padLine(line))),
+        ...lines.map(line => paint(padLine(line))),
         paint(`╰${"─".repeat(inner)}╯`),
     ].join("\n");
     return box;

package/dist/internal/tool-result.js

@@ -38,8 +38,8 @@ export function toolCallErrorMessage(result) {
         return undefined;
     }
     const texts = result.content
-        .filter((part) => part.type === "text" && typeof part.text === "string")
-        .map((part) => part.text.trim())
-        .filter((text) => text !== "");
+        .filter(part => part.type === "text" && typeof part.text === "string")
+        .map(part => part.text.trim())
+        .filter(text => text !== "");
     return texts.length === 0 ? undefined : texts.join("\n");
 }

package/dist/internal/trajectory.js

@@ -103,7 +103,7 @@ export function buildTrajectory(events) {
                     };
                     pendingCalls.set(call.callId, entry);
                     if (parentCallId !== undefined) {
-                        let sub = turn.subagents.find((s) => s.callId === parentCallId);
+                        let sub = turn.subagents.find(s => s.callId === parentCallId);
                         if (sub === undefined) {
                             sub = { callId: parentCallId, toolCalls: [] };
                             turn.subagents.push(sub);
@@ -154,7 +154,7 @@ export function buildTrajectory(events) {
                         parentCallId: event.data.parentCallId,
                     };
                     if (event.data.parentCallId !== undefined) {
-                        let sub = turn.subagents.find((s) => s.callId === event.data.parentCallId);
+                        let sub = turn.subagents.find(s => s.callId === event.data.parentCallId);
                         if (sub === undefined) {
                             sub = {
                                 callId: event.data.parentCallId,
@@ -173,7 +173,7 @@ export function buildTrajectory(events) {
             case "subagent.called": {
                 if (event.turnId !== undefined) {
                     const turn = ensureTurn(event.turnId);
-                    const existing = turn.subagents.find((s) => s.callId === event.data.callId);
+                    const existing = turn.subagents.find(s => s.callId === event.data.callId);
                     if (existing !== undefined) {
                         existing.name = event.data.name;
                         existing.description = event.data.description;
@@ -229,13 +229,13 @@ export function buildTrajectory(events) {
                 break;
         }
     }
-    const turns = turnOrder.map((id) => turnsById.get(id));
-    const turnsFailed = turns.filter((t) => t.failed).length;
+    const turns = turnOrder.map(id => turnsById.get(id));
+    const turnsFailed = turns.filter(t => t.failed).length;
     const toolCallCount = turns.reduce((n, t) => n +
         t.toolCalls.length +
         t.subagents.reduce((m, s) => m + s.toolCalls.length, 0), 0);
-    const lastGood = [...turns].reverse().find((t) => t.assistantText !== "");
-    const costedTurns = turns.filter((t) => t.cost !== undefined);
+    const lastGood = [...turns].reverse().find(t => t.assistantText !== "");
+    const costedTurns = turns.filter(t => t.cost !== undefined);
     const totalCostUsd = costedTurns.length === 0
         ? undefined
         : roundCostUsd(costedTurns.reduce((sum, t) => { var _a; var _b; return sum + ((_b = (_a = t.cost) === null || _a === void 0 ? void 0 : _a.totalUsd) !== null && _b !== void 0 ? _b : 0); }, 0));

package/dist/internal/turn-governor.js

@@ -52,11 +52,11 @@ export class TurnGovernor {
         if (((_a = args.signal) === null || _a === void 0 ? void 0 : _a.aborted) === true) {
             return Promise.resolve(undefined);
         }
-        return new Promise((resolve) => {
+        return new Promise(resolve => {
             var _a, _b;
             const waiter = {
                 sessionId: args.sessionId,
-                grant: (permit) => resolve(permit),
+                grant: permit => resolve(permit),
                 cancel: () => resolve(undefined),
                 cleanup: () => {
                     var _a;

package/dist/internal/turn-outbox.js

@@ -58,7 +58,7 @@ export class TurnOutbox {
                 return [];
             }
             const items = [];
-            for (const name of names.filter((n) => n.endsWith(".json")).sort()) {
+            for (const name of names.filter(n => n.endsWith(".json")).sort()) {
                 const path = join(dir, name);
                 try {
                     const raw = yield readFile(path, "utf8");

package/dist/internal/update-check.js

@@ -299,7 +299,7 @@ function findDependingProjectDir(packageRoot, packageName) {
             }
             const inNodeModules = dir
                 .split(sep)
-                .some((part) => part === "node_modules" || part === ".pnpm");
+                .some(part => part === "node_modules" || part === ".pnpm");
             if (!inNodeModules && (yield declaresDependency(dir, packageName))) {
                 return dir;
             }
@@ -424,7 +424,7 @@ function runUpdateCommand(command) {
             shell: process.platform === "win32",
         });
         child.on("error", reject);
-        child.on("close", (code) => {
+        child.on("close", code => {
             resolve(code !== null && code !== void 0 ? code : 1);
         });
     });

package/dist/internal/v2-hosting.d.ts

@@ -1,5 +1,12 @@
 import type { AgentArchitecture } from "../types.js";
 import { type CursorManagedV2StoreIds } from "./cursor/hosted-store-secrets.js";
+/**
+ * Exported (as `1`) by the control plane's start script for a version
+ * container of a persistent deployment. Its presence, not the agent's
+ * `persistent` flag, is what tells the runtime it owns a durable state
+ * directory.
+ */
+export declare const AGENT_SERVE_PERSISTENT_ENV_VAR = "AGENT_SERVE_PERSISTENT";
 export type AgentV2Hosting = {
     kind: "not-v2";
 } | {
@@ -7,6 +14,8 @@ export type AgentV2Hosting = {
 } | {
     kind: "cursor-managed";
     resolveStoreIds: () => CursorManagedV2StoreIds;
+} | {
+    kind: "cursor-managed-persistent";
 };
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.

package/dist/internal/v2-hosting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2-hosting.d.ts","sourceRoot":"","sources":["../../src/internal/v2-hosting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAG1C,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,CAAC;AAEN;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAYjB"}
+{"version":3,"file":"v2-hosting.d.ts","sourceRoot":"","sources":["../../src/internal/v2-hosting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAG1C;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AAEvE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,GACD;IACE,IAAI,EAAE,2BAA2B,CAAC;CACnC,CAAC;AAEN;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAejB"}

package/dist/internal/v2-hosting.js

@@ -1,5 +1,12 @@
 import { requireCursorManagedV2StoreIdsSync, } from "./cursor/hosted-store-secrets.js";
 import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
+/**
+ * Exported (as `1`) by the control plane's start script for a version
+ * container of a persistent deployment. Its presence, not the agent's
+ * `persistent` flag, is what tells the runtime it owns a durable state
+ * directory.
+ */
+export const AGENT_SERVE_PERSISTENT_ENV_VAR = "AGENT_SERVE_PERSISTENT";
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.
  *
@@ -16,6 +23,9 @@ export function resolveAgentV2Hosting(input) {
     if (env[AGENT_SERVE_GENERATION_ENV_VAR] === undefined) {
         return { kind: "self-hosted" };
     }
+    if (env[AGENT_SERVE_PERSISTENT_ENV_VAR] === "1") {
+        return { kind: "cursor-managed-persistent" };
+    }
     return {
         kind: "cursor-managed",
         resolveStoreIds: () => requireCursorManagedV2StoreIdsSync(env),

package/dist/internal/workspace.d.ts

@@ -1,10 +1,12 @@
 /**
  * Session workspace materialization. Each session gets its own working
- * directory that the Cursor harness treats as the project: instructions land
- * in `AGENTS.md`, skills land in `.cursor/skills/<name>/SKILL.md`,
- * agent-side tools land in `.agent-serve/tools/<name>.sh`, and
- * `agent/sandbox/workspace/**` seed files are mirrored in. The harness picks
- * all of this up natively through its project setting source.
+ * directory that the Cursor harness treats as the project: skills land in
+ * `.cursor/skills/<name>/SKILL.md`, agent-side tools land in
+ * `.agent-serve/tools/<name>.sh`, and `agent/sandbox/workspace/**` seed files
+ * are mirrored in. The harness picks all of this up natively through its
+ * project setting source. Instructions are not written here: local turns
+ * deliver them as the harness system prompt ({@link buildAgentsMdContent}),
+ * and cloud / grokbot harnesses never read the session workspace.
  */
 import type { DiscoveredSkill, DiscoveredTool, ResolvedAgent } from "../types.js";
 export interface MaterializeWorkspaceOptions {
@@ -89,11 +91,12 @@ export declare function buildServerToolsCatalog(tools: DiscoveredTool[], options
     mcpServerName: string;
 }): string;
 /**
- * The full AGENTS.md-equivalent context for an agent: instructions, identity
- * section, and the agent-side tool catalog. Written to the session workspace
- * as `AGENTS.md`, and inlined into the first turn's prompt when the harness
- * cannot discover that file (cloud runtime, or a local workspace the harness
- * will not treat as the project root — see {@link isNestedInGitRepo}).
+ * The full instructions context for an agent: instructions, identity
+ * section, and the agent-side tool catalog. Local turns send it as the
+ * harness system prompt (`AgentOptions.systemPrompt`, replacing Cursor's
+ * built-in prompt), grokbot turns carry it into the hosted session's system
+ * prompt, and cloud turns inline it into the first prompt because a cloud VM
+ * has no materialized workspace to read it from.
  *
  * `serverToolsMcpName` is cloud-only: when the turn's MCP config carries the
  * session-bound server-tool endpoint, the catalog names that server so the

package/dist/internal/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,CAOR;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAapB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC/D,MAAM,CA8CR;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACjC,MAAM,CA6BR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAkCf;AAqGD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CACX,MAAM,EACN,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CACjE,GACA,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,CAOR;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAapB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC/D,MAAM,CA8CR;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACjC,MAAM,CA6BR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAqGD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CACX,MAAM,EACN,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CACjE,GACA,OAAO,CAAC,IAAI,CAAC,CAcf"}