@robota-sdk/agent-tools 3.0.0-beta.33 → 3.0.0-beta.34

package/README.md

@@ -46,16 +46,16 @@ const agent = new Robota({
 
 ## Built-in Tools (8)
 
-| 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          | 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                  |
 
 ## Tool Infrastructure
 
@@ -66,7 +66,31 @@ const agent = new Robota({
 | `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          |
+
+## TToolResult Shape
+
+```typescript
+interface TToolResult {
+  success: boolean;
+  output: string;
+  error?: string;
+  exitCode?: number;
+  startLine?: number; // Start line number of the edit in the original file (Edit tool only)
+}
+```
+
+`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
+
+| 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

@@ -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

@@ -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.33",
+  "version": "3.0.0-beta.34",
   "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.33"
+    "@robota-sdk/agent-core": "3.0.0-beta.34"
   },
   "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.33"
+    "@robota-sdk/agent-core": "3.0.0-beta.34"
   },
   "license": "MIT",
   "publishConfig": {