@saadnvd1/agent-os 0.3.596 → 0.3.597

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;

package/lib/db/migrations/0039_add_session_name_source.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 39,
+  name: "add_session_name_source",
+  up: (db) => {
+    // Who named a session: "user" (typed or given explicitly, never
+    // renamed for them), "generated" (a title picked from its prompt) or
+    // "default" ("Session 4", or a placeholder until a title arrives).
+    // One transaction, so a crash part-way leaves nothing to skip.
+    db.transaction(() => {
+      db.exec(
+        `ALTER TABLE sessions ADD COLUMN name_source TEXT NOT NULL DEFAULT 'default'`
+      );
+      // A session renamed by hand before this keeps its name.
+      db.exec(
+        `UPDATE sessions SET name_source = 'user' WHERE id IN (SELECT session_id FROM session_names)`
+      );
+    })();
+  },
+} satisfies Migration;

package/lib/db/migrations/0040_add_schedule_targets_and_phone_notify.ts

@@ -0,0 +1,41 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 40,
+  name: "add_schedule_targets_and_phone_notify",
+  // One transaction, so a crash part-way leaves nothing to skip as
+  // "duplicate column" on the next start.
+  up: (db) =>
+    db.transaction(() => {
+      // Where phone notifications go. One row; the bot token is never
+      // returned by any route or written to a log.
+      db.exec(`
+          CREATE TABLE IF NOT EXISTS notify_settings (
+            id INTEGER PRIMARY KEY CHECK (id = 1),
+            telegram_token TEXT,
+            telegram_chat_id TEXT,
+            updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+          )
+        `);
+      // Every phone notification, sent or waiting out its source's
+      // minute, so one held across a restart still goes.
+      db.exec(`
+          CREATE TABLE IF NOT EXISTS notify_outbox (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            source TEXT NOT NULL,
+            text TEXT NOT NULL,
+            created_at INTEGER NOT NULL,
+            send_after INTEGER NOT NULL,
+            sent_at INTEGER,
+            error TEXT
+          )
+        `);
+      db.exec(
+        `CREATE INDEX IF NOT EXISTS idx_notify_outbox_source ON notify_outbox(source, sent_at)`
+      );
+      // A "message" schedule's session, by id: names change, ids don't.
+      // And the agent session that made a schedule, when one did.
+      db.exec(`ALTER TABLE schedules ADD COLUMN target_session_id TEXT`);
+      db.exec(`ALTER TABLE schedules ADD COLUMN created_by_session_id TEXT`);
+    })(),
+} satisfies Migration;

package/lib/db/migrations/0041_add_task_setup.ts

@@ -0,0 +1,17 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 41,
+  name: "add_task_setup",
+  up: (db) => {
+    // How a task's worktree setup (deps, setup commands) went before its
+    // agent started: running, ok or failed, how long, and what failed;
+    // and the brief its launch needs, so a restart can resume it.
+    db.transaction(() => {
+      db.exec(`ALTER TABLE sessions ADD COLUMN setup_status TEXT`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN setup_ms INTEGER`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN setup_error TEXT`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN task_brief TEXT`);
+    })();
+  },
+} satisfies Migration;

package/lib/db/migrations/0042_add_host_links_and_moved_tasks.ts

@@ -0,0 +1,29 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 42,
+  name: "add_host_links_and_moved_tasks",
+  up: (db) => {
+    // How this machine reaches another machine's own AgentOS: its URL and
+    // the device token it paired with. Apart from hosts so the token never
+    // rides along with a host row to the browser.
+    db.transaction(() => {
+      db.exec(`
+          CREATE TABLE IF NOT EXISTS host_links (
+            host_id TEXT PRIMARY KEY REFERENCES hosts(id) ON DELETE CASCADE,
+            url TEXT NOT NULL,
+            token TEXT NOT NULL,
+            linked_at TEXT NOT NULL DEFAULT (datetime('now'))
+          )
+        `);
+      // A task moved to another machine keeps its row, marked where it
+      // went; one that arrived names the session it came from, so the
+      // same move imported twice finds the first.
+      db.exec(`ALTER TABLE sessions ADD COLUMN moved_to TEXT`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN moved_from TEXT`);
+      db.exec(
+        `CREATE INDEX IF NOT EXISTS idx_sessions_moved_from ON sessions(moved_from)`
+      );
+    })();
+  },
+} satisfies Migration;

package/lib/db/migrations/0043_scratch_project.ts

@@ -0,0 +1,14 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 43,
+  name: "scratch_project",
+  up: (db) => {
+    // Chats with no project work in a scratch folder rather than the home
+    // directory. Sessions already made keep their own folders.
+    db.prepare(
+      `UPDATE projects SET name = 'Scratch', working_directory = '~/.agent-os/scratch'
+         WHERE is_uncategorized = 1 AND name = 'Uncategorized' AND working_directory = '~'`
+    ).run();
+  },
+} satisfies Migration;

package/lib/db/migrations/0044_chat_item_kind.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 44,
+  name: "chat_item_kind",
+  up: (db) => {
+    // Items of one kind (a chat's background tasks, its sent messages)
+    // read from an index, not by parsing every row of a long conversation.
+    const columns = db.prepare(`PRAGMA table_xinfo(chat_items)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "kind"))
+      db.exec(
+        `ALTER TABLE chat_items ADD COLUMN kind TEXT
+             GENERATED ALWAYS AS (json_extract(data, '$.kind')) VIRTUAL`
+      );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_chat_items_kind ON chat_items(session_id, kind, seq)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0045_change_versions.ts

@@ -0,0 +1,13 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_45 } from "../changes";
+
+export default {
+  id: 45,
+  name: "change_versions",
+  up: (db) => {
+    // What browsers show from these tables is pushed when they change
+    // (lib/db/changes.ts) instead of polled. A table added later gets its
+    // own migration.
+    installChangeTriggers(db, TABLES_WATCHED_45);
+  },
+} satisfies Migration;

package/lib/db/migrations/0046_session_port_slots.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 46,
+  name: "session_port_slots",
+  up: (db) => {
+    // A session's port slot and the ports agentos.json's bases resolve to
+    // with it (lib/ports.ts). The unique index is what keeps two parallel
+    // starts, in any process, off one slot.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "port_slot"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN port_slot INTEGER`);
+    if (!columns.some((c) => c.name === "ports"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN ports TEXT`);
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_sessions_port_slot ON sessions(port_slot) WHERE port_slot IS NOT NULL`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0047_pin_orchestrators.ts

@@ -0,0 +1,12 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 47,
+  name: "pin_orchestrators",
+  up: (db) => {
+    // A workspace's orchestrator starts pinned to the top of its list;
+    // unpinning it is then remembered on the session, which lives as
+    // long as its workspace.
+    db.exec(`UPDATE sessions SET pinned = 1 WHERE role = 'orchestrator'`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0048_session_database.ts

@@ -0,0 +1,15 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 48,
+  name: "session_database",
+  up: (db) => {
+    // The session's private Postgres copy, or why it has none, as JSON
+    // (lib/project-config/database.ts).
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "database"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN database TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0049_peer_mirror.ts

@@ -0,0 +1,14 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 49,
+  name: "peer_mirror",
+  up: (db) => {
+    // A row that only shows a linked machine's own session: actions on
+    // it go to that machine. Rows this machine started there over ssh
+    // are its own, and stay 0.
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN peer_mirror INTEGER NOT NULL DEFAULT 0`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0050_task_queue.ts

@@ -0,0 +1,44 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_50 } from "../changes";
+
+export default {
+  id: 50,
+  name: "task_queue",
+  up: (db) => {
+    // Tasks waiting to start (lib/tasks/queue.ts): over the workspace's
+    // limit on running tasks, or after another task. A row's id is the
+    // session id it starts as, so a restart never starts one twice.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS task_queue (
+          id TEXT PRIMARY KEY,
+          project_id TEXT NOT NULL,
+          prompt TEXT NOT NULL,
+          name TEXT,
+          model TEXT,
+          view TEXT,
+          base_branch TEXT,
+          host_id TEXT,
+          after_task TEXT,
+          after_any TEXT,
+          origin_workspace_id TEXT,
+          position INTEGER NOT NULL,
+          status TEXT NOT NULL DEFAULT 'queued',
+          note TEXT,
+          error TEXT,
+          attempts INTEGER NOT NULL DEFAULT 0,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          started_at TEXT
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_task_queue_status ON task_queue(status, position)`
+    );
+    const columns = db.prepare(`PRAGMA table_info(workspaces)`).all() as {
+      name: string;
+    }[];
+    // Null: no limit.
+    if (!columns.some((c) => c.name === "max_running_tasks"))
+      db.exec(`ALTER TABLE workspaces ADD COLUMN max_running_tasks INTEGER`);
+    installChangeTriggers(db, TABLES_WATCHED_50);
+  },
+} satisfies Migration;

package/lib/db/migrations/0051_chat_queue_sent_by.ts

@@ -0,0 +1,16 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  // 50 is taken by queued tasks, landing separately.
+  id: 51,
+  name: "chat_queue_sent_by",
+  up: (db) => {
+    // Who sent a queued message the reader didn't type (lib/chat/events
+    // SentBy, as JSON), so it still shows as theirs once it's sent.
+    const columns = db.prepare(`PRAGMA table_info(chat_queue)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "sent_by"))
+      db.exec(`ALTER TABLE chat_queue ADD COLUMN sent_by TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0052_sessions_chat_restarted.ts

@@ -0,0 +1,17 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 52,
+  name: "sessions_chat_restarted",
+  up: (db) => {
+    // Set by a chat worker that retired cleanly after a deploy; the next
+    // worker tells the agent so with its first message, then clears it.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "chat_restarted"))
+      db.exec(
+        `ALTER TABLE sessions ADD COLUMN chat_restarted INTEGER NOT NULL DEFAULT 0`
+      );
+  },
+} satisfies Migration;