@saadnvd1/agent-os 0.3.700 → 0.3.723

package/lib/db/migrations/20261020T1800_session_groups.ts

@@ -0,0 +1,49 @@
+import type { Migration } from "../migration-types";
+import {
+  installChangeTriggers,
+  TABLES_WATCHED_SESSION_GROUPS,
+} from "../changes";
+import { createSessionRowsView } from "../session-parts/view";
+
+export default {
+  key: "20261020T1800_session_groups",
+  up: (db) => {
+    // Named shelves a user files sessions into (lib/session-groups). Not the
+    // old `groups` table, which nothing reads. Additive.
+    db.exec(`CREATE TABLE IF NOT EXISTS session_groups (
+      id TEXT PRIMARY KEY,
+      workspace_id TEXT REFERENCES workspaces(id) ON DELETE SET NULL,
+      name TEXT NOT NULL,
+      sort_order INTEGER NOT NULL DEFAULT 0,
+      collapsed INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+      deleted_at TEXT
+    )`);
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS session_groups_name
+         ON session_groups(COALESCE(workspace_id, ''), lower(name))
+         WHERE deleted_at IS NULL`
+    );
+    const has = (
+      db.prepare(`PRAGMA table_info(sessions)`).all() as { name: string }[]
+    ).some((c) => c.name === "session_group_id");
+    if (!has)
+      db.exec(
+        `ALTER TABLE sessions ADD COLUMN session_group_id TEXT
+           REFERENCES session_groups(id) ON DELETE SET NULL`
+      );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS sessions_session_group
+         ON sessions(session_group_id)`
+    );
+    // A queued task remembers the group it starts in.
+    const queueHas = (
+      db.prepare(`PRAGMA table_info(task_queue)`).all() as { name: string }[]
+    ).some((c) => c.name === "session_group_id");
+    if (!queueHas)
+      db.exec(`ALTER TABLE task_queue ADD COLUMN session_group_id TEXT`);
+    createSessionRowsView(db);
+    installChangeTriggers(db, TABLES_WATCHED_SESSION_GROUPS);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261020T1900_task_queue_after_claim.ts

@@ -0,0 +1,13 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261020T1900_task_queue_after_claim",
+  up: (db) => {
+    // The work claim (lib/claims) a queued task waits on, by claim id.
+    const cols = db.prepare(`PRAGMA table_info(task_queue)`).all() as {
+      name: string;
+    }[];
+    if (!cols.some((c) => c.name === "after_claim"))
+      db.exec(`ALTER TABLE task_queue ADD COLUMN after_claim TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261020T2000_claim_notices.ts

@@ -0,0 +1,20 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261020T2000_claim_notices",
+  up: (db) => {
+    // What a mid-work overlap between two claims has told the local session:
+    // how many syncs it has held, the shared paths last told, and whether the
+    // winner's merge has been passed on. Times are this machine's clock in ms.
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS claim_notices (
+        pair_key TEXT PRIMARY KEY,
+        hits INTEGER NOT NULL DEFAULT 0,
+        shared TEXT NOT NULL DEFAULT '[]',
+        told_at INTEGER,
+        merged_at INTEGER,
+        seen_at INTEGER NOT NULL
+      );
+    `);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261020T2100_claims_via_host.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261020T2100_claims_via_host",
+  up: (db) => {
+    // The link (hosts.id) a remote claim arrived through, and which claims
+    // machine each link talks to, so a machine linked twice is asked once.
+    const cols = db.prepare(`PRAGMA table_info(work_claims)`).all() as {
+      name: string;
+    }[];
+    if (!cols.some((c) => c.name === "via_host"))
+      db.exec(`ALTER TABLE work_claims ADD COLUMN via_host TEXT`);
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS claim_peers (
+        host_id TEXT PRIMARY KEY,
+        machine_id TEXT NOT NULL,
+        seen_at INTEGER NOT NULL
+      );
+    `);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261020T2200_work_claims_watch.ts

@@ -0,0 +1,10 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_WORK_CLAIMS } from "../changes";
+
+export default {
+  key: "20261020T2200_work_claims_watch",
+  up: (db) => {
+    // The claims sheet and the overlap pills refetch when a claim changes.
+    installChangeTriggers(db, TABLES_WATCHED_WORK_CLAIMS);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261021T1400_session_agent_roles.ts

@@ -0,0 +1,20 @@
+import type { Migration } from "../migration-types";
+import { createSessionRowsView } from "../session-parts/view";
+
+export default {
+  key: "20261021T1400_session_agent_roles",
+  up: (db) => {
+    // The role a session was started in (developer, analyst, reviewer,
+    // supervisor) and the crew it works with: the id of the session that
+    // began it. Additive.
+    const cols = (
+      db.prepare(`PRAGMA table_info(sessions)`).all() as { name: string }[]
+    ).map((c) => c.name);
+    if (!cols.includes("agent_role"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN agent_role TEXT`);
+    if (!cols.includes("crew_id"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN crew_id TEXT`);
+    db.exec(`CREATE INDEX IF NOT EXISTS sessions_crew ON sessions(crew_id)`);
+    createSessionRowsView(db);
+  },
+} satisfies Migration;

package/lib/db/migrations/20261021T1430_analyst_links.ts

@@ -0,0 +1,52 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_ANALYST } from "../changes";
+
+export default {
+  key: "20261021T1430_analyst_links",
+  up: (db) => {
+    // A coding chat paired with an analyst chat that reviews each of its
+    // turns (lib/analyst). Rows are kept after unlinking.
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS analyst_links (
+        id TEXT PRIMARY KEY,
+        coder_session_id TEXT NOT NULL,
+        analyst_session_id TEXT NOT NULL,
+        paused INTEGER NOT NULL DEFAULT 0,
+        reviewed_through TEXT,
+        pending_digest_id TEXT,
+        pending_through TEXT,
+        digest_signals TEXT,
+        created_at INTEGER NOT NULL,
+        ended_at INTEGER
+      );
+      CREATE UNIQUE INDEX IF NOT EXISTS analyst_links_coder_live
+        ON analyst_links(coder_session_id) WHERE ended_at IS NULL;
+      CREATE UNIQUE INDEX IF NOT EXISTS analyst_links_analyst
+        ON analyst_links(analyst_session_id);
+      CREATE TABLE IF NOT EXISTS analyst_recommendations (
+        id TEXT PRIMARY KEY,
+        link_id TEXT NOT NULL,
+        analyst_item_id TEXT NOT NULL,
+        coder_through TEXT,
+        verdict TEXT,
+        summary TEXT NOT NULL DEFAULT '',
+        issues TEXT NOT NULL DEFAULT '[]',
+        signals TEXT,
+        prompt TEXT,
+        state TEXT NOT NULL DEFAULT 'open',
+        error TEXT,
+        sent_text TEXT,
+        sent_item_id TEXT,
+        edited INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL,
+        decided_at INTEGER
+      );
+      CREATE UNIQUE INDEX IF NOT EXISTS analyst_recs_item
+        ON analyst_recommendations(link_id, analyst_item_id);
+      CREATE INDEX IF NOT EXISTS analyst_recs_link
+        ON analyst_recommendations(link_id, created_at);
+    `);
+    // The pane's card and the sidebar refetch when either changes.
+    installChangeTriggers(db, TABLES_WATCHED_ANALYST);
+  },
+} satisfies Migration;

package/lib/db/queries.ts

@@ -94,24 +94,6 @@ export const queries = {
       `UPDATE sessions SET worktree_path = ?, branch_name = ?, base_branch = ?, dev_server_port = ?, updated_at = datetime('now') WHERE id = ?`
     ),
 
-  updateSessionGroup: (db: Database.Database) =>
-    getStmt(
-      db,
-      `UPDATE sessions SET group_path = ?, updated_at = datetime('now') WHERE id = ?`
-    ),
-
-  getSessionsByGroup: (db: Database.Database) =>
-    getStmt(
-      db,
-      `SELECT * FROM session_rows WHERE group_path = ? ORDER BY updated_at DESC`
-    ),
-
-  moveSessionsToGroup: (db: Database.Database) =>
-    getStmt(
-      db,
-      `UPDATE sessions SET group_path = ?, updated_at = datetime('now') WHERE group_path = ?`
-    ),
-
   updateSessionProject: (db: Database.Database) =>
     getStmt(
       db,
@@ -196,28 +178,6 @@ export const queries = {
       `SELECT * FROM tool_calls WHERE message_id = ? ORDER BY timestamp ASC`
     ),
 
-  // Groups
-  getAllGroups: (db: Database.Database) =>
-    getStmt(db, `SELECT * FROM groups ORDER BY sort_order ASC, name ASC`),
-
-  getGroup: (db: Database.Database) =>
-    getStmt(db, `SELECT * FROM groups WHERE path = ?`),
-
-  createGroup: (db: Database.Database) =>
-    getStmt(db, `INSERT INTO groups (path, name, sort_order) VALUES (?, ?, ?)`),
-
-  updateGroupName: (db: Database.Database) =>
-    getStmt(db, `UPDATE groups SET name = ? WHERE path = ?`),
-
-  updateGroupExpanded: (db: Database.Database) =>
-    getStmt(db, `UPDATE groups SET expanded = ? WHERE path = ?`),
-
-  updateGroupOrder: (db: Database.Database) =>
-    getStmt(db, `UPDATE groups SET sort_order = ? WHERE path = ?`),
-
-  deleteGroup: (db: Database.Database) =>
-    getStmt(db, `DELETE FROM groups WHERE path = ?`),
-
   // Projects
   createProject: (db: Database.Database) =>
     getStmt(

package/lib/db/session-parts/columns.ts

@@ -183,4 +183,7 @@ export const SESSION_ROW_COLUMNS: readonly string[] = [
   "started_via",
   "plan_waits_for_caller",
   "plan_handoff_message",
+  "session_group_id",
+  "agent_role",
+  "crew_id",
 ];

package/lib/db/types.ts

@@ -94,11 +94,26 @@ export interface Session {
   // it, as a short line (lib/bus/waits/store).
   waiting_on?: string | null;
   waited_by?: string | null;
+  // Set only by GET /api/sessions: the strongest overlap of this session's
+  // work with a claim here or on a linked machine (lib/claims/overlapCache).
+  overlap?: {
+    strength: "strong" | "weak";
+    machine: string;
+    goal: string;
+    shared: number;
+    claimId: string;
+    mineId: string;
+  } | null;
   placed_note?: string | null;
   // Set by done: hidden from the sidebar and the orchestrator, never deleted.
   archived_at: string | null;
   // On the sidebar's Pinned shelf (0/1 from SQLite).
   pinned: boolean;
+  // The user's group it sits in (session_groups), or null.
+  session_group_id?: string | null;
+  // The agent role it was started in (lib/models/agent-roles) and its crew.
+  agent_role?: string | null;
+  crew_id?: string | null;
   // A workspace's standing orchestrator chat (and that workspace), or null.
   role: "orchestrator" | null;
   // An orchestrator's tool-call secret.
@@ -165,14 +180,6 @@ export interface Session {
   worker_status: "pending" | "running" | "completed" | "failed" | null;
 }
 
-export interface Group {
-  path: string;
-  name: string;
-  expanded: boolean;
-  sort_order: number;
-  created_at: string;
-}
-
 // production: every merge gate applies. fast: a task's PR merges when it opens.
 export type ProjectTier = "production" | "fast";
 
@@ -314,4 +321,8 @@ export interface Host {
   kind?: "ssh" | "connect";
   // Paired with that machine's own AgentOS (lib/hosts/link.ts); 0/1 from SQLite.
   linked?: boolean | number;
+  // Connect hosts (lib/peer): the link's state, and why it's suspended or
+  // who unlinked it.
+  peer_state?: "active" | "suspended" | "unlinked" | null;
+  peer_note?: string | null;
 }

package/lib/doctor/checks.ts

@@ -5,7 +5,11 @@
  */
 
 import { execFile } from "child_process";
+import fs from "fs";
+import os from "os";
+import path from "path";
 import { promisify } from "util";
+import { agentOsHome, liveCheckout } from "../dev-instance/liveServer";
 import { probeAgents, type AgentProbe } from "../agents/probe";
 import { getAllProviderDefinitions } from "../providers/registry";
 
@@ -37,12 +41,14 @@ export interface DoctorDeps {
   exec: ExecFn;
   probe: (fresh: boolean) => Promise<Record<string, AgentProbe>>;
   nodeVersion: string;
+  cliLinks: () => DoctorCheck | null;
 }
 
 const defaultDeps: DoctorDeps = {
   exec: promisify(execFile) as ExecFn,
   probe: probeAgents,
   nodeVersion: process.versions.node,
+  cliLinks: () => checkCliLinks(),
 };
 
 const INSTALL = {
@@ -190,6 +196,62 @@ export function checkAgents(probes: Record<string, AgentProbe>): DoctorCheck {
   };
 }
 
+const CLI_LINKS: Array<[string, string]> = [
+  ["agent-os", "scripts/agent-os"],
+  ["aos", "bin/aos"],
+];
+
+const real = (p: string) => {
+  try {
+    return fs.realpathSync(p);
+  } catch {
+    return null;
+  }
+};
+
+/**
+ * Do the CLI links in ~/.local/bin run the checkout the live server runs from?
+ * A link into an older clone runs an old `aos`. Null when there is no live
+ * server record or no link to judge.
+ */
+export function checkCliLinks(
+  binDir = process.env.AOS_BIN_DIR || path.join(os.homedir(), ".local/bin"),
+  home = agentOsHome()
+): DoctorCheck | null {
+  const live = liveCheckout(home);
+  if (!live) return null;
+  const stale: string[] = [];
+  let seen = 0;
+  for (const [name, rel] of CLI_LINKS) {
+    const link = path.join(binDir, name);
+    let target: string;
+    try {
+      target = fs.readlinkSync(link);
+    } catch {
+      continue;
+    }
+    seen++;
+    const want = real(path.join(live, rel));
+    if (!want || real(path.resolve(binDir, target)) !== want)
+      stale.push(`${name} -> ${target}`);
+  }
+  if (seen === 0) return null;
+  if (stale.length === 0)
+    return {
+      id: "cli-links",
+      label: "CLI links",
+      status: "ok",
+      detail: `Point at ${live}`,
+    };
+  return {
+    id: "cli-links",
+    label: "CLI links",
+    status: "warn",
+    detail: `${stale.join(", ")}; the live server runs from ${live}`,
+    fix: `${live}/scripts/sync-cli-links`,
+  };
+}
+
 let cache: { at: number; checks: Promise<DoctorCheck[]> } | null = null;
 
 /** Every check, in parallel, cached for a minute. `fresh` runs them again. */
@@ -214,7 +276,8 @@ export function runDoctor(
         detail: "Couldn't check the agent CLIs",
         fix: "Check again",
       })),
-  ]);
+    Promise.resolve(d.cliLinks()),
+  ]).then((all) => all.filter((c): c is DoctorCheck => c !== null));
   if (!custom) cache = { at: Date.now(), checks };
   return checks;
 }

package/lib/done/archive.ts

@@ -6,6 +6,7 @@ import { db, queries, type Session } from "../db";
 import { statusOf } from "../orchestrator/facts";
 import { kickWaits } from "../bus/waits/kick";
 import { peerSessionLink } from "../hosts/peer-actions";
+import { endLinkOf } from "../analyst/endLink";
 
 export interface ArchivedView {
   id: string;
@@ -27,6 +28,7 @@ export function archiveSession(id: string): void {
   db.prepare(
     `UPDATE sessions SET archived_at = datetime('now') WHERE id = ? AND archived_at IS NULL`
   ).run(id);
+  endLinkOf(id);
   kickWaits();
 }
 

package/lib/drafts.ts

@@ -29,6 +29,10 @@ export interface Draft {
   // A task's own model, "provider/model"; unset, its roles' models
   // (lib/models).
   taskModel?: string | null;
+  // Start in an agent role (Developer, Analyst, Reviewer, Supervisor): its
+  // binding picks the model; roleModel overrides it for this session.
+  agentRole?: string | null;
+  roleModel?: string | null;
   // A task's priority in the queue; unset: normal.
   taskPriority?: Priority;
   createdAt: number;