@weavelogic/knowledge-graph-agent 0.6.0 → 0.7.1

package/dist/learning/learning-loop.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Learning Loop Orchestrator
+ *
+ * Coordinates all learning loop components: memory extraction,
+ * agent priming, task completion, daily logs, and A/B testing.
+ *
+ * @module learning/learning-loop
+ */
+import { EventEmitter } from 'events';
+import { type LearningLoopConfig, type TaskResult, type TaskCompletionEvent, type PrimingContext, type DailyLogEntry, type WeeklyReport, type ABTest, type ABTestResult, type MemoryStore, type ActivityStore, type VectorStore } from './types.js';
+import { type TaskForPriming } from './services/agent-priming-service.js';
+/**
+ * Learning loop events
+ */
+export interface LearningLoopEvents {
+    'initialized': () => void;
+    'task-completed': (event: TaskCompletionEvent) => void;
+    'learning-cycle-started': () => void;
+    'learning-cycle-completed': (results: LearningCycleResult) => void;
+    'agent-primed': (agentId: string, context: PrimingContext) => void;
+    'daily-log-generated': (log: DailyLogEntry) => void;
+    'error': (error: Error) => void;
+    'shutdown': () => void;
+}
+/**
+ * Results from a learning cycle
+ */
+export interface LearningCycleResult {
+    memoriesConsolidated: number;
+    primingDataUpdated: boolean;
+    insightsGenerated: number;
+    learningsApplied: number;
+    duration: number;
+    timestamp: Date;
+}
+/**
+ * Learning loop status
+ */
+export interface LearningLoopStatus {
+    initialized: boolean;
+    running: boolean;
+    totalTasksProcessed: number;
+    totalMemoriesExtracted: number;
+    learningCyclesCompleted: number;
+    lastLearningCycle: Date | null;
+    activeABTests: number;
+    health: 'healthy' | 'degraded' | 'error';
+}
+/**
+ * Learning Loop Orchestrator
+ *
+ * Central coordinator for the 4-Pillar Framework learning system.
+ * Manages the flow of information between all learning components.
+ *
+ * @example
+ * ```typescript
+ * const loop = new LearningLoop({
+ *   autoExtract: true,
+ *   enablePriming: true,
+ *   learningThreshold: 10,
+ * });
+ *
+ * await loop.initialize();
+ *
+ * // Process task completions
+ * loop.onTaskCompleted(taskResult);
+ *
+ * // Prime an agent
+ * const context = await loop.primeAgent('agent-123', task);
+ *
+ * // Generate daily report
+ * const log = await loop.generateDailyLog();
+ * ```
+ */
+export declare class LearningLoop extends EventEmitter {
+    private config;
+    private memoryExtraction;
+    private agentPriming;
+    private taskConsumer;
+    private dailyLog;
+    private abTesting;
+    private memoryStore;
+    private activityStore;
+    private vectorStore;
+    private initialized;
+    private running;
+    private learningCyclesCompleted;
+    private lastLearningCycle;
+    private learningCycleTimer;
+    constructor(config?: Partial<LearningLoopConfig>);
+    /**
+     * Initialize the learning loop with optional stores
+     */
+    initialize(memoryStore?: MemoryStore, activityStore?: ActivityStore, vectorStore?: VectorStore): Promise<void>;
+    /**
+     * Process a completed task
+     */
+    onTaskCompleted(result: TaskResult): Promise<void>;
+    /**
+     * Prime an agent before task execution
+     */
+    primeAgent(agentId: string, task: TaskForPriming): Promise<PrimingContext>;
+    /**
+     * Run a learning cycle manually
+     */
+    runLearningCycle(): Promise<LearningCycleResult>;
+    /**
+     * Generate daily log
+     */
+    generateDailyLog(date?: Date): Promise<DailyLogEntry>;
+    /**
+     * Generate weekly report
+     */
+    generateWeeklyReport(weekEndDate?: Date): Promise<WeeklyReport>;
+    /**
+     * Create an A/B test
+     */
+    createABTest(test: Omit<ABTest, 'id' | 'status' | 'createdAt'>): Promise<string>;
+    /**
+     * Get A/B test results
+     */
+    getABTestResults(testId: string): Promise<ABTestResult>;
+    /**
+     * Get current status
+     */
+    getStatus(): LearningLoopStatus;
+    /**
+     * Get task statistics
+     */
+    getTaskStatistics(): import("./services/task-completion-consumer.js").TaskStatistics;
+    /**
+     * Pause the learning loop
+     */
+    pause(): void;
+    /**
+     * Resume the learning loop
+     */
+    resume(): void;
+    /**
+     * Shutdown the learning loop
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Set up internal event handlers
+     */
+    private setupEventHandlers;
+    /**
+     * Set up task consumer event handlers
+     */
+    private setupTaskConsumerHandlers;
+    /**
+     * Consolidate memories from recent tasks
+     */
+    private consolidateMemories;
+    /**
+     * Update agent priming data
+     */
+    private updatePrimingData;
+    /**
+     * Generate insights from recent data
+     */
+    private generateInsights;
+    /**
+     * Apply learnings to improve future performance
+     */
+    private applyLearnings;
+    /**
+     * Get active test configuration for an agent/task
+     */
+    private getActiveTestConfig;
+}
+/**
+ * Create a learning loop instance
+ */
+export declare function createLearningLoop(config?: Partial<LearningLoopConfig>): LearningLoop;
+//# sourceMappingURL=learning-loop.d.ts.map

package/dist/learning/learning-loop.d.ts.map

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

package/dist/learning/services/ab-testing-framework.d.ts

@@ -0,0 +1,135 @@
+/**
+ * A/B Testing Framework
+ *
+ * Enables experimentation with agent configurations, prompts, and workflows
+ * through controlled A/B tests with statistical analysis.
+ *
+ * @module learning/services/ab-testing-framework
+ */
+import { type ABTest, type ABTestResult } from '../types.js';
+/**
+ * Configuration for A/B testing
+ */
+export interface ABTestingConfig {
+    /** Minimum sample size for statistical significance */
+    minSampleSize: number;
+    /** P-value threshold for significance */
+    significanceThreshold: number;
+    /** Maximum concurrent tests */
+    maxConcurrentTests: number;
+    /** Auto-stop tests when clear winner is found */
+    autoStopOnWinner: boolean;
+    /** Minimum improvement to declare winner */
+    minImprovementThreshold: number;
+}
+/**
+ * A/B Testing Framework
+ *
+ * Manages experiments to optimize agent performance through
+ * controlled testing of different configurations.
+ *
+ * @example
+ * ```typescript
+ * const framework = new ABTestingFramework();
+ *
+ * const testId = await framework.createTest({
+ *   name: 'Prompt Optimization',
+ *   description: 'Test different prompt styles',
+ *   variants: [
+ *     { id: 'control', name: 'Current', config: { promptStyle: 'detailed' }, weight: 0.5 },
+ *     { id: 'treatment', name: 'Concise', config: { promptStyle: 'concise' }, weight: 0.5 },
+ *   ],
+ *   metrics: ['success_rate', 'response_time', 'quality_score'],
+ * });
+ *
+ * // Assign subjects to variants
+ * const variant = await framework.assignVariant(testId, 'user-123');
+ *
+ * // Record metrics
+ * await framework.recordMetric(testId, variant, 'success_rate', 1);
+ * ```
+ */
+export declare class ABTestingFramework {
+    private tests;
+    private metrics;
+    private subjectAssignments;
+    private config;
+    constructor(config?: Partial<ABTestingConfig>);
+    /**
+     * Create a new A/B test
+     */
+    createTest(test: Omit<ABTest, 'id' | 'status' | 'createdAt'>): Promise<string>;
+    /**
+     * Start an A/B test
+     */
+    startTest(testId: string): Promise<void>;
+    /**
+     * Assign a subject to a variant (deterministic based on subject ID)
+     */
+    assignVariant(testId: string, subjectId: string): Promise<string>;
+    /**
+     * Record a metric value for a variant
+     */
+    recordMetric(testId: string, variantId: string, metric: string, value: number, subjectId?: string): Promise<void>;
+    /**
+     * Analyze test results
+     */
+    analyzeResults(testId: string): Promise<ABTestResult>;
+    /**
+     * Stop a test
+     */
+    stopTest(testId: string, reason: string): Promise<void>;
+    /**
+     * Complete a test
+     */
+    completeTest(testId: string): Promise<ABTestResult>;
+    /**
+     * Get test by ID
+     */
+    getTest(testId: string): ABTest | undefined;
+    /**
+     * List all tests
+     */
+    listTests(status?: ABTest['status']): ABTest[];
+    /**
+     * Get variant config for a subject
+     */
+    getVariantConfig(testId: string, subjectId: string): Record<string, unknown> | undefined;
+    /**
+     * Delete a test and its data
+     */
+    deleteTest(testId: string): boolean;
+    /**
+     * Select variant based on subject ID (deterministic)
+     */
+    private selectVariant;
+    /**
+     * Calculate statistics for a set of values
+     */
+    private calculateStatistics;
+    /**
+     * Determine winner using statistical significance
+     */
+    private determineWinner;
+    /**
+     * Two-sample t-test for statistical significance
+     */
+    private tTest;
+    /**
+     * Cumulative distribution function for standard normal
+     */
+    private normalCDF;
+    /**
+     * Check if there's a clear winner to auto-stop
+     */
+    private checkForWinner;
+    /**
+     * Clear all tests and data
+     */
+    clear(): void;
+}
+/**
+ * Create an A/B testing framework instance
+ */
+export declare function createABTestingFramework(config?: Partial<ABTestingConfig>): ABTestingFramework;
+//# sourceMappingURL=ab-testing-framework.d.ts.map

package/dist/learning/services/ab-testing-framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab-testing-framework.d.ts","sourceRoot":"","sources":["../../../src/learning/services/ab-testing-framework.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,MAAM,EAEX,KAAK,YAAY,EAIlB,MAAM,aAAa,CAAC;AAerB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAO7C;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCpF;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BvE;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IA8BhB;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwE3D;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBzD;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;IAQ9C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAYxF;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAiBnC;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAsDvB;;OAEG;IACH,OAAO,CAAC,KAAK;IA0Bb;;OAEG;IACH,OAAO,CAAC,SAAS;IAkBjB;;OAEG;YACW,cAAc;IAyB5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,kBAAkB,CAEpB"}

package/dist/learning/services/agent-priming-service.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Agent Priming Service
+ *
+ * Primes agents with relevant context before task execution by
+ * retrieving similar past tasks and relevant memories.
+ *
+ * Enhanced with verdict judgment capability that leverages the
+ * ReasoningBank to provide historical insights and recommendations.
+ *
+ * @module learning/services/agent-priming-service
+ */
+import { type PrimingContext, type MemoryStore, type VectorStore, type TaskResult } from '../types.js';
+import { type ReasoningBankAdapter, type Verdict } from '../../integrations/agentic-flow/adapters/reasoning-bank-adapter.js';
+/**
+ * Task interface for priming (minimal required fields)
+ */
+export interface TaskForPriming {
+    /** Task identifier */
+    id: string;
+    /** Task description */
+    description: string;
+    /** Expected agent type */
+    agentType?: string;
+    /** Task tags */
+    tags?: string[];
+    /** Task priority */
+    priority?: 'low' | 'medium' | 'high' | 'critical';
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+/**
+ * Configuration for agent priming
+ */
+export interface AgentPrimingConfig {
+    /** Maximum memories to include */
+    maxMemories: number;
+    /** Maximum similar tasks to include */
+    maxSimilarTasks: number;
+    /** Similarity threshold (0-1) */
+    similarityThreshold: number;
+    /** Include warnings from failed tasks */
+    includeWarnings: boolean;
+    /** Maximum warnings to include */
+    maxWarnings: number;
+    /** Default tools by agent type */
+    defaultToolsByType: Record<string, string[]>;
+}
+/**
+ * Agent Priming Service
+ *
+ * Provides context and recommendations to agents before task execution
+ * based on historical data and relevant memories.
+ *
+ * @example
+ * ```typescript
+ * const priming = new AgentPrimingService(memoryStore, vectorStore);
+ * const context = await priming.primeAgent('agent-123', task);
+ * console.log(context.recommendedApproach);
+ * ```
+ */
+/**
+ * Extended priming context with verdict judgment
+ */
+export interface PrimingContextWithVerdict extends PrimingContext {
+    /** Verdict judgment from ReasoningBank */
+    verdict: Verdict | null;
+}
+/**
+ * Task insights from historical data
+ */
+export interface TaskInsights {
+    /** Number of similar tasks found */
+    similarTasks: number;
+    /** Success rate of similar tasks (0-1) */
+    successRate: number;
+    /** Average duration in milliseconds */
+    avgDuration: number;
+    /** Common approaches used in successful tasks */
+    commonApproaches: string[];
+}
+export declare class AgentPrimingService {
+    private config;
+    private memoryStore;
+    private vectorStore;
+    private reasoningBank;
+    private taskHistory;
+    constructor(memoryStore?: MemoryStore, vectorStore?: VectorStore, config?: Partial<AgentPrimingConfig>, reasoningBank?: ReasoningBankAdapter);
+    /**
+     * Set the ReasoningBank adapter for verdict judgment
+     */
+    setReasoningBank(reasoningBank: ReasoningBankAdapter): void;
+    /**
+     * Prime an agent with context for a task
+     */
+    primeAgent(agentId: string, task: TaskForPriming): Promise<PrimingContext>;
+    /**
+     * Record a completed task for future priming
+     */
+    recordTaskCompletion(result: TaskResult): void;
+    /**
+     * Find memories relevant to the task
+     */
+    private findRelevantMemories;
+    /**
+     * Find similar past tasks
+     */
+    private findSimilarTasks;
+    /**
+     * Generate recommended approach based on history
+     */
+    private generateApproach;
+    /**
+     * Extract warnings from failed similar tasks
+     */
+    private extractWarnings;
+    /**
+     * Suggest tools based on task type
+     */
+    private suggestTools;
+    /**
+     * Get recommended patterns from memories and tasks
+     */
+    private getRecommendedPatterns;
+    /**
+     * Estimate task duration based on similar tasks
+     */
+    private estimateDuration;
+    /**
+     * Calculate confidence in priming recommendations
+     */
+    private calculateConfidence;
+    /**
+     * Calculate similarity between two tasks
+     */
+    private calculateTaskSimilarity;
+    /**
+     * Get agent type specific recommendations
+     */
+    private getAgentTypeRecommendation;
+    /**
+     * Extract learnings from a task result
+     */
+    private extractLearnings;
+    /**
+     * Extract patterns from a task result
+     */
+    private extractPatterns;
+    /**
+     * Clear all recorded history
+     */
+    clearHistory(): void;
+    /**
+     * Prime agent with verdict judgment from ReasoningBank
+     *
+     * Extends standard priming with historical verdict judgment
+     * that provides insights based on similar past trajectories.
+     *
+     * @param agentId - ID of the agent to prime
+     * @param task - Task to prime for
+     * @returns PrimingContext with verdict
+     *
+     * @example
+     * ```typescript
+     * const contextWithVerdict = await priming.primeAgentWithVerdict('agent-123', task);
+     *
+     * if (contextWithVerdict.verdict?.recommendation === 'avoid') {
+     *   console.warn('Similar tasks have failed:', contextWithVerdict.verdict.warnings);
+     * }
+     * ```
+     */
+    primeAgentWithVerdict(agentId: string, task: TaskForPriming): Promise<PrimingContextWithVerdict>;
+    /**
+     * Get historical insights for a task description
+     *
+     * Provides aggregated insights from similar past tasks
+     * to help inform task planning and estimation.
+     *
+     * @param taskDescription - Description of the task
+     * @returns Task insights including success rate and common approaches
+     *
+     * @example
+     * ```typescript
+     * const insights = await priming.getTaskInsights('Implement user authentication');
+     *
+     * console.log(`Similar tasks: ${insights.similarTasks}`);
+     * console.log(`Success rate: ${(insights.successRate * 100).toFixed(1)}%`);
+     * console.log(`Avg duration: ${insights.avgDuration}ms`);
+     * ```
+     */
+    getTaskInsights(taskDescription: string): Promise<TaskInsights>;
+    /**
+     * Check if verdict judgment is available
+     *
+     * @returns True if ReasoningBank is configured and available
+     */
+    hasVerdictCapability(): boolean;
+}
+/**
+ * Create an agent priming service instance
+ *
+ * @param memoryStore - Optional memory store for retrieving memories
+ * @param vectorStore - Optional vector store for similarity search
+ * @param config - Optional configuration overrides
+ * @param reasoningBank - Optional ReasoningBank for verdict judgment
+ */
+export declare function createAgentPrimingService(memoryStore?: MemoryStore, vectorStore?: VectorStore, config?: Partial<AgentPrimingConfig>, reasoningBank?: ReasoningBankAdapter): AgentPrimingService;
+//# sourceMappingURL=agent-priming-service.d.ts.map

package/dist/learning/services/agent-priming-service.d.ts.map

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

package/dist/learning/services/daily-log-generator.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Daily Log Generator
+ *
+ * Generates daily activity logs and weekly reports summarizing
+ * task execution, agent performance, and system insights.
+ *
+ * @module learning/services/daily-log-generator
+ */
+import { type DailyLogEntry, type WeeklyReport, type TaskCompletionEvent, type ActivityStore, type MemoryStore } from '../types.js';
+/**
+ * Configuration for daily log generator
+ */
+export interface DailyLogConfig {
+    /** Maximum top agents to include */
+    maxTopAgents: number;
+    /** Maximum insights to generate */
+    maxInsights: number;
+    /** Include error details in logs */
+    includeErrors: boolean;
+    /** Maximum errors to include */
+    maxErrors: number;
+    /** Minimum tasks for meaningful insights */
+    minTasksForInsights: number;
+}
+/**
+ * Daily Log Generator
+ *
+ * Creates comprehensive daily logs and weekly reports from
+ * task completion data.
+ *
+ * @example
+ * ```typescript
+ * const generator = new DailyLogGenerator(activityStore, memoryStore);
+ * const log = await generator.generateDailyLog(new Date());
+ * console.log(`Tasks completed: ${log.tasksCompleted}`);
+ * ```
+ */
+export declare class DailyLogGenerator {
+    private activityStore;
+    private memoryStore;
+    private config;
+    private localTracker;
+    constructor(activityStore?: ActivityStore, memoryStore?: MemoryStore, config?: Partial<DailyLogConfig>);
+    /**
+     * Record an activity for local tracking
+     */
+    recordActivity(event: TaskCompletionEvent): void;
+    /**
+     * Generate daily log for a specific date
+     */
+    generateDailyLog(date?: Date): Promise<DailyLogEntry>;
+    /**
+     * Generate weekly report
+     */
+    generateWeeklyReport(weekEndDate?: Date): Promise<WeeklyReport>;
+    /**
+     * Get activities for a date range
+     */
+    private getActivitiesForRange;
+    /**
+     * Calculate task statistics
+     */
+    private calculateTaskStats;
+    /**
+     * Calculate agent performance statistics
+     */
+    private calculateAgentStats;
+    /**
+     * Get memory statistics for a day
+     */
+    private getMemoryStats;
+    /**
+     * Generate insights from the day's data
+     */
+    private generateInsights;
+    /**
+     * Collect errors from activities
+     */
+    private collectErrors;
+    /**
+     * Generate summary text
+     */
+    private generateSummary;
+    /**
+     * Generate week summary
+     */
+    private generateWeekSummary;
+    /**
+     * Identify top patterns from daily logs
+     */
+    private identifyTopPatterns;
+    /**
+     * Generate recommendations based on weekly data
+     */
+    private generateRecommendations;
+    /**
+     * Calculate week-over-week comparison
+     */
+    private calculateWeekComparison;
+    /**
+     * Calculate variance of an array
+     */
+    private calculateVariance;
+    /**
+     * Clear local tracking data
+     */
+    clear(): void;
+}
+/**
+ * Create a daily log generator instance
+ */
+export declare function createDailyLogGenerator(activityStore?: ActivityStore, memoryStore?: MemoryStore, config?: Partial<DailyLogConfig>): DailyLogGenerator;
+//# sourceMappingURL=daily-log-generator.d.ts.map

package/dist/learning/services/daily-log-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-log-generator.d.ts","sourceRoot":"","sources":["../../../src/learning/services/daily-log-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EAEjB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAqDD;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAkB;gBAGpC,aAAa,CAAC,EAAE,aAAa,EAC7B,WAAW,CAAC,EAAE,WAAW,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAQlC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAIhD;;OAEG;IACG,gBAAgB,CAAC,IAAI,GAAE,IAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAiDvE;;OAEG;IACG,oBAAoB,CAAC,WAAW,GAAE,IAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2DjF;;OAEG;YACW,qBAAqB;IAUnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0E3B;;OAEG;YACW,cAAc;IAgB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0ExB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsC/B;;OAEG;YACW,uBAAuB;IAWrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,CAAC,EAAE,aAAa,EAC7B,WAAW,CAAC,EAAE,WAAW,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,iBAAiB,CAEnB"}

package/dist/learning/services/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Learning Services Index
+ *
+ * Exports all learning loop services for easy importing.
+ *
+ * @module learning/services
+ */
+export { MemoryExtractionService, createMemoryExtractionService, type MemoryExtractionConfig, } from './memory-extraction-service.js';
+export { AgentPrimingService, createAgentPrimingService, type AgentPrimingConfig, type TaskForPriming, } from './agent-priming-service.js';
+export { TaskCompletionConsumer, createTaskCompletionConsumer, type TaskConsumerConfig, type TaskConsumerEvents, type TaskStatistics, } from './task-completion-consumer.js';
+export { DailyLogGenerator, createDailyLogGenerator, type DailyLogConfig, } from './daily-log-generator.js';
+export { ABTestingFramework, createABTestingFramework, type ABTestingConfig, } from './ab-testing-framework.js';
+export { TrajectoryTracker, createTrajectoryTracker, type TrajectoryTrackerConfig, type TrajectoryTrackerEvents, } from './trajectory-tracker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/learning/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/learning/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC"}