@agimon-ai/po-cache 0.0.0-alpha.2 → 0.0.0-alpha.4

package/dist/env.mjs

@@ -1,2 +1 @@
-import { a as PO_PROMPT_CACHE_ROOT_SESSION_ENV, i as PO_PROMPT_CACHE_PARENT_NAMESPACE_ENV, n as PI_CACHE_RETENTION_LONG, r as PO_PROMPT_CACHE_CHILD_PROJECTION_ENV, t as PI_CACHE_RETENTION_ENV } from "./environment-vyw-n84h.mjs";
-export { PI_CACHE_RETENTION_ENV, PI_CACHE_RETENTION_LONG, PO_PROMPT_CACHE_CHILD_PROJECTION_ENV, PO_PROMPT_CACHE_PARENT_NAMESPACE_ENV, PO_PROMPT_CACHE_ROOT_SESSION_ENV };
+export { t as PI_CACHE_RETENTION_ENV, n as PI_CACHE_RETENTION_LONG, r as PO_PROMPT_CACHE_CHILD_PROJECTION_ENV, i as PO_PROMPT_CACHE_PARENT_NAMESPACE_ENV, a as PO_PROMPT_CACHE_ROOT_SESSION_ENV } from "./environment-vyw-n84h.mjs";

package/dist/extensions/mcp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.cjs","names":["defineMcpSkill","readPackageResource","defineMcpPlugin","skillPoUseCache"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-cache',\n  description: 'Inspect Po provider prompt cache policy, routing identity, and provider-observed usage.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-cache/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseCache from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-cache',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillPoUseCache, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;;;;;AAGA,IAAA,4BAAA,GAAeA,4BAAAA,eAAAA,CAAe;CAC5B,MAAM;CACN,aAAa;CACb,aAAA,GAAYC,+BAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,mCAAmC;AACtF,CAAC;;;ACDD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,OAAA,GAAMC,4BAAAA,gBAAAA,CAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGC,0BAAiB,OAAO,CAAC;CAAG,EACxF;AACF,CAAC"}
+{"version":3,"file":"mcp.cjs","names":["defineMcpSkill","readPackageResource","defineMcpPlugin","skillPoUseCache"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-cache',\n  description: 'Inspect Po provider prompt cache policy, routing identity, and provider-observed usage.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-cache/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseCache from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-cache',\n  session: (context) => ({\n    get skills(): PoMcpSessionPlugin['skills'] { return [at(skillPoUseCache, context)]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;;;;;AAGA,IAAA,4BAAA,GAAeA,4BAAAA,eAAAA,CAAe;CAC5B,MAAM;CACN,aAAa;CACb,aAAA,GAAYC,+BAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,mCAAmC;AACtF,CAAC;;;ACDD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,OAAA,GAAMC,4BAAAA,gBAAAA,CAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAuC;EAAE,OAAO,CAAC,GAAGC,0BAAiB,OAAO,CAAC;CAAG,EACtF;AACF,CAAC"}

package/dist/extensions/mcp.d.mts

@@ -1,5 +1,5 @@
 //#region generated/mcp.d.ts
-export declare const mcp: import("@agimon-ai/po-core/mcpFacet").DoomMcpPluginDefinition;
+export declare const mcp: import("@agimon-ai/po-core/mcpFacet").PoMcpPluginDefinition;
 //#endregion
 export { mcp as default };
 //# sourceMappingURL=mcp.d.mts.map

package/dist/extensions/mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.mjs","names":["skillPoUseCache"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-cache',\n  description: 'Inspect Po provider prompt cache policy, routing identity, and provider-observed usage.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-cache/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseCache from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-cache',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillPoUseCache, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;AAGA,IAAA,2BAAe,eAAe;CAC5B,MAAM;CACN,aAAa;CACb,YAAY,oBAAoB,YAAY,KAAK,mCAAmC;AACtF,CAAC;;;ACDD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,MAAM,gBAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGA,0BAAiB,OAAO,CAAC;CAAG,EACxF;AACF,CAAC"}
+{"version":3,"file":"mcp.mjs","names":["skillPoUseCache"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-use-cache',\n  description: 'Inspect Po provider prompt cache policy, routing identity, and provider-observed usage.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-use-cache/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoUseCache from '../src/extensions/workspaces/sessions/(backend)/skill/po-use-cache.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-cache',\n  session: (context) => ({\n    get skills(): PoMcpSessionPlugin['skills'] { return [at(skillPoUseCache, context)]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;AAGA,IAAA,2BAAe,eAAe;CAC5B,MAAM;CACN,aAAa;CACb,YAAY,oBAAoB,YAAY,KAAK,mCAAmC;AACtF,CAAC;;;ACDD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,MAAM,gBAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAuC;EAAE,OAAO,CAAC,GAAGA,0BAAiB,OAAO,CAAC;CAAG,EACtF;AACF,CAAC"}

package/dist/extensions/server.cjs

@@ -3,17 +3,15 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_environment = require("../environment-CRhmV8ze.cjs");
-const require_promptCacheTelemetry = require("../promptCacheTelemetry-BU1fIhb8.cjs");
+const require_promptCacheTelemetry = require("../promptCacheTelemetry-DeN4LdSo.cjs");
 let node_crypto = require("node:crypto");
 let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
+let _agimon_ai_po_core_platform = require("@agimon-ai/po-core/platform");
 let _agimon_ai_po_config_harnessStore = require("@agimon-ai/po-config/harnessStore");
 let _agimon_ai_po_minor_mode = require("@agimon-ai/po-minor-mode");
 let node_path = require("node:path");
 let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
-let node_os = require("node:os");
 //#region src/services/environment/index.ts
 const environmentLeases = /* @__PURE__ */ new WeakMap();
 /** Same-value session leases restore only after the final owner leaves. External writes win. */
@@ -181,7 +179,7 @@ function createCacheRuntime(dependencies, environment) {
 		return parentNamespace;
 	};
 	const plugin = (cordis) => {
-		cordis.inject([_agimon_ai_po_minor_mode.DOOM_MINOR_MODE_CATALOG_SERVICE], (context) => {
+		cordis.inject([_agimon_ai_po_minor_mode.PO_MINOR_MODE_CATALOG_SERVICE], (context) => {
 			if (isProjectedChild) return void 0;
 			const catalog = (0, _agimon_ai_po_minor_mode.readMinorModeCatalog)(context);
 			if (!catalog) return void 0;
@@ -216,8 +214,19 @@ function createCacheRuntime(dependencies, environment) {
 	};
 }
 //#endregion
+//#region src/services/agentDirectory/index.ts
+/** Pi's agent directory, where the optimizer keeps its state; the edge build swaps in `index.edge.ts`. */
+function defaultAgentDirectory() {
+	return (0, _earendil_works_pi_coding_agent.getAgentDir)();
+}
+//#endregion
 //#region src/services/optimizerSupport/index.ts
-function createOptimizerSupport(STATE_DIR, environment) {
+/**
+* Optimizer state under `STATE_DIR`, read and written through the injected file system. Synchronous
+* readers (`getCompat`, `footerStatsMode`) use the files as of the last `refreshFileConfig()`.
+*/
+function createOptimizerSupport(STATE_DIR, environment, fs) {
+	const io = _agimon_ai_po_core_platform.BACKGROUND_CONTEXT;
 	const MODELS_JSON_PATH = (0, node_path.join)(STATE_DIR, "models.json");
 	function isVirtualRoutingModel(model) {
 		return !!model && (isNativeVirtualModel(model) || model.provider.toLowerCase() === "router");
@@ -496,21 +505,20 @@ function createOptimizerSupport(STATE_DIR, environment) {
 		}
 		return true;
 	}
+	/** Keyed by the file text, so an unchanged models.json is not parsed again. */
 	let modelsConfigCache;
-	function getModelsConfigSignature() {
+	async function refreshModelsConfig() {
+		let text;
 		try {
-			const info = (0, node_fs.statSync)(MODELS_JSON_PATH);
-			return `${info.dev}:${info.ino}:${info.size}:${info.mtimeMs}:${info.ctimeMs}`;
+			text = await (0, _agimon_ai_po_core_platform.readTextIfExists)(fs, MODELS_JSON_PATH, io);
 		} catch {
-			return "missing";
+			text = void 0;
 		}
-	}
-	function readEffectiveCompatConfig() {
-		const signature = getModelsConfigSignature();
-		if (modelsConfigCache?.signature === signature) return modelsConfigCache.value;
+		const signature = text ?? "missing";
+		if (modelsConfigCache?.signature === signature) return;
 		let value;
-		if (signature !== "missing") try {
-			const parsed = parseJsonc((0, node_fs.readFileSync)(MODELS_JSON_PATH, "utf8"));
+		if (text !== void 0) try {
+			const parsed = parseJsonc(text);
 			value = isValidModelsConfigForEffectiveCompat(parsed) ? parsed : void 0;
 		} catch {
 			value = void 0;
@@ -519,17 +527,24 @@ function createOptimizerSupport(STATE_DIR, environment) {
 			signature,
 			value
 		};
-		return value;
+	}
+	/** The models.json compat config as of the last refresh. */
+	function effectiveCompatConfig() {
+		return modelsConfigCache?.value;
+	}
+	async function readEffectiveCompatConfig() {
+		await refreshModelsConfig();
+		return effectiveCompatConfig();
 	}
 	function getCompat(model) {
 		if (!model) return {};
-		return resolveEffectiveCompatFromConfig(model, readEffectiveCompatConfig());
+		return resolveEffectiveCompatFromConfig(model, effectiveCompatConfig());
 	}
 	function joinDisplayPath(base, child, platform = process.platform) {
 		const sep = platform.startsWith("win") ? "\\" : "/";
 		return `${base.replace(/[\\/]+$/, "")}${sep}${child}`;
 	}
-	function getAgentDirDisplayPath(platform = process.platform, agentDir = STATE_DIR, homeDir = (0, node_os.homedir)()) {
+	function getAgentDirDisplayPath(platform = process.platform, agentDir = STATE_DIR, homeDir = _agimon_ai_po_core_platform.nodeHost.homeDirectory()) {
 		const sep = platform.startsWith("win") ? "\\" : "/";
 		const normalizedAgentDir = agentDir.replace(/[\\/]+/g, sep);
 		const normalizedHomeDir = homeDir.replace(/[\\/]+/g, sep).replace(/[\\/]+$/, "");
@@ -541,7 +556,7 @@ function createOptimizerSupport(STATE_DIR, environment) {
 		}
 		return normalizedAgentDir;
 	}
-	function getModelsJsonDisplayPath(platform = process.platform, agentDir = STATE_DIR, homeDir = (0, node_os.homedir)()) {
+	function getModelsJsonDisplayPath(platform = process.platform, agentDir = STATE_DIR, homeDir = _agimon_ai_po_core_platform.nodeHost.homeDirectory()) {
 		return joinDisplayPath(getAgentDirDisplayPath(platform, agentDir, homeDir), "models.json", platform);
 	}
 	function parseFooterStatsMode(value) {
@@ -605,11 +620,13 @@ function createOptimizerSupport(STATE_DIR, environment) {
 			...features ? { features } : {}
 		};
 	}
-	function readPersistedCacheOptimizerConfig(configPath = CONFIG_FILE_PATH) {
+	async function readPersistedCacheOptimizerConfig(configPath = CONFIG_FILE_PATH) {
 		try {
-			return normalizePersistedCacheOptimizerConfig(parsePersistedCacheOptimizerConfig(JSON.parse((0, node_fs.readFileSync)(configPath, "utf8"))));
+			const text = await (0, _agimon_ai_po_core_platform.readTextIfExists)(fs, configPath, io);
+			if (text === void 0) return { version: 2 };
+			return normalizePersistedCacheOptimizerConfig(parsePersistedCacheOptimizerConfig(JSON.parse(text)));
 		} catch (error) {
-			if (getErrorCode(error) !== "ENOENT") console.warn(`${LOG_PREFIX}: failed to read optimizer config; using defaults`, error);
+			console.warn(`${LOG_PREFIX}: failed to read optimizer config; using defaults`, error);
 			return { version: 2 };
 		}
 	}
@@ -630,7 +647,17 @@ function createOptimizerSupport(STATE_DIR, environment) {
 	function footerStatsMode(env = environment, configuredMode = persistedFooterStatsMode) {
 		return resolveFooterStatsMode(configuredMode, env).mode;
 	}
-	const persistedFooterStatsMode = readPersistedCacheOptimizerConfig().footerMode;
+	/** Read once, on the first refresh, like the original read at construction. */
+	let persistedConfigLoaded = false;
+	let persistedFooterStatsMode;
+	/** Loads the persisted optimizer config once and rereads models.json; call before the synchronous readers. */
+	async function refreshFileConfig() {
+		if (!persistedConfigLoaded) {
+			persistedConfigLoaded = true;
+			persistedFooterStatsMode = (await readPersistedCacheOptimizerConfig()).footerMode;
+		}
+		await refreshModelsConfig();
+	}
 	function isAssistantMessage(message) {
 		return asRecord(message)?.role === "assistant";
 	}
@@ -1258,7 +1285,7 @@ function createOptimizerSupport(STATE_DIR, environment) {
 			baseUrl: "",
 			[ROUTED_FALLBACK_MODEL_SYMBOL]: true
 		};
-		const provider = asRecord(asRecord(asRecord(readEffectiveCompatConfig())?.providers)?.[model.provider]);
+		const provider = asRecord(asRecord(asRecord(effectiveCompatConfig())?.providers)?.[model.provider]);
 		const customModel = findLastExactModelDefinition(Array.isArray(provider?.models) ? provider.models : void 0, model.id);
 		const configuredApi = customModel?.api ?? provider?.api;
 		const configuredBaseUrl = customModel?.baseUrl ?? provider?.baseUrl;
@@ -2783,14 +2810,6 @@ function createOptimizerSupport(STATE_DIR, environment) {
 			stats: best.stats
 		} : void 0;
 	}
-	function createSerializedAsyncRunner() {
-		let tail = Promise.resolve();
-		return (operation) => {
-			const result = tail.then(operation);
-			tail = result.catch(() => void 0);
-			return result;
-		};
-	}
 	function modelEpochPath(modelKeyValue) {
 		return (0, node_path.join)(SHARD_MODEL_EPOCH_DIR, `${(0, node_crypto.createHash)("sha256").update(modelKeyValue).digest("hex")}.json`);
 	}
@@ -2803,7 +2822,7 @@ function createOptimizerSupport(STATE_DIR, environment) {
 	}
 	async function readEpochFile(path, fallback) {
 		try {
-			return parseEpochRecord(JSON.parse(await (0, node_fs_promises.readFile)(path, "utf8"))) ?? fallback;
+			return parseEpochRecord(JSON.parse((0, _agimon_ai_po_core_platform.getOrThrow)(await fs.readTextFile(path, io)))) ?? fallback;
 		} catch {
 			return fallback;
 		}
@@ -2815,14 +2834,11 @@ function createOptimizerSupport(STATE_DIR, environment) {
 		return readEpochFile(modelEpochPath(modelKeyValue), initialEpoch(`model:${modelKeyValue}`));
 	}
 	async function writeStatsEpoch(path, epoch) {
-		await (0, node_fs_promises.mkdir)((0, node_path.dirname)(path), { recursive: true });
-		const tempPath = `${path}.${process.pid}.${Date.now()}.${(0, node_crypto.randomUUID)()}.tmp`;
-		await (0, node_fs_promises.writeFile)(tempPath, JSON.stringify({
+		await (0, _agimon_ai_po_core_platform.writeFileAtomic)(fs, path, JSON.stringify({
 			version: 1,
 			epoch,
 			createdAt: Date.now()
-		}, null, 2) + "\n", "utf8");
-		await (0, node_fs_promises.rename)(tempPath, path);
+		}, null, 2) + "\n", io);
 	}
 	async function advanceGlobalStatsEpoch() {
 		const epoch = `${Date.now()}-${(0, node_crypto.randomUUID)()}`;
@@ -2878,27 +2894,34 @@ function createOptimizerSupport(STATE_DIR, environment) {
 		};
 	}
 	async function writeStatsShardV7(path, shard) {
-		await (0, node_fs_promises.mkdir)((0, node_path.dirname)(path), { recursive: true });
-		const tempPath = `${path}.${process.pid}.${Date.now()}.${(0, node_crypto.randomUUID)()}.tmp`;
-		await (0, node_fs_promises.writeFile)(tempPath, JSON.stringify(shard, null, 2) + "\n", "utf8");
-		await (0, node_fs_promises.rename)(tempPath, path);
+		await (0, _agimon_ai_po_core_platform.writeFileAtomic)(fs, path, JSON.stringify(shard, null, 2) + "\n", io);
 	}
-	async function readValidStatsShardsV7(directory = SHARD_FILES_DIR) {
-		let names;
+	/** Entries of `directory`, or undefined when it does not exist. Entries removed while listing are skipped. */
+	async function listDirectoryEntries(directory) {
+		const opened = await fs.openDirReader(directory, io);
+		if (!opened.ok && opened.error.code === "not_found") return void 0;
+		const reader = (0, _agimon_ai_po_core_platform.getOrThrow)(opened);
 		try {
-			names = await (0, node_fs_promises.readdir)(directory);
-		} catch (error) {
-			if (getErrorCode(error) === "ENOENT") return [];
-			throw error;
+			const entries = [];
+			for (;;) {
+				const page = (0, _agimon_ai_po_core_platform.getOrThrow)(await reader.next(256, io));
+				entries.push(...page.entries);
+				if (page.done) return entries;
+			}
+		} finally {
+			await reader.close(io);
 		}
+	}
+	async function readValidStatsShardsV7(directory = SHARD_FILES_DIR) {
+		const entries = await listDirectoryEntries(directory);
+		if (!entries) return [];
 		const shards = [];
-		for (const name of names) {
+		for (const { name, kind } of entries) {
 			if (!/^[0-9a-f-]+\.json$/i.test(name)) continue;
 			const path = (0, node_path.join)(directory, name);
 			try {
-				const info = await (0, node_fs_promises.lstat)(path);
-				if (!info.isFile() || info.isSymbolicLink()) continue;
-				const parsed = parsePersistedStatsShardV7(JSON.parse(await (0, node_fs_promises.readFile)(path, "utf8")));
+				if (kind !== "file") continue;
+				const parsed = parsePersistedStatsShardV7(JSON.parse((0, _agimon_ai_po_core_platform.getOrThrow)(await fs.readTextFile(path, io))));
 				const filenameInstanceId = name.slice(0, -5);
 				if (parsed && parsed.instanceId === filenameInstanceId) shards.push(parsed);
 			} catch {}
@@ -2969,73 +2992,63 @@ function createOptimizerSupport(STATE_DIR, environment) {
 		}
 	}
 	async function removeLegacyStatsFiles() {
-		for (const path of [STATE_FILE_PATH, LEGACY_STATE_FILE_PATH]) try {
-			await (0, node_fs_promises.unlink)(path);
-		} catch (error) {
-			if (getErrorCode(error) !== "ENOENT") console.warn(`${LOG_PREFIX}: failed to remove obsolete stats file ${path}`, error);
+		for (const path of [STATE_FILE_PATH, LEGACY_STATE_FILE_PATH]) {
+			const removed = await fs.remove(path, { force: true }, io);
+			if (!removed.ok) console.warn(`${LOG_PREFIX}: failed to remove obsolete stats file ${path}`, removed.error);
 		}
 	}
 	async function cleanupStatsShardsV7(now = Date.now(), directory = SHARD_FILES_DIR) {
-		let names;
-		try {
-			names = await (0, node_fs_promises.readdir)(directory);
-		} catch (error) {
-			return getErrorCode(error) === "ENOENT" ? 0 : Promise.reject(error);
-		}
+		const entries = await listDirectoryEntries(directory);
+		if (!entries) return 0;
 		const today = currentLocalDay();
 		let removed = 0;
-		for (const name of names) {
+		for (const info of entries) {
+			const { name } = info;
 			const isShard = /^[0-9a-f-]+\.json$/i.test(name);
 			const isTemp = name.endsWith(".tmp");
 			if (!isShard && !isTemp) continue;
 			const path = (0, node_path.join)(directory, name);
 			try {
-				const info = await (0, node_fs_promises.lstat)(path);
-				if (!info.isFile() || info.isSymbolicLink()) continue;
+				if (info.kind !== "file") continue;
 				if (isTemp) {
 					if (now - info.mtimeMs < SHARD_TEMP_RETENTION_MS) continue;
 				} else {
-					const parsed = parsePersistedStatsShardV7(JSON.parse(await (0, node_fs_promises.readFile)(path, "utf8")));
+					const parsed = parsePersistedStatsShardV7(JSON.parse((0, _agimon_ai_po_core_platform.getOrThrow)(await fs.readTextFile(path, io))));
 					if (parsed?.day === today) continue;
 					if (now - (parsed?.lifecycle.updatedAt ?? info.mtimeMs) < SHARD_RETENTION_MS) continue;
 					if (parsed?.lifecycle.state === "active" && isProcessAlive(parsed.process.pid)) continue;
 				}
-				await (0, node_fs_promises.unlink)(path);
+				(0, _agimon_ai_po_core_platform.getOrThrow)(await fs.remove(path, void 0, io));
 				removed += 1;
 			} catch {}
 		}
 		return removed;
 	}
+	/**
+	* Best-effort cross-process maintenance. A non-recursive `createDir` claims the cleanup lock; if two
+	* cleanups ever overlap, each only removes expired shards, so the lock bounds work rather than guarding
+	* correctness.
+	*/
 	async function maybeCleanupStatsShardsV7(now = Date.now()) {
-		await (0, node_fs_promises.mkdir)(SHARD_MAINTENANCE_DIR, { recursive: true });
-		try {
-			if (now - (await (0, node_fs_promises.stat)(SHARD_CLEANUP_MARKER_PATH)).mtimeMs < SHARD_CLEANUP_INTERVAL_MS) return;
-		} catch {}
-		try {
-			await (0, node_fs_promises.mkdir)(SHARD_CLEANUP_LOCK_PATH);
-		} catch (error) {
-			if (getErrorCode(error) !== "EEXIST") return;
-			try {
-				if (now - (await (0, node_fs_promises.stat)(SHARD_CLEANUP_LOCK_PATH)).mtimeMs <= SHARD_CLEANUP_LOCK_STALE_MS) return;
-				await (0, node_fs_promises.rm)(SHARD_CLEANUP_LOCK_PATH, {
-					recursive: true,
-					force: true
-				});
-				await (0, node_fs_promises.mkdir)(SHARD_CLEANUP_LOCK_PATH);
-			} catch {
-				return;
-			}
+		(0, _agimon_ai_po_core_platform.getOrThrow)(await fs.createDir(SHARD_MAINTENANCE_DIR, { recursive: true }, io));
+		const marker = await fs.fileInfo(SHARD_CLEANUP_MARKER_PATH, io);
+		if (marker.ok && now - marker.value.mtimeMs < SHARD_CLEANUP_INTERVAL_MS) return;
+		if (!(await fs.createDir(SHARD_CLEANUP_LOCK_PATH, { recursive: false }, io)).ok) {
+			const lock = await fs.fileInfo(SHARD_CLEANUP_LOCK_PATH, io);
+			if (!lock.ok || now - lock.value.mtimeMs <= SHARD_CLEANUP_LOCK_STALE_MS) return;
+			if (!(await fs.remove(SHARD_CLEANUP_LOCK_PATH, {
+				recursive: true,
+				force: true
+			}, io)).ok || !(await fs.createDir(SHARD_CLEANUP_LOCK_PATH, { recursive: false }, io)).ok) return;
 		}
 		try {
 			await cleanupStatsShardsV7(now);
-			const tempPath = `${SHARD_CLEANUP_MARKER_PATH}.${process.pid}.${(0, node_crypto.randomUUID)()}.tmp`;
-			await (0, node_fs_promises.writeFile)(tempPath, `${now}\n`, "utf8");
-			await (0, node_fs_promises.rename)(tempPath, SHARD_CLEANUP_MARKER_PATH);
+			await (0, _agimon_ai_po_core_platform.writeFileAtomic)(fs, SHARD_CLEANUP_MARKER_PATH, `${now}\n`, io);
 		} finally {
-			await (0, node_fs_promises.rm)(SHARD_CLEANUP_LOCK_PATH, {
+			(0, _agimon_ai_po_core_platform.getOrThrow)(await fs.remove(SHARD_CLEANUP_LOCK_PATH, {
 				recursive: true,
 				force: true
-			});
+			}, io));
 		}
 	}
 	function isExplicitPromptCacheRetentionUnsupportedApplicable(model) {
@@ -3186,7 +3199,7 @@ function createOptimizerSupport(STATE_DIR, environment) {
 		advanceModelStatsEpoch,
 		maybeCleanupStatsShardsV7,
 		removeLegacyStatsFiles,
-		createSerializedAsyncRunner,
+		createSerializedAsyncRunner: _agimon_ai_po_core_platform.createSerialRunner,
 		hasReasoningProtocolRejectionErrorMessage,
 		isReasoningProtocolRejectionForModel,
 		hasPromptCacheKeyUnsupportedErrorMessage,
@@ -3205,6 +3218,7 @@ function createOptimizerSupport(STATE_DIR, environment) {
 		parsePersistedStatsShardV7,
 		cleanupStatsShardsV7,
 		readEffectiveCompatConfig,
+		refreshFileConfig,
 		getCompat,
 		SHARD_FILES_DIR,
 		LOG_PREFIX
@@ -3224,8 +3238,8 @@ function asModel(model) {
 	} : void 0;
 }
 /** One native session owner. Only V7 counters, never payloads or credentials, reach disk. */
-function createNativeOptimizer(initial, stateDir = (0, _earendil_works_pi_coding_agent.getAgentDir)()) {
-	const support = createOptimizerSupport(stateDir, initial.environment);
+function createNativeOptimizer(initial, fs, stateDir = defaultAgentDirectory()) {
+	const support = createOptimizerSupport(stateDir, initial.environment, fs);
 	const serialized = support.createSerializedAsyncRunner();
 	const instanceId = (0, node_crypto.randomUUID)();
 	const instanceStartedAt = Date.now();
@@ -3509,6 +3523,7 @@ function createNativeOptimizer(initial, stateDir = (0, _earendil_works_pi_coding
 					if (started || closed) return;
 					started = true;
 					releaseRetention = acquireEnvironmentValue("PI_CACHE_RETENTION", "long");
+					await support.refreshFileConfig();
 					currentGlobalEpoch = await support.readGlobalStatsEpoch();
 					await support.removeLegacyStatsFiles();
 					await refresh();
@@ -3523,6 +3538,7 @@ function createNativeOptimizer(initial, stateDir = (0, _earendil_works_pi_coding
 				handle: (event, context) => serialized(async () => {
 					if (typeof event.parentToolCallId === "string" && event.parentToolCallId.trim()) return;
 					if (started && !closed) {
+						await support.refreshFileConfig();
 						await refresh();
 						await publish(context);
 					}
@@ -3532,6 +3548,7 @@ function createNativeOptimizer(initial, stateDir = (0, _earendil_works_pi_coding
 				event: "agent_settled",
 				handle: (_event, context) => serialized(async () => {
 					if (started && !closed) {
+						await support.refreshFileConfig();
 						await refresh();
 						await publish(context);
 					}
@@ -3541,6 +3558,7 @@ function createNativeOptimizer(initial, stateDir = (0, _earendil_works_pi_coding
 				event: "model_select",
 				handle: (_event, context) => serialized(async () => {
 					if (!started || closed) return;
+					await support.refreshFileConfig();
 					const model = selectedModel(context);
 					support.notifyCacheCompatIfNeeded(model, (text) => notify(context, text), warnedModels);
 					await refresh();
@@ -3550,7 +3568,9 @@ function createNativeOptimizer(initial, stateDir = (0, _earendil_works_pi_coding
 			{
 				event: "message_end",
 				handle: (event, context) => serialized(async () => {
-					if (started && !closed) await observe(event.message, context);
+					if (!started || closed) return;
+					await support.refreshFileConfig();
+					await observe(event.message, context);
 				})
 			},
 			{
@@ -3570,14 +3590,14 @@ function createNativeOptimizer(initial, stateDir = (0, _earendil_works_pi_coding
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/root.server.ts
-var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)(({ agent }) => {
+var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)(({ agent, context: root }) => {
 	if (!agent) throw new Error("Cache statistics require the native session host.");
 	const telemetry = new require_promptCacheTelemetry.PromptCacheTelemetry();
 	const runtime = createCacheRuntime({
 		telemetry,
 		now: Date.now
 	}, agent.context.environment);
-	const optimizer = createNativeOptimizer(agent.context);
+	const optimizer = createNativeOptimizer(agent.context, (0, _agimon_ai_po_core_platform.requirePoFs)(root));
 	return {
 		value: { hooks: optimizer.hooks.map((hook) => {
 			if (hook.event === "session_start") return {