attocode 0.1.0

package/dist/src/integrations/pending-plan.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Pending Plan Manager
+ *
+ * Manages plans that are awaiting user approval before execution.
+ * Used in "plan mode" where write operations are intercepted and queued
+ * as proposed changes rather than being executed immediately.
+ *
+ * @example
+ * ```typescript
+ * const planManager = createPendingPlanManager();
+ *
+ * // In plan mode, intercept a write operation
+ * planManager.addProposedChange({
+ *   tool: 'write_file',
+ *   args: { path: 'src/main.ts', content: '...' },
+ *   reason: 'Create entry point for the application',
+ * });
+ *
+ * // User approves the plan
+ * const changes = planManager.approve();
+ * for (const change of changes) {
+ *   await executeTool(change.tool, change.args);
+ * }
+ * ```
+ */
+/**
+ * Status of a pending plan.
+ */
+export type PlanStatus = 'pending' | 'approved' | 'rejected' | 'partially_approved';
+/**
+ * A proposed change that will be executed if the plan is approved.
+ */
+export interface ProposedChange {
+    /** Unique ID for this change */
+    id: string;
+    /** The tool that would be called */
+    tool: string;
+    /** Arguments for the tool call */
+    args: Record<string, unknown>;
+    /** LLM's explanation of why this change is needed */
+    reason: string;
+    /** Order in which this change should be executed */
+    order: number;
+    /** Timestamp when this change was proposed */
+    proposedAt: string;
+    /** Optional: The tool call ID from the LLM response */
+    toolCallId?: string;
+}
+/**
+ * A pending plan awaiting user approval.
+ */
+export interface PendingPlan {
+    /** Unique plan ID */
+    id: string;
+    /** The original task/prompt that led to this plan */
+    task: string;
+    /** When the plan was created */
+    createdAt: string;
+    /** When the plan was last updated */
+    updatedAt: string;
+    /** The proposed changes in execution order */
+    proposedChanges: ProposedChange[];
+    /** Summary of exploration done before proposing changes */
+    explorationSummary: string;
+    /** Current status of the plan */
+    status: PlanStatus;
+    /** Session ID this plan belongs to */
+    sessionId?: string;
+}
+/**
+ * Result of approving a plan.
+ */
+export interface PlanApprovalResult {
+    /** Changes to execute */
+    changes: ProposedChange[];
+    /** Number of changes skipped (if partial approval) */
+    skippedCount: number;
+}
+/**
+ * Event types emitted by the plan manager.
+ */
+export type PendingPlanEvent = {
+    type: 'plan.created';
+    plan: PendingPlan;
+} | {
+    type: 'plan.change.added';
+    change: ProposedChange;
+    planId: string;
+} | {
+    type: 'plan.approved';
+    planId: string;
+    changeCount: number;
+} | {
+    type: 'plan.rejected';
+    planId: string;
+} | {
+    type: 'plan.cleared';
+    planId: string;
+};
+export type PendingPlanEventListener = (event: PendingPlanEvent) => void;
+/**
+ * Manages pending plans that await user approval.
+ */
+export declare class PendingPlanManager {
+    private currentPlan;
+    private changeCounter;
+    private eventListeners;
+    /**
+     * Start a new pending plan.
+     * Clears any existing plan.
+     */
+    startPlan(task: string, sessionId?: string): PendingPlan;
+    /**
+     * Add a proposed change to the current plan.
+     * Returns the created change, or null if no plan is active.
+     */
+    addProposedChange(tool: string, args: Record<string, unknown>, reason: string, toolCallId?: string): ProposedChange | null;
+    /**
+     * Set the exploration summary for the current plan.
+     */
+    setExplorationSummary(summary: string): void;
+    /**
+     * Get the current pending plan.
+     */
+    getPendingPlan(): PendingPlan | null;
+    /**
+     * Check if there's an active pending plan.
+     */
+    hasPendingPlan(): boolean;
+    /**
+     * Get the number of proposed changes.
+     */
+    getChangeCount(): number;
+    /**
+     * Approve the pending plan.
+     * @param count - If provided, only approve the first N changes
+     * @returns The changes to execute
+     */
+    approve(count?: number): PlanApprovalResult;
+    /**
+     * Reject the pending plan.
+     * Clears all proposed changes.
+     */
+    reject(): void;
+    /**
+     * Clear the current plan without changing status.
+     */
+    clear(): void;
+    /**
+     * Restore a plan from storage.
+     */
+    restorePlan(plan: PendingPlan): void;
+    /**
+     * Format the pending plan for display.
+     */
+    formatPlan(): string;
+    /**
+     * Subscribe to plan events.
+     */
+    subscribe(listener: PendingPlanEventListener): () => void;
+    private emit;
+}
+/**
+ * Create a new pending plan manager.
+ */
+export declare function createPendingPlanManager(): PendingPlanManager;
+/**
+ * Format a plan for compact display (e.g., in status bar).
+ */
+export declare function formatPlanStatus(plan: PendingPlan | null): string;
+//# sourceMappingURL=pending-plan.d.ts.map

package/dist/src/integrations/pending-plan.d.ts.map

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

package/dist/src/integrations/pending-plan.js

@@ -0,0 +1,244 @@
+/**
+ * Pending Plan Manager
+ *
+ * Manages plans that are awaiting user approval before execution.
+ * Used in "plan mode" where write operations are intercepted and queued
+ * as proposed changes rather than being executed immediately.
+ *
+ * @example
+ * ```typescript
+ * const planManager = createPendingPlanManager();
+ *
+ * // In plan mode, intercept a write operation
+ * planManager.addProposedChange({
+ *   tool: 'write_file',
+ *   args: { path: 'src/main.ts', content: '...' },
+ *   reason: 'Create entry point for the application',
+ * });
+ *
+ * // User approves the plan
+ * const changes = planManager.approve();
+ * for (const change of changes) {
+ *   await executeTool(change.tool, change.args);
+ * }
+ * ```
+ */
+// =============================================================================
+// PENDING PLAN MANAGER
+// =============================================================================
+/**
+ * Manages pending plans that await user approval.
+ */
+export class PendingPlanManager {
+    currentPlan = null;
+    changeCounter = 0;
+    eventListeners = new Set();
+    /**
+     * Start a new pending plan.
+     * Clears any existing plan.
+     */
+    startPlan(task, sessionId) {
+        const now = new Date().toISOString();
+        const plan = {
+            id: `plan-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            task,
+            createdAt: now,
+            updatedAt: now,
+            proposedChanges: [],
+            explorationSummary: '',
+            status: 'pending',
+            sessionId,
+        };
+        this.currentPlan = plan;
+        this.changeCounter = 0;
+        this.emit({ type: 'plan.created', plan });
+        return plan;
+    }
+    /**
+     * Add a proposed change to the current plan.
+     * Returns the created change, or null if no plan is active.
+     */
+    addProposedChange(tool, args, reason, toolCallId) {
+        if (!this.currentPlan) {
+            return null;
+        }
+        const change = {
+            id: `change-${++this.changeCounter}`,
+            tool,
+            args,
+            reason,
+            order: this.currentPlan.proposedChanges.length + 1,
+            proposedAt: new Date().toISOString(),
+            toolCallId,
+        };
+        this.currentPlan.proposedChanges.push(change);
+        this.currentPlan.updatedAt = new Date().toISOString();
+        this.emit({ type: 'plan.change.added', change, planId: this.currentPlan.id });
+        return change;
+    }
+    /**
+     * Set the exploration summary for the current plan.
+     */
+    setExplorationSummary(summary) {
+        if (this.currentPlan) {
+            this.currentPlan.explorationSummary = summary;
+            this.currentPlan.updatedAt = new Date().toISOString();
+        }
+    }
+    /**
+     * Get the current pending plan.
+     */
+    getPendingPlan() {
+        return this.currentPlan;
+    }
+    /**
+     * Check if there's an active pending plan.
+     */
+    hasPendingPlan() {
+        return this.currentPlan !== null && this.currentPlan.status === 'pending';
+    }
+    /**
+     * Get the number of proposed changes.
+     */
+    getChangeCount() {
+        return this.currentPlan?.proposedChanges.length ?? 0;
+    }
+    /**
+     * Approve the pending plan.
+     * @param count - If provided, only approve the first N changes
+     * @returns The changes to execute
+     */
+    approve(count) {
+        if (!this.currentPlan) {
+            return { changes: [], skippedCount: 0 };
+        }
+        const allChanges = this.currentPlan.proposedChanges;
+        const approvedChanges = count !== undefined
+            ? allChanges.slice(0, count)
+            : allChanges;
+        const skippedCount = allChanges.length - approvedChanges.length;
+        this.currentPlan.status = skippedCount > 0 ? 'partially_approved' : 'approved';
+        this.currentPlan.updatedAt = new Date().toISOString();
+        this.emit({
+            type: 'plan.approved',
+            planId: this.currentPlan.id,
+            changeCount: approvedChanges.length,
+        });
+        // Clear the plan after approval
+        const result = { changes: approvedChanges, skippedCount };
+        this.currentPlan = null;
+        return result;
+    }
+    /**
+     * Reject the pending plan.
+     * Clears all proposed changes.
+     */
+    reject() {
+        if (!this.currentPlan) {
+            return;
+        }
+        this.currentPlan.status = 'rejected';
+        this.currentPlan.updatedAt = new Date().toISOString();
+        this.emit({ type: 'plan.rejected', planId: this.currentPlan.id });
+        this.currentPlan = null;
+    }
+    /**
+     * Clear the current plan without changing status.
+     */
+    clear() {
+        if (this.currentPlan) {
+            this.emit({ type: 'plan.cleared', planId: this.currentPlan.id });
+            this.currentPlan = null;
+        }
+    }
+    /**
+     * Restore a plan from storage.
+     */
+    restorePlan(plan) {
+        this.currentPlan = plan;
+        this.changeCounter = plan.proposedChanges.length;
+    }
+    /**
+     * Format the pending plan for display.
+     */
+    formatPlan() {
+        if (!this.currentPlan) {
+            return 'No pending plan.';
+        }
+        const lines = [
+            `Plan: "${this.currentPlan.task}"`,
+            `Status: ${this.currentPlan.status}`,
+            `Created: ${this.currentPlan.createdAt}`,
+            '',
+        ];
+        if (this.currentPlan.explorationSummary) {
+            lines.push('Exploration Summary:');
+            lines.push(this.currentPlan.explorationSummary);
+            lines.push('');
+        }
+        if (this.currentPlan.proposedChanges.length === 0) {
+            lines.push('No proposed changes yet.');
+        }
+        else {
+            lines.push(`Proposed Changes (${this.currentPlan.proposedChanges.length}):`);
+            lines.push('');
+            for (const change of this.currentPlan.proposedChanges) {
+                lines.push(`${change.order}. [${change.tool}]`);
+                // Format args nicely
+                if (change.tool === 'write_file' || change.tool === 'edit_file') {
+                    const path = change.args.path || change.args.file_path;
+                    lines.push(`   File: ${path}`);
+                }
+                else if (change.tool === 'bash') {
+                    const cmd = String(change.args.command || '').slice(0, 60);
+                    lines.push(`   Command: ${cmd}${cmd.length >= 60 ? '...' : ''}`);
+                }
+                else {
+                    lines.push(`   Args: ${JSON.stringify(change.args).slice(0, 80)}...`);
+                }
+                lines.push(`   Reason: ${change.reason}`);
+                lines.push('');
+            }
+        }
+        lines.push('Commands: /approve, /reject, /show-plan');
+        return lines.join('\n');
+    }
+    /**
+     * Subscribe to plan events.
+     */
+    subscribe(listener) {
+        this.eventListeners.add(listener);
+        return () => this.eventListeners.delete(listener);
+    }
+    // Internal
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a new pending plan manager.
+ */
+export function createPendingPlanManager() {
+    return new PendingPlanManager();
+}
+/**
+ * Format a plan for compact display (e.g., in status bar).
+ */
+export function formatPlanStatus(plan) {
+    if (!plan) {
+        return '';
+    }
+    const count = plan.proposedChanges.length;
+    return `${count} change${count === 1 ? '' : 's'} pending`;
+}
+//# sourceMappingURL=pending-plan.js.map

package/dist/src/integrations/pending-plan.js.map

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

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

@@ -0,0 +1,48 @@
+/**
+ * Persistence Utilities
+ *
+ * Debug logging and checkpoint management for session persistence.
+ */
+import type { SQLiteStore, SessionStore } from './index.js';
+export type AnySessionStore = SQLiteStore | SessionStore;
+/**
+ * Debug logger for persistence operations.
+ * Enabled via --debug flag. Shows data flow at each layer boundary.
+ * In TUI mode, logs are buffered instead of printed to avoid interfering with Ink.
+ */
+export declare class PersistenceDebugger {
+    private enabled;
+    private tuiMode;
+    private buffer;
+    enable(): void;
+    enableTUIMode(): void;
+    isEnabled(): boolean;
+    getBuffer(): string[];
+    log(message: string, data?: unknown): void;
+    error(message: string, err: unknown): void;
+    storeType(store: AnySessionStore): string;
+}
+export declare const persistenceDebug: PersistenceDebugger;
+/**
+ * Checkpoint data structure for full state restoration.
+ */
+export interface CheckpointData {
+    id: string;
+    label?: string;
+    messages: unknown[];
+    iteration: number;
+    metrics?: unknown;
+    plan?: unknown;
+    memoryContext?: string[];
+}
+/**
+ * Save checkpoint to session store (works with both SQLite and JSONL).
+ * Now includes plan and memoryContext for full state restoration.
+ */
+export declare function saveCheckpointToStore(store: AnySessionStore, checkpoint: CheckpointData): void;
+/**
+ * Load session state (checkpoint or messages) for resuming.
+ * Returns checkpoint data if found, or null.
+ */
+export declare function loadSessionState(sessionStore: AnySessionStore, sessionId: string): Promise<CheckpointData | null>;
+//# sourceMappingURL=persistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../src/integrations/persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5D,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,CAAC;AAMzD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAgB;IAE9B,MAAM,IAAI,IAAI;IAKd,aAAa,IAAI,IAAI;IAIrB,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,MAAM,EAAE;IAMrB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAgB1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IAuB1C,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;CAM1C;AAGD,eAAO,MAAM,gBAAgB,qBAA4B,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,cAAc,GACzB,IAAI,CAgEN;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,eAAe,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8ChC"}

package/dist/src/integrations/persistence.js

@@ -0,0 +1,196 @@
+/**
+ * Persistence Utilities
+ *
+ * Debug logging and checkpoint management for session persistence.
+ */
+// =============================================================================
+// DEBUG LOGGER FOR PERSISTENCE OPERATIONS
+// =============================================================================
+/**
+ * Debug logger for persistence operations.
+ * Enabled via --debug flag. Shows data flow at each layer boundary.
+ * In TUI mode, logs are buffered instead of printed to avoid interfering with Ink.
+ */
+export class PersistenceDebugger {
+    enabled = false;
+    tuiMode = false;
+    buffer = [];
+    enable() {
+        this.enabled = true;
+        this.log('Persistence debug mode ENABLED');
+    }
+    enableTUIMode() {
+        this.tuiMode = true;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    getBuffer() {
+        const logs = [...this.buffer];
+        this.buffer = [];
+        return logs;
+    }
+    log(message, data) {
+        if (!this.enabled)
+            return;
+        const timestamp = new Date().toISOString().split('T')[1].slice(0, 12);
+        const logLine = `[${timestamp}] ${message}`;
+        const dataLine = data !== undefined ? `    -> ${JSON.stringify(data, null, 2).split('\n').join('\n    ')}` : '';
+        if (this.tuiMode) {
+            // Buffer logs in TUI mode to avoid console interference
+            this.buffer.push(logLine);
+            if (dataLine)
+                this.buffer.push(dataLine);
+        }
+        else {
+            console.log(logLine);
+            if (dataLine)
+                console.log(dataLine);
+        }
+    }
+    error(message, err) {
+        if (!this.enabled)
+            return;
+        const timestamp = new Date().toISOString().split('T')[1].slice(0, 12);
+        const errLine = `[${timestamp}] ERROR: ${message}`;
+        let details = '';
+        if (err instanceof Error) {
+            details = `    -> ${err.message}`;
+            if (err.stack) {
+                details += `\n    -> Stack: ${err.stack.split('\n').slice(1, 3).join(' -> ')}`;
+            }
+        }
+        else {
+            details = `    -> ${String(err)}`;
+        }
+        if (this.tuiMode) {
+            this.buffer.push(errLine);
+            this.buffer.push(details);
+        }
+        else {
+            console.error(errLine);
+            console.error(details);
+        }
+    }
+    storeType(store) {
+        if ('saveCheckpoint' in store && typeof store.saveCheckpoint === 'function') {
+            return 'SQLiteStore';
+        }
+        return 'JSONLStore';
+    }
+}
+// Global debug instance - enabled via --debug flag
+export const persistenceDebug = new PersistenceDebugger();
+/**
+ * Save checkpoint to session store (works with both SQLite and JSONL).
+ * Now includes plan and memoryContext for full state restoration.
+ */
+export function saveCheckpointToStore(store, checkpoint) {
+    const storeType = persistenceDebug.storeType(store);
+    persistenceDebug.log(`saveCheckpointToStore called`, {
+        storeType,
+        checkpointId: checkpoint.id,
+        messageCount: checkpoint.messages?.length ?? 0,
+        hasLabel: !!checkpoint.label,
+        hasPlan: !!checkpoint.plan,
+    });
+    try {
+        if ('saveCheckpoint' in store && typeof store.saveCheckpoint === 'function') {
+            // SQLite store - check currentSessionId
+            const sqliteStore = store;
+            const currentSessionId = sqliteStore.getCurrentSessionId();
+            persistenceDebug.log(`SQLite saveCheckpoint`, {
+                currentSessionId,
+                hasCurrentSession: !!currentSessionId,
+            });
+            if (!currentSessionId) {
+                persistenceDebug.error('SQLite store has no currentSessionId!', new Error('No active session'));
+            }
+            const ckptId = store.saveCheckpoint({
+                id: checkpoint.id,
+                label: checkpoint.label,
+                messages: checkpoint.messages,
+                iteration: checkpoint.iteration,
+                metrics: checkpoint.metrics,
+                plan: checkpoint.plan,
+                memoryContext: checkpoint.memoryContext,
+            }, checkpoint.label || `auto-checkpoint-${checkpoint.id}`);
+            persistenceDebug.log(`SQLite checkpoint saved successfully`, { returnedId: ckptId });
+        }
+        else if ('appendEntry' in store && typeof store.appendEntry === 'function') {
+            // JSONL store - use appendEntry with checkpoint type
+            persistenceDebug.log(`JSONL appendEntry (checkpoint type)`);
+            store.appendEntry({
+                type: 'checkpoint',
+                data: {
+                    id: checkpoint.id,
+                    label: checkpoint.label,
+                    messages: checkpoint.messages,
+                    iteration: checkpoint.iteration,
+                    metrics: checkpoint.metrics,
+                    plan: checkpoint.plan,
+                    memoryContext: checkpoint.memoryContext,
+                    createdAt: new Date().toISOString(),
+                },
+            });
+            persistenceDebug.log(`JSONL checkpoint appended successfully`);
+        }
+        else {
+            persistenceDebug.error('No compatible save method found on store', { storeType });
+        }
+    }
+    catch (err) {
+        persistenceDebug.error(`Failed to save checkpoint`, err);
+        // Re-throw in debug mode so the error is visible
+        if (persistenceDebug.isEnabled()) {
+            throw err;
+        }
+    }
+}
+/**
+ * Load session state (checkpoint or messages) for resuming.
+ * Returns checkpoint data if found, or null.
+ */
+export async function loadSessionState(sessionStore, sessionId) {
+    persistenceDebug.log('Loading session state', { sessionId });
+    // Try SQLite's loadLatestCheckpoint first
+    if ('loadLatestCheckpoint' in sessionStore && typeof sessionStore.loadLatestCheckpoint === 'function') {
+        const sqliteCheckpoint = sessionStore.loadLatestCheckpoint(sessionId);
+        if (sqliteCheckpoint?.state) {
+            persistenceDebug.log('Loaded from SQLite checkpoint', {
+                messageCount: sqliteCheckpoint.state.messages?.length,
+            });
+            return sqliteCheckpoint.state;
+        }
+    }
+    // Fall back to entries-based lookup (for JSONL or if SQLite checkpoint not found)
+    try {
+        const entriesResult = sessionStore.loadSession(sessionId);
+        const entries = Array.isArray(entriesResult) ? entriesResult : await entriesResult;
+        // Try to find a checkpoint entry
+        const checkpoint = [...entries].reverse().find(e => e.type === 'checkpoint');
+        if (checkpoint?.data) {
+            persistenceDebug.log('Loaded from entries checkpoint', {
+                messageCount: checkpoint.data.messages?.length,
+            });
+            return checkpoint.data;
+        }
+        // No checkpoint, try to load messages directly from entries
+        const messages = entries
+            .filter((e) => e.type === 'message')
+            .map((e) => e.data);
+        if (messages.length > 0) {
+            persistenceDebug.log('Loaded messages from entries', { count: messages.length });
+            return {
+                id: `loaded-${sessionId}`,
+                messages,
+                iteration: 0,
+            };
+        }
+    }
+    catch (error) {
+        persistenceDebug.error('Failed to load session entries', error);
+    }
+    return null;
+}
+//# sourceMappingURL=persistence.js.map