erosolar-cli 1.7.195 → 1.7.196

package/dist/core/toolRuntime.js

@@ -0,0 +1,375 @@
+import { ToolArgumentValidationError, validateToolArguments, } from './schemaValidator.js';
+import { globalPerformanceMonitor } from './performanceMonitor.js';
+import { validateToolPreconditions, validateAIFlowPatterns } from './toolPreconditions.js';
+// Idempotent tools that can be safely cached
+const CACHEABLE_TOOLS = new Set([
+    'Read',
+    'read_file',
+    'Glob',
+    'glob_search',
+    'Grep',
+    'grep_search',
+    'find_definition',
+    'analyze_code_quality',
+    'extract_exports',
+]);
+/**
+ * Type-safe utility functions for tool runtime operations
+ */
+export var ToolRuntimeUtils;
+(function (ToolRuntimeUtils) {
+    /**
+     * Creates a type-safe tool definition with inferred parameter types
+     */
+    function createToolDefinition(definition) {
+        return definition;
+    }
+    ToolRuntimeUtils.createToolDefinition = createToolDefinition;
+    /**
+     * Creates a type-safe tool suite with inferred tool types
+     */
+    function createToolSuite(suite) {
+        return suite;
+    }
+    ToolRuntimeUtils.createToolSuite = createToolSuite;
+    /**
+     * Type guard to check if a tool definition matches expected parameter schema
+     */
+    function isToolDefinition(__tool, expectedSchema) {
+        if (!expectedSchema)
+            return true;
+        // In a real implementation, this would validate against the schema
+        return true;
+    }
+    ToolRuntimeUtils.isToolDefinition = isToolDefinition;
+})(ToolRuntimeUtils || (ToolRuntimeUtils = {}));
+export class ToolRuntime {
+    registry = new Map();
+    registrationOrder = [];
+    observer;
+    contextManager;
+    cache = new Map();
+    enableCache;
+    cacheTTLMs;
+    toolHistory = [];
+    maxHistorySize = 50; // Keep last 50 tool calls for AI flow pattern detection
+    constructor(baseTools = [], options = {}) {
+        this.observer = options.observer ?? null;
+        this.contextManager = options.contextManager ?? null;
+        this.enableCache = options.enableCache ?? true;
+        this.cacheTTLMs = options.cacheTTLMs ?? 5 * 60 * 1000; // 5 minutes default
+        if (baseTools.length) {
+            this.registerSuite({
+                id: 'runtime.core',
+                description: 'Core runtime metadata tools',
+                tools: baseTools,
+            });
+        }
+    }
+    registerSuite(suite) {
+        if (!suite?.id?.trim()) {
+            throw new Error('Tool suite id cannot be blank.');
+        }
+        this.unregisterSuite(suite.id);
+        for (const definition of suite.tools ?? []) {
+            this.addTool(definition, suite.id);
+        }
+    }
+    unregisterSuite(id) {
+        if (!id?.trim()) {
+            return;
+        }
+        for (const [name, record] of this.registry.entries()) {
+            if (record.suiteId === id) {
+                this.registry.delete(name);
+                this.removeFromOrder(name);
+            }
+        }
+    }
+    listProviderTools() {
+        return this.registrationOrder
+            .map((name) => this.registry.get(name))
+            .filter((record) => Boolean(record))
+            .map(({ definition }) => ({
+            name: definition.name,
+            description: definition.description,
+            ...(definition.parameters && { parameters: definition.parameters }),
+        }));
+    }
+    async execute(call, context) {
+        const record = this.registry.get(call.name);
+        // Parse args early to create augmented call for observer
+        const args = normalizeToolArguments(call.arguments);
+        const augmentedCall = { ...call, args };
+        if (!record) {
+            const message = `Tool "${call.name}" is not available.`;
+            this.observer?.onToolError?.(augmentedCall, message);
+            globalPerformanceMonitor.recordToolError(call, message, context ?? undefined);
+            return message;
+        }
+        // Check if tool is cacheable
+        const isCacheable = record.definition.cacheable ?? CACHEABLE_TOOLS.has(call.name);
+        // Try to get from cache
+        if (this.enableCache && isCacheable) {
+            const cacheKey = this.getCacheKey(call);
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp < this.cacheTTLMs) {
+                this.observer?.onCacheHit?.(augmentedCall);
+                this.observer?.onToolResult?.(augmentedCall, cached.result);
+                // Record cache hit as successful execution with 0ms time
+                globalPerformanceMonitor.startToolCall(call, context)();
+                return cached.result;
+            }
+        }
+        this.observer?.onToolStart?.(augmentedCall);
+        // Start performance monitoring
+        const finishToolCall = globalPerformanceMonitor.startToolCall(call, context);
+        try {
+            validateToolArguments(record.definition.name, record.definition.parameters, args);
+            // Pre-flight AI flow validation - catch common tool usage failures
+            const preflightWarnings = validateToolPreconditions(call.name, args);
+            for (const warning of preflightWarnings) {
+                this.observer?.onToolWarning?.(augmentedCall, warning);
+            }
+            // Advanced AI flow pattern validation using tool history
+            const aiFlowWarnings = validateAIFlowPatterns(call.name, args, this.toolHistory);
+            for (const warning of aiFlowWarnings) {
+                this.observer?.onToolWarning?.(augmentedCall, warning);
+            }
+            // Collect optimization hints to inject into result
+            const optimizationHints = [];
+            for (const warning of aiFlowWarnings) {
+                if (warning.code === 'SEQUENTIAL_READ_OPTIMIZATION') {
+                    optimizationHints.push(`\n\n<optimization-hint>\n` +
+                        `⚡ PARALLEL READ OPTIMIZATION: ${warning.suggestion}\n` +
+                        `Next time, request multiple independent file reads in a single tool call batch.\n` +
+                        `</optimization-hint>`);
+                }
+            }
+            // Track this tool call in history for AI flow pattern detection
+            this.toolHistory.push({
+                toolName: call.name,
+                args,
+                timestamp: Date.now(),
+            });
+            // Keep history bounded to prevent memory growth
+            if (this.toolHistory.length > this.maxHistorySize) {
+                this.toolHistory.shift();
+            }
+            const result = await record.definition.handler(args);
+            let output = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+            // Truncate output if context manager is available
+            if (this.contextManager) {
+                const truncated = this.contextManager.truncateToolOutput(output, call.name);
+                if (truncated.wasTruncated) {
+                    output = truncated.content;
+                    // Log truncation for debugging
+                    if (process.env['DEBUG_CONTEXT']) {
+                        console.warn(`[Context Manager] Truncated ${call.name} output: ${truncated.originalLength} -> ${truncated.truncatedLength} chars`);
+                    }
+                }
+            }
+            // Cache the result if cacheable
+            if (this.enableCache && isCacheable) {
+                const cacheKey = this.getCacheKey(call);
+                this.cache.set(cacheKey, {
+                    result: output,
+                    timestamp: Date.now(),
+                });
+            }
+            // Append optimization hints to guide future LLM behavior
+            if (optimizationHints.length > 0) {
+                output = output + optimizationHints.join('');
+            }
+            this.observer?.onToolResult?.(augmentedCall, output);
+            // Record successful execution
+            finishToolCall();
+            return output;
+        }
+        catch (error) {
+            let formatted;
+            if (error instanceof ToolArgumentValidationError) {
+                formatted = error.message;
+            }
+            else {
+                const message = error instanceof Error ? error.message : String(error);
+                formatted = `Failed to run "${call.name}": ${message}`;
+            }
+            this.observer?.onToolError?.(augmentedCall, formatted);
+            // Record failed execution
+            globalPerformanceMonitor.recordToolError(call, formatted, context ?? undefined);
+            return formatted;
+        }
+    }
+    getCacheKey(call) {
+        return `${call.name}:${JSON.stringify(call.arguments)}`;
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    getCacheStats() {
+        let totalSize = 0;
+        for (const entry of this.cache.values()) {
+            totalSize += entry.result.length;
+        }
+        return {
+            size: totalSize,
+            entries: this.cache.size,
+        };
+    }
+    clearToolHistory() {
+        this.toolHistory.length = 0;
+    }
+    getToolHistory() {
+        return this.toolHistory;
+    }
+    addTool(definition, suiteId) {
+        if (!definition?.name?.trim()) {
+            throw new Error(`Tool names cannot be blank (suite "${suiteId}").`);
+        }
+        if (this.registry.has(definition.name)) {
+            const owner = this.registry.get(definition.name)?.suiteId ?? 'unknown';
+            throw new Error(`Tool "${definition.name}" already registered by suite "${owner}".`);
+        }
+        this.registry.set(definition.name, {
+            suiteId,
+            definition,
+        });
+        this.registrationOrder.push(definition.name);
+    }
+    removeFromOrder(name) {
+        const index = this.registrationOrder.indexOf(name);
+        if (index >= 0) {
+            this.registrationOrder.splice(index, 1);
+        }
+    }
+}
+export function createDefaultToolRuntime(context, toolSuites = [], options = {}) {
+    const runtime = new ToolRuntime([
+        buildContextSnapshotTool(context.workspaceContext),
+        buildCapabilitiesTool(context),
+        buildProfileInspectorTool(context),
+    ], options);
+    for (const suite of toolSuites) {
+        runtime.registerSuite(suite);
+    }
+    return runtime;
+}
+function buildContextSnapshotTool(workspaceContext) {
+    return {
+        name: 'context_snapshot',
+        description: 'Returns a summary of the repository context. NOTE: Full context is already in your system prompt - only use this if you need to refresh or verify the context.',
+        parameters: {
+            type: 'object',
+            properties: {
+                format: {
+                    type: 'string',
+                    description: 'Use "plain" for raw text or "markdown" for a fenced block.',
+                    enum: ['plain', 'markdown'],
+                },
+            },
+        },
+        handler: (args) => {
+            if (!workspaceContext?.trim()) {
+                return 'Workspace context is unavailable.';
+            }
+            // CRITICAL: Return only summary to prevent context duplication
+            // Full context is already in system prompt
+            const lines = workspaceContext.trim().split('\n');
+            const totalLines = lines.length;
+            // Return just first 20 lines + summary
+            const preview = lines.slice(0, 20).join('\n');
+            const summary = [
+                preview,
+                '',
+                `[Workspace context: ${totalLines} total lines]`,
+                `[Full context already available in system prompt - use Read/Glob tools for specific files]`
+            ].join('\n');
+            const format = args['format'] === 'markdown' ? 'markdown' : 'plain';
+            if (format === 'markdown') {
+                return ['```text', summary, '```'].join('\n');
+            }
+            return summary;
+        },
+    };
+}
+function buildCapabilitiesTool(context) {
+    return {
+        name: 'capabilities_overview',
+        description: 'Summarizes the agent runtime capabilities including available tools and features.',
+        parameters: {
+            type: 'object',
+            properties: {
+                audience: {
+                    type: 'string',
+                    enum: ['developer', 'model'],
+                    description: 'Tailors the tone of the description.',
+                },
+            },
+        },
+        handler: (args) => {
+            const audience = args['audience'];
+            const adjective = audience === 'developer' ? 'Operator facing' : 'Model facing';
+            return [
+                `${adjective} capabilities summary:`,
+                '- Full file system access (read, write, list, search).',
+                '- Bash command execution for running scripts and tools.',
+                '- Advanced code search and pattern matching.',
+                '- Deterministic workspace context snapshot appended to the system prompt.',
+                '- Tool invocations are logged in realtime for transparency.',
+                `- Active provider: ${context.provider} (${context.model}).`,
+            ].join('\n');
+        },
+    };
+}
+function buildProfileInspectorTool(context) {
+    return {
+        name: 'profile_details',
+        description: 'Returns the configuration of the active CLI profile.',
+        parameters: {
+            type: 'object',
+            properties: {
+                includeWorkspaceContext: {
+                    type: 'boolean',
+                    description: 'Set true to append the workspace context snapshot if available.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const payload = {
+                profile: context.profileName,
+                provider: context.provider,
+                model: context.model,
+                workspaceContext: args['includeWorkspaceContext'] ? context.workspaceContext ?? null : null,
+            };
+            return JSON.stringify(payload, null, 2);
+        },
+    };
+}
+function normalizeToolArguments(value) {
+    if (value instanceof Map) {
+        return Object.fromEntries(value.entries());
+    }
+    if (isRecord(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed) {
+            return {};
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            return isRecord(parsed) ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    return {};
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=toolRuntime.js.map

package/dist/core/toolRuntime.js.map

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

package/dist/core/toolValidation.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Comprehensive Tool Validation System
+ *
+ * Provides proactive validation for AI tool usage with:
+ * - Pre-flight validation before tool execution
+ * - Real-time AI flow guidance
+ * - Pattern-based anti-pattern detection
+ * - Recovery suggestions for common failures
+ */
+import type { ToolDefinition } from './toolRuntime.js';
+/**
+ * Tool validation result
+ */
+export interface ToolValidationResult {
+    readonly valid: boolean;
+    readonly warnings: ToolValidationWarning[];
+    readonly suggestions: ToolValidationSuggestion[];
+    readonly criticalErrors: ToolValidationError[];
+}
+/**
+ * Tool validation warning
+ */
+export interface ToolValidationWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly severity: 'low' | 'medium' | 'high';
+    readonly suggestion?: string;
+}
+/**
+ * Tool validation error
+ */
+export interface ToolValidationError {
+    readonly code: string;
+    readonly message: string;
+    readonly recovery?: string;
+}
+/**
+ * Tool validation suggestion
+ */
+export interface ToolValidationSuggestion {
+    readonly code: string;
+    readonly message: string;
+    readonly action: string;
+}
+/**
+ * AI flow guidance patterns
+ */
+export interface AIFlowPattern {
+    readonly pattern: string;
+    readonly description: string;
+    readonly guidance: string;
+    readonly examples: string[];
+}
+/**
+ * Tool usage context
+ */
+export interface ToolUsageContext {
+    readonly toolName: string;
+    readonly parameters: Record<string, unknown>;
+    readonly workspaceContext?: {
+        readonly currentFiles: string[];
+        readonly recentOperations: string[];
+        readonly workspacePath: string;
+    };
+}
+/**
+ * Comprehensive tool validator
+ */
+export declare class ToolValidator {
+    private readonly patterns;
+    /**
+     * Validate tool usage before execution
+     */
+    validateToolUsage(tool: ToolDefinition, context: ToolUsageContext): ToolValidationResult;
+    /**
+     * Validate tool-specific patterns
+     */
+    private validateToolSpecific;
+    /**
+     * Validate Edit tool usage
+     */
+    private validateEditTool;
+    /**
+     * Validate search tools (Glob, Grep)
+     */
+    private validateSearchTools;
+    /**
+     * Validate bash commands
+     */
+    private validateBashCommands;
+    /**
+     * Validate AI flow patterns
+     */
+    private validateAIFlowPatterns;
+    /**
+     * Validate performance optimizations
+     */
+    private validatePerformance;
+    private containsPlaceholderPattern;
+    private isLongSingleLine;
+    private hasIndentationMismatch;
+    private detectIndentation;
+    private isOverlyBroadPattern;
+    private isBroadPattern;
+    private containsRedundantGitOperations;
+    private isIncompleteNpmPublish;
+    /**
+     * Get AI flow guidance for a specific pattern
+     */
+    getAIFlowGuidance(patternId: string): AIFlowPattern | undefined;
+    /**
+     * Get all AI flow patterns
+     */
+    getAllAIFlowPatterns(): AIFlowPattern[];
+}
+export declare const globalToolValidator: ToolValidator;
+//# sourceMappingURL=toolValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolValidation.d.ts","sourceRoot":"","sources":["../../src/core/toolValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,mBAAmB,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAuDvB;IAEF;;OAEG;IACH,iBAAiB,CACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,gBAAgB,GACxB,oBAAoB;IAsBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA8B5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,8BAA8B;IAMtC,OAAO,CAAC,sBAAsB;IAM9B;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI/D;;OAEG;IACH,oBAAoB,IAAI,aAAa,EAAE;CAGxC;AAGD,eAAO,MAAM,mBAAmB,eAAsB,CAAC"}