@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/store/index.js

@@ -0,0 +1,10 @@
+export { nodeStoreFs, listAgents, readAllAgents, findAgent, isPidAlive, readLiveMeta, loadAgentEvents, readLiveMetas, readDoing, readFinishedDiary, } from './agent-store.js';
+export { findCheckout, resolveAgentCheckout, resolveAgentDiary } from './agent-checkout.js';
+export { projectRuns, providedRuns, noRuns, parseRunCard, isRunId } from './runs.js';
+export { projectBranches, providedBranches, noBranches, parseCheckouts, parseBranchStates } from './branches.js';
+export { projectGitHost, providedGitHost, noGitHost, parseRequests } from './git-host.js';
+export { projectQueue, providedQueue, noQueue, parseQueueEntries } from './queue.js';
+export { providedDataChanged } from './provided.js';
+export { fromRunCard, fromDiaryLine, eventsOf } from './run-record.js';
+export { agentIdFromStartedAt, startedAtFromAgentId } from '../agent-id.js';
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,iBAAiB,GAKlB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAyB,MAAM,qBAAqB,CAAA;AAClH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAoJ,MAAM,WAAW,CAAA;AACtO,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAqN,MAAM,eAAe,CAAA;AACnU,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAoO,MAAM,eAAe,CAAA;AAC3T,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAqD,MAAM,YAAY,CAAA;AACvI,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/store/provided.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A package's command just ran in the project at `root` (a module's, through the dashboard), and
+ * may have written what one of OpenAgent's provided readers caches: every provided reader
+ * forgets that project, so its next read runs the provider again. OpenAgent never knows which
+ * command writes what; forgetting is cheap and re-reading is what it does anyway.
+ */
+export declare function providedDataChanged(root: string): void;
+/** The kinds of OpenAgent's data a project's package may provide, one reader each (`git-host` is `git-host.ts`). */
+export declare const PROVIDED_KINDS: readonly ['tickets', 'queue', 'runs', 'branches', 'git-host', 'repository'];
+/**
+ * Why a kind of the project's data has no provider although packages declare it (#1820): two or
+ * more declare the kind and the project's package.json names none, or names one that does not
+ * declare it. One sentence per such kind, for the project's error banner; none when every kind is
+ * settled. Nobody declaring a kind is not a problem: the project has none of that data.
+ */
+export declare function providerProblems(root: string): Promise<string[]>;
+//# sourceMappingURL=provided.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provided.d.ts","sourceRoot":"","sources":["../../src/store/provided.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMtD;AAED,oHAAoH;AACpH,eAAO,MAAM,cAAc,YAAI,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAU,CAAA;AAEzG;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOtE"}

package/dist/store/provided.js

@@ -0,0 +1,37 @@
+import { lookupProvided } from '../built-in.js';
+import { projectBranches } from './branches.js';
+import { projectGitHost } from './git-host.js';
+import { projectQueue } from './queue.js';
+import { projectRuns } from './runs.js';
+import { projectTickets } from './tickets.js';
+/**
+ * A package's command just ran in the project at `root` (a module's, through the dashboard), and
+ * may have written what one of OpenAgent's provided readers caches: every provided reader
+ * forgets that project, so its next read runs the provider again. OpenAgent never knows which
+ * command writes what; forgetting is cheap and re-reading is what it does anyway.
+ */
+export function providedDataChanged(root) {
+    projectBranches.changed(root);
+    projectGitHost.changed(root);
+    projectQueue.changed(root);
+    projectRuns.changed(root);
+    projectTickets.changed(root);
+}
+/** The kinds of OpenAgent's data a project's package may provide, one reader each (`git-host` is `git-host.ts`). */
+export const PROVIDED_KINDS = ['tickets', 'queue', 'runs', 'branches', 'git-host', 'repository'];
+/**
+ * Why a kind of the project's data has no provider although packages declare it (#1820): two or
+ * more declare the kind and the project's package.json names none, or names one that does not
+ * declare it. One sentence per such kind, for the project's error banner; none when every kind is
+ * settled. Nobody declaring a kind is not a problem: the project has none of that data.
+ */
+export async function providerProblems(root) {
+    const problems = [];
+    for (const kind of PROVIDED_KINDS) {
+        const { problem } = await lookupProvided(root, kind).catch(() => ({}));
+        if (problem)
+            problems.push(problem);
+    }
+    return problems;
+}
+//# sourceMappingURL=provided.js.map

package/dist/store/provided.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provided.js","sourceRoot":"","sources":["../../src/store/provided.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,oHAAoH;AACpH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAU,CAAA;AAEzG;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAyB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5F,IAAI,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/store/queue.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The agent queue, as OpenAgent reads it (#1774). OpenAgent keeps no queue and imports no
+ * queue package: a project's queue comes from whichever of its packages declares that it provides
+ * it — `"openagent": { "queue": "<command>" }` in the package's own package.json — and
+ * OpenAgent reads it 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 queue, and the dashboard shows it none.
+ *
+ * The command line a provider answers, printing one JSON document and exiting 0:
+ *   `<command> --local`   the open entries, in order of work, as an array of strings
+ * `--local` reads the copy on this machine, no network: OpenAgent polls.
+ *
+ * That is the whole contract. Writing the queue is not OpenAgent's: a module the queue package
+ * brings acts on it through its own command (`@openagt/dashboard/module`'s link actions), and OpenAgent
+ * only re-reads.
+ *
+ * The shape, owned here: an entry is one string, the task a future agent is started with, as the
+ * queue's own command prints it. A markdown link at its start names the work and where it points;
+ * how a dashboard reads that is the queue package's module's.
+ */
+/** A project's queue: what a provider answers, read by OpenAgent. */
+export interface QueueSource {
+    /** The open entries, in order of work; `[]` when none can be read. */
+    list(): Promise<string[]>;
+}
+/** The queue of the project at `root`, or `undefined` when none of its packages provides one. */
+export type QueueFor = (root: string) => Promise<QueueSource | undefined>;
+/** A {@link QueueFor} that also forgets what it read of one project, for when a module just wrote there. */
+export type QueueReader = QueueFor & {
+    changed(root: string): void;
+};
+/** Entries read back from a provider's output: the non-empty strings of an array, trimmed; anything else is no entries. */
+export declare function parseQueueEntries(output: unknown): string[];
+/**
+ * The production {@link QueueReader}: 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 providedQueue(now?: () => number): QueueReader;
+/** OpenAgent's one reader of the queue, shared by every caller so they share its cache. */
+export declare const projectQueue: QueueReader;
+/** A {@link QueueFor} for a project with no provider: no queue. */
+export declare const noQueue: QueueFor;
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/store/queue.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAC1B;AAED,iGAAiG;AACjG,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;AAEzE,4GAA4G;AAC5G,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG;IAAE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAKpE,2HAA2H;AAC3H,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAG3D;AA0BD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,MAAiB,GAAG,WAAW,CAavE;AAED,2FAA2F;AAC3F,eAAO,MAAM,YAAY,EAAE,WAA6B,CAAA;AAExD,mEAAmE;AACnE,eAAO,MAAM,OAAO,EAAE,QAAgC,CAAA"}

package/dist/store/queue.js

@@ -0,0 +1,61 @@
+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 queue every few seconds, and each is a process. */
+const CACHE_MS = 5_000;
+/** Entries read back from a provider's output: the non-empty strings of an array, trimmed; anything else is no entries. */
+export function parseQueueEntries(output) {
+    if (!Array.isArray(output))
+        return [];
+    return output.filter((entry) => typeof entry === 'string').map(entry => entry.trim()).filter(Boolean);
+}
+/** The queue source over one provider command: each list one run of the command, reads cached per {@link CACHE_MS}. */
+function commandQueue(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.entries;
+            const read = { at: now(), entries: Promise.resolve([]) };
+            read.entries = runPackageCommand(root, command, ['--local']).then(result => {
+                if (!result.ok || !Array.isArray(result.output)) {
+                    if (listed === read)
+                        listed = undefined;
+                    return [];
+                }
+                return parseQueueEntries(result.output);
+            });
+            listed = read;
+            return read.entries;
+        },
+    };
+}
+/**
+ * The production {@link QueueReader}: 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 providedQueue(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, 'queue').catch(() => undefined);
+            const same = known?.command && command && known.command.bin === command.bin;
+            known = { at: now(), ...(command ? { command, source: same ? known.source : commandQueue(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 queue, shared by every caller so they share its cache. */
+export const projectQueue = providedQueue();
+/** A {@link QueueFor} for a project with no provider: no queue. */
+export const noQueue = async () => undefined;
+//# sourceMappingURL=queue.js.map

package/dist/store/queue.js.map

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

package/dist/store/repository.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Creating a project's repository on a host, for a project that lives on this machine only. Like
+ * every provided kind, OpenAgent names no host: the package that declares
+ * `"openagent": { "repository": "<command>" }` creates it, and OpenAgent asks by running that
+ * command.
+ *
+ * The command line a provider answers, each printing one JSON document and exiting 0 (a refusal
+ * exits 1 with its reason on stderr):
+ *   `<command> create --check`   the repository the project would become, `{ repository, name }`
+ *                                (`name` is the host's), creating nothing; refused when the
+ *                                project has a remote already or the host cannot be reached
+ *   `<command> create`           create it private, set it as the project's origin and push;
+ *                                `{ repository, url, name }`
+ */
+/** The repository a project would become, and the host it would be on. */
+export interface RepositoryOffer {
+    /** `<account>/<name>`, as the host names it. */
+    repository: string;
+    /** The host's name, for a button: `GitHub`. */
+    name: string;
+}
+export type CreateRepositoryResult = {
+    ok: true;
+    url: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** What the project's repository provider offers to create, or undefined: no provider, a remote already there, or a host that cannot be reached. */
+export declare function repositoryOffer(root: string): Promise<RepositoryOffer | undefined>;
+/** Create the project's repository through its provider; a refusal is the provider's own line. */
+export declare function createRepository(root: string): Promise<CreateRepositoryResult>;
+//# sourceMappingURL=repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/store/repository.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7F,oJAAoJ;AACpJ,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAOxF;AAED,kGAAkG;AAClG,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAOpF"}

package/dist/store/repository.js

@@ -0,0 +1,25 @@
+import { runPackageCommand } from '@openagt/agent-data';
+import { providedCommand } from '../built-in.js';
+/** What the project's repository provider offers to create, or undefined: no provider, a remote already there, or a host that cannot be reached. */
+export async function repositoryOffer(root) {
+    const command = await providedCommand(root, 'repository').catch(() => undefined);
+    if (!command)
+        return undefined;
+    const result = await runPackageCommand(root, command, ['create', '--check']);
+    if (!result.ok || !result.output || typeof result.output !== 'object')
+        return undefined;
+    const { repository, name } = result.output;
+    return typeof repository === 'string' && typeof name === 'string' ? { repository, name } : undefined;
+}
+/** Create the project's repository through its provider; a refusal is the provider's own line. */
+export async function createRepository(root) {
+    const command = await providedCommand(root, 'repository').catch(() => undefined);
+    if (!command)
+        return { ok: false, error: 'no package of this project creates a repository' };
+    const result = await runPackageCommand(root, command, ['create']);
+    if (!result.ok)
+        return { ok: false, error: result.error };
+    const url = result.output && typeof result.output === 'object' ? result.output['url'] : undefined;
+    return typeof url === 'string' ? { ok: true, url } : { ok: false, error: `${command.name} created no repository` };
+}
+//# sourceMappingURL=repository.js.map

package/dist/store/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/store/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AA2BhD,oJAAoJ;AACpJ,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAChF,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAC9B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAA;IAC5E,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACvF,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,MAAiC,CAAA;IACrE,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACtG,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAChF,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAA;IAC5F,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IACjE,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;IACzD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAM,CAAC,MAAkC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC9H,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,wBAAwB,EAAE,CAAA;AACpH,CAAC"}

package/dist/store/run-record.d.ts

@@ -0,0 +1,22 @@
+import type { AnyDiaryLine, RunCard } from './runs.js';
+import type { OpenAgentEvent } from '../events.js';
+import type { AgentMeta } from './agent-store.js';
+/**
+ * A run's card and diary (`runs.ts`), read as OpenAgent's own shapes (#1769): the card as the
+ * meta every list shows, the diary as the events the run page replays and tails. The card's
+ * eleven plain fields and four kinds of diary line are the shape; whoever ran the agent keeps the
+ * rest of what it knows under one key, `caller`, and writes its other lines as they are.
+ * OpenAgent records no run of its own (#1774), so there is no writing half.
+ */
+/** A card as OpenAgent's meta: `caller` unfolded, the card's own fields winning. */
+export declare function fromRunCard(card: RunCard): AgentMeta;
+/**
+ * One diary line as one OpenAgent event: what the agent said, its result, the run's end and its
+ * cost are the shape's four kinds; a line of any other kind is an OpenAgent event as written, and
+ * one whose kind is no longer an event (the kinds of runs recorded before OpenAgent stopped
+ * running agents) reads as nothing. The line's time, `at`, is the event's, whatever the kind.
+ */
+export declare function fromDiaryLine(line: AnyDiaryLine): OpenAgentEvent | undefined;
+/** A diary as the run's events, for a reader that replays them. */
+export declare function eventsOf(lines: readonly AnyDiaryLine[]): OpenAgentEvent[];
+//# sourceMappingURL=run-record.d.ts.map

package/dist/store/run-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../../src/store/run-record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;;GAMG;AAEH,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAK5E;AAiFD,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,EAAE,CAEzE"}

package/dist/store/run-record.js

@@ -0,0 +1,108 @@
+/**
+ * A run's card and diary (`runs.ts`), read as OpenAgent's own shapes (#1769): the card as the
+ * meta every list shows, the diary as the events the run page replays and tails. The card's
+ * eleven plain fields and four kinds of diary line are the shape; whoever ran the agent keeps the
+ * rest of what it knows under one key, `caller`, and writes its other lines as they are.
+ * OpenAgent records no run of its own (#1774), so there is no writing half.
+ */
+/** A card as OpenAgent's meta: `caller` unfolded, the card's own fields winning. */
+export function fromRunCard(card) {
+    const { caller, ...own } = card;
+    return { updatedAt: card.endedAt ?? card.startedAt, ...caller, ...own };
+}
+/**
+ * One diary line as one OpenAgent event: what the agent said, its result, the run's end and its
+ * cost are the shape's four kinds; a line of any other kind is an OpenAgent event as written, and
+ * one whose kind is no longer an event (the kinds of runs recorded before OpenAgent stopped
+ * running agents) reads as nothing. The line's time, `at`, is the event's, whatever the kind.
+ */
+export function fromDiaryLine(line) {
+    const { at, ...rest } = line;
+    const event = eventOf(rest);
+    if (!event)
+        return undefined;
+    return typeof at === 'string' ? { ...event, at } : event;
+}
+/** Every kind of event there is: a line of another kind has nothing to show. */
+const EVENT_KINDS = {
+    session: true,
+    'session-update': true,
+    screen: true,
+    log: true,
+    error: true,
+    view: true,
+    'pull-request': true,
+    branch: true,
+    'cloud-anchor': true,
+    settled: true,
+    usage: true,
+    choice: true,
+    'choice-resolved': true,
+    driver: true,
+    intent: true,
+    end: true,
+};
+/** A diary line with no time on it, as the event it reads as. */
+function eventOf(line) {
+    switch (line.kind) {
+        case 'said':
+            return { kind: 'driver', event: { type: 'text', text: String(line['text']) } };
+        case 'result': {
+            const { kind: _kind, ...rest } = line;
+            return { kind: 'driver', event: { type: 'result', ...rest } };
+        }
+        case 'ended':
+            return {
+                kind: 'end',
+                ok: line['status'] === 'done',
+                ...(line['status'] === 'stopped' ? { stopped: true } : {}),
+                ...(line['status'] === 'waiting' ? { waiting: true } : {}),
+                ...(typeof line['detail'] === 'string' ? { detail: line['detail'] } : {}),
+            };
+        // An error line with a headline is the agent's own `error` block, from a run recorded before the
+        // daemon stopped running agents; any other is agent-driver's, a driver's message.
+        case 'error': {
+            if (typeof line['headline'] === 'string') {
+                return { kind: 'error', headline: line['headline'], ...(typeof line['detail'] === 'string' ? { detail: line['detail'] } : {}) };
+            }
+            const { kind: _kind, ...rest } = line;
+            return { kind: 'driver', event: { type: 'error', ...rest } };
+        }
+        // The lines agent-driver's own log writes (its `session-log.ts`): a driver event per kind, the
+        // agent's session id, and the question a turn ended on as the gate the dashboard shows.
+        case 'start':
+        case 'action':
+        case 'output':
+        case 'thought':
+        case 'rate-limit':
+        case 'notice': {
+            const { kind, ...rest } = line;
+            return { kind: 'driver', event: { type: kind, ...rest } };
+        }
+        case 'session':
+            if (typeof line['sessionId'] === 'string' && line['driver'] === undefined)
+                return { kind: 'session-update', sessionId: line['sessionId'] };
+            return line;
+        case 'question': {
+            const { kind: _kind, title, options, recommended, multi, file } = line;
+            return {
+                kind: 'choice',
+                id: 'await-choices',
+                title: String(title ?? 'Which option?'),
+                options: Array.isArray(options) ? options : [],
+                ...(typeof recommended === 'string' ? { recommended } : {}),
+                ...(multi === true ? { multi: true } : {}),
+                ...(typeof file === 'string' ? { file } : {}),
+            };
+        }
+        case 'cost':
+            return { kind: 'usage', costUsd: line['usd'] };
+        default:
+            return Object.hasOwn(EVENT_KINDS, line.kind) ? line : undefined;
+    }
+}
+/** A diary as the run's events, for a reader that replays them. */
+export function eventsOf(lines) {
+    return lines.flatMap(line => fromDiaryLine(line) ?? []);
+}
+//# sourceMappingURL=run-record.js.map

package/dist/store/run-record.js.map

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

package/dist/store/runs.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Finished runs, as OpenAgent reads them (#1774). OpenAgent keeps no run and imports no
+ * records package: a project's finished runs come from whichever of its packages declares that it
+ * provides them — `"openagent": { "runs": "<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 shapes, and nothing here changes. No package declares
+ * it: the project has no finished runs, only the ones still running in a checkout.
+ *
+ * The command line a provider answers, each printing one JSON document and exiting 0:
+ *   `<command> --local --full --limit N`   the runs, newest first, whole cards
+ *   `<command> show <id> --local --full`   one run: the whole card plus `diary`, every line
+ *   `<command> delete <id>`                remove a run
+ *   `<command> patch <id> [--branch <b>] [--pr <n> --pr-url <url>] [--landed <commit> --from <commit>]`   the late facts
+ * `--local` reads the copy on this machine, no network: OpenAgent polls.
+ *
+ * The shapes, owned here: {@link RunCard} and {@link AnyDiaryLine}. A running agent's own card in
+ * its checkout is the same shape, written by the tool that runs it.
+ */
+/** How a run stands: still going, or how it ended. */
+export type RunStatus = 'running' | 'done' | 'stopped' | 'failed' | 'waiting';
+/**
+ * A run's card: what was asked, where the work went, how it ended, what it cost. `caller` is the
+ * bookkeeping of the program that ran the agent (its pid, host, session id, …), one key.
+ */
+export interface RunCard {
+    id: string;
+    startedAt: string;
+    endedAt?: string;
+    status: RunStatus;
+    intent?: string;
+    driver?: string;
+    model?: string;
+    branch?: string;
+    pr?: {
+        number: number;
+        url: string;
+    };
+    ticket?: string;
+    cost?: number;
+    caller?: Record<string, unknown>;
+}
+/** The two late facts a finished run's card may still learn: the branch its work landed on, its pull request. */
+export type RunPatch = Partial<Pick<RunCard, 'branch' | 'pr'>> & {
+    /** The run's work was merged and its branch deleted: its last commit, and the commit its work began at. */
+    landed?: {
+        commit: string;
+        from: string;
+    };
+};
+/** One line of a run's diary: a JSON object with a `kind`. */
+export type AnyDiaryLine = {
+    kind: string;
+} & Record<string, unknown>;
+/** A finished run: its card and its whole diary. */
+export interface FinishedRun {
+    card: RunCard;
+    diary: AnyDiaryLine[];
+}
+/** A project's finished runs: what a provider answers, read by OpenAgent. */
+export interface RunsSource {
+    /**
+     * Every finished run's card, newest first; `[]` when none can be read. `fresh` skips a list read
+     * a moment ago: the caller knows the runs changed since.
+     */
+    list(opts?: {
+        fresh?: boolean;
+    }): Promise<RunCard[]>;
+    /** One run with its diary; `undefined` for no such run, or none readable. */
+    show(id: string): Promise<FinishedRun | undefined>;
+    /** Remove a run, or why it could not be. */
+    remove(id: string): Promise<RunsWrite>;
+    /** Set a run's late facts, or why they could not be. */
+    patch(id: string, patch: RunPatch): Promise<RunsWrite>;
+}
+/** What a change to the runs did: done, or the provider's reason it was not. */
+export type RunsWrite = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** The finished runs of the project at `root`, or `undefined` when none of its packages provides them. */
+export type RunsFor = (root: string) => Promise<RunsSource | undefined>;
+/** A {@link RunsFor} that also forgets what it read of one project, for when a module just wrote there. */
+export type RunsReader = RunsFor & {
+    changed(root: string): void;
+};
+/** Whether a string can name a run: letters, digits, `-` and `_`, nothing a path can climb out with. */
+export declare function isRunId(id: string): boolean;
+/**
+ * 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 declare function parseRunCard(input: unknown): RunCard | undefined;
+/**
+ * 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 declare function providedRuns(now?: () => number): RunsReader;
+/** OpenAgent's one reader of finished runs, shared by every caller so they share its cache. */
+export declare const projectRuns: RunsReader;
+/** A {@link RunsFor} for a project with no provider: no finished runs. */
+export declare const noRuns: RunsFor;
+//# sourceMappingURL=runs.d.ts.map

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

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