adhdev 0.1.53 → 0.2.0

package/package.json

@@ -1,18 +1,16 @@
 {
   "name": "adhdev",
-  "version": "0.1.53",
-  "description": "ADHDev CLI — Detect, install and configure your IDE + AI agent extensions",
+  "version": "0.2.0",
+  "description": "ADHDev — Agent Dashboard Hub for Dev. Remote-control AI coding agents from anywhere.",
   "main": "dist/index.js",
   "bin": {
-    "adhdev": "./dist/index.js"
+    "adhdev": "./dist/cli-entrypoint.js"
   },
   "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsup && cp src/daemon/dev-console.html src/daemon/dev-console.css src/daemon/dev-console.js src/daemon/dev-console-monaco.js dist/",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build",
-    "test": "vitest run",
-    "test:watch": "vitest"
+    "build": "tsup",
+    "dev": "tsx src/cli-entrypoint.ts",
+    "start": "node dist/cli-entrypoint.js",
+    "prepublishOnly": "npm run build"
   },
   "files": [
     "dist",
@@ -27,22 +25,28 @@
     "setup-wizard",
     "cursor",
     "vscode",
-    "antigravity"
+    "windsurf",
+    "p2p",
+    "webrtc"
   ],
   "author": "vilmire",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
-    "url": "https://github.com/vilmire/adhdev.git",
-    "directory": "packages/launcher"
+    "url": "https://github.com/vilmire/adhdev-cloud.git",
+    "directory": "packages/daemon-cloud"
+  },
+  "homepage": "https://adhf.dev",
+  "bugs": "https://github.com/vilmire/adhdev-cloud/issues",
+  "engines": {
+    "node": ">=18"
   },
-  "homepage": "https://github.com/vilmire/adhdev#readme",
-  "bugs": "https://github.com/vilmire/adhdev/issues",
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "conf": "^13.0.0",
     "inquirer": "^9.3.0",
+    "node-datachannel": "^0.32.1",
     "node-pty": "^1.0.0",
     "open": "^10.1.0",
     "ora": "^8.0.0",
@@ -54,7 +58,6 @@
     "@types/ws": "^8.18.1",
     "tsup": "^8.2.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.5.0",
-    "vitest": "^4.0.18"
+    "typescript": "^5.5.0"
   }
 }

package/providers/_builtin/CONTRIBUTING.md

@@ -0,0 +1,141 @@
+# 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

@@ -0,0 +1,51 @@
+# 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/acp/agentpool/provider.json

@@ -0,0 +1,47 @@
+{
+  "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

@@ -0,0 +1,45 @@
+{
+  "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

@@ -0,0 +1,50 @@
+{
+  "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

@@ -0,0 +1,47 @@
+{
+  "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

@@ -0,0 +1,45 @@
+{
+  "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

@@ -0,0 +1,47 @@
+{
+  "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
+    }
+  }
+}

package/providers/_builtin/acp/claude-agent/provider.json

@@ -0,0 +1,50 @@
+{
+  "type": "claude-agent-acp",
+  "name": "Claude Agent (ACP)",
+  "category": "acp",
+  "displayName": "Claude Agent",
+  "icon": "🟠",
+  "install": "npm install -g @zed-industries/claude-agent-acp  (requires ANTHROPIC_API_KEY)",
+  "spawn": {
+    "command": "claude-agent-acp",
+    "args": [],
+    "shell": false
+  },
+  "auth": [
+    {
+      "type": "env_var",
+      "id": "anthropic",
+      "name": "Anthropic API Key",
+      "vars": [
+        {
+          "name": "ANTHROPIC_API_KEY"
+        }
+      ],
+      "link": "https://console.anthropic.com/settings/keys"
+    }
+  ],
+  "settings": {
+    "approvalAlert": {
+      "type": "boolean",
+      "default": true,
+      "public": true,
+      "label": "Approval Alerts",
+      "description": "Show notification when Claude 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/cline-acp/provider.json

@@ -0,0 +1,47 @@
+{
+  "type": "cline-acp",
+  "name": "Cline (ACP)",
+  "category": "acp",
+  "displayName": "Cline (ACP)",
+  "icon": "🔵",
+  "install": "npm install -g cline",
+  "spawn": {
+    "command": "cline",
+    "args": [
+      "--acp"
+    ],
+    "shell": false
+  },
+  "auth": [
+    {
+      "type": "agent",
+      "id": "cline-settings",
+      "name": "Cline Settings",
+      "description": "Configure API keys through Cline interactive setup"
+    }
+  ],
+  "settings": {
+    "approvalAlert": {
+      "type": "boolean",
+      "default": true,
+      "public": true,
+      "label": "Approval Alerts",
+      "description": "Show notification when Cline 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
+    }
+  }
+}