@evalops/maestro 0.10.51 → 0.10.53

package/dist/agent/profile-loader.js

@@ -0,0 +1,115 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { extname, join } from "node:path";
+import YAML from "yaml";
+import { PATHS } from "../config/constants.js";
+import { isRecord } from "../utils/json.js";
+import { parseAgentProfileLevel, } from "./profiles.js";
+import { parseSubagentType } from "./subagent-specs.js";
+const REASONING_EFFORTS = new Set([
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+]);
+function requiredString(value, path) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`${path} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function positiveInteger(value, path) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
+        throw new Error(`${path} must be a positive integer`);
+    }
+    return value;
+}
+function invocation(value, path, options = {}) {
+    if (!isRecord(value))
+        throw new Error(`${path} must be an object`);
+    const reasoningEffort = requiredString(value.reasoningEffort, `${path}.reasoningEffort`);
+    if (!REASONING_EFFORTS.has(reasoningEffort)) {
+        throw new Error(`${path}.reasoningEffort is invalid`);
+    }
+    if (options.requireReadOnly && value.readOnly !== true) {
+        throw new Error(`${path}.readOnly must be true`);
+    }
+    return Object.freeze({
+        provider: requiredString(value.provider, `${path}.provider`),
+        model: requiredString(value.model, `${path}.model`),
+        reasoningEffort,
+        ...(value.readOnly === true ? { readOnly: true } : {}),
+    });
+}
+function parseProfile(value, source) {
+    if (!isRecord(value))
+        throw new Error(`${source} must contain an object`);
+    const parsedLevel = parseAgentProfileLevel(requiredString(value.level, `${source}.level`));
+    if (!parsedLevel)
+        throw new Error(`${source}.level is invalid`);
+    const version = positiveInteger(value.version, `${source}.version`);
+    const fallbackLevels = Array.isArray(value.fallbackLevels)
+        ? value.fallbackLevels.map((entry, index) => {
+            const level = parseAgentProfileLevel(requiredString(entry, `${source}.fallbackLevels[${index}]`));
+            if (!level) {
+                throw new Error(`${source}.fallbackLevels[${index}] is invalid`);
+            }
+            return level;
+        })
+        : [];
+    if (!isRecord(value.budgets)) {
+        throw new Error(`${source}.budgets must be an object`);
+    }
+    const budgets = Object.freeze({
+        maxAttempts: positiveInteger(value.budgets.maxAttempts, `${source}.budgets.maxAttempts`),
+        maxToolCalls: positiveInteger(value.budgets.maxToolCalls, `${source}.budgets.maxToolCalls`),
+        ...(typeof value.budgets.maxCostUsd === "number"
+            ? { maxCostUsd: value.budgets.maxCostUsd }
+            : {}),
+    });
+    const specialists = {};
+    if (isRecord(value.specialists)) {
+        for (const [rawType, config] of Object.entries(value.specialists)) {
+            const type = parseSubagentType(rawType);
+            if (!type)
+                throw new Error(`${source}.specialists.${rawType} is invalid`);
+            specialists[type] = invocation(config, `${source}.specialists.${rawType}`);
+        }
+    }
+    return Object.freeze({
+        id: requiredString(value.id, `${source}.id`),
+        version,
+        level: parsedLevel,
+        description: requiredString(value.description, `${source}.description`),
+        primary: invocation(value.primary, `${source}.primary`),
+        oracle: invocation(value.oracle, `${source}.oracle`, {
+            requireReadOnly: true,
+        }),
+        specialists: Object.freeze(specialists),
+        fallbackLevels: Object.freeze(fallbackLevels),
+        budgets,
+    });
+}
+export function loadAgentProfilesFromDirectory(directory) {
+    if (!existsSync(directory))
+        return [];
+    return readdirSync(directory)
+        .filter((file) => [".yaml", ".yml"].includes(extname(file).toLowerCase()))
+        .sort()
+        .map((file) => {
+        const path = join(directory, file);
+        return parseProfile(YAML.parse(readFileSync(path, "utf8")), path);
+    });
+}
+export function loadAgentProfiles(options = {}) {
+    const workspaceDir = options.workspaceDir ?? process.cwd();
+    const homeDir = options.homeDir ?? PATHS.MAESTRO_HOME;
+    const profiles = new Map();
+    for (const profile of loadAgentProfilesFromDirectory(join(homeDir, "agent-profiles"))) {
+        profiles.set(profile.id, profile);
+    }
+    for (const profile of loadAgentProfilesFromDirectory(join(workspaceDir, ".maestro", "agent-profiles"))) {
+        profiles.set(profile.id, profile);
+    }
+    return Array.from(profiles.values()).sort((a, b) => a.id.localeCompare(b.id));
+}
+//# sourceMappingURL=profile-loader.js.map

package/dist/agent/profile-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-loader.js","sourceRoot":"","sources":["../../src/agent/profile-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { extname, join } from \"node:path\";\nimport YAML from \"yaml\";\nimport { PATHS } from \"../config/constants.js\";\nimport { isRecord } from \"../utils/json.js\";\nimport type { ReasoningEffort } from \"./modes.js\";\nimport {\n\ttype AgentProfile,\n\ttype AgentProfileBudgets,\n\ttype AgentProfileLevel,\n\ttype ModelInvocationProfile,\n\tparseAgentProfileLevel,\n} from \"./profiles.js\";\nimport { parseSubagentType } from \"./subagent-specs.js\";\n\nconst REASONING_EFFORTS = new Set<ReasoningEffort>([\n\t\"low\",\n\t\"medium\",\n\t\"high\",\n\t\"xhigh\",\n]);\n\nfunction requiredString(value: unknown, path: string): string {\n\tif (typeof value !== \"string\" || !value.trim()) {\n\t\tthrow new Error(`${path} must be a non-empty string`);\n\t}\n\treturn value.trim();\n}\n\nfunction positiveInteger(value: unknown, path: string): number {\n\tif (typeof value !== \"number\" || !Number.isInteger(value) || value < 1) {\n\t\tthrow new Error(`${path} must be a positive integer`);\n\t}\n\treturn value;\n}\n\nfunction invocation(\n\tvalue: unknown,\n\tpath: string,\n\toptions: { requireReadOnly?: boolean } = {},\n): ModelInvocationProfile {\n\tif (!isRecord(value)) throw new Error(`${path} must be an object`);\n\tconst reasoningEffort = requiredString(\n\t\tvalue.reasoningEffort,\n\t\t`${path}.reasoningEffort`,\n\t) as ReasoningEffort;\n\tif (!REASONING_EFFORTS.has(reasoningEffort)) {\n\t\tthrow new Error(`${path}.reasoningEffort is invalid`);\n\t}\n\tif (options.requireReadOnly && value.readOnly !== true) {\n\t\tthrow new Error(`${path}.readOnly must be true`);\n\t}\n\treturn Object.freeze({\n\t\tprovider: requiredString(value.provider, `${path}.provider`),\n\t\tmodel: requiredString(value.model, `${path}.model`),\n\t\treasoningEffort,\n\t\t...(value.readOnly === true ? { readOnly: true } : {}),\n\t});\n}\n\nfunction parseProfile(value: unknown, source: string): AgentProfile {\n\tif (!isRecord(value)) throw new Error(`${source} must contain an object`);\n\tconst parsedLevel = parseAgentProfileLevel(\n\t\trequiredString(value.level, `${source}.level`),\n\t);\n\tif (!parsedLevel) throw new Error(`${source}.level is invalid`);\n\tconst version = positiveInteger(value.version, `${source}.version`);\n\tconst fallbackLevels = Array.isArray(value.fallbackLevels)\n\t\t? value.fallbackLevels.map((entry, index) => {\n\t\t\t\tconst level = parseAgentProfileLevel(\n\t\t\t\t\trequiredString(entry, `${source}.fallbackLevels[${index}]`),\n\t\t\t\t);\n\t\t\t\tif (!level) {\n\t\t\t\t\tthrow new Error(`${source}.fallbackLevels[${index}] is invalid`);\n\t\t\t\t}\n\t\t\t\treturn level;\n\t\t\t})\n\t\t: [];\n\tif (!isRecord(value.budgets)) {\n\t\tthrow new Error(`${source}.budgets must be an object`);\n\t}\n\tconst budgets: AgentProfileBudgets = Object.freeze({\n\t\tmaxAttempts: positiveInteger(\n\t\t\tvalue.budgets.maxAttempts,\n\t\t\t`${source}.budgets.maxAttempts`,\n\t\t),\n\t\tmaxToolCalls: positiveInteger(\n\t\t\tvalue.budgets.maxToolCalls,\n\t\t\t`${source}.budgets.maxToolCalls`,\n\t\t),\n\t\t...(typeof value.budgets.maxCostUsd === \"number\"\n\t\t\t? { maxCostUsd: value.budgets.maxCostUsd }\n\t\t\t: {}),\n\t});\n\tconst specialists: AgentProfile[\"specialists\"] = {};\n\tif (isRecord(value.specialists)) {\n\t\tfor (const [rawType, config] of Object.entries(value.specialists)) {\n\t\t\tconst type = parseSubagentType(rawType);\n\t\t\tif (!type) throw new Error(`${source}.specialists.${rawType} is invalid`);\n\t\t\tspecialists[type] = invocation(\n\t\t\t\tconfig,\n\t\t\t\t`${source}.specialists.${rawType}`,\n\t\t\t);\n\t\t}\n\t}\n\treturn Object.freeze({\n\t\tid: requiredString(value.id, `${source}.id`),\n\t\tversion,\n\t\tlevel: parsedLevel as AgentProfileLevel,\n\t\tdescription: requiredString(value.description, `${source}.description`),\n\t\tprimary: invocation(value.primary, `${source}.primary`),\n\t\toracle: invocation(value.oracle, `${source}.oracle`, {\n\t\t\trequireReadOnly: true,\n\t\t}),\n\t\tspecialists: Object.freeze(specialists),\n\t\tfallbackLevels: Object.freeze(fallbackLevels) as AgentProfileLevel[],\n\t\tbudgets,\n\t});\n}\n\nexport function loadAgentProfilesFromDirectory(\n\tdirectory: string,\n): AgentProfile[] {\n\tif (!existsSync(directory)) return [];\n\treturn readdirSync(directory)\n\t\t.filter((file) => [\".yaml\", \".yml\"].includes(extname(file).toLowerCase()))\n\t\t.sort()\n\t\t.map((file) => {\n\t\t\tconst path = join(directory, file);\n\t\t\treturn parseProfile(YAML.parse(readFileSync(path, \"utf8\")), path);\n\t\t});\n}\n\nexport function loadAgentProfiles(\n\toptions: {\n\t\tworkspaceDir?: string;\n\t\thomeDir?: string;\n\t} = {},\n): AgentProfile[] {\n\tconst workspaceDir = options.workspaceDir ?? process.cwd();\n\tconst homeDir = options.homeDir ?? PATHS.MAESTRO_HOME;\n\tconst profiles = new Map<string, AgentProfile>();\n\tfor (const profile of loadAgentProfilesFromDirectory(\n\t\tjoin(homeDir, \"agent-profiles\"),\n\t)) {\n\t\tprofiles.set(profile.id, profile);\n\t}\n\tfor (const profile of loadAgentProfilesFromDirectory(\n\t\tjoin(workspaceDir, \".maestro\", \"agent-profiles\"),\n\t)) {\n\t\tprofiles.set(profile.id, profile);\n\t}\n\treturn Array.from(profiles.values()).sort((a, b) => a.id.localeCompare(b.id));\n}\n"]}

package/dist/agent/profiles.d.ts

@@ -0,0 +1,30 @@
+import { type ModelProvider, type ReasoningEffort } from "./modes.js";
+import type { SubagentType } from "./subagent-specs.js";
+export declare const AGENT_PROFILE_LEVELS: readonly ["low", "medium", "high", "ultra"];
+export type AgentProfileLevel = (typeof AGENT_PROFILE_LEVELS)[number];
+export interface ModelInvocationProfile {
+    provider: string;
+    model: string;
+    reasoningEffort: ReasoningEffort;
+    readOnly?: boolean;
+}
+export interface AgentProfileBudgets {
+    maxAttempts: number;
+    maxToolCalls: number;
+    maxCostUsd?: number;
+}
+export interface AgentProfile {
+    id: string;
+    version: number;
+    level: AgentProfileLevel;
+    description: string;
+    primary: ModelInvocationProfile;
+    oracle: ModelInvocationProfile;
+    specialists: Partial<Record<SubagentType, ModelInvocationProfile>>;
+    fallbackLevels: AgentProfileLevel[];
+    budgets: AgentProfileBudgets;
+}
+export declare function parseAgentProfileLevel(input: string): AgentProfileLevel | null;
+export declare function resolveAgentProfile(input: string, provider?: ModelProvider): AgentProfile;
+export declare const AGENT_PROFILES: Readonly<Record<AgentProfileLevel, AgentProfile>>;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/agent/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/agent/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,aAAa,EAElB,KAAK,eAAe,EAEpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,oBAAoB,6CAA8C,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACnE,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,OAAO,EAAE,mBAAmB,CAAC;CAC7B;AAoLD,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,MAAM,GACX,iBAAiB,GAAG,IAAI,CAM1B;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,aAA8B,GACtC,YAAY,CAId;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAQ3E,CAAC"}

package/dist/agent/profiles.js

@@ -0,0 +1,146 @@
+import { getModelForTier, } from "./modes.js";
+export const AGENT_PROFILE_LEVELS = ["low", "medium", "high", "ultra"];
+const LEGACY_LEVEL_ALIASES = Object.freeze({
+    free: "low",
+    rush: "low",
+    smart: "medium",
+    custom: "medium",
+    frontier: "ultra",
+});
+const PROFILE_TEMPLATES = Object.freeze({
+    low: {
+        description: "Bounded, obvious, and reversible work",
+        primaryTier: "haiku",
+        primaryReasoningEffort: "low",
+        oracleProvider: "openai-codex",
+        oracleTier: "opus",
+        oracleReasoningEffort: "medium",
+        specialists: {
+            explorer: { tier: "haiku", reasoningEffort: "low" },
+            coder: { tier: "haiku", reasoningEffort: "low" },
+            reviewer: { tier: "sonnet", reasoningEffort: "low" },
+        },
+        fallbackLevels: [],
+        budgets: { maxAttempts: 1, maxToolCalls: 15 },
+    },
+    medium: {
+        description: "Ordinary repository work with moderate uncertainty",
+        primaryTier: "opus",
+        primaryReasoningEffort: "medium",
+        oracleProvider: "anthropic",
+        oracleTier: "opus",
+        oracleReasoningEffort: "medium",
+        specialists: {
+            explorer: { tier: "haiku", reasoningEffort: "low" },
+            planner: { tier: "sonnet", reasoningEffort: "medium" },
+            coder: {
+                provider: "openai-codex",
+                tier: "opus",
+                reasoningEffort: "medium",
+            },
+            reviewer: { tier: "sonnet", reasoningEffort: "medium" },
+        },
+        fallbackLevels: ["low"],
+        budgets: { maxAttempts: 2, maxToolCalls: 30 },
+    },
+    high: {
+        description: "Ambiguous or cross-cutting work where misses are expensive",
+        primaryTier: "opus",
+        primaryReasoningEffort: "xhigh",
+        oracleProvider: "anthropic",
+        oracleTier: "opus",
+        oracleReasoningEffort: "high",
+        specialists: {
+            explorer: { tier: "sonnet", reasoningEffort: "medium" },
+            planner: { tier: "opus", reasoningEffort: "high" },
+            coder: {
+                provider: "openai-codex",
+                tier: "opus",
+                reasoningEffort: "xhigh",
+            },
+            reviewer: {
+                provider: "anthropic",
+                tier: "opus",
+                reasoningEffort: "high",
+            },
+        },
+        fallbackLevels: ["medium", "low"],
+        budgets: { maxAttempts: 2, maxToolCalls: 45 },
+    },
+    ultra: {
+        description: "Migrations, architecture, and discovery-heavy work",
+        primaryTier: "opus",
+        primaryReasoningEffort: "xhigh",
+        oracleProvider: "openai-codex",
+        oracleTier: "opus",
+        oracleReasoningEffort: "xhigh",
+        specialists: {
+            explorer: { tier: "sonnet", reasoningEffort: "high" },
+            planner: { tier: "opus", reasoningEffort: "xhigh" },
+            coder: { tier: "opus", reasoningEffort: "xhigh" },
+            reviewer: {
+                provider: "openai-codex",
+                tier: "opus",
+                reasoningEffort: "xhigh",
+            },
+        },
+        fallbackLevels: ["high", "medium"],
+        budgets: { maxAttempts: 3, maxToolCalls: 60 },
+    },
+});
+function deepFreeze(value) {
+    if (value && typeof value === "object" && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const child of Object.values(value)) {
+            deepFreeze(child);
+        }
+    }
+    return value;
+}
+function invocation(provider, tier, reasoningEffort, readOnly = false) {
+    return {
+        provider,
+        model: getModelForTier(tier, provider),
+        reasoningEffort,
+        ...(readOnly ? { readOnly: true } : {}),
+    };
+}
+function buildProfile(level, provider) {
+    const template = PROFILE_TEMPLATES[level];
+    const specialists = Object.fromEntries(Object.entries(template.specialists).map(([type, specialist]) => {
+        const specialistProvider = specialist.provider ?? provider;
+        return [
+            type,
+            invocation(specialistProvider, specialist.tier, specialist.reasoningEffort),
+        ];
+    }));
+    return deepFreeze({
+        id: `${level}-v1`,
+        version: 1,
+        level,
+        description: template.description,
+        primary: invocation(provider, template.primaryTier, template.primaryReasoningEffort),
+        oracle: invocation(template.oracleProvider, template.oracleTier, template.oracleReasoningEffort, true),
+        specialists,
+        fallbackLevels: [...template.fallbackLevels],
+        budgets: { ...template.budgets },
+    });
+}
+export function parseAgentProfileLevel(input) {
+    const normalized = input.trim().toLowerCase();
+    if (AGENT_PROFILE_LEVELS.includes(normalized)) {
+        return normalized;
+    }
+    return LEGACY_LEVEL_ALIASES[normalized] ?? null;
+}
+export function resolveAgentProfile(input, provider = "openai-codex") {
+    const level = parseAgentProfileLevel(input);
+    if (!level)
+        throw new Error(`Unknown agent profile: ${input}`);
+    return buildProfile(level, provider);
+}
+export const AGENT_PROFILES = deepFreeze(Object.fromEntries(AGENT_PROFILE_LEVELS.map((level) => [
+    level,
+    buildProfile(level, "openai-codex"),
+])));
+//# sourceMappingURL=profiles.js.map

package/dist/agent/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/agent/profiles.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype ModelProvider,\n\ttype ModelTier,\n\ttype ReasoningEffort,\n\tgetModelForTier,\n} from \"./modes.js\";\nimport type { SubagentType } from \"./subagent-specs.js\";\n\nexport const AGENT_PROFILE_LEVELS = [\"low\", \"medium\", \"high\", \"ultra\"] as const;\n\nexport type AgentProfileLevel = (typeof AGENT_PROFILE_LEVELS)[number];\n\nexport interface ModelInvocationProfile {\n\tprovider: string;\n\tmodel: string;\n\treasoningEffort: ReasoningEffort;\n\treadOnly?: boolean;\n}\n\nexport interface AgentProfileBudgets {\n\tmaxAttempts: number;\n\tmaxToolCalls: number;\n\tmaxCostUsd?: number;\n}\n\nexport interface AgentProfile {\n\tid: string;\n\tversion: number;\n\tlevel: AgentProfileLevel;\n\tdescription: string;\n\tprimary: ModelInvocationProfile;\n\toracle: ModelInvocationProfile;\n\tspecialists: Partial<Record<SubagentType, ModelInvocationProfile>>;\n\tfallbackLevels: AgentProfileLevel[];\n\tbudgets: AgentProfileBudgets;\n}\n\ninterface AgentProfileTemplate {\n\tdescription: string;\n\tprimaryTier: ModelTier;\n\tprimaryReasoningEffort: ReasoningEffort;\n\toracleProvider: ModelProvider;\n\toracleTier: ModelTier;\n\toracleReasoningEffort: ReasoningEffort;\n\tspecialists: Partial<\n\t\tRecord<\n\t\t\tSubagentType,\n\t\t\t{\n\t\t\t\tprovider?: ModelProvider;\n\t\t\t\ttier: ModelTier;\n\t\t\t\treasoningEffort: ReasoningEffort;\n\t\t\t}\n\t\t>\n\t>;\n\tfallbackLevels: AgentProfileLevel[];\n\tbudgets: AgentProfileBudgets;\n}\n\nconst LEGACY_LEVEL_ALIASES: Readonly<Record<string, AgentProfileLevel>> =\n\tObject.freeze({\n\t\tfree: \"low\",\n\t\trush: \"low\",\n\t\tsmart: \"medium\",\n\t\tcustom: \"medium\",\n\t\tfrontier: \"ultra\",\n\t});\n\nconst PROFILE_TEMPLATES: Readonly<\n\tRecord<AgentProfileLevel, AgentProfileTemplate>\n> = Object.freeze({\n\tlow: {\n\t\tdescription: \"Bounded, obvious, and reversible work\",\n\t\tprimaryTier: \"haiku\",\n\t\tprimaryReasoningEffort: \"low\",\n\t\toracleProvider: \"openai-codex\",\n\t\toracleTier: \"opus\",\n\t\toracleReasoningEffort: \"medium\",\n\t\tspecialists: {\n\t\t\texplorer: { tier: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tcoder: { tier: \"haiku\", reasoningEffort: \"low\" },\n\t\t\treviewer: { tier: \"sonnet\", reasoningEffort: \"low\" },\n\t\t},\n\t\tfallbackLevels: [],\n\t\tbudgets: { maxAttempts: 1, maxToolCalls: 15 },\n\t},\n\tmedium: {\n\t\tdescription: \"Ordinary repository work with moderate uncertainty\",\n\t\tprimaryTier: \"opus\",\n\t\tprimaryReasoningEffort: \"medium\",\n\t\toracleProvider: \"anthropic\",\n\t\toracleTier: \"opus\",\n\t\toracleReasoningEffort: \"medium\",\n\t\tspecialists: {\n\t\t\texplorer: { tier: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { tier: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tcoder: {\n\t\t\t\tprovider: \"openai-codex\",\n\t\t\t\ttier: \"opus\",\n\t\t\t\treasoningEffort: \"medium\",\n\t\t\t},\n\t\t\treviewer: { tier: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t},\n\t\tfallbackLevels: [\"low\"],\n\t\tbudgets: { maxAttempts: 2, maxToolCalls: 30 },\n\t},\n\thigh: {\n\t\tdescription: \"Ambiguous or cross-cutting work where misses are expensive\",\n\t\tprimaryTier: \"opus\",\n\t\tprimaryReasoningEffort: \"xhigh\",\n\t\toracleProvider: \"anthropic\",\n\t\toracleTier: \"opus\",\n\t\toracleReasoningEffort: \"high\",\n\t\tspecialists: {\n\t\t\texplorer: { tier: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tplanner: { tier: \"opus\", reasoningEffort: \"high\" },\n\t\t\tcoder: {\n\t\t\t\tprovider: \"openai-codex\",\n\t\t\t\ttier: \"opus\",\n\t\t\t\treasoningEffort: \"xhigh\",\n\t\t\t},\n\t\t\treviewer: {\n\t\t\t\tprovider: \"anthropic\",\n\t\t\t\ttier: \"opus\",\n\t\t\t\treasoningEffort: \"high\",\n\t\t\t},\n\t\t},\n\t\tfallbackLevels: [\"medium\", \"low\"],\n\t\tbudgets: { maxAttempts: 2, maxToolCalls: 45 },\n\t},\n\tultra: {\n\t\tdescription: \"Migrations, architecture, and discovery-heavy work\",\n\t\tprimaryTier: \"opus\",\n\t\tprimaryReasoningEffort: \"xhigh\",\n\t\toracleProvider: \"openai-codex\",\n\t\toracleTier: \"opus\",\n\t\toracleReasoningEffort: \"xhigh\",\n\t\tspecialists: {\n\t\t\texplorer: { tier: \"sonnet\", reasoningEffort: \"high\" },\n\t\t\tplanner: { tier: \"opus\", reasoningEffort: \"xhigh\" },\n\t\t\tcoder: { tier: \"opus\", reasoningEffort: \"xhigh\" },\n\t\t\treviewer: {\n\t\t\t\tprovider: \"openai-codex\",\n\t\t\t\ttier: \"opus\",\n\t\t\t\treasoningEffort: \"xhigh\",\n\t\t\t},\n\t\t},\n\t\tfallbackLevels: [\"high\", \"medium\"],\n\t\tbudgets: { maxAttempts: 3, maxToolCalls: 60 },\n\t},\n});\n\nfunction deepFreeze<T>(value: T): Readonly<T> {\n\tif (value && typeof value === \"object\" && !Object.isFrozen(value)) {\n\t\tObject.freeze(value);\n\t\tfor (const child of Object.values(value as Record<string, unknown>)) {\n\t\t\tdeepFreeze(child);\n\t\t}\n\t}\n\treturn value;\n}\n\nfunction invocation(\n\tprovider: ModelProvider,\n\ttier: ModelTier,\n\treasoningEffort: ReasoningEffort,\n\treadOnly = false,\n): ModelInvocationProfile {\n\treturn {\n\t\tprovider,\n\t\tmodel: getModelForTier(tier, provider),\n\t\treasoningEffort,\n\t\t...(readOnly ? { readOnly: true } : {}),\n\t};\n}\n\nfunction buildProfile(\n\tlevel: AgentProfileLevel,\n\tprovider: ModelProvider,\n): AgentProfile {\n\tconst template = PROFILE_TEMPLATES[level];\n\tconst specialists = Object.fromEntries(\n\t\tObject.entries(template.specialists).map(([type, specialist]) => {\n\t\t\tconst specialistProvider = specialist.provider ?? provider;\n\t\t\treturn [\n\t\t\t\ttype,\n\t\t\t\tinvocation(\n\t\t\t\t\tspecialistProvider,\n\t\t\t\t\tspecialist.tier,\n\t\t\t\t\tspecialist.reasoningEffort,\n\t\t\t\t),\n\t\t\t];\n\t\t}),\n\t) as Partial<Record<SubagentType, ModelInvocationProfile>>;\n\treturn deepFreeze({\n\t\tid: `${level}-v1`,\n\t\tversion: 1,\n\t\tlevel,\n\t\tdescription: template.description,\n\t\tprimary: invocation(\n\t\t\tprovider,\n\t\t\ttemplate.primaryTier,\n\t\t\ttemplate.primaryReasoningEffort,\n\t\t),\n\t\toracle: invocation(\n\t\t\ttemplate.oracleProvider,\n\t\t\ttemplate.oracleTier,\n\t\t\ttemplate.oracleReasoningEffort,\n\t\t\ttrue,\n\t\t),\n\t\tspecialists,\n\t\tfallbackLevels: [...template.fallbackLevels],\n\t\tbudgets: { ...template.budgets },\n\t}) as AgentProfile;\n}\n\nexport function parseAgentProfileLevel(\n\tinput: string,\n): AgentProfileLevel | null {\n\tconst normalized = input.trim().toLowerCase();\n\tif (AGENT_PROFILE_LEVELS.includes(normalized as AgentProfileLevel)) {\n\t\treturn normalized as AgentProfileLevel;\n\t}\n\treturn LEGACY_LEVEL_ALIASES[normalized] ?? null;\n}\n\nexport function resolveAgentProfile(\n\tinput: string,\n\tprovider: ModelProvider = \"openai-codex\",\n): AgentProfile {\n\tconst level = parseAgentProfileLevel(input);\n\tif (!level) throw new Error(`Unknown agent profile: ${input}`);\n\treturn buildProfile(level, provider);\n}\n\nexport const AGENT_PROFILES: Readonly<Record<AgentProfileLevel, AgentProfile>> =\n\tdeepFreeze(\n\t\tObject.fromEntries(\n\t\t\tAGENT_PROFILE_LEVELS.map((level) => [\n\t\t\t\tlevel,\n\t\t\t\tbuildProfile(level, \"openai-codex\"),\n\t\t\t]),\n\t\t) as Record<AgentProfileLevel, AgentProfile>,\n\t);\n"]}

package/dist/agent/prompt-cache.d.ts

@@ -73,10 +73,6 @@ export interface PromptCacheConfig {
  * Get prompt cache configuration from environment.
  */
 export declare function getPromptCacheConfig(): PromptCacheConfig;
-/**
- * Estimate token count for a string (rough approximation).
- */
-export declare function estimateTokens(text: string): number;
 /**
  * Prompt Cache Manager for optimizing LLM requests.
  */

package/dist/agent/prompt-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../src/agent/prompt-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../src/agent/prompt-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,WAAW,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,yCAAyC;IACzC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACtD,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,sBAAsB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,yBAAyB,EAAE,MAAM,CAAC;IAClC,8DAA8D;IAC9D,yBAAyB,EAAE,MAAM,CAAC;IAClC,qEAAqE;IACrE,6BAA6B,EAAE,MAAM,CAAC;CACtC;AAWD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAqBxD;AASD;;GAEG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,aAAa,CAGP;IACd,OAAO,CAAC,eAAe,CAA0B;gBAErC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAa/C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,cAAc;IA4BhE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IASlD;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,cAAc;IASlE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc;IASnD;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAqBlE;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAoCR;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAC3B,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,IAAI,CAAC;KACf,CAAC;IAYF;;OAEG;IACH,OAAO,CAAC,QAAQ,SAAU,GAAG,MAAM;IAkBnC;;;OAGG;IACH,4BAA4B,CAC3B,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAC1B,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IA+CtE;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;CAGnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACjC,kBAAkB,CAEpB"}

package/dist/agent/prompt-cache.js

@@ -11,6 +11,7 @@
  * - MAESTRO_PROMPT_CACHE_TTL: TTL in seconds for cache entries (default: 300)
  */
 import { createHash } from "node:crypto";
+import { estimateTokens } from "@evalops/contracts";
 import { createLogger } from "../utils/logger.js";
 const logger = createLogger("prompt-cache");
 const DEFAULT_CONFIG = {
@@ -39,13 +40,6 @@ export function getPromptCacheConfig() {
             : Math.max(300, ttl), // Anthropic minimum is 5 minutes
     };
 }
-/**
- * Estimate token count for a string (rough approximation).
- */
-export function estimateTokens(text) {
-    // Rough estimate: 4 characters per token on average
-    return Math.ceil(text.length / 4);
-}
 /**
  * Generate a content hash for cache key generation.
  */

package/dist/agent/prompt-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-cache.js","sourceRoot":"","sources":["../../src/agent/prompt-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAiE5C,MAAM,cAAc,GAAsB;IACzC,OAAO,EAAE,IAAI;IACb,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,GAAG,EAAE,kCAAkC;IACxD,yBAAyB,EAAE,CAAC,EAAE,6CAA6C;IAC3E,yBAAyB,EAAE,CAAC,EAAE,4BAA4B;IAC1D,6BAA6B,EAAE,GAAG,EAAE,oBAAoB;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,OAAO,CAAC;IACrE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAChC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,MAAM,EACrD,EAAE,CACF,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAC1B,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,KAAK,EAC7C,EAAE,CACF,CAAC;IAEF,OAAO;QACN,GAAG,cAAc;QACjB,OAAO;QACP,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;YAC3C,CAAC,CAAC,cAAc,CAAC,mBAAmB;YACpC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,4BAA4B;QAC1D,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;YACjC,CAAC,CAAC,cAAc,CAAC,eAAe;YAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,iCAAiC;KACxD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,oDAAoD;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAS9B,YAAY,MAAmC;QANvC,kBAAa,GAGjB,IAAI,GAAG,EAAE,CAAC;QACN,oBAAe,GAAgB,IAAI,GAAG,EAAE,CAAC;QAGhD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,oBAAoB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG;YACZ,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,sBAAsB,EAAE,CAAC;SACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAiC;QAC9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;QAExC,MAAM,SAAS,GAAmB;YACjC,GAAG,KAAK;YACR,EAAE;YACF,YAAY,EACX,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB;gBAClD,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE;gBACvB,CAAC,CAAC,SAAS;SACb,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACrB,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;gBAC1B,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;gBACpB,QAAQ,EAAE,CAAC;aACX,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAe;QAChC,OAAO,IAAI,CAAC,aAAa,CAAC;YACzB,OAAO;YACP,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC;YACnC,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,GAAG,EAAE,mBAAmB;SAClC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,OAAe,EAAE,QAAQ,GAAG,EAAE;QAChD,OAAO,IAAI,CAAC,aAAa,CAAC;YACzB,OAAO;YACP,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC;YACnC,SAAS,EAAE,SAAS;YACpB,QAAQ;SACR,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,aAAa,CAAC;YACzB,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE,cAAc,CAAC,SAAS,CAAC;YACrC,SAAS,EAAE,OAAO;YAClB,QAAQ,EAAE,EAAE,EAAE,sCAAsC;SACpD,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,MAAwB;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,uDAAuD;QACvD,MAAM,QAAQ,GAAG,MAAM;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;aAC9D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE1C,gCAAgC;QAChC,MAAM,UAAU,GAAG,IAAI,GAAG,CACzB,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACzE,CAAC;QAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,GAAG,CAAC;YACJ,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;SACtE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAIjB;QACA,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAE3B,MAAM,SAAS,GAAG,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAE/C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC;YAEpC,6DAA6D;YAC7D,MAAM,WAAW,GAChB,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC;YACjE,MAAM,SAAS,GACd,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,6BAA6B,CAAC;YACrE,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,WAAW,GAAG,SAAS,CAAC;QACjD,CAAC;aAAM,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1B,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;QACvE,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,UAAU,CAAC;QAE/C,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;YACrC,SAAS;YACT,UAAU;YACV,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACxC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;SAC3C,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,UAAU;QACT,IAAI,CAAC,KAAK,GAAG;YACZ,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,sBAAsB,EAAE,CAAC;SACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAOjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aAC5C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChB,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;YAClB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;YAChC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;YAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;SAClC,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ,GAAG,OAAO;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACrC,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9C,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC;gBAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC9B,OAAO,EAAE,CAAC;YACX,CAAC;QACF,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,4BAA4B,CAC3B,UAAkB,EAClB,iBAA4B;QAE5B,MAAM,MAAM,GAIP,EAAE,CAAC;QAER,2BAA2B;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW,CAAC,OAAO;YACzB,aAAa,EAAE,WAAW,CAAC,YAAY;SACvC,CAAC,CAAC;QAEH,4BAA4B;QAC5B,IAAI,iBAAiB,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAC3C,iBAAiB,CAAC,CAAC,CAAE,EACrB,EAAE,GAAG,CAAC,CACN,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,YAAY,CAAC,OAAO;oBAC1B,aAAa,EAAE,YAAY,CAAC,YAAY;iBACxC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,IAAI;YACf,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;YAClC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,QAAkB,CAAC,CAAC,CAAE,SAAmB;YAC/D,QAAQ,EAAE,GAAG,GAAG,CAAC;SACjB,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,GAAG,CAAC;YACJ,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY;SACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAkC;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7C,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACvC,MAAmC;IAEnC,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/**\n * Prompt Caching Manager\n *\n * Implements Anthropic's prompt caching to reduce costs and latency for\n * repeated system prompts and context. Tracks cache-eligible content blocks\n * and monitors cache hit/miss ratios for optimization.\n *\n * Environment variables:\n * - MAESTRO_PROMPT_CACHE_ENABLED: Enable/disable prompt caching (default: true)\n * - MAESTRO_PROMPT_CACHE_MIN_TOKENS: Minimum tokens for caching (default: 1024)\n * - MAESTRO_PROMPT_CACHE_TTL: TTL in seconds for cache entries (default: 300)\n */\n\nimport { createHash } from \"node:crypto\";\nimport { createLogger } from \"../utils/logger.js\";\n\nconst logger = createLogger(\"prompt-cache\");\n\n/**\n * Cache control type for Anthropic API.\n */\nexport interface CacheControl {\n\ttype: \"ephemeral\";\n}\n\n/**\n * A content block that can be cached.\n */\nexport interface CacheableBlock {\n\t/** Unique identifier for this block */\n\tid: string;\n\t/** The content to cache */\n\tcontent: string;\n\t/** Estimated token count */\n\ttokenCount: number;\n\t/** Whether to apply cache control */\n\tcacheControl?: CacheControl;\n\t/** Block type (system, context, etc.) */\n\tblockType: \"system\" | \"context\" | \"tools\" | \"history\";\n\t/** Priority for caching (higher = more likely to cache) */\n\tpriority: number;\n}\n\n/**\n * Cache statistics for monitoring.\n */\nexport interface CacheStats {\n\t/** Total requests made */\n\ttotalRequests: number;\n\t/** Requests that hit the cache */\n\tcacheHits: number;\n\t/** Requests that missed the cache */\n\tcacheMisses: number;\n\t/** Cache hit ratio (0-1) */\n\thitRatio: number;\n\t/** Estimated tokens saved by caching */\n\ttokensSaved: number;\n\t/** Estimated cost saved (USD) */\n\tcostSaved: number;\n\t/** Current cache size in tokens */\n\tcurrentCacheSizeTokens: number;\n}\n\n/**\n * Configuration for prompt caching.\n */\nexport interface PromptCacheConfig {\n\t/** Whether caching is enabled */\n\tenabled: boolean;\n\t/** Minimum tokens for a block to be cache-eligible */\n\tminTokensForCaching: number;\n\t/** TTL for cache entries in seconds */\n\tcacheTtlSeconds: number;\n\t/** Maximum number of blocks to cache per request */\n\tmaxCachedBlocksPerRequest: number;\n\t/** Cost per million input tokens (for savings calculation) */\n\tinputCostPerMillionTokens: number;\n\t/** Cache read cost per million tokens (usually 10% of input cost) */\n\tcacheReadCostPerMillionTokens: number;\n}\n\nconst DEFAULT_CONFIG: PromptCacheConfig = {\n\tenabled: true,\n\tminTokensForCaching: 1024,\n\tcacheTtlSeconds: 300, // 5 minutes (Anthropic's minimum)\n\tmaxCachedBlocksPerRequest: 4, // Anthropic allows up to 4 cache breakpoints\n\tinputCostPerMillionTokens: 3, // Claude 3.5 Sonnet pricing\n\tcacheReadCostPerMillionTokens: 0.3, // 10% of input cost\n};\n\n/**\n * Get prompt cache configuration from environment.\n */\nexport function getPromptCacheConfig(): PromptCacheConfig {\n\tconst enabled = process.env.MAESTRO_PROMPT_CACHE_ENABLED !== \"false\";\n\tconst minTokens = Number.parseInt(\n\t\tprocess.env.MAESTRO_PROMPT_CACHE_MIN_TOKENS || \"1024\",\n\t\t10,\n\t);\n\tconst ttl = Number.parseInt(\n\t\tprocess.env.MAESTRO_PROMPT_CACHE_TTL || \"300\",\n\t\t10,\n\t);\n\n\treturn {\n\t\t...DEFAULT_CONFIG,\n\t\tenabled,\n\t\tminTokensForCaching: Number.isNaN(minTokens)\n\t\t\t? DEFAULT_CONFIG.minTokensForCaching\n\t\t\t: Math.max(1024, minTokens), // Anthropic minimum is 1024\n\t\tcacheTtlSeconds: Number.isNaN(ttl)\n\t\t\t? DEFAULT_CONFIG.cacheTtlSeconds\n\t\t\t: Math.max(300, ttl), // Anthropic minimum is 5 minutes\n\t};\n}\n\n/**\n * Estimate token count for a string (rough approximation).\n */\nexport function estimateTokens(text: string): number {\n\t// Rough estimate: 4 characters per token on average\n\treturn Math.ceil(text.length / 4);\n}\n\n/**\n * Generate a content hash for cache key generation.\n */\nfunction generateContentHash(content: string): string {\n\treturn createHash(\"sha256\").update(content).digest(\"hex\").slice(0, 16);\n}\n\n/**\n * Prompt Cache Manager for optimizing LLM requests.\n */\nexport class PromptCacheManager {\n\tprivate config: PromptCacheConfig;\n\tprivate stats: CacheStats;\n\tprivate blockRegistry: Map<\n\t\tstring,\n\t\t{ block: CacheableBlock; lastUsed: number; useCount: number }\n\t> = new Map();\n\tprivate lastCacheHashes: Set<string> = new Set();\n\n\tconstructor(config?: Partial<PromptCacheConfig>) {\n\t\tthis.config = { ...getPromptCacheConfig(), ...config };\n\t\tthis.stats = {\n\t\t\ttotalRequests: 0,\n\t\t\tcacheHits: 0,\n\t\t\tcacheMisses: 0,\n\t\t\thitRatio: 0,\n\t\t\ttokensSaved: 0,\n\t\t\tcostSaved: 0,\n\t\t\tcurrentCacheSizeTokens: 0,\n\t\t};\n\t}\n\n\t/**\n\t * Register a content block for potential caching.\n\t */\n\tregisterBlock(block: Omit<CacheableBlock, \"id\">): CacheableBlock {\n\t\tconst hash = generateContentHash(block.content);\n\t\tconst id = `${block.blockType}-${hash}`;\n\n\t\tconst fullBlock: CacheableBlock = {\n\t\t\t...block,\n\t\t\tid,\n\t\t\tcacheControl:\n\t\t\t\tblock.tokenCount >= this.config.minTokensForCaching\n\t\t\t\t\t? { type: \"ephemeral\" }\n\t\t\t\t\t: undefined,\n\t\t};\n\n\t\tconst existing = this.blockRegistry.get(id);\n\t\tif (existing) {\n\t\t\texisting.lastUsed = Date.now();\n\t\t\texisting.useCount++;\n\t\t} else {\n\t\t\tthis.blockRegistry.set(id, {\n\t\t\t\tblock: fullBlock,\n\t\t\t\tlastUsed: Date.now(),\n\t\t\t\tuseCount: 1,\n\t\t\t});\n\t\t}\n\n\t\treturn fullBlock;\n\t}\n\n\t/**\n\t * Create a cacheable system prompt block.\n\t */\n\tcreateSystemBlock(content: string): CacheableBlock {\n\t\treturn this.registerBlock({\n\t\t\tcontent,\n\t\t\ttokenCount: estimateTokens(content),\n\t\t\tblockType: \"system\",\n\t\t\tpriority: 100, // Highest priority\n\t\t});\n\t}\n\n\t/**\n\t * Create a cacheable context block (e.g., file contents, documentation).\n\t */\n\tcreateContextBlock(content: string, priority = 50): CacheableBlock {\n\t\treturn this.registerBlock({\n\t\t\tcontent,\n\t\t\ttokenCount: estimateTokens(content),\n\t\t\tblockType: \"context\",\n\t\t\tpriority,\n\t\t});\n\t}\n\n\t/**\n\t * Create a cacheable tools definition block.\n\t */\n\tcreateToolsBlock(toolsJson: string): CacheableBlock {\n\t\treturn this.registerBlock({\n\t\t\tcontent: toolsJson,\n\t\t\ttokenCount: estimateTokens(toolsJson),\n\t\t\tblockType: \"tools\",\n\t\t\tpriority: 90, // High priority (tools rarely change)\n\t\t});\n\t}\n\n\t/**\n\t * Select blocks to cache for a request, respecting limits.\n\t */\n\tselectBlocksForCaching(blocks: CacheableBlock[]): CacheableBlock[] {\n\t\tif (!this.config.enabled) {\n\t\t\treturn blocks.map((b) => ({ ...b, cacheControl: undefined }));\n\t\t}\n\n\t\t// Filter to cache-eligible blocks and sort by priority\n\t\tconst eligible = blocks\n\t\t\t.filter((b) => b.tokenCount >= this.config.minTokensForCaching)\n\t\t\t.sort((a, b) => b.priority - a.priority);\n\n\t\t// Take top N blocks for caching\n\t\tconst toCacheIds = new Set(\n\t\t\teligible.slice(0, this.config.maxCachedBlocksPerRequest).map((b) => b.id),\n\t\t);\n\n\t\treturn blocks.map((b) => ({\n\t\t\t...b,\n\t\t\tcacheControl: toCacheIds.has(b.id) ? { type: \"ephemeral\" } : undefined,\n\t\t}));\n\t}\n\n\t/**\n\t * Process response and update cache statistics.\n\t */\n\trecordCacheResult(usage: {\n\t\tcacheReadTokens?: number;\n\t\tcacheWriteTokens?: number;\n\t\tinputTokens: number;\n\t}): void {\n\t\tthis.stats.totalRequests++;\n\n\t\tconst cacheRead = usage.cacheReadTokens || 0;\n\t\tconst cacheWrite = usage.cacheWriteTokens || 0;\n\n\t\tif (cacheRead > 0) {\n\t\t\tthis.stats.cacheHits++;\n\t\t\tthis.stats.tokensSaved += cacheRead;\n\n\t\t\t// Calculate cost savings (cache reads are 10% of input cost)\n\t\t\tconst regularCost =\n\t\t\t\t(cacheRead / 1_000_000) * this.config.inputCostPerMillionTokens;\n\t\t\tconst cacheCost =\n\t\t\t\t(cacheRead / 1_000_000) * this.config.cacheReadCostPerMillionTokens;\n\t\t\tthis.stats.costSaved += regularCost - cacheCost;\n\t\t} else if (cacheWrite > 0) {\n\t\t\tthis.stats.cacheMisses++;\n\t\t}\n\n\t\t// Update hit ratio\n\t\tif (this.stats.totalRequests > 0) {\n\t\t\tthis.stats.hitRatio = this.stats.cacheHits / this.stats.totalRequests;\n\t\t}\n\n\t\t// Update current cache size estimate\n\t\tthis.stats.currentCacheSizeTokens = cacheWrite;\n\n\t\tlogger.debug(\"Cache result recorded\", {\n\t\t\tcacheRead,\n\t\t\tcacheWrite,\n\t\t\thitRatio: this.stats.hitRatio.toFixed(2),\n\t\t\ttotalSaved: this.stats.costSaved.toFixed(4),\n\t\t});\n\t}\n\n\t/**\n\t * Get current cache statistics.\n\t */\n\tgetStats(): CacheStats {\n\t\treturn { ...this.stats };\n\t}\n\n\t/**\n\t * Reset cache statistics.\n\t */\n\tresetStats(): void {\n\t\tthis.stats = {\n\t\t\ttotalRequests: 0,\n\t\t\tcacheHits: 0,\n\t\t\tcacheMisses: 0,\n\t\t\thitRatio: 0,\n\t\t\ttokensSaved: 0,\n\t\t\tcostSaved: 0,\n\t\t\tcurrentCacheSizeTokens: 0,\n\t\t};\n\t}\n\n\t/**\n\t * Get block usage statistics for optimization.\n\t */\n\tgetBlockUsageStats(): Array<{\n\t\tid: string;\n\t\tblockType: string;\n\t\ttokenCount: number;\n\t\tuseCount: number;\n\t\tlastUsed: Date;\n\t}> {\n\t\treturn Array.from(this.blockRegistry.values())\n\t\t\t.map((entry) => ({\n\t\t\t\tid: entry.block.id,\n\t\t\t\tblockType: entry.block.blockType,\n\t\t\t\ttokenCount: entry.block.tokenCount,\n\t\t\t\tuseCount: entry.useCount,\n\t\t\t\tlastUsed: new Date(entry.lastUsed),\n\t\t\t}))\n\t\t\t.sort((a, b) => b.useCount - a.useCount);\n\t}\n\n\t/**\n\t * Clean up old block entries.\n\t */\n\tcleanup(maxAgeMs = 3600000): number {\n\t\tconst cutoff = Date.now() - maxAgeMs;\n\t\tlet removed = 0;\n\n\t\tfor (const [id, entry] of this.blockRegistry) {\n\t\t\tif (entry.lastUsed < cutoff) {\n\t\t\t\tthis.blockRegistry.delete(id);\n\t\t\t\tremoved++;\n\t\t\t}\n\t\t}\n\n\t\tif (removed > 0) {\n\t\t\tlogger.info(\"Cleaned up old cache entries\", { removed });\n\t\t}\n\n\t\treturn removed;\n\t}\n\n\t/**\n\t * Format system prompt with cache control markers.\n\t * Returns an array of content blocks for Anthropic API.\n\t */\n\tformatSystemPromptForCaching(\n\t\tbasePrompt: string,\n\t\tadditionalContext?: string[],\n\t): Array<{ type: \"text\"; text: string; cache_control?: CacheControl }> {\n\t\tconst blocks: Array<{\n\t\t\ttype: \"text\";\n\t\t\ttext: string;\n\t\t\tcache_control?: CacheControl;\n\t\t}> = [];\n\n\t\t// Main system prompt block\n\t\tconst systemBlock = this.createSystemBlock(basePrompt);\n\t\tblocks.push({\n\t\t\ttype: \"text\",\n\t\t\ttext: systemBlock.content,\n\t\t\tcache_control: systemBlock.cacheControl,\n\t\t});\n\n\t\t// Additional context blocks\n\t\tif (additionalContext) {\n\t\t\tfor (let i = 0; i < additionalContext.length; i++) {\n\t\t\t\tconst contextBlock = this.createContextBlock(\n\t\t\t\t\tadditionalContext[i]!,\n\t\t\t\t\t50 - i, // Decreasing priority\n\t\t\t\t);\n\t\t\t\tblocks.push({\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: contextBlock.content,\n\t\t\t\t\tcache_control: contextBlock.cacheControl,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\t// Only apply cache control to top blocks\n\t\tconst selected = this.selectBlocksForCaching(\n\t\t\tblocks.map((b, i) => ({\n\t\t\t\tid: `block-${i}`,\n\t\t\t\tcontent: b.text,\n\t\t\t\ttokenCount: estimateTokens(b.text),\n\t\t\t\tblockType: i === 0 ? (\"system\" as const) : (\"context\" as const),\n\t\t\t\tpriority: 100 - i,\n\t\t\t})),\n\t\t);\n\n\t\treturn blocks.map((b, i) => ({\n\t\t\t...b,\n\t\t\tcache_control: selected[i]?.cacheControl,\n\t\t}));\n\t}\n\n\t/**\n\t * Check if caching is enabled.\n\t */\n\tisEnabled(): boolean {\n\t\treturn this.config.enabled;\n\t}\n\n\t/**\n\t * Get configuration.\n\t */\n\tgetConfig(): PromptCacheConfig {\n\t\treturn { ...this.config };\n\t}\n\n\t/**\n\t * Update configuration.\n\t */\n\tsetConfig(config: Partial<PromptCacheConfig>): void {\n\t\tthis.config = { ...this.config, ...config };\n\t}\n}\n\n/**\n * Create a default prompt cache manager.\n */\nexport function createPromptCacheManager(\n\tconfig?: Partial<PromptCacheConfig>,\n): PromptCacheManager {\n\treturn new PromptCacheManager(config);\n}\n"]}
+{"version":3,"file":"prompt-cache.js","sourceRoot":"","sources":["../../src/agent/prompt-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAiE5C,MAAM,cAAc,GAAsB;IACzC,OAAO,EAAE,IAAI;IACb,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,GAAG,EAAE,kCAAkC;IACxD,yBAAyB,EAAE,CAAC,EAAE,6CAA6C;IAC3E,yBAAyB,EAAE,CAAC,EAAE,4BAA4B;IAC1D,6BAA6B,EAAE,GAAG,EAAE,oBAAoB;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,OAAO,CAAC;IACrE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAChC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,MAAM,EACrD,EAAE,CACF,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAC1B,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,KAAK,EAC7C,EAAE,CACF,CAAC;IAEF,OAAO;QACN,GAAG,cAAc;QACjB,OAAO;QACP,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;YAC3C,CAAC,CAAC,cAAc,CAAC,mBAAmB;YACpC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,4BAA4B;QAC1D,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;YACjC,CAAC,CAAC,cAAc,CAAC,eAAe;YAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,iCAAiC;KACxD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAS9B,YAAY,MAAmC;QANvC,kBAAa,GAGjB,IAAI,GAAG,EAAE,CAAC;QACN,oBAAe,GAAgB,IAAI,GAAG,EAAE,CAAC;QAGhD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,oBAAoB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG;YACZ,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,sBAAsB,EAAE,CAAC;SACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAiC;QAC9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;QAExC,MAAM,SAAS,GAAmB;YACjC,GAAG,KAAK;YACR,EAAE;YACF,YAAY,EACX,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB;gBAClD,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE;gBACvB,CAAC,CAAC,SAAS;SACb,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACrB,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;gBAC1B,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;gBACpB,QAAQ,EAAE,CAAC;aACX,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAe;QAChC,OAAO,IAAI,CAAC,aAAa,CAAC;YACzB,OAAO;YACP,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC;YACnC,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,GAAG,EAAE,mBAAmB;SAClC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,OAAe,EAAE,QAAQ,GAAG,EAAE;QAChD,OAAO,IAAI,CAAC,aAAa,CAAC;YACzB,OAAO;YACP,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC;YACnC,SAAS,EAAE,SAAS;YACpB,QAAQ;SACR,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,aAAa,CAAC;YACzB,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE,cAAc,CAAC,SAAS,CAAC;YACrC,SAAS,EAAE,OAAO;YAClB,QAAQ,EAAE,EAAE,EAAE,sCAAsC;SACpD,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,MAAwB;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,uDAAuD;QACvD,MAAM,QAAQ,GAAG,MAAM;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;aAC9D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE1C,gCAAgC;QAChC,MAAM,UAAU,GAAG,IAAI,GAAG,CACzB,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACzE,CAAC;QAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,GAAG,CAAC;YACJ,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;SACtE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAIjB;QACA,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAE3B,MAAM,SAAS,GAAG,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAE/C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC;YAEpC,6DAA6D;YAC7D,MAAM,WAAW,GAChB,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC;YACjE,MAAM,SAAS,GACd,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,6BAA6B,CAAC;YACrE,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,WAAW,GAAG,SAAS,CAAC;QACjD,CAAC;aAAM,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1B,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;QACvE,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,UAAU,CAAC;QAE/C,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;YACrC,SAAS;YACT,UAAU;YACV,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACxC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;SAC3C,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,UAAU;QACT,IAAI,CAAC,KAAK,GAAG;YACZ,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,sBAAsB,EAAE,CAAC;SACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAOjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aAC5C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChB,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;YAClB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;YAChC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;YAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;SAClC,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ,GAAG,OAAO;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACrC,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9C,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC;gBAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC9B,OAAO,EAAE,CAAC;YACX,CAAC;QACF,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,4BAA4B,CAC3B,UAAkB,EAClB,iBAA4B;QAE5B,MAAM,MAAM,GAIP,EAAE,CAAC;QAER,2BAA2B;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW,CAAC,OAAO;YACzB,aAAa,EAAE,WAAW,CAAC,YAAY;SACvC,CAAC,CAAC;QAEH,4BAA4B;QAC5B,IAAI,iBAAiB,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAC3C,iBAAiB,CAAC,CAAC,CAAE,EACrB,EAAE,GAAG,CAAC,CACN,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,YAAY,CAAC,OAAO;oBAC1B,aAAa,EAAE,YAAY,CAAC,YAAY;iBACxC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,IAAI;YACf,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;YAClC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,QAAkB,CAAC,CAAC,CAAE,SAAmB;YAC/D,QAAQ,EAAE,GAAG,GAAG,CAAC;SACjB,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,GAAG,CAAC;YACJ,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY;SACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAkC;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7C,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACvC,MAAmC;IAEnC,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/**\n * Prompt Caching Manager\n *\n * Implements Anthropic's prompt caching to reduce costs and latency for\n * repeated system prompts and context. Tracks cache-eligible content blocks\n * and monitors cache hit/miss ratios for optimization.\n *\n * Environment variables:\n * - MAESTRO_PROMPT_CACHE_ENABLED: Enable/disable prompt caching (default: true)\n * - MAESTRO_PROMPT_CACHE_MIN_TOKENS: Minimum tokens for caching (default: 1024)\n * - MAESTRO_PROMPT_CACHE_TTL: TTL in seconds for cache entries (default: 300)\n */\n\nimport { createHash } from \"node:crypto\";\nimport { estimateTokens } from \"@evalops/contracts\";\nimport { createLogger } from \"../utils/logger.js\";\n\nconst logger = createLogger(\"prompt-cache\");\n\n/**\n * Cache control type for Anthropic API.\n */\nexport interface CacheControl {\n\ttype: \"ephemeral\";\n}\n\n/**\n * A content block that can be cached.\n */\nexport interface CacheableBlock {\n\t/** Unique identifier for this block */\n\tid: string;\n\t/** The content to cache */\n\tcontent: string;\n\t/** Estimated token count */\n\ttokenCount: number;\n\t/** Whether to apply cache control */\n\tcacheControl?: CacheControl;\n\t/** Block type (system, context, etc.) */\n\tblockType: \"system\" | \"context\" | \"tools\" | \"history\";\n\t/** Priority for caching (higher = more likely to cache) */\n\tpriority: number;\n}\n\n/**\n * Cache statistics for monitoring.\n */\nexport interface CacheStats {\n\t/** Total requests made */\n\ttotalRequests: number;\n\t/** Requests that hit the cache */\n\tcacheHits: number;\n\t/** Requests that missed the cache */\n\tcacheMisses: number;\n\t/** Cache hit ratio (0-1) */\n\thitRatio: number;\n\t/** Estimated tokens saved by caching */\n\ttokensSaved: number;\n\t/** Estimated cost saved (USD) */\n\tcostSaved: number;\n\t/** Current cache size in tokens */\n\tcurrentCacheSizeTokens: number;\n}\n\n/**\n * Configuration for prompt caching.\n */\nexport interface PromptCacheConfig {\n\t/** Whether caching is enabled */\n\tenabled: boolean;\n\t/** Minimum tokens for a block to be cache-eligible */\n\tminTokensForCaching: number;\n\t/** TTL for cache entries in seconds */\n\tcacheTtlSeconds: number;\n\t/** Maximum number of blocks to cache per request */\n\tmaxCachedBlocksPerRequest: number;\n\t/** Cost per million input tokens (for savings calculation) */\n\tinputCostPerMillionTokens: number;\n\t/** Cache read cost per million tokens (usually 10% of input cost) */\n\tcacheReadCostPerMillionTokens: number;\n}\n\nconst DEFAULT_CONFIG: PromptCacheConfig = {\n\tenabled: true,\n\tminTokensForCaching: 1024,\n\tcacheTtlSeconds: 300, // 5 minutes (Anthropic's minimum)\n\tmaxCachedBlocksPerRequest: 4, // Anthropic allows up to 4 cache breakpoints\n\tinputCostPerMillionTokens: 3, // Claude 3.5 Sonnet pricing\n\tcacheReadCostPerMillionTokens: 0.3, // 10% of input cost\n};\n\n/**\n * Get prompt cache configuration from environment.\n */\nexport function getPromptCacheConfig(): PromptCacheConfig {\n\tconst enabled = process.env.MAESTRO_PROMPT_CACHE_ENABLED !== \"false\";\n\tconst minTokens = Number.parseInt(\n\t\tprocess.env.MAESTRO_PROMPT_CACHE_MIN_TOKENS || \"1024\",\n\t\t10,\n\t);\n\tconst ttl = Number.parseInt(\n\t\tprocess.env.MAESTRO_PROMPT_CACHE_TTL || \"300\",\n\t\t10,\n\t);\n\n\treturn {\n\t\t...DEFAULT_CONFIG,\n\t\tenabled,\n\t\tminTokensForCaching: Number.isNaN(minTokens)\n\t\t\t? DEFAULT_CONFIG.minTokensForCaching\n\t\t\t: Math.max(1024, minTokens), // Anthropic minimum is 1024\n\t\tcacheTtlSeconds: Number.isNaN(ttl)\n\t\t\t? DEFAULT_CONFIG.cacheTtlSeconds\n\t\t\t: Math.max(300, ttl), // Anthropic minimum is 5 minutes\n\t};\n}\n\n/**\n * Generate a content hash for cache key generation.\n */\nfunction generateContentHash(content: string): string {\n\treturn createHash(\"sha256\").update(content).digest(\"hex\").slice(0, 16);\n}\n\n/**\n * Prompt Cache Manager for optimizing LLM requests.\n */\nexport class PromptCacheManager {\n\tprivate config: PromptCacheConfig;\n\tprivate stats: CacheStats;\n\tprivate blockRegistry: Map<\n\t\tstring,\n\t\t{ block: CacheableBlock; lastUsed: number; useCount: number }\n\t> = new Map();\n\tprivate lastCacheHashes: Set<string> = new Set();\n\n\tconstructor(config?: Partial<PromptCacheConfig>) {\n\t\tthis.config = { ...getPromptCacheConfig(), ...config };\n\t\tthis.stats = {\n\t\t\ttotalRequests: 0,\n\t\t\tcacheHits: 0,\n\t\t\tcacheMisses: 0,\n\t\t\thitRatio: 0,\n\t\t\ttokensSaved: 0,\n\t\t\tcostSaved: 0,\n\t\t\tcurrentCacheSizeTokens: 0,\n\t\t};\n\t}\n\n\t/**\n\t * Register a content block for potential caching.\n\t */\n\tregisterBlock(block: Omit<CacheableBlock, \"id\">): CacheableBlock {\n\t\tconst hash = generateContentHash(block.content);\n\t\tconst id = `${block.blockType}-${hash}`;\n\n\t\tconst fullBlock: CacheableBlock = {\n\t\t\t...block,\n\t\t\tid,\n\t\t\tcacheControl:\n\t\t\t\tblock.tokenCount >= this.config.minTokensForCaching\n\t\t\t\t\t? { type: \"ephemeral\" }\n\t\t\t\t\t: undefined,\n\t\t};\n\n\t\tconst existing = this.blockRegistry.get(id);\n\t\tif (existing) {\n\t\t\texisting.lastUsed = Date.now();\n\t\t\texisting.useCount++;\n\t\t} else {\n\t\t\tthis.blockRegistry.set(id, {\n\t\t\t\tblock: fullBlock,\n\t\t\t\tlastUsed: Date.now(),\n\t\t\t\tuseCount: 1,\n\t\t\t});\n\t\t}\n\n\t\treturn fullBlock;\n\t}\n\n\t/**\n\t * Create a cacheable system prompt block.\n\t */\n\tcreateSystemBlock(content: string): CacheableBlock {\n\t\treturn this.registerBlock({\n\t\t\tcontent,\n\t\t\ttokenCount: estimateTokens(content),\n\t\t\tblockType: \"system\",\n\t\t\tpriority: 100, // Highest priority\n\t\t});\n\t}\n\n\t/**\n\t * Create a cacheable context block (e.g., file contents, documentation).\n\t */\n\tcreateContextBlock(content: string, priority = 50): CacheableBlock {\n\t\treturn this.registerBlock({\n\t\t\tcontent,\n\t\t\ttokenCount: estimateTokens(content),\n\t\t\tblockType: \"context\",\n\t\t\tpriority,\n\t\t});\n\t}\n\n\t/**\n\t * Create a cacheable tools definition block.\n\t */\n\tcreateToolsBlock(toolsJson: string): CacheableBlock {\n\t\treturn this.registerBlock({\n\t\t\tcontent: toolsJson,\n\t\t\ttokenCount: estimateTokens(toolsJson),\n\t\t\tblockType: \"tools\",\n\t\t\tpriority: 90, // High priority (tools rarely change)\n\t\t});\n\t}\n\n\t/**\n\t * Select blocks to cache for a request, respecting limits.\n\t */\n\tselectBlocksForCaching(blocks: CacheableBlock[]): CacheableBlock[] {\n\t\tif (!this.config.enabled) {\n\t\t\treturn blocks.map((b) => ({ ...b, cacheControl: undefined }));\n\t\t}\n\n\t\t// Filter to cache-eligible blocks and sort by priority\n\t\tconst eligible = blocks\n\t\t\t.filter((b) => b.tokenCount >= this.config.minTokensForCaching)\n\t\t\t.sort((a, b) => b.priority - a.priority);\n\n\t\t// Take top N blocks for caching\n\t\tconst toCacheIds = new Set(\n\t\t\teligible.slice(0, this.config.maxCachedBlocksPerRequest).map((b) => b.id),\n\t\t);\n\n\t\treturn blocks.map((b) => ({\n\t\t\t...b,\n\t\t\tcacheControl: toCacheIds.has(b.id) ? { type: \"ephemeral\" } : undefined,\n\t\t}));\n\t}\n\n\t/**\n\t * Process response and update cache statistics.\n\t */\n\trecordCacheResult(usage: {\n\t\tcacheReadTokens?: number;\n\t\tcacheWriteTokens?: number;\n\t\tinputTokens: number;\n\t}): void {\n\t\tthis.stats.totalRequests++;\n\n\t\tconst cacheRead = usage.cacheReadTokens || 0;\n\t\tconst cacheWrite = usage.cacheWriteTokens || 0;\n\n\t\tif (cacheRead > 0) {\n\t\t\tthis.stats.cacheHits++;\n\t\t\tthis.stats.tokensSaved += cacheRead;\n\n\t\t\t// Calculate cost savings (cache reads are 10% of input cost)\n\t\t\tconst regularCost =\n\t\t\t\t(cacheRead / 1_000_000) * this.config.inputCostPerMillionTokens;\n\t\t\tconst cacheCost =\n\t\t\t\t(cacheRead / 1_000_000) * this.config.cacheReadCostPerMillionTokens;\n\t\t\tthis.stats.costSaved += regularCost - cacheCost;\n\t\t} else if (cacheWrite > 0) {\n\t\t\tthis.stats.cacheMisses++;\n\t\t}\n\n\t\t// Update hit ratio\n\t\tif (this.stats.totalRequests > 0) {\n\t\t\tthis.stats.hitRatio = this.stats.cacheHits / this.stats.totalRequests;\n\t\t}\n\n\t\t// Update current cache size estimate\n\t\tthis.stats.currentCacheSizeTokens = cacheWrite;\n\n\t\tlogger.debug(\"Cache result recorded\", {\n\t\t\tcacheRead,\n\t\t\tcacheWrite,\n\t\t\thitRatio: this.stats.hitRatio.toFixed(2),\n\t\t\ttotalSaved: this.stats.costSaved.toFixed(4),\n\t\t});\n\t}\n\n\t/**\n\t * Get current cache statistics.\n\t */\n\tgetStats(): CacheStats {\n\t\treturn { ...this.stats };\n\t}\n\n\t/**\n\t * Reset cache statistics.\n\t */\n\tresetStats(): void {\n\t\tthis.stats = {\n\t\t\ttotalRequests: 0,\n\t\t\tcacheHits: 0,\n\t\t\tcacheMisses: 0,\n\t\t\thitRatio: 0,\n\t\t\ttokensSaved: 0,\n\t\t\tcostSaved: 0,\n\t\t\tcurrentCacheSizeTokens: 0,\n\t\t};\n\t}\n\n\t/**\n\t * Get block usage statistics for optimization.\n\t */\n\tgetBlockUsageStats(): Array<{\n\t\tid: string;\n\t\tblockType: string;\n\t\ttokenCount: number;\n\t\tuseCount: number;\n\t\tlastUsed: Date;\n\t}> {\n\t\treturn Array.from(this.blockRegistry.values())\n\t\t\t.map((entry) => ({\n\t\t\t\tid: entry.block.id,\n\t\t\t\tblockType: entry.block.blockType,\n\t\t\t\ttokenCount: entry.block.tokenCount,\n\t\t\t\tuseCount: entry.useCount,\n\t\t\t\tlastUsed: new Date(entry.lastUsed),\n\t\t\t}))\n\t\t\t.sort((a, b) => b.useCount - a.useCount);\n\t}\n\n\t/**\n\t * Clean up old block entries.\n\t */\n\tcleanup(maxAgeMs = 3600000): number {\n\t\tconst cutoff = Date.now() - maxAgeMs;\n\t\tlet removed = 0;\n\n\t\tfor (const [id, entry] of this.blockRegistry) {\n\t\t\tif (entry.lastUsed < cutoff) {\n\t\t\t\tthis.blockRegistry.delete(id);\n\t\t\t\tremoved++;\n\t\t\t}\n\t\t}\n\n\t\tif (removed > 0) {\n\t\t\tlogger.info(\"Cleaned up old cache entries\", { removed });\n\t\t}\n\n\t\treturn removed;\n\t}\n\n\t/**\n\t * Format system prompt with cache control markers.\n\t * Returns an array of content blocks for Anthropic API.\n\t */\n\tformatSystemPromptForCaching(\n\t\tbasePrompt: string,\n\t\tadditionalContext?: string[],\n\t): Array<{ type: \"text\"; text: string; cache_control?: CacheControl }> {\n\t\tconst blocks: Array<{\n\t\t\ttype: \"text\";\n\t\t\ttext: string;\n\t\t\tcache_control?: CacheControl;\n\t\t}> = [];\n\n\t\t// Main system prompt block\n\t\tconst systemBlock = this.createSystemBlock(basePrompt);\n\t\tblocks.push({\n\t\t\ttype: \"text\",\n\t\t\ttext: systemBlock.content,\n\t\t\tcache_control: systemBlock.cacheControl,\n\t\t});\n\n\t\t// Additional context blocks\n\t\tif (additionalContext) {\n\t\t\tfor (let i = 0; i < additionalContext.length; i++) {\n\t\t\t\tconst contextBlock = this.createContextBlock(\n\t\t\t\t\tadditionalContext[i]!,\n\t\t\t\t\t50 - i, // Decreasing priority\n\t\t\t\t);\n\t\t\t\tblocks.push({\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: contextBlock.content,\n\t\t\t\t\tcache_control: contextBlock.cacheControl,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\t// Only apply cache control to top blocks\n\t\tconst selected = this.selectBlocksForCaching(\n\t\t\tblocks.map((b, i) => ({\n\t\t\t\tid: `block-${i}`,\n\t\t\t\tcontent: b.text,\n\t\t\t\ttokenCount: estimateTokens(b.text),\n\t\t\t\tblockType: i === 0 ? (\"system\" as const) : (\"context\" as const),\n\t\t\t\tpriority: 100 - i,\n\t\t\t})),\n\t\t);\n\n\t\treturn blocks.map((b, i) => ({\n\t\t\t...b,\n\t\t\tcache_control: selected[i]?.cacheControl,\n\t\t}));\n\t}\n\n\t/**\n\t * Check if caching is enabled.\n\t */\n\tisEnabled(): boolean {\n\t\treturn this.config.enabled;\n\t}\n\n\t/**\n\t * Get configuration.\n\t */\n\tgetConfig(): PromptCacheConfig {\n\t\treturn { ...this.config };\n\t}\n\n\t/**\n\t * Update configuration.\n\t */\n\tsetConfig(config: Partial<PromptCacheConfig>): void {\n\t\tthis.config = { ...this.config, ...config };\n\t}\n}\n\n/**\n * Create a default prompt cache manager.\n */\nexport function createPromptCacheManager(\n\tconfig?: Partial<PromptCacheConfig>,\n): PromptCacheManager {\n\treturn new PromptCacheManager(config);\n}\n"]}

package/dist/agent/providers/google-gemini-cli.js

@@ -18832,6 +18832,7 @@ function createRuntimeEnv(raw) {
     missionStoreDir: resolveHomePath(trim(raw.MAESTRO_MISSION_STORE_DIR), raw),
     snapshotBlobDir: resolveHomePath(trim(raw.MAESTRO_SNAPSHOT_BLOB_DIR), raw),
     skillTrustStrict: parseBoolean(trim(raw.MAESTRO_SKILL_TRUST_STRICT)),
+    primaryModelProvider: trim(raw.MAESTRO_PRIMARY_MODEL_PROVIDER),
     telemetryEnabled: parseOptionalBoolean(trim(raw.MAESTRO_TELEMETRY) ?? trim(raw.PLAYWRIGHT_TELEMETRY)),
     telemetryFlag: trim(raw.MAESTRO_TELEMETRY) ?? trim(raw.PLAYWRIGHT_TELEMETRY),
     beaconFile: resolveHomePath(trim(raw.MAESTRO_BEACON_FILE), raw),

package/dist/agent/providers/google.js

@@ -18832,6 +18832,7 @@ function createRuntimeEnv(raw) {
     missionStoreDir: resolveHomePath(trim(raw.MAESTRO_MISSION_STORE_DIR), raw),
     snapshotBlobDir: resolveHomePath(trim(raw.MAESTRO_SNAPSHOT_BLOB_DIR), raw),
     skillTrustStrict: parseBoolean(trim(raw.MAESTRO_SKILL_TRUST_STRICT)),
+    primaryModelProvider: trim(raw.MAESTRO_PRIMARY_MODEL_PROVIDER),
     telemetryEnabled: parseOptionalBoolean(trim(raw.MAESTRO_TELEMETRY) ?? trim(raw.PLAYWRIGHT_TELEMETRY)),
     telemetryFlag: trim(raw.MAESTRO_TELEMETRY) ?? trim(raw.PLAYWRIGHT_TELEMETRY),
     beaconFile: resolveHomePath(trim(raw.MAESTRO_BEACON_FILE), raw),

package/dist/agent/providers/vertex.js

@@ -18525,6 +18525,7 @@ function createRuntimeEnv(raw) {
     missionStoreDir: resolveHomePath(trim(raw.MAESTRO_MISSION_STORE_DIR), raw),
     snapshotBlobDir: resolveHomePath(trim(raw.MAESTRO_SNAPSHOT_BLOB_DIR), raw),
     skillTrustStrict: parseBoolean(trim(raw.MAESTRO_SKILL_TRUST_STRICT)),
+    primaryModelProvider: trim(raw.MAESTRO_PRIMARY_MODEL_PROVIDER),
     telemetryEnabled: parseOptionalBoolean(trim(raw.MAESTRO_TELEMETRY) ?? trim(raw.PLAYWRIGHT_TELEMETRY)),
     telemetryFlag: trim(raw.MAESTRO_TELEMETRY) ?? trim(raw.PLAYWRIGHT_TELEMETRY),
     beaconFile: resolveHomePath(trim(raw.MAESTRO_BEACON_FILE), raw),

package/dist/agent/routing-receipt.d.ts

@@ -0,0 +1,34 @@
+import type { AgentProfilePin, RoutingReceipt, RoutingReceiptExperiment, RoutingReceiptSource } from "@evalops/contracts";
+import type { OracleConsultationDecision } from "./oracle-consultation-policy.js";
+import type { AgentProfile } from "./profiles.js";
+export interface AgentProfileSelectionInput {
+    requestedProfile?: string;
+    sessionPin?: AgentProfilePin;
+    compatibilityProfile: string;
+}
+export interface AgentProfileSelection {
+    requestedProfile: string;
+    source: RoutingReceiptSource;
+}
+export interface RoutingReceiptDecision {
+    decisionId: string;
+    selectedModel: {
+        provider: string;
+        model: string;
+    };
+    selectedProfile: AgentProfile;
+    createdAt: string;
+    oracleConsultation?: OracleConsultationDecision;
+}
+export interface RoutingReceiptContext extends AgentProfileSelection {
+    fallbackReason?: string;
+    fallbackModel?: {
+        provider: string;
+        model: string;
+    };
+    experiment?: RoutingReceiptExperiment;
+}
+export declare function resolveAgentProfileSelection(input: AgentProfileSelectionInput): AgentProfileSelection;
+/** Project a routing decision into immutable historical turn metadata. */
+export declare function createRoutingReceipt(decision: RoutingReceiptDecision, context: RoutingReceiptContext): RoutingReceipt;
+//# sourceMappingURL=routing-receipt.d.ts.map

package/dist/agent/routing-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-receipt.d.ts","sourceRoot":"","sources":["../../src/agent/routing-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,WAAW,0BAA0B;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,eAAe,EAAE,YAAY,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;CAChD;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAED,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,0BAA0B,GAC/B,qBAAqB,CAoBvB;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,qBAAqB,GAC5B,cAAc,CAgChB"}

package/dist/agent/routing-receipt.js

@@ -0,0 +1,55 @@
+export function resolveAgentProfileSelection(input) {
+    if (input.requestedProfile?.trim()) {
+        return {
+            requestedProfile: input.requestedProfile.trim(),
+            source: "request",
+        };
+    }
+    if (input.sessionPin?.profile.trim()) {
+        return {
+            requestedProfile: input.sessionPin.profile.trim(),
+            source: "session",
+        };
+    }
+    if (!input.compatibilityProfile.trim()) {
+        throw new Error("A compatibility profile is required");
+    }
+    return {
+        requestedProfile: input.compatibilityProfile.trim(),
+        source: "compatibility_default",
+    };
+}
+/** Project a routing decision into immutable historical turn metadata. */
+export function createRoutingReceipt(decision, context) {
+    const oracle = decision.oracleConsultation
+        ? Object.freeze({
+            policyVersion: decision.oracleConsultation.policyVersion,
+            mode: decision.oracleConsultation.mode,
+            reasons: Object.freeze([...decision.oracleConsultation.reasons]),
+        })
+        : undefined;
+    const fallback = context.fallbackReason
+        ? Object.freeze({
+            reason: context.fallbackReason,
+            ...(context.fallbackModel ?? {}),
+        })
+        : undefined;
+    const experiment = context.experiment
+        ? Object.freeze({ ...context.experiment })
+        : undefined;
+    return Object.freeze({
+        decisionId: decision.decisionId,
+        requestedProfile: context.requestedProfile,
+        source: context.source,
+        resolvedProfileId: decision.selectedProfile.id,
+        resolvedProfileVersion: decision.selectedProfile.version,
+        provider: decision.selectedModel.provider,
+        model: decision.selectedModel.model,
+        reasoningEffort: decision.selectedProfile.primary.reasoningEffort,
+        createdAt: decision.createdAt,
+        ...(oracle ? { oracle } : {}),
+        ...(fallback ? { fallback } : {}),
+        ...(experiment ? { experiment } : {}),
+    });
+}
+//# sourceMappingURL=routing-receipt.js.map

package/dist/agent/routing-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-receipt.js","sourceRoot":"","sources":["../../src/agent/routing-receipt.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,4BAA4B,CAC3C,KAAiC;IAEjC,IAAI,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,OAAO;YACN,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC/C,MAAM,EAAE,SAAS;SACjB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,OAAO;YACN,gBAAgB,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE;YACjD,MAAM,EAAE,SAAS;SACjB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO;QACN,gBAAgB,EAAE,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE;QACnD,MAAM,EAAE,uBAAuB;KAC/B,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CACnC,QAAgC,EAChC,OAA8B;IAE9B,MAAM,MAAM,GAAG,QAAQ,CAAC,kBAAkB;QACzC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACd,aAAa,EAAE,QAAQ,CAAC,kBAAkB,CAAC,aAAa;YACxD,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,IAAI;YACtC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;SAChE,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc;QACtC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,OAAO,CAAC,cAAc;YAC9B,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;SAChC,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU;QACpC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEb,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,iBAAiB,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE;QAC9C,sBAAsB,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO;QACxD,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,QAAQ;QACzC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK;QACnC,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe;QACjE,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type {\n\tAgentProfilePin,\n\tRoutingReceipt,\n\tRoutingReceiptExperiment,\n\tRoutingReceiptSource,\n} from \"@evalops/contracts\";\nimport type { OracleConsultationDecision } from \"./oracle-consultation-policy.js\";\nimport type { AgentProfile } from \"./profiles.js\";\n\nexport interface AgentProfileSelectionInput {\n\trequestedProfile?: string;\n\tsessionPin?: AgentProfilePin;\n\tcompatibilityProfile: string;\n}\n\nexport interface AgentProfileSelection {\n\trequestedProfile: string;\n\tsource: RoutingReceiptSource;\n}\n\nexport interface RoutingReceiptDecision {\n\tdecisionId: string;\n\tselectedModel: { provider: string; model: string };\n\tselectedProfile: AgentProfile;\n\tcreatedAt: string;\n\toracleConsultation?: OracleConsultationDecision;\n}\n\nexport interface RoutingReceiptContext extends AgentProfileSelection {\n\tfallbackReason?: string;\n\tfallbackModel?: { provider: string; model: string };\n\texperiment?: RoutingReceiptExperiment;\n}\n\nexport function resolveAgentProfileSelection(\n\tinput: AgentProfileSelectionInput,\n): AgentProfileSelection {\n\tif (input.requestedProfile?.trim()) {\n\t\treturn {\n\t\t\trequestedProfile: input.requestedProfile.trim(),\n\t\t\tsource: \"request\",\n\t\t};\n\t}\n\tif (input.sessionPin?.profile.trim()) {\n\t\treturn {\n\t\t\trequestedProfile: input.sessionPin.profile.trim(),\n\t\t\tsource: \"session\",\n\t\t};\n\t}\n\tif (!input.compatibilityProfile.trim()) {\n\t\tthrow new Error(\"A compatibility profile is required\");\n\t}\n\treturn {\n\t\trequestedProfile: input.compatibilityProfile.trim(),\n\t\tsource: \"compatibility_default\",\n\t};\n}\n\n/** Project a routing decision into immutable historical turn metadata. */\nexport function createRoutingReceipt(\n\tdecision: RoutingReceiptDecision,\n\tcontext: RoutingReceiptContext,\n): RoutingReceipt {\n\tconst oracle = decision.oracleConsultation\n\t\t? Object.freeze({\n\t\t\t\tpolicyVersion: decision.oracleConsultation.policyVersion,\n\t\t\t\tmode: decision.oracleConsultation.mode,\n\t\t\t\treasons: Object.freeze([...decision.oracleConsultation.reasons]),\n\t\t\t})\n\t\t: undefined;\n\tconst fallback = context.fallbackReason\n\t\t? Object.freeze({\n\t\t\t\treason: context.fallbackReason,\n\t\t\t\t...(context.fallbackModel ?? {}),\n\t\t\t})\n\t\t: undefined;\n\tconst experiment = context.experiment\n\t\t? Object.freeze({ ...context.experiment })\n\t\t: undefined;\n\n\treturn Object.freeze({\n\t\tdecisionId: decision.decisionId,\n\t\trequestedProfile: context.requestedProfile,\n\t\tsource: context.source,\n\t\tresolvedProfileId: decision.selectedProfile.id,\n\t\tresolvedProfileVersion: decision.selectedProfile.version,\n\t\tprovider: decision.selectedModel.provider,\n\t\tmodel: decision.selectedModel.model,\n\t\treasoningEffort: decision.selectedProfile.primary.reasoningEffort,\n\t\tcreatedAt: decision.createdAt,\n\t\t...(oracle ? { oracle } : {}),\n\t\t...(fallback ? { fallback } : {}),\n\t\t...(experiment ? { experiment } : {}),\n\t});\n}\n"]}