@debugmcp/mcp-debugger/src/proxy/dap-proxy-entry.ts

Run-time step-through debugging for LLM agents.

/**
 * DAP Proxy Entry Point - Production auto-execution entry
 * 
 * This file is the production entry point for the DAP proxy worker process.
 * It handles environment detection and auto-starts the proxy runner.
 * 
 * Detection methods:
 * 1. Direct execution: Script run directly via node
 * 2. IPC presence: Spawned as child process with IPC channel
 * 3. Environment flag: DAP_PROXY_WORKER=true set by bootstrap
 */

import { ProxyRunner, detectExecutionMode, shouldAutoExecute } from './dap-proxy-core.js';
import { 
  createProductionDependencies, 
  createConsoleLogger
} from './dap-proxy-dependencies.js';

// Detect execution mode
const executionMode = detectExecutionMode();

console.error('[Proxy Worker] Starting DAP Proxy worker process...');
console.error(`[Proxy Worker] Detection results: directRun=${executionMode.isDirectRun}, hasIPC=${executionMode.hasIPC}, workerEnv=${executionMode.isWorkerEnv}`);
console.error('[Proxy Worker] Node.js version:', process.version);
console.error(`[Proxy Worker] Current working directory: ${process.cwd()}`);

// Auto-execute if running as worker (NO test environment checks!)
if (shouldAutoExecute(executionMode)) {
  console.error('[Proxy Worker] Auto-executing proxy runner...');
  
  // Create dependencies and logger
  const dependencies = createProductionDependencies();
  const consoleLogger = createConsoleLogger();
  
  // Create and start runner
  const runner = new ProxyRunner(dependencies, consoleLogger);
  
  // Setup global error handlers
  runner.setupGlobalErrorHandlers(
    () => runner.stop(),
    () => runner.getWorker()['currentSessionId'] // Access private field for error messages
  );

  // Start the runner
  runner.start().catch((error) => {
    consoleLogger.error('[Proxy Worker] Failed to start runner:', error);
    process.exit(1);
  });

  console.error('[Proxy Worker] Ready to receive commands.');
} else {
  console.error('[Proxy Worker] Not auto-executing (not running as worker).');
}