@agimon-ai/po-cache 0.0.0-alpha.0

package/dist/index.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_promptCacheTelemetry = require("./promptCacheTelemetry-BU1fIhb8.cjs");
+exports.DOOM_PROMPT_CACHE_TELEMETRY_SERVICE = require_promptCacheTelemetry.DOOM_PROMPT_CACHE_TELEMETRY_SERVICE;
+exports.PromptCacheTelemetry = require_promptCacheTelemetry.PromptCacheTelemetry;
+exports.PromptCacheTelemetryService = require_promptCacheTelemetry.PromptCacheTelemetryService;
+exports.canonicalJson = require_promptCacheTelemetry.canonicalJson;
+exports.canonicalValue = require_promptCacheTelemetry.canonicalValue;
+exports.classifyPromptCacheCapability = require_promptCacheTelemetry.classifyPromptCacheCapability;
+exports.createChildPromptCacheProjection = require_promptCacheTelemetry.createChildPromptCacheProjection;
+exports.createParentPromptCacheNamespace = require_promptCacheTelemetry.createParentPromptCacheNamespace;
+exports.createPromptCacheKey = require_promptCacheTelemetry.createPromptCacheKey;
+exports.createPromptCacheModelFingerprint = require_promptCacheTelemetry.createPromptCacheModelFingerprint;
+exports.createRootSessionIdentity = require_promptCacheTelemetry.createRootSessionIdentity;
+exports.readPromptCacheTelemetry = require_promptCacheTelemetry.readPromptCacheTelemetry;
+exports.requestedPromptCacheRetention = require_promptCacheTelemetry.requestedPromptCacheRetention;
+exports.rewritePromptCacheKey = require_promptCacheTelemetry.rewritePromptCacheKey;
+exports.sha256Base64Url = require_promptCacheTelemetry.sha256Base64Url;

package/dist/index.d.mts

@@ -0,0 +1,116 @@
+import { Context, Service } from "@deepseek-ai/cordis";
+//#region src/services/digest/index.d.ts
+export declare function sha256Base64Url(value: string): string;
+//#endregion
+//#region src/types/cache.d.ts
+type PromptCacheCapabilityClass = 'key-and-long-retention' | 'key-only' | 'marker-only' | 'automatic' | 'unknown';
+interface PromptCacheMinorModeState {
+  readonly source: string;
+  readonly id: string;
+  readonly activation: string;
+  readonly modelContextVariant?: string;
+}
+interface PromptCacheParentState {
+  readonly rootSessionId: string;
+  readonly compositionFingerprint?: string;
+  readonly majorMode: string;
+  readonly domains: readonly string[];
+  readonly profile?: string;
+  readonly persona?: string;
+  readonly minorModes: readonly PromptCacheMinorModeState[];
+}
+interface PromptCacheChildProjection {
+  readonly systemPrompt?: string;
+  readonly tools: readonly string[];
+  readonly excludedTools: readonly string[];
+  readonly extensions: readonly string[];
+  readonly inheritProjectContext?: boolean;
+  readonly inheritSkills?: boolean;
+  readonly fanout?: boolean;
+  readonly structuredOutputSchema?: unknown;
+}
+interface PromptCacheModelIdentity {
+  readonly virtualProvider?: string;
+  readonly virtualModel?: string;
+  readonly api?: string;
+  readonly baseUrl?: string;
+  readonly wireModel?: string;
+}
+interface PromptCacheDigest {
+  (value: string): string;
+}
+interface PromptCacheUsage {
+  readonly cacheRead: number;
+  readonly cacheWrite: number;
+  readonly totalInput: number;
+}
+interface PromptCacheObservation extends PromptCacheUsage {
+  readonly namespace: string;
+  readonly modelFingerprint: string;
+  readonly observedAt: number;
+}
+interface PromptCacheRequestStatus {
+  readonly capability: PromptCacheCapabilityClass;
+  readonly namespace?: string;
+  readonly modelFingerprint?: string;
+  readonly requestedRetention?: string;
+  readonly keySuffix?: string;
+}
+interface PromptCacheTelemetrySnapshot extends PromptCacheRequestStatus {
+  readonly residency: 'unknown';
+  readonly observations: readonly PromptCacheObservation[];
+  readonly lastObservation?: PromptCacheObservation;
+}
+interface PromptCacheTelemetryPort {
+  beginRequest(status: PromptCacheRequestStatus): void;
+  observe(usage: PromptCacheUsage, observedAt: number): void;
+  snapshot(): PromptCacheTelemetrySnapshot;
+  reset(): void;
+}
+//#endregion
+//#region src/services/promptCacheTelemetry/index.d.ts
+export declare const DOOM_PROMPT_CACHE_TELEMETRY_SERVICE = "doom/prompt-cache-telemetry";
+export declare class PromptCacheTelemetryService extends Service {
+  private readonly telemetry;
+  constructor(context: Context, telemetry: PromptCacheTelemetryPort);
+  snapshot(): PromptCacheTelemetrySnapshot;
+}
+export declare function readPromptCacheTelemetry(context: Context): PromptCacheTelemetryService | undefined;
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/prompt-cache-telemetry': PromptCacheTelemetryService;
+  }
+}
+//#endregion
+//#region src/services/canonical/index.d.ts
+type CanonicalValue = null | boolean | number | string | readonly CanonicalValue[] | CanonicalObject;
+interface CanonicalObject {
+  readonly [key: string]: CanonicalValue;
+}
+export declare function canonicalValue(value: unknown): CanonicalValue;
+export declare function canonicalJson(value: unknown): string;
+//#endregion
+//#region src/services/namespace/index.d.ts
+export declare function createRootSessionIdentity(rootSessionId: string, digest: PromptCacheDigest): string;
+export declare function createParentPromptCacheNamespace(state: PromptCacheParentState, digest: PromptCacheDigest): string;
+export declare function createChildPromptCacheProjection(projection: PromptCacheChildProjection, digest: PromptCacheDigest): string;
+export declare function createPromptCacheModelFingerprint(model: PromptCacheModelIdentity, digest: PromptCacheDigest): string;
+export declare function createPromptCacheKey(parentNamespace: string, scope: 'parent' | 'child', modelFingerprint: string, digest: PromptCacheDigest, childProjection?: string): string;
+//#endregion
+//#region src/services/providerPolicy/index.d.ts
+export declare function classifyPromptCacheCapability(model: PromptCacheModelIdentity): PromptCacheCapabilityClass;
+export declare function rewritePromptCacheKey(payload: unknown, api: string | undefined, key: string, enabled: boolean): Record<string, unknown> | undefined;
+export declare function requestedPromptCacheRetention(payload: unknown): string | undefined;
+//#endregion
+//#region src/models/promptCacheTelemetry.d.ts
+export declare class PromptCacheTelemetry implements PromptCacheTelemetryPort {
+  #private;
+  constructor(limit?: number);
+  beginRequest(status: PromptCacheRequestStatus): void;
+  observe(usage: PromptCacheUsage, observedAt: number): void;
+  snapshot(): PromptCacheTelemetrySnapshot;
+  reset(): void;
+}
+//#endregion
+export type { CanonicalObject, CanonicalValue, PromptCacheCapabilityClass, PromptCacheChildProjection, PromptCacheDigest, PromptCacheMinorModeState, PromptCacheModelIdentity, PromptCacheObservation, PromptCacheParentState, PromptCacheRequestStatus, PromptCacheTelemetryPort, PromptCacheTelemetrySnapshot, PromptCacheUsage };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/services/digest/index.ts","../src/types/cache.ts","../src/services/promptCacheTelemetry/index.ts","../src/services/canonical/index.ts","../src/services/namespace/index.ts","../src/services/providerPolicy/index.ts","../src/models/promptCacheTelemetry.ts"],"mappings":";;wBAEgB,gBAAgB;;;KCFpB;UAOK;WACN;WACA;WACA;WACA;;UAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA,qBAAqB;;UAGf;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;UAGM;WACN;WACA;WACA;WACA;WACA;;UAGM;GACd;;UAGc;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;;;;qBCzEW;qBAEA,oCAAoC;mBAG5B;EAFnB,YACE,SAAS,SACQ,WAAW;EAK9B,YAAY;;wBAKE,yBAAyB,SAAS,UAAU;;YAKhD;IACR,+BAA+B;;;;;KCzBvB,6DAA6D,mBAAmB;UAE3E;YACL,cAAc;;wBAQV,eAAe,iBAAiB;wBAiBhC,cAAc;;;wBCOd,0BAA0B,uBAAuB,QAAQ;wBAIzD,iCAAiC,OAAO,wBAAwB,QAAQ;wBAiBxE,iCACd,YAAY,4BACZ,QAAQ;wBAmBM,kCAAkC,OAAO,0BAA0B,QAAQ;wBAe3E,qBACd,yBACA,2BACA,0BACA,QAAQ,mBACR;;;wBCjFc,8BAA8B,OAAO,2BAA2B;wBAUhE,sBACd,kBACA,yBACA,aACA,mBACC;wBAOa,8BAA8B;;;qBC5BjC,gCAAgC;;EAK3C,YAAY;EAMZ,aAAa,QAAQ;EAIrB,QAAQ,OAAO,kBAAkB;EAkBjC,YAAY;EAUZ"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as createChildPromptCacheProjection, c as createPromptCacheModelFingerprint, d as canonicalValue, f as DOOM_PROMPT_CACHE_TELEMETRY_SERVICE, h as sha256Base64Url, i as rewritePromptCacheKey, l as createRootSessionIdentity, m as readPromptCacheTelemetry, n as classifyPromptCacheCapability, o as createParentPromptCacheNamespace, p as PromptCacheTelemetryService, r as requestedPromptCacheRetention, s as createPromptCacheKey, t as PromptCacheTelemetry, u as canonicalJson } from "./promptCacheTelemetry-CguL1ZqT.mjs";
+export { DOOM_PROMPT_CACHE_TELEMETRY_SERVICE, PromptCacheTelemetry, PromptCacheTelemetryService, canonicalJson, canonicalValue, classifyPromptCacheCapability, createChildPromptCacheProjection, createParentPromptCacheNamespace, createPromptCacheKey, createPromptCacheModelFingerprint, createRootSessionIdentity, readPromptCacheTelemetry, requestedPromptCacheRetention, rewritePromptCacheKey, sha256Base64Url };

package/dist/promptCacheTelemetry-BU1fIhb8.cjs

@@ -0,0 +1,289 @@
+let node_crypto = require("node:crypto");
+let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
+//#region src/services/digest/index.ts
+function sha256Base64Url(value) {
+	return (0, node_crypto.createHash)("sha256").update(value).digest("base64url");
+}
+//#endregion
+//#region src/services/promptCacheTelemetry/index.ts
+const DOOM_PROMPT_CACHE_TELEMETRY_SERVICE = "doom/prompt-cache-telemetry";
+var PromptCacheTelemetryService = class extends _deepseek_ai_cordis.Service {
+	telemetry;
+	constructor(context, telemetry) {
+		super(context, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE);
+		this.telemetry = telemetry;
+	}
+	snapshot() {
+		return this.telemetry.snapshot();
+	}
+};
+function readPromptCacheTelemetry(context) {
+	return context.get(DOOM_PROMPT_CACHE_TELEMETRY_SERVICE);
+}
+//#endregion
+//#region src/services/canonical/index.ts
+function canonicalNumber(value) {
+	if (!Number.isFinite(value)) throw new Error("Prompt cache identity cannot contain a non-finite number.");
+	return Object.is(value, -0) ? 0 : value;
+}
+function canonicalValue(value) {
+	if (value === null) return null;
+	if (typeof value === "string") return value.normalize("NFC");
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number") return canonicalNumber(value);
+	if (Array.isArray(value)) return value.map((entry) => canonicalValue(entry));
+	if (typeof value !== "object") throw new Error(`Unsupported prompt cache identity value: ${typeof value}.`);
+	const record = value;
+	const result = {};
+	for (const key of Object.keys(record).sort((left, right) => left.localeCompare(right))) {
+		const entry = record[key];
+		if (entry !== void 0) result[key.normalize("NFC")] = canonicalValue(entry);
+	}
+	return result;
+}
+function canonicalJson(value) {
+	return JSON.stringify(canonicalValue(value));
+}
+//#endregion
+//#region src/services/namespace/index.ts
+const KEY_PREFIX = "dpc1_";
+const PARENT_PREFIX = "dpn1_";
+const CHILD_PREFIX = "dch1_";
+const ROOT_PREFIX = "dpr1_";
+const MODEL_PREFIX = "dpm1_";
+function digestIdentity(prefix, value, digest) {
+	return `${prefix}${digest(canonicalJson(value))}`;
+}
+function normalizedPersona(value) {
+	return value?.trim().replaceAll("\\", "/") || void 0;
+}
+function activeMinorModes(modes) {
+	return modes.filter(({ activation }) => activation === "active" || activation === "activating").map(({ source, id, modelContextVariant }) => ({
+		source,
+		id,
+		...modelContextVariant ? { modelContextVariant } : {}
+	})).sort((left, right) => left.source.localeCompare(right.source) || left.id.localeCompare(right.id));
+}
+function createRootSessionIdentity(rootSessionId, digest) {
+	return digestIdentity(ROOT_PREFIX, {
+		version: 1,
+		rootSessionId
+	}, digest);
+}
+function createParentPromptCacheNamespace(state, digest) {
+	return digestIdentity(PARENT_PREFIX, {
+		version: 1,
+		rootSession: createRootSessionIdentity(state.rootSessionId, digest),
+		compositionFingerprint: state.compositionFingerprint ?? null,
+		majorMode: state.majorMode,
+		domains: [...state.domains],
+		profile: state.profile ?? null,
+		persona: normalizedPersona(state.persona) ?? null,
+		minorModes: activeMinorModes(state.minorModes)
+	}, digest);
+}
+function createChildPromptCacheProjection(projection, digest) {
+	return digestIdentity(CHILD_PREFIX, {
+		version: 1,
+		systemPrompt: projection.systemPrompt ?? null,
+		tools: [...projection.tools],
+		excludedTools: [...projection.excludedTools].sort((left, right) => left.localeCompare(right)),
+		extensions: [...projection.extensions],
+		inheritProjectContext: projection.inheritProjectContext ?? null,
+		inheritSkills: projection.inheritSkills ?? null,
+		fanout: projection.fanout ?? null,
+		structuredOutputSchema: projection.structuredOutputSchema ?? null
+	}, digest);
+}
+function createPromptCacheModelFingerprint(model, digest) {
+	return digestIdentity(MODEL_PREFIX, {
+		version: 1,
+		virtualProvider: model.virtualProvider ?? null,
+		virtualModel: model.virtualModel ?? null,
+		api: model.api ?? null,
+		baseUrl: model.baseUrl ?? null,
+		wireModel: model.wireModel ?? null
+	}, digest);
+}
+function createPromptCacheKey(parentNamespace, scope, modelFingerprint, digest, childProjection) {
+	return digestIdentity(KEY_PREFIX, {
+		version: 1,
+		parentNamespace,
+		scope,
+		childProjection: childProjection ?? null,
+		modelFingerprint
+	}, digest);
+}
+//#endregion
+//#region src/services/providerPolicy/index.ts
+const ROUTING_KEY_APIS = /* @__PURE__ */ new Set([
+	"openai-completions",
+	"openai-responses",
+	"openai-codex-responses",
+	"azure-openai-responses"
+]);
+const MARKER_APIS = /* @__PURE__ */ new Set(["anthropic-messages", "bedrock-converse-stream"]);
+const AUTOMATIC_APIS = /* @__PURE__ */ new Set([
+	"google-generative-ai",
+	"google-vertex",
+	"google-vertex-anthropic"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function classifyPromptCacheCapability(model) {
+	if (model.api === "openai-responses" || model.api === "openai-completions") return model.virtualProvider === "openai" ? "key-and-long-retention" : "key-only";
+	if (model.api && ROUTING_KEY_APIS.has(model.api)) return "key-only";
+	if (model.api && MARKER_APIS.has(model.api)) return "marker-only";
+	if (model.api && AUTOMATIC_APIS.has(model.api)) return "automatic";
+	return "unknown";
+}
+function rewritePromptCacheKey(payload, api, key, enabled) {
+	if (!enabled || !api || !ROUTING_KEY_APIS.has(api) || !isRecord(payload)) return void 0;
+	const current = payload.prompt_cache_key;
+	if (typeof current !== "string" || !current.trim() || current === key) return void 0;
+	return {
+		...payload,
+		prompt_cache_key: key
+	};
+}
+function requestedPromptCacheRetention(payload) {
+	if (!isRecord(payload)) return void 0;
+	const retention = payload.prompt_cache_retention;
+	return typeof retention === "string" && retention.trim() ? retention.trim() : void 0;
+}
+//#endregion
+//#region src/models/promptCacheTelemetry.ts
+const DEFAULT_OBSERVATION_LIMIT = 64;
+var PromptCacheTelemetry = class {
+	#limit;
+	#request = { capability: "unknown" };
+	#observations = [];
+	constructor(limit = DEFAULT_OBSERVATION_LIMIT) {
+		if (!Number.isInteger(limit) || limit < 1) throw new Error("Prompt cache telemetry limit must be a positive integer.");
+		this.#limit = limit;
+	}
+	beginRequest(status) {
+		this.#request = { ...status };
+	}
+	observe(usage, observedAt) {
+		const namespace = this.#request.namespace;
+		const modelFingerprint = this.#request.modelFingerprint;
+		if (!namespace || !modelFingerprint) return;
+		this.#observations.push({
+			namespace,
+			modelFingerprint,
+			cacheRead: usage.cacheRead,
+			cacheWrite: usage.cacheWrite,
+			totalInput: usage.totalInput,
+			observedAt
+		});
+		if (this.#observations.length > this.#limit) this.#observations.splice(0, this.#observations.length - this.#limit);
+	}
+	snapshot() {
+		const observations = [...this.#observations];
+		return {
+			...this.#request,
+			residency: "unknown",
+			observations,
+			...observations.length > 0 ? { lastObservation: observations.at(-1) } : {}
+		};
+	}
+	reset() {
+		this.#request = { capability: "unknown" };
+		this.#observations = [];
+	}
+};
+//#endregion
+Object.defineProperty(exports, "DOOM_PROMPT_CACHE_TELEMETRY_SERVICE", {
+	enumerable: true,
+	get: function() {
+		return DOOM_PROMPT_CACHE_TELEMETRY_SERVICE;
+	}
+});
+Object.defineProperty(exports, "PromptCacheTelemetry", {
+	enumerable: true,
+	get: function() {
+		return PromptCacheTelemetry;
+	}
+});
+Object.defineProperty(exports, "PromptCacheTelemetryService", {
+	enumerable: true,
+	get: function() {
+		return PromptCacheTelemetryService;
+	}
+});
+Object.defineProperty(exports, "canonicalJson", {
+	enumerable: true,
+	get: function() {
+		return canonicalJson;
+	}
+});
+Object.defineProperty(exports, "canonicalValue", {
+	enumerable: true,
+	get: function() {
+		return canonicalValue;
+	}
+});
+Object.defineProperty(exports, "classifyPromptCacheCapability", {
+	enumerable: true,
+	get: function() {
+		return classifyPromptCacheCapability;
+	}
+});
+Object.defineProperty(exports, "createChildPromptCacheProjection", {
+	enumerable: true,
+	get: function() {
+		return createChildPromptCacheProjection;
+	}
+});
+Object.defineProperty(exports, "createParentPromptCacheNamespace", {
+	enumerable: true,
+	get: function() {
+		return createParentPromptCacheNamespace;
+	}
+});
+Object.defineProperty(exports, "createPromptCacheKey", {
+	enumerable: true,
+	get: function() {
+		return createPromptCacheKey;
+	}
+});
+Object.defineProperty(exports, "createPromptCacheModelFingerprint", {
+	enumerable: true,
+	get: function() {
+		return createPromptCacheModelFingerprint;
+	}
+});
+Object.defineProperty(exports, "createRootSessionIdentity", {
+	enumerable: true,
+	get: function() {
+		return createRootSessionIdentity;
+	}
+});
+Object.defineProperty(exports, "readPromptCacheTelemetry", {
+	enumerable: true,
+	get: function() {
+		return readPromptCacheTelemetry;
+	}
+});
+Object.defineProperty(exports, "requestedPromptCacheRetention", {
+	enumerable: true,
+	get: function() {
+		return requestedPromptCacheRetention;
+	}
+});
+Object.defineProperty(exports, "rewritePromptCacheKey", {
+	enumerable: true,
+	get: function() {
+		return rewritePromptCacheKey;
+	}
+});
+Object.defineProperty(exports, "sha256Base64Url", {
+	enumerable: true,
+	get: function() {
+		return sha256Base64Url;
+	}
+});
+
+//# sourceMappingURL=promptCacheTelemetry-BU1fIhb8.cjs.map

package/dist/promptCacheTelemetry-BU1fIhb8.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptCacheTelemetry-BU1fIhb8.cjs","names":["createHash","Service"],"sources":["../src/services/digest/index.ts","../src/services/promptCacheTelemetry/index.ts","../src/services/canonical/index.ts","../src/services/namespace/index.ts","../src/services/providerPolicy/index.ts","../src/models/promptCacheTelemetry.ts"],"sourcesContent":["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';\n\nimport type { PromptCacheTelemetryPort, PromptCacheTelemetrySnapshot } from '../../types/cache';\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';\nimport { canonicalJson } from '../canonical';\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","import type { PromptCacheCapabilityClass, PromptCacheModelIdentity } from '../../types/cache';\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 {\n  PromptCacheObservation,\n  PromptCacheRequestStatus,\n  PromptCacheTelemetryPort,\n  PromptCacheTelemetrySnapshot,\n  PromptCacheUsage,\n} from '../types/cache';\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"],"mappings":"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"}

package/dist/promptCacheTelemetry-CguL1ZqT.mjs

@@ -0,0 +1,200 @@
+import { createHash } from "node:crypto";
+import { Service } from "@deepseek-ai/cordis";
+//#region src/services/digest/index.ts
+function sha256Base64Url(value) {
+	return createHash("sha256").update(value).digest("base64url");
+}
+//#endregion
+//#region src/services/promptCacheTelemetry/index.ts
+const DOOM_PROMPT_CACHE_TELEMETRY_SERVICE = "doom/prompt-cache-telemetry";
+var PromptCacheTelemetryService = class extends Service {
+	telemetry;
+	constructor(context, telemetry) {
+		super(context, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE);
+		this.telemetry = telemetry;
+	}
+	snapshot() {
+		return this.telemetry.snapshot();
+	}
+};
+function readPromptCacheTelemetry(context) {
+	return context.get(DOOM_PROMPT_CACHE_TELEMETRY_SERVICE);
+}
+//#endregion
+//#region src/services/canonical/index.ts
+function canonicalNumber(value) {
+	if (!Number.isFinite(value)) throw new Error("Prompt cache identity cannot contain a non-finite number.");
+	return Object.is(value, -0) ? 0 : value;
+}
+function canonicalValue(value) {
+	if (value === null) return null;
+	if (typeof value === "string") return value.normalize("NFC");
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number") return canonicalNumber(value);
+	if (Array.isArray(value)) return value.map((entry) => canonicalValue(entry));
+	if (typeof value !== "object") throw new Error(`Unsupported prompt cache identity value: ${typeof value}.`);
+	const record = value;
+	const result = {};
+	for (const key of Object.keys(record).sort((left, right) => left.localeCompare(right))) {
+		const entry = record[key];
+		if (entry !== void 0) result[key.normalize("NFC")] = canonicalValue(entry);
+	}
+	return result;
+}
+function canonicalJson(value) {
+	return JSON.stringify(canonicalValue(value));
+}
+//#endregion
+//#region src/services/namespace/index.ts
+const KEY_PREFIX = "dpc1_";
+const PARENT_PREFIX = "dpn1_";
+const CHILD_PREFIX = "dch1_";
+const ROOT_PREFIX = "dpr1_";
+const MODEL_PREFIX = "dpm1_";
+function digestIdentity(prefix, value, digest) {
+	return `${prefix}${digest(canonicalJson(value))}`;
+}
+function normalizedPersona(value) {
+	return value?.trim().replaceAll("\\", "/") || void 0;
+}
+function activeMinorModes(modes) {
+	return modes.filter(({ activation }) => activation === "active" || activation === "activating").map(({ source, id, modelContextVariant }) => ({
+		source,
+		id,
+		...modelContextVariant ? { modelContextVariant } : {}
+	})).sort((left, right) => left.source.localeCompare(right.source) || left.id.localeCompare(right.id));
+}
+function createRootSessionIdentity(rootSessionId, digest) {
+	return digestIdentity(ROOT_PREFIX, {
+		version: 1,
+		rootSessionId
+	}, digest);
+}
+function createParentPromptCacheNamespace(state, digest) {
+	return digestIdentity(PARENT_PREFIX, {
+		version: 1,
+		rootSession: createRootSessionIdentity(state.rootSessionId, digest),
+		compositionFingerprint: state.compositionFingerprint ?? null,
+		majorMode: state.majorMode,
+		domains: [...state.domains],
+		profile: state.profile ?? null,
+		persona: normalizedPersona(state.persona) ?? null,
+		minorModes: activeMinorModes(state.minorModes)
+	}, digest);
+}
+function createChildPromptCacheProjection(projection, digest) {
+	return digestIdentity(CHILD_PREFIX, {
+		version: 1,
+		systemPrompt: projection.systemPrompt ?? null,
+		tools: [...projection.tools],
+		excludedTools: [...projection.excludedTools].sort((left, right) => left.localeCompare(right)),
+		extensions: [...projection.extensions],
+		inheritProjectContext: projection.inheritProjectContext ?? null,
+		inheritSkills: projection.inheritSkills ?? null,
+		fanout: projection.fanout ?? null,
+		structuredOutputSchema: projection.structuredOutputSchema ?? null
+	}, digest);
+}
+function createPromptCacheModelFingerprint(model, digest) {
+	return digestIdentity(MODEL_PREFIX, {
+		version: 1,
+		virtualProvider: model.virtualProvider ?? null,
+		virtualModel: model.virtualModel ?? null,
+		api: model.api ?? null,
+		baseUrl: model.baseUrl ?? null,
+		wireModel: model.wireModel ?? null
+	}, digest);
+}
+function createPromptCacheKey(parentNamespace, scope, modelFingerprint, digest, childProjection) {
+	return digestIdentity(KEY_PREFIX, {
+		version: 1,
+		parentNamespace,
+		scope,
+		childProjection: childProjection ?? null,
+		modelFingerprint
+	}, digest);
+}
+//#endregion
+//#region src/services/providerPolicy/index.ts
+const ROUTING_KEY_APIS = /* @__PURE__ */ new Set([
+	"openai-completions",
+	"openai-responses",
+	"openai-codex-responses",
+	"azure-openai-responses"
+]);
+const MARKER_APIS = /* @__PURE__ */ new Set(["anthropic-messages", "bedrock-converse-stream"]);
+const AUTOMATIC_APIS = /* @__PURE__ */ new Set([
+	"google-generative-ai",
+	"google-vertex",
+	"google-vertex-anthropic"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function classifyPromptCacheCapability(model) {
+	if (model.api === "openai-responses" || model.api === "openai-completions") return model.virtualProvider === "openai" ? "key-and-long-retention" : "key-only";
+	if (model.api && ROUTING_KEY_APIS.has(model.api)) return "key-only";
+	if (model.api && MARKER_APIS.has(model.api)) return "marker-only";
+	if (model.api && AUTOMATIC_APIS.has(model.api)) return "automatic";
+	return "unknown";
+}
+function rewritePromptCacheKey(payload, api, key, enabled) {
+	if (!enabled || !api || !ROUTING_KEY_APIS.has(api) || !isRecord(payload)) return void 0;
+	const current = payload.prompt_cache_key;
+	if (typeof current !== "string" || !current.trim() || current === key) return void 0;
+	return {
+		...payload,
+		prompt_cache_key: key
+	};
+}
+function requestedPromptCacheRetention(payload) {
+	if (!isRecord(payload)) return void 0;
+	const retention = payload.prompt_cache_retention;
+	return typeof retention === "string" && retention.trim() ? retention.trim() : void 0;
+}
+//#endregion
+//#region src/models/promptCacheTelemetry.ts
+const DEFAULT_OBSERVATION_LIMIT = 64;
+var PromptCacheTelemetry = class {
+	#limit;
+	#request = { capability: "unknown" };
+	#observations = [];
+	constructor(limit = DEFAULT_OBSERVATION_LIMIT) {
+		if (!Number.isInteger(limit) || limit < 1) throw new Error("Prompt cache telemetry limit must be a positive integer.");
+		this.#limit = limit;
+	}
+	beginRequest(status) {
+		this.#request = { ...status };
+	}
+	observe(usage, observedAt) {
+		const namespace = this.#request.namespace;
+		const modelFingerprint = this.#request.modelFingerprint;
+		if (!namespace || !modelFingerprint) return;
+		this.#observations.push({
+			namespace,
+			modelFingerprint,
+			cacheRead: usage.cacheRead,
+			cacheWrite: usage.cacheWrite,
+			totalInput: usage.totalInput,
+			observedAt
+		});
+		if (this.#observations.length > this.#limit) this.#observations.splice(0, this.#observations.length - this.#limit);
+	}
+	snapshot() {
+		const observations = [...this.#observations];
+		return {
+			...this.#request,
+			residency: "unknown",
+			observations,
+			...observations.length > 0 ? { lastObservation: observations.at(-1) } : {}
+		};
+	}
+	reset() {
+		this.#request = { capability: "unknown" };
+		this.#observations = [];
+	}
+};
+//#endregion
+export { createChildPromptCacheProjection as a, createPromptCacheModelFingerprint as c, canonicalValue as d, DOOM_PROMPT_CACHE_TELEMETRY_SERVICE as f, sha256Base64Url as h, rewritePromptCacheKey as i, createRootSessionIdentity as l, readPromptCacheTelemetry as m, classifyPromptCacheCapability as n, createParentPromptCacheNamespace as o, PromptCacheTelemetryService as p, requestedPromptCacheRetention as r, createPromptCacheKey as s, PromptCacheTelemetry as t, canonicalJson as u };
+
+//# sourceMappingURL=promptCacheTelemetry-CguL1ZqT.mjs.map