attocode 0.2.1 → 0.2.2

package/dist/src/integrations/auto-checkpoint.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Auto-Checkpoint Resumption
+ *
+ * Saves lightweight checkpoints at key execution points so that
+ * work can be recovered if the agent crashes or times out.
+ *
+ * Key points where checkpoints are saved:
+ * - After each tool batch execution
+ * - Before LLM calls (so the prompt is recoverable)
+ * - After significant state changes (plan approval, mode switch)
+ *
+ * On startup, detects recent sessions (<5 min) and offers auto-resume.
+ */
+export interface Checkpoint {
+    /** Unique checkpoint ID */
+    id: string;
+    /** Label describing the checkpoint point */
+    label: string;
+    /** Session ID this checkpoint belongs to */
+    sessionId: string;
+    /** Timestamp of the checkpoint */
+    timestamp: number;
+    /** Agent iteration count at this point */
+    iteration: number;
+    /** Messages up to this point (serialized) */
+    messages?: unknown[];
+    /** Current objective/task */
+    objective?: string;
+    /** Current mode */
+    mode?: string;
+    /** Files modified since last checkpoint */
+    filesModified?: string[];
+    /** Token usage at this point */
+    tokensUsed?: number;
+    /** Tool call history summary */
+    toolCallSummary?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface AutoCheckpointConfig {
+    /** Directory for checkpoint storage (default: '.agent/checkpoints') */
+    checkpointDir: string;
+    /** Maximum checkpoints to keep per session (default: 10) */
+    maxCheckpointsPerSession: number;
+    /** Auto-cleanup checkpoints older than this (ms, default: 3600000 = 1hr) */
+    maxAge: number;
+    /** Whether checkpointing is enabled (default: true) */
+    enabled: boolean;
+    /** Minimum interval between checkpoints (ms, default: 30000) */
+    minInterval: number;
+}
+export interface ResumeCandidate {
+    /** Session ID */
+    sessionId: string;
+    /** Most recent checkpoint */
+    checkpoint: Checkpoint;
+    /** Age of the checkpoint in ms */
+    ageMs: number;
+    /** Number of checkpoints available */
+    checkpointCount: number;
+}
+export declare class AutoCheckpointManager {
+    private config;
+    private lastCheckpointTime;
+    private checkpointCount;
+    constructor(config?: Partial<AutoCheckpointConfig>);
+    /**
+     * Save a checkpoint at a key execution point.
+     * Respects minInterval to avoid excessive I/O.
+     */
+    save(checkpoint: Omit<Checkpoint, 'id' | 'timestamp'>): string | null;
+    /**
+     * Load a specific checkpoint.
+     */
+    load(sessionId: string, checkpointId: string): Checkpoint | null;
+    /**
+     * Find sessions with recent checkpoints that could be resumed.
+     */
+    findResumeCandidates(maxAgeMs?: number): ResumeCandidate[];
+    /**
+     * Load all checkpoints for a session, sorted by timestamp.
+     */
+    loadSessionCheckpoints(sessionId: string): Checkpoint[];
+    /**
+     * Get a summary of a checkpoint for display.
+     */
+    formatCheckpointSummary(checkpoint: Checkpoint): string;
+    /**
+     * Clean up old checkpoints globally.
+     */
+    cleanupAll(): number;
+    private cleanupSession;
+}
+/**
+ * Create an auto-checkpoint manager.
+ */
+export declare function createAutoCheckpointManager(config?: Partial<AutoCheckpointConfig>): AutoCheckpointManager;
+//# sourceMappingURL=auto-checkpoint.d.ts.map

package/dist/src/integrations/auto-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-checkpoint.d.ts","sourceRoot":"","sources":["../../../src/integrations/auto-checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,wBAAwB,EAAE,MAAM,CAAC;IACjC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;CACzB;AAkBD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,eAAe,CAAK;gBAEhB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAYlD;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,MAAM,GAAG,IAAI;IA0CrE;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUhE;;OAEG;IACH,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IA2C1D;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAwBvD;;OAEG;IACH,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IA2BvD;;OAEG;IACH,UAAU,IAAI,MAAM;IAyCpB,OAAO,CAAC,cAAc;CAiBvB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,qBAAqB,CAEvB"}

package/dist/src/integrations/auto-checkpoint.js

@@ -0,0 +1,252 @@
+/**
+ * Auto-Checkpoint Resumption
+ *
+ * Saves lightweight checkpoints at key execution points so that
+ * work can be recovered if the agent crashes or times out.
+ *
+ * Key points where checkpoints are saved:
+ * - After each tool batch execution
+ * - Before LLM calls (so the prompt is recoverable)
+ * - After significant state changes (plan approval, mode switch)
+ *
+ * On startup, detects recent sessions (<5 min) and offers auto-resume.
+ */
+import { writeFileSync, readFileSync, mkdirSync, existsSync, readdirSync, statSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    checkpointDir: '.agent/checkpoints',
+    maxCheckpointsPerSession: 10,
+    maxAge: 3600000, // 1 hour
+    enabled: true,
+    minInterval: 30000, // 30 seconds
+};
+// =============================================================================
+// AUTO-CHECKPOINT MANAGER
+// =============================================================================
+export class AutoCheckpointManager {
+    config;
+    lastCheckpointTime = 0;
+    checkpointCount = 0;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        if (this.config.enabled) {
+            try {
+                mkdirSync(this.config.checkpointDir, { recursive: true });
+            }
+            catch {
+                // Directory creation may fail
+            }
+        }
+    }
+    /**
+     * Save a checkpoint at a key execution point.
+     * Respects minInterval to avoid excessive I/O.
+     */
+    save(checkpoint) {
+        if (!this.config.enabled)
+            return null;
+        const now = Date.now();
+        if (now - this.lastCheckpointTime < this.config.minInterval) {
+            return null; // Too soon since last checkpoint
+        }
+        const id = `ckpt-${now}-${Math.random().toString(36).slice(2, 6)}`;
+        const fullCheckpoint = {
+            ...checkpoint,
+            id,
+            timestamp: now,
+        };
+        try {
+            const sessionDir = join(this.config.checkpointDir, checkpoint.sessionId);
+            mkdirSync(sessionDir, { recursive: true });
+            const filePath = join(sessionDir, `${id}.json`);
+            // Don't persist full messages array to save space - just metadata
+            const persistable = {
+                ...fullCheckpoint,
+                messages: undefined, // Strip messages to keep checkpoints small
+                _messageCount: fullCheckpoint.messages?.length ?? 0,
+            };
+            writeFileSync(filePath, JSON.stringify(persistable, null, 2), 'utf-8');
+            this.lastCheckpointTime = now;
+            this.checkpointCount++;
+            // Cleanup old checkpoints for this session
+            this.cleanupSession(checkpoint.sessionId);
+            return id;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load a specific checkpoint.
+     */
+    load(sessionId, checkpointId) {
+        try {
+            const filePath = join(this.config.checkpointDir, sessionId, `${checkpointId}.json`);
+            const content = readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Find sessions with recent checkpoints that could be resumed.
+     */
+    findResumeCandidates(maxAgeMs) {
+        const maxAge = maxAgeMs ?? 300000; // Default: 5 minutes
+        const now = Date.now();
+        const candidates = [];
+        try {
+            if (!existsSync(this.config.checkpointDir))
+                return [];
+            const sessions = readdirSync(this.config.checkpointDir);
+            for (const sessionId of sessions) {
+                const sessionDir = join(this.config.checkpointDir, sessionId);
+                try {
+                    const stat = statSync(sessionDir);
+                    if (!stat.isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                const checkpoints = this.loadSessionCheckpoints(sessionId);
+                if (checkpoints.length === 0)
+                    continue;
+                // Most recent checkpoint
+                const latest = checkpoints[checkpoints.length - 1];
+                const age = now - latest.timestamp;
+                if (age <= maxAge) {
+                    candidates.push({
+                        sessionId,
+                        checkpoint: latest,
+                        ageMs: age,
+                        checkpointCount: checkpoints.length,
+                    });
+                }
+            }
+        }
+        catch {
+            // Directory reading may fail
+        }
+        // Sort by recency (most recent first)
+        return candidates.sort((a, b) => a.ageMs - b.ageMs);
+    }
+    /**
+     * Load all checkpoints for a session, sorted by timestamp.
+     */
+    loadSessionCheckpoints(sessionId) {
+        const sessionDir = join(this.config.checkpointDir, sessionId);
+        const checkpoints = [];
+        try {
+            if (!existsSync(sessionDir))
+                return [];
+            const files = readdirSync(sessionDir).filter(f => f.endsWith('.json'));
+            for (const file of files) {
+                try {
+                    const content = readFileSync(join(sessionDir, file), 'utf-8');
+                    checkpoints.push(JSON.parse(content));
+                }
+                catch {
+                    // Skip malformed checkpoints
+                }
+            }
+        }
+        catch {
+            return [];
+        }
+        return checkpoints.sort((a, b) => a.timestamp - b.timestamp);
+    }
+    /**
+     * Get a summary of a checkpoint for display.
+     */
+    formatCheckpointSummary(checkpoint) {
+        const age = Date.now() - checkpoint.timestamp;
+        const ageStr = age < 60000
+            ? `${Math.round(age / 1000)}s ago`
+            : `${Math.round(age / 60000)}m ago`;
+        const lines = [
+            `Session: ${checkpoint.sessionId}`,
+            `Checkpoint: ${checkpoint.label} (${ageStr})`,
+            `Iteration: ${checkpoint.iteration}`,
+        ];
+        if (checkpoint.objective) {
+            lines.push(`Objective: ${checkpoint.objective.slice(0, 100)}`);
+        }
+        if (checkpoint.tokensUsed) {
+            lines.push(`Tokens used: ${checkpoint.tokensUsed}`);
+        }
+        if (checkpoint.filesModified && checkpoint.filesModified.length > 0) {
+            lines.push(`Files modified: ${checkpoint.filesModified.join(', ')}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Clean up old checkpoints globally.
+     */
+    cleanupAll() {
+        let cleaned = 0;
+        const now = Date.now();
+        try {
+            if (!existsSync(this.config.checkpointDir))
+                return 0;
+            const sessions = readdirSync(this.config.checkpointDir);
+            for (const sessionId of sessions) {
+                const sessionDir = join(this.config.checkpointDir, sessionId);
+                try {
+                    const stat = statSync(sessionDir);
+                    if (!stat.isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                const checkpoints = this.loadSessionCheckpoints(sessionId);
+                for (const ckpt of checkpoints) {
+                    if (now - ckpt.timestamp > this.config.maxAge) {
+                        try {
+                            unlinkSync(join(sessionDir, `${ckpt.id}.json`));
+                            cleaned++;
+                        }
+                        catch {
+                            // Deletion may fail
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory operations may fail
+        }
+        return cleaned;
+    }
+    // ===========================================================================
+    // INTERNAL
+    // ===========================================================================
+    cleanupSession(sessionId) {
+        const checkpoints = this.loadSessionCheckpoints(sessionId);
+        if (checkpoints.length > this.config.maxCheckpointsPerSession) {
+            // Remove oldest checkpoints
+            const toRemove = checkpoints.slice(0, checkpoints.length - this.config.maxCheckpointsPerSession);
+            const sessionDir = join(this.config.checkpointDir, sessionId);
+            for (const ckpt of toRemove) {
+                try {
+                    unlinkSync(join(sessionDir, `${ckpt.id}.json`));
+                }
+                catch {
+                    // Deletion may fail
+                }
+            }
+        }
+    }
+}
+/**
+ * Create an auto-checkpoint manager.
+ */
+export function createAutoCheckpointManager(config) {
+    return new AutoCheckpointManager(config);
+}
+//# sourceMappingURL=auto-checkpoint.js.map

package/dist/src/integrations/auto-checkpoint.js.map

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

package/dist/src/integrations/complexity-classifier.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Complexity Classifier
+ *
+ * Heuristic-based task complexity assessment that determines
+ * the appropriate execution strategy (agent count, tool budget,
+ * swarm mode) without requiring an LLM call.
+ *
+ * Inspired by Anthropic's multi-agent research system's approach
+ * to scaling effort based on task complexity.
+ */
+export type ComplexityTier = 'simple' | 'medium' | 'complex' | 'deep_research';
+export interface ComplexityAssessment {
+    /** Classified complexity tier */
+    tier: ComplexityTier;
+    /** Confidence in the classification (0-1) */
+    confidence: number;
+    /** Human-readable reasoning */
+    reasoning: string;
+    /** Recommended execution parameters */
+    recommendation: ExecutionRecommendation;
+    /** Signals that contributed to the classification */
+    signals: ComplexitySignal[];
+}
+export interface ExecutionRecommendation {
+    /** Number of agents to use */
+    agentCount: {
+        min: number;
+        max: number;
+    };
+    /** Tool calls per agent */
+    toolCallsPerAgent: {
+        min: number;
+        max: number;
+    };
+    /** Whether to use swarm mode */
+    useSwarmMode: boolean;
+    /** Suggested agent types */
+    suggestedAgents: string[];
+    /** Budget multiplier relative to standard */
+    budgetMultiplier: number;
+    /** Whether extended thinking is recommended */
+    useExtendedThinking: boolean;
+}
+export interface ComplexitySignal {
+    name: string;
+    value: number;
+    weight: number;
+    description: string;
+}
+export interface ClassificationContext {
+    /** Number of files in the project */
+    projectFileCount?: number;
+    /** Whether the task references specific files */
+    referencesFiles?: boolean;
+    /** Previous task in the session (for context) */
+    previousTask?: string;
+    /** Currently active plan */
+    hasActivePlan?: boolean;
+}
+/**
+ * Classify task complexity using heuristic signals.
+ * No LLM call needed — fast and deterministic.
+ */
+export declare function classifyComplexity(task: string, context?: ClassificationContext): ComplexityAssessment;
+/**
+ * Generate scaling guidance for injection into the agent's system prompt.
+ * This follows Anthropic's pattern of embedding scaling rules directly in prompts.
+ */
+export declare function getScalingGuidance(assessment: ComplexityAssessment): string;
+/**
+ * Create a complexity classifier with custom thresholds.
+ */
+export declare function createComplexityClassifier(config?: {
+    simpleThreshold?: number;
+    mediumThreshold?: number;
+    complexThreshold?: number;
+}): {
+    classify: (task: string, context?: ClassificationContext) => ComplexityAssessment;
+    getScalingGuidance: typeof getScalingGuidance;
+    thresholds: {
+        simple: number;
+        medium: number;
+        complex: number;
+    };
+};
+//# sourceMappingURL=complexity-classifier.d.ts.map

package/dist/src/integrations/complexity-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-classifier.d.ts","sourceRoot":"","sources":["../../../src/integrations/complexity-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,cAAc,EAAE,uBAAuB,CAAC;IACxC,qDAAqD;IACrD,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,2BAA2B;IAC3B,iBAAiB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,gCAAgC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA+ED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CA2GtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAgC3E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;qBAQoB,MAAM,YAAY,qBAAqB;;;;;;;EAK3D"}