imperium-crawl 2.5.3 → 2.6.0

package/dist/cli/onboarding.js

@@ -0,0 +1,128 @@
+/**
+ * Interactive setup wizard for imperium-crawl CLI.
+ *
+ * Usage: imperium-crawl setup
+ *
+ * Guides the user through configuring API keys and saves them to
+ * ~/.imperium-crawl/config.json for persistent use.
+ */
+import chalk from "chalk";
+import { input, select, confirm } from "@inquirer/prompts";
+import { loadCliConfig, saveCliConfig, getCliConfigPath } from "./config.js";
+const BANNER = chalk.cyan(`
+  ██╗███╗   ███╗██████╗ ███████╗██████╗ ██╗██╗   ██╗███╗   ███╗
+  ██║████╗ ████║██╔══██╗██╔════╝██╔══██╗██║██║   ██║████╗ ████║
+  ██║██╔████╔██║██████╔╝█████╗  ██████╔╝██║██║   ██║██╔████╔██║
+  ██║██║╚██╔╝██║██╔═══╝ ██╔══╝  ██╔══██╗██║██║   ██║██║╚██╔╝██║
+  ██║██║ ╚═╝ ██║██║     ███████╗██║  ██║██║╚██████╔╝██║ ╚═╝ ██║
+  ╚═╝╚═╝     ╚═╝╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝ ╚═════╝ ╚═╝     ╚═╝
+`);
+export async function runSetup() {
+    console.log(BANNER);
+    console.log(chalk.bold("  API Key Setup\n"));
+    const existing = loadCliConfig();
+    const config = { ...existing };
+    // ── Brave Search ──────────────────────────────────────────────────
+    const hasBrave = !!(process.env.BRAVE_API_KEY || existing.BRAVE_API_KEY);
+    if (hasBrave) {
+        console.log(chalk.green("  ✓ BRAVE_API_KEY") +
+            chalk.dim(" — already configured (search, news_search, image_search, video_search)"));
+    }
+    else {
+        console.log(chalk.dim("  Brave Search enables 4 search tools. Free tier: https://brave.com/search/api/\n"));
+        const braveKey = await input({
+            message: "Brave Search API key (press Enter to skip):",
+        });
+        if (braveKey.trim())
+            config.BRAVE_API_KEY = braveKey.trim();
+    }
+    console.log();
+    // ── LLM Provider ─────────────────────────────────────────────────
+    const hasLLM = !!(process.env.LLM_API_KEY || existing.LLM_API_KEY);
+    if (hasLLM) {
+        const currentProvider = process.env.LLM_PROVIDER || existing.LLM_PROVIDER || "anthropic";
+        console.log(chalk.green(`  ✓ LLM_API_KEY (${currentProvider})`) +
+            chalk.dim(" — already configured (ai_extract tool)"));
+    }
+    else {
+        console.log(chalk.dim("  LLM key enables the ai_extract tool — natural language data extraction.\n"));
+        const provider = await select({
+            message: "LLM provider (for ai_extract tool):",
+            choices: [
+                {
+                    name: "Anthropic (Claude Haiku — default)",
+                    value: "anthropic",
+                    description: "Fast, affordable. Get key: https://console.anthropic.com",
+                },
+                {
+                    name: "OpenAI (GPT-4o mini — default)",
+                    value: "openai",
+                    description: "Widely used. Get key: https://platform.openai.com",
+                },
+                {
+                    name: "MiniMax (M2.5 — 200K context, reasoning)",
+                    value: "minimax",
+                    description: "Strong model, OpenAI-compatible API.",
+                },
+                {
+                    name: "Skip for now",
+                    value: "skip",
+                    description: "Configure later via env vars or run setup again.",
+                },
+            ],
+        });
+        if (provider !== "skip") {
+            config.LLM_PROVIDER = provider;
+            const providerLabel = provider === "anthropic" ? "Anthropic" : provider === "openai" ? "OpenAI" : "MiniMax";
+            const llmKey = await input({
+                message: `${providerLabel} API key:`,
+            });
+            if (llmKey.trim())
+                config.LLM_API_KEY = llmKey.trim();
+        }
+    }
+    console.log();
+    // ── 2Captcha ─────────────────────────────────────────────────────
+    const hasCaptcha = !!(process.env.TWOCAPTCHA_API_KEY ||
+        process.env.TWO_CAPTCHA_API_KEY ||
+        existing.TWOCAPTCHA_API_KEY);
+    if (hasCaptcha) {
+        console.log(chalk.green("  ✓ TWOCAPTCHA_API_KEY") +
+            chalk.dim(" — already configured (auto CAPTCHA solving in stealth level 3)"));
+    }
+    else {
+        const wantCaptcha = await confirm({
+            message: "Configure 2Captcha for automatic CAPTCHA solving? (optional)",
+            default: false,
+        });
+        if (wantCaptcha) {
+            const captchaKey = await input({
+                message: "2Captcha API key (https://2captcha.com):",
+            });
+            if (captchaKey.trim())
+                config.TWOCAPTCHA_API_KEY = captchaKey.trim();
+        }
+    }
+    // ── Save + Summary ────────────────────────────────────────────────
+    saveCliConfig(config);
+    console.log("\n" + chalk.bold("  ─────────────────────────────────────────"));
+    const enabledTools = [];
+    if (config.BRAVE_API_KEY || process.env.BRAVE_API_KEY) {
+        enabledTools.push("search, news_search, image_search, video_search");
+    }
+    if (config.LLM_API_KEY || process.env.LLM_API_KEY) {
+        enabledTools.push("ai_extract");
+    }
+    if (config.TWOCAPTCHA_API_KEY || process.env.TWOCAPTCHA_API_KEY) {
+        enabledTools.push("CAPTCHA auto-solve (stealth lvl 3)");
+    }
+    if (enabledTools.length > 0) {
+        console.log(chalk.green(`\n  🚀 Ready! Extra tools enabled: ${enabledTools.join(", ")}`));
+    }
+    else {
+        console.log(chalk.yellow("\n  ⚠ No API keys configured.") +
+            chalk.dim(" Basic scraping tools work without keys."));
+    }
+    console.log(chalk.dim(`\n  Config saved → ${getCliConfigPath()}\n`));
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/cli/onboarding.js.map

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

package/dist/cli/recorder.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Action Recorder — captures browser actions during an explore REPL session.
+ *
+ * Records every action the user performs, supports undo, and can export
+ * the captured sequence as an InteractSkillConfig JSON file.
+ *
+ * Usage: instantiate one per explore session, call record() after each action,
+ * call toSkillConfig() at the end to get a saveable skill.
+ */
+import type { ActionInput } from "../core/action-executor.js";
+import type { InteractSkillConfig } from "../skills/index.js";
+import type { SkillParameters } from "../skills/index.js";
+export interface RecordedAction {
+    action: ActionInput;
+    rawCommand: string;
+    pageUrl: string;
+    timestamp: number;
+}
+export declare class ActionRecorder {
+    private history;
+    private startUrl;
+    constructor(startUrl: string);
+    /** Record an action after it was successfully executed. */
+    record(action: ActionInput, rawCommand: string, pageUrl: string): void;
+    /** Remove the last recorded action. */
+    undo(): RecordedAction | null;
+    /** Current number of recorded actions. */
+    get count(): number;
+    /** List all recorded actions for display. */
+    getHistory(): RecordedAction[];
+    /** Clear all recorded actions. */
+    clear(): void;
+    /**
+     * Heuristically detect fields that should be parameterized.
+     * Returns suggested SkillParameters — user reviews and adjusts.
+     */
+    detectParameters(): SkillParameters;
+    /**
+     * Export recorded session to InteractSkillConfig.
+     * Ready to save with skills/manager.ts save().
+     */
+    toSkillConfig(name: string, description: string, sessionId?: string, parameters?: SkillParameters): InteractSkillConfig;
+}
+//# sourceMappingURL=recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/cli/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B,2DAA2D;IAC3D,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAStE,uCAAuC;IACvC,IAAI,IAAI,cAAc,GAAG,IAAI;IAI7B,0CAA0C;IAC1C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,6CAA6C;IAC7C,UAAU,IAAI,cAAc,EAAE;IAI9B,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,gBAAgB,IAAI,eAAe;IAKnC;;;OAGG;IACH,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,eAAe,GAC3B,mBAAmB;CAYvB"}

package/dist/cli/recorder.js

@@ -0,0 +1,67 @@
+/**
+ * Action Recorder — captures browser actions during an explore REPL session.
+ *
+ * Records every action the user performs, supports undo, and can export
+ * the captured sequence as an InteractSkillConfig JSON file.
+ *
+ * Usage: instantiate one per explore session, call record() after each action,
+ * call toSkillConfig() at the end to get a saveable skill.
+ */
+import { detectParameterCandidates } from "../skills/index.js";
+export class ActionRecorder {
+    history = [];
+    startUrl;
+    constructor(startUrl) {
+        this.startUrl = startUrl;
+    }
+    /** Record an action after it was successfully executed. */
+    record(action, rawCommand, pageUrl) {
+        this.history.push({
+            action,
+            rawCommand,
+            pageUrl,
+            timestamp: Date.now(),
+        });
+    }
+    /** Remove the last recorded action. */
+    undo() {
+        return this.history.pop() ?? null;
+    }
+    /** Current number of recorded actions. */
+    get count() {
+        return this.history.length;
+    }
+    /** List all recorded actions for display. */
+    getHistory() {
+        return [...this.history];
+    }
+    /** Clear all recorded actions. */
+    clear() {
+        this.history = [];
+    }
+    /**
+     * Heuristically detect fields that should be parameterized.
+     * Returns suggested SkillParameters — user reviews and adjusts.
+     */
+    detectParameters() {
+        const actions = this.history.map((r) => r.action);
+        return detectParameterCandidates(actions);
+    }
+    /**
+     * Export recorded session to InteractSkillConfig.
+     * Ready to save with skills/manager.ts save().
+     */
+    toSkillConfig(name, description, sessionId, parameters) {
+        return {
+            name,
+            description,
+            tool: "interact",
+            url: this.startUrl,
+            created_at: new Date().toISOString(),
+            session_id: sessionId,
+            actions: this.history.map((r) => ({ ...r.action })),
+            ...(parameters && Object.keys(parameters).length > 0 && { parameters }),
+        };
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/cli/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/cli/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAS/D,MAAM,OAAO,cAAc;IACjB,OAAO,GAAqB,EAAE,CAAC;IAC/B,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,2DAA2D;IAC3D,MAAM,CAAC,MAAmB,EAAE,UAAkB,EAAE,OAAe;QAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,MAAM;YACN,UAAU;YACV,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,0CAA0C;IAC1C,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,6CAA6C;IAC7C,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,kCAAkC;IAClC,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAiC,CAAC,CAAC;QAC7E,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,IAAY,EACZ,WAAmB,EACnB,SAAkB,EAClB,UAA4B;QAE5B,OAAO;YACL,IAAI;YACJ,WAAW;YACX,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,IAAI,CAAC,QAAQ;YAClB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACnD,GAAG,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;SACxE,CAAC;IACJ,CAAC;CACF"}

package/dist/cli/tui.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Full TUI (Terminal User Interface) for imperium-crawl — v3
+ *
+ * Slash-command-driven UX (Claude Code aesthetic).
+ * readline for main prompt, @clack/prompts for param collection only.
+ *
+ * Activated when: no CLI args AND process.stdout.isTTY.
+ * Non-TTY mode (pipe/CI/agents) shows --help output.
+ * CLI subcommands (scrape, crawl, etc.) are unaffected — they bypass this.
+ */
+export declare function runTui(): Promise<void>;
+//# sourceMappingURL=tui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/cli/tui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgjCH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB5C"}