@saadnvd1/agent-os 0.3.596 → 0.3.600

package/lib/db/migrations/0018_add_chat.ts

@@ -0,0 +1,23 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 18,
+  name: "add_chat",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN view TEXT NOT NULL DEFAULT 'terminal'`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS chat_items (
+          session_id TEXT NOT NULL,
+          item_id TEXT NOT NULL,
+          seq INTEGER NOT NULL,
+          data TEXT NOT NULL,
+          PRIMARY KEY (session_id, item_id)
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_chat_items_seq ON chat_items(session_id, seq)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0019_add_lumifyhub.ts

@@ -0,0 +1,36 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 19,
+  name: "add_lumifyhub",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS lumifyhub_connection (
+          id INTEGER PRIMARY KEY CHECK (id = 1),
+          base_url TEXT NOT NULL,
+          token TEXT NOT NULL,
+          user_id TEXT,
+          user_email TEXT,
+          user_name TEXT,
+          connected_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS lumifyhub_connect_attempts (
+          state TEXT PRIMARY KEY,
+          verifier TEXT NOT NULL,
+          redirect_uri TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(`ALTER TABLE workspaces ADD COLUMN lh_workspace_id TEXT`);
+    db.exec(`ALTER TABLE workspaces ADD COLUMN lh_workspace_slug TEXT`);
+    db.exec(`ALTER TABLE workspaces ADD COLUMN lh_workspace_name TEXT`);
+    db.exec(`ALTER TABLE projects ADD COLUMN lh_board_id TEXT`);
+    db.exec(`ALTER TABLE projects ADD COLUMN lh_board_name TEXT`);
+    db.exec(`ALTER TABLE projects ADD COLUMN lh_board_page_id TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN lh_card_id TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN lh_board_id TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN lh_card_list TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0020_add_lumifyhub_published_docs.ts

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 20,
+  name: "add_lumifyhub_published_docs",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS lumifyhub_published_docs (
+          project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+          repo_path TEXT NOT NULL,
+          page_id TEXT NOT NULL,
+          content_hash TEXT NOT NULL,
+          published_at TEXT NOT NULL DEFAULT (datetime('now')),
+          PRIMARY KEY (project_id, repo_path)
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0021_add_chat_access.ts

@@ -0,0 +1,14 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 21,
+  name: "add_chat_access",
+  up: (db) => {
+    // What a chat agent may do without asking; full is the old behavior.
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN chat_access TEXT NOT NULL DEFAULT 'full'`
+    );
+    // After an undo, where the next start resumes the conversation from.
+    db.exec(`ALTER TABLE sessions ADD COLUMN chat_resume_at TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0022_add_last_seen.ts

@@ -0,0 +1,10 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 22,
+  name: "add_last_seen",
+  up: (db) => {
+    // When the reader last looked, so "needs you" means something new.
+    db.exec(`ALTER TABLE sessions ADD COLUMN last_seen_at TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0023_mark_existing_sessions_seen.ts

@@ -0,0 +1,12 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 23,
+  name: "mark_existing_sessions_seen",
+  up: (db) => {
+    // Start quiet: what finished before "needs you" meant news is old news.
+    db.exec(
+      `UPDATE sessions SET last_seen_at = datetime('now') WHERE last_seen_at IS NULL`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0024_add_stacks.ts

@@ -0,0 +1,49 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 24,
+  name: "add_stacks",
+  up: (db) => {
+    // A LumifyHub board's cards run as stacked tasks (lib/stacks).
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS stacks (
+          id TEXT PRIMARY KEY,
+          project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+          lh_board_id TEXT NOT NULL,
+          name TEXT NOT NULL,
+          status TEXT NOT NULL DEFAULT 'running',
+          max_parallel INTEGER NOT NULL DEFAULT 3,
+          progress TEXT,
+          error TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          landed_at TEXT
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS stack_items (
+          id TEXT PRIMARY KEY,
+          stack_id TEXT NOT NULL REFERENCES stacks(id) ON DELETE CASCADE,
+          position INTEGER NOT NULL,
+          lh_card_id TEXT NOT NULL,
+          ticket TEXT,
+          title TEXT NOT NULL,
+          parent_item_id TEXT,
+          also_item_ids TEXT NOT NULL DEFAULT '[]',
+          blocker_item_ids TEXT NOT NULL DEFAULT '[]',
+          status TEXT NOT NULL DEFAULT 'planned',
+          session_id TEXT,
+          base_branch TEXT,
+          base_tip TEXT,
+          pr_number INTEGER,
+          note TEXT,
+          error TEXT
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_stack_items_stack ON stack_items(stack_id, position)`
+    );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_stack_items_session ON stack_items(session_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0025_add_stack_item_attempts.ts

@@ -0,0 +1,16 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 25,
+  name: "add_stack_item_attempts",
+  up: (db) => {
+    // Starts retried after a transient failure, and holds the plan made
+    // (an open blocker outside the stack) that a retry must not undo.
+    db.exec(
+      `ALTER TABLE stack_items ADD COLUMN attempts INTEGER NOT NULL DEFAULT 0`
+    );
+    db.exec(
+      `ALTER TABLE stack_items ADD COLUMN held_outside INTEGER NOT NULL DEFAULT 0`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0026_add_workspace_orchestrator.ts

@@ -0,0 +1,47 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 26,
+  name: "add_workspace_orchestrator",
+  up: (db) => {
+    // One standing orchestrator chat per workspace. Its events are kept
+    // by key: a key present means that event is known, delivered or
+    // queued. An event is sent once seen on two diffs in a row (hits);
+    // a passing one that cleared is remembered (cleared_at) so it can't
+    // fire again too soon. The log counts deliveries per subject.
+    db.exec(`ALTER TABLE sessions ADD COLUMN role TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN workspace_id TEXT`);
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_sessions_orchestrator
+         ON sessions(workspace_id) WHERE role = 'orchestrator'`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_events (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          key TEXT NOT NULL,
+          subject TEXT,
+          line TEXT NOT NULL,
+          sticky INTEGER NOT NULL DEFAULT 1,
+          low INTEGER NOT NULL DEFAULT 0,
+          hits INTEGER NOT NULL DEFAULT 1,
+          created_at TEXT NOT NULL,
+          delivered_at TEXT,
+          cleared_at TEXT,
+          UNIQUE (workspace_id, key)
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_event_log (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          subject TEXT,
+          delivered_at TEXT NOT NULL
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_event_log
+         ON orchestrator_event_log(workspace_id, delivered_at)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0027_add_devices_and_settings.ts

@@ -0,0 +1,28 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 27,
+  name: "add_devices_and_settings",
+  up: (db) => {
+    // Paired phones, tablets and laptops. Only a hash of each token is kept.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS devices (
+          id TEXT PRIMARY KEY,
+          name TEXT NOT NULL,
+          token_hash TEXT NOT NULL UNIQUE,
+          user_agent TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          last_seen_at TEXT,
+          last_address TEXT,
+          revoked_at TEXT
+        )
+      `);
+    // Small app-wide switches (Wi-Fi access, pairing on the tailnet).
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS settings (
+          key TEXT PRIMARY KEY,
+          value TEXT NOT NULL
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0028_add_orchestrator_acting.ts

@@ -0,0 +1,70 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 28,
+  name: "add_orchestrator_acting",
+  up: (db) => {
+    // The orchestrator's brakes (settings per workspace, and the brake in
+    // force so it's noted once), its starts, its decision log, the reviews
+    // and scope checks it ran per commit, and gate failures per task.
+    db.exec(
+      `ALTER TABLE workspaces ADD COLUMN orch_max_running INTEGER NOT NULL DEFAULT 4`
+    );
+    db.exec(
+      `ALTER TABLE workspaces ADD COLUMN orch_max_starts_per_hour INTEGER NOT NULL DEFAULT 6`
+    );
+    db.exec(`ALTER TABLE workspaces ADD COLUMN orch_brake TEXT`);
+    // The secret an orchestrator's worker sends with each tool call.
+    db.exec(`ALTER TABLE sessions ADD COLUMN orch_token TEXT`);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_starts (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          target TEXT,
+          created_at TEXT NOT NULL
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_starts
+         ON orchestrator_starts(workspace_id, created_at)`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_notes (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          kind TEXT NOT NULL DEFAULT 'note',
+          text TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_notes
+         ON orchestrator_notes(workspace_id, id)`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_checks (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          session_id TEXT NOT NULL,
+          sha TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          status TEXT NOT NULL,
+          detail TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          UNIQUE (session_id, sha, kind)
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_gate_failures (
+          session_id TEXT NOT NULL,
+          gate TEXT NOT NULL,
+          workspace_id TEXT NOT NULL,
+          count INTEGER NOT NULL DEFAULT 0,
+          last_reason TEXT,
+          escalated_at TEXT,
+          PRIMARY KEY (session_id, gate)
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0029_add_orchestrator_asks_and_pause.ts

@@ -0,0 +1,81 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 29,
+  name: "add_orchestrator_asks_and_pause",
+  up: (db) => {
+    // Items the orchestrator parks for Saad. One open ask per subject (a
+    // task, the brakes, a title it raised), so a repeat escalation updates
+    // it instead of adding another. An approval of a gate or brake ask is
+    // spent once (used_at), on the commit it was asked about (sha).
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_asks (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          subject TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          title TEXT NOT NULL,
+          detail TEXT NOT NULL DEFAULT '',
+          link TEXT,
+          sha TEXT,
+          status TEXT NOT NULL DEFAULT 'open',
+          answer TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          resolved_at TEXT,
+          used_at TEXT,
+          brake_key TEXT
+        )
+      `);
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_orchestrator_asks_open
+         ON orchestrator_asks(workspace_id, subject) WHERE status = 'open'`
+    );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_asks_workspace
+         ON orchestrator_asks(workspace_id, status)`
+    );
+    // While set, the orchestrator acts on nothing: events queue and its
+    // acting tools refuse.
+    db.exec(`ALTER TABLE workspaces ADD COLUMN orch_paused_at TEXT`);
+    // Proof a person approves: a paired device may answer asks only once
+    // Saad lets it, and approvals that matter need a passkey assertion
+    // (user verification) on a challenge bound to the one item.
+    db.exec(
+      `ALTER TABLE devices ADD COLUMN can_approve INTEGER NOT NULL DEFAULT 0`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS passkeys (
+          id TEXT PRIMARY KEY,
+          public_key BLOB NOT NULL,
+          counter INTEGER NOT NULL DEFAULT 0,
+          transports TEXT,
+          rp_id TEXT NOT NULL,
+          name TEXT NOT NULL,
+          registered_via TEXT,
+          registered_from TEXT,
+          user_agent TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          last_used_at TEXT,
+          revoked_at TEXT
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS presence_challenges (
+          challenge TEXT PRIMARY KEY,
+          kind TEXT NOT NULL,
+          purpose TEXT NOT NULL,
+          binding TEXT NOT NULL,
+          rp_id TEXT NOT NULL,
+          expires_at INTEGER NOT NULL,
+          used_at INTEGER
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS passkey_enrollments (
+          code_hash TEXT PRIMARY KEY,
+          expires_at INTEGER NOT NULL,
+          used_at INTEGER
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0030_add_sessions_archived_at.ts

@@ -0,0 +1,14 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 30,
+  name: "add_sessions_archived_at",
+  up: (db) => {
+    // Done sessions leave the sidebar but are never deleted, so their
+    // history and chat items stay.
+    db.exec(`ALTER TABLE sessions ADD COLUMN archived_at TEXT`);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_sessions_archived_at ON sessions(archived_at)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0031_add_stack_item_restacked_heads.ts

@@ -0,0 +1,22 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 31,
+  name: "add_stack_item_restacked_heads",
+  up: (db) => {
+    // A branch AgentOS rebased itself: its head before (the commit the
+    // task's code review covered) and after (the head AgentOS pushed).
+    // Each column checked, so a run cut off between the two can't be
+    // marked applied with one missing.
+    const cols = new Set(
+      (
+        db.prepare(`PRAGMA table_info(stack_items)`).all() as {
+          name: string;
+        }[]
+      ).map((c) => c.name)
+    );
+    for (const col of ["restacked_from", "restacked_to"])
+      if (!cols.has(col))
+        db.exec(`ALTER TABLE stack_items ADD COLUMN ${col} TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0032_add_sessions_pinned.ts

@@ -0,0 +1,12 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 32,
+  name: "add_sessions_pinned",
+  up: (db) => {
+    // Pinned sessions sit on their own shelf at the top of the sidebar.
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN pinned INTEGER NOT NULL DEFAULT 0`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0033_add_program_status.ts

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 33,
+  name: "add_program_status",
+  up: (db) => {
+    // What programs in a terminal report about themselves (OSC 7501),
+    // by tmux session: kept so a restart doesn't forget a finished or
+    // blocked session.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS program_status (
+          session_name TEXT PRIMARY KEY,
+          records TEXT NOT NULL,
+          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0034_add_session_names.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 34,
+  name: "add_session_names",
+  up: (db) => {
+    // Names a session had before it was renamed, so a message sent to
+    // an old name still reaches it.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS session_names (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          name TEXT NOT NULL,
+          renamed_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_session_names_session ON session_names(session_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0035_add_artifacts.ts

@@ -0,0 +1,23 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 35,
+  name: "add_artifacts",
+  up: (db) => {
+    // Pages a chat agent showed with html_render. The HTML lives in a file
+    // under ~/.agent-os/artifacts; the row says whose it is and what it's
+    // called.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS artifacts (
+          id TEXT PRIMARY KEY,
+          session_id TEXT NOT NULL,
+          title TEXT NOT NULL,
+          path TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_artifacts_session ON artifacts(session_id, created_at)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0036_add_chat_queue.ts

@@ -0,0 +1,26 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 36,
+  name: "add_chat_queue",
+  up: (db) => {
+    // Messages written while a chat turn runs, sent in order once it ends.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS chat_queue (
+          session_id TEXT NOT NULL,
+          id TEXT NOT NULL,
+          position REAL NOT NULL,
+          text TEXT NOT NULL,
+          images TEXT,
+          image_count INTEGER NOT NULL DEFAULT 0,
+          created_at INTEGER NOT NULL,
+          PRIMARY KEY (session_id, id)
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_chat_queue_session ON chat_queue(session_id, position)`
+    );
+    // The agent's guess at the next message, shown in an empty composer.
+    db.exec(`ALTER TABLE sessions ADD COLUMN chat_suggestion TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0037_add_chat_plan_and_turns.ts

@@ -0,0 +1,39 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 37,
+  name: "add_chat_plan_and_turns",
+  // One transaction, so a crash part-way leaves nothing to skip as
+  // "duplicate column" on the next start.
+  up: (db) =>
+    db.transaction(() => {
+      // Plan mode is remembered per session; the context meter's last
+      // reading survives a reload; and the agent's running totals at its
+      // last turn tell what the next turn added.
+      db.exec(
+        `ALTER TABLE sessions ADD COLUMN chat_plan INTEGER NOT NULL DEFAULT 0`
+      );
+      db.exec(`ALTER TABLE sessions ADD COLUMN chat_context TEXT`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN chat_usage TEXT`);
+      // What each chat turn cost, kept with the session's name and
+      // workspace so the history outlives the session.
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS chat_turns (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          session_name TEXT NOT NULL,
+          workspace_id TEXT,
+          at INTEGER NOT NULL,
+          cost_usd REAL NOT NULL,
+          input_tokens INTEGER NOT NULL,
+          output_tokens INTEGER NOT NULL,
+          cache_read_tokens INTEGER NOT NULL,
+          cache_write_tokens INTEGER NOT NULL
+        )
+      `);
+      db.exec(`CREATE INDEX IF NOT EXISTS idx_chat_turns_at ON chat_turns(at)`);
+      db.exec(
+        `CREATE INDEX IF NOT EXISTS idx_chat_turns_session ON chat_turns(session_id, id)`
+      );
+    })(),
+} satisfies Migration;

package/lib/db/migrations/0038_add_schedules.ts

@@ -0,0 +1,56 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 38,
+  name: "add_schedules",
+  up: (db) => {
+    // Cron schedules that start agent work, and every run they made or
+    // skipped. A run's (schedule, slot) is unique: claiming the row is
+    // what stops a slot from running twice. Runs are never deleted, and a
+    // removed schedule is archived, not deleted, so its history stays.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS schedules (
+          id TEXT PRIMARY KEY,
+          workspace_id TEXT NOT NULL,
+          project_id TEXT,
+          name TEXT NOT NULL,
+          cron TEXT NOT NULL,
+          timezone TEXT NOT NULL DEFAULT 'America/Chicago',
+          prompt TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          enabled INTEGER NOT NULL DEFAULT 1,
+          armed_at INTEGER NOT NULL,
+          archived_at TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS schedule_runs (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          schedule_id TEXT NOT NULL,
+          slot TEXT NOT NULL,
+          slot_at INTEGER NOT NULL,
+          trigger TEXT NOT NULL,
+          outcome TEXT NOT NULL,
+          detail TEXT,
+          session_id TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          UNIQUE (schedule_id, slot)
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_schedule_runs_schedule ON schedule_runs(schedule_id, id)`
+    );
+    // Which server process ticks the schedules: one row, renewed each
+    // tick, so a second server on the same database never runs them.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS scheduler_lease (
+          id INTEGER PRIMARY KEY CHECK (id = 1),
+          owner TEXT NOT NULL,
+          pid INTEGER NOT NULL,
+          heartbeat INTEGER NOT NULL
+        )
+      `);
+  },
+} satisfies Migration;