npm - @wong2kim/wmux - Versions diffs - 1.0.0 - Mend

@wong2kim/wmux 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (122) hide show

package/README.md +157 -0
package/assets/icon.ico +0 -0
package/assets/icon.svg +6 -0
package/dist/cli/cli/client.js +102 -0
package/dist/cli/cli/commands/browser.js +137 -0
package/dist/cli/cli/commands/input.js +80 -0
package/dist/cli/cli/commands/notify.js +28 -0
package/dist/cli/cli/commands/pane.js +88 -0
package/dist/cli/cli/commands/surface.js +98 -0
package/dist/cli/cli/commands/system.js +98 -0
package/dist/cli/cli/commands/workspace.js +117 -0
package/dist/cli/cli/index.js +140 -0
package/dist/cli/cli/utils.js +47 -0
package/dist/cli/shared/constants.js +54 -0
package/dist/cli/shared/rpc.js +33 -0
package/dist/cli/shared/types.js +79 -0
package/dist/mcp/mcp/index.js +60 -0
package/dist/mcp/mcp/wmux-client.js +146 -0
package/dist/mcp/shared/constants.js +54 -0
package/dist/mcp/shared/rpc.js +33 -0
package/dist/mcp/shared/types.js +79 -0
package/forge.config.ts +61 -0
package/index.html +12 -0
package/package.json +84 -0
package/postcss.config.js +6 -0
package/src/cli/client.ts +76 -0
package/src/cli/commands/browser.ts +128 -0
package/src/cli/commands/input.ts +72 -0
package/src/cli/commands/notify.ts +29 -0
package/src/cli/commands/pane.ts +90 -0
package/src/cli/commands/surface.ts +102 -0
package/src/cli/commands/system.ts +95 -0
package/src/cli/commands/workspace.ts +116 -0
package/src/cli/index.ts +145 -0
package/src/cli/utils.ts +44 -0
package/src/main/index.ts +86 -0
package/src/main/ipc/handlers/clipboard.handler.ts +20 -0
package/src/main/ipc/handlers/metadata.handler.ts +56 -0
package/src/main/ipc/handlers/pty.handler.ts +69 -0
package/src/main/ipc/handlers/session.handler.ts +17 -0
package/src/main/ipc/handlers/shell.handler.ts +11 -0
package/src/main/ipc/registerHandlers.ts +31 -0
package/src/main/mcp/McpRegistrar.ts +156 -0
package/src/main/metadata/MetadataCollector.ts +58 -0
package/src/main/notification/ToastManager.ts +32 -0
package/src/main/pipe/PipeServer.ts +190 -0
package/src/main/pipe/RpcRouter.ts +46 -0
package/src/main/pipe/handlers/_bridge.ts +40 -0
package/src/main/pipe/handlers/browser.rpc.ts +132 -0
package/src/main/pipe/handlers/input.rpc.ts +120 -0
package/src/main/pipe/handlers/meta.rpc.ts +59 -0
package/src/main/pipe/handlers/notify.rpc.ts +53 -0
package/src/main/pipe/handlers/pane.rpc.ts +39 -0
package/src/main/pipe/handlers/surface.rpc.ts +43 -0
package/src/main/pipe/handlers/system.rpc.ts +36 -0
package/src/main/pipe/handlers/workspace.rpc.ts +52 -0
package/src/main/pty/AgentDetector.ts +247 -0
package/src/main/pty/OscParser.ts +81 -0
package/src/main/pty/PTYBridge.ts +88 -0
package/src/main/pty/PTYManager.ts +104 -0
package/src/main/pty/ShellDetector.ts +63 -0
package/src/main/session/SessionManager.ts +53 -0
package/src/main/updater/AutoUpdater.ts +132 -0
package/src/main/window/createWindow.ts +71 -0
package/src/mcp/README.md +56 -0
package/src/mcp/index.ts +153 -0
package/src/mcp/wmux-client.ts +127 -0
package/src/preload/index.ts +111 -0
package/src/preload/preload.ts +108 -0
package/src/renderer/App.tsx +5 -0
package/src/renderer/components/Browser/BrowserPanel.tsx +219 -0
package/src/renderer/components/Browser/BrowserToolbar.tsx +253 -0
package/src/renderer/components/Company/ApprovalDialog.tsx +3 -0
package/src/renderer/components/Company/CompanyView.tsx +7 -0
package/src/renderer/components/Company/MessageFeedPanel.tsx +3 -0
package/src/renderer/components/Layout/AppLayout.tsx +234 -0
package/src/renderer/components/Notification/NotificationPanel.tsx +129 -0
package/src/renderer/components/Palette/CommandPalette.tsx +409 -0
package/src/renderer/components/Palette/PaletteItem.tsx +55 -0
package/src/renderer/components/Pane/Pane.tsx +122 -0
package/src/renderer/components/Pane/PaneContainer.tsx +41 -0
package/src/renderer/components/Pane/SurfaceTabs.tsx +46 -0
package/src/renderer/components/Settings/SettingsPanel.tsx +886 -0
package/src/renderer/components/Sidebar/MiniSidebar.tsx +67 -0
package/src/renderer/components/Sidebar/Sidebar.tsx +84 -0
package/src/renderer/components/Sidebar/WorkspaceItem.tsx +241 -0
package/src/renderer/components/StatusBar/StatusBar.tsx +93 -0
package/src/renderer/components/Terminal/SearchBar.tsx +126 -0
package/src/renderer/components/Terminal/Terminal.tsx +102 -0
package/src/renderer/components/Terminal/ViCopyMode.tsx +104 -0
package/src/renderer/hooks/useKeyboard.ts +310 -0
package/src/renderer/hooks/useNotificationListener.ts +80 -0
package/src/renderer/hooks/useNotificationSound.ts +75 -0
package/src/renderer/hooks/useRpcBridge.ts +451 -0
package/src/renderer/hooks/useT.ts +11 -0
package/src/renderer/hooks/useTerminal.ts +349 -0
package/src/renderer/hooks/useViCopyMode.ts +320 -0
package/src/renderer/i18n/index.ts +69 -0
package/src/renderer/i18n/locales/en.ts +157 -0
package/src/renderer/i18n/locales/ja.ts +155 -0
package/src/renderer/i18n/locales/ko.ts +155 -0
package/src/renderer/i18n/locales/zh.ts +155 -0
package/src/renderer/index.tsx +6 -0
package/src/renderer/stores/index.ts +19 -0
package/src/renderer/stores/slices/notificationSlice.ts +56 -0
package/src/renderer/stores/slices/paneSlice.ts +141 -0
package/src/renderer/stores/slices/surfaceSlice.ts +122 -0
package/src/renderer/stores/slices/uiSlice.ts +247 -0
package/src/renderer/stores/slices/workspaceSlice.ts +120 -0
package/src/renderer/styles/globals.css +150 -0
package/src/renderer/themes.ts +99 -0
package/src/shared/constants.ts +53 -0
package/src/shared/electron.d.ts +11 -0
package/src/shared/rpc.ts +71 -0
package/src/shared/types.ts +176 -0
package/tailwind.config.js +11 -0
package/tsconfig.cli.json +24 -0
package/tsconfig.json +21 -0
package/tsconfig.mcp.json +25 -0
package/vite.main.config.ts +14 -0
package/vite.preload.config.ts +9 -0
package/vite.renderer.config.ts +6 -0

package/src/cli/index.ts ADDED Viewed

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+process.on('SIGINT', () => {
+  process.exit(130);
+});
+import { hasFlag } from './utils';
+import { handleWorkspace } from './commands/workspace';
+import { handleSurface } from './commands/surface';
+import { handlePane } from './commands/pane';
+import { handleInput } from './commands/input';
+import { handleNotify } from './commands/notify';
+import { handleSystem } from './commands/system';
+import { handleBrowser } from './commands/browser';
+const HELP_TEXT = `
+wmux CLI
+USAGE
+  wmux <command> [options]
+WORKSPACE COMMANDS
+  list-workspaces                   List all workspaces
+  new-workspace [--name <name>]     Create a new workspace
+  focus-workspace <id>              Focus a workspace by ID
+  close-workspace <id>              Close a workspace by ID
+  current-workspace                 Show the active workspace
+SURFACE COMMANDS
+  list-surfaces                     List all surfaces in the active workspace
+  new-surface                       Open a new surface (terminal tab)
+  focus-surface <id>                Focus a surface by ID
+  close-surface <id>                Close a surface by ID
+PANE COMMANDS
+  list-panes                        List all panes in the active workspace
+  focus-pane <id>                   Focus a pane by ID
+  split [--direction right|down]    Split the active pane (default: right)
+INPUT COMMANDS
+  send <text>                       Send text to the active terminal
+  send-key <keystroke>              Send a key (e.g. Enter, ctrl-c, Tab)
+  read-screen                       Read the current terminal screen content
+NOTIFICATION COMMANDS
+  notify --title <title> --body <body>   Show a notification in wmux
+SYSTEM COMMANDS
+  set-status <text>                 Set a status message on the active workspace
+  set-progress <0-100>              Set a progress value on the active workspace
+  identify                          Show wmux app info
+  capabilities                      List all supported RPC methods
+BROWSER COMMANDS
+  browser snapshot                  Return the full page HTML of the active browser surface
+  browser click <selector>          Click an element by CSS selector
+  browser fill <selector> <text>    Fill an input field by CSS selector
+  browser eval <code>               Execute JavaScript in the browser context
+  browser navigate <url>            Navigate the browser surface to a URL
+GLOBAL FLAGS
+  --json      Output raw JSON (useful for scripting)
+  --help      Show this help text
+EXAMPLES
+  wmux list-workspaces
+  wmux new-workspace --name dev
+  wmux send "echo hello"
+  wmux notify --title "Done" --body "Build finished"
+  wmux identify --json
+  wmux browser snapshot
+  wmux browser navigate "https://example.com"
+  wmux browser click "#login-btn"
+`.trimStart();
+const WORKSPACE_CMDS = new Set([
+  'list-workspaces',
+  'new-workspace',
+  'focus-workspace',
+  'close-workspace',
+  'current-workspace',
+]);
+const SURFACE_CMDS = new Set([
+  'list-surfaces',
+  'new-surface',
+  'focus-surface',
+  'close-surface',
+]);
+const PANE_CMDS = new Set(['list-panes', 'focus-pane', 'split']);
+const INPUT_CMDS = new Set(['send', 'send-key', 'read-screen']);
+const SYSTEM_CMDS = new Set([
+  'identify',
+  'capabilities',
+  'set-status',
+  'set-progress',
+]);
+async function main(): Promise<void> {
+  // process.argv = ['node', 'index.js', ...userArgs]
+  const argv = process.argv.slice(2);
+  if (argv.length === 0 || hasFlag(argv, '--help') || hasFlag(argv, '-h')) {
+    process.stdout.write(HELP_TEXT);
+    process.exit(0);
+  }
+  const jsonMode = hasFlag(argv, '--json');
+  // Strip global flags so commands see clean args
+  const args = argv.filter((a) => a !== '--json' && a !== '--help' && a !== '-h');
+  const cmd = args[0];
+  const rest = args.slice(1);
+  try {
+    if (WORKSPACE_CMDS.has(cmd)) {
+      await handleWorkspace(cmd, rest, jsonMode);
+    } else if (SURFACE_CMDS.has(cmd)) {
+      await handleSurface(cmd, rest, jsonMode);
+    } else if (PANE_CMDS.has(cmd)) {
+      await handlePane(cmd, rest, jsonMode);
+    } else if (INPUT_CMDS.has(cmd)) {
+      await handleInput(cmd, rest, jsonMode);
+    } else if (cmd === 'notify') {
+      await handleNotify(rest, jsonMode);
+    } else if (SYSTEM_CMDS.has(cmd)) {
+      await handleSystem(cmd, rest, jsonMode);
+    } else if (cmd === 'browser') {
+      await handleBrowser(rest, jsonMode);
+    } else {
+      console.error(`Unknown command: "${cmd}". Run 'wmux --help' for usage.`);
+      process.exit(1);
+    }
+  } catch (err: unknown) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(message);
+    process.exit(1);
+  }
+}
+main();

package/src/cli/utils.ts ADDED Viewed

@@ -0,0 +1,44 @@
+import type { RpcResponse } from '../shared/rpc';
+/**
+ * Print the result field of a successful RPC response as JSON.
+ * If the response contains an error, the error is printed to stderr and
+ * the process exits with code 1.
+ */
+export function printResult(response: RpcResponse): void {
+  if (!response.ok) {
+    printError(response);
+    return;
+  }
+  console.log(JSON.stringify(response.result, null, 2));
+}
+/**
+ * Print the error field of a failed RPC response to stderr and exit with 1.
+ */
+export function printError(response: RpcResponse): void {
+  const msg = !response.ok ? response.error : 'Unknown error from wmux';
+  console.error(`Error: ${msg}`);
+  process.exit(1);
+}
+/**
+ * Parse a named flag value from an argv array.
+ * e.g. parseFlag(['--name', 'dev'], '--name') => 'dev'
+ * Returns undefined when the flag is not present.
+ */
+export function parseFlag(args: string[], flag: string): string | undefined {
+  const idx = args.indexOf(flag);
+  if (idx === -1) return undefined;
+  const value = args[idx + 1];
+  if (value === undefined || value.startsWith('-')) return undefined;
+  return value;
+}
+/**
+ * Check whether a bare flag is present in argv.
+ * e.g. hasFlag(['--json', 'identify'], '--json') => true
+ */
+export function hasFlag(args: string[], flag: string): boolean {
+  return args.includes(flag);
+}

package/src/main/index.ts ADDED Viewed

@@ -0,0 +1,86 @@
+process.on('unhandledRejection', (reason) => {
+  console.error('[Main] Unhandled rejection:', reason);
+});
+process.on('uncaughtException', (err) => {
+  console.error('[Main] Uncaught exception:', err);
+});
+import { app, BrowserWindow } from 'electron';
+import started from 'electron-squirrel-startup';
+import { createWindow } from './window/createWindow';
+import { PTYManager } from './pty/PTYManager';
+import { PTYBridge } from './pty/PTYBridge';
+import { registerAllHandlers } from './ipc/registerHandlers';
+import { RpcRouter } from './pipe/RpcRouter';
+import { PipeServer } from './pipe/PipeServer';
+import { registerWorkspaceRpc } from './pipe/handlers/workspace.rpc';
+import { registerSurfaceRpc } from './pipe/handlers/surface.rpc';
+import { registerPaneRpc } from './pipe/handlers/pane.rpc';
+import { registerInputRpc } from './pipe/handlers/input.rpc';
+import { registerNotifyRpc } from './pipe/handlers/notify.rpc';
+import { registerMetaRpc } from './pipe/handlers/meta.rpc';
+import { registerSystemRpc } from './pipe/handlers/system.rpc';
+import { registerBrowserRpc } from './pipe/handlers/browser.rpc';
+import { AutoUpdater } from './updater/AutoUpdater';
+import { McpRegistrar } from './mcp/McpRegistrar';
+if (started) {
+  app.quit();
+}
+const ptyManager = new PTYManager();
+let mainWindow: BrowserWindow | null = null;
+const ptyBridge = new PTYBridge(ptyManager, () => mainWindow);
+const autoUpdater = new AutoUpdater(() => mainWindow);
+const rpcRouter = new RpcRouter();
+const pipeServer = new PipeServer(rpcRouter);
+const mcpRegistrar = new McpRegistrar();
+const cleanupHandlers = registerAllHandlers(ptyManager, ptyBridge, () => mainWindow);
+registerWorkspaceRpc(rpcRouter, () => mainWindow);
+registerSurfaceRpc(rpcRouter, () => mainWindow);
+registerPaneRpc(rpcRouter, () => mainWindow);
+registerInputRpc(rpcRouter, ptyManager, () => mainWindow);
+registerNotifyRpc(rpcRouter, () => mainWindow);
+registerMetaRpc(rpcRouter, () => mainWindow);
+registerSystemRpc(rpcRouter);
+registerBrowserRpc(rpcRouter, () => mainWindow);
+app.on('ready', () => {
+  console.log('[Main] App ready, creating window...');
+  mainWindow = createWindow();
+  console.log('[Main] Window created:', !!mainWindow);
+  mainWindow.on('closed', () => {
+    mainWindow = null;
+  });
+  mainWindow.webContents.on('did-fail-load', (_e, code, desc) => {
+    console.error('[Main] Page failed to load:', code, desc);
+  });
+  mainWindow.webContents.on('did-finish-load', () => {
+    console.log('[Main] Page loaded successfully');
+  });
+  pipeServer.start();
+  const authToken = pipeServer.getAuthToken();
+  ptyManager.setAuthToken(authToken);
+  mcpRegistrar.register(authToken);
+  autoUpdater.start();
+});
+app.on('window-all-closed', () => {
+  app.quit();
+});
+app.on('before-quit', () => {
+  cleanupHandlers();
+  ptyManager.disposeAll();
+  pipeServer.stop();
+  mcpRegistrar.unregister();
+  autoUpdater.stop();
+});
+app.on('activate', () => {
+  if (BrowserWindow.getAllWindows().length === 0) {
+    mainWindow = createWindow();
+  }
+});

package/src/main/ipc/handlers/clipboard.handler.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import { ipcMain, clipboard } from 'electron';
+import { IPC } from '../../../shared/constants';
+export function registerClipboardHandlers(): void {
+  // Remove any previously registered handlers before re-registering.
+  // ipcMain.handle() throws if the same channel is registered twice (e.g.
+  // during dev HMR reloads), which silently kills clipboard IPC.
+  ipcMain.removeHandler(IPC.CLIPBOARD_WRITE);
+  ipcMain.removeHandler(IPC.CLIPBOARD_READ);
+  ipcMain.handle(IPC.CLIPBOARD_WRITE, (_event, text: string) => {
+    if (typeof text !== 'string') return;
+    if (text.length > 1_000_000) return; // 1MB limit
+    clipboard.writeText(text);
+  });
+  ipcMain.handle(IPC.CLIPBOARD_READ, () => {
+    return clipboard.readText();
+  });
+}

package/src/main/ipc/handlers/metadata.handler.ts ADDED Viewed

@@ -0,0 +1,56 @@
+import { ipcMain, BrowserWindow } from 'electron';
+import { IPC } from '../../../shared/constants';
+import { MetadataCollector } from '../../metadata/MetadataCollector';
+import { PTYManager } from '../../pty/PTYManager';
+const collector = new MetadataCollector();
+// Track CWD per ptyId (updated via OSC 7 or polling)
+const cwdMap = new Map<string, string>();
+export function registerMetadataHandlers(
+  ptyManager: PTYManager,
+  getWindow: () => BrowserWindow | null,
+): () => void {
+  // Handle metadata request from renderer
+  ipcMain.handle(IPC.METADATA_REQUEST, async (_event, ptyId: string) => {
+    const cwd = cwdMap.get(ptyId);
+    return collector.collect(cwd);
+  });
+  // Listen for CWD changes from PTYBridge (via OscParser)
+  ipcMain.on(IPC.CWD_CHANGED, (_event, ptyId: string, cwd: string) => {
+    cwdMap.set(ptyId, cwd);
+  });
+  // Periodic metadata polling (every 5 seconds)
+  const pollingInterval = setInterval(async () => {
+    const win = getWindow();
+    if (!win || win.isDestroyed()) return;
+    for (const [ptyId] of cwdMap) {
+      const instance = ptyManager.get(ptyId);
+      if (!instance) {
+        cwdMap.delete(ptyId);
+        continue;
+      }
+      const cwd = cwdMap.get(ptyId);
+      if (cwd) {
+        const metadata = await collector.collect(cwd);
+        win.webContents.send(IPC.METADATA_UPDATE, ptyId, metadata);
+      }
+    }
+  }, 5000);
+  // cleanup 함수 반환 — 앱 종료 시 호출
+  return () => {
+    clearInterval(pollingInterval);
+    ipcMain.removeHandler(IPC.METADATA_REQUEST);
+    ipcMain.removeAllListeners(IPC.CWD_CHANGED);
+  };
+}
+export function updateCwd(ptyId: string, cwd: string): void {
+  cwdMap.set(ptyId, cwd);
+}

package/src/main/ipc/handlers/pty.handler.ts ADDED Viewed

@@ -0,0 +1,69 @@
+import { ipcMain } from 'electron';
+import fs from 'node:fs';
+import path from 'node:path';
+import { PTYManager } from '../../pty/PTYManager';
+import { PTYBridge } from '../../pty/PTYBridge';
+import { IPC } from '../../../shared/constants';
+/**
+ * Allowed shell basenames (case-insensitive on Windows).
+ * Only these executables may be spawned via IPC.
+ */
+const ALLOWED_SHELLS = new Set([
+  'powershell.exe',
+  'pwsh.exe',
+  'cmd.exe',
+  'bash.exe',
+  'wsl.exe',
+  'git-bash.exe',
+  'sh.exe',
+]);
+function isAllowedShell(shell: string): boolean {
+  const basename = path.basename(shell).toLowerCase();
+  return ALLOWED_SHELLS.has(basename);
+}
+export function registerPTYHandlers(ptyManager: PTYManager, ptyBridge: PTYBridge): void {
+  ipcMain.handle(IPC.PTY_CREATE, (_event, options?: { shell?: string; cwd?: string; cols?: number; rows?: number }) => {
+    if (options?.shell !== undefined && !isAllowedShell(options.shell)) {
+      throw new Error(`PTY_CREATE: shell not allowed: ${options.shell}`);
+    }
+    // Validate workDir to block UNC paths and non-existent directories
+    let safeCwd: string | undefined;
+    if (options?.cwd) {
+      const resolved = path.resolve(options.cwd);
+      // Block UNC paths (e.g. \\server\share)
+      if (!resolved.startsWith('\\\\') && fs.existsSync(resolved)) {
+        const stat = fs.statSync(resolved);
+        if (stat.isDirectory()) {
+          safeCwd = resolved;
+        }
+      }
+    }
+    const instance = ptyManager.create(safeCwd !== undefined ? { ...options, cwd: safeCwd } : { ...options, cwd: undefined });
+    ptyBridge.setupDataForwarding(instance.id);
+    return { id: instance.id, shell: instance.shell };
+  });
+  ipcMain.handle(IPC.PTY_WRITE, (_event, id: string, data: string) => {
+    // 세션 복원 시 이전 ptyId가 남아있을 수 있음 — 조용히 무시
+    if (!ptyManager.get(id)) return;
+    if (typeof data !== 'string') return;
+    if (data.length > 100_000) return; // prevent mega-writes
+    ptyManager.write(id, data);
+  });
+  ipcMain.handle(IPC.PTY_RESIZE, (_event, id: string, cols: number, rows: number) => {
+    if (!Number.isInteger(cols) || cols <= 0 || !Number.isInteger(rows) || rows <= 0) {
+      throw new Error(`PTY_RESIZE: cols and rows must be positive integers (got cols=${cols}, rows=${rows})`);
+    }
+    ptyManager.resize(id, cols, rows);
+  });
+  ipcMain.handle(IPC.PTY_DISPOSE, (_event, id: string) => {
+    ptyManager.dispose(id);
+  });
+}

package/src/main/ipc/handlers/session.handler.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import { ipcMain } from 'electron';
+import { IPC } from '../../../shared/constants';
+import { SessionManager } from '../../session/SessionManager';
+import type { SessionData } from '../../../shared/types';
+const sessionManager = new SessionManager();
+export function registerSessionHandlers(): void {
+  ipcMain.handle(IPC.SESSION_SAVE, (_event, data: SessionData) => {
+    sessionManager.save(data);
+    return { success: true };
+  });
+  ipcMain.handle(IPC.SESSION_LOAD, () => {
+    return sessionManager.load();
+  });
+}

package/src/main/ipc/handlers/shell.handler.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import { ipcMain } from 'electron';
+import { ShellDetector } from '../../pty/ShellDetector';
+import { IPC } from '../../../shared/constants';
+export function registerShellHandlers(): void {
+  const detector = new ShellDetector();
+  ipcMain.handle(IPC.SHELL_LIST, () => {
+    return detector.detect();
+  });
+}

package/src/main/ipc/registerHandlers.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { ipcMain, type BrowserWindow } from 'electron';
+import { PTYManager } from '../pty/PTYManager';
+import { PTYBridge } from '../pty/PTYBridge';
+import { registerPTYHandlers } from './handlers/pty.handler';
+import { registerSessionHandlers } from './handlers/session.handler';
+import { registerShellHandlers } from './handlers/shell.handler';
+import { registerMetadataHandlers } from './handlers/metadata.handler';
+import { registerClipboardHandlers } from './handlers/clipboard.handler';
+import { IPC } from '../../shared/constants';
+import { toastManager } from '../pipe/handlers/notify.rpc';
+export function registerAllHandlers(
+  ptyManager: PTYManager,
+  ptyBridge: PTYBridge,
+  getWindow: () => BrowserWindow | null,
+): () => void {
+  registerPTYHandlers(ptyManager, ptyBridge);
+  registerSessionHandlers();
+  registerShellHandlers();
+  const cleanupMetadata = registerMetadataHandlers(ptyManager, getWindow);
+  registerClipboardHandlers();
+  // Sync toast setting from renderer
+  ipcMain.on(IPC.TOAST_ENABLED, (_event, enabled: boolean) => {
+    toastManager.enabled = enabled;
+  });
+  return () => {
+    cleanupMetadata();
+  };
+}

package/src/main/mcp/McpRegistrar.ts ADDED Viewed

@@ -0,0 +1,156 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { app } from 'electron';
+import { getAuthTokenPath } from '../../shared/constants';
+/**
+ * Registers/unregisters the wmux MCP server in Claude Code's config files
+ * and writes the auth token to a well-known file so the MCP server can read it.
+ *
+ * The MCP server uses:
+ *   - Fixed pipe path: \\.\pipe\wmux  (from shared/constants)
+ *   - Auth token file: ~/.wmux-auth-token (written here, read by MCP)
+ *
+ * Config files written:
+ *   1. ~/.claude/settings.json   (global settings — mcpServers key)
+ *   2. ~/.claude/.mcp.json       (user-level MCP config)
+ */
+export class McpRegistrar {
+  private readonly settingsPath: string;
+  private readonly mcpJsonPath: string;
+  private readonly authTokenPath: string;
+  private registered = false;
+  constructor() {
+    const home = app.getPath('home');
+    this.settingsPath = path.join(home, '.claude', 'settings.json');
+    this.mcpJsonPath = path.join(home, '.claude', '.mcp.json');
+    this.authTokenPath = getAuthTokenPath();
+  }
+  /**
+   * Write auth token to file and register MCP server in Claude Code configs.
+   * Must be called after PipeServer.start().
+   */
+  register(authToken: string): void {
+    try {
+      // Write auth token to file so MCP server can read it
+      fs.writeFileSync(this.authTokenPath, authToken, { encoding: 'utf8', mode: 0o600 });
+      console.log(`[McpRegistrar] Auth token written to ${this.authTokenPath}`);
+      const mcpScript = this.getMcpScriptPath();
+      if (!mcpScript) {
+        console.warn('[McpRegistrar] Could not determine MCP script path — skipping registration.');
+        return;
+      }
+      // Use absolute node path to avoid PATH resolution issues
+      const mcpEntry = {
+        command: process.execPath,
+        args: [mcpScript],
+      };
+      this.registerInSettings(mcpEntry);
+      this.registerInMcpJson(mcpEntry);
+      this.registered = true;
+      console.log(`[McpRegistrar] Registered wmux MCP → ${mcpScript}`);
+    } catch (err) {
+      console.error('[McpRegistrar] Failed to register:', err);
+    }
+  }
+  /**
+   * Remove wmux MCP server entry and auth token file.
+   */
+  unregister(): void {
+    // Always clean up auth token file
+    try {
+      if (fs.existsSync(this.authTokenPath)) {
+        fs.unlinkSync(this.authTokenPath);
+      }
+    } catch { /* ignore */ }
+    if (!this.registered) return;
+    try {
+      this.unregisterFromSettings();
+      this.unregisterFromMcpJson();
+      console.log('[McpRegistrar] Unregistered wmux MCP.');
+    } catch (err) {
+      console.error('[McpRegistrar] Failed to unregister:', err);
+    }
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private registerInSettings(mcpEntry: Record<string, any>): void {
+    const settings = this.readJson(this.settingsPath);
+    if (!settings.mcpServers) settings.mcpServers = {};
+    settings.mcpServers['wmux'] = mcpEntry;
+    this.writeJson(this.settingsPath, settings);
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private registerInMcpJson(mcpEntry: Record<string, any>): void {
+    const mcpConfig = this.readJson(this.mcpJsonPath);
+    if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
+    mcpConfig.mcpServers['wmux'] = mcpEntry;
+    this.writeJson(this.mcpJsonPath, mcpConfig);
+  }
+  private unregisterFromSettings(): void {
+    const settings = this.readJson(this.settingsPath);
+    if (settings.mcpServers?.['wmux']) {
+      delete settings.mcpServers['wmux'];
+      if (Object.keys(settings.mcpServers).length === 0) delete settings.mcpServers;
+      this.writeJson(this.settingsPath, settings);
+    }
+  }
+  private unregisterFromMcpJson(): void {
+    const mcpConfig = this.readJson(this.mcpJsonPath);
+    if (mcpConfig.mcpServers?.['wmux']) {
+      delete mcpConfig.mcpServers['wmux'];
+      if (Object.keys(mcpConfig.mcpServers).length === 0) delete mcpConfig.mcpServers;
+      if (Object.keys(mcpConfig).length === 0) {
+        try { fs.unlinkSync(this.mcpJsonPath); } catch { /* ignore */ }
+      } else {
+        this.writeJson(this.mcpJsonPath, mcpConfig);
+      }
+    }
+  }
+  private getMcpScriptPath(): string | null {
+    if (app.isPackaged) {
+      const resourcePath = path.join(process.resourcesPath, 'mcp', 'mcp', 'index.js');
+      if (fs.existsSync(resourcePath)) return resourcePath;
+      return null;
+    }
+    const appPath = app.getAppPath();
+    const devPath = path.join(appPath, 'dist', 'mcp', 'mcp', 'index.js');
+    if (fs.existsSync(devPath)) return devPath;
+    return null;
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private readJson(filePath: string): Record<string, any> {
+    try {
+      if (fs.existsSync(filePath)) {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+      }
+    } catch { /* corrupted — start fresh */ }
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    return {};
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private writeJson(filePath: string, data: Record<string, any>): void {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
+  }
+}