@weavelogic/knowledge-graph-agent 0.6.0 → 0.7.1

package/dist/integrations/agentic-flow/feature-flags.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Feature Flags for Agentic-Flow Integration
+ *
+ * Provides runtime feature flag management for selectively enabling
+ * agentic-flow components based on configuration and availability.
+ *
+ * @module integrations/agentic-flow/feature-flags
+ */
+/**
+ * Available feature flag names
+ */
+export type FeatureFlagName = 'agentdb' | 'reasoning-bank' | 'agent-booster' | 'model-router' | 'quic-transport' | 'federation-hub';
+/**
+ * Feature flag metadata
+ */
+export interface FeatureFlagInfo {
+    name: FeatureFlagName;
+    enabled: boolean;
+    description: string;
+    requiresPackage: boolean;
+}
+/**
+ * Singleton feature flags manager
+ *
+ * Manages runtime feature flags for agentic-flow integration.
+ * Flags are computed based on configuration and package availability.
+ */
+export declare class FeatureFlags {
+    private static instance;
+    private flags;
+    private descriptions;
+    private constructor();
+    /**
+     * Get the singleton instance
+     *
+     * @returns FeatureFlags singleton
+     */
+    static getInstance(): FeatureFlags;
+    /**
+     * Reset the singleton instance (for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Initialize flags from current configuration
+     */
+    private initializeFlags;
+    /**
+     * Check if a feature is enabled
+     *
+     * @param feature - Feature name to check
+     * @returns True if feature is enabled
+     */
+    isEnabled(feature: FeatureFlagName): boolean;
+    /**
+     * Manually set a feature flag
+     *
+     * Useful for testing or runtime feature toggles.
+     *
+     * @param feature - Feature name
+     * @param enabled - Whether to enable the feature
+     */
+    setFlag(feature: FeatureFlagName, enabled: boolean): void;
+    /**
+     * Get all feature flags as a record
+     *
+     * @returns Record of all flag names to their enabled status
+     */
+    getAllFlags(): Record<FeatureFlagName, boolean>;
+    /**
+     * Get detailed information about all flags
+     *
+     * @returns Array of feature flag info objects
+     */
+    getAllFlagInfo(): FeatureFlagInfo[];
+    /**
+     * Refresh flags from current configuration
+     *
+     * Call this after configuration changes to update flags.
+     */
+    refresh(): void;
+    /**
+     * Get enabled feature count
+     *
+     * @returns Number of enabled features
+     */
+    getEnabledCount(): number;
+    /**
+     * Get list of enabled feature names
+     *
+     * @returns Array of enabled feature names
+     */
+    getEnabledFeatures(): FeatureFlagName[];
+    /**
+     * Get list of disabled feature names
+     *
+     * @returns Array of disabled feature names
+     */
+    getDisabledFeatures(): FeatureFlagName[];
+}
+/**
+ * Convenience getter for the singleton instance
+ *
+ * Note: Returns the current singleton instance. After calling
+ * FeatureFlags.resetInstance(), this will return a new instance.
+ */
+export declare const featureFlags: {
+    readonly instance: FeatureFlags;
+    isEnabled(feature: FeatureFlagName): boolean;
+    setFlag(feature: FeatureFlagName, enabled: boolean): void;
+    getAllFlags(): Record<FeatureFlagName, boolean>;
+    getAllFlagInfo(): FeatureFlagInfo[];
+    refresh(): void;
+    getEnabledCount(): number;
+    getEnabledFeatures(): FeatureFlagName[];
+    getDisabledFeatures(): FeatureFlagName[];
+};
+/**
+ * Helper function to check if a feature is enabled
+ *
+ * @param feature - Feature name to check
+ * @returns True if feature is enabled
+ */
+export declare function isFeatureEnabled(feature: FeatureFlagName): boolean;
+/**
+ * Helper function to run code only when a feature is enabled
+ *
+ * @param feature - Feature name to check
+ * @param fn - Function to run if feature is enabled
+ * @returns Result of function or undefined if disabled
+ */
+export declare function withFeature<T>(feature: FeatureFlagName, fn: () => T): T | undefined;
+/**
+ * Helper function to run async code only when a feature is enabled
+ *
+ * @param feature - Feature name to check
+ * @param fn - Async function to run if feature is enabled
+ * @returns Promise of result or undefined if disabled
+ */
+export declare function withFeatureAsync<T>(feature: FeatureFlagName, fn: () => Promise<T>): Promise<T | undefined>;
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/integrations/agentic-flow/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/integrations/agentic-flow/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,YAAY,CAA+B;IAEnD,OAAO;IAaP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO;IAI5C;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzD;;;;OAIG;IACH,WAAW,IAAI,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC;IAI/C;;;;OAIG;IACH,cAAc,IAAI,eAAe,EAAE;IAenC;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAIf;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAQzB;;;;OAIG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAQvC;;;;OAIG;IACH,mBAAmB,IAAI,eAAe,EAAE;CAOzC;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY;uBACP,YAAY;uBAGT,eAAe,GAAG,OAAO;qBAG3B,eAAe,WAAW,OAAO,GAAG,IAAI;mBAG1C,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC;sBAG7B,eAAe,EAAE;eAGxB,IAAI;uBAGI,MAAM;0BAGH,eAAe,EAAE;2BAGhB,eAAe,EAAE;CAGzC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,GAAG,SAAS,CAKf;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAKxB"}

package/dist/integrations/agentic-flow/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agentic-Flow Integration Module
+ *
+ * Provides optional integration with agentic-flow for enhanced AI agent capabilities.
+ * All features are opt-in and require the agentic-flow package to be installed.
+ *
+ * Features:
+ * - AgentDB: GNN-enhanced vector database (150x faster search)
+ * - ReasoningBank: Adaptive learning and memory distillation
+ * - AgentBooster: Dynamic capability enhancement (352x faster transforms)
+ * - ModelRouter: Intelligent LLM routing for cost optimization
+ * - QUICTransport: High-performance data synchronization
+ * - FederationHub: Multi-agent coordination
+ *
+ * @module integrations/agentic-flow
+ */
+export { type AgenticFlowConfig, defaultConfig, loadConfigFromEnv, getAgenticFlowConfig, setAgenticFlowConfig, resetAgenticFlowConfig, initializeConfig, isAgenticFlowAvailable, isAgenticFlowEnabled, validateConfig, } from './config.js';
+export { FeatureFlags, featureFlags, isFeatureEnabled, withFeature, withFeatureAsync, type FeatureFlagName, type FeatureFlagInfo, } from './feature-flags.js';
+export * from './adapters/index.js';
+export * from './migration/index.js';
+export * from './benchmark/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/agentic-flow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/agentic-flow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC"}

package/dist/integrations/agentic-flow/migration/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agentic-Flow Migration Utilities
+ *
+ * Export migration tools for vector store transitions.
+ *
+ * @module integrations/agentic-flow/migration
+ */
+export { VectorStoreMigration, migrateToAgentDB, createMigrationPlan, type MigrationOptions, type MigrationProgress, type MigrationResult, type MigrationStats, type ValidationResult, type VectorEntry, type ISourceVectorStore, type ITargetVectorStore, } from './migrate-to-agentdb.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/agentic-flow/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/migration/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC"}

package/dist/integrations/agentic-flow/migration/migrate-to-agentdb.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Vector Store Migration to AgentDB
+ *
+ * Provides utilities for migrating existing SQLite-based VectorStore
+ * data to the high-performance AgentDB backend.
+ *
+ * Features:
+ * - Batch migration with progress tracking
+ * - Post-migration validation
+ * - Rollback support
+ * - Parallel processing for large datasets
+ *
+ * @module integrations/agentic-flow/migration/migrate-to-agentdb
+ */
+/**
+ * Migration options
+ */
+export interface MigrationOptions {
+    /** Number of vectors to migrate per batch */
+    batchSize: number;
+    /** Callback for progress updates */
+    onProgress?: (progress: MigrationProgress) => void;
+    /** Validate data after migration */
+    validateAfterMigration: boolean;
+    /** Number of parallel batches (default: 1) */
+    parallelBatches: number;
+    /** Skip vectors that fail to migrate */
+    skipOnError: boolean;
+    /** Sample size for validation (percentage, 0-100) */
+    validationSampleSize: number;
+    /** Dry run mode - validate without migrating */
+    dryRun: boolean;
+}
+/**
+ * Migration progress information
+ */
+export interface MigrationProgress {
+    /** Total vectors to migrate */
+    total: number;
+    /** Successfully migrated vectors */
+    migrated: number;
+    /** Failed migrations */
+    failed: number;
+    /** Skipped vectors */
+    skipped: number;
+    /** Progress percentage (0-100) */
+    percentage: number;
+    /** Estimated time remaining in milliseconds */
+    estimatedTimeRemaining: number;
+    /** Current migration rate (vectors/second) */
+    rate: number;
+    /** Current batch number */
+    currentBatch: number;
+    /** Total batches */
+    totalBatches: number;
+    /** Current phase */
+    phase: 'preparing' | 'migrating' | 'validating' | 'complete';
+}
+/**
+ * Migration result
+ */
+export interface MigrationResult {
+    /** Whether migration completed successfully */
+    success: boolean;
+    /** Total vectors migrated */
+    totalMigrated: number;
+    /** Total vectors that failed to migrate */
+    totalFailed: number;
+    /** Total vectors skipped */
+    totalSkipped: number;
+    /** Migration duration in milliseconds */
+    duration: number;
+    /** Error messages */
+    errors: string[];
+    /** Validation results if performed */
+    validation?: ValidationResult;
+    /** Summary statistics */
+    stats: MigrationStats;
+}
+/**
+ * Migration statistics
+ */
+export interface MigrationStats {
+    /** Average migration rate (vectors/second) */
+    avgRate: number;
+    /** Peak migration rate (vectors/second) */
+    peakRate: number;
+    /** Source vector count */
+    sourceCount: number;
+    /** Target vector count */
+    targetCount: number;
+    /** Data integrity check result */
+    integrityValid: boolean;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Number of vectors validated */
+    samplesChecked: number;
+    /** Number of mismatches found */
+    mismatches: number;
+    /** Validation errors */
+    errors: string[];
+    /** Average similarity score of validated vectors */
+    avgSimilarity: number;
+}
+/**
+ * Vector entry for migration
+ */
+export interface VectorEntry {
+    nodeId: string;
+    content: string;
+    embedding: Float32Array;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Interface for source vector store (compatible with EnhancedVectorStore)
+ */
+export interface ISourceVectorStore {
+    getAllIds(): string[];
+    get(id: string): Promise<{
+        id: string;
+        vector: number[];
+        metadata: Record<string, unknown>;
+    } | null>;
+    getStats?(): {
+        totalVectors: number;
+    };
+    search?(query: {
+        vector: number[];
+        k?: number;
+        minScore?: number;
+    }): Promise<Array<{
+        id: string;
+        score: number;
+        metadata: Record<string, unknown>;
+    }>>;
+}
+/**
+ * Interface for target vector store (compatible with AgentDBVectorStore)
+ */
+export interface ITargetVectorStore {
+    upsertBatch(entries: Array<{
+        nodeId: string;
+        content: string;
+        embedding: Float32Array;
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    search(queryEmbedding: Float32Array, limit?: number, threshold?: number): Promise<Array<{
+        nodeId: string;
+        content: string;
+        similarity: number;
+        metadata: Record<string, unknown>;
+    }>>;
+    getStats(): Promise<{
+        totalVectors: number;
+        indexSize: number;
+        cacheHitRate: number;
+    }>;
+}
+/**
+ * Vector Store Migration class
+ *
+ * Handles the migration of vectors from a source VectorStore
+ * (SQLite-based) to AgentDB with progress tracking, validation,
+ * and error handling.
+ *
+ * @example
+ * ```typescript
+ * const migration = new VectorStoreMigration();
+ *
+ * const result = await migration.migrate(sourceStore, targetStore, {
+ *   batchSize: 100,
+ *   validateAfterMigration: true,
+ *   onProgress: (progress) => {
+ *     console.log(`${progress.percentage}% complete`);
+ *   },
+ * });
+ *
+ * if (result.success) {
+ *   console.log(`Migrated ${result.totalMigrated} vectors`);
+ * }
+ * ```
+ */
+export declare class VectorStoreMigration {
+    private startTime;
+    private rateHistory;
+    /**
+     * Log a message
+     */
+    private log;
+    /**
+     * Migrate vectors from source to target store
+     *
+     * @param source - Source VectorStore (SQLite-based)
+     * @param target - Target AgentDBVectorStore
+     * @param options - Migration options
+     * @returns Migration result
+     */
+    migrate(source: ISourceVectorStore, target: ITargetVectorStore, options?: Partial<MigrationOptions>): Promise<MigrationResult>;
+    /**
+     * Validate migration by comparing samples between source and target
+     */
+    private validateMigration;
+    /**
+     * Calculate migration statistics
+     */
+    private calculateStats;
+    /**
+     * Report progress to callback
+     */
+    private reportProgress;
+    /**
+     * Get random sample from array
+     */
+    private randomSample;
+}
+/**
+ * Convenience function for migrating from SQLite to AgentDB
+ *
+ * @param source - Source VectorStore
+ * @param target - Target AgentDBVectorStore
+ * @param options - Migration options
+ * @returns Migration result
+ */
+export declare function migrateToAgentDB(source: ISourceVectorStore, target: ITargetVectorStore, options?: Partial<MigrationOptions>): Promise<MigrationResult>;
+/**
+ * Create a migration plan without executing
+ *
+ * @param source - Source VectorStore
+ * @returns Migration plan details
+ */
+export declare function createMigrationPlan(source: ISourceVectorStore): Promise<{
+    totalVectors: number;
+    estimatedDuration: number;
+    estimatedBatches: number;
+    recommendations: string[];
+}>;
+//# sourceMappingURL=migrate-to-agentdb.d.ts.map

package/dist/integrations/agentic-flow/migration/migrate-to-agentdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-to-agentdb.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/migration/migrate-to-agentdb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,oCAAoC;IACpC,sBAAsB,EAAE,OAAO,CAAC;IAChC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;CACjB;AAcD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,yBAAyB;IACzB,KAAK,EAAE,cAAc,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,IAAI,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,IAAI,CAAC,CAAC;IACV,QAAQ,CAAC,IAAI;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,MAAM,CAAC,CAAC,KAAK,EAAE;QACb,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,YAAY,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,CACJ,cAAc,EAAE,YAAY,EAC5B,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC,CAAC;IACJ,QAAQ,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAgB;IAEnC;;OAEG;IACH,OAAO,CAAC,GAAG;IA2BX;;;;;;;OAOG;IACG,OAAO,CACX,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,OAAO,CAAC,eAAe,CAAC;IAsM3B;;OAEG;YACW,iBAAiB;IA0D/B;;OAEG;YACW,cAAc;IA2B5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,YAAY;CAIrB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC,CAgCD"}

package/dist/learning/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Learning Loop Module
+ *
+ * Implements the 4-Pillar Framework learning loop with memory extraction,
+ * agent priming, task completion tracking, daily logging, and A/B testing.
+ *
+ * This module provides the foundation for continuous learning and improvement
+ * of agent performance through experience.
+ *
+ * ## Architecture
+ *
+ * The learning loop consists of 5 key components:
+ *
+ * 1. **Memory Extraction Service**: Extracts episodic, procedural, semantic,
+ *    technical, and context memories from completed tasks.
+ *
+ * 2. **Agent Priming Service**: Provides agents with relevant context and
+ *    recommendations before task execution based on historical data.
+ *
+ * 3. **Task Completion Consumer**: Processes task completion events, extracts
+ *    memories, updates statistics, and triggers learning cycles.
+ *
+ * 4. **Daily Log Generator**: Creates comprehensive daily activity logs and
+ *    weekly reports for monitoring and analysis.
+ *
+ * 5. **A/B Testing Framework**: Enables experimentation with agent configurations
+ *    and prompts through controlled testing.
+ *
+ * ## Expected Impact
+ *
+ * - +10-15% task success rate through better priming
+ * - +0.15-0.20 quality score improvement
+ * - -15% time reduction through learned patterns
+ *
+ * @module learning
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   LearningLoop,
+ *   createLearningLoop,
+ *   MemoryType,
+ * } from './learning';
+ *
+ * // Create and initialize the learning loop
+ * const loop = createLearningLoop({
+ *   autoExtract: true,
+ *   enablePriming: true,
+ *   learningThreshold: 10,
+ * });
+ *
+ * await loop.initialize();
+ *
+ * // Process task completions
+ * await loop.onTaskCompleted(taskResult);
+ *
+ * // Prime an agent before execution
+ * const context = await loop.primeAgent('agent-123', {
+ *   id: 'task-456',
+ *   description: 'Implement user authentication',
+ *   agentType: 'coder',
+ * });
+ *
+ * // Generate daily report
+ * const log = await loop.generateDailyLog();
+ * console.log(`Tasks completed: ${log.tasksCompleted}`);
+ *
+ * // Create and run A/B tests
+ * const testId = await loop.createABTest({
+ *   name: 'Prompt Optimization',
+ *   description: 'Test different prompt styles',
+ *   variants: [
+ *     { id: 'control', name: 'Current', config: {}, weight: 0.5 },
+ *     { id: 'treatment', name: 'New', config: {}, weight: 0.5 },
+ *   ],
+ *   metrics: ['success_rate', 'quality_score'],
+ *   startDate: new Date(),
+ * });
+ *
+ * // Shutdown gracefully
+ * await loop.shutdown();
+ * ```
+ */
+export { MemoryType, MemoryConfidence, type ExtractedMemory, type TaskStep, type CodeChange, type TaskContext, type TaskResult, type TaskSummary, type TaskCompletionEvent, type PrimingContext, type AgentPerformanceEntry, type DailyLogEntry, type WeeklyReport, type ABTestVariant, type ABTest, type MetricStatistics, type VariantResult, type ABTestResult, type MemoryStore, type ActivityStore, type VectorStore, type LearningLoopConfig, DEFAULT_LEARNING_CONFIG, createMemoryId, createTestId, } from './types.js';
+export { MemoryExtractionService, createMemoryExtractionService, type MemoryExtractionConfig, } from './services/memory-extraction-service.js';
+export { AgentPrimingService, createAgentPrimingService, type AgentPrimingConfig, type TaskForPriming, } from './services/agent-priming-service.js';
+export { TaskCompletionConsumer, createTaskCompletionConsumer, type TaskConsumerConfig, type TaskConsumerEvents, } from './services/task-completion-consumer.js';
+export { DailyLogGenerator, createDailyLogGenerator, type DailyLogConfig, } from './services/daily-log-generator.js';
+export { ABTestingFramework, createABTestingFramework, type ABTestingConfig, } from './services/ab-testing-framework.js';
+export { LearningLoop, createLearningLoop, type LearningLoopEvents, type LearningCycleResult, type LearningLoopStatus, } from './learning-loop.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAGH,OAAO,EAEL,UAAU,EACV,gBAAgB,EAChB,KAAK,eAAe,EAGpB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,EAGxB,KAAK,cAAc,EAGnB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EAGjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAGhB,KAAK,kBAAkB,EACvB,uBAAuB,EAGvB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,eAAe,GACrB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC"}