agentdb 1.0.0

package/dist/plugins/index.mjs

@@ -0,0 +1,168 @@
+/**
+ * SQLite Vector Learning Plugins
+ *
+ * Extensible plugin system for custom learning methodologies using vector databases.
+ *
+ * This module provides:
+ * - Plugin interface definitions
+ * - Plugin registry for discovery and management
+ * - Base plugin implementation
+ * - Configuration validation
+ *
+ * @module plugins
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   getRegistry,
+ *   registerPlugin,
+ *   loadPlugin,
+ *   BasePlugin,
+ *   type LearningPlugin,
+ *   type PluginConfig
+ * } from '@agentdb/plugins';
+ *
+ * // Register a plugin
+ * registerPlugin({
+ *   name: 'my-q-learning',
+ *   version: '1.0.0',
+ *   description: 'Custom Q-Learning implementation',
+ *   baseAlgorithm: 'q_learning',
+ *   factory: (config) => new MyQLearningPlugin(config)
+ * });
+ *
+ * // Load and use plugin
+ * const plugin = await loadPlugin('my-q-learning', {
+ *   config: {
+ *     training: { batchSize: 64 }
+ *   },
+ *   initialize: true
+ * });
+ *
+ * // Use plugin for learning
+ * const action = await plugin.selectAction(stateVector);
+ * await plugin.storeExperience({
+ *   state: stateVector,
+ *   action,
+ *   reward: 1.0,
+ *   nextState: nextStateVector,
+ *   done: false
+ * });
+ * await plugin.train();
+ * ```
+ */
+// ============ Plugin Registry ============
+export { 
+// Registry class
+PluginRegistry, 
+// Registry functions
+getRegistry, registerPlugin, loadPlugin, 
+// Errors
+PluginError } from './registry.mjs';
+// ============ Base Plugin ============
+export { 
+// Base plugin class
+BasePlugin } from './base-plugin.mjs';
+// ============ Validation ============
+export { 
+// Validation functions
+validatePluginConfig, validateRequired, getErrorSummary } from './validator.mjs';
+// ============ Version Information ============
+/**
+ * Plugin system version
+ */
+export const PLUGIN_SYSTEM_VERSION = '1.0.0';
+/**
+ * Supported plugin API version
+ */
+export const PLUGIN_API_VERSION = '1.0.0';
+export function createDefaultConfig(overrides) {
+    return {
+        name: overrides.name || 'unnamed-plugin',
+        version: overrides.version || '1.0.0',
+        description: overrides.description || 'A learning plugin',
+        baseAlgorithm: overrides.baseAlgorithm || 'custom',
+        algorithm: {
+            type: 'custom',
+            learningRate: 0.001,
+            discountFactor: 0.99,
+            ...overrides.algorithm
+        },
+        state: {
+            dimension: 768,
+            preprocessing: ['normalize'],
+            ...overrides.state
+        },
+        action: {
+            type: 'discrete',
+            spaceSize: 100,
+            selectionStrategy: 'epsilon_greedy',
+            ...overrides.action
+        },
+        reward: {
+            type: 'success_based',
+            ...overrides.reward
+        },
+        experienceReplay: overrides.experienceReplay || {
+            type: 'uniform',
+            capacity: 10000
+        },
+        storage: {
+            backend: 'agentdb',
+            path: './.rl/plugin.db',
+            hnsw: {
+                enabled: true,
+                M: 16,
+                efConstruction: 200
+            },
+            ...overrides.storage
+        },
+        training: {
+            batchSize: 32,
+            epochs: 10,
+            minExperiences: 100,
+            trainEvery: 100,
+            ...overrides.training
+        },
+        monitoring: {
+            trackMetrics: ['success_rate', 'avg_reward', 'loss'],
+            logInterval: 10,
+            saveCheckpoints: true,
+            checkpointInterval: 50,
+            ...overrides.monitoring
+        },
+        extensions: overrides.extensions || []
+    };
+}
+import { getRegistry } from './registry.mjs';
+/**
+ * Check if plugin system is initialized
+ *
+ * @returns Whether registry has plugins
+ */
+export function isInitialized() {
+    const registry = getRegistry();
+    return registry.list().length > 0;
+}
+/**
+ * Get plugin system information
+ *
+ * @returns System information
+ */
+export function getSystemInfo() {
+    const registry = getRegistry();
+    const plugins = registry.list();
+    const activePlugins = registry.listActive();
+    return {
+        systemVersion: PLUGIN_SYSTEM_VERSION,
+        apiVersion: PLUGIN_API_VERSION,
+        totalPlugins: plugins.length,
+        activePlugins: activePlugins.length,
+        availablePlugins: plugins.map((p) => ({
+            name: p.name,
+            version: p.version,
+            baseAlgorithm: p.baseAlgorithm
+        }))
+    };
+}

package/dist/plugins/interface.d.ts

@@ -0,0 +1,439 @@
+/**
+ * Core interface definitions for the Learning Plugin System
+ *
+ * This module defines the contract that all learning plugins must implement,
+ * enabling custom learning methodologies to integrate seamlessly with the
+ * agentdb system.
+ *
+ * @module plugins/interface
+ */
+/**
+ * Vector type for state and action embeddings
+ */
+export type Vector = number[] | Float32Array | Float64Array;
+/**
+ * Plugin execution context with metadata
+ */
+export interface Context {
+    /** Task identifier */
+    taskId?: string;
+    /** Execution duration in milliseconds */
+    duration?: number;
+    /** Number of tokens used */
+    tokensUsed?: number;
+    /** Code complexity score (0-1) */
+    codeComplexity?: number;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Task outcome after action execution
+ */
+export interface Outcome {
+    /** Whether the task succeeded */
+    success: boolean;
+    /** Result value or error */
+    result?: any;
+    /** Error information if failed */
+    error?: Error;
+    /** Next state after action */
+    nextState?: any;
+    /** Whether this is a terminal state */
+    done: boolean;
+}
+/**
+ * Experience tuple for reinforcement learning
+ */
+export interface Experience {
+    /** Unique experience identifier */
+    id?: string;
+    /** Current state vector */
+    state: Vector;
+    /** Action taken */
+    action: Action;
+    /** Reward received */
+    reward: number;
+    /** Next state vector */
+    nextState: Vector;
+    /** Whether episode terminated */
+    done: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+    /** Timestamp when experience was collected */
+    timestamp?: number;
+    /** Priority for prioritized replay (optional) */
+    priority?: number;
+}
+/**
+ * Action representation
+ */
+export interface Action {
+    /** Action identifier or index */
+    id: string | number;
+    /** Action type */
+    type: 'discrete' | 'continuous';
+    /** Action value(s) */
+    value: number | number[];
+    /** Confidence or probability */
+    confidence?: number;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Training options
+ */
+export interface TrainOptions {
+    /** Number of training epochs */
+    epochs?: number;
+    /** Batch size for training */
+    batchSize?: number;
+    /** Validation split ratio */
+    validationSplit?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Custom training callbacks */
+    callbacks?: TrainingCallback[];
+}
+/**
+ * Training callback interface
+ */
+export interface TrainingCallback {
+    /** Called before training starts */
+    onTrainBegin?(logs?: Record<string, any>): void | Promise<void>;
+    /** Called after training ends */
+    onTrainEnd?(logs?: Record<string, any>): void | Promise<void>;
+    /** Called before each epoch */
+    onEpochBegin?(epoch: number, logs?: Record<string, any>): void | Promise<void>;
+    /** Called after each epoch */
+    onEpochEnd?(epoch: number, logs?: Record<string, any>): void | Promise<void>;
+    /** Called before each batch */
+    onBatchBegin?(batch: number, logs?: Record<string, any>): void | Promise<void>;
+    /** Called after each batch */
+    onBatchEnd?(batch: number, logs?: Record<string, any>): void | Promise<void>;
+}
+/**
+ * Training metrics
+ */
+export interface TrainingMetrics {
+    /** Training loss */
+    loss: number;
+    /** Validation loss */
+    validationLoss?: number;
+    /** Average Q-value */
+    avgQValue?: number;
+    /** Current exploration rate (epsilon) */
+    epsilon?: number;
+    /** Number of experiences processed */
+    experiencesProcessed: number;
+    /** Training duration in milliseconds */
+    duration: number;
+    /** Additional custom metrics */
+    [key: string]: any;
+}
+/**
+ * Plugin performance metrics
+ */
+export interface PluginMetrics {
+    /** Success rate (0-1) */
+    successRate: number;
+    /** Average reward per episode */
+    avgReward: number;
+    /** Total number of experiences collected */
+    totalExperiences: number;
+    /** Total number of training steps */
+    totalTrainingSteps: number;
+    /** Sample efficiency (experiences needed to reach threshold) */
+    sampleEfficiency?: number;
+    /** Current exploration rate */
+    explorationRate?: number;
+    /** Additional custom metrics */
+    [key: string]: any;
+}
+/**
+ * Plugin configuration schema
+ */
+export interface PluginConfig {
+    /** Plugin name (kebab-case) */
+    name: string;
+    /** Semantic version */
+    version: string;
+    /** Plugin author */
+    author?: string;
+    /** Plugin description */
+    description: string;
+    /** Base algorithm type */
+    baseAlgorithm: 'decision_transformer' | 'q_learning' | 'sarsa' | 'actor_critic' | 'custom';
+    /** Algorithm-specific configuration */
+    algorithm: AlgorithmConfig;
+    /** State representation configuration */
+    state: StateConfig;
+    /** Action space configuration */
+    action: ActionConfig;
+    /** Reward configuration */
+    reward: RewardConfig;
+    /** Experience replay configuration */
+    experienceReplay?: ExperienceReplayConfig;
+    /** Storage configuration */
+    storage: StorageConfig;
+    /** Training configuration */
+    training: TrainingConfig;
+    /** Monitoring configuration */
+    monitoring?: MonitoringConfig;
+    /** Plugin extensions */
+    extensions?: ExtensionConfig[];
+}
+/**
+ * Algorithm configuration
+ */
+export interface AlgorithmConfig {
+    /** Algorithm type */
+    type: string;
+    /** Learning rate */
+    learningRate?: number;
+    /** Discount factor (gamma) */
+    discountFactor?: number;
+    /** Additional algorithm-specific parameters */
+    [key: string]: any;
+}
+/**
+ * State configuration
+ */
+export interface StateConfig {
+    /** Embedding model name */
+    embeddingModel?: string;
+    /** State vector dimension */
+    dimension: number;
+    /** Preprocessing steps */
+    preprocessing?: ('normalize' | 'reduce_dim' | 'augment')[];
+}
+/**
+ * Action configuration
+ */
+export interface ActionConfig {
+    /** Action space type */
+    type: 'discrete' | 'continuous';
+    /** Number of discrete actions */
+    spaceSize?: number;
+    /** Bounds for continuous actions */
+    spaceBounds?: [number, number][];
+    /** Action selection strategy */
+    selectionStrategy: string;
+}
+/**
+ * Reward configuration
+ */
+export interface RewardConfig {
+    /** Reward function type */
+    type: 'success_based' | 'time_aware' | 'token_aware' | 'custom';
+    /** Custom reward function code */
+    function?: string;
+    /** Reward shaping parameters */
+    shaping?: {
+        gamma: number;
+        lambda: number;
+    };
+}
+/**
+ * Experience replay configuration
+ */
+export interface ExperienceReplayConfig {
+    /** Replay buffer type */
+    type: 'none' | 'uniform' | 'prioritized';
+    /** Buffer capacity */
+    capacity: number;
+    /** Prioritization exponent (for prioritized replay) */
+    alpha?: number;
+    /** Importance sampling exponent */
+    beta?: number;
+    /** Beta increment per sample */
+    betaIncrement?: number;
+}
+/**
+ * Storage configuration
+ */
+export interface StorageConfig {
+    /** Storage backend */
+    backend: 'agentdb';
+    /** Database file path */
+    path: string;
+    /** HNSW index configuration */
+    hnsw?: {
+        enabled: boolean;
+        M: number;
+        efConstruction: number;
+        efSearch?: number;
+    };
+    /** Quantization configuration */
+    quantization?: {
+        enabled: boolean;
+        bits: 8 | 16;
+    };
+}
+/**
+ * Training configuration
+ */
+export interface TrainingConfig {
+    /** Batch size */
+    batchSize: number;
+    /** Number of training epochs */
+    epochs?: number;
+    /** Validation split ratio */
+    validationSplit?: number;
+    /** Early stopping patience */
+    earlyStoppingPatience?: number;
+    /** Minimum experiences before training */
+    minExperiences: number;
+    /** Train every N experiences */
+    trainEvery?: number;
+    /** Online training mode */
+    online?: boolean;
+}
+/**
+ * Monitoring configuration
+ */
+export interface MonitoringConfig {
+    /** Metrics to track */
+    trackMetrics: string[];
+    /** Log interval (episodes) */
+    logInterval: number;
+    /** Save checkpoints */
+    saveCheckpoints: boolean;
+    /** Checkpoint interval (episodes) */
+    checkpointInterval?: number;
+    /** Weights & Biases configuration */
+    wandb?: {
+        enabled: boolean;
+        project: string;
+        entity?: string;
+    };
+}
+/**
+ * Extension configuration
+ */
+export interface ExtensionConfig {
+    /** Extension name */
+    name: string;
+    /** Whether extension is enabled */
+    enabled: boolean;
+    /** Extension-specific configuration */
+    config: Record<string, any>;
+}
+/**
+ * Core Learning Plugin interface
+ *
+ * All learning plugins must implement this interface to integrate
+ * with the agentdb plugin system.
+ */
+export interface LearningPlugin {
+    /** Plugin name */
+    readonly name: string;
+    /** Plugin version */
+    readonly version: string;
+    /** Plugin configuration */
+    readonly config: PluginConfig;
+    /**
+     * Initialize the plugin with configuration
+     *
+     * @param config - Plugin configuration
+     * @throws {Error} If initialization fails
+     */
+    initialize(config: PluginConfig): Promise<void>;
+    /**
+     * Cleanup and destroy the plugin
+     *
+     * @throws {Error} If cleanup fails
+     */
+    destroy(): Promise<void>;
+    /**
+     * Store a single experience
+     *
+     * @param experience - Experience to store
+     * @throws {Error} If storage fails
+     */
+    storeExperience(experience: Experience): Promise<void>;
+    /**
+     * Store a batch of experiences efficiently
+     *
+     * @param experiences - Array of experiences
+     * @throws {Error} If batch storage fails
+     */
+    storeBatch(experiences: Experience[]): Promise<void>;
+    /**
+     * Retrieve similar experiences using vector similarity
+     *
+     * @param state - Query state vector
+     * @param k - Number of similar experiences to retrieve
+     * @returns Array of similar experiences
+     * @throws {Error} If retrieval fails
+     */
+    retrieveSimilar(state: Vector, k: number): Promise<Experience[]>;
+    /**
+     * Select an action given the current state
+     *
+     * @param state - Current state vector
+     * @param context - Optional execution context
+     * @returns Selected action
+     * @throws {Error} If action selection fails
+     */
+    selectAction(state: Vector, context?: Context): Promise<Action>;
+    /**
+     * Train the plugin on collected experiences
+     *
+     * @param options - Optional training configuration
+     * @returns Training metrics
+     * @throws {Error} If training fails
+     */
+    train(options?: TrainOptions): Promise<TrainingMetrics>;
+    /**
+     * Get current plugin performance metrics
+     *
+     * @returns Plugin metrics
+     */
+    getMetrics(): Promise<PluginMetrics>;
+    /**
+     * Get plugin configuration
+     *
+     * @returns Plugin configuration
+     */
+    getConfig(): PluginConfig;
+    /**
+     * Save plugin state to disk
+     *
+     * @param path - File path to save to
+     * @throws {Error} If save fails
+     */
+    save(path: string): Promise<void>;
+    /**
+     * Load plugin state from disk
+     *
+     * @param path - File path to load from
+     * @throws {Error} If load fails
+     */
+    load(path: string): Promise<void>;
+}
+/**
+ * Plugin factory function type
+ */
+export type PluginFactory = (config?: Partial<PluginConfig>) => LearningPlugin | Promise<LearningPlugin>;
+/**
+ * Plugin metadata for registration
+ */
+export interface PluginMetadata {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Plugin description */
+    description: string;
+    /** Plugin author */
+    author?: string;
+    /** Base algorithm */
+    baseAlgorithm: string;
+    /** Plugin factory function */
+    factory: PluginFactory;
+    /** Default configuration */
+    defaultConfig?: Partial<PluginConfig>;
+    /** Plugin tags for categorization */
+    tags?: string[];
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/plugins/interface.d.ts.map

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

package/dist/plugins/interface.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Core interface definitions for the Learning Plugin System
+ *
+ * This module defines the contract that all learning plugins must implement,
+ * enabling custom learning methodologies to integrate seamlessly with the
+ * agentdb system.
+ *
+ * @module plugins/interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interface.js.map

package/dist/plugins/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/plugins/interface.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/plugins/interface.mjs

@@ -0,0 +1,10 @@
+/**
+ * Core interface definitions for the Learning Plugin System
+ *
+ * This module defines the contract that all learning plugins must implement,
+ * enabling custom learning methodologies to integrate seamlessly with the
+ * agentdb system.
+ *
+ * @module plugins/interface
+ */
+export {};