@framers/agentos 0.1.0

package/dist/core/planning/IPlanningEngine.d.ts

@@ -0,0 +1,524 @@
+/**
+ * @file IPlanningEngine.ts
+ * @description Interface for the AgentOS Planning Engine - enables autonomous goal pursuit,
+ * task decomposition, and self-correcting execution plans.
+ *
+ * The Planning Engine implements cognitive patterns like ReAct (Reasoning + Acting),
+ * Chain-of-Thought, and Tree-of-Thought for sophisticated multi-step reasoning.
+ *
+ * @module AgentOS/Planning
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const planningEngine = new PlanningEngine(llmProvider, logger);
+ *
+ * // Generate a plan from a high-level goal
+ * const plan = await planningEngine.generatePlan(
+ *   'Research and summarize the latest AI safety papers',
+ *   { maxSteps: 10, allowToolUse: true }
+ * );
+ *
+ * // Execute with autonomous loop
+ * for await (const step of planningEngine.runAutonomousLoop(goal, options)) {
+ *   console.log(`Step ${step.index}: ${step.action}`);
+ *   if (step.requiresHumanApproval) {
+ *     // Handle HITL checkpoint
+ *   }
+ * }
+ * ```
+ */
+import type { ITool } from '../tools/ITool';
+/**
+ * Represents a single step in an execution plan.
+ * Each step contains the reasoning, action, and expected outcome.
+ */
+export interface PlanStep {
+    /** Unique step identifier */
+    stepId: string;
+    /** Zero-based step index */
+    index: number;
+    /** The action to take (tool call, reasoning, etc.) */
+    action: PlanAction;
+    /** Chain-of-thought reasoning for this step */
+    reasoning: string;
+    /** Expected outcome description */
+    expectedOutcome: string;
+    /** Dependencies on other step IDs */
+    dependsOn: string[];
+    /** Estimated token cost for this step */
+    estimatedTokens: number;
+    /** Confidence score (0-1) in this step's success */
+    confidence: number;
+    /** Whether this step requires human approval */
+    requiresHumanApproval: boolean;
+    /** Current execution status */
+    status: PlanStepStatus;
+    /** Actual result after execution */
+    result?: PlanStepResult;
+}
+/**
+ * Status of a plan step during execution.
+ */
+export type PlanStepStatus = 'pending' | 'ready' | 'executing' | 'awaiting_approval' | 'completed' | 'failed' | 'skipped';
+/**
+ * The type of action a plan step performs.
+ */
+export interface PlanAction {
+    /** Action type */
+    type: PlanActionType;
+    /** Tool to invoke (if type is 'tool_call') */
+    toolId?: string;
+    /** Arguments for tool call */
+    toolArgs?: Record<string, unknown>;
+    /** Sub-goal to pursue (if type is 'subgoal') */
+    subgoal?: string;
+    /** Query for information retrieval */
+    query?: string;
+    /** Content for reasoning/synthesis steps */
+    content?: string;
+}
+/**
+ * Types of actions that can appear in a plan.
+ */
+export type PlanActionType = 'tool_call' | 'reasoning' | 'information_gathering' | 'subgoal' | 'synthesis' | 'validation' | 'human_input' | 'checkpoint';
+/**
+ * Result of executing a plan step.
+ */
+export interface PlanStepResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Output data from execution */
+    output: unknown;
+    /** Error message if failed */
+    error?: string;
+    /** Actual tokens used */
+    tokensUsed: number;
+    /** Execution duration in ms */
+    durationMs: number;
+    /** Observations made during execution */
+    observations: string[];
+}
+/**
+ * Complete execution plan generated by the planning engine.
+ */
+export interface ExecutionPlan {
+    /** Unique plan identifier */
+    planId: string;
+    /** Original goal this plan addresses */
+    goal: string;
+    /** Ordered list of plan steps */
+    steps: PlanStep[];
+    /** Dependency graph: stepId -> dependent stepIds */
+    dependencies: Map<string, string[]>;
+    /** Estimated total token cost */
+    estimatedTokens: number;
+    /** Overall confidence score (0-1) */
+    confidenceScore: number;
+    /** Plan generation timestamp */
+    createdAt: Date;
+    /** Planning strategy used */
+    strategy: PlanningStrategy;
+    /** Metadata about plan generation */
+    metadata: PlanMetadata;
+}
+/**
+ * Metadata about how a plan was generated.
+ */
+export interface PlanMetadata {
+    /** Model used for planning */
+    modelId: string;
+    /** Planning iterations/refinements */
+    iterations: number;
+    /** Time spent planning in ms */
+    planningDurationMs: number;
+    /** Alternative plans considered */
+    alternativesConsidered: number;
+}
+/**
+ * Available planning strategies.
+ */
+export type PlanningStrategy = 'react' | 'plan_and_execute' | 'tree_of_thought' | 'least_to_most' | 'self_consistency' | 'reflexion';
+/**
+ * Configuration for plan generation.
+ */
+export interface PlanningOptions {
+    /** Maximum steps allowed in plan */
+    maxSteps?: number;
+    /** Maximum planning iterations */
+    maxIterations?: number;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+    /** Allow tool usage in plan */
+    allowToolUse?: boolean;
+    /** Available tools for planning */
+    availableTools?: ITool[];
+    /** Planning strategy to use */
+    strategy?: PlanningStrategy;
+    /** Enable human checkpoints */
+    enableCheckpoints?: boolean;
+    /** Checkpoint frequency (every N steps) */
+    checkpointFrequency?: number;
+    /** Maximum tokens for entire plan execution */
+    maxTotalTokens?: number;
+    /** Time limit for planning phase in ms */
+    planningTimeoutMs?: number;
+}
+/**
+ * Context provided to the planning engine.
+ */
+export interface PlanningContext {
+    /** Current conversation/session context */
+    conversationHistory?: string;
+    /** Retrieved relevant context */
+    retrievedContext?: string;
+    /** User preferences/constraints */
+    userConstraints?: string[];
+    /** Previously failed approaches */
+    failedApproaches?: string[];
+    /** Domain-specific knowledge */
+    domainContext?: string;
+    /** Available resources/capabilities */
+    capabilities?: string[];
+}
+/**
+ * Result of decomposing a complex task into subtasks.
+ */
+export interface TaskDecomposition {
+    /** Original task */
+    originalTask: string;
+    /** Decomposed subtasks */
+    subtasks: SubTask[];
+    /** Decomposition reasoning */
+    reasoning: string;
+    /** Whether decomposition is complete */
+    isComplete: boolean;
+    /** Suggested execution order */
+    executionOrder: string[];
+}
+/**
+ * A subtask resulting from decomposition.
+ */
+export interface SubTask {
+    /** Unique subtask identifier */
+    subtaskId: string;
+    /** Subtask description */
+    description: string;
+    /** Complexity estimate (1-10) */
+    complexity: number;
+    /** Dependencies on other subtasks */
+    dependsOn: string[];
+    /** Estimated tokens to complete */
+    estimatedTokens: number;
+    /** Can this be parallelized with others? */
+    parallelizable: boolean;
+}
+/**
+ * Feedback from plan execution used for refinement.
+ */
+export interface ExecutionFeedback {
+    /** Plan being executed */
+    planId: string;
+    /** Step that generated feedback */
+    stepId: string;
+    /** Type of feedback */
+    feedbackType: FeedbackType;
+    /** Feedback details */
+    details: string;
+    /** Suggested correction */
+    suggestedCorrection?: string;
+    /** Severity of the issue */
+    severity: 'info' | 'warning' | 'error' | 'critical';
+}
+/**
+ * Types of execution feedback.
+ */
+export type FeedbackType = 'step_failed' | 'unexpected_output' | 'confidence_drop' | 'timeout' | 'resource_exhausted' | 'human_correction' | 'validation_failed';
+/**
+ * Options for autonomous goal pursuit loop.
+ */
+export interface AutonomousLoopOptions {
+    /** Maximum iterations before stopping */
+    maxIterations?: number;
+    /** Stop when goal confidence exceeds this */
+    goalConfidenceThreshold?: number;
+    /** Enable self-reflection between iterations */
+    enableReflection?: boolean;
+    /** Reflection frequency (every N iterations) */
+    reflectionFrequency?: number;
+    /** Human approval required for certain actions */
+    requireApprovalFor?: PlanActionType[];
+    /** Callback for progress updates */
+    onProgress?: (progress: LoopProgress) => void;
+    /** Callback for human approval requests */
+    onApprovalRequired?: (request: ApprovalRequest) => Promise<boolean>;
+}
+/**
+ * Progress update during autonomous loop.
+ */
+export interface LoopProgress {
+    /** Current iteration */
+    iteration: number;
+    /** Current step being executed */
+    currentStep: PlanStep;
+    /** Overall progress (0-1) */
+    progress: number;
+    /** Accumulated observations */
+    observations: string[];
+    /** Current confidence in goal achievement */
+    goalConfidence: number;
+    /** Tokens used so far */
+    tokensUsed: number;
+}
+/**
+ * Request for human approval during autonomous execution.
+ */
+export interface ApprovalRequest {
+    /** Request identifier */
+    requestId: string;
+    /** Step requiring approval */
+    step: PlanStep;
+    /** Reason approval is needed */
+    reason: string;
+    /** Suggested action */
+    suggestedAction: 'approve' | 'modify' | 'reject';
+    /** Timeout for response in ms */
+    timeoutMs: number;
+}
+/**
+ * Interface for the AgentOS Planning Engine.
+ *
+ * The Planning Engine provides sophisticated cognitive capabilities for
+ * autonomous agents, including:
+ *
+ * - **Goal Decomposition**: Break complex goals into manageable subtasks
+ * - **Plan Generation**: Create multi-step execution plans with ReAct pattern
+ * - **Self-Correction**: Refine plans based on execution feedback
+ * - **Autonomous Loops**: Pursue goals with minimal human intervention
+ *
+ * @example
+ * ```typescript
+ * // Generate and execute a plan
+ * const engine = new PlanningEngine(llmProvider);
+ * const plan = await engine.generatePlan('Build a REST API', {
+ *   strategy: 'plan_and_execute',
+ *   maxSteps: 20,
+ * });
+ *
+ * for (const step of plan.steps) {
+ *   const result = await engine.executeStep(step);
+ *   if (!result.success) {
+ *     const refined = await engine.refinePlan(plan, {
+ *       planId: plan.planId,
+ *       stepId: step.stepId,
+ *       feedbackType: 'step_failed',
+ *       details: result.error!,
+ *       severity: 'error',
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export interface IPlanningEngine {
+    /**
+     * Generates a multi-step execution plan from a high-level goal.
+     *
+     * @param goal - The high-level goal to achieve
+     * @param context - Additional context for planning
+     * @param options - Planning configuration options
+     * @returns Generated execution plan
+     *
+     * @example
+     * ```typescript
+     * const plan = await engine.generatePlan(
+     *   'Analyze customer feedback and generate a report',
+     *   { domainContext: 'E-commerce platform' },
+     *   { strategy: 'react', maxSteps: 15 }
+     * );
+     * ```
+     */
+    generatePlan(goal: string, context?: PlanningContext, options?: PlanningOptions): Promise<ExecutionPlan>;
+    /**
+     * Decomposes a complex task into simpler subtasks.
+     *
+     * @param task - The task description to decompose
+     * @param depth - Maximum decomposition depth (default: 3)
+     * @returns Task decomposition result
+     */
+    decomposeTask(task: string, depth?: number): Promise<TaskDecomposition>;
+    /**
+     * Validates a plan for feasibility and completeness.
+     *
+     * @param plan - Plan to validate
+     * @returns Validation result with any issues found
+     */
+    validatePlan(plan: ExecutionPlan): Promise<PlanValidationResult>;
+    /**
+     * Refines an existing plan based on execution feedback.
+     * Uses self-reflection to identify issues and generate corrections.
+     *
+     * @param plan - Original plan to refine
+     * @param feedback - Feedback from execution
+     * @returns Refined execution plan
+     */
+    refinePlan(plan: ExecutionPlan, feedback: ExecutionFeedback): Promise<ExecutionPlan>;
+    /**
+     * Performs self-reflection on plan execution state.
+     *
+     * @param plan - Current plan
+     * @param executionState - Current execution state
+     * @returns Reflection insights and suggested adjustments
+     */
+    reflect(plan: ExecutionPlan, executionState: ExecutionState): Promise<ReflectionResult>;
+    /**
+     * Executes a single plan step.
+     *
+     * @param step - Step to execute
+     * @param context - Execution context including previous results
+     * @returns Step execution result
+     */
+    executeStep(step: PlanStep, context?: StepExecutionContext): Promise<PlanStepResult>;
+    /**
+     * Runs an autonomous goal pursuit loop.
+     * Yields progress updates and handles self-correction automatically.
+     *
+     * @param goal - Goal to pursue
+     * @param options - Loop configuration
+     * @yields Progress updates including current step and observations
+     * @returns Final execution summary
+     */
+    runAutonomousLoop(goal: string, options?: AutonomousLoopOptions): AsyncGenerator<LoopProgress, ExecutionSummary, undefined>;
+    /**
+     * Saves current execution state for checkpointing/rollback.
+     *
+     * @param plan - Plan being executed
+     * @param state - Current execution state
+     * @returns Checkpoint identifier
+     */
+    saveCheckpoint(plan: ExecutionPlan, state: ExecutionState): Promise<string>;
+    /**
+     * Restores execution state from a checkpoint.
+     *
+     * @param checkpointId - Checkpoint to restore
+     * @returns Restored execution state
+     */
+    restoreCheckpoint(checkpointId: string): Promise<{
+        plan: ExecutionPlan;
+        state: ExecutionState;
+    }>;
+    /**
+     * Gets the current execution state for a plan.
+     *
+     * @param planId - Plan identifier
+     * @returns Current execution state or null if not found
+     */
+    getExecutionState(planId: string): ExecutionState | null;
+}
+/**
+ * Result of plan validation.
+ */
+export interface PlanValidationResult {
+    /** Whether plan is valid */
+    isValid: boolean;
+    /** Validation issues found */
+    issues: PlanValidationIssue[];
+    /** Suggestions for improvement */
+    suggestions: string[];
+}
+/**
+ * A single plan validation issue.
+ */
+export interface PlanValidationIssue {
+    /** Issue severity */
+    severity: 'warning' | 'error';
+    /** Step ID if issue is step-specific */
+    stepId?: string;
+    /** Issue description */
+    message: string;
+    /** Suggested fix */
+    suggestedFix?: string;
+}
+/**
+ * Result of self-reflection.
+ */
+export interface ReflectionResult {
+    /** Key insights from reflection */
+    insights: string[];
+    /** Identified issues */
+    issues: string[];
+    /** Suggested plan adjustments */
+    adjustments: PlanAdjustment[];
+    /** Updated confidence score */
+    confidenceAdjustment: number;
+    /** Whether to continue or replan */
+    recommendation: 'continue' | 'adjust' | 'replan' | 'abort';
+}
+/**
+ * A suggested adjustment to the plan.
+ */
+export interface PlanAdjustment {
+    /** Type of adjustment */
+    type: 'add_step' | 'remove_step' | 'modify_step' | 'reorder';
+    /** Target step ID (for modify/remove) */
+    targetStepId?: string;
+    /** New step data (for add/modify) */
+    newStepData?: Partial<PlanStep>;
+    /** Reason for adjustment */
+    reason: string;
+}
+/**
+ * Current state of plan execution.
+ */
+export interface ExecutionState {
+    /** Plan being executed */
+    planId: string;
+    /** Current step index */
+    currentStepIndex: number;
+    /** Completed step IDs */
+    completedSteps: string[];
+    /** Failed step IDs */
+    failedSteps: string[];
+    /** Accumulated results */
+    results: Map<string, PlanStepResult>;
+    /** Total tokens used */
+    tokensUsed: number;
+    /** Start timestamp */
+    startedAt: Date;
+    /** Last update timestamp */
+    lastUpdatedAt: Date;
+}
+/**
+ * Context for step execution.
+ */
+export interface StepExecutionContext {
+    /** Results from previous steps */
+    previousResults: Map<string, PlanStepResult>;
+    /** Available tools */
+    tools: ITool[];
+    /** Conversation context */
+    conversationContext?: string;
+    /** RAG retrieval function */
+    retrieve?: (query: string) => Promise<string[]>;
+}
+/**
+ * Final summary after autonomous loop completion.
+ */
+export interface ExecutionSummary {
+    /** Whether goal was achieved */
+    goalAchieved: boolean;
+    /** Final confidence score */
+    finalConfidence: number;
+    /** Total iterations */
+    iterations: number;
+    /** Total tokens used */
+    totalTokensUsed: number;
+    /** Total duration in ms */
+    totalDurationMs: number;
+    /** Key outcomes */
+    outcomes: string[];
+    /** Final synthesized result */
+    finalResult?: unknown;
+    /** Any unresolved issues */
+    unresolvedIssues: string[];
+}
+//# sourceMappingURL=IPlanningEngine.d.ts.map

package/dist/core/planning/IPlanningEngine.d.ts.map

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

package/dist/core/planning/IPlanningEngine.js

@@ -0,0 +1,32 @@
+/**
+ * @file IPlanningEngine.ts
+ * @description Interface for the AgentOS Planning Engine - enables autonomous goal pursuit,
+ * task decomposition, and self-correcting execution plans.
+ *
+ * The Planning Engine implements cognitive patterns like ReAct (Reasoning + Acting),
+ * Chain-of-Thought, and Tree-of-Thought for sophisticated multi-step reasoning.
+ *
+ * @module AgentOS/Planning
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const planningEngine = new PlanningEngine(llmProvider, logger);
+ *
+ * // Generate a plan from a high-level goal
+ * const plan = await planningEngine.generatePlan(
+ *   'Research and summarize the latest AI safety papers',
+ *   { maxSteps: 10, allowToolUse: true }
+ * );
+ *
+ * // Execute with autonomous loop
+ * for await (const step of planningEngine.runAutonomousLoop(goal, options)) {
+ *   console.log(`Step ${step.index}: ${step.action}`);
+ *   if (step.requiresHumanApproval) {
+ *     // Handle HITL checkpoint
+ *   }
+ * }
+ * ```
+ */
+export {};
+//# sourceMappingURL=IPlanningEngine.js.map

package/dist/core/planning/IPlanningEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPlanningEngine.js","sourceRoot":"","sources":["../../../src/core/planning/IPlanningEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG"}