whale-code 6.5.5 → 6.5.7

package/dist/shared/agent-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-core.js","names":["getProvider","resolveToolChoice","opts","toolChoice","undefined","recentToolUses","length","last3","slice","last6","isRepeatingPair","turnCount","userMessage","availableToolNames","msgLower","toLowerCase","toolName","includes","type","name","COMPACTION_TRIGGER_TOKENS","COMPACTION_TOTAL_BUDGET","DEFAULT_SESSION_COST_BUDGET_USD","getCompactionConfig","model","provider","triggerTokens","totalBudget","isNative","getContextManagement","overrides","betas","config","edits","clearThinkingKeep","clear_thinking_keep","push","keep","value","supportsCompaction","compactionTrigger","compaction_trigger_tokens","AGENT_DEFAULTS","compactionTriggerTokens","trigger","pause_after_compaction","instructions","clearToolUsesTrigger","clear_tool_uses_trigger","clearToolUsesKeep","clear_tool_uses_keep","DEFAULT_OUTPUT_TOKENS","MODEL_MAX_OUTPUT_TOKENS","getMaxOutputTokens","agentMax","modelMax","Math","min","addPromptCaching","tools","messages","cachedTools","cache_control","cachedMessages","idx","msg","content","text","Array","isArray","blocks","djb2Hash","str","hash","i","charCodeAt","toString","LoopDetector","history","consecutiveErrors","Map","turnErrors","turnHadErrors","sessionErrors","failedStrategies","Set","consecutiveFailedTurns","totalSessionErrors","fileReadCounts","constructor","identicalCallLimit","loopIdenticalCallLimit","consecutiveErrorLimit","loopConsecutiveErrorLimit","turnErrorLimit","loopTurnErrorLimit","window","loopWindow","sessionToolErrorLimit","loopSessionToolErrorLimit","consecutiveFailedTurnLimit","loopConsecutiveFailedTurnLimit","fileReadLimit","loopFileReadLimit","fromResolved","resolved","errorKey","input","action","recordCall","inputHash","JSON","stringify","eKey","has","blocked","reason","sessionErrorCount","get","errorCount","windowSlice","identicalCount","filter","h","trackRead","path","readCount","set","recordResult","success","transient","delete","current","sessionCount","add","size","arr","from","endTurn","clear","key","count","decayed","floor","shouldBail","message","resetTurn","reset","getSessionStats","totalErrors","getThinkingConfig","enabled","thinking","beta","isReasoning","test","budget_tokens","MODEL_PRICING","inputPer1M","outputPer1M","thinkingPer1M","emitCostWarningIfNeeded","sessionCostUsd","maxCostUsd","costWarningsEmitted","onText","isFinite","pct","toFixed","estimateCostUsd","inputTokens","outputTokens","thinkingTokens","cacheReadTokens","cacheCreationTokens","pricing","Object","keys","find","k","startsWith","thinkingRate","inputRate","cost","max","routeModel","requestedModel","forceModel","estimatedTokens","ceil","simplePatterns","complexPatterns","categorizeError","err","e","status","statusCode","String","category","retryable","isRetryableError","demoteSubagentModel","requested","agentType","maxTurns","temperature","maxConcurrentTools","enableDelegation","maxDurationMs","maxDurationMsWorkflow","enableModelRouting","subagentMaxTokens","subagentMaxTurns","subagentTemperature","subagentMaxRetries","maxContinuations","subagentMaxContinuations","maxMessageChars","maxHistoryChars","maxToolResultChars","compactionTotalBudget","sessionCostBudgetUsd","teammateMaxTotalTurns","teamTimeoutMs","workerStallMs","teamReviewMaxTokens","apiTimeoutMs","toolTimeoutMs","toolResultTruncateChars","loopBatchErrorLimit","resolveAgentLoopConfig","agent","callPath","workflowMaxTurns","cc","context_config","defaultsUsed","resolve","dbValue","defaultValue","agentMaxTurns","max_tool_calls","maxTokens","max_tokens","durationDefault","max_concurrent_tools","enable_delegation","max_duration_ms","enable_model_routing","max_message_chars","max_history_chars","contextOverrides","compaction_total_budget","session_cost_budget_usd","subagent_max_tokens","subagent_max_turns","subagent_temperature","max_continuations","subagent_max_continuations","subagent_max_retries","max_tool_result_chars","teammate_max_total_turns","team_timeout_ms","worker_stall_ms","team_review_max_tokens","api_timeout_ms","tool_timeout_ms","tool_result_truncate_chars","loop_identical_call_limit","loop_consecutive_error_limit","loop_turn_error_limit","loop_window","loop_session_tool_error_limit","loop_consecutive_failed_turn_limit","loop_file_read_limit","loop_batch_error_limit","sanitizeError","replace","substring"],"sources":["../../src/shared/agent-core.ts"],"sourcesContent":["/**\n * Shared Agent Core — single source of truth for CLI + server agent\n *\n * Pure TypeScript, no runtime-specific APIs (no Deno.env, no process.env, no fs).\n * Both the CLI (Node.js) and server (Fly container) import from here.\n */\n\nimport { getProvider } from \"./constants.js\";\nimport type { CompactableMessage } from \"./compaction.js\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface LoopCheckResult {\n  blocked: boolean;\n  reason?: string;\n}\n\nexport interface BailCheckResult {\n  shouldBail: boolean;\n  message?: string;\n}\n\nexport interface CostInfo {\n  inputTokens: number;\n  outputTokens: number;\n  costUsd: number;\n  cacheCreation: number;\n  cacheRead: number;\n}\n\n// ============================================================================\n// TOOL CHOICE\n// ============================================================================\n\n/**\n * Controls which tools the model can/must use:\n * - \"auto\": Model decides whether to use tools (default)\n * - \"any\": Model must use at least one tool\n * - \"none\": Model must not use any tools (text-only response)\n * - { type: \"tool\", name: string }: Model must use the specified tool\n */\nexport type ToolChoice = \"auto\" | \"any\" | \"none\" | { type: \"tool\"; name: string };\n\n/**\n * Resolve the effective tool_choice for a given turn.\n *\n * Priority:\n * 1. Explicit override from caller (toolChoice option)\n * 2. Loop detection: if last 3 turns all used the same tool, force \"none\"\n * 3. Keyword detection: if user message mentions a tool name, force that tool\n * 4. Default: \"auto\"\n */\nexport function resolveToolChoice(\n  opts: {\n    toolChoice?: ToolChoice;\n    turnCount: number;\n    recentToolUses: string[];\n    availableToolNames: string[];\n    userMessage: string;\n  },\n): ToolChoice {\n  // 1. Explicit override always wins\n  if (opts.toolChoice !== undefined) return opts.toolChoice;\n\n  // 2. Loop detection: if last 3+ turns all used the exact same tool, force text\n  if (opts.recentToolUses.length >= 3) {\n    const last3 = opts.recentToolUses.slice(-3);\n    if (last3[0] === last3[1] && last3[1] === last3[2]) {\n      return \"none\";\n    }\n  }\n\n  // 2b. Alternating pattern detection: catch A→B→A→B→A→B death spirals (e.g. read→edit→read→edit)\n  if (opts.recentToolUses.length >= 6) {\n    const last6 = opts.recentToolUses.slice(-6);\n    const isRepeatingPair =\n      last6[2] === last6[0] && last6[3] === last6[1] &&\n      last6[4] === last6[0] && last6[5] === last6[1];\n    if (isRepeatingPair) return \"none\";\n  }\n\n  // 3. Keyword matching: check if the user message mentions a specific tool name\n  //    Only on the first turn (avoids false positives on multi-turn conversations)\n  if (opts.turnCount === 1 && opts.userMessage && opts.availableToolNames.length > 0) {\n    const msgLower = opts.userMessage.toLowerCase();\n    for (const toolName of opts.availableToolNames) {\n      // Match tool name as a whole word (e.g. \"blender_do\" not \"do\")\n      // Only consider tool names >= 4 chars to avoid false positives\n      if (toolName.length >= 4 && msgLower.includes(toolName.toLowerCase())) {\n        return { type: \"tool\", name: toolName };\n      }\n    }\n  }\n\n  // 4. Default\n  return \"auto\";\n}\n\nexport interface ContextManagementConfig {\n  betas: string[];\n  config: { edits: Array<Record<string, unknown>> };\n}\n\n/** Overrides from ai_agent_config.context_config JSONB — all optional, falls back to defaults */\nexport interface ContextManagementOverrides {\n  compaction_trigger_tokens?: number;\n  compaction_total_budget?: number;\n  clear_thinking_keep?: number;\n  clear_tool_uses_trigger?: number;\n  clear_tool_uses_keep?: number;\n  session_cost_budget_usd?: number;\n}\n\n// ============================================================================\n// MODEL-AWARE CONTEXT MANAGEMENT\n// ============================================================================\n\n// These re-export from AGENT_DEFAULTS so there's exactly one place to change.\n// DB context_config always overrides these via resolveAgentLoopConfig().\n\n/** Legacy compaction trigger — used by getCompactionConfig() for non-Anthropic providers. */\nexport const COMPACTION_TRIGGER_TOKENS = 167_000;\n/** Max cumulative tokens before forcing wrap-up */\nexport const COMPACTION_TOTAL_BUDGET = 2_000_000;\n/** Session cost safety cap — DB context_config.session_cost_budget_usd overrides */\nexport const DEFAULT_SESSION_COST_BUDGET_USD = 25.00;\n\n/**\n * Provider-aware compaction configuration.\n * - Anthropic/Bedrock: native server-side compaction via compact_20260112\n * - OpenAI/Gemini: Haiku-based summarization (same instructions, same format)\n */\nexport interface CompactionConfig {\n  triggerTokens: number;  // When to trigger compaction\n  totalBudget: number;    // Max cumulative tokens before forced wrap-up\n  isNative: boolean;      // true = Anthropic handles it server-side, false = we call Haiku\n}\n\nexport function getCompactionConfig(model: string): CompactionConfig {\n  const provider = getProvider(model);\n\n  switch (provider) {\n    case \"gemini\":\n      return { triggerTokens: 700_000, totalBudget: 4_000_000, isNative: false };\n    case \"openai\":\n      return { triggerTokens: 120_000, totalBudget: 2_000_000, isNative: false };\n    case \"bedrock\":\n    case \"anthropic\":\n    default:\n      return { triggerTokens: COMPACTION_TRIGGER_TOKENS, totalBudget: COMPACTION_TOTAL_BUDGET, isNative: true };\n  }\n}\n\n/**\n * Returns Anthropic beta flags and context_management config for the given model.\n * - Opus 4.6 / Sonnet 4.6: compact at 120K (pause after) + clear thinking + clear tools at 80K/keep 3\n * - All other Claude models: clear thinking + clear tools at 80K/keep 3\n * - Non-Anthropic models (Gemini, OpenAI): no betas, no context management\n */\nexport function getContextManagement(model: string, overrides?: ContextManagementOverrides): ContextManagementConfig {\n  // Non-Anthropic models don't use Anthropic betas or context management\n  const provider = getProvider(model);\n  if (provider === \"gemini\" || provider === \"openai\") {\n    return { betas: [], config: { edits: [] } };\n  }\n\n  const edits: Array<Record<string, unknown>> = [];\n  const betas: string[] = [\"context-management-2025-06-27\"];\n\n  // Thinking block clearing — must come FIRST in edits array (API requirement).\n  // Default: keep 1 thinking turn (matches Claude Code / Anthropic API defaults).\n  const clearThinkingKeep = overrides?.clear_thinking_keep ?? 1;\n  edits.push({\n    type: \"clear_thinking_20251015\",\n    keep: { type: \"thinking_turns\", value: clearThinkingKeep },\n  });\n\n  // Server-side compaction for models that support compact_20260112.\n  // Default trigger: 150K tokens (matches Anthropic API default).\n  // pause_after_compaction: true enables the loop to preserve recent messages\n  // and track compaction count for budget enforcement.\n  const supportsCompaction = model.includes(\"opus-4-6\") || model.includes(\"sonnet-4-6\");\n  const compactionTrigger = overrides?.compaction_trigger_tokens ?? AGENT_DEFAULTS.compactionTriggerTokens;\n  if (supportsCompaction) {\n    edits.push({\n      type: \"compact_20260112\",\n      trigger: { type: \"input_tokens\", value: compactionTrigger },\n      pause_after_compaction: true,\n      instructions: \"Summarize the conversation preserving: (1) task goals and constraints, (2) files created/modified with paths, (3) decisions made and rationale, (4) errors encountered and resolutions, (5) exact next steps. Be concise but preserve all state needed to continue work without repeating mistakes.\",\n    });\n    betas.push(\"compact-2026-01-12\");\n  }\n\n  // Clear tool uses — default: trigger at 100K, keep 3 (matches Anthropic API defaults).\n  const clearToolUsesTrigger = overrides?.clear_tool_uses_trigger ?? 100_000;\n  const clearToolUsesKeep = overrides?.clear_tool_uses_keep ?? 3;\n  edits.push({\n    type: \"clear_tool_uses_20250919\",\n    trigger: { type: \"input_tokens\", value: clearToolUsesTrigger },\n    keep: { type: \"tool_uses\", value: clearToolUsesKeep },\n  });\n\n  return { betas, config: { edits } };\n}\n\n/**\n * Model-aware max output tokens.\n * Agent config max_tokens takes priority but is capped at model maximum.\n *\n * DEFAULT_OUTPUT_TOKENS is the sensible per-response cap (like Claude Code's ~16K).\n * The full MODEL_MAX is only used when explicitly requested via agentMax.\n */\n// Fallback only when DB agent.max_tokens is null/0. DB value (ai_agent_config.max_tokens) takes priority.\nconst DEFAULT_OUTPUT_TOKENS = 32000;\n\nconst MODEL_MAX_OUTPUT_TOKENS: Record<string, number> = {\n  // Anthropic — current models (actual API-enforced limits)\n  \"claude-opus-4-6\": 128000,           // 128K\n  \"claude-sonnet-4-6\": 64000,          // 64K (API enforces 64000, not 65536)\n  \"claude-haiku-4-5-20251001\": 64000,  // 64K\n  // Anthropic — legacy models\n  \"claude-sonnet-4-5-20250929\": 64000, // 64K (API enforces 64000)\n  \"claude-opus-4-5-20251101\": 64000,   // 64K\n  \"claude-opus-4-1-20250805\": 32768,   // 32K\n  \"claude-sonnet-4-20250514\": 64000,   // 64K\n  \"claude-opus-4-20250514\": 32768,     // 32K\n  \"claude-3-7-sonnet-20250219\": 64000, // 64K\n  \"claude-3-haiku-20240307\": 4096,     // 4K\n  // Bedrock — same limits as direct API\n  \"anthropic.claude-sonnet-4-6\": 64000,\n  \"us.anthropic.claude-sonnet-4-20250514-v1:0\": 64000,\n  \"us.anthropic.claude-sonnet-4-5-20250929-v1:0\": 64000,\n  \"us.anthropic.claude-haiku-4-5-20251001-v1:0\": 64000,\n  // Google Gemini\n  \"gemini-3-pro-preview\": 65536,\n  \"gemini-3-flash-preview\": 65536,\n  \"gemini-2.5-pro\": 65536,\n  \"gemini-2.5-flash\": 65536,\n  \"gemini-2.5-flash-lite\": 65536,\n  // OpenAI — GPT-5 family: 128K max output, o-series: 100K\n  \"gpt-5\": 128000,\n  \"gpt-5-mini\": 128000,\n  \"gpt-5-nano\": 128000,\n  \"o3\": 100000,\n  \"o4-mini\": 100000,\n  \"gpt-4o\": 16384,\n};\n\nexport function getMaxOutputTokens(model: string, agentMax?: number): number {\n  const modelMax = MODEL_MAX_OUTPUT_TOKENS[model] ?? DEFAULT_OUTPUT_TOKENS;\n  // If caller explicitly sets agentMax, respect it (capped at model max).\n  // Otherwise use sane default — never auto-request 128K output.\n  if (agentMax) return Math.min(agentMax, modelMax);\n  return Math.min(DEFAULT_OUTPUT_TOKENS, modelMax);\n}\n\n// ============================================================================\n// MULTI-BREAKPOINT PROMPT CACHING\n// ============================================================================\n\n/**\n * Add prompt cache breakpoints to tools and messages.\n * Uses 2 of 4 allowed breakpoints:\n * - Last tool definition\n * - Turn boundary (second-to-last message)\n * System prompt caching is handled by the caller.\n */\nexport function addPromptCaching<\n  T extends object = Record<string, unknown>,\n  M extends CompactableMessage = CompactableMessage,\n>(\n  tools: T[],\n  messages: M[]\n): { tools: T[]; messages: M[] } {\n  const cachedTools =\n    tools.length > 0\n      ? [...tools.slice(0, -1), { ...tools[tools.length - 1], cache_control: { type: \"ephemeral\" } } as T]\n      : [...tools];\n\n  const cachedMessages = [...messages];\n  if (cachedMessages.length >= 2) {\n    const idx = cachedMessages.length - 2;\n    const msg = cachedMessages[idx] as any;\n    if (typeof msg.content === \"string\") {\n      cachedMessages[idx] = {\n        ...msg,\n        content: [{ type: \"text\", text: msg.content, cache_control: { type: \"ephemeral\" } }],\n      };\n    } else if (Array.isArray(msg.content)) {\n      const blocks = [...msg.content];\n      blocks[blocks.length - 1] = { ...blocks[blocks.length - 1], cache_control: { type: \"ephemeral\" } };\n      cachedMessages[idx] = { ...msg, content: blocks };\n    }\n  }\n\n  return { tools: cachedTools, messages: cachedMessages };\n}\n\n// ============================================================================\n// LOOP DETECTION\n// ============================================================================\n\n/** djb2 string hash — fast, deterministic, no dependencies */\nexport function djb2Hash(str: string): string {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash + str.charCodeAt(i)) & 0xffffffff;\n  }\n  return hash.toString(36);\n}\n\nexport interface LoopDetectorConfig {\n  identicalCallLimit: number;\n  consecutiveErrorLimit: number;\n  turnErrorLimit: number;\n  window: number;\n  sessionToolErrorLimit: number;\n  consecutiveFailedTurnLimit: number;\n  fileReadLimit: number;\n}\n\nexport class LoopDetector {\n  private history: { name: string; inputHash: string }[] = [];\n  private consecutiveErrors = new Map<string, number>();\n  private turnErrors = 0;\n  private turnHadErrors = false;\n\n  private sessionErrors = new Map<string, number>();\n  private failedStrategies = new Set<string>();\n  private consecutiveFailedTurns = 0;\n  private totalSessionErrors = 0;\n\n  /** Tracks how many times the same file path has been read this session */\n  private fileReadCounts = new Map<string, number>();\n\n  /** Resolved config — accepts DB overrides, falls back to AGENT_DEFAULTS */\n  readonly config: LoopDetectorConfig;\n\n  constructor(config?: Partial<LoopDetectorConfig>) {\n    this.config = {\n      identicalCallLimit: config?.identicalCallLimit ?? AGENT_DEFAULTS.loopIdenticalCallLimit,\n      consecutiveErrorLimit: config?.consecutiveErrorLimit ?? AGENT_DEFAULTS.loopConsecutiveErrorLimit,\n      turnErrorLimit: config?.turnErrorLimit ?? AGENT_DEFAULTS.loopTurnErrorLimit,\n      window: config?.window ?? AGENT_DEFAULTS.loopWindow,\n      sessionToolErrorLimit: config?.sessionToolErrorLimit ?? AGENT_DEFAULTS.loopSessionToolErrorLimit,\n      consecutiveFailedTurnLimit: config?.consecutiveFailedTurnLimit ?? AGENT_DEFAULTS.loopConsecutiveFailedTurnLimit,\n      fileReadLimit: config?.fileReadLimit ?? AGENT_DEFAULTS.loopFileReadLimit,\n    };\n  }\n\n  /** Create a LoopDetector from a ResolvedAgentLoopConfig */\n  static fromResolved(resolved: ResolvedAgentLoopConfig): LoopDetector {\n    return new LoopDetector({\n      identicalCallLimit: resolved.loopIdenticalCallLimit,\n      consecutiveErrorLimit: resolved.loopConsecutiveErrorLimit,\n      turnErrorLimit: resolved.loopTurnErrorLimit,\n      window: resolved.loopWindow,\n      sessionToolErrorLimit: resolved.loopSessionToolErrorLimit,\n      consecutiveFailedTurnLimit: resolved.loopConsecutiveFailedTurnLimit,\n      fileReadLimit: resolved.loopFileReadLimit,\n    });\n  }\n\n  /** Get the error-tracking key for a tool call. Tools with an `action` param\n   *  are tracked per-action so e.g. voice/speak failing won't block voice/music_compose. */\n  private errorKey(name: string, input?: Record<string, unknown>): string {\n    if (input && typeof input.action === \"string\") return `${name}:${input.action}`;\n    return name;\n  }\n\n  recordCall(name: string, input: Record<string, unknown>): LoopCheckResult {\n    const inputHash = djb2Hash(JSON.stringify({ name, ...input }));\n    const eKey = this.errorKey(name, input);\n\n    if (this.failedStrategies.has(inputHash)) {\n      return {\n        blocked: true,\n        reason: `Blocked: this exact \"${name}\" call failed in a previous turn. Try a fundamentally different approach.`,\n      };\n    }\n\n    const sessionErrorCount = this.sessionErrors.get(eKey) || 0;\n    if (sessionErrorCount >= this.config.sessionToolErrorLimit) {\n      return {\n        blocked: true,\n        reason: `Tool \"${name}\" (action: ${input.action || \"default\"}) has failed ${sessionErrorCount} times this session. Stop using this tool and try a different approach.`,\n      };\n    }\n\n    if (this.turnErrors >= this.config.turnErrorLimit) {\n      return {\n        blocked: true,\n        reason: `${this.turnErrors} errors this turn. Stop and re-assess your approach.`,\n      };\n    }\n\n    const errorCount = this.consecutiveErrors.get(eKey) || 0;\n    if (errorCount >= this.config.consecutiveErrorLimit) {\n      return {\n        blocked: true,\n        reason: `Tool \"${name}\" (action: ${input.action || \"default\"}) blocked: failed ${errorCount} times consecutively. Try a different approach or action.`,\n      };\n    }\n\n    const windowSlice = this.history.slice(-this.config.window);\n    const identicalCount = windowSlice.filter((h) => h.inputHash === inputHash).length;\n    if (identicalCount >= this.config.identicalCallLimit) {\n      return {\n        blocked: true,\n        reason: `Tool \"${name}\" blocked: identical call made ${identicalCount} times. Try different parameters.`,\n      };\n    }\n\n    this.history.push({ name, inputHash });\n    if (this.history.length > this.config.window * 2) {\n      this.history = this.history.slice(-this.config.window);\n    }\n\n    return { blocked: false };\n  }\n\n  /**\n   * Track file read frequency — call when the tool is known to be a file read.\n   * Blocks re-reading the same path more than FILE_READ_LIMIT times per session.\n   */\n  trackRead(path: string): LoopCheckResult {\n    const readCount = (this.fileReadCounts.get(path) || 0) + 1;\n    this.fileReadCounts.set(path, readCount);\n    if (readCount > this.config.fileReadLimit) {\n      return {\n        blocked: true,\n        reason: `File \"${path}\" already read ${readCount - 1} times this session. Use the content from a previous read instead of re-reading.`,\n      };\n    }\n    return { blocked: false };\n  }\n\n  /**\n   * Record a tool execution result.\n   * @param transient - If true, the failure is transient (timeout, rate limit)\n   *   and should NOT be added to failedStrategies. Transient failures are\n   *   retryable with the exact same inputs — e.g., a task_output poll that\n   *   timed out because the task is still running.\n   */\n  recordResult(name: string, success: boolean, input?: Record<string, unknown>, transient?: boolean): void {\n    const eKey = this.errorKey(name, input);\n    if (success) {\n      this.consecutiveErrors.delete(eKey);\n    } else {\n      const current = this.consecutiveErrors.get(eKey) || 0;\n      this.consecutiveErrors.set(eKey, current + 1);\n      this.turnErrors++;\n      this.turnHadErrors = true;\n\n      const sessionCount = this.sessionErrors.get(eKey) || 0;\n      this.sessionErrors.set(eKey, sessionCount + 1);\n      this.totalSessionErrors++;\n\n      // Only add to failedStrategies for non-transient errors.\n      // Transient errors (timeouts, rate limits) should be retryable with\n      // the exact same inputs — blocking them creates a deadlock for polling\n      // tools like task_output where the input (task_id) never changes.\n      if (input && !transient) {\n        const inputHash = djb2Hash(JSON.stringify({ name, ...input }));\n        this.failedStrategies.add(inputHash);\n        if (this.failedStrategies.size > 200) {\n          const arr = Array.from(this.failedStrategies);\n          this.failedStrategies = new Set(arr.slice(-100));\n        }\n      }\n    }\n  }\n\n  endTurn(): BailCheckResult {\n    if (this.turnHadErrors) {\n      this.consecutiveFailedTurns++;\n    } else {\n      this.consecutiveFailedTurns = 0;\n      // A clean turn means the agent has recovered — unblock previously failed strategies\n      // so it can retry calls that failed due to bad params (e.g., wrong UUID format)\n      this.failedStrategies.clear();\n      // Decay session error counts on clean turns so tools aren't permanently blocked.\n      // Each clean turn halves all session error counts, allowing recovery from\n      // transient issues while still blocking persistently broken tools.\n      if (this.sessionErrors.size > 0) {\n        for (const [key, count] of this.sessionErrors) {\n          const decayed = Math.floor(count / 2);\n          if (decayed <= 0) {\n            this.sessionErrors.delete(key);\n          } else {\n            this.sessionErrors.set(key, decayed);\n          }\n        }\n      }\n    }\n\n    // Cap consecutiveErrors so a single bad batch (parallel Promise.all) can't\n    // permanently brick a tool. Without this, N parallel failures push\n    // consecutiveErrors to N, which exceeds consecutiveErrorLimit and creates\n    // a deadlock: the tool is blocked because it failed, but can't succeed to\n    // unblock itself because it's blocked. Capping to (limit - 1) gives the\n    // tool one retry on the next turn. Only permanently block after multiple\n    // consecutive failed turns (handled by the bail-out check below).\n    if (this.consecutiveFailedTurns < this.config.consecutiveFailedTurnLimit) {\n      for (const [key, count] of this.consecutiveErrors) {\n        if (count >= this.config.consecutiveErrorLimit) {\n          this.consecutiveErrors.set(key, this.config.consecutiveErrorLimit - 1);\n        }\n      }\n    }\n\n    // Reset turn-level counters so the NEXT dispatch batch starts fresh.\n    // Session-level counters (sessionErrors, consecutiveFailedTurns) persist.\n    this.turnErrors = 0;\n    this.turnHadErrors = false;\n\n    if (this.consecutiveFailedTurns >= this.config.consecutiveFailedTurnLimit) {\n      return {\n        shouldBail: true,\n        message: `You have had errors in ${this.consecutiveFailedTurns} consecutive turns (${this.totalSessionErrors} total errors). Your approach is not working. STOP and explain to the user what's failing.`,\n      };\n    }\n\n    return { shouldBail: false };\n  }\n\n  resetTurn(): void {\n    // Only reset per-turn counters — history and consecutiveErrors persist\n    // for cross-turn detection. The full reset() clears everything for new sessions.\n    this.turnErrors = 0;\n    this.turnHadErrors = false;\n  }\n\n  reset(): void {\n    this.resetTurn();\n    this.history = [];\n    this.consecutiveErrors.clear();\n    this.sessionErrors.clear();\n    this.failedStrategies.clear();\n    this.fileReadCounts.clear();\n    this.consecutiveFailedTurns = 0;\n    this.totalSessionErrors = 0;\n  }\n\n  getSessionStats(): { totalErrors: number; failedStrategies: number; consecutiveFailedTurns: number } {\n    return {\n      totalErrors: this.totalSessionErrors,\n      failedStrategies: this.failedStrategies.size,\n      consecutiveFailedTurns: this.consecutiveFailedTurns,\n    };\n  }\n}\n\n// ============================================================================\n// EXTENDED THINKING\n// ============================================================================\n\nexport interface ThinkingConfig {\n  type: \"enabled\" | \"disabled\" | \"adaptive\";\n  budget_tokens?: number;\n}\n\n/**\n * Returns the thinking configuration and required beta string for the given model.\n * - Opus 4.6: adaptive thinking (no budget needed)\n * - Sonnet/Haiku: enabled with 10000 token budget\n * - budget_tokens must be strictly < max_tokens\n */\nexport function getThinkingConfig(model: string, enabled: boolean): {\n  thinking: ThinkingConfig;\n  beta: string;\n} {\n  if (!enabled) {\n    return { thinking: { type: \"disabled\" }, beta: \"\" };\n  }\n\n  const provider = getProvider(model);\n\n  // Gemini models: thinking is always-on for 2.5+/3.x — signal pass-through\n  if (provider === \"gemini\") {\n    return { thinking: { type: \"enabled\" }, beta: \"\" };\n  }\n\n  // OpenAI models: reasoning models (o-series) have built-in reasoning, GPT models don't support thinking\n  if (provider === \"openai\") {\n    const isReasoning = /^o\\d/.test(model);\n    return { thinking: { type: isReasoning ? \"enabled\" : \"disabled\" }, beta: \"\" };\n  }\n\n  if (model.includes(\"opus-4-6\") || model.includes(\"sonnet-4-6\")) {\n    return {\n      thinking: { type: \"adaptive\" },\n      beta: \"adaptive-thinking-2026-01-28\",\n    };\n  }\n\n  // Sonnet 4.5/4.0 / Haiku: fixed budget (matches Claude Code's 31,999 default)\n  return {\n    thinking: { type: \"enabled\", budget_tokens: 31_999 },\n    beta: \"interleaved-thinking-2025-05-14\",\n  };\n}\n\n// ============================================================================\n// COST TRACKING\n// ============================================================================\n\nexport const MODEL_PRICING: Record<string, { inputPer1M: number; outputPer1M: number; thinkingPer1M?: number }> = {\n  // Anthropic direct — Claude 4.x\n  \"claude-sonnet-4-6\": { inputPer1M: 3.0, outputPer1M: 15.0, thinkingPer1M: 15.0 },\n  \"claude-sonnet-4-20250514\": { inputPer1M: 3.0, outputPer1M: 15.0, thinkingPer1M: 15.0 },\n  \"claude-sonnet-4-5-20250929\": { inputPer1M: 3.0, outputPer1M: 15.0, thinkingPer1M: 15.0 },\n  \"claude-opus-4-6\": { inputPer1M: 5.0, outputPer1M: 25.0, thinkingPer1M: 25.0 },\n  \"claude-opus-4-20250514\": { inputPer1M: 5.0, outputPer1M: 25.0, thinkingPer1M: 25.0 },\n  \"claude-opus-4-5-20251101\": { inputPer1M: 5.0, outputPer1M: 25.0, thinkingPer1M: 25.0 },\n  \"claude-haiku-4-20250514\": { inputPer1M: 1.0, outputPer1M: 5.0, thinkingPer1M: 5.0 },\n  \"claude-haiku-4-5-20251001\": { inputPer1M: 1.0, outputPer1M: 5.0, thinkingPer1M: 5.0 },\n  // Anthropic direct — Claude 3.5\n  \"claude-3-5-sonnet-20241022\": { inputPer1M: 3.0, outputPer1M: 15.0 },\n  \"claude-3-5-haiku-20241022\": { inputPer1M: 0.80, outputPer1M: 4.0 },\n  // Bedrock — Claude 4.x\n  \"anthropic.claude-sonnet-4-6\": { inputPer1M: 3.0, outputPer1M: 15.0, thinkingPer1M: 15.0 },\n  \"us.anthropic.claude-sonnet-4-20250514-v1:0\": { inputPer1M: 3.0, outputPer1M: 15.0, thinkingPer1M: 15.0 },\n  \"us.anthropic.claude-sonnet-4-5-20250929-v1:0\": { inputPer1M: 3.0, outputPer1M: 15.0, thinkingPer1M: 15.0 },\n  \"us.anthropic.claude-haiku-4-5-20251001-v1:0\": { inputPer1M: 1.0, outputPer1M: 5.0, thinkingPer1M: 5.0 },\n  // Bedrock — Claude 3.5\n  \"us.anthropic.claude-3-5-haiku-20241022-v1:0\": { inputPer1M: 0.80, outputPer1M: 4.0 },\n  // Bedrock — Llama & Nova\n  \"us.meta.llama3-1-70b-instruct-v1:0\": { inputPer1M: 0.72, outputPer1M: 0.72 },\n  \"us.amazon.nova-pro-v1:0\": { inputPer1M: 0.80, outputPer1M: 3.20 },\n  // Gemini (thinking tokens are cheaper than output)\n  \"gemini-3-pro-preview\": { inputPer1M: 1.25, outputPer1M: 10.0, thinkingPer1M: 2.50 },\n  \"gemini-3-flash-preview\": { inputPer1M: 0.15, outputPer1M: 0.60, thinkingPer1M: 0.15 },\n  \"gemini-2.5-pro\": { inputPer1M: 1.25, outputPer1M: 10.0, thinkingPer1M: 2.50 },\n  \"gemini-2.5-flash\": { inputPer1M: 0.15, outputPer1M: 0.60, thinkingPer1M: 0.15 },\n  \"gemini-2.5-flash-lite\": { inputPer1M: 0.075, outputPer1M: 0.30, thinkingPer1M: 0.075 },\n  \"gemini-2.0-flash\": { inputPer1M: 0.10, outputPer1M: 0.40 },\n  \"gemini-2.0-flash-lite\": { inputPer1M: 0.075, outputPer1M: 0.30 },\n  // OpenAI — GPT\n  \"gpt-5\": { inputPer1M: 1.25, outputPer1M: 10.0 },\n  \"gpt-5-mini\": { inputPer1M: 0.25, outputPer1M: 2.0 },\n  \"gpt-5-nano\": { inputPer1M: 0.05, outputPer1M: 0.40 },\n  \"gpt-4o\": { inputPer1M: 2.50, outputPer1M: 10.0 },\n  \"gpt-4o-mini\": { inputPer1M: 0.15, outputPer1M: 0.60 },\n  \"gpt-4-turbo\": { inputPer1M: 10.0, outputPer1M: 30.0 },\n  // OpenAI — reasoning models\n  \"o1\": { inputPer1M: 15.0, outputPer1M: 60.0, thinkingPer1M: 60.0 },\n  \"o1-mini\": { inputPer1M: 3.0, outputPer1M: 12.0, thinkingPer1M: 12.0 },\n  \"o3\": { inputPer1M: 2.0, outputPer1M: 8.0, thinkingPer1M: 8.0 },\n  \"o3-mini\": { inputPer1M: 1.10, outputPer1M: 4.40, thinkingPer1M: 4.40 },\n  \"o4-mini\": { inputPer1M: 1.10, outputPer1M: 4.40, thinkingPer1M: 4.40 },\n};\n\n/**\n * Emit graduated cost warnings at 25%, 50%, 75% thresholds.\n * Single source of truth — replaces copy-pasted blocks in server + CLI.\n */\nexport function emitCostWarningIfNeeded(\n  sessionCostUsd: number,\n  maxCostUsd: number,\n  costWarningsEmitted: Set<number>,\n  onText?: (text: string) => void,\n): void {\n  if (!isFinite(maxCostUsd) || !onText) return;\n  for (const pct of [25, 50, 75]) {\n    if (!costWarningsEmitted.has(pct) && sessionCostUsd >= maxCostUsd * (pct / 100)) {\n      costWarningsEmitted.add(pct);\n      onText(`\\n[Cost warning: ${pct}% of budget used ($${sessionCostUsd.toFixed(2)}/$${maxCostUsd.toFixed(2)}).${pct >= 75 ? \" Wrap up soon.\" : \"\"}]`);\n    }\n  }\n}\n\nexport function estimateCostUsd(\n  inputTokens: number,\n  outputTokens: number,\n  model: string,\n  thinkingTokens = 0,\n  cacheReadTokens = 0,\n  cacheCreationTokens = 0,\n): number {\n  // Exact match first, then find a pricing key that is a prefix of the model ID\n  const pricing = MODEL_PRICING[model]\n    || MODEL_PRICING[Object.keys(MODEL_PRICING).find((k) => model.startsWith(k)) ?? \"\"]\n    || MODEL_PRICING[\"claude-sonnet-4-6\"];\n  const thinkingRate = pricing.thinkingPer1M || pricing.outputPer1M;\n  const inputRate = pricing.inputPer1M;\n\n  // Base cost\n  let cost = (inputTokens / 1_000_000) * inputRate\n    + (outputTokens / 1_000_000) * pricing.outputPer1M\n    + (thinkingTokens / 1_000_000) * thinkingRate;\n\n  // Cache pricing — subtract savings for cached tokens\n  // Anthropic/Bedrock: cache reads 90% cheaper, cache creation 25% surcharge\n  // OpenAI: cache reads 50% cheaper, no creation surcharge\n  // Gemini: cache reads 75% cheaper\n  if (cacheReadTokens > 0 || cacheCreationTokens > 0) {\n    const provider = getProvider(model);\n    if (provider === \"anthropic\" || provider === \"bedrock\") {\n      cost -= (cacheReadTokens / 1_000_000) * inputRate * 0.9;\n      cost += (cacheCreationTokens / 1_000_000) * inputRate * 0.25;\n    } else if (provider === \"openai\") {\n      cost -= (cacheReadTokens / 1_000_000) * inputRate * 0.5;\n    } else if (provider === \"gemini\") {\n      cost -= (cacheReadTokens / 1_000_000) * inputRate * 0.75;\n    }\n  }\n\n  return Math.max(0, cost);\n}\n\n// ============================================================================\n// MODEL ROUTING BY TASK COMPLEXITY\n// ============================================================================\n\n/**\n * Route to cheaper model when the task is simple enough.\n * Returns the model to actually use.\n */\nexport function routeModel(message: string, requestedModel: string, forceModel?: boolean): string {\n  // If user explicitly picked a model, respect it\n  if (forceModel) return requestedModel;\n\n  // Estimate token count (rough: 1 token ~= 4 chars)\n  const estimatedTokens = Math.ceil(message.length / 4);\n\n  // Simple queries → Haiku (30x cheaper than Opus)\n  const simplePatterns = /^(what|who|when|where|show|list|get|find|look ?up|check)\\b/i;\n  const complexPatterns = /\\b(analyze|implement|refactor|design|architect|debug|explain why|compare|evaluate|write|create|build|fix)\\b/i;\n\n  if (estimatedTokens < 50 && simplePatterns.test(message) && !complexPatterns.test(message)) {\n    return \"claude-haiku-4-5-20251001\";\n  }\n\n  // Medium queries → Sonnet\n  if (estimatedTokens < 200 && !complexPatterns.test(message)) {\n    return \"claude-sonnet-4-5-20250929\";\n  }\n\n  // Complex → honor requested model\n  return requestedModel;\n}\n\n// ============================================================================\n// ERROR CATEGORIZATION\n// ============================================================================\n\nexport type ErrorCategory =\n  | \"RATE_LIMIT\"\n  | \"TIMEOUT\"\n  | \"AUTH\"\n  | \"MALFORMED\"\n  | \"PROVIDER_DOWN\"\n  | \"NETWORK\"\n  | \"UNKNOWN\";\n\nexport function categorizeError(err: unknown): { category: ErrorCategory; retryable: boolean } {\n  const e = err as any;\n  const status = e?.status || e?.statusCode;\n  const msg = String(e?.message || \"\").toLowerCase();\n\n  if (status === 429 || msg.includes(\"rate limit\")) {\n    return { category: \"RATE_LIMIT\", retryable: true };\n  }\n  if (status === 401 || status === 403 || msg.includes(\"unauthorized\") || msg.includes(\"forbidden\") || msg.includes(\"invalid api key\")) {\n    return { category: \"AUTH\", retryable: false };\n  }\n  if (status === 400 || msg.includes(\"malformed\") || msg.includes(\"invalid\") || msg.includes(\"validation\")) {\n    return { category: \"MALFORMED\", retryable: false };\n  }\n  if (status === 500 || status === 502 || status === 503 || status === 529 || msg.includes(\"overloaded\") || msg.includes(\"internal server error\")) {\n    return { category: \"PROVIDER_DOWN\", retryable: true };\n  }\n  if (msg.includes(\"timeout\") || msg.includes(\"timed out\") || msg.includes(\"deadline\") || msg.includes(\"econnreset\") || msg.includes(\"stream stalled\")) {\n    return { category: \"TIMEOUT\", retryable: true };\n  }\n  if (msg.includes(\"econnrefused\") || msg.includes(\"enetunreach\") || msg.includes(\"enotfound\") || msg.includes(\"fetch failed\") || msg.includes(\"network\")) {\n    return { category: \"NETWORK\", retryable: true };\n  }\n  return { category: \"UNKNOWN\", retryable: false };\n}\n\n// ============================================================================\n// RETRY LOGIC\n// ============================================================================\n\nexport function isRetryableError(err: unknown): boolean {\n  return categorizeError(err).retryable;\n}\n\n// ============================================================================\n// UTILITY — model demotion, sanitize errors\n// ============================================================================\n\n/**\n * Demote subagent model requests — single source of truth for server + CLI.\n * - explore/research: always haiku\n * - opus: demoted to sonnet\n * - sonnet: kept for plan, demoted to haiku for others\n * - default/undefined: haiku\n */\n/**\n * Resolve subagent model based on agent type and request.\n *\n * Claude Code behavior: general-purpose and plan subagents inherit the parent\n * model (they do real work / need full reasoning). Only explore and research\n * are demoted to haiku (fast, focused tasks).\n */\nexport function demoteSubagentModel(\n  requested: string | undefined,\n  agentType?: string,\n): \"haiku\" | \"sonnet\" | \"opus\" {\n  // Fast, focused agent types always use haiku regardless of request\n  if (agentType === \"explore\" || agentType === \"research\") return \"haiku\";\n\n  // General-purpose and plan inherit the requested model (Claude Code parity)\n  if (agentType === \"general-purpose\" || agentType === \"plan\") {\n    if (requested === \"opus\") return \"opus\";\n    if (requested === \"sonnet\") return \"sonnet\";\n    return \"sonnet\"; // default to sonnet if no model specified\n  }\n\n  // Unknown/custom agent types — default to haiku for safety\n  if (!requested) return \"haiku\";\n  return requested === \"opus\" ? \"sonnet\" : requested === \"sonnet\" ? \"sonnet\" : \"haiku\";\n}\n\n// ============================================================================\n// AGENT LOOP CONFIG RESOLVER — single source of truth for all call paths\n// ============================================================================\n\nexport type CallPath = \"sse\" | \"workflow\" | \"channel\";\n\n/**\n * EMERGENCY FALLBACK DEFAULTS — used ONLY when ai_agent_config DB is unreachable.\n *\n * The SINGLE SOURCE OF TRUTH is the ai_agent_config table (Supabase), specifically\n * the row for Whale Code (id: 72d7aaa8-2e8b-48a0-a38d-f332f69600bb).\n * All behavioral knobs are stored in `context_config` JSONB.\n *\n * These values MUST mirror what's in the DB. If you change a value, update the DB\n * first (via Supabase dashboard or migration), then mirror it here.\n *\n * DB → resolveAgentLoopConfig() → code reads resolved values.\n * AGENT_DEFAULTS → code reads ONLY if DB fetch returns null.\n */\nexport const AGENT_DEFAULTS = {\n  // Mirrors ai_agent_config.max_tool_calls / temperature\n  maxTurns: 0,  // 0 = no limit (agent self-regulates via end_turn, Claude Code parity)\n  temperature: 1.0,\n  // Mirrors ai_agent_config.context_config JSONB fields\n  maxConcurrentTools: 7,\n  enableDelegation: true,\n  maxDurationMs: 900_000,\n  maxDurationMsWorkflow: 120_000,\n  enableModelRouting: true,\n  subagentMaxTokens: 32000,\n  subagentMaxTurns: 0,  // 0 = no limit (agent self-regulates via end_turn, Claude Code parity)\n  subagentTemperature: 1.0,\n  subagentMaxRetries: 2,  // 1 retry (2 total attempts) — proxy already handles auth refresh, avoid double backoff\n  maxContinuations: 10,\n  subagentMaxContinuations: 5,\n  maxMessageChars: 100_000,\n  maxHistoryChars: 400_000,\n  maxToolResultChars: 2048,\n  compactionTriggerTokens: 167_000,\n  compactionTotalBudget: 2_000_000,\n  sessionCostBudgetUsd: 25.00,\n  // Team / teammate behavioral defaults\n  teammateMaxTotalTurns: 0,  // 0 = no limit (teammate self-regulates, Claude Code parity)\n  teamTimeoutMs: 600_000,       // 10 min global safety cap — prevents runaway team runs (DB overridable)\n  workerStallMs: 90_000,        // 90s no-message stall detection (API timeout is 90s, so 90s silence = truly stalled)\n  teamReviewMaxTokens: 1024,    // Max tokens for team review synthesis\n  // Infrastructure timeouts for teammates (DB overridable, not hardcoded)\n  apiTimeoutMs: 90_000,         // 90s timeout on proxy/API fetch calls\n  toolTimeoutMs: 60_000,        // 60s timeout on individual tool execution\n  // Per-tool-result truncation cap (different from maxToolResultChars which is for preCompact)\n  toolResultTruncateChars: 30_000,  // Match SAFETY_MAX_CHARS from tool-dispatch.ts — 500K was blowing context windows\n  // Loop detector thresholds (DB overridable via context_config)\n  loopIdenticalCallLimit: 4,\n  loopConsecutiveErrorLimit: 3,\n  loopTurnErrorLimit: 5,\n  loopWindow: 20,\n  loopSessionToolErrorLimit: 10,\n  loopConsecutiveFailedTurnLimit: 3,\n  loopFileReadLimit: 3,\n  loopBatchErrorLimit: 3,  // Max errors from single parallel batch before abort\n} as const;\n\n/** Context config shape from ai_agent_config.context_config JSONB */\nexport interface AgentContextConfig {\n  includeLocations?: boolean;\n  locationIds?: string[];\n  includeCustomers?: boolean;\n  customerSegments?: string[];\n  max_history_chars?: number;\n  max_tool_result_chars?: number;\n  max_message_chars?: number;\n  compaction_trigger_tokens?: number;\n  compaction_total_budget?: number;\n  clear_thinking_keep?: number;\n  clear_tool_uses_trigger?: number;\n  clear_tool_uses_keep?: number;\n  session_cost_budget_usd?: number;\n  max_concurrent_tools?: number;\n  enable_delegation?: boolean;\n  max_duration_ms?: number;\n  enable_model_routing?: boolean;\n  subagent_max_tokens?: number;\n  subagent_max_turns?: number;\n  subagent_temperature?: number;\n  subagent_max_retries?: number;\n  max_continuations?: number;\n  subagent_max_continuations?: number;\n  // Team / teammate\n  teammate_max_total_turns?: number;\n  team_timeout_ms?: number;\n  worker_stall_ms?: number;\n  team_review_max_tokens?: number;\n  // Infrastructure timeouts for teammates\n  api_timeout_ms?: number;\n  tool_timeout_ms?: number;\n  // Per-tool-result truncation cap\n  tool_result_truncate_chars?: number;\n  // Loop detector thresholds\n  loop_identical_call_limit?: number;\n  loop_consecutive_error_limit?: number;\n  loop_turn_error_limit?: number;\n  loop_window?: number;\n  loop_session_tool_error_limit?: number;\n  loop_consecutive_failed_turn_limit?: number;\n  loop_file_read_limit?: number;\n  loop_batch_error_limit?: number;\n}\n\nexport interface ResolvedAgentLoopConfig {\n  maxTurns: number;\n  temperature: number;\n  maxTokens: number;\n  maxConcurrentTools: number;\n  enableDelegation: boolean;\n  maxDurationMs: number;\n  enableModelRouting: boolean;\n  maxMessageChars: number;\n  maxHistoryChars: number;\n  contextOverrides: ContextManagementOverrides;\n  subagentMaxTokens: number;\n  subagentMaxTurns: number;\n  subagentTemperature: number;\n  maxContinuations: number;\n  subagentMaxContinuations: number;\n  subagentMaxRetries: number;\n  maxToolResultChars: number;\n  // Team / teammate\n  teammateMaxTotalTurns: number;\n  teamTimeoutMs: number;\n  workerStallMs: number;\n  teamReviewMaxTokens: number;\n  // Infrastructure timeouts for teammates\n  apiTimeoutMs: number;\n  toolTimeoutMs: number;\n  // Per-tool-result truncation cap\n  toolResultTruncateChars: number;\n  // Loop detector thresholds\n  loopIdenticalCallLimit: number;\n  loopConsecutiveErrorLimit: number;\n  loopTurnErrorLimit: number;\n  loopWindow: number;\n  loopSessionToolErrorLimit: number;\n  loopConsecutiveFailedTurnLimit: number;\n  loopFileReadLimit: number;\n  loopBatchErrorLimit: number;\n  /** Which fields fell back to AGENT_DEFAULTS (transparency for logging) */\n  defaultsUsed: string[];\n}\n\n/**\n * Resolve all agent loop behavioral knobs from DB config.\n * All 3 call paths MUST use this — structurally prevents hardcoded constants.\n *\n * @param agent - Agent config (DB row or subset)\n * @param callPath - Which call path is invoking (\"sse\" | \"workflow\" | \"channel\")\n * @param workflowMaxTurns - Optional cap from workflow step config (workflow path only)\n */\nexport function resolveAgentLoopConfig(\n  agent: {\n    max_tool_calls: number;\n    temperature: number;\n    max_tokens: number;\n    model: string;\n    context_config: AgentContextConfig | null;\n  },\n  callPath: CallPath,\n  workflowMaxTurns?: number,\n): ResolvedAgentLoopConfig {\n  const cc = agent.context_config;\n  const defaultsUsed: string[] = [];\n\n  function resolve<T>(dbValue: T | undefined | null, defaultValue: T, name: string): T {\n    if (dbValue != null) return dbValue;\n    defaultsUsed.push(name);\n    return defaultValue;\n  }\n\n  // Core agent behavior\n  const agentMaxTurns = agent.max_tool_calls || AGENT_DEFAULTS.maxTurns;\n  if (!agent.max_tool_calls) defaultsUsed.push(\"maxTurns\");\n  const temperature = agent.temperature ?? AGENT_DEFAULTS.temperature;\n  if (agent.temperature == null) defaultsUsed.push(\"temperature\");\n  const maxTokens = getMaxOutputTokens(agent.model || \"claude-sonnet-4-6\", agent.max_tokens);\n  if (!agent.max_tokens) defaultsUsed.push(\"maxTokens\");\n\n  // Call-path-specific duration defaults\n  const durationDefault = callPath === \"sse\"\n    ? AGENT_DEFAULTS.maxDurationMs\n    : AGENT_DEFAULTS.maxDurationMsWorkflow;\n\n  // Call-path-specific turn caps (0 = no limit, Claude Code parity)\n  let maxTurns = agentMaxTurns;\n  if (maxTurns > 0) {\n    if (callPath === \"channel\") maxTurns = Math.min(agentMaxTurns, 15);\n    if (callPath === \"workflow\" && workflowMaxTurns != null) {\n      maxTurns = Math.min(agentMaxTurns, workflowMaxTurns);\n    }\n  }\n\n  return {\n    maxTurns,\n    temperature,\n    maxTokens,\n    maxConcurrentTools: resolve(cc?.max_concurrent_tools, AGENT_DEFAULTS.maxConcurrentTools, \"maxConcurrentTools\"),\n    enableDelegation: resolve(cc?.enable_delegation, AGENT_DEFAULTS.enableDelegation, \"enableDelegation\"),\n    maxDurationMs: resolve(cc?.max_duration_ms, durationDefault, \"maxDurationMs\"),\n    enableModelRouting: resolve(cc?.enable_model_routing, AGENT_DEFAULTS.enableModelRouting, \"enableModelRouting\"),\n    maxMessageChars: resolve(cc?.max_message_chars, AGENT_DEFAULTS.maxMessageChars, \"maxMessageChars\"),\n    maxHistoryChars: resolve(cc?.max_history_chars, AGENT_DEFAULTS.maxHistoryChars, \"maxHistoryChars\"),\n    contextOverrides: {\n      compaction_trigger_tokens: cc?.compaction_trigger_tokens ?? undefined,\n      compaction_total_budget: cc?.compaction_total_budget ?? undefined,\n      clear_thinking_keep: cc?.clear_thinking_keep ?? undefined,\n      clear_tool_uses_trigger: cc?.clear_tool_uses_trigger ?? undefined,\n      clear_tool_uses_keep: cc?.clear_tool_uses_keep ?? undefined,\n      session_cost_budget_usd: cc?.session_cost_budget_usd ?? undefined,\n    },\n    subagentMaxTokens: resolve(cc?.subagent_max_tokens, AGENT_DEFAULTS.subagentMaxTokens, \"subagentMaxTokens\"),\n    subagentMaxTurns: resolve(cc?.subagent_max_turns, AGENT_DEFAULTS.subagentMaxTurns, \"subagentMaxTurns\"),\n    subagentTemperature: resolve(cc?.subagent_temperature, AGENT_DEFAULTS.subagentTemperature, \"subagentTemperature\"),\n    maxContinuations: resolve(cc?.max_continuations, AGENT_DEFAULTS.maxContinuations, \"maxContinuations\"),\n    subagentMaxContinuations: resolve(cc?.subagent_max_continuations, AGENT_DEFAULTS.subagentMaxContinuations, \"subagentMaxContinuations\"),\n    subagentMaxRetries: resolve(cc?.subagent_max_retries, AGENT_DEFAULTS.subagentMaxRetries, \"subagentMaxRetries\"),\n    maxToolResultChars: resolve(cc?.max_tool_result_chars, AGENT_DEFAULTS.maxToolResultChars, \"maxToolResultChars\"),\n    teammateMaxTotalTurns: resolve(cc?.teammate_max_total_turns, AGENT_DEFAULTS.teammateMaxTotalTurns, \"teammateMaxTotalTurns\"),\n    teamTimeoutMs: resolve(cc?.team_timeout_ms, AGENT_DEFAULTS.teamTimeoutMs, \"teamTimeoutMs\"),\n    workerStallMs: resolve(cc?.worker_stall_ms, AGENT_DEFAULTS.workerStallMs, \"workerStallMs\"),\n    teamReviewMaxTokens: resolve(cc?.team_review_max_tokens, AGENT_DEFAULTS.teamReviewMaxTokens, \"teamReviewMaxTokens\"),\n    apiTimeoutMs: resolve(cc?.api_timeout_ms, AGENT_DEFAULTS.apiTimeoutMs, \"apiTimeoutMs\"),\n    toolTimeoutMs: resolve(cc?.tool_timeout_ms, AGENT_DEFAULTS.toolTimeoutMs, \"toolTimeoutMs\"),\n    toolResultTruncateChars: resolve(cc?.tool_result_truncate_chars, AGENT_DEFAULTS.toolResultTruncateChars, \"toolResultTruncateChars\"),\n    // Loop detector thresholds\n    loopIdenticalCallLimit: resolve(cc?.loop_identical_call_limit, AGENT_DEFAULTS.loopIdenticalCallLimit, \"loopIdenticalCallLimit\"),\n    loopConsecutiveErrorLimit: resolve(cc?.loop_consecutive_error_limit, AGENT_DEFAULTS.loopConsecutiveErrorLimit, \"loopConsecutiveErrorLimit\"),\n    loopTurnErrorLimit: resolve(cc?.loop_turn_error_limit, AGENT_DEFAULTS.loopTurnErrorLimit, \"loopTurnErrorLimit\"),\n    loopWindow: resolve(cc?.loop_window, AGENT_DEFAULTS.loopWindow, \"loopWindow\"),\n    loopSessionToolErrorLimit: resolve(cc?.loop_session_tool_error_limit, AGENT_DEFAULTS.loopSessionToolErrorLimit, \"loopSessionToolErrorLimit\"),\n    loopConsecutiveFailedTurnLimit: resolve(cc?.loop_consecutive_failed_turn_limit, AGENT_DEFAULTS.loopConsecutiveFailedTurnLimit, \"loopConsecutiveFailedTurnLimit\"),\n    loopFileReadLimit: resolve(cc?.loop_file_read_limit, AGENT_DEFAULTS.loopFileReadLimit, \"loopFileReadLimit\"),\n    loopBatchErrorLimit: resolve(cc?.loop_batch_error_limit, AGENT_DEFAULTS.loopBatchErrorLimit, \"loopBatchErrorLimit\"),\n    defaultsUsed,\n  };\n}\n\nexport function sanitizeError(err: unknown): string {\n  const msg = String(err);\n  return msg\n    .replace(/sk-[a-zA-Z0-9_-]+/g, \"sk-***\")\n    .replace(/AIzaSy[a-zA-Z0-9_-]+/g, \"AIzaSy***\")\n    .replace(/AKIA[A-Z0-9]{16}/g, \"AKIA***\")\n    .replace(/key[=:]\\s*[\"']?[a-zA-Z0-9_-]{20,}[\"']?/gi, \"key=***\")\n    .replace(/password[=:]\\s*[\"']?[^\\s\"']+[\"']?/gi, \"password=***\")\n    .replace(/\\n\\s+at\\s+.*/g, \"\")\n    .substring(0, 500);\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/shared/agent-loop-base.d.ts

@@ -0,0 +1,130 @@
+/**
+ * AgentLoopBase — Template Method base class for all agent loops.
+ *
+ * Owns the turn iteration skeleton. Subclasses implement the abstract methods
+ * to customize API calling, tool routing, abort checking, and lifecycle hooks.
+ *
+ * Shared concrete logic:
+ * - Turn loop with maxTurns enforcement
+ * - Cost budget checking and warnings
+ * - Compaction handling (native + circuit breaker)
+ * - max_tokens continuation injection
+ * - Token/cost accumulation
+ * - Tool dispatch orchestration
+ *
+ * Subclasses:
+ * - CLIAgentLoop (src/cli/services/cli-agent-loop.ts)
+ * - ServerAgentLoop (src/server/lib/server-agent-loop-v2.ts)
+ * - SubagentLoop (src/cli/services/subagent-loop-v2.ts)
+ */
+import { LoopDetector } from "./agent-core.js";
+import type { LoopDetectorConfig } from "./agent-core-types.js";
+import type { CompactableMessage } from "./compaction.js";
+import { type ToolExecutor, type ToolDispatchOptions } from "./tool-dispatch.js";
+import type { ToolUseBlock, ToolResultMessage } from "./types.js";
+export interface AgentLoopConfig {
+    model: string;
+    systemPrompt: string;
+    messages: CompactableMessage[];
+    maxTurns: number;
+    maxCostUsd?: number;
+    maxConcurrentTools?: number;
+    maxToolResultChars?: number;
+    maxContinuations?: number;
+    loopDetectorConfig?: Partial<LoopDetectorConfig>;
+    batchErrorLimit?: number;
+}
+export interface AgentLoopEvents {
+    onText?: (text: string) => void;
+    onToolStart?: (name: string, input: Record<string, unknown>) => void;
+    onToolResult?: (name: string, success: boolean, output: string, durationMs: number) => void;
+    onCostWarning?: (pct: number, costUsd: number, budgetUsd: number) => void;
+}
+export interface TurnResult {
+    text: string;
+    toolUseBlocks: ToolUseBlock[];
+    thinkingBlocks?: Array<{
+        type: "thinking";
+        thinking: string;
+        signature: string;
+    }>;
+    compactionContent?: string | null;
+    stopReason: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheRead?: number;
+        cacheCreation?: number;
+        thinkingTokens?: number;
+    };
+}
+export interface AgentLoopResult {
+    finalText: string;
+    turnCount: number;
+    tokens: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheCreation: number;
+    };
+    costUsd: number;
+    toolsUsed: string[];
+    toolCallCount: number;
+    stopReason: string;
+    loopDetectorStats?: {
+        totalErrors: number;
+        failedStrategies: number;
+        consecutiveFailedTurns: number;
+    };
+}
+export declare abstract class AgentLoopBase {
+    protected config: AgentLoopConfig;
+    protected events: AgentLoopEvents;
+    protected loopDetector: LoopDetector;
+    protected messages: CompactableMessage[];
+    protected turnCount: number;
+    protected totalInputTokens: number;
+    protected totalOutputTokens: number;
+    protected totalCacheRead: number;
+    protected totalCacheCreation: number;
+    protected totalThinkingTokens: number;
+    protected sessionCostUsd: number;
+    protected toolsUsed: Set<string>;
+    protected toolCallCount: number;
+    protected lastStopReason: string;
+    protected lastText: string;
+    protected compactionCount: number;
+    protected consecutiveCompactions: number;
+    protected continuationCount: number;
+    protected costWarningsEmitted: Set<number>;
+    constructor(config: AgentLoopConfig, events?: AgentLoopEvents);
+    run(): Promise<AgentLoopResult>;
+    protected accumulateTokens(turn: TurnResult): void;
+    protected getToolDispatchOptions(): ToolDispatchOptions;
+    protected buildAssistantContent(turn: TurnResult): unknown;
+    protected buildResult(): AgentLoopResult;
+    /** Execute a single API turn and return normalized result. */
+    protected abstract executeTurn(messages: CompactableMessage[], iteration: number): Promise<TurnResult>;
+    /** Create a tool executor appropriate for this loop type. */
+    protected abstract createToolExecutor(): ToolExecutor;
+    /** Check if the loop should abort (signal, disconnect, timeout). */
+    protected checkAbort(): boolean;
+    /** Called when abort is detected. */
+    protected onAborted(): void;
+    /** Pre-compact messages before each turn. Subagent can be more aggressive. */
+    protected preCompactMessages(msgs: CompactableMessage[]): CompactableMessage[];
+    /** Called after each completed turn. Subclass: telemetry, usage events. */
+    protected onTurnComplete(_turn: TurnResult, _iteration: number): Promise<void>;
+    /** Called after tool results are ready. CLI: shell summarization. */
+    protected onToolResultsReady(_toolBlocks: ToolUseBlock[], _results: ToolResultMessage[]): Promise<void>;
+    /** Called after messages are updated. Server: checkpointing, persistence. */
+    protected onMessagesUpdated(_reason: "compaction" | "continuation" | "tool_results"): Promise<void>;
+    /** Handle a turn-level error. Return true if the loop should continue, false to break. */
+    protected handleTurnError(_err: unknown, _iteration: number): Promise<boolean>;
+    /**
+     * Dispatch tools and append results to messages. Returns true to continue loop, false to break.
+     * Default implementation uses shared dispatchTools(). Subclass can override entirely for
+     * custom dispatch (e.g. SubagentLoop uses executeToolBlocks instead).
+     */
+    protected dispatchToolsAndAppend(turnResult: TurnResult): Promise<boolean>;
+}