@agimon-ai/doompi-cache 0.0.1-alpha.7 → 0.0.1-alpha.71

package/dist/extensions/pi.d.mts

@@ -1,4 +1,3 @@
-import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 //#region src/types/cache.d.ts
 type PromptCacheCapabilityClass = 'key-and-long-retention' | 'key-only' | 'marker-only' | 'automatic' | 'unknown';
 interface PromptCacheUsage {
@@ -36,8 +35,8 @@ interface CacheExtensionDependencies {
   readonly now: () => number;
 }
 //#endregion
-//#region src/adapters/pi/extension.d.ts
-declare function activateCacheExtension(pi: ExtensionAPI, dependencies?: CacheExtensionDependencies): Promise<void>;
+//#region generated/pi.d.ts
+export declare const extension: import("@agimon-ai/doompi-core/runtimePiExtension").DefinedPiExtension<CacheExtensionDependencies>;
 //#endregion
-export { activateCacheExtension, activateCacheExtension as default };
+export { extension as default };
 //# sourceMappingURL=pi.d.mts.map

package/dist/extensions/pi.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"pi.d.mts","names":[],"sources":["../../src/types/cache.ts","../../src/types/extension.ts","../../src/adapters/pi/extension.ts"],"mappings":";;KAAY;UA+CK;WACN;WACA;WACA;;UAGM,+BAA+B;WACrC;WACA;WACA;;UAGM;WACN,YAAY;WACZ;WACA;WACA;WACA;;UAGM,qCAAqC;WAC3C;WACA,uBAAuB;WACvB,kBAAkB;;UAGZ;EACf,aAAa,QAAQ;EACrB,QAAQ,OAAO,kBAAkB;EACjC,YAAY;EACZ;;;;UC3Ee;WACN,WAAW;WACX;;;;iBC2MW,uBACpB,IAAI,cACJ,eAAc,6BACb"}
+{"version":3,"file":"pi.d.mts","names":[],"sources":["../../src/types/cache.ts","../../src/types/extension.ts","../../generated/pi.ts"],"mappings":";KAAY;UA+CK;WACN;WACA;WACA;;UAGM,+BAA+B;WACrC;WACA;WACA;;UAGM;WACN,YAAY;WACZ;WACA;WACA;WACA;;UAGM,qCAAqC;WAC3C;WACA,uBAAuB;WACvB,kBAAkB;;UAGZ;EACf,aAAa,QAAQ;EACrB,QAAQ,OAAO,kBAAkB;EACjC,YAAY;EACZ;;;;UC3Ee;WACN,WAAW;WACX;;;;qBCaE,+DAAS,mBAAT"}

package/dist/extensions/pi.mjs

@@ -1,2 +1,454 @@
-import{getHarnessState as e}from"@agimon-ai/doompi-config/harnessStore";import{connectDoomCordisHost as t}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{DOOM_HELP_SERVICE as n,requireDoomHelpService as r}from"@agimon-ai/doompi-extension-contracts/help";import{DOOM_MINOR_MODE_CATALOG_SERVICE as i,readMinorModeCatalog as a}from"@agimon-ai/doompi-extension-contracts/mode";import{createHash as o}from"node:crypto";import{Service as s}from"@deepseek-ai/cordis";var c=class{#e;#t={capability:`unknown`};#n=[];constructor(e=64){if(!Number.isInteger(e)||e<1)throw Error(`Prompt cache telemetry limit must be a positive integer.`);this.#e=e}beginRequest(e){this.#t={...e}}observe(e,t){let n=this.#t.namespace,r=this.#t.modelFingerprint;!n||!r||(this.#n.push({namespace:n,modelFingerprint:r,cacheRead:e.cacheRead,cacheWrite:e.cacheWrite,totalInput:e.totalInput,observedAt:t}),this.#n.length>this.#e&&this.#n.splice(0,this.#n.length-this.#e))}snapshot(){let e=[...this.#n];return{...this.#t,residency:`unknown`,observations:e,...e.length>0?{lastObservation:e.at(-1)}:{}}}reset(){this.#t={capability:`unknown`},this.#n=[]}};function l(e={}){return{telemetry:e.telemetry??new c,now:e.now??Date.now}}var u=class{#e;#t;#n;#r;constructor(e,t=process.env){this.#t=e,this.#e=t,this.#n={present:Object.hasOwn(t,e),value:t[e]}}set(e){this.#e[this.#t]=e,this.#r=e}restore(){this.#r!==void 0&&this.#e[this.#t]===this.#r&&(this.#n.present?this.#e[this.#t]=this.#n.value:delete this.#e[this.#t],this.#r=void 0)}};function d(e){return o(`sha256`).update(e).digest(`base64url`)}var f=class extends s{telemetry;constructor(e,t){super(e,`doom/prompt-cache-telemetry`),this.telemetry=t}snapshot(){return this.telemetry.snapshot()}};function p(e){if(!Number.isFinite(e))throw Error(`Prompt cache identity cannot contain a non-finite number.`);return Object.is(e,-0)?0:e}function m(e){if(e===null)return null;if(typeof e==`string`)return e.normalize(`NFC`);if(typeof e==`boolean`)return e;if(typeof e==`number`)return p(e);if(Array.isArray(e))return e.map(e=>m(e));if(typeof e!=`object`)throw Error(`Unsupported prompt cache identity value: ${typeof e}.`);let t=e,n={};for(let e of Object.keys(t).sort((e,t)=>e.localeCompare(t))){let r=t[e];r!==void 0&&(n[e.normalize(`NFC`)]=m(r))}return n}function h(e){return JSON.stringify(m(e))}function g(e,t,n){return`${e}${n(h(t))}`}function _(e){return e?.trim().replaceAll(`\\`,`/`)||void 0}function v(e){return e.filter(({activation:e})=>e===`active`||e===`activating`).map(({source:e,id:t,modelContextVariant:n})=>({source:e,id:t,...n?{modelContextVariant:n}:{}})).sort((e,t)=>e.source.localeCompare(t.source)||e.id.localeCompare(t.id))}function y(e,t){return g(`dpr1_`,{version:1,rootSessionId:e},t)}function b(e,t){return g(`dpn1_`,{version:1,rootSession:y(e.rootSessionId,t),compositionFingerprint:e.compositionFingerprint??null,majorMode:e.majorMode,domains:[...e.domains],profile:e.profile??null,persona:_(e.persona)??null,minorModes:v(e.minorModes)},t)}function x(e,t){return g(`dpm1_`,{version:1,virtualProvider:e.virtualProvider??null,virtualModel:e.virtualModel??null,api:e.api??null,baseUrl:e.baseUrl??null,wireModel:e.wireModel??null},t)}function S(e,t,n,r,i){return g(`dpc1_`,{version:1,parentNamespace:e,scope:t,childProjection:i??null,modelFingerprint:n},r)}function C(e){let t=e.__internals_for_tests;return typeof t?.isRuntimeOptimizerEnabled==`function`&&typeof t.shouldInjectOpenAIPromptCacheKey==`function`&&t.isRuntimeOptimizerEnabled()&&t.shouldInjectOpenAIPromptCacheKey()}const w=new Set([`openai-completions`,`openai-responses`,`openai-codex-responses`,`azure-openai-responses`]),T=new Set([`anthropic-messages`,`bedrock-converse-stream`]),E=new Set([`google-generative-ai`,`google-vertex`,`google-vertex-anthropic`]);function D(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function O(e){return e.api===`openai-responses`||e.api===`openai-completions`?e.virtualProvider===`openai`?`key-and-long-retention`:`key-only`:e.api&&w.has(e.api)?`key-only`:e.api&&T.has(e.api)?`marker-only`:e.api&&E.has(e.api)?`automatic`:`unknown`}function k(e,t,n,r){if(!r||!t||!w.has(t)||!D(e))return;let i=e.prompt_cache_key;if(!(typeof i!=`string`||!i.trim()||i===n))return{...e,prompt_cache_key:n}}function A(e){if(!D(e))return;let t=e.prompt_cache_retention;return typeof t==`string`&&t.trim()?t.trim():void 0}function j(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:void 0}function M(e){return typeof e==`number`&&Number.isFinite(e)&&e>=0?e:void 0}function N(...e){for(let t of e){let e=M(t);if(e!==void 0)return e}}function P(e){let t=M(e.cacheRead),n=M(e.cacheWrite);if(t===void 0&&n===void 0)return;let r=M(e.input)??0;return{cacheRead:t??0,cacheWrite:n??0,totalInput:r+(t??0)+(n??0)}}function F(e){let t=j(e.prompt_tokens_details)??j(e.promptTokensDetails),n=j(e.input_tokens_details)??j(e.inputTokensDetails),r=N(t?.cached_tokens,t?.cachedTokens,n?.cached_tokens,n?.cachedTokens),i=N(t?.cache_write_tokens,t?.cacheWriteTokens,n?.cache_write_tokens,n?.cacheWriteTokens);if(r===void 0&&i===void 0)return;let a=(r??0)+(i??0),o=N(e.prompt_tokens,e.promptTokens,e.input_tokens,e.inputTokens);return{cacheRead:r??0,cacheWrite:i??0,totalInput:Math.max(o??a,a)}}function I(e){let t=N(e.cache_read_input_tokens,e.cacheReadInputTokens),n=N(e.cache_creation_input_tokens,e.cacheCreationInputTokens);if(t===void 0&&n===void 0)return;let r=N(e.input_tokens,e.inputTokens)??0;return{cacheRead:t??0,cacheWrite:n??0,totalInput:r+(t??0)+(n??0)}}function L(e){let t=j(e.usage_metadata)??j(e.usageMetadata)??e,n=N(t.cachedContentTokenCount,t.cached_content_token_count);if(n===void 0)return;let r=N(t.promptTokenCount,t.prompt_token_count,e.input_tokens,e.inputTokens,e.prompt_tokens,e.promptTokens);return{cacheRead:n,cacheWrite:0,totalInput:Math.max(r??n,n)}}function R(e){let t=j(j(e)?.usage);if(t)return P(t)??F(t)??I(t)??L(t)}const z=`DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE`,B=`@agimon-ai/doompi-cache`;function V(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function H(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:void 0}function U(e){let t=e.state;return{source:e.descriptor.source,id:e.descriptor.id,activation:t.activation,...t.modelContextVariant?{modelContextVariant:t.modelContextVariant}:{}}}function W(e,t){let n=H(e.model),r=H(t);return{virtualProvider:V(n?.provider),virtualModel:V(n?.id),api:V(n?.api),baseUrl:V(n?.baseUrl),wireModel:V(r?.model)}}function G(e){let t=H(e);return t?.stopReason===`error`||t?.stopReason===`aborted`}function K(e){return A(e)??(process.env.PI_CACHE_RETENTION===`long`?`long`:void 0)}function q(t,n,r,o){let s=new u(z),c=new u(`DOOMPI_PROMPT_CACHE_ROOT_SESSION`),l=V(process.env[z]),f=V(process.env.DOOMPI_PROMPT_CACHE_CHILD_PROJECTION),p=!!(l&&f),m,h=l,g=[],_=()=>{if(p)return h;if(!m)return;let t=e();return h=b({rootSessionId:m,compositionFingerprint:t.compositionFingerprint,majorMode:t.majorMode,domains:t.domains,profile:t.profile,persona:t.personaFile,minorModes:g},d),s.set(h),c.set(y(m,d)),h};return t.inject([i],e=>{if(p)return;let t=a(e);if(!t)return;let n=()=>{g=t.getSnapshot().modes.map(U),_()};return n(),t.subscribe(n)}),n.on(`session_start`,(e,t)=>{p||(m=V(t.sessionManager.getSessionId()),_())}),n.on(`before_provider_request`,(e,t)=>{let n=p?l:_();if(!n)return;let i=W(t,e.payload),a=x(i,d),s=S(n,p?`child`:`parent`,a,d,f),c=k(e.payload,i.api,s,C(o));return r.telemetry.beginRequest({capability:O(i),namespace:n,modelFingerprint:a,requestedRetention:K(c??e.payload),...c?{keySuffix:s.slice(-8)}:{}}),c}),n.on(`message_end`,e=>{if(G(e.message))return;let t=R(e.message);t&&r.telemetry.observe(t,r.now())}),()=>{s.restore(),c.restore(),r.telemetry.reset()}}function J(e,t){e.inject([n],e=>{let t=r(e).register({source:B,moduleUrl:import.meta.url,skills:[{name:`doompi-use-cache`,description:`Inspect DoomPi provider prompt cache policy, routing identity, and provider-observed usage.`}]});return()=>t.dispose()}),e.effect(function*(){new f(e,t.dependencies.telemetry),yield q(e,t.pi,t.dependencies,t.optimizer)},B)}async function Y(e,n=l()){let r=await import(`../pi-cache-optimizer-CjPVk06Q.mjs`);if(typeof r.default!=`function`)throw Error(`Pi Cache Optimizer does not export an extension factory.`);await r.default(e);let i=await t(e,B),a=i.root.plugin(J,{pi:e,dependencies:n,optimizer:r});try{await a}catch(e){try{await a.dispose()}finally{await i.dispose()}throw e}let o;e.on(`session_shutdown`,()=>o??=(async()=>{try{await a.dispose()}finally{await i.dispose()}})())}export{Y as activateCacheExtension,Y as default};
+import { definePiExtension } from "@agimon-ai/doompi-core/piExtension";
+import { composeRootHooks, defineResource, defineRoot } from "@agimon-ai/doompi-core/extensionFile";
+import { getHarnessState } from "@agimon-ai/doompi-config/harnessStore";
+import { DOOM_MINOR_MODE_CATALOG_SERVICE, readMinorModeCatalog } from "@agimon-ai/doompi-minor-mode";
+import { createHash } from "node:crypto";
+import { Service } from "@deepseek-ai/cordis";
+//#region src/models/promptCacheTelemetry.ts
+const DEFAULT_OBSERVATION_LIMIT = 64;
+var PromptCacheTelemetry = class {
+	#limit;
+	#request = { capability: "unknown" };
+	#observations = [];
+	constructor(limit = DEFAULT_OBSERVATION_LIMIT) {
+		if (!Number.isInteger(limit) || limit < 1) throw new Error("Prompt cache telemetry limit must be a positive integer.");
+		this.#limit = limit;
+	}
+	beginRequest(status) {
+		this.#request = { ...status };
+	}
+	observe(usage, observedAt) {
+		const namespace = this.#request.namespace;
+		const modelFingerprint = this.#request.modelFingerprint;
+		if (!namespace || !modelFingerprint) return;
+		this.#observations.push({
+			namespace,
+			modelFingerprint,
+			cacheRead: usage.cacheRead,
+			cacheWrite: usage.cacheWrite,
+			totalInput: usage.totalInput,
+			observedAt
+		});
+		if (this.#observations.length > this.#limit) this.#observations.splice(0, this.#observations.length - this.#limit);
+	}
+	snapshot() {
+		const observations = [...this.#observations];
+		return {
+			...this.#request,
+			residency: "unknown",
+			observations,
+			...observations.length > 0 ? { lastObservation: observations.at(-1) } : {}
+		};
+	}
+	reset() {
+		this.#request = { capability: "unknown" };
+		this.#observations = [];
+	}
+};
+//#endregion
+//#region src/constants/cache.ts
+const PACKAGE_SOURCE = "@agimon-ai/doompi-cache";
+const CACHE_HELP_SKILL = {
+	name: "doompi-use-cache",
+	description: "Inspect DoomPi provider prompt cache policy, routing identity, and provider-observed usage."
+};
+//#endregion
+//#region src/constants/environment.ts
+const DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV = "DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE";
+const DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV = "DOOMPI_PROMPT_CACHE_ROOT_SESSION";
+const DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV = "DOOMPI_PROMPT_CACHE_CHILD_PROJECTION";
+//#endregion
+//#region src/services/digest/index.ts
+function sha256Base64Url(value) {
+	return createHash("sha256").update(value).digest("base64url");
+}
+//#endregion
+//#region src/services/environment/index.ts
+var OwnedEnvironmentValue = class {
+	#environment;
+	#name;
+	#baseline;
+	#ownedValue;
+	constructor(name, environment = process.env) {
+		this.#name = name;
+		this.#environment = environment;
+		this.#baseline = {
+			present: Object.hasOwn(environment, name),
+			value: environment[name]
+		};
+	}
+	set(value) {
+		this.#environment[this.#name] = value;
+		this.#ownedValue = value;
+	}
+	restore() {
+		if (this.#ownedValue === void 0 || this.#environment[this.#name] !== this.#ownedValue) return;
+		if (this.#baseline.present) this.#environment[this.#name] = this.#baseline.value;
+		else delete this.#environment[this.#name];
+		this.#ownedValue = void 0;
+	}
+};
+//#endregion
+//#region src/services/canonical/index.ts
+function canonicalNumber(value) {
+	if (!Number.isFinite(value)) throw new Error("Prompt cache identity cannot contain a non-finite number.");
+	return Object.is(value, -0) ? 0 : value;
+}
+function canonicalValue(value) {
+	if (value === null) return null;
+	if (typeof value === "string") return value.normalize("NFC");
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number") return canonicalNumber(value);
+	if (Array.isArray(value)) return value.map((entry) => canonicalValue(entry));
+	if (typeof value !== "object") throw new Error(`Unsupported prompt cache identity value: ${typeof value}.`);
+	const record = value;
+	const result = {};
+	for (const key of Object.keys(record).sort((left, right) => left.localeCompare(right))) {
+		const entry = record[key];
+		if (entry !== void 0) result[key.normalize("NFC")] = canonicalValue(entry);
+	}
+	return result;
+}
+function canonicalJson(value) {
+	return JSON.stringify(canonicalValue(value));
+}
+//#endregion
+//#region src/services/namespace/index.ts
+const KEY_PREFIX = "dpc1_";
+const PARENT_PREFIX = "dpn1_";
+const ROOT_PREFIX = "dpr1_";
+const MODEL_PREFIX = "dpm1_";
+function digestIdentity(prefix, value, digest) {
+	return `${prefix}${digest(canonicalJson(value))}`;
+}
+function normalizedPersona(value) {
+	return value?.trim().replaceAll("\\", "/") || void 0;
+}
+function activeMinorModes(modes) {
+	return modes.filter(({ activation }) => activation === "active" || activation === "activating").map(({ source, id, modelContextVariant }) => ({
+		source,
+		id,
+		...modelContextVariant ? { modelContextVariant } : {}
+	})).sort((left, right) => left.source.localeCompare(right.source) || left.id.localeCompare(right.id));
+}
+function createRootSessionIdentity(rootSessionId, digest) {
+	return digestIdentity(ROOT_PREFIX, {
+		version: 1,
+		rootSessionId
+	}, digest);
+}
+function createParentPromptCacheNamespace(state, digest) {
+	return digestIdentity(PARENT_PREFIX, {
+		version: 1,
+		rootSession: createRootSessionIdentity(state.rootSessionId, digest),
+		compositionFingerprint: state.compositionFingerprint ?? null,
+		majorMode: state.majorMode,
+		domains: [...state.domains],
+		profile: state.profile ?? null,
+		persona: normalizedPersona(state.persona) ?? null,
+		minorModes: activeMinorModes(state.minorModes)
+	}, digest);
+}
+function createPromptCacheModelFingerprint(model, digest) {
+	return digestIdentity(MODEL_PREFIX, {
+		version: 1,
+		virtualProvider: model.virtualProvider ?? null,
+		virtualModel: model.virtualModel ?? null,
+		api: model.api ?? null,
+		baseUrl: model.baseUrl ?? null,
+		wireModel: model.wireModel ?? null
+	}, digest);
+}
+function createPromptCacheKey(parentNamespace, scope, modelFingerprint, digest, childProjection) {
+	return digestIdentity(KEY_PREFIX, {
+		version: 1,
+		parentNamespace,
+		scope,
+		childProjection: childProjection ?? null,
+		modelFingerprint
+	}, digest);
+}
+//#endregion
+//#region src/services/optimizerPolicy/index.ts
+/** Fail closed unless the pinned optimizer confirms both runtime and key routing are enabled. */
+function optimizerAllowsPromptCacheKey(optimizer) {
+	const internals = optimizer.__internals_for_tests;
+	return typeof internals?.isRuntimeOptimizerEnabled === "function" && typeof internals.shouldInjectOpenAIPromptCacheKey === "function" && internals.isRuntimeOptimizerEnabled() && internals.shouldInjectOpenAIPromptCacheKey();
+}
+//#endregion
+//#region src/services/promptCacheUsage/index.ts
+function recordValue$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function nonNegativeNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
+}
+function firstNumber(...values) {
+	for (const value of values) {
+		const number = nonNegativeNumber(value);
+		if (number !== void 0) return number;
+	}
+}
+function normalizedUsage(usage) {
+	const cacheRead = nonNegativeNumber(usage.cacheRead);
+	const cacheWrite = nonNegativeNumber(usage.cacheWrite);
+	if (cacheRead === void 0 && cacheWrite === void 0) return void 0;
+	const input = nonNegativeNumber(usage.input) ?? 0;
+	return {
+		cacheRead: cacheRead ?? 0,
+		cacheWrite: cacheWrite ?? 0,
+		totalInput: input + (cacheRead ?? 0) + (cacheWrite ?? 0)
+	};
+}
+function openAiUsage(usage) {
+	const promptDetails = recordValue$1(usage.prompt_tokens_details) ?? recordValue$1(usage.promptTokensDetails);
+	const inputDetails = recordValue$1(usage.input_tokens_details) ?? recordValue$1(usage.inputTokensDetails);
+	const cacheRead = firstNumber(promptDetails?.cached_tokens, promptDetails?.cachedTokens, inputDetails?.cached_tokens, inputDetails?.cachedTokens);
+	const cacheWrite = firstNumber(promptDetails?.cache_write_tokens, promptDetails?.cacheWriteTokens, inputDetails?.cache_write_tokens, inputDetails?.cacheWriteTokens);
+	if (cacheRead === void 0 && cacheWrite === void 0) return void 0;
+	const floor = (cacheRead ?? 0) + (cacheWrite ?? 0);
+	const reportedTotal = firstNumber(usage.prompt_tokens, usage.promptTokens, usage.input_tokens, usage.inputTokens);
+	return {
+		cacheRead: cacheRead ?? 0,
+		cacheWrite: cacheWrite ?? 0,
+		totalInput: Math.max(reportedTotal ?? floor, floor)
+	};
+}
+function anthropicUsage(usage) {
+	const cacheRead = firstNumber(usage.cache_read_input_tokens, usage.cacheReadInputTokens);
+	const cacheWrite = firstNumber(usage.cache_creation_input_tokens, usage.cacheCreationInputTokens);
+	if (cacheRead === void 0 && cacheWrite === void 0) return void 0;
+	const input = firstNumber(usage.input_tokens, usage.inputTokens) ?? 0;
+	return {
+		cacheRead: cacheRead ?? 0,
+		cacheWrite: cacheWrite ?? 0,
+		totalInput: input + (cacheRead ?? 0) + (cacheWrite ?? 0)
+	};
+}
+function geminiUsage(usage) {
+	const metadata = recordValue$1(usage.usage_metadata) ?? recordValue$1(usage.usageMetadata) ?? usage;
+	const cacheRead = firstNumber(metadata.cachedContentTokenCount, metadata.cached_content_token_count);
+	if (cacheRead === void 0) return void 0;
+	const totalInput = firstNumber(metadata.promptTokenCount, metadata.prompt_token_count, usage.input_tokens, usage.inputTokens, usage.prompt_tokens, usage.promptTokens);
+	return {
+		cacheRead,
+		cacheWrite: 0,
+		totalInput: Math.max(totalInput ?? cacheRead, cacheRead)
+	};
+}
+/** Normalize only usage values carried by a provider-produced assistant message. */
+function normalizePromptCacheUsage(message) {
+	const usage = recordValue$1(recordValue$1(message)?.usage);
+	if (!usage) return void 0;
+	return normalizedUsage(usage) ?? openAiUsage(usage) ?? anthropicUsage(usage) ?? geminiUsage(usage);
+}
+//#endregion
+//#region src/services/providerPolicy/index.ts
+const ROUTING_KEY_APIS = /* @__PURE__ */ new Set([
+	"openai-completions",
+	"openai-responses",
+	"openai-codex-responses",
+	"azure-openai-responses"
+]);
+const MARKER_APIS = /* @__PURE__ */ new Set(["anthropic-messages", "bedrock-converse-stream"]);
+const AUTOMATIC_APIS = /* @__PURE__ */ new Set([
+	"google-generative-ai",
+	"google-vertex",
+	"google-vertex-anthropic"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function classifyPromptCacheCapability(model) {
+	if (model.api === "openai-responses" || model.api === "openai-completions") return model.virtualProvider === "openai" ? "key-and-long-retention" : "key-only";
+	if (model.api && ROUTING_KEY_APIS.has(model.api)) return "key-only";
+	if (model.api && MARKER_APIS.has(model.api)) return "marker-only";
+	if (model.api && AUTOMATIC_APIS.has(model.api)) return "automatic";
+	return "unknown";
+}
+function rewritePromptCacheKey(payload, api, key, enabled) {
+	if (!enabled || !api || !ROUTING_KEY_APIS.has(api) || !isRecord(payload)) return void 0;
+	const current = payload.prompt_cache_key;
+	if (typeof current !== "string" || !current.trim() || current === key) return void 0;
+	return {
+		...payload,
+		prompt_cache_key: key
+	};
+}
+function requestedPromptCacheRetention(payload) {
+	if (!isRecord(payload)) return void 0;
+	const retention = payload.prompt_cache_retention;
+	return typeof retention === "string" && retention.trim() ? retention.trim() : void 0;
+}
+//#endregion
+//#region src/services/cacheRuntime/index.ts
+function stringValue(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function recordValue(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function minorModeState(record) {
+	const state = record.state;
+	return {
+		source: record.descriptor.source,
+		id: record.descriptor.id,
+		activation: state.activation,
+		...state.modelContextVariant ? { modelContextVariant: state.modelContextVariant } : {}
+	};
+}
+function modelIdentity(ctx, payload) {
+	const model = recordValue(ctx.model);
+	const request = recordValue(payload);
+	return {
+		virtualProvider: stringValue(model?.provider),
+		virtualModel: stringValue(model?.id),
+		api: stringValue(model?.api),
+		baseUrl: stringValue(model?.baseUrl),
+		wireModel: stringValue(request?.model)
+	};
+}
+function isErrorMessage(message) {
+	const record = recordValue(message);
+	return record?.stopReason === "error" || record?.stopReason === "aborted";
+}
+function requestedRetention(payload) {
+	return requestedPromptCacheRetention(payload) ?? (process.env["PI_CACHE_RETENTION"] === "long" ? "long" : void 0);
+}
+function createCacheRuntime(dependencies, optimizer) {
+	const parentNamespaceEnvironment = new OwnedEnvironmentValue(DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV);
+	const rootSessionEnvironment = new OwnedEnvironmentValue(DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV);
+	const projectedParentNamespace = stringValue(process.env[DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV]);
+	const childProjection = stringValue(process.env[DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV]);
+	const isProjectedChild = Boolean(projectedParentNamespace && childProjection);
+	let rootSessionId;
+	let parentNamespace = projectedParentNamespace;
+	let minorModes = [];
+	const refreshParentNamespace = () => {
+		if (isProjectedChild) return parentNamespace;
+		if (!rootSessionId) return void 0;
+		const harness = getHarnessState();
+		parentNamespace = createParentPromptCacheNamespace({
+			rootSessionId,
+			compositionFingerprint: harness.compositionFingerprint,
+			majorMode: harness.majorMode,
+			domains: harness.domains,
+			profile: harness.profile,
+			persona: harness.personaFile,
+			minorModes
+		}, sha256Base64Url);
+		parentNamespaceEnvironment.set(parentNamespace);
+		rootSessionEnvironment.set(createRootSessionIdentity(rootSessionId, sha256Base64Url));
+		return parentNamespace;
+	};
+	const plugin = (cordis) => {
+		cordis.inject([DOOM_MINOR_MODE_CATALOG_SERVICE], (context) => {
+			if (isProjectedChild) return void 0;
+			const catalog = readMinorModeCatalog(context);
+			if (!catalog) return void 0;
+			const refreshModes = () => {
+				minorModes = catalog.getSnapshot().modes.map(minorModeState);
+				refreshParentNamespace();
+			};
+			refreshModes();
+			return catalog.subscribe(refreshModes);
+		});
+	};
+	return {
+		plugin,
+		events: {
+			session_start: (_event, ctx) => {
+				if (!isProjectedChild) {
+					rootSessionId = stringValue(ctx.sessionManager.getSessionId());
+					refreshParentNamespace();
+				}
+			},
+			before_provider_request: (event, ctx) => {
+				const namespace = isProjectedChild ? projectedParentNamespace : refreshParentNamespace();
+				if (!namespace) return void 0;
+				const identity = modelIdentity(ctx, event.payload);
+				const modelFingerprint = createPromptCacheModelFingerprint(identity, sha256Base64Url);
+				const key = createPromptCacheKey(namespace, isProjectedChild ? "child" : "parent", modelFingerprint, sha256Base64Url, childProjection);
+				const rewritten = rewritePromptCacheKey(event.payload, identity.api, key, optimizerAllowsPromptCacheKey(optimizer));
+				dependencies.telemetry.beginRequest({
+					capability: classifyPromptCacheCapability(identity),
+					namespace,
+					modelFingerprint,
+					requestedRetention: requestedRetention(rewritten ?? event.payload),
+					...rewritten ? { keySuffix: key.slice(-8) } : {}
+				});
+				return rewritten;
+			},
+			message_end: (event) => {
+				if (isErrorMessage(event.message)) return;
+				const usage = normalizePromptCacheUsage(event.message);
+				if (usage) dependencies.telemetry.observe(usage, dependencies.now());
+			}
+		},
+		dispose: () => {
+			parentNamespaceEnvironment.restore();
+			rootSessionEnvironment.restore();
+			dependencies.telemetry.reset();
+		}
+	};
+}
+//#endregion
+//#region src/services/promptCacheTelemetry/index.ts
+const DOOM_PROMPT_CACHE_TELEMETRY_SERVICE = "doom/prompt-cache-telemetry";
+var PromptCacheTelemetryService = class extends Service {
+	telemetry;
+	constructor(context, telemetry) {
+		super(context, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE);
+		this.telemetry = telemetry;
+	}
+	snapshot() {
+		return this.telemetry.snapshot();
+	}
+};
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/root.cli.ts
+var root_cli_default = defineRoot(async ({ pi, options }) => {
+	const dependencies = options ?? {
+		telemetry: new PromptCacheTelemetry(),
+		now: Date.now
+	};
+	const optimizer = await import("../pi-cache-optimizer-EMbP1t9X.mjs");
+	if (typeof optimizer.default !== "function") throw new Error("Pi Cache Optimizer does not provide an extension factory.");
+	await optimizer.default(pi);
+	const runtime = createCacheRuntime(dependencies, optimizer);
+	return {
+		value: runtime,
+		services: [(context) => {
+			new PromptCacheTelemetryService(context, dependencies.telemetry);
+		}, runtime.plugin],
+		onDispose: () => runtime.dispose()
+	};
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/doompi-use-cache.cli.ts
+var doompi_use_cache_cli_default = defineResource({
+	source: PACKAGE_SOURCE,
+	moduleUrl: import.meta.url,
+	skills: [CACHE_HELP_SKILL]
+});
+//#endregion
+//#region generated/pi.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const extension = definePiExtension("@agimon-ai/doompi-cache", async (context) => {
+	const scopeSession = await root_cli_default(context);
+	const contextSession = {
+		...context,
+		root: scopeSession.value
+	};
+	return {
+		...composeRootHooks(scopeSession),
+		get resources() {
+			return [at(doompi_use_cache_cli_default, contextSession)];
+		},
+		services: [...scopeSession.services ?? []]
+	};
+});
+//#endregion
+export { extension as default, extension };
+
 //# sourceMappingURL=pi.mjs.map