chore(docs): small updates to descriptions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 130
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic/anthropic-6f50d4734ed3d091e593f0add6090591d197529834e3b15ccc83a70c88c2fc6d.yml
-openapi_spec_hash: d2deb0fef6a15bf53cc6c53f07973a54
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic/anthropic-c48ea225ef1d1685f19d56df1b647b69026a203fe6ad6cb913c832856d223418.yml
+openapi_spec_hash: e9c540d82f06430a4b554f73df4ef914
 config_hash: d335041db7fb23dedd07cf9ff13a1565

src/Beta/Messages/BetaRedactedThinkingBlock.php

@@ -22,6 +22,13 @@ final class BetaRedactedThinkingBlock implements BaseModel
     #[Required]
     public string $type = 'redacted_thinking';
 
+    /**
+     * The contents of this redacted thinking block, returned when portions of the model's thinking were safety-redacted. This field is opaque and encrypted, with no readable content.
+     *
+     * Pass `redacted_thinking` blocks back to the API unchanged when continuing a multi-turn conversation.
+     *
+     * See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#redacted-thinking-blocks) for details.
+     */
     #[Required]
     public string $data;
 
@@ -58,6 +65,13 @@ public static function with(string $data): self
         return $self;
     }
 
+    /**
+     * The contents of this redacted thinking block, returned when portions of the model's thinking were safety-redacted. This field is opaque and encrypted, with no readable content.
+     *
+     * Pass `redacted_thinking` blocks back to the API unchanged when continuing a multi-turn conversation.
+     *
+     * See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#redacted-thinking-blocks) for details.
+     */
     public function withData(string $data): self
     {
         $self = clone $this;

src/Beta/Messages/BetaRedactedThinkingBlockParam.php

@@ -22,6 +22,9 @@ final class BetaRedactedThinkingBlockParam implements BaseModel
     #[Required]
     public string $type = 'redacted_thinking';
 
+    /**
+     * The `data` value of this redacted thinking block, exactly as returned by the API in a previous response. Opaque and encrypted; pass it back unchanged.
+     */
     #[Required]
     public string $data;
 
@@ -58,6 +61,9 @@ public static function with(string $data): self
         return $self;
     }
 
+    /**
+     * The `data` value of this redacted thinking block, exactly as returned by the API in a previous response. Opaque and encrypted; pass it back unchanged.
+     */
     public function withData(string $data): self
     {
         $self = clone $this;

src/Beta/Messages/BetaSignatureDelta.php

@@ -22,6 +22,9 @@ final class BetaSignatureDelta implements BaseModel
     #[Required]
     public string $type = 'signature_delta';
 
+    /**
+     * The `signature` for this thinking block: an opaque value used to verify that the block was generated by Claude when it is passed back to the API. Delivered in a `signature_delta` event just before the block's `content_block_stop` event.
+     */
     #[Required]
     public string $signature;
 
@@ -58,6 +61,9 @@ public static function with(string $signature): self
         return $self;
     }
 
+    /**
+     * The `signature` for this thinking block: an opaque value used to verify that the block was generated by Claude when it is passed back to the API. Delivered in a `signature_delta` event just before the block's `content_block_stop` event.
+     */
     public function withSignature(string $signature): self
     {
         $self = clone $this;

src/Beta/Messages/BetaThinkingBlock.php

@@ -22,9 +22,19 @@ final class BetaThinkingBlock implements BaseModel
     #[Required]
     public string $type = 'thinking';
 
+    /**
+     * A value used to verify that this thinking block was generated by Claude when it is passed back to the API.
+     *
+     * This is an opaque field and should not be interpreted or parsed. When passing thinking blocks back to the API (required when using tools with extended thinking), pass them back exactly as received, with this field intact.
+     *
+     * See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) for details.
+     */
     #[Required]
     public string $signature;
 
+    /**
+     * The text of Claude's thinking process for this block.
+     */
     #[Required]
     public string $thinking;
 
@@ -62,6 +72,13 @@ public static function with(string $signature, string $thinking): self
         return $self;
     }
 
+    /**
+     * A value used to verify that this thinking block was generated by Claude when it is passed back to the API.
+     *
+     * This is an opaque field and should not be interpreted or parsed. When passing thinking blocks back to the API (required when using tools with extended thinking), pass them back exactly as received, with this field intact.
+     *
+     * See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) for details.
+     */
     public function withSignature(string $signature): self
     {
         $self = clone $this;
@@ -70,6 +87,9 @@ public function withSignature(string $signature): self
         return $self;
     }
 
+    /**
+     * The text of Claude's thinking process for this block.
+     */
     public function withThinking(string $thinking): self
     {
         $self = clone $this;

src/Beta/Messages/BetaThinkingBlockParam.php

@@ -22,9 +22,17 @@ final class BetaThinkingBlockParam implements BaseModel
     #[Required]
     public string $type = 'thinking';
 
+    /**
+     * The `signature` value of this thinking block, exactly as returned by the API in a previous response. Used to verify that the block was generated by Claude.
+     *
+     * Thinking blocks must be passed back unmodified and in their original order; a modified block results in a 400 `invalid_request_error`.
+     */
     #[Required]
     public string $signature;
 
+    /**
+     * The `thinking` text of this block as returned by the API.
+     */
     #[Required]
     public string $thinking;
 
@@ -62,6 +70,11 @@ public static function with(string $signature, string $thinking): self
         return $self;
     }
 
+    /**
+     * The `signature` value of this thinking block, exactly as returned by the API in a previous response. Used to verify that the block was generated by Claude.
+     *
+     * Thinking blocks must be passed back unmodified and in their original order; a modified block results in a 400 `invalid_request_error`.
+     */
     public function withSignature(string $signature): self
     {
         $self = clone $this;
@@ -70,6 +83,9 @@ public function withSignature(string $signature): self
         return $self;
     }
 
+    /**
+     * The `thinking` text of this block as returned by the API.
+     */
     public function withThinking(string $thinking): self
     {
         $self = clone $this;

src/Beta/Messages/BetaThinkingDelta.php

@@ -28,6 +28,9 @@ final class BetaThinkingDelta implements BaseModel
     #[Required('estimated_tokens')]
     public ?int $estimatedTokens;
 
+    /**
+     * The incremental `thinking` text for this content block. Concatenate the `thinking` values of successive `thinking_delta` events to assemble the block's full `thinking` value.
+     */
     #[Required]
     public string $thinking;
 
@@ -76,6 +79,9 @@ public function withEstimatedTokens(?int $estimatedTokens): self
         return $self;
     }
 
+    /**
+     * The incremental `thinking` text for this content block. Concatenate the `thinking` values of successive `thinking_delta` events to assemble the block's full `thinking` value.
+     */
     public function withThinking(string $thinking): self
     {
         $self = clone $this;

src/Messages/RedactedThinkingBlock.php

@@ -22,6 +22,13 @@ final class RedactedThinkingBlock implements BaseModel
     #[Required]
     public string $type = 'redacted_thinking';
 
+    /**
+     * The contents of this redacted thinking block, returned when portions of the model's thinking were safety-redacted. This field is opaque and encrypted, with no readable content.
+     *
+     * Pass `redacted_thinking` blocks back to the API unchanged when continuing a multi-turn conversation.
+     *
+     * See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#redacted-thinking-blocks) for details.
+     */
     #[Required]
     public string $data;
 
@@ -58,6 +65,13 @@ public static function with(string $data): self
         return $self;
     }
 
+    /**
+     * The contents of this redacted thinking block, returned when portions of the model's thinking were safety-redacted. This field is opaque and encrypted, with no readable content.
+     *
+     * Pass `redacted_thinking` blocks back to the API unchanged when continuing a multi-turn conversation.
+     *
+     * See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#redacted-thinking-blocks) for details.
+     */
     public function withData(string $data): self
     {
         $self = clone $this;

src/Messages/RedactedThinkingBlockParam.php

@@ -22,6 +22,9 @@ final class RedactedThinkingBlockParam implements BaseModel
     #[Required]
     public string $type = 'redacted_thinking';
 
+    /**
+     * The `data` value of this redacted thinking block, exactly as returned by the API in a previous response. Opaque and encrypted; pass it back unchanged.
+     */
     #[Required]
     public string $data;
 
@@ -58,6 +61,9 @@ public static function with(string $data): self
         return $self;
     }
 
+    /**
+     * The `data` value of this redacted thinking block, exactly as returned by the API in a previous response. Opaque and encrypted; pass it back unchanged.
+     */
     public function withData(string $data): self
     {
         $self = clone $this;

src/Messages/SignatureDelta.php

@@ -22,6 +22,9 @@ final class SignatureDelta implements BaseModel
     #[Required]
     public string $type = 'signature_delta';
 
+    /**
+     * The `signature` for this thinking block: an opaque value used to verify that the block was generated by Claude when it is passed back to the API. Delivered in a `signature_delta` event just before the block's `content_block_stop` event.
+     */
     #[Required]
     public string $signature;
 
@@ -58,6 +61,9 @@ public static function with(string $signature): self
         return $self;
     }
 
+    /**
+     * The `signature` for this thinking block: an opaque value used to verify that the block was generated by Claude when it is passed back to the API. Delivered in a `signature_delta` event just before the block's `content_block_stop` event.
+     */
     public function withSignature(string $signature): self
     {
         $self = clone $this;