@hover-dev/core 0.17.0 → 0.18.0

package/dist/agents/invoke.js

@@ -1,93 +0,0 @@
-// cross-spawn is a drop-in for child_process.spawn that fixes Windows behaviour
-// around `.cmd`/`.bat` shims (e.g. npm-installed `claude.cmd`). The return type
-// is identical to node:child_process so call sites are unchanged.
-import spawn from 'cross-spawn';
-import { createInterface } from 'node:readline';
-import { buildArgv } from './argv.js';
-import { resolveBinForAgent } from './detect.js';
-import { getAgent } from './registry.js';
-import { AgentNotInstalledError, UnsupportedAgentProtocolError, } from './types.js';
-/**
- * Spawn an agent and yield normalized InvokeEvents as they arrive.
- *
- * Lifecycle: the generator owns the child process. Iterating to completion
- * drains stdout; breaking early (e.g. WS disconnect) runs the finally block
- * which closes readline and SIGTERMs the child, so we never leak orphan
- * agent processes that would keep driving the browser (and burning tokens)
- * after the user has navigated away.
- */
-export async function* invokeAgent(opts) {
-    const descriptor = getAgent(opts.agentId);
-    if (!descriptor) {
-        throw new UnsupportedAgentProtocolError(`Unknown agent: ${opts.agentId}`);
-    }
-    const bin = await resolveBinForAgent(descriptor);
-    if (!bin)
-        throw new AgentNotInstalledError(opts.agentId);
-    const argv = buildArgv(descriptor, opts);
-    const usesStdinPrompt = descriptor.protocol === 'stdin';
-    const child = spawn(bin, argv, {
-        stdio: [usesStdinPrompt ? 'pipe' : 'ignore', 'pipe', 'inherit'],
-        cwd: opts.cwd,
-        // Clear CLAUDECODE so spawning `claude` from inside a Claude Code session
-        // doesn't trip the nested-session guard. Harmless for other agents.
-        // The CLI authenticates via its own logged-in subscription (or inherits any
-        // key already in process.env); opts.env carries the Local LLM endpoint vars.
-        env: {
-            ...process.env,
-            CLAUDECODE: '',
-            ...(opts.env ?? {}),
-        },
-    });
-    const onAbort = () => {
-        if (!child.killed)
-            child.kill('SIGTERM');
-    };
-    if (opts.signal) {
-        if (opts.signal.aborted)
-            onAbort();
-        else
-            opts.signal.addEventListener('abort', onAbort, { once: true });
-    }
-    if (usesStdinPrompt && child.stdin) {
-        child.stdin.write(opts.prompt);
-        child.stdin.end();
-    }
-    const rl = createInterface({ input: child.stdout });
-    const exitPromise = new Promise(res => child.on('exit', c => res(c ?? -1)));
-    const state = {};
-    let sawSessionEnd = false;
-    try {
-        for await (const line of rl) {
-            for (const ev of descriptor.parseEvent(line, state)) {
-                if (ev.kind === 'session_end')
-                    sawSessionEnd = true;
-                yield ev;
-            }
-        }
-        const code = await exitPromise;
-        if (!sawSessionEnd && !opts.signal?.aborted) {
-            // Give the descriptor a chance to synthesize its own terminator from
-            // accumulated state (codex does this — its stream never emits a
-            // session_end). Falls back to a generic error session_end if the
-            // descriptor declines and the child exited non-zero.
-            const synthetic = descriptor.onStreamEnd?.(code, state);
-            if (synthetic) {
-                yield synthetic;
-            }
-            else if (code !== 0) {
-                yield {
-                    kind: 'session_end',
-                    isError: true,
-                    summary: `agent exited with code ${code}`,
-                };
-            }
-        }
-    }
-    finally {
-        rl.close();
-        if (!child.killed)
-            child.kill('SIGTERM');
-        opts.signal?.removeEventListener('abort', onAbort);
-    }
-}

package/dist/agents/qwen.d.ts

@@ -1,17 +0,0 @@
-import type { AgentDescriptor, ParserState } from './types.js';
-export declare const qwenAgent: AgentDescriptor;
-/**
- * Test-only escape hatches, same pattern as cursor.ts / codex.ts.
- */
-export declare const __testing: {
-    freshState: () => ParserState;
-    resetCounters: (state: ParserState) => void;
-    getState: (state: ParserState) => {
-        runningTurns: number;
-        runningSessionId: string | undefined;
-        runningModel: string | undefined;
-        lastAssistantText: string | undefined;
-        sawErrorEvent: boolean;
-    };
-};
-//# sourceMappingURL=qwen.d.ts.map

package/dist/agents/qwen.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"qwen.d.ts","sourceRoot":"","sources":["../../src/agents/qwen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA8B,WAAW,EAAE,MAAM,YAAY,CAAC;AAoJ3F,eAAO,MAAM,SAAS,EAAE,eAqJvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS;sBACJ,WAAW;2BACJ,WAAW;sBAChB,WAAW;;;;;;;CAU9B,CAAC"}

package/dist/agents/qwen.js

@@ -1,172 +0,0 @@
-import { HOVER_PROMPT_PREFACE, stripMcpPrefix } from './shared.js';
-function qwenState(state) {
-    if (typeof state.runningTurns !== 'number') {
-        state.runningTurns = 0;
-        state.runningSessionId = undefined;
-        state.runningModel = undefined;
-        state.lastAssistantText = undefined;
-        state.sawErrorEvent = false;
-        state.toolNameByUseId = new Map();
-    }
-    return state;
-}
-function resetQwenCounters(s) {
-    s.runningTurns = 0;
-    s.runningSessionId = undefined;
-    s.runningModel = undefined;
-    s.lastAssistantText = undefined;
-    s.sawErrorEvent = false;
-    s.toolNameByUseId.clear();
-}
-export const qwenAgent = {
-    id: 'qwen',
-    binName: 'qwen',
-    protocol: 'argv',
-    streamFormat: 'json-lines',
-    sandboxStrength: 'soft',
-    display: {
-        label: 'Qwen Code',
-        tagline: 'Qwen Code — soft sandbox (no built-in tool deny-list)',
-        homepage: 'https://github.com/QwenLM/qwen-code',
-        installHint: 'npm install -g @qwen-code/qwen-code@latest',
-    },
-    buildArgs(opts) {
-        const args = ['-p', opts.prompt];
-        // NDJSON streaming output.
-        args.push('--output-format', 'stream-json');
-        // Auto-approve all tool calls so the run doesn't hang. The newer
-        // canonical form is --approval-mode=yolo; --yolo is deprecated but
-        // still works in 2026-05. We use the modern form.
-        args.push('--approval-mode', 'yolo');
-        if (opts.model) {
-            args.push('--model', opts.model);
-        }
-        if (opts.sessionId) {
-            // --resume <sessionId> is the documented headless form. --continue
-            // (no arg) picks the most recent — NOT what we want when a specific
-            // session was passed.
-            args.push('--resume', opts.sessionId);
-        }
-        // Qwen has a real --append-system-prompt flag — use it instead of
-        // prepending to the user prompt. Concatenate the standing Hover-mode
-        // preface with whatever the caller appended.
-        const sysPrompt = opts.appendSystemPrompt && opts.appendSystemPrompt.trim().length > 0
-            ? `${HOVER_PROMPT_PREFACE} ${opts.appendSystemPrompt}`
-            : HOVER_PROMPT_PREFACE;
-        args.push('--append-system-prompt', sysPrompt);
-        // MCP servers configured in ~/.qwen/settings.json — no per-invocation
-        // --mcp-config equivalent. Same constraint as cursor / codex.
-        // No equivalent for --max-budget-usd or --allowedTools / --disallowedTools.
-        return args;
-    },
-    parseEvent(line, state = {}) {
-        if (!line.trim())
-            return [];
-        let ev;
-        try {
-            ev = JSON.parse(line);
-        }
-        catch {
-            return [{ kind: 'raw', line }];
-        }
-        const s = qwenState(state);
-        const out = [];
-        if (ev.type === 'system' && ev.subtype === 'session_start') {
-            resetQwenCounters(s);
-            s.runningModel = ev.model;
-            if (ev.session_id) {
-                s.runningSessionId = ev.session_id;
-                out.push({ kind: 'session_start', sessionId: ev.session_id, model: ev.model });
-            }
-            return out;
-        }
-        if (ev.type === 'assistant' && ev.message) {
-            s.runningTurns += 1;
-            // Emit a usage event so the widget can advance its turn counter.
-            // costUsd intentionally omitted — qwen doesn't publish $ in stream.
-            out.push({ kind: 'usage', turns: s.runningTurns });
-            for (const block of ev.message.content ?? []) {
-                if (block.type === 'text') {
-                    const text = block.text?.trim();
-                    if (text) {
-                        s.lastAssistantText = text;
-                        out.push({ kind: 'text', text });
-                    }
-                }
-                else if (block.type === 'tool_use') {
-                    const rawName = block.name ?? '';
-                    const tool = stripMcpPrefix(rawName);
-                    if (block.id)
-                        s.toolNameByUseId.set(block.id, tool);
-                    out.push({ kind: 'tool_use', tool, input: block.input });
-                }
-            }
-            return out;
-        }
-        // tool_result blocks are wrapped in `user` messages (Anthropic Messages
-        // convention). We surface them as tool_result events.
-        if (ev.type === 'user' && ev.message) {
-            for (const block of ev.message.content ?? []) {
-                if (block.type === 'tool_result') {
-                    const isError = block.is_error === true;
-                    out.push({ kind: 'tool_result', isError });
-                }
-            }
-            return out;
-        }
-        if (ev.type === 'result') {
-            const isError = ev.is_error === true ||
-                (typeof ev.subtype === 'string' && /error|fail/i.test(ev.subtype));
-            if (isError)
-                s.sawErrorEvent = true;
-            out.push({
-                kind: 'session_end',
-                turns: s.runningTurns,
-                // costUsd intentionally undefined — qwen doesn't publish $.
-                isError,
-                summary: ev.result ?? s.lastAssistantText,
-            });
-            return out;
-        }
-        // Qwen emits various error envelopes mid-stream; surface them as text.
-        if (ev.type && /error/i.test(ev.type)) {
-            s.sawErrorEvent = true;
-            const msg = ev.error?.message ?? ev.text ?? ev.result ?? `[qwen] ${ev.type}`;
-            out.push({ kind: 'text', text: msg });
-            return out;
-        }
-        return [];
-    },
-    /**
-     * Qwen's `result` event already produces a session_end via parseEvent;
-     * this fallback is for the case where the child exits without emitting a
-     * `result` (e.g. crash, signal). Mirrors codex.ts / cursor.ts shape.
-     */
-    onStreamEnd(exitCode, state = {}) {
-        const s = qwenState(state);
-        return {
-            kind: 'session_end',
-            turns: s.runningTurns,
-            // costUsd intentionally undefined — see parseEvent note.
-            isError: s.sawErrorEvent || (exitCode != null && exitCode !== 0),
-            summary: s.lastAssistantText,
-        };
-    },
-};
-/**
- * Test-only escape hatches, same pattern as cursor.ts / codex.ts.
- */
-export const __testing = {
-    freshState: () => ({}),
-    resetCounters: (state) => resetQwenCounters(qwenState(state)),
-    getState: (state) => {
-        const s = qwenState(state);
-        return {
-            runningTurns: s.runningTurns,
-            runningSessionId: s.runningSessionId,
-            runningModel: s.runningModel,
-            lastAssistantText: s.lastAssistantText,
-            sawErrorEvent: s.sawErrorEvent,
-        };
-    },
-};

package/dist/agents/registry.d.ts

@@ -1,19 +0,0 @@
-import type { AgentDescriptor } from './types.js';
-/**
- * Registry of agents Hover can drive.
- *
- * To add support for another agent (e.g. cline, continue, kilo), implement
- * its AgentDescriptor in its own file and register it here. The rest of the
- * system — detect, argv, invoke, service, widget — works without further
- * changes.
- *
- * Insertion order is the order shown in the widget's agent dropdown, so put
- * the recommended primary first. The two hard-sandbox / first-party agents
- * (claude, codex) lead; the soft-sandbox third-party agents follow in the
- * order they were added.
- */
-export declare const AGENTS: Record<string, AgentDescriptor>;
-export declare function getAgent(id: string): AgentDescriptor | undefined;
-/** Stable, insertion-ordered list of all registered agents. */
-export declare function listAgents(): AgentDescriptor[];
-//# sourceMappingURL=registry.d.ts.map

package/dist/agents/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAKlD,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEhE;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,IAAI,eAAe,EAAE,CAE9C"}

package/dist/agents/registry.js

@@ -1,30 +0,0 @@
-import { claudeAgent } from './claude.js';
-import { codexAgent } from './codex.js';
-import { geminiAgent } from './gemini.js';
-import { qwenAgent } from './qwen.js';
-/**
- * Registry of agents Hover can drive.
- *
- * To add support for another agent (e.g. cline, continue, kilo), implement
- * its AgentDescriptor in its own file and register it here. The rest of the
- * system — detect, argv, invoke, service, widget — works without further
- * changes.
- *
- * Insertion order is the order shown in the widget's agent dropdown, so put
- * the recommended primary first. The two hard-sandbox / first-party agents
- * (claude, codex) lead; the soft-sandbox third-party agents follow in the
- * order they were added.
- */
-export const AGENTS = {
-    [claudeAgent.id]: claudeAgent,
-    [codexAgent.id]: codexAgent,
-    [geminiAgent.id]: geminiAgent,
-    [qwenAgent.id]: qwenAgent,
-};
-export function getAgent(id) {
-    return AGENTS[id];
-}
-/** Stable, insertion-ordered list of all registered agents. */
-export function listAgents() {
-    return Object.values(AGENTS);
-}

package/dist/agents/shared.d.ts

@@ -1,28 +0,0 @@
-/**
- * Cross-agent helpers shared by the soft-sandbox descriptors
- * (codex / cursor / gemini / qwen / aider).
- *
- * These agents all need the same two things:
- *   1. A standing "HOVER-mode" instruction preface that tells the agent to
- *      drive the browser via the Playwright MCP tools only and not to touch
- *      its built-in shell / file-edit tools. Each agent injects it through a
- *      different channel (cursor / gemini / aider prepend it to the prompt,
- *      qwen passes it via --append-system-prompt, codex via
- *      `-c developer_instructions=`), so this module owns only the *text*, not
- *      the injection.
- *   2. Normalising the `mcp__playwright__` / `mcp__hover-playwright__` prefix
- *      off a raw tool name so the emitted tool names line up across agents.
- *
- * codex deliberately does NOT use HOVER_PROMPT_PREFACE — it keeps its own
- * wording ("Do NOT call …", "emit a short agent_message summary …") that is
- * tuned to codex's event vocabulary. See codex.ts.
- */
-/**
- * The standing HOVER-mode instruction shared by cursor / gemini / qwen / aider.
- * codex carries a near-identical but intentionally different variant inline.
- */
-export declare const HOVER_PROMPT_PREFACE: string;
-/** Strip the `mcp__playwright__` / `mcp__hover-playwright__` prefix so tool
- *  names match the normalised names every agent emits. */
-export declare function stripMcpPrefix(raw: string): string;
-//# sourceMappingURL=shared.d.ts.map

package/dist/agents/shared.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/agents/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAMtB,CAAC;AAEZ;0DAC0D;AAC1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/agents/shared.js

@@ -1,35 +0,0 @@
-/**
- * Cross-agent helpers shared by the soft-sandbox descriptors
- * (codex / cursor / gemini / qwen / aider).
- *
- * These agents all need the same two things:
- *   1. A standing "HOVER-mode" instruction preface that tells the agent to
- *      drive the browser via the Playwright MCP tools only and not to touch
- *      its built-in shell / file-edit tools. Each agent injects it through a
- *      different channel (cursor / gemini / aider prepend it to the prompt,
- *      qwen passes it via --append-system-prompt, codex via
- *      `-c developer_instructions=`), so this module owns only the *text*, not
- *      the injection.
- *   2. Normalising the `mcp__playwright__` / `mcp__hover-playwright__` prefix
- *      off a raw tool name so the emitted tool names line up across agents.
- *
- * codex deliberately does NOT use HOVER_PROMPT_PREFACE — it keeps its own
- * wording ("Do NOT call …", "emit a short agent_message summary …") that is
- * tuned to codex's event vocabulary. See codex.ts.
- */
-/**
- * The standing HOVER-mode instruction shared by cursor / gemini / qwen / aider.
- * codex carries a near-identical but intentionally different variant inline.
- */
-export const HOVER_PROMPT_PREFACE = [
-    'You are operating in Hover, a browser-testing tool.',
-    'Use ONLY the MCP playwright tools (prefixed `mcp__playwright__` / `mcp__hover-playwright__`) to drive the browser.',
-    'Do NOT use shell, file-edit, web-search, or any other built-in tool.',
-    'Do NOT navigate to a URL the user is already on; check the page state via `browser_snapshot` first.',
-    'When the task is complete, emit a short summary and stop.',
-].join(' ');
-/** Strip the `mcp__playwright__` / `mcp__hover-playwright__` prefix so tool
- *  names match the normalised names every agent emits. */
-export function stripMcpPrefix(raw) {
-    return raw.replace(/^mcp__playwright__/, '').replace(/^mcp__hover-playwright__/, '');
-}

package/dist/agents/types.d.ts

@@ -1,194 +0,0 @@
-/**
- * Local CLI Agent First — agent abstraction layer.
- *
- * Hover does not bundle any AI runtime. It spawns whatever coding-agent CLI the
- * user has on PATH (`claude`, `codex`, `cursor`, `aider`, ...) and treats it as
- * a strategy implementation behind this interface.
- *
- * To add a new agent: write an AgentDescriptor and register it in registry.ts.
- */
-export type AgentProtocol = 'argv' | 'stdin' | 'acp' | 'pi-rpc';
-export type StreamFormat = 'stream-json' | 'sse' | 'plain-text' | 'json-lines';
-export declare class UnsupportedAgentProtocolError extends Error {
-    constructor(message: string);
-}
-export declare class AgentNotInstalledError extends Error {
-    readonly agentId: string;
-    constructor(agentId: string);
-}
-export interface InvokeOptions {
-    agentId: string;
-    prompt: string;
-    mcpConfig?: string;
-    allowedTools?: string[];
-    disallowedTools?: string[];
-    maxBudgetUsd?: number;
-    /** Hard ceiling on agent turns (~steps) — claude `--max-turns`. Used by QA
-     *  intensity to bound an exploratory run by step count. */
-    maxTurns?: number;
-    model?: string;
-    /** Reasoning-effort level for the run. claude → `--effort <level>` (low /
-     *  medium / high / xhigh / max); codex → `-c model_reasoning_effort=<level>`
-     *  (minimal / low / medium / high / xhigh). The caller is responsible for
-     *  passing a level the chosen model actually supports. */
-    effort?: string;
-    cwd?: string;
-    sessionId?: string;
-    /** Extra text appended to the agent's system prompt (claude: via
-     *  --append-system-prompt). Used to inject session-specific context like
-     *  "the user's current Chrome tab is already on http://localhost:5173/,
-     *  don't browser_navigate there". */
-    appendSystemPrompt?: string;
-    /** Extra environment variables for the spawned CLI (merged over process.env).
-     *  Used for the "Local LLM" path: qwen-code reads OPENAI_BASE_URL /
-     *  OPENAI_API_KEY to target a user's self-hosted OpenAI-compatible endpoint. */
-    env?: Record<string, string>;
-    /** Aborts the spawned child if signaled. Used to stop an orphan run when
-     *  the WebSocket caller disconnects (e.g. user reloads the dev page). */
-    signal?: AbortSignal;
-}
-/**
- * Normalized event emitted by every agent, regardless of its native wire format.
- * Each agent's `parseEvent` translates its own stream into these.
- */
-export type InvokeEvent = {
-    kind: 'session_start';
-    sessionId: string;
-    model?: string;
-} | {
-    kind: 'mcp_status';
-    server: string;
-    status: string;
-} | {
-    kind: 'tool_use';
-    tool: string;
-    input: unknown;
-    costUsdSnapshot?: number;
-    tokensSnapshot?: number;
-} | {
-    kind: 'tool_result';
-    isError?: boolean;
-    preview?: string;
-} | {
-    kind: 'text';
-    text: string;
-}
-/** Running cost / turn-count update emitted mid-session so the widget can
- *  show a live $ counter without waiting for session_end. Claude Code's
- *  stream-json includes `total_cost_usd` on intermediate result-ish events;
- *  agents that don't surface running cost simply never emit this. */
- | {
-    kind: 'usage';
-    costUsd?: number;
-    turns?: number;
-    tokens?: number;
-}
-/** End-of-session event. Three terminal states the widget renders distinctly:
- *
- *   - normal completion: `isError: false`, no `cancelled` flag
- *   - agent / runtime failure: `isError: true`, no `cancelled` flag
- *   - user-initiated stop: `cancelled: true` (and we leave `isError: false`
- *     so downstream "did the agent fail?" predicates don't conflate
- *     "user pressed Stop" with "agent crashed mid-run"). The widget
- *     renders this as a neutral "Stopped" state, not a red Failed card.
- */
- | {
-    kind: 'session_end';
-    turns?: number;
-    costUsd?: number;
-    tokens?: number;
-    isError?: boolean;
-    cancelled?: boolean;
-    summary?: string;
-} | {
-    kind: 'raw';
-    line: string;
-};
-/**
- * How tightly the agent's tool surface can be locked down per invocation.
- *
- *   'hard' — the agent CLI accepts a deny-list / allow-list that effectively
- *            removes built-in tools (shell, file edit, etc.) so the only
- *            callable surface is whatever MCP servers we configure. Claude
- *            Code's `--strict-mcp-config` + `--allowedTools mcp__playwright`
- *            + `--disallowedTools <every built-in>` is the canonical example.
- *
- *   'soft' — the agent CLI does not expose a way to disable its built-in
- *            tools (shell, fs). We can constrain side-effects via OS-level
- *            sandbox flags (e.g. codex's `--sandbox read-only`) and we lean
- *            on a strict `developer_instructions` system-prompt to nudge the
- *            agent toward MCP-only behavior, but a determined / hallucinating
- *            agent COULD still try a built-in shell call. The widget should
- *            mark this agent with a warning indicator.
- */
-export type SandboxStrength = 'hard' | 'soft';
-/**
- * Human-facing metadata for the widget's agent picker. None of these affect
- * agent invocation — they only shape how the agent is presented in the UI.
- */
-export interface AgentDisplay {
-    /** Pretty name for the dropdown ("Claude Code", "OpenAI Codex"). */
-    label: string;
-    /** One-line tagline shown under the label. */
-    tagline?: string;
-    /** Vendor / source URL — clicking the agent name in the widget can open
-     *  this in a new tab when the agent isn't installed. */
-    homepage?: string;
-    /** Shell command the user can run to install (copy-paste from a tooltip
-     *  in the widget when the agent is listed but not on PATH). */
-    installHint?: string;
-}
-/**
- * Per-invocation parser state. A fresh object is created by `invokeAgent`
- * for each spawn and passed to both `parseEvent` and `onStreamEnd`.
- *
- * Descriptors that need to accumulate state across lines (cost, turn count,
- * last agent message for synthesized session_end, etc.) read and write
- * their own keys on this object. There is no shared shape — each agent
- * uses whatever fields it needs.
- *
- * Why: module-level state in claude.ts / codex.ts worked only because the
- * service enforces one in-flight invocation per Node process. Two concurrent
- * agent runs (future: tests in parallel, in-process workers) would silently
- * smear their cost accumulators together. Threading the state object per
- * invocation removes that hazard at zero runtime cost.
- */
-export type ParserState = Record<string, unknown>;
-export interface AgentDescriptor {
-    id: string;
-    binName: string;
-    protocol: AgentProtocol;
-    streamFormat: StreamFormat;
-    sandboxStrength: SandboxStrength;
-    display: AgentDisplay;
-    /** Hard-sandbox agents pass this list to `disallowedTools` when the
-     *  service-level allow/deny config isn't explicitly overridden. Lets the
-     *  per-CLI deny list live alongside its descriptor instead of as a magic
-     *  array in the service. Soft-sandbox agents leave this undefined. */
-    defaultDisallowedTools?: readonly string[];
-    /** A cheap/fast model id for non-interactive refinement work (the F7 optimize
-     *  pass) where the big model isn't worth the cost. Used when the user hasn't
-     *  set `hover.optimizeModel`; undefined → fall back to the session model. */
-    cheapModel?: string;
-    buildArgs(opts: InvokeOptions): string[];
-    /**
-     * Parse a single line of agent stdout into normalised InvokeEvents.
-     * `state` is a per-invocation scratch pad (see ParserState). Optional
-     * for callers that don't accumulate across lines (and for unit tests
-     * that don't care about cost / turn carry-over) — descriptors that
-     * DO accumulate must check / initialise the state object themselves.
-     */
-    parseEvent(line: string, state?: ParserState): InvokeEvent[];
-    /**
-     * Optional. Called once after the agent's stream closes, with the child's
-     * exit code (or null if it was aborted). Lets agents whose protocol does
-     * NOT emit an explicit session-terminating event synthesize one from
-     * accumulated parser state. Returns `null` if the agent's own `parseEvent`
-     * already emitted a `session_end` and nothing further is needed.
-     *
-     * Used by codex.ts (no native session_end). Claude does not implement
-     * this — `result` events terminate naturally.
-     */
-    onStreamEnd?(exitCode: number | null, state?: ParserState): InvokeEvent | null;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

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

package/dist/agents/types.js

@@ -1,23 +0,0 @@
-/**
- * Local CLI Agent First — agent abstraction layer.
- *
- * Hover does not bundle any AI runtime. It spawns whatever coding-agent CLI the
- * user has on PATH (`claude`, `codex`, `cursor`, `aider`, ...) and treats it as
- * a strategy implementation behind this interface.
- *
- * To add a new agent: write an AgentDescriptor and register it in registry.ts.
- */
-export class UnsupportedAgentProtocolError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'UnsupportedAgentProtocolError';
-    }
-}
-export class AgentNotInstalledError extends Error {
-    agentId;
-    constructor(agentId) {
-        super(`Agent "${agentId}" is not installed (binary not found on PATH).`);
-        this.agentId = agentId;
-        this.name = 'AgentNotInstalledError';
-    }
-}

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-export * from './agents/index.js';
-export { connectAndListTabs } from './playwright/preflight.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,2 +0,0 @@
-export * from './agents/index.js';
-export { connectAndListTabs } from './playwright/preflight.js';

package/dist/mcp/actuateServer.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=actuateServer.d.ts.map

package/dist/mcp/actuateServer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"actuateServer.d.ts","sourceRoot":"","sources":["../../src/mcp/actuateServer.ts"],"names":[],"mappings":""}