@jackwener/opencli 1.3.3 → 1.4.0

package/src/clis/chatwise/status.ts

@@ -1,25 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
+import { makeStatusCommand } from '../_shared/desktop-commands.js';
+import { chatwiseRequiredEnv } from './shared.js';
 
-export const statusCommand = cli({
-  site: 'chatwise',
-  name: 'status',
-  description: 'Check active CDP connection to ChatWise Desktop',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  args: [],
-  columns: ['Status', 'Url', 'Title'],
-  func: async (page: IPage) => {
-    const url = await page.evaluate('window.location.href');
-    const title = await page.evaluate('document.title');
-
-    return [
-      {
-        Status: 'Connected',
-        Url: url,
-        Title: title,
-      },
-    ];
-  },
-});
+export const statusCommand = makeStatusCommand('chatwise', 'ChatWise Desktop', { requiredEnv: chatwiseRequiredEnv });

package/src/clis/codex/ask.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const askCommand = cli({
@@ -26,15 +27,17 @@ export const askCommand = cli({
     `);
 
     // Inject and send
-    await page.evaluate(`
+    const injected = await page.evaluate(`
       (function(text) {
         const editables = Array.from(document.querySelectorAll('[contenteditable="true"]'));
         const composer = editables.length > 0 ? editables[editables.length - 1] : document.querySelector('textarea');
-        if (!composer) throw new Error('Could not find Codex input');
+        if (!composer) return false;
         composer.focus();
         document.execCommand('insertText', false, text);
+        return true;
       })(${JSON.stringify(text)})
     `);
+    if (!injected) throw new SelectorError('Codex input element');
     await page.wait(0.5);
     await page.pressKey('Enter');
 

package/src/clis/codex/dump.ts

@@ -1,28 +1,3 @@
-import { cli, Strategy } from '../../registry.js';
-import * as fs from 'fs';
+import { makeDumpCommand } from '../_shared/desktop-commands.js';
 
-export const dumpCommand = cli({
-  site: 'codex',
-  name: 'dump',
-  description: 'Dump the DOM and Accessibility tree of Codex for reverse-engineering',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  columns: ['action', 'files'],
-  func: async (page) => {
-    // Extract full HTML
-    const dom = await page.evaluate('document.body.innerHTML');
-    fs.writeFileSync('/tmp/codex-dom.html', dom);
-
-    // Get accessibility snapshot
-    const snap = await page.snapshot({ interactive: false });
-    fs.writeFileSync('/tmp/codex-snapshot.json', JSON.stringify(snap, null, 2));
-
-    return [
-      {
-        action: 'Dom extraction finished',
-        files: '/tmp/codex-dom.html, /tmp/codex-snapshot.json',
-      },
-    ];
-  },
-});
+export const dumpCommand = makeDumpCommand('codex');

package/src/clis/codex/new.ts

@@ -1,29 +1,3 @@
-import { cli, Strategy } from '../../registry.js';
+import { makeNewCommand } from '../_shared/desktop-commands.js';
 
-export const newCommand = cli({
-  site: 'codex',
-  name: 'new',
-  description: 'Start a new Codex conversation thread / isolated workspace',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  columns: ['Status', 'Action'],
-  func: async (page) => {
-    // According to research, Cmd+N / Ctrl+N spins up a new thread
-    const isMac = process.platform === 'darwin';
-    const newThreadKey = isMac ? 'Meta+N' : 'Control+N';
-    
-    // Simulate keyboard shortcut
-    await page.pressKey(newThreadKey);
-
-    // Wait a brief moment for UI animation
-    await page.wait(1);
-
-    return [
-      {
-        Status: 'Success',
-        Action: `Pressed ${newThreadKey} to trigger New Thread`,
-      },
-    ];
-  },
-});
+export const newCommand = makeNewCommand('codex', 'Codex conversation');

package/src/clis/codex/screenshot.ts

@@ -1,33 +1,3 @@
-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';
 
-export const screenshotCommand = cli({
-  site: 'codex',
-  name: 'screenshot',
-  description: 'Capture a snapshot of the current Codex window (DOM + Accessibility tree)',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  args: [
-    { name: 'output', required: false,  help: 'Output file path (default: /tmp/codex-snapshot.txt)' },
-  ],
-  columns: ['Status', 'File'],
-  func: async (page: IPage, kwargs: any) => {
-    const outputPath = (kwargs.output as string) || '/tmp/codex-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 },
-    ];
-  },
-});
+export const screenshotCommand = makeScreenshotCommand('codex', 'Codex');

package/src/clis/codex/send.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const sendCommand = cli({
@@ -13,7 +14,7 @@ export const sendCommand = cli({
   func: async (page: IPage, kwargs: any) => {
     const textToInsert = kwargs.text as string;
 
-    await page.evaluate(`
+    const injected = await page.evaluate(`
       (function(text) {
         let composer = document.querySelector('textarea, [contenteditable="true"]');
         
@@ -22,14 +23,14 @@ export const sendCommand = cli({
            composer = editables[editables.length - 1];
         }
 
-        if (!composer) {
-          throw new Error('Could not find Composer input element in Codex UI');
-        }
+        if (!composer) return false;
 
         composer.focus();
         document.execCommand('insertText', false, text);
+        return true;
       })(${JSON.stringify(textToInsert)})
     `);
+    if (!injected) throw new SelectorError('Codex Composer input element');
 
     // Wait for the UI to register the input
     await page.wait(0.5);

package/src/clis/codex/status.ts

@@ -1,25 +1,3 @@
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
+import { makeStatusCommand } from '../_shared/desktop-commands.js';
 
-export const statusCommand = cli({
-  site: 'codex',
-  name: 'status',
-  description: 'Check active CDP connection to OpenAI Codex App',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  args: [],
-  columns: ['Status', 'Url', 'Title'],
-  func: async (page: IPage) => {
-    const url = await page.evaluate('window.location.href');
-    const title = await page.evaluate('document.title');
-
-    return [
-      {
-        Status: 'Connected',
-        Url: url,
-        Title: title,
-      },
-    ];
-  },
-});
+export const statusCommand = makeStatusCommand('codex', 'OpenAI Codex App');

package/src/clis/cursor/ask.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const askCommand = cli({
@@ -33,7 +34,7 @@ export const askCommand = cli({
       })(${JSON.stringify(text)})`
     );
 
-    if (!injected) throw new Error('Could not find input element.');
+    if (!injected) throw new SelectorError('Cursor input element');
     await page.wait(0.5);
     await page.pressKey('Enter');
 

package/src/clis/cursor/composer.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const composerCommand = cli({
@@ -33,7 +34,7 @@ export const composerCommand = cli({
     );
 
     if (!typed) {
-      throw new Error('Could not find Cursor Composer input element after pressing Cmd+I.');
+      throw new SelectorError('Cursor Composer input element', 'Could not find Cursor Composer input element after pressing Cmd+I.');
     }
 
     await page.wait(0.5);

package/src/clis/cursor/dump.ts

@@ -1,28 +1,3 @@
-import { cli, Strategy } from '../../registry.js';
-import * as fs from 'fs';
+import { makeDumpCommand } from '../_shared/desktop-commands.js';
 
-export const dumpCommand = cli({
-  site: 'cursor',
-  name: 'dump',
-  description: 'Dump the DOM and Accessibility tree of Cursor for reverse-engineering',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  columns: ['action', 'files'],
-  func: async (page) => {
-    // Extract full HTML
-    const dom = await page.evaluate('document.body.innerHTML');
-    fs.writeFileSync('/tmp/cursor-dom.html', dom);
-
-    // Get accessibility snapshot
-    const snap = await page.snapshot({ interactive: false });
-    fs.writeFileSync('/tmp/cursor-snapshot.json', JSON.stringify(snap, null, 2));
-
-    return [
-      {
-        action: 'Dom extraction finished',
-        files: '/tmp/cursor-dom.html, /tmp/cursor-snapshot.json',
-      },
-    ];
-  },
-});
+export const dumpCommand = makeDumpCommand('cursor');

package/src/clis/cursor/new.ts

@@ -1,21 +1,3 @@
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
+import { makeNewCommand } from '../_shared/desktop-commands.js';
 
-export const newCommand = cli({
-  site: 'cursor',
-  name: 'new',
-  description: 'Start a new Cursor chat or Composer session',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,
-  args: [],
-  columns: ['Status'],
-  func: async (page: IPage) => {
-    // Use keyboard shortcut — most robust approach, avoids brittle DOM selectors
-    const isMac = process.platform === 'darwin';
-    await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
-    await page.wait(1);
-
-    return [{ Status: 'Success' }];
-  },
-});
+export const newCommand = makeNewCommand('cursor', 'Cursor chat or Composer');

package/src/clis/cursor/read.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { EmptyResultError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const readCommand = cli({
@@ -39,7 +40,7 @@ export const readCommand = cli({
     `);
 
     if (!history || history.length === 0) {
-      throw new Error('No conversation history found in Cursor.');
+      throw new EmptyResultError('cursor read', 'No conversation history found in Cursor.');
     }
 
     return history;

package/src/clis/cursor/screenshot.ts

@@ -1,38 +1,3 @@
-import * as fs from 'node:fs';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-function makeScreenshotCommand(site: string) {
-  return cli({
-    site,
-    name: 'screenshot',
-    description: `Capture a snapshot of the current ${site} 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: IPage, kwargs: any) => {
-      const outputPath = (kwargs.output as string) || `/tmp/${site}-snapshot.txt`;
-
-      // Get both the accessibility snapshot and the raw DOM HTML
-      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 },
-      ];
-    },
-  });
-}
+import { makeScreenshotCommand } from '../_shared/desktop-commands.js';
 
 export const screenshotCursor = makeScreenshotCommand('cursor');

package/src/clis/cursor/send.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { SelectorError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export const sendCommand = cli({
@@ -29,7 +30,7 @@ export const sendCommand = cli({
     );
 
     if (!injected) {
-      throw new Error('Could not find Cursor Composer input element.');
+      throw new SelectorError('Cursor Composer input element');
     }
 
     // Submit the command. In Cursor, Enter usually submits the chat.

package/src/clis/cursor/status.ts

@@ -1,23 +1,3 @@
-import { cli, Strategy } from '../../registry.js';
+import { makeStatusCommand } from '../_shared/desktop-commands.js';
 
-export const statusCommand = cli({
-  site: 'cursor',
-  name: 'status',
-  description: 'Check active CDP connection to Cursor AI Editor',
-  domain: 'localhost',
-  strategy: Strategy.UI, // Interactive UI manipulation
-  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,
-      },
-    ];
-  },
-});
+export const statusCommand = makeStatusCommand('cursor', 'Cursor AI Editor');

package/src/clis/dictionary/examples.yaml

@@ -0,0 +1,25 @@
+site: dictionary
+name: examples
+description: Read real-world example sentences utilizing the word
+domain: api.dictionaryapi.dev
+strategy: public
+browser: false
+
+args:
+  word:
+    type: string
+    required: true
+    positional: true
+    description: Word to get example sentences for
+
+pipeline:
+  - fetch:
+      url: "https://api.dictionaryapi.dev/api/v2/entries/en/${{ args.word | urlencode }}"
+
+  - map:
+      word: "${{ item.word }}"
+      example: "${{ (() => { if (item.meanings) { for (const m of item.meanings) { if (m.definitions) { for (const d of m.definitions) { if (d.example) return d.example; } } } } return 'No example found in API.'; })() }}"
+
+  - limit: 1
+
+columns: [word, example]

package/src/clis/dictionary/search.yaml

@@ -0,0 +1,27 @@
+site: dictionary
+name: search
+description: Search the Free Dictionary API for definitions, parts of speech, and pronunciations.
+domain: api.dictionaryapi.dev
+strategy: public
+browser: false
+
+args:
+  word:
+    type: string
+    required: true
+    positional: true
+    description: Word to define (e.g., serendipity)
+
+pipeline:
+  - fetch:
+      url: "https://api.dictionaryapi.dev/api/v2/entries/en/${{ args.word | urlencode }}"
+
+  - map:
+      word: "${{ item.word }}"
+      phonetic: "${{ (() => { if (item.phonetic) return item.phonetic; if (item.phonetics) { for (const p of item.phonetics) { if (p.text) return p.text; } } return ''; })() }}"
+      type: "${{ (() => { if (item.meanings && item.meanings[0] && item.meanings[0].partOfSpeech) return item.meanings[0].partOfSpeech; return 'N/A'; })() }}"
+      definition: "${{ (() => { if (item.meanings && item.meanings[0] && item.meanings[0].definitions && item.meanings[0].definitions[0] && item.meanings[0].definitions[0].definition) return item.meanings[0].definitions[0].definition; return 'No definition found in API.'; })() }}"
+
+  - limit: 1
+
+columns: [word, phonetic, type, definition]

package/src/clis/dictionary/synonyms.yaml

@@ -0,0 +1,25 @@
+site: dictionary
+name: synonyms
+description: Find synonyms for a specific word
+domain: api.dictionaryapi.dev
+strategy: public
+browser: false
+
+args:
+  word:
+    type: string
+    required: true
+    positional: true
+    description: Word to find synonyms for (e.g., serendipity)
+
+pipeline:
+  - fetch:
+      url: "https://api.dictionaryapi.dev/api/v2/entries/en/${{ args.word | urlencode }}"
+
+  - map:
+      word: "${{ item.word }}"
+      synonyms: "${{ (() => { const s = new Set(); if (item.meanings) { for (const m of item.meanings) { if (m.synonyms) { for (const syn of m.synonyms) s.add(syn); } if (m.definitions) { for (const d of m.definitions) { if (d.synonyms) { for (const syn of d.synonyms) s.add(syn); } } } } } const arr = Array.from(s); return arr.length > 0 ? arr.slice(0, 5).join(', ') : 'No synonyms found in API.'; })() }}"
+
+  - limit: 1
+
+columns: [word, synonyms]

package/src/clis/douban/book-hot.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { loadDoubanBookHot } from './shared.js';
+import { loadDoubanBookHot } from './utils.js';
 
 cli({
   site: 'douban',

package/src/clis/douban/movie-hot.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { loadDoubanMovieHot } from './shared.js';
+import { loadDoubanMovieHot } from './utils.js';
 
 cli({
   site: 'douban',

package/src/clis/douban/search.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { searchDouban } from './shared.js';
+import { searchDouban } from './utils.js';
 
 cli({
   site: 'douban',