@anthropic-ai/sdk 0.94.0 → 0.95.0

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

@@ -597,30 +597,66 @@ export interface BetaCitationConfig {
 }
 
 export interface BetaCitationContentBlockLocation {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
   document_index: number;
 
   document_title: string | null;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
   file_id: string | null;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   type: 'content_block_location';
 }
 
 export interface BetaCitationContentBlockLocationParam {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
   document_index: number;
 
   document_title: string | null;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   type: 'content_block_location';
@@ -657,14 +693,40 @@ export interface BetaCitationPageLocationParam {
 }
 
 export interface BetaCitationSearchResultLocation {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
+  /**
+   * 0-based index of the cited search result among all `search_result` content
+   * blocks in the request, in the order they appear across messages and tool
+   * results.
+   *
+   * Counted separately from `document_index`; server-side web search results are not
+   * included in this count.
+   */
   search_result_index: number;
 
   source: string;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   title: string | null;
@@ -673,14 +735,40 @@ export interface BetaCitationSearchResultLocation {
 }
 
 export interface BetaCitationSearchResultLocationParam {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
+  /**
+   * 0-based index of the cited search result among all `search_result` content
+   * blocks in the request, in the order they appear across messages and tool
+   * results.
+   *
+   * Counted separately from `document_index`; server-side web search results are not
+   * included in this count.
+   */
   search_result_index: number;
 
   source: string;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   title: string | null;