@agimon-ai/po-runner 0.0.0-alpha.0

package/dist/bashRunService-CJ02XaAq.mjs

@@ -0,0 +1,440 @@
+import { t as RTK_FAILED_WARNING } from "./rtkProcessor-B4_urXQr.mjs";
+import { t as getBackgroundThresholdMs } from "./runnerConfig-BQBlVAXn.mjs";
+import { randomBytes } from "node:crypto";
+//#region src/constants/bashRunService.ts
+const COMPLETED = "completed";
+const FAILED = "failed";
+const LAUNCHER_ERROR = "launcher_error";
+//#endregion
+//#region src/services/bashRunService/resources.ts
+/** Split shell words without mistaking quoted examples for executed commands. */
+function commandInvocations(command) {
+	const invocations = [];
+	let words = [];
+	let word = "";
+	let quote = "";
+	let escaped = false;
+	const flushWord = () => {
+		if (word) words.push(word);
+		word = "";
+	};
+	for (const character of command) if (escaped) {
+		word += character;
+		escaped = false;
+	} else if (character === "\\" && quote !== "'") escaped = true;
+	else if (quote) {
+		if (character === quote) quote = "";
+		else word += character;
+	} else if (character === "\"" || character === "'") quote = character;
+	else if (";&|\n".includes(character)) {
+		flushWord();
+		if (words.length) invocations.push(words);
+		words = [];
+	} else if (/\s/.test(character)) flushWord();
+	else word += character;
+	flushWord();
+	if (words.length) invocations.push(words);
+	return invocations;
+}
+function executableName(word) {
+	return word.replace(/\\/g, "/").split("/").pop() ?? word;
+}
+/** Admission policy, not a shell security boundary. Opaque scripts still need explicit ownership. */
+function isHeavyCommand(command) {
+	const heavyTarget = /(?:^|[\s:,=])(?:build(?:-[\w-]+)?|test(?:-[\w-]+)?|lint|fixcode|typecheck|check|bundle)(?:[\s:,=]|$)/;
+	const expensiveBinary = /^(?:vitest|jest|tsc|tsgo|tsdown|webpack|rollup|esbuild|oxlint|oxfmt|pytest|maestro|xcodebuild|gradle|gradlew)$/;
+	return commandInvocations(command).some((words) => {
+		while (words.length) {
+			const first = words[0];
+			if (/^[A-Za-z_][A-Za-z_0-9]*=/.test(first) || /^(?:env|command|exec|time)$/.test(executableName(first))) words.shift();
+			else break;
+		}
+		let executable = executableName(words.shift() ?? "");
+		if (words.includes("--help") || words.includes("--version")) return false;
+		if (/^(?:pnpm|npm|npx|yarn|bun)$/.test(executable)) {
+			while (words[0]?.startsWith("-")) {
+				const option = words.shift();
+				if (/^(?:--filter|--dir|-C|--cwd|--prefix)$/.test(option)) words.shift();
+			}
+			if (words[0] === "exec" || words[0] === "run") words.shift();
+			const invocation = words.shift() ?? "";
+			if (/^(?:build|test|lint|fixcode|typecheck|check)(?::[\w-]+)?$/.test(invocation)) return true;
+			executable = executableName(invocation);
+		}
+		if (expensiveBinary.test(executable)) return true;
+		if (executable === "nx") {
+			if (/^(?:show|graph|daemon|reset|report|list)$/.test(words[0] ?? "")) return false;
+			return heavyTarget.test(words.join(" "));
+		}
+		if (/^(?:playwright|vite|cargo|go)$/.test(executable)) return heavyTarget.test(words.join(" "));
+		if (/^(?:python|python3)$/.test(executable)) return words[0] === "-m" && words[1] === "pytest";
+		if (/^(?:node|bun|tsx)$/.test(executable)) executable = executableName(words.find((word) => !word.startsWith("-")) ?? "");
+		const script = executable.replace(/\.(?:[cm]?[jt]s)$/, "");
+		return script !== executable && (expensiveBinary.test(script) || /^(?:build|test|lint|fixcode|typecheck|dev)(?:[-:]|$)/.test(script));
+	});
+}
+//#endregion
+//#region src/services/bashRunService/index.ts
+/** The command outlived the background threshold and should be promoted. */
+const TIMED_OUT = Symbol("threshold-reached");
+/** The command outlived the caller's explicit timeout and should be stopped. */
+const DEADLINE = Symbol("deadline-reached");
+/** The caller cancelled the command and its owned runner should be stopped. */
+const ABORTED = Symbol("aborted");
+function runnerId() {
+	return `${Date.now().toString(36)}-${randomBytes(3).toString("base64url")}`;
+}
+var BashRunService = class {
+	launcher;
+	rmuxBackend;
+	namer;
+	registry;
+	clock;
+	rtkProcessor;
+	cwd;
+	env;
+	executionBudget;
+	constructor(launcher, rmuxBackend, namer, registry, clock, rtkProcessor, cwd = process.cwd(), env = process.env, executionBudget) {
+		this.launcher = launcher;
+		this.rmuxBackend = rmuxBackend;
+		this.namer = namer;
+		this.registry = registry;
+		this.clock = clock;
+		this.rtkProcessor = rtkProcessor;
+		this.cwd = cwd;
+		this.env = env;
+		this.executionBudget = executionBudget;
+	}
+	async run(request) {
+		const id = runnerId();
+		const name = await this.namer.allocate(request.command, request.sessionId, request.name);
+		const cwd = request.cwd ?? this.cwd;
+		const interactive = request.interactive === true;
+		if (request.signal?.aborted) return {
+			kind: FAILED,
+			id,
+			name,
+			error: "Operation aborted"
+		};
+		let handle;
+		let releaseSlot;
+		try {
+			if (this.executionBudget && isHeavyCommand(request.command)) releaseSlot = await this.executionBudget.acquire(request.signal);
+			request.signal?.throwIfAborted();
+			const rmuxHandle = await this.rmuxBackend.launch({
+				id,
+				name,
+				command: request.command,
+				cwd,
+				sessionId: request.sessionId,
+				interactive
+			});
+			if (interactive && !rmuxHandle) {
+				releaseSlot?.();
+				return {
+					kind: FAILED,
+					id,
+					name,
+					error: "RMUX is required for interactive commands but is unavailable"
+				};
+			}
+			handle = rmuxHandle ?? this.launcher.launch({
+				id,
+				name,
+				command: request.command,
+				cwd,
+				sessionId: request.sessionId
+			});
+		} catch (error) {
+			releaseSlot?.();
+			return {
+				kind: FAILED,
+				id,
+				name,
+				error: error instanceof Error ? error.message : String(error)
+			};
+		}
+		if (handle.pid === void 0) {
+			releaseSlot?.();
+			return {
+				kind: FAILED,
+				id,
+				name,
+				error: "The command did not start, so it cannot be supervised"
+			};
+		}
+		if (releaseSlot) handle.completion().then(releaseSlot, releaseSlot);
+		try {
+			await this.registry.register({
+				id,
+				name,
+				pid: handle.pid,
+				command: request.command,
+				cwd,
+				logPath: handle.logPath,
+				interactive,
+				sessionId: request.sessionId,
+				backend: handle.backend,
+				...handle.backendTarget ? { backendTarget: handle.backendTarget } : {}
+			});
+		} catch (error) {
+			await handle.stop();
+			return {
+				kind: FAILED,
+				id,
+				name,
+				error: error instanceof Error ? error.message : String(error)
+			};
+		}
+		if (releaseSlot) try {
+			await releaseSlot.attachProcess?.(handle.pid);
+		} catch (error) {
+			if (!await handle.stop()) return this.promote(handle, "requested", void 0);
+			await this.registry.complete(id, {
+				reason: "stopped",
+				code: null,
+				signal: "SIGTERM"
+			});
+			return {
+				kind: FAILED,
+				id,
+				name,
+				error: error instanceof Error ? error.message : String(error)
+			};
+		}
+		if (request.signal?.aborted) {
+			if (!await handle.stop()) return this.promote(handle, "requested", void 0);
+			await this.registry.complete(id, {
+				reason: "stopped",
+				code: null,
+				signal: "SIGTERM"
+			});
+			return {
+				kind: FAILED,
+				id,
+				name,
+				error: "Operation aborted"
+			};
+		}
+		if (request.background === true || interactive) return this.promote(handle, request.background === true ? "requested" : "interactive", request.signal);
+		const outputUpdates = request.onOutput ? this.followOutput(handle, request.onOutput) : void 0;
+		try {
+			const outcome = await this.race(handle, request.timeoutMs, request.signal);
+			outputUpdates?.flush();
+			if (outcome === TIMED_OUT) return this.promote(handle, "threshold", request.signal);
+			if (outcome === ABORTED) {
+				await this.registry.requestTermination(id, {
+					reason: "stopped",
+					terminationReason: "request_cancelled"
+				});
+				await handle.stop();
+				outputUpdates?.flush();
+				await this.registry.complete(id, {
+					reason: "stopped",
+					code: null,
+					signal: "SIGTERM"
+				});
+				return {
+					kind: COMPLETED,
+					id,
+					name,
+					output: handle.output(),
+					exitCode: null,
+					signal: "SIGTERM",
+					logPath: handle.logPath,
+					backend: handle.backend,
+					aborted: true
+				};
+			}
+			if (outcome === DEADLINE) {
+				await this.registry.requestTermination(id, {
+					reason: "timed_out",
+					terminationReason: "timeout"
+				});
+				await handle.stop();
+				outputUpdates?.flush();
+				await this.registry.complete(id, {
+					reason: "timed_out",
+					code: null,
+					signal: "SIGTERM"
+				});
+				return {
+					kind: COMPLETED,
+					id,
+					name,
+					output: handle.output(),
+					exitCode: null,
+					signal: "SIGTERM",
+					logPath: handle.logPath,
+					backend: handle.backend,
+					timedOut: true
+				};
+			}
+			if (outcome instanceof Error) {
+				await this.registry.complete(id, {
+					reason: LAUNCHER_ERROR,
+					code: null,
+					signal: null
+				});
+				return {
+					kind: FAILED,
+					id,
+					name,
+					error: outcome.message
+				};
+			}
+			await this.registry.complete(id, {
+				reason: outcome.reason ?? (outcome.signal ? "signaled" : outcome.code === 0 ? "completed" : "failed"),
+				code: outcome.code,
+				signal: outcome.signal,
+				...outcome.terminationReason ? { terminationReason: outcome.terminationReason } : {},
+				...outcome.stopReason ? { stopReason: outcome.stopReason } : {}
+			});
+			return {
+				kind: COMPLETED,
+				id,
+				name,
+				output: handle.output(),
+				exitCode: outcome.code,
+				signal: outcome.signal,
+				logPath: handle.logPath,
+				backend: handle.backend,
+				...await this.processLog(request.command, handle.logPath)
+			};
+		} finally {
+			outputUpdates?.dispose();
+		}
+	}
+	async processLog(command, logPath) {
+		try {
+			const result = await this.rtkProcessor.process({
+				command,
+				logPath
+			});
+			if (result.kind === "processed") return { rtkOutput: result.result };
+			if (result.kind === "fallback") return { rtkWarning: result.warning };
+			return {};
+		} catch {
+			return { rtkWarning: RTK_FAILED_WARNING };
+		}
+	}
+	followOutput(handle, onOutput) {
+		let active = true;
+		let previous = "";
+		let cancelPoll;
+		const flush = () => {
+			if (!active) return;
+			const output = handle.output();
+			if (output === previous) return;
+			previous = output;
+			onOutput(output);
+		};
+		const poll = () => {
+			if (!active) return;
+			flush();
+			if (active) cancelPoll = this.clock.after(100, poll);
+		};
+		cancelPoll = this.clock.after(100, poll);
+		return {
+			flush,
+			dispose: () => {
+				active = false;
+				cancelPoll?.();
+				cancelPoll = void 0;
+			}
+		};
+	}
+	/**
+	* Waits for the command, giving up at the background threshold or at the
+	* caller's timeout, whichever comes first.
+	*
+	* A rejected completion is returned rather than thrown so the caller can
+	* report a start failure as a tool result instead of an exception.
+	*/
+	async race(handle, timeoutMs, signal) {
+		const cancels = [];
+		const racers = [handle.completion().catch((error) => error)];
+		racers.push(new Promise((resolve) => {
+			cancels.push(this.clock.after(getBackgroundThresholdMs(this.env), () => resolve(TIMED_OUT)));
+		}));
+		if (timeoutMs !== void 0 && timeoutMs > 0) racers.push(new Promise((resolve) => {
+			cancels.push(this.clock.after(timeoutMs, () => resolve(DEADLINE)));
+		}));
+		if (signal) racers.push(new Promise((resolve) => {
+			if (signal.aborted) {
+				resolve(ABORTED);
+				return;
+			}
+			const abort = () => resolve(ABORTED);
+			signal.addEventListener("abort", abort, { once: true });
+			cancels.push(() => signal.removeEventListener("abort", abort));
+		}));
+		try {
+			return await Promise.race(racers);
+		} finally {
+			for (const cancel of cancels) cancel();
+		}
+	}
+	async promote(handle, reason, signal) {
+		if (handle.pid === void 0) return {
+			kind: FAILED,
+			id: handle.id,
+			name: handle.name,
+			error: "The command did not start"
+		};
+		await this.registry.markPromoted(handle.id);
+		handle.detach();
+		let abortStop;
+		const abort = () => {
+			abortStop = this.registry.requestTermination(handle.id, {
+				reason: "stopped",
+				terminationReason: "request_cancelled"
+			}).then(() => handle.stop()).then(async () => {
+				await this.registry.complete(handle.id, {
+					reason: "stopped",
+					code: null,
+					signal: "SIGTERM"
+				});
+				return true;
+			}).catch((error) => {
+				const message = error instanceof Error ? error.message : String(error);
+				process.emitWarning(`Failed to stop aborted runner ${handle.id}: ${message}`);
+				return false;
+			});
+		};
+		if (signal?.aborted) abort();
+		handle.completion().then(async (outcome) => {
+			if (await abortStop) return;
+			await this.registry.complete(handle.id, {
+				reason: outcome.reason ?? (outcome.signal ? "signaled" : outcome.code === 0 ? "completed" : "failed"),
+				code: outcome.code,
+				signal: outcome.signal,
+				...outcome.terminationReason ? { terminationReason: outcome.terminationReason } : {},
+				...outcome.stopReason ? { stopReason: outcome.stopReason } : {}
+			});
+		}, async () => {
+			if (await abortStop) return;
+			await this.registry.complete(handle.id, {
+				reason: LAUNCHER_ERROR,
+				code: null,
+				signal: null
+			});
+		}).catch((error) => {
+			const message = error instanceof Error ? error.message : String(error);
+			process.emitWarning(`Failed to complete runner ${handle.id}: ${message}`);
+		});
+		return {
+			kind: "promoted",
+			id: handle.id,
+			name: handle.name,
+			pid: handle.pid,
+			logPath: handle.logPath,
+			backend: handle.backend,
+			reason
+		};
+	}
+};
+//#endregion
+export { BashRunService as t };
+
+//# sourceMappingURL=bashRunService-CJ02XaAq.mjs.map

package/dist/bashRunService-CJ02XaAq.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashRunService-CJ02XaAq.mjs","names":[],"sources":["../src/constants/bashRunService.ts","../src/services/bashRunService/resources.ts","../src/services/bashRunService/index.ts"],"sourcesContent":["export const RUNNER_ID_RANDOM_BYTES = 3;\nexport const OUTPUT_UPDATE_POLL_MS = 100;\nexport const COMPLETED = 'completed';\nexport const FAILED = 'failed';\nexport const LAUNCHER_ERROR = 'launcher_error';\nexport const SIGNALED = 'signaled';\n","/** Split shell words without mistaking quoted examples for executed commands. */\nfunction commandInvocations(command: string): string[][] {\n  const invocations: string[][] = [];\n  let words: string[] = [];\n  let word = '';\n  let quote = '';\n  let escaped = false;\n  const flushWord = (): void => {\n    if (word) words.push(word);\n    word = '';\n  };\n  for (const character of command) {\n    if (escaped) {\n      word += character;\n      escaped = false;\n    } else if (character === '\\\\' && quote !== \"'\") {\n      escaped = true;\n    } else if (quote) {\n      if (character === quote) quote = '';\n      else word += character;\n    } else if (character === '\"' || character === \"'\") {\n      quote = character;\n    } else if (';&|\\n'.includes(character)) {\n      flushWord();\n      if (words.length) invocations.push(words);\n      words = [];\n    } else if (/\\s/.test(character)) {\n      flushWord();\n    } else {\n      word += character;\n    }\n  }\n  flushWord();\n  if (words.length) invocations.push(words);\n  return invocations;\n}\n\nfunction executableName(word: string): string {\n  return word.replace(/\\\\/g, '/').split('/').pop() ?? word;\n}\n\n/** Admission policy, not a shell security boundary. Opaque scripts still need explicit ownership. */\nexport function isHeavyCommand(command: string): boolean {\n  const heavyTarget =\n    /(?:^|[\\s:,=])(?:build(?:-[\\w-]+)?|test(?:-[\\w-]+)?|lint|fixcode|typecheck|check|bundle)(?:[\\s:,=]|$)/;\n  const expensiveBinary =\n    /^(?:vitest|jest|tsc|tsgo|tsdown|webpack|rollup|esbuild|oxlint|oxfmt|pytest|maestro|xcodebuild|gradle|gradlew)$/;\n  return commandInvocations(command).some((words) => {\n    while (words.length) {\n      const first = words[0]!;\n      if (/^[A-Za-z_][A-Za-z_0-9]*=/.test(first) || /^(?:env|command|exec|time)$/.test(executableName(first))) {\n        words.shift();\n      } else break;\n    }\n    let executable = executableName(words.shift() ?? '');\n    if (words.includes('--help') || words.includes('--version')) return false;\n    if (/^(?:pnpm|npm|npx|yarn|bun)$/.test(executable)) {\n      while (words[0]?.startsWith('-')) {\n        const option = words.shift()!;\n        if (/^(?:--filter|--dir|-C|--cwd|--prefix)$/.test(option)) words.shift();\n      }\n      if (words[0] === 'exec' || words[0] === 'run') words.shift();\n      const invocation = words.shift() ?? '';\n      if (/^(?:build|test|lint|fixcode|typecheck|check)(?::[\\w-]+)?$/.test(invocation)) return true;\n      executable = executableName(invocation);\n    }\n    if (expensiveBinary.test(executable)) return true;\n    if (executable === 'nx') {\n      if (/^(?:show|graph|daemon|reset|report|list)$/.test(words[0] ?? '')) return false;\n      return heavyTarget.test(words.join(' '));\n    }\n    if (/^(?:playwright|vite|cargo|go)$/.test(executable)) return heavyTarget.test(words.join(' '));\n    if (/^(?:python|python3)$/.test(executable)) return words[0] === '-m' && words[1] === 'pytest';\n    if (/^(?:node|bun|tsx)$/.test(executable)) {\n      executable = executableName(words.find((word) => !word.startsWith('-')) ?? '');\n    }\n    const script = executable.replace(/\\.(?:[cm]?[jt]s)$/, '');\n    return (\n      script !== executable &&\n      (expensiveBinary.test(script) || /^(?:build|test|lint|fixcode|typecheck|dev)(?:[-:]|$)/.test(script))\n    );\n  });\n}\n","import { randomBytes } from 'node:crypto';\n\nimport type { DoomHostExecutionBudget, DoomHostExecutionPermit } from '@agimon-ai/po-core/packageApi';\n\nimport {\n  COMPLETED,\n  FAILED,\n  LAUNCHER_ERROR,\n  OUTPUT_UPDATE_POLL_MS,\n  RUNNER_ID_RANDOM_BYTES,\n  SIGNALED,\n} from '../../constants/bashRunService';\nimport type {\n  BashRunRequest,\n  BashRunResult,\n  CompletedRun,\n  IBashRunService,\n  PromotedRun,\n} from '../../types/bashRunService';\nimport type { IClock } from '../../types/clock';\nimport type { ILauncher, RunHandle } from '../../types/launcher';\nimport type { IRmuxBackend } from '../../types/rmuxBackend';\nimport { type IRtkProcessor, RTK_FAILED_WARNING } from '../../types/rtkProcessor';\nimport type { IRunnerRegistry } from '../../types/runnerRegistry';\nimport { getBackgroundThresholdMs } from '../runnerConfig';\nimport type { IRunnerNamer } from '../runnerNamer/type';\nimport { isHeavyCommand } from './resources';\n\n/** The command outlived the background threshold and should be promoted. */\nconst TIMED_OUT = Symbol('threshold-reached');\n/** The command outlived the caller's explicit timeout and should be stopped. */\nconst DEADLINE = Symbol('deadline-reached');\n/** The caller cancelled the command and its owned runner should be stopped. */\nconst ABORTED = Symbol('aborted');\n\nfunction runnerId(): string {\n  const timestamp = Date.now().toString(36);\n  const random = randomBytes(RUNNER_ID_RANDOM_BYTES).toString('base64url');\n  return `${timestamp}-${random}`;\n}\n\nexport class BashRunService implements IBashRunService {\n  constructor(\n    private readonly launcher: ILauncher,\n    private readonly rmuxBackend: IRmuxBackend,\n    private readonly namer: IRunnerNamer,\n    private readonly registry: IRunnerRegistry,\n    private readonly clock: IClock,\n    private readonly rtkProcessor: IRtkProcessor,\n    private readonly cwd: string = process.cwd(),\n    private readonly env: Readonly<Record<string, string | undefined>> = process.env,\n    private readonly executionBudget?: DoomHostExecutionBudget,\n  ) {}\n\n  async run(request: BashRunRequest): Promise<BashRunResult> {\n    const id = runnerId();\n    const name = await this.namer.allocate(request.command, request.sessionId, request.name);\n    const cwd = request.cwd ?? this.cwd;\n    const interactive = request.interactive === true;\n    if (request.signal?.aborted) return { kind: FAILED, id, name, error: 'Operation aborted' };\n\n    let handle: RunHandle;\n    let releaseSlot: DoomHostExecutionPermit | undefined;\n    try {\n      if (this.executionBudget && isHeavyCommand(request.command)) {\n        releaseSlot = await this.executionBudget.acquire(request.signal);\n      }\n      request.signal?.throwIfAborted();\n      const rmuxHandle = await this.rmuxBackend.launch({\n        id,\n        name,\n        command: request.command,\n        cwd,\n        sessionId: request.sessionId,\n        interactive,\n      });\n      if (interactive && !rmuxHandle) {\n        releaseSlot?.();\n        return { kind: FAILED, id, name, error: 'RMUX is required for interactive commands but is unavailable' };\n      }\n      handle =\n        rmuxHandle ?? this.launcher.launch({ id, name, command: request.command, cwd, sessionId: request.sessionId });\n    } catch (error) {\n      releaseSlot?.();\n      return { kind: FAILED, id, name, error: error instanceof Error ? error.message : String(error) };\n    }\n\n    if (handle.pid === undefined) {\n      releaseSlot?.();\n      return { kind: FAILED, id, name, error: 'The command did not start, so it cannot be supervised' };\n    }\n    // A background promotion is not process completion. Keep the slot until actual exit.\n    if (releaseSlot) void handle.completion().then(releaseSlot, releaseSlot);\n    // Register first so a process that survives PID attachment failure remains discoverable.\n    try {\n      await this.registry.register({\n        id,\n        name,\n        pid: handle.pid,\n        command: request.command,\n        cwd,\n        logPath: handle.logPath,\n        interactive,\n        sessionId: request.sessionId,\n        backend: handle.backend,\n        ...(handle.backendTarget ? { backendTarget: handle.backendTarget } : {}),\n      });\n    } catch (error) {\n      await handle.stop();\n      return { kind: FAILED, id, name, error: error instanceof Error ? error.message : String(error) };\n    }\n\n    if (releaseSlot) {\n      try {\n        await releaseSlot.attachProcess?.(handle.pid);\n      } catch (error) {\n        if (!(await handle.stop())) {\n          return this.promote(handle, 'requested', undefined);\n        }\n        await this.registry.complete(id, { reason: 'stopped', code: null, signal: 'SIGTERM' });\n        return { kind: FAILED, id, name, error: error instanceof Error ? error.message : String(error) };\n      }\n    }\n    if (request.signal?.aborted) {\n      if (!(await handle.stop())) return this.promote(handle, 'requested', undefined);\n      await this.registry.complete(id, { reason: 'stopped', code: null, signal: 'SIGTERM' });\n      return { kind: FAILED, id, name, error: 'Operation aborted' };\n    }\n\n    // An interactive run has nothing to wait for: it is going to prompt, so\n    // the model needs the runner name before it can answer.\n    if (request.background === true || interactive) {\n      return this.promote(handle, request.background === true ? 'requested' : 'interactive', request.signal);\n    }\n\n    const outputUpdates = request.onOutput ? this.followOutput(handle, request.onOutput) : undefined;\n    try {\n      const outcome = await this.race(handle, request.timeoutMs, request.signal);\n      outputUpdates?.flush();\n      if (outcome === TIMED_OUT) {\n        return this.promote(handle, 'threshold', request.signal);\n      }\n      if (outcome === ABORTED) {\n        await this.registry.requestTermination(id, { reason: 'stopped', terminationReason: 'request_cancelled' });\n        await handle.stop();\n        outputUpdates?.flush();\n        await this.registry.complete(id, { reason: 'stopped', code: null, signal: 'SIGTERM' });\n        return {\n          kind: COMPLETED,\n          id,\n          name,\n          output: handle.output(),\n          exitCode: null,\n          signal: 'SIGTERM',\n          logPath: handle.logPath,\n          backend: handle.backend,\n          aborted: true,\n        };\n      }\n      if (outcome === DEADLINE) {\n        // An explicit timeout means the caller wants the command dead, not\n        // supervised, so it is stopped rather than promoted.\n        await this.registry.requestTermination(id, { reason: 'timed_out', terminationReason: 'timeout' });\n        await handle.stop();\n        outputUpdates?.flush();\n        await this.registry.complete(id, { reason: 'timed_out', code: null, signal: 'SIGTERM' });\n        return {\n          kind: COMPLETED,\n          id,\n          name,\n          output: handle.output(),\n          exitCode: null,\n          signal: 'SIGTERM',\n          logPath: handle.logPath,\n          backend: handle.backend,\n          timedOut: true,\n        };\n      }\n      if (outcome instanceof Error) {\n        await this.registry.complete(id, { reason: LAUNCHER_ERROR, code: null, signal: null });\n        return { kind: FAILED, id, name, error: outcome.message };\n      }\n\n      await this.registry.complete(id, {\n        reason: outcome.reason ?? (outcome.signal ? SIGNALED : outcome.code === 0 ? COMPLETED : FAILED),\n        code: outcome.code,\n        signal: outcome.signal,\n        ...(outcome.terminationReason ? { terminationReason: outcome.terminationReason } : {}),\n        ...(outcome.stopReason ? { stopReason: outcome.stopReason } : {}),\n      });\n\n      return {\n        kind: COMPLETED,\n        id,\n        name,\n        output: handle.output(),\n        exitCode: outcome.code,\n        signal: outcome.signal,\n        logPath: handle.logPath,\n        backend: handle.backend,\n        ...(await this.processLog(request.command, handle.logPath)),\n      };\n    } finally {\n      outputUpdates?.dispose();\n    }\n  }\n\n  private async processLog(command: string, logPath: string): Promise<Pick<CompletedRun, 'rtkOutput' | 'rtkWarning'>> {\n    try {\n      const result = await this.rtkProcessor.process({ command, logPath });\n      if (result.kind === 'processed') return { rtkOutput: result.result };\n      if (result.kind === 'fallback') return { rtkWarning: result.warning };\n      return {};\n    } catch {\n      return { rtkWarning: RTK_FAILED_WARNING };\n    }\n  }\n\n  private followOutput(\n    handle: RunHandle,\n    onOutput: NonNullable<BashRunRequest['onOutput']>,\n  ): { flush(): void; dispose(): void } {\n    let active = true;\n    let previous = '';\n    let cancelPoll: (() => void) | undefined;\n    const flush = (): void => {\n      if (!active) return;\n      const output = handle.output();\n      if (output === previous) return;\n      previous = output;\n      onOutput(output);\n    };\n    const poll = (): void => {\n      if (!active) return;\n      flush();\n      if (active) cancelPoll = this.clock.after(OUTPUT_UPDATE_POLL_MS, poll);\n    };\n    cancelPoll = this.clock.after(OUTPUT_UPDATE_POLL_MS, poll);\n    return {\n      flush,\n      dispose: () => {\n        active = false;\n        cancelPoll?.();\n        cancelPoll = undefined;\n      },\n    };\n  }\n\n  /**\n   * Waits for the command, giving up at the background threshold or at the\n   * caller's timeout, whichever comes first.\n   *\n   * A rejected completion is returned rather than thrown so the caller can\n   * report a start failure as a tool result instead of an exception.\n   */\n  private async race(\n    handle: RunHandle,\n    timeoutMs: number | undefined,\n    signal: AbortSignal | undefined,\n  ): Promise<\n    Awaited<ReturnType<RunHandle['completion']>> | Error | typeof TIMED_OUT | typeof DEADLINE | typeof ABORTED\n  > {\n    const cancels: Array<() => void> = [];\n    const racers: Array<Promise<unknown>> = [handle.completion().catch((error: Error) => error)];\n\n    racers.push(\n      new Promise((resolve) => {\n        cancels.push(this.clock.after(getBackgroundThresholdMs(this.env), () => resolve(TIMED_OUT)));\n      }),\n    );\n    if (timeoutMs !== undefined && timeoutMs > 0) {\n      racers.push(\n        new Promise((resolve) => {\n          cancels.push(this.clock.after(timeoutMs, () => resolve(DEADLINE)));\n        }),\n      );\n    }\n    if (signal) {\n      racers.push(\n        new Promise((resolve) => {\n          if (signal.aborted) {\n            resolve(ABORTED);\n            return;\n          }\n          const abort = (): void => resolve(ABORTED);\n          signal.addEventListener('abort', abort, { once: true });\n          cancels.push(() => signal.removeEventListener('abort', abort));\n        }),\n      );\n    }\n\n    try {\n      return (await Promise.race(racers)) as\n        | Awaited<ReturnType<RunHandle['completion']>>\n        | Error\n        | typeof TIMED_OUT\n        | typeof DEADLINE\n        | typeof ABORTED;\n    } finally {\n      for (const cancel of cancels) cancel();\n    }\n  }\n\n  private async promote(\n    handle: RunHandle,\n    reason: PromotedRun['reason'],\n    signal: AbortSignal | undefined,\n  ): Promise<BashRunResult> {\n    if (handle.pid === undefined)\n      return { kind: FAILED, id: handle.id, name: handle.name, error: 'The command did not start' };\n    await this.registry.markPromoted(handle.id);\n    // Registration first: an unregistered runner is invisible, and the handle\n    // stops buffering the moment it is detached.\n    handle.detach();\n    let abortStop: Promise<boolean> | undefined;\n    const abort = (): void => {\n      abortStop = this.registry\n        .requestTermination(handle.id, { reason: 'stopped', terminationReason: 'request_cancelled' })\n        .then(() => handle.stop())\n        .then(async () => {\n          await this.registry.complete(handle.id, { reason: 'stopped', code: null, signal: 'SIGTERM' });\n          return true;\n        })\n        .catch((error: unknown) => {\n          const message = error instanceof Error ? error.message : String(error);\n          process.emitWarning(`Failed to stop aborted runner ${handle.id}: ${message}`);\n          return false;\n        });\n    };\n    // The signal belongs to the tool call, which ends when this returns, and\n    // Pi aborts it at that point. A promoted runner outlives the call, so only\n    // an abort that landed before the handoff stops it.\n    if (signal?.aborted) abort();\n    void handle\n      .completion()\n      .then(\n        async (outcome) => {\n          if (await abortStop) return;\n          await this.registry.complete(handle.id, {\n            reason: outcome.reason ?? (outcome.signal ? SIGNALED : outcome.code === 0 ? COMPLETED : FAILED),\n            code: outcome.code,\n            signal: outcome.signal,\n            ...(outcome.terminationReason ? { terminationReason: outcome.terminationReason } : {}),\n            ...(outcome.stopReason ? { stopReason: outcome.stopReason } : {}),\n          });\n        },\n        async () => {\n          if (await abortStop) return;\n          await this.registry.complete(handle.id, { reason: LAUNCHER_ERROR, code: null, signal: null });\n        },\n      )\n      .catch((error: unknown) => {\n        const message = error instanceof Error ? error.message : String(error);\n        process.emitWarning(`Failed to complete runner ${handle.id}: ${message}`);\n      });\n\n    return {\n      kind: 'promoted',\n      id: handle.id,\n      name: handle.name,\n      pid: handle.pid,\n      logPath: handle.logPath,\n      backend: handle.backend,\n      reason,\n    };\n  }\n}\n"],"mappings":";;;;AAEA,MAAa,YAAY;AACzB,MAAa,SAAS;AACtB,MAAa,iBAAiB;;;;ACH9B,SAAS,mBAAmB,SAA6B;CACvD,MAAM,cAA0B,CAAC;CACjC,IAAI,QAAkB,CAAC;CACvB,IAAI,OAAO;CACX,IAAI,QAAQ;CACZ,IAAI,UAAU;CACd,MAAM,kBAAwB;EAC5B,IAAI,MAAM,MAAM,KAAK,IAAI;EACzB,OAAO;CACT;CACA,KAAK,MAAM,aAAa,SACtB,IAAI,SAAS;EACX,QAAQ;EACR,UAAU;CACZ,OAAO,IAAI,cAAc,QAAQ,UAAU,KACzC,UAAU;MACL,IAAI,OAAO;EAChB,IAAI,cAAc,OAAO,QAAQ;OAC5B,QAAQ;CACf,OAAO,IAAI,cAAc,QAAO,cAAc,KAC5C,QAAQ;MACH,IAAI,QAAQ,SAAS,SAAS,GAAG;EACtC,UAAU;EACV,IAAI,MAAM,QAAQ,YAAY,KAAK,KAAK;EACxC,QAAQ,CAAC;CACX,OAAO,IAAI,KAAK,KAAK,SAAS,GAC5B,UAAU;MAEV,QAAQ;CAGZ,UAAU;CACV,IAAI,MAAM,QAAQ,YAAY,KAAK,KAAK;CACxC,OAAO;AACT;AAEA,SAAS,eAAe,MAAsB;CAC5C,OAAO,KAAK,QAAQ,OAAO,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK;AACtD;;AAGA,SAAgB,eAAe,SAA0B;CACvD,MAAM,cACJ;CACF,MAAM,kBACJ;CACF,OAAO,mBAAmB,OAAO,CAAC,CAAC,MAAM,UAAU;EACjD,OAAO,MAAM,QAAQ;GACnB,MAAM,QAAQ,MAAM;GACpB,IAAI,2BAA2B,KAAK,KAAK,KAAK,8BAA8B,KAAK,eAAe,KAAK,CAAC,GACpG,MAAM,MAAM;QACP;EACT;EACA,IAAI,aAAa,eAAe,MAAM,MAAM,KAAK,EAAE;EACnD,IAAI,MAAM,SAAS,QAAQ,KAAK,MAAM,SAAS,WAAW,GAAG,OAAO;EACpE,IAAI,8BAA8B,KAAK,UAAU,GAAG;GAClD,OAAO,MAAM,EAAE,EAAE,WAAW,GAAG,GAAG;IAChC,MAAM,SAAS,MAAM,MAAM;IAC3B,IAAI,yCAAyC,KAAK,MAAM,GAAG,MAAM,MAAM;GACzE;GACA,IAAI,MAAM,OAAO,UAAU,MAAM,OAAO,OAAO,MAAM,MAAM;GAC3D,MAAM,aAAa,MAAM,MAAM,KAAK;GACpC,IAAI,4DAA4D,KAAK,UAAU,GAAG,OAAO;GACzF,aAAa,eAAe,UAAU;EACxC;EACA,IAAI,gBAAgB,KAAK,UAAU,GAAG,OAAO;EAC7C,IAAI,eAAe,MAAM;GACvB,IAAI,4CAA4C,KAAK,MAAM,MAAM,EAAE,GAAG,OAAO;GAC7E,OAAO,YAAY,KAAK,MAAM,KAAK,GAAG,CAAC;EACzC;EACA,IAAI,iCAAiC,KAAK,UAAU,GAAG,OAAO,YAAY,KAAK,MAAM,KAAK,GAAG,CAAC;EAC9F,IAAI,uBAAuB,KAAK,UAAU,GAAG,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO;EACtF,IAAI,qBAAqB,KAAK,UAAU,GACtC,aAAa,eAAe,MAAM,MAAM,SAAS,CAAC,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE;EAE/E,MAAM,SAAS,WAAW,QAAQ,qBAAqB,EAAE;EACzD,OACE,WAAW,eACV,gBAAgB,KAAK,MAAM,KAAK,uDAAuD,KAAK,MAAM;CAEvG,CAAC;AACH;;;;ACrDA,MAAM,YAAY,OAAO,mBAAmB;;AAE5C,MAAM,WAAW,OAAO,kBAAkB;;AAE1C,MAAM,UAAU,OAAO,SAAS;AAEhC,SAAS,WAAmB;CAG1B,OAAO,GAFW,KAAK,IAAI,CAAC,CAAC,SAAS,EAEpB,EAAE,GADL,YAAA,CAAkC,CAAC,CAAC,SAAS,WAChC;AAC9B;AAEA,IAAa,iBAAb,MAAuD;CAElC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CATnB,YACE,UACA,aACA,OACA,UACA,OACA,cACA,MAA+B,QAAQ,IAAI,GAC3C,MAAqE,QAAQ,KAC7E,iBACA;EATiB,KAAA,WAAA;EACA,KAAA,cAAA;EACA,KAAA,QAAA;EACA,KAAA,WAAA;EACA,KAAA,QAAA;EACA,KAAA,eAAA;EACA,KAAA,MAAA;EACA,KAAA,MAAA;EACA,KAAA,kBAAA;CAChB;CAEH,MAAM,IAAI,SAAiD;EACzD,MAAM,KAAK,SAAS;EACpB,MAAM,OAAO,MAAM,KAAK,MAAM,SAAS,QAAQ,SAAS,QAAQ,WAAW,QAAQ,IAAI;EACvF,MAAM,MAAM,QAAQ,OAAO,KAAK;EAChC,MAAM,cAAc,QAAQ,gBAAgB;EAC5C,IAAI,QAAQ,QAAQ,SAAS,OAAO;GAAE,MAAM;GAAQ;GAAI;GAAM,OAAO;EAAoB;EAEzF,IAAI;EACJ,IAAI;EACJ,IAAI;GACF,IAAI,KAAK,mBAAmB,eAAe,QAAQ,OAAO,GACxD,cAAc,MAAM,KAAK,gBAAgB,QAAQ,QAAQ,MAAM;GAEjE,QAAQ,QAAQ,eAAe;GAC/B,MAAM,aAAa,MAAM,KAAK,YAAY,OAAO;IAC/C;IACA;IACA,SAAS,QAAQ;IACjB;IACA,WAAW,QAAQ;IACnB;GACF,CAAC;GACD,IAAI,eAAe,CAAC,YAAY;IAC9B,cAAc;IACd,OAAO;KAAE,MAAM;KAAQ;KAAI;KAAM,OAAO;IAA+D;GACzG;GACA,SACE,cAAc,KAAK,SAAS,OAAO;IAAE;IAAI;IAAM,SAAS,QAAQ;IAAS;IAAK,WAAW,QAAQ;GAAU,CAAC;EAChH,SAAS,OAAO;GACd,cAAc;GACd,OAAO;IAAE,MAAM;IAAQ;IAAI;IAAM,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAAE;EACjG;EAEA,IAAI,OAAO,QAAQ,KAAA,GAAW;GAC5B,cAAc;GACd,OAAO;IAAE,MAAM;IAAQ;IAAI;IAAM,OAAO;GAAwD;EAClG;EAEA,IAAI,aAAa,OAAY,WAAW,CAAC,CAAC,KAAK,aAAa,WAAW;EAEvE,IAAI;GACF,MAAM,KAAK,SAAS,SAAS;IAC3B;IACA;IACA,KAAK,OAAO;IACZ,SAAS,QAAQ;IACjB;IACA,SAAS,OAAO;IAChB;IACA,WAAW,QAAQ;IACnB,SAAS,OAAO;IAChB,GAAI,OAAO,gBAAgB,EAAE,eAAe,OAAO,cAAc,IAAI,CAAC;GACxE,CAAC;EACH,SAAS,OAAO;GACd,MAAM,OAAO,KAAK;GAClB,OAAO;IAAE,MAAM;IAAQ;IAAI;IAAM,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAAE;EACjG;EAEA,IAAI,aACF,IAAI;GACF,MAAM,YAAY,gBAAgB,OAAO,GAAG;EAC9C,SAAS,OAAO;GACd,IAAI,CAAE,MAAM,OAAO,KAAK,GACtB,OAAO,KAAK,QAAQ,QAAQ,aAAa,KAAA,CAAS;GAEpD,MAAM,KAAK,SAAS,SAAS,IAAI;IAAE,QAAQ;IAAW,MAAM;IAAM,QAAQ;GAAU,CAAC;GACrF,OAAO;IAAE,MAAM;IAAQ;IAAI;IAAM,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAAE;EACjG;EAEF,IAAI,QAAQ,QAAQ,SAAS;GAC3B,IAAI,CAAE,MAAM,OAAO,KAAK,GAAI,OAAO,KAAK,QAAQ,QAAQ,aAAa,KAAA,CAAS;GAC9E,MAAM,KAAK,SAAS,SAAS,IAAI;IAAE,QAAQ;IAAW,MAAM;IAAM,QAAQ;GAAU,CAAC;GACrF,OAAO;IAAE,MAAM;IAAQ;IAAI;IAAM,OAAO;GAAoB;EAC9D;EAIA,IAAI,QAAQ,eAAe,QAAQ,aACjC,OAAO,KAAK,QAAQ,QAAQ,QAAQ,eAAe,OAAO,cAAc,eAAe,QAAQ,MAAM;EAGvG,MAAM,gBAAgB,QAAQ,WAAW,KAAK,aAAa,QAAQ,QAAQ,QAAQ,IAAI,KAAA;EACvF,IAAI;GACF,MAAM,UAAU,MAAM,KAAK,KAAK,QAAQ,QAAQ,WAAW,QAAQ,MAAM;GACzE,eAAe,MAAM;GACrB,IAAI,YAAY,WACd,OAAO,KAAK,QAAQ,QAAQ,aAAa,QAAQ,MAAM;GAEzD,IAAI,YAAY,SAAS;IACvB,MAAM,KAAK,SAAS,mBAAmB,IAAI;KAAE,QAAQ;KAAW,mBAAmB;IAAoB,CAAC;IACxG,MAAM,OAAO,KAAK;IAClB,eAAe,MAAM;IACrB,MAAM,KAAK,SAAS,SAAS,IAAI;KAAE,QAAQ;KAAW,MAAM;KAAM,QAAQ;IAAU,CAAC;IACrF,OAAO;KACL,MAAM;KACN;KACA;KACA,QAAQ,OAAO,OAAO;KACtB,UAAU;KACV,QAAQ;KACR,SAAS,OAAO;KAChB,SAAS,OAAO;KAChB,SAAS;IACX;GACF;GACA,IAAI,YAAY,UAAU;IAGxB,MAAM,KAAK,SAAS,mBAAmB,IAAI;KAAE,QAAQ;KAAa,mBAAmB;IAAU,CAAC;IAChG,MAAM,OAAO,KAAK;IAClB,eAAe,MAAM;IACrB,MAAM,KAAK,SAAS,SAAS,IAAI;KAAE,QAAQ;KAAa,MAAM;KAAM,QAAQ;IAAU,CAAC;IACvF,OAAO;KACL,MAAM;KACN;KACA;KACA,QAAQ,OAAO,OAAO;KACtB,UAAU;KACV,QAAQ;KACR,SAAS,OAAO;KAChB,SAAS,OAAO;KAChB,UAAU;IACZ;GACF;GACA,IAAI,mBAAmB,OAAO;IAC5B,MAAM,KAAK,SAAS,SAAS,IAAI;KAAE,QAAQ;KAAgB,MAAM;KAAM,QAAQ;IAAK,CAAC;IACrF,OAAO;KAAE,MAAM;KAAQ;KAAI;KAAM,OAAO,QAAQ;IAAQ;GAC1D;GAEA,MAAM,KAAK,SAAS,SAAS,IAAI;IAC/B,QAAQ,QAAQ,WAAW,QAAQ,SAAA,aAAoB,QAAQ,SAAS,IAAA,cAAA;IACxE,MAAM,QAAQ;IACd,QAAQ,QAAQ;IAChB,GAAI,QAAQ,oBAAoB,EAAE,mBAAmB,QAAQ,kBAAkB,IAAI,CAAC;IACpF,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;GACjE,CAAC;GAED,OAAO;IACL,MAAM;IACN;IACA;IACA,QAAQ,OAAO,OAAO;IACtB,UAAU,QAAQ;IAClB,QAAQ,QAAQ;IAChB,SAAS,OAAO;IAChB,SAAS,OAAO;IAChB,GAAI,MAAM,KAAK,WAAW,QAAQ,SAAS,OAAO,OAAO;GAC3D;EACF,UAAU;GACR,eAAe,QAAQ;EACzB;CACF;CAEA,MAAc,WAAW,SAAiB,SAA0E;EAClH,IAAI;GACF,MAAM,SAAS,MAAM,KAAK,aAAa,QAAQ;IAAE;IAAS;GAAQ,CAAC;GACnE,IAAI,OAAO,SAAS,aAAa,OAAO,EAAE,WAAW,OAAO,OAAO;GACnE,IAAI,OAAO,SAAS,YAAY,OAAO,EAAE,YAAY,OAAO,QAAQ;GACpE,OAAO,CAAC;EACV,QAAQ;GACN,OAAO,EAAE,YAAY,mBAAmB;EAC1C;CACF;CAEA,aACE,QACA,UACoC;EACpC,IAAI,SAAS;EACb,IAAI,WAAW;EACf,IAAI;EACJ,MAAM,cAAoB;GACxB,IAAI,CAAC,QAAQ;GACb,MAAM,SAAS,OAAO,OAAO;GAC7B,IAAI,WAAW,UAAU;GACzB,WAAW;GACX,SAAS,MAAM;EACjB;EACA,MAAM,aAAmB;GACvB,IAAI,CAAC,QAAQ;GACb,MAAM;GACN,IAAI,QAAQ,aAAa,KAAK,MAAM,MAAA,KAA6B,IAAI;EACvE;EACA,aAAa,KAAK,MAAM,MAAA,KAA6B,IAAI;EACzD,OAAO;GACL;GACA,eAAe;IACb,SAAS;IACT,aAAa;IACb,aAAa,KAAA;GACf;EACF;CACF;;;;;;;;CASA,MAAc,KACZ,QACA,WACA,QAGA;EACA,MAAM,UAA6B,CAAC;EACpC,MAAM,SAAkC,CAAC,OAAO,WAAW,CAAC,CAAC,OAAO,UAAiB,KAAK,CAAC;EAE3F,OAAO,KACL,IAAI,SAAS,YAAY;GACvB,QAAQ,KAAK,KAAK,MAAM,MAAM,yBAAyB,KAAK,GAAG,SAAS,QAAQ,SAAS,CAAC,CAAC;EAC7F,CAAC,CACH;EACA,IAAI,cAAc,KAAA,KAAa,YAAY,GACzC,OAAO,KACL,IAAI,SAAS,YAAY;GACvB,QAAQ,KAAK,KAAK,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,CAAC,CAAC;EACnE,CAAC,CACH;EAEF,IAAI,QACF,OAAO,KACL,IAAI,SAAS,YAAY;GACvB,IAAI,OAAO,SAAS;IAClB,QAAQ,OAAO;IACf;GACF;GACA,MAAM,cAAoB,QAAQ,OAAO;GACzC,OAAO,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;GACtD,QAAQ,WAAW,OAAO,oBAAoB,SAAS,KAAK,CAAC;EAC/D,CAAC,CACH;EAGF,IAAI;GACF,OAAQ,MAAM,QAAQ,KAAK,MAAM;EAMnC,UAAU;GACR,KAAK,MAAM,UAAU,SAAS,OAAO;EACvC;CACF;CAEA,MAAc,QACZ,QACA,QACA,QACwB;EACxB,IAAI,OAAO,QAAQ,KAAA,GACjB,OAAO;GAAE,MAAM;GAAQ,IAAI,OAAO;GAAI,MAAM,OAAO;GAAM,OAAO;EAA4B;EAC9F,MAAM,KAAK,SAAS,aAAa,OAAO,EAAE;EAG1C,OAAO,OAAO;EACd,IAAI;EACJ,MAAM,cAAoB;GACxB,YAAY,KAAK,SACd,mBAAmB,OAAO,IAAI;IAAE,QAAQ;IAAW,mBAAmB;GAAoB,CAAC,CAAC,CAC5F,WAAW,OAAO,KAAK,CAAC,CAAC,CACzB,KAAK,YAAY;IAChB,MAAM,KAAK,SAAS,SAAS,OAAO,IAAI;KAAE,QAAQ;KAAW,MAAM;KAAM,QAAQ;IAAU,CAAC;IAC5F,OAAO;GACT,CAAC,CAAC,CACD,OAAO,UAAmB;IACzB,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;IACrE,QAAQ,YAAY,iCAAiC,OAAO,GAAG,IAAI,SAAS;IAC5E,OAAO;GACT,CAAC;EACL;EAIA,IAAI,QAAQ,SAAS,MAAM;EAC3B,OACG,WAAW,CAAC,CACZ,KACC,OAAO,YAAY;GACjB,IAAI,MAAM,WAAW;GACrB,MAAM,KAAK,SAAS,SAAS,OAAO,IAAI;IACtC,QAAQ,QAAQ,WAAW,QAAQ,SAAA,aAAoB,QAAQ,SAAS,IAAA,cAAA;IACxE,MAAM,QAAQ;IACd,QAAQ,QAAQ;IAChB,GAAI,QAAQ,oBAAoB,EAAE,mBAAmB,QAAQ,kBAAkB,IAAI,CAAC;IACpF,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;GACjE,CAAC;EACH,GACA,YAAY;GACV,IAAI,MAAM,WAAW;GACrB,MAAM,KAAK,SAAS,SAAS,OAAO,IAAI;IAAE,QAAQ;IAAgB,MAAM;IAAM,QAAQ;GAAK,CAAC;EAC9F,CACF,CAAC,CACA,OAAO,UAAmB;GACzB,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GACrE,QAAQ,YAAY,6BAA6B,OAAO,GAAG,IAAI,SAAS;EAC1E,CAAC;EAEH,OAAO;GACL,MAAM;GACN,IAAI,OAAO;GACX,MAAM,OAAO;GACb,KAAK,OAAO;GACZ,SAAS,OAAO;GAChB,SAAS,OAAO;GAChB;EACF;CACF;AACF"}

package/dist/bashRunService-Ci0cGdYO.d.mts

@@ -0,0 +1,71 @@
+import { l as RtkProcessedOutput } from "./rtkProcessor-CVZvNhkJ.mjs";
+//#region src/types/bashRunService.d.ts
+interface BashRunRequest {
+  command: string;
+  cwd?: string;
+  /**
+   * Stops the command outright once it has run this long. Only meaningful
+   * below the background threshold: past that the command is promoted instead.
+   */
+  timeoutMs?: number;
+  /** Runs in the background immediately, skipping the wait entirely. */
+  background?: boolean;
+  /** Runs under a pseudo terminal so the command can prompt for input. */
+  interactive?: boolean;
+  /** Preferred runner name. A colliding name gets a numbered variant. */
+  name?: string;
+  /** Receives bounded output snapshots while the command remains in the foreground. */
+  onOutput?: (output: string) => void;
+  /** Stops this run, including after promotion to a supervised background runner. */
+  signal?: AbortSignal;
+  /** Session that owns the runner, so shutdown can stop what it started. */
+  sessionId: string;
+}
+/** The command finished inside the foreground window. */
+interface CompletedRun {
+  kind: 'completed';
+  id: string;
+  name: string;
+  output: string;
+  exitCode: number | null;
+  signal: NodeJS.Signals | null;
+  logPath: string;
+  backend: 'rmux' | 'tmux' | 'native';
+  /** Present only when an eligible completed command was safely processed by RTK. */
+  rtkOutput?: RtkProcessedOutput;
+  /** RTK failure notice. The command outcome and raw output remain unchanged. */
+  rtkWarning?: string;
+  /** True when the run was stopped by the caller's timeout rather than finishing. */
+  timedOut?: boolean;
+  /** True when the run was stopped by the caller's abort signal. */
+  aborted?: boolean;
+}
+/** The command is still running and is now a supervised background runner. */
+interface PromotedRun {
+  kind: 'promoted';
+  id: string;
+  name: string;
+  pid: number;
+  logPath: string;
+  backend: 'rmux' | 'tmux' | 'native';
+  /**
+   * `requested` when the caller asked for it, `threshold` when it outlived the
+   * foreground window, `interactive` when it was hosted on a terminal.
+   */
+  reason: 'requested' | 'threshold' | 'interactive';
+}
+/** The process could not be started at all. */
+interface FailedRun {
+  kind: 'failed';
+  id: string;
+  name: string;
+  error: string;
+}
+type BashRunResult = CompletedRun | PromotedRun | FailedRun;
+/** Runs one bash command, promoting it to a background runner when it outlives the threshold. */
+interface IBashRunService {
+  run(request: BashRunRequest): Promise<BashRunResult>;
+}
+//#endregion
+export { IBashRunService as a, FailedRun as i, BashRunResult as n, PromotedRun as o, CompletedRun as r, BashRunRequest as t };
+//# sourceMappingURL=bashRunService-Ci0cGdYO.d.mts.map

package/dist/bashRunService-Ci0cGdYO.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashRunService-Ci0cGdYO.d.mts","names":[],"sources":["../src/types/bashRunService.ts"],"mappings":";;UAEiB;EACf;EACA;;;;;EAKA;;EAEA;;EAEA;;EAEA;;EAEA,YAAY;;EAEZ,SAAS;;EAET;;;UAIe;EACf;EACA;EACA;EACA;EACA;EACA,QAAQ,OAAO;EACf;EACA;;EAEA,YAAY;;EAEZ;;EAEA;;EAEA;;;UAIe;EACf;EACA;EACA;EACA;EACA;EACA;;;;;EAKA;;;UAIe;EACf;EACA;EACA;EACA;;KAGU,gBAAgB,eAAe,cAAc;;UAGxC;EACf,IAAI,SAAS,iBAAiB,QAAQ"}