opencode-remote-control 0.2.4 → 0.2.5

package/README.md

@@ -15,15 +15,37 @@
   Control OpenCode from anywhere via Telegram or Feishu.
 </p>
 
+## Requirements
+
+- Node.js >= 18.0.0
+- [OpenCode](https://github.com/opencode-ai/opencode) installed and accessible in PATH
+- Telegram account (for Telegram bot)
+- Feishu account (for Feishu bot)
+- ngrok or cloudflared (for Feishu webhook)
+
+### Verify OpenCode Installation
+
+Before starting, make sure OpenCode is installed and accessible:
+
+```bash
+opencode --version
+```
+
+If you see `command not found`, install OpenCode first:
+
+```bash
+npm install -g @opencode-ai/opencode
+```
+
 ## Installation
 
 ```bash
 # Install globally with npm, pnpm, or bun
-npm install -g opencode-remote-control
+npm install -g opencode-remote-control@latest
 # or
-pnpm install -g opencode-remote-control
+pnpm install -g opencode-remote-control@latest
 # or
-bun install -g opencode-remote-control
+bun install -g opencode-remote-control@latest
 ```
 
 ## Configuration
@@ -48,6 +70,16 @@ Token is saved to `~/.opencode-remote/.env`
 
 For detailed Feishu setup instructions, see [Feishu Setup Guide](./docs/FEISHU_SETUP_EN.md) or [飞书配置指南](./docs/FEISHU_SETUP.md).
 
+## Start Service
+
+Once configured, start the bot service:
+
+```bash
+opencode-remote
+```
+
+That's it! You can now send messages to your Telegram bot or Feishu bot to control OpenCode remotely.
+
 ## Usage
 
 ```bash
@@ -136,14 +168,6 @@ The Telegram bot uses **Polling Mode** to fetch messages from Telegram servers,
 
 The Feishu bot uses **Webhook Mode** and requires a tunnel (ngrok/cloudflared) to receive messages.
 
-## Requirements
-
-- Node.js >= 18.0.0
-- [OpenCode](https://github.com/opencode-ai/opencode) installed
-- Telegram account (for Telegram bot)
-- Feishu account (for Feishu bot)
-- ngrok or cloudflared (for Feishu webhook)
-
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/opencode/client.js

@@ -1,15 +1,90 @@
 // OpenCode SDK client for remote control
+import { spawn } from 'node:child_process';
+import { platform } from 'node:os';
 import { createOpencode } from '@opencode-ai/sdk';
+// Windows compatibility: patch child_process.spawn to use shell for 'opencode' command
+// This is needed because Windows requires shell: true to execute .cmd files
+if (platform() === 'win32') {
+    const originalSpawn = spawn;
+    // @ts-ignore - monkey patching for Windows compatibility
+    require('node:child_process').spawn = function (command, args, options = {}) {
+        if (command === 'opencode' && !options.shell) {
+            options.shell = true;
+        }
+        return originalSpawn(command, args, options);
+    };
+}
+/**
+ * Verify that OpenCode is installed and accessible
+ * This helps catch issues early before the SDK tries to spawn the process
+ */
+export async function verifyOpenCodeInstalled() {
+    return new Promise((resolve) => {
+        const isWindows = platform() === 'win32';
+        const command = isWindows ? 'where' : 'which';
+        const proc = spawn(command, ['opencode'], { shell: isWindows });
+        let output = '';
+        let errorOutput = '';
+        proc.stdout?.on('data', (chunk) => {
+            output += chunk.toString();
+        });
+        proc.stderr?.on('data', (chunk) => {
+            errorOutput += chunk.toString();
+        });
+        proc.on('close', (code) => {
+            if (code === 0 && output.trim()) {
+                resolve({ ok: true });
+            }
+            else {
+                resolve({
+                    ok: false,
+                    error: `OpenCode not found in PATH. Please install it first:\n  npm install -g @opencode-ai/opencode\n\nThen verify with:\n  opencode --version`
+                });
+            }
+        });
+        proc.on('error', (err) => {
+            resolve({
+                ok: false,
+                error: `Failed to check OpenCode installation: ${err.message}\n\nPlease ensure OpenCode is installed:\n  npm install -g @opencode-ai/opencode`
+            });
+        });
+    });
+}
 let opencodeInstance = null;
+let verificationDone = false;
 export async function initOpenCode() {
     if (opencodeInstance) {
         return opencodeInstance;
     }
+    // Verify OpenCode is installed (only once)
+    if (!verificationDone) {
+        verificationDone = true;
+        console.log('🔧 Verifying OpenCode installation...');
+        const verification = await verifyOpenCodeInstalled();
+        if (!verification.ok) {
+            console.error('\n❌ ' + verification.error);
+            throw new Error('OpenCode not found. Please install it first: npm install -g @opencode-ai/opencode');
+        }
+        console.log('✅ OpenCode found');
+    }
     console.log('🚀 Starting OpenCode server...');
-    opencodeInstance = await createOpencode({
-        port: 0, // Don't start HTTP server
-    });
-    console.log('✅ OpenCode server ready');
+    try {
+        opencodeInstance = await createOpencode({
+            port: 0, // Don't start HTTP server
+        });
+        console.log('✅ OpenCode server ready');
+    }
+    catch (error) {
+        const isWindows = platform() === 'win32';
+        if (isWindows) {
+            console.error('\n❌ Failed to start OpenCode server.');
+            console.error('This may be a Windows compatibility issue.');
+            console.error('Please ensure OpenCode is installed correctly:');
+            console.error('  1. Run: npm install -g @opencode-ai/opencode');
+            console.error('  2. Verify: opencode --version');
+        }
+        throw error;
+    }
     return opencodeInstance;
 }
 export async function createSession(_threadId, title = `Remote control session`) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-remote-control",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Control OpenCode from anywhere via Telegram or Feishu",
   "type": "module",
   "bin": {