@saadnvd1/agent-os 0.3.851 → 0.3.859

package/components/SessionList/useSidebarData.ts

@@ -1,5 +1,6 @@
 "use client";
 
+import { isStandingRole, isTechRole } from "@/lib/leads/roles";
 import { useCallback, useEffect, useMemo } from "react";
 import { useSnapshot } from "valtio";
 import type { Session } from "@/lib/db";
@@ -92,7 +93,7 @@ export function useSidebarData(
     const taskStates: Record<string, TaskState> = {};
     for (const t of tasks) taskStates[t.id] = t.state;
     const projectName = (s: Session) =>
-      s.role === "orchestrator"
+      isTechRole(s.role)
         ? `Orchestrator · ${workspaceName.get(s.workspace_id ?? "") ?? ""}`
         : (byId.get(s.project_id ?? "")?.name ?? "");
     const common = {
@@ -167,7 +168,11 @@ export function useSidebarData(
     const counts = new Map<string, number>();
     for (const s of sessions) {
       const ws = byId.get(s.project_id ?? "");
-      if (s.role || !ws || sessionStatuses?.[s.id]?.status !== "running")
+      if (
+        isStandingRole(s.role) ||
+        !ws ||
+        sessionStatuses?.[s.id]?.status !== "running"
+      )
         continue;
       counts.set(ws, (counts.get(ws) ?? 0) + 1);
     }
@@ -226,7 +231,7 @@ export function useSidebarData(
   // Orchestrator session id -> the workspace it serves, for tags and chips.
   const orchestratorKey = JSON.stringify(
     sessions
-      .filter((s) => s.role === "orchestrator")
+      .filter((s) => isTechRole(s.role))
       .map((s) => [
         s.id,
         workspaces.find((w) => w.id === s.workspace_id)?.name ?? s.name,

package/content/whats-new.json

@@ -2033,6 +2033,30 @@
       "area": "Updates",
       "text": "You can update AgentOS by hand again on machines that deploy themselves, and Update now skips the hourly wait.",
       "url": "https://github.com/saadnvd1/agent-os/pull/571"
+    },
+    {
+      "id": 573,
+      "date": "2026-11-02",
+      "kind": "new",
+      "area": "AgentOS",
+      "text": "Mark a fork as done straight from the Forks list above the chat box.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/573"
+    },
+    {
+      "id": 574,
+      "date": "2026-11-02",
+      "kind": "fixed",
+      "area": "AgentOS",
+      "text": "Files a forked session writes are no longer deleted when it finishes.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/574"
+    },
+    {
+      "id": 576,
+      "date": "2026-11-02",
+      "kind": "improved",
+      "area": "AgentOS",
+      "text": "Heavy builds and test runs on Linux machines are now memory-capped, so one runaway command can no longer freeze the whole machine.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/576"
     }
   ]
 }

package/data/done/index.ts

@@ -5,6 +5,7 @@ import type { ArchivedView } from "@/lib/done/archive";
 import type { ResurrectOutcome } from "@/lib/resurrect";
 import { sessionKeys } from "../sessions/keys";
 import { taskKeys } from "../tasks";
+import { forkKeys } from "../fork";
 
 export const archivedKeys = {
   all: ["archived-sessions"] as const,
@@ -52,7 +53,12 @@ function useDoneMutation<V, R>(fn: (v: V) => Promise<R>) {
   return useMutation({
     mutationFn: fn,
     onSettled: () => {
-      for (const queryKey of [sessionKeys.all, taskKeys.all, archivedKeys.all])
+      for (const queryKey of [
+        sessionKeys.all,
+        taskKeys.all,
+        archivedKeys.all,
+        forkKeys.all,
+      ])
         queryClient.invalidateQueries({ queryKey });
     },
   });

package/hooks/useNeedsYou.ts

@@ -1,5 +1,6 @@
 "use client";
 
+import { isStandingRole } from "@/lib/leads/roles";
 import { useMemo } from "react";
 import { useQuery } from "@tanstack/react-query";
 import { useSessionsQuery } from "@/data/sessions/queries";
@@ -15,9 +16,11 @@ import {
 } from "@/lib/orchestrator/needs-you-items";
 
 // Everything waiting on Saad in a workspace: its open asks and questions, the
-// tasks the sidebar marks as needing him, and its chat waiting on an answer.
+// tasks the sidebar marks as needing him, and this chat waiting on an answer
+// (keyed by the chat, so one lead's waiting chat never hides another's).
 export function useNeedsYou(
   workspaceId: string,
+  sessionId: string,
   chatWaiting: boolean
 ): NeedsYouItem[] {
   const overview = useOrchestratorOverview(workspaceId);
@@ -35,7 +38,10 @@ export function useNeedsYou(
     );
     return (sessions?.sessions ?? []).flatMap((s): TaskNeed[] => {
       const need = statuses?.statuses[s.id]?.need;
-      return !s.role && s.project_id && members.has(s.project_id) && need
+      return !isStandingRole(s.role) &&
+        s.project_id &&
+        members.has(s.project_id) &&
+        need
         ? [{ sessionId: s.id, name: s.name, need }]
         : [];
     });
@@ -49,8 +55,8 @@ export function useNeedsYou(
         tasks,
         cards: cardsOn ? (overview?.cards ?? []) : [],
         chatWaiting,
-        chatKey: `approval:${workspaceId}`,
+        chatKey: `approval:${sessionId}`,
       }),
-    [overview, tasks, cardsOn, chatWaiting, workspaceId]
+    [overview, tasks, cardsOn, chatWaiting, sessionId]
   );
 }

package/hooks/useOrchestratorHeader.ts

@@ -1,5 +1,6 @@
 "use client";
 
+import { isStandingRole } from "@/lib/leads/roles";
 import { useQuery } from "@tanstack/react-query";
 import { useSessionsQuery } from "@/data/sessions/queries";
 import { useProjectsQuery } from "@/data/projects/queries";
@@ -23,7 +24,7 @@ export function useWorkspaceRunning(workspaceId: string): number {
   );
   return (sessions?.sessions ?? []).filter(
     (s) =>
-      !s.role &&
+      !isStandingRole(s.role) &&
       s.project_id &&
       members.has(s.project_id) &&
       statuses?.statuses[s.id]?.status === "running"

package/lib/analyst/createLink.ts

@@ -1,3 +1,4 @@
+import { isStandingRole, RoleLabel } from "../leads/roles";
 import { db, type Session } from "../db";
 import { lastItems } from "../chat/store";
 import { launchSession } from "../sessions/launch";
@@ -18,7 +19,8 @@ const sessionRow = (id: string) =>
 export function coderRefusal(s: Session | undefined): string | null {
   if (!s) return "Session not found";
   if (s.archived_at) return `${s.name} is archived`;
-  if (s.role === "orchestrator") return "An orchestrator can't have an analyst";
+  if (isStandingRole(s.role))
+    return `${RoleLabel(s.role)} can't have an analyst`;
   if (s.view !== "chat")
     return "Only a chat session can have an analyst: a terminal has no turns to review";
   if ((s.host_id || "local") !== "local")

package/lib/away/report.ts

@@ -4,6 +4,7 @@
  * as Away ends and kept with the period, so it reads the same later.
  */
 
+import { sqlNoRole } from "../leads/roles";
 import { db } from "../db";
 import { listWorkspaces } from "../workspaces";
 import { HARD_LINES, openAsks } from "../orchestrator/asks";
@@ -178,7 +179,7 @@ function inFlight(workspaceId: string, awayId: number): InFlightItem[] {
       `SELECT s.id, s.name, p.name AS project, s.pr_number, s.pr_url,
          s.merge_armed_at AS armed_at
        FROM session_rows s JOIN projects p ON p.id = s.project_id
-       WHERE p.workspace_id = ? AND s.role IS NULL AND s.archived_at IS NULL
+       WHERE p.workspace_id = ? AND ${sqlNoRole("s.role")} AND s.archived_at IS NULL
          AND s.task_status = 'running'
          AND EXISTS (SELECT 1 FROM away_actions a WHERE a.away_id = ?
            AND a.subject = s.id AND a.kind IN (${TOUCHED}))

package/lib/bus/format.ts

@@ -81,6 +81,8 @@ export function matchesRef(
     // orchestrator: "<workspace>/<name>" and "<workspace>/orchestrator".
     workspaceName?: string | null;
     orchestrator?: boolean;
+    // A lead's department: "<workspace>/<kind>".
+    leadKind?: string | null;
   }
 ): boolean {
   const r = ref.trim().toLowerCase();
@@ -92,6 +94,7 @@ export function matchesRef(
     r === name ||
     (!!s.projectName && r === `${s.projectName.toLowerCase()}/${name}`) ||
     (!!ws && r === `${ws}/${name}`) ||
-    (!!ws && !!s.orchestrator && r === `${ws}/orchestrator`)
+    (!!ws && !!s.orchestrator && r === `${ws}/orchestrator`) ||
+    (!!ws && !!s.leadKind && r === `${ws}/${s.leadKind}`)
   );
 }

package/lib/bus/index.ts

@@ -4,6 +4,7 @@
  * the recipient's tmux pane, which works for any agent CLI.
  */
 
+import { isTechRole } from "../leads/roles";
 import { db, type Session } from "../db";
 import { statusDetector } from "../status-detector";
 import { chatState, sendChatConfirmed } from "../chat/runner";
@@ -63,6 +64,8 @@ export interface Peer {
   orchestratorOf: string | null;
   // The asking session's own workspace orchestrator.
   yours?: boolean;
+  // A lead's address, "<workspace>/<kind>", once its workspace has leads.
+  lead?: string;
   // Names of the sessions it waits on, and of those waiting on it.
   waitingOn: string[];
   waitedBy: string[];
@@ -93,7 +96,7 @@ async function peerState(
 }
 
 const orchestratorOf = (s: Session) =>
-  s.role === "orchestrator" && s.workspace_id
+  isTechRole(s.role) && s.workspace_id
     ? (getWorkspace(s.workspace_id)?.name ?? "a workspace")
     : null;
 
@@ -121,6 +124,10 @@ export async function listPeers(callerId?: string): Promise<Peer[]> {
         running: info.running,
         doing: info.subtitle,
         orchestratorOf: orchestratorOf(s),
+        ...(named[i].leadKind &&
+          named[i].workspaceName && {
+            lead: `${named[i].workspaceName}/${named[i].leadKind}`,
+          }),
         waitingOn: badges.get(s.id)?.on.map((w) => w.name) ?? [],
         waitedBy: badges.get(s.id)?.by.map((w) => w.name) ?? [],
         ...(s.agent_role && { agentRole: s.agent_role }),
@@ -130,7 +137,7 @@ export async function listPeers(callerId?: string): Promise<Peer[]> {
             group: groups.get(s.session_group_id),
           }),
         ...(callerWorkspace &&
-          s.role === "orchestrator" &&
+          isTechRole(s.role) &&
           s.workspace_id === callerWorkspace && { yours: true }),
       };
     })

package/lib/bus/read-scope.ts

@@ -1,3 +1,4 @@
+import { isStandingRole, roleLabel } from "../leads/roles";
 import { db } from "../db";
 import type { Session } from "../db";
 import { getProject } from "../projects";
@@ -58,7 +59,7 @@ function candidates(rows: ReadableSession[]): Candidate[] {
 }
 
 function inScope(s: ReadableSession, scope: ReaderScope): boolean {
-  if (s.role) return false;
+  if (isStandingRole(s.role)) return false;
   if (scope.workspaceId) {
     const p = s.project_id ? getProject(s.project_id) : null;
     // A session in no project is in the workspace it was started in.
@@ -113,8 +114,8 @@ export function resolveReadable(callerId: string, ref: string): Readable {
     return {
       ok: false,
       external: false,
-      error: s.role
-        ? `${s.name} is an orchestrator: it isn't readable. Message it with aos send`
+      error: isStandingRole(s.role)
+        ? `${s.name} is ${roleLabel(s.role)}: it isn't readable. Message it with aos send`
         : `"${ref}" isn't in your ${scope.label}; aos read reaches only sessions there`,
     };
   }

package/lib/bus/resolve.ts

@@ -13,6 +13,8 @@ export interface Candidate {
   previousNames: string[];
   workspaceName?: string | null;
   orchestrator?: boolean;
+  // The department it heads, when its workspace has leads: "<workspace>/<kind>".
+  leadKind?: string | null;
 }
 
 export type Resolution =
@@ -23,7 +25,7 @@ export const MIN_ID_PREFIX = 4;
 
 const label = (c: Candidate) =>
   `${
-    c.orchestrator && c.workspaceName
+    (c.orchestrator || c.leadKind) && c.workspaceName
       ? `${c.workspaceName}/`
       : c.projectName
         ? `${c.projectName}/`
@@ -46,6 +48,7 @@ const matchesOld = (r: string, c: Candidate) =>
       tmuxName: "",
       name: old,
       orchestrator: false,
+      leadKind: null,
     })
   );
 

package/lib/bus/role-alias.ts

@@ -5,6 +5,7 @@
  * refuses and lists them, like any other name.
  */
 
+import { isTechRole } from "../leads/roles";
 import type { Session } from "../db";
 import { sessionWorkspace } from "../models/resolve";
 
@@ -60,7 +61,7 @@ export function resolveRoleAlias<T extends RoleSession>(
   const workspace = caller ? sessionWorkspace(caller) : null;
   if (role === "supervisor" && workspace) {
     const orchestrator = others.find(
-      (s) => s.role === "orchestrator" && s.workspace_id === workspace
+      (s) => isTechRole(s.role) && s.workspace_id === workspace
     );
     if (orchestrator) return { ok: true, session: orchestrator };
   }

package/lib/bus/targets.ts

@@ -2,6 +2,8 @@
  * Which live session a name someone typed reaches, across workspaces.
  */
 
+import { isTechRole, leadKindOf } from "../leads/roles";
+import { hasLeads } from "../leads/settings";
 import { db, type Session } from "../db";
 import { getProject } from "../projects";
 import { getWorkspace } from "../workspaces";
@@ -37,7 +39,10 @@ export function candidates(sessions: Session[]): Candidate[] {
     tmuxName: s.tmux_name,
     previousNames: old.get(s.id) ?? [],
     workspaceName: workspaceName(s),
-    orchestrator: s.role === "orchestrator",
+    orchestrator: isTechRole(s.role),
+    // The orchestrator answers to "tech" only once its workspace has leads.
+    leadKind:
+      isTechRole(s.role) && !hasLeads(s.workspace_id) ? null : leadKindOf(s),
   }));
 }
 
@@ -77,7 +82,7 @@ function ownOrchestrator(
   const workspace = caller ? sessionWorkspace(caller) : null;
   if (!workspace) return undefined;
   return sessions.find(
-    (s) => s.role === "orchestrator" && s.workspace_id === workspace
+    (s) => isTechRole(s.role) && s.workspace_id === workspace
   );
 }
 
@@ -95,7 +100,7 @@ export function tryResolveTarget(
   const r = resolveRef(ref, candidates(sessions));
   if (!r.ok) {
     const orchestrators = /^(my )?orchestrator$/i.test(ref.trim())
-      ? sessions.filter((s) => s.role === "orchestrator")
+      ? sessions.filter((s) => isTechRole(s.role))
       : [];
     if (orchestrators.length)
       return {

package/lib/bus/waits/tick.ts

@@ -5,6 +5,7 @@
  * reads status through statusOf, the same idle test the orchestrator uses.
  */
 
+import { isStandingRole } from "../../leads/roles";
 import type { Session } from "../../db";
 import { db } from "../../db";
 import { statusDetector } from "../../status-detector";
@@ -128,7 +129,7 @@ async function settle(w: WaitRow, waiter: Session, now: number): Promise<void> {
       timeoutLine(target, w.kind, w.deadline - w.created_at, w.request, is)
     );
     const workspace = sessionWorkspace(waiter);
-    if (workspace && waiter.role !== "orchestrator")
+    if (workspace && !isStandingRole(waiter.role))
       queueEventOnce(
         workspace,
         `wait-timeout:${w.id}`,

package/lib/chat/compact-context.ts

@@ -5,6 +5,7 @@
  * deploy restarted the worker too.
  */
 
+import { isStandingRole } from "../leads/roles";
 import os from "node:os";
 import { statusPorcelain } from "../git-exec";
 import { db, type Session } from "../db";
@@ -33,7 +34,7 @@ export async function compactContext(sessionId: string): Promise<string> {
     .get(sessionId) as
     Pick<Session, "working_directory" | "task_prompt" | "role"> | undefined;
   // An orchestrator starts fresh instead of compacting.
-  if (!session || session.role === "orchestrator") return "";
+  if (!session || isStandingRole(session.role)) return "";
   const tools = lastItems(sessionId, 400, "tool").filter(
     (i) => i.kind === "tool"
   );

package/lib/chat/mention-roots.ts

@@ -1,3 +1,4 @@
+import { isStandingRole } from "../leads/roles";
 import fs from "fs";
 import os from "os";
 import path from "path";
@@ -35,7 +36,7 @@ export function mentionRoots(sessionId: string): MentionRoot[] | null {
         working_directory: string;
       }
     | undefined;
-  if (session?.role !== "orchestrator") return null;
+  if (!isStandingRole(session?.role)) return null;
 
   // Never the home folder or the whole disk: a project pointed there would
   // list everything under it, dotfiles and keys included.

package/lib/chat/runner.ts

@@ -5,6 +5,7 @@
  * events to whoever is watching. Restarting the server leaves turns running.
  */
 
+import { isStandingRole } from "../leads/roles";
 import { pushPlanReady } from "../notify/push/events";
 import {
   handoffAfterPlan,
@@ -638,7 +639,7 @@ async function resumeCutOff(sessionId: string): Promise<void> {
   const task =
     row.workspace_id &&
     row.task_status === "running" &&
-    row.role !== "orchestrator"
+    !isStandingRole(row.role)
       ? row.workspace_id
       : null;
   try {
@@ -923,7 +924,7 @@ export async function freshStartChat(
     id: `note-refresh-${Date.now()}`,
     kind: "note",
     tone: "note",
-    text: `Fresh start: the agent starts a new conversation with its brief${session.role === "orchestrator" ? " and the current state from AgentOS" : ""} at its next message.`,
+    text: `Fresh start: the agent starts a new conversation with its brief${isStandingRole(session.role) ? " and the current state from AgentOS" : ""} at its next message.`,
     createdAt: Date.now(),
   };
   saveItem(sessionId, item);

package/lib/chat/settings.ts

@@ -3,6 +3,7 @@
  * per-session settings that go with them: the model and the access level.
  */
 
+import { isStandingRole } from "../leads/roles";
 import { effectiveChatAccess, noApprovalsOn } from "../approvals/no-approvals";
 import os from "os";
 import { agentLabel } from "../agent-options";
@@ -330,7 +331,7 @@ export async function setChatAccess(
 ): Promise<void> {
   if (!CHAT_ACCESS.includes(access)) return;
   // An orchestrator's access is fixed by its role.
-  if (getSession(sessionId).role === "orchestrator") return;
+  if (isStandingRole(getSession(sessionId).role)) return;
   db.prepare(`UPDATE sessions SET chat_access = ? WHERE id = ?`).run(
     access,
     sessionId
@@ -341,7 +342,7 @@ export async function setChatAccess(
 
 // An orchestrator's permission mode is fixed by its role.
 const canPlan = (s: Session) =>
-  s.role !== "orchestrator" && chatDriverFor(s.agent_type)?.plan !== false;
+  !isStandingRole(s.role) && chatDriverFor(s.agent_type)?.plan !== false;
 
 // Plan mode: the agent reads and plans, and changes nothing until the plan
 // is carried out. Now if a conversation is live, and for every next start.

package/lib/chat/worker/extras.ts

@@ -1,3 +1,4 @@
+import { isLeadRole } from "../../leads/roles";
 import type { Session } from "../../db";
 import type { ChatStartOptions } from "../driver";
 import { refreshSettings } from "../refresh";
@@ -40,7 +41,9 @@ export async function roleExtras(session: Session): Promise<RoleExtras> {
 }
 
 async function ownExtras(session: Session): Promise<RoleExtras> {
-  if (session.role === "orchestrator")
+  // The orchestrator and the other leads run on the orchestrator's worker,
+  // each with its own profile.
+  if (isLeadRole(session.role))
     return (await import("../../orchestrator/worker")).orchestratorExtras(
       session
     );

package/lib/chat/worker/host.ts

@@ -4,6 +4,7 @@
  * events to whoever is connected.
  */
 
+import { isStandingRole } from "../../leads/roles";
 import os from "os";
 import { db, type Session } from "../../db";
 import { agentEnv } from "../../agents/launch";
@@ -216,7 +217,7 @@ export class ChatHost {
     this.atRest = driver.atRest !== false;
     const cwd = session.working_directory.replace(/^~/, os.homedir());
     const env = { ...agentEnv(session.id), ...extras.env };
-    const orchestrator = session.role === "orchestrator";
+    const orchestrator = isStandingRole(session.role);
     // Every chat can show visuals, asked for like any tool under its access
     // setting (they read files and reach the web). An orchestrator reads
     // other sessions' text, so it gets a shorter brief that says what stays
@@ -289,7 +290,7 @@ export class ChatHost {
     if (session.chat_refreshed)
       this.refreshedNote = refreshedNote(
         extras.refresh?.role ??
-          (session.role === "orchestrator" ? "orchestrator" : "task"),
+          (isStandingRole(session.role) ? "orchestrator" : "task"),
         session.chat_refreshed
       );
     // Told only an orchestrator whose tools changed since its last worker:
@@ -964,7 +965,7 @@ export class ChatHost {
     const stale = this.staleNow(cmd.compact);
     // An orchestrator starts over at its own threshold (lib/chat/refresh);
     // only one gone stale does it early.
-    if (!stale || (this.session.role === "orchestrator" && !stale.stale))
+    if (!stale || (isStandingRole(this.session.role) && !stale.stale))
       return false;
     try {
       enqueue(this.session.id, cmd);
@@ -978,7 +979,7 @@ export class ChatHost {
     // from tasks and CI without its untrusted fence. It starts a fresh
     // conversation from its brief and the database instead, as at its
     // threshold, and the next worker sends the message.
-    if (this.session.role === "orchestrator") {
+    if (isStandingRole(this.session.role)) {
       this.staleRefresh = stale;
       this.refreshAt = stale.tokens;
       this.retiring = true;
@@ -1085,7 +1086,7 @@ export class ChatHost {
   // line saying where it started over.
   private endConversation(): void {
     releaseConversation(this.session.id, this.refreshAt);
-    const brief = `its brief${this.session.role === "orchestrator" ? " and the current state from AgentOS" : ""}`;
+    const brief = `its brief${isStandingRole(this.session.role) ? " and the current state from AgentOS" : ""}`;
     const stale = this.staleRefresh;
     const requested = this.refreshAt === REQUESTED_FRESH;
     this.record({