@fusengine/browser-mcp 0.1.0

package/dist/actions/wait-for.js

@@ -0,0 +1,28 @@
+/** Wait until the condition holds; returns ok=false on timeout. */
+export async function waitForCondition(page, cond) {
+    const timeout = cond.timeoutMs ?? 15_000;
+    try {
+        if (cond.text !== undefined) {
+            await page.getByText(cond.text).first().waitFor({ state: "visible", timeout });
+            return { type: "wait_for", ok: true, condition: "text", value: cond.text };
+        }
+        if (cond.selector !== undefined) {
+            await page.locator(cond.selector).first().waitFor({ state: "visible", timeout });
+            return { type: "wait_for", ok: true, condition: "selector", value: cond.selector };
+        }
+        if (cond.gone !== undefined) {
+            await page.locator(cond.gone).first().waitFor({ state: "hidden", timeout });
+            return { type: "wait_for", ok: true, condition: "gone", value: cond.gone };
+        }
+        if (cond.urlContains !== undefined) {
+            const needle = cond.urlContains;
+            await page.waitForURL((url) => url.href.includes(needle), { timeout });
+            return { type: "wait_for", ok: true, condition: "urlContains", value: needle };
+        }
+        return { type: "wait_for", ok: false, error: "no_condition_provided" };
+    }
+    catch (err) {
+        return { type: "wait_for", ok: false, error: String(err).split("\n")[0] ?? "timeout" };
+    }
+}
+//# sourceMappingURL=wait-for.js.map

package/dist/actions/wait-for.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for.js","sourceRoot":"","sources":["../../src/actions/wait-for.ts"],"names":[],"mappings":"AAoBA,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAU,EAAE,IAAmB;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IACzC,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7E,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YACjF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7E,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;YAChC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACvE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACjF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;IACzF,CAAC;AACH,CAAC"}

package/dist/agent/actions-loop.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Execute the action plan, recording replay steps and site memory.
+ * @module agent/actions-loop
+ */
+import type { Page } from "playwright";
+import { type ActionInput } from "../actions/perform.js";
+import type { ReplayStep } from "../interfaces/report.js";
+import type { ActionResult } from "../interfaces/types.js";
+import type { ResolvedConfig } from "./config.js";
+/** Outcome of running the action plan. */
+export interface ActionsOutcome {
+    results: ActionResult[];
+    replaySteps: ReplayStep[];
+    siteMemoryUpdated: boolean;
+}
+/** Run each action sequentially, applying remembered strategies and capturing replay. */
+export declare function runActions(page: Page, config: ResolvedConfig, actions: ActionInput[], targetUrl: string, runId: string): Promise<ActionsOutcome>;
+//# sourceMappingURL=actions-loop.d.ts.map

package/dist/agent/actions-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-loop.d.ts","sourceRoot":"","sources":["../../src/agent/actions-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,KAAK,WAAW,EAAsC,MAAM,uBAAuB,CAAC;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,yFAAyF;AACzF,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAmCzB"}

package/dist/agent/actions-loop.js

@@ -0,0 +1,44 @@
+import { performAction, safeActionForReport } from "../actions/perform.js";
+import { domSignature } from "../state/dom-signature.js";
+import { waitForRealtimeSettle } from "../state/realtime.js";
+import { captureReplayScreenshot } from "../state/replay.js";
+import { loadSiteMemory, rememberActionStrategy, rememberedAction } from "../state/site-memory.js";
+/** Run each action sequentially, applying remembered strategies and capturing replay. */
+export async function runActions(page, config, actions, targetUrl, runId) {
+    const results = [];
+    const replaySteps = [];
+    let siteMemoryUpdated = false;
+    const memory = loadSiteMemory(config.siteMemoryDir, targetUrl);
+    for (let index = 0; index < actions.length; index += 1) {
+        const source = actions[index];
+        if (!source)
+            continue;
+        const action = { ...source };
+        const remembered = rememberedAction(memory, action);
+        if (remembered)
+            action.preferredStrategy = remembered.strategy;
+        const beforeDom = await domSignature(page);
+        const beforeShot = await captureReplayScreenshot(page, config.replayDir, config.replayEnabled, runId, index, "before");
+        const result = await performAction(page, action, config.humanMode);
+        results.push(result);
+        await waitForRealtimeSettle(page);
+        const afterDom = await domSignature(page);
+        const afterShot = await captureReplayScreenshot(page, config.replayDir, config.replayEnabled, runId, index, "after");
+        replaySteps.push({
+            index,
+            action: safeActionForReport(action),
+            result,
+            beforeDomSignature: beforeDom,
+            afterDomSignature: afterDom,
+            domChanged: beforeDom !== afterDom,
+            beforeScreenshotPath: beforeShot,
+            afterScreenshotPath: afterShot,
+        });
+        if (result.ok) {
+            siteMemoryUpdated =
+                rememberActionStrategy(config.siteMemoryDir, targetUrl, action, result) || siteMemoryUpdated;
+        }
+    }
+    return { results, replaySteps, siteMemoryUpdated };
+}
+//# sourceMappingURL=actions-loop.js.map

package/dist/agent/actions-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-loop.js","sourceRoot":"","sources":["../../src/agent/actions-loop.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAUnG,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAU,EACV,MAAsB,EACtB,OAAsB,EACtB,SAAiB,EACjB,KAAa;IAEb,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAE/D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,MAAM,GAAgB,EAAE,GAAG,MAAM,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,UAAU;YAAE,MAAM,CAAC,iBAAiB,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC/D,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACrH,WAAW,CAAC,IAAI,CAAC;YACf,KAAK;YACL,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACnC,MAAM;YACN,kBAAkB,EAAE,SAAS;YAC7B,iBAAiB,EAAE,QAAQ;YAC3B,UAAU,EAAE,SAAS,KAAK,QAAQ;YAClC,oBAAoB,EAAE,UAAU;YAChC,mBAAmB,EAAE,SAAS;SAC/B,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,iBAAiB;gBACf,sBAAsB,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,iBAAiB,CAAC;QACjG,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AACrD,CAAC"}

package/dist/agent/browser-agent.d.ts

@@ -0,0 +1,24 @@
+/**
+ * High-level agentic browser facade: guardrails + probe orchestration.
+ * @module agent/browser-agent
+ */
+import { type PreflightResult } from "../guardrails/preflight.js";
+import type { ProbeReport } from "../interfaces/report.js";
+import type { AgentOptions, BrowserAction, ProbeOptions } from "../interfaces/types.js";
+import { type ResolvedConfig } from "./config.js";
+/** Lightweight browser agent on top of Patchright/Playwright. */
+export declare class BrowserAgent {
+    /** Effective resolved configuration. */
+    readonly config: ResolvedConfig;
+    constructor(opts?: AgentOptions);
+    /** Check whether the given actions are allowed without human approval. */
+    preflight(actions: BrowserAction[], humanApproved?: boolean): PreflightResult;
+    /**
+     * Probe a real URL: enforce guardrails then run the browser pipeline.
+     * @throws {GuardrailViolation} when a sensitive action lacks approval.
+     */
+    probe(url: string, options?: ProbeOptions): Promise<ProbeReport>;
+    /** Probe an inline HTML fixture via a base64 data URL. */
+    probeHtml(html: string, options?: ProbeOptions): Promise<ProbeReport>;
+}
+//# sourceMappingURL=browser-agent.d.ts.map

package/dist/agent/browser-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-agent.d.ts","sourceRoot":"","sources":["../../src/agent/browser-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAExF,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAGjE,iEAAiE;AACjE,qBAAa,YAAY;IACvB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAEpB,IAAI,GAAE,YAAiB;IAInC,0EAA0E;IAC1E,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,aAAa,UAAQ,GAAG,eAAe;IAI3E;;;OAGG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAM1E,0DAA0D;IACpD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CAIhF"}

package/dist/agent/browser-agent.js

@@ -0,0 +1,36 @@
+/**
+ * High-level agentic browser facade: guardrails + probe orchestration.
+ * @module agent/browser-agent
+ */
+import { preflight } from "../guardrails/preflight.js";
+import { GuardrailViolation } from "../lib/errors.js";
+import { resolveConfig } from "./config.js";
+import { runProbe } from "./probe-run.js";
+/** Lightweight browser agent on top of Patchright/Playwright. */
+export class BrowserAgent {
+    /** Effective resolved configuration. */
+    config;
+    constructor(opts = {}) {
+        this.config = resolveConfig(opts);
+    }
+    /** Check whether the given actions are allowed without human approval. */
+    preflight(actions, humanApproved = false) {
+        return preflight(actions, humanApproved);
+    }
+    /**
+     * Probe a real URL: enforce guardrails then run the browser pipeline.
+     * @throws {GuardrailViolation} when a sensitive action lacks approval.
+     */
+    async probe(url, options = {}) {
+        const pf = preflight(options.actions ?? [], options.humanApproved ?? false);
+        if (!pf.allowed)
+            throw new GuardrailViolation(pf.reason, pf.blockedActions);
+        return runProbe(this.config, url, options);
+    }
+    /** Probe an inline HTML fixture via a base64 data URL. */
+    async probeHtml(html, options = {}) {
+        const dataUrl = `data:text/html;charset=utf-8;base64,${Buffer.from(html).toString("base64")}`;
+        return this.probe(dataUrl, options);
+    }
+}
+//# sourceMappingURL=browser-agent.js.map

package/dist/agent/browser-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-agent.js","sourceRoot":"","sources":["../../src/agent/browser-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAwB,MAAM,4BAA4B,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,iEAAiE;AACjE,MAAM,OAAO,YAAY;IACvB,wCAAwC;IAC/B,MAAM,CAAiB;IAEhC,YAAY,OAAqB,EAAE;QACjC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,0EAA0E;IAC1E,SAAS,CAAC,OAAwB,EAAE,aAAa,GAAG,KAAK;QACvD,OAAO,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,UAAwB,EAAE;QACjD,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;QAC5E,IAAI,CAAC,EAAE,CAAC,OAAO;YAAE,MAAM,IAAI,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC;QAC5E,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,UAAwB,EAAE;QACtD,MAAM,OAAO,GAAG,uCAAuC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9F,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/agent/compact.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compact projection of a probe report for tool/CLI output.
+ * @module agent/compact
+ */
+import type { ProbeReport } from "../interfaces/report.js";
+/** Pick the operationally useful fields from a full report. */
+export declare function compactReport(r: ProbeReport): Record<string, unknown>;
+//# sourceMappingURL=compact.d.ts.map

package/dist/agent/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/agent/compact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBrE"}

package/dist/agent/compact.js

@@ -0,0 +1,24 @@
+/** Pick the operationally useful fields from a full report. */
+export function compactReport(r) {
+    return {
+        title: r.title,
+        url: r.url,
+        realtime: r.realtime,
+        domChanged: r.domChanged,
+        text: r.text,
+        prices: r.prices,
+        hotelOffers: r.hotelOffers,
+        challenges: r.challenges,
+        visual: r.visual,
+        actions: r.actions,
+        replay: r.replay,
+        siteMemory: r.siteMemory,
+        currency: r.currency,
+        identity: r.identity,
+        consent: r.consent,
+        screenshotPath: r.screenshotPath,
+        reportPath: r.reportPath,
+        storageStatePath: r.storageStatePath,
+    };
+}
+//# sourceMappingURL=compact.js.map

package/dist/agent/compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.js","sourceRoot":"","sources":["../../src/agent/compact.ts"],"names":[],"mappings":"AAMA,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,CAAc;IAC1C,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;KACrC,CAAC;AACJ,CAAC"}

package/dist/agent/config.d.ts

@@ -0,0 +1,30 @@
+import { type ResolvedIdentity } from "../identity/resolve.js";
+import type { BrowserChannel, EngineName } from "../interfaces/engine-types.js";
+import type { CaptchaConfig, RetryConfig } from "../interfaces/net.js";
+import type { AgentOptions } from "../interfaces/types.js";
+import { type ProxySource } from "../proxy/country-map.js";
+/** Effective configuration used by every probe run. */
+export interface ResolvedConfig {
+    outputDir: string;
+    engine: EngineName;
+    channel: BrowserChannel | null;
+    executablePath: string | null;
+    cdpEndpoint: string | null;
+    storageStatePath: string | null;
+    humanMode: boolean;
+    headless: boolean;
+    identity: ResolvedIdentity;
+    currency: string;
+    userDataDir: string | null;
+    proxyUrl: string | null;
+    proxySource: ProxySource;
+    realisticProfile: boolean;
+    replayEnabled: boolean;
+    replayDir: string;
+    siteMemoryDir: string;
+    retry: RetryConfig;
+    captcha: CaptchaConfig | null;
+}
+/** Build the resolved configuration, creating required directories. */
+export declare function resolveConfig(opts?: AgentOptions): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/agent/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agent/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAuB,KAAK,WAAW,EAAgB,MAAM,yBAAyB,CAAC;AAE9F,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;CAC/B;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,GAAE,YAAiB,GAAG,cAAc,CAoCrE"}

package/dist/agent/config.js

@@ -0,0 +1,49 @@
+/**
+ * Resolve agent options into an effective, normalized configuration.
+ * @module agent/config
+ */
+import { join } from "node:path";
+import { resolveIdentity } from "../identity/resolve.js";
+import { ensureDir } from "../lib/fs.js";
+import { resolveDefaultOutputDir } from "../lib/output-dir.js";
+import { loadProxyCountryMap, resolveProxy } from "../proxy/country-map.js";
+/** Build the resolved configuration, creating required directories. */
+export function resolveConfig(opts = {}) {
+    const outputDir = opts.outputDir ?? resolveDefaultOutputDir();
+    ensureDir(outputDir);
+    const identity = resolveIdentity(opts);
+    const map = loadProxyCountryMap(opts.proxyCountryMap, opts.proxyMapPath);
+    const { proxyUrl, proxySource } = resolveProxy(opts.proxyUrl, identity.countryCode, map);
+    const userDataDir = opts.userDataDir ?? null;
+    if (userDataDir)
+        ensureDir(userDataDir);
+    const siteMemoryDir = opts.siteMemoryDir ?? join(outputDir, "site-memory");
+    ensureDir(siteMemoryDir);
+    return {
+        outputDir,
+        engine: opts.engine ?? "patchright",
+        channel: opts.channel ?? null,
+        executablePath: opts.executablePath ?? null,
+        cdpEndpoint: opts.cdpEndpoint ?? null,
+        storageStatePath: opts.storageStatePath ?? null,
+        humanMode: opts.humanMode ?? false,
+        headless: opts.headless ?? true,
+        identity,
+        currency: identity.currency,
+        userDataDir,
+        proxyUrl,
+        proxySource,
+        realisticProfile: opts.realisticProfile ?? true,
+        replayEnabled: opts.replayEnabled ?? false,
+        replayDir: opts.replayDir ?? join(outputDir, "replay"),
+        siteMemoryDir,
+        retry: {
+            maxAttempts: opts.retry?.maxAttempts ?? 3,
+            baseMs: opts.retry?.baseMs ?? 300,
+            capMs: opts.retry?.capMs ?? 10_000,
+            throttleMs: opts.retry?.throttleMs ?? 0,
+        },
+        captcha: opts.captcha ?? null,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/agent/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/agent/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAyB,MAAM,wBAAwB,CAAC;AAIhF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAoB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAyB9F,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,OAAqB,EAAE;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,uBAAuB,EAAE,CAAC;IAC9D,SAAS,CAAC,SAAS,CAAC,CAAC;IACrB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACzF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;IAC7C,IAAI,WAAW;QAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAC3E,SAAS,CAAC,aAAa,CAAC,CAAC;IACzB,OAAO;QACL,SAAS;QACT,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;QAC3C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;QAC/C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK;QAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW;QACX,QAAQ;QACR,WAAW;QACX,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;QAC/C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,KAAK;QAC1C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;QACtD,aAAa;QACb,KAAK,EAAE;YACL,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC;YACzC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,IAAI,MAAM;YAClC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC;SACxC;QACD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;KAC9B,CAAC;AACJ,CAAC"}

package/dist/agent/detect.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Challenge detection and optional captcha solving for a probe run.
+ * @module agent/detect
+ */
+import type { Page } from "playwright";
+import type { Challenges } from "../interfaces/extraction.js";
+import type { CaptchaOutcome } from "../interfaces/net.js";
+import type { ProbeOptions } from "../interfaces/types.js";
+import type { ResolvedConfig } from "./config.js";
+/** Detection result: challenge flags plus an optional captcha outcome. */
+export interface DetectResult {
+    challenges: Challenges | Record<string, never>;
+    captcha?: CaptchaOutcome;
+}
+/** Detect challenges (when requested) and solve a captcha when opted-in. */
+export declare function detectAndSolve(page: Page, text: string, options: ProbeOptions, config: ResolvedConfig): Promise<DetectResult>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/agent/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/agent/detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,YAAY,CAAC,CAKvB"}

package/dist/agent/detect.js

@@ -0,0 +1,9 @@
+import { solveIfEnabled } from "../captcha/solve.js";
+import { detectChallenges } from "../extraction/challenges.js";
+/** Detect challenges (when requested) and solve a captcha when opted-in. */
+export async function detectAndSolve(page, text, options, config) {
+    const challenges = options.detectChallenges || options.solveCaptcha ? await detectChallenges(page, text) : {};
+    const captcha = await solveIfEnabled(page, challenges, options, config);
+    return { challenges, captcha };
+}
+//# sourceMappingURL=detect.js.map

package/dist/agent/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/agent/detect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAY/D,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAU,EACV,IAAY,EACZ,OAAqB,EACrB,MAAsB;IAEtB,MAAM,UAAU,GACd,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7F,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/dist/agent/network.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Attach network and console listeners to a page.
+ * @module agent/network
+ */
+import type { Page } from "playwright";
+/** Collected network and console entries (live, mutated by the listeners). */
+export interface NetworkLog {
+    network: Array<Record<string, unknown>>;
+    console: Array<{
+        type: string;
+        text: string;
+    }>;
+}
+/** Register request/response/console listeners and return their backing arrays. */
+export declare function attachListeners(page: Page): NetworkLog;
+//# sourceMappingURL=network.d.ts.map

package/dist/agent/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/agent/network.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAOD,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAOtD"}

package/dist/agent/network.js

@@ -0,0 +1,16 @@
+const MAX_ENTRIES = 80;
+function pushCapped(arr, item) {
+    arr.push(item);
+    if (arr.length > MAX_ENTRIES)
+        arr.shift();
+}
+/** Register request/response/console listeners and return their backing arrays. */
+export function attachListeners(page) {
+    const network = [];
+    const consoleEntries = [];
+    page.on("request", (req) => pushCapped(network, { type: "request", method: req.method(), url: req.url() }));
+    page.on("response", (res) => pushCapped(network, { type: "response", status: res.status(), url: res.url() }));
+    page.on("console", (msg) => pushCapped(consoleEntries, { type: msg.type(), text: msg.text() }));
+    return { network, console: consoleEntries };
+}
+//# sourceMappingURL=network.js.map

package/dist/agent/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/agent/network.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,GAAG,EAAE,CAAC;AAQvB,SAAS,UAAU,CAAI,GAAQ,EAAE,IAAO;IACtC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,IAAI,GAAG,CAAC,MAAM,GAAG,WAAW;QAAE,GAAG,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,MAAM,cAAc,GAA0C,EAAE,CAAC;IACjE,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5G,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9G,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAChG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC9C,CAAC"}

package/dist/agent/probe-run.d.ts

@@ -0,0 +1,6 @@
+import type { ProbeReport } from "../interfaces/report.js";
+import type { ProbeOptions } from "../interfaces/types.js";
+import type { ResolvedConfig } from "./config.js";
+/** Run one probe against `url` and return the assembled report. */
+export declare function runProbe(config: ResolvedConfig, url: string, options?: ProbeOptions): Promise<ProbeReport>;
+//# sourceMappingURL=probe-run.d.ts.map

package/dist/agent/probe-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-run.d.ts","sourceRoot":"","sources":["../../src/agent/probe-run.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,mEAAmE;AACnE,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA6DtB"}

package/dist/agent/probe-run.js

@@ -0,0 +1,90 @@
+/**
+ * Orchestrate a single probe run: launch, navigate, act, capture, report.
+ * @module agent/probe-run
+ */
+import { dirname, join } from "node:path";
+import {} from "../actions/perform.js";
+import { prepareBookingCurrency } from "../consent/booking-currency.js";
+import { handleCommonConsent } from "../consent/consent.js";
+import { applyCurrencyPreference } from "../consent/currency.js";
+import { urlWithCurrency } from "../consent/currency-url.js";
+import { selectEngine } from "../engine/registry.js";
+import { mainText } from "../extraction/main-text.js";
+import { visualObservation } from "../extraction/visual.js";
+import { ensureDir, sha1 } from "../lib/fs.js";
+import { gotoWithRetry } from "../net/navigate.js";
+import { throttleHost } from "../net/throttle.js";
+import { domSignature } from "../state/dom-signature.js";
+import { runActions } from "./actions-loop.js";
+import { detectAndSolve } from "./detect.js";
+import { attachListeners } from "./network.js";
+import { buildReport } from "./report.js";
+/** Run one probe against `url` and return the assembled report. */
+export async function runProbe(config, url, options = {}) {
+    const actions = (options.actions ?? []);
+    const runId = sha1(`${url}-${Date.now()}`).slice(0, 10);
+    const screenshotPath = join(config.outputDir, `${runId}.png`);
+    const reportPath = join(config.outputDir, `${runId}.json`);
+    const { context, browser } = await selectEngine(config.engine).open(config);
+    try {
+        const page = await context.newPage();
+        const logs = attachListeners(page);
+        const targetUrl = urlWithCurrency(url, config.currency);
+        if (targetUrl.includes("booking.com") && config.currency) {
+            await prepareBookingCurrency(page, config.currency);
+        }
+        await throttleHost(targetUrl, config.retry.throttleMs);
+        await gotoWithRetry(page, targetUrl, { waitUntil: "domcontentloaded", timeout: 30_000 }, config.retry);
+        try {
+            await page.waitForLoadState("networkidle", { timeout: 10_000 });
+        }
+        catch {
+            /* networkidle is best-effort */
+        }
+        const consent = options.autoConsent
+            ? await handleCommonConsent(page, config.humanMode)
+            : { handled: false };
+        const currency = await applyCurrencyPreference(page, config.currency, config.identity.countryCode);
+        if (options.waitMs)
+            await page.waitForTimeout(options.waitMs);
+        const before = await domSignature(page);
+        const outcome = await runActions(page, config, actions, targetUrl, runId);
+        if (options.waitMs)
+            await page.waitForTimeout(options.waitMs);
+        const after = await domSignature(page);
+        const text = await mainText(page);
+        const { challenges, captcha } = await detectAndSolve(page, text, options, config);
+        const title = await page.title();
+        await page.screenshot({ path: screenshotPath, fullPage: true });
+        const visual = options.observeVisual ? await visualObservation(page, screenshotPath) : {};
+        if (config.storageStatePath) {
+            ensureDir(dirname(config.storageStatePath));
+            await context.storageState({ path: config.storageStatePath });
+        }
+        return buildReport({
+            config,
+            targetUrl,
+            title,
+            text,
+            before,
+            after,
+            hasActions: actions.length > 0,
+            consent,
+            currency,
+            challenges,
+            visual,
+            outcome,
+            logs,
+            screenshotPath,
+            reportPath,
+            extractPricesFlag: Boolean(options.extractPrices),
+            captcha,
+        });
+    }
+    finally {
+        await context.close();
+        if (browser)
+            await browser.close();
+    }
+}
+//# sourceMappingURL=probe-run.js.map

package/dist/agent/probe-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-run.js","sourceRoot":"","sources":["../../src/agent/probe-run.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAoB,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAsB,EACtB,GAAW,EACX,UAAwB,EAAE;IAE1B,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAkB,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IAC3D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzD,MAAM,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACvG,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW;YACjC,CAAC,CAAC,MAAM,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC;YACnD,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACnG,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAC1E,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAClF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC5C,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,WAAW,CAAC;YACjB,MAAM;YACN,SAAS;YACT,KAAK;YACL,IAAI;YACJ,MAAM;YACN,KAAK;YACL,UAAU,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;YAC9B,OAAO;YACP,QAAQ;YACR,UAAU;YACV,MAAM;YACN,OAAO;YACP,IAAI;YACJ,cAAc;YACd,UAAU;YACV,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;YACjD,OAAO;SACR,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,OAAO;YAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/agent/report.d.ts

@@ -0,0 +1,29 @@
+import type { Challenges, Visual } from "../interfaces/extraction.js";
+import type { CaptchaOutcome } from "../interfaces/net.js";
+import type { ConsentResult, CurrencyResult, ProbeReport } from "../interfaces/report.js";
+import type { ActionsOutcome } from "./actions-loop.js";
+import type { ResolvedConfig } from "./config.js";
+import type { NetworkLog } from "./network.js";
+/** All inputs needed to assemble a {@link ProbeReport}. */
+export interface ReportInput {
+    config: ResolvedConfig;
+    targetUrl: string;
+    title: string;
+    text: string;
+    before: string;
+    after: string;
+    hasActions: boolean;
+    consent: ConsentResult;
+    currency: CurrencyResult;
+    challenges: Challenges | Record<string, never>;
+    visual: Visual | Record<string, never>;
+    outcome: ActionsOutcome;
+    logs: NetworkLog;
+    screenshotPath: string;
+    reportPath: string;
+    extractPricesFlag: boolean;
+    captcha?: CaptchaOutcome;
+}
+/** Build the full report, write it to disk, and return it. */
+export declare function buildReport(input: ReportInput): ProbeReport;
+//# sourceMappingURL=report.d.ts.map

package/dist/agent/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/agent/report.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAyC3D"}

package/dist/agent/report.js

@@ -0,0 +1,53 @@
+/**
+ * Assemble and persist the probe report.
+ * @module agent/report
+ */
+import { extractHotelOffers } from "../extraction/hotel-offers.js";
+import { extractPrices } from "../extraction/prices.js";
+import { buildIdentity } from "../identity/identity.js";
+import { writeJson } from "../lib/fs.js";
+import { siteMemoryFilePath } from "../state/site-memory.js";
+/** Build the full report, write it to disk, and return it. */
+export function buildReport(input) {
+    const { config, outcome, logs } = input;
+    const report = {
+        url: input.targetUrl,
+        title: input.title,
+        realtime: input.hasActions && input.before !== input.after,
+        domChanged: input.before !== input.after,
+        text: input.text,
+        prices: input.extractPricesFlag ? extractPrices(input.text) : [],
+        hotelOffers: input.extractPricesFlag ? extractHotelOffers(input.text) : {},
+        challenges: input.challenges,
+        visual: input.visual,
+        consent: input.consent,
+        currency: input.currency,
+        identity: buildIdentity({
+            identity: config.identity,
+            realisticProfile: config.realisticProfile,
+            userDataDir: config.userDataDir,
+            proxyUrl: config.proxyUrl,
+            proxySource: config.proxySource,
+        }),
+        actions: outcome.results,
+        replay: {
+            enabled: config.replayEnabled,
+            steps: outcome.replaySteps,
+            dir: config.replayEnabled ? config.replayDir : null,
+        },
+        siteMemory: {
+            enabled: true,
+            updated: outcome.siteMemoryUpdated,
+            filePath: siteMemoryFilePath(config.siteMemoryDir, input.targetUrl),
+        },
+        network: logs.network.slice(-80),
+        console: logs.console.slice(-80),
+        screenshotPath: input.screenshotPath,
+        reportPath: input.reportPath,
+        storageStatePath: config.storageStatePath,
+        captcha: input.captcha,
+    };
+    writeJson(input.reportPath, report);
+    return report;
+}
+//# sourceMappingURL=report.js.map

package/dist/agent/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/agent/report.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIxD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AA0B7D,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACxC,MAAM,MAAM,GAAgB;QAC1B,GAAG,EAAE,KAAK,CAAC,SAAS;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK;QAC1D,UAAU,EAAE,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK;QACxC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QAChE,WAAW,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1E,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,aAAa,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QACF,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC,aAAa;YAC7B,KAAK,EAAE,OAAO,CAAC,WAAW;YAC1B,GAAG,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;SACpD;QACD,UAAU,EAAE;YACV,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO,CAAC,iBAAiB;YAClC,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC;SACpE;QACD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAChC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;IACF,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/agent/run-steps.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Execute a multi-step plan in one call: navigate / act / waitFor / extract.
+ * Stops at the first failed step and returns a per-step report. Reduces the
+ * number of LLM round-trips for predictable sequences.
+ * @module agent/run-steps
+ */
+import type { Page } from "playwright";
+/** A single step. `type` selects the operation; other fields are step args. */
+export type RunStep = Record<string, unknown> & {
+    type: string;
+};
+/** Result of one executed step. */
+export interface StepResult {
+    index: number;
+    type: string;
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+}
+/** Run steps in order, stopping at the first failure. */
+export declare function runSteps(page: Page, steps: RunStep[], humanMode?: boolean): Promise<StepResult[]>;
+//# sourceMappingURL=run-steps.d.ts.map