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

package/dist/extensions/server.mjs

@@ -1,49 +1,203 @@
-import { composeServerProviderOverrides, defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
-import { composeRootHooks, defineChannel, defineHook, defineRoot, defineRoute } from "@agimon-ai/po-core/extensionFile";
-import fs from "node:fs";
+import { composeServerProviderOverrides, defineServerPlugin } from "@agimon-ai/po-core/serverPlugin";
+import { composeRootHooks, composeRootInjects, defineChannel, defineHook, defineRoot, defineRoute, runCleanups } from "@agimon-ai/po-core/extensionFile";
+import { PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE, readPoChildSessionLabels } from "@agimon-ai/po-core/childSession";
+import { WORKFLOW_STEP_SESSION_PROVENANCE } from "@agimon-ai/po-core/hubChannel";
+import fs from "node:fs/promises";
 import path from "node:path";
+import { parseFileHeader } from "@agimon-ai/po-hashline";
+import { computeFileTag, displayPath, resolveInputPath, resolveReadInputPath } from "@agimon-ai/po-hashline/files";
+import fs$1 from "node:fs";
 import { SUBAGENT_CHILD_ENV, SUBAGENT_PARENT_SESSION_ENV } from "@agimon-ai/po-core/childProcess";
-import { createDoomTelemetry } from "@agimon-ai/po-telemetry";
-import ignore from "ignore";
-import { execFile, execFileSync } from "node:child_process";
+import { createPoTelemetry } from "@agimon-ai/po-telemetry";
 import { createHash } from "node:crypto";
 import { piAgentDirectory } from "@agimon-ai/po-core/piSettings";
+import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import fs$1 from "node:fs/promises";
+import ignore from "ignore";
+import os from "node:os";
+import { loadPoConfig, resolvePlanningPlansDirectory } from "@agimon-ai/po-config";
 import { Hono } from "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 = parseFileHeader(line);
+		return header === void 0 ? [] : [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 = resolveInputPath(stringArg(call.args, "path") ?? ".", call.cwd);
+	if ((await fs.stat(searchPath).catch(() => void 0))?.isFile()) return [searchPath];
+	return [...new Set(rows.map((row) => path.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 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 = ignore().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 fs.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 fs.readFile(real).catch(() => void 0);
+			const current = bytes === void 0 ? void 0 : computeFileTag(bytes);
+			const shown = 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 fs.readFile(real).catch(() => void 0);
+			if (bytes !== void 0) record(ledger, real, agent, 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
@@ -493,7 +647,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 createHash("sha256").update(value).digest("hex").slice(0, 16);
 }
@@ -511,7 +665,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
@@ -531,8 +685,8 @@ var FileEditPaths = class {
 	*/
 	timelinePath(cwd, sessionKey) {
 		const directory = this.stateDirectory();
-		fs.mkdirSync(directory, { recursive: true });
-		return path.join(directory, `${hash(fs.realpathSync(cwd))}-${hash(sessionKey)}.jsonl`);
+		fs$1.mkdirSync(directory, { recursive: true });
+		return path.join(directory, `${hash(fs$1.realpathSync(cwd))}-${hash(sessionKey)}.jsonl`);
 	}
 	/**
 	* Where this session's content snapshots live: beside its timeline and named
@@ -541,31 +695,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 : path.join(common, STATE_DIRECTORY);
-	}
-	/** Only still read so the state an older build left behind can be cleared away. */
-	gitCommonDirectory(cwd) {
-		try {
-			return 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
@@ -653,6 +782,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 = ignore().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([
@@ -672,7 +836,7 @@ var NodeSnapshotStoreAdapter = class {
 	async capture(filePath) {
 		let raw;
 		try {
-			raw = await fs$1.readFile(filePath);
+			raw = await fs.readFile(filePath);
 		} catch (error) {
 			if (hasCode$2(error, MISSING_CODES)) return void 0;
 			throw error;
@@ -685,19 +849,19 @@ var NodeSnapshotStoreAdapter = class {
 		const hash = createHash("sha256").update(content, "utf8").digest("hex");
 		const blobPath = path.join(this.requireDirectory(), hash);
 		try {
-			await fs$1.access(blobPath);
+			await fs.access(blobPath);
 			return hash;
 		} catch (error) {
 			if (!hasCode$2(error, MISSING_CODES)) throw error;
 		}
-		await fs$1.mkdir(this.requireDirectory(), { recursive: true });
-		await fs$1.writeFile(blobPath, content, "utf8");
+		await fs.mkdir(this.requireDirectory(), { recursive: true });
+		await fs.writeFile(blobPath, content, "utf8");
 		return hash;
 	}
 	async read(hash) {
 		if (!/^[0-9a-f]{64}$/u.test(hash)) return void 0;
 		try {
-			return await fs$1.readFile(path.join(this.requireDirectory(), hash), "utf8");
+			return await fs.readFile(path.join(this.requireDirectory(), hash), "utf8");
 		} catch (error) {
 			if (hasCode$2(error, MISSING_CODES)) return void 0;
 			throw error;
@@ -705,7 +869,7 @@ var NodeSnapshotStoreAdapter = class {
 	}
 	async clear() {
 		if (this.directory === void 0) return;
-		await fs$1.rm(this.directory, {
+		await fs.rm(this.directory, {
 			recursive: true,
 			force: true
 		});
@@ -869,7 +1033,7 @@ var TimelineStore = class {
 		this.filePath = filePath;
 	}
 	async append(event) {
-		await this.withLock(async () => fs$1.appendFile(this.requirePath(), `${JSON.stringify(event)}\n`, "utf8"));
+		await this.withLock(async () => fs.appendFile(this.requirePath(), `${JSON.stringify(event)}\n`, "utf8"));
 	}
 	async list() {
 		return foldEntries(confirmedChanges(await this.events()));
@@ -879,7 +1043,7 @@ var TimelineStore = class {
 	}
 	async clear() {
 		try {
-			await fs$1.unlink(this.requirePath());
+			await fs.unlink(this.requirePath());
 		} catch (error) {
 			if (!hasCode$1(error, "ENOENT")) throw error;
 		}
@@ -888,7 +1052,7 @@ var TimelineStore = class {
 	async events() {
 		let content;
 		try {
-			content = await fs$1.readFile(this.requirePath(), "utf8");
+			content = await fs.readFile(this.requirePath(), "utf8");
 		} catch (error) {
 			if (hasCode$1(error, "ENOENT")) return [];
 			throw error;
@@ -912,7 +1076,7 @@ var TimelineStore = class {
 	/** Waits for the lock file, breaking one an earlier process left behind. */
 	async acquire(lockPath) {
 		for (let attempt = 0; attempt < LOCK_RETRIES; attempt += 1) try {
-			return await fs$1.open(lockPath, "wx");
+			return await fs.open(lockPath, "wx");
 		} catch (error) {
 			if (!hasCode$1(error, "EEXIST")) throw error;
 			if (await this.breakStale(lockPath)) continue;
@@ -923,9 +1087,9 @@ var TimelineStore = class {
 	/** Whether the lock is now free to take, having removed it when its holder is gone. */
 	async breakStale(lockPath) {
 		try {
-			const stats = await fs$1.stat(lockPath);
+			const stats = await fs.stat(lockPath);
 			if (Date.now() - stats.mtimeMs < LOCK_STALE_MS) return false;
-			await fs$1.unlink(lockPath);
+			await fs.unlink(lockPath);
 			return true;
 		} catch (error) {
 			if (hasCode$1(error, "ENOENT")) return true;
@@ -934,7 +1098,7 @@ var TimelineStore = class {
 	}
 	async release(lockPath) {
 		try {
-			await fs$1.unlink(lockPath);
+			await fs.unlink(lockPath);
 		} catch (error) {
 			if (!hasCode$1(error, "ENOENT")) console.warn(`Could not remove timeline lock: ${String(error)}`);
 		}
@@ -1024,7 +1188,7 @@ var NodeTreeManifestAdapter = class {
 	}
 	async fingerprint(filePath) {
 		try {
-			const stat = await fs$1.stat(filePath);
+			const stat = await fs.stat(filePath);
 			return stat.isFile() ? fingerprintOf(stat.size, stat.mtimeMs) : void 0;
 		} catch {
 			return;
@@ -1032,7 +1196,7 @@ var NodeTreeManifestAdapter = class {
 	}
 	async modifiedAt(filePath) {
 		try {
-			const stat = await fs$1.stat(filePath);
+			const stat = await fs.stat(filePath);
 			return stat.isFile() ? stat.mtimeMs : void 0;
 		} catch {
 			return;
@@ -1053,7 +1217,7 @@ var NodeTreeManifestAdapter = class {
 		if (depth > this.maxDepth) return true;
 		let listing;
 		try {
-			listing = await fs$1.readdir(directory, { withFileTypes: true });
+			listing = await fs.readdir(directory, { withFileTypes: true });
 		} catch {
 			return false;
 		}
@@ -1070,7 +1234,7 @@ var NodeTreeManifestAdapter = class {
 			}
 			if (!entry.isFile()) continue;
 			try {
-				const stat = await fs$1.stat(entryPath);
+				const stat = await fs.stat(entryPath);
 				entries.set(entryPath, fingerprintOf(stat.size, stat.mtimeMs));
 			} catch {}
 		}
@@ -1082,7 +1246,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
 /**
@@ -1201,7 +1365,7 @@ function describe(error) {
 async function readWorking(filePath) {
 	let raw;
 	try {
-		raw = await fs$1.readFile(filePath);
+		raw = await fs.readFile(filePath);
 	} catch {
 		return {
 			content: "",
@@ -1241,8 +1405,8 @@ async function isRealPathInside(root, candidate) {
 	let realRoot;
 	let real;
 	try {
-		realRoot = await fs$1.realpath(root);
-		real = await fs$1.realpath(candidate);
+		realRoot = await fs.realpath(root);
+		real = await fs.realpath(candidate);
 	} catch (error) {
 		return hasCode(error, "ENOENT");
 	}
@@ -1369,6 +1533,13 @@ function createFileEditsApi(options = {}) {
 		const root = path.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 = path.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);
@@ -1401,10 +1572,11 @@ function createFileEditsApi(options = {}) {
 		if (cwd === "") return context.json({ error: "This session has no working directory to read from." }, 403);
 		const root = path.resolve(cwd);
 		const filePath = path.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: path.relative(root, filePath),
+			relPath: inSession ? path.relative(root, filePath) : filePath,
 			working: await readWorking(filePath)
 		};
 		return context.json(body);
@@ -1426,7 +1598,7 @@ function createFileEditsApi(options = {}) {
 			error: "The file changed since it was opened.",
 			hash: current.hash
 		}, 409);
-		await fs$1.writeFile(filePath, request.content, "utf8");
+		await fs.writeFile(filePath, request.content, "utf8");
 		const body = { hash: hashOf(request.content) };
 		return context.json(body);
 	});
@@ -1436,7 +1608,7 @@ function createFileEditsApi(options = {}) {
 		const filePath = path.resolve(cwd, requested);
 		if (!await isInsideSession(filePath)) return context.json({ error: "Files outside the session directory are read-only." }, 403);
 		try {
-			await fs$1.unlink(filePath);
+			await fs.unlink(filePath);
 		} catch (error) {
 			if (!hasCode(error, "ENOENT")) return context.json({ error: `The file could not be deleted: ${describe(error)}` }, 409);
 		}
@@ -1448,10 +1620,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),
@@ -1459,6 +1636,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 ?? os.homedir();
+	try {
+		const configured = loadPoConfig(cwd, home, environment).modes?.planning?.plansDirectory;
+		return [resolvePlanningPlansDirectory(configured, cwd, home)];
+	} catch {
+		return [];
+	}
+}
 //#endregion
 //#region src/services/sessionStateSweep/index.ts
 /**
@@ -1484,7 +1675,7 @@ const STATE_MAX_AGE_MS = 6048e5;
 const TIMELINE_SUFFIX = ".jsonl";
 const SNAPSHOTS_SUFFIX = ".blobs";
 async function remove(target) {
-	await fs$1.rm(target, {
+	await fs.rm(target, {
 		recursive: true,
 		force: true
 	});
@@ -1493,7 +1684,7 @@ async function remove(target) {
 async function lastTouched(paths) {
 	let newest;
 	for (const target of paths) try {
-		const stat = await fs$1.stat(target);
+		const stat = await fs.stat(target);
 		if (newest === void 0 || stat.mtimeMs > newest) newest = stat.mtimeMs;
 	} catch {}
 	return newest;
@@ -1503,7 +1694,7 @@ async function sweepSessionState(options) {
 	const { directory, keep, removeDirectory = false, now = Date.now(), maxAgeMs = STATE_MAX_AGE_MS } = options;
 	let entries;
 	try {
-		entries = await fs$1.readdir(directory);
+		entries = await fs.readdir(directory);
 	} catch {
 		return 0;
 	}
@@ -1535,20 +1726,21 @@ async function sweepSessionState(options) {
 		await remove(orphan);
 	}
 	if (removeDirectory) try {
-		await fs$1.rmdir(directory);
+		await fs.rmdir(directory);
 	} catch {}
 	return removed;
 }
 //#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) {
 	try {
-		return fs.statSync(filePath).isFile();
+		return fs$1.statSync(filePath).isFile();
 	} catch {
 		return false;
 	}
@@ -1566,7 +1758,7 @@ function stillExists(filePath) {
 function readSessionFiles(timelinePath, cwd) {
 	let content;
 	try {
-		content = fs.readFileSync(timelinePath, "utf8");
+		content = fs$1.readFileSync(timelinePath, "utf8");
 	} catch {
 		return [];
 	}
@@ -1580,7 +1772,7 @@ function readSessionFiles(timelinePath, cwd) {
 		diffable: isDiffable(foldVersions(events, entry.path))
 	}));
 	try {
-		return filterDoomIgnoredFiles(items, fs.readFileSync(path.join(cwd, ".poignore"), "utf8"));
+		return filterPoIgnoredFiles(items, fs$1.readFileSync(path.join(cwd, ".poignore"), "utf8"));
 	} catch {
 		return items;
 	}
@@ -1636,10 +1828,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(fs.readFileSync(path.join(cwd, DOOM_IGNORE_FILE), "utf8"));
+		const matcher = createPoIgnoreMatcher(fs$1.readFileSync(path.join(cwd, PO_IGNORE_FILE), "utf8"));
 		return matcher === void 0 ? void 0 : (filePath) => matcher(path.relative(cwd, filePath));
 	} catch {
 		return;
@@ -1656,10 +1848,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 = createDoomTelemetry({
-		serviceName: "doom-file-edit",
+	const telemetry = createPoTelemetry({
+		serviceName: "po-file-edit",
 		packageName: "@agimon-ai/po-file-edit",
 		env: environment,
 		enableLogs: true,
@@ -1682,7 +1874,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.
@@ -1708,20 +1900,19 @@ function createFileEditSession({ agent, host }) {
 	const dispose = () => {
 		if (disposal) return disposal;
 		closed = true;
-		disposal = (async () => {
-			try {
-				await stopActivity();
-				if (lastRuntime) {
-					if (!environment[SUBAGENT_CHILD_ENV]) {
-						await timeline.clear();
-						await snapshots.clear();
-					}
-					await telemetry.recordEvent("doom_file_edit.timeline_finished", { outcome: "closed" });
-				}
-			} finally {
-				await telemetry.shutdown();
-			}
-		})();
+		disposal = runCleanups([
+			stopActivity,
+			async () => {
+				if (lastRuntime && !environment[SUBAGENT_CHILD_ENV]) await timeline.clear();
+			},
+			async () => {
+				if (lastRuntime && !environment[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 {
@@ -1739,7 +1930,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,
@@ -1762,16 +1953,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();
 			}
@@ -1788,7 +1974,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
 					});
@@ -1809,7 +1995,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 },
@@ -1824,12 +2010,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 === WORKFLOW_STEP_SESSION_PROVENANCE,
+		isLive: () => host.context.sessionService?.isLive(execution.sessionId) ?? true,
+		labelFor: (runId) => 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([PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE], (registryContext) => {
+				const registration = registryContext.get(PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE).register(presence.childHooks);
+				return () => registration.dispose();
+			});
+		}] },
+		onDispose: async (pluginContext) => {
+			await runCleanups([() => presence?.dispose(), () => runtime.onDispose?.(pluginContext)], "File-edit root cleanup failed.");
+		}
 	};
 };
 //#endregion
@@ -1858,23 +2070,32 @@ var tool_execution_end_server_default = defineHook((context) => context.root.hoo
 //#region src/extensions/workspaces/sessions/(backend)/hook/tool-execution-start.server.ts
 var tool_execution_start_server_default = defineHook((context) => context.root.hooks[0]);
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/tool-result.server.ts
+var tool_result_server_default = 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 = defineServerPlugin({
+const serverPlugin = defineServerPlugin({
 	name: "@agimon-ai/po-file-edit",
 	providerOverrides: composeServerProviderOverrides(root_server_default),
+	injects: 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
@@ -1885,10 +2106,14 @@ const facet = 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() {
@@ -1898,6 +2123,6 @@ const facet = defineServerPlugin({
 	}
 });
 //#endregion
-export { facet as default, facet };
+export { serverPlugin as default, serverPlugin };
 
 //# sourceMappingURL=server.mjs.map