stitchkit 0.118.0 → 0.119.0

package/dist/{index-073nw9qr.js → index-ba7are04.js}

@@ -10,81 +10,24 @@ import {
   AgentAdmissionReceiptSchema2,
   AgentSeedReceiptSchema2,
   AgentHistoryMutationSchema2
-} from "./index-xx1j310k.js";
-import {
-  AgentMessageSchema2,
-  AgentRunSchema2
-} from "./index-8kzct1d6.js";
+} from "./index-8yxgcyt6.js";
 import {
   appendEventIn,
   ArchiveProjectionSchema,
   createAgentRuntimeStore2
-} from "./index-cycp3r3e.js";
+} from "./index-rxcgp4b9.js";
+import {
+  AgentMessageSchema2,
+  AgentRunSchema2
+} from "./index-8kzct1d6.js";
 import {
   AgentConversationPageSchema2,
   AgentConversationMessagePageSchema2
 } from "./index-kqnd6a85.js";
 
-// src/agent-runtime/sqlite-schema.ts
-import { z as z3 } from "zod";
-
-// src/agent-runtime/sqlite-purge.ts
-var OWNED_TABLES = [
-  "stitchkit_agent_runtime_spills",
-  "stitchkit_agent_runtime_schedules",
-  "stitchkit_agent_runtime_projections",
-  "stitchkit_agent_runtime_events",
-  "stitchkit_agent_runtime_messages",
-  "stitchkit_agent_runtime_seeds",
-  "stitchkit_agent_runtime_admissions",
-  "stitchkit_agent_runtime_runs",
-  "stitchkit_agent_runtime_heads"
-];
-function initializeSqliteConversationPurge(database) {
-  database.exec(`
-    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_purged (
-      conversation_id TEXT PRIMARY KEY
-    );
-  `);
-  for (const table of OWNED_TABLES) {
-    for (const operation of ["INSERT", "UPDATE"]) {
-      database.exec(`
-        CREATE TRIGGER IF NOT EXISTS ${table}_purge_${operation.toLowerCase()}
-        BEFORE ${operation} ON ${table}
-        WHEN EXISTS (
-          SELECT 1 FROM stitchkit_agent_runtime_purged WHERE conversation_id = NEW.conversation_id
-        )
-        BEGIN SELECT RAISE(ABORT, 'Agent conversation has been purged'); END;
-      `);
-    }
-  }
-}
-function sqliteConversationPurge(database) {
-  const table = database.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'stitchkit_agent_runtime_purged'").get();
-  if (table === null || table === undefined)
-    return;
-  return {
-    async isEmpty(transaction, conversationId) {
-      for (const table of OWNED_TABLES) {
-        const row = transaction.prepare(`SELECT 1 FROM ${table} WHERE conversation_id = ? LIMIT 1`).get(conversationId);
-        if (row !== null && row !== undefined)
-          return false;
-      }
-      return transaction.prepare("SELECT 1 FROM stitchkit_agent_runtime_children WHERE parent_conversation_id = ? OR child_conversation_id = ? LIMIT 1").get(conversationId, conversationId) == null;
-    },
-    async isPurged(transaction, conversationId) {
-      const row = transaction.prepare("SELECT conversation_id FROM stitchkit_agent_runtime_purged WHERE conversation_id = ?").get(conversationId);
-      return row !== null && row !== undefined;
-    },
-    async remove(transaction, conversationId) {
-      transaction.prepare("INSERT INTO stitchkit_agent_runtime_purged (conversation_id) VALUES (?)").run(conversationId);
-      for (const table of OWNED_TABLES) {
-        transaction.prepare(`DELETE FROM ${table} WHERE conversation_id = ?`).run(conversationId);
-      }
-      transaction.prepare("DELETE FROM stitchkit_agent_runtime_children WHERE parent_conversation_id = ? OR child_conversation_id = ?").run(conversationId, conversationId);
-    }
-  };
-}
+// src/agent-runtime/sqlite-events.ts
+import { createHash } from "node:crypto";
+import { z as z2 } from "zod";
 
 // src/agent-runtime/sqlite-rows.ts
 import { z } from "zod";
@@ -144,424 +87,88 @@ function parseEventRow(value) {
   });
 }
 
-// src/agent-runtime/store-migrations/v1-to-v2.ts
-import { randomUUID } from "node:crypto";
-import { z as z2 } from "zod";
-var ConversationRowSchema = z2.object({
-  conversation_id: z2.string().min(1),
-  version: z2.int().nonnegative()
-});
-var PayloadRowSchema = z2.object({
-  payload: z2.string(),
-  terminal_assistant_payload: z2.string().nullable().optional()
-});
-var HistoryRowSchema = z2.object({
+// src/agent-runtime/sqlite-events.ts
+var ArchiveProjectionRowSchema = z2.object({
+  name: z2.string(),
+  version: z2.int().positive(),
+  upto_seq: z2.int().nonnegative(),
   payload: z2.string(),
-  active: z2.union([z2.literal(0), z2.literal(1)])
+  updated_at: z2.string()
 });
-var AdmissionRowSchema = z2.object({
-  conversation_id: z2.string(),
-  idempotency_key: z2.string(),
-  input_payload: z2.string(),
-  run_id: z2.string(),
-  assistant_message_id: z2.string()
+var ArchiveSpillRowSchema = z2.object({
+  reference_id: z2.string(),
+  run_id: z2.string().nullable(),
+  tool_call_id: z2.string().nullable(),
+  media_type: z2.string(),
+  bytes: z2.int().nonnegative(),
+  sha256: z2.string(),
+  created_at: z2.string(),
+  expires_at: z2.string().nullable(),
+  authorization_payload: z2.string().nullable(),
+  payload: z2.instanceof(Uint8Array)
 });
-function parseJson2(value) {
-  return JSON.parse(value);
-}
-function createDurableTables(database) {
-  database.exec(`
-    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_events (
-      row_id INTEGER PRIMARY KEY AUTOINCREMENT,
-      conversation_id TEXT NOT NULL,
-      seq INTEGER NOT NULL CHECK (seq > 0),
-      event_id TEXT NOT NULL UNIQUE,
-      schema_version INTEGER NOT NULL CHECK (schema_version > 0),
-      kind TEXT NOT NULL,
-      occurred_at TEXT NOT NULL,
-      ignorable INTEGER NOT NULL DEFAULT 0 CHECK (ignorable IN (0, 1)),
-      payload TEXT NOT NULL,
-      UNIQUE (conversation_id, seq)
-    );
-    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_events_time
-      ON stitchkit_agent_runtime_events (conversation_id, occurred_at, seq);
-    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_projections (
-      conversation_id TEXT NOT NULL,
-      name TEXT NOT NULL,
-      version INTEGER NOT NULL CHECK (version > 0),
-      upto_seq INTEGER NOT NULL CHECK (upto_seq >= 0),
-      payload TEXT NOT NULL,
-      updated_at TEXT NOT NULL,
-      PRIMARY KEY (conversation_id, name)
-    );
-    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_projection_updates
-      ON stitchkit_agent_runtime_projections (name, updated_at, conversation_id);
-    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_spills (
-      reference_id TEXT PRIMARY KEY,
-      conversation_id TEXT NOT NULL,
-      run_id TEXT,
-      tool_call_id TEXT,
-      media_type TEXT NOT NULL,
-      bytes INTEGER NOT NULL CHECK (bytes >= 0),
-      sha256 TEXT NOT NULL,
-      created_at TEXT NOT NULL,
-      expires_at TEXT,
-      authorization_payload TEXT,
-      payload BLOB NOT NULL
-    );
-    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_spills_owner
-      ON stitchkit_agent_runtime_spills (conversation_id, created_at);
-    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_schedules (
-      id TEXT PRIMARY KEY,
-      conversation_id TEXT NOT NULL,
-      kind TEXT NOT NULL,
-      next_at TEXT NOT NULL,
-      interval_ms INTEGER,
-      time_zone TEXT,
-      input_payload TEXT NOT NULL,
-      state TEXT NOT NULL,
-      occurrence INTEGER NOT NULL DEFAULT 0 CHECK (occurrence >= 0),
-      claim_owner TEXT,
-      claim_until TEXT,
-      created_at TEXT NOT NULL,
-      updated_at TEXT NOT NULL
-    );
-    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_schedules_due
-      ON stitchkit_agent_runtime_schedules (state, next_at);
-    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_children (
-      parent_conversation_id TEXT NOT NULL,
-      child_conversation_id TEXT NOT NULL UNIQUE,
-      seed_upto_seq INTEGER,
-      state TEXT NOT NULL,
-      budget_payload TEXT NOT NULL,
-      usage_payload TEXT NOT NULL,
-      result_reference TEXT,
-      created_at TEXT NOT NULL,
-      updated_at TEXT NOT NULL,
-      PRIMARY KEY (parent_conversation_id, child_conversation_id)
-    );
-  `);
-  try {
-    database.exec(`
-      CREATE VIRTUAL TABLE IF NOT EXISTS stitchkit_agent_runtime_events_fts
-      USING fts5(
-        conversation_id UNINDEXED,
-        event_seq UNINDEXED,
-        occurred_at UNINDEXED,
-        body,
-        tokenize = 'unicode61 remove_diacritics 2'
-      );
-      CREATE TRIGGER IF NOT EXISTS stitchkit_agent_runtime_events_fts_insert
-      AFTER INSERT ON stitchkit_agent_runtime_events BEGIN
-        INSERT INTO stitchkit_agent_runtime_events_fts(
-          rowid, conversation_id, event_seq, occurred_at, body
-        ) VALUES (new.row_id, new.conversation_id, new.seq, new.occurred_at, new.payload);
-      END;
-      CREATE TRIGGER IF NOT EXISTS stitchkit_agent_runtime_events_fts_delete
-      AFTER DELETE ON stitchkit_agent_runtime_events BEGIN
-        DELETE FROM stitchkit_agent_runtime_events_fts WHERE rowid = old.row_id;
-      END;
-    `);
-  } catch (error) {
-    throw new Error("SQLite agent-runtime requires FTS5 support", { cause: error });
+var sqliteEvents = {
+  async append(transaction, rawEvent) {
+    const event = rawEvent;
+    const last = transaction.prepare("SELECT COALESCE(MAX(seq), 0) AS count FROM stitchkit_agent_runtime_events WHERE conversation_id = ?").get(event.conversationId);
+    const seq = CountRowSchema.parse(last).count + 1;
+    transaction.prepare(`
+        INSERT INTO stitchkit_agent_runtime_events (
+          conversation_id, seq, event_id, schema_version, kind, occurred_at, ignorable, payload
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(event.conversationId, seq, event.eventId, event.schemaVersion, event.kind, event.occurredAt, event.ignorable ? 1 : 0, encodeJson(event.payload));
+    return AgentStoreEventEnvelopeSchema2.parse({ ...event, seq });
+  },
+  async list(transaction, input) {
+    const clauses = ["conversation_id = ?"];
+    const values = [input.conversationId];
+    if (input.fromSeq !== undefined) {
+      clauses.push("seq >= ?");
+      values.push(input.fromSeq);
+    }
+    if (input.toSeq !== undefined) {
+      clauses.push("seq <= ?");
+      values.push(input.toSeq);
+    }
+    const rows = transaction.prepare(`
+        SELECT event_id, conversation_id, seq, schema_version, kind, occurred_at,
+          ignorable, payload
+        FROM stitchkit_agent_runtime_events
+        WHERE ${clauses.join(" AND ")}
+        ORDER BY seq ASC LIMIT ?
+      `).all(...values, input.limit + 1).map(parseEventRow);
+    const hasMore = rows.length > input.limit;
+    const items = rows.slice(0, input.limit);
+    const lastEvent = items.at(-1);
+    return AgentStoreEventPageSchema2.parse({
+      items,
+      ...hasMore && lastEvent ? { nextSeq: lastEvent.seq + 1 } : {}
+    });
+  },
+  async find(transaction, input) {
+    const row = transaction.prepare(`
+        SELECT event_id, conversation_id, seq, schema_version, kind, occurred_at,
+          ignorable, payload
+        FROM stitchkit_agent_runtime_events
+        WHERE event_id = ? AND conversation_id = ?
+      `).get(input.eventId, input.conversationId);
+    return row === null || row === undefined ? undefined : parseEventRow(row);
   }
-}
-function writeBaselines(database, migratedAt) {
-  const conversations = database.prepare("SELECT conversation_id, version FROM stitchkit_agent_runtime_heads ORDER BY conversation_id").all().map((row) => ConversationRowSchema.parse(row));
-  const insert = database.prepare(`
-    INSERT INTO stitchkit_agent_runtime_events (
-      conversation_id, seq, event_id, schema_version, kind, occurred_at, ignorable, payload
-    ) VALUES (?, 1, ?, 1, 'runtime/baseline', ?, 0, ?)
-  `);
-  for (const conversation of conversations) {
-    const rows = database.prepare("SELECT payload, active FROM stitchkit_agent_runtime_messages WHERE conversation_id = ? ORDER BY position, rowid").all(conversation.conversation_id).map((row) => {
-      const parsed = HistoryRowSchema.parse(row);
+};
+var sqliteArchive = {
+  async export(transaction, conversationId) {
+    const projections = transaction.prepare(`
+        SELECT name, version, upto_seq, payload, updated_at
+        FROM stitchkit_agent_runtime_projections
+        WHERE conversation_id = ? ORDER BY name
+      `).all(conversationId).map((raw) => {
+      const row = ArchiveProjectionRowSchema.parse(raw);
       return {
-        message: AgentMessageSchema2.parse(parseJson2(parsed.payload)),
-        active: parsed.active === 1
-      };
-    });
-    const messages = rows.map((row) => row.message);
-    const compacted = rows.filter((row) => !row.active).map((row) => row.message.id);
-    const runs = database.prepare("SELECT payload, terminal_assistant_payload FROM stitchkit_agent_runtime_runs WHERE conversation_id = ? ORDER BY created_at, run_id").all(conversation.conversation_id).map((value) => {
-      const row = PayloadRowSchema.parse(value);
-      return {
-        schemaVersion: 1,
-        run: AgentRunSchema2.parse(parseJson2(row.payload)),
-        ...row.terminal_assistant_payload ? {
-          terminalAssistant: AgentMessageSchema2.parse(parseJson2(row.terminal_assistant_payload))
-        } : {}
-      };
-    });
-    const admissions = database.prepare("SELECT conversation_id, idempotency_key, input_payload, run_id, assistant_message_id FROM stitchkit_agent_runtime_admissions WHERE conversation_id = ? ORDER BY idempotency_key").all(conversation.conversation_id).map((value) => {
-      const row = AdmissionRowSchema.parse(value);
-      return {
-        schemaVersion: 1,
-        conversationId: row.conversation_id,
-        idempotencyKey: row.idempotency_key,
-        input: AgentMessageSchema2.parse(parseJson2(row.input_payload)),
-        runId: row.run_id,
-        assistantMessageId: row.assistant_message_id
-      };
-    });
-    const asOf = messages.at(-1)?.createdAt ?? runs.at(-1)?.run.createdAt;
-    insert.run(conversation.conversation_id, randomUUID(), migratedAt, canonicalAgentJson2({
-      migratedAt,
-      ...asOf !== undefined && { asOf },
-      head: {
-        schemaVersion: 1,
-        conversationId: conversation.conversation_id,
-        version: conversation.version
-      },
-      messages,
-      ...compacted.length > 0 && { compacted },
-      runs,
-      admissions
-    }));
-  }
-}
-function migrateAgentRuntimeSqliteV1ToV2(database, migratedAt = new Date().toISOString()) {
-  createDurableTables(database);
-  writeBaselines(database, migratedAt);
-  database.prepare("UPDATE stitchkit_agent_runtime_meta SET value = '2' WHERE key = 'schema_version'").run();
-}
-function createAgentRuntimeSqliteV2Tables(database) {
-  createDurableTables(database);
-}
-
-// src/agent-runtime/store-migrations/v2-to-v3.ts
-function createAgentRuntimeSqliteV3Tables(database) {
-  database.exec(`
-    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_seeds (
-      conversation_id TEXT NOT NULL,
-      seed_key TEXT NOT NULL,
-      message_ids TEXT NOT NULL,
-      created_at TEXT NOT NULL,
-      PRIMARY KEY (conversation_id, seed_key)
-    );
-  `);
-}
-function migrateAgentRuntimeSqliteV2ToV3(database) {
-  createAgentRuntimeSqliteV3Tables(database);
-  database.prepare("UPDATE stitchkit_agent_runtime_meta SET value = '3' WHERE key = 'schema_version'").run();
-}
-
-// src/agent-runtime/store-migrations/v3-to-v4.ts
-function migrateAgentRuntimeSqliteV3ToV4(database) {
-  database.exec(`
-    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN retry_at TEXT;
-    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN attempts INTEGER NOT NULL DEFAULT 0;
-    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN last_error TEXT;
-    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN eligible_at TEXT
-      GENERATED ALWAYS AS (MAX(next_at, COALESCE(retry_at, next_at), COALESCE(claim_until, next_at))) VIRTUAL;
-    DROP INDEX stitchkit_agent_runtime_schedules_due;
-    CREATE INDEX stitchkit_agent_runtime_schedules_due
-      ON stitchkit_agent_runtime_schedules (eligible_at, id) WHERE state = 'scheduled';
-    UPDATE stitchkit_agent_runtime_meta SET value = '4' WHERE key = 'schema_version';
-  `);
-}
-
-// src/agent-runtime/sqlite-schema.ts
-var MetaRowSchema = z3.object({ value: z3.string() });
-var TableRowSchema = z3.object({ name: z3.string() });
-var SCHEMA_VERSION = 4;
-var TABLES = [
-  "stitchkit_agent_runtime_heads",
-  "stitchkit_agent_runtime_runs",
-  "stitchkit_agent_runtime_admissions",
-  "stitchkit_agent_runtime_messages",
-  "stitchkit_agent_runtime_seeds",
-  "stitchkit_agent_runtime_events",
-  "stitchkit_agent_runtime_projections",
-  "stitchkit_agent_runtime_spills",
-  "stitchkit_agent_runtime_schedules",
-  "stitchkit_agent_runtime_children"
-];
-function initializeAgentRuntimeSqlite2(database) {
-  database.exec("BEGIN IMMEDIATE");
-  try {
-    const existing = database.prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name LIKE 'stitchkit_agent_runtime_%' ORDER BY name`).all().map((row) => TableRowSchema.parse(row).name);
-    const hasMeta = existing.includes("stitchkit_agent_runtime_meta");
-    if (!hasMeta && existing.length > 0) {
-      throw new Error("Refusing an unversioned partial Stitchkit agent-runtime SQLite schema");
-    }
-    database.exec(`
-      CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_meta (
-        key TEXT PRIMARY KEY,
-        value TEXT NOT NULL
-      );
-    `);
-    const versionRow = database.prepare("SELECT value FROM stitchkit_agent_runtime_meta WHERE key = 'schema_version'").get();
-    if (!missing(versionRow)) {
-      const version = Number(MetaRowSchema.parse(versionRow).value);
-      if (version === 1) {
-        migrateAgentRuntimeSqliteV1ToV2(database);
-        migrateAgentRuntimeSqliteV2ToV3(database);
-        migrateAgentRuntimeSqliteV3ToV4(database);
-        initializeSqliteConversationPurge(database);
-        database.exec("COMMIT");
-        return;
-      }
-      if (version === 2) {
-        migrateAgentRuntimeSqliteV2ToV3(database);
-        migrateAgentRuntimeSqliteV3ToV4(database);
-        initializeSqliteConversationPurge(database);
-        database.exec("COMMIT");
-        return;
-      }
-      if (version === 3) {
-        migrateAgentRuntimeSqliteV3ToV4(database);
-        initializeSqliteConversationPurge(database);
-        database.exec("COMMIT");
-        return;
-      }
-      if (version !== SCHEMA_VERSION) {
-        throw new Error(`Unsupported Stitchkit agent-runtime SQLite schema version ${version}; expected ${SCHEMA_VERSION}`);
-      }
-      const missingTables = TABLES.filter((table) => !existing.includes(table));
-      if (missingTables.length > 0) {
-        throw new Error(`Refusing a partial Stitchkit agent-runtime SQLite schema; missing ${missingTables.join(", ")}`);
-      }
-      initializeSqliteConversationPurge(database);
-      database.exec("COMMIT");
-      return;
-    }
-    if (existing.some((table) => table !== "stitchkit_agent_runtime_meta")) {
-      throw new Error("Refusing an unversioned partial Stitchkit agent-runtime SQLite schema");
-    }
-    database.exec(`
-      CREATE TABLE stitchkit_agent_runtime_heads (
-        conversation_id TEXT PRIMARY KEY,
-        version INTEGER NOT NULL CHECK (version >= 0)
-      );
-      CREATE TABLE stitchkit_agent_runtime_runs (
-        conversation_id TEXT NOT NULL,
-        run_id TEXT NOT NULL,
-        assistant_message_id TEXT NOT NULL,
-        state TEXT NOT NULL,
-        created_at TEXT NOT NULL,
-        payload TEXT NOT NULL,
-        terminal_assistant_payload TEXT,
-        PRIMARY KEY (conversation_id, run_id),
-        UNIQUE (conversation_id, assistant_message_id)
-      );
-      CREATE INDEX stitchkit_agent_runtime_recoverable
-        ON stitchkit_agent_runtime_runs (state, conversation_id, run_id);
-      CREATE TABLE stitchkit_agent_runtime_admissions (
-        conversation_id TEXT NOT NULL,
-        idempotency_key TEXT NOT NULL,
-        input_message_id TEXT NOT NULL,
-        run_id TEXT NOT NULL,
-        assistant_message_id TEXT NOT NULL,
-        input_payload TEXT NOT NULL,
-        PRIMARY KEY (conversation_id, idempotency_key),
-        UNIQUE (conversation_id, input_message_id)
-      );
-      CREATE TABLE stitchkit_agent_runtime_messages (
-        conversation_id TEXT NOT NULL,
-        id TEXT NOT NULL,
-        position INTEGER NOT NULL CHECK (position >= 0),
-        active INTEGER NOT NULL DEFAULT 1 CHECK (active IN (0, 1)),
-        payload TEXT NOT NULL,
-        PRIMARY KEY (conversation_id, id)
-      );
-    `);
-    createAgentRuntimeSqliteV2Tables(database);
-    createAgentRuntimeSqliteV3Tables(database);
-    database.prepare("INSERT INTO stitchkit_agent_runtime_meta (key, value) VALUES ('schema_version', '3')").run();
-    migrateAgentRuntimeSqliteV3ToV4(database);
-    initializeSqliteConversationPurge(database);
-    database.exec("COMMIT");
-  } catch (error) {
-    database.exec("ROLLBACK");
-    throw error;
-  }
-}
-
-// src/agent-runtime/sqlite-events.ts
-import { createHash } from "node:crypto";
-import { z as z4 } from "zod";
-var ArchiveProjectionRowSchema = z4.object({
-  name: z4.string(),
-  version: z4.int().positive(),
-  upto_seq: z4.int().nonnegative(),
-  payload: z4.string(),
-  updated_at: z4.string()
-});
-var ArchiveSpillRowSchema = z4.object({
-  reference_id: z4.string(),
-  run_id: z4.string().nullable(),
-  tool_call_id: z4.string().nullable(),
-  media_type: z4.string(),
-  bytes: z4.int().nonnegative(),
-  sha256: z4.string(),
-  created_at: z4.string(),
-  expires_at: z4.string().nullable(),
-  authorization_payload: z4.string().nullable(),
-  payload: z4.instanceof(Uint8Array)
-});
-var sqliteEvents = {
-  async append(transaction, rawEvent) {
-    const event = rawEvent;
-    const last = transaction.prepare("SELECT COALESCE(MAX(seq), 0) AS count FROM stitchkit_agent_runtime_events WHERE conversation_id = ?").get(event.conversationId);
-    const seq = CountRowSchema.parse(last).count + 1;
-    transaction.prepare(`
-        INSERT INTO stitchkit_agent_runtime_events (
-          conversation_id, seq, event_id, schema_version, kind, occurred_at, ignorable, payload
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(event.conversationId, seq, event.eventId, event.schemaVersion, event.kind, event.occurredAt, event.ignorable ? 1 : 0, encodeJson(event.payload));
-    return AgentStoreEventEnvelopeSchema2.parse({ ...event, seq });
-  },
-  async list(transaction, input) {
-    const clauses = ["conversation_id = ?"];
-    const values = [input.conversationId];
-    if (input.fromSeq !== undefined) {
-      clauses.push("seq >= ?");
-      values.push(input.fromSeq);
-    }
-    if (input.toSeq !== undefined) {
-      clauses.push("seq <= ?");
-      values.push(input.toSeq);
-    }
-    const rows = transaction.prepare(`
-        SELECT event_id, conversation_id, seq, schema_version, kind, occurred_at,
-          ignorable, payload
-        FROM stitchkit_agent_runtime_events
-        WHERE ${clauses.join(" AND ")}
-        ORDER BY seq ASC LIMIT ?
-      `).all(...values, input.limit + 1).map(parseEventRow);
-    const hasMore = rows.length > input.limit;
-    const items = rows.slice(0, input.limit);
-    const lastEvent = items.at(-1);
-    return AgentStoreEventPageSchema2.parse({
-      items,
-      ...hasMore && lastEvent ? { nextSeq: lastEvent.seq + 1 } : {}
-    });
-  },
-  async find(transaction, input) {
-    const row = transaction.prepare(`
-        SELECT event_id, conversation_id, seq, schema_version, kind, occurred_at,
-          ignorable, payload
-        FROM stitchkit_agent_runtime_events
-        WHERE event_id = ? AND conversation_id = ?
-      `).get(input.eventId, input.conversationId);
-    return row === null || row === undefined ? undefined : parseEventRow(row);
-  }
-};
-var sqliteArchive = {
-  async export(transaction, conversationId) {
-    const projections = transaction.prepare(`
-        SELECT name, version, upto_seq, payload, updated_at
-        FROM stitchkit_agent_runtime_projections
-        WHERE conversation_id = ? ORDER BY name
-      `).all(conversationId).map((raw) => {
-      const row = ArchiveProjectionRowSchema.parse(raw);
-      return {
-        name: row.name,
-        version: row.version,
-        uptoSeq: row.upto_seq,
-        value: z4.json().parse(parseJson(row.payload)),
-        updatedAt: row.updated_at
+        name: row.name,
+        version: row.version,
+        uptoSeq: row.upto_seq,
+        value: z2.json().parse(parseJson(row.payload)),
+        updatedAt: row.updated_at
       };
     });
     const spills = transaction.prepare(`
@@ -581,7 +188,7 @@ var sqliteArchive = {
         createdAt: row.created_at,
         ...row.expires_at && { expiresAt: row.expires_at },
         ...row.authorization_payload && {
-          authorization: z4.json().parse(parseJson(row.authorization_payload))
+          authorization: z2.json().parse(parseJson(row.authorization_payload))
         },
         base64: Buffer.from(row.payload).toString("base64")
       };
@@ -601,17 +208,17 @@ var sqliteArchive = {
         `).run(archive.conversationId, projection.name, projection.version, projection.uptoSeq, encodeJson(projection.value), projection.updatedAt);
     }
     for (const raw of archive.spills) {
-      const spill = z4.object({
-        reference: z4.string(),
-        runId: z4.string().optional(),
-        toolCallId: z4.string().optional(),
-        mediaType: z4.string(),
-        bytes: z4.int().nonnegative(),
-        sha256: z4.string(),
-        createdAt: z4.string(),
-        expiresAt: z4.string().optional(),
-        authorization: z4.json().optional(),
-        base64: z4.string()
+      const spill = z2.object({
+        reference: z2.string(),
+        runId: z2.string().optional(),
+        toolCallId: z2.string().optional(),
+        mediaType: z2.string(),
+        bytes: z2.int().nonnegative(),
+        sha256: z2.string(),
+        createdAt: z2.string(),
+        expiresAt: z2.string().optional(),
+        authorization: z2.json().optional(),
+        base64: z2.string()
       }).strict().parse(raw);
       const payload = Buffer.from(spill.base64, "base64");
       if (payload.byteLength !== spill.bytes) {
@@ -740,21 +347,21 @@ var sqliteHistory = {
 };
 
 // src/agent-runtime/sqlite-ledger.ts
-import { z as z5 } from "zod";
-var AdmissionRowSchema2 = z5.object({
-  conversation_id: z5.string(),
-  idempotency_key: z5.string(),
-  input_payload: z5.string(),
-  run_id: z5.string(),
-  assistant_message_id: z5.string()
+import { z as z3 } from "zod";
+var AdmissionRowSchema = z3.object({
+  conversation_id: z3.string(),
+  idempotency_key: z3.string(),
+  input_payload: z3.string(),
+  run_id: z3.string(),
+  assistant_message_id: z3.string()
 });
-var SeedRowSchema = z5.object({
-  conversation_id: z5.string(),
-  seed_key: z5.string(),
-  message_ids: z5.string()
+var SeedRowSchema = z3.object({
+  conversation_id: z3.string(),
+  seed_key: z3.string(),
+  message_ids: z3.string()
 });
 function parseAdmissionRow(value) {
-  const row = AdmissionRowSchema2.parse(value);
+  const row = AdmissionRowSchema.parse(value);
   return AgentAdmissionReceiptSchema2.parse({
     schemaVersion: 1,
     conversationId: row.conversation_id,
@@ -879,7 +486,7 @@ var sqliteSeeds = {
       schemaVersion: 1,
       conversationId: row.conversation_id,
       seedKey: row.seed_key,
-      messageIds: z5.array(z5.string().min(1)).parse(parseJson(row.message_ids))
+      messageIds: z3.array(z3.string().min(1)).parse(parseJson(row.message_ids))
     });
   },
   async create(transaction, rawReceipt) {
@@ -892,8 +499,66 @@ var sqliteSeeds = {
   }
 };
 
+// src/agent-runtime/sqlite-purge.ts
+var OWNED_TABLES = [
+  "stitchkit_agent_runtime_spills",
+  "stitchkit_agent_runtime_schedules",
+  "stitchkit_agent_runtime_projections",
+  "stitchkit_agent_runtime_events",
+  "stitchkit_agent_runtime_messages",
+  "stitchkit_agent_runtime_seeds",
+  "stitchkit_agent_runtime_admissions",
+  "stitchkit_agent_runtime_runs",
+  "stitchkit_agent_runtime_heads"
+];
+function initializeSqliteConversationPurge(database) {
+  database.exec(`
+    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_purged (
+      conversation_id TEXT PRIMARY KEY
+    );
+  `);
+  for (const table of OWNED_TABLES) {
+    for (const operation of ["INSERT", "UPDATE"]) {
+      database.exec(`
+        CREATE TRIGGER IF NOT EXISTS ${table}_purge_${operation.toLowerCase()}
+        BEFORE ${operation} ON ${table}
+        WHEN EXISTS (
+          SELECT 1 FROM stitchkit_agent_runtime_purged WHERE conversation_id = NEW.conversation_id
+        )
+        BEGIN SELECT RAISE(ABORT, 'Agent conversation has been purged'); END;
+      `);
+    }
+  }
+}
+function sqliteConversationPurge(database) {
+  const table = database.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'stitchkit_agent_runtime_purged'").get();
+  if (table === null || table === undefined)
+    return;
+  return {
+    async isEmpty(transaction, conversationId) {
+      for (const table of OWNED_TABLES) {
+        const row = transaction.prepare(`SELECT 1 FROM ${table} WHERE conversation_id = ? LIMIT 1`).get(conversationId);
+        if (row !== null && row !== undefined)
+          return false;
+      }
+      return transaction.prepare("SELECT 1 FROM stitchkit_agent_runtime_children WHERE parent_conversation_id = ? OR child_conversation_id = ? LIMIT 1").get(conversationId, conversationId) == null;
+    },
+    async isPurged(transaction, conversationId) {
+      const row = transaction.prepare("SELECT conversation_id FROM stitchkit_agent_runtime_purged WHERE conversation_id = ?").get(conversationId);
+      return row !== null && row !== undefined;
+    },
+    async remove(transaction, conversationId) {
+      transaction.prepare("INSERT INTO stitchkit_agent_runtime_purged (conversation_id) VALUES (?)").run(conversationId);
+      for (const table of OWNED_TABLES) {
+        transaction.prepare(`DELETE FROM ${table} WHERE conversation_id = ?`).run(conversationId);
+      }
+      transaction.prepare("DELETE FROM stitchkit_agent_runtime_children WHERE parent_conversation_id = ? OR child_conversation_id = ?").run(conversationId, conversationId);
+    }
+  };
+}
+
 // src/agent-runtime/sqlite-reads.ts
-import { z as z6 } from "zod";
+import { z as z4 } from "zod";
 
 // src/agent-runtime/sqlite-transactions.ts
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -951,40 +616,40 @@ async function closeSqliteStore(state) {
 }
 
 // src/agent-runtime/sqlite-reads.ts
-var RecoverableRowSchema = z6.object({
-  conversation_id: z6.string(),
-  run_id: z6.string(),
-  payload: z6.string()
+var RecoverableRowSchema = z4.object({
+  conversation_id: z4.string(),
+  run_id: z4.string(),
+  payload: z4.string()
 });
-var ConversationHeadRowSchema = z6.object({
-  conversation_id: z6.string(),
-  version: z6.number().int().nonnegative()
+var ConversationHeadRowSchema = z4.object({
+  conversation_id: z4.string(),
+  version: z4.number().int().nonnegative()
 });
-var MessagePageRowSchema = z6.object({
-  row_id: z6.number().int().positive(),
-  position: z6.number().int().nonnegative(),
-  active: z6.union([z6.literal(0), z6.literal(1)]),
-  payload: z6.string()
+var MessagePageRowSchema = z4.object({
+  row_id: z4.number().int().positive(),
+  position: z4.number().int().nonnegative(),
+  active: z4.union([z4.literal(0), z4.literal(1)]),
+  payload: z4.string()
 });
 function recoveryCursor(conversationId, runId) {
   return encodeJson([conversationId, runId]);
 }
 function parseRecoveryCursor(cursor) {
-  return z6.tuple([z6.string().min(1), z6.string().min(1)]).parse(parseJson(cursor));
+  return z4.tuple([z4.string().min(1), z4.string().min(1)]).parse(parseJson(cursor));
 }
 function conversationCursor(conversationId) {
   return encodeJson([conversationId]);
 }
 function parseConversationCursor(cursor) {
-  return z6.tuple([z6.string().min(1)]).parse(parseJson(cursor))[0];
+  return z4.tuple([z4.string().min(1)]).parse(parseJson(cursor))[0];
 }
 function messageCursor(position, rowId) {
   return encodeJson([position, rowId]);
 }
 function parseMessageCursor(cursor) {
-  const parsed = z6.union([
-    z6.tuple([z6.int().nonnegative(), z6.int().positive()]),
-    z6.tuple([z6.int().nonnegative()])
+  const parsed = z4.union([
+    z4.tuple([z4.int().nonnegative(), z4.int().positive()]),
+    z4.tuple([z4.int().nonnegative()])
   ]).parse(parseJson(cursor));
   const [position, rowId] = parsed;
   return { position, ...rowId !== undefined && { rowId } };
@@ -1109,6 +774,343 @@ function pageSqliteConversationMessages(state, input) {
   });
 }
 
+// src/agent-runtime/sqlite-schema.ts
+import { z as z6 } from "zod";
+
+// src/agent-runtime/store-migrations/v1-to-v2.ts
+import { randomUUID } from "node:crypto";
+import { z as z5 } from "zod";
+var ConversationRowSchema = z5.object({
+  conversation_id: z5.string().min(1),
+  version: z5.int().nonnegative()
+});
+var PayloadRowSchema = z5.object({
+  payload: z5.string(),
+  terminal_assistant_payload: z5.string().nullable().optional()
+});
+var HistoryRowSchema = z5.object({
+  payload: z5.string(),
+  active: z5.union([z5.literal(0), z5.literal(1)])
+});
+var AdmissionRowSchema2 = z5.object({
+  conversation_id: z5.string(),
+  idempotency_key: z5.string(),
+  input_payload: z5.string(),
+  run_id: z5.string(),
+  assistant_message_id: z5.string()
+});
+function parseJson2(value) {
+  return JSON.parse(value);
+}
+function createDurableTables(database) {
+  database.exec(`
+    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_events (
+      row_id INTEGER PRIMARY KEY AUTOINCREMENT,
+      conversation_id TEXT NOT NULL,
+      seq INTEGER NOT NULL CHECK (seq > 0),
+      event_id TEXT NOT NULL UNIQUE,
+      schema_version INTEGER NOT NULL CHECK (schema_version > 0),
+      kind TEXT NOT NULL,
+      occurred_at TEXT NOT NULL,
+      ignorable INTEGER NOT NULL DEFAULT 0 CHECK (ignorable IN (0, 1)),
+      payload TEXT NOT NULL,
+      UNIQUE (conversation_id, seq)
+    );
+    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_events_time
+      ON stitchkit_agent_runtime_events (conversation_id, occurred_at, seq);
+    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_projections (
+      conversation_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      version INTEGER NOT NULL CHECK (version > 0),
+      upto_seq INTEGER NOT NULL CHECK (upto_seq >= 0),
+      payload TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (conversation_id, name)
+    );
+    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_projection_updates
+      ON stitchkit_agent_runtime_projections (name, updated_at, conversation_id);
+    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_spills (
+      reference_id TEXT PRIMARY KEY,
+      conversation_id TEXT NOT NULL,
+      run_id TEXT,
+      tool_call_id TEXT,
+      media_type TEXT NOT NULL,
+      bytes INTEGER NOT NULL CHECK (bytes >= 0),
+      sha256 TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      expires_at TEXT,
+      authorization_payload TEXT,
+      payload BLOB NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_spills_owner
+      ON stitchkit_agent_runtime_spills (conversation_id, created_at);
+    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_schedules (
+      id TEXT PRIMARY KEY,
+      conversation_id TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      next_at TEXT NOT NULL,
+      interval_ms INTEGER,
+      time_zone TEXT,
+      input_payload TEXT NOT NULL,
+      state TEXT NOT NULL,
+      occurrence INTEGER NOT NULL DEFAULT 0 CHECK (occurrence >= 0),
+      claim_owner TEXT,
+      claim_until TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS stitchkit_agent_runtime_schedules_due
+      ON stitchkit_agent_runtime_schedules (state, next_at);
+    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_children (
+      parent_conversation_id TEXT NOT NULL,
+      child_conversation_id TEXT NOT NULL UNIQUE,
+      seed_upto_seq INTEGER,
+      state TEXT NOT NULL,
+      budget_payload TEXT NOT NULL,
+      usage_payload TEXT NOT NULL,
+      result_reference TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (parent_conversation_id, child_conversation_id)
+    );
+  `);
+  try {
+    database.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS stitchkit_agent_runtime_events_fts
+      USING fts5(
+        conversation_id UNINDEXED,
+        event_seq UNINDEXED,
+        occurred_at UNINDEXED,
+        body,
+        tokenize = 'unicode61 remove_diacritics 2'
+      );
+      CREATE TRIGGER IF NOT EXISTS stitchkit_agent_runtime_events_fts_insert
+      AFTER INSERT ON stitchkit_agent_runtime_events BEGIN
+        INSERT INTO stitchkit_agent_runtime_events_fts(
+          rowid, conversation_id, event_seq, occurred_at, body
+        ) VALUES (new.row_id, new.conversation_id, new.seq, new.occurred_at, new.payload);
+      END;
+      CREATE TRIGGER IF NOT EXISTS stitchkit_agent_runtime_events_fts_delete
+      AFTER DELETE ON stitchkit_agent_runtime_events BEGIN
+        DELETE FROM stitchkit_agent_runtime_events_fts WHERE rowid = old.row_id;
+      END;
+    `);
+  } catch (error) {
+    throw new Error("SQLite agent-runtime requires FTS5 support", { cause: error });
+  }
+}
+function writeBaselines(database, migratedAt) {
+  const conversations = database.prepare("SELECT conversation_id, version FROM stitchkit_agent_runtime_heads ORDER BY conversation_id").all().map((row) => ConversationRowSchema.parse(row));
+  const insert = database.prepare(`
+    INSERT INTO stitchkit_agent_runtime_events (
+      conversation_id, seq, event_id, schema_version, kind, occurred_at, ignorable, payload
+    ) VALUES (?, 1, ?, 1, 'runtime/baseline', ?, 0, ?)
+  `);
+  for (const conversation of conversations) {
+    const rows = database.prepare("SELECT payload, active FROM stitchkit_agent_runtime_messages WHERE conversation_id = ? ORDER BY position, rowid").all(conversation.conversation_id).map((row) => {
+      const parsed = HistoryRowSchema.parse(row);
+      return {
+        message: AgentMessageSchema2.parse(parseJson2(parsed.payload)),
+        active: parsed.active === 1
+      };
+    });
+    const messages = rows.map((row) => row.message);
+    const compacted = rows.filter((row) => !row.active).map((row) => row.message.id);
+    const runs = database.prepare("SELECT payload, terminal_assistant_payload FROM stitchkit_agent_runtime_runs WHERE conversation_id = ? ORDER BY created_at, run_id").all(conversation.conversation_id).map((value) => {
+      const row = PayloadRowSchema.parse(value);
+      return {
+        schemaVersion: 1,
+        run: AgentRunSchema2.parse(parseJson2(row.payload)),
+        ...row.terminal_assistant_payload ? {
+          terminalAssistant: AgentMessageSchema2.parse(parseJson2(row.terminal_assistant_payload))
+        } : {}
+      };
+    });
+    const admissions = database.prepare("SELECT conversation_id, idempotency_key, input_payload, run_id, assistant_message_id FROM stitchkit_agent_runtime_admissions WHERE conversation_id = ? ORDER BY idempotency_key").all(conversation.conversation_id).map((value) => {
+      const row = AdmissionRowSchema2.parse(value);
+      return {
+        schemaVersion: 1,
+        conversationId: row.conversation_id,
+        idempotencyKey: row.idempotency_key,
+        input: AgentMessageSchema2.parse(parseJson2(row.input_payload)),
+        runId: row.run_id,
+        assistantMessageId: row.assistant_message_id
+      };
+    });
+    const asOf = messages.at(-1)?.createdAt ?? runs.at(-1)?.run.createdAt;
+    insert.run(conversation.conversation_id, randomUUID(), migratedAt, canonicalAgentJson2({
+      migratedAt,
+      ...asOf !== undefined && { asOf },
+      head: {
+        schemaVersion: 1,
+        conversationId: conversation.conversation_id,
+        version: conversation.version
+      },
+      messages,
+      ...compacted.length > 0 && { compacted },
+      runs,
+      admissions
+    }));
+  }
+}
+function migrateAgentRuntimeSqliteV1ToV2(database, migratedAt = new Date().toISOString()) {
+  createDurableTables(database);
+  writeBaselines(database, migratedAt);
+  database.prepare("UPDATE stitchkit_agent_runtime_meta SET value = '2' WHERE key = 'schema_version'").run();
+}
+function createAgentRuntimeSqliteV2Tables(database) {
+  createDurableTables(database);
+}
+
+// src/agent-runtime/store-migrations/v2-to-v3.ts
+function createAgentRuntimeSqliteV3Tables(database) {
+  database.exec(`
+    CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_seeds (
+      conversation_id TEXT NOT NULL,
+      seed_key TEXT NOT NULL,
+      message_ids TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      PRIMARY KEY (conversation_id, seed_key)
+    );
+  `);
+}
+function migrateAgentRuntimeSqliteV2ToV3(database) {
+  createAgentRuntimeSqliteV3Tables(database);
+  database.prepare("UPDATE stitchkit_agent_runtime_meta SET value = '3' WHERE key = 'schema_version'").run();
+}
+
+// src/agent-runtime/store-migrations/v3-to-v4.ts
+function migrateAgentRuntimeSqliteV3ToV4(database) {
+  database.exec(`
+    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN retry_at TEXT;
+    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN attempts INTEGER NOT NULL DEFAULT 0;
+    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN last_error TEXT;
+    ALTER TABLE stitchkit_agent_runtime_schedules ADD COLUMN eligible_at TEXT
+      GENERATED ALWAYS AS (MAX(next_at, COALESCE(retry_at, next_at), COALESCE(claim_until, next_at))) VIRTUAL;
+    DROP INDEX stitchkit_agent_runtime_schedules_due;
+    CREATE INDEX stitchkit_agent_runtime_schedules_due
+      ON stitchkit_agent_runtime_schedules (eligible_at, id) WHERE state = 'scheduled';
+    UPDATE stitchkit_agent_runtime_meta SET value = '4' WHERE key = 'schema_version';
+  `);
+}
+
+// src/agent-runtime/sqlite-schema.ts
+var MetaRowSchema = z6.object({ value: z6.string() });
+var TableRowSchema = z6.object({ name: z6.string() });
+var SCHEMA_VERSION = 4;
+var TABLES = [
+  "stitchkit_agent_runtime_heads",
+  "stitchkit_agent_runtime_runs",
+  "stitchkit_agent_runtime_admissions",
+  "stitchkit_agent_runtime_messages",
+  "stitchkit_agent_runtime_seeds",
+  "stitchkit_agent_runtime_events",
+  "stitchkit_agent_runtime_projections",
+  "stitchkit_agent_runtime_spills",
+  "stitchkit_agent_runtime_schedules",
+  "stitchkit_agent_runtime_children"
+];
+function initializeAgentRuntimeSqlite2(database) {
+  database.exec("BEGIN IMMEDIATE");
+  try {
+    const existing = database.prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name LIKE 'stitchkit_agent_runtime_%' ORDER BY name`).all().map((row) => TableRowSchema.parse(row).name);
+    const hasMeta = existing.includes("stitchkit_agent_runtime_meta");
+    if (!hasMeta && existing.length > 0) {
+      throw new Error("Refusing an unversioned partial Stitchkit agent-runtime SQLite schema");
+    }
+    database.exec(`
+      CREATE TABLE IF NOT EXISTS stitchkit_agent_runtime_meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+    const versionRow = database.prepare("SELECT value FROM stitchkit_agent_runtime_meta WHERE key = 'schema_version'").get();
+    if (!missing(versionRow)) {
+      const version = Number(MetaRowSchema.parse(versionRow).value);
+      if (version === 1) {
+        migrateAgentRuntimeSqliteV1ToV2(database);
+        migrateAgentRuntimeSqliteV2ToV3(database);
+        migrateAgentRuntimeSqliteV3ToV4(database);
+        initializeSqliteConversationPurge(database);
+        database.exec("COMMIT");
+        return;
+      }
+      if (version === 2) {
+        migrateAgentRuntimeSqliteV2ToV3(database);
+        migrateAgentRuntimeSqliteV3ToV4(database);
+        initializeSqliteConversationPurge(database);
+        database.exec("COMMIT");
+        return;
+      }
+      if (version === 3) {
+        migrateAgentRuntimeSqliteV3ToV4(database);
+        initializeSqliteConversationPurge(database);
+        database.exec("COMMIT");
+        return;
+      }
+      if (version !== SCHEMA_VERSION) {
+        throw new Error(`Unsupported Stitchkit agent-runtime SQLite schema version ${version}; expected ${SCHEMA_VERSION}`);
+      }
+      const missingTables = TABLES.filter((table) => !existing.includes(table));
+      if (missingTables.length > 0) {
+        throw new Error(`Refusing a partial Stitchkit agent-runtime SQLite schema; missing ${missingTables.join(", ")}`);
+      }
+      initializeSqliteConversationPurge(database);
+      database.exec("COMMIT");
+      return;
+    }
+    if (existing.some((table) => table !== "stitchkit_agent_runtime_meta")) {
+      throw new Error("Refusing an unversioned partial Stitchkit agent-runtime SQLite schema");
+    }
+    database.exec(`
+      CREATE TABLE stitchkit_agent_runtime_heads (
+        conversation_id TEXT PRIMARY KEY,
+        version INTEGER NOT NULL CHECK (version >= 0)
+      );
+      CREATE TABLE stitchkit_agent_runtime_runs (
+        conversation_id TEXT NOT NULL,
+        run_id TEXT NOT NULL,
+        assistant_message_id TEXT NOT NULL,
+        state TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        terminal_assistant_payload TEXT,
+        PRIMARY KEY (conversation_id, run_id),
+        UNIQUE (conversation_id, assistant_message_id)
+      );
+      CREATE INDEX stitchkit_agent_runtime_recoverable
+        ON stitchkit_agent_runtime_runs (state, conversation_id, run_id);
+      CREATE TABLE stitchkit_agent_runtime_admissions (
+        conversation_id TEXT NOT NULL,
+        idempotency_key TEXT NOT NULL,
+        input_message_id TEXT NOT NULL,
+        run_id TEXT NOT NULL,
+        assistant_message_id TEXT NOT NULL,
+        input_payload TEXT NOT NULL,
+        PRIMARY KEY (conversation_id, idempotency_key),
+        UNIQUE (conversation_id, input_message_id)
+      );
+      CREATE TABLE stitchkit_agent_runtime_messages (
+        conversation_id TEXT NOT NULL,
+        id TEXT NOT NULL,
+        position INTEGER NOT NULL CHECK (position >= 0),
+        active INTEGER NOT NULL DEFAULT 1 CHECK (active IN (0, 1)),
+        payload TEXT NOT NULL,
+        PRIMARY KEY (conversation_id, id)
+      );
+    `);
+    createAgentRuntimeSqliteV2Tables(database);
+    createAgentRuntimeSqliteV3Tables(database);
+    database.prepare("INSERT INTO stitchkit_agent_runtime_meta (key, value) VALUES ('schema_version', '3')").run();
+    migrateAgentRuntimeSqliteV3ToV4(database);
+    initializeSqliteConversationPurge(database);
+    database.exec("COMMIT");
+  } catch (error) {
+    database.exec("ROLLBACK");
+    throw error;
+  }
+}
+
 // src/agent-runtime/sqlite.ts
 function createSqliteAgentRuntimeStore2(config) {
   const database = config.database;