@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/dashboard/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/dashboard/http.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,4CAA4C;AAC5C,MAAM,UAAU,GAAG,CAAC,GAAmB,EAAE,MAAc,EAAE,OAAe,EAAE,OAAO,GAA2B,EAAE;IAC5G,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACnE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAClB,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,QAAQ,CAAC,GAAmB,EAAE,OAAgB,EAAE,MAAM,GAAG,GAAG;IAC1E,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;IAC7D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAoB,EAAE,QAAgB;IACjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAC/B,IAAI,IAAI,KAAK,CAAC,MAAM,CAAA;YACpB,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;gBACnC,GAAG,CAAC,OAAO,EAAE,CAAA;gBACb,OAAM;YACR,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAA;YACxC,CAAC;QACH,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAoB,EAAE,GAAmB,EAAE,QAAgB;IACxF,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1B,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QACtD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,GAAG,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,UAAU,CAAC,GAAoB,EAAE,GAAmB;IAClE,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,CAAA;IACrC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACrD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/dashboard/index.d.ts

@@ -0,0 +1,24 @@
+export { startDashboard, type Dashboard, type DashboardOptions } from './server.js';
+export type { StartAgentOptions, StartAgentResult, AddProjectResult, OnboardingSuggestion, AgentWorktree } from './types.js';
+export { summarizeProject, defaultProjectsProvider, type ProjectSummary, type ProjectionRead, type ProjectsProvider, type SummarizeDeps, } from './projects.js';
+export { resolveDashboardBundle } from './bundle.js';
+export { makeRpcMount, RPC_PREFIX, isSameOriginRequest, isExpectedHost, type EventsSource } from './rpc-serve.js';
+export { serveClientBundle } from './static.js';
+export { readDocs, DOC_CATEGORIES, type WorkspaceDoc } from './docs.js';
+export { collectQueue, type ProjectQueue } from './queue.js';
+export { buildOverview, buildRecentAgents, type Overview, type ActiveAgent as ActiveAgent, type RecentProject, type RecentAgent as RecentAgent, type OverviewDeps } from './overview.js';
+export { buildDashboard, type DashboardData, type ProjectStat, type DashboardDeps } from './dashboard.js';
+export { readGitStatus, type GitStatus } from './git-status.js';
+export { prView, prsForBranch, openPrs, pickAgentPr, type LinkedPr, type OpenPr, type PrLookup, type BranchPrLookup, type PrLister } from './pull-requests.js';
+export { readAgentHandoff, agentBranchFor, openAgentPullRequest, type AgentHandoff, type HandoffCommit, type HandoffFile, type HandoffResult, type AgentHandoffDeps, } from './agent-handoff.js';
+export { buildInterventions, interventionKey, type Intervention, type InterventionsDeps, } from './interventions.js';
+export { buildOpenQuestions, type OpenQuestion, type OpenQuestionsDeps } from './open-questions.js';
+export { bridgeChoiceRequest, type BridgeOption, type BridgeQuestion } from './bridge-question.js';
+export { buildActivity, activityKey, type Activity, type ActivityDeps } from './activity.js';
+export { SeenTracker } from './keyed-watcher.js';
+export { BRIDGE_PREFIX, handleBridgeRequest, type BridgeHandlers, type BridgeSession, type BridgeEvent, type BridgeHello, type BridgeStart } from './bridge-endpoints.js';
+export { bridgeStarts, resetBridgeStarts, BridgeStarts, START_CLAIM_TTL_MS, MAX_START_PROMPT, type BridgeStartRequest, type BridgeStartState, type BridgeStartInput } from './bridge-starts.js';
+export { WEB_START_PREFIX, DAEMON_URL_ENV, handleWebStartRequest, type WebStartHandlers } from './web-start-endpoints.js';
+export { bridgeSessionsFrom, BRIDGE_SESSION_WINDOW_MS } from './bridge-sessions.js';
+export { bridgeQuestions, resetBridgeQuestions, BridgeQuestions, type BridgeContact, type BridgeAnswer } from './bridge-store.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/dashboard/index.js

@@ -0,0 +1,23 @@
+export { startDashboard } from './server.js';
+export { summarizeProject, defaultProjectsProvider, } from './projects.js';
+export { resolveDashboardBundle } from './bundle.js';
+export { makeRpcMount, RPC_PREFIX, isSameOriginRequest, isExpectedHost } from './rpc-serve.js';
+export { serveClientBundle } from './static.js';
+export { readDocs, DOC_CATEGORIES } from './docs.js';
+export { collectQueue } from './queue.js';
+export { buildOverview, buildRecentAgents } from './overview.js';
+export { buildDashboard } from './dashboard.js';
+export { readGitStatus } from './git-status.js';
+export { prView, prsForBranch, openPrs, pickAgentPr } from './pull-requests.js';
+export { readAgentHandoff, agentBranchFor, openAgentPullRequest, } from './agent-handoff.js';
+export { buildInterventions, interventionKey, } from './interventions.js';
+export { buildOpenQuestions } from './open-questions.js';
+export { bridgeChoiceRequest } from './bridge-question.js';
+export { buildActivity, activityKey } from './activity.js';
+export { SeenTracker } from './keyed-watcher.js';
+export { BRIDGE_PREFIX, handleBridgeRequest } from './bridge-endpoints.js';
+export { bridgeStarts, resetBridgeStarts, BridgeStarts, START_CLAIM_TTL_MS, MAX_START_PROMPT } from './bridge-starts.js';
+export { WEB_START_PREFIX, DAEMON_URL_ENV, handleWebStartRequest } from './web-start-endpoints.js';
+export { bridgeSessionsFrom, BRIDGE_SESSION_WINDOW_MS } from './bridge-sessions.js';
+export { bridgeQuestions, resetBridgeQuestions, BridgeQuestions } from './bridge-store.js';
+//# sourceMappingURL=index.js.map

package/dist/dashboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAyC,MAAM,aAAa,CAAA;AAEnF,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GAKxB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAqB,MAAM,gBAAgB,CAAA;AACjH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAqB,MAAM,WAAW,CAAA;AACvE,OAAO,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAA0H,MAAM,eAAe,CAAA;AACxL,OAAO,EAAE,cAAc,EAA4D,MAAM,gBAAgB,CAAA;AACzG,OAAO,EAAE,aAAa,EAAkB,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAiF,MAAM,oBAAoB,CAAA;AAC9J,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GAMrB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,kBAAkB,EAClB,eAAe,GAGhB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,kBAAkB,EAA6C,MAAM,qBAAqB,CAAA;AACnG,OAAO,EAAE,mBAAmB,EAA0C,MAAM,sBAAsB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAoC,MAAM,eAAe,CAAA;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAiG,MAAM,uBAAuB,CAAA;AACzK,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAyE,MAAM,oBAAoB,CAAA;AAC/L,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,qBAAqB,EAAyB,MAAM,0BAA0B,CAAA;AACzH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAyC,MAAM,mBAAmB,CAAA"}

package/dist/dashboard/interventions.d.ts

@@ -0,0 +1,67 @@
+import { type LiveAgent, type AgentMeta } from '../store/index.js';
+import type { FrameworkEvent } from '../events.js';
+import type { ProjectSummary, ProjectionRead } from './projects.js';
+import { type BranchesFor } from '../store/branches.js';
+import { type PrLister } from './pull-requests.js';
+export { interventionKey } from './keys.js';
+/**
+ * One item awaiting the human. Two kinds: an open `pr` to review/merge or close, and an
+ * `awaiting` run paused on a choice gate. The card and the browser hook both iterate the flat
+ * list, branching on `kind` for the fields that differ.
+ */
+export interface Intervention {
+    projectId: string;
+    projectName: string;
+    /**
+     * `pr` = an open PR to review/merge or close; `awaiting` = a run waiting on the question it ended on (#636/#1774);
+     * `unpushed` = a finished agent whose branch has commits that were never pushed (#860).
+     */
+    kind: 'pr' | 'awaiting' | 'unpushed';
+    title: string;
+    /** The PR on the git host (`pr` only): where a click takes the user. */
+    url?: string;
+    /** The PR number (`pr` only). */
+    number?: number;
+    /** The question's id (`awaiting` only) — its stable identity, so it notifies exactly once. */
+    awaitId?: string;
+    /** Which run this is about (`awaiting` #738 / `unpushed`): a project has several agents. */
+    agentId?: string;
+    /** The branch the work is sitting on (`unpushed` only). */
+    branch?: string;
+    /** How many commits are waiting (`unpushed` only). */
+    commits?: number;
+    /** When the PR was opened (`pr`) or the agent last updated (the other two), ISO, for ordering. */
+    createdAt?: string;
+}
+/** Injectable seam so {@link buildInterventions} is unit-testable off disk. */
+export interface InterventionsDeps {
+    prs?: PrLister;
+    /** The reader of the runs that have a checkout (default {@link readLiveMetas}): a waiting run keeps its own; drives the `awaiting` source (#636). */
+    liveAgents?: (cwd: string) => Promise<LiveAgent[]>;
+    /** One run's events, by the project's path and the run's id (default {@link loadAgentEvents}): where a waiting run's question is read. */
+    events?: (cwd: string, agentId: string) => Promise<FrameworkEvent[] | undefined>;
+    /** The finished-agent reader (default {@link listAgents}); drives the `unpushed` source (#860). */
+    agents?: (cwd: string) => Promise<AgentMeta[]>;
+    /** The project's checkouts and branches (default the project's provider, {@link projectBranches}): where a branch's state is read; drives the `unpushed` source (#860). */
+    branches?: BranchesFor;
+    /**
+     * How many of a project's most recent finished agents to inspect for unpushed work. Each one costs
+     * a handful of git reads, and this runs on a poll, so old history is not re-walked every minute:
+     * work that has sat unpushed for dozens of agents is not news, and the agent list stays the record.
+     */
+    handoffLimit?: number;
+}
+/**
+ * Build the cross-project interventions queue: every registered project's open PRs, plus any run
+ * currently paused on a choice gate (#636), newest first. Forgiving — a project with no remote
+ * (or an unreadable one) simply contributes nothing. Hand-opened draft PRs are excluded: they are
+ * not yet asking for review. A draft on an agent's branch is not (#1102): an agent publishes a
+ * draft when a person should look first, and cloud work adoption opens its PRs as drafts.
+ *
+ * Which projects were read whole comes back alongside the items (#1623): forgiveness here is what
+ * lets one unreachable project keep the queue useful, and it is also what would let that project's
+ * whole backlog announce itself as new the moment it came back. The queue's panels ignore this;
+ * the notification watcher is the caller that cannot.
+ */
+export declare function buildInterventions(projects: ProjectSummary[], deps?: InterventionsDeps): Promise<ProjectionRead<Intervention>>;
+//# sourceMappingURL=interventions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interventions.d.ts","sourceRoot":"","sources":["../../src/dashboard/interventions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE9G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnE,OAAO,EAAmB,KAAK,WAAW,EAAoB,MAAM,sBAAsB,CAAA;AAC1F,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAI3D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAS3C;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,UAAU,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,QAAQ,CAAA;IACd,qJAAqJ;IACrJ,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAClD,0IAA0I;IAC1I,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,GAAG,SAAS,CAAC,CAAA;IAChF,mGAAmG;IACnG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAC9C,2KAA2K;IAC3K,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CA6EvC"}

package/dist/dashboard/interventions.js

@@ -0,0 +1,169 @@
+import { listAgents, loadAgentEvents, readLiveMetas } from '../store/index.js';
+import { pendingChoices } from '../open-choices.js';
+import { agentBranchFor } from './agent-handoff.js';
+import { projectBranches } from '../store/branches.js';
+import { openPrs } from './pull-requests.js';
+import { interventionKey } from './keys.js';
+// Pure identity + diff, in the leaf `keys.ts` so the dashboard shares them rather than copying.
+export { interventionKey } from './keys.js';
+/** How many recent finished agents are inspected per project by default. */
+const HANDOFF_LIMIT = 5;
+/**
+ * Build the cross-project interventions queue: every registered project's open PRs, plus any run
+ * currently paused on a choice gate (#636), newest first. Forgiving — a project with no remote
+ * (or an unreadable one) simply contributes nothing. Hand-opened draft PRs are excluded: they are
+ * not yet asking for review. A draft on an agent's branch is not (#1102): an agent publishes a
+ * draft when a person should look first, and cloud work adoption opens its PRs as drafts.
+ *
+ * Which projects were read whole comes back alongside the items (#1623): forgiveness here is what
+ * lets one unreachable project keep the queue useful, and it is also what would let that project's
+ * whole backlog announce itself as new the moment it came back. The queue's panels ignore this;
+ * the notification watcher is the caller that cannot.
+ */
+export async function buildInterventions(projects, deps = {}) {
+    const prs = deps.prs ?? openPrs;
+    const liveAgents = deps.liveAgents ?? readLiveMetas;
+    const events = deps.events ?? loadAgentEvents;
+    const items = [];
+    const whole = [];
+    for (const project of projects) {
+        // A project is read whole only when every one of its sources answered. Each `unread()` below is
+        // a source that did not, and contributed nothing for a reason other than nothing being there.
+        let sawEverything = true;
+        const unread = () => {
+            sawEverything = false;
+            return [];
+        };
+        const open = await prs(project.path).catch(unread);
+        // The branches the project's runs are on, recorded or in a checkout (#1774): what tells a
+        // run's draft from one opened by hand. Read only when a draft asks.
+        let runBranches;
+        const isRunBranch = async (branch) => {
+            runBranches ??= new Set([...(await (deps.agents ?? listAgents)(project.path).catch(() => [])), ...(await liveAgents(project.path).catch(() => []))].flatMap(agent => (agent.branch ? [agent.branch] : [])));
+            return runBranches.has(branch);
+        };
+        for (const pr of open) {
+            // A draft opened by hand is not asking for review, so it stays off the queue. A draft on a
+            // run's branch is the opposite (#1102): the agent, or cloud work adoption, opened it as a
+            // draft so it does not ping reviewers, and if the queue then dropped it too, nothing
+            // would tell anyone the work exists — which is the whole of #860 again.
+            if (pr.isDraft && !(pr.headRefName !== undefined && (await isRunBranch(pr.headRefName))))
+                continue;
+            items.push({
+                projectId: project.id,
+                projectName: project.name,
+                kind: 'pr',
+                number: pr.number,
+                title: pr.title,
+                url: pr.url,
+                ...(pr.createdAt ? { createdAt: pr.createdAt } : {}),
+            });
+        }
+        // A run that ended on a question waits for the user, a "needs you" too (#636): it ended
+        // `waiting`, its checkout kept for the answer (#1774). The question is read off the run's own
+        // diary by the rule the run page and the open-questions list use, so the ping names the question
+        // they offer; a waiting run whose diary shows none is skipped. A project has several runs
+        // (#736), so each waiting run contributes its own item — keyed on the question's id, plus the
+        // agent id so two runs are told apart.
+        for (const meta of await liveAgents(project.path).catch(unread)) {
+            if (meta.status !== 'waiting')
+                continue;
+            const choice = pendingChoices((await events(project.path, meta.id).catch(() => undefined)) ?? []).at(-1);
+            if (!choice)
+                continue;
+            items.push({
+                projectId: project.id,
+                projectName: project.name,
+                kind: 'awaiting',
+                title: choice.title,
+                awaitId: choice.id,
+                agentId: meta.id,
+                ...(meta.updatedAt ? { createdAt: meta.updatedAt } : {}),
+            });
+        }
+        // A finished agent whose work never left the machine is a "needs you" too (#860). Until now the
+        // queue only knew about a PR that is *already on the git host* and an agent parked on a gate, so an agent
+        // that committed real code and stopped produced neither, and nothing told anyone: the overview
+        // drops it (it filters on `running`) and the handoff panel is behind clicking into that agent.
+        //
+        // Surfacing only: this says there is a decision waiting, it does not take it. A run publishes
+        // nothing by itself, so every finished run with work of its own reaches here until a person
+        // publishes it, or the agent does on their ask.
+        for (const item of await unpushedFor(project, deps, unread).catch(unread))
+            items.push(item);
+        if (sawEverything)
+            whole.push(project.id);
+    }
+    items.sort((a, b) => (b.createdAt ?? '').localeCompare(a.createdAt ?? ''));
+    // The same repo can be registered under two projects (e.g. a monorepo root + a subdir), so a
+    // PR would otherwise appear once per entry. Collapse by identity, keeping the first (newest-sorted).
+    const seen = new Set();
+    const unique = items.filter(item => (seen.has(interventionKey(item)) ? false : (seen.add(interventionKey(item)), true)));
+    return { items: unique, whole };
+}
+/**
+ * The finished agents of a project whose branch still holds unpushed, unmerged commits (#860).
+ *
+ * Only the most recent {@link InterventionsDeps.handoffLimit} finished agents are inspected, and
+ * their branches in one read of the project's branches provider: each read is a process, and
+ * this runs on a poll. A run started from another branch is the exception: its branch is read on
+ * its own, measured from the commit its own work begins at, as its page measures it; counted from
+ * the default branch it would be credited that other branch's commits too. The provider answers git facts only, so the git host PR lookup the handoff
+ * summary makes per branch is never paid here: an open PR means the branch was pushed, so
+ * `pushed` already excludes it, and the `pr` kind above is what surfaces it.
+ */
+async function unpushedFor(project, deps, unread) {
+    const agents = deps.agents ?? listAgents;
+    const branches = deps.branches ?? projectBranches;
+    const finished = (await agents(project.path))
+        // A subagent's branch is its main agent's to land, never a person's to push.
+        .filter(agent => agent.status !== 'running' && agent.parent === undefined)
+        .sort((a, b) => (b.startedAt ?? '').localeCompare(a.startedAt ?? ''))
+        .slice(0, deps.handoffLimit ?? HANDOFF_LIMIT)
+        .flatMap(agent => {
+        const branch = agentBranchFor(agent);
+        return branch === undefined ? [] : [{ agent, branch }];
+    });
+    if (finished.length === 0)
+        return [];
+    // No provider: the project has no checkouts and no branch state to read; nothing is waiting.
+    const source = await branches(project.path).catch(() => undefined);
+    if (!source)
+        return [];
+    // One read per commit the branches are measured from; the runs that name none share one.
+    const asks = new Map();
+    for (const { agent, branch } of finished)
+        asks.set(agent.baseCommit, [...(asks.get(agent.baseCommit) ?? []), branch]);
+    const states = new Map();
+    try {
+        for (const shown of await Promise.all([...asks].map(([from, asked]) => source.show(asked, from)))) {
+            for (const state of shown)
+                states.set(state.branch, state);
+        }
+    }
+    catch {
+        unread();
+        return [];
+    }
+    const items = [];
+    for (const { agent, branch } of finished) {
+        const state = states.get(branch);
+        // Every condition is a reason this is *not* waiting on anyone: the branch is gone, the session
+        // wrote nothing, it already landed, it is already on the remote, or there is nowhere to push.
+        if (!state || !state.exists || state.commits.length === 0 || state.files.length === 0 || state.merged || state.pushed || !state.hasRemote)
+            continue;
+        items.push({
+            projectId: project.id,
+            projectName: project.name,
+            kind: 'unpushed',
+            // What was asked, else the name the provider gave the branch, else the branch: never a prefix cut off here.
+            title: agent.intent?.trim() || state.name || branch,
+            agentId: agent.id,
+            branch,
+            commits: state.commits.length,
+            ...(agent.updatedAt ? { createdAt: agent.updatedAt } : {}),
+        });
+    }
+    return items;
+}
+//# sourceMappingURL=interventions.js.map

package/dist/dashboard/interventions.js.map

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

package/dist/dashboard/keyed-watcher.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tracks which items have been announced, so only new ones notify. Identity is the caller's
+ * (`keyOf`), since what makes two items "the same" is a property of what is being watched.
+ * Testable without timers.
+ *
+ * The baseline is kept per project (`scopeOf`), not once for the whole poll (#1623). A poll that
+ * reached three projects out of four knows what already existed on those three and knows nothing
+ * about the fourth, and announcing is a per-project decision anyway. Held globally, one project
+ * that can never be read — a registered repo with no remote is an ordinary case — would either
+ * silence every project's notifications or hand the whole set a baseline it had not earned.
+ */
+export declare class SeenTracker<T> {
+    private readonly keyOf;
+    private readonly scopeOf;
+    private readonly seen;
+    private readonly warmedUp;
+    constructor(keyOf: (item: T) => string, scopeOf: (item: T) => string);
+    /**
+     * Fold a poll's items into the baseline and return the ones worth announcing: the items not seen
+     * before, from projects this watcher has a real baseline for. `whole` names the projects the poll
+     * read completely, and only those earn a baseline — so whatever already existed at start-up is
+     * never announced, and a project that could not be read stays quiet until it can be.
+     *
+     * Items keep being folded in either way: a partial read can only under-report, never invent, so
+     * anything it did see is still something the user should not later hear about as new.
+     */
+    observe(items: T[], whole: Iterable<string>): T[];
+}
+//# sourceMappingURL=keyed-watcher.d.ts.map

package/dist/dashboard/keyed-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-watcher.d.ts","sourceRoot":"","sources":["../../src/dashboard/keyed-watcher.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,qBAAa,WAAW,CAAC,CAAC;IAKtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,YACmB,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3C;IAEJ;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAOhD;CACF"}

package/dist/dashboard/keyed-watcher.js

@@ -0,0 +1,42 @@
+// The baseline half of the browser's notifications (#627): what a feed already held versus what
+// is new. One engine, two feeds: the "needs you" queue and the "New activity" feed. They differ
+// only in how an item is identified, so that is a parameter rather than a second copy.
+/**
+ * Tracks which items have been announced, so only new ones notify. Identity is the caller's
+ * (`keyOf`), since what makes two items "the same" is a property of what is being watched.
+ * Testable without timers.
+ *
+ * The baseline is kept per project (`scopeOf`), not once for the whole poll (#1623). A poll that
+ * reached three projects out of four knows what already existed on those three and knows nothing
+ * about the fourth, and announcing is a per-project decision anyway. Held globally, one project
+ * that can never be read — a registered repo with no remote is an ordinary case — would either
+ * silence every project's notifications or hand the whole set a baseline it had not earned.
+ */
+export class SeenTracker {
+    keyOf;
+    scopeOf;
+    seen = new Set();
+    warmedUp = new Set();
+    constructor(keyOf, scopeOf) {
+        this.keyOf = keyOf;
+        this.scopeOf = scopeOf;
+    }
+    /**
+     * Fold a poll's items into the baseline and return the ones worth announcing: the items not seen
+     * before, from projects this watcher has a real baseline for. `whole` names the projects the poll
+     * read completely, and only those earn a baseline — so whatever already existed at start-up is
+     * never announced, and a project that could not be read stays quiet until it can be.
+     *
+     * Items keep being folded in either way: a partial read can only under-report, never invent, so
+     * anything it did see is still something the user should not later hear about as new.
+     */
+    observe(items, whole) {
+        const fresh = items.filter(item => this.warmedUp.has(this.scopeOf(item)) && !this.seen.has(this.keyOf(item)));
+        for (const item of items)
+            this.seen.add(this.keyOf(item));
+        for (const project of whole)
+            this.warmedUp.add(project);
+        return fresh;
+    }
+}
+//# sourceMappingURL=keyed-watcher.js.map

package/dist/dashboard/keyed-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-watcher.js","sourceRoot":"","sources":["../../src/dashboard/keyed-watcher.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,gGAAgG;AAChG,uFAAuF;AAEvF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IAKH,KAAK;IACL,OAAO;IALT,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IACxB,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IAE7C,YACmB,KAA0B,EAC1B,OAA4B;qBAD5B,KAAK;uBACL,OAAO;IACvB,CAAC;IAEJ;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAU,EAAE,KAAuB;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CACxB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAClF,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QACzD,KAAK,MAAM,OAAO,IAAI,KAAK;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACvD,OAAO,KAAK,CAAA;IACd,CAAC;CACF"}

package/dist/dashboard/keys.d.ts

@@ -0,0 +1,31 @@
+import type { Activity } from './activity.js';
+import type { Intervention } from './interventions.js';
+/**
+ * The stable identity of a watched item, which the browser notifications dedupe on.
+ *
+ * A leaf module on purpose: `activity.ts` and `interventions.ts` build their items by reading the
+ * store, so they import `node:*` and cannot be reached from the browser bundle. These functions
+ * are pure and depend on nothing but the item, so they live here and are re-exported from
+ * `client.ts` — which is what lets the dashboard share them instead of keeping a copy that could
+ * drift from the item types.
+ *
+ * The type imports are erased at compile time, so they add no edge to the graph `client.test.ts`
+ * walks.
+ */
+/**
+ * The stable identity of an intervention. A PR is its url (survives title edits and re-sorts);
+ * the other two have no url and are keyed on the project plus the thing waiting — the agent and
+ * the gate it is parked on, or the agent whose branch is unpushed.
+ *
+ * The agent is part of the awaiting key because a gate id is only unique within its own agent:
+ * every agent's first gate is `await-choices`. Two agents running in one project (#736) and both
+ * parked would otherwise share one identity, and the dedupe would announce only one of them.
+ */
+export declare function interventionKey(item: Intervention): string;
+/**
+ * The stable identity of an activity item: its kind + project + run. The kind is part of the key
+ * so an agent's `started` and `finished` are two separate announcements (one when it kicks off, one
+ * when it lands), each firing exactly once.
+ */
+export declare function activityKey(item: Activity): string;
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/dashboard/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAElD"}

package/dist/dashboard/keys.js

@@ -0,0 +1,37 @@
+/**
+ * The stable identity of a watched item, which the browser notifications dedupe on.
+ *
+ * A leaf module on purpose: `activity.ts` and `interventions.ts` build their items by reading the
+ * store, so they import `node:*` and cannot be reached from the browser bundle. These functions
+ * are pure and depend on nothing but the item, so they live here and are re-exported from
+ * `client.ts` — which is what lets the dashboard share them instead of keeping a copy that could
+ * drift from the item types.
+ *
+ * The type imports are erased at compile time, so they add no edge to the graph `client.test.ts`
+ * walks.
+ */
+/**
+ * The stable identity of an intervention. A PR is its url (survives title edits and re-sorts);
+ * the other two have no url and are keyed on the project plus the thing waiting — the agent and
+ * the gate it is parked on, or the agent whose branch is unpushed.
+ *
+ * The agent is part of the awaiting key because a gate id is only unique within its own agent:
+ * every agent's first gate is `await-choices`. Two agents running in one project (#736) and both
+ * parked would otherwise share one identity, and the dedupe would announce only one of them.
+ */
+export function interventionKey(item) {
+    if (item.kind === 'awaiting')
+        return `awaiting:${item.projectId}:${item.agentId ?? ''}:${item.awaitId ?? ''}`;
+    if (item.kind === 'unpushed')
+        return `unpushed:${item.projectId}:${item.agentId ?? ''}`;
+    return item.url ?? '';
+}
+/**
+ * The stable identity of an activity item: its kind + project + run. The kind is part of the key
+ * so an agent's `started` and `finished` are two separate announcements (one when it kicks off, one
+ * when it lands), each firing exactly once.
+ */
+export function activityKey(item) {
+    return `${item.kind}:${item.projectId}:${item.agentId}`;
+}
+//# sourceMappingURL=keys.js.map

package/dist/dashboard/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/dashboard/keys.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,YAAY,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAA;IAC7G,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,YAAY,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAA;IACvF,OAAO,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAA;AACzD,CAAC"}

package/dist/dashboard/models.d.ts

@@ -0,0 +1,25 @@
+import type { Driver, DriverModel } from '@openagt/agent-driver';
+import { type DriverName } from '../driver-names.js';
+/** What one coding agent offers: its models, or why it could not say. */
+export type DriverModels = {
+    models: DriverModel[];
+} | {
+    models: [];
+    error: string;
+};
+/** The models of every coding agent a person can pick, by driver. */
+export type ModelsView = Record<DriverName, DriverModels>;
+/** Where the dashboard reads which models each coding agent offers. */
+export interface ModelsSource {
+    read(): Promise<ModelsView>;
+}
+/**
+ * Ask each coding agent for its models, once: the first read asks, every later read answers from
+ * what it said, for the daemon's life. The list changes only with a new CLI version or a new
+ * login, and each question starts a CLI, so a menu opened again never waits on one. An agent that
+ * could not say is asked again at the next read, so a CLI installed or logged in since is found.
+ */
+export declare function cachedModelsSource(drivers: Record<DriverName, Pick<Driver, 'listModels'>>): ModelsSource;
+/** The daemon's own source: the coding agents on this machine, asked as the person's own login. */
+export declare function defaultModelsSource(): ModelsSource;
+//# sourceMappingURL=models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/dashboard/models.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE7D,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpF,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;AAEzD,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAA;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,YAAY,CAkBxG;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,IAAI,YAAY,CAElD"}

package/dist/dashboard/models.js

@@ -0,0 +1,30 @@
+import { ClaudeCodeDriver } from '@openagt/agent-driver-claude';
+import { CodexDriver } from '@openagt/agent-driver-codex';
+import { DRIVERS } from '../driver-names.js';
+/**
+ * Ask each coding agent for its models, once: the first read asks, every later read answers from
+ * what it said, for the daemon's life. The list changes only with a new CLI version or a new
+ * login, and each question starts a CLI, so a menu opened again never waits on one. An agent that
+ * could not say is asked again at the next read, so a CLI installed or logged in since is found.
+ */
+export function cachedModelsSource(drivers) {
+    const asked = new Map();
+    const ask = (name) => {
+        let answer = asked.get(name);
+        if (!answer) {
+            const listModels = drivers[name].listModels;
+            answer = listModels ? listModels.call(drivers[name]) : Promise.reject(new Error('this agent cannot list its models'));
+            asked.set(name, answer);
+            answer.catch(() => asked.delete(name));
+        }
+        return answer.then(models => ({ models }), (err) => ({ models: [], error: err instanceof Error ? err.message : String(err) }));
+    };
+    return {
+        read: async () => Object.fromEntries(await Promise.all(DRIVERS.map(async (name) => [name, await ask(name)]))),
+    };
+}
+/** The daemon's own source: the coding agents on this machine, asked as the person's own login. */
+export function defaultModelsSource() {
+    return cachedModelsSource({ 'claude-code': new ClaudeCodeDriver(), codex: new CodexDriver() });
+}
+//# sourceMappingURL=models.js.map

package/dist/dashboard/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/dashboard/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,OAAO,EAAE,OAAO,EAAmB,MAAM,oBAAoB,CAAA;AAa7D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAuD;IACxF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsC,CAAA;IAC3D,MAAM,GAAG,GAAG,CAAC,IAAgB,EAAyB,EAAE;QACtD,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;YAC3C,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAA;YACrH,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACvB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAChB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EACtB,CAAC,GAAY,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAC5F,CAAA;IACH,CAAC,CAAA;IACD,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,IAAI,EAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,CAAU,CAAC,CAAC,CAAe;KACnI,CAAA;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,mBAAmB;IACjC,OAAO,kBAAkB,CAAC,EAAE,aAAa,EAAE,IAAI,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,EAAE,CAAC,CAAA;AAChG,CAAC"}

package/dist/dashboard/module-host.d.ts

@@ -0,0 +1,44 @@
+import { type BranchesFor } from '../store/index.js';
+import { type LinkedPr } from './pull-requests.js';
+import type { Cached } from './cache.js';
+import type { ModuleServerHost } from '../module-server.js';
+/** What {@link serverHost} reads through; each defaults to the production reader. */
+export interface ServerHostDeps {
+    branches?: BranchesFor;
+    agent?: (root: string, agentId: string) => Promise<{
+        id: string;
+        status?: string;
+        host?: string;
+        branch?: string;
+        pr?: {
+            number: number;
+        };
+        base?: string;
+        baseCommit?: string;
+        landed?: string;
+    } | undefined>;
+    /** This machine's name, against a run's `host`. */
+    host?: string;
+    prs?: (root: string, branch: string) => Promise<Cached<LinkedPr[]>>;
+}
+/** The host a read of the project at `root` is given. */
+export declare function serverHost(root: string, deps?: ServerHostDeps): ModuleServerHost;
+/** How large the input of one read may be, as JSON: what a page asks with, never a payload. */
+export declare const MAX_READ_INPUT: number;
+/** How long one read may take before it answers an error instead. */
+export declare const READ_TIMEOUT_MS = 20000;
+/** What a read answered: its JSON, or why there is none. */
+export type ModuleReadResult = {
+    ok: true;
+    output: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Call read `name` of the server part at `file` with `host` and `input`. Refused: a part that did
+ * not load, a read it does not have, an input that is not an object or is too large. A read that
+ * throws or runs past {@link READ_TIMEOUT_MS} answers an error; nothing a read does stops the daemon.
+ */
+export declare function callModuleRead(file: string, name: string, host: ModuleServerHost, input: unknown, timeoutMs?: number): Promise<ModuleReadResult>;
+//# sourceMappingURL=module-host.d.ts.map

package/dist/dashboard/module-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-host.d.ts","sourceRoot":"","sources":["../../src/dashboard/module-host.ts"],"names":[],"mappings":"AACA,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEvG,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAA0D,gBAAgB,EAAY,MAAM,qBAAqB,CAAA;AAM7H,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IAC7M,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;CACpE;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,gBAAgB,CAkCpF;AAoBD,+FAA+F;AAC/F,eAAO,MAAM,cAAc,QAAY,CAAA;AACvC,qEAAqE;AACrE,eAAO,MAAM,eAAe,QAAS,CAAA;AAErC,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3F;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,SAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsB/J"}