@robota-sdk/agent-tools 3.0.0-beta.2 → 3.0.0-beta.21

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/dist/node/index.cjs

@@ -276,6 +276,12 @@ function convertZodTypeToProperty(typeObj) {
         return { ...innerProperty, ...base };
       }
       throw new Error("ZodDefault is missing innerType; cannot convert to JSON schema.");
+    case "ZodRecord":
+      if (typeDef.valueType) {
+        const valueProperty = convertZodTypeToProperty(typeDef.valueType);
+        return { type: "object", additionalProperties: valueProperty, ...base };
+      }
+      return { type: "object", additionalProperties: { type: "string" }, ...base };
     default:
       throw new Error(`Unsupported Zod type: ${String(typeDef.typeName)}`);
   }
@@ -1012,7 +1018,7 @@ async function writeFileTool(args) {
     await (0, import_promises2.writeFile)(filePath, content, "utf8");
     const result = {
       success: true,
-      output: `Written ${content.length} bytes to ${filePath}`
+      output: `Written ${Buffer.byteLength(content, "utf8")} bytes to ${filePath}`
     };
     return JSON.stringify(result);
   } catch (err) {

package/dist/node/index.d.cts

@@ -86,6 +86,7 @@ interface IZodParseResult {
 interface IZodSchemaDef {
     typeName?: string;
     innerType?: IZodSchema;
+    valueType?: IZodSchema;
     checks?: Array<{
         kind: string;
         value?: TUniversalValue;

package/dist/node/index.d.ts

@@ -86,6 +86,7 @@ interface IZodParseResult {
 interface IZodSchemaDef {
     typeName?: string;
     innerType?: IZodSchema;
+    valueType?: IZodSchema;
     checks?: Array<{
         kind: string;
         value?: TUniversalValue;

package/dist/node/index.js

@@ -226,6 +226,12 @@ function convertZodTypeToProperty(typeObj) {
         return { ...innerProperty, ...base };
       }
       throw new Error("ZodDefault is missing innerType; cannot convert to JSON schema.");
+    case "ZodRecord":
+      if (typeDef.valueType) {
+        const valueProperty = convertZodTypeToProperty(typeDef.valueType);
+        return { type: "object", additionalProperties: valueProperty, ...base };
+      }
+      return { type: "object", additionalProperties: { type: "string" }, ...base };
     default:
       throw new Error(`Unsupported Zod type: ${String(typeDef.typeName)}`);
   }
@@ -962,7 +968,7 @@ async function writeFileTool(args) {
     await writeFile(filePath, content, "utf8");
     const result = {
       success: true,
-      output: `Written ${content.length} bytes to ${filePath}`
+      output: `Written ${Buffer.byteLength(content, "utf8")} bytes to ${filePath}`
     };
     return JSON.stringify(result);
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-tools",
-  "version": "3.0.0-beta.2",
+  "version": "3.0.0-beta.21",
   "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.2"
+    "@robota-sdk/agent-core": "3.0.0-beta.21"
   },
   "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.2"
+    "@robota-sdk/agent-core": "3.0.0-beta.21"
   },
   "license": "MIT",
   "publishConfig": {