@robota-sdk/agent-tools 3.0.0-beta.3 → 3.0.0-beta.5

package/README.md

@@ -1,90 +1,72 @@
 # @robota-sdk/agent-tools
 
-Tool registry, tool creation infrastructure, and built-in CLI tools for the Robota SDK. Provides everything needed to define custom tools with Zod schema validation and includes six ready-to-use file system tools.
+Tool registry, tool creation infrastructure, and 8 built-in CLI tools for the Robota SDK.
 
 ## Installation
 
 ```bash
 npm install @robota-sdk/agent-tools
-# or
-pnpm add @robota-sdk/agent-tools
 ```
 
+Peer dependency: `@robota-sdk/agent-core`
+
 ## Quick Start
 
-Create a custom tool with `createZodFunctionTool`:
+### Create a Tool with Zod
 
 ```typescript
-import { z } from 'zod';
 import { createZodFunctionTool } from '@robota-sdk/agent-tools';
+import { z } from 'zod';
 
 const weatherTool = createZodFunctionTool({
-  name: 'GetWeather',
+  name: 'get_weather',
   description: 'Get current weather for a city',
   schema: z.object({
     city: z.string().describe('City name'),
-    unit: z.enum(['celsius', 'fahrenheit']).default('celsius'),
   }),
-  execute: async ({ city, unit }) => {
-    // Your implementation here
-    return { temperature: 22, unit, city };
-  },
+  handler: async ({ city }) => ({
+    data: JSON.stringify({ city, temperature: 22, condition: 'sunny' }),
+  }),
 });
 ```
 
-## Built-in Tools
-
-Six CLI tools are included for file system operations:
-
-| Export      | Tool Name | Description                              |
-| ----------- | --------- | ---------------------------------------- |
-| `bashTool`  | `Bash`    | Execute shell commands via child_process |
-| `readTool`  | `Read`    | Read file contents with line numbers     |
-| `writeTool` | `Write`   | Write content to a file                  |
-| `editTool`  | `Edit`    | Replace a specific string in a file      |
-| `globTool`  | `Glob`    | Find files matching a glob pattern       |
-| `grepTool`  | `Grep`    | Search file contents with regex          |
+### Use Built-in Tools
 
 ```typescript
-import {
-  bashTool,
-  readTool,
-  writeTool,
-  editTool,
-  globTool,
-  grepTool,
-} from '@robota-sdk/agent-tools';
+import { bashTool, readTool, globTool, grepTool } from '@robota-sdk/agent-tools';
+import { Robota } from '@robota-sdk/agent-core';
+
+const agent = new Robota({
+  name: 'DevAgent',
+  aiProviders: [provider],
+  defaultModel: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
+  tools: [bashTool, readTool, globTool, grepTool],
+});
 ```
 
-Each tool implements `getName()`, `getDescription()`, `getSchema()`, and `execute()`.
+## Built-in Tools (8)
 
-## Tool Infrastructure
+| Export          | Tool Name | Description                          |
+| --------------- | --------- | ------------------------------------ |
+| `bashTool`      | Bash      | Execute shell commands               |
+| `readTool`      | Read      | Read file contents with line numbers |
+| `writeTool`     | Write     | Write content to a file              |
+| `editTool`      | Edit      | Replace a specific string in a file  |
+| `globTool`      | Glob      | Find files matching a glob pattern   |
+| `grepTool`      | Grep      | Search file contents with regex      |
+| `webFetchTool`  | WebFetch  | Fetch URL content (HTML-to-text)     |
+| `webSearchTool` | WebSearch | Web search via Brave Search API      |
 
-| Export                  | Description                                 |
-| ----------------------- | ------------------------------------------- |
-| `ToolRegistry`          | Central tool registration and schema lookup |
-| `FunctionTool`          | JS function tool with Zod schema validation |
-| `createFunctionTool`    | Factory for creating function tools         |
-| `createZodFunctionTool` | Factory with Zod validation and conversion  |
-| `OpenAPITool`           | Tool generated from OpenAPI specification   |
-| `zodToJsonSchema`       | Converts Zod schemas to JSON Schema format  |
-
-## TToolResult
-
-Built-in tools return results using the `TToolResult` type:
-
-```typescript
-interface TToolResult {
-  success: boolean;
-  output: string;
-  error?: string;
-  exitCode?: number;
-}
-```
-
-## Documentation
+## Tool Infrastructure
 
-See [docs/SPEC.md](./docs/SPEC.md) for the full specification, architecture details, and type ownership.
+| Export                  | Description                                            |
+| ----------------------- | ------------------------------------------------------ |
+| `ToolRegistry`          | Central tool registration and schema lookup            |
+| `FunctionTool`          | JS function tool with Zod schema validation            |
+| `createFunctionTool`    | Factory for creating function tools                    |
+| `createZodFunctionTool` | Factory with Zod validation and JSON Schema conversion |
+| `OpenAPITool`           | Tool generated from OpenAPI specification              |
+| `zodToJsonSchema`       | Converts Zod schemas to JSON Schema format             |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-tools",
-  "version": "3.0.0-beta.3",
+  "version": "3.0.0-beta.5",
   "description": "Tool registry and implementations for Robota SDK",
   "type": "module",
   "main": "dist/node/index.js",
@@ -26,7 +26,7 @@
     "zod": "^3.24.0"
   },
   "peerDependencies": {
-    "@robota-sdk/agent-core": "3.0.0-beta.3"
+    "@robota-sdk/agent-core": "3.0.0-beta.5"
   },
   "devDependencies": {
     "openapi-types": "^12.1.3",
@@ -34,7 +34,7 @@
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.6.1",
-    "@robota-sdk/agent-core": "3.0.0-beta.3"
+    "@robota-sdk/agent-core": "3.0.0-beta.5"
   },
   "license": "MIT",
   "publishConfig": {