/**
 * oh-my-codex CLI
 * Multi-agent orchestration for OpenAI Codex CLI
 */
import { type SetupInstallMode, type SetupMcpMode, type SetupScope, type SetupTeamMode } from "./setup.js";
import { type CleanupDependencies, type CleanupResult } from "./cleanup.js";
export { readPersistedSetupPreferences, readPersistedSetupScope, resolveCodexConfigPathForLaunch, resolveCodexHomeForLaunch, resolveProjectLocalCodexHomeForLaunch, } from "./codex-home.js";
import { type UpdateChannel } from "./update.js";
import type { UnifiedMcpRegistryServer } from "../config/mcp-registry.js";
import { type RegisterHudResizeHookOptions } from "../hud/tmux.js";
export { parseTmuxPaneSnapshot, isHudWatchPane, findHudWatchPaneIds } from "../hud/tmux.js";
import { type NotifyTempContract, type ParseNotifyTempContractResult } from "../notifications/temp-contract.js";
export declare function resolveNotifyFallbackWatcherScript(pkgRoot?: string): string;
export declare function resolveHookDerivedWatcherScript(pkgRoot?: string): string;
export declare function resolveNotifyHookScript(pkgRoot?: string): string;
export declare const HELP = "\noh-my-codex (omx) - Multi-agent orchestration for Codex CLI\n\nUsage:\n  omx           Launch Codex CLI (detached tmux by default on supported interactive terminals)\n  omx exec      Run codex exec non-interactively with OMX AGENTS/overlay injection\n  omx exec inject <session-id> --prompt <text>\n                Queue audited follow-up instructions for a running non-interactive exec job\n  omx mission <file>\n                Run a prompt/checklist file sequentially through omx exec with durable summary\n  omx imagegen continuation <session-id> --artifact <name>\n                Queue a Stop-hook continuation for built-in image generation turns\n  omx setup     Install skills, prompts, CLI-first config, and scope-specific AGENTS.md\n                (user scope prompts for legacy vs plugin skill delivery when needed)\n  omx update    Install the stable channel now, then refresh setup\n  omx update --stable\n                Install/rollback to npm stable (oh-my-codex@latest), then refresh setup\n  omx update --dev\n                Install the upstream dev branch, then refresh setup\n  omx uninstall Remove OMX configuration and clean up installed artifacts\n  omx doctor    Check installation health\n  omx list      List packaged OMX skills and native agent prompts (--json)\n  omx cleanup   Kill orphaned OMX MCP server processes and remove stale OMX /tmp directories\n  omx doctor --team  Check team/swarm runtime health diagnostics\n  omx ask       Ask local provider CLI (claude|gemini) and write artifact output\n  omx auth      Manage Codex OAuth auth slots (add|list|use)\n  omx question  OMX-owned blocking question UI entrypoint for agent-invoked user questions\n  omx adapt     Scaffold OMX-owned adapter foundations for persistent external targets\n  omx resume    Resume Codex sessions (supports --project and --codex-home <path>)\n  omx explore   DEPRECATED compatibility command; use normal repo inspection or omx sparkshell\n  omx api       Run native omx-api localhost gateway commands (serve|status|stop|generate)\n  omx session   Search and summarize local session history (--codex-home <path> escape hatch)\n  omx url       Passive URL reader (read <url> --json)\n  omx agents-init [path]\n                Bootstrap lightweight AGENTS.md files for a repo/subtree\n  omx agents    Manage Codex native agent TOML files\n  omx deepinit [path]\n                Alias for agents-init (lightweight AGENTS bootstrap only)\n  omx team      Spawn parallel worker panes in tmux and bootstrap inbox/task state\n  omx ralph     Launch Codex with ralph persistence mode active\n  omx ultragoal Create, resume, and checkpoint durable multi-goal plans over Codex goal mode\n  omx performance-goal\n                Create, hand off, and gate evaluator-backed performance goals\n  omx autoresearch-goal\n                Create, hand off, and gate professor-critic research goals\n  omx autoresearch [DEPRECATED] Use $autoresearch; direct CLI launch removed\n  omx version   Show version information\n  omx tmux-hook Manage tmux prompt injection workaround (init|status|validate|test)\n  omx hooks     Manage hook plugins (init|status|validate|test)\n  omx hud       Show HUD statusline (--watch, --json, --preset=NAME)\n  omx sidecar   Show read-only team/multi-agent visualization (--watch, --json, --tmux)\n  omx state     Read/write/list OMX mode state via CLI parity surface\n  omx notepad   JSON CLI surface for OMX notepad operations\n  omx project-memory\n                JSON CLI surface for OMX project-memory operations\n  omx trace     JSON CLI surface for OMX trace operations\n  omx code-intel\n                JSON CLI surface for OMX code-intel operations\n  omx wiki      JSON CLI surface for OMX wiki operations\n  omx mcp-serve Launch an OMX stdio MCP server target (plugin/runtime use)\n  omx sparkshell <command> [args...]\n  omx sparkshell --tmux-pane <pane-id> [--tail-lines <100-1000>]\n                Run native sparkshell sidecar for direct command execution or explicit tmux-pane summarization\n                (also used as an adaptive backend for qualifying read-only explore tasks)\n  omx help      Show this help message\n  omx status    Show active modes and state\n  omx cancel    Cancel active execution modes\n  omx reasoning Show or set model reasoning effort (low|medium|high|xhigh)\n\nOptions:\n  --yolo        Launch Codex in yolo mode (shorthand for: omx launch --yolo)\n  --high        Launch Codex with high reasoning effort\n                (shorthand for: -c model_reasoning_effort=\"high\")\n  --xhigh       Launch Codex with xhigh reasoning effort\n                (shorthand for: -c model_reasoning_effort=\"xhigh\")\n  --madmax      DANGEROUS: bypass Codex approvals and sandbox\n                (alias for --dangerously-bypass-approvals-and-sandbox)\n  --spark       Use the Codex spark model (~1.3x faster) for team workers only\n                Workers get the configured low-complexity team model; leader model unchanged\n  --madmax-spark  spark model for workers + bypass approvals for leader and workers\n                (shorthand for: --spark --madmax)\n  --notify-temp  Enable temporary notification routing for this run/session only\n  --hotswap     Run a direct Codex session that rotates auth slots on 429/quota and resumes\n  --direct       Launch the interactive leader directly without OMX tmux/HUD management\n  --tmux         Launch the interactive leader session in detached tmux\n  --discord      Select Discord provider for temporary notification mode\n  --slack        Select Slack provider for temporary notification mode\n  --telegram     Select Telegram provider for temporary notification mode\n  --custom <name>\n                Select custom/OpenClaw gateway name for temporary notification mode\n  -w, --worktree[=<name>]\n                Launch Codex in a git worktree (detached when no name is given)\n  --force       Force reinstall (overwrite existing files)\n  --merge-agents\n                Merge OMX-managed AGENTS.md sections into an existing AGENTS.md\n                instead of overwriting user-authored content\n  --dry-run     Show what would be done without doing it\n  --plugin      Use Codex plugin delivery for omx setup and remove legacy OMX-managed user/project components\n  --legacy      Use legacy setup delivery for omx setup, overriding persisted plugin mode\n  --install-mode <legacy|plugin>\n                Explicit setup install mode (canonical form; --legacy/--plugin are aliases)\n  --mcp <none|compat>\n                Explicit setup MCP mode (default: none; compat enables first-party MCP compatibility and shared registry sync)\n  --no-mcp      Alias for --mcp=none\n  --with-mcp    Alias for --mcp=compat\n  --disable-team\n                Disable Team skill/context generation for setup (default remains enabled)\n  --enable-team Re-enable Team skill/context generation for setup\n  --team-mode <enabled|disabled>\n                Explicit Team setup mode\n  --keep-config Skip config.toml cleanup during uninstall\n  --purge       Remove .omx/ cache directory during uninstall\n  --verbose     Show detailed output\n  --scope       Setup scope for \"omx setup\" only:\n                user | project\n\nLaunch policy:\n  OMX_LAUNCH_POLICY=auto\n                Use the default policy: detached tmux when supported, direct otherwise\n  OMX_LAUNCH_POLICY=direct\n                Run without OMX tmux/HUD management\n  OMX_LAUNCH_POLICY=tmux\n                Force OMX-managed detached tmux launch\n  OMX_LAUNCH_POLICY=detached-tmux\n                Force OMX-managed detached tmux launch\n  CLI policy flags (--direct/--tmux) override OMX_LAUNCH_POLICY; the last flag before -- wins.\n  Unset or empty OMX_LAUNCH_POLICY returns to auto/default behavior.\n  Config files are intentionally not used for launch policy in this release.\n";
type CliCommand = "launch" | "exec" | "mission" | "imagegen" | "setup" | "update" | "list" | "agents" | "agents-init" | "deepinit" | "uninstall" | "doctor" | "cleanup" | "auth" | "ask" | "question" | "adapt" | "explore" | "api" | "sparkshell" | "team" | "session" | "url" | "resume" | "version" | "tmux-hook" | "hooks" | "hud" | "sidecar" | "state" | "notepad" | "project-memory" | "trace" | "code-intel" | "wiki" | "mcp-serve" | "status" | "cancel" | "help" | "reasoning" | "codex-native-hook" | string;
export interface ResolvedCliInvocation {
    command: CliCommand;
    launchArgs: string[];
}
export declare function resolveSetupInstallModeArg(args: string[]): SetupInstallMode | undefined;
export declare function resolveSetupMcpModeArg(args: string[]): SetupMcpMode | undefined;
export declare function resolveSetupScopeArg(args: string[]): SetupScope | undefined;
export declare function resolveSetupTeamModeArg(args: string[]): SetupTeamMode | undefined;
export declare function resolveCliInvocation(args: string[]): ResolvedCliInvocation;
export declare function resolveUpdateChannelArg(args: string[]): UpdateChannel;
export declare function resolveNotifyTempContract(args: string[], env?: NodeJS.ProcessEnv): ParseNotifyTempContractResult;
export declare function commandOwnsLocalHelp(command: CliCommand): boolean;
export type CodexLaunchPolicy = "inside-tmux" | "detached-tmux" | "direct";
export declare function resolveLeaderLaunchPolicyOverride(args: string[]): CodexLaunchPolicy | undefined;
export declare function resolveEnvLaunchPolicyOverride(env?: NodeJS.ProcessEnv): CodexLaunchPolicy | undefined;
export declare function resolveEffectiveLeaderLaunchPolicyOverride(args: string[], env?: NodeJS.ProcessEnv): CodexLaunchPolicy | undefined;
export declare function resolveCodexLaunchPolicy(env?: NodeJS.ProcessEnv, _platform?: NodeJS.Platform, tmuxAvailable?: boolean, nativeWindows?: boolean, stdinIsTTY?: boolean, stdoutIsTTY?: boolean, explicitPolicy?: CodexLaunchPolicy): CodexLaunchPolicy;
export interface PreparedCodexHomeForLaunch {
    codexHomeOverride?: string;
    sqliteHomeOverride?: string;
    projectLocalCodexHomeForCleanup?: string;
    runtimeCodexHomeForCleanup?: string;
}
export declare const CODEX_SQLITE_HOME_ENV = "CODEX_SQLITE_HOME";
export declare function runtimeCodexHomePath(cwd: string, sessionId: string): string;
export declare function persistProjectLaunchRuntimeAuthState(runtimeCodexHome: string | undefined, projectCodexHome: string | undefined): Promise<void>;
/**
 * Project-scope setup keeps durable Codex config under <repo>/.codex, but the
 * Codex TUI also stores model-availability NUX counters in CODEX_HOME/config.toml.
 * Launch against a session mirror so those runtime writes never dirty the
 * durable project config while preserving the project config as the launch input.
 */
export interface PrepareRuntimeCodexHomeForProjectLaunchOptions {
    includeHistoryArtifacts?: boolean;
    extraHistoryCodexHomes?: string[];
}
export declare function prepareRuntimeCodexHomeForProjectLaunch(cwd: string, sessionId: string, projectCodexHome: string, options?: PrepareRuntimeCodexHomeForProjectLaunchOptions): Promise<string>;
export interface PrepareCodexHomeForLaunchOptions {
    includeHistoryArtifacts?: boolean;
    extraHistoryCodexHomes?: string[];
}
export declare function prepareCodexHomeForLaunch(cwd: string, sessionId: string, env?: NodeJS.ProcessEnv, options?: PrepareCodexHomeForLaunchOptions): Promise<PreparedCodexHomeForLaunch>;
export interface ResumeCodexHomeSelection {
    args: string[];
    explicitCodexHome?: string;
    projectOnly: boolean;
}
export declare function parseResumeCodexHomeSelection(args: string[]): ResumeCodexHomeSelection;
export interface ResumePluginPreflightResult {
    status: "unavailable" | "prepared";
    version?: string;
    cacheDir?: string;
    prunedStaleDirs: string[];
    configUpdated: boolean;
}
export declare function preflightResumeOmxPluginState(codexHomeDir: string | undefined, pkgRoot?: string): Promise<ResumePluginPreflightResult>;
export declare function persistProjectLaunchRuntimeProjectTrustState(runtimeCodexHome: string | undefined, projectCodexHome: string | undefined): Promise<void>;
export declare function cleanupRuntimeCodexHome(runtimeCodexHomeForCleanup?: string, projectCodexHomeForPersistence?: string): Promise<void>;
type HudResizeHookRegistrar = (hudPaneId: string, leaderPaneId: string | undefined, heightLines: number, options?: RegisterHudResizeHookOptions) => boolean;
export declare function buildInsideTmuxHudHookEnv(baseEnv: NodeJS.ProcessEnv, sessionId: string, currentPaneId: string | undefined, omxRootOverride?: string): NodeJS.ProcessEnv;
export declare function registerInsideTmuxHudResizeHook(options: {
    hudPaneId: string | null;
    currentPaneId: string | undefined;
    cwd: string;
    sessionId: string;
    omxRootOverride?: string;
    baseEnv?: NodeJS.ProcessEnv;
    register?: HudResizeHookRegistrar;
}): boolean;
export declare function buildDetachedHudHookEnv(baseEnv: NodeJS.ProcessEnv, sessionId: string, detachedLeaderPaneId: string, tmuxEnvValue: string, omxBin: string, omxRootOverride?: string): NodeJS.ProcessEnv;
export declare function registerDetachedHudLayoutReconcileHook(options: {
    hudPaneId: string | null;
    detachedLeaderPaneId: string | null;
    cwd: string;
    sessionId: string;
    omxBin: string;
    omxRootOverride?: string;
    baseEnv?: NodeJS.ProcessEnv;
    readTmuxEnvValue?: (targetPaneId: string) => string | undefined;
    register?: HudResizeHookRegistrar;
}): boolean;
export declare const DETACHED_TMUX_HISTORY_LIMIT = 500;
export interface TmuxLaunchHealth {
    usable: boolean;
    reason?: string;
}
export declare function checkDetachedTmuxLaunchHealth(): TmuxLaunchHealth;
export interface CodexExecFailureClassification {
    kind: "exit" | "launch-error";
    code?: string;
    message: string;
    exitCode?: number;
    signal?: NodeJS.Signals;
}
export declare function resolveSignalExitCode(signal: NodeJS.Signals | null | undefined): number;
export declare function classifyCodexExecFailure(error: unknown): CodexExecFailureClassification;
export declare function resolveLaunchConfigRepairOptions(cwd: string, configPath: string): Promise<{
    includeFirstPartyMcp: boolean;
    sharedMcpServers?: UnifiedMcpRegistryServer[];
    sharedMcpRegistrySource?: string;
}>;
export declare function omxRuntimeCommandShimFileName(platform?: NodeJS.Platform): string;
export declare function omxRuntimeCommandShimPath(cwd: string, platform?: NodeJS.Platform): string;
export declare function ensureOmxRuntimeCommandShim(cwd: string, omxBin: string, nodePath?: string, platform?: NodeJS.Platform): string;
export declare function prependOmxRuntimeCommandShimToEnv(cwd: string, env: NodeJS.ProcessEnv, omxBin: string, nodePath?: string, platform?: NodeJS.Platform): NodeJS.ProcessEnv;
export interface DetachedSessionTmuxStep {
    name: string;
    args: string[];
}
export declare function buildHudPaneCleanupTargets(existingPaneIds: string[], createdPaneId: string | null, leaderPaneId?: string): string[];
export declare function resolveOmxRootForLaunch(cwd: string, env?: NodeJS.ProcessEnv): string | undefined;
type HudRuntimeRootSource = 'team-env' | 'omx-root-env' | 'omx-state-root-env' | 'cwd-default';
interface HudRuntimeRootForLaunch {
    omxRoot?: string;
    omxStateRoot?: string;
    omxTeamStateRoot?: string;
    rootSource: HudRuntimeRootSource;
}
export declare function resolveHudRuntimeRootForLaunch(cwd: string, env?: NodeJS.ProcessEnv): HudRuntimeRootForLaunch;
export declare function resolveDisposableWorktreeOmxRootForLaunch(ensuredWorktree: {
    enabled: true;
    repoRoot: string;
} | {
    enabled: false;
} | undefined, env?: NodeJS.ProcessEnv): string | undefined;
interface MadmaxWorktreeRuntimeContext {
    omxRoot: string;
    omxStateRoot?: string;
    sourceCwd: string;
    worktreeCwd?: string;
    madmaxDetachedContext?: string;
    boxedActive?: true;
}
export declare function captureMadmaxWorktreeRuntimeContext(options: {
    originalLaunchArgs: readonly string[];
    worktreeEnabled: boolean;
    sourceCwd: string;
    worktreeCwd?: string;
    env?: NodeJS.ProcessEnv;
}): MadmaxWorktreeRuntimeContext | undefined;
export declare function shouldAutoIsolateMadmaxLaunch(command: string, launchArgs: string[], env?: NodeJS.ProcessEnv, cwd?: string): boolean;
interface MadmaxDetachedLockRetryOptions {
    maxAttempts?: number;
    retryMs?: number;
}
export declare function buildMadmaxDetachedLaunchContextKey(sourceCwd: string, argv: readonly string[], runIdentity?: string): string;
export declare function withMadmaxDetachedContextLock<T>(runsRoot: string, contextKey: string, run: () => T, options?: MadmaxDetachedLockRetryOptions): T;
export declare function createMadmaxIsolatedRoot(sourceCwd: string, argv: string[], env?: NodeJS.ProcessEnv): string;
export declare function main(args: string[]): Promise<void>;
export declare function launchWithAuthHotswap(args: string[]): Promise<void>;
export declare function launchWithHud(args: string[]): Promise<void>;
export declare function execWithOverlay(args: string[]): Promise<void>;
export declare function normalizeCodexLaunchArgs(args: string[]): string[];
/**
 * Returns the spark model string if --spark or --madmax-spark appears in the
 * raw (pre-normalize) args, or undefined if neither flag is present.
 * Used to route the spark model to team workers without affecting the leader.
 */
export declare function resolveWorkerSparkModel(args: string[], codexHomeOverride?: string): string | undefined;
export declare function resolveNativeSessionName(cwd: string, sessionId: string, env?: NodeJS.ProcessEnv): string;
export declare function injectModelInstructionsBypassArgs(cwd: string, args: string[], env?: NodeJS.ProcessEnv, defaultFilePath?: string): string[];
export declare function collectInheritableTeamWorkerArgs(codexArgs: string[]): string[];
export declare function resolveTeamWorkerLaunchArgsEnv(existingRaw: string | undefined, codexArgs: string[], inheritLeaderFlags?: boolean, defaultModel?: string): string | null;
export { readTopLevelTomlString, upsertTopLevelTomlString } from "../utils/toml.js";
export declare function buildTmuxSessionName(cwd: string, sessionId: string): string;
export declare function buildDetachedTmuxSessionName(cwd: string, sessionId: string): string;
export declare function detectDetachedSessionWindowIndex(sessionName: string): string | null;
type TmuxExecSync = (file: string, args: readonly string[]) => string;
export declare function acquireTmuxExtendedKeysLease(cwd: string, execFileSyncImpl?: TmuxExecSync, ownerPid?: number): string | null;
export declare function releaseTmuxExtendedKeysLease(cwd: string, leaseHandle: string, execFileSyncImpl?: TmuxExecSync): void;
export declare function serializeDetachedSessionParentEnv(env: NodeJS.ProcessEnv): string;
export declare function detachedSessionParentEnvFilePath(cwd: string, sessionId: string): string;
export declare function writeDetachedSessionParentEnvFile(cwd: string, sessionId: string, env: NodeJS.ProcessEnv): string;
export declare function withTmuxExtendedKeys<T>(cwd: string, run: () => T, execFileSyncImpl?: TmuxExecSync): T;
export declare function buildDetachedSessionBootstrapSteps(sessionName: string, cwd: string, codexCmd: string, hudCmd: string, workerLaunchArgs: string | null, codexHomeOverride?: string, notifyTempContractRaw?: string | null, nativeWindows?: boolean, sessionId?: string, projectLocalCodexHomeForCleanup?: string, runtimeCodexHomeForCleanup?: string, omxRootOverride?: string, env?: NodeJS.ProcessEnv, sqliteHomeOverride?: string, parentEnvFilePath?: string, inheritedWorkerModel?: string | null): DetachedSessionTmuxStep[];
export declare function shouldAttachDetachedTmuxSession(env?: NodeJS.ProcessEnv): boolean;
export declare function buildDetachedSessionFinalizeSteps(sessionName: string, hudPaneId: string | null, hookWindowIndex: string | null, enableMouse: boolean, nativeWindows?: boolean, attachSession?: boolean, leaderPaneId?: string | null): DetachedSessionTmuxStep[];
export declare function buildDetachedSessionRollbackSteps(sessionName: string, hookTarget: string | null, hookName: string | null, clientAttachedHookName: string | null): DetachedSessionTmuxStep[];
export declare function buildNotifyTempStartupMessages(contract: NotifyTempContract, hasValidProviders: boolean): {
    infoLines: string[];
    warningLines: string[];
};
export declare function buildNotifyFallbackWatcherEnv(env?: NodeJS.ProcessEnv, options?: {
    codexHomeOverride?: string;
    omxRootOverride?: string;
    enableAuthority?: boolean;
    sessionId?: string;
}): NodeJS.ProcessEnv;
export declare function shouldEnableNotifyFallbackWatcher(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
export declare function cleanupLaunchOrphanedMcpProcesses(dependencies?: CleanupDependencies): Promise<CleanupResult>;
interface PostLaunchCleanupDependencies {
    cleanup?: () => Promise<CleanupResult>;
    writeInfo?: (line: string) => void;
    writeWarn?: (line: string) => void;
    writeError?: (line: string) => void;
}
interface PostLaunchModeCleanupDependencies {
    readdir?: typeof import("fs/promises").readdir;
    readFile?: typeof import("fs/promises").readFile;
    writeFile?: typeof import("fs/promises").writeFile;
    sleep?: (ms: number) => Promise<void>;
    writeWarn?: (line: string) => void;
    now?: () => Date;
}
export declare function cleanupPostLaunchModeStateFiles(cwd: string, sessionId: string, dependencies?: PostLaunchModeCleanupDependencies): Promise<void>;
export declare function reapPostLaunchOrphanedMcpProcesses(dependencies?: PostLaunchCleanupDependencies): Promise<void>;
/**
 * preLaunch: Prepare environment before Codex starts.
 * 1. Best-effort launch-safe orphan cleanup for detached OMX MCP processes
 * 2. Generate runtime overlay + write session-scoped model instructions file
 * 3. Write session.json
 *
 * Automatic broad stale-session cleanup remains disabled here. Only detached
 * OMX MCP processes without a live Codex ancestor are reaped so new launches
 * do not accumulate stale processes from prior crashed/closed sessions.
 */
export declare function preLaunch(cwd: string, sessionId: string, notifyTempContract?: NotifyTempContract, codexHomeOverride?: string, enableNotifyFallbackAuthority?: boolean, worktreeDirty?: boolean): Promise<void>;
/**
 * Decide whether an existing tmux window is too short to spend rows on a
 * launch-time HUD split. When the window height is unknown (null), we keep the
 * default behavior and create the HUD. (closes #2754)
 */
export declare function isExistingTmuxWindowTooCrampedForLaunchHud(windowHeight: number | null | undefined, minWindowHeight?: number): boolean;
export declare function buildTmuxShellCommand(command: string, args: string[]): string;
export declare function buildWindowsPromptCommand(command: string, args: string[]): string;
/**
 * Wrap a command for tmux pane execution while preserving the tmux pane cwd.
 * tmux already starts the pane at `-c <cwd>`; using a login shell here can
 * reset that cwd back to the shell's startup directory on some setups.
 *
 * Do not source user shell rc files by default. In issue #2282 the surviving
 * OOM signature was thousands of bash processes, not MCP node children;
 * non-interactive tmux panes sourcing ~/.bashrc can recursively trigger user
 * automation and fan out before Codex starts. Users who need legacy PATH setup
 * can opt in with OMX_TMUX_SOURCE_SHELL_RC=1.
 */
export declare function shouldSourceTmuxPaneShellRc(env?: NodeJS.ProcessEnv): boolean;
export declare function buildTmuxPaneCommand(command: string, args: string[], shellPath?: string | undefined, env?: NodeJS.ProcessEnv): string;
export declare function buildDetachedWindowsBootstrapScript(sessionName: string, commandText: string, delayMs?: number, tmuxCommand?: string): string;
/**
 * postLaunch: Clean up after Codex exits.
 * Each step is independently fault-tolerant (try/catch per step).
 */
export declare function postLaunch(cwd: string, sessionId: string, codexHomeOverride?: string, enableNotifyFallbackAuthority?: boolean, projectLocalCodexHomeForCleanup?: string): Promise<void>;
export declare function runDetachedSessionPostLaunch(cwd: string, sessionId: string, codexHomeOverride?: string, projectLocalCodexHomeForCleanup?: string, runtimeCodexHomeForCleanup?: string): Promise<void>;
export declare function shouldDetachBackgroundHelper(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
export type BackgroundHelperLaunchMode = "direct-detached" | "windows-msys-bootstrap";
export declare function resolveBackgroundHelperLaunchMode(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): BackgroundHelperLaunchMode;
export declare function buildWindowsMsysBackgroundHelperBootstrapScript(helperArgs: readonly string[], cwd: string): string;
export type NotifyFallbackReapResult = "missing" | "invalid" | "identity_mismatch" | "recent_active" | "reaped" | "failed";
export declare function reapStaleNotifyFallbackWatcher(pidPath: string, deps?: {
    exists?: (path: string) => boolean;
    readFile?: (path: string, encoding: BufferEncoding) => Promise<string>;
    tryKillPid?: (pid: number, signal?: NodeJS.Signals) => boolean;
    hasErrnoCode?: (error: unknown, code: string) => boolean;
    warn?: (message?: unknown, ...optionalParams: unknown[]) => void;
    isWatcherProcess?: (pid: number) => boolean;
    nowMs?: () => number;
    reapGraceMs?: number;
}): Promise<NotifyFallbackReapResult>;
//# sourceMappingURL=index.d.ts.map