@jackwener/opencli 1.1.0 → 1.2.0

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

@@ -1,29 +0,0 @@
-# Notion 桌面端适配器
-
-通过 Chrome DevTools Protocol (CDP) 在终端中控制 **Notion 桌面应用**。
-
-## 前置条件
-
-通过远程调试端口启动：
-```bash
-/Applications/Notion.app/Contents/MacOS/Notion --remote-debugging-port=9230
-```
-
-## 配置
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9230"
-```
-
-## 命令
-
-| 命令 | 说明 |
-|------|------|
-| `notion status` | 检查 CDP 连接 |
-| `notion search "关键词"` | 快速搜索（Cmd+P） |
-| `notion read` | 读取当前页面内容 |
-| `notion new "标题"` | 新建页面（Cmd+N） |
-| `notion write "文本"` | 在当前页面追加文字 |
-| `notion sidebar` | 列出侧边栏页面列表 |
-| `notion favorites` | 列出收藏夹页面列表 |
-| `notion export` | 导出页面为 Markdown |

package/src/clis/twitter/trending.yaml

@@ -1,46 +0,0 @@
-site: twitter
-name: trending
-description: Twitter/X trending topics
-domain: x.com
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of trends to show
-
-pipeline:
-  - navigate: https://x.com/explore/tabs/trending
-
-  - evaluate: |
-      (async () => {
-        const cookies = document.cookie.split(';').reduce((acc, c) => {
-          const [k, v] = c.trim().split('=');
-          acc[k] = v;
-          return acc;
-        }, {});
-        const csrfToken = cookies['ct0'] || '';
-        const bearerToken = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA';
-        const res = await fetch('/i/api/2/guide.json?include_page_configuration=true', {
-          credentials: 'include',
-          headers: { 'x-twitter-active-user': 'yes', 'x-csrf-token': csrfToken, 'authorization': 'Bearer ' + bearerToken }
-        });
-        if (!res.ok) throw new Error('HTTP ' + res.status + '. Hint: trending endpoint may require login or API shape changed.');
-        const data = await res.json();
-        const instructions = data?.timeline?.instructions || [];
-        const entries = instructions.flatMap(inst => inst?.addEntries?.entries || inst?.entries || []);
-        return entries
-          .filter(e => e.content?.timelineModule)
-          .flatMap(e => e.content.timelineModule.items || [])
-          .map(t => t?.item?.content?.trend)
-          .filter(Boolean);
-      })()
-
-  - map:
-      rank: ${{ index + 1 }}
-      topic: ${{ item.name }}
-      tweets: ${{ item.tweetCount || 'N/A' }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, topic, tweets]

package/src/clis/wechat/README.md

@@ -1,5 +0,0 @@
-# WeChat (微信) Adapter
-
-Control **WeChat Mac Desktop** from the terminal via AppleScript + Accessibility API.
-
-📖 **Full documentation**: [docs/adapters/desktop/wechat](../../../docs/adapters/desktop/wechat.md)

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

@@ -1,28 +0,0 @@
-# 微信桌面端适配器
-
-通过 AppleScript + Accessibility API 在终端中控制**微信 Mac 桌面端**。
-
-> **注意：** 微信是原生 macOS 应用（非 Electron），因此无法使用 CDP。此适配器使用 AppleScript 键盘模拟和剪贴板操作。
-
-## 前置条件
-
-1. 微信必须正在运行且已登录
-2. Terminal 需要 **辅助功能权限**（系统设置 → 隐私与安全性 → 辅助功能）
-
-## 命令
-
-| 命令 | 说明 |
-|------|------|
-| `wechat status` | 检查微信是否在运行 |
-| `wechat send "消息"` | 发送消息（剪贴板粘贴 + 回车） |
-| `wechat read` | 读取当前聊天内容（Cmd+A → Cmd+C） |
-| `wechat search "关键词"` | 打开搜索并输入关键词（Cmd+F） |
-| `wechat chats` | 切换到聊天列表（Cmd+1） |
-| `wechat contacts` | 切换到通讯录（Cmd+2） |
-
-## 限制
-
-- **不支持 CDP** — 微信是原生 Cocoa 应用
-- `send` 需要先手动打开正确的会话
-- `read` 通过全选+复制来获取可见内容
-- `search` 可以输入关键词但无法自动点击结果

package/src/clis/wechat/chats.ts

@@ -1,33 +0,0 @@
-import { execSync } from 'node:child_process';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-export const chatsCommand = cli({
-  site: 'wechat',
-  name: 'chats',
-  description: 'Open the WeChat chats panel (conversation list)',
-  domain: 'localhost',
-  strategy: Strategy.PUBLIC,
-  browser: false,
-  args: [],
-  columns: ['Status'],
-  func: async (page: IPage | null) => {
-    try {
-      // Activate WeChat
-      execSync("osascript -e 'tell application \"WeChat\" to activate'");
-      execSync("osascript -e 'delay 0.3'");
-
-      // Cmd+1 switches to Chats tab in WeChat Mac
-      execSync(
-        "osascript " +
-        "-e 'tell application \"System Events\"' " +
-        "-e 'keystroke \"1\" using command down' " +
-        "-e 'end tell'"
-      );
-
-      return [{ Status: 'Chats panel opened (Cmd+1)' }];
-    } catch (err: any) {
-      return [{ Status: 'Error: ' + err.message }];
-    }
-  },
-});

package/src/clis/wechat/contacts.ts

@@ -1,33 +0,0 @@
-import { execSync } from 'node:child_process';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-export const contactsCommand = cli({
-  site: 'wechat',
-  name: 'contacts',
-  description: 'Open the WeChat contacts panel',
-  domain: 'localhost',
-  strategy: Strategy.PUBLIC,
-  browser: false,
-  args: [],
-  columns: ['Status'],
-  func: async (page: IPage | null) => {
-    try {
-      // Activate WeChat
-      execSync("osascript -e 'tell application \"WeChat\" to activate'");
-      execSync("osascript -e 'delay 0.3'");
-
-      // Cmd+2 switches to Contacts tab in WeChat Mac
-      execSync(
-        "osascript " +
-        "-e 'tell application \"System Events\"' " +
-        "-e 'keystroke \"2\" using command down' " +
-        "-e 'end tell'"
-      );
-
-      return [{ Status: 'Contacts panel opened (Cmd+2)' }];
-    } catch (err: any) {
-      return [{ Status: 'Error: ' + err.message }];
-    }
-  },
-});

package/src/clis/wechat/read.ts

@@ -1,72 +0,0 @@
-import { execSync, spawnSync } from 'node:child_process';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-export const readCommand = cli({
-  site: 'wechat',
-  name: 'read',
-  description: 'Read the current chat content by selecting all and copying',
-  domain: 'localhost',
-  strategy: Strategy.PUBLIC,
-  browser: false,
-  args: [],
-  columns: ['Content'],
-  func: async (page: IPage | null) => {
-    try {
-      // Backup clipboard
-      let clipBackup = '';
-      try {
-        clipBackup = execSync('pbpaste', { encoding: 'utf-8' });
-      } catch { /* empty */ }
-
-      // Activate WeChat
-      execSync("osascript -e 'tell application \"WeChat\" to activate'");
-      execSync("osascript -e 'delay 0.3'");
-
-      // Click on the chat area first, then select all and copy
-      execSync(
-        "osascript " +
-        "-e 'tell application \"System Events\"' " +
-        "-e 'tell application process \"WeChat\"' " +
-        // Click in the message area (center-right of the window)
-        "-e 'set frontWin to front window' " +
-        "-e 'set winPos to position of frontWin' " +
-        "-e 'set winSize to size of frontWin' " +
-        "-e 'end tell' " +
-        "-e 'end tell'"
-      );
-
-      execSync("osascript -e 'delay 0.2'");
-
-      // Select all text in chat area and copy
-      execSync(
-        "osascript " +
-        "-e 'tell application \"System Events\"' " +
-        "-e 'keystroke \"a\" using command down' " +
-        "-e 'delay 0.2' " +
-        "-e 'keystroke \"c\" using command down' " +
-        "-e 'delay 0.2' " +
-        "-e 'end tell'"
-      );
-
-      const content = execSync('pbpaste', { encoding: 'utf-8' }).trim();
-
-      // Restore clipboard
-      if (clipBackup) {
-        spawnSync('pbcopy', { input: clipBackup });
-      }
-
-      // Press Escape to deselect
-      execSync(
-        "osascript " +
-        "-e 'tell application \"System Events\"' " +
-        "-e 'key code 53' " + // Escape
-        "-e 'end tell'"
-      );
-
-      return [{ Content: content || '(no content captured)' }];
-    } catch (err: any) {
-      return [{ Content: 'Error: ' + err.message }];
-    }
-  },
-});

package/src/clis/wechat/search.ts

@@ -1,36 +0,0 @@
-import { execSync } from 'node:child_process';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-export const searchCommand = cli({
-  site: 'wechat',
-  name: 'search',
-  description: 'Open WeChat search and type a query (find contacts or messages)',
-  domain: 'localhost',
-  strategy: Strategy.PUBLIC,
-  browser: false,
-  args: [{ name: 'query', required: true, positional: true, help: 'Search query (contact name or keyword)' }],
-  columns: ['Status'],
-  func: async (page: IPage | null, kwargs: any) => {
-    const query = kwargs.query as string;
-    try {
-      // Activate WeChat
-      execSync("osascript -e 'tell application \"WeChat\" to activate'");
-      execSync("osascript -e 'delay 0.3'");
-
-      // Cmd+F to open search (WeChat Mac uses Cmd+F for search)
-      execSync(
-        "osascript " +
-        "-e 'tell application \"System Events\"' " +
-        "-e 'keystroke \"f\" using command down' " +
-        "-e 'delay 0.5' " +
-        `-e 'keystroke ${JSON.stringify(query)}' ` +
-        "-e 'end tell'"
-      );
-
-      return [{ Status: `Searching for: ${query}` }];
-    } catch (err: any) {
-      return [{ Status: 'Error: ' + err.message }];
-    }
-  },
-});

package/src/clis/wechat/send.ts

@@ -1,49 +0,0 @@
-import { execSync, spawnSync } from 'node:child_process';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-export const sendCommand = cli({
-  site: 'wechat',
-  name: 'send',
-  description: 'Send a message in the active WeChat conversation via clipboard paste',
-  domain: 'localhost',
-  strategy: Strategy.PUBLIC,
-  browser: false,
-  args: [{ name: 'text', required: true, positional: true, help: 'Message to send' }],
-  columns: ['Status'],
-  func: async (page: IPage | null, kwargs: any) => {
-    const text = kwargs.text as string;
-    try {
-      // Backup clipboard
-      let clipBackup = '';
-      try {
-        clipBackup = execSync('pbpaste', { encoding: 'utf-8' });
-      } catch { /* clipboard may be empty */ }
-
-      // Copy text to clipboard
-      spawnSync('pbcopy', { input: text });
-
-      // Activate WeChat and paste
-      execSync("osascript -e 'tell application \"WeChat\" to activate'");
-      execSync("osascript -e 'delay 0.5'");
-
-      execSync(
-        "osascript " +
-        "-e 'tell application \"System Events\"' " +
-        "-e 'keystroke \"v\" using command down' " +
-        "-e 'delay 0.2' " +
-        "-e 'keystroke return' " +
-        "-e 'end tell'"
-      );
-
-      // Restore clipboard
-      if (clipBackup) {
-        spawnSync('pbcopy', { input: clipBackup });
-      }
-
-      return [{ Status: 'Success' }];
-    } catch (err: any) {
-      return [{ Status: 'Error: ' + err.message }];
-    }
-  },
-});

package/src/clis/wechat/status.ts

@@ -1,35 +0,0 @@
-import { execSync } from 'node:child_process';
-import { cli, Strategy } from '../../registry.js';
-import type { IPage } from '../../types.js';
-
-export const statusCommand = cli({
-  site: 'wechat',
-  name: 'status',
-  description: 'Check if WeChat Desktop is running on macOS',
-  domain: 'localhost',
-  strategy: Strategy.PUBLIC,
-  browser: false,
-  args: [],
-  columns: ['Status', 'Detail'],
-  func: async (page: IPage | null) => {
-    try {
-      const running = execSync("osascript -e 'application \"WeChat\" is running'", { encoding: 'utf-8' }).trim();
-      if (running !== 'true') {
-        return [{ Status: 'Stopped', Detail: 'WeChat is not running' }];
-      }
-
-      // Get window count to check if logged in
-      const windowCount = execSync(
-        "osascript -e 'tell application \"System Events\" to count windows of application process \"WeChat\"'",
-        { encoding: 'utf-8' }
-      ).trim();
-
-      return [{
-        Status: 'Running',
-        Detail: `${windowCount} window(s) open`,
-      }];
-    } catch (err: any) {
-      return [{ Status: 'Error', Detail: err.message }];
-    }
-  },
-});

package/src/engine.ts

@@ -1,274 +0,0 @@
-/**
- * CLI discovery: finds YAML/TS CLI definitions and registers them.
- *
- * Supports two modes:
- * 1. FAST PATH (manifest): If a pre-compiled cli-manifest.json exists,
- *    registers all YAML commands instantly without runtime YAML parsing.
- *    TS modules are loaded lazily only when their command is executed.
- * 2. FALLBACK (filesystem scan): Traditional runtime discovery for development.
- */
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import yaml from 'js-yaml';
-import { type CliCommand, type InternalCliCommand, type Arg, Strategy, registerCommand } from './registry.js';
-import type { IPage } from './types.js';
-import { executePipeline } from './pipeline.js';
-import { log } from './logger.js';
-import { AdapterLoadError } from './errors.js';
-
-/** Set of TS module paths that have been loaded */
-const _loadedModules = new Set<string>();
-
-/**
- * Discover and register CLI commands.
- * Uses pre-compiled manifest when available for instant startup.
- */
-export async function discoverClis(...dirs: string[]): Promise<void> {
-  // Fast path: try manifest first (production / post-build)
-  for (const dir of dirs) {
-    const manifestPath = path.resolve(dir, '..', 'cli-manifest.json');
-    try {
-      await fs.promises.access(manifestPath);
-      await loadFromManifest(manifestPath, dir);
-      continue; // Skip filesystem scan for this directory
-    } catch {
-      // Fallback: runtime filesystem scan (development)
-      await discoverClisFromFs(dir);
-    }
-  }
-}
-
-/**
- * Fast-path: register commands from pre-compiled manifest.
- * YAML pipelines are inlined — zero YAML parsing at runtime.
- * TS modules are deferred — loaded lazily on first execution.
- */
-async function loadFromManifest(manifestPath: string, clisDir: string): Promise<void> {
-  try {
-    const raw = await fs.promises.readFile(manifestPath, 'utf-8');
-    const manifest = JSON.parse(raw) as any[];
-    for (const entry of manifest) {
-      if (entry.type === 'yaml') {
-        // YAML pipelines fully inlined in manifest — register directly
-        const strategy = (Strategy as any)[entry.strategy.toUpperCase()] ?? Strategy.COOKIE;
-        const cmd: CliCommand = {
-          site: entry.site,
-          name: entry.name,
-          description: entry.description ?? '',
-          domain: entry.domain,
-          strategy,
-          browser: entry.browser,
-          args: entry.args ?? [],
-          columns: entry.columns,
-          pipeline: entry.pipeline,
-          timeoutSeconds: entry.timeout,
-          source: `manifest:${entry.site}/${entry.name}`,
-        };
-        registerCommand(cmd);
-      } else if (entry.type === 'ts' && entry.modulePath) {
-        // TS adapters: register a lightweight stub.
-        // The actual module is loaded lazily on first executeCommand().
-        const strategy = (Strategy as any)[(entry.strategy ?? 'cookie').toUpperCase()] ?? Strategy.COOKIE;
-        const modulePath = path.resolve(clisDir, entry.modulePath);
-        const cmd: InternalCliCommand = {
-          site: entry.site,
-          name: entry.name,
-          description: entry.description ?? '',
-          domain: entry.domain,
-          strategy,
-          browser: entry.browser ?? true,
-          args: entry.args ?? [],
-          columns: entry.columns,
-          timeoutSeconds: entry.timeout,
-          source: modulePath,
-          _lazy: true,
-          _modulePath: modulePath,
-        };
-        registerCommand(cmd);
-      }
-    }
-  } catch (err: any) {
-    log.warn(`Failed to load manifest ${manifestPath}: ${err.message}`);
-  }
-}
-
-/**
- * Fallback: traditional filesystem scan (used during development with tsx).
- */
-async function discoverClisFromFs(dir: string): Promise<void> {
-  try { await fs.promises.access(dir); } catch { return; }
-  const promises: Promise<any>[] = [];
-  const entries = await fs.promises.readdir(dir, { withFileTypes: true });
-  
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const site = entry.name;
-    const siteDir = path.join(dir, site);
-    const files = await fs.promises.readdir(siteDir);
-    for (const file of files) {
-      const filePath = path.join(siteDir, file);
-      if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-        promises.push(registerYamlCli(filePath, site));
-      } else if (
-        (file.endsWith('.js') && !file.endsWith('.d.js')) ||
-        (file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts'))
-      ) {
-        promises.push(
-          import(`file://${filePath}`).catch((err: any) => {
-            log.warn(`Failed to load module ${filePath}: ${err.message}`);
-          })
-        );
-      }
-    }
-  }
-  await Promise.all(promises);
-}
-
-async function registerYamlCli(filePath: string, defaultSite: string): Promise<void> {
-  try {
-    const raw = await fs.promises.readFile(filePath, 'utf-8');
-    const def = yaml.load(raw) as any;
-    if (!def || typeof def !== 'object') return;
-
-    const site = def.site ?? defaultSite;
-    const name = def.name ?? path.basename(filePath, path.extname(filePath));
-    const strategyStr = def.strategy ?? (def.browser === false ? 'public' : 'cookie');
-    const strategy = (Strategy as any)[strategyStr.toUpperCase()] ?? Strategy.COOKIE;
-    const browser = def.browser ?? (strategy !== Strategy.PUBLIC);
-
-    const args: Arg[] = [];
-    if (def.args && typeof def.args === 'object') {
-      for (const [argName, argDef] of Object.entries(def.args as Record<string, any>)) {
-        args.push({
-          name: argName,
-          type: argDef?.type ?? 'str',
-          default: argDef?.default,
-          required: argDef?.required ?? false,
-          help: argDef?.description ?? argDef?.help ?? '',
-          choices: argDef?.choices,
-        });
-      }
-    }
-
-    const cmd: CliCommand = {
-      site,
-      name,
-      description: def.description ?? '',
-      domain: def.domain,
-      strategy,
-      browser,
-      args,
-      columns: def.columns,
-      pipeline: def.pipeline,
-      timeoutSeconds: def.timeout,
-      source: filePath,
-    };
-
-    registerCommand(cmd);
-  } catch (err: any) {
-    log.warn(`Failed to load ${filePath}: ${err.message}`);
-  }
-}
-
-/**
- * Validates and coerces arguments based on the command's Arg definitions.
- */
-function coerceAndValidateArgs(cmdArgs: Arg[], kwargs: Record<string, any>): Record<string, any> {
-  const result: Record<string, any> = { ...kwargs };
-
-  for (const argDef of cmdArgs) {
-    const val = result[argDef.name];
-    
-    // 1. Check required
-    if (argDef.required && (val === undefined || val === null || val === '')) {
-      throw new Error(`Argument "${argDef.name}" is required.\n${argDef.help ? `Hint: ${argDef.help}` : ''}`);
-    }
-
-    if (val !== undefined && val !== null) {
-      // 2. Type coercion
-      if (argDef.type === 'int' || argDef.type === 'number') {
-        const num = Number(val);
-        if (Number.isNaN(num)) {
-          throw new Error(`Argument "${argDef.name}" must be a valid number. Received: "${val}"`);
-        }
-        result[argDef.name] = num;
-      } else if (argDef.type === 'boolean' || argDef.type === 'bool') {
-        if (typeof val === 'string') {
-          const lower = val.toLowerCase();
-          if (lower === 'true' || lower === '1') result[argDef.name] = true;
-          else if (lower === 'false' || lower === '0') result[argDef.name] = false;
-          else throw new Error(`Argument "${argDef.name}" must be a boolean (true/false). Received: "${val}"`);
-        } else {
-          result[argDef.name] = Boolean(val);
-        }
-      }
-
-      // 3. Choices validation
-      const coercedVal = result[argDef.name];
-      if (argDef.choices && argDef.choices.length > 0) {
-        // Only stringent check for string/number types against choices array
-        if (!argDef.choices.map(String).includes(String(coercedVal))) {
-          throw new Error(`Argument "${argDef.name}" must be one of: ${argDef.choices.join(', ')}. Received: "${coercedVal}"`);
-        }
-      }
-    } else if (argDef.default !== undefined) {
-      // Set default if value is missing
-      result[argDef.name] = argDef.default;
-    }
-  }
-  return result;
-}
-
-/**
- * Execute a CLI command. Handles lazy-loading of TS modules.
- */
-export async function executeCommand(
-  cmd: CliCommand,
-  page: IPage | null,
-  rawKwargs: Record<string, any>,
-  debug: boolean = false,
-): Promise<any> {
-  let kwargs: Record<string, any>;
-  try {
-    kwargs = coerceAndValidateArgs(cmd.args, rawKwargs);
-  } catch (err: any) {
-    // Re-throw validation errors clearly
-    throw new Error(`[Argument Validation Error]\n${err.message}`);
-  }
-
-  // Lazy-load TS module on first execution
-  const internal = cmd as InternalCliCommand;
-  if (internal._lazy && internal._modulePath) {
-    const modulePath = internal._modulePath;
-    if (!_loadedModules.has(modulePath)) {
-      try {
-        await import(`file://${modulePath}`);
-        _loadedModules.add(modulePath);
-      } catch (err: any) {
-        throw new AdapterLoadError(
-          `Failed to load adapter module ${modulePath}: ${err.message}`,
-          'Check that the adapter file exists and has no syntax errors.',
-        );
-      }
-    }
-    // After loading, the module's cli() call will have updated the registry
-    // with the real func/pipeline. Re-fetch the command.
-    const { getRegistry, fullName } = await import('./registry.js');
-    const updated = getRegistry().get(fullName(cmd));
-    if (updated && updated.func) {
-      return updated.func(page!, kwargs, debug);
-    }
-    if (updated && updated.pipeline) {
-      return executePipeline(page, updated.pipeline, { args: kwargs, debug });
-    }
-  }
-
-  if (cmd.func) {
-    return cmd.func(page!, kwargs, debug);
-  }
-  if (cmd.pipeline) {
-    return executePipeline(page, cmd.pipeline, { args: kwargs, debug });
-  }
-  throw new Error(`Command ${cmd.site}/${cmd.name} has no func or pipeline`);
-}

package/src/pipeline.ts

@@ -1,8 +0,0 @@
-/**
- * YAML pipeline executor — re-exports from modular pipeline system.
- *
- * This file exists for backward compatibility. All logic has been
- * refactored into src/pipeline/ with modular step handlers.
- */
-
-export { executePipeline, type PipelineContext } from './pipeline/index.js';