attocode 0.1.0

package/dist/src/integrations/react.js

@@ -0,0 +1,273 @@
+/**
+ * Lesson 25: ReAct Pattern Integration
+ *
+ * Integrates the ReAct (Reasoning + Acting) pattern (from Lesson 18)
+ * into the production agent. Enables explicit reasoning traces
+ * with thought-action-observation loops.
+ */
+// =============================================================================
+// DEFAULT PATTERNS
+// =============================================================================
+const DEFAULT_PATTERNS = {
+    thought: /Thought:\s*(.+?)(?=Action:|Final Answer:|$)/is,
+    action: /Action:\s*(\w+)/i,
+    actionInput: /Action Input:\s*(.+?)(?=Thought:|Observation:|Final Answer:|$)/is,
+    observation: /Observation:\s*(.+?)(?=Thought:|Action:|Final Answer:|$)/is,
+    finalAnswer: /Final Answer:\s*(.+?)$/is,
+};
+const REACT_SYSTEM_PROMPT = `You are a helpful AI assistant that uses the ReAct (Reasoning + Acting) framework.
+
+For each step:
+1. Thought: Reason about what to do next
+2. Action: Choose a tool to use
+3. Action Input: Provide the input for the tool
+4. Observation: (This will be provided after tool execution)
+
+When you have enough information:
+Final Answer: Provide your final response
+
+Format your response exactly like this:
+Thought: I need to...
+Action: tool_name
+Action Input: {"param": "value"}
+
+Or when ready to answer:
+Thought: I now have enough information...
+Final Answer: The answer is...
+
+Available tools:
+{tools}`;
+// =============================================================================
+// REACT MANAGER
+// =============================================================================
+/**
+ * ReActManager implements the ReAct reasoning pattern.
+ */
+export class ReActManager {
+    provider;
+    tools;
+    config;
+    patterns;
+    listeners = [];
+    constructor(provider, tools, config = {}) {
+        this.provider = provider;
+        this.tools = new Map(tools.map(t => [t.name, t]));
+        this.config = {
+            maxSteps: config.maxSteps ?? 15,
+            stopOnAnswer: config.stopOnAnswer ?? true,
+            includeReasoning: config.includeReasoning ?? true,
+            patterns: config.patterns,
+        };
+        this.patterns = config.patterns ?? DEFAULT_PATTERNS;
+    }
+    /**
+     * Run a task using the ReAct pattern.
+     */
+    async run(task) {
+        this.emit({ type: 'react.start', task });
+        const trace = {
+            steps: [],
+            success: false,
+            totalSteps: 0,
+        };
+        const messages = [
+            { role: 'system', content: this.buildSystemPrompt() },
+            { role: 'user', content: task },
+        ];
+        for (let step = 1; step <= this.config.maxSteps; step++) {
+            // Get LLM response
+            const response = await this.provider.chat(messages);
+            const output = response.content;
+            // Parse the response
+            const parsed = this.parseOutput(output);
+            const reactStep = {
+                stepNumber: step,
+                thought: parsed.thought || 'No explicit thought',
+                isFinal: !!parsed.finalAnswer,
+            };
+            if (parsed.thought) {
+                this.emit({ type: 'react.thought', step, thought: parsed.thought });
+            }
+            // Check for final answer
+            if (parsed.finalAnswer) {
+                trace.finalAnswer = parsed.finalAnswer;
+                trace.success = true;
+                reactStep.isFinal = true;
+                trace.steps.push(reactStep);
+                this.emit({ type: 'react.answer', answer: parsed.finalAnswer });
+                break;
+            }
+            // Execute action if present
+            if (parsed.action && parsed.actionInput) {
+                const action = {
+                    tool: parsed.action,
+                    input: this.parseActionInput(parsed.actionInput),
+                };
+                reactStep.action = action;
+                this.emit({ type: 'react.action', step, action });
+                // Execute the tool
+                const observation = await this.executeAction(action);
+                reactStep.observation = observation;
+                this.emit({ type: 'react.observation', step, observation });
+                // Add to messages for next iteration
+                messages.push({ role: 'assistant', content: output }, { role: 'user', content: `Observation: ${observation}` });
+            }
+            else {
+                // No action, just add the response
+                messages.push({ role: 'assistant', content: output });
+            }
+            trace.steps.push(reactStep);
+            trace.totalSteps = step;
+        }
+        // If we exhausted steps without answer
+        if (!trace.finalAnswer) {
+            trace.success = false;
+            trace.finalAnswer = 'Maximum steps reached without a final answer.';
+        }
+        this.emit({ type: 'react.complete', trace });
+        return trace;
+    }
+    /**
+     * Subscribe to events.
+     */
+    on(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    /**
+     * Get the reasoning trace as a formatted string.
+     */
+    formatTrace(trace) {
+        const lines = [];
+        for (const step of trace.steps) {
+            lines.push(`=== Step ${step.stepNumber} ===`);
+            lines.push(`Thought: ${step.thought}`);
+            if (step.action) {
+                lines.push(`Action: ${step.action.tool}`);
+                lines.push(`Input: ${JSON.stringify(step.action.input)}`);
+            }
+            if (step.observation) {
+                lines.push(`Observation: ${step.observation}`);
+            }
+            if (step.isFinal) {
+                lines.push(`[Final Step]`);
+            }
+            lines.push('');
+        }
+        if (trace.finalAnswer) {
+            lines.push(`=== Final Answer ===`);
+            lines.push(trace.finalAnswer);
+        }
+        return lines.join('\n');
+    }
+    // -------------------------------------------------------------------------
+    // PRIVATE METHODS
+    // -------------------------------------------------------------------------
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    buildSystemPrompt() {
+        const toolDescriptions = Array.from(this.tools.values())
+            .map(t => `- ${t.name}: ${t.description}`)
+            .join('\n');
+        return REACT_SYSTEM_PROMPT.replace('{tools}', toolDescriptions);
+    }
+    parseOutput(output) {
+        const thoughtMatch = output.match(this.patterns.thought);
+        const actionMatch = output.match(this.patterns.action);
+        const actionInputMatch = output.match(this.patterns.actionInput);
+        const finalAnswerMatch = output.match(this.patterns.finalAnswer);
+        return {
+            thought: thoughtMatch?.[1]?.trim(),
+            action: actionMatch?.[1]?.trim(),
+            actionInput: actionInputMatch?.[1]?.trim(),
+            finalAnswer: finalAnswerMatch?.[1]?.trim(),
+        };
+    }
+    parseActionInput(input) {
+        try {
+            return JSON.parse(input);
+        }
+        catch {
+            // If not JSON, wrap as a single argument
+            return { input };
+        }
+    }
+    async executeAction(action) {
+        const tool = this.tools.get(action.tool);
+        if (!tool) {
+            return `Error: Unknown tool "${action.tool}". Available tools: ${Array.from(this.tools.keys()).join(', ')}`;
+        }
+        try {
+            const result = await tool.execute(action.input);
+            return this.formatObservation(result);
+        }
+        catch (error) {
+            return `Error executing ${action.tool}: ${error instanceof Error ? error.message : 'Unknown error'}`;
+        }
+    }
+    formatObservation(result) {
+        if (typeof result === 'string') {
+            return result;
+        }
+        if (result === null || result === undefined) {
+            return 'No result';
+        }
+        try {
+            return JSON.stringify(result, null, 2);
+        }
+        catch {
+            return String(result);
+        }
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a ReAct manager.
+ */
+export function createReActManager(provider, tools, config) {
+    return new ReActManager(provider, tools, config);
+}
+/**
+ * Extract all thoughts from a trace.
+ */
+export function extractThoughts(trace) {
+    return trace.steps
+        .map(s => s.thought)
+        .filter(t => t && t !== 'No explicit thought');
+}
+/**
+ * Extract all actions from a trace.
+ */
+export function extractActions(trace) {
+    return trace.steps
+        .filter(s => s.action)
+        .map(s => s.action);
+}
+/**
+ * Check if trace shows coherent reasoning.
+ */
+export function hasCoherentReasoning(trace) {
+    const thoughts = extractThoughts(trace);
+    // At least 2 thoughts for reasoning chain
+    if (thoughts.length < 2)
+        return false;
+    // Check for progression keywords
+    const progressionKeywords = ['then', 'next', 'now', 'based on', 'after', 'since'];
+    const hasProgression = thoughts.some(t => progressionKeywords.some(k => t.toLowerCase().includes(k)));
+    return hasProgression;
+}
+//# sourceMappingURL=react.js.map

package/dist/src/integrations/react.js.map

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

package/dist/src/integrations/resources.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Resource Monitor Integration
+ *
+ * Provides lightweight resource usage tracking and limits for agent operations.
+ * Integrates with the economics system to check both token budget AND system resources.
+ * Adapted from tricks/resource-monitor.ts.
+ *
+ * Usage:
+ *   const resources = createResourceManager({ maxMemoryMB: 512 });
+ *   const check = resources.check();
+ *   if (check.status === 'exceeded') { ... }
+ */
+/**
+ * Resource limits configuration.
+ */
+export interface ResourceLimitsConfig {
+    /** Enable/disable resource monitoring */
+    enabled?: boolean;
+    /** Max memory in MB */
+    maxMemoryMB?: number;
+    /** Max CPU time in seconds */
+    maxCpuTimeSec?: number;
+    /** Max concurrent operations */
+    maxConcurrentOps?: number;
+    /** Warning threshold (0-1) - emit warning when usage exceeds this */
+    warnThreshold?: number;
+    /** Critical threshold (0-1) - slow down operations when exceeded */
+    criticalThreshold?: number;
+}
+/**
+ * Current resource usage.
+ */
+export interface ResourceUsage {
+    memoryMB: number;
+    memoryPercent: number;
+    cpuTimeSec: number;
+    cpuPercent: number;
+    concurrentOps: number;
+    opsPercent: number;
+    timestamp: Date;
+}
+/**
+ * Resource status levels.
+ */
+export type ResourceStatus = 'healthy' | 'warning' | 'critical' | 'exceeded';
+/**
+ * Result of a resource check.
+ */
+export interface ResourceCheck {
+    status: ResourceStatus;
+    usage: ResourceUsage;
+    canContinue: boolean;
+    message?: string;
+    recommendation?: 'continue' | 'slow_down' | 'stop';
+}
+/**
+ * Resource event types.
+ */
+export type ResourceEvent = {
+    type: 'resource.warning';
+    metric: string;
+    value: number;
+    threshold: number;
+} | {
+    type: 'resource.critical';
+    metric: string;
+    value: number;
+    threshold: number;
+} | {
+    type: 'resource.exceeded';
+    metric: string;
+    value: number;
+    limit: number;
+} | {
+    type: 'resource.recovered';
+    metric: string;
+    previousStatus: ResourceStatus;
+};
+export type ResourceEventListener = (event: ResourceEvent) => void;
+/**
+ * Manages resource monitoring and limits for the agent.
+ */
+export declare class ResourceManager {
+    private config;
+    private startTime;
+    private concurrentOps;
+    private previousStatus;
+    private eventListeners;
+    constructor(config?: ResourceLimitsConfig);
+    /**
+     * Get current resource usage.
+     */
+    getUsage(): ResourceUsage;
+    /**
+     * Check resource status and determine if operations can continue.
+     */
+    check(): ResourceCheck;
+    /**
+     * Check if we can start a new operation.
+     */
+    canStartOperation(): boolean;
+    /**
+     * Track the start of an operation.
+     * Returns a function to call when the operation completes.
+     */
+    startOperation(): () => void;
+    /**
+     * Run a function with operation tracking.
+     * Throws ResourceLimitError if resources exceeded.
+     */
+    runTracked<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Run only if resources are available.
+     * Returns fallback value if resources exceeded.
+     */
+    runIfAvailable<T>(fn: () => Promise<T>, fallback?: T): Promise<T | undefined>;
+    /**
+     * Update resource limits.
+     */
+    setLimits(limits: Partial<ResourceLimitsConfig>): void;
+    /**
+     * Get current limits.
+     */
+    getLimits(): Required<ResourceLimitsConfig>;
+    /**
+     * Reset timing and operation count.
+     */
+    reset(): void;
+    /**
+     * Get formatted status string.
+     */
+    getStatusString(): string;
+    /**
+     * Subscribe to resource events.
+     */
+    subscribe(listener: ResourceEventListener): () => void;
+    /**
+     * Emit a resource event.
+     */
+    private emit;
+    /**
+     * Cleanup resources.
+     */
+    cleanup(): void;
+}
+/**
+ * Error thrown when resource limits are exceeded.
+ */
+export declare class ResourceLimitError extends Error {
+    readonly isResourceLimit = true;
+    constructor(message: string);
+}
+/**
+ * Check if an error is a resource limit error.
+ */
+export declare function isResourceLimitError(error: unknown): error is ResourceLimitError;
+/**
+ * Create a resource manager with default limits.
+ */
+export declare function createResourceManager(config?: ResourceLimitsConfig): ResourceManager;
+/**
+ * Create a strict resource manager (lower limits).
+ */
+export declare function createStrictResourceManager(): ResourceManager;
+/**
+ * Create a lenient resource manager (higher limits).
+ */
+export declare function createLenientResourceManager(): ResourceManager;
+/**
+ * Combine resource check with economics budget check.
+ * Returns true only if BOTH resource AND budget checks pass.
+ */
+export declare function combinedShouldContinue(resourceManager: ResourceManager | null, economicsShouldContinue: boolean): {
+    canContinue: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=resources.d.ts.map

package/dist/src/integrations/resources.d.ts.map

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