@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/agent-commit.js

@@ -0,0 +1,254 @@
+import { join } from 'node:path';
+import { ARCHIVE_DIR } from './store/index.js';
+import { THE_FRAMEWORK_DIR } from './framework-dir.js';
+import { nodeGitRunner } from './project.js';
+import { errorMessage } from './error-message.js';
+/**
+ * Committing the agent archives the daemon writes (#912/#1179) into the project checkout.
+ *
+ * An agent's own worktree sweeps its archive on teardown (`store/worktree.ts`). The main checkout has
+ * no such path — `install.ts` commits once at activation and nothing after — so an archive written
+ * there sat as a working-tree change until a human happened to commit it. That is the gap between
+ * "the history is in Git" and "the history reaches Git by itself".
+ *
+ * It used to carry a second pathspec, the per-agent conversation markdown, and the machinery for
+ * choosing between them: a pathspec matching no file aborts the whole `git add`, so every project
+ * that had sessions but had never recorded a chat needed the other pattern dropped. With one
+ * record (B3) there is one pathspec and nothing to choose.
+ *
+ * Two rules shape the whole module, both about writing into a repo somebody else is using.
+ *
+ * Path-scoped, never `git add -A`. The pathspec names the archives and nothing else, the way
+ * `queue-promote.ts` names the queue file, so whatever the user has in progress cannot ride along
+ * in our commit. A pathspec commit also leaves their index alone: what they had staged is still
+ * staged afterwards.
+ *
+ * Debounced on an idle window rather than committed per write. Archives land seconds apart, and a
+ * commit each would bury the project's real history under noise. A poll that sees the same pending
+ * set twice running treats it as settled and commits the batch; a burst keeps resetting it.
+ * {@link AgentCommitterOptions.maxWaitMs} caps that, so a project that never goes idle still
+ * lands instead of being starved forever.
+ *
+ * Tolerates not being alone (the question (#605) this waited on). One daemon per machine is the rule
+ * today (#393), but the committer never assumes it: a locked index or a rebase/merge in progress
+ * means somebody else is mid-operation, so it skips rather than commits into their work, and a
+ * failed commit is swallowed and retried on the next window.
+ */
+/**
+ * The committed agent archives (#1179), under every user's own directory.
+ *
+ * `:(glob)` magic so the `*` stops at a path separator — a plain pathspec wildcard matches `/` too,
+ * and would reach further down `.the-framework/` than this means to.
+ *
+ * The trailing `/**` is load-bearing, and its absence is silent: glob magic matches the pattern
+ * against each file's whole path rather than treating a directory as a prefix, so
+ * `.the-framework/*​/sessions` matches no *file* and `git add` fails with "did not match any files"
+ * — a committer that commits nothing, every time. Only a real repo shows this.
+ */
+export const ARCHIVE_PATHSPEC = `:(glob)${THE_FRAMEWORK_DIR}/*/${ARCHIVE_DIR}/**`;
+/** How long writes may keep arriving before the batch is committed anyway. */
+export const COMMIT_MAX_WAIT_MS = 5 * 60_000;
+/** A {@link PathProbe} over `fs.access`. */
+export function nodePathProbe() {
+    return async (path) => {
+        const { access } = await import('node:fs/promises');
+        return access(path).then(() => true, () => false);
+    };
+}
+/**
+ * The commit message a batch writes. Names what moved, so the log line stands alone.
+ *
+ * Counted by run, not by file: one archived agent is a `<id>.json` and a `<id>.jsonl`, and
+ * "2 sessions" for a single session would be a lie told by the batch's own commit message.
+ */
+export function commitMessage(files) {
+    const agents = new Set(files.map(file => file.replace(/\.[^./]+$/, ''))).size;
+    return `[The Framework] ${agents === 1 ? 'a session' : `${agents} sessions`}`;
+}
+/**
+ * The archive files with uncommitted changes, as repo-relative paths, sorted so the result is
+ * a stable fingerprint the debounce can compare across polls.
+ *
+ * `--porcelain` v1 is parsed rather than `--short` because its two status columns are fixed-width
+ * and its paths are quoted consistently. A rename (`R  old -> new`) reports the destination, which
+ * is the path we would commit. Anything unreadable — not a repo, no git — reads as no changes.
+ *
+ * `-uall` is load-bearing, not a detail. By default git collapses a wholly-untracked directory into
+ * one entry instead of naming the files under it, which makes the fingerprint identical whether one
+ * archive is being written or ten. The debounce compares fingerprints, so without this the idle
+ * window could never see a burst and would commit straight through the middle of one. Only a real
+ * repo shows this; a per-file fake does not.
+ */
+export async function pendingAgents(cwd, git = nodeGitRunner()) {
+    const out = await git(['status', '--porcelain', '-uall', '--', ARCHIVE_PATHSPEC], cwd).catch(() => '');
+    const files = new Set();
+    for (const line of out.split('\n')) {
+        if (line.length < 4)
+            continue;
+        // Columns 0-1 are the status codes, 2 is a space, the path starts at 3.
+        const entry = line.slice(3);
+        const arrow = entry.indexOf(' -> ');
+        files.add(unquotePath(arrow === -1 ? entry : entry.slice(arrow + ' -> '.length)));
+    }
+    return [...files].sort();
+}
+/**
+ * Undo git's C-style quoting of a path holding non-ASCII or special characters. Only the escapes
+ * git actually emits are handled; anything else is left as written rather than mangled.
+ */
+function unquotePath(entry) {
+    if (!entry.startsWith('"') || !entry.endsWith('"'))
+        return entry;
+    return entry
+        .slice(1, -1)
+        .replace(/\\([\\"])/g, '$1')
+        .replace(/\\t/g, '\t')
+        .replace(/\\n/g, '\n');
+}
+/** The markers that mean another git operation owns this repo right now. */
+const BUSY_MARKERS = [
+    ['index.lock', 'another git process holds the index lock'],
+    ['rebase-merge', 'a rebase is in progress'],
+    ['rebase-apply', 'a rebase is in progress'],
+    ['MERGE_HEAD', 'a merge is in progress'],
+    ['CHERRY_PICK_HEAD', 'a cherry-pick is in progress'],
+    ['REVERT_HEAD', 'a revert is in progress'],
+    ['BISECT_LOG', 'a bisect is in progress'],
+];
+/**
+ * Why the repo is in no state to be committed into, or `undefined` when it is fine.
+ *
+ * The git dir is resolved through git rather than assumed to be `<cwd>/.git`, so this is right in a
+ * linked worktree, where `.git` is a file pointing elsewhere and the markers live in the real dir.
+ */
+export async function gitBusy(cwd, git = nodeGitRunner(), exists = nodePathProbe()) {
+    const gitDir = await git(['rev-parse', '--absolute-git-dir'], cwd).then(out => out.trim(), () => '');
+    if (!gitDir)
+        return 'not a git repository';
+    for (const [name, reason] of BUSY_MARKERS) {
+        if (await exists(join(gitDir, name)))
+            return reason;
+    }
+    return undefined;
+}
+/** The everyday no-op outcome. Named so the poller can tell it apart from a real failure. */
+const NOTHING_PENDING = 'no session changes';
+/**
+ * Stage and commit the pending agent archives under `cwd`, scoped to {@link ARCHIVE_PATHSPEC}.
+ *
+ * `add` before `commit` because a brand-new archive is untracked, and `git commit -- <path>` only
+ * knows paths git already knows. Both are pathspec-scoped, so the staging is as narrow as the
+ * commit and the user's own staged work is neither swept in nor disturbed. Nothing pending returns
+ * early: a pathspec matching no file is a hard error to git, and "no session has been archived here
+ * yet" is not an error at all.
+ *
+ * Never throws: this runs on a background tick with nothing to catch it.
+ */
+export async function commitAgents(cwd, git = nodeGitRunner(), exists = nodePathProbe()) {
+    const busy = await gitBusy(cwd, git, exists);
+    if (busy)
+        return { committed: false, reason: busy };
+    const files = await pendingAgents(cwd, git);
+    if (files.length === 0)
+        return { committed: false, reason: NOTHING_PENDING };
+    try {
+        await git(['add', '--', ARCHIVE_PATHSPEC], cwd);
+        await git(['commit', '-m', commitMessage(files), '--', ARCHIVE_PATHSPEC], cwd);
+        return { committed: true, files };
+    }
+    catch (err) {
+        return { committed: false, reason: errorMessage(err) };
+    }
+}
+/**
+ * Start committing settled agent archives, and return the handle that stops it.
+ *
+ * The idle window is the poll itself: a project whose pending set is byte-identical to the previous
+ * poll's has stopped being written to, so its batch is committed. Anything still moving is recorded
+ * and reconsidered next time, unless it has been dirty past `maxWaitMs`, which forces it through.
+ *
+ * Forgiving throughout — a failed project scan, a busy repo or a rejected commit costs one window
+ * and is retried, never a throw. Owns no timer (E4): the daemon's one clock calls {@link
+ * AgentCommitter.poll}, and the window it debounces on is that cadence.
+ */
+export function startAgentCommitter(opts) {
+    const git = opts.git ?? nodeGitRunner();
+    const exists = opts.exists ?? nodePathProbe();
+    const now = opts.now ?? Date.now;
+    const maxWaitMs = opts.maxWaitMs ?? COMMIT_MAX_WAIT_MS;
+    const pending = new Map();
+    let stopped = false;
+    let running = false;
+    const poll = async () => {
+        if (stopped || running)
+            return;
+        running = true;
+        try {
+            const projects = await opts.projects().catch(() => []);
+            const seen = new Set();
+            for (const project of projects) {
+                if (stopped)
+                    break;
+                seen.add(project.path);
+                const files = await pendingAgents(project.path, git).catch(() => []);
+                if (files.length === 0) {
+                    pending.delete(project.path);
+                    continue;
+                }
+                const fingerprint = files.join('\n');
+                const previous = pending.get(project.path);
+                const since = previous?.since ?? now();
+                // Settled (nothing changed since the last poll), or dirty long enough that waiting for
+                // quiet is no longer worth it.
+                const settled = previous?.fingerprint === fingerprint || now() - since >= maxWaitMs;
+                const loggedReason = previous?.loggedReason;
+                if (!settled) {
+                    pending.set(project.path, { fingerprint, since, loggedReason });
+                    continue;
+                }
+                const outcome = await commitAgents(project.path, git, exists);
+                if (outcome.committed) {
+                    pending.delete(project.path);
+                    opts.log?.(`[framework] committed ${outcome.files.length} session file(s) in ${project.name}`);
+                }
+                else {
+                    // A busy repo or a rejected commit keeps its place, so the next window retries it
+                    // rather than starting the idle count over.
+                    const reason = outcome.reason === NOTHING_PENDING ? undefined : outcome.reason;
+                    // Announced on change only: this is a poll, so logging every failure would repeat the
+                    // same line forever while a project stays stuck.
+                    if (reason !== undefined && reason !== loggedReason) {
+                        opts.log?.(`[framework] session commit failed in ${project.name}: ${reason}`);
+                    }
+                    pending.set(project.path, { fingerprint, since, loggedReason: reason });
+                }
+            }
+            // Drop state for projects that went away, so the map cannot grow without bound.
+            for (const path of [...pending.keys()])
+                if (!seen.has(path))
+                    pending.delete(path);
+        }
+        finally {
+            running = false;
+        }
+    };
+    const flush = async () => {
+        let committed = 0;
+        for (const project of await opts.projects().catch(() => [])) {
+            const outcome = await commitAgents(project.path, git, exists);
+            if (outcome.committed) {
+                pending.delete(project.path);
+                committed++;
+            }
+        }
+        return committed;
+    };
+    return {
+        stop: () => {
+            stopped = true;
+        },
+        poll,
+        flush,
+    };
+}
+//# sourceMappingURL=agent-commit.js.map

package/dist/agent-commit.js.map

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

package/dist/agent-driver.d.ts

@@ -0,0 +1,28 @@
+import type { AgentLocation } from './agent-location.js';
+import { type CreateDriverOptions } from './driver-cli.js';
+import { type ActionsDriverOptions, type Driver } from 'agent-driver';
+import { type CloudDriverOptions } from './driver/cloud.js';
+/**
+ * Build the {@link Driver} for an agent's *target* (#1050): where the turn runs, on top of the agent
+ * axis {@link createDriver} owns. `actions` returns an {@link ActionsDriver} (#934) built from the
+ * resolved owner/repo/token; `web` returns a {@link CloudDriver} (#610), which hands the task to a
+ * Claude Code cloud session; anything else falls through to the local agent driver — byte-identical
+ * to today.
+ *
+ * Kept off {@link createDriver} on purpose: ActionsDriver's owner/repo/token do not fit
+ * {@link CreateDriverOptions}, and folding them in would push GitHub config onto every local agent.
+ */
+export interface CreateAgentDriverOptions extends CreateDriverOptions {
+    /**
+     * Where the agent executes: `local` (this device, the default), `actions` (a GitHub Actions
+     * runner, #1050) or `web` (a Claude Code cloud session, #610).
+     */
+    target?: AgentLocation;
+    /** The Actions runner config, required when {@link target} is `actions`. */
+    actionsConfig?: ActionsDriverOptions;
+    /** The cloud-session config used when {@link target} is `web`. Every field has a default. */
+    cloudConfig?: CloudDriverOptions;
+}
+/** The one place an agent path turns `--run-on` into a real driver. */
+export declare function createAgentDriver(opts: CreateAgentDriverOptions): Driver;
+//# sourceMappingURL=agent-driver.d.ts.map

package/dist/agent-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-driver.d.ts","sourceRoot":"","sources":["../src/agent-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAiB,KAAK,oBAAoB,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AACpF,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAExE;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,oBAAoB,CAAA;IACpC,6FAA6F;IAC7F,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAWxE"}

package/dist/agent-driver.js

@@ -0,0 +1,18 @@
+import { createDriver } from './driver-cli.js';
+import { ActionsDriver } from 'agent-driver';
+import { CloudDriver } from './driver/cloud.js';
+/** The one place an agent path turns `--run-on` into a real driver. */
+export function createAgentDriver(opts) {
+    if (opts.target === 'actions') {
+        if (!opts.actionsConfig) {
+            throw new Error('run target "actions" needs the repo owner/repo and a GitHub token; set a GitHub origin remote and GH_TOKEN');
+        }
+        return new ActionsDriver(opts.actionsConfig);
+    }
+    // `web` needs no configuration of ours: the CLI already holds the account it signs the
+    // cloud session in with, the same auth the local driver runs on.
+    if (opts.target === 'web')
+        return new CloudDriver(opts.cloudConfig ?? {});
+    return createDriver(opts);
+}
+//# sourceMappingURL=agent-driver.js.map

package/dist/agent-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-driver.js","sourceRoot":"","sources":["../src/agent-driver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA4B,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,aAAa,EAA0C,MAAM,cAAc,CAAA;AACpF,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAA;AAwBxE,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,IAA8B;IAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,4GAA4G,CAAC,CAAA;QAC/H,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC9C,CAAC;IACD,uFAAuF;IACvF,iEAAiE;IACjE,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAA;IACzE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC"}

package/dist/agent-id.d.ts

@@ -0,0 +1,13 @@
+/**
+ * An agent's id, derived from the moment it starts. Pure — no node imports — because the sweep
+ * that mints ids ahead of a claim (#1748) is reachable from the dashboard's browser bundle.
+ */
+/** Filesystem-safe, lexicographically-sortable agent id from an ISO start time. */
+export declare function agentIdFromStartedAt(startedAt: string): string;
+/**
+ * The inverse of {@link agentIdFromStartedAt}, for a caller that has the id but not the meta
+ * (#1251): picking which PR is the agent's needs the start time to tell the agent's own PR from a
+ * predecessor's on the same branch name. Undefined for an id that is not one of ours.
+ */
+export declare function startedAtFromAgentId(id: string): string | undefined;
+//# sourceMappingURL=agent-id.d.ts.map

package/dist/agent-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-id.d.ts","sourceRoot":"","sources":["../src/agent-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnE"}

package/dist/agent-id.js

@@ -0,0 +1,20 @@
+/**
+ * An agent's id, derived from the moment it starts. Pure — no node imports — because the sweep
+ * that mints ids ahead of a claim (#1748) is reachable from the dashboard's browser bundle.
+ */
+/** Filesystem-safe, lexicographically-sortable agent id from an ISO start time. */
+export function agentIdFromStartedAt(startedAt) {
+    // ISO is fixed-width, so replacing the `:`/`.` separators keeps lexical order
+    // in step with chronological order — the history list sorts by id alone.
+    return startedAt.replace(/[:.]/g, '-');
+}
+/**
+ * The inverse of {@link agentIdFromStartedAt}, for a caller that has the id but not the meta
+ * (#1251): picking which PR is the agent's needs the start time to tell the agent's own PR from a
+ * predecessor's on the same branch name. Undefined for an id that is not one of ours.
+ */
+export function startedAtFromAgentId(id) {
+    const match = /^(\d{4}-\d{2}-\d{2}T\d{2})-(\d{2})-(\d{2})-(\d{3})Z$/.exec(id);
+    return match ? `${match[1]}:${match[2]}:${match[3]}.${match[4]}Z` : undefined;
+}
+//# sourceMappingURL=agent-id.js.map

package/dist/agent-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-id.js","sourceRoot":"","sources":["../src/agent-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,8EAA8E;IAC9E,yEAAyE;IACzE,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,MAAM,KAAK,GAAG,sDAAsD,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC7E,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AAC/E,CAAC"}

package/dist/agent-location.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Where a run's turns executed, as a run's record names it (D1): this machine, a GitHub Actions
+ * runner, or a Claude Code cloud session. A run started today is local; the other two are read
+ * off records of runs from before the launcher started runs through the project's hook (#1774),
+ * and off the cloud work the bridge still adopts.
+ *
+ * Node-free on purpose, like `driver-names.ts`: the dashboard and the store both name this axis.
+ */
+/** Where an agent executes. */
+export type AgentLocation = 'local' | 'actions' | 'web';
+//# sourceMappingURL=agent-location.d.ts.map

package/dist/agent-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-location.d.ts","sourceRoot":"","sources":["../src/agent-location.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA"}

package/dist/agent-location.js

@@ -0,0 +1,10 @@
+/**
+ * Where a run's turns executed, as a run's record names it (D1): this machine, a GitHub Actions
+ * runner, or a Claude Code cloud session. A run started today is local; the other two are read
+ * off records of runs from before the launcher started runs through the project's hook (#1774),
+ * and off the cloud work the bridge still adopts.
+ *
+ * Node-free on purpose, like `driver-names.ts`: the dashboard and the store both name this axis.
+ */
+export {};
+//# sourceMappingURL=agent-location.js.map

package/dist/agent-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-location.js","sourceRoot":"","sources":["../src/agent-location.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/agent-locks.d.ts

@@ -0,0 +1,3 @@
+/** Run `fn` once every earlier holder of `checkout`'s lock has settled. */
+export declare function withAgentLock<T>(checkout: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=agent-locks.d.ts.map

package/dist/agent-locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-locks.d.ts","sourceRoot":"","sources":["../src/agent-locks.ts"],"names":[],"mappings":"AAwBA,2EAA2E;AAC3E,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAgBzF"}

package/dist/agent-locks.js

@@ -0,0 +1,40 @@
+import { resolve } from 'node:path';
+/**
+ * Serialize the dashboard's own actions against one run's checkout.
+ *
+ * Two clicks on the same finished run (Open PR, and Remove or Delete of its checkout) each run
+ * their own git in that checkout. Unserialized they raced: the loser reported "could not commit
+ * the work this session left uncommitted", and a removal that lost kept a worktree it should have
+ * taken. Both actions are served inside the daemon's own process (the dashboard's RPCs are), so
+ * an in-process lock is the whole fix between them.
+ *
+ * It does NOT coordinate with the run's own tool (#1774), which is another process and reclaims
+ * the checkout itself when the run ends. What keeps those two apart is that the run has to have
+ * ended before the dashboard offers either action, and that the tool's own reclaim refuses a
+ * checkout it cannot take cleanly.
+ *
+ * Keyed by the checkout path, resolved, so the actions against one run contend on one key;
+ * actions against a run whose checkout is already gone key on the project root, where nothing
+ * contends. A waiter chains on the predecessor's *settlement* — a failed removal must not skip
+ * the action waiting behind it — and each caller still gets its own outcome (or failure) back
+ * untouched.
+ */
+const chains = new Map();
+/** Run `fn` once every earlier holder of `checkout`'s lock has settled. */
+export async function withAgentLock(checkout, fn) {
+    const key = resolve(checkout);
+    const prev = chains.get(key) ?? Promise.resolve();
+    const agent = prev.then(fn, fn);
+    // What the next waiter chains on: settlement, never rejection — one failed holder must not
+    // poison every later acquisition of the same key.
+    const settled = agent.then(() => { }, () => { });
+    chains.set(key, settled);
+    try {
+        return await agent;
+    }
+    finally {
+        if (chains.get(key) === settled)
+            chains.delete(key);
+    }
+}
+//# sourceMappingURL=agent-locks.js.map

package/dist/agent-locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-locks.js","sourceRoot":"","sources":["../src/agent-locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAA;AAElD,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,QAAgB,EAAE,EAAoB;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAC/B,2FAA2F;IAC3F,kDAAkD;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CACxB,GAAG,EAAE,GAAE,CAAC,EACR,GAAG,EAAE,GAAE,CAAC,CACT,CAAA;IACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IACxB,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAA;IACpB,CAAC;YAAS,CAAC;QACT,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC;AACH,CAAC"}

package/dist/agent-messages.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The live-chat message channel (#714): the user's own turns into a running agent.
+ *
+ * An agent's await gates (#337) are the agent asking the user; this is the reverse —
+ * the user speaking to the agent unprompted. Each message continues the *same*
+ * agent session (`claude --resume <id>`), so the conversation keeps its full
+ * context. The run loop drains this once the work settles; a daemon-spawned
+ * session then ends itself when the queue is idle (#1390) — a follow-up message
+ * reopens the conversation via `--resume`, like Claude Code web — while an agent
+ * with its own terminal dashboard keeps the old stay-open wait, since that
+ * surface has no daemon to resume through.
+ *
+ * Wired only when an interactive channel can deliver messages (a live dashboard /
+ * daemon over `control.jsonl`). A headless agent gets no {@link AgentMessages}, so its
+ * loop ends when the agent stops asking — byte-identical to before this existed.
+ */
+/**
+ * One user chat message, plus the surface it arrived through (#917).
+ */
+export interface ChatMessage {
+    text: string;
+}
+/** A source of user chat messages for a running agent. */
+export interface AgentMessages {
+    /**
+     * The next user message. Returns an already-queued message immediately (drain
+     * between turns); otherwise waits for one (stay-open). Resolves `undefined` when
+     * the agent should stop waiting — the signal aborted (a Stop, or an answer marked stop) or the
+     * source was closed — so the loop ends cleanly rather than hanging.
+     */
+    next(signal?: AbortSignal): Promise<ChatMessage | undefined>;
+    /**
+     * The next user message only if one has already arrived — never waits (#1390). What the
+     * end-of-run drain asks: a queued follow-up is processed, an idle queue ends the session.
+     * `undefined` once closed, so an aborted agent never starts a new turn off a stale message.
+     */
+    takeQueued(): ChatMessage | undefined;
+}
+/**
+ * A {@link AgentMessages} the control channel feeds ({@link push}) and the run loop
+ * drains ({@link next}). A message that arrives with a waiter parked hands off
+ * directly; otherwise it queues until the next `next()`. FIFO in both directions.
+ */
+export declare class AgentMessageQueue implements AgentMessages {
+    private readonly pending;
+    private readonly waiters;
+    private closed;
+    /** Enqueue a user message (or hand it to a parked waiter). No-op once closed. */
+    push(text: string): void;
+    /** Stop the chat: wake every parked waiter with `undefined` so their loops end. */
+    close(): void;
+    takeQueued(): ChatMessage | undefined;
+    next(signal?: AbortSignal): Promise<ChatMessage | undefined>;
+}
+//# sourceMappingURL=agent-messages.d.ts.map

package/dist/agent-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages.d.ts","sourceRoot":"","sources":["../src/agent-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;IAC5D;;;;OAIG;IACH,UAAU,IAAI,WAAW,GAAG,SAAS,CAAA;CACtC;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAChF,OAAO,CAAC,MAAM,CAAQ;IAEtB,iFAAiF;IACjF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMvB;IAED,mFAAmF;IACnF,KAAK,IAAI,IAAI,CAIZ;IAED,UAAU,IAAI,WAAW,GAAG,SAAS,CAGpC;IAED,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAiB3D;CACF"}

package/dist/agent-messages.js

@@ -0,0 +1,73 @@
+/**
+ * The live-chat message channel (#714): the user's own turns into a running agent.
+ *
+ * An agent's await gates (#337) are the agent asking the user; this is the reverse —
+ * the user speaking to the agent unprompted. Each message continues the *same*
+ * agent session (`claude --resume <id>`), so the conversation keeps its full
+ * context. The run loop drains this once the work settles; a daemon-spawned
+ * session then ends itself when the queue is idle (#1390) — a follow-up message
+ * reopens the conversation via `--resume`, like Claude Code web — while an agent
+ * with its own terminal dashboard keeps the old stay-open wait, since that
+ * surface has no daemon to resume through.
+ *
+ * Wired only when an interactive channel can deliver messages (a live dashboard /
+ * daemon over `control.jsonl`). A headless agent gets no {@link AgentMessages}, so its
+ * loop ends when the agent stops asking — byte-identical to before this existed.
+ */
+/**
+ * A {@link AgentMessages} the control channel feeds ({@link push}) and the run loop
+ * drains ({@link next}). A message that arrives with a waiter parked hands off
+ * directly; otherwise it queues until the next `next()`. FIFO in both directions.
+ */
+export class AgentMessageQueue {
+    pending = [];
+    waiters = [];
+    closed = false;
+    /** Enqueue a user message (or hand it to a parked waiter). No-op once closed. */
+    push(text) {
+        if (this.closed)
+            return;
+        const message = { text };
+        const waiter = this.waiters.shift();
+        if (waiter)
+            waiter(message);
+        else
+            this.pending.push(message);
+    }
+    /** Stop the chat: wake every parked waiter with `undefined` so their loops end. */
+    close() {
+        this.closed = true;
+        let waiter;
+        while ((waiter = this.waiters.shift()))
+            waiter(undefined);
+    }
+    takeQueued() {
+        if (this.closed)
+            return undefined;
+        return this.pending.shift();
+    }
+    next(signal) {
+        const queued = this.pending.shift();
+        if (queued !== undefined)
+            return Promise.resolve(queued);
+        if (this.closed || signal?.aborted)
+            return Promise.resolve(undefined);
+        return new Promise(resolve => {
+            const waiter = (message) => {
+                if (signal)
+                    signal.removeEventListener('abort', onAbort);
+                resolve(message);
+            };
+            const onAbort = () => {
+                const i = this.waiters.indexOf(waiter);
+                if (i >= 0)
+                    this.waiters.splice(i, 1);
+                resolve(undefined);
+            };
+            this.waiters.push(waiter);
+            if (signal)
+                signal.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+}
+//# sourceMappingURL=agent-messages.js.map

package/dist/agent-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages.js","sourceRoot":"","sources":["../src/agent-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA0BH;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,GAAkB,EAAE,CAAA;IAC3B,OAAO,GAAsD,EAAE,CAAA;IACxE,MAAM,GAAG,KAAK,CAAA;IAEtB,iFAAiF;IACjF,IAAI,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,MAAM,OAAO,GAAgB,EAAE,IAAI,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACnC,IAAI,MAAM;YAAE,MAAM,CAAC,OAAO,CAAC,CAAA;;YACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAED,mFAAmF;IACnF,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,MAAgE,CAAA;QACpE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IAC3D,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IAC7B,CAAC;IAED,IAAI,CAAC,MAAoB;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACnC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACxD,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACrE,OAAO,IAAI,OAAO,CAA0B,OAAO,CAAC,EAAE;YACpD,MAAM,MAAM,GAAG,CAAC,OAAgC,EAAQ,EAAE;gBACxD,IAAI,MAAM;oBAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;gBACxD,OAAO,CAAC,OAAO,CAAC,CAAA;YAClB,CAAC,CAAA;YACD,MAAM,OAAO,GAAG,GAAS,EAAE;gBACzB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBACtC,IAAI,CAAC,IAAI,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBACrC,OAAO,CAAC,SAAS,CAAC,CAAA;YACpB,CAAC,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACzB,IAAI,MAAM;gBAAE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACvE,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/agent-names.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The agent vocabulary (#542), node-free so every surface shares one copy: the CLI's
+ * `--agent` flag, the registry's preference sanitizer, and the dashboard bundle — which must
+ * not import the driver layer (it spawns processes), and whose "kept local" copies existed
+ * only because this list used to live beside those imports. Adding an agent is one entry
+ * here plus its driver; the dashboard's per-agent UI table is keyed by {@link AgentName}, so
+ * a missing entry there is a compile error, not a silent gap.
+ */
+/** The agents the framework can drive, in the order surfaces list them. */
+export declare const AGENTS: readonly ["claude", "codex"];
+/** An agent `--agent` can name. */
+export type AgentName = (typeof AGENTS)[number];
+/** Whether `value` names an agent we can drive. */
+export declare function isAgentName(value: string | undefined): value is AgentName;
+/** How each agent reads in a sentence or on a button. */
+export declare const AGENT_LABELS: Record<AgentName, string>;
+/**
+ * The agent behind a driver name (#831): a run records the driver that ran it
+ * (`claude-code`), while `--agent` takes the agent name (`claude`). `undefined` for a driver
+ * no agent claims (the fake driver, or a record from a newer version). An agent whose driver
+ * name differs from its own needs a case here, like claude's does.
+ */
+export declare function agentForDriver(driver: string | undefined): AgentName | undefined;
+//# sourceMappingURL=agent-names.d.ts.map

package/dist/agent-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-names.d.ts","sourceRoot":"","sources":["../src/agent-names.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,MAAM,8BAA+B,CAAA;AAElD,mCAAmC;AACnC,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAEzE;AAED,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAGlD,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAKhF"}