@agimon-ai/po-runner 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/extensions/server.cjs

@@ -3,21 +3,23 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_rolldown_runtime = require("../rolldown-runtime-VH7oDXx4.cjs");
-const require_runnerConfig = require("../runnerConfig-D2tGq5ZM.cjs");
-const require_logReader = require("../logReader-B6J7L7Ua.cjs");
-const require_headless = require("../headless-CHUsBGhg.cjs");
-const require_reconcile = require("../reconcile-BugwYFbV.cjs");
-const require_compaction = require("../compaction-4QSUsBxq.cjs");
-const require_rmuxBackend = require("../rmuxBackend-DlxgqRZ1.cjs");
-const require_runnerDependencies = require("../runnerDependencies-KMZigIxB.cjs");
-const require_runnerPaths = require("../runnerPaths-BTEuzxw0.cjs");
-const require_runnerRegistry = require("../runnerRegistry-BmkZTJHi.cjs");
+const require_runnerConfig = require("../runnerConfig-BoLMinlx.cjs");
+const require_logReader = require("../logReader-DHCK2BEr.cjs");
+const require_headless = require("../headless-Dko_yBiy.cjs");
+const require_reconcile = require("../reconcile-5cZ11jSD.cjs");
+const require_clock = require("../clock-jqnLWziT.cjs");
+const require_compaction = require("../compaction-Cduebib_.cjs");
+const require_rmuxBackend = require("../rmuxBackend-Dh0CYVAL.cjs");
+const require_launcher = require("../launcher-ZgDdyXpq.cjs");
+const require_runnerDependencies = require("../runnerDependencies-DSun3xO-.cjs");
+const require_runnerPaths = require("../runnerPaths-B41rMOY6.cjs");
+const require_runnerRegistry = require("../runnerRegistry-dQYlMSpQ.cjs");
 let node_fs = require("node:fs");
 node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
 let node_path = require("node:path");
 node_path = require_rolldown_runtime.__toESM(node_path, 1);
 let _agimon_ai_po_core_childProcess = require("@agimon-ai/po-core/childProcess");
-let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
 let _agimon_ai_po_core_backgroundWork = require("@agimon-ai/po-core/backgroundWork");
 let _agimon_ai_po_telemetry = require("@agimon-ai/po-telemetry");
@@ -25,6 +27,10 @@ let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent")
 let hono = require("hono");
 let hono_streaming = require("hono/streaming");
 let _agimon_ai_po_core_help = require("@agimon-ai/po-core/help");
+const RUNNER_STATUS_KEY = "po-runner-runners";
+const BACKGROUND_WORK_PROVIDER = "po-runner";
+const HISTORY_SWEEP_INTERVAL_MS = 6e5;
+//#endregion
 //#region src/constants/runnerSettings.ts
 const RUNNER_SETTINGS_FILE = "po-runner.json";
 const RATIO_KEYS = ["headRatio", "errorBudgetRatio"];
@@ -32,10 +38,110 @@ const MAX_RESULT_BYTES_CEILING = 262144;
 const MAX_RESULT_LINES_CEILING = 5e3;
 const MAX_RESULT_TOKENS_CEILING = 1e5;
 //#endregion
-//#region src/constants/runnerRuntime.ts
-const RUNNER_STATUS_KEY = "doom-runner-runners";
-const BACKGROUND_WORK_PROVIDER = "doom-runner";
-const HISTORY_SWEEP_INTERVAL_MS = 6e5;
+//#region src/services/runnerHost/index.ts
+const describe = (error) => error instanceof Error ? error.message : String(error);
+/** Runs `pass` again `ms` after the previous pass finished, so two passes never overlap. */
+function repeat(clock, ms, pass) {
+	let stopped = false;
+	let cancel;
+	let running;
+	const arm = () => {
+		cancel = clock.after(ms, () => {
+			cancel = void 0;
+			running = pass().finally(() => {
+				running = void 0;
+				if (!stopped) arm();
+			});
+		});
+	};
+	arm();
+	return { async stop() {
+		stopped = true;
+		cancel?.();
+		await running;
+	} };
+}
+/**
+* The housekeeping every session running one po-runner build in one hub shares.
+*
+* A session used to open its own registry connection and arm its own status poll and history
+* sweep, and each sweep walked the whole runner store. Here one loop refreshes the attached sessions
+* one at a time, one sweep per store spares every attached session at once, and runners a crashed
+* server left behind are reclaimed once rather than at every session start.
+*/
+function createRunnerHost(options) {
+	const sessions = /* @__PURE__ */ new Set();
+	let closed = false;
+	let reclaiming;
+	let sweeping;
+	const refreshAll = async () => {
+		for (const session of sessions) {
+			if (closed) return;
+			try {
+				await session.refresh();
+			} catch (error) {
+				options.onWarning(`Could not refresh po-runner session ${session.sessionId}: ${describe(error)}`);
+			}
+		}
+	};
+	const sweepAll = () => {
+		sweeping ??= (async () => {
+			try {
+				const byStore = /* @__PURE__ */ new Map();
+				for (const session of sessions) {
+					const store = session.paths.storeDirectory();
+					byStore.set(store, [...byStore.get(store) ?? [], session]);
+				}
+				for (const group of byStore.values()) {
+					const [first] = group;
+					if (closed || first === void 0) return;
+					const live = new Set(group.map((session) => session.sessionId));
+					const now = options.clock.now();
+					const result = first.paths.sweepHistoryAsync ? await first.paths.sweepHistoryAsync(first.historyTtlMs, now, live) : first.paths.sweepHistory(first.historyTtlMs, now, live);
+					for (const error of result.errors) options.onWarning(error);
+				}
+			} catch (error) {
+				options.onWarning(`Could not sweep po-runner history: ${describe(error)}`);
+			}
+		})().finally(() => {
+			sweeping = void 0;
+		});
+		return sweeping;
+	};
+	const polling = repeat(options.clock, options.statusPollMs, refreshAll);
+	const sweeper = repeat(options.clock, options.historySweepMs, sweepAll);
+	return {
+		processRegistry: {
+			registerProcess: (...args) => options.processRegistry.registerProcess(...args),
+			releaseProcess: (...args) => options.processRegistry.releaseProcess(...args),
+			listProcesses: (...args) => options.processRegistry.listProcesses(...args),
+			close: () => void 0
+		},
+		attach(session) {
+			if (closed) throw new Error("The po-runner host is disposed.");
+			sessions.add(session);
+			if (reclaiming === void 0) {
+				reclaiming = session.reclaimOrphans().catch((error) => options.onWarning(`Could not reclaim orphaned runners: ${describe(error)}`));
+				sweepAll();
+			}
+			return () => {
+				sessions.delete(session);
+			};
+		},
+		async dispose() {
+			if (closed) return;
+			closed = true;
+			sessions.clear();
+			await Promise.all([
+				polling.stop(),
+				sweeper.stop(),
+				reclaiming,
+				sweeping
+			]);
+			options.processRegistry.close();
+		}
+	};
+}
 //#endregion
 //#region src/constants/webRunners.ts
 const RUNNER_RUNS_TYPE = "runner_runs";
@@ -91,9 +197,9 @@ function presentRunnerRuns(records, now) {
 //#endregion
 //#region src/services/runnerServerRuntime/index.ts
 const COMPLETION_RETRY_MS = 1e3;
-function createRunnerServerRuntime(container, directEvents, wakeAgent, execution) {
-	const telemetry = execution ? (0, _agimon_ai_po_telemetry.createDoomTelemetry)({
-		serviceName: "doom-runner",
+function createRunnerServerRuntime(container, host, directEvents, wakeAgent, execution) {
+	const telemetry = execution ? (0, _agimon_ai_po_telemetry.createPoTelemetry)({
+		serviceName: "po-runner",
 		packageName: "@agimon-ai/po-runner",
 		cwd: execution.cwd,
 		env: execution.environment,
@@ -112,41 +218,31 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 	let wakes = Promise.resolve();
 	let closing = false;
 	let retryTimer;
-	let statusTimer;
-	let historyTimer;
-	let historySweep;
-	const sweepHistory = () => {
-		if (closing) return Promise.resolve();
-		historySweep ??= (async () => {
-			const ttl = require_runnerConfig.getLogTtlMs(container.environment);
-			const result = container.paths.sweepHistoryAsync ? await container.paths.sweepHistoryAsync(ttl) : container.paths.sweepHistory(ttl);
-			for (const error of result.errors) process.emitWarning(error);
-		})().catch((error) => process.emitWarning(`Could not sweep doom-runner history: ${String(error)}`)).finally(() => {
-			historySweep = void 0;
+	/** Stops the shared loop refreshing this session and sweeping around it. */
+	let detach;
+	/** Every runner of every session the registry knows, reclaimed when its owning process is gone. */
+	const reclaimOrphans = async () => {
+		const reclaimed = await require_reconcile.reconcileActiveRunners({
+			registry: container.runnerRegistry,
+			launcher: container.launcher,
+			rmuxBackend: container.rmuxBackend,
+			processControl: container.processControl,
+			currentHostPid: process.pid,
+			startup: false
 		});
-		return historySweep;
+		for (const error of reclaimed.errors) process.emitWarning(error);
 	};
 	const ensureSession = (requestedSessionId) => {
 		if (closing) return Promise.reject(/* @__PURE__ */ new Error("Runner runtime is closing."));
 		if (sessionId !== void 0 && sessionId !== requestedSessionId) throw new Error(`Runner runtime belongs to session ${sessionId}.`);
 		sessionId ??= requestedSessionId;
 		supervision ??= (async () => {
-			await telemetry?.recordEvent("doom_runner.session_started", { outcome: "started" });
+			telemetry?.recordEvent("po_runner.session_started", { outcome: "started" }).catch((error) => process.emitWarning(`Could not record runner session telemetry: ${String(error)}`));
 			if (closing) return;
 			container.paths.setSessionId(requestedSessionId);
 			if (await container.lifeline.arm(requestedSessionId) === void 0) throw new Error("Could not arm runner supervision lifeline.");
 			if (closing) return;
 			const promotedIds = (await container.runnerRegistry.listAll(requestedSessionId)).filter((record) => record.state === "running" && record.promoted).map((record) => record.id);
-			const legacy = await require_reconcile.cleanupLegacyRunnerStore({
-				registry: container.runnerRegistry,
-				launcher: container.launcher,
-				rmuxBackend: container.rmuxBackend,
-				processControl: container.processControl,
-				currentHostPid: process.pid,
-				paths: container.paths
-			});
-			for (const error of legacy.errors) process.emitWarning(error);
-			if (closing) return;
 			const reconciled = await require_reconcile.reconcileActiveRunners({
 				registry: container.runnerRegistry,
 				launcher: container.launcher,
@@ -154,28 +250,26 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 				processControl: container.processControl,
 				currentHostPid: process.pid,
 				startup: true,
-				startupSessionId: requestedSessionId
+				startupSessionId: requestedSessionId,
+				active: await container.runnerRegistry.listBySession(requestedSessionId)
 			});
 			for (const error of reconciled.errors) process.emitWarning(error);
-			await telemetry?.recordEvent("doom_runner.reconciled", {
-				"runner.reclaimed_count": legacy.reclaimed.length + reconciled.reclaimed.length,
-				"runner.error_count": legacy.errors.length + reconciled.errors.length,
-				outcome: legacy.errors.length + reconciled.errors.length === 0 ? "completed" : "degraded"
-			});
+			telemetry?.recordEvent("po_runner.reconciled", {
+				"runner.reclaimed_count": reconciled.reclaimed.length,
+				"runner.error_count": reconciled.errors.length,
+				outcome: reconciled.errors.length === 0 ? "completed" : "degraded"
+			}).catch((error) => process.emitWarning(`Could not record runner reconcile telemetry: ${String(error)}`));
 			if (!closing) {
 				unsubscribeRunnerUpdates ??= container.runnerRegistry.subscribe(() => requestPublish(requestedSessionId), requestedSessionId);
 				for (const id of promotedIds) watchRunner(id);
 				requestPublish(requestedSessionId);
-				await sweepHistory();
-				if (closing) return;
-				statusTimer ??= setInterval(() => {
-					refreshSession(requestedSessionId);
-				}, 500);
-				statusTimer.unref?.();
-				historyTimer ??= setInterval(() => {
-					sweepHistory();
-				}, HISTORY_SWEEP_INTERVAL_MS);
-				historyTimer.unref?.();
+				detach ??= host.attach({
+					sessionId: requestedSessionId,
+					paths: container.paths,
+					historyTtlMs: require_runnerConfig.getLogTtlMs(container.environment),
+					refresh: () => refreshSession(requestedSessionId),
+					reclaimOrphans
+				});
 			}
 		})().catch((error) => {
 			supervision = void 0;
@@ -188,36 +282,36 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 			await supervision?.catch((error) => process.emitWarning(`Could not initialize headless runner supervision: ${String(error)}`));
 			const ownedSessionId = sessionId;
 			if (ownedSessionId === void 0) return;
-			const records = await container.runnerRegistry.listBySession(ownedSessionId).catch(() => []);
-			await Promise.all(records.map(async (record) => {
-				try {
-					if (!await require_reconcile.stopRunnerProcess(record, container.launcher, container.rmuxBackend, {
-						registry: container.runnerRegistry,
-						intent: {
+			await (0, _agimon_ai_po_core_extensionFile.runCleanups)([
+				async () => {
+					const records = await container.runnerRegistry.listBySession(ownedSessionId);
+					const errors = (await Promise.allSettled(records.map(async (record) => {
+						await require_reconcile.stopRunnerProcess(record, container.launcher, container.rmuxBackend, {
+							registry: container.runnerRegistry,
+							intent: {
+								reason: "stopped",
+								terminationReason: "parent_session_cleanup",
+								stopReason: "session ended"
+							}
+						});
+						const deadline = container.clock.now() + require_launcher.TERM_GRACE_MS;
+						while (container.processControl.isAlive(record.pid)) {
+							if (container.clock.now() >= deadline) throw new Error(`Could not stop runner ${record.id} during session shutdown`);
+							await new Promise((resolve) => container.clock.after(100, resolve));
+						}
+						await container.runnerRegistry.complete(record.id, {
 							reason: "stopped",
-							terminationReason: "parent_session_cleanup",
+							code: null,
+							signal: null,
 							stopReason: "session ended"
-						}
-					}) && container.processControl.isAlive(record.pid)) {
-						process.emitWarning(`Could not stop runner ${record.id} during session shutdown`);
-						return;
-					}
-					await container.runnerRegistry.complete(record.id, {
-						reason: "stopped",
-						code: null,
-						signal: null,
-						stopReason: "session ended"
-					}, ownedSessionId);
-				} catch (error) {
-					process.emitWarning(`Could not clean up runner ${record.id}: ${String(error)}`);
-				}
-			}));
-			try {
-				await container.ptyHost.disposeAll();
-			} finally {
-				container.lifeline.dispose();
-				container.runnerRegistry.close();
-			}
+						}, ownedSessionId);
+					}))).filter((result) => result.status === "rejected").map((result) => result.reason);
+					if (errors.length) throw new AggregateError(errors, "Runner process cleanup failed.");
+				},
+				() => container.ptyHost.disposeAll(),
+				() => container.lifeline.dispose(),
+				() => container.runnerRegistry.close()
+			], "Runner runtime cleanup failed.");
 		})();
 		return runtimeDisposal;
 	};
@@ -247,7 +341,7 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 				wakeForFinished(ownedSessionId);
 			}
 		} catch (error) {
-			process.emitWarning(`Could not refresh doom-runner: ${String(error)}`);
+			process.emitWarning(`Could not refresh po-runner: ${String(error)}`);
 		}
 	};
 	const publishRuns = async (ownedSessionId) => {
@@ -306,8 +400,8 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 					const record = await container.runnerRegistry.get(id, ownedSessionId);
 					if (closing) return;
 					if (record?.state === "running") continue;
-					if (record) await wakeAgent?.(require_runnerRegistry.formatRunnerFinished(record), `runner-finished:${JSON.stringify([ownedSessionId, id])}`);
-					if (record) await telemetry?.recordEvent("doom_runner.process_finished", {
+					if (record) await wakeAgent?.(require_runnerRegistry.formatRunnerFinished(record), `runner-finished:${JSON.stringify([ownedSessionId, id])}`, require_runnerRegistry.formatRunnerFinishedNotice(record));
+					if (record) await telemetry?.recordEvent("po_runner.process_finished", {
 						outcome: "completed",
 						"runner.exit_code": record.exit?.code ?? 0,
 						"runner.backend": record.backend
@@ -349,7 +443,7 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 		activity: {
 			name: "runner",
 			start: async (executionContext) => {
-				await ensureSession(executionContext.sessionId);
+				ensureSession(executionContext.sessionId).catch((error) => process.emitWarning(`Could not initialize headless runner supervision: ${String(error)}`));
 				requestPublish(executionContext.sessionId);
 				return () => {};
 			}
@@ -372,7 +466,7 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 			const text = require_compaction.activeRunnerRecovery(active);
 			if (!text) return;
 			await execution.session.appendMessage?.({
-				type: "doom-runner-compaction",
+				type: "po-runner-compaction",
 				text,
 				display: false,
 				details: {
@@ -383,8 +477,8 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 			if (!closing) recoveredCompactionId = event.entryId;
 		},
 		backgroundWorkPlugin: (context) => {
-			context.inject([_agimon_ai_po_core_backgroundWork.DOOM_BACKGROUND_WORK_SERVICE], (serviceContext) => {
-				const service = (0, _agimon_ai_po_core_backgroundWork.readDoomBackgroundWorkService)(serviceContext);
+			context.inject([_agimon_ai_po_core_backgroundWork.PO_BACKGROUND_WORK_SERVICE], (serviceContext) => {
+				const service = (0, _agimon_ai_po_core_backgroundWork.readPoBackgroundWorkService)(serviceContext);
 				if (!service) return void 0;
 				const registration = service.register({
 					provider: BACKGROUND_WORK_PROVIDER,
@@ -402,8 +496,8 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 			closing = true;
 			disposal = (async () => {
 				closing = true;
-				clearInterval(statusTimer);
-				clearInterval(historyTimer);
+				detach?.();
+				detach = void 0;
 				clearTimeout(retryTimer);
 				retryTimer = void 0;
 				watched.clear();
@@ -413,16 +507,17 @@ function createRunnerServerRuntime(container, directEvents, wakeAgent, execution
 				unsubscribeRunnerUpdates = void 0;
 				await wakes;
 				await publishInFlight;
-				await historySweep;
 				await refreshInFlight;
 				try {
 					execution?.client.setStatus(RUNNER_STATUS_KEY, void 0);
 				} catch (error) {
 					process.emitWarning(`Could not clear runner status: ${String(error)}`);
 				}
-				await disposeRuntime();
-				await telemetry?.recordEvent("doom_runner.session_finished", { outcome: "stopped" });
-				await telemetry?.shutdown();
+				await (0, _agimon_ai_po_core_extensionFile.runCleanups)([
+					disposeRuntime,
+					() => telemetry?.recordEvent("po_runner.session_finished", { outcome: "stopped" }),
+					() => telemetry?.shutdown()
+				], "Runner shutdown failed.");
 			})();
 			return disposal;
 		}
@@ -538,27 +633,41 @@ function validate(parsed) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/_lib/serverRoot.ts
-const RUNNER_SERVER_SCOPE_SERVICE = "doom/runner-server-scope";
-const createRunnerServerRoot = ({ host, agent, signal }) => {
-	if (!host.context.directEvents) throw new Error("Runner headless facet requires the session direct event bus.");
-	if (!host.context.cwd || !host.context.environment) throw new Error("Runner headless facet requires session cwd and environment.");
+const RUNNER_SERVER_SCOPE_SERVICE = "po/runner-server-scope";
+const createRunnerServerRoot = async ({ host, agent, signal, resources }) => {
+	if (!host.context.directEvents) throw new Error("Runner server plugin requires the session direct event bus.");
+	if (!host.context.cwd || !host.context.environment) throw new Error("Runner server plugin requires session cwd and environment.");
 	const loaded = new RunnerSettingsLoader().load(host.context.cwd, true);
 	const settings = Object.freeze({
 		...loaded.settings,
 		...loaded.settings.errorPatterns ? { errorPatterns: Object.freeze([...loaded.settings.errorPatterns]) } : {}
 	});
 	for (const issue of loaded.issues) process.emitWarning(`${RUNNER_SETTINGS_FILE}: ${issue}`);
+	const environment = host.context.environment;
+	const runnerHost = await resources.acquire(["runner-host", environment["PROCESS_REGISTRY_PATH"] ?? null], () => createRunnerHost({
+		processRegistry: require_runnerRegistry.createDefaultProcessRegistry(environment),
+		clock: new require_clock.SystemClock(),
+		statusPollMs: 500,
+		historySweepMs: HISTORY_SWEEP_INTERVAL_MS,
+		onWarning: (message) => process.emitWarning(message)
+	}), (shared) => shared.dispose());
 	const dependencies = require_runnerDependencies.createRunnerDependencies({
 		settings,
 		cwd: host.context.cwd,
-		environment: host.context.environment,
+		environment,
+		processRegistry: runnerHost.processRegistry,
 		...host.context.executionBudget === void 0 ? {} : { executionBudget: host.context.executionBudget }
 	});
 	const execution = agent?.context;
-	const wakeAgent = execution && (async (content, requestId) => {
+	const wakeAgent = execution && (async (content, requestId, notice) => {
 		try {
-			if (!execution.session.admitPrompt) throw new Error("The session cannot admit a runner notification.");
-			await execution.session.admitPrompt(content, "steer", void 0, requestId);
+			if (!execution.session.admitMessage) throw new Error("The session cannot admit a runner notification.");
+			await execution.session.admitMessage({
+				type: "po-runner-finished",
+				text: content,
+				display: true,
+				details: { notice }
+			}, "steer", requestId);
 		} catch (error) {
 			await Promise.resolve().then(() => execution.client.notify({
 				body: String(error),
@@ -567,7 +676,7 @@ const createRunnerServerRoot = ({ host, agent, signal }) => {
 			throw error;
 		}
 	});
-	const runtime = createRunnerServerRuntime(dependencies, host.context.directEvents, wakeAgent, execution);
+	const runtime = createRunnerServerRuntime(dependencies, runnerHost, host.context.directEvents, wakeAgent, execution);
 	const bash = (wakeOnExit) => require_headless.createHeadlessBashTool({ run: async (request) => {
 		await runtime.ensureSession(request.sessionId);
 		const result = await dependencies.bashRunService.run({
@@ -589,7 +698,9 @@ const createRunnerServerRoot = ({ host, agent, signal }) => {
 			context.plugin((providerContext) => providerContext.provide(RUNNER_SERVER_SCOPE_SERVICE, value));
 		}],
 		activities: [runtime.activity],
-		onStart: execution ? () => runtime.ensureSession(execution.sessionId) : void 0,
+		onStart: execution ? () => {
+			runtime.ensureSession(execution.sessionId).catch((error) => process.emitWarning(`Could not initialize headless runner supervision: ${String(error)}`));
+		} : void 0,
 		onStop: runtime.dispose
 	};
 };
@@ -1173,11 +1284,11 @@ var session_compact_server_default = (0, _agimon_ai_po_core_extensionFile.define
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-use-runner.server.ts
 var po_use_runner_server_default = (0, _agimon_ai_po_core_extensionFile.defineResource)({
 	name: "po-use-runner",
-	description: "Use Doom Pi Runner to supervise shell commands, inspect durable logs, provide interactive input, and stop background runs.",
-	when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+	description: "Use Po Pi Runner to supervise shell commands, inspect durable logs, provide interactive input, and stop background runs.",
+	when: _agimon_ai_po_core_help.PO_HELP_WHEN,
 	kind: "skill",
-	path: (0, _agimon_ai_po_core_serverFacet.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-runner/SKILL.md"),
-	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-runner/SKILL.md")
+	path: (0, _agimon_ai_po_core_serverPlugin.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-runner/SKILL.md"),
+	read: () => (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-runner/SKILL.md")
 });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/tool/bash.server.ts
@@ -1185,21 +1296,24 @@ var bash_server_default = (0, _agimon_ai_po_core_extensionFile.defineServerTool)
 //#endregion
 //#region generated/server.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;
+/* v8 ignore next -- generated normalization branch */
+const defined = (values) => values.filter((value) => value !== void 0);
 const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
 	...value
 };
-const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 	name: "@agimon-ai/po-runner",
-	providerOverrides: (0, _agimon_ai_po_core_serverFacet.composeServerProviderOverrides)(root_server_default),
+	providerOverrides: (0, _agimon_ai_po_core_serverPlugin.composeServerProviderOverrides)(root_server_default),
+	injects: (0, _agimon_ai_po_core_extensionFile.composeRootInjects)({ session: [root_server_default] }),
 	global: () => ({ get channels() {
 		return [() => via({ frameType: "runner_runs" }, runnerRuns_server_default())];
 	} }),
-	workspace: () => ({ get channels() {
-		return [() => via({ frameType: "runner_runs" }, runnerRuns_server_default())];
+	workspace: (context) => ({ get channels() {
+		return defined([context.hosted("global") ? void 0 : () => via({ frameType: "runner_runs" }, runnerRuns_server_default())]);
 	} }),
 	session: async (context) => {
-		const scopeSession = await root_server_default(context);
+		const scopeSession = await context.scopeRoot("session", root_server_default, context);
 		const contextSession = {
 			...context,
 			root: scopeSession.value
@@ -1210,7 +1324,7 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 				return [at(route_server_default, contextSession)];
 			},
 			get channels() {
-				return [() => via({ frameType: "runner_runs" }, runnerRuns_server_default())];
+				return defined([context.hosted("global") ? void 0 : () => via({ frameType: "runner_runs" }, runnerRuns_server_default())]);
 			},
 			get commands() {
 				return [via({ name: "runners" }, at(runners_server_default, contextSession))];
@@ -1232,7 +1346,7 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 	}
 });
 //#endregion
-exports.default = facet;
-exports.facet = facet;
+exports.default = serverPlugin;
+exports.serverPlugin = serverPlugin;
 
 //# sourceMappingURL=server.cjs.map