@jackwener/opencli 1.5.4 → 1.5.6

package/dist/clis/zsxq/utils.js

@@ -0,0 +1,230 @@
+import { ArgumentError, AuthRequiredError, CliError } from '../../errors.js';
+const SITE_DOMAIN = 'wx.zsxq.com';
+const SITE_URL = 'https://wx.zsxq.com';
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function pickArray(...values) {
+    for (const value of values) {
+        if (Array.isArray(value)) {
+            return value;
+        }
+    }
+    return [];
+}
+export async function ensureZsxqPage(page) {
+    await page.goto(SITE_URL);
+}
+export async function ensureZsxqAuth(page) {
+    // zsxq uses httpOnly cookies that may be on different subdomains.
+    // Verify auth by attempting a lightweight API call instead of checking cookies.
+    try {
+        const result = await page.evaluate(`
+      (async () => {
+        try {
+          const r = await new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            xhr.open('GET', 'https://api.zsxq.com/v2/groups', true);
+            xhr.withCredentials = true;
+            xhr.setRequestHeader('accept', 'application/json');
+            xhr.onload = () => {
+              if (xhr.status >= 200 && xhr.status < 300) {
+                try { resolve(JSON.parse(xhr.responseText)); }
+                catch { resolve(null); }
+              } else { resolve(null); }
+            };
+            xhr.onerror = () => resolve(null);
+            xhr.send();
+          });
+          return r !== null;
+        } catch { return false; }
+      })()
+    `);
+        if (!result) {
+            throw new AuthRequiredError('zsxq.com');
+        }
+    }
+    catch (err) {
+        if (err instanceof AuthRequiredError)
+            throw err;
+        throw new AuthRequiredError('zsxq.com');
+    }
+}
+export async function getCookieValue(page, name) {
+    const cookies = await page.getCookies({ domain: SITE_DOMAIN });
+    return cookies.find(cookie => cookie.name === name)?.value;
+}
+export async function getActiveGroupId(page) {
+    const groupId = await page.evaluate(`
+    (() => {
+      const target = localStorage.getItem('target_group');
+      if (target) {
+        try {
+          const parsed = JSON.parse(target);
+          if (parsed.group_id) return String(parsed.group_id);
+        } catch {}
+      }
+      return null;
+    })()
+  `);
+    if (groupId)
+        return groupId;
+    throw new ArgumentError('Cannot determine active group_id', 'Pass --group_id <id> or open the target 知识星球 page in Chrome first');
+}
+export async function browserJsonRequest(page, path) {
+    return await page.evaluate(`
+    (async () => {
+      const path = ${JSON.stringify(path)};
+
+      try {
+        return await new Promise((resolve) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', path, true);
+          xhr.withCredentials = true;
+          xhr.setRequestHeader('accept', 'application/json, text/plain, */*');
+          xhr.onload = () => {
+            let parsed = null;
+            if (xhr.responseText) {
+              try { parsed = JSON.parse(xhr.responseText); }
+              catch {}
+            }
+
+            resolve({
+              ok: xhr.status >= 200 && xhr.status < 300,
+              url: path,
+              status: xhr.status,
+              data: parsed,
+              error: xhr.status >= 200 && xhr.status < 300 ? undefined : 'HTTP ' + xhr.status,
+            });
+          };
+          xhr.onerror = () => resolve({
+            ok: false,
+            url: path,
+            error: 'Network error',
+          });
+          xhr.send();
+        });
+      } catch (error) {
+        return {
+          ok: false,
+          url: path,
+          error: error instanceof Error ? error.message : String(error),
+        };
+      }
+    })()
+  `);
+}
+export async function fetchFirstJson(page, paths) {
+    let lastFailure = null;
+    for (const path of paths) {
+        const result = await browserJsonRequest(page, path);
+        if (result.ok) {
+            return result;
+        }
+        lastFailure = result;
+    }
+    if (!lastFailure) {
+        throw new CliError('FETCH_ERROR', 'No candidate endpoint returned JSON', `Checked endpoints: ${paths.join(', ')}`);
+    }
+    throw new CliError('FETCH_ERROR', lastFailure.error || 'Failed to fetch ZSXQ API', `Checked endpoints: ${paths.join(', ')}`);
+}
+export function unwrapRespData(payload) {
+    const record = asRecord(payload);
+    if (!record) {
+        throw new CliError('PARSE_ERROR', 'Invalid ZSXQ API response');
+    }
+    if (record.succeeded === false) {
+        const code = typeof record.code === 'number' ? String(record.code) : 'API_ERROR';
+        const message = typeof record.info === 'string'
+            ? record.info
+            : typeof record.error === 'string'
+                ? record.error
+                : 'ZSXQ API returned an error';
+        throw new CliError(code, message);
+    }
+    return (record.resp_data ?? record.data ?? payload);
+}
+export function getTopicsFromResponse(payload) {
+    const data = unwrapRespData(payload);
+    if (Array.isArray(data))
+        return data;
+    return pickArray(data.topics, data.list, data.records, data.items, data.search_result);
+}
+export function getCommentsFromResponse(payload) {
+    const data = unwrapRespData(payload);
+    if (Array.isArray(data))
+        return data;
+    return pickArray(data.comments, data.list, data.items);
+}
+export function getGroupsFromResponse(payload) {
+    const data = unwrapRespData(payload);
+    if (Array.isArray(data))
+        return data;
+    return pickArray(data.groups, data.list, data.items);
+}
+export function getTopicFromResponse(payload) {
+    const data = unwrapRespData(payload);
+    if (Array.isArray(data))
+        return data[0] ?? null;
+    if (typeof data.topic_id === 'number')
+        return data;
+    const record = asRecord(data);
+    if (!record)
+        return null;
+    const topic = record.topic;
+    return topic && typeof topic === 'object' ? topic : null;
+}
+export function getTopicAuthor(topic) {
+    return (topic.owner?.name ||
+        topic.talk?.owner?.name ||
+        topic.question?.owner?.name ||
+        topic.answer?.owner?.name ||
+        topic.task?.owner?.name ||
+        topic.solution?.owner?.name ||
+        '');
+}
+export function getTopicText(topic) {
+    const primary = [
+        topic.title,
+        topic.talk?.text,
+        topic.question?.text,
+        topic.answer?.text,
+        topic.task?.text,
+        topic.solution?.text,
+    ].find(value => typeof value === 'string' && value.trim());
+    return (primary || '').replace(/\s+/g, ' ').trim();
+}
+export function getTopicUrl(topicId) {
+    return topicId ? `${SITE_URL}/topic/${topicId}` : SITE_URL;
+}
+export function summarizeComments(comments, limit = 3) {
+    return comments
+        .slice(0, limit)
+        .map((comment) => {
+        const author = comment.owner?.name || '匿名';
+        const target = comment.repliee?.name ? ` -> ${comment.repliee.name}` : '';
+        const text = (comment.text || '').replace(/\s+/g, ' ').trim();
+        return `${author}${target}: ${text}`;
+    })
+        .join(' | ');
+}
+export function toTopicRow(topic) {
+    const topicId = topic.topic_id ?? '';
+    const comments = pickArray(topic.show_comments, topic.comments);
+    return {
+        topic_id: topicId,
+        type: topic.type || '',
+        group: topic.group?.name || '',
+        author: getTopicAuthor(topic),
+        title: getTopicText(topic).slice(0, 120),
+        content: getTopicText(topic),
+        comments: topic.comments_count ?? comments.length ?? 0,
+        likes: topic.likes_count ?? 0,
+        readers: topic.readers_count ?? topic.reading_count ?? 0,
+        time: topic.create_time || '',
+        comment_preview: summarizeComments(comments),
+        url: getTopicUrl(topicId),
+    };
+}

package/dist/commanderAdapter.js

@@ -14,10 +14,10 @@ import { fullName, getRegistry } from './registry.js';
 import { formatRegistryHelpText } from './serialization.js';
 import { render as renderOutput } from './output.js';
 import { executeCommand } from './execution.js';
-import { CliError, ERROR_ICONS, getErrorMessage, BrowserConnectError, AuthRequiredError, TimeoutError, SelectorError, EmptyResultError, ArgumentError, AdapterLoadError, CommandExecutionError, } from './errors.js';
+import { CliError, EXIT_CODES, ERROR_ICONS, getErrorMessage, BrowserConnectError, AuthRequiredError, TimeoutError, SelectorError, EmptyResultError, ArgumentError, AdapterLoadError, CommandExecutionError, } from './errors.js';
 import { checkDaemonStatus } from './browser/discover.js';
 export function normalizeArgValue(argType, value, name) {
-    if (argType !== 'bool')
+    if (argType !== 'bool' && argType !== 'boolean')
         return value;
     if (typeof value === 'boolean')
         return value;
@@ -28,7 +28,7 @@ export function normalizeArgValue(argType, value, name) {
         return true;
     if (normalized === 'false')
         return false;
-    throw new CliError('ARGUMENT', `"${name}" must be either "true" or "false".`);
+    throw new ArgumentError(`"${name}" must be either "true" or "false".`);
 }
 /**
  * Register a single CliCommand as a Commander subcommand.
@@ -106,10 +106,33 @@ export function registerCommandToProgram(siteCmd, cmd) {
         }
         catch (err) {
             await renderError(err, fullName(cmd), optionsRecord.verbose === true);
-            process.exitCode = 1;
+            process.exitCode = resolveExitCode(err);
         }
     });
 }
+// ── Exit code resolution ─────────────────────────────────────────────────────
+/**
+ * Map any thrown value to a Unix process exit code.
+ *
+ * - CliError subclasses carry their own exitCode (set in errors.ts).
+ * - Generic Error objects are classified by message pattern so that
+ *   un-typed auth / not-found errors from adapters still produce
+ *   meaningful exit codes for shell scripts.
+ */
+function resolveExitCode(err) {
+    if (err instanceof CliError)
+        return err.exitCode;
+    // Pattern-based fallback for untyped errors thrown by third-party adapters.
+    const msg = getErrorMessage(err);
+    const kind = classifyGenericError(msg);
+    if (kind === 'auth')
+        return EXIT_CODES.NOPERM;
+    if (kind === 'not-found')
+        return EXIT_CODES.EMPTY_RESULT;
+    if (kind === 'http')
+        return EXIT_CODES.GENERIC_ERROR; // HTTP 4xx/5xx → generic; renderer shows details
+    return EXIT_CODES.GENERIC_ERROR;
+}
 // ── Error rendering ──────────────────────────────────────────────────────────
 const ISSUES_URL = 'https://github.com/jackwener/opencli/issues';
 /** Pattern-based classifier for untyped errors thrown by adapters. */

package/dist/commanderAdapter.test.js

@@ -60,3 +60,42 @@ describe('commanderAdapter arg passing', () => {
         expect(mockExecuteCommand).not.toHaveBeenCalled();
     });
 });
+describe('commanderAdapter boolean alias support', () => {
+    const cmd = {
+        site: 'reddit',
+        name: 'save',
+        description: 'Save a post',
+        browser: false,
+        args: [
+            { name: 'post-id', positional: true, required: true, help: 'Post ID' },
+            { name: 'undo', type: 'boolean', default: false, help: 'Unsave instead of save' },
+        ],
+        func: vi.fn(),
+    };
+    beforeEach(() => {
+        mockExecuteCommand.mockReset();
+        mockExecuteCommand.mockResolvedValue([]);
+        mockRenderOutput.mockReset();
+        delete process.env.OPENCLI_VERBOSE;
+        process.exitCode = undefined;
+    });
+    it('coerces default false for boolean args to a real boolean', async () => {
+        const program = new Command();
+        const siteCmd = program.command('reddit');
+        registerCommandToProgram(siteCmd, cmd);
+        await program.parseAsync(['node', 'opencli', 'reddit', 'save', 't3_abc123']);
+        expect(mockExecuteCommand).toHaveBeenCalled();
+        const kwargs = mockExecuteCommand.mock.calls[0][1];
+        expect(kwargs['post-id']).toBe('t3_abc123');
+        expect(kwargs.undo).toBe(false);
+    });
+    it('coerces explicit false for boolean args to a real boolean', async () => {
+        const program = new Command();
+        const siteCmd = program.command('reddit');
+        registerCommandToProgram(siteCmd, cmd);
+        await program.parseAsync(['node', 'opencli', 'reddit', 'save', 't3_abc123', '--undo', 'false']);
+        expect(mockExecuteCommand).toHaveBeenCalled();
+        const kwargs = mockExecuteCommand.mock.calls[0][1];
+        expect(kwargs.undo).toBe(false);
+    });
+});

package/dist/daemon.js

@@ -21,6 +21,7 @@
 import { createServer } from 'node:http';
 import { WebSocketServer, WebSocket } from 'ws';
 import { DEFAULT_DAEMON_PORT } from './constants.js';
+import { EXIT_CODES } from './errors.js';
 const PORT = parseInt(process.env.OPENCLI_DAEMON_PORT ?? String(DEFAULT_DAEMON_PORT), 10);
 const IDLE_TIMEOUT = 5 * 60 * 1000; // 5 minutes
 // ─── State ───────────────────────────────────────────────────────────
@@ -41,7 +42,7 @@ function resetIdleTimer() {
         clearTimeout(idleTimer);
     idleTimer = setTimeout(() => {
         console.error('[daemon] Idle timeout, shutting down');
-        process.exit(0);
+        process.exit(EXIT_CODES.SUCCESS);
     }, IDLE_TIMEOUT);
 }
 // ─── HTTP Server ─────────────────────────────────────────────────────
@@ -269,10 +270,10 @@ httpServer.listen(PORT, '127.0.0.1', () => {
 httpServer.on('error', (err) => {
     if (err.code === 'EADDRINUSE') {
         console.error(`[daemon] Port ${PORT} already in use — another daemon is likely running. Exiting.`);
-        process.exit(1);
+        process.exit(EXIT_CODES.SERVICE_UNAVAIL);
     }
     console.error('[daemon] Server error:', err.message);
-    process.exit(1);
+    process.exit(EXIT_CODES.GENERIC_ERROR);
 });
 // Graceful shutdown
 function shutdown() {
@@ -285,7 +286,7 @@ function shutdown() {
     if (extensionWs)
         extensionWs.close();
     httpServer.close();
-    process.exit(0);
+    process.exit(EXIT_CODES.SUCCESS);
 }
 process.on('SIGTERM', shutdown);
 process.on('SIGINT', shutdown);

package/dist/errors.d.ts

@@ -4,13 +4,41 @@
  * All errors thrown by the framework should extend CliError so that
  * the top-level handler in commanderAdapter.ts can render consistent,
  * helpful output with emoji-coded severity and actionable hints.
+ *
+ * ## Exit codes
+ *
+ * opencli follows Unix conventions (sysexits.h) for process exit codes:
+ *
+ *   0   Success
+ *   1   Generic / unexpected error
+ *   2   Argument / usage error          (ArgumentError)
+ *  66   No input / empty result         (EmptyResultError)
+ *  69   Service unavailable             (BrowserConnectError, AdapterLoadError)
+ *  75   Temporary failure, retry later  (TimeoutError)   EX_TEMPFAIL
+ *  77   Permission denied / auth needed (AuthRequiredError)
+ *  78   Configuration error             (ConfigError)
+ * 130   Interrupted by Ctrl-C           (set by tui.ts SIGINT handler)
  */
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly GENERIC_ERROR: 1;
+    readonly USAGE_ERROR: 2;
+    readonly EMPTY_RESULT: 66;
+    readonly SERVICE_UNAVAIL: 69;
+    readonly TEMPFAIL: 75;
+    readonly NOPERM: 77;
+    readonly CONFIG_ERROR: 78;
+    readonly INTERRUPTED: 130;
+};
+export type ExitCode = typeof EXIT_CODES[keyof typeof EXIT_CODES];
 export declare class CliError extends Error {
     /** Machine-readable error code (e.g. 'BROWSER_CONNECT', 'AUTH_REQUIRED') */
     readonly code: string;
     /** Human-readable hint on how to fix the problem */
     readonly hint?: string;
-    constructor(code: string, message: string, hint?: string);
+    /** Unix process exit code — defaults to 1 (generic error) */
+    readonly exitCode: ExitCode;
+    constructor(code: string, message: string, hint?: string, exitCode?: ExitCode);
 }
 export type BrowserConnectKind = 'daemon-not-running' | 'extension-not-connected' | 'command-failed' | 'unknown';
 export declare class BrowserConnectError extends CliError {

package/dist/errors.js

@@ -4,61 +4,99 @@
  * All errors thrown by the framework should extend CliError so that
  * the top-level handler in commanderAdapter.ts can render consistent,
  * helpful output with emoji-coded severity and actionable hints.
+ *
+ * ## Exit codes
+ *
+ * opencli follows Unix conventions (sysexits.h) for process exit codes:
+ *
+ *   0   Success
+ *   1   Generic / unexpected error
+ *   2   Argument / usage error          (ArgumentError)
+ *  66   No input / empty result         (EmptyResultError)
+ *  69   Service unavailable             (BrowserConnectError, AdapterLoadError)
+ *  75   Temporary failure, retry later  (TimeoutError)   EX_TEMPFAIL
+ *  77   Permission denied / auth needed (AuthRequiredError)
+ *  78   Configuration error             (ConfigError)
+ * 130   Interrupted by Ctrl-C           (set by tui.ts SIGINT handler)
  */
+// ── Exit code table ──────────────────────────────────────────────────────────
+export const EXIT_CODES = {
+    SUCCESS: 0,
+    GENERIC_ERROR: 1,
+    USAGE_ERROR: 2, // Bad arguments / command misuse
+    EMPTY_RESULT: 66, // No data / not found           (EX_NOINPUT)
+    SERVICE_UNAVAIL: 69, // Daemon / browser unavailable  (EX_UNAVAILABLE)
+    TEMPFAIL: 75, // Timeout — try again later     (EX_TEMPFAIL)
+    NOPERM: 77, // Auth required / permission    (EX_NOPERM)
+    CONFIG_ERROR: 78, // Missing / invalid config      (EX_CONFIG)
+    INTERRUPTED: 130, // Ctrl-C / SIGINT
+};
+// ── Base class ───────────────────────────────────────────────────────────────
 export class CliError extends Error {
     /** Machine-readable error code (e.g. 'BROWSER_CONNECT', 'AUTH_REQUIRED') */
     code;
     /** Human-readable hint on how to fix the problem */
     hint;
-    constructor(code, message, hint) {
+    /** Unix process exit code — defaults to 1 (generic error) */
+    exitCode;
+    constructor(code, message, hint, exitCode = EXIT_CODES.GENERIC_ERROR) {
         super(message);
         this.name = new.target.name;
         this.code = code;
         this.hint = hint;
+        this.exitCode = exitCode;
     }
 }
 export class BrowserConnectError extends CliError {
     kind;
     constructor(message, hint, kind = 'unknown') {
-        super('BROWSER_CONNECT', message, hint);
+        super('BROWSER_CONNECT', message, hint, EXIT_CODES.SERVICE_UNAVAIL);
         this.kind = kind;
     }
 }
 export class AdapterLoadError extends CliError {
-    constructor(message, hint) { super('ADAPTER_LOAD', message, hint); }
+    constructor(message, hint) {
+        super('ADAPTER_LOAD', message, hint, EXIT_CODES.SERVICE_UNAVAIL);
+    }
 }
 export class CommandExecutionError extends CliError {
-    constructor(message, hint) { super('COMMAND_EXEC', message, hint); }
+    constructor(message, hint) {
+        super('COMMAND_EXEC', message, hint, EXIT_CODES.GENERIC_ERROR);
+    }
 }
 export class ConfigError extends CliError {
-    constructor(message, hint) { super('CONFIG', message, hint); }
+    constructor(message, hint) {
+        super('CONFIG', message, hint, EXIT_CODES.CONFIG_ERROR);
+    }
 }
 export class AuthRequiredError extends CliError {
     domain;
     constructor(domain, message) {
-        super('AUTH_REQUIRED', message ?? `Not logged in to ${domain}`, `Please open Chrome and log in to https://${domain}`);
+        super('AUTH_REQUIRED', message ?? `Not logged in to ${domain}`, `Please open Chrome and log in to https://${domain}`, EXIT_CODES.NOPERM);
         this.domain = domain;
     }
 }
 export class TimeoutError extends CliError {
     constructor(label, seconds, hint) {
-        super('TIMEOUT', `${label} timed out after ${seconds}s`, hint ?? 'Try again, or increase timeout with OPENCLI_BROWSER_COMMAND_TIMEOUT env var');
+        super('TIMEOUT', `${label} timed out after ${seconds}s`, hint ?? 'Try again, or increase timeout with OPENCLI_BROWSER_COMMAND_TIMEOUT env var', EXIT_CODES.TEMPFAIL);
     }
 }
 export class ArgumentError extends CliError {
-    constructor(message, hint) { super('ARGUMENT', message, hint); }
+    constructor(message, hint) {
+        super('ARGUMENT', message, hint, EXIT_CODES.USAGE_ERROR);
+    }
 }
 export class EmptyResultError extends CliError {
     constructor(command, hint) {
-        super('EMPTY_RESULT', `${command} returned no data`, hint ?? 'The page structure may have changed, or you may need to log in');
+        super('EMPTY_RESULT', `${command} returned no data`, hint ?? 'The page structure may have changed, or you may need to log in', EXIT_CODES.EMPTY_RESULT);
     }
 }
 export class SelectorError extends CliError {
     constructor(selector, hint) {
-        super('SELECTOR', `Could not find element: ${selector}`, hint ?? 'The page UI may have changed. Please report this issue.');
+        super('SELECTOR', `Could not find element: ${selector}`, hint ?? 'The page UI may have changed. Please report this issue.', EXIT_CODES.GENERIC_ERROR);
     }
 }
-// ── Utilities ───────────────────────────────────────────────────────────
+// ── Utilities ───────────────────────────────────────────────────────────────
 /** Extract a human-readable message from an unknown caught value. */
 export function getErrorMessage(error) {
     return error instanceof Error ? error.message : String(error);

package/dist/external-clis.yaml

@@ -30,6 +30,23 @@
   install:
     default: "npm install -g @larksuite/cli"
 
+- name: dws
+  binary: dws
+  description: "DingTalk Workspace CLI — messages, docs, calendar, contacts and more for humans and AI agents"
+  homepage: "https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli"
+  tags: [dingtalk, collaboration, productivity, ai-agent]
+  install:
+    mac: "curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh"
+    linux: "curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh"
+
+- name: wecom-cli
+  binary: wecom-cli
+  description: "WeCom/企业微信 CLI — contacts, todos, meetings, messages, calendar, docs and smart sheets for AI agents"
+  homepage: "https://github.com/WecomTeam/wecom-cli"
+  tags: [wecom, wechat-work, collaboration, productivity, ai-agent]
+  install:
+    default: "npm install -g @wecom/cli"
+
 - name: vercel
   binary: vercel
   description: "Vercel CLI — deploy projects, manage domains, env vars, logs and serverless functions"

package/dist/external.js

@@ -6,7 +6,7 @@ import { spawnSync, execFileSync } from 'node:child_process';
 import yaml from 'js-yaml';
 import chalk from 'chalk';
 import { log } from './logger.js';
-import { getErrorMessage } from './errors.js';
+import { EXIT_CODES, getErrorMessage } from './errors.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 function getUserRegistryPath() {
     const home = os.homedir();
@@ -154,7 +154,7 @@ export function executeExternalCli(name, args, preloaded) {
         // 2. Try to auto install
         const success = installExternalCli(cli);
         if (!success) {
-            process.exitCode = 1;
+            process.exitCode = EXIT_CODES.SERVICE_UNAVAIL;
             return;
         }
     }
@@ -162,7 +162,7 @@ export function executeExternalCli(name, args, preloaded) {
     const result = spawnSync(cli.binary, args, { stdio: 'inherit' });
     if (result.error) {
         console.error(chalk.red(`Failed to execute '${cli.binary}': ${result.error.message}`));
-        process.exitCode = 1;
+        process.exitCode = EXIT_CODES.GENERIC_ERROR;
         return;
     }
     if (result.status !== null) {

package/dist/main.js

@@ -21,6 +21,7 @@ import { runCli } from './cli.js';
 import { emitHook } from './hooks.js';
 import { installNodeNetwork } from './node-network.js';
 import { registerUpdateNoticeOnExit, checkForUpdateBackground } from './update-check.js';
+import { EXIT_CODES } from './errors.js';
 installNodeNetwork();
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -53,7 +54,7 @@ if (getCompIdx !== -1) {
         cursor = words.length;
     const candidates = getCompletions(words, cursor);
     process.stdout.write(candidates.join('\n') + '\n');
-    process.exit(0);
+    process.exit(EXIT_CODES.SUCCESS);
 }
 await emitHook('onStartup', { command: '__startup__', args: {} });
 runCli(BUILTIN_CLIS, USER_CLIS);

package/dist/tui.js

@@ -4,6 +4,7 @@
  * Uses raw stdin mode + ANSI escape codes for interactive prompts.
  */
 import chalk from 'chalk';
+import { EXIT_CODES } from './errors.js';
 /**
  * Interactive multi-select checkbox prompt.
  *
@@ -130,7 +131,7 @@ export async function checkboxPrompt(items, opts = {}) {
             // Ctrl+C — exit process
             if (key === '\x03') {
                 cleanup();
-                process.exit(130);
+                process.exit(EXIT_CODES.INTERRUPTED);
             }
         }
         stdin.on('data', onData);

package/dist/types.d.ts

@@ -70,6 +70,11 @@ export interface IPage {
     getInterceptedRequests(): Promise<any[]>;
     waitForCapture(timeout?: number): Promise<void>;
     screenshot(options?: ScreenshotOptions): Promise<string>;
+    /**
+     * Set local file paths on a file input element via CDP DOM.setFileInputFiles.
+     * Chrome reads the files directly — no base64 encoding or payload size limits.
+     */
+    setFileInput?(files: string[], selector?: string): Promise<void>;
     closeWindow?(): Promise<void>;
     /** Returns the current page URL, or null if unavailable. */
     getCurrentUrl?(): Promise<string | null>;

package/docs/.vitepress/config.mts

@@ -50,6 +50,7 @@ export default defineConfig({
               items: [
                 { text: 'Twitter / X', link: '/adapters/browser/twitter' },
                 { text: 'Reddit', link: '/adapters/browser/reddit' },
+                { text: 'Tieba', link: '/adapters/browser/tieba' },
                 { text: 'Bilibili', link: '/adapters/browser/bilibili' },
                 { text: 'Zhihu', link: '/adapters/browser/zhihu' },
                 { text: 'Xiaohongshu', link: '/adapters/browser/xiaohongshu' },
@@ -68,6 +69,7 @@ export default defineConfig({
                 { text: 'Jimeng', link: '/adapters/browser/jimeng' },
                 { text: 'Yollomi', link: '/adapters/browser/yollomi' },
                 { text: 'LINUX DO', link: '/adapters/browser/linux-do' },
+                { text: 'Band', link: '/adapters/browser/band' },
                 { text: 'Chaoxing', link: '/adapters/browser/chaoxing' },
                 { text: 'Grok', link: '/adapters/browser/grok' },
                 { text: 'WeRead', link: '/adapters/browser/weread' },
@@ -104,6 +106,7 @@ export default defineConfig({
                 { text: 'Barchart', link: '/adapters/browser/barchart' },
                 { text: 'Hugging Face', link: '/adapters/browser/hf' },
                 { text: 'Sina Finance', link: '/adapters/browser/sinafinance' },
+                { text: 'Spotify', link: '/adapters/browser/spotify' },
                 { text: 'Stack Overflow', link: '/adapters/browser/stackoverflow' },
                 { text: 'Wikipedia', link: '/adapters/browser/wikipedia' },
                 { text: 'Lobsters', link: '/adapters/browser/lobsters' },