crawlix 0.1.0

package/dist/lib/display.js

@@ -0,0 +1,80 @@
+import chalk from 'chalk';
+import ora, {} from 'ora';
+import boxen from 'boxen';
+const spinners = new Map();
+export function agentStarted(personaName) {
+    const spinner = ora({
+        text: chalk.gray(`${personaName} — running...`),
+        spinner: 'dots',
+    }).start();
+    spinners.set(personaName, spinner);
+}
+export function agentDone(result) {
+    const spinner = spinners.get(result.persona);
+    if (!spinner)
+        return;
+    const critical = result.findings.filter(f => f.severity === 'critical').length;
+    const warnings = result.findings.filter(f => f.severity === 'warning').length;
+    const info = result.findings.filter(f => f.severity === 'info').length;
+    const duration = (result.duration / 1000).toFixed(1);
+    const findings = result.findings.length === 0
+        ? chalk.green('no findings')
+        : [
+            critical > 0 ? chalk.red(`${critical} critical`) : null,
+            warnings > 0 ? chalk.yellow(`${warnings} warnings`) : null,
+            info > 0 ? chalk.gray(`${info} info`) : null,
+        ].filter(Boolean).join(chalk.gray(' · '));
+    const status = result.goalReached
+        ? chalk.green('✓')
+        : result.stuck
+            ? chalk.red('✗')
+            : chalk.yellow('~');
+    spinner.stopAndPersist({
+        symbol: status,
+        text: `${chalk.white(result.persona.padEnd(16))} ${findings}  ${chalk.gray(`${result.steps} steps · ${duration}s`)}`,
+    });
+    spinners.delete(result.persona);
+}
+export function printFinding(finding, persona) {
+    const icon = finding.severity === 'critical'
+        ? chalk.red('⚠ critical')
+        : finding.severity === 'warning'
+            ? chalk.yellow('⚠ warning')
+            : chalk.gray('ℹ info');
+    console.log(`  ${icon}  ${chalk.gray(`[${persona}]`)} ${finding.description}`);
+    if (finding.element) {
+        console.log(`  ${chalk.gray('element:')} ${finding.element}`);
+    }
+}
+export function printSummary(results) {
+    const allFindings = results.flatMap(r => r.findings);
+    const critical = allFindings.filter(f => f.severity === 'critical').length;
+    const warnings = allFindings.filter(f => f.severity === 'warning').length;
+    const info = allFindings.filter(f => f.severity === 'info').length;
+    const passed = results.filter(r => r.goalReached).length;
+    const stuck = results.filter(r => r.stuck).length;
+    const totalTime = results.reduce((acc, r) => acc + r.duration, 0);
+    const lines = [
+        chalk.bold.white('👾 Crawlix — run complete'),
+        '',
+        `  ${chalk.red(`${critical} critical`)}  ${chalk.yellow(`${warnings} warnings`)}  ${chalk.gray(`${info} info`)}`,
+        '',
+        `  ${chalk.green(`${passed} passed`)}  ${chalk.red(`${stuck} stuck`)}  ${chalk.gray(`${results.length - passed - stuck} incomplete`)}`,
+        '',
+        chalk.gray(`  total time → ${(totalTime / 1000).toFixed(1)}s`),
+    ].join('\n');
+    console.log('\n' + boxen(lines, {
+        padding: 1,
+        borderColor: 'magenta',
+        borderStyle: 'round',
+        dimBorder: false,
+    }));
+}
+export function printHeader(url, goal, personas) {
+    console.log('\n' + chalk.bold.white('  👾 Crawlix - Claw through bugs before your users do.'));
+    console.log(chalk.gray(`  target   → `) + chalk.white(url));
+    console.log(chalk.gray(`  goal     → `) + chalk.white(goal));
+    console.log(chalk.gray(`  agents   → `) + chalk.white(personas.join(', ')));
+    console.log();
+}
+//# sourceMappingURL=display.js.map

package/dist/lib/display.js.map

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

package/dist/lib/getConfigs.d.ts

@@ -0,0 +1,3 @@
+import type { CrawlixConfig } from '../types/index.js';
+export declare function getConfig(): CrawlixConfig;
+//# sourceMappingURL=getConfigs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigs.d.ts","sourceRoot":"","sources":["../../src/lib/getConfigs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAgB,SAAS,IAAI,aAAa,CAOzC"}

package/dist/lib/getConfigs.js

@@ -0,0 +1,12 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+export function getConfig() {
+    const configPath = path.join(os.homedir(), '.crawlix', 'crawlix.config.json');
+    if (!fs.existsSync(configPath)) {
+        throw new Error("Config file not found. Run 'crawlix setup' to create one.");
+    }
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    return config;
+}
+//# sourceMappingURL=getConfigs.js.map

package/dist/lib/getConfigs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfigs.js","sourceRoot":"","sources":["../../src/lib/getConfigs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,IAAI,MAAM,MAAM,CAAA;AAGvB,MAAM,UAAU,SAAS;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAC9E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/llm/index.d.ts

@@ -0,0 +1,15 @@
+import type { ProviderConfig, LLMInput, LLMOutput } from "../types/index.js";
+export declare class LLM {
+    private primaryConfig;
+    private fallbackConfig?;
+    private client;
+    private fallbackClient?;
+    private roundRobinProviders;
+    private roundRobinClients;
+    private roundRobinIndex;
+    private useRoundRobin;
+    constructor(primaryConfig: ProviderConfig, fallbackConfig?: ProviderConfig, roundRobin?: ProviderConfig[]);
+    complete(input: LLMInput): Promise<LLMOutput>;
+    private callProvider;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAgB,MAAM,mBAAmB,CAAC;AAoC3F,qBAAa,GAAG;IACZ,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAC,CAA6B;IAEpD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAAC,CAAiC;IACxD,OAAO,CAAC,mBAAmB,CAAwB;IACnD,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,aAAa,CAAkB;gBAE3B,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE;IAcnG,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;YAsDrC,YAAY;CA2D7B"}

package/dist/llm/index.js

@@ -0,0 +1,147 @@
+import Anthropic from "@anthropic-ai/sdk";
+import OpenAI from "openai";
+// Default baseURLs per provider 
+const BASE_URLS = {
+    groq: 'https://api.groq.com/openai/v1',
+    gemini: 'https://generativelanguage.googleapis.com/v1beta/openai',
+    openrouter: 'https://openrouter.ai/api/v1',
+    ollama: 'http://localhost:11434/v1',
+    cerebras: 'https://api.cerebras.ai/v1',
+    mistral: 'https://api.mistral.ai/v1',
+};
+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',
+};
+// Client factory 
+function createClient(config) {
+    if (config.provider === 'anthropic') {
+        return new Anthropic({ apiKey: config.apiKey });
+    }
+    return new OpenAI({
+        apiKey: config.apiKey ?? 'no-key-needed', // ollama doesn't need a key
+        baseURL: config.baseURL ?? BASE_URLS[config.provider],
+    });
+}
+// LLM
+export class LLM {
+    primaryConfig;
+    fallbackConfig;
+    client;
+    fallbackClient;
+    roundRobinProviders = [];
+    roundRobinClients = [];
+    roundRobinIndex = 0;
+    useRoundRobin = false;
+    constructor(primaryConfig, fallbackConfig, roundRobin) {
+        this.primaryConfig = primaryConfig;
+        this.fallbackConfig = fallbackConfig;
+        if (roundRobin && roundRobin.length > 0) {
+            this.useRoundRobin = true;
+            this.roundRobinProviders = roundRobin;
+            this.roundRobinClients = roundRobin.map(c => createClient(c));
+        }
+        this.client = createClient(primaryConfig);
+        if (fallbackConfig) {
+            this.fallbackClient = createClient(fallbackConfig);
+        }
+    }
+    async complete(input) {
+        if (this.useRoundRobin && this.roundRobinProviders.length > 0) {
+            // try current provider
+            const index = this.roundRobinIndex % this.roundRobinProviders.length;
+            const config = this.roundRobinProviders[index];
+            const client = this.roundRobinClients[index];
+            this.roundRobinIndex++;
+            try {
+                return await this.callProvider(client, config, input);
+            }
+            catch (err) {
+                const isRateLimit = err?.status === 429 ||
+                    String(err).toLowerCase().includes('rate');
+                if (isRateLimit) {
+                    // remove current provider from available pool temporarily
+                    const available = this.roundRobinProviders
+                        .map((p, i) => ({ p, i }))
+                        .filter(({ i }) => i !== index);
+                    if (available.length === 0)
+                        throw err;
+                    // pick randomly from remaining
+                    const random = available[Math.floor(Math.random() * available.length)];
+                    console.warn(`👾 ${config.provider} rate limited — randomly switching to ${this.roundRobinProviders[random.i].provider}`);
+                    return await this.callProvider(this.roundRobinClients[random.i], this.roundRobinProviders[random.i], input);
+                }
+                throw err;
+            }
+        }
+        try {
+            return await this.callProvider(this.client, this.primaryConfig, input);
+        }
+        catch (err) {
+            const isRateLimit = err?.status === 429 ||
+                String(err).toLowerCase().includes('rate');
+            if (isRateLimit && this.fallbackClient && this.fallbackConfig) {
+                console.warn(`👾 ${this.primaryConfig.provider} rate limited — falling back to ${this.fallbackConfig.provider}`);
+                return await this.callProvider(this.fallbackClient, this.fallbackConfig, input);
+            }
+            throw err;
+        }
+    }
+    async callProvider(client, config, input) {
+        const model = config.model ?? DEFAULT_MODELS[config.provider];
+        // Anthropic 
+        if (client instanceof Anthropic) {
+            const res = await client.messages.create({
+                model,
+                max_tokens: 2048,
+                system: [{
+                        type: 'text',
+                        text: input.system,
+                        cache_control: { type: 'ephemeral' }
+                    }],
+                messages: input.messages.map(m => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+            });
+            const block = res.content[0];
+            if (!block || block.type !== 'text') {
+                throw new Error('Anthropic returned empty response');
+            }
+            return {
+                content: block.text,
+                provider: config.provider,
+                model,
+            };
+        }
+        // OpenAI-compatible (Groq, Gemini, etc.)
+        const res = await client.chat.completions.create({
+            model,
+            temperature: 0.2,
+            max_tokens: 2048,
+            response_format: { type: 'json_object' },
+            messages: [
+                { role: 'system', content: input.system },
+                ...input.messages.map(m => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+            ],
+        });
+        const content = res.choices[0]?.message?.content;
+        if (!content)
+            throw new Error(`${config.provider} returned empty response`);
+        return {
+            content,
+            provider: config.provider,
+            model,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

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

package/dist/personas/index.d.ts

@@ -0,0 +1,5 @@
+import type { PersonaConfig } from '../types/index.js';
+export declare const PERSONAS: Record<string, PersonaConfig>;
+export declare function resolvePersona(input: PersonaConfig | string): PersonaConfig;
+export declare const PERSONA_NAMES: Array<keyof typeof PERSONAS>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/personas/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGtD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAwFlD,CAAA;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,aAAa,CAa3E;AAID,eAAO,MAAM,aAAa,EAA4B,KAAK,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA"}

package/dist/personas/index.js

@@ -0,0 +1,100 @@
+// Persona Definitions 
+export const PERSONAS = {
+    'first-timer': {
+        name: 'First-Timer',
+        description: 'A new user encountering this product for the first time',
+        patience: 7,
+        aggression: 1,
+        readingBehavior: 'thorough',
+        systemPrompt: `You are a first-time user of this application. You have no prior knowledge
+of how it works. You read everything carefully before clicking. You get lost easily
+and click whatever looks most obvious. You notice when labels are confusing or when
+the UI doesn't explain what it does. You try the happy path but may misread instructions.
+You stop and re-read if something doesn't work. You sometimes click the wrong button
+by accident. You never use keyboard shortcuts.`,
+    },
+    'impatient': {
+        name: 'Impatient',
+        description: 'A busy user who skims and clicks fast without reading',
+        patience: 3,
+        aggression: 4,
+        readingBehavior: 'skip',
+        systemPrompt: `You are a busy, impatient user. You skip reading instructions entirely.
+You click the first thing that looks right. You submit forms immediately without
+filling all fields. You abandon flows quickly if they take more than 2 steps.
+You double-click buttons. You spam the submit button if nothing happens immediately.
+You get frustrated by loading states and try to click through them. You ignore
+confirmation dialogs and click the default option.`,
+    },
+    'power-user': {
+        name: 'Power User',
+        description: 'An experienced user who uses advanced features and shortcuts',
+        patience: 9,
+        aggression: 3,
+        readingBehavior: 'skim',
+        systemPrompt: `You are an experienced power user. You use keyboard shortcuts whenever
+possible. You try edge cases deliberately: very long inputs, special characters,
+emoji in text fields, extreme values in number fields. You try to navigate directly
+to deep URLs. You open multiple flows. You look for admin or settings panels.
+You test the absolute limits of the application. You notice missing features and
+document them as findings. You move fast but methodically.`,
+    },
+    'adversarial': {
+        name: 'Adversarial',
+        description: 'A malicious user probing for security issues and broken flows',
+        patience: 8,
+        aggression: 10,
+        readingBehavior: 'skim',
+        systemPrompt: `You are a malicious user deliberately trying to break the application
+and find security vulnerabilities. You inject script tags into input fields: <script>alert(1)</script>.
+You try SQL injection: ' OR 1=1 --. You enter extremely long strings (500+ characters).
+You try to access other users' data by modifying IDs in URLs. You submit forms
+with missing required fields. You try to upload malicious file types. You look for
+exposed API keys or tokens in the page source. You test every boundary condition.
+You document every vulnerability as a critical finding.`,
+    },
+    'non-native': {
+        name: 'Non-Native Speaker',
+        description: 'A user who reads English as a second language and gets confused by jargon',
+        patience: 6,
+        aggression: 1,
+        readingBehavior: 'thorough',
+        systemPrompt: `You are a user for whom English is not your first language. You read
+carefully but misunderstand idioms and technical jargon. You get confused by
+abbreviations and acronyms that aren't explained. You misread instructions when
+they use complex sentence structures. You sometimes click the wrong option because
+labels use synonyms you don't recognize. You note when UI copy is unclear or uses
+unexplained terminology. You are patient and try multiple times before giving up.`,
+    },
+    'slow-network': {
+        name: 'Slow Network',
+        description: 'A user on a throttled connection who encounters loading and timeout issues',
+        patience: 5,
+        aggression: 2,
+        readingBehavior: 'skim',
+        systemPrompt: `You are using this application on a very slow mobile network connection.
+Pages take a long time to load. You notice when content loads without a visible
+loading indicator. You record it as a warning whenever you're left staring at
+a blank screen with no feedback. You sometimes click buttons multiple times because
+you think the first click didn't register. You notice layout shifts when content
+loads in. You look for missing skeleton screens and loading states. You document
+every slow response as at least a warning-level finding.`,
+    },
+};
+// Resolver 
+// Accepts either a persona name string or a full PersonaConfig
+export function resolvePersona(input) {
+    if (typeof input === 'string') {
+        const persona = PERSONAS[input.toLowerCase()];
+        if (!persona) {
+            const available = Object.keys(PERSONAS).join(', ');
+            throw new Error(`Unknown persona "${input}". Available: ${available}\n` +
+                `Or pass a full PersonaConfig object.`);
+        }
+        return persona;
+    }
+    return input;
+}
+// All persona names 
+export const PERSONA_NAMES = Object.keys(PERSONAS);
+//# sourceMappingURL=index.js.map

package/dist/personas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/personas/index.ts"],"names":[],"mappings":"AAEA,uBAAuB;AACvB,MAAM,CAAC,MAAM,QAAQ,GAAkC;IAErD,aAAa,EAAE;QACb,IAAI,EAAa,aAAa;QAC9B,WAAW,EAAM,yDAAyD;QAC1E,QAAQ,EAAS,CAAC;QAClB,UAAU,EAAO,CAAC;QAClB,eAAe,EAAE,UAAU;QAC3B,YAAY,EAAE;;;;;+CAK6B;KAC5C;IAED,WAAW,EAAE;QACX,IAAI,EAAa,WAAW;QAC5B,WAAW,EAAM,uDAAuD;QACxE,QAAQ,EAAS,CAAC;QAClB,UAAU,EAAO,CAAC;QAClB,eAAe,EAAE,MAAM;QACvB,YAAY,EAAE;;;;;mDAKiC;KAChD;IAED,YAAY,EAAE;QACZ,IAAI,EAAa,YAAY;QAC7B,WAAW,EAAM,8DAA8D;QAC/E,QAAQ,EAAS,CAAC;QAClB,UAAU,EAAO,CAAC;QAClB,eAAe,EAAE,MAAM;QACvB,YAAY,EAAE;;;;;2DAKyC;KACxD;IAED,aAAa,EAAE;QACb,IAAI,EAAa,aAAa;QAC9B,WAAW,EAAM,+DAA+D;QAChF,QAAQ,EAAS,CAAC;QAClB,UAAU,EAAO,EAAE;QACnB,eAAe,EAAE,MAAM;QACvB,YAAY,EAAE;;;;;;wDAMsC;KACrD;IAED,YAAY,EAAE;QACZ,IAAI,EAAa,oBAAoB;QACrC,WAAW,EAAM,2EAA2E;QAC5F,QAAQ,EAAS,CAAC;QAClB,UAAU,EAAO,CAAC;QAClB,eAAe,EAAE,UAAU;QAC3B,YAAY,EAAE;;;;;kFAKgE;KAC/E;IAED,cAAc,EAAE;QACd,IAAI,EAAa,cAAc;QAC/B,WAAW,EAAM,4EAA4E;QAC7F,QAAQ,EAAS,CAAC;QAClB,UAAU,EAAO,CAAC;QAClB,eAAe,EAAE,MAAM;QACvB,YAAY,EAAE;;;;;;yDAMuC;KACtD;CAEF,CAAA;AAED,YAAY;AACZ,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,KAA6B;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAClD,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,iBAAiB,SAAS,IAAI;gBACvD,sCAAsC,CACvC,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,qBAAqB;AAErB,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAiC,CAAA"}

package/dist/personas/loader.d.ts

@@ -0,0 +1,4 @@
+import type { PersonaConfig } from '../types/index.js';
+export declare function loadPersonas(agentFlag?: string): Promise<PersonaConfig[]>;
+export declare function listPersonas(): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/personas/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/personas/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAyCtD,wBAAsB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA0B/E;AAED,wBAAsB,YAAY,kBAmBjC"}

package/dist/personas/loader.js

@@ -0,0 +1,72 @@
+import { PERSONAS } from './index.js';
+import fs from 'fs';
+import path from 'path';
+function isValidPersona(config) {
+    const c = config;
+    return (typeof c.name === 'string' &&
+        typeof c.description === 'string' &&
+        typeof c.systemPrompt === 'string' &&
+        typeof c.patience === 'number' &&
+        typeof c.aggression === 'number' &&
+        ['thorough', 'skim', 'skip'].includes(c.readingBehavior));
+}
+async function loadCustomPersonas() {
+    const dir = path.resolve(process.cwd(), '.crawlix/agents/');
+    if (!fs.existsSync(dir))
+        return [];
+    const result = [];
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(path.join(dir, file), 'utf-8');
+            const config = JSON.parse(content);
+            if (isValidPersona(config)) {
+                result.push(config);
+            }
+            else {
+                console.warn(`👾 skipping ${file} — missing or invalid fields`);
+            }
+        }
+        catch {
+            console.warn(`👾 skipping ${file} — invalid JSON`);
+        }
+    }
+    return result;
+}
+export async function loadPersonas(agentFlag) {
+    const builtIns = Object.values(PERSONAS);
+    // if --agent is specified, only load those 
+    if (agentFlag) {
+        const requested = agentFlag.split(',').map(a => a.trim().toLowerCase());
+        const customs = await loadCustomPersonas();
+        const allPersonas = [
+            ...Object.values(PERSONAS),
+            ...customs
+        ];
+        return requested.map(name => {
+            const found = allPersonas.find(p => p.name.toLowerCase() === name);
+            if (!found)
+                throw new Error(`Unknown agent "${name}". Run 'crawlix agents --list' to see available agents.`);
+            return found;
+        });
+    }
+    const customs = await loadCustomPersonas();
+    return [...builtIns, ...customs];
+}
+export async function listPersonas() {
+    const builtIns = Object.values(PERSONAS);
+    const customs = await loadCustomPersonas();
+    console.log('\n  👾 available agents\n');
+    console.log('  built-in:');
+    builtIns.forEach(p => {
+        console.log(`    ${p.name.padEnd(16)} ${p.description}`);
+    });
+    if (customs.length > 0) {
+        console.log('\n  custom:');
+        customs.forEach(p => {
+            console.log(`    ${p.name.padEnd(16)} ${p.description}`);
+        });
+    }
+    console.log();
+}
+//# sourceMappingURL=loader.js.map

package/dist/personas/loader.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,76 @@
+export type ActionType = 'open' | 'click' | 'type' | 'scroll' | 'select' | 'hover' | 'press' | 'wait' | 'done' | 'stuck';
+export interface Action {
+    type: ActionType;
+    target?: string;
+    value?: string;
+    reasoning: string;
+    finding?: Finding;
+}
+export interface ActionResult {
+    success: boolean;
+    error?: string;
+}
+export interface Finding {
+    severity: 'critical' | 'warning' | 'info';
+    description: string;
+    element?: string | undefined;
+    screenshot?: string;
+    step?: number;
+}
+export interface PageState {
+    url?: string;
+    title?: string | undefined;
+    tree: string;
+    timestamp: number;
+}
+export interface HistoryEntry {
+    step: number;
+    pageState: PageState;
+    action: Action;
+}
+export interface PersonaConfig {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    patience: number;
+    aggression: number;
+    readingBehavior: 'thorough' | 'skim' | 'skip';
+    maxSteps?: number;
+}
+export type ProviderName = 'groq' | 'openai' | 'anthropic' | 'gemini' | 'openrouter' | 'ollama' | 'cerebras' | 'mistral';
+export interface ProviderConfig {
+    provider: ProviderName;
+    apiKey?: string;
+    model?: string;
+    baseURL?: string;
+}
+export interface LLMInput {
+    system: string;
+    messages: LLMMessage[];
+}
+export interface LLMMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface LLMOutput {
+    content: string;
+    provider: ProviderName;
+    model: string;
+}
+export interface CrawlixConfig {
+    primary: ProviderConfig;
+    fallback?: ProviderConfig;
+    roundRobin?: ProviderConfig[];
+}
+export interface RunResult {
+    persona: string;
+    url: string;
+    goal: string;
+    steps: number;
+    findings: Finding[];
+    goalReached: boolean;
+    stuck: boolean;
+    duration: number;
+    history: HistoryEntry[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAK,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1H,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAGD,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAGD,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAGD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;CACf;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAGD,MAAM,MAAM,YAAY,GAAK,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3H,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,UAAU,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,YAAY,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAA;CAC9B;AAGD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+//  Crawlix — Types
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "crawlix",
+  "version": "0.1.0",
+  "description": "AI testers that think like users. Your users will break it anyway. Crawlix finds it first.",
+  "main": "./dist/cli/index.js",
+  "exports": {
+    ".": "./dist/cli/index.js"
+  },
+  "keywords": [
+    "ai",
+    "testing",
+    "qa",
+    "automation",
+    "playwright",
+    "agents",
+    "llm"
+  ],
+  "author": "Muhammad Taqi",
+  "license": "MIT",
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "^11.2.2",
+      "onFail": "download"
+    }
+  },
+  "type": "module",
+  "bin": {
+    "crawlix": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.98.0",
+    "@inquirer/prompts": "^8.5.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "openai": "^6.39.0",
+    "ora": "^9.4.0",
+    "playwright": "^1.60.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "dev": "tsx src/cli/index.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}