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

package/dist/runnerRegistry-CeOHEjBv.mjs

@@ -0,0 +1,339 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createProcessRegistryService, normalizeRepositoryPath, resolveProcessTags } from "@agimon-ai/foundation-process-registry";
+import { resolveRootSessionId } from "@agimon-ai/po-core/childProcess";
+//#region src/constants/runnerRegistry.ts
+const SERVICE_TYPE = "tool";
+const SERVICE_PREFIX = "doom-runner:";
+const RUNNER_TAG = "doom-runner";
+const REGISTRY_PATH_ENV = "PROCESS_REGISTRY_PATH";
+//#endregion
+//#region src/services/runnerRecord/index.ts
+/** The disk record's shape guard, shared by the registry and every reader of its files. */
+function isRunnerRecord(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	return typeof record.id === "string" && typeof record.name === "string" && typeof record.pid === "number" && typeof record.command === "string" && typeof record.cwd === "string" && typeof record.logPath === "string" && typeof record.sessionId === "string" && typeof record.startedAt === "string" && (record.state === "running" || record.state === "completed") && typeof record.promoted === "boolean" && (record.backend === "rmux" || record.backend === "tmux" || record.backend === "native");
+}
+/** What the agent reads when a runner it sent to the background exits. Shared by the Pi and server hosts. */
+function formatRunnerFinished(record) {
+	const outcome = record.exit?.reason ?? record.state;
+	const code = record.exit?.code === null || record.exit?.code === void 0 ? "" : `, exit code ${record.exit.code}`;
+	return [
+		`Background runner ${record.name} exited: ${outcome}${code}.`,
+		`Runner ID: ${record.id}`,
+		`Log: ${record.logPath}`,
+		`Inspect: doom-runner logs ${record.id}`
+	].join("\n");
+}
+/** Compact footer text. An absent value removes the group entirely. */
+function formatRunnerStatus(count) {
+	return count > 0 ? `Runners ${count} ●` : void 0;
+}
+//#endregion
+//#region src/services/runnerRegistry/index.ts
+/** Opens the SQLite-backed registry the rest of the monorepo already shares. */
+function createDefaultProcessRegistry(env = process.env) {
+	return createProcessRegistryService(env[REGISTRY_PATH_ENV]);
+}
+function sessionTag(sessionId) {
+	return `session:${sessionId}`;
+}
+function readString(record, key) {
+	const value = record.metadata?.[key];
+	return typeof value === "string" ? value : "";
+}
+function readNumber(record, key) {
+	const value = record.metadata?.[key];
+	return typeof value === "number" ? value : 0;
+}
+const runCommand = promisify(execFile);
+/**
+* The process start time the registry stores to prove a pid is still the
+* process it registered.
+*
+* The registry resolves it itself when the caller omits it, and it does so with
+* `execFileSync`, which stops this process for the length of a `ps` on every
+* runner that starts. Reading it here costs the same subprocess and blocks
+* nothing: the command is already running by the time a runner is registered.
+*
+* The value has to match what the registry would have read, so the command and
+* the trimming are deliberately identical to its own.
+*/
+async function processStartedAt(pid) {
+	if (process.platform === "win32") return void 0;
+	try {
+		const { stdout } = await runCommand("ps", [
+			"-o",
+			"lstart=",
+			"-p",
+			String(pid)
+		], { encoding: "utf8" });
+		return stdout.trim() || void 0;
+	} catch {
+		return;
+	}
+}
+const listenersBySession = /* @__PURE__ */ new Map();
+var RunnerRegistry = class {
+	paths;
+	processControl;
+	registry;
+	environment;
+	subscriptions = /* @__PURE__ */ new Set();
+	constructor(paths, processControl, registry, environment) {
+		this.paths = paths;
+		this.processControl = processControl;
+		this.registry = registry;
+		this.environment = environment;
+	}
+	async register(input) {
+		const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+		const rootSessionId = resolveRootSessionId(input.sessionId, this.environment);
+		const identity = await processStartedAt(input.pid);
+		const response = await this.registry.registerProcess({
+			repositoryPath: this.repositoryPath(),
+			serviceName: `${SERVICE_PREFIX}${input.id}`,
+			serviceType: SERVICE_TYPE,
+			pid: input.pid,
+			command: input.command,
+			...identity === void 0 ? {} : { processStartedAt: identity },
+			tags: resolveProcessTags([
+				RUNNER_TAG,
+				`runner:${input.id}`,
+				sessionTag(input.sessionId)
+			]),
+			metadata: {
+				id: input.id,
+				name: input.name,
+				command: input.command,
+				cwd: input.cwd,
+				logPath: input.logPath,
+				interactive: input.interactive,
+				sessionId: input.sessionId,
+				rootSessionId,
+				backend: input.backend,
+				...input.backendTarget ? { backendTarget: input.backendTarget } : {},
+				startedAt,
+				hostPid: process.pid
+			},
+			force: true
+		});
+		if (!response.success) throw new Error(response.error ?? `Failed to register runner ${input.name}`);
+		const record = {
+			id: input.id,
+			name: input.name,
+			pid: input.pid,
+			command: input.command,
+			cwd: input.cwd,
+			logPath: input.logPath,
+			interactive: input.interactive,
+			sessionId: input.sessionId,
+			rootSessionId,
+			startedAt,
+			state: "running",
+			promoted: false,
+			backend: input.backend,
+			...input.backendTarget ? { backendTarget: input.backendTarget } : {},
+			hostPid: process.pid
+		};
+		this.writeRecord(record);
+		this.notify(record.sessionId);
+		return record;
+	}
+	async list() {
+		return (await this.registry.listProcesses({
+			repositoryPath: this.repositoryPath(),
+			serviceType: SERVICE_TYPE,
+			tags: resolveProcessTags([RUNNER_TAG])
+		})).map(toRunnerRecord);
+	}
+	async listAcrossRepositories() {
+		return (await this.registry.listProcesses({
+			serviceType: SERVICE_TYPE,
+			tags: resolveProcessTags([RUNNER_TAG])
+		})).map(toRunnerRecord);
+	}
+	async listBySession(sessionId) {
+		return (await this.list()).filter((record) => record.sessionId === sessionId);
+	}
+	async listByRootSession(rootSessionId) {
+		return (await this.list()).filter((record) => (record.rootSessionId ?? record.sessionId) === rootSessionId);
+	}
+	async listAll(sessionId) {
+		this.paths.ensureDirectories(sessionId);
+		const records = [];
+		const directory = this.paths.stateDirectory(sessionId);
+		for (const entry of fs.readdirSync(directory)) {
+			if (!isPrimaryMetadataEntry(entry)) continue;
+			try {
+				const parsed = JSON.parse(fs.readFileSync(`${directory}/${entry}`, "utf8"));
+				if (isRunnerRecord(parsed)) records.push(parsed);
+			} catch (error) {
+				process.emitWarning(`Could not read runner metadata ${entry}: ${String(error)}`);
+			}
+		}
+		return records.sort((left, right) => right.startedAt.localeCompare(left.startedAt));
+	}
+	async get(id, sessionId) {
+		const target = this.paths.statePathFor(id, sessionId);
+		try {
+			const parsed = JSON.parse(fs.readFileSync(target, "utf8"));
+			if (!isRunnerRecord(parsed) || parsed.id !== id) {
+				process.emitWarning(`Could not read runner metadata ${path.basename(target)}: invalid runner record`);
+				return;
+			}
+			return parsed;
+		} catch (error) {
+			if (error.code === "ENOENT") return void 0;
+			process.emitWarning(`Could not read runner metadata ${path.basename(target)}: ${String(error)}`);
+			return;
+		}
+	}
+	async markPromoted(id) {
+		const record = await this.get(id);
+		if (!record) return void 0;
+		const promoted = {
+			...record,
+			promoted: true
+		};
+		this.writeRecord(promoted);
+		this.notify(promoted.sessionId);
+		return promoted;
+	}
+	async requestTermination(id, intent, sessionId) {
+		const record = await this.get(id, sessionId);
+		if (!record) return void 0;
+		if (record.state === "completed") return record;
+		if (intent !== void 0 && record.terminationIntent !== void 0) return record;
+		const { terminationIntent: _previous, ...rest } = record;
+		const updated = {
+			...rest,
+			...intent ? { terminationIntent: intent } : {}
+		};
+		this.writeRecord(updated);
+		return updated;
+	}
+	async complete(id, outcome, sessionId) {
+		const persisted = await this.get(id, sessionId);
+		if (persisted?.state === "completed") {
+			await this.release(id, persisted.sessionId);
+			return persisted;
+		}
+		const active = await this.list();
+		const record = persisted ?? active.find((candidate) => candidate.id === id && (sessionId === void 0 || candidate.sessionId === sessionId));
+		if (!record) {
+			if (!(sessionId !== void 0 && active.some((candidate) => candidate.id === id && candidate.sessionId !== sessionId))) await this.release(id, sessionId);
+			return;
+		}
+		const completed = {
+			...record,
+			state: "completed",
+			exit: {
+				...outcome,
+				...outcome.signal !== null && outcome.terminationReason === void 0 && record.terminationIntent === void 0 ? { terminationReason: "external_signal" } : {},
+				...record.terminationIntent,
+				finishedAt: (/* @__PURE__ */ new Date()).toISOString()
+			}
+		};
+		this.writeRecord(completed);
+		await this.release(id, completed.sessionId);
+		return completed;
+	}
+	async release(id, sessionId) {
+		const ownedSessionId = sessionId ?? (await this.list()).find((record) => record.id === id)?.sessionId ?? (await this.get(id))?.sessionId;
+		const response = await this.registry.releaseProcess({
+			repositoryPath: this.repositoryPath(),
+			serviceName: `${SERVICE_PREFIX}${id}`,
+			serviceType: SERVICE_TYPE,
+			kill: false,
+			releasePort: false,
+			force: true
+		});
+		if (!response.success && !response.error?.includes("No matching process entry")) throw new Error(response.error ?? `Failed to release runner ${id}`);
+		if (ownedSessionId !== void 0) this.notify(ownedSessionId);
+	}
+	async pruneDead() {
+		const dead = (await this.list()).filter((record) => !this.processControl.isAlive(record.pid));
+		for (const record of dead) await this.complete(record.id, {
+			reason: "backend_lost",
+			code: null,
+			signal: null
+		}, record.sessionId);
+		return dead.map((record) => record.id);
+	}
+	subscribe(listener, sessionId) {
+		const subscribed = () => listener();
+		const registration = {
+			key: this.subscriptionKey(sessionId),
+			listener: subscribed
+		};
+		const listeners = listenersBySession.get(registration.key) ?? /* @__PURE__ */ new Set();
+		listeners.add(subscribed);
+		listenersBySession.set(registration.key, listeners);
+		this.subscriptions.add(registration);
+		return () => this.removeSubscription(registration);
+	}
+	close() {
+		for (const registration of this.subscriptions) this.removeSubscription(registration);
+		this.registry.close();
+	}
+	notify(sessionId) {
+		for (const listener of listenersBySession.get(this.subscriptionKey(sessionId)) ?? []) try {
+			listener();
+		} catch (error) {
+			process.emitWarning(`Runner registry listener failed: ${String(error)}`);
+		}
+	}
+	removeSubscription(registration) {
+		const listeners = listenersBySession.get(registration.key);
+		listeners?.delete(registration.listener);
+		if (listeners?.size === 0) listenersBySession.delete(registration.key);
+		this.subscriptions.delete(registration);
+	}
+	subscriptionKey(sessionId) {
+		return JSON.stringify([path.resolve(this.paths.stateDirectory(sessionId)), sessionId]);
+	}
+	repositoryPath() {
+		return normalizeRepositoryPath(this.paths.repositoryPath());
+	}
+	writeRecord(record) {
+		this.paths.ensureDirectories(record.sessionId);
+		const target = this.paths.statePathFor(record.id, record.sessionId);
+		const temporary = `${target}.${process.pid}.tmp`;
+		fs.writeFileSync(temporary, `${JSON.stringify(record, null, 2)}\n`, "utf8");
+		fs.renameSync(temporary, target);
+	}
+};
+/** Every field is read back from metadata this class wrote on registration. */
+function toRunnerRecord(record) {
+	return {
+		id: readString(record, "id"),
+		name: readString(record, "name"),
+		pid: record.pid,
+		command: readString(record, "command"),
+		cwd: readString(record, "cwd"),
+		logPath: readString(record, "logPath"),
+		interactive: record.metadata?.interactive === true,
+		sessionId: readString(record, "sessionId"),
+		...readString(record, "rootSessionId") ? { rootSessionId: readString(record, "rootSessionId") } : {},
+		startedAt: readString(record, "startedAt"),
+		state: "running",
+		promoted: false,
+		backend: readBackend(record.metadata?.backend),
+		...readString(record, "backendTarget") ? { backendTarget: readString(record, "backendTarget") } : {},
+		hostPid: readNumber(record, "hostPid")
+	};
+}
+function readBackend(value) {
+	return value === "rmux" || value === "tmux" ? value : "native";
+}
+function isPrimaryMetadataEntry(entry) {
+	return entry.endsWith(".json") && !entry.endsWith(".command.json") && !entry.endsWith(".exit.json");
+}
+//#endregion
+export { isRunnerRecord as a, formatRunnerStatus as i, createDefaultProcessRegistry as n, formatRunnerFinished as r, RunnerRegistry as t };
+
+//# sourceMappingURL=runnerRegistry-CeOHEjBv.mjs.map

package/dist/runnerRegistry-CeOHEjBv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerRegistry-CeOHEjBv.mjs","names":[],"sources":["../src/constants/runnerRegistry.ts","../src/services/runnerRecord/index.ts","../src/services/runnerRegistry/index.ts"],"sourcesContent":["export const SERVICE_TYPE = 'tool';\nexport const SERVICE_PREFIX = 'doom-runner:';\nexport const RUNNER_TAG = 'doom-runner';\nexport const REGISTRY_PATH_ENV = 'PROCESS_REGISTRY_PATH';\nexport const JSON_EXTENSION = '.json';\nexport const COMMAND_SIDECAR_SUFFIX = '.command.json';\nexport const EXIT_SIDECAR_SUFFIX = '.exit.json';\nexport const NOT_FOUND_ERROR_CODE = 'ENOENT';\n","import type { RunnerRecord } from '../../types/runnerRegistry';\n\n/** The disk record's shape guard, shared by the registry and every reader of its files. */\nexport function isRunnerRecord(value: unknown): value is RunnerRecord {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Partial<RunnerRecord>;\n  return (\n    typeof record.id === 'string' &&\n    typeof record.name === 'string' &&\n    typeof record.pid === 'number' &&\n    typeof record.command === 'string' &&\n    typeof record.cwd === 'string' &&\n    typeof record.logPath === 'string' &&\n    typeof record.sessionId === 'string' &&\n    typeof record.startedAt === 'string' &&\n    (record.state === 'running' || record.state === 'completed') &&\n    typeof record.promoted === 'boolean' &&\n    (record.backend === 'rmux' || record.backend === 'tmux' || record.backend === 'native')\n  );\n}\n\n/** What the agent reads when a runner it sent to the background exits. Shared by the Pi and server hosts. */\nexport function formatRunnerFinished(record: RunnerRecord): string {\n  const outcome = record.exit?.reason ?? record.state;\n  const code = record.exit?.code === null || record.exit?.code === undefined ? '' : `, exit code ${record.exit.code}`;\n  return [\n    `Background runner ${record.name} exited: ${outcome}${code}.`,\n    `Runner ID: ${record.id}`,\n    `Log: ${record.logPath}`,\n    `Inspect: doom-runner logs ${record.id}`,\n  ].join('\\n');\n}\n\n/** Compact footer text. An absent value removes the group entirely. */\nexport function formatRunnerStatus(count: number): string | undefined {\n  return count > 0 ? `Runners ${count} ●` : undefined;\n}\n\nexport function formatRunnerFooterContribution(count: number): { fullText: string; compactText: string } | undefined {\n  return count > 0 ? { fullText: `Runner ${count}`, compactText: `R${count}` } : undefined;\n}\n","import { execFile } from 'node:child_process';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { promisify } from 'node:util';\n\nimport {\n  createProcessRegistryService,\n  normalizeRepositoryPath,\n  type ProcessRegistryRecord,\n  type ProcessRegistryService,\n  resolveProcessTags,\n} from '@agimon-ai/foundation-process-registry';\nimport { resolveRootSessionId } from '@agimon-ai/po-core/childProcess';\n\nimport {\n  COMMAND_SIDECAR_SUFFIX,\n  EXIT_SIDECAR_SUFFIX,\n  JSON_EXTENSION,\n  NOT_FOUND_ERROR_CODE,\n  REGISTRY_PATH_ENV,\n  RUNNER_TAG,\n  SERVICE_PREFIX,\n  SERVICE_TYPE,\n} from '../../constants/runnerRegistry';\nimport type { IProcessControl } from '../../types/processControl';\nimport type {\n  CompleteRunnerInput,\n  IRunnerRegistry,\n  RegisterRunnerInput,\n  RunnerRecord,\n  RunnerTerminationIntent,\n} from '../../types/runnerRegistry';\nimport type { IRunnerPaths } from '../runnerPaths/type';\nimport { isRunnerRecord } from '../runnerRecord';\n\n/** The slice of the shared registry service this wrapper depends on. */\nexport type ProcessRegistryPort = Pick<\n  ProcessRegistryService,\n  'registerProcess' | 'releaseProcess' | 'listProcesses' | 'close'\n>;\n\n/** Opens the SQLite-backed registry the rest of the monorepo already shares. */\nexport function createDefaultProcessRegistry(\n  env: Readonly<Record<string, string | undefined>> = process.env,\n): ProcessRegistryPort {\n  return createProcessRegistryService(env[REGISTRY_PATH_ENV]);\n}\n\nfunction sessionTag(sessionId: string): string {\n  return `session:${sessionId}`;\n}\n\nfunction readString(record: ProcessRegistryRecord, key: string): string {\n  const value = record.metadata?.[key];\n  return typeof value === 'string' ? value : '';\n}\n\nfunction readNumber(record: ProcessRegistryRecord, key: string): number {\n  const value = record.metadata?.[key];\n  return typeof value === 'number' ? value : 0;\n}\n\nconst runCommand = promisify(execFile);\n\n/**\n * The process start time the registry stores to prove a pid is still the\n * process it registered.\n *\n * The registry resolves it itself when the caller omits it, and it does so with\n * `execFileSync`, which stops this process for the length of a `ps` on every\n * runner that starts. Reading it here costs the same subprocess and blocks\n * nothing: the command is already running by the time a runner is registered.\n *\n * The value has to match what the registry would have read, so the command and\n * the trimming are deliberately identical to its own.\n */\nasync function processStartedAt(pid: number): Promise<string | undefined> {\n  if (process.platform === 'win32') return undefined;\n  try {\n    const { stdout } = await runCommand('ps', ['-o', 'lstart=', '-p', String(pid)], { encoding: 'utf8' });\n    return stdout.trim() || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\ntype ListenerRegistration = Readonly<{ key: string; listener: () => void }>;\n\n// Facet replacement can leave an in-flight tool and its publisher on different registry instances.\nconst listenersBySession = new Map<string, Set<() => void>>();\n\nexport class RunnerRegistry implements IRunnerRegistry {\n  private readonly subscriptions = new Set<ListenerRegistration>();\n\n  constructor(\n    private readonly paths: IRunnerPaths,\n    private readonly processControl: IProcessControl,\n    private readonly registry: ProcessRegistryPort,\n    private readonly environment: Readonly<Record<string, string | undefined>>,\n  ) {}\n\n  async register(input: RegisterRunnerInput): Promise<RunnerRecord> {\n    const startedAt = new Date().toISOString();\n    const rootSessionId = resolveRootSessionId(input.sessionId, this.environment);\n    const identity = await processStartedAt(input.pid);\n    const response = await this.registry.registerProcess({\n      repositoryPath: this.repositoryPath(),\n      serviceName: `${SERVICE_PREFIX}${input.id}`,\n      serviceType: SERVICE_TYPE,\n      pid: input.pid,\n      command: input.command,\n      ...(identity === undefined ? {} : { processStartedAt: identity }),\n      tags: resolveProcessTags([RUNNER_TAG, `runner:${input.id}`, sessionTag(input.sessionId)]),\n      metadata: {\n        id: input.id,\n        name: input.name,\n        command: input.command,\n        cwd: input.cwd,\n        logPath: input.logPath,\n        interactive: input.interactive,\n        sessionId: input.sessionId,\n        rootSessionId,\n        backend: input.backend,\n        ...(input.backendTarget ? { backendTarget: input.backendTarget } : {}),\n        startedAt,\n        hostPid: process.pid,\n      },\n      // The caller has already resolved name collisions against live records,\n      // so anything still holding this name is stale.\n      force: true,\n    });\n    if (!response.success) throw new Error(response.error ?? `Failed to register runner ${input.name}`);\n    const record: RunnerRecord = {\n      id: input.id,\n      name: input.name,\n      pid: input.pid,\n      command: input.command,\n      cwd: input.cwd,\n      logPath: input.logPath,\n      interactive: input.interactive,\n      sessionId: input.sessionId,\n      rootSessionId,\n      startedAt,\n      state: 'running',\n      promoted: false,\n      backend: input.backend,\n      ...(input.backendTarget ? { backendTarget: input.backendTarget } : {}),\n      hostPid: process.pid,\n    };\n    this.writeRecord(record);\n    this.notify(record.sessionId);\n    return record;\n  }\n\n  async list(): Promise<RunnerRecord[]> {\n    const records = await this.registry.listProcesses({\n      repositoryPath: this.repositoryPath(),\n      serviceType: SERVICE_TYPE,\n      tags: resolveProcessTags([RUNNER_TAG]),\n    });\n    return records.map(toRunnerRecord);\n  }\n\n  async listAcrossRepositories(): Promise<RunnerRecord[]> {\n    const records = await this.registry.listProcesses({\n      serviceType: SERVICE_TYPE,\n      tags: resolveProcessTags([RUNNER_TAG]),\n    });\n    return records.map(toRunnerRecord);\n  }\n\n  async listBySession(sessionId: string): Promise<RunnerRecord[]> {\n    const records = await this.list();\n    return records.filter((record) => record.sessionId === sessionId);\n  }\n\n  async listByRootSession(rootSessionId: string): Promise<RunnerRecord[]> {\n    const records = await this.list();\n    return records.filter((record) => (record.rootSessionId ?? record.sessionId) === rootSessionId);\n  }\n\n  async listAll(sessionId?: string): Promise<RunnerRecord[]> {\n    this.paths.ensureDirectories(sessionId);\n    const records: RunnerRecord[] = [];\n    const directory = this.paths.stateDirectory(sessionId);\n    for (const entry of fs.readdirSync(directory)) {\n      if (!isPrimaryMetadataEntry(entry)) continue;\n      try {\n        const parsed: unknown = JSON.parse(fs.readFileSync(`${directory}/${entry}`, 'utf8'));\n        if (isRunnerRecord(parsed)) records.push(parsed);\n      } catch (error) {\n        process.emitWarning(`Could not read runner metadata ${entry}: ${String(error)}`);\n      }\n    }\n    return records.sort((left, right) => right.startedAt.localeCompare(left.startedAt));\n  }\n\n  async get(id: string, sessionId?: string): Promise<RunnerRecord | undefined> {\n    const target = this.paths.statePathFor(id, sessionId);\n    try {\n      const parsed: unknown = JSON.parse(fs.readFileSync(target, 'utf8'));\n      if (!isRunnerRecord(parsed) || parsed.id !== id) {\n        process.emitWarning(`Could not read runner metadata ${path.basename(target)}: invalid runner record`);\n        return undefined;\n      }\n      return parsed;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === NOT_FOUND_ERROR_CODE) return undefined;\n      process.emitWarning(`Could not read runner metadata ${path.basename(target)}: ${String(error)}`);\n      return undefined;\n    }\n  }\n\n  async markPromoted(id: string): Promise<RunnerRecord | undefined> {\n    const record = await this.get(id);\n    if (!record) return undefined;\n    const promoted = { ...record, promoted: true };\n    this.writeRecord(promoted);\n    this.notify(promoted.sessionId);\n    return promoted;\n  }\n\n  async requestTermination(\n    id: string,\n    intent: RunnerTerminationIntent | undefined,\n    sessionId?: string,\n  ): Promise<RunnerRecord | undefined> {\n    const record = await this.get(id, sessionId);\n    if (!record) return undefined;\n    if (record.state === 'completed') return record;\n    if (intent !== undefined && record.terminationIntent !== undefined) return record;\n    const { terminationIntent: _previous, ...rest } = record;\n    const updated: RunnerRecord = { ...rest, ...(intent ? { terminationIntent: intent } : {}) };\n    this.writeRecord(updated);\n    return updated;\n  }\n\n  async complete(id: string, outcome: CompleteRunnerInput, sessionId?: string): Promise<RunnerRecord | undefined> {\n    const persisted = await this.get(id, sessionId);\n    if (persisted?.state === 'completed') {\n      await this.release(id, persisted.sessionId);\n      return persisted;\n    }\n    const active = await this.list();\n    const record =\n      persisted ??\n      active.find((candidate) => candidate.id === id && (sessionId === undefined || candidate.sessionId === sessionId));\n    if (!record) {\n      const belongsToAnotherSession =\n        sessionId !== undefined && active.some((candidate) => candidate.id === id && candidate.sessionId !== sessionId);\n      if (!belongsToAnotherSession) await this.release(id, sessionId);\n      return undefined;\n    }\n    const completed: RunnerRecord = {\n      ...record,\n      state: 'completed',\n      exit: {\n        ...outcome,\n        ...(outcome.signal !== null && outcome.terminationReason === undefined && record.terminationIntent === undefined\n          ? { terminationReason: 'external_signal' as const }\n          : {}),\n        ...record.terminationIntent,\n        finishedAt: new Date().toISOString(),\n      },\n    };\n    this.writeRecord(completed);\n    await this.release(id, completed.sessionId);\n    return completed;\n  }\n\n  async release(id: string, sessionId?: string): Promise<void> {\n    const activeSessionId = sessionId ?? (await this.list()).find((record) => record.id === id)?.sessionId;\n    const ownedSessionId = activeSessionId ?? (await this.get(id))?.sessionId;\n    const response = await this.registry.releaseProcess({\n      repositoryPath: this.repositoryPath(),\n      serviceName: `${SERVICE_PREFIX}${id}`,\n      serviceType: SERVICE_TYPE,\n      kill: false,\n      releasePort: false,\n      force: true,\n    });\n    if (!response.success && !response.error?.includes('No matching process entry')) {\n      throw new Error(response.error ?? `Failed to release runner ${id}`);\n    }\n    if (ownedSessionId !== undefined) this.notify(ownedSessionId);\n  }\n\n  async pruneDead(): Promise<string[]> {\n    const dead = (await this.list()).filter((record) => !this.processControl.isAlive(record.pid));\n    for (const record of dead) {\n      await this.complete(record.id, { reason: 'backend_lost', code: null, signal: null }, record.sessionId);\n    }\n    return dead.map((record) => record.id);\n  }\n\n  subscribe(listener: () => void, sessionId: string): () => void {\n    const subscribed = (): void => listener();\n    const registration = { key: this.subscriptionKey(sessionId), listener: subscribed };\n    const listeners = listenersBySession.get(registration.key) ?? new Set<() => void>();\n    listeners.add(subscribed);\n    listenersBySession.set(registration.key, listeners);\n    this.subscriptions.add(registration);\n    return () => this.removeSubscription(registration);\n  }\n\n  close(): void {\n    for (const registration of this.subscriptions) this.removeSubscription(registration);\n    this.registry.close();\n  }\n\n  private notify(sessionId: string): void {\n    for (const listener of listenersBySession.get(this.subscriptionKey(sessionId)) ?? []) {\n      try {\n        listener();\n      } catch (error) {\n        process.emitWarning(`Runner registry listener failed: ${String(error)}`);\n      }\n    }\n  }\n\n  private removeSubscription(registration: ListenerRegistration): void {\n    const listeners = listenersBySession.get(registration.key);\n    listeners?.delete(registration.listener);\n    if (listeners?.size === 0) listenersBySession.delete(registration.key);\n    this.subscriptions.delete(registration);\n  }\n\n  private subscriptionKey(sessionId: string): string {\n    return JSON.stringify([path.resolve(this.paths.stateDirectory(sessionId)), sessionId]);\n  }\n\n  private repositoryPath(): string {\n    return normalizeRepositoryPath(this.paths.repositoryPath());\n  }\n\n  private writeRecord(record: RunnerRecord): void {\n    this.paths.ensureDirectories(record.sessionId);\n    const target = this.paths.statePathFor(record.id, record.sessionId);\n    const temporary = `${target}.${process.pid}.tmp`;\n    fs.writeFileSync(temporary, `${JSON.stringify(record, null, 2)}\\n`, 'utf8');\n    fs.renameSync(temporary, target);\n  }\n}\n\n/** Every field is read back from metadata this class wrote on registration. */\nfunction toRunnerRecord(record: ProcessRegistryRecord): RunnerRecord {\n  return {\n    id: readString(record, 'id'),\n    name: readString(record, 'name'),\n    pid: record.pid,\n    command: readString(record, 'command'),\n    cwd: readString(record, 'cwd'),\n    logPath: readString(record, 'logPath'),\n    interactive: record.metadata?.interactive === true,\n    sessionId: readString(record, 'sessionId'),\n    ...(readString(record, 'rootSessionId') ? { rootSessionId: readString(record, 'rootSessionId') } : {}),\n    startedAt: readString(record, 'startedAt'),\n    state: 'running',\n    promoted: false,\n    backend: readBackend(record.metadata?.backend),\n    ...(readString(record, 'backendTarget') ? { backendTarget: readString(record, 'backendTarget') } : {}),\n    hostPid: readNumber(record, 'hostPid'),\n  };\n}\n\nfunction readBackend(value: unknown): RunnerRecord['backend'] {\n  return value === 'rmux' || value === 'tmux' ? value : 'native';\n}\n\nfunction isPrimaryMetadataEntry(entry: string): boolean {\n  return (\n    entry.endsWith(JSON_EXTENSION) && !entry.endsWith(COMMAND_SIDECAR_SUFFIX) && !entry.endsWith(EXIT_SIDECAR_SUFFIX)\n  );\n}\n"],"mappings":"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"}

package/dist/runnerRegistry-CtJiD02R.d.mts

@@ -0,0 +1,88 @@
+//#region src/types/runnerRegistry.d.ts
+type RunnerBackend = 'rmux' | 'tmux' | 'native';
+type RunnerState = 'running' | 'completed';
+type RunnerExitReason = 'completed' | 'failed' | 'signaled' | 'stopped' | 'timed_out' | 'launcher_error' | 'backend_lost';
+type RunnerTerminationReason = 'timeout' | 'user_stop' | 'request_cancelled' | 'parent_session_cleanup' | 'owner_lost' | 'external_signal';
+type RunnerTerminationIntent = {
+  reason: 'stopped' | 'timed_out';
+  terminationReason: Exclude<RunnerTerminationReason, 'external_signal'>;
+  stopReason?: string;
+};
+interface RunnerExit {
+  reason: RunnerExitReason;
+  code: number | null;
+  signal: NodeJS.Signals | null;
+  terminationReason?: RunnerTerminationReason;
+  stopReason?: string;
+  finishedAt: string;
+}
+/** A command this extension supervises, retained after completion for CLI access. */
+interface RunnerRecord {
+  id: string;
+  name: string;
+  /** Process group leader, the pid signals are sent to. */
+  pid: number;
+  command: string;
+  cwd: string;
+  logPath: string;
+  interactive: boolean;
+  sessionId: string;
+  /** Root Pi session shared by the process tree. Ownership remains with sessionId. */
+  rootSessionId?: string;
+  startedAt: string;
+  state: RunnerState;
+  promoted: boolean;
+  backend: RunnerBackend;
+  backendTarget?: string;
+  exit?: RunnerExit;
+  /** Persisted before sending a stop signal so other observers retain the caller's intent. */
+  terminationIntent?: RunnerTerminationIntent;
+  /** pid of the pi process that launched it, for orphan detection. */
+  hostPid: number;
+}
+interface RegisterRunnerInput {
+  id: string;
+  name: string;
+  pid: number;
+  command: string;
+  cwd: string;
+  logPath: string;
+  interactive: boolean;
+  sessionId: string;
+  backend: RunnerBackend;
+  backendTarget?: string;
+}
+interface CompleteRunnerInput {
+  reason: RunnerExitReason;
+  code: number | null;
+  signal: NodeJS.Signals | null;
+  terminationReason?: RunnerTerminationReason;
+  stopReason?: string;
+}
+/** Worktree-scoped active registry with session-scoped retained history. */
+interface IRunnerRegistry {
+  register(input: RegisterRunnerInput): Promise<RunnerRecord>;
+  list(): Promise<RunnerRecord[]>;
+  /** Active doom-runner records across repository scopes, used only for safe legacy-store cleanup. */
+  listAcrossRepositories(): Promise<RunnerRecord[]>;
+  /** Active records started by one session, used for scoped bulk stop and shutdown. */
+  listBySession(sessionId: string): Promise<RunnerRecord[]>;
+  /** Active records visible to every descendant of one root Pi session. */
+  listByRootSession(rootSessionId: string): Promise<RunnerRecord[]>;
+  /** Active and recently completed records retained for one session. */
+  listAll(sessionId?: string): Promise<RunnerRecord[]>;
+  get(id: string, sessionId?: string): Promise<RunnerRecord | undefined>;
+  markPromoted(id: string): Promise<RunnerRecord | undefined>;
+  requestTermination(id: string, intent: RunnerTerminationIntent | undefined, sessionId?: string): Promise<RunnerRecord | undefined>;
+  complete(id: string, outcome: CompleteRunnerInput, sessionId?: string): Promise<RunnerRecord | undefined>;
+  /** Removes the active process entry while retaining run metadata. */
+  release(id: string, sessionId?: string): Promise<void>;
+  /** Marks entries whose process is gone as lost. Returns their ids. */
+  pruneDead(): Promise<string[]>;
+  /** Notifies in-process consumers after this session's registry changes. */
+  subscribe(listener: () => void, sessionId: string): () => void;
+  close(): void;
+}
+//#endregion
+export { RunnerTerminationIntent as a, RunnerRecord as i, IRunnerRegistry as n, RegisterRunnerInput as r, CompleteRunnerInput as t };
+//# sourceMappingURL=runnerRegistry-CtJiD02R.d.mts.map

package/dist/runnerRegistry-CtJiD02R.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerRegistry-CtJiD02R.d.mts","names":[],"sources":["../src/types/runnerRegistry.ts"],"mappings":";KAAY;KACA;KACA;KASA;KAOA;EACV;EACA,mBAAmB,QAAQ;EAC3B;;UAGe;EACf,QAAQ;EACR;EACA,QAAQ,OAAO;EACf,oBAAoB;EACpB;EACA;;;UAIe;EACf;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA,OAAO;EACP;EACA,SAAS;EACT;EACA,OAAO;;EAEP,oBAAoB;;EAEpB;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS;EACT;;UAGe;EACf,QAAQ;EACR;EACA,QAAQ,OAAO;EACf,oBAAoB;EACpB;;;UAIe;EACf,SAAS,OAAO,sBAAsB,QAAQ;EAC9C,QAAQ,QAAQ;;EAEhB,0BAA0B,QAAQ;;EAElC,cAAc,oBAAoB,QAAQ;;EAE1C,kBAAkB,wBAAwB,QAAQ;;EAElD,QAAQ,qBAAqB,QAAQ;EACrC,IAAI,YAAY,qBAAqB,QAAQ;EAC7C,aAAa,aAAa,QAAQ;EAClC,mBACE,YACA,QAAQ,qCACR,qBACC,QAAQ;EACX,SAAS,YAAY,SAAS,qBAAqB,qBAAqB,QAAQ;;EAEhF,QAAQ,YAAY,qBAAqB;;EAEzC,aAAa;;EAEb,UAAU,sBAAsB;EAChC"}

package/dist/runnerRegistry.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runnerRegistry = require("./runnerRegistry-BmkZTJHi.cjs");
+exports.RunnerRegistry = require_runnerRegistry.RunnerRegistry;
+exports.createDefaultProcessRegistry = require_runnerRegistry.createDefaultProcessRegistry;

package/dist/runnerRegistry.d.mts

@@ -0,0 +1,3 @@
+import { i as RunnerRecord, n as IRunnerRegistry, r as RegisterRunnerInput } from "./runnerRegistry-CtJiD02R.mjs";
+import { n as RunnerRegistry, r as createDefaultProcessRegistry, t as ProcessRegistryPort } from "./index-DBz0DxnL.mjs";
+export { type IRunnerRegistry, type ProcessRegistryPort, type RegisterRunnerInput, type RunnerRecord, RunnerRegistry, createDefaultProcessRegistry };

package/dist/runnerRegistry.mjs

@@ -0,0 +1,2 @@
+import { n as createDefaultProcessRegistry, t as RunnerRegistry } from "./runnerRegistry-CeOHEjBv.mjs";
+export { RunnerRegistry, createDefaultProcessRegistry };

package/dist/runnerSettings-DiV1lvzx.d.mts

@@ -0,0 +1,34 @@
+//#region src/types/runnerSettings.d.ts
+/**
+ * Project-local extension configuration, read from `<CONFIG_DIR_NAME>/po-runner.json`.
+ *
+ * Pi's convention for extension configuration is one JSON file per extension
+ * under the config directory, honoured only for a trusted project. Values here
+ * are the project's baseline: an environment variable still wins for a single
+ * invocation, and a per-command pragma wins over both.
+ */
+interface RunnerSettings {
+  /** Byte ceiling for one tool result. */
+  readonly maxResultBytes?: number;
+  /** Line ceiling for one tool result. */
+  readonly maxResultLines?: number;
+  /** Byte ceiling for the result of a command that succeeded. */
+  readonly successMaxResultBytes?: number;
+  /** Token ceiling for one tool result. */
+  readonly maxResultTokens?: number;
+  /** Token ceiling for the result of a command that succeeded. */
+  readonly successMaxResultTokens?: number;
+  /** Share of the budget spent on the leading excerpt, between 0 and 1. */
+  readonly headRatio?: number;
+  /** Extra severity patterns appended to the built-in matcher. */
+  readonly errorPatterns?: readonly string[];
+  /** Distinct failures rescued from the elided middle. */
+  readonly errorMaxEntries?: number;
+  /** Variants joined inside one bracket before the rest become a count. */
+  readonly errorMaxVariantsJoined?: number;
+  /** Share of the budget reserved for rescued errors, between 0 and 1. */
+  readonly errorBudgetRatio?: number;
+}
+//#endregion
+export { RunnerSettings as t };
+//# sourceMappingURL=runnerSettings-DiV1lvzx.d.mts.map

package/dist/runnerSettings-DiV1lvzx.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerSettings-DiV1lvzx.d.mts","names":[],"sources":["../src/types/runnerSettings.ts"],"mappings":";;;;;;;;;UAQiB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA"}

package/dist/services/lifeline/client.cjs

@@ -0,0 +1,52 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("../../rolldown-runtime-VH7oDXx4.cjs");
+let node_net = require("node:net");
+node_net = require_rolldown_runtime.__toESM(node_net, 1);
+//#region src/services/lifeline/client.ts
+/** Environment variable carrying the lifeline socket path to every runner supervisor. */
+const LIFELINE_ENV = "DOOM_RUNNER_LIFELINE";
+/**
+* Reports the owning pi process dying to a runner's supervisor.
+*
+* A connected Unix socket drops the moment the owner's descriptors close, which
+* happens on every exit path including SIGKILL, so it is the one death signal a
+* graceful shutdown handler cannot provide. Connecting never blocks, the close
+* edge arrives through the event loop rather than a poll, and an unref'd socket
+* can never keep the supervisor alive: the watcher is therefore incapable of
+* outliving the process that installed it.
+*
+* A refused or missing socket means the owner died before this runner started,
+* which is reported the same way as a later death rather than left to hang.
+*
+* Runners run unwatched when no lifeline is armed, so a missing environment
+* variable can never be mistaken for a dead owner.
+*/
+function watchOwner(onOwnerLost, target = process.env[LIFELINE_ENV]) {
+	if (!target) return () => void 0;
+	let settled = false;
+	const settle = () => {
+		if (settled) return;
+		settled = true;
+		onOwnerLost();
+	};
+	let connection;
+	try {
+		connection = node_net.default.connect(target);
+	} catch (error) {
+		process.emitWarning(`Could not watch the doom-runner lifeline: ${String(error)}`);
+		return () => void 0;
+	}
+	connection.unref();
+	connection.on("connect", () => connection.resume());
+	connection.on("error", settle);
+	connection.on("close", settle);
+	return () => {
+		settled = true;
+		connection.destroy();
+	};
+}
+//#endregion
+exports.LIFELINE_ENV = LIFELINE_ENV;
+exports.watchOwner = watchOwner;
+
+//# sourceMappingURL=client.cjs.map

package/dist/services/lifeline/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","names":["net"],"sources":["../../../src/services/lifeline/client.ts"],"sourcesContent":["import net from 'node:net';\n\n/** Environment variable carrying the lifeline socket path to every runner supervisor. */\nexport const LIFELINE_ENV = 'DOOM_RUNNER_LIFELINE';\n\n/**\n * Reports the owning pi process dying to a runner's supervisor.\n *\n * A connected Unix socket drops the moment the owner's descriptors close, which\n * happens on every exit path including SIGKILL, so it is the one death signal a\n * graceful shutdown handler cannot provide. Connecting never blocks, the close\n * edge arrives through the event loop rather than a poll, and an unref'd socket\n * can never keep the supervisor alive: the watcher is therefore incapable of\n * outliving the process that installed it.\n *\n * A refused or missing socket means the owner died before this runner started,\n * which is reported the same way as a later death rather than left to hang.\n *\n * Runners run unwatched when no lifeline is armed, so a missing environment\n * variable can never be mistaken for a dead owner.\n */\nexport function watchOwner(\n  onOwnerLost: () => void,\n  target: string | undefined = process.env[LIFELINE_ENV],\n): () => void {\n  if (!target) return () => undefined;\n\n  let settled = false;\n  const settle = (): void => {\n    if (settled) return;\n    settled = true;\n    onOwnerLost();\n  };\n\n  let connection: net.Socket;\n  try {\n    connection = net.connect(target);\n  } catch (error) {\n    process.emitWarning(`Could not watch the doom-runner lifeline: ${String(error)}`);\n    return () => undefined;\n  }\n\n  // The supervisor's own exit must never wait on this socket.\n  connection.unref();\n  // The owner never sends anything, so drain rather than accumulate.\n  connection.on('connect', () => connection.resume());\n  connection.on('error', settle);\n  connection.on('close', settle);\n\n  return () => {\n    settled = true;\n    connection.destroy();\n  };\n}\n"],"mappings":";;;;;;AAGA,MAAa,eAAe;;;;;;;;;;;;;;;;;AAkB5B,SAAgB,WACd,aACA,SAA6B,QAAQ,IAAI,eAC7B;CACZ,IAAI,CAAC,QAAQ,aAAa,KAAA;CAE1B,IAAI,UAAU;CACd,MAAM,eAAqB;EACzB,IAAI,SAAS;EACb,UAAU;EACV,YAAY;CACd;CAEA,IAAI;CACJ,IAAI;EACF,aAAaA,SAAAA,QAAI,QAAQ,MAAM;CACjC,SAAS,OAAO;EACd,QAAQ,YAAY,6CAA6C,OAAO,KAAK,GAAG;EAChF,aAAa,KAAA;CACf;CAGA,WAAW,MAAM;CAEjB,WAAW,GAAG,iBAAiB,WAAW,OAAO,CAAC;CAClD,WAAW,GAAG,SAAS,MAAM;CAC7B,WAAW,GAAG,SAAS,MAAM;CAE7B,aAAa;EACX,UAAU;EACV,WAAW,QAAQ;CACrB;AACF"}

package/dist/services/lifeline/client.d.mts

@@ -0,0 +1,22 @@
+//#region src/services/lifeline/client.d.ts
+/** Environment variable carrying the lifeline socket path to every runner supervisor. */
+export declare const LIFELINE_ENV = "DOOM_RUNNER_LIFELINE";
+/**
+ * Reports the owning pi process dying to a runner's supervisor.
+ *
+ * A connected Unix socket drops the moment the owner's descriptors close, which
+ * happens on every exit path including SIGKILL, so it is the one death signal a
+ * graceful shutdown handler cannot provide. Connecting never blocks, the close
+ * edge arrives through the event loop rather than a poll, and an unref'd socket
+ * can never keep the supervisor alive: the watcher is therefore incapable of
+ * outliving the process that installed it.
+ *
+ * A refused or missing socket means the owner died before this runner started,
+ * which is reported the same way as a later death rather than left to hang.
+ *
+ * Runners run unwatched when no lifeline is armed, so a missing environment
+ * variable can never be mistaken for a dead owner.
+ */
+export declare function watchOwner(onOwnerLost: () => void, target?: string | undefined): () => void;
+//#endregion
+//# sourceMappingURL=client.d.mts.map

package/dist/services/lifeline/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../../../src/services/lifeline/client.ts"],"mappings":";;qBAGa;;;;;;;;;;;;;;;;;wBAkBG,WACd,yBACA"}