@stigmer/runner 3.1.7 → 3.1.9

package/src/shared/tool-row.ts

@@ -187,11 +187,24 @@ export function collectSubAgentToolCallIds(
   return ids;
 }
 
-/** Terminal tool-call statuses — a row that has finished (however it finished). */
+/**
+ * Terminal tool-call statuses — a row that has finished (however it finished).
+ *
+ * Includes TOOL_CALL_INTERRUPTED (server-authored when an execution
+ * terminalized with the call in flight): for the provenance scoping below, a
+ * settled row from a prior (failed, then recovered) invocation is PRIOR-turn
+ * history and must not be attributed to the resuming turn. This is the
+ * opposite call from the Cursor translator's isTerminalToolStatus, which
+ * EXCLUDES interrupted so a recovery-replayed event can advance the row in
+ * place (the enum's recovery supersede rule) — that guard asks "may this row
+ * still move?", this set asks "had this row finished before the turn?", and an
+ * interrupted row answers yes to both.
+ */
 const TERMINAL_TOOL_CALL_STATUSES: ReadonlySet<ToolCallStatus> = new Set([
   ToolCallStatus.TOOL_CALL_COMPLETED,
   ToolCallStatus.TOOL_CALL_FAILED,
   ToolCallStatus.TOOL_CALL_SKIPPED,
+  ToolCallStatus.TOOL_CALL_INTERRUPTED,
 ]);
 
 /**

package/src/shared/workspace/platform-dir.ts

@@ -73,6 +73,31 @@ export function getPlatformDir(sessionId: string): string {
   return join(getSessionDir(sessionId), "platform");
 }
 
+/**
+ * Compute the durable-checkpoint database path for a session — the SQLite file
+ * backing the local LangGraph checkpointer (see shared/checkpointer/sqlite-saver.ts).
+ *
+ * Session-scoped by design: a session has exactly one LangGraph thread
+ * (`thread-{sessionId}`), so one DB per session keeps checkpoint lifetime bound
+ * to session lifetime (retention becomes "remove the session dir") and mirrors
+ * the sibling `platform/` and `hitl/` trees. Pure function — performs no I/O.
+ */
+export function getCheckpointDbPath(sessionId: string): string {
+  return join(getSessionDir(sessionId), "checkpoints.db");
+}
+
+/**
+ * Ensure the session directory exists and return the checkpoint DB path.
+ *
+ * Creates the session directory tree if needed (the SQLite driver requires the
+ * parent directory to exist before opening the file). Idempotent — safe across
+ * executions, HITL reinvocations, and activity retries.
+ */
+export async function ensureCheckpointDbPath(sessionId: string): Promise<string> {
+  await mkdir(getSessionDir(sessionId), { recursive: true });
+  return getCheckpointDbPath(sessionId);
+}
+
 /**
  * Ensure the platform directory exists and return its path.
  *