@jackwener/opencli 1.3.3 → 1.4.1

package/dist/cli.js

@@ -14,6 +14,7 @@ import { PKG_VERSION } from './version.js';
 import { printCompletionScript } from './completion.js';
 import { loadExternalClis, executeExternalCli, installExternalCli, registerExternalCli, isBinaryInstalled } from './external.js';
 import { registerAllCommands } from './commanderAdapter.js';
+import { getErrorMessage } from './errors.js';
 export function runCli(BUILTIN_CLIS, USER_CLIS) {
     const program = new Command();
     // enablePositionalOptions: prevents parent from consuming flags meant for subcommands;
@@ -157,8 +158,6 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         const r = await generateCliFromUrl({
             url,
             BrowserFactory: getBrowserFactory(),
-            builtinClis: BUILTIN_CLIS,
-            userClis: USER_CLIS,
             goal: opts.goal,
             site: opts.site,
             workspace,
@@ -240,7 +239,7 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
             console.log(chalk.green(`✅ Plugin "${name}" installed successfully. Commands are ready to use.`));
         }
         catch (err) {
-            console.error(chalk.red(`Error: ${err.message}`));
+            console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
             process.exitCode = 1;
         }
     });
@@ -255,24 +254,64 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
             console.log(chalk.green(`✅ Plugin "${name}" uninstalled.`));
         }
         catch (err) {
-            console.error(chalk.red(`Error: ${err.message}`));
+            console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
             process.exitCode = 1;
         }
     });
     pluginCmd
         .command('update')
-        .description('Update a plugin to the latest version')
-        .argument('<name>', 'Plugin name')
-        .action(async (name) => {
-        const { updatePlugin } = await import('./plugin.js');
+        .description('Update a plugin (or all plugins) to the latest version')
+        .argument('[name]', 'Plugin name (required unless --all is passed)')
+        .option('--all', 'Update all installed plugins')
+        .action(async (name, opts) => {
+        if (!name && !opts.all) {
+            console.error(chalk.red('Error: Please specify a plugin name or use the --all flag.'));
+            process.exitCode = 1;
+            return;
+        }
+        if (name && opts.all) {
+            console.error(chalk.red('Error: Cannot specify both a plugin name and --all.'));
+            process.exitCode = 1;
+            return;
+        }
+        const { updatePlugin, updateAllPlugins } = await import('./plugin.js');
         const { discoverPlugins } = await import('./discovery.js');
+        if (opts.all) {
+            const results = updateAllPlugins();
+            if (results.length > 0) {
+                await discoverPlugins();
+            }
+            let hasErrors = false;
+            console.log(chalk.bold('  Update Results:'));
+            for (const result of results) {
+                if (result.success) {
+                    console.log(`  ${chalk.green('✓')} ${result.name}`);
+                    continue;
+                }
+                hasErrors = true;
+                console.log(`  ${chalk.red('✗')} ${result.name} — ${chalk.dim(result.error)}`);
+            }
+            if (results.length === 0) {
+                console.log(chalk.dim('  No plugins installed.'));
+                return;
+            }
+            console.log();
+            if (hasErrors) {
+                console.error(chalk.red('Completed with some errors.'));
+                process.exitCode = 1;
+            }
+            else {
+                console.log(chalk.green('✅ All plugins updated successfully.'));
+            }
+            return;
+        }
         try {
             updatePlugin(name);
             await discoverPlugins();
             console.log(chalk.green(`✅ Plugin "${name}" updated successfully.`));
         }
         catch (err) {
-            console.error(chalk.red(`Error: ${err.message}`));
+            console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
             process.exitCode = 1;
         }
     });
@@ -301,9 +340,10 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         console.log(chalk.bold('  Installed plugins'));
         console.log();
         for (const p of plugins) {
+            const version = p.version ? chalk.green(` @${p.version}`) : '';
             const cmds = p.commands.length > 0 ? chalk.dim(` (${p.commands.join(', ')})`) : '';
             const src = p.source ? chalk.dim(` ← ${p.source}`) : '';
-            console.log(`  ${chalk.cyan(p.name)}${cmds}${src}`);
+            console.log(`  ${chalk.cyan(p.name)}${version}${cmds}${src}`);
         }
         console.log();
         console.log(chalk.dim(`  ${plugins.length} plugin(s) installed`));
@@ -343,7 +383,7 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
             executeExternalCli(name, args, externalClis);
         }
         catch (err) {
-            console.error(chalk.red(`Error: ${err.message}`));
+            console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
             process.exitCode = 1;
         }
     }
@@ -374,28 +414,16 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
     siteGroups.set('antigravity', antigravityCmd);
     registerAllCommands(program, siteGroups);
     // ── Unknown command fallback ──────────────────────────────────────────────
-    const DENY_LIST = new Set([
-        'rm', 'sudo', 'dd', 'mkfs', 'fdisk', 'shutdown', 'reboot',
-        'kill', 'killall', 'chmod', 'chown', 'passwd', 'su', 'mount',
-        'umount', 'format', 'diskutil',
-    ]);
+    // Security: do NOT auto-discover and register arbitrary system binaries.
+    // Only explicitly registered external CLIs (via `opencli register`) are allowed.
     program.on('command:*', (operands) => {
         const binary = operands[0];
-        if (DENY_LIST.has(binary)) {
-            console.error(chalk.red(`Refusing to register system command '${binary}'.`));
-            process.exitCode = 1;
-            return;
-        }
+        console.error(chalk.red(`error: unknown command '${binary}'`));
         if (isBinaryInstalled(binary)) {
-            console.log(chalk.cyan(`🔹 Auto-discovered local CLI '${binary}'. Registering...`));
-            registerExternalCli(binary);
-            passthroughExternal(binary);
-        }
-        else {
-            console.error(chalk.red(`error: unknown command '${binary}'`));
-            program.outputHelp();
-            process.exitCode = 1;
+            console.error(chalk.dim(`  Tip: '${binary}' exists on your PATH. Use 'opencli register ${binary}' to add it as an external CLI.`));
         }
+        program.outputHelp();
+        process.exitCode = 1;
     });
     program.parse();
 }

package/dist/clis/_shared/desktop-commands.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared command factories for Electron/desktop app adapters.
+ * Eliminates duplicate screenshot/status/new/dump implementations
+ * across cursor, codex, chatwise, etc.
+ */
+import type { CliOptions } from '../../registry.js';
+/**
+ * Factory: capture DOM HTML + accessibility snapshot.
+ */
+export declare function makeScreenshotCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../registry.js").CliCommand;
+/**
+ * Factory: check CDP connection status.
+ */
+export declare function makeStatusCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../registry.js").CliCommand;
+/**
+ * Factory: start a new session via Cmd/Ctrl+N.
+ */
+export declare function makeNewCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../registry.js").CliCommand;
+/**
+ * Factory: dump DOM + snapshot for reverse-engineering.
+ */
+export declare function makeDumpCommand(site: string): import("../../registry.js").CliCommand;

package/dist/clis/_shared/desktop-commands.js

@@ -0,0 +1,108 @@
+/**
+ * Shared command factories for Electron/desktop app adapters.
+ * Eliminates duplicate screenshot/status/new/dump implementations
+ * across cursor, codex, chatwise, etc.
+ */
+import * as fs from 'node:fs';
+import { cli, Strategy } from '../../registry.js';
+/**
+ * Factory: capture DOM HTML + accessibility snapshot.
+ */
+export function makeScreenshotCommand(site, displayName, extra = {}) {
+    const label = displayName ?? site;
+    return cli({
+        ...extra,
+        site,
+        name: 'screenshot',
+        description: `Capture a snapshot of the current ${label} window (DOM + Accessibility tree)`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        args: [
+            { name: 'output', required: false, help: `Output file path (default: /tmp/${site}-snapshot.txt)` },
+        ],
+        columns: ['Status', 'File'],
+        func: async (page, kwargs) => {
+            const outputPath = kwargs.output || `/tmp/${site}-snapshot.txt`;
+            const snap = await page.snapshot({ compact: true });
+            const html = await page.evaluate('document.documentElement.outerHTML');
+            const htmlPath = outputPath.replace(/\.\w+$/, '') + '-dom.html';
+            const snapPath = outputPath.replace(/\.\w+$/, '') + '-a11y.txt';
+            fs.writeFileSync(htmlPath, html);
+            fs.writeFileSync(snapPath, typeof snap === 'string' ? snap : JSON.stringify(snap, null, 2));
+            return [
+                { Status: 'Success', File: htmlPath },
+                { Status: 'Success', File: snapPath },
+            ];
+        },
+    });
+}
+/**
+ * Factory: check CDP connection status.
+ */
+export function makeStatusCommand(site, displayName, extra = {}) {
+    const label = displayName ?? site;
+    return cli({
+        ...extra,
+        site,
+        name: 'status',
+        description: `Check active CDP connection to ${label}`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        columns: ['Status', 'Url', 'Title'],
+        func: async (page) => {
+            const url = await page.evaluate('window.location.href');
+            const title = await page.evaluate('document.title');
+            return [{ Status: 'Connected', Url: url, Title: title }];
+        },
+    });
+}
+/**
+ * Factory: start a new session via Cmd/Ctrl+N.
+ */
+export function makeNewCommand(site, displayName, extra = {}) {
+    const label = displayName ?? site;
+    return cli({
+        ...extra,
+        site,
+        name: 'new',
+        description: `Start a new ${label} session`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        columns: ['Status'],
+        func: async (page) => {
+            const isMac = process.platform === 'darwin';
+            await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
+            await page.wait(1);
+            return [{ Status: 'Success' }];
+        },
+    });
+}
+/**
+ * Factory: dump DOM + snapshot for reverse-engineering.
+ */
+export function makeDumpCommand(site) {
+    return cli({
+        site,
+        name: 'dump',
+        description: `Dump the DOM and Accessibility tree of ${site} for reverse-engineering`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        columns: ['action', 'files'],
+        func: async (page) => {
+            const dom = await page.evaluate('document.body.innerHTML');
+            fs.writeFileSync(`/tmp/${site}-dom.html`, dom);
+            const snap = await page.snapshot({ interactive: false });
+            fs.writeFileSync(`/tmp/${site}-snapshot.json`, JSON.stringify(snap, null, 2));
+            return [
+                {
+                    action: 'Dom extraction finished',
+                    files: `/tmp/${site}-dom.html, /tmp/${site}-snapshot.json`,
+                },
+            ];
+        },
+    });
+}

package/dist/clis/antigravity/serve.js

@@ -11,6 +11,7 @@
  */
 import { createServer } from 'node:http';
 import { CDPBridge } from '../../browser/cdp.js';
+import { getErrorMessage } from '../../errors.js';
 // ─── Helpers ─────────────────────────────────────────────────────────
 function generateMsgId() {
     const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
@@ -389,12 +390,14 @@ export async function startServe(opts = {}) {
         }
         catch (err) {
             cdp = null;
-            const isRefused = err?.cause?.code === 'ECONNREFUSED' || err?.message?.includes('ECONNREFUSED');
+            const errMsg = getErrorMessage(err);
+            const cause = err instanceof Error ? err.cause : undefined;
+            const isRefused = cause?.code === 'ECONNREFUSED' || errMsg.includes('ECONNREFUSED');
             throw new Error(isRefused
                 ? `Cannot connect to Antigravity at ${endpoint}.\n` +
                     '  1. Make sure Antigravity is running\n' +
                     '  2. Launch with: --remote-debugging-port=9224'
-                : `CDP connection failed: ${err.message}`);
+                : `CDP connection failed: ${errMsg}`);
         }
         console.error('[serve] ✅ CDP connected.');
         // Quick verification

package/dist/clis/apple-podcasts/search.js

@@ -11,7 +11,7 @@ cli({
         { name: 'query', positional: true, required: true, help: 'Search keyword' },
         { name: 'limit', type: 'int', default: 10, help: 'Max results' },
     ],
-    columns: ['id', 'title', 'author', 'episodes', 'genre'],
+    columns: ['id', 'title', 'author', 'episodes', 'genre', 'url'],
     func: async (_page, args) => {
         const term = encodeURIComponent(args.query);
         const limit = Math.max(1, Math.min(Number(args.limit), 25));
@@ -24,6 +24,7 @@ cli({
             author: p.artistName,
             episodes: p.trackCount ?? '-',
             genre: p.primaryGenreName ?? '-',
+            url: p.collectionViewUrl || '',
         }));
     },
 });

package/dist/clis/arxiv/search.js

@@ -11,14 +11,14 @@ cli({
         { name: 'query', positional: true, required: true, help: 'Search keyword (e.g. "attention is all you need")' },
         { name: 'limit', type: 'int', default: 10, help: 'Max results (max 25)' },
     ],
-    columns: ['id', 'title', 'authors', 'published'],
+    columns: ['id', 'title', 'authors', 'published', 'url'],
     func: async (_page, args) => {
         const limit = Math.max(1, Math.min(Number(args.limit), 25));
-        const query = encodeURIComponent(`all:${args.keyword}`);
+        const query = encodeURIComponent(`all:${args.query}`);
         const xml = await arxivFetch(`search_query=${query}&max_results=${limit}&sortBy=relevance`);
         const entries = parseEntries(xml);
         if (!entries.length)
             throw new CliError('NOT_FOUND', 'No papers found', 'Try a different keyword');
-        return entries.map(e => ({ id: e.id, title: e.title, authors: e.authors, published: e.published }));
+        return entries.map(e => ({ id: e.id, title: e.title, authors: e.authors, published: e.published, url: e.url }));
     },
 });

package/dist/clis/bbc/news.js

@@ -1,6 +1,5 @@
 /**
  * BBC News headlines — public RSS feed, no browser needed.
- * Source: bb-sites/bbc/news.js
  */
 import { cli, Strategy } from '../../registry.js';
 cli({

package/dist/clis/bilibili/dynamic.test.d.ts

@@ -0,0 +1 @@
+import './dynamic.js';

package/dist/clis/bilibili/dynamic.test.js

@@ -0,0 +1,68 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockApiGet } = vi.hoisted(() => ({
+    mockApiGet: vi.fn(),
+}));
+vi.mock('./utils.js', () => ({
+    apiGet: mockApiGet,
+}));
+import { getRegistry } from '../../registry.js';
+import './dynamic.js';
+describe('bilibili dynamic adapter', () => {
+    const command = getRegistry().get('bilibili/dynamic');
+    beforeEach(() => {
+        mockApiGet.mockReset();
+    });
+    it('maps desc text rows from the dynamic feed payload', async () => {
+        mockApiGet.mockResolvedValue({
+            data: {
+                items: [
+                    {
+                        id_str: '123',
+                        modules: {
+                            module_author: { name: 'Alice' },
+                            module_dynamic: { desc: { text: 'hello world' } },
+                            module_stat: { like: { count: 9 } },
+                        },
+                    },
+                ],
+            },
+        });
+        const result = await command.func({}, { limit: 5 });
+        expect(mockApiGet).toHaveBeenCalledWith({}, '/x/polymer/web-dynamic/v1/feed/all', { params: {}, signed: false });
+        expect(result).toEqual([
+            {
+                id: '123',
+                author: 'Alice',
+                text: 'hello world',
+                likes: 9,
+                url: 'https://t.bilibili.com/123',
+            },
+        ]);
+    });
+    it('falls back to archive title when desc text is absent', async () => {
+        mockApiGet.mockResolvedValue({
+            data: {
+                items: [
+                    {
+                        id_str: '456',
+                        modules: {
+                            module_author: { name: 'Bob' },
+                            module_dynamic: { major: { archive: { title: 'Video title' } } },
+                            module_stat: { like: { count: 3 } },
+                        },
+                    },
+                ],
+            },
+        });
+        const result = await command.func({}, { limit: 5 });
+        expect(result).toEqual([
+            {
+                id: '456',
+                author: 'Bob',
+                text: 'Video title',
+                likes: 3,
+                url: 'https://t.bilibili.com/456',
+            },
+        ]);
+    });
+});

package/dist/clis/bilibili/favorite.js

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { apiGet, payloadData } from './utils.js';
+import { apiGet, payloadData, getSelfUid } from './utils.js';
 cli({
     site: 'bilibili',
     name: 'favorite',
@@ -13,9 +13,11 @@ cli({
     columns: ['rank', 'title', 'author', 'plays', 'url'],
     func: async (page, kwargs) => {
         const { limit = 20, page: pageNum = 1 } = kwargs;
+        // Get current user's UID
+        const uid = await getSelfUid(page);
         // Get default favorite folder ID
         const foldersPayload = await apiGet(page, '/x/v3/fav/folder/created/list-all', {
-            params: { up_mid: 0 },
+            params: { up_mid: uid },
             signed: true,
         });
         const folders = payloadData(foldersPayload)?.list ?? [];

package/dist/clis/bilibili/following.js

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError } from '../../errors.js';
 import { fetchJson, getSelfUid, resolveUid } from './utils.js';
 cli({
     site: 'bilibili',
@@ -13,7 +14,7 @@ cli({
     columns: ['mid', 'name', 'sign', 'following', 'fans'],
     func: async (page, kwargs) => {
         if (!page)
-            throw new Error('Requires browser');
+            throw new CommandExecutionError('Browser session required for bilibili following');
         // 1. Resolve UID (default to self)
         const uid = kwargs.uid
             ? await resolveUid(page, kwargs.uid)
@@ -23,7 +24,7 @@ cli({
         // 2. Fetch following list (standard Cookie API, no Wbi signing needed)
         const payload = await fetchJson(page, `https://api.bilibili.com/x/relation/followings?vmid=${uid}&pn=${pn}&ps=${ps}&order=desc`);
         if (payload.code !== 0) {
-            throw new Error(`获取关注列表失败: ${payload.message} (${payload.code})`);
+            throw new CommandExecutionError(`获取关注列表失败: ${payload.message} (${payload.code})`);
         }
         const list = payload.data?.list || [];
         if (list.length === 0) {

package/dist/clis/bilibili/subtitle.js

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError, CommandExecutionError, EmptyResultError, SelectorError } from '../../errors.js';
 import { apiGet } from './utils.js';
 cli({
     site: 'bilibili',
@@ -12,7 +13,7 @@ cli({
     columns: ['index', 'from', 'to', 'content'],
     func: async (page, kwargs) => {
         if (!page)
-            throw new Error('Requires browser');
+            throw new CommandExecutionError('Browser session required for bilibili subtitle');
         // 1. 先前往视频详情页 (建立有鉴权的 Session，且这里不需要加载完整个视频)
         await page.goto(`https://www.bilibili.com/video/${kwargs.bvid}/`);
         // 2. 利用 __INITIAL_STATE__ 获取基础信息，拿 CID
@@ -21,7 +22,7 @@ cli({
       return state?.videoData?.cid;
     })()`);
         if (!cid) {
-            throw new Error('无法在页面中提取到当前视频的 CID，请检查页面是否正常加载。');
+            throw new SelectorError('videoData.cid', '无法在页面中提取到当前视频的 CID，请检查页面是否正常加载。');
         }
         // 3. 在 Node 端使用 apiGet 获取带 Wbi 签名的字幕列表
         // 之前纯靠 evaluate 里的 fetch 会失败，因为 B 站 /wbi/ 开头的接口强校验 w_rid，未签名直接被风控返回 403 HTML
@@ -30,11 +31,11 @@ cli({
             signed: true, // 开启 wbi_sign 自动签名
         });
         if (payload.code !== 0) {
-            throw new Error(`获取视频播放信息失败: ${payload.message} (${payload.code})`);
+            throw new CommandExecutionError(`获取视频播放信息失败: ${payload.message} (${payload.code})`);
         }
         const subtitles = payload.data?.subtitle?.subtitles || [];
         if (subtitles.length === 0) {
-            throw new Error('此视频没有发现外挂或智能字幕。');
+            throw new EmptyResultError('bilibili subtitle', '此视频没有发现外挂或智能字幕。');
         }
         // 4. 选择目标字幕语言
         const target = kwargs.lang
@@ -42,7 +43,7 @@ cli({
             : subtitles[0];
         const targetSubUrl = target.subtitle_url;
         if (!targetSubUrl || targetSubUrl === '') {
-            throw new Error('[风控拦截/未登录] 获取到的 subtitle_url 为空！请确保 CLI 已成功登录且风控未封锁此账号。');
+            throw new AuthRequiredError('bilibili.com', '[风控拦截/未登录] 获取到的 subtitle_url 为空！请确保 CLI 已成功登录且风控未封锁此账号。');
         }
         const finalUrl = targetSubUrl.startsWith('//') ? 'https:' + targetSubUrl : targetSubUrl;
         // 5. 解析并拉取 CDN 的 JSON 文件
@@ -69,11 +70,11 @@ cli({
     `;
         const items = await page.evaluate(fetchJs);
         if (items?.error) {
-            throw new Error(`字幕获取失败: ${items.error}${items.text ? ' — ' + items.text : ''}`);
+            throw new CommandExecutionError(`字幕获取失败: ${items.error}${items.text ? ' — ' + items.text : ''}`);
         }
         const finalItems = items?.data || [];
         if (!Array.isArray(finalItems)) {
-            throw new Error('解析到的字幕列表对象不符合数组格式');
+            throw new CommandExecutionError('解析到的字幕列表对象不符合数组格式');
         }
         // 6. 数据映射
         return finalItems.map((item, idx) => ({

package/dist/clis/bilibili/utils.js

@@ -1,7 +1,7 @@
 /**
  * Bilibili shared helpers: WBI signing, authenticated fetch, nav data, UID resolution.
  */
-import { AuthRequiredError } from '../../errors.js';
+import { AuthRequiredError, EmptyResultError } from '../../errors.js';
 const MIXIN_KEY_ENC_TAB = [
     46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35, 27, 43, 5, 49,
     33, 9, 42, 19, 29, 28, 14, 39, 12, 38, 41, 13, 37, 48, 7, 16, 24, 55, 40,
@@ -92,5 +92,5 @@ export async function resolveUid(page, input) {
     const results = payload?.data?.result ?? [];
     if (results.length > 0)
         return String(results[0].mid);
-    throw new Error(`Cannot resolve UID for: ${input}`);
+    throw new EmptyResultError(`bilibili user search: ${input}`, 'User may not exist or username may have changed.');
 }

package/dist/clis/boss/batchgreet.js

@@ -2,7 +2,7 @@
  * BOSS直聘 batchgreet — batch greet recommended candidates.
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, fetchRecommendList, clickCandidateInList, typeAndSendMessage, verbose, } from './common.js';
+import { requirePage, navigateToChat, fetchRecommendList, clickCandidateInList, typeAndSendMessage, verbose, } from './utils.js';
 cli({
     site: 'boss',
     name: 'batchgreet',

package/dist/clis/boss/chatlist.js

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, fetchFriendList } from './common.js';
+import { requirePage, navigateToChat, fetchFriendList } from './utils.js';
 cli({
     site: 'boss',
     name: 'chatlist',

package/dist/clis/boss/chatmsg.js

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, bossFetch, findFriendByUid } from './common.js';
+import { requirePage, navigateToChat, bossFetch, findFriendByUid } from './utils.js';
 cli({
     site: 'boss',
     name: 'chatmsg',

package/dist/clis/boss/detail.js

@@ -2,7 +2,7 @@
  * BOSS直聘 job detail — fetch full job posting details via browser cookie API.
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateTo, bossFetch, verbose } from './common.js';
+import { requirePage, navigateTo, bossFetch, verbose } from './utils.js';
 cli({
     site: 'boss',
     name: 'detail',

package/dist/clis/boss/exchange.js

@@ -2,7 +2,7 @@
  * BOSS直聘 exchange — request phone/wechat exchange with a candidate.
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './common.js';
+import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './utils.js';
 cli({
     site: 'boss',
     name: 'exchange',

package/dist/clis/boss/greet.js

@@ -2,7 +2,7 @@
  * BOSS直聘 greet — send greeting to a new candidate (initiate chat).
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, findFriendByUid, clickCandidateInList, typeAndSendMessage, verbose, } from './common.js';
+import { requirePage, navigateToChat, findFriendByUid, clickCandidateInList, typeAndSendMessage, verbose, } from './utils.js';
 cli({
     site: 'boss',
     name: 'greet',

package/dist/clis/boss/invite.js

@@ -2,7 +2,7 @@
  * BOSS直聘 invite — send interview invitation to a candidate.
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './common.js';
+import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './utils.js';
 cli({
     site: 'boss',
     name: 'invite',

package/dist/clis/boss/joblist.js

@@ -2,7 +2,7 @@
  * BOSS直聘 job list — list my published jobs via boss API.
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, bossFetch, verbose } from './common.js';
+import { requirePage, navigateToChat, bossFetch, verbose } from './utils.js';
 cli({
     site: 'boss',
     name: 'joblist',

package/dist/clis/boss/mark.js

@@ -6,7 +6,8 @@
  *   6=已交换微信, 7=不合适, 8=牛人发起, 11=收藏
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './common.js';
+import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './utils.js';
+import { ArgumentError, EmptyResultError } from '../../errors.js';
 const LABEL_MAP = {
     '新招呼': 1, '沟通中': 2, '已约面': 3, '已获取简历': 4,
     '已交换电话': 5, '已交换微信': 6, '不合适': 7, '牛人发起': 8, '收藏': 11,
@@ -43,14 +44,14 @@ cli({
                 labelId = entry[1];
             }
             else {
-                throw new Error(`未知标签: ${labelInput}。可用标签: ${Object.keys(LABEL_MAP).join(', ')}`);
+                throw new ArgumentError(`未知标签: ${labelInput}。可用标签: ${Object.keys(LABEL_MAP).join(', ')}`);
             }
         }
         verbose(`${remove ? 'Removing' : 'Adding'} label ${labelId} for ${kwargs.uid}...`);
         await navigateToChat(page);
         const friend = await findFriendByUid(page, kwargs.uid, { checkGreetList: true });
         if (!friend)
-            throw new Error('未找到该候选人');
+            throw new EmptyResultError('boss candidate search');
         const friendName = friend.name || '候选人';
         const action = remove ? 'deleteMark' : 'addMark';
         const params = new URLSearchParams({