@openagt/dashboard 0.0.0-stage → 0.8.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"child-registry.d.ts","sourceRoot":"","sources":["../../src/driver/child-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAMlE;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/driver/child-registry.js

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+/** Live process-group leaders we spawned, by pid. Force-killed on our exit. */
+const live = new Set();
+let exitHookInstalled = false;
+/**
+ * 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 function killTree(pid, signal) {
+    try {
+        process.kill(-pid, signal);
+    }
+    catch {
+        // Group already gone, or pid never led one; nothing to do.
+    }
+}
+/** Track a detached child so it is force-killed if the framework exits first. */
+export function registerChild(pid) {
+    installExitHook();
+    live.add(pid);
+}
+/** Stop tracking a child that has already exited (or been killed). */
+export function unregisterChild(pid) {
+    live.delete(pid);
+}
+function installExitHook() {
+    if (exitHookInstalled)
+        return;
+    exitHookInstalled = true;
+    // `exit` fires on normal completion, process.exit(), and after an uncaught
+    // error unwinds — sync-only, so a plain group SIGKILL is all we can (and need
+    // to) do. Signal deaths (SIGINT/SIGTERM) are handled by the CLI, which aborts
+    // the agent first; this is the last-resort net for every other exit path.
+    process.on('exit', () => {
+        for (const pid of live)
+            killTree(pid, 'SIGKILL');
+    });
+}
+//# sourceMappingURL=child-registry.js.map

package/dist/driver/child-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-registry.js","sourceRoot":"","sources":["../../src/driver/child-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,+EAA+E;AAC/E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;AAC9B,IAAI,iBAAiB,GAAG,KAAK,CAAA;AAE7B;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAsB;IAC1D,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,eAAe,EAAE,CAAA;IACjB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACf,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AAClB,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,iBAAiB;QAAE,OAAM;IAC7B,iBAAiB,GAAG,IAAI,CAAA;IACxB,2EAA2E;IAC3E,8EAA8E;IAC9E,8EAA8E;IAC9E,0EAA0E;IAC1E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/driver/claude-code-quota.d.ts

@@ -0,0 +1,40 @@
+import type { DriverQuota } from './types.js';
+import type { SpawnLike } from './cli-session.js';
+/**
+ * Parse Claude Code's `/usage` readout (#521).
+ *
+ * The agent prints prose, so this is a text parse and a reworded readout is a
+ * real failure mode. It fails to `unrecognized` rather than to an empty reading:
+ * a silent zero would read as "nothing used" and let a consumption limit run the
+ * account dry.
+ */
+export declare function parseQuotaReadout(text: string): DriverQuota;
+/** Options for {@link readClaudeQuota}. */
+export interface ReadClaudeQuotaOptions {
+    /** CLI binary to spawn. Default `"claude"` (resolved on `PATH`). */
+    bin?: string;
+    /** Working directory for the child. The read is account-wide, so this is incidental. */
+    cwd?: string;
+    /** Environment for the child process. Default `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** `spawn` override for tests. Default `node:child_process.spawn`. */
+    spawn?: SpawnLike;
+    /** Abort the read. */
+    signal?: AbortSignal;
+    /** Override the timeout. Default {@link READ_TIMEOUT_MS}. */
+    timeoutMs?: number;
+}
+/**
+ * Ask Claude Code where the account's subscription quota stands (#521).
+ *
+ * Runs the CLI's own `/usage` command in print mode. Costs nothing: verified on
+ * 2.1.210 as `total_cost_usd: 0` across zero turns and zero tokens, because the
+ * CLI answers it locally rather than by prompting a model. It reaches Anthropic
+ * itself, with its own credentials, so The Framework never reads or handles the
+ * user's token.
+ *
+ * Never pass `--bare` here: it pins the CLI to API-key auth and never reads the
+ * OAuth credentials, so the subscription quota this reads would vanish.
+ */
+export declare function readClaudeQuota(opts?: ReadClaudeQuotaOptions): Promise<DriverQuota>;
+//# sourceMappingURL=claude-code-quota.d.ts.map

package/dist/driver/claude-code-quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-quota.d.ts","sourceRoot":"","sources":["../../src/driver/claude-code-quota.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,YAAY,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAkCjD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAqB3D;AAED,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,sBAA2B,GAAG,OAAO,CAAC,WAAW,CAAC,CAmDvF"}

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

@@ -0,0 +1,144 @@
+import { spawn as nodeSpawn } from 'node:child_process';
+/** How long we wait for the readout before calling it a timeout. */
+const READ_TIMEOUT_MS = 20_000;
+/**
+ * Present in both subscription headers Claude Code can print (`"your
+ * subscription"` and, mid-overage, `"your overages"`), and in neither
+ * non-subscription case. Matching the shared tail rather than the word
+ * "subscription" is deliberate: an account burning overage still has a quota to
+ * report, and keying on "subscription" would read it as having none.
+ */
+const SUBSCRIPTION_HEADER = /to power your Claude Code usage/;
+/**
+ * One `"<label>: <n>% used · resets <when>"` line.
+ *
+ * Anchored and strict on `% used` immediately after the colon, because the same
+ * readout carries lines that are shaped just closely enough to match a lazier
+ * pattern (`"Top skills: /dataviz 2%, /claude-api 1%"`, `"  70% of your usage
+ * was at >150k context"`).
+ */
+const WINDOW_LINE = /^(.+?):\s+(\d+(?:\.\d+)?)% used(?:\s*·\s*(.+))?$/;
+/** Strips the `resets` verb, which is prose framing rather than part of the value. */
+const RESETS_PREFIX = /^resets\s+/;
+function windowKind(label) {
+    if (/^current session$/i.test(label))
+        return 'session';
+    if (/^current week \(all models\)$/i.test(label))
+        return 'week';
+    if (/^current week \(.+\)$/i.test(label))
+        return 'week-model';
+    return 'unknown';
+}
+/**
+ * Parse Claude Code's `/usage` readout (#521).
+ *
+ * The agent prints prose, so this is a text parse and a reworded readout is a
+ * real failure mode. It fails to `unrecognized` rather than to an empty reading:
+ * a silent zero would read as "nothing used" and let a consumption limit run the
+ * account dry.
+ */
+export function parseQuotaReadout(text) {
+    const windows = [];
+    for (const line of text.split('\n')) {
+        const match = WINDOW_LINE.exec(line.trim());
+        if (!match)
+            continue;
+        const [, label, percent, resets] = match;
+        if (label === undefined || percent === undefined)
+            continue;
+        const resetsAtText = resets?.replace(RESETS_PREFIX, '').trim();
+        windows.push({
+            label,
+            kind: windowKind(label),
+            percentUsed: Number(percent),
+            ...(resetsAtText ? { resetsAtText } : {}),
+        });
+    }
+    if (windows.length > 0)
+        return { available: true, windows };
+    // No windows and no subscription header: the account has no quota to report
+    // (API-key auth). With the header, it does have one and we simply failed to
+    // read it, which is a parser problem and must not masquerade as the former.
+    return { available: false, reason: SUBSCRIPTION_HEADER.test(text) ? 'unrecognized' : 'no-subscription' };
+}
+/**
+ * Ask Claude Code where the account's subscription quota stands (#521).
+ *
+ * Runs the CLI's own `/usage` command in print mode. Costs nothing: verified on
+ * 2.1.210 as `total_cost_usd: 0` across zero turns and zero tokens, because the
+ * CLI answers it locally rather than by prompting a model. It reaches Anthropic
+ * itself, with its own credentials, so The Framework never reads or handles the
+ * user's token.
+ *
+ * Never pass `--bare` here: it pins the CLI to API-key auth and never reads the
+ * OAuth credentials, so the subscription quota this reads would vanish.
+ */
+export function readClaudeQuota(opts = {}) {
+    return new Promise(resolvePromise => {
+        if (opts.signal?.aborted) {
+            resolvePromise({ available: false, reason: 'timeout' });
+            return;
+        }
+        const spawn = opts.spawn ?? nodeSpawn;
+        const child = spawn(opts.bin ?? 'claude', ['-p', '/usage', '--output-format', 'json'], {
+            cwd: opts.cwd ?? process.cwd(),
+            env: opts.env ?? process.env,
+        });
+        let settled = false;
+        // Raw bytes, decoded once at the end: a per-chunk `String(chunk)` corrupts a multibyte
+        // UTF-8 codepoint split across two chunks (the readout's `·` is one), and a corrupted
+        // readout parses as 'unrecognized' instead of the real quota.
+        const chunks = [];
+        const settle = (quota) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            opts.signal?.removeEventListener('abort', onAbort);
+            resolvePromise(quota);
+        };
+        const onAbort = () => {
+            child.kill('SIGTERM');
+            settle({ available: false, reason: 'timeout' });
+        };
+        opts.signal?.addEventListener('abort', onAbort);
+        // Deliberately not unref'd: this timer is the only thing guaranteeing the
+        // promise settles, and an unref'd one never fires once the loop goes idle,
+        // leaving the caller awaiting forever. `settle` clears it either way.
+        const timer = setTimeout(() => {
+            child.kill('SIGTERM');
+            settle({ available: false, reason: 'timeout' });
+        }, opts.timeoutMs ?? READ_TIMEOUT_MS);
+        child.stdout?.on('data', (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
+        // ENOENT lands here rather than as a non-zero exit.
+        child.on('error', () => settle({ available: false, reason: 'agent-not-found' }));
+        child.on('close', code => {
+            if (code !== 0) {
+                settle({ available: false, reason: 'fetch-failed' });
+                return;
+            }
+            settle(parseQuotaResponse(Buffer.concat(chunks).toString('utf8')));
+        });
+    });
+}
+/** Unwrap the CLI's `--output-format json` envelope and parse the readout inside it. */
+function parseQuotaResponse(stdout) {
+    let envelope;
+    try {
+        envelope = JSON.parse(stdout);
+    }
+    catch {
+        return { available: false, reason: 'unrecognized' };
+    }
+    if (typeof envelope !== 'object' || envelope === null)
+        return { available: false, reason: 'unrecognized' };
+    const obj = envelope;
+    // The CLI's own failure arm, e.g. its usage fetch was refused upstream.
+    if (obj['is_error'] === true)
+        return { available: false, reason: 'fetch-failed' };
+    const result = obj['result'];
+    if (typeof result !== 'string')
+        return { available: false, reason: 'unrecognized' };
+    return parseQuotaReadout(result);
+}
+//# sourceMappingURL=claude-code-quota.js.map

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

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

package/dist/driver/claude-code.d.ts

@@ -0,0 +1,104 @@
+import { type RunCliSessionOptions, type SpawnLike } from './cli-session.js';
+import type { Driver, DriverEvent, DriverPromptOptions, DriverQuota, DriverSession, DriverStartOptions, DriverTurn } from './types.js';
+/** Claude Code permission modes we pass through to the CLI. */
+export type PermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan';
+/** A stdio MCP server spec, as written into the `--mcp-config` file (#452). */
+export interface McpServerSpec {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/** Options for {@link ClaudeCodeDriver}. */
+export interface ClaudeCodeDriverOptions {
+    /** CLI binary to spawn. Default `"claude"` (resolved on `PATH`). */
+    bin?: string;
+    /**
+     * Permission mode. Default `"acceptEdits"` so file writes are non-interactive.
+     * A fully autonomous build that also runs installs / tests needs
+     * `"bypassPermissions"` (or {@link dangerouslySkipPermissions}).
+     */
+    permissionMode?: PermissionMode;
+    /** Add `--dangerously-skip-permissions`. Only for sandboxes with no network. */
+    dangerouslySkipPermissions?: boolean;
+    /** Extra CLI args appended verbatim (escape hatch). */
+    extraArgs?: string[];
+    /**
+     * MCP servers to expose to the agent for this session (#452). Written to a
+     * temp config file passed via `--mcp-config`, so they merge with the user's
+     * own configured MCP servers rather than replacing them. Used by `--browser`
+     * to wire chrome-devtools-mcp (a real browser + DevTools tools) into the agent.
+     */
+    mcpServers?: Record<string, McpServerSpec>;
+    /** Environment for the child process. Default `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** `spawn` override for tests. Default `node:child_process.spawn`. */
+    spawn?: SpawnLike;
+}
+/**
+ * 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 declare class ClaudeCodeDriver implements Driver {
+    private readonly opts;
+    readonly id = "claude-code";
+    constructor(opts?: ClaudeCodeDriverOptions);
+    start(opts: DriverStartOptions): Promise<DriverSession>;
+    /** Where the account's subscription quota stands (#521). Account-wide, so no session. */
+    readQuota(opts?: {
+        signal?: AbortSignal;
+    }): Promise<DriverQuota>;
+}
+/** One workspace-bound Claude Code session. `prompt` is a fresh CLI invocation. */
+export declare class ClaudeCodeSession implements DriverSession {
+    private readonly config;
+    private readonly startOpts;
+    readonly id: string;
+    readonly cwd: string;
+    /** Path to the written `--mcp-config` file, lazily created on first use. */
+    private 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.
+     */
+    private lastSessionId;
+    constructor(config: ClaudeCodeDriverOptions, startOpts: DriverStartOptions);
+    prompt(text: string, opts?: DriverPromptOptions): Promise<DriverTurn>;
+    readCode(path: string): Promise<string>;
+    dispose(): Promise<void>;
+    private buildArgs;
+    /**
+     * 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.
+     */
+    private mcpConfigFile;
+}
+/** Spawn one Claude Code invocation and resolve with its final turn. */
+export declare function runClaude(opts: Omit<RunCliSessionOptions, 'parser' | 'driver'>): Promise<DriverTurn>;
+/**
+ * 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 declare class StreamJsonParser {
+    private finalText;
+    private assistantText;
+    private sessionId?;
+    private usage?;
+    /** Feed one line; returns the events it produced (may be empty). */
+    push(line: string): DriverEvent[];
+    private handleAssistant;
+    /** The final turn: the `result` text, falling back to accumulated assistant text. */
+    result(): DriverTurn;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/driver/claude-code.d.ts.map

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