@zenalexa/unicli 0.210.0 → 0.212.1

package/dist/commands/lint.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `unicli lint [path]` — minimal schema-v2 lint engine.
+ *
+ * Four checks, all static (no network):
+ *
+ *   1. Every YAML adapter parses and matches schema-v2 shape.
+ *   2. Every step name in every `pipeline` is in the known-steps registry.
+ *   3. No cycles in nested `if` / `each` sub-pipelines (BFS visit).
+ *   4. Quarantined adapters (quarantine: true) must carry a non-empty
+ *      `quarantineReason`.
+ *
+ * Non-zero exit on any failure so CI can gate. `--json` emits a
+ * structured report for agents.
+ */
+import { Command } from "commander";
+export interface LintIssue {
+    file: string;
+    severity: "error" | "warning";
+    rule: string;
+    message: string;
+}
+export interface LintReport {
+    scanned: number;
+    passed: number;
+    failed: number;
+    warnings: number;
+    issues: LintIssue[];
+}
+export declare function lintAdapterFile(filePath: string): LintIssue[];
+export declare function lintPath(target: string): LintReport;
+export declare function registerLintCommand(program: Command): void;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmHpC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAkGD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAmJ7D;AA2BD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAoBnD;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C1D"}

package/dist/commands/lint.js

@@ -0,0 +1,377 @@
+/**
+ * `unicli lint [path]` — minimal schema-v2 lint engine.
+ *
+ * Four checks, all static (no network):
+ *
+ *   1. Every YAML adapter parses and matches schema-v2 shape.
+ *   2. Every step name in every `pipeline` is in the known-steps registry.
+ *   3. No cycles in nested `if` / `each` sub-pipelines (BFS visit).
+ *   4. Quarantined adapters (quarantine: true) must carry a non-empty
+ *      `quarantineReason`.
+ *
+ * Non-zero exit on any failure so CI can gate. `--json` emits a
+ * structured report for agents.
+ */
+import chalk from "chalk";
+import yaml from "js-yaml";
+import { readdirSync, readFileSync, statSync, existsSync } from "node:fs";
+import { join, extname, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ExitCode } from "../types.js";
+import { AdapterTrustSchema, AdapterConfidentialitySchema, } from "../core/schema-v2.js";
+// ── Known step registry ─────────────────────────────────────────────────
+//
+// Source of truth is the switch in src/engine/yaml-runner.ts. Keep this
+// list in lock-step; see contributing/schema.md for the protocol.
+const KNOWN_STEPS = new Set([
+    // API
+    "fetch",
+    "fetch_text",
+    "parse_rss",
+    "html_to_md",
+    // Transform
+    "select",
+    "map",
+    "filter",
+    "sort",
+    "limit",
+    // Desktop
+    "exec",
+    "write_temp",
+    // Browser
+    "navigate",
+    "evaluate",
+    "click",
+    "type",
+    "wait",
+    "intercept",
+    "press",
+    "scroll",
+    "snapshot",
+    "tap",
+    "extract",
+    // Media
+    "download",
+    "websocket",
+    // Control
+    "set",
+    "if",
+    "append",
+    "each",
+    "parallel",
+    "rate_limit",
+    "assert",
+    "retry",
+    // CUA (Phase 2 — pluggable VLM backend: anthropic/trycua/opencua/scrapybara)
+    "cua_snapshot",
+    "cua_click",
+    "cua_type",
+    "cua_key",
+    "cua_scroll",
+    "cua_drag",
+    "cua_wait",
+    "cua_assert",
+    "cua_ask",
+    "cua_backend",
+    "cua_launch",
+    // Desktop AX (Phase 2 — macOS Accessibility + AppleScript, stubs on win/linux)
+    "ax_focus",
+    "ax_menu_select",
+    "applescript",
+    "clipboard_read",
+    "clipboard_write",
+    "launch_app",
+    "focus_window",
+]);
+// Step keys that modify other keys rather than being executable themselves.
+// They count as metadata, not actions.
+const STEP_META_KEYS = new Set(["retry", "continue_on_error", "label"]);
+const VALID_TYPES = new Set([
+    "web-api",
+    "desktop",
+    "browser",
+    "bridge",
+    "service",
+]);
+const VALID_STRATEGIES = new Set([
+    "public",
+    "cookie",
+    "header",
+    "intercept",
+    "ui",
+]);
+// ── Step extraction ─────────────────────────────────────────────────────
+/**
+ * A pipeline step is a single-key object: `{ fetch: { url: ... } }`.
+ * Returns the action name (the key) excluding metadata siblings.
+ */
+function extractActionName(step) {
+    if (!step || typeof step !== "object" || Array.isArray(step))
+        return null;
+    const keys = Object.keys(step).filter((k) => !STEP_META_KEYS.has(k));
+    return keys[0] ?? null;
+}
+/**
+ * BFS walk of a pipeline tracking step-object identity to detect cycles.
+ * Returns `true` if any step object is reachable from itself.
+ *
+ * Cycles in native YAML trees are rare (`&anchor`/`*alias` can create
+ * them), but they would crash the runner. We catch them statically.
+ */
+function hasCycle(pipeline) {
+    const queue = [...pipeline];
+    const visited = new Set();
+    while (queue.length > 0) {
+        const step = queue.shift();
+        if (!step || typeof step !== "object")
+            continue;
+        if (visited.has(step))
+            return true;
+        visited.add(step);
+        // Drill into `if` and `each` sub-pipelines
+        const rec = step;
+        for (const key of ["if", "each"]) {
+            const config = rec[key];
+            if (!config || typeof config !== "object")
+                continue;
+            for (const branch of ["then", "else", "do"]) {
+                const sub = config[branch];
+                if (Array.isArray(sub))
+                    queue.push(...sub);
+            }
+        }
+        // `parallel` has `branches: [{ pipeline: [...] }, ...]`
+        const parallel = rec["parallel"];
+        if (parallel && typeof parallel === "object") {
+            const branches = parallel["branches"];
+            if (Array.isArray(branches)) {
+                for (const b of branches) {
+                    if (b && typeof b === "object") {
+                        const sub = b["pipeline"];
+                        if (Array.isArray(sub))
+                            queue.push(...sub);
+                    }
+                }
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Walk every step (including nested `if`/`each`/`parallel`) and yield
+ * each step's action name.
+ */
+function* walkStepNames(pipeline) {
+    const queue = [...pipeline];
+    while (queue.length > 0) {
+        const step = queue.shift();
+        const action = extractActionName(step);
+        if (action)
+            yield action;
+        if (!step || typeof step !== "object")
+            continue;
+        const rec = step;
+        for (const key of ["if", "each"]) {
+            const config = rec[key];
+            if (!config || typeof config !== "object")
+                continue;
+            for (const branch of ["then", "else", "do"]) {
+                const sub = config[branch];
+                if (Array.isArray(sub))
+                    queue.push(...sub);
+            }
+        }
+        const parallel = rec["parallel"];
+        if (parallel && typeof parallel === "object") {
+            const branches = parallel["branches"];
+            if (Array.isArray(branches)) {
+                for (const b of branches) {
+                    if (b && typeof b === "object") {
+                        const sub = b["pipeline"];
+                        if (Array.isArray(sub))
+                            queue.push(...sub);
+                    }
+                }
+            }
+        }
+    }
+}
+// ── Per-file linter ─────────────────────────────────────────────────────
+export function lintAdapterFile(filePath) {
+    const issues = [];
+    const add = (severity, rule, message) => issues.push({ file: filePath, severity, rule, message });
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        add("error", "read", `failed to read: ${err instanceof Error ? err.message : String(err)}`);
+        return issues;
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(raw);
+    }
+    catch (err) {
+        add("error", "parse", `invalid YAML: ${err instanceof Error ? err.message : String(err)}`);
+        return issues;
+    }
+    if (!parsed || typeof parsed !== "object") {
+        add("error", "parse", "top-level value must be an object");
+        return issues;
+    }
+    // schema-v2: required fields
+    if (typeof parsed.type === "string" && !VALID_TYPES.has(parsed.type)) {
+        add("error", "schema", `type must be one of ${[...VALID_TYPES].join(", ")}, got "${parsed.type}"`);
+    }
+    if (typeof parsed.strategy === "string" &&
+        !VALID_STRATEGIES.has(parsed.strategy)) {
+        add("error", "schema", `strategy must be one of ${[...VALID_STRATEGIES].join(", ")}, got "${parsed.strategy}"`);
+    }
+    // schema-v2: five required metadata fields
+    if (parsed.capabilities !== undefined &&
+        !Array.isArray(parsed.capabilities)) {
+        add("error", "schema-v2", "capabilities must be an array of strings");
+    }
+    else if (parsed.capabilities === undefined) {
+        add("error", "schema-v2", "missing required field: capabilities");
+    }
+    if (parsed.minimum_capability === undefined) {
+        add("error", "schema-v2", "missing required field: minimum_capability");
+    }
+    else if (typeof parsed.minimum_capability !== "string") {
+        add("error", "schema-v2", "minimum_capability must be a string");
+    }
+    if (parsed.trust === undefined) {
+        add("error", "schema-v2", "missing required field: trust");
+    }
+    else if (typeof parsed.trust !== "string" ||
+        !AdapterTrustSchema.safeParse(parsed.trust).success) {
+        add("error", "schema-v2", `trust must be one of public|user|system, got "${String(parsed.trust)}"`);
+    }
+    if (parsed.confidentiality === undefined) {
+        add("error", "schema-v2", "missing required field: confidentiality");
+    }
+    else if (typeof parsed.confidentiality !== "string" ||
+        !AdapterConfidentialitySchema.safeParse(parsed.confidentiality).success) {
+        add("error", "schema-v2", `confidentiality must be one of public|internal|private, got "${String(parsed.confidentiality)}"`);
+    }
+    if (parsed.quarantine === undefined) {
+        add("error", "schema-v2", "missing required field: quarantine");
+    }
+    // quarantine integrity
+    if (parsed.quarantine === true) {
+        if (typeof parsed.quarantineReason !== "string" ||
+            parsed.quarantineReason.trim().length === 0) {
+            add("error", "quarantine", "quarantine: true requires a non-empty quarantineReason");
+        }
+    }
+    else if (typeof parsed.quarantineReason === "string" &&
+        parsed.quarantineReason.length > 0) {
+        add("warning", "quarantine", "quarantineReason set without quarantine: true — ignored at load time");
+    }
+    // pipeline checks
+    if (parsed.pipeline !== undefined) {
+        if (!Array.isArray(parsed.pipeline)) {
+            add("error", "pipeline", "pipeline must be an array");
+        }
+        else {
+            if (parsed.pipeline.length === 0) {
+                add("warning", "pipeline", "pipeline is empty");
+            }
+            if (hasCycle(parsed.pipeline)) {
+                add("error", "cycle", "pipeline contains a structural cycle (YAML anchor/alias?)");
+            }
+            for (const action of walkStepNames(parsed.pipeline)) {
+                if (!KNOWN_STEPS.has(action)) {
+                    add("error", "unknown-step", `unknown pipeline step: "${action}"`);
+                }
+            }
+        }
+    }
+    return issues;
+}
+// ── Directory walk ──────────────────────────────────────────────────────
+function* walkYaml(path) {
+    const st = statSync(path);
+    if (st.isFile()) {
+        if (extname(path) === ".yaml" || extname(path) === ".yml") {
+            yield path;
+        }
+        return;
+    }
+    for (const entry of readdirSync(path)) {
+        if (entry.startsWith(".") || entry.startsWith("_"))
+            continue;
+        yield* walkYaml(join(path, entry));
+    }
+}
+function resolveTarget(arg) {
+    if (arg)
+        return resolve(arg);
+    // Default: src/adapters relative to cwd (falls back to package-root).
+    const cwdTarget = resolve("src/adapters");
+    if (existsSync(cwdTarget))
+        return cwdTarget;
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    return resolve(__dirname, "..", "adapters");
+}
+export function lintPath(target) {
+    const report = {
+        scanned: 0,
+        passed: 0,
+        failed: 0,
+        warnings: 0,
+        issues: [],
+    };
+    for (const file of walkYaml(target)) {
+        report.scanned++;
+        const issues = lintAdapterFile(file);
+        const hasError = issues.some((i) => i.severity === "error");
+        if (hasError)
+            report.failed++;
+        else
+            report.passed++;
+        report.warnings += issues.filter((i) => i.severity === "warning").length;
+        report.issues.push(...issues);
+    }
+    return report;
+}
+// ── Command registration ────────────────────────────────────────────────
+export function registerLintCommand(program) {
+    program
+        .command("lint [path]")
+        .description("Static lint for YAML adapters (schema-v2, known steps)")
+        .option("--json", "emit a structured JSON report")
+        .action((path, opts) => {
+        const target = resolveTarget(path);
+        if (!existsSync(target)) {
+            console.error(chalk.red(`lint target not found: ${target}`));
+            process.exit(ExitCode.CONFIG_ERROR);
+        }
+        const report = lintPath(target);
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            const header = `unicli lint: ${report.scanned} adapters scanned in ${target}`;
+            console.log(chalk.bold(header));
+            if (report.issues.length === 0) {
+                console.log(chalk.green(`  ${report.passed} passed`));
+            }
+            else {
+                for (const issue of report.issues) {
+                    const badge = issue.severity === "error"
+                        ? chalk.red("error")
+                        : chalk.yellow("warn");
+                    console.log(`  ${badge} [${issue.rule}] ${issue.file}: ${issue.message}`);
+                }
+                console.log(`\n  ${chalk.green(`${report.passed} passed`)}, ${chalk.red(`${report.failed} failed`)}, ${chalk.yellow(`${report.warnings} warnings`)}`);
+            }
+        }
+        if (report.failed > 0) {
+            process.exit(ExitCode.GENERIC_ERROR);
+        }
+    });
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/commands/mcp.d.ts

@@ -1,15 +1,14 @@
 /**
  * MCP gateway CLI — wrapper around src/mcp/server.ts.
  *
- *   unicli mcp serve [--transport stdio|http] [--port 19826] [--lazy]
- *   unicli mcp health                       # list registered tools (no server)
+ *   unicli mcp serve [--transport stdio|http] [--port 19826] [--expanded]
+ *   unicli mcp health                       # pre-flight check (no server)
  *
  * `serve` shells out to the same `src/mcp/server.ts` entry point as
  * `npm run mcp` so the two paths share exactly one implementation.
  *
  * `health` is intentionally fast and offline: it loads adapters into the
- * registry and prints the same tool list the server would build, without
- * binding stdio or HTTP. Useful as a Claude Desktop / Cursor pre-flight.
+ * registry and prints a structured health report. Exit 0 if healthy, 1 if not.
  */
 import type { Command } from "commander";
 export declare function registerMcpCommand(program: Command): void;

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

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+GzD"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiHzD"}

package/dist/commands/mcp.js

@@ -1,15 +1,14 @@
 /**
  * MCP gateway CLI — wrapper around src/mcp/server.ts.
  *
- *   unicli mcp serve [--transport stdio|http] [--port 19826] [--lazy]
- *   unicli mcp health                       # list registered tools (no server)
+ *   unicli mcp serve [--transport stdio|http] [--port 19826] [--expanded]
+ *   unicli mcp health                       # pre-flight check (no server)
  *
  * `serve` shells out to the same `src/mcp/server.ts` entry point as
  * `npm run mcp` so the two paths share exactly one implementation.
  *
  * `health` is intentionally fast and offline: it loads adapters into the
- * registry and prints the same tool list the server would build, without
- * binding stdio or HTTP. Useful as a Claude Desktop / Cursor pre-flight.
+ * registry and prints a structured health report. Exit 0 if healthy, 1 if not.
  */
 import chalk from "chalk";
 import { spawn } from "node:child_process";
@@ -26,14 +25,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
  * stable relative position from this commands file.
  */
 function resolveServerEntry() {
-    // After build: __dirname is dist/commands → ../mcp/server.js
-    // In dev (tsx): __dirname is src/commands  → ../mcp/server.ts
     const candidateJs = join(__dirname, "..", "mcp", "server.js");
     const candidateTs = join(__dirname, "..", "mcp", "server.ts");
-    // Prefer TS if it exists (dev mode); otherwise JS.
-    // We can't easily statSync here without importing fs, but join + spawn will
-    // surface the error if neither exists. Use TS by default in dev.
-    // The simpler heuristic: if __dirname contains "/dist/", we're built.
     if (__dirname.includes("/dist/")) {
         return { kind: "js", path: candidateJs };
     }
@@ -48,16 +41,12 @@ export function registerMcpCommand(program) {
         .description("Start the MCP server (stdio default, --transport http for HTTP/JSON-RPC)")
         .option("--transport <kind>", "stdio or http", "stdio")
         .option("--port <n>", "Port for http transport", "19826")
-        .option("--lazy", "Register only list_adapters + run_command (compat mode)")
+        .option("--expanded", "Register one tool per adapter command (full catalog)")
         .action((opts) => {
         const entry = resolveServerEntry();
-        const args = [];
-        if (entry.kind === "ts")
-            args.unshift(entry.path);
-        else
-            args.unshift(entry.path);
-        if (opts.lazy)
-            args.push("--lazy");
+        const args = [entry.path];
+        if (opts.expanded)
+            args.push("--expanded");
         if (opts.transport) {
             args.push("--transport", opts.transport);
         }
@@ -81,55 +70,51 @@ export function registerMcpCommand(program) {
     });
     mcp
         .command("health")
-        .description("Pre-flight check — list tools the MCP server would expose")
-        .option("--json", "Output as JSON")
+        .description("Pre-flight check — verify adapters load and report tool counts")
+        .option("--json", "Output as JSON (default when piped)")
         .action(async (opts) => {
-        // Load adapters into the registry the same way the server does
-        loadAllAdapters();
-        await loadTsAdapters();
-        const adapters = getAllAdapters();
-        const commands = listCommands();
-        const tools = [
-            {
-                name: "list_adapters",
-                description: "List all Uni-CLI adapters and their commands",
-            },
-        ];
-        for (const adapter of adapters) {
-            for (const [cmdName, cmd] of Object.entries(adapter.commands)) {
-                const toolName = `unicli_${adapter.name}_${cmdName}`.replace(/[^a-zA-Z0-9_]/g, "_");
-                tools.push({
-                    name: toolName,
-                    description: cmd.description?.trim() ||
-                        adapter.description?.trim() ||
-                        `${cmdName} for ${adapter.name}`,
-                });
+        const useJson = opts.json || !process.stdout.isTTY;
+        try {
+            // Load adapters into the registry the same way the server does
+            loadAllAdapters();
+            await loadTsAdapters();
+            const adapters = getAllAdapters();
+            const commands = listCommands();
+            // Count expanded tools (1 per command + 3 default)
+            let expandedToolCount = 3; // unicli_run, unicli_list, unicli_discover
+            for (const adapter of adapters) {
+                expandedToolCount += Object.keys(adapter.commands).length;
             }
-        }
-        if (opts.json) {
-            console.log(JSON.stringify({
-                version: VERSION,
-                sites: adapters.length,
+            const health = {
+                status: "ok",
+                adapters: adapters.length,
                 commands: commands.length,
-                tools: tools.length,
-                entries: tools,
-            }, null, 2));
-            return;
-        }
-        console.log(chalk.bold(`unicli MCP gateway v${VERSION}`));
-        console.log(`  sites:    ${chalk.green(adapters.length)}`);
-        console.log(`  commands: ${chalk.green(commands.length)}`);
-        console.log(`  tools:    ${chalk.green(tools.length)} (1 core + ${commands.length} per-command)`);
-        console.log();
-        console.log(chalk.dim("Sample tools:"));
-        for (const t of tools.slice(0, 8)) {
-            console.log(`  ${chalk.cyan(t.name)}: ${t.description.slice(0, 60)}`);
+                tools: { default: 3, expanded: expandedToolCount },
+                version: VERSION,
+            };
+            if (useJson) {
+                console.log(JSON.stringify(health, null, 2));
+                return;
+            }
+            console.log(chalk.bold(`unicli MCP health v${VERSION}`));
+            console.log(`  status:   ${chalk.green("ok")}`);
+            console.log(`  adapters: ${chalk.green(adapters.length)}`);
+            console.log(`  commands: ${chalk.green(commands.length)}`);
+            console.log(`  tools:    ${chalk.green("3")} default, ${chalk.green(expandedToolCount)} expanded`);
+            console.log();
+            console.log(chalk.dim("Default tools: unicli_run, unicli_list, unicli_discover"));
+            console.log(chalk.dim("To start: unicli mcp serve [--expanded] [--transport http]"));
         }
-        if (tools.length > 8) {
-            console.log(chalk.dim(`  … and ${tools.length - 8} more`));
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (useJson) {
+                console.log(JSON.stringify({ status: "error", error: message, version: VERSION }, null, 2));
+            }
+            else {
+                console.error(chalk.red(`Health check failed: ${message}`));
+            }
+            process.exit(1);
         }
-        console.log();
-        console.log(chalk.dim("To start: unicli mcp serve [--transport http]"));
     });
 }
 //# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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