crawlix 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 M.Taqi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+# 👾 Crawlix
+
+> Claw through bugs before your users do.
+
+Crawlix is an open-source autonomous QA agent that spawns AI-powered user personas and unleashes them on your product. Each persona navigates independently, makes real decisions, hits dead ends, and finds bugs - without you writing a single test script.
+
+---
+
+## How it works
+
+Crawlix spawns multiple AI agents simultaneously. Each one opens your app in a real browser, reads the UI, and navigates toward the goal exactly as that type of user would behave - including their mistakes, impatience, and confusion. When they find something broken, confusing, or unexpected - they report it.
+
+```
+  👾 Crawlix - Claw through bugs before your users do.
+
+  target   → http://localhost:3000/
+  goal     → Check the landing page is everything working fine
+  agents   → First-Timer, Impatient, Power User, Adversarial, Non-Native Speaker, Slow Network
+
+  ✓ First-Timer       2 critical · 3 warnings   18 steps · 12.3s
+  ~ Impatient         1 warning                  6 steps  · 4.1s
+  ✓ Power User        no findings                22 steps · 15.7s
+  ✗ Adversarial       3 critical                 14 steps · 9.2s
+  ~ Non-Native        106 warnings · 1 info      10 steps · 27.5s
+  ~ Slow Network      no findings                4 steps  · 27.7s
+
+  ╭──────────────────────────────────────╮
+  │ 👾 Crawlix - run complete               │
+  │                                      │
+  │   1 critical  106 warnings  1 info   │
+  │                                      │
+  │   0 passed  0 stuck  6 incomplete    │
+  │                                      │
+  │   total time → 539.8s                │
+  ╰──────────────────────────────────────╯
+```
+
+No test scripts. No selectors. No maintenance.
+
+---
+
+## Install
+
+```bash
+npm install -g crawlix
+```
+
+---
+
+## Setup
+
+Run once. Crawlix asks for your LLM provider and API key - remembers it forever.
+
+```bash
+crawlix setup
+```
+
+Supported providers:
+
+- Groq
+- Gemini
+- Cerebras
+- Mistral
+- OpenRouter
+- Ollama
+- OpenAI
+- Anthropic
+
+Config is saved to `~/.crawlix/crawlix.config.json`.
+
+---
+
+## Usage
+
+```bash
+# run all agents against your app
+crawlix run --url https://myapp.com --goal "complete the signup flow"
+
+# run specific agents only
+crawlix run --url https://myapp.com --goal "login" --agent first-timer,adversarial
+
+# run headed - watch agents navigate in real browser
+crawlix run --url https://myapp.com --goal "checkout" --headed
+
+# control steps and concurrency
+crawlix run --url https://myapp.com --goal "find pricing" --steps 15 --concurrency 1
+
+# list all available agents
+crawlix agents
+```
+
+---
+
+## Built-in agents
+
+| Agent | Behavior |
+|---|---|
+| `first-timer` | Never seen this app. Reads nothing. Clicks whatever looks obvious. |
+| `impatient` | Skips everything. Rage-clicks. Abandons if stuck for more than 2 steps. |
+| `power-user` | Tries every edge case, advanced flow, and keyboard shortcut. |
+| `adversarial` | SQL injection, XSS attempts, wrong inputs, broken sequences. |
+| `non-native` | Misreads labels, confused by idioms. Tests copy clarity ruthlessly. |
+| `slow-network` | Throttled connection. Finds missing loading states and timeouts. |
+
+---
+
+## Custom agents
+
+Drop a JSON file into `.crawlix/agents/` in your project root:
+
+```json
+{
+  "name": "doctor",
+  "description": "Medical professional, time-pressured, technically literate",
+  "systemPrompt": "You are a busy doctor with 2 minutes between patients. You know what you want, you don't read instructions, and you get frustrated fast if the UI isn't obvious.",
+  "patience": 4,
+  "aggression": 3,
+  "readingBehavior": "skim"
+}
+```
+
+Crawlix picks it up automatically on the next run. No code, no imports, no build step.
+
+Run a specific custom agent:
+
+```bash
+crawlix run --url https://myapp.com --goal "book an appointment" --agent doctor
+```
+
+---
+
+## Findings
+
+Crawlix reports three severity levels:
+
+| Severity | Meaning |
+|---|---|
+| `critical` | Broken element, crash, security issue, complete blocker |
+| `warning` | Confusing flow, missing feedback, slow response, unclear copy |
+| `info` | Minor friction, accessibility gap, copy improvement |
+
+---
+
+## Why no test scripts?
+
+Traditional QA tools require you to write and maintain selectors, flows, and assertions. They break when your UI changes. They only test paths you already thought of.
+
+Crawlix doesn't know your app. That's the point. It finds the paths you didn't think of - the ones your real users will find on their own.
+
+---
+
+## Contributing
+
+Contributions are welcome - bug fixes, new agents, adapter improvements, or anything that makes it better.
+
+### Getting started
+
+```bash
+git clone https://github.com/m-taqii/crawlix
+cd crawlix
+pnpm install
+pnpm tsx src/cli/index.ts run --url https://example.com --goal "find the more information link"
+```
+
+### Ways to contribute
+
+- **Add a built-in agent** - add a persona to `src/personas/index.ts` and open a PR
+- **Fix a bug** - open an issue first, then a PR with the fix
+- **Improve element resolution** - `src/adapters/web.ts` `resolve()` method always needs work
+- **Add an adapter** - API testing, mobile, desktop - see `src/adapters/base.ts` for the interface
+- **Improve the report** - `src/core/reporter.ts` - better prompts, better structure
+
+### Before opening a PR
+
+- Run `pnpm exec tsc --noEmit` - must be clean
+- Test against a real URL
+- Keep it focused - one thing per PR
+
+### Found a bug?
+
+Open an issue with the URL you were testing, the goal you gave, and the error output.
+
+---
+
+## License
+
+MIT - see [LICENSE](LICENSE)

package/dist/adapters/base.d.ts

@@ -0,0 +1,8 @@
+import type { Action, ActionResult, PageState } from "../types/index.js";
+export interface Adapter {
+    open(url: string): Promise<void>;
+    getState(): Promise<PageState>;
+    execute(action: Action): Promise<ActionResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAExE,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;IAC9B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/adapters/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":""}

package/dist/adapters/web.d.ts

@@ -0,0 +1,14 @@
+import type { Adapter } from "./base.js";
+import type { ActionResult, Action, PageState } from "../types/index.js";
+import type { Page } from "playwright";
+export declare class WebAdapter implements Adapter {
+    private page;
+    private extractor;
+    constructor(page: Page);
+    open(url: string): Promise<void>;
+    getState(): Promise<PageState>;
+    private resolve;
+    execute(action: Action): Promise<ActionResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/adapters/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/adapters/web.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,qBAAa,UAAW,YAAW,OAAO;IACtC,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,SAAS,CAAW;gBAEhB,IAAI,EAAE,IAAI;IAKhB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;YAItB,OAAO;IA8Bf,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiF9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/adapters/web.js

@@ -0,0 +1,120 @@
+import { Extractor } from "../core/extractor.js";
+export class WebAdapter {
+    page;
+    extractor;
+    constructor(page) {
+        this.page = page;
+        this.extractor = new Extractor();
+    }
+    async open(url) {
+        await this.page.goto(url, { waitUntil: 'domcontentloaded' });
+    }
+    async getState() {
+        return this.extractor.extract(this.page);
+    }
+    async resolve(target) {
+        const cleaned = target
+            .replace(/^\w+:\s*/, '') // remove 'link: ' or 'button: ' prefix
+            .replace(/^"|"$/g, '') // remove surrounding quotes
+            .trim();
+        const strategies = [
+            () => this.page.getByRole('button', { name: cleaned, exact: false }).first(),
+            () => this.page.getByRole('link', { name: cleaned, exact: false }).first(),
+            () => this.page.getByRole('textbox', { name: cleaned, exact: false }).first(),
+            () => this.page.getByRole('combobox', { name: cleaned, exact: false }).first(),
+            () => this.page.getByRole('checkbox', { name: cleaned, exact: false }).first(),
+            () => this.page.getByLabel(cleaned, { exact: false }).first(),
+            () => this.page.getByPlaceholder(cleaned, { exact: false }).first(),
+            () => this.page.getByText(cleaned, { exact: false }).first(),
+        ];
+        for (const strategy of strategies) {
+            try {
+                const el = strategy();
+                if (await el.isVisible().catch(() => false)) {
+                    return el;
+                }
+            }
+            catch {
+            }
+        }
+        return null;
+    }
+    async execute(action) {
+        try {
+            switch (action.type) {
+                case 'click': {
+                    // find element by description, click it
+                    const el = await this.resolve(action.target);
+                    if (!el)
+                        return { success: false, error: `Element not found: "${action.target}"` };
+                    await el.click({ timeout: 5000 });
+                    // wait for page to settle after click
+                    await this.page.waitForLoadState('domcontentloaded', { timeout: 5000 }).catch(() => { });
+                    break;
+                }
+                case 'type': {
+                    // find input, fill it with value
+                    const el = await this.resolve(action.target);
+                    if (!el)
+                        return { success: false, error: `Element not found: "${action.target}"` };
+                    await el.fill(action.value ?? '');
+                    break;
+                }
+                case 'scroll': {
+                    // scroll direction comes in action.value: up/down/left/right
+                    const directions = {
+                        up: [0, -500],
+                        down: [0, 500],
+                        left: [-500, 0],
+                        right: [500, 0],
+                    };
+                    const [x, y] = directions[action.value ?? 'down'] ?? [0, 500];
+                    await this.page.mouse.wheel(x, y);
+                    break;
+                }
+                case 'select': {
+                    // dropdown selection
+                    const el = await this.resolve(action.target);
+                    if (!el)
+                        return { success: false, error: `Element not found: "${action.target}"` };
+                    await el.selectOption(action.value ?? '');
+                    break;
+                }
+                case 'hover': {
+                    const el = await this.resolve(action.target);
+                    if (!el)
+                        return { success: false, error: `Element not found: "${action.target}"` };
+                    await el.hover();
+                    break;
+                }
+                case 'press': {
+                    // keyboard key press - Enter, Tab, Escape, ArrowDown etc
+                    await this.page.keyboard.press(action.value ?? 'Enter');
+                    break;
+                }
+                case 'open': {
+                    await this.page.goto(action.value ?? '', { waitUntil: 'domcontentloaded', timeout: 15000 });
+                    break;
+                }
+                case 'wait': {
+                    await this.page.waitForLoadState('networkidle', { timeout: 10000 }).catch(() => { });
+                    break;
+                }
+                case 'done':
+                case 'stuck':
+                    break;
+            }
+            return { success: true };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err)
+            };
+        }
+    }
+    async close() {
+        await this.page.close();
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/adapters/web.js.map

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

package/dist/cli/commands/agents.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const agentsCommand: Command;
+//# sourceMappingURL=agents.d.ts.map

package/dist/cli/commands/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,eAAO,MAAM,aAAa,SAKpB,CAAA"}

package/dist/cli/commands/agents.js

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+import { listPersonas } from '../../personas/loader.js';
+export const agentsCommand = new Command('agents')
+    .description('List available agents')
+    .option('--list', 'Show all available agents')
+    .action(async () => {
+    await listPersonas();
+});
+//# sourceMappingURL=agents.js.map

package/dist/cli/commands/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/cli/commands/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC7C,WAAW,CAAC,uBAAuB,CAAC;KACpC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;KAC7C,MAAM,CAAC,KAAK,IAAI,EAAE;IACf,MAAM,YAAY,EAAE,CAAA;AACxB,CAAC,CAAC,CAAA"}

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const runCommand: Command;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,eAAO,MAAM,UAAU,SA2CjB,CAAA"}

package/dist/cli/commands/run.js

@@ -0,0 +1,49 @@
+import { Command } from 'commander';
+import ora from 'ora';
+import chalk from 'chalk';
+import { Orchestrator } from '../../core/orchestrator.js';
+import { LLM } from '../../llm/index.js';
+import { loadPersonas } from '../../personas/loader.js';
+import { getConfig } from '../../lib/getConfigs.js';
+import { agentDone, agentStarted, printFinding, printHeader, printSummary } from '../../lib/display.js';
+import { generateReport, saveReport } from "../../core/reporter.js";
+export const runCommand = new Command('run')
+    .description('Run AI agents against your app')
+    .requiredOption('--url <url>', 'URL to test')
+    .requiredOption('--goal <goal>', 'What to achieve')
+    .option('--agent <agents>', 'Specific agent(s) to run, comma separated')
+    .option('--steps <number>', 'Max steps per agent', '25')
+    .option('--concurrency <number>', 'Agents running in parallel', '2')
+    .option('--headed', 'Run browser in headed mode')
+    .option('--round-robin', 'Spread load across multiple providers to avoid rate limiting')
+    .action(async (options) => {
+    const config = getConfig();
+    if (options.roundRobin && !config.roundRobin?.length) {
+        console.warn(chalk.yellow('  ⚠ --round-robin flag used but no round robin providers configured. Run crawlix setup to add them.'));
+    }
+    const llm = new LLM(config.primary, config.fallback, options.roundRobin ? config.roundRobin : undefined);
+    const { url, goal, agent, steps, concurrency, headed } = options;
+    const personas = await loadPersonas(agent);
+    printHeader(url, goal, personas.map(p => p.name));
+    const orchestrator = new Orchestrator({
+        url,
+        goal,
+        llm,
+        personas,
+        maxSteps: parseInt(steps),
+        concurrency: parseInt(concurrency),
+        headless: !headed,
+        onAgentStart: (name) => agentStarted(name),
+        onAgentDone: (result) => {
+            agentDone(result);
+            result.findings.forEach(f => printFinding(f, result.persona));
+        }
+    });
+    const results = await orchestrator.run();
+    printSummary(results);
+    const reportSpinner = ora({ text: chalk.gray('generating report...'), spinner: 'dots' }).start();
+    const { title, report } = await generateReport(results, url, goal, llm);
+    const filepath = saveReport(title, report);
+    reportSpinner.stopAndPersist({ symbol: '📋', text: chalk.gray('report saved → ') + chalk.white(filepath) });
+});
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

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

package/dist/cli/commands/setup.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const setupCommand: Command;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA0DnC,eAAO,MAAM,YAAY,SAoDnB,CAAA"}

package/dist/cli/commands/setup.js

@@ -0,0 +1,93 @@
+import { Command } from 'commander';
+import { select, input, password, confirm } from '@inquirer/prompts';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+const DEFAULT_MODELS = {
+    groq: 'llama-3.3-70b-versatile',
+    openai: 'gpt-4o-mini',
+    gemini: 'gemini-2.5-flash',
+    anthropic: 'claude-haiku-4-5-20251001',
+    openrouter: 'meta-llama/llama-3.3-70b-instruct:free',
+    ollama: 'llama3.2',
+    cerebras: 'gpt-oss-120b',
+    mistral: 'mistral-medium-3-5',
+};
+async function setupProvider(label) {
+    const provider = await select({
+        message: `Select ${label} provider`,
+        choices: [
+            { name: 'Groq', value: 'groq' },
+            { name: 'Gemini', value: 'gemini' },
+            { name: 'Cerebras', value: 'cerebras' },
+            { name: 'Mistral', value: 'mistral' },
+            { name: 'OpenRouter', value: 'openrouter' },
+            { name: 'Ollama', value: 'ollama' },
+            { name: 'OpenAI', value: 'openai' },
+            { name: 'Anthropic', value: 'anthropic' },
+        ]
+    });
+    let apiKey;
+    if (provider === 'ollama') {
+        console.log('  ✓ Ollama runs locally — no API key needed');
+    }
+    else {
+        apiKey = await password({
+            message: `Enter your ${provider} API key:`,
+            validate: v => v.trim().length > 0 ? true : 'API key cannot be empty'
+        });
+    }
+    const defaultModel = DEFAULT_MODELS[provider];
+    const customModel = await input({
+        message: `Model to use (press enter for default: ${defaultModel}):`,
+    });
+    const config = {
+        provider,
+        ...(apiKey && { apiKey }),
+        ...(customModel.trim().length > 0 && { model: customModel.trim() }),
+    };
+    return config;
+}
+export const setupCommand = new Command('setup')
+    .description('Configure your LLM provider')
+    .action(async () => {
+    console.log('\n  👾 crawlix setup\n');
+    const primary = await setupProvider('primary');
+    const wantsFallback = await confirm({
+        message: 'Add a fallback provider?',
+        default: false,
+    });
+    let fallback;
+    if (wantsFallback) {
+        fallback = await setupProvider('fallback');
+    }
+    // after fallback setup
+    const wantsRoundRobin = await confirm({
+        message: 'Add round robin providers to spread load across multiple providers?',
+        default: false,
+    });
+    const roundRobin = [];
+    if (wantsRoundRobin) {
+        console.log('\n  Add providers one by one. Press N when done.\n');
+        let addMore = true;
+        while (addMore) {
+            const provider = await setupProvider(`round robin #${roundRobin.length + 1}`);
+            roundRobin.push(provider);
+            addMore = await confirm({ message: 'Add another provider?', default: false });
+        }
+    }
+    // build config
+    const crawlixConfig = {
+        primary,
+        ...(fallback && { fallback }),
+        ...(roundRobin.length > 0 && { roundRobin }),
+    };
+    // save to ~/.crawlix/crawlix.config.json
+    const configDir = path.join(os.homedir(), '.crawlix');
+    const configPath = path.join(configDir, 'crawlix.config.json');
+    fs.mkdirSync(configDir, { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(crawlixConfig, null, 2));
+    console.log('\n  ✓ Config saved to', configPath);
+    console.log('  Run crawlix run --url <url> --goal "<goal>" to start testing\n');
+});
+//# sourceMappingURL=setup.js.map

package/dist/cli/commands/setup.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import { runCommand } from './commands/run.js';
+import { setupCommand } from './commands/setup.js';
+import { agentsCommand } from './commands/agents.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+const program = new Command();
+program
+    .name('crawlix')
+    .description('👾 Crawlix: Claw through bugs before your users do.')
+    .version(pkg.version);
+program.addCommand(runCommand);
+program.addCommand(setupCommand);
+program.addCommand(agentsCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAA;AAChE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACF,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAEzB,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAC9B,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;AAChC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;AAEjC,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/core/director.d.ts

@@ -0,0 +1,14 @@
+import type { Action, HistoryEntry, PageState, PersonaConfig } from "../types/index.js";
+import { LLM } from "../llm/index.js";
+export declare class Director {
+    private persona;
+    private llm;
+    private goal;
+    constructor(persona: PersonaConfig, llm: LLM, goal: string);
+    get personaName(): string;
+    private buildSystemPrompt;
+    private buildUserMessage;
+    private parseAction;
+    decide(pageState: PageState, history: HistoryEntry[]): Promise<Action>;
+}
+//# sourceMappingURL=director.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"director.d.ts","sourceRoot":"","sources":["../../src/core/director.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAY,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,qBAAa,QAAQ;IACjB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,IAAI,CAAS;gBAGT,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM;IAM1D,IAAI,WAAW,IAAI,MAAM,CAExB;IAGD,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,WAAW;IA0BN,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAStF"}