crawlix 0.1.0

package/dist/core/director.js

@@ -0,0 +1,112 @@
+import { LLM } from "../llm/index.js";
+export class Director {
+    persona;
+    llm;
+    goal;
+    constructor(persona, llm, goal) {
+        this.persona = persona;
+        this.llm = llm;
+        this.goal = goal;
+    }
+    get personaName() {
+        return this.persona.name;
+    }
+    // build system prompt
+    buildSystemPrompt() {
+        return `You are an autonomous QA agent embodying the following user persona.
+
+PERSONA: ${this.persona.name}
+DESCRIPTION: ${this.persona.description}
+GOAL: ${this.goal}
+
+BEHAVIOR:
+${this.persona.systemPrompt}
+
+BEHAVIORAL MODIFIERS:
+- Patience level: ${this.persona.patience}/10 — ${this.persona.patience <= 3 ? 'give up quickly if stuck' : this.persona.patience >= 8 ? 'persist through difficulties' : 'try a few times before giving up'}
+- Aggression level: ${this.persona.aggression}/10 — ${this.persona.aggression >= 8 ? 'actively try to break things' : this.persona.aggression <= 2 ? 'interact gently and carefully' : 'interact normally'}
+- Reading behavior: ${this.persona.readingBehavior === 'thorough' ? 'read everything on the page before acting' : this.persona.readingBehavior === 'skim' ? 'skim text quickly, catch main points only' : 'skip all text, act on visual cues only'}
+
+RESPONSE RULES:
+"target": "use ONLY the visible label text of the element, nothing else. 
+Not the index number, not the role. Just the text. 
+Example: 'Sign Up' not '[01] button Sign Up'"
+You must always respond with valid JSON only. No explanation outside JSON.
+
+{
+  "type": "open" | "click" | "type" | "scroll" | "select" | "hover" | "press" | "wait" | "done" | "stuck",
+  "target": "element description",
+  "value": "text to type / key to press / scroll direction / url to open",
+  "reasoning": "one sentence why",
+  "finding": {
+    "severity": "critical" | "warning" | "info",
+    "description": "what you observed",
+    "element": "which element"
+  }
+}
+
+Set "finding" to null if nothing notable this step.
+Set "type" to "done" only when goal is fully complete.
+Set "type" to "stuck" only after ${this.persona.patience <= 3 ? '2' : this.persona.patience <= 6 ? '3' : '4'} failed attempts on the same step.`;
+    }
+    // build user message with history and page Elementa
+    buildUserMessage(pageState, history) {
+        const header = [
+            pageState.url ? `Current URL: ${pageState.url}` : null,
+            pageState.title ? `Current Title: ${pageState.title}` : null,
+        ].filter(Boolean).join('\n');
+        // build history text to pass to the LLM in user message
+        const historyText = history.length === 0
+            ? 'No actions yet — this is your first step.'
+            : history.slice(-10).map(e => `[${String(e.step).padStart(2, '0')}] ${e.action.type.toUpperCase().padEnd(8)} ` +
+                `${e.action.target ?? '—'} ` +
+                `${e.action.value ? `"${e.action.value}"` : ''} ` +
+                `→ ${e.action.reasoning}` +
+                (e.action.finding ? ` ⚠ ${e.action.finding.severity.toUpperCase()}: ${e.action.finding.description}` : '')).join('\n');
+        return [
+            header,
+            '',
+            '── PAGE ELEMENTS ──────────────────────────',
+            pageState.tree,
+            '',
+            '── HISTORY ────────────────────────────────',
+            historyText,
+            '',
+            'What is your next action?',
+        ].join('\n');
+    }
+    // parse LLM response for next action
+    parseAction(raw) {
+        const cleaned = raw
+            .replace(/^```(?:json)?\n?/m, '')
+            .replace(/\n?```$/m, '')
+            .trim();
+        let parsed;
+        try {
+            parsed = JSON.parse(cleaned);
+        }
+        catch {
+            throw new Error(`Crawlix: received non-JSON response:\n${raw}`);
+        }
+        if (Array.isArray(parsed)) {
+            parsed = parsed[0];
+        }
+        if (!parsed['type'] || typeof parsed['type'] !== 'string') {
+            throw new Error(`Crawlix: missing "type" in response:\n${raw}`);
+        }
+        if (!parsed['reasoning'] || typeof parsed['reasoning'] !== 'string') {
+            throw new Error(`Crawlix: missing "reasoning" in response:\n${raw}`);
+        }
+        return parsed;
+    }
+    // call LLM for Next Action
+    async decide(pageState, history) {
+        const input = {
+            system: this.buildSystemPrompt(),
+            messages: [{ role: 'user', content: this.buildUserMessage(pageState, history) }]
+        };
+        const response = await this.llm.complete(input);
+        return this.parseAction(response.content);
+    }
+}
+//# sourceMappingURL=director.js.map

package/dist/core/director.js.map

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

package/dist/core/extractor.d.ts

@@ -0,0 +1,6 @@
+import type { Page } from 'playwright';
+import type { PageState } from '../types/index.js';
+export declare class Extractor {
+    extract(page: Page): Promise<PageState>;
+}
+//# sourceMappingURL=extractor.d.ts.map

package/dist/core/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/core/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,qBAAa,SAAS;IACd,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;CA6C9C"}

package/dist/core/extractor.js

@@ -0,0 +1,42 @@
+export class Extractor {
+    async extract(page) {
+        const url = page.url();
+        const title = await page.title().catch(() => undefined);
+        // runs inside the browser - queries DOM directly
+        const tree = await page.evaluate(() => {
+            const selector = [
+                'button', 'a[href]', 'input', 'select', 'textarea',
+                '[role="button"]', '[role="link"]', '[role="tab"]',
+                '[role="menuitem"]', '[role="checkbox"]', '[role="radio"]',
+                '[tabindex]:not([tabindex="-1"])',
+            ].join(', ');
+            return Array.from(document.querySelectorAll(selector))
+                .filter(el => {
+                // visible only
+                const rect = el.getBoundingClientRect();
+                return rect.width > 0 && rect.height > 0;
+            })
+                .slice(0, 60) // cap at 60
+                .map((el, i) => {
+                const tag = el.tagName.toLowerCase();
+                const role = el.getAttribute('role') ?? (tag === 'a' ? 'link' : tag === 'button' ? 'button' : tag);
+                const label = (el.getAttribute('aria-label') ??
+                    el.getAttribute('placeholder') ??
+                    el.getAttribute('title') ??
+                    el.textContent?.trim().slice(0, 60) ??
+                    '').trim();
+                const type = el.getAttribute('type') ?? '';
+                const name = el.getAttribute('name') ?? '';
+                return `[${String(i + 1).padStart(2, '0')}] ${role}: "${label}"${type ? ` (${type})` : ''}${name ? ` name="${name}"` : ''}`;
+            })
+                .join('\n');
+        });
+        return {
+            url,
+            title,
+            tree: tree || '(no interactive elements found)',
+            timestamp: Date.now(),
+        };
+    }
+}
+//# sourceMappingURL=extractor.js.map

package/dist/core/extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../src/core/extractor.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACpB,KAAK,CAAC,OAAO,CAAC,IAAU;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAEvD,iDAAiD;QACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YACpC,MAAM,QAAQ,GAAG;gBACf,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU;gBAClD,iBAAiB,EAAE,eAAe,EAAE,cAAc;gBAClD,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB;gBAC1D,iCAAiC;aAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAEZ,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;iBACnD,MAAM,CAAC,EAAE,CAAC,EAAE;gBACX,eAAe;gBACf,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAA;gBACvC,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;YAC1C,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAE,YAAY;iBAC1B,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;gBACb,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;gBACpC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;gBAClG,MAAM,KAAK,GAAG,CACZ,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC;oBAC7B,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC;oBAC9B,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;oBACxB,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;oBACnC,EAAE,CACH,CAAC,IAAI,EAAE,CAAA;gBACR,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;gBAC1C,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;gBAE1C,OAAO,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;YAC7H,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAA;QACf,CAAC,CAAC,CAAA;QAEF,OAAO;YACL,GAAG;YACH,KAAK;YACL,IAAI,EAAE,IAAI,IAAI,iCAAiC;YAC/C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAA;IACH,CAAC;CACF"}

package/dist/core/orchestrator.d.ts

@@ -0,0 +1,27 @@
+import type { LLM } from "../llm/index.js";
+import type { PersonaConfig, RunResult } from "../types/index.js";
+export interface OrchestratorConfig {
+    url: string;
+    goal: string;
+    llm: LLM;
+    personas: PersonaConfig[];
+    maxSteps?: number;
+    concurrency?: number;
+    headless?: boolean;
+    onAgentStart?: (personaName: string) => void;
+    onAgentDone?: (result: RunResult) => void;
+}
+export declare class Orchestrator {
+    private url;
+    private goal;
+    private llm;
+    private personas;
+    private maxSteps;
+    private concurrency;
+    private headless;
+    private onAgentStart?;
+    private onAgentDone?;
+    constructor(config: OrchestratorConfig);
+    run(): Promise<RunResult[]>;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/core/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,GAAG,CAAA;IACR,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAA;CAC5C;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,YAAY,CAAC,CAA8C;IACnE,OAAO,CAAC,WAAW,CAAC,CAA4C;gBAEpD,MAAM,EAAE,kBAAkB;IAYhC,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CAwCpC"}

package/dist/core/orchestrator.js

@@ -0,0 +1,62 @@
+import { getBrowser, closeBrowser } from "../lib/browser.js";
+import { Director } from "./director.js";
+import { Runner } from "./runner.js";
+import { WebAdapter } from "../adapters/web.js";
+export class Orchestrator {
+    url;
+    goal;
+    llm;
+    personas;
+    maxSteps;
+    concurrency;
+    headless;
+    onAgentStart;
+    onAgentDone;
+    constructor(config) {
+        this.url = config.url;
+        this.goal = config.goal;
+        this.llm = config.llm;
+        this.personas = config.personas;
+        this.maxSteps = config.maxSteps || 10;
+        this.concurrency = config.concurrency || 2;
+        this.headless = config.headless ?? true;
+        this.onAgentStart = config.onAgentStart;
+        this.onAgentDone = config.onAgentDone;
+    }
+    async run() {
+        const browser = await getBrowser(this.headless);
+        const allResults = [];
+        try {
+            for (let i = 0; i < this.personas.length; i += this.concurrency) {
+                const batch = this.personas.slice(i, i + this.concurrency);
+                const results = await Promise.all(batch.map(async (persona) => {
+                    this.onAgentStart?.(persona.name);
+                    const context = await browser.newContext();
+                    const page = await context.newPage();
+                    try {
+                        const adapter = new WebAdapter(page);
+                        const director = new Director(persona, this.llm, this.goal);
+                        const runner = new Runner(adapter, director, this.url, this.goal, this.maxSteps);
+                        const result = await runner.run();
+                        this.onAgentDone?.(result);
+                        return result;
+                    }
+                    finally {
+                        await page.close();
+                        await context.close();
+                    }
+                }));
+                allResults.push(...results);
+            }
+            return allResults;
+        }
+        catch (err) {
+            console.error(`Error during orchestration: ${err}`);
+            return [];
+        }
+        finally {
+            await closeBrowser();
+        }
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/core/orchestrator.js.map

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

package/dist/core/reporter.d.ts

@@ -0,0 +1,8 @@
+import type { RunResult } from '../types/index.js';
+import { LLM } from '../llm/index.js';
+export declare function generateReport(results: RunResult[], url: string, goal: string, llm: LLM): Promise<{
+    title: string;
+    report: string;
+}>;
+export declare function saveReport(title: string, content: string): string;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/core/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/core/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AA+GrC,wBAAsB,cAAc,CAChC,OAAO,EAAE,SAAS,EAAE,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,GAAG,GACT,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAa5C;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAajE"}

package/dist/core/reporter.js

@@ -0,0 +1,132 @@
+import { LLM } from '../llm/index.js';
+import fs from 'fs';
+import path from 'path';
+const REPORT_SYSTEM_PROMPT = `You are a senior QA analyst reviewing results from an autonomous AI testing session.
+
+Your job is to turn raw test findings into a clear, actionable markdown report that a developer can read and immediately understand what to fix.
+
+REPORT STRUCTURE — follow this exactly:
+
+# Crawlix Report
+
+## Overview
+- URL tested
+- Goal
+- Agents run
+- Total findings
+- Time taken
+
+## Critical Issues
+List every critical finding. For each one:
+- What broke
+- Which agent found it
+- Why it matters
+- Suggested fix
+
+## Warnings
+Group similar warnings together. For each group:
+- What the pattern is
+- How many agents hit it
+- Suggested fix
+
+## Patterns
+Findings that multiple agents experienced — these are the most important UX problems because real users of different types all hit them.
+
+## Agent Performance
+One line per agent — goal reached, steps taken, findings count, notable observations.
+
+## Recommendations
+Top 3-5 things to fix first, ordered by impact.
+
+---
+
+RULES:
+- Be specific — name the element, describe the exact problem
+- Be actionable — every finding should have a suggested fix
+- Be concise — no filler, no generic advice
+- Use proper markdown — headers, bullet points, code blocks where relevant
+- If no critical issues found — say so clearly
+- Write for a developer who will act on this immediately
+
+RESPONSE RULES:
+You must always respond with valid JSON only. No explanation outside JSON.
+
+{
+  "title": "Short report title for report filename",
+  "report": "Complete markdown report content following the structure and rules above",
+  }
+}`;
+// formats all results into structured text for the LLM
+function buildReportPrompt(results, url, goal) {
+    const totalFindings = results.flatMap(r => r.findings).length;
+    const totalDuration = results.reduce((acc, r) => acc + r.duration, 0);
+    // summary context as first message
+    const summary = {
+        role: 'user',
+        content: [
+            `URL: ${url}`,
+            `Goal: ${goal}`,
+            `Agents run: ${results.length}`,
+            `Total findings: ${totalFindings}`,
+            `Total duration: ${(totalDuration / 1000).toFixed(1)}s`,
+        ].join('\n')
+    };
+    // one message per agent
+    const agentMessages = results.map(result => {
+        const findingsText = result.findings.length === 0
+            ? 'No findings.'
+            : result.findings
+                .map(f => `- [${f.severity}] ${f.description}${f.element ? ` — element: ${f.element}` : ''}`)
+                .join('\n');
+        return {
+            role: 'user',
+            content: [
+                `Agent: ${result.persona}`,
+                `Goal reached: ${result.goalReached}`,
+                `Stuck: ${result.stuck}`,
+                `Steps taken: ${result.steps}`,
+                `Duration: ${(result.duration / 1000).toFixed(1)}s`,
+                `Findings:\n${findingsText}`,
+            ].join('\n')
+        };
+    });
+    // final instruction
+    const instruction = {
+        role: 'user',
+        content: 'Generate the full QA report based on the above results.'
+    };
+    return {
+        system: REPORT_SYSTEM_PROMPT,
+        messages: [summary, ...agentMessages, instruction]
+    };
+}
+// generates the report using LLM
+export async function generateReport(results, url, goal, llm) {
+    const prompt = buildReportPrompt(results, url, goal);
+    const output = await llm.complete(prompt);
+    const cleaned = output.content
+        .replace(/^```(?:json)?\n?/m, '')
+        .replace(/\n?```$/m, '')
+        .trim();
+    try {
+        const parsed = JSON.parse(cleaned);
+        return parsed;
+    }
+    catch {
+        return { title: 'crawlix-report', report: output.content };
+    }
+}
+// saves report to ./crawlix-reports/
+export function saveReport(title, content) {
+    const reportsDir = path.join(process.cwd(), 'crawlix-reports');
+    if (!fs.existsSync(reportsDir)) {
+        fs.mkdirSync(reportsDir, { recursive: true });
+    }
+    const safeTitle = title.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9\-]/g, '');
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `report-${safeTitle}-${timestamp}.md`;
+    const filepath = path.join(reportsDir, filename);
+    fs.writeFileSync(filepath, content);
+    return filepath;
+}
+//# sourceMappingURL=reporter.js.map

package/dist/core/reporter.js.map

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

package/dist/core/runner.d.ts

@@ -0,0 +1,13 @@
+import type { Adapter } from "../adapters/base.js";
+import type { RunResult } from "../types/index.js";
+import type { Director } from "./director.js";
+export declare class Runner {
+    private adapter;
+    private director;
+    private url;
+    private goal;
+    private maxSteps;
+    constructor(adapter: Adapter, director: Director, url: string, goal: string, maxSteps?: number);
+    run(): Promise<RunResult>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/core/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAK;IAQpF,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;CAuDhC"}

package/dist/core/runner.js

@@ -0,0 +1,61 @@
+export class Runner {
+    adapter;
+    director;
+    url;
+    goal;
+    maxSteps;
+    constructor(adapter, director, url, goal, maxSteps = 25) {
+        this.adapter = adapter;
+        this.director = director;
+        this.url = url;
+        this.goal = goal;
+        this.maxSteps = maxSteps;
+    }
+    async run() {
+        // 1. open the url
+        await this.adapter.open(this.url);
+        const history = [];
+        const findings = [];
+        const startedAt = Date.now();
+        // 2. loop
+        for (let step = 1; step <= this.maxSteps; step++) {
+            // get current state
+            const pageState = await this.adapter.getState();
+            // ask director what to do
+            const action = await this.director.decide(pageState, history);
+            // record finding if any
+            if (action.finding)
+                findings.push({ ...action.finding, step });
+            // stop if done or stuck
+            if (action.type === 'done' || action.type === 'stuck')
+                break;
+            // execute the action
+            const result = await this.adapter.execute(action);
+            // record in history
+            history.push({ step, pageState, action });
+            // if action failed record it
+            if (!result.success) {
+                findings.push({
+                    severity: 'warning',
+                    description: `Action failed: ${result.error}`,
+                    element: action.target ?? undefined,
+                    step,
+                });
+            }
+        }
+        // 3. close and return
+        await this.adapter.close();
+        return {
+            persona: this.director.personaName,
+            url: this.url,
+            goal: this.goal,
+            steps: history.length,
+            findings,
+            goalReached: history.at(-1)?.action.type === 'done',
+            stuck: history.at(-1)?.action.type === 'stuck',
+            duration: Date.now() - startedAt,
+            history,
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/core/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,MAAM;IACT,OAAO,CAAW;IAClB,QAAQ,CAAW;IACnB,GAAG,CAAc;IACjB,IAAI,CAAa;IACjB,QAAQ,CAAS;IAEzB,YAAY,OAAgB,EAAE,QAAkB,EAAE,GAAW,EAAE,IAAY,EAAE,QAAQ,GAAG,EAAE;QACxF,IAAI,CAAC,OAAO,GAAI,OAAO,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,GAAG,GAAQ,GAAG,CAAC;QACpB,IAAI,CAAC,IAAI,GAAO,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG;QACP,kBAAkB;QAClB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEjC,MAAM,OAAO,GAAoB,EAAE,CAAA;QACnC,MAAM,QAAQ,GAAmB,EAAE,CAAA;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,UAAU;QACV,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;YAEjD,oBAAoB;YACpB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;YAE/C,0BAA0B;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAE7D,wBAAwB;YACxB,IAAI,MAAM,CAAC,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YAE9D,wBAAwB;YACxB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;gBAAE,MAAK;YAE5D,qBAAqB;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAEjD,oBAAoB;YACpB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;YAEzC,6BAA6B;YAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAK,SAAS;oBACtB,WAAW,EAAE,kBAAkB,MAAM,CAAC,KAAK,EAAE;oBAC7C,OAAO,EAAM,MAAM,CAAC,MAAM,IAAI,SAAS;oBACvC,IAAI;iBACL,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QAE1B,OAAO;YACL,OAAO,EAAM,IAAI,CAAC,QAAQ,CAAC,WAAW;YACtC,GAAG,EAAU,IAAI,CAAC,GAAG;YACrB,IAAI,EAAS,IAAI,CAAC,IAAI;YACtB,KAAK,EAAQ,OAAO,CAAC,MAAM;YAC3B,QAAQ;YACR,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,KAAK,MAAM;YACnD,KAAK,EAAQ,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,KAAK,OAAO;YACpD,QAAQ,EAAK,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,OAAO;SACR,CAAA;IACH,CAAC;CACF"}

package/dist/lib/browser.d.ts

@@ -0,0 +1,4 @@
+import { type Browser } from "playwright";
+export declare function getBrowser(isheadless?: boolean): Promise<Browser>;
+export declare function closeBrowser(): Promise<void>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/lib/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/lib/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,YAAY,CAAA;AAInD,wBAAsB,UAAU,CAAC,UAAU,GAAE,OAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAc7E;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAKlD"}

package/dist/lib/browser.js

@@ -0,0 +1,24 @@
+import { chromium } from "playwright";
+let browser = null;
+export async function getBrowser(isheadless = true) {
+    if (!browser || !browser.isConnected()) {
+        browser = await chromium.launch({
+            headless: isheadless,
+            timeout: 30_000,
+            args: [
+                "--no-sandbox",
+                "--disable-setuid-sandbox",
+                "--disable-dev-shm-usage",
+                "--disable-gpu",
+            ]
+        });
+    }
+    return browser;
+}
+export async function closeBrowser() {
+    if (browser) {
+        await browser.close();
+        browser = null;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/lib/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/lib/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAA;AAEnD,IAAI,OAAO,GAAmB,IAAI,CAAA;AAElC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,aAAsB,IAAI;IACvD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QACrC,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YAC5B,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE;gBACF,cAAc;gBACd,0BAA0B;gBAC1B,yBAAyB;gBACzB,eAAe;aAClB;SACJ,CAAC,CAAA;IACN,CAAC;IACD,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAC9B,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACrB,OAAO,GAAG,IAAI,CAAA;IAClB,CAAC;AACL,CAAC"}

package/dist/lib/display.d.ts

@@ -0,0 +1,7 @@
+import type { RunResult, Finding } from '../types/index.js';
+export declare function agentStarted(personaName: string): void;
+export declare function agentDone(result: RunResult): void;
+export declare function printFinding(finding: Finding, persona: string): void;
+export declare function printSummary(results: RunResult[]): void;
+export declare function printHeader(url: string, goal: string, personas: string[]): void;
+//# sourceMappingURL=display.d.ts.map

package/dist/lib/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/lib/display.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAI3D,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAMtD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BjD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAWpE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAyBvD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAM/E"}