@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/dashboard-rpc/preferences.d.ts

@@ -0,0 +1,41 @@
+import { type EditorInfo } from '../dashboard/open-in-app.js';
+import type { CustomPreset, Preferences } from '../registry.js';
+/** The outcome of a {@link savePreferences} write. */
+export type SavePreferencesResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** The user's stored dashboard preferences, or `{}` when the read fails. */
+export declare function onPreferences(): Promise<Preferences>;
+/** Persist the dashboard preferences (sanitized in the store). */
+export declare function savePreferences(preferences: Preferences): Promise<SavePreferencesResult>;
+/** The outcome of a patch write (#1148): the stored result, so the caller can adopt it. */
+export type PatchPreferencesResult<T> = {
+    ok: true;
+    preferences: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Merge the keys the caller changed into the stored preferences (#1148), and hand back what is
+ * now stored. The write half of the fix for a stale tab reverting settings it never touched:
+ * {@link savePreferences} replaces the whole block, so a client's snapshot overwrote whatever
+ * anyone else had changed since it loaded. Returning the merged result also lets the caller
+ * adopt the truth it just wrote against, so a tab converges instead of staying stale.
+ */
+export declare function patchPreferences(patch: Preferences): Promise<PatchPreferencesResult<Preferences>>;
+/**
+ * A project's shared custom presets (#1025), committed into its `.openagent/` so they travel
+ * with the repo — the team-shared counterpart to the user-tier {@link onPreferences} presets. Read
+ * from the project's own checkout, so this resolves the project id to its workspace path rather than
+ * touching the home registry. `[]` for an unknown project.
+ */
+export declare function onProjectPresets(projectId: string): Promise<CustomPreset[]>;
+/** Persist a project's shared custom presets into its `.openagent/` (#1025). */
+export declare function saveProjectPresets(projectId: string, presets: CustomPreset[]): Promise<SavePreferencesResult>;
+/** The editors installed on this server (#727), for the "Preferred editor" picker. */
+export declare function onEditors(): Promise<EditorInfo[]>;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/dashboard-rpc/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/preferences.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAQ/D,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E,4EAA4E;AAC5E,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAE1D;AAED,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAS9F;AAED,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAOvG;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAIjF;AAED,gFAAgF;AAChF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAShC;AAED,sFAAsF;AACtF,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAEvD"}

package/dist/dashboard-rpc/preferences.js

@@ -0,0 +1,65 @@
+import { contextPreferences, resolveProjectPath } from './context.js';
+import { detectEditors } from '../dashboard/open-in-app.js';
+import { readProjectPresets, writeProjectPresets } from '../project-presets.js';
+/** The user's stored dashboard preferences, or `{}` when the read fails. */
+export async function onPreferences() {
+    return contextPreferences().read().catch(() => ({}));
+}
+/** Persist the dashboard preferences (sanitized in the store). */
+export async function savePreferences(preferences) {
+    // A failed write returns the advertised typed error rather than rejecting the RPC, so the
+    // client renders it instead of losing the save to an exception it cannot read.
+    try {
+        await contextPreferences().save(preferences);
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/**
+ * Merge the keys the caller changed into the stored preferences (#1148), and hand back what is
+ * now stored. The write half of the fix for a stale tab reverting settings it never touched:
+ * {@link savePreferences} replaces the whole block, so a client's snapshot overwrote whatever
+ * anyone else had changed since it loaded. Returning the merged result also lets the caller
+ * adopt the truth it just wrote against, so a tab converges instead of staying stale.
+ */
+export async function patchPreferences(patch) {
+    // Typed error rather than a rejection, like `savePreferences` — one shape for every failure.
+    try {
+        return { ok: true, preferences: await contextPreferences().patch(patch) };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/**
+ * A project's shared custom presets (#1025), committed into its `.openagent/` so they travel
+ * with the repo — the team-shared counterpart to the user-tier {@link onPreferences} presets. Read
+ * from the project's own checkout, so this resolves the project id to its workspace path rather than
+ * touching the home registry. `[]` for an unknown project.
+ */
+export async function onProjectPresets(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return [];
+    return readProjectPresets(cwd).catch(() => []);
+}
+/** Persist a project's shared custom presets into its `.openagent/` (#1025). */
+export async function saveProjectPresets(projectId, presets) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return { ok: false, error: 'unknown project' };
+    try {
+        await writeProjectPresets(cwd, presets);
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, error: 'failed to save presets' };
+    }
+}
+/** The editors installed on this server (#727), for the "Preferred editor" picker. */
+export async function onEditors() {
+    return detectEditors().catch(() => []);
+}
+//# sourceMappingURL=preferences.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/dashboard-rpc/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,aAAa,EAAmB,MAAM,6BAA6B,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAY/E,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,kBAAkB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAwB;IAC5D,0FAA0F;IAC1F,+EAA+E;IAC/E,IAAI,CAAC;QACH,MAAM,kBAAkB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC5C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAA;IAC3D,CAAC;AACH,CAAC;AAKD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAkB;IACvD,6FAA6F;IAC7F,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAA;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IACtD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,OAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;IACxD,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAA;IACvD,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;AACxC,CAAC"}

package/dist/dashboard-rpc/projects.d.ts

@@ -0,0 +1,85 @@
+import { type ProjectCommand } from '../project-commands.js';
+import { type BranchReach } from '@openagt/agent-data';
+import { type StartReadiness } from '../project-hooks.js';
+import { type PickDirectoryResult } from '../pick-directory.js';
+import type { ProjectSummary } from '../dashboard/projects.js';
+import type { AddProjectResult, OnboardingSuggestion, RemoveProjectResult } from '../dashboard/types.js';
+export declare function onProjects(): Promise<ProjectSummary[]>;
+/**
+ * Add a project from the dashboard (#396/#433): install the repo and register it so it joins the
+ * Projects list. Like `sendStart` this needs the daemon (it spawns git + writes the shared
+ * registry), so it calls the daemon's own `addProject` closure off the wired dashboard context.
+ * Returns the daemon's {@link AddProjectResult}.
+ *
+ * `share` is the person's answer, asked before the add: whether the agents' records may go to the
+ * repository's remote. Nothing is pushed for a project added with `false`.
+ */
+export declare function sendAddProject(path: string, share: boolean): Promise<AddProjectResult>;
+/**
+ * Remove a project from the dashboard: it leaves the Projects list. Nothing in its folder is
+ * deleted unless `files` is true: then what OpenAgent left there is removed too, and the answer
+ * says what went and what stayed. Like `sendAddProject` this is the daemon's to do (it runs the project's close hooks and
+ * writes the shared registry), so it calls the daemon's own closure off the wired dashboard context.
+ * Addressed by id and not by path, so a project whose folder is gone can still be removed.
+ */
+export declare function sendRemoveProject(projectId: string, files: boolean): Promise<RemoveProjectResult>;
+/** How far the project's records reach right now, read off its repository; `null` when the project is unknown here. */
+export declare function onRecordsReach(projectId: string): Promise<BranchReach | null>;
+/**
+ * The person's switch: share the project's records with its remote, or keep them on this machine.
+ * Turning it on sends what is there now, so a remote that refuses is said at once, and the switch
+ * goes back to off: the records stay where they were. A project with no remote has nothing to
+ * share with, and is refused.
+ */
+export declare function sendShareRecords(projectId: string, on: boolean): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Open the OS folder picker on the daemon's machine and wait for the user's choice (#1150). The
+ * browser cannot learn an absolute path from any picker of its own, and the daemon — which runs on
+ * the machine the user is sitting at — can, so the dialog is the daemon's. A dismissed dialog
+ * comes back as `path: null`.
+ */
+export declare function sendPickProjectDirectory(): Promise<PickDirectoryResult>;
+/**
+ * The Onboarding checklist's one server-side fact (#958): the directory this server runs in,
+ * so the first step can offer "Add {cwd} as project" without the user typing a path.
+ */
+export declare function onOnboarding(): Promise<OnboardingSuggestion>;
+/** What the launcher offers for a project: its commands, and whether a run can be started here at all. */
+export interface ProjectLauncher {
+    commands: ProjectCommand[];
+    /** Whether the project's `.openagent/hooks.yml` has a `start` line; without one Start is off. */
+    startHook: boolean;
+    /** Whether one of the project's packages provides a git host; without one no pull request can be opened, so the publish menu stops at the branch. */
+    gitHost: boolean;
+    /** Whether the project's repository has an `origin` remote; without one nothing can be published, so the publish menu stops at the commit. */
+    remote: boolean;
+    /**
+     * The two branches an agent can start from here, for the launcher's "start from" chip: `main`,
+     * the name of origin's default branch, and `local`, the branch the project's folder is on now.
+     * Absent where the pick could not be obeyed or has nothing to pick between: the start line does
+     * not pass `BASE` on, the repository has no remote, or the folder is on no branch.
+     */
+    startFrom?: {
+        main: string;
+        local: string;
+    };
+}
+/**
+ * The project's commands (#1774), read off its skills folders, whether it has a start hook, whether
+ * it has a git host, and the branches an agent can start from. `null` when the project is unknown here.
+ */
+export declare function onCommands(projectId: string): Promise<ProjectLauncher | null>;
+/**
+ * What would stop a run in this project before it spends a checkout, said in the launcher before
+ * the Start: the project's `check` hook, given the coding agent picked. A missing CLI or a
+ * logged-out one is a problem the run itself would refuse on; a warning is said and blocks nothing.
+ * A check line that fails is said as a warning: it is a broken check, not a reason to stop.
+ * `null` for an unknown project or one without a check hook: nothing to say.
+ */
+export declare function onStartCheck(projectId: string, driver?: string): Promise<StartReadiness | null>;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAA+E,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACnI,OAAO,EAAsD,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAI7G,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAYxG,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAM5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAM5F;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAIvG;AAED,uHAAuH;AACvH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAGnF;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAU3H;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAIlE;AAED,0GAA0G;AAC1G,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,iGAAiG;IACjG,SAAS,EAAE,OAAO,CAAA;IAClB,qJAAqJ;IACrJ,OAAO,EAAE,OAAO,CAAA;IAChB,8IAA8I;IAC9I,MAAM,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5C;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOnF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMrG"}

package/dist/dashboard-rpc/projects.js

@@ -0,0 +1,129 @@
+import { contextAddProject, contextProjectErrors, contextProjects, contextRemoveProject, resolveProjectPath } from './context.js';
+import { readProjectCommands } from '../project-commands.js';
+import { DATA_BRANCH, branchReach, originDefaultBranch, pullFileBranch, writeSharing } from '@openagt/agent-data';
+import { readProjectHooks, runCheckHook, startLineTakesBase } from '../project-hooks.js';
+import { hasRemote } from '../has-remote.js';
+import { currentBranch } from '../dashboard/git-status.js';
+import { pickDirectory } from '../pick-directory.js';
+import { projectGitHost } from '../store/git-host.js';
+// The Projects sidebar behind the new dashboard (#405): the global registry (#390) the
+// daemon and CLI write — id, path, name, activated, last activity. The per-agent
+// foreground dashboard (#427) scopes this to a single project via the request context.
+// The live event stream is its own endpoint rather than a call (`GET /_rpc/events`).
+//
+// Each project also carries what the daemon's background jobs found wrong with it (#1500) —
+// a data branch that cannot reach origin, say (#1599) — and why its data stays on this machine, if it does.
+// Both ride this list rather than a read of their own because the list is what every project
+// surface already polls, so an error reaches the sidebar dot and the project's banner with
+// nothing new to subscribe to.
+export async function onProjects() {
+    const state = contextProjectErrors();
+    return (await contextProjects().list()).map(project => {
+        const { errors, local } = state(project.path);
+        return { ...project, ...(errors.length > 0 ? { errors } : {}), ...(local ? { local } : {}) };
+    });
+}
+/**
+ * Add a project from the dashboard (#396/#433): install the repo and register it so it joins the
+ * Projects list. Like `sendStart` this needs the daemon (it spawns git + writes the shared
+ * registry), so it calls the daemon's own `addProject` closure off the wired dashboard context.
+ * Returns the daemon's {@link AddProjectResult}.
+ *
+ * `share` is the person's answer, asked before the add: whether the agents' records may go to the
+ * repository's remote. Nothing is pushed for a project added with `false`.
+ */
+export async function sendAddProject(path, share) {
+    // Throws on an unwired context (D3), like `sendStart`: a missing capability is a wiring bug.
+    const addProject = contextAddProject();
+    const trimmed = path.trim();
+    if (!trimmed)
+        return { ok: false, error: 'a project path is required' };
+    return addProject(trimmed, share === true);
+}
+/**
+ * Remove a project from the dashboard: it leaves the Projects list. Nothing in its folder is
+ * deleted unless `files` is true: then what OpenAgent left there is removed too, and the answer
+ * says what went and what stayed. Like `sendAddProject` this is the daemon's to do (it runs the project's close hooks and
+ * writes the shared registry), so it calls the daemon's own closure off the wired dashboard context.
+ * Addressed by id and not by path, so a project whose folder is gone can still be removed.
+ */
+export async function sendRemoveProject(projectId, files) {
+    const removeProject = contextRemoveProject();
+    if (typeof projectId !== 'string' || !projectId)
+        return { ok: false, error: 'a project id is required' };
+    return removeProject(projectId, files === true);
+}
+/** How far the project's records reach right now, read off its repository; `null` when the project is unknown here. */
+export async function onRecordsReach(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    return cwd ? branchReach(cwd) : null;
+}
+/**
+ * The person's switch: share the project's records with its remote, or keep them on this machine.
+ * Turning it on sends what is there now, so a remote that refuses is said at once, and the switch
+ * goes back to off: the records stay where they were. A project with no remote has nothing to
+ * share with, and is refused.
+ */
+export async function sendShareRecords(projectId, on) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return { ok: false, error: 'this project has no local path on this server' };
+    if (on && !(await hasRemote(cwd)))
+        return { ok: false, error: 'this project has no remote to share with' };
+    await writeSharing(cwd, on);
+    if (!on)
+        return { ok: true };
+    const sent = await pullFileBranch(cwd, DATA_BRANCH, { log: () => { } });
+    if (sent.ok)
+        return { ok: true };
+    await writeSharing(cwd, false);
+    return { ok: false, error: sent.error };
+}
+/**
+ * Open the OS folder picker on the daemon's machine and wait for the user's choice (#1150). The
+ * browser cannot learn an absolute path from any picker of its own, and the daemon — which runs on
+ * the machine the user is sitting at — can, so the dialog is the daemon's. A dismissed dialog
+ * comes back as `path: null`.
+ */
+export async function sendPickProjectDirectory() {
+    return pickDirectory();
+}
+/**
+ * The Onboarding checklist's one server-side fact (#958): the directory this server runs in,
+ * so the first step can offer "Add {cwd} as project" without the user typing a path.
+ */
+export async function onOnboarding() {
+    const cwd = process.cwd();
+    const registered = await contextProjects().list();
+    return { cwd, cwdProjectId: registered.find(p => p.path === cwd)?.id ?? null };
+}
+/**
+ * The project's commands (#1774), read off its skills folders, whether it has a start hook, whether
+ * it has a git host, and the branches an agent can start from. `null` when the project is unknown here.
+ */
+export async function onCommands(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return null;
+    const [commands, hooks, gitHost, remote, main, local] = await Promise.all([readProjectCommands(cwd), readProjectHooks(cwd), projectGitHost(cwd).catch(() => undefined), hasRemote(cwd), originDefaultBranch(cwd), currentBranch(cwd)]);
+    // Both read locally, never fetched. `HEAD` is a folder on no branch: there is no local branch to start from.
+    const startFrom = hooks.start !== undefined && startLineTakesBase(hooks.start) && remote && main !== undefined && local !== undefined && local !== 'HEAD' ? { main: main.slice('origin/'.length), local } : undefined;
+    return { commands, startHook: hooks.start !== undefined, gitHost: gitHost !== undefined, remote, ...(startFrom ? { startFrom } : {}) };
+}
+/**
+ * What would stop a run in this project before it spends a checkout, said in the launcher before
+ * the Start: the project's `check` hook, given the coding agent picked. A missing CLI or a
+ * logged-out one is a problem the run itself would refuse on; a warning is said and blocks nothing.
+ * A check line that fails is said as a warning: it is a broken check, not a reason to stop.
+ * `null` for an unknown project or one without a check hook: nothing to say.
+ */
+export async function onStartCheck(projectId, driver) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return null;
+    const checked = await runCheckHook(cwd, driver !== undefined ? { driver } : {});
+    if (checked.ok)
+        return { problems: checked.problems, warnings: checked.warnings };
+    return checked.noHook ? null : { problems: [], warnings: [checked.error] };
+}
+//# sourceMappingURL=projects.js.map

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

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

package/dist/dashboard-rpc/quota.d.ts

@@ -0,0 +1,4 @@
+import type { QuotaView } from '../dashboard/quota.js';
+/** Where the account's quota stands against its boundary. */
+export declare function onQuota(): Promise<QuotaView>;
+//# sourceMappingURL=quota.d.ts.map

package/dist/dashboard-rpc/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/quota.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAatD,6DAA6D;AAC7D,wBAAsB,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAElD"}

package/dist/dashboard-rpc/quota.js

@@ -0,0 +1,15 @@
+import { contextQuota } from './context.js';
+// The usage panel's surface (#533): where the account's subscription quota stands, and where the
+// quota boundary (#879) sits. The source is wired into the dashboard context by the daemon, and the panel polls it for its
+// whole life.
+/** An honest empty view: no reading, and so no boundary to measure against. */
+function noReading() {
+    // No windows and no boundary rather than zeroes: an empty bar reads as
+    // "nothing used", which is the one thing this panel must never imply.
+    return { windows: [], unavailable: 'fetch-failed' };
+}
+/** Where the account's quota stands against its boundary. */
+export async function onQuota() {
+    return contextQuota().read().catch(() => noReading());
+}
+//# sourceMappingURL=quota.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../../src/dashboard-rpc/quota.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,iGAAiG;AACjG,2HAA2H;AAC3H,cAAc;AAEd,+EAA+E;AAC/E,SAAS,SAAS;IAChB,uEAAuE;IACvE,sEAAsE;IACtE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,CAAA;AACrD,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,OAAO,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAA;AACvD,CAAC"}

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

@@ -0,0 +1,185 @@
+import type { BridgeBrowserStatus } from '../bridge-browser.js';
+import { type AgentMeta } from '../store/index.js';
+import { type GitHostHome } from '../store/git-host.js';
+import { type RepositoryOffer } from '../store/repository.js';
+import { type WorkspaceDoc } from '../dashboard/docs.js';
+import { type ProjectQueue } from '../dashboard/queue.js';
+import { type Overview, type RecentAgent } from '../dashboard/overview.js';
+import { type Intervention } from '../dashboard/interventions.js';
+import type { ProjectionRead } from '../dashboard/projects.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 AgentHandoff } from '../dashboard/agent-handoff.js';
+import type { AgentWorktree } from '../dashboard/types.js';
+import type { OpenAgentEvent } from '../events.js';
+import type { BridgeEvent, BridgeHello, BridgeQuestion } from '../dashboard/bridge-endpoints.js';
+import type { BridgeAnswer, BridgeContact, BridgeVersion } from '../dashboard/bridge-store.js';
+/**
+ * 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 declare function onAgents(projectId: string): Promise<AgentMeta[]>;
+/**
+ * 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 declare function markCloudWaiting(agent: AgentMeta): AgentMeta;
+/**
+ * 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 declare function markOtherHost(agent: AgentMeta, thisHost?: string): AgentMeta;
+/**
+ * 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 declare function markSaving(agent: AgentMeta, thisHost?: string, alive?: (pid: number) => boolean): AgentMeta;
+/**
+ * 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 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 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 declare function onAgentWorktree(projectId: string, agentId: string): Promise<AgentWorktree | null>;
+/** One archived agent's event log for replay (or `[]` when the agent or project is gone). */
+export declare function onAgent(projectId: string, agentId: string): Promise<OpenAgentEvent[]>;
+/** What each of the named runs of a project is doing now, by id; a run that is not working has no entry. */
+export declare function onAgentsDoing(projectId: string, agentIds: string[]): Promise<Record<string, string>>;
+/** The surfaced PLAN/TODO docs at the workspace root, in sidebar order (or `[]`). */
+export declare function onDocs(projectId: string): Promise<WorkspaceDoc[]>;
+/** 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 onRecentAgents(): Promise<RecentAgent[]>;
+/**
+ * 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 declare function onInterventions(): Promise<ProjectionRead<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, with the projects that were read whole beside them (#1625) — see {@link onInterventions}.
+ */
+export declare function onActivity(): Promise<ProjectionRead<Activity>>;
+/** The Overview dashboard page (#471): the {@link onOverview} rollup plus agent counts, run-status totals, and activity. */
+export declare function onDashboard(): Promise<DashboardData>;
+/**
+ * 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 declare function onProjectFiles(projectId: string, agentId?: string): Promise<string[]>;
+/** 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 declare function onGitHostHome(projectId: string): Promise<GitHostHome | 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 declare function onRepositoryOffer(projectId: string): Promise<RepositoryOffer | 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 declare function onGitStatus(projectId: string, agentId?: 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 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 declare function onAgentHandoff(projectId: string, agentId: string): Promise<AgentHandoff | 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 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;
+    version: BridgeVersion | 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
+ * `~/.openagent.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[]>;
+/** Where the daemon's own bridge browser stands (#1332): off, starting (and on which step), running, or stopped and why. */
+export declare function onBridgeBrowser(): Promise<BridgeBrowserStatus>;
+//# sourceMappingURL=reads.d.ts.map

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

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