docs(providers): move prompt-cache inline comments into TSDoc

Drop the inline // comments in favor of TSDoc on the helper/gate. The gate-sizing
and call-ordering rationale now lives in applyAnthropicPromptCache's TSDoc; no
behavior change.

Author: waleedlatif1

apps/sim/providers/anthropic/core.ts

@@ -325,10 +325,6 @@ export async function executeAnthropicProviderRequest(
     }
   }
 
-  // Prompt caching: mark the static prefix (system + tools) with an ephemeral
-  // cache breakpoint so repeated calls (agent tool-loops, multi-turn) reuse it.
-  // Runs after the structured-output block above, which assumes `system` is still
-  // a string. Mutates payload.system and the last tool in place.
   applyAnthropicPromptCache(payload, anthropicTools, request.systemPrompt)
 
   // Add extended thinking configuration if supported and requested

apps/sim/providers/anthropic/utils.ts

@@ -22,12 +22,19 @@ interface AnthropicCacheablePayload {
  * Marks the static request prefix (system prompt + tools) with an ephemeral
  * cache breakpoint when {@link shouldCacheStaticPrefix} deems it worthwhile, so
  * repeated calls reuse the cached prefix. Mutates `payload.system` (string → a
- * single cached text block) and the last entry of `tools` in place.
+ * single cached text block) and the last entry of `tools` in place; a no-op when
+ * the prefix is too small or not present. Call after any structured-output
+ * mutation of `payload.system`, since it may replace the string with a block array.
  *
- * `systemPrompt` is the ORIGINAL request system prompt, used only for the
- * worthiness gate: on the no-messages path the provider relocates the system
- * text into a user message and blanks `payload.system`, but the tools prefix is
- * still worth caching there.
+ * The worthiness gate is sized on the LARGER of the final `payload.system`
+ * (which may include appended structured-output schema text) and the original
+ * `systemPrompt` (non-empty even when the no-messages path relocates the system
+ * text into a user message and blanks `payload.system` — the tools prefix is
+ * still worth caching there).
+ *
+ * @param payload - Anthropic request payload; `system` is mutated in place.
+ * @param tools - Anthropic tool definitions; the last entry is mutated in place.
+ * @param systemPrompt - The original request system prompt, used only for sizing.
  */
 export function applyAnthropicPromptCache(
   payload: AnthropicCacheablePayload,
@@ -36,9 +43,6 @@ export function applyAnthropicPromptCache(
 ): void {
   const payloadSystem = typeof payload.system === 'string' ? payload.system : ''
 
-  // Size the gate on the LARGER of the final payload.system (which may include
-  // appended structured-output schema text) and the original request prompt
-  // (non-empty even when the no-messages path relocates it out of payload.system).
   const gateSystem =
     payloadSystem.length >= (systemPrompt?.length ?? 0) ? payloadSystem : systemPrompt
 

apps/sim/providers/prompt-cache.ts

@@ -40,8 +40,5 @@ export function shouldCacheStaticPrefix(params: {
     return false
   }
 
-  // Tools imply an agent loop (the prefix is re-read each iteration). Without
-  // tools, only cache when the system prompt alone is large enough to be worth
-  // the write on its own.
   return params.hasTools || systemTokens >= MIN_CACHEABLE_PREFIX_TOKENS
 }