@dinoxx/dinox-cli 2.9.0 → 2.11.0

package/dist/gateway/detect.js

@@ -17,13 +17,13 @@ export const KNOWN_ACP_AGENTS = [
         id: 'claude',
         name: 'Claude Code',
         candidates: [['claude-agent-acp'], ['claude-code-acp']],
-        adapter: { baseBinary: 'claude', install: 'npm install -g @agentclientprotocol/claude-agent-acp' },
+        adapter: { baseBinary: 'claude', packageName: '@agentclientprotocol/claude-agent-acp' },
     },
     {
         id: 'codex',
         name: 'Codex',
         candidates: [['codex-acp']],
-        adapter: { baseBinary: 'codex', install: 'npm install -g @agentclientprotocol/codex-acp' },
+        adapter: { baseBinary: 'codex', packageName: '@agentclientprotocol/codex-acp' },
     },
     { id: 'gemini', name: 'Gemini CLI', candidates: [['gemini', '--acp'], ['gemini', '--experimental-acp']] },
     { id: 'copilot', name: 'GitHub Copilot', candidates: [['copilot', '--acp']] },
@@ -31,8 +31,8 @@ export const KNOWN_ACP_AGENTS = [
     { id: 'opencode', name: 'OpenCode', candidates: [['opencode', 'acp']] },
     { id: 'pi', name: 'pi', candidates: [['pi-acp']] },
     { id: 'goose', name: 'Goose', candidates: [['goose', 'acp']] },
-    { id: 'qwen', name: 'Qwen Code', candidates: [['qwen', '--acp'], ['qwen', '--experimental-acp']] },
-    { id: 'kimi', name: 'Kimi CLI', candidates: [['kimi', 'acp'], ['kimi', '--acp']] },
+    { id: 'qwen', name: 'Qwen Code', candidates: [['qwen', '--acp'], ['qwen', '--acp', '--experimental-skills'], ['qwen', '--experimental-acp']] },
+    { id: 'kimi', name: 'Kimi Code CLI', candidates: [['kimi', 'acp'], ['kimi', '--acp']] },
     // DeepSeek Harness: ACP is a dsh profile; the model key comes from DEEPSEEK_API_KEY.
     { id: 'deepseek', name: 'DeepSeek Harness', candidates: [['dsh', '--profile', 'acp']] },
     { id: 'qoder', name: 'Qoder CLI', candidates: [['qodercli', '--acp'], ['qoderclicn', '--acp']] },
@@ -40,7 +40,56 @@ export const KNOWN_ACP_AGENTS = [
         id: 'zcode',
         name: 'ZCode',
         candidates: [['zcode-acp']],
-        adapter: { baseBinary: 'zcode', install: 'npm install -g zcode-acp' },
+        adapter: { baseBinary: 'zcode', packageName: 'zcode-acp' },
+    },
+    // Launch lines follow Paseo's ACP catalog (packages/app/src/data/acp-provider-catalog.ts).
+    // Local binaries only: detect must not run `npx -y`, which would download a package just to probe it.
+    { id: 'amp', name: 'Amp', candidates: [['amp-acp']] },
+    {
+        id: 'auggie',
+        name: 'Auggie CLI',
+        candidates: [['auggie', '--acp']],
+        env: { AUGMENT_DISABLE_AUTO_UPDATE: '1' },
+    },
+    { id: 'autohand', name: 'Autohand Code', candidates: [['autohand-acp']] },
+    { id: 'cline', name: 'Cline', candidates: [['cline', '--acp']] },
+    { id: 'codebuddy', name: 'Codebuddy Code', candidates: [['codebuddy', '--acp']] },
+    { id: 'codewhale', name: 'CodeWhale', candidates: [['codewhale', 'serve', '--acp']] },
+    { id: 'cortex', name: 'Cortex Code', candidates: [['cortex', 'acp', 'serve']] },
+    { id: 'corust', name: 'Corust Agent', candidates: [['corust-agent-acp']] },
+    { id: 'crow', name: 'crow-cli', candidates: [['crow-cli', 'acp']] },
+    { id: 'deepagents', name: 'DeepAgents', candidates: [['deepagents-acp']] },
+    { id: 'devin', name: 'Devin CLI', candidates: [['devin', 'acp']] },
+    { id: 'dimcode', name: 'DimCode', candidates: [['dimcode', 'acp'], ['dim', 'acp']] },
+    { id: 'dirac', name: 'Dirac', candidates: [['dirac', '--acp']] },
+    {
+        id: 'droid',
+        name: 'Factory Droid',
+        candidates: [['droid', 'exec', '--output-format', 'acp-daemon']],
+        env: { DROID_DISABLE_AUTO_UPDATE: 'true', FACTORY_DROID_AUTO_UPDATE_ENABLED: 'false' },
+    },
+    { id: 'fast-agent', name: 'fast-agent', candidates: [['fast-agent-acp', '-x']] },
+    { id: 'gjc', name: 'Gajae Code', candidates: [['gjc', 'acp']], env: { GJC_ACP_PERMISSION_MODE: 'prompt' } },
+    { id: 'glm', name: 'GLM Agent', candidates: [['glm-acp-agent']] },
+    { id: 'grok', name: 'Grok', candidates: [['grok', 'agent', 'stdio']] },
+    { id: 'hoplite', name: 'Hoplite', candidates: [['hoplite', 'acp']] },
+    { id: 'junie', name: 'Junie', candidates: [['junie', '--acp', 'true']] },
+    { id: 'kilo', name: 'Kilo Code', candidates: [['kilo', 'acp']] },
+    { id: 'kiro', name: 'Kiro CLI', candidates: [['kiro-cli', 'acp']] },
+    { id: 'minimax', name: 'MiniMax Code', candidates: [['mcode', 'acp']] },
+    { id: 'minion', name: 'Minion Code', candidates: [['minion-code', 'acp']] },
+    { id: 'vibe', name: 'Mistral Vibe', candidates: [['vibe-acp']] },
+    { id: 'nova', name: 'Nova', candidates: [['nova', 'acp']] },
+    { id: 'poolside', name: 'Poolside', candidates: [['pool', 'acp']] },
+    { id: 'agoragentic', name: 'Agoragentic', candidates: [['agoragentic-mcp', '--acp']] },
+    { id: 'sigit', name: 'siGit Code', candidates: [['sigit']] },
+    { id: 'stakpak', name: 'Stakpak', candidates: [['stakpak', 'acp']] },
+    { id: 'trae', name: 'TRAE CLI', candidates: [['traecli', 'acp', 'serve']] },
+    {
+        id: 'vtcode',
+        name: 'VT Code',
+        candidates: [['vtcode', 'acp']],
+        env: { VT_ACP_ENABLED: '1', VT_ACP_ZED_ENABLED: '1' },
     },
 ];
 /** The known agent a manual launch command starts, by executable name and arguments. */
@@ -52,6 +101,17 @@ export function inferAgentId(command, args = []) {
 }
 // Some agents cold-start slowly (OpenCode boots a local server: ~40s on first run).
 const PROBE_TIMEOUT_MS = 45_000;
+/** A launch stayed up but never completed the ACP handshake. Further flags of that agent are not tried. */
+export class AcpProbeTimeoutError extends Error {
+    constructor() {
+        super('no ACP handshake within timeout');
+        this.name = 'AcpProbeTimeoutError';
+    }
+}
+/** A quick failure can be a wrong flag. A timeout means that agent is not going to answer. */
+export function shouldTryNextAcpCandidate(error) {
+    return !(error instanceof AcpProbeTimeoutError);
+}
 export async function findExecutable(name, envPath = process.env.PATH ?? '') {
     const extensions = process.platform === 'win32' ? (process.env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';') : [''];
     for (const dir of envPath.split(path.delimiter).filter(Boolean)) {
@@ -70,8 +130,12 @@ export async function findExecutable(name, envPath = process.env.PATH ?? '') {
     return null;
 }
 /** Starts the agent, runs `initialize`, and stops it. Never leaves the process running. */
-export async function probeAcpAgent(command, args, timeoutMs = PROBE_TIMEOUT_MS) {
-    const launch = agentLaunch(command, args, { stdio: ['pipe', 'pipe', 'ignore'], env: process.env, windowsHide: true });
+export async function probeAcpAgent(command, args, timeoutMs = PROBE_TIMEOUT_MS, env) {
+    const launch = agentLaunch(command, args, {
+        stdio: ['pipe', 'pipe', 'ignore'],
+        env: env ? { ...process.env, ...env } : process.env,
+        windowsHide: true,
+    });
     const child = spawn(launch.command, launch.args, launch.options);
     if (!child.stdin || !child.stdout)
         throw new Error('ACP probe stdio was not piped');
@@ -82,7 +146,7 @@ export async function probeAcpAgent(command, args, timeoutMs = PROBE_TIMEOUT_MS)
             child.once('exit', (code) => reject(new Error(`exited before handshake (code ${code})`)));
         });
         const timedOut = new Promise((_, reject) => {
-            timer = setTimeout(() => reject(new Error('no ACP handshake within timeout')), timeoutMs);
+            timer = setTimeout(() => reject(new AcpProbeTimeoutError()), timeoutMs);
         });
         const connection = new ClientSideConnection(() => ({
             sessionUpdate: async () => { },
@@ -118,17 +182,29 @@ export async function detectAcpAgents(options = {}) {
                 return { id: agent.id, name: agent.name, command, args, verified: false, agentName: null, agentVersion: null };
             }
             try {
-                const info = await probeAcpAgent(command, args);
-                return { id: agent.id, name: agent.name, command, args, verified: true, ...info };
+                const info = await probeAcpAgent(command, args, options.timeoutMs, agent.env);
+                const detected = {
+                    id: agent.id,
+                    name: agent.name,
+                    command,
+                    args,
+                    verified: true,
+                    ...info,
+                    ...(agent.env ? { env: agent.env } : {}),
+                };
+                options.onDetected?.(detected);
+                return detected;
             }
             catch (error) {
                 lastError = error instanceof Error ? error.message : String(error);
+                if (!shouldTryNextAcpCandidate(error))
+                    break;
             }
         }
         if (!lastError) {
             if (agent.adapter && (await findExecutable(agent.adapter.baseBinary))) {
                 const [binary, ...args] = agent.candidates[0];
-                return {
+                const detected = {
                     id: agent.id,
                     name: agent.name,
                     command: binary,
@@ -136,14 +212,51 @@ export async function detectAcpAgents(options = {}) {
                     verified: false,
                     agentName: null,
                     agentVersion: null,
-                    installHint: agent.adapter.install,
+                    installHint: `npm install -g ${agent.adapter.packageName}`,
                 };
+                options.onDetected?.(detected);
+                return detected;
             }
             return null;
         }
         const [binary, ...args] = agent.candidates[0];
         const command = (await findExecutable(binary)) ?? binary;
-        return { id: agent.id, name: agent.name, command, args, verified: false, agentName: null, agentVersion: null, error: lastError };
+        const detected = {
+            id: agent.id,
+            name: agent.name,
+            command,
+            args,
+            verified: false,
+            agentName: null,
+            agentVersion: null,
+            error: lastError,
+        };
+        options.onDetected?.(detected);
+        return detected;
     }));
     return results.filter((agent) => agent !== null);
 }
+/**
+ * Agents whose own CLI is on PATH but none of the ACP launch commands are.
+ * Those need a global adapter package before a gateway can start them.
+ */
+export async function findMissingAcpAdapters(envPath = process.env.PATH ?? '') {
+    const missing = [];
+    for (const agent of KNOWN_ACP_AGENTS) {
+        if (!agent.adapter)
+            continue;
+        if (!(await findExecutable(agent.adapter.baseBinary, envPath)))
+            continue;
+        let adapterPresent = false;
+        for (const [binary] of agent.candidates) {
+            if (await findExecutable(binary, envPath)) {
+                adapterPresent = true;
+                break;
+            }
+        }
+        if (!adapterPresent) {
+            missing.push({ id: agent.id, name: agent.name, packageName: agent.adapter.packageName });
+        }
+    }
+    return missing;
+}

package/dist/utils/errorCodes.d.ts

@@ -11,6 +11,18 @@ export declare const ERROR_CODES: {
         readonly exitCode: 3;
         readonly description: "The configured credentials were rejected.";
     };
+    readonly AUTH_PAIRING_FAILED: {
+        readonly exitCode: 3;
+        readonly description: "Device QR login failed because the server rejected the pairing request.";
+    };
+    readonly AUTH_PAIRING_TIMEOUT: {
+        readonly exitCode: 3;
+        readonly description: "Device QR login timed out before the phone approved this computer.";
+    };
+    readonly AUTH_PAIRING_UNSUPPORTED: {
+        readonly exitCode: 3;
+        readonly description: "This server does not accept the CLI device type for QR login yet.";
+    };
     readonly AUTH_REQUIRED: {
         readonly exitCode: 3;
         readonly description: "The command needs an authenticated Dinox account.";

package/dist/utils/errorCodes.js

@@ -8,6 +8,9 @@
 export const ERROR_CODES = {
     ALREADY_EXISTS: { exitCode: 5, description: 'The target resource already exists.' },
     AUTH_INVALID: { exitCode: 3, description: 'The configured credentials were rejected.' },
+    AUTH_PAIRING_FAILED: { exitCode: 3, description: 'Device QR login failed because the server rejected the pairing request.' },
+    AUTH_PAIRING_TIMEOUT: { exitCode: 3, description: 'Device QR login timed out before the phone approved this computer.' },
+    AUTH_PAIRING_UNSUPPORTED: { exitCode: 3, description: 'This server does not accept the CLI device type for QR login yet.' },
     AUTH_REQUIRED: { exitCode: 3, description: 'The command needs an authenticated Dinox account.' },
     AUTH_STATE_CHANGED: { exitCode: 3, description: 'Authentication changed while the command was running.' },
     CACHE_CLEANUP_FAILED: { exitCode: 1, description: 'Local cache cleanup after logout did not complete.' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dinoxx/dinox-cli",
-  "version": "2.9.0",
+  "version": "2.11.0",
   "description": "Dinox CLI",
   "main": "dist/dinox.js",
   "scripts": {
@@ -78,6 +78,7 @@
     "@tiptap/markdown": "^3.20.0",
     "better-sqlite3": "^12.6.2",
     "commander": "^14.0.3",
+    "qrcode": "1.5.4",
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",
     "remark-stringify": "^11.0.0",
@@ -93,6 +94,7 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.19.0",
+    "@types/qrcode": "1.5.6",
     "eslint": "^10.12.0",
     "tsx": "^4.20.3",
     "typescript": "^5.9.3",