Function handleStartScript

projects/electron/src/modules/code/process.ts:425–510

* Start a script process

(params: StartScriptParams)

 * Start a script process
 */
async function handleStartScript(params: StartScriptParams): Promise<StartProcessResponse> {
    const startTime = Date.now()
    logger.info("[Process:startScript] Starting script", JSON.stringify({
        scriptLength: params.script.length,
        cwd: params.cwd,
        hasEnv: !!params.env,
        timeoutMs: params.timeoutMs,
    }))

    let tempScriptPath: string | undefined

    try {
        validateCwd(params.cwd)

        // Check process limit
        if (activeProcesses.size >= MAX_ACTIVE_PROCESSES) {
            throw new Error(`Maximum active processes (${MAX_ACTIVE_PROCESSES}) reached`)
        }

        const processId = generateProcessId()
        const timeoutMs = params.timeoutMs ?? DEFAULT_TIMEOUT_MS

        // Ensure temp directory exists
        const tempDir = getTempDir()
        if (!fs.existsSync(tempDir)) {
            fs.mkdirSync(tempDir, { recursive: true, mode: 0o700 })
        }

        // Get platform-appropriate shell
        const shellConfig = getScriptShell()

        // Write script to temp file
        tempScriptPath = path.join(tempDir, `script-${processId}${shellConfig.extension}`)
        let fullScript = params.script
        // Add preamble for bash scripts that don't have a shebang
        if (shellConfig.usePreamble && !params.script.startsWith("#!")) {
            fullScript = BASH_SCRIPT_PREAMBLE + params.script
        }
        fs.writeFileSync(tempScriptPath, fullScript, { mode: 0o700 })

        // Spawn the script in a new process group so we can kill the entire tree
        const childProcess = spawn(shellConfig.shell, shellConfig.args(tempScriptPath), {
            cwd: params.cwd,
            env: { ...process.env, ...params.env },
            stdio: ["ignore", "pipe", "pipe"],
            detached: process.platform !== "win32", // detached doesn't work the same on Windows
        })

        // Store in active processes
        activeProcesses.set(processId, {
            process: childProcess,
            outputBuffer: [],
            bufferSizeBytes: 0,
            exitCode: null,
            signal: null,
            completed: false,
            tempScriptPath,
        })