@saadnvd1/agent-os 0.3.596 → 0.3.597

package/lib/db/migrations/0074_held_task_replies.ts

@@ -0,0 +1,27 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 74,
+  name: "held_task_replies",
+  up: (db) => {
+    // held_for / held_for_name: the orchestrator (id, name there) a held
+    // task messages. relay_state: a held task's message to it, waiting for
+    // the holder to pull it (pending) or pulled (relayed). relay_key: a
+    // pulled message's key on the orchestrator's machine, so a repeat pull
+    // is not delivered twice.
+    const has = (table: string, col: string) =>
+      (
+        db.prepare(`PRAGMA table_info(${table})`).all() as { name: string }[]
+      ).some((c) => c.name === col);
+    for (const col of ["held_for", "held_for_name"])
+      if (!has("sessions", col))
+        db.exec(`ALTER TABLE sessions ADD COLUMN ${col} TEXT`);
+    for (const col of ["relay_state", "relay_key"])
+      if (!has("bus_messages", col))
+        db.exec(`ALTER TABLE bus_messages ADD COLUMN ${col} TEXT`);
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_bus_relay_key ON bus_messages(relay_key) WHERE relay_key IS NOT NULL;
+         CREATE INDEX IF NOT EXISTS idx_bus_relay_pending ON bus_messages(relay_state) WHERE relay_state = 'pending'`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0075_plan_only_tasks.ts

@@ -0,0 +1,17 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 75,
+  name: "plan_only_tasks",
+  up: (db) => {
+    // plan_only: 1 for a task that stops after its plan and waits for
+    // approval (plan_phase 'awaiting'); queued tasks keep it until they start.
+    const has = (table: string) =>
+      (
+        db.prepare(`PRAGMA table_info(${table})`).all() as { name: string }[]
+      ).some((c) => c.name === "plan_only");
+    for (const table of ["sessions", "task_queue"])
+      if (!has(table))
+        db.exec(`ALTER TABLE ${table} ADD COLUMN plan_only INTEGER`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0076_welcome_backfill.ts

@@ -0,0 +1,16 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 76,
+  name: "welcome_backfill",
+  up: (db) => {
+    // An install that already has a session or a project of its own has
+    // been set up; mark it so the first-run welcome never shows there.
+    db.exec(
+      `INSERT OR IGNORE INTO settings (key, value)
+         SELECT 'welcome.completed_at', 'existing-install'
+         WHERE EXISTS (SELECT 1 FROM sessions)
+            OR EXISTS (SELECT 1 FROM projects WHERE is_uncategorized = 0)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0077_simulator_leases.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 77,
+  name: "simulator_leases",
+  up: (db) => {
+    // One iOS simulator a task holds (lib/simulator): the device AgentOS
+    // made for it, and where it is in coming up.
+    db.exec(
+      `CREATE TABLE IF NOT EXISTS simulator_leases (
+           session_id TEXT PRIMARY KEY,
+           udid TEXT,
+           name TEXT NOT NULL,
+           state TEXT NOT NULL,
+           error TEXT,
+           created_at INTEGER NOT NULL,
+           last_used_at INTEGER NOT NULL
+         )`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0078_orchestrator_questions.ts

@@ -0,0 +1,34 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_78 } from "../changes";
+
+export default {
+  id: 78,
+  name: "orchestrator_questions",
+  up: (db) => {
+    // A question the orchestrator put to Saad in chat, open until he
+    // answers it or the orchestrator clears it. needs_you_dismissed: items
+    // he hid from the Needs-you strip (an ask's or question's key); hiding
+    // never resolves anything.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_questions (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          text TEXT NOT NULL,
+          task TEXT,
+          status TEXT NOT NULL DEFAULT 'open',
+          resolved_by TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          resolved_at TEXT
+        );
+        CREATE INDEX IF NOT EXISTS idx_orchestrator_questions_open
+          ON orchestrator_questions(workspace_id, status);
+        CREATE TABLE IF NOT EXISTS needs_you_dismissed (
+          workspace_id TEXT NOT NULL,
+          key TEXT NOT NULL,
+          dismissed_at TEXT NOT NULL DEFAULT (datetime('now')),
+          PRIMARY KEY (workspace_id, key)
+        );
+      `);
+    installChangeTriggers(db, TABLES_WATCHED_78);
+  },
+} satisfies Migration;

package/lib/db/migrations/0079_task_queue_agent.ts

@@ -0,0 +1,13 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 79,
+  name: "task_queue_agent",
+  up: (db) => {
+    // The agent CLI a queued task runs with; null is Claude Code.
+    const has = (
+      db.prepare(`PRAGMA table_info(task_queue)`).all() as { name: string }[]
+    ).some((c) => c.name === "agent_type");
+    if (!has) db.exec(`ALTER TABLE task_queue ADD COLUMN agent_type TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0080_recipes.ts

@@ -0,0 +1,129 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_80 } from "../changes";
+
+export default {
+  id: 80,
+  name: "recipes",
+  up: (db) => {
+    // Recipes: a saved brief that starts a fresh task or session each run
+    // (lib/recipes), and the features a plan splits into pieces
+    // (lib/plans). All additive. A run or piece finds its session by
+    // session_id, so sessions gains no column.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS recipes (
+          id TEXT PRIMARY KEY,
+          workspace_id TEXT NOT NULL,
+          project_id TEXT NOT NULL,
+          name TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          brief TEXT NOT NULL,
+          model TEXT,
+          view TEXT NOT NULL DEFAULT 'chat',
+          auto_done INTEGER NOT NULL DEFAULT 1,
+          max_minutes INTEGER,
+          carry_cleared_at INTEGER,
+          source_session_id TEXT,
+          created_by_session_id TEXT,
+          updated_by_session_id TEXT,
+          archived_at TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+        CREATE UNIQUE INDEX IF NOT EXISTS idx_recipes_name
+          ON recipes(workspace_id, name COLLATE NOCASE) WHERE archived_at IS NULL;
+
+        CREATE TABLE IF NOT EXISTS recipe_runs (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          recipe_id TEXT NOT NULL,
+          seq INTEGER NOT NULL,
+          trigger TEXT NOT NULL,
+          triggered_by_session_id TEXT,
+          schedule_run_id INTEGER,
+          request_id TEXT,
+          note TEXT,
+          prompt TEXT NOT NULL,
+          revision_id INTEGER,
+          status TEXT NOT NULL,
+          session_id TEXT,
+          pr_number INTEGER,
+          pr_url TEXT,
+          summary TEXT,
+          outputs TEXT,
+          summary_source TEXT,
+          error TEXT,
+          cost_usd REAL,
+          duration_ms INTEGER,
+          started_at TEXT,
+          ended_at TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          UNIQUE (recipe_id, seq)
+        );
+        CREATE INDEX IF NOT EXISTS idx_recipe_runs_recipe
+          ON recipe_runs(recipe_id, id DESC);
+        CREATE INDEX IF NOT EXISTS idx_recipe_runs_session
+          ON recipe_runs(session_id);
+        CREATE UNIQUE INDEX IF NOT EXISTS idx_recipe_runs_one_live
+          ON recipe_runs(recipe_id)
+          WHERE status IN ('queued','starting','running');
+        CREATE UNIQUE INDEX IF NOT EXISTS idx_recipe_runs_request
+          ON recipe_runs(request_id) WHERE request_id IS NOT NULL;
+
+        CREATE TABLE IF NOT EXISTS recipe_revisions (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          recipe_id TEXT NOT NULL,
+          brief TEXT NOT NULL,
+          settings TEXT NOT NULL,
+          edited_by_session_id TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+
+        CREATE TABLE IF NOT EXISTS features (
+          id TEXT PRIMARY KEY,
+          workspace_id TEXT NOT NULL,
+          name TEXT NOT NULL,
+          plan_session_id TEXT NOT NULL,
+          plan_text TEXT NOT NULL,
+          status TEXT NOT NULL,
+          done_at TEXT,
+          cost_usd REAL,
+          duration_ms INTEGER,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+        CREATE INDEX IF NOT EXISTS idx_features_plan
+          ON features(plan_session_id);
+
+        CREATE TABLE IF NOT EXISTS feature_pieces (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          feature_id TEXT NOT NULL,
+          position INTEGER NOT NULL,
+          name TEXT NOT NULL,
+          slice TEXT NOT NULL,
+          project_id TEXT NOT NULL,
+          after_position INTEGER,
+          after_kind TEXT,
+          reasons TEXT,
+          owns TEXT,
+          status TEXT NOT NULL,
+          session_id TEXT,
+          note TEXT,
+          UNIQUE (feature_id, position)
+        );
+        CREATE INDEX IF NOT EXISTS idx_feature_pieces_session
+          ON feature_pieces(session_id);
+      `);
+    const cols = (
+      db.prepare(`PRAGMA table_info(schedules)`).all() as { name: string }[]
+    ).map((c) => c.name);
+    if (!cols.includes("recipe_id"))
+      db.exec(`ALTER TABLE schedules ADD COLUMN recipe_id TEXT`);
+    if (!cols.includes("migrated_from_kind"))
+      db.exec(`ALTER TABLE schedules ADD COLUMN migrated_from_kind TEXT`);
+    const plan = (
+      db.prepare(`PRAGMA table_info(sessions)`).all() as { name: string }[]
+    ).map((c) => c.name);
+    // Edits Saad made to a plan's pieces before approving it (merge, drop).
+    if (!plan.includes("plan_edits"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN plan_edits TEXT`);
+    installChangeTriggers(db, TABLES_WATCHED_80);
+  },
+} satisfies Migration;

package/lib/db/migrations/0081_schedules_into_recipes.ts

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+import { moveSchedulesToRecipes } from "../schedules-move";
+
+export default {
+  id: 81,
+  name: "schedules_into_recipes",
+  up: (db) => {
+    // Live task and session schedules become recipes with a timer, and
+    // their runs become recipe runs (lib/db/schedules-move). Reversible:
+    // scripts/revert-schedules-move.ts.
+    const cols = (
+      db.prepare(`PRAGMA table_info(schedules)`).all() as { name: string }[]
+    ).map((c) => c.name);
+    if (!cols.includes("recipe_id") || !cols.includes("migrated_from_kind"))
+      throw new Error("migration 80 hasn't run");
+    moveSchedulesToRecipes(db);
+  },
+} satisfies Migration;

package/lib/db/migrations/0082_session_shelf_times.ts

@@ -0,0 +1,23 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 82,
+  name: "session_shelf_times",
+  up: (db) => {
+    const cols = (
+      db.prepare(`PRAGMA table_info(sessions)`).all() as { name: string }[]
+    ).map((c) => c.name);
+    // Last real activity, when it was marked done, and the snooze.
+    for (const col of [
+      "active_at",
+      "settled_at",
+      "snoozed_until",
+      "snoozed_at",
+    ])
+      if (!cols.includes(col))
+        db.exec(`ALTER TABLE sessions ADD COLUMN ${col} TEXT`);
+    db.exec(
+      `UPDATE sessions SET active_at = updated_at WHERE active_at IS NULL`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0083_native_devices_can_approve.ts

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 83,
+  name: "native_devices_can_approve",
+  up: (db) => {
+    // New native pairings start with Can approve; this gives it once to the
+    // ones paired before. The claim wasn't recorded, so the app is known by
+    // its user agent (`AgentOS/<build> CFNetwork/...` on iOS) or by an
+    // app push token. It only ever turns the flag on.
+    db.exec(
+      `UPDATE devices SET can_approve = 1
+         WHERE revoked_at IS NULL AND can_approve = 0
+           AND (user_agent LIKE 'AgentOS/% CFNetwork/%'
+                OR push_platform IN ('ios', 'android'))`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0084_approval_audit.ts

@@ -0,0 +1,20 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 84,
+  name: "approval_audit",
+  up: (db) => {
+    // Every approval No approvals mode made in place of a person.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS approval_audit (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          at TEXT NOT NULL DEFAULT (datetime('now')),
+          source TEXT NOT NULL,
+          workspace_id TEXT,
+          session_id TEXT,
+          subject TEXT NOT NULL,
+          detail TEXT NOT NULL DEFAULT ''
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0085_experiment_usage.ts

@@ -0,0 +1,35 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 85,
+  name: "experiment_usage",
+  up: (db) => {
+    // What each experiment did: model calls with their cost, and the
+    // non-model work (scripts run, suggestions shown and decided).
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS experiment_usage (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          experiment_id TEXT NOT NULL,
+          event TEXT NOT NULL,
+          trigger TEXT NOT NULL,
+          session_id TEXT,
+          workspace_id TEXT,
+          model TEXT,
+          provider TEXT,
+          input_tokens INTEGER NOT NULL DEFAULT 0,
+          cache_write_tokens INTEGER NOT NULL DEFAULT 0,
+          cache_read_tokens INTEGER NOT NULL DEFAULT 0,
+          output_tokens INTEGER NOT NULL DEFAULT 0,
+          cost_usd REAL NOT NULL DEFAULT 0,
+          duration_ms INTEGER,
+          ok INTEGER NOT NULL DEFAULT 1,
+          detail TEXT,
+          at INTEGER NOT NULL
+        );
+        CREATE INDEX IF NOT EXISTS idx_experiment_usage_exp_at
+          ON experiment_usage(experiment_id, at);
+        CREATE INDEX IF NOT EXISTS idx_experiment_usage_session
+          ON experiment_usage(session_id, experiment_id, event);
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0086_learning_cards.ts

@@ -0,0 +1,28 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 86,
+  name: "learning_cards",
+  up: (db) => {
+    // End-of-session suggestions (save as recipe, keep a lesson). An
+    // accepted lesson row is the record of where it was applied.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS learning_cards (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          workspace_id TEXT,
+          kind TEXT NOT NULL,
+          status TEXT NOT NULL DEFAULT 'pending',
+          payload TEXT NOT NULL,
+          destination TEXT,
+          applied_ref TEXT,
+          shown_at INTEGER,
+          decided_at INTEGER,
+          created_at INTEGER NOT NULL,
+          UNIQUE (session_id, kind)
+        );
+        CREATE INDEX IF NOT EXISTS idx_learning_cards_dest
+          ON learning_cards(destination, decided_at);
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0087_plan_pieces_reconcile.ts

@@ -0,0 +1,29 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 87,
+  name: "plan_pieces_reconcile",
+  up: (db) => {
+    // How many pieces a plan listed and what the checker folded, so a plan
+    // that builds as fewer than it listed is never silent; the PRs agents
+    // opened (from their `gh pr create` output) so one outside its task's
+    // repo is noticed.
+    const columns = db.prepare(`PRAGMA table_info(features)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "listed"))
+      db.exec(`ALTER TABLE features ADD COLUMN listed INTEGER`);
+    if (!columns.some((c) => c.name === "folded"))
+      db.exec(`ALTER TABLE features ADD COLUMN folded TEXT`);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS agent_prs (
+          url TEXT PRIMARY KEY,
+          session_id TEXT NOT NULL,
+          repo TEXT NOT NULL,
+          number INTEGER NOT NULL,
+          seen_at TEXT NOT NULL DEFAULT (datetime('now')),
+          told_at TEXT
+        );
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0088_shared_links.ts

@@ -0,0 +1,25 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 88,
+  name: "shared_links",
+  up: (db) => {
+    // Snapshot links made through Connect. Connect keeps only a digest of
+    // the token, so this is the one place the link can be copied again.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS shared_links (
+          id TEXT PRIMARY KEY,
+          url TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          title TEXT NOT NULL,
+          session_id TEXT,
+          artifact_id TEXT,
+          expires_at TEXT,
+          created_at TEXT NOT NULL,
+          revoked_at TEXT
+        );
+        CREATE INDEX IF NOT EXISTS idx_shared_links_created
+          ON shared_links(created_at DESC);
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0089_passkeys_device_keys.ts

@@ -0,0 +1,23 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 89,
+  name: "passkeys_device_keys",
+  up: (db) => {
+    // A paired device's own approval key (Secure Enclave, Face ID) sits in
+    // the passkeys table beside the browser passkeys: type 'device', bound
+    // to the device that made it. Additive; existing rows read as webauthn.
+    const columns = db.prepare(`PRAGMA table_info(passkeys)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "type"))
+      db.exec(
+        `ALTER TABLE passkeys ADD COLUMN type TEXT NOT NULL DEFAULT 'webauthn'`
+      );
+    if (!columns.some((c) => c.name === "device_id"))
+      db.exec(`ALTER TABLE passkeys ADD COLUMN device_id TEXT`);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_passkeys_device ON passkeys(device_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/20261014T0900_task_scheduling.ts

@@ -0,0 +1,57 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T0900_task_scheduling",
+  up: (db) => {
+    // Priority, "after any" consumption, and timed pause. Additive: every
+    // existing row reads as normal priority and not paused.
+    const has = (table: string, col: string) =>
+      (
+        db.prepare(`PRAGMA table_info(${table})`).all() as { name: string }[]
+      ).some((c) => c.name === col);
+    const add = (table: string, col: string, def: string) => {
+      if (!has(table, col))
+        db.exec(`ALTER TABLE ${table} ADD COLUMN ${col} ${def}`);
+    };
+    add("task_queue", "priority", "TEXT NOT NULL DEFAULT 'normal'");
+    add("task_queue", "machine_needs", "TEXT");
+    add("task_queue", "after_any_used", "TEXT");
+    add("task_queue", "wait_code", "TEXT");
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_task_queue_after_any_used
+           ON task_queue(after_any_used) WHERE after_any_used IS NOT NULL`
+    );
+    add("sessions", "priority", "TEXT");
+    add("sessions", "pause_state", "TEXT");
+    add("sessions", "paused_until", "TEXT");
+    add("sessions", "pause_id", "INTEGER");
+    // "Started on <machine> · <why>" for a task the scheduler placed.
+    add("sessions", "placed_note", "TEXT");
+    add("bus_messages", "held_pause_id", "INTEGER");
+    add("projects", "machine_needs", "TEXT");
+    add("projects", "machine_needs_source", "TEXT");
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS task_pauses (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          mode TEXT NOT NULL DEFAULT 'turn',
+          by_kind TEXT NOT NULL DEFAULT 'person',
+          by_id TEXT,
+          reason TEXT,
+          until_at TEXT,
+          state TEXT NOT NULL DEFAULT 'pausing',
+          requested_at TEXT NOT NULL DEFAULT (datetime('now')),
+          paused_at TEXT,
+          resume_requested_at TEXT,
+          resume_by_kind TEXT,
+          resumed_at TEXT,
+          ended_at TEXT,
+          end_reason TEXT,
+          interrupted INTEGER NOT NULL DEFAULT 0,
+          held_count INTEGER NOT NULL DEFAULT 0
+        );
+        CREATE INDEX IF NOT EXISTS idx_task_pauses_session
+          ON task_pauses(session_id, state);
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261014T1235_placed_mirror_started_by.ts

@@ -0,0 +1,19 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T1235_placed_mirror_started_by",
+  up: (db) => {
+    // A task the queue started on a linked machine kept no record of the
+    // orchestrator that queued it, so it couldn't be read, messaged or
+    // stopped from there. Fills the mirror from the queue row; additive,
+    // only where the mirror has none.
+    db.exec(`
+        UPDATE sessions SET
+          started_by = (SELECT q.started_by FROM task_queue q WHERE q.id = sessions.id),
+          task_since = COALESCE(task_since, created_at)
+        WHERE started_by IS NULL AND task_prompt IS NOT NULL
+          AND host_id IS NOT NULL AND host_id != 'local'
+          AND (SELECT q.started_by FROM task_queue q WHERE q.id = sessions.id) IS NOT NULL
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261014T1600_queued_task_messages.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T1600_queued_task_messages",
+  up: (db) => {
+    // A message for a task still in the start queue, held (addressed to
+    // the queue id, which is the session id it starts as) until its
+    // first prompt. Additive.
+    const has = (
+      db.prepare(`PRAGMA table_info(bus_messages)`).all() as {
+        name: string;
+      }[]
+    ).some((c) => c.name === "held_queued");
+    if (!has)
+      db.exec(`ALTER TABLE bus_messages ADD COLUMN held_queued INTEGER`);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_bus_messages_held_queued
+           ON bus_messages(to_id) WHERE held_queued = 1`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/20261014T1800_task_starter_device.ts

@@ -0,0 +1,20 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T1800_task_starter_device",
+  up: (db) => {
+    // The paired device that started a task over the API: the only one
+    // that may later hold it. Tasks already running have no record, so
+    // they're marked unrecorded. Additive.
+    const has = (
+      db.prepare(`PRAGMA table_info(sessions)`).all() as { name: string }[]
+    ).some((c) => c.name === "started_by_device");
+    if (!has) db.exec(`ALTER TABLE sessions ADD COLUMN started_by_device TEXT`);
+    db.exec(`
+        UPDATE sessions SET started_by_device = 'unrecorded'
+        WHERE started_by_device IS NULL AND started_by IS NULL
+          AND held_by_device IS NULL AND task_status = 'running'
+          AND task_prompt IS NOT NULL AND (host_id IS NULL OR host_id = 'local')
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261014T1900_pause_note.ts

@@ -0,0 +1,13 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T1900_pause_note",
+  up: (db) => {
+    // Why a resume that was asked for hasn't happened yet (waiting for a
+    // slot, held by load), shown on the task row. Additive.
+    const has = (
+      db.prepare(`PRAGMA table_info(sessions)`).all() as { name: string }[]
+    ).some((c) => c.name === "pause_note");
+    if (!has) db.exec(`ALTER TABLE sessions ADD COLUMN pause_note TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261014T2000_chat_bookmarks.ts

@@ -0,0 +1,33 @@
+import type { Migration } from "../migration-types";
+import {
+  installChangeTriggers,
+  TABLES_WATCHED_CHAT_BOOKMARKS,
+} from "../changes";
+
+export default {
+  key: "20261014T2000_chat_bookmarks",
+  up: (db) => {
+    // A person's marks on single chat items. No FK to sessions: a
+    // bookmark outlives a deleted chat with its own snapshot. Additive.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS chat_bookmarks (
+          id TEXT PRIMARY KEY,
+          session_id TEXT NOT NULL,
+          item_id TEXT NOT NULL,
+          scope TEXT NOT NULL DEFAULT 'item',
+          workspace_id TEXT,
+          kind TEXT NOT NULL,
+          text TEXT NOT NULL,
+          session_name TEXT NOT NULL,
+          note TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          UNIQUE (session_id, item_id, scope)
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_chat_bookmarks_ws
+           ON chat_bookmarks(workspace_id, created_at DESC)`
+    );
+    installChangeTriggers(db, TABLES_WATCHED_CHAT_BOOKMARKS);
+  },
+} satisfies Migration;