@pixelbyte-software/pixcode 1.33.2 → 1.33.4

package/server/opencode-cli.js

@@ -0,0 +1,403 @@
+/**
+ * OpenCode CLI adapter.
+ *
+ * OpenCode (https://opencode.ai, npm package: `opencode-ai`, binary: `opencode`)
+ * is a multi-provider terminal coding agent. Unlike Claude/Codex/Gemini/Qwen it
+ * uses XDG paths (`~/.config/opencode/` for config, `~/.local/share/opencode/`
+ * for data) on Linux/macOS/Windows alike — the literal `~/.config` and
+ * `~/.local/share` folders under the user profile, NOT %APPDATA% on Windows.
+ *
+ * Headless invocation:
+ *   opencode run \
+ *     --agent <build|plan>          # build (default) or plan (read-only) mode
+ *     --model <provider/model>       # e.g. anthropic/claude-sonnet-4-5
+ *     --format json                  # NDJSON event stream
+ *     [-s <id>]                      # resume a session by id
+ *     [--dangerously-skip-permissions]
+ *     -- "<prompt>"
+ *
+ * Mirrors the structure of qwen-code-cli.js so the dispatch path in
+ * server/index.js is uniform across all five spawn-based providers.
+ */
+import { spawn } from 'child_process';
+import crossSpawn from 'cross-spawn';
+import { promises as fs } from 'fs';
+import path from 'path';
+import os from 'os';
+
+import sessionManager from './sessionManager.js';
+import OpencodeResponseHandler from './opencode-response-handler.js';
+import { notifyRunFailed, notifyRunStopped } from './services/notification-orchestrator.js';
+import { buildSpawnEnv } from './services/provider-credentials.js';
+import { providerAuthService } from './modules/providers/services/provider-auth.service.js';
+import { createNormalizedMessage } from './shared/utils.js';
+
+// `opencode.cmd` shim on Windows — cross-spawn handles the .cmd resolution.
+const spawnFunction = process.platform === 'win32' ? crossSpawn : spawn;
+
+const activeOpencodeProcesses = new Map();
+
+function mapPermissionModeToArgs(permissionMode, skipPermissions) {
+    // OpenCode's permission model is per-tool/per-pattern (see opencode.json
+    // "permission" key). For chat-message routing we only need the high-level
+    // toggle: build (normal) vs plan (read-only) vs skip-everything.
+    if (skipPermissions || permissionMode === 'bypassPermissions' || permissionMode === 'acceptEdits') {
+        return { agent: 'build', dangerously: true };
+    }
+    if (permissionMode === 'plan') {
+        return { agent: 'plan', dangerously: false };
+    }
+    return { agent: 'build', dangerously: false };
+}
+
+async function spawnOpencode(command, options = {}, ws) {
+    const { sessionId, projectPath, cwd, toolsSettings, permissionMode, images, sessionSummary, agent: agentOverride } = options;
+    let capturedSessionId = sessionId;
+    let sessionCreatedSent = false;
+    let assistantBlocks = [];
+
+    const settings = toolsSettings || { allowedTools: [], disallowedTools: [], skipPermissions: false };
+
+    const safeSessionIdPattern = /^[a-zA-Z0-9_.\-:]+$/;
+    const args = ['run', '--format', 'json'];
+
+    const { agent, dangerously } = mapPermissionModeToArgs(permissionMode, settings.skipPermissions || options.skipPermissions);
+    const effectiveAgent = agentOverride || agent;
+    if (effectiveAgent) {
+        args.push('--agent', effectiveAgent);
+    }
+    if (dangerously) {
+        args.push('--dangerously-skip-permissions');
+    }
+
+    if (sessionId) {
+        const session = sessionManager.getSession(sessionId);
+        const cliId = session?.cliSessionId || sessionId;
+        if (cliId && safeSessionIdPattern.test(cliId)) {
+            args.push('-s', cliId);
+        }
+    }
+
+    const modelToUse = options.model;
+    if (modelToUse) {
+        args.push('--model', modelToUse);
+    }
+
+    const cleanPath = (cwd || projectPath || process.cwd()).replace(/[^\x20-\x7E]/g, '').trim();
+    const workingDir = cleanPath;
+
+    // Image attachments: OpenCode accepts repeated `-f <path>` flags. We dump
+    // base64 attachments to a tmp dir under the project root and pass each path.
+    const tempImagePaths = [];
+    let tempDir = null;
+    if (images && images.length > 0) {
+        try {
+            tempDir = path.join(workingDir, '.tmp', 'opencode-images', Date.now().toString());
+            await fs.mkdir(tempDir, { recursive: true });
+
+            for (const [index, image] of images.entries()) {
+                const matches = image.data.match(/^data:([^;]+);base64,(.+)$/);
+                if (!matches) continue;
+                const [, mimeType, base64Data] = matches;
+                const extension = mimeType.split('/')[1] || 'png';
+                const filename = `image_${index}.${extension}`;
+                const filepath = path.join(tempDir, filename);
+                await fs.writeFile(filepath, Buffer.from(base64Data, 'base64'));
+                tempImagePaths.push(filepath);
+                args.push('-f', filepath);
+            }
+        } catch (error) {
+            console.error('Error processing images for OpenCode:', error);
+        }
+    }
+
+    // Prompt is the trailing positional. Use `--` to be safe against prompts
+    // that start with a `-`.
+    if (command && command.trim()) {
+        args.push('--', command);
+    }
+
+    // OPENCODE_CLI_PATH is exported by primeCliBinPath() during boot. Falls
+    // back to the bare binary name (resolved via PATH) when unset.
+    const opencodePath = process.env.OPENCODE_CLI_PATH || 'opencode';
+    console.log('Spawning OpenCode CLI:', opencodePath, args.join(' '));
+    console.log('Working directory:', workingDir);
+
+    let spawnCmd = opencodePath;
+    let spawnArgs = args;
+
+    if (os.platform() !== 'win32') {
+        // Force `exec` so the child replaces the wrapper shell — keeps SIGTERM
+        // delivery clean when we abort the session. Same trick as qwen-cli.
+        spawnCmd = 'sh';
+        spawnArgs = ['-c', 'exec "$0" "$@"', opencodePath, ...args];
+    }
+
+    const spawnEnv = await buildSpawnEnv('opencode');
+
+    return new Promise((resolve, reject) => {
+        const opencodeProcess = spawnFunction(spawnCmd, spawnArgs, {
+            cwd: workingDir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: spawnEnv,
+        });
+
+        let terminalNotificationSent = false;
+        let terminalFailureReason = null;
+
+        const notifyTerminalState = ({ code = null, error = null } = {}) => {
+            if (terminalNotificationSent) return;
+            terminalNotificationSent = true;
+
+            const finalSessionId = capturedSessionId || sessionId || processKey;
+            if (code === 0 && !error) {
+                notifyRunStopped({
+                    userId: ws?.userId || null,
+                    provider: 'opencode',
+                    sessionId: finalSessionId,
+                    sessionName: sessionSummary,
+                    stopReason: 'completed',
+                });
+                return;
+            }
+
+            notifyRunFailed({
+                userId: ws?.userId || null,
+                provider: 'opencode',
+                sessionId: finalSessionId,
+                sessionName: sessionSummary,
+                error: error || terminalFailureReason || `OpenCode CLI exited with code ${code}`,
+            });
+        };
+
+        opencodeProcess.tempImagePaths = tempImagePaths;
+        opencodeProcess.tempDir = tempDir;
+
+        const processKey = capturedSessionId || sessionId || `opencode_${Date.now()}`;
+        activeOpencodeProcesses.set(processKey, opencodeProcess);
+        opencodeProcess.sessionId = processKey;
+
+        opencodeProcess.stdin.end();
+
+        const timeoutMs = 120000;
+        let timeout;
+        const startTimeout = () => {
+            if (timeout) clearTimeout(timeout);
+            timeout = setTimeout(() => {
+                const socketSessionId = typeof ws.getSessionId === 'function' ? ws.getSessionId() : (capturedSessionId || sessionId || processKey);
+                terminalFailureReason = `OpenCode CLI timeout - no response received for ${timeoutMs / 1000} seconds`;
+                ws.send(createNormalizedMessage({ kind: 'error', content: terminalFailureReason, sessionId: socketSessionId, provider: 'opencode' }));
+                try { opencodeProcess.kill('SIGTERM'); } catch { /* noop */ }
+            }, timeoutMs);
+        };
+        startTimeout();
+
+        if (command && capturedSessionId) {
+            sessionManager.addMessage(capturedSessionId, 'user', command);
+        }
+
+        let responseHandler;
+        if (ws) {
+            responseHandler = new OpencodeResponseHandler(ws, {
+                onContentFragment: (content) => {
+                    if (assistantBlocks.length > 0 && assistantBlocks[assistantBlocks.length - 1].type === 'text') {
+                        assistantBlocks[assistantBlocks.length - 1].text += content;
+                    } else {
+                        assistantBlocks.push({ type: 'text', text: content });
+                    }
+                },
+                onToolUse: (event) => {
+                    assistantBlocks.push({
+                        type: 'tool_use',
+                        id: event.tool_id,
+                        name: event.tool_name,
+                        input: event.parameters,
+                    });
+                },
+                onToolResult: (event) => {
+                    if (capturedSessionId) {
+                        if (assistantBlocks.length > 0) {
+                            sessionManager.addMessage(capturedSessionId, 'assistant', [...assistantBlocks]);
+                            assistantBlocks = [];
+                        }
+                        sessionManager.addMessage(capturedSessionId, 'user', [{
+                            type: 'tool_result',
+                            tool_use_id: event.tool_id,
+                            content: event.output === undefined ? null : event.output,
+                            is_error: event.status === 'error',
+                        }]);
+                    }
+                },
+                onInit: (event) => {
+                    if (capturedSessionId) {
+                        const sess = sessionManager.getSession(capturedSessionId);
+                        if (sess && !sess.cliSessionId) {
+                            sess.cliSessionId = event.session_id;
+                            sessionManager.saveSession(capturedSessionId);
+                        }
+                    }
+                },
+            });
+        }
+
+        opencodeProcess.stdout.on('data', (data) => {
+            const rawOutput = data.toString();
+            startTimeout();
+
+            if (!sessionId && !sessionCreatedSent && !capturedSessionId) {
+                capturedSessionId = `opencode_${Date.now()}`;
+                sessionCreatedSent = true;
+
+                sessionManager.createSession(capturedSessionId, cwd || process.cwd());
+                if (command) {
+                    sessionManager.addMessage(capturedSessionId, 'user', command);
+                }
+                if (processKey !== capturedSessionId) {
+                    activeOpencodeProcesses.delete(processKey);
+                    activeOpencodeProcesses.set(capturedSessionId, opencodeProcess);
+                }
+
+                ws.setSessionId && typeof ws.setSessionId === 'function' && ws.setSessionId(capturedSessionId);
+                ws.send(createNormalizedMessage({ kind: 'session_created', newSessionId: capturedSessionId, sessionId: capturedSessionId, provider: 'opencode' }));
+            }
+
+            if (responseHandler) {
+                responseHandler.processData(rawOutput);
+            } else if (rawOutput) {
+                if (assistantBlocks.length > 0 && assistantBlocks[assistantBlocks.length - 1].type === 'text') {
+                    assistantBlocks[assistantBlocks.length - 1].text += rawOutput;
+                } else {
+                    assistantBlocks.push({ type: 'text', text: rawOutput });
+                }
+                const socketSessionId = typeof ws.getSessionId === 'function' ? ws.getSessionId() : (capturedSessionId || sessionId);
+                ws.send(createNormalizedMessage({ kind: 'stream_delta', content: rawOutput, sessionId: socketSessionId, provider: 'opencode' }));
+            }
+        });
+
+        opencodeProcess.stderr.on('data', (data) => {
+            const errorMsg = data.toString();
+            // Suppress known cosmetic noise.
+            if (errorMsg.includes('[DEP0040]') ||
+                errorMsg.includes('DeprecationWarning') ||
+                errorMsg.includes('--trace-deprecation') ||
+                errorMsg.includes('punycode')) {
+                return;
+            }
+
+            const socketSessionId = typeof ws.getSessionId === 'function' ? ws.getSessionId() : (capturedSessionId || sessionId);
+            ws.send(createNormalizedMessage({ kind: 'error', content: errorMsg, sessionId: socketSessionId, provider: 'opencode' }));
+        });
+
+        opencodeProcess.on('close', async (code) => {
+            clearTimeout(timeout);
+
+            if (responseHandler) {
+                responseHandler.forceFlush();
+                responseHandler.destroy();
+            }
+
+            const finalSessionId = capturedSessionId || sessionId || processKey;
+            activeOpencodeProcesses.delete(finalSessionId);
+
+            if (finalSessionId && assistantBlocks.length > 0) {
+                sessionManager.addMessage(finalSessionId, 'assistant', assistantBlocks);
+            }
+
+            ws.send(createNormalizedMessage({ kind: 'complete', exitCode: code, isNewSession: !sessionId && !!command, sessionId: finalSessionId, provider: 'opencode' }));
+
+            if (opencodeProcess.tempImagePaths && opencodeProcess.tempImagePaths.length > 0) {
+                for (const imagePath of opencodeProcess.tempImagePaths) {
+                    await fs.unlink(imagePath).catch(() => { /* noop */ });
+                }
+                if (opencodeProcess.tempDir) {
+                    await fs.rm(opencodeProcess.tempDir, { recursive: true, force: true }).catch(() => { /* noop */ });
+                }
+            }
+
+            if (code === 0) {
+                notifyTerminalState({ code });
+                resolve();
+            } else {
+                if (code === 127) {
+                    const installed = await providerAuthService.isProviderInstalled('opencode');
+                    if (!installed) {
+                        const socketSessionId = typeof ws.getSessionId === 'function' ? ws.getSessionId() : finalSessionId;
+                        ws.send(createNormalizedMessage({
+                            kind: 'error',
+                            content: 'OpenCode CLI is not installed. Install it from the Settings → Agents → OpenCode tab, or run: npm install -g opencode-ai',
+                            sessionId: socketSessionId,
+                            provider: 'opencode',
+                        }));
+                    }
+                }
+
+                notifyTerminalState({
+                    code,
+                    error: code === null ? 'OpenCode CLI process was terminated or timed out' : null,
+                });
+                reject(new Error(code === null ? 'OpenCode CLI process was terminated or timed out' : `OpenCode CLI exited with code ${code}`));
+            }
+        });
+
+        opencodeProcess.on('error', async (error) => {
+            const finalSessionId = capturedSessionId || sessionId || processKey;
+            activeOpencodeProcesses.delete(finalSessionId);
+
+            const installed = await providerAuthService.isProviderInstalled('opencode');
+            const errorContent = !installed
+                ? 'OpenCode CLI is not installed. Install it from the Settings → Agents → OpenCode tab, or run: npm install -g opencode-ai'
+                : error.message;
+
+            const errorSessionId = typeof ws.getSessionId === 'function' ? ws.getSessionId() : finalSessionId;
+            ws.send(createNormalizedMessage({ kind: 'error', content: errorContent, sessionId: errorSessionId, provider: 'opencode' }));
+            notifyTerminalState({ error });
+
+            reject(error);
+        });
+    });
+}
+
+function abortOpencodeSession(sessionId) {
+    let opencodeProc = activeOpencodeProcesses.get(sessionId);
+    let processKey = sessionId;
+
+    if (!opencodeProc) {
+        for (const [key, proc] of activeOpencodeProcesses.entries()) {
+            if (proc.sessionId === sessionId) {
+                opencodeProc = proc;
+                processKey = key;
+                break;
+            }
+        }
+    }
+
+    if (opencodeProc) {
+        try {
+            opencodeProc.kill('SIGTERM');
+            setTimeout(() => {
+                if (activeOpencodeProcesses.has(processKey)) {
+                    try { opencodeProc.kill('SIGKILL'); } catch { /* noop */ }
+                }
+            }, 2000);
+            return true;
+        } catch {
+            return false;
+        }
+    }
+    return false;
+}
+
+function isOpencodeSessionActive(sessionId) {
+    return activeOpencodeProcesses.has(sessionId);
+}
+
+function getActiveOpencodeSessions() {
+    return Array.from(activeOpencodeProcesses.keys());
+}
+
+export {
+    spawnOpencode,
+    abortOpencodeSession,
+    isOpencodeSessionActive,
+    getActiveOpencodeSessions,
+};

package/server/opencode-response-handler.js

@@ -0,0 +1,92 @@
+// OpenCode Response Handler — `opencode run --format json` parser.
+//
+// The JSON format streams one event per line (NDJSON). Event shapes follow
+// the OpenAPI contract exposed by `opencode serve`. We treat the stream
+// permissively: lines that don't parse as JSON are passed through as plain
+// text deltas (covers OpenCode's pre-stream banner output and any debug
+// noise the CLI emits to stdout).
+import { sessionsService } from './modules/providers/services/sessions.service.js';
+
+class OpencodeResponseHandler {
+  constructor(ws, options = {}) {
+    this.ws = ws;
+    this.buffer = '';
+    this.onContentFragment = options.onContentFragment || null;
+    this.onInit = options.onInit || null;
+    this.onToolUse = options.onToolUse || null;
+    this.onToolResult = options.onToolResult || null;
+  }
+
+  processData(data) {
+    this.buffer += data;
+
+    const lines = this.buffer.split('\n');
+    this.buffer = lines.pop() || '';
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const event = JSON.parse(trimmed);
+        this.handleEvent(event);
+      } catch {
+        // Non-JSON line — surface as plain text delta so the user sees CLI
+        // banners / status messages instead of swallowing them silently.
+        if (this.onContentFragment) this.onContentFragment(trimmed + '\n');
+      }
+    }
+  }
+
+  handleEvent(event) {
+    const sid = typeof this.ws.getSessionId === 'function' ? this.ws.getSessionId() : null;
+
+    if (event.type === 'init' || event.type === 'session.start') {
+      if (this.onInit) this.onInit(event);
+      return;
+    }
+
+    // OpenCode emits both `message` events and `part` events that compose
+    // a single assistant turn. We handle whichever shape lands.
+    if (event.type === 'message' && event.role === 'assistant') {
+      const content = event.content || event.text || '';
+      if (this.onContentFragment && content) this.onContentFragment(content);
+    } else if (event.type === 'part' && event.part_type === 'text') {
+      const content = event.text || event.content || '';
+      if (this.onContentFragment && content) this.onContentFragment(content);
+    } else if (event.type === 'tool_use' || event.type === 'tool-use' || event.type === 'tool.start') {
+      if (this.onToolUse) this.onToolUse({
+        tool_id: event.tool_id || event.id,
+        tool_name: event.tool_name || event.name,
+        parameters: event.parameters || event.input || {},
+      });
+    } else if (event.type === 'tool_result' || event.type === 'tool-result' || event.type === 'tool.end') {
+      if (this.onToolResult) this.onToolResult({
+        tool_id: event.tool_id || event.id,
+        output: event.output ?? event.result ?? '',
+        status: event.status || (event.isError ? 'error' : 'ok'),
+      });
+    }
+
+    const normalized = sessionsService.normalizeMessage('opencode', event, sid);
+    for (const msg of normalized) {
+      this.ws.send(msg);
+    }
+  }
+
+  forceFlush() {
+    if (this.buffer.trim()) {
+      try {
+        const event = JSON.parse(this.buffer);
+        this.handleEvent(event);
+      } catch {
+        if (this.onContentFragment) this.onContentFragment(this.buffer);
+      }
+    }
+  }
+
+  destroy() {
+    this.buffer = '';
+  }
+}
+
+export default OpencodeResponseHandler;