@robota-sdk/agent-tools 3.0.0-beta.4 → 3.0.0-beta.44

package/README.md

@@ -1,77 +1,76 @@
 # @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 via `child_process.spawn` |
+| `readTool`      | Read      | Read file contents with line numbers (cat -n)    |
+| `writeTool`     | Write     | Write content to a file (creates parent dirs)    |
+| `editTool`      | Edit      | Replace a specific string in a file              |
+| `globTool`      | Glob      | Find files matching a glob pattern (fast-glob)   |
+| `grepTool`      | Grep      | Search file contents with regex patterns         |
+| `webFetchTool`  | WebFetch  | Fetch URL content (HTML-to-text conversion)      |
+| `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  |
+## Tool Infrastructure
 
-## TToolResult
+| 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              |
+| `createOpenAPITool`     | Factory for creating OpenAPI tools                     |
+| `zodToJsonSchema`       | Converts Zod schemas to JSON Schema format             |
+| `TToolResult`           | Result type for built-in CLI tool invocations          |
 
-Built-in tools return results using the `TToolResult` type:
+## TToolResult Shape
 
 ```typescript
 interface TToolResult {
@@ -79,12 +78,19 @@ interface TToolResult {
   output: string;
   error?: string;
   exitCode?: number;
+  startLine?: number; // Start line number of the edit in the original file (Edit tool only)
 }
 ```
 
-## Documentation
+`TToolResult` is the inner result type used by built-in tools. It is serialized to JSON and placed inside the `IToolResult.data` field before being returned to the Robota execution loop.
+
+## Dependencies
 
-See [docs/SPEC.md](./docs/SPEC.md) for the full specification, architecture details, and type ownership.
+| Dependency               | Kind | Purpose                                                |
+| ------------------------ | ---- | ------------------------------------------------------ |
+| `@robota-sdk/agent-core` | Peer | Abstract tool base class, tool interfaces, event types |
+| `fast-glob`              | Prod | High-performance glob matching for the Glob tool       |
+| `zod`                    | Prod | Schema validation for function tool parameters         |
 
 ## License
 

package/dist/node/index.cjs

@@ -1018,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) {
@@ -1096,9 +1096,12 @@ async function editFileTool(args) {
     return JSON.stringify(result2);
   }
   const count = replaceAll ? content.split(oldString).length - 1 : 1;
+  const matchIdx = content.indexOf(oldString);
+  const startLine = matchIdx >= 0 ? content.substring(0, matchIdx).split("\n").length : 1;
   const result = {
     success: true,
-    output: `Replaced ${count} occurrence(s) in ${filePath}`
+    output: `Replaced ${count} occurrence(s) in ${filePath}`,
+    startLine
   };
   return JSON.stringify(result);
 }

package/dist/node/index.d.cts

@@ -8,6 +8,8 @@ interface TToolResult {
     output: string;
     error?: string;
     exitCode?: number;
+    /** Start line number of the edit in the original file (Edit tool only) */
+    startLine?: number;
 }
 
 /**

package/dist/node/index.d.ts

@@ -8,6 +8,8 @@ interface TToolResult {
     output: string;
     error?: string;
     exitCode?: number;
+    /** Start line number of the edit in the original file (Edit tool only) */
+    startLine?: number;
 }
 
 /**

package/dist/node/index.js

@@ -968,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) {
@@ -1046,9 +1046,12 @@ async function editFileTool(args) {
     return JSON.stringify(result2);
   }
   const count = replaceAll ? content.split(oldString).length - 1 : 1;
+  const matchIdx = content.indexOf(oldString);
+  const startLine = matchIdx >= 0 ? content.substring(0, matchIdx).split("\n").length : 1;
   const result = {
     success: true,
-    output: `Replaced ${count} occurrence(s) in ${filePath}`
+    output: `Replaced ${count} occurrence(s) in ${filePath}`,
+    startLine
   };
   return JSON.stringify(result);
 }

package/package.json

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