@zenalexa/unicli 0.207.1

package/dist/discovery/loader.js

@@ -0,0 +1,155 @@
+/**
+ * Adapter loader — discovers and registers YAML + TS adapters.
+ *
+ * Scan order:
+ *   1. Built-in adapters from src/adapters/
+ *   2. User adapters from ~/.unicli/adapters/
+ *   3. Plugin adapters from ~/.unicli/plugins/
+ */
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { join, extname, basename, dirname } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import yaml from "js-yaml";
+import { registerAdapter } from "../registry.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const BUILTIN_DIR = join(__dirname, "..", "adapters");
+const USER_DIR = join(process.env.HOME ?? "~", ".unicli", "adapters");
+/** Load all adapters from a directory */
+export function loadAdaptersFromDir(dir) {
+    if (!existsSync(dir))
+        return 0;
+    let count = 0;
+    for (const site of readdirSync(dir)) {
+        if (site.startsWith("_") || site.startsWith("."))
+            continue;
+        const siteDir = join(dir, site);
+        if (!statSync(siteDir).isDirectory())
+            continue;
+        const commands = {};
+        let siteType = "web-api";
+        let siteMeta = {};
+        for (const file of readdirSync(siteDir)) {
+            const ext = extname(file);
+            const cmdName = basename(file, ext);
+            if (ext === ".yaml" || ext === ".yml") {
+                let parsed;
+                try {
+                    const raw = readFileSync(join(siteDir, file), "utf-8");
+                    parsed = yaml.load(raw);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (process.env.UNICLI_DEBUG) {
+                        console.error(`Warning: Failed to parse ${join(siteDir, file)}: ${msg}`);
+                    }
+                    continue;
+                }
+                if (parsed.type)
+                    siteType = parsed.type;
+                if (parsed.domain)
+                    siteMeta.domain = parsed.domain;
+                if (parsed.strategy)
+                    siteMeta.strategy = parsed.strategy;
+                if (parsed.browser !== undefined)
+                    siteMeta.browser = parsed.browser;
+                if (parsed.binary)
+                    siteMeta.binary = parsed.binary;
+                if (parsed.base)
+                    siteMeta.base = parsed.base;
+                if (parsed.detect)
+                    siteMeta.detect = parsed.detect;
+                if (parsed.auth)
+                    siteMeta.auth = parsed.auth;
+                if (parsed.autoInstall)
+                    siteMeta.autoInstall = parsed.autoInstall;
+                if (parsed.passthrough !== undefined)
+                    siteMeta.passthrough = parsed.passthrough;
+                if (parsed.auth_cookies)
+                    siteMeta.authCookies = parsed.auth_cookies;
+                // Parse args from YAML into AdapterArg[]
+                let adapterArgs;
+                if (parsed.args) {
+                    adapterArgs = Object.entries(parsed.args).map(([argName, argDef]) => ({
+                        name: argName,
+                        type: argDef.type ?? "str",
+                        default: argDef.default,
+                        required: argDef.required ?? false,
+                        positional: argDef.positional ?? false,
+                        choices: argDef.choices,
+                        description: argDef.description,
+                    }));
+                }
+                commands[cmdName] = {
+                    name: cmdName,
+                    description: parsed.description,
+                    pipeline: parsed.pipeline,
+                    adapterArgs,
+                    columns: parsed.columns,
+                    method: parsed.method,
+                    path: parsed.path,
+                    url: parsed.url,
+                    params: parsed.params,
+                    navigate: parsed.navigate,
+                    wait: parsed.wait,
+                    extract: parsed.extract,
+                    execArgs: parsed.execArgs,
+                };
+                count++;
+            }
+        }
+        if (Object.keys(commands).length > 0) {
+            registerAdapter({
+                name: site,
+                type: siteType,
+                commands,
+                ...siteMeta,
+            });
+        }
+    }
+    return count;
+}
+/** Collect TS adapter files from a directory for dynamic import */
+function collectTsFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    const files = [];
+    for (const site of readdirSync(dir)) {
+        if (site.startsWith("_") || site.startsWith("."))
+            continue;
+        const siteDir = join(dir, site);
+        if (!statSync(siteDir).isDirectory())
+            continue;
+        for (const file of readdirSync(siteDir)) {
+            if (extname(file) === ".ts" && !file.endsWith(".test.ts")) {
+                files.push(join(siteDir, file));
+            }
+        }
+    }
+    return files;
+}
+/** Load all adapters: built-in YAML → user YAML → TS adapters (async) */
+export function loadAllAdapters() {
+    let total = 0;
+    total += loadAdaptersFromDir(BUILTIN_DIR);
+    total += loadAdaptersFromDir(USER_DIR);
+    return total;
+}
+/** Load TS adapters that self-register via cli() */
+export async function loadTsAdapters() {
+    const files = [...collectTsFiles(BUILTIN_DIR), ...collectTsFiles(USER_DIR)];
+    let count = 0;
+    for (const file of files) {
+        try {
+            await import(pathToFileURL(file).href);
+            count++;
+        }
+        catch (err) {
+            if (process.env.UNICLI_DEBUG) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`Warning: Failed to import ${file}: ${msg}`);
+            }
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=loader.js.map

package/dist/discovery/loader.js.map

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

package/dist/electron-apps.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Electron app registry — known Electron apps with CDP debug ports.
+ *
+ * Each app gets a unique CDP port for parallel debugging.
+ * Users can extend via ~/.unicli/apps.yaml (additive only).
+ */
+export interface ElectronAppEntry {
+    port: number;
+    processName: string;
+    executableNames?: string[];
+    bundleId?: string;
+    displayName?: string;
+    extraArgs?: string[];
+}
+/**
+ * Get all known Electron apps (builtins + user extensions).
+ * User apps from ~/.unicli/apps.yaml are additive only — cannot override builtins.
+ */
+export declare function getElectronApps(): Record<string, ElectronAppEntry>;
+/**
+ * Look up an Electron app by site name.
+ */
+export declare function getElectronApp(site: string): ElectronAppEntry | null;
+/**
+ * Check if a site is a known Electron app.
+ */
+export declare function isElectronApp(site: string): boolean;
+//# sourceMappingURL=electron-apps.d.ts.map

package/dist/electron-apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron-apps.d.ts","sourceRoot":"","sources":["../src/electron-apps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAwDD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAwBlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/electron-apps.js

@@ -0,0 +1,101 @@
+/**
+ * Electron app registry — known Electron apps with CDP debug ports.
+ *
+ * Each app gets a unique CDP port for parallel debugging.
+ * Users can extend via ~/.unicli/apps.yaml (additive only).
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import yaml from "js-yaml";
+const BUILTIN_APPS = {
+    cursor: {
+        port: 9226,
+        processName: "Cursor",
+        bundleId: "com.todesktop.runtime.Cursor",
+        displayName: "Cursor",
+    },
+    codex: {
+        port: 9222,
+        processName: "Codex",
+        bundleId: "com.openai.codex",
+        displayName: "Codex CLI",
+    },
+    chatgpt: {
+        port: 9236,
+        processName: "ChatGPT",
+        bundleId: "com.openai.chat",
+        displayName: "ChatGPT",
+    },
+    notion: {
+        port: 9230,
+        processName: "Notion",
+        bundleId: "notion.id",
+        displayName: "Notion",
+    },
+    "discord-app": {
+        port: 9232,
+        processName: "Discord",
+        bundleId: "com.hnc.Discord",
+        displayName: "Discord",
+    },
+    chatwise: {
+        port: 9228,
+        processName: "ChatWise",
+        bundleId: "com.chatwise.app",
+        displayName: "ChatWise",
+    },
+    "doubao-app": {
+        port: 9225,
+        processName: "Doubao",
+        bundleId: "com.volcengine.doubao",
+        displayName: "Doubao",
+    },
+    antigravity: {
+        port: 9234,
+        processName: "Antigravity",
+        executableNames: ["Electron", "Antigravity"],
+        bundleId: "dev.antigravity.app",
+        displayName: "Antigravity",
+    },
+};
+let _apps = null;
+/**
+ * Get all known Electron apps (builtins + user extensions).
+ * User apps from ~/.unicli/apps.yaml are additive only — cannot override builtins.
+ */
+export function getElectronApps() {
+    if (_apps)
+        return _apps;
+    _apps = { ...BUILTIN_APPS };
+    // Load user extensions
+    try {
+        const userAppsPath = join(homedir(), ".unicli", "apps.yaml");
+        const content = readFileSync(userAppsPath, "utf-8");
+        const parsed = yaml.load(content);
+        if (parsed?.apps) {
+            for (const [name, entry] of Object.entries(parsed.apps)) {
+                if (!(name in BUILTIN_APPS)) {
+                    _apps[name] = entry;
+                }
+            }
+        }
+    }
+    catch {
+        // No user apps file — that's fine
+    }
+    return _apps;
+}
+/**
+ * Look up an Electron app by site name.
+ */
+export function getElectronApp(site) {
+    return getElectronApps()[site] ?? null;
+}
+/**
+ * Check if a site is a known Electron app.
+ */
+export function isElectronApp(site) {
+    return site in getElectronApps();
+}
+//# sourceMappingURL=electron-apps.js.map

package/dist/electron-apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron-apps.js","sourceRoot":"","sources":["../src/electron-apps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,SAAS,CAAC;AAW3B,MAAM,YAAY,GAAqC;IACrD,MAAM,EAAE;QACN,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,8BAA8B;QACxC,WAAW,EAAE,QAAQ;KACtB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,OAAO;QACpB,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,WAAW;KACzB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,iBAAiB;QAC3B,WAAW,EAAE,SAAS;KACvB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE;QACb,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,iBAAiB;QAC3B,WAAW,EAAE,SAAS;KACvB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,UAAU;QACvB,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,UAAU;KACxB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,uBAAuB;QACjC,WAAW,EAAE,QAAQ;KACtB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,aAAa;QAC1B,eAAe,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC;QAC5C,QAAQ,EAAE,qBAAqB;QAC/B,WAAW,EAAE,aAAa;KAC3B;CACF,CAAC;AAEF,IAAI,KAAK,GAA4C,IAAI,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,KAAK,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;IAE5B,uBAAuB;IACvB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAE/B,CAAC;QACF,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,CAAC,EAAE,CAAC;oBAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,IAAI,eAAe,EAAE,CAAC;AACnC,CAAC"}

package/dist/engine/analysis.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared Analysis Module — boolean endpoint filters + transparent sort keys.
+ *
+ * Replaces the numeric scoring approach with composable boolean predicates and
+ * a tuple sort key, making ranking logic explicit and unit-testable.
+ *
+ * Reference: APISensor (NJU 2026), industry best practices.
+ */
+/**
+ * Returns true if the URL belongs to a known noise source: trackers, analytics
+ * beacons, Next.js internals, or hot-reload endpoints.
+ */
+export declare function isNoiseUrl(url: string): boolean;
+/**
+ * Returns true if the URL or content-type indicates a static resource
+ * (image, font, stylesheet, script, or source map).
+ */
+export declare function isStaticResource(url: string, contentType?: string): boolean;
+/**
+ * Returns true if the endpoint appears to return useful structured data:
+ * JSON content-type, 2xx status (when provided), and non-trivial body.
+ */
+export declare function isUsefulEndpoint(entry: {
+    url: string;
+    status?: number;
+    contentType?: string;
+    body?: unknown;
+}): boolean;
+/**
+ * Returns a 4-tuple sort key for transparent, deterministic endpoint ranking.
+ *
+ * Tuple: [itemCount, fieldCount, isApiPath, hasParams]
+ *
+ * Sort descending on all dimensions (higher = better).
+ */
+export declare function endpointSortKey(entry: {
+    url: string;
+    body?: unknown;
+}): [number, number, number, number];
+/**
+ * Detect a capability label from the URL and optionally the body shape.
+ *
+ * URL patterns take priority. If no URL match, falls back to field-name
+ * heuristics on the first item in an array body.
+ */
+export declare function detectCapability(url: string, body?: unknown): string | null;
+/**
+ * Format a duration in milliseconds into a human-readable string.
+ *
+ * - < 1000 ms  → "42ms"
+ * - < 60000 ms → "3.2s"
+ * - else       → "1m 23s"
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/engine/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0EH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAU/C;AAiCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CA4B3E;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAwCV;AAoBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CA6CnC;AA4CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAiC3E;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD"}