@ebowwa/osascript 1.1.0

package/src/mcp/stdio.ts

@@ -0,0 +1,1284 @@
+#!/usr/bin/env bun
+/**
+ * osascript MCP Server (stdio protocol)
+ *
+ * Model Context Protocol server for macOS automation via osascript
+ * Uses stdio transport for Claude Code integration
+ */
+
+import {
+  executeAppleScript,
+  executeJXA,
+  displayNotification,
+  displayDialog,
+  getVolume,
+  setVolume,
+  getClipboard,
+  setClipboard,
+  clearClipboard,
+  listRunningApplications,
+  getApplicationInfo,
+  activateApplication,
+  quitApplication,
+  launchApplication,
+  getFrontmostApplication,
+  getApplicationWindows,
+  setWindowBounds,
+  minimizeWindow,
+  sendKeystroke,
+  sendKeyCode,
+  typeText,
+  KeyCodes,
+  getSafariURL,
+  setSafariURL,
+  getSafariTabTitles,
+  executeSafariJS,
+  getFinderSelection,
+  openFinderWindow,
+  createFolder,
+  moveToTrash,
+  getDisplayInfo,
+  getScreenResolution,
+  sayText,
+  beep,
+  getSystemDateTime,
+  isMacOS,
+  ensureMacOS,
+} from "../index.js";
+
+import type {
+  OsascriptResult,
+  NotificationOptions,
+  DialogOptions,
+  KeystrokeOptions,
+  KeyCodeOptions,
+} from "../types.js";
+
+// Action Events System
+import {
+  eventBus,
+  createEvent,
+  ActionEvent,
+  EventType,
+  startAppMonitor,
+  startClipboardMonitor,
+  stopMonitor,
+  stopAllMonitors,
+  registerEventListener,
+  unregisterEventListener,
+  listEventListeners,
+  toggleListener,
+  getEventHistory,
+  clearEventHistory,
+  sendEventWebhook,
+  emitLifecycleEvent,
+  getActiveMonitorCount,
+  getActiveListenerCount,
+} from "./events.js";
+
+// ==============
+// MCP Protocol Types
+// ==============
+
+interface JSONRPCMessage {
+  jsonrpc: "2.0";
+  id?: number | string;
+  method?: string;
+  params?: any;
+  result?: any;
+  error?: {
+    code: number;
+    message: string;
+    data?: any;
+  };
+}
+
+interface MCPTool {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: "object";
+    properties: Record<
+      string,
+      {
+        type: string;
+        description: string;
+        enum?: string[];
+        default?: any;
+      }
+    >;
+    required: string[];
+  };
+}
+
+// ==============
+// Tool Implementations
+// ==============
+
+async function osascriptExecute(script: string, language: "applescript" | "javascript" = "applescript"): Promise<string> {
+  const result = language === "javascript" ? await executeJXA(script) : await executeAppleScript(script);
+  return JSON.stringify(result, null, 2);
+}
+
+async function osascriptNotification(
+  message: string,
+  title: string = "Notification",
+  subtitle?: string,
+  soundName?: string
+): Promise<string> {
+  const options: NotificationOptions = { message, title, subtitle, soundName };
+  const result = await displayNotification(options);
+  return result.success ? `Notification sent: ${title}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptDialog(
+  message: string,
+  title?: string,
+  buttons?: string[],
+  defaultButton?: number,
+  icon?: "note" | "caution" | "stop"
+): Promise<string> {
+  const options: DialogOptions = { message, title, buttons, defaultButton, icon };
+  try {
+    const result = await displayDialog(options);
+    return `Button returned: ${result.buttonReturned}${result.gaveUp ? " (timed out)" : ""}`;
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptGetVolume(): Promise<string> {
+  const info = await getVolume();
+  return `Volume: ${info.volume}%${info.muted ? " (muted)" : ""}`;
+}
+
+async function osascriptSetVolume(volume: number, muted?: boolean): Promise<string> {
+  const result = await setVolume(volume, muted);
+  return result.success ? `Volume set to ${volume}%` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetClipboard(): Promise<string> {
+  try {
+    const content = await getClipboard();
+    return content || "(clipboard is empty)";
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptSetClipboard(text: string): Promise<string> {
+  const result = await setClipboard(text);
+  return result.success ? "Clipboard updated" : `Error: ${result.stderr}`;
+}
+
+async function osascriptClearClipboard(): Promise<string> {
+  const result = await clearClipboard();
+  return result.success ? "Clipboard cleared" : `Error: ${result.stderr}`;
+}
+
+async function osascriptListApps(): Promise<string> {
+  const apps = await listRunningApplications();
+  const lines = ["Running Applications:", "=".repeat(40), ""];
+  for (const app of apps) {
+    lines.push(`- ${app.name}`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptGetAppInfo(appName: string): Promise<string> {
+  const info = await getApplicationInfo(appName);
+  if (!info.running) {
+    return `Application "${appName}" is not running`;
+  }
+  const lines = [
+    `Application: ${info.name}`,
+    "=".repeat(40),
+    `Running: ${info.running}`,
+    info.path ? `Path: ${info.path}` : "",
+    info.processId ? `PID: ${info.processId}` : "",
+    info.windowCount !== undefined ? `Windows: ${info.windowCount}` : "",
+  ].filter(Boolean);
+  return lines.join("\n");
+}
+
+async function osascriptActivateApp(appName: string): Promise<string> {
+  const result = await activateApplication(appName);
+  return result.success ? `Activated ${appName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptQuitApp(appName: string, force: boolean = false): Promise<string> {
+  const result = await quitApplication(appName, force);
+  return result.success ? `Quit ${appName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptLaunchApp(appName: string): Promise<string> {
+  const result = await launchApplication(appName);
+  return result.success ? `Launched ${appName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetFrontmostApp(): Promise<string> {
+  const appName = await getFrontmostApplication();
+  return `Frontmost application: ${appName}`;
+}
+
+async function osascriptGetWindows(appName: string): Promise<string> {
+  const windows = await getApplicationWindows(appName);
+  if (windows.length === 0) {
+    return `No windows for ${appName}`;
+  }
+  const lines = [`Windows for ${appName}:`, "=".repeat(40), ""];
+  for (const win of windows) {
+    lines.push(`${win.index}. ${win.name || "(unnamed)"} (ID: ${win.id})`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptSetWindowBounds(
+  appName: string,
+  windowIndex: number,
+  x: number,
+  y: number,
+  width: number,
+  height: number
+): Promise<string> {
+  const result = await setWindowBounds(appName, windowIndex, { x, y, width, height });
+  return result.success
+    ? `Window ${windowIndex} bounds set to ${width}x${height} at (${x}, ${y})`
+    : `Error: ${result.stderr}`;
+}
+
+async function osascriptKeystroke(
+  key: string,
+  modifiers: ("command" | "shift" | "option" | "control")[] = []
+): Promise<string> {
+  const options: KeystrokeOptions = { key, modifiers };
+  const result = await sendKeystroke(options);
+  const modStr = modifiers.length > 0 ? ` with ${modifiers.join("+")}` : "";
+  return result.success ? `Sent keystroke: ${key}${modStr}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptKeyCode(
+  keyCode: number,
+  modifiers: ("command" | "shift" | "option" | "control")[] = []
+): Promise<string> {
+  const options: KeyCodeOptions = { keyCode, modifiers };
+  const result = await sendKeyCode(options);
+  const modStr = modifiers.length > 0 ? ` with ${modifiers.join("+")}` : "";
+  return result.success ? `Sent key code: ${keyCode}${modStr}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptTypeText(text: string): Promise<string> {
+  const result = await typeText(text);
+  return result.success ? `Typed: ${text}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptSafariGetURL(): Promise<string> {
+  try {
+    const url = await getSafariURL();
+    return `Current Safari URL: ${url}`;
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptSafariSetURL(url: string): Promise<string> {
+  const result = await setSafariURL(url);
+  return result.success ? `Navigated to: ${url}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptSafariGetTabs(): Promise<string> {
+  const titles = await getSafariTabTitles();
+  if (titles.length === 0) {
+    return "No Safari tabs";
+  }
+  const lines = ["Safari Tabs:", "=".repeat(40), ""];
+  titles.forEach((title, i) => lines.push(`${i + 1}. ${title}`));
+  return lines.join("\n");
+}
+
+async function osascriptSafariExecJS(jsCode: string): Promise<string> {
+  try {
+    const result = await executeSafariJS(jsCode);
+    return result || "(no output)";
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptFinderGetSelection(): Promise<string> {
+  const items = await getFinderSelection();
+  if (items.length === 0) {
+    return "No Finder selection";
+  }
+  const lines = ["Finder Selection:", "=".repeat(40), ""];
+  for (const item of items) {
+    lines.push(`- ${item.name} (${item.type})`);
+    lines.push(`  ${item.path}`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptFinderOpen(path: string): Promise<string> {
+  const result = await openFinderWindow(path);
+  return result.success ? `Opened Finder at: ${path}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptFinderCreateFolder(parentPath: string, folderName: string): Promise<string> {
+  const result = await createFolder(parentPath, folderName);
+  return result.success ? `Created folder: ${folderName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptFinderTrash(path: string): Promise<string> {
+  const result = await moveToTrash(path);
+  return result.success ? `Moved to trash: ${path}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetDisplays(): Promise<string> {
+  const displays = await getDisplayInfo();
+  const lines = ["Display Information:", "=".repeat(40), ""];
+  for (const display of displays) {
+    lines.push(`Display ${display.id}: ${display.width}x${display.height}${display.main ? " (main)" : ""}`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptGetResolution(): Promise<string> {
+  const { width, height } = await getScreenResolution();
+  return `Screen resolution: ${width}x${height}`;
+}
+
+async function osascriptSay(text: string, voice?: string, rate?: number): Promise<string> {
+  const result = await sayText(text, voice, rate);
+  return result.success ? `Said: "${text}"` : `Error: ${result.stderr}`;
+}
+
+async function osascriptBeep(count: number = 1): Promise<string> {
+  const result = await beep(count);
+  return result.success ? `Beeped ${count} time(s)` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetDateTime(): Promise<string> {
+  const dateTime = await getSystemDateTime();
+  return `System date/time: ${dateTime}`;
+}
+
+// Claude Code session spawning
+async function osascriptSpawnClaudeSession(
+  sessionId: string,
+  workingDir?: string,
+  dopplerProject: string = "seed",
+  dopplerConfig: string = "prd"
+): Promise<string> {
+  const cdCmd = workingDir ? `cd ${workingDir} && ` : "";
+  // NO_COLOR=1 and TERM=dumb disable colors
+  const script = `tell application "Terminal" to do script "${cdCmd}unset CLAUDECODE && NO_COLOR=1 TERM=dumb doppler run --project ${dopplerProject} --config ${dopplerConfig} --command \\\"claude -r ${sessionId}\\\""`;
+
+  const result = await executeAppleScript(script);
+  if (result.success) {
+    return `Spawned Claude Code session ${sessionId} in ${result.stdout}`;
+  }
+  return `Error: ${result.stderr}`;
+}
+
+async function osascriptSpawnClaudeSessionsBatch(
+  sessionIdsStr: string,
+  workingDir?: string,
+  dopplerProject: string = "seed",
+  dopplerConfig: string = "prd"
+): Promise<string> {
+  const sessionIds = sessionIdsStr.split(",").map((s) => s.trim()).filter(Boolean);
+  const cdCmd = workingDir ? `cd ${workingDir} && ` : "";
+
+  const results: string[] = [];
+  for (const sessionId of sessionIds) {
+    // NO_COLOR=1 and TERM=dumb disable colors
+    const script = `tell application "Terminal" to do script "${cdCmd}unset CLAUDECODE && NO_COLOR=1 TERM=dumb doppler run --project ${dopplerProject} --config ${dopplerConfig} --command \\\"claude -r ${sessionId}\\\""`;
+    const result = await executeAppleScript(script);
+    results.push(`${sessionId.slice(0, 8)}: ${result.success ? result.stdout : result.stderr}`);
+  }
+
+  return `Spawned ${sessionIds.length} sessions:\n${results.join("\n")}`;
+}
+
+// ==============
+// Tool Definitions
+// ==============
+
+const TOOLS: MCPTool[] = [
+  // Core
+  {
+    name: "osascript_execute",
+    description: "Execute raw AppleScript code",
+    inputSchema: {
+      type: "object",
+      properties: {
+        script: { type: "string", description: "AppleScript code to execute" },
+        language: {
+          type: "string",
+          description: "Script language",
+          enum: ["applescript", "javascript"],
+          default: "applescript",
+        },
+      },
+      required: ["script"],
+    },
+  },
+  // System
+  {
+    name: "osascript_display_notification",
+    description: "Display a macOS notification",
+    inputSchema: {
+      type: "object",
+      properties: {
+        message: { type: "string", description: "Notification body text" },
+        title: { type: "string", description: "Notification title", default: "Notification" },
+        subtitle: { type: "string", description: "Notification subtitle" },
+        sound_name: { type: "string", description: "Sound name (e.g., 'Ping', 'Glass')" },
+      },
+      required: ["message"],
+    },
+  },
+  {
+    name: "osascript_display_dialog",
+    description: "Display a dialog with buttons",
+    inputSchema: {
+      type: "object",
+      properties: {
+        message: { type: "string", description: "Dialog message" },
+        title: { type: "string", description: "Dialog title" },
+        buttons: {
+          type: "string",
+          description: "Comma-separated button labels (e.g., 'OK,Cancel')",
+        },
+        default_button: { type: "number", description: "Default button index (1-based)" },
+        icon: {
+          type: "string",
+          description: "Dialog icon",
+          enum: ["note", "caution", "stop"],
+        },
+      },
+      required: ["message"],
+    },
+  },
+  // Volume
+  {
+    name: "osascript_get_volume",
+    description: "Get system volume level",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_set_volume",
+    description: "Set system volume level (0-100)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        volume: { type: "number", description: "Volume level 0-100" },
+        muted: { type: "boolean", description: "Whether to mute" },
+      },
+      required: ["volume"],
+    },
+  },
+  // Clipboard
+  {
+    name: "osascript_get_clipboard",
+    description: "Get clipboard contents",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_set_clipboard",
+    description: "Set clipboard contents",
+    inputSchema: {
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Text to copy to clipboard" },
+      },
+      required: ["text"],
+    },
+  },
+  {
+    name: "osascript_clear_clipboard",
+    description: "Clear clipboard contents",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  // Applications
+  {
+    name: "osascript_list_apps",
+    description: "List all running applications",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_get_app_info",
+    description: "Get detailed information about an application",
+    inputSchema: {
+      type: "object",
+      properties: {
+        app_name: { type: "string", description: "Application name" },
+      },
+      required: ["app_name"],
+    },
+  },
+  {
+    name: "osascript_activate_app",
+    description: "Activate (bring to front) an application",
+    inputSchema: {
+      type: "object",
+      properties: {
+        app_name: { type: "string", description: "Application name to activate" },
+      },
+      required: ["app_name"],
+    },
+  },
+  {
+    name: "osascript_quit_app",
+    description: "Quit an application",
+    inputSchema: {
+      type: "object",
+      properties: {
+        app_name: { type: "string", description: "Application name to quit" },
+        force: { type: "boolean", description: "Force quit (kill -9)" },
+      },
+      required: ["app_name"],
+    },
+  },
+  {
+    name: "osascript_launch_app",
+    description: "Launch an application",
+    inputSchema: {
+      type: "object",
+      properties: {
+        app_name: { type: "string", description: "Application name to launch" },
+      },
+      required: ["app_name"],
+    },
+  },
+  {
+    name: "osascript_get_frontmost_app",
+    description: "Get the name of the frontmost (active) application",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  // Windows
+  {
+    name: "osascript_get_windows",
+    description: "Get window list for an application",
+    inputSchema: {
+      type: "object",
+      properties: {
+        app_name: { type: "string", description: "Application name" },
+      },
+      required: ["app_name"],
+    },
+  },
+  {
+    name: "osascript_set_window_bounds",
+    description: "Set window position and size",
+    inputSchema: {
+      type: "object",
+      properties: {
+        app_name: { type: "string", description: "Application name" },
+        window_index: { type: "number", description: "Window index (1-based)" },
+        x: { type: "number", description: "X position" },
+        y: { type: "number", description: "Y position" },
+        width: { type: "number", description: "Window width" },
+        height: { type: "number", description: "Window height" },
+      },
+      required: ["app_name", "window_index", "x", "y", "width", "height"],
+    },
+  },
+  // Keyboard
+  {
+    name: "osascript_keystroke",
+    description: "Send keystroke with optional modifiers",
+    inputSchema: {
+      type: "object",
+      properties: {
+        key: { type: "string", description: "Key to press" },
+        modifiers: {
+          type: "string",
+          description: "Comma-separated modifiers: command, shift, option, control",
+        },
+      },
+      required: ["key"],
+    },
+  },
+  {
+    name: "osascript_key_code",
+    description: "Send key code (for special keys)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        key_code: { type: "number", description: "Key code number (e.g., 36=Return, 48=Tab)" },
+        modifiers: {
+          type: "string",
+          description: "Comma-separated modifiers: command, shift, option, control",
+        },
+      },
+      required: ["key_code"],
+    },
+  },
+  {
+    name: "osascript_type_text",
+    description: "Type text (simulate keyboard input)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Text to type" },
+      },
+      required: ["text"],
+    },
+  },
+  // Safari
+  {
+    name: "osascript_safari_get_url",
+    description: "Get current Safari URL",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_safari_set_url",
+    description: "Navigate Safari to URL",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to navigate to" },
+      },
+      required: ["url"],
+    },
+  },
+  {
+    name: "osascript_safari_get_tabs",
+    description: "Get Safari tab titles",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_safari_exec_js",
+    description: "Execute JavaScript in Safari",
+    inputSchema: {
+      type: "object",
+      properties: {
+        js_code: { type: "string", description: "JavaScript code to execute" },
+      },
+      required: ["js_code"],
+    },
+  },
+  // Finder
+  {
+    name: "osascript_finder_get_selection",
+    description: "Get currently selected files in Finder",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_finder_open",
+    description: "Open Finder window at path",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to open" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "osascript_finder_create_folder",
+    description: "Create new folder in Finder",
+    inputSchema: {
+      type: "object",
+      properties: {
+        parent_path: { type: "string", description: "Parent directory path" },
+        folder_name: { type: "string", description: "New folder name" },
+      },
+      required: ["parent_path", "folder_name"],
+    },
+  },
+  {
+    name: "osascript_finder_trash",
+    description: "Move file/folder to trash",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Path to move to trash" },
+      },
+      required: ["path"],
+    },
+  },
+  // Display
+  {
+    name: "osascript_get_displays",
+    description: "Get display information",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_get_resolution",
+    description: "Get main screen resolution",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  // Audio
+  {
+    name: "osascript_say",
+    description: "Say text using system voice",
+    inputSchema: {
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Text to speak" },
+        voice: { type: "string", description: "Voice name (e.g., 'Alex', 'Samantha')" },
+        rate: { type: "number", description: "Speaking rate" },
+      },
+      required: ["text"],
+    },
+  },
+  {
+    name: "osascript_beep",
+    description: "Play system beep",
+    inputSchema: {
+      type: "object",
+      properties: {
+        count: { type: "number", description: "Number of beeps" },
+      },
+      required: [],
+    },
+  },
+  // Date/Time
+  {
+    name: "osascript_get_datetime",
+    description: "Get current system date/time",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  // Claude Code
+  {
+    name: "osascript_spawn_claude_session",
+    description: "Open new Terminal tab with Claude Code resume session (auto-unsets CLAUDECODE to bypass nested session check)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        session_id: { type: "string", description: "Claude Code session ID to resume" },
+        working_dir: { type: "string", description: "Working directory (default: current directory)" },
+        doppler_project: { type: "string", description: "Doppler project name (default: seed)" },
+        doppler_config: { type: "string", description: "Doppler config (default: prd)" },
+      },
+      required: ["session_id"],
+    },
+  },
+  {
+    name: "osascript_spawn_claude_sessions_batch",
+    description: "Open multiple Terminal tabs with Claude Code resume sessions in parallel",
+    inputSchema: {
+      type: "object",
+      properties: {
+        session_ids: { type: "string", description: "Comma-separated list of Claude Code session IDs" },
+        working_dir: { type: "string", description: "Working directory (default: current directory)" },
+        doppler_project: { type: "string", description: "Doppler project name (default: seed)" },
+        doppler_config: { type: "string", description: "Doppler config (default: prd)" },
+      },
+      required: ["session_ids"],
+    },
+  },
+  // ==============
+  // Action Events
+  // ==============
+  {
+    name: "osascript_event_start_app_monitor",
+    description: "Start monitoring application switches (fires event when frontmost app changes)",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_event_start_clipboard_monitor",
+    description: "Start monitoring clipboard changes (fires event when clipboard content changes)",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_event_stop_monitor",
+    description: "Stop a specific monitor by ID",
+    inputSchema: {
+      type: "object",
+      properties: {
+        monitor_id: { type: "string", description: "Monitor ID to stop" },
+      },
+      required: ["monitor_id"],
+    },
+  },
+  {
+    name: "osascript_event_stop_all_monitors",
+    description: "Stop all active monitors",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_event_register_listener",
+    description: "Register an event listener with optional webhook callback",
+    inputSchema: {
+      type: "object",
+      properties: {
+        event_type: {
+          type: "string",
+          description: "Event type to listen for (e.g., 'keystroke', 'app_activate', '*' for all)",
+        },
+        webhook_url: { type: "string", description: "Webhook URL to POST events to" },
+      },
+      required: ["event_type"],
+    },
+  },
+  {
+    name: "osascript_event_unregister_listener",
+    description: "Unregister an event listener",
+    inputSchema: {
+      type: "object",
+      properties: {
+        listener_id: { type: "string", description: "Listener ID to remove" },
+      },
+      required: ["listener_id"],
+    },
+  },
+  {
+    name: "osascript_event_list_listeners",
+    description: "List all registered event listeners",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_event_get_history",
+    description: "Get event history, optionally filtered by type or time",
+    inputSchema: {
+      type: "object",
+      properties: {
+        since: { type: "number", description: "Unix timestamp to get events since" },
+        event_type: { type: "string", description: "Filter by event type" },
+      },
+      required: [],
+    },
+  },
+  {
+    name: "osascript_event_clear_history",
+    description: "Clear all event history",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "osascript_event_send_webhook",
+    description: "Manually send an event to a webhook URL",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "Webhook URL" },
+        event_type: { type: "string", description: "Event type" },
+        data: { type: "string", description: "JSON string of event data" },
+      },
+      required: ["url", "event_type"],
+    },
+  },
+  {
+    name: "osascript_event_emit",
+    description: "Emit a custom event to the event bus",
+    inputSchema: {
+      type: "object",
+      properties: {
+        event_type: { type: "string", description: "Event type to emit" },
+        source: { type: "string", description: "Source identifier" },
+        data: { type: "string", description: "JSON string of event data" },
+      },
+      required: ["event_type", "source"],
+    },
+  },
+  {
+    name: "osascript_event_status",
+    description: "Get status of event system (active monitors, listeners, event count)",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+];
+
+// ==============
+// MCP Server
+// ==============
+
+function parseModifiers(modifiersStr?: string): ("command" | "shift" | "option" | "control")[] {
+  if (!modifiersStr) return [];
+  return modifiersStr
+    .split(",")
+    .map((m) => m.trim().toLowerCase() as "command" | "shift" | "option" | "control")
+    .filter((m) => ["command", "shift", "option", "control"].includes(m));
+}
+
+async function handleToolCall(name: string, args: any): Promise<string> {
+  // Check macOS availability
+  if (!isMacOS()) {
+    throw new Error("osascript MCP only works on macOS");
+  }
+
+  switch (name) {
+    // Core
+    case "osascript_execute":
+      return await osascriptExecute(args.script, args.language || "applescript");
+
+    // System
+    case "osascript_display_notification":
+      return await osascriptNotification(args.message, args.title, args.subtitle, args.sound_name);
+    case "osascript_display_dialog":
+      return await osascriptDialog(
+        args.message,
+        args.title,
+        args.buttons?.split(","),
+        args.default_button,
+        args.icon
+      );
+
+    // Volume
+    case "osascript_get_volume":
+      return await osascriptGetVolume();
+    case "osascript_set_volume":
+      return await osascriptSetVolume(args.volume, args.muted);
+
+    // Clipboard
+    case "osascript_get_clipboard":
+      return await osascriptGetClipboard();
+    case "osascript_set_clipboard":
+      return await osascriptSetClipboard(args.text);
+    case "osascript_clear_clipboard":
+      return await osascriptClearClipboard();
+
+    // Applications
+    case "osascript_list_apps":
+      return await osascriptListApps();
+    case "osascript_get_app_info":
+      return await osascriptGetAppInfo(args.app_name);
+    case "osascript_activate_app":
+      return await osascriptActivateApp(args.app_name);
+    case "osascript_quit_app":
+      return await osascriptQuitApp(args.app_name, args.force);
+    case "osascript_launch_app":
+      return await osascriptLaunchApp(args.app_name);
+    case "osascript_get_frontmost_app":
+      return await osascriptGetFrontmostApp();
+
+    // Windows
+    case "osascript_get_windows":
+      return await osascriptGetWindows(args.app_name);
+    case "osascript_set_window_bounds":
+      return await osascriptSetWindowBounds(
+        args.app_name,
+        args.window_index,
+        args.x,
+        args.y,
+        args.width,
+        args.height
+      );
+
+    // Keyboard
+    case "osascript_keystroke":
+      return await osascriptKeystroke(args.key, parseModifiers(args.modifiers));
+    case "osascript_key_code":
+      return await osascriptKeyCode(args.key_code, parseModifiers(args.modifiers));
+    case "osascript_type_text":
+      return await osascriptTypeText(args.text);
+
+    // Safari
+    case "osascript_safari_get_url":
+      return await osascriptSafariGetURL();
+    case "osascript_safari_set_url":
+      return await osascriptSafariSetURL(args.url);
+    case "osascript_safari_get_tabs":
+      return await osascriptSafariGetTabs();
+    case "osascript_safari_exec_js":
+      return await osascriptSafariExecJS(args.js_code);
+
+    // Finder
+    case "osascript_finder_get_selection":
+      return await osascriptFinderGetSelection();
+    case "osascript_finder_open":
+      return await osascriptFinderOpen(args.path);
+    case "osascript_finder_create_folder":
+      return await osascriptFinderCreateFolder(args.parent_path, args.folder_name);
+    case "osascript_finder_trash":
+      return await osascriptFinderTrash(args.path);
+
+    // Display
+    case "osascript_get_displays":
+      return await osascriptGetDisplays();
+    case "osascript_get_resolution":
+      return await osascriptGetResolution();
+
+    // Audio
+    case "osascript_say":
+      return await osascriptSay(args.text, args.voice, args.rate);
+    case "osascript_beep":
+      return await osascriptBeep(args.count || 1);
+
+    // Date/Time
+    case "osascript_get_datetime":
+      return await osascriptGetDateTime();
+
+    // Claude Code
+    case "osascript_spawn_claude_session":
+      return await osascriptSpawnClaudeSession(
+        args.session_id,
+        args.working_dir,
+        args.doppler_project,
+        args.doppler_config
+      );
+    case "osascript_spawn_claude_sessions_batch":
+      return await osascriptSpawnClaudeSessionsBatch(
+        args.session_ids,
+        args.working_dir,
+        args.doppler_project,
+        args.doppler_config
+      );
+
+    // ==============
+    // Action Events
+    // ==============
+    case "osascript_event_start_app_monitor": {
+      const monitorId = await startAppMonitor();
+      return `Started app monitor: ${monitorId}`;
+    }
+    case "osascript_event_start_clipboard_monitor": {
+      const monitorId = await startClipboardMonitor();
+      return `Started clipboard monitor: ${monitorId}`;
+    }
+    case "osascript_event_stop_monitor": {
+      const stopped = stopMonitor(args.monitor_id);
+      return stopped ? `Stopped monitor: ${args.monitor_id}` : `Monitor not found: ${args.monitor_id}`;
+    }
+    case "osascript_event_stop_all_monitors": {
+      stopAllMonitors();
+      return "Stopped all monitors";
+    }
+    case "osascript_event_register_listener": {
+      const listenerId = registerEventListener(args.event_type as EventType | "*", {
+        webhookUrl: args.webhook_url,
+      });
+      return `Registered listener: ${listenerId}`;
+    }
+    case "osascript_event_unregister_listener": {
+      const removed = unregisterEventListener(args.listener_id);
+      return removed ? `Unregistered listener: ${args.listener_id}` : `Listener not found: ${args.listener_id}`;
+    }
+    case "osascript_event_list_listeners": {
+      const listeners = listEventListeners();
+      if (listeners.length === 0) return "No listeners registered";
+      const lines = ["Event Listeners:", "=".repeat(40), ""];
+      for (const l of listeners) {
+        lines.push(`${l.id}: ${l.eventType} (${l.active ? "active" : "inactive"})${l.webhookUrl ? ` -> ${l.webhookUrl}` : ""}`);
+      }
+      return lines.join("\n");
+    }
+    case "osascript_event_get_history": {
+      const events = getEventHistory(args.since, args.event_type as EventType);
+      if (events.length === 0) return "No events in history";
+      return JSON.stringify(events, null, 2);
+    }
+    case "osascript_event_clear_history": {
+      clearEventHistory();
+      return "Event history cleared";
+    }
+    case "osascript_event_send_webhook": {
+      const data = args.data ? JSON.parse(args.data) : {};
+      const event = createEvent(args.event_type as EventType, "manual", data);
+      const result = await sendEventWebhook(args.url, event);
+      return result.success ? `Webhook sent: ${event.id}` : `Webhook failed: ${result.error}`;
+    }
+    case "osascript_event_emit": {
+      const data = args.data ? JSON.parse(args.data) : {};
+      const event = createEvent(args.event_type as EventType, args.source, data);
+      eventBus.emit(event);
+      return `Emitted event: ${event.id}`;
+    }
+    case "osascript_event_status": {
+      const status = {
+        activeMonitors: getActiveMonitorCount(),
+        activeListeners: getActiveListenerCount(),
+        historySize: getEventHistory().length,
+      };
+      return `Event System Status:\n${JSON.stringify(status, null, 2)}`;
+    }
+
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+
+function sendMessage(message: JSONRPCMessage): void {
+  console.log(JSON.stringify(message));
+}
+
+async function processMessage(message: JSONRPCMessage): Promise<void> {
+  const { id, method, params } = message;
+
+  try {
+    switch (method) {
+      case "initialize":
+        sendMessage({
+          jsonrpc: "2.0",
+          id,
+          result: {
+            protocolVersion: "2024-11-05",
+            capabilities: {
+              tools: {},
+            },
+            serverInfo: {
+              name: "osascript-mcp",
+              version: "1.0.0",
+              description: "macOS automation via osascript (AppleScript/JXA)",
+            },
+          },
+        });
+        break;
+
+      case "tools/list":
+        sendMessage({
+          jsonrpc: "2.0",
+          id,
+          result: {
+            tools: TOOLS,
+          },
+        });
+        break;
+
+      case "tools/call":
+        const { name, arguments: args } = params;
+        const result = await handleToolCall(name, args || {});
+        sendMessage({
+          jsonrpc: "2.0",
+          id,
+          result: {
+            content: [
+              {
+                type: "text",
+                text: result,
+              },
+            ],
+          },
+        });
+        break;
+
+      case "shutdown":
+        sendMessage({
+          jsonrpc: "2.0",
+          id,
+          result: {},
+        });
+        process.exit(0);
+        break;
+
+      default:
+        sendMessage({
+          jsonrpc: "2.0",
+          id,
+          error: {
+            code: -32601,
+            message: `Method not found: ${method}`,
+          },
+        });
+    }
+  } catch (error) {
+    sendMessage({
+      jsonrpc: "2.0",
+      id,
+      error: {
+        code: -32603,
+        message: `Internal error: ${error}`,
+      },
+    });
+  }
+}
+
+// ==============
+// Main Loop
+// ==============
+
+async function main() {
+  // Verify macOS
+  if (!isMacOS()) {
+    console.error("ERROR: osascript MCP only works on macOS");
+    process.exit(1);
+  }
+
+  const decoder = new TextDecoder();
+  let buffer = "";
+
+  for await (const chunk of process.stdin) {
+    buffer += decoder.decode(chunk);
+
+    const lines = buffer.split("\n");
+    buffer = lines.pop() || "";
+
+    for (const line of lines) {
+      if (!line.trim()) continue;
+
+      try {
+        const message: JSONRPCMessage = JSON.parse(line);
+        await processMessage(message);
+      } catch (error) {
+        sendMessage({
+          jsonrpc: "2.0",
+          error: {
+            code: -32700,
+            message: `Parse error: ${error}`,
+          },
+        });
+      }
+    }
+  }
+}
+
+main().catch(console.error);