attocode 0.1.0

package/dist/src/tricks/failure-evidence.js

@@ -0,0 +1,544 @@
+/**
+ * Trick S: Failure Evidence Preservation
+ *
+ * Preserves failed actions, error traces, and unsuccessful attempts in context
+ * so the model can learn from mistakes and avoid repeating them.
+ *
+ * Problem: When errors are silently discarded or minimally logged, the model
+ * may repeat the same mistakes. Without evidence of what failed and why,
+ * the agent loops endlessly.
+ *
+ * Solution: Explicitly preserve failure evidence with structured metadata.
+ * This includes error messages, stack traces, what was attempted, and why
+ * it failed - enabling the model to learn and adapt.
+ *
+ * @example
+ * ```typescript
+ * import { createFailureTracker, formatFailureContext } from './failure-evidence';
+ *
+ * const tracker = createFailureTracker({
+ *   maxFailures: 20,
+ *   preserveStackTraces: true,
+ *   categorizeErrors: true,
+ * });
+ *
+ * // Record a failure
+ * tracker.recordFailure({
+ *   action: 'read_file',
+ *   args: { path: '/etc/passwd' },
+ *   error: 'Permission denied',
+ *   category: 'permission',
+ * });
+ *
+ * // Get context for LLM
+ * const failureContext = tracker.getFailureContext();
+ * ```
+ */
+// =============================================================================
+// ERROR CATEGORIZATION
+// =============================================================================
+/**
+ * Auto-categorize an error based on its message.
+ */
+export function categorizeError(error) {
+    const lowerError = error.toLowerCase();
+    // Permission errors
+    if (lowerError.includes('permission denied') ||
+        lowerError.includes('access denied') ||
+        lowerError.includes('not permitted') ||
+        lowerError.includes('eacces') ||
+        lowerError.includes('unauthorized')) {
+        return 'permission';
+    }
+    // Not found errors
+    if (lowerError.includes('not found') ||
+        lowerError.includes('no such file') ||
+        lowerError.includes('enoent') ||
+        lowerError.includes('does not exist') ||
+        lowerError.includes('404')) {
+        return 'not_found';
+    }
+    // Syntax errors
+    if (lowerError.includes('syntax error') ||
+        lowerError.includes('unexpected token') ||
+        lowerError.includes('parse error') ||
+        lowerError.includes('invalid json')) {
+        return 'syntax';
+    }
+    // Type errors
+    if (lowerError.includes('type error') ||
+        lowerError.includes('typeerror') ||
+        lowerError.includes('is not a function') ||
+        lowerError.includes('undefined is not') ||
+        lowerError.includes('cannot read propert')) {
+        return 'type';
+    }
+    // Network errors
+    if (lowerError.includes('network') ||
+        lowerError.includes('connection') ||
+        lowerError.includes('econnrefused') ||
+        lowerError.includes('socket') ||
+        lowerError.includes('dns') ||
+        lowerError.includes('fetch failed')) {
+        return 'network';
+    }
+    // Timeout errors
+    if (lowerError.includes('timeout') ||
+        lowerError.includes('timed out') ||
+        lowerError.includes('etimedout')) {
+        return 'timeout';
+    }
+    // Validation errors
+    if (lowerError.includes('validation') ||
+        lowerError.includes('invalid') ||
+        lowerError.includes('required') ||
+        lowerError.includes('must be')) {
+        return 'validation';
+    }
+    // Resource errors
+    if (lowerError.includes('out of memory') ||
+        lowerError.includes('disk full') ||
+        lowerError.includes('enomem') ||
+        lowerError.includes('enospc') ||
+        lowerError.includes('quota')) {
+        return 'resource';
+    }
+    // Logic errors
+    if (lowerError.includes('assertion') ||
+        lowerError.includes('invariant') ||
+        lowerError.includes('expect')) {
+        return 'logic';
+    }
+    return 'unknown';
+}
+/**
+ * Generate a suggestion based on failure category.
+ */
+export function generateSuggestion(failure) {
+    switch (failure.category) {
+        case 'permission':
+            return `Check file/directory permissions. The action "${failure.action}" may need elevated privileges or the path may be restricted.`;
+        case 'not_found':
+            return `Verify the resource exists before accessing. Use list_directory or check for typos in the path.`;
+        case 'syntax':
+            return `Review the syntax. Check for missing brackets, quotes, or invalid characters. Validate JSON/code before submission.`;
+        case 'type':
+            return `Check variable types and ensure proper null/undefined handling. The value may be a different type than expected.`;
+        case 'network':
+            return `Check network connectivity. The service may be down, or there may be firewall/DNS issues.`;
+        case 'timeout':
+            return `The operation took too long. Consider breaking it into smaller operations or increasing timeout.`;
+        case 'validation':
+            return `Verify input matches expected format/constraints. Check required fields and value ranges.`;
+        case 'resource':
+            return `System resources are constrained. Consider cleanup, smaller batch sizes, or freeing memory/disk.`;
+        case 'logic':
+            return `An assumption was violated. Review the logic and check preconditions.`;
+        default:
+            return `Analyze the error message for specific guidance.`;
+    }
+}
+// =============================================================================
+// FAILURE TRACKER
+// =============================================================================
+/**
+ * Tracks failures with pattern detection.
+ */
+export class FailureTracker {
+    config;
+    failures = [];
+    actionHistory = new Map(); // action -> failure IDs
+    listeners = [];
+    constructor(config = {}) {
+        this.config = {
+            maxFailures: config.maxFailures ?? 50,
+            preserveStackTraces: config.preserveStackTraces ?? true,
+            categorizeErrors: config.categorizeErrors ?? true,
+            detectRepeats: config.detectRepeats ?? true,
+            repeatWarningThreshold: config.repeatWarningThreshold ?? 3,
+        };
+    }
+    /**
+     * Record a failure.
+     */
+    recordFailure(input) {
+        const errorString = input.error instanceof Error
+            ? input.error.message
+            : input.error;
+        const stackTrace = input.error instanceof Error
+            ? input.error.stack
+            : undefined;
+        // Auto-categorize if needed
+        const category = input.category ??
+            (this.config.categorizeErrors ? categorizeError(errorString) : 'unknown');
+        // Check for repeats
+        let repeatCount = 1;
+        if (this.config.detectRepeats) {
+            repeatCount = this.countSimilarFailures(input.action, errorString);
+        }
+        const failure = {
+            id: `fail-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            timestamp: new Date().toISOString(),
+            action: input.action,
+            args: input.args,
+            error: errorString,
+            stackTrace: this.config.preserveStackTraces ? stackTrace : undefined,
+            category,
+            iteration: input.iteration,
+            intent: input.intent,
+            suggestion: '',
+            resolved: false,
+            repeatCount,
+        };
+        // Generate suggestion
+        failure.suggestion = generateSuggestion(failure);
+        // Store
+        this.failures.push(failure);
+        // Track by action
+        const actionFailures = this.actionHistory.get(input.action) || [];
+        actionFailures.push(failure.id);
+        this.actionHistory.set(input.action, actionFailures);
+        // Enforce max failures with eviction warning
+        if (this.failures.length > this.config.maxFailures) {
+            const evicted = this.failures.shift();
+            // Log warning about eviction
+            console.warn(`[FailureTracker] Evicted failure due to limit (${this.config.maxFailures}): ${evicted.action} - ${evicted.error.slice(0, 50)}`);
+            // Emit eviction event for observability
+            this.emit({
+                type: 'failure.evicted',
+                failure: evicted,
+                reason: `Max failures limit (${this.config.maxFailures}) exceeded`,
+            });
+            // Clean up action history
+            for (const [_action, ids] of this.actionHistory) {
+                const idx = ids.indexOf(evicted.id);
+                if (idx >= 0)
+                    ids.splice(idx, 1);
+            }
+        }
+        // Emit events
+        this.emit({ type: 'failure.recorded', failure });
+        if (repeatCount >= this.config.repeatWarningThreshold) {
+            this.emit({ type: 'failure.repeated', failure, count: repeatCount });
+        }
+        // Check for patterns
+        this.detectPatterns();
+        return failure;
+    }
+    /**
+     * Mark a failure as resolved.
+     */
+    resolveFailure(failureId) {
+        const failure = this.failures.find(f => f.id === failureId);
+        if (failure) {
+            failure.resolved = true;
+            this.emit({ type: 'failure.resolved', failureId });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get all unresolved failures.
+     */
+    getUnresolvedFailures() {
+        return this.failures.filter(f => !f.resolved);
+    }
+    /**
+     * Get failures by category.
+     */
+    getFailuresByCategory(category) {
+        return this.failures.filter(f => f.category === category);
+    }
+    /**
+     * Get failures by action.
+     */
+    getFailuresByAction(action) {
+        const ids = this.actionHistory.get(action) || [];
+        return this.failures.filter(f => ids.includes(f.id));
+    }
+    /**
+     * Get recent failures (last N).
+     */
+    getRecentFailures(count = 10) {
+        return this.failures.slice(-count);
+    }
+    /**
+     * Get failure context formatted for LLM inclusion.
+     */
+    getFailureContext(options = {}) {
+        const { maxFailures = 10, includeResolved = false, includeStackTraces = false, } = options;
+        let failures = includeResolved
+            ? this.failures
+            : this.failures.filter(f => !f.resolved);
+        failures = failures.slice(-maxFailures);
+        if (failures.length === 0) {
+            return '';
+        }
+        return formatFailureContext(failures, { includeStackTraces });
+    }
+    /**
+     * Check if an action has failed recently.
+     */
+    hasRecentFailure(action, withinMs = 60000) {
+        const cutoff = Date.now() - withinMs;
+        return this.failures.some(f => f.action === action && new Date(f.timestamp).getTime() > cutoff);
+    }
+    /**
+     * Get failure statistics.
+     */
+    getStats() {
+        const byCategory = {
+            permission: 0,
+            not_found: 0,
+            syntax: 0,
+            type: 0,
+            runtime: 0,
+            network: 0,
+            timeout: 0,
+            validation: 0,
+            logic: 0,
+            resource: 0,
+            unknown: 0,
+        };
+        for (const f of this.failures) {
+            byCategory[f.category]++;
+        }
+        const actionCounts = new Map();
+        for (const f of this.failures) {
+            actionCounts.set(f.action, (actionCounts.get(f.action) || 0) + 1);
+        }
+        const mostFailedActions = Array.from(actionCounts.entries())
+            .map(([action, count]) => ({ action, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 5);
+        return {
+            total: this.failures.length,
+            unresolved: this.failures.filter(f => !f.resolved).length,
+            byCategory,
+            mostFailedActions,
+        };
+    }
+    /**
+     * Clear all failures.
+     */
+    clear() {
+        this.failures = [];
+        this.actionHistory.clear();
+    }
+    /**
+     * Subscribe to events.
+     */
+    on(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    // Internal methods
+    countSimilarFailures(action, error) {
+        const normalizedError = error.toLowerCase().slice(0, 50);
+        return this.failures.filter(f => f.action === action && f.error.toLowerCase().startsWith(normalizedError)).length + 1;
+    }
+    detectPatterns() {
+        // Detect repeated action failures
+        for (const [action, ids] of this.actionHistory) {
+            if (ids.length >= 3) {
+                const recent = ids.slice(-3);
+                const recentFailures = this.failures.filter(f => recent.includes(f.id));
+                if (recentFailures.every(f => !f.resolved)) {
+                    this.emit({
+                        type: 'pattern.detected',
+                        pattern: {
+                            type: 'repeated_action',
+                            description: `Action "${action}" has failed ${ids.length} times`,
+                            failureIds: recent,
+                            confidence: Math.min(0.9, 0.3 + ids.length * 0.1),
+                            suggestion: `Consider an alternative approach. "${action}" is consistently failing.`,
+                        },
+                    });
+                }
+            }
+        }
+        // Detect category clusters
+        const recentFailures = this.failures.slice(-10);
+        const categoryCounts = new Map();
+        for (const f of recentFailures) {
+            categoryCounts.set(f.category, (categoryCounts.get(f.category) || 0) + 1);
+        }
+        for (const [category, count] of categoryCounts) {
+            if (count >= 5) {
+                this.emit({
+                    type: 'pattern.detected',
+                    pattern: {
+                        type: 'category_cluster',
+                        description: `Multiple ${category} errors (${count} of last 10)`,
+                        failureIds: recentFailures.filter(f => f.category === category).map(f => f.id),
+                        confidence: count / 10,
+                        suggestion: `Address the underlying ${category} issue before continuing.`,
+                    },
+                });
+            }
+        }
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+}
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create a failure tracker.
+ *
+ * @example
+ * ```typescript
+ * const tracker = createFailureTracker({
+ *   maxFailures: 30,
+ *   preserveStackTraces: true,
+ *   detectRepeats: true,
+ * });
+ *
+ * // Record failures during agent loop
+ * try {
+ *   await tool.execute(args);
+ * } catch (error) {
+ *   tracker.recordFailure({
+ *     action: tool.name,
+ *     args,
+ *     error,
+ *     iteration: currentIteration,
+ *   });
+ * }
+ *
+ * // Include failure context in prompts
+ * const failureContext = tracker.getFailureContext();
+ * if (failureContext) {
+ *   messages.push({
+ *     role: 'system',
+ *     content: failureContext,
+ *   });
+ * }
+ * ```
+ */
+export function createFailureTracker(config = {}) {
+    return new FailureTracker(config);
+}
+// =============================================================================
+// UTILITIES
+// =============================================================================
+/**
+ * Format failures as context for LLM.
+ */
+export function formatFailureContext(failures, options = {}) {
+    if (failures.length === 0)
+        return '';
+    const lines = [
+        '[Previous Failures - Learn from these to avoid repeating mistakes]',
+        '',
+    ];
+    for (const f of failures) {
+        lines.push(`**${f.action}** (${f.category}): ${f.error}`);
+        if (f.args && Object.keys(f.args).length > 0) {
+            lines.push(`  Args: ${JSON.stringify(f.args)}`);
+        }
+        if (f.suggestion) {
+            lines.push(`  → ${f.suggestion}`);
+        }
+        if (options.includeStackTraces && f.stackTrace) {
+            const shortStack = f.stackTrace.split('\n').slice(0, 3).join('\n');
+            lines.push(`  Stack: ${shortStack}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Create a warning message for repeated failures.
+ */
+export function createRepeatWarning(action, count, suggestion) {
+    let warning = `⚠️ Action "${action}" has failed ${count} times.`;
+    if (count >= 5) {
+        warning += ' Consider a completely different approach.';
+    }
+    else if (count >= 3) {
+        warning += ' Review previous errors before retrying.';
+    }
+    if (suggestion) {
+        warning += `\n💡 Suggestion: ${suggestion}`;
+    }
+    return warning;
+}
+/**
+ * Extract actionable insights from failures.
+ */
+export function extractInsights(failures) {
+    const insights = [];
+    // Group by category
+    const byCategory = new Map();
+    for (const f of failures) {
+        const group = byCategory.get(f.category) || [];
+        group.push(f);
+        byCategory.set(f.category, group);
+    }
+    // Generate insights
+    if (byCategory.has('permission') && byCategory.get('permission').length >= 2) {
+        insights.push('Multiple permission errors - check if running with sufficient privileges');
+    }
+    if (byCategory.has('not_found') && byCategory.get('not_found').length >= 2) {
+        insights.push('Multiple not-found errors - verify paths and use list_directory first');
+    }
+    if (byCategory.has('syntax') && byCategory.get('syntax').length >= 2) {
+        insights.push('Multiple syntax errors - validate code/JSON before execution');
+    }
+    if (byCategory.has('network') && byCategory.get('network').length >= 1) {
+        insights.push('Network issues detected - check connectivity and service availability');
+    }
+    if (byCategory.has('timeout') && byCategory.get('timeout').length >= 1) {
+        insights.push('Timeout detected - consider breaking operations into smaller chunks');
+    }
+    // Action-specific insights
+    const actionCounts = new Map();
+    for (const f of failures) {
+        actionCounts.set(f.action, (actionCounts.get(f.action) || 0) + 1);
+    }
+    for (const [action, count] of actionCounts) {
+        if (count >= 3) {
+            insights.push(`"${action}" failed ${count} times - try an alternative tool/approach`);
+        }
+    }
+    return insights;
+}
+/**
+ * Format failure stats for display.
+ */
+export function formatFailureStats(stats) {
+    const lines = [
+        `Failure Statistics:`,
+        `  Total: ${stats.total} (${stats.unresolved} unresolved)`,
+        '',
+        '  By Category:',
+    ];
+    for (const [category, count] of Object.entries(stats.byCategory)) {
+        if (count > 0) {
+            lines.push(`    ${category}: ${count}`);
+        }
+    }
+    if (stats.mostFailedActions.length > 0) {
+        lines.push('');
+        lines.push('  Most Failed Actions:');
+        for (const { action, count } of stats.mostFailedActions) {
+            lines.push(`    ${action}: ${count}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=failure-evidence.js.map

package/dist/src/tricks/failure-evidence.js.map

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

package/dist/src/tricks/json-utils.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Trick: JSON Utilities
+ *
+ * Robust JSON parsing utilities that handle:
+ * - Nested objects (the regex `\{[^}]*\}` problem)
+ * - Strings containing braces
+ * - Escaped quotes
+ * - Malformed JSON with recovery
+ * - LLM response extraction (code blocks, tool calls)
+ */
+export interface SafeParseOptions {
+    /** Context for error messages (e.g., "tool read_file") */
+    context?: string;
+    /** Whether to attempt recovery from malformed JSON */
+    attemptRecovery?: boolean;
+}
+export interface SafeParseResult<T = unknown> {
+    success: boolean;
+    value?: T;
+    error?: string;
+    /** Whether recovery was applied */
+    recovered?: boolean;
+}
+export interface ToolCall {
+    tool: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Extract a complete JSON object from text using brace-depth tracking.
+ *
+ * Unlike regex `\{[^}]*\}`, this properly handles:
+ * - Nested objects: `{"a": {"b": 1}}`
+ * - Nested arrays: `{"a": [1, [2, 3]]}`
+ * - Strings containing braces: `{"text": "hello { } world"}`
+ * - Escaped quotes: `{"text": "he said \"hi\""}`
+ *
+ * @param text - The text to search for JSON
+ * @param startFrom - Optional index to start searching from
+ * @returns The extracted JSON string and its end index, or null if not found
+ */
+export declare function extractJsonObject(text: string, startFrom?: number): {
+    json: string;
+    endIndex: number;
+} | null;
+/**
+ * Extract all JSON objects from text.
+ */
+export declare function extractAllJsonObjects(text: string): string[];
+/**
+ * Safely parse JSON with multi-level fallback and recovery.
+ *
+ * Fallback levels:
+ * 1. Direct JSON.parse
+ * 2. Extract JSON object from surrounding text
+ * 3. Attempt malformed JSON recovery (if enabled)
+ *
+ * @param input - Raw input (may be JSON or text containing JSON)
+ * @param options - Parsing options
+ */
+export declare function safeParseJson<T = unknown>(input: string, options?: SafeParseOptions): SafeParseResult<T>;
+/**
+ * Extract a tool call from an LLM response.
+ *
+ * Handles multiple formats:
+ * - Code block: ```json\n{"tool": "x", "input": {...}}\n```
+ * - Inline JSON: {"tool": "x", "input": {...}}
+ * - Nested inputs: {"tool": "x", "input": {"a": {"b": 1}}}
+ *
+ * @param response - The LLM response text
+ * @returns The extracted tool call, or null if not found
+ */
+export declare function extractToolCallJson(response: string): ToolCall | null;
+/**
+ * Extract multiple tool calls from a response.
+ */
+export declare function extractAllToolCalls(response: string): ToolCall[];
+//# sourceMappingURL=json-utils.d.ts.map

package/dist/src/tricks/json-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../../src/tricks/json-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,SAAI,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8C3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAa5D;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAAC,CAAC,CAAC,CAgDpB;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAuBrE;AAuBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAsBhE"}