@lensagent/core 0.1.0 → 0.1.2

package/dist/store/event-log.js

@@ -9,10 +9,14 @@ export class EventLog {
     path;
     #tail = Promise.resolve();
     #hash = null;
+    #error;
     constructor(root, path, fsync) {
         this.fsync = fsync;
         this.path = resolve(root, path);
     }
+    get failed() {
+        return this.#error !== undefined;
+    }
     async load() {
         const records = await readEventLog(this.path).catch((error) => {
             if (isMissing(error))
@@ -22,21 +26,34 @@ export class EventLog {
         this.#hash = records.at(-1)?.hash ?? null;
     }
     append(revision, state) {
+        if (this.failed)
+            return;
         this.#tail = this.#tail.then(async () => {
+            if (this.failed)
+                return;
             const base = { revision, occurred_at: now(), previous_hash: this.#hash, state };
             const record = { ...base, hash: hash(base) };
             await mkdir(dirname(this.path), { recursive: true });
             await appendFile(this.path, `${JSON.stringify(record)}\n`, 'utf8');
             if (this.fsync) {
-                const file = await open(this.path, 'r');
-                await file.sync();
-                await file.close();
+                const file = await open(this.path, 'r+');
+                try {
+                    await file.sync();
+                }
+                finally {
+                    await file.close();
+                }
             }
             this.#hash = record.hash;
+        }).catch((error) => {
+            // A failed append may have written only part of a record. Do not extend that chain.
+            this.#error = error instanceof Error ? error : new Error(String(error));
         });
     }
-    close() {
-        return this.#tail;
+    async close() {
+        await this.#tail;
+        if (this.#error !== undefined)
+            throw this.#error;
     }
 }
 export async function readEventLog(path) {

package/dist/store/schema.d.ts

@@ -1 +1 @@
-export declare const schema = "\nPRAGMA foreign_keys = ON;\nPRAGMA journal_mode = WAL;\nPRAGMA synchronous = NORMAL;\nPRAGMA busy_timeout = 5000;\n\nCREATE TABLE IF NOT EXISTS instance (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  epoch TEXT NOT NULL,\n  state_revision INTEGER NOT NULL CHECK (state_revision >= 0),\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  archived_at TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS workspaces (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  is_default INTEGER NOT NULL CHECK (is_default IN (0, 1)),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(project_id, name)\n) STRICT;\nCREATE UNIQUE INDEX IF NOT EXISTS workspace_default ON workspaces(project_id) WHERE is_default = 1;\n\nCREATE TABLE IF NOT EXISTS workspace_paths (\n  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  path TEXT NOT NULL,\n  PRIMARY KEY(workspace_id, ordinal),\n  UNIQUE(workspace_id, path)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS tasks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  title TEXT NOT NULL,\n  archived_at TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS sessions (\n  id TEXT PRIMARY KEY,\n  task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  title TEXT NOT NULL,\n  archived_at TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS agents (\n  id TEXT PRIMARY KEY,\n  task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,\n  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE RESTRICT,\n  parent_agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  name TEXT NOT NULL,\n  state TEXT NOT NULL CHECK (state IN ('IDLE', 'RUNNING', 'WAITING', 'STOPPED')),\n  model TEXT NOT NULL,\n  model_reasoning_effort TEXT NOT NULL,\n  policy_preset TEXT NOT NULL,\n  context_revision INTEGER NOT NULL CHECK (context_revision >= 0),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS messages (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  source_agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  role TEXT NOT NULL CHECK (role IN ('system', 'user', 'assistant', 'tool')),\n  content TEXT NOT NULL,\n  metadata_json TEXT,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS pending_messages (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,\n  source_agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  content TEXT NOT NULL,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS runs (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  goal_message_ids_json TEXT NOT NULL DEFAULT '[]',\n  initial_step_pending INTEGER NOT NULL DEFAULT 0 CHECK (initial_step_pending IN (0, 1)),\n  state TEXT NOT NULL CHECK (state IN ('READY', 'RUNNING', 'WAITING', 'TERMINAL')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  error_code TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS steps (\n  id TEXT PRIMARY KEY,\n  run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,\n  turn_group_id TEXT NOT NULL REFERENCES context_turn_groups(id) ON DELETE RESTRICT,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  state TEXT NOT NULL CHECK (state IN ('RUNNING', 'WAITING', 'TERMINAL')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  error_code TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(run_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS model_attempts (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  step_id TEXT REFERENCES steps(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL CHECK (kind IN ('agent', 'compaction')),\n  sequence INTEGER NOT NULL CHECK (sequence >= 0),\n  model TEXT NOT NULL,\n  state TEXT NOT NULL CHECK (state IN ('PREPARED', 'RUNNING', 'TERMINAL')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  profile_id TEXT NOT NULL,\n  profile_version INTEGER NOT NULL CHECK (profile_version >= 1),\n  profile_digest TEXT NOT NULL,\n  config_digest TEXT NOT NULL,\n  context_revision INTEGER NOT NULL CHECK (context_revision >= 0),\n  request_digest TEXT NOT NULL,\n  preparation_json TEXT NOT NULL,\n  usage_json TEXT,\n  error_code TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, kind, sequence)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS attempt_capabilities (\n  attempt_id TEXT NOT NULL REFERENCES model_attempts(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  capability_id TEXT NOT NULL,\n  schema_json TEXT NOT NULL,\n  PRIMARY KEY(attempt_id, ordinal),\n  UNIQUE(attempt_id, capability_id)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS attempt_tool_ordinals (\n  attempt_id TEXT NOT NULL REFERENCES model_attempts(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  provider_tool_id TEXT,\n  complete INTEGER NOT NULL CHECK (complete IN (0, 1)),\n  PRIMARY KEY(attempt_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS call_partitions (\n  id TEXT PRIMARY KEY,\n  step_id TEXT NOT NULL REFERENCES steps(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  mode TEXT NOT NULL CHECK (mode IN ('parallel', 'serial')),\n  created_at TEXT NOT NULL,\n  UNIQUE(step_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS calls (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE RESTRICT,\n  agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  step_id TEXT REFERENCES steps(id) ON DELETE CASCADE,\n  attempt_id TEXT REFERENCES model_attempts(id) ON DELETE CASCADE,\n  partition_id TEXT REFERENCES call_partitions(id) ON DELETE CASCADE,\n  parent_call_id TEXT REFERENCES calls(id) ON DELETE CASCADE,\n  source TEXT NOT NULL CHECK (source IN ('user', 'llm', 'program')),\n  capability_id TEXT NOT NULL,\n  provider_call_id TEXT,\n  call_ordinal INTEGER CHECK (call_ordinal >= 0),\n  input_json TEXT NOT NULL,\n  effect TEXT NOT NULL CHECK (effect IN ('read_only', 'workspace_write', 'external', 'full')),\n  policy TEXT CHECK (policy IN ('read_only', 'workspace_write', 'external', 'ask', 'auto_approve', 'full_access')),\n  state TEXT NOT NULL CHECK (state IN ('WAITING', 'QUEUED', 'RUNNING', 'TERMINAL')),\n  wait_reason TEXT CHECK (wait_reason IN ('user_input', 'policy_review')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  outcome_unknown INTEGER NOT NULL CHECK (outcome_unknown IN (0, 1)),\n  auto_review_passed INTEGER CHECK (auto_review_passed IN (0, 1)),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(attempt_id, call_ordinal)\n) STRICT;\nCREATE UNIQUE INDEX IF NOT EXISTS calls_by_provider_call ON calls(attempt_id, provider_call_id) WHERE provider_call_id IS NOT NULL;\n\nCREATE TABLE IF NOT EXISTS results (\n  id TEXT PRIMARY KEY,\n  call_id TEXT NOT NULL UNIQUE REFERENCES calls(id) ON DELETE CASCADE,\n  outcome TEXT NOT NULL CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  content_json TEXT NOT NULL,\n  truncated INTEGER NOT NULL DEFAULT 0 CHECK (truncated IN (0, 1)),\n  error_code TEXT,\n  error_message TEXT,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS artifacts (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  media_type TEXT NOT NULL,\n  relative_path TEXT NOT NULL,\n  sha256 TEXT NOT NULL,\n  size_bytes INTEGER NOT NULL CHECK (size_bytes >= 0),\n  created_at TEXT NOT NULL\n) STRICT;\nCREATE UNIQUE INDEX IF NOT EXISTS artifact_identity ON artifacts(project_id, sha256, name, media_type);\nCREATE INDEX IF NOT EXISTS artifacts_by_path ON artifacts(relative_path);\n\nCREATE TABLE IF NOT EXISTS result_artifacts (\n  result_id TEXT NOT NULL REFERENCES results(id) ON DELETE CASCADE,\n  artifact_id TEXT NOT NULL REFERENCES artifacts(id) ON DELETE RESTRICT,\n  PRIMARY KEY(result_id, artifact_id)\n) STRICT;\n\n-- No table for write_file/edit_file file history: it belongs to the Executor, which owns the files\n-- and therefore the only authoritative view of what they contained. Core keeps Call semantics and\n-- asks the Executor to revert by call_id. See\n-- docs/architecture/harness-level3/09-file-snapshot-storage-decision.md.\n\nCREATE TABLE IF NOT EXISTS context_turn_groups (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  kind TEXT NOT NULL CHECK (kind IN ('turn', 'compaction', 'included', 'ledger')),\n  state TEXT NOT NULL CHECK (state IN ('OPEN', 'COMPLETE', 'ABORTED')),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  completed_at TEXT,\n  UNIQUE(agent_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS context_items (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  turn_group_id TEXT NOT NULL REFERENCES context_turn_groups(id) ON DELETE CASCADE,\n  turn_group_ordinal INTEGER NOT NULL CHECK (turn_group_ordinal >= 0),\n  kind TEXT NOT NULL CHECK (kind IN ('message', 'tool_calls', 'result', 'compaction')),\n  source_id TEXT NOT NULL,\n  role TEXT CHECK (role IN ('system', 'user', 'assistant', 'tool')),\n  content TEXT NOT NULL,\n  tool_call_id TEXT,\n  tool_name TEXT,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  visible INTEGER NOT NULL CHECK (visible IN (0, 1)),\n  locked INTEGER NOT NULL CHECK (locked IN (0, 1)),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, ordinal),\n  UNIQUE(turn_group_id, turn_group_ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS context_overrides (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  target_kind TEXT NOT NULL CHECK (target_kind IN ('agent', 'message', 'result', 'artifact')),\n  target_id TEXT NOT NULL,\n  instructions TEXT NOT NULL,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, target_kind, target_id)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS projection_decisions (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  attempt_id TEXT REFERENCES model_attempts(id) ON DELETE CASCADE,\n  stage TEXT NOT NULL,\n  source_tokens INTEGER NOT NULL CHECK (source_tokens >= 0),\n  projected_tokens INTEGER NOT NULL CHECK (projected_tokens >= 0),\n  details_json TEXT NOT NULL,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS capability_assignments (\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  capability_id TEXT NOT NULL,\n  policy TEXT NOT NULL CHECK (policy IN ('read_only', 'workspace_write', 'external', 'ask', 'auto_approve', 'full_access')),\n  assigned_at TEXT NOT NULL,\n  PRIMARY KEY(agent_id, capability_id)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS capability_loads (\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  capability_id TEXT NOT NULL,\n  loaded_at TEXT NOT NULL,\n  PRIMARY KEY(agent_id, capability_id),\n  FOREIGN KEY(agent_id, capability_id) REFERENCES capability_assignments(agent_id, capability_id) ON DELETE CASCADE\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS agent_plans (\n  agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,\n  items_json TEXT NOT NULL,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS ingress_requests (\n  client_id TEXT NOT NULL,\n  key TEXT NOT NULL,\n  operation TEXT NOT NULL,\n  request_digest TEXT NOT NULL,\n  response_json TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  PRIMARY KEY(client_id, key)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS side_effect_ledgers (\n  id TEXT PRIMARY KEY,\n  step_id TEXT NOT NULL REFERENCES steps(id) ON DELETE CASCADE,\n  content TEXT NOT NULL,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE INDEX IF NOT EXISTS tasks_by_project ON tasks(project_id, archived_at, updated_at DESC);\nCREATE INDEX IF NOT EXISTS sessions_by_task ON sessions(task_id, archived_at, updated_at DESC);\nCREATE INDEX IF NOT EXISTS agents_by_session ON agents(session_id, parent_agent_id, created_at);\nCREATE INDEX IF NOT EXISTS pending_by_agent ON pending_messages(agent_id, ordinal);\nCREATE INDEX IF NOT EXISTS runs_by_agent ON runs(agent_id, created_at DESC);\nCREATE UNIQUE INDEX IF NOT EXISTS one_live_run_per_agent ON runs(agent_id) WHERE state != 'TERMINAL';\nCREATE INDEX IF NOT EXISTS attempts_by_step ON model_attempts(step_id, sequence);\nCREATE INDEX IF NOT EXISTS calls_by_project ON calls(project_id, state, created_at DESC);\nCREATE INDEX IF NOT EXISTS context_by_agent ON context_items(agent_id, ordinal);\nCREATE INDEX IF NOT EXISTS artifacts_by_project ON artifacts(project_id, created_at DESC);\n";
+export declare const schema = "\nPRAGMA foreign_keys = ON;\nPRAGMA journal_mode = WAL;\nPRAGMA synchronous = NORMAL;\nPRAGMA busy_timeout = 5000;\n\nCREATE TABLE IF NOT EXISTS instance (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  epoch TEXT NOT NULL,\n  state_revision INTEGER NOT NULL CHECK (state_revision >= 0),\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  archived_at TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS workspaces (\n  executor_ref TEXT,\n  executor_id TEXT NOT NULL DEFAULT 'remote' CHECK (executor_id IN ('local', 'remote')),\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  is_default INTEGER NOT NULL CHECK (is_default IN (0, 1)),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(project_id, name)\n) STRICT;\nCREATE UNIQUE INDEX IF NOT EXISTS workspace_default ON workspaces(project_id) WHERE is_default = 1;\n\nCREATE TABLE IF NOT EXISTS workspace_paths (\n  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  path TEXT NOT NULL,\n  PRIMARY KEY(workspace_id, ordinal),\n  UNIQUE(workspace_id, path)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS tasks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  title TEXT NOT NULL,\n  archived_at TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS sessions (\n  id TEXT PRIMARY KEY,\n  task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  title TEXT NOT NULL,\n  archived_at TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS agents (\n  id TEXT PRIMARY KEY,\n  task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,\n  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE RESTRICT,\n  parent_agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  name TEXT NOT NULL,\n  state TEXT NOT NULL CHECK (state IN ('IDLE', 'RUNNING', 'WAITING', 'STOPPED')),\n  model TEXT NOT NULL,\n  model_reasoning_effort TEXT NOT NULL,\n  policy_preset TEXT NOT NULL,\n  context_revision INTEGER NOT NULL CHECK (context_revision >= 0),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS messages (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  source_agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  role TEXT NOT NULL CHECK (role IN ('system', 'user', 'assistant', 'tool')),\n  content TEXT NOT NULL,\n  metadata_json TEXT,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS pending_messages (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,\n  source_agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  content TEXT NOT NULL,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS runs (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  goal_message_ids_json TEXT NOT NULL DEFAULT '[]',\n  initial_step_pending INTEGER NOT NULL DEFAULT 0 CHECK (initial_step_pending IN (0, 1)),\n  state TEXT NOT NULL CHECK (state IN ('READY', 'RUNNING', 'WAITING', 'TERMINAL')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  error_code TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS steps (\n  id TEXT PRIMARY KEY,\n  run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,\n  turn_group_id TEXT NOT NULL REFERENCES context_turn_groups(id) ON DELETE RESTRICT,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  state TEXT NOT NULL CHECK (state IN ('RUNNING', 'WAITING', 'TERMINAL')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  error_code TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(run_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS model_attempts (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  step_id TEXT REFERENCES steps(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL CHECK (kind IN ('agent', 'compaction')),\n  sequence INTEGER NOT NULL CHECK (sequence >= 0),\n  model TEXT NOT NULL,\n  state TEXT NOT NULL CHECK (state IN ('PREPARED', 'RUNNING', 'TERMINAL')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  profile_id TEXT NOT NULL,\n  profile_version INTEGER NOT NULL CHECK (profile_version >= 1),\n  profile_digest TEXT NOT NULL,\n  config_digest TEXT NOT NULL,\n  context_revision INTEGER NOT NULL CHECK (context_revision >= 0),\n  request_digest TEXT NOT NULL,\n  request_json TEXT,\n  observation_json TEXT,\n  preparation_json TEXT NOT NULL,\n  usage_json TEXT,\n  error_code TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, kind, sequence)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS attempt_capabilities (\n  attempt_id TEXT NOT NULL REFERENCES model_attempts(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  capability_id TEXT NOT NULL,\n  schema_json TEXT NOT NULL,\n  PRIMARY KEY(attempt_id, ordinal),\n  UNIQUE(attempt_id, capability_id)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS attempt_tool_ordinals (\n  attempt_id TEXT NOT NULL REFERENCES model_attempts(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  provider_tool_id TEXT,\n  complete INTEGER NOT NULL CHECK (complete IN (0, 1)),\n  PRIMARY KEY(attempt_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS call_partitions (\n  id TEXT PRIMARY KEY,\n  step_id TEXT NOT NULL REFERENCES steps(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  mode TEXT NOT NULL CHECK (mode IN ('parallel', 'serial')),\n  created_at TEXT NOT NULL,\n  UNIQUE(step_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS calls (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE RESTRICT,\n  agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,\n  step_id TEXT REFERENCES steps(id) ON DELETE CASCADE,\n  attempt_id TEXT REFERENCES model_attempts(id) ON DELETE CASCADE,\n  partition_id TEXT REFERENCES call_partitions(id) ON DELETE CASCADE,\n  parent_call_id TEXT REFERENCES calls(id) ON DELETE CASCADE,\n  source TEXT NOT NULL CHECK (source IN ('user', 'llm', 'program')),\n  capability_id TEXT NOT NULL,\n  provider_call_id TEXT,\n  call_ordinal INTEGER CHECK (call_ordinal >= 0),\n  input_json TEXT NOT NULL,\n  continuation_json TEXT,\n  effect TEXT NOT NULL CHECK (effect IN ('read_only', 'workspace_write', 'external', 'full')),\n  policy TEXT CHECK (policy IN ('read_only', 'workspace_write', 'external', 'ask', 'auto_approve', 'full_access')),\n  state TEXT NOT NULL CHECK (state IN ('WAITING', 'QUEUED', 'RUNNING', 'TERMINAL')),\n  wait_reason TEXT CHECK (wait_reason IN ('user_input', 'policy_review')),\n  outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  outcome_unknown INTEGER NOT NULL CHECK (outcome_unknown IN (0, 1)),\n  auto_review_passed INTEGER CHECK (auto_review_passed IN (0, 1)),\n  auto_review_json TEXT,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(attempt_id, call_ordinal)\n) STRICT;\nCREATE UNIQUE INDEX IF NOT EXISTS calls_by_provider_call ON calls(attempt_id, provider_call_id) WHERE provider_call_id IS NOT NULL;\n\nCREATE TABLE IF NOT EXISTS results (\n  capture TEXT NOT NULL DEFAULT 'unknown' CHECK (capture IN ('complete', 'partial', 'unknown')),\n  stored TEXT NOT NULL DEFAULT 'unknown' CHECK (stored IN ('full', 'unknown')),\n  id TEXT PRIMARY KEY,\n  call_id TEXT NOT NULL UNIQUE REFERENCES calls(id) ON DELETE CASCADE,\n  outcome TEXT NOT NULL CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),\n  content_json TEXT NOT NULL,\n  truncated INTEGER NOT NULL DEFAULT 0 CHECK (truncated IN (0, 1)),\n  error_code TEXT,\n  error_message TEXT,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS artifacts (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  media_type TEXT NOT NULL,\n  relative_path TEXT NOT NULL,\n  sha256 TEXT NOT NULL,\n  size_bytes INTEGER NOT NULL CHECK (size_bytes >= 0),\n  created_at TEXT NOT NULL\n) STRICT;\nCREATE UNIQUE INDEX IF NOT EXISTS artifact_identity ON artifacts(project_id, sha256, name, media_type);\nCREATE INDEX IF NOT EXISTS artifacts_by_path ON artifacts(relative_path);\n\nCREATE TABLE IF NOT EXISTS result_artifacts (\n  result_id TEXT NOT NULL REFERENCES results(id) ON DELETE CASCADE,\n  artifact_id TEXT NOT NULL REFERENCES artifacts(id) ON DELETE RESTRICT,\n  PRIMARY KEY(result_id, artifact_id)\n) STRICT;\n\n-- No table for edit_file/patch_file file history: it belongs to the Executor, which owns the files\n-- and therefore the only authoritative view of what they contained. Core keeps Call semantics and\n-- asks the Executor to revert by call_id. See\n-- docs/architecture/harness-level3/09-file-snapshot-storage-decision.md.\n\nCREATE TABLE IF NOT EXISTS context_turn_groups (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  kind TEXT NOT NULL CHECK (kind IN ('turn', 'compaction', 'included', 'ledger')),\n  state TEXT NOT NULL CHECK (state IN ('OPEN', 'COMPLETE', 'ABORTED')),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  completed_at TEXT,\n  UNIQUE(agent_id, ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS context_items (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  turn_group_id TEXT NOT NULL REFERENCES context_turn_groups(id) ON DELETE CASCADE,\n  turn_group_ordinal INTEGER NOT NULL CHECK (turn_group_ordinal >= 0),\n  kind TEXT NOT NULL CHECK (kind IN ('message', 'tool_calls', 'result', 'compaction')),\n  source_id TEXT NOT NULL,\n  role TEXT CHECK (role IN ('system', 'user', 'assistant', 'tool')),\n  content TEXT NOT NULL,\n  tool_call_id TEXT,\n  tool_name TEXT,\n  ordinal INTEGER NOT NULL CHECK (ordinal >= 0),\n  visible INTEGER NOT NULL CHECK (visible IN (0, 1)),\n  locked INTEGER NOT NULL CHECK (locked IN (0, 1)),\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, ordinal),\n  UNIQUE(turn_group_id, turn_group_ordinal)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS context_overrides (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  target_kind TEXT NOT NULL CHECK (target_kind IN ('agent', 'message', 'result', 'artifact')),\n  target_id TEXT NOT NULL,\n  instructions TEXT NOT NULL,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(agent_id, target_kind, target_id)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS todo_reminder_state (\n  agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,\n  last_context_rowid INTEGER NOT NULL DEFAULT 0,\n  pending_tokens INTEGER NOT NULL DEFAULT 0 CHECK (pending_tokens >= 0)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS working_context_items (\n  context_item_id TEXT PRIMARY KEY REFERENCES context_items(id) ON DELETE CASCADE,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  source_revision INTEGER NOT NULL,\n  content TEXT NOT NULL,\n  snipped INTEGER NOT NULL DEFAULT 0 CHECK (snipped IN (0, 1))\n) STRICT;\nCREATE INDEX IF NOT EXISTS working_context_agent ON working_context_items(agent_id);\n\nCREATE TABLE IF NOT EXISTS working_contexts (\n  agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,\n  source_revision INTEGER NOT NULL,\n  revision INTEGER NOT NULL,\n  digest TEXT NOT NULL,\n  prefixes_json TEXT NOT NULL DEFAULT '[]',\n  messages_json TEXT,\n  request_frame_json TEXT,\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS context_compactions (\n  context_item_id TEXT PRIMARY KEY REFERENCES context_items(id) ON DELETE CASCADE,\n  source_revision INTEGER NOT NULL,\n  covered_item_ids_json TEXT NOT NULL,\n  focus TEXT\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS projection_decisions (\n  id TEXT PRIMARY KEY,\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  attempt_id TEXT REFERENCES model_attempts(id) ON DELETE CASCADE,\n  stage TEXT NOT NULL,\n  source_tokens INTEGER NOT NULL CHECK (source_tokens >= 0),\n  projected_tokens INTEGER NOT NULL CHECK (projected_tokens >= 0),\n  details_json TEXT NOT NULL,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS capability_assignments (\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  capability_id TEXT NOT NULL,\n  policy TEXT NOT NULL CHECK (policy IN ('read_only', 'workspace_write', 'external', 'ask', 'auto_approve', 'full_access')),\n  assigned_at TEXT NOT NULL,\n  PRIMARY KEY(agent_id, capability_id)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS capability_loads (\n  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,\n  capability_id TEXT NOT NULL,\n  loaded_at TEXT NOT NULL,\n  PRIMARY KEY(agent_id, capability_id),\n  FOREIGN KEY(agent_id, capability_id) REFERENCES capability_assignments(agent_id, capability_id) ON DELETE CASCADE\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS agent_plans (\n  agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,\n  items_json TEXT NOT NULL,\n  revision INTEGER NOT NULL CHECK (revision >= 0),\n  updated_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS ingress_requests (\n  client_id TEXT NOT NULL,\n  key TEXT NOT NULL,\n  operation TEXT NOT NULL,\n  request_digest TEXT NOT NULL,\n  response_json TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  PRIMARY KEY(client_id, key)\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS side_effect_ledgers (\n  id TEXT PRIMARY KEY,\n  step_id TEXT NOT NULL REFERENCES steps(id) ON DELETE CASCADE,\n  content TEXT NOT NULL,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE TABLE IF NOT EXISTS purge_cleanups (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id),\n  executor_state_id TEXT NOT NULL,\n  payload_json TEXT NOT NULL,\n  created_at TEXT NOT NULL\n) STRICT;\n\nCREATE INDEX IF NOT EXISTS tasks_by_project ON tasks(project_id, archived_at, updated_at DESC);\nCREATE INDEX IF NOT EXISTS sessions_by_task ON sessions(task_id, archived_at, updated_at DESC);\nCREATE INDEX IF NOT EXISTS agents_by_session ON agents(session_id, parent_agent_id, created_at);\nCREATE INDEX IF NOT EXISTS pending_by_agent ON pending_messages(agent_id, ordinal);\nCREATE INDEX IF NOT EXISTS runs_by_agent ON runs(agent_id, created_at DESC);\nCREATE UNIQUE INDEX IF NOT EXISTS one_live_run_per_agent ON runs(agent_id) WHERE state != 'TERMINAL';\nCREATE INDEX IF NOT EXISTS attempts_by_step ON model_attempts(step_id, sequence);\nCREATE INDEX IF NOT EXISTS calls_by_project ON calls(project_id, state, created_at DESC);\nCREATE INDEX IF NOT EXISTS context_by_agent ON context_items(agent_id, ordinal);\nCREATE INDEX IF NOT EXISTS artifacts_by_project ON artifacts(project_id, created_at DESC);\n";

package/dist/store/schema.js

@@ -21,6 +21,8 @@ CREATE TABLE IF NOT EXISTS projects (
 ) STRICT;
 
 CREATE TABLE IF NOT EXISTS workspaces (
+  executor_ref TEXT,
+  executor_id TEXT NOT NULL DEFAULT 'remote' CHECK (executor_id IN ('local', 'remote')),
   id TEXT PRIMARY KEY,
   project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
   name TEXT NOT NULL,
@@ -141,6 +143,8 @@ CREATE TABLE IF NOT EXISTS model_attempts (
   config_digest TEXT NOT NULL,
   context_revision INTEGER NOT NULL CHECK (context_revision >= 0),
   request_digest TEXT NOT NULL,
+  request_json TEXT,
+  observation_json TEXT,
   preparation_json TEXT NOT NULL,
   usage_json TEXT,
   error_code TEXT,
@@ -189,6 +193,7 @@ CREATE TABLE IF NOT EXISTS calls (
   provider_call_id TEXT,
   call_ordinal INTEGER CHECK (call_ordinal >= 0),
   input_json TEXT NOT NULL,
+  continuation_json TEXT,
   effect TEXT NOT NULL CHECK (effect IN ('read_only', 'workspace_write', 'external', 'full')),
   policy TEXT CHECK (policy IN ('read_only', 'workspace_write', 'external', 'ask', 'auto_approve', 'full_access')),
   state TEXT NOT NULL CHECK (state IN ('WAITING', 'QUEUED', 'RUNNING', 'TERMINAL')),
@@ -196,6 +201,7 @@ CREATE TABLE IF NOT EXISTS calls (
   outcome TEXT CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),
   outcome_unknown INTEGER NOT NULL CHECK (outcome_unknown IN (0, 1)),
   auto_review_passed INTEGER CHECK (auto_review_passed IN (0, 1)),
+  auto_review_json TEXT,
   revision INTEGER NOT NULL CHECK (revision >= 0),
   created_at TEXT NOT NULL,
   updated_at TEXT NOT NULL,
@@ -204,6 +210,8 @@ CREATE TABLE IF NOT EXISTS calls (
 CREATE UNIQUE INDEX IF NOT EXISTS calls_by_provider_call ON calls(attempt_id, provider_call_id) WHERE provider_call_id IS NOT NULL;
 
 CREATE TABLE IF NOT EXISTS results (
+  capture TEXT NOT NULL DEFAULT 'unknown' CHECK (capture IN ('complete', 'partial', 'unknown')),
+  stored TEXT NOT NULL DEFAULT 'unknown' CHECK (stored IN ('full', 'unknown')),
   id TEXT PRIMARY KEY,
   call_id TEXT NOT NULL UNIQUE REFERENCES calls(id) ON DELETE CASCADE,
   outcome TEXT NOT NULL CHECK (outcome IN ('success', 'failed', 'cancelled', 'interrupted')),
@@ -233,7 +241,7 @@ CREATE TABLE IF NOT EXISTS result_artifacts (
   PRIMARY KEY(result_id, artifact_id)
 ) STRICT;
 
--- No table for write_file/edit_file file history: it belongs to the Executor, which owns the files
+-- No table for edit_file/patch_file file history: it belongs to the Executor, which owns the files
 -- and therefore the only authoritative view of what they contained. Core keeps Call semantics and
 -- asks the Executor to revert by call_id. See
 -- docs/architecture/harness-level3/09-file-snapshot-storage-decision.md.
@@ -283,6 +291,39 @@ CREATE TABLE IF NOT EXISTS context_overrides (
   UNIQUE(agent_id, target_kind, target_id)
 ) STRICT;
 
+CREATE TABLE IF NOT EXISTS todo_reminder_state (
+  agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,
+  last_context_rowid INTEGER NOT NULL DEFAULT 0,
+  pending_tokens INTEGER NOT NULL DEFAULT 0 CHECK (pending_tokens >= 0)
+) STRICT;
+
+CREATE TABLE IF NOT EXISTS working_context_items (
+  context_item_id TEXT PRIMARY KEY REFERENCES context_items(id) ON DELETE CASCADE,
+  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  source_revision INTEGER NOT NULL,
+  content TEXT NOT NULL,
+  snipped INTEGER NOT NULL DEFAULT 0 CHECK (snipped IN (0, 1))
+) STRICT;
+CREATE INDEX IF NOT EXISTS working_context_agent ON working_context_items(agent_id);
+
+CREATE TABLE IF NOT EXISTS working_contexts (
+  agent_id TEXT PRIMARY KEY REFERENCES agents(id) ON DELETE CASCADE,
+  source_revision INTEGER NOT NULL,
+  revision INTEGER NOT NULL,
+  digest TEXT NOT NULL,
+  prefixes_json TEXT NOT NULL DEFAULT '[]',
+  messages_json TEXT,
+  request_frame_json TEXT,
+  updated_at TEXT NOT NULL
+) STRICT;
+
+CREATE TABLE IF NOT EXISTS context_compactions (
+  context_item_id TEXT PRIMARY KEY REFERENCES context_items(id) ON DELETE CASCADE,
+  source_revision INTEGER NOT NULL,
+  covered_item_ids_json TEXT NOT NULL,
+  focus TEXT
+) STRICT;
+
 CREATE TABLE IF NOT EXISTS projection_decisions (
   id TEXT PRIMARY KEY,
   agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
@@ -334,6 +375,14 @@ CREATE TABLE IF NOT EXISTS side_effect_ledgers (
   created_at TEXT NOT NULL
 ) STRICT;
 
+CREATE TABLE IF NOT EXISTS purge_cleanups (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id),
+  executor_state_id TEXT NOT NULL,
+  payload_json TEXT NOT NULL,
+  created_at TEXT NOT NULL
+) STRICT;
+
 CREATE INDEX IF NOT EXISTS tasks_by_project ON tasks(project_id, archived_at, updated_at DESC);
 CREATE INDEX IF NOT EXISTS sessions_by_task ON sessions(task_id, archived_at, updated_at DESC);
 CREATE INDEX IF NOT EXISTS agents_by_session ON agents(session_id, parent_agent_id, created_at);

package/dist/store/store.d.ts

@@ -1,6 +1,8 @@
-import { type EntityRef, type Json, type Page } from '../core/domain.js';
+import type { Observability } from '../runtime/observability.js';
+import { type EntityRef, type Json, type ModelMessage, type ModelResponse, type Page } from '../core/domain.js';
 import type { EventBus } from '../runtime/events.js';
 import type { Sqlite } from './database.js';
+import type { AutoReviewResult, ReviewContext } from '../contracts/review.js';
 import type { EventLog } from './event-log.js';
 export type Document = Readonly<Record<string, Json>>;
 interface PageOptions {
@@ -27,7 +29,10 @@ export interface IngressCommand {
 }
 export declare class Store {
     #private;
-    constructor(database: Sqlite, events: EventBus, eventLog?: EventLog);
+    readonly observability?: Observability | undefined;
+    /** Persist a model tool batch before reviews or execution can yield control. */
+    commitToolBatch(projectId: string, command: () => readonly string[]): readonly string[];
+    constructor(database: Sqlite, events: EventBus, eventLog?: EventLog, observability?: Observability | undefined);
     close(): Promise<void>;
     instance(): Document;
     stateRevision(): number;
@@ -41,7 +46,7 @@ export declare class Store {
     listProjects(options: PageOptions, archive?: 'active' | 'archived' | 'all'): Page<Document>;
     defaultProject(): Document | null;
     getProject(projectId: string): Document;
-    createProject(name: string, paths: readonly string[]): Document;
+    createProject(name: string, paths: readonly string[], executorId?: string): Document;
     updateProject(projectId: string, expectedRevision: number, name: string): Document;
     archiveProject(projectId: string, expectedRevision: number, archived: boolean): Document;
     listWorkspaces(projectId: string): readonly Document[];
@@ -56,7 +61,7 @@ export declare class Store {
      */
     projectWorkspacePaths(projectId: string, workspaceId: string): readonly string[];
     getWorkspace(projectId: string, workspaceId: string): Document;
-    createWorkspace(projectId: string, name: string, paths: readonly string[], makeDefault: boolean): Document;
+    createWorkspace(projectId: string, name: string, paths: readonly string[], makeDefault: boolean, executorId?: string): Document;
     updateWorkspace(projectId: string, workspaceId: string, expectedRevision: number, name: string, paths: readonly string[], makeDefault: boolean): Document;
     deleteWorkspace(projectId: string, workspaceId: string, expectedRevision: number): void;
     listTasks(projectId: string, options: PageOptions, archived?: boolean): Page<Document>;
@@ -75,7 +80,7 @@ export declare class Store {
     createTask(projectId: string, title: string): Document;
     updateTask(projectId: string, taskId: string, expectedRevision: number, title: string): Document;
     archiveTask(projectId: string, taskId: string, expectedRevision: number, archived: boolean): Document;
-    deleteTask(projectId: string, taskId: string, expectedRevision: number): Document;
+    deleteTask(projectId: string, taskId: string, expectedRevision: number, executorStateId: string): Document;
     listSessions(projectId: string, taskId: string, options: PageOptions, archived?: boolean): Page<Document>;
     getSession(projectId: string, sessionId: string): Document;
     /**
@@ -127,6 +132,10 @@ export declare class Store {
         readonly loadedCapabilities: readonly string[];
         readonly forkContext: 'full' | 'compact' | 'none';
         readonly compactSummary?: string;
+        readonly compactCoveredItemIds?: readonly string[];
+        readonly compactRetainedItemIds?: readonly string[];
+        readonly compactFocus?: string;
+        readonly expectedParentContextRevision?: number;
         readonly initialPrompt?: string;
         readonly initialMessage?: string;
         readonly ingress?: IngressCommand;
@@ -146,7 +155,7 @@ export declare class Store {
     };
     enqueueSubagentMessage(projectId: string, parentAgentId: string, targetAgentId: string, content: string, ingress: IngressCommand): Document;
     broadcastSubagentMessage(projectId: string, parentAgentId: string, content: string, ingress: IngressCommand): Document;
-    waitForSubagent(projectId: string, sourceAgentId: string, targetAgentId: string, timeoutMs: number, signal: AbortSignal): Promise<Document>;
+    waitForSubagent(projectId: string, sourceAgentId: string, targetAgentId: string, timeoutMs: number, signal: AbortSignal, afterMessageId?: string): Promise<Document>;
     listPending(projectId: string, agentId: string, options: PageOptions): Page<Document>;
     getPending(projectId: string, pendingId: string): Document;
     updatePending(projectId: string, pendingId: string, expectedRevision: number, content: string): Document;
@@ -191,7 +200,9 @@ export declare class Store {
     }): Document;
     getAttempt(projectId: string, attemptId: string): Document;
     listAttempts(projectId: string, field: 'agent_id' | 'step_id', ownerId: string, options: PageOptions): Page<Document>;
-    transitionAttempt(projectId: string, attemptId: string, from: string, to: string, outcome?: string | null, usage?: Json | null, errorCode?: string | null): Document;
+    latestModelAttempt(projectId: string, agentId: string, kind?: 'agent' | 'compaction', model?: string): Document | null;
+    cacheUsage(projectId: string, agentId: string): Document;
+    transitionAttempt(projectId: string, attemptId: string, from: string, to: string, outcome?: string | null, usage?: Json | null, errorCode?: string | null, observation?: Json | null): Document;
     recordToolOrdinal(projectId: string, attemptId: string, ordinal: number, providerToolId: string | null, complete: boolean): void;
     createPartition(projectId: string, stepId: string, mode: 'parallel' | 'serial'): Document;
     listPartitions(projectId: string, stepId: string, options: PageOptions): Page<Document>;
@@ -207,6 +218,7 @@ export declare class Store {
         readonly providerCallId?: string;
         readonly callOrdinal?: number;
         readonly arguments: Json;
+        readonly prompt?: Json;
         readonly effect: string;
         readonly policy?: string;
         readonly state: 'WAITING' | 'QUEUED';
@@ -245,10 +257,19 @@ export declare class Store {
         readonly call: Document;
         readonly result: Document | null;
     };
-    reviewCall(projectId: string, callId: string, approved: boolean): Document;
-    startCall(projectId: string, callId: string): Document;
+    reviewCall(projectId: string, callId: string, review: AutoReviewResult): Document;
+    autoReviewContext(projectId: string, agentId: string): ReviewContext;
+    consumePendingForStep(projectId: string, stepId: string): readonly Document[];
+    interruptCall(projectId: string, callId: string, errorCode: string, message: string): Document;
+    interruptProjectCalls(projectId: string): void;
+    callAdmission(projectId: string, callId: string): 'ready' | 'blocked' | 'inactive';
+    startCall(projectId: string, callId: string, validate?: (call: Document) => void): Document;
+    failQueuedCall(projectId: string, callId: string, errorCode: string, errorMessage: string | null, content?: Json): {
+        readonly call: Document;
+        readonly result: Document;
+    };
     waitCall(projectId: string, callId: string, prompt: Json): Document;
-    completeCall(projectId: string, callId: string, outcome: string, content: Json, errorCode?: string | null, errorMessage?: string | null, artifacts?: readonly string[], truncated?: boolean): {
+    completeCall(projectId: string, callId: string, outcome: string, content: Json, errorCode?: string | null, errorMessage?: string | null, artifacts?: readonly string[], truncated?: boolean, capture?: 'complete' | 'partial' | 'unknown', stored?: 'full' | 'unknown'): {
         readonly call: Document;
         readonly result: Document;
     };
@@ -259,10 +280,9 @@ export declare class Store {
     getResult(projectId: string, resultId: string): Document;
     /**
      * 02A `ResultDocument`. One `content_json` column becomes `text` or `structured` according to its
-     * JSON type, which is the same split `normalizeOutput` makes when it decides what to store: a
-     * Capability producing prose stores a string, one producing records stores an object or array, and
-     * either is `null` here when the payload was too large to inline and became an Artifact instead.
-     * That is why a client reading a large Result has to fall back to `artifact_ids` and ART-01.
+     * JSON type. Short results retain their original type; long non-PTC results carry a text preview
+     * and full-body Artifact. Earlier results may have null content with only an Artifact reference.
+     * Clients reading the full large Result use `artifact_ids` and ART-01.
      *
      * `error_code` stays off the wire here because the documented shape does not carry it; a failed
      * Call reports its code on `CallSummary.error_code`.
@@ -277,6 +297,14 @@ export declare class Store {
         readonly sizeBytes: number;
     }): Document;
     getArtifact(projectId: string, artifactId: string): Document;
+    getAgentArtifact(projectId: string, agentId: string, artifactId: string): Document;
+    readHistoryItem(projectId: string, agentId: string, contextId: string): Document;
+    searchHistory(projectId: string, agentId: string, query: string, after: number, limit: number, scope?: {
+        readonly agent_id?: string;
+        readonly session_id?: string;
+        readonly task_id?: string;
+        readonly after_context_item_id?: string;
+    }): Document;
     listArtifacts(projectId: string, options: PageOptions): Page<Document>;
     /**
      * 02A `ContextPageQuery.direction`. `backward` walks from the newest item towards the oldest,
@@ -286,14 +314,24 @@ export declare class Store {
      * paged away from the conversation instead of into its history.
      */
     listContext(projectId: string, agentId: string, options: PageOptions, direction?: 'forward' | 'backward'): Page<Document>;
-    contextSource(projectId: string, agentId: string): {
+    contextSource(projectId: string, agentId: string, completedOnly?: boolean): {
         readonly agent: Document;
         readonly items: readonly Document[];
+        readonly workingItems: readonly Document[];
+        readonly unsettledItemIds: readonly string[];
+        readonly todo: Document | null;
         readonly overrides: readonly Document[];
         readonly capabilities: readonly Document[];
     };
-    getPlan(projectId: string, agentId: string): Document | null;
-    updatePlan(projectId: string, agentId: string, items: Json): Document;
+    workingContext(projectId: string, agentId: string): Document;
+    saveWorkingContext(projectId: string, agentId: string, sourceRevision: number, edits: readonly {
+        readonly id: string;
+        readonly content: string;
+    }[], messages: Json, prefixes: Json, requestFrame: Json): void;
+    compactionSources(projectId: string, contextItemId: string): Document;
+    getTodo(projectId: string, agentId: string): Document | null;
+    updateTodo(projectId: string, agentId: string, items: Json): Document;
+    syncTodoReminder(projectId: string, agentId: string): void;
     getContextItem(projectId: string, contextItemId: string): Document;
     updateContextItem(projectId: string, contextItemId: string, expectedRevision: number, content: string): Document;
     setContextVisibility(projectId: string, agentId: string, turnGroupIds: readonly string[], visible: boolean, expectedContextRevision: number): readonly Document[];
@@ -307,7 +345,7 @@ export declare class Store {
     listProjectionDecisions(projectId: string, agentId: string, options: PageOptions): Page<Document>;
     resetProjection(projectId: string, agentId: string, expectedContextRevision: number, stages?: readonly string[]): Document;
     appendProjectionDecision(projectId: string, agentId: string, attemptId: string | null, stage: string, sourceTokens: number, projectedTokens: number, details: Json): Document;
-    compactContext(projectId: string, agentId: string, summary: string, preserveFromOrdinal: number): Document;
+    compactContext(projectId: string, agentId: string, summary: string, coveredItemIds: readonly string[], expectedContextRevision: number, focus?: string, expectedAgentRevision?: number): Document;
     forkContext(projectId: string, sourceAgentId: string, targetAgentId: string, throughOrdinal: number): readonly Document[];
     createContextFork(projectId: string, sourceAgentId: string, input: {
         readonly throughTurnGroupId: string;
@@ -316,6 +354,8 @@ export declare class Store {
         readonly model: string;
         readonly modelReasoningEffort: string;
     }): Document;
+    /** Persist one completed Provider response atomically with its tool batch. */
+    appendModelResponse(projectId: string, agentId: string, stepId: string, text: string, calls: NonNullable<ModelMessage['toolCalls']>, response: ModelResponse): Document;
     appendAssistantMessage(projectId: string, agentId: string, stepId: string, content: string): Document;
     appendToolCalls(projectId: string, agentId: string, stepId: string, calls: readonly {
         readonly id: string;
@@ -338,7 +378,13 @@ export declare class Store {
     stepOutput(projectId: string, stepId: string): Document;
     storageStats(): Document;
     exportState(): Json;
-    purgeArchived(projectId: string, before: string): Document;
+    purgeArchived(projectId: string, before: string, executorStateId: string): Document;
+    pendingPurges(projectId: string): readonly Document[];
+    completePurge(projectId: string, cleanupId: string): void;
+    artifactPathReferenced(relativePath: string): boolean;
     snapshot(projectId: string, maxEntities: number): Document;
+    workspaceOwner(workspaceId: string): {
+        readonly projectId: string;
+    };
 }
 export {};