@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/dashboard/module-host.js

@@ -0,0 +1,91 @@
+import { pathToFileURL } from 'node:url';
+import { findAgent, findCheckout, isRunId, projectBranches } from '../store/index.js';
+import { agentBranchFor, leftNothing } from './agent-handoff.js';
+import { cachedPrsForBranch } from './pull-requests.js';
+/** The host a read of the project at `root` is given. */
+export function serverHost(root, deps = {}) {
+    return {
+        root,
+        async run(agentId) {
+            if (typeof agentId !== 'string' || !isRunId(agentId))
+                return undefined;
+            const checkout = await findCheckout(root, agentId, deps.branches ?? projectBranches);
+            const agent = await (deps.agent ?? findAgent)(root, agentId).catch(() => undefined);
+            if (!checkout && !agent)
+                return undefined;
+            const branch = agent && agentBranchFor(agent);
+            return {
+                ...(checkout ? { checkout: checkout.path } : {}),
+                ...(agent
+                    ? {
+                        record: {
+                            ...(agent.status !== undefined ? { status: agent.status } : {}),
+                            ...(agent.host !== undefined ? { host: agent.host } : {}),
+                            ...(branch !== undefined ? { branch } : {}),
+                            ...(agent.pr ? { pr: { number: agent.pr.number } } : {}),
+                            ...(agent.base !== undefined ? { base: agent.base } : {}),
+                            ...(agent.baseCommit !== undefined ? { baseCommit: agent.baseCommit } : {}),
+                            ...(agent.landed !== undefined ? { landed: agent.landed } : {}),
+                        },
+                    }
+                    : {}),
+                changedNothing: agent ? leftNothing(agent, deps.host) : false,
+            };
+        },
+        async mergeCommit(branch, number) {
+            const read = await (deps.prs ?? cachedPrsForBranch)(root, branch).catch(() => ({ value: undefined, pending: false }));
+            if (read.pending && read.value === undefined)
+                return { pending: true };
+            const pr = read.value?.find(pr => pr.number === number);
+            return pr?.mergeCommit ? { pending: false, commit: pr.mergeCommit, ...(pr.headRefOid ? { head: pr.headRefOid } : {}) } : { pending: false };
+        },
+    };
+}
+/** Each server part, imported once per daemon, by its file. */
+const imported = new Map();
+function load(file) {
+    let loading = imported.get(file);
+    if (!loading) {
+        loading = import(pathToFileURL(file).href).then((module) => {
+            const server = module.default;
+            return server && typeof server === 'object' && server.reads && typeof server.reads === 'object' ? server : undefined;
+        }, () => undefined);
+        imported.set(file, loading);
+    }
+    return loading;
+}
+/** How large the input of one read may be, as JSON: what a page asks with, never a payload. */
+export const MAX_READ_INPUT = 16 * 1024;
+/** How long one read may take before it answers an error instead. */
+export const READ_TIMEOUT_MS = 20_000;
+/**
+ * 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 async function callModuleRead(file, name, host, input, timeoutMs = READ_TIMEOUT_MS) {
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        return { ok: false, error: 'a read takes an object' };
+    if (JSON.stringify(input).length > MAX_READ_INPUT)
+        return { ok: false, error: 'the read input is too large' };
+    const server = await load(file);
+    if (!server)
+        return { ok: false, error: 'the module’s server part did not load' };
+    const read = Object.hasOwn(server.reads, name) ? server.reads[name] : undefined;
+    if (typeof read !== 'function')
+        return { ok: false, error: `the module has no read ${name}` };
+    let timer;
+    const timeout = new Promise(resolve => {
+        timer = setTimeout(() => resolve({ ok: false, error: `the read ${name} took too long` }), timeoutMs);
+    });
+    try {
+        return await Promise.race([
+            read(host, input).then((output) => ({ ok: true, output: output ?? null }), (error) => ({ ok: false, error: error instanceof Error ? error.message : String(error) })),
+            timeout,
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=module-host.js.map

package/dist/dashboard/module-host.js.map

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

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

@@ -0,0 +1,15 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type ProjectsProvider } from './projects.js';
+import { type ProjectModule } from '../project-modules.js';
+/** Where module files are served: `/_modules/<project id>/<package>/<file>`, each segment encoded. */
+export declare const MODULES_PREFIX = "/_modules";
+/** The URL a module's browser part is served at from one project. */
+export declare function moduleUrl(projectId: string, module: Pick<ProjectModule, 'package' | 'entry'>): string;
+/**
+ * Serve one module file (#1774): the project must be registered, the package must be a module of
+ * that project, and the file must sit inside the module's browser part's own directory. Anything else is a
+ * 404, never a fallback: a module URL is asked for by the dashboard's loader, not typed by a person.
+ * Served as `no-cache`, since a module is rebuilt in place under the same name.
+ */
+export declare function serveModuleFile(req: IncomingMessage, res: ServerResponse, pathname: string, projects?: ProjectsProvider): Promise<void>;
+//# sourceMappingURL=module-serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module-serve.d.ts","sourceRoot":"","sources":["../../src/dashboard/module-serve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEzF,sGAAsG;AACtG,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,MAAM,CAGrG;AAUD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,gBAA4C,GACrD,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/dashboard/module-serve.js

@@ -0,0 +1,45 @@
+import { readFile } from 'node:fs/promises';
+import { contentTypeFor } from './content-type.js';
+import { defaultProjectsProvider } from './projects.js';
+import { findProjectModule, moduleFile } from '../project-modules.js';
+/** Where module files are served: `/_modules/<project id>/<package>/<file>`, each segment encoded. */
+export const MODULES_PREFIX = '/_modules';
+/** The URL a module's browser part is served at from one project. */
+export function moduleUrl(projectId, module) {
+    const file = module.entry.split('/').map(encodeURIComponent).join('/');
+    return `${MODULES_PREFIX}/${encodeURIComponent(projectId)}/${encodeURIComponent(module.package)}/${file}`;
+}
+function decode(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Serve one module file (#1774): the project must be registered, the package must be a module of
+ * that project, and the file must sit inside the module's browser part's own directory. Anything else is a
+ * 404, never a fallback: a module URL is asked for by the dashboard's loader, not typed by a person.
+ * Served as `no-cache`, since a module is rebuilt in place under the same name.
+ */
+export async function serveModuleFile(req, res, pathname, projects = defaultProjectsProvider()) {
+    const notFound = () => void res.writeHead(404, { 'content-type': 'text/plain' }).end('no such module file');
+    if (req.method !== 'GET' && req.method !== 'HEAD')
+        return void res.writeHead(405, { allow: 'GET, HEAD' }).end();
+    const [projectSegment, packageSegment, ...rest] = pathname.slice(MODULES_PREFIX.length + 1).split('/');
+    const projectId = projectSegment !== undefined ? decode(projectSegment) : undefined;
+    const pkg = packageSegment !== undefined ? decode(packageSegment) : undefined;
+    const rel = rest.map(decode);
+    if (!projectId || !pkg || rel.length === 0 || rel.some(part => part === undefined))
+        return notFound();
+    const root = await projects.resolvePath(projectId);
+    const module = root ? await findProjectModule(root, pkg).catch(() => undefined) : undefined;
+    const file = module ? await moduleFile(module, rel.join('/')) : undefined;
+    const body = file ? await readFile(file).catch(() => undefined) : undefined;
+    if (!file || body === undefined)
+        return notFound();
+    res.writeHead(200, { 'content-type': contentTypeFor(file), 'cache-control': 'no-cache' });
+    res.end(req.method === 'HEAD' ? undefined : body);
+}
+//# sourceMappingURL=module-serve.js.map

package/dist/dashboard/module-serve.js.map

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

package/dist/dashboard/open-in-app.d.ts

@@ -0,0 +1,43 @@
+/** Which app to open the project in. */
+export type OpenTarget = 'files' | 'editor';
+/** A known editor: its launcher CLI plus a human label for the picker (#727). */
+export interface EditorInfo {
+    bin: string;
+    label: string;
+}
+/**
+ * The editors the picker can offer (#727), probed by their CLI launcher on PATH. Order is the
+ * display order. `$FRAMEWORK_EDITOR` and a hand-typed value stay valid beyond this list; this is
+ * only what auto-detection looks for.
+ */
+export declare const KNOWN_EDITORS: EditorInfo[];
+/** Whether an editor launcher is installed (on PATH). A seam so detection is unit-testable. */
+export type EditorProbe = (bin: string) => Promise<boolean>;
+/** The installed subset of {@link KNOWN_EDITORS}, in display order (#727). */
+export declare function detectEditors(probe?: EditorProbe): Promise<EditorInfo[]>;
+/** The outcome of an open attempt. */
+export type OpenResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Spawns a command, resolving once it launches (not on exit) and rejecting if it can't start. */
+export type SpawnRunner = (command: string, args: string[]) => Promise<void>;
+/** The OS command that reveals a path in the file manager. */
+export declare function fileManagerCommand(path: string, os?: NodeJS.Platform): {
+    command: string;
+    args: string[];
+};
+/** The command to open a path in an editor: `$FRAMEWORK_EDITOR` when set, else the VS Code CLI. */
+export declare function editorCommand(path: string, editor?: string | undefined): {
+    command: string;
+    args: string[];
+};
+/**
+ * Open the project at `cwd` in the file manager or an editor. Failures are values, never throws.
+ * `editor` (#727) is the stored preference; when unset {@link editorCommand} falls back to
+ * `$FRAMEWORK_EDITOR`, then `code`.
+ */
+export declare function openInApp(cwd: string, target: OpenTarget, agent?: SpawnRunner, editor?: string): Promise<OpenResult>;
+//# sourceMappingURL=open-in-app.d.ts.map

package/dist/dashboard/open-in-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-app.d.ts","sourceRoot":"","sources":["../../src/dashboard/open-in-app.ts"],"names":[],"mappings":"AAQA,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE3C,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,EAYrC,CAAA;AAED,+FAA+F;AAC/F,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AA0B3D,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,KAAK,GAAE,WAA+B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAGjG;AAED,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpE,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAqB5E,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,MAAM,CAAC,QAAqB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAItH;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,qBAA+B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGtH;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,EAClB,KAAK,GAAE,WAA+B,EACtC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/dist/dashboard/open-in-app.js

@@ -0,0 +1,98 @@
+import { platform } from 'node:os';
+import { delimiter, join } from 'node:path';
+/**
+ * The editors the picker can offer (#727), probed by their CLI launcher on PATH. Order is the
+ * display order. `$FRAMEWORK_EDITOR` and a hand-typed value stay valid beyond this list; this is
+ * only what auto-detection looks for.
+ */
+export const KNOWN_EDITORS = [
+    { bin: 'code', label: 'VS Code' },
+    { bin: 'code-insiders', label: 'VS Code Insiders' },
+    { bin: 'cursor', label: 'Cursor' },
+    { bin: 'windsurf', label: 'Windsurf' },
+    { bin: 'zed', label: 'Zed' },
+    { bin: 'subl', label: 'Sublime Text' },
+    { bin: 'webstorm', label: 'WebStorm' },
+    { bin: 'idea', label: 'IntelliJ IDEA' },
+    { bin: 'nvim', label: 'Neovim' },
+    { bin: 'vim', label: 'Vim' },
+    { bin: 'emacs', label: 'Emacs' },
+];
+/**
+ * An {@link EditorProbe} that looks each launcher up on the real PATH: an executable match in any
+ * PATH dir (trying PATHEXT suffixes on Windows). Pure lookup, nothing is spawned.
+ */
+function nodeEditorProbe(env = process.env, os = platform()) {
+    const dirs = (env.PATH ?? '').split(delimiter).filter(Boolean);
+    const exts = os === 'win32' ? (env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';').filter(Boolean) : [''];
+    return async (bin) => {
+        const { access, constants } = await import('node:fs/promises');
+        const flag = os === 'win32' ? constants.F_OK : constants.X_OK;
+        for (const dir of dirs) {
+            for (const ext of exts) {
+                try {
+                    await access(join(dir, bin + ext), flag);
+                    return true;
+                }
+                catch {
+                    // not here; keep looking
+                }
+            }
+        }
+        return false;
+    };
+}
+/** The installed subset of {@link KNOWN_EDITORS}, in display order (#727). */
+export async function detectEditors(probe = nodeEditorProbe()) {
+    const hits = await Promise.all(KNOWN_EDITORS.map(async (e) => ((await probe(e.bin)) ? e : null)));
+    return hits.filter((e) => e !== null);
+}
+/**
+ * A {@link SpawnRunner} backed by `spawn`, detached. Resolves on the `spawn` event so a
+ * long-lived editor (or `explorer`, which exits non-zero even on success) does not block or
+ * error; rejects on the `error` event (e.g. ENOENT when the command is not on PATH).
+ */
+function nodeSpawnRunner() {
+    return (command, args) => new Promise((resolve, reject) => {
+        void import('node:child_process').then(({ spawn }) => {
+            const child = spawn(command, args, { stdio: 'ignore', detached: true });
+            child.on('error', reject);
+            child.on('spawn', () => {
+                child.unref();
+                resolve();
+            });
+        });
+    });
+}
+/** The OS command that reveals a path in the file manager. */
+export function fileManagerCommand(path, os = platform()) {
+    if (os === 'darwin')
+        return { command: 'open', args: [path] };
+    if (os === 'win32')
+        return { command: 'explorer', args: [path] };
+    return { command: 'xdg-open', args: [path] };
+}
+/** The command to open a path in an editor: `$FRAMEWORK_EDITOR` when set, else the VS Code CLI. */
+export function editorCommand(path, editor = process.env.FRAMEWORK_EDITOR) {
+    const bin = editor && editor.trim() ? editor.trim() : 'code';
+    return { command: bin, args: [path] };
+}
+/**
+ * Open the project at `cwd` in the file manager or an editor. Failures are values, never throws.
+ * `editor` (#727) is the stored preference; when unset {@link editorCommand} falls back to
+ * `$FRAMEWORK_EDITOR`, then `code`.
+ */
+export async function openInApp(cwd, target, agent = nodeSpawnRunner(), editor) {
+    const { command, args } = target === 'editor' ? editorCommand(cwd, editor) : fileManagerCommand(cwd);
+    try {
+        await agent(command, args);
+        return { ok: true };
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            return { ok: false, error: `"${command}" was not found on PATH` };
+        }
+        return { ok: false, error: err instanceof Error ? err.message : 'failed to open' };
+    }
+}
+//# sourceMappingURL=open-in-app.js.map

package/dist/dashboard/open-in-app.js.map

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

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

@@ -0,0 +1,45 @@
+import { type AgentMeta, type LiveAgent } from '../store/index.js';
+import type { ChoiceRequest, FrameworkEvent } 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<FrameworkEvent[] | 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