@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/dashboard/open-questions.d.ts

@@ -0,0 +1,45 @@
+import { type AgentMeta, type LiveAgent } from '../store/index.js';
+import type { ChoiceRequest, OpenAgentEvent } from '../events.js';
+import { type BridgeQuestion } from './bridge-question.js';
+import type { ProjectSummary } from './projects.js';
+/** One session's open question, as the hub lists it: who waits, on what, since when. */
+export interface OpenQuestion {
+    projectId: string;
+    projectName: string;
+    agentId: string;
+    /** What the agent was asked to do: the row's title. */
+    intent?: string;
+    /** When the agent last spoke, ISO: what the longest-waiting-first order sorts on. */
+    updatedAt?: string;
+    /** The question; for one a Claude web session asked (#1237/#1554), built from what the browser bridge reported. */
+    choice: ChoiceRequest;
+}
+/** Injectable seams so {@link buildOpenQuestions} is unit-testable off disk. */
+export interface OpenQuestionsDeps {
+    /** The reader of the runs that have a checkout (default {@link readLiveMetas}): a waiting run keeps its own. */
+    liveAgents?: (cwd: string) => Promise<LiveAgent[]>;
+    /** One run's events, by the project's path and the run's id (default {@link loadAgentEvents}). */
+    events?: (cwd: string, agentId: string) => Promise<OpenAgentEvent[] | undefined>;
+    /**
+     * The questions the browser bridge holds, minus those with an answer already on its way
+     * (default: the daemon's bridge store).
+     */
+    bridged?: () => BridgeQuestion[];
+    /**
+     * Every agent of a project, archived included (default {@link readAllAgents}): a web agent is
+     * `done` at its hand-off (#1231) and its checkout may be long gone, so the live reader alone
+     * would never find the run a bridged question belongs to.
+     */
+    agents?: (cwd: string) => Promise<AgentMeta[]>;
+}
+/**
+ * Every project's parked questions, longest-waiting first (#1455): an agent that has been blocked
+ * on its human the longest is the one to unblock first.
+ *
+ * Forgiving throughout, like every cross-project rollup: an unreadable project, agent list or
+ * event log contributes nothing rather than failing the read. A waiting run whose diary shows no
+ * open question (log unreadable) is skipped — listing a question nobody can answer is worse than
+ * one row fewer.
+ */
+export declare function buildOpenQuestions(projects: ProjectSummary[], deps?: OpenQuestionsDeps): Promise<OpenQuestion[]>;
+//# sourceMappingURL=open-questions.d.ts.map

package/dist/dashboard/open-questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-questions.d.ts","sourceRoot":"","sources":["../../src/dashboard/open-questions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEjH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACjE,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AASnD,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mHAAmH;IACnH,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,gHAAgH;IAChH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAClD,kGAAkG;IAClG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,GAAG,SAAS,CAAC,CAAA;IAChF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,cAAc,EAAE,CAAA;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;CAC/C;AAQD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC,CAqCzB"}

package/dist/dashboard/open-questions.js

@@ -0,0 +1,62 @@
+import { loadAgentEvents, readAllAgents, readLiveMetas } from '../store/index.js';
+import { pendingChoices } from '../open-choices.js';
+import { bridgeChoiceRequest } from './bridge-question.js';
+import { bridgeQuestions } from './bridge-store.js';
+/** The bridge store's questions still waiting for a pick. */
+function unansweredBridgeQuestions() {
+    const store = bridgeQuestions();
+    return store.list().filter(question => !store.pendingAnswer(question.sessionId));
+}
+/**
+ * Every project's parked questions, longest-waiting first (#1455): an agent that has been blocked
+ * on its human the longest is the one to unblock first.
+ *
+ * Forgiving throughout, like every cross-project rollup: an unreadable project, agent list or
+ * event log contributes nothing rather than failing the read. A waiting run whose diary shows no
+ * open question (log unreadable) is skipped — listing a question nobody can answer is worse than
+ * one row fewer.
+ */
+export async function buildOpenQuestions(projects, deps = {}) {
+    const liveAgents = deps.liveAgents ?? readLiveMetas;
+    const events = deps.events ?? loadAgentEvents;
+    const agents = deps.agents ?? readAllAgents;
+    // One card per bridged question, whichever project claims it first: two checkouts of the same
+    // repository share their `agents-data` archive, so the web run behind a question shows up under each.
+    const bridged = (deps.bridged ?? unansweredBridgeQuestions)();
+    const claimed = new Set();
+    const items = [];
+    const card = (project, meta, choice, updatedAt) => ({
+        projectId: project.id,
+        projectName: project.name,
+        agentId: meta.id,
+        ...(meta.intent ? { intent: meta.intent } : {}),
+        ...(updatedAt ? { updatedAt } : {}),
+        choice,
+    });
+    for (const project of projects) {
+        for (const meta of await liveAgents(project.path).catch(() => [])) {
+            if (meta.status !== 'waiting')
+                continue;
+            const choice = pendingChoices((await events(project.path, meta.id).catch(() => undefined)) ?? []).at(-1);
+            if (!choice)
+                continue;
+            items.push(card(project, meta, choice, meta.updatedAt));
+        }
+        // A web agent's question lives in the bridge store, not its log (#1554): join it on the cloud
+        // session id its meta carries. The archive is read only while there is something to join.
+        if (!bridged.length)
+            continue;
+        for (const meta of await agents(project.path).catch(() => [])) {
+            if (meta.target !== 'web' || !meta.sessionId)
+                continue;
+            const question = bridged.find(q => q.sessionId === meta.sessionId && !claimed.has(q.sessionId));
+            if (!question)
+                continue;
+            claimed.add(question.sessionId);
+            // Parked since the bridge saw it, which is the wait that matters here — not the hand-off.
+            items.push(card(project, meta, bridgeChoiceRequest(question), question.receivedAt));
+        }
+    }
+    return items.sort((a, b) => (a.updatedAt ?? '').localeCompare(b.updatedAt ?? ''));
+}
+//# sourceMappingURL=open-questions.js.map

package/dist/dashboard/open-questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-questions.js","sourceRoot":"","sources":["../../src/dashboard/open-questions.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/overview.d.ts

@@ -0,0 +1,78 @@
+import { type LiveAgent, type AgentMeta, type AgentStatus } from '../store/index.js';
+import type { ProjectSummary } from './projects.js';
+import { type ProjectQueue } from './queue.js';
+/** One project's in-flight run, surfaced in the Overview's "working now" list. */
+export interface ActiveAgent {
+    projectId: string;
+    projectName: string;
+    /** Which run this is (#738): a project can have several in flight, one per worktree. */
+    agentId: string;
+    /** The agent's own checkout, so its git/file status is read from the worktree it edits (#738). */
+    cwd: string;
+    status: AgentStatus;
+    /** What the user asked to build (the agent's `scope` event). */
+    intent?: string;
+    scope?: string;
+    /** ISO timestamp of the agent's last event. */
+    updatedAt?: string;
+    /**
+     * A web run at work on its cloud side (#1668): in its session, or parked on a question the
+     * bridge reported. Its local half is over, so it is not a live agent — it is listed because the
+     * cloud side is the agent, and "no agents working" over a waiting cloud session was a lie.
+     */
+    cloud?: 'in-cloud' | 'waiting';
+    /** The machine whose daemon started it (#1648), only when that is not this one. */
+    host?: string;
+}
+/** One recently active project, most-recent first. */
+export interface RecentProject {
+    projectId: string;
+    projectName: string;
+    lastActivityAt?: string;
+}
+/** The cross-project Overview payload. */
+export interface Overview {
+    /** Projects with a running agent, most-recently-updated first. */
+    active: ActiveAgent[];
+    /** Total open TODO items across every project. */
+    queueOpen: number;
+    /** The most recently active projects (capped). */
+    recent: RecentProject[];
+}
+/** One recent session, tagged with the project it belongs to, for the cross-project rail. */
+export interface RecentAgent {
+    projectId: string;
+    projectName: string;
+    agent: AgentMeta;
+}
+/** Injectable reader so {@link buildRecentAgents} is unit-testable off disk. */
+export interface RecentAgentsDeps {
+    agents?: (cwd: string) => Promise<AgentMeta[]>;
+}
+/**
+ * Every project's sessions pooled and sorted newest-first (capped), so the shared sidebar (#shared-
+ * shell) can show recents on the home/Overview where no single project is selected. Each row carries
+ * the project it belongs to, so selecting it jumps into that project's session. Forgiving — a project
+ * whose agents cannot be read simply contributes nothing.
+ */
+export declare function buildRecentAgents(projects: ProjectSummary[], deps?: RecentAgentsDeps): Promise<RecentAgent[]>;
+/** Injectable readers so {@link buildOverview} is unit-testable off disk. */
+export interface OverviewDeps {
+    liveAgents?: (cwd: string) => Promise<LiveAgent[]>;
+    queue?: (projects: ProjectSummary[]) => Promise<ProjectQueue[]>;
+    /** Every run of a project, archived included (default {@link readAllAgents}): where the web runs are. */
+    agents?: (cwd: string) => Promise<AgentMeta[]>;
+    /** Whether the bridge holds a question for that cloud session (default: the daemon's bridge store). */
+    waiting?: (sessionId: string) => boolean;
+    now?: () => number;
+    /** This machine's hostname; `node:os` in production. */
+    host?: string;
+}
+/**
+ * Build the cross-project Overview: the running agents (every live agent of each project, one per
+ * worktree since #736), the total of open queue entries (from {@link collectQueue}), and the most
+ * recently active projects (by {@link ProjectSummary.lastActivityAt}). Forgiving — a project
+ * with no live run, or none running, simply contributes nothing to `active`.
+ */
+export declare function buildOverview(projects: ProjectSummary[], deps?: OverviewDeps): Promise<Overview>;
+//# sourceMappingURL=overview.d.ts.map

package/dist/dashboard/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../src/dashboard/overview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAClH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAW5D,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAA;IACf,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,WAAW,CAAA;IACnB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IAC9B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,MAAM,EAAE,aAAa,EAAE,CAAA;CACxB;AAED,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,SAAS,CAAA;CACjB;AAQD,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;CAC/C;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAavH;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAClD,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC/D,yGAAyG;IACzG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAC9C,uGAAuG;IACvG,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;IACxC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoD1G"}

package/dist/dashboard/overview.js

@@ -0,0 +1,87 @@
+import { readAllAgents, readLiveMetas } from '../store/index.js';
+import { collectQueue } from './queue.js';
+import { cloudRunState } from '../cloud-run-state.js';
+import { bridgeQuestions } from './bridge-store.js';
+import { hostname } from 'node:os';
+/** How many recent projects the Overview surfaces. */
+const RECENT_LIMIT = 5;
+/** How many recent sessions the home rail pools across every project. */
+const RECENT_RUNS_LIMIT = 30;
+/**
+ * Every project's sessions pooled and sorted newest-first (capped), so the shared sidebar (#shared-
+ * shell) can show recents on the home/Overview where no single project is selected. Each row carries
+ * the project it belongs to, so selecting it jumps into that project's session. Forgiving — a project
+ * whose agents cannot be read simply contributes nothing.
+ */
+export async function buildRecentAgents(projects, deps = {}) {
+    const readAgents = deps.agents ?? readAllAgents;
+    const all = [];
+    for (const project of projects) {
+        for (const agent of await readAgents(project.path).catch(() => [])) {
+            all.push({ projectId: project.id, projectName: project.name, agent });
+        }
+    }
+    all.sort((a, b) => (b.agent.startedAt ?? '').localeCompare(a.agent.startedAt ?? ''));
+    // One row per run (#1648): two checkouts of one repository share their archive, so every run
+    // was listed once per checkout; the first project to list it keeps it.
+    const seen = new Set();
+    return all.filter(row => !seen.has(row.agent.id) && seen.add(row.agent.id)).slice(0, RECENT_RUNS_LIMIT);
+}
+/**
+ * Build the cross-project Overview: the running agents (every live agent of each project, one per
+ * worktree since #736), the total of open queue entries (from {@link collectQueue}), and the most
+ * recently active projects (by {@link ProjectSummary.lastActivityAt}). Forgiving — a project
+ * with no live run, or none running, simply contributes nothing to `active`.
+ */
+export async function buildOverview(projects, deps = {}) {
+    const liveAgents = deps.liveAgents ?? readLiveMetas;
+    const queue = deps.queue ?? (p => collectQueue(p));
+    const agents = deps.agents ?? readAllAgents;
+    const waiting = deps.waiting ?? (sessionId => bridgeQuestions().waiting(sessionId));
+    const now = (deps.now ?? Date.now)();
+    const thisHost = deps.host ?? hostname();
+    const active = [];
+    // One entry per web run across projects: two checkouts of one repository share their archive,
+    // so the same run is in both projects' lists; the first project to list it keeps it.
+    const cloudSeen = new Set();
+    const entry = (project, meta, cwd) => ({
+        projectId: project.id,
+        projectName: project.name,
+        agentId: meta.id,
+        cwd,
+        status: meta.status,
+        ...(meta.intent ? { intent: meta.intent } : {}),
+        ...(meta.updatedAt ? { updatedAt: meta.updatedAt } : {}),
+        // Another machine's daemon started it (#1648): the shared data branch shows its runs here too.
+        ...(meta.host !== undefined && meta.host !== thisHost ? { host: meta.host } : {}),
+    });
+    for (const project of projects) {
+        // Every live agent of the project (#738), not just the one that used to sit at its path.
+        for (const meta of await liveAgents(project.path).catch(() => [])) {
+            if (meta.status !== 'running')
+                continue;
+            active.push(entry(project, meta, meta.cwd));
+        }
+        // The web runs whose cloud side is still at work (#1668): their local half is over and their
+        // checkout may be gone, so they are read from the archive and keyed to the project's own path.
+        for (const meta of await agents(project.path).catch(() => [])) {
+            if (meta.target !== 'web' || cloudSeen.has(meta.id))
+                continue;
+            const state = cloudRunState({ ...meta, cloudWaiting: meta.sessionId !== undefined && waiting(meta.sessionId) }, now);
+            if (state !== 'in-cloud' && state !== 'waiting')
+                continue;
+            cloudSeen.add(meta.id);
+            active.push({ ...entry(project, meta, project.path), cloud: state });
+        }
+    }
+    active.sort((a, b) => (b.updatedAt ?? '').localeCompare(a.updatedAt ?? ''));
+    const queues = await queue(projects);
+    const queueOpen = queues.reduce((sum, q) => sum + q.entries.length, 0);
+    const recent = projects
+        .filter(p => p.lastActivityAt)
+        .sort((a, b) => (b.lastActivityAt ?? '').localeCompare(a.lastActivityAt ?? ''))
+        .slice(0, RECENT_LIMIT)
+        .map(p => ({ projectId: p.id, projectName: p.name, lastActivityAt: p.lastActivityAt }));
+    return { active, queueOpen, recent };
+}
+//# sourceMappingURL=overview.js.map

package/dist/dashboard/overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.js","sourceRoot":"","sources":["../../src/dashboard/overview.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/projects.d.ts

@@ -0,0 +1,101 @@
+import { type ProjectRecord } from '../registry.js';
+import { type AgentMeta } from '../store/index.js';
+import type { ProjectError, StaysLocal } from '../project-errors.js';
+import { type GitHostFor } from '../store/git-host.js';
+/**
+ * The multi-project read side (#392): projects the daemon serves come from the registry (#390),
+ * and every read resolves a project id to that project's path before running the per-cwd reader
+ * underneath. One daemon serves them all, running as many agents per project as their own
+ * concurrency allows (#736), each in its own checkout.
+ */
+/** One project's summary for the Projects sidebar (#314). */
+export interface ProjectSummary {
+    /** Registry id (stable, URL-safe). */
+    id: string;
+    /** Absolute repo path. */
+    path: string;
+    /** Display name (the path's basename). */
+    name: string;
+    /** True when the repo still has its `.openagent/` marker. */
+    activated: boolean;
+    /** Whether one of the project's packages provides a git host; without one no pull request can be opened there. */
+    gitHost: boolean;
+    /** ISO timestamp of the project's newest activity: its most recent session. */
+    lastActivityAt?: string;
+    /**
+     * What the daemon's background jobs currently find wrong with the project (#1500), oldest
+     * first — absent when nothing is. Not part of the summary itself: the dashboard's project
+     * list attaches it from the daemon's error state.
+     */
+    errors?: ProjectError[];
+    /**
+     * Why the project's data stays on this machine, as the daemon's last data sync found it: its
+     * repository has no remote, or the person keeps the agents' records here. Nothing is wrong.
+     * Absent for a project that shares them; attached like `errors`.
+     */
+    local?: StaysLocal;
+}
+/**
+ * A projection over the registered projects, together with the projects it could actually see.
+ *
+ * A project whose sources cannot be read contributes no items — which is exactly what a project
+ * with nothing waiting contributes. `whole` is what tells the two apart (#1623). Only a caller
+ * that keeps a baseline of what it has already announced needs the distinction; the panels that
+ * simply render the list read `items` and ignore it.
+ */
+export interface ProjectionRead<T> {
+    /** What was found. Possibly only part of it, when some project could not be read. */
+    items: T[];
+    /** The ids of the projects every source answered for, so their share of `items` is all of it. */
+    whole: string[];
+}
+/** Injectable readers so {@link summarizeProject} is unit-testable off disk. */
+export interface SummarizeDeps {
+    isActivated?: (path: string) => Promise<boolean>;
+    /** The project's runs (live + archived), newest-first. Defaults to {@link readAllAgents}. */
+    readAgents?: (path: string) => Promise<AgentMeta[]>;
+    /** The project's git host. Defaults to {@link projectGitHost}. */
+    gitHost?: GitHostFor;
+}
+/** A project's runs, live prepended to the archived history. Forgiving: a failed read is `[]`. */
+/**
+ * Derive a {@link ProjectSummary} from a registry record: its display name, whether
+ * it is still activated, and its last activity. Forgiving: a failed read reads as an
+ * inactive project with no activity, never a throw.
+ *
+ * Activity is the sessions themselves (B3). It used to be the newest of those and the latest
+ * `LOGS.md` entry — a committed markdown re-narration of the same sessions, which could only ever
+ * be older than the agent it described.
+ */
+export declare function summarizeProject(record: ProjectRecord, deps?: SummarizeDeps): Promise<ProjectSummary>;
+/**
+ * Reads the registry to serve the multi-project endpoints. The dashboard server
+ * holds one of these; the daemon uses the default (the real registry), tests pass
+ * a fake so the server is exercised without touching the user's registry.
+ */
+export interface ProjectsProvider {
+    /** Every registered project, summarized, for the projects read. */
+    list(): Promise<ProjectSummary[]>;
+    /** The absolute path for a registry id, or `undefined` when unknown. */
+    resolvePath(id: string): Promise<string | undefined>;
+}
+/** Injectable readers so {@link defaultProjectsProvider} is unit-testable off the user's registry. */
+export interface ProviderDeps {
+    /** The registry's records. Defaults to {@link listProjects}, forgiving. */
+    listRecords?: () => Promise<ProjectRecord[]>;
+    /** Whether a project's directory is on disk. Defaults to a directory stat. */
+    isDirectory?: (path: string) => Promise<boolean>;
+    /** Defaults to {@link summarizeProject}. */
+    summarize?: (record: ProjectRecord) => Promise<ProjectSummary>;
+}
+/**
+ * A {@link ProjectsProvider} backed by the global registry (#390).
+ *
+ * Only projects whose directory is still on disk are served (#1140): a repo the user renamed or
+ * deleted used to stay in the sidebar as a grey "not activated" entry with no files (#1142),
+ * indistinguishable from a repo that merely lost its marker, and with nothing to click to make it
+ * go away. The registry itself is left alone — the record is skipped, not pruned — so a directory
+ * that comes back (renamed back, a volume remounted) is a project again on the next read.
+ */
+export declare function defaultProjectsProvider(deps?: ProviderDeps): ProjectsProvider;
+//# sourceMappingURL=projects.d.ts.map

package/dist/dashboard/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/dashboard/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGjE,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtE;;;;;GAKG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAA;IAClB,kHAAkH;IAClH,OAAO,EAAE,OAAO,CAAA;IAChB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,qFAAqF;IACrF,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,iGAAiG;IACjG,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,6FAA6F;IAC7F,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACnD,kEAAkE;IAClE,OAAO,CAAC,EAAE,UAAU,CAAA;CACrB;AAED,kGAAkG;AAClG;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiB/G;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACjC,wEAAwE;IACxE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACrD;AAED,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAC5C,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CAC/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,YAAiB,GAAG,gBAAgB,CAiBjF"}

package/dist/dashboard/projects.js

@@ -0,0 +1,63 @@
+import { basename } from 'node:path';
+import { listProjects } from '../registry.js';
+import { nodeFs } from '../node-fs.js';
+import { isActivated } from '../project.js';
+import { readAllAgents } from '../store/index.js';
+import { projectGitHost } from '../store/git-host.js';
+/** A project's runs, live prepended to the archived history. Forgiving: a failed read is `[]`. */
+/**
+ * Derive a {@link ProjectSummary} from a registry record: its display name, whether
+ * it is still activated, and its last activity. Forgiving: a failed read reads as an
+ * inactive project with no activity, never a throw.
+ *
+ * Activity is the sessions themselves (B3). It used to be the newest of those and the latest
+ * `LOGS.md` entry — a committed markdown re-narration of the same sessions, which could only ever
+ * be older than the agent it described.
+ */
+export async function summarizeProject(record, deps = {}) {
+    const checkActivated = deps.isActivated ?? isActivated;
+    const loadAgents = deps.readAgents ?? readAllAgents;
+    const activated = await checkActivated(record.path).catch(() => false);
+    const agents = await loadAgents(record.path).catch(() => []);
+    // ISO timestamps sort chronologically.
+    const agentActivity = agents.map(r => r.updatedAt || r.startedAt).filter(Boolean);
+    const lastActivityAt = agentActivity.filter((a) => !!a).sort().at(-1);
+    const summary = {
+        id: record.id,
+        path: record.path,
+        name: basename(record.path),
+        activated,
+        gitHost: (await (deps.gitHost ?? projectGitHost)(record.path).catch(() => undefined)) !== undefined,
+    };
+    if (lastActivityAt)
+        summary.lastActivityAt = lastActivityAt;
+    return summary;
+}
+/**
+ * A {@link ProjectsProvider} backed by the global registry (#390).
+ *
+ * Only projects whose directory is still on disk are served (#1140): a repo the user renamed or
+ * deleted used to stay in the sidebar as a grey "not activated" entry with no files (#1142),
+ * indistinguishable from a repo that merely lost its marker, and with nothing to click to make it
+ * go away. The registry itself is left alone — the record is skipped, not pruned — so a directory
+ * that comes back (renamed back, a volume remounted) is a project again on the next read.
+ */
+export function defaultProjectsProvider(deps = {}) {
+    const listRecords = deps.listRecords ?? (() => listProjects().catch(() => []));
+    const isDirectory = deps.isDirectory ?? nodeFs().isDirectory;
+    const summarize = deps.summarize ?? (record => summarizeProject(record));
+    const present = async () => {
+        const records = await listRecords();
+        const kept = await Promise.all(records.map(async (record) => ((await isDirectory(record.path).catch(() => false)) ? record : undefined)));
+        return kept.filter((record) => record !== undefined);
+    };
+    return {
+        async list() {
+            return Promise.all((await present()).map(summarize));
+        },
+        async resolvePath(id) {
+            return (await present()).find(record => record.id === id)?.path;
+        },
+    };
+}
+//# sourceMappingURL=projects.js.map

package/dist/dashboard/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/dashboard/projects.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/pull-requests.d.ts

@@ -0,0 +1,127 @@
+import { type GitHostFor, type GitHostRequest } from '../store/git-host.js';
+import { type Cached } from './cache.js';
+/**
+ * The pull requests the dashboard reads (#1820), in one place, all through the project's git host
+ * provider (`../store/git-host.ts`): a branch's request, a branch's whole request history, and the
+ * project's open requests. Reads only: opening and landing are `agent-handoff.ts`'s, through the
+ * same provider. OpenAgent runs no git host tool; a project with no git host package has no pull
+ * requests, and every read here answers "none" for it.
+ *
+ * The shapes are OpenAgent's own ({@link LinkedPr}, {@link OpenPr}), copied out of what the
+ * provider answers rather than passed through, so a field a provider adds cannot leak into what
+ * callers store.
+ */
+/** The PR opened for a branch, when there is one. */
+export interface LinkedPr {
+    number: number;
+    url: string;
+    /** OPEN / MERGED / CLOSED, as the git host reports it; UNKNOWN for a recorded request no live read confirmed. */
+    state: string;
+    title: string;
+    /** ISO creation time, when the read included it: what tells one agent's PR from a predecessor's. */
+    createdAt?: string;
+    /**
+     * The head commit the PR covers, when the read included it (#1512): what tells "the branch's
+     * PR already landed everything" from "the session kept working after its PR merged".
+     */
+    headRefOid?: string;
+    /** The commit a merged PR landed as on the base branch, when the git host said. */
+    mergeCommit?: string;
+}
+/** An open PR on the interventions queue (#632). */
+export interface OpenPr {
+    number: number;
+    title: string;
+    url: string;
+    /**
+     * Draft PRs are generally left off the queue: a draft is not asking for review.
+     *
+     * The exception is a draft OpenAgent opened for itself (#1102), which {@link headRefName}
+     * is what tells apart.
+     */
+    isDraft: boolean;
+    /** The branch the PR is from, so a session's own PR can be recognised as ours (#1102). */
+    headRefName?: string;
+    createdAt?: string;
+}
+/**
+ * A best-effort PR lookup, for a named branch or for the checkout's current branch. One type for
+ * both: the named-branch form is the general one, and "the current branch" is just omitting it.
+ */
+export type PrLookup = (cwd: string, branch?: string) => Promise<LinkedPr | undefined>;
+/**
+ * The branch-addressed form, for a caller that always names one (#799): a finished session's
+ * worktree may be gone, so "the current branch" would silently be the project's, not the
+ * session's. Narrower than {@link PrLookup} on purpose, so that invariant is in the type.
+ */
+export type BranchPrLookup = (cwd: string, branch: string) => Promise<LinkedPr | undefined>;
+/** Lists a checkout's open PRs; rejects when the git host could not answer. */
+export type PrLister = (cwd: string) => Promise<OpenPr[]>;
+/** A provider's request as OpenAgent keeps it: the state upper-cased, the head as the request's commit. */
+export declare function linkedPrOf(request: GitHostRequest): LinkedPr;
+/** A provider's open request as the interventions queue keeps it. */
+export declare function openPrOf(request: GitHostRequest): OpenPr;
+/**
+ * Every PR a branch name has ever had, newest first (#1251).
+ *
+ * The newest request for a head *in any state* is what a single view would answer, so a session
+ * whose prompt pins its branch name (`openagent/triage-quick`) inherits a predecessor's
+ * merged PR as its own. The list form keeps the whole history so {@link pickAgentPr} can decide
+ * which entry, if any, belongs to the agent asking. Resolves `[]` when the project has no git host or
+ * the git host could not answer — indistinguishable from "no PRs", which is what every caller would do
+ * with a failure anyway.
+ */
+export declare function prsForBranch(cwd: string, branch: string, gitHost?: GitHostFor): Promise<LinkedPr[]>;
+/**
+ * {@link prsForBranch} for a caller about to *open* a PR (#1601): a listing the git host could not
+ * answer throws instead of reading as "no PRs", because "none" and "could not tell" must not look
+ * alike there — the difference is a second draft PR on a branch that already has one. A project
+ * with no git host has none, truthfully.
+ */
+export declare function prsForBranchOrThrow(cwd: string, branch: string, gitHost?: GitHostFor): Promise<LinkedPr[]>;
+/** The newest PR of `branch`, in any state, or undefined when it has none or the git host cannot tell. */
+export declare function prView(cwd: string, branch: string, gitHost?: GitHostFor): Promise<LinkedPr | undefined>;
+/**
+ * The cached form of {@link prView} (#1028), and what the dashboard's panels use.
+ *
+ * A PR lookup costs a process where the git reads beside it cost ten milliseconds, and the answer
+ * changes about as often as someone opens a PR. Cached per checkout and branch, shared between
+ * the worktree bar and the handoff summary, and refreshed behind whoever asks. `pending` says the
+ * answer is not known yet rather than that there is no PR — the difference matters to a caller
+ * deciding whether to offer "Open PR". A read with no branch to ask about answers nothing at once.
+ */
+export declare function cachedPrView(cwd: string, branch?: string): Promise<Cached<LinkedPr | undefined>>;
+/** Forget a branch's PR, after an action that changes whether it has one. */
+export declare function forgetPr(cwd: string, branch?: string): void;
+/** The cached form of {@link prsForBranch}, shared through the same read-through cache (#1028). */
+export declare function cachedPrsForBranch(cwd: string, branch: string): Promise<Cached<LinkedPr[]>>;
+/** Forget a branch's PR history, after an action that changes it (opening one). */
+export declare function forgetBranchPrs(cwd: string, branch: string): void;
+/**
+ * The PR that belongs to an agent, out of every PR its branch name has had (#1251/#1255).
+ *
+ * An OPEN PR always counts: a git host allows one open PR per head branch, so whatever is open on the
+ * run's branch is where its pushed commits land. A closed one counts only when it was created
+ * after the agent started (`since`, the agent's `startedAt`) — the oldest such entry, which is the one
+ * this agent's handoff opened. Anything older is a previous agent's PR wearing the same branch name,
+ * which is exactly what showed a merged two-day-old PR as a fresh session's own. Without `since`
+ * only an open PR is trusted.
+ *
+ * `order` exists for the one caller asking a different question (#1512). `'first'` answers
+ * identity — which PR did *this agent* open, so a later agent's must not be the answer. `'latest'`
+ * answers the handoff decision — which PR last saw the branch, so "did the session keep working
+ * past it" is readable off that PR's `headRefOid`; there the oldest entry would call work that a
+ * second PR already landed unlanded.
+ */
+export declare function pickAgentPr(prs: LinkedPr[], since?: string, order?: 'first' | 'latest'): LinkedPr | undefined;
+/**
+ * A project's open PRs, through its git host. Unlike the other reads here it *rejects* when the git host
+ * could not answer — no remote, not logged in, the git host unreachable — instead of resolving `[]`.
+ *
+ * "No PRs are open" and "I could not look" are different answers, and its caller keeps a baseline
+ * of what it has already announced (#1623): taking the second for the first makes the next
+ * successful read announce every already-open PR as new. The caller decides what a failure costs;
+ * it cannot decide what it never hears about. A project with no git host package has none open.
+ */
+export declare function openPrs(cwd: string, gitHost?: GitHostFor): Promise<OpenPr[]>;
+//# sourceMappingURL=pull-requests.d.ts.map

package/dist/dashboard/pull-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-requests.d.ts","sourceRoot":"","sources":["../../src/dashboard/pull-requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC3F,OAAO,EAA0B,KAAK,MAAM,EAAE,MAAM,YAAY,CAAA;AAEhE;;;;;;;;;;GAUG;AAEH,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,iHAAiH;IACjH,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,oDAAoD;AACpD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;AAEtF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;AAE3F,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAEzD,2GAA2G;AAC3G,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,CAU5D;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CASxD;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAA2B,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAEzH;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAA2B,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMhI;AAED,0GAA0G;AAC1G,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAA2B,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAE7H;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAGtG;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,mGAAmG;AACnG,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAEjG;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjE;AAaD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,OAAO,GAAG,QAAkB,GAAG,QAAQ,GAAG,SAAS,CAQtH;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,UAA2B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMlG"}