@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/store/git-host.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The project's git host, as the framework reads and acts on it (#1820): the pull requests of the
+ * project, opening one, landing one, and the project's page there. The framework names no git host
+ * and runs no git host tool: a project's git host comes from whichever of its packages declares that it
+ * provides it — `"framework": { "git-host": "<command>" }` in the package's own package.json — and
+ * the framework asks 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 git host, so no pull requests, and a finished run's last step is the push. A
+ * built-in package's git host is the project's only when it answers the project's page there: a
+ * project whose remote is on another host, or that has no remote, has none.
+ *
+ * The command line a provider answers, each printing one JSON document and exiting 0 (a refusal
+ * exits 1 with its reason on stderr):
+ *   `<command> requests [--branch <b>] [--state open|merged|all] [--since <iso>]`
+ *                                                       the project's pull requests, newest first, as an array of {@link GitHostRequest}
+ *   `<command> open --branch <b> --title <t> [--body <text>] [--draft]`
+ *                                                       open the branch's pull request; an open one is answered as it is (`existing`)
+ *   `<command> merge <number>`                          land the pull request: armed to merge on green, or merged at once
+ *   `<command> home`                                    the project's page on the git host, and the git host's name
+ * The branch `open` is asked for must already be on the remote: pushing is the branches
+ * provider's step, and the framework runs it first.
+ *
+ * The shapes, owned here: {@link GitHostRequest}, {@link GitHostHome}.
+ */
+/** A pull request, as a provider lists it. */
+export interface GitHostRequest {
+    number: number;
+    url: string;
+    state: 'open' | 'merged' | 'closed';
+    title: string;
+    draft: boolean;
+    /** The branch the request is from. */
+    branch: string;
+    /** The commit the request's head is at. */
+    head: string;
+    /** ISO creation time. */
+    createdAt: string;
+    /** ISO merge time, for a merged request. */
+    mergedAt?: string;
+    /** The commit a merged request landed as on the base branch. */
+    mergeCommit?: string;
+}
+/** The project's page on the git host, and what the git host is called: what a link is drawn from. */
+export interface GitHostHome {
+    url: string;
+    name: string;
+}
+/** What asking for requests answered: the list, or why there is none: "none" and "could not tell" are different answers. */
+export type RequestsOutcome = {
+    ok: true;
+    requests: GitHostRequest[];
+} | {
+    ok: false;
+    error: string;
+};
+/** What opening a pull request left: the request, and whether it was open already. */
+export type OpenOutcome = {
+    ok: true;
+    request: {
+        number: number;
+        url: string;
+    };
+    existing: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/** What landing a pull request did: armed to merge on green, merged at once, or the provider watching its checks. */
+export type MergeOutcome = {
+    ok: true;
+    outcome: 'auto-armed' | 'merged' | 'watching';
+} | {
+    ok: false;
+    error: string;
+};
+/** A project's git host: what a provider answers, read and moved by the framework. */
+export interface GitHostSource {
+    /** The project's pull requests, newest first: all, or one branch's, or by state, or since a time. */
+    requests(opts?: {
+        branch?: string;
+        state?: 'open' | 'merged' | 'all';
+        since?: string;
+    }): Promise<RequestsOutcome>;
+    /** Open a branch's pull request, or answer the open one. */
+    open(branch: string, opts: {
+        title: string;
+        body?: string;
+        draft?: boolean;
+    }): Promise<OpenOutcome>;
+    /** Land a pull request. */
+    merge(number: number): Promise<MergeOutcome>;
+    /** The project's page on the git host; `undefined` when the provider cannot tell (no remote there). */
+    home(): Promise<GitHostHome | undefined>;
+}
+/** The git host of the project at `root`, or `undefined` when none of its packages provides one. */
+export type GitHostFor = (root: string) => Promise<GitHostSource | undefined>;
+/** A {@link GitHostFor} that also forgets what it knows of one project. */
+export type GitHostReader = GitHostFor & {
+    changed(root: string): void;
+};
+/** The rows read back from a provider's `requests`: the objects with the facts a request needs; anything else is no request. */
+export declare function parseRequests(output: unknown): GitHostRequest[];
+/**
+ * The production {@link GitHostReader}: the project's provider, looked up by its package.json, one
+ * source per project kept while the same command provides, so a project that installs, swaps or
+ * drops its git host is read the new way within {@link CACHE_MS}. `changed(root)` forgets the
+ * project, so the next ask looks its provider up again.
+ */
+export declare function providedGitHost(now?: () => number): GitHostReader;
+/** The framework's one reader of the git host, shared by every caller. */
+export declare const projectGitHost: GitHostReader;
+/** A {@link GitHostFor} for a project with no git host package. */
+export declare const noGitHost: GitHostFor;
+//# sourceMappingURL=git-host.d.ts.map

package/dist/store/git-host.d.ts.map

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

package/dist/store/git-host.js

@@ -0,0 +1,103 @@
+import { runPackageCommand } from '@openagt/agent-data';
+import { isBuiltIn, providedCommand } from '../built-in.js';
+/** How long a provider lookup is reused: the dashboard asks for the git host on every handoff read. */
+const CACHE_MS = 5_000;
+/** The rows read back from a provider's `requests`: the objects with the facts a request needs; anything else is no request. */
+export function parseRequests(output) {
+    if (!Array.isArray(output))
+        return [];
+    const requests = [];
+    for (const value of output) {
+        if (!value || typeof value !== 'object')
+            continue;
+        const row = value;
+        const state = row['state'];
+        if (typeof row['number'] !== 'number' || typeof row['url'] !== 'string' || (state !== 'open' && state !== 'merged' && state !== 'closed'))
+            continue;
+        requests.push({
+            number: row['number'],
+            url: row['url'],
+            state,
+            title: typeof row['title'] === 'string' ? row['title'] : '',
+            draft: row['draft'] === true,
+            branch: typeof row['branch'] === 'string' ? row['branch'] : '',
+            head: typeof row['head'] === 'string' ? row['head'] : '',
+            createdAt: typeof row['createdAt'] === 'string' ? row['createdAt'] : '',
+            ...(typeof row['mergedAt'] === 'string' ? { mergedAt: row['mergedAt'] } : {}),
+            ...(typeof row['mergeCommit'] === 'string' ? { mergeCommit: row['mergeCommit'] } : {}),
+        });
+    }
+    return requests;
+}
+/** A pull request read back from an `open` answer, or undefined. */
+function requestOf(output) {
+    const request = output && typeof output === 'object' ? output['request'] : undefined;
+    return request && typeof request === 'object' && typeof request['number'] === 'number' && typeof request['url'] === 'string' ? { number: request['number'], url: request['url'] } : undefined;
+}
+/** The git host source over one provider command: each call one run of the command. */
+function commandGitHost(root, command) {
+    return {
+        async requests(opts = {}) {
+            const args = ['requests', ...(opts.branch ? ['--branch', opts.branch] : []), ...(opts.state ? ['--state', opts.state] : []), ...(opts.since ? ['--since', opts.since] : [])];
+            const result = await runPackageCommand(root, command, args);
+            if (!result.ok)
+                return { ok: false, error: result.error };
+            return { ok: true, requests: parseRequests(result.output) };
+        },
+        async open(branch, opts) {
+            const args = ['open', '--branch', branch, '--title', opts.title, ...(opts.body !== undefined ? ['--body', opts.body] : []), ...(opts.draft ? ['--draft'] : [])];
+            const result = await runPackageCommand(root, command, args);
+            if (!result.ok)
+                return { ok: false, error: result.error };
+            const request = requestOf(result.output);
+            if (!request)
+                return { ok: false, error: `${command.name} opened no pull request` };
+            return { ok: true, request, existing: result.output['existing'] === true };
+        },
+        async merge(number) {
+            const result = await runPackageCommand(root, command, ['merge', String(number)]);
+            if (!result.ok)
+                return { ok: false, error: result.error };
+            const outcome = result.output && typeof result.output === 'object' ? result.output['outcome'] : undefined;
+            if (outcome === 'auto-armed' || outcome === 'merged' || outcome === 'watching')
+                return { ok: true, outcome };
+            return { ok: false, error: `${command.name} did not merge` };
+        },
+        async home() {
+            const result = await runPackageCommand(root, command, ['home']);
+            if (!result.ok || !result.output || typeof result.output !== 'object')
+                return undefined;
+            const home = result.output;
+            return typeof home['url'] === 'string' && typeof home['name'] === 'string' ? { url: home['url'], name: home['name'] } : undefined;
+        },
+    };
+}
+/**
+ * The production {@link GitHostReader}: the project's provider, looked up by its package.json, one
+ * source per project kept while the same command provides, so a project that installs, swaps or
+ * drops its git host is read the new way within {@link CACHE_MS}. `changed(root)` forgets the
+ * project, so the next ask looks its provider up again.
+ */
+export function providedGitHost(now = Date.now) {
+    const sources = new Map();
+    const reader = async (root) => {
+        let known = sources.get(root);
+        if (!known || now() - known.at >= CACHE_MS) {
+            let command = await providedCommand(root, 'git-host').catch(() => undefined);
+            // A built-in git host is one the project did not choose: it is the project's only when it
+            // knows the project's page there (the origin remote is on that host).
+            if (command && (await isBuiltIn(root, command)) && !(await commandGitHost(root, command).home()))
+                command = undefined;
+            const same = known?.command && command && known.command.bin === command.bin;
+            known = { at: now(), ...(command ? { command, source: same ? known.source : commandGitHost(root, command) } : {}) };
+            sources.set(root, known);
+        }
+        return known.source;
+    };
+    return Object.assign(reader, { changed: (root) => sources.delete(root) });
+}
+/** The framework's one reader of the git host, shared by every caller. */
+export const projectGitHost = providedGitHost();
+/** A {@link GitHostFor} for a project with no git host package. */
+export const noGitHost = async () => undefined;
+//# sourceMappingURL=git-host.js.map

package/dist/store/git-host.js.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,10 @@
+export { nodeStoreFs, listAgents, readAllAgents, findAgent, isPidAlive, readLiveMeta, loadAgentEvents, readLiveMetas, readDoing, readFinishedDiary, type StoreFs, type AgentMeta, type LiveAgent, type AgentStatus, } from './agent-store.js';
+export { findCheckout, resolveAgentCheckout, resolveAgentDiary, type AgentDiarySource } from './agent-checkout.js';
+export { projectRuns, providedRuns, noRuns, parseRunCard, isRunId, type RunsFor, type RunsReader, type RunsSource, type RunsWrite, type RunCard, type RunPatch, type RunStatus, type AnyDiaryLine, type FinishedRun } from './runs.js';
+export { projectBranches, providedBranches, noBranches, parseCheckouts, parseBranchStates, type BranchesFor, type BranchesReader, type BranchesSource, type RemoveOutcome as BranchRemoveOutcome, type Checkout, type BranchState, type BranchCommit, type BranchFile, type PushOutcome as BranchPushOutcome } from './branches.js';
+export { projectGitHost, providedGitHost, noGitHost, parseRequests, type GitHostFor, type GitHostReader, type GitHostSource, type GitHostRequest, type GitHostHome, type RequestsOutcome as GitHostRequestsOutcome, type OpenOutcome as GitHostOpenOutcome, type MergeOutcome as GitHostMergeOutcome } from './git-host.js';
+export { projectQueue, providedQueue, noQueue, parseQueueEntries, type QueueFor, type QueueReader, type QueueSource } 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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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,EACjB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAClH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AACtO,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,IAAI,mBAAmB,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACnU,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,IAAI,sBAAsB,EAAE,KAAK,WAAW,IAAI,kBAAkB,EAAE,KAAK,YAAY,IAAI,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAC3T,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,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/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 the framework's provided readers caches: every provided reader
+ * forgets that project, so its next read runs the provider again. The framework 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 the framework'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,wHAAwH;AACxH,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 the framework's provided readers caches: every provided reader
+ * forgets that project, so its next read runs the provider again. The framework 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 the framework'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,wHAAwH;AACxH,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 the framework reads it (#1774). The framework keeps no queue and imports no
+ * queue package: a project's queue comes from whichever of its packages declares that it provides
+ * it — `"framework": { "queue": "<command>" }` in the package's own package.json — and the
+ * framework 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: the framework polls.
+ *
+ * That is the whole contract. Writing the queue is not the framework's: a module the queue package
+ * brings acts on it through its own command (`@openagt/dashboard/module`'s link actions), and the framework
+ * 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 the framework. */
+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;
+/** The framework'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,yEAAyE;AACzE,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,+FAA+F;AAC/F,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() });
+}
+/** The framework'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, the framework names no host: the package that declares
+ * `"framework": { "repository": "<command>" }` creates it, and the framework 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-checkout.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The checkout a run id resolves to (#738/#797): the run's own worktree while it exists, else
+ * the project root. Live metas first — a running run records its cwd — then the worktree
+ * directory itself, which exists before the run has written its `run.json` (#766): the daemon
+ * creates the directory and spawns the process, and only then does the run write its meta, so
+ * a lookup by run state alone misses a run that certainly exists.
+ *
+ * The directory probe matters beyond a slow first read: a Telefunc Channel resolves its path
+ * once, when the client subscribes. Falling back to the project root would not self-correct a
+ * moment later — the channel would tail the wrong file for the life of the subscription, which
+ * is how a newly started run once showed a previous run's output.
+ *
+ * An unknown or finished `runId` falls back to the project root rather than failing: the
+ * run's worktree may already be gone, and the project's own state is still the sane thing to
+ * act on. This is the one resolution every run-addressed surface shares — the daemon's serve
+ * targets and previews, and each dashboard RPC — so the fallback rules cannot drift apart.
+ */
+export declare function resolveRunCheckout(projectCwd: string, runId: string | undefined): Promise<string>;
+/**
+ * The events journal a run-scoped subscribe should tail (#1472). Follows
+ * {@link resolveRunCheckout}'s order — live meta cwd, then the worktree — but where that
+ * resolution would fall back to the project root, an ended run's **archived** `<id>.jsonl`
+ * wins: the archive existing proves the run ended, and it is the run's own record, where the
+ * root journal belongs to whatever root run wrote it last. The root journal stays the final
+ * fallback for the no-archive residue, so a just-starting root run (no meta yet, #766, and no
+ * worktree to probe) streams exactly as before.
+ *
+ * Only the events tails resolve here; every other run-addressed surface keeps
+ * {@link resolveRunCheckout}'s root fallback, where the project's own state is the sane
+ * thing to act on.
+ */
+export declare function resolveRunEventsPath(projectCwd: string, runId: string | undefined): Promise<string>;
+//# sourceMappingURL=run-checkout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-checkout.d.ts","sourceRoot":"","sources":["../../src/store/run-checkout.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAOvG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzG"}

package/dist/store/run-checkout.js

@@ -0,0 +1,59 @@
+import { join } from 'node:path';
+import { archivedRunPaths, isSafeRunId, readLiveMetas, EVENTS_FILE, FRAMEWORK_DIR } from './run-store.js';
+import { worktreePath } from './worktree.js';
+import { nodeFs } from '../node-fs.js';
+/**
+ * The checkout a run id resolves to (#738/#797): the run's own worktree while it exists, else
+ * the project root. Live metas first — a running run records its cwd — then the worktree
+ * directory itself, which exists before the run has written its `run.json` (#766): the daemon
+ * creates the directory and spawns the process, and only then does the run write its meta, so
+ * a lookup by run state alone misses a run that certainly exists.
+ *
+ * The directory probe matters beyond a slow first read: a Telefunc Channel resolves its path
+ * once, when the client subscribes. Falling back to the project root would not self-correct a
+ * moment later — the channel would tail the wrong file for the life of the subscription, which
+ * is how a newly started run once showed a previous run's output.
+ *
+ * An unknown or finished `runId` falls back to the project root rather than failing: the
+ * run's worktree may already be gone, and the project's own state is still the sane thing to
+ * act on. This is the one resolution every run-addressed surface shares — the daemon's serve
+ * targets and previews, and each dashboard RPC — so the fallback rules cannot drift apart.
+ */
+export async function resolveRunCheckout(projectCwd, runId) {
+    if (!runId || !isSafeRunId(runId))
+        return projectCwd;
+    const live = await readLiveMetas(projectCwd).catch(() => []);
+    const running = live.find(run => run.id === runId)?.cwd;
+    if (running)
+        return running;
+    const path = worktreePath(projectCwd, runId);
+    return (await nodeFs().isDirectory(path)) ? path : projectCwd;
+}
+/**
+ * The events journal a run-scoped subscribe should tail (#1472). Follows
+ * {@link resolveRunCheckout}'s order — live meta cwd, then the worktree — but where that
+ * resolution would fall back to the project root, an ended run's **archived** `<id>.jsonl`
+ * wins: the archive existing proves the run ended, and it is the run's own record, where the
+ * root journal belongs to whatever root run wrote it last. The root journal stays the final
+ * fallback for the no-archive residue, so a just-starting root run (no meta yet, #766, and no
+ * worktree to probe) streams exactly as before.
+ *
+ * Only the events tails resolve here; every other run-addressed surface keeps
+ * {@link resolveRunCheckout}'s root fallback, where the project's own state is the sane
+ * thing to act on.
+ */
+export async function resolveRunEventsPath(projectCwd, runId) {
+    const rootJournal = join(projectCwd, FRAMEWORK_DIR, EVENTS_FILE);
+    if (!runId || !isSafeRunId(runId))
+        return rootJournal;
+    const live = await readLiveMetas(projectCwd).catch(() => []);
+    const running = live.find(run => run.id === runId)?.cwd;
+    if (running)
+        return join(running, FRAMEWORK_DIR, EVENTS_FILE);
+    const path = worktreePath(projectCwd, runId);
+    if (await nodeFs().isDirectory(path))
+        return join(path, FRAMEWORK_DIR, EVENTS_FILE);
+    const [, archivedEvents] = await archivedRunPaths(projectCwd, runId);
+    return archivedEvents ?? rootJournal;
+}
+//# sourceMappingURL=run-checkout.js.map