@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/dashboard-rpc/reads.js

@@ -0,0 +1,370 @@
+import { findAgent, findCheckout, readLiveMetas, readAllAgents, readDoing, loadAgentEvents, startedAtFromAgentId, isPidAlive, isRunId, projectBranches } from '../store/index.js';
+import { listProjectWorktrees } from '../worktrees.js';
+import { projectGitHost } from '../store/git-host.js';
+import { repositoryOffer } from '../store/repository.js';
+import { readDocs } from '../dashboard/docs.js';
+import { collectQueue } from '../dashboard/queue.js';
+import { buildOverview, buildRecentAgents } from '../dashboard/overview.js';
+import { buildInterventions } from '../dashboard/interventions.js';
+import { buildOpenQuestions } from '../dashboard/open-questions.js';
+import { buildActivity } from '../dashboard/activity.js';
+import { buildDashboard } from '../dashboard/dashboard.js';
+import { readGitStatus } from '../dashboard/git-status.js';
+import { readRunHandoff, resolveAgentPr } from '../dashboard/agent-handoff.js';
+import { crawlRepoFiles } from '../project.js';
+import { contextBridgeBrowser, contextProjects, contextRemote, resolveProjectPath, resolveAgentPath } from './context.js';
+import { relayOr } from './relay-agent.js';
+import { bridgeQuestions } from '../dashboard/bridge-store.js';
+import { readDaemonToken, readPreferences } from '../registry.js';
+import { hostname } from 'node:os';
+// The read model behind the dashboard (#405): the agent history, an agent's replay, and the
+// surfaced PLAN/TODO docs — each keyed by project id and backed by
+// the readers that own those files, so the dashboard stays a projection of the same files. They live beside the daemon rather than in the
+// browser's own tree so it can serve them in-process; the dashboard calls them by name over
+// `POST /_rpc/<name>`. The live agent stream is its own endpoint (`GET /_rpc/events`).
+/**
+ * Resolve a project id and run a forgiving read against its workspace: an unknown project
+ * or a failing read both fall back to `empty`. The uniform readers below are one call each
+ * over this; the agent history and null-returning git readers stay bespoke (extra logic or a
+ * distinct empty).
+ */
+async function withProject(projectId, read, empty) {
+    const cwd = await resolveProjectPath(projectId);
+    return cwd ? read(cwd).catch(() => empty) : empty;
+}
+/**
+ * The `withProject` twin for a run-scoped read: resolve the checkout a `agentId` names (its own
+ * worktree while live, else the project root, #738), then read forgivingly. An absent project
+ * or a failing read both fall back to `empty`.
+ */
+async function withAgentPath(projectId, agentId, read, empty) {
+    const cwd = await resolveAgentPath(projectId, agentId);
+    return cwd ? read(cwd).catch(() => empty) : empty;
+}
+/** Run a cross-project rollup over every registered project, tolerating a failed registry read. */
+async function withProjects(build) {
+    const projects = await contextProjects().list().catch(() => []);
+    return build(projects);
+}
+/**
+ * The project's runs, most-recent first (or `[]`). The archived (finished) runs
+ * from `agents/`, plus every live agent prepended — so the sidebar shows an in-progress
+ * run with a `running` status the moment it starts, not only after it closes.
+ *
+ * Since #736 a project has any number of live agents, each in its own worktree, so this reads
+ * them all (#738) instead of the single one that used to sit at the project path. They come
+ * back as {@link LiveAgent}s, carrying the `cwd` of the checkout that agent is editing.
+ *
+ * One row per id, and where both a live and an archived copy exist the live one wins (#768): a
+ * continued run (#762) has an archive from its first leg while being live again, and the archive
+ * would otherwise show a running agent as finished. The status is not filtered on: `readLiveMeta`
+ * may have just self-healed a dead agent to `stopped` (#716), and that freshly-archived row can
+ * lag `listAgents` by a poll — keeping it regardless leaves the row visible with no flicker.
+ *
+ * An agent relayed to a connected device (#1067) lives only in the daemon's memory, never on disk, so
+ * its in-memory stub is merged in too (#1077): that is what re-opens it after a dashboard reload
+ * instead of losing it.
+ */
+export async function onAgents(projectId) {
+    // The relayed-agent stubs (#1077). Read up front by habit rather than by necessity now: the
+    // context was request-scoped and evaporated at the first await, so reading it late dropped
+    // every remote agent from the list on a reload. It is wired once at start-up (F3), so an await
+    // no longer costs anything — nothing here depends on this staying above one.
+    const remote = contextRemote()?.list(projectId) ?? [];
+    const cwd = await resolveProjectPath(projectId);
+    const local = cwd ? (await readAllAgents(cwd)).map(forDashboard) : [];
+    if (remote.length === 0)
+        return local;
+    // A relayed agent (#1067) lives only in the daemon's memory, not on disk; surface it in the list so
+    // a reload re-opens it instead of losing it. Remote wins an id tie (it is the live authority).
+    return [...remote, ...local.filter(agent => !remote.some(r => r.id === agent.id))];
+}
+/**
+ * A web run whose cloud session is waiting on a human — the bridge holds its parked question, or
+ * claude.ai's session list shows it awaiting input (#1332) — is marked waiting (#1668), so its row
+ * says so instead of "in cloud": the archive on disk cannot know, only the daemon's bridge store
+ * does. Every other run passes through untouched.
+ */
+export function markCloudWaiting(agent) {
+    if (agent.target !== 'web' || !agent.sessionId || !bridgeQuestions().waiting(agent.sessionId))
+        return agent;
+    return { ...agent, cloudWaiting: true };
+}
+/**
+ * A run another machine's daemon started is marked as from another host (#1648): the data branch
+ * is shared precisely so other machines' runs show up here, and a row that looked exactly like
+ * one of this daemon's own sent the user reading the archive by hand to learn whose it was. A run
+ * with no recorded host predates the field and passes through untouched.
+ */
+export function markOtherHost(agent, thisHost = hostname()) {
+    if (agent.host === undefined || agent.host === thisHost)
+        return agent;
+    return { ...agent, otherHost: true };
+}
+/**
+ * A run that ended clean while the process its card names is still alive on this host is marked
+ * saving: the tool that runs it saves the run's record and cleans up its checkout after the card says
+ * done, and a row that said "done" through that window read as finished with nothing coming. A
+ * run of another host, or with no recorded process, passes through untouched.
+ */
+export function markSaving(agent, thisHost = hostname(), alive = isPidAlive) {
+    if (agent.status !== 'done' || agent.pid === undefined || agent.host !== thisHost || !alive(agent.pid))
+        return agent;
+    return { ...agent, saving: true };
+}
+/** Every annotation a run's record gets on its way to the dashboard: what the daemon knows and the disk cannot. */
+function forDashboard(agent) {
+    return markSaving(markOtherHost(markCloudWaiting(agent)));
+}
+/**
+ * The agent ids that still have a worktree on disk (#737). An agent that failed or was stopped keeps
+ * its checkout so you can go look at what it was holding; this is how the dashboard knows which
+ * finished run has one to offer removing. Live agents are excluded — their worktree is in use.
+ */
+export async function onRetainedWorktrees(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return [];
+    const rows = await listProjectWorktrees(cwd, { sizes: false }).catch(() => []);
+    return rows.filter(row => !row.live).map(row => row.agentId);
+}
+/**
+ * Where a session is working (#798): the checkout it has, its branch, whether it is holding
+ * uncommitted changes, and — once it is no longer live — what that checkout costs on disk.
+ *
+ * The dashboard could not answer "where is this session working". The git status bar reads the
+ * *project*, so a session's own branch was visible nowhere, and a worktree an agent kept (#737) was
+ * a name in a list with no size and no way in.
+ *
+ * Every run works in a checkout of its own, so once that checkout is gone there is no tree left to
+ * be clean or dirty: the answer is then only what the run recorded, its branch and its pull
+ * request. It used to fall back to the project's root and report the user's own checkout (their
+ * branch, their "clean") as the run's.
+ */
+export async function onAgentWorktree(projectId, agentId) {
+    return relayOr(agentId, 'onAgentWorktree', [projectId, agentId], async () => {
+        const root = await resolveProjectPath(projectId);
+        if (!root || !isRunId(agentId))
+            return null;
+        const checkout = await findCheckout(root, agentId, projectBranches);
+        if (!checkout) {
+            // The checkout's branch was the agent's; with no checkout the record is the only witness.
+            const agent = await findAgent(root, agentId).catch(() => undefined);
+            if (!agent)
+                return null;
+            const pr = await resolveAgentPr(root, agent).catch(() => ({ value: undefined, pending: false }));
+            return {
+                ...(agent.branch ? { branch: agent.branch } : {}),
+                ...(pr.value ? { pr: pr.value } : {}),
+                ...(pr.pending ? { prPending: true } : {}),
+            };
+        }
+        // Since-filtered like every run-scoped PR read (#1255): the checkout's branch is the agent's,
+        // but a reused pinned branch has a predecessor's PR history.
+        const since = startedAtFromAgentId(agentId);
+        const [status, live] = await Promise.all([
+            readGitStatus(checkout.path, { prRoot: root, ...(since !== undefined ? { since } : {}) }).catch(() => undefined),
+            readLiveMetas(root).catch(() => []),
+        ]);
+        // Size is only read for a checkout nothing is writing to: a live agent's tree changes under the
+        // poll, and a size over a build directory mid-build is a cost with no answer worth having. The
+        // provider's sized listing is where a checkout's size comes from (#1774).
+        const running = live.some(agent => agent.id === agentId && agent.status === 'running');
+        const size = running ? undefined : (await (await projectBranches(root).catch(() => undefined))?.list({ sizes: true }).catch(() => []))?.find(row => row.id === agentId)?.sizeBytes;
+        return {
+            checkout: { path: checkout.path, dirty: status?.dirty ?? false, ...(size !== undefined ? { sizeBytes: size } : {}) },
+            ...(status?.branch ? { branch: status.branch } : {}),
+            // A session's branch is exactly the thing that has a PR (#809), so the bar can show it
+            // like the project's does.
+            ...(status?.pr ? { pr: status.pr } : {}),
+            // Still being looked up rather than absent (#1028), so the bar can ask again shortly.
+            ...(status?.prPending ? { prPending: true } : {}),
+        };
+    }, null);
+}
+/** One archived agent's event log for replay (or `[]` when the agent or project is gone). */
+export async function onAgent(projectId, agentId) {
+    return relayOr(agentId, 'onAgent', [projectId, agentId], async () => {
+        const cwd = await resolveProjectPath(projectId);
+        if (!cwd)
+            return [];
+        return (await loadAgentEvents(cwd, agentId).catch(() => undefined)) ?? [];
+    }, []);
+}
+/** What each of the named runs of a project is doing now, by id; a run that is not working has no entry. */
+export async function onAgentsDoing(projectId, agentIds) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return {};
+    return readDoing(cwd, agentIds).catch(() => ({}));
+}
+/** The surfaced PLAN/TODO docs at the workspace root, in sidebar order (or `[]`). */
+export async function onDocs(projectId) {
+    return withProject(projectId, readDocs, []);
+}
+/** The aggregated open TODO queue across every registered project (#438), most-open first. */
+export async function onQueue() {
+    return withProjects(collectQueue);
+}
+/** The cross-project Overview (#437): what is running now, the queue size, and recent projects. */
+export async function onOverview() {
+    return withProjects(buildOverview);
+}
+/** Recent sessions pooled across every project (#shared-shell), newest first, for the home rail. */
+export async function onRecentAgents() {
+    const recent = await withProjects(projects => buildRecentAgents(projects));
+    return recent.map(row => ({ ...row, agent: forDashboard(row.agent) }));
+}
+/**
+ * The cross-project interventions queue (#632, Queue #624): open PRs that need review, newest first,
+ * plus which projects were read whole (#1625).
+ *
+ * The panels render `items` and ignore the rest. The browser's notifier is the caller that cannot:
+ * it keeps a baseline of what was already waiting when the page opened, and a queue that came back
+ * empty because the git host was unreachable is not a baseline — taking it for one announces the whole
+ * backlog the moment the git host answers.
+ */
+export async function onInterventions() {
+    return withProjects(buildInterventions);
+}
+/** Every session's open question with its full gate (#1455), longest-waiting first: the launcher's hub. */
+export async function onOpenQuestions() {
+    return withProjects(buildOpenQuestions);
+}
+/**
+ * The cross-project "New activity" feed (#627): recent run started/finished transitions, newest
+ * first, with the projects that were read whole beside them (#1625) — see {@link onInterventions}.
+ */
+export async function onActivity() {
+    return withProjects(buildActivity);
+}
+/** The Overview dashboard page (#471): the {@link onOverview} rollup plus agent counts, run-status totals, and activity. */
+export async function onDashboard() {
+    return withProjects(buildDashboard);
+}
+/**
+ * The project's files for the `#` context picker (#504) and the Context's file count (#661): every
+ * file git sees (tracked + untracked, honoring .gitignore), repo-relative and sorted, via
+ * `git ls-files`. Localhost-only by nature — the relay has no checkout, so it resolves `[]`.
+ * Pass a live `agentId` to list that agent's worktree instead of the project root (#738). The
+ * Files tab reads its own list, through its module.
+ */
+export async function onProjectFiles(projectId, agentId) {
+    return relayOr(agentId, 'onProjectFiles', [projectId, agentId], () => withAgentPath(projectId, agentId, crawlRepoFiles, []), []);
+}
+/** The project's page on its git host and the git host's name (#489, #1820), or null: no git host package, no remote there, or the relay. */
+export async function onGitHostHome(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return null;
+    const gitHost = await projectGitHost(cwd).catch(() => undefined);
+    return (await gitHost?.home()) ?? null;
+}
+/** The repository the project's provider offers to create for it (a project with no remote), or null: no provider, a remote already there, the host out of reach, or the relay. */
+export async function onRepositoryOffer(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return null;
+    return (await repositoryOffer(cwd)) ?? null;
+}
+/**
+ * The project's git status (#491): active branch, dirty flag, linked PR. Null when not a repo /
+ * relay. Pass a live `agentId` to read that agent's worktree, which is the branch and the dirty
+ * state that actually belong to it (#738). A run-scoped read is since-filtered (#1255): an agent on
+ * a reused pinned branch must not wear a predecessor's merged PR as its own badge.
+ */
+export async function onGitStatus(projectId, agentId) {
+    return relayOr(agentId, 'onGitStatus', [projectId, agentId], async () => {
+        const cwd = await resolveAgentPath(projectId, agentId);
+        if (!cwd)
+            return null;
+        const since = agentId !== undefined ? startedAtFromAgentId(agentId) : undefined;
+        return (await readGitStatus(cwd, since !== undefined ? { since } : {})) ?? null;
+    }, null);
+}
+/**
+ * The end-of-session handoff (#799): the branch a finished session left its work on, what it
+ * committed, what it changed, and whether that has been pushed or opened as a PR.
+ *
+ * Read from the *project* checkout against the session's branch, not from the session's worktree.
+ * A clean agent's worktree is removed when it finishes, and `resolveAgentPath` then falls back to the
+ * project root — so a worktree-addressed read reports the project's own branch and the user's own
+ * uncommitted changes as though they were the session's. The branch is what outlives the agent, so
+ * the branch is what this asks about.
+ */
+export async function onAgentHandoff(projectId, agentId) {
+    return relayOr(agentId, 'onAgentHandoff', [projectId, agentId], async () => {
+        const cwd = await resolveProjectPath(projectId);
+        if (!cwd || !isRunId(agentId))
+            return null;
+        const agent = await findAgent(cwd, agentId).catch(() => undefined);
+        return (agent && (await readRunHandoff(cwd, agent).catch(() => undefined))) ?? null;
+    }, null);
+}
+/**
+ * The question a Claude web session is parked on, as reported by the browser bridge (#1237).
+ *
+ * Keyed by cloud session id rather than agent id because that is what the bridge can see: it reads
+ * a claude.ai page, which knows its session and nothing about our runs. The agent view already
+ * derives that id from the agent's own `cloud <url>` event, so the join happens on the client
+ * without the daemon having to index runs by session.
+ *
+ * Returns null for anything unrecognised, so an agent with no bridge, no question, or a target that
+ * is not `web` renders exactly as it did before.
+ */
+export async function onBridgeQuestion(sessionId) {
+    if (typeof sessionId !== 'string' || !/^session_[A-Za-z0-9]{1,128}$/.test(sessionId))
+        return null;
+    return bridgeQuestions().get(sessionId) ?? null;
+}
+/**
+ * Whether anything has reached the browser bridge, and how it went (#1237).
+ *
+ * A misconfigured extension and an uninstalled one both leave no question behind, so "nothing is
+ * showing" cannot be diagnosed from the questions alone. A refused request at least proves
+ * something is trying, and its status says which half is wrong.
+ */
+export async function onBridgeStatus() {
+    const store = bridgeQuestions();
+    return {
+        lastContact: store.lastContact() ?? null,
+        questions: store.list().length,
+        page: store.hello() ?? null,
+        version: store.version() ?? null,
+    };
+}
+/**
+ * The bridge token, for the setup step where a user pastes it into the extension (#1237).
+ *
+ * Only while the bridge is on, so a daemon with the feature off never hands the secret to a
+ * page. Revealing it here is not a new exposure: anyone who can load this dashboard can already
+ * start runs on this machine, and on a non-loopback bind their browser is holding the same token
+ * as a cookie. What it replaces is the alternative, which was telling people to open
+ * `~/.the-framework.json` and copy a field out of it.
+ */
+export async function onBridgeToken() {
+    const preferences = await readPreferences().catch(() => ({}));
+    if (preferences.bridge !== true)
+        return null;
+    return (await readDaemonToken().catch(() => undefined)) ?? null;
+}
+/**
+ * Where the answer picked for that session's question stands (#1237): queued for the
+ * extension, delivered, or failed with the extension's reason. Null when nothing was picked.
+ */
+export async function onBridgeAnswer(sessionId) {
+    if (typeof sessionId !== 'string' || !/^session_[A-Za-z0-9]{1,128}$/.test(sessionId))
+        return null;
+    return bridgeQuestions().answer(sessionId) ?? null;
+}
+/** What a Claude web session has said so far, as scraped by the browser bridge (#1237). */
+export async function onBridgeEvents(sessionId) {
+    if (typeof sessionId !== 'string' || !/^session_[A-Za-z0-9]{1,128}$/.test(sessionId))
+        return [];
+    return bridgeQuestions().events(sessionId);
+}
+/** Where the daemon's own bridge browser stands (#1332): off, starting (and on which step), running, or stopped and why. */
+export async function onBridgeBrowser() {
+    return contextBridgeBrowser().status();
+}
+//# sourceMappingURL=reads.js.map

package/dist/dashboard-rpc/reads.js.map

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

package/dist/dashboard-rpc/reads.telefunc.d.ts

@@ -0,0 +1,197 @@
+import { type RunMeta } from '../store/index.js';
+import { type LogEntry } from '../logs.js';
+import { type WorkspaceDoc } from '../dashboard/docs.js';
+import { type WorkspaceTicket, type WorkspaceTicketDetail, type TicketsMeta } from '../dashboard/tickets.js';
+import { type ProjectQueue } from '../dashboard/queue.js';
+import { type Overview, type RecentRun, type HotTicket, type ProjectTickets } from '../dashboard/overview.js';
+import { type Intervention } from '../dashboard/interventions.js';
+import { type OpenQuestion } from '../dashboard/open-questions.js';
+import { type Activity } from '../dashboard/activity.js';
+import { type DashboardData } from '../dashboard/dashboard.js';
+import { type GitStatus } from '../dashboard/git-status.js';
+import { type RunHandoff } from '../dashboard/run-handoff.js';
+import type { RunWorktree } from '../dashboard/types.js';
+import { type FileGitStatus } from '../dashboard/file-status.js';
+import { type FileDiff, type FileChange } from '../dashboard/file-diff.js';
+import { type FileContent } from '../dashboard/file-read.js';
+import type { FrameworkEvent } from '../events.js';
+import type { BridgeEvent, BridgeHello, BridgeQuestion } from '../dashboard/bridge-endpoints.js';
+import type { BridgeAnswer, BridgeContact } from '../dashboard/bridge-store.js';
+/**
+ * The project's runs, most-recent first (or `[]`). The archived (finished) runs
+ * from `runs/`, plus every live run prepended — so the sidebar shows an in-progress
+ * run with a `running` status the moment it starts, not only after it closes.
+ *
+ * Since #736 a project has any number of live runs, each in its own worktree, so this reads
+ * them all (#738) instead of the single one that used to sit at the project path. They come
+ * back as {@link LiveRun}s, carrying the `cwd` of the checkout that run is editing.
+ *
+ * One row per id, and where both a live and an archived copy exist the live one wins (#768): a
+ * continued run (#762) has an archive from its first leg while being live again, and the archive
+ * would otherwise show a running run as finished. The status is not filtered on: `readLiveMeta`
+ * may have just self-healed a dead run to `stopped` (#716), and that freshly-archived row can
+ * lag `listRuns` by a poll — keeping it regardless leaves the row visible with no flicker.
+ *
+ * A run relayed to a connected device (#1067) lives only in the daemon's memory, never on disk, so
+ * its in-memory stub is merged in too (#1077): that is what re-opens it after a dashboard reload
+ * instead of losing it.
+ */
+export declare function onRuns(projectId: string): Promise<RunMeta[]>;
+/**
+ * The run ids that still have a worktree on disk (#737). A run that failed or was stopped keeps
+ * its checkout so you can go look at what it was holding; this is how the dashboard knows which
+ * finished run has one to offer removing. Live runs are excluded — their worktree is in use.
+ */
+export declare function onRetainedWorktrees(projectId: string): Promise<string[]>;
+/**
+ * Where a session is working (#798): the checkout it has, its branch, whether it is holding
+ * uncommitted changes, and — once it is no longer live — what that checkout costs on disk.
+ *
+ * The dashboard could not answer "where is this session working". The git status bar reads the
+ * *project*, so a session's own branch was visible nowhere, and a worktree a run kept (#737) was
+ * a name in a list with no size and no way in.
+ *
+ * `own` separates a run with its own worktree from one that fell back to the main checkout (a
+ * project with no git repo): "uncommitted changes" means something different there, since that
+ * working tree is the user's, not the agent's.
+ */
+export declare function onRunWorktree(projectId: string, runId: string): Promise<RunWorktree | null>;
+/** One archived run's event log for replay (or `[]` when the run or project is gone). */
+export declare function onRun(projectId: string, runId: string): Promise<FrameworkEvent[]>;
+/** The surfaced PLAN/TODO docs at the workspace root, in sidebar order (or `[]`). */
+export declare function onDocs(projectId: string): Promise<WorkspaceDoc[]>;
+/** The project's `tickets/*.md`, by filename (#697). `[]` when the repo has no `tickets/` yet. */
+export declare function onTickets(projectId: string): Promise<WorkspaceTicket[]>;
+/** One ticket's full text, for its own detail page (#1144). Null when it does not exist. */
+export declare function onTicket(projectId: string, file: string): Promise<WorkspaceTicketDetail | null>;
+/** When `tickets/` last caught up with GitHub (#1208), or `{}` when nothing has recorded it. */
+export declare function onTicketsMeta(projectId: string): Promise<TicketsMeta>;
+/** Every registered project's tickets, one list per project (#1144): the cross-project Tickets page. */
+export declare function onAllTickets(): Promise<ProjectTickets[]>;
+/** The committed `.the-framework/LOGS.md` entries, newest-first (or `[]`). */
+export declare function onProjectLog(projectId: string): Promise<LogEntry[]>;
+/** The aggregated open TODO queue across every registered project (#438), most-open first. */
+export declare function onQueue(): Promise<ProjectQueue[]>;
+/** The cross-project Overview (#437): what is running now, the queue size, and recent projects. */
+export declare function onOverview(): Promise<Overview>;
+/** Recent sessions pooled across every project (#shared-shell), newest first, for the home rail. */
+export declare function onRecentRuns(): Promise<RecentRun[]>;
+/** Hot tickets across every project (#1112): being worked on, likely next, and queued. */
+export declare function onHotTickets(): Promise<HotTicket[]>;
+/** The cross-project interventions queue (#632, Queue #624): open PRs that need review, newest first. */
+export declare function onInterventions(): Promise<Intervention[]>;
+/** Every session's open question with its full gate (#1455), longest-waiting first: the launcher's hub. */
+export declare function onOpenQuestions(): Promise<OpenQuestion[]>;
+/** The cross-project "New activity" feed (#627): recent run started/finished transitions, newest first. */
+export declare function onActivity(): Promise<Activity[]>;
+/** The Overview dashboard page (#471): the {@link onOverview} rollup plus run counts, run-status totals, and activity. */
+export declare function onDashboard(): Promise<DashboardData>;
+/**
+ * The project's files for the `#` context picker (#504) and the panel tree (#492): every
+ * file git sees (tracked + untracked, honoring .gitignore), repo-relative and sorted, via
+ * `git ls-files`. Localhost-only by nature — the relay has no checkout, so it resolves `[]`.
+ * Pass a live `runId` to list that run's worktree instead of the project root (#738).
+ */
+export declare function onProjectFiles(projectId: string, runId?: string): Promise<string[]>;
+/**
+ * Per-file git status for the tree's dots (#492): repo-relative path -> untracked/modified/
+ * deleted, from `git status --porcelain`. `{}` when not a repo / on the relay (no checkout).
+ * Pass a live `runId` to see that run's own worktree rather than the project root (#738).
+ */
+export declare function onProjectFileStatus(projectId: string, runId?: string): Promise<Record<string, FileGitStatus>>;
+/**
+ * One changed file's diff, for the tree's hover card (#816). Null when the path is not a changed
+ * file, is unsafe (see `safeRepoPath`), or there is no checkout. Reads the run's own worktree when
+ * `runId` names one, so it shows the same change the tree dotted (#815).
+ *
+ * The status comes from the same `git status` the dots do, rather than from the caller: a client
+ * that thinks a file is untracked must not be able to make the server read it as one.
+ */
+export declare function onFileDiff(projectId: string, path: string, runId?: string): Promise<FileDiff | null>;
+/**
+ * What the session changed (#817): every changed file in its worktree with line counts, newest
+ * state each poll. `[]` when nothing changed or there is no checkout.
+ *
+ * Derived from the worktree rather than from the agent's tool calls on purpose. The driver
+ * surfaces a tool's name and not its arguments (#165) — we verify by outcome, not by watching
+ * which tool the agent reached for — so reading git is both the honest source and the one that
+ * works for every agent, not just the ones whose stream carries an edit payload.
+ */
+export declare function onRunChanges(projectId: string, runId?: string): Promise<FileChange[]>;
+/**
+ * One unchanged file's contents, for the tree's hover card (#828). Null when the path is unsafe
+ * (see `safeRepoPath`), outside the checkout, or unreadable. Reads the run's own worktree when
+ * `runId` names one, so it shows the copy the tree is listing (#815).
+ *
+ * The caller picks this or {@link onFileDiff} from the status the tree already holds; a changed
+ * file has a diff worth seeing, an unchanged one has only itself.
+ */
+export declare function onFileContent(projectId: string, path: string, runId?: string): Promise<FileContent | null>;
+/** The project's GitHub URL from its `origin` remote (#489), or null (no remote / not GitHub / relay). */
+export declare function onGithubUrl(projectId: string): Promise<string | null>;
+/**
+ * The project's git status (#491): active branch, dirty flag, linked PR. Null when not a repo /
+ * relay. Pass a live `runId` to read that run's worktree, which is the branch and the dirty
+ * state that actually belong to it (#738). A run-scoped read is since-filtered (#1255): a run on
+ * a reused pinned branch must not wear a predecessor's merged PR as its own badge.
+ */
+export declare function onGitStatus(projectId: string, runId?: string): Promise<GitStatus | null>;
+/**
+ * The end-of-session handoff (#799): the branch a finished session left its work on, what it
+ * committed, what it changed, and whether that has been pushed or opened as a PR.
+ *
+ * Read from the *project* checkout against the session's branch, not from the session's worktree.
+ * A clean run's worktree is removed when it finishes, and `resolveRunPath` then falls back to the
+ * project root — so a worktree-addressed read reports the project's own branch and the user's own
+ * uncommitted changes as though they were the session's. The branch is what outlives the run, so
+ * the branch is what this asks about.
+ */
+export declare function onRunHandoff(projectId: string, runId: string): Promise<RunHandoff | null>;
+/**
+ * The project's own `SYSTEM.md` text, or null when it has none (#872). The prompt preview
+ * claims to show the entire system prompt; composition takes this text as `opts.user`, but
+ * reading it is Node-bound, so the browser needs this read to keep that claim true.
+ */
+export declare function onSystemPromptUser(projectId: string): Promise<string | null>;
+/**
+ * The question a Claude web session is parked on, as reported by the browser bridge (#1237).
+ *
+ * Keyed by cloud session id rather than run id because that is what the bridge can see: it reads
+ * a claude.ai page, which knows its session and nothing about our runs. The run view already
+ * derives that id from the run's own `cloud <url>` event, so the join happens on the client
+ * without the daemon having to index runs by session.
+ *
+ * Returns null for anything unrecognised, so a run with no bridge, no question, or a target that
+ * is not `web` renders exactly as it did before.
+ */
+export declare function onBridgeQuestion(sessionId: string): Promise<BridgeQuestion | null>;
+/**
+ * Whether anything has reached the browser bridge, and how it went (#1237).
+ *
+ * A misconfigured extension and an uninstalled one both leave no question behind, so "nothing is
+ * showing" cannot be diagnosed from the questions alone. A refused request at least proves
+ * something is trying, and its status says which half is wrong.
+ */
+export declare function onBridgeStatus(): Promise<{
+    lastContact: BridgeContact | null;
+    questions: number;
+    page: BridgeHello | null;
+}>;
+/**
+ * The bridge token, for the setup step where a user pastes it into the extension (#1237).
+ *
+ * Only while the bridge is on, so a daemon with the feature off never hands the secret to a
+ * page. Revealing it here is not a new exposure: anyone who can load this dashboard can already
+ * start runs on this machine, and on a non-loopback bind their browser is holding the same token
+ * as a cookie. What it replaces is the alternative, which was telling people to open
+ * `~/.the-framework.json` and copy a field out of it.
+ */
+export declare function onBridgeToken(): Promise<string | null>;
+/**
+ * Where the answer picked for that session's question stands (#1237): queued for the
+ * extension, delivered, or failed with the extension's reason. Null when nothing was picked.
+ */
+export declare function onBridgeAnswer(sessionId: string): Promise<BridgeAnswer | null>;
+/** What a Claude web session has said so far, as scraped by the browser bridge (#1237). */
+export declare function onBridgeEvents(sessionId: string): Promise<BridgeEvent[]>;
+//# sourceMappingURL=reads.telefunc.d.ts.map

package/dist/dashboard-rpc/reads.telefunc.d.ts.map

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