@stigmer/runner 3.15.2 → 3.15.3-dev.20260914121148

package/dist/activities/execute-cursor/session-lifecycle.js

@@ -3,46 +3,51 @@
  *
  * 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.
+ *   for git-backed workspaces. Produces bc- prefixed IDs. No store — 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.
+ * 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.
  *
- * 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 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.
  *
- * 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.
+ * 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 { mkdirSync } from "node:fs";
-import { join } from "node:path";
 import { Agent } from "@cursor/sdk";
 import { withTimeout, TimeoutError } from "../../shared/with-timeout.js";
+import { sessionStore } from "./session-store.js";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-const CURSOR_SDK_STATE_DIR = ".stigmer/cursor-sdk-state";
 /**
  * Cursor SDK setting sources loaded for LOCAL agents.
  *
@@ -72,63 +77,43 @@ const LOCAL_SETTING_SOURCES = ["project"];
 // Local agent functions
 // ---------------------------------------------------------------------------
 /**
- * Compute deterministic platform options for a Stigmer session.
+ * The `local` options a session's agent is created AND resumed with — one
+ * builder so the two calls cannot drift (see the module header for why every
+ * field is re-supplied on resume).
  *
- * 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.
+ * Workspaces: the SDK takes ONE primary `cwd` (the default shell's directory
+ * and the agent's store scoping) plus `dirs` for the other roots of a
+ * multi-root workspace, merged cwd-first with duplicates dropped, so rules,
+ * skills and hooks load from every root. The session's first workspace
+ * directory is the primary, as it was when the SDK took the whole array.
  */
-export function resolvePlatformOptions(sessionId, workspaceRootDir) {
-    if (!sessionId) {
-        throw new Error("resolvePlatformOptions: sessionId is required but was empty. The Cursor SDK " +
-            "state store is keyed by sessionId; an empty value would collide across sessions " +
-            "sharing a workspace volume (e.g. a workflow sandbox's child agent executions).");
-    }
-    if (!workspaceRootDir) {
-        throw new Error("resolvePlatformOptions: workspaceRootDir is required but was empty. The Cursor " +
-            "SDK state store must live on the durable workspace volume to survive restarts.");
-    }
-    const stateRoot = join(workspaceRootDir, CURSOR_SDK_STATE_DIR, sessionId);
-    mkdirSync(stateRoot, { recursive: true });
+async function localAgentOptions(sessionId, workspaceRootDir, workspaceDirs) {
+    const [cwd, ...dirs] = workspaceDirs;
+    const store = await sessionStore(sessionId, workspaceRootDir);
     return {
-        workspaceRef: `stigmer-session:${sessionId}`,
-        stateRoot,
+        cwd,
+        ...(dirs.length > 0 ? { dirs } : {}),
+        settingSources: [...LOCAL_SETTING_SOURCES],
+        store,
+        // The runner is the one retry authority (module header).
+        enableAgentRetries: false,
     };
 }
 /**
  * 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 async function createAgent(options) {
-    const cwd = options.workspaceDirs.length === 1
-        ? options.workspaceDirs[0]
-        : options.workspaceDirs;
-    const platform = resolvePlatformOptions(options.sessionId, options.workspaceRootDir);
-    console.log(`createAgent: sessionId=${options.sessionId}, workspaceRef=${platform.workspaceRef}, ` +
-        `stateRoot=${platform.stateRoot}, process.cwd=${process.cwd()}`);
+    const local = await localAgentOptions(options.sessionId, options.workspaceRootDir, options.workspaceDirs);
+    console.log(`createAgent: sessionId=${options.sessionId}, workspaceRef=${local.store.workspaceRef}, ` +
+        `stateRoot=${local.store.stateRoot}, process.cwd=${process.cwd()}`);
     return Agent.create({
         apiKey: options.apiKey,
         // Always a full selection — id AND params. A bare { id } would let the
         // catalog's default variant (account-influenced) pick the price (#357).
         model: { id: options.model, params: options.modelParams },
-        local: { cwd, settingSources: [...LOCAL_SETTING_SOURCES] },
+        local,
         mcpServers: options.mcpServers,
         agents: options.agents,
-        platform,
     });
 }
 /**
@@ -138,12 +123,9 @@ export async function createAgent(options) {
  * propagate or fall back to a fresh agent with continuation context.
  */
 export async function resumeAgent(options) {
-    const cwd = options.workspaceDirs.length === 1
-        ? options.workspaceDirs[0]
-        : options.workspaceDirs;
-    const platform = resolvePlatformOptions(options.sessionId, options.workspaceRootDir);
+    const local = await localAgentOptions(options.sessionId, options.workspaceRootDir, options.workspaceDirs);
     console.log(`resumeAgent: agentId=${options.agentId}, sessionId=${options.sessionId}, ` +
-        `workspaceRef=${platform.workspaceRef}, stateRoot=${platform.stateRoot}, ` +
+        `workspaceRef=${local.store.workspaceRef}, stateRoot=${local.store.stateRoot}, ` +
         `process.cwd=${process.cwd()}`);
     return Agent.resume(options.agentId, {
         apiKey: options.apiKey,
@@ -152,16 +134,9 @@ export async function resumeAgent(options) {
         // ledger, #357), but an id-only resume would fall back to the catalog
         // default variant for the new turns.
         model: options.model ? { id: options.model, params: options.modelParams } : undefined,
-        // Neither cwd nor settingSources survive Agent.resume(); both must be
-        // re-supplied every turn. Omitting cwd makes the SDK fall back to
-        // process.cwd(), which re-roots the agent in the runner's own working
-        // directory and loads the "project" setting source — the .cursor/hooks.json
-        // carrying the HITL approval hook — from that wrong directory, silently
-        // disabling the approval gate on every resumed turn.
-        local: { cwd, settingSources: [...LOCAL_SETTING_SOURCES] },
+        local,
         mcpServers: options.mcpServers,
         agents: options.agents,
-        platform,
     });
 }
 // ---------------------------------------------------------------------------
@@ -171,7 +146,7 @@ export async function resumeAgent(options) {
  * 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.
  */
@@ -191,7 +166,7 @@ export async function createCloudAgent(options) {
  *
  * 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 async function resumeCloudAgent(options) {
     console.log(`resumeCloudAgent: agentId=${options.agentId}`);
@@ -210,8 +185,8 @@ export async function resumeCloudAgent(options) {
  * 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.
@@ -333,16 +308,4 @@ export async function resolveAgentWithTransportRecovery(opts) {
         return attempt(true);
     }
 }
-/**
- * Dispose a Cursor Agent when a session is deleted.
- * Best-effort: logs and swallows errors.
- */
-export async function disposeAgent(agentId, apiKey) {
-    try {
-        await Agent.archive(agentId, { apiKey });
-    }
-    catch (err) {
-        console.warn(`Failed to archive Cursor agent ${agentId}:`, err instanceof Error ? err.message : err);
-    }
-}
 //# sourceMappingURL=session-lifecycle.js.map

package/dist/activities/execute-cursor/session-lifecycle.js.map

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

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

@@ -0,0 +1,100 @@
+/**
+ * Session-keyed Cursor SDK store — the on-disk SQLite store a session's
+ * agent records, runs and checkpoints live in, opened once per session and
+ * handed to every `Agent.create` / `Agent.resume` of that session
+ * (stigmer/stigmer#1053).
+ *
+ * Why this exists: `@cursor/sdk` 1.0.31 removed the `platform` option the
+ * runner used to key the SDK's store (`platform.workspaceRef` /
+ * `platform.stateRoot`) and replaced it with a caller-owned
+ * `local.store: LocalAgentStore`. The SDK's own instruction is "open once per
+ * workspace / state root and reuse across `Agent.create` / `resume`". So the
+ * store has a lifetime the runner owns, and this module is where it lives.
+ *
+ * Where the store lives on disk is unchanged from the `platform` era:
+ * `{workspaceRootDir}/.stigmer/cursor-sdk-state/{sessionId}` — the durable
+ * workspace volume rather than `$HOME`, so native `Agent.resume()` survives
+ * pod restart, reschedule and snapshot restore; keyed by sessionId so sessions
+ * sharing one volume (a workflow sandbox's child agent executions) never
+ * collide. The `workspaceRef` is the same synthetic `stigmer-session:<id>`,
+ * deliberately not a filesystem path, so lookups are stable regardless of
+ * `process.cwd()` (in a cloud sandbox that is the runner's app directory, not
+ * the workspace).
+ *
+ * Lifetime — the session's, on the two hooks the adapter already has:
+ * - `sessionStore()` opens on first use and memoizes the OPEN PROMISE per
+ *   session, so two activities racing on one session (the agent cache's
+ *   documented race: the loser resolves its own agent) await the same open
+ *   instead of racing two opens on one file. A failed open is not memoized;
+ *   the next call retries.
+ * - `releaseSessionStore(sessionId)` is called from the adapter's
+ *   `releaseSession` — the runtime saying the session is done on this host.
+ * - `releaseAllSessionStores()` is called from the adapter's `shutdown`.
+ * - A re-acquire under a DIFFERENT state root (the session moved volumes)
+ *   releases the store it held and opens the new one — the same rule the agent
+ *   cache applies to a fingerprint mismatch: a handle for the old binding can
+ *   never serve the new one, and holding it would only pin a file.
+ * Nothing else disposes a store. In particular the store does NOT ride the
+ * agent handle's `close()` — the handle has five close sites and a second
+ * resource on each would be a parallel lifecycle — and it does not enter the
+ * agent cache, whose exclusive-checkout model is about one handle per turn.
+ *
+ * At 1.0.13 the SDK memoized its platform (with open SQLite handles) for the
+ * whole process; a per-session store released when the session is released is
+ * a tighter lifetime, not a looser one.
+ *
+ * `SessionStores` is the mechanism with the opener injected, so its rules are
+ * unit-tested without a SQLite file; the module-level instance binds the SDK's
+ * `SqliteLocalAgentStore.open` (`@cursor/sdk/sqlite`, the subpath entry that
+ * keeps the sqlite driver off the main package's import path). In a hermetic
+ * run that subpath is doubled beside `@cursor/sdk` itself (`scripted-sdk.ts`).
+ *
+ * THIS MODULE'S STATIC GRAPH IS SDK-FREE, like `agent-session-cache.ts`: the
+ * adapter imports both statically, and the adapter's own static graph must
+ * stay SDK-free so the composition roots can import it before `boot` installs
+ * the interceptors (`adapter.ts` header). The SDK's sqlite entry is loaded
+ * with a dynamic import at the first open — the runner's
+ * dynamic-import-for-order convention — and only its TYPE is imported here.
+ */
+import type { SqliteLocalAgentStore } from "@cursor/sdk/sqlite";
+/** Where a session's store lives and the ref the SDK scopes it under. */
+export interface SessionStoreLocation {
+    /** Synthetic, stable across activity invocations: `stigmer-session:<sessionId>`. */
+    readonly workspaceRef: string;
+    /** `{workspaceRootDir}/.stigmer/cursor-sdk-state/{sessionId}`, created eagerly. */
+    readonly stateRoot: string;
+}
+/** The slice of the SDK store whose lifetime this module owns. */
+export interface ReleasableStore {
+    readonly stateRoot: string;
+    dispose(): Promise<void>;
+}
+/**
+ * Compute a session's store location. Both inputs are required and must be
+ * non-empty: the state root is keyed by sessionId, so an empty sessionId would
+ * collapse every session sharing the volume onto one store and corrupt their
+ * conversation state; an empty root would put the store somewhere that does
+ * not survive a restart. The directory is created eagerly to prevent ENOENT on
+ * the SDK's first write.
+ */
+export declare function resolveSessionStoreLocation(sessionId: string, workspaceRootDir: string): SessionStoreLocation;
+/** One store per session, opened through `open`, held until released. */
+export declare class SessionStores<S extends ReleasableStore> {
+    private readonly open;
+    private readonly held;
+    constructor(open: (location: SessionStoreLocation) => Promise<S>);
+    /** The session's store, opened on first use; the same instance on every later call. */
+    acquire(sessionId: string, workspaceRootDir: string): Promise<S>;
+    /** Disposes and forgets the session's store, if any. A later acquire reopens. */
+    release(sessionId: string): Promise<void>;
+    /** Worker shutdown: dispose every held store. */
+    releaseAll(): Promise<void>;
+    /** How many stores are held — for assertions. */
+    get size(): number;
+}
+/** The session's SDK store, opened on first use — pass as `local.store` on create AND resume. */
+export declare function sessionStore(sessionId: string, workspaceRootDir: string): Promise<SqliteLocalAgentStore>;
+/** The session is done on this host (the adapter's `releaseSession`). */
+export declare function releaseSessionStore(sessionId: string): Promise<void>;
+/** Worker shutdown (the adapter's `shutdown`). */
+export declare function releaseAllSessionStores(): Promise<void>;

package/dist/activities/execute-cursor/session-store.js

@@ -0,0 +1,157 @@
+/**
+ * Session-keyed Cursor SDK store — the on-disk SQLite store a session's
+ * agent records, runs and checkpoints live in, opened once per session and
+ * handed to every `Agent.create` / `Agent.resume` of that session
+ * (stigmer/stigmer#1053).
+ *
+ * Why this exists: `@cursor/sdk` 1.0.31 removed the `platform` option the
+ * runner used to key the SDK's store (`platform.workspaceRef` /
+ * `platform.stateRoot`) and replaced it with a caller-owned
+ * `local.store: LocalAgentStore`. The SDK's own instruction is "open once per
+ * workspace / state root and reuse across `Agent.create` / `resume`". So the
+ * store has a lifetime the runner owns, and this module is where it lives.
+ *
+ * Where the store lives on disk is unchanged from the `platform` era:
+ * `{workspaceRootDir}/.stigmer/cursor-sdk-state/{sessionId}` — the durable
+ * workspace volume rather than `$HOME`, so native `Agent.resume()` survives
+ * pod restart, reschedule and snapshot restore; keyed by sessionId so sessions
+ * sharing one volume (a workflow sandbox's child agent executions) never
+ * collide. The `workspaceRef` is the same synthetic `stigmer-session:<id>`,
+ * deliberately not a filesystem path, so lookups are stable regardless of
+ * `process.cwd()` (in a cloud sandbox that is the runner's app directory, not
+ * the workspace).
+ *
+ * Lifetime — the session's, on the two hooks the adapter already has:
+ * - `sessionStore()` opens on first use and memoizes the OPEN PROMISE per
+ *   session, so two activities racing on one session (the agent cache's
+ *   documented race: the loser resolves its own agent) await the same open
+ *   instead of racing two opens on one file. A failed open is not memoized;
+ *   the next call retries.
+ * - `releaseSessionStore(sessionId)` is called from the adapter's
+ *   `releaseSession` — the runtime saying the session is done on this host.
+ * - `releaseAllSessionStores()` is called from the adapter's `shutdown`.
+ * - A re-acquire under a DIFFERENT state root (the session moved volumes)
+ *   releases the store it held and opens the new one — the same rule the agent
+ *   cache applies to a fingerprint mismatch: a handle for the old binding can
+ *   never serve the new one, and holding it would only pin a file.
+ * Nothing else disposes a store. In particular the store does NOT ride the
+ * agent handle's `close()` — the handle has five close sites and a second
+ * resource on each would be a parallel lifecycle — and it does not enter the
+ * agent cache, whose exclusive-checkout model is about one handle per turn.
+ *
+ * At 1.0.13 the SDK memoized its platform (with open SQLite handles) for the
+ * whole process; a per-session store released when the session is released is
+ * a tighter lifetime, not a looser one.
+ *
+ * `SessionStores` is the mechanism with the opener injected, so its rules are
+ * unit-tested without a SQLite file; the module-level instance binds the SDK's
+ * `SqliteLocalAgentStore.open` (`@cursor/sdk/sqlite`, the subpath entry that
+ * keeps the sqlite driver off the main package's import path). In a hermetic
+ * run that subpath is doubled beside `@cursor/sdk` itself (`scripted-sdk.ts`).
+ *
+ * THIS MODULE'S STATIC GRAPH IS SDK-FREE, like `agent-session-cache.ts`: the
+ * adapter imports both statically, and the adapter's own static graph must
+ * stay SDK-free so the composition roots can import it before `boot` installs
+ * the interceptors (`adapter.ts` header). The SDK's sqlite entry is loaded
+ * with a dynamic import at the first open — the runner's
+ * dynamic-import-for-order convention — and only its TYPE is imported here.
+ */
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+const CURSOR_SDK_STATE_DIR = ".stigmer/cursor-sdk-state";
+/**
+ * Compute a session's store location. Both inputs are required and must be
+ * non-empty: the state root is keyed by sessionId, so an empty sessionId would
+ * collapse every session sharing the volume onto one store and corrupt their
+ * conversation state; an empty root would put the store somewhere that does
+ * not survive a restart. The directory is created eagerly to prevent ENOENT on
+ * the SDK's first write.
+ */
+export function resolveSessionStoreLocation(sessionId, workspaceRootDir) {
+    if (!sessionId) {
+        throw new Error("resolveSessionStoreLocation: sessionId is required but was empty. The Cursor SDK " +
+            "state store is keyed by sessionId; an empty value would collide across sessions " +
+            "sharing a workspace volume (e.g. a workflow sandbox's child agent executions).");
+    }
+    if (!workspaceRootDir) {
+        throw new Error("resolveSessionStoreLocation: workspaceRootDir is required but was empty. The Cursor " +
+            "SDK state store must live on the durable workspace volume to survive restarts.");
+    }
+    const stateRoot = join(workspaceRootDir, CURSOR_SDK_STATE_DIR, sessionId);
+    mkdirSync(stateRoot, { recursive: true });
+    return { workspaceRef: `stigmer-session:${sessionId}`, stateRoot };
+}
+/** One store per session, opened through `open`, held until released. */
+export class SessionStores {
+    open;
+    held = new Map();
+    constructor(open) {
+        this.open = open;
+    }
+    /** The session's store, opened on first use; the same instance on every later call. */
+    acquire(sessionId, workspaceRootDir) {
+        const location = resolveSessionStoreLocation(sessionId, workspaceRootDir);
+        const existing = this.held.get(sessionId);
+        if (existing && existing.stateRoot === location.stateRoot)
+            return existing.store;
+        if (existing) {
+            console.log(`session-store: session=${sessionId} re-acquired under a different state root ` +
+                `(held=${existing.stateRoot}, requested=${location.stateRoot}) — releasing the held store`);
+            void this.release(sessionId);
+        }
+        const store = this.open(location);
+        this.held.set(sessionId, { stateRoot: location.stateRoot, store });
+        // A failed open must not be memoized: the next acquire retries. Only the
+        // entry THIS open created is removed (a later re-acquire may have replaced it).
+        store.catch(() => {
+            if (this.held.get(sessionId)?.store === store)
+                this.held.delete(sessionId);
+        });
+        return store;
+    }
+    /** Disposes and forgets the session's store, if any. A later acquire reopens. */
+    async release(sessionId) {
+        const entry = this.held.get(sessionId);
+        if (!entry)
+            return;
+        this.held.delete(sessionId);
+        await disposeQuietly(sessionId, entry.store);
+    }
+    /** Worker shutdown: dispose every held store. */
+    async releaseAll() {
+        const entries = [...this.held.entries()];
+        this.held.clear();
+        await Promise.all(entries.map(([sessionId, entry]) => disposeQuietly(sessionId, entry.store)));
+    }
+    /** How many stores are held — for assertions. */
+    get size() {
+        return this.held.size;
+    }
+}
+async function disposeQuietly(sessionId, store) {
+    try {
+        await (await store).dispose();
+    }
+    catch (err) {
+        // Best effort: a store whose open failed has nothing to dispose, and a
+        // dispose that fails on a dead handle changes nothing the session needs.
+        console.warn(`session-store: dispose failed for session=${sessionId}:`, err instanceof Error ? err.message : err);
+    }
+}
+const sessionStores = new SessionStores(async (location) => {
+    const { SqliteLocalAgentStore } = await import("@cursor/sdk/sqlite");
+    return SqliteLocalAgentStore.open(location);
+});
+/** The session's SDK store, opened on first use — pass as `local.store` on create AND resume. */
+export function sessionStore(sessionId, workspaceRootDir) {
+    return sessionStores.acquire(sessionId, workspaceRootDir);
+}
+/** The session is done on this host (the adapter's `releaseSession`). */
+export function releaseSessionStore(sessionId) {
+    return sessionStores.release(sessionId);
+}
+/** Worker shutdown (the adapter's `shutdown`). */
+export function releaseAllSessionStores() {
+    return sessionStores.releaseAll();
+}
+//# sourceMappingURL=session-store.js.map

package/dist/activities/execute-cursor/session-store.js.map

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

package/dist/shared/attachment-vision.d.ts

@@ -95,7 +95,8 @@ export type VisionOutcome = {
 /**
  * What a harness can actually display inline. The split exists because the
  * Cursor local transport re-sniffs magic bytes and recognizes ONLY PNG and
- * JPEG (verified against @cursor/sdk 1.0.13 dist — the declared mimeType is
+ * JPEG (verified against the @cursor/sdk dist at 1.0.13 and again at 1.0.31:
+ * the attachment sniff map is exactly JPEG and PNG; the declared mimeType is
  * discarded), while the LangChain providers accept all four types.
  */
 export interface VisionProfile {

package/dist/shared/attachment-vision.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-vision.js","sourceRoot":"","sources":["../../src/shared/attachment-vision.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"attachment-vision.js","sourceRoot":"","sources":["../../src/shared/attachment-vision.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/runner",
-  "version": "3.15.2",
+  "version": "3.15.3-dev.20260914121148",
   "description": "Embeddable Temporal worker for the Stigmer AI agent platform — handles agent execution, workflow orchestration, and MCP server management",
   "license": "Apache-2.0",
   "type": "module",
@@ -90,7 +90,7 @@
     "@bufbuild/protobuf": "2.12.0",
     "@connectrpc/connect": "^2.0.0",
     "@connectrpc/connect-node": "^2.0.0",
-    "@cursor/sdk": "^1.0.13",
+    "@cursor/sdk": "1.0.31",
     "@langchain/anthropic": "^1.5.5",
     "@langchain/core": "^1.2.7",
     "@langchain/langgraph": "^1.3.0",
@@ -104,9 +104,9 @@
     "@opentelemetry/sdk-metrics": "^2.0.0",
     "@opentelemetry/sdk-trace-base": "^2.0.0",
     "@opentelemetry/sdk-trace-node": "^2.0.0",
-    "@stigmer/protos": "3.15.2",
-    "@stigmer/temporal-codecs": "3.15.2",
-    "@stigmer/zip-structure": "3.15.2",
+    "@stigmer/protos": "3.15.3-dev.20260914121148",
+    "@stigmer/temporal-codecs": "3.15.3-dev.20260914121148",
+    "@stigmer/zip-structure": "3.15.3-dev.20260914121148",
     "@temporalio/activity": "1.16.2",
     "@temporalio/common": "1.16.2",
     "@temporalio/interceptors-opentelemetry": "1.16.2",