@cursor/july 0.1.16 → 0.1.18

package/dist/internal/local-env.js

@@ -0,0 +1,47 @@
+/**
+ * Loads an agent directory's `.env.local` (and each immediate child's,
+ * for multi-agent hosts) into process.env. Real env always wins —
+ * `process.loadEnvFile` never overrides. Values a previous call loaded are
+ * refreshed, so a reload picks up edits made since.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+// Not real env, so a reload has to clear them first: loadEnvFile skips
+// anything already in process.env, which would pin the first-boot values.
+let fileLoadedKeys = new Set();
+export function loadAgentLocalEnv(dir) {
+    for (const key of fileLoadedKeys) {
+        delete process.env[key];
+    }
+    const realKeys = new Set(Object.keys(process.env));
+    const loaded = [];
+    const tryLoad = (path) => {
+        if (!existsSync(path)) {
+            return;
+        }
+        process.loadEnvFile(path);
+        loaded.push(path);
+    };
+    const trackLoadedKeys = () => {
+        fileLoadedKeys = new Set(Object.keys(process.env).filter((key) => !realKeys.has(key)));
+    };
+    tryLoad(join(dir, ".env.local"));
+    let children;
+    try {
+        children = readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() && !entry.name.startsWith("."))
+            .map((entry) => entry.name);
+    }
+    catch (_a) {
+        trackLoadedKeys();
+        return loaded;
+    }
+    for (const child of children) {
+        if (child === "node_modules") {
+            continue;
+        }
+        tryLoad(join(dir, child, ".env.local"));
+    }
+    trackLoadedKeys();
+    return loaded;
+}

package/dist/internal/playground/static.d.ts

@@ -18,6 +18,9 @@ export declare function playgroundBundleExists(): boolean;
  * The SPA `index.html` with a `<base href>` injected so its relative asset
  * URLs resolve under the mount point (`/playground/` or `/<slug>/playground/`).
  * Falls back to a helpful placeholder page when the bundle is missing.
+ * The hosted alias performs the same injection for its central copy
+ * (`backend/server/src/agentServe/aliasPlaygroundShell.ts`) — keep them
+ * behaviorally aligned.
  */
 export declare function renderPlaygroundIndexHtml(baseHref: string): string;
 /** Serve one built asset from `dist/playground/assets/` by filename. */

package/dist/internal/playground/static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../src/internal/playground/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiBvD,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAsB5D;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAiBvE"}
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../src/internal/playground/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiBvD,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAsB5D;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAiBvE"}

package/dist/internal/playground/static.js

@@ -45,6 +45,9 @@ export function playgroundBundleExists() {
  * The SPA `index.html` with a `<base href>` injected so its relative asset
  * URLs resolve under the mount point (`/playground/` or `/<slug>/playground/`).
  * Falls back to a helpful placeholder page when the bundle is missing.
+ * The hosted alias performs the same injection for its central copy
+ * (`backend/server/src/agentServe/aliasPlaygroundShell.ts`) — keep them
+ * behaviorally aligned.
  */
 export function renderPlaygroundIndexHtml(baseHref) {
     if (!playgroundBundleExists()) {

package/dist/internal/reminder-runner.d.ts

@@ -42,6 +42,13 @@ export declare class ReminderRunner {
     cancel(id: string, reason?: string): Promise<ReminderInfo | undefined>;
     /** Cancel all armed reminders matching a continuation token (e.g. PR closed). */
     cancelForContinuation(continuationToken: string, reason: string): Promise<number>;
+    /**
+     * Re-key armed reminders when a channel rotates a session's continuation
+     * token (the built-in HTTP channel rotates after every follow-up). Without
+     * this, a reminder armed before the rotation misses its session at fire
+     * time and disarms as `session_gone`.
+     */
+    rekeyContinuation(channelId: string, oldToken: string, newToken: string): Promise<number>;
     /** Fire one reminder immediately (dev / hillclimb). */
     dispatch(reminderId: string): Promise<{
         reminderId: string;

package/dist/internal/reminder-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAGnB,YAAY,EAEb,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAyDD,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAG3D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B3B;IAED;;;OAGG;YACW,kBAAkB;IA6BhC,8EAA8E;YAChE,OAAO;IAKrB,IAAI,IAAI,IAAI,CAOX;IAEK,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9D;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B1B;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,SAAoB,GACzB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAED,iFAAiF;IAC3E,qBAAqB,CACzB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAQD;IAED,OAAO,CAAC,QAAQ;IA4ChB,OAAO,CAAC,UAAU;YAQJ,IAAI;YA6GJ,aAAa;IAY3B,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;YACW,mBAAmB;YAcnB,aAAa;YAcb,YAAY;IA0C1B,OAAO,CAAC,gBAAgB;IAyDxB,OAAO,CAAC,iBAAiB;YAeX,MAAM;YAYN,SAAS;CAoFxB;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAGnB,YAAY,EAEb,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAyDD,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAG3D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B3B;IAED;;;OAGG;YACW,kBAAkB;IA6BhC,8EAA8E;YAChE,OAAO;IAKrB,IAAI,IAAI,IAAI,CAOX;IAEK,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9D;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B1B;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,SAAoB,GACzB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAED,iFAAiF;IAC3E,qBAAqB,CACzB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED;;;;;OAKG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAkBjB;IAED,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAQD;IAED,OAAO,CAAC,QAAQ;IA4ChB,OAAO,CAAC,UAAU;YAQJ,IAAI;YA6GJ,aAAa;IAY3B,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;YACW,mBAAmB;YAcnB,aAAa;YAcb,YAAY;IA0C1B,OAAO,CAAC,gBAAgB;IAyDxB,OAAO,CAAC,iBAAiB;YAeX,MAAM;YAYN,SAAS;CAoFxB;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/internal/reminder-runner.js

@@ -279,6 +279,27 @@ export class ReminderRunner {
             return n;
         });
     }
+    /**
+     * Re-key armed reminders when a channel rotates a session's continuation
+     * token (the built-in HTTP channel rotates after every follow-up). Without
+     * this, a reminder armed before the rotation misses its session at fire
+     * time and disarms as `session_gone`.
+     */
+    rekeyContinuation(channelId, oldToken, newToken) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const armed = yield this.store.listArmed();
+            let n = 0;
+            for (const record of armed) {
+                if (record.channelId !== channelId ||
+                    record.continuationToken !== oldToken) {
+                    continue;
+                }
+                yield this.persist(Object.assign(Object.assign({}, record), { continuationToken: newToken, updatedAt: new Date().toISOString() }));
+                n += 1;
+            }
+            return n;
+        });
+    }
     /** Fire one reminder immediately (dev / hillclimb). */
     dispatch(reminderId) {
         return __awaiter(this, void 0, void 0, function* () {

package/dist/internal/run-client.d.ts

@@ -34,6 +34,11 @@ export interface RunSessionResult {
     events: SessionEvent[];
     trajectory: Trajectory;
     ok: boolean;
+    /**
+     * Index to pass as `startIndex` on the next call for this session. Undefined
+     * when the turn streamed nothing, in which case reuse the previous value.
+     */
+    nextEventIndex?: number;
 }
 /**
  * Run one or more messages against a live agent-serve base URL
@@ -43,6 +48,16 @@ export declare function runSession(options: RunClientOptions & {
     messages: string[];
     sessionId?: string;
     continuationToken?: string;
+    /**
+     * First event index to read when resuming an existing session.
+     *
+     * The stream replays from `startIndex` and this client stops at the first
+     * terminal event, so a caller that sends several turns across separate
+     * `runSession` calls **must** pass the index after its last consumed event
+     * (see {@link RunSessionResult.nextEventIndex}). Omitting it replays the
+     * earlier turn and returns those stale events instead of the new turn's.
+     */
+    startIndex?: number;
     /** Applied only when creating a new session (first message). */
     workspaceDir?: string;
     /** Applied only when creating a new session (first message). */

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

@@ -1 +1 @@
-{"version":3,"file":"run-client.d.ts","sourceRoot":"","sources":["../../src/internal/run-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAF5B,YACE,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM,EAI3B;CACF;AACD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;CACb;AAQD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,GAAG;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gEAAgE;IAChE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,GACA,OAAO,CAAC,gBAAgB,CAAC,CAyD3B"}
+{"version":3,"file":"run-client.d.ts","sourceRoot":"","sources":["../../src/internal/run-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAF5B,YACE,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM,EAI3B;CACF;AACD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,GAAG;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gEAAgE;IAChE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,GACA,OAAO,CAAC,gBAAgB,CAAC,CA0D3B"}

package/dist/internal/run-client.js

@@ -35,6 +35,7 @@ const TERMINAL_TYPES = new Set([
  */
 export function runSession(options) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
         if (options.messages.length === 0) {
             throw new Error("runSession requires at least one message");
         }
@@ -42,7 +43,7 @@ export function runSession(options) {
         let sessionId = options.sessionId;
         let continuationToken = options.continuationToken;
         const allEvents = [];
-        let nextEventIndex = 0;
+        let nextEventIndex = (_a = options.startIndex) !== null && _a !== void 0 ? _a : 0;
         const auth = {
             bearerToken: options.bearerToken,
             headers: options.headers,
@@ -78,7 +79,7 @@ export function runSession(options) {
             throw new Error("server did not return a session id");
         }
         const trajectory = buildTrajectory(allEvents);
-        return Object.assign(Object.assign({ sessionId }, (continuationToken === undefined ? {} : { continuationToken })), { baseUrl, events: allEvents, trajectory, ok: trajectory.ok });
+        return Object.assign(Object.assign({ sessionId }, (continuationToken === undefined ? {} : { continuationToken })), { baseUrl, events: allEvents, trajectory, ok: trajectory.ok, nextEventIndex: allEvents.length === 0 ? undefined : nextEventIndex });
     });
 }
 function runOneTurn(args) {

package/dist/internal/sdk-runner.d.ts

@@ -5,13 +5,33 @@
  * settings; cloud agents use Cursor cloud (`bc-…` ids) with optional
  * `cloud` options from `defineAgent`.
  */
-import { type LocalAgentStore, type ModelSelection } from "@cursor/sdk";
+import { type LocalAgentStore, type ModelSelection, type RunResult } from "@cursor/sdk";
 import { type ModelSetting, type RunnerTurnRequest, type TurnOutcome } from "../types.js";
 /** Internal seam between the session engine and the Cursor SDK harness. */
 export interface AgentRunner {
     runTurn(request: RunnerTurnRequest): Promise<TurnOutcome>;
+    /**
+     * Resolve a local workspace before any session needs it, so the first turn
+     * is not the one that pays for it. Best effort, hence the reported outcome:
+     * a runner that cannot warm must say so rather than let a caller log
+     * success over a workspace that was never touched.
+     */
+    prewarm?(request: RunnerPrewarmRequest): Promise<PrewarmOutcome>;
     dispose?(): Promise<void>;
 }
+/**
+ * The parts of a turn that decide which local executor it runs on. Must stay
+ * a subset of {@link RunnerTurnRequest} — anything that disagrees warms an
+ * executor no turn will ask for.
+ */
+export type RunnerPrewarmRequest = Pick<RunnerTurnRequest, "workspaceDir" | "runnerStateDir" | "sandbox" | "mcpServers" | "subagents" | "model">;
+/** Whether a workspace was actually resolved, and why not when it wasn't. */
+export type PrewarmOutcome = {
+    readonly warmed: true;
+} | {
+    readonly warmed: false;
+    readonly reason: string;
+};
 export interface CursorSdkRunnerOptions {
     /** Cursor API key. Defaults to the `CURSOR_API_KEY` environment variable. */
     apiKey?: string;
@@ -24,14 +44,43 @@ export interface CursorSdkRunnerOptions {
     /** Diagnostics for degraded paths (resume-miss fallback). */
     logger?: (line: string) => void;
 }
+/**
+ * The backend's `NotLoggedIn` copy ("Authentication error" title, "try
+ * logging out and back in." detail) as it surfaces through SDK RunResults.
+ * Deliberately narrow: this gates a one-shot in-place retry, and matching
+ * broader error text would retry turns that a fresh transport cannot fix.
+ */
+export declare function isAuthErrorMessage(message: string | undefined): boolean;
 export declare class CursorSdkRunner implements AgentRunner {
     private readonly options;
     private readonly agents;
     private readonly stores;
+    private readonly prewarmReleases;
     constructor(options?: CursorSdkRunnerOptions);
     runTurn(request: RunnerTurnRequest): Promise<TurnOutcome>;
+    private runTurnAttempt;
+    /**
+     * Build the local executor for a workspace before any session asks for it.
+     * The warmed executor is reference counted, so the lease is held until
+     * {@link dispose}; dropping it early would tear the workspace back down.
+     */
+    prewarm(request: RunnerPrewarmRequest): Promise<PrewarmOutcome>;
     dispose(): Promise<void>;
     private getAgent;
+    /**
+     * Drop a cached handle and close it best-effort to release its transport
+     * and executor lease. Identity-checked so a turn that lost a race with a
+     * newer open cannot evict the replacement handle.
+     */
+    private evictAgent;
+    private log;
+    private requireApiKey;
+    private buildSharedOptions;
+    /**
+     * The options that decide which local executor a turn runs on. Prewarming
+     * goes through here too, so a warmed workspace is the one turns land on.
+     */
+    private buildLocalOptions;
     private openAgent;
     private openLocalAgent;
     private openCloudAgent;
@@ -47,4 +96,5 @@ export declare function isServerMintedCloudAgentId(id: string): boolean;
  */
 export declare function isLocalAgentNotFoundError(error: unknown, agentId: string): boolean;
 export declare function toModelSelection(model: ModelSetting): ModelSelection;
+export declare function runErrorMessage(result: Pick<RunResult, "error">): string;
 //# sourceMappingURL=sdk-runner.d.ts.map

package/dist/internal/sdk-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,cAAc,EAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,eAAgB,YAAW,WAAW;IAIrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IAEtE,YAA6B,OAAO,GAAE,sBAA2B,EAAI;IAE/D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CA0D9D;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ7B;IAED,OAAO,CAAC,QAAQ;YAYF,SAAS;YA2BT,cAAc;YAyCd,cAAc;IAqC5B,OAAO,CAAC,QAAQ;CAUjB;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAMT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAQpE"}
+{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,EACf,cAAc,GACd,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,CACV,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxD,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAwBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKvE;AAED,qBAAa,eAAgB,YAAW,WAAW;IAKrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAElE,YAA6B,OAAO,GAAE,sBAA2B,EAAI;IAE/D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkC9D;YAEa,cAAc;IAyE5B;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAepE;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7B;IAED,OAAO,CAAC,QAAQ;IA0BhB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAc1B;;;OAGG;YACW,iBAAiB;YAkBjB,SAAS;YAOT,cAAc;YA6Bd,cAAc;IAqC5B,OAAO,CAAC,QAAQ;CAUjB;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAMT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAQpE;AAmED,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}

package/dist/internal/sdk-runner.js

@@ -15,18 +15,80 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { mkdir } from "node:fs/promises";
-import { Agent, JsonlLocalAgentStore, } from "@cursor/sdk";
+import { Agent, createAgentPlatform, JsonlLocalAgentStore, } from "@cursor/sdk";
 import { DEFAULT_MODEL, } from "../types.js";
+/**
+ * How long one SDK agent handle (and the Connect transport inside it) may be
+ * reused before the runner retires it.
+ *
+ * The transport exchanges the account API key for a short-lived access token
+ * (`SessionType.API_KEY_TOKEN`, 60 minutes) once per handle, and has no
+ * reliable refresh: an Unauthenticated rejection on the agent's streaming RPC
+ * surfaces while the stream is being read — outside the transport's
+ * request-time 401 retry — so an expired token gets replayed on every
+ * subsequent turn until the handle is rebuilt. Long-lived sessions (watch
+ * wakes, crons) hit this at the ~60 minute mark and then fail forever.
+ * Retiring the handle comfortably before the token can expire keeps them
+ * healthy: `Agent.resume` rehydrates the same conversation from the runner
+ * store on a fresh transport, so recycling costs only transport warmth.
+ */
+const MAX_AGENT_HANDLE_AGE_MS = 45 * 60 * 1000;
+/**
+ * The backend's `NotLoggedIn` copy ("Authentication error" title, "try
+ * logging out and back in." detail) as it surfaces through SDK RunResults.
+ * Deliberately narrow: this gates a one-shot in-place retry, and matching
+ * broader error text would retry turns that a fresh transport cannot fix.
+ */
+export function isAuthErrorMessage(message) {
+    if (message === undefined) {
+        return false;
+    }
+    return /authentication error|try logging out and back in/i.test(message);
+}
 export class CursorSdkRunner {
     constructor(options = {}) {
         this.options = options;
         this.agents = new Map();
         this.stores = new Map();
+        this.prewarmReleases = [];
     }
     runTurn(request) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            let sawUpdate = false;
+            const tracked = Object.assign(Object.assign({}, request), { onUpdate: (update) => {
+                    sawUpdate = true;
+                    return request.onUpdate(update);
+                } });
+            const outcome = yield this.runTurnAttempt(tracked);
+            if (outcome.status !== "error" ||
+                !isAuthErrorMessage(outcome.errorMessage) ||
+                sawUpdate ||
+                request.isFirstTurn ||
+                ((_a = request.signal) === null || _a === void 0 ? void 0 : _a.aborted) === true) {
+                return outcome;
+            }
+            // The turn died on an authentication failure before producing any output
+            // — the signature of a handle whose exchanged access token expired (the
+            // failed attempt already evicted it). Retrying once on a fresh handle is
+            // safe here because nothing streamed and no tool ran. First turns are
+            // excluded: their token was exchanged moments ago, so the credential
+            // itself is the problem and a retry cannot succeed.
+            this.log(`[agentkit] session ${request.sessionId}: retrying the turn on a fresh SDK agent handle after an authentication failure`);
             try {
-                const agent = yield this.getAgent(request);
+                return yield this.runTurnAttempt(tracked);
+            }
+            catch (_b) {
+                // The retry was best effort; report the original failure.
+                return outcome;
+            }
+        });
+    }
+    runTurnAttempt(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const agentPromise = this.getAgent(request);
+            try {
+                const agent = yield agentPromise;
                 const run = yield agent.send(request.prompt, Object.assign({ onDelta: (_a) => __awaiter(this, [_a], void 0, function* ({ update }) {
                         try {
                             yield request.onUpdate(update);
@@ -65,7 +127,17 @@ export class CursorSdkRunner {
                 }
                 try {
                     const result = yield run.wait();
-                    return toTurnOutcome(result);
+                    const outcome = toTurnOutcome(result);
+                    if (outcome.status === "error") {
+                        // An error result usually means the handle's transport is poisoned
+                        // — most often a cached access token that aged past its 60-minute
+                        // lifetime and gets replayed on every request (stream failures
+                        // bypass the transport's 401 retry). Retire the handle so the next
+                        // attempt resumes the conversation from the store on a fresh
+                        // transport instead of failing every turn until a restart.
+                        this.evictAgent(request.sessionId, agentPromise);
+                    }
+                    return outcome;
                 }
                 finally {
                     signal === null || signal === void 0 ? void 0 : signal.removeEventListener("abort", onAbort);
@@ -74,14 +146,36 @@ export class CursorSdkRunner {
             catch (error) {
                 // Drop the cached agent so a dead Connect/HTTP2 session cannot poison
                 // the next turn (terminal/shell overflow often kills the transport).
-                this.agents.delete(request.sessionId);
+                this.evictAgent(request.sessionId, agentPromise);
                 throw error;
             }
         });
     }
+    /**
+     * Build the local executor for a workspace before any session asks for it.
+     * The warmed executor is reference counted, so the lease is held until
+     * {@link dispose}; dropping it early would tear the workspace back down.
+     */
+    prewarm(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const platform = (yield createAgentPlatform());
+            if (typeof platform.prewarmLocalWorkspace !== "function") {
+                // Older @cursor/sdk. Turns still work; they just pay on the first one.
+                return {
+                    warmed: false,
+                    reason: "the installed @cursor/sdk has no prewarmLocalWorkspace; upgrade it to warm the workspace before the first turn",
+                };
+            }
+            const release = yield platform.prewarmLocalWorkspace(yield this.buildLocalOptions(request));
+            this.prewarmReleases.push(release);
+            return { warmed: true };
+        });
+    }
     dispose() {
         return __awaiter(this, void 0, void 0, function* () {
-            const agents = yield Promise.allSettled([...this.agents.values()]);
+            const releases = this.prewarmReleases.splice(0);
+            yield Promise.allSettled(releases.map((release) => release()));
+            const agents = yield Promise.allSettled([...this.agents.values()].map((handle) => handle.agent));
             this.agents.clear();
             for (const settled of agents) {
                 if (settled.status === "fulfilled") {
@@ -91,47 +185,89 @@ export class CursorSdkRunner {
         });
     }
     getAgent(request) {
-        let agentPromise = this.agents.get(request.sessionId);
-        if (agentPromise === undefined) {
-            agentPromise = this.openAgent(request).catch((error) => {
-                this.agents.delete(request.sessionId);
-                throw error;
-            });
-            this.agents.set(request.sessionId, agentPromise);
+        const cached = this.agents.get(request.sessionId);
+        if (cached !== undefined) {
+            const ageMs = Date.now() - cached.openedAtMs;
+            if (ageMs < MAX_AGENT_HANDLE_AGE_MS) {
+                return cached.agent;
+            }
+            // Past this age the handle's exchanged access token could expire
+            // mid-turn. Retire it and reopen below on a fresh transport.
+            this.log(`[agentkit] session ${request.sessionId}: recycling the SDK agent handle after ${Math.round(ageMs / 60000)} min so the turn runs on a fresh access token`);
+            this.evictAgent(request.sessionId, cached.agent);
         }
+        const agentPromise = this.openAgent(request).catch((error) => {
+            // Nothing opened, so there is no handle to close — just free the slot.
+            this.agents.delete(request.sessionId);
+            throw error;
+        });
+        this.agents.set(request.sessionId, {
+            agent: agentPromise,
+            openedAtMs: Date.now(),
+        });
         return agentPromise;
     }
+    /**
+     * Drop a cached handle and close it best-effort to release its transport
+     * and executor lease. Identity-checked so a turn that lost a race with a
+     * newer open cannot evict the replacement handle.
+     */
+    evictAgent(sessionId, agent) {
+        const cached = this.agents.get(sessionId);
+        if (cached === undefined || cached.agent !== agent) {
+            return;
+        }
+        this.agents.delete(sessionId);
+        void cached.agent.then((sdkAgent) => sdkAgent.close()).catch(() => { });
+    }
+    log(line) {
+        var _a;
+        ((_a = this.options.logger) !== null && _a !== void 0 ? _a : (() => { }))(line);
+    }
+    requireApiKey() {
+        var _a;
+        const apiKey = (_a = this.options.apiKey) !== null && _a !== void 0 ? _a : process.env.CURSOR_API_KEY;
+        if (apiKey === undefined || apiKey.trim() === "") {
+            throw new Error("The Cursor SDK runner requires a Cursor credential: run `agent-serve login`, set CURSOR_API_KEY, or pass serve({ apiKey }).");
+        }
+        return apiKey;
+    }
+    buildSharedOptions(request) {
+        var _a;
+        const subagents = toAgentDefinitions(request.subagents);
+        return Object.assign(Object.assign({ model: toModelSelection((_a = request.model) !== null && _a !== void 0 ? _a : DEFAULT_MODEL), apiKey: this.requireApiKey() }, (Object.keys(request.mcpServers).length > 0
+            ? { mcpServers: request.mcpServers }
+            : {})), (subagents === undefined ? {} : { agents: subagents }));
+    }
+    /**
+     * The options that decide which local executor a turn runs on. Prewarming
+     * goes through here too, so a warmed workspace is the one turns land on.
+     */
+    buildLocalOptions(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const store = (_a = this.options.store) !== null && _a !== void 0 ? _a : (yield this.getStore(request.runnerStateDir));
+            return Object.assign(Object.assign({}, this.buildSharedOptions(request)), { local: Object.assign({ cwd: request.workspaceDir, settingSources: ["project"], store }, (request.sandbox === true
+                    ? { sandboxOptions: { enabled: true } }
+                    : {})) });
+        });
+    }
     openAgent(request) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            const apiKey = (_a = this.options.apiKey) !== null && _a !== void 0 ? _a : process.env.CURSOR_API_KEY;
-            if (apiKey === undefined || apiKey.trim() === "") {
-                throw new Error("The Cursor SDK runner requires a Cursor credential: run `agent-serve login`, set CURSOR_API_KEY, or pass serve({ apiKey }).");
-            }
-            const model = (_b = request.model) !== null && _b !== void 0 ? _b : DEFAULT_MODEL;
-            const subagents = toAgentDefinitions(request.subagents);
-            const shared = Object.assign(Object.assign({ model: toModelSelection(model), apiKey }, (Object.keys(request.mcpServers).length > 0
-                ? { mcpServers: request.mcpServers }
-                : {})), (subagents === undefined ? {} : { agents: subagents }));
             if (request.runtime === "cloud") {
-                return this.openCloudAgent(request, shared);
+                return this.openCloudAgent(request, this.buildSharedOptions(request));
             }
-            return this.openLocalAgent(request, shared);
+            return this.openLocalAgent(request);
         });
     }
-    openLocalAgent(request, shared) {
+    openLocalAgent(request) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
-            const store = (_a = this.options.store) !== null && _a !== void 0 ? _a : (yield this.getStore(request.runnerStateDir));
-            const options = Object.assign(Object.assign({}, shared), { local: {
-                    cwd: request.workspaceDir,
-                    settingSources: ["project"],
-                    store,
-                } });
+            var _a, _b;
+            const options = yield this.buildLocalOptions(request);
             if (request.isFirstTurn || request.sdkAgentId === undefined) {
-                return Agent.create(Object.assign(Object.assign({}, options), { agentId: (_b = request.sdkAgentId) !== null && _b !== void 0 ? _b : request.sessionId }));
+                return Agent.create(Object.assign(Object.assign({}, options), { agentId: (_a = request.sdkAgentId) !== null && _a !== void 0 ? _a : request.sessionId }));
             }
-            const agentId = (_c = request.sdkAgentId) !== null && _c !== void 0 ? _c : request.sessionId;
+            const agentId = (_b = request.sdkAgentId) !== null && _b !== void 0 ? _b : request.sessionId;
             try {
                 return yield Agent.resume(agentId, options);
             }
@@ -144,7 +280,7 @@ export class CursorSdkRunner {
                 // conversation under the same id beats failing this thread's turns
                 // forever ("Agent … not found" on every follow-up). The channel's
                 // warm-turn prompt context re-hydrates the thread history.
-                ((_d = this.options.logger) !== null && _d !== void 0 ? _d : (() => { }))(`[agentkit] no stored conversation for ${agentId} on this host; starting a fresh one`);
+                this.log(`[agentkit] no stored conversation for ${agentId} on this host; starting a fresh one`);
                 return Agent.create(Object.assign(Object.assign({}, options), { agentId }));
             }
         });
@@ -242,6 +378,10 @@ function toTurnOutcome(result) {
             ? {}
             : { reasoningTokens: result.usage.reasoningTokens }));
     return Object.assign(Object.assign(Object.assign({ status: result.status }, (result.result === undefined ? {} : { result: result.result })), (result.status === "error"
-        ? { errorMessage: "The Cursor agent run failed" }
+        ? { errorMessage: runErrorMessage(result) }
         : {})), (usage === undefined ? {} : { usage }));
 }
+export function runErrorMessage(result) {
+    var _a, _b;
+    return ((_b = (_a = result.error) === null || _a === void 0 ? void 0 : _a.message) === null || _b === void 0 ? void 0 : _b.trim()) || "The Cursor agent run failed";
+}

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAqFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAmpB3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAqFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CA2pB3B"}

package/dist/internal/server.js

@@ -241,6 +241,11 @@ export function startServer(mounts_1) {
             // Rehydrate sessions from the authored storage sink before any
             // channel or route can address them (continuation tokens must resolve).
             yield engine.restoreStoredSessions();
+            // Resolve a shared harness workspace in the background: on a large repo
+            // that takes seconds, and a deployment coming online should absorb it
+            // rather than whoever sends the first message. No-op unless the agent
+            // pins `local.workspaceDir`.
+            void engine.prewarmSharedWorkspace();
             if (!githubAuthWarmed) {
                 // Soft ambient GitHub auth check before channel onStart (which may call
                 // host.github). Missing auth is a warning only — serve still starts.
@@ -263,6 +268,7 @@ export function startServer(mounts_1) {
                 list: (filter) => reminderRunner.list(filter),
                 cancel: (id, reason) => reminderRunner.cancel(id, reason),
                 cancelForContinuation: (token, reason) => reminderRunner.cancelForContinuation(token, reason),
+                rekeyContinuation: (channelId, oldToken, newToken) => reminderRunner.rekeyContinuation(channelId, oldToken, newToken),
                 dispatch: (id) => reminderRunner.dispatch(id),
             });
             engine.setEvals({
@@ -687,7 +693,11 @@ function mountAgentRoutes(router, runtime, args) {
         method: "GET",
         pattern: `${base}/v1/meta`,
         auth: "none",
-        handler: () => jsonResponse(Object.assign({ name: project.name, dev, basePath: base }, (multi ? { indexPath: "/" } : {}))),
+        handler: () => jsonResponse(Object.assign({ name: project.name, dev, basePath: base, 
+            // Framework version, for SPA/engine skew observability now that the
+            // hosted playground shell is served centrally (backend deploys)
+            // while engines stay on their install-time version.
+            version: packageVersion() }, (multi ? { indexPath: "/" } : {}))),
     });
     router.add({
         method: "GET",

package/dist/internal/session-engine.d.ts

@@ -227,15 +227,28 @@ export declare class SessionEngine {
     getContinuationLastBotMessageTs(channelId: string, continuationToken: string): Promise<string | undefined>;
     interruptContinuation(channelId: string, continuationToken: string): Promise<boolean>;
     /**
-     * Local harness cwd for a session: per-send override, else
-     * `<agent.local.cwd>/<sessionId>`, else the durable session workspace.
+     * Local harness cwd for a session: per-send override, else the shared
+     * `agent.local.workspaceDir`, else `<agent.local.cwd>/<sessionId>`, else
+     * the durable session workspace.
      */
     harnessCwd(record: SessionRecord): string;
     /**
-     * Directory that receives AGENTS.md / skills / agent tools. When the
-     * harness cwd is a one-off override (e.g. PR worktree), scaffold stays in
-     * the durable session workspace; otherwise scaffold lands in the harness.
+     * True when the harness cwd is a directory the session does not own — a
+     * per-send override (e.g. a PR worktree) or a workspace shared by every
+     * session. Agent scaffold has to stay out of those, so it lands in the
+     * durable session workspace and the instructions travel inline instead.
      */
+    private hasBorrowedWorkspace;
+    /**
+     * Resolve the shared harness workspace during startup, so the first session
+     * is not the one that waits for it. Only possible with
+     * `local.workspaceDir`: every other layout gives a session its own cwd,
+     * which is unknowable until that session exists.
+     *
+     * Best effort — warming is an optimization, and a turn rebuilds on its own.
+     */
+    prewarmSharedWorkspace(): Promise<void>;
+    /** Directory that receives AGENTS.md / skills / agent tools. */
     private scaffoldDir;
     private executeTurn;
     private buildTurnRequest;