@defai.digital/ax-cli 3.15.26 → 4.0.0

package/dist/tools/definitions/search.js

@@ -0,0 +1,159 @@
+/**
+ * Search Tool Definition - Claude Code Quality
+ *
+ * Unified search tool for finding text content or files in the codebase.
+ */
+export const searchTool = {
+    name: 'search',
+    displayName: 'Search',
+    description: `Unified search tool for finding text content or files in the codebase.
+
+This tool combines text search (like grep/ripgrep) and file search (like find) into a single interface. It's powered by ripgrep for fast, accurate results.
+
+Use this tool instead of bash grep/find/rg commands. It's faster, safer, and integrated with the agent workflow.
+
+Search types:
+- "text": Search file CONTENTS for matching text/patterns
+- "files": Search file NAMES/PATHS matching pattern
+- "both": Search both content and file names (default)
+
+Results are sorted by relevance and common directories like node_modules are excluded by default.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search pattern. Can be literal text or regex (set regex: true).',
+                examples: ['TODO', 'function.*export', 'class UserService', '*.test.ts'],
+            },
+            search_type: {
+                type: 'string',
+                enum: ['text', 'files', 'both'],
+                description: 'Type of search. "text" for content, "files" for names, "both" for both.',
+                default: 'both',
+            },
+            include_pattern: {
+                type: 'string',
+                description: 'Glob pattern for files to include. Example: "*.ts", "src/**/*.js"',
+                examples: ['*.ts', '*.{js,jsx}', 'src/**/*'],
+            },
+            exclude_pattern: {
+                type: 'string',
+                description: 'Glob pattern for files to exclude. Example: "*.log", "node_modules"',
+                examples: ['*.log', 'node_modules', 'dist', '*.min.js'],
+            },
+            case_sensitive: {
+                type: 'boolean',
+                description: 'Whether search is case-sensitive.',
+                default: false,
+            },
+            whole_word: {
+                type: 'boolean',
+                description: 'Match whole words only.',
+                default: false,
+            },
+            regex: {
+                type: 'boolean',
+                description: 'Treat query as regular expression.',
+                default: false,
+            },
+            max_results: {
+                type: 'number',
+                description: 'Maximum results to return.',
+                default: 50,
+                constraints: ['Must be between 1 and 500'],
+            },
+            file_types: {
+                type: 'array',
+                description: 'File extensions to search (without dot). Example: ["ts", "js", "py"]',
+                examples: [['ts', 'tsx'], ['py'], ['js', 'jsx', 'ts', 'tsx']],
+                items: {
+                    type: 'string',
+                },
+            },
+            include_hidden: {
+                type: 'boolean',
+                description: 'Include hidden files (starting with dot).',
+                default: false,
+            },
+        },
+        required: ['query'],
+    },
+    usageNotes: [
+        'Always use this instead of bash grep/find/rg',
+        'Default search_type "both" searches content AND file names',
+        'Use include_pattern to narrow down to specific file types',
+        'Common patterns:',
+        '  - Find function: search("function myFunction")',
+        '  - Find files: search("*.test.ts", { search_type: "files" })',
+        '  - Find in specific files: search("TODO", { include_pattern: "*.ts" })',
+        'For complex regex, set regex: true',
+        'Results are sorted by relevance',
+        'node_modules and common build directories are excluded by default',
+        'Use file_types for common extensions instead of include_pattern',
+    ],
+    constraints: [
+        'Does not search binary files',
+        'node_modules excluded by default',
+        'Max 500 results per search',
+        'Very large files may be partially searched',
+        'Regex patterns must be valid ripgrep syntax',
+    ],
+    antiPatterns: [
+        'Using bash grep instead of search',
+        'Using bash find instead of search',
+        'Using bash rg instead of search',
+        'Searching without specifying file types for large codebases',
+    ],
+    examples: [
+        {
+            description: 'Find TODO comments',
+            scenario: 'Locate all TODO items in the codebase',
+            input: { query: 'TODO', search_type: 'text' },
+            expectedBehavior: 'Returns all lines containing TODO with file paths and line numbers',
+        },
+        {
+            description: 'Find test files',
+            scenario: 'Locate all test files in the project',
+            input: { query: '*.test.ts', search_type: 'files' },
+            expectedBehavior: 'Returns paths to all .test.ts files',
+        },
+        {
+            description: 'Find function definition',
+            scenario: 'Locate where a specific function is defined',
+            input: {
+                query: 'function processPayment',
+                search_type: 'text',
+                include_pattern: '*.ts',
+            },
+            expectedBehavior: 'Returns file and line where processPayment is defined',
+        },
+        {
+            description: 'Find class usage with regex',
+            scenario: 'Find all instantiations of a class',
+            input: {
+                query: 'new UserService\\(',
+                regex: true,
+                search_type: 'text',
+            },
+            expectedBehavior: 'Returns all places where UserService is instantiated',
+        },
+        {
+            description: 'Search in specific file types',
+            scenario: 'Find imports in TypeScript files only',
+            input: {
+                query: "import.*from 'react'",
+                regex: true,
+                file_types: ['ts', 'tsx'],
+            },
+            expectedBehavior: 'Returns all React imports in TypeScript files',
+        },
+    ],
+    tokenCost: 550,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['search'],
+    alternatives: [],
+    relatedTools: ['view_file'],
+};
+//# sourceMappingURL=search.js.map

package/dist/tools/definitions/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/tools/definitions/search.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/str-replace-editor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * String Replace Editor Tool Definition - Claude Code Quality
+ *
+ * Edit files with precise string replacement.
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const strReplaceEditorTool: ToolDefinition;

package/dist/tools/definitions/str-replace-editor.js

@@ -0,0 +1,145 @@
+/**
+ * String Replace Editor Tool Definition - Claude Code Quality
+ *
+ * Edit files with precise string replacement.
+ */
+export const strReplaceEditorTool = {
+    name: 'str_replace_editor',
+    displayName: 'String Replace Editor',
+    description: `Edit files with precise string replacement.
+
+This tool performs exact string matching and replacement within files. It's the primary way to modify existing files safely and precisely.
+
+The replacement is EXACT - the old_str must match the file content character-for-character, including whitespace and indentation. If old_str appears multiple times and replace_all is false (default), the operation fails to prevent unintended changes.
+
+IMPORTANT: Always use view_file to read the file first before editing. This ensures you have the exact current content and correct indentation.
+
+When copying text from view_file output, ignore the line number prefix. The format is: spaces + line number + tab + actual content. Copy only the content after the tab.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Path to the file to edit. Must exist.',
+                format: 'file-path',
+            },
+            old_str: {
+                type: 'string',
+                description: `Text to replace. Must match EXACTLY including:
+- Whitespace (spaces, tabs)
+- Line endings
+- Indentation
+Include enough context to make the match unique. For multi-line replacements, include complete lines.`,
+                examples: [
+                    'const x = 1;',
+                    'function processData(input) {\n  return input;\n}',
+                ],
+            },
+            new_str: {
+                type: 'string',
+                description: 'Replacement text. Must be different from old_str. Preserve original indentation style.',
+                examples: [
+                    'const x = 2;',
+                    'function processData(input) {\n  // Validate input\n  if (!input) return null;\n  return input;\n}',
+                ],
+            },
+            replace_all: {
+                type: 'boolean',
+                description: 'Replace ALL occurrences instead of failing on duplicates. Use for variable/function renaming.',
+                default: false,
+            },
+        },
+        required: ['path', 'old_str', 'new_str'],
+    },
+    usageNotes: [
+        'ALWAYS view_file first to see current content and indentation',
+        'Match indentation exactly - copy from the file, do not assume',
+        'Include enough surrounding context to make old_str unique:',
+        '  - Bad: "return true;"  (likely appears multiple times)',
+        '  - Good: "function validate(x) {\\n  return true;\\n}"',
+        'For multiple changes to the same file, use multi_edit instead',
+        'Use replace_all: true for renaming across file (variables, functions, etc.)',
+        'Preserve the coding style of the file (tabs vs spaces, semicolons, etc.)',
+        'When editing code from view_file output, ignore the line number prefix',
+        'The line number format is: spaces + line number + tab + actual content',
+        'For large multi-line changes, include the entire block to replace',
+    ],
+    constraints: [
+        'File must exist (cannot create new files - use create_file)',
+        'old_str must exist in the file',
+        'old_str must be unique unless replace_all is true',
+        'new_str must be different from old_str',
+        'Must read file with view_file before editing',
+        'Cannot use for creating new files (use create_file)',
+    ],
+    antiPatterns: [
+        'Editing without reading the file first',
+        'Using bash sed/awk for editing',
+        'Making multiple separate edits when multi_edit would work',
+        'Guessing indentation instead of copying from file',
+        'Using very short old_str that may not be unique',
+        'Trying to create a file (use create_file instead)',
+    ],
+    examples: [
+        {
+            description: 'Fix a simple bug',
+            scenario: 'Change a value in the code',
+            input: {
+                path: '/project/src/config.ts',
+                old_str: 'const MAX_RETRIES = 3;',
+                new_str: 'const MAX_RETRIES = 5;',
+            },
+            expectedBehavior: 'Updates the constant value',
+        },
+        {
+            description: 'Rename a variable across file',
+            scenario: 'Rename a variable consistently',
+            input: {
+                path: '/project/src/utils.ts',
+                old_str: 'userData',
+                new_str: 'userProfile',
+                replace_all: true,
+            },
+            expectedBehavior: 'Renames all occurrences of userData to userProfile',
+        },
+        {
+            description: 'Add error handling to a function',
+            scenario: 'Wrap existing code with try-catch',
+            input: {
+                path: '/project/src/api.ts',
+                old_str: `async function fetchData(url) {
+  const response = await fetch(url);
+  return response.json();
+}`,
+                new_str: `async function fetchData(url) {
+  try {
+    const response = await fetch(url);
+    return response.json();
+  } catch (error) {
+    console.error('Fetch failed:', error);
+    throw error;
+  }
+}`,
+            },
+            expectedBehavior: 'Adds try-catch around the function body',
+        },
+        {
+            description: 'Add import statement',
+            scenario: 'Add a new import at the top of a file',
+            input: {
+                path: '/project/src/utils.ts',
+                old_str: "import { existingImport } from './existing';",
+                new_str: `import { existingImport } from './existing';
+import { newImport } from './new';`,
+            },
+            expectedBehavior: 'Adds new import after existing one',
+        },
+    ],
+    tokenCost: 600,
+    safetyLevel: 'moderate',
+    requiresConfirmation: false,
+    categories: ['file-operations'],
+    alternatives: ['multi_edit', 'create_file'],
+    relatedTools: ['view_file', 'multi_edit'],
+};
+//# sourceMappingURL=str-replace-editor.js.map

package/dist/tools/definitions/str-replace-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"str-replace-editor.js","sourceRoot":"","sources":["../../../src/tools/definitions/str-replace-editor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,uBAAuB;IAEpC,WAAW,EAAE;;;;;;;;yKAQ0J;IAEvK,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;gBACpD,MAAM,EAAE,WAAW;aACpB;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;sGAIiF;gBAC9F,QAAQ,EAAE;oBACR,cAAc;oBACd,mDAAmD;iBACpD;aACF;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wFAAwF;gBAC1F,QAAQ,EAAE;oBACR,cAAc;oBACd,oGAAoG;iBACrG;aACF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,+FAA+F;gBACjG,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;KACzC;IAED,UAAU,EAAE;QACV,+DAA+D;QAC/D,+DAA+D;QAC/D,4DAA4D;QAC5D,0DAA0D;QAC1D,yDAAyD;QACzD,+DAA+D;QAC/D,6EAA6E;QAC7E,0EAA0E;QAC1E,wEAAwE;QACxE,wEAAwE;QACxE,mEAAmE;KACpE;IAED,WAAW,EAAE;QACX,6DAA6D;QAC7D,gCAAgC;QAChC,mDAAmD;QACnD,wCAAwC;QACxC,8CAA8C;QAC9C,qDAAqD;KACtD;IAED,YAAY,EAAE;QACZ,wCAAwC;QACxC,gCAAgC;QAChC,2DAA2D;QAC3D,mDAAmD;QACnD,iDAAiD;QACjD,mDAAmD;KACpD;IAED,QAAQ,EAAE;QACR;YACE,WAAW,EAAE,kBAAkB;YAC/B,QAAQ,EAAE,4BAA4B;YACtC,KAAK,EAAE;gBACL,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,wBAAwB;gBACjC,OAAO,EAAE,wBAAwB;aAClC;YACD,gBAAgB,EAAE,4BAA4B;SAC/C;QACD;YACE,WAAW,EAAE,+BAA+B;YAC5C,QAAQ,EAAE,gCAAgC;YAC1C,KAAK,EAAE;gBACL,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,aAAa;gBACtB,WAAW,EAAE,IAAI;aAClB;YACD,gBAAgB,EAAE,oDAAoD;SACvE;QACD;YACE,WAAW,EAAE,kCAAkC;YAC/C,QAAQ,EAAE,mCAAmC;YAC7C,KAAK,EAAE;gBACL,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE;;;EAGf;gBACM,OAAO,EAAE;;;;;;;;EAQf;aACK;YACD,gBAAgB,EAAE,yCAAyC;SAC5D;QACD;YACE,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,uCAAuC;YACjD,KAAK,EAAE;gBACL,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,8CAA8C;gBACvD,OAAO,EAAE;mCACkB;aAC5B;YACD,gBAAgB,EAAE,oCAAoC;SACvD;KACF;IAED,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,UAAU;IACvB,oBAAoB,EAAE,KAAK;IAE3B,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,YAAY,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;IAC3C,YAAY,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;CAC1C,CAAC"}

package/dist/tools/definitions/todo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Todo Tools Definition - Claude Code Quality
+ *
+ * Create and update task lists for planning and tracking work.
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const createTodoListTool: ToolDefinition;
+export declare const updateTodoListTool: ToolDefinition;

package/dist/tools/definitions/todo.js

@@ -0,0 +1,261 @@
+/**
+ * Todo Tools Definition - Claude Code Quality
+ *
+ * Create and update task lists for planning and tracking work.
+ */
+export const createTodoListTool = {
+    name: 'create_todo_list',
+    displayName: 'Create Todo List',
+    description: `Create a structured task list for planning and tracking work.
+
+Use this tool for complex tasks that require multiple steps. It helps you:
+- Plan work systematically
+- Track progress visibly
+- Communicate status to the user
+- Stay organized on multi-step tasks
+
+WHEN TO USE:
+- Tasks with 3+ distinct steps
+- Complex features requiring planning
+- User explicitly requests a todo list
+- Multiple independent tasks to complete
+
+WHEN NOT TO USE:
+- Single, simple tasks
+- Tasks completable in 1-2 steps
+- Purely informational questions
+
+Create the todo list at the START of a multi-step task, then use update_todo_list as you complete each item.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            todos: {
+                type: 'array',
+                description: 'Array of todo items to create',
+                items: {
+                    type: 'object',
+                    properties: {
+                        id: {
+                            type: 'string',
+                            description: 'Unique identifier (e.g., "1", "auth-1", "step-1")',
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'Clear, actionable task description',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['pending', 'in_progress', 'completed'],
+                            description: 'Current status. Start most as "pending", one as "in_progress"',
+                        },
+                        priority: {
+                            type: 'string',
+                            enum: ['high', 'medium', 'low'],
+                            description: 'Task priority for ordering',
+                        },
+                    },
+                    required: ['id', 'content', 'status', 'priority'],
+                },
+            },
+        },
+        required: ['todos'],
+    },
+    usageNotes: [
+        'Create todos at the START of a multi-step task',
+        'Have exactly ONE task as in_progress at any time',
+        'Mark tasks completed IMMEDIATELY when done (do not batch)',
+        'Tasks should be specific and actionable:',
+        '  - Bad: "Fix bugs"',
+        '  - Good: "Fix null pointer in UserService.getUser()"',
+        'Use priority to indicate execution order',
+        'Each task needs content (what) and could have notes (how)',
+        'Update todo list as you complete each task with update_todo_list',
+    ],
+    constraints: [
+        'Do not create todos for single simple tasks',
+        'Only one task should be in_progress at a time',
+        'Task IDs must be unique',
+        'Mark completed immediately, not in batches',
+    ],
+    antiPatterns: [
+        'Creating todos for trivial single-step tasks',
+        'Having multiple tasks in_progress simultaneously',
+        'Batching completion updates instead of updating immediately',
+        'Using vague task descriptions',
+    ],
+    examples: [
+        {
+            description: 'Plan a feature implementation',
+            scenario: 'User asks to add dark mode to the app',
+            input: {
+                todos: [
+                    {
+                        id: '1',
+                        content: 'Add theme context and provider',
+                        status: 'in_progress',
+                        priority: 'high',
+                    },
+                    {
+                        id: '2',
+                        content: 'Create dark mode CSS variables',
+                        status: 'pending',
+                        priority: 'high',
+                    },
+                    {
+                        id: '3',
+                        content: 'Add toggle component to settings',
+                        status: 'pending',
+                        priority: 'medium',
+                    },
+                    {
+                        id: '4',
+                        content: 'Persist theme preference',
+                        status: 'pending',
+                        priority: 'medium',
+                    },
+                    {
+                        id: '5',
+                        content: 'Test theme switching',
+                        status: 'pending',
+                        priority: 'low',
+                    },
+                ],
+            },
+            expectedBehavior: 'Creates a todo list with planned implementation steps',
+        },
+        {
+            description: 'Plan bug fix investigation',
+            scenario: 'User reports a complex bug to fix',
+            input: {
+                todos: [
+                    {
+                        id: '1',
+                        content: 'Reproduce the bug locally',
+                        status: 'in_progress',
+                        priority: 'high',
+                    },
+                    {
+                        id: '2',
+                        content: 'Identify root cause',
+                        status: 'pending',
+                        priority: 'high',
+                    },
+                    {
+                        id: '3',
+                        content: 'Implement fix',
+                        status: 'pending',
+                        priority: 'high',
+                    },
+                    {
+                        id: '4',
+                        content: 'Add regression test',
+                        status: 'pending',
+                        priority: 'medium',
+                    },
+                ],
+            },
+            expectedBehavior: 'Creates a todo list for bug investigation and fix',
+        },
+    ],
+    tokenCost: 700,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['task-management'],
+    alternatives: [],
+    relatedTools: ['update_todo_list'],
+};
+export const updateTodoListTool = {
+    name: 'update_todo_list',
+    displayName: 'Update Todo List',
+    description: `Update status or content of existing todo items.
+
+Use this to mark tasks complete, update status, or modify task descriptions as work progresses.
+
+IMPORTANT: Update todos IMMEDIATELY when completing a task - do not batch updates. When marking a task complete, also set the next task to in_progress.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            updates: {
+                type: 'array',
+                description: 'Array of updates to apply',
+                items: {
+                    type: 'object',
+                    properties: {
+                        id: {
+                            type: 'string',
+                            description: 'ID of the todo item to update',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['pending', 'in_progress', 'completed'],
+                            description: 'New status',
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'New content (optional)',
+                        },
+                        priority: {
+                            type: 'string',
+                            enum: ['high', 'medium', 'low'],
+                            description: 'New priority (optional)',
+                        },
+                    },
+                    required: ['id'],
+                },
+            },
+        },
+        required: ['updates'],
+    },
+    usageNotes: [
+        'Update status IMMEDIATELY when completing a task',
+        'When marking complete, also set next task to in_progress',
+        'Do not batch status updates - update as you complete',
+        'Only one task should be in_progress at a time',
+        'Can update content if task scope changes',
+        'Can update priority if priorities shift',
+    ],
+    constraints: [
+        'Task ID must exist in the todo list',
+        'Do not batch multiple completions',
+        'Keep exactly one task in_progress',
+    ],
+    antiPatterns: [
+        'Waiting to batch completion updates',
+        'Having zero or multiple in_progress tasks',
+        'Updating tasks that do not exist',
+    ],
+    examples: [
+        {
+            description: 'Complete a task and start next',
+            scenario: 'Finished first task, moving to second',
+            input: {
+                updates: [
+                    { id: '1', status: 'completed' },
+                    { id: '2', status: 'in_progress' },
+                ],
+            },
+            expectedBehavior: 'Marks task 1 complete and task 2 in progress',
+        },
+        {
+            description: 'Update task content',
+            scenario: 'Task scope changed during work',
+            input: {
+                updates: [
+                    {
+                        id: '3',
+                        content: 'Add toggle component with animation',
+                        priority: 'high',
+                    },
+                ],
+            },
+            expectedBehavior: 'Updates task content and priority',
+        },
+    ],
+    tokenCost: 400,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['task-management'],
+    alternatives: [],
+    relatedTools: ['create_todo_list'],
+};
+//# sourceMappingURL=todo.js.map

package/dist/tools/definitions/todo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.js","sourceRoot":"","sources":["../../../src/tools/definitions/todo.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/view-file.d.ts

@@ -0,0 +1,7 @@
+/**
+ * View File Tool Definition - Claude Code Quality
+ *
+ * Read and display file contents or directory listings.
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const viewFileTool: ToolDefinition;