@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/store/runs.js

@@ -0,0 +1,146 @@
+import { runPackageCommand } from '@openagt/agent-data';
+import { providedCommand } from '../built-in.js';
+const STATUSES = ['running', 'done', 'stopped', 'failed', 'waiting'];
+/** Whether a string can name a run: letters, digits, `-` and `_`, nothing a path can climb out with. */
+export function isRunId(id) {
+    return /^[A-Za-z0-9_-]+$/.test(id);
+}
+/**
+ * A card read back: the fields of the shape, each kept only when it has the right type, plus
+ * `caller` as it is. `undefined` for anything that is not a card — not an object, or missing an
+ * id, a start or a status. Takes a card's JSON text or an already-parsed value.
+ */
+export function parseRunCard(input) {
+    let raw = input;
+    if (typeof input === 'string') {
+        try {
+            raw = JSON.parse(input);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const r = raw;
+    const status = r['status'];
+    if (typeof r['id'] !== 'string' || !isRunId(r['id']) || typeof r['startedAt'] !== 'string' || !STATUSES.includes(status))
+        return undefined;
+    const card = { id: r['id'], startedAt: r['startedAt'], status: status };
+    for (const key of ['endedAt', 'intent', 'driver', 'model', 'branch', 'ticket']) {
+        if (typeof r[key] === 'string')
+            card[key] = r[key];
+    }
+    if (typeof r['cost'] === 'number')
+        card.cost = r['cost'];
+    const pr = r['pr'];
+    if (pr && typeof pr === 'object' && typeof pr['number'] === 'number' && typeof pr['url'] === 'string')
+        card.pr = { number: pr['number'], url: pr['url'] };
+    const caller = r['caller'];
+    if (caller && typeof caller === 'object' && !Array.isArray(caller))
+        card.caller = caller;
+    return card;
+}
+/** Diary lines read back from a provider's output: the JSON objects with a string `kind`, in order. */
+function diaryLines(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((line) => !!line && typeof line === 'object' && !Array.isArray(line) && typeof line['kind'] === 'string');
+}
+/**
+ * How many runs a list asks for: every run the project has, in practice. The command line takes a
+ * cap, and OpenAgent's lists (the sidebar's history, a ticket's holder, the activity feed) have
+ * always read the whole record.
+ */
+const LIST_LIMIT = 10_000;
+/** How long a read is reused: the dashboard polls many reads of the same list every few seconds, and each is a process. */
+const CACHE_MS = 5_000;
+/** The runs source over one provider command: each call one run of the command, reads cached per {@link CACHE_MS}. */
+function commandRuns(root, command, now) {
+    let listed;
+    const shown = new Map();
+    const drop = () => {
+        listed = undefined;
+        shown.clear();
+    };
+    return {
+        drop,
+        list(opts = {}) {
+            // Concurrent reads share one process; a read that failed is not kept.
+            if (listed && !opts.fresh && now() - listed.at < CACHE_MS)
+                return listed.cards;
+            const read = { at: now(), cards: Promise.resolve([]) };
+            read.cards = runPackageCommand(root, command, ['--local', '--full', '--limit', String(LIST_LIMIT)]).then(result => {
+                if (!result.ok || !Array.isArray(result.output)) {
+                    if (listed === read)
+                        listed = undefined;
+                    return [];
+                }
+                return result.output.map(parseRunCard).filter((card) => card !== undefined);
+            });
+            listed = read;
+            return read.cards;
+        },
+        show(id) {
+            if (!isRunId(id))
+                return Promise.resolve(undefined);
+            const known = shown.get(id);
+            if (known && now() - known.at < CACHE_MS)
+                return known.run;
+            const read = { at: now(), run: Promise.resolve(undefined) };
+            read.run = runPackageCommand(root, command, ['show', id, '--local', '--full']).then(result => {
+                const output = result.ok ? result.output : undefined;
+                const card = parseRunCard(output);
+                if (!card) {
+                    if (shown.get(id) === read)
+                        shown.delete(id);
+                    return undefined;
+                }
+                return { card, diary: diaryLines(output['diary']) };
+            });
+            shown.set(id, read);
+            return read.run;
+        },
+        async remove(id) {
+            if (!isRunId(id))
+                return { ok: false, error: `not a run id: ${id}` };
+            const result = await runPackageCommand(root, command, ['delete', id]);
+            drop();
+            return result.ok ? { ok: true } : { ok: false, error: result.error };
+        },
+        async patch(id, patch) {
+            if (!isRunId(id))
+                return { ok: false, error: `not a run id: ${id}` };
+            const args = ['patch', id, ...(patch.branch !== undefined ? ['--branch', patch.branch] : []), ...(patch.pr ? ['--pr', String(patch.pr.number), '--pr-url', patch.pr.url] : []), ...(patch.landed ? ['--landed', patch.landed.commit, '--from', patch.landed.from] : [])];
+            const result = await runPackageCommand(root, command, args);
+            drop();
+            return result.ok ? { ok: true } : { ok: false, error: result.error };
+        },
+    };
+}
+/**
+ * The production {@link RunsFor}: the project's provider, looked up by its package.json, one
+ * source per project kept while the same command provides — so the cache holds across the many
+ * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
+ * within {@link CACHE_MS}. `changed(root)` forgets that project's reads, so the next read runs the
+ * command again: a module's command just ran there, and may have written.
+ */
+export function providedRuns(now = Date.now) {
+    const sources = new Map();
+    const reader = async (root) => {
+        let known = sources.get(root);
+        if (!known || now() - known.at >= CACHE_MS) {
+            const command = await providedCommand(root, 'runs').catch(() => undefined);
+            const same = known?.command && command && known.command.bin === command.bin;
+            known = { at: now(), ...(command ? { command, source: same ? known.source : commandRuns(root, command, now) } : {}) };
+            sources.set(root, known);
+        }
+        return known.source;
+    };
+    return Object.assign(reader, { changed: (root) => sources.get(root)?.source?.drop() });
+}
+/** OpenAgent's one reader of finished runs, shared by every caller so they share its cache. */
+export const projectRuns = providedRuns();
+/** A {@link RunsFor} for a project with no provider: no finished runs. */
+export const noRuns = async () => undefined;
+//# sourceMappingURL=runs.js.map

package/dist/store/runs.js.map

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

package/dist/store/test-branches.d.ts

@@ -0,0 +1,18 @@
+import type { BranchesFor, BranchState, Checkout } from './branches.js';
+/**
+ * A branches provider as a test would have it: the checkouts of every project held in memory,
+ * answering what a real provider's command would. `writes` records every publish, merge and
+ * remove; a remove takes the checkout out of the list, the way the command would.
+ */
+export declare function testBranches(byProject?: Record<string, Checkout[]>, states?: BranchState[]): BranchesFor & {
+    writes: string[];
+};
+/**
+ * Make the real branches package the project's provider, the way a project has it: listed as a
+ * dependency in its package.json (kept, when one is there), and installed under `node_modules` as
+ * a link to this workspace's copy, whose built command is what the provider runs. The package
+ * lists the project's checkouts from `.branches/`, so the project must be a git repository whose
+ * checkouts are real worktrees.
+ */
+export declare function linkBranchesProvider(root: string): Promise<void>;
+//# sourceMappingURL=test-branches.d.ts.map

package/dist/store/test-branches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-branches.d.ts","sourceRoot":"","sources":["../../src/store/test-branches.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAkB,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEvF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAM,EAAE,MAAM,GAAE,WAAW,EAAO,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA8BvI;AAKD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE"}

package/dist/store/test-branches.js

@@ -0,0 +1,59 @@
+import { mkdir, readFile, symlink, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * A branches provider as a test would have it: the checkouts of every project held in memory,
+ * answering what a real provider's command would. `writes` records every publish, merge and
+ * remove; a remove takes the checkout out of the list, the way the command would.
+ */
+export function testBranches(byProject = {}, states = []) {
+    const writes = [];
+    const checkouts = new Map(Object.entries(byProject).map(([root, rows]) => [root, [...rows]]));
+    const sourceFor = (root) => ({
+        async list() {
+            return [...(checkouts.get(root) ?? [])];
+        },
+        async show(branches) {
+            return branches.flatMap(branch => states.filter(state => state.branch === branch));
+        },
+        async push(branch) {
+            writes.push(`push ${branch}`);
+            return { ok: true, pushed: true };
+        },
+        async merge(branch) {
+            writes.push(`merge ${branch}`);
+            return { ok: true, into: 'main', commit: 'c'.repeat(40), from: 'b'.repeat(40), deleted: true };
+        },
+        async remove(id, opts = {}) {
+            writes.push(`remove ${id}${opts.discard ? ' --discard' : ''}`);
+            const rows = checkouts.get(root) ?? [];
+            if (!rows.some(row => row.id === id))
+                return { ok: false, error: `no checkout for agent ${id}` };
+            checkouts.set(root, rows.filter(row => row.id !== id));
+            return { ok: true };
+        },
+    });
+    return Object.assign(async (root) => (checkouts.has(root) ? sourceFor(root) : undefined), { writes });
+}
+/** The name of the package whose command is the branches provider of every project a test makes real. */
+const BRANCHES_PACKAGE = '@openagt/skill-branches';
+/**
+ * Make the real branches package the project's provider, the way a project has it: listed as a
+ * dependency in its package.json (kept, when one is there), and installed under `node_modules` as
+ * a link to this workspace's copy, whose built command is what the provider runs. The package
+ * lists the project's checkouts from `.branches/`, so the project must be a git repository whose
+ * checkouts are real worktrees.
+ */
+export async function linkBranchesProvider(root) {
+    const manifestPath = join(root, 'package.json');
+    const manifest = JSON.parse(await readFile(manifestPath, 'utf8').catch(() => '{}'));
+    const devDependencies = (manifest['devDependencies'] ?? {});
+    await writeFile(manifestPath, JSON.stringify({ ...manifest, devDependencies: { ...devDependencies, [BRANCHES_PACKAGE]: '*' } }));
+    const link = join(root, 'node_modules', ...BRANCHES_PACKAGE.split('/'));
+    await mkdir(dirname(link), { recursive: true });
+    await symlink(resolve(dirname(fileURLToPath(import.meta.resolve(BRANCHES_PACKAGE))), '..'), link).catch((err) => {
+        if (err.code !== 'EEXIST')
+            throw err;
+    });
+}
+//# sourceMappingURL=test-branches.js.map

package/dist/store/test-branches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-branches.js","sourceRoot":"","sources":["../../src/store/test-branches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGxC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,SAAS,GAA+B,EAAE,EAAE,MAAM,GAAkB,EAAE;IACjG,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7F,MAAM,SAAS,GAAG,CAAC,IAAY,EAAkB,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI;YACR,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACzC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ;YACjB,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAA;QACpF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM;YACf,MAAM,CAAC,IAAI,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAA;YAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QACnC,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,MAAM;YAChB,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;YAC9B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAChG,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE;YACxB,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAC9D,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;YACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE,CAAA;YAChG,SAAS,CAAC,GAAG,CACX,IAAI,EACJ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAClC,CAAA;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrB,CAAC;KACF,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;AAC/G,CAAC;AAED,yGAAyG;AACzG,MAAM,gBAAgB,GAAG,yBAAyB,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAA4B,CAAA;IAC9G,MAAM,eAAe,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAA2B,CAAA;IACrF,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,eAAe,EAAE,EAAE,GAAG,eAAe,EAAE,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;IAChI,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACvE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAA0B,EAAE,EAAE;QACrI,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/store/test-runs.d.ts

@@ -0,0 +1,15 @@
+import { type AnyDiaryLine, type RunCard, type RunsFor } from './runs.js';
+/** One finished run a test seeds: its card (a whole card, or just its fields) and its diary. */
+export interface TestRun {
+    card: Partial<RunCard> & Pick<RunCard, 'id' | 'status'>;
+    diary?: AnyDiaryLine[];
+}
+/**
+ * A runs provider as a test would have it: the finished runs of every project held in memory,
+ * answering what a real provider's command would. `writes` records every remove and patch, and
+ * the runs change the way the command would change them.
+ */
+export declare function testRuns(byProject?: Record<string, TestRun[]>): RunsFor & {
+    writes: string[];
+};
+//# sourceMappingURL=test-runs.d.ts.map

package/dist/store/test-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runs.d.ts","sourceRoot":"","sources":["../../src/store/test-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAmB,MAAM,WAAW,CAAA;AAExG,gGAAgG;AAChG,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAA;IACvD,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAM,GAAG,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA2BlG"}

package/dist/store/test-runs.js

@@ -0,0 +1,37 @@
+import { parseRunCard } from './runs.js';
+/**
+ * A runs provider as a test would have it: the finished runs of every project held in memory,
+ * answering what a real provider's command would. `writes` records every remove and patch, and
+ * the runs change the way the command would change them.
+ */
+export function testRuns(byProject = {}) {
+    const writes = [];
+    const runs = new Map(Object.entries(byProject).map(([root, list]) => [root, list.map(run => ({ card: parseRunCard({ startedAt: '2026-07-04T00:00:00.000Z', ...run.card }), diary: run.diary ?? [] }))]));
+    const sourceFor = (root) => ({
+        async list() {
+            return [...(runs.get(root) ?? [])].map(run => run.card).sort((a, b) => (a.id < b.id ? 1 : a.id > b.id ? -1 : 0));
+        },
+        async show(id) {
+            const run = runs.get(root)?.find(r => r.card.id === id);
+            return run && { card: run.card, diary: run.diary };
+        },
+        async remove(id) {
+            writes.push(`delete ${id}`);
+            const list = runs.get(root) ?? [];
+            if (!list.some(r => r.card.id === id))
+                return { ok: false, error: `no run is named ${id}` };
+            runs.set(root, list.filter(r => r.card.id !== id));
+            return { ok: true };
+        },
+        async patch(id, patch) {
+            writes.push(`patch ${id} ${JSON.stringify(patch)}`);
+            const run = runs.get(root)?.find(r => r.card.id === id);
+            if (!run)
+                return { ok: false, error: `no run is named ${id}` };
+            run.card = { ...run.card, ...patch };
+            return { ok: true };
+        },
+    });
+    return Object.assign(async (root) => (runs.has(root) ? sourceFor(root) : undefined), { writes });
+}
+//# sourceMappingURL=test-runs.js.map

package/dist/store/test-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runs.js","sourceRoot":"","sources":["../../src/store/test-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkE,MAAM,WAAW,CAAA;AAQxG;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAS,GAA8B,EAAE;IAChE,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,SAAS,EAAE,0BAA0B,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,CAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzM,MAAM,SAAS,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI;YACR,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAClH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE;YACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;YACvD,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QACpD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE;YACb,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;YACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAA;YAC3F,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;YAClD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrB,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK;YACnB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;YACvD,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAA;YAC9D,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAA;YACpC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrB,CAAC;KACF,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;AAC1G,CAAC"}

package/dist/store/tickets.d.ts

@@ -0,0 +1,73 @@
+/**
+ * The tickets, as OpenAgent reads them (#1774). OpenAgent keeps no ticket and imports no
+ * tickets package: a project's tickets come from whichever of its packages declares that it
+ * provides them — `"openagent": { "tickets": "<command>" }` in the package's own package.json —
+ * and OpenAgent reads them by running that command. Swap the package for another that answers
+ * the same command line and prints the same shape, and nothing here changes. No package declares
+ * it: the project has no tickets, and the dashboard shows it none.
+ *
+ * The command line a provider answers, printing one JSON document and exiting 0:
+ *   `<command> list --local`   every open ticket, as an array of {@link Ticket}
+ * `--local` reads the copy on this machine, no network: OpenAgent polls.
+ *
+ * That is the whole contract. OpenAgent reads tickets for what it composes across skills: the
+ * onboarding step, a queued link's title. Showing them, planning them, claiming and releasing them,
+ * and the Overview's hot-tickets card, are the tickets package's own module, through its own command.
+ *
+ * The shape, owned here: {@link Ticket}, the row a ticket lists as.
+ */
+/** A ticket's row, as a provider prints it. Everything but the five plain facts is optional. */
+export interface Ticket {
+    /** The ticket's file name, its identity: `tickets/<file>` is the path a link to it carries. */
+    file: string;
+    title: string;
+    /** One line of what it is about; empty when the ticket says nothing beyond its title. */
+    summary: string;
+    /** `0`–`10` as written, `10` acting at once; absent when unset, and not checked here. */
+    priority?: string;
+    topics?: string[];
+    /** The issue it tracks in the project's tracker, and the pull request that closes it: a label and where it points. */
+    issue?: {
+        label: string;
+        url: string;
+    };
+    pr?: {
+        label: string;
+        url: string;
+    };
+    /** ISO 8601: the file's date. */
+    date: string;
+    /** Whether a plan sits beside it. */
+    planned: boolean;
+    /** Whether someone holds it, and who: a run's id, or a branch. */
+    locked?: boolean;
+    lockedBy?: string;
+    effort?: number;
+    uncertainty?: number;
+}
+/** A project's tickets: what a provider answers, read by OpenAgent. */
+export interface TicketsSource {
+    /** Every open ticket; `[]` when none can be read. */
+    list(): Promise<Ticket[]>;
+}
+/** The tickets of the project at `root`, or `undefined` when none of its packages provides them. */
+export type TicketsFor = (root: string) => Promise<TicketsSource | undefined>;
+/** A {@link TicketsFor} that also forgets what it read of one project, for when a module just wrote there. */
+export type TicketsReader = TicketsFor & {
+    changed(root: string): void;
+};
+/** The rows read back from a provider's output: the objects with the five plain facts, everything else as printed; anything else is no ticket. */
+export declare function parseTickets(output: unknown): Ticket[];
+/**
+ * The production {@link TicketsReader}: the project's provider, looked up by its package.json, one
+ * source per project kept while the same command provides — so the cache holds across the many
+ * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
+ * within {@link CACHE_MS}. `changed(root)` forgets that project's read, so the next read runs the
+ * command again: a module's command just ran there, and may have written.
+ */
+export declare function providedTickets(now?: () => number): TicketsReader;
+/** OpenAgent's one reader of the tickets, shared by every caller so they share its cache. */
+export declare const projectTickets: TicketsReader;
+/** A {@link TicketsFor} for a project with no provider: no tickets. */
+export declare const noTickets: TicketsFor;
+//# sourceMappingURL=tickets.d.ts.map

package/dist/store/tickets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.d.ts","sourceRoot":"","sources":["../../src/store/tickets.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH,gGAAgG;AAChG,MAAM,WAAW,MAAM;IACrB,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAA;IACf,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,sHAAsH;IACtH,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,EAAE,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAC1B;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;AAE7E,8GAA8G;AAC9G,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IAAE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAKxE,kJAAkJ;AAClJ,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAGtD;AAgCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,MAAiB,GAAG,aAAa,CAa3E;AAED,6FAA6F;AAC7F,eAAO,MAAM,cAAc,EAAE,aAAiC,CAAA;AAE9D,uEAAuE;AACvE,eAAO,MAAM,SAAS,EAAE,UAAkC,CAAA"}

package/dist/store/tickets.js

@@ -0,0 +1,67 @@
+import { runPackageCommand } from '@openagt/agent-data';
+import { providedCommand } from '../built-in.js';
+/** How long a read is reused: the dashboard polls several reads of every project's tickets every few seconds, and each is a process. */
+const CACHE_MS = 5_000;
+/** The rows read back from a provider's output: the objects with the five plain facts, everything else as printed; anything else is no ticket. */
+export function parseTickets(output) {
+    if (!Array.isArray(output))
+        return [];
+    return output.filter(isTicket);
+}
+function isTicket(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const row = value;
+    return typeof row.file === 'string' && row.file !== '' && typeof row.title === 'string' && typeof row.summary === 'string' && typeof row.date === 'string' && typeof row.planned === 'boolean';
+}
+/** The tickets source over one provider command: each list one run of the command, reads cached per {@link CACHE_MS}. */
+function commandTickets(root, command, now) {
+    let listed;
+    return {
+        drop() {
+            listed = undefined;
+        },
+        list() {
+            // Concurrent reads share one process; a read that failed is not kept.
+            if (listed && now() - listed.at < CACHE_MS)
+                return listed.tickets;
+            const read = { at: now(), tickets: Promise.resolve([]) };
+            read.tickets = runPackageCommand(root, command, ['list', '--local']).then(result => {
+                if (!result.ok || !Array.isArray(result.output)) {
+                    if (listed === read)
+                        listed = undefined;
+                    return [];
+                }
+                return parseTickets(result.output);
+            });
+            listed = read;
+            return read.tickets;
+        },
+    };
+}
+/**
+ * The production {@link TicketsReader}: the project's provider, looked up by its package.json, one
+ * source per project kept while the same command provides — so the cache holds across the many
+ * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
+ * within {@link CACHE_MS}. `changed(root)` forgets that project's read, so the next read runs the
+ * command again: a module's command just ran there, and may have written.
+ */
+export function providedTickets(now = Date.now) {
+    const sources = new Map();
+    const reader = async (root) => {
+        let known = sources.get(root);
+        if (!known || now() - known.at >= CACHE_MS) {
+            const command = await providedCommand(root, 'tickets').catch(() => undefined);
+            const same = known?.command && command && known.command.bin === command.bin;
+            known = { at: now(), ...(command ? { command, source: same ? known.source : commandTickets(root, command, now) } : {}) };
+            sources.set(root, known);
+        }
+        return known.source;
+    };
+    return Object.assign(reader, { changed: (root) => sources.get(root)?.source?.drop() });
+}
+/** OpenAgent's one reader of the tickets, shared by every caller so they share its cache. */
+export const projectTickets = providedTickets();
+/** A {@link TicketsFor} for a project with no provider: no tickets. */
+export const noTickets = async () => undefined;
+//# sourceMappingURL=tickets.js.map

package/dist/store/tickets.js.map

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

package/dist/terminal.d.ts

@@ -0,0 +1,4 @@
+import { type OpenAgentEvent } from './events.js';
+/** Render a {@link OpenAgentEvent} as one human-readable line (terminal surface). */
+export declare function formatOpenAgentEvent(event: OpenAgentEvent): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAO/E,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA4ClE"}

package/dist/terminal.js

@@ -0,0 +1,97 @@
+import { pickedIds } from './events.js';
+// The terminal surface for the agent's event stream: render one {@link OpenAgentEvent} as one
+// human-readable line. This is the CLI's counterpart to the dashboard's read-model
+// projections (run-view.ts) — a pure formatter over the same union, kept out of events.ts so
+// the event contract stays a plain data module (and browser-safe for the client bundle).
+/** Render a {@link OpenAgentEvent} as one human-readable line (terminal surface). */
+export function formatOpenAgentEvent(event) {
+    switch (event.kind) {
+        case 'session':
+            return `◆ ${event.fake ? 'fake' : event.driver}${event.model ? ` (${event.model})` : ''} in ${event.workspace}${event.sessionLink ? ` — ${event.sessionLink}` : ''}`;
+        case 'session-update':
+            return `  session ${event.sessionId}${event.sessionLink ? ` — ${event.sessionLink}` : ''}`;
+        case 'screen':
+            return `◆ ${event.label}`;
+        case 'log':
+            return `  ${event.message}`;
+        case 'error':
+            return `✗ ${event.headline}${event.detail ? `\n    ${event.detail.replace(/\n/g, '\n    ')}` : ''}`;
+        case 'view':
+            return `▶ view: ${event.title}`;
+        case 'settled':
+            return `◆ done for now — waiting for your next message`;
+        case 'branch':
+            return `  branch: ${event.branch}`;
+        case 'cloud-anchor':
+            return `  hand-off anchor: ${event.sha.slice(0, 7)}`;
+        case 'pull-request':
+            return `  pull request: #${event.number}`;
+        case 'usage':
+            return `  spend: $${event.costUsd.toFixed(4)}`;
+        case 'choice': {
+            const mark = (o) => event.multi ? (o.default ? '[x]' : '[ ]') : o.id === event.recommended ? '●' : '○';
+            const opts = event.options.map(o => `    ${mark(o)} ${o.label}`).join('\n');
+            return `? ${event.title}\n${opts}`;
+        }
+        case 'choice-resolved':
+            return `  ✓ chose ${pickedIds(event.picked).join(', ') || '(none)'} (${event.by})`;
+        case 'driver':
+            return formatDriverEvent(event.event);
+        case 'intent':
+            return `▶ "${truncate(event.text)}"`;
+        case 'end':
+            if (event.ok)
+                return '✓ finished';
+            if (event.stopped)
+                return '■ stopped';
+            if (event.waiting)
+                return '? waiting for an answer';
+            return `✗ failed: ${event.detail ?? 'unknown error'}`;
+    }
+}
+function formatDriverEvent(event) {
+    switch (event.type) {
+        case 'start':
+            return `  › prompt: ${truncate(event.prompt, 140)}`;
+        // Normally consumed by telemetry before it reaches a stream (#1322); rendered anyway so a
+        // stray one reads as what it is rather than crashing the formatter.
+        case 'session':
+            return `  session ${event.sessionId}`;
+        case 'model':
+            return `  model ${event.model}`;
+        // A message being written reads as the text it has so far; a diary never holds one.
+        case 'partial':
+        case 'text':
+            return `    ${truncate(event.text)}`;
+        case 'action':
+            return event.detail !== undefined ? `    · ${event.label}  ${truncate(event.detail, 140)}` : `    · ${event.label}`;
+        case 'output':
+            return `      ${event.failed ? '✗' : '→'} ${truncate(event.text, 140)}`;
+        case 'thought':
+            return `    💭 ${truncate(event.text, 140)}`;
+        case 'result':
+            return `  ‹ turn complete`;
+        case 'rate-limit':
+            return `    ${formatRateLimit(event.limit)}`;
+        case 'error':
+            return `  ! agent error: ${event.message}`;
+        case 'notice':
+            return `  ~ ${event.message}`;
+        case 'question':
+            return `  ? ${truncate(event.question.title, 140)}`;
+    }
+}
+/** Quiet on the happy path: only worth a line when the quota is actually tight. */
+function formatRateLimit(limit) {
+    const resets = new Date(limit.resetsAt).toISOString();
+    if (limit.status === 'rejected')
+        return `✗ quota exhausted (${limit.window}), resets ${resets}`;
+    if (limit.status === 'allowed_warning')
+        return `! quota running low (${limit.window}), resets ${resets}`;
+    return `· quota ${limit.status} (${limit.window}), resets ${resets}`;
+}
+function truncate(text, max = 100) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? flat.slice(0, max - 1) + '…' : flat;
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

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

package/dist/update-check.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CLI "up-to-date?" check (#312): after the bare-`openagent` version footer,
+ * tell the user whether a newer version is published on npm. Display only;
+ * auto-update is a separate, deferred concern. Same seam + node-adapter +
+ * forgiving-on-error convention as `project.ts` (#380).
+ */
+/** The npm package this CLI ships as; the registry key for the version check. */
+export declare const PACKAGE_NAME = "@openagt/dashboard";
+/** Fetches the latest published version of `pkg`, or undefined on any failure. Injectable for tests. */
+export type VersionFetcher = (pkg: string) => Promise<string | undefined>;
+/**
+ * A {@link VersionFetcher} backed by the npm registry. GETs the packument and
+ * reads `dist-tags.latest`. A 2.5s AbortSignal.timeout caps it; any error /
+ * non-ok / offline yields undefined (the check silently degrades to "unknown").
+ */
+export declare function nodeVersionFetcher(): VersionFetcher;
+/** The result of an update check. */
+export type UpdateStatus = {
+    kind: 'up-to-date';
+    current: string;
+} | {
+    kind: 'update-available';
+    current: string;
+    latest: string;
+} | {
+    kind: 'unknown';
+    current: string;
+};
+/**
+ * Compare two `major.minor.patch` versions numerically (a prerelease/build
+ * suffix after `-` or `+` is stripped, missing parts read as 0). Returns
+ * -1 / 0 / 1. No semver dependency.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Check whether `current` is behind the latest published version. Uses the
+ * injected fetcher; a missing/failed fetch is 'unknown'. `current` >= latest is
+ * 'up-to-date' (so running a local build ahead of the registry never reads as
+ * "update available").
+ */
+export declare function checkForUpdate(current: string, fetchLatest: VersionFetcher, pkg?: string): Promise<UpdateStatus>;
+/** The one-line message to print for a status, or undefined for 'unknown' (print nothing). */
+export declare function formatUpdateStatus(status: UpdateStatus): string | undefined;
+//# sourceMappingURL=update-check.d.ts.map