@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/agent/facades/model-routing-facade.js

@@ -7,6 +7,7 @@
  * - Cost tracking and limits
  * - Routing statistics and savings calculation
  */
+import { classifyTaskComplexity, selectModel, GROK_MODELS } from '../../optimization/model-routing.js';
 /**
  * Facade for model routing and cost management in agents.
  *
@@ -20,9 +21,14 @@ export class ModelRoutingFacade {
     modelRouter;
     costTracker;
     useModelRouting = false;
+    autoRoutingEnabled = false;
     lastRoutingDecision = null;
     sessionCostLimit = 10;
     sessionCost = 0;
+    /** Architect/editor model pair config */
+    modelPairs = null;
+    /** Mid-conversation model override (set by /switch) */
+    switchedModel = null;
     constructor(deps) {
         this.modelRouter = deps.modelRouter;
         this.costTracker = deps.costTracker;
@@ -42,6 +48,44 @@ export class ModelRoutingFacade {
     isModelRoutingEnabled() {
         return this.useModelRouting;
     }
+    /**
+     * Enable or disable automatic model routing by task complexity.
+     * When enabled, each user message is classified and routed to the
+     * optimal model before the LLM call.
+     */
+    setAutoRouting(enabled) {
+        this.autoRoutingEnabled = enabled;
+        // Also enable/disable the underlying model routing engine
+        this.useModelRouting = enabled;
+        this.modelRouter.updateConfig({ enabled });
+    }
+    /**
+     * Check if automatic model routing is enabled
+     */
+    isAutoRoutingEnabled() {
+        return this.autoRoutingEnabled;
+    }
+    /**
+     * Route a user message to the optimal model if auto-routing is enabled.
+     *
+     * @param userMessage - The user's message to classify
+     * @param availableModels - Optional list of available model IDs (defaults to GROK_MODELS keys)
+     * @returns The recommended model name, or null if auto-routing is disabled
+     *          or fewer than 2 models are available
+     */
+    autoRouteIfEnabled(userMessage, availableModels) {
+        if (!this.autoRoutingEnabled) {
+            return null;
+        }
+        const models = availableModels ?? Object.keys(GROK_MODELS);
+        if (models.length < 2) {
+            return null;
+        }
+        const classification = classifyTaskComplexity(userMessage);
+        const decision = selectModel(classification, undefined, models);
+        this.lastRoutingDecision = decision;
+        return decision.recommendedModel;
+    }
     /**
      * Get the model router instance (for advanced operations)
      */
@@ -93,6 +137,105 @@ export class ModelRoutingFacade {
         return lines.join('\n');
     }
     // ============================================================================
+    // Architect / Editor Model Pairs
+    // ============================================================================
+    /**
+     * Configure architect/editor model pairs.
+     * When set, the facade routes planning/reasoning tasks to the architect model
+     * and editing/tool-execution tasks to the editor model.
+     */
+    setModelPairs(pairs) {
+        this.modelPairs = pairs;
+    }
+    /**
+     * Get the current model pairs config.
+     */
+    getModelPairs() {
+        return this.modelPairs;
+    }
+    /**
+     * Resolve which model to use based on task intent and model pair configuration.
+     *
+     * Priority:
+     * 1. Mid-conversation /switch override (if set)
+     * 2. Architect/editor pair routing (if configured and intent is classifiable)
+     * 3. Auto-routing by complexity (if enabled)
+     * 4. Default model (null — caller uses their default)
+     */
+    resolveModelForIntent(intent, userMessage) {
+        // Priority 1: explicit /switch override
+        if (this.switchedModel) {
+            return this.switchedModel;
+        }
+        // Priority 2: architect/editor pair
+        if (this.modelPairs) {
+            if ((intent === 'planning' || intent === 'reasoning') && this.modelPairs.architect) {
+                return this.modelPairs.architect;
+            }
+            if (intent === 'editing' && this.modelPairs.editor) {
+                return this.modelPairs.editor;
+            }
+            // 'general' falls through to auto-routing or default
+        }
+        // Priority 3: auto-routing
+        if (userMessage && this.autoRoutingEnabled) {
+            return this.autoRouteIfEnabled(userMessage);
+        }
+        // Priority 4: no override
+        return null;
+    }
+    /**
+     * Classify user message intent for model pair routing.
+     * Returns 'planning' for architecture/design questions,
+     * 'editing' for code changes, and 'general' otherwise.
+     */
+    classifyIntent(userMessage) {
+        const lower = userMessage.toLowerCase();
+        const planningPatterns = [
+            'plan', 'design', 'architect', 'how should', 'what approach',
+            'strategy', 'outline', 'think about', 'consider', 'evaluate',
+            'compare', 'pros and cons', 'trade-off', 'tradeoff',
+        ];
+        const reasoningPatterns = [
+            'why', 'explain', 'reason', 'analyze', 'debug',
+            'understand', 'investigate', 'diagnose', 'figure out',
+        ];
+        const editingPatterns = [
+            'fix', 'edit', 'change', 'update', 'modify', 'refactor',
+            'implement', 'create', 'add', 'remove', 'delete', 'rename',
+            'write', 'build', 'code', 'make',
+        ];
+        for (const p of planningPatterns) {
+            if (lower.includes(p))
+                return 'planning';
+        }
+        for (const p of reasoningPatterns) {
+            if (lower.includes(p))
+                return 'reasoning';
+        }
+        for (const p of editingPatterns) {
+            if (lower.includes(p))
+                return 'editing';
+        }
+        return 'general';
+    }
+    // ============================================================================
+    // Mid-Conversation Model Switching
+    // ============================================================================
+    /**
+     * Switch the model for subsequent messages (set by /switch command).
+     * Pass null to return to auto-routing / default behavior.
+     */
+    setSwitchedModel(model) {
+        this.switchedModel = model;
+    }
+    /**
+     * Get the currently switched model (if any).
+     */
+    getSwitchedModel() {
+        return this.switchedModel;
+    }
+    // ============================================================================
     // Cost Management
     // ============================================================================
     /**

package/dist/agent/facades/model-routing-facade.js.map

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

package/dist/agent/facades/session-facade.d.ts

@@ -35,7 +35,13 @@ export interface SessionFacadeDeps {
 export declare class SessionFacade {
     private readonly checkpointManager;
     private readonly sessionStore;
+    private encryption;
+    private encryptionInitialized;
     constructor(deps: SessionFacadeDeps);
+    /**
+     * Lazily initialize session encryption if enabled via SESSION_ENCRYPTION env var
+     */
+    private getEncryption;
     /**
      * Create a checkpoint with the given description
      */
@@ -59,7 +65,7 @@ export declare class SessionFacade {
     /**
      * Save the current chat history to the session
      */
-    saveCurrentSession(chatHistory: ChatEntry[]): Promise<void> | void;
+    saveCurrentSession(chatHistory: ChatEntry[]): Promise<void>;
     /**
      * Get formatted list of sessions
      */

package/dist/agent/facades/session-facade.js

@@ -7,6 +7,8 @@
  * - Checkpoint creation and restoration
  * - Session export functionality
  */
+import { SessionEncryption } from '../../security/session-encryption.js';
+import { logger } from '../../utils/logger.js';
 /**
  * Facade for session and checkpoint management in agents.
  *
@@ -18,10 +20,34 @@
 export class SessionFacade {
     checkpointManager;
     sessionStore;
+    encryption = null;
+    encryptionInitialized = false;
     constructor(deps) {
         this.checkpointManager = deps.checkpointManager;
         this.sessionStore = deps.sessionStore;
     }
+    /**
+     * Lazily initialize session encryption if enabled via SESSION_ENCRYPTION env var
+     */
+    async getEncryption() {
+        if (this.encryptionInitialized)
+            return this.encryption;
+        this.encryptionInitialized = true;
+        if (process.env.SESSION_ENCRYPTION === 'true') {
+            try {
+                this.encryption = new SessionEncryption({ enabled: true });
+                await this.encryption.initialize();
+                logger.debug('Session encryption initialized');
+            }
+            catch (err) {
+                logger.warn('Failed to initialize session encryption', {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                this.encryption = null;
+            }
+        }
+        return this.encryption;
+    }
     // ============================================================================
     // Checkpoint Management
     // ============================================================================
@@ -73,8 +99,26 @@ export class SessionFacade {
     /**
      * Save the current chat history to the session
      */
-    saveCurrentSession(chatHistory) {
-        return this.sessionStore.updateCurrentSession(chatHistory);
+    async saveCurrentSession(chatHistory) {
+        const enc = await this.getEncryption();
+        if (enc) {
+            try {
+                const encrypted = enc.encryptObject(chatHistory);
+                const marker = {
+                    type: 'assistant',
+                    content: JSON.stringify({ __encrypted: true, data: encrypted }),
+                    timestamp: new Date(),
+                };
+                await this.sessionStore.updateCurrentSession([marker]);
+                return;
+            }
+            catch (err) {
+                logger.warn('Session encryption failed, saving unencrypted', {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        await this.sessionStore.updateCurrentSession(chatHistory);
     }
     /**
      * Get formatted list of sessions

package/dist/agent/facades/session-facade.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-facade.js","sourceRoot":"","sources":["../../../src/agent/facades/session-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IACP,iBAAiB,CAAoB;IACrC,YAAY,CAAe;IAE5C,YAAY,IAAuB;QACjC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxC,CAAC;IAED,+EAA+E;IAC/E,wBAAwB;IACxB,+EAA+E;IAE/E;;OAEG;IACH,gBAAgB,CAAC,WAAmB;QAClC,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,CAAC;QACrD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM,CAAC,UAAU;oBACxB,CAAC,CAAC,eAAe,MAAM,CAAC,UAAU,CAAC,WAAW,eAAe,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACzF,CAAC,CAAC,qBAAqB;aAC1B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB;SACxD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,+EAA+E;IAC/E,qBAAqB;IACrB,+EAA+E;IAE/E;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,WAAwB;QACzC,OAAO,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,UAAmB;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC;QAC1D,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"session-facade.js","sourceRoot":"","sources":["../../../src/agent/facades/session-facade.ts"],"names":[],"mappings":"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"}

package/dist/agent/file-watcher-trigger.d.ts

@@ -0,0 +1,65 @@
+/**
+ * File Watcher Trigger
+ *
+ * Watches source files for changes and triggers agent actions (lint, test,
+ * typecheck, notify, custom). Uses fs.watch with debouncing and glob-based
+ * filtering via the shared glob-utils.
+ */
+import { EventEmitter } from 'events';
+export interface FileWatcherConfig {
+    /** Glob patterns to watch: ['src/**\/*.ts', '*.py'] */
+    patterns: string[];
+    /** Glob patterns to ignore: ['node_modules/**', 'dist/**'] */
+    ignorePatterns: string[];
+    /** Debounce interval in ms (default 1000) */
+    debounceMs: number;
+    /** Actions to trigger on detected change */
+    actions: WatchAction[];
+}
+export type WatchAction = 'lint' | 'test' | 'typecheck' | 'notify' | 'custom';
+export interface FileChangeEvent {
+    filePath: string;
+    changeType: 'create' | 'modify' | 'delete';
+    timestamp: number;
+}
+/**
+ * Watches the filesystem for changes matching configured glob patterns and
+ * emits events + triggers actions when files are created, modified, or deleted.
+ *
+ * Events:
+ *  - 'change' (FileChangeEvent) — raw file change detected
+ *  - 'action' (WatchAction, filePath) — action triggered for a change
+ *  - 'error' (Error) — watcher error
+ */
+export declare class FileWatcherTrigger extends EventEmitter {
+    private watchers;
+    private debounceTimers;
+    private config;
+    private running;
+    private rootDir;
+    constructor(config?: Partial<FileWatcherConfig>);
+    /**
+     * Start watching files under rootDir.
+     */
+    start(rootDir: string): void;
+    /**
+     * Stop all watchers and clear pending debounce timers.
+     */
+    stop(): void;
+    /**
+     * Whether the watcher is currently running.
+     */
+    isRunning(): boolean;
+    /**
+     * Get current configuration (read-only copy).
+     */
+    getConfig(): Readonly<FileWatcherConfig>;
+    /**
+     * Handle a raw fs.watch event with debouncing and glob filtering.
+     */
+    private handleRawEvent;
+    /**
+     * After debounce, determine the change type and emit events.
+     */
+    private processChange;
+}

package/dist/agent/file-watcher-trigger.js

@@ -0,0 +1,190 @@
+/**
+ * File Watcher Trigger
+ *
+ * Watches source files for changes and triggers agent actions (lint, test,
+ * typecheck, notify, custom). Uses fs.watch with debouncing and glob-based
+ * filtering via the shared glob-utils.
+ */
+import { watch } from 'fs';
+import { EventEmitter } from 'events';
+import * as path from 'path';
+import * as fs from 'fs';
+import { logger } from '../utils/logger.js';
+import { matchGlobPatterns } from '../utils/glob-utils.js';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_IGNORE_PATTERNS = [
+    'node_modules/**',
+    'dist/**',
+    '.git/**',
+    '__pycache__/**',
+    '.codebuddy/**',
+    '*.log',
+    '.DS_Store',
+    'coverage/**',
+    '.next/**',
+    '.nuxt/**',
+    'build/**',
+    'out/**',
+];
+const DEFAULT_CONFIG = {
+    patterns: ['**/*.ts', '**/*.js', '**/*.py', '**/*.go', '**/*.rs'],
+    ignorePatterns: DEFAULT_IGNORE_PATTERNS,
+    debounceMs: 1000,
+    actions: ['notify'],
+};
+// ============================================================================
+// FileWatcherTrigger
+// ============================================================================
+/**
+ * Watches the filesystem for changes matching configured glob patterns and
+ * emits events + triggers actions when files are created, modified, or deleted.
+ *
+ * Events:
+ *  - 'change' (FileChangeEvent) — raw file change detected
+ *  - 'action' (WatchAction, filePath) — action triggered for a change
+ *  - 'error' (Error) — watcher error
+ */
+export class FileWatcherTrigger extends EventEmitter {
+    watchers = [];
+    debounceTimers = new Map();
+    config;
+    running = false;
+    rootDir = '';
+    constructor(config = {}) {
+        super();
+        this.config = {
+            patterns: config.patterns ?? DEFAULT_CONFIG.patterns,
+            ignorePatterns: config.ignorePatterns ?? DEFAULT_CONFIG.ignorePatterns,
+            debounceMs: config.debounceMs ?? DEFAULT_CONFIG.debounceMs,
+            actions: config.actions ?? DEFAULT_CONFIG.actions,
+        };
+    }
+    /**
+     * Start watching files under rootDir.
+     */
+    start(rootDir) {
+        if (this.running) {
+            logger.warn('FileWatcherTrigger: already running');
+            return;
+        }
+        this.rootDir = path.resolve(rootDir);
+        if (!fs.existsSync(this.rootDir)) {
+            const err = new Error(`Watch directory does not exist: ${this.rootDir}`);
+            this.emit('error', err);
+            return;
+        }
+        try {
+            // Use recursive watch where supported (Windows + macOS).
+            // On Linux, recursive watch may not be supported on older Node versions,
+            // but Node 19+ supports it for most filesystems.
+            const watcher = watch(this.rootDir, { recursive: true }, (eventType, filename) => {
+                if (!filename)
+                    return;
+                this.handleRawEvent(eventType, filename);
+            });
+            watcher.on('error', (err) => {
+                logger.error('FileWatcherTrigger: watcher error', err);
+                this.emit('error', err);
+            });
+            this.watchers.push(watcher);
+            this.running = true;
+            logger.info(`FileWatcherTrigger: started watching ${this.rootDir}`);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            logger.error('FileWatcherTrigger: failed to start', error);
+            this.emit('error', error);
+        }
+    }
+    /**
+     * Stop all watchers and clear pending debounce timers.
+     */
+    stop() {
+        for (const watcher of this.watchers) {
+            try {
+                watcher.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+        this.watchers = [];
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        this.running = false;
+        logger.info('FileWatcherTrigger: stopped');
+    }
+    /**
+     * Whether the watcher is currently running.
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * Get current configuration (read-only copy).
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    // --------------------------------------------------------------------------
+    // Private
+    // --------------------------------------------------------------------------
+    /**
+     * Handle a raw fs.watch event with debouncing and glob filtering.
+     */
+    handleRawEvent(eventType, filename) {
+        // Normalize to forward slashes for glob matching
+        const normalized = filename.replace(/\\/g, '/');
+        // Check ignore patterns first (fast rejection)
+        if (matchGlobPatterns(normalized, this.config.ignorePatterns)) {
+            return;
+        }
+        // Check if file matches any watch pattern
+        if (!matchGlobPatterns(normalized, this.config.patterns)) {
+            return;
+        }
+        // Debounce: skip if a timer is already pending for this file
+        if (this.debounceTimers.has(normalized)) {
+            clearTimeout(this.debounceTimers.get(normalized));
+        }
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(normalized);
+            this.processChange(eventType, normalized);
+        }, this.config.debounceMs);
+        this.debounceTimers.set(normalized, timer);
+    }
+    /**
+     * After debounce, determine the change type and emit events.
+     */
+    processChange(eventType, relativePath) {
+        const absolutePath = path.join(this.rootDir, relativePath);
+        let changeType;
+        try {
+            if (fs.existsSync(absolutePath)) {
+                // rename events on new files → create; change events → modify
+                changeType = eventType === 'rename' ? 'create' : 'modify';
+            }
+            else {
+                changeType = 'delete';
+            }
+        }
+        catch {
+            changeType = 'modify';
+        }
+        const event = {
+            filePath: absolutePath,
+            changeType,
+            timestamp: Date.now(),
+        };
+        this.emit('change', event);
+        // Trigger configured actions
+        for (const action of this.config.actions) {
+            this.emit('action', action, absolutePath);
+        }
+    }
+}
+//# sourceMappingURL=file-watcher-trigger.js.map

package/dist/agent/file-watcher-trigger.js.map

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

package/dist/agent/flow/planning-flow.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Planning Flow — OpenManus-compatible
+ * Multi-agent orchestrated execution with step-by-step plan decomposition.
+ *
+ * Dual execution mode:
+ * - Direct Mode: single agent ReAct loop (existing CodeBuddyAgent.processUserMessage)
+ * - Flow Mode: PlanningFlow decomposes task into steps, delegates to specialist agents
+ */
+import { EventEmitter } from 'events';
+import { AgentStatus } from '../state-machine.js';
+export declare enum PlanStepStatus {
+    NOT_STARTED = "not_started",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    BLOCKED = "blocked",
+    SKIPPED = "skipped"
+}
+export interface PlanStep {
+    id: string;
+    title: string;
+    description: string;
+    status: PlanStepStatus;
+    /** Agent key to delegate to (e.g., 'swe', 'browser', 'data') */
+    agentKey?: string;
+    /** IDs of steps that must complete first */
+    dependencies: string[];
+    /** Result from execution */
+    result?: string;
+    /** Error if failed */
+    error?: string;
+    /** Execution time in ms */
+    duration?: number;
+}
+export interface ExecutionPlan {
+    id: string;
+    goal: string;
+    steps: PlanStep[];
+    createdAt: number;
+    completedAt?: number;
+}
+/** Minimal agent interface for flow execution */
+export interface FlowAgent {
+    name: string;
+    run(request: string): Promise<string>;
+}
+export interface PlanningFlowConfig {
+    /** Function to call LLM for plan generation */
+    planWithLLM: (prompt: string) => Promise<string>;
+    /** Registered agents by key */
+    agents: Map<string, FlowAgent>;
+    /** Default agent key when step doesn't specify one */
+    defaultAgentKey: string;
+    /** Max retries for failed steps */
+    maxRetries: number;
+}
+export declare class PlanningFlow extends EventEmitter {
+    private config;
+    private stateMachine;
+    private activePlan;
+    constructor(config: PlanningFlowConfig);
+    /** Current plan */
+    get plan(): ExecutionPlan | null;
+    /** Current status */
+    get status(): AgentStatus;
+    /**
+     * Execute a task using the planning flow.
+     * 1. Create plan from goal
+     * 2. Execute each step with the appropriate agent
+     * 3. Synthesize final result
+     */
+    execute(goal: string): Promise<string>;
+    /** Phase 1: Generate a structured plan from the goal */
+    private createPlan;
+    /** Phase 2: Execute plan steps in dependency order */
+    private executeSteps;
+    /** Get steps whose dependencies are all completed */
+    private getReadySteps;
+    /** Execute a single plan step with the appropriate agent */
+    private executeStep;
+    /** Build execution context for a step, including dependency results */
+    private buildStepContext;
+    /** Skip steps that depend on a failed step */
+    private skipDependents;
+    /** Phase 3: Synthesize final results from all completed steps */
+    private synthesize;
+    /** Get plan progress as percentage */
+    getProgress(): number;
+}
+export declare enum FlowType {
+    PLANNING = "planning"
+}
+export declare function createFlow(type: FlowType, config: PlanningFlowConfig): PlanningFlow;