auspex 0.3.0 → 0.4.0

package/dist/agent/actions.d.ts

@@ -0,0 +1,5 @@
+import type { AgentAction } from "../types.js";
+import { type UrlValidationOptions } from "../security/url-validator.js";
+export declare function parseAndValidateAction(raw: unknown, urlOptions: UrlValidationOptions): Promise<AgentAction>;
+export declare function formatActionForHistory(action: AgentAction, iteration: number): string;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +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,CAqBrF"}

package/dist/agent/actions.js

@@ -0,0 +1,32 @@
+import { validateAction } from "../security/action-validator.js";
+import { validateUrl } from "../security/url-validator.js";
+export async function parseAndValidateAction(raw, urlOptions) {
+    const action = validateAction(raw);
+    if (action.type === "goto") {
+        await validateUrl(action.url, urlOptions);
+    }
+    return action;
+}
+export function formatActionForHistory(action, iteration) {
+    switch (action.type) {
+        case "click":
+            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}${action.amount ? ` ${action.amount}px` : ""}`;
+        case "done":
+            return `[${iteration}] done: ${action.result}`;
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/agent/actions.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,26 @@
+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;
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,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;IA6B5B,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;IA2LpD,OAAO,CAAC,WAAW;IAkBb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,OAAO,CAAC,iBAAiB;CAe1B"}

package/dist/agent/agent.js

@@ -0,0 +1,279 @@
+import { EventEmitter } from "node:events";
+import { gotScraping } from "got-scraping";
+import { launchStealthBrowser, STEALTH_INIT_SCRIPT, CHROME_UA } from "../browser/stealth.js";
+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";
+import { RunLogger } from "./logger.js";
+export class Auspex extends EventEmitter {
+    config;
+    browser = null;
+    browserPromise = null;
+    pool;
+    constructor(config, pool) {
+        super();
+        this.config = agentConfigSchema.parse(config);
+        this.pool = pool ?? null;
+    }
+    // ── Type-safe event emitter methods ────────────────────────────────────────
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    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 = this.config.proxy
+                    ? {
+                        proxy: {
+                            server: this.config.proxy.server,
+                            username: this.config.proxy.username,
+                            password: this.config.proxy.password,
+                        },
+                    }
+                    : {};
+                const browser = await launchStealthBrowser(launchOptions);
+                this.browser = browser;
+                this.browserPromise = null;
+                return browser;
+            })();
+        }
+        return this.browserPromise;
+    }
+    releaseBrowser(browser) {
+        if (this.pool)
+            this.pool.release(browser);
+        // Singleton mode: keep browser alive — no release needed
+    }
+    async run(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: effectiveConfig.allowedDomains,
+            blockedDomains: effectiveConfig.blockedDomains,
+        });
+        // ── 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,
+                method: "GET",
+                headerGeneratorOptions: {
+                    browsers: [{ name: "chrome", minVersion: 120 }],
+                    operatingSystems: ["macos", "windows"],
+                    devices: ["desktop"],
+                    locales: ["pt-BR", "pt", "en-US"],
+                },
+                timeout: { request: Math.min(effectiveConfig.timeoutMs, 10_000) },
+                followRedirect: true,
+                maxRedirects: 10,
+                throwHttpErrors: false,
+                decompress: true,
+            });
+            const html = response.body;
+            const status = response.statusCode;
+            if (html && status < 400) {
+                const snapshot = snapshotFromHtml(html, validUrl);
+                if (snapshot.text.length > 200) {
+                    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 failed (timeout, SSL, network) → go to Playwright
+        }
+        // ── 2. Playwright (fallback) ─────────────────────────────────────────────
+        logger?.logTier("playwright");
+        this.emit("tier", "playwright");
+        const browser = await this.acquireBrowser();
+        let page = null;
+        try {
+            const contextOptions = {
+                userAgent: CHROME_UA,
+                viewport: { width: 1920, height: 1080 },
+                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,
+                })));
+            }
+            // Apply comprehensive stealth patches (second layer on top of playwright-extra stealth plugin)
+            await context.addInitScript(STEALTH_INIT_SCRIPT);
+            page = await context.newPage();
+            const gotoTimeout = effectiveConfig.gotoTimeoutMs ?? 15_000;
+            await page.goto(validUrl, { waitUntil: "domcontentloaded", timeout: gotoTimeout });
+            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);
+            const result = {
+                status: "error",
+                tier: "playwright",
+                data: null,
+                report: "",
+                durationMs: 0,
+                actions: [],
+                usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0, calls: 0 },
+                memory: { browserPeakRssKb: 0, nodeHeapUsedMb: 0 },
+                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 {
+            if (page) {
+                const context = page.context();
+                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

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

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

@@ -0,0 +1,21 @@
+import type { Page } from "playwright-core";
+import type { AgentResult, LLMUsage, PageSnapshot, AgentAction } from "../types.js";
+import type { ValidatedConfig } from "../config/schema.js";
+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

@@ -0,0 +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,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"}