@zenalexa/unicli 0.221.0 → 0.221.1

package/dist/commands/do.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @owner        src/commands/do.ts
+ * @does         One-call intent → ranked plan. Natural-language input maps to
+ *               the best-fitting adapter command, and the envelope's
+ *               next_actions field carries an executable, schema-aware
+ *               invocation template. Intentionally plan-only — agents
+ *               explicitly invoke the suggested command on the second hop
+ *               (mirrors REST HATEOAS; avoids ambiguous-intent triggering
+ *               irreversible adapter writes).
+ * @needs        commander, src/discovery/search, src/registry,
+ *               src/commands/describe (describeCommand), src/output/{envelope,formatter}
+ * @feeds        src/cli.ts agent entrypoint; complements `unicli search`
+ *               (set semantics) with action semantics ("give me the answer").
+ * @breaks       Emits `empty_result` envelope (exit 66) when no adapter
+ *               scores above the floor. Otherwise always success path —
+ *               this command does not perform network calls or writes.
+ * @invariants   Never auto-executes the matched command. Output envelope's
+ *               next_actions[0] is the recommended invocation; the agent
+ *               must call it explicitly.
+ * @side-effects None — local index lookup only.
+ * @perf         O(N) over BM25 index already loaded; <10ms cold per
+ *               discovery/search.ts header.
+ * @concurrency  Pure; no shared state.
+ * @test         tests/unit/commands/do.test.ts
+ * @stability    experimental
+ * @since        2026-05-18
+ */
+import { Command } from "commander";
+export declare function registerDoCommand(program: Command): void;
+//# sourceMappingURL=do.d.ts.map

package/dist/commands/do.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do.d.ts","sourceRoot":"","sources":["../../src/commands/do.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2GxD"}

package/dist/commands/do.js

@@ -0,0 +1,248 @@
+/**
+ * @owner        src/commands/do.ts
+ * @does         One-call intent → ranked plan. Natural-language input maps to
+ *               the best-fitting adapter command, and the envelope's
+ *               next_actions field carries an executable, schema-aware
+ *               invocation template. Intentionally plan-only — agents
+ *               explicitly invoke the suggested command on the second hop
+ *               (mirrors REST HATEOAS; avoids ambiguous-intent triggering
+ *               irreversible adapter writes).
+ * @needs        commander, src/discovery/search, src/registry,
+ *               src/commands/describe (describeCommand), src/output/{envelope,formatter}
+ * @feeds        src/cli.ts agent entrypoint; complements `unicli search`
+ *               (set semantics) with action semantics ("give me the answer").
+ * @breaks       Emits `empty_result` envelope (exit 66) when no adapter
+ *               scores above the floor. Otherwise always success path —
+ *               this command does not perform network calls or writes.
+ * @invariants   Never auto-executes the matched command. Output envelope's
+ *               next_actions[0] is the recommended invocation; the agent
+ *               must call it explicitly.
+ * @side-effects None — local index lookup only.
+ * @perf         O(N) over BM25 index already loaded; <10ms cold per
+ *               discovery/search.ts header.
+ * @concurrency  Pure; no shared state.
+ * @test         tests/unit/commands/do.test.ts
+ * @stability    experimental
+ * @since        2026-05-18
+ */
+import { search } from "../discovery/search.js";
+import { getAdapter, resolveCommand } from "../registry.js";
+import { describeCommand } from "./describe.js";
+import { format, detectFormat } from "../output/formatter.js";
+const DEFAULT_TOP = 3;
+const SCORE_FLOOR = 0.0;
+export function registerDoCommand(program) {
+    program
+        .command("do <intent...>")
+        .description("Route a natural-language intent to the best-fit adapter command (plan-only; agent executes the suggested next_action)")
+        .option("-n, --top <n>", `Return top-N candidates (default ${DEFAULT_TOP})`, String(DEFAULT_TOP))
+        .option("--no-schema", "Omit args_schema and example_stdin from each match payload")
+        .action((intentParts, opts) => {
+        const startedAt = Date.now();
+        const fmt = detectFormat(program.opts().format);
+        const intent = intentParts.join(" ").trim();
+        let top;
+        try {
+            top = parseTop(opts.top);
+        }
+        catch (e) {
+            emitInvalidInput(startedAt, fmt, intent, e instanceof Error ? e.message : "invalid --top value", `Pass a positive integer up to ${TOP_HARD_LIMIT}`);
+            return;
+        }
+        const includeSchema = opts.schema !== false;
+        if (!intent) {
+            emitEmpty(startedAt, fmt, intent, "missing intent argument");
+            return;
+        }
+        const results = search(intent, top);
+        const filtered = results.filter((r) => r.score > SCORE_FLOOR);
+        if (filtered.length === 0) {
+            emitEmpty(startedAt, fmt, intent, "no adapter scored above the floor");
+            return;
+        }
+        const matches = filtered.map((r) => {
+            const m = {
+                site: r.site,
+                command: r.command,
+                score: round(r.score, 4),
+                description: r.description,
+                category: r.category,
+            };
+            if (includeSchema) {
+                const resolved = resolveCommand(r.site, r.command);
+                if (resolved) {
+                    const adapter = getAdapter(r.site);
+                    const desc = describeCommand(r.site, r.command, resolved.command, adapter);
+                    const argsSchema = desc.args_schema;
+                    const example = desc.example_stdin;
+                    if (argsSchema !== undefined)
+                        m.args_schema = argsSchema;
+                    if (example !== undefined)
+                        m.example_stdin = example;
+                }
+            }
+            return m;
+        });
+        const best = matches[0];
+        const data = {
+            intent,
+            match: best
+                ? {
+                    site: best.site,
+                    command: best.command,
+                    score: best.score,
+                    category: best.category,
+                    description: best.description,
+                    invocation: `unicli ${best.site} ${best.command}`,
+                }
+                : null,
+            candidates: matches,
+        };
+        const ctx = {
+            command: "core.do",
+            duration_ms: Date.now() - startedAt,
+            surface: "web",
+            next_actions: best ? successNextActions(intent, best, matches) : [],
+        };
+        console.log(format(data, undefined, fmt, ctx));
+    });
+}
+// ── helpers ──────────────────────────────────────────────────────────────────
+const TOP_HARD_LIMIT = 25;
+/**
+ * Parse `--top`. Throws on invalid input — caller converts to an
+ * `invalid_input` envelope. Bad CLI input is a caller bug, not a system
+ * state to silently snap to a default (rule 02).
+ */
+function parseTop(raw) {
+    const n = Number(raw);
+    if (!Number.isFinite(n) || !Number.isInteger(n) || n <= 0) {
+        throw new Error(`--top must be a positive integer (got "${raw}")`);
+    }
+    if (n > TOP_HARD_LIMIT) {
+        throw new Error(`--top ${n} exceeds hard limit ${TOP_HARD_LIMIT}`);
+    }
+    return n;
+}
+function round(n, digits) {
+    const m = 10 ** digits;
+    return Math.round(n * m) / m;
+}
+function successNextActions(intent, best, matches) {
+    const actions = [];
+    // Primary: invoke the top match
+    const params = argsSchemaToParams(best.args_schema);
+    actions.push({
+        command: `unicli ${best.site} ${best.command}`,
+        description: `Invoke the top-scored match (${best.score})`,
+        ...(params ? { params } : {}),
+    });
+    // Schema introspection
+    actions.push({
+        command: `unicli describe ${best.site} ${best.command}`,
+        description: "Read the full schema, channels, and example payload",
+    });
+    // Stdin-JSON channel for payloads with quoting hazards
+    actions.push({
+        command: `echo '{}' | unicli ${best.site} ${best.command}`,
+        description: "Stdin-JSON channel — use when params contain quotes/emoji/JSON",
+    });
+    // Surface a runner-up if it scored close to the top
+    if (matches.length > 1 &&
+        matches[1] &&
+        matches[1].score >= best.score * 0.7) {
+        const runner = matches[1];
+        actions.push({
+            command: `unicli ${runner.site} ${runner.command}`,
+            description: `Runner-up (score ${runner.score}) — consider if top match misreads intent`,
+        });
+    }
+    // Broaden if the agent wants the full ranked list
+    actions.push({
+        command: `unicli search "${intent}"`,
+        description: "List all matching candidates with scores",
+    });
+    return actions;
+}
+/**
+ * Walk a JSON-schema args object and produce AgentNextActionParam hints —
+ * we surface the description and the closed-set `enum` when present so the
+ * agent fills the template without re-reading docs.
+ */
+function argsSchemaToParams(schema) {
+    if (schema === undefined)
+        return undefined;
+    if (typeof schema === "string")
+        return undefined;
+    const properties = schema.properties ?? undefined;
+    if (!properties)
+        return undefined;
+    const out = {};
+    for (const [name, prop] of Object.entries(properties)) {
+        const param = {};
+        if (typeof prop.description === "string") {
+            param.description = prop.description;
+        }
+        if (Array.isArray(prop.enum) &&
+            prop.enum.every((v) => typeof v === "string" || typeof v === "number")) {
+            param.enum = prop.enum;
+        }
+        if (prop.default !== undefined &&
+            (typeof prop.default === "string" ||
+                typeof prop.default === "number" ||
+                typeof prop.default === "boolean")) {
+            param.default = prop.default;
+        }
+        if (Object.keys(param).length > 0) {
+            out[name] = param;
+        }
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function emitEmpty(startedAt, fmt, intent, reason) {
+    const ctx = {
+        command: "core.do",
+        duration_ms: Date.now() - startedAt,
+        surface: "web",
+        next_actions: [
+            {
+                command: `unicli search "${intent || "<query>"}"`,
+                description: "Broaden the query — list all candidates with scores",
+            },
+            {
+                command: `unicli describe`,
+                description: "Browse the site index for the right vertical",
+            },
+        ],
+        error: {
+            code: "empty_result",
+            message: `No adapter matched intent: ${reason}`,
+            retryable: false,
+            suggestion: "Use simpler keywords or run `unicli describe` to see the full catalogue",
+        },
+    };
+    process.exitCode = 66;
+    console.log(format(null, undefined, fmt, ctx));
+}
+function emitInvalidInput(startedAt, fmt, intent, message, suggestion) {
+    const ctx = {
+        command: "core.do",
+        duration_ms: Date.now() - startedAt,
+        surface: "web",
+        next_actions: [
+            {
+                command: `unicli search "${intent || "<query>"}"`,
+                description: "List all candidates without --top constraints",
+            },
+        ],
+        error: {
+            code: "invalid_input",
+            message,
+            retryable: false,
+            suggestion,
+        },
+    };
+    process.exitCode = 2;
+    console.log(format(null, undefined, fmt, ctx));
+}
+//# sourceMappingURL=do.js.map

package/dist/commands/do.js.map

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

package/dist/commands/extract.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @owner        src/commands/extract.ts
+ * @does         One-shot URL → cleaned Markdown/text/HTML extraction without
+ *               adapter awareness. Stateless agent verb: fetch + render in a
+ *               single CLI call, no browser session, no auth, no pipeline
+ *               composition required.
+ * @needs        turndown, commander, src/engine/ssrf, src/engine/proxy,
+ *               src/output/{envelope,formatter}, src/constants
+ * @feeds        src/cli.ts agent entrypoint; agents that want "fetch this URL
+ *               as Markdown" without composing a fetch_text + html_to_md
+ *               pipeline themselves.
+ * @breaks       Emits structured envelopes. Codes:
+ *                 invalid_input    — non-http(s) URL, SSRF block, body cap
+ *                 not_found        — 404
+ *                 auth_required    — 401/403
+ *                 rate_limited     — 429
+ *                 api_error        — other 4xx
+ *                 upstream_error   — 5xx
+ *                 network_error    — DNS/TCP/TLS failure or timeout
+ *               Each error envelope carries next_actions with a retry hint,
+ *               a `describe` link, and a `do` link.
+ * @invariants   Truncates rendered content at --max-chars; never holds more
+ *               than HARD_MAX_BYTES of upstream body in memory.
+ * @side-effects HTTP GET to user-supplied URL with proxy if configured.
+ *               No local filesystem writes.
+ * @perf         O(N) in body bytes for Turndown; N capped by HARD_MAX_BYTES.
+ * @concurrency  Pure async; no shared state.
+ * @test         tests/unit/commands/extract.test.ts
+ * @stability    experimental
+ * @since        2026-05-18
+ */
+import { Command } from "commander";
+export declare function registerExtractCommand(program: Command): void;
+//# sourceMappingURL=extract.d.ts.map

package/dist/commands/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/commands/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiL7D"}

package/dist/commands/extract.js

@@ -0,0 +1,316 @@
+/**
+ * @owner        src/commands/extract.ts
+ * @does         One-shot URL → cleaned Markdown/text/HTML extraction without
+ *               adapter awareness. Stateless agent verb: fetch + render in a
+ *               single CLI call, no browser session, no auth, no pipeline
+ *               composition required.
+ * @needs        turndown, commander, src/engine/ssrf, src/engine/proxy,
+ *               src/output/{envelope,formatter}, src/constants
+ * @feeds        src/cli.ts agent entrypoint; agents that want "fetch this URL
+ *               as Markdown" without composing a fetch_text + html_to_md
+ *               pipeline themselves.
+ * @breaks       Emits structured envelopes. Codes:
+ *                 invalid_input    — non-http(s) URL, SSRF block, body cap
+ *                 not_found        — 404
+ *                 auth_required    — 401/403
+ *                 rate_limited     — 429
+ *                 api_error        — other 4xx
+ *                 upstream_error   — 5xx
+ *                 network_error    — DNS/TCP/TLS failure or timeout
+ *               Each error envelope carries next_actions with a retry hint,
+ *               a `describe` link, and a `do` link.
+ * @invariants   Truncates rendered content at --max-chars; never holds more
+ *               than HARD_MAX_BYTES of upstream body in memory.
+ * @side-effects HTTP GET to user-supplied URL with proxy if configured.
+ *               No local filesystem writes.
+ * @perf         O(N) in body bytes for Turndown; N capped by HARD_MAX_BYTES.
+ * @concurrency  Pure async; no shared state.
+ * @test         tests/unit/commands/extract.test.ts
+ * @stability    experimental
+ * @since        2026-05-18
+ */
+import TurndownService from "turndown";
+import { assertSafeRequestUrl } from "../engine/ssrf.js";
+import { getProxyAgent } from "../engine/proxy.js";
+import { USER_AGENT } from "../constants.js";
+import { format, detectFormat } from "../output/formatter.js";
+const DEFAULT_MAX_CHARS = 50_000;
+const HARD_MAX_BYTES = 5_000_000;
+export function registerExtractCommand(program) {
+    program
+        .command("extract <url>")
+        .description("Fetch a URL and return cleaned Markdown (one-shot, no browser/auth)")
+        .option("--max-chars <n>", `Truncate rendered content at N chars (default ${DEFAULT_MAX_CHARS})`, String(DEFAULT_MAX_CHARS))
+        .option("--as <format>", "Render content as markdown|text|html (default markdown)", "markdown")
+        .action(async (url, opts) => {
+        const startedAt = Date.now();
+        const fmt = detectFormat(program.opts().format);
+        let maxChars;
+        try {
+            maxChars = parseMaxChars(opts.maxChars);
+        }
+        catch (e) {
+            emitError(baseCtx(startedAt), {
+                code: "invalid_input",
+                message: e instanceof Error ? e.message : "invalid --max-chars value",
+                suggestion: `Pass a positive integer up to ${MAX_CHARS_HARD_LIMIT}`,
+                retryable: false,
+            }, fmt, url);
+            return;
+        }
+        const renderAs = parseExtractFormat(opts.as);
+        try {
+            assertSafeRequestUrl(url);
+        }
+        catch (e) {
+            emitError(baseCtx(startedAt), {
+                code: "invalid_input",
+                message: e instanceof Error ? e.message : "URL failed safety validation",
+                suggestion: "Use an http(s) URL; loopback / link-local / private ranges are blocked",
+                retryable: false,
+            }, fmt, url);
+            return;
+        }
+        let html;
+        let httpStatus = 0;
+        try {
+            const init = {
+                method: "GET",
+                headers: { "User-Agent": USER_AGENT },
+            };
+            const agent = getProxyAgent();
+            if (agent)
+                init.dispatcher = agent;
+            const resp = await fetch(url, init);
+            httpStatus = resp.status;
+            if (!resp.ok) {
+                emitError(baseCtx(startedAt), {
+                    code: mapStatus(resp.status),
+                    message: `HTTP ${resp.status} ${resp.statusText} from ${url}`,
+                    suggestion: resp.status >= 500
+                        ? "Upstream 5xx — retry after a short delay"
+                        : resp.status === 429
+                            ? "Rate-limited — back off and retry"
+                            : resp.status === 401 || resp.status === 403
+                                ? "Authenticated endpoint — try `unicli auth setup <site>`"
+                                : `Check that ${url} is the canonical URL`,
+                    retryable: resp.status >= 500 || resp.status === 429,
+                }, fmt, url);
+                return;
+            }
+            const lenHeader = resp.headers.get("content-length");
+            if (lenHeader && Number(lenHeader) > HARD_MAX_BYTES) {
+                emitError(baseCtx(startedAt), {
+                    // REASON: oversized upstream payload is an upstream property,
+                    // not caller error — surface as `upstream_error` (exit 69) so
+                    // agent retry policy knows the URL itself cannot be re-fetched
+                    // smaller. retryable=false because shrink-on-retry is unlikely.
+                    code: "upstream_error",
+                    message: `Content-Length ${lenHeader} exceeds hard cap ${HARD_MAX_BYTES}`,
+                    suggestion: "Target a smaller URL or use a streaming adapter via `unicli search`",
+                    retryable: false,
+                }, fmt, url);
+                return;
+            }
+            html = await resp.text();
+            if (html.length > HARD_MAX_BYTES) {
+                html = html.slice(0, HARD_MAX_BYTES);
+            }
+        }
+        catch (e) {
+            emitError(baseCtx(startedAt), {
+                code: "network_error",
+                message: e instanceof Error ? e.message : String(e),
+                suggestion: `Network fetch failed for ${url} — verify connectivity`,
+                retryable: true,
+            }, fmt, url);
+            return;
+        }
+        let content;
+        if (renderAs === "markdown") {
+            const turndown = new TurndownService({
+                headingStyle: "atx",
+                codeBlockStyle: "fenced",
+            });
+            content = turndown.turndown(html);
+        }
+        else if (renderAs === "text") {
+            content = stripTags(html);
+        }
+        else {
+            content = html;
+        }
+        const originalLength = content.length;
+        const truncated = originalLength > maxChars;
+        if (truncated)
+            content = content.slice(0, maxChars);
+        const ctx = {
+            command: "core.extract",
+            duration_ms: Date.now() - startedAt,
+            surface: "web",
+            next_actions: successNextActions(url, renderAs, truncated, originalLength),
+        };
+        const data = {
+            url,
+            format: renderAs,
+            http_status: httpStatus,
+            length: content.length,
+            original_length: originalLength,
+            truncated,
+            content,
+        };
+        console.log(format(data, undefined, fmt, ctx));
+    });
+}
+// ── helpers ──────────────────────────────────────────────────────────────────
+function baseCtx(startedAt) {
+    return {
+        command: "core.extract",
+        duration_ms: Date.now() - startedAt,
+        surface: "web",
+    };
+}
+/**
+ * Parse `--max-chars`. Throws on invalid input — caller is responsible for
+ * converting the throw into a structured `invalid_input` envelope. This is
+ * the rule-02 contract: bad CLI input is a caller bug, not a system state
+ * to silently recover from.
+ */
+const MAX_CHARS_HARD_LIMIT = 1_000_000;
+function parseMaxChars(raw) {
+    const n = Number(raw);
+    if (!Number.isFinite(n) || !Number.isInteger(n) || n <= 0) {
+        throw new Error(`--max-chars must be a positive integer (got "${raw}")`);
+    }
+    if (n > MAX_CHARS_HARD_LIMIT) {
+        throw new Error(`--max-chars ${n} exceeds hard limit ${MAX_CHARS_HARD_LIMIT}`);
+    }
+    return n;
+}
+function parseExtractFormat(raw) {
+    const v = raw.toLowerCase();
+    if (v === "text" || v === "txt" || v === "plain")
+        return "text";
+    if (v === "html" || v === "raw")
+        return "html";
+    return "markdown";
+}
+function mapStatus(status) {
+    if (status === 404)
+        return "not_found";
+    if (status === 401 || status === 403)
+        return "auth_required";
+    if (status === 429)
+        return "rate_limited";
+    if (status >= 500)
+        return "upstream_error";
+    return "api_error";
+}
+// REASON: intentionally minimal HTML stripper for `--as text` mode. Strips
+// scripts, styles, tags, and 5 common entities. Does NOT handle CDATA,
+// HTML comments, numeric character references, or HTML5 `<template>` —
+// agents post-process the output anyway. NOT a safe-HTML sanitizer.
+function stripTags(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function successNextActions(url, as, truncated, originalLength) {
+    const actions = [];
+    if (truncated) {
+        const fullCap = Math.min(originalLength, 1_000_000);
+        actions.push({
+            command: `unicli extract ${url} --max-chars ${fullCap}`,
+            description: `Re-extract with larger limit (full rendered length ${originalLength})`,
+            params: {
+                "max-chars": {
+                    value: fullCap,
+                    description: "Truncation cap in characters",
+                },
+            },
+        });
+    }
+    if (as !== "text") {
+        actions.push({
+            command: `unicli extract ${url} --as text`,
+            description: "Re-extract as plain text (no Markdown formatting)",
+        });
+    }
+    if (as !== "html") {
+        actions.push({
+            command: `unicli extract ${url} --as html`,
+            description: "Re-extract as raw HTML (no cleaning)",
+        });
+    }
+    actions.push({
+        command: `unicli do "<natural-language intent>"`,
+        description: "Route a natural-language intent to the best-matching adapter (e.g. structured site fetch instead of a raw URL)",
+    });
+    return actions;
+}
+function errorNextActions(url, errCode) {
+    const actions = [
+        {
+            command: `unicli extract ${url}`,
+            description: "Retry the same extraction",
+        },
+    ];
+    if (errCode === "auth_required") {
+        actions.push({
+            command: `unicli auth setup <site>`,
+            description: "Authenticate before retrying",
+            params: {
+                site: {
+                    description: "Short site name (e.g. `twitter`, `github`)",
+                },
+            },
+        });
+    }
+    if (errCode === "not_found" ||
+        errCode === "api_error" ||
+        errCode === "invalid_input") {
+        actions.push({
+            command: `unicli do "<natural-language intent>"`,
+            description: "Try a structured adapter instead of a raw URL fetch",
+        });
+    }
+    actions.push({
+        command: `unicli describe`,
+        description: "Inspect available commands and adapters",
+    });
+    return actions;
+}
+function emitError(baseCtxValue, err, fmt, url) {
+    const ctx = {
+        ...baseCtxValue,
+        next_actions: errorNextActions(url, err.code),
+        error: err,
+    };
+    process.exitCode = mapExitCode(err.code);
+    console.log(format(null, undefined, fmt, ctx));
+}
+function mapExitCode(code) {
+    switch (code) {
+        case "auth_required":
+            return 77;
+        case "rate_limited":
+        case "network_error":
+            return 75;
+        case "upstream_error":
+            return 69;
+        case "not_found":
+        case "invalid_input":
+            return 2;
+        default:
+            return 1;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/commands/extract.js.map

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