@jackwener/opencli 1.7.19 → 1.7.21

package/dist/src/daemon.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { getResponseCorsHeaders } from './daemon.js';
+import { COMMAND_RESULT_UNKNOWN_CODE, COMMAND_RESULT_UNKNOWN_HINT, buildCommandDispatchFailure, buildExtensionDisconnectFailure, commandResultUnknownMessage, getResponseCorsHeaders, } from './daemon-utils.js';
 describe('getResponseCorsHeaders', () => {
     it('allows the Browser Bridge extension origin to read /ping', () => {
         expect(getResponseCorsHeaders('/ping', 'chrome-extension://abc123')).toEqual({
@@ -17,3 +17,44 @@ describe('getResponseCorsHeaders', () => {
         expect(getResponseCorsHeaders('/command', 'chrome-extension://abc123')).toBeUndefined();
     });
 });
+describe('daemon command dispatch', () => {
+    it('uses a distinct command_result_unknown contract for ambiguous dispatched commands', () => {
+        expect(COMMAND_RESULT_UNKNOWN_CODE).toBe('command_result_unknown');
+        expect(commandResultUnknownMessage('navigate')).toContain('navigate command was dispatched');
+        expect(COMMAND_RESULT_UNKNOWN_HINT).toContain('Inspect the browser/session state');
+        expect(COMMAND_RESULT_UNKNOWN_HINT).toContain('Do not blindly retry write commands');
+    });
+    it('classifies dispatched extension disconnects as command_result_unknown', () => {
+        expect(buildExtensionDisconnectFailure({
+            contextId: 'work',
+            action: 'navigate',
+            dispatched: true,
+        })).toEqual({
+            message: 'Browser connection dropped after the navigate command was dispatched; it may have completed.',
+            errorCode: 'command_result_unknown',
+            errorHint: COMMAND_RESULT_UNKNOWN_HINT,
+            status: 503,
+            countAsCommandResultUnknown: true,
+        });
+    });
+    it('classifies pre-dispatch extension disconnects as profile_disconnected', () => {
+        expect(buildExtensionDisconnectFailure({
+            contextId: 'work',
+            action: 'navigate',
+            dispatched: false,
+        })).toMatchObject({
+            message: 'Browser profile "work" disconnected before command dispatch',
+            errorCode: 'profile_disconnected',
+            status: 503,
+            countAsCommandResultUnknown: false,
+        });
+    });
+    it('classifies ws.send dispatch failures as profile_disconnected', () => {
+        expect(buildCommandDispatchFailure('work')).toMatchObject({
+            message: 'Browser profile "work" disconnected before command dispatch',
+            errorCode: 'profile_disconnected',
+            status: 503,
+            countAsCommandResultUnknown: false,
+        });
+    });
+});

package/dist/src/electron-apps.js

@@ -12,7 +12,6 @@ export const builtinApps = {
     cursor: { port: 9226, processName: 'Cursor', bundleId: 'com.todesktop.runtime.Cursor', displayName: 'Cursor' },
     codex: { port: 9222, processName: 'Codex', bundleId: 'com.openai.codex', displayName: 'Codex' },
     chatwise: { port: 9228, processName: 'ChatWise', bundleId: 'com.chatwise.app', displayName: 'ChatWise' },
-    notion: { port: 9230, processName: 'Notion', bundleId: 'notion.id', displayName: 'Notion' },
     'discord-app': { port: 9232, processName: 'Discord', bundleId: 'com.discord.app', displayName: 'Discord' },
     'doubao-app': { port: 9225, processName: 'Doubao', bundleId: 'com.volcengine.doubao', displayName: 'Doubao' },
     antigravity: {

package/dist/src/electron-apps.test.js

@@ -23,6 +23,7 @@ describe('electron-apps registry', () => {
     });
     it('isElectronApp returns false for non-Electron sites', () => {
         expect(isElectronApp('bilibili')).toBe(false);
+        expect(isElectronApp('notion')).toBe(false);
         expect(isElectronApp('unknown-app')).toBe(false);
     });
     it('loadApps merges user config additively', () => {

package/dist/src/external-clis.yaml

@@ -14,6 +14,12 @@
   install:
     mac: "brew install --cask obsidian"
 
+- name: ntn
+  binary: ntn
+  description: "Notion CLI — official Notion API CLI for pages, databases, blocks, search, comments"
+  homepage: "https://ntn.dev"
+  tags: [notion, notes, knowledge, productivity]
+
 - name: docker
   binary: docker
   description: "Docker command-line interface"
@@ -55,24 +61,27 @@
   install:
     default: "npm install -g vercel"
 
-- name: tg-cli
+- name: tg
   binary: tg
+  package: tg-cli
   description: "Telegram CLI — local-first sync, search, export via MTProto for AI agents"
   homepage: "https://github.com/jackwener/tg-cli"
   tags: [telegram, messaging, search, export, ai-agent]
   install:
     default: "uv tool install kabi-tg-cli"
 
-- name: discord-cli
+- name: discord
   binary: discord
+  package: discord-cli
   description: "Discord CLI — local-first sync, search, export via SQLite for AI agents"
   homepage: "https://github.com/jackwener/discord-cli"
   tags: [discord, messaging, search, export, ai-agent]
   install:
     default: "uv tool install kabi-discord-cli"
 
-- name: wx-cli
+- name: wx
   binary: wx
+  package: wx-cli
   description: "WeChat local data CLI — sessions, messages, search, contacts, export for AI agents"
   homepage: "https://github.com/jackwener/wx-cli"
   tags: [wechat, messaging, search, export, ai-agent]

package/dist/src/external.d.ts

@@ -5,8 +5,11 @@ export interface ExternalCliInstall {
     default?: string;
 }
 export interface ExternalCliConfig {
+    /** User-facing OpenCLI subcommand and, by default, the executable name. */
     name: string;
     binary: string;
+    /** Distribution/project name when it differs from the executable name. */
+    package?: string;
     description?: string;
     homepage?: string;
     tags?: string[];
@@ -15,6 +18,7 @@ export interface ExternalCliConfig {
 export declare function loadExternalClis(): ExternalCliConfig[];
 export declare function isBinaryInstalled(binary: string): boolean;
 export declare function getInstallCmd(installConfig?: ExternalCliInstall): string | null;
+export declare function formatExternalCliLabel(cli: ExternalCliConfig): string;
 /**
  * Safely parses a command string into a binary and argument list.
  * Rejects commands containing shell operators (&&, ||, |, ;, >, <, `) that

package/dist/src/external.js

@@ -70,6 +70,9 @@ export function getInstallCmd(installConfig) {
         return installConfig.default;
     return null;
 }
+export function formatExternalCliLabel(cli) {
+    return cli.package && cli.package !== cli.name ? `${cli.name}(${cli.package})` : cli.name;
+}
 /**
  * Safely parses a command string into a binary and argument list.
  * Rejects commands containing shell operators (&&, ||, |, ;, >, <, `) that

package/dist/src/external.test.js

@@ -1,4 +1,8 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import yaml from 'js-yaml';
 const { mockExecFileSync, mockPlatform } = vi.hoisted(() => ({
     mockExecFileSync: vi.fn(),
     mockPlatform: vi.fn(() => 'darwin'),
@@ -14,7 +18,8 @@ vi.mock('node:os', async () => {
         platform: mockPlatform,
     };
 });
-import { installExternalCli, parseCommand } from './external.js';
+import { formatExternalCliLabel, installExternalCli, parseCommand } from './external.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 describe('parseCommand', () => {
     it('splits binaries and quoted arguments without invoking a shell', () => {
         expect(parseCommand('npm install -g "@scope/tool name"')).toEqual({
@@ -29,6 +34,24 @@ describe('parseCommand', () => {
         expect(() => parseCommand('brew install $(whoami)')).toThrow('Install command contains unsafe shell operators');
         expect(() => parseCommand('brew install gh\nrm -rf /')).toThrow('Install command contains unsafe shell operators');
     });
+    it('keeps built-in install commands compatible with the shell-free parser', () => {
+        const raw = fs.readFileSync(path.join(__dirname, 'external-clis.yaml'), 'utf8');
+        const entries = (yaml.load(raw) || []);
+        for (const entry of entries) {
+            for (const command of Object.values(entry.install ?? {})) {
+                if (command)
+                    expect(() => parseCommand(command)).not.toThrow();
+            }
+        }
+    });
+});
+describe('formatExternalCliLabel', () => {
+    it('shows the package name when the executable name differs', () => {
+        expect(formatExternalCliLabel({ name: 'wx', binary: 'wx', package: 'wx-cli' })).toBe('wx(wx-cli)');
+    });
+    it('keeps the label compact when package and name match', () => {
+        expect(formatExternalCliLabel({ name: 'docker', binary: 'docker', package: 'docker' })).toBe('docker');
+    });
 });
 describe('installExternalCli', () => {
     const cli = {

package/dist/src/help.d.ts

@@ -40,12 +40,16 @@ export type AdapterKind = 'site' | 'app';
 export declare function classifyAdapter(domain: string | undefined): AdapterKind;
 export interface RootAdapterGroups {
     /** Externally-registered CLIs (docker, gh, vercel, ...) — passthrough binaries */
-    external: readonly string[];
+    external: readonly RootExternalCli[];
     /** Desktop-app adapters (chatgpt-app, chatwise, codex, ...) */
     apps: readonly string[];
     /** Web-site adapters (bilibili, dianping, ...) */
     sites: readonly string[];
 }
+export interface RootExternalCli {
+    name: string;
+    label: string;
+}
 export declare function formatRootAdapterHelpText(groups: RootAdapterGroups): string;
 /**
  * Extracts a positional placeholder that should appear immediately after this

package/dist/src/help.js

@@ -116,7 +116,7 @@ export function formatRootAdapterHelpText(groups) {
     if (total === 0)
         return '';
     const lines = [''];
-    lines.push(...formatGroupSection('External CLIs', groups.external));
+    lines.push(...formatGroupSection('External CLIs', groups.external.map(cli => cli.label)));
     lines.push(...formatGroupSection('App adapters', groups.apps));
     lines.push(...formatGroupSection('Site adapters', groups.sites));
     lines.push("Run 'opencli list' for full command details, or 'opencli <site> --help' to inspect one site.");
@@ -376,7 +376,7 @@ function compactCommand(cmd) {
     };
 }
 export function rootHelpData(program, groups) {
-    const adapterNames = new Set([...groups.external, ...groups.apps, ...groups.sites]);
+    const adapterNames = new Set([...groups.external.map(cli => cli.name), ...groups.apps, ...groups.sites]);
     const commands = program.commands
         .filter(command => !adapterNames.has(command.name()))
         .map(command => ({
@@ -390,7 +390,8 @@ export function rootHelpData(program, groups) {
         commands,
         external_clis: {
             count: groups.external.length,
-            clis: [...groups.external].sort(sortLocale),
+            clis: groups.external.map(cli => cli.name).sort(sortLocale),
+            display: groups.external.map(cli => cli.label).sort(sortLocale),
         },
         app_adapters: {
             count: groups.apps.length,

package/dist/src/help.test.js

@@ -20,13 +20,17 @@ describe('classifyAdapter', () => {
 describe('formatRootAdapterHelpText', () => {
     it('renders all three sections in External / App / Site order when populated', () => {
         const text = formatRootAdapterHelpText({
-            external: ['gh', 'docker'],
+            external: [
+                { name: 'gh', label: 'gh' },
+                { name: 'wx', label: 'wx(wx-cli)' },
+            ],
             apps: ['chatwise', 'codex'],
             sites: ['bilibili'],
         });
         expect(text).toContain('External CLIs (2):');
         expect(text).toContain('App adapters (2):');
         expect(text).toContain('Site adapters (1):');
+        expect(text).toContain('wx(wx-cli)');
         expect(text.indexOf('External CLIs')).toBeLessThan(text.indexOf('App adapters'));
         expect(text.indexOf('App adapters')).toBeLessThan(text.indexOf('Site adapters'));
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackwener/opencli",
-  "version": "1.7.19",
+  "version": "1.7.21",
   "publishConfig": {
     "access": "public"
   },

package/clis/notion/export.js

@@ -1,32 +0,0 @@
-import * as fs from 'node:fs';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const exportCommand = cli({
-    site: 'notion',
-    name: 'export',
-    access: 'read',
-    description: 'Export the current Notion page as Markdown',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [
-        { name: 'output', required: false, help: 'Output file (default: /tmp/notion-export.md)' },
-    ],
-    columns: ['Status', 'File'],
-    func: async (page, kwargs) => {
-        const outputPath = kwargs.output || '/tmp/notion-export.md';
-        const result = await page.evaluate(`
-      (function() {
-        const titleEl = document.querySelector('[data-block-id] [placeholder="Untitled"], h1.notion-title, [class*="title"]');
-        const title = titleEl ? (titleEl.textContent || '').trim() : document.title;
-        
-        const frame = document.querySelector('.notion-page-content, [class*="page-content"], main');
-        const content = frame ? (frame.innerText || '').trim() : document.body.innerText;
-        
-        return { title, content };
-      })()
-    `);
-        const md = `# ${result.title}\n\n${result.content}`;
-        fs.writeFileSync(outputPath, md);
-        return [{ Status: 'Success', File: outputPath }];
-    },
-});

package/clis/notion/favorites.js

@@ -1,85 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const favoritesCommand = cli({
-    site: 'notion',
-    name: 'favorites',
-    access: 'read',
-    description: 'List pages from the Notion Favorites section in the sidebar',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [],
-    columns: ['Index', 'Title', 'Icon'],
-    func: async (page) => {
-        const items = await page.evaluate(`
-      (function() {
-        const results = [];
-
-        // Strategy 1: Use Notion's own class 'notion-outliner-bookmarks-header-container'
-        const headerContainer = document.querySelector('.notion-outliner-bookmarks-header-container');
-        if (headerContainer) {
-          // Walk up to the section parent that wraps header + items
-          let section = headerContainer.parentElement;
-          if (section && section.children.length === 1) section = section.parentElement;
-
-          if (section) {
-            const treeItems = section.querySelectorAll('[role="treeitem"]');
-            treeItems.forEach((item) => {
-              // Title text is in a div.notranslate sibling of the icon area
-              const titleEl = item.querySelector('div.notranslate:not(.notion-record-icon)');
-              const title = titleEl
-                ? titleEl.textContent.trim()
-                : (item.textContent || '').trim().substring(0, 80);
-
-              // Icon/emoji is in the notion-record-icon element
-              const iconEl = item.querySelector('.notion-record-icon');
-              const icon = iconEl ? iconEl.textContent.trim().substring(0, 4) : '';
-
-              if (title && title.length > 0) {
-                results.push({ Index: results.length + 1, Title: title, Icon: icon || '📄' });
-              }
-            });
-          }
-        }
-
-        // Strategy 2: Fallback — find "Favorites" text node and walk DOM
-        if (results.length === 0) {
-          const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, null);
-          let node;
-          let favEl = null;
-          while (node = walker.nextNode()) {
-            const text = node.textContent.trim();
-            if (text === 'Favorites' || text === '收藏' || text === '收藏夹') {
-              favEl = node.parentElement;
-              break;
-            }
-          }
-
-          if (favEl) {
-            let section = favEl;
-            for (let i = 0; i < 6; i++) {
-              const p = section.parentElement;
-              if (!p || p === document.body) break;
-              const treeItems = p.querySelectorAll(':scope > [role="treeitem"]');
-              if (treeItems.length > 0) { section = p; break; }
-              section = p;
-            }
-
-            const treeItems = section.querySelectorAll('[role="treeitem"]');
-            treeItems.forEach((item) => {
-              const text = (item.textContent || '').trim().substring(0, 120);
-              if (text && text.length > 1 && !text.match(/^(Favorites|收藏夹?)$/)) {
-                results.push({ Index: results.length + 1, Title: text, Icon: '📄' });
-              }
-            });
-          }
-        }
-
-        return results;
-      })()
-    `);
-        if (items.length === 0) {
-            return [{ Index: 0, Title: 'No favorites found. Make sure sidebar is visible and you have favorites.', Icon: '⚠️' }];
-        }
-        return items;
-    },
-});

package/clis/notion/new.js

@@ -1,35 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const newCommand = cli({
-    site: 'notion',
-    name: 'new',
-    access: 'write',
-    description: 'Create a new page in Notion',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [
-        { name: 'title', required: false, positional: true, help: 'Page title (optional)' },
-    ],
-    columns: ['Status'],
-    func: async (page, kwargs) => {
-        const title = kwargs.title;
-        // Cmd+N creates a new page in Notion
-        const isMac = process.platform === 'darwin';
-        await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
-        await page.wait(1);
-        // If title is provided, type it into the title field
-        if (title) {
-            await page.evaluate(`
-        (function(t) {
-          const titleEl = document.querySelector('[placeholder="Untitled"], [data-content-editable-leaf] [placeholder]');
-          if (titleEl) {
-            titleEl.focus();
-            document.execCommand('insertText', false, t);
-          }
-        })(${JSON.stringify(title)})
-      `);
-            await page.wait(0.5);
-        }
-        return [{ Status: title ? `Created page: ${title}` : 'New blank page created' }];
-    },
-});

package/clis/notion/read.js

@@ -1,31 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const readCommand = cli({
-    site: 'notion',
-    name: 'read',
-    access: 'read',
-    description: 'Read the content of the currently open Notion page',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [],
-    columns: ['Title', 'Content'],
-    func: async (page) => {
-        const result = await page.evaluate(`
-      (function() {
-        // Get the page title
-        const titleEl = document.querySelector('[data-block-id] [placeholder="Untitled"], .notion-page-block .notranslate, h1.notion-title, [class*="title"]');
-        const title = titleEl ? (titleEl.textContent || '').trim() : document.title;
-        
-        // Get the page content — Notion renders blocks in a frame
-        const frame = document.querySelector('.notion-page-content, [class*="page-content"], .layout-content, main');
-        const content = frame ? (frame.innerText || frame.textContent || '').trim() : '';
-        
-        return { title, content };
-      })()
-    `);
-        return [{
-                Title: result.title || 'Untitled',
-                Content: result.content || '(empty page)',
-            }];
-    },
-});

package/clis/notion/search.js

@@ -1,47 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const searchCommand = cli({
-    site: 'notion',
-    name: 'search',
-    access: 'read',
-    description: 'Search pages and databases in Notion via Quick Find (Cmd+P)',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [{ name: 'query', required: true, positional: true, help: 'Search query' }],
-    columns: ['Index', 'Title'],
-    func: async (page, kwargs) => {
-        const query = kwargs.query;
-        // Open Quick Find
-        const isMac = process.platform === 'darwin';
-        await page.pressKey(isMac ? 'Meta+P' : 'Control+P');
-        await page.wait(0.5);
-        // Type the search query
-        await page.evaluate(`
-      (function(q) {
-        const input = document.querySelector('input[placeholder*="Search"], input[type="text"]');
-        if (input) {
-          const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
-          setter.call(input, q);
-          input.dispatchEvent(new Event('input', { bubbles: true }));
-        }
-      })(${JSON.stringify(query)})
-    `);
-        await page.wait(1.5);
-        // Scrape results
-        const results = await page.evaluate(`
-      (function() {
-        const items = document.querySelectorAll('[role="option"], [class*="searchResult"], [class*="quick-find"] [role="button"]');
-        return Array.from(items).slice(0, 20).map((item, i) => ({
-          Index: i + 1,
-          Title: (item.textContent || '').trim().substring(0, 120),
-        }));
-      })()
-    `);
-        // Close Quick Find
-        await page.pressKey('Escape');
-        if (results.length === 0) {
-            return [{ Index: 0, Title: `No results for "${query}"` }];
-        }
-        return results;
-    },
-});

package/clis/notion/sidebar.js

@@ -1,42 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const sidebarCommand = cli({
-    site: 'notion',
-    name: 'sidebar',
-    access: 'read',
-    description: 'List pages and databases from the Notion sidebar',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [],
-    columns: ['Index', 'Title'],
-    func: async (page) => {
-        const items = await page.evaluate(`
-      (function() {
-        const results = [];
-        // Notion sidebar items
-        const selectors = [
-          '[class*="sidebar"] [role="treeitem"]',
-          '[class*="sidebar"] a',
-          '.notion-sidebar [role="button"]',
-          'nav [role="treeitem"]',
-        ];
-        
-        for (const sel of selectors) {
-          const nodes = document.querySelectorAll(sel);
-          if (nodes.length > 0) {
-            nodes.forEach((n, i) => {
-              const text = (n.textContent || '').trim().substring(0, 100);
-              if (text && text.length > 1) results.push({ Index: i + 1, Title: text });
-            });
-            break;
-          }
-        }
-        return results;
-      })()
-    `);
-        if (items.length === 0) {
-            return [{ Index: 0, Title: 'No sidebar items found. Toggle the sidebar first.' }];
-        }
-        return items;
-    },
-});

package/clis/notion/status.js

@@ -1,17 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const statusCommand = cli({
-    site: 'notion',
-    name: 'status',
-    access: 'read',
-    description: 'Check active CDP connection to Notion Desktop',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [],
-    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 }];
-    },
-});

package/clis/notion/write.js

@@ -1,41 +0,0 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const writeCommand = cli({
-    site: 'notion',
-    name: 'write',
-    access: 'write',
-    description: 'Append text content to the currently open Notion page',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [{ name: 'text', required: true, positional: true, help: 'Text to append to the page' }],
-    columns: ['Status'],
-    func: async (page, kwargs) => {
-        const text = kwargs.text;
-        // Focus the page body and move to the end
-        await page.evaluate(`
-      (function(text) {
-        // Find the editable area in Notion
-        const editables = document.querySelectorAll('.notion-page-content [contenteditable="true"], [class*="page-content"] [contenteditable="true"]');
-        let target = editables.length > 0 ? editables[editables.length - 1] : null;
-        
-        if (!target) {
-          // Fallback: just find any contenteditable
-          const all = document.querySelectorAll('[contenteditable="true"]');
-          target = all.length > 0 ? all[all.length - 1] : null;
-        }
-        
-        if (!target) throw new Error('Could not find editable area in Notion page');
-        
-        target.focus();
-        // Move to end
-        const sel = window.getSelection();
-        sel.selectAllChildren(target);
-        sel.collapseToEnd();
-        
-        document.execCommand('insertText', false, text);
-      })(${JSON.stringify(text)})
-    `);
-        await page.wait(0.5);
-        return [{ Status: 'Text appended successfully' }];
-    },
-});