@ebowwa/terminal 0.3.7 → 0.3.9

package/dist/lib/activities.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Activity tracking for terminal operations
+ */
+export interface Activity {
+    type: string;
+    message: string;
+    nodeId?: string;
+    sessionName?: string;
+    timestamp?: Date;
+}
+export declare function addActivity(activity: Activity): void;

package/dist/lib/hetzner/client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hetzner client stub for type checking
+ */
+export interface HetznerClient {
+}
+export declare function createHetznerClient(): HetznerClient;

package/dist/lib/hetzner/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Hetzner types stub for type checking
+ */
+export interface HetznerServer {
+    id: number;
+    name: string;
+    status: string;
+}
+export interface HetznerSSHKey {
+    id: number;
+    name: string;
+    fingerprint: string;
+}

package/dist/manager.d.ts

@@ -14,7 +14,27 @@
  * ENVIRONMENT VARIABLES:
  * - HETZNER_SSH_KEYS_DIR: Override default SSH keys directory
  */
-import type { HetznerClient } from "../lib/hetzner/client";
+interface HetznerSSHKeysAPI {
+    getAll(): Promise<{
+        ssh_keys: HetznerSSHKey[];
+    }>;
+    list(): Promise<{
+        ssh_keys: HetznerSSHKey[];
+    }>;
+    create(params: {
+        name: string;
+        public_key: string;
+    }): Promise<HetznerSSHKey>;
+    findByName(name: string): Promise<HetznerSSHKey | undefined>;
+}
+interface HetznerClient {
+    ssh_keys: HetznerSSHKeysAPI;
+}
+interface HetznerSSHKey {
+    id: number;
+    name: string;
+    fingerprint: string;
+}
 declare module "bun" {
     interface Env {
         HETZNER_SSH_KEYS_DIR?: string;
@@ -100,3 +120,4 @@ export declare class SSHKeyManager {
  * @returns SSH key information
  */
 export declare function ensureSSHKey(hetznerClient: HetznerClient, config?: SSHKeyManagerConfig): Promise<SSHKeyInfo>;
+export {};

package/dist/mcp/index.js

@@ -16,7 +16,6 @@ var __toESM = (mod, isNodeMode, target) => {
       });
   return to;
 };
-var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -446,34 +445,33 @@ var init_error = __esm(() => {
 });
 
 // node_modules/@ebowwa/codespaces-types/runtime/ssh.js
-var require_ssh = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.FilePreviewOptionsSchema = exports.FilesListOptionsSchema = exports.SCPOptionsSchema = exports.SSHCommandSchema = exports.SSHOptionsSchema = undefined;
-  var zod_1 = __require("zod");
-  exports.SSHOptionsSchema = zod_1.z.object({
-    host: zod_1.z.string().min(1, "Host is required"),
-    user: zod_1.z.string().default("root"),
-    timeout: zod_1.z.number().int().positive().default(5),
-    port: zod_1.z.number().int().positive().max(65535).default(22),
-    keyPath: zod_1.z.string().optional(),
-    password: zod_1.z.string().optional()
+import { z } from "zod";
+var SSHOptionsSchema, SSHCommandSchema, SCPOptionsSchema, FilesListOptionsSchema, FilePreviewOptionsSchema;
+var init_ssh = __esm(() => {
+  SSHOptionsSchema = z.object({
+    host: z.string().min(1, "Host is required"),
+    user: z.string().default("root"),
+    timeout: z.number().int().positive().default(5),
+    port: z.number().int().positive().max(65535).default(22),
+    keyPath: z.string().optional(),
+    password: z.string().optional()
   });
-  exports.SSHCommandSchema = zod_1.z.string().min(1, "Command cannot be empty");
-  exports.SCPOptionsSchema = exports.SSHOptionsSchema.extend({
-    source: zod_1.z.string().min(1, "Source is required"),
-    destination: zod_1.z.string().min(1, "Destination is required"),
-    recursive: zod_1.z.boolean().default(false),
-    preserve: zod_1.z.boolean().default(false)
+  SSHCommandSchema = z.string().min(1, "Command cannot be empty");
+  SCPOptionsSchema = SSHOptionsSchema.extend({
+    source: z.string().min(1, "Source is required"),
+    destination: z.string().min(1, "Destination is required"),
+    recursive: z.boolean().default(false),
+    preserve: z.boolean().default(false)
   });
-  exports.FilesListOptionsSchema = zod_1.z.object({
-    host: zod_1.z.string().min(1, "Host is required"),
-    user: zod_1.z.string().default("root"),
-    path: zod_1.z.string().default(".")
+  FilesListOptionsSchema = z.object({
+    host: z.string().min(1, "Host is required"),
+    user: z.string().default("root"),
+    path: z.string().default(".")
   });
-  exports.FilePreviewOptionsSchema = zod_1.z.object({
-    host: zod_1.z.string().min(1, "Host is required"),
-    user: zod_1.z.string().default("root"),
-    path: zod_1.z.string().min(1, "Path is required")
+  FilePreviewOptionsSchema = z.object({
+    host: z.string().min(1, "Host is required"),
+    user: z.string().default("root"),
+    path: z.string().min(1, "Path is required")
   });
 });
 
@@ -483,11 +481,11 @@ __export(exports_client, {
   execSSH: () => execSSH
 });
 async function execSSH(command, options) {
-  const validatedCommand = import_ssh.SSHCommandSchema.safeParse(command);
+  const validatedCommand = SSHCommandSchema.safeParse(command);
   if (!validatedCommand.success) {
     throw new Error(`Invalid SSH command: ${validatedCommand.error.issues.map((i) => i.message).join(", ")}`);
   }
-  const validatedOptions = import_ssh.SSHOptionsSchema.safeParse(options);
+  const validatedOptions = SSHOptionsSchema.safeParse(options);
   if (!validatedOptions.success) {
     throw new Error(`Invalid SSH options: ${validatedOptions.error.issues.map((i) => i.message).join(", ")}`);
   }
@@ -507,120 +505,10 @@ async function execSSH(command, options) {
     throw new SSHError(`SSH command failed: ${validatedCommand.data}`, error);
   }
 }
-var import_ssh;
 var init_client = __esm(() => {
   init_error();
+  init_ssh();
   init_pool();
-  import_ssh = __toESM(require_ssh(), 1);
-});
-
-// node_modules/@ebowwa/codespaces-types/compile/terminal-websocket.js
-var require_terminal_websocket = __commonJS((exports) => {
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.WebSocketCloseCode = undefined;
-  exports.WebSocketCloseCode = {
-    NORMAL_CLOSURE: 1000,
-    ENDPOINT_GOING_AWAY: 1001,
-    PROTOCOL_ERROR: 1002,
-    UNSUPPORTED_DATA: 1003,
-    NO_STATUS_RECEIVED: 1005,
-    ABNORMAL_CLOSURE: 1006,
-    INVALID_FRAME_PAYLOAD_DATA: 1007,
-    POLICY_VIOLATION: 1008,
-    MESSAGE_TOO_BIG: 1009,
-    MISSING_MANDATORY_EXTENSION: 1010,
-    INTERNAL_ERROR: 1011,
-    SERVICE_RESTART: 1012,
-    TRY_AGAIN_LATER: 1013,
-    SESSION_NOT_FOUND: 4001,
-    SESSION_ALREADY_CLOSED: 4002,
-    INVALID_MESSAGE_FORMAT: 4003,
-    AUTHENTICATION_FAILED: 4004,
-    CONNECTION_TIMEOUT: 4005,
-    SESSION_LIMIT_REACHED: 4006,
-    INVALID_HOST: 4007,
-    SSH_CONNECTION_FAILED: 4008,
-    NETWORK_BLOCKED: 4009
-  };
-});
-
-// node_modules/@ebowwa/codespaces-types/compile/index.js
-var require_compile = __commonJS((exports) => {
-  var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m, k, k2) {
-    if (k2 === undefined)
-      k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() {
-        return m[k];
-      } };
-    }
-    Object.defineProperty(o, k2, desc);
-  } : function(o, m, k, k2) {
-    if (k2 === undefined)
-      k2 = k;
-    o[k2] = m[k];
-  });
-  var __exportStar = exports && exports.__exportStar || function(m, exports2) {
-    for (var p in m)
-      if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports2, p))
-        __createBinding(exports2, m, p);
-  };
-  Object.defineProperty(exports, "__esModule", { value: true });
-  exports.LoopStatus = exports.VolumeStatus = exports.ActionStatus = exports.EnvironmentStatus = undefined;
-  exports.getEnvLocation = getEnvLocation;
-  exports.getEnvRegionName = getEnvRegionName;
-  exports.getEnvLocationLabel = getEnvLocationLabel;
-  __exportStar(require_terminal_websocket(), exports);
-  var EnvironmentStatus;
-  (function(EnvironmentStatus2) {
-    EnvironmentStatus2["Running"] = "running";
-    EnvironmentStatus2["Stopped"] = "stopped";
-    EnvironmentStatus2["Creating"] = "creating";
-    EnvironmentStatus2["Deleting"] = "deleting";
-    EnvironmentStatus2["Starting"] = "starting";
-    EnvironmentStatus2["Stopping"] = "stopping";
-    EnvironmentStatus2["Initializing"] = "initializing";
-  })(EnvironmentStatus || (exports.EnvironmentStatus = EnvironmentStatus = {}));
-  var ActionStatus;
-  (function(ActionStatus2) {
-    ActionStatus2["Running"] = "running";
-    ActionStatus2["Success"] = "success";
-    ActionStatus2["Error"] = "error";
-  })(ActionStatus || (exports.ActionStatus = ActionStatus = {}));
-  var VolumeStatus;
-  (function(VolumeStatus2) {
-    VolumeStatus2["Creating"] = "creating";
-    VolumeStatus2["Available"] = "available";
-    VolumeStatus2["Deleting"] = "deleting";
-  })(VolumeStatus || (exports.VolumeStatus = VolumeStatus = {}));
-  var LoopStatus;
-  (function(LoopStatus2) {
-    LoopStatus2["Running"] = "running";
-    LoopStatus2["Stopped"] = "stopped";
-    LoopStatus2["Error"] = "error";
-    LoopStatus2["Completed"] = "completed";
-  })(LoopStatus || (exports.LoopStatus = LoopStatus = {}));
-  function getEnvLocation(env) {
-    if (!env)
-      return null;
-    return env.location || null;
-  }
-  function getEnvRegionName(env) {
-    var _a;
-    if (!env)
-      return "Unknown";
-    return ((_a = env.location) === null || _a === undefined ? undefined : _a.name) || "Unknown";
-  }
-  function getEnvLocationLabel(env) {
-    var _a, _b, _c;
-    if (!env)
-      return "Unknown";
-    if (((_a = env.location) === null || _a === undefined ? undefined : _a.city) && ((_b = env.location) === null || _b === undefined ? undefined : _b.country)) {
-      return "".concat(env.location.city, ", ").concat(env.location.country);
-    }
-    return ((_c = env.location) === null || _c === undefined ? undefined : _c.name) || "Unknown";
-  }
 });
 
 // src/tmux.ts
@@ -1265,7 +1153,7 @@ class TmuxSessionManager {
       return { success: false, error: `Node ${nodeId} is not running` };
     }
     try {
-      const result = await createOrAttachTmuxSession(node.ip, node.user, node.keyPath, { sessionName });
+      const result = await createOrAttachTmuxSession(node.ip, node.user, node.keyPath, {});
       return {
         success: true,
         sshArgs: result.sshArgs,
@@ -1697,10 +1585,10 @@ async function testSSHConnection(options) {
 init_pool();
 // src/scp.ts
 init_error();
+init_ssh();
 init_pool();
-var import_ssh2 = __toESM(require_ssh(), 1);
 async function scpUpload(options) {
-  const validated = import_ssh2.SCPOptionsSchema.safeParse(options);
+  const validated = SCPOptionsSchema.safeParse(options);
   if (!validated.success) {
     throw new Error(`Invalid SCP options: ${validated.error.issues.map((i) => i.message).join(", ")}`);
   }
@@ -1727,7 +1615,7 @@ async function scpUpload(options) {
   }
 }
 async function scpDownload(options) {
-  const validated = import_ssh2.SCPOptionsSchema.safeParse(options);
+  const validated = SCPOptionsSchema.safeParse(options);
   if (!validated.success) {
     throw new Error(`Invalid SCP options: ${validated.error.issues.map((i) => i.message).join(", ")}`);
   }
@@ -1983,13 +1871,70 @@ import { promisify } from "util";
 var execAsync = promisify(__require("child_process").exec);
 // src/pty.ts
 var activeSessions = new Map;
+var activeReplSessions = new Map;
 
 // src/index.ts
 init_pool();
 
 // src/sessions.ts
 import path2 from "path";
-var import_compile = __toESM(require_compile(), 1);
+
+// node_modules/@ebowwa/codespaces-types/compile/index.js
+var WebSocketCloseCode = {
+  NORMAL_CLOSURE: 1000,
+  ENDPOINT_GOING_AWAY: 1001,
+  PROTOCOL_ERROR: 1002,
+  UNSUPPORTED_DATA: 1003,
+  NO_STATUS_RECEIVED: 1005,
+  ABNORMAL_CLOSURE: 1006,
+  INVALID_FRAME_PAYLOAD_DATA: 1007,
+  POLICY_VIOLATION: 1008,
+  MESSAGE_TOO_BIG: 1009,
+  MISSING_MANDATORY_EXTENSION: 1010,
+  INTERNAL_ERROR: 1011,
+  SERVICE_RESTART: 1012,
+  TRY_AGAIN_LATER: 1013,
+  SESSION_NOT_FOUND: 4001,
+  SESSION_ALREADY_CLOSED: 4002,
+  INVALID_MESSAGE_FORMAT: 4003,
+  AUTHENTICATION_FAILED: 4004,
+  CONNECTION_TIMEOUT: 4005,
+  SESSION_LIMIT_REACHED: 4006,
+  INVALID_HOST: 4007,
+  SSH_CONNECTION_FAILED: 4008,
+  NETWORK_BLOCKED: 4009
+};
+var EnvironmentStatus;
+((EnvironmentStatus2) => {
+  EnvironmentStatus2["Running"] = "running";
+  EnvironmentStatus2["Stopped"] = "stopped";
+  EnvironmentStatus2["Creating"] = "creating";
+  EnvironmentStatus2["Deleting"] = "deleting";
+  EnvironmentStatus2["Starting"] = "starting";
+  EnvironmentStatus2["Stopping"] = "stopping";
+  EnvironmentStatus2["Initializing"] = "initializing";
+})(EnvironmentStatus ||= {});
+var ActionStatus;
+((ActionStatus2) => {
+  ActionStatus2["Running"] = "running";
+  ActionStatus2["Success"] = "success";
+  ActionStatus2["Error"] = "error";
+})(ActionStatus ||= {});
+var VolumeStatus;
+((VolumeStatus2) => {
+  VolumeStatus2["Creating"] = "creating";
+  VolumeStatus2["Available"] = "available";
+  VolumeStatus2["Deleting"] = "deleting";
+})(VolumeStatus ||= {});
+var LoopStatus;
+((LoopStatus2) => {
+  LoopStatus2["Running"] = "running";
+  LoopStatus2["Stopped"] = "stopped";
+  LoopStatus2["Error"] = "error";
+  LoopStatus2["Completed"] = "completed";
+})(LoopStatus ||= {});
+
+// src/sessions.ts
 var metadataModule = null;
 function loadMetadata() {
   if (metadataModule === null) {
@@ -2030,7 +1975,7 @@ async function closeSession(sessionId) {
     } catch {}
   }
   try {
-    session.ws?.close(import_compile.WebSocketCloseCode.NORMAL_CLOSURE, "Session closed");
+    session.ws?.close(WebSocketCloseCode.NORMAL_CLOSURE, "Session closed");
   } catch {}
   if (session.bootstrapLogStreamer) {
     try {
@@ -2350,14 +2295,14 @@ async function getOrCreateSession(host, user = "root", sessionId = null, keyPath
     console.log(`[Terminal] Process for ${newSessionId} exited with code ${exitCode}`);
     session.closed = true;
     try {
-      session.ws?.close(import_compile.WebSocketCloseCode.NORMAL_CLOSURE, `SSH process exited (code: ${exitCode})`);
+      session.ws?.close(WebSocketCloseCode.NORMAL_CLOSURE, `SSH process exited (code: ${exitCode})`);
     } catch {}
     terminalSessions.delete(newSessionId);
   }).catch((err) => {
     console.log(`[Terminal] Process exit error for ${newSessionId}:`, err);
     session.closed = true;
     try {
-      session.ws?.close(import_compile.WebSocketCloseCode.INTERNAL_ERROR, "SSH process error");
+      session.ws?.close(WebSocketCloseCode.INTERNAL_ERROR, "SSH process error");
     } catch {}
   });
   return session;
@@ -2439,6 +2384,12 @@ var DEFAULT_CONFIG3 = {
   historyLimit: 1e4,
   sessionAgeLimit: 30 * 24 * 60 * 60 * 1000
 };
+// src/config.ts
+import { join, dirname, isAbsolute, resolve } from "path";
+import { exec as exec2 } from "child_process";
+import { promisify as promisify3 } from "util";
+var execAsync3 = promisify3(exec2);
+var SSH_CONFIG_PATH = join(process.env.HOME || "~", ".ssh", "config");
 // src/mcp/index.ts
 async function listSessionsTool() {
   const sessions = getAllSessionInfo();

package/dist/sessions.d.ts

@@ -20,7 +20,9 @@ export interface TerminalSession {
     createdAt: number;
     lastUsed: number;
     reader: ReadableStreamDefaultReader<Uint8Array> | null;
-    stderrReader: ReadableStreamDefaultReader<Uint8Array> | null;
+    stderrReader: (ReadableStreamDefaultReader<Uint8Array> & {
+        readMany?: () => Promise<any>;
+    }) | null;
     writer: WritableStreamDefaultWriter<Uint8Array> | null;
     closed: boolean;
     tmuxSessionName?: string;

package/dist/tmux-manager.d.ts

@@ -46,7 +46,7 @@ export interface TmuxSession {
 /**
  * Detailed session information with windows and panes
  */
-export interface DetailedTmuxSession extends TmuxSession {
+export interface DetailedTmuxSession extends Omit<TmuxSession, 'windows'> {
     windows: Array<{
         index: string;
         name: string;
@@ -95,8 +95,8 @@ export interface CreateSessionOptions {
  * Options for batch command execution
  */
 export interface BatchCommandOptions {
-    /** Command to execute */
-    command: string;
+    /** Command to execute (optional - passed separately to sendCommandToNodes) */
+    command?: string;
     /** Target pane index (default: "0") */
     paneIndex?: string;
     /** Execute in parallel (default: true) */
@@ -293,6 +293,7 @@ export declare class TmuxSessionManager {
         success: boolean;
         cleaned?: number;
         errors?: string[];
+        error?: string;
     }>;
     /**
      * Get resource usage for sessions on a node

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ebowwa/terminal",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Terminal session management with tmux integration, SSH client, WebSocket support, and MCP interface",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,10 +17,15 @@
     "./types": {
       "types": "./dist/types.d.ts",
       "default": "./dist/types.d.ts"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
     }
   },
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target bun --external 'node-ssh' --external 'hono' --external 'zod' --external 'node:*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external 'node-ssh' --external 'hono' --external 'zod' --external 'node:*' --external '@modelcontextprotocol/*'"
+    "build": "bun build src/index.ts --outdir dist --target bun --external 'node-ssh' --external 'hono' --external 'zod' --external 'node:*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external 'node-ssh' --external 'hono' --external 'zod' --external 'node:*' --external '@modelcontextprotocol/*'",
+    "prepublishOnly": "bun run build"
   },
   "files": [
     "dist"
@@ -61,5 +66,13 @@
     "@types/bun": "latest",
     "@types/node-ssh": "^11.0.0",
     "typescript": "^5.9.3"
+  },
+  "ownership": {
+    "domain": "terminal",
+    "responsibilities": [
+      "ssh",
+      "tmux",
+      "session-management"
+    ]
   }
 }

package/dist/mcp/index.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Terminal MCP Server
- *
- * Exposes terminal session management via Model Context Protocol
- * Integrates with tmux, SSH, PTY, and file operations
- */
-export {};

package/dist/mcp/stdio.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Terminal MCP Server (stdio protocol)
- *
- * Model Context Protocol server for terminal session management
- * Uses stdio transport for Claude Code integration
- */
-export {};