@hover-dev/core 0.16.0 → 0.18.0

package/dist/agents/gemini.js

@@ -1,186 +0,0 @@
-import { HOVER_PROMPT_PREFACE, stripMcpPrefix } from './shared.js';
-function geminiState(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 resetGeminiCounters(s) {
-    s.runningTurns = 0;
-    s.runningSessionId = undefined;
-    s.runningModel = undefined;
-    s.lastAssistantText = undefined;
-    s.sawErrorEvent = false;
-    s.toolNameByUseId.clear();
-}
-/**
- * Extract assistant text from a `message` event whose `content` may be a
- * plain string OR an array of `{type:'text', text}` content blocks. Gemini's
- * docs aren't explicit on which shape ships per build, so we handle both.
- */
-function extractMessageText(ev) {
-    if (typeof ev.content === 'string') {
-        const t = ev.content.trim();
-        return t.length > 0 ? t : undefined;
-    }
-    if (Array.isArray(ev.content)) {
-        const parts = ev.content
-            .filter(b => b.type === 'text' && typeof b.text === 'string')
-            .map(b => b.text.trim())
-            .filter(t => t.length > 0);
-        return parts.length > 0 ? parts.join('\n') : undefined;
-    }
-    return undefined;
-}
-export const geminiAgent = {
-    id: 'gemini',
-    binName: 'gemini',
-    protocol: 'argv',
-    streamFormat: 'json-lines',
-    sandboxStrength: 'soft',
-    display: {
-        label: 'Gemini',
-        tagline: 'Google Gemini — soft sandbox (no built-in tool deny-list)',
-        homepage: 'https://github.com/google-gemini/gemini-cli',
-        installHint: 'npm install -g @google/gemini-cli',
-    },
-    buildArgs(opts) {
-        // Gemini has no --append-system-prompt CLI flag (only the
-        // GEMINI_SYSTEM_MD env var which writes a file). Prepend the HOVER-mode
-        // preface to the prompt instead — same pattern as cursor.ts / aider.ts.
-        const preface = opts.appendSystemPrompt && opts.appendSystemPrompt.trim().length > 0
-            ? `${HOVER_PROMPT_PREFACE} ${opts.appendSystemPrompt}`
-            : HOVER_PROMPT_PREFACE;
-        const finalPrompt = `${preface}\n\n${opts.prompt}`;
-        const args = ['-p', finalPrompt];
-        // 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 accepted 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 <id> is the documented form. -r is the alias. The single
-            // string 'latest' picks the most recent session; we only pass an
-            // explicit id, never the literal 'latest'.
-            args.push('--resume', opts.sessionId);
-        }
-        // MCP servers configured via `gemini mcp add` at install time — no
-        // per-invocation --mcp-config equivalent.
-        // No equivalent for --max-budget-usd or --allowedTools / --disallowedTools
-        // in the disable-built-ins sense.
-        return args;
-    },
-    parseEvent(line, state = {}) {
-        if (!line.trim())
-            return [];
-        let ev;
-        try {
-            ev = JSON.parse(line);
-        }
-        catch {
-            return [{ kind: 'raw', line }];
-        }
-        const s = geminiState(state);
-        const out = [];
-        if (ev.type === 'init') {
-            resetGeminiCounters(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 === 'message') {
-            // Only count and surface assistant messages — user echoes (the
-            // role:'user' message events) don't count as turns from our POV.
-            if (ev.role === 'assistant' || ev.role === undefined) {
-                s.runningTurns += 1;
-                out.push({ kind: 'usage', turns: s.runningTurns });
-                const text = extractMessageText(ev);
-                if (text) {
-                    s.lastAssistantText = text;
-                    out.push({ kind: 'text', text });
-                }
-            }
-            return out;
-        }
-        if (ev.type === 'tool_use') {
-            const rawName = ev.name ?? '';
-            const tool = stripMcpPrefix(rawName);
-            if (ev.id)
-                s.toolNameByUseId.set(ev.id, tool);
-            out.push({ kind: 'tool_use', tool, input: ev.input });
-            return out;
-        }
-        if (ev.type === 'tool_result') {
-            const isError = ev.is_error === true;
-            out.push({ kind: 'tool_result', isError });
-            return out;
-        }
-        if (ev.type === 'result') {
-            // result.stats may carry turns; prefer it over our running count.
-            const turns = ev.stats?.turns ?? ev.stats?.model?.turns ?? s.runningTurns;
-            const isError = ev.is_error === true || ev.error !== undefined && ev.error !== null;
-            if (isError)
-                s.sawErrorEvent = true;
-            out.push({
-                kind: 'session_end',
-                turns,
-                // costUsd intentionally undefined — gemini's stats block does not
-                // include $ figures.
-                isError,
-                summary: ev.response ?? s.lastAssistantText,
-            });
-            return out;
-        }
-        if (ev.type === 'error') {
-            s.sawErrorEvent = true;
-            const msg = ev.message ?? ev.error?.message ?? `[gemini] error`;
-            out.push({ kind: 'text', text: msg });
-            return out;
-        }
-        return [];
-    },
-    /**
-     * Gemini'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). Same shape as cursor.ts / qwen.ts.
-     */
-    onStreamEnd(exitCode, state = {}) {
-        const s = geminiState(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) => resetGeminiCounters(geminiState(state)),
-    getState: (state) => {
-        const s = geminiState(state);
-        return {
-            runningTurns: s.runningTurns,
-            runningSessionId: s.runningSessionId,
-            runningModel: s.runningModel,
-            lastAssistantText: s.lastAssistantText,
-            sawErrorEvent: s.sawErrorEvent,
-        };
-    },
-};

package/dist/agents/index.d.ts

@@ -1,6 +0,0 @@
-export * from './types.js';
-export * from './detect.js';
-export * from './invoke.js';
-export * from './registry.js';
-export * from './argv.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/agents/index.js

@@ -1,5 +0,0 @@
-export * from './types.js';
-export * from './detect.js';
-export * from './invoke.js';
-export * from './registry.js';
-export * from './argv.js';

package/dist/agents/invoke.d.ts

@@ -1,12 +0,0 @@
-import type { InvokeEvent, InvokeOptions } 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 declare function invokeAgent(opts: InvokeOptions): AsyncIterable<InvokeEvent>;
-//# sourceMappingURL=invoke.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/agents/invoke.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAe,MAAM,YAAY,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAuB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAAC,WAAW,CAAC,CA+ElF"}

package/dist/agents/invoke.js

@@ -1,96 +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.
-        // If the caller supplied an API key and the descriptor names a key env var,
-        // inject it so the CLI runs on the key instead of a logged-in subscription.
-        // The key lives only in this child's env — never logged, never persisted.
-        env: {
-            ...process.env,
-            CLAUDECODE: '',
-            ...(opts.apiKey && descriptor.apiKeyEnv
-                ? { [descriptor.apiKeyEnv]: opts.apiKey }
-                : {}),
-        },
-    });
-    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;AAQlD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAOlD,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,34 +0,0 @@
-import { claudeAgent } from './claude.js';
-import { codexAgent } from './codex.js';
-import { cursorAgent } from './cursor.js';
-import { aiderAgent } from './aider.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,
-    [cursorAgent.id]: cursorAgent,
-    [aiderAgent.id]: aiderAgent,
-    [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__/, '');
-}