@yu_robotics/remote-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 xiaoyu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @yu_robotics/remote-cli
+
+Remote control your [Claude Code](https://claude.ai/code) CLI from anywhere using your mobile phone through Feishu (Lark) messaging.
+
+## Features
+
+- **Remote Control**: Control your local development environment from anywhere via mobile
+- **Secure**: Directory whitelisting, command filtering, and device authentication
+- **Mobile-Optimized**: Simplified commands and rich text formatting for Feishu
+- **Claude Code Integration**: Full access to Claude Code's capabilities and context
+- **Persistent Process**: Long-running Claude process with bidirectional streaming (no repeated spawn overhead)
+
+## Prerequisites
+
+- **Node.js** >= 18.0.0
+- **Claude Code CLI** installed and configured
+- Access to a Feishu (Lark) bot connected to a [remote-cli-router](https://www.npmjs.com/package/@yu_robotics/remote-cli-router) server
+
+## Installation
+
+```bash
+npm install -g @yu_robotics/remote-cli
+```
+
+## Quick Start
+
+### 1. Initialize
+
+```bash
+remote-cli init --server https://your-router-server.com
+```
+
+### 2. Bind Device in Feishu
+
+Send the binding code to the Feishu bot:
+
+```
+/bind ABC-123-XYZ
+```
+
+### 3. Configure Allowed Directories
+
+```bash
+remote-cli config add-dir ~/projects ~/work
+```
+
+### 4. Start the Service
+
+```bash
+remote-cli start
+```
+
+### 5. Send Commands via Feishu
+
+```
+Help me fix TypeScript errors in ~/projects/my-app
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `remote-cli init -s <url>` | Initialize and generate binding code |
+| `remote-cli start` | Start the background service |
+| `remote-cli stop` | Stop the service |
+| `remote-cli status` | Check service status |
+| `remote-cli config show` | View configuration |
+| `remote-cli config add-dir <path>` | Add allowed directory |
+
+## Feishu Bot Commands
+
+| Command | Description |
+|---------|-------------|
+| `/cd <path>` | Change working directory |
+| `/status` | Check connection status |
+| `/c` or `/continue` | Continue previous conversation |
+| `/r` or `/resume` | Resume from last session |
+| `/clear` | Clear current session |
+| `/help` | Show help |
+
+## Security
+
+- **Directory whitelisting**: Only explicitly allowed directories are accessible
+- **Command filtering**: Dangerous commands are automatically blocked
+- **Device authentication**: Each device has a unique hardware-based ID
+- **Binding codes**: Expire after 5 minutes
+
+## Documentation
+
+For full documentation including router server deployment, see the [project README](https://github.com/xiaoyu/remote-cli#readme).
+
+## License
+
+MIT

package/bin/remote-cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');

package/dist/client/MessageHandler.d.ts

@@ -0,0 +1,92 @@
+import { WebSocketClient } from './WebSocketClient';
+import { DirectoryGuard } from '../security/DirectoryGuard';
+import { IncomingMessage } from '../types';
+import type { ClaudeExecutor, ClaudePersistentExecutor } from '../executor';
+/**
+ * Legacy message type for backward compatibility
+ */
+export interface Message {
+    type: string;
+    messageId?: string;
+    content?: string;
+    timestamp?: number;
+}
+/**
+ * Message Handler
+ * Responsible for handling messages from WebSocket and invoking Claude executor
+ */
+export declare class MessageHandler {
+    private wsClient;
+    private executor;
+    private directoryGuard;
+    private isDestroyed;
+    private isExecuting;
+    private currentOpenId?;
+    private notificationAdapter;
+    constructor(wsClient: WebSocketClient, executor: ClaudeExecutor | ClaudePersistentExecutor, directoryGuard: DirectoryGuard);
+    /**
+     * Handle message (supports new IncomingMessage format)
+     * @param message Message object
+     */
+    handleMessage(message: Message | IncomingMessage): Promise<void>;
+    /**
+     * Handle command message
+     */
+    private handleCommandMessage;
+    /**
+     * Handle abort command
+     * Can be executed even when executor is busy
+     */
+    private handleAbortCommand;
+    /**
+     * Handle status query
+     */
+    private handleStatusQuery;
+    /**
+     * Validate message structure
+     */
+    private isValidMessage;
+    /**
+     * Handle built-in commands
+     * @returns Returns true if built-in command was handled, otherwise false
+     */
+    private handleBuiltInCommand;
+    /**
+     * Expand command shortcuts
+     */
+    private expandCommandShortcuts;
+    /**
+     * Execute passthrough slash command using local Claude CLI
+     * This allows users to use their custom slash commands
+     */
+    private executeSlashCommand;
+    /**
+     * Execute Claude command
+     */
+    private executeCommand;
+    /**
+     * Send streaming output chunk
+     */
+    private sendStreamChunk;
+    /**
+     * Send tool use event
+     */
+    private sendToolUse;
+    /**
+     * Send tool result event
+     */
+    private sendToolResult;
+    /**
+     * Send structured content for rich formatting
+     */
+    private sendStructuredContent;
+    /**
+     * Send response
+     */
+    private sendResponse;
+    /**
+     * Destroy handler
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=MessageHandler.d.ts.map

package/dist/client/MessageHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageHandler.d.ts","sourceRoot":"","sources":["../../src/client/MessageHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAmE,MAAM,UAAU,CAAC;AAC5G,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAI5E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,mBAAmB,CAA4B;gBAGrD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,cAAc,GAAG,wBAAwB,EACnD,cAAc,EAAE,cAAc;IAWhC;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCtE;;OAEG;YACW,oBAAoB;IAmGlC;;;OAGG;YACW,kBAAkB;IAoBhC;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;;OAGG;YACW,oBAAoB;IAsFlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;;OAGG;YACW,mBAAmB;IAgEjC;;OAEG;YACW,cAAc;IA+B5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB"}