@zenalexa/unicli 0.207.1

package/dist/engine/community-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-fix.d.ts","sourceRoot":"","sources":["../../src/engine/community-fix.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG5D;AAGD,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/engine/community-fix.js

@@ -0,0 +1,29 @@
+/**
+ * Community Fix Level 3 — query the adapter registry for updates.
+ *
+ * When an adapter fails and auto-fix can't resolve it, this module
+ * checks if a newer version exists in the community registry.
+ *
+ * Registry: https://registry.unicli.dev/api/adapters/<site>/<cmd>/latest
+ * Status: STUB — returns null until registry is deployed.
+ */
+const REGISTRY_BASE = "https://registry.unicli.dev/api";
+/**
+ * Query the community registry for a newer adapter version.
+ * Returns the YAML content if a newer version exists, null otherwise.
+ */
+export async function fetchCommunityFix(site, command, _currentHash) {
+    // STUB: Registry not yet deployed
+    void REGISTRY_BASE;
+    void site;
+    void command;
+    return null;
+}
+/**
+ * Check if the community registry is reachable.
+ */
+export async function isRegistryAvailable() {
+    // STUB: Always returns false until registry is deployed
+    return false;
+}
+//# sourceMappingURL=community-fix.js.map

package/dist/engine/community-fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-fix.js","sourceRoot":"","sources":["../../src/engine/community-fix.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,aAAa,GAAG,iCAAiC,CAAC;AAWxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAAe,EACf,YAAqB;IAErB,kCAAkC;IAClC,KAAK,aAAa,CAAC;IACnB,KAAK,IAAI,CAAC;IACV,KAAK,OAAO,CAAC;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,wDAAwD;IACxD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/engine/cookie-extractor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Extract cookies from a running Chrome instance via CDP.
+ * No extension. No cookie files. No manual export.
+ *
+ * Usage:
+ *   const cookies = await extractCookiesViaCDP("bilibili.com");
+ *   // -> { SESSDATA: "abc", bili_jct: "def", ... }
+ */
+/**
+ * Extract cookies for a domain from a running Chrome instance.
+ * Connects to Chrome's CDP debug port, calls Network.getCookies,
+ * and returns cookies as a flat key-value record.
+ */
+export declare function extractCookiesViaCDP(domain: string, port?: number): Promise<Record<string, string>>;
+/**
+ * Save extracted cookies to disk for offline use.
+ * Writes to ~/.unicli/cookies/<site>.json
+ */
+export declare function saveCookies(site: string, cookies: Record<string, string>): string;
+//# sourceMappingURL=cookie-extractor.d.ts.map

package/dist/engine/cookie-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-extractor.d.ts","sourceRoot":"","sources":["../../src/engine/cookie-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+BjC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAaR"}

package/dist/engine/cookie-extractor.js

@@ -0,0 +1,62 @@
+/**
+ * Extract cookies from a running Chrome instance via CDP.
+ * No extension. No cookie files. No manual export.
+ *
+ * Usage:
+ *   const cookies = await extractCookiesViaCDP("bilibili.com");
+ *   // -> { SESSDATA: "abc", bili_jct: "def", ... }
+ */
+import { writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Extract cookies for a domain from a running Chrome instance.
+ * Connects to Chrome's CDP debug port, calls Network.getCookies,
+ * and returns cookies as a flat key-value record.
+ */
+export async function extractCookiesViaCDP(domain, port) {
+    const { CDPClient } = await import("../browser/cdp-client.js");
+    const rawPort = process.env.UNICLI_CDP_PORT;
+    let cdpPort = port ?? 9222;
+    if (!port && rawPort) {
+        const p = parseInt(rawPort, 10);
+        if (!Number.isInteger(p) || p < 1 || p > 65535) {
+            throw new Error(`Invalid UNICLI_CDP_PORT: "${rawPort}"`);
+        }
+        cdpPort = p;
+    }
+    const client = await CDPClient.connectToChrome(cdpPort);
+    try {
+        const { cookies } = (await client.send("Network.getCookies", {
+            urls: [
+                `https://${domain}`,
+                `https://www.${domain}`,
+                `http://${domain}`,
+                `http://www.${domain}`,
+            ],
+        }));
+        const result = {};
+        for (const c of cookies) {
+            result[c.name] = c.value;
+        }
+        return result;
+    }
+    finally {
+        await client.close().catch(() => { });
+    }
+}
+/**
+ * Save extracted cookies to disk for offline use.
+ * Writes to ~/.unicli/cookies/<site>.json
+ */
+export function saveCookies(site, cookies) {
+    if (!/^[a-zA-Z0-9._-]+$/.test(site)) {
+        throw new Error(`Invalid site name: "${site}" — only alphanumeric, dot, dash, underscore allowed`);
+    }
+    const dir = process.env.UNICLI_COOKIE_DIR ??
+        join(process.env.HOME ?? "~", ".unicli", "cookies");
+    mkdirSync(dir, { recursive: true });
+    const filePath = join(dir, `${site}.json`);
+    writeFileSync(filePath, JSON.stringify(cookies, null, 2), "utf-8");
+    return filePath;
+}
+//# sourceMappingURL=cookie-extractor.js.map

package/dist/engine/cookie-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-extractor.js","sourceRoot":"","sources":["../../src/engine/cookie-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,IAAa;IAEb,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC5C,IAAI,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,GAAG,CAAC,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;YAC3D,IAAI,EAAE;gBACJ,WAAW,MAAM,EAAE;gBACnB,eAAe,MAAM,EAAE;gBACvB,UAAU,MAAM,EAAE;gBAClB,cAAc,MAAM,EAAE;aACvB;SACF,CAAC,CAA6B,CAAC;QAEhC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,OAA+B;IAE/B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,sDAAsD,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GACP,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACtD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC3C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/engine/cookie-refresh.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Smart Cookie Refresh — automatically refresh expired cookies via CDP.
+ *
+ * When an adapter gets a 401/403, this module attempts to navigate Chrome
+ * to the site's main page (refreshing the session), extract fresh cookies
+ * via CDP, and write them to the cookie file for subsequent requests.
+ */
+/**
+ * Attempt to refresh cookies for a site by navigating Chrome to it.
+ * Returns true if cookies were refreshed, false if not possible.
+ */
+export declare function refreshCookies(site: string, domain?: string): Promise<boolean>;
+//# sourceMappingURL=cookie-refresh.d.ts.map

package/dist/engine/cookie-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-refresh.d.ts","sourceRoot":"","sources":["../../src/engine/cookie-refresh.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CA4DlB"}

package/dist/engine/cookie-refresh.js

@@ -0,0 +1,71 @@
+/**
+ * Smart Cookie Refresh — automatically refresh expired cookies via CDP.
+ *
+ * When an adapter gets a 401/403, this module attempts to navigate Chrome
+ * to the site's main page (refreshing the session), extract fresh cookies
+ * via CDP, and write them to the cookie file for subsequent requests.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+/**
+ * Attempt to refresh cookies for a site by navigating Chrome to it.
+ * Returns true if cookies were refreshed, false if not possible.
+ */
+export async function refreshCookies(site, domain) {
+    try {
+        const { BrowserPage: BP } = await import("../browser/page.js");
+        // Try connecting to an existing Chrome instance
+        let port = 9222;
+        const rawPort = process.env.UNICLI_CDP_PORT;
+        if (rawPort) {
+            const p = parseInt(rawPort, 10);
+            if (Number.isInteger(p) && p >= 1 && p <= 65535) {
+                port = p;
+            }
+        }
+        let page;
+        try {
+            page = await BP.connect(port);
+        }
+        catch {
+            // No Chrome CDP available — cannot refresh
+            return false;
+        }
+        try {
+            // Navigate to the site's main page to refresh session
+            const targetUrl = domain
+                ? `https://${domain}`
+                : `https://www.${site}.com`;
+            await page.goto(targetUrl, { settleMs: 3000 });
+            // Extract cookies
+            const cookies = await page.cookies();
+            if (Object.keys(cookies).length === 0) {
+                return false;
+            }
+            // Write cookies to file
+            const cookiesDir = join(homedir(), ".unicli", "cookies");
+            mkdirSync(cookiesDir, { recursive: true });
+            const cookieArray = Object.entries(cookies).map(([name, value]) => ({
+                name,
+                value,
+                domain: domain ?? `${site}.com`,
+            }));
+            const cookiePath = join(cookiesDir, `${site}.json`);
+            writeFileSync(cookiePath, JSON.stringify(cookieArray, null, 2), "utf-8");
+            return true;
+        }
+        finally {
+            try {
+                await page.close();
+            }
+            catch {
+                /* best effort */
+            }
+        }
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=cookie-refresh.js.map

package/dist/engine/cookie-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-refresh.js","sourceRoot":"","sources":["../../src/engine/cookie-refresh.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,MAAe;IAEf,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAE/D,gDAAgD;QAChD,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;gBAChD,IAAI,GAAG,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,sDAAsD;YACtD,MAAM,SAAS,GAAG,MAAM;gBACtB,CAAC,CAAC,WAAW,MAAM,EAAE;gBACrB,CAAC,CAAC,eAAe,IAAI,MAAM,CAAC;YAE9B,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/C,kBAAkB;YAClB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,wBAAwB;YACxB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACzD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3C,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClE,IAAI;gBACJ,KAAK;gBACL,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM;aAChC,CAAC,CAAC,CAAC;YAEJ,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;YACpD,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAEzE,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/engine/cookies.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Cookie file reader for authenticated adapters.
+ *
+ * Cookies are stored as JSON in ~/.unicli/cookies/<site>.json
+ * Each file contains { "cookie_name": "value", ... }
+ */
+/**
+ * Load cookies for a site from disk.
+ * Returns null if file doesn't exist or is malformed.
+ */
+export declare function loadCookies(site: string): Record<string, string> | null;
+/**
+ * Format cookies as an HTTP Cookie header value.
+ * Example: "SESSDATA=abc; bili_jct=def"
+ */
+export declare function formatCookieHeader(cookies: Record<string, string>): string;
+/**
+ * Validate that a cookie file has all required keys.
+ */
+export declare function validateCookies(site: string, requiredKeys: string[]): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * Get the cookie directory path (for display in auth commands).
+ */
+export declare function getCookieDir(): string;
+/**
+ * Load cookies with CDP fallback.
+ * 1. Try disk (fast, synchronous) — ~/.unicli/cookies/<site>.json
+ * 2. Try CDP extraction (connects to Chrome debug port)
+ * 3. Return null if neither available
+ *
+ * When CDP extraction succeeds, cookies are saved to disk for future use.
+ */
+export declare function loadCookiesWithCDP(site: string, domain?: string): Promise<Record<string, string> | null>;
+//# sourceMappingURL=cookies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/engine/cookies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAmBvE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,GACrB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAMvC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CA2BxC"}

package/dist/engine/cookies.js

@@ -0,0 +1,100 @@
+/**
+ * Cookie file reader for authenticated adapters.
+ *
+ * Cookies are stored as JSON in ~/.unicli/cookies/<site>.json
+ * Each file contains { "cookie_name": "value", ... }
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { extractCookiesViaCDP, saveCookies as saveCookiesToDisk, } from "./cookie-extractor.js";
+function cookieDir() {
+    return (process.env.UNICLI_COOKIE_DIR ??
+        join(process.env.HOME ?? "~", ".unicli", "cookies"));
+}
+/**
+ * Load cookies for a site from disk.
+ * Returns null if file doesn't exist or is malformed.
+ */
+export function loadCookies(site) {
+    if (!/^[a-zA-Z0-9._-]+$/.test(site))
+        return null;
+    const path = join(cookieDir(), `${site}.json`);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = readFileSync(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Format cookies as an HTTP Cookie header value.
+ * Example: "SESSDATA=abc; bili_jct=def"
+ */
+export function formatCookieHeader(cookies) {
+    return Object.entries(cookies)
+        .map(([k, v]) => `${k}=${v}`)
+        .join("; ");
+}
+/**
+ * Validate that a cookie file has all required keys.
+ */
+export function validateCookies(site, requiredKeys) {
+    const cookies = loadCookies(site);
+    if (!cookies)
+        return { valid: false, missing: requiredKeys };
+    const missing = requiredKeys.filter((k) => !(k in cookies));
+    return { valid: missing.length === 0, missing };
+}
+/**
+ * Get the cookie directory path (for display in auth commands).
+ */
+export function getCookieDir() {
+    return cookieDir();
+}
+/**
+ * Load cookies with CDP fallback.
+ * 1. Try disk (fast, synchronous) — ~/.unicli/cookies/<site>.json
+ * 2. Try CDP extraction (connects to Chrome debug port)
+ * 3. Return null if neither available
+ *
+ * When CDP extraction succeeds, cookies are saved to disk for future use.
+ */
+export async function loadCookiesWithCDP(site, domain) {
+    // 1. Try disk first (existing behavior)
+    const diskCookies = loadCookies(site);
+    if (diskCookies)
+        return diskCookies;
+    // 2. Try CDP extraction
+    let cookieDomain = domain ?? site.replace(/_/g, ".");
+    // If no TLD in domain, append .com as default (covers bilibili, zhihu, weibo, etc.)
+    if (!cookieDomain.includes(".")) {
+        cookieDomain = `${cookieDomain}.com`;
+    }
+    try {
+        const cdpCookies = await extractCookiesViaCDP(cookieDomain);
+        if (Object.keys(cdpCookies).length > 0) {
+            // Save to disk for future use (site name is already validated by saveCookiesToDisk)
+            try {
+                saveCookiesToDisk(site, cdpCookies);
+            }
+            catch {
+                // Non-fatal: disk write failed but we still have the cookies
+            }
+            return cdpCookies;
+        }
+    }
+    catch {
+        // CDP not available — fall through
+    }
+    return null;
+}
+//# sourceMappingURL=cookies.js.map

package/dist/engine/cookies.js.map

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

package/dist/engine/diagnostic.d.ts

@@ -0,0 +1,95 @@
+/**
+ * RepairContext Diagnostic Module — structured error context for agent self-repair.
+ *
+ * When UNICLI_DIAGNOSTIC=1, pipeline failures emit a RepairContext JSON block
+ * to stderr, giving agents everything they need to diagnose and fix the adapter:
+ *   - Error details with hints
+ *   - Full adapter source (YAML/TS)
+ *   - Browser page state (URL, DOM snapshot, network, console errors)
+ */
+import type { BrowserPage } from "../browser/page.js";
+export interface RepairContext {
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+        stack?: string;
+    };
+    adapter: {
+        site: string;
+        command: string;
+        sourcePath?: string;
+        source?: string;
+    };
+    page?: {
+        url: string;
+        snapshot: string;
+        networkRequests: Array<{
+            url: string;
+            method: string;
+            status: number;
+            type: string;
+            headers?: Record<string, string>;
+            body?: unknown;
+        }>;
+        consoleErrors: string[];
+    };
+    timestamp: string;
+}
+export declare const MAX_DIAGNOSTIC_BYTES: number;
+/**
+ * Validate that a parsed object has the minimum shape of a RepairContext.
+ * Guards against truncated or malformed diagnostic JSON.
+ */
+export declare function isValidRepairContext(obj: unknown): obj is RepairContext;
+/**
+ * Redact sensitive HTTP headers, replacing values with [REDACTED].
+ * Case-insensitive match. Returns a new object (does not mutate input).
+ */
+export declare function redactHeaders(headers: Record<string, string>): Record<string, string>;
+/**
+ * Redact sensitive query parameters from a URL.
+ * Case-insensitive match against SENSITIVE_PARAMS.
+ * Handles both absolute and relative URLs.
+ * Returns the sanitized URL string, or the original on parse failure.
+ */
+export declare function redactUrl(url: string): string;
+/**
+ * Redact full JWTs in a string.
+ * Replaces entire header.payload.signature with [JWT-REDACTED].
+ */
+export declare function redactJwt(text: string): string;
+/**
+ * Recursively redact sensitive keys from a body value.
+ * - String: apply JWT redaction
+ * - Object: redact values of keys matching SENSITIVE_PARAMS, recurse
+ * - Array: map each element recursively
+ * Returns a new structure (does not mutate input).
+ */
+export declare function redactBody(body: unknown): unknown;
+/**
+ * Apply all redaction passes to a RepairContext.
+ * Returns a new context (does not mutate input).
+ */
+export declare function redactRepairContext(ctx: RepairContext): RepairContext;
+/**
+ * Build a RepairContext from a pipeline error and execution context.
+ */
+export declare function buildRepairContext(opts: {
+    error: Error;
+    site: string;
+    command: string;
+    adapterPath?: string;
+    page?: BrowserPage;
+}): Promise<RepairContext>;
+/**
+ * Returns true when UNICLI_DIAGNOSTIC env var is set to "1".
+ */
+export declare function isDiagnosticEnabled(): boolean;
+/**
+ * Emit RepairContext to stderr wrapped in markers for machine parsing.
+ * Applies redaction, then progressive size degradation if the payload
+ * exceeds thresholds.
+ */
+export declare function emitRepairContext(ctx: RepairContext): void;
+//# sourceMappingURL=diagnostic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../../src/engine/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,KAAK,CAAC;YACrB,GAAG,EAAE,MAAM,CAAC;YACZ,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,EAAE,OAAO,CAAC;SAChB,CAAC,CAAC;QACH,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAoD/C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAavE;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkC7C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEjD;AAsCD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CA+BrE;AAmBD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2FzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAgD1D"}