feat(api): add support for disabling tool calls (#701)

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic-129d8719c17bc9ea6e310a63400f60e7ad3ef828e54265eb8a8035684187210b.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic-fd7537a41646cd9253c04f350436c5471e4762750fce8ca8f1909a3052d98608.yml

api.md

@@ -79,6 +79,7 @@ Types:
 - <code><a href="./src/resources/messages/messages.ts">ToolChoice</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ToolChoiceAny</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ToolChoiceAuto</a></code>
+- <code><a href="./src/resources/messages/messages.ts">ToolChoiceNone</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ToolChoiceTool</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ToolResultBlockParam</a></code>
 - <code><a href="./src/resources/messages/messages.ts">ToolTextEditor20250124</a></code>
@@ -212,6 +213,7 @@ Types:
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolChoice</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolChoiceAny</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolChoiceAuto</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaToolChoiceNone</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolChoiceTool</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolComputerUse20241022</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolComputerUse20250124</a></code>

src/index.ts

@@ -96,6 +96,7 @@ import {
   ToolChoice,
   ToolChoiceAny,
   ToolChoiceAuto,
+  ToolChoiceNone,
   ToolChoiceTool,
   ToolResultBlockParam,
   ToolTextEditor20250124,
@@ -408,6 +409,7 @@ export declare namespace Anthropic {
     type ToolChoice as ToolChoice,
     type ToolChoiceAny as ToolChoiceAny,
     type ToolChoiceAuto as ToolChoiceAuto,
+    type ToolChoiceNone as ToolChoiceNone,
     type ToolChoiceTool as ToolChoiceTool,
     type ToolResultBlockParam as ToolResultBlockParam,
     type ToolTextEditor20250124 as ToolTextEditor20250124,

src/resources/beta/beta.ts

@@ -56,6 +56,7 @@ import {
   BetaToolChoice,
   BetaToolChoiceAny,
   BetaToolChoiceAuto,
+  BetaToolChoiceNone,
   BetaToolChoiceTool,
   BetaToolComputerUse20241022,
   BetaToolComputerUse20250124,
@@ -242,6 +243,7 @@ export declare namespace Beta {
     type BetaToolChoice as BetaToolChoice,
     type BetaToolChoiceAny as BetaToolChoiceAny,
     type BetaToolChoiceAuto as BetaToolChoiceAuto,
+    type BetaToolChoiceNone as BetaToolChoiceNone,
     type BetaToolChoiceTool as BetaToolChoiceTool,
     type BetaToolComputerUse20241022 as BetaToolComputerUse20241022,
     type BetaToolComputerUse20250124 as BetaToolComputerUse20250124,

src/resources/beta/index.ts

@@ -69,6 +69,7 @@ export {
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,
+  type BetaToolChoiceNone,
   type BetaToolChoiceTool,
   type BetaToolComputerUse20241022,
   type BetaToolComputerUse20250124,

src/resources/beta/messages/index.ts

@@ -72,6 +72,7 @@ export {
   type BetaToolChoice,
   type BetaToolChoiceAny,
   type BetaToolChoiceAuto,
+  type BetaToolChoiceNone,
   type BetaToolChoiceTool,
   type BetaToolComputerUse20241022,
   type BetaToolComputerUse20250124,

src/resources/beta/messages/messages.ts

@@ -701,9 +701,9 @@ export interface BetaToolBash20250124 {
 
 /**
  * How the model should use the provided tools. The model can use a specific tool,
- * any available tool, or decide by itself.
+ * any available tool, decide by itself, or not use tools at all.
  */
-export type BetaToolChoice = BetaToolChoiceAuto | BetaToolChoiceAny | BetaToolChoiceTool;
+export type BetaToolChoice = BetaToolChoiceAuto | BetaToolChoiceAny | BetaToolChoiceTool | BetaToolChoiceNone;
 
 /**
  * The model will use any available tools.
@@ -735,6 +735,13 @@ export interface BetaToolChoiceAuto {
   disable_parallel_tool_use?: boolean;
 }
 
+/**
+ * The model will not be allowed to use tools.
+ */
+export interface BetaToolChoiceNone {
+  type: 'none';
+}
+
 /**
  * The model will use the specified tool with `tool_choice.name`.
  */
@@ -1088,7 +1095,7 @@ export interface MessageCreateParamsBase {
 
   /**
    * Body param: How the model should use the provided tools. The model can use a
-   * specific tool, any available tool, or decide by itself.
+   * specific tool, any available tool, decide by itself, or not use tools at all.
    */
   tool_choice?: BetaToolChoice;
 
@@ -1344,7 +1351,7 @@ export interface MessageCountTokensParams {
 
   /**
    * Body param: How the model should use the provided tools. The model can use a
-   * specific tool, any available tool, or decide by itself.
+   * specific tool, any available tool, decide by itself, or not use tools at all.
    */
   tool_choice?: BetaToolChoice;
 
@@ -1491,6 +1498,7 @@ export declare namespace Messages {
     type BetaToolChoice as BetaToolChoice,
     type BetaToolChoiceAny as BetaToolChoiceAny,
     type BetaToolChoiceAuto as BetaToolChoiceAuto,
+    type BetaToolChoiceNone as BetaToolChoiceNone,
     type BetaToolChoiceTool as BetaToolChoiceTool,
     type BetaToolComputerUse20241022 as BetaToolComputerUse20241022,
     type BetaToolComputerUse20250124 as BetaToolComputerUse20250124,

src/resources/index.ts

@@ -86,6 +86,7 @@ export {
   type ToolChoice,
   type ToolChoiceAny,
   type ToolChoiceAuto,
+  type ToolChoiceNone,
   type ToolChoiceTool,
   type ToolResultBlockParam,
   type ToolTextEditor20250124,

src/resources/messages/index.ts

@@ -76,6 +76,7 @@ export {
   type ToolChoice,
   type ToolChoiceAny,
   type ToolChoiceAuto,
+  type ToolChoiceNone,
   type ToolChoiceTool,
   type ToolResultBlockParam,
   type ToolTextEditor20250124,

src/resources/messages/messages.ts

@@ -696,9 +696,9 @@ export interface ToolBash20250124 {
 
 /**
  * How the model should use the provided tools. The model can use a specific tool,
- * any available tool, or decide by itself.
+ * any available tool, decide by itself, or not use tools at all.
  */
-export type ToolChoice = ToolChoiceAuto | ToolChoiceAny | ToolChoiceTool;
+export type ToolChoice = ToolChoiceAuto | ToolChoiceAny | ToolChoiceTool | ToolChoiceNone;
 
 /**
  * The model will use any available tools.
@@ -730,6 +730,13 @@ export interface ToolChoiceAuto {
   disable_parallel_tool_use?: boolean;
 }
 
+/**
+ * The model will not be allowed to use tools.
+ */
+export interface ToolChoiceNone {
+  type: 'none';
+}
+
 /**
  * The model will use the specified tool with `tool_choice.name`.
  */
@@ -1006,7 +1013,7 @@ export interface MessageCreateParamsBase {
 
   /**
    * How the model should use the provided tools. The model can use a specific tool,
-   * any available tool, or decide by itself.
+   * any available tool, decide by itself, or not use tools at all.
    */
   tool_choice?: ToolChoice;
 
@@ -1277,7 +1284,7 @@ export interface MessageCountTokensParams {
 
   /**
    * How the model should use the provided tools. The model can use a specific tool,
-   * any available tool, or decide by itself.
+   * any available tool, decide by itself, or not use tools at all.
    */
   tool_choice?: ToolChoice;
 
@@ -1420,6 +1427,7 @@ export declare namespace Messages {
     type ToolChoice as ToolChoice,
     type ToolChoiceAny as ToolChoiceAny,
     type ToolChoiceAuto as ToolChoiceAuto,
+    type ToolChoiceNone as ToolChoiceNone,
     type ToolChoiceTool as ToolChoiceTool,
     type ToolResultBlockParam as ToolResultBlockParam,
     type ToolTextEditor20250124 as ToolTextEditor20250124,