@stigmer/runner 3.15.2 → 3.15.3-dev.20260914121148

package/dist/activities/execute-cursor/__test-utils__/scripted-sdk.js

@@ -1,11 +1,16 @@
 /**
  * The `@cursor/sdk` module a hermetic `ExecuteCursor` run imports — every
- * runtime surface the activity path touches, backed by scripted agents.
+ * runtime surface the activity path touches, backed by scripted agents — and
+ * the `@cursor/sdk/sqlite` module beside it, backed by a store that holds
+ * nothing.
  *
- * The activity reaches the SDK at three runtime sites and nowhere else:
+ * The activity reaches the SDK at four runtime sites and nowhere else:
  *
- *  - `session-lifecycle.ts`: `Agent.create(options)`, `Agent.resume(id, options)`,
- *    `Agent.archive(id, ...)` — the agent handle.
+ *  - `session-lifecycle.ts`: `Agent.create(options)`, `Agent.resume(id, options)`
+ *    — the agent handle.
+ *  - `session-store.ts`: `SqliteLocalAgentStore.open({ workspaceRef, stateRoot })`
+ *    from `@cursor/sdk/sqlite` — the session's store the handle is created and
+ *    resumed over (`local.store`).
  *  - `service-tier.ts`: `Cursor.models.list({ apiKey })` — the catalog the
  *    variant params (`fast`, `thinking`) are pinned from.
  *  - `index.ts` outer catch: `import("@cursor/sdk")` for `CursorSdkError`, the
@@ -13,50 +18,78 @@
  *
  * Neither the SDK nor the client is injectable into the activity (the real
  * seam arrives with the harness contract; parent Q1/Q2), so — exactly as the
- * native activity tests already do for their boundary modules — the module is
- * substituted with `vi.mock`. Three existing tests each mock ONE of these
+ * native activity tests already do for their boundary modules — the modules
+ * are substituted with `vi.mock`. Three existing tests each mock ONE of these
  * surfaces (`session-lifecycle.test.ts`, `service-tier.test.ts`,
- * `sdk-warmup.test.ts`); a whole-activity run needs all three at once, which is
- * what this module is.
+ * `sdk-warmup.test.ts`); a whole-activity run needs all of them at once, which
+ * is what this module is.
  *
- * `vi.mock` is hoisted and must appear in the test file; the factory can
- * `await import()` this module and return {@link scriptedCursorSdkModule}. The
- * module's statics read the {@link ScriptedCursorSdk} bound for the current
+ * `vi.mock` is hoisted and must appear in the test file, once per module id
+ * (a subpath is its own module id, so `@cursor/sdk/sqlite` needs its own
+ * `vi.mock`); the factories `await import()` this module and return
+ * {@link scriptedCursorSdkModule} and {@link scriptedCursorSqliteModule}. The
+ * modules' statics read the {@link ScriptedCursorSdk} bound for the current
  * scenario ({@link bindScriptedSdk}), so one test file can run several
- * scenarios with different agents against the same mocked module.
+ * scenarios with different agents against the same mocked modules.
  *
  * Resolution rules a scenario declares, mirroring what the real SDK does:
  *  - `Agent.create` hands out the agent declared for the session it is asked
- *    for (`agentForSession`, when the scenario resolves agents per session —
- *    the harness contract kit runs several sessions concurrently on one
- *    adapter, and the order their creates arrive in is real I/O timing), else
- *    the NEXT unclaimed agent in `agents` (turn 1 of a fresh session; the fresh
- *    agent of a poisoned-handle recovery) — unless the scenario declared a
- *    `createFailure`, which the FIRST create throws instead (the SDK refusing
+ *    for (`agentForWorkspaceRef`, when the scenario resolves agents per
+ *    session — the harness contract kit runs several sessions concurrently on
+ *    one adapter, and the order their creates arrive in is real I/O timing),
+ *    else the NEXT unclaimed agent in `agents` (turn 1 of a fresh session; the
+ *    fresh agent of a poisoned-handle recovery) — unless the scenario declared
+ *    a `createFailure`, which the FIRST create throws instead (the SDK refusing
  *    to mint an agent: a 401 on the key, a validation error).
  *  - `Agent.resume(id)` hands back the agent with that id if the scenario
  *    declared it (in `agents` or `resumableAgents`, or handed out for a
  *    session), else throws — `resolveAgent` then falls back to `create`, which
  *    is the production shape of a lost handle.
  *  - `Cursor.models.list` answers the scenario's catalog.
+ *  - `SqliteLocalAgentStore.open` hands out a {@link ScriptedLocalAgentStore}
+ *    carrying the ref and root it was asked for, and records the open; its
+ *    `dispose()` is recorded too, so a scenario can assert the adapter's
+ *    session-store lifetime (`releaseSession`, `shutdown`).
  */
 /**
- * The `platform.workspaceRef` a create names, read defensively: the platform
- * option's type re-exports from the unshipped `@anysphere/cursor-sdk-local-runtime`
- * and resolves to `any` under `skipLibCheck` (the same gap `scripted-agent.ts`
- * records for the delta channel), so the shape is checked here, not assumed.
+ * The session a create names: the `workspaceRef` of the store it passes as
+ * `local.store`. In a hermetic run that store is the one this module's sqlite
+ * double opened; anything else (a test that mocks `@cursor/sdk` with its own
+ * stub and passes no store) names no session and falls through to the list.
  */
 function workspaceRefOf(options) {
-    const platform = options.platform;
-    if (typeof platform !== "object" || platform === null)
-        return undefined;
-    const ref = platform.workspaceRef;
-    return typeof ref === "string" ? ref : undefined;
+    const store = options.local?.store;
+    return store instanceof ScriptedLocalAgentStore ? store.workspaceRef : undefined;
+}
+/**
+ * The `@cursor/sdk/sqlite` store the adapter opens per session, holding
+ * nothing: the scripted agents carry their own state, so the store only has
+ * to be the thing `Agent.create` / `Agent.resume` are handed and the thing
+ * `releaseSession` / `shutdown` dispose. `open` and `dispose` are recorded on
+ * the bound {@link ScriptedCursorSdk} for lifetime assertions.
+ */
+export class ScriptedLocalAgentStore {
+    workspaceRef;
+    stateRoot;
+    disposeCalls = 0;
+    constructor(workspaceRef, stateRoot) {
+        this.workspaceRef = workspaceRef;
+        this.stateRoot = stateRoot;
+    }
+    static async open(options) {
+        const store = new ScriptedLocalAgentStore(options.workspaceRef, options.stateRoot ?? "");
+        current().stores.push(store);
+        return store;
+    }
+    async dispose() {
+        this.disposeCalls++;
+    }
 }
 export class ScriptedCursorSdk {
     options;
     resolutions = [];
-    archived = [];
+    /** Every store `SqliteLocalAgentStore.open` handed out, in order. */
+    stores = [];
     nextCreate = 0;
     createFailurePending;
     byId = new Map();
@@ -101,9 +134,6 @@ export class ScriptedCursorSdk {
             agent.model = options.model;
         return agent;
     }
-    archive(agentId) {
-        this.archived.push(agentId);
-    }
     listModels() {
         return this.options.catalog;
     }
@@ -178,7 +208,6 @@ export function scriptedCursorSdkModule() {
         Agent: {
             create: async (options) => current().create(options),
             resume: async (agentId, options) => current().resume(agentId, options),
-            archive: async (agentId) => current().archive(agentId),
         },
         Cursor: {
             models: {
@@ -188,4 +217,25 @@ export function scriptedCursorSdkModule() {
         CursorSdkError: ScriptedCursorSdkError,
     };
 }
+/**
+ * The factory a test passes to `vi.mock("@cursor/sdk/sqlite", ...)`, beside
+ * the one above:
+ *
+ * ```ts
+ * vi.mock("@cursor/sdk/sqlite", async () =>
+ *   (await import("../../__test-utils__/scripted-sdk.js")).scriptedCursorSqliteModule(),
+ * );
+ * ```
+ *
+ * The one export the runner reads from that entry (`session-store.ts`). The
+ * class is exported under the SDK's name so `session-store.ts`'s dynamic
+ * import destructures it unchanged; its type is the SDK's, which is why
+ * {@link ScriptedLocalAgentStore} carries `workspaceRef`, `stateRoot` and
+ * `dispose()` — the members the runner touches — and nothing else.
+ */
+export function scriptedCursorSqliteModule() {
+    return {
+        SqliteLocalAgentStore: ScriptedLocalAgentStore,
+    };
+}
 //# sourceMappingURL=scripted-sdk.js.map

package/dist/activities/execute-cursor/__test-utils__/scripted-sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"scripted-sdk.js","sourceRoot":"","sources":["../../../../src/activities/execute-cursor/__test-utils__/scripted-sdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scripted-sdk.js","sourceRoot":"","sources":["../../../../src/activities/execute-cursor/__test-utils__/scripted-sdk.ts"],"names":[],"mappings":"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"}

package/dist/activities/execute-cursor/adapter.d.ts

@@ -5,9 +5,10 @@
  * module boots, releases, and delegates.
  *
  * What this adapter owns: the proxy interceptors and the parked-agent cache
- * (worker lifetime), the parked agent per session (session lifetime), and one
- * engine turn (`runTurn`, through `turn.ts`). Everything else about a turn is
- * the runtime's (`harness/run-turn.ts`).
+ * (worker lifetime), the parked agent and the SDK store per session (session
+ * lifetime; `agent-session-cache.ts`, `session-store.ts`), and one engine turn
+ * (`runTurn`, through `turn.ts`). Everything else about a turn is the
+ * runtime's (`harness/run-turn.ts`).
  *
  * THIS MODULE'S STATIC GRAPH IS SDK-FREE, ON PURPOSE. The composition roots
  * import it (through `src/harness-adapters.ts`) BEFORE they boot it, and

package/dist/activities/execute-cursor/adapter.js

@@ -5,9 +5,10 @@
  * module boots, releases, and delegates.
  *
  * What this adapter owns: the proxy interceptors and the parked-agent cache
- * (worker lifetime), the parked agent per session (session lifetime), and one
- * engine turn (`runTurn`, through `turn.ts`). Everything else about a turn is
- * the runtime's (`harness/run-turn.ts`).
+ * (worker lifetime), the parked agent and the SDK store per session (session
+ * lifetime; `agent-session-cache.ts`, `session-store.ts`), and one engine turn
+ * (`runTurn`, through `turn.ts`). Everything else about a turn is the
+ * runtime's (`harness/run-turn.ts`).
  *
  * THIS MODULE'S STATIC GRAPH IS SDK-FREE, ON PURPOSE. The composition roots
  * import it (through `src/harness-adapters.ts`) BEFORE they boot it, and
@@ -54,6 +55,7 @@ import { closeAllCachedAgents, evictSessionAgent } from "./agent-session-cache.j
 import { CURSOR_CAPABILITIES } from "./cursor-capabilities.js";
 import { installFetchInterceptor } from "./fetch-interceptor.js";
 import { assertHttp2ConnectPatched, installHttp2Interceptor } from "./http2-interceptor.js";
+import { releaseAllSessionStores, releaseSessionStore } from "./session-store.js";
 /** The config slice this adapter reads per turn, taken at `boot`; a whole `Config` satisfies it. */
 export function resolveCursorConfig(config) {
     return {
@@ -102,13 +104,15 @@ export function createCursorAdapter() {
             const { runCursorTurn } = await import("./turn.js");
             booted = { config: resolveCursorConfig(bootConfig), runCursorTurn };
         },
-        /** Close every parked agent (their executor leases and MCP subprocesses). */
+        /** Close every parked agent (their executor leases and MCP subprocesses), then every session's SDK store. */
         async shutdown() {
             closeAllCachedAgents();
+            await releaseAllSessionStores();
         },
-        /** The session is done on this host: close the agent parked for it, if any (#215). */
+        /** The session is done on this host: close the agent parked for it, if any (#215), then its SDK store (#1053). */
         async releaseSession(sessionId) {
             evictSessionAgent(sessionId);
+            await releaseSessionStore(sessionId);
         },
         async runTurn(input, sink) {
             if (booted === undefined) {

package/dist/activities/execute-cursor/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAG5F,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;KACpD,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,mBAAmB;IACjC,IAAI,MAAuC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,mBAAmB;QAEjC;;;;;;WAMG;QACH,KAAK,CAAC,IAAI,CAAC,UAAkB;YAC3B,IAAI,UAAU,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CACb,oIAAoI,CACrI,CAAC;YACJ,CAAC;YACD,qEAAqE;YACrE,uEAAuE;YACvE,wEAAwE;YACxE,oEAAoE;YACpE,uBAAuB,CAAC;gBACtB,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,SAAS;gBACpD,aAAa,EAAE,UAAU,CAAC,aAAa;aACxC,CAAC,CAAC;YACH,uBAAuB,CAAC;gBACtB,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,SAAS;gBACpD,aAAa,EAAE,UAAU,CAAC,aAAa;aACxC,CAAC,CAAC;YACH,QAAQ,CAAC,wBAAwB,CAAC,CAAC;YACnC,yEAAyE;YACzE,sEAAsE;YACtE,mDAAmD;YACnD,MAAM,yBAAyB,EAAE,CAAC;YAElC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACpD,MAAM,GAAG,EAAE,MAAM,EAAE,mBAAmB,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QACtE,CAAC;QAED,6EAA6E;QAC7E,KAAK,CAAC,QAAQ;YACZ,oBAAoB,EAAE,CAAC;QACzB,CAAC;QAED,sFAAsF;QACtF,KAAK,CAAC,cAAc,CAAC,SAAiB;YACpC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,IAAc;YAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,gGAAgG,CAAC,CAAC;YACpH,CAAC;YACD,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGlF,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;KACpD,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,mBAAmB;IACjC,IAAI,MAAuC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,mBAAmB;QAEjC;;;;;;WAMG;QACH,KAAK,CAAC,IAAI,CAAC,UAAkB;YAC3B,IAAI,UAAU,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CACb,oIAAoI,CACrI,CAAC;YACJ,CAAC;YACD,qEAAqE;YACrE,uEAAuE;YACvE,wEAAwE;YACxE,oEAAoE;YACpE,uBAAuB,CAAC;gBACtB,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,SAAS;gBACpD,aAAa,EAAE,UAAU,CAAC,aAAa;aACxC,CAAC,CAAC;YACH,uBAAuB,CAAC;gBACtB,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,SAAS;gBACpD,aAAa,EAAE,UAAU,CAAC,aAAa;aACxC,CAAC,CAAC;YACH,QAAQ,CAAC,wBAAwB,CAAC,CAAC;YACnC,yEAAyE;YACzE,sEAAsE;YACtE,mDAAmD;YACnD,MAAM,yBAAyB,EAAE,CAAC;YAElC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACpD,MAAM,GAAG,EAAE,MAAM,EAAE,mBAAmB,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QACtE,CAAC;QAED,6GAA6G;QAC7G,KAAK,CAAC,QAAQ;YACZ,oBAAoB,EAAE,CAAC;YACvB,MAAM,uBAAuB,EAAE,CAAC;QAClC,CAAC;QAED,kHAAkH;QAClH,KAAK,CAAC,cAAc,CAAC,SAAiB;YACpC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,IAAc;YAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,gGAAgG,CAAC,CAAC;YACpH,CAAC;YACD,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/activities/execute-cursor/sdk-warmup.d.ts

@@ -3,10 +3,19 @@
  *
  * The first `Agent.create` in a pod pays the SDK's platform construction:
  * four SQLite-backed stores (run/checkpoint/event stores + notifier) whose
- * first use loads the sqlite native binding and compiles the schema
- * migrations. The 2026-07-30 instrumented baseline (issue #209) measured
- * this at ~1.2s of the ~2.4s `resolve_agent` segment, with a 624ms floor —
- * roughly half the cost is per-process warm-up, not per-session work.
+ * first use compiles the schema migrations. The 2026-07-30 instrumented
+ * baseline (issue #209, @cursor/sdk 1.0.13) measured this at ~1.2s of the
+ * ~2.4s `resolve_agent` segment, with a 624ms floor — roughly half the cost
+ * was per-process warm-up, not per-session work. Part of that floor was the
+ * `sqlite3` native binding's load; since 1.0.31 (stigmer/stigmer#1053) the
+ * SDK's stores run on `node:sqlite`, which is inside the Node binary, and the
+ * session's store is opened by the runner itself (`session-store.ts`,
+ * `SqliteLocalAgentStore.open`) rather than through the platform this
+ * warm-up constructs. What this warm-up still saves at 1.0.31 is therefore a
+ * measurement, not a known quantity: its `durationMs` and the cold-start
+ * timeline answer it, and the harness program carries the question of
+ * whether to warm through the store the runner actually opens, or through
+ * the SDK's own `prewarmLocalWorkspace`, or not at all.
  *
  * Pool members idle between boot and claim, so constructing one throwaway
  * platform there moves that per-process cost off the user-visible path.
@@ -26,8 +35,8 @@ export interface SdkWarmupResult {
 }
 /**
  * Construct (and abandon) one SDK agent platform on a throwaway temp-dir
- * state root, forcing the sqlite native binding + store schema work to
- * happen now instead of inside the first user-facing `Agent.create`.
+ * state root, forcing the store schema work to happen now instead of inside
+ * the first user-facing `Agent.create`.
  *
  * Total by construction — warm-up is an optimization and must never affect
  * the member's ability to serve. The throwaway state root is a few KB on

package/dist/activities/execute-cursor/sdk-warmup.js

@@ -3,10 +3,19 @@
  *
  * The first `Agent.create` in a pod pays the SDK's platform construction:
  * four SQLite-backed stores (run/checkpoint/event stores + notifier) whose
- * first use loads the sqlite native binding and compiles the schema
- * migrations. The 2026-07-30 instrumented baseline (issue #209) measured
- * this at ~1.2s of the ~2.4s `resolve_agent` segment, with a 624ms floor —
- * roughly half the cost is per-process warm-up, not per-session work.
+ * first use compiles the schema migrations. The 2026-07-30 instrumented
+ * baseline (issue #209, @cursor/sdk 1.0.13) measured this at ~1.2s of the
+ * ~2.4s `resolve_agent` segment, with a 624ms floor — roughly half the cost
+ * was per-process warm-up, not per-session work. Part of that floor was the
+ * `sqlite3` native binding's load; since 1.0.31 (stigmer/stigmer#1053) the
+ * SDK's stores run on `node:sqlite`, which is inside the Node binary, and the
+ * session's store is opened by the runner itself (`session-store.ts`,
+ * `SqliteLocalAgentStore.open`) rather than through the platform this
+ * warm-up constructs. What this warm-up still saves at 1.0.31 is therefore a
+ * measurement, not a known quantity: its `durationMs` and the cold-start
+ * timeline answer it, and the harness program carries the question of
+ * whether to warm through the store the runner actually opens, or through
+ * the SDK's own `prewarmLocalWorkspace`, or not at all.
  *
  * Pool members idle between boot and claim, so constructing one throwaway
  * platform there moves that per-process cost off the user-visible path.
@@ -24,8 +33,8 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 /**
  * Construct (and abandon) one SDK agent platform on a throwaway temp-dir
- * state root, forcing the sqlite native binding + store schema work to
- * happen now instead of inside the first user-facing `Agent.create`.
+ * state root, forcing the store schema work to happen now instead of inside
+ * the first user-facing `Agent.create`.
  *
  * Total by construction — warm-up is an optimization and must never affect
  * the member's ability to serve. The throwaway state root is a few KB on

package/dist/activities/execute-cursor/sdk-warmup.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-warmup.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/sdk-warmup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAClE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,mBAAmB,CAAC,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC;YAC5B,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"sdk-warmup.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/sdk-warmup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAClE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,mBAAmB,CAAC,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC;YAC5B,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAC7D,CAAC"}

package/dist/activities/execute-cursor/session-lifecycle.d.ts

@@ -3,39 +3,46 @@
  *
  * SessionSpec.harness_state_id stores the Cursor agentId. This module handles
  * creating new agents (first execution), resuming existing agents
- * (subsequent executions), graceful fallback on resume failure, and
- * cleaning up agents (session deletion).
+ * (subsequent executions) and graceful fallback on resume failure.
  *
  * Two execution modes:
  *
- * - Local mode: Agent.create({ local: { cwd } }) with explicit
- *   platform.workspaceRef/stateRoot for deterministic store keying.
- *   Produces agent- prefixed IDs.
+ * - Local mode: Agent.create({ local: { cwd, dirs, store, ... } }) over the
+ *   session's own SQLite store (`session-store.ts`). Produces agent- prefixed
+ *   IDs.
  *
  * - Cloud mode (feature-flagged): Agent.create({ cloud: { repos } })
- *   for git-backed workspaces. Produces bc- prefixed IDs. No platform
- *   options — cloud state lives on Cursor's servers, not local SQLite.
- *
- * Key SDK limitation: mcpServers are NOT persisted across Agent.resume().
- * They must be passed again on every resume call.
- *
- * Platform store keying (local only): The Cursor SDK defaults to
- * process.cwd() for its internal state root lookup. In cloud sandboxes,
- * process.cwd() is the runner's app directory, not the workspace — causing
- * Agent.resume() to fail with "Agent not found". We pass explicit
- * platform.workspaceRef and platform.stateRoot derived from the Stigmer
- * sessionId to ensure deterministic store lookup regardless of process.cwd().
- *
- * Durability model: the SDK's local SQLite store (agent records, runs,
- * checkpoints) is the source of truth for conversation continuation. It is
- * persisted under the durable workspace volume (see resolvePlatformOptions)
- * so Agent.resume() survives pod restart, reschedule, and snapshot restore.
- * When resume nonetheless fails (store lost, corrupted, or agent unknown),
- * this module creates a fresh agent and the caller starts a new turn from
- * the user message plus re-injected instructions — there is no separate
- * continuation store.
+ *   for git-backed workspaces. Produces bc- prefixed IDs. No store — cloud
+ *   state lives on Cursor's servers, not local SQLite.
+ *
+ * Nothing under `local` survives Agent.resume(): `cwd`, `dirs`,
+ * `settingSources`, `store` and `enableAgentRetries` are re-supplied on every
+ * resume, exactly like `mcpServers`, `agents` and the model params. Omitting
+ * `cwd` re-roots the resumed agent at process.cwd() and loads the "project"
+ * setting source (the .cursor/hooks.json carrying the HITL approval hook) from
+ * the wrong directory, silently disabling the gate on every resumed turn;
+ * omitting `store` would make the SDK look the agent up in a default store
+ * derived from `cwd`, not the one the session's records are in.
+ *
+ * Durability model: the session's SQLite store (agent records, runs,
+ * checkpoints) is the source of truth for conversation continuation. It lives
+ * under the durable workspace volume (`session-store.ts`) so Agent.resume()
+ * survives pod restart, reschedule, and snapshot restore. When resume
+ * nonetheless fails (store lost, corrupted, or agent unknown), this module
+ * creates a fresh agent and the caller starts a new turn from the user message
+ * plus re-injected instructions — there is no separate continuation store.
+ *
+ * Retries are the runner's, not the SDK's. `@cursor/sdk` 1.0.31 defaults
+ * `enableAgentRetries` to true for headless embedders (1.0.13 defaulted it to
+ * false); the runner already owns recovery from a dead or stalled transport —
+ * `withTimeout` around agent resolution, `resolveAgentWithTransportRecovery`
+ * (reset the transport, retry once), the two recovery spines in
+ * `turn-settle.ts`, and the stall detector — so the SDK's layer is pinned OFF
+ * to keep one retry authority and the 1.0.13 timing of every provider fault.
+ * Whether to adopt the SDK's retries and delete ours is an open design
+ * question for the harness program, recorded there; it is not decided here.
  */
-import type { SDKAgent, CursorAgentPlatformOptions, AgentDefinition, ModelParameterValue } from "@cursor/sdk";
+import type { SDKAgent, AgentDefinition, ModelParameterValue } from "@cursor/sdk";
 import type { CloudRepo } from "../../shared/blueprint-resolver.js";
 import type { CursorMcpServerConfig } from "./cursor-mcp-config.js";
 export interface CreateAgentOptions {
@@ -129,31 +136,8 @@ export interface AgentResolution {
     /** Non-empty only when reason is "created_after_resume_failure". */
     resumeFailureDetail?: string;
 }
-/**
- * Compute deterministic platform options for a Stigmer session.
- *
- * workspaceRef is a synthetic identifier (not a filesystem path) that
- * ensures the SDK's platform cache key is stable across activity
- * invocations regardless of process.cwd().
- *
- * stateRoot is a session-isolated directory under the durable workspace
- * volume ({workspaceRootDir}/.stigmer/cursor-sdk-state/{sessionId}) where
- * the SDK persists its SQLite stores (agent records, runs, checkpoints).
- * Placing it on the workspace volume (rather than $HOME) makes native
- * Agent.resume() survive pod restart/reschedule and snapshot restore, and
- * keys it by sessionId so sessions sharing one volume (e.g. the child agent
- * executions of a workflow sandbox) never collide. Created eagerly to
- * prevent ENOENT on first SDK write.
- *
- * Both inputs are required and must be non-empty: the stateRoot is keyed by
- * sessionId, so an empty sessionId would collapse every session sharing the
- * volume onto the same store and corrupt their conversation state.
- */
-export declare function resolvePlatformOptions(sessionId: string, workspaceRootDir: string): CursorAgentPlatformOptions;
 /**
  * Create a new local Cursor Agent for the first execution in a session.
- *
- * Supports multi-workspace: passes string[] when multiple dirs, string when single.
  */
 export declare function createAgent(options: CreateAgentOptions): Promise<SDKAgent>;
 /**
@@ -167,7 +151,7 @@ export declare function resumeAgent(options: ResumeAgentOptions): Promise<SDKAge
  * Create a new cloud Cursor Agent for git-backed sessions.
  *
  * Cloud agents (bc- prefix) run on Cursor's servers with cloned repos.
- * No platform options — cloud state lives server-side, not in local SQLite.
+ * No store — cloud state lives server-side, not in local SQLite.
  * Model is optional — Cursor resolves the caller's configured default
  * when omitted.
  */
@@ -177,7 +161,7 @@ export declare function createCloudAgent(options: CreateCloudAgentOptions): Prom
  *
  * Throws on failure — the caller (resolveAgent) decides whether to
  * propagate or fall back to a fresh cloud agent with continuation context.
- * No platform options — cloud state lives server-side.
+ * No store — cloud state lives server-side.
  */
 export declare function resumeCloudAgent(options: ResumeCloudAgentOptions): Promise<SDKAgent>;
 /**
@@ -185,8 +169,8 @@ export declare function resumeCloudAgent(options: ResumeCloudAgentOptions): Prom
  * graceful fallback if resume fails.
  *
  * The mode parameter determines which create/resume functions are used:
- * - "local": createAgent / resumeAgent (with platform options)
- * - "cloud": createCloudAgent / resumeCloudAgent (no platform options)
+ * - "local": createAgent / resumeAgent (over the session's store)
+ * - "cloud": createCloudAgent / resumeCloudAgent (no store)
  *
  * When harnessStateId is non-empty (subsequent execution):
  *   1. Attempt Agent.resume with mode-appropriate options.
@@ -248,8 +232,3 @@ export interface ResolveWithTransportRecoveryOptions {
  * cost, no state impact, cleaned up with the sandbox.
  */
 export declare function resolveAgentWithTransportRecovery(opts: ResolveWithTransportRecoveryOptions): Promise<AgentResolution>;
-/**
- * Dispose a Cursor Agent when a session is deleted.
- * Best-effort: logs and swallows errors.
- */
-export declare function disposeAgent(agentId: string, apiKey: string): Promise<void>;