@openagt/dashboard 0.8.0 → 0.9.0

package/dist/driver/claude-code.js

@@ -1,314 +0,0 @@
-import { spawn as nodeSpawn } from 'node:child_process';
-import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { readClaudeQuota } from './claude-code-quota.js';
-import { combineFraming, combineSignals, makeEmit, readWorkspaceFile } from './session-support.js';
-import { runCliSession } from './cli-session.js';
-/**
- * The first real {@link Driver}: wraps the **Claude Code CLI** in print mode
- * (`claude -p --output-format stream-json`). Each {@link DriverSession.prompt}
- * spawns a fresh non-interactive invocation, so every loop pass gets fresh
- * context (option A). We stream its JSON events to {@link DriverStartOptions.onEvent}
- * for the dashboard and return the final `result` text as the turn.
- *
- * True black box: we prompt and read the result; Claude Code owns its own loop,
- * tools, and (subscription-based) auth. A second agent slots in behind the same
- * `Driver` interface without touching the orchestration above it.
- */
-export class ClaudeCodeDriver {
-    opts;
-    id = 'claude-code';
-    constructor(opts = {}) {
-        this.opts = opts;
-    }
-    start(opts) {
-        return Promise.resolve(new ClaudeCodeSession(this.opts, opts));
-    }
-    /** Where the account's subscription quota stands (#521). Account-wide, so no session. */
-    readQuota(opts = {}) {
-        return readClaudeQuota({
-            ...(this.opts.bin !== undefined ? { bin: this.opts.bin } : {}),
-            ...(this.opts.env !== undefined ? { env: this.opts.env } : {}),
-            ...(this.opts.spawn !== undefined ? { spawn: this.opts.spawn } : {}),
-            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
-        });
-    }
-}
-let sessionCounter = 0;
-/** One workspace-bound Claude Code session. `prompt` is a fresh CLI invocation. */
-export class ClaudeCodeSession {
-    config;
-    startOpts;
-    id;
-    cwd;
-    /** Path to the written `--mcp-config` file, lazily created on first use. */
-    mcpConfigPath;
-    /**
-     * The agent's own session id from the last turn (#714). Retained so a
-     * {@link DriverPromptOptions.resume} prompt can `--resume` the same
-     * conversation; resume keeps the id stable, so consecutive chat messages chain.
-     */
-    lastSessionId;
-    constructor(config, startOpts) {
-        this.config = config;
-        this.startOpts = startOpts;
-        this.cwd = startOpts.cwd;
-        this.id = `claude-code-${++sessionCounter}`;
-        // Resume a finished agent (#720): seeding lastSessionId makes the very first `resume` prompt
-        // `--resume` this conversation, exactly as a mid-run chat turn continues its own session.
-        this.lastSessionId = startOpts.resumeSessionId;
-    }
-    async prompt(text, opts = {}) {
-        const system = combineFraming(this.startOpts.system, opts.system);
-        const resumeId = opts.resume ? this.lastSessionId : undefined;
-        const emit = makeEmit(this.startOpts.onEvent, 'claude-code');
-        const signals = combineSignals(this.startOpts.signal, opts.signal);
-        const agent = (id, emitFn) => runClaude({
-            bin: this.config.bin ?? 'claude',
-            args: this.buildArgs(system, id),
-            cwd: this.cwd,
-            env: this.config.env ?? process.env,
-            prompt: text,
-            spawn: this.config.spawn ?? nodeSpawn,
-            emit: emitFn,
-            signals,
-        });
-        let turn;
-        // On a resume attempt, hold the failure's `error` event back until the conversation-gone
-        // case (#778) is ruled out: a turn that recovers on the retry must not show a failed row.
-        // Safe to hold — runCliSession emits `error` exactly once, right before it rejects.
-        let heldError;
-        try {
-            turn = await agent(resumeId, resumeId === undefined ? emit : event => {
-                if (event.type === 'error')
-                    heldError = event;
-                else
-                    emit(event);
-            });
-        }
-        catch (err) {
-            // The id we captured outlives what the CLI will resume (#778) — its retention, a
-            // cleared history, another machine. There is no way to ask first, so let it fail
-            // once and continue as a fresh conversation (which gets the system framing back)
-            // rather than losing the message the user already typed.
-            if (resumeId === undefined || !isConversationGone(err) || signals.some(s => s.aborted)) {
-                if (heldError)
-                    emit(heldError);
-                throw err;
-            }
-            this.lastSessionId = undefined;
-            emit({ type: 'notice', message: 'That conversation is no longer available; continuing without its history.' });
-            // The retry re-sends the same prompt; swallow its duplicate `start` so the user's
-            // message appears once in the transcript, not twice.
-            let startSeen = false;
-            turn = await agent(undefined, event => {
-                if (event.type === 'start' && !startSeen)
-                    startSeen = true;
-                else
-                    emit(event);
-            });
-        }
-        // Track the agent's session so a later resume continues this exact conversation.
-        if (turn.sessionId)
-            this.lastSessionId = turn.sessionId;
-        return turn;
-    }
-    readCode(path) {
-        return readWorkspaceFile(this.cwd, path);
-    }
-    dispose() {
-        // Each prompt spawns and reaps its own process, so the only durable thing is
-        // the temp MCP config file; drop it. The session id reaches the UI via the
-        // emitted result event.
-        if (this.mcpConfigPath) {
-            try {
-                rmSync(dirname(this.mcpConfigPath), { recursive: true, force: true });
-            }
-            catch {
-                // Best effort: the temp dir lands under the OS tmp and is reaped anyway.
-            }
-            this.mcpConfigPath = undefined;
-        }
-        return Promise.resolve();
-    }
-    buildArgs(system, resumeId) {
-        const args = ['-p', '--output-format', 'stream-json', '--verbose'];
-        if (this.config.dangerouslySkipPermissions)
-            args.push('--dangerously-skip-permissions');
-        else
-            args.push('--permission-mode', this.config.permissionMode ?? 'acceptEdits');
-        // Resume the same conversation for a chat turn (#714). Skip the system append then:
-        // the resumed transcript already carries its framing, so re-appending only duplicates it.
-        if (resumeId)
-            args.push('--resume', resumeId);
-        else if (system)
-            args.push('--append-system-prompt', system);
-        if (this.startOpts.model)
-            args.push('--model', this.startOpts.model);
-        const mcpConfig = this.mcpConfigFile();
-        if (mcpConfig)
-            args.push('--mcp-config', mcpConfig);
-        if (this.config.extraArgs)
-            args.push(...this.config.extraArgs);
-        return args;
-    }
-    /**
-     * Lazily materialize the `--mcp-config` file for {@link ClaudeCodeDriverOptions.mcpServers}.
-     * Written once and reused across the session's prompts; `undefined` when no
-     * servers are configured. Not `--strict-mcp-config`, so these merge with the
-     * user's own MCP servers rather than replacing them.
-     */
-    mcpConfigFile() {
-        const servers = this.config.mcpServers;
-        if (!servers || Object.keys(servers).length === 0)
-            return undefined;
-        if (!this.mcpConfigPath) {
-            const dir = mkdtempSync(join(tmpdir(), 'framework-mcp-'));
-            this.mcpConfigPath = join(dir, 'mcp.json');
-            writeFileSync(this.mcpConfigPath, JSON.stringify({ mcpServers: servers }));
-        }
-        return this.mcpConfigPath;
-    }
-}
-/** How the CLI reports that the session id we asked it to resume is gone from its history (#778). */
-const CONVERSATION_GONE = /No conversation found with session ID/i;
-/** Whether a failed turn failed because the conversation we tried to resume no longer exists. */
-function isConversationGone(err) {
-    return CONVERSATION_GONE.test(err instanceof Error ? err.message : String(err));
-}
-/** Spawn one Claude Code invocation and resolve with its final turn. */
-export function runClaude(opts) {
-    return runCliSession({ ...opts, parser: new StreamJsonParser() });
-}
-/**
- * Incremental parser for Claude Code's `stream-json` output: newline-delimited
- * JSON, one object per line. We surface assistant text + tool names as
- * {@link DriverEvent}s and keep the final `result` line as the turn text.
- * Kept separate from the process plumbing so it is unit-testable in isolation.
- */
-export class StreamJsonParser {
-    finalText = '';
-    assistantText = '';
-    sessionId;
-    usage;
-    /** Feed one line; returns the events it produced (may be empty). */
-    push(line) {
-        const trimmed = line.trim();
-        if (!trimmed)
-            return [];
-        let obj;
-        try {
-            obj = JSON.parse(trimmed);
-        }
-        catch {
-            return []; // Non-JSON noise (banners etc.); ignore.
-        }
-        // `null` parses, so the catch above lets it through and every field read below throws — from
-        // inside a readline handler, where nothing catches it. Noise is noise whatever it parses to.
-        if (typeof obj !== 'object' || obj === null)
-            return [];
-        // Announced on the very first stream line, so it must not wait for `result`: a turn that is
-        // stopped or dies mid-flight would take the id — the agent's `claude --resume` handle — with
-        // it (#1322). Emitted only when it changes; every subsequent line repeats the same id.
-        const announced = [];
-        if (typeof obj['session_id'] === 'string' && obj['session_id'] !== this.sessionId) {
-            this.sessionId = obj['session_id'];
-            announced.push({ type: 'session', sessionId: this.sessionId });
-        }
-        const type = obj['type'];
-        if (type === 'assistant')
-            return [...announced, ...this.handleAssistant(obj)];
-        if (type === 'rate_limit_event') {
-            const limit = parseRateLimit(obj);
-            return limit ? [...announced, { type: 'rate-limit', limit }] : announced;
-        }
-        if (type === 'result') {
-            const result = obj['result'];
-            if (typeof result === 'string')
-                this.finalText = result;
-            const usage = parseUsage(obj);
-            if (usage)
-                this.usage = usage;
-            return announced; // The `result` event is emitted by the runner after `close`.
-        }
-        return announced;
-    }
-    handleAssistant(obj) {
-        const message = obj['message'];
-        if (typeof message !== 'object' || message === null)
-            return [];
-        const content = message['content'];
-        if (!Array.isArray(content))
-            return [];
-        const events = [];
-        for (const item of content) {
-            if (typeof item !== 'object' || item === null)
-                continue;
-            const block = item;
-            if (block['type'] === 'text' && typeof block['text'] === 'string') {
-                this.assistantText += block['text'];
-                events.push({ type: 'text', text: block['text'] });
-            }
-            else if (block['type'] === 'tool_use' && typeof block['name'] === 'string') {
-                events.push({ type: 'action', label: block['name'] });
-            }
-        }
-        return events;
-    }
-    /** The final turn: the `result` text, falling back to accumulated assistant text. */
-    result() {
-        const text = this.finalText || this.assistantText;
-        return {
-            text,
-            ...(this.sessionId ? { sessionId: this.sessionId } : {}),
-            ...(this.usage ? { usage: this.usage } : {}),
-        };
-    }
-}
-/**
- * Pull the account's quota standing off a `rate_limit_event` line (#517):
- * `{status, resetsAt, rateLimitType}`. The agent emits one per turn, so this is
- * free telemetry — no extra call, no polling. Returns undefined when the payload
- * is missing the parts we'd gate on, so a malformed line stays silent rather
- * than reporting a bogus reset.
- */
-function parseRateLimit(obj) {
-    const raw = obj['rate_limit_info'];
-    if (typeof raw !== 'object' || raw === null)
-        return undefined;
-    const info = raw;
-    const status = info['status'];
-    const window = info['rateLimitType'];
-    const resetsAt = info['resetsAt'];
-    if (typeof status !== 'string' || typeof window !== 'string')
-        return undefined;
-    if (typeof resetsAt !== 'number' || !Number.isFinite(resetsAt))
-        return undefined;
-    // The agent reports epoch seconds; the rest of the framework speaks millis.
-    return { status, window, resetsAt: resetsAt * 1000 };
-}
-/**
- * Pull token + cost accounting off Claude Code's `result` line (#322):
- * `total_cost_usd` plus a `usage` object of token counts. Returns undefined when
- * the line carries neither, so a driver/agent that omits usage stays usage-free.
- */
-function parseUsage(obj) {
-    const cost = obj['total_cost_usd'];
-    const raw = obj['usage'];
-    const hasUsage = typeof raw === 'object' && raw !== null;
-    if (typeof cost !== 'number' && !hasUsage)
-        return undefined;
-    const usage = (hasUsage ? raw : {});
-    const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : 0);
-    // Omit costUsd when there is no price, never 0: the budget gate reads 0 as "free"
-    // and undefined as "unknown" (#540), and Codex reports tokens without a price.
-    return {
-        ...(typeof cost === 'number' && Number.isFinite(cost) ? { costUsd: cost } : {}),
-        inputTokens: num(usage['input_tokens']),
-        outputTokens: num(usage['output_tokens']),
-        cacheReadTokens: num(usage['cache_read_input_tokens']),
-        cacheCreationTokens: num(usage['cache_creation_input_tokens']),
-    };
-}
-//# sourceMappingURL=claude-code.js.map

package/dist/driver/claude-code.js.map

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

package/dist/driver/cli-session.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 runCliSession} 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 RunCliSessionOptions {
-    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"`. */
-    driver?: string;
-}
-/**
- * Spawn one agent-CLI invocation and resolve with its final turn.
- *
- * Everything here is about the *process*, not the driver: 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 RunCliSessionOptions.parser} knows
- * which CLI is on the other end — a second driver gets all of this for free
- * rather than a second copy of it.
- */
-export declare function runCliSession(opts: RunCliSessionOptions): Promise<DriverTurn>;
-//# sourceMappingURL=cli-session.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cli-session.d.ts","sourceRoot":"","sources":["../../src/driver/cli-session.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,oBAAoB;IACnC,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,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8G7E"}

package/dist/driver/cli-session.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 driver: 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 RunCliSessionOptions.parser} knows
- * which CLI is on the other end — a second driver gets all of this for free
- * rather than a second copy of it.
- */
-export function runCliSession(opts) {
-    return new Promise((resolvePromise, rejectPromise) => {
-        for (const s of opts.signals) {
-            if (s.aborted) {
-                rejectPromise(new Error(`[framework] ${opts.driver ?? '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.driver ?? '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=cli-session.js.map

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

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

package/dist/driver/cloud.d.ts

@@ -1,109 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-import { type Driver, type DriverPromptOptions, type DriverSession, type DriverStartOptions, type DriverTurn } from 'agent-driver';
-/**
- * A {@link Driver} that hands the task to **Claude Code on the web** (#610): it has a cloud
- * session created on claude.ai and returns its id and URL.
- *
- * The session is created by the browser extension, in the user's own signed-in browser,
- * through claude.ai's repository picker (#1328): the run asks its daemon to queue the request
- * — the repository, the pushed hand-off ref, the prompt — and the extension drives the page
- * and reports the session it became. A session created that way is bound to the repository,
- * so it can push its work and open its pull request; the CLI's own `--cloud` flag, the earlier
- * mechanism, produced on some accounts a bundle upload that never could (#1320), and is gone.
- * The account, the auth and the quota are the user's, exactly as with the local driver (#495).
- *
- * So a web run needs four things, and names whichever is missing: a daemon that spawned it
- * (the daemon's URL travels in the run's environment), the browser bridge switched on, the
- * extension present, and a GitHub remote for the picker to name.
- *
- * **What this target is, and is not.** It is a hand-off: the session runs on Anthropic's
- * infrastructure, does its own git worktree and opens its own PR, at 0% local CPU — the
- * whole point of #610. What it is not is a streamed peer like the local, device and
- * Actions targets, and that is not a shortcut in this implementation but a property of
- * the surface: a cloud session exposes **no read-back API** of any kind — no status, no
- * transcript, no output endpoint, only the session URL. So the turn resolves once the
- * session is created, and following the work happens on claude.ai, through the browser
- * bridge's mirror and gate relay (#1237/#1554), or by pulling it back with
- * `claude --teleport <id>`.
- *
- * For the same reason there is no `readCode`: the workspace lives in a cloud VM this
- * machine never sees.
- */
-export declare class CloudDriver implements Driver {
-    private readonly opts;
-    readonly id = "claude-web";
-    constructor(opts?: CloudDriverOptions);
-    start(opts: DriverStartOptions): Promise<DriverSession>;
-}
-/**
- * How a run reaches its daemon's session start-queue (#1328): the daemon's URL, put in the run's
- * environment when it was spawned, and the daemon token from the registry.
- */
-export interface ExtensionStart {
-    daemonUrl: string;
-    token: string;
-    /** Injected in tests; defaults to the global `fetch`. */
-    fetch?: typeof fetch;
-    /** How often to ask where the request stands, in ms. Default 2000. */
-    pollMs?: number;
-}
-/** Options for {@link CloudDriver}. */
-export interface CloudDriverOptions {
-    /**
-     * The daemon whose start-queue the browser extension drains (#1328). Absent on a run no
-     * daemon spawned, which then has nobody to create its session and fails saying so.
-     */
-    extension?: ExtensionStart;
-    /** Give up on session creation after this long, in ms. Default 120000. */
-    timeoutMs?: number;
-    /** Runs git for the pre-hand-off push (#1320). Injected in tests; defaults to real git. */
-    git?: GitRunner;
-    /**
-     * Unique tag mixed into the session id. Default a random token. Injected in tests for a
-     * stable id, and load-bearing in production for the same reason it is in the Actions
-     * driver: a fresh `framework run` process restarts the counter, so without it every
-     * run's first session would carry the same id.
-     */
-    agentTag?: () => string;
-}
-export declare const CLOUD_PROMPT_SEPARATOR = "===============================";
-/**
- * The prompt handed to the cloud session (#1497): the task first, then every block The Framework
- * injects — the framing, a per-call system — behind a labeled rule. On claude.ai this string is
- * read by a human, and the task is what they open the session to find.
- */
-export declare function cloudHandOffPrompt(task: string, ...injected: (string | undefined)[]): string;
-export declare class CloudSession implements DriverSession {
-    private readonly config;
-    private readonly startOpts;
-    readonly id: string;
-    readonly cwd: string;
-    private readonly emit;
-    private readonly framing;
-    private readonly controllers;
-    private disposed;
-    /** The cloud session this agent was handed to, once it exists. Set at most once. */
-    private handedOff;
-    /** The hand-off anchor commit (#1601), once it is on origin. Set at most once, with the hand-off. */
-    private anchorSha;
-    constructor(config: CloudDriverOptions, startOpts: DriverStartOptions);
-    prompt(text: string, opts?: DriverPromptOptions): Promise<DriverTurn>;
-    /**
-     * Hand the session request to the daemon's start-queue and wait for the extension's word
-     * (#1328). Throws, naming the cure, when the daemon has no extension to ask (409) or the
-     * bridge is off (404); throws with the extension's own note when it tried and could not create
-     * the session; throws when the wait was aborted or timed out. The model the run was started
-     * with travels along (#1697): the extension picks it in claude.ai's model menu, so a web run
-     * honours the choice the way a local one does instead of dropping it on the page's default.
-     */
-    private createViaExtension;
-    /**
-     * Report where this agent went. The `first` hand-off emits the `cloud <url>` action the agent
-     * view links through to — mirroring the Actions driver's `run <url>` — and a later pass
-     * says the work is already there, so a loop that keeps prompting cannot read the same turn
-     * as fresh progress and cannot spend a second session.
-     */
-    private report;
-    dispose(): Promise<void>;
-}
-//# sourceMappingURL=cloud.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/driver/cloud.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAIpE,OAAO,EAAY,KAAK,MAAM,EAAoB,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9J;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAY,YAAW,MAAM;IAE5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,QAAQ,CAAC,EAAE,gBAAe;IAC1B,YAA6B,IAAI,GAAE,kBAAuB,EAAI;IAE9D,KAAK,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAEtD;CAIF;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,SAAS,CAAA;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB;AAKD,eAAO,MAAM,sBAAsB,oCAAoC,CAAA;AAEvE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAM5F;AAQD,qBAAa,YAAa,YAAW,aAAa;IAa9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAQ;IACxB,oFAAoF;IACpF,OAAO,CAAC,SAAS,CAAgD;IACjE,qGAAqG;IACrG,OAAO,CAAC,SAAS,CAAoB;IAErC,YACmB,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,kBAAkB,EAO/C;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuD9E;IAED;;;;;;;OAOG;YACW,kBAAkB;IAwChC;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IA2BR,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAI7B;CACF"}