seahorse-bash-client 1.0.0

package/dist/websocket-client.js

@@ -0,0 +1,318 @@
+"use strict";
+/**
+ * WebSocket Client - Connects to Seahorse Agent and handles MCP tool calls
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+const events_1 = require("events");
+const os_1 = __importDefault(require("os"));
+const https_1 = __importDefault(require("https"));
+const http_1 = __importDefault(require("http"));
+const pty_manager_1 = require("./pty-manager");
+const tools_1 = require("./tools");
+class WebSocketClient extends events_1.EventEmitter {
+    constructor(config) {
+        super();
+        this.ws = null;
+        this.reconnectTimer = null;
+        this.heartbeatTimer = null;
+        this.isConnected = false;
+        this.isShuttingDown = false;
+        this.config = {
+            reconnectInterval: 5000,
+            heartbeatInterval: 30000,
+            maxOutputLines: 50000,
+            ...config,
+        };
+        this.ptyManager = new pty_manager_1.PTYManager({
+            maxOutputLines: this.config.maxOutputLines,
+            defaultShell: this.config.defaultShell,
+        });
+        // Forward session exit events
+        this.ptyManager.on('session:exited', (data) => {
+            this.sendNotification('session/exited', data);
+        });
+    }
+    /**
+     * Connect to the Seahorse Agent
+     */
+    async connect() {
+        if (this.isShuttingDown)
+            return;
+        return new Promise((resolve, reject) => {
+            try {
+                const url = new URL(this.config.serverUrl);
+                const isSecure = url.protocol === 'wss:';
+                // Create agent that forces HTTP/1.1 (no ALPN for HTTP/2)
+                const agent = isSecure
+                    ? new https_1.default.Agent({
+                        rejectUnauthorized: !this.config.insecure,
+                        // Force HTTP/1.1 by not advertising HTTP/2
+                        ALPNProtocols: ['http/1.1'],
+                    })
+                    : new http_1.default.Agent();
+                const wsOptions = {
+                    agent,
+                    perMessageDeflate: false,
+                };
+                this.ws = new ws_1.default(this.config.serverUrl, wsOptions);
+                this.ws.on('open', () => {
+                    this.isConnected = true;
+                    this.emit('connected');
+                    this.register();
+                    this.startHeartbeat();
+                    resolve();
+                });
+                this.ws.on('message', (data) => {
+                    this.handleMessage(data);
+                });
+                this.ws.on('close', (code, reason) => {
+                    this.isConnected = false;
+                    this.stopHeartbeat();
+                    this.emit('disconnected', { code, reason: reason.toString() });
+                    if (!this.isShuttingDown) {
+                        this.scheduleReconnect();
+                    }
+                });
+                this.ws.on('error', (error) => {
+                    this.emit('error', error);
+                    if (!this.isConnected) {
+                        reject(error);
+                    }
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Disconnect from the server
+     */
+    async disconnect() {
+        this.isShuttingDown = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.stopHeartbeat();
+        // Shutdown all PTY sessions
+        await this.ptyManager.shutdown();
+        if (this.ws) {
+            this.ws.close(1000, 'Client shutdown');
+            this.ws = null;
+        }
+    }
+    /**
+     * Register tools with the agent
+     */
+    register() {
+        // Note: Server expects "registration" type, not "register"
+        const message = {
+            type: 'registration',
+            tools: tools_1.TOOL_DEFINITIONS,
+            metadata: {
+                version: '1.0.0',
+                hostname: os_1.default.hostname(),
+                platform: process.platform,
+                shell: this.config.defaultShell || process.env.SHELL || '/bin/bash',
+            },
+        };
+        this.send(message);
+    }
+    /**
+     * Handle incoming WebSocket messages
+     */
+    handleMessage(data) {
+        try {
+            const message = JSON.parse(data.toString());
+            switch (message.type) {
+                case 'tool_call':
+                    this.handleToolCall(message);
+                    break;
+                case 'heartbeat':
+                case 'heartbeat_ack':
+                    // Respond to heartbeat, ignore ack
+                    if (message.type === 'heartbeat') {
+                        this.send({ type: 'heartbeat' });
+                    }
+                    break;
+                case 'registration_ack':
+                    // Server acknowledged registration
+                    const ackData = message;
+                    this.emit('registered', {
+                        serverName: ackData.server_name,
+                        tools: tools_1.TOOL_DEFINITIONS,
+                        registeredCount: ackData.registered_tools,
+                    });
+                    break;
+                case 'error':
+                    const errorData = message;
+                    this.emit('error', new Error(`Server error: ${errorData.error}`));
+                    break;
+                default:
+                    this.emit('message', message);
+            }
+        }
+        catch (error) {
+            this.emit('error', new Error(`Failed to parse message: ${error}`));
+        }
+    }
+    /**
+     * Handle a tool call from the agent
+     */
+    async handleToolCall(message) {
+        const { request_id, params } = message;
+        const { name, arguments: args } = params;
+        this.emit('tool:call', { name, args, requestId: request_id });
+        try {
+            const result = await this.executeTool(name, args);
+            this.sendToolResponse(request_id, result, false);
+            this.emit('tool:success', { name, requestId: request_id });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.sendToolResponse(request_id, { error: errorMessage }, true, errorMessage);
+            this.emit('tool:error', { name, requestId: request_id, error: errorMessage });
+        }
+    }
+    /**
+     * Execute a tool
+     */
+    async executeTool(name, args) {
+        // Validate allowed commands if configured
+        if (this.config.allowedCommands && name.startsWith('bash_')) {
+            const command = args.command || '';
+            const isAllowed = this.config.allowedCommands.some((allowed) => command.startsWith(allowed) || command === allowed);
+            if (!isAllowed) {
+                throw new Error(`Command not in allowed list: ${command}`);
+            }
+        }
+        // Validate blocked commands if configured
+        if (this.config.blockedCommands && name.startsWith('bash_')) {
+            const command = args.command || '';
+            const isBlocked = this.config.blockedCommands.some((blocked) => command.includes(blocked) || command.startsWith(blocked));
+            if (isBlocked) {
+                throw new Error(`Command is blocked: ${command}`);
+            }
+        }
+        // Validate cwd if restrictions are configured
+        if (this.config.allowedCwdPaths && args.cwd) {
+            const cwd = args.cwd;
+            const isAllowed = this.config.allowedCwdPaths.some((allowed) => cwd.startsWith(allowed));
+            if (!isAllowed) {
+                throw new Error(`Working directory not allowed: ${cwd}`);
+            }
+        }
+        switch (name) {
+            case 'bash_spawn':
+                return this.ptyManager.spawn(args);
+            case 'bash_exec':
+                return this.ptyManager.exec(args);
+            case 'bash_write':
+                return this.ptyManager.write(args);
+            case 'bash_read':
+                return this.ptyManager.read(args);
+            case 'bash_list':
+                return this.ptyManager.list(args);
+            case 'bash_kill':
+                return this.ptyManager.kill(args);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    /**
+     * Send a tool response
+     */
+    sendToolResponse(requestId, result, isError, errorMessage) {
+        const response = {
+            type: 'tool_response',
+            request_id: requestId,
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+            isError,
+            ...(errorMessage && { error: errorMessage }),
+        };
+        this.send(response);
+    }
+    /**
+     * Send a notification to the agent
+     */
+    sendNotification(method, params) {
+        if (!this.isConnected)
+            return;
+        const notification = {
+            type: 'notification',
+            method,
+            params,
+        };
+        this.send(notification);
+        this.emit('notification:sent', { method, params });
+    }
+    /**
+     * Send a message through the WebSocket
+     */
+    send(message) {
+        if (this.ws && this.ws.readyState === ws_1.default.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    /**
+     * Schedule a reconnection attempt
+     */
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        this.emit('reconnecting', { interval: this.config.reconnectInterval });
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = null;
+            try {
+                await this.connect();
+            }
+            catch (error) {
+                // Will retry via close handler
+            }
+        }, this.config.reconnectInterval);
+    }
+    /**
+     * Start heartbeat timer
+     */
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(() => {
+            if (this.isConnected) {
+                this.send({ type: 'heartbeat' });
+            }
+        }, this.config.heartbeatInterval);
+    }
+    /**
+     * Stop heartbeat timer
+     */
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    /**
+     * Get connection status
+     */
+    get connected() {
+        return this.isConnected;
+    }
+    /**
+     * Get PTY manager for direct access
+     */
+    get pty() {
+        return this.ptyManager;
+    }
+}
+exports.WebSocketClient = WebSocketClient;
+//# sourceMappingURL=websocket-client.js.map

package/dist/websocket-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client.js","sourceRoot":"","sources":["../src/websocket-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "seahorse-bash-client",
+  "version": "1.0.0",
+  "description": "Reverse MCP client for providing bash/PTY tools to Seahorse Agent",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "seahorse-bash": "./bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "cd node_modules/node-pty && npm run install",
+    "build": "tsc",
+    "watch": "tsc -w",
+    "start": "node dist/cli.js",
+    "dev": "ts-node src/cli.ts",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "seahorse",
+    "mcp",
+    "bash",
+    "pty",
+    "shell",
+    "reverse-connection",
+    "agent"
+  ],
+  "author": "Seahorse Team",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "node-pty": "^1.0.0",
+    "ora": "^5.4.1",
+    "uuid": "^9.0.0",
+    "ws": "^8.14.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.30",
+    "@types/uuid": "^9.0.0",
+    "@types/ws": "^8.5.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dn-inc/seahorse-mcp-agent-server.git"
+  },
+  "homepage": "https://github.com/dn-inc/seahorse-mcp-agent-server#readme"
+}

package/src/cli.ts

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+/**
+ * Seahorse Bash Client CLI
+ *
+ * Connects to Seahorse Agent and provides PTY-based bash tools.
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import os from 'os';
+import { WebSocketClient } from './websocket-client';
+import { ClientConfig } from './types';
+
+const VERSION = '1.0.0';
+
+const program = new Command();
+
+program
+  .name('seahorse-bash')
+  .description('Seahorse Bash Client - PTY-based bash tools for Seahorse Agent')
+  .version(VERSION);
+
+program
+  .command('connect')
+  .description('Connect to Seahorse Agent and provide bash tools')
+  .requiredOption('-u, --url <url>', 'Seahorse Agent WebSocket URL (e.g., wss://agent.example.com/ws/remote-mcp)')
+  .option('-n, --name <name>', 'Server name for identification', `bash-${os.hostname()}`)
+  .option('-s, --shell <shell>', 'Default shell to use', process.env.SHELL || '/bin/bash')
+  .option('--reconnect-interval <ms>', 'Reconnect interval in milliseconds', '5000')
+  .option('--heartbeat-interval <ms>', 'Heartbeat interval in milliseconds', '30000')
+  .option('--max-output-lines <lines>', 'Maximum output lines to buffer per session', '50000')
+  .option('--allowed-commands <cmds>', 'Comma-separated list of allowed command prefixes')
+  .option('--blocked-commands <cmds>', 'Comma-separated list of blocked command patterns')
+  .option('--allowed-cwd <paths>', 'Comma-separated list of allowed working directory paths')
+  .option('-k, --insecure', 'Skip SSL certificate verification (for self-signed certs)')
+  .action(async (options) => {
+    const spinner = ora('Connecting to Seahorse Agent...').start();
+
+    const config: ClientConfig = {
+      serverUrl: options.url,
+      serverName: options.name,
+      defaultShell: options.shell,
+      reconnectInterval: parseInt(options.reconnectInterval, 10),
+      heartbeatInterval: parseInt(options.heartbeatInterval, 10),
+      maxOutputLines: parseInt(options.maxOutputLines, 10),
+      allowedCommands: options.allowedCommands?.split(',').map((s: string) => s.trim()),
+      blockedCommands: options.blockedCommands?.split(',').map((s: string) => s.trim()),
+      allowedCwdPaths: options.allowedCwd?.split(',').map((s: string) => s.trim()),
+      insecure: options.insecure || false,
+    };
+
+    const client = new WebSocketClient(config);
+
+    // Event handlers
+    client.on('connected', () => {
+      spinner.succeed(chalk.green('Connected to Seahorse Agent'));
+      console.log(chalk.gray(`  Server name: ${config.serverName}`));
+      console.log(chalk.gray(`  Shell: ${config.defaultShell}`));
+      console.log(chalk.gray(`  Platform: ${process.platform}`));
+      console.log();
+      console.log(chalk.cyan('Listening for tool calls...'));
+      console.log(chalk.gray('Press Ctrl+C to disconnect'));
+      console.log();
+    });
+
+    client.on('registered', ({ tools }) => {
+      console.log(chalk.green(`Registered ${tools.length} tools:`));
+      tools.forEach((tool: { name: string }) => {
+        console.log(chalk.gray(`  - ${tool.name}`));
+      });
+      console.log();
+    });
+
+    client.on('disconnected', ({ code, reason }) => {
+      console.log(chalk.yellow(`Disconnected (code: ${code}, reason: ${reason})`));
+    });
+
+    client.on('reconnecting', ({ interval }) => {
+      console.log(chalk.yellow(`Reconnecting in ${interval}ms...`));
+    });
+
+    client.on('error', (error) => {
+      console.error(chalk.red(`Error: ${error.message}`));
+    });
+
+    client.on('tool:call', ({ name, requestId }) => {
+      console.log(chalk.blue(`[${new Date().toISOString()}] Tool call: ${name} (${requestId})`));
+    });
+
+    client.on('tool:success', ({ name, requestId }) => {
+      console.log(chalk.green(`[${new Date().toISOString()}] Tool success: ${name} (${requestId})`));
+    });
+
+    client.on('tool:error', ({ name, requestId, error }) => {
+      console.log(chalk.red(`[${new Date().toISOString()}] Tool error: ${name} (${requestId}): ${error}`));
+    });
+
+    client.on('notification:sent', ({ method }) => {
+      console.log(chalk.magenta(`[${new Date().toISOString()}] Notification: ${method}`));
+    });
+
+    // Graceful shutdown
+    const shutdown = async () => {
+      console.log();
+      console.log(chalk.yellow('Shutting down...'));
+      await client.disconnect();
+      console.log(chalk.green('Disconnected. Goodbye!'));
+      process.exit(0);
+    };
+
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+
+    // Connect
+    try {
+      await client.connect();
+    } catch (error) {
+      spinner.fail(chalk.red(`Failed to connect: ${error instanceof Error ? error.message : error}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('test')
+  .description('Test PTY functionality locally (without connecting to agent)')
+  .option('-c, --command <cmd>', 'Command to execute', 'echo "Hello from PTY!"')
+  .option('-s, --shell <shell>', 'Shell to use', process.env.SHELL || '/bin/bash')
+  .action(async (options) => {
+    const { PTYManager } = await import('./pty-manager');
+    const ptyManager = new PTYManager({ defaultShell: options.shell });
+
+    console.log(chalk.cyan('Testing PTY Manager...'));
+    console.log();
+
+    // Test bash_exec
+    console.log(chalk.yellow('1. Testing bash_exec:'));
+    const execResult = await ptyManager.exec({ command: options.command });
+    console.log(chalk.gray(`   Exit code: ${execResult.exitCode}`));
+    console.log(chalk.gray(`   Duration: ${execResult.duration}ms`));
+    console.log(chalk.gray(`   Output: ${execResult.stdout}`));
+    console.log();
+
+    // Test bash_spawn
+    console.log(chalk.yellow('2. Testing bash_spawn:'));
+    const spawnResult = await ptyManager.spawn({
+      command: 'for i in 1 2 3; do echo "Count: $i"; sleep 0.5; done',
+      name: 'test-session',
+    });
+    console.log(chalk.gray(`   Session ID: ${spawnResult.sessionId}`));
+    console.log(chalk.gray(`   PID: ${spawnResult.pid}`));
+
+    // Wait for output
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+
+    // Test bash_read
+    console.log();
+    console.log(chalk.yellow('3. Testing bash_read:'));
+    const readResult = ptyManager.read({ sessionId: spawnResult.sessionId, tail: true, limit: 10 });
+    console.log(chalk.gray(`   Total lines: ${readResult.totalLines}`));
+    readResult.lines.forEach((line) => {
+      console.log(chalk.gray(`   [${line.line}] ${line.text}`));
+    });
+
+    // Test bash_list
+    console.log();
+    console.log(chalk.yellow('4. Testing bash_list:'));
+    const listResult = ptyManager.list({});
+    console.log(chalk.gray(`   Total sessions: ${listResult.summary.total}`));
+    console.log(chalk.gray(`   Running: ${listResult.summary.running}`));
+    console.log(chalk.gray(`   Exited: ${listResult.summary.exited}`));
+
+    // Cleanup
+    await ptyManager.shutdown();
+    console.log();
+    console.log(chalk.green('All tests passed!'));
+  });
+
+program.parse();

package/src/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Seahorse Bash Client
+ *
+ * Reverse MCP client that provides PTY-based bash tools to Seahorse Agent.
+ */
+
+export { WebSocketClient } from './websocket-client';
+export { PTYManager, ptyManager } from './pty-manager';
+export { TOOL_DEFINITIONS } from './tools';
+export * from './types';