@compilr-dev/agents 0.3.16 → 0.3.18

package/dist/tools/builtin/read-file.js

@@ -19,8 +19,8 @@ const DEFAULT_MAX_CONTENT_SIZE = 100 * 1024;
 export const readFileTool = defineTool({
     name: 'read_file',
     readonly: true,
-    description: 'Read the contents of a file. Returns the file content as text. ' +
-        'Use maxLines and startLine to read specific portions of large files.',
+    // Original: 'Read the contents of a file. Returns the file content as text. Use maxLines and startLine to read specific portions of large files.'
+    description: 'Read file contents. Use maxLines/startLine for large files.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -30,7 +30,8 @@ export const readFileTool = defineTool({
             },
             encoding: {
                 type: 'string',
-                description: 'File encoding (default: utf-8)',
+                description: 'File encoding',
+                default: 'utf-8',
             },
             maxLines: {
                 type: 'number',
@@ -139,30 +140,8 @@ export function createReadFileTool(options) {
     return defineTool({
         name: 'read_file',
         readonly: true,
-        description: 'Read the contents of a file. Returns the file content as text. ' +
-            'Use maxLines and startLine to read specific portions of large files.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Absolute or relative path to the file',
-                },
-                encoding: {
-                    type: 'string',
-                    description: 'File encoding (default: utf-8)',
-                },
-                maxLines: {
-                    type: 'number',
-                    description: 'Maximum number of lines to read',
-                },
-                startLine: {
-                    type: 'number',
-                    description: 'Line number to start reading from (1-indexed)',
-                },
-            },
-            required: ['path'],
-        },
+        description: readFileTool.definition.description,
+        inputSchema: readFileTool.definition.inputSchema,
         execute: async (input) => {
             const { baseDir, allowedExtensions, maxFileSize, maxContentSize, truncateIfLarge } = options ?? {};
             let filePath = input.path;

package/dist/tools/builtin/recall-result.js

@@ -12,9 +12,8 @@ export function createRecallResultTool(options) {
     const { store, onEvent } = options;
     return defineTool({
         name: 'recall_full_result',
-        description: 'Retrieve the full output of a previously delegated tool result. ' +
-            'Use when a summary is insufficient and you need the complete data. ' +
-            'Results expire after 10 minutes.',
+        // Original: 'Retrieve the full output of a previously delegated tool result. Use when a summary is insufficient and you need the complete data. Results expire after 10 minutes.'
+        description: 'Retrieve full output of a delegated tool result. Results expire after 10 minutes.',
         inputSchema: {
             type: 'object',
             properties: {

package/dist/tools/builtin/suggest.js

@@ -15,11 +15,8 @@ import { defineTool, createSuccessResult } from '../define.js';
  */
 export const suggestTool = defineTool({
     name: 'suggest',
-    description: 'Suggest a next action for the user. The suggestion appears as ghost text in the input prompt. ' +
-        'Use this after completing a task to guide the user toward a logical next step. ' +
-        'Good suggestions are actionable, specific, and follow naturally from what you just did. ' +
-        'Examples: "run npm test to verify the fix", "review the changes in src/index.ts", ' +
-        '"commit the changes with git commit". Only suggest when there is a clear, helpful next step.',
+    // Original: 'Suggest a next action for the user. The suggestion appears as ghost text in the input prompt. Use this after completing a task to guide the user toward a logical next step. Good suggestions are actionable, specific, and follow naturally from what you just did. Examples: "run npm test to verify the fix", "review the changes in src/index.ts", "commit the changes with git commit". Only suggest when there is a clear, helpful next step.'
+    description: 'Suggest a next action as ghost text in the input prompt. Use after completing a task.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -61,25 +58,8 @@ export function createSuggestTool(options = {}) {
     const { onSuggest } = options;
     return defineTool({
         name: 'suggest',
-        description: 'Suggest a next action for the user. The suggestion appears as ghost text in the input prompt. ' +
-            'Use this after completing a task to guide the user toward a logical next step. ' +
-            'Good suggestions are actionable, specific, and follow naturally from what you just did. ' +
-            'Examples: "run npm test to verify the fix", "review the changes in src/index.ts", ' +
-            '"commit the changes with git commit". Only suggest when there is a clear, helpful next step.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: {
-                    type: 'string',
-                    description: 'The suggested action or command for the user to take next',
-                },
-                reason: {
-                    type: 'string',
-                    description: 'Brief explanation of why this action is suggested (optional)',
-                },
-            },
-            required: ['action'],
-        },
+        description: suggestTool.definition.description,
+        inputSchema: suggestTool.definition.inputSchema,
         execute: (input) => {
             // Emit the suggest event if handler is configured
             if (onSuggest) {

package/dist/tools/builtin/todo.js

@@ -158,10 +158,9 @@ const defaultStore = new TodoStore();
  */
 export const todoWriteTool = defineTool({
     name: 'todo_write',
-    description: 'Update the SESSION todo list (shown in CLI footer). These are ephemeral tasks for the current session only - ' +
-        'NOT persistent backlog items. For persistent project backlog, use workitem_* tools. ' +
-        'Provide the complete list to replace current todos. ' +
-        'Use blockedBy to declare task dependencies (1-based positions in the array).',
+    // Original: 'Update the SESSION todo list (shown in CLI footer). These are ephemeral tasks for the current session only - NOT persistent backlog items. For persistent project backlog, use workitem_* tools. Provide the complete list to replace current todos. Use blockedBy to declare task dependencies (1-based positions in the array).'
+    description: 'Replace the session todo list (ephemeral, shown in footer). ' +
+        'For persistent backlog, use workitem_* tools.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -229,8 +228,8 @@ export const todoWriteTool = defineTool({
 export const todoReadTool = defineTool({
     name: 'todo_read',
     readonly: true,
-    description: 'Get the SESSION todo list (shown in CLI footer). These are ephemeral session tasks - ' +
-        'for persistent project backlog, use workitem_query. Optionally filter by status or owner.',
+    // Original: 'Get the SESSION todo list (shown in CLI footer). These are ephemeral session tasks - for persistent project backlog, use workitem_query. Optionally filter by status or owner.'
+    description: 'Get the session todo list. For persistent backlog, use workitem_query.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -241,7 +240,8 @@ export const todoReadTool = defineTool({
             },
             includeCompleted: {
                 type: 'boolean',
-                description: 'Include completed tasks (default: true)',
+                description: 'Include completed tasks',
+                default: true,
             },
             owner: {
                 type: 'string',
@@ -291,9 +291,7 @@ export function createTodoTools(store) {
     const todoStore = store ?? new TodoStore();
     const todoWrite = defineTool({
         name: 'todo_write',
-        description: 'Update the SESSION todo list (shown in CLI footer). These are ephemeral tasks for the current session only - ' +
-            'NOT persistent backlog items. For persistent project backlog, use workitem_* tools. ' +
-            'Use blockedBy to declare task dependencies (1-based positions in the array).',
+        description: todoWriteTool.definition.description,
         inputSchema: {
             type: 'object',
             properties: {
@@ -342,8 +340,7 @@ export function createTodoTools(store) {
     const todoRead = defineTool({
         name: 'todo_read',
         readonly: true,
-        description: 'Get the SESSION todo list (shown in CLI footer). These are ephemeral session tasks - ' +
-            'for persistent project backlog, use workitem_query.',
+        description: todoReadTool.definition.description,
         inputSchema: {
             type: 'object',
             properties: {
@@ -395,7 +392,8 @@ export function createTodoTools(store) {
     });
     const todoClaim = defineTool({
         name: 'todo_claim',
-        description: 'Claim an unassigned SESSION todo (from CLI footer). For persistent backlog items, use workitem_claim.',
+        // Original: 'Claim an unassigned SESSION todo (from CLI footer). For persistent backlog items, use workitem_claim.'
+        description: 'Claim an unassigned session todo. For persistent items, use workitem_claim.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -436,8 +434,8 @@ export function createTodoTools(store) {
     });
     const todoHandoff = defineTool({
         name: 'todo_handoff',
-        description: 'Hand off a SESSION todo (from CLI footer) to another agent. ' +
-            'For persistent backlog items, use workitem_handoff.',
+        // Original: 'Hand off a SESSION todo (from CLI footer) to another agent. For persistent backlog items, use workitem_handoff.'
+        description: 'Hand off a session todo to another agent. For persistent items, use workitem_handoff.',
         inputSchema: {
             type: 'object',
             properties: {

package/dist/tools/builtin/web-fetch.js

@@ -18,9 +18,8 @@ const DEFAULT_MAX_SIZE = 100 * 1024;
 export const webFetchTool = defineTool({
     name: 'web_fetch',
     readonly: true,
-    description: 'Fetch content from a URL. Returns the page content as text. ' +
-        'Use for retrieving documentation, API responses, or web pages. ' +
-        'HTTP URLs are automatically upgraded to HTTPS.',
+    // Original: 'Fetch content from a URL. Returns the page content as text. Use for retrieving documentation, API responses, or web pages. HTTP URLs are automatically upgraded to HTTPS.'
+    description: 'Fetch content from a URL and return as text.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -35,11 +34,13 @@ export const webFetchTool = defineTool({
             },
             timeout: {
                 type: 'number',
-                description: 'Request timeout in milliseconds (default: 30000)',
+                description: 'Request timeout in milliseconds',
+                default: 30000,
             },
             maxSize: {
                 type: 'number',
-                description: 'Maximum content size to return in bytes (default: 102400)',
+                description: 'Maximum content size to return in bytes',
+                default: 102400,
             },
         },
         required: ['url'],
@@ -170,9 +171,7 @@ export function createWebFetchTool(options) {
     return defineTool({
         name: 'web_fetch',
         readonly: true,
-        description: 'Fetch content from a URL. Returns the page content as text. ' +
-            'Use for retrieving documentation, API responses, or web pages. ' +
-            'HTTP URLs are automatically upgraded to HTTPS.',
+        description: webFetchTool.definition.description,
         inputSchema: {
             type: 'object',
             properties: {
@@ -187,11 +186,13 @@ export function createWebFetchTool(options) {
                 },
                 timeout: {
                     type: 'number',
-                    description: `Request timeout in milliseconds (default: ${String(defaultTimeout)})`,
+                    description: 'Request timeout in milliseconds',
+                    default: defaultTimeout,
                 },
                 maxSize: {
                     type: 'number',
-                    description: `Maximum content size to return in bytes (default: ${String(defaultMaxSize)})`,
+                    description: 'Maximum content size to return in bytes',
+                    default: defaultMaxSize,
                 },
             },
             required: ['url'],

package/dist/tools/builtin/write-file.js

@@ -10,8 +10,8 @@ import { isNodeError, isExtensionAllowed } from './utils.js';
  */
 export const writeFileTool = defineTool({
     name: 'write_file',
-    description: 'Write content to a file. Creates the file if it does not exist. ' +
-        'Use append: true to add to existing content instead of overwriting.',
+    // Original: 'Write content to a file. Creates the file if it does not exist. Use append: true to add to existing content instead of overwriting.'
+    description: 'Write content to a file, creating it if needed.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -25,15 +25,18 @@ export const writeFileTool = defineTool({
             },
             encoding: {
                 type: 'string',
-                description: 'File encoding (default: utf-8)',
+                description: 'File encoding',
+                default: 'utf-8',
             },
             createDirs: {
                 type: 'boolean',
-                description: 'Create parent directories if needed (default: true)',
+                description: 'Create parent directories if needed',
+                default: true,
             },
             append: {
                 type: 'boolean',
-                description: 'Append to file instead of overwriting (default: false)',
+                description: 'Append to file instead of overwriting',
+                default: false,
             },
         },
         required: ['path', 'content'],
@@ -86,34 +89,8 @@ async function executeWriteFile(input) {
 export function createWriteFileTool(options) {
     return defineTool({
         name: 'write_file',
-        description: 'Write content to a file. Creates the file if it does not exist. ' +
-            'Use append: true to add to existing content instead of overwriting.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Absolute or relative path to the file',
-                },
-                content: {
-                    type: 'string',
-                    description: 'Content to write to the file',
-                },
-                encoding: {
-                    type: 'string',
-                    description: 'File encoding (default: utf-8)',
-                },
-                createDirs: {
-                    type: 'boolean',
-                    description: 'Create parent directories if needed (default: true)',
-                },
-                append: {
-                    type: 'boolean',
-                    description: 'Append to file instead of overwriting (default: false)',
-                },
-            },
-            required: ['path', 'content'],
-        },
+        description: writeFileTool.definition.description,
+        inputSchema: writeFileTool.definition.inputSchema,
         execute: async (input) => {
             const { baseDir, allowedExtensions, maxContentSize = 10 * 1024 * 1024, blockedPaths = [], } = options ?? {};
             let filePath = input.path;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "Lightweight multi-LLM agent library for building CLI AI assistants",
   "type": "module",
   "main": "dist/index.js",
@@ -43,7 +43,7 @@
     "anthropic"
   ],
   "author": "Carmelo Scozzola",
-  "license": "MIT",
+  "license": "FSL-1.1-MIT",
   "bugs": {
     "url": "https://github.com/compilr-dev/agents/issues"
   },