@evalops/maestro 0.10.51 → 0.10.53

package/dist/agent/context-handoff.js

@@ -6,6 +6,7 @@
  *
  * Inspired by Amp's thread handoff feature.
  */
+import { estimateTokens } from "@evalops/contracts";
 import { createLogger } from "../utils/logger.js";
 const log = createLogger("agent:context-handoff");
 /** Default thresholds */
@@ -221,7 +222,7 @@ export function createContextHandoffManager(thresholds) {
  * Uses ~4 characters per token as a rough estimate.
  */
 export function estimateTokenCount(text) {
-    return Math.ceil(text.length / 4);
+    return estimateTokens(text);
 }
 /**
  * Format context usage for display.

package/dist/agent/context-handoff.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-handoff.js","sourceRoot":"","sources":["../../src/agent/context-handoff.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Context Handoff System.\n *\n * Manages automatic context handoff when approaching context limits.\n * Creates summarized new sessions to continue work without losing progress.\n *\n * Inspired by Amp's thread handoff feature.\n */\n\nimport { createLogger } from \"../utils/logger.js\";\n\nconst log = createLogger(\"agent:context-handoff\");\n\n/** Context usage thresholds */\nexport interface ContextThresholds {\n\t/** Warn when context usage exceeds this percentage (0-1) */\n\twarnAt: number;\n\t/** Suggest handoff when context usage exceeds this percentage (0-1) */\n\tsuggestHandoffAt: number;\n\t/** Force handoff when context usage exceeds this percentage (0-1) */\n\tforceHandoffAt: number;\n}\n\n/** Default thresholds */\nexport const DEFAULT_THRESHOLDS: ContextThresholds = {\n\twarnAt: 0.7,\n\tsuggestHandoffAt: 0.85,\n\tforceHandoffAt: 0.95,\n};\n\n/** Context usage status */\nexport type ContextStatus =\n\t| \"ok\"\n\t| \"warning\"\n\t| \"suggest_handoff\"\n\t| \"force_handoff\";\n\n/** Handoff context for creating a new session */\nexport interface HandoffContext {\n\t/** Summary of what was accomplished */\n\tsummary: string;\n\t/** Current task/goal being worked on */\n\tcurrentTask: string | null;\n\t/** Key files that were modified */\n\tmodifiedFiles: string[];\n\t/** Key files that were read/referenced */\n\treferencedFiles: string[];\n\t/** Any pending work or todos */\n\tpendingWork: string[];\n\t/** Important context that should carry over */\n\timportantContext: string[];\n\t/** Timestamp of handoff */\n\ttimestamp: Date;\n\t/** Previous session ID if available */\n\tpreviousSessionId?: string;\n}\n\n/** Context usage tracking */\nexport interface ContextUsage {\n\t/** Current token count */\n\tcurrentTokens: number;\n\t/** Maximum context window */\n\tmaxTokens: number;\n\t/** Usage percentage (0-1) */\n\tusagePercent: number;\n\t/** Current status */\n\tstatus: ContextStatus;\n\t/** Estimated tokens remaining */\n\ttokensRemaining: number;\n}\n\n/**\n * Context Handoff Manager.\n *\n * Tracks context usage and manages handoff when limits are approached.\n */\nexport class ContextHandoffManager {\n\tprivate thresholds: ContextThresholds;\n\tprivate modifiedFiles: Set<string> = new Set();\n\tprivate referencedFiles: Set<string> = new Set();\n\tprivate pendingWork: string[] = [];\n\tprivate importantContext: string[] = [];\n\tprivate currentTask: string | null = null;\n\tprivate lastStatus: ContextStatus = \"ok\";\n\n\tconstructor(thresholds: ContextThresholds = DEFAULT_THRESHOLDS) {\n\t\tthis.thresholds = thresholds;\n\t}\n\n\t/**\n\t * Check context usage and return status.\n\t */\n\tcheckUsage(currentTokens: number, maxTokens: number): ContextUsage {\n\t\tconst usagePercent = currentTokens / maxTokens;\n\t\tconst tokensRemaining = maxTokens - currentTokens;\n\n\t\tlet status: ContextStatus = \"ok\";\n\t\tif (usagePercent >= this.thresholds.forceHandoffAt) {\n\t\t\tstatus = \"force_handoff\";\n\t\t} else if (usagePercent >= this.thresholds.suggestHandoffAt) {\n\t\t\tstatus = \"suggest_handoff\";\n\t\t} else if (usagePercent >= this.thresholds.warnAt) {\n\t\t\tstatus = \"warning\";\n\t\t}\n\n\t\t// Log status changes\n\t\tif (status !== this.lastStatus) {\n\t\t\tlog.info(\"Context status changed\", {\n\t\t\t\tfrom: this.lastStatus,\n\t\t\t\tto: status,\n\t\t\t\tusagePercent: Math.round(usagePercent * 100),\n\t\t\t\ttokensRemaining,\n\t\t\t});\n\t\t\tthis.lastStatus = status;\n\t\t}\n\n\t\treturn {\n\t\t\tcurrentTokens,\n\t\t\tmaxTokens,\n\t\t\tusagePercent,\n\t\t\tstatus,\n\t\t\ttokensRemaining,\n\t\t};\n\t}\n\n\t/**\n\t * Record a file modification.\n\t */\n\trecordFileModification(path: string): void {\n\t\tthis.modifiedFiles.add(path);\n\t}\n\n\t/**\n\t * Record a file reference.\n\t */\n\trecordFileReference(path: string): void {\n\t\tthis.referencedFiles.add(path);\n\t}\n\n\t/**\n\t * Set the current task being worked on.\n\t */\n\tsetCurrentTask(task: string | null): void {\n\t\tthis.currentTask = task;\n\t}\n\n\t/**\n\t * Add pending work item.\n\t */\n\taddPendingWork(item: string): void {\n\t\tif (!this.pendingWork.includes(item)) {\n\t\t\tthis.pendingWork.push(item);\n\t\t}\n\t}\n\n\t/**\n\t * Remove completed work item.\n\t */\n\tcompletePendingWork(item: string): void {\n\t\tconst index = this.pendingWork.indexOf(item);\n\t\tif (index !== -1) {\n\t\t\tthis.pendingWork.splice(index, 1);\n\t\t}\n\t}\n\n\t/**\n\t * Add important context that should carry over to handoff.\n\t */\n\taddImportantContext(context: string): void {\n\t\tif (!this.importantContext.includes(context)) {\n\t\t\tthis.importantContext.push(context);\n\t\t}\n\t}\n\n\t/**\n\t * Clear important context.\n\t */\n\tclearImportantContext(): void {\n\t\tthis.importantContext = [];\n\t}\n\n\t/**\n\t * Generate handoff context for creating a new session.\n\t */\n\tgenerateHandoffContext(\n\t\tsummary: string,\n\t\tpreviousSessionId?: string,\n\t): HandoffContext {\n\t\treturn {\n\t\t\tsummary,\n\t\t\tcurrentTask: this.currentTask,\n\t\t\tmodifiedFiles: Array.from(this.modifiedFiles),\n\t\t\treferencedFiles: Array.from(this.referencedFiles),\n\t\t\tpendingWork: [...this.pendingWork],\n\t\t\timportantContext: [...this.importantContext],\n\t\t\ttimestamp: new Date(),\n\t\t\tpreviousSessionId,\n\t\t};\n\t}\n\n\t/**\n\t * Format handoff context as a prompt for the new session.\n\t */\n\tformatHandoffPrompt(context: HandoffContext): string {\n\t\tconst lines: string[] = [\n\t\t\t\"# Context Handoff\",\n\t\t\t\"\",\n\t\t\t\"This session continues from a previous conversation that reached its context limit.\",\n\t\t\t\"\",\n\t\t\t\"## Summary of Previous Work\",\n\t\t\tcontext.summary,\n\t\t\t\"\",\n\t\t];\n\n\t\tif (context.currentTask) {\n\t\t\tlines.push(\"## Current Task\", context.currentTask, \"\");\n\t\t}\n\n\t\tif (context.modifiedFiles.length > 0) {\n\t\t\tlines.push(\"## Modified Files\");\n\t\t\tfor (const file of context.modifiedFiles.slice(0, 20)) {\n\t\t\t\tlines.push(`- ${file}`);\n\t\t\t}\n\t\t\tif (context.modifiedFiles.length > 20) {\n\t\t\t\tlines.push(`- ... and ${context.modifiedFiles.length - 20} more`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tif (context.referencedFiles.length > 0) {\n\t\t\tlines.push(\"## Referenced Files\");\n\t\t\tfor (const file of context.referencedFiles.slice(0, 20)) {\n\t\t\t\tlines.push(`- ${file}`);\n\t\t\t}\n\t\t\tif (context.referencedFiles.length > 20) {\n\t\t\t\tlines.push(`- ... and ${context.referencedFiles.length - 20} more`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tif (context.pendingWork.length > 0) {\n\t\t\tlines.push(\"## Pending Work\");\n\t\t\tfor (const item of context.pendingWork) {\n\t\t\t\tlines.push(`- [ ] ${item}`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tif (context.importantContext.length > 0) {\n\t\t\tlines.push(\"## Important Context\");\n\t\t\tfor (const item of context.importantContext) {\n\t\t\t\tlines.push(`- ${item}`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tlines.push(\n\t\t\t\"---\",\n\t\t\t\"\",\n\t\t\t\"Please continue with the work described above. You can read the modified files to understand the current state.\",\n\t\t);\n\n\t\treturn lines.join(\"\\n\");\n\t}\n\n\t/**\n\t * Get status message for user display.\n\t */\n\tgetStatusMessage(usage: ContextUsage): string | null {\n\t\tswitch (usage.status) {\n\t\t\tcase \"warning\":\n\t\t\t\treturn `Context ${Math.round(usage.usagePercent * 100)}% used. Consider wrapping up soon.`;\n\t\t\tcase \"suggest_handoff\":\n\t\t\t\treturn `Context near full (${Math.round(usage.usagePercent * 100)}%). Use /handoff to continue in a new session.`;\n\t\t\tcase \"force_handoff\":\n\t\t\t\treturn `Context limit reached (${Math.round(usage.usagePercent * 100)}%). Handoff required to continue.`;\n\t\t\tdefault:\n\t\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * Reset tracking state (e.g., for a new session).\n\t */\n\treset(): void {\n\t\tthis.modifiedFiles.clear();\n\t\tthis.referencedFiles.clear();\n\t\tthis.pendingWork = [];\n\t\tthis.importantContext = [];\n\t\tthis.currentTask = null;\n\t\tthis.lastStatus = \"ok\";\n\t}\n}\n\n/**\n * Create a default context handoff manager.\n */\nexport function createContextHandoffManager(\n\tthresholds?: Partial<ContextThresholds>,\n): ContextHandoffManager {\n\treturn new ContextHandoffManager({\n\t\t...DEFAULT_THRESHOLDS,\n\t\t...thresholds,\n\t});\n}\n\n/**\n * Estimate token count from text (rough approximation).\n * Uses ~4 characters per token as a rough estimate.\n */\nexport function estimateTokenCount(text: string): number {\n\treturn Math.ceil(text.length / 4);\n}\n\n/**\n * Format context usage for display.\n */\nexport function formatContextUsage(usage: ContextUsage): string {\n\tconst percent = Math.round(usage.usagePercent * 100);\n\tconst remaining = Math.round(usage.tokensRemaining / 1000);\n\treturn `${percent}% (${remaining}K tokens remaining)`;\n}\n"]}
+{"version":3,"file":"context-handoff.js","sourceRoot":"","sources":["../../src/agent/context-handoff.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Context Handoff System.\n *\n * Manages automatic context handoff when approaching context limits.\n * Creates summarized new sessions to continue work without losing progress.\n *\n * Inspired by Amp's thread handoff feature.\n */\n\nimport { estimateTokens } from \"@evalops/contracts\";\nimport { createLogger } from \"../utils/logger.js\";\n\nconst log = createLogger(\"agent:context-handoff\");\n\n/** Context usage thresholds */\nexport interface ContextThresholds {\n\t/** Warn when context usage exceeds this percentage (0-1) */\n\twarnAt: number;\n\t/** Suggest handoff when context usage exceeds this percentage (0-1) */\n\tsuggestHandoffAt: number;\n\t/** Force handoff when context usage exceeds this percentage (0-1) */\n\tforceHandoffAt: number;\n}\n\n/** Default thresholds */\nexport const DEFAULT_THRESHOLDS: ContextThresholds = {\n\twarnAt: 0.7,\n\tsuggestHandoffAt: 0.85,\n\tforceHandoffAt: 0.95,\n};\n\n/** Context usage status */\nexport type ContextStatus =\n\t| \"ok\"\n\t| \"warning\"\n\t| \"suggest_handoff\"\n\t| \"force_handoff\";\n\n/** Handoff context for creating a new session */\nexport interface HandoffContext {\n\t/** Summary of what was accomplished */\n\tsummary: string;\n\t/** Current task/goal being worked on */\n\tcurrentTask: string | null;\n\t/** Key files that were modified */\n\tmodifiedFiles: string[];\n\t/** Key files that were read/referenced */\n\treferencedFiles: string[];\n\t/** Any pending work or todos */\n\tpendingWork: string[];\n\t/** Important context that should carry over */\n\timportantContext: string[];\n\t/** Timestamp of handoff */\n\ttimestamp: Date;\n\t/** Previous session ID if available */\n\tpreviousSessionId?: string;\n}\n\n/** Context usage tracking */\nexport interface ContextUsage {\n\t/** Current token count */\n\tcurrentTokens: number;\n\t/** Maximum context window */\n\tmaxTokens: number;\n\t/** Usage percentage (0-1) */\n\tusagePercent: number;\n\t/** Current status */\n\tstatus: ContextStatus;\n\t/** Estimated tokens remaining */\n\ttokensRemaining: number;\n}\n\n/**\n * Context Handoff Manager.\n *\n * Tracks context usage and manages handoff when limits are approached.\n */\nexport class ContextHandoffManager {\n\tprivate thresholds: ContextThresholds;\n\tprivate modifiedFiles: Set<string> = new Set();\n\tprivate referencedFiles: Set<string> = new Set();\n\tprivate pendingWork: string[] = [];\n\tprivate importantContext: string[] = [];\n\tprivate currentTask: string | null = null;\n\tprivate lastStatus: ContextStatus = \"ok\";\n\n\tconstructor(thresholds: ContextThresholds = DEFAULT_THRESHOLDS) {\n\t\tthis.thresholds = thresholds;\n\t}\n\n\t/**\n\t * Check context usage and return status.\n\t */\n\tcheckUsage(currentTokens: number, maxTokens: number): ContextUsage {\n\t\tconst usagePercent = currentTokens / maxTokens;\n\t\tconst tokensRemaining = maxTokens - currentTokens;\n\n\t\tlet status: ContextStatus = \"ok\";\n\t\tif (usagePercent >= this.thresholds.forceHandoffAt) {\n\t\t\tstatus = \"force_handoff\";\n\t\t} else if (usagePercent >= this.thresholds.suggestHandoffAt) {\n\t\t\tstatus = \"suggest_handoff\";\n\t\t} else if (usagePercent >= this.thresholds.warnAt) {\n\t\t\tstatus = \"warning\";\n\t\t}\n\n\t\t// Log status changes\n\t\tif (status !== this.lastStatus) {\n\t\t\tlog.info(\"Context status changed\", {\n\t\t\t\tfrom: this.lastStatus,\n\t\t\t\tto: status,\n\t\t\t\tusagePercent: Math.round(usagePercent * 100),\n\t\t\t\ttokensRemaining,\n\t\t\t});\n\t\t\tthis.lastStatus = status;\n\t\t}\n\n\t\treturn {\n\t\t\tcurrentTokens,\n\t\t\tmaxTokens,\n\t\t\tusagePercent,\n\t\t\tstatus,\n\t\t\ttokensRemaining,\n\t\t};\n\t}\n\n\t/**\n\t * Record a file modification.\n\t */\n\trecordFileModification(path: string): void {\n\t\tthis.modifiedFiles.add(path);\n\t}\n\n\t/**\n\t * Record a file reference.\n\t */\n\trecordFileReference(path: string): void {\n\t\tthis.referencedFiles.add(path);\n\t}\n\n\t/**\n\t * Set the current task being worked on.\n\t */\n\tsetCurrentTask(task: string | null): void {\n\t\tthis.currentTask = task;\n\t}\n\n\t/**\n\t * Add pending work item.\n\t */\n\taddPendingWork(item: string): void {\n\t\tif (!this.pendingWork.includes(item)) {\n\t\t\tthis.pendingWork.push(item);\n\t\t}\n\t}\n\n\t/**\n\t * Remove completed work item.\n\t */\n\tcompletePendingWork(item: string): void {\n\t\tconst index = this.pendingWork.indexOf(item);\n\t\tif (index !== -1) {\n\t\t\tthis.pendingWork.splice(index, 1);\n\t\t}\n\t}\n\n\t/**\n\t * Add important context that should carry over to handoff.\n\t */\n\taddImportantContext(context: string): void {\n\t\tif (!this.importantContext.includes(context)) {\n\t\t\tthis.importantContext.push(context);\n\t\t}\n\t}\n\n\t/**\n\t * Clear important context.\n\t */\n\tclearImportantContext(): void {\n\t\tthis.importantContext = [];\n\t}\n\n\t/**\n\t * Generate handoff context for creating a new session.\n\t */\n\tgenerateHandoffContext(\n\t\tsummary: string,\n\t\tpreviousSessionId?: string,\n\t): HandoffContext {\n\t\treturn {\n\t\t\tsummary,\n\t\t\tcurrentTask: this.currentTask,\n\t\t\tmodifiedFiles: Array.from(this.modifiedFiles),\n\t\t\treferencedFiles: Array.from(this.referencedFiles),\n\t\t\tpendingWork: [...this.pendingWork],\n\t\t\timportantContext: [...this.importantContext],\n\t\t\ttimestamp: new Date(),\n\t\t\tpreviousSessionId,\n\t\t};\n\t}\n\n\t/**\n\t * Format handoff context as a prompt for the new session.\n\t */\n\tformatHandoffPrompt(context: HandoffContext): string {\n\t\tconst lines: string[] = [\n\t\t\t\"# Context Handoff\",\n\t\t\t\"\",\n\t\t\t\"This session continues from a previous conversation that reached its context limit.\",\n\t\t\t\"\",\n\t\t\t\"## Summary of Previous Work\",\n\t\t\tcontext.summary,\n\t\t\t\"\",\n\t\t];\n\n\t\tif (context.currentTask) {\n\t\t\tlines.push(\"## Current Task\", context.currentTask, \"\");\n\t\t}\n\n\t\tif (context.modifiedFiles.length > 0) {\n\t\t\tlines.push(\"## Modified Files\");\n\t\t\tfor (const file of context.modifiedFiles.slice(0, 20)) {\n\t\t\t\tlines.push(`- ${file}`);\n\t\t\t}\n\t\t\tif (context.modifiedFiles.length > 20) {\n\t\t\t\tlines.push(`- ... and ${context.modifiedFiles.length - 20} more`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tif (context.referencedFiles.length > 0) {\n\t\t\tlines.push(\"## Referenced Files\");\n\t\t\tfor (const file of context.referencedFiles.slice(0, 20)) {\n\t\t\t\tlines.push(`- ${file}`);\n\t\t\t}\n\t\t\tif (context.referencedFiles.length > 20) {\n\t\t\t\tlines.push(`- ... and ${context.referencedFiles.length - 20} more`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tif (context.pendingWork.length > 0) {\n\t\t\tlines.push(\"## Pending Work\");\n\t\t\tfor (const item of context.pendingWork) {\n\t\t\t\tlines.push(`- [ ] ${item}`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tif (context.importantContext.length > 0) {\n\t\t\tlines.push(\"## Important Context\");\n\t\t\tfor (const item of context.importantContext) {\n\t\t\t\tlines.push(`- ${item}`);\n\t\t\t}\n\t\t\tlines.push(\"\");\n\t\t}\n\n\t\tlines.push(\n\t\t\t\"---\",\n\t\t\t\"\",\n\t\t\t\"Please continue with the work described above. You can read the modified files to understand the current state.\",\n\t\t);\n\n\t\treturn lines.join(\"\\n\");\n\t}\n\n\t/**\n\t * Get status message for user display.\n\t */\n\tgetStatusMessage(usage: ContextUsage): string | null {\n\t\tswitch (usage.status) {\n\t\t\tcase \"warning\":\n\t\t\t\treturn `Context ${Math.round(usage.usagePercent * 100)}% used. Consider wrapping up soon.`;\n\t\t\tcase \"suggest_handoff\":\n\t\t\t\treturn `Context near full (${Math.round(usage.usagePercent * 100)}%). Use /handoff to continue in a new session.`;\n\t\t\tcase \"force_handoff\":\n\t\t\t\treturn `Context limit reached (${Math.round(usage.usagePercent * 100)}%). Handoff required to continue.`;\n\t\t\tdefault:\n\t\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * Reset tracking state (e.g., for a new session).\n\t */\n\treset(): void {\n\t\tthis.modifiedFiles.clear();\n\t\tthis.referencedFiles.clear();\n\t\tthis.pendingWork = [];\n\t\tthis.importantContext = [];\n\t\tthis.currentTask = null;\n\t\tthis.lastStatus = \"ok\";\n\t}\n}\n\n/**\n * Create a default context handoff manager.\n */\nexport function createContextHandoffManager(\n\tthresholds?: Partial<ContextThresholds>,\n): ContextHandoffManager {\n\treturn new ContextHandoffManager({\n\t\t...DEFAULT_THRESHOLDS,\n\t\t...thresholds,\n\t});\n}\n\n/**\n * Estimate token count from text (rough approximation).\n * Uses ~4 characters per token as a rough estimate.\n */\nexport function estimateTokenCount(text: string): number {\n\treturn estimateTokens(text);\n}\n\n/**\n * Format context usage for display.\n */\nexport function formatContextUsage(usage: ContextUsage): string {\n\tconst percent = Math.round(usage.usagePercent * 100);\n\tconst remaining = Math.round(usage.tokensRemaining / 1000);\n\treturn `${percent}% (${remaining}K tokens remaining)`;\n}\n"]}

package/dist/agent/index.d.ts

@@ -9,8 +9,15 @@ export { FileTranscriptStore, MemoryTranscriptStore, createTranscript, updateTra
 export { AutoCompactionMonitor, createAutoCompactionMonitor, getAutoCompactionConfig, calculateContextUsage, shouldAutoCompact, type AutoCompactionConfig, type CompactionStats, } from "./auto-compaction.js";
 export { enterPlanMode, exitPlanMode, isPlanModeActive, getCurrentPlanFilePath, readPlanFile, writePlanFile, appendToPlanFile, listPlanFiles, loadPlanModeState, savePlanModeState, clearPlanModeState, generatePlanFilePath, getPlanModeConfig, type PlanModeState, type PlanModeConfig, } from "./plan-mode.js";
 export { SessionRecoveryManager, createSessionRecoveryManager, saveSessionBackup, loadSessionBackup, listSessionBackups, cleanupExpiredBackups, deleteSessionBackups, getSessionRecoveryConfig, type SessionBackup, type SessionRecoveryConfig, } from "./session-recovery.js";
-export { PromptCacheManager, createPromptCacheManager, getPromptCacheConfig, estimateTokens, type CacheControl, type CacheableBlock, type CacheStats, type PromptCacheConfig, } from "./prompt-cache.js";
+export { PromptCacheManager, createPromptCacheManager, getPromptCacheConfig, type CacheControl, type CacheableBlock, type CacheStats, type PromptCacheConfig, } from "./prompt-cache.js";
 export { MODE_CONFIGS, MODEL_BY_TIER, formatModeDisplay, getAllModes, getCurrentMode, getModeConfig, getModeFromEnv, getModelForMode, getModelForTier, parseMode, resolveSubagentDispatch, setCurrentMode, suggestMode, type AgentMode, type DispatchSource, type ModeConfig, type ModelMapping, type ModelProvider, type ModelTier, type ResolvedSubagentDispatch, type SubagentDispatch, } from "./modes.js";
+export { AGENT_PROFILES, AGENT_PROFILE_LEVELS, type AgentProfile, type AgentProfileBudgets, type AgentProfileLevel, type ModelInvocationProfile, parseAgentProfileLevel, resolveAgentProfile, } from "./profiles.js";
+export { createPluginAgentApi, type PluginAgentApi, type PluginAgentBudgets, type PluginAgentConfig, type PluginAgentHandle, type PluginAgentModeMetadata, type PluginAgentModeRegistration, type PluginAgentPolicy, type PluginAgentSandboxMode, type RegisteredPluginAgentMode, } from "./plugin-agent-api.js";
+export { loadConfiguredPluginAgentMetadata, loadPluginAgentMetadataFromDirectories, type LoadedPluginAgentModeMetadata, type PluginAgentMetadataLoadResult, } from "./plugin-agent-loader.js";
+export { createRoutingReceipt, resolveAgentProfileSelection, type AgentProfileSelection, type AgentProfileSelectionInput, type RoutingReceiptContext, type RoutingReceiptDecision, } from "./routing-receipt.js";
+export { assignOraclePolicyExperiment, assignConfiguredOraclePolicyExperiment, getOraclePolicyExperimentConfig, type OraclePolicyExperimentArm, type OraclePolicyExperimentAssignment, type OraclePolicyExperimentConfig, type OraclePolicyExperimentInput, } from "./oracle-policy-experiment.js";
+export { DEFAULT_ORACLE_ROLLOUT_MAX_SUCCESS_RATE_REGRESSION, DEFAULT_ORACLE_ROLLOUT_MIN_VERIFIED_SAMPLES, evaluateOraclePolicyRollout, type OraclePolicyRolloutDecision, type OraclePolicyRolloutInput, type OraclePolicyRolloutMetrics, type OraclePolicyRolloutStatus, type OraclePolicyVerifiedAggregate, } from "./oracle-policy-rollout.js";
+export { loadAgentProfiles, loadAgentProfilesFromDirectory, } from "./profile-loader.js";
 export { ContextHandoffManager, createContextHandoffManager, estimateTokenCount, formatContextUsage, DEFAULT_THRESHOLDS, type ContextThresholds, type ContextStatus, type ContextUsage, type HandoffContext, } from "./context-handoff.js";
 export { SUBAGENT_SPECS, TOOL_CATEGORIES, createCustomSpec, filterToolsForSubagent, formatSubagentDisplay, getAllSubagentTypes, getAllowedTools, getCurrentSubagentType, getSubagentSpec, getSubagentTypeFromEnv, isToolAllowed, parseSubagentType, setCurrentSubagentType, validateSpec, type SubagentSpec, type SubagentType, } from "./subagent-specs.js";
 export type { AgentEvent, AgentMessage, AgentRunConfig, AgentState, AgentTool, AgentToolResult, AgentToolUpdateCallback, AgentTransport, Api, AppMessage, AssistantMessage, AssistantMessageEvent, Attachment, BranchSummaryMessage, CompactionSummaryMessage, Context, CustomAgentMessages, CustomMessages, HookMessage, ImageContent, Message, Model, Provider, QueuedMessage, ReasoningEffort, StopReason, StreamOptions, TextContent, ThinkingContent, ThinkingLevel, Tool, ToolCall, ToolResultMessage, Usage, UserMessage, UserMessageWithAttachments, } from "./types.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"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"}

package/dist/agent/index.js

@@ -9,8 +9,15 @@ export { FileTranscriptStore, MemoryTranscriptStore, createTranscript, updateTra
 export { AutoCompactionMonitor, createAutoCompactionMonitor, getAutoCompactionConfig, calculateContextUsage, shouldAutoCompact, } from "./auto-compaction.js";
 export { enterPlanMode, exitPlanMode, isPlanModeActive, getCurrentPlanFilePath, readPlanFile, writePlanFile, appendToPlanFile, listPlanFiles, loadPlanModeState, savePlanModeState, clearPlanModeState, generatePlanFilePath, getPlanModeConfig, } from "./plan-mode.js";
 export { SessionRecoveryManager, createSessionRecoveryManager, saveSessionBackup, loadSessionBackup, listSessionBackups, cleanupExpiredBackups, deleteSessionBackups, getSessionRecoveryConfig, } from "./session-recovery.js";
-export { PromptCacheManager, createPromptCacheManager, getPromptCacheConfig, estimateTokens, } from "./prompt-cache.js";
+export { PromptCacheManager, createPromptCacheManager, getPromptCacheConfig, } from "./prompt-cache.js";
 export { MODE_CONFIGS, MODEL_BY_TIER, formatModeDisplay, getAllModes, getCurrentMode, getModeConfig, getModeFromEnv, getModelForMode, getModelForTier, parseMode, resolveSubagentDispatch, setCurrentMode, suggestMode, } from "./modes.js";
+export { AGENT_PROFILES, AGENT_PROFILE_LEVELS, parseAgentProfileLevel, resolveAgentProfile, } from "./profiles.js";
+export { createPluginAgentApi, } from "./plugin-agent-api.js";
+export { loadConfiguredPluginAgentMetadata, loadPluginAgentMetadataFromDirectories, } from "./plugin-agent-loader.js";
+export { createRoutingReceipt, resolveAgentProfileSelection, } from "./routing-receipt.js";
+export { assignOraclePolicyExperiment, assignConfiguredOraclePolicyExperiment, getOraclePolicyExperimentConfig, } from "./oracle-policy-experiment.js";
+export { DEFAULT_ORACLE_ROLLOUT_MAX_SUCCESS_RATE_REGRESSION, DEFAULT_ORACLE_ROLLOUT_MIN_VERIFIED_SAMPLES, evaluateOraclePolicyRollout, } from "./oracle-policy-rollout.js";
+export { loadAgentProfiles, loadAgentProfilesFromDirectory, } from "./profile-loader.js";
 export { ContextHandoffManager, createContextHandoffManager, estimateTokenCount, formatContextUsage, DEFAULT_THRESHOLDS, } from "./context-handoff.js";
 export { SUBAGENT_SPECS, TOOL_CATEGORIES, createCustomSpec, filterToolsForSubagent, formatSubagentDisplay, getAllSubagentTypes, getAllowedTools, getCurrentSubagentType, getSubagentSpec, getSubagentTypeFromEnv, isToolAllowed, parseSubagentType, setCurrentSubagentType, validateSpec, } from "./subagent-specs.js";
 export { 

package/dist/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EACN,mBAAmB,GAInB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,iBAAiB,GAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACN,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,GAKpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,GAGzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,GAGjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAGjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,sBAAsB,EACtB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GAGxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,GAKd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,SAAS,EACT,uBAAuB,EACvB,cAAc,EACd,WAAW,GASX,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GAKlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,GAGZ,MAAM,qBAAqB,CAAC;AAuC7B,OAAO;AACN,sBAAsB;AACtB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,cAAc,EACd,YAAY;AACZ,sBAAsB;AACtB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,UAAU;AACV,oBAAoB;AACpB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { Agent, type AgentOptions } from \"./agent.js\";\nexport {\n\tAgentContextManager,\n\ttype AgentContextSource,\n\ttype ContextLoadResult,\n\ttype SourceLoadStatus,\n} from \"./context-manager.js\";\nexport {\n\tProviderTransport,\n\ttype ProviderTransportOptions,\n} from \"./transport.js\";\nexport { sanitizeSurrogates } from \"./providers/sanitize-unicode.js\";\nexport { StringEnum } from \"./providers/typebox-helpers.js\";\nexport { validateToolArguments } from \"./providers/validation.js\";\nexport {\n\tSystemReminderManager,\n\tcreateDefaultReminderManager,\n\twrapInSystemReminder,\n\textractSystemReminders,\n\tstripSystemReminders,\n\ttodoReminderProvider,\n\tfileReadReminderProvider,\n\teditReminderProvider,\n\ttype SystemReminder,\n\ttype ReminderContext,\n\ttype ReminderProvider,\n\ttype ReminderManagerConfig,\n} from \"./system-reminders.js\";\nexport {\n\tFileTranscriptStore,\n\tMemoryTranscriptStore,\n\tcreateTranscript,\n\tupdateTranscript,\n\tcompleteTranscript,\n\tfailTranscript,\n\tgetTranscriptSummary,\n\tbuildResumePrompt,\n\tgetDefaultTranscriptStore,\n\tsetDefaultTranscriptStore,\n\ttype AgentTranscript,\n\ttype TranscriptStore,\n} from \"./agent-resume.js\";\nexport {\n\tAutoCompactionMonitor,\n\tcreateAutoCompactionMonitor,\n\tgetAutoCompactionConfig,\n\tcalculateContextUsage,\n\tshouldAutoCompact,\n\ttype AutoCompactionConfig,\n\ttype CompactionStats,\n} from \"./auto-compaction.js\";\nexport {\n\tenterPlanMode,\n\texitPlanMode,\n\tisPlanModeActive,\n\tgetCurrentPlanFilePath,\n\treadPlanFile,\n\twritePlanFile,\n\tappendToPlanFile,\n\tlistPlanFiles,\n\tloadPlanModeState,\n\tsavePlanModeState,\n\tclearPlanModeState,\n\tgeneratePlanFilePath,\n\tgetPlanModeConfig,\n\ttype PlanModeState,\n\ttype PlanModeConfig,\n} from \"./plan-mode.js\";\nexport {\n\tSessionRecoveryManager,\n\tcreateSessionRecoveryManager,\n\tsaveSessionBackup,\n\tloadSessionBackup,\n\tlistSessionBackups,\n\tcleanupExpiredBackups,\n\tdeleteSessionBackups,\n\tgetSessionRecoveryConfig,\n\ttype SessionBackup,\n\ttype SessionRecoveryConfig,\n} from \"./session-recovery.js\";\nexport {\n\tPromptCacheManager,\n\tcreatePromptCacheManager,\n\tgetPromptCacheConfig,\n\testimateTokens,\n\ttype CacheControl,\n\ttype CacheableBlock,\n\ttype CacheStats,\n\ttype PromptCacheConfig,\n} from \"./prompt-cache.js\";\nexport {\n\tMODE_CONFIGS,\n\tMODEL_BY_TIER,\n\tformatModeDisplay,\n\tgetAllModes,\n\tgetCurrentMode,\n\tgetModeConfig,\n\tgetModeFromEnv,\n\tgetModelForMode,\n\tgetModelForTier,\n\tparseMode,\n\tresolveSubagentDispatch,\n\tsetCurrentMode,\n\tsuggestMode,\n\ttype AgentMode,\n\ttype DispatchSource,\n\ttype ModeConfig,\n\ttype ModelMapping,\n\ttype ModelProvider,\n\ttype ModelTier,\n\ttype ResolvedSubagentDispatch,\n\ttype SubagentDispatch,\n} from \"./modes.js\";\nexport {\n\tContextHandoffManager,\n\tcreateContextHandoffManager,\n\testimateTokenCount,\n\tformatContextUsage,\n\tDEFAULT_THRESHOLDS,\n\ttype ContextThresholds,\n\ttype ContextStatus,\n\ttype ContextUsage,\n\ttype HandoffContext,\n} from \"./context-handoff.js\";\nexport {\n\tSUBAGENT_SPECS,\n\tTOOL_CATEGORIES,\n\tcreateCustomSpec,\n\tfilterToolsForSubagent,\n\tformatSubagentDisplay,\n\tgetAllSubagentTypes,\n\tgetAllowedTools,\n\tgetCurrentSubagentType,\n\tgetSubagentSpec,\n\tgetSubagentTypeFromEnv,\n\tisToolAllowed,\n\tparseSubagentType,\n\tsetCurrentSubagentType,\n\tvalidateSpec,\n\ttype SubagentSpec,\n\ttype SubagentType,\n} from \"./subagent-specs.js\";\nexport type {\n\tAgentEvent,\n\tAgentMessage,\n\tAgentRunConfig,\n\tAgentState,\n\tAgentTool,\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tAgentTransport,\n\tApi,\n\tAppMessage,\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tAttachment,\n\tBranchSummaryMessage,\n\tCompactionSummaryMessage,\n\tContext,\n\tCustomAgentMessages,\n\tCustomMessages,\n\tHookMessage,\n\tImageContent,\n\tMessage,\n\tModel,\n\tProvider,\n\tQueuedMessage,\n\tReasoningEffort,\n\tStopReason,\n\tStreamOptions,\n\tTextContent,\n\tThinkingContent,\n\tThinkingLevel,\n\tTool,\n\tToolCall,\n\tToolResultMessage,\n\tUsage,\n\tUserMessage,\n\tUserMessageWithAttachments,\n} from \"./types.js\";\nexport {\n\t// Message type guards\n\tisUserMessage,\n\tisAssistantMessage,\n\tisToolResultMessage,\n\tisHookMessage,\n\tisBranchSummaryMessage,\n\tisCompactionSummaryMessage,\n\tisUserMessageWithAttachments,\n\thasAttachments,\n\tisLLMMessage,\n\t// Content type guards\n\tisTextContent,\n\tisThinkingContent,\n\tisImageContent,\n\tisToolCall,\n\t// Utility functions\n\tgetToolCalls,\n\tgetTextContent,\n\tgetThinkingContent,\n\thasToolCalls,\n\tgetUserMessageText,\n\tgetFirstToolCall,\n\tisErrorResult,\n\tgetLastAssistantMessage,\n\tgetLastUserMessage,\n\tcountMessagesByRole,\n\tgetImageContent,\n} from \"./type-guards.js\";\nexport { convertToLlm, isLlmMessage } from \"./message-converter.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"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","sourcesContent":["export { Agent, type AgentOptions } from \"./agent.js\";\nexport {\n\tAgentContextManager,\n\ttype AgentContextSource,\n\ttype ContextLoadResult,\n\ttype SourceLoadStatus,\n} from \"./context-manager.js\";\nexport {\n\tProviderTransport,\n\ttype ProviderTransportOptions,\n} from \"./transport.js\";\nexport { sanitizeSurrogates } from \"./providers/sanitize-unicode.js\";\nexport { StringEnum } from \"./providers/typebox-helpers.js\";\nexport { validateToolArguments } from \"./providers/validation.js\";\nexport {\n\tSystemReminderManager,\n\tcreateDefaultReminderManager,\n\twrapInSystemReminder,\n\textractSystemReminders,\n\tstripSystemReminders,\n\ttodoReminderProvider,\n\tfileReadReminderProvider,\n\teditReminderProvider,\n\ttype SystemReminder,\n\ttype ReminderContext,\n\ttype ReminderProvider,\n\ttype ReminderManagerConfig,\n} from \"./system-reminders.js\";\nexport {\n\tFileTranscriptStore,\n\tMemoryTranscriptStore,\n\tcreateTranscript,\n\tupdateTranscript,\n\tcompleteTranscript,\n\tfailTranscript,\n\tgetTranscriptSummary,\n\tbuildResumePrompt,\n\tgetDefaultTranscriptStore,\n\tsetDefaultTranscriptStore,\n\ttype AgentTranscript,\n\ttype TranscriptStore,\n} from \"./agent-resume.js\";\nexport {\n\tAutoCompactionMonitor,\n\tcreateAutoCompactionMonitor,\n\tgetAutoCompactionConfig,\n\tcalculateContextUsage,\n\tshouldAutoCompact,\n\ttype AutoCompactionConfig,\n\ttype CompactionStats,\n} from \"./auto-compaction.js\";\nexport {\n\tenterPlanMode,\n\texitPlanMode,\n\tisPlanModeActive,\n\tgetCurrentPlanFilePath,\n\treadPlanFile,\n\twritePlanFile,\n\tappendToPlanFile,\n\tlistPlanFiles,\n\tloadPlanModeState,\n\tsavePlanModeState,\n\tclearPlanModeState,\n\tgeneratePlanFilePath,\n\tgetPlanModeConfig,\n\ttype PlanModeState,\n\ttype PlanModeConfig,\n} from \"./plan-mode.js\";\nexport {\n\tSessionRecoveryManager,\n\tcreateSessionRecoveryManager,\n\tsaveSessionBackup,\n\tloadSessionBackup,\n\tlistSessionBackups,\n\tcleanupExpiredBackups,\n\tdeleteSessionBackups,\n\tgetSessionRecoveryConfig,\n\ttype SessionBackup,\n\ttype SessionRecoveryConfig,\n} from \"./session-recovery.js\";\nexport {\n\tPromptCacheManager,\n\tcreatePromptCacheManager,\n\tgetPromptCacheConfig,\n\ttype CacheControl,\n\ttype CacheableBlock,\n\ttype CacheStats,\n\ttype PromptCacheConfig,\n} from \"./prompt-cache.js\";\nexport {\n\tMODE_CONFIGS,\n\tMODEL_BY_TIER,\n\tformatModeDisplay,\n\tgetAllModes,\n\tgetCurrentMode,\n\tgetModeConfig,\n\tgetModeFromEnv,\n\tgetModelForMode,\n\tgetModelForTier,\n\tparseMode,\n\tresolveSubagentDispatch,\n\tsetCurrentMode,\n\tsuggestMode,\n\ttype AgentMode,\n\ttype DispatchSource,\n\ttype ModeConfig,\n\ttype ModelMapping,\n\ttype ModelProvider,\n\ttype ModelTier,\n\ttype ResolvedSubagentDispatch,\n\ttype SubagentDispatch,\n} from \"./modes.js\";\nexport {\n\tAGENT_PROFILES,\n\tAGENT_PROFILE_LEVELS,\n\ttype AgentProfile,\n\ttype AgentProfileBudgets,\n\ttype AgentProfileLevel,\n\ttype ModelInvocationProfile,\n\tparseAgentProfileLevel,\n\tresolveAgentProfile,\n} from \"./profiles.js\";\nexport {\n\tcreatePluginAgentApi,\n\ttype PluginAgentApi,\n\ttype PluginAgentBudgets,\n\ttype PluginAgentConfig,\n\ttype PluginAgentHandle,\n\ttype PluginAgentModeMetadata,\n\ttype PluginAgentModeRegistration,\n\ttype PluginAgentPolicy,\n\ttype PluginAgentSandboxMode,\n\ttype RegisteredPluginAgentMode,\n} from \"./plugin-agent-api.js\";\nexport {\n\tloadConfiguredPluginAgentMetadata,\n\tloadPluginAgentMetadataFromDirectories,\n\ttype LoadedPluginAgentModeMetadata,\n\ttype PluginAgentMetadataLoadResult,\n} from \"./plugin-agent-loader.js\";\nexport {\n\tcreateRoutingReceipt,\n\tresolveAgentProfileSelection,\n\ttype AgentProfileSelection,\n\ttype AgentProfileSelectionInput,\n\ttype RoutingReceiptContext,\n\ttype RoutingReceiptDecision,\n} from \"./routing-receipt.js\";\nexport {\n\tassignOraclePolicyExperiment,\n\tassignConfiguredOraclePolicyExperiment,\n\tgetOraclePolicyExperimentConfig,\n\ttype OraclePolicyExperimentArm,\n\ttype OraclePolicyExperimentAssignment,\n\ttype OraclePolicyExperimentConfig,\n\ttype OraclePolicyExperimentInput,\n} from \"./oracle-policy-experiment.js\";\nexport {\n\tDEFAULT_ORACLE_ROLLOUT_MAX_SUCCESS_RATE_REGRESSION,\n\tDEFAULT_ORACLE_ROLLOUT_MIN_VERIFIED_SAMPLES,\n\tevaluateOraclePolicyRollout,\n\ttype OraclePolicyRolloutDecision,\n\ttype OraclePolicyRolloutInput,\n\ttype OraclePolicyRolloutMetrics,\n\ttype OraclePolicyRolloutStatus,\n\ttype OraclePolicyVerifiedAggregate,\n} from \"./oracle-policy-rollout.js\";\nexport {\n\tloadAgentProfiles,\n\tloadAgentProfilesFromDirectory,\n} from \"./profile-loader.js\";\nexport {\n\tContextHandoffManager,\n\tcreateContextHandoffManager,\n\testimateTokenCount,\n\tformatContextUsage,\n\tDEFAULT_THRESHOLDS,\n\ttype ContextThresholds,\n\ttype ContextStatus,\n\ttype ContextUsage,\n\ttype HandoffContext,\n} from \"./context-handoff.js\";\nexport {\n\tSUBAGENT_SPECS,\n\tTOOL_CATEGORIES,\n\tcreateCustomSpec,\n\tfilterToolsForSubagent,\n\tformatSubagentDisplay,\n\tgetAllSubagentTypes,\n\tgetAllowedTools,\n\tgetCurrentSubagentType,\n\tgetSubagentSpec,\n\tgetSubagentTypeFromEnv,\n\tisToolAllowed,\n\tparseSubagentType,\n\tsetCurrentSubagentType,\n\tvalidateSpec,\n\ttype SubagentSpec,\n\ttype SubagentType,\n} from \"./subagent-specs.js\";\nexport type {\n\tAgentEvent,\n\tAgentMessage,\n\tAgentRunConfig,\n\tAgentState,\n\tAgentTool,\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tAgentTransport,\n\tApi,\n\tAppMessage,\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tAttachment,\n\tBranchSummaryMessage,\n\tCompactionSummaryMessage,\n\tContext,\n\tCustomAgentMessages,\n\tCustomMessages,\n\tHookMessage,\n\tImageContent,\n\tMessage,\n\tModel,\n\tProvider,\n\tQueuedMessage,\n\tReasoningEffort,\n\tStopReason,\n\tStreamOptions,\n\tTextContent,\n\tThinkingContent,\n\tThinkingLevel,\n\tTool,\n\tToolCall,\n\tToolResultMessage,\n\tUsage,\n\tUserMessage,\n\tUserMessageWithAttachments,\n} from \"./types.js\";\nexport {\n\t// Message type guards\n\tisUserMessage,\n\tisAssistantMessage,\n\tisToolResultMessage,\n\tisHookMessage,\n\tisBranchSummaryMessage,\n\tisCompactionSummaryMessage,\n\tisUserMessageWithAttachments,\n\thasAttachments,\n\tisLLMMessage,\n\t// Content type guards\n\tisTextContent,\n\tisThinkingContent,\n\tisImageContent,\n\tisToolCall,\n\t// Utility functions\n\tgetToolCalls,\n\tgetTextContent,\n\tgetThinkingContent,\n\thasToolCalls,\n\tgetUserMessageText,\n\tgetFirstToolCall,\n\tisErrorResult,\n\tgetLastAssistantMessage,\n\tgetLastUserMessage,\n\tcountMessagesByRole,\n\tgetImageContent,\n} from \"./type-guards.js\";\nexport { convertToLlm, isLlmMessage } from \"./message-converter.js\";\n"]}

package/dist/agent/modes.d.ts

@@ -53,7 +53,7 @@ import { type SubagentType } from "./subagent-specs.js";
  * - "free": Cost-optimized, uses haiku-class models for simple operations
  * - "custom": User-defined settings for specialized workflows
  */
-export type AgentMode = "smart" | "rush" | "free" | "custom" | "frontier" | "replay";
+export type AgentMode = "low" | "medium" | "high" | "ultra" | "smart" | "rush" | "free" | "custom" | "frontier" | "replay";
 /**
  * Model tier representing capability levels that map to provider-specific models.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/agent/modes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/agent/modes.ts"],"names":[],"mappings":"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"}

package/dist/agent/modes.js

@@ -68,6 +68,62 @@ const PROVIDERS = [
  * - **custom**: Balanced defaults that users can override
  */
 export const MODE_CONFIGS = {
+    low: {
+        displayName: "Low",
+        description: "Bounded, obvious, and reversible work",
+        primaryTier: "haiku",
+        fallbackTier: "haiku",
+        enableThinking: false,
+        reasoningEffort: "low",
+        thinkingBudget: 2000,
+        useExtendedContext: false,
+        maxRetries: 1,
+        costMultiplier: 0.1,
+        speedHint: 10,
+        visible: true,
+    },
+    medium: {
+        displayName: "Medium",
+        description: "Ordinary repository work with moderate uncertainty",
+        primaryTier: "opus",
+        fallbackTier: "haiku",
+        enableThinking: true,
+        reasoningEffort: "medium",
+        thinkingBudget: 16000,
+        useExtendedContext: true,
+        maxRetries: 2,
+        costMultiplier: 1,
+        speedHint: 5,
+        visible: true,
+    },
+    high: {
+        displayName: "High",
+        description: "Ambiguous or cross-cutting work where misses are expensive",
+        primaryTier: "opus",
+        fallbackTier: "sonnet",
+        enableThinking: true,
+        reasoningEffort: "xhigh",
+        thinkingBudget: 20000,
+        useExtendedContext: true,
+        maxRetries: 2,
+        costMultiplier: 1.25,
+        speedHint: 4,
+        visible: true,
+    },
+    ultra: {
+        displayName: "Ultra",
+        description: "Migrations, architecture, and discovery-heavy work",
+        primaryTier: "opus",
+        fallbackTier: "opus",
+        enableThinking: true,
+        reasoningEffort: "xhigh",
+        thinkingBudget: 32000,
+        useExtendedContext: true,
+        maxRetries: 3,
+        costMultiplier: 1.5,
+        speedHint: 3,
+        visible: true,
+    },
     // Smart mode: Maximum capability for complex reasoning tasks
     smart: {
         displayName: "Smart",

package/dist/agent/modes.js.map

@@ -1 +1 @@
-{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../src/agent/modes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Agent Modes - Different operating modes for the agent.\n *\n * This module implements a tiered model selection system inspired by Amp's\n * smart/rush/free modes. Each mode represents a different balance between\n * response quality, speed, and cost:\n *\n * - **smart**: Uses the highest capability model (opus) for complex reasoning\n *   tasks. Enables thinking/reasoning mode with extended context windows.\n *   Best for: Architecture decisions, complex refactoring, debugging.\n *\n * - **rush**: Uses mid-tier models (sonnet) for faster responses. Disables\n *   thinking mode to reduce latency. Best for: Quick fixes, simple edits,\n *   straightforward code generation.\n *\n * - **free**: Uses the most cost-effective models (haiku) with minimal\n *   features. Best for: Simple questions, file searches, documentation\n *   lookups where speed and cost matter more than depth.\n *\n * - **custom**: User-defined configuration allowing fine-tuned control\n *   over model selection and feature toggles.\n *\n * ## Architecture\n *\n * The mode system uses a two-level abstraction:\n * 1. **ModelTier** (opus/sonnet/haiku): Logical capability levels\n * 2. **ModelMapping**: Provider-specific model IDs for each tier\n *\n * This allows the same mode configuration to work across different\n * LLM providers (Anthropic, OpenAI, Google) by mapping tiers to\n * provider-specific model identifiers.\n *\n * ## Usage\n *\n * ```typescript\n * // Set mode based on task\n * setCurrentMode(suggestMode(\"refactor the auth module\")); // → \"smart\"\n *\n * // Get model for current provider\n * const model = getModelForMode(getCurrentMode(), \"anthropic\");\n * ```\n *\n * ## Environment Variables\n *\n * - `MAESTRO_MODE`: Override the default mode at startup\n */\n\nimport { recordStagedRolloutSurfaceUsage } from \"../telemetry.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { type SubagentType, parseSubagentType } from \"./subagent-specs.js\";\n\n// Logger scoped to agent modes for debugging mode transitions\nconst logger = createLogger(\"agent:modes\");\n\n/**\n * Available agent modes representing different quality/speed/cost tradeoffs.\n *\n * - \"smart\": Maximum capability, uses opus-class models with reasoning enabled\n * - \"rush\": Balanced speed, uses sonnet-class models without reasoning overhead\n * - \"free\": Cost-optimized, uses haiku-class models for simple operations\n * - \"custom\": User-defined settings for specialized workflows\n */\nexport type AgentMode =\n\t| \"smart\"\n\t| \"rush\"\n\t| \"free\"\n\t| \"custom\"\n\t| \"frontier\"\n\t| \"replay\";\n\n/**\n * Model tier representing capability levels that map to provider-specific models.\n *\n * The tier abstraction allows the same configuration to work across providers:\n * - \"opus\": Highest capability (claude-opus, gpt-5.2, gemini-thinking)\n * - \"sonnet\": Balanced capability (claude-sonnet, gpt-4o, gemini-flash)\n * - \"haiku\": Fast/efficient (claude-haiku, gpt-4o-mini, gemini-flash-lite)\n */\nexport type ModelTier = \"opus\" | \"sonnet\" | \"haiku\";\n\n/** Supported model providers for tier and subagent dispatch. */\nexport type ModelProvider = \"anthropic\" | \"openai\" | \"openai-codex\" | \"google\";\n\n/** Reasoning budget hint passed to subagents that support it. */\nexport type ReasoningEffort = \"low\" | \"medium\" | \"high\" | \"xhigh\";\n\n/** Where the resolved subagent dispatch came from. */\nexport type DispatchSource = \"mode\" | \"fallback\";\n\n/**\n * Per-subagent model routing override.\n *\n * `model` can be a logical model tier (`opus`, `sonnet`, `haiku`) or an\n * explicit model ID. Explicit model IDs may be provider-prefixed, for example\n * `openai-codex/gpt-5.5`.\n */\nexport interface SubagentDispatch {\n\tmodel: ModelTier | string;\n\tprovider?: ModelProvider;\n\treasoningEffort?: ReasoningEffort;\n\tmaxTokens?: number;\n\ttemperature?: number;\n\ttimeoutMs?: number;\n\tpromptTemplate?: string;\n}\n\n/** Fully resolved model routing for one subagent invocation. */\nexport interface ResolvedSubagentDispatch {\n\tmode: AgentMode;\n\ttype: SubagentType;\n\tprovider: ModelProvider;\n\tmodel: string;\n\tmodelTier?: ModelTier;\n\treasoningEffort: ReasoningEffort;\n\tmaxTokens?: number;\n\ttemperature?: number;\n\ttimeoutMs?: number;\n\tpromptTemplate?: string;\n\tsource: DispatchSource;\n}\n\n/**\n * Mode configuration that determines model selection and behavior.\n *\n * Each mode has a complete configuration that controls:\n * - Which model tier to use (primary and fallback)\n * - Whether to enable extended reasoning/thinking\n * - Context and retry limits\n * - UI hints for cost/speed display\n */\nexport interface ModeConfig {\n\t/** Display name for the mode */\n\tdisplayName: string;\n\t/** Description of what this mode does */\n\tdescription: string;\n\t/** Primary model tier to use */\n\tprimaryTier: ModelTier;\n\t/** Fallback model tier if primary is unavailable */\n\tfallbackTier: ModelTier;\n\t/** Whether to enable thinking/reasoning */\n\tenableThinking: boolean;\n\t/** Default reasoning effort for mode-level and fallback subagent routing. */\n\treasoningEffort?: ReasoningEffort;\n\t/** Maximum thinking budget (tokens) */\n\tthinkingBudget: number;\n\t/** Whether to use extended context */\n\tuseExtendedContext: boolean;\n\t/** Retry configuration */\n\tmaxRetries: number;\n\t/** Cost multiplier hint (for UI display) */\n\tcostMultiplier: number;\n\t/** Speed hint (1-10, higher is faster) */\n\tspeedHint: number;\n\t/** Whether this mode is shown in default user-facing mode lists. */\n\tvisible: boolean;\n\t/** Optional dispatch table for mode-specific subagent routing. */\n\tsubagents?: Partial<Record<SubagentType, SubagentDispatch>>;\n\t/** Owner responsible for promotion or removal when hidden. */\n\trolloutOwner?: string;\n}\n\n/**\n * Model mapping for different providers.\n */\nexport interface ModelMapping {\n\tanthropic: string;\n\topenai?: string;\n\t\"openai-codex\"?: string;\n\tgoogle?: string;\n}\n\nconst PROVIDERS: ModelProvider[] = [\n\t\"anthropic\",\n\t\"openai\",\n\t\"openai-codex\",\n\t\"google\",\n];\n\n/**\n * Default mode configurations defining the behavior of each agent mode.\n *\n * These configurations are the canonical source of truth for how each mode\n * behaves. The settings are carefully tuned based on model capabilities\n * and typical use case requirements:\n *\n * - **smart**: Full-featured for complex tasks (16k thinking budget, 3 retries)\n * - **rush**: Optimized for speed (no thinking, 2 retries, smaller context)\n * - **free**: Minimal resource usage (no thinking, 1 retry, no extended context)\n * - **custom**: Balanced defaults that users can override\n */\nexport const MODE_CONFIGS: Record<AgentMode, ModeConfig> = {\n\t// Smart mode: Maximum capability for complex reasoning tasks\n\tsmart: {\n\t\tdisplayName: \"Smart\",\n\t\tdescription: \"Best quality, uses opus for complex tasks\",\n\t\tprimaryTier: \"opus\",\n\t\tfallbackTier: \"sonnet\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"medium\",\n\t\tthinkingBudget: 16000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 3,\n\t\tcostMultiplier: 1.0,\n\t\tspeedHint: 5,\n\t\tvisible: true,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"opus\", reasoningEffort: \"high\" },\n\t\t\tcoder: { model: \"openai-codex/gpt-5.5\", reasoningEffort: \"medium\" },\n\t\t\treviewer: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tresearcher: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\t\"browser-qa\": { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t},\n\t// Rush mode: Speed-optimized for quick iterations\n\trush: {\n\t\tdisplayName: \"Rush\",\n\t\tdescription: \"Fast responses, uses sonnet for speed\",\n\t\tprimaryTier: \"sonnet\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: false,\n\t\treasoningEffort: \"low\",\n\t\tthinkingBudget: 4000,\n\t\tuseExtendedContext: false,\n\t\tmaxRetries: 2,\n\t\tcostMultiplier: 0.5,\n\t\tspeedHint: 8,\n\t\tvisible: true,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"sonnet\", reasoningEffort: \"low\" },\n\t\t\tcoder: { model: \"sonnet\", reasoningEffort: \"low\" },\n\t\t\treviewer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tresearcher: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\t\"browser-qa\": { model: \"sonnet\", reasoningEffort: \"low\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t},\n\t// Free mode: Cost-optimized for simple tasks\n\tfree: {\n\t\tdisplayName: \"Free\",\n\t\tdescription: \"Most cost-effective, uses haiku\",\n\t\tprimaryTier: \"haiku\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: false,\n\t\treasoningEffort: \"low\",\n\t\tthinkingBudget: 2000,\n\t\tuseExtendedContext: false,\n\t\tmaxRetries: 1,\n\t\tcostMultiplier: 0.1,\n\t\tspeedHint: 10,\n\t\tvisible: true,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tcoder: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\treviewer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tresearcher: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\t\"browser-qa\": { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t},\n\t// Custom mode: User-configurable defaults (can be overridden at runtime)\n\tcustom: {\n\t\tdisplayName: \"Custom\",\n\t\tdescription: \"User-defined configuration\",\n\t\tprimaryTier: \"sonnet\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"medium\",\n\t\tthinkingBudget: 8000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 2,\n\t\tcostMultiplier: 0.7,\n\t\tspeedHint: 6,\n\t\tvisible: true,\n\t},\n\tfrontier: {\n\t\tdisplayName: \"Frontier\",\n\t\tdescription: \"Experimental high-capability orchestration mode\",\n\t\tprimaryTier: \"opus\",\n\t\tfallbackTier: \"sonnet\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"high\",\n\t\tthinkingBudget: 20000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 3,\n\t\tcostMultiplier: 1.25,\n\t\tspeedHint: 4,\n\t\tvisible: false,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tplanner: { model: \"opus\", reasoningEffort: \"xhigh\" },\n\t\t\tcoder: { model: \"openai-codex/gpt-5.5\", reasoningEffort: \"high\" },\n\t\t\treviewer: { model: \"openai-codex/gpt-5.5\", reasoningEffort: \"medium\" },\n\t\t\tresearcher: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\t\"browser-qa\": { model: \"sonnet\", reasoningEffort: \"high\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t\trolloutOwner: \"agent-runtime\",\n\t},\n\treplay: {\n\t\tdisplayName: \"Replay\",\n\t\tdescription: \"Deterministic scripted scenario replay\",\n\t\tprimaryTier: \"haiku\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: false,\n\t\treasoningEffort: \"low\",\n\t\tthinkingBudget: 0,\n\t\tuseExtendedContext: false,\n\t\tmaxRetries: 0,\n\t\tcostMultiplier: 0,\n\t\tspeedHint: 10,\n\t\tvisible: false,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tcoder: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\treviewer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tresearcher: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\t\"browser-qa\": { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t\trolloutOwner: \"agent-evals\",\n\t},\n};\n\n/**\n * Model mappings by tier for each provider.\n *\n * This lookup table maps abstract capability tiers to concrete model IDs\n * for each supported LLM provider. When adding new providers or updating\n * model versions, update this table to maintain consistent tier behavior.\n *\n * Note: Model IDs include version dates to ensure reproducibility.\n * Update these periodically as providers release improved versions.\n */\nexport const MODEL_BY_TIER: Record<ModelTier, ModelMapping> = {\n\t// Opus tier: Highest capability models with advanced reasoning\n\topus: {\n\t\tanthropic: \"claude-opus-4-6\",\n\t\topenai: \"gpt-5.2\",\n\t\t\"openai-codex\": \"gpt-5.5\",\n\t\tgoogle: \"gemini-2.0-flash-thinking-exp\",\n\t},\n\t// Sonnet tier: Balanced performance models for general use\n\tsonnet: {\n\t\tanthropic: \"claude-sonnet-4-5-20250929\",\n\t\topenai: \"gpt-4o\",\n\t\t\"openai-codex\": \"gpt-5.4\",\n\t\tgoogle: \"gemini-2.0-flash-exp\",\n\t},\n\t// Haiku tier: Fast, efficient models for simple tasks\n\thaiku: {\n\t\tanthropic: \"claude-haiku-4-5-20251001\",\n\t\topenai: \"gpt-4o-mini\",\n\t\t\"openai-codex\": \"gpt-5.4-mini\",\n\t\tgoogle: \"gemini-2.0-flash-lite-exp\",\n\t},\n};\n\n/**\n * Get the model ID for a given tier and provider.\n *\n * @param tier - The capability tier (opus/sonnet/haiku)\n * @param provider - The LLM provider (defaults to openai-codex)\n * @returns The concrete model ID string for the provider\n *\n * Falls back to the OpenAI Codex model if the requested provider\n * doesn't have a mapping for the tier.\n */\nexport function getModelForTier(\n\ttier: ModelTier,\n\tprovider: ModelProvider = \"openai-codex\",\n): string {\n\tconst mapping = MODEL_BY_TIER[tier];\n\treturn mapping[provider] ?? mapping[\"openai-codex\"] ?? \"gpt-5.5\";\n}\n\nfunction isModelTier(model: string): model is ModelTier {\n\treturn model in MODEL_BY_TIER;\n}\n\nfunction isModelProvider(provider: string): provider is ModelProvider {\n\treturn PROVIDERS.includes(provider as ModelProvider);\n}\n\nfunction splitExplicitModel(model: string): {\n\tprovider?: ModelProvider;\n\tmodel: string;\n} {\n\tconst slashIndex = model.indexOf(\"/\");\n\tif (slashIndex <= 0) {\n\t\treturn { model };\n\t}\n\n\tconst provider = model.slice(0, slashIndex);\n\tif (!isModelProvider(provider)) {\n\t\treturn { model };\n\t}\n\n\treturn {\n\t\tprovider,\n\t\tmodel: model.slice(slashIndex + 1),\n\t};\n}\n\nfunction defaultReasoningEffort(config: ModeConfig): ReasoningEffort {\n\treturn config.reasoningEffort ?? (config.enableThinking ? \"medium\" : \"low\");\n}\n\n/**\n * Resolve the concrete model/provider a subagent should use in a mode.\n */\nexport function resolveSubagentDispatch(\n\tmode: AgentMode,\n\ttype: SubagentType | string,\n\tprovider: ModelProvider = \"openai-codex\",\n): ResolvedSubagentDispatch {\n\tconst config = getModeConfig(mode);\n\tconst resolvedType = parseSubagentType(type) ?? \"coder\";\n\tconst dispatch = config.subagents?.[resolvedType];\n\tconst source: DispatchSource = dispatch ? \"mode\" : \"fallback\";\n\tconst requestedModel = dispatch?.model ?? config.primaryTier;\n\tconst reasoningEffort =\n\t\tdispatch?.reasoningEffort ?? defaultReasoningEffort(config);\n\n\tif (isModelTier(requestedModel)) {\n\t\tconst resolvedProvider = dispatch?.provider ?? provider;\n\t\treturn {\n\t\t\tmode,\n\t\t\ttype: resolvedType,\n\t\t\tprovider: resolvedProvider,\n\t\t\tmodel: getModelForTier(requestedModel, resolvedProvider),\n\t\t\tmodelTier: requestedModel,\n\t\t\treasoningEffort,\n\t\t\tmaxTokens: dispatch?.maxTokens,\n\t\t\ttemperature: dispatch?.temperature,\n\t\t\ttimeoutMs: dispatch?.timeoutMs,\n\t\t\tpromptTemplate: dispatch?.promptTemplate,\n\t\t\tsource,\n\t\t};\n\t}\n\n\tconst explicit = splitExplicitModel(requestedModel);\n\tconst resolvedProvider = dispatch?.provider ?? explicit.provider ?? provider;\n\treturn {\n\t\tmode,\n\t\ttype: resolvedType,\n\t\tprovider: resolvedProvider,\n\t\tmodel: explicit.model,\n\t\treasoningEffort,\n\t\tmaxTokens: dispatch?.maxTokens,\n\t\ttemperature: dispatch?.temperature,\n\t\ttimeoutMs: dispatch?.timeoutMs,\n\t\tpromptTemplate: dispatch?.promptTemplate,\n\t\tsource,\n\t};\n}\n\n/**\n * Get the configuration for a mode.\n */\nexport function getModeConfig(mode: AgentMode): ModeConfig {\n\treturn MODE_CONFIGS[mode];\n}\n\n/**\n * Get the recommended model for a mode and provider.\n */\nexport function getModelForMode(\n\tmode: AgentMode,\n\tprovider: ModelProvider = \"openai-codex\",\n): string {\n\tconst config = getModeConfig(mode);\n\treturn getModelForTier(config.primaryTier, provider);\n}\n\n/**\n * Current agent mode state (module-level singleton).\n *\n * This tracks the active mode for the current process. In multi-session\n * scenarios, each session should manage its own mode state rather than\n * relying on this global.\n */\nlet currentMode: AgentMode = \"smart\";\n\n/**\n * Get the current agent mode.\n *\n * @returns The currently active agent mode\n */\nexport function getCurrentMode(): AgentMode {\n\treturn currentMode;\n}\n\n/**\n * Set the current agent mode.\n *\n * This updates the global mode state and logs the transition for debugging.\n * Mode changes take effect immediately for subsequent operations.\n *\n * @param mode - The new mode to activate\n */\nexport function setCurrentMode(mode: AgentMode): void {\n\tlogger.info(\"Setting agent mode\", { mode });\n\tcurrentMode = mode;\n\tconst config = getModeConfig(mode);\n\tif (config.visible === false) {\n\t\tvoid recordStagedRolloutSurfaceUsage(\"hidden_mode_used\", {\n\t\t\tsurfaceId: `mode:${mode}`,\n\t\t\tsurfaceType: \"mode\",\n\t\t\towner: config.rolloutOwner,\n\t\t});\n\t}\n}\n\n/**\n * Parse mode from string (case-insensitive).\n *\n * Validates user input and converts to a valid AgentMode type.\n *\n * @param modeStr - User-provided mode string (e.g., \"Smart\", \"RUSH\")\n * @returns The parsed AgentMode, or null if invalid\n */\nexport function parseMode(modeStr: string): AgentMode | null {\n\tconst normalized = modeStr.toLowerCase().trim();\n\tif (normalized in MODE_CONFIGS) {\n\t\treturn normalized as AgentMode;\n\t}\n\treturn null;\n}\n\n/**\n * Get mode from environment variable.\n *\n * Reads MAESTRO_MODE from environment and validates it.\n * Defaults to \"smart\" if not set or invalid.\n *\n * @returns The configured mode or \"smart\" as default\n */\nexport function getModeFromEnv(): AgentMode {\n\tconst envMode = process.env.MAESTRO_MODE?.toLowerCase();\n\tif (envMode && envMode in MODE_CONFIGS) {\n\t\treturn envMode as AgentMode;\n\t}\n\t// Default to smart mode for best quality when not specified\n\treturn \"smart\";\n}\n\n/**\n * Format mode for display.\n */\nexport function formatModeDisplay(mode: AgentMode): string {\n\tconst config = getModeConfig(mode);\n\treturn `${config.displayName} - ${config.description}`;\n}\n\n/**\n * Get all available modes with their descriptions.\n */\nexport function getAllModes(options?: {\n\tincludeHidden?: boolean;\n}): Array<{ mode: AgentMode; config: ModeConfig }> {\n\treturn (Object.entries(MODE_CONFIGS) as [AgentMode, ModeConfig][])\n\t\t.filter(([, config]) => options?.includeHidden === true || config.visible)\n\t\t.map(([mode, config]) => ({\n\t\t\tmode,\n\t\t\tconfig,\n\t\t}));\n}\n\n/**\n * Suggest a mode based on task complexity heuristics.\n *\n * This function analyzes the task description to recommend an appropriate\n * mode based on keyword matching. It uses a scoring system to determine\n * task complexity:\n *\n * **Scoring Algorithm:**\n * 1. Count matches against complex/simple/info indicator word lists\n * 2. Compare scores to determine dominant category\n * 3. Return mode matching the highest score\n *\n * **Keyword Categories:**\n * - Complex (→ smart): refactor, architect, design, implement, build...\n * - Simple (→ rush): fix, typo, rename, update, small changes...\n * - Info (→ free): what, where, explain, find, search queries...\n *\n * @param taskDescription - The user's task description to analyze\n * @returns The recommended AgentMode based on task complexity\n *\n * @example\n * suggestMode(\"refactor the authentication module\") // → \"smart\"\n * suggestMode(\"fix typo in README\") // → \"rush\"\n * suggestMode(\"what does this function do?\") // → \"free\"\n */\nexport function suggestMode(taskDescription: string): AgentMode {\n\tconst lowerTask = taskDescription.toLowerCase();\n\n\t// Complex tasks → smart mode (require deep reasoning)\n\tconst complexIndicators = [\n\t\t\"refactor\",\n\t\t\"architect\",\n\t\t\"design\",\n\t\t\"implement\",\n\t\t\"create\",\n\t\t\"build\",\n\t\t\"complex\",\n\t\t\"system\",\n\t\t\"full\",\n\t\t\"entire\",\n\t\t\"comprehensive\",\n\t];\n\n\t// Simple tasks → rush mode (straightforward modifications)\n\tconst simpleIndicators = [\n\t\t\"fix\",\n\t\t\"typo\",\n\t\t\"simple\",\n\t\t\"quick\",\n\t\t\"small\",\n\t\t\"minor\",\n\t\t\"rename\",\n\t\t\"update\",\n\t\t\"change\",\n\t];\n\n\t// Information tasks → free mode (queries, not modifications)\n\tconst infoIndicators = [\n\t\t\"what\",\n\t\t\"where\",\n\t\t\"explain\",\n\t\t\"describe\",\n\t\t\"list\",\n\t\t\"show\",\n\t\t\"find\",\n\t\t\"search\",\n\t];\n\n\t// Calculate match scores for each category\n\tconst complexScore = complexIndicators.filter((i) =>\n\t\tlowerTask.includes(i),\n\t).length;\n\tconst simpleScore = simpleIndicators.filter((i) =>\n\t\tlowerTask.includes(i),\n\t).length;\n\tconst infoScore = infoIndicators.filter((i) => lowerTask.includes(i)).length;\n\n\t// Determine mode based on highest scoring category\n\tif (complexScore > simpleScore && complexScore > infoScore) {\n\t\treturn \"smart\";\n\t}\n\tif (infoScore > simpleScore) {\n\t\treturn \"free\";\n\t}\n\tif (simpleScore > 0) {\n\t\treturn \"rush\";\n\t}\n\n\t// Default to smart mode when no clear indicators found\n\t// (better to over-estimate complexity than under-estimate)\n\treturn \"smart\";\n}\n"]}
+{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../src/agent/modes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Agent Modes - Different operating modes for the agent.\n *\n * This module implements a tiered model selection system inspired by Amp's\n * smart/rush/free modes. Each mode represents a different balance between\n * response quality, speed, and cost:\n *\n * - **smart**: Uses the highest capability model (opus) for complex reasoning\n *   tasks. Enables thinking/reasoning mode with extended context windows.\n *   Best for: Architecture decisions, complex refactoring, debugging.\n *\n * - **rush**: Uses mid-tier models (sonnet) for faster responses. Disables\n *   thinking mode to reduce latency. Best for: Quick fixes, simple edits,\n *   straightforward code generation.\n *\n * - **free**: Uses the most cost-effective models (haiku) with minimal\n *   features. Best for: Simple questions, file searches, documentation\n *   lookups where speed and cost matter more than depth.\n *\n * - **custom**: User-defined configuration allowing fine-tuned control\n *   over model selection and feature toggles.\n *\n * ## Architecture\n *\n * The mode system uses a two-level abstraction:\n * 1. **ModelTier** (opus/sonnet/haiku): Logical capability levels\n * 2. **ModelMapping**: Provider-specific model IDs for each tier\n *\n * This allows the same mode configuration to work across different\n * LLM providers (Anthropic, OpenAI, Google) by mapping tiers to\n * provider-specific model identifiers.\n *\n * ## Usage\n *\n * ```typescript\n * // Set mode based on task\n * setCurrentMode(suggestMode(\"refactor the auth module\")); // → \"smart\"\n *\n * // Get model for current provider\n * const model = getModelForMode(getCurrentMode(), \"anthropic\");\n * ```\n *\n * ## Environment Variables\n *\n * - `MAESTRO_MODE`: Override the default mode at startup\n */\n\nimport { recordStagedRolloutSurfaceUsage } from \"../telemetry.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { type SubagentType, parseSubagentType } from \"./subagent-specs.js\";\n\n// Logger scoped to agent modes for debugging mode transitions\nconst logger = createLogger(\"agent:modes\");\n\n/**\n * Available agent modes representing different quality/speed/cost tradeoffs.\n *\n * - \"smart\": Maximum capability, uses opus-class models with reasoning enabled\n * - \"rush\": Balanced speed, uses sonnet-class models without reasoning overhead\n * - \"free\": Cost-optimized, uses haiku-class models for simple operations\n * - \"custom\": User-defined settings for specialized workflows\n */\nexport type AgentMode =\n\t| \"low\"\n\t| \"medium\"\n\t| \"high\"\n\t| \"ultra\"\n\t| \"smart\"\n\t| \"rush\"\n\t| \"free\"\n\t| \"custom\"\n\t| \"frontier\"\n\t| \"replay\";\n\n/**\n * Model tier representing capability levels that map to provider-specific models.\n *\n * The tier abstraction allows the same configuration to work across providers:\n * - \"opus\": Highest capability (claude-opus, gpt-5.2, gemini-thinking)\n * - \"sonnet\": Balanced capability (claude-sonnet, gpt-4o, gemini-flash)\n * - \"haiku\": Fast/efficient (claude-haiku, gpt-4o-mini, gemini-flash-lite)\n */\nexport type ModelTier = \"opus\" | \"sonnet\" | \"haiku\";\n\n/** Supported model providers for tier and subagent dispatch. */\nexport type ModelProvider = \"anthropic\" | \"openai\" | \"openai-codex\" | \"google\";\n\n/** Reasoning budget hint passed to subagents that support it. */\nexport type ReasoningEffort = \"low\" | \"medium\" | \"high\" | \"xhigh\";\n\n/** Where the resolved subagent dispatch came from. */\nexport type DispatchSource = \"mode\" | \"fallback\";\n\n/**\n * Per-subagent model routing override.\n *\n * `model` can be a logical model tier (`opus`, `sonnet`, `haiku`) or an\n * explicit model ID. Explicit model IDs may be provider-prefixed, for example\n * `openai-codex/gpt-5.5`.\n */\nexport interface SubagentDispatch {\n\tmodel: ModelTier | string;\n\tprovider?: ModelProvider;\n\treasoningEffort?: ReasoningEffort;\n\tmaxTokens?: number;\n\ttemperature?: number;\n\ttimeoutMs?: number;\n\tpromptTemplate?: string;\n}\n\n/** Fully resolved model routing for one subagent invocation. */\nexport interface ResolvedSubagentDispatch {\n\tmode: AgentMode;\n\ttype: SubagentType;\n\tprovider: ModelProvider;\n\tmodel: string;\n\tmodelTier?: ModelTier;\n\treasoningEffort: ReasoningEffort;\n\tmaxTokens?: number;\n\ttemperature?: number;\n\ttimeoutMs?: number;\n\tpromptTemplate?: string;\n\tsource: DispatchSource;\n}\n\n/**\n * Mode configuration that determines model selection and behavior.\n *\n * Each mode has a complete configuration that controls:\n * - Which model tier to use (primary and fallback)\n * - Whether to enable extended reasoning/thinking\n * - Context and retry limits\n * - UI hints for cost/speed display\n */\nexport interface ModeConfig {\n\t/** Display name for the mode */\n\tdisplayName: string;\n\t/** Description of what this mode does */\n\tdescription: string;\n\t/** Primary model tier to use */\n\tprimaryTier: ModelTier;\n\t/** Fallback model tier if primary is unavailable */\n\tfallbackTier: ModelTier;\n\t/** Whether to enable thinking/reasoning */\n\tenableThinking: boolean;\n\t/** Default reasoning effort for mode-level and fallback subagent routing. */\n\treasoningEffort?: ReasoningEffort;\n\t/** Maximum thinking budget (tokens) */\n\tthinkingBudget: number;\n\t/** Whether to use extended context */\n\tuseExtendedContext: boolean;\n\t/** Retry configuration */\n\tmaxRetries: number;\n\t/** Cost multiplier hint (for UI display) */\n\tcostMultiplier: number;\n\t/** Speed hint (1-10, higher is faster) */\n\tspeedHint: number;\n\t/** Whether this mode is shown in default user-facing mode lists. */\n\tvisible: boolean;\n\t/** Optional dispatch table for mode-specific subagent routing. */\n\tsubagents?: Partial<Record<SubagentType, SubagentDispatch>>;\n\t/** Owner responsible for promotion or removal when hidden. */\n\trolloutOwner?: string;\n}\n\n/**\n * Model mapping for different providers.\n */\nexport interface ModelMapping {\n\tanthropic: string;\n\topenai?: string;\n\t\"openai-codex\"?: string;\n\tgoogle?: string;\n}\n\nconst PROVIDERS: ModelProvider[] = [\n\t\"anthropic\",\n\t\"openai\",\n\t\"openai-codex\",\n\t\"google\",\n];\n\n/**\n * Default mode configurations defining the behavior of each agent mode.\n *\n * These configurations are the canonical source of truth for how each mode\n * behaves. The settings are carefully tuned based on model capabilities\n * and typical use case requirements:\n *\n * - **smart**: Full-featured for complex tasks (16k thinking budget, 3 retries)\n * - **rush**: Optimized for speed (no thinking, 2 retries, smaller context)\n * - **free**: Minimal resource usage (no thinking, 1 retry, no extended context)\n * - **custom**: Balanced defaults that users can override\n */\nexport const MODE_CONFIGS: Record<AgentMode, ModeConfig> = {\n\tlow: {\n\t\tdisplayName: \"Low\",\n\t\tdescription: \"Bounded, obvious, and reversible work\",\n\t\tprimaryTier: \"haiku\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: false,\n\t\treasoningEffort: \"low\",\n\t\tthinkingBudget: 2000,\n\t\tuseExtendedContext: false,\n\t\tmaxRetries: 1,\n\t\tcostMultiplier: 0.1,\n\t\tspeedHint: 10,\n\t\tvisible: true,\n\t},\n\tmedium: {\n\t\tdisplayName: \"Medium\",\n\t\tdescription: \"Ordinary repository work with moderate uncertainty\",\n\t\tprimaryTier: \"opus\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"medium\",\n\t\tthinkingBudget: 16000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 2,\n\t\tcostMultiplier: 1,\n\t\tspeedHint: 5,\n\t\tvisible: true,\n\t},\n\thigh: {\n\t\tdisplayName: \"High\",\n\t\tdescription: \"Ambiguous or cross-cutting work where misses are expensive\",\n\t\tprimaryTier: \"opus\",\n\t\tfallbackTier: \"sonnet\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"xhigh\",\n\t\tthinkingBudget: 20000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 2,\n\t\tcostMultiplier: 1.25,\n\t\tspeedHint: 4,\n\t\tvisible: true,\n\t},\n\tultra: {\n\t\tdisplayName: \"Ultra\",\n\t\tdescription: \"Migrations, architecture, and discovery-heavy work\",\n\t\tprimaryTier: \"opus\",\n\t\tfallbackTier: \"opus\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"xhigh\",\n\t\tthinkingBudget: 32000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 3,\n\t\tcostMultiplier: 1.5,\n\t\tspeedHint: 3,\n\t\tvisible: true,\n\t},\n\t// Smart mode: Maximum capability for complex reasoning tasks\n\tsmart: {\n\t\tdisplayName: \"Smart\",\n\t\tdescription: \"Best quality, uses opus for complex tasks\",\n\t\tprimaryTier: \"opus\",\n\t\tfallbackTier: \"sonnet\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"medium\",\n\t\tthinkingBudget: 16000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 3,\n\t\tcostMultiplier: 1.0,\n\t\tspeedHint: 5,\n\t\tvisible: true,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"opus\", reasoningEffort: \"high\" },\n\t\t\tcoder: { model: \"openai-codex/gpt-5.5\", reasoningEffort: \"medium\" },\n\t\t\treviewer: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tresearcher: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\t\"browser-qa\": { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t},\n\t// Rush mode: Speed-optimized for quick iterations\n\trush: {\n\t\tdisplayName: \"Rush\",\n\t\tdescription: \"Fast responses, uses sonnet for speed\",\n\t\tprimaryTier: \"sonnet\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: false,\n\t\treasoningEffort: \"low\",\n\t\tthinkingBudget: 4000,\n\t\tuseExtendedContext: false,\n\t\tmaxRetries: 2,\n\t\tcostMultiplier: 0.5,\n\t\tspeedHint: 8,\n\t\tvisible: true,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"sonnet\", reasoningEffort: \"low\" },\n\t\t\tcoder: { model: \"sonnet\", reasoningEffort: \"low\" },\n\t\t\treviewer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tresearcher: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\t\"browser-qa\": { model: \"sonnet\", reasoningEffort: \"low\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t},\n\t// Free mode: Cost-optimized for simple tasks\n\tfree: {\n\t\tdisplayName: \"Free\",\n\t\tdescription: \"Most cost-effective, uses haiku\",\n\t\tprimaryTier: \"haiku\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: false,\n\t\treasoningEffort: \"low\",\n\t\tthinkingBudget: 2000,\n\t\tuseExtendedContext: false,\n\t\tmaxRetries: 1,\n\t\tcostMultiplier: 0.1,\n\t\tspeedHint: 10,\n\t\tvisible: true,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tcoder: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\treviewer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tresearcher: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\t\"browser-qa\": { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t},\n\t// Custom mode: User-configurable defaults (can be overridden at runtime)\n\tcustom: {\n\t\tdisplayName: \"Custom\",\n\t\tdescription: \"User-defined configuration\",\n\t\tprimaryTier: \"sonnet\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"medium\",\n\t\tthinkingBudget: 8000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 2,\n\t\tcostMultiplier: 0.7,\n\t\tspeedHint: 6,\n\t\tvisible: true,\n\t},\n\tfrontier: {\n\t\tdisplayName: \"Frontier\",\n\t\tdescription: \"Experimental high-capability orchestration mode\",\n\t\tprimaryTier: \"opus\",\n\t\tfallbackTier: \"sonnet\",\n\t\tenableThinking: true,\n\t\treasoningEffort: \"high\",\n\t\tthinkingBudget: 20000,\n\t\tuseExtendedContext: true,\n\t\tmaxRetries: 3,\n\t\tcostMultiplier: 1.25,\n\t\tspeedHint: 4,\n\t\tvisible: false,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\tplanner: { model: \"opus\", reasoningEffort: \"xhigh\" },\n\t\t\tcoder: { model: \"openai-codex/gpt-5.5\", reasoningEffort: \"high\" },\n\t\t\treviewer: { model: \"openai-codex/gpt-5.5\", reasoningEffort: \"medium\" },\n\t\t\tresearcher: { model: \"sonnet\", reasoningEffort: \"medium\" },\n\t\t\t\"browser-qa\": { model: \"sonnet\", reasoningEffort: \"high\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t\trolloutOwner: \"agent-runtime\",\n\t},\n\treplay: {\n\t\tdisplayName: \"Replay\",\n\t\tdescription: \"Deterministic scripted scenario replay\",\n\t\tprimaryTier: \"haiku\",\n\t\tfallbackTier: \"haiku\",\n\t\tenableThinking: false,\n\t\treasoningEffort: \"low\",\n\t\tthinkingBudget: 0,\n\t\tuseExtendedContext: false,\n\t\tmaxRetries: 0,\n\t\tcostMultiplier: 0,\n\t\tspeedHint: 10,\n\t\tvisible: false,\n\t\tsubagents: {\n\t\t\texplorer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tplanner: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tcoder: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\treviewer: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tresearcher: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\t\"browser-qa\": { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t\tminimal: { model: \"haiku\", reasoningEffort: \"low\" },\n\t\t},\n\t\trolloutOwner: \"agent-evals\",\n\t},\n};\n\n/**\n * Model mappings by tier for each provider.\n *\n * This lookup table maps abstract capability tiers to concrete model IDs\n * for each supported LLM provider. When adding new providers or updating\n * model versions, update this table to maintain consistent tier behavior.\n *\n * Note: Model IDs include version dates to ensure reproducibility.\n * Update these periodically as providers release improved versions.\n */\nexport const MODEL_BY_TIER: Record<ModelTier, ModelMapping> = {\n\t// Opus tier: Highest capability models with advanced reasoning\n\topus: {\n\t\tanthropic: \"claude-opus-4-6\",\n\t\topenai: \"gpt-5.2\",\n\t\t\"openai-codex\": \"gpt-5.5\",\n\t\tgoogle: \"gemini-2.0-flash-thinking-exp\",\n\t},\n\t// Sonnet tier: Balanced performance models for general use\n\tsonnet: {\n\t\tanthropic: \"claude-sonnet-4-5-20250929\",\n\t\topenai: \"gpt-4o\",\n\t\t\"openai-codex\": \"gpt-5.4\",\n\t\tgoogle: \"gemini-2.0-flash-exp\",\n\t},\n\t// Haiku tier: Fast, efficient models for simple tasks\n\thaiku: {\n\t\tanthropic: \"claude-haiku-4-5-20251001\",\n\t\topenai: \"gpt-4o-mini\",\n\t\t\"openai-codex\": \"gpt-5.4-mini\",\n\t\tgoogle: \"gemini-2.0-flash-lite-exp\",\n\t},\n};\n\n/**\n * Get the model ID for a given tier and provider.\n *\n * @param tier - The capability tier (opus/sonnet/haiku)\n * @param provider - The LLM provider (defaults to openai-codex)\n * @returns The concrete model ID string for the provider\n *\n * Falls back to the OpenAI Codex model if the requested provider\n * doesn't have a mapping for the tier.\n */\nexport function getModelForTier(\n\ttier: ModelTier,\n\tprovider: ModelProvider = \"openai-codex\",\n): string {\n\tconst mapping = MODEL_BY_TIER[tier];\n\treturn mapping[provider] ?? mapping[\"openai-codex\"] ?? \"gpt-5.5\";\n}\n\nfunction isModelTier(model: string): model is ModelTier {\n\treturn model in MODEL_BY_TIER;\n}\n\nfunction isModelProvider(provider: string): provider is ModelProvider {\n\treturn PROVIDERS.includes(provider as ModelProvider);\n}\n\nfunction splitExplicitModel(model: string): {\n\tprovider?: ModelProvider;\n\tmodel: string;\n} {\n\tconst slashIndex = model.indexOf(\"/\");\n\tif (slashIndex <= 0) {\n\t\treturn { model };\n\t}\n\n\tconst provider = model.slice(0, slashIndex);\n\tif (!isModelProvider(provider)) {\n\t\treturn { model };\n\t}\n\n\treturn {\n\t\tprovider,\n\t\tmodel: model.slice(slashIndex + 1),\n\t};\n}\n\nfunction defaultReasoningEffort(config: ModeConfig): ReasoningEffort {\n\treturn config.reasoningEffort ?? (config.enableThinking ? \"medium\" : \"low\");\n}\n\n/**\n * Resolve the concrete model/provider a subagent should use in a mode.\n */\nexport function resolveSubagentDispatch(\n\tmode: AgentMode,\n\ttype: SubagentType | string,\n\tprovider: ModelProvider = \"openai-codex\",\n): ResolvedSubagentDispatch {\n\tconst config = getModeConfig(mode);\n\tconst resolvedType = parseSubagentType(type) ?? \"coder\";\n\tconst dispatch = config.subagents?.[resolvedType];\n\tconst source: DispatchSource = dispatch ? \"mode\" : \"fallback\";\n\tconst requestedModel = dispatch?.model ?? config.primaryTier;\n\tconst reasoningEffort =\n\t\tdispatch?.reasoningEffort ?? defaultReasoningEffort(config);\n\n\tif (isModelTier(requestedModel)) {\n\t\tconst resolvedProvider = dispatch?.provider ?? provider;\n\t\treturn {\n\t\t\tmode,\n\t\t\ttype: resolvedType,\n\t\t\tprovider: resolvedProvider,\n\t\t\tmodel: getModelForTier(requestedModel, resolvedProvider),\n\t\t\tmodelTier: requestedModel,\n\t\t\treasoningEffort,\n\t\t\tmaxTokens: dispatch?.maxTokens,\n\t\t\ttemperature: dispatch?.temperature,\n\t\t\ttimeoutMs: dispatch?.timeoutMs,\n\t\t\tpromptTemplate: dispatch?.promptTemplate,\n\t\t\tsource,\n\t\t};\n\t}\n\n\tconst explicit = splitExplicitModel(requestedModel);\n\tconst resolvedProvider = dispatch?.provider ?? explicit.provider ?? provider;\n\treturn {\n\t\tmode,\n\t\ttype: resolvedType,\n\t\tprovider: resolvedProvider,\n\t\tmodel: explicit.model,\n\t\treasoningEffort,\n\t\tmaxTokens: dispatch?.maxTokens,\n\t\ttemperature: dispatch?.temperature,\n\t\ttimeoutMs: dispatch?.timeoutMs,\n\t\tpromptTemplate: dispatch?.promptTemplate,\n\t\tsource,\n\t};\n}\n\n/**\n * Get the configuration for a mode.\n */\nexport function getModeConfig(mode: AgentMode): ModeConfig {\n\treturn MODE_CONFIGS[mode];\n}\n\n/**\n * Get the recommended model for a mode and provider.\n */\nexport function getModelForMode(\n\tmode: AgentMode,\n\tprovider: ModelProvider = \"openai-codex\",\n): string {\n\tconst config = getModeConfig(mode);\n\treturn getModelForTier(config.primaryTier, provider);\n}\n\n/**\n * Current agent mode state (module-level singleton).\n *\n * This tracks the active mode for the current process. In multi-session\n * scenarios, each session should manage its own mode state rather than\n * relying on this global.\n */\nlet currentMode: AgentMode = \"smart\";\n\n/**\n * Get the current agent mode.\n *\n * @returns The currently active agent mode\n */\nexport function getCurrentMode(): AgentMode {\n\treturn currentMode;\n}\n\n/**\n * Set the current agent mode.\n *\n * This updates the global mode state and logs the transition for debugging.\n * Mode changes take effect immediately for subsequent operations.\n *\n * @param mode - The new mode to activate\n */\nexport function setCurrentMode(mode: AgentMode): void {\n\tlogger.info(\"Setting agent mode\", { mode });\n\tcurrentMode = mode;\n\tconst config = getModeConfig(mode);\n\tif (config.visible === false) {\n\t\tvoid recordStagedRolloutSurfaceUsage(\"hidden_mode_used\", {\n\t\t\tsurfaceId: `mode:${mode}`,\n\t\t\tsurfaceType: \"mode\",\n\t\t\towner: config.rolloutOwner,\n\t\t});\n\t}\n}\n\n/**\n * Parse mode from string (case-insensitive).\n *\n * Validates user input and converts to a valid AgentMode type.\n *\n * @param modeStr - User-provided mode string (e.g., \"Smart\", \"RUSH\")\n * @returns The parsed AgentMode, or null if invalid\n */\nexport function parseMode(modeStr: string): AgentMode | null {\n\tconst normalized = modeStr.toLowerCase().trim();\n\tif (normalized in MODE_CONFIGS) {\n\t\treturn normalized as AgentMode;\n\t}\n\treturn null;\n}\n\n/**\n * Get mode from environment variable.\n *\n * Reads MAESTRO_MODE from environment and validates it.\n * Defaults to \"smart\" if not set or invalid.\n *\n * @returns The configured mode or \"smart\" as default\n */\nexport function getModeFromEnv(): AgentMode {\n\tconst envMode = process.env.MAESTRO_MODE?.toLowerCase();\n\tif (envMode && envMode in MODE_CONFIGS) {\n\t\treturn envMode as AgentMode;\n\t}\n\t// Default to smart mode for best quality when not specified\n\treturn \"smart\";\n}\n\n/**\n * Format mode for display.\n */\nexport function formatModeDisplay(mode: AgentMode): string {\n\tconst config = getModeConfig(mode);\n\treturn `${config.displayName} - ${config.description}`;\n}\n\n/**\n * Get all available modes with their descriptions.\n */\nexport function getAllModes(options?: {\n\tincludeHidden?: boolean;\n}): Array<{ mode: AgentMode; config: ModeConfig }> {\n\treturn (Object.entries(MODE_CONFIGS) as [AgentMode, ModeConfig][])\n\t\t.filter(([, config]) => options?.includeHidden === true || config.visible)\n\t\t.map(([mode, config]) => ({\n\t\t\tmode,\n\t\t\tconfig,\n\t\t}));\n}\n\n/**\n * Suggest a mode based on task complexity heuristics.\n *\n * This function analyzes the task description to recommend an appropriate\n * mode based on keyword matching. It uses a scoring system to determine\n * task complexity:\n *\n * **Scoring Algorithm:**\n * 1. Count matches against complex/simple/info indicator word lists\n * 2. Compare scores to determine dominant category\n * 3. Return mode matching the highest score\n *\n * **Keyword Categories:**\n * - Complex (→ smart): refactor, architect, design, implement, build...\n * - Simple (→ rush): fix, typo, rename, update, small changes...\n * - Info (→ free): what, where, explain, find, search queries...\n *\n * @param taskDescription - The user's task description to analyze\n * @returns The recommended AgentMode based on task complexity\n *\n * @example\n * suggestMode(\"refactor the authentication module\") // → \"smart\"\n * suggestMode(\"fix typo in README\") // → \"rush\"\n * suggestMode(\"what does this function do?\") // → \"free\"\n */\nexport function suggestMode(taskDescription: string): AgentMode {\n\tconst lowerTask = taskDescription.toLowerCase();\n\n\t// Complex tasks → smart mode (require deep reasoning)\n\tconst complexIndicators = [\n\t\t\"refactor\",\n\t\t\"architect\",\n\t\t\"design\",\n\t\t\"implement\",\n\t\t\"create\",\n\t\t\"build\",\n\t\t\"complex\",\n\t\t\"system\",\n\t\t\"full\",\n\t\t\"entire\",\n\t\t\"comprehensive\",\n\t];\n\n\t// Simple tasks → rush mode (straightforward modifications)\n\tconst simpleIndicators = [\n\t\t\"fix\",\n\t\t\"typo\",\n\t\t\"simple\",\n\t\t\"quick\",\n\t\t\"small\",\n\t\t\"minor\",\n\t\t\"rename\",\n\t\t\"update\",\n\t\t\"change\",\n\t];\n\n\t// Information tasks → free mode (queries, not modifications)\n\tconst infoIndicators = [\n\t\t\"what\",\n\t\t\"where\",\n\t\t\"explain\",\n\t\t\"describe\",\n\t\t\"list\",\n\t\t\"show\",\n\t\t\"find\",\n\t\t\"search\",\n\t];\n\n\t// Calculate match scores for each category\n\tconst complexScore = complexIndicators.filter((i) =>\n\t\tlowerTask.includes(i),\n\t).length;\n\tconst simpleScore = simpleIndicators.filter((i) =>\n\t\tlowerTask.includes(i),\n\t).length;\n\tconst infoScore = infoIndicators.filter((i) => lowerTask.includes(i)).length;\n\n\t// Determine mode based on highest scoring category\n\tif (complexScore > simpleScore && complexScore > infoScore) {\n\t\treturn \"smart\";\n\t}\n\tif (infoScore > simpleScore) {\n\t\treturn \"free\";\n\t}\n\tif (simpleScore > 0) {\n\t\treturn \"rush\";\n\t}\n\n\t// Default to smart mode when no clear indicators found\n\t// (better to over-estimate complexity than under-estimate)\n\treturn \"smart\";\n}\n"]}

package/dist/agent/oracle-consultation-policy.d.ts

@@ -0,0 +1,22 @@
+import type { AgentProfileLevel } from "./profiles.js";
+export declare const ORACLE_CONSULTATION_POLICY_VERSION = "evalops.maestro.oracle-consultation.v1";
+export type OracleConsultationMode = "available" | "recommended" | "required";
+export interface OracleConsultationPolicyInput {
+    policyVersion?: string;
+    profileLevel: AgentProfileLevel;
+    taskType: string;
+    taskSummary?: string;
+    priorFailures?: number;
+}
+export interface OracleConsultationDecision {
+    policyVersion: string;
+    evalSuite: "oracle-consultation-policy-v1";
+    mode: OracleConsultationMode;
+    reasons: string[];
+}
+export declare function recommendOracleConsultation(input: OracleConsultationPolicyInput): OracleConsultationDecision;
+export declare function formatOracleConsultationDirective(decision: OracleConsultationDecision): string;
+export declare function applyOracleConsultationDirective(agent: {
+    queueNextRunSystemPromptAddition(text: string): void;
+}, decision: OracleConsultationDecision | undefined): boolean;
+//# sourceMappingURL=oracle-consultation-policy.d.ts.map

package/dist/agent/oracle-consultation-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-consultation-policy.d.ts","sourceRoot":"","sources":["../../src/agent/oracle-consultation-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,eAAO,MAAM,kCAAkC,2CACN,CAAC;AAE1C,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,6BAA6B;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,iBAAiB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,+BAA+B,CAAC;IAC3C,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAkBD,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,6BAA6B,GAClC,0BAA0B,CA4C5B;AAED,wBAAgB,iCAAiC,CAChD,QAAQ,EAAE,0BAA0B,GAClC,MAAM,CAYR;AAED,wBAAgB,gCAAgC,CAC/C,KAAK,EAAE;IAAE,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC/D,QAAQ,EAAE,0BAA0B,GAAG,SAAS,GAC9C,OAAO,CAMT"}

package/dist/agent/oracle-consultation-policy.js

@@ -0,0 +1,72 @@
+export const ORACLE_CONSULTATION_POLICY_VERSION = "evalops.maestro.oracle-consultation.v1";
+const CONSULTATION_TASK_TYPES = new Set([
+    "architecture",
+    "code_review",
+    "discovery",
+    "incident_response",
+    "migration",
+    "planning",
+    "security_review",
+]);
+const UNCERTAINTY_PATTERN = /\b(?:ambiguous|unclear|uncertain|trade-?offs?|cross[- ]cutting|multiple approaches|data loss|irreversible|root cause unknown)\b/i;
+const CONSULTATION_PROMPT_PATTERN = /\b(?:architect(?:ure|ural|ing)?|migrat(?:e|es|ed|ing|ion)|security|secure|threat model(?:ing)?|auth(?:entication|orization)?|schema (?:change|migration)|backfill)\b/i;
+export function recommendOracleConsultation(input) {
+    const reasons = [];
+    const priorFailures = Math.max(0, Math.floor(input.priorFailures ?? 0));
+    let mode = "available";
+    if (input.profileLevel === "ultra") {
+        mode = "required";
+        reasons.push("ultra_profile");
+    }
+    else if (input.profileLevel === "high") {
+        mode = "recommended";
+        reasons.push("high_profile");
+    }
+    if (CONSULTATION_TASK_TYPES.has(input.taskType.trim().toLowerCase())) {
+        if (mode === "available")
+            mode = "recommended";
+        reasons.push("consultation_task_type");
+    }
+    if (input.taskSummary && UNCERTAINTY_PATTERN.test(input.taskSummary)) {
+        if (mode === "available")
+            mode = "recommended";
+        reasons.push("uncertainty_signal");
+    }
+    if (input.taskSummary &&
+        CONSULTATION_PROMPT_PATTERN.test(input.taskSummary)) {
+        if (mode === "available")
+            mode = "recommended";
+        reasons.push("consultation_prompt_signal");
+    }
+    if (priorFailures >= 2) {
+        mode = input.profileLevel === "low" ? "recommended" : "required";
+        reasons.push("repeated_failures");
+    }
+    if (reasons.length === 0)
+        reasons.push("oracle_available_on_demand");
+    return {
+        policyVersion: input.policyVersion?.trim() || ORACLE_CONSULTATION_POLICY_VERSION,
+        evalSuite: "oracle-consultation-policy-v1",
+        mode,
+        reasons,
+    };
+}
+export function formatOracleConsultationDirective(decision) {
+    const instruction = decision.mode === "required"
+        ? "You MUST consult the read-only Oracle once before committing to the plan or final answer. Incorporate or explicitly rebut its advice."
+        : decision.mode === "recommended"
+            ? "Consult the read-only Oracle once before committing to the plan or final answer unless the task has become clearly bounded; if you skip it, state the concrete reason."
+            : "The read-only Oracle is available on demand.";
+    return [
+        `Oracle consultation policy (${decision.policyVersion})`,
+        instruction,
+        `Triggers: ${decision.reasons.join(", ")}.`,
+    ].join("\n");
+}
+export function applyOracleConsultationDirective(agent, decision) {
+    if (!decision || decision.mode === "available")
+        return false;
+    agent.queueNextRunSystemPromptAddition(formatOracleConsultationDirective(decision));
+    return true;
+}
+//# sourceMappingURL=oracle-consultation-policy.js.map

package/dist/agent/oracle-consultation-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-consultation-policy.js","sourceRoot":"","sources":["../../src/agent/oracle-consultation-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentProfileLevel } from \"./profiles.js\";\n\nexport const ORACLE_CONSULTATION_POLICY_VERSION =\n\t\"evalops.maestro.oracle-consultation.v1\";\n\nexport type OracleConsultationMode = \"available\" | \"recommended\" | \"required\";\n\nexport interface OracleConsultationPolicyInput {\n\tpolicyVersion?: string;\n\tprofileLevel: AgentProfileLevel;\n\ttaskType: string;\n\ttaskSummary?: string;\n\tpriorFailures?: number;\n}\n\nexport interface OracleConsultationDecision {\n\tpolicyVersion: string;\n\tevalSuite: \"oracle-consultation-policy-v1\";\n\tmode: OracleConsultationMode;\n\treasons: string[];\n}\n\nconst CONSULTATION_TASK_TYPES = new Set([\n\t\"architecture\",\n\t\"code_review\",\n\t\"discovery\",\n\t\"incident_response\",\n\t\"migration\",\n\t\"planning\",\n\t\"security_review\",\n]);\n\nconst UNCERTAINTY_PATTERN =\n\t/\\b(?:ambiguous|unclear|uncertain|trade-?offs?|cross[- ]cutting|multiple approaches|data loss|irreversible|root cause unknown)\\b/i;\n\nconst CONSULTATION_PROMPT_PATTERN =\n\t/\\b(?:architect(?:ure|ural|ing)?|migrat(?:e|es|ed|ing|ion)|security|secure|threat model(?:ing)?|auth(?:entication|orization)?|schema (?:change|migration)|backfill)\\b/i;\n\nexport function recommendOracleConsultation(\n\tinput: OracleConsultationPolicyInput,\n): OracleConsultationDecision {\n\tconst reasons: string[] = [];\n\tconst priorFailures = Math.max(0, Math.floor(input.priorFailures ?? 0));\n\tlet mode: OracleConsultationMode = \"available\";\n\n\tif (input.profileLevel === \"ultra\") {\n\t\tmode = \"required\";\n\t\treasons.push(\"ultra_profile\");\n\t} else if (input.profileLevel === \"high\") {\n\t\tmode = \"recommended\";\n\t\treasons.push(\"high_profile\");\n\t}\n\n\tif (CONSULTATION_TASK_TYPES.has(input.taskType.trim().toLowerCase())) {\n\t\tif (mode === \"available\") mode = \"recommended\";\n\t\treasons.push(\"consultation_task_type\");\n\t}\n\n\tif (input.taskSummary && UNCERTAINTY_PATTERN.test(input.taskSummary)) {\n\t\tif (mode === \"available\") mode = \"recommended\";\n\t\treasons.push(\"uncertainty_signal\");\n\t}\n\n\tif (\n\t\tinput.taskSummary &&\n\t\tCONSULTATION_PROMPT_PATTERN.test(input.taskSummary)\n\t) {\n\t\tif (mode === \"available\") mode = \"recommended\";\n\t\treasons.push(\"consultation_prompt_signal\");\n\t}\n\n\tif (priorFailures >= 2) {\n\t\tmode = input.profileLevel === \"low\" ? \"recommended\" : \"required\";\n\t\treasons.push(\"repeated_failures\");\n\t}\n\n\tif (reasons.length === 0) reasons.push(\"oracle_available_on_demand\");\n\treturn {\n\t\tpolicyVersion:\n\t\t\tinput.policyVersion?.trim() || ORACLE_CONSULTATION_POLICY_VERSION,\n\t\tevalSuite: \"oracle-consultation-policy-v1\",\n\t\tmode,\n\t\treasons,\n\t};\n}\n\nexport function formatOracleConsultationDirective(\n\tdecision: OracleConsultationDecision,\n): string {\n\tconst instruction =\n\t\tdecision.mode === \"required\"\n\t\t\t? \"You MUST consult the read-only Oracle once before committing to the plan or final answer. Incorporate or explicitly rebut its advice.\"\n\t\t\t: decision.mode === \"recommended\"\n\t\t\t\t? \"Consult the read-only Oracle once before committing to the plan or final answer unless the task has become clearly bounded; if you skip it, state the concrete reason.\"\n\t\t\t\t: \"The read-only Oracle is available on demand.\";\n\treturn [\n\t\t`Oracle consultation policy (${decision.policyVersion})`,\n\t\tinstruction,\n\t\t`Triggers: ${decision.reasons.join(\", \")}.`,\n\t].join(\"\\n\");\n}\n\nexport function applyOracleConsultationDirective(\n\tagent: { queueNextRunSystemPromptAddition(text: string): void },\n\tdecision: OracleConsultationDecision | undefined,\n): boolean {\n\tif (!decision || decision.mode === \"available\") return false;\n\tagent.queueNextRunSystemPromptAddition(\n\t\tformatOracleConsultationDirective(decision),\n\t);\n\treturn true;\n}\n"]}

package/dist/agent/oracle-policy-experiment.d.ts

@@ -0,0 +1,27 @@
+export type OraclePolicyExperimentArm = "control" | "treatment";
+export interface OraclePolicyExperimentInput {
+    experimentId: string;
+    sessionId: string;
+    /** Fraction of sessions assigned to treatment, in the inclusive range 0..1. */
+    allocation: number;
+    controlVersion: string;
+    treatmentVersion: string;
+}
+export interface OraclePolicyExperimentAssignment {
+    readonly experimentId: string;
+    readonly arm: OraclePolicyExperimentArm;
+    readonly policyVersion: string;
+    readonly bucket: number;
+}
+export interface OraclePolicyExperimentConfig {
+    experimentId: string;
+    allocation: number;
+    controlVersion: string;
+    treatmentVersion: string;
+}
+/** Deterministically assign a session to one immutable Oracle policy arm. */
+export declare function assignOraclePolicyExperiment(input: OraclePolicyExperimentInput): OraclePolicyExperimentAssignment;
+/** Resolve the optional host-configured experiment. Partial configs fail closed. */
+export declare function getOraclePolicyExperimentConfig(): OraclePolicyExperimentConfig | undefined;
+export declare function assignConfiguredOraclePolicyExperiment(sessionId: string): OraclePolicyExperimentAssignment | undefined;
+//# sourceMappingURL=oracle-policy-experiment.d.ts.map

package/dist/agent/oracle-policy-experiment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-policy-experiment.d.ts","sourceRoot":"","sources":["../../src/agent/oracle-policy-experiment.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEhE,MAAM,WAAW,2BAA2B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,yBAAyB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAKD,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,2BAA2B,GAChC,gCAAgC,CA8BlC;AAED,oFAAoF;AACpF,wBAAgB,+BAA+B,IAC5C,4BAA4B,GAC5B,SAAS,CA6BX;AAED,wBAAgB,sCAAsC,CACrD,SAAS,EAAE,MAAM,GACf,gCAAgC,GAAG,SAAS,CAK9C"}