@zenalexa/unicli 0.207.1

package/dist/engine/repair/failure-classifier.js

@@ -0,0 +1,110 @@
+/**
+ * Failure classifier for the self-repair loop.
+ * Categorizes pipeline failures and provides targeted guidance.
+ */
+/**
+ * Extract all HTTP error statuses (>= 400) from structured network request data.
+ * Returns a Set of unique failing status codes.
+ */
+function extractStatusesFromContext(ctx) {
+    const statuses = new Set();
+    if (!ctx?.page?.networkRequests)
+        return statuses;
+    for (const req of ctx.page.networkRequests) {
+        if (req.status && req.status >= 400)
+            statuses.add(req.status);
+    }
+    return statuses;
+}
+/**
+ * Extract HTTP status code from an error message string.
+ * Requires nearby HTTP context words to avoid false positives from
+ * numbers like port numbers or IDs.
+ */
+const STATUS_PATTERN = /(?:status|http|response|code|error)[:\s]*(\d{3})\b/i;
+function extractStatusFromMessage(message) {
+    const match = STATUS_PATTERN.exec(message);
+    if (!match)
+        return null;
+    const code = Number(match[1]);
+    return code >= 400 && code <= 599 ? code : null;
+}
+/** Pattern to detect API-style URL paths */
+const API_PATH_PATTERN = /\/(api|v\d|graphql|rest|endpoint)\//i;
+/**
+ * Classify a pipeline failure from its RepairContext and return
+ * targeted guidance for the repair agent.
+ */
+export function classifyFailure(repairContext) {
+    const message = repairContext.error.message.toLowerCase();
+    const code = repairContext.error.code.toUpperCase();
+    const site = repairContext.adapter.site;
+    // Collect all failing HTTP statuses from structured data + message
+    const networkStatuses = extractStatusesFromContext(repairContext);
+    const messageStatus = extractStatusFromMessage(repairContext.error.message);
+    if (messageStatus)
+        networkStatuses.add(messageStatus);
+    // 1. Selector miss
+    if (code === "SELECTOR_MISS" ||
+        message.includes("selector") ||
+        message.includes("element not found") ||
+        message.includes("not found in dom")) {
+        return {
+            type: "selector_miss",
+            guidance: "The CSS selector is broken. Read the DOM snapshot and find the correct selector. " +
+                "Use the browser snapshot or page source to identify the new element structure.",
+        };
+    }
+    // 2. Auth expired
+    if (networkStatuses.has(401) ||
+        networkStatuses.has(403) ||
+        message.includes("unauthorized") ||
+        message.includes("forbidden") ||
+        message.includes("login")) {
+        return {
+            type: "auth_expired",
+            guidance: "Authentication expired. The adapter needs fresh cookies or updated auth headers.",
+            preAction: ["npx", "unicli", "auth", "setup", site],
+        };
+    }
+    // 3. API versioned — only classify 404 as api_versioned if URL looks like an API endpoint
+    if (networkStatuses.has(404)) {
+        if (repairContext.error.message &&
+            API_PATH_PATTERN.test(repairContext.error.message)) {
+            return {
+                type: "api_versioned",
+                guidance: "The API endpoint or response shape has changed. " +
+                    "Inspect the current response and update the adapter URL, select path, or map fields.",
+            };
+        }
+        // Generic 404 without API path — fall through to unknown
+    }
+    // 3b. Schema/shape changes
+    if (message.includes("unexpected") ||
+        message.includes("schema") ||
+        message.includes("shape")) {
+        return {
+            type: "api_versioned",
+            guidance: "The API endpoint or response shape has changed. " +
+                "Inspect the current response and update the adapter URL, select path, or map fields.",
+        };
+    }
+    // 4. Rate limited
+    if (networkStatuses.has(429) ||
+        message.includes("rate limit") ||
+        message.includes("too many requests") ||
+        message.includes("throttle")) {
+        return {
+            type: "rate_limited",
+            guidance: "Rate limited. Add or increase wait/delay steps in the pipeline. " +
+                "Consider adding a rate_limit step or increasing backoff intervals.",
+        };
+    }
+    // 5. Unknown
+    return {
+        type: "unknown",
+        guidance: "Unknown failure. Read the full error context, adapter source, and any available " +
+            "page diagnostics to diagnose the root cause.",
+    };
+}
+//# sourceMappingURL=failure-classifier.js.map

package/dist/engine/repair/failure-classifier.js.map

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

package/dist/engine/repair/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * RepairLogger — TSV file logger for self-repair loop iterations.
+ * Logs to ~/.unicli/repair/<site>/log.tsv
+ */
+export interface LogEntry {
+    iteration: number;
+    metric: number;
+    status: "keep" | "discard" | "error";
+    delta: number;
+    summary: string;
+    timestamp: string;
+}
+export declare class RepairLogger {
+    private readonly filePath;
+    constructor(site: string);
+    append(entry: LogEntry): void;
+    readAll(): LogEntry[];
+    readLast(n: number): LogEntry[];
+    consecutiveDiscards(): number;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/engine/repair/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/engine/repair/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,IAAI,EAAE,MAAM;IAWxB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAY7B,OAAO,IAAI,QAAQ,EAAE;IAoBrB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;IAK/B,mBAAmB,IAAI,MAAM;CAY9B"}

package/dist/engine/repair/logger.js

@@ -0,0 +1,69 @@
+/**
+ * RepairLogger — TSV file logger for self-repair loop iterations.
+ * Logs to ~/.unicli/repair/<site>/log.tsv
+ */
+import { appendFileSync, readFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const TSV_HEADER = "iteration\tmetric\tstatus\tdelta\tsummary\ttimestamp";
+export class RepairLogger {
+    filePath;
+    constructor(site) {
+        const dir = join(homedir(), ".unicli", "repair", site);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.filePath = join(dir, "log.tsv");
+        if (!existsSync(this.filePath)) {
+            appendFileSync(this.filePath, TSV_HEADER + "\n", "utf-8");
+        }
+    }
+    append(entry) {
+        const line = [
+            entry.iteration,
+            entry.metric,
+            entry.status,
+            entry.delta,
+            entry.summary.replace(/\t/g, " ").replace(/\n/g, " "),
+            entry.timestamp,
+        ].join("\t");
+        appendFileSync(this.filePath, line + "\n", "utf-8");
+    }
+    readAll() {
+        if (!existsSync(this.filePath))
+            return [];
+        const content = readFileSync(this.filePath, "utf-8");
+        const lines = content.trim().split("\n").slice(1); // skip header
+        return lines
+            .filter((l) => l.trim().length > 0)
+            .map((line) => {
+            const [iteration, metric, status, delta, summary, timestamp] = line.split("\t");
+            return {
+                iteration: Number(iteration),
+                metric: Number(metric),
+                status: status,
+                delta: Number(delta),
+                summary: summary ?? "",
+                timestamp: timestamp ?? "",
+            };
+        });
+    }
+    readLast(n) {
+        const all = this.readAll();
+        return all.slice(-n);
+    }
+    consecutiveDiscards() {
+        const all = this.readAll();
+        let count = 0;
+        for (let i = all.length - 1; i >= 0; i--) {
+            if (all[i].status === "discard") {
+                count++;
+            }
+            else {
+                break;
+            }
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/engine/repair/logger.js.map

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

package/dist/engine/repair/prompt.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Prompt builder for the self-repair loop.
+ * Assembles context for Claude Code to make targeted adapter fixes.
+ */
+import type { LogEntry } from "./logger.js";
+import type { RepairConfig } from "./config.js";
+export interface RepairLoopContext {
+    iteration: number;
+    bestMetric: number;
+    currentMetric: number;
+    recentLog: LogEntry[];
+    gitLog: string;
+    scopeFiles: string[];
+    consecutiveDiscards: number;
+    stuckHint?: string;
+    failureGuidance?: string;
+}
+/**
+ * Build the repair prompt sent to Claude Code for each iteration.
+ */
+export declare function buildRepairPrompt(ctx: RepairLoopContext, config: RepairConfig): string;
+/**
+ * Get a hint based on how many consecutive iterations have been discarded.
+ * Returns undefined if the loop is not stuck.
+ */
+export declare function getStuckHint(consecutiveDiscards: number): string | undefined;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/engine/repair/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/engine/repair/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,YAAY,GACnB,MAAM,CAiER;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAY5E"}

package/dist/engine/repair/prompt.js

@@ -0,0 +1,51 @@
+/**
+ * Prompt builder for the self-repair loop.
+ * Assembles context for Claude Code to make targeted adapter fixes.
+ */
+/**
+ * Build the repair prompt sent to Claude Code for each iteration.
+ */
+export function buildRepairPrompt(ctx, config) {
+    const sections = [];
+    // 1. Goal
+    sections.push(`# Self-Repair Iteration ${ctx.iteration}`, "", `**Goal**: Fix the failing adapter for site "${config.site}".`, `Current score: ${ctx.currentMetric}. Best score: ${ctx.bestMetric}.`, `Verify command: \`${config.verify}\``, "");
+    // 2. Scope
+    sections.push("## Scope", `You may ONLY edit files matching these patterns:`, ...config.scope.map((s) => `- \`${s}\``), "", "Resolved files:", ...ctx.scopeFiles.map((f) => `- ${f}`), "");
+    // 3. Recent history
+    if (ctx.recentLog.length > 0) {
+        sections.push("## Recent Repair History", "iteration\tmetric\tstatus\tdelta\tsummary", ...ctx.recentLog.map((e) => `${e.iteration}\t${e.metric}\t${e.status}\t${e.delta}\t${e.summary}`), "");
+    }
+    // 4. Git log
+    if (ctx.gitLog.trim()) {
+        sections.push("## Recent Git Log", "```", ctx.gitLog.trim(), "```", "");
+    }
+    // 5. Failure guidance
+    if (ctx.failureGuidance) {
+        sections.push("## Failure Analysis", ctx.failureGuidance, "");
+    }
+    // 6. Stuck hint
+    if (ctx.stuckHint) {
+        sections.push("## Hint (you are stuck)", ctx.stuckHint, "");
+    }
+    // 7. Rules
+    sections.push("## Rules", "- Make ONE atomic change per iteration.", "- Do NOT refactor unrelated code.", "- Do NOT add features — only fix what is broken.", "- Read the adapter YAML/TS source before editing.", "- If a CSS selector is broken, read the DOM snapshot first.", "- After editing, the verify command will be run automatically.", "");
+    return sections.join("\n");
+}
+/**
+ * Get a hint based on how many consecutive iterations have been discarded.
+ * Returns undefined if the loop is not stuck.
+ */
+export function getStuckHint(consecutiveDiscards) {
+    if (consecutiveDiscards >= 11)
+        return "Simplify — remove complexity. Strip the adapter down to its minimal working form.";
+    if (consecutiveDiscards >= 9)
+        return "Try a radical architectural change. Switch strategy, change endpoint, or restructure the pipeline.";
+    if (consecutiveDiscards >= 7)
+        return "Try the OPPOSITE of what has been failing. If you've been fixing selectors, try a different API endpoint instead.";
+    if (consecutiveDiscards >= 5)
+        return "Review the entire results log — what approach worked before? Go back to that direction.";
+    if (consecutiveDiscards >= 3)
+        return "Re-read ALL scope files from scratch. You may be working from stale assumptions.";
+    return undefined;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/engine/repair/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/engine/repair/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAsB,EACtB,MAAoB;IAEpB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,UAAU;IACV,QAAQ,CAAC,IAAI,CACX,2BAA2B,GAAG,CAAC,SAAS,EAAE,EAC1C,EAAE,EACF,+CAA+C,MAAM,CAAC,IAAI,IAAI,EAC9D,kBAAkB,GAAG,CAAC,aAAa,iBAAiB,GAAG,CAAC,UAAU,GAAG,EACrE,qBAAqB,MAAM,CAAC,MAAM,IAAI,EACtC,EAAE,CACH,CAAC;IAEF,WAAW;IACX,QAAQ,CAAC,IAAI,CACX,UAAU,EACV,kDAAkD,EAClD,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EACxC,EAAE,EACF,iBAAiB,EACjB,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EACtC,EAAE,CACH,CAAC;IAEF,oBAAoB;IACpB,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CACX,0BAA0B,EAC1B,2CAA2C,EAC3C,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAClB,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CACvE,EACD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,aAAa;IACb,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,sBAAsB;IACtB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,gBAAgB;IAChB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,WAAW;IACX,QAAQ,CAAC,IAAI,CACX,UAAU,EACV,yCAAyC,EACzC,mCAAmC,EACnC,kDAAkD,EAClD,mDAAmD,EACnD,6DAA6D,EAC7D,gEAAgE,EAChE,EAAE,CACH,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,mBAA2B;IACtD,IAAI,mBAAmB,IAAI,EAAE;QAC3B,OAAO,mFAAmF,CAAC;IAC7F,IAAI,mBAAmB,IAAI,CAAC;QAC1B,OAAO,oGAAoG,CAAC;IAC9G,IAAI,mBAAmB,IAAI,CAAC;QAC1B,OAAO,mHAAmH,CAAC;IAC7H,IAAI,mBAAmB,IAAI,CAAC;QAC1B,OAAO,yFAAyF,CAAC;IACnG,IAAI,mBAAmB,IAAI,CAAC;QAC1B,OAAO,kFAAkF,CAAC;IAC5F,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/engine/update-check.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Non-blocking update checker.
+ * Queries npm registry (cached 24h) and displays a banner on process exit
+ * if a newer version of unicli is available.
+ */
+/**
+ * Non-blocking update check. Fire-and-forget.
+ * Registers a process.on('exit') handler to display result.
+ */
+export declare function checkForUpdates(): void;
+/** Compare semver strings. Returns true if latest > current. Exported for testing. */
+export declare function isNewer(latest: string, current: string): boolean;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/engine/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/engine/update-check.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CA+CtC;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQhE"}

package/dist/engine/update-check.js

@@ -0,0 +1,85 @@
+/**
+ * Non-blocking update checker.
+ * Queries npm registry (cached 24h) and displays a banner on process exit
+ * if a newer version of unicli is available.
+ */
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import chalk from "chalk";
+import { VERSION } from "../constants.js";
+const CACHE_PATH = join(homedir(), ".unicli", "update-check.json");
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const REGISTRY_URL = "https://registry.npmjs.org/unicli/latest";
+/**
+ * Non-blocking update check. Fire-and-forget.
+ * Registers a process.on('exit') handler to display result.
+ */
+export function checkForUpdates() {
+    // Skip in CI
+    if (process.env.CI)
+        return;
+    // Skip in non-TTY (piped output)
+    if (!process.stderr.isTTY)
+        return;
+    // Check cache first
+    let cached;
+    try {
+        const raw = readFileSync(CACHE_PATH, "utf-8");
+        cached = JSON.parse(raw);
+        if (Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+            // Cache is fresh — display on exit if newer
+            if (cached.latest !== VERSION && isNewer(cached.latest, VERSION)) {
+                registerExitMessage(cached.latest);
+            }
+            return;
+        }
+    }
+    catch {
+        // No cache or invalid cache — check registry
+    }
+    // Fire-and-forget fetch
+    fetch(REGISTRY_URL, { signal: AbortSignal.timeout(3000) })
+        .then((resp) => resp.json())
+        .then((data) => {
+        const latest = data.version;
+        // Write cache
+        try {
+            mkdirSync(join(homedir(), ".unicli"), { recursive: true });
+            writeFileSync(CACHE_PATH, JSON.stringify({ latest, checkedAt: Date.now() }), "utf-8");
+        }
+        catch {
+            /* best effort */
+        }
+        if (latest !== VERSION && isNewer(latest, VERSION)) {
+            registerExitMessage(latest);
+        }
+    })
+        .catch(() => {
+        /* network failure — silently ignore */
+    });
+}
+/** Compare semver strings. Returns true if latest > current. Exported for testing. */
+export function isNewer(latest, current) {
+    const l = latest.split(".").map(Number);
+    const c = current.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((l[i] ?? 0) > (c[i] ?? 0))
+            return true;
+        if ((l[i] ?? 0) < (c[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+let _registered = false;
+function registerExitMessage(latest) {
+    if (_registered)
+        return;
+    _registered = true;
+    process.on("exit", (code) => {
+        if (code === 0) {
+            process.stderr.write(`\n${chalk.yellow(`Update available: ${VERSION} → ${latest}`)} — run ${chalk.cyan("npm i -g unicli")} to upgrade\n`);
+        }
+    });
+}
+//# sourceMappingURL=update-check.js.map

package/dist/engine/update-check.js.map

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

package/dist/engine/websocket.d.ts

@@ -0,0 +1,19 @@
+/**
+ * WebSocket pipeline step — connect, send, receive.
+ * For OBS Studio (obs-websocket 5.x) and similar WebSocket services.
+ */
+export interface WebsocketStepConfig {
+    url: string;
+    auth?: {
+        password_env?: string;
+        password?: string;
+    };
+    send: string;
+    parse?: "json" | "text";
+    timeout?: number;
+}
+/**
+ * Execute a WebSocket request: connect → optional auth → send → receive → close.
+ */
+export declare function executeWebsocket(config: WebsocketStepConfig): Promise<unknown>;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/engine/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/engine/websocket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE;QACL,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsCD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAmFlB"}

package/dist/engine/websocket.js

@@ -0,0 +1,102 @@
+/**
+ * WebSocket pipeline step — connect, send, receive.
+ * For OBS Studio (obs-websocket 5.x) and similar WebSocket services.
+ */
+import WebSocket from "ws";
+import { createHash } from "node:crypto";
+/**
+ * OBS WebSocket 5.x authentication handshake.
+ * obs-websocket uses SHA256 challenge-response.
+ */
+async function obsAuth(ws, password, challenge, salt) {
+    const secret = createHash("sha256")
+        .update(password + salt)
+        .digest("base64");
+    const authResponse = createHash("sha256")
+        .update(secret + challenge)
+        .digest("base64");
+    ws.send(JSON.stringify({
+        op: 1, // Identify
+        d: { rpcVersion: 1, authentication: authResponse },
+    }));
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error("OBS auth timeout")), 5000);
+        ws.once("message", (raw) => {
+            clearTimeout(timer);
+            const msg = JSON.parse(String(raw));
+            if (msg.op === 2)
+                resolve(); // Identified response
+            else
+                reject(new Error(`OBS auth failed: ${JSON.stringify(msg)}`));
+        });
+    });
+}
+/**
+ * Execute a WebSocket request: connect → optional auth → send → receive → close.
+ */
+export async function executeWebsocket(config) {
+    const timeout = config.timeout ?? 5000;
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(config.url);
+        const timer = setTimeout(() => {
+            ws.close();
+            reject(new Error(`WebSocket timeout after ${timeout}ms`));
+        }, timeout);
+        ws.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        ws.on("open", async () => {
+            try {
+                // Handle OBS-style auth if configured
+                if (config.auth) {
+                    const password = (config.auth.password_env
+                        ? process.env[config.auth.password_env]
+                        : undefined) ??
+                        config.auth.password ??
+                        "";
+                    // Wait for Hello message (op: 0) from OBS
+                    const hello = await new Promise((res, rej) => {
+                        const helloTimer = setTimeout(() => rej(new Error("No Hello from OBS")), 5000);
+                        ws.once("message", (raw) => {
+                            clearTimeout(helloTimer);
+                            res(JSON.parse(String(raw)));
+                        });
+                    });
+                    if (hello.op === 0) {
+                        const data = hello.d;
+                        if (data.authentication) {
+                            await obsAuth(ws, password, data.authentication.challenge, data.authentication.salt);
+                        }
+                    }
+                }
+                // Send the message
+                ws.send(config.send);
+                // Wait for response
+                ws.once("message", (raw) => {
+                    clearTimeout(timer);
+                    ws.close();
+                    const text = String(raw);
+                    if (config.parse === "text") {
+                        resolve(text);
+                    }
+                    else {
+                        // Default: try JSON parse, fall back to text
+                        try {
+                            resolve(JSON.parse(text));
+                        }
+                        catch {
+                            resolve(text);
+                        }
+                    }
+                });
+            }
+            catch (err) {
+                clearTimeout(timer);
+                ws.close();
+                reject(err);
+            }
+        });
+    });
+}
+//# sourceMappingURL=websocket.js.map

package/dist/engine/websocket.js.map

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

package/dist/engine/yaml-runner.d.ts

@@ -0,0 +1,92 @@
+/**
+ * YAML Pipeline Execution Engine — the Flight Computer.
+ *
+ * Executes pipeline steps defined in YAML adapters:
+ *   fetch    → HTTP request (GET/POST)
+ *   select   → Extract nested field from response
+ *   map      → Transform each item using template expressions
+ *   filter   → Keep items matching a condition
+ *   limit    → Cap the number of results
+ *   html_to_md → Convert HTML to Markdown via turndown
+ *   write_temp → Write content to a temp file (cleaned up after pipeline)
+ *   evaluate → Run JS expression (for browser adapters, future)
+ *
+ * Template syntax: ${{ expression }}
+ *   Available variables: item, index, args, base, temp
+ */
+import type { PipelineStep } from "../types.js";
+import type { BrowserPage } from "../browser/page.js";
+export interface PipelineOptions {
+    site?: string;
+    strategy?: string;
+}
+type PipelineContext = {
+    data: unknown;
+    args: Record<string, unknown>;
+    vars: Record<string, unknown>;
+    base?: string;
+    cookieHeader?: string;
+    temp?: Record<string, string>;
+    tempDir?: string;
+    page?: BrowserPage;
+};
+/**
+ * Structured pipeline error — designed for AI agent consumption.
+ * An agent receiving this error can read the adapter YAML, understand
+ * exactly what failed, and edit the file to fix it.
+ */
+export declare class PipelineError extends Error {
+    readonly detail: {
+        step: number;
+        action: string;
+        config: unknown;
+        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "timeout" | "expression_error" | "assertion_failed";
+        url?: string;
+        statusCode?: number;
+        responsePreview?: string;
+        suggestion: string;
+    };
+    constructor(message: string, detail: {
+        step: number;
+        action: string;
+        config: unknown;
+        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "timeout" | "expression_error" | "assertion_failed";
+        url?: string;
+        statusCode?: number;
+        responsePreview?: string;
+        suggestion: string;
+    });
+    /** JSON output for AI agents — includes everything needed to self-repair */
+    toAgentJSON(adapterPath?: string): {
+        step: number;
+        action: string;
+        config: unknown;
+        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "timeout" | "expression_error" | "assertion_failed";
+        url?: string;
+        statusCode?: number;
+        responsePreview?: string;
+        suggestion: string;
+        error: string;
+        adapter: string | undefined;
+    };
+}
+export declare function runPipeline(steps: PipelineStep[], args: Record<string, unknown>, base?: string, options?: PipelineOptions): Promise<unknown[]>;
+declare function buildScope(ctx: PipelineContext): Record<string, unknown>;
+/**
+ * Built-in pipe filters — used in template expressions like:
+ *   ${{ item.tags | join(', ') }}
+ *   ${{ args.word | urlencode }}
+ *   ${{ item.text | slice(0, 200) }}
+ */
+declare const PIPE_FILTERS: Record<string, (...args: unknown[]) => unknown>;
+/**
+ * Safe expression evaluator using Node.js VM sandbox.
+ * Provides stronger isolation than `new Function()` with a 50ms timeout
+ * to prevent DoS. Simple dotted access (the most common case) uses a
+ * fast path that avoids the VM overhead entirely.
+ *
+ * Supports pipe filters: ${{ expr | join(', ') | slice(0, 100) }}
+ */
+declare function evalExpression(expr: string, scope: Record<string, unknown>): unknown;
+export { PIPE_FILTERS, evalExpression, buildScope };
+//# sourceMappingURL=yaml-runner.d.ts.map

package/dist/engine/yaml-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-runner.d.ts","sourceRoot":"","sources":["../../src/engine/yaml-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmBtD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EACL,YAAY,GACZ,eAAe,GACf,cAAc,GACd,aAAa,GACb,SAAS,GACT,kBAAkB,GAClB,kBAAkB,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB;gBAjBD,OAAO,EAAE,MAAM,EACC,MAAM,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EACL,YAAY,GACZ,eAAe,GACf,cAAc,GACd,aAAa,GACb,SAAS,GACT,kBAAkB,GAClB,kBAAkB,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB;IAMH,4EAA4E;IAC5E,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM;cAtBtB,MAAM;gBACJ,MAAM;gBACN,OAAO;mBAEX,YAAY,GACZ,eAAe,GACf,cAAc,GACd,aAAa,GACb,SAAS,GACT,kBAAkB,GAClB,kBAAkB;cAChB,MAAM;qBACC,MAAM;0BACD,MAAM;oBACZ,MAAM;;;;CAevB;AAmID,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EAAE,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC,CAqPpB;AA6pBD,iBAAS,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBjE;AAwOD;;;;;GAKG;AACH,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAyFjE,CAAC;AA0GF;;;;;;;GAOG;AACH,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA6D7E;AAqwBD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC"}