scai 0.1.178 → 1.0.0

package/dist/agent/persistence/currentTask.js

@@ -0,0 +1,36 @@
+/**
+ * Owns the current-task pointer for the modular agent runtime.
+ *
+ * Why this file exists:
+ * - shell and task commands need one durable current-task binding
+ * - the binding should stay separate from task row persistence and turn history
+ * - callers should not know the `global_state` table details
+ */
+import { getDbForRepo } from "../../db/client.js";
+export function getCurrentAgentTaskId(db = getDbForRepo()) {
+    const row = db.prepare(`SELECT current_task_id FROM global_state WHERE id = 1`).get();
+    return typeof row?.current_task_id === "number" ? row.current_task_id : undefined;
+}
+export function setCurrentAgentTask(taskId, sessionId, db = getDbForRepo()) {
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO global_state(id, current_session_id, current_task_id, created_at, updated_at)
+    VALUES(1, ?, ?, ?, ?)
+    ON CONFLICT(id) DO UPDATE SET
+      current_session_id = excluded.current_session_id,
+      current_task_id = excluded.current_task_id,
+      updated_at = excluded.updated_at
+  `).run(sessionId ?? null, taskId, now, now);
+}
+export function clearCurrentAgentTask(db = getDbForRepo()) {
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO global_state(id, current_session_id, current_task_id, created_at, updated_at)
+    VALUES(1, NULL, NULL, ?, ?)
+    ON CONFLICT(id) DO UPDATE SET
+      current_session_id = NULL,
+      current_task_id = NULL,
+      updated_at = excluded.updated_at
+  `).run(now, now);
+}
+//# sourceMappingURL=currentTask.js.map

package/dist/agent/persistence/currentTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currentTask.js","sourceRoot":"","sources":["../../../src/agent/persistence/currentTask.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,qBAAqB,CAAC,EAAE,GAAG,YAAY,EAAE;IACvD,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,uDAAuD,CAAC,CAAC,GAAG,EAEtE,CAAC;IACd,OAAO,OAAO,GAAG,EAAE,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,SAA6B,EAAE,EAAE,GAAG,YAAY,EAAE;IACpG,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,EAAE,CAAC,OAAO,CAAC;;;;;;;GAOV,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAE,GAAG,YAAY,EAAE;IACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,EAAE,CAAC,OAAO,CAAC;;;;;;;GAOV,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Owns the current-task pointer for the modular agent runtime.\n *\n * Why this file exists:\n * - shell and task commands need one durable current-task binding\n * - the binding should stay separate from task row persistence and turn history\n * - callers should not know the `global_state` table details\n */\nimport { getDbForRepo } from \"../../db/client.js\";\n\nexport function getCurrentAgentTaskId(db = getDbForRepo()): number | undefined {\n  const row = db.prepare(`SELECT current_task_id FROM global_state WHERE id = 1`).get() as {\n    current_task_id?: number | null;\n  } | undefined;\n  return typeof row?.current_task_id === \"number\" ? row.current_task_id : undefined;\n}\n\nexport function setCurrentAgentTask(taskId: number, sessionId: number | undefined, db = getDbForRepo()): void {\n  const now = new Date().toISOString();\n  db.prepare(`\n    INSERT INTO global_state(id, current_session_id, current_task_id, created_at, updated_at)\n    VALUES(1, ?, ?, ?, ?)\n    ON CONFLICT(id) DO UPDATE SET\n      current_session_id = excluded.current_session_id,\n      current_task_id = excluded.current_task_id,\n      updated_at = excluded.updated_at\n  `).run(sessionId ?? null, taskId, now, now);\n}\n\nexport function clearCurrentAgentTask(db = getDbForRepo()): void {\n  const now = new Date().toISOString();\n  db.prepare(`\n    INSERT INTO global_state(id, current_session_id, current_task_id, created_at, updated_at)\n    VALUES(1, NULL, NULL, ?, ?)\n    ON CONFLICT(id) DO UPDATE SET\n      current_session_id = NULL,\n      current_task_id = NULL,\n      updated_at = excluded.updated_at\n  `).run(now, now);\n}\n"]}

package/dist/agent/persistence/hydrate.js

@@ -0,0 +1,42 @@
+/**
+ * Rebuilds modular-agent memory from persisted rows and the compact snapshot.
+ *
+ * Why this file exists:
+ * - DB rows and runtime memory should meet in one place
+ * - resume hydration rules should stay out of task boot and SQL helpers
+ * - command read models should not depend on full runtime hydration
+ */
+import { createAgentMemory } from "../state/memory.js";
+import { applyAgentSnapshot, parseAgentSnapshot } from "./snapshots.js";
+import { refreshResumeCheckpoint } from "../resume/checkpoint.js";
+export function hydrateAgentMemory(sessionRow, taskRow, userQuery) {
+    const repoRootPath = taskRow.repo_root_path ?? sessionRow.repo_root_path ?? "";
+    const executionPath = taskRow.worktree_path ?? sessionRow.worktree_path ?? sessionRow.execution_path ?? repoRootPath;
+    const memory = createAgentMemory(taskRow.initial_query, repoRootPath, executionPath);
+    memory.session.id = sessionRow.id;
+    memory.session.repoRootPath = repoRootPath;
+    memory.session.executionPath = executionPath;
+    memory.session.initialQuery = taskRow.initial_query;
+    memory.task.id = taskRow.id;
+    memory.task.initialQuery = taskRow.initial_query;
+    memory.task.status = taskRow.status;
+    applyAgentSnapshot(memory, parseAgentSnapshot(taskRow.snapshot_json));
+    if (!memory.durableCheckpoint && taskRow.summary && taskRow.final_answer_packet_json) {
+        try {
+            memory.durableCheckpoint = {
+                finalAnswer: taskRow.summary,
+                finalAnswerPacket: JSON.parse(taskRow.final_answer_packet_json),
+                sourceTurnIndex: taskRow.latest_turn_index > 0 ? taskRow.latest_turn_index : undefined,
+                sourceUserQuery: taskRow.initial_query,
+            };
+        }
+        catch {
+            memory.durableCheckpoint = undefined;
+        }
+    }
+    refreshResumeCheckpoint(memory);
+    memory.task.currentTurnIndex = taskRow.latest_turn_index > 0 ? taskRow.latest_turn_index : undefined;
+    memory.session.initialQuery = userQuery;
+    return memory;
+}
+//# sourceMappingURL=hydrate.js.map

package/dist/agent/persistence/hydrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.js","sourceRoot":"","sources":["../../../src/agent/persistence/hydrate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,UAAU,kBAAkB,CAChC,UAAoC,EACpC,OAA8B,EAC9B,SAAiB;IAEjB,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,IAAI,UAAU,CAAC,cAAc,IAAI,EAAE,CAAC;IAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,UAAU,CAAC,aAAa,IAAI,UAAU,CAAC,cAAc,IAAI,YAAY,CAAC;IACrH,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACrF,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;IAClC,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IAC3C,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAuC,CAAC;IACrE,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,CAAC,iBAAiB,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;QACrF,IAAI,CAAC;YACH,MAAM,CAAC,iBAAiB,GAAG;gBACzB,WAAW,EAAE,OAAO,CAAC,OAAO;gBAC5B,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,wBAAwB,CAAsB;gBACpF,eAAe,EAAE,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;gBACtF,eAAe,EAAE,OAAO,CAAC,aAAa;aACvC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACvC,CAAC;IACH,CAAC;IACD,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IACrG,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Rebuilds modular-agent memory from persisted rows and the compact snapshot.\n *\n * Why this file exists:\n * - DB rows and runtime memory should meet in one place\n * - resume hydration rules should stay out of task boot and SQL helpers\n * - command read models should not depend on full runtime hydration\n */\nimport { createAgentMemory } from \"../state/memory.js\";\nimport type { AgentMemory, FinalAnswerPacket } from \"../types.js\";\nimport type { PersistedAgentSessionRow, PersistedAgentTaskRow } from \"./tasks.js\";\nimport { applyAgentSnapshot, parseAgentSnapshot } from \"./snapshots.js\";\nimport { refreshResumeCheckpoint } from \"../resume/checkpoint.js\";\n\nexport function hydrateAgentMemory(\n  sessionRow: PersistedAgentSessionRow,\n  taskRow: PersistedAgentTaskRow,\n  userQuery: string\n): AgentMemory {\n  const repoRootPath = taskRow.repo_root_path ?? sessionRow.repo_root_path ?? \"\";\n  const executionPath = taskRow.worktree_path ?? sessionRow.worktree_path ?? sessionRow.execution_path ?? repoRootPath;\n  const memory = createAgentMemory(taskRow.initial_query, repoRootPath, executionPath);\n  memory.session.id = sessionRow.id;\n  memory.session.repoRootPath = repoRootPath;\n  memory.session.executionPath = executionPath;\n  memory.session.initialQuery = taskRow.initial_query;\n  memory.task.id = taskRow.id;\n  memory.task.initialQuery = taskRow.initial_query;\n  memory.task.status = taskRow.status as AgentMemory[\"task\"][\"status\"];\n  applyAgentSnapshot(memory, parseAgentSnapshot(taskRow.snapshot_json));\n  if (!memory.durableCheckpoint && taskRow.summary && taskRow.final_answer_packet_json) {\n    try {\n      memory.durableCheckpoint = {\n        finalAnswer: taskRow.summary,\n        finalAnswerPacket: JSON.parse(taskRow.final_answer_packet_json) as FinalAnswerPacket,\n        sourceTurnIndex: taskRow.latest_turn_index > 0 ? taskRow.latest_turn_index : undefined,\n        sourceUserQuery: taskRow.initial_query,\n      };\n    } catch {\n      memory.durableCheckpoint = undefined;\n    }\n  }\n  refreshResumeCheckpoint(memory);\n  memory.task.currentTurnIndex = taskRow.latest_turn_index > 0 ? taskRow.latest_turn_index : undefined;\n  memory.session.initialQuery = userQuery;\n  return memory;\n}\n"]}

package/dist/agent/persistence/index.js

@@ -0,0 +1,15 @@
+/**
+ * Exposes the narrow public persistence API for the modular agent runtime.
+ *
+ * Why this file exists:
+ * - runtime and command code should depend on one small persistence surface
+ * - deeper SQL, snapshot, and hydration helpers should stay hidden behind this index
+ * - this module is the new-agent owner for durable task state
+ */
+export { beginAgentTurn, bootAgentTask, loadAgentTask, resolveAgentResumeTaskId, } from "./boot.js";
+export { clearCurrentAgentTask, getCurrentAgentTaskId, setCurrentAgentTask, } from "./currentTask.js";
+export { getCurrentAgentTaskDetails, getAgentTaskDetails, listAgentTasks, loadPersistedAgentSession, loadPersistedAgentTask, persistAgentSnapshot, persistAgentTask, } from "./tasks.js";
+export { listAgentSteps, persistAgentStep, persistAgentSteps, } from "./steps.js";
+export { buildAgentSnapshot, parseAgentSnapshot, } from "./snapshots.js";
+export { finishAgentTurn, listAgentTurns, startAgentTurn, } from "./turns.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/persistence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,wBAAwB,GAEzB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,GAGjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,GAGf,MAAM,YAAY,CAAC","sourcesContent":["/**\n * Exposes the narrow public persistence API for the modular agent runtime.\n *\n * Why this file exists:\n * - runtime and command code should depend on one small persistence surface\n * - deeper SQL, snapshot, and hydration helpers should stay hidden behind this index\n * - this module is the new-agent owner for durable task state\n */\nexport {\n  beginAgentTurn,\n  bootAgentTask,\n  loadAgentTask,\n  resolveAgentResumeTaskId,\n  type AgentBootOptions,\n} from \"./boot.js\";\nexport {\n  clearCurrentAgentTask,\n  getCurrentAgentTaskId,\n  setCurrentAgentTask,\n} from \"./currentTask.js\";\nexport {\n  getCurrentAgentTaskDetails,\n  getAgentTaskDetails,\n  listAgentTasks,\n  loadPersistedAgentSession,\n  loadPersistedAgentTask,\n  persistAgentSnapshot,\n  persistAgentTask,\n  type AgentTaskDetails,\n  type AgentTaskListItem,\n} from \"./tasks.js\";\nexport {\n  listAgentSteps,\n  persistAgentStep,\n  persistAgentSteps,\n  type PersistedAgentStepRecord,\n} from \"./steps.js\";\nexport {\n  buildAgentSnapshot,\n  parseAgentSnapshot,\n} from \"./snapshots.js\";\nexport {\n  finishAgentTurn,\n  listAgentTurns,\n  startAgentTurn,\n  type AgentTurnQueryKind,\n  type AgentTurnRecord,\n} from \"./turns.js\";\n"]}

package/dist/agent/persistence/snapshots.js

@@ -0,0 +1,97 @@
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export function buildAgentSnapshot(memory) {
+    return {
+        task: {
+            mode: memory.task.mode,
+            normalizedQuery: memory.task.normalizedQuery,
+            ...(memory.task.stopReason ? { stopReason: memory.task.stopReason } : {}),
+            ...(memory.task.dialogState ? { dialogState: cloneJson(memory.task.dialogState) } : {}),
+            primaryIntent: memory.task.primaryIntent,
+            alternativeIntents: cloneJson(memory.task.alternativeIntents),
+            searchTermGroups: cloneJson(memory.task.searchTermGroups),
+            ambiguityFlags: cloneJson(memory.task.ambiguityFlags),
+            queryScope: memory.task.queryScope,
+            explicitTargets: cloneJson(memory.task.explicitTargets),
+            explicitTargetOverrides: cloneJson(memory.task.explicitTargetOverrides),
+            hardFileTargets: cloneJson(memory.task.hardFileTargets),
+            softHints: cloneJson(memory.task.softHints),
+            constraints: cloneJson(memory.task.constraints),
+            turnCount: memory.task.turnCount,
+            replanCount: memory.task.replanCount,
+            maxTurns: memory.task.maxTurns,
+            ...(memory.task.currentStepId ? { currentStepId: memory.task.currentStepId } : {}),
+        },
+        evidence: {
+            candidateFiles: cloneJson(memory.evidence.candidateFiles),
+            ...(memory.evidence.candidateMetadata ? { candidateMetadata: cloneJson(memory.evidence.candidateMetadata) } : {}),
+            ...(memory.evidence.targetResolutions ? { targetResolutions: cloneJson(memory.evidence.targetResolutions) } : {}),
+            fileReads: cloneJson(memory.evidence.fileReads),
+            notes: cloneJson(memory.evidence.notes),
+        },
+        artifacts: {
+            ...(memory.artifacts.understand ? { understand: cloneJson(memory.artifacts.understand) } : {}),
+            plans: cloneJson(memory.artifacts.plans),
+            ...(memory.artifacts.latestFinalAnswerPacket ? { latestFinalAnswerPacket: cloneJson(memory.artifacts.latestFinalAnswerPacket) } : {}),
+            ...(memory.artifacts.finalAnswer ? { finalAnswer: memory.artifacts.finalAnswer } : {}),
+            ...(memory.artifacts.stopMessage ? { stopMessage: memory.artifacts.stopMessage } : {}),
+            ...(memory.artifacts.transform ? { transform: cloneJson(memory.artifacts.transform) } : {}),
+        },
+        ...(memory.durableCheckpoint ? { durableCheckpoint: cloneJson(memory.durableCheckpoint) } : {}),
+        steps: cloneJson(memory.steps),
+    };
+}
+export function parseAgentSnapshot(snapshotJson) {
+    if (!snapshotJson) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(snapshotJson);
+        return parsed && typeof parsed === "object" ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function applyAgentSnapshot(memory, snapshot) {
+    if (!snapshot) {
+        return;
+    }
+    memory.task.mode = snapshot.task.mode;
+    memory.task.normalizedQuery = snapshot.task.normalizedQuery;
+    memory.task.stopReason = snapshot.task.stopReason;
+    memory.task.dialogState = snapshot.task.dialogState;
+    memory.task.primaryIntent = snapshot.task.primaryIntent;
+    memory.task.alternativeIntents = snapshot.task.alternativeIntents;
+    memory.task.searchTermGroups = snapshot.task.searchTermGroups;
+    memory.task.ambiguityFlags = snapshot.task.ambiguityFlags;
+    memory.task.queryScope = snapshot.task.queryScope;
+    memory.task.explicitTargets = snapshot.task.explicitTargets;
+    memory.task.explicitTargetOverrides = snapshot.task.explicitTargetOverrides;
+    memory.task.hardFileTargets = snapshot.task.hardFileTargets;
+    memory.task.softHints = snapshot.task.softHints;
+    memory.task.constraints = snapshot.task.constraints;
+    memory.task.turnCount = snapshot.task.turnCount;
+    memory.task.replanCount = snapshot.task.replanCount;
+    memory.task.maxTurns = snapshot.task.maxTurns;
+    memory.task.currentStepId = snapshot.task.currentStepId;
+    memory.evidence.candidateFiles = snapshot.evidence.candidateFiles;
+    memory.evidence.candidateMetadata = snapshot.evidence.candidateMetadata;
+    memory.evidence.targetResolutions = snapshot.evidence.targetResolutions;
+    memory.evidence.fileReads = snapshot.evidence.fileReads;
+    memory.evidence.notes = snapshot.evidence.notes;
+    memory.evidence.searches = [];
+    memory.artifacts.understand = snapshot.artifacts.understand;
+    memory.artifacts.plans = snapshot.artifacts.plans;
+    memory.artifacts.latestFinalAnswerPacket = snapshot.artifacts.latestFinalAnswerPacket;
+    memory.artifacts.finalAnswer = snapshot.artifacts.finalAnswer;
+    memory.artifacts.stopMessage = snapshot.artifacts.stopMessage;
+    memory.artifacts.transform = snapshot.artifacts.transform;
+    memory.artifacts.actionResults = {};
+    memory.durableCheckpoint = snapshot.durableCheckpoint;
+    memory.resumeCheckpoint = snapshot.durableCheckpoint;
+    memory.steps = snapshot.steps;
+    memory.events = [];
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/agent/persistence/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../../../src/agent/persistence/snapshots.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Builds and restores the compact persisted state for the modular agent runtime.\n *\n * Why this file exists:\n * - resumed runs need a small trusted snapshot instead of a broad legacy blob\n * - the final-answer packet should survive resume without carrying transient loop state\n * - persistence shape should stay separate from SQL and task boot logic\n */\nimport type {\n  AgentCandidateMetadata,\n  AgentDialogState,\n  AgentMemory,\n  AgentPlanArtifact,\n  AgentResumeCheckpoint,\n  AgentReadEvidence,\n  AgentStep,\n  AgentTargetResolution,\n  AgentTransformStore,\n  FinalAnswerPacket,\n  UnderstandResult,\n} from \"../types.js\";\n\ntype PersistedTaskSnapshot = {\n  task: {\n    mode: AgentMemory[\"task\"][\"mode\"];\n    normalizedQuery: string;\n    stopReason?: string;\n    dialogState?: AgentDialogState;\n    primaryIntent: string;\n    alternativeIntents: string[];\n    searchTermGroups: AgentMemory[\"task\"][\"searchTermGroups\"];\n    ambiguityFlags: string[];\n    queryScope: AgentMemory[\"task\"][\"queryScope\"];\n    explicitTargets: string[];\n    explicitTargetOverrides: Record<string, string>;\n    hardFileTargets: string[];\n    softHints: string[];\n    constraints: string[];\n    turnCount: number;\n    replanCount: number;\n    maxTurns: number;\n    currentStepId?: string;\n  };\n  evidence: {\n    candidateFiles: string[];\n    candidateMetadata?: Record<string, AgentCandidateMetadata>;\n    targetResolutions?: Record<string, AgentTargetResolution>;\n    fileReads: Record<string, AgentReadEvidence>;\n    notes: string[];\n  };\n  artifacts: {\n    understand?: UnderstandResult;\n    plans: AgentPlanArtifact[];\n    latestFinalAnswerPacket?: FinalAnswerPacket;\n    finalAnswer?: string;\n    stopMessage?: string;\n    transform?: AgentTransformStore;\n  };\n  durableCheckpoint?: AgentResumeCheckpoint;\n  steps: AgentStep[];\n};\n\nfunction cloneJson<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nexport function buildAgentSnapshot(memory: AgentMemory): PersistedTaskSnapshot {\n  return {\n    task: {\n      mode: memory.task.mode,\n      normalizedQuery: memory.task.normalizedQuery,\n      ...(memory.task.stopReason ? { stopReason: memory.task.stopReason } : {}),\n      ...(memory.task.dialogState ? { dialogState: cloneJson(memory.task.dialogState) } : {}),\n      primaryIntent: memory.task.primaryIntent,\n      alternativeIntents: cloneJson(memory.task.alternativeIntents),\n      searchTermGroups: cloneJson(memory.task.searchTermGroups),\n      ambiguityFlags: cloneJson(memory.task.ambiguityFlags),\n      queryScope: memory.task.queryScope,\n      explicitTargets: cloneJson(memory.task.explicitTargets),\n      explicitTargetOverrides: cloneJson(memory.task.explicitTargetOverrides),\n      hardFileTargets: cloneJson(memory.task.hardFileTargets),\n      softHints: cloneJson(memory.task.softHints),\n      constraints: cloneJson(memory.task.constraints),\n      turnCount: memory.task.turnCount,\n      replanCount: memory.task.replanCount,\n      maxTurns: memory.task.maxTurns,\n      ...(memory.task.currentStepId ? { currentStepId: memory.task.currentStepId } : {}),\n    },\n    evidence: {\n      candidateFiles: cloneJson(memory.evidence.candidateFiles),\n      ...(memory.evidence.candidateMetadata ? { candidateMetadata: cloneJson(memory.evidence.candidateMetadata) } : {}),\n      ...(memory.evidence.targetResolutions ? { targetResolutions: cloneJson(memory.evidence.targetResolutions) } : {}),\n      fileReads: cloneJson(memory.evidence.fileReads),\n      notes: cloneJson(memory.evidence.notes),\n    },\n    artifacts: {\n      ...(memory.artifacts.understand ? { understand: cloneJson(memory.artifacts.understand) } : {}),\n      plans: cloneJson(memory.artifacts.plans),\n      ...(memory.artifacts.latestFinalAnswerPacket ? { latestFinalAnswerPacket: cloneJson(memory.artifacts.latestFinalAnswerPacket) } : {}),\n      ...(memory.artifacts.finalAnswer ? { finalAnswer: memory.artifacts.finalAnswer } : {}),\n      ...(memory.artifacts.stopMessage ? { stopMessage: memory.artifacts.stopMessage } : {}),\n      ...(memory.artifacts.transform ? { transform: cloneJson(memory.artifacts.transform) } : {}),\n    },\n    ...(memory.durableCheckpoint ? { durableCheckpoint: cloneJson(memory.durableCheckpoint) } : {}),\n    steps: cloneJson(memory.steps),\n  };\n}\n\nexport function parseAgentSnapshot(snapshotJson: string | null | undefined): PersistedTaskSnapshot | undefined {\n  if (!snapshotJson) {\n    return undefined;\n  }\n  try {\n    const parsed = JSON.parse(snapshotJson) as PersistedTaskSnapshot;\n    return parsed && typeof parsed === \"object\" ? parsed : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function applyAgentSnapshot(memory: AgentMemory, snapshot: PersistedTaskSnapshot | undefined): void {\n  if (!snapshot) {\n    return;\n  }\n  memory.task.mode = snapshot.task.mode;\n  memory.task.normalizedQuery = snapshot.task.normalizedQuery;\n  memory.task.stopReason = snapshot.task.stopReason;\n  memory.task.dialogState = snapshot.task.dialogState;\n  memory.task.primaryIntent = snapshot.task.primaryIntent;\n  memory.task.alternativeIntents = snapshot.task.alternativeIntents;\n  memory.task.searchTermGroups = snapshot.task.searchTermGroups;\n  memory.task.ambiguityFlags = snapshot.task.ambiguityFlags;\n  memory.task.queryScope = snapshot.task.queryScope;\n  memory.task.explicitTargets = snapshot.task.explicitTargets;\n  memory.task.explicitTargetOverrides = snapshot.task.explicitTargetOverrides;\n  memory.task.hardFileTargets = snapshot.task.hardFileTargets;\n  memory.task.softHints = snapshot.task.softHints;\n  memory.task.constraints = snapshot.task.constraints;\n  memory.task.turnCount = snapshot.task.turnCount;\n  memory.task.replanCount = snapshot.task.replanCount;\n  memory.task.maxTurns = snapshot.task.maxTurns;\n  memory.task.currentStepId = snapshot.task.currentStepId;\n\n  memory.evidence.candidateFiles = snapshot.evidence.candidateFiles;\n  memory.evidence.candidateMetadata = snapshot.evidence.candidateMetadata;\n  memory.evidence.targetResolutions = snapshot.evidence.targetResolutions;\n  memory.evidence.fileReads = snapshot.evidence.fileReads;\n  memory.evidence.notes = snapshot.evidence.notes;\n  memory.evidence.searches = [];\n\n  memory.artifacts.understand = snapshot.artifacts.understand;\n  memory.artifacts.plans = snapshot.artifacts.plans;\n  memory.artifacts.latestFinalAnswerPacket = snapshot.artifacts.latestFinalAnswerPacket;\n  memory.artifacts.finalAnswer = snapshot.artifacts.finalAnswer;\n  memory.artifacts.stopMessage = snapshot.artifacts.stopMessage;\n  memory.artifacts.transform = snapshot.artifacts.transform;\n  memory.artifacts.actionResults = {};\n  memory.durableCheckpoint = snapshot.durableCheckpoint;\n  memory.resumeCheckpoint = snapshot.durableCheckpoint;\n\n  memory.steps = snapshot.steps;\n  memory.events = [];\n}\n"]}

package/dist/agent/persistence/steps.js

@@ -0,0 +1,95 @@
+/**
+ * Owns persisted step history for the modular agent runtime.
+ *
+ * Why this file exists:
+ * - step rows should stay append-only in concept even when they are upserted by runtime step id
+ * - command read models should not understand runtime step serialization details
+ * - task persistence should not mix turn rows with step rows
+ */
+import { getDbForRepo } from "../../db/client.js";
+function stepTargetLabel(step) {
+    const target = typeof step.args.target === "string" ? step.args.target.trim() : "";
+    if (target) {
+        return target;
+    }
+    const query = typeof step.args.query === "string" ? step.args.query.trim() : "";
+    return query || "";
+}
+function parseJson(value) {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function persistAgentStep(memory, step, db = getDbForRepo()) {
+    const now = new Date().toISOString();
+    const createdAtMs = step.startedAt ? Date.parse(step.startedAt) : null;
+    const completedAtMs = step.completedAt ? Date.parse(step.completedAt) : null;
+    db.prepare(`
+    INSERT INTO steps(
+      task_id,
+      runtime_step_id,
+      file_path,
+      action,
+      args_json,
+      purpose,
+      expected_evidence_json,
+      status,
+      start_time,
+      end_time,
+      result_json,
+      result_summary,
+      notes,
+      step_index,
+      step_questions_json,
+      created_at,
+      updated_at
+    )
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, ?, NULL, ?, NULL, ?, ?)
+    ON CONFLICT(task_id, runtime_step_id) DO UPDATE SET
+      file_path = excluded.file_path,
+      action = excluded.action,
+      args_json = excluded.args_json,
+      purpose = excluded.purpose,
+      expected_evidence_json = excluded.expected_evidence_json,
+      status = excluded.status,
+      start_time = excluded.start_time,
+      end_time = excluded.end_time,
+      result_summary = excluded.result_summary,
+      step_index = excluded.step_index,
+      updated_at = excluded.updated_at
+  `).run(memory.task.id, step.id, stepTargetLabel(step), step.action, JSON.stringify(step.args), step.purpose, JSON.stringify(step.expectedEvidence), step.status, Number.isFinite(createdAtMs) ? createdAtMs : null, Number.isFinite(completedAtMs) ? completedAtMs : null, step.resultSummary ?? null, memory.steps.indexOf(step) + 1, step.createdAt, now);
+}
+export function persistAgentSteps(memory, db = getDbForRepo()) {
+    for (const step of memory.steps) {
+        persistAgentStep(memory, step, db);
+    }
+}
+export function listAgentSteps(taskId, db = getDbForRepo()) {
+    const rows = db.prepare(`
+    SELECT *
+    FROM steps
+    WHERE task_id = ?
+    ORDER BY step_index ASC, id ASC
+  `).all(taskId);
+    return rows.map((row) => ({
+        id: row.id,
+        runtimeStepId: row.runtime_step_id,
+        filePath: row.file_path,
+        ...(row.action ? { action: row.action } : {}),
+        status: row.status,
+        ...(typeof row.step_index === "number" ? { stepIndex: row.step_index } : {}),
+        ...(parseJson(row.args_json) ? { args: parseJson(row.args_json) } : {}),
+        ...(row.purpose ? { purpose: row.purpose } : {}),
+        ...(parseJson(row.expected_evidence_json) ? { expectedEvidence: parseJson(row.expected_evidence_json) } : {}),
+        ...(row.result_summary ? { resultSummary: row.result_summary } : {}),
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    }));
+}
+//# sourceMappingURL=steps.js.map

package/dist/agent/persistence/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../../src/agent/persistence/steps.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Owns persisted step history for the modular agent runtime.\n *\n * Why this file exists:\n * - step rows should stay append-only in concept even when they are upserted by runtime step id\n * - command read models should not understand runtime step serialization details\n * - task persistence should not mix turn rows with step rows\n */\nimport { getDbForRepo } from \"../../db/client.js\";\nimport type { AgentMemory, AgentStep } from \"../types.js\";\n\nexport type PersistedAgentStepRecord = {\n  id: number;\n  runtimeStepId: string;\n  filePath: string;\n  action?: string;\n  status: string;\n  stepIndex?: number;\n  args?: Record<string, unknown>;\n  purpose?: string;\n  expectedEvidence?: string[];\n  resultSummary?: string;\n  createdAt: string;\n  updatedAt: string;\n};\n\nfunction stepTargetLabel(step: AgentStep): string {\n  const target = typeof step.args.target === \"string\" ? step.args.target.trim() : \"\";\n  if (target) {\n    return target;\n  }\n  const query = typeof step.args.query === \"string\" ? step.args.query.trim() : \"\";\n  return query || \"\";\n}\n\nfunction parseJson<T>(value: string | null | undefined): T | undefined {\n  if (!value) {\n    return undefined;\n  }\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function persistAgentStep(memory: AgentMemory, step: AgentStep, db = getDbForRepo()): void {\n  const now = new Date().toISOString();\n  const createdAtMs = step.startedAt ? Date.parse(step.startedAt) : null;\n  const completedAtMs = step.completedAt ? Date.parse(step.completedAt) : null;\n  db.prepare(`\n    INSERT INTO steps(\n      task_id,\n      runtime_step_id,\n      file_path,\n      action,\n      args_json,\n      purpose,\n      expected_evidence_json,\n      status,\n      start_time,\n      end_time,\n      result_json,\n      result_summary,\n      notes,\n      step_index,\n      step_questions_json,\n      created_at,\n      updated_at\n    )\n    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, ?, NULL, ?, NULL, ?, ?)\n    ON CONFLICT(task_id, runtime_step_id) DO UPDATE SET\n      file_path = excluded.file_path,\n      action = excluded.action,\n      args_json = excluded.args_json,\n      purpose = excluded.purpose,\n      expected_evidence_json = excluded.expected_evidence_json,\n      status = excluded.status,\n      start_time = excluded.start_time,\n      end_time = excluded.end_time,\n      result_summary = excluded.result_summary,\n      step_index = excluded.step_index,\n      updated_at = excluded.updated_at\n  `).run(\n    memory.task.id,\n    step.id,\n    stepTargetLabel(step),\n    step.action,\n    JSON.stringify(step.args),\n    step.purpose,\n    JSON.stringify(step.expectedEvidence),\n    step.status,\n    Number.isFinite(createdAtMs) ? createdAtMs : null,\n    Number.isFinite(completedAtMs) ? completedAtMs : null,\n    step.resultSummary ?? null,\n    memory.steps.indexOf(step) + 1,\n    step.createdAt,\n    now\n  );\n}\n\nexport function persistAgentSteps(memory: AgentMemory, db = getDbForRepo()): void {\n  for (const step of memory.steps) {\n    persistAgentStep(memory, step, db);\n  }\n}\n\nexport function listAgentSteps(taskId: number, db = getDbForRepo()): PersistedAgentStepRecord[] {\n  const rows = db.prepare(`\n    SELECT *\n    FROM steps\n    WHERE task_id = ?\n    ORDER BY step_index ASC, id ASC\n  `).all(taskId) as Array<{\n    id: number;\n    runtime_step_id: string;\n    file_path: string;\n    action?: string | null;\n    args_json?: string | null;\n    purpose?: string | null;\n    expected_evidence_json?: string | null;\n    status: string;\n    result_summary?: string | null;\n    step_index?: number | null;\n    created_at: string;\n    updated_at: string;\n  }>;\n  return rows.map((row) => ({\n    id: row.id,\n    runtimeStepId: row.runtime_step_id,\n    filePath: row.file_path,\n    ...(row.action ? { action: row.action } : {}),\n    status: row.status,\n    ...(typeof row.step_index === \"number\" ? { stepIndex: row.step_index } : {}),\n    ...(parseJson<Record<string, unknown>>(row.args_json) ? { args: parseJson<Record<string, unknown>>(row.args_json)! } : {}),\n    ...(row.purpose ? { purpose: row.purpose } : {}),\n    ...(parseJson<string[]>(row.expected_evidence_json) ? { expectedEvidence: parseJson<string[]>(row.expected_evidence_json)! } : {}),\n    ...(row.result_summary ? { resultSummary: row.result_summary } : {}),\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n  }));\n}\n"]}

package/dist/agent/persistence/tasks.js

@@ -0,0 +1,195 @@
+/**
+ * Owns task and session rows for the modular agent runtime.
+ *
+ * Why this file exists:
+ * - task boot, latest task state, and task read models should stay together
+ * - command code should not know task table columns or join details
+ * - latest task state is different from turn history and step history
+ */
+import { getDbForRepo } from "../../db/client.js";
+import { resolveCanonicalRepoIdentity } from "../../utils/repoIdentity.js";
+import { createDurableCheckpointFromArtifacts } from "../resume/checkpoint.js";
+import { buildAgentSnapshot } from "./snapshots.js";
+function parseJson(value) {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function ensureProjectId(db, repoRootPath, now) {
+    const existing = db.prepare(`SELECT id FROM projects WHERE repo_path = ?`).get(repoRootPath);
+    if (existing?.id) {
+        return existing.id;
+    }
+    const inserted = db.prepare(`
+    INSERT INTO projects(repo_path, name, created_at, updated_at)
+    VALUES(?, ?, ?, ?)
+  `).run(repoRootPath, "Default Project", now, now);
+    return inserted.lastInsertRowid;
+}
+export function createAgentSession(memory, db = getDbForRepo()) {
+    const now = new Date().toISOString();
+    const identity = resolveCanonicalRepoIdentity();
+    const projectId = ensureProjectId(db, identity.repoRootPath, now);
+    const inserted = db.prepare(`
+    INSERT INTO sessions(
+      project_id,
+      host_type,
+      active_task_id,
+      repo_root_path,
+      execution_path,
+      worktree_path,
+      status,
+      created_at,
+      updated_at
+    )
+    VALUES (?, ?, NULL, ?, ?, ?, ?, ?, ?)
+  `).run(projectId, "cli", identity.repoRootPath, identity.executionPath, identity.worktreePath ?? null, "active", now, now);
+    memory.session.id = inserted.lastInsertRowid;
+    memory.session.repoRootPath = identity.repoRootPath;
+    memory.session.executionPath = identity.executionPath;
+    return projectId;
+}
+export function createAgentTask(memory, projectId, db = getDbForRepo()) {
+    const now = new Date().toISOString();
+    const identity = resolveCanonicalRepoIdentity();
+    const inserted = db.prepare(`
+    INSERT INTO tasks(
+      session_id,
+      project_id,
+      runtime,
+      status,
+      initial_query,
+      summary,
+      final_answer_packet_json,
+      normalized_query,
+      dialog_state_json,
+      relevant_files_json,
+      missing_files_json,
+      repo_root_path,
+      worktree_path,
+      worktree_branch,
+      worktree_name,
+      base_branch,
+      snapshot_json,
+      current_step_id,
+      latest_turn_id,
+      latest_turn_index,
+      created_at,
+      updated_at
+    )
+    VALUES (?, ?, 'agent', ?, ?, NULL, NULL, ?, NULL, '[]', '[]', ?, ?, ?, ?, ?, NULL, NULL, NULL, 0, ?, ?)
+  `).run(memory.session.id, projectId, memory.task.status, memory.task.initialQuery, memory.task.normalizedQuery, identity.repoRootPath, identity.worktreePath ?? null, identity.worktreePath ? identity.currentBranch ?? null : null, null, identity.currentBranch ?? null, now, now);
+    memory.task.id = inserted.lastInsertRowid;
+}
+export function loadPersistedAgentTask(taskId, db = getDbForRepo()) {
+    return db.prepare(`
+    SELECT *
+    FROM tasks
+    WHERE id = ? AND runtime = 'agent'
+  `).get(taskId);
+}
+export function loadPersistedAgentSession(sessionId, db = getDbForRepo()) {
+    return db.prepare(`
+    SELECT *
+    FROM sessions
+    WHERE id = ?
+  `).get(sessionId);
+}
+export function persistAgentTask(memory, db = getDbForRepo()) {
+    const now = new Date().toISOString();
+    memory.durableCheckpoint = createDurableCheckpointFromArtifacts(memory);
+    const snapshot = buildAgentSnapshot(memory);
+    const latestGrounded = memory.durableCheckpoint;
+    const latestPacket = latestGrounded?.finalAnswerPacket;
+    const latestAnswer = latestGrounded?.finalAnswer;
+    const relevantFiles = latestPacket?.mustMentionFiles ?? Object.keys(memory.evidence.fileReads).slice(0, 8);
+    const worktreePath = memory.session.executionPath !== memory.session.repoRootPath
+        ? memory.session.executionPath
+        : null;
+    db.prepare(`
+    UPDATE tasks
+    SET status = ?,
+        summary = ?,
+        final_answer_packet_json = ?,
+        normalized_query = ?,
+        dialog_state_json = ?,
+        relevant_files_json = ?,
+        missing_files_json = ?,
+        repo_root_path = ?,
+        worktree_path = COALESCE(?, worktree_path),
+        resume_context_json = NULL,
+        snapshot_json = ?,
+        current_step_id = ?,
+        latest_turn_id = ?,
+        latest_turn_index = ?,
+        updated_at = ?
+    WHERE id = ?
+  `).run(memory.task.status, latestAnswer ?? null, latestPacket ? JSON.stringify(latestPacket) : null, memory.task.normalizedQuery, memory.task.dialogState ? JSON.stringify(memory.task.dialogState) : null, JSON.stringify(relevantFiles), JSON.stringify([]), memory.session.repoRootPath, worktreePath, JSON.stringify(snapshot), memory.task.currentStepId ?? null, memory.task.currentTurnId ?? null, memory.task.currentTurnIndex ?? 0, now, memory.task.id);
+    db.prepare(`
+    UPDATE sessions
+    SET active_task_id = ?, repo_root_path = ?, execution_path = ?, worktree_path = ?, status = ?, updated_at = ?
+    WHERE id = ?
+  `).run(memory.task.id, memory.session.repoRootPath, memory.session.executionPath, null, memory.task.status === "done" ? "completed" : "active", now, memory.session.id);
+}
+export function persistAgentSnapshot(memory, db = getDbForRepo()) {
+    memory.durableCheckpoint = createDurableCheckpointFromArtifacts(memory);
+    db.prepare(`
+    UPDATE tasks
+    SET snapshot_json = ?, updated_at = ?
+    WHERE id = ?
+  `).run(JSON.stringify(buildAgentSnapshot(memory)), new Date().toISOString(), memory.task.id);
+}
+export function listAgentTasks(db = getDbForRepo()) {
+    const rows = db.prepare(`
+    SELECT id, status, initial_query, latest_turn_index, created_at, updated_at
+    FROM tasks
+    WHERE runtime = 'agent'
+    ORDER BY id DESC
+  `).all();
+    return rows.map((row) => ({
+        id: row.id,
+        status: row.status,
+        initialQuery: row.initial_query,
+        latestTurnIndex: row.latest_turn_index,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    }));
+}
+export function getAgentTaskDetails(taskId, db = getDbForRepo()) {
+    const row = loadPersistedAgentTask(taskId, db);
+    if (!row) {
+        return undefined;
+    }
+    return {
+        id: row.id,
+        sessionId: row.session_id,
+        status: row.status,
+        initialQuery: row.initial_query,
+        ...(row.summary ? { finalAnswer: row.summary } : {}),
+        ...(parseJson(row.final_answer_packet_json) ? { latestFinalAnswerPacket: parseJson(row.final_answer_packet_json) } : {}),
+        ...(parseJson(row.dialog_state_json) ? { dialogState: parseJson(row.dialog_state_json) } : {}),
+        ...(row.repo_root_path ? { repoRootPath: row.repo_root_path } : {}),
+        ...(row.worktree_path ? { worktreePath: row.worktree_path } : {}),
+        ...(row.worktree_branch ? { worktreeBranch: row.worktree_branch } : {}),
+        ...(row.worktree_name ? { worktreeName: row.worktree_name } : {}),
+        ...(row.base_branch ? { baseBranch: row.base_branch } : {}),
+        ...(row.current_step_id ? { currentStepId: row.current_step_id } : {}),
+        latestTurnIndex: row.latest_turn_index,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+export function getCurrentAgentTaskDetails(db = getDbForRepo()) {
+    const row = db.prepare(`SELECT current_task_id FROM global_state WHERE id = 1`).get();
+    if (!row?.current_task_id) {
+        return undefined;
+    }
+    return getAgentTaskDetails(row.current_task_id, db);
+}
+//# sourceMappingURL=tasks.js.map

package/dist/agent/persistence/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/agent/persistence/tasks.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Owns task and session rows for the modular agent runtime.\n *\n * Why this file exists:\n * - task boot, latest task state, and task read models should stay together\n * - command code should not know task table columns or join details\n * - latest task state is different from turn history and step history\n */\nimport { getDbForRepo } from \"../../db/client.js\";\nimport { resolveCanonicalRepoIdentity } from \"../../utils/repoIdentity.js\";\nimport { createDurableCheckpointFromArtifacts } from \"../resume/checkpoint.js\";\nimport type { AgentMemory, FinalAnswerPacket } from \"../types.js\";\nimport { buildAgentSnapshot } from \"./snapshots.js\";\n\nexport type PersistedAgentSessionRow = {\n  id: number;\n  project_id: number;\n  active_task_id?: number | null;\n  repo_root_path?: string | null;\n  execution_path?: string | null;\n  worktree_path?: string | null;\n  status: string;\n  created_at: string;\n  updated_at: string;\n};\n\nexport type PersistedAgentTaskRow = {\n  id: number;\n  session_id: number;\n  project_id: number;\n  runtime: string;\n  status: string;\n  initial_query: string;\n  summary?: string | null;\n  final_answer_packet_json?: string | null;\n  normalized_query?: string | null;\n  dialog_state_json?: string | null;\n  relevant_files_json?: string | null;\n  missing_files_json?: string | null;\n  repo_root_path?: string | null;\n  worktree_path?: string | null;\n  worktree_branch?: string | null;\n  worktree_name?: string | null;\n  base_branch?: string | null;\n  snapshot_json?: string | null;\n  current_step_id?: string | null;\n  latest_turn_id?: number | null;\n  latest_turn_index: number;\n  created_at: string;\n  updated_at: string;\n};\n\nexport type AgentTaskListItem = {\n  id: number;\n  status: string;\n  initialQuery: string;\n  createdAt: string;\n  updatedAt: string;\n  latestTurnIndex: number;\n};\n\nexport type AgentTaskDetails = {\n  id: number;\n  sessionId: number;\n  status: string;\n  initialQuery: string;\n  finalAnswer?: string;\n  latestFinalAnswerPacket?: FinalAnswerPacket;\n  dialogState?: AgentMemory[\"task\"][\"dialogState\"];\n  repoRootPath?: string;\n  worktreePath?: string;\n  worktreeBranch?: string;\n  worktreeName?: string;\n  baseBranch?: string;\n  currentStepId?: string;\n  latestTurnIndex: number;\n  createdAt: string;\n  updatedAt: string;\n};\n\nfunction parseJson<T>(value: string | null | undefined): T | undefined {\n  if (!value) {\n    return undefined;\n  }\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ensureProjectId(db: any, repoRootPath: string, now: string): number {\n  const existing = db.prepare(`SELECT id FROM projects WHERE repo_path = ?`).get(repoRootPath) as { id: number } | undefined;\n  if (existing?.id) {\n    return existing.id;\n  }\n  const inserted = db.prepare(`\n    INSERT INTO projects(repo_path, name, created_at, updated_at)\n    VALUES(?, ?, ?, ?)\n  `).run(repoRootPath, \"Default Project\", now, now);\n  return inserted.lastInsertRowid as number;\n}\n\nexport function createAgentSession(memory: AgentMemory, db = getDbForRepo()): number {\n  const now = new Date().toISOString();\n  const identity = resolveCanonicalRepoIdentity();\n  const projectId = ensureProjectId(db, identity.repoRootPath, now);\n  const inserted = db.prepare(`\n    INSERT INTO sessions(\n      project_id,\n      host_type,\n      active_task_id,\n      repo_root_path,\n      execution_path,\n      worktree_path,\n      status,\n      created_at,\n      updated_at\n    )\n    VALUES (?, ?, NULL, ?, ?, ?, ?, ?, ?)\n  `).run(\n    projectId,\n    \"cli\",\n    identity.repoRootPath,\n    identity.executionPath,\n    identity.worktreePath ?? null,\n    \"active\",\n    now,\n    now\n  );\n  memory.session.id = inserted.lastInsertRowid as number;\n  memory.session.repoRootPath = identity.repoRootPath;\n  memory.session.executionPath = identity.executionPath;\n  return projectId;\n}\n\nexport function createAgentTask(memory: AgentMemory, projectId: number, db = getDbForRepo()): void {\n  const now = new Date().toISOString();\n  const identity = resolveCanonicalRepoIdentity();\n  const inserted = db.prepare(`\n    INSERT INTO tasks(\n      session_id,\n      project_id,\n      runtime,\n      status,\n      initial_query,\n      summary,\n      final_answer_packet_json,\n      normalized_query,\n      dialog_state_json,\n      relevant_files_json,\n      missing_files_json,\n      repo_root_path,\n      worktree_path,\n      worktree_branch,\n      worktree_name,\n      base_branch,\n      snapshot_json,\n      current_step_id,\n      latest_turn_id,\n      latest_turn_index,\n      created_at,\n      updated_at\n    )\n    VALUES (?, ?, 'agent', ?, ?, NULL, NULL, ?, NULL, '[]', '[]', ?, ?, ?, ?, ?, NULL, NULL, NULL, 0, ?, ?)\n  `).run(\n    memory.session.id,\n    projectId,\n    memory.task.status,\n    memory.task.initialQuery,\n    memory.task.normalizedQuery,\n    identity.repoRootPath,\n    identity.worktreePath ?? null,\n    identity.worktreePath ? identity.currentBranch ?? null : null,\n    null,\n    identity.currentBranch ?? null,\n    now,\n    now\n  );\n  memory.task.id = inserted.lastInsertRowid as number;\n}\n\nexport function loadPersistedAgentTask(taskId: number, db = getDbForRepo()): PersistedAgentTaskRow | undefined {\n  return db.prepare(`\n    SELECT *\n    FROM tasks\n    WHERE id = ? AND runtime = 'agent'\n  `).get(taskId) as PersistedAgentTaskRow | undefined;\n}\n\nexport function loadPersistedAgentSession(sessionId: number, db = getDbForRepo()): PersistedAgentSessionRow | undefined {\n  return db.prepare(`\n    SELECT *\n    FROM sessions\n    WHERE id = ?\n  `).get(sessionId) as PersistedAgentSessionRow | undefined;\n}\n\nexport function persistAgentTask(memory: AgentMemory, db = getDbForRepo()): void {\n  const now = new Date().toISOString();\n  memory.durableCheckpoint = createDurableCheckpointFromArtifacts(memory);\n  const snapshot = buildAgentSnapshot(memory);\n  const latestGrounded = memory.durableCheckpoint;\n  const latestPacket = latestGrounded?.finalAnswerPacket;\n  const latestAnswer = latestGrounded?.finalAnswer;\n  const relevantFiles = latestPacket?.mustMentionFiles ?? Object.keys(memory.evidence.fileReads).slice(0, 8);\n  const worktreePath = memory.session.executionPath !== memory.session.repoRootPath\n    ? memory.session.executionPath\n    : null;\n  db.prepare(`\n    UPDATE tasks\n    SET status = ?,\n        summary = ?,\n        final_answer_packet_json = ?,\n        normalized_query = ?,\n        dialog_state_json = ?,\n        relevant_files_json = ?,\n        missing_files_json = ?,\n        repo_root_path = ?,\n        worktree_path = COALESCE(?, worktree_path),\n        resume_context_json = NULL,\n        snapshot_json = ?,\n        current_step_id = ?,\n        latest_turn_id = ?,\n        latest_turn_index = ?,\n        updated_at = ?\n    WHERE id = ?\n  `).run(\n    memory.task.status,\n    latestAnswer ?? null,\n    latestPacket ? JSON.stringify(latestPacket) : null,\n    memory.task.normalizedQuery,\n    memory.task.dialogState ? JSON.stringify(memory.task.dialogState) : null,\n    JSON.stringify(relevantFiles),\n    JSON.stringify([]),\n    memory.session.repoRootPath,\n    worktreePath,\n    JSON.stringify(snapshot),\n    memory.task.currentStepId ?? null,\n    memory.task.currentTurnId ?? null,\n    memory.task.currentTurnIndex ?? 0,\n    now,\n    memory.task.id\n  );\n  db.prepare(`\n    UPDATE sessions\n    SET active_task_id = ?, repo_root_path = ?, execution_path = ?, worktree_path = ?, status = ?, updated_at = ?\n    WHERE id = ?\n  `).run(\n    memory.task.id,\n    memory.session.repoRootPath,\n    memory.session.executionPath,\n    null,\n    memory.task.status === \"done\" ? \"completed\" : \"active\",\n    now,\n    memory.session.id\n  );\n}\n\nexport function persistAgentSnapshot(memory: AgentMemory, db = getDbForRepo()): void {\n  memory.durableCheckpoint = createDurableCheckpointFromArtifacts(memory);\n  db.prepare(`\n    UPDATE tasks\n    SET snapshot_json = ?, updated_at = ?\n    WHERE id = ?\n  `).run(JSON.stringify(buildAgentSnapshot(memory)), new Date().toISOString(), memory.task.id);\n}\n\nexport function listAgentTasks(db = getDbForRepo()): AgentTaskListItem[] {\n  const rows = db.prepare(`\n    SELECT id, status, initial_query, latest_turn_index, created_at, updated_at\n    FROM tasks\n    WHERE runtime = 'agent'\n    ORDER BY id DESC\n  `).all() as Array<{\n    id: number;\n    status: string;\n    initial_query: string;\n    latest_turn_index: number;\n    created_at: string;\n    updated_at: string;\n  }>;\n  return rows.map((row) => ({\n    id: row.id,\n    status: row.status,\n    initialQuery: row.initial_query,\n    latestTurnIndex: row.latest_turn_index,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n  }));\n}\n\nexport function getAgentTaskDetails(taskId: number, db = getDbForRepo()): AgentTaskDetails | undefined {\n  const row = loadPersistedAgentTask(taskId, db);\n  if (!row) {\n    return undefined;\n  }\n  return {\n    id: row.id,\n    sessionId: row.session_id,\n    status: row.status,\n    initialQuery: row.initial_query,\n    ...(row.summary ? { finalAnswer: row.summary } : {}),\n    ...(parseJson<FinalAnswerPacket>(row.final_answer_packet_json) ? { latestFinalAnswerPacket: parseJson<FinalAnswerPacket>(row.final_answer_packet_json)! } : {}),\n    ...(parseJson<AgentMemory[\"task\"][\"dialogState\"]>(row.dialog_state_json) ? { dialogState: parseJson<AgentMemory[\"task\"][\"dialogState\"]>(row.dialog_state_json)! } : {}),\n    ...(row.repo_root_path ? { repoRootPath: row.repo_root_path } : {}),\n    ...(row.worktree_path ? { worktreePath: row.worktree_path } : {}),\n    ...(row.worktree_branch ? { worktreeBranch: row.worktree_branch } : {}),\n    ...(row.worktree_name ? { worktreeName: row.worktree_name } : {}),\n    ...(row.base_branch ? { baseBranch: row.base_branch } : {}),\n    ...(row.current_step_id ? { currentStepId: row.current_step_id } : {}),\n    latestTurnIndex: row.latest_turn_index,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n  };\n}\n\nexport function getCurrentAgentTaskDetails(db = getDbForRepo()): AgentTaskDetails | undefined {\n  const row = db.prepare(`SELECT current_task_id FROM global_state WHERE id = 1`).get() as {\n    current_task_id?: number | null;\n  } | undefined;\n  if (!row?.current_task_id) {\n    return undefined;\n  }\n  return getAgentTaskDetails(row.current_task_id, db);\n}\n"]}