@proletariat/cli 0.3.69 → 0.3.70

package/dist/lib/execution/runners/executor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Executor Command Helpers
+ *
+ * Functions for building executor commands, checking executor availability,
+ * and running preflight checks across different execution environments.
+ */
+import { ExecutionEnvironment, ExecutorType } from '../types.js';
+export declare function getExecutorCommand(executor: ExecutorType, prompt: string, skipPermissions?: boolean): {
+    cmd: string;
+    args: string[];
+};
+/**
+ * Check if an executor is Claude Code.
+ */
+export declare function isClaudeExecutor(executor: ExecutorType): boolean;
+/**
+ * Get the display name for an executor type.
+ */
+export declare function getExecutorDisplayName(executor: ExecutorType): string;
+/**
+ * Get the npm package name for an executor (for container installation).
+ */
+export declare function getExecutorPackage(executor: ExecutorType): string | null;
+export interface PreflightResult {
+    ok: boolean;
+    error?: string;
+}
+/**
+ * Check executor binary availability on host.
+ */
+export declare function checkExecutorOnHost(executor: ExecutorType): PreflightResult;
+/**
+ * Check executor binary availability inside a container.
+ */
+export declare function checkExecutorInContainer(executor: ExecutorType, containerId: string): PreflightResult;
+/**
+ * Run executor preflight checks for the target environment.
+ */
+export declare function runExecutorPreflight(environment: ExecutionEnvironment, executor: ExecutorType, options?: {
+    containerId?: string;
+}): PreflightResult;

package/dist/lib/execution/runners/executor.js

@@ -0,0 +1,108 @@
+/**
+ * Executor Command Helpers
+ *
+ * Functions for building executor commands, checking executor availability,
+ * and running preflight checks across different execution environments.
+ */
+import { execSync } from 'node:child_process';
+import { normalizeEnvironment, } from '../types.js';
+import { getCodexCommand } from '../codex-adapter.js';
+export function getExecutorCommand(executor, prompt, skipPermissions = true) {
+    switch (executor) {
+        case 'claude-code':
+            if (skipPermissions) {
+                return { cmd: 'claude', args: ['--permission-mode', 'bypassPermissions', '--dangerously-skip-permissions', '--effort', 'high', prompt] };
+            }
+            return { cmd: 'claude', args: [prompt] };
+        case 'codex': {
+            const codexPermission = skipPermissions ? 'danger' : 'safe';
+            const codexResult = getCodexCommand(prompt, codexPermission, 'interactive');
+            return { cmd: codexResult.cmd, args: codexResult.args };
+        }
+        case 'custom':
+            return { cmd: 'echo', args: ['Custom executor not configured'] };
+        default:
+            if (skipPermissions) {
+                return { cmd: 'claude', args: ['--permission-mode', 'bypassPermissions', '--dangerously-skip-permissions', '--effort', 'high', prompt] };
+            }
+            return { cmd: 'claude', args: [prompt] };
+    }
+}
+/**
+ * Check if an executor is Claude Code.
+ */
+export function isClaudeExecutor(executor) {
+    return executor === 'claude-code';
+}
+/**
+ * Get the display name for an executor type.
+ */
+export function getExecutorDisplayName(executor) {
+    switch (executor) {
+        case 'claude-code': return 'Claude Code';
+        case 'codex': return 'Codex';
+        case 'custom': return 'Custom';
+        default: return 'Claude Code';
+    }
+}
+/**
+ * Get the npm package name for an executor (for container installation).
+ */
+export function getExecutorPackage(executor) {
+    switch (executor) {
+        case 'claude-code': return '@anthropic-ai/claude-code';
+        case 'codex': return '@openai/codex';
+        case 'custom': return null;
+        default: return '@anthropic-ai/claude-code';
+    }
+}
+/**
+ * Check executor binary availability on host.
+ */
+export function checkExecutorOnHost(executor) {
+    const { cmd } = getExecutorCommand(executor, 'preflight');
+    try {
+        execSync(`command -v ${cmd}`, { stdio: 'pipe' });
+        return { ok: true };
+    }
+    catch {
+        const pkg = getExecutorPackage(executor);
+        const installHint = pkg ? `Install it with: npm install -g ${pkg}` : 'Install and configure the executor binary.';
+        return {
+            ok: false,
+            error: `${getExecutorDisplayName(executor)} CLI not found on host (missing "${cmd}"). ${installHint}`,
+        };
+    }
+}
+/**
+ * Check executor binary availability inside a container.
+ */
+export function checkExecutorInContainer(executor, containerId) {
+    const { cmd } = getExecutorCommand(executor, 'preflight');
+    try {
+        execSync(`docker exec ${containerId} sh -lc 'command -v ${cmd}'`, { stdio: 'pipe' });
+        return { ok: true };
+    }
+    catch {
+        const pkg = getExecutorPackage(executor);
+        const installHint = pkg ? `Container image is missing ${pkg}.` : `Container image is missing "${cmd}".`;
+        return {
+            ok: false,
+            error: `${getExecutorDisplayName(executor)} CLI not found in container (missing "${cmd}"). ${installHint}`,
+        };
+    }
+}
+/**
+ * Run executor preflight checks for the target environment.
+ */
+export function runExecutorPreflight(environment, executor, options) {
+    const env = normalizeEnvironment(environment);
+    if (env === 'host' || env === 'sandbox') {
+        return checkExecutorOnHost(executor);
+    }
+    if (env === 'devcontainer' && options?.containerId) {
+        return checkExecutorInContainer(executor, options.containerId);
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=executor.js.map

package/dist/lib/execution/runners/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../src/lib/execution/runners/executor.ts"],"names":[],"mappings":"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"}

package/dist/lib/execution/runners/host.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Host Runner — tmux session persistence on macOS
+ */
+import { DisplayMode, ExecutorType, ExecutionContext, ExecutionConfig, RunnerResult } from './shared.js';
+/**
+ * Run command on the host machine with tmux session for persistence.
+ * Supports multiple terminal emulators on macOS.
+ *
+ * Architecture (same as devcontainer):
+ * - Always creates a host tmux session for session persistence
+ * - displayMode controls whether to open a terminal tab attached to the session
+ * - User can reattach with `prlt session attach` if tab is closed
+ */
+export declare function runHost(context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig, displayMode?: DisplayMode): Promise<RunnerResult>;

package/dist/lib/execution/runners/host.js

@@ -0,0 +1,437 @@
+/**
+ * Host Runner — tmux session persistence on macOS
+ */
+import { execSync, fs, path, os, getSetTitleCommands, resolveCodexExecutionContext, validateCodexMode, getCodexCommand, resolveToolsForSpawn, buildWindowTitle, buildTmuxWindowName, buildPrompt, buildOrchestratorSystemPrompt, getExecutorCommand, isClaudeExecutor, shouldUseControlMode, buildTmuxMouseOption, buildTmuxAttachCommand, configureITermTmuxWindowMode, } from './shared.js';
+import { buildSrtCommand } from './sandbox.js';
+/**
+ * Run command on the host machine with tmux session for persistence.
+ * Supports multiple terminal emulators on macOS.
+ *
+ * Architecture (same as devcontainer):
+ * - Always creates a host tmux session for session persistence
+ * - displayMode controls whether to open a terminal tab attached to the session
+ * - User can reattach with `prlt session attach` if tab is closed
+ */
+export async function runHost(context, executor, config, displayMode = 'terminal') {
+    // Session name: {ticketId}-{action} (e.g., TKT-347-implement)
+    const sessionName = buildTmuxWindowName(context);
+    const windowTitle = buildWindowTitle(context);
+    const prompt = buildPrompt(context);
+    // Terminal - use permission mode setting
+    const skipPermissions = config.permissionMode === 'danger';
+    // Validate Codex mode combination before proceeding
+    if (executor === 'codex') {
+        const codexPermission = config.permissionMode;
+        const codexContext = resolveCodexExecutionContext(displayMode, config.outputMode);
+        const modeError = validateCodexMode(codexPermission, codexContext);
+        if (modeError) {
+            return { success: false, error: modeError.message };
+        }
+    }
+    const { cmd, args } = getExecutorCommand(executor, prompt, skipPermissions);
+    // Write command to temp script to avoid shell escaping issues
+    // Use HQ .proletariat/scripts if available, otherwise fallback to home dir
+    const baseDir = context.hqPath
+        ? path.join(context.hqPath, '.proletariat', 'scripts')
+        : path.join(os.homedir(), '.proletariat', 'scripts');
+    fs.mkdirSync(baseDir, { recursive: true });
+    const timestamp = Date.now();
+    const scriptPath = path.join(baseDir, `exec-${context.ticketId}-${timestamp}.sh`);
+    const promptPath = path.join(baseDir, `prompt-${context.ticketId}-${timestamp}.txt`);
+    // For orchestrator sessions with Claude Code, split the prompt:
+    // - System prompt (role/tools/context) → injected via --system-prompt flag
+    // - User message (action instructions or default) → passed as the initial message
+    // Non-Claude executors get the full combined prompt as the user message.
+    let systemPromptPath = null;
+    if (context.isOrchestrator && isClaudeExecutor(executor)) {
+        const systemPrompt = buildOrchestratorSystemPrompt(context);
+        systemPromptPath = path.join(baseDir, `system-prompt-${context.ticketId}-${timestamp}.txt`);
+        fs.writeFileSync(systemPromptPath, systemPrompt, { mode: 0o644 });
+        // Override user message: just action instructions or a default startup message
+        const userMessage = context.actionPrompt
+            || 'Assess the current state of the project:\n'
+                + '1. Check the board: `prlt board view` — what tickets are in progress, blocked, or ready?\n'
+                + '2. List running agents: `prlt session list` — who is working on what? Any stale sessions?\n'
+                + '3. Check open PRs: `gh pr list` — any PRs ready for review or merge?\n'
+                + '4. Summarize what needs attention and recommend next actions.';
+        fs.writeFileSync(promptPath, userMessage, { mode: 0o644 });
+    }
+    else {
+        // Write full prompt (includes role context for non-Claude executors)
+        fs.writeFileSync(promptPath, prompt, { mode: 0o644 });
+    }
+    // Tool registry (TKT-083): generate MCP config for Claude Code
+    let mcpConfigPath = null;
+    if (context.hqPath && isClaudeExecutor(executor)) {
+        const toolsResult = resolveToolsForSpawn(context.hqPath, context.toolPolicy, baseDir);
+        mcpConfigPath = toolsResult.mcpConfigPath;
+    }
+    // Build the executor command using getExecutorCommand() output
+    // For Claude Code, we also support outputMode and additional flags
+    // For Codex, we use the codex adapter for deterministic command building (TKT-080)
+    // For other executors, we use the command as-is from getExecutorCommand()
+    let executorInvocation;
+    if (isClaudeExecutor(executor)) {
+        // Build flags based on config - Claude-specific flags
+        // PRLT-948: --permission-mode bypassPermissions skips the "trust this folder" dialog.
+        // Without it, Claude Code shows a workspace trust prompt in new worktrees and the
+        // agent sits idle waiting for user input that never comes in automated tmux sessions.
+        const bypassTrustFlag = skipPermissions ? '--permission-mode bypassPermissions ' : '';
+        const permissionsFlag = skipPermissions ? '--dangerously-skip-permissions ' : '';
+        // outputMode: 'print' adds -p flag (final result only), 'interactive' shows streaming UI
+        const printFlag = config.outputMode === 'print' ? '-p ' : '';
+        // --effort high: skips the effort level prompt for automated agents (TKT-1134)
+        const effortFlag = skipPermissions ? '--effort high ' : '';
+        // Orchestrator sessions inject their role via --system-prompt
+        const systemPromptFlag = systemPromptPath ? '--system-prompt "$(cat "$SYSTEM_PROMPT_PATH")" ' : '';
+        // TKT-053: Disable plan mode for background agents — prevents silent stalls
+        // when there's no user to approve the plan mode transition
+        const disallowPlanFlag = displayMode === 'background' ? '--disallowedTools EnterPlanMode ' : '';
+        // Tool registry (TKT-083): pass MCP config to Claude Code via --mcp-config flag
+        const mcpConfigFlag = mcpConfigPath ? `--mcp-config "${mcpConfigPath}" ` : '';
+        // PRLT-950: Use -- to separate flags from positional prompt argument.
+        // --disallowedTools is variadic and will consume the prompt as its second arg without --.
+        executorInvocation = `${cmd} ${bypassTrustFlag}${permissionsFlag}${effortFlag}${printFlag}${disallowPlanFlag}${systemPromptFlag}${mcpConfigFlag}-- "$(cat "$PROMPT_PATH")"`;
+    }
+    else if (executor === 'codex') {
+        // TKT-080: Use Codex adapter for deterministic command building.
+        // Uses PLACEHOLDER pattern for reliable prompt replacement (same as devcontainer runner).
+        const codexPermission = config.permissionMode;
+        const codexContext = resolveCodexExecutionContext(displayMode, config.outputMode);
+        const codexResult = getCodexCommand('PLACEHOLDER', codexPermission, codexContext);
+        const argsStr = codexResult.args.map(a => a === 'PLACEHOLDER' ? '"$(cat "$PROMPT_PATH")"' : a).join(' ');
+        executorInvocation = `${codexResult.cmd} ${argsStr}`;
+    }
+    else {
+        // Non-Claude, non-Codex executors: build command from getExecutorCommand() args
+        // Use PLACEHOLDER for reliable prompt replacement instead of fragile string comparison
+        const { cmd: execCmd, args: execArgs } = getExecutorCommand(executor, 'PLACEHOLDER', skipPermissions);
+        const argsWithFile = execArgs.map(a => a === 'PLACEHOLDER' ? '"$(cat "$PROMPT_PATH")"' : `"${a}"`);
+        executorInvocation = `${execCmd} ${argsWithFile.join(' ')}`;
+    }
+    // Build script that runs executor and keeps shell open after completion
+    const setTitleCmds = getSetTitleCommands(windowTitle);
+    // TKT-941: Export SYSTEM_PROMPT_PATH so it's available inside srt sandbox child processes.
+    // Without export, `bash -c '...'` inside srt can't access the variable.
+    const systemPromptVar = systemPromptPath ? `\nexport SYSTEM_PROMPT_PATH="${systemPromptPath}"` : '';
+    // Ephemeral agents auto-close after completion instead of dropping to interactive shell
+    const postExecBlock = context.isEphemeral
+        ? `
+echo ""
+echo "✅ Ephemeral agent work complete. Session will auto-close in 5s..."
+sleep 5
+exit 0
+`
+        : `
+echo ""
+echo "✅ Agent work complete. Press Enter to close or run more commands."
+exec $SHELL
+`;
+    // Wrap with srt sandbox if running in sandbox environment
+    let finalInvocation = executorInvocation;
+    if (context.executionEnvironment === 'sandbox') {
+        // Build the srt wrapper command
+        // The inner command is the executor invocation that reads from PROMPT_PATH
+        const srtCmd = buildSrtCommand(`bash -c '${executorInvocation.replace(/'/g, "'\\''")}'`, context, config);
+        finalInvocation = srtCmd;
+    }
+    // TKT-099: Build a fallback invocation WITHOUT the prompt argument.
+    // Used when prompt file is missing/empty — starts Claude in interactive mode
+    // so the agent at least gets a working session instead of silently failing.
+    let fallbackInvocation;
+    if (isClaudeExecutor(executor)) {
+        const fbBypassTrust = skipPermissions ? '--permission-mode bypassPermissions ' : '';
+        const fbPermissions = skipPermissions ? '--dangerously-skip-permissions ' : '';
+        const fbEffort = skipPermissions ? '--effort high ' : '';
+        const fbPrint = config.outputMode === 'print' ? '-p ' : '';
+        const fbDisallowPlan = displayMode === 'background' ? '--disallowedTools EnterPlanMode ' : '';
+        const fbSystemPrompt = systemPromptPath ? '--system-prompt "$(cat "$SYSTEM_PROMPT_PATH")" ' : '';
+        const fbMcpConfig = mcpConfigPath ? `--mcp-config "${mcpConfigPath}" ` : '';
+        fallbackInvocation = `${cmd} ${fbBypassTrust}${fbPermissions}${fbEffort}${fbPrint}${fbDisallowPlan}${fbSystemPrompt}${fbMcpConfig}`.trim();
+    }
+    else {
+        fallbackInvocation = cmd;
+    }
+    const scriptContent = `#!/bin/bash
+# Auto-generated script for ticket ${context.ticketId}
+SCRIPT_PATH="${scriptPath}"
+# TKT-941: Export PROMPT_PATH so it's available inside srt sandbox child processes.
+# When running in sandbox mode, the executor is wrapped with:
+#   srt ... -- bash -c 'claude ... "$(cat "$PROMPT_PATH")"'
+# Without export, the inner bash started by srt cannot access PROMPT_PATH,
+# causing $(cat "$PROMPT_PATH") to expand to empty and the agent to start idle.
+export PROMPT_PATH="${promptPath}"${systemPromptVar}
+${setTitleCmds}
+echo "🚀 Starting: ${sessionName}"
+${context.executionEnvironment === 'sandbox' ? 'echo "🔒 Running in srt sandbox (filesystem + network isolation)"' : ''}
+echo ""
+cd "${context.worktreePath}"
+
+# TKT-099: Robust prompt loading — wait for file and verify content before passing to executor.
+# Prevents race where the prompt file isn't flushed/synced yet (e.g., Docker file-sharing
+# delay, tmux server restart, or transient filesystem latency).
+PROMPT_WAIT=0
+while [ ! -s "$PROMPT_PATH" ] && [ $PROMPT_WAIT -lt 30 ]; do
+  sleep 0.5
+  PROMPT_WAIT=$((PROMPT_WAIT + 1))
+done
+
+if [ ! -s "$PROMPT_PATH" ]; then
+  echo "⚠️  Warning: Prompt file not available after 15s. Starting in interactive mode."
+  echo "   Expected: $PROMPT_PATH"
+  # Fallback: launch executor without prompt so the session isn't lost
+  (unset CLAUDECODE CLAUDE_CODE_ENTRYPOINT; ${fallbackInvocation})
+else
+  # Run executor in subshell with CLAUDECODE unset (prevents nested session error)
+  (unset CLAUDECODE CLAUDE_CODE_ENTRYPOINT; ${finalInvocation})
+fi
+
+# Clean up script and prompt files
+rm -f "$SCRIPT_PATH" "$PROMPT_PATH"${systemPromptPath ? ' "$SYSTEM_PROMPT_PATH"' : ''}
+${postExecBlock}`;
+    fs.writeFileSync(scriptPath, scriptContent, { mode: 0o755 });
+    try {
+        // Check if tmux is available
+        execSync('which tmux', { stdio: 'pipe' });
+        const terminalApp = config.terminal.app;
+        // Check if we should use iTerm control mode (-CC)
+        // When using -CC, iTerm handles scrolling/selection natively, so we DON'T set mouse on
+        // Without -CC, we need mouse on for tmux to handle scrolling
+        const useControlMode = shouldUseControlMode(terminalApp, config.tmux.controlMode);
+        // Step 1: Create host tmux session (detached)
+        // Only enable mouse mode if NOT using control mode (control mode lets iTerm handle mouse natively)
+        const mouseOption = buildTmuxMouseOption(useControlMode);
+        const tmuxCmd = `tmux new-session -d -s "${sessionName}" -n "${sessionName}" "${scriptPath}"${mouseOption} \\; set-option -g set-titles on \\; set-option -g set-titles-string "#{window_name}"`;
+        try {
+            execSync(tmuxCmd, { stdio: 'pipe' });
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to create tmux session: ${error instanceof Error ? error.message : error}`,
+            };
+        }
+        // Step 2: Open terminal tab attached to tmux session (unless background or foreground mode)
+        if (displayMode === 'background') {
+            return {
+                success: true,
+                sessionId: sessionName,
+            };
+        }
+        // Foreground mode: attach to tmux session in current terminal (blocking)
+        if (displayMode === 'foreground') {
+            try {
+                // Clear screen and attach - this blocks until user detaches or claude exits
+                // Never use -CC in foreground mode: control mode sends raw tmux protocol
+                // sequences (%begin, %output, %end) that render as garbled text unless
+                // iTerm's native CC handler is active (only happens in new tabs opened via AppleScript)
+                const fgTmuxAttach = buildTmuxAttachCommand(false);
+                execSync(`clear && ${fgTmuxAttach} -t "${sessionName}"`, { stdio: 'inherit' });
+                return {
+                    success: true,
+                    sessionId: sessionName,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to attach to tmux session: ${error instanceof Error ? error.message : error}`,
+                };
+            }
+        }
+        // Use tmux -CC (control mode) for iTerm when enabled in config
+        // -CC gives native iTerm scrolling, selection, and gesture support
+        // Without -CC, use regular attach (relies on mouse mode for scrolling)
+        const tmuxAttach = buildTmuxAttachCommand(useControlMode);
+        const attachCmd = `clear && ${tmuxAttach} -t \\"${sessionName}\\"`;
+        // For iTerm with control mode, create a new tab and run -CC attach there
+        // This avoids interfering with the terminal where prlt is running
+        if (terminalApp === 'iTerm' && useControlMode) {
+            // Configure iTerm to open tmux windows as tabs or windows based on user preference
+            configureITermTmuxWindowMode(config.tmux.windowMode);
+            const openInBackground = config.terminal.openInBackground ?? true;
+            if (openInBackground) {
+                // Open tab without stealing focus - save frontmost app and restore after
+                execSync(`osascript -e '
+          set frontApp to path to frontmost application as text
+          tell application "iTerm"
+            tell current window
+              set newTab to (create tab with default profile)
+              tell current session of newTab
+                write text "tmux -u -CC attach -d -t \\"${sessionName}\\""
+              end tell
+            end tell
+          end tell
+          tell application frontApp to activate
+        '`);
+            }
+            else {
+                execSync(`osascript -e '
+          tell application "iTerm"
+            activate
+            tell current window
+              set newTab to (create tab with default profile)
+              tell current session of newTab
+                write text "tmux -u -CC attach -d -t \\"${sessionName}\\""
+              end tell
+            end tell
+          end tell
+        '`);
+            }
+            return {
+                success: true,
+                sessionId: sessionName,
+            };
+        }
+        // Check if we should open in background (don't steal focus)
+        const openInBackground = config.terminal.openInBackground ?? true;
+        switch (terminalApp) {
+            case 'iTerm':
+                // Without control mode, create a new tab and attach normally
+                // When openInBackground is true, save frontmost app and restore after
+                if (openInBackground) {
+                    execSync(`osascript -e '
+            -- Save the currently active application and window
+            tell application "System Events"
+              set frontApp to name of first application process whose frontmost is true
+              set frontAppBundle to bundle identifier of first application process whose frontmost is true
+            end tell
+
+            tell application "iTerm"
+              if (count of windows) = 0 then
+                create window with default profile
+                delay 0.3
+                tell current session of current window
+                  set name to "${windowTitle}"
+                  write text "${attachCmd}"
+                end tell
+              else
+                tell current window
+                  set newTab to (create tab with default profile)
+                  delay 0.3
+                  tell current session of newTab
+                    set name to "${windowTitle}"
+                    write text "${attachCmd}"
+                  end tell
+                end tell
+              end if
+            end tell
+
+            -- Restore focus to the original application
+            delay 0.2
+            tell application "System Events"
+              set frontmost of process frontApp to true
+            end tell
+            delay 0.1
+            do shell script "open -b " & quoted form of frontAppBundle
+          '`);
+                }
+                else {
+                    execSync(`osascript -e '
+            tell application "iTerm"
+              activate
+              if (count of windows) = 0 then
+                create window with default profile
+                delay 0.3
+                tell current session of current window
+                  set name to "${windowTitle}"
+                  write text "${attachCmd}"
+                end tell
+              else
+                tell current window
+                  set newTab to (create tab with default profile)
+                  delay 0.3
+                  tell current session of newTab
+                    set name to "${windowTitle}"
+                    write text "${attachCmd}"
+                  end tell
+                end tell
+              end if
+            end tell
+          '`);
+                }
+                break;
+            case 'Ghostty':
+                // Ghostty - use osascript to open new tab and run command
+                execSync(`osascript -e '
+          tell application "Ghostty"
+            activate
+          end tell
+          tell application "System Events"
+            tell process "Ghostty"
+              keystroke "t" using command down
+              delay 0.3
+              keystroke "${attachCmd}"
+              keystroke return
+            end tell
+          end tell
+        '`);
+                break;
+            case 'WezTerm':
+                // WezTerm - use wezterm cli to spawn new tab
+                execSync(`wezterm cli spawn --new-window -- bash -c '${attachCmd}'`);
+                break;
+            case 'Kitty':
+                // Kitty - use kitten to open new tab
+                execSync(`kitty @ launch --type=tab -- bash -c '${attachCmd}'`);
+                break;
+            case 'Alacritty':
+                // Alacritty doesn't have native tab support, opens new window
+                execSync(`osascript -e '
+          tell application "Alacritty"
+            activate
+          end tell
+          tell application "System Events"
+            tell process "Alacritty"
+              keystroke "n" using command down
+              delay 0.3
+              keystroke "${attachCmd}"
+              keystroke return
+            end tell
+          end tell
+        '`);
+                break;
+            case 'Terminal':
+            default:
+                // macOS Terminal.app - new tab
+                // Note: Terminal.app with System Events keystrokes requires activation for Cmd+T
+                // But we can use 'do script' which opens a new window without activation if needed
+                if (openInBackground) {
+                    // Open in background: use 'do script' which creates a new window without activating
+                    execSync(`osascript -e '
+            tell application "Terminal"
+              do script "${attachCmd}"
+              set custom title of front window to "${windowTitle}"
+            end tell
+          '`);
+                }
+                else {
+                    // Bring to front: use traditional Cmd+T for new tab
+                    execSync(`osascript -e '
+            tell application "Terminal"
+              activate
+              tell application "System Events"
+                tell process "Terminal"
+                  keystroke "t" using command down
+                end tell
+              end tell
+              delay 0.3
+              do script "${attachCmd}" in front window
+            end tell
+          '`);
+                }
+                break;
+        }
+        return {
+            success: true,
+            sessionId: sessionName,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : `Failed to start host tmux session`,
+        };
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/lib/execution/runners/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../../../src/lib/execution/runners/host.ts"],"names":[],"mappings":"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"}

package/dist/lib/execution/runners/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Execution Runners
+ *
+ * Dispatcher and re-exports for all execution environment runners.
+ * Each runner is in its own module for independent testability and maintainability.
+ *
+ * Modules:
+ * - shared.ts — Shared utilities (session names, credentials, docker, prompts, etc.)
+ * - host.ts — Host runner with tmux session persistence
+ * - devcontainer.ts — Docker container runner with raw Docker commands
+ * - docker.ts — Simple detached Docker container runner
+ * - orchestrator.ts — Orchestrator-in-Docker runner (sibling container pattern)
+ * - sandbox.ts — srt sandbox runner (wraps host runner)
+ * - cloud.ts — Remote execution via SSH
+ */
+import { ExecutionEnvironment, DisplayMode, SessionManager, ExecutorType, ExecutionContext, ExecutionConfig } from './shared.js';
+import { RunnerResult } from './shared.js';
+export declare function runExecution(environment: ExecutionEnvironment, context: ExecutionContext, executor: ExecutorType, config?: ExecutionConfig, options?: {
+    host?: string;
+    displayMode?: DisplayMode;
+    sessionManager?: SessionManager;
+}): Promise<RunnerResult>;
+export { RunnerResult, Runner, buildSessionName, buildWindowTitle, buildTmuxWindowName, shouldUseControlMode, buildTmuxMouseOption, buildTmuxAttachCommand, configureITermTmuxPreferences, configureITermTmuxWindowMode, CLAUDE_CREDENTIALS_VOLUME, credentialsVolumeExists, dockerCredentialsExist, getDockerCredentialInfo, hostCredentialsExist, getExecutorCommand, isClaudeExecutor, getExecutorDisplayName, getExecutorPackage, PreflightResult, checkExecutorOnHost, checkExecutorInContainer, runExecutorPreflight, getGitHubToken, isGitHubTokenAvailable, DockerDaemonStatus, checkDockerDaemon, isDockerRunning, isDevcontainerCliInstalled, getHostPrltVersion, getAgentContainerName, containerExists, isContainerRunning, getContainerId, buildPrompt, buildOrchestratorSystemPrompt, buildIntegrationCommandsSection, } from './shared.js';
+export { runHost } from './host.js';
+export { runDevcontainer, buildDevcontainerCommand } from './devcontainer.js';
+export { runDocker } from './docker.js';
+export { runOrchestratorInDocker } from './orchestrator.js';
+export { runSandbox, isSrtInstalled, buildSrtCommand } from './sandbox.js';
+export { runCloud, runVm } from './cloud.js';