@jackwener/opencli 1.3.3 → 1.4.0

package/src/clis/bilibili/subtitle.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError, CommandExecutionError, EmptyResultError, SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 import { apiGet } from './utils.js';
 
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['index', 'from', 'to', 'content'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for bilibili subtitle');
     // 1. 先前往视频详情页 (建立有鉴权的 Session，且这里不需要加载完整个视频)
     await page.goto(`https://www.bilibili.com/video/${kwargs.bvid}/`);
 
@@ -24,7 +25,7 @@ cli({
     })()`);
 
     if (!cid) {
-      throw new Error('无法在页面中提取到当前视频的 CID，请检查页面是否正常加载。');
+      throw new SelectorError('videoData.cid', '无法在页面中提取到当前视频的 CID，请检查页面是否正常加载。');
     }
 
     // 3. 在 Node 端使用 apiGet 获取带 Wbi 签名的字幕列表
@@ -35,12 +36,12 @@ cli({
     });
 
     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. 选择目标字幕语言
@@ -50,7 +51,7 @@ cli({
 
     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;
@@ -81,12 +82,12 @@ 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. 数据映射

package/src/clis/bilibili/utils.ts

@@ -3,7 +3,7 @@
  */
 
 import type { IPage } from '../../types.js';
-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,
@@ -112,5 +112,5 @@ export async function resolveUid(page: IPage, input: string): Promise<string> {
   });
   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/src/clis/boss/batchgreet.ts

@@ -5,7 +5,7 @@ import { cli, Strategy } from '../../registry.js';
 import {
   requirePage, navigateToChat, fetchRecommendList,
   clickCandidateInList, typeAndSendMessage, verbose,
-} from './common.js';
+} from './utils.js';
 
 cli({
   site: 'boss',

package/src/clis/boss/chatlist.ts

@@ -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',

package/src/clis/boss/chatmsg.ts

@@ -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',

package/src/clis/boss/detail.ts

@@ -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',

package/src/clis/boss/exchange.ts

@@ -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',

package/src/clis/boss/greet.ts

@@ -5,7 +5,7 @@ import { cli, Strategy } from '../../registry.js';
 import {
   requirePage, navigateToChat, findFriendByUid,
   clickCandidateInList, typeAndSendMessage, verbose,
-} from './common.js';
+} from './utils.js';
 
 cli({
   site: 'boss',

package/src/clis/boss/invite.ts

@@ -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',

package/src/clis/boss/joblist.ts

@@ -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',

package/src/clis/boss/mark.ts

@@ -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: Record<string, number> = {
   '新招呼': 1, '沟通中': 2, '已约面': 3, '已获取简历': 4,
@@ -44,7 +45,7 @@ cli({
       if (entry) {
         labelId = entry[1];
       } else {
-        throw new Error(`未知标签: ${labelInput}。可用标签: ${Object.keys(LABEL_MAP).join(', ')}`);
+        throw new ArgumentError(`未知标签: ${labelInput}。可用标签: ${Object.keys(LABEL_MAP).join(', ')}`);
       }
     }
 
@@ -53,7 +54,7 @@ cli({
     await navigateToChat(page);
 
     const friend = await findFriendByUid(page, kwargs.uid, { checkGreetList: true });
-    if (!friend) throw new Error('未找到该候选人');
+    if (!friend) throw new EmptyResultError('boss candidate search');
 
     const friendName = friend.name || '候选人';
     const action = remove ? 'deleteMark' : 'addMark';

package/src/clis/boss/recommend.ts

@@ -2,7 +2,7 @@
  * BOSS直聘 recommend — view recommended candidates (新招呼/greet sort list).
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, bossFetch, fetchRecommendList, verbose } from './common.js';
+import { requirePage, navigateToChat, bossFetch, fetchRecommendList, verbose } from './utils.js';
 
 cli({
   site: 'boss',

package/src/clis/boss/resume.ts

@@ -10,7 +10,7 @@
  *  .position-content → job being discussed + expectation
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, findFriendByUid, clickCandidateInList } from './common.js';
+import { requirePage, navigateToChat, findFriendByUid, clickCandidateInList } from './utils.js';
 
 cli({
   site: 'boss',

package/src/clis/boss/search.ts

@@ -2,7 +2,7 @@
  * BOSS直聘 job search — browser cookie API.
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateTo, bossFetch, assertOk, verbose } from './common.js';
+import { requirePage, navigateTo, bossFetch, assertOk, verbose } from './utils.js';
 
 /** City name → BOSS Zhipin city code mapping */
 const CITY_CODES: Record<string, string> = {

package/src/clis/boss/send.ts

@@ -8,7 +8,8 @@ import { cli, Strategy } from '../../registry.js';
 import {
   requirePage, navigateToChat, findFriendByUid,
   clickCandidateInList, typeAndSendMessage,
-} from './common.js';
+} from './utils.js';
+import { EmptyResultError, SelectorError } from '../../errors.js';
 
 cli({
   site: 'boss',
@@ -29,21 +30,21 @@ cli({
     await navigateToChat(page, 3);
 
     const friend = await findFriendByUid(page, kwargs.uid, { maxPages: 5 });
-    if (!friend) throw new Error('未找到该候选人，请确认 uid 是否正确');
+    if (!friend) throw new EmptyResultError('boss candidate search', '请确认 uid 是否正确');
 
     const numericUid = friend.uid;
     const friendName = friend.name || '候选人';
 
     const clicked = await clickCandidateInList(page, numericUid);
     if (!clicked) {
-      throw new Error('无法在聊天列表中找到该用户，请确认聊天列表中有此人');
+      throw new SelectorError('聊天列表中的用户', '请确认聊天列表中有此人');
     }
 
     await page.wait({ time: 2 });
 
     const sent = await typeAndSendMessage(page, kwargs.text);
     if (!sent) {
-      throw new Error('找不到消息输入框');
+      throw new SelectorError('消息输入框', '聊天页面 UI 可能已改变');
     }
 
     await page.wait({ time: 1 });

package/src/clis/boss/stats.ts

@@ -2,7 +2,7 @@
  * BOSS直聘 stats — job statistics overview.
  */
 import { cli, Strategy } from '../../registry.js';
-import { requirePage, navigateToChat, bossFetch, fetchFriendList, verbose } from './common.js';
+import { requirePage, navigateToChat, bossFetch, fetchFriendList, verbose } from './utils.js';
 
 cli({
   site: 'boss',

package/src/clis/chatgpt/ask.ts

@@ -1,5 +1,6 @@
 import { execSync, spawnSync } from 'node:child_process';
 import { cli, Strategy } from '../../registry.js';
+import { ConfigError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 import { getVisibleChatMessages } from './ax.js';
 
@@ -16,6 +17,10 @@ export const askCommand = cli({
   ],
   columns: ['Role', 'Text'],
   func: async (page: IPage | null, kwargs: any) => {
+    if (process.platform !== 'darwin') {
+      throw new ConfigError('ChatGPT Desktop integration requires macOS (osascript is not available on this platform)');
+    }
+
     const text = kwargs.text as string;
     const timeout = parseInt(kwargs.timeout as string, 10) || 30;
 

package/src/clis/chatgpt/new.ts

@@ -1,5 +1,6 @@
 import { execSync } from 'node:child_process';
 import { cli, Strategy } from '../../registry.js';
+import { ConfigError, getErrorMessage } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const newCommand = cli({
@@ -12,13 +13,17 @@ export const newCommand = cli({
   args: [],
   columns: ['Status'],
   func: async (page: IPage | null) => {
+    if (process.platform !== 'darwin') {
+      throw new ConfigError('ChatGPT Desktop integration requires macOS (osascript is not available on this platform)');
+    }
+
     try {
       execSync("osascript -e 'tell application \"ChatGPT\" to activate'");
       execSync("osascript -e 'delay 0.5'");
       execSync("osascript -e 'tell application \"System Events\" to keystroke \"n\" using command down'");
       return [{ Status: 'Success' }];
-    } catch (err: any) {
-      return [{ Status: "Error: " + err.message }];
+    } catch (err) {
+      return [{ Status: "Error: " + getErrorMessage(err) }];
     }
   },
 });

package/src/clis/chatgpt/read.ts

@@ -1,5 +1,6 @@
 import { execSync } from 'node:child_process';
 import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError, ConfigError, getErrorMessage } from '../../errors.js';
 import type { IPage } from '../../types.js';
 import { getVisibleChatMessages } from './ax.js';
 
@@ -13,6 +14,10 @@ export const readCommand = cli({
   args: [],
   columns: ['Role', 'Text'],
   func: async (page: IPage | null) => {
+    if (process.platform !== 'darwin') {
+      throw new ConfigError('ChatGPT Desktop integration requires macOS (osascript is not available on this platform)');
+    }
+
     try {
       execSync("osascript -e 'tell application \"ChatGPT\" to activate'");
       execSync("osascript -e 'delay 0.3'");
@@ -23,8 +28,8 @@ export const readCommand = cli({
       }
 
       return [{ Role: 'Assistant', Text: messages[messages.length - 1] }];
-    } catch (err: any) {
-      throw new Error("Failed to read from ChatGPT: " + err.message);
+    } catch (err) {
+      throw new CommandExecutionError("Failed to read from ChatGPT: " + getErrorMessage(err));
     }
   },
 });

package/src/clis/chatgpt/send.ts

@@ -1,6 +1,7 @@
 import { execSync, spawnSync } from 'node:child_process';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
+import { getErrorMessage } from '../../errors.js';
 
 export const sendCommand = cli({
   site: 'chatgpt',
@@ -41,8 +42,8 @@ export const sendCommand = cli({
       }
 
       return [{ Status: 'Success' }];
-    } catch (err: any) {
-      return [{ Status: "Error: " + err.message }];
+    } catch (err) {
+      return [{ Status: "Error: " + getErrorMessage(err) }];
     }
   },
 });

package/src/clis/chatgpt/status.ts

@@ -1,5 +1,6 @@
 import { execSync } from 'node:child_process';
 import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError, ConfigError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const statusCommand = cli({
@@ -12,11 +13,15 @@ export const statusCommand = cli({
   args: [],
   columns: ['Status'],
   func: async (page: IPage | null) => {
+    if (process.platform !== 'darwin') {
+      throw new ConfigError('ChatGPT Desktop integration requires macOS (osascript is not available on this platform)');
+    }
+
     try {
       const output = execSync("osascript -e 'application \"ChatGPT\" is running'", { encoding: 'utf-8' }).trim();
       return [{ Status: output === 'true' ? 'Running' : 'Stopped' }];
     } catch {
-      return [{ Status: 'Error querying application state' }];
+      throw new CommandExecutionError('Error querying ChatGPT application state');
     }
   },
 });

package/src/clis/chatwise/ask.ts

@@ -1,5 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
 export const askCommand = cli({
   site: 'chatwise',
@@ -8,6 +10,7 @@ export const askCommand = cli({
   domain: 'localhost',
   strategy: Strategy.UI,
   browser: true,
+  requiredEnv: chatwiseRequiredEnv,
   args: [
     { name: 'text', required: true, positional: true, help: 'Prompt to send' },
     { name: 'timeout', required: false, help: 'Max seconds to wait (default: 30)', default: '30' },
@@ -26,14 +29,14 @@ export const askCommand = cli({
     `);
 
     // Send message
-    await page.evaluate(`
+    const injected = await page.evaluate(`
       (function(text) {
         let composer = document.querySelector('textarea');
         if (!composer) {
           const editables = Array.from(document.querySelectorAll('[contenteditable="true"]'));
           composer = editables.length > 0 ? editables[editables.length - 1] : null;
         }
-        if (!composer) throw new Error('Could not find input');
+        if (!composer) return false;
         composer.focus();
         if (composer.tagName === 'TEXTAREA') {
           const setter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set;
@@ -42,8 +45,10 @@ export const askCommand = cli({
         } else {
           document.execCommand('insertText', false, text);
         }
+        return true;
       })(${JSON.stringify(text)})
     `);
+    if (!injected) throw new SelectorError('ChatWise input element');
 
     await page.wait(0.5);
     await page.pressKey('Enter');

package/src/clis/chatwise/export.ts

@@ -1,6 +1,7 @@
 import * as fs from 'node:fs';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
 export const exportCommand = cli({
   site: 'chatwise',
@@ -9,6 +10,7 @@ export const exportCommand = cli({
   domain: 'localhost',
   strategy: Strategy.UI,
   browser: true,
+  requiredEnv: chatwiseRequiredEnv,
   args: [
     { name: 'output', required: false,  help: 'Output file (default: /tmp/chatwise-export.md)' },
   ],

package/src/clis/chatwise/history.ts

@@ -1,5 +1,6 @@
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
 export const historyCommand = cli({
   site: 'chatwise',
@@ -8,6 +9,7 @@ export const historyCommand = cli({
   domain: 'localhost',
   strategy: Strategy.UI,
   browser: true,
+  requiredEnv: chatwiseRequiredEnv,
   args: [],
   columns: ['Index', 'Title'],
   func: async (page: IPage) => {

package/src/clis/chatwise/model.ts

@@ -1,5 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
 export const modelCommand = cli({
   site: 'chatwise',
@@ -8,6 +10,7 @@ export const modelCommand = cli({
   domain: 'localhost',
   strategy: Strategy.UI,
   browser: true,
+  requiredEnv: chatwiseRequiredEnv,
   args: [
     { name: 'model-name', required: false, positional: true, help: 'Model to switch to (e.g. gpt-4, claude-3)' },
   ],
@@ -44,7 +47,7 @@ export const modelCommand = cli({
       return [{ Status: 'Active', Model: currentModel }];
     } else {
       // Try to switch model
-      await page.evaluate(`
+      const opened = await page.evaluate(`
         (function(target) {
           const selectors = [
             '[class*="model"]',
@@ -54,11 +57,12 @@ export const modelCommand = cli({
           
           for (const sel of selectors) {
             const el = document.querySelector(sel);
-            if (el) { el.click(); return; }
+            if (el) { el.click(); return true; }
           }
-          throw new Error('Could not find model selector');
+          return false;
         })(${JSON.stringify(desiredModel)})
       `);
+      if (!opened) throw new SelectorError('ChatWise model selector');
 
       await page.wait(0.5);
 

package/src/clis/chatwise/new.ts

@@ -1,21 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
+import { makeNewCommand } from '../_shared/desktop-commands.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
-export const newCommand = cli({
-  site: 'chatwise',
-  name: 'new',
-  description: 'Start a new conversation in ChatWise',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  args: [],
-  columns: ['Status'],
-  func: async (page: IPage) => {
-    // ChatWise uses standard Electron shortcuts
-    const isMac = process.platform === 'darwin';
-    await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
-    await page.wait(1);
-
-    return [{ Status: 'Success' }];
-  },
-});
+export const newCommand = makeNewCommand('chatwise', 'ChatWise conversation', { requiredEnv: chatwiseRequiredEnv });

package/src/clis/chatwise/read.ts

@@ -1,5 +1,6 @@
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
 export const readCommand = cli({
   site: 'chatwise',
@@ -8,6 +9,7 @@ export const readCommand = cli({
   domain: 'localhost',
   strategy: Strategy.UI,
   browser: true,
+  requiredEnv: chatwiseRequiredEnv,
   args: [],
   columns: ['Content'],
   func: async (page: IPage) => {

package/src/clis/chatwise/screenshot.ts

@@ -1,33 +1,4 @@
-import * as fs from 'node:fs';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
+import { makeScreenshotCommand } from '../_shared/desktop-commands.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
-export const screenshotCommand = cli({
-  site: 'chatwise',
-  name: 'screenshot',
-  description: 'Capture a snapshot of the current ChatWise window (DOM + Accessibility tree)',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  args: [
-    { name: 'output', required: false,  help: 'Output file path (default: /tmp/chatwise-snapshot)' },
-  ],
-  columns: ['Status', 'File'],
-  func: async (page: IPage, kwargs: any) => {
-    const basePath = (kwargs.output as string) || '/tmp/chatwise-snapshot';
-
-    const snap = await page.snapshot({ compact: true });
-    const html = await page.evaluate('document.documentElement.outerHTML');
-
-    const htmlPath = basePath + '-dom.html';
-    const snapPath = basePath + '-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 },
-    ];
-  },
-});
+export const screenshotCommand = makeScreenshotCommand('chatwise', 'ChatWise', { requiredEnv: chatwiseRequiredEnv });

package/src/clis/chatwise/send.ts

@@ -1,5 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
 export const sendCommand = cli({
   site: 'chatwise',
@@ -8,12 +10,13 @@ export const sendCommand = cli({
   domain: 'localhost',
   strategy: Strategy.UI,
   browser: true,
+  requiredEnv: chatwiseRequiredEnv,
   args: [{ name: 'text', required: true, positional: true, help: 'Message to send' }],
   columns: ['Status', 'InjectedText'],
   func: async (page: IPage, kwargs: any) => {
     const text = kwargs.text as string;
 
-    await page.evaluate(`
+    const injected = await page.evaluate(`
       (function(text) {
         // ChatWise input can be textarea or contenteditable
         let composer = document.querySelector('textarea');
@@ -22,7 +25,7 @@ export const sendCommand = cli({
           composer = editables.length > 0 ? editables[editables.length - 1] : null;
         }
 
-        if (!composer) throw new Error('Could not find ChatWise input element');
+        if (!composer) return false;
 
         composer.focus();
         
@@ -34,8 +37,10 @@ export const sendCommand = cli({
         } else {
           document.execCommand('insertText', false, text);
         }
+        return true;
       })(${JSON.stringify(text)})
     `);
+    if (!injected) throw new SelectorError('ChatWise input element');
 
     await page.wait(0.5);
     await page.pressKey('Enter');

package/src/clis/chatwise/shared.ts

@@ -0,0 +1,8 @@
+import type { RequiredEnv } from '../../registry.js';
+
+export const chatwiseRequiredEnv: RequiredEnv[] = [
+  {
+    name: 'OPENCLI_CDP_ENDPOINT',
+    help: 'Launch ChatWise with --remote-debugging-port=9228, then run OPENCLI_CDP_ENDPOINT=http://127.0.0.1:9228 opencli chatwise status. If you use a local proxy, also set NO_PROXY=127.0.0.1,localhost.',
+  },
+];