@jackwener/opencli 0.9.6 → 0.9.8

package/src/build-manifest.ts

@@ -11,7 +11,7 @@
 
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import yaml from 'js-yaml';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -43,6 +43,116 @@ interface ManifestEntry {
   modulePath?: string;
 }
 
+function extractBalancedBlock(
+  source: string,
+  startIndex: number,
+  openChar: string,
+  closeChar: string,
+): string | null {
+  let depth = 0;
+  let quote: string | null = null;
+  let escaped = false;
+
+  for (let i = startIndex; i < source.length; i++) {
+    const ch = source[i];
+
+    if (quote) {
+      if (escaped) {
+        escaped = false;
+        continue;
+      }
+      if (ch === '\\') {
+        escaped = true;
+        continue;
+      }
+      if (ch === quote) quote = null;
+      continue;
+    }
+
+    if (ch === '"' || ch === '\'' || ch === '`') {
+      quote = ch;
+      continue;
+    }
+
+    if (ch === openChar) {
+      depth++;
+    } else if (ch === closeChar) {
+      depth--;
+      if (depth === 0) {
+        return source.slice(startIndex + 1, i);
+      }
+    }
+  }
+
+  return null;
+}
+
+function extractTsArgsBlock(source: string): string | null {
+  const argsMatch = source.match(/args\s*:/);
+  if (!argsMatch || argsMatch.index === undefined) return null;
+
+  const bracketIndex = source.indexOf('[', argsMatch.index);
+  if (bracketIndex === -1) return null;
+
+  return extractBalancedBlock(source, bracketIndex, '[', ']');
+}
+
+function parseInlineChoices(body: string): string[] | undefined {
+  const choicesMatch = body.match(/choices\s*:\s*\[([^\]]*)\]/);
+  if (!choicesMatch) return undefined;
+
+  const values = choicesMatch[1]
+    .split(',')
+    .map(s => s.trim().replace(/^['"`]|['"`]$/g, ''))
+    .filter(Boolean);
+
+  return values.length > 0 ? values : undefined;
+}
+
+export function parseTsArgsBlock(argsBlock: string): ManifestEntry['args'] {
+  const args: ManifestEntry['args'] = [];
+  let cursor = 0;
+
+  while (cursor < argsBlock.length) {
+    const nameMatch = argsBlock.slice(cursor).match(/\{\s*name\s*:\s*['"`](\w+)['"`]/);
+    if (!nameMatch || nameMatch.index === undefined) break;
+
+    const objectStart = cursor + nameMatch.index;
+    const body = extractBalancedBlock(argsBlock, objectStart, '{', '}');
+    if (body == null) break;
+
+    const typeMatch = body.match(/type\s*:\s*['"`](\w+)['"`]/);
+    const defaultMatch = body.match(/default\s*:\s*([^,}]+)/);
+    const requiredMatch = body.match(/required\s*:\s*(true|false)/);
+    const helpMatch = body.match(/help\s*:\s*['"`]([^'"`]*)['"`]/);
+    const positionalMatch = body.match(/positional\s*:\s*(true|false)/);
+
+    let defaultVal: any = undefined;
+    if (defaultMatch) {
+      const raw = defaultMatch[1].trim();
+      if (raw === 'true') defaultVal = true;
+      else if (raw === 'false') defaultVal = false;
+      else if (/^\d+$/.test(raw)) defaultVal = parseInt(raw, 10);
+      else if (/^\d+\.\d+$/.test(raw)) defaultVal = parseFloat(raw);
+      else defaultVal = raw.replace(/^['"`]|['"`]$/g, '');
+    }
+
+    args.push({
+      name: nameMatch[1],
+      type: typeMatch?.[1] ?? 'str',
+      default: defaultVal,
+      required: requiredMatch?.[1] === 'true',
+      positional: positionalMatch?.[1] === 'true' || undefined,
+      help: helpMatch?.[1] ?? '',
+      choices: parseInlineChoices(body),
+    });
+
+    cursor = objectStart + body.length + 2;
+  }
+
+  return args;
+}
+
 function scanYaml(filePath: string, site: string): ManifestEntry | null {
   try {
     const raw = fs.readFileSync(filePath, 'utf-8');
@@ -129,39 +239,9 @@ function scanTs(filePath: string, site: string): ManifestEntry {
     }
 
     // Extract args array items: { name: '...', ... }
-    const argsBlockMatch = src.match(/args\s*:\s*\[([\s\S]*?)\]\s*,/);
-    if (argsBlockMatch) {
-      const argsBlock = argsBlockMatch[1];
-      const argRegex = /\{\s*name\s*:\s*['"`](\w+)['"`]([^}]*)\}/g;
-      let m;
-      while ((m = argRegex.exec(argsBlock)) !== null) {
-        const argName = m[1];
-        const body = m[2];
-        const typeMatch = body.match(/type\s*:\s*['"`](\w+)['"`]/);
-        const defaultMatch = body.match(/default\s*:\s*([^,}]+)/);
-        const requiredMatch = body.match(/required\s*:\s*(true|false)/);
-        const helpMatch = body.match(/help\s*:\s*['"`]([^'"`]*)['"`]/);
-        const positionalMatch = body.match(/positional\s*:\s*(true|false)/);
-
-        let defaultVal: any = undefined;
-        if (defaultMatch) {
-          const raw = defaultMatch[1].trim();
-          if (raw === 'true') defaultVal = true;
-          else if (raw === 'false') defaultVal = false;
-          else if (/^\d+$/.test(raw)) defaultVal = parseInt(raw, 10);
-          else if (/^\d+\.\d+$/.test(raw)) defaultVal = parseFloat(raw);
-          else defaultVal = raw.replace(/^['"`]|['"`]$/g, '');
-        }
-
-        entry.args.push({
-          name: argName,
-          type: typeMatch?.[1] ?? 'str',
-          default: defaultVal,
-          required: requiredMatch?.[1] === 'true',
-          positional: positionalMatch?.[1] === 'true' || undefined,
-          help: helpMatch?.[1] ?? '',
-        });
-      }
+    const argsBlock = extractTsArgsBlock(src);
+    if (argsBlock) {
+      entry.args = parseTsArgsBlock(argsBlock);
     }
   } catch {
     // If parsing fails, fall back to empty metadata — module will self-register at runtime
@@ -170,32 +250,42 @@ function scanTs(filePath: string, site: string): ManifestEntry {
   return entry;
 }
 
-// Main
-const manifest: ManifestEntry[] = [];
-
-if (fs.existsSync(CLIS_DIR)) {
-  for (const site of fs.readdirSync(CLIS_DIR)) {
-    const siteDir = path.join(CLIS_DIR, site);
-    if (!fs.statSync(siteDir).isDirectory()) continue;
-    for (const file of fs.readdirSync(siteDir)) {
-      const filePath = path.join(siteDir, file);
-      if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-        const entry = scanYaml(filePath, site);
-        if (entry) manifest.push(entry);
-      } else if (
-        (file.endsWith('.ts') && !file.endsWith('.d.ts') && file !== 'index.ts') ||
-        (file.endsWith('.js') && !file.endsWith('.d.js') && file !== 'index.js')
-      ) {
-        manifest.push(scanTs(filePath, site));
+export function buildManifest(): ManifestEntry[] {
+  const manifest: ManifestEntry[] = [];
+
+  if (fs.existsSync(CLIS_DIR)) {
+    for (const site of fs.readdirSync(CLIS_DIR)) {
+      const siteDir = path.join(CLIS_DIR, site);
+      if (!fs.statSync(siteDir).isDirectory()) continue;
+      for (const file of fs.readdirSync(siteDir)) {
+        const filePath = path.join(siteDir, file);
+        if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+          const entry = scanYaml(filePath, site);
+          if (entry) manifest.push(entry);
+        } else if (
+          (file.endsWith('.ts') && !file.endsWith('.d.ts') && file !== 'index.ts') ||
+          (file.endsWith('.js') && !file.endsWith('.d.js') && file !== 'index.js')
+        ) {
+          manifest.push(scanTs(filePath, site));
+        }
       }
     }
   }
+
+  return manifest;
 }
 
-// Ensure output directory exists
-fs.mkdirSync(path.dirname(OUTPUT), { recursive: true });
-fs.writeFileSync(OUTPUT, JSON.stringify(manifest, null, 2));
+function main(): void {
+  const manifest = buildManifest();
+  fs.mkdirSync(path.dirname(OUTPUT), { recursive: true });
+  fs.writeFileSync(OUTPUT, JSON.stringify(manifest, null, 2));
 
-const yamlCount = manifest.filter(e => e.type === 'yaml').length;
-const tsCount = manifest.filter(e => e.type === 'ts').length;
-console.log(`✅ Manifest compiled: ${manifest.length} entries (${yamlCount} YAML, ${tsCount} TS) → ${OUTPUT}`);
+  const yamlCount = manifest.filter(e => e.type === 'yaml').length;
+  const tsCount = manifest.filter(e => e.type === 'ts').length;
+  console.log(`✅ Manifest compiled: ${manifest.length} entries (${yamlCount} YAML, ${tsCount} TS) → ${OUTPUT}`);
+}
+
+const entrypoint = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : null;
+if (entrypoint === import.meta.url) {
+  main();
+}

package/src/clis/bilibili/download.ts

@@ -0,0 +1,161 @@
+/**
+ * Bilibili download — download videos using yt-dlp.
+ *
+ * Usage:
+ *   opencli bilibili download --bvid BV1xxx --output ./bilibili
+ *
+ * Requirements:
+ *   - yt-dlp must be installed: pip install yt-dlp
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { cli, Strategy } from '../../registry.js';
+import {
+  ytdlpDownload,
+  checkYtdlp,
+  sanitizeFilename,
+  getTempDir,
+  exportCookiesToNetscape,
+} from '../../download/index.js';
+import { DownloadProgressTracker, formatBytes } from '../../download/progress.js';
+
+cli({
+  site: 'bilibili',
+  name: 'download',
+  description: '下载B站视频（需要 yt-dlp）',
+  domain: 'www.bilibili.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'bvid', required: true, help: 'Video BV ID (e.g., BV1xxx)' },
+    { name: 'output', default: './bilibili-downloads', help: 'Output directory' },
+    { name: 'quality', default: 'best', help: 'Video quality (best, 1080p, 720p, 480p)' },
+  ],
+  columns: ['bvid', 'title', 'status', 'size'],
+  func: async (page, kwargs) => {
+    const bvid = kwargs.bvid;
+    const output = kwargs.output;
+    const quality = kwargs.quality;
+
+    // Check yt-dlp availability
+    if (!checkYtdlp()) {
+      return [{
+        bvid,
+        title: '-',
+        status: 'failed',
+        size: 'yt-dlp not installed. Run: pip install yt-dlp',
+      }];
+    }
+
+    // Navigate to video page to get title and cookies
+    await page.goto(`https://www.bilibili.com/video/${bvid}`);
+    await page.wait(3);
+
+    // Extract video info
+    const data = await page.evaluate(`
+      (() => {
+        const title = document.querySelector('h1.video-title, .video-title')?.textContent?.trim() || 'video';
+        const author = document.querySelector('.up-name, .username')?.textContent?.trim() || 'unknown';
+        return { title, author };
+      })()
+    `);
+
+    const title = sanitizeFilename(data?.title || 'video');
+
+    // Extract cookies for authenticated downloads
+    const cookieString = await page.evaluate(`(() => document.cookie)()`);
+
+    // Create output directory
+    fs.mkdirSync(output, { recursive: true });
+
+    // Export cookies to Netscape format for yt-dlp
+    let cookiesFile: string | undefined;
+    if (typeof cookieString === 'string' && cookieString) {
+      const tempDir = getTempDir();
+      fs.mkdirSync(tempDir, { recursive: true });
+      cookiesFile = path.join(tempDir, `bilibili_cookies_${Date.now()}.txt`);
+
+      const cookies = cookieString.split(';').map((c) => {
+        const [name, ...rest] = c.trim().split('=');
+        return {
+          name: name || '',
+          value: rest.join('=') || '',
+          domain: '.bilibili.com',
+          path: '/',
+          secure: true,
+          httpOnly: false,
+        };
+      }).filter((c) => c.name);
+
+      exportCookiesToNetscape(cookies, cookiesFile);
+    }
+
+    // Build yt-dlp format string based on quality
+    let format = 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best';
+    if (quality === '1080p') {
+      format = 'bestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/best[height<=1080]';
+    } else if (quality === '720p') {
+      format = 'bestvideo[height<=720][ext=mp4]+bestaudio[ext=m4a]/best[height<=720]';
+    } else if (quality === '480p') {
+      format = 'bestvideo[height<=480][ext=mp4]+bestaudio[ext=m4a]/best[height<=480]';
+    }
+
+    const destPath = path.join(output, `${bvid}_${title}.mp4`);
+
+    const tracker = new DownloadProgressTracker(1, true);
+    const progressBar = tracker.onFileStart(`${bvid}.mp4`, 0);
+
+    try {
+      const result = await ytdlpDownload(
+        `https://www.bilibili.com/video/${bvid}`,
+        destPath,
+        {
+          cookiesFile,
+          format,
+          extraArgs: [
+            '--merge-output-format', 'mp4',
+            '--embed-thumbnail',
+          ],
+          onProgress: (percent) => {
+            if (progressBar) progressBar.update(percent, 100);
+          },
+        },
+      );
+
+      if (progressBar) {
+        progressBar.complete(result.success, result.success ? formatBytes(result.size) : undefined);
+      }
+
+      tracker.onFileComplete(result.success);
+      tracker.finish();
+
+      // Cleanup cookies file
+      if (cookiesFile && fs.existsSync(cookiesFile)) {
+        fs.unlinkSync(cookiesFile);
+      }
+
+      return [{
+        bvid,
+        title: data?.title || 'video',
+        status: result.success ? 'success' : 'failed',
+        size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
+      }];
+    } catch (err: any) {
+      if (progressBar) progressBar.fail(err.message);
+      tracker.onFileComplete(false);
+      tracker.finish();
+
+      // Cleanup cookies file
+      if (cookiesFile && fs.existsSync(cookiesFile)) {
+        fs.unlinkSync(cookiesFile);
+      }
+
+      return [{
+        bvid,
+        title: data?.title || 'video',
+        status: 'failed',
+        size: err.message,
+      }];
+    }
+  },
+});

package/src/clis/chatwise/README.md

@@ -0,0 +1,38 @@
+# ChatWise Adapter for OpenCLI
+
+Control the **ChatWise Desktop App** from the terminal via Chrome DevTools Protocol (CDP). ChatWise is an Electron-based multi-LLM client supporting GPT-4, Claude, Gemini, and more.
+
+## Prerequisites
+
+1. Install [ChatWise](https://chatwise.app/).
+2. Launch with remote debugging port:
+   ```bash
+   /Applications/ChatWise.app/Contents/MacOS/ChatWise \
+     --remote-debugging-port=9228
+   ```
+
+## Setup
+
+```bash
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9228"
+```
+
+## Commands
+
+### Diagnostics
+- `opencli chatwise status`: Check CDP connection status.
+- `opencli chatwise screenshot`: Export DOM + accessibility snapshot.
+
+### Chat
+- `opencli chatwise new`: Start a new conversation (`Cmd+N`).
+- `opencli chatwise send "message"`: Send a message to the active chat.
+- `opencli chatwise read`: Read the current conversation.
+- `opencli chatwise ask "prompt"`: Send + wait for response + return it (one-shot).
+
+### AI Features
+- `opencli chatwise model`: Get the current AI model.
+- `opencli chatwise model gpt-4`: Switch to a different model.
+
+### Organization
+- `opencli chatwise history`: List conversations from the sidebar.
+- `opencli chatwise export`: Export conversation as Markdown.

package/src/clis/chatwise/README.zh-CN.md

@@ -0,0 +1,38 @@
+# ChatWise 适配器
+
+通过 Chrome DevTools Protocol (CDP) 在终端中控制 **ChatWise 桌面应用**。ChatWise 是基于 Electron 的多 LLM 客户端，支持 GPT-4、Claude、Gemini 等。
+
+## 前置条件
+
+1. 安装 [ChatWise](https://chatwise.app/)。
+2. 通过远程调试端口启动：
+   ```bash
+   /Applications/ChatWise.app/Contents/MacOS/ChatWise \
+     --remote-debugging-port=9228
+   ```
+
+## 配置
+
+```bash
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9228"
+```
+
+## 命令
+
+### 诊断
+- `opencli chatwise status`：检查 CDP 连接状态。
+- `opencli chatwise screenshot`：导出 DOM + accessibility 快照。
+
+### 对话
+- `opencli chatwise new`：开始新对话（`Cmd+N`）。
+- `opencli chatwise send "消息"`：发送消息到当前对话。
+- `opencli chatwise read`：读取当前对话内容。
+- `opencli chatwise ask "提示词"`：发送 + 等待回复 + 返回结果（一站式）。
+
+### AI 功能
+- `opencli chatwise model`：获取当前 AI 模型。
+- `opencli chatwise model gpt-4`：切换模型。
+
+### 组织管理
+- `opencli chatwise history`：列出 sidebar 会话列表。
+- `opencli chatwise export`：导出对话为 Markdown 文件。

package/src/clis/chatwise/ask.ts

@@ -0,0 +1,87 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const askCommand = cli({
+  site: 'chatwise',
+  name: 'ask',
+  description: 'Send a prompt and wait for the AI response (send + wait + read)',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [
+    { name: 'text', required: true, positional: true, help: 'Prompt to send' },
+    { name: 'timeout', required: false, help: 'Max seconds to wait (default: 30)', default: '30' },
+  ],
+  columns: ['Role', 'Text'],
+  func: async (page: IPage, kwargs: any) => {
+    const text = kwargs.text as string;
+    const timeout = parseInt(kwargs.timeout as string, 10) || 30;
+
+    // Snapshot content length
+    const beforeLen = await page.evaluate(`
+      (function() {
+        const msgs = document.querySelectorAll('[data-message-id], [class*="message"], [class*="bubble"]');
+        return msgs.length;
+      })()
+    `);
+
+    // Send message
+    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');
+        composer.focus();
+        if (composer.tagName === 'TEXTAREA') {
+          const setter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set;
+          setter.call(composer, text);
+          composer.dispatchEvent(new Event('input', { bubbles: true }));
+        } else {
+          document.execCommand('insertText', false, text);
+        }
+      })(${JSON.stringify(text)})
+    `);
+
+    await page.wait(0.5);
+    await page.pressKey('Enter');
+
+    // Poll for response
+    const pollInterval = 2;
+    const maxPolls = Math.ceil(timeout / pollInterval);
+    let response = '';
+
+    for (let i = 0; i < maxPolls; i++) {
+      await page.wait(pollInterval);
+
+      const result = await page.evaluate(`
+        (function(prevLen) {
+          const msgs = document.querySelectorAll('[data-message-id], [class*="message"], [class*="bubble"]');
+          if (msgs.length <= prevLen) return null;
+          const last = msgs[msgs.length - 1];
+          const text = last.innerText || last.textContent;
+          return text ? text.trim() : null;
+        })(${beforeLen})
+      `);
+
+      if (result) {
+        response = result;
+        break;
+      }
+    }
+
+    if (!response) {
+      return [
+        { Role: 'User', Text: text },
+        { Role: 'System', Text: `No response within ${timeout}s.` },
+      ];
+    }
+
+    return [
+      { Role: 'User', Text: text },
+      { Role: 'Assistant', Text: response },
+    ];
+  },
+});

package/src/clis/chatwise/export.ts

@@ -0,0 +1,51 @@
+import * as fs from 'node:fs';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const exportCommand = cli({
+  site: 'chatwise',
+  name: 'export',
+  description: 'Export the current ChatWise conversation to a Markdown file',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [
+    { name: 'output', required: false, positional: true, help: 'Output file (default: /tmp/chatwise-export.md)' },
+  ],
+  columns: ['Status', 'File', 'Messages'],
+  func: async (page: IPage, kwargs: any) => {
+    const outputPath = (kwargs.output as string) || '/tmp/chatwise-export.md';
+
+    const md = await page.evaluate(`
+      (function() {
+        const selectors = [
+          '[data-message-id]',
+          '[class*="message"]',
+          '[class*="chat-item"]',
+          '[class*="bubble"]',
+        ];
+        
+        for (const sel of selectors) {
+          const nodes = document.querySelectorAll(sel);
+          if (nodes.length > 0) {
+            return Array.from(nodes).map((n, i) => '## Message ' + (i + 1) + '\\n\\n' + (n.innerText || n.textContent).trim()).join('\\n\\n---\\n\\n');
+          }
+        }
+        
+        const main = document.querySelector('main, [role="main"], [class*="chat-container"]');
+        if (main) return main.innerText || main.textContent;
+        return document.body.innerText;
+      })()
+    `);
+
+    fs.writeFileSync(outputPath, '# ChatWise Conversation Export\\n\\n' + md);
+
+    return [
+      {
+        Status: 'Success',
+        File: outputPath,
+        Messages: md.split('## Message').length - 1,
+      },
+    ];
+  },
+});

package/src/clis/chatwise/history.ts

@@ -0,0 +1,47 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const historyCommand = cli({
+  site: 'chatwise',
+  name: 'history',
+  description: 'List conversation history in ChatWise sidebar',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [],
+  columns: ['Index', 'Title'],
+  func: async (page: IPage) => {
+    const items = await page.evaluate(`
+      (function() {
+        const results = [];
+        const selectors = [
+          '[class*="sidebar"] [class*="item"]',
+          '[class*="conversation-list"] a',
+          '[class*="chat-list"] > *',
+          'nav a',
+          'aside a',
+          '[role="listbox"] [role="option"]',
+        ];
+        
+        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) results.push({ Index: i + 1, Title: text });
+            });
+            break;
+          }
+        }
+        
+        return results;
+      })()
+    `);
+
+    if (items.length === 0) {
+      return [{ Index: 0, Title: 'No history found. Ensure the sidebar is visible.' }];
+    }
+
+    return items;
+  },
+});