LLMs: Anthropic: sync proto

Author: enricoros

src/modules/aix/server/dispatch/chatGenerate/adapters/anthropic.messageCreate.ts

@@ -34,7 +34,7 @@ export function aixAnthropicHostedFeatures(model: AixAPI_Model, chatGenerate: Ai
   const _hasAixCustomTools = chatGenerate.tools?.some(t => t.type === 'function_call');
   const _hasAixToolRestrictivePolicy = chatGenerate.toolsPolicy?.type === 'any' || chatGenerate.toolsPolicy?.type === 'function_call';
 
-  // Dynamic web tools (20260209) require code execution for programmatic tool calling
+  // Dynamic web tools (20260318, was 20260209) require code execution for programmatic tool calling
   // const hasDynamicWebTools = model.vndAntWebDynamic === true && (model.vndAntWebSearch === 'auto' || model.vndAntWebFetch === 'auto');
 
   // Programmatic Tool Calling - tools with allowed_callers or input_examples
@@ -49,7 +49,7 @@ export function aixAnthropicHostedFeatures(model: AixAPI_Model, chatGenerate: Ai
   // three ways, all converging on ONE explicit container: the standalone Code Sandbox toggle (a
   // general-purpose hosted-container sandbox), Skills (which run inside the container), and Programmatic Tool Calling
   // (which uses the container as its script executor).
-  // Dynamic web tools (_20260209) have their OWN internal code execution. We never AUTO-enable the
+  // Dynamic web tools (_20260318, was _20260209) have their OWN internal code execution. We never AUTO-enable the
   // standalone tool from them (#1087: a 2nd implicit environment is parasitic), nor from container
   // continuity alone. We DO honor an explicit user toggle even alongside dynamic web: Anthropic's
   // docs note this can create two execution environments that may confuse the model (mitigable via
@@ -285,10 +285,11 @@ export function aixToAnthropicMessageCreate(model: AixAPI_Model, _chatGenerate:
   if (!disableAllHostedTools) {
     const hostedTools: NonNullable<TRequest['tools']> = [];
 
-    // Web Search Tool - dynamic filtering (20260209) uses internal code execution for better results
+    // Web Search Tool - dynamic filtering (20260318, supersedes 20260209) uses internal code execution for better results.
+    // response_inclusion intentionally left unset (defaults to 'full') - unchanged behavior, see _WebSearchTool_20260318_schema.
     if (model.vndAntWebSearch === 'auto') {
       hostedTools.push({
-        type: model.vndAntWebDynamic ? 'web_search_20260209' : 'web_search_20250305',
+        type: model.vndAntWebDynamic ? 'web_search_20260318' : 'web_search_20250305',
         name: 'web_search',
         ...(model.vndAntWebSearchMaxUses !== undefined ? { max_uses: model.vndAntWebSearchMaxUses } : {}),
         ...(model.userGeolocation ? {
@@ -297,10 +298,11 @@ export function aixToAnthropicMessageCreate(model: AixAPI_Model, _chatGenerate:
       });
     }
 
-    // Web Fetch Tool - dynamic filtering (20260209) uses internal code execution for better results
+    // Web Fetch Tool - dynamic filtering (20260318, supersedes 20260209/20260309) uses internal code execution for better results.
+    // response_inclusion intentionally left unset (defaults to 'full') - unchanged behavior, see _WebFetchTool_20260318_schema.
     if (model.vndAntWebFetch === 'auto') {
       hostedTools.push({
-        type: model.vndAntWebDynamic ? 'web_fetch_20260209' : 'web_fetch_20250910',
+        type: model.vndAntWebDynamic ? 'web_fetch_20260318' : 'web_fetch_20250910',
         name: 'web_fetch',
         ...(model.vndAntWebFetchMaxUses !== undefined ? { max_uses: model.vndAntWebFetchMaxUses } : {}),
         citations: { enabled: true },
@@ -320,10 +322,11 @@ export function aixToAnthropicMessageCreate(model: AixAPI_Model, _chatGenerate:
       });
 
     // Code execution tool (Anthropic's) - added for the Code Sandbox toggle, Skills, container reuse, and Programmatic Tool Calling.
-    // Not AUTO-added for dynamic web tools (_20260209) which execute code internally; an explicit user
+    // Not AUTO-added for dynamic web tools (_20260318, was _20260209) which execute code internally; an explicit user
     // toggle may still coexist with them by design (see aixAnthropicHostedFeatures note re #1087).
     // Keep _20260120: it matches the code execution version dynamic web auto-injects, so coexisting
-    // merges into ONE environment. An older version (e.g. _20250825) 400s: 'tool names must be unique'.
+    // merges into ONE environment (re-verified empirically on _20260318: caller.type is still 'code_execution_20260120').
+    // An older version (e.g. _20250825) 400s: 'tool names must be unique'.
     if (enableCodeExecution)
       hostedTools.push({ type: 'code_execution_20260120', name: 'code_execution' });
 
@@ -334,7 +337,7 @@ export function aixToAnthropicMessageCreate(model: AixAPI_Model, _chatGenerate:
   }
 
   // --- Container continuity between calls ---
-  // Re-attaching the container is DECOUPLED from enableCodeExecution: dynamic web tools (_20260209)
+  // Re-attaching the container is DECOUPLED from enableCodeExecution: dynamic web tools (_20260318, was _20260209)
   // use a container internally, and the API accepts a `container` alongside them WITHOUT the standalone
   // code_execution tool (empirically verified). So we keep ONE sandbox across mixed search/skills/code
   // turns - a file written by code execution survives an intervening search turn (verified: ls /tmp). This

src/modules/aix/server/dispatch/chatGenerate/parsers/anthropic.parser.ts

@@ -74,6 +74,15 @@ const hotFixAntInjectToolsTextSpacer = true;
  * - Message Deltas will provide a 'stop reason' on the message
  * - Begin/End are explicit
  */
+
+// TODO (tracked, not implemented): Anthropic GA'd "mid-conversation system messages" 2026-05-28 (Opus 4.8 only so far) -
+// a `{role: 'system'}` message can be appended mid-`messages` (must immediately follow a user/tool-result turn, and
+// either end the array or precede an assistant turn) to inject operator-priority instructions without invalidating the
+// cached prefix - unlike editing the top-level `system` field, which busts the cache for everything after it. This is a
+// REQUEST-construction feature (would live in anthropic.messageCreate.ts's per-message content-block generator, not
+// here) - noted in this file as the spot we track Anthropic protocol deltas pending wider model support past Opus 4.8.
+// See: https://platform.claude.com/docs/en/build-with-claude/mid-conversation-system-messages
+
 export function createAnthropicMessageParser(): ChatGenerateParseFunction {
   const parserCreationTimestamp = Date.now();
   let responseMessage: AnthropicWire_API_Message_Create.Response;

src/modules/aix/server/dispatch/wiretypes/anthropic.wiretypes.ts

@@ -13,6 +13,18 @@ const hotFixAntShipNoEmptyTextBlocks = true; // Replace empty text blocks with a
  *
  * ## Updates
  *
+ * ### 2026-06-30 - API Sync: new tool versions, refusal categories, Sonnet 5 verified
+ * - Tools: Added web_search_20260318 / web_fetch_20260318 (GA, 2026-06-11) - adds `response_inclusion` ('full'|'excluded')
+ *   to drop the nested search/fetch call+result pair from the response once consumed by a completed code-execution call
+ *   (dynamic filtering). Wired as the new default for the dynamic-filtering path (replacing _20260209); `response_inclusion`
+ *   left unset (defaults to 'full') - this is purely the version bump, no behavior change.
+ * - StopDetails.category: added 'frontier_llm', 'military_weapons' (current docs list these alongside 'cyber'/'bio'/'reasoning_extraction')
+ * - Verified empirically against the live API: Claude Sonnet 5 (launched 2026-06-29) breaking changes (temperature/top_p/top_k
+ *   rejected, manual thinking budget rejected, but thinking.disabled and forced tool_choice both OK unlike Fable/Mythos 5) -
+ *   existing adapter logic already handles all of these correctly via LLM_IF_HOTFIX_NoTemperature + per-model thinking-budget plumbing.
+ * - NOT adopted (tracked in anthropic.parser.ts top comment): mid-conversation system messages (role: 'system', Opus 4.8
+ *   only, GA 2026-05-28) - appends operator-priority instructions mid-`messages` without invalidating the cached prefix.
+ *
  * ### 2026-06-09 - API Sync: Claude Fable 5 / Mythos 5, forward-compatible parsing
  * - StopDetails.category: added 'reasoning_extraction' (Fable 5 ToS classifier for reverse engineering / output duplication)
  * - StopDetails: added `recommended_model` (suggested retry model when a server-side fallback could not run)
@@ -802,6 +814,18 @@ export namespace AnthropicWire_Tools {
     use_cache: z.boolean().optional(), // default true; set false to bypass cache and fetch fresh content
   });
 
+  /**
+   * [Anthropic, 2026-06-11 GA] Latest - adds `response_inclusion`.
+   * When the fetch was called programmatically from a completed code-execution call (dynamic filtering), 'excluded'
+   * drops the nested server_tool_use(web_fetch) + web_fetch_tool_result pair from the response entirely (verified
+   * empirically: ~98% response size reduction on a full page fetch). Default 'full' (unchanged from prior versions).
+   * Direct calls, or code-execution calls that paused before completing, are always returned in full regardless.
+   */
+  const _WebFetchTool_20260318_schema = _WebFetchTool_20260309_schema.extend({
+    type: z.literal('web_fetch_20260318'),
+    response_inclusion: z.enum(['full', 'excluded']).optional(), // default: 'full'
+  });
+
   // -- Web Search Tools --
 
   const _WebSearchTool_20250305_schema = _ToolDefinitionBase_schema.extend({
@@ -813,11 +837,17 @@ export namespace AnthropicWire_Tools {
     user_location: z.any().nullish(), // UserLocation schema
   });
 
-  /** [Anthropic, Feb 2026 GA] Web search v2 - latest. */
+  /** [Anthropic, Feb 2026 GA] Web search v2. */
   const _WebSearchTool_20260209_schema = _WebSearchTool_20250305_schema.extend({
     type: z.literal('web_search_20260209'),
   });
 
+  /** [Anthropic, 2026-06-11 GA] Latest - adds `response_inclusion`, see _WebFetchTool_20260318_schema for semantics. */
+  const _WebSearchTool_20260318_schema = _WebSearchTool_20260209_schema.extend({
+    type: z.literal('web_search_20260318'),
+    response_inclusion: z.enum(['full', 'excluded']).optional(), // default: 'full'
+  });
+
 
   export const ToolDefinition_schema = z.discriminatedUnion('type', [
     // Client-side tools
@@ -835,8 +865,10 @@ export namespace AnthropicWire_Tools {
     _WebFetchTool_20250910_schema,
     _WebFetchTool_20260209_schema,
     _WebFetchTool_20260309_schema,
+    _WebFetchTool_20260318_schema,
     _WebSearchTool_20250305_schema,
     _WebSearchTool_20260209_schema,
+    _WebSearchTool_20260318_schema,
   ]);
 
 }
@@ -878,7 +910,7 @@ export namespace AnthropicWire_API_Message_Create {
    */
   const StopDetails_schema = z.object({
     type: z.enum(['refusal']).or(z.string()),
-    category: z.enum(['cyber', 'bio', 'reasoning_extraction']).or(z.string()).nullish(),
+    category: z.enum(['cyber', 'bio', 'reasoning_extraction', 'frontier_llm', 'military_weapons']).or(z.string()).nullish(),
     explanation: z.string().nullish(),
     /** [Anthropic, 2026-06-09] Model suggested for a direct retry when a server-side fallback could not run (e.g. fallback model rate-limited). Hint only, may be null. */
     recommended_model: z.string().nullish(),

src/modules/llms/server/anthropic/anthropic.models.ts

@@ -114,6 +114,8 @@ const _hardcodedAnthropicThinkingVariants: ModelVariantMap & { [id: string]: { i
     parameterSpecs: [
       { paramId: 'llmVndAntThinkingBudget', hidden: true, initialValue: -1 /* FORCE adaptive - 4.7 rejects budget_tokens */ },
       { paramId: 'llmVndAntEffort', enumValues: ['low', 'medium', 'high', 'xhigh', 'max'] },
+      // TODO 2026-07-24: fast mode deprecated 2026-06-25, HARD REMOVAL on this date - speed:'fast' will then return
+      // an error (unlike Opus 4.6's silent no-op removal). Drop 'fast_6x' here once removed; migrate users to Opus 4.8.
       { paramId: 'llmVndAntInfSpeed', enumValues: ['fast_6x'] },
       ...ANT_TOOLS_DYNAMIC,
     ],
@@ -129,7 +131,9 @@ const _hardcodedAnthropicThinkingVariants: ModelVariantMap & { [id: string]: { i
     parameterSpecs: [
       { paramId: 'llmVndAntThinkingBudget', hidden: true, initialValue: -1 /* FORCE adaptive */ },
       { paramId: 'llmVndAntEffort', enumValues: ['low', 'medium', 'high', 'max'] },
-      { paramId: 'llmVndAntInfSpeed', enumValues: ['fast_6x'] }, // fast mode deprecated 2026-05-28, removal ~30d later
+      // fast mode REMOVED by Anthropic 2026-06-29: speed:'fast' no longer errors, but silently runs at standard
+      // speed/price (no usage.speed field to detect this client-side - see anthropic.wiretypes.ts). Toggle dropped
+      // here so the UI doesn't advertise a dead control. If Anthropic restores it, re-add 'fast_6x'.
       ...ANT_TOOLS_DYNAMIC,
     ],
     benchmark: { cbaElo: 1502 }, // claude-opus-4-6-thinking
@@ -364,6 +368,8 @@ export const hardcodedAnthropicModels = llmsDefineModels<_AnthropicModelDef>()([
     interfaces: [...IF_47, LLM_IF_ANT_ToolsSearch],
     parameterSpecs: [
       { paramId: 'llmVndAntEffort', enumValues: ['low', 'medium', 'high', 'xhigh', 'max'] },
+      // TODO 2026-07-24: fast mode deprecated 2026-06-25, HARD REMOVAL on this date - speed:'fast' will then return
+      // an error (unlike Opus 4.6's silent no-op removal). Drop 'fast_6x' here once removed; migrate users to Opus 4.8.
       { paramId: 'llmVndAntInfSpeed', enumValues: ['fast_6x'] }, // fast mode: research preview since 2026-05-12, Anthropic API only (6x tier, $30/$150)
       ...ANT_TOOLS_DYNAMIC,
     ],
@@ -385,7 +391,9 @@ export const hardcodedAnthropicModels = llmsDefineModels<_AnthropicModelDef>()([
     interfaces: [...IF_4, LLM_IF_ANT_ToolsSearch],
     parameterSpecs: [
       { paramId: 'llmVndAntEffort', enumValues: ['low', 'medium', 'high', 'max'] },
-      { paramId: 'llmVndAntInfSpeed', enumValues: ['fast_6x'] }, // fast mode deprecated 2026-05-28, removal ~30d later
+      // fast mode REMOVED by Anthropic 2026-06-29: speed:'fast' no longer errors, but silently runs at standard
+      // speed/price (no usage.speed field to detect this client-side - see anthropic.wiretypes.ts). Toggle dropped
+      // here so the UI doesn't advertise a dead control. If Anthropic restores it, re-add 'fast_6x'.
       ...ANT_TOOLS_DYNAMIC,
     ],
     // Opus 4.6: flat $5/$25 pricing (1M context GA at standard pricing since 2026-03-13, no opt-in required)