@defai.digital/ax-cli 3.15.26 → 4.0.0

package/dist/tools/definitions/view-file.js

@@ -0,0 +1,111 @@
+/**
+ * View File Tool Definition - Claude Code Quality
+ *
+ * Read and display file contents or directory listings.
+ */
+export const viewFileTool = {
+    name: 'view_file',
+    displayName: 'View File',
+    description: `Read and display file contents or directory listings.
+
+This tool reads files from the local filesystem and displays their contents with line numbers. It can also list directory contents when given a directory path.
+
+For files:
+- Displays content with line numbers (1-indexed)
+- Supports partial reading with start_line/end_line
+- Handles text files, images, PDFs, and Jupyter notebooks
+- Lines over 2000 characters are truncated
+
+For directories:
+- Lists files and subdirectories
+- Shows file types and sizes
+- Respects .gitignore patterns
+
+IMPORTANT: Always use this tool to read a file BEFORE attempting to edit it. This ensures you have the exact current content and correct indentation for str_replace_editor.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Absolute or relative path to file or directory. Use absolute paths for reliability.',
+                format: 'file-path',
+                examples: ['/project/src/index.ts', 'package.json', './src/'],
+            },
+            start_line: {
+                type: 'number',
+                description: 'Starting line number for partial file view (1-indexed). Only for files.',
+                constraints: ['Must be >= 1', 'Must be <= end_line if end_line is specified'],
+            },
+            end_line: {
+                type: 'number',
+                description: 'Ending line number for partial file view (inclusive). Only for files.',
+                constraints: ['Must be >= start_line'],
+            },
+        },
+        required: ['path'],
+    },
+    usageNotes: [
+        'ALWAYS read a file before attempting to edit it with str_replace_editor',
+        'Use absolute paths for reliability across different working directories',
+        'For large files, use start_line/end_line to read specific sections',
+        'When viewing a directory, returns a listing instead of contents',
+        'Supports various file types:',
+        '  - Text files: displayed with line numbers',
+        '  - Images (PNG, JPG, etc.): displayed visually',
+        '  - PDFs: extracted text and visual content',
+        '  - Jupyter notebooks (.ipynb): cells with outputs',
+        '  - Binary files: shows file type information',
+        'Line numbers in output start at 1, matching editor conventions',
+        'Empty files return a system reminder warning',
+        'When editing code from view_file output, copy the exact content after the line number prefix',
+    ],
+    constraints: [
+        'Cannot modify files (use str_replace_editor or create_file)',
+        'Do not view potentially sensitive files unless necessary:',
+        '  - .env files with secrets',
+        '  - credential files',
+        '  - private keys',
+        'Lines over 2000 characters are truncated',
+        'Maximum default read is 2000 lines from start',
+    ],
+    antiPatterns: [
+        'Using bash cat/head/tail instead of view_file',
+        'Modifying files (use str_replace_editor instead)',
+        'Creating files (use create_file instead)',
+        'Viewing binary files expecting text content',
+        'Editing without reading first',
+    ],
+    examples: [
+        {
+            description: 'Read entire file',
+            scenario: 'Understand a source file before editing',
+            input: { path: '/project/src/utils.ts' },
+            expectedBehavior: 'Returns file contents with line numbers',
+        },
+        {
+            description: 'Read specific lines',
+            scenario: 'Focus on a particular function or section',
+            input: { path: '/project/src/utils.ts', start_line: 50, end_line: 75 },
+            expectedBehavior: 'Returns lines 50-75 with line numbers',
+        },
+        {
+            description: 'List directory contents',
+            scenario: 'Explore project structure',
+            input: { path: '/project/src/' },
+            expectedBehavior: 'Returns listing of files and directories',
+        },
+        {
+            description: 'Read package.json',
+            scenario: 'Check project dependencies and scripts',
+            input: { path: 'package.json' },
+            expectedBehavior: 'Returns package.json contents',
+        },
+    ],
+    tokenCost: 500,
+    safetyLevel: 'safe',
+    requiresConfirmation: false,
+    categories: ['file-operations'],
+    alternatives: [],
+    relatedTools: ['str_replace_editor', 'create_file', 'search'],
+};
+//# sourceMappingURL=view-file.js.map

package/dist/tools/definitions/view-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-file.js","sourceRoot":"","sources":["../../../src/tools/definitions/view-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,WAAW;IAExB,WAAW,EAAE;;;;;;;;;;;;;;;6KAe8J;IAE3K,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qFAAqF;gBACvF,MAAM,EAAE,WAAW;gBACnB,QAAQ,EAAE,CAAC,uBAAuB,EAAE,cAAc,EAAE,QAAQ,CAAC;aAC9D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yEAAyE;gBAC3E,WAAW,EAAE,CAAC,cAAc,EAAE,8CAA8C,CAAC;aAC9E;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uEAAuE;gBACzE,WAAW,EAAE,CAAC,uBAAuB,CAAC;aACvC;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IAED,UAAU,EAAE;QACV,yEAAyE;QACzE,yEAAyE;QACzE,oEAAoE;QACpE,iEAAiE;QACjE,8BAA8B;QAC9B,6CAA6C;QAC7C,iDAAiD;QACjD,6CAA6C;QAC7C,oDAAoD;QACpD,+CAA+C;QAC/C,gEAAgE;QAChE,8CAA8C;QAC9C,8FAA8F;KAC/F;IAED,WAAW,EAAE;QACX,6DAA6D;QAC7D,2DAA2D;QAC3D,6BAA6B;QAC7B,sBAAsB;QACtB,kBAAkB;QAClB,0CAA0C;QAC1C,+CAA+C;KAChD;IAED,YAAY,EAAE;QACZ,+CAA+C;QAC/C,kDAAkD;QAClD,0CAA0C;QAC1C,6CAA6C;QAC7C,+BAA+B;KAChC;IAED,QAAQ,EAAE;QACR;YACE,WAAW,EAAE,kBAAkB;YAC/B,QAAQ,EAAE,yCAAyC;YACnD,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE;YACxC,gBAAgB,EAAE,yCAAyC;SAC5D;QACD;YACE,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,2CAA2C;YACrD,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YACtE,gBAAgB,EAAE,uCAAuC;SAC1D;QACD;YACE,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,2BAA2B;YACrC,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;YAChC,gBAAgB,EAAE,0CAA0C;SAC7D;QACD;YACE,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,wCAAwC;YAClD,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;YAC/B,gBAAgB,EAAE,+BAA+B;SAClD;KACF;IAED,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,MAAM;IACnB,oBAAoB,EAAE,KAAK;IAE3B,UAAU,EAAE,CAAC,iBAAiB,CAAC;IAC/B,YAAY,EAAE,EAAE;IAChB,YAAY,EAAE,CAAC,oBAAoB,EAAE,aAAa,EAAE,QAAQ,CAAC;CAC9D,CAAC"}

package/dist/tools/format-generators.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Format Generators for Tool Definitions
+ *
+ * Converts rich ToolDefinition objects to various output formats:
+ * - OpenAI function calling format
+ * - Anthropic tool format
+ * - System prompt sections
+ *
+ * These are DERIVED formats - the ToolDefinition is the source of truth.
+ */
+import type { ToolDefinition, AnthropicTool } from './types.js';
+import type { LLMTool } from '../llm/client.js';
+/**
+ * Generate a compact description suitable for API calls
+ *
+ * The compact description is the first paragraph plus key constraints
+ * for dangerous tools.
+ */
+export declare function generateCompactDescription(tool: ToolDefinition): string;
+/**
+ * Convert rich ToolDefinition to OpenAI function calling format
+ *
+ * This is a DERIVED format for API calls. The full tool details
+ * should be provided in the system prompt.
+ */
+export declare function toOpenAIFormat(tool: ToolDefinition): LLMTool;
+/**
+ * Convert rich ToolDefinition to Anthropic tool format
+ */
+export declare function toAnthropicFormat(tool: ToolDefinition): AnthropicTool;
+/**
+ * Generate a full system prompt section for a tool
+ *
+ * This includes all the rich metadata: description, parameters,
+ * usage notes, constraints, anti-patterns, and examples.
+ */
+export declare function toSystemPromptSection(tool: ToolDefinition): string;
+/**
+ * Generate the complete tool instructions section for system prompt
+ *
+ * @param tools - Array of tool definitions
+ * @returns Formatted markdown string with all tool documentation
+ */
+export declare function generateToolInstructions(tools: ToolDefinition[]): string;
+/**
+ * Calculate total token cost for a set of tools
+ *
+ * Useful for budget planning and deciding which tools to include
+ */
+export declare function calculateTotalTokenCost(tools: ToolDefinition[]): number;
+/**
+ * Filter tools by category
+ */
+export declare function filterByCategory(tools: ToolDefinition[], categories: string[]): ToolDefinition[];
+/**
+ * Filter tools by safety level
+ */
+export declare function filterBySafetyLevel(tools: ToolDefinition[], levels: Array<'safe' | 'moderate' | 'dangerous'>): ToolDefinition[];
+/**
+ * Get tools that require confirmation
+ */
+export declare function getToolsRequiringConfirmation(tools: ToolDefinition[]): ToolDefinition[];

package/dist/tools/format-generators.js

@@ -0,0 +1,291 @@
+/**
+ * Format Generators for Tool Definitions
+ *
+ * Converts rich ToolDefinition objects to various output formats:
+ * - OpenAI function calling format
+ * - Anthropic tool format
+ * - System prompt sections
+ *
+ * These are DERIVED formats - the ToolDefinition is the source of truth.
+ */
+/**
+ * Convert ParameterDefinition to JSON Schema format for OpenAI
+ */
+function toJSONSchemaProperty(param) {
+    // Build the base schema
+    const baseSchema = {
+        type: param.type,
+        description: param.description,
+    };
+    if (param.default !== undefined) {
+        baseSchema.default = param.default;
+    }
+    if (param.enum) {
+        baseSchema.enum = param.enum;
+    }
+    if (param.items && param.type === 'array') {
+        const items = param.items;
+        if (items.type === 'object' && items.properties) {
+            baseSchema.items = {
+                type: 'object',
+                properties: Object.fromEntries(Object.entries(items.properties).map(([key, val]) => [
+                    key,
+                    toJSONSchemaProperty(val),
+                ])),
+                required: items.required || [],
+            };
+        }
+        else {
+            baseSchema.items = { type: items.type };
+        }
+    }
+    return baseSchema;
+}
+/**
+ * Generate a compact description suitable for API calls
+ *
+ * The compact description is the first paragraph plus key constraints
+ * for dangerous tools.
+ */
+export function generateCompactDescription(tool) {
+    // Get first paragraph (up to first double newline or 500 chars)
+    const firstParagraph = tool.description.split('\n\n')[0].slice(0, 500);
+    // For dangerous tools, add the most important constraint
+    if (tool.safetyLevel === 'dangerous' && tool.constraints.length > 0) {
+        return `${firstParagraph} IMPORTANT: ${tool.constraints[0]}`;
+    }
+    return firstParagraph;
+}
+/**
+ * Convert rich ToolDefinition to OpenAI function calling format
+ *
+ * This is a DERIVED format for API calls. The full tool details
+ * should be provided in the system prompt.
+ */
+export function toOpenAIFormat(tool) {
+    const properties = {};
+    for (const [name, param] of Object.entries(tool.parameters.properties)) {
+        properties[name] = toJSONSchemaProperty(param);
+    }
+    return {
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: generateCompactDescription(tool),
+            parameters: {
+                type: 'object',
+                properties,
+                required: tool.parameters.required,
+            },
+        },
+    };
+}
+/**
+ * Convert rich ToolDefinition to Anthropic tool format
+ */
+export function toAnthropicFormat(tool) {
+    const properties = {};
+    for (const [name, param] of Object.entries(tool.parameters.properties)) {
+        properties[name] = toJSONSchemaProperty(param);
+    }
+    return {
+        name: tool.name,
+        description: generateCompactDescription(tool),
+        input_schema: {
+            type: 'object',
+            properties,
+            required: tool.parameters.required,
+        },
+    };
+}
+/**
+ * Generate a full system prompt section for a tool
+ *
+ * This includes all the rich metadata: description, parameters,
+ * usage notes, constraints, anti-patterns, and examples.
+ */
+export function toSystemPromptSection(tool) {
+    const sections = [];
+    // Header
+    sections.push(`## ${tool.displayName}`);
+    sections.push('');
+    sections.push(tool.description);
+    sections.push('');
+    // Parameters
+    sections.push('### Parameters');
+    sections.push('');
+    for (const [name, param] of Object.entries(tool.parameters.properties)) {
+        const required = tool.parameters.required.includes(name) ? '(required)' : '(optional)';
+        sections.push(`- \`${name}\` ${required}: ${param.description}`);
+        if (param.default !== undefined) {
+            sections.push(`  - Default: \`${JSON.stringify(param.default)}\``);
+        }
+        if (param.enum) {
+            sections.push(`  - Options: ${param.enum.map(e => `\`${e}\``).join(', ')}`);
+        }
+        if (param.examples && param.examples.length > 0) {
+            sections.push(`  - Examples: ${param.examples.map(e => `\`${JSON.stringify(e)}\``).join(', ')}`);
+        }
+        if (param.constraints && param.constraints.length > 0) {
+            param.constraints.forEach(c => sections.push(`  - ${c}`));
+        }
+    }
+    sections.push('');
+    // Usage Notes
+    if (tool.usageNotes.length > 0) {
+        sections.push('### Usage Notes');
+        sections.push('');
+        tool.usageNotes.forEach(note => sections.push(`- ${note}`));
+        sections.push('');
+    }
+    // Constraints
+    if (tool.constraints.length > 0) {
+        sections.push('### Constraints');
+        sections.push('');
+        tool.constraints.forEach(c => sections.push(`- ${c}`));
+        sections.push('');
+    }
+    // Anti-patterns (when NOT to use)
+    if (tool.antiPatterns && tool.antiPatterns.length > 0) {
+        sections.push('### Do NOT Use When');
+        sections.push('');
+        tool.antiPatterns.forEach(ap => sections.push(`- ${ap}`));
+        sections.push('');
+    }
+    // Examples
+    if (tool.examples.length > 0) {
+        sections.push('### Examples');
+        sections.push('');
+        tool.examples.forEach(ex => {
+            sections.push(`**${ex.description}**`);
+            sections.push(`- Scenario: ${ex.scenario}`);
+            sections.push(`- Input: \`${JSON.stringify(ex.input)}\``);
+            sections.push(`- Expected: ${ex.expectedBehavior}`);
+            if (ex.notes) {
+                sections.push(`- Note: ${ex.notes}`);
+            }
+            sections.push('');
+        });
+    }
+    // Related tools
+    if (tool.relatedTools && tool.relatedTools.length > 0) {
+        sections.push(`**Related tools:** ${tool.relatedTools.join(', ')}`);
+        sections.push('');
+    }
+    // Alternatives
+    if (tool.alternatives && tool.alternatives.length > 0) {
+        sections.push(`**Alternatives:** ${tool.alternatives.join(', ')}`);
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+/**
+ * Generate the complete tool instructions section for system prompt
+ *
+ * @param tools - Array of tool definitions
+ * @returns Formatted markdown string with all tool documentation
+ */
+export function generateToolInstructions(tools) {
+    const sections = [];
+    sections.push('# Available Tools');
+    sections.push('');
+    sections.push('The following tools are available. Read each description carefully before using.');
+    sections.push('');
+    // Group tools by category
+    const byCategory = new Map();
+    for (const tool of tools) {
+        for (const category of tool.categories) {
+            if (!byCategory.has(category)) {
+                byCategory.set(category, []);
+            }
+            const categoryTools = byCategory.get(category);
+            if (categoryTools) {
+                categoryTools.push(tool);
+            }
+        }
+    }
+    // Generate sections by category
+    const categoryOrder = [
+        'file-operations',
+        'command-execution',
+        'search',
+        'task-management',
+        'user-interaction',
+        'agent-delegation',
+        'design',
+        'web',
+    ];
+    for (const category of categoryOrder) {
+        const categoryTools = byCategory.get(category);
+        if (categoryTools && categoryTools.length > 0) {
+            sections.push(`---`);
+            sections.push('');
+            sections.push(`# ${formatCategoryName(category)}`);
+            sections.push('');
+            // Deduplicate tools (a tool might be in multiple categories)
+            const seen = new Set();
+            for (const tool of categoryTools) {
+                if (!seen.has(tool.name)) {
+                    seen.add(tool.name);
+                    sections.push(toSystemPromptSection(tool));
+                    sections.push('---');
+                    sections.push('');
+                }
+            }
+        }
+    }
+    // Add general tool usage principles
+    sections.push('# Tool Usage Principles');
+    sections.push('');
+    sections.push('1. **Use specialized tools over general tools** - Use view_file instead of bash cat');
+    sections.push('2. **Read before editing** - Always view_file before str_replace_editor');
+    sections.push('3. **Parallel execution** - Make independent tool calls in parallel');
+    sections.push('4. **Sequential for dependencies** - Chain dependent calls with proper ordering');
+    sections.push('5. **Never guess parameters** - Ask if unsure about required values');
+    sections.push('6. **Match exact content** - For str_replace_editor, copy exact text from file');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * Format category name for display
+ */
+function formatCategoryName(category) {
+    const names = {
+        'file-operations': 'File Operations',
+        'command-execution': 'Command Execution',
+        'search': 'Search',
+        'task-management': 'Task Management',
+        'user-interaction': 'User Interaction',
+        'agent-delegation': 'Agent Delegation',
+        'design': 'Design Tools',
+        'web': 'Web Tools',
+    };
+    return names[category] || category;
+}
+/**
+ * Calculate total token cost for a set of tools
+ *
+ * Useful for budget planning and deciding which tools to include
+ */
+export function calculateTotalTokenCost(tools) {
+    return tools.reduce((sum, tool) => sum + tool.tokenCost, 0);
+}
+/**
+ * Filter tools by category
+ */
+export function filterByCategory(tools, categories) {
+    return tools.filter(tool => tool.categories.some(c => categories.includes(c)));
+}
+/**
+ * Filter tools by safety level
+ */
+export function filterBySafetyLevel(tools, levels) {
+    return tools.filter(tool => levels.includes(tool.safetyLevel));
+}
+/**
+ * Get tools that require confirmation
+ */
+export function getToolsRequiringConfirmation(tools) {
+    return tools.filter(tool => tool.requiresConfirmation);
+}
+//# sourceMappingURL=format-generators.js.map

package/dist/tools/format-generators.js.map

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

package/dist/tools/index.d.ts

@@ -3,3 +3,7 @@ export { TextEditorTool } from "./text-editor.js";
 export { TodoTool } from "./todo-tool.js";
 export { ConfirmationTool } from "./confirmation-tool.js";
 export { SearchTool } from "./search.js";
+export * from "./types.js";
+export * from "./format-generators.js";
+export * from "./result-enhancer.js";
+export { TOOL_DEFINITIONS, getToolDefinition, getToolsByCategory } from "./definitions/index.js";

package/dist/tools/index.js

@@ -1,6 +1,12 @@
+// Tool implementations
 export { BashTool } from "./bash.js";
 export { TextEditorTool } from "./text-editor.js";
 export { TodoTool } from "./todo-tool.js";
 export { ConfirmationTool } from "./confirmation-tool.js";
 export { SearchTool } from "./search.js";
+// Tool System v3.0 - Rich definitions and utilities
+export * from "./types.js";
+export * from "./format-generators.js";
+export * from "./result-enhancer.js";
+export { TOOL_DEFINITIONS, getToolDefinition, getToolsByCategory } from "./definitions/index.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,oDAAoD;AACpD,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/result-enhancer.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Tool Result Enhancer
+ *
+ * Enhances tool results with embedded instructions, security reminders,
+ * and contextual guidance based on the tool definition and result content.
+ */
+import type { ToolDefinition, EnhancedToolResult, ResultEnhancerConfig } from './types.js';
+/**
+ * Result Enhancer Class
+ *
+ * Enhances tool results with:
+ * - Security reminders for potentially dangerous content
+ * - Failure guidance based on tool constraints
+ * - Format reminders for large outputs
+ */
+export declare class ToolResultEnhancer {
+    private config;
+    constructor(config?: Partial<ResultEnhancerConfig>);
+    /**
+     * Enhance a tool result with embedded instructions
+     *
+     * @param toolName - Name of the tool that was executed
+     * @param result - Raw result from tool execution
+     * @param success - Whether the tool executed successfully
+     * @param definition - Tool definition with metadata
+     * @returns Enhanced result with reminders
+     */
+    enhance(toolName: string, result: string, success: boolean, definition?: ToolDefinition): EnhancedToolResult;
+    /**
+     * Get security reminders based on content patterns
+     */
+    private getSecurityReminders;
+    /**
+     * Get failure guidance from tool constraints
+     */
+    private getFailureGuidance;
+    /**
+     * Get format reminders for output handling
+     */
+    private getFormatReminders;
+    /**
+     * Get tool-specific reminders based on tool and context
+     */
+    private getToolSpecificReminders;
+    /**
+     * Update configuration
+     */
+    setConfig(config: Partial<ResultEnhancerConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): ResultEnhancerConfig;
+}
+/**
+ * Create a default result enhancer instance
+ */
+export declare function createResultEnhancer(config?: Partial<ResultEnhancerConfig>): ToolResultEnhancer;
+/**
+ * Format reminders for inclusion in tool result message
+ *
+ * @param reminders - Array of reminder strings
+ * @returns Formatted string to append to result
+ */
+export declare function formatReminders(reminders: string[]): string;