@saadnvd1/agent-os 0.3.596 → 0.3.600

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;

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

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T2100_gate_failure_ask_held",
+  up: (db) => {
+    // When a failed-twice escalation started holding its ask until the
+    // agent is idle and CI has settled; null is not held. Additive.
+    const has = (
+      db.prepare(`PRAGMA table_info(orchestrator_gate_failures)`).all() as {
+        name: string;
+      }[]
+    ).some((c) => c.name === "ask_held_at");
+    if (!has)
+      db.exec(
+        `ALTER TABLE orchestrator_gate_failures ADD COLUMN ask_held_at TEXT`
+      );
+  },
+} satisfies Migration;

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

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T2110_task_start_record",
+  up: (db) => {
+    // Who started a task and how, on the session and its queue row; an
+    // approval kind on brief entries. Additive.
+    const add = (table: string, col: string, type: string) => {
+      const columns = db.prepare(`PRAGMA table_info(${table})`).all() as {
+        name: string;
+      }[];
+      if (!columns.some((c) => c.name === col))
+        db.exec(`ALTER TABLE ${table} ADD COLUMN ${col} ${type}`);
+    };
+    add("sessions", "started_via", "TEXT");
+    add("task_queue", "parent_session_id", "TEXT");
+    add("task_queue", "started_by_device", "TEXT");
+    add("task_queue", "started_via", "TEXT");
+    add("brief_amendments", "kind", "TEXT NOT NULL DEFAULT 'scope'");
+  },
+} satisfies Migration;

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

@@ -0,0 +1,23 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T2200_end_orphaned_tasks",
+  up: (db) => {
+    // A background task still "running" whose tool call was stopped or
+    // errored has no job behind it. Settles the rows already stuck.
+    db.exec(`
+      UPDATE chat_items
+      SET data = json_set(data, '$.status', 'stopped',
+                          '$.endedAt', CAST(strftime('%s','now') AS INTEGER) * 1000,
+                          '$.summary', COALESCE(json_extract(data, '$.summary'),
+                                                'Its agent ended before this finished'))
+      WHERE kind = 'task' AND json_extract(data, '$.status') = 'running'
+        AND EXISTS (
+          SELECT 1 FROM chat_items t
+          WHERE t.session_id = chat_items.session_id
+            AND t.item_id = json_extract(chat_items.data, '$.toolUseId')
+            AND t.kind = 'tool'
+            AND json_extract(t.data, '$.status') IN ('stopped', 'error'))
+    `);
+  },
+} satisfies Migration;

package/lib/db/migrations/README.md

@@ -0,0 +1,35 @@
+# Migrations
+
+One file per migration. To add one, add a file here and edit nothing else.
+
+Name the file with a UTC timestamp key, `YYYYMMDDTHHMM_snake_name.ts`
+(e.g. `20261014T0130_share_links.ts`), and export the migration as its default.
+The key in the file must equal the file name:
+
+```ts
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261014T0130_share_links",
+  up: (db) => {
+    db.exec(`CREATE TABLE IF NOT EXISTS share_links (...)`);
+  },
+} satisfies Migration;
+```
+
+- Never edit a migration that has shipped; add a new one. Existing databases
+  have already recorded it and will not run it again.
+- `0001_<name>.ts` .. `0089_<name>.ts` are the legacy numbered migrations
+  (`{ id, name, up }`). They run first, by number, and never change. Do not add
+  numbered ones: two tasks picking the same number collide.
+- Timestamp keys run after the legacy ones, in key order.
+- Keep each `up` safe to repeat (`IF NOT EXISTS`, check `PRAGMA table_info`
+  before `ADD COLUMN`).
+- `lib/db/migrations.generated.ts` lists these files. It is built by
+  `scripts/gen-migrations-index.mjs`, which npm runs before dev, start, build,
+  typecheck, lint and test, and it is not committed. Never edit it. If an import
+  of it fails, run `node scripts/gen-migrations-index.mjs`.
+- A duplicate id or key, or a file whose name does not match its id, throws when
+  `lib/db/migrations.ts` loads. `lib/db/migrations.test.ts` also checks order, the
+  legacy bodies, and that a database migrated before the split would run nothing
+  again.

package/lib/db/migrations-legacy-checksums.json

@@ -43,20 +43,20 @@
   "42": "410ef4562a046ce6",
   "43": "b0fca4e05ff6499e",
   "44": "06b7f4dc636c9675",
-  "45": "73948f256c522959",
+  "45": "8b09dff1aab56f50",
   "46": "202f8fd102ef2581",
   "47": "510435d6afa487cd",
   "48": "10727869e8c8dea1",
   "49": "0384a86395f6650a",
-  "50": "cc05c3663ca18b2b",
+  "50": "7b8c394c61aa997e",
   "51": "b381268fe096fb02",
   "52": "281ad10453d9177a",
   "53": "a7a53074ed49a566",
   "54": "2358b106da3e7b68",
   "55": "478ece72deb01953",
-  "56": "d04bafcaa2eda941",
+  "56": "09adb47c6c996660",
   "57": "0f9bc09a7a31f64d",
-  "58": "ccbf7eebccadfa3f",
+  "58": "2deb463333462eb3",
   "59": "1859ac87155d546b",
   "60": "035e204a4b6c457e",
   "61": "85d9bb65b051409a",
@@ -76,15 +76,16 @@
   "75": "e082428a046f9e6b",
   "76": "17f3160630d658dc",
   "77": "cd54bfd73fbcd168",
-  "78": "8ad44a982b1eb58d",
+  "78": "06e3421d1c7afbb4",
   "79": "0b09d57d6ea8ce0a",
-  "80": "941d85f2ef8bd012",
-  "81": "ecd85de2bdf45ff1",
+  "80": "8d5fdff7cbb2af1e",
+  "81": "b029136a954b8b13",
   "82": "07f11cdac5f8444a",
   "83": "eabf72b6a8616eac",
   "84": "1ed4fb30b7435f28",
   "85": "a85ac25c0e34f2fb",
   "86": "50b5725a67286dee",
   "87": "6024c62bcdbb186e",
-  "88": "bb58ec622ae398e5"
+  "88": "bb58ec622ae398e5",
+  "89": "6df1801b9eceff58"
 }