@anthropic-ai/sdk 0.95.2 → 0.96.0

package/src/resources/beta/beta.ts

@@ -171,6 +171,12 @@ import {
   BetaBashCodeExecutionToolResultErrorParam,
   BetaCacheControlEphemeral,
   BetaCacheCreation,
+  BetaCacheMissMessagesChanged,
+  BetaCacheMissModelChanged,
+  BetaCacheMissPreviousMessageNotFound,
+  BetaCacheMissSystemChanged,
+  BetaCacheMissToolsChanged,
+  BetaCacheMissUnavailable,
   BetaCitationCharLocation,
   BetaCitationCharLocationParam,
   BetaCitationConfig,
@@ -218,6 +224,8 @@ import {
   BetaContextManagementConfig,
   BetaContextManagementResponse,
   BetaCountTokensContextManagementResponse,
+  BetaDiagnostics,
+  BetaDiagnosticsParam,
   BetaDirectCaller,
   BetaDocumentBlock,
   BetaEncryptedCodeExecutionResultBlock,
@@ -448,7 +456,8 @@ export type AnthropicBeta =
   | 'output-300k-2026-03-24'
   | 'user-profiles-2026-03-24'
   | 'advisor-tool-2026-03-01'
-  | 'managed-agents-2026-04-01';
+  | 'managed-agents-2026-04-01'
+  | 'cache-diagnosis-2026-04-07';
 
 export interface BetaAPIError {
   message: string;
@@ -590,6 +599,12 @@ export declare namespace Beta {
     type BetaBashCodeExecutionToolResultErrorParam as BetaBashCodeExecutionToolResultErrorParam,
     type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
     type BetaCacheCreation as BetaCacheCreation,
+    type BetaCacheMissMessagesChanged as BetaCacheMissMessagesChanged,
+    type BetaCacheMissModelChanged as BetaCacheMissModelChanged,
+    type BetaCacheMissPreviousMessageNotFound as BetaCacheMissPreviousMessageNotFound,
+    type BetaCacheMissSystemChanged as BetaCacheMissSystemChanged,
+    type BetaCacheMissToolsChanged as BetaCacheMissToolsChanged,
+    type BetaCacheMissUnavailable as BetaCacheMissUnavailable,
     type BetaCitationCharLocation as BetaCitationCharLocation,
     type BetaCitationCharLocationParam as BetaCitationCharLocationParam,
     type BetaCitationConfig as BetaCitationConfig,
@@ -637,6 +652,8 @@ export declare namespace Beta {
     type BetaContextManagementConfig as BetaContextManagementConfig,
     type BetaContextManagementResponse as BetaContextManagementResponse,
     type BetaCountTokensContextManagementResponse as BetaCountTokensContextManagementResponse,
+    type BetaDiagnostics as BetaDiagnostics,
+    type BetaDiagnosticsParam as BetaDiagnosticsParam,
     type BetaDirectCaller as BetaDirectCaller,
     type BetaDocumentBlock as BetaDocumentBlock,
     type BetaEncryptedCodeExecutionResultBlock as BetaEncryptedCodeExecutionResultBlock,

package/src/resources/beta/index.ts

@@ -124,6 +124,12 @@ export {
   type BetaBashCodeExecutionToolResultErrorParam,
   type BetaCacheControlEphemeral,
   type BetaCacheCreation,
+  type BetaCacheMissMessagesChanged,
+  type BetaCacheMissModelChanged,
+  type BetaCacheMissPreviousMessageNotFound,
+  type BetaCacheMissSystemChanged,
+  type BetaCacheMissToolsChanged,
+  type BetaCacheMissUnavailable,
   type BetaCitationCharLocation,
   type BetaCitationCharLocationParam,
   type BetaCitationConfig,
@@ -171,6 +177,8 @@ export {
   type BetaContextManagementConfig,
   type BetaContextManagementResponse,
   type BetaCountTokensContextManagementResponse,
+  type BetaDiagnostics,
+  type BetaDiagnosticsParam,
   type BetaDirectCaller,
   type BetaDocumentBlock,
   type BetaEncryptedCodeExecutionResultBlock,

package/src/resources/beta/messages/batches.ts

@@ -563,6 +563,12 @@ export namespace BatchCreateParams {
        */
       context_management?: BetaMessagesAPI.BetaContextManagementConfig | null;
 
+      /**
+       * Request-level diagnostics. Currently carries the previous response id for
+       * prompt-cache divergence reporting.
+       */
+      diagnostics?: BetaMessagesAPI.BetaDiagnosticsParam | null;
+
       /**
        * Specifies the geographic region for inference processing. If not specified, the
        * workspace's `default_inference_geo` is used.

package/src/resources/beta/messages/index.ts

@@ -44,6 +44,12 @@ export {
   type BetaBashCodeExecutionToolResultErrorParam,
   type BetaCacheControlEphemeral,
   type BetaCacheCreation,
+  type BetaCacheMissMessagesChanged,
+  type BetaCacheMissModelChanged,
+  type BetaCacheMissPreviousMessageNotFound,
+  type BetaCacheMissSystemChanged,
+  type BetaCacheMissToolsChanged,
+  type BetaCacheMissUnavailable,
   type BetaCitationCharLocation,
   type BetaCitationCharLocationParam,
   type BetaCitationConfig,
@@ -91,6 +97,8 @@ export {
   type BetaContextManagementConfig,
   type BetaContextManagementResponse,
   type BetaCountTokensContextManagementResponse,
+  type BetaDiagnostics,
+  type BetaDiagnosticsParam,
   type BetaDirectCaller,
   type BetaDocumentBlock,
   type BetaEncryptedCodeExecutionResultBlock,

package/src/resources/beta/messages/messages.ts

@@ -562,6 +562,54 @@ export interface BetaCacheCreation {
   ephemeral_5m_input_tokens: number;
 }
 
+export interface BetaCacheMissMessagesChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'messages_changed';
+}
+
+export interface BetaCacheMissModelChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'model_changed';
+}
+
+export interface BetaCacheMissPreviousMessageNotFound {
+  type: 'previous_message_not_found';
+}
+
+export interface BetaCacheMissSystemChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'system_changed';
+}
+
+export interface BetaCacheMissToolsChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'tools_changed';
+}
+
+export interface BetaCacheMissUnavailable {
+  type: 'unavailable';
+}
+
 export interface BetaCitationCharLocation {
   cited_text: string;
 
@@ -1330,6 +1378,42 @@ export interface BetaCountTokensContextManagementResponse {
   original_input_tokens: number;
 }
 
+/**
+ * Response envelope for request-level diagnostics. Present (possibly null)
+ * whenever the caller supplied `diagnostics` on the request.
+ */
+export interface BetaDiagnostics {
+  /**
+   * Explains why the prompt cache could not fully reuse the prefix from the request
+   * identified by `diagnostics.previous_message_id`. `null` means diagnosis is still
+   * pending — the response was serialized before the background comparison
+   * completed.
+   */
+  cache_miss_reason:
+    | BetaCacheMissModelChanged
+    | BetaCacheMissSystemChanged
+    | BetaCacheMissToolsChanged
+    | BetaCacheMissMessagesChanged
+    | BetaCacheMissPreviousMessageNotFound
+    | BetaCacheMissUnavailable
+    | null;
+}
+
+/**
+ * Request-level diagnostics. Currently carries the previous response id for
+ * prompt-cache divergence reporting.
+ */
+export interface BetaDiagnosticsParam {
+  /**
+   * The `id` (`msg_...`) from this client's previous /v1/messages response. The
+   * server compares that request's prompt fingerprint against this one and returns
+   * `diagnostics.cache_miss_reason` when the prompt-cache prefix could not be
+   * reused. Pass `null` on the first turn to opt in without a prior message to
+   * compare.
+   */
+  previous_message_id?: string | null;
+}
+
 /**
  * Tool invocation directly from the model.
  */
@@ -1746,6 +1830,12 @@ export interface BetaMessage {
    */
   context_management: BetaContextManagementResponse | null;
 
+  /**
+   * Response envelope for request-level diagnostics. Present (possibly null)
+   * whenever the caller supplied `diagnostics` on the request.
+   */
+  diagnostics: BetaDiagnostics | null;
+
   /**
    * The model that will complete your prompt.\n\nSee
    * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -3947,6 +4037,12 @@ export interface MessageCreateParamsBase {
    */
   context_management?: BetaContextManagementConfig | null;
 
+  /**
+   * Body param: Request-level diagnostics. Currently carries the previous response
+   * id for prompt-cache divergence reporting.
+   */
+  diagnostics?: BetaDiagnosticsParam | null;
+
   /**
    * Body param: Specifies the geographic region for inference processing. If not
    * specified, the workspace's `default_inference_geo` is used.
@@ -4465,6 +4561,12 @@ export declare namespace Messages {
     type BetaBashCodeExecutionToolResultErrorParam as BetaBashCodeExecutionToolResultErrorParam,
     type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
     type BetaCacheCreation as BetaCacheCreation,
+    type BetaCacheMissMessagesChanged as BetaCacheMissMessagesChanged,
+    type BetaCacheMissModelChanged as BetaCacheMissModelChanged,
+    type BetaCacheMissPreviousMessageNotFound as BetaCacheMissPreviousMessageNotFound,
+    type BetaCacheMissSystemChanged as BetaCacheMissSystemChanged,
+    type BetaCacheMissToolsChanged as BetaCacheMissToolsChanged,
+    type BetaCacheMissUnavailable as BetaCacheMissUnavailable,
     type BetaCitationCharLocation as BetaCitationCharLocation,
     type BetaCitationCharLocationParam as BetaCitationCharLocationParam,
     type BetaCitationConfig as BetaCitationConfig,
@@ -4512,6 +4614,8 @@ export declare namespace Messages {
     type BetaContextManagementConfig as BetaContextManagementConfig,
     type BetaContextManagementResponse as BetaContextManagementResponse,
     type BetaCountTokensContextManagementResponse as BetaCountTokensContextManagementResponse,
+    type BetaDiagnostics as BetaDiagnostics,
+    type BetaDiagnosticsParam as BetaDiagnosticsParam,
     type BetaDirectCaller as BetaDirectCaller,
     type BetaDocumentBlock as BetaDocumentBlock,
     type BetaEncryptedCodeExecutionResultBlock as BetaEncryptedCodeExecutionResultBlock,

package/src/resources/beta/sessions/events.ts

@@ -172,7 +172,12 @@ export interface BetaManagedAgentsAgentMCPToolResultEvent {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -374,7 +379,12 @@ export interface BetaManagedAgentsAgentToolResultEvent {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -732,6 +742,55 @@ export interface BetaManagedAgentsRetryStatusTerminal {
   type: 'terminal';
 }
 
+/**
+ * A block containing a web search result.
+ */
+export interface BetaManagedAgentsSearchResultBlock {
+  /**
+   * Citation settings for a search result.
+   */
+  citations: BetaManagedAgentsSearchResultCitations;
+
+  /**
+   * Array of text content blocks from the search result.
+   */
+  content: Array<BetaManagedAgentsSearchResultContent>;
+
+  /**
+   * The URL source of the search result.
+   */
+  source: string;
+
+  /**
+   * The title of the search result.
+   */
+  title: string;
+
+  type: 'search_result';
+}
+
+/**
+ * Citation settings for a search result.
+ */
+export interface BetaManagedAgentsSearchResultCitations {
+  /**
+   * Whether citations are enabled for this search result.
+   */
+  enabled: boolean;
+}
+
+/**
+ * Text content within a search result.
+ */
+export interface BetaManagedAgentsSearchResultContent {
+  /**
+   * The text content.
+   */
+  text: string;
+
+  type: 'text';
+}
+
 /**
  * Events that were successfully sent to the session.
  */
@@ -1428,7 +1487,12 @@ export interface BetaManagedAgentsUserCustomToolResultEvent {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -1464,7 +1528,12 @@ export interface BetaManagedAgentsUserCustomToolResultEventParams {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -1765,6 +1834,9 @@ export declare namespace Events {
     type BetaManagedAgentsRetryStatusExhausted as BetaManagedAgentsRetryStatusExhausted,
     type BetaManagedAgentsRetryStatusRetrying as BetaManagedAgentsRetryStatusRetrying,
     type BetaManagedAgentsRetryStatusTerminal as BetaManagedAgentsRetryStatusTerminal,
+    type BetaManagedAgentsSearchResultBlock as BetaManagedAgentsSearchResultBlock,
+    type BetaManagedAgentsSearchResultCitations as BetaManagedAgentsSearchResultCitations,
+    type BetaManagedAgentsSearchResultContent as BetaManagedAgentsSearchResultContent,
     type BetaManagedAgentsSendSessionEvents as BetaManagedAgentsSendSessionEvents,
     type BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,

package/src/resources/beta/sessions/index.ts

@@ -31,6 +31,9 @@ export {
   type BetaManagedAgentsRetryStatusExhausted,
   type BetaManagedAgentsRetryStatusRetrying,
   type BetaManagedAgentsRetryStatusTerminal,
+  type BetaManagedAgentsSearchResultBlock,
+  type BetaManagedAgentsSearchResultCitations,
+  type BetaManagedAgentsSearchResultContent,
   type BetaManagedAgentsSendSessionEvents,
   type BetaManagedAgentsSessionDeletedEvent,
   type BetaManagedAgentsSessionEndTurn,

package/src/resources/beta/sessions/sessions.ts

@@ -34,6 +34,9 @@ import {
   BetaManagedAgentsRetryStatusExhausted,
   BetaManagedAgentsRetryStatusRetrying,
   BetaManagedAgentsRetryStatusTerminal,
+  BetaManagedAgentsSearchResultBlock,
+  BetaManagedAgentsSearchResultCitations,
+  BetaManagedAgentsSearchResultContent,
   BetaManagedAgentsSendSessionEvents,
   BetaManagedAgentsSessionDeletedEvent,
   BetaManagedAgentsSessionEndTurn,
@@ -480,9 +483,9 @@ export interface BetaManagedAgentsOutcomeEvaluationResource {
   outcome_id: string;
 
   /**
-   * Current evaluation state. 'pending' before the agent begins work; 'running'
-   * while producing or revising; 'evaluating' while the grader scores;
-   * 'satisfied'/'max_iterations_reached'/'failed'/'interrupted' are terminal.
+   * Current evaluation state. `pending` before the agent begins work; `running`
+   * while producing or revising; `evaluating` while the grader scores;
+   * `satisfied`/`max_iterations_reached`/`failed`/`interrupted` are terminal.
    */
   result: string;
 
@@ -864,6 +867,9 @@ export declare namespace Sessions {
     type BetaManagedAgentsRetryStatusExhausted as BetaManagedAgentsRetryStatusExhausted,
     type BetaManagedAgentsRetryStatusRetrying as BetaManagedAgentsRetryStatusRetrying,
     type BetaManagedAgentsRetryStatusTerminal as BetaManagedAgentsRetryStatusTerminal,
+    type BetaManagedAgentsSearchResultBlock as BetaManagedAgentsSearchResultBlock,
+    type BetaManagedAgentsSearchResultCitations as BetaManagedAgentsSearchResultCitations,
+    type BetaManagedAgentsSearchResultContent as BetaManagedAgentsSearchResultContent,
     type BetaManagedAgentsSendSessionEvents as BetaManagedAgentsSendSessionEvents,
     type BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.95.2'; // x-release-please-version
+export const VERSION = '0.96.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.95.2";
+export declare const VERSION = "0.96.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.95.2";
+export declare const VERSION = "0.96.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.95.2'; // x-release-please-version
+exports.VERSION = '0.96.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.95.2'; // x-release-please-version
+export const VERSION = '0.96.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map