feat!: Add computer use support in anthropic_sdk_dart (#586)

Author: davidmigloz

packages/anthropic_sdk_dart/README.md

@@ -106,6 +106,7 @@ await for (final res in stream) {
     },
     contentBlockStop: (ContentBlockStopEvent e) {},
     ping: (PingEvent e) {},
+    error: (ErrorEvent v) {},
   );
 }
 // Hello! It's nice to meet you. How are you doing today?
@@ -136,7 +137,7 @@ Map<String, dynamic> _getCurrentWeather(
 
 To do that, we need to provide the definition of the tool:
 ```dart
-const tool = Tool(
+const tool = Tool.custom(
   name: 'get_current_weather',
   description: 'Get the current weather in a given location',
   inputSchema: {
@@ -239,11 +240,50 @@ await for (final res in stream) {
     },
     contentBlockStop: (ContentBlockStopEvent v) {},
     ping: (PingEvent v) {},
+    error: (ErrorEvent v) {},
   );
 }
 // {"location": "Boston, MA", "unit": "fahrenheit"}
 ```
 
+### Computer use
+
+Claude 3.5 Sonnet model is capable of interacting with tools that can manipulate a computer desktop environment.
+
+Refer to the [official documentation](https://docs.anthropic.com/en/docs/build-with-claude/computer-use) for more information.
+
+Anthropic-defined tools:
+- `computer`: a tool that uses a mouse and keyboard to interact with a computer, and take screenshots.
+- `text_editor`: a tool for viewing, creating and editing files.
+- `bash`: a tool for running commands in a bash shell.
+
+Example:
+```dart
+const request = CreateMessageRequest(
+  model: Model.model(Models.claude35Sonnet20241022),
+  messages: [
+    Message(
+      role: MessageRole.user,
+      content: MessageContent.text(
+        'Save a picture of a cat to my desktop. '
+        'After each step, take a screenshot and carefully evaluate if you '
+            'have achieved the right outcome. Explicitly show your thinking: '
+            '"I have evaluated step X..." If not correct, try again. '
+            'Only when you confirm a step was executed correctly should '
+            'you move on to the next one.',
+      ),
+    ),
+  ],
+  tools: [
+    Tool.computerUse(displayWidthPx: 1024, displayHeightPx: 768),
+    Tool.textEditor(),
+    Tool.bash(),
+  ],
+  maxTokens: 1024,
+);
+final res = await client.createMessage(request: request);
+```
+
 ### Message Batches
 
 The Message Batches API is a powerful, cost-effective way to asynchronously process large volumes of Messages requests. This approach is well-suited to tasks that do not require immediate responses, reducing costs by 50% while increasing throughput.

packages/anthropic_sdk_dart/example/anthropic_sdk_dart_example.dart

@@ -59,6 +59,7 @@ Future<void> _createMessageStream(final AnthropicClient client) async {
       },
       contentBlockStop: (ContentBlockStopEvent e) {},
       ping: (PingEvent e) {},
+      error: (ErrorEvent e) {},
     );
   }
   // Hello! It's nice to meet you. How are you doing today?
@@ -161,6 +162,7 @@ Future<void> _toolUseStreaming(final AnthropicClient client) async {
       },
       contentBlockStop: (ContentBlockStopEvent v) {},
       ping: (PingEvent v) {},
+      error: (ErrorEvent v) {},
     );
   }
   // {"location": "Boston, MA", "unit": "fahrenheit"}
@@ -179,7 +181,7 @@ Map<String, dynamic> _getCurrentWeather(
   };
 }
 
-const tool = Tool(
+const tool = Tool.custom(
   name: 'get_current_weather',
   description: 'Get the current weather in a given location',
   inputSchema: {

packages/anthropic_sdk_dart/lib/src/client.dart

@@ -38,7 +38,9 @@ class AnthropicClient extends g.AnthropicClient {
           baseUrl: baseUrl,
           headers: {
             'anthropic-version': '2023-06-01',
-            'anthropic-beta': 'message-batches-2024-09-24',
+            'anthropic-beta': 'message-batches-2024-09-24,'
+                'prompt-caching-2024-07-31,'
+                'computer-use-2024-10-22',
             ...?headers,
           },
           queryParams: queryParams ?? const {},