@framers/agentos 0.9.111 → 0.9.113

package/dist/core/llm/providers/IProvider.d.ts

@@ -159,6 +159,20 @@ export interface ModelCompletionOptions {
      * dropped on unsupported models or invalid values.
      */
     effort?: string;
+    /**
+     * Anthropic prompt-cache diagnostics (beta `cache-diagnosis-2026-04-07`).
+     * When set, the provider sends `diagnostics: { previous_message_id }` plus
+     * the beta header, and the API compares this request against the referenced
+     * one to explain any cache miss. Pass `previousMessageId: null` on the first
+     * call of a conversation to opt in; thread the previous response's `id`
+     * (`msg_...`) on subsequent calls. The verdict comes back on
+     * {@link ModelCompletionResponse.cacheDiagnostics}. Anthropic-only —
+     * other providers ignore the field. Never affects request processing:
+     * diagnostics are best-effort observability.
+     */
+    cacheDiagnostics?: {
+        previousMessageId: string | null;
+    };
     /**
      * Positive values penalize new tokens based on whether they appear in the text so far,
      * increasing the model's likelihood to talk about new topics.
@@ -220,6 +234,30 @@ export interface ModelCompletionOptions {
         };
     } | Record<string, unknown>;
 }
+/**
+ * The first point of divergence between this request and the one referenced
+ * by `cacheDiagnostics.previousMessageId`, as reported by Anthropic's
+ * cache-diagnostics beta. `type` is one of the API's discriminants
+ * (`model_changed` | `system_changed` | `tools_changed` | `messages_changed`
+ * | `previous_message_not_found` | `unavailable`) — kept as an open string so
+ * new discriminants pass through without a library update. The `*_changed`
+ * types also carry `cacheMissedInputTokens`, an estimate of how many input
+ * tokens fell after the divergence point (magnitude indicator, not a billing
+ * number).
+ */
+export interface CacheMissReason {
+    type: string;
+    cacheMissedInputTokens?: number;
+}
+/**
+ * Cache-diagnostics verdict for one call. `cacheMissReason: null` means the
+ * comparison was still running when the response serialized (inconclusive —
+ * check the next turn). A populated reason identifies the earliest divergence;
+ * fix it first, later ones may be hidden behind it.
+ */
+export interface CacheDiagnostics {
+    cacheMissReason: CacheMissReason | null;
+}
 /**
  * Represents token usage information from a model call, including cost estimation.
  */
@@ -267,6 +305,15 @@ export interface ModelCompletionResponse {
     choices: ModelCompletionChoice[];
     /** Token usage & optional cost metrics (present on final chunk; may be partial/omitted on deltas). */
     usage?: ModelUsage;
+    /**
+     * Anthropic cache-diagnostics verdict (beta). Present only when the request
+     * opted in via {@link ModelCompletionOptions.cacheDiagnostics} AND the API
+     * returned a verdict. `null` = a comparison ran and found no divergence (or
+     * this was the opt-in first turn with nothing to compare). An object with
+     * `cacheMissReason` identifies the earliest divergence — see
+     * {@link CacheDiagnostics}.
+     */
+    cacheDiagnostics?: CacheDiagnostics | null;
     /** Unified error envelope; present ONLY if an error occurred for this request/chunk. */
     error?: {
         /** Human readable message suitable for UI display or logging. */

package/dist/core/llm/providers/IProvider.d.ts.map

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

package/dist/core/llm/providers/implementations/AnthropicProvider.d.ts

@@ -16,7 +16,7 @@
  * @module backend/agentos/core/llm/providers/implementations/AnthropicProvider
  * @implements {IProvider}
  */
-import { IProvider, ChatMessage, ModelCompletionOptions, ModelCompletionResponse, ModelInfo, ProviderEmbeddingOptions, ProviderEmbeddingResponse } from '../IProvider';
+import { IProvider, ChatMessage, ModelCompletionOptions, ModelCompletionResponse, ModelInfo, ProviderEmbeddingOptions, ProviderEmbeddingResponse, CacheDiagnostics } from '../IProvider';
 import { modelSupportsForcedToolChoice } from '../model-forced-tool-choice.js';
 export { modelSupportsForcedToolChoice };
 /**
@@ -106,6 +106,73 @@ export interface AnthropicProviderConfig {
  *   model, `true` otherwise.
  */
 export declare function modelSupportsTemperature(modelId: string): boolean;
+/** A single content block in an Anthropic message (text, tool_use, or tool_result). */
+interface AnthropicContentBlock {
+    type: 'text' | 'tool_use' | 'tool_result' | 'image' | 'thinking' | 'redacted_thinking';
+    /** Present when type === 'text'. */
+    text?: string;
+    /** Present when type === 'thinking' — the reasoning text. */
+    thinking?: string;
+    /** Present when type === 'thinking' — opaque replay signature; preserve verbatim. */
+    signature?: string;
+    /** Present when type === 'redacted_thinking' — encrypted reasoning blob; preserve verbatim. */
+    data?: string;
+    /** Present when type === 'tool_use'. */
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+    /** Present when type === 'tool_result'. */
+    tool_use_id?: string;
+    content?: string | Array<{
+        type: string;
+        text?: string;
+    }>;
+    is_error?: boolean;
+    /** Present when type === 'image'. */
+    source?: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    };
+}
+/** The Anthropic Messages API response shape. */
+interface AnthropicMessagesResponse {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    content: AnthropicContentBlock[];
+    model: string;
+    stop_reason: 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | null;
+    stop_sequence: string | null;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number;
+        cache_read_input_tokens?: number;
+    };
+    /**
+     * Cache-diagnostics verdict (beta `cache-diagnosis-2026-04-07`). Returned
+     * only when the request carried a `diagnostics` field. Absent = not
+     * requested; `null` = compared with no divergence (or first-turn opt-in);
+     * `{ cache_miss_reason: null }` = comparison still running;
+     * `{ cache_miss_reason: {...} }` = earliest divergence identified.
+     */
+    diagnostics?: {
+        cache_miss_reason: {
+            type: string;
+            cache_missed_input_tokens?: number;
+        } | null;
+    } | null;
+}
+/**
+ * Normalize the wire-format diagnostics object into the camelCased
+ * {@link CacheDiagnostics} surfaced on {@link ModelCompletionResponse}.
+ * Preserves the API's three requested-response states losslessly:
+ * `null` (compared, no divergence) stays `null`; `cache_miss_reason: null`
+ * (comparison pending) becomes `{ cacheMissReason: null }`; a populated
+ * reason maps field-for-field. Exported for tests.
+ */
+export declare function normalizeCacheDiagnostics(diagnostics: AnthropicMessagesResponse['diagnostics']): CacheDiagnostics | null;
 /**
  * Clamp a requested `max_tokens` to the target model's real output ceiling from
  * {@link ANTHROPIC_MODELS}. Anthropic returns HTTP 400 when `max_tokens` exceeds
@@ -480,13 +547,25 @@ export declare class AnthropicProvider implements IProvider {
     private nextApiKey;
     private buildHeaders;
     /**
-     * The `anthropic-beta` header for interleaved extended thinking, returned
-     * only when this request actually uses thinking — either it enables it
-     * outbound (`thinking` in the body) or it replays captured thinking blocks
-     * from a prior assistant turn. Empty otherwise, so non-thinking traffic is
-     * byte-for-byte unchanged.
-     */
-    private thinkingBetaHeaders;
+     * The `anthropic-beta` header for every beta this request actually uses,
+     * comma-joined per the API convention. Currently:
+     *
+     * - `interleaved-thinking-2025-05-14` — when the request enables extended
+     *   thinking outbound (`thinking` in the body) or replays captured thinking
+     *   blocks from a prior assistant turn.
+     * - `cache-diagnosis-2026-04-07` — when the body carries a `diagnostics`
+     *   field (see {@link ModelCompletionOptions.cacheDiagnostics}); the header
+     *   must ride EVERY diagnosed turn or the next turn's lookup fails with
+     *   `previous_message_not_found`.
+     * - `structured-outputs-2025-11-13` — when any tool definition in the body
+     *   carries `strict: true` (the forced structured-output tool on
+     *   strict-capable models; see modelSupportsStrictToolUse).
+     *
+     * Empty when no beta applies, so plain traffic is byte-for-byte unchanged.
+     */
+    private betaHeaders;
+    /** True when any tool definition in the request carries `strict: true`. */
+    private payloadUsesStrictTools;
     /** True when the request enables extended thinking or replays thinking blocks. */
     private payloadUsesThinking;
     /**

package/dist/core/llm/providers/implementations/AnthropicProvider.d.ts.map

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

package/dist/core/llm/providers/implementations/AnthropicProvider.js

@@ -3,6 +3,7 @@ import { AnthropicProviderError } from '../errors/AnthropicProviderError.js';
 import { ApiKeyPool } from '../../../providers/ApiKeyPool.js';
 import { resolveThinkingPayload } from '../model-thinking.js';
 import { modelSupportsForcedToolChoice } from '../model-forced-tool-choice.js';
+import { modelSupportsStrictToolUse } from '../model-strict-tool-use.js';
 import { modelSupportsEffort, isEffortLevel } from '../model-effort.js';
 import { computeRetryBackoffMs } from './retry-backoff.js';
 import { recordCacheUsage } from './cacheLeakDetector.js';
@@ -43,6 +44,29 @@ export function modelSupportsTemperature(modelId) {
     // lockstep with modelSupportsThinking.
     return !/^claude-(opus-4-(7|8)|sonnet-5|fable-5)\b/i.test(modelId);
 }
+/**
+ * Normalize the wire-format diagnostics object into the camelCased
+ * {@link CacheDiagnostics} surfaced on {@link ModelCompletionResponse}.
+ * Preserves the API's three requested-response states losslessly:
+ * `null` (compared, no divergence) stays `null`; `cache_miss_reason: null`
+ * (comparison pending) becomes `{ cacheMissReason: null }`; a populated
+ * reason maps field-for-field. Exported for tests.
+ */
+export function normalizeCacheDiagnostics(diagnostics) {
+    if (diagnostics == null)
+        return null;
+    const reason = diagnostics.cache_miss_reason;
+    return {
+        cacheMissReason: reason == null
+            ? null
+            : {
+                type: reason.type,
+                ...(reason.cache_missed_input_tokens !== undefined && {
+                    cacheMissedInputTokens: reason.cache_missed_input_tokens,
+                }),
+            },
+    };
+}
 // ---------------------------------------------------------------------------
 // Known model catalog — used by listAvailableModels / getModelInfo
 // ---------------------------------------------------------------------------
@@ -382,7 +406,15 @@ export class AnthropicProvider {
                 if (!this.isRetryableStreamError(lastError) || attempt === attempts - 1) {
                     throw lastError;
                 }
-                await new Promise(resolve => setTimeout(resolve, computeRetryBackoffMs(attempt)));
+                // Honor the server's Retry-After when the failed attempt carried one
+                // (429s from makeStreamRequest stash it on error.details) — parity
+                // with the non-stream retry path. Fall back to jittered backoff.
+                const retryAfterSec = lastError.details
+                    ?.retryAfterSec;
+                const sleepMs = typeof retryAfterSec === 'number' && Number.isFinite(retryAfterSec) && retryAfterSec > 0
+                    ? retryAfterSec * 1000
+                    : computeRetryBackoffMs(attempt);
+                await new Promise(resolve => setTimeout(resolve, sleepMs));
             }
         }
         throw lastError;
@@ -434,6 +466,7 @@ export class AnthropicProvider {
         let outputTokens = 0;
         let cacheCreationTokens;
         let cacheReadTokens;
+        let diagnostics;
         let sawMessageDelta = false;
         const blocks = new Map();
         for await (const rawEvent of this.parseSseStream(stream)) {
@@ -452,6 +485,8 @@ export class AnthropicProvider {
                     inputTokens = event.message.usage?.input_tokens ?? 0;
                     cacheCreationTokens = event.message.usage?.cache_creation_input_tokens;
                     cacheReadTokens = event.message.usage?.cache_read_input_tokens;
+                    // Cache diagnostics ride message_start in streaming responses.
+                    diagnostics = event.message.diagnostics;
                     break;
                 }
                 case 'content_block_start': {
@@ -550,6 +585,7 @@ export class AnthropicProvider {
                 ...(cacheCreationTokens !== undefined && { cache_creation_input_tokens: cacheCreationTokens }),
                 ...(cacheReadTokens !== undefined && { cache_read_input_tokens: cacheReadTokens }),
             },
+            ...(diagnostics !== undefined && { diagnostics }),
         };
     }
     /**
@@ -1035,6 +1071,18 @@ export class AnthropicProvider {
             const oc = payload.output_config ?? {};
             payload.output_config = { ...oc, effort: options.effort };
         }
+        // --- Cache diagnostics (beta cache-diagnosis-2026-04-07) ---
+        // Opt-in observability: the API compares this request against the one
+        // referenced by previous_message_id and reports where the prompt prefix
+        // diverged (cache_miss_reason on the response). `null` opts in on the
+        // first turn with nothing to compare. The matching beta header is added
+        // by betaHeaders() keyed off this payload field. Best-effort by API
+        // contract — diagnostics never block or fail the request.
+        if (options.cacheDiagnostics !== undefined) {
+            payload.diagnostics = {
+                previous_message_id: options.cacheDiagnostics.previousMessageId,
+            };
+        }
         // --- Tool definitions ---
         const tools = this.convertToolDefs(options.tools);
         if (tools.length > 0) {
@@ -1066,7 +1114,20 @@ export class AnthropicProvider {
             // against a direct provider.generateCompletion call that
             // accidentally passes both responseFormat (structured-output
             // marker) and a tools array.
-            payload.tools = [{ name: sf.tool.name, input_schema: sf.tool.input_schema }];
+            // Guaranteed schema conformance where the model supports strict tool
+            // use (structured-outputs surface, 4.5+ generations): the API
+            // validates the tool input against input_schema server-side instead
+            // of best-effort adherence, so long/adversarial generations can no
+            // longer drift from the schema and fail the caller's Zod parse.
+            // Older models reject the unknown field ("tools.0.strict: Extra
+            // inputs are not permitted"), hence the capability gate. The
+            // matching `structured-outputs-2025-11-13` beta header is emitted by
+            // betaHeaders() whenever a payload's tools carry the flag.
+            payload.tools = [{
+                    name: sf.tool.name,
+                    input_schema: sf.tool.input_schema,
+                    ...(modelSupportsStrictToolUse(modelId) ? { strict: true } : {}),
+                }];
             payload.tool_choice = { type: 'tool', name: sf.tool.name };
         }
         // --- Forced tool_choice reconciliation ---
@@ -1508,6 +1569,9 @@ export class AnthropicProvider {
             modelId: apiResponse.model,
             choices: [choice],
             usage,
+            ...(apiResponse.diagnostics !== undefined && {
+                cacheDiagnostics: normalizeCacheDiagnostics(apiResponse.diagnostics),
+            }),
         };
     }
     /**
@@ -1656,7 +1720,7 @@ export class AnthropicProvider {
                 // race guarantees the await resolves within requestTimeout + 500ms.
                 const fetchPromise = fetch(url, {
                     method,
-                    headers: { ...headers, ...this.thinkingBetaHeaders(body), 'Content-Type': 'application/json', connection: 'close' },
+                    headers: { ...headers, ...this.betaHeaders(body), 'Content-Type': 'application/json', connection: 'close' },
                     body: JSON.stringify(body),
                     signal: controller.signal,
                 });
@@ -1776,7 +1840,7 @@ export class AnthropicProvider {
             // guarantees the await ends even when the signal is ignored.
             const fetchPromise = fetch(url, {
                 method: 'POST',
-                headers: { ...headers, ...this.thinkingBetaHeaders(body), 'Content-Type': 'application/json' },
+                headers: { ...headers, ...this.betaHeaders(body), 'Content-Type': 'application/json' },
                 body: JSON.stringify(body),
                 signal: controller.signal,
             });
@@ -1803,7 +1867,16 @@ export class AnthropicProvider {
                 if (response.status === 429) {
                     this.keyPool?.markExhausted(apiKey);
                 }
-                throw new AnthropicProviderError(errorMessage, 'STREAM_CONNECTION_FAILED', response.status, errorData.error?.type, errorData);
+                // Carry the server's Retry-After (seconds) on the error so the
+                // stream retry loop (streamMessagesToResponse) can honor it — the
+                // non-stream path already does; without this the stream path
+                // re-hit a throttled endpoint on computed backoff and burned an
+                // attempt the server told us was doomed.
+                const retryAfterHeader = response.headers.get('retry-after');
+                const retryAfterSec = retryAfterHeader ? parseInt(retryAfterHeader, 10) : NaN;
+                throw new AnthropicProviderError(errorMessage, 'STREAM_CONNECTION_FAILED', response.status, errorData.error?.type, Number.isFinite(retryAfterSec) && retryAfterSec > 0
+                    ? { ...errorData, retryAfterSec }
+                    : errorData);
             }
             if (!response.body) {
                 throw new AnthropicProviderError('Expected a stream response but body was null.', 'STREAM_BODY_NULL');
@@ -1844,16 +1917,37 @@ export class AnthropicProvider {
         };
     }
     /**
-     * The `anthropic-beta` header for interleaved extended thinking, returned
-     * only when this request actually uses thinking — either it enables it
-     * outbound (`thinking` in the body) or it replays captured thinking blocks
-     * from a prior assistant turn. Empty otherwise, so non-thinking traffic is
-     * byte-for-byte unchanged.
+     * The `anthropic-beta` header for every beta this request actually uses,
+     * comma-joined per the API convention. Currently:
+     *
+     * - `interleaved-thinking-2025-05-14` — when the request enables extended
+     *   thinking outbound (`thinking` in the body) or replays captured thinking
+     *   blocks from a prior assistant turn.
+     * - `cache-diagnosis-2026-04-07` — when the body carries a `diagnostics`
+     *   field (see {@link ModelCompletionOptions.cacheDiagnostics}); the header
+     *   must ride EVERY diagnosed turn or the next turn's lookup fails with
+     *   `previous_message_not_found`.
+     * - `structured-outputs-2025-11-13` — when any tool definition in the body
+     *   carries `strict: true` (the forced structured-output tool on
+     *   strict-capable models; see modelSupportsStrictToolUse).
+     *
+     * Empty when no beta applies, so plain traffic is byte-for-byte unchanged.
      */
-    thinkingBetaHeaders(body) {
-        return this.payloadUsesThinking(body)
-            ? { 'anthropic-beta': 'interleaved-thinking-2025-05-14' }
-            : {};
+    betaHeaders(body) {
+        const betas = [];
+        if (this.payloadUsesThinking(body))
+            betas.push('interleaved-thinking-2025-05-14');
+        if (body.diagnostics !== undefined)
+            betas.push('cache-diagnosis-2026-04-07');
+        if (this.payloadUsesStrictTools(body))
+            betas.push('structured-outputs-2025-11-13');
+        return betas.length > 0 ? { 'anthropic-beta': betas.join(',') } : {};
+    }
+    /** True when any tool definition in the request carries `strict: true`. */
+    payloadUsesStrictTools(body) {
+        const tools = body.tools;
+        return (Array.isArray(tools) &&
+            tools.some(t => t != null && typeof t === 'object' && t.strict === true));
     }
     /** True when the request enables extended thinking or replays thinking blocks. */
     payloadUsesThinking(body) {