@hover-dev/core 0.17.0 → 0.19.0

package/dist/engine.d.ts

@@ -1,11 +1,24 @@
-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 { writeApiSpec } from './specs/writeApiSpec.js';
+export type { ApiCheck, WriteApiSpecOptions, WriteApiSpecResult } from './specs/writeApiSpec.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 +27,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,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,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,29 @@
 /**
- * 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';
+// API-layer crystallizer — observed/replayed requests → *.api-test.spec.ts.
+export { writeApiSpec } from './specs/writeApiSpec.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/dist/specs/writeApiSpec.d.ts

@@ -0,0 +1,36 @@
+/** One asserted API call — a contract, shape, or authz check. */
+export interface ApiCheck {
+    /** Short imperative title → the `test()` name (e.g. "GET /api/cart returns the cart"). */
+    title: string;
+    /** HTTP method. */
+    method: string;
+    /** URL as captured. Same-origin URLs are relativized to a path so the spec
+     *  rides the config's baseURL; cross-origin URLs are emitted in full. */
+    url: string;
+    /** Request body to send (objects are emitted as a JSON literal via `data`). */
+    requestBody?: unknown;
+    /** Headers to send. For an authz check the agent omits/alters the auth header. */
+    headers?: Record<string, string>;
+    /** Expected status — observed for a contract check, or expected-after-mutation
+     *  for an authz check (verified with replay_request before crystallizing). */
+    expectStatus?: number;
+    /** Top-level response keys to assert present (a light shape contract). */
+    expectBodyKeys?: string[];
+    /** Optional human note → emitted as a leading comment (e.g. "authz: no session → 401"). */
+    note?: string;
+}
+export interface WriteApiSpecOptions {
+    devRoot: string;
+    name: string;
+    description?: string;
+    checks: ApiCheck[];
+    /** Run target origin — same-origin URLs are relativized against it. */
+    startUrl?: string;
+    overwrite?: boolean;
+}
+export interface WriteApiSpecResult {
+    path: string;
+    slug: string;
+}
+export declare function writeApiSpec(opts: WriteApiSpecOptions): Promise<WriteApiSpecResult>;
+//# sourceMappingURL=writeApiSpec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeApiSpec.d.ts","sourceRoot":"","sources":["../../src/specs/writeApiSpec.ts"],"names":[],"mappings":"AAgBA,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf;6EACyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;kFAC8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA0DD,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyBzF"}

package/dist/specs/writeApiSpec.js

@@ -0,0 +1,94 @@
+/**
+ * Deterministic API-spec crystallizer — the API-layer sibling of writeSpec.
+ *
+ * Writes a `<devRoot>/__vibe_tests__/<slug>.api-test.spec.ts` from a list of
+ * `ApiCheck`s the agent assembled (observed via CDP capture, optionally with a
+ * mutation it verified with replay_request). Pure `@playwright/test`
+ * `APIRequestContext` — `request.get/post(...)` + status / shape / authz
+ * assertions. No LLM in the codegen path: a 1:1 string-template translation, so
+ * record == replay holds for the API layer too (the call that was captured is
+ * the call that's asserted).
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { slugify, firstSentence } from './text.js';
+const KNOWN_METHODS = new Set(['get', 'post', 'put', 'delete', 'patch', 'head']);
+function q(s) {
+    return `'${String(s).replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
+/** Same-origin → path (rides baseURL); cross-origin → full URL. */
+function toRequestUrl(url, startUrl) {
+    try {
+        const u = new URL(url);
+        if (startUrl) {
+            const base = new URL(startUrl);
+            if (u.origin === base.origin)
+                return (u.pathname + u.search) || '/';
+        }
+        return url;
+    }
+    catch {
+        return url; // already a path, or unparseable — emit as-is
+    }
+}
+function renderCheck(check, startUrl) {
+    const m = check.method.toLowerCase();
+    const useFetch = !KNOWN_METHODS.has(m);
+    const fn = useFetch ? 'fetch' : m;
+    const url = toRequestUrl(check.url, startUrl);
+    // Build the options object (data / headers / method-for-fetch).
+    const opts = [];
+    if (useFetch)
+        opts.push(`method: ${q(check.method.toUpperCase())}`);
+    if (check.requestBody !== undefined && m !== 'get' && m !== 'head') {
+        opts.push(`data: ${JSON.stringify(check.requestBody)}`);
+    }
+    if (check.headers && Object.keys(check.headers).length) {
+        opts.push(`headers: ${JSON.stringify(check.headers)}`);
+    }
+    const callArgs = opts.length ? `${q(url)}, { ${opts.join(', ')} }` : q(url);
+    const body = [];
+    if (check.note)
+        body.push(`    // ${check.note}`);
+    body.push(`    const res = await request.${fn}(${callArgs});`);
+    if (typeof check.expectStatus === 'number') {
+        body.push(`    expect(res.status()).toBe(${check.expectStatus});`);
+    }
+    else {
+        body.push(`    expect(res.ok()).toBeTruthy();`);
+    }
+    if (check.expectBodyKeys && check.expectBodyKeys.length) {
+        body.push(`    const body = await res.json();`);
+        for (const k of check.expectBodyKeys) {
+            body.push(`    expect(body).toHaveProperty(${q(k)});`);
+        }
+    }
+    const title = check.title.replace(/'/g, "\\'");
+    return [`  test('${title}', async ({ request }) => {`, ...body, `  });`].join('\n');
+}
+export async function writeApiSpec(opts) {
+    const slug = slugify(opts.name);
+    if (!slug)
+        throw new Error('api spec name must contain at least one alphanumeric character');
+    if (!opts.checks.length)
+        throw new Error('api spec needs at least one check');
+    const dir = join(opts.devRoot, '__vibe_tests__');
+    const path = join(dir, `${slug}.api-test.spec.ts`);
+    if (existsSync(path) && !opts.overwrite) {
+        throw new Error(`${path} already exists (pass overwrite to replace)`);
+    }
+    const header = opts.description ? `// ${firstSentence(opts.description)}` : null;
+    const lines = [
+        ...(header ? [header] : []),
+        `import { test, expect } from '@playwright/test';`,
+        ``,
+        `test.describe(${q(opts.name)}, () => {`,
+        opts.checks.map(c => renderCheck(c, opts.startUrl)).join('\n\n'),
+        `});`,
+        ``,
+    ];
+    await mkdir(dir, { recursive: true });
+    await writeFile(path, lines.join('\n'), 'utf-8');
+    return { path, slug };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hover-dev/core",
-  "version": "0.17.0",
+  "version": "0.19.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"}