auspex 0.1.1 → 0.2.1

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

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/agent/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAe,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEtF,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAerF"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/agent/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAe,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEtF,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAqBrF"}

package/dist/agent/actions.js

@@ -13,12 +13,18 @@ export function formatActionForHistory(action, iteration) {
             return `[${iteration}] click "${action.selector}"`;
         case "type":
             return `[${iteration}] type "${action.text}" into "${action.selector}"`;
+        case "select":
+            return `[${iteration}] select "${action.value}" in "${action.selector}"`;
+        case "pressKey":
+            return `[${iteration}] press key "${action.key}"`;
+        case "hover":
+            return `[${iteration}] hover "${action.selector}"`;
         case "goto":
             return `[${iteration}] navigate to ${action.url}`;
         case "wait":
             return `[${iteration}] wait ${action.ms}ms`;
         case "scroll":
-            return `[${iteration}] scroll ${action.direction}`;
+            return `[${iteration}] scroll ${action.direction}${action.amount ? ` ${action.amount}px` : ""}`;
         case "done":
             return `[${iteration}] done: ${action.result}`;
     }

package/dist/agent/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/agent/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAyB,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAY,EACZ,UAAgC;IAEhC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAmB,EAAE,SAAiB;IAC3E,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,IAAI,SAAS,YAAY,MAAM,CAAC,QAAQ,GAAG,CAAC;QACrD,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,WAAW,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,QAAQ,GAAG,CAAC;QAC1E,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,iBAAiB,MAAM,CAAC,GAAG,EAAE,CAAC;QACpD,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,UAAU,MAAM,CAAC,EAAE,IAAI,CAAC;QAC9C,KAAK,QAAQ;YACX,OAAO,IAAI,SAAS,YAAY,MAAM,CAAC,SAAS,EAAE,CAAC;QACrD,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC;AACH,CAAC"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/agent/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAY,EACZ,UAAgC;IAEhC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAmB,EAAE,SAAiB;IAC3E,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,IAAI,SAAS,YAAY,MAAM,CAAC,QAAQ,GAAG,CAAC;QACrD,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,WAAW,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,QAAQ,GAAG,CAAC;QAC1E,KAAK,QAAQ;YACX,OAAO,IAAI,SAAS,aAAa,MAAM,CAAC,KAAK,SAAS,MAAM,CAAC,QAAQ,GAAG,CAAC;QAC3E,KAAK,UAAU;YACb,OAAO,IAAI,SAAS,gBAAgB,MAAM,CAAC,GAAG,GAAG,CAAC;QACpD,KAAK,OAAO;YACV,OAAO,IAAI,SAAS,YAAY,MAAM,CAAC,QAAQ,GAAG,CAAC;QACrD,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,iBAAiB,MAAM,CAAC,GAAG,EAAE,CAAC;QACpD,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,UAAU,MAAM,CAAC,EAAE,IAAI,CAAC;QAC9C,KAAK,QAAQ;YACX,OAAO,IAAI,SAAS,YAAY,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAClG,KAAK,MAAM;YACT,OAAO,IAAI,SAAS,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/agent/agent.d.ts

@@ -1,12 +1,26 @@
-import type { AgentConfig, AgentResult, RunOptions } from "../types.js";
-export declare class Auspex {
+import { EventEmitter } from "node:events";
+import { type ZodType } from "zod";
+import type { AgentConfig, AgentResult, RunOptions, AuspexEvents } from "../types.js";
+import type { BrowserPool } from "../browser/pool.js";
+export declare class Auspex extends EventEmitter {
     private config;
     private browser;
-    constructor(config: AgentConfig);
-    private getChromiumPids;
-    private makeChromiumMemoryTracker;
-    private ensureBrowser;
+    private browserPromise;
+    private pool;
+    constructor(config: AgentConfig, pool?: BrowserPool);
+    emit<K extends keyof AuspexEvents>(event: K, ...args: AuspexEvents[K]): boolean;
+    on<K extends keyof AuspexEvents>(event: K, listener: (...args: AuspexEvents[K]) => void): this;
+    once<K extends keyof AuspexEvents>(event: K, listener: (...args: AuspexEvents[K]) => void): this;
+    private acquireBrowser;
+    private releaseBrowser;
+    run<T>(options: RunOptions & {
+        schema: ZodType<T>;
+    }): Promise<AgentResult & {
+        data: T | null;
+    }>;
     run(options: RunOptions): Promise<AgentResult>;
+    private applySchema;
     close(): Promise<void>;
+    private makeAbortedResult;
 }
 //# sourceMappingURL=agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOxE,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,MAAM,EAAE,WAAW;IAM/B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,yBAAyB;YA4BnB,aAAa;IAYrB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IA4F9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAA0C,MAAM,aAAa,CAAC;AAO9H,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qBAAa,MAAO,SAAQ,YAAY;IACtC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,IAAI,CAAqB;gBAErB,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,WAAW;IAQ1C,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO;IAI/E,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAI9F,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;YAM3F,cAAc;IAgC5B,OAAO,CAAC,cAAc;IAOhB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAC/F,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IA4LpD,OAAO,CAAC,WAAW;IAkBb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,OAAO,CAAC,iBAAiB;CAe1B"}

package/dist/agent/agent.js

@@ -1,80 +1,102 @@
-import { execSync } from "node:child_process";
+import { EventEmitter } from "node:events";
 import { chromium } from "playwright";
 import { gotScraping } from "got-scraping";
+import { zodToJsonSchema } from "zod-to-json-schema";
 import { agentConfigSchema, runOptionsSchema } from "../config/schema.js";
 import { validateUrl } from "../security/url-validator.js";
 import { snapshotFromHtml } from "../browser/snapshot.js";
 import { runStaticLoop, runAgentLoop } from "./loop.js";
 import { generateReport } from "./report.js";
-export class Auspex {
+import { RunLogger } from "./logger.js";
+export class Auspex extends EventEmitter {
     config;
     browser = null;
-    constructor(config) {
+    browserPromise = null;
+    pool;
+    constructor(config, pool) {
+        super();
         this.config = agentConfigSchema.parse(config);
+        this.pool = pool ?? null;
     }
-    // ── Snapshot de PIDs do Chromium antes do launch ─────────────────────────
-    getChromiumPids() {
-        try {
-            const out = execSync("ps aux | grep -i chromium | grep -v grep | awk '{print $2}'", {
-                encoding: "utf-8",
-                timeout: 2_000,
-            });
-            return new Set(out.trim().split("\n").filter(Boolean));
-        }
-        catch {
-            return new Set();
-        }
+    // ── Type-safe event emitter methods ────────────────────────────────────────
+    emit(event, ...args) {
+        return super.emit(event, ...args);
     }
-    // ── Soma RSS de todos os processos Chromium novos (KB) ────────────────────
-    makeChromiumMemoryTracker(pidsBeforeLaunch) {
-        return () => {
-            try {
-                const out = execSync("ps aux | grep -i chromium | grep -v grep | awk '{print $2}'", {
-                    encoding: "utf-8",
-                    timeout: 2_000,
-                });
-                const newPids = out.trim().split("\n").filter(p => p && !pidsBeforeLaunch.has(p));
-                if (newPids.length === 0)
-                    return 0;
-                // Soma o RSS de todos os processos Chromium lançados por este agente
-                const pidsArg = newPids.join(",");
-                const rssOut = execSync(`ps -o rss= -p ${pidsArg}`, {
-                    encoding: "utf-8",
-                    timeout: 2_000,
-                });
-                return rssOut
-                    .trim()
-                    .split("\n")
-                    .reduce((sum, line) => sum + (parseInt(line.trim(), 10) || 0), 0);
-            }
-            catch {
-                return 0;
-            }
-        };
+    on(event, listener) {
+        return super.on(event, listener);
     }
-    // ── Garante que o browser Playwright está rodando ─────────────────────────
-    async ensureBrowser() {
-        if (!this.browser || !this.browser.isConnected()) {
-            this.browser = await chromium.launch({
-                headless: true,
-                args: ["--disable-blink-features=AutomationControlled"],
-            });
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    // ── Browser lifecycle ────────────────────────────────────────────────────────
+    async acquireBrowser() {
+        // Pool mode: acquire from shared pool each run
+        if (this.pool)
+            return this.pool.acquire();
+        // Singleton mode: reuse the same browser across runs
+        if (this.browser?.isConnected())
+            return this.browser;
+        if (!this.browserPromise) {
+            this.browserPromise = (async () => {
+                const launchOptions = {
+                    headless: true,
+                    args: ["--disable-blink-features=AutomationControlled"],
+                };
+                if (this.config.proxy) {
+                    launchOptions.proxy = {
+                        server: this.config.proxy.server,
+                        username: this.config.proxy.username,
+                        password: this.config.proxy.password,
+                    };
+                }
+                const browser = await chromium.launch(launchOptions);
+                this.browser = browser;
+                this.browserPromise = null;
+                return browser;
+            })();
         }
-        return this.browser;
+        return this.browserPromise;
+    }
+    releaseBrowser(browser) {
+        if (this.pool)
+            this.pool.release(browser);
+        // Singleton mode: keep browser alive — no release needed
     }
-    // ── Execução principal ────────────────────────────────────────────────────
     async run(options) {
-        const { url, prompt } = runOptionsSchema.parse(options);
+        const validated = runOptionsSchema.parse(options);
+        const { url, prompt } = validated;
+        const signal = options.signal;
+        const schema = options.schema;
+        // Per-run overrides
+        const effectiveConfig = { ...this.config };
+        if (validated.maxIterations)
+            effectiveConfig.maxIterations = validated.maxIterations;
+        if (validated.timeoutMs)
+            effectiveConfig.timeoutMs = validated.timeoutMs;
+        if (validated.actionDelayMs !== undefined)
+            effectiveConfig.actionDelayMs = validated.actionDelayMs;
+        if (validated.vision !== undefined)
+            effectiveConfig.vision = validated.vision;
+        // ── Logger setup ─────────────────────────────────────────────────────
+        const logger = effectiveConfig.log ? new RunLogger(effectiveConfig.logDir) : null;
+        logger?.logStart(url, prompt);
+        if (signal?.aborted) {
+            return this.makeAbortedResult(url, prompt);
+        }
         const validUrl = await validateUrl(url, {
-            allowedDomains: this.config.allowedDomains,
-            blockedDomains: this.config.blockedDomains,
+            allowedDomains: effectiveConfig.allowedDomains,
+            blockedDomains: effectiveConfig.blockedDomains,
         });
-        // ── 1. Tenta HTTP/Cheerio primeiro (sem browser) ──────────────────────
-        //
-        // Se o HTML da página já tiver conteúdo suficiente E o LLM conseguir
-        // responder com "done" na primeira tentativa → economizamos o Playwright
-        // (zero processos externos, ~100-500ms vs ~5-30s).
-        //
+        // ── Schema description for structured extraction ────────────────────
+        let schemaDescription;
+        if (schema) {
+            const jsonSchema = zodToJsonSchema(schema, { target: "openApi3" });
+            schemaDescription = JSON.stringify(jsonSchema, null, 2);
+        }
+        // Track tokens used during static loop attempt (added to Playwright result if fallback)
+        let staticLoopUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0, calls: 0 };
+        // ── 1. Try HTTP/Cheerio first (no browser) ──────────────────────────────
+        logger?.logTier("http (attempt)");
         try {
             const response = await gotScraping({
                 url: validUrl,
@@ -85,45 +107,102 @@ export class Auspex {
                     devices: ["desktop"],
                     locales: ["pt-BR", "pt", "en-US"],
                 },
-                timeout: { request: Math.min(this.config.timeoutMs, 10_000) },
+                timeout: { request: Math.min(effectiveConfig.timeoutMs, 10_000) },
                 followRedirect: true,
                 maxRedirects: 10,
                 throwHttpErrors: false,
                 decompress: true,
             });
-            const { body: html, statusCode: status } = response;
+            const html = response.body;
+            const status = response.statusCode;
             if (html && status < 400) {
                 const snapshot = snapshotFromHtml(html, validUrl);
-                // Só tenta o loop estático se houver conteúdo mínimo (evita SPA vazia)
                 if (snapshot.text.length > 200) {
-                    const staticResult = await runStaticLoop(snapshot, validUrl, prompt, this.config);
-                    if (staticResult)
-                        return staticResult; // ✅ resolvido sem browser
+                    this.emit("tier", "http");
+                    const staticLoop = await runStaticLoop(snapshot, validUrl, prompt, effectiveConfig, signal, schemaDescription);
+                    staticLoopUsage = staticLoop.usage;
+                    if (staticLoop.result) {
+                        const finalResult = this.applySchema(staticLoop.result, schema, validUrl, prompt);
+                        this.emit("done", finalResult);
+                        return finalResult;
+                    }
                 }
             }
         }
         catch {
-            // HTTP falhou (timeout, SSL, rede) → vai direto para o Playwright
+            // HTTP failed (timeout, SSL, network) → go to Playwright
         }
-        // ── 2. Playwright (fallback — página precisa de JS ou de interação) ───
-        const pidsBefore = this.getChromiumPids();
-        const browser = await this.ensureBrowser();
-        const getMemoryKb = this.makeChromiumMemoryTracker(pidsBefore);
+        // ── 2. Playwright (fallback) ─────────────────────────────────────────────
+        logger?.logTier("playwright");
+        this.emit("tier", "playwright");
+        const browser = await this.acquireBrowser();
         let page = null;
         try {
-            const context = await browser.newContext({
+            const contextOptions = {
                 viewport: { width: 1280, height: 720 },
                 locale: "pt-BR",
                 timezoneId: "America/Sao_Paulo",
-            });
+                extraHTTPHeaders: this.config.extraHeaders,
+            };
+            if (this.config.proxy) {
+                contextOptions.proxy = {
+                    server: this.config.proxy.server,
+                    username: this.config.proxy.username,
+                    password: this.config.proxy.password,
+                };
+            }
+            const context = await browser.newContext(contextOptions);
+            // Inject cookies if provided
+            if (this.config.cookies && this.config.cookies.length > 0) {
+                await context.addCookies(this.config.cookies.map((c) => ({
+                    name: c.name,
+                    value: c.value,
+                    domain: c.domain ?? new URL(validUrl).hostname,
+                    path: c.path ?? "/",
+                    httpOnly: c.httpOnly,
+                    secure: c.secure,
+                    sameSite: c.sameSite,
+                    expires: c.expires,
+                })));
+            }
             context.addInitScript(() => {
                 Object.defineProperty(navigator, "webdriver", { get: () => false, configurable: true });
                 window.chrome = { runtime: {} };
             });
             page = await context.newPage();
-            const gotoTimeout = this.config.gotoTimeoutMs ?? 15_000;
+            const gotoTimeout = effectiveConfig.gotoTimeoutMs ?? 15_000;
             await page.goto(validUrl, { waitUntil: "domcontentloaded", timeout: gotoTimeout });
-            return await runAgentLoop(page, validUrl, prompt, this.config, getMemoryKb);
+            const result = await runAgentLoop(page, validUrl, prompt, effectiveConfig, () => 0, {
+                actionDelayMs: effectiveConfig.actionDelayMs,
+                maxTotalTokens: effectiveConfig.maxTotalTokens,
+                signal,
+                schemaDescription,
+                onAction: (action, iteration) => {
+                    logger?.logAction(action, iteration);
+                    this.emit("action", action, iteration);
+                },
+                onActionResult: (iteration, ok, error) => {
+                    logger?.logActionResult(iteration, ok, error);
+                },
+                onInvalidAction: (iteration, error) => {
+                    logger?.logInvalidAction(iteration, error);
+                },
+                onIteration: (iteration, snapshot) => {
+                    logger?.logIteration(iteration, snapshot);
+                    this.emit("iteration", iteration, snapshot);
+                },
+            });
+            // Add tokens consumed during the static loop attempt (if any)
+            if (staticLoopUsage.calls > 0) {
+                result.usage.promptTokens += staticLoopUsage.promptTokens;
+                result.usage.completionTokens += staticLoopUsage.completionTokens;
+                result.usage.totalTokens += staticLoopUsage.totalTokens;
+                result.usage.calls += staticLoopUsage.calls;
+            }
+            const finalResult = this.applySchema(result, schema, validUrl, prompt);
+            logger?.logResult(finalResult);
+            this.emit("done", finalResult);
+            return finalResult;
         }
         catch (err) {
             const errorMsg = err instanceof Error ? err.message : String(err);
@@ -139,6 +218,9 @@ export class Auspex {
                 error: errorMsg,
             };
             result.report = generateReport(result, validUrl, prompt);
+            if (this.listenerCount("error") > 0) {
+                this.emit("error", err instanceof Error ? err : new Error(errorMsg));
+            }
             return result;
         }
         finally {
@@ -147,13 +229,54 @@ export class Auspex {
                 await page.close().catch(() => { });
                 await context.close().catch(() => { });
             }
+            this.releaseBrowser(browser);
+        }
+    }
+    applySchema(result, schema, url, prompt) {
+        if (!schema || result.status !== "done" || result.data === null)
+            return result;
+        try {
+            const parsed = JSON.parse(result.data);
+            const validated = schema.parse(parsed);
+            // Cast: when schema is provided, data becomes the validated object (T | null via overload)
+            result.data = validated;
+            return result;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.status = "error";
+            result.error = `Schema validation failed: ${msg}`;
+            result.data = null;
+            result.report = generateReport(result, url, prompt);
+            return result;
         }
     }
     async close() {
+        if (this.pool) {
+            // Pool-managed: detach only — caller owns the pool lifecycle
+            this.pool = null;
+            return;
+        }
         if (this.browser) {
             await this.browser.close().catch(() => { });
             this.browser = null;
         }
+        this.browserPromise = null;
+    }
+    makeAbortedResult(url, prompt) {
+        const result = {
+            status: "aborted",
+            tier: "http",
+            data: null,
+            report: "",
+            durationMs: 0,
+            actions: [],
+            usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0, calls: 0 },
+            memory: { browserPeakRssKb: 0, nodeHeapUsedMb: 0 },
+            error: "Aborted by user",
+        };
+        result.report = generateReport(result, url, prompt);
+        return result;
     }
 }
 //# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAA2B,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAwB,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,OAAO,MAAO,SAAQ,YAAY;IAC9B,MAAM,CAAkB;IACxB,OAAO,GAAmB,IAAI,CAAC;IAC/B,cAAc,GAA4B,IAAI,CAAC;IAC/C,IAAI,CAAqB;IAEjC,YAAY,MAAmB,EAAE,IAAkB;QACjD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC;IAC3B,CAAC;IAED,8EAA8E;IAErE,IAAI,CAA+B,KAAQ,EAAE,GAAG,IAAqB;QAC5E,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IAEQ,EAAE,CAA+B,KAAQ,EAAE,QAA4C;QAC9F,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACnE,CAAC;IAEQ,IAAI,CAA+B,KAAQ,EAAE,QAA4C;QAChG,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACrE,CAAC;IAED,gFAAgF;IAExE,KAAK,CAAC,cAAc;QAC1B,+CAA+C;QAC/C,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAE1C,qDAAqD;QACrD,IAAI,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QAErD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,GAAG,CAAC,KAAK,IAAI,EAAE;gBAChC,MAAM,aAAa,GAA0C;oBAC3D,QAAQ,EAAE,IAAI;oBACd,IAAI,EAAE,CAAC,+CAA+C,CAAC;iBACxD,CAAC;gBAEF,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACtB,aAAa,CAAC,KAAK,GAAG;wBACpB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;wBAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ;wBACpC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ;qBACrC,CAAC;gBACJ,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBACrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;gBACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;gBAC3B,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEO,cAAc,CAAC,OAAgB;QACrC,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,yDAAyD;IAC3D,CAAC;IAMD,KAAK,CAAC,GAAG,CAAC,OAAmB;QAC3B,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAA6B,CAAC;QAErD,oBAAoB;QACpB,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,IAAI,SAAS,CAAC,aAAa;YAAE,eAAe,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QACrF,IAAI,SAAS,CAAC,SAAS;YAAE,eAAe,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QACzE,IAAI,SAAS,CAAC,aAAa,KAAK,SAAS;YAAE,eAAe,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QACnG,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;YAAE,eAAe,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAE9E,wEAAwE;QACxE,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE9B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE;YACtC,cAAc,EAAE,eAAe,CAAC,cAAc;YAC9C,cAAc,EAAE,eAAe,CAAC,cAAc;SAC/C,CAAC,CAAC;QAEH,uEAAuE;QACvE,IAAI,iBAAqC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACnE,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,wFAAwF;QACxF,IAAI,eAAe,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAEzF,2EAA2E;QAC3E,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC;gBACjC,GAAG,EAAE,QAAQ;gBACb,MAAM,EAAE,KAAK;gBACb,sBAAsB,EAAE;oBACtB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;oBAC/C,gBAAgB,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;oBACtC,OAAO,EAAE,CAAC,SAAS,CAAC;oBACpB,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;iBAClC;gBACD,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;gBACjE,cAAc,EAAE,IAAI;gBACpB,YAAY,EAAE,EAAE;gBAChB,eAAe,EAAE,KAAK;gBACtB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAc,CAAC;YACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC;YAEnC,IAAI,IAAI,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAElD,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC1B,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;oBAC/G,eAAe,GAAG,UAAU,CAAC,KAAK,CAAC;oBACnC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;wBACtB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;wBAClF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;wBAC/B,OAAO,WAAW,CAAC;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;QAED,4EAA4E;QAC5E,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE5C,IAAI,IAAI,GAAgB,IAAI,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,cAAc,GAAyC;gBAC3D,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;gBACtC,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,mBAAmB;gBAC/B,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;aAC3C,CAAC;YAEF,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,cAAc,CAAC,KAAK,GAAG;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;oBAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ;oBACpC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ;iBACrC,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YAEzD,6BAA6B;YAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1D,MAAM,OAAO,CAAC,UAAU,CACtB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC;oBAC3C,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ;oBAC9C,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,GAAG;oBACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC,CACJ,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE;gBACzB,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvF,MAA0C,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACvE,CAAC,CAAC,CAAC;YAEH,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,eAAe,CAAC,aAAa,IAAI,MAAM,CAAC;YAC5D,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAEnF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;gBAClF,aAAa,EAAE,eAAe,CAAC,aAAa;gBAC5C,cAAc,EAAE,eAAe,CAAC,cAAc;gBAC9C,MAAM;gBACN,iBAAiB;gBACjB,QAAQ,EAAE,CAAC,MAAmB,EAAE,SAAiB,EAAE,EAAE;oBACnD,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;oBACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;gBACzC,CAAC;gBACD,cAAc,EAAE,CAAC,SAAiB,EAAE,EAAW,EAAE,KAAc,EAAE,EAAE;oBACjE,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;gBAChD,CAAC;gBACD,eAAe,EAAE,CAAC,SAAiB,EAAE,KAAa,EAAE,EAAE;oBACpD,MAAM,EAAE,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAC7C,CAAC;gBACD,WAAW,EAAE,CAAC,SAAiB,EAAE,QAAsB,EAAE,EAAE;oBACzD,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;oBAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAC9C,CAAC;aACF,CAAC,CAAC;YAEH,8DAA8D;YAC9D,IAAI,eAAe,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,YAAY,IAAQ,eAAe,CAAC,YAAY,CAAC;gBAC9D,MAAM,CAAC,KAAK,CAAC,gBAAgB,IAAI,eAAe,CAAC,gBAAgB,CAAC;gBAClE,MAAM,CAAC,KAAK,CAAC,WAAW,IAAS,eAAe,CAAC,WAAW,CAAC;gBAC7D,MAAM,CAAC,KAAK,CAAC,KAAK,IAAe,eAAe,CAAC,KAAK,CAAC;YACzD,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvE,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC/B,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClE,MAAM,MAAM,GAAgB;gBAC1B,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,EAAE;gBACV,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;gBACzE,MAAM,EAAE,EAAE,gBAAgB,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE;gBAClD,KAAK,EAAE,QAAQ;aAChB,CAAC;YACF,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACzD,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvE,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,MAAmB,EAAE,MAA2B,EAAE,GAAW,EAAE,MAAc;QAC/F,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAC/E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACvC,2FAA2F;YAC1F,MAA4B,CAAC,IAAI,GAAG,SAAS,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;YACxB,MAAM,CAAC,KAAK,GAAG,6BAA6B,GAAG,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,6DAA6D;YAC7D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAEO,iBAAiB,CAAC,GAAW,EAAE,MAAc;QACnD,MAAM,MAAM,GAAgB;YAC1B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;YACzE,MAAM,EAAE,EAAE,gBAAgB,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE;YAClD,KAAK,EAAE,iBAAiB;SACzB,CAAC;QACF,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/agent/logger.d.ts

@@ -0,0 +1,15 @@
+import type { AgentAction, PageSnapshot, AgentResult } from "../types.js";
+export declare class RunLogger {
+    private filePath;
+    constructor(dir?: string);
+    private write;
+    logStart(url: string, prompt: string): void;
+    logTier(tier: string): void;
+    logIteration(i: number, snapshot: PageSnapshot): void;
+    logAction(action: AgentAction, i: number): void;
+    logActionResult(i: number, ok: boolean, error?: string): void;
+    logInvalidAction(i: number, error: string): void;
+    logResult(result: AgentResult): void;
+    getPath(): string;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/agent/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1E,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;gBAEb,GAAG,SAAS;IAOxB,OAAO,CAAC,KAAK;IAIb,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKpC,OAAO,CAAC,IAAI,EAAE,MAAM;IAIpB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY;IAM9C,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM;IAexC,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM;IAQtD,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAIzC,SAAS,CAAC,MAAM,EAAE,WAAW;IAgB7B,OAAO,IAAI,MAAM;CAGlB"}

package/dist/agent/logger.js

@@ -0,0 +1,70 @@
+import { mkdirSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+export class RunLogger {
+    filePath;
+    constructor(dir = "logs") {
+        mkdirSync(dir, { recursive: true });
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        this.filePath = join(dir, `auspex-${ts}.txt`);
+        this.write(`=== Auspex Run — ${new Date().toISOString()} ===\n`);
+    }
+    write(line) {
+        appendFileSync(this.filePath, line + "\n", "utf-8");
+    }
+    logStart(url, prompt) {
+        this.write(`URL   : ${url}`);
+        this.write(`Prompt: ${prompt}\n`);
+    }
+    logTier(tier) {
+        this.write(`[tier] ${tier}`);
+    }
+    logIteration(i, snapshot) {
+        this.write(`\n[iter ${i}] ${snapshot.url}`);
+        this.write(`  title: ${snapshot.title}`);
+        this.write(`  text (${snapshot.text.length} chars) | ${snapshot.links.length} links | ${snapshot.forms.length} forms`);
+    }
+    logAction(action, i) {
+        const desc = action.type === "click" ? `click "${action.selector}"` :
+            action.type === "type" ? `type "${action.text}" into "${action.selector}"` :
+                action.type === "select" ? `select "${action.value}" in "${action.selector}"` :
+                    action.type === "pressKey" ? `press ${action.key}` :
+                        action.type === "hover" ? `hover "${action.selector}"` :
+                            action.type === "goto" ? `goto ${action.url}` :
+                                action.type === "scroll" ? `scroll ${action.direction}${action.amount ? ` ${action.amount}px` : ""}` :
+                                    action.type === "wait" ? `wait ${action.ms}ms` :
+                                        action.type === "done" ? `done: ${action.result.slice(0, 200)}` :
+                                            JSON.stringify(action);
+        this.write(`  [action ${i}] ${desc}`);
+    }
+    logActionResult(i, ok, error) {
+        if (ok) {
+            this.write(`  [action ${i}] -> OK`);
+        }
+        else {
+            this.write(`  [action ${i}] -> ERROR: ${error}`);
+        }
+    }
+    logInvalidAction(i, error) {
+        this.write(`  [iter ${i}] INVALID ACTION: ${error}`);
+    }
+    logResult(result) {
+        this.write(`\n${"─".repeat(50)}`);
+        this.write(`Status  : ${result.status}`);
+        this.write(`Duration: ${result.durationMs}ms`);
+        this.write(`Tokens  : ${result.usage.totalTokens} (${result.usage.calls} calls)`);
+        this.write(`Actions : ${result.actions.length}`);
+        if (result.error)
+            this.write(`Error   : ${result.error}`);
+        if (result.data !== null && result.data !== undefined) {
+            const dataStr = typeof result.data === "string"
+                ? result.data.slice(0, 500)
+                : JSON.stringify(result.data).slice(0, 500);
+            this.write(`Data    : ${dataStr}`);
+        }
+        this.write(`\nLog file: ${this.filePath}`);
+    }
+    getPath() {
+        return this.filePath;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/agent/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/agent/logger.ts"],"names":[],"mappings":"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"}

package/dist/agent/loop.d.ts

@@ -1,6 +1,21 @@
 import type { Page } from "playwright-core";
-import type { AgentResult, PageSnapshot } from "../types.js";
+import type { AgentResult, LLMUsage, PageSnapshot, AgentAction } from "../types.js";
 import type { ValidatedConfig } from "../config/schema.js";
-export declare function runStaticLoop(snapshot: PageSnapshot, url: string, prompt: string, config: ValidatedConfig): Promise<AgentResult | null>;
-export declare function runAgentLoop(page: Page, url: string, prompt: string, config: ValidatedConfig, getMemoryKb?: () => number): Promise<AgentResult>;
+export interface StaticLoopResult {
+    result: AgentResult | null;
+    usage: LLMUsage;
+}
+export declare function runStaticLoop(snapshot: PageSnapshot, url: string, prompt: string, config: ValidatedConfig, signal?: AbortSignal, schemaDescription?: string): Promise<StaticLoopResult>;
+export interface LoopOptions {
+    actionDelayMs?: number;
+    maxTotalTokens?: number;
+    signal?: AbortSignal;
+    /** JSON Schema description string injected into the LLM prompt for structured extraction */
+    schemaDescription?: string;
+    onAction?: (action: AgentAction, iteration: number) => void;
+    onActionResult?: (iteration: number, ok: boolean, error?: string) => void;
+    onInvalidAction?: (iteration: number, error: string) => void;
+    onIteration?: (iteration: number, snapshot: PageSnapshot) => void;
+}
+export declare function runAgentLoop(page: Page, url: string, prompt: string, config: ValidatedConfig, getMemoryKb?: () => number, loopOptions?: LoopOptions): Promise<AgentResult>;
 //# sourceMappingURL=loop.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAkD,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAwD3D,wBAAsB,aAAa,CACjC,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAsD7B;AASD,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,EACvB,WAAW,GAAE,MAAM,MAAgB,GAClC,OAAO,CAAC,WAAW,CAAC,CAuGtB"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAgB,QAAQ,EAA0B,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkF3D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAyD3B;AAID,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4FAA4F;IAC5F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;CACnE;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,EACvB,WAAW,GAAE,MAAM,MAAgB,EACnC,WAAW,GAAE,WAAgB,GAC5B,OAAO,CAAC,WAAW,CAAC,CA2KtB"}