attocode 0.1.0

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * Lesson 23: Planning Integration
+ *
+ * Integrates planning (Lesson 15) and reflection (Lesson 16) into the production agent.
+ * Provides task decomposition and self-improvement capabilities.
+ */
+import type { PlanningConfig, ReflectionConfig, AgentPlan, PlanTask, LLMProvider } from '../types.js';
+/**
+ * Manages planning and reflection for the agent.
+ */
+export declare class PlanningManager {
+    private planningConfig;
+    private reflectionConfig;
+    private currentPlan;
+    constructor(planningConfig: PlanningConfig, reflectionConfig: ReflectionConfig);
+    /**
+     * Determine if task needs planning.
+     */
+    shouldPlan(task: string): boolean;
+    /**
+     * Estimate task complexity (1-10 scale).
+     */
+    estimateComplexity(task: string): number;
+    /**
+     * Create a plan for a task.
+     */
+    createPlan(task: string, provider: LLMProvider): Promise<AgentPlan>;
+    /**
+     * Parse plan response from LLM.
+     */
+    private parsePlanResponse;
+    /**
+     * Create a simple fallback plan.
+     */
+    private createFallbackPlan;
+    /**
+     * Get the current plan.
+     */
+    getCurrentPlan(): AgentPlan | null;
+    /**
+     * Get the current task to work on.
+     */
+    getCurrentTask(): PlanTask | null;
+    /**
+     * Get next available task (dependencies satisfied).
+     */
+    getNextTask(): PlanTask | null;
+    /**
+     * Mark a task as started.
+     */
+    startTask(taskId: string): void;
+    /**
+     * Mark a task as completed.
+     */
+    completeTask(taskId: string): void;
+    /**
+     * Mark a task as failed.
+     */
+    failTask(taskId: string): void;
+    /**
+     * Check if plan is complete.
+     */
+    isPlanComplete(): boolean;
+    /**
+     * Clear the current plan.
+     */
+    clearPlan(): void;
+    /**
+     * Load a plan from a checkpoint.
+     */
+    loadPlan(plan: AgentPlan): void;
+    /**
+     * Reflect on an output and determine if it's satisfactory.
+     */
+    reflect(goal: string, output: string, provider: LLMProvider): Promise<ReflectionResult>;
+    /**
+     * Parse reflection response.
+     */
+    private parseReflectionResponse;
+    /**
+     * Run a reflection loop on a task.
+     */
+    reflectionLoop(task: () => Promise<string>, goal: string, provider: LLMProvider): Promise<{
+        output: string;
+        attempts: number;
+        reflections: ReflectionResult[];
+    }>;
+}
+export interface ReflectionResult {
+    satisfied: boolean;
+    confidence: number;
+    critique: string;
+    suggestions: string[];
+}
+export declare function createPlanningManager(planningConfig: PlanningConfig, reflectionConfig: ReflectionConfig): PlanningManager;
+//# sourceMappingURL=planning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../src/integrations/planning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,WAAW,EAEZ,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAA0B;gBAEjC,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB;IAK9E;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOjC;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA4BxC;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAwCzE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,cAAc,IAAI,SAAS,GAAG,IAAI;IAIlC;;OAEG;IACH,cAAc,IAAI,QAAQ,GAAG,IAAI;IASjC;;OAEG;IACH,WAAW,IAAI,QAAQ,GAAG,IAAI;IAoB9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS/B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUlC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS9B;;OAEG;IACH,cAAc,IAAI,OAAO;IAQzB;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAQ/B;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,gBAAgB,CAAC;IAyC5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;OAEG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;CA+BlF;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,gBAAgB,GACjC,eAAe,CAEjB"}

package/dist/src/integrations/planning.js

@@ -0,0 +1,338 @@
+/**
+ * Lesson 23: Planning Integration
+ *
+ * Integrates planning (Lesson 15) and reflection (Lesson 16) into the production agent.
+ * Provides task decomposition and self-improvement capabilities.
+ */
+// =============================================================================
+// PLANNING MANAGER
+// =============================================================================
+/**
+ * Manages planning and reflection for the agent.
+ */
+export class PlanningManager {
+    planningConfig;
+    reflectionConfig;
+    currentPlan = null;
+    constructor(planningConfig, reflectionConfig) {
+        this.planningConfig = planningConfig;
+        this.reflectionConfig = reflectionConfig;
+    }
+    /**
+     * Determine if task needs planning.
+     */
+    shouldPlan(task) {
+        if (!this.planningConfig.autoplan)
+            return false;
+        const complexity = this.estimateComplexity(task);
+        return complexity >= (this.planningConfig.complexityThreshold || 5);
+    }
+    /**
+     * Estimate task complexity (1-10 scale).
+     */
+    estimateComplexity(task) {
+        let score = 1;
+        // Length-based complexity
+        if (task.length > 100)
+            score += 1;
+        if (task.length > 200)
+            score += 1;
+        // Keyword-based complexity
+        const complexKeywords = [
+            'implement', 'refactor', 'migrate', 'integrate', 'build',
+            'create', 'design', 'architect', 'optimize', 'debug',
+            'multiple', 'several', 'all', 'entire', 'complete',
+        ];
+        for (const keyword of complexKeywords) {
+            if (task.toLowerCase().includes(keyword)) {
+                score += 0.5;
+            }
+        }
+        // Multi-step indicators
+        if (task.includes(' and ') || task.includes(' then '))
+            score += 1;
+        if (task.includes('1.') || task.includes('first'))
+            score += 1;
+        // Cap at 10
+        return Math.min(Math.round(score), 10);
+    }
+    /**
+     * Create a plan for a task.
+     */
+    async createPlan(task, provider) {
+        const planPrompt = `Break down this task into concrete steps:
+
+Task: ${task}
+
+Return a JSON array of steps, each with:
+- id: unique identifier (step-1, step-2, etc.)
+- description: what needs to be done
+- dependencies: array of step IDs this depends on (empty for first steps)
+
+Example format:
+[
+  { "id": "step-1", "description": "Analyze current code", "dependencies": [] },
+  { "id": "step-2", "description": "Design new structure", "dependencies": ["step-1"] }
+]
+
+Return ONLY the JSON array, no other text.`;
+        const messages = [
+            { role: 'user', content: planPrompt },
+        ];
+        try {
+            const response = await provider.chat(messages);
+            const tasks = this.parsePlanResponse(response.content, task);
+            this.currentPlan = {
+                goal: task,
+                tasks,
+                currentTaskIndex: 0,
+            };
+            return this.currentPlan;
+        }
+        catch (err) {
+            // Fallback to simple plan
+            console.warn('[Planning] Failed to create detailed plan, using fallback');
+            return this.createFallbackPlan(task);
+        }
+    }
+    /**
+     * Parse plan response from LLM.
+     */
+    parsePlanResponse(content, goal) {
+        try {
+            // Extract JSON from response
+            const jsonMatch = content.match(/\[[\s\S]*\]/);
+            if (!jsonMatch) {
+                throw new Error('No JSON array found');
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (!Array.isArray(parsed)) {
+                throw new Error('Response is not an array');
+            }
+            return parsed.map((item, index) => ({
+                id: String(item.id || `step-${index + 1}`),
+                description: String(item.description || `Step ${index + 1}`),
+                status: 'pending',
+                dependencies: Array.isArray(item.dependencies)
+                    ? item.dependencies.map(String)
+                    : [],
+            }));
+        }
+        catch (err) {
+            console.warn('[Planning] Failed to parse plan:', err);
+            return this.createFallbackPlan(goal).tasks;
+        }
+    }
+    /**
+     * Create a simple fallback plan.
+     */
+    createFallbackPlan(task) {
+        return {
+            goal: task,
+            tasks: [
+                { id: 'step-1', description: 'Understand the requirements', status: 'pending', dependencies: [] },
+                { id: 'step-2', description: 'Execute the task', status: 'pending', dependencies: ['step-1'] },
+                { id: 'step-3', description: 'Verify the results', status: 'pending', dependencies: ['step-2'] },
+            ],
+            currentTaskIndex: 0,
+        };
+    }
+    /**
+     * Get the current plan.
+     */
+    getCurrentPlan() {
+        return this.currentPlan;
+    }
+    /**
+     * Get the current task to work on.
+     */
+    getCurrentTask() {
+        if (!this.currentPlan)
+            return null;
+        const { tasks, currentTaskIndex } = this.currentPlan;
+        if (currentTaskIndex >= tasks.length)
+            return null;
+        return tasks[currentTaskIndex];
+    }
+    /**
+     * Get next available task (dependencies satisfied).
+     */
+    getNextTask() {
+        if (!this.currentPlan)
+            return null;
+        for (const task of this.currentPlan.tasks) {
+            if (task.status !== 'pending')
+                continue;
+            // Check dependencies
+            const depsComplete = task.dependencies.every((depId) => {
+                const dep = this.currentPlan.tasks.find((t) => t.id === depId);
+                return dep?.status === 'completed';
+            });
+            if (depsComplete) {
+                return task;
+            }
+        }
+        return null;
+    }
+    /**
+     * Mark a task as started.
+     */
+    startTask(taskId) {
+        if (!this.currentPlan)
+            return;
+        const task = this.currentPlan.tasks.find((t) => t.id === taskId);
+        if (task) {
+            task.status = 'in_progress';
+        }
+    }
+    /**
+     * Mark a task as completed.
+     */
+    completeTask(taskId) {
+        if (!this.currentPlan)
+            return;
+        const task = this.currentPlan.tasks.find((t) => t.id === taskId);
+        if (task) {
+            task.status = 'completed';
+            this.currentPlan.currentTaskIndex++;
+        }
+    }
+    /**
+     * Mark a task as failed.
+     */
+    failTask(taskId) {
+        if (!this.currentPlan)
+            return;
+        const task = this.currentPlan.tasks.find((t) => t.id === taskId);
+        if (task) {
+            task.status = 'failed';
+        }
+    }
+    /**
+     * Check if plan is complete.
+     */
+    isPlanComplete() {
+        if (!this.currentPlan)
+            return true;
+        return this.currentPlan.tasks.every((t) => t.status === 'completed' || t.status === 'failed');
+    }
+    /**
+     * Clear the current plan.
+     */
+    clearPlan() {
+        this.currentPlan = null;
+    }
+    /**
+     * Load a plan from a checkpoint.
+     */
+    loadPlan(plan) {
+        this.currentPlan = { ...plan };
+    }
+    // ===========================================================================
+    // REFLECTION
+    // ===========================================================================
+    /**
+     * Reflect on an output and determine if it's satisfactory.
+     */
+    async reflect(goal, output, provider) {
+        const reflectionPrompt = `Evaluate this output against the goal.
+
+Goal: ${goal}
+
+Output:
+${output}
+
+Evaluate:
+1. Does the output fully address the goal?
+2. Are there any errors or issues?
+3. What could be improved?
+
+Respond in JSON format:
+{
+  "satisfied": true/false,
+  "confidence": 0.0-1.0,
+  "critique": "brief critique",
+  "suggestions": ["suggestion 1", "suggestion 2"]
+}
+
+Return ONLY the JSON, no other text.`;
+        const messages = [
+            { role: 'user', content: reflectionPrompt },
+        ];
+        try {
+            const response = await provider.chat(messages);
+            return this.parseReflectionResponse(response.content);
+        }
+        catch (err) {
+            console.warn('[Reflection] Failed to reflect:', err);
+            return {
+                satisfied: true,
+                confidence: 0.5,
+                critique: 'Unable to reflect on output',
+                suggestions: [],
+            };
+        }
+    }
+    /**
+     * Parse reflection response.
+     */
+    parseReflectionResponse(content) {
+        try {
+            const jsonMatch = content.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                throw new Error('No JSON object found');
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            return {
+                satisfied: Boolean(parsed.satisfied),
+                confidence: Number(parsed.confidence) || 0.5,
+                critique: String(parsed.critique || ''),
+                suggestions: Array.isArray(parsed.suggestions)
+                    ? parsed.suggestions.map(String)
+                    : [],
+            };
+        }
+        catch (err) {
+            return {
+                satisfied: true,
+                confidence: 0.5,
+                critique: 'Unable to parse reflection',
+                suggestions: [],
+            };
+        }
+    }
+    /**
+     * Run a reflection loop on a task.
+     */
+    async reflectionLoop(task, goal, provider) {
+        const maxAttempts = this.reflectionConfig.maxAttempts || 3;
+        const threshold = this.reflectionConfig.confidenceThreshold || 0.8;
+        const reflections = [];
+        let output = '';
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+            attempts++;
+            output = await task();
+            if (!this.reflectionConfig.autoReflect && attempts === 1) {
+                // No auto-reflection, return first output
+                break;
+            }
+            const reflection = await this.reflect(goal, output, provider);
+            reflections.push(reflection);
+            if (reflection.satisfied && reflection.confidence >= threshold) {
+                break;
+            }
+            if (attempts < maxAttempts) {
+                console.log(`[Reflection] Attempt ${attempts} not satisfactory, retrying...`);
+            }
+        }
+        return { output, attempts, reflections };
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+export function createPlanningManager(planningConfig, reflectionConfig) {
+    return new PlanningManager(planningConfig, reflectionConfig);
+}
+//# sourceMappingURL=planning.js.map

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

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

package/dist/src/integrations/pty-shell.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Persistent PTY Shell
+ *
+ * Provides a persistent shell session that maintains state between commands.
+ * Uses Node.js child_process with PTY-like behavior.
+ *
+ * Key features:
+ * - Persistent shell process (bash/zsh)
+ * - Command history tracking
+ * - Environment inheritance
+ * - Working directory state
+ * - Output buffering with timeout
+ */
+export interface PTYShellConfig {
+    /** Shell to use (default: auto-detect) */
+    shell?: string;
+    /** Initial working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Command timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Maximum output buffer size (default: 1MB) */
+    maxOutputSize?: number;
+    /** Shell prompt to detect command completion */
+    promptPattern?: string;
+}
+export interface CommandResult {
+    output: string;
+    exitCode: number | null;
+    duration: number;
+    timedOut: boolean;
+}
+export interface ShellState {
+    cwd: string;
+    env: Record<string, string>;
+    history: string[];
+    isRunning: boolean;
+    pid?: number;
+}
+export type PTYEvent = {
+    type: 'shell.started';
+    pid: number;
+    shell: string;
+} | {
+    type: 'shell.stopped';
+    exitCode: number | null;
+} | {
+    type: 'command.start';
+    command: string;
+} | {
+    type: 'command.output';
+    data: string;
+} | {
+    type: 'command.complete';
+    result: CommandResult;
+} | {
+    type: 'command.timeout';
+    command: string;
+} | {
+    type: 'error';
+    error: string;
+};
+export type PTYEventListener = (event: PTYEvent) => void;
+/**
+ * Manages persistent shell sessions.
+ */
+export declare class PTYShellManager {
+    private config;
+    private process;
+    private outputBuffer;
+    private commandHistory;
+    private currentCwd;
+    private currentEnv;
+    private commandResolve;
+    private commandStartTime;
+    private commandTimeoutId;
+    private eventListeners;
+    private readonly endMarker;
+    constructor(config?: PTYShellConfig);
+    /**
+     * Auto-detect the user's preferred shell.
+     */
+    private detectShell;
+    /**
+     * Start the persistent shell.
+     */
+    start(): Promise<void>;
+    /**
+     * Handle output from the shell.
+     */
+    private handleOutput;
+    /**
+     * Handle command completion.
+     */
+    private handleCommandComplete;
+    /**
+     * Execute a command in the persistent shell.
+     */
+    execute(command: string): Promise<CommandResult>;
+    /**
+     * Change the working directory.
+     */
+    cd(directory: string): Promise<CommandResult>;
+    /**
+     * Set an environment variable.
+     */
+    setEnv(key: string, value: string): Promise<void>;
+    /**
+     * Get the current state.
+     */
+    getState(): ShellState;
+    /**
+     * Get command history.
+     */
+    getHistory(): string[];
+    /**
+     * Clear command history.
+     */
+    clearHistory(): void;
+    /**
+     * Subscribe to events.
+     */
+    subscribe(listener: PTYEventListener): () => void;
+    /**
+     * Emit an event.
+     */
+    private emitEvent;
+    /**
+     * Stop the shell.
+     */
+    stop(): Promise<void>;
+    /**
+     * Cleanup resources.
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Create a PTY shell manager.
+ */
+export declare function createPTYShell(config?: PTYShellConfig): PTYShellManager;
+/**
+ * Create and start a PTY shell.
+ */
+export declare function createAndStartPTYShell(config?: PTYShellConfig): Promise<PTYShellManager>;
+/**
+ * Create a shell execution tool that uses the persistent PTY.
+ */
+export declare function createPTYShellTool(shell: PTYShellManager): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            command: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    dangerLevel: "dangerous";
+    execute(args: Record<string, unknown>): Promise<string>;
+};
+/**
+ * Format shell state for display.
+ */
+export declare function formatShellState(state: ShellState): string;
+//# sourceMappingURL=pty-shell.d.ts.map

package/dist/src/integrations/pty-shell.d.ts.map

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