@openagt/dashboard 0.8.0 → 0.10.0

package/dist/driver/actions.d.ts

@@ -1,130 +0,0 @@
-import type { Driver, DriverEvent, DriverPromptOptions, DriverSession, DriverStartOptions, DriverTurn } from './types.js';
-/**
- * A {@link Driver} that runs the agent on **GitHub Actions** instead of on this
- * machine (#610): dispatch a workflow, poll it, read the transcript it uploads.
- *
- * This is the answer to "drive Claude Code on the web". The routines fire API was
- * the obvious candidate and turned out unusable — the prompt arrives wrapped as
- * untrusted data, and there is no read-back of any kind. The official
- * `anthropics/claude-code-action@v1` has neither problem: the prompt is passed
- * verbatim, and the run publishes its full transcript. Auth is the same
- * subscription posture as everywhere else (#495): a `claude setup-token` OAuth
- * token held by the repo, never an API key of ours.
- *
- * It fits `Driver`/`DriverSession` as written, with no new methods. What changes is
- * not the shape but the tempo, and those costs are real:
- *
- * - **Minutes, not seconds.** Every `prompt` is a fresh runner and a fresh
- *   checkout. Continuity comes from the branch the previous turn pushed, which the
- *   session tracks and dispatches onto next time.
- * - **No live stream.** The transcript arrives once, at the end, so the dashboard's
- *   {@link DriverStartOptions.onEvent} feed replays in a burst rather than trickling.
- * - **Quota is the account's, not the runner's.** Free minutes on a public repo
- *   change nothing about the subscription window every run draws down.
- *
- * The workspace lives on a runner that is gone by the time we read it, so
- * {@link ActionsSession.readCode} reads from the pushed branch over the contents
- * API rather than from disk.
- */
-export declare class ActionsDriver implements Driver {
-    private readonly opts;
-    readonly id = "github-actions";
-    constructor(opts: ActionsDriverOptions);
-    start(opts: DriverStartOptions): Promise<DriverSession>;
-}
-/** Options for {@link ActionsDriver}. */
-export interface ActionsDriverOptions {
-    /** Repository owner (user or org) that runs the workflow. */
-    owner: string;
-    /** Repository name. */
-    repo: string;
-    /**
-     * GitHub token used to dispatch and to read runs, artifacts, and file contents.
-     * Needs `repo` + `workflow` scope. Must belong to a **user**, not an App: the
-     * action's `checkHumanActor` rejects a bot-triggered agent run unless the bot is
-     * in its `allowed_bots`.
-     */
-    token: string;
-    /** Workflow file to dispatch. Default `"framework-agent.yml"`. */
-    workflow?: string;
-    /** Git ref the first turn runs on. Later turns follow the branch the agent pushed. */
-    ref?: string;
-    /** How often to poll the run, in ms. Default 5000. */
-    pollIntervalMs?: number;
-    /** Give up on a run after this long, in ms. Default 1 hour (the job cap is 6). */
-    timeoutMs?: number;
-    /** REST base. Default `"https://api.github.com"`. */
-    apiBase?: string;
-    /** `fetch` override for tests. Default the global. */
-    fetch?: FetchLike;
-    /** Clock override for tests. Default `Date.now`. */
-    now?: () => number;
-    /** Sleep override for tests. Default a real timer. */
-    sleep?: (ms: number) => Promise<void>;
-    /**
-     * Unique tag mixed into the correlation id. Default a random token; injected in tests for
-     * a stable id. Without it a fresh driver process restarts the session counter at 1, so
-     * every run's first turn is `actions-1-turn-1` and runs collide (see {@link ActionsSession}).
-     */
-    runTag?: () => string;
-    /**
-     * Prefix for the branch each run pushes its work to (#1085). Default `"claude/"`. The
-     * driver names the branch (prefix + session id) and passes it to the workflow, rather than
-     * discovering it after the fact: the action leaves `branch_name` empty for a
-     * `workflow_dispatch` run, so there is nothing to discover.
-     */
-    branchPrefix?: string;
-}
-/** The slice of `fetch` this driver uses. */
-export type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
-/** One Actions-backed session. Each `prompt` is one workflow run. */
-export declare class ActionsSession implements DriverSession {
-    private readonly config;
-    private readonly startOpts;
-    readonly id: string;
-    readonly cwd: string;
-    /** The branch the last run pushed; set once the run reports it, and the next turn builds on it. */
-    private branch;
-    /** The branch this session asks each run to push to. Stable across turns, so they chain. */
-    private readonly runBranch;
-    /** The agent's own session id, carried across turns so `resume` can continue it. */
-    private lastSessionId;
-    private turnCounter;
-    constructor(config: ActionsDriverOptions, startOpts: DriverStartOptions);
-    prompt(text: string, opts?: DriverPromptOptions): Promise<DriverTurn>;
-    /**
-     * Read a file the agent produced. The runner is gone, so this reads the branch the
-     * run pushed rather than the local workspace — the seam is still the code, just
-     * fetched over the contents API.
-     */
-    readCode(path: string): Promise<string>;
-    dispose(): Promise<void>;
-    /** Fire the workflow. Returns nothing useful: dispatch is 204 with no body, hence the correlation id. */
-    private dispatch;
-    /** Poll until our run appears and finishes. Identified by the correlation id in its `run-name`. */
-    private awaitWorkflowRun;
-    /** Our run among the workflow's recent ones, or undefined while GitHub is still creating it. */
-    private findWorkflowRun;
-    /** Download the run's artifact and pull the transcript and the pushed branch out of it. */
-    private readRunArtifact;
-    private get owner();
-    /** The session-wide signal or the per-prompt one (`DriverPromptOptions.signal`) both stop the poll. */
-    private throwIfAborted;
-    /** A REST call that expects JSON back. */
-    private api;
-    /** A REST call, with auth and error handling. */
-    private request;
-}
-/**
- * Turn the action's `execution_file` into a turn, replaying its events on the way.
- *
- * The adapter is thin on purpose: the file is a JSON **array** of exactly the
- * SDKMessage objects the CLI emits one-per-line, so the existing
- * {@link StreamJsonParser} reads it verbatim once the array is unwrapped. The whole
- * difference between running locally and running on a runner is array-vs-JSONL.
- *
- * Events replay in a burst at the end rather than live — that is the honest cost of
- * this driver, and the dashboard sees the same event stream either way.
- */
-export declare function replayTranscript(json: string, emit?: (event: DriverEvent) => void): DriverTurn;
-//# sourceMappingURL=actions.d.ts.map

package/dist/driver/actions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/driver/actions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEzH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,YAAW,MAAM;IAE9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,QAAQ,CAAC,EAAE,oBAAmB;IAC9B,YAA6B,IAAI,EAAE,oBAAoB,EAAI;IAE3D,KAAK,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAEtD;CAIF;AAED,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,sDAAsD;IACtD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;IACrB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAO9E,qEAAqE;AACrE,qBAAa,cAAe,YAAW,aAAa;IAYhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAZ5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,OAAO,CAAC,MAAM,CAAoB;IAClC,4FAA4F;IAC5F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,oFAAoF;IACpF,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,WAAW,CAAI;IAEvB,YACmB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,kBAAkB,EAQ/C;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2B9E;IAED;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5C;IAED,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvB;IAED,yGAAyG;YAC3F,QAAQ;IAatB,mGAAmG;YACrF,gBAAgB;IA8B9B,gGAAgG;YAClF,eAAe;IAK7B,2FAA2F;YAC7E,eAAe;IAe7B,OAAO,KAAK,KAAK,GAEhB;IAED,uGAAuG;IACvG,OAAO,CAAC,cAAc;IAKtB,0CAA0C;YAC5B,GAAG;IAMjB,iDAAiD;YACnC,OAAO;CAetB;AAWD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAe,GAAG,UAAU,CAcxG"}

package/dist/driver/actions.js

@@ -1,261 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { StreamJsonParser } from './claude-code.js';
-import { readZip } from './actions-zip.js';
-import { combineFraming, makeEmit } from './session-support.js';
-/**
- * A {@link Driver} that runs the agent on **GitHub Actions** instead of on this
- * machine (#610): dispatch a workflow, poll it, read the transcript it uploads.
- *
- * This is the answer to "drive Claude Code on the web". The routines fire API was
- * the obvious candidate and turned out unusable — the prompt arrives wrapped as
- * untrusted data, and there is no read-back of any kind. The official
- * `anthropics/claude-code-action@v1` has neither problem: the prompt is passed
- * verbatim, and the run publishes its full transcript. Auth is the same
- * subscription posture as everywhere else (#495): a `claude setup-token` OAuth
- * token held by the repo, never an API key of ours.
- *
- * It fits `Driver`/`DriverSession` as written, with no new methods. What changes is
- * not the shape but the tempo, and those costs are real:
- *
- * - **Minutes, not seconds.** Every `prompt` is a fresh runner and a fresh
- *   checkout. Continuity comes from the branch the previous turn pushed, which the
- *   session tracks and dispatches onto next time.
- * - **No live stream.** The transcript arrives once, at the end, so the dashboard's
- *   {@link DriverStartOptions.onEvent} feed replays in a burst rather than trickling.
- * - **Quota is the account's, not the runner's.** Free minutes on a public repo
- *   change nothing about the subscription window every run draws down.
- *
- * The workspace lives on a runner that is gone by the time we read it, so
- * {@link ActionsSession.readCode} reads from the pushed branch over the contents
- * API rather than from disk.
- */
-export class ActionsDriver {
-    opts;
-    id = 'github-actions';
-    constructor(opts) {
-        this.opts = opts;
-    }
-    start(opts) {
-        return Promise.resolve(new ActionsSession(this.opts, opts));
-    }
-}
-let sessionCounter = 0;
-/** A short random tag so correlation ids stay unique across driver processes. */
-const randomRunTag = () => randomUUID().slice(0, 8);
-/** One Actions-backed session. Each `prompt` is one workflow run. */
-export class ActionsSession {
-    config;
-    startOpts;
-    id;
-    cwd;
-    /** The branch the last run pushed; set once the run reports it, and the next turn builds on it. */
-    branch;
-    /** The branch this session asks each run to push to. Stable across turns, so they chain. */
-    runBranch;
-    /** The agent's own session id, carried across turns so `resume` can continue it. */
-    lastSessionId;
-    turnCounter = 0;
-    constructor(config, startOpts) {
-        this.config = config;
-        this.startOpts = startOpts;
-        this.cwd = startOpts.cwd;
-        // The counter reads well in logs within one process; the random tag is what keeps the
-        // correlation id unique across processes, since the daemon spawns a fresh one per run.
-        this.id = `actions-${++sessionCounter}-${(config.runTag ?? randomRunTag)()}`;
-        this.runBranch = `${config.branchPrefix ?? 'claude/'}framework-${this.id}`;
-        this.lastSessionId = startOpts.resumeSessionId;
-    }
-    async prompt(text, opts = {}) {
-        const emit = makeEmit(this.startOpts.onEvent, 'github-actions');
-        // The action takes `prompt` as an action input, not through a shell, so a
-        // multi-line prompt is safe. The framing rides in front of it (as with Codex):
-        // `--append-system-prompt` would have to survive shell-quoting inside the
-        // workflow, and a system prompt is not worth an injection seam.
-        const framing = combineFraming(this.startOpts.system, opts.system);
-        const prompt = framing ? `${framing}\n\n${text}` : text;
-        emit({ type: 'start', prompt });
-        // How we find our run: the dispatch API returns no run id, so the workflow echoes this
-        // into its run-name and artifact name and we match on it. It must be unique per run (the
-        // session's random tag) so a fresh process never latches onto a stale same-named run.
-        const correlationId = `${this.id}-turn-${++this.turnCounter}`;
-        const resume = opts.resume ? this.lastSessionId : undefined;
-        await this.dispatch(prompt, correlationId, resume);
-        emit({ type: 'notice', message: `Dispatched ${correlationId} to ${this.config.owner}/${this.config.repo}; waiting for the runner.` });
-        const run = await this.awaitWorkflowRun(correlationId, emit, opts.signal);
-        const artifact = await this.readRunArtifact(run.id, correlationId);
-        if (artifact.branch)
-            this.branch = artifact.branch;
-        const turn = replayTranscript(artifact.execution, emit);
-        if (turn.sessionId)
-            this.lastSessionId = turn.sessionId;
-        emit({ type: 'result', text: turn.text, ...(turn.sessionId ? { sessionId: turn.sessionId } : {}), ...(turn.usage ? { usage: turn.usage } : {}) });
-        return turn;
-    }
-    /**
-     * Read a file the agent produced. The runner is gone, so this reads the branch the
-     * run pushed rather than the local workspace — the seam is still the code, just
-     * fetched over the contents API.
-     */
-    async readCode(path) {
-        if (!this.branch)
-            throw new Error('No branch yet: readCode is only available after a run has pushed one.');
-        const encoded = path.split('/').map(encodeURIComponent).join('/');
-        const body = await this.api(`/repos/${this.owner}/contents/${encoded}?ref=${encodeURIComponent(this.branch)}`);
-        if (typeof body.content !== 'string')
-            throw new Error(`${path} is not a file on ${this.branch}`);
-        return Buffer.from(body.content, body.encoding === 'base64' ? 'base64' : 'utf8').toString('utf8');
-    }
-    dispose() {
-        // Every run reaps itself on the runner; there is nothing here to free.
-        return Promise.resolve();
-    }
-    /** Fire the workflow. Returns nothing useful: dispatch is 204 with no body, hence the correlation id. */
-    async dispatch(prompt, correlationId, resume) {
-        const workflow = this.config.workflow ?? 'framework-agent.yml';
-        const inputs = { prompt, correlation_id: correlationId, branch: this.runBranch };
-        // These reach a shell on the runner as environment variables. They are ids and
-        // model names, so anything outside that alphabet is a bug or an attack.
-        if (this.startOpts.model)
-            inputs['model'] = assertToken(this.startOpts.model, 'model');
-        if (resume)
-            inputs['resume_session_id'] = assertToken(resume, 'resume session id');
-        await this.api(`/repos/${this.owner}/actions/workflows/${encodeURIComponent(workflow)}/dispatches`, {
-            method: 'POST',
-            body: JSON.stringify({ ref: this.branch ?? this.config.ref ?? 'main', inputs }),
-        });
-    }
-    /** Poll until our run appears and finishes. Identified by the correlation id in its `run-name`. */
-    async awaitWorkflowRun(correlationId, emit, promptSignal) {
-        const now = this.config.now ?? Date.now;
-        const sleep = this.config.sleep ?? (ms => new Promise(r => setTimeout(r, ms)));
-        const interval = this.config.pollIntervalMs ?? 5000;
-        const deadline = now() + (this.config.timeoutMs ?? 60 * 60 * 1000);
-        let announced = false;
-        for (;;) {
-            const found = await this.findWorkflowRun(correlationId);
-            if (found) {
-                if (!announced) {
-                    announced = true;
-                    emit({ type: 'action', label: `run ${found.html_url}` });
-                }
-                if (found.status === 'completed') {
-                    if (found.conclusion !== 'success')
-                        throw new Error(`GitHub Actions run concluded "${found.conclusion}": ${found.html_url}`);
-                    return found;
-                }
-            }
-            if (now() >= deadline)
-                throw new Error(`Timed out waiting for the GitHub Actions run (${correlationId}).`);
-            this.throwIfAborted(promptSignal);
-            await sleep(interval);
-            this.throwIfAborted(promptSignal);
-        }
-    }
-    /** Our run among the workflow's recent ones, or undefined while GitHub is still creating it. */
-    async findWorkflowRun(correlationId) {
-        const body = await this.api(`/repos/${this.owner}/actions/runs?event=workflow_dispatch&per_page=50`);
-        return (body.workflow_runs ?? []).find(run => typeof run.name === 'string' && run.name.includes(correlationId));
-    }
-    /** Download the run's artifact and pull the transcript and the pushed branch out of it. */
-    async readRunArtifact(runId, correlationId) {
-        const list = await this.api(`/repos/${this.owner}/actions/runs/${runId}/artifacts`);
-        const artifact = (list.artifacts ?? []).find(a => a.name.includes(correlationId)) ?? list.artifacts?.[0];
-        if (!artifact)
-            throw new Error(`Run ${runId} uploaded no artifact; the workflow's collect step did not run.`);
-        const res = await this.request(`/repos/${this.owner}/actions/artifacts/${artifact.id}/zip`);
-        const entries = readZip(Buffer.from(await res.arrayBuffer()));
-        const execution = entries.find(e => e.name.endsWith('execution.json'));
-        if (!execution)
-            throw new Error(`Artifact ${artifact.name} has no execution.json (entries: ${entries.map(e => e.name).join(', ') || 'none'})`);
-        const meta = entries.find(e => e.name.endsWith('meta.json'));
-        const branch = meta ? readBranch(meta.data.toString('utf8')) : undefined;
-        return { execution: execution.data.toString('utf8'), ...(branch ? { branch } : {}) };
-    }
-    get owner() {
-        return `${this.config.owner}/${this.config.repo}`;
-    }
-    /** The session-wide signal or the per-prompt one (`DriverPromptOptions.signal`) both stop the poll. */
-    throwIfAborted(promptSignal) {
-        if (this.startOpts.signal?.aborted || promptSignal?.aborted)
-            throw new Error('Session aborted while waiting for the GitHub Actions run.');
-    }
-    /** A REST call that expects JSON back. */
-    async api(path, init) {
-        const res = await this.request(path, init);
-        if (res.status === 204)
-            return undefined;
-        return (await res.json());
-    }
-    /** A REST call, with auth and error handling. */
-    async request(path, init = {}) {
-        const doFetch = this.config.fetch ?? globalThis.fetch;
-        const res = await doFetch(`${this.config.apiBase ?? 'https://api.github.com'}${path}`, {
-            ...init,
-            headers: {
-                accept: 'application/vnd.github+json',
-                authorization: `Bearer ${this.config.token}`,
-                'x-github-api-version': '2022-11-28',
-                ...(init.body ? { 'content-type': 'application/json' } : {}),
-                ...init.headers,
-            },
-        });
-        if (!res.ok)
-            throw new Error(`GitHub API ${init.method ?? 'GET'} ${path} failed (${res.status} ${res.statusText}): ${await safeText(res)}`);
-        return res;
-    }
-}
-/**
- * Turn the action's `execution_file` into a turn, replaying its events on the way.
- *
- * The adapter is thin on purpose: the file is a JSON **array** of exactly the
- * SDKMessage objects the CLI emits one-per-line, so the existing
- * {@link StreamJsonParser} reads it verbatim once the array is unwrapped. The whole
- * difference between running locally and running on a runner is array-vs-JSONL.
- *
- * Events replay in a burst at the end rather than live — that is the honest cost of
- * this driver, and the dashboard sees the same event stream either way.
- */
-export function replayTranscript(json, emit = () => { }) {
-    let messages;
-    try {
-        messages = JSON.parse(json);
-    }
-    catch (err) {
-        throw new Error(`Could not parse the run transcript as JSON: ${err.message}`);
-    }
-    if (!Array.isArray(messages))
-        throw new Error('The run transcript is not a JSON array of messages.');
-    const parser = new StreamJsonParser();
-    for (const message of messages) {
-        for (const event of parser.push(JSON.stringify(message)))
-            emit(event);
-    }
-    return parser.result();
-}
-/** The branch the run pushed, from the workflow's `meta.json`. Absent when the agent pushed nothing. */
-function readBranch(json) {
-    try {
-        const meta = JSON.parse(json);
-        const branch = meta['branch'];
-        return typeof branch === 'string' && branch ? branch : undefined;
-    }
-    catch {
-        return undefined; // A malformed meta file costs us `readCode`, not the turn.
-    }
-}
-/** Reject anything that is not an opaque id, since these reach a shell on the runner. */
-function assertToken(value, what) {
-    if (!/^[A-Za-z0-9._:-]+$/.test(value))
-        throw new Error(`Refusing to pass an unsafe ${what} to the workflow: ${value}`);
-    return value;
-}
-/** An error body, best-effort — a failure to read one must not replace the real error. */
-async function safeText(res) {
-    try {
-        return (await res.text()).slice(0, 500);
-    }
-    catch {
-        return '<no body>';
-    }
-}
-//# sourceMappingURL=actions.js.map

package/dist/driver/actions.js.map

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

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

@@ -1,57 +0,0 @@
-import type { DriverEvent, DriverTurn } from './types.js';
-/** The slice of `child_process.spawn` a driver needs. Injectable for tests. */
-export type SpawnLike = (command: string, args: readonly string[], options: {
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    detached?: boolean;
-}) => SpawnedProcess;
-/** The slice of a spawned process a driver reads. */
-export interface SpawnedProcess {
-    /** OS pid; present for a real child, absent for in-memory test fakes. */
-    pid?: number | undefined;
-    stdout: NodeJS.ReadableStream | null;
-    stderr: NodeJS.ReadableStream | null;
-    stdin: NodeJS.WritableStream | null;
-    on(event: 'close', listener: (code: number | null) => void): unknown;
-    on(event: 'error', listener: (err: Error) => void): unknown;
-    kill(signal?: NodeJS.Signals): unknown;
-}
-/**
- * The slice of a driver's output parser {@link runAgentCli} drives: fed one line
- * at a time, asked for the turn at the end. Each wrapped agent speaks its own
- * dialect ({@link StreamJsonParser} for Claude Code, `CodexJsonParser` for
- * Codex), but the process handling around it is identical.
- */
-export interface AgentCliParser {
-    /** Fold one line of the agent's output in, and surface anything worth emitting. */
-    push(line: string): DriverEvent[];
-    /** The turn the lines added up to. */
-    result(): DriverTurn;
-}
-/** How to run one agent-CLI invocation. */
-export interface RunAgentCliOptions {
-    bin: string;
-    args: string[];
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    prompt: string;
-    spawn: SpawnLike;
-    emit: (event: DriverEvent) => void;
-    signals: AbortSignal[];
-    /** The agent's own output dialect. */
-    parser: AgentCliParser;
-    /** The agent's name, for error messages. Default `"claude-code"`. */
-    agent?: string;
-}
-/**
- * Spawn one agent-CLI invocation and resolve with its final turn.
- *
- * Everything here is about the *process*, not the agent: its own process group
- * so an interrupt kills the whole tree rather than orphaning it, a SIGTERM/
- * SIGKILL grace window, abort wiring, and a non-zero exit failing the turn even
- * when text was streamed first. Only {@link RunAgentCliOptions.parser} knows
- * which agent is on the other end — a second agent gets all of this for free
- * rather than a second copy of it.
- */
-export declare function runAgentCli(opts: RunAgentCliOptions): Promise<DriverTurn>;
-//# sourceMappingURL=agent-cli.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent-cli.d.ts","sourceRoot":"","sources":["../../src/driver/agent-cli.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAWzD,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KACjE,cAAc,CAAA;AAEnB,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IACpC,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IACnC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAA;IACpE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAA;IAC3D,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAAA;IACjC,sCAAsC;IACtC,MAAM,IAAI,UAAU,CAAA;CACrB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IAClC,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,sCAAsC;IACtC,MAAM,EAAE,cAAc,CAAA;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8GzE"}

package/dist/driver/agent-cli.js

@@ -1,134 +0,0 @@
-import { createInterface } from 'node:readline';
-import { killTree, registerChild, unregisterChild } from './child-registry.js';
-// The agent-agnostic core for running one wrapped coding-agent CLI: spawn it in its own
-// process group, stream its output through a parser, and gate the turn on its exit. Each
-// concrete driver (claude-code, codex) supplies the argv and an AgentCliParser for its own
-// output dialect; everything about the *process* lives here, so a second driver reuses it
-// rather than reaching into the first driver's file for it.
-/** Grace between SIGTERM and the SIGKILL that forces a hung agent tree down. */
-const TERMINATE_GRACE_MS = 5000;
-/**
- * Spawn one agent-CLI invocation and resolve with its final turn.
- *
- * Everything here is about the *process*, not the agent: its own process group
- * so an interrupt kills the whole tree rather than orphaning it, a SIGTERM/
- * SIGKILL grace window, abort wiring, and a non-zero exit failing the turn even
- * when text was streamed first. Only {@link RunAgentCliOptions.parser} knows
- * which agent is on the other end — a second agent gets all of this for free
- * rather than a second copy of it.
- */
-export function runAgentCli(opts) {
-    return new Promise((resolvePromise, rejectPromise) => {
-        for (const s of opts.signals) {
-            if (s.aborted) {
-                rejectPromise(new Error(`[framework] ${opts.agent ?? 'claude-code'} prompt aborted`));
-                return;
-            }
-        }
-        opts.emit({ type: 'start', prompt: opts.prompt });
-        // `detached` makes the child its own process-group leader so we can kill the
-        // whole agent subtree (claude + node workers + tool calls) at once, not just
-        // the top process — otherwise an interrupt orphans the tree (the leak).
-        const child = opts.spawn(opts.bin, opts.args, { cwd: opts.cwd, env: opts.env, detached: true });
-        const pid = child.pid;
-        if (pid != null)
-            registerChild(pid);
-        const parser = opts.parser;
-        const agent = opts.agent ?? 'claude-code';
-        let settled = false;
-        let hardKillTimer;
-        // Raw bytes, decoded once at close: a per-chunk `String(chunk)` corrupts a multibyte
-        // UTF-8 codepoint split across two chunks, and this text becomes the turn's error detail.
-        const stderrChunks = [];
-        // Kill the agent's whole process group: SIGTERM to let it flush, then a
-        // SIGKILL after a grace window in case it ignores the term (mid tool-call).
-        const terminate = () => {
-            if (pid != null)
-                killTree(pid, 'SIGTERM');
-            else
-                child.kill('SIGTERM');
-            hardKillTimer = setTimeout(() => {
-                if (pid != null)
-                    killTree(pid, 'SIGKILL');
-                else
-                    child.kill('SIGKILL');
-            }, TERMINATE_GRACE_MS);
-            hardKillTimer.unref?.();
-        };
-        // Runs exactly once the process is done with (closed, errored, or killed):
-        // stop tracking it and cancel any pending hard-kill.
-        const cleanup = () => {
-            if (pid != null)
-                unregisterChild(pid);
-            if (hardKillTimer)
-                clearTimeout(hardKillTimer);
-        };
-        const finish = (fn) => {
-            if (settled)
-                return;
-            settled = true;
-            for (const { signal, handler } of aborts)
-                signal.removeEventListener('abort', handler);
-            fn();
-        };
-        const aborts = opts.signals.map(signal => {
-            const handler = () => {
-                if (settled)
-                    return;
-                terminate();
-                finish(() => rejectPromise(new Error(`[framework] ${agent} prompt aborted`)));
-            };
-            signal.addEventListener('abort', handler);
-            return { signal, handler };
-        });
-        child.on('error', err => {
-            cleanup();
-            finish(() => rejectPromise(err));
-        });
-        if (child.stdout) {
-            const rl = createInterface({ input: child.stdout });
-            rl.on('line', line => {
-                for (const event of parser.push(line))
-                    opts.emit(event);
-            });
-        }
-        if (child.stderr) {
-            child.stderr.on('data', (chunk) => stderrChunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
-        }
-        child.on('close', code => {
-            cleanup();
-            // An abort (or a spawn error) already settled and reported the turn; the process
-            // still closes afterward, but its late exit must not emit a second telemetry event.
-            if (settled)
-                return;
-            const turn = parser.result();
-            // A non-zero exit is a failed turn even when the agent streamed some text
-            // first: the loop gates on the outcome, so a crash mid-build must not pass
-            // as a result. Surface stderr, else the partial text, as context.
-            if (code !== 0) {
-                const detail = Buffer.concat(stderrChunks).toString('utf8').trim() || turn.text.trim() || `exit code ${code ?? 'null'}`;
-                opts.emit({ type: 'error', message: detail });
-                finish(() => rejectPromise(new Error(`[framework] ${agent} exited (${code ?? 'null'}): ${detail}`)));
-                return;
-            }
-            opts.emit({
-                type: 'result',
-                text: turn.text,
-                ...(turn.sessionId ? { sessionId: turn.sessionId } : {}),
-                ...(turn.usage ? { usage: turn.usage } : {}),
-            });
-            finish(() => resolvePromise(turn));
-        });
-        // Feed the prompt over stdin so long prompts never hit arg-length limits.
-        if (child.stdin) {
-            // A CLI that exits before reading stdin (bad flag, instant crash) surfaces an async
-            // EPIPE on the stream; with no listener that is an uncaught exception in the daemon
-            // (#943). The close handler already reports the failed turn, so the error carries
-            // nothing the caller needs.
-            child.stdin.on('error', () => { });
-            child.stdin.write(opts.prompt);
-            child.stdin.end();
-        }
-    });
-}
-//# sourceMappingURL=agent-cli.js.map

package/dist/driver/agent-cli.js.map

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

package/dist/driver/child-registry.d.ts

@@ -1,25 +0,0 @@
-/**
- * Process-tree kill registry.
- *
- * The framework spawns the Claude Code CLI, which in turn spawns a deep subtree
- * (node workers, ripgrep, bash tool calls, MCP servers). Signaling only the
- * top-level `claude` orphans that subtree: it reparents to init and keeps
- * burning CPU — the runaway-process leak we hit (a swarm of stray `claude`
- * processes after an agent was interrupted).
- *
- * Fix: spawn each long-lived child as its own process-group leader (`detached`)
- * and signal the whole group at once via a negative pid. Register every live
- * child here so a hard framework exit (crash, uncaught error, process.exit)
- * still reaps the trees on the way out.
- */
-/**
- * Signal an entire process group. `pid` must be a group leader (spawned
- * `detached`); the negative pid targets the group, reaping the whole subtree in
- * one shot. Never throws — a group that already exited is not an error.
- */
-export declare function killTree(pid: number, signal: NodeJS.Signals): void;
-/** Track a detached child so it is force-killed if the framework exits first. */
-export declare function registerChild(pid: number): void;
-/** Stop tracking a child that has already exited (or been killed). */
-export declare function unregisterChild(pid: number): void;
-//# sourceMappingURL=child-registry.d.ts.map