adhdev 0.2.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adhdev",
-  "version": "0.2.0",
+  "version": "0.4.1",
   "description": "ADHDev — Agent Dashboard Hub for Dev. Remote-control AI coding agents from anywhere.",
   "main": "dist/index.js",
   "bin": {
@@ -14,7 +14,6 @@
   },
   "files": [
     "dist",
-    "providers",
     "README.md"
   ],
   "keywords": [
@@ -42,6 +41,7 @@
     "node": ">=18"
   },
   "dependencies": {
+    "@adhdev/daemon-core": "*",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "conf": "^13.0.0",

package/providers/_builtin/CONTRIBUTING.md

@@ -1,141 +0,0 @@
-# Contributing to ADHDev Providers
-
-> How to add new providers or improve existing ones for ADHDev.
-
-## Quick Start
-
-### 1. Fork & Clone
-
-```bash
-git clone https://github.com/YOUR_USERNAME/adhdev-providers.git
-cd adhdev-providers
-```
-
-### 2. Create a Provider
-
-Create a `provider.js` in the appropriate category directory:
-
-```bash
-# IDE provider
-mkdir -p ide/my-ide && touch ide/my-ide/provider.js
-
-# CLI agent
-mkdir -p cli/my-cli && touch cli/my-cli/provider.js
-
-# ACP agent
-mkdir -p acp/my-agent && touch acp/my-agent/provider.js
-
-# VS Code extension
-mkdir -p extension/my-ext && touch extension/my-ext/provider.js
-```
-
-### 3. Provider Structure
-
-```javascript
-module.exports = {
-  type: 'my-ide',           // unique identifier (must not conflict)
-  name: 'My IDE',           // display name
-  category: 'ide',          // 'ide' | 'extension' | 'cli' | 'acp'
-  displayName: 'My IDE',
-  icon: '🔧',
-
-  // IDE: CDP configuration
-  cdpPorts: [9357, 9358],   // use next available ports (see table below)
-  cli: 'my-ide',
-  paths: { darwin: ['/Applications/My IDE.app'] },
-
-  // CDP scripts
-  scripts: {
-    readChat() { return `(() => { /* ... */ })()`; },
-    sendMessage(text) { return `(() => { /* ... */ })()`; },
-  },
-};
-```
-
-> 📖 Full guide: [PROVIDER_GUIDE.md](https://github.com/vilmire/adhdev/blob/main/docs/PROVIDER_GUIDE.md)
-
-### 4. Validate
-
-```bash
-# Syntax check
-node -c ide/my-ide/provider.js
-
-# Schema validation (required fields, port conflicts, etc.)
-node validate.js ide/my-ide/provider.js
-
-# Validate all providers
-node validate.js
-```
-
-### 5. Local Testing
-
-```bash
-# If ADHDev is installed:
-# Copy your provider to the user directory for instant loading
-mkdir -p ~/.adhdev/providers/ide/my-ide
-cp ide/my-ide/provider.js ~/.adhdev/providers/ide/my-ide/
-
-# Restart daemon to pick up changes
-adhdev daemon:restart
-
-# Test scripts via DevConsole
-# Open http://127.0.0.1:19280 → IDE tab → Scripts → Run
-```
-
-### 6. Submit PR
-
-```bash
-git checkout -b feat/add-my-ide
-git add -A
-git commit -m "feat: add My IDE provider"
-git push origin feat/add-my-ide
-# Open a Pull Request on GitHub
-```
-
----
-
-## PR Checklist
-
-- [ ] `node validate.js` passes with no errors
-- [ ] `type` does not conflict with existing providers
-- [ ] CDP ports do not overlap with existing ones (for IDE providers)
-- [ ] At least `readChat` + `sendMessage` scripts implemented
-- [ ] Tested via DevConsole (if ADHDev is available)
-
----
-
-## Reference Implementations
-
-| Category | Reference | Key Features |
-|----------|-----------|-------------|
-| **IDE (mainframe)** | `ide/cursor/provider.js` | CDP evaluate, `inputMethod` |
-| **IDE (webview)** | `ide/kiro/provider.js` | `webviewMatchText`, `webview*` scripts |
-| **CLI** | `cli/gemini-cli/provider.js` | `aliases`, spawn config |
-| **ACP** | `acp/gemini-cli/provider.js` | `auth`, `spawn`, `settings` |
-| **Extension** | `extension/cline/provider.js` | `extensionIdPattern`, webview |
-
----
-
-## CDP Port Registry
-
-| Port | Provider |
-|------|----------|
-| 9333–9334 | Cursor |
-| 9335–9336 | Antigravity |
-| 9337–9338 | Windsurf |
-| 9339–9340 | VS Code |
-| 9341–9342 | VS Code Insiders |
-| 9343–9344 | VSCodium |
-| 9351–9352 | Kiro |
-| 9353–9354 | Trae |
-| 9355–9356 | PearAI |
-
-**Next available: 9357+**
-
----
-
-## Need Help?
-
-- Full provider guide: [PROVIDER_GUIDE.md](https://github.com/vilmire/adhdev/blob/main/docs/PROVIDER_GUIDE.md)
-- DOM exploration tips: PROVIDER_GUIDE.md §6
-- DevConsole usage: PROVIDER_GUIDE.md §4

package/providers/_builtin/README.md

@@ -1,51 +0,0 @@
-# ADHDev Providers
-
-> IDE, CLI, Extension, and ACP provider definitions for [ADHDev](https://github.com/vilmire/adhdev).
-
-## Structure
-
-```
-├── ide/            — IDE providers (Cursor, Windsurf, Kiro, PearAI, etc.)
-├── cli/            — CLI agent providers (Gemini CLI, Claude Code, Codex CLI)
-├── extension/      — VS Code extension providers (Cline, Roo Code)
-├── acp/            — ACP agent providers (40+ agents)
-├── _helpers/       — Shared utility functions
-├── validate.js     — Provider schema validator
-└── CONTRIBUTING.md — How to add a new provider
-```
-
-## Adding a New Provider
-
-1. Create `provider.js` in the appropriate category:
-
-```bash
-mkdir -p ide/my-ide
-# Edit ide/my-ide/provider.js
-```
-
-2. Validate:
-
-```bash
-node validate.js ide/my-ide/provider.js
-```
-
-3. Submit a PR.
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full workflow, and  
-[PROVIDER_GUIDE.md](https://github.com/vilmire/adhdev/blob/main/docs/PROVIDER_GUIDE.md) for the complete specification.
-
-## How It Works
-
-This repository is consumed by ADHDev in three ways:
-
-| Method | When | Directory |
-|--------|------|-----------|
-| **Bundled** | `npm install -g adhdev` | `_builtin/` (offline fallback) |
-| **Auto-updated** | Every daemon start | `~/.adhdev/providers/.upstream/` |
-| **User custom** | Manual | `~/.adhdev/providers/` (never overwritten) |
-
-Loading priority: **User custom > Auto-updated > Bundled**
-
-## License
-
-MIT

package/providers/_builtin/_helpers/index.js

@@ -1,188 +0,0 @@
-/**
- * Provider Helpers — 공유 유틸리티
- * 
- * 각 provider.js에서 require해 사용할 수 있는 공통 함수들.
- * 사용은 선택사항 — 각 provider.js는 독립적이어도 됨.
- * 
- * 사용법 (provider.js 내부):
- *   const { getWebviewDoc, htmlToMd, waitFor } = require('../../_helpers/index.js');
- */
-
-/**
- * Extension webview iframe의 contentDocument 접근
- * @param {string} [selector='iframe'] - iframe 셀렉터
- * @returns {string} CDP evaluate용 JS 코드 (document 변수를 설정)
- */
-function getWebviewDoc(selector = 'iframe') {
-  return `
-    const _iframe = document.querySelector('${selector}');
-    const _doc = _iframe ? (_iframe.contentDocument || _iframe.contentWindow?.document) : document;
-  `;
-}
-
-/**
- * React Fiber 데이터 추출 헬퍼 코드
- * 특정 엔트리 포인트에서 시작해 memoizedState를 순회
- * @param {string[]} entrySelectors - 엔트리 포인트 CSS 셀렉터
- * @param {number} [maxDepth=200] - Fiber 트리 최대 순회 깊이
- * @returns {string} CDP evaluate용 JS 코드 (변수 _fiberData를 설정)
- */
-function getFiber(entrySelectors, maxDepth = 200) {
-  const sels = JSON.stringify(entrySelectors);
-  return `
-    let _fiberData = null;
-    const _entryPoints = ${sels};
-    for (const sel of _entryPoints) {
-      const el = document.querySelector(sel);
-      if (!el) continue;
-      const fk = Object.keys(el).find(k => k.startsWith('__reactFiber'));
-      if (!fk) continue;
-      let fib = el[fk];
-      for (let d = 0; d < ${maxDepth} && fib; d++) {
-        if (fib.memoizedState) {
-          let s = fib.memoizedState;
-          while (s) {
-            try {
-              const memo = s.memoizedState;
-              if (memo && typeof memo === 'object') {
-                _fiberData = memo;
-                break;
-              }
-            } catch(e) {}
-            s = s.next;
-          }
-        }
-        if (_fiberData) break;
-        fib = fib.return;
-      }
-      if (_fiberData) break;
-    }
-  `;
-}
-
-/**
- * 텍스트 입력 + Enter 전송 코드 생성
- * @param {string} varName - 텍스트가 저장된 변수명
- * @param {string} selectorExpr - 에디터 요소 참조 JS 표현식
- * @returns {string} CDP evaluate용 JS 코드
- */
-function typeAndSubmit(varName, selectorExpr) {
-  return `
-    const _editor = ${selectorExpr};
-    if (_editor) {
-      _editor.focus();
-      document.execCommand('selectAll', false, null);
-      document.execCommand('delete', false, null);
-      document.execCommand('insertText', false, ${varName});
-      _editor.dispatchEvent(new Event('input', { bubbles: true }));
-      await new Promise(r => setTimeout(r, 300));
-      const _enterOpts = { key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true, cancelable: true, composed: true };
-      _editor.dispatchEvent(new KeyboardEvent('keydown', _enterOpts));
-      _editor.dispatchEvent(new KeyboardEvent('keypress', _enterOpts));
-      _editor.dispatchEvent(new KeyboardEvent('keyup', _enterOpts));
-    }
-  `;
-}
-
-/**
- * 요소 대기 코드 생성
- * @param {string} selector - CSS 셀렉터
- * @param {number} [timeout=5000] - 최대 대기 시간 (ms)
- * @returns {string} CDP evaluate용 JS 코드 (표현식 → 요소 또는 null)
- */
-function waitFor(selector, timeout = 5000) {
-  return `
-    await new Promise((resolve) => {
-      const _t = Date.now();
-      const _check = () => {
-        const el = document.querySelector('${selector}');
-        if (el && el.offsetWidth > 0) return resolve(el);
-        if (Date.now() - _t > ${timeout}) return resolve(null);
-        setTimeout(_check, 200);
-      };
-      _check();
-    })
-  `;
-}
-
-/**
- * HTML → Markdown 변환 함수 (CDP 코드 문자열)
- * 대시보드가 ReactMarkdown+remarkGfm을 사용하므로 HTML을 GFM으로 변환 필요
- * @returns {string} htmlToMd, childrenToMd 함수 선언 코드
- */
-function htmlToMdCode() {
-  return `
-    function htmlToMd(node) {
-      if (node.nodeType === 3) return node.textContent || '';
-      if (node.nodeType !== 1) return '';
-      const tag = node.tagName;
-      if (tag === 'STYLE' || tag === 'SCRIPT' || tag === 'SVG') return '';
-      if (tag === 'TABLE') {
-        const rows = Array.from(node.querySelectorAll('tr'));
-        if (rows.length === 0) return '';
-        const table = rows.map(tr => Array.from(tr.querySelectorAll('th, td')).map(cell => (cell.textContent || '').trim().replace(/\\|/g, '\\\\|')));
-        if (table.length === 0) return '';
-        const colCount = Math.max(...table.map(r => r.length));
-        const header = table[0];
-        const sep = Array(colCount).fill('---');
-        const body = table.slice(1);
-        let md = '| ' + header.join(' | ') + ' |\\n';
-        md += '| ' + sep.join(' | ') + ' |\\n';
-        for (const row of body) {
-          while (row.length < colCount) row.push('');
-          md += '| ' + row.join(' | ') + ' |\\n';
-        }
-        return '\\n' + md + '\\n';
-      }
-      if (tag === 'UL') return '\\n' + Array.from(node.children).map(li => '- ' + childrenToMd(li).trim()).join('\\n') + '\\n';
-      if (tag === 'OL') return '\\n' + Array.from(node.children).map((li, i) => (i + 1) + '. ' + childrenToMd(li).trim()).join('\\n') + '\\n';
-      if (tag === 'LI') return childrenToMd(node);
-      if (tag === 'H1') return '\\n# ' + childrenToMd(node).trim() + '\\n';
-      if (tag === 'H2') return '\\n## ' + childrenToMd(node).trim() + '\\n';
-      if (tag === 'H3') return '\\n### ' + childrenToMd(node).trim() + '\\n';
-      if (tag === 'H4') return '\\n#### ' + childrenToMd(node).trim() + '\\n';
-      if (tag === 'STRONG' || tag === 'B') return '**' + childrenToMd(node).trim() + '**';
-      if (tag === 'EM' || tag === 'I') return '*' + childrenToMd(node).trim() + '*';
-      if (tag === 'PRE') {
-        const codeEl = node.querySelector('code');
-        const lang = codeEl ? (codeEl.className.match(/language-(\\w+)/)?.[1] || '') : '';
-        const code = (codeEl || node).textContent || '';
-        return '\\n\`\`\`' + lang + '\\n' + code.trim() + '\\n\`\`\`\\n';
-      }
-      if (tag === 'CODE') {
-        if (node.parentElement && node.parentElement.tagName === 'PRE') return node.textContent || '';
-        return '\`' + (node.textContent || '').trim() + '\`';
-      }
-      if (tag === 'BLOCKQUOTE') return '\\n> ' + childrenToMd(node).trim().replace(/\\n/g, '\\n> ') + '\\n';
-      if (tag === 'A') return '[' + childrenToMd(node).trim() + '](' + (node.getAttribute('href') || '') + ')';
-      if (tag === 'BR') return '\\n';
-      if (tag === 'P') return '\\n' + childrenToMd(node).trim() + '\\n';
-      return childrenToMd(node);
-    }
-    function childrenToMd(node) {
-      return Array.from(node.childNodes).map(htmlToMd).join('');
-    }
-  `;
-}
-
-/**
- * 노이즈 텍스트 필터링 (상태 메시지, MCP 등)
- * @param {string} text - 원본 텍스트
- * @returns {boolean} true면 노이즈
- */
-function isNoiseText(text) {
-  const low = (text || '').trim().toLowerCase();
-  if (low.length > 60) return false;
-  if (/^(analyzed\s+\d|edited\s+\d|ran\s+\S|terminal\s|reading|searching)/i.test(low)) return true;
-  if (/^(mcp|customizationmcp|serversexport)/i.test(low)) return true;
-  return false;
-}
-
-module.exports = {
-  getWebviewDoc,
-  getFiber,
-  typeAndSubmit,
-  waitFor,
-  htmlToMdCode,
-  isNoiseText,
-};

package/providers/_builtin/acp/agentpool/provider.json

@@ -1,47 +0,0 @@
-{
-  "type": "agentpool-acp",
-  "name": "AgentPool (ACP)",
-  "category": "acp",
-  "displayName": "AgentPool",
-  "icon": "🏊",
-  "install": "pip install agentpool  (Python/uvx)",
-  "spawn": {
-    "command": "agentpool",
-    "args": [
-      "acp"
-    ],
-    "shell": false
-  },
-  "auth": [
-    {
-      "type": "agent",
-      "id": "agentpool",
-      "name": "AgentPool Auth",
-      "description": "Configure provider through AgentPool setup"
-    }
-  ],
-  "settings": {
-    "approvalAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Approval Alerts",
-      "description": "Show notification when agent requires approval"
-    },
-    "longGeneratingAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Long Generation Alert",
-      "description": "Alert when generation takes too long"
-    },
-    "longGeneratingThresholdSec": {
-      "type": "number",
-      "default": 180,
-      "public": true,
-      "label": "Long Generation Threshold (sec)",
-      "min": 30,
-      "max": 600
-    }
-  }
-}

package/providers/_builtin/acp/amp/provider.json

@@ -1,45 +0,0 @@
-{
-  "type": "amp-acp",
-  "name": "Amp (ACP)",
-  "category": "acp",
-  "displayName": "Amp",
-  "icon": "⚡",
-  "install": "Binary download from GitHub: https://github.com/tao12345666333/amp-acp/releases",
-  "spawn": {
-    "command": "amp-acp",
-    "args": [],
-    "shell": false
-  },
-  "auth": [
-    {
-      "type": "agent",
-      "id": "amp-auth",
-      "name": "Amp Authentication",
-      "description": "Authenticate through Amp setup flow"
-    }
-  ],
-  "settings": {
-    "approvalAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Approval Alerts",
-      "description": "Show notification when Amp requires approval"
-    },
-    "longGeneratingAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Long Generation Alert",
-      "description": "Alert when generation takes too long"
-    },
-    "longGeneratingThresholdSec": {
-      "type": "number",
-      "default": 180,
-      "public": true,
-      "label": "Long Generation Threshold (sec)",
-      "min": 30,
-      "max": 600
-    }
-  }
-}

package/providers/_builtin/acp/auggie/provider.json

@@ -1,50 +0,0 @@
-{
-  "type": "auggie-acp",
-  "name": "Auggie CLI (ACP)",
-  "category": "acp",
-  "displayName": "Auggie CLI",
-  "icon": "🧠",
-  "install": "npm install -g @augmentcode/auggie",
-  "spawn": {
-    "command": "auggie",
-    "args": [
-      "--acp"
-    ],
-    "shell": false,
-    "env": {
-      "AUGMENT_DISABLE_AUTO_UPDATE": "1"
-    }
-  },
-  "auth": [
-    {
-      "type": "agent",
-      "id": "augment",
-      "name": "Augment Code Auth",
-      "description": "Authenticate through Augment Code setup"
-    }
-  ],
-  "settings": {
-    "approvalAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Approval Alerts",
-      "description": "Show notification when agent requires approval"
-    },
-    "longGeneratingAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Long Generation Alert",
-      "description": "Alert when generation takes too long"
-    },
-    "longGeneratingThresholdSec": {
-      "type": "number",
-      "default": 180,
-      "public": true,
-      "label": "Long Generation Threshold (sec)",
-      "min": 30,
-      "max": 600
-    }
-  }
-}

package/providers/_builtin/acp/autodev/provider.json

@@ -1,47 +0,0 @@
-{
-  "type": "autodev-acp",
-  "name": "AutoDev (ACP)",
-  "category": "acp",
-  "displayName": "AutoDev",
-  "icon": "🤖",
-  "install": "Download from https://github.com/phodal/auto-dev/releases",
-  "spawn": {
-    "command": "autodev",
-    "args": [
-      "acp"
-    ],
-    "shell": false
-  },
-  "auth": [
-    {
-      "type": "agent",
-      "id": "autodev",
-      "name": "AutoDev Auth",
-      "description": "Configure provider through AutoDev setup"
-    }
-  ],
-  "settings": {
-    "approvalAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Approval Alerts",
-      "description": "Show notification when agent requires approval"
-    },
-    "longGeneratingAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Long Generation Alert",
-      "description": "Alert when generation takes too long"
-    },
-    "longGeneratingThresholdSec": {
-      "type": "number",
-      "default": 180,
-      "public": true,
-      "label": "Long Generation Threshold (sec)",
-      "min": 30,
-      "max": 600
-    }
-  }
-}

package/providers/_builtin/acp/autohand/provider.json

@@ -1,45 +0,0 @@
-{
-  "type": "autohand-acp",
-  "name": "Autohand Code (ACP)",
-  "category": "acp",
-  "displayName": "Autohand Code",
-  "icon": "🤖",
-  "install": "npm install -g @autohandai/autohand-acp",
-  "spawn": {
-    "command": "autohand-acp",
-    "args": [],
-    "shell": false
-  },
-  "auth": [
-    {
-      "type": "agent",
-      "id": "autohand",
-      "name": "Autohand Auth",
-      "description": "Authenticate through Autohand AI setup"
-    }
-  ],
-  "settings": {
-    "approvalAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Approval Alerts",
-      "description": "Show notification when agent requires approval"
-    },
-    "longGeneratingAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Long Generation Alert",
-      "description": "Alert when generation takes too long"
-    },
-    "longGeneratingThresholdSec": {
-      "type": "number",
-      "default": 180,
-      "public": true,
-      "label": "Long Generation Threshold (sec)",
-      "min": 30,
-      "max": 600
-    }
-  }
-}

package/providers/_builtin/acp/blackbox-ai/provider.json

@@ -1,47 +0,0 @@
-{
-  "type": "blackbox-ai-acp",
-  "name": "Blackbox AI (ACP)",
-  "category": "acp",
-  "displayName": "Blackbox AI",
-  "icon": "⬛",
-  "install": "Download from https://docs.blackbox.ai/features/blackbox-cli",
-  "spawn": {
-    "command": "blackbox",
-    "args": [
-      "acp"
-    ],
-    "shell": false
-  },
-  "auth": [
-    {
-      "type": "agent",
-      "id": "blackbox",
-      "name": "Blackbox Auth",
-      "description": "Authenticate with Blackbox AI account"
-    }
-  ],
-  "settings": {
-    "approvalAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Approval Alerts",
-      "description": "Show notification when agent requires approval"
-    },
-    "longGeneratingAlert": {
-      "type": "boolean",
-      "default": true,
-      "public": true,
-      "label": "Long Generation Alert",
-      "description": "Alert when generation takes too long"
-    },
-    "longGeneratingThresholdSec": {
-      "type": "number",
-      "default": 180,
-      "public": true,
-      "label": "Long Generation Threshold (sec)",
-      "min": 30,
-      "max": 600
-    }
-  }
-}