@jojonax/codex-copilot 1.5.5 → 1.6.0

package/src/utils/automator.js

@@ -1,279 +1,279 @@
-/**
- * Desktop IDE Automator — platform-aware process detection + auto-paste
- * 
- * Supports macOS (AppleScript/osascript) and Windows (PowerShell/SendKeys).
- * Each IDE has its own keystroke recipe.
- * Falls back gracefully if automation fails.
- */
-
-import { execSync } from 'child_process';
-import { log } from './logger.js';
-
-const IS_MAC = process.platform === 'darwin';
-const IS_WIN = process.platform === 'win32';
-
-// ──────────────────────────────────────────────
-// Per-IDE Automation Recipes
-// ──────────────────────────────────────────────
-
-/**
- * Each recipe defines:
- *   processName: { mac, win } — binary/process name to detect
- *   appName:     { mac, win } — display name for activation
- *   preKeys:     keystroke sequence BEFORE paste (e.g., open Composer in Cursor)
- *   preDelay:    ms to wait after preKeys
- *   postKeys:    keystroke sequence AFTER paste (usually Enter to send)
- *   pasteDelay:  ms to wait between paste and postKeys
- */
-const IDE_RECIPES = {
-  'codex-desktop': {
-    processName: { mac: 'Codex', win: 'Codex' },
-    appName: { mac: 'Codex', win: 'Codex' },
-    // Codex Desktop: input is focused on activate → paste → Enter
-    preKeys: null,
-    preDelay: 0,
-    postKeys: 'return',
-    pasteDelay: 300,
-  },
-
-  'cursor': {
-    processName: { mac: 'Cursor', win: 'Cursor' },
-    appName: { mac: 'Cursor', win: 'Cursor' },
-    // Cursor: Cmd/Ctrl+I opens Composer, then paste, then Enter
-    preKeys: IS_MAC
-      ? 'keystroke "i" using {command down}'
-      : '^i',
-    preDelay: 800,
-    postKeys: 'return',
-    pasteDelay: 300,
-  },
-
-  'antigravity': {
-    processName: { mac: 'Antigravity', win: 'Antigravity' },
-    appName: { mac: 'Antigravity', win: 'Antigravity' },
-    // Antigravity: chat input auto-focused → paste → Enter
-    preKeys: null,
-    preDelay: 0,
-    postKeys: 'return',
-    pasteDelay: 300,
-  },
-};
-
-// ──────────────────────────────────────────────
-// Process Detection
-// ──────────────────────────────────────────────
-
-/**
- * Check if a process is running
- * @param {string} processName - Name of the process
- * @returns {boolean}
- */
-export function isProcessRunning(processName) {
-  try {
-    if (IS_MAC) {
-      const result = execSync(
-        `pgrep -x "${processName}" || pgrep -fi "${processName}"`,
-        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
-      ).trim();
-      return result.length > 0;
-    } else if (IS_WIN) {
-      const result = execSync(
-        `tasklist /FI "IMAGENAME eq ${processName}.exe" /NH`,
-        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
-      ).trim();
-      return !result.includes('No tasks');
-    }
-    return false;
-  } catch {
-    return false;
-  }
-}
-
-// ──────────────────────────────────────────────
-// macOS Automation (AppleScript)
-// ──────────────────────────────────────────────
-
-function buildAppleScript(recipe) {
-  const appName = recipe.appName.mac;
-  const lines = [];
-
-  // Activate the application
-  lines.push(`tell application "${appName}" to activate`);
-  lines.push('delay 0.5');
-
-  // System Events block for keystrokes
-  lines.push('tell application "System Events"');
-
-  // Pre-keys (e.g., Cmd+I for Cursor Composer)
-  if (recipe.preKeys) {
-    lines.push(`  ${recipe.preKeys}`);
-    lines.push(`  delay ${recipe.preDelay / 1000}`);
-  }
-
-  // Paste: Cmd+V
-  lines.push('  keystroke "v" using {command down}');
-  lines.push(`  delay ${recipe.pasteDelay / 1000}`);
-
-  // Post-keys: usually Enter to send
-  if (recipe.postKeys === 'return') {
-    lines.push('  keystroke return');
-  }
-
-  lines.push('end tell');
-
-  return lines.join('\n');
-}
-
-function runAppleScript(script) {
-  try {
-    execSync(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`, {
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 10000,
-    });
-    return true;
-  } catch (err) {
-    log.warn(`AppleScript failed: ${err.message}`);
-    if (err.message.includes('not allowed assistive access')) {
-      log.error('⚠ Accessibility permission required:');
-      log.error('  System Settings → Privacy & Security → Accessibility');
-      log.error('  Add your terminal app (Terminal / iTerm2 / Warp)');
-    }
-    return false;
-  }
-}
-
-// ──────────────────────────────────────────────
-// Windows Automation (PowerShell)
-// ──────────────────────────────────────────────
-
-function buildPowerShell(recipe) {
-  const appName = recipe.appName.win;
-  const lines = [];
-
-  lines.push('Add-Type -AssemblyName System.Windows.Forms');
-  lines.push('Add-Type -AssemblyName Microsoft.VisualBasic');
-
-  // Activate window
-  lines.push(`[Microsoft.VisualBasic.Interaction]::AppActivate("${appName}")`);
-  lines.push('Start-Sleep -Milliseconds 500');
-
-  // Pre-keys
-  if (recipe.preKeys) {
-    lines.push(`[System.Windows.Forms.SendKeys]::SendWait("${recipe.preKeys}")`);
-    lines.push(`Start-Sleep -Milliseconds ${recipe.preDelay}`);
-  }
-
-  // Paste: Ctrl+V
-  lines.push('[System.Windows.Forms.SendKeys]::SendWait("^v")');
-  lines.push(`Start-Sleep -Milliseconds ${recipe.pasteDelay}`);
-
-  // Post-keys: Enter
-  if (recipe.postKeys === 'return') {
-    lines.push('[System.Windows.Forms.SendKeys]::SendWait("{ENTER}")');
-  }
-
-  return lines.join('; ');
-}
-
-function runPowerShell(script) {
-  try {
-    execSync(`powershell -NoProfile -Command "${script.replace(/"/g, '\\"')}"`, {
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 10000,
-    });
-    return true;
-  } catch (err) {
-    log.warn(`PowerShell automation failed: ${err.message}`);
-    return false;
-  }
-}
-
-// ──────────────────────────────────────────────
-// Public API
-// ──────────────────────────────────────────────
-
-/**
- * Check if a specific IDE has a known automation recipe
- */
-export function hasRecipe(providerId) {
-  return providerId in IDE_RECIPES;
-}
-
-/**
- * Check if the IDE is currently running
- */
-export function isIDERunning(providerId) {
-  const recipe = IDE_RECIPES[providerId];
-  if (!recipe) return false;
-
-  const processName = IS_MAC ? recipe.processName.mac : recipe.processName.win;
-  return isProcessRunning(processName);
-}
-
-/**
- * Attempt to auto-paste prompt into the IDE and trigger send
- * 
- * Flow: copy to clipboard → activate window → pre-keys → paste → post-keys
- * 
- * @param {string} providerId - IDE provider ID
- * @param {string} text - Prompt text to paste
- * @returns {boolean} true if automation succeeded
- */
-export function activateAndPaste(providerId, text) {
-  const recipe = IDE_RECIPES[providerId];
-  if (!recipe) {
-    log.warn(`No automation recipe for '${providerId}'`);
-    return false;
-  }
-
-  // Step 1: Check process is running
-  const processName = IS_MAC ? recipe.processName.mac : recipe.processName.win;
-  if (!isProcessRunning(processName)) {
-    log.warn(`${recipe.appName[IS_MAC ? 'mac' : 'win']} is not running`);
-    return false;
-  }
-
-  // Step 2: Copy to clipboard (handled by caller, but ensure it's done)
-  copyToSystemClipboard(text);
-
-  // Step 3: Run platform-specific automation
-  log.info(`Auto-pasting into ${recipe.appName[IS_MAC ? 'mac' : 'win']}...`);
-
-  if (IS_MAC) {
-    const script = buildAppleScript(recipe);
-    return runAppleScript(script);
-  } else if (IS_WIN) {
-    const script = buildPowerShell(recipe);
-    return runPowerShell(script);
-  } else {
-    log.warn('Desktop automation not supported on this platform');
-    return false;
-  }
-}
-
-/**
- * Copy text to system clipboard (cross-platform)
- */
-function copyToSystemClipboard(text) {
-  try {
-    if (IS_MAC) {
-      execSync('pbcopy', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
-    } else if (IS_WIN) {
-      execSync('clip', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
-    } else {
-      try {
-        execSync('xclip -selection clipboard', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
-      } catch {
-        execSync('xsel --clipboard --input', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
-      }
-    }
-  } catch {
-    // Clipboard failure is non-fatal — user can copy file manually
-  }
-}
-
-export const automator = {
-  isProcessRunning, hasRecipe, isIDERunning, activateAndPaste,
-};
+/**
+ * Desktop IDE Automator — platform-aware process detection + auto-paste
+ * 
+ * Supports macOS (AppleScript/osascript) and Windows (PowerShell/SendKeys).
+ * Each IDE has its own keystroke recipe.
+ * Falls back gracefully if automation fails.
+ */
+
+import { execSync } from 'child_process';
+import { log } from './logger.js';
+
+const IS_MAC = process.platform === 'darwin';
+const IS_WIN = process.platform === 'win32';
+
+// ──────────────────────────────────────────────
+// Per-IDE Automation Recipes
+// ──────────────────────────────────────────────
+
+/**
+ * Each recipe defines:
+ *   processName: { mac, win } — binary/process name to detect
+ *   appName:     { mac, win } — display name for activation
+ *   preKeys:     keystroke sequence BEFORE paste (e.g., open Composer in Cursor)
+ *   preDelay:    ms to wait after preKeys
+ *   postKeys:    keystroke sequence AFTER paste (usually Enter to send)
+ *   pasteDelay:  ms to wait between paste and postKeys
+ */
+const IDE_RECIPES = {
+  'codex-desktop': {
+    processName: { mac: 'Codex', win: 'Codex' },
+    appName: { mac: 'Codex', win: 'Codex' },
+    // Codex Desktop: input is focused on activate → paste → Enter
+    preKeys: null,
+    preDelay: 0,
+    postKeys: 'return',
+    pasteDelay: 300,
+  },
+
+  'cursor': {
+    processName: { mac: 'Cursor', win: 'Cursor' },
+    appName: { mac: 'Cursor', win: 'Cursor' },
+    // Cursor: Cmd/Ctrl+I opens Composer, then paste, then Enter
+    preKeys: IS_MAC
+      ? 'keystroke "i" using {command down}'
+      : '^i',
+    preDelay: 800,
+    postKeys: 'return',
+    pasteDelay: 300,
+  },
+
+  'antigravity': {
+    processName: { mac: 'Antigravity', win: 'Antigravity' },
+    appName: { mac: 'Antigravity', win: 'Antigravity' },
+    // Antigravity: chat input auto-focused → paste → Enter
+    preKeys: null,
+    preDelay: 0,
+    postKeys: 'return',
+    pasteDelay: 300,
+  },
+};
+
+// ──────────────────────────────────────────────
+// Process Detection
+// ──────────────────────────────────────────────
+
+/**
+ * Check if a process is running
+ * @param {string} processName - Name of the process
+ * @returns {boolean}
+ */
+export function isProcessRunning(processName) {
+  try {
+    if (IS_MAC) {
+      const result = execSync(
+        `pgrep -x "${processName}" || pgrep -fi "${processName}"`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      ).trim();
+      return result.length > 0;
+    } else if (IS_WIN) {
+      const result = execSync(
+        `tasklist /FI "IMAGENAME eq ${processName}.exe" /NH`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      ).trim();
+      return !result.includes('No tasks');
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+// ──────────────────────────────────────────────
+// macOS Automation (AppleScript)
+// ──────────────────────────────────────────────
+
+function buildAppleScript(recipe) {
+  const appName = recipe.appName.mac;
+  const lines = [];
+
+  // Activate the application
+  lines.push(`tell application "${appName}" to activate`);
+  lines.push('delay 0.5');
+
+  // System Events block for keystrokes
+  lines.push('tell application "System Events"');
+
+  // Pre-keys (e.g., Cmd+I for Cursor Composer)
+  if (recipe.preKeys) {
+    lines.push(`  ${recipe.preKeys}`);
+    lines.push(`  delay ${recipe.preDelay / 1000}`);
+  }
+
+  // Paste: Cmd+V
+  lines.push('  keystroke "v" using {command down}');
+  lines.push(`  delay ${recipe.pasteDelay / 1000}`);
+
+  // Post-keys: usually Enter to send
+  if (recipe.postKeys === 'return') {
+    lines.push('  keystroke return');
+  }
+
+  lines.push('end tell');
+
+  return lines.join('\n');
+}
+
+function runAppleScript(script) {
+  try {
+    execSync(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 10000,
+    });
+    return true;
+  } catch (err) {
+    log.warn(`AppleScript failed: ${err.message}`);
+    if (err.message.includes('not allowed assistive access')) {
+      log.error('⚠ Accessibility permission required:');
+      log.error('  System Settings → Privacy & Security → Accessibility');
+      log.error('  Add your terminal app (Terminal / iTerm2 / Warp)');
+    }
+    return false;
+  }
+}
+
+// ──────────────────────────────────────────────
+// Windows Automation (PowerShell)
+// ──────────────────────────────────────────────
+
+function buildPowerShell(recipe) {
+  const appName = recipe.appName.win;
+  const lines = [];
+
+  lines.push('Add-Type -AssemblyName System.Windows.Forms');
+  lines.push('Add-Type -AssemblyName Microsoft.VisualBasic');
+
+  // Activate window
+  lines.push(`[Microsoft.VisualBasic.Interaction]::AppActivate("${appName}")`);
+  lines.push('Start-Sleep -Milliseconds 500');
+
+  // Pre-keys
+  if (recipe.preKeys) {
+    lines.push(`[System.Windows.Forms.SendKeys]::SendWait("${recipe.preKeys}")`);
+    lines.push(`Start-Sleep -Milliseconds ${recipe.preDelay}`);
+  }
+
+  // Paste: Ctrl+V
+  lines.push('[System.Windows.Forms.SendKeys]::SendWait("^v")');
+  lines.push(`Start-Sleep -Milliseconds ${recipe.pasteDelay}`);
+
+  // Post-keys: Enter
+  if (recipe.postKeys === 'return') {
+    lines.push('[System.Windows.Forms.SendKeys]::SendWait("{ENTER}")');
+  }
+
+  return lines.join('; ');
+}
+
+function runPowerShell(script) {
+  try {
+    execSync(`powershell -NoProfile -Command "${script.replace(/"/g, '\\"')}"`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 10000,
+    });
+    return true;
+  } catch (err) {
+    log.warn(`PowerShell automation failed: ${err.message}`);
+    return false;
+  }
+}
+
+// ──────────────────────────────────────────────
+// Public API
+// ──────────────────────────────────────────────
+
+/**
+ * Check if a specific IDE has a known automation recipe
+ */
+export function hasRecipe(providerId) {
+  return providerId in IDE_RECIPES;
+}
+
+/**
+ * Check if the IDE is currently running
+ */
+export function isIDERunning(providerId) {
+  const recipe = IDE_RECIPES[providerId];
+  if (!recipe) return false;
+
+  const processName = IS_MAC ? recipe.processName.mac : recipe.processName.win;
+  return isProcessRunning(processName);
+}
+
+/**
+ * Attempt to auto-paste prompt into the IDE and trigger send
+ * 
+ * Flow: copy to clipboard → activate window → pre-keys → paste → post-keys
+ * 
+ * @param {string} providerId - IDE provider ID
+ * @param {string} text - Prompt text to paste
+ * @returns {boolean} true if automation succeeded
+ */
+export function activateAndPaste(providerId, text) {
+  const recipe = IDE_RECIPES[providerId];
+  if (!recipe) {
+    log.warn(`No automation recipe for '${providerId}'`);
+    return false;
+  }
+
+  // Step 1: Check process is running
+  const processName = IS_MAC ? recipe.processName.mac : recipe.processName.win;
+  if (!isProcessRunning(processName)) {
+    log.warn(`${recipe.appName[IS_MAC ? 'mac' : 'win']} is not running`);
+    return false;
+  }
+
+  // Step 2: Copy to clipboard (handled by caller, but ensure it's done)
+  copyToSystemClipboard(text);
+
+  // Step 3: Run platform-specific automation
+  log.info(`Auto-pasting into ${recipe.appName[IS_MAC ? 'mac' : 'win']}...`);
+
+  if (IS_MAC) {
+    const script = buildAppleScript(recipe);
+    return runAppleScript(script);
+  } else if (IS_WIN) {
+    const script = buildPowerShell(recipe);
+    return runPowerShell(script);
+  } else {
+    log.warn('Desktop automation not supported on this platform');
+    return false;
+  }
+}
+
+/**
+ * Copy text to system clipboard (cross-platform)
+ */
+function copyToSystemClipboard(text) {
+  try {
+    if (IS_MAC) {
+      execSync('pbcopy', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+    } else if (IS_WIN) {
+      execSync('clip', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+    } else {
+      try {
+        execSync('xclip -selection clipboard', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+      } catch {
+        execSync('xsel --clipboard --input', { input: text, stdio: ['pipe', 'pipe', 'pipe'] });
+      }
+    }
+  } catch {
+    // Clipboard failure is non-fatal — user can copy file manually
+  }
+}
+
+export const automator = {
+  isProcessRunning, hasRecipe, isIDERunning, activateAndPaste,
+};