agentic-qe 3.3.1 → 3.3.3

package/v3/dist/learning/dream/dream-scheduler.d.ts

@@ -0,0 +1,302 @@
+/**
+ * DreamScheduler - Automated Dream Cycle Scheduling
+ * ADR-021: QE ReasoningBank - Dream Cycle Integration
+ *
+ * The DreamScheduler provides automated triggering of dream cycles based on:
+ * - Time-based scheduling (periodic dreams)
+ * - Experience accumulation thresholds
+ * - Event-based triggers (quality gate failures, domain milestones)
+ *
+ * It coordinates with the DreamEngine to run actual dream cycles and
+ * can automatically apply high-confidence insights.
+ *
+ * @module v3/learning/dream/dream-scheduler
+ */
+import type { EventBus, MemoryBackend } from '../../kernel/interfaces.js';
+import type { DreamEngine, DreamCycleResult } from './dream-engine.js';
+/**
+ * Configuration for the DreamScheduler
+ */
+export interface DreamSchedulerConfig {
+    /** Interval between automatic dreams in ms. Default: 3600000 (1 hour) */
+    autoScheduleIntervalMs: number;
+    /** Minimum time between dreams in ms. Default: 300000 (5 minutes) */
+    minTimeBetweenDreamsMs: number;
+    /** Number of experiences before triggering a dream. Default: 20 */
+    experienceThreshold: number;
+    /** Whether to trigger dreams when experience threshold is reached. Default: true */
+    enableExperienceTrigger: boolean;
+    /** Trigger dream on quality gate failures. Default: true */
+    enableQualityGateFailureTrigger: boolean;
+    /** Trigger dream on domain milestones. Default: false */
+    enableDomainMilestoneTrigger: boolean;
+    /** Default dream duration in ms. Default: 10000 (10 seconds) */
+    defaultDreamDurationMs: number;
+    /** Quick dream duration in ms. Default: 5000 (5 seconds) */
+    quickDreamDurationMs: number;
+    /** Full dream duration in ms. Default: 30000 (30 seconds) */
+    fullDreamDurationMs: number;
+    /** Automatically apply insights above confidence threshold. Default: false */
+    autoApplyHighConfidenceInsights: boolean;
+    /** Confidence threshold for auto-applying insights. Default: 0.8 */
+    insightConfidenceThreshold: number;
+}
+/**
+ * Default DreamScheduler configuration
+ */
+export declare const DEFAULT_DREAM_SCHEDULER_CONFIG: DreamSchedulerConfig;
+/**
+ * A task experience to be recorded for dream processing
+ */
+export interface TaskExperience {
+    /** Unique identifier */
+    id: string;
+    /** Agent type that produced this experience */
+    agentType: string;
+    /** Domain this experience belongs to */
+    domain: string;
+    /** Type of task */
+    taskType: string;
+    /** Whether the task succeeded */
+    success: boolean;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Additional context */
+    context?: Record<string, unknown>;
+    /** When this experience occurred */
+    timestamp: Date;
+}
+/**
+ * Current status of the DreamScheduler
+ */
+export interface DreamSchedulerStatus {
+    /** Whether the scheduler is initialized */
+    initialized: boolean;
+    /** Whether the scheduler is running */
+    running: boolean;
+    /** Whether a dream is currently in progress */
+    dreaming: boolean;
+    /** Number of experiences in the buffer */
+    experienceCount: number;
+    /** Experience threshold for triggering */
+    experienceThreshold: number;
+    /** Time until next scheduled dream (ms) */
+    timeUntilNextDream: number | null;
+    /** Total dreams completed */
+    totalDreamsCompleted: number;
+    /** Last dream timestamp */
+    lastDreamTime: Date | null;
+    /** Whether auto-scheduling is enabled */
+    autoSchedulingEnabled: boolean;
+}
+/**
+ * Dependencies required by DreamScheduler
+ */
+export interface DreamSchedulerDependencies {
+    /** The DreamEngine instance for running dreams */
+    dreamEngine: DreamEngine;
+    /** EventBus for subscribing to domain events */
+    eventBus: EventBus;
+    /** Memory backend for persisting scheduler state (optional) */
+    memoryBackend?: MemoryBackend;
+}
+/**
+ * DreamScheduler manages automatic triggering of dream cycles.
+ *
+ * It follows the dependency injection pattern - all required dependencies
+ * (DreamEngine, EventBus) must be provided via the constructor.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new DreamScheduler({
+ *   dreamEngine,
+ *   eventBus,
+ *   memoryBackend, // optional
+ * });
+ *
+ * await scheduler.initialize();
+ * scheduler.start();
+ *
+ * // Record experiences as they happen
+ * scheduler.recordExperience({
+ *   id: 'exp-1',
+ *   agentType: 'tester',
+ *   domain: 'test-execution',
+ *   taskType: 'run-tests',
+ *   success: true,
+ *   duration: 5000,
+ *   timestamp: new Date(),
+ * });
+ *
+ * // Manually trigger a dream
+ * const result = await scheduler.triggerDream();
+ *
+ * // Stop and cleanup
+ * scheduler.stop();
+ * await scheduler.dispose();
+ * ```
+ */
+export declare class DreamScheduler {
+    private readonly config;
+    private readonly dreamEngine;
+    private readonly eventBus;
+    private readonly memoryBackend?;
+    private initialized;
+    private running;
+    private dreaming;
+    private experienceBuffer;
+    private lastDreamTime;
+    private scheduledDreamTimer;
+    private totalDreamsCompleted;
+    private subscriptions;
+    private lastDreamResult;
+    /**
+     * Create a new DreamScheduler instance.
+     *
+     * @param dependencies - Required dependencies (dreamEngine, eventBus, memoryBackend)
+     * @param config - Optional configuration overrides
+     * @throws {Error} If required dependencies are missing
+     */
+    constructor(dependencies: DreamSchedulerDependencies, config?: Partial<DreamSchedulerConfig>);
+    /**
+     * Initialize the scheduler.
+     *
+     * Sets up event subscriptions and restores state from memory if available.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start the scheduler.
+     *
+     * Begins automatic dream scheduling based on the configured interval.
+     */
+    start(): void;
+    /**
+     * Stop the scheduler.
+     *
+     * Stops automatic scheduling but does not dispose resources.
+     */
+    stop(): void;
+    /**
+     * Dispose of all resources.
+     *
+     * Stops scheduling, unsubscribes from events, and saves state.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Manually trigger a dream cycle.
+     *
+     * @param duration - Optional duration override in ms
+     * @returns Result of the dream cycle
+     */
+    triggerDream(duration?: number): Promise<DreamCycleResult>;
+    /**
+     * Trigger a quick dream (shorter duration).
+     *
+     * @returns Result of the dream cycle
+     */
+    triggerQuickDream(): Promise<DreamCycleResult>;
+    /**
+     * Trigger a full dream (longer duration).
+     *
+     * @returns Result of the dream cycle
+     */
+    triggerFullDream(): Promise<DreamCycleResult>;
+    /**
+     * Record a task experience for future dream processing.
+     *
+     * If experience threshold is reached and enabled, triggers a dream.
+     *
+     * @param experience - The experience to record
+     */
+    recordExperience(experience: TaskExperience): void;
+    /**
+     * Get the current experience buffer.
+     *
+     * @returns Copy of the experience buffer
+     */
+    getExperienceBuffer(): TaskExperience[];
+    /**
+     * Clear the experience buffer.
+     */
+    clearExperienceBuffer(): void;
+    /**
+     * Get the current scheduler status.
+     *
+     * @returns Current status object
+     */
+    getStatus(): DreamSchedulerStatus;
+    /**
+     * Get the result of the last completed dream.
+     *
+     * @returns Last dream result or null
+     */
+    getLastDreamResult(): DreamCycleResult | null;
+    /**
+     * Execute a dream cycle with the specified duration.
+     */
+    private executeDream;
+    /**
+     * Auto-apply insights that meet the confidence threshold.
+     */
+    private autoApplyInsights;
+    /**
+     * Schedule the next automatic dream.
+     */
+    private scheduleNextDream;
+    /**
+     * Clear any scheduled dream timer.
+     */
+    private clearScheduledDream;
+    /**
+     * Calculate delay until next scheduled dream.
+     */
+    private calculateNextDreamDelay;
+    /**
+     * Get time until the currently scheduled dream.
+     */
+    private getTimeUntilScheduledDream;
+    /**
+     * Check if enough time has passed since the last dream.
+     */
+    private canDream;
+    /**
+     * Get time until we can start a dream.
+     */
+    private getTimeUntilCanDream;
+    /**
+     * Handle quality gate completion events.
+     * Triggers a dream when a gate fails to analyze what went wrong.
+     */
+    private handleQualityGateEvent;
+    /**
+     * Handle domain milestone events.
+     * Triggers a dream to consolidate learnings after significant progress.
+     */
+    private handleDomainMilestoneEvent;
+    /**
+     * Publish a dream completed event.
+     */
+    private publishDreamCompletedEvent;
+    /**
+     * Save scheduler state to memory backend.
+     */
+    private saveState;
+    /**
+     * Restore scheduler state from memory backend.
+     */
+    private restoreState;
+    /**
+     * Ensure the scheduler is initialized.
+     */
+    private ensureInitialized;
+}
+/**
+ * Create a new DreamScheduler instance.
+ *
+ * @param dependencies - Required dependencies
+ * @param config - Optional configuration overrides
+ * @returns New DreamScheduler instance
+ */
+export declare function createDreamScheduler(dependencies: DreamSchedulerDependencies, config?: Partial<DreamSchedulerConfig>): DreamScheduler;
+export default DreamScheduler;
+//# sourceMappingURL=dream-scheduler.d.ts.map

package/v3/dist/learning/dream/dream-scheduler.d.ts.map

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