lit-shell.js 0.1.4 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2025-01-09
+
+### Added
+
+- **Tabbed Terminals**: New `show-tabs` attribute enables multiple terminal tabs in a single component
+  - Each tab has independent WebSocket connection and terminal session
+  - Tab bar with status indicators and add/close buttons
+  - Dynamic labels showing shell or container name
+  - `createTab()`, `switchTab()`, `closeTab()` methods
+- **Join Existing Session**: Connection panel now shows "Join Existing Session" mode when sessions are available
+- **Prompt Refresh on Join**: Joining a session now triggers a fresh prompt display
+
+### Fixed
+
+- Fixed duplicate output when multiple tabs join the same session
+- Fixed session list not updating after spawning a session
+- Each client's data handler now correctly writes to its own tab's terminal
+
+## [1.0.0] - 2025-01-08
+
+### Added
+
+- Initial release
+- WebSocket-based terminal server with node-pty
+- Lightweight client library with auto-reconnection
+- `<lit-shell-terminal>` Lit web component with xterm.js
+- Docker exec support for connecting to containers
+- Docker attach mode for connecting to container's main process (PID 1)
+- Session multiplexing - multiple clients sharing the same terminal
+- Session persistence with configurable orphan timeout
+- History replay for clients joining existing sessions
+- Built-in connection panel with container/shell selector
+- Settings dropdown (theme, font size)
+- Status bar with connection info
+- Dark/light/auto theme support
+- Security features: shell, path, and container allowlists
+- Python client bindings (`bindings/python/`)
+- Example projects for Docker containers and multiplexing

package/dist/client/browser-bundle.js

@@ -5,6 +5,7 @@ var TerminalClient = class {
     this.state = "disconnected";
     this.sessionId = null;
     this.sessionInfo = null;
+    this.serverInfo = null;
     this.reconnectAttempts = 0;
     this.reconnectTimeout = null;
     // Event handlers
@@ -14,9 +15,21 @@ var TerminalClient = class {
     this.exitHandlers = [];
     this.errorHandlers = [];
     this.spawnedHandlers = [];
-    // Promise resolvers for spawn
+    this.serverInfoHandlers = [];
+    this.containerListHandlers = [];
+    // Session multiplexing handlers
+    this.sessionListHandlers = [];
+    this.joinedHandlers = [];
+    this.leftHandlers = [];
+    this.clientJoinedHandlers = [];
+    this.clientLeftHandlers = [];
+    this.sessionClosedHandlers = [];
+    // Promise resolvers for spawn/join
     this.spawnResolve = null;
     this.spawnReject = null;
+    this.joinResolve = null;
+    this.joinReject = null;
+    this.listSessionsResolve = null;
     this.config = {
       url: config.url,
       reconnect: config.reconnect ?? true,
@@ -123,7 +136,8 @@ var TerminalClient = class {
           cwd: message.cwd,
           cols: message.cols,
           rows: message.rows,
-          createdAt: /* @__PURE__ */ new Date()
+          createdAt: /* @__PURE__ */ new Date(),
+          container: message.container
         };
         this.spawnedHandlers.forEach((handler) => handler(this.sessionInfo));
         if (this.spawnResolve) {
@@ -149,6 +163,76 @@ var TerminalClient = class {
           this.spawnResolve = null;
           this.spawnReject = null;
         }
+        if (this.joinReject) {
+          this.joinReject(error);
+          this.joinResolve = null;
+          this.joinReject = null;
+        }
+        break;
+      case "serverInfo":
+        this.serverInfo = message.info;
+        this.serverInfoHandlers.forEach((handler) => handler(message.info));
+        break;
+      case "containerList":
+        this.containerListHandlers.forEach((handler) => handler(message.containers));
+        break;
+      case "sessionList":
+        this.sessionListHandlers.forEach(
+          (handler) => handler(message.sessions)
+        );
+        if (this.listSessionsResolve) {
+          this.listSessionsResolve(message.sessions);
+          this.listSessionsResolve = null;
+        }
+        break;
+      case "joined":
+        const joinedSession = message.session;
+        const history = message.history;
+        this.sessionId = message.sessionId;
+        this.sessionInfo = {
+          sessionId: joinedSession.sessionId,
+          shell: joinedSession.shell,
+          cwd: joinedSession.cwd,
+          cols: joinedSession.cols,
+          rows: joinedSession.rows,
+          createdAt: joinedSession.createdAt,
+          container: joinedSession.container
+        };
+        this.joinedHandlers.forEach((handler) => handler(joinedSession, history));
+        if (this.joinResolve) {
+          this.joinResolve(joinedSession);
+          this.joinResolve = null;
+          this.joinReject = null;
+        }
+        break;
+      case "left":
+        const leftSessionId = message.sessionId;
+        if (this.sessionId === leftSessionId) {
+          this.sessionId = null;
+          this.sessionInfo = null;
+        }
+        this.leftHandlers.forEach((handler) => handler(leftSessionId));
+        break;
+      case "clientJoined":
+        this.clientJoinedHandlers.forEach(
+          (handler) => handler(message.sessionId, message.clientCount)
+        );
+        break;
+      case "clientLeft":
+        this.clientLeftHandlers.forEach(
+          (handler) => handler(message.sessionId, message.clientCount)
+        );
+        break;
+      case "sessionClosed":
+        const closedSessionId = message.sessionId;
+        const reason = message.reason;
+        if (this.sessionId === closedSessionId) {
+          this.sessionId = null;
+          this.sessionInfo = null;
+        }
+        this.sessionClosedHandlers.forEach(
+          (handler) => handler(closedSessionId, reason)
+        );
         break;
     }
   }
@@ -162,7 +246,7 @@ var TerminalClient = class {
         return;
       }
       if (this.sessionId) {
-        reject(new Error("Session already spawned. Call kill() first."));
+        reject(new Error("Session already active. Call kill() or leave() first."));
         return;
       }
       this.spawnResolve = resolve;
@@ -217,7 +301,7 @@ var TerminalClient = class {
     );
   }
   /**
-   * Kill the terminal session
+   * Kill the terminal session (close and terminate)
    */
   kill() {
     if (!this.ws || this.state !== "connected") {
@@ -236,6 +320,91 @@ var TerminalClient = class {
     this.sessionInfo = null;
   }
   // ==========================================
+  // Session Multiplexing Methods
+  // ==========================================
+  /**
+   * List available sessions
+   */
+  listSessions(filter) {
+    return new Promise((resolve, reject) => {
+      if (this.state !== "connected" || !this.ws) {
+        reject(new Error("Not connected to server"));
+        return;
+      }
+      this.listSessionsResolve = resolve;
+      this.ws.send(
+        JSON.stringify({
+          type: "listSessions",
+          filter
+        })
+      );
+    });
+  }
+  /**
+   * Join an existing session
+   */
+  join(options) {
+    return new Promise((resolve, reject) => {
+      if (this.state !== "connected" || !this.ws) {
+        reject(new Error("Not connected to server"));
+        return;
+      }
+      if (this.sessionId) {
+        reject(new Error("Already in a session. Call leave() first."));
+        return;
+      }
+      this.joinResolve = resolve;
+      this.joinReject = reject;
+      this.ws.send(
+        JSON.stringify({
+          type: "join",
+          options
+        })
+      );
+    });
+  }
+  /**
+   * Leave the current session without killing it
+   */
+  leave(sessionId) {
+    if (!this.ws || this.state !== "connected") {
+      console.error("[lit-shell] Cannot leave: not connected");
+      return;
+    }
+    const targetSession = sessionId || this.sessionId;
+    if (!targetSession) {
+      console.error("[lit-shell] Cannot leave: no active session");
+      return;
+    }
+    this.ws.send(
+      JSON.stringify({
+        type: "leave",
+        sessionId: targetSession
+      })
+    );
+    if (targetSession === this.sessionId) {
+      this.sessionId = null;
+      this.sessionInfo = null;
+    }
+  }
+  /**
+   * Request session list and trigger onSessionList handlers
+   * (Fire-and-forget version of listSessions)
+   */
+  requestSessionList(filter) {
+    this.listSessions(filter).then((sessions) => {
+      this.sessionListHandlers.forEach((handler) => {
+        try {
+          handler(sessions);
+        } catch (e) {
+          console.error("[lit-shell] Error in sessionList handler:", e);
+        }
+      });
+    }).catch((err) => {
+      console.error("[lit-shell] Failed to list sessions:", err);
+    });
+  }
+  // ==========================================
   // Event handlers
   // ==========================================
   /**
@@ -274,6 +443,67 @@ var TerminalClient = class {
   onSpawned(handler) {
     this.spawnedHandlers.push(handler);
   }
+  /**
+   * Called when server info is received
+   */
+  onServerInfo(handler) {
+    this.serverInfoHandlers.push(handler);
+    if (this.serverInfo) {
+      handler(this.serverInfo);
+    }
+  }
+  /**
+   * Called when container list is received
+   */
+  onContainerList(handler) {
+    this.containerListHandlers.push(handler);
+  }
+  /**
+   * Called when session list is received
+   */
+  onSessionList(handler) {
+    this.sessionListHandlers.push(handler);
+  }
+  /**
+   * Called when successfully joined a session
+   */
+  onJoined(handler) {
+    this.joinedHandlers.push(handler);
+  }
+  /**
+   * Called when left a session
+   */
+  onLeft(handler) {
+    this.leftHandlers.push(handler);
+  }
+  /**
+   * Called when another client joins the current session
+   */
+  onClientJoined(handler) {
+    this.clientJoinedHandlers.push(handler);
+  }
+  /**
+   * Called when another client leaves the current session
+   */
+  onClientLeft(handler) {
+    this.clientLeftHandlers.push(handler);
+  }
+  /**
+   * Called when the session is closed by owner or orphan timeout
+   */
+  onSessionClosed(handler) {
+    this.sessionClosedHandlers.push(handler);
+  }
+  /**
+   * Request list of available containers
+   */
+  requestContainerList() {
+    if (!this.ws || this.state !== "connected") {
+      console.error("[lit-shell] Cannot request containers: not connected");
+      return;
+    }
+    this.ws.send(JSON.stringify({ type: "listContainers" }));
+  }
   // ==========================================
   // Getters
   // ==========================================
@@ -307,6 +537,12 @@ var TerminalClient = class {
   hasActiveSession() {
     return this.sessionId !== null;
   }
+  /**
+   * Get server info
+   */
+  getServerInfo() {
+    return this.serverInfo;
+  }
 };
 export {
   TerminalClient

package/dist/client/browser-bundle.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/client/terminal-client.ts"],
-  "sourcesContent": ["/**\n * Terminal client for connecting to lit-shell server\n *\n * Example usage:\n * ```typescript\n * import { TerminalClient } from 'lit-shell.js/client';\n *\n * const client = new TerminalClient({ url: 'ws://localhost:3000/terminal' });\n * await client.connect();\n *\n * client.onData((data) => console.log(data));\n * client.onExit((code) => console.log('Exited with code:', code));\n *\n * await client.spawn({ shell: '/bin/bash', cwd: '/home/user' });\n * client.write('ls -la\\n');\n * client.resize(120, 40);\n * client.kill();\n * ```\n */\n\nimport type {\n  ClientConfig,\n  TerminalOptions,\n  TerminalMessage,\n  SessionInfo,\n} from '../shared/types.js';\n\n/**\n * Connection state\n */\nexport type ConnectionState = 'disconnected' | 'connecting' | 'connected';\n\n/**\n * Terminal client class\n */\nexport class TerminalClient {\n  private config: Required<ClientConfig>;\n  private ws: WebSocket | null = null;\n  private state: ConnectionState = 'disconnected';\n  private sessionId: string | null = null;\n  private sessionInfo: SessionInfo | null = null;\n  private reconnectAttempts = 0;\n  private reconnectTimeout: ReturnType<typeof setTimeout> | null = null;\n\n  // Event handlers\n  private connectHandlers: (() => void)[] = [];\n  private disconnectHandlers: (() => void)[] = [];\n  private dataHandlers: ((data: string) => void)[] = [];\n  private exitHandlers: ((code: number) => void)[] = [];\n  private errorHandlers: ((error: Error) => void)[] = [];\n  private spawnedHandlers: ((info: SessionInfo) => void)[] = [];\n\n  // Promise resolvers for spawn\n  private spawnResolve: ((info: SessionInfo) => void) | null = null;\n  private spawnReject: ((error: Error) => void) | null = null;\n\n  constructor(config: ClientConfig) {\n    this.config = {\n      url: config.url,\n      reconnect: config.reconnect ?? true,\n      maxReconnectAttempts: config.maxReconnectAttempts ?? 10,\n      reconnectDelay: config.reconnectDelay ?? 1000,\n    };\n  }\n\n  /**\n   * Connect to the terminal server\n   */\n  connect(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      if (this.state === 'connected') {\n        resolve();\n        return;\n      }\n\n      this.state = 'connecting';\n\n      try {\n        this.ws = new WebSocket(this.config.url);\n      } catch (error) {\n        this.state = 'disconnected';\n        reject(error);\n        return;\n      }\n\n      this.ws.onopen = () => {\n        this.state = 'connected';\n        this.reconnectAttempts = 0;\n        this.connectHandlers.forEach((handler) => handler());\n        resolve();\n      };\n\n      this.ws.onclose = () => {\n        const wasConnected = this.state === 'connected';\n        this.state = 'disconnected';\n        this.sessionId = null;\n        this.sessionInfo = null;\n\n        if (wasConnected) {\n          this.disconnectHandlers.forEach((handler) => handler());\n        }\n\n        // Attempt reconnection\n        if (this.config.reconnect && this.reconnectAttempts < this.config.maxReconnectAttempts) {\n          this.scheduleReconnect();\n        }\n      };\n\n      this.ws.onerror = (event) => {\n        const error = new Error('WebSocket error');\n        this.errorHandlers.forEach((handler) => handler(error));\n\n        if (this.state === 'connecting') {\n          reject(error);\n        }\n      };\n\n      this.ws.onmessage = (event) => {\n        this.handleMessage(event.data);\n      };\n    });\n  }\n\n  /**\n   * Disconnect from the terminal server\n   */\n  disconnect(): void {\n    this.config.reconnect = false; // Prevent auto-reconnect\n\n    if (this.reconnectTimeout) {\n      clearTimeout(this.reconnectTimeout);\n      this.reconnectTimeout = null;\n    }\n\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n\n    this.state = 'disconnected';\n    this.sessionId = null;\n    this.sessionInfo = null;\n  }\n\n  /**\n   * Schedule a reconnection attempt\n   */\n  private scheduleReconnect(): void {\n    if (this.reconnectTimeout) return;\n\n    const delay = this.config.reconnectDelay * Math.pow(2, this.reconnectAttempts);\n    const maxDelay = 30000; // 30 seconds max\n\n    this.reconnectTimeout = setTimeout(() => {\n      this.reconnectTimeout = null;\n      this.reconnectAttempts++;\n      this.connect().catch(() => {\n        // Error handled by onclose\n      });\n    }, Math.min(delay, maxDelay));\n  }\n\n  /**\n   * Handle incoming message\n   */\n  private handleMessage(data: string): void {\n    let message: TerminalMessage;\n\n    try {\n      message = JSON.parse(data);\n    } catch {\n      console.error('[lit-shell] Invalid message:', data);\n      return;\n    }\n\n    switch (message.type) {\n      case 'spawned':\n        this.sessionId = message.sessionId;\n        this.sessionInfo = {\n          sessionId: message.sessionId,\n          shell: message.shell,\n          cwd: message.cwd,\n          cols: message.cols,\n          rows: message.rows,\n          createdAt: new Date(),\n        };\n        this.spawnedHandlers.forEach((handler) => handler(this.sessionInfo!));\n        if (this.spawnResolve) {\n          this.spawnResolve(this.sessionInfo);\n          this.spawnResolve = null;\n          this.spawnReject = null;\n        }\n        break;\n\n      case 'data':\n        this.dataHandlers.forEach((handler) => handler(message.data));\n        break;\n\n      case 'exit':\n        const exitCode = message.exitCode;\n        this.exitHandlers.forEach((handler) => handler(exitCode));\n        this.sessionId = null;\n        this.sessionInfo = null;\n        break;\n\n      case 'error':\n        const error = new Error(message.error);\n        this.errorHandlers.forEach((handler) => handler(error));\n        if (this.spawnReject) {\n          this.spawnReject(error);\n          this.spawnResolve = null;\n          this.spawnReject = null;\n        }\n        break;\n    }\n  }\n\n  /**\n   * Spawn a terminal session\n   */\n  spawn(options: TerminalOptions = {}): Promise<SessionInfo> {\n    return new Promise((resolve, reject) => {\n      if (this.state !== 'connected' || !this.ws) {\n        reject(new Error('Not connected to server'));\n        return;\n      }\n\n      if (this.sessionId) {\n        reject(new Error('Session already spawned. Call kill() first.'));\n        return;\n      }\n\n      this.spawnResolve = resolve;\n      this.spawnReject = reject;\n\n      this.ws.send(\n        JSON.stringify({\n          type: 'spawn',\n          options,\n        })\n      );\n    });\n  }\n\n  /**\n   * Write data to the terminal\n   */\n  write(data: string): void {\n    if (!this.ws || this.state !== 'connected') {\n      console.error('[lit-shell] Cannot write: not connected');\n      return;\n    }\n\n    if (!this.sessionId) {\n      console.error('[lit-shell] Cannot write: no active session');\n      return;\n    }\n\n    this.ws.send(\n      JSON.stringify({\n        type: 'data',\n        sessionId: this.sessionId,\n        data,\n      })\n    );\n  }\n\n  /**\n   * Resize the terminal\n   */\n  resize(cols: number, rows: number): void {\n    if (!this.ws || this.state !== 'connected') {\n      console.error('[lit-shell] Cannot resize: not connected');\n      return;\n    }\n\n    if (!this.sessionId) {\n      console.error('[lit-shell] Cannot resize: no active session');\n      return;\n    }\n\n    this.ws.send(\n      JSON.stringify({\n        type: 'resize',\n        sessionId: this.sessionId,\n        cols,\n        rows,\n      })\n    );\n  }\n\n  /**\n   * Kill the terminal session\n   */\n  kill(): void {\n    if (!this.ws || this.state !== 'connected') {\n      return;\n    }\n\n    if (!this.sessionId) {\n      return;\n    }\n\n    this.ws.send(\n      JSON.stringify({\n        type: 'close',\n        sessionId: this.sessionId,\n      })\n    );\n\n    this.sessionId = null;\n    this.sessionInfo = null;\n  }\n\n  // ==========================================\n  // Event handlers\n  // ==========================================\n\n  /**\n   * Called when connected to server\n   */\n  onConnect(handler: () => void): void {\n    this.connectHandlers.push(handler);\n  }\n\n  /**\n   * Called when disconnected from server\n   */\n  onDisconnect(handler: () => void): void {\n    this.disconnectHandlers.push(handler);\n  }\n\n  /**\n   * Called when data is received from the terminal\n   */\n  onData(handler: (data: string) => void): void {\n    this.dataHandlers.push(handler);\n  }\n\n  /**\n   * Called when the terminal session exits\n   */\n  onExit(handler: (code: number) => void): void {\n    this.exitHandlers.push(handler);\n  }\n\n  /**\n   * Called when an error occurs\n   */\n  onError(handler: (error: Error) => void): void {\n    this.errorHandlers.push(handler);\n  }\n\n  /**\n   * Called when a session is spawned\n   */\n  onSpawned(handler: (info: SessionInfo) => void): void {\n    this.spawnedHandlers.push(handler);\n  }\n\n  // ==========================================\n  // Getters\n  // ==========================================\n\n  /**\n   * Get current connection state\n   */\n  getState(): ConnectionState {\n    return this.state;\n  }\n\n  /**\n   * Check if connected\n   */\n  isConnected(): boolean {\n    return this.state === 'connected';\n  }\n\n  /**\n   * Get current session ID\n   */\n  getSessionId(): string | null {\n    return this.sessionId;\n  }\n\n  /**\n   * Get current session info\n   */\n  getSessionInfo(): SessionInfo | null {\n    return this.sessionInfo;\n  }\n\n  /**\n   * Check if a session is active\n   */\n  hasActiveSession(): boolean {\n    return this.sessionId !== null;\n  }\n}\n"],
-  "mappings": ";AAmCO,IAAM,iBAAN,MAAqB;AAAA,EAqB1B,YAAY,QAAsB;AAnBlC,SAAQ,KAAuB;AAC/B,SAAQ,QAAyB;AACjC,SAAQ,YAA2B;AACnC,SAAQ,cAAkC;AAC1C,SAAQ,oBAAoB;AAC5B,SAAQ,mBAAyD;AAGjE;AAAA,SAAQ,kBAAkC,CAAC;AAC3C,SAAQ,qBAAqC,CAAC;AAC9C,SAAQ,eAA2C,CAAC;AACpD,SAAQ,eAA2C,CAAC;AACpD,SAAQ,gBAA4C,CAAC;AACrD,SAAQ,kBAAmD,CAAC;AAG5D;AAAA,SAAQ,eAAqD;AAC7D,SAAQ,cAA+C;AAGrD,SAAK,SAAS;AAAA,MACZ,KAAK,OAAO;AAAA,MACZ,WAAW,OAAO,aAAa;AAAA,MAC/B,sBAAsB,OAAO,wBAAwB;AAAA,MACrD,gBAAgB,OAAO,kBAAkB;AAAA,IAC3C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAyB;AACvB,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAI,KAAK,UAAU,aAAa;AAC9B,gBAAQ;AACR;AAAA,MACF;AAEA,WAAK,QAAQ;AAEb,UAAI;AACF,aAAK,KAAK,IAAI,UAAU,KAAK,OAAO,GAAG;AAAA,MACzC,SAAS,OAAO;AACd,aAAK,QAAQ;AACb,eAAO,KAAK;AACZ;AAAA,MACF;AAEA,WAAK,GAAG,SAAS,MAAM;AACrB,aAAK,QAAQ;AACb,aAAK,oBAAoB;AACzB,aAAK,gBAAgB,QAAQ,CAAC,YAAY,QAAQ,CAAC;AACnD,gBAAQ;AAAA,MACV;AAEA,WAAK,GAAG,UAAU,MAAM;AACtB,cAAM,eAAe,KAAK,UAAU;AACpC,aAAK,QAAQ;AACb,aAAK,YAAY;AACjB,aAAK,cAAc;AAEnB,YAAI,cAAc;AAChB,eAAK,mBAAmB,QAAQ,CAAC,YAAY,QAAQ,CAAC;AAAA,QACxD;AAGA,YAAI,KAAK,OAAO,aAAa,KAAK,oBAAoB,KAAK,OAAO,sBAAsB;AACtF,eAAK,kBAAkB;AAAA,QACzB;AAAA,MACF;AAEA,WAAK,GAAG,UAAU,CAAC,UAAU;AAC3B,cAAM,QAAQ,IAAI,MAAM,iBAAiB;AACzC,aAAK,cAAc,QAAQ,CAAC,YAAY,QAAQ,KAAK,CAAC;AAEtD,YAAI,KAAK,UAAU,cAAc;AAC/B,iBAAO,KAAK;AAAA,QACd;AAAA,MACF;AAEA,WAAK,GAAG,YAAY,CAAC,UAAU;AAC7B,aAAK,cAAc,MAAM,IAAI;AAAA,MAC/B;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAmB;AACjB,SAAK,OAAO,YAAY;AAExB,QAAI,KAAK,kBAAkB;AACzB,mBAAa,KAAK,gBAAgB;AAClC,WAAK,mBAAmB;AAAA,IAC1B;AAEA,QAAI,KAAK,IAAI;AACX,WAAK,GAAG,MAAM;AACd,WAAK,KAAK;AAAA,IACZ;AAEA,SAAK,QAAQ;AACb,SAAK,YAAY;AACjB,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAA0B;AAChC,QAAI,KAAK;AAAkB;AAE3B,UAAM,QAAQ,KAAK,OAAO,iBAAiB,KAAK,IAAI,GAAG,KAAK,iBAAiB;AAC7E,UAAM,WAAW;AAEjB,SAAK,mBAAmB,WAAW,MAAM;AACvC,WAAK,mBAAmB;AACxB,WAAK;AACL,WAAK,QAAQ,EAAE,MAAM,MAAM;AAAA,MAE3B,CAAC;AAAA,IACH,GAAG,KAAK,IAAI,OAAO,QAAQ,CAAC;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,MAAoB;AACxC,QAAI;AAEJ,QAAI;AACF,gBAAU,KAAK,MAAM,IAAI;AAAA,IAC3B,QAAQ;AACN,cAAQ,MAAM,gCAAgC,IAAI;AAClD;AAAA,IACF;AAEA,YAAQ,QAAQ,MAAM;AAAA,MACpB,KAAK;AACH,aAAK,YAAY,QAAQ;AACzB,aAAK,cAAc;AAAA,UACjB,WAAW,QAAQ;AAAA,UACnB,OAAO,QAAQ;AAAA,UACf,KAAK,QAAQ;AAAA,UACb,MAAM,QAAQ;AAAA,UACd,MAAM,QAAQ;AAAA,UACd,WAAW,oBAAI,KAAK;AAAA,QACtB;AACA,aAAK,gBAAgB,QAAQ,CAAC,YAAY,QAAQ,KAAK,WAAY,CAAC;AACpE,YAAI,KAAK,cAAc;AACrB,eAAK,aAAa,KAAK,WAAW;AAClC,eAAK,eAAe;AACpB,eAAK,cAAc;AAAA,QACrB;AACA;AAAA,MAEF,KAAK;AACH,aAAK,aAAa,QAAQ,CAAC,YAAY,QAAQ,QAAQ,IAAI,CAAC;AAC5D;AAAA,MAEF,KAAK;AACH,cAAM,WAAW,QAAQ;AACzB,aAAK,aAAa,QAAQ,CAAC,YAAY,QAAQ,QAAQ,CAAC;AACxD,aAAK,YAAY;AACjB,aAAK,cAAc;AACnB;AAAA,MAEF,KAAK;AACH,cAAM,QAAQ,IAAI,MAAM,QAAQ,KAAK;AACrC,aAAK,cAAc,QAAQ,CAAC,YAAY,QAAQ,KAAK,CAAC;AACtD,YAAI,KAAK,aAAa;AACpB,eAAK,YAAY,KAAK;AACtB,eAAK,eAAe;AACpB,eAAK,cAAc;AAAA,QACrB;AACA;AAAA,IACJ;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAA2B,CAAC,GAAyB;AACzD,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAI,KAAK,UAAU,eAAe,CAAC,KAAK,IAAI;AAC1C,eAAO,IAAI,MAAM,yBAAyB,CAAC;AAC3C;AAAA,MACF;AAEA,UAAI,KAAK,WAAW;AAClB,eAAO,IAAI,MAAM,6CAA6C,CAAC;AAC/D;AAAA,MACF;AAEA,WAAK,eAAe;AACpB,WAAK,cAAc;AAEnB,WAAK,GAAG;AAAA,QACN,KAAK,UAAU;AAAA,UACb,MAAM;AAAA,UACN;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MAAoB;AACxB,QAAI,CAAC,KAAK,MAAM,KAAK,UAAU,aAAa;AAC1C,cAAQ,MAAM,yCAAyC;AACvD;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,WAAW;AACnB,cAAQ,MAAM,6CAA6C;AAC3D;AAAA,IACF;AAEA,SAAK,GAAG;AAAA,MACN,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,QACN,WAAW,KAAK;AAAA,QAChB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,MAAc,MAAoB;AACvC,QAAI,CAAC,KAAK,MAAM,KAAK,UAAU,aAAa;AAC1C,cAAQ,MAAM,0CAA0C;AACxD;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,WAAW;AACnB,cAAQ,MAAM,8CAA8C;AAC5D;AAAA,IACF;AAEA,SAAK,GAAG;AAAA,MACN,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,QACN,WAAW,KAAK;AAAA,QAChB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACX,QAAI,CAAC,KAAK,MAAM,KAAK,UAAU,aAAa;AAC1C;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,WAAW;AACnB;AAAA,IACF;AAEA,SAAK,GAAG;AAAA,MACN,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,QACN,WAAW,KAAK;AAAA,MAClB,CAAC;AAAA,IACH;AAEA,SAAK,YAAY;AACjB,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,UAAU,SAA2B;AACnC,SAAK,gBAAgB,KAAK,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,SAA2B;AACtC,SAAK,mBAAmB,KAAK,OAAO;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAuC;AAC5C,SAAK,aAAa,KAAK,OAAO;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAuC;AAC5C,SAAK,aAAa,KAAK,OAAO;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,SAAuC;AAC7C,SAAK,cAAc,KAAK,OAAO;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,SAA4C;AACpD,SAAK,gBAAgB,KAAK,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAA4B;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,cAAuB;AACrB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,eAA8B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAqC;AACnC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,mBAA4B;AAC1B,WAAO,KAAK,cAAc;AAAA,EAC5B;AACF;",
+  "sourcesContent": ["/**\n * Terminal client for connecting to lit-shell server\n *\n * Example usage:\n * ```typescript\n * import { TerminalClient } from 'lit-shell.js/client';\n *\n * const client = new TerminalClient({ url: 'ws://localhost:3000/terminal' });\n * await client.connect();\n *\n * client.onData((data) => console.log(data));\n * client.onExit((code) => console.log('Exited with code:', code));\n *\n * await client.spawn({ shell: '/bin/bash', cwd: '/home/user' });\n * client.write('ls -la\\n');\n * client.resize(120, 40);\n * client.kill();\n *\n * // Session multiplexing example\n * const sessions = await client.listSessions();\n * if (sessions.length > 0) {\n *   await client.join({ sessionId: sessions[0].sessionId, requestHistory: true });\n * }\n * ```\n */\n\nimport type {\n  ClientConfig,\n  TerminalOptions,\n  TerminalMessage,\n  SessionInfo,\n  ContainerInfo,\n  ServerInfo,\n  SharedSessionInfo,\n  SessionListFilter,\n  JoinSessionOptions,\n} from '../shared/types.js';\n\n/**\n * Connection state\n */\nexport type ConnectionState = 'disconnected' | 'connecting' | 'connected';\n\n/**\n * Terminal client class with session multiplexing support\n */\nexport class TerminalClient {\n  private config: Required<ClientConfig>;\n  private ws: WebSocket | null = null;\n  private state: ConnectionState = 'disconnected';\n  private sessionId: string | null = null;\n  private sessionInfo: SessionInfo | null = null;\n  private serverInfo: ServerInfo | null = null;\n  private reconnectAttempts = 0;\n  private reconnectTimeout: ReturnType<typeof setTimeout> | null = null;\n\n  // Event handlers\n  private connectHandlers: (() => void)[] = [];\n  private disconnectHandlers: (() => void)[] = [];\n  private dataHandlers: ((data: string) => void)[] = [];\n  private exitHandlers: ((code: number) => void)[] = [];\n  private errorHandlers: ((error: Error) => void)[] = [];\n  private spawnedHandlers: ((info: SessionInfo) => void)[] = [];\n  private serverInfoHandlers: ((info: ServerInfo) => void)[] = [];\n  private containerListHandlers: ((containers: ContainerInfo[]) => void)[] = [];\n  // Session multiplexing handlers\n  private sessionListHandlers: ((sessions: SharedSessionInfo[]) => void)[] = [];\n  private joinedHandlers: ((session: SharedSessionInfo, history?: string) => void)[] = [];\n  private leftHandlers: ((sessionId: string) => void)[] = [];\n  private clientJoinedHandlers: ((sessionId: string, clientCount: number) => void)[] = [];\n  private clientLeftHandlers: ((sessionId: string, clientCount: number) => void)[] = [];\n  private sessionClosedHandlers: ((sessionId: string, reason: string) => void)[] = [];\n\n  // Promise resolvers for spawn/join\n  private spawnResolve: ((info: SessionInfo) => void) | null = null;\n  private spawnReject: ((error: Error) => void) | null = null;\n  private joinResolve: ((info: SharedSessionInfo) => void) | null = null;\n  private joinReject: ((error: Error) => void) | null = null;\n  private listSessionsResolve: ((sessions: SharedSessionInfo[]) => void) | null = null;\n\n  constructor(config: ClientConfig) {\n    this.config = {\n      url: config.url,\n      reconnect: config.reconnect ?? true,\n      maxReconnectAttempts: config.maxReconnectAttempts ?? 10,\n      reconnectDelay: config.reconnectDelay ?? 1000,\n    };\n  }\n\n  /**\n   * Connect to the terminal server\n   */\n  connect(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      if (this.state === 'connected') {\n        resolve();\n        return;\n      }\n\n      this.state = 'connecting';\n\n      try {\n        this.ws = new WebSocket(this.config.url);\n      } catch (error) {\n        this.state = 'disconnected';\n        reject(error);\n        return;\n      }\n\n      this.ws.onopen = () => {\n        this.state = 'connected';\n        this.reconnectAttempts = 0;\n        this.connectHandlers.forEach((handler) => handler());\n        resolve();\n      };\n\n      this.ws.onclose = () => {\n        const wasConnected = this.state === 'connected';\n        this.state = 'disconnected';\n        this.sessionId = null;\n        this.sessionInfo = null;\n\n        if (wasConnected) {\n          this.disconnectHandlers.forEach((handler) => handler());\n        }\n\n        // Attempt reconnection\n        if (this.config.reconnect && this.reconnectAttempts < this.config.maxReconnectAttempts) {\n          this.scheduleReconnect();\n        }\n      };\n\n      this.ws.onerror = (event) => {\n        const error = new Error('WebSocket error');\n        this.errorHandlers.forEach((handler) => handler(error));\n\n        if (this.state === 'connecting') {\n          reject(error);\n        }\n      };\n\n      this.ws.onmessage = (event) => {\n        this.handleMessage(event.data);\n      };\n    });\n  }\n\n  /**\n   * Disconnect from the terminal server\n   */\n  disconnect(): void {\n    this.config.reconnect = false; // Prevent auto-reconnect\n\n    if (this.reconnectTimeout) {\n      clearTimeout(this.reconnectTimeout);\n      this.reconnectTimeout = null;\n    }\n\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n\n    this.state = 'disconnected';\n    this.sessionId = null;\n    this.sessionInfo = null;\n  }\n\n  /**\n   * Schedule a reconnection attempt\n   */\n  private scheduleReconnect(): void {\n    if (this.reconnectTimeout) return;\n\n    const delay = this.config.reconnectDelay * Math.pow(2, this.reconnectAttempts);\n    const maxDelay = 30000; // 30 seconds max\n\n    this.reconnectTimeout = setTimeout(() => {\n      this.reconnectTimeout = null;\n      this.reconnectAttempts++;\n      this.connect().catch(() => {\n        // Error handled by onclose\n      });\n    }, Math.min(delay, maxDelay));\n  }\n\n  /**\n   * Handle incoming message\n   */\n  private handleMessage(data: string): void {\n    let message: TerminalMessage;\n\n    try {\n      message = JSON.parse(data);\n    } catch {\n      console.error('[lit-shell] Invalid message:', data);\n      return;\n    }\n\n    switch (message.type) {\n      case 'spawned':\n        this.sessionId = message.sessionId;\n        this.sessionInfo = {\n          sessionId: message.sessionId,\n          shell: message.shell,\n          cwd: message.cwd,\n          cols: message.cols,\n          rows: message.rows,\n          createdAt: new Date(),\n          container: message.container,\n        };\n        this.spawnedHandlers.forEach((handler) => handler(this.sessionInfo!));\n        if (this.spawnResolve) {\n          this.spawnResolve(this.sessionInfo);\n          this.spawnResolve = null;\n          this.spawnReject = null;\n        }\n        break;\n\n      case 'data':\n        this.dataHandlers.forEach((handler) => handler(message.data));\n        break;\n\n      case 'exit':\n        const exitCode = message.exitCode;\n        this.exitHandlers.forEach((handler) => handler(exitCode));\n        this.sessionId = null;\n        this.sessionInfo = null;\n        break;\n\n      case 'error':\n        const error = new Error(message.error);\n        this.errorHandlers.forEach((handler) => handler(error));\n        if (this.spawnReject) {\n          this.spawnReject(error);\n          this.spawnResolve = null;\n          this.spawnReject = null;\n        }\n        if (this.joinReject) {\n          this.joinReject(error);\n          this.joinResolve = null;\n          this.joinReject = null;\n        }\n        break;\n\n      case 'serverInfo':\n        this.serverInfo = message.info;\n        this.serverInfoHandlers.forEach((handler) => handler(message.info));\n        break;\n\n      case 'containerList':\n        this.containerListHandlers.forEach((handler) => handler(message.containers));\n        break;\n\n      // Session multiplexing messages\n      case 'sessionList':\n        this.sessionListHandlers.forEach((handler) =>\n          handler((message as any).sessions)\n        );\n        if (this.listSessionsResolve) {\n          this.listSessionsResolve((message as any).sessions);\n          this.listSessionsResolve = null;\n        }\n        break;\n\n      case 'joined':\n        const joinedSession = (message as any).session as SharedSessionInfo;\n        const history = (message as any).history as string | undefined;\n        this.sessionId = message.sessionId!;\n        this.sessionInfo = {\n          sessionId: joinedSession.sessionId,\n          shell: joinedSession.shell,\n          cwd: joinedSession.cwd,\n          cols: joinedSession.cols,\n          rows: joinedSession.rows,\n          createdAt: joinedSession.createdAt,\n          container: joinedSession.container,\n        };\n        this.joinedHandlers.forEach((handler) => handler(joinedSession, history));\n        if (this.joinResolve) {\n          this.joinResolve(joinedSession);\n          this.joinResolve = null;\n          this.joinReject = null;\n        }\n        break;\n\n      case 'left':\n        const leftSessionId = message.sessionId!;\n        if (this.sessionId === leftSessionId) {\n          this.sessionId = null;\n          this.sessionInfo = null;\n        }\n        this.leftHandlers.forEach((handler) => handler(leftSessionId));\n        break;\n\n      case 'clientJoined':\n        this.clientJoinedHandlers.forEach((handler) =>\n          handler(message.sessionId!, (message as any).clientCount)\n        );\n        break;\n\n      case 'clientLeft':\n        this.clientLeftHandlers.forEach((handler) =>\n          handler(message.sessionId!, (message as any).clientCount)\n        );\n        break;\n\n      case 'sessionClosed':\n        const closedSessionId = message.sessionId!;\n        const reason = (message as any).reason as string;\n        if (this.sessionId === closedSessionId) {\n          this.sessionId = null;\n          this.sessionInfo = null;\n        }\n        this.sessionClosedHandlers.forEach((handler) =>\n          handler(closedSessionId, reason)\n        );\n        break;\n    }\n  }\n\n  /**\n   * Spawn a terminal session\n   */\n  spawn(options: TerminalOptions = {}): Promise<SessionInfo> {\n    return new Promise((resolve, reject) => {\n      if (this.state !== 'connected' || !this.ws) {\n        reject(new Error('Not connected to server'));\n        return;\n      }\n\n      if (this.sessionId) {\n        reject(new Error('Session already active. Call kill() or leave() first.'));\n        return;\n      }\n\n      this.spawnResolve = resolve;\n      this.spawnReject = reject;\n\n      this.ws.send(\n        JSON.stringify({\n          type: 'spawn',\n          options,\n        })\n      );\n    });\n  }\n\n  /**\n   * Write data to the terminal\n   */\n  write(data: string): void {\n    if (!this.ws || this.state !== 'connected') {\n      console.error('[lit-shell] Cannot write: not connected');\n      return;\n    }\n\n    if (!this.sessionId) {\n      console.error('[lit-shell] Cannot write: no active session');\n      return;\n    }\n\n    this.ws.send(\n      JSON.stringify({\n        type: 'data',\n        sessionId: this.sessionId,\n        data,\n      })\n    );\n  }\n\n  /**\n   * Resize the terminal\n   */\n  resize(cols: number, rows: number): void {\n    if (!this.ws || this.state !== 'connected') {\n      console.error('[lit-shell] Cannot resize: not connected');\n      return;\n    }\n\n    if (!this.sessionId) {\n      console.error('[lit-shell] Cannot resize: no active session');\n      return;\n    }\n\n    this.ws.send(\n      JSON.stringify({\n        type: 'resize',\n        sessionId: this.sessionId,\n        cols,\n        rows,\n      })\n    );\n  }\n\n  /**\n   * Kill the terminal session (close and terminate)\n   */\n  kill(): void {\n    if (!this.ws || this.state !== 'connected') {\n      return;\n    }\n\n    if (!this.sessionId) {\n      return;\n    }\n\n    this.ws.send(\n      JSON.stringify({\n        type: 'close',\n        sessionId: this.sessionId,\n      })\n    );\n\n    this.sessionId = null;\n    this.sessionInfo = null;\n  }\n\n  // ==========================================\n  // Session Multiplexing Methods\n  // ==========================================\n\n  /**\n   * List available sessions\n   */\n  listSessions(filter?: SessionListFilter): Promise<SharedSessionInfo[]> {\n    return new Promise((resolve, reject) => {\n      if (this.state !== 'connected' || !this.ws) {\n        reject(new Error('Not connected to server'));\n        return;\n      }\n\n      this.listSessionsResolve = resolve;\n\n      this.ws.send(\n        JSON.stringify({\n          type: 'listSessions',\n          filter,\n        })\n      );\n    });\n  }\n\n  /**\n   * Join an existing session\n   */\n  join(options: JoinSessionOptions): Promise<SharedSessionInfo> {\n    return new Promise((resolve, reject) => {\n      if (this.state !== 'connected' || !this.ws) {\n        reject(new Error('Not connected to server'));\n        return;\n      }\n\n      if (this.sessionId) {\n        reject(new Error('Already in a session. Call leave() first.'));\n        return;\n      }\n\n      this.joinResolve = resolve;\n      this.joinReject = reject;\n\n      this.ws.send(\n        JSON.stringify({\n          type: 'join',\n          options,\n        })\n      );\n    });\n  }\n\n  /**\n   * Leave the current session without killing it\n   */\n  leave(sessionId?: string): void {\n    if (!this.ws || this.state !== 'connected') {\n      console.error('[lit-shell] Cannot leave: not connected');\n      return;\n    }\n\n    const targetSession = sessionId || this.sessionId;\n    if (!targetSession) {\n      console.error('[lit-shell] Cannot leave: no active session');\n      return;\n    }\n\n    this.ws.send(\n      JSON.stringify({\n        type: 'leave',\n        sessionId: targetSession,\n      })\n    );\n\n    if (targetSession === this.sessionId) {\n      this.sessionId = null;\n      this.sessionInfo = null;\n    }\n  }\n\n  /**\n   * Request session list and trigger onSessionList handlers\n   * (Fire-and-forget version of listSessions)\n   */\n  requestSessionList(filter?: SessionListFilter): void {\n    this.listSessions(filter)\n      .then((sessions) => {\n        this.sessionListHandlers.forEach((handler) => {\n          try {\n            handler(sessions);\n          } catch (e) {\n            console.error('[lit-shell] Error in sessionList handler:', e);\n          }\n        });\n      })\n      .catch((err) => {\n        console.error('[lit-shell] Failed to list sessions:', err);\n      });\n  }\n\n  // ==========================================\n  // Event handlers\n  // ==========================================\n\n  /**\n   * Called when connected to server\n   */\n  onConnect(handler: () => void): void {\n    this.connectHandlers.push(handler);\n  }\n\n  /**\n   * Called when disconnected from server\n   */\n  onDisconnect(handler: () => void): void {\n    this.disconnectHandlers.push(handler);\n  }\n\n  /**\n   * Called when data is received from the terminal\n   */\n  onData(handler: (data: string) => void): void {\n    this.dataHandlers.push(handler);\n  }\n\n  /**\n   * Called when the terminal session exits\n   */\n  onExit(handler: (code: number) => void): void {\n    this.exitHandlers.push(handler);\n  }\n\n  /**\n   * Called when an error occurs\n   */\n  onError(handler: (error: Error) => void): void {\n    this.errorHandlers.push(handler);\n  }\n\n  /**\n   * Called when a session is spawned\n   */\n  onSpawned(handler: (info: SessionInfo) => void): void {\n    this.spawnedHandlers.push(handler);\n  }\n\n  /**\n   * Called when server info is received\n   */\n  onServerInfo(handler: (info: ServerInfo) => void): void {\n    this.serverInfoHandlers.push(handler);\n    // If we already have server info, call immediately\n    if (this.serverInfo) {\n      handler(this.serverInfo);\n    }\n  }\n\n  /**\n   * Called when container list is received\n   */\n  onContainerList(handler: (containers: ContainerInfo[]) => void): void {\n    this.containerListHandlers.push(handler);\n  }\n\n  /**\n   * Called when session list is received\n   */\n  onSessionList(handler: (sessions: SharedSessionInfo[]) => void): void {\n    this.sessionListHandlers.push(handler);\n  }\n\n  /**\n   * Called when successfully joined a session\n   */\n  onJoined(handler: (session: SharedSessionInfo, history?: string) => void): void {\n    this.joinedHandlers.push(handler);\n  }\n\n  /**\n   * Called when left a session\n   */\n  onLeft(handler: (sessionId: string) => void): void {\n    this.leftHandlers.push(handler);\n  }\n\n  /**\n   * Called when another client joins the current session\n   */\n  onClientJoined(handler: (sessionId: string, clientCount: number) => void): void {\n    this.clientJoinedHandlers.push(handler);\n  }\n\n  /**\n   * Called when another client leaves the current session\n   */\n  onClientLeft(handler: (sessionId: string, clientCount: number) => void): void {\n    this.clientLeftHandlers.push(handler);\n  }\n\n  /**\n   * Called when the session is closed by owner or orphan timeout\n   */\n  onSessionClosed(handler: (sessionId: string, reason: string) => void): void {\n    this.sessionClosedHandlers.push(handler);\n  }\n\n  /**\n   * Request list of available containers\n   */\n  requestContainerList(): void {\n    if (!this.ws || this.state !== 'connected') {\n      console.error('[lit-shell] Cannot request containers: not connected');\n      return;\n    }\n\n    this.ws.send(JSON.stringify({ type: 'listContainers' }));\n  }\n\n  // ==========================================\n  // Getters\n  // ==========================================\n\n  /**\n   * Get current connection state\n   */\n  getState(): ConnectionState {\n    return this.state;\n  }\n\n  /**\n   * Check if connected\n   */\n  isConnected(): boolean {\n    return this.state === 'connected';\n  }\n\n  /**\n   * Get current session ID\n   */\n  getSessionId(): string | null {\n    return this.sessionId;\n  }\n\n  /**\n   * Get current session info\n   */\n  getSessionInfo(): SessionInfo | null {\n    return this.sessionInfo;\n  }\n\n  /**\n   * Check if a session is active\n   */\n  hasActiveSession(): boolean {\n    return this.sessionId !== null;\n  }\n\n  /**\n   * Get server info\n   */\n  getServerInfo(): ServerInfo | null {\n    return this.serverInfo;\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/client/index.d.ts

@@ -3,5 +3,5 @@
  */
 export { TerminalClient } from './terminal-client.js';
 export type { ConnectionState } from './terminal-client.js';
-export type { ClientConfig, TerminalOptions, SessionInfo, } from '../shared/types.js';
+export type { ClientConfig, TerminalOptions, SessionInfo, SharedSessionInfo, SessionType, SessionListFilter, JoinSessionOptions, } from '../shared/types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/client/terminal-client.d.ts

@@ -15,15 +15,21 @@
  * client.write('ls -la\n');
  * client.resize(120, 40);
  * client.kill();
+ *
+ * // Session multiplexing example
+ * const sessions = await client.listSessions();
+ * if (sessions.length > 0) {
+ *   await client.join({ sessionId: sessions[0].sessionId, requestHistory: true });
+ * }
  * ```
  */
-import type { ClientConfig, TerminalOptions, SessionInfo } from '../shared/types.js';
+import type { ClientConfig, TerminalOptions, SessionInfo, ContainerInfo, ServerInfo, SharedSessionInfo, SessionListFilter, JoinSessionOptions } from '../shared/types.js';
 /**
  * Connection state
  */
 export type ConnectionState = 'disconnected' | 'connecting' | 'connected';
 /**
- * Terminal client class
+ * Terminal client class with session multiplexing support
  */
 export declare class TerminalClient {
     private config;
@@ -31,6 +37,7 @@ export declare class TerminalClient {
     private state;
     private sessionId;
     private sessionInfo;
+    private serverInfo;
     private reconnectAttempts;
     private reconnectTimeout;
     private connectHandlers;
@@ -39,8 +46,19 @@ export declare class TerminalClient {
     private exitHandlers;
     private errorHandlers;
     private spawnedHandlers;
+    private serverInfoHandlers;
+    private containerListHandlers;
+    private sessionListHandlers;
+    private joinedHandlers;
+    private leftHandlers;
+    private clientJoinedHandlers;
+    private clientLeftHandlers;
+    private sessionClosedHandlers;
     private spawnResolve;
     private spawnReject;
+    private joinResolve;
+    private joinReject;
+    private listSessionsResolve;
     constructor(config: ClientConfig);
     /**
      * Connect to the terminal server
@@ -71,9 +89,26 @@ export declare class TerminalClient {
      */
     resize(cols: number, rows: number): void;
     /**
-     * Kill the terminal session
+     * Kill the terminal session (close and terminate)
      */
     kill(): void;
+    /**
+     * List available sessions
+     */
+    listSessions(filter?: SessionListFilter): Promise<SharedSessionInfo[]>;
+    /**
+     * Join an existing session
+     */
+    join(options: JoinSessionOptions): Promise<SharedSessionInfo>;
+    /**
+     * Leave the current session without killing it
+     */
+    leave(sessionId?: string): void;
+    /**
+     * Request session list and trigger onSessionList handlers
+     * (Fire-and-forget version of listSessions)
+     */
+    requestSessionList(filter?: SessionListFilter): void;
     /**
      * Called when connected to server
      */
@@ -98,6 +133,42 @@ export declare class TerminalClient {
      * Called when a session is spawned
      */
     onSpawned(handler: (info: SessionInfo) => void): void;
+    /**
+     * Called when server info is received
+     */
+    onServerInfo(handler: (info: ServerInfo) => void): void;
+    /**
+     * Called when container list is received
+     */
+    onContainerList(handler: (containers: ContainerInfo[]) => void): void;
+    /**
+     * Called when session list is received
+     */
+    onSessionList(handler: (sessions: SharedSessionInfo[]) => void): void;
+    /**
+     * Called when successfully joined a session
+     */
+    onJoined(handler: (session: SharedSessionInfo, history?: string) => void): void;
+    /**
+     * Called when left a session
+     */
+    onLeft(handler: (sessionId: string) => void): void;
+    /**
+     * Called when another client joins the current session
+     */
+    onClientJoined(handler: (sessionId: string, clientCount: number) => void): void;
+    /**
+     * Called when another client leaves the current session
+     */
+    onClientLeft(handler: (sessionId: string, clientCount: number) => void): void;
+    /**
+     * Called when the session is closed by owner or orphan timeout
+     */
+    onSessionClosed(handler: (sessionId: string, reason: string) => void): void;
+    /**
+     * Request list of available containers
+     */
+    requestContainerList(): void;
     /**
      * Get current connection state
      */
@@ -118,5 +189,9 @@ export declare class TerminalClient {
      * Check if a session is active
      */
     hasActiveSession(): boolean;
+    /**
+     * Get server info
+     */
+    getServerInfo(): ServerInfo | null;
 }
 //# sourceMappingURL=terminal-client.d.ts.map

package/dist/client/terminal-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-client.d.ts","sourceRoot":"","sources":["../../src/client/terminal-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAEf,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1E;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAA8C;IAGtE,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,eAAe,CAAuC;IAG9D,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAAyC;gBAEhD,MAAM,EAAE,YAAY;IAShC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAkBlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoDrB;;OAEG;IACH,KAAK,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwB1D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoBzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBxC;;OAEG;IACH,IAAI,IAAI,IAAI;IAwBZ;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI7C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAQrD;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,gBAAgB,IAAI,OAAO;CAG5B"}
+{"version":3,"file":"terminal-client.d.ts","sourceRoot":"","sources":["../../src/client/terminal-client.ts"],"names":[],"mappings":"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"}