@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/project-commands.js

@@ -0,0 +1,57 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * A project's commands (#1774): the skills written to be run by a person, read off the folders
+ * the coding agents read them from. OpenAgent ships no prompt text; what a project can be
+ * asked to do is what its own command skills say. A skill that teaches the agent how to do
+ * something (the tickets, the queue) is not a command: typed alone it starts an agent with
+ * nothing to do, so the launcher does not list it.
+ */
+/** Where coding agents read a project's skills: Claude Code's folder, and the shared one Codex reads. */
+export const SKILLS_DIRS = ['.claude/skills', '.agents/skills'];
+/**
+ * The project's commands, by name: the skills whose front matter says
+ * `disable-model-invocation: true`, written to be run by a person or a runner and never picked
+ * up by the agent on its own. A skill in both folders is listed once. A folder without a
+ * readable `SKILL.md` is skipped, and a project with no skills folder has no commands.
+ */
+export async function readProjectCommands(cwd) {
+    const commands = new Map();
+    // A skill's first readable copy decides, as with the coding agent: a later folder's copy of a
+    // skill already read is not looked at, command or not.
+    const read = new Set();
+    for (const dir of SKILLS_DIRS) {
+        const entries = await readdir(join(cwd, dir), { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            if (read.has(entry.name) || !/^[a-z0-9][a-z0-9-]*$/.test(entry.name))
+                continue;
+            const raw = await readFile(join(cwd, dir, entry.name, 'SKILL.md'), 'utf8').catch(() => undefined);
+            if (raw === undefined)
+                continue;
+            read.add(entry.name);
+            const front = frontMatter(raw);
+            if (front['disable-model-invocation'] !== true)
+                continue;
+            commands.set(entry.name, {
+                name: entry.name,
+                ...(typeof front['description'] === 'string' && front['description'].trim() ? { description: front['description'].trim() } : {}),
+            });
+        }
+    }
+    return [...commands.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/** The YAML front matter of a markdown file as a map; none, or one that does not parse, is empty. */
+function frontMatter(raw) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(raw);
+    if (!match)
+        return {};
+    try {
+        const data = parseYaml(match[1]);
+        return data && typeof data === 'object' && !Array.isArray(data) ? data : {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=project-commands.js.map

package/dist/project-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-commands.js","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AAEzC;;;;;;GAMG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAUxE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAClD,8FAA8F;IAC9F,uDAAuD;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAC9E,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACjG,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAQ;YAC/B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACpB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,KAAK,CAAC,0BAA0B,CAAC,KAAK,IAAI;gBAAE,SAAQ;YACxD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjI,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,qGAAqG;AACrG,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,SAAS,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QAC1C,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/project-errors.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The daemon's per-project error state (#1500): a background job that finds a project in a state
+ * the user has to fix — and can only fix if told — records it here, and clears it the moment the
+ * state is good again. The dashboard renders what is recorded; nothing else reads it.
+ *
+ * The first emitter is the data-branch sync (#1599): a push origin rejects used to be a console
+ * line on the daemon's stdout and nothing else, which is the worst way to handle a state nobody
+ * can see.
+ *
+ * A project whose data stays on this machine is not an error: a folder with no origin, or one the
+ * person does not share, is a normal project. The sync records why as `local`, a note the
+ * dashboard says quietly.
+ *
+ * In memory on purpose. Every emitter re-evaluates on its own cadence — the sync every minute —
+ * so a restarted daemon re-learns each error within a tick, and there is no stale record to
+ * outlive the condition that raised it.
+ */
+import type { BranchReach } from '@openagt/agent-data';
+/**
+ * What went wrong, by kind: the dashboard picks its wording from this, the message carries the
+ * detail. `data-sync`: the data branch cannot converge with the remote. `provider`: which package
+ * provides a kind of the project's data is unsettled (#1820): several declare it and the project's
+ * package.json names none, or names one that does not.
+ */
+export type ProjectErrorCode = 'data-sync' | 'provider';
+export interface ProjectError {
+    code: ProjectErrorCode;
+    /** The detail — what the failing command said, in the words the user would see running it by hand. */
+    message: string;
+    /** ISO timestamp of when the error was first recorded; a re-report of the same code keeps it. */
+    since: string;
+}
+/** Why a project's data stays on this machine: its repository has no origin, or the person keeps it here. */
+export type StaysLocal = Exclude<BranchReach, 'origin'>;
+/** The daemon's write side: one slot per (project, code). */
+export interface ProjectErrors {
+    /**
+     * Record the error. A second report of the same code on the same project refreshes the message
+     * and keeps `since`, so a banner says how long this has been going on rather than resetting
+     * every minute.
+     */
+    set(projectPath: string, code: ProjectErrorCode, message: string): void;
+    /** The condition is gone; a clear of something never set is a no-op. */
+    clear(projectPath: string, code: ProjectErrorCode): void;
+    /** The project's current errors, oldest first. */
+    list(projectPath: string): ProjectError[];
+    /** How far the project's data reaches, as the last sync found it. */
+    setReach(projectPath: string, reach: BranchReach): void;
+    /** What the dashboard shows of the project: its errors, and why its data stays local, if it does. */
+    read(projectPath: string): ProjectState;
+}
+/** What the background jobs currently know of a project: what is wrong with it, and why its data stays on this machine, if it does. */
+export interface ProjectState {
+    errors: ProjectError[];
+    local?: StaysLocal;
+}
+/** The dashboard's read side, wired into its context. */
+export type ProjectErrorsReader = ProjectErrors['read'];
+export declare function projectErrorStore(now?: () => Date): ProjectErrors;
+//# sourceMappingURL=project-errors.d.ts.map

package/dist/project-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-errors.d.ts","sourceRoot":"","sources":["../src/project-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,CAAA;AAEvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAA;IACtB,sGAAsG;IACtG,OAAO,EAAE,MAAM,CAAA;IACf,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6GAA6G;AAC7G,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAEvD,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACvE,wEAAwE;IACxE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACxD,kDAAkD;IAClD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;IACzC,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACvD,qGAAqG;IACrG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAAA;CACxC;AAED,uIAAuI;AACvI,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;AAEvD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,IAAuB,GAAG,aAAa,CA2BnF"}

package/dist/project-errors.js

@@ -0,0 +1,51 @@
+/**
+ * The daemon's per-project error state (#1500): a background job that finds a project in a state
+ * the user has to fix — and can only fix if told — records it here, and clears it the moment the
+ * state is good again. The dashboard renders what is recorded; nothing else reads it.
+ *
+ * The first emitter is the data-branch sync (#1599): a push origin rejects used to be a console
+ * line on the daemon's stdout and nothing else, which is the worst way to handle a state nobody
+ * can see.
+ *
+ * A project whose data stays on this machine is not an error: a folder with no origin, or one the
+ * person does not share, is a normal project. The sync records why as `local`, a note the
+ * dashboard says quietly.
+ *
+ * In memory on purpose. Every emitter re-evaluates on its own cadence — the sync every minute —
+ * so a restarted daemon re-learns each error within a tick, and there is no stale record to
+ * outlive the condition that raised it.
+ */
+export function projectErrorStore(now = () => new Date()) {
+    const byProject = new Map();
+    const local = new Map();
+    const list = (projectPath) => [...(byProject.get(projectPath)?.values() ?? [])].sort((a, b) => a.since.localeCompare(b.since));
+    return {
+        set(projectPath, code, message) {
+            let errors = byProject.get(projectPath);
+            if (!errors)
+                byProject.set(projectPath, (errors = new Map()));
+            const since = errors.get(code)?.since ?? now().toISOString();
+            errors.set(code, { code, message, since });
+        },
+        clear(projectPath, code) {
+            const errors = byProject.get(projectPath);
+            if (!errors)
+                return;
+            errors.delete(code);
+            if (errors.size === 0)
+                byProject.delete(projectPath);
+        },
+        list,
+        setReach(projectPath, reach) {
+            if (reach === 'origin')
+                local.delete(projectPath);
+            else
+                local.set(projectPath, reach);
+        },
+        read(projectPath) {
+            const why = local.get(projectPath);
+            return { errors: list(projectPath), ...(why ? { local: why } : {}) };
+        },
+    };
+}
+//# sourceMappingURL=project-errors.js.map

package/dist/project-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-errors.js","sourceRoot":"","sources":["../src/project-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAkDH,MAAM,UAAU,iBAAiB,CAAC,GAAG,GAAe,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;IAClE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+C,CAAA;IACxE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;IAC3C,MAAM,IAAI,GAAG,CAAC,WAAmB,EAAkB,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IACtJ,OAAO;QACL,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO;YAC5B,IAAI,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YACvC,IAAI,CAAC,MAAM;gBAAE,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAA;YAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;YAC5D,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5C,CAAC;QACD,KAAK,CAAC,WAAW,EAAE,IAAI;YACrB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YACzC,IAAI,CAAC,MAAM;gBAAE,OAAM;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACnB,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;gBAAE,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QACtD,CAAC;QACD,IAAI;QACJ,QAAQ,CAAC,WAAW,EAAE,KAAK;YACzB,IAAI,KAAK,KAAK,QAAQ;gBAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;;gBAC5C,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QACpC,CAAC;QACD,IAAI,CAAC,WAAW;YACd,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YAClC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;QACtE,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/project-hooks.d.ts

@@ -0,0 +1,130 @@
+/**
+ * A project's hooks (#1774): the shell lines a project's own `.openagent/hooks.yml` names to
+ * run when the dashboard opens and when it closes, the two lines that start a run and continue
+ * one, and the line that says whether a run can start here at all. The daemon calls no tool by
+ * name: it runs whatever the file says, in the project, with the project's installed tools and
+ * then the built-in packages' on the PATH, so a line reaches its tool with nothing fetched from npm. Per
+ * user, since `.openagent/` is ignored: a hook is this machine's, and a teammate's pull
+ * changes nothing.
+ *
+ * Optional, best-effort and bounded: no file means nothing runs, a broken file is a warning, an
+ * `open` or `close` line that fails or hangs is logged and the next line still runs, and nothing
+ * here ever throws to the daemon.
+ */
+/** The hooks file, under the project's ignored `.openagent/`. */
+export declare const PROJECT_HOOKS_FILE = ".openagent/hooks.yml";
+/** How long one line may run before it is killed and logged as timed out. */
+export declare const HOOK_TIMEOUT_MS = 60000;
+/** When a project's hooks run: `open` when the dashboard starts (and when the project is added while it runs), `close` when it stops. */
+export type HookKind = 'open' | 'close';
+/**
+ * The two lines a person's click runs to start or continue a run: `start` begins a run from a
+ * prompt, `resume` continues an ended one with a text or an answer. One line each, since each
+ * answers one document on stdout.
+ */
+export type RunHookKind = 'start' | 'resume';
+export interface ProjectHooks {
+    open: string[];
+    close: string[];
+    start?: string;
+    resume?: string;
+    check?: string;
+}
+/**
+ * Read a project's hooks. A missing file is no hooks. A file that cannot be parsed or has the
+ * wrong shape is reported through `onWarn`, prefixed "ignoring", and counts as no hooks.
+ */
+export declare function readProjectHooks(cwd: string, onWarn?: (message: string) => void): Promise<ProjectHooks>;
+/**
+ * Parse the hooks file: a YAML map whose keys are `open` and `close`, each a list of shell lines,
+ * and `start`, `resume` and `check`, each one shell line. An empty document is no hooks. Anything else throws, so the reader can warn: a wrong key is
+ * refused rather than ignored, because a misspelled `open` would otherwise be a hook that
+ * silently never runs.
+ */
+export declare function parseProjectHooks(raw: string, source?: string): ProjectHooks;
+export interface RunHooksOptions {
+    /** Where each line's outcome and the tool's stderr go; default nowhere. */
+    log?: (line: string) => void;
+    /** How long one line may run; default {@link HOOK_TIMEOUT_MS}. */
+    timeoutMs?: number;
+    /** The environment the lines run with; default the daemon's own. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Run a project's `open` or `close` lines, in order, each through `sh -c` with the project's
+ * root as working directory. A line that exits non-zero, times out or cannot start is logged and
+ * the next line still runs; the lines' stderr is logged too, since a tool's one line for a person
+ * goes there. Never throws.
+ */
+export declare function runProjectHooks(cwd: string, kind: HookKind, opts?: RunHooksOptions): Promise<void>;
+/** What a `start` line is given: the prompt, the coding agent, model, publish level and branch to start from when the person picked them, and the follow-up when there is one. */
+export interface StartHookInput {
+    prompt: string;
+    driver?: string;
+    model?: string;
+    /** A fresh agent's prompt once the run ends done with a pull request; the merge waits for it. */
+    then?: string;
+    /** How far the run takes its work when its agent finishes: `commit`, `branch`, `pr` or `merge`. */
+    publish?: string;
+    /** The branch the run's own branch starts from; origin's default branch when absent. */
+    base?: string;
+}
+/**
+ * Whether a `start` line passes the branch to start from on: it mentions `$BASE` or `${BASE`. A
+ * line is written once and kept, so one written before the pick existed, or a person's own, may
+ * not; the launcher then offers no pick, rather than one the line would drop.
+ */
+export declare function startLineTakesBase(line: string): boolean;
+/** What a `resume` line is given: the run, and the person's text or their answer to the question it ended on. */
+export type ResumeHookInput = {
+    runId: string;
+} & ({
+    text: string;
+} | {
+    answer: string;
+});
+export type RunHookResult = {
+    ok: true;
+    id: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Run the project's `start` line: the prompt in `PROMPT`, the picks in `DRIVER`, `MODEL`,
+ * `PUBLISH` and `BASE` when made, the follow-up in `THEN` when there is one. The line answers one JSON
+ * document on stdout whose `id` names the run it started.
+ */
+export declare function runStartHook(cwd: string, input: StartHookInput, opts?: Omit<RunHooksOptions, 'log'>): Promise<RunHookResult>;
+/**
+ * Run the project's `resume` line: the run in `RUN_ID`, and the person's words in `TEXT` or their
+ * answer in `ANSWER`. The line answers like a `start` line, naming the run it continued.
+ */
+export declare function runResumeHook(cwd: string, input: ResumeHookInput, opts?: Omit<RunHooksOptions, 'log'>): Promise<RunHookResult>;
+/** What stands in the way of a run: problems stop it, warnings do not. One line each, each naming its fix. */
+export interface StartReadiness {
+    problems: string[];
+    warnings: string[];
+}
+/** How a `check` line went; `noHook` when the project's file names no such line. */
+export type CheckHookResult = ({
+    ok: true;
+} & StartReadiness) | {
+    ok: false;
+    error: string;
+    noHook?: true;
+};
+/**
+ * Run the project's `check` line: the coding agent the person picked in `DRIVER`, when picked.
+ * The line answers one JSON document on stdout with `problems` and `warnings`, lists of lines.
+ */
+export declare function runCheckHook(cwd: string, input: {
+    driver?: string;
+}, opts?: Omit<RunHooksOptions, 'log'>): Promise<CheckHookResult>;
+/**
+ * The environment a line runs with: the PATH led by the project's installed tools, then the
+ * built-in packages' own commands, so a tool named in a line is the project's copy when it
+ * installed one and the dashboard's otherwise, and never a package fetched by name.
+ */
+export declare function hookEnv(cwd: string, env: NodeJS.ProcessEnv): Promise<NodeJS.ProcessEnv>;
+//# sourceMappingURL=project-hooks.d.ts.map

package/dist/project-hooks.d.ts.map

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

package/dist/project-hooks.js

@@ -0,0 +1,232 @@
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { basename, delimiter, join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { builtInBinDirs } from './built-in.js';
+import { errorMessage } from './error-message.js';
+import { OPENAGENT_DIR } from './openagent-dir.js';
+/**
+ * A project's hooks (#1774): the shell lines a project's own `.openagent/hooks.yml` names to
+ * run when the dashboard opens and when it closes, the two lines that start a run and continue
+ * one, and the line that says whether a run can start here at all. The daemon calls no tool by
+ * name: it runs whatever the file says, in the project, with the project's installed tools and
+ * then the built-in packages' on the PATH, so a line reaches its tool with nothing fetched from npm. Per
+ * user, since `.openagent/` is ignored: a hook is this machine's, and a teammate's pull
+ * changes nothing.
+ *
+ * Optional, best-effort and bounded: no file means nothing runs, a broken file is a warning, an
+ * `open` or `close` line that fails or hangs is logged and the next line still runs, and nothing
+ * here ever throws to the daemon.
+ */
+/** The hooks file, under the project's ignored `.openagent/`. */
+export const PROJECT_HOOKS_FILE = `${OPENAGENT_DIR}/hooks.yml`;
+/** How long one line may run before it is killed and logged as timed out. */
+export const HOOK_TIMEOUT_MS = 60_000;
+const HOOK_KINDS = ['open', 'close'];
+const ONE_LINE_HOOK_KINDS = ['start', 'resume', 'check'];
+/**
+ * Read a project's hooks. A missing file is no hooks. A file that cannot be parsed or has the
+ * wrong shape is reported through `onWarn`, prefixed "ignoring", and counts as no hooks.
+ */
+export async function readProjectHooks(cwd, onWarn) {
+    let raw;
+    try {
+        raw = await readFile(join(cwd, PROJECT_HOOKS_FILE), 'utf8');
+    }
+    catch {
+        return { open: [], close: [] };
+    }
+    try {
+        return parseProjectHooks(raw);
+    }
+    catch (err) {
+        onWarn?.(`ignoring ${errorMessage(err)}`);
+        return { open: [], close: [] };
+    }
+}
+/**
+ * Parse the hooks file: a YAML map whose keys are `open` and `close`, each a list of shell lines,
+ * and `start`, `resume` and `check`, each one shell line. An empty document is no hooks. Anything else throws, so the reader can warn: a wrong key is
+ * refused rather than ignored, because a misspelled `open` would otherwise be a hook that
+ * silently never runs.
+ */
+export function parseProjectHooks(raw, source = PROJECT_HOOKS_FILE) {
+    let data;
+    try {
+        data = parseYaml(raw);
+    }
+    catch (err) {
+        // The parser's message runs to several lines with a caret drawing; the first line says what is wrong.
+        throw new Error(`${source}: ${errorMessage(err).split('\n')[0]}`);
+    }
+    const hooks = { open: [], close: [] };
+    if (data == null)
+        return hooks;
+    if (typeof data !== 'object' || Array.isArray(data))
+        throw new Error(`${source} must be a YAML map; the keys are open, close, start, resume and check`);
+    for (const [key, value] of Object.entries(data)) {
+        const isOneLine = ONE_LINE_HOOK_KINDS.includes(key);
+        if (!isOneLine && !HOOK_KINDS.includes(key))
+            throw new Error(`${source}: unknown key "${key}"; the keys are open, close, start, resume and check`);
+        if (value == null)
+            continue;
+        if (isOneLine) {
+            if (typeof value !== 'string' || value.trim() === '')
+                throw new Error(`${source}: "${key}" must be one shell line`);
+            hooks[key] = value.trim();
+            continue;
+        }
+        if (!Array.isArray(value) || !value.every(line => typeof line === 'string' && line.trim() !== '')) {
+            throw new Error(`${source}: "${key}" must be a list of shell lines`);
+        }
+        hooks[key] = value.map(line => line.trim());
+    }
+    return hooks;
+}
+/**
+ * Run a project's `open` or `close` lines, in order, each through `sh -c` with the project's
+ * root as working directory. A line that exits non-zero, times out or cannot start is logged and
+ * the next line still runs; the lines' stderr is logged too, since a tool's one line for a person
+ * goes there. Never throws.
+ */
+export async function runProjectHooks(cwd, kind, opts = {}) {
+    const log = opts.log ?? (() => { });
+    const hooks = await readProjectHooks(cwd, message => log(`[openagent] ${kind} hook (${basename(cwd)}): ${message}`));
+    for (const line of hooks[kind]) {
+        const outcome = await runLine(cwd, line, opts.timeoutMs ?? HOOK_TIMEOUT_MS, opts.env ?? process.env);
+        log(`[openagent] ${kind} hook (${basename(cwd)}): ${line}: ${outcome.summary}`);
+        for (const said of outcome.stderr.split('\n').map(s => s.trimEnd()).filter(Boolean))
+            log(`[openagent]   ${said}`);
+    }
+}
+/**
+ * Whether a `start` line passes the branch to start from on: it mentions `$BASE` or `${BASE`. A
+ * line is written once and kept, so one written before the pick existed, or a person's own, may
+ * not; the launcher then offers no pick, rather than one the line would drop.
+ */
+export function startLineTakesBase(line) {
+    return /\$\{?BASE\b/.test(line);
+}
+/**
+ * Run the project's `start` line: the prompt in `PROMPT`, the picks in `DRIVER`, `MODEL`,
+ * `PUBLISH` and `BASE` when made, the follow-up in `THEN` when there is one. The line answers one JSON
+ * document on stdout whose `id` names the run it started.
+ */
+export function runStartHook(cwd, input, opts = {}) {
+    return runRunHook(cwd, 'start', {
+        PROMPT: input.prompt,
+        ...(input.driver !== undefined ? { DRIVER: input.driver } : {}),
+        ...(input.model !== undefined ? { MODEL: input.model } : {}),
+        ...(input.then !== undefined ? { THEN: input.then } : {}),
+        ...(input.publish !== undefined ? { PUBLISH: input.publish } : {}),
+        ...(input.base !== undefined ? { BASE: input.base } : {}),
+    }, opts);
+}
+/**
+ * Run the project's `resume` line: the run in `RUN_ID`, and the person's words in `TEXT` or their
+ * answer in `ANSWER`. The line answers like a `start` line, naming the run it continued.
+ */
+export function runResumeHook(cwd, input, opts = {}) {
+    return runRunHook(cwd, 'resume', { RUN_ID: input.runId, ...('text' in input ? { TEXT: input.text } : { ANSWER: input.answer }) }, opts);
+}
+async function runRunHook(cwd, kind, vars, opts) {
+    let broken;
+    const hooks = await readProjectHooks(cwd, message => {
+        broken = message;
+    });
+    const line = hooks[kind];
+    if (line === undefined)
+        return { ok: false, error: broken ?? `this project has no ${kind} hook` };
+    const outcome = await runLine(cwd, line, opts.timeoutMs ?? HOOK_TIMEOUT_MS, { ...(opts.env ?? process.env), ...vars }, true);
+    let said;
+    try {
+        said = JSON.parse(outcome.stdout);
+    }
+    catch {
+        said = undefined;
+    }
+    const id = said && typeof said === 'object' ? said['id'] : undefined;
+    if (outcome.summary === 'exit 0' && typeof id === 'string' && id !== '')
+        return { ok: true, id };
+    // The tool's one line for a person is its last on stderr; without one, how the line ended.
+    const lastSaid = outcome.stderr.split('\n').map(s => s.trim()).filter(Boolean).at(-1);
+    return { ok: false, error: `the ${kind} hook: ${lastSaid ?? (outcome.summary === 'exit 0' ? 'it answered no run id' : outcome.summary)}` };
+}
+/**
+ * Run the project's `check` line: the coding agent the person picked in `DRIVER`, when picked.
+ * The line answers one JSON document on stdout with `problems` and `warnings`, lists of lines.
+ */
+export async function runCheckHook(cwd, input, opts = {}) {
+    let broken;
+    const hooks = await readProjectHooks(cwd, message => {
+        broken = message;
+    });
+    if (hooks.check === undefined)
+        return broken ? { ok: false, error: broken } : { ok: false, error: 'this project has no check hook', noHook: true };
+    const vars = input.driver !== undefined ? { DRIVER: input.driver } : {};
+    const outcome = await runLine(cwd, hooks.check, opts.timeoutMs ?? HOOK_TIMEOUT_MS, { ...(opts.env ?? process.env), ...vars }, true);
+    let said;
+    try {
+        said = JSON.parse(outcome.stdout);
+    }
+    catch {
+        said = undefined;
+    }
+    const lines = (key) => {
+        const value = said && typeof said === 'object' ? said[key] : undefined;
+        return Array.isArray(value) && value.every(line => typeof line === 'string') ? value : undefined;
+    };
+    const problems = lines('problems');
+    const warnings = lines('warnings');
+    if (outcome.summary === 'exit 0' && problems && warnings)
+        return { ok: true, problems, warnings };
+    const lastSaid = outcome.stderr.split('\n').map(s => s.trim()).filter(Boolean).at(-1);
+    return { ok: false, error: `the check hook: ${lastSaid ?? (outcome.summary === 'exit 0' ? 'it answered no problems and warnings' : outcome.summary)}` };
+}
+/**
+ * The environment a line runs with: the PATH led by the project's installed tools, then the
+ * built-in packages' own commands, so a tool named in a line is the project's copy when it
+ * installed one and the dashboard's otherwise, and never a package fetched by name.
+ */
+export async function hookEnv(cwd, env) {
+    return { ...env, PATH: [join(cwd, 'node_modules', '.bin'), ...(await builtInBinDirs()), env['PATH']].filter(Boolean).join(delimiter) };
+}
+/** One line through the shell: how it ended, in words, what it said on stderr, and its stdout when asked for. */
+async function runLine(cwd, line, timeoutMs, baseEnv, readStdout = false) {
+    const env = await hookEnv(cwd, baseEnv);
+    return new Promise(resolve => {
+        let stderr = '';
+        let stdout = '';
+        let settled = false;
+        const done = (summary) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ summary, stderr, stdout });
+        };
+        let child;
+        try {
+            child = spawn('sh', ['-c', line], { cwd, env, stdio: ['ignore', readStdout ? 'pipe' : 'ignore', 'pipe'] });
+        }
+        catch (err) {
+            done(`could not start: ${errorMessage(err)}`);
+            return;
+        }
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            done(`timed out after ${Math.round(timeoutMs / 1000)}s`);
+        }, timeoutMs);
+        child.stderr?.setEncoding('utf8');
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk;
+        });
+        child.stdout?.setEncoding('utf8');
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk;
+        });
+        child.once('error', err => done(`could not start: ${errorMessage(err)}`));
+        child.once('close', (code, signal) => done(signal ? `killed by ${signal}` : `exit ${code ?? 0}`));
+    });
+}
+//# sourceMappingURL=project-hooks.js.map

package/dist/project-hooks.js.map

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

package/dist/project-modules.d.ts

@@ -0,0 +1,50 @@
+import { type PackageCommandResult } from '@openagt/agent-data';
+/**
+ * A package that adds to the dashboard (#1774): its browser part, named by its
+ * `exports["./dashboard"]`, and optionally its server part, named by `exports["./server"]`.
+ * OpenAgent names no package: any dependency of the project that exports `./dashboard` is a
+ * module, whoever wrote it, and OpenAgent's own built-in modules come the same way.
+ */
+export interface ProjectModule {
+    /** The package's name, as the project's package.json lists it. */
+    package: string;
+    /** The package's version, when its package.json says one. */
+    version?: string;
+    /** The directory the module's browser part sits in, symlinks resolved: the only directory served for it. */
+    dir: string;
+    /** The module's browser part's file name inside {@link dir}. */
+    entry: string;
+    /** The package's commands, by name, as absolute paths: what the module may run in this project. */
+    bins: Record<string, string>;
+    /** The module's server part, an absolute path inside the package, when it has one. */
+    server?: string;
+}
+/**
+ * The modules a project has: each of its dependencies whose package.json exports `./dashboard` to
+ * a file that exists inside the package, plus the modules among OpenAgent's built-in packages (`built-in.ts`). A project that
+ * depends on a built-in module's package itself gets its own copy. Sorted by name.
+ */
+export declare function readProjectModules(root: string): Promise<ProjectModule[]>;
+/** The one module of this project that `name` names, or undefined. */
+export declare function findProjectModule(root: string, name: string): Promise<ProjectModule | undefined>;
+/**
+ * The file a module serves at `rel`, a path relative to its module's directory: its module, its
+ * stylesheet, a chunk. `undefined` for a path that leaves that directory (symlinks resolved) or
+ * names no file, so nothing else of the package, and nothing of the project, is ever served.
+ */
+export declare function moduleFile(module: ProjectModule, rel: string): Promise<string | undefined>;
+/** What a module's command answered: its JSON output, or why there is none. */
+export type ModuleCommandResult = PackageCommandResult;
+/**
+ * Run one of a module package's own commands in the project, with the given arguments, and read
+ * its standard output as JSON. This is how a module reads its data: the same command an agent runs
+ * (`npx logs`), so the module and the agent see the same thing and OpenAgent knows neither.
+ *
+ * `command` picks one of the package's commands; a package with exactly one needs none. The
+ * command runs with Node (a package's commands are Node scripts), in the project root, never
+ * through a shell, bounded in time and output. Refused: a command the package does not have, too
+ * many or too long arguments. A command that exits non-zero answers its last stderr line; one that
+ * prints no JSON says so.
+ */
+export declare function runModuleCommand(root: string, module: ProjectModule, args: readonly string[], command?: string): Promise<ModuleCommandResult>;
+//# sourceMappingURL=project-modules.d.ts.map

package/dist/project-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-modules.d.ts","sourceRoot":"","sources":["../src/project-modules.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiE,KAAK,oBAAoB,EAAuB,MAAM,qBAAqB,CAAA;AAGnJ;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4GAA4G;IAC5G,GAAG,EAAE,MAAM,CAAA;IACX,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AA4BD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAY/E;AAgBD,sEAAsE;AACtE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAEtG;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKhG;AAED,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAA;AAMtD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAS9B"}