@fairyhunter13/ai-anthropic 3.0.75-fork.4 → 3.0.75-fork.6

package/docs/05-anthropic.mdx

@@ -723,14 +723,31 @@ For more on prompt caching with Anthropic, see [Anthropic's Cache Control docume
 
 ### Bash Tool
 
-The Bash Tool allows running bash commands. Here's how to create and use it:
+The Bash Tool allows running bash commands. By default, the tool executes
+commands through the `sandbox` that you pass to `generateText` or `streamText`:
 
 ```ts
-const bashTool = anthropic.tools.bash_20250124({
-  execute: async ({ command, restart }) => {
-    // Implement your bash command execution logic here
-    // Return the result of the command execution
+import { anthropic } from '@ai-sdk/anthropic';
+import { generateText, isStepCount } from 'ai';
+
+const result = await generateText({
+  model: anthropic('claude-opus-4-7'),
+  tools: {
+    bash: anthropic.tools.bash_20250124(),
+  },
+  sandbox: {
+    description: 'A sandboxed shell environment.',
+    executeCommand: async ({ command }) => {
+      // Run the command in your sandbox and return the result.
+      return {
+        exitCode: 0,
+        stdout: `Executed: ${command}`,
+        stderr: '',
+      };
+    },
   },
+  stopWhen: isStepCount(2),
+  prompt: 'List the files in the current directory.',
 });
 ```
 
@@ -744,6 +761,9 @@ Parameters:
   Only certain Claude versions are supported.
 </Note>
 
+You can also provide a custom `execute` function when you want to handle bash
+execution directly instead of using the request sandbox.
+
 ### Memory Tool
 
 The [Memory Tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/memory-tool) allows Claude to use a local memory, e.g. in the filesystem.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairyhunter13/ai-anthropic",
-  "version": "3.0.75-fork.4",
+  "version": "3.0.75-fork.6",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -48,8 +48,8 @@
     }
   },
   "dependencies": {
-    "@fairyhunter13/ai-provider": "3.0.10-fork.11",
-    "@fairyhunter13/ai-provider-utils": "4.0.26-fork.11"
+    "@fairyhunter13/ai-provider": "3.0.10-fork.13",
+    "@fairyhunter13/ai-provider-utils": "4.0.26-fork.13"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "workspace:*",

package/src/tool/bash_20241022.ts

@@ -1,10 +1,26 @@
 import {
   createProviderDefinedToolFactory,
   lazySchema,
+  type ProviderDefinedTool,
+  type Sandbox,
+  type Tool,
+  type ToolExecuteFunction,
   zodSchema,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
+type Bash20241022Input = {
+  /**
+   * The bash command to run. Required unless the tool is being restarted.
+   */
+  command: string;
+
+  /**
+   * Specifying true will restart this tool. Otherwise, leave this unspecified.
+   */
+  restart?: boolean;
+};
+
 const bash_20241022InputSchema = lazySchema(() =>
   zodSchema(
     z.object({
@@ -14,20 +30,69 @@ const bash_20241022InputSchema = lazySchema(() =>
   ),
 );
 
-export const bash_20241022 = createProviderDefinedToolFactory<
-  {
-    /**
-     * The bash command to run. Required unless the tool is being restarted.
-     */
-    command: string;
-
-    /**
-     * Specifying true will restart this tool. Otherwise, leave this unspecified.
-     */
-    restart?: boolean;
-  },
+export const bash_20241022_internal = createProviderDefinedToolFactory<
+  Bash20241022Input,
   {}
 >({
   id: 'anthropic.bash_20241022',
   inputSchema: bash_20241022InputSchema,
 });
+
+type Bash20241022Options<OUTPUT> = {
+  execute?: ToolExecuteFunction<Bash20241022Input, OUTPUT, {}>;
+  needsApproval?: Tool<Bash20241022Input, OUTPUT, {}>['needsApproval'];
+  toModelOutput?: Tool<Bash20241022Input, OUTPUT, {}>['toModelOutput'];
+  onInputStart?: Tool<Bash20241022Input, OUTPUT, {}>['onInputStart'];
+  onInputDelta?: Tool<Bash20241022Input, OUTPUT, {}>['onInputDelta'];
+  onInputAvailable?: Tool<Bash20241022Input, OUTPUT, {}>['onInputAvailable'];
+};
+
+type Bash20241022OptionsWithNullableExecute<OUTPUT> = Omit<
+  Bash20241022Options<OUTPUT>,
+  'execute'
+> & {
+  execute?: Bash20241022Options<OUTPUT>['execute'] | null;
+};
+
+type Bash20241022DefaultOutput = Awaited<ReturnType<Sandbox['executeCommand']>>;
+
+export function bash_20241022(
+  options?: Omit<Bash20241022Options<Bash20241022DefaultOutput>, 'execute'> & {
+    execute?: undefined;
+  },
+): ProviderDefinedTool<Bash20241022Input, Bash20241022DefaultOutput, {}>;
+export function bash_20241022<OUTPUT = never>(
+  options: Omit<Bash20241022Options<OUTPUT>, 'execute'> & {
+    execute: null;
+  },
+): ProviderDefinedTool<Bash20241022Input, OUTPUT, {}>;
+export function bash_20241022<OUTPUT>(
+  options: Omit<Bash20241022Options<OUTPUT>, 'execute'> & {
+    execute: Bash20241022Options<OUTPUT>['execute'];
+  },
+): ProviderDefinedTool<Bash20241022Input, OUTPUT, {}>;
+export function bash_20241022<OUTPUT>(
+  options: Bash20241022OptionsWithNullableExecute<OUTPUT> = {},
+): ProviderDefinedTool<Bash20241022Input, OUTPUT, {}> {
+  const { execute, ...rest } = options;
+
+  if (execute === undefined) {
+    return bash_20241022_internal({
+      ...rest,
+      execute: async ({ command }, { sandbox }) => {
+        if (!sandbox) {
+          throw new Error('Sandbox is not available');
+        }
+
+        return await sandbox.executeCommand({ command });
+      },
+    } as Bash20241022Options<Bash20241022DefaultOutput>) as ReturnType<
+      typeof bash_20241022_internal<OUTPUT>
+    >;
+  }
+
+  return bash_20241022_internal({
+    ...rest,
+    ...(execute === null ? {} : { execute }),
+  } as Bash20241022Options<OUTPUT>);
+}

package/src/tool/bash_20250124.ts

@@ -1,10 +1,26 @@
 import {
   createProviderDefinedToolFactory,
   lazySchema,
+  type ProviderDefinedTool,
+  type Sandbox,
+  type Tool,
+  type ToolExecuteFunction,
   zodSchema,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
+type Bash20250124Input = {
+  /**
+   * The bash command to run. Required unless the tool is being restarted.
+   */
+  command: string;
+
+  /**
+   * Specifying true will restart this tool. Otherwise, leave this unspecified.
+   */
+  restart?: boolean;
+};
+
 const bash_20250124InputSchema = lazySchema(() =>
   zodSchema(
     z.object({
@@ -14,20 +30,69 @@ const bash_20250124InputSchema = lazySchema(() =>
   ),
 );
 
-export const bash_20250124 = createProviderDefinedToolFactory<
-  {
-    /**
-     * The bash command to run. Required unless the tool is being restarted.
-     */
-    command: string;
-
-    /**
-     * Specifying true will restart this tool. Otherwise, leave this unspecified.
-     */
-    restart?: boolean;
-  },
+export const bash_20250124_internal = createProviderDefinedToolFactory<
+  Bash20250124Input,
   {}
 >({
   id: 'anthropic.bash_20250124',
   inputSchema: bash_20250124InputSchema,
 });
+
+type Bash20250124Options<OUTPUT> = {
+  execute?: ToolExecuteFunction<Bash20250124Input, OUTPUT, {}>;
+  needsApproval?: Tool<Bash20250124Input, OUTPUT, {}>['needsApproval'];
+  toModelOutput?: Tool<Bash20250124Input, OUTPUT, {}>['toModelOutput'];
+  onInputStart?: Tool<Bash20250124Input, OUTPUT, {}>['onInputStart'];
+  onInputDelta?: Tool<Bash20250124Input, OUTPUT, {}>['onInputDelta'];
+  onInputAvailable?: Tool<Bash20250124Input, OUTPUT, {}>['onInputAvailable'];
+};
+
+type Bash20250124OptionsWithNullableExecute<OUTPUT> = Omit<
+  Bash20250124Options<OUTPUT>,
+  'execute'
+> & {
+  execute?: Bash20250124Options<OUTPUT>['execute'] | null;
+};
+
+type Bash20250124DefaultOutput = Awaited<ReturnType<Sandbox['executeCommand']>>;
+
+export function bash_20250124(
+  options?: Omit<Bash20250124Options<Bash20250124DefaultOutput>, 'execute'> & {
+    execute?: undefined;
+  },
+): ProviderDefinedTool<Bash20250124Input, Bash20250124DefaultOutput, {}>;
+export function bash_20250124<OUTPUT = never>(
+  options: Omit<Bash20250124Options<OUTPUT>, 'execute'> & {
+    execute: null;
+  },
+): ProviderDefinedTool<Bash20250124Input, OUTPUT, {}>;
+export function bash_20250124<OUTPUT>(
+  options: Omit<Bash20250124Options<OUTPUT>, 'execute'> & {
+    execute: Bash20250124Options<OUTPUT>['execute'];
+  },
+): ProviderDefinedTool<Bash20250124Input, OUTPUT, {}>;
+export function bash_20250124<OUTPUT>(
+  options: Bash20250124OptionsWithNullableExecute<OUTPUT> = {},
+): ProviderDefinedTool<Bash20250124Input, OUTPUT, {}> {
+  const { execute, ...rest } = options;
+
+  if (execute === undefined) {
+    return bash_20250124_internal({
+      ...rest,
+      execute: async ({ command }, { sandbox }) => {
+        if (!sandbox) {
+          throw new Error('Sandbox is not available');
+        }
+
+        return await sandbox.executeCommand({ command });
+      },
+    } as Bash20250124Options<Bash20250124DefaultOutput>) as ReturnType<
+      typeof bash_20250124_internal<OUTPUT>
+    >;
+  }
+
+  return bash_20250124_internal({
+    ...rest,
+    ...(execute === null ? {} : { execute }),
+  } as Bash20250124Options<OUTPUT>);
+}