@hover-dev/core 0.17.0 → 0.18.0

package/dist/engine.d.ts

@@ -1,11 +1,22 @@
-export { runSession } from './runSession.js';
-export type { RunSessionOptions, RunSessionResult } from './runSession.js';
+/**
+ * In-process engine surface for the `@hover-dev/mcp` server (and any other
+ * standalone consumer). The MCP server drives the debug Chrome directly via
+ * `playwright-core` and buffers grounded steps, then crystallizes them with
+ * `writeSpec` — no WebSocket service, no agent spawning. This barrel re-exports
+ * exactly those building blocks.
+ *
+ * (The old staged-engine surface — `runSession`, the WS `service`, the
+ * Playwright-MCP config in `resolveMcpConfig` / `buildGroundedMcpConfig`, and
+ * the `mcp/actuateServer` + `mcp/sourceServer` relays — has been removed. The
+ * MCP-first path doesn't spawn Playwright's MCP; it actuates through
+ * `playwright-core` and `groundedLocate` below, which is what keeps
+ * record == replay.)
+ */
 export { writeSpec } from './specs/writeSpec.js';
 export type { WriteSpecOptions, WriteSpecResult, Redaction } from './specs/writeSpec.js';
 export type { SkillStep } from './specs/specStep.js';
 export { replayGroundedSteps, replayOnPage, applyGroundedStep, groundedLocate } from './specs/replayGrounded.js';
 export type { ReplayResult, ReplayFailure, ReplayStep, GroundedTarget } from './specs/replayGrounded.js';
-export { resolveMcpConfig, mcpToolPrefix } from './playwright/resolveMcpConfig.js';
 export { launchDebugChrome, closeDebugChrome, findChromeBinary } from './playwright/launchChrome.js';
 export type { LaunchOptions, LaunchResult } from './playwright/launchChrome.js';
 export { GROUNDED_ACTUATION_DENY, GROUNDED_ACTUATION_DIRECTIVE } from './agentDirectives.js';
@@ -14,40 +25,4 @@ export type { BusinessFact } from './memory/businessMemory.js';
 export { RECON_DIRECTIVE, QA_EXPLORATION_DIRECTIVE } from './agentDirectives.js';
 export { QA_INTENSITY, DEFAULT_QA_INTENSITY, asQaIntensity, qaBudgetDirective } from './qa/intensity.js';
 export type { QaIntensity, QaIntensitySpec } from './qa/intensity.js';
-/**
- * The always-on control-actuation MCP server id. Alphanumeric on purpose — a
- * hyphen would make the hard-sandbox allow prefix (`mcp__hovercontrol`) fail to
- * match the tool names (`mcp__hovercontrol__click_control`), so every grounded
- * actuation would be denied. (Same constant + reasoning as service.ts.)
- */
-export declare const CONTROL_MCP_ID = "hovercontrol";
-/** The hard-sandbox allow prefix for the control server — pass in
- *  `runSession({ allowedToolsExtra: [CONTROL_MCP_TOOL_PREFIX] })`. */
-export declare const CONTROL_MCP_TOOL_PREFIX: string;
-export interface GroundedMcpOptions {
-    /** CDP endpoint of the debug Chrome the agent drives. */
-    cdpUrl: string;
-    /** Port used only to namespace the generated config filename. */
-    port: number;
-    /** Project root — where the control server resolves relative paths / writes
-     *  its placeholder upload fixture, and where `@playwright/mcp` resolves from. */
-    devRoot: string;
-    /** The dev-server origin the run targets (defaults to `cdpUrl`). */
-    devUrl?: string;
-    /** WS port the control server's back-channel (`ask_user` / `record_*`)
-     *  connects to. Omit when there's no listener — actuation still works; the
-     *  back-channel features silently no-op (actuateServer fails soft). */
-    approvalPort?: number;
-    /** Directory the Playwright MCP + control screenshots write into. */
-    outputDir?: string;
-}
-/**
- * Build an MCP config mirroring the service's grounded/normal mode: the
- * Playwright MCP over CDP PLUS the hover-control actuation server. Pair it in
- * `runSession` with `allowedToolsExtra: [CONTROL_MCP_TOOL_PREFIX]`,
- * `disallowedToolsExtra: GROUNDED_ACTUATION_DENY`, and append
- * `GROUNDED_ACTUATION_DIRECTIVE` to the system prompt — then the selectors the
- * agent actuates with are the ones crystallized (record==replay).
- */
-export declare function buildGroundedMcpConfig(opts: GroundedMcpOptions): string;
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACjH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGzG,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrG,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGhF,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAG7F,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACrG,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM/D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzG,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C;sEACsE;AACtE,eAAO,MAAM,uBAAuB,QAAgC,CAAC;AAMrE,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb;qFACiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;2EAEuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAqBvE"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACjH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGzG,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrG,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGhF,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAG7F,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACrG,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzG,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/engine.js

@@ -1,78 +1,27 @@
 /**
- * In-process engine surface for non-service consumers — the `hover` CLI and the
- * `@hover-dev/mcp` server. The VS Code extension drives core through the WS
- * service (`./service`); a standalone process instead calls `runSession`
- * directly. This barrel exposes the same building blocks the service composes —
- * the session run, the GROUNDED MCP config (so a CLI-authored spec gets the
- * record==replay fidelity the extension does), and spec crystallization —
- * without the WebSocket layer.
+ * In-process engine surface for the `@hover-dev/mcp` server (and any other
+ * standalone consumer). The MCP server drives the debug Chrome directly via
+ * `playwright-core` and buffers grounded steps, then crystallizes them with
+ * `writeSpec` — no WebSocket service, no agent spawning. This barrel re-exports
+ * exactly those building blocks.
  *
- * Keep this a thin re-export + the one `buildGroundedMcpConfig` helper. The
- * grounded path here MUST stay in lock-step with `service.ts`'s normal-mode
- * assembly (the control-actuation server + `GROUNDED_ACTUATION_DENY` /
- * `GROUNDED_ACTUATION_DIRECTIVE`), or CLI specs would drift from extension specs.
+ * (The old staged-engine surface — `runSession`, the WS `service`, the
+ * Playwright-MCP config in `resolveMcpConfig` / `buildGroundedMcpConfig`, and
+ * the `mcp/actuateServer` + `mcp/sourceServer` relays — has been removed. The
+ * MCP-first path doesn't spawn Playwright's MCP; it actuates through
+ * `playwright-core` and `groundedLocate` below, which is what keeps
+ * record == replay.)
  */
-import { resolve, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { resolveMcpConfig, mcpToolPrefix } from './playwright/resolveMcpConfig.js';
-// ── in-process session + crystallization ─────────────────────────────────────
-export { runSession } from './runSession.js';
+// ── crystallization + grounded replay ────────────────────────────────────────
 export { writeSpec } from './specs/writeSpec.js';
 // Creation-verification: replay a flow's grounded steps over CDP (no playwright test).
 export { replayGroundedSteps, replayOnPage, applyGroundedStep, groundedLocate } from './specs/replayGrounded.js';
-// ── browser / MCP plumbing ───────────────────────────────────────────────────
-export { resolveMcpConfig, mcpToolPrefix } from './playwright/resolveMcpConfig.js';
+// ── debug-Chrome lifecycle ───────────────────────────────────────────────────
 export { launchDebugChrome, closeDebugChrome, findChromeBinary } from './playwright/launchChrome.js';
-// ── grounded-actuation knobs (must match service.ts) ─────────────────────────
+// ── grounded-actuation knobs (the deny-list + directive the agent runs under) ─
 export { GROUNDED_ACTUATION_DENY, GROUNDED_ACTUATION_DIRECTIVE } from './agentDirectives.js';
-// ── business memory (ask → remember loop; shared with the extension's QA mode) ─
+// ── business memory (ask → remember loop) ────────────────────────────────────
 export { loadMemory, formatMemoryForPrompt, writeFact, memoryDir } from './memory/businessMemory.js';
-// ── autonomous-exploration directives (QA mode reuse) ────────────────────────
-// The CLI's "explore → discover business flows → record_candidate" loop is the
-// same mechanism QA mode drives the agent with; reuse the directives verbatim
-// so behaviour stays in lock-step.
+// ── autonomous-exploration directives + intensity (the test_app workflow) ─────
 export { RECON_DIRECTIVE, QA_EXPLORATION_DIRECTIVE } from './agentDirectives.js';
 export { QA_INTENSITY, DEFAULT_QA_INTENSITY, asQaIntensity, qaBudgetDirective } from './qa/intensity.js';
-/**
- * The always-on control-actuation MCP server id. Alphanumeric on purpose — a
- * hyphen would make the hard-sandbox allow prefix (`mcp__hovercontrol`) fail to
- * match the tool names (`mcp__hovercontrol__click_control`), so every grounded
- * actuation would be denied. (Same constant + reasoning as service.ts.)
- */
-export const CONTROL_MCP_ID = 'hovercontrol';
-/** The hard-sandbox allow prefix for the control server — pass in
- *  `runSession({ allowedToolsExtra: [CONTROL_MCP_TOOL_PREFIX] })`. */
-export const CONTROL_MCP_TOOL_PREFIX = mcpToolPrefix(CONTROL_MCP_ID);
-// dist/engine.js sits beside dist/service.js, so mcp/actuateServer.js resolves
-// the same way it does from service.ts.
-const CONTROL_MCP_SCRIPT = resolve(dirname(fileURLToPath(import.meta.url)), 'mcp', 'actuateServer.js');
-/**
- * Build an MCP config mirroring the service's grounded/normal mode: the
- * Playwright MCP over CDP PLUS the hover-control actuation server. Pair it in
- * `runSession` with `allowedToolsExtra: [CONTROL_MCP_TOOL_PREFIX]`,
- * `disallowedToolsExtra: GROUNDED_ACTUATION_DENY`, and append
- * `GROUNDED_ACTUATION_DIRECTIVE` to the system prompt — then the selectors the
- * agent actuates with are the ones crystallized (record==replay).
- */
-export function buildGroundedMcpConfig(opts) {
-    return resolveMcpConfig({
-        cdpUrl: opts.cdpUrl,
-        port: opts.port,
-        cwd: opts.devRoot,
-        outputDir: opts.outputDir,
-        extra: [
-            {
-                id: CONTROL_MCP_ID,
-                command: process.execPath,
-                args: [CONTROL_MCP_SCRIPT],
-                env: {
-                    HOVER_CDP_URL: opts.cdpUrl,
-                    HOVER_DEV_URL: opts.devUrl ?? opts.cdpUrl,
-                    HOVER_PROJECT_ROOT: opts.devRoot,
-                    ...(opts.approvalPort ? { HOVER_APPROVAL_PORT: String(opts.approvalPort) } : {}),
-                    ...(opts.outputDir ? { HOVER_SHOT_DIR: opts.outputDir } : {}),
-                },
-            },
-        ],
-    });
-}

package/dist/specs/pageObjectManifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pageObjectManifest.d.ts","sourceRoot":"","sources":["../../src/specs/pageObjectManifest.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAMD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,eAAe,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;wDAEwD;AACxD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAUhG"}
+{"version":3,"file":"pageObjectManifest.d.ts","sourceRoot":"","sources":["../../src/specs/pageObjectManifest.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAMD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,eAAe,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;wDAEwD;AACxD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAUhG"}

package/dist/specs/pageObjectManifest.js

@@ -1,15 +1,16 @@
 /**
- * Page Object manifest — the link between extraction (Stage 3b) and
- * consumption (Stage 3c).
+ * Page Object manifest — `.hover/page-objects.json` describing each emitted
+ * Page Object (class/method/fixture names + the signature prefix it replays).
+ * writeSpec reads it (`readPageObjectManifest`) to decide whether a freshly-saved
+ * spec's prefix matches an existing Page Object — if so it consumes
+ * `await loginPage.login(…)` and imports from `./fixtures` instead of re-emitting
+ * the steps inline.
  *
- * extractPageObjects writes `.hover/page-objects.json` describing each emitted
- * Page Object: its class/method/fixture names and the signature prefix it
- * replays. writeSpec reads it to decide whether a freshly-saved spec's prefix
- * matches a Page Object — if so it consumes `await loginPage.login(…)` and
- * imports from `./fixtures` instead of re-emitting the steps inline.
- *
- * Kept separate from extractPageObjects so writeSpec can read the manifest
- * without importing the detection/generation chain.
+ * NOTE: cross-spec reuse is currently DORMANT — the manifest writer
+ * (`writePageObjectManifest`) has no caller since the standalone extraction stage
+ * was removed, so the read path returns null and writeSpec emits Page Objects
+ * inline. Kept as the seam for when cross-spec Page Object reuse is wired into
+ * the MCP-first flow.
  */
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';

package/dist/specs/replayGrounded.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replayGrounded.d.ts","sourceRoot":"","sources":["../../src/specs/replayGrounded.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAkBlF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAGD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AA+BD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI,CAS5E;AAED;yEACyE;AACzE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CA4B/F;AAED;;qEAEqE;AACrE,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAqBzG;AAuBD,+EAA+E;AAC/E,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAoB9H"}
+{"version":3,"file":"replayGrounded.d.ts","sourceRoot":"","sources":["../../src/specs/replayGrounded.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAiBlF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAGD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AA+BD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI,CAS5E;AAED;yEACyE;AACzE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CA4B/F;AAED;;qEAEqE;AACrE,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAqBzG;AAuBD,+EAA+E;AAC/E,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAoB9H"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hover-dev/core",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Hover's local Node service: agent invocation, Playwright CDP preflight, WebSocket bridge.",
   "license": "Apache-2.0",
   "author": "Hyperyond",
@@ -20,32 +20,16 @@
     "claude"
   ],
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/engine.js",
+  "types": "dist/engine.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./agents": {
-      "types": "./dist/agents/index.d.ts",
-      "import": "./dist/agents/index.js"
-    },
-    "./service": {
-      "types": "./dist/service.d.ts",
-      "import": "./dist/service.js"
+      "types": "./dist/engine.d.ts",
+      "import": "./dist/engine.js"
     },
     "./engine": {
       "types": "./dist/engine.d.ts",
       "import": "./dist/engine.js"
-    },
-    "./launch-chrome": {
-      "types": "./dist/playwright/launchChrome.d.ts",
-      "import": "./dist/playwright/launchChrome.js"
-    },
-    "./plugin-api": {
-      "types": "./dist/plugin-api.d.ts",
-      "import": "./dist/plugin-api.js"
     }
   },
   "files": [
@@ -55,7 +39,6 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@playwright/mcp": "0.0.75",
     "cross-spawn": "^7.0.6",
     "playwright-core": "^1.50.0",
     "ts-morph": "^28.0.0",

package/dist/agents/argv.d.ts

@@ -1,11 +0,0 @@
-import type { AgentDescriptor, InvokeOptions } from './types.js';
-/**
- * Build argv for spawning an agent.
- *
- * Per-agent argument logic lives on the descriptor (e.g. claude.ts owns its
- * own `--mcp-config`, `--permission-mode` etc.). This dispatcher only
- * gates by protocol — `acp` and `pi-rpc` are not yet implemented because
- * they require a long-lived bidirectional channel rather than argv.
- */
-export declare function buildArgv(descriptor: AgentDescriptor, opts: InvokeOptions): string[];
-//# sourceMappingURL=argv.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"argv.d.ts","sourceRoot":"","sources":["../../src/agents/argv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGjE;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAepF"}

package/dist/agents/argv.js

@@ -1,23 +0,0 @@
-import { UnsupportedAgentProtocolError } from './types.js';
-/**
- * Build argv for spawning an agent.
- *
- * Per-agent argument logic lives on the descriptor (e.g. claude.ts owns its
- * own `--mcp-config`, `--permission-mode` etc.). This dispatcher only
- * gates by protocol — `acp` and `pi-rpc` are not yet implemented because
- * they require a long-lived bidirectional channel rather than argv.
- */
-export function buildArgv(descriptor, opts) {
-    switch (descriptor.protocol) {
-        case 'argv':
-        case 'stdin':
-            return descriptor.buildArgs(opts);
-        case 'acp':
-        case 'pi-rpc':
-            throw new UnsupportedAgentProtocolError(`Agent protocol "${descriptor.protocol}" is not yet implemented (agent: ${descriptor.id})`);
-        default: {
-            const exhaustive = descriptor.protocol;
-            throw new UnsupportedAgentProtocolError(`Unknown protocol: ${String(exhaustive)}`);
-        }
-    }
-}

package/dist/agents/claude.d.ts

@@ -1,3 +0,0 @@
-import type { AgentDescriptor } from './types.js';
-export declare const claudeAgent: AgentDescriptor;
-//# sourceMappingURL=claude.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA2C,MAAM,YAAY,CAAC;AAiI3F,eAAO,MAAM,WAAW,EAAE,eA8IzB,CAAC"}

package/dist/agents/claude.js

@@ -1,220 +0,0 @@
-/**
- * Running-cost accumulator across one parser lifecycle. Claude Code's
- * stream-json sometimes carries `total_cost_usd` on intermediate events; when
- * it does we just forward it. When it doesn't, we estimate from token usage
- * using public per-million pricing. Hardcoded rates because they change
- * rarely and we'd rather not network-fetch a price table from a sandbox.
- *
- * The estimate is empirically about 1.5–2× the authoritative
- * `total_cost_usd` that arrives on the final `result` event (overhead from
- * tool-definition tokens we don't see + Claude's actual cache hit ratios
- * vs. our pessimistic accounting). That's fine for the widget's purpose:
- * give the user a signal of cost direction and order-of-magnitude so they
- * know when to hit Stop. The done card displays the final authoritative
- * number from `total_cost_usd`, so the user always sees the ground truth.
- */
-const PRICE_PER_M_USD = {
-    // claude-sonnet-4 / 4.5 / 4.6 / 4.7 — all priced the same as of 2026
-    sonnet: { in: 3, out: 15, cacheCreate: 3.75, cacheRead: 0.3 },
-    opus: { in: 15, out: 75, cacheCreate: 18.75, cacheRead: 1.5 },
-    haiku: { in: 1, out: 5, cacheCreate: 1.25, cacheRead: 0.1 },
-};
-function estimateCostUsd(modelHint, usage) {
-    // Match the most specific tier by substring. e.g. 'claude-sonnet-4-6' → sonnet.
-    const m = (modelHint ?? 'sonnet').toLowerCase();
-    const tier = m.includes('opus') ? PRICE_PER_M_USD.opus :
-        m.includes('haiku') ? PRICE_PER_M_USD.haiku :
-            PRICE_PER_M_USD.sonnet;
-    return ((usage.input_tokens ?? 0) * tier.in +
-        (usage.output_tokens ?? 0) * tier.out +
-        (usage.cache_creation_input_tokens ?? 0) * tier.cacheCreate +
-        (usage.cache_read_input_tokens ?? 0) * tier.cacheRead) / 1_000_000;
-}
-function claudeState(state) {
-    // First touch on this state object — seed the keys we read below.
-    if (typeof state.runningCost !== 'number') {
-        state.runningCost = 0;
-        state.runningTurns = 0;
-        state.runningTokens = 0;
-        state.runningModel = undefined;
-    }
-    return state;
-}
-/** Every built-in claude-code tool that has nothing to do with driving a
- *  browser. Combined with `--strict-mcp-config` + an allow-list of mcp__*
- *  ids, this leaves Claude with only the Playwright MCP (plus any
- *  plugin-contributed MCPs) as a usable tool surface. */
-const CLAUDE_DEFAULT_DISALLOWED_TOOLS = [
-    // file / shell / data access — never appropriate for browser driving
-    'Bash', 'BashOutput', 'KillBash',
-    'Edit', 'MultiEdit', 'Write', 'Read', 'NotebookEdit',
-    // `Task` was renamed `Agent` in newer Claude Code — it spawns a subagent with
-    // the full tool surface (Bash/Write/…), a real sandbox escape, so deny BOTH
-    // the current and legacy name. (Only this one targeted name was added; do NOT
-    // add MCP-machinery tools like WaitForMcpServers here — denying those breaks
-    // the MCP tool path and the agent loses its real browser tools.)
-    'Grep', 'Glob', 'Task', 'Agent', 'TodoWrite',
-    'WebFetch', 'WebSearch',
-    // plan / worktree / cron / notification — irrelevant in -p mode
-    'EnterPlanMode', 'ExitPlanMode',
-    'EnterWorktree', 'ExitWorktree',
-    'CronCreate', 'CronDelete', 'CronList',
-    'PushNotification', 'RemoteTrigger',
-    // task & tool introspection added in claude 2.1.x — let through and
-    // the agent will burn turns exploring instead of executing
-    'ToolSearch',
-    'Monitor', 'TaskOutput', 'TaskStop',
-    'AskUserQuestion',
-    'ShareOnboardingGuide',
-    // Skills are loaded independently of the --allowedTools allow-list, so an
-    // allow-list of `mcp__playwright` does NOT block the `Skill` tool. Left
-    // through, the agent burns a turn "checking for a project skill first" and
-    // pollutes the crystallized spec with a junk `When · Skill` step. Deny it.
-    'Skill',
-    // Playwright MCP's arbitrary-JS tools. browser_run_code_unsafe /
-    // browser_evaluate run any JS in the page — a real prompt-injection exfil
-    // path (fetch a token out, read localStorage) that punches through the
-    // "Playwright MCP only" sandbox, and their output can't be translated into
-    // a deterministic Playwright spec anyway (it lands as a `// TODO`). Agents
-    // drive via click/fill/select and read state via snapshot instead.
-    'mcp__playwright__browser_run_code_unsafe',
-    'mcp__playwright__browser_evaluate',
-];
-export const claudeAgent = {
-    id: 'claude',
-    binName: 'claude',
-    protocol: 'argv',
-    streamFormat: 'stream-json',
-    sandboxStrength: 'hard',
-    defaultDisallowedTools: CLAUDE_DEFAULT_DISALLOWED_TOOLS,
-    // F7 optimize is text-in/text-out refinement — haiku is plenty and ~cheap.
-    cheapModel: 'haiku',
-    display: {
-        label: 'Claude Code',
-        tagline: 'Anthropic — best-in-class browser driving, hard tool sandbox',
-        homepage: 'https://docs.claude.com/claude-code',
-        installHint: 'npm install -g @anthropic-ai/claude-code',
-    },
-    buildArgs(opts) {
-        const args = ['-p', opts.prompt];
-        args.push('--output-format', 'stream-json', '--verbose');
-        args.push('--permission-mode', 'dontAsk');
-        if (opts.mcpConfig) {
-            args.push('--mcp-config', opts.mcpConfig, '--strict-mcp-config');
-        }
-        if (opts.allowedTools?.length) {
-            args.push('--allowedTools', ...opts.allowedTools);
-        }
-        if (opts.disallowedTools?.length) {
-            args.push('--disallowedTools', ...opts.disallowedTools);
-        }
-        if (opts.maxBudgetUsd != null) {
-            args.push('--max-budget-usd', String(opts.maxBudgetUsd));
-        }
-        if (opts.maxTurns != null) {
-            args.push('--max-turns', String(opts.maxTurns));
-        }
-        if (opts.model) {
-            args.push('--model', opts.model);
-        }
-        if (opts.effort) {
-            args.push('--effort', opts.effort);
-        }
-        if (opts.sessionId) {
-            args.push('--resume', opts.sessionId);
-        }
-        if (opts.appendSystemPrompt && opts.appendSystemPrompt.trim().length > 0) {
-            args.push('--append-system-prompt', opts.appendSystemPrompt);
-        }
-        return args;
-    },
-    parseEvent(line, state = {}) {
-        if (!line.trim())
-            return [];
-        let ev;
-        try {
-            ev = JSON.parse(line);
-        }
-        catch {
-            return [{ kind: 'raw', line }];
-        }
-        const s = claudeState(state);
-        const out = [];
-        if (ev.type === 'system' && ev.subtype === 'init') {
-            // Fresh session — reset the cost/turn accumulator.
-            s.runningCost = 0;
-            s.runningTurns = 0;
-            s.runningTokens = 0;
-            s.runningModel = ev.model;
-            if (ev.session_id) {
-                out.push({ kind: 'session_start', sessionId: ev.session_id, model: ev.model });
-            }
-            for (const server of ev.mcp_servers ?? []) {
-                out.push({ kind: 'mcp_status', server: server.name, status: server.status });
-            }
-            return out;
-        }
-        if (ev.type === 'assistant') {
-            s.runningTurns += 1;
-            // Claude Code sometimes carries `total_cost_usd` on intermediate events;
-            // when present it's authoritative (server-computed, includes anything
-            // we'd miss). When absent, estimate from this turn's usage so the widget
-            // still shows a growing $ counter on long runs.
-            if (typeof ev.total_cost_usd === 'number') {
-                s.runningCost = ev.total_cost_usd;
-            }
-            else if (ev.message?.usage) {
-                s.runningCost += estimateCostUsd(s.runningModel ?? ev.message.model, ev.message.usage);
-            }
-            // Token consumption = fresh input + output only. We deliberately EXCLUDE
-            // cache_read (and cache_creation): Claude re-reads ~the whole context from
-            // cache every turn, so summing cache_read across turns inflates the total
-            // ~5-10× and diverges from what Claude Code reports. input+output tracks
-            // the new tokens processed, matching the user's mental model + CC's number.
-            if (ev.message?.usage) {
-                const u = ev.message.usage;
-                s.runningTokens += (u.input_tokens ?? 0) + (u.output_tokens ?? 0);
-            }
-            out.push({ kind: 'usage', costUsd: s.runningCost, turns: s.runningTurns, tokens: s.runningTokens });
-            for (const block of ev.message?.content ?? []) {
-                if (block.type === 'tool_use') {
-                    const name = block.name ?? '';
-                    const tool = name.replace(/^mcp__playwright__/, '');
-                    out.push({
-                        kind: 'tool_use',
-                        tool,
-                        input: block.input,
-                        costUsdSnapshot: s.runningCost,
-                        tokensSnapshot: s.runningTokens,
-                    });
-                }
-                else if (block.type === 'text') {
-                    const text = block.text?.trim();
-                    if (text)
-                        out.push({ kind: 'text', text });
-                }
-            }
-            return out;
-        }
-        if (ev.type === 'user') {
-            for (const block of ev.message?.content ?? []) {
-                if (block.type === 'tool_result') {
-                    out.push({ kind: 'tool_result', isError: block.is_error });
-                }
-            }
-            return out;
-        }
-        if (ev.type === 'result') {
-            out.push({
-                kind: 'session_end',
-                turns: ev.num_turns,
-                costUsd: ev.total_cost_usd,
-                tokens: s.runningTokens,
-                isError: ev.is_error,
-                summary: ev.result,
-            });
-            return out;
-        }
-        return [];
-    },
-};

package/dist/agents/codex.d.ts

@@ -1,19 +0,0 @@
-import type { AgentDescriptor, ParserState } from './types.js';
-export declare const codexAgent: AgentDescriptor;
-/**
- * Test-only escape hatches. Tests pass a state object in and get the
- * accumulated counters back — same shape as the parser sees during a real
- * invocation, just driven by the test instead of by invokeAgent.
- */
-export declare const __testing: {
-    freshState: () => ParserState;
-    resetCounters: (state: ParserState) => void;
-    getState: (state: ParserState) => {
-        runningCost: number;
-        runningTurns: number;
-        runningSessionId: string | undefined;
-        lastAgentMessage: string | undefined;
-        sawErrorEvent: boolean;
-    };
-};
-//# sourceMappingURL=codex.d.ts.map

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

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