@agent-native/core 0.122.4 → 0.123.1

package/dist/agent/engine/anthropic-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-engine.js","sourceRoot":"","sources":["../../../src/agent/engine/anthropic-engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AnthropicEngine — wraps @anthropic-ai/sdk for use as an AgentEngine.\n *\n * This is the default, best-in-class engine. It supports all Anthropic-native\n * features: extended thinking, prompt caching, vision, computer use, and\n * parallel tool calls.\n *\n * All providerOptions.anthropic fields are forwarded directly to the SDK.\n */\n\nimport {\n  clearProviderCredentialAuthFailure,\n  readDeployCredentialEnv,\n  recordProviderCredentialAuthFailure,\n} from \"../../server/credential-provider.js\";\nimport {\n  anthropicManualThinkingBudget,\n  normalizeReasoningEffortForModel,\n  supportsClaudeAdaptiveThinking,\n} from \"../../shared/reasoning-effort.js\";\nimport { ANTHROPIC_MODEL_CONFIG } from \"../model-config.js\";\nimport {\n  LLM_MISSING_CREDENTIALS_ERROR_CODE,\n  LLM_MISSING_CREDENTIALS_MESSAGE,\n} from \"./credential-errors.js\";\nimport {\n  createFirstEventAbortController,\n  FIRST_STREAM_EVENT_TIMEOUT_MS,\n} from \"./first-event-timeout.js\";\nimport {\n  clampThinkingBudgetTokens,\n  resolveMaxOutputTokensForEngine,\n} from \"./output-tokens.js\";\nimport {\n  engineToolsToAnthropic,\n  engineMessagesToAnthropic,\n  anthropicContentToEngine,\n  anthropicChunkToEngineEvents,\n  createAnthropicChunkStreamState,\n} from \"./translate-anthropic.js\";\nimport type {\n  AgentEngine,\n  EngineCapabilities,\n  EngineStreamOptions,\n  EngineEvent,\n} from \"./types.js\";\n\nexport const ANTHROPIC_CAPABILITIES: EngineCapabilities = {\n  thinking: true,\n  promptCaching: true,\n  vision: true,\n  computerUse: true,\n  parallelToolCalls: true,\n};\n\nexport const ANTHROPIC_SUPPORTED_MODELS =\n  ANTHROPIC_MODEL_CONFIG.supportedModels;\nexport const ANTHROPIC_DEFAULT_MODEL = ANTHROPIC_MODEL_CONFIG.defaultModel;\n\nclass AnthropicEngine implements AgentEngine {\n  readonly name = \"anthropic\";\n  readonly label = \"Claude (Anthropic SDK)\";\n  readonly defaultModel = ANTHROPIC_DEFAULT_MODEL;\n  readonly supportedModels = ANTHROPIC_SUPPORTED_MODELS;\n  readonly capabilities = ANTHROPIC_CAPABILITIES;\n\n  private readonly apiKey: string;\n\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  async *stream(opts: EngineStreamOptions): AsyncIterable<EngineEvent> {\n    const Anthropic = (await import(\"@anthropic-ai/sdk\")).default;\n    const client = new Anthropic({ apiKey: this.apiKey });\n\n    const tools = engineToolsToAnthropic(opts.tools);\n    const messages = engineMessagesToAnthropic(opts.messages);\n    const anthropicOpts = opts.providerOptions?.anthropic;\n\n    // Resolved once so both max_tokens and the thinking-budget headroom\n    // clamp below agree on the same ceiling.\n    const resolvedMaxOutputTokens = resolveMaxOutputTokensForEngine(\n      this.name,\n      opts.maxOutputTokens,\n      opts.model,\n    );\n\n    // Build extra body params for Anthropic-native features\n    const extra: Record<string, unknown> = {};\n    if (anthropicOpts?.thinking) {\n      extra.thinking = {\n        type: anthropicOpts.thinking.type,\n        // Only the \"enabled\" config carries a numeric budget_tokens; clamp it\n        // so thinking can't consume the entire max_tokens budget and leave\n        // zero room for the actual response (\"adaptive\" thinking has no\n        // budget_tokens field at all, so it passes through unclamped).\n        budget_tokens:\n          anthropicOpts.thinking.type === \"enabled\" &&\n          typeof anthropicOpts.thinking.budgetTokens === \"number\"\n            ? clampThinkingBudgetTokens(\n                anthropicOpts.thinking.budgetTokens,\n                resolvedMaxOutputTokens,\n              )\n            : anthropicOpts.thinking.budgetTokens,\n      };\n    }\n    if (anthropicOpts?.topK !== undefined) {\n      extra.top_k = anthropicOpts.topK;\n    }\n    const reasoningEffort = normalizeReasoningEffortForModel(\n      opts.model,\n      opts.reasoningEffort,\n    );\n    if (reasoningEffort && !extra.thinking) {\n      if (supportsClaudeAdaptiveThinking(opts.model)) {\n        extra.thinking = { type: \"adaptive\" };\n        extra.output_config = { effort: reasoningEffort };\n      } else {\n        const budgetTokens = clampThinkingBudgetTokens(\n          anthropicManualThinkingBudget(reasoningEffort),\n          resolvedMaxOutputTokens,\n        );\n        if (budgetTokens !== undefined) {\n          extra.thinking = { type: \"enabled\", budget_tokens: budgetTokens };\n        }\n      }\n    }\n\n    // Apply prompt caching to the system prompt and tools by default.\n    // Cache is pure upside: identical prefixes on subsequent turns get ~90%\n    // off input cost and much faster time-to-first-token. If the prefix\n    // changes turn-to-turn, it's a no-op. Templates can opt out by setting\n    // providerOptions.anthropic.cacheControl = false.\n    const cacheEnabled = anthropicOpts?.cacheControl !== false;\n    const systemBlocks: any[] = [{ type: \"text\", text: opts.systemPrompt }];\n    if (cacheEnabled) {\n      systemBlocks[0].cache_control = { type: \"ephemeral\" };\n    }\n\n    // Apply cache_control to the last tool definition when caching is enabled.\n    // Anthropic caches the prefix up to and including the last cached block.\n    let cachedTools = tools;\n    if (cacheEnabled && tools.length > 0) {\n      cachedTools = [...tools];\n      const last = { ...cachedTools[cachedTools.length - 1] } as any;\n      last.cache_control = { type: \"ephemeral\" };\n      cachedTools[cachedTools.length - 1] = last;\n    }\n\n    // Apply a moving cache breakpoint on the last user message's last content\n    // block so the entire conversation prefix (system + tools + growing\n    // history) is cached turn-over-turn as the thread lengthens. Mirrors the\n    // Builder gateway engine's identical handling in builder-engine.ts.\n    let cachedMessages = messages;\n    if (cacheEnabled && messages.length > 0) {\n      let lastUserIdx = -1;\n      for (let i = messages.length - 1; i >= 0; i -= 1) {\n        if ((messages[i] as any).role === \"user\") {\n          lastUserIdx = i;\n          break;\n        }\n      }\n      if (lastUserIdx >= 0) {\n        cachedMessages = [...messages];\n        const lastMsg = { ...cachedMessages[lastUserIdx] } as any;\n        if (Array.isArray(lastMsg.content) && lastMsg.content.length > 0) {\n          const content = [...lastMsg.content];\n          const lastBlock = { ...content[content.length - 1] } as any;\n          lastBlock.cache_control = { type: \"ephemeral\" };\n          content[content.length - 1] = lastBlock;\n          lastMsg.content = content;\n          cachedMessages[lastUserIdx] = lastMsg;\n        }\n      }\n    }\n\n    const requestParams: any = {\n      model: opts.model,\n      max_tokens: resolvedMaxOutputTokens,\n      system: systemBlocks,\n      tools: cachedTools.length > 0 ? cachedTools : undefined,\n      messages: cachedMessages,\n      ...(opts.temperature !== undefined\n        ? { temperature: opts.temperature }\n        : {}),\n      ...extra,\n    };\n\n    // Remove undefined tools to avoid Anthropic API validation errors\n    if (!requestParams.tools) delete requestParams.tools;\n\n    const firstEventAbort = createFirstEventAbortController(opts.abortSignal);\n    const apiStream = client.messages.stream(requestParams, {\n      signal: firstEventAbort.signal,\n    });\n\n    // Per-stream state lets the translator carry each tool-call's id/name from\n    // its `content_block_start` onto the streamed `input_json_delta` chunks, so\n    // long tool-input generation emits countable `tool-input-start` /\n    // `tool-input-delta` progress events (mirroring the Builder engine).\n    const chunkState = createAnthropicChunkStreamState();\n\n    try {\n      for await (const chunk of apiStream) {\n        // The SDK's SSE parsing already drops `ping` keepalives before they\n        // reach this loop, so any chunk here is real provider progress.\n        firstEventAbort.markFirstEvent();\n        const events = anthropicChunkToEngineEvents(chunk, chunkState);\n        for (const event of events) {\n          yield event;\n        }\n      }\n\n      const finalMessage = await apiStream.finalMessage();\n      const assistantContent = anthropicContentToEngine(finalMessage.content);\n\n      // Emit usage\n      if (finalMessage.usage) {\n        yield {\n          type: \"usage\",\n          inputTokens: finalMessage.usage.input_tokens ?? 0,\n          outputTokens: finalMessage.usage.output_tokens ?? 0,\n          cacheReadTokens:\n            (finalMessage.usage as any).cache_read_input_tokens ?? 0,\n          cacheWriteTokens:\n            (finalMessage.usage as any).cache_creation_input_tokens ?? 0,\n        };\n      }\n\n      yield { type: \"assistant-content\", parts: assistantContent };\n      await clearProviderCredentialAuthFailure({\n        key: \"ANTHROPIC_API_KEY\",\n        value: this.apiKey,\n      });\n\n      // Emit stop reason\n      const stopReason = finalMessage.stop_reason ?? \"end_turn\";\n      yield {\n        type: \"stop\",\n        reason:\n          stopReason === \"tool_use\"\n            ? \"tool_use\"\n            : stopReason === \"max_tokens\"\n              ? \"max_tokens\"\n              : \"end_turn\",\n      };\n    } catch (err: any) {\n      const timedOut = firstEventAbort.didTimeout();\n      const statusCode: number | undefined =\n        typeof err?.status === \"number\"\n          ? err.status\n          : typeof err?.statusCode === \"number\"\n            ? err.statusCode\n            : undefined;\n      // A first-event abort surfaces from the SDK as a generic\n      // APIUserAbortError (\"Request was aborted.\") — replace it with a\n      // message that actually explains what happened.\n      const errorMessage = timedOut\n        ? `Model request produced no stream events within ${FIRST_STREAM_EVENT_TIMEOUT_MS / 1000}s; the connection appears wedged.`\n        : (err?.message ?? String(err));\n      // Anthropic SDK APIConnectionError defaults to \"Connection error.\" with\n      // no HTTP status. Tag it so in-run retries and run-level resume treat\n      // the failure as a transient network interruption.\n      const isConnectionError =\n        !timedOut &&\n        statusCode === undefined &&\n        String(errorMessage).trim().toLowerCase() === \"connection error.\";\n      if (statusCode === 401) {\n        await recordProviderCredentialAuthFailure({\n          key: \"ANTHROPIC_API_KEY\",\n          value: this.apiKey,\n          status: statusCode,\n          code: \"http_401\",\n          message: errorMessage,\n        });\n      }\n      yield {\n        type: \"stop\",\n        reason: \"error\",\n        error: errorMessage,\n        // Forward the provider HTTP status for EVERY known status, not just\n        // 401. The Anthropic SDK reports empty-body failures as a bare\n        // \"429 status code (no body)\" message, so without a structured\n        // statusCode/errorCode `isRetryableError` couldn't classify a rate\n        // limit (it matches \"529\"/\"502\" substrings but not \"429\") and the\n        // run failed hard instead of backing off + retrying like the Builder\n        // gateway path does. `http_429`/`http_529` also let the run-level\n        // continuation logic auto-resume a rate-limited turn.\n        ...(statusCode !== undefined\n          ? { errorCode: `http_${statusCode}`, statusCode }\n          : isConnectionError || timedOut\n            ? {\n                errorCode: \"provider_network_error\",\n                providerRetryable: true,\n              }\n            : {}),\n      };\n      throw err;\n    } finally {\n      firstEventAbort.cleanup();\n    }\n  }\n}\n\n/**\n * Create an AnthropicEngine instance.\n * Falls back to the deployment Anthropic key if no key is provided.\n */\nexport function createAnthropicEngine(\n  config: Record<string, unknown> = {},\n): AgentEngine {\n  const allowEnvFallback = config.allowEnvFallback !== false;\n  const apiKey =\n    (config.apiKey as string | undefined) ??\n    (allowEnvFallback ? readDeployCredentialEnv(\"ANTHROPIC_API_KEY\") : \"\") ??\n    \"\";\n  if (!apiKey) {\n    // Return a \"missing key\" engine that immediately errors\n    return {\n      name: \"anthropic\",\n      label: \"Claude (Anthropic SDK)\",\n      defaultModel: ANTHROPIC_DEFAULT_MODEL,\n      supportedModels: ANTHROPIC_SUPPORTED_MODELS,\n      capabilities: ANTHROPIC_CAPABILITIES,\n      async *stream() {\n        yield {\n          type: \"stop\" as const,\n          reason: \"error\" as const,\n          error: LLM_MISSING_CREDENTIALS_MESSAGE,\n          errorCode: LLM_MISSING_CREDENTIALS_ERROR_CODE,\n        };\n      },\n    };\n  }\n  return new AnthropicEngine(apiKey);\n}\n"]}
+{"version":3,"file":"anthropic-engine.js","sourceRoot":"","sources":["../../../src/agent/engine/anthropic-engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AnthropicEngine — wraps @anthropic-ai/sdk for use as an AgentEngine.\n *\n * This is the default, best-in-class engine. It supports all Anthropic-native\n * features: extended thinking, prompt caching, vision, computer use, and\n * parallel tool calls.\n *\n * All providerOptions.anthropic fields are forwarded directly to the SDK.\n */\n\nimport {\n  clearProviderCredentialAuthFailure,\n  readDeployCredentialEnv,\n  recordProviderCredentialAuthFailure,\n} from \"../../server/credential-provider.js\";\nimport {\n  anthropicManualThinkingBudget,\n  normalizeReasoningEffortForModel,\n  supportsClaudeAdaptiveThinking,\n} from \"../../shared/reasoning-effort.js\";\nimport { ANTHROPIC_MODEL_CONFIG } from \"../model-config.js\";\nimport {\n  LLM_MISSING_CREDENTIALS_ERROR_CODE,\n  LLM_MISSING_CREDENTIALS_MESSAGE,\n} from \"./credential-errors.js\";\nimport { describeErrorWithCauses } from \"./error-detail.js\";\nimport {\n  createFirstEventAbortController,\n  FIRST_STREAM_EVENT_TIMEOUT_MS,\n} from \"./first-event-timeout.js\";\nimport {\n  clampThinkingBudgetTokens,\n  resolveMaxOutputTokensForEngine,\n} from \"./output-tokens.js\";\nimport {\n  splitSystemPromptForCache,\n  stablePrefixCacheControl,\n} from \"./prompt-cache.js\";\nimport {\n  engineToolsToAnthropic,\n  engineMessagesToAnthropic,\n  anthropicContentToEngine,\n  anthropicChunkToEngineEvents,\n  createAnthropicChunkStreamState,\n  createStreamedToolInputState,\n  finalizeStreamedToolInputs,\n  observeStreamedToolInput,\n} from \"./translate-anthropic.js\";\nimport type {\n  AgentEngine,\n  EngineCapabilities,\n  EngineStreamOptions,\n  EngineEvent,\n} from \"./types.js\";\n\nexport const ANTHROPIC_CAPABILITIES: EngineCapabilities = {\n  thinking: true,\n  promptCaching: true,\n  vision: true,\n  computerUse: true,\n  parallelToolCalls: true,\n};\n\nexport const ANTHROPIC_SUPPORTED_MODELS =\n  ANTHROPIC_MODEL_CONFIG.supportedModels;\nexport const ANTHROPIC_DEFAULT_MODEL = ANTHROPIC_MODEL_CONFIG.defaultModel;\n\nclass AnthropicEngine implements AgentEngine {\n  readonly name = \"anthropic\";\n  readonly label = \"Claude (Anthropic SDK)\";\n  readonly defaultModel = ANTHROPIC_DEFAULT_MODEL;\n  readonly supportedModels = ANTHROPIC_SUPPORTED_MODELS;\n  readonly capabilities = ANTHROPIC_CAPABILITIES;\n\n  private readonly apiKey: string;\n\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  async *stream(opts: EngineStreamOptions): AsyncIterable<EngineEvent> {\n    const Anthropic = (await import(\"@anthropic-ai/sdk\")).default;\n    // Explicit: the agent loop already retries a failed model call up to\n    // MAX_RETRIES times with backoff. Leaving the SDK on its default (2)\n    // multiplies the two layers into ~12 HTTP requests per failed run.\n    const client = new Anthropic({ apiKey: this.apiKey, maxRetries: 1 });\n\n    const tools = engineToolsToAnthropic(opts.tools);\n    const messages = engineMessagesToAnthropic(opts.messages);\n    const anthropicOpts = opts.providerOptions?.anthropic;\n\n    // Resolved once so both max_tokens and the thinking-budget headroom\n    // clamp below agree on the same ceiling.\n    const resolvedMaxOutputTokens = resolveMaxOutputTokensForEngine(\n      this.name,\n      opts.maxOutputTokens,\n      opts.model,\n    );\n\n    // Build extra body params for Anthropic-native features\n    const extra: Record<string, unknown> = {};\n    if (anthropicOpts?.thinking) {\n      extra.thinking = {\n        type: anthropicOpts.thinking.type,\n        // Only the \"enabled\" config carries a numeric budget_tokens; clamp it\n        // so thinking can't consume the entire max_tokens budget and leave\n        // zero room for the actual response (\"adaptive\" thinking has no\n        // budget_tokens field at all, so it passes through unclamped).\n        budget_tokens:\n          anthropicOpts.thinking.type === \"enabled\" &&\n          typeof anthropicOpts.thinking.budgetTokens === \"number\"\n            ? clampThinkingBudgetTokens(\n                anthropicOpts.thinking.budgetTokens,\n                resolvedMaxOutputTokens,\n              )\n            : anthropicOpts.thinking.budgetTokens,\n      };\n    }\n    if (anthropicOpts?.topK !== undefined) {\n      extra.top_k = anthropicOpts.topK;\n    }\n    const reasoningEffort = normalizeReasoningEffortForModel(\n      opts.model,\n      opts.reasoningEffort,\n    );\n    if (reasoningEffort && !extra.thinking) {\n      if (supportsClaudeAdaptiveThinking(opts.model)) {\n        extra.thinking = { type: \"adaptive\" };\n        extra.output_config = { effort: reasoningEffort };\n      } else {\n        const budgetTokens = clampThinkingBudgetTokens(\n          anthropicManualThinkingBudget(reasoningEffort),\n          resolvedMaxOutputTokens,\n        );\n        if (budgetTokens !== undefined) {\n          extra.thinking = { type: \"enabled\", budget_tokens: budgetTokens };\n        }\n      }\n    }\n\n    // Apply prompt caching to the system prompt and tools by default.\n    // Cache is pure upside: identical prefixes on subsequent turns get ~90%\n    // off input cost and much faster time-to-first-token. If the prefix\n    // changes turn-to-turn, it's a no-op. Templates can opt out by setting\n    // providerOptions.anthropic.cacheControl = false.\n    const cacheEnabled = anthropicOpts?.cacheControl !== false;\n    // Two system blocks: the breakpoint sits on the stable prefix so a change\n    // in the volatile tail (resources the agent itself creates mid-turn, app\n    // extras, model overlay, runtime context) no longer invalidates system +\n    // tools. Callers that emit no sentinel get one block, as before.\n    const { stable, volatile } = splitSystemPromptForCache(opts.systemPrompt);\n    const systemBlocks: any[] = [{ type: \"text\", text: stable }];\n    if (cacheEnabled) {\n      systemBlocks[0].cache_control = stablePrefixCacheControl();\n    }\n    if (volatile) systemBlocks.push({ type: \"text\", text: volatile });\n\n    // Apply cache_control to the last tool definition when caching is enabled.\n    // Anthropic caches the prefix up to and including the last cached block.\n    let cachedTools = tools;\n    if (cacheEnabled && tools.length > 0) {\n      cachedTools = [...tools];\n      const last = { ...cachedTools[cachedTools.length - 1] } as any;\n      last.cache_control = stablePrefixCacheControl();\n      cachedTools[cachedTools.length - 1] = last;\n    }\n\n    // Apply a moving cache breakpoint on the last user message's last content\n    // block so the entire conversation prefix (system + tools + growing\n    // history) is cached turn-over-turn as the thread lengthens. Mirrors the\n    // Builder gateway engine's identical handling in builder-engine.ts. This\n    // breakpoint keeps the default 5m TTL: it moves every iteration, so a\n    // longer-lived entry would only pay the higher write premium.\n    let cachedMessages = messages;\n    if (cacheEnabled && messages.length > 0) {\n      let lastUserIdx = -1;\n      for (let i = messages.length - 1; i >= 0; i -= 1) {\n        if ((messages[i] as any).role === \"user\") {\n          lastUserIdx = i;\n          break;\n        }\n      }\n      if (lastUserIdx >= 0) {\n        cachedMessages = [...messages];\n        const lastMsg = { ...cachedMessages[lastUserIdx] } as any;\n        if (Array.isArray(lastMsg.content) && lastMsg.content.length > 0) {\n          const content = [...lastMsg.content];\n          const lastBlock = { ...content[content.length - 1] } as any;\n          lastBlock.cache_control = { type: \"ephemeral\" };\n          content[content.length - 1] = lastBlock;\n          lastMsg.content = content;\n          cachedMessages[lastUserIdx] = lastMsg;\n        }\n      }\n    }\n\n    const requestParams: any = {\n      model: opts.model,\n      max_tokens: resolvedMaxOutputTokens,\n      system: systemBlocks,\n      tools: cachedTools.length > 0 ? cachedTools : undefined,\n      messages: cachedMessages,\n      ...(opts.temperature !== undefined\n        ? { temperature: opts.temperature }\n        : {}),\n      ...extra,\n    };\n\n    // Remove undefined tools to avoid Anthropic API validation errors\n    if (!requestParams.tools) delete requestParams.tools;\n\n    const firstEventAbort = createFirstEventAbortController(opts.abortSignal);\n    const apiStream = client.messages.stream(requestParams, {\n      signal: firstEventAbort.signal,\n    });\n\n    // Per-stream state lets the translator carry each tool-call's id/name from\n    // its `content_block_start` onto the streamed `input_json_delta` chunks, so\n    // long tool-input generation emits countable `tool-input-start` /\n    // `tool-input-delta` progress events (mirroring the Builder engine).\n    const chunkState = createAnthropicChunkStreamState();\n    const toolInputs = createStreamedToolInputState();\n\n    try {\n      for await (const chunk of apiStream) {\n        // The SDK's SSE parsing already drops `ping` keepalives before they\n        // reach this loop, so any chunk here is real provider progress.\n        firstEventAbort.markFirstEvent();\n        const events = anthropicChunkToEngineEvents(chunk, chunkState);\n        for (const event of events) {\n          observeStreamedToolInput(toolInputs, event);\n          yield event;\n        }\n      }\n\n      const finalMessage = await apiStream.finalMessage();\n      const assistantContent = anthropicContentToEngine(finalMessage.content);\n\n      // A tool call the stream announced but the final message never carried\n      // would otherwise vanish, leaving the turn claiming an action it never\n      // ran. Recover it from its deltas, or tell the model in-band.\n      for (const recovered of finalizeStreamedToolInputs(\n        toolInputs,\n        assistantContent.flatMap((part) =>\n          part.type === \"tool-call\" ? [part.id] : [],\n        ),\n      )) {\n        if (recovered.type === \"tool-call\") {\n          assistantContent.push({\n            type: \"tool-call\",\n            id: recovered.id,\n            name: recovered.name,\n            input: recovered.input,\n          });\n        }\n        yield recovered;\n      }\n\n      // Emit usage\n      if (finalMessage.usage) {\n        yield {\n          type: \"usage\",\n          inputTokens: finalMessage.usage.input_tokens ?? 0,\n          outputTokens: finalMessage.usage.output_tokens ?? 0,\n          cacheReadTokens:\n            (finalMessage.usage as any).cache_read_input_tokens ?? 0,\n          cacheWriteTokens:\n            (finalMessage.usage as any).cache_creation_input_tokens ?? 0,\n        };\n      }\n\n      yield { type: \"assistant-content\", parts: assistantContent };\n      await clearProviderCredentialAuthFailure({\n        key: \"ANTHROPIC_API_KEY\",\n        value: this.apiKey,\n      });\n\n      // Emit stop reason\n      const stopReason = finalMessage.stop_reason ?? \"end_turn\";\n      yield {\n        type: \"stop\",\n        reason:\n          stopReason === \"tool_use\"\n            ? \"tool_use\"\n            : stopReason === \"max_tokens\"\n              ? \"max_tokens\"\n              : \"end_turn\",\n      };\n    } catch (err: any) {\n      const timedOut = firstEventAbort.didTimeout();\n      const statusCode: number | undefined =\n        typeof err?.status === \"number\"\n          ? err.status\n          : typeof err?.statusCode === \"number\"\n            ? err.statusCode\n            : undefined;\n      // A first-event abort surfaces from the SDK as a generic\n      // APIUserAbortError (\"Request was aborted.\") — replace it with a\n      // message that actually explains what happened.\n      const rawMessage: string = err?.message ?? String(err);\n      const errorMessage = timedOut\n        ? `Model request produced no stream events within ${FIRST_STREAM_EVENT_TIMEOUT_MS / 1000}s; the connection appears wedged.`\n        : describeErrorWithCauses(err);\n      // Anthropic SDK APIConnectionError defaults to \"Connection error.\" with\n      // no HTTP status. Tag it so in-run retries and run-level resume treat\n      // the failure as a transient network interruption. Classify on the bare\n      // message — the recorded `errorMessage` carries the cause chain.\n      const isConnectionError =\n        !timedOut &&\n        statusCode === undefined &&\n        rawMessage.trim().toLowerCase() === \"connection error.\";\n      if (statusCode === 401) {\n        await recordProviderCredentialAuthFailure({\n          key: \"ANTHROPIC_API_KEY\",\n          value: this.apiKey,\n          status: statusCode,\n          code: \"http_401\",\n          message: errorMessage,\n        });\n      }\n      yield {\n        type: \"stop\",\n        reason: \"error\",\n        error: errorMessage,\n        // Forward the provider HTTP status for EVERY known status, not just\n        // 401. The Anthropic SDK reports empty-body failures as a bare\n        // \"429 status code (no body)\" message, so without a structured\n        // statusCode/errorCode `isRetryableError` couldn't classify a rate\n        // limit (it matches \"529\"/\"502\" substrings but not \"429\") and the\n        // run failed hard instead of backing off + retrying like the Builder\n        // gateway path does. `http_429`/`http_529` also let the run-level\n        // continuation logic auto-resume a rate-limited turn.\n        ...(statusCode !== undefined\n          ? { errorCode: `http_${statusCode}`, statusCode }\n          : isConnectionError || timedOut\n            ? {\n                errorCode: \"provider_network_error\",\n                providerRetryable: true,\n              }\n            : {}),\n      };\n      throw err;\n    } finally {\n      firstEventAbort.cleanup();\n    }\n  }\n}\n\n/**\n * Create an AnthropicEngine instance.\n * Falls back to the deployment Anthropic key if no key is provided.\n */\nexport function createAnthropicEngine(\n  config: Record<string, unknown> = {},\n): AgentEngine {\n  const allowEnvFallback = config.allowEnvFallback !== false;\n  const apiKey =\n    (config.apiKey as string | undefined) ??\n    (allowEnvFallback ? readDeployCredentialEnv(\"ANTHROPIC_API_KEY\") : \"\") ??\n    \"\";\n  if (!apiKey) {\n    // Return a \"missing key\" engine that immediately errors\n    return {\n      name: \"anthropic\",\n      label: \"Claude (Anthropic SDK)\",\n      defaultModel: ANTHROPIC_DEFAULT_MODEL,\n      supportedModels: ANTHROPIC_SUPPORTED_MODELS,\n      capabilities: ANTHROPIC_CAPABILITIES,\n      async *stream() {\n        yield {\n          type: \"stop\" as const,\n          reason: \"error\" as const,\n          error: LLM_MISSING_CREDENTIALS_MESSAGE,\n          errorCode: LLM_MISSING_CREDENTIALS_ERROR_CODE,\n        };\n      },\n    };\n  }\n  return new AnthropicEngine(apiKey);\n}\n"]}

package/dist/agent/engine/builder-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-engine.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/builder-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA2BH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAInB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,oBAAoB,EAAE,kBAMlC,CAAC;AAEF,eAAO,MAAM,wBAAwB,iLAAuC,CAAC;AAiB7E,eAAO,MAAM,qCAAqC,+BACpB,CAAC;AAE/B,eAAO,MAAM,qBAAqB,QAAoC,CAAC;AAuwBvE,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,WAAW,CAEb"}
+{"version":3,"file":"builder-engine.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/builder-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmCH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAInB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,oBAAoB,EAAE,kBAMlC,CAAC;AAEF,eAAO,MAAM,wBAAwB,iLAAuC,CAAC;AAiB7E,eAAO,MAAM,qCAAqC,+BACpB,CAAC;AAE/B,eAAO,MAAM,qBAAqB,QAAoC,CAAC;AAsyBvE,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,WAAW,CAEb"}

package/dist/agent/engine/builder-engine.js

@@ -20,9 +20,11 @@ import { isInBackgroundFunctionRuntime } from "../durable-background.js";
 import { BUILDER_MODEL_CONFIG } from "../model-config.js";
 import { getBuilderGatewayRequestHeaders } from "./builder-gateway-headers.js";
 import { LLM_MISSING_CREDENTIALS_ERROR_CODE, LLM_MISSING_CREDENTIALS_MESSAGE, } from "./credential-errors.js";
+import { describeErrorWithCauses } from "./error-detail.js";
 import { FIRST_STREAM_EVENT_TIMEOUT_MS } from "./first-event-timeout.js";
 import { resolveMaxOutputTokensForEngine } from "./output-tokens.js";
-import { engineMessagesToBuilderGatewayAnthropic, engineToolsToAnthropic, } from "./translate-anthropic.js";
+import { splitSystemPromptForCache, stablePrefixCacheControl, } from "./prompt-cache.js";
+import { createStreamedToolInputState, engineMessagesToBuilderGatewayAnthropic, engineToolsToAnthropic, finalizeStreamedToolInputs, observeStreamedToolInput, } from "./translate-anthropic.js";
 export const BUILDER_CAPABILITIES = {
     thinking: true,
     promptCaching: true,
@@ -124,28 +126,34 @@ class BuilderEngine {
         // across tool-loop iterations at ~90% off input cost).
         // Templates can opt out by setting providerOptions.anthropic.cacheControl=false.
         const cacheEnabled = opts.providerOptions?.anthropic?.cacheControl !== false;
-        // System: wrap in array with cache_control when caching is on.
+        // System: split into a stable block carrying the breakpoint and a volatile
+        // tail (resources, app extras, model overlay, runtime context) without one,
+        // so mid-turn resource churn no longer invalidates system + tools.
+        const { stable, volatile } = splitSystemPromptForCache(opts.systemPrompt ?? "");
         const systemValue = opts.systemPrompt
             ? cacheEnabled
                 ? [
                     {
                         type: "text",
-                        text: opts.systemPrompt,
-                        cache_control: { type: "ephemeral" },
+                        text: stable,
+                        cache_control: stablePrefixCacheControl(),
                     },
+                    ...(volatile ? [{ type: "text", text: volatile }] : []),
                 ]
-                : opts.systemPrompt
+                : stable + volatile
             : undefined;
         // Tools: add cache_control to the last tool definition.
         let cachedTools = tools;
         if (cacheEnabled && tools.length > 0) {
             cachedTools = [...tools];
             const last = { ...cachedTools[cachedTools.length - 1] };
-            last.cache_control = { type: "ephemeral" };
+            last.cache_control = stablePrefixCacheControl();
             cachedTools[cachedTools.length - 1] = last;
         }
         // Messages: add a moving cache breakpoint on the last user message's last
-        // content block so the entire conversation prefix is cached.
+        // content block so the entire conversation prefix is cached. Stays on the
+        // default 5m TTL — it moves every iteration, so a longer-lived entry would
+        // only pay the higher write premium.
         let cachedMessages = messages;
         if (cacheEnabled && messages.length > 0) {
             let lastUserIdx = -1;
@@ -428,6 +436,25 @@ async function* parseJsonlStream(reader, model, captureContext = {}) {
         flushPendingText();
         flushPendingThinking();
     };
+    const toolInputs = createStreamedToolInputState();
+    // The gateway can announce a tool call through `tool-call-delta` frames and
+    // then die before the terminal `tool-call` frame. Assemble what streamed, or
+    // hand the model an in-band error — never end the turn advertising a call
+    // that was silently dropped.
+    const recoverUndeliveredToolCalls = () => {
+        const events = finalizeStreamedToolInputs(toolInputs);
+        for (const event of events) {
+            if (event.type === "tool-call") {
+                parts.push({
+                    type: "tool-call",
+                    id: event.id,
+                    name: event.name,
+                    input: event.input,
+                });
+            }
+        }
+        return events;
+    };
     try {
         for await (const line of readJsonlLines(reader, captureContext.abortSignal)) {
             let event;
@@ -473,8 +500,8 @@ async function* parseJsonlStream(reader, model, captureContext = {}) {
                     };
                     break;
                 }
-                case "tool-call-delta":
-                    yield {
+                case "tool-call-delta": {
+                    const delta = {
                         type: "tool-input-delta",
                         id: event.id,
                         name: event.name,
@@ -484,24 +511,24 @@ async function* parseJsonlStream(reader, model, captureContext = {}) {
                                 ? event.delta
                                 : "",
                     };
+                    observeStreamedToolInput(toolInputs, delta);
+                    yield delta;
                     break;
+                }
                 case "heartbeat":
                     yield { type: "gateway-heartbeat" };
                     break;
                 case "tool-call": {
                     flushPending();
-                    parts.push({
-                        type: "tool-call",
-                        id: event.id,
-                        name: event.name,
-                        input: event.input,
-                    });
-                    yield {
+                    const call = {
                         type: "tool-call",
                         id: event.id,
                         name: event.name,
                         input: event.input,
                     };
+                    parts.push(call);
+                    observeStreamedToolInput(toolInputs, call);
+                    yield { ...call };
                     break;
                 }
                 case "usage": {
@@ -519,6 +546,7 @@ async function* parseJsonlStream(reader, model, captureContext = {}) {
                 }
                 case "stop": {
                     flushPending();
+                    yield* recoverUndeliveredToolCalls();
                     yield { type: "assistant-content", parts };
                     const reason = event.reason ?? "end_turn";
                     if (reason === "rate_limited") {
@@ -634,6 +662,7 @@ async function* parseJsonlStream(reader, model, captureContext = {}) {
         }
         // Stream ended without a stop event — synthesize one so callers don't hang.
         flushPending();
+        yield* recoverUndeliveredToolCalls();
         yield { type: "assistant-content", parts };
         yield {
             type: "stop",
@@ -882,9 +911,7 @@ function formatTimeoutMs(timeoutMs) {
     return `${Math.round(timeoutMs / 1000)}s`;
 }
 function errorMessage(err) {
-    if (err instanceof Error)
-        return err.message;
-    return String(err);
+    return describeErrorWithCauses(err);
 }
 function errorSearchText(err) {
     const parts = [];