@openagt/agent-runner 0.0.1

package/dist/git-host.js

@@ -0,0 +1,26 @@
+import { readProvidedCommand, runPackageCommand } from '@openagt/agent-data';
+const NO_GIT_HOST = 'this project has no git host package';
+/** The git host the project declares, run as a command. */
+export const projectGitHost = {
+    async requestOfBranch(repo, branch) {
+        const command = await readProvidedCommand(repo, 'git-host').catch(() => undefined);
+        if (!command)
+            return undefined;
+        const result = await runPackageCommand(repo, command, ['requests', '--branch', branch]);
+        if (!result.ok || !Array.isArray(result.output))
+            return undefined;
+        const first = result.output[0];
+        return first && typeof first.number === 'number' && typeof first.url === 'string' ? { number: first.number, url: first.url } : undefined;
+    },
+    async mergeRequest(repo, number) {
+        const command = await readProvidedCommand(repo, 'git-host').catch(() => undefined);
+        if (!command)
+            return { outcome: 'failed', error: NO_GIT_HOST };
+        const result = await runPackageCommand(repo, command, ['merge', String(number)]);
+        if (!result.ok)
+            return { outcome: 'failed', error: result.error };
+        const outcome = result.output?.outcome;
+        return outcome === 'auto-armed' || outcome === 'merged' || outcome === 'watching' ? { outcome } : { outcome: 'failed', error: `the git host answered no outcome for pull request ${number}` };
+    },
+};
+//# sourceMappingURL=git-host.js.map

package/dist/git-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-host.js","sourceRoot":"","sources":["../src/git-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AA6B5E,MAAM,WAAW,GAAG,sCAAsC,CAAA;AAE1D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM;QAChC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAClF,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QAC9B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;QACvF,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAA;QACjE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAoD,CAAA;QACjF,OAAO,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1I,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM;QAC7B,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAClF,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;QAC9D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAChF,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;QACjE,MAAM,OAAO,GAAI,MAAM,CAAC,MAAuC,EAAE,OAAO,CAAA;QACxE,OAAO,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,qDAAqD,MAAM,EAAE,EAAE,CAAA;IAC/L,CAAC;CACF,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { RUNNER_DIR, RUNS_DIR, RUNNER_CONFIG, DASHBOARD_DIR, DASHBOARD_HOOKS } from './names.js';
+export { readConfig, readPersonal, configFile } from './config.js';
+export { markerCard, writeMarker, withdrawMarker, recordRun, runnerMark, isPublish, PUBLISH_LEVELS, type Publish, type RunnerMark } from './records.js';
+export { runCommand, resumeRun, runIdFrom, addedLine, HOLD_MERGE_LINE, PUBLISH_LINES, type RunOptions, type ResumeOptions, type RunOutcome } from './run.js';
+export { sweep, type SweepDeps, type SweepResult } from './sweep.js';
+export { childEndedLine, tellParent, type ChildEnd, type ParentDeps } from './parent.js';
+export { runProject, resumeProject, detachRun, detachResume, readyToRun, spawnRun, spawnResume, resumeDetached, driverFor, isDriverName, DRIVER_NAMES, AGENT_ID_ENV, type DriverName, type SpawnedRun } from './runner.js';
+export { isPidAlive, runLockPath, runStderrPath } from './run-lock.js';
+export { projectGitHost, type GitHost, type BranchRequest, type MergeOutcome } from './git-host.js';
+export { readLiveCard, readLiveDiary, endLiveCard, liveDir, inboxPath, LIVE_DIR, INBOX_FILE } from './live-card.js';
+export { initHooks, writeHookLines, HOOK_LINES, type InitOutcome } from './init.js';
+export { runCli, USAGE, type CliIo, type CliRefusal } from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AACvJ,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAC5J,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAC1N,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AACnG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { RUNNER_DIR, RUNS_DIR, RUNNER_CONFIG, DASHBOARD_DIR, DASHBOARD_HOOKS } from './names.js';
+export { readConfig, readPersonal, configFile } from './config.js';
+export { markerCard, writeMarker, withdrawMarker, recordRun, runnerMark, isPublish, PUBLISH_LEVELS } from './records.js';
+export { runCommand, resumeRun, runIdFrom, addedLine, HOLD_MERGE_LINE, PUBLISH_LINES } from './run.js';
+export { sweep } from './sweep.js';
+export { childEndedLine, tellParent } from './parent.js';
+export { runProject, resumeProject, detachRun, detachResume, readyToRun, spawnRun, spawnResume, resumeDetached, driverFor, isDriverName, DRIVER_NAMES, AGENT_ID_ENV } from './runner.js';
+export { isPidAlive, runLockPath, runStderrPath } from './run-lock.js';
+export { projectGitHost } from './git-host.js';
+export { readLiveCard, readLiveDiary, endLiveCard, liveDir, inboxPath, LIVE_DIR, INBOX_FILE } from './live-card.js';
+export { initHooks, writeHookLines, HOOK_LINES } from './init.js';
+export { runCli, USAGE } from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAiC,MAAM,cAAc,CAAA;AACvJ,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAwD,MAAM,UAAU,CAAA;AAC5J,OAAO,EAAE,KAAK,EAAoC,MAAM,YAAY,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAkC,MAAM,aAAa,CAAA;AACxF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAoC,MAAM,aAAa,CAAA;AAC1N,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,cAAc,EAAuD,MAAM,eAAe,CAAA;AACnG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAoB,MAAM,WAAW,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,KAAK,EAA+B,MAAM,UAAU,CAAA"}

package/dist/init.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `init`: this tool's lines written into a dashboard's hooks file, so a project added to the
+ * dashboard can check, start and resume a run with nothing typed by hand. The tool writes its own
+ * lines: the dashboard runs `init` when a project is added (the package declares it under
+ * `framework.hooks` in its package.json) and holds no copy of them, and a project that wants
+ * another tool writes that tool's lines. The writer takes any tool's lines, so
+ * another tool's `init` (a scheduler's) writes its own through it.
+ *
+ * The lines name the tool bare, with no `npx`: the dashboard runs a line with the project's
+ * installed tools and then its built-in packages' on the PATH, so nothing is fetched from npm to run one.
+ *
+ * A person's file is never overwritten. A one-line key already there keeps its line, whatever
+ * it says; a list (`open`, `close`) gains a line only when it lacks it; comments and
+ * the other keys stay as they were.
+ */
+/** The lines, in the order a new file lists them: one line each. */
+export declare const HOOK_LINES: Readonly<Record<string, string | readonly string[]>>;
+export type InitOutcome = {
+    ok: true;
+    file: string;
+    added: string[];
+    kept: string[];
+} | {
+    ok: false;
+    reason: 'no-dashboard' | 'unreadable';
+    file: string;
+    detail?: string;
+};
+/** This tool's lines into the dashboard's hooks file. */
+export declare function initHooks(repo: string): Promise<InitOutcome>;
+/**
+ * Write `lines` into `<repo>/.the-framework/hooks.yml`: a key is a one-line hook when its line is
+ * a string, a list (`open`, `close`) when it is an array. The dashboard's directory must be there
+ * already (the dashboard makes it when the project is added, and hides it from git); without it
+ * nothing is written. `added` names the keys that gained a line, `kept` the ones already set
+ * otherwise.
+ */
+export declare function writeHookLines(repo: string, lines: Readonly<Record<string, string | readonly string[]>>): Promise<InitOutcome>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AAEH,oEAAoE;AACpE,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAI3E,CAAA;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvF,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAE5D;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CA+CpI"}

package/dist/init.js

@@ -0,0 +1,104 @@
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { isMap, isSeq, parseDocument } from 'yaml';
+import { DASHBOARD_DIR, DASHBOARD_HOOKS } from './names.js';
+/**
+ * `init`: this tool's lines written into a dashboard's hooks file, so a project added to the
+ * dashboard can check, start and resume a run with nothing typed by hand. The tool writes its own
+ * lines: the dashboard runs `init` when a project is added (the package declares it under
+ * `framework.hooks` in its package.json) and holds no copy of them, and a project that wants
+ * another tool writes that tool's lines. The writer takes any tool's lines, so
+ * another tool's `init` (a scheduler's) writes its own through it.
+ *
+ * The lines name the tool bare, with no `npx`: the dashboard runs a line with the project's
+ * installed tools and then its built-in packages' on the PATH, so nothing is fetched from npm to run one.
+ *
+ * A person's file is never overwritten. A one-line key already there keeps its line, whatever
+ * it says; a list (`open`, `close`) gains a line only when it lacks it; comments and
+ * the other keys stay as they were.
+ */
+/** The lines, in the order a new file lists them: one line each. */
+export const HOOK_LINES = {
+    start: 'agent-runner run --detach "$PROMPT" ${DRIVER:+--driver "$DRIVER"} ${MODEL:+--model "$MODEL"} ${THEN:+--then "$THEN"} ${PUBLISH:+--publish "$PUBLISH"} ${BASE:+--base "$BASE"}',
+    resume: 'agent-runner run --detach --resume "$RUN_ID" ${TEXT:+"$TEXT"} ${ANSWER:+--answer "$ANSWER"}',
+    check: 'agent-runner check ${DRIVER:+--driver "$DRIVER"}',
+};
+/** This tool's lines into the dashboard's hooks file. */
+export function initHooks(repo) {
+    return writeHookLines(repo, HOOK_LINES);
+}
+/**
+ * Write `lines` into `<repo>/.the-framework/hooks.yml`: a key is a one-line hook when its line is
+ * a string, a list (`open`, `close`) when it is an array. The dashboard's directory must be there
+ * already (the dashboard makes it when the project is added, and hides it from git); without it
+ * nothing is written. `added` names the keys that gained a line, `kept` the ones already set
+ * otherwise.
+ */
+export async function writeHookLines(repo, lines) {
+    const file = join(repo, DASHBOARD_HOOKS);
+    if (!(await isDirectory(join(repo, DASHBOARD_DIR))))
+        return { ok: false, reason: 'no-dashboard', file };
+    let raw = '';
+    try {
+        raw = await readFile(file, 'utf8');
+    }
+    catch {
+        // No file yet: every line is added.
+    }
+    const doc = parseDocument(raw);
+    const error = doc.errors[0];
+    if (error)
+        return { ok: false, reason: 'unreadable', file, detail: error.message.split('\n')[0] ?? error.message };
+    // An empty file, or one of comments only, is an empty map.
+    if (doc.contents === null)
+        doc.contents = doc.createNode({});
+    if (!isMap(doc.contents))
+        return { ok: false, reason: 'unreadable', file, detail: 'the file is not a YAML map' };
+    const added = [];
+    const kept = [];
+    for (const [key, line] of Object.entries(lines)) {
+        const present = doc.get(key, true);
+        if (typeof line === 'string') {
+            if (present == null) {
+                doc.set(key, line);
+                added.push(key);
+            }
+            else if (String(doc.get(key)).trim() !== line) {
+                kept.push(key);
+            }
+            continue;
+        }
+        if (present == null) {
+            doc.set(key, doc.createNode([...line]));
+            added.push(key);
+        }
+        else if (isSeq(present)) {
+            const lines = present.items.map(item => String(isScalarLike(item) ? item.value : item).trim());
+            const missing = line.filter(l => !lines.includes(l));
+            for (const l of missing)
+                present.add(doc.createNode(l));
+            if (missing.length > 0)
+                added.push(key);
+        }
+        else {
+            kept.push(key);
+        }
+    }
+    if (added.length > 0) {
+        await mkdir(dirname(file), { recursive: true });
+        await writeFile(file, doc.toString({ lineWidth: 0 }));
+    }
+    return { ok: true, file, added, kept };
+}
+function isScalarLike(item) {
+    return typeof item === 'object' && item !== null && 'value' in item;
+}
+async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/live-card.d.ts

@@ -0,0 +1,27 @@
+import { type AnyDiaryLine, type RunCard, type RunStatus } from '@openagt/skill-logs';
+/**
+ * A run's live record: the card and the diary agent-driver keeps under `.the-framework/` in the
+ * run's checkout, in the run record's shape, while the agent works. The dashboard reads them
+ * there; the run copies them onto the `agent-data` branch unchanged when it ends; the sweep
+ * reads them to find a run whose process died, and closes them from outside.
+ */
+/** The dashboard's directory in a checkout, where the two files live. */
+export declare const LIVE_DIR = ".the-framework";
+/** The inbox's file name under the live directory: what reaches the agent from outside. */
+export declare const INBOX_FILE = "inbox.jsonl";
+export declare function liveDir(checkout: string): string;
+export declare function inboxPath(checkout: string): string;
+/**
+ * Keep the live directory out of git in this checkout alone, so the tree stays clean for the
+ * reclaim: a `.gitignore` of `*` inside it. Never a rule in the repository's shared exclude file,
+ * which every checkout reads, the project's own included, where it would stop the dashboard from
+ * tracking its directory. A `.gitignore` already there is kept as it is.
+ */
+export declare function hideLiveDir(checkout: string): Promise<void>;
+/** A checkout's live card, or `undefined` when it holds none, it does not parse, or it is not this tool's (no mark). */
+export declare function readLiveCard(checkout: string, id: string): Promise<RunCard | undefined>;
+/** A checkout's live diary, every line that parses. */
+export declare function readLiveDiary(checkout: string, id: string): Promise<AnyDiaryLine[]>;
+/** Close a checkout's live record from outside its process: the `ended` line appended, the card's status set. Best-effort. */
+export declare function endLiveCard(checkout: string, card: RunCard, status: Exclude<RunStatus, 'running'>, detail: string, at: string): Promise<RunCard>;
+//# sourceMappingURL=live-card.d.ts.map

package/dist/live-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-card.d.ts","sourceRoot":"","sources":["../src/live-card.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAG/G;;;;;GAKG;AAEH,yEAAyE;AACzE,eAAO,MAAM,QAAQ,mBAAmB,CAAA;AAExC,2FAA2F;AAC3F,eAAO,MAAM,UAAU,gBAAgB,CAAA;AAEvC,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjE;AAED,wHAAwH;AACxH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAK7F;AAED,uDAAuD;AACvD,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzF;AAED,8HAA8H;AAC9H,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKtJ"}

package/dist/live-card.js

@@ -0,0 +1,56 @@
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { logCardFile, logDiaryFile } from '@openagt/agent-driver';
+import { parseDiary, parseRunCard } from '@openagt/skill-logs';
+import { runnerMark } from './records.js';
+/**
+ * A run's live record: the card and the diary agent-driver keeps under `.the-framework/` in the
+ * run's checkout, in the run record's shape, while the agent works. The dashboard reads them
+ * there; the run copies them onto the `agent-data` branch unchanged when it ends; the sweep
+ * reads them to find a run whose process died, and closes them from outside.
+ */
+/** The dashboard's directory in a checkout, where the two files live. */
+export const LIVE_DIR = '.the-framework';
+/** The inbox's file name under the live directory: what reaches the agent from outside. */
+export const INBOX_FILE = 'inbox.jsonl';
+export function liveDir(checkout) {
+    return join(checkout, LIVE_DIR);
+}
+export function inboxPath(checkout) {
+    return join(liveDir(checkout), INBOX_FILE);
+}
+/**
+ * Keep the live directory out of git in this checkout alone, so the tree stays clean for the
+ * reclaim: a `.gitignore` of `*` inside it. Never a rule in the repository's shared exclude file,
+ * which every checkout reads, the project's own included, where it would stop the dashboard from
+ * tracking its directory. A `.gitignore` already there is kept as it is.
+ */
+export async function hideLiveDir(checkout) {
+    const dir = liveDir(checkout);
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, '.gitignore'), '*\n', { flag: 'wx' }).catch((err) => {
+        if (err.code !== 'EEXIST')
+            throw err;
+    });
+}
+/** A checkout's live card, or `undefined` when it holds none, it does not parse, or it is not this tool's (no mark). */
+export async function readLiveCard(checkout, id) {
+    const raw = await readFile(join(liveDir(checkout), logCardFile(id)), 'utf8').catch(() => undefined);
+    if (raw === undefined)
+        return undefined;
+    const card = parseRunCard(raw);
+    return card && runnerMark(card) ? card : undefined;
+}
+/** A checkout's live diary, every line that parses. */
+export async function readLiveDiary(checkout, id) {
+    const raw = await readFile(join(liveDir(checkout), logDiaryFile(id)), 'utf8').catch(() => '');
+    return parseDiary(raw);
+}
+/** Close a checkout's live record from outside its process: the `ended` line appended, the card's status set. Best-effort. */
+export async function endLiveCard(checkout, card, status, detail, at) {
+    const ended = { ...card, status, endedAt: at };
+    await appendFile(join(liveDir(checkout), logDiaryFile(card.id)), JSON.stringify({ kind: 'ended', status, detail, at }) + '\n').catch(() => { });
+    await writeFile(join(liveDir(checkout), logCardFile(card.id)), JSON.stringify(ended, null, 2) + '\n').catch(() => { });
+    return ended;
+}
+//# sourceMappingURL=live-card.js.map

package/dist/live-card.js.map

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

package/dist/names.d.ts

@@ -0,0 +1,12 @@
+/** The names the package hangs off. No node imports. */
+/** The tool's own directory at the repository root, hidden from git by the tool itself. */
+export declare const RUNNER_DIR = ".agent-runner";
+/** Under the tool's directory: one lock and one stderr file per run. */
+export declare const RUNS_DIR = "runs";
+/** The dashboard's directory in a project it knows: made and hidden from git when the project is added. */
+export declare const DASHBOARD_DIR = ".the-framework";
+/** The dashboard's hooks file, the lines it runs for the project: where `init` writes this tool's. */
+export declare const DASHBOARD_HOOKS = ".the-framework/hooks.yml";
+/** Under the tool's directory: this machine's settings for the tool, the `ended:` line and the `personal:` parts. */
+export declare const RUNNER_CONFIG = "config.yml";
+//# sourceMappingURL=names.d.ts.map

package/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,2FAA2F;AAC3F,eAAO,MAAM,UAAU,kBAAkB,CAAA;AAEzC,wEAAwE;AACxE,eAAO,MAAM,QAAQ,SAAS,CAAA;AAE9B,2GAA2G;AAC3G,eAAO,MAAM,aAAa,mBAAmB,CAAA;AAE7C,sGAAsG;AACtG,eAAO,MAAM,eAAe,6BAA+B,CAAA;AAE3D,qHAAqH;AACrH,eAAO,MAAM,aAAa,eAAe,CAAA"}

package/dist/names.js

@@ -0,0 +1,12 @@
+/** The names the package hangs off. No node imports. */
+/** The tool's own directory at the repository root, hidden from git by the tool itself. */
+export const RUNNER_DIR = '.agent-runner';
+/** Under the tool's directory: one lock and one stderr file per run. */
+export const RUNS_DIR = 'runs';
+/** The dashboard's directory in a project it knows: made and hidden from git when the project is added. */
+export const DASHBOARD_DIR = '.the-framework';
+/** The dashboard's hooks file, the lines it runs for the project: where `init` writes this tool's. */
+export const DASHBOARD_HOOKS = `${DASHBOARD_DIR}/hooks.yml`;
+/** Under the tool's directory: this machine's settings for the tool, the `ended:` line and the `personal:` parts. */
+export const RUNNER_CONFIG = 'config.yml';
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAA;AAEzC,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE9B,2GAA2G;AAC3G,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAA;AAE7C,sGAAsG;AACtG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,aAAa,YAAY,CAAA;AAE3D,qHAAqH;AACrH,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA"}

package/dist/parent.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A run started for another run, its parent (`run --parent <id>`), tells the parent when it ends:
+ * one line saying which run, how it ended, and its last words. The line reaches the parent the way
+ * a person's message reaches a run: into its inbox while it works, as a resume once it has ended.
+ * Nothing waits for a child: the parent's agent ends its turn, and the line is its next prompt.
+ */
+/** How a run ended, as its parent is told. */
+export interface ChildEnd {
+    id: string;
+    status: string;
+    /** Why, when the run did not end well. */
+    detail?: string;
+    /** The question the run stopped on, when it ended waiting. */
+    question?: string;
+    /** The branch the run's work is on, when it still exists. */
+    branch?: string;
+    pr?: {
+        url: string;
+    };
+    /** The agent's answer on its last turn. */
+    lastWords?: string;
+}
+/** The line a parent gets: which run, how it ended, where its work is, and its last words. */
+export declare function childEndedLine(end: ChildEnd): string;
+export interface ParentDeps {
+    host: string;
+    /** Whether a pid is a live process here. */
+    isAlive: (pid: number) => boolean;
+    /** Continue an ended run in its own process, with a text or an answer. Absent, an ended parent is not told. */
+    resume?: (id: string, line: {
+        text: string;
+    } | {
+        answer: string;
+    }) => Promise<void>;
+    log: (line: string) => void;
+    /** Whether the parent is working; read off its live card when absent. */
+    isWorking?: (repo: string, id: string) => Promise<boolean>;
+}
+/**
+ * Hand one line to the parent run. A parent that is working takes it from its inbox when its turn
+ * ends. A parent that has ended is continued with it. A parent that ends while the line is on its
+ * way would leave it in an inbox nobody reads, so the parent is looked at again after the write,
+ * and what is still in the inbox then is taken back and continues the parent instead. Never
+ * throws: whatever goes wrong is one line on `log`, and the child ends as it ended.
+ */
+export declare function tellParent(repo: string, parent: string, text: string, deps: ParentDeps): Promise<void>;
+//# sourceMappingURL=parent.d.ts.map

package/dist/parent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent.d.ts","sourceRoot":"","sources":["../src/parent.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACpB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAQpD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,+GAA+G;IAC/G,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnF,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC3D;AASD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5G"}

package/dist/parent.js

@@ -0,0 +1,52 @@
+import { appendInbox, takeInbox } from '@openagt/agent-driver';
+import { worktreePath } from '@openagt/skill-branches';
+import { inboxPath, readLiveCard } from './live-card.js';
+import { runnerMark } from './records.js';
+/** The line a parent gets: which run, how it ended, where its work is, and its last words. */
+export function childEndedLine(end) {
+    const lines = [`The run ${end.id}, started for this run, ended ${end.status}${end.detail ? `: ${end.detail}` : ''}.`];
+    if (end.question !== undefined)
+        lines.push(`It is waiting on a question: ${end.question.replace(/\s+/g, ' ').trim()}`);
+    if (end.branch !== undefined)
+        lines.push(`Its work is on the branch ${end.branch}.`);
+    if (end.pr)
+        lines.push(`Its pull request: ${end.pr.url}`);
+    const words = end.lastWords?.trim();
+    if (words)
+        lines.push('', 'Its last words:', words);
+    return lines.join('\n');
+}
+/** Whether the run's live card says it is working, on this machine, under a process that is alive. */
+async function isRunWorking(repo, id, deps) {
+    const card = await readLiveCard(worktreePath(repo, id), id);
+    const mark = card && runnerMark(card);
+    return card?.status === 'running' && mark !== undefined && mark.host === deps.host && mark.pid !== undefined && deps.isAlive(mark.pid);
+}
+/**
+ * Hand one line to the parent run. A parent that is working takes it from its inbox when its turn
+ * ends. A parent that has ended is continued with it. A parent that ends while the line is on its
+ * way would leave it in an inbox nobody reads, so the parent is looked at again after the write,
+ * and what is still in the inbox then is taken back and continues the parent instead. Never
+ * throws: whatever goes wrong is one line on `log`, and the child ends as it ended.
+ */
+export async function tellParent(repo, parent, text, deps) {
+    try {
+        const isWorking = deps.isWorking ?? ((r, id) => isRunWorking(r, id, deps));
+        let lines = [{ kind: 'message', text }];
+        if (await isWorking(repo, parent)) {
+            const inbox = inboxPath(worktreePath(repo, parent));
+            await appendInbox(inbox, lines[0]);
+            if (await isWorking(repo, parent))
+                return;
+            lines = await takeInbox(inbox);
+        }
+        if (!deps.resume)
+            return;
+        for (const stranded of lines)
+            await deps.resume(parent, stranded.kind === 'message' ? { text: stranded.text } : { answer: stranded.answer });
+    }
+    catch (err) {
+        deps.log(`[agent-runner] the parent run ${parent} could not be told: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=parent.js.map

package/dist/parent.js.map

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

package/dist/records.d.ts

@@ -0,0 +1,81 @@
+import type { FileBranchWrite } from '@openagt/agent-data';
+import { type AnyDiaryLine, type LogsDeps, type RunCard } from '@openagt/skill-logs';
+/**
+ * A run in flight is a run record (#1774): the `logs` skill's card on the project's `agent-data`
+ * branch, written before the agent is spawned with `status: running` and this tool's own mark
+ * under `caller`, and written again when the run ends — same id, same file — with how it went.
+ * One file for the run's whole life, and every machine that shares the branch reads the same
+ * running cards (a scheduler counts them against its caps). No pid is held anywhere: a restart
+ * loses nothing.
+ *
+ * A running card from another machine is that machine's: only its own sweep, or a person, changes
+ * it. A machine that never comes back leaves its card running, on purpose: nothing here guesses that a run it cannot see is dead.
+ */
+/** How far a run takes its work when its agent finishes: a commit, its branch pushed, its pull request, or the request set to merge once its checks pass. */
+export declare const PUBLISH_LEVELS: readonly ['commit', 'branch', 'pr', 'merge'];
+export type Publish = (typeof PUBLISH_LEVELS)[number];
+export declare function isPublish(value: unknown): value is Publish;
+/** This tool's mark on a card, under `caller.runner`. */
+export interface RunnerMark {
+    /** The machine that started it. */
+    host: string;
+    /** The run's process on that machine, while it runs. */
+    pid?: number;
+    /** The prompt a fresh agent is given once the run ends done with a pull request, the run's id after it (`run --then`). */
+    then?: string;
+    /** How far the run takes its work when its agent finishes (`run --publish`): a commit, the branch, its pull request, or the request set to merge; absent, only what its prompt asks. */
+    publish?: Publish;
+    /** The run this one was started for, told when this one ends (`run --parent`). */
+    parent?: string;
+    /** The branch this run's own branch started from (`run --base`); origin's default branch when absent. */
+    base?: string;
+    /** The commit this run's own branch was made at: where the run's own work begins. Absent for a run given a branch that existed. */
+    baseCommit?: string;
+}
+/** The mark a card carries, or `undefined` for a run this tool did not start. */
+export declare function runnerMark(card: RunCard): RunnerMark | undefined;
+/** What a mark keeps for the run's whole life, a resume included: its follow-up, its publish level, its parent, where it started. */
+export declare function lasting(mark: {
+    then?: unknown;
+    publish?: unknown;
+    parent?: unknown;
+    base?: unknown;
+    baseCommit?: unknown;
+}): Pick<RunnerMark, 'then' | 'publish' | 'parent' | 'base' | 'baseCommit'>;
+/** The card a run starts with. */
+export declare function markerCard(run: {
+    id: string;
+    startedAt: string;
+    prompt: string;
+    driver: string;
+    model?: string;
+    mark: RunnerMark;
+}): RunCard;
+/**
+ * What a reader of the card finds beside `host`, outside this tool's mark: the run's parent, the
+ * branch it was started from when it was told one, and the commit its own work begins at, which
+ * its changes are measured from.
+ */
+export declare function forReaders(mark: Pick<RunnerMark, 'parent' | 'base' | 'baseCommit'>): {
+    parent?: string;
+    base?: string;
+    baseCommit?: string;
+};
+/** What the reclaim of a run's checkout is told: the commit its branch was made at, when its mark names one. */
+export declare function startOf(card: RunCard): {
+    from?: string;
+};
+/** Put the run's card on the branch before its agent exists. The outcome says whether it reached origin. */
+export declare function writeMarker(repo: string, card: RunCard, deps?: LogsDeps): Promise<FileBranchWrite>;
+/** Take a marker back: a scheduler lost a cap to another machine's marker, so this run never starts. */
+export declare function withdrawMarker(repo: string, id: string, deps?: LogsDeps): Promise<FileBranchWrite>;
+/** Record how a run went: its card and its diary, over the marker. */
+export declare function recordRun(repo: string, card: RunCard, diary: readonly AnyDiaryLine[], deps?: LogsDeps): Promise<FileBranchWrite>;
+/**
+ * Record a run again without its branch when the reclaim deleted that branch: one that held
+ * nothing goes with its checkout, and the record must not name a branch that is gone. Written
+ * after the reclaim rather than reclaiming first, so the record never says `running` with no
+ * checkout behind it. Nothing is written when the branch stayed.
+ */
+export declare function recordBranchGone(repo: string, card: RunCard, diary: readonly AnyDiaryLine[], deleted: readonly string[] | undefined, deps?: LogsDeps): Promise<FileBranchWrite | undefined>;
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

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