imperium-crawl 2.5.3 → 2.6.0

package/dist/core/constants.js

@@ -0,0 +1,86 @@
+export const PACKAGE_NAME = "imperium-crawl";
+export const PACKAGE_VERSION = "2.5.0";
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const DEFAULT_MAX_PAGES = 10;
+export const DEFAULT_MAX_DEPTH = 2;
+export const DEFAULT_CONCURRENCY = 3;
+export const DEFAULT_ROBOTS_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+export const SKILLS_DIR_NAME = ".imperium-crawl";
+export const SKILLS_SUBDIR = "skills";
+export const SESSIONS_SUBDIR = "sessions";
+export const JOBS_SUBDIR = "jobs";
+export const BRAVE_API_BASE = "https://api.search.brave.com/res/v1";
+export const DEFAULT_BROWSER_POOL_SIZE = 3;
+export const DEFAULT_BROWSER_IDLE_TIMEOUT_MS = 300_000; // 5 min
+export const KNOWLEDGE_FILE = "knowledge.json";
+// ── Stealth defaults ──
+// Random window size variation for fingerprint diversity
+const W_OFFSET = Math.floor(Math.random() * 101) - 50; // -50 to +50
+const H_OFFSET = Math.floor(Math.random() * 101) - 50;
+export const STEALTH_ARGS = [
+    // ── Core automation hiding ──
+    "--disable-blink-features=AutomationControlled",
+    "--disable-features=AutomationControlled",
+    "--disable-infobars",
+    "--no-first-run",
+    "--no-default-browser-check",
+    "--disable-background-networking",
+    "--disable-component-update",
+    "--disable-default-apps",
+    "--disable-hang-monitor",
+    "--disable-popup-blocking",
+    "--disable-prompt-on-repost",
+    "--disable-sync",
+    "--metrics-recording-only",
+    "--no-service-autorun",
+    "--password-store=basic",
+    // ── Phase 9 additions ──
+    "--disable-dev-shm-usage", // Docker compatibility (shared memory)
+    "--disable-extensions", // No extension detection fingerprint
+    "--lang=en-US,en", // Consistent language fingerprint
+    `--window-size=${1920 + W_OFFSET},${1080 + H_OFFSET}`, // Random window size variation
+    // ── Anti-fingerprinting: WebGL ──
+    "--disable-webgl",
+    "--disable-webgl2",
+    // ── Anti-fingerprinting: Canvas noise suppression ──
+    "--disable-canvas-aa",
+    // ── Anti-fingerprinting: Client Hints (reduce entropy surface) ──
+    "--disable-client-side-phishing-detection",
+    "--disable-histogram-customizer",
+    "--disable-peer-connection",
+    "--disable-permissions-api",
+    // ── Additional anti-bot ──
+    "--disable-background-timer-throttling",
+    "--disable-renderer-backgrounding",
+    "--disable-backgrounding-occluded-windows",
+    "--disable-ipc-flooding-protection",
+    "--disable-gpu-sandbox",
+    "--enable-features=NetworkService,NetworkServiceInProcess",
+    // ── Webdriver flag ──
+    "--webdriver-active=false",
+    // ── Hide Chromium presence via prefs ──
+    "--browser.search.isOnDefaultSearchProvider=false",
+];
+export const DEFAULT_VIEWPORT = { width: 1920, height: 1080 };
+export const HUMAN_DELAY_MIN_MS = 800;
+export const HUMAN_DELAY_MAX_MS = 2500;
+export const MIN_REPEATING_ELEMENTS = 3;
+// ── Input validation bounds ──
+export const MAX_STRING_LENGTH = 10_000;
+export const MAX_BODY_LENGTH = 1_048_576; // 1MB
+export const MAX_QUERY_LENGTH = 2_000;
+export const MAX_SELECTOR_LENGTH = 1_000;
+export const MAX_URL_LENGTH = 8_192;
+export const MAX_PAGES = 100;
+export const MAX_URLS = 10_000;
+export const MAX_ITEMS = 1_000;
+export const MAX_MESSAGES = 1_000;
+export const MAX_CONCURRENCY = 20;
+export const MAX_WAIT_SECONDS = 300;
+export const MAX_DURATION_SECONDS = 300;
+export const MAX_TIMEOUT_MS = 300_000;
+export const MAX_SELECTOR_KEYS = 50;
+export const MAX_CRAWL_CONTENT_PER_PAGE = 102_400; // 100KB
+// ── Snapshot system ──
+export const MAX_STORED_SNAPSHOTS = 100;
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

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

package/dist/core/formatters.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Output formatters for CLI mode.
+ *
+ * Tool execute() returns { content: [{ type: "text", text: JSON.stringify(data) }] }.
+ * These formatters transform that data into json, jsonl, csv, or markdown.
+ */
+export type OutputFormat = "json" | "jsonl" | "csv" | "markdown";
+export interface FormatOptions {
+    format: OutputFormat;
+    pretty?: boolean;
+}
+/**
+ * Parse the first text content block from a tool result.
+ */
+export declare function parseToolOutput(result: {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+}): unknown;
+/**
+ * Parse the first image content block from a tool result.
+ * Returns base64 data + mimeType, or null if no image block found.
+ */
+export declare function parseImageOutput(result: {
+    content: Array<{
+        type: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+}): {
+    data: string;
+    mimeType: string;
+} | null;
+export declare function formatOutput(data: unknown, options: FormatOptions): string;
+//# sourceMappingURL=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/core/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAC1D,OAAO,CAST;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI3C;AAyHD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAa1E"}

package/dist/core/formatters.js

@@ -0,0 +1,147 @@
+/**
+ * Output formatters for CLI mode.
+ *
+ * Tool execute() returns { content: [{ type: "text", text: JSON.stringify(data) }] }.
+ * These formatters transform that data into json, jsonl, csv, or markdown.
+ */
+// ── Helpers ──────────────────────────────────────────────────────────
+/**
+ * Parse the first text content block from a tool result.
+ */
+export function parseToolOutput(result) {
+    const textBlock = result.content.find((c) => c.type === "text" && c.text);
+    if (!textBlock?.text)
+        return null;
+    try {
+        return JSON.parse(textBlock.text);
+    }
+    catch {
+        // Not JSON — return raw text
+        return textBlock.text;
+    }
+}
+/**
+ * Parse the first image content block from a tool result.
+ * Returns base64 data + mimeType, or null if no image block found.
+ */
+export function parseImageOutput(result) {
+    const imgBlock = result.content.find((c) => c.type === "image" && c.data);
+    if (!imgBlock?.data)
+        return null;
+    return { data: imgBlock.data, mimeType: imgBlock.mimeType ?? "image/png" };
+}
+/**
+ * Find the primary array field in an object (for jsonl/csv).
+ * Looks for common keys like results, items, pages, urls, skills, etc.
+ */
+function findArrayField(data) {
+    const priorityKeys = [
+        "results",
+        "items",
+        "pages",
+        "urls",
+        "links",
+        "skills",
+        "images",
+        "videos",
+        "apis",
+        "endpoints",
+        "messages",
+    ];
+    for (const key of priorityKeys) {
+        if (Array.isArray(data[key]))
+            return data[key];
+    }
+    // Fallback: find first array value
+    for (const val of Object.values(data)) {
+        if (Array.isArray(val))
+            return val;
+    }
+    return null;
+}
+// ── CSV Helpers ──────────────────────────────────────────────────────
+function csvEscape(value) {
+    if (value === null || value === undefined)
+        return "";
+    const str = typeof value === "object" ? JSON.stringify(value) : String(value);
+    if (str.includes(",") || str.includes('"') || str.includes("\n")) {
+        return '"' + str.replace(/"/g, '""') + '"';
+    }
+    return str;
+}
+function toCsv(rows) {
+    if (rows.length === 0)
+        return "";
+    // Collect all unique keys across all rows
+    const keys = [...new Set(rows.flatMap((r) => Object.keys(r)))];
+    const header = keys.map(csvEscape).join(",");
+    const lines = rows.map((row) => keys.map((k) => csvEscape(row[k])).join(","));
+    return [header, ...lines].join("\n");
+}
+// ── Format Functions ─────────────────────────────────────────────────
+function formatJson(data, pretty) {
+    return pretty
+        ? JSON.stringify(data, null, 2)
+        : JSON.stringify(data);
+}
+function formatJsonl(data) {
+    if (Array.isArray(data)) {
+        return data.map((item) => JSON.stringify(item)).join("\n");
+    }
+    if (data && typeof data === "object") {
+        const arr = findArrayField(data);
+        if (arr) {
+            return arr.map((item) => JSON.stringify(item)).join("\n");
+        }
+    }
+    // Single object — emit as one line
+    return JSON.stringify(data);
+}
+function formatCsv(data) {
+    let rows;
+    if (Array.isArray(data)) {
+        rows = data.filter((item) => item && typeof item === "object");
+    }
+    else if (data && typeof data === "object") {
+        const arr = findArrayField(data);
+        if (arr) {
+            rows = arr.filter((item) => item && typeof item === "object");
+        }
+        else {
+            // Single object — one row
+            rows = [data];
+        }
+    }
+    else {
+        return String(data);
+    }
+    return toCsv(rows);
+}
+function formatMarkdown(data) {
+    if (data && typeof data === "object" && !Array.isArray(data)) {
+        const obj = data;
+        // Scrape/readability: extract markdown or content field directly
+        if (typeof obj.markdown === "string")
+            return obj.markdown;
+        if (typeof obj.content === "string")
+            return obj.content;
+    }
+    // Fallback: pretty JSON
+    return JSON.stringify(data, null, 2);
+}
+// ── Main Entry Point ─────────────────────────────────────────────────
+export function formatOutput(data, options) {
+    switch (options.format) {
+        case "json":
+            return formatJson(data, options.pretty);
+        case "jsonl":
+            return formatJsonl(data);
+        case "csv":
+            return formatCsv(data);
+        case "markdown":
+            return formatMarkdown(data);
+        default:
+            return formatJson(data, options.pretty);
+    }
+}
+//# sourceMappingURL=formatters.js.map

package/dist/core/formatters.js.map

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

package/dist/engines/camofox.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CamoFox browser engine — REST API wrapper around CamoFox (Camoufox-based stealth browser).
+ *
+ * CamoFox is a Firefox fork with C++ anti-fingerprinting — it patches
+ * navigator.hardwareConcurrency, WebGL, AudioContext, and WebRTC at the C++
+ * level before JavaScript ever sees them. No shims, no tells.
+ *
+ * This engine auto-starts the CamoFox server on first use and communicates
+ * via its REST API (default port 9377). It implements BrowserEngine so tool
+ * code can switch between Playwright and CamoFox with a single flag.
+ *
+ * Usage:
+ *   import { camofoxEngine } from "../engines/camofox.js";
+ *   if (await camofoxEngine.isAvailable()) {
+ *     await camofoxEngine.launch();
+ *     const { page, cleanup } = await camofoxEngine.acquirePage({ headless: true });
+ *     await page.goto("https://example.com");
+ *     const html = await page.content();
+ *     await cleanup();
+ *   }
+ */
+import type { BrowserEngine } from "./types.js";
+export declare const camofoxEngine: BrowserEngine;
+export declare function isCamofoxAvailable(): Promise<boolean>;
+export declare function getCamofoxVersion(): Promise<string | null>;
+export declare function getCamofoxLatestVersion(): Promise<string | null>;
+//# sourceMappingURL=camofox.d.ts.map

package/dist/engines/camofox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camofox.d.ts","sourceRoot":"","sources":["../../src/engines/camofox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,YAAY,CAAC;AAoV/E,eAAO,MAAM,aAAa,EAAE,aAmF3B,CAAC;AAIF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE3D;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQhE;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWtE"}