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

package/dist/extensions/server.cjs

@@ -24,56 +24,211 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-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 node_fs = require("node:fs");
-node_fs = __toESM(node_fs, 1);
+let _agimon_ai_po_core_childSession = require("@agimon-ai/po-core/childSession");
+let _agimon_ai_po_core_hubChannel = require("@agimon-ai/po-core/hubChannel");
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises, 1);
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
+let _agimon_ai_po_hashline = require("@agimon-ai/po-hashline");
+let _agimon_ai_po_hashline_files = require("@agimon-ai/po-hashline/files");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs, 1);
 let _agimon_ai_po_core_childProcess = require("@agimon-ai/po-core/childProcess");
 let _agimon_ai_po_telemetry = require("@agimon-ai/po-telemetry");
-let ignore = require("ignore");
-ignore = __toESM(ignore, 1);
-let node_child_process = require("node:child_process");
 let node_crypto = require("node:crypto");
 let _agimon_ai_po_core_piSettings = require("@agimon-ai/po-core/piSettings");
+let node_child_process = require("node:child_process");
 let node_util = require("node:util");
-let node_fs_promises = require("node:fs/promises");
-node_fs_promises = __toESM(node_fs_promises, 1);
+let ignore = require("ignore");
+ignore = __toESM(ignore, 1);
+let node_os = require("node:os");
+node_os = __toESM(node_os, 1);
+let _agimon_ai_po_config = require("@agimon-ai/po-config");
 let hono = require("hono");
-//#region src/services/doomIgnore/index.ts
-function matchablePath(relPath) {
-	const normalized = relPath.replace(/\\/gu, "/");
-	if (normalized.length === 0 || normalized.includes("\0") || normalized === ".." || normalized.startsWith("../") || normalized.startsWith("/") || /^[A-Za-z]:\//u.test(normalized)) return;
-	return normalized;
+//#region src/constants/editPresence.ts
+const PRESENCE_NOTE_TITLE = "[Po: other active agents edited files in this result]";
+const PRESENCE_NOTE_GUIDANCE = "Preserve unrelated edits. If coordination would help, you can use intercom to send to the session id, or ask the subagent by name if it is on your team. Contact is optional; this notice does not block editing.";
+//#endregion
+//#region src/services/editPresence/index.ts
+const PATH_TOOLS = /* @__PURE__ */ new Set([
+	"read",
+	"edit",
+	"write"
+]);
+const EDIT_TOOLS = /* @__PURE__ */ new Set(["edit", "write"]);
+const MAX_GREP_FILES = 50;
+const MAX_NOTE_LINES = 10;
+const MINUTE_MS = 6e4;
+const SHORT_ID_LENGTH = 8;
+/** Pi's built-in grep prints match rows as `relative/path:line: text`. */
+const PI_GREP_ROW = /^(.+?):(\d+): /u;
+function forgetPresence(ledger, agentKey) {
+	for (const [file, entries] of ledger) {
+		entries.delete(agentKey);
+		if (entries.size === 0) ledger.delete(file);
+	}
+}
+function stringArg(args, key) {
+	if (typeof args !== "object" || args === null) return void 0;
+	const value = args[key];
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function textOf(content) {
+	return content.map((part) => part.type === "text" && "text" in part && typeof part.text === "string" ? part.text : "").join("\n");
+}
+async function grepFiles(call) {
+	const lines = textOf(call.content).split("\n");
+	const headers = lines.flatMap((line) => {
+		const header = (0, _agimon_ai_po_hashline.parseFileHeader)(line);
+		return header === void 0 ? [] : [(0, _agimon_ai_po_hashline_files.resolveInputPath)(header.path, call.cwd)];
+	});
+	if (headers.length > 0) return [...new Set(headers)].slice(0, MAX_GREP_FILES);
+	const rows = lines.flatMap((line) => {
+		const match = PI_GREP_ROW.exec(line)?.[1];
+		return match === void 0 ? [] : [match];
+	});
+	if (rows.length === 0) return [];
+	const searchPath = (0, _agimon_ai_po_hashline_files.resolveInputPath)(stringArg(call.args, "path") ?? ".", call.cwd);
+	if ((await node_fs_promises.default.stat(searchPath).catch(() => void 0))?.isFile()) return [searchPath];
+	return [...new Set(rows.map((row) => node_path.default.resolve(searchPath, row)))].slice(0, MAX_GREP_FILES);
+}
+async function touchedFiles(call) {
+	if (PATH_TOOLS.has(call.toolName)) {
+		const input = stringArg(call.args, "path");
+		return input === void 0 ? [] : [await (0, _agimon_ai_po_hashline_files.resolveReadInputPath)(input, call.cwd)];
+	}
+	return call.toolName === "grep" ? grepFiles(call) : [];
+}
+function ago(elapsed) {
+	const minutes = Math.floor(elapsed / MINUTE_MS);
+	return minutes < 1 ? "under 1m ago" : `${minutes}m ago`;
+}
+function liveOthers(ledger, file, self) {
+	const entries = ledger.get(file);
+	if (entries === void 0) return [];
+	const live = [];
+	for (const [key, entry] of entries) {
+		if (key === self) continue;
+		if (entry.agent.isLive()) live.push(entry);
+		else entries.delete(key);
+	}
+	return live.sort((left, right) => right.at - left.at);
+}
+function record(ledger, file, agent, tag, at) {
+	const entries = ledger.get(file) ?? /* @__PURE__ */ new Map();
+	entries.set(agent.key, {
+		agent,
+		tag,
+		at
+	});
+	ledger.set(file, entries);
+}
+function renderNote(lines) {
+	const shown = lines.slice(0, MAX_NOTE_LINES);
+	const more = lines.length - shown.length;
+	return [
+		PRESENCE_NOTE_TITLE,
+		...shown,
+		...more > 0 ? [`- and ${more} more`] : [],
+		PRESENCE_NOTE_GUIDANCE
+	].join("\n");
 }
 /**
-* Builds the project's ignore test, or nothing when there are no rules.
-*
-* Shared because the same rules are needed twice: once when deciding what to
-* record, and once when deciding what to list. A caller that built its own
-* matcher would let the two drift apart.
-*
-* The test answers false for anything it cannot safely match, so a path that
-* escapes the project stays visible rather than being hidden by accident.
+* Notes live editors of the files a tool call touched, then records the caller's own successful edit.
+* Returns the content with one note appended, or undefined when there is nothing to add, so callers
+* never rewrite a result needlessly.
 */
-function createDoomIgnoreMatcher(content) {
-	try {
-		if (content.trim().length === 0) return void 0;
-		const matcher = (0, ignore.default)().add(content);
-		return (relPath) => {
-			const candidate = matchablePath(relPath);
-			return candidate !== void 0 && matcher.ignores(candidate);
-		};
-	} catch {
-		return;
+async function observePresence(ledger, agent, call, now = Date.now()) {
+	const recording = EDIT_TOOLS.has(call.toolName) && !call.isError;
+	if (!recording && ledger.size === 0) return void 0;
+	const lines = [];
+	for (const file of await touchedFiles(call)) {
+		const real = await node_fs_promises.default.realpath(file).catch(() => void 0);
+		if (real === void 0) continue;
+		const others = liveOthers(ledger, real, agent.key);
+		let bytes;
+		if (others.length > 0) {
+			bytes = await node_fs_promises.default.readFile(real).catch(() => void 0);
+			const current = bytes === void 0 ? void 0 : (0, _agimon_ai_po_hashline_files.computeFileTag)(bytes);
+			const shown = (0, _agimon_ai_po_hashline_files.displayPath)(file, call.cwd);
+			for (const entry of others) {
+				const state = entry.tag === current ? "unchanged" : "changed";
+				lines.push(`- ${shown}: ${entry.agent.label()}, ${ago(now - entry.at)}, file ${state} since their edit.`);
+			}
+		}
+		if (recording) {
+			bytes ??= await node_fs_promises.default.readFile(real).catch(() => void 0);
+			if (bytes !== void 0) record(ledger, real, agent, (0, _agimon_ai_po_hashline_files.computeFileTag)(bytes), now);
+		}
 	}
+	if (lines.length === 0) return void 0;
+	return [...call.content, {
+		type: "text",
+		text: renderNote(lines)
+	}];
 }
-/** Applies project-local gitignore rules while keeping unsafe candidates visible. */
-function filterDoomIgnoredFiles(items, content) {
-	const ignored = createDoomIgnoreMatcher(content);
-	if (ignored === void 0) return items;
-	return items.filter((item) => !ignored(item.relPath));
+/** Edit presence for one hub session and the in-process children it spawns. */
+function createSessionPresence(options) {
+	const { sessionId, ledger } = options;
+	const sessionAgent = {
+		key: `session:${sessionId}`,
+		label: () => `session ${sessionId}${options.workflowStep ? " (workflow step)" : ""}`,
+		contact: sessionId,
+		isLive: options.isLive
+	};
+	const safely = async (work) => {
+		try {
+			return await work();
+		} catch (error) {
+			options.onError?.(error);
+			return;
+		}
+	};
+	return {
+		toolResult: {
+			event: "tool_result",
+			async handle(event, execution) {
+				const toolName = event.toolName;
+				if (execution.sessionId !== sessionId || typeof toolName !== "string" || !Array.isArray(event.content)) return;
+				const content = event.content;
+				const next = await safely(() => observePresence(ledger, sessionAgent, {
+					toolName,
+					args: event.args,
+					content,
+					isError: event.isError === true,
+					cwd: execution.cwd
+				}));
+				return next === void 0 ? void 0 : { content: next };
+			}
+		},
+		childHooks: { bind(scope) {
+			const { runId, parentSessionId, agent } = scope.request;
+			const child = {
+				key: `run:${runId}`,
+				label: () => `${options.labelFor(runId) ?? `${agent} (run ${runId.slice(0, SHORT_ID_LENGTH)})`} (subagent of session ${parentSessionId})`,
+				contact: parentSessionId,
+				isLive: () => !scope.signal.aborted
+			};
+			return {
+				beforeTool: () => void 0,
+				async afterTool(event) {
+					const next = await safely(() => observePresence(ledger, child, {
+						toolName: event.toolName,
+						args: event.args,
+						content: event.content,
+						isError: event.isError,
+						cwd: scope.request.cwd || options.cwd
+					}));
+					return next === void 0 ? void 0 : { content: next };
+				},
+				dispose: async () => forgetPresence(ledger, child.key)
+			};
+		} },
+		dispose: () => forgetPresence(ledger, sessionAgent.key)
+	};
 }
 //#endregion
 //#region src/services/lineDiff/index.ts
@@ -523,7 +678,7 @@ var EditTracker = class {
 //#endregion
 //#region src/services/fileEditPaths/index.ts
 /** The directory this package owns, under whichever root holds agent state. */
-const STATE_DIRECTORY = "doom-file-edit";
+const STATE_DIRECTORY = "po-file-edit";
 function hash(value) {
 	return (0, node_crypto.createHash)("sha256").update(value).digest("hex").slice(0, 16);
 }
@@ -541,7 +696,7 @@ var FileEditPaths = class {
 	}
 	/**
 	* Where every session's state lives: the Pi agent directory, the same root
-	* every other Doom package writes to, and never inside the working tree.
+	* every other Po package writes to, and never inside the working tree.
 	*
 	* An earlier layout put this in the repository's git common directory. That
 	* is git's own storage: nothing in git's lifecycle prunes a directory we add
@@ -571,31 +726,6 @@ var FileEditPaths = class {
 	snapshotsPath(cwd, sessionKey) {
 		return `${this.timelinePath(cwd, sessionKey).replace(/\.jsonl$/u, "")}.blobs`;
 	}
-	legacyStateDirectory(cwd) {
-		const common = this.gitCommonDirectory(cwd);
-		return common === void 0 ? void 0 : node_path.default.join(common, STATE_DIRECTORY);
-	}
-	/** Only still read so the state an older build left behind can be cleared away. */
-	gitCommonDirectory(cwd) {
-		try {
-			return (0, node_child_process.execFileSync)("git", [
-				"rev-parse",
-				"--path-format=absolute",
-				"--git-common-dir"
-			], {
-				cwd,
-				encoding: "utf8",
-				stdio: [
-					"ignore",
-					"pipe",
-					"ignore"
-				]
-			}).trim() || void 0;
-		} catch (error) {
-			if (error instanceof Error) return void 0;
-			throw error;
-		}
-	}
 };
 //#endregion
 //#region src/services/gitStatus/index.ts
@@ -683,6 +813,41 @@ var NodeGitStatusAdapter = class {
 		}
 	}
 };
+//#endregion
+//#region src/services/poIgnore/index.ts
+function matchablePath(relPath) {
+	const normalized = relPath.replace(/\\/gu, "/");
+	if (normalized.length === 0 || normalized.includes("\0") || normalized === ".." || normalized.startsWith("../") || normalized.startsWith("/") || /^[A-Za-z]:\//u.test(normalized)) return;
+	return normalized;
+}
+/**
+* Builds the project's ignore test, or nothing when there are no rules.
+*
+* Shared because the same rules are needed twice: once when deciding what to
+* record, and once when deciding what to list. A caller that built its own
+* matcher would let the two drift apart.
+*
+* The test answers false for anything it cannot safely match, so a path that
+* escapes the project stays visible rather than being hidden by accident.
+*/
+function createPoIgnoreMatcher(content) {
+	try {
+		if (content.trim().length === 0) return void 0;
+		const matcher = (0, ignore.default)().add(content);
+		return (relPath) => {
+			const candidate = matchablePath(relPath);
+			return candidate !== void 0 && matcher.ignores(candidate);
+		};
+	} catch {
+		return;
+	}
+}
+/** Applies project-local gitignore rules while keeping unsafe candidates visible. */
+function filterPoIgnoredFiles(items, content) {
+	const ignored = createPoIgnoreMatcher(content);
+	if (ignored === void 0) return items;
+	return items.filter((item) => !ignored(item.relPath));
+}
 /** How much of a file is read before deciding it is binary. */
 const BINARY_SAMPLE_BYTES$1 = 8192;
 const MISSING_CODES = /* @__PURE__ */ new Set([
@@ -1112,7 +1277,7 @@ var NodeTreeManifestAdapter = class {
 /** The frame type the hub publishes and the web plugin claims; declared in the poWeb block too. */
 const filesChannelType = "file_edits";
 /** Footer status key whose presence shows the activity group; the extension publishes it. */
-const filesStatusKey = "doom-file-edit-files";
+const filesStatusKey = "po-file-edit-files";
 //#endregion
 //#region src/types/apiRoutes.ts
 /**
@@ -1399,6 +1564,13 @@ function createFileEditsApi(options = {}) {
 		const root = node_path.default.resolve(cwd);
 		return isInside(root, filePath) && await isRealPathInside(root, filePath);
 	};
+	/** The Po-owned folder holding the file, checked the same two ways as the working directory. */
+	const readableRootOf = async (filePath) => {
+		for (const root of options.readableRoots?.() ?? []) {
+			const resolved = node_path.default.resolve(root);
+			if (isInside(resolved, filePath) && await isRealPathInside(resolved, filePath)) return resolved;
+		}
+	};
 	app.get(routes.detail.path, async (context) => {
 		const requested = context.req.query(PATH_QUERY_PARAM);
 		const versions = await recordedVersions(requested);
@@ -1431,10 +1603,11 @@ function createFileEditsApi(options = {}) {
 		if (cwd === "") return context.json({ error: "This session has no working directory to read from." }, 403);
 		const root = node_path.default.resolve(cwd);
 		const filePath = node_path.default.resolve(root, requested);
-		if (!await isInsideSession(filePath)) return context.json({ error: "The path leaves the session directory." }, 403);
+		const inSession = await isInsideSession(filePath);
+		if (!inSession && await readableRootOf(filePath) === void 0) return context.json({ error: "The path leaves the session directory." }, 403);
 		const body = {
 			path: filePath,
-			relPath: node_path.default.relative(root, filePath),
+			relPath: inSession ? node_path.default.relative(root, filePath) : filePath,
 			working: await readWorking(filePath)
 		};
 		return context.json(body);
@@ -1478,10 +1651,15 @@ function createFileEditsApi(options = {}) {
 const api = {
 	basePath: API_BASE_PATH,
 	start(context) {
+		const environment = context.environment ?? process.env;
+		const cwd = context.cwd;
 		const app = createFileEditsApi({
 			paths: new FileEditPaths(context.environment),
 			...context.sessionId === void 0 ? {} : { sessionId: context.sessionId },
-			...context.cwd === void 0 ? {} : { cwd: context.cwd }
+			...cwd === void 0 ? {} : {
+				cwd,
+				readableRoots: () => plansRoots(cwd, environment)
+			}
 		});
 		return {
 			fetch: (request) => app.fetch(request),
@@ -1489,6 +1667,20 @@ const api = {
 		};
 	}
 };
+/**
+* The plans directory Plan mode writes to, resolved the way Plan resolves it, so
+* a plan link in the transcript opens in the file view. A config that cannot be
+* read admits nothing extra rather than failing the preview.
+*/
+function plansRoots(cwd, environment) {
+	const home = environment.HOME ?? node_os.default.homedir();
+	try {
+		const configured = (0, _agimon_ai_po_config.loadPoConfig)(cwd, home, environment).modes?.planning?.plansDirectory;
+		return [(0, _agimon_ai_po_config.resolvePlanningPlansDirectory)(configured, cwd, home)];
+	} catch {
+		return [];
+	}
+}
 //#endregion
 //#region src/services/sessionStateSweep/index.ts
 /**
@@ -1572,8 +1764,9 @@ async function sweepSessionState(options) {
 //#endregion
 //#region src/services/webFilesChannel/index.ts
 /**
-* The changed-files channel consumes snapshots emitted by the owning session
-* facet. Durable timeline reads seed a channel that starts after session startup.
+* The changed-files channel consumes snapshots emitted by the owning session's
+* server plugin. Durable timeline reads seed a channel that starts after session
+* startup.
 */
 /** Whether the file is still there to be opened. */
 function stillExists(filePath) {
@@ -1610,7 +1803,7 @@ function readSessionFiles(timelinePath, cwd) {
 		diffable: isDiffable(foldVersions(events, entry.path))
 	}));
 	try {
-		return filterDoomIgnoredFiles(items, node_fs.default.readFileSync(node_path.default.join(cwd, ".poignore"), "utf8"));
+		return filterPoIgnoredFiles(items, node_fs.default.readFileSync(node_path.default.join(cwd, ".poignore"), "utf8"));
 	} catch {
 		return items;
 	}
@@ -1666,10 +1859,10 @@ function createFilesChannel() {
 }
 //#endregion
 //#region src/services/fileEditSession/index.ts
-const DOOM_IGNORE_FILE = ".poignore";
-function readDoomIgnore(cwd) {
+const PO_IGNORE_FILE = ".poignore";
+function readPoIgnore(cwd) {
 	try {
-		const matcher = createDoomIgnoreMatcher(node_fs.default.readFileSync(node_path.default.join(cwd, DOOM_IGNORE_FILE), "utf8"));
+		const matcher = createPoIgnoreMatcher(node_fs.default.readFileSync(node_path.default.join(cwd, PO_IGNORE_FILE), "utf8"));
 		return matcher === void 0 ? void 0 : (filePath) => matcher(node_path.default.relative(cwd, filePath));
 	} catch {
 		return;
@@ -1686,10 +1879,10 @@ function createFileEditSession({ agent, host }) {
 	const timeline = new TimelineStore();
 	const snapshots = new NodeSnapshotStoreAdapter();
 	const editTracker = new EditTracker(timeline, snapshots, new NodeTreeManifestAdapter(), { git: new NodeGitStatusAdapter() });
-	if (host.context.directEvents === void 0) throw new Error("File-edit headless facet requires the session direct event bus.");
+	if (host.context.directEvents === void 0) throw new Error("File-edit server plugin requires the session direct event bus.");
 	const directEvents = host.context.directEvents;
-	const telemetry = (0, _agimon_ai_po_telemetry.createDoomTelemetry)({
-		serviceName: "doom-file-edit",
+	const telemetry = (0, _agimon_ai_po_telemetry.createPoTelemetry)({
+		serviceName: "po-file-edit",
 		packageName: "@agimon-ai/po-file-edit",
 		env: environment,
 		enableLogs: true,
@@ -1712,7 +1905,7 @@ function createFileEditSession({ agent, host }) {
 	/**
 	* The channel carries the rows; the status decides whether the group exists.
 	*
-	* A cockpit drives this facet and never the Pi runtime, so without the status
+	* A cockpit drives this server plugin and never the Pi runtime, so without the status
 	* the dock had the file list on the wire and no frame to draw it in. The empty
 	* string is deliberate: the group declares `hideWhenEmpty`, so a session that
 	* has edited nothing publishes a key with no content and stays hidden.
@@ -1738,20 +1931,19 @@ function createFileEditSession({ agent, host }) {
 	const dispose = () => {
 		if (disposal) return disposal;
 		closed = true;
-		disposal = (async () => {
-			try {
-				await stopActivity();
-				if (lastRuntime) {
-					if (!environment[_agimon_ai_po_core_childProcess.SUBAGENT_CHILD_ENV]) {
-						await timeline.clear();
-						await snapshots.clear();
-					}
-					await telemetry.recordEvent("doom_file_edit.timeline_finished", { outcome: "closed" });
-				}
-			} finally {
-				await telemetry.shutdown();
-			}
-		})();
+		disposal = (0, _agimon_ai_po_core_extensionFile.runCleanups)([
+			stopActivity,
+			async () => {
+				if (lastRuntime && !environment[_agimon_ai_po_core_childProcess.SUBAGENT_CHILD_ENV]) await timeline.clear();
+			},
+			async () => {
+				if (lastRuntime && !environment[_agimon_ai_po_core_childProcess.SUBAGENT_CHILD_ENV]) await snapshots.clear();
+			},
+			async () => {
+				if (lastRuntime) await telemetry.recordEvent("po_file_edit.timeline_finished", { outcome: "closed" });
+			},
+			() => telemetry.shutdown()
+		], "File-edit session cleanup failed.");
 		return disposal;
 	};
 	return {
@@ -1769,7 +1961,7 @@ function createFileEditSession({ agent, host }) {
 				const snapshotsPath = paths.snapshotsPath(executionContext.cwd, sessionKey);
 				timeline.initialize(timelinePath);
 				snapshots.initialize(snapshotsPath);
-				const isIgnored = readDoomIgnore(executionContext.cwd);
+				const isIgnored = readPoIgnore(executionContext.cwd);
 				editTracker.reset({
 					exclude: [
 						timelinePath,
@@ -1792,16 +1984,11 @@ function createFileEditSession({ agent, host }) {
 							directory: paths.stateDirectory(),
 							keep: timelinePath
 						});
-						const legacy = paths.legacyStateDirectory(executionContext.cwd);
-						if (legacy !== void 0 && legacy !== paths.stateDirectory()) await sweepSessionState({
-							directory: legacy,
-							removeDirectory: true
-						});
 					} catch {}
 				});
 				if (!initialized) {
 					initialized = true;
-					await track(() => telemetry.recordEvent("doom_file_edit.timeline_started", { outcome: "initialized" }));
+					await track(() => telemetry.recordEvent("po_file_edit.timeline_started", { outcome: "initialized" }));
 				}
 				return () => active === runtime ? stopActivity() : Promise.resolve();
 			}
@@ -1818,7 +2005,7 @@ function createFileEditSession({ agent, host }) {
 					const hookStartedAt = Date.now();
 					await editTracker.start(toolCallId, toolName, event.args, executionContext.cwd);
 					if (active !== runtime) return;
-					await telemetry.recordEvent("doom_file_edit.edit_started", {
+					await telemetry.recordEvent("po_file_edit.edit_started", {
 						"tool.name": toolName,
 						hook_ms: Date.now() - hookStartedAt
 					});
@@ -1839,7 +2026,7 @@ function createFileEditSession({ agent, host }) {
 					await editTracker.end(toolCallId, isError, executionContext.cwd);
 					if (active !== runtime) return;
 					publish(runtime);
-					await telemetry.recordEvent("doom_file_edit.edit_finished", {
+					await telemetry.recordEvent("po_file_edit.edit_finished", {
 						"tool.name": toolName,
 						"tool.result.error": isError,
 						...startedAt === void 0 ? {} : { duration_ms: Date.now() - startedAt },
@@ -1854,12 +2041,38 @@ function createFileEditSession({ agent, host }) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/_lib/serverRoot.ts
+function createPresence({ agent, host, context }) {
+	const ledger = host.context.editPresence;
+	if (!agent || !ledger) return void 0;
+	const execution = agent.context;
+	return createSessionPresence({
+		ledger,
+		sessionId: execution.sessionId,
+		cwd: execution.cwd,
+		workflowStep: execution.sessionContext?.provenance === _agimon_ai_po_core_hubChannel.WORKFLOW_STEP_SESSION_PROVENANCE,
+		isLive: () => host.context.sessionService?.isLive(execution.sessionId) ?? true,
+		labelFor: (runId) => (0, _agimon_ai_po_core_childSession.readPoChildSessionLabels)(context)?.labelFor(runId),
+		onError: (error) => host.context.onNotice(`Edit presence failed: ${error instanceof Error ? error.message : String(error)}`)
+	});
+}
 const createFileEditServerRoot = (context) => {
 	const runtime = createFileEditSession(context);
+	const presence = createPresence(context);
 	return {
-		value: runtime,
+		value: {
+			...runtime,
+			...presence === void 0 ? {} : { presence }
+		},
 		activities: runtime.activities,
-		onDispose: runtime.onDispose
+		...presence === void 0 ? {} : { services: [(cordis) => {
+			cordis.inject([_agimon_ai_po_core_childSession.PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE], (registryContext) => {
+				const registration = registryContext.get(_agimon_ai_po_core_childSession.PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE).register(presence.childHooks);
+				return () => registration.dispose();
+			});
+		}] },
+		onDispose: async (pluginContext) => {
+			await (0, _agimon_ai_po_core_extensionFile.runCleanups)([() => presence?.dispose(), () => runtime.onDispose?.(pluginContext)], "File-edit root cleanup failed.");
+		}
 	};
 };
 //#endregion
@@ -1888,23 +2101,32 @@ var tool_execution_end_server_default = (0, _agimon_ai_po_core_extensionFile.def
 //#region src/extensions/workspaces/sessions/(backend)/hook/tool-execution-start.server.ts
 var tool_execution_start_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)((context) => context.root.hooks[0]);
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/tool-result.server.ts
+var tool_result_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)(({ root }) => ({
+	event: "tool_result",
+	handle: async (event, execution) => root.presence?.toolResult.handle(event, execution)
+}));
+//#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-file-edit",
-	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: "file_edits" }, fileEdits_server_default())];
 	} }),
-	workspace: () => ({ get channels() {
-		return [() => via({ frameType: "file_edits" }, fileEdits_server_default())];
+	workspace: (context) => ({ get channels() {
+		return defined([context.hosted("global") ? void 0 : () => via({ frameType: "file_edits" }, fileEdits_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
@@ -1915,10 +2137,14 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 				return [at(route_server_default, contextSession)];
 			},
 			get channels() {
-				return [() => via({ frameType: "file_edits" }, fileEdits_server_default())];
+				return defined([context.hosted("global") ? void 0 : () => via({ frameType: "file_edits" }, fileEdits_server_default())]);
 			},
 			get hooks() {
-				return [via({ event: "tool_execution_end" }, at(tool_execution_end_server_default, contextSession)), via({ event: "tool_execution_start" }, at(tool_execution_start_server_default, contextSession))];
+				return [
+					via({ event: "tool_execution_end" }, at(tool_execution_end_server_default, contextSession)),
+					via({ event: "tool_execution_start" }, at(tool_execution_start_server_default, contextSession)),
+					via({ event: "tool_result" }, at(tool_result_server_default, contextSession))
+				];
 			},
 			services: [...scopeSession.services ?? []],
 			get activities() {
@@ -1928,7 +2154,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