erosolar-cli 1.7.439 → 1.7.441

package/dist/core/testUtils.js.map

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

package/dist/core/toolPreconditions.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pre-flight validation patterns for AI flow design.
+ * Catches common tool usage failures before execution and provides actionable guidance.
+ */
+export interface PreflightWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly severity: 'critical' | 'warning' | 'info';
+    readonly suggestion: string;
+}
+export declare const AI_FLOW_VALIDATION_PATTERNS: {
+    readonly EDIT_LONG_SINGLE_LINE: RegExp;
+    readonly EDIT_PLACEHOLDER_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp];
+    readonly EDIT_FUNCTION_SIGNATURE: RegExp;
+    readonly SEARCH_OVERLY_BROAD: readonly [RegExp, RegExp, RegExp, RegExp];
+    readonly GIT_REDUNDANT_STATUS: RegExp;
+    readonly GIT_INEFFICIENT_CHAIN: RegExp;
+    readonly NPM_INCOMPLETE_PUBLISH: RegExp;
+    readonly CONTEXT_REDUNDANT_SNAPSHOT: RegExp;
+    readonly VALIDATION_EARLY_RUN: RegExp;
+};
+/**
+ * Validate tool preconditions before execution to prevent common AI flow failures.
+ *
+ * This function implements the critical AI flow design principle: validate before execute.
+ * It catches common patterns that lead to tool failures and provides actionable guidance.
+ *
+ * @param toolName - Name of the tool being called
+ * @param args - Tool arguments
+ * @returns Array of pre-flight warnings (empty if all validations pass)
+ */
+export declare function validateToolPreconditions(toolName: string, args: Record<string, unknown>): PreflightWarning[];
+/**
+ * Enhanced AI flow validation for TypeScript software engineering
+ * Provides comprehensive validation of AI tool usage patterns
+ */
+export declare function validateAIFlowPatterns(toolName: string, args: Record<string, unknown>, toolHistory: readonly {
+    toolName: string;
+    args: Record<string, unknown>;
+    timestamp?: number;
+}[]): PreflightWarning[];
+//# sourceMappingURL=toolPreconditions.d.ts.map

package/dist/core/toolPreconditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolPreconditions.d.ts","sourceRoot":"","sources":["../../src/core/toolPreconditions.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAGD,eAAO,MAAM,2BAA2B;;;;;;;;;;CA+B9B,CAAC;AAEX;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,EAAE,CA8KpB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAC9F,gBAAgB,EAAE,CA6EpB"}

package/dist/core/toolPreconditions.js

@@ -0,0 +1,347 @@
+import { existsSync, realpathSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, normalize as normalizePath, resolve as resolvePath } from 'node:path';
+import { analyzeBashFlow } from './bashCommandGuidance.js';
+// Enhanced AI flow validation patterns for TypeScript software engineering
+export const AI_FLOW_VALIDATION_PATTERNS = {
+    // Edit tool patterns
+    EDIT_LONG_SINGLE_LINE: /^[^\n]{50,}$/, // Long single line without newlines
+    EDIT_PLACEHOLDER_PATTERNS: [
+        /\.\.\./, // ... placeholder
+        /\[.*\]/, // [content] placeholder
+        /\/\/\s*\.\.\./, // // ... comment placeholder
+        /\/\*\s*\.\.\.\s*\*\//, // /* ... */ comment placeholder
+    ],
+    EDIT_FUNCTION_SIGNATURE: /^(function|class|const|let|var|export)\s+\w+\s*\([^)]*$/, // Unbalanced function signature
+    // Search patterns
+    SEARCH_OVERLY_BROAD: [
+        /^\*$/, // Single asterisk
+        /^\.$/, // Single dot
+        /^\*\*\/\*\*$/, // **/** pattern
+        /^\*\*\/\*$/, // **/* pattern
+    ],
+    // Git patterns
+    GIT_REDUNDANT_STATUS: /git\s+status/i,
+    GIT_INEFFICIENT_CHAIN: /git\s+(status|add|commit|push)/i,
+    // NPM patterns
+    NPM_INCOMPLETE_PUBLISH: /npm\s+publish/i,
+    // Context patterns
+    CONTEXT_REDUNDANT_SNAPSHOT: /context_snapshot/i,
+    // Validation patterns
+    VALIDATION_EARLY_RUN: /(run_repo_checks|run_tests|run_build)/i,
+};
+/**
+ * Validate tool preconditions before execution to prevent common AI flow failures.
+ *
+ * This function implements the critical AI flow design principle: validate before execute.
+ * It catches common patterns that lead to tool failures and provides actionable guidance.
+ *
+ * @param toolName - Name of the tool being called
+ * @param args - Tool arguments
+ * @returns Array of pre-flight warnings (empty if all validations pass)
+ */
+export function validateToolPreconditions(toolName, args) {
+    const warnings = [];
+    const toolLower = toolName.toLowerCase();
+    // -------------------------------------------------------------------------
+    // Edit Tool Validation - Critical for AI software engineering flow
+    // -------------------------------------------------------------------------
+    if (toolLower === 'edit') {
+        const oldString = args['old_string'];
+        const newString = args['new_string'];
+        const filePath = args['file_path'];
+        if (!oldString) {
+            // Empty old_string = new file creation - validate path structure
+            if (filePath && !filePath.startsWith('/')) {
+                warnings.push({
+                    code: 'EDIT_RELATIVE_PATH',
+                    message: 'Edit file_path should be absolute path for new file creation',
+                    severity: 'warning',
+                    suggestion: 'Use absolute path starting with / for file creation',
+                });
+            }
+        }
+        else {
+            // PATTERN 1: Long single line without newlines - likely didn't read file
+            if (!oldString.includes('\n') && oldString.length > 50) {
+                warnings.push({
+                    code: 'EDIT_NO_CONTEXT',
+                    message: 'Long single line without newlines detected in old_string',
+                    severity: 'critical',
+                    suggestion: 'AI should use Read tool first to get exact text including whitespace. Copy multiple lines for uniqueness.',
+                });
+            }
+            // PATTERN 2: Placeholder patterns - AI is guessing content
+            const placeholderPatterns = ['...', '[content]', '// ...', '# ...', '/* ... */', '[code]', 'TODO'];
+            if (placeholderPatterns.some((p) => oldString.includes(p))) {
+                warnings.push({
+                    code: 'EDIT_PLACEHOLDER',
+                    message: 'Placeholder patterns detected in old_string',
+                    severity: 'critical',
+                    suggestion: 'AI is guessing instead of reading actual file. Use Read tool to get exact file content.',
+                });
+            }
+            // PATTERN 3: Indentation mismatch detection
+            if (oldString && newString) {
+                const oldLines = oldString.split('\n');
+                const newLines = newString.split('\n');
+                if (oldLines.length > 1 && newLines.length > 1) {
+                    const firstOldLine = oldLines[0] || '';
+                    const firstNewLine = newLines[0] || '';
+                    const oldIndent = firstOldLine.length - firstOldLine.trimStart().length;
+                    const newIndent = firstNewLine.length - firstNewLine.trimStart().length;
+                    if (oldIndent !== newIndent && oldIndent > 0) {
+                        warnings.push({
+                            code: 'EDIT_INDENT_MISMATCH',
+                            message: `old_string starts with ${oldIndent} spaces, new_string starts with ${newIndent}`,
+                            severity: 'warning',
+                            suggestion: 'Mismatched indentation often causes Edit to fail matching.',
+                        });
+                    }
+                }
+            }
+            // PATTERN 4: Tab vs space mismatch
+            if (oldString && newString) {
+                const oldHasTabs = oldString.includes('\t');
+                const newHasTabs = newString.includes('\t');
+                if (oldHasTabs && !newHasTabs) {
+                    warnings.push({
+                        code: 'EDIT_WHITESPACE_MISMATCH',
+                        message: 'old_string uses tabs, new_string uses spaces',
+                        severity: 'warning',
+                        suggestion: 'Whitespace type mismatch may cause Edit to fail.',
+                    });
+                }
+            }
+            // PATTERN 5: Function signature truncation
+            if (oldString.includes('function ') || oldString.includes('def ') || oldString.includes('fn ')) {
+                const openParens = (oldString.match(/\(/g) || []).length;
+                const closeParens = (oldString.match(/\)/g) || []).length;
+                if (openParens !== closeParens) {
+                    warnings.push({
+                        code: 'EDIT_TRUNCATED_SIGNATURE',
+                        message: 'Unbalanced parentheses in old_string - function signature may be truncated',
+                        severity: 'warning',
+                        suggestion: 'Use Read to get complete function signature.',
+                    });
+                }
+            }
+            // PATTERN 6: Very short old_string for complex replacement
+            if (oldString.length < 20 && newString && newString.length > 100) {
+                warnings.push({
+                    code: 'EDIT_SHORT_MATCH',
+                    message: 'old_string is very short but new_string is large',
+                    severity: 'warning',
+                    suggestion: 'Short matches may hit multiple locations. Use more context in old_string.',
+                });
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Search Operations Validation
+    // -------------------------------------------------------------------------
+    if (toolLower === 'grep' || toolLower === 'glob' || toolLower.includes('search')) {
+        const patternArg = args['pattern'];
+        const pattern = typeof patternArg === 'string' ? patternArg.trim() : '';
+        const isGrepTool = toolLower.includes('grep');
+        const effectiveHeadLimit = normalizeHeadLimit(toolLower, args);
+        const looksGlob = !isGrepTool && /[*?\[]/.test(pattern);
+        if (pattern) {
+            if (isBroadBasePattern(pattern)) {
+                warnings.push({
+                    code: 'SEARCH_BROAD_PATTERN',
+                    message: `Pattern '${pattern}' is too broad and may return thousands of files`,
+                    severity: 'critical',
+                    suggestion: "Use targeted patterns like '**/*.ts' or 'src/**/*.js' with head_limit parameter.",
+                });
+            }
+            if (looksGlob && !effectiveHeadLimit) {
+                warnings.push({
+                    code: 'SEARCH_NO_LIMIT',
+                    message: `Pattern '${pattern}' may match many files without head_limit`,
+                    severity: 'info',
+                    suggestion: 'Consider adding head_limit parameter to prevent context overflow.',
+                });
+            }
+            if (isGrepTool) {
+                const hasFileFilters = typeof args['glob'] === 'string' || typeof args['type'] === 'string';
+                if (isVeryBroadRegex(pattern) && !hasFileFilters) {
+                    warnings.push({
+                        code: 'SEARCH_CONTEXT_OVERFLOW_RISK',
+                        message: `Regex pattern '${pattern}' is very broad and may match across many files`,
+                        severity: 'warning',
+                        suggestion: 'Add a glob/type filter or narrow the pattern to avoid overwhelming output.',
+                    });
+                }
+            }
+            else if (looksGlob && isGlobContextOverflowRisk(pattern)) {
+                warnings.push({
+                    code: 'SEARCH_CONTEXT_OVERFLOW_RISK',
+                    message: `Broad search pattern '${pattern}' detected - high risk of context overflow`,
+                    severity: 'warning',
+                    suggestion: 'Use targeted patterns like "**/*.ts" with head_limit=20, or read specific files directly.',
+                });
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Bash Command Efficiency
+    // -------------------------------------------------------------------------
+    if (toolLower === 'bash' || toolLower === 'execute_bash') {
+        const command = String(args['command'] || '');
+        const flowWarnings = analyzeBashFlow(command);
+        for (const flow of flowWarnings) {
+            warnings.push({
+                code: flow.code,
+                message: flow.message,
+                severity: flow.severity === 'critical' ? 'critical' : flow.severity === 'info' ? 'info' : 'warning',
+                suggestion: flow.suggestion ?? flow.message,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Enhanced AI flow validation for TypeScript software engineering
+ * Provides comprehensive validation of AI tool usage patterns
+ */
+export function validateAIFlowPatterns(toolName, args, toolHistory) {
+    const warnings = [];
+    const toolLower = toolName.toLowerCase();
+    // Pattern: Edit without prior Read
+    if (toolLower === 'edit') {
+        const oldString = typeof args['old_string'] === 'string' ? args['old_string'] : undefined;
+        const isNewFileCreation = oldString !== undefined && oldString.length === 0;
+        const targetPath = normalizeFilePath(args['file_path']);
+        const hasRecentRead = toolHistory.some((call) => {
+            if (!targetPath) {
+                return false;
+            }
+            const callLower = call.toolName.toLowerCase();
+            if (!callLower.includes('read')) {
+                return false;
+            }
+            const readPath = normalizeFilePath(call.args['path'] ?? call.args['file_path']);
+            return Boolean(readPath && readPath === targetPath);
+        });
+        if (!isNewFileCreation && !hasRecentRead) {
+            warnings.push({
+                code: 'EDIT_WITHOUT_READ',
+                message: 'Edit attempted without prior file read',
+                severity: 'critical',
+                suggestion: 'Always use Read tool first to get exact text including whitespace and indentation.',
+            });
+        }
+    }
+    // Pattern: Multiple validation runs
+    if (toolLower === 'run_repo_checks' || toolLower === 'run_tests' || toolLower === 'run_build') {
+        const now = Date.now();
+        const recencyWindowMs = 15 * 60 * 1000; // Only warn when validations are clustered
+        const recentValidations = toolHistory
+            .filter((call) => call.toolName.toLowerCase().includes('run_') ||
+            call.toolName.toLowerCase().includes('test') ||
+            call.toolName.toLowerCase().includes('build'))
+            .filter((call) => {
+            if (typeof call.timestamp !== 'number') {
+                return true;
+            }
+            return now - call.timestamp <= recencyWindowMs;
+        });
+        if (recentValidations.length > 0) {
+            warnings.push({
+                code: 'DEFERRED_VALIDATION_REMINDER',
+                message: 'Validation already ran recently; batch edits and run one final pass at the end.',
+                severity: 'info',
+                suggestion: 'Finish implementation work first, then run a single build/test/check step to validate.',
+            });
+        }
+    }
+    // Pattern: Inefficient git operations
+    if (toolLower.includes('git')) {
+        const recentGitOps = toolHistory.filter((call) => call.toolName.toLowerCase().includes('git'));
+        if (recentGitOps.length >= 2) {
+            warnings.push({
+                code: 'GIT_EFFICIENCY_OPTIMIZATION',
+                message: 'Multiple git operations detected - consider combined commands',
+                severity: 'info',
+                suggestion: 'Use single combined commands like "git add -A && git commit -m msg && git push" instead of separate calls.',
+            });
+        }
+    }
+    return warnings;
+}
+function normalizeHeadLimit(toolName, args) {
+    const tool = toolName.toLowerCase();
+    const explicit = args['head_limit'];
+    if (typeof explicit === 'number' && Number.isFinite(explicit) && explicit > 0) {
+        return explicit;
+    }
+    if (tool === 'glob' || tool.includes('glob')) {
+        return 20;
+    }
+    if (tool.includes('search')) {
+        return 50;
+    }
+    if (tool.includes('grep')) {
+        const outputMode = typeof args['output_mode'] === 'string' ? args['output_mode'] : 'files_with_matches';
+        if (outputMode === 'content')
+            return 20;
+        if (outputMode === 'count')
+            return 50;
+        return 30;
+    }
+    return null;
+}
+function isBroadBasePattern(pattern) {
+    return pattern === '.' || pattern === '*' || pattern === '**/*';
+}
+function isGlobContextOverflowRisk(pattern) {
+    const literalPortion = pattern.replace(/[*?[\]]+/g, '');
+    const hasExtension = /\.[\w]+/.test(pattern);
+    const hasMeaningfulLiteral = literalPortion.replace(/[\\/]/g, '').length >= 3;
+    const deepGlobstar = pattern.includes('**') && !hasExtension && literalPortion.length < 6;
+    const wildcardHeavy = !hasExtension && !hasMeaningfulLiteral;
+    return deepGlobstar || wildcardHeavy;
+}
+function isVeryBroadRegex(pattern) {
+    const normalized = pattern.trim();
+    return normalized === '.*' || normalized === '.+' || normalized === '.';
+}
+function normalizeFilePath(pathValue) {
+    if (typeof pathValue !== 'string') {
+        return null;
+    }
+    const trimmed = pathValue.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        const normalized = normalizePath(trimmed);
+        const absolutePath = isAbsolute(normalized) ? normalized : resolvePath(process.cwd(), normalized);
+        // Resolve symlinks on the deepest existing directory to avoid /var vs /private/var mismatches
+        let currentDir = dirname(absolutePath);
+        let suffix = basename(absolutePath);
+        while (true) {
+            if (existsSync(currentDir)) {
+                try {
+                    const realDir = realpathSync(currentDir);
+                    return normalizePath(join(realDir, suffix));
+                }
+                catch {
+                    // If realpath fails, fall through to the default normalization
+                    break;
+                }
+            }
+            const parentDir = dirname(currentDir);
+            if (parentDir === currentDir) {
+                break;
+            }
+            suffix = join(basename(currentDir), suffix);
+            currentDir = parentDir;
+        }
+        return normalizePath(absolutePath);
+    }
+    catch {
+        return trimmed;
+    }
+}
+//# sourceMappingURL=toolPreconditions.js.map

package/dist/core/toolPreconditions.js.map

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

package/dist/core/toolRuntime.d.ts

@@ -0,0 +1,163 @@
+import { type JSONSchemaObject, type ProviderId, type ProviderToolDefinition, type ToolCallRequest } from './types.js';
+import { ContextManager } from './contextManager.js';
+import { type PreflightWarning } from './toolPreconditions.js';
+/**
+ * Execution context for tool operations with strict TypeScript typing
+ */
+export interface ToolExecutionContext {
+    readonly profileName: string;
+    readonly provider: ProviderId;
+    readonly model: string;
+    readonly workspaceContext?: string | null;
+}
+/**
+ * Type-safe tool observer with generic parameter inference for AI flow monitoring
+ */
+export interface ToolRuntimeObserver<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** Called when tool execution begins */
+    onToolStart?(call: ToolCallRequest & {
+        args: T;
+    }): void;
+    /** Called when tool execution completes successfully */
+    onToolResult?(call: ToolCallRequest & {
+        args: T;
+    }, output: string): void;
+    /** Called when tool execution fails */
+    onToolError?(call: ToolCallRequest & {
+        args: T;
+    }, error: string): void;
+    /** Called when cached result is used instead of execution */
+    onCacheHit?(call: ToolCallRequest & {
+        args: T;
+    }): void;
+    /** Called for progress updates during long-running operations */
+    onToolProgress?(call: ToolCallRequest & {
+        args: T;
+    }, progress: ToolProgressUpdate): void;
+    /** Called for pre-flight warnings before tool execution */
+    onToolWarning?(call: ToolCallRequest & {
+        args: T;
+    }, warning: PreflightWarning | string): void;
+}
+interface ToolRuntimeOptions {
+    readonly observer?: ToolRuntimeObserver;
+    readonly contextManager?: ContextManager;
+    readonly enableCache?: boolean;
+    readonly cacheTTLMs?: number;
+}
+/**
+ * Generic tool handler with parameter type inference for AI flow execution
+ */
+type ToolHandler<T extends Record<string, unknown> = Record<string, unknown>> = (args: T) => Promise<string> | string;
+/**
+ * Enhanced tool definition with parameter type safety for AI software engineering
+ */
+export interface ToolDefinition<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique identifier for the tool */
+    readonly name: string;
+    /** Human-readable description for AI understanding */
+    readonly description: string;
+    /** JSON Schema defining the tool's parameter structure */
+    readonly parameters?: JSONSchemaObject;
+    /** Function that implements the tool's behavior */
+    readonly handler: ToolHandler<T>;
+    /** Whether results can be cached for performance optimization */
+    readonly cacheable?: boolean;
+}
+/**
+ * Collection of related tools grouped by functionality
+ */
+export interface ToolSuite {
+    /** Unique identifier for the tool suite */
+    readonly id: string;
+    /** Human-readable description of the suite's purpose */
+    readonly description?: string;
+    /** Array of tool definitions in this suite */
+    readonly tools: readonly ToolDefinition[];
+}
+export interface ToolHistoryEntry {
+    toolName: string;
+    args: Record<string, unknown>;
+    timestamp: number;
+}
+export interface ToolProgressUpdate {
+    current: number;
+    total?: number;
+    message?: string;
+}
+/**
+ * Report incremental progress for the currently executing tool.
+ * Tools can call this to surface live status updates (e.g., indexing files).
+ */
+export declare function reportToolProgress(progress: ToolProgressUpdate): void;
+/**
+ * Type-safe utility functions for tool runtime operations
+ */
+export declare namespace ToolRuntimeUtils {
+    /**
+     * Creates a type-safe tool definition with inferred parameter types
+     */
+    function createToolDefinition<T extends Record<string, unknown>>(definition: ToolDefinition<T>): ToolDefinition<T>;
+    /**
+     * Creates a type-safe tool suite with inferred tool types
+     */
+    function createToolSuite(suite: ToolSuite): ToolSuite;
+    /**
+     * Type guard to check if a tool definition matches expected parameter schema
+     */
+    function isToolDefinition(__tool: ToolDefinition, expectedSchema?: JSONSchemaObject): boolean;
+}
+/**
+ * Interface describing the public API of ToolRuntime.
+ * Used by wrapper implementations like RestrictedToolRuntime.
+ */
+export interface IToolRuntime {
+    listProviderTools(): ProviderToolDefinition[];
+    execute(call: ToolCallRequest, context?: {
+        profileName?: string;
+        provider?: string;
+        model?: string;
+    }): Promise<string>;
+    registerSuite(suite: ToolSuite): void;
+    unregisterSuite(id: string): void;
+    clearCache(): void;
+    getCacheStats(): {
+        size: number;
+        entries: number;
+    };
+    clearToolHistory(): void;
+    getToolHistory(): readonly ToolHistoryEntry[];
+}
+export declare class ToolRuntime implements IToolRuntime {
+    private readonly registry;
+    private readonly registrationOrder;
+    private readonly observer;
+    private readonly contextManager;
+    private readonly cache;
+    private readonly enableCache;
+    private readonly cacheTTLMs;
+    private readonly toolHistory;
+    private readonly maxHistorySize;
+    constructor(baseTools?: ToolDefinition[], options?: ToolRuntimeOptions);
+    registerSuite(suite: ToolSuite): void;
+    unregisterSuite(id: string): void;
+    listProviderTools(): ProviderToolDefinition[];
+    execute(call: ToolCallRequest, context?: {
+        profileName?: string;
+        provider?: string;
+        model?: string;
+    }): Promise<string>;
+    private getCacheKey;
+    clearCache(): void;
+    getCacheStats(): {
+        size: number;
+        entries: number;
+    };
+    clearToolHistory(): void;
+    getToolHistory(): readonly ToolHistoryEntry[];
+    private addTool;
+    private removeFromOrder;
+}
+export declare function createDefaultToolRuntime(context: ToolExecutionContext, toolSuites?: ToolSuite[], options?: ToolRuntimeOptions): ToolRuntime;
+export {};
+//# sourceMappingURL=toolRuntime.d.ts.map

package/dist/core/toolRuntime.d.ts.map

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