@wong2kim/wmux 1.0.0 → 1.0.1

package/src/cli/commands/pane.ts

@@ -1,90 +0,0 @@
-import { sendRequest } from '../client';
-import { printResult, printError, parseFlag } from '../utils';
-import type { RpcResponse } from '../../shared/rpc';
-
-interface PaneInfo {
-  id: string;
-  type: 'leaf' | 'branch';
-  direction?: string;
-  activeSurfaceId?: string;
-}
-
-function formatPaneList(result: unknown): void {
-  const list = result as PaneInfo[];
-  if (!Array.isArray(list) || list.length === 0) {
-    console.log('No panes found.');
-    return;
-  }
-  const maxId = Math.max(...list.map((p) => p.id.length));
-  console.log('ID'.padEnd(maxId + 2) + 'TYPE'.padEnd(8) + 'DETAILS');
-  console.log('-'.repeat(maxId + 30));
-  for (const p of list) {
-    let details = '';
-    if (p.type === 'leaf' && p.activeSurfaceId) {
-      details = `active surface: ${p.activeSurfaceId}`;
-    } else if (p.type === 'branch' && p.direction) {
-      details = `direction: ${p.direction}`;
-    }
-    console.log(p.id.padEnd(maxId + 2) + p.type.padEnd(8) + details);
-  }
-}
-
-export async function handlePane(
-  cmd: string,
-  args: string[],
-  jsonMode: boolean
-): Promise<void> {
-  let response: RpcResponse;
-
-  switch (cmd) {
-    case 'list-panes': {
-      response = await sendRequest('pane.list', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        formatPaneList(response.result);
-      }
-      break;
-    }
-
-    case 'focus-pane': {
-      const id = args[0];
-      if (!id) {
-        console.error('Error: focus-pane requires <id>');
-        process.exit(1);
-      }
-      response = await sendRequest('pane.focus', { id });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Focused pane: ${id}`);
-      }
-      break;
-    }
-
-    case 'split': {
-      const direction = parseFlag(args, '--direction') ?? 'right';
-      if (direction !== 'right' && direction !== 'down') {
-        console.error('Error: --direction must be "right" or "down"');
-        process.exit(1);
-      }
-      // right → horizontal, down → vertical (server expects horizontal/vertical)
-      const dirMap: Record<string, string> = { right: 'horizontal', down: 'vertical' };
-      const mapped = dirMap[direction] || direction;
-      response = await sendRequest('pane.split', { direction: mapped });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Split pane ${direction}.`);
-      }
-      break;
-    }
-
-    default:
-      console.error(`Unknown pane command: ${cmd}`);
-      process.exit(1);
-  }
-}

package/src/cli/commands/surface.ts

@@ -1,102 +0,0 @@
-import { sendRequest } from '../client';
-import { printResult, printError } from '../utils';
-import type { RpcResponse } from '../../shared/rpc';
-
-interface SurfaceInfo {
-  id: string;
-  title: string;
-  shell: string;
-  cwd: string;
-}
-
-function formatSurfaceList(result: unknown): void {
-  const list = result as SurfaceInfo[];
-  if (!Array.isArray(list) || list.length === 0) {
-    console.log('No surfaces found.');
-    return;
-  }
-  const maxId = Math.max(...list.map((s) => s.id.length));
-  const maxTitle = Math.max(...list.map((s) => (s.title ?? '').length), 5);
-  console.log(
-    'ID'.padEnd(maxId + 2) +
-    'TITLE'.padEnd(maxTitle + 2) +
-    'SHELL'
-  );
-  console.log('-'.repeat(maxId + maxTitle + 20));
-  for (const s of list) {
-    console.log(
-      s.id.padEnd(maxId + 2) +
-      (s.title ?? '').padEnd(maxTitle + 2) +
-      (s.shell ?? '')
-    );
-  }
-}
-
-export async function handleSurface(
-  cmd: string,
-  args: string[],
-  jsonMode: boolean
-): Promise<void> {
-  let response: RpcResponse;
-
-  switch (cmd) {
-    case 'list-surfaces': {
-      response = await sendRequest('surface.list', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        formatSurfaceList(response.result);
-      }
-      break;
-    }
-
-    case 'new-surface': {
-      response = await sendRequest('surface.new', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        const s = response.result as SurfaceInfo;
-        console.log(`Created surface: ${s?.id ?? '(unknown)'}`);
-      }
-      break;
-    }
-
-    case 'focus-surface': {
-      const id = args[0];
-      if (!id) {
-        console.error('Error: focus-surface requires <id>');
-        process.exit(1);
-      }
-      response = await sendRequest('surface.focus', { id });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Focused surface: ${id}`);
-      }
-      break;
-    }
-
-    case 'close-surface': {
-      const id = args[0];
-      if (!id) {
-        console.error('Error: close-surface requires <id>');
-        process.exit(1);
-      }
-      response = await sendRequest('surface.close', { id });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Closed surface: ${id}`);
-      }
-      break;
-    }
-
-    default:
-      console.error(`Unknown surface command: ${cmd}`);
-      process.exit(1);
-  }
-}

package/src/cli/commands/system.ts

@@ -1,95 +0,0 @@
-import { sendRequest } from '../client';
-import { printResult, printError } from '../utils';
-import type { RpcResponse } from '../../shared/rpc';
-
-interface IdentifyResult {
-  app: string;
-  version: string;
-  platform: string;
-}
-
-export async function handleSystem(
-  cmd: string,
-  args: string[],
-  jsonMode: boolean
-): Promise<void> {
-  let response: RpcResponse;
-
-  switch (cmd) {
-    case 'identify': {
-      response = await sendRequest('system.identify', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        const info = response.result as IdentifyResult;
-        console.log(`app:      ${info?.app ?? 'wmux'}`);
-        console.log(`version:  ${info?.version ?? '1.0.0'}`);
-        console.log(`platform: ${info?.platform ?? process.platform}`);
-      }
-      break;
-    }
-
-    case 'capabilities': {
-      response = await sendRequest('system.capabilities', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        // server may return { methods: string[] } or string[] directly
-        const result = response.result as { methods?: string[] } | string[];
-        const methods = Array.isArray(result) ? result : (result?.methods || []);
-        if (methods.length > 0) {
-          console.log('Supported RPC methods:');
-          for (const m of methods) {
-            console.log(`  ${m}`);
-          }
-        } else {
-          console.log(JSON.stringify(response.result, null, 2));
-        }
-      }
-      break;
-    }
-
-    case 'set-status': {
-      const text = args[0];
-      if (text === undefined) {
-        console.error('Error: set-status requires <text>');
-        process.exit(1);
-      }
-      response = await sendRequest('meta.setStatus', { text });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Status set: "${text}"`);
-      }
-      break;
-    }
-
-    case 'set-progress': {
-      const raw = args[0];
-      if (raw === undefined) {
-        console.error('Error: set-progress requires <0-100>');
-        process.exit(1);
-      }
-      const value = Number(raw);
-      if (isNaN(value) || value < 0 || value > 100) {
-        console.error('Error: progress value must be a number between 0 and 100');
-        process.exit(1);
-      }
-      response = await sendRequest('meta.setProgress', { value });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Progress set: ${value}%`);
-      }
-      break;
-    }
-
-    default:
-      console.error(`Unknown system command: ${cmd}`);
-      process.exit(1);
-  }
-}

package/src/cli/commands/workspace.ts

@@ -1,116 +0,0 @@
-import { sendRequest } from '../client';
-import { printResult, printError, parseFlag } from '../utils';
-import type { RpcResponse } from '../../shared/rpc';
-
-interface WorkspaceInfo {
-  id: string;
-  name: string;
-  isActive?: boolean;
-}
-
-function formatWorkspaceList(result: unknown): void {
-  const list = result as WorkspaceInfo[];
-  if (!Array.isArray(list) || list.length === 0) {
-    console.log('No workspaces found.');
-    return;
-  }
-  const maxId = Math.max(...list.map((w) => w.id.length));
-  console.log(
-    'ID'.padEnd(maxId + 2) + 'NAME' + '    ' + 'STATUS'
-  );
-  console.log('-'.repeat(maxId + 30));
-  for (const ws of list) {
-    const active = ws.isActive ? ' (active)' : '';
-    console.log(ws.id.padEnd(maxId + 2) + ws.name + active);
-  }
-}
-
-function formatWorkspaceCurrent(result: unknown): void {
-  const ws = result as WorkspaceInfo | null;
-  if (!ws) {
-    console.log('No active workspace.');
-    return;
-  }
-  console.log(`Current workspace: ${ws.name} (${ws.id})`);
-}
-
-export async function handleWorkspace(
-  cmd: string,
-  args: string[],
-  jsonMode: boolean
-): Promise<void> {
-  let response: RpcResponse;
-
-  switch (cmd) {
-    case 'list-workspaces': {
-      response = await sendRequest('workspace.list', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        formatWorkspaceList(response.result);
-      }
-      break;
-    }
-
-    case 'new-workspace': {
-      const name = parseFlag(args, '--name') ?? `workspace-${Date.now()}`;
-      response = await sendRequest('workspace.new', { name });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        const ws = response.result as WorkspaceInfo;
-        console.log(`Created workspace: ${ws?.name ?? name} (${ws?.id ?? ''})`);
-      }
-      break;
-    }
-
-    case 'focus-workspace': {
-      const id = args[0];
-      if (!id) {
-        console.error('Error: focus-workspace requires <id>');
-        process.exit(1);
-      }
-      response = await sendRequest('workspace.focus', { id });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Focused workspace: ${id}`);
-      }
-      break;
-    }
-
-    case 'close-workspace': {
-      const id = args[0];
-      if (!id) {
-        console.error('Error: close-workspace requires <id>');
-        process.exit(1);
-      }
-      response = await sendRequest('workspace.close', { id });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Closed workspace: ${id}`);
-      }
-      break;
-    }
-
-    case 'current-workspace': {
-      response = await sendRequest('workspace.current', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        formatWorkspaceCurrent(response.result);
-      }
-      break;
-    }
-
-    default:
-      console.error(`Unknown workspace command: ${cmd}`);
-      process.exit(1);
-  }
-}

package/src/cli/index.ts

@@ -1,145 +0,0 @@
-#!/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

@@ -1,44 +0,0 @@
-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

@@ -1,86 +0,0 @@
-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

@@ -1,20 +0,0 @@
-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();
-  });
-}