attocode 0.1.0 → 0.1.2

package/dist/src/integrations/index.js

@@ -70,4 +70,16 @@ export { ResultSynthesizer, createResultSynthesizer, createSynthesisPrompt, } fr
 export { PendingPlanManager, createPendingPlanManager, formatPlanStatus, } from './pending-plan.js';
 // Persistence utilities (debug logging, checkpoint management)
 export { PersistenceDebugger, persistenceDebug, saveCheckpointToStore, loadSessionState, } from './persistence.js';
+// Interactive Planning (conversational + editable planning)
+export { InteractivePlanner, createInteractivePlanner, formatPlan, formatStep, } from './interactive-planning.js';
+// Learning Store (persistent cross-session learning)
+export { LearningStore, createLearningStore, createInMemoryLearningStore, formatLearningsContext, formatLearningStats, } from './learning-store.js';
+// Recursive Context (RLM) - from tricks
+export { RecursiveContextManager, createRecursiveContext, createMinimalRecursiveContext, createFileSystemSource, createConversationSource, formatRecursiveResult, formatRecursiveStats, } from '../tricks/recursive-context.js';
+// Provider Resilience (circuit breaker + fallback chain)
+export { getResilientProvider, createResilientFallbackChain, createAutoFallbackChain, getCircuitBreaker, getAllCircuitBreakerMetrics, resetAllCircuitBreakers, formatResilienceStatus, hasResilientProviderSupport, } from '../providers/resilient-provider.js';
+// Circuit Breaker (for direct use)
+export { CircuitBreaker, createCircuitBreaker, createStrictCircuitBreaker, createLenientCircuitBreaker, formatCircuitBreakerMetrics, isCircuitBreakerError, } from '../providers/circuit-breaker.js';
+// Fallback Chain (for direct use)
+export { FallbackChain, createFallbackChain, createFallbackChainFromRegistry, formatHealthStatus, isChainExhaustedError, } from '../providers/fallback-chain.js';
 //# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,322 @@
+/**
+ * Interactive Planning Integration
+ *
+ * Combines conversational refinement with structural editing for plans.
+ * Supports a Draft → Discuss → Execute → Checkpoint cycle.
+ *
+ * Features:
+ * - Natural language plan editing ("add X after step 3", "skip step 2")
+ * - Decision points where agent pauses for user input
+ * - Automatic checkpoints before each step
+ * - Rollback capability to any checkpoint
+ *
+ * @example
+ * ```typescript
+ * const planner = createInteractivePlanner({
+ *   autoCheckpoint: true,
+ *   confirmBeforeExecute: true,
+ * });
+ *
+ * // Create and discuss a plan
+ * const plan = await planner.draft('Add authentication to the API', llmCall);
+ *
+ * // User refines via conversation
+ * planner.edit('add rate limiting after step 3');
+ * planner.edit('skip the testing step for now');
+ *
+ * // Execute with checkpoints
+ * for await (const step of planner.execute()) {
+ *   console.log(`Executing: ${step.description}`);
+ *   await executeStep(step);
+ *   await planner.checkpoint();
+ * }
+ * ```
+ */
+/**
+ * Status of the interactive plan.
+ */
+export type PlanStatus = 'draft' | 'discussing' | 'approved' | 'executing' | 'paused' | 'completed' | 'failed' | 'cancelled';
+/**
+ * A step in the plan.
+ */
+export interface PlanStep {
+    /** Unique ID */
+    id: string;
+    /** Step number (1-indexed for display) */
+    number: number;
+    /** Description of what to do */
+    description: string;
+    /** Dependencies (step IDs that must complete first) */
+    dependencies: string[];
+    /** Current status */
+    status: 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
+    /** Reason for any status change */
+    statusReason?: string;
+    /** Checkpoint ID created before this step */
+    checkpointId?: string;
+    /** Output/result from execution */
+    output?: string;
+    /** Whether this is a decision point requiring user input */
+    isDecisionPoint?: boolean;
+    /** Decision options if this is a decision point */
+    decisionOptions?: string[];
+    /** User's decision choice */
+    decisionChoice?: string;
+    /** Estimated complexity (1-5) */
+    complexity?: number;
+}
+/**
+ * A checkpoint for rollback.
+ */
+export interface PlanCheckpoint {
+    /** Unique ID */
+    id: string;
+    /** When created */
+    timestamp: string;
+    /** Label/description */
+    label: string;
+    /** Step ID this checkpoint is before */
+    beforeStepId: string;
+    /** Snapshot of plan state */
+    planState: {
+        steps: PlanStep[];
+        status: PlanStatus;
+        currentStepIndex: number;
+    };
+    /** Additional context to restore */
+    context?: Record<string, unknown>;
+}
+/**
+ * The interactive plan.
+ */
+export interface InteractivePlan {
+    /** Unique ID */
+    id: string;
+    /** Original goal/task */
+    goal: string;
+    /** Plan steps */
+    steps: PlanStep[];
+    /** Current status */
+    status: PlanStatus;
+    /** Current step index (0-indexed) */
+    currentStepIndex: number;
+    /** Checkpoints for rollback */
+    checkpoints: PlanCheckpoint[];
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Conversation history for the plan */
+    discussionHistory: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    /** Agent's reasoning for the plan */
+    reasoning?: string;
+}
+/**
+ * Configuration for interactive planning.
+ */
+export interface InteractivePlannerConfig {
+    /** Auto-create checkpoint before each step */
+    autoCheckpoint?: boolean;
+    /** Require confirmation before execution */
+    confirmBeforeExecute?: boolean;
+    /** Max checkpoints to keep */
+    maxCheckpoints?: number;
+    /** Auto-pause at decision points */
+    autoPauseAtDecisions?: boolean;
+}
+/**
+ * An edit command for the plan.
+ */
+export interface EditCommand {
+    /** Type of edit */
+    type: 'add' | 'remove' | 'move' | 'update' | 'skip' | 'unskip';
+    /** Target step number or ID */
+    target?: string | number;
+    /** For add: position relative to target */
+    position?: 'before' | 'after';
+    /** New description or content */
+    content?: string;
+    /** For move: destination position */
+    destination?: number;
+}
+/**
+ * Result of parsing a natural language edit.
+ */
+export interface ParsedEdit {
+    /** The edit command */
+    command: EditCommand;
+    /** Confidence in the parse (0-1) */
+    confidence: number;
+    /** Original input */
+    original: string;
+    /** Clarification question if confidence is low */
+    clarificationNeeded?: string;
+}
+/**
+ * LLM call function for planning.
+ */
+export type PlannerLLMCall = (systemPrompt: string, userMessage: string) => Promise<{
+    content: string;
+}>;
+/**
+ * Events emitted by the interactive planner.
+ */
+export type InteractivePlannerEvent = {
+    type: 'plan.created';
+    plan: InteractivePlan;
+} | {
+    type: 'plan.updated';
+    changes: string;
+} | {
+    type: 'plan.approved';
+} | {
+    type: 'step.started';
+    step: PlanStep;
+} | {
+    type: 'step.completed';
+    step: PlanStep;
+} | {
+    type: 'step.failed';
+    step: PlanStep;
+    error: string;
+} | {
+    type: 'step.skipped';
+    step: PlanStep;
+    reason: string;
+} | {
+    type: 'decision.required';
+    step: PlanStep;
+    options: string[];
+} | {
+    type: 'decision.made';
+    step: PlanStep;
+    choice: string;
+} | {
+    type: 'checkpoint.created';
+    checkpoint: PlanCheckpoint;
+} | {
+    type: 'rollback.started';
+    toCheckpoint: string;
+} | {
+    type: 'rollback.completed';
+    toCheckpoint: string;
+} | {
+    type: 'plan.completed';
+} | {
+    type: 'plan.cancelled';
+    reason: string;
+} | {
+    type: 'edit.applied';
+    edit: EditCommand;
+} | {
+    type: 'edit.failed';
+    edit: EditCommand;
+    reason: string;
+};
+export type InteractivePlannerEventListener = (event: InteractivePlannerEvent) => void;
+/**
+ * Manages interactive planning with conversation and checkpoints.
+ */
+export declare class InteractivePlanner {
+    private config;
+    private plan;
+    private listeners;
+    constructor(config?: InteractivePlannerConfig);
+    /**
+     * Get the current plan.
+     */
+    getPlan(): InteractivePlan | null;
+    /**
+     * Draft a new plan.
+     */
+    draft(goal: string, llmCall: PlannerLLMCall): Promise<InteractivePlan>;
+    /**
+     * Parse an LLM plan response.
+     */
+    private parsePlanResponse;
+    /**
+     * Edit the plan using natural language.
+     */
+    edit(command: string, llmCall?: PlannerLLMCall): Promise<ParsedEdit>;
+    /**
+     * Parse edit command directly without LLM.
+     */
+    private parseEditDirectly;
+    /**
+     * Parse edit response from LLM.
+     */
+    private parseEditResponse;
+    /**
+     * Apply an edit command to the plan.
+     */
+    private applyEdit;
+    /**
+     * Renumber steps after modification.
+     */
+    private renumberSteps;
+    /**
+     * Approve the plan for execution.
+     */
+    approve(): void;
+    /**
+     * Start execution of the plan.
+     */
+    execute(): Generator<PlanStep, void, void>;
+    /**
+     * Mark the current step as completed.
+     */
+    completeStep(output?: string): void;
+    /**
+     * Mark the current step as failed.
+     */
+    failStep(error: string): void;
+    /**
+     * Make a decision for a decision point.
+     */
+    makeDecision(choice: string): void;
+    /**
+     * Create a checkpoint.
+     */
+    createCheckpoint(label: string): PlanCheckpoint;
+    /**
+     * Rollback to a checkpoint.
+     */
+    rollback(checkpointId: string): void;
+    /**
+     * Cancel the plan.
+     */
+    cancel(reason: string): void;
+    /**
+     * Add a message to discussion history.
+     */
+    addDiscussion(role: 'user' | 'assistant', content: string): void;
+    /**
+     * Get checkpoints for display.
+     */
+    getCheckpoints(): PlanCheckpoint[];
+    /**
+     * Clear the current plan.
+     */
+    clear(): void;
+    /**
+     * Subscribe to events.
+     */
+    on(listener: InteractivePlannerEventListener): () => void;
+    private emit;
+}
+/**
+ * Create an interactive planner.
+ */
+export declare function createInteractivePlanner(config?: InteractivePlannerConfig): InteractivePlanner;
+/**
+ * Format plan for display.
+ */
+export declare function formatPlan(plan: InteractivePlan): string;
+/**
+ * Format step for display.
+ */
+export declare function formatStep(step: PlanStep): string;
+//# sourceMappingURL=interactive-planning.d.ts.map

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

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