@hover-dev/core 0.17.0 → 0.19.0

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":""}