feat(client): adds support for code-execution-2025-08-26 tool

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-0f40955413f5d04b30ecd6c2f5002ce36a85c320cc671911ff70902fed6e342c.yml
-openapi_spec_hash: 92a37231c475ddfec0093718cd24f7ab
-config_hash: 21a1f78a64f751cc59c36f88095511cc
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-c150096acd4c91e98b0b888f5cb61e9c2d73c433f165f6fe343a8af50ff40daa.yml
+openapi_spec_hash: b0fc4933c9280be98c637752c5cb3acc
+config_hash: 6c2c7f9a9019f8299e3fa94c6ac190d1

src/Beta/BetaErrorResponse.php

@@ -11,6 +11,7 @@
 /**
  * @phpstan-type beta_error_response = array{
  *   error: BetaInvalidRequestError|BetaAuthenticationError|BetaBillingError|BetaPermissionError|BetaNotFoundError|BetaRateLimitError|BetaGatewayTimeoutError|BetaAPIError|BetaOverloadedError,
+ *   requestID: string|null,
  *   type: string,
  * }
  */
@@ -25,18 +26,21 @@ final class BetaErrorResponse implements BaseModel
     #[Api(union: BetaError::class)]
     public BetaInvalidRequestError|BetaAuthenticationError|BetaBillingError|BetaPermissionError|BetaNotFoundError|BetaRateLimitError|BetaGatewayTimeoutError|BetaAPIError|BetaOverloadedError $error;
 
+    #[Api('request_id')]
+    public ?string $requestID;
+
     /**
      * `new BetaErrorResponse()` is missing required properties by the API.
      *
      * To enforce required parameters use
      * ```
-     * BetaErrorResponse::with(error: ...)
+     * BetaErrorResponse::with(error: ..., requestID: ...)
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
-     * (new BetaErrorResponse)->withError(...)
+     * (new BetaErrorResponse)->withError(...)->withRequestID(...)
      * ```
      */
     public function __construct()
@@ -51,10 +55,12 @@ public function __construct()
      */
     public static function with(
         BetaInvalidRequestError|BetaAuthenticationError|BetaBillingError|BetaPermissionError|BetaNotFoundError|BetaRateLimitError|BetaGatewayTimeoutError|BetaAPIError|BetaOverloadedError $error,
+        ?string $requestID,
     ): self {
         $obj = new self;
 
         $obj->error = $error;
+        $obj->requestID = $requestID;
 
         return $obj;
     }
@@ -67,4 +73,12 @@ public function withError(
 
         return $obj;
     }
+
+    public function withRequestID(?string $requestID): self
+    {
+        $obj = clone $this;
+        $obj->requestID = $requestID;
+
+        return $obj;
+    }
 }

src/Beta/Messages/Batches/BatchCreateParams/Request/Params.php

@@ -7,6 +7,7 @@
 use Anthropic\Beta\Messages\Batches\BatchCreateParams\Request\Params\ServiceTier;
 use Anthropic\Beta\Messages\Batches\BatchCreateParams\Request\Params\System;
 use Anthropic\Beta\Messages\BetaCodeExecutionTool20250522;
+use Anthropic\Beta\Messages\BetaCodeExecutionTool20250825;
 use Anthropic\Beta\Messages\BetaMessageParam;
 use Anthropic\Beta\Messages\BetaMetadata;
 use Anthropic\Beta\Messages\BetaRequestMCPServerURLDefinition;
@@ -54,7 +55,7 @@
  *   temperature?: float|null,
  *   thinking?: null|BetaThinkingConfigEnabled|BetaThinkingConfigDisabled,
  *   toolChoice?: null|BetaToolChoiceAuto|BetaToolChoiceAny|BetaToolChoiceTool|BetaToolChoiceNone,
- *   tools?: list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305>|null,
+ *   tools?: list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaCodeExecutionTool20250825|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305>|null,
  *   topK?: int|null,
  *   topP?: float|null,
  * }
@@ -118,25 +119,7 @@ final class Params implements BaseModel
      * {"role": "user", "content": [{"type": "text", "text": "Hello, Claude"}]}
      * ```
      *
-     * Starting with Claude 3 models, you can also send image content blocks:
-     *
-     * ```json
-     * {"role": "user", "content": [
-     *   {
-     *     "type": "image",
-     *     "source": {
-     *       "type": "base64",
-     *       "media_type": "image/jpeg",
-     *       "data": "/9j/4AAQSkZJRg...",
-     *     }
-     *   },
-     *   {"type": "text", "text": "What is in this image?"}
-     * ]}
-     * ```
-     *
-     * We currently support the `base64` source type for images, and the `image/jpeg`, `image/png`, `image/gif`, and `image/webp` media types.
-     *
-     * See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for more input examples.
+     * See [input examples](https://docs.anthropic.com/en/api/messages-examples).
      *
      * Note that if you want to include a [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use the top-level `system` parameter — there is no `"system"` role for input messages in the Messages API.
      *
@@ -308,7 +291,7 @@ final class Params implements BaseModel
      *
      * See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
      *
-     * @var list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305>|null $tools
+     * @var list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaCodeExecutionTool20250825|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305>|null $tools
      */
     #[Api(list: BetaToolUnion::class, optional: true)]
     public ?array $tools;
@@ -363,7 +346,7 @@ public function __construct()
      * @param ServiceTier::* $serviceTier
      * @param list<string> $stopSequences
      * @param string|list<BetaTextBlockParam> $system
-     * @param list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305> $tools
+     * @param list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaCodeExecutionTool20250825|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305> $tools
      */
     public static function with(
         int $maxTokens,
@@ -465,25 +448,7 @@ public function withMaxTokens(int $maxTokens): self
      * {"role": "user", "content": [{"type": "text", "text": "Hello, Claude"}]}
      * ```
      *
-     * Starting with Claude 3 models, you can also send image content blocks:
-     *
-     * ```json
-     * {"role": "user", "content": [
-     *   {
-     *     "type": "image",
-     *     "source": {
-     *       "type": "base64",
-     *       "media_type": "image/jpeg",
-     *       "data": "/9j/4AAQSkZJRg...",
-     *     }
-     *   },
-     *   {"type": "text", "text": "What is in this image?"}
-     * ]}
-     * ```
-     *
-     * We currently support the `base64` source type for images, and the `image/jpeg`, `image/png`, `image/gif`, and `image/webp` media types.
-     *
-     * See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for more input examples.
+     * See [input examples](https://docs.anthropic.com/en/api/messages-examples).
      *
      * Note that if you want to include a [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use the top-level `system` parameter — there is no `"system"` role for input messages in the Messages API.
      *
@@ -713,7 +678,7 @@ public function withToolChoice(
      *
      * See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
      *
-     * @param list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305> $tools
+     * @param list<BetaTool|BetaToolBash20241022|BetaToolBash20250124|BetaCodeExecutionTool20250522|BetaCodeExecutionTool20250825|BetaToolComputerUse20241022|BetaToolComputerUse20250124|BetaToolTextEditor20241022|BetaToolTextEditor20250124|BetaToolTextEditor20250429|BetaToolTextEditor20250728|BetaWebSearchTool20250305> $tools
      */
     public function withTools(array $tools): self
     {

src/Beta/Messages/BetaBashCodeExecutionOutputBlock.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Anthropic\Beta\Messages;
+
+use Anthropic\Core\Attributes\Api;
+use Anthropic\Core\Concerns\SdkModel;
+use Anthropic\Core\Contracts\BaseModel;
+
+/**
+ * @phpstan-type beta_bash_code_execution_output_block = array{
+ *   fileID: string, type: string
+ * }
+ */
+final class BetaBashCodeExecutionOutputBlock implements BaseModel
+{
+    /** @use SdkModel<beta_bash_code_execution_output_block> */
+    use SdkModel;
+
+    #[Api]
+    public string $type = 'bash_code_execution_output';
+
+    #[Api('file_id')]
+    public string $fileID;
+
+    /**
+     * `new BetaBashCodeExecutionOutputBlock()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * BetaBashCodeExecutionOutputBlock::with(fileID: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new BetaBashCodeExecutionOutputBlock)->withFileID(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     */
+    public static function with(string $fileID): self
+    {
+        $obj = new self;
+
+        $obj->fileID = $fileID;
+
+        return $obj;
+    }
+
+    public function withFileID(string $fileID): self
+    {
+        $obj = clone $this;
+        $obj->fileID = $fileID;
+
+        return $obj;
+    }
+}

src/Beta/Messages/BetaBashCodeExecutionOutputBlockParam.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Anthropic\Beta\Messages;
+
+use Anthropic\Core\Attributes\Api;
+use Anthropic\Core\Concerns\SdkModel;
+use Anthropic\Core\Contracts\BaseModel;
+
+/**
+ * @phpstan-type beta_bash_code_execution_output_block_param = array{
+ *   fileID: string, type: string
+ * }
+ */
+final class BetaBashCodeExecutionOutputBlockParam implements BaseModel
+{
+    /** @use SdkModel<beta_bash_code_execution_output_block_param> */
+    use SdkModel;
+
+    #[Api]
+    public string $type = 'bash_code_execution_output';
+
+    #[Api('file_id')]
+    public string $fileID;
+
+    /**
+     * `new BetaBashCodeExecutionOutputBlockParam()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * BetaBashCodeExecutionOutputBlockParam::with(fileID: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new BetaBashCodeExecutionOutputBlockParam)->withFileID(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     */
+    public static function with(string $fileID): self
+    {
+        $obj = new self;
+
+        $obj->fileID = $fileID;
+
+        return $obj;
+    }
+
+    public function withFileID(string $fileID): self
+    {
+        $obj = clone $this;
+        $obj->fileID = $fileID;
+
+        return $obj;
+    }
+}