opencode-remote-control 0.2.3 → 0.2.5

package/README.md

@@ -15,22 +15,50 @@
   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
 ```
 
-## Quick Start
+## Configuration
 
-### Telegram Setup
+Run the config command to set up your preferred channel:
+
+```bash
+opencode-remote config
+```
 
-On first run, you'll be prompted for a Telegram bot token:
+Select **Telegram** or **Feishu** and follow the interactive guide.
+
+### Telegram Setup
 
 1. Open Telegram, search **@BotFather**
 2. Send `/newbot` and follow instructions
@@ -40,13 +68,17 @@ Token is saved to `~/.opencode-remote/.env`
 
 ### Feishu Setup
 
-Run the config command for Feishu:
+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 config-feishu
+opencode-remote
 ```
 
-Follow the interactive guide to configure your Feishu bot. For detailed setup instructions, see [Feishu Setup Guide](./docs/FEISHU_SETUP_EN.md) or [飞书配置指南](./docs/FEISHU_SETUP.md).
+That's it! You can now send messages to your Telegram bot or Feishu bot to control OpenCode remotely.
 
 ## Usage
 
@@ -56,7 +88,6 @@ opencode-remote start        # Start all configured bots
 opencode-remote telegram     # Start Telegram bot only
 opencode-remote feishu       # Start Feishu bot only
 opencode-remote config       # Configure a channel (interactive)
-opencode-remote config-feishu # Configure Feishu directly
 opencode-remote help         # Show help
 ```
 
@@ -137,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/cli.js

@@ -24,7 +24,6 @@ Commands:
   telegram           Start Telegram bot only
   feishu             Start Feishu bot only
   config             Configure a channel (interactive selection)
-  config-feishu      Configure Feishu bot directly
   help               Show this help message
 
 Examples:
@@ -33,7 +32,6 @@ Examples:
   opencode-remote telegram     # Start Telegram only
   opencode-remote feishu       # Start Feishu only
   opencode-remote config       # Interactive channel selection
-  opencode-remote config-feishu # Configure Feishu directly
 `);
 }
 async function promptChannel() {
@@ -329,17 +327,6 @@ async function runConfig() {
     }
     process.exit(0);
 }
-async function runConfigFeishu() {
-    printBanner();
-    const { appId, appSecret } = await promptFeishuConfig();
-    if (!appId || !appSecret) {
-        console.log('\n❌ Invalid credentials. Please try again.');
-        process.exit(1);
-    }
-    await saveFeishuConfig(appId, appSecret);
-    console.log('\n🚀 Ready! Run `opencode-remote` to start the bot.');
-    process.exit(0);
-}
 function hasTelegramConfig(config) {
     return !!(config.telegramBotToken?.trim());
 }
@@ -355,9 +342,7 @@ async function runStart() {
     const hasFeishu = hasFeishuConfig(config);
     if (!hasTelegram && !hasFeishu) {
         console.log('❌ No bots configured!');
-        console.log('\nRun one of:');
-        console.log('  opencode-remote config        # Configure Telegram');
-        console.log('  opencode-remote config-feishu # Configure Feishu');
+        console.log('\nRun: opencode-remote config');
         process.exit(1);
     }
     // Track shutdown state
@@ -425,7 +410,7 @@ async function runFeishuOnly() {
     const config = await getConfig();
     if (!hasFeishuConfig(config)) {
         console.log('❌ Feishu bot not configured!');
-        console.log('\nRun: opencode-remote config-feishu');
+        console.log('\nRun: opencode-remote config');
         process.exit(1);
     }
     printBanner();
@@ -454,9 +439,6 @@ switch (command) {
     case 'config':
         runConfig();
         break;
-    case 'config-feishu':
-        runConfigFeishu();
-        break;
     case 'help':
     case '--help':
     case '-h':

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.3",
+  "version": "0.2.5",
   "description": "Control OpenCode from anywhere via Telegram or Feishu",
   "type": "module",
   "bin": {