@agimon-ai/doompi-cache 0.0.1-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +85 -0
  3. package/dist/adapters/node/digest.cjs +2 -0
  4. package/dist/adapters/node/digest.cjs.map +1 -0
  5. package/dist/adapters/node/digest.d.cts +5 -0
  6. package/dist/adapters/node/digest.d.cts.map +1 -0
  7. package/dist/adapters/node/digest.d.mts +5 -0
  8. package/dist/adapters/node/digest.d.mts.map +1 -0
  9. package/dist/adapters/node/digest.mjs +2 -0
  10. package/dist/adapters/node/digest.mjs.map +1 -0
  11. package/dist/env.cjs +1 -0
  12. package/dist/env.d.cts +2 -0
  13. package/dist/env.d.mts +2 -0
  14. package/dist/env.mjs +1 -0
  15. package/dist/extensions/pi.cjs +3 -0
  16. package/dist/extensions/pi.cjs.map +1 -0
  17. package/dist/extensions/pi.d.cts +43 -0
  18. package/dist/extensions/pi.d.cts.map +1 -0
  19. package/dist/extensions/pi.d.mts +43 -0
  20. package/dist/extensions/pi.d.mts.map +1 -0
  21. package/dist/extensions/pi.mjs +3 -0
  22. package/dist/extensions/pi.mjs.map +1 -0
  23. package/dist/index.cjs +1 -0
  24. package/dist/index.d.cts +9 -0
  25. package/dist/index.d.mts +9 -0
  26. package/dist/index.mjs +1 -0
  27. package/dist/pi-cache-optimizer-B7B911Pz.cjs +54 -0
  28. package/dist/pi-cache-optimizer-B7B911Pz.cjs.map +1 -0
  29. package/dist/pi-cache-optimizer-CjPVk06Q.mjs +54 -0
  30. package/dist/pi-cache-optimizer-CjPVk06Q.mjs.map +1 -0
  31. package/dist/providers/promptCacheTelemetry.cjs +2 -0
  32. package/dist/providers/promptCacheTelemetry.cjs.map +1 -0
  33. package/dist/providers/promptCacheTelemetry.d.cts +18 -0
  34. package/dist/providers/promptCacheTelemetry.d.cts.map +1 -0
  35. package/dist/providers/promptCacheTelemetry.d.mts +18 -0
  36. package/dist/providers/promptCacheTelemetry.d.mts.map +1 -0
  37. package/dist/providers/promptCacheTelemetry.mjs +2 -0
  38. package/dist/providers/promptCacheTelemetry.mjs.map +1 -0
  39. package/dist/services/canonical.cjs +2 -0
  40. package/dist/services/canonical.cjs.map +1 -0
  41. package/dist/services/canonical.d.cts +10 -0
  42. package/dist/services/canonical.d.cts.map +1 -0
  43. package/dist/services/canonical.d.mts +10 -0
  44. package/dist/services/canonical.d.mts.map +1 -0
  45. package/dist/services/canonical.mjs +2 -0
  46. package/dist/services/canonical.mjs.map +1 -0
  47. package/dist/services/namespace.cjs +2 -0
  48. package/dist/services/namespace.cjs.map +1 -0
  49. package/dist/services/namespace.d.cts +10 -0
  50. package/dist/services/namespace.d.cts.map +1 -0
  51. package/dist/services/namespace.d.mts +10 -0
  52. package/dist/services/namespace.d.mts.map +1 -0
  53. package/dist/services/namespace.mjs +2 -0
  54. package/dist/services/namespace.mjs.map +1 -0
  55. package/dist/services/providerPolicy.cjs +2 -0
  56. package/dist/services/providerPolicy.cjs.map +1 -0
  57. package/dist/services/providerPolicy.d.cts +8 -0
  58. package/dist/services/providerPolicy.d.cts.map +1 -0
  59. package/dist/services/providerPolicy.d.mts +8 -0
  60. package/dist/services/providerPolicy.d.mts.map +1 -0
  61. package/dist/services/providerPolicy.mjs +2 -0
  62. package/dist/services/providerPolicy.mjs.map +1 -0
  63. package/dist/services/status.cjs +3 -0
  64. package/dist/services/status.cjs.map +1 -0
  65. package/dist/services/status.d.cts +6 -0
  66. package/dist/services/status.d.cts.map +1 -0
  67. package/dist/services/status.d.mts +6 -0
  68. package/dist/services/status.d.mts.map +1 -0
  69. package/dist/services/status.mjs +3 -0
  70. package/dist/services/status.mjs.map +1 -0
  71. package/dist/services/telemetry.cjs +2 -0
  72. package/dist/services/telemetry.cjs.map +1 -0
  73. package/dist/services/telemetry.d.cts +13 -0
  74. package/dist/services/telemetry.d.cts.map +1 -0
  75. package/dist/services/telemetry.d.mts +13 -0
  76. package/dist/services/telemetry.d.mts.map +1 -0
  77. package/dist/services/telemetry.mjs +2 -0
  78. package/dist/services/telemetry.mjs.map +1 -0
  79. package/dist/types/cache.d.cts +68 -0
  80. package/dist/types/cache.d.cts.map +1 -0
  81. package/dist/types/cache.d.mts +68 -0
  82. package/dist/types/cache.d.mts.map +1 -0
  83. package/dist/types/environment.cjs +2 -0
  84. package/dist/types/environment.cjs.map +1 -0
  85. package/dist/types/environment.d.cts +9 -0
  86. package/dist/types/environment.d.cts.map +1 -0
  87. package/dist/types/environment.d.mts +9 -0
  88. package/dist/types/environment.d.mts.map +1 -0
  89. package/dist/types/environment.mjs +2 -0
  90. package/dist/types/environment.mjs.map +1 -0
  91. package/llms.txt +11 -0
  92. package/package.json +90 -0
  93. package/src/prompts/doompi-use-cache/SKILL.md +14 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Vuong Ngo
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,85 @@
1
+ # @agimon-ai/doompi-cache
2
+
3
+ Provider prompt cache policy and deterministic routing for DoomPi
4
+
5
+ This package is a composable [DoomPi](https://www.npmjs.com/package/@agimon-ai/doompi) subsystem. Use it with the distribution or install it independently in [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent).
6
+
7
+ ## Requirements
8
+
9
+ - Node.js 22.19.0 or newer
10
+ - `@earendil-works/pi-coding-agent` 0.84.2
11
+
12
+ ## Install
13
+
14
+ ```bash
15
+ pi install npm:@agimon-ai/doompi-cache
16
+ ```
17
+
18
+ The package declares its Pi extension entry, so Pi loads it after installation. DoomPi users can include the package through their normal profile and domain composition instead.
19
+
20
+ ## Use
21
+
22
+ Run the registered command in Pi:
23
+
24
+ ```text
25
+ /doom-cache
26
+ ```
27
+
28
+ Show provider prompt cache status
29
+
30
+ ## Package behavior
31
+
32
+ DoomPi derives an opaque provider cache key from stable model-visible state, including the composition fingerprint, ordered domains, profile, persona, active minor modes, effective model, and child prompt projection. Returning to equivalent state restores the same key, but provider expiry or eviction can still make that namespace cold.
33
+
34
+ The Pi extension rewrites only a nonblank cache key already emitted for an allowlisted OpenAI-family wire API. It preserves supported retention and provider cache markers, avoids adding unsupported fields to proxies, and reports only provider-observed token usage. `/doom-cache` always reports current provider residency as `unknown`.
35
+
36
+ ## Help
37
+
38
+ The published package includes `llms.txt` and the package-owned `src/prompts/doompi-use-cache/SKILL.md`. When the DoomPi Help minor mode is active, the extension contributes `doompi-use-cache` to its live Help catalog. The contribution follows Help provider replacement and is withdrawn when the extension shuts down.
39
+
40
+ Help remains optional. Loading the standalone Pi extension does not require DoomPi Help or any other DoomPi runtime service.
41
+
42
+ To add another package-owned Help prompt, use the `scaffold-doom-prompt` feature with a `doompi-author-*` or `doompi-use-*` name and a concise description. Then link the generated `SKILL.md` from `llms.txt` and register a matching descriptor through the optional `DOOM_HELP_SERVICE` injection in the Pi adapter. Keep prompts as published resources under `src/prompts`; do not export them or copy them into `dist`.
43
+
44
+ ## Public API
45
+
46
+ ```ts
47
+ import {
48
+ createChildPromptCacheProjection,
49
+ createParentPromptCacheNamespace,
50
+ createPromptCacheKey,
51
+ PromptCacheTelemetry,
52
+ } from '@agimon-ai/doompi-cache';
53
+ import {
54
+ DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV,
55
+ DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV,
56
+ } from '@agimon-ai/doompi-cache/env';
57
+ ```
58
+
59
+ The Pi host entry is available at `@agimon-ai/doompi-cache/extensions/pi`. The root API has no import-time extension side effects.
60
+
61
+ ## Development
62
+
63
+ ```bash
64
+ pnpm build
65
+ pnpm typecheck
66
+ pnpm test
67
+ pnpm lint
68
+ pnpm exec vibe-lint check .
69
+ npm pack --dry-run
70
+ ```
71
+
72
+ The official OpenAI canary is opt-in and reports provider `cached_tokens` without treating a cold result as a deterministic failure:
73
+
74
+ ```bash
75
+ DOOMPI_CACHE_LIVE_OPENAI=1 \
76
+ OPENAI_API_KEY=... \
77
+ DOOMPI_CACHE_LIVE_OPENAI_MODEL=... \
78
+ pnpm exec vitest run tests/live/openaiPromptCache.live.test.ts
79
+ ```
80
+
81
+ Maintained by [Agimon](https://agimon.ai/about).
82
+
83
+ ## License
84
+
85
+ MIT
@@ -0,0 +1,2 @@
1
+ let e=require("node:crypto");function t(t){return(0,e.createHash)(`sha256`).update(t).digest(`base64url`)}exports.sha256Base64Url=t;
2
+ //# sourceMappingURL=digest.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"digest.cjs","names":["createHash"],"sources":["../../../src/adapters/node/digest.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nexport function sha256Base64Url(value: string): string {\n return createHash('sha256').update(value).digest('base64url');\n}\n"],"mappings":"6BAEA,SAAgB,EAAgB,EAAuB,CACrD,OAAA,EAAOA,EAAAA,WAAAA,CAAW,QAAQ,CAAC,CAAC,OAAO,CAAK,CAAC,CAAC,OAAO,WAAW,CAC9D"}
@@ -0,0 +1,5 @@
1
+ //#region src/adapters/node/digest.d.ts
2
+ declare function sha256Base64Url(value: string): string;
3
+ //#endregion
4
+ export { sha256Base64Url };
5
+ //# sourceMappingURL=digest.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"digest.d.cts","names":[],"sources":["../../../src/adapters/node/digest.ts"],"mappings":";iBAEgB,gBAAgB"}
@@ -0,0 +1,5 @@
1
+ //#region src/adapters/node/digest.d.ts
2
+ declare function sha256Base64Url(value: string): string;
3
+ //#endregion
4
+ export { sha256Base64Url };
5
+ //# sourceMappingURL=digest.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"digest.d.mts","names":[],"sources":["../../../src/adapters/node/digest.ts"],"mappings":";iBAEgB,gBAAgB"}
@@ -0,0 +1,2 @@
1
+ import{createHash as e}from"node:crypto";function t(t){return e(`sha256`).update(t).digest(`base64url`)}export{t as sha256Base64Url};
2
+ //# sourceMappingURL=digest.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"digest.mjs","names":[],"sources":["../../../src/adapters/node/digest.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nexport function sha256Base64Url(value: string): string {\n return createHash('sha256').update(value).digest('base64url');\n}\n"],"mappings":"yCAEA,SAAgB,EAAgB,EAAuB,CACrD,OAAO,EAAW,QAAQ,CAAC,CAAC,OAAO,CAAK,CAAC,CAAC,OAAO,WAAW,CAC9D"}
package/dist/env.cjs ADDED
@@ -0,0 +1 @@
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./types/environment.cjs");exports.DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV=e.DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV,exports.DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV=e.DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV,exports.DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV=e.DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV,exports.PI_CACHE_RETENTION_ENV=e.PI_CACHE_RETENTION_ENV,exports.PI_CACHE_RETENTION_LONG=e.PI_CACHE_RETENTION_LONG;
package/dist/env.d.cts ADDED
@@ -0,0 +1,2 @@
1
+ import { DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV, DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV, DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV, PI_CACHE_RETENTION_ENV, PI_CACHE_RETENTION_LONG } from "./types/environment.cjs";
2
+ export { DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV, DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV, DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV, PI_CACHE_RETENTION_ENV, PI_CACHE_RETENTION_LONG };
package/dist/env.d.mts ADDED
@@ -0,0 +1,2 @@
1
+ import { DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV, DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV, DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV, PI_CACHE_RETENTION_ENV, PI_CACHE_RETENTION_LONG } from "./types/environment.mjs";
2
+ export { DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV, DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV, DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV, PI_CACHE_RETENTION_ENV, PI_CACHE_RETENTION_LONG };
package/dist/env.mjs ADDED
@@ -0,0 +1 @@
1
+ import{DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV as e,DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV as t,DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV as n,PI_CACHE_RETENTION_ENV as r,PI_CACHE_RETENTION_LONG as i}from"./types/environment.mjs";export{e as DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV,t as DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV,n as DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV,r as PI_CACHE_RETENTION_ENV,i as PI_CACHE_RETENTION_LONG};
@@ -0,0 +1,3 @@
1
+ Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});let e=require("@agimon-ai/doompi-config/harnessStore"),t=require("@agimon-ai/doompi-extension-contracts/cordis-host"),n=require("@agimon-ai/doompi-extension-contracts/help"),r=require("@agimon-ai/doompi-extension-contracts/mode"),i=require("node:crypto"),a=require("@deepseek-ai/cordis");function o(e){let t=e.lastObservation;return t?`Last provider observation: cacheRead=${t.cacheRead}, cacheWrite=${t.cacheWrite}, input=${t.totalInput}`:`Last provider observation: none`}function s(e){return[`DoomPi provider prompt cache`,`Capability: ${e.capability}`,`Requested retention: ${e.requestedRetention??`provider default`}`,`Namespace key: ${e.keySuffix?`…${e.keySuffix}`:`unavailable`}`,o(e),`Current provider residency: unknown`,`UI CH and optimizer counters are aggregate reuse metrics, not residency guarantees.`].join(`
2
+ `)}function c(e,t){e.registerCommand(`doom-cache`,{description:`Show provider prompt cache status`,handler:async(e,n)=>{n.hasUI&&n.ui.notify(s(t.snapshot()),`info`)}})}var l=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 u(e={}){return{telemetry:e.telemetry??new l,now:e.now??Date.now}}var d=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 f(e){return(0,i.createHash)(`sha256`).update(e).digest(`base64url`)}var p=class extends a.Service{telemetry;constructor(e,t){super(e,`doom/prompt-cache-telemetry`),this.telemetry=t}snapshot(){return this.telemetry.snapshot()}};function m(e){if(!Number.isFinite(e))throw Error(`Prompt cache identity cannot contain a non-finite number.`);return Object.is(e,-0)?0:e}function h(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 m(e);if(Array.isArray(e))return e.map(e=>h(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`)]=h(r))}return n}function g(e){return JSON.stringify(h(e))}function _(e,t,n){return`${e}${n(g(t))}`}function v(e){return e?.trim().replaceAll(`\\`,`/`)||void 0}function y(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 b(e,t){return _(`dpr1_`,{version:1,rootSessionId:e},t)}function x(e,t){return _(`dpn1_`,{version:1,rootSession:b(e.rootSessionId,t),compositionFingerprint:e.compositionFingerprint??null,majorMode:e.majorMode,domains:[...e.domains],profile:e.profile??null,persona:v(e.persona)??null,minorModes:y(e.minorModes)},t)}function S(e,t){return _(`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 C(e,t,n,r,i){return _(`dpc1_`,{version:1,parentNamespace:e,scope:t,childProjection:i??null,modelFingerprint:n},r)}function w(e){let t=e.__internals_for_tests;return typeof t?.isRuntimeOptimizerEnabled==`function`&&typeof t.shouldInjectOpenAIPromptCacheKey==`function`&&t.isRuntimeOptimizerEnabled()&&t.shouldInjectOpenAIPromptCacheKey()}const T=new Set([`openai-completions`,`openai-responses`,`openai-codex-responses`,`azure-openai-responses`]),E=new Set([`anthropic-messages`,`bedrock-converse-stream`]),D=new Set([`google-generative-ai`,`google-vertex`,`google-vertex-anthropic`]);function O(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function k(e){return e.api===`openai-responses`||e.api===`openai-completions`?e.virtualProvider===`openai`?`key-and-long-retention`:`key-only`:e.api&&T.has(e.api)?`key-only`:e.api&&E.has(e.api)?`marker-only`:e.api&&D.has(e.api)?`automatic`:`unknown`}function A(e,t,n,r){if(!r||!t||!T.has(t)||!O(e))return;let i=e.prompt_cache_key;if(!(typeof i!=`string`||!i.trim()||i===n))return{...e,prompt_cache_key:n}}function j(e){if(!O(e))return;let t=e.prompt_cache_retention;return typeof t==`string`&&t.trim()?t.trim():void 0}function M(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:void 0}function N(e){return typeof e==`number`&&Number.isFinite(e)&&e>=0?e:void 0}function P(...e){for(let t of e){let e=N(t);if(e!==void 0)return e}}function F(e){let t=N(e.cacheRead),n=N(e.cacheWrite);if(t===void 0&&n===void 0)return;let r=N(e.input)??0;return{cacheRead:t??0,cacheWrite:n??0,totalInput:r+(t??0)+(n??0)}}function I(e){let t=M(e.prompt_tokens_details)??M(e.promptTokensDetails),n=M(e.input_tokens_details)??M(e.inputTokensDetails),r=P(t?.cached_tokens,t?.cachedTokens,n?.cached_tokens,n?.cachedTokens),i=P(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=P(e.prompt_tokens,e.promptTokens,e.input_tokens,e.inputTokens);return{cacheRead:r??0,cacheWrite:i??0,totalInput:Math.max(o??a,a)}}function L(e){let t=P(e.cache_read_input_tokens,e.cacheReadInputTokens),n=P(e.cache_creation_input_tokens,e.cacheCreationInputTokens);if(t===void 0&&n===void 0)return;let r=P(e.input_tokens,e.inputTokens)??0;return{cacheRead:t??0,cacheWrite:n??0,totalInput:r+(t??0)+(n??0)}}function R(e){let t=M(e.usage_metadata)??M(e.usageMetadata)??e,n=P(t.cachedContentTokenCount,t.cached_content_token_count);if(n===void 0)return;let r=P(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 z(e){let t=M(M(e)?.usage);if(t)return F(t)??I(t)??L(t)??R(t)}const B=`DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE`,V=`@agimon-ai/doompi-cache`;function H(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function U(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:void 0}function W(e){let t=e.state;return{source:e.descriptor.source,id:e.descriptor.id,activation:t.activation,...t.modelContextVariant?{modelContextVariant:t.modelContextVariant}:{}}}function G(e,t){let n=U(e.model),r=U(t);return{virtualProvider:H(n?.provider),virtualModel:H(n?.id),api:H(n?.api),baseUrl:H(n?.baseUrl),wireModel:H(r?.model)}}function K(e){let t=U(e);return t?.stopReason===`error`||t?.stopReason===`aborted`}function q(e){return j(e)??(process.env.PI_CACHE_RETENTION===`long`?`long`:void 0)}function J(t,n,i,a){let o=new d(B),s=new d(`DOOMPI_PROMPT_CACHE_ROOT_SESSION`),l=H(process.env[B]),u=H(process.env.DOOMPI_PROMPT_CACHE_CHILD_PROJECTION),p=!!(l&&u),m,h=l,g=[],_=()=>{if(p)return h;if(!m)return;let t=(0,e.getHarnessState)();return h=x({rootSessionId:m,compositionFingerprint:t.compositionFingerprint,majorMode:t.majorMode,domains:t.domains,profile:t.profile,persona:t.personaFile,minorModes:g},f),o.set(h),s.set(b(m,f)),h};return t.inject([r.DOOM_MINOR_MODE_CATALOG_SERVICE],e=>{if(p)return;let t=(0,r.readMinorModeCatalog)(e);if(!t)return;let n=()=>{g=t.getSnapshot().modes.map(W),_()};return n(),t.subscribe(n)}),c(n,i.telemetry),n.on(`session_start`,(e,t)=>{p||(m=H(t.sessionManager.getSessionId()),_())}),n.on(`before_provider_request`,(e,t)=>{let n=p?l:_();if(!n)return;let r=G(t,e.payload),o=S(r,f),s=C(n,p?`child`:`parent`,o,f,u),c=A(e.payload,r.api,s,w(a));return i.telemetry.beginRequest({capability:k(r),namespace:n,modelFingerprint:o,requestedRetention:q(c??e.payload),...c?{keySuffix:s.slice(-8)}:{}}),c}),n.on(`message_end`,e=>{if(K(e.message))return;let t=z(e.message);t&&i.telemetry.observe(t,i.now())}),()=>{o.restore(),s.restore(),i.telemetry.reset()}}function Y(e,t){e.inject([n.DOOM_HELP_SERVICE],e=>{let t=(0,n.requireDoomHelpService)(e).register({source:V,moduleUrl:require("url").pathToFileURL(__filename).href,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 p(e,t.dependencies.telemetry),yield J(e,t.pi,t.dependencies,t.optimizer)},V)}async function X(e,n=u()){let r=await Promise.resolve().then(()=>require("../pi-cache-optimizer-B7B911Pz.cjs"));if(typeof r.default!=`function`)throw Error(`Pi Cache Optimizer does not export an extension factory.`);await r.default(e);let i=await(0,t.connectDoomCordisHost)(e,V),a=i.root.plugin(Y,{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()}})())}exports.activateCacheExtension=X,exports.default=X;
3
+ //# sourceMappingURL=pi.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi.cjs","names":["#limit","#request","#observations","#environment","#name","#baseline","#ownedValue","createHash","Service","recordValue","getHarnessState","DOOM_MINOR_MODE_CATALOG_SERVICE","readMinorModeCatalog","DOOM_HELP_SERVICE","requireDoomHelpService","connectDoomCordisHost"],"sources":["../../src/services/status.ts","../../src/commands/doomCacheCommand.ts","../../src/services/telemetry.ts","../../src/container/index.ts","../../src/adapters/node/environment.ts","../../src/adapters/node/digest.ts","../../src/providers/promptCacheTelemetry.ts","../../src/services/canonical.ts","../../src/services/namespace.ts","../../src/services/optimizerPolicy.ts","../../src/services/providerPolicy.ts","../../src/services/promptCacheUsage.ts","../../src/types/environment.ts","../../src/adapters/pi/extension.ts"],"sourcesContent":["import type { PromptCacheTelemetrySnapshot } from '../types/cache.ts';\n\nfunction observationLine(snapshot: PromptCacheTelemetrySnapshot): string {\n const observation = snapshot.lastObservation;\n if (!observation) return 'Last provider observation: none';\n return `Last provider observation: cacheRead=${observation.cacheRead}, cacheWrite=${observation.cacheWrite}, input=${observation.totalInput}`;\n}\n\nexport function formatPromptCacheStatus(snapshot: PromptCacheTelemetrySnapshot): string {\n return [\n 'DoomPi provider prompt cache',\n `Capability: ${snapshot.capability}`,\n `Requested retention: ${snapshot.requestedRetention ?? 'provider default'}`,\n `Namespace key: ${snapshot.keySuffix ? `…${snapshot.keySuffix}` : 'unavailable'}`,\n observationLine(snapshot),\n 'Current provider residency: unknown',\n 'UI CH and optimizer counters are aggregate reuse metrics, not residency guarantees.',\n ].join('\\n');\n}\n","import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { formatPromptCacheStatus } from '../services/status.ts';\nimport type { PromptCacheTelemetryPort } from '../types/cache.ts';\n\nexport const COMMAND_NAME = 'doom-cache';\nexport const COMMAND_DESCRIPTION = 'Show provider prompt cache status';\n\nexport function registerCacheCommand(\n pi: Pick<ExtensionAPI, 'registerCommand'>,\n telemetry: PromptCacheTelemetryPort,\n): void {\n pi.registerCommand(COMMAND_NAME, {\n description: COMMAND_DESCRIPTION,\n handler: async (_args, ctx) => {\n if (ctx.hasUI) ctx.ui.notify(formatPromptCacheStatus(telemetry.snapshot()), 'info');\n },\n });\n}\n","import type {\n PromptCacheObservation,\n PromptCacheRequestStatus,\n PromptCacheTelemetryPort,\n PromptCacheTelemetrySnapshot,\n PromptCacheUsage,\n} from '../types/cache.ts';\n\nconst DEFAULT_OBSERVATION_LIMIT = 64;\n\nexport class PromptCacheTelemetry implements PromptCacheTelemetryPort {\n readonly #limit: number;\n #request: PromptCacheRequestStatus = { capability: 'unknown' };\n #observations: PromptCacheObservation[] = [];\n\n constructor(limit: number = DEFAULT_OBSERVATION_LIMIT) {\n if (!Number.isInteger(limit) || limit < 1)\n throw new Error('Prompt cache telemetry limit must be a positive integer.');\n this.#limit = limit;\n }\n\n beginRequest(status: PromptCacheRequestStatus): void {\n this.#request = { ...status };\n }\n\n observe(usage: PromptCacheUsage, observedAt: number): void {\n const namespace = this.#request.namespace;\n const modelFingerprint = this.#request.modelFingerprint;\n if (!namespace || !modelFingerprint) return;\n\n this.#observations.push({\n namespace,\n modelFingerprint,\n cacheRead: usage.cacheRead,\n cacheWrite: usage.cacheWrite,\n totalInput: usage.totalInput,\n observedAt,\n });\n if (this.#observations.length > this.#limit) {\n this.#observations.splice(0, this.#observations.length - this.#limit);\n }\n }\n\n snapshot(): PromptCacheTelemetrySnapshot {\n const observations = [...this.#observations];\n return {\n ...this.#request,\n residency: 'unknown',\n observations,\n ...(observations.length > 0 ? { lastObservation: observations.at(-1) } : {}),\n };\n }\n\n reset(): void {\n this.#request = { capability: 'unknown' };\n this.#observations = [];\n }\n}\n","import { PromptCacheTelemetry } from '../services/telemetry.ts';\nimport type { CacheExtensionDependencies } from '../types/extension.ts';\n\nexport function createCacheContainer(overrides: Partial<CacheExtensionDependencies> = {}): CacheExtensionDependencies {\n return {\n telemetry: overrides.telemetry ?? new PromptCacheTelemetry(),\n now: overrides.now ?? Date.now,\n };\n}\n","interface EnvironmentSnapshot {\n readonly present: boolean;\n readonly value?: string;\n}\n\nexport class OwnedEnvironmentValue {\n readonly #environment: NodeJS.ProcessEnv;\n readonly #name: string;\n readonly #baseline: EnvironmentSnapshot;\n #ownedValue?: string;\n\n constructor(name: string, environment: NodeJS.ProcessEnv = process.env) {\n this.#name = name;\n this.#environment = environment;\n this.#baseline = {\n present: Object.hasOwn(environment, name),\n value: environment[name],\n };\n }\n\n set(value: string): void {\n this.#environment[this.#name] = value;\n this.#ownedValue = value;\n }\n\n restore(): void {\n if (this.#ownedValue === undefined || this.#environment[this.#name] !== this.#ownedValue) return;\n if (this.#baseline.present) this.#environment[this.#name] = this.#baseline.value;\n else delete this.#environment[this.#name];\n this.#ownedValue = undefined;\n }\n}\n","import { createHash } from 'node:crypto';\n\nexport function sha256Base64Url(value: string): string {\n return createHash('sha256').update(value).digest('base64url');\n}\n","import { type Context, Service } from '@deepseek-ai/cordis';\nimport type { PromptCacheTelemetryPort, PromptCacheTelemetrySnapshot } from '../types/cache.ts';\n\nexport const DOOM_PROMPT_CACHE_TELEMETRY_SERVICE = 'doom/prompt-cache-telemetry';\n\nexport class PromptCacheTelemetryService extends Service {\n constructor(\n context: Context,\n private readonly telemetry: PromptCacheTelemetryPort,\n ) {\n super(context, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE);\n }\n\n snapshot(): PromptCacheTelemetrySnapshot {\n return this.telemetry.snapshot();\n }\n}\n\nexport function readPromptCacheTelemetry(context: Context): PromptCacheTelemetryService | undefined {\n return context.get(DOOM_PROMPT_CACHE_TELEMETRY_SERVICE) as PromptCacheTelemetryService | undefined;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n interface Context {\n 'doom/prompt-cache-telemetry': PromptCacheTelemetryService;\n }\n}\n","export type CanonicalValue = null | boolean | number | string | readonly CanonicalValue[] | CanonicalObject;\n\nexport interface CanonicalObject {\n readonly [key: string]: CanonicalValue;\n}\n\nfunction canonicalNumber(value: number): number {\n if (!Number.isFinite(value)) throw new Error('Prompt cache identity cannot contain a non-finite number.');\n return Object.is(value, -0) ? 0 : value;\n}\n\nexport function canonicalValue(value: unknown): CanonicalValue {\n if (value === null) return null;\n if (typeof value === 'string') return value.normalize('NFC');\n if (typeof value === 'boolean') return value;\n if (typeof value === 'number') return canonicalNumber(value);\n if (Array.isArray(value)) return value.map((entry) => canonicalValue(entry));\n if (typeof value !== 'object') throw new Error(`Unsupported prompt cache identity value: ${typeof value}.`);\n\n const record = value as Readonly<Record<string, unknown>>;\n const result: Record<string, CanonicalValue> = {};\n for (const key of Object.keys(record).sort((left, right) => left.localeCompare(right))) {\n const entry = record[key];\n if (entry !== undefined) result[key.normalize('NFC')] = canonicalValue(entry);\n }\n return result;\n}\n\nexport function canonicalJson(value: unknown): string {\n return JSON.stringify(canonicalValue(value));\n}\n","import type {\n PromptCacheChildProjection,\n PromptCacheDigest,\n PromptCacheMinorModeState,\n PromptCacheModelIdentity,\n PromptCacheParentState,\n} from '../types/cache.ts';\nimport { canonicalJson } from './canonical.ts';\n\nconst KEY_PREFIX = 'dpc1_';\nconst PARENT_PREFIX = 'dpn1_';\nconst CHILD_PREFIX = 'dch1_';\nconst ROOT_PREFIX = 'dpr1_';\nconst MODEL_PREFIX = 'dpm1_';\n\nfunction digestIdentity(prefix: string, value: unknown, digest: PromptCacheDigest): string {\n return `${prefix}${digest(canonicalJson(value))}`;\n}\n\nfunction normalizedPersona(value: string | undefined): string | undefined {\n const normalized = value?.trim().replaceAll('\\\\', '/');\n return normalized || undefined;\n}\n\nfunction activeMinorModes(modes: readonly PromptCacheMinorModeState[]): readonly Record<string, string>[] {\n return modes\n .filter(({ activation }) => activation === 'active' || activation === 'activating')\n .map(({ source, id, modelContextVariant }) => ({\n source,\n id,\n ...(modelContextVariant ? { modelContextVariant } : {}),\n }))\n .sort((left, right) => left.source.localeCompare(right.source) || left.id.localeCompare(right.id));\n}\n\nexport function createRootSessionIdentity(rootSessionId: string, digest: PromptCacheDigest): string {\n return digestIdentity(ROOT_PREFIX, { version: 1, rootSessionId }, digest);\n}\n\nexport function createParentPromptCacheNamespace(state: PromptCacheParentState, digest: PromptCacheDigest): string {\n return digestIdentity(\n PARENT_PREFIX,\n {\n version: 1,\n rootSession: createRootSessionIdentity(state.rootSessionId, digest),\n compositionFingerprint: state.compositionFingerprint ?? null,\n majorMode: state.majorMode,\n domains: [...state.domains],\n profile: state.profile ?? null,\n persona: normalizedPersona(state.persona) ?? null,\n minorModes: activeMinorModes(state.minorModes),\n },\n digest,\n );\n}\n\nexport function createChildPromptCacheProjection(\n projection: PromptCacheChildProjection,\n digest: PromptCacheDigest,\n): string {\n return digestIdentity(\n CHILD_PREFIX,\n {\n version: 1,\n systemPrompt: projection.systemPrompt ?? null,\n tools: [...projection.tools],\n excludedTools: [...projection.excludedTools].sort((left, right) => left.localeCompare(right)),\n extensions: [...projection.extensions],\n inheritProjectContext: projection.inheritProjectContext ?? null,\n inheritSkills: projection.inheritSkills ?? null,\n fanout: projection.fanout ?? null,\n structuredOutputSchema: projection.structuredOutputSchema ?? null,\n },\n digest,\n );\n}\n\nexport function createPromptCacheModelFingerprint(model: PromptCacheModelIdentity, digest: PromptCacheDigest): string {\n return digestIdentity(\n MODEL_PREFIX,\n {\n version: 1,\n virtualProvider: model.virtualProvider ?? null,\n virtualModel: model.virtualModel ?? null,\n api: model.api ?? null,\n baseUrl: model.baseUrl ?? null,\n wireModel: model.wireModel ?? null,\n },\n digest,\n );\n}\n\nexport function createPromptCacheKey(\n parentNamespace: string,\n scope: 'parent' | 'child',\n modelFingerprint: string,\n digest: PromptCacheDigest,\n childProjection?: string,\n): string {\n return digestIdentity(\n KEY_PREFIX,\n {\n version: 1,\n parentNamespace,\n scope,\n childProjection: childProjection ?? null,\n modelFingerprint,\n },\n digest,\n );\n}\n","export interface PromptCacheOptimizerRuntime {\n readonly __internals_for_tests?: {\n readonly isRuntimeOptimizerEnabled?: () => boolean;\n readonly shouldInjectOpenAIPromptCacheKey?: () => boolean;\n };\n}\n\n/** Fail closed unless the pinned optimizer confirms both runtime and key routing are enabled. */\nexport function optimizerAllowsPromptCacheKey(optimizer: PromptCacheOptimizerRuntime): boolean {\n const internals = optimizer.__internals_for_tests;\n return (\n typeof internals?.isRuntimeOptimizerEnabled === 'function' &&\n typeof internals.shouldInjectOpenAIPromptCacheKey === 'function' &&\n internals.isRuntimeOptimizerEnabled() &&\n internals.shouldInjectOpenAIPromptCacheKey()\n );\n}\n","import type { PromptCacheCapabilityClass, PromptCacheModelIdentity } from '../types/cache.ts';\n\nconst ROUTING_KEY_APIS = new Set([\n 'openai-completions',\n 'openai-responses',\n 'openai-codex-responses',\n 'azure-openai-responses',\n]);\n\nconst MARKER_APIS = new Set(['anthropic-messages', 'bedrock-converse-stream']);\nconst AUTOMATIC_APIS = new Set(['google-generative-ai', 'google-vertex', 'google-vertex-anthropic']);\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nexport function classifyPromptCacheCapability(model: PromptCacheModelIdentity): PromptCacheCapabilityClass {\n if (model.api === 'openai-responses' || model.api === 'openai-completions') {\n return model.virtualProvider === 'openai' ? 'key-and-long-retention' : 'key-only';\n }\n if (model.api && ROUTING_KEY_APIS.has(model.api)) return 'key-only';\n if (model.api && MARKER_APIS.has(model.api)) return 'marker-only';\n if (model.api && AUTOMATIC_APIS.has(model.api)) return 'automatic';\n return 'unknown';\n}\n\nexport function rewritePromptCacheKey(\n payload: unknown,\n api: string | undefined,\n key: string,\n enabled: boolean,\n): Record<string, unknown> | undefined {\n if (!enabled || !api || !ROUTING_KEY_APIS.has(api) || !isRecord(payload)) return undefined;\n const current = payload.prompt_cache_key;\n if (typeof current !== 'string' || !current.trim() || current === key) return undefined;\n return { ...payload, prompt_cache_key: key };\n}\n\nexport function requestedPromptCacheRetention(payload: unknown): string | undefined {\n if (!isRecord(payload)) return undefined;\n const retention = payload.prompt_cache_retention;\n return typeof retention === 'string' && retention.trim() ? retention.trim() : undefined;\n}\n","import type { PromptCacheUsage } from '../types/cache.ts';\n\nfunction recordValue(value: unknown): Readonly<Record<string, unknown>> | undefined {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? (value as Readonly<Record<string, unknown>>)\n : undefined;\n}\n\nfunction nonNegativeNumber(value: unknown): number | undefined {\n return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined;\n}\n\nfunction firstNumber(...values: readonly unknown[]): number | undefined {\n for (const value of values) {\n const number = nonNegativeNumber(value);\n if (number !== undefined) return number;\n }\n return undefined;\n}\n\nfunction normalizedUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const cacheRead = nonNegativeNumber(usage.cacheRead);\n const cacheWrite = nonNegativeNumber(usage.cacheWrite);\n if (cacheRead === undefined && cacheWrite === undefined) return undefined;\n const input = nonNegativeNumber(usage.input) ?? 0;\n return {\n cacheRead: cacheRead ?? 0,\n cacheWrite: cacheWrite ?? 0,\n totalInput: input + (cacheRead ?? 0) + (cacheWrite ?? 0),\n };\n}\n\nfunction openAiUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const promptDetails = recordValue(usage.prompt_tokens_details) ?? recordValue(usage.promptTokensDetails);\n const inputDetails = recordValue(usage.input_tokens_details) ?? recordValue(usage.inputTokensDetails);\n const cacheRead = firstNumber(\n promptDetails?.cached_tokens,\n promptDetails?.cachedTokens,\n inputDetails?.cached_tokens,\n inputDetails?.cachedTokens,\n );\n const cacheWrite = firstNumber(\n promptDetails?.cache_write_tokens,\n promptDetails?.cacheWriteTokens,\n inputDetails?.cache_write_tokens,\n inputDetails?.cacheWriteTokens,\n );\n if (cacheRead === undefined && cacheWrite === undefined) return undefined;\n const floor = (cacheRead ?? 0) + (cacheWrite ?? 0);\n const reportedTotal = firstNumber(usage.prompt_tokens, usage.promptTokens, usage.input_tokens, usage.inputTokens);\n return {\n cacheRead: cacheRead ?? 0,\n cacheWrite: cacheWrite ?? 0,\n totalInput: Math.max(reportedTotal ?? floor, floor),\n };\n}\n\nfunction anthropicUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const cacheRead = firstNumber(usage.cache_read_input_tokens, usage.cacheReadInputTokens);\n const cacheWrite = firstNumber(usage.cache_creation_input_tokens, usage.cacheCreationInputTokens);\n if (cacheRead === undefined && cacheWrite === undefined) return undefined;\n const input = firstNumber(usage.input_tokens, usage.inputTokens) ?? 0;\n return {\n cacheRead: cacheRead ?? 0,\n cacheWrite: cacheWrite ?? 0,\n totalInput: input + (cacheRead ?? 0) + (cacheWrite ?? 0),\n };\n}\n\nfunction geminiUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const metadata = recordValue(usage.usage_metadata) ?? recordValue(usage.usageMetadata) ?? usage;\n const cacheRead = firstNumber(metadata.cachedContentTokenCount, metadata.cached_content_token_count);\n if (cacheRead === undefined) return undefined;\n const totalInput = firstNumber(\n metadata.promptTokenCount,\n metadata.prompt_token_count,\n usage.input_tokens,\n usage.inputTokens,\n usage.prompt_tokens,\n usage.promptTokens,\n );\n return { cacheRead, cacheWrite: 0, totalInput: Math.max(totalInput ?? cacheRead, cacheRead) };\n}\n\n/** Normalize only usage values carried by a provider-produced assistant message. */\nexport function normalizePromptCacheUsage(message: unknown): PromptCacheUsage | undefined {\n const messageRecord = recordValue(message);\n const usage = recordValue(messageRecord?.usage);\n if (!usage) return undefined;\n return normalizedUsage(usage) ?? openAiUsage(usage) ?? anthropicUsage(usage) ?? geminiUsage(usage);\n}\n","export const DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV = 'DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE';\nexport const DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV = 'DOOMPI_PROMPT_CACHE_ROOT_SESSION';\nexport const DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV = 'DOOMPI_PROMPT_CACHE_CHILD_PROJECTION';\nexport const PI_CACHE_RETENTION_ENV = 'PI_CACHE_RETENTION';\nexport const PI_CACHE_RETENTION_LONG = 'long';\n","import { getHarnessState } from '@agimon-ai/doompi-config/harnessStore';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport {\n DOOM_MINOR_MODE_CATALOG_SERVICE,\n readMinorModeCatalog,\n type MinorModeRecord,\n} from '@agimon-ai/doompi-extension-contracts/mode';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { registerCacheCommand } from '../../commands/doomCacheCommand.ts';\nimport { createCacheContainer } from '../../container/index.ts';\nimport { OwnedEnvironmentValue } from '../node/environment.ts';\nimport { sha256Base64Url } from '../node/digest.ts';\nimport { PromptCacheTelemetryService } from '../../providers/promptCacheTelemetry.ts';\nimport {\n createParentPromptCacheNamespace,\n createPromptCacheKey,\n createPromptCacheModelFingerprint,\n createRootSessionIdentity,\n} from '../../services/namespace.ts';\nimport { optimizerAllowsPromptCacheKey } from '../../services/optimizerPolicy.ts';\nimport {\n classifyPromptCacheCapability,\n requestedPromptCacheRetention,\n rewritePromptCacheKey,\n} from '../../services/providerPolicy.ts';\nimport { normalizePromptCacheUsage } from '../../services/promptCacheUsage.ts';\nimport type { PromptCacheMinorModeState, PromptCacheModelIdentity } from '../../types/cache.ts';\nimport {\n DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV,\n DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV,\n DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV,\n PI_CACHE_RETENTION_ENV,\n PI_CACHE_RETENTION_LONG,\n} from '../../types/environment.ts';\nimport type { CacheExtensionDependencies } from '../../types/extension.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-cache';\nconst KEY_SUFFIX_LENGTH = 8;\n\ntype BeforeProviderEvent = { readonly payload?: unknown };\ntype MessageEndEvent = { readonly message?: unknown };\ntype MinorModeStateWithVariant = MinorModeRecord['state'] & { readonly modelContextVariant?: string };\ntype OptimizerModule = typeof import('#doompi-cache-optimizer-source');\n\nfunction stringValue(value: unknown): string | undefined {\n return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\nfunction recordValue(value: unknown): Readonly<Record<string, unknown>> | undefined {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? (value as Readonly<Record<string, unknown>>)\n : undefined;\n}\n\nfunction minorModeState(record: MinorModeRecord): PromptCacheMinorModeState {\n const state = record.state as MinorModeStateWithVariant;\n return {\n source: record.descriptor.source,\n id: record.descriptor.id,\n activation: state.activation,\n ...(state.modelContextVariant ? { modelContextVariant: state.modelContextVariant } : {}),\n };\n}\n\nfunction modelIdentity(ctx: ExtensionContext, payload: unknown): PromptCacheModelIdentity {\n const model = recordValue(ctx.model);\n const request = recordValue(payload);\n return {\n virtualProvider: stringValue(model?.provider),\n virtualModel: stringValue(model?.id),\n api: stringValue(model?.api),\n baseUrl: stringValue(model?.baseUrl),\n wireModel: stringValue(request?.model),\n };\n}\n\nfunction isErrorMessage(message: unknown): boolean {\n const record = recordValue(message);\n return record?.stopReason === 'error' || record?.stopReason === 'aborted';\n}\n\nfunction requestedRetention(payload: unknown): string | undefined {\n return (\n requestedPromptCacheRetention(payload) ??\n (process.env[PI_CACHE_RETENTION_ENV] === PI_CACHE_RETENTION_LONG ? PI_CACHE_RETENTION_LONG : undefined)\n );\n}\n\nfunction installCacheRuntime(\n cordis: Context,\n pi: ExtensionAPI,\n dependencies: CacheExtensionDependencies,\n optimizer: OptimizerModule,\n): () => void {\n const parentNamespaceEnvironment = new OwnedEnvironmentValue(DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV);\n const rootSessionEnvironment = new OwnedEnvironmentValue(DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV);\n const projectedParentNamespace = stringValue(process.env[DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV]);\n const childProjection = stringValue(process.env[DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV]);\n const isProjectedChild = Boolean(projectedParentNamespace && childProjection);\n let rootSessionId: string | undefined;\n let parentNamespace = projectedParentNamespace;\n let minorModes: readonly PromptCacheMinorModeState[] = [];\n\n const refreshParentNamespace = (): string | undefined => {\n if (isProjectedChild) return parentNamespace;\n if (!rootSessionId) return undefined;\n const harness = getHarnessState();\n parentNamespace = createParentPromptCacheNamespace(\n {\n rootSessionId,\n compositionFingerprint: harness.compositionFingerprint,\n majorMode: harness.majorMode,\n domains: harness.domains,\n profile: harness.profile,\n persona: harness.personaFile,\n minorModes,\n },\n sha256Base64Url,\n );\n parentNamespaceEnvironment.set(parentNamespace);\n rootSessionEnvironment.set(createRootSessionIdentity(rootSessionId, sha256Base64Url));\n return parentNamespace;\n };\n\n cordis.inject([DOOM_MINOR_MODE_CATALOG_SERVICE], (context) => {\n if (isProjectedChild) return undefined;\n const catalog = readMinorModeCatalog(context);\n if (!catalog) return undefined;\n const refreshModes = (): void => {\n minorModes = catalog.getSnapshot().modes.map(minorModeState);\n refreshParentNamespace();\n };\n refreshModes();\n return catalog.subscribe(refreshModes);\n });\n\n registerCacheCommand(pi, dependencies.telemetry);\n\n pi.on('session_start', (_event, ctx) => {\n if (!isProjectedChild) {\n rootSessionId = stringValue(ctx.sessionManager.getSessionId());\n refreshParentNamespace();\n }\n });\n\n pi.on('before_provider_request', (event: BeforeProviderEvent, ctx: ExtensionContext) => {\n const namespace = isProjectedChild ? projectedParentNamespace : refreshParentNamespace();\n if (!namespace) return undefined;\n\n const identity = modelIdentity(ctx, event.payload);\n const modelFingerprint = createPromptCacheModelFingerprint(identity, sha256Base64Url);\n const key = createPromptCacheKey(\n namespace,\n isProjectedChild ? 'child' : 'parent',\n modelFingerprint,\n sha256Base64Url,\n childProjection,\n );\n const rewritten = rewritePromptCacheKey(event.payload, identity.api, key, optimizerAllowsPromptCacheKey(optimizer));\n dependencies.telemetry.beginRequest({\n capability: classifyPromptCacheCapability(identity),\n namespace,\n modelFingerprint,\n requestedRetention: requestedRetention(rewritten ?? event.payload),\n ...(rewritten ? { keySuffix: key.slice(-KEY_SUFFIX_LENGTH) } : {}),\n });\n return rewritten;\n });\n\n pi.on('message_end', (event: MessageEndEvent) => {\n if (isErrorMessage(event.message)) return;\n const usage = normalizePromptCacheUsage(event.message);\n if (usage) dependencies.telemetry.observe(usage, dependencies.now());\n });\n\n return () => {\n parentNamespaceEnvironment.restore();\n rootSessionEnvironment.restore();\n dependencies.telemetry.reset();\n };\n}\n\ninterface CachePluginConfig {\n readonly pi: ExtensionAPI;\n readonly dependencies: CacheExtensionDependencies;\n readonly optimizer: OptimizerModule;\n}\n\nfunction cachePlugin(cordis: Context, config: CachePluginConfig): void {\n cordis.inject([DOOM_HELP_SERVICE], (helpContext) => {\n const contribution = requireDoomHelpService(helpContext).register({\n source: PACKAGE_SOURCE,\n moduleUrl: import.meta.url,\n skills: [\n {\n name: 'doompi-use-cache',\n description: 'Inspect DoomPi provider prompt cache policy, routing identity, and provider-observed usage.',\n },\n ],\n });\n return () => contribution.dispose();\n });\n cordis.effect(function* () {\n new PromptCacheTelemetryService(cordis, config.dependencies.telemetry);\n yield installCacheRuntime(cordis, config.pi, config.dependencies, config.optimizer);\n }, PACKAGE_SOURCE);\n}\n\nexport async function activateCacheExtension(\n pi: ExtensionAPI,\n dependencies: CacheExtensionDependencies = createCacheContainer(),\n): Promise<void> {\n const optimizer = await import('#doompi-cache-optimizer-source');\n if (typeof optimizer.default !== 'function')\n throw new Error('Pi Cache Optimizer does not export an extension factory.');\n await optimizer.default(pi);\n\n const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n const fiber = connection.root.plugin(cachePlugin, { pi, dependencies, optimizer });\n try {\n await fiber;\n } catch (error) {\n try {\n await fiber.dispose();\n } finally {\n await connection.dispose();\n }\n throw error;\n }\n\n let disposal: Promise<void> | undefined;\n pi.on(\n 'session_shutdown',\n () =>\n (disposal ??= (async () => {\n try {\n await fiber.dispose();\n } finally {\n await connection.dispose();\n }\n })()),\n );\n}\n\nexport default activateCacheExtension;\n"],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ //#region src/types/cache.d.ts
3
+ type PromptCacheCapabilityClass = 'key-and-long-retention' | 'key-only' | 'marker-only' | 'automatic' | 'unknown';
4
+ interface PromptCacheUsage {
5
+ readonly cacheRead: number;
6
+ readonly cacheWrite: number;
7
+ readonly totalInput: number;
8
+ }
9
+ interface PromptCacheObservation extends PromptCacheUsage {
10
+ readonly namespace: string;
11
+ readonly modelFingerprint: string;
12
+ readonly observedAt: number;
13
+ }
14
+ interface PromptCacheRequestStatus {
15
+ readonly capability: PromptCacheCapabilityClass;
16
+ readonly namespace?: string;
17
+ readonly modelFingerprint?: string;
18
+ readonly requestedRetention?: string;
19
+ readonly keySuffix?: string;
20
+ }
21
+ interface PromptCacheTelemetrySnapshot extends PromptCacheRequestStatus {
22
+ readonly residency: 'unknown';
23
+ readonly observations: readonly PromptCacheObservation[];
24
+ readonly lastObservation?: PromptCacheObservation;
25
+ }
26
+ interface PromptCacheTelemetryPort {
27
+ beginRequest(status: PromptCacheRequestStatus): void;
28
+ observe(usage: PromptCacheUsage, observedAt: number): void;
29
+ snapshot(): PromptCacheTelemetrySnapshot;
30
+ reset(): void;
31
+ }
32
+ //#endregion
33
+ //#region src/types/extension.d.ts
34
+ interface CacheExtensionDependencies {
35
+ readonly telemetry: PromptCacheTelemetryPort;
36
+ readonly now: () => number;
37
+ }
38
+ //#endregion
39
+ //#region src/adapters/pi/extension.d.ts
40
+ declare function activateCacheExtension(pi: ExtensionAPI, dependencies?: CacheExtensionDependencies): Promise<void>;
41
+ //#endregion
42
+ export { activateCacheExtension, activateCacheExtension as default };
43
+ //# sourceMappingURL=pi.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi.d.cts","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;;;;iBC8MW,uBACpB,IAAI,cACJ,eAAc,6BACb"}
@@ -0,0 +1,43 @@
1
+ import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ //#region src/types/cache.d.ts
3
+ type PromptCacheCapabilityClass = 'key-and-long-retention' | 'key-only' | 'marker-only' | 'automatic' | 'unknown';
4
+ interface PromptCacheUsage {
5
+ readonly cacheRead: number;
6
+ readonly cacheWrite: number;
7
+ readonly totalInput: number;
8
+ }
9
+ interface PromptCacheObservation extends PromptCacheUsage {
10
+ readonly namespace: string;
11
+ readonly modelFingerprint: string;
12
+ readonly observedAt: number;
13
+ }
14
+ interface PromptCacheRequestStatus {
15
+ readonly capability: PromptCacheCapabilityClass;
16
+ readonly namespace?: string;
17
+ readonly modelFingerprint?: string;
18
+ readonly requestedRetention?: string;
19
+ readonly keySuffix?: string;
20
+ }
21
+ interface PromptCacheTelemetrySnapshot extends PromptCacheRequestStatus {
22
+ readonly residency: 'unknown';
23
+ readonly observations: readonly PromptCacheObservation[];
24
+ readonly lastObservation?: PromptCacheObservation;
25
+ }
26
+ interface PromptCacheTelemetryPort {
27
+ beginRequest(status: PromptCacheRequestStatus): void;
28
+ observe(usage: PromptCacheUsage, observedAt: number): void;
29
+ snapshot(): PromptCacheTelemetrySnapshot;
30
+ reset(): void;
31
+ }
32
+ //#endregion
33
+ //#region src/types/extension.d.ts
34
+ interface CacheExtensionDependencies {
35
+ readonly telemetry: PromptCacheTelemetryPort;
36
+ readonly now: () => number;
37
+ }
38
+ //#endregion
39
+ //#region src/adapters/pi/extension.d.ts
40
+ declare function activateCacheExtension(pi: ExtensionAPI, dependencies?: CacheExtensionDependencies): Promise<void>;
41
+ //#endregion
42
+ export { activateCacheExtension, activateCacheExtension as default };
43
+ //# sourceMappingURL=pi.d.mts.map
@@ -0,0 +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;;;;iBC8MW,uBACpB,IAAI,cACJ,eAAc,6BACb"}
@@ -0,0 +1,3 @@
1
+ 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";function c(e){let t=e.lastObservation;return t?`Last provider observation: cacheRead=${t.cacheRead}, cacheWrite=${t.cacheWrite}, input=${t.totalInput}`:`Last provider observation: none`}function l(e){return[`DoomPi provider prompt cache`,`Capability: ${e.capability}`,`Requested retention: ${e.requestedRetention??`provider default`}`,`Namespace key: ${e.keySuffix?`…${e.keySuffix}`:`unavailable`}`,c(e),`Current provider residency: unknown`,`UI CH and optimizer counters are aggregate reuse metrics, not residency guarantees.`].join(`
2
+ `)}function u(e,t){e.registerCommand(`doom-cache`,{description:`Show provider prompt cache status`,handler:async(e,n)=>{n.hasUI&&n.ui.notify(l(t.snapshot()),`info`)}})}var d=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 f(e={}){return{telemetry:e.telemetry??new d,now:e.now??Date.now}}var p=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 m(e){return o(`sha256`).update(e).digest(`base64url`)}var h=class extends s{telemetry;constructor(e,t){super(e,`doom/prompt-cache-telemetry`),this.telemetry=t}snapshot(){return this.telemetry.snapshot()}};function g(e){if(!Number.isFinite(e))throw Error(`Prompt cache identity cannot contain a non-finite number.`);return Object.is(e,-0)?0:e}function _(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 g(e);if(Array.isArray(e))return e.map(e=>_(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`)]=_(r))}return n}function v(e){return JSON.stringify(_(e))}function y(e,t,n){return`${e}${n(v(t))}`}function b(e){return e?.trim().replaceAll(`\\`,`/`)||void 0}function x(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 S(e,t){return y(`dpr1_`,{version:1,rootSessionId:e},t)}function C(e,t){return y(`dpn1_`,{version:1,rootSession:S(e.rootSessionId,t),compositionFingerprint:e.compositionFingerprint??null,majorMode:e.majorMode,domains:[...e.domains],profile:e.profile??null,persona:b(e.persona)??null,minorModes:x(e.minorModes)},t)}function w(e,t){return y(`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 T(e,t,n,r,i){return y(`dpc1_`,{version:1,parentNamespace:e,scope:t,childProjection:i??null,modelFingerprint:n},r)}function E(e){let t=e.__internals_for_tests;return typeof t?.isRuntimeOptimizerEnabled==`function`&&typeof t.shouldInjectOpenAIPromptCacheKey==`function`&&t.isRuntimeOptimizerEnabled()&&t.shouldInjectOpenAIPromptCacheKey()}const D=new Set([`openai-completions`,`openai-responses`,`openai-codex-responses`,`azure-openai-responses`]),O=new Set([`anthropic-messages`,`bedrock-converse-stream`]),k=new Set([`google-generative-ai`,`google-vertex`,`google-vertex-anthropic`]);function A(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function j(e){return e.api===`openai-responses`||e.api===`openai-completions`?e.virtualProvider===`openai`?`key-and-long-retention`:`key-only`:e.api&&D.has(e.api)?`key-only`:e.api&&O.has(e.api)?`marker-only`:e.api&&k.has(e.api)?`automatic`:`unknown`}function M(e,t,n,r){if(!r||!t||!D.has(t)||!A(e))return;let i=e.prompt_cache_key;if(!(typeof i!=`string`||!i.trim()||i===n))return{...e,prompt_cache_key:n}}function N(e){if(!A(e))return;let t=e.prompt_cache_retention;return typeof t==`string`&&t.trim()?t.trim():void 0}function P(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:void 0}function F(e){return typeof e==`number`&&Number.isFinite(e)&&e>=0?e:void 0}function I(...e){for(let t of e){let e=F(t);if(e!==void 0)return e}}function L(e){let t=F(e.cacheRead),n=F(e.cacheWrite);if(t===void 0&&n===void 0)return;let r=F(e.input)??0;return{cacheRead:t??0,cacheWrite:n??0,totalInput:r+(t??0)+(n??0)}}function R(e){let t=P(e.prompt_tokens_details)??P(e.promptTokensDetails),n=P(e.input_tokens_details)??P(e.inputTokensDetails),r=I(t?.cached_tokens,t?.cachedTokens,n?.cached_tokens,n?.cachedTokens),i=I(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=I(e.prompt_tokens,e.promptTokens,e.input_tokens,e.inputTokens);return{cacheRead:r??0,cacheWrite:i??0,totalInput:Math.max(o??a,a)}}function z(e){let t=I(e.cache_read_input_tokens,e.cacheReadInputTokens),n=I(e.cache_creation_input_tokens,e.cacheCreationInputTokens);if(t===void 0&&n===void 0)return;let r=I(e.input_tokens,e.inputTokens)??0;return{cacheRead:t??0,cacheWrite:n??0,totalInput:r+(t??0)+(n??0)}}function B(e){let t=P(e.usage_metadata)??P(e.usageMetadata)??e,n=I(t.cachedContentTokenCount,t.cached_content_token_count);if(n===void 0)return;let r=I(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 V(e){let t=P(P(e)?.usage);if(t)return L(t)??R(t)??z(t)??B(t)}const H=`DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE`,U=`@agimon-ai/doompi-cache`;function W(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function G(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:void 0}function K(e){let t=e.state;return{source:e.descriptor.source,id:e.descriptor.id,activation:t.activation,...t.modelContextVariant?{modelContextVariant:t.modelContextVariant}:{}}}function q(e,t){let n=G(e.model),r=G(t);return{virtualProvider:W(n?.provider),virtualModel:W(n?.id),api:W(n?.api),baseUrl:W(n?.baseUrl),wireModel:W(r?.model)}}function J(e){let t=G(e);return t?.stopReason===`error`||t?.stopReason===`aborted`}function Y(e){return N(e)??(process.env.PI_CACHE_RETENTION===`long`?`long`:void 0)}function X(t,n,r,o){let s=new p(H),c=new p(`DOOMPI_PROMPT_CACHE_ROOT_SESSION`),l=W(process.env[H]),d=W(process.env.DOOMPI_PROMPT_CACHE_CHILD_PROJECTION),f=!!(l&&d),h,g=l,_=[],v=()=>{if(f)return g;if(!h)return;let t=e();return g=C({rootSessionId:h,compositionFingerprint:t.compositionFingerprint,majorMode:t.majorMode,domains:t.domains,profile:t.profile,persona:t.personaFile,minorModes:_},m),s.set(g),c.set(S(h,m)),g};return t.inject([i],e=>{if(f)return;let t=a(e);if(!t)return;let n=()=>{_=t.getSnapshot().modes.map(K),v()};return n(),t.subscribe(n)}),u(n,r.telemetry),n.on(`session_start`,(e,t)=>{f||(h=W(t.sessionManager.getSessionId()),v())}),n.on(`before_provider_request`,(e,t)=>{let n=f?l:v();if(!n)return;let i=q(t,e.payload),a=w(i,m),s=T(n,f?`child`:`parent`,a,m,d),c=M(e.payload,i.api,s,E(o));return r.telemetry.beginRequest({capability:j(i),namespace:n,modelFingerprint:a,requestedRetention:Y(c??e.payload),...c?{keySuffix:s.slice(-8)}:{}}),c}),n.on(`message_end`,e=>{if(J(e.message))return;let t=V(e.message);t&&r.telemetry.observe(t,r.now())}),()=>{s.restore(),c.restore(),r.telemetry.reset()}}function Z(e,t){e.inject([n],e=>{let t=r(e).register({source:U,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 h(e,t.dependencies.telemetry),yield X(e,t.pi,t.dependencies,t.optimizer)},U)}async function Q(e,n=f()){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,U),a=i.root.plugin(Z,{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{Q as activateCacheExtension,Q as default};
3
+ //# sourceMappingURL=pi.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi.mjs","names":["#limit","#request","#observations","#environment","#name","#baseline","#ownedValue","recordValue"],"sources":["../../src/services/status.ts","../../src/commands/doomCacheCommand.ts","../../src/services/telemetry.ts","../../src/container/index.ts","../../src/adapters/node/environment.ts","../../src/adapters/node/digest.ts","../../src/providers/promptCacheTelemetry.ts","../../src/services/canonical.ts","../../src/services/namespace.ts","../../src/services/optimizerPolicy.ts","../../src/services/providerPolicy.ts","../../src/services/promptCacheUsage.ts","../../src/types/environment.ts","../../src/adapters/pi/extension.ts"],"sourcesContent":["import type { PromptCacheTelemetrySnapshot } from '../types/cache.ts';\n\nfunction observationLine(snapshot: PromptCacheTelemetrySnapshot): string {\n const observation = snapshot.lastObservation;\n if (!observation) return 'Last provider observation: none';\n return `Last provider observation: cacheRead=${observation.cacheRead}, cacheWrite=${observation.cacheWrite}, input=${observation.totalInput}`;\n}\n\nexport function formatPromptCacheStatus(snapshot: PromptCacheTelemetrySnapshot): string {\n return [\n 'DoomPi provider prompt cache',\n `Capability: ${snapshot.capability}`,\n `Requested retention: ${snapshot.requestedRetention ?? 'provider default'}`,\n `Namespace key: ${snapshot.keySuffix ? `…${snapshot.keySuffix}` : 'unavailable'}`,\n observationLine(snapshot),\n 'Current provider residency: unknown',\n 'UI CH and optimizer counters are aggregate reuse metrics, not residency guarantees.',\n ].join('\\n');\n}\n","import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { formatPromptCacheStatus } from '../services/status.ts';\nimport type { PromptCacheTelemetryPort } from '../types/cache.ts';\n\nexport const COMMAND_NAME = 'doom-cache';\nexport const COMMAND_DESCRIPTION = 'Show provider prompt cache status';\n\nexport function registerCacheCommand(\n pi: Pick<ExtensionAPI, 'registerCommand'>,\n telemetry: PromptCacheTelemetryPort,\n): void {\n pi.registerCommand(COMMAND_NAME, {\n description: COMMAND_DESCRIPTION,\n handler: async (_args, ctx) => {\n if (ctx.hasUI) ctx.ui.notify(formatPromptCacheStatus(telemetry.snapshot()), 'info');\n },\n });\n}\n","import type {\n PromptCacheObservation,\n PromptCacheRequestStatus,\n PromptCacheTelemetryPort,\n PromptCacheTelemetrySnapshot,\n PromptCacheUsage,\n} from '../types/cache.ts';\n\nconst DEFAULT_OBSERVATION_LIMIT = 64;\n\nexport class PromptCacheTelemetry implements PromptCacheTelemetryPort {\n readonly #limit: number;\n #request: PromptCacheRequestStatus = { capability: 'unknown' };\n #observations: PromptCacheObservation[] = [];\n\n constructor(limit: number = DEFAULT_OBSERVATION_LIMIT) {\n if (!Number.isInteger(limit) || limit < 1)\n throw new Error('Prompt cache telemetry limit must be a positive integer.');\n this.#limit = limit;\n }\n\n beginRequest(status: PromptCacheRequestStatus): void {\n this.#request = { ...status };\n }\n\n observe(usage: PromptCacheUsage, observedAt: number): void {\n const namespace = this.#request.namespace;\n const modelFingerprint = this.#request.modelFingerprint;\n if (!namespace || !modelFingerprint) return;\n\n this.#observations.push({\n namespace,\n modelFingerprint,\n cacheRead: usage.cacheRead,\n cacheWrite: usage.cacheWrite,\n totalInput: usage.totalInput,\n observedAt,\n });\n if (this.#observations.length > this.#limit) {\n this.#observations.splice(0, this.#observations.length - this.#limit);\n }\n }\n\n snapshot(): PromptCacheTelemetrySnapshot {\n const observations = [...this.#observations];\n return {\n ...this.#request,\n residency: 'unknown',\n observations,\n ...(observations.length > 0 ? { lastObservation: observations.at(-1) } : {}),\n };\n }\n\n reset(): void {\n this.#request = { capability: 'unknown' };\n this.#observations = [];\n }\n}\n","import { PromptCacheTelemetry } from '../services/telemetry.ts';\nimport type { CacheExtensionDependencies } from '../types/extension.ts';\n\nexport function createCacheContainer(overrides: Partial<CacheExtensionDependencies> = {}): CacheExtensionDependencies {\n return {\n telemetry: overrides.telemetry ?? new PromptCacheTelemetry(),\n now: overrides.now ?? Date.now,\n };\n}\n","interface EnvironmentSnapshot {\n readonly present: boolean;\n readonly value?: string;\n}\n\nexport class OwnedEnvironmentValue {\n readonly #environment: NodeJS.ProcessEnv;\n readonly #name: string;\n readonly #baseline: EnvironmentSnapshot;\n #ownedValue?: string;\n\n constructor(name: string, environment: NodeJS.ProcessEnv = process.env) {\n this.#name = name;\n this.#environment = environment;\n this.#baseline = {\n present: Object.hasOwn(environment, name),\n value: environment[name],\n };\n }\n\n set(value: string): void {\n this.#environment[this.#name] = value;\n this.#ownedValue = value;\n }\n\n restore(): void {\n if (this.#ownedValue === undefined || this.#environment[this.#name] !== this.#ownedValue) return;\n if (this.#baseline.present) this.#environment[this.#name] = this.#baseline.value;\n else delete this.#environment[this.#name];\n this.#ownedValue = undefined;\n }\n}\n","import { createHash } from 'node:crypto';\n\nexport function sha256Base64Url(value: string): string {\n return createHash('sha256').update(value).digest('base64url');\n}\n","import { type Context, Service } from '@deepseek-ai/cordis';\nimport type { PromptCacheTelemetryPort, PromptCacheTelemetrySnapshot } from '../types/cache.ts';\n\nexport const DOOM_PROMPT_CACHE_TELEMETRY_SERVICE = 'doom/prompt-cache-telemetry';\n\nexport class PromptCacheTelemetryService extends Service {\n constructor(\n context: Context,\n private readonly telemetry: PromptCacheTelemetryPort,\n ) {\n super(context, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE);\n }\n\n snapshot(): PromptCacheTelemetrySnapshot {\n return this.telemetry.snapshot();\n }\n}\n\nexport function readPromptCacheTelemetry(context: Context): PromptCacheTelemetryService | undefined {\n return context.get(DOOM_PROMPT_CACHE_TELEMETRY_SERVICE) as PromptCacheTelemetryService | undefined;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n interface Context {\n 'doom/prompt-cache-telemetry': PromptCacheTelemetryService;\n }\n}\n","export type CanonicalValue = null | boolean | number | string | readonly CanonicalValue[] | CanonicalObject;\n\nexport interface CanonicalObject {\n readonly [key: string]: CanonicalValue;\n}\n\nfunction canonicalNumber(value: number): number {\n if (!Number.isFinite(value)) throw new Error('Prompt cache identity cannot contain a non-finite number.');\n return Object.is(value, -0) ? 0 : value;\n}\n\nexport function canonicalValue(value: unknown): CanonicalValue {\n if (value === null) return null;\n if (typeof value === 'string') return value.normalize('NFC');\n if (typeof value === 'boolean') return value;\n if (typeof value === 'number') return canonicalNumber(value);\n if (Array.isArray(value)) return value.map((entry) => canonicalValue(entry));\n if (typeof value !== 'object') throw new Error(`Unsupported prompt cache identity value: ${typeof value}.`);\n\n const record = value as Readonly<Record<string, unknown>>;\n const result: Record<string, CanonicalValue> = {};\n for (const key of Object.keys(record).sort((left, right) => left.localeCompare(right))) {\n const entry = record[key];\n if (entry !== undefined) result[key.normalize('NFC')] = canonicalValue(entry);\n }\n return result;\n}\n\nexport function canonicalJson(value: unknown): string {\n return JSON.stringify(canonicalValue(value));\n}\n","import type {\n PromptCacheChildProjection,\n PromptCacheDigest,\n PromptCacheMinorModeState,\n PromptCacheModelIdentity,\n PromptCacheParentState,\n} from '../types/cache.ts';\nimport { canonicalJson } from './canonical.ts';\n\nconst KEY_PREFIX = 'dpc1_';\nconst PARENT_PREFIX = 'dpn1_';\nconst CHILD_PREFIX = 'dch1_';\nconst ROOT_PREFIX = 'dpr1_';\nconst MODEL_PREFIX = 'dpm1_';\n\nfunction digestIdentity(prefix: string, value: unknown, digest: PromptCacheDigest): string {\n return `${prefix}${digest(canonicalJson(value))}`;\n}\n\nfunction normalizedPersona(value: string | undefined): string | undefined {\n const normalized = value?.trim().replaceAll('\\\\', '/');\n return normalized || undefined;\n}\n\nfunction activeMinorModes(modes: readonly PromptCacheMinorModeState[]): readonly Record<string, string>[] {\n return modes\n .filter(({ activation }) => activation === 'active' || activation === 'activating')\n .map(({ source, id, modelContextVariant }) => ({\n source,\n id,\n ...(modelContextVariant ? { modelContextVariant } : {}),\n }))\n .sort((left, right) => left.source.localeCompare(right.source) || left.id.localeCompare(right.id));\n}\n\nexport function createRootSessionIdentity(rootSessionId: string, digest: PromptCacheDigest): string {\n return digestIdentity(ROOT_PREFIX, { version: 1, rootSessionId }, digest);\n}\n\nexport function createParentPromptCacheNamespace(state: PromptCacheParentState, digest: PromptCacheDigest): string {\n return digestIdentity(\n PARENT_PREFIX,\n {\n version: 1,\n rootSession: createRootSessionIdentity(state.rootSessionId, digest),\n compositionFingerprint: state.compositionFingerprint ?? null,\n majorMode: state.majorMode,\n domains: [...state.domains],\n profile: state.profile ?? null,\n persona: normalizedPersona(state.persona) ?? null,\n minorModes: activeMinorModes(state.minorModes),\n },\n digest,\n );\n}\n\nexport function createChildPromptCacheProjection(\n projection: PromptCacheChildProjection,\n digest: PromptCacheDigest,\n): string {\n return digestIdentity(\n CHILD_PREFIX,\n {\n version: 1,\n systemPrompt: projection.systemPrompt ?? null,\n tools: [...projection.tools],\n excludedTools: [...projection.excludedTools].sort((left, right) => left.localeCompare(right)),\n extensions: [...projection.extensions],\n inheritProjectContext: projection.inheritProjectContext ?? null,\n inheritSkills: projection.inheritSkills ?? null,\n fanout: projection.fanout ?? null,\n structuredOutputSchema: projection.structuredOutputSchema ?? null,\n },\n digest,\n );\n}\n\nexport function createPromptCacheModelFingerprint(model: PromptCacheModelIdentity, digest: PromptCacheDigest): string {\n return digestIdentity(\n MODEL_PREFIX,\n {\n version: 1,\n virtualProvider: model.virtualProvider ?? null,\n virtualModel: model.virtualModel ?? null,\n api: model.api ?? null,\n baseUrl: model.baseUrl ?? null,\n wireModel: model.wireModel ?? null,\n },\n digest,\n );\n}\n\nexport function createPromptCacheKey(\n parentNamespace: string,\n scope: 'parent' | 'child',\n modelFingerprint: string,\n digest: PromptCacheDigest,\n childProjection?: string,\n): string {\n return digestIdentity(\n KEY_PREFIX,\n {\n version: 1,\n parentNamespace,\n scope,\n childProjection: childProjection ?? null,\n modelFingerprint,\n },\n digest,\n );\n}\n","export interface PromptCacheOptimizerRuntime {\n readonly __internals_for_tests?: {\n readonly isRuntimeOptimizerEnabled?: () => boolean;\n readonly shouldInjectOpenAIPromptCacheKey?: () => boolean;\n };\n}\n\n/** Fail closed unless the pinned optimizer confirms both runtime and key routing are enabled. */\nexport function optimizerAllowsPromptCacheKey(optimizer: PromptCacheOptimizerRuntime): boolean {\n const internals = optimizer.__internals_for_tests;\n return (\n typeof internals?.isRuntimeOptimizerEnabled === 'function' &&\n typeof internals.shouldInjectOpenAIPromptCacheKey === 'function' &&\n internals.isRuntimeOptimizerEnabled() &&\n internals.shouldInjectOpenAIPromptCacheKey()\n );\n}\n","import type { PromptCacheCapabilityClass, PromptCacheModelIdentity } from '../types/cache.ts';\n\nconst ROUTING_KEY_APIS = new Set([\n 'openai-completions',\n 'openai-responses',\n 'openai-codex-responses',\n 'azure-openai-responses',\n]);\n\nconst MARKER_APIS = new Set(['anthropic-messages', 'bedrock-converse-stream']);\nconst AUTOMATIC_APIS = new Set(['google-generative-ai', 'google-vertex', 'google-vertex-anthropic']);\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nexport function classifyPromptCacheCapability(model: PromptCacheModelIdentity): PromptCacheCapabilityClass {\n if (model.api === 'openai-responses' || model.api === 'openai-completions') {\n return model.virtualProvider === 'openai' ? 'key-and-long-retention' : 'key-only';\n }\n if (model.api && ROUTING_KEY_APIS.has(model.api)) return 'key-only';\n if (model.api && MARKER_APIS.has(model.api)) return 'marker-only';\n if (model.api && AUTOMATIC_APIS.has(model.api)) return 'automatic';\n return 'unknown';\n}\n\nexport function rewritePromptCacheKey(\n payload: unknown,\n api: string | undefined,\n key: string,\n enabled: boolean,\n): Record<string, unknown> | undefined {\n if (!enabled || !api || !ROUTING_KEY_APIS.has(api) || !isRecord(payload)) return undefined;\n const current = payload.prompt_cache_key;\n if (typeof current !== 'string' || !current.trim() || current === key) return undefined;\n return { ...payload, prompt_cache_key: key };\n}\n\nexport function requestedPromptCacheRetention(payload: unknown): string | undefined {\n if (!isRecord(payload)) return undefined;\n const retention = payload.prompt_cache_retention;\n return typeof retention === 'string' && retention.trim() ? retention.trim() : undefined;\n}\n","import type { PromptCacheUsage } from '../types/cache.ts';\n\nfunction recordValue(value: unknown): Readonly<Record<string, unknown>> | undefined {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? (value as Readonly<Record<string, unknown>>)\n : undefined;\n}\n\nfunction nonNegativeNumber(value: unknown): number | undefined {\n return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined;\n}\n\nfunction firstNumber(...values: readonly unknown[]): number | undefined {\n for (const value of values) {\n const number = nonNegativeNumber(value);\n if (number !== undefined) return number;\n }\n return undefined;\n}\n\nfunction normalizedUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const cacheRead = nonNegativeNumber(usage.cacheRead);\n const cacheWrite = nonNegativeNumber(usage.cacheWrite);\n if (cacheRead === undefined && cacheWrite === undefined) return undefined;\n const input = nonNegativeNumber(usage.input) ?? 0;\n return {\n cacheRead: cacheRead ?? 0,\n cacheWrite: cacheWrite ?? 0,\n totalInput: input + (cacheRead ?? 0) + (cacheWrite ?? 0),\n };\n}\n\nfunction openAiUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const promptDetails = recordValue(usage.prompt_tokens_details) ?? recordValue(usage.promptTokensDetails);\n const inputDetails = recordValue(usage.input_tokens_details) ?? recordValue(usage.inputTokensDetails);\n const cacheRead = firstNumber(\n promptDetails?.cached_tokens,\n promptDetails?.cachedTokens,\n inputDetails?.cached_tokens,\n inputDetails?.cachedTokens,\n );\n const cacheWrite = firstNumber(\n promptDetails?.cache_write_tokens,\n promptDetails?.cacheWriteTokens,\n inputDetails?.cache_write_tokens,\n inputDetails?.cacheWriteTokens,\n );\n if (cacheRead === undefined && cacheWrite === undefined) return undefined;\n const floor = (cacheRead ?? 0) + (cacheWrite ?? 0);\n const reportedTotal = firstNumber(usage.prompt_tokens, usage.promptTokens, usage.input_tokens, usage.inputTokens);\n return {\n cacheRead: cacheRead ?? 0,\n cacheWrite: cacheWrite ?? 0,\n totalInput: Math.max(reportedTotal ?? floor, floor),\n };\n}\n\nfunction anthropicUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const cacheRead = firstNumber(usage.cache_read_input_tokens, usage.cacheReadInputTokens);\n const cacheWrite = firstNumber(usage.cache_creation_input_tokens, usage.cacheCreationInputTokens);\n if (cacheRead === undefined && cacheWrite === undefined) return undefined;\n const input = firstNumber(usage.input_tokens, usage.inputTokens) ?? 0;\n return {\n cacheRead: cacheRead ?? 0,\n cacheWrite: cacheWrite ?? 0,\n totalInput: input + (cacheRead ?? 0) + (cacheWrite ?? 0),\n };\n}\n\nfunction geminiUsage(usage: Readonly<Record<string, unknown>>): PromptCacheUsage | undefined {\n const metadata = recordValue(usage.usage_metadata) ?? recordValue(usage.usageMetadata) ?? usage;\n const cacheRead = firstNumber(metadata.cachedContentTokenCount, metadata.cached_content_token_count);\n if (cacheRead === undefined) return undefined;\n const totalInput = firstNumber(\n metadata.promptTokenCount,\n metadata.prompt_token_count,\n usage.input_tokens,\n usage.inputTokens,\n usage.prompt_tokens,\n usage.promptTokens,\n );\n return { cacheRead, cacheWrite: 0, totalInput: Math.max(totalInput ?? cacheRead, cacheRead) };\n}\n\n/** Normalize only usage values carried by a provider-produced assistant message. */\nexport function normalizePromptCacheUsage(message: unknown): PromptCacheUsage | undefined {\n const messageRecord = recordValue(message);\n const usage = recordValue(messageRecord?.usage);\n if (!usage) return undefined;\n return normalizedUsage(usage) ?? openAiUsage(usage) ?? anthropicUsage(usage) ?? geminiUsage(usage);\n}\n","export const DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV = 'DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE';\nexport const DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV = 'DOOMPI_PROMPT_CACHE_ROOT_SESSION';\nexport const DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV = 'DOOMPI_PROMPT_CACHE_CHILD_PROJECTION';\nexport const PI_CACHE_RETENTION_ENV = 'PI_CACHE_RETENTION';\nexport const PI_CACHE_RETENTION_LONG = 'long';\n","import { getHarnessState } from '@agimon-ai/doompi-config/harnessStore';\nimport { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport {\n DOOM_MINOR_MODE_CATALOG_SERVICE,\n readMinorModeCatalog,\n type MinorModeRecord,\n} from '@agimon-ai/doompi-extension-contracts/mode';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { registerCacheCommand } from '../../commands/doomCacheCommand.ts';\nimport { createCacheContainer } from '../../container/index.ts';\nimport { OwnedEnvironmentValue } from '../node/environment.ts';\nimport { sha256Base64Url } from '../node/digest.ts';\nimport { PromptCacheTelemetryService } from '../../providers/promptCacheTelemetry.ts';\nimport {\n createParentPromptCacheNamespace,\n createPromptCacheKey,\n createPromptCacheModelFingerprint,\n createRootSessionIdentity,\n} from '../../services/namespace.ts';\nimport { optimizerAllowsPromptCacheKey } from '../../services/optimizerPolicy.ts';\nimport {\n classifyPromptCacheCapability,\n requestedPromptCacheRetention,\n rewritePromptCacheKey,\n} from '../../services/providerPolicy.ts';\nimport { normalizePromptCacheUsage } from '../../services/promptCacheUsage.ts';\nimport type { PromptCacheMinorModeState, PromptCacheModelIdentity } from '../../types/cache.ts';\nimport {\n DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV,\n DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV,\n DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV,\n PI_CACHE_RETENTION_ENV,\n PI_CACHE_RETENTION_LONG,\n} from '../../types/environment.ts';\nimport type { CacheExtensionDependencies } from '../../types/extension.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-cache';\nconst KEY_SUFFIX_LENGTH = 8;\n\ntype BeforeProviderEvent = { readonly payload?: unknown };\ntype MessageEndEvent = { readonly message?: unknown };\ntype MinorModeStateWithVariant = MinorModeRecord['state'] & { readonly modelContextVariant?: string };\ntype OptimizerModule = typeof import('#doompi-cache-optimizer-source');\n\nfunction stringValue(value: unknown): string | undefined {\n return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\nfunction recordValue(value: unknown): Readonly<Record<string, unknown>> | undefined {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? (value as Readonly<Record<string, unknown>>)\n : undefined;\n}\n\nfunction minorModeState(record: MinorModeRecord): PromptCacheMinorModeState {\n const state = record.state as MinorModeStateWithVariant;\n return {\n source: record.descriptor.source,\n id: record.descriptor.id,\n activation: state.activation,\n ...(state.modelContextVariant ? { modelContextVariant: state.modelContextVariant } : {}),\n };\n}\n\nfunction modelIdentity(ctx: ExtensionContext, payload: unknown): PromptCacheModelIdentity {\n const model = recordValue(ctx.model);\n const request = recordValue(payload);\n return {\n virtualProvider: stringValue(model?.provider),\n virtualModel: stringValue(model?.id),\n api: stringValue(model?.api),\n baseUrl: stringValue(model?.baseUrl),\n wireModel: stringValue(request?.model),\n };\n}\n\nfunction isErrorMessage(message: unknown): boolean {\n const record = recordValue(message);\n return record?.stopReason === 'error' || record?.stopReason === 'aborted';\n}\n\nfunction requestedRetention(payload: unknown): string | undefined {\n return (\n requestedPromptCacheRetention(payload) ??\n (process.env[PI_CACHE_RETENTION_ENV] === PI_CACHE_RETENTION_LONG ? PI_CACHE_RETENTION_LONG : undefined)\n );\n}\n\nfunction installCacheRuntime(\n cordis: Context,\n pi: ExtensionAPI,\n dependencies: CacheExtensionDependencies,\n optimizer: OptimizerModule,\n): () => void {\n const parentNamespaceEnvironment = new OwnedEnvironmentValue(DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV);\n const rootSessionEnvironment = new OwnedEnvironmentValue(DOOMPI_PROMPT_CACHE_ROOT_SESSION_ENV);\n const projectedParentNamespace = stringValue(process.env[DOOMPI_PROMPT_CACHE_PARENT_NAMESPACE_ENV]);\n const childProjection = stringValue(process.env[DOOMPI_PROMPT_CACHE_CHILD_PROJECTION_ENV]);\n const isProjectedChild = Boolean(projectedParentNamespace && childProjection);\n let rootSessionId: string | undefined;\n let parentNamespace = projectedParentNamespace;\n let minorModes: readonly PromptCacheMinorModeState[] = [];\n\n const refreshParentNamespace = (): string | undefined => {\n if (isProjectedChild) return parentNamespace;\n if (!rootSessionId) return undefined;\n const harness = getHarnessState();\n parentNamespace = createParentPromptCacheNamespace(\n {\n rootSessionId,\n compositionFingerprint: harness.compositionFingerprint,\n majorMode: harness.majorMode,\n domains: harness.domains,\n profile: harness.profile,\n persona: harness.personaFile,\n minorModes,\n },\n sha256Base64Url,\n );\n parentNamespaceEnvironment.set(parentNamespace);\n rootSessionEnvironment.set(createRootSessionIdentity(rootSessionId, sha256Base64Url));\n return parentNamespace;\n };\n\n cordis.inject([DOOM_MINOR_MODE_CATALOG_SERVICE], (context) => {\n if (isProjectedChild) return undefined;\n const catalog = readMinorModeCatalog(context);\n if (!catalog) return undefined;\n const refreshModes = (): void => {\n minorModes = catalog.getSnapshot().modes.map(minorModeState);\n refreshParentNamespace();\n };\n refreshModes();\n return catalog.subscribe(refreshModes);\n });\n\n registerCacheCommand(pi, dependencies.telemetry);\n\n pi.on('session_start', (_event, ctx) => {\n if (!isProjectedChild) {\n rootSessionId = stringValue(ctx.sessionManager.getSessionId());\n refreshParentNamespace();\n }\n });\n\n pi.on('before_provider_request', (event: BeforeProviderEvent, ctx: ExtensionContext) => {\n const namespace = isProjectedChild ? projectedParentNamespace : refreshParentNamespace();\n if (!namespace) return undefined;\n\n const identity = modelIdentity(ctx, event.payload);\n const modelFingerprint = createPromptCacheModelFingerprint(identity, sha256Base64Url);\n const key = createPromptCacheKey(\n namespace,\n isProjectedChild ? 'child' : 'parent',\n modelFingerprint,\n sha256Base64Url,\n childProjection,\n );\n const rewritten = rewritePromptCacheKey(event.payload, identity.api, key, optimizerAllowsPromptCacheKey(optimizer));\n dependencies.telemetry.beginRequest({\n capability: classifyPromptCacheCapability(identity),\n namespace,\n modelFingerprint,\n requestedRetention: requestedRetention(rewritten ?? event.payload),\n ...(rewritten ? { keySuffix: key.slice(-KEY_SUFFIX_LENGTH) } : {}),\n });\n return rewritten;\n });\n\n pi.on('message_end', (event: MessageEndEvent) => {\n if (isErrorMessage(event.message)) return;\n const usage = normalizePromptCacheUsage(event.message);\n if (usage) dependencies.telemetry.observe(usage, dependencies.now());\n });\n\n return () => {\n parentNamespaceEnvironment.restore();\n rootSessionEnvironment.restore();\n dependencies.telemetry.reset();\n };\n}\n\ninterface CachePluginConfig {\n readonly pi: ExtensionAPI;\n readonly dependencies: CacheExtensionDependencies;\n readonly optimizer: OptimizerModule;\n}\n\nfunction cachePlugin(cordis: Context, config: CachePluginConfig): void {\n cordis.inject([DOOM_HELP_SERVICE], (helpContext) => {\n const contribution = requireDoomHelpService(helpContext).register({\n source: PACKAGE_SOURCE,\n moduleUrl: import.meta.url,\n skills: [\n {\n name: 'doompi-use-cache',\n description: 'Inspect DoomPi provider prompt cache policy, routing identity, and provider-observed usage.',\n },\n ],\n });\n return () => contribution.dispose();\n });\n cordis.effect(function* () {\n new PromptCacheTelemetryService(cordis, config.dependencies.telemetry);\n yield installCacheRuntime(cordis, config.pi, config.dependencies, config.optimizer);\n }, PACKAGE_SOURCE);\n}\n\nexport async function activateCacheExtension(\n pi: ExtensionAPI,\n dependencies: CacheExtensionDependencies = createCacheContainer(),\n): Promise<void> {\n const optimizer = await import('#doompi-cache-optimizer-source');\n if (typeof optimizer.default !== 'function')\n throw new Error('Pi Cache Optimizer does not export an extension factory.');\n await optimizer.default(pi);\n\n const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n const fiber = connection.root.plugin(cachePlugin, { pi, dependencies, optimizer });\n try {\n await fiber;\n } catch (error) {\n try {\n await fiber.dispose();\n } finally {\n await connection.dispose();\n }\n throw error;\n }\n\n let disposal: Promise<void> | undefined;\n pi.on(\n 'session_shutdown',\n () =>\n (disposal ??= (async () => {\n try {\n await fiber.dispose();\n } finally {\n await connection.dispose();\n }\n })()),\n );\n}\n\nexport default activateCacheExtension;\n"],"mappings":"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"}
package/dist/index.cjs ADDED
@@ -0,0 +1 @@
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/node/digest.cjs"),t=require("./providers/promptCacheTelemetry.cjs"),n=require("./services/canonical.cjs"),r=require("./services/namespace.cjs"),i=require("./services/providerPolicy.cjs"),a=require("./services/status.cjs"),o=require("./services/telemetry.cjs");exports.DOOM_PROMPT_CACHE_TELEMETRY_SERVICE=t.DOOM_PROMPT_CACHE_TELEMETRY_SERVICE,exports.PromptCacheTelemetry=o.PromptCacheTelemetry,exports.PromptCacheTelemetryService=t.PromptCacheTelemetryService,exports.canonicalJson=n.canonicalJson,exports.canonicalValue=n.canonicalValue,exports.classifyPromptCacheCapability=i.classifyPromptCacheCapability,exports.createChildPromptCacheProjection=r.createChildPromptCacheProjection,exports.createParentPromptCacheNamespace=r.createParentPromptCacheNamespace,exports.createPromptCacheKey=r.createPromptCacheKey,exports.createPromptCacheModelFingerprint=r.createPromptCacheModelFingerprint,exports.createRootSessionIdentity=r.createRootSessionIdentity,exports.formatPromptCacheStatus=a.formatPromptCacheStatus,exports.readPromptCacheTelemetry=t.readPromptCacheTelemetry,exports.requestedPromptCacheRetention=i.requestedPromptCacheRetention,exports.rewritePromptCacheKey=i.rewritePromptCacheKey,exports.sha256Base64Url=e.sha256Base64Url;
@@ -0,0 +1,9 @@
1
+ import { sha256Base64Url } from "./adapters/node/digest.cjs";
2
+ import { PromptCacheCapabilityClass, PromptCacheChildProjection, PromptCacheDigest, PromptCacheMinorModeState, PromptCacheModelIdentity, PromptCacheObservation, PromptCacheParentState, PromptCacheRequestStatus, PromptCacheTelemetryPort, PromptCacheTelemetrySnapshot, PromptCacheUsage } from "./types/cache.cjs";
3
+ import { DOOM_PROMPT_CACHE_TELEMETRY_SERVICE, PromptCacheTelemetryService, readPromptCacheTelemetry } from "./providers/promptCacheTelemetry.cjs";
4
+ import { CanonicalObject, CanonicalValue, canonicalJson, canonicalValue } from "./services/canonical.cjs";
5
+ import { createChildPromptCacheProjection, createParentPromptCacheNamespace, createPromptCacheKey, createPromptCacheModelFingerprint, createRootSessionIdentity } from "./services/namespace.cjs";
6
+ import { classifyPromptCacheCapability, requestedPromptCacheRetention, rewritePromptCacheKey } from "./services/providerPolicy.cjs";
7
+ import { formatPromptCacheStatus } from "./services/status.cjs";
8
+ import { PromptCacheTelemetry } from "./services/telemetry.cjs";
9
+ export { type CanonicalObject, type CanonicalValue, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE, type PromptCacheCapabilityClass, type PromptCacheChildProjection, type PromptCacheDigest, type PromptCacheMinorModeState, type PromptCacheModelIdentity, type PromptCacheObservation, type PromptCacheParentState, type PromptCacheRequestStatus, PromptCacheTelemetry, type PromptCacheTelemetryPort, PromptCacheTelemetryService, type PromptCacheTelemetrySnapshot, type PromptCacheUsage, canonicalJson, canonicalValue, classifyPromptCacheCapability, createChildPromptCacheProjection, createParentPromptCacheNamespace, createPromptCacheKey, createPromptCacheModelFingerprint, createRootSessionIdentity, formatPromptCacheStatus, readPromptCacheTelemetry, requestedPromptCacheRetention, rewritePromptCacheKey, sha256Base64Url };
@@ -0,0 +1,9 @@
1
+ import { sha256Base64Url } from "./adapters/node/digest.mjs";
2
+ import { PromptCacheCapabilityClass, PromptCacheChildProjection, PromptCacheDigest, PromptCacheMinorModeState, PromptCacheModelIdentity, PromptCacheObservation, PromptCacheParentState, PromptCacheRequestStatus, PromptCacheTelemetryPort, PromptCacheTelemetrySnapshot, PromptCacheUsage } from "./types/cache.mjs";
3
+ import { DOOM_PROMPT_CACHE_TELEMETRY_SERVICE, PromptCacheTelemetryService, readPromptCacheTelemetry } from "./providers/promptCacheTelemetry.mjs";
4
+ import { CanonicalObject, CanonicalValue, canonicalJson, canonicalValue } from "./services/canonical.mjs";
5
+ import { createChildPromptCacheProjection, createParentPromptCacheNamespace, createPromptCacheKey, createPromptCacheModelFingerprint, createRootSessionIdentity } from "./services/namespace.mjs";
6
+ import { classifyPromptCacheCapability, requestedPromptCacheRetention, rewritePromptCacheKey } from "./services/providerPolicy.mjs";
7
+ import { formatPromptCacheStatus } from "./services/status.mjs";
8
+ import { PromptCacheTelemetry } from "./services/telemetry.mjs";
9
+ export { type CanonicalObject, type CanonicalValue, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE, type PromptCacheCapabilityClass, type PromptCacheChildProjection, type PromptCacheDigest, type PromptCacheMinorModeState, type PromptCacheModelIdentity, type PromptCacheObservation, type PromptCacheParentState, type PromptCacheRequestStatus, PromptCacheTelemetry, type PromptCacheTelemetryPort, PromptCacheTelemetryService, type PromptCacheTelemetrySnapshot, type PromptCacheUsage, canonicalJson, canonicalValue, classifyPromptCacheCapability, createChildPromptCacheProjection, createParentPromptCacheNamespace, createPromptCacheKey, createPromptCacheModelFingerprint, createRootSessionIdentity, formatPromptCacheStatus, readPromptCacheTelemetry, requestedPromptCacheRetention, rewritePromptCacheKey, sha256Base64Url };
package/dist/index.mjs ADDED
@@ -0,0 +1 @@
1
+ import{sha256Base64Url as e}from"./adapters/node/digest.mjs";import{DOOM_PROMPT_CACHE_TELEMETRY_SERVICE as t,PromptCacheTelemetryService as n,readPromptCacheTelemetry as r}from"./providers/promptCacheTelemetry.mjs";import{canonicalJson as i,canonicalValue as a}from"./services/canonical.mjs";import{createChildPromptCacheProjection as o,createParentPromptCacheNamespace as s,createPromptCacheKey as c,createPromptCacheModelFingerprint as l,createRootSessionIdentity as u}from"./services/namespace.mjs";import{classifyPromptCacheCapability as d,requestedPromptCacheRetention as f,rewritePromptCacheKey as p}from"./services/providerPolicy.mjs";import{formatPromptCacheStatus as m}from"./services/status.mjs";import{PromptCacheTelemetry as h}from"./services/telemetry.mjs";export{t as DOOM_PROMPT_CACHE_TELEMETRY_SERVICE,h as PromptCacheTelemetry,n as PromptCacheTelemetryService,i as canonicalJson,a as canonicalValue,d as classifyPromptCacheCapability,o as createChildPromptCacheProjection,s as createParentPromptCacheNamespace,c as createPromptCacheKey,l as createPromptCacheModelFingerprint,u as createRootSessionIdentity,m as formatPromptCacheStatus,r as readPromptCacheTelemetry,f as requestedPromptCacheRetention,p as rewritePromptCacheKey,e as sha256Base64Url};