agentdb 1.0.0

package/dist/cli/wizard/validator.js

@@ -0,0 +1,234 @@
+"use strict";
+/**
+ * Configuration validation
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+exports.validatePluginName = validatePluginName;
+exports.validateVersion = validateVersion;
+exports.validateRewardFunction = validateRewardFunction;
+const ajv_1 = __importDefault(require("ajv"));
+const ajv = new ajv_1.default({ allErrors: true });
+// JSON Schema for plugin configuration
+const pluginConfigSchema = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    title: 'Learning Plugin Configuration',
+    type: 'object',
+    required: ['name', 'version', 'description', 'algorithm', 'storage', 'training'],
+    properties: {
+        name: {
+            type: 'string',
+            pattern: '^[a-z0-9-]+$',
+            minLength: 3,
+            maxLength: 50,
+        },
+        version: {
+            type: 'string',
+            pattern: '^\\d+\\.\\d+\\.\\d+$',
+        },
+        author: {
+            type: 'string',
+        },
+        description: {
+            type: 'string',
+            minLength: 10,
+            maxLength: 500,
+        },
+        algorithm: {
+            type: 'object',
+            required: ['type', 'base'],
+            properties: {
+                type: {
+                    type: 'string',
+                },
+                base: {
+                    type: 'string',
+                    enum: ['decision_transformer', 'q_learning', 'sarsa', 'actor_critic', 'custom'],
+                },
+                learning_rate: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                },
+                discount_factor: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                },
+            },
+        },
+        reward: {
+            type: 'object',
+            required: ['type'],
+            properties: {
+                type: {
+                    type: 'string',
+                    // SECURITY FIX: Removed 'custom' to prevent code injection
+                    enum: ['success_based', 'time_aware', 'token_aware'],
+                },
+                // SECURITY: function field removed
+            },
+        },
+        storage: {
+            type: 'object',
+            required: ['backend', 'path'],
+            properties: {
+                backend: {
+                    type: 'string',
+                    enum: ['agentdb'],
+                },
+                path: {
+                    type: 'string',
+                },
+                hnsw: {
+                    type: 'object',
+                    properties: {
+                        enabled: { type: 'boolean' },
+                        M: { type: 'number', minimum: 2, maximum: 100 },
+                        efConstruction: { type: 'number', minimum: 10, maximum: 1000 },
+                    },
+                },
+                quantization: {
+                    type: 'object',
+                    properties: {
+                        enabled: { type: 'boolean' },
+                        bits: { type: 'number', enum: [8, 16] },
+                    },
+                },
+            },
+        },
+        training: {
+            type: 'object',
+            required: ['min_experiences'],
+            properties: {
+                batch_size: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 1024,
+                },
+                epochs: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 1000,
+                },
+                min_experiences: {
+                    type: 'number',
+                    minimum: 10,
+                },
+                train_every: {
+                    type: 'number',
+                    minimum: 1,
+                },
+                validation_split: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                },
+                online: {
+                    type: 'boolean',
+                },
+            },
+        },
+        monitoring: {
+            type: 'object',
+            properties: {
+                track_metrics: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+                log_interval: {
+                    type: 'number',
+                    minimum: 1,
+                },
+                save_checkpoints: {
+                    type: 'boolean',
+                },
+                checkpoint_interval: {
+                    type: 'number',
+                    minimum: 1,
+                },
+            },
+        },
+    },
+};
+const validate = ajv.compile(pluginConfigSchema);
+function validateConfig(config) {
+    const valid = validate(config);
+    if (valid) {
+        // Additional custom validation
+        const customErrors = performCustomValidation(config);
+        if (customErrors.length > 0) {
+            return {
+                valid: false,
+                errors: customErrors,
+            };
+        }
+        return {
+            valid: true,
+            errors: [],
+        };
+    }
+    const errors = validate.errors?.map((err) => {
+        return `${err.instancePath} ${err.message}`;
+    }) || ['Unknown validation error'];
+    return {
+        valid: false,
+        errors,
+    };
+}
+function performCustomValidation(config) {
+    const errors = [];
+    // SECURITY FIX: Custom reward functions completely removed from type system
+    // Type system now prevents 'custom' at compile time
+    // This check is kept for runtime validation of external JSON configs
+    // Validate algorithm-specific configuration
+    if (config.algorithm.base === 'q_learning') {
+        if (!config.algorithm.learning_rate) {
+            errors.push('Q-Learning requires learning_rate');
+        }
+        if (!config.algorithm.discount_factor) {
+            errors.push('Q-Learning requires discount_factor');
+        }
+    }
+    if (config.algorithm.base === 'decision_transformer') {
+        if (!config.algorithm.state_dim) {
+            errors.push('Decision Transformer requires state_dim');
+        }
+        if (!config.algorithm.action_dim) {
+            errors.push('Decision Transformer requires action_dim');
+        }
+    }
+    // Validate training configuration
+    if (!config.training.online && !config.training.batch_size) {
+        errors.push('Offline training requires batch_size');
+    }
+    // Validate HNSW configuration
+    if (config.storage.hnsw?.enabled) {
+        if (config.storage.hnsw.M && (config.storage.hnsw.M < 2 || config.storage.hnsw.M > 100)) {
+            errors.push('HNSW M parameter must be between 2 and 100');
+        }
+        if (config.storage.hnsw.efConstruction && config.storage.hnsw.efConstruction < 10) {
+            errors.push('HNSW efConstruction must be at least 10');
+        }
+    }
+    return errors;
+}
+function validatePluginName(name) {
+    return /^[a-z0-9-]+$/.test(name) && name.length >= 3 && name.length <= 50;
+}
+function validateVersion(version) {
+    return /^\d+\.\d+\.\d+$/.test(version);
+}
+function validateRewardFunction(func) {
+    try {
+        new Function('return ' + func);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/cli/wizard/validator.js.map

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

package/dist/cli/wizard/validator.mjs

@@ -0,0 +1,224 @@
+/**
+ * Configuration validation
+ */
+import Ajv from 'ajv';
+const ajv = new Ajv({ allErrors: true });
+// JSON Schema for plugin configuration
+const pluginConfigSchema = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    title: 'Learning Plugin Configuration',
+    type: 'object',
+    required: ['name', 'version', 'description', 'algorithm', 'storage', 'training'],
+    properties: {
+        name: {
+            type: 'string',
+            pattern: '^[a-z0-9-]+$',
+            minLength: 3,
+            maxLength: 50,
+        },
+        version: {
+            type: 'string',
+            pattern: '^\\d+\\.\\d+\\.\\d+$',
+        },
+        author: {
+            type: 'string',
+        },
+        description: {
+            type: 'string',
+            minLength: 10,
+            maxLength: 500,
+        },
+        algorithm: {
+            type: 'object',
+            required: ['type', 'base'],
+            properties: {
+                type: {
+                    type: 'string',
+                },
+                base: {
+                    type: 'string',
+                    enum: ['decision_transformer', 'q_learning', 'sarsa', 'actor_critic', 'custom'],
+                },
+                learning_rate: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                },
+                discount_factor: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                },
+            },
+        },
+        reward: {
+            type: 'object',
+            required: ['type'],
+            properties: {
+                type: {
+                    type: 'string',
+                    // SECURITY FIX: Removed 'custom' to prevent code injection
+                    enum: ['success_based', 'time_aware', 'token_aware'],
+                },
+                // SECURITY: function field removed
+            },
+        },
+        storage: {
+            type: 'object',
+            required: ['backend', 'path'],
+            properties: {
+                backend: {
+                    type: 'string',
+                    enum: ['agentdb'],
+                },
+                path: {
+                    type: 'string',
+                },
+                hnsw: {
+                    type: 'object',
+                    properties: {
+                        enabled: { type: 'boolean' },
+                        M: { type: 'number', minimum: 2, maximum: 100 },
+                        efConstruction: { type: 'number', minimum: 10, maximum: 1000 },
+                    },
+                },
+                quantization: {
+                    type: 'object',
+                    properties: {
+                        enabled: { type: 'boolean' },
+                        bits: { type: 'number', enum: [8, 16] },
+                    },
+                },
+            },
+        },
+        training: {
+            type: 'object',
+            required: ['min_experiences'],
+            properties: {
+                batch_size: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 1024,
+                },
+                epochs: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 1000,
+                },
+                min_experiences: {
+                    type: 'number',
+                    minimum: 10,
+                },
+                train_every: {
+                    type: 'number',
+                    minimum: 1,
+                },
+                validation_split: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                },
+                online: {
+                    type: 'boolean',
+                },
+            },
+        },
+        monitoring: {
+            type: 'object',
+            properties: {
+                track_metrics: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+                log_interval: {
+                    type: 'number',
+                    minimum: 1,
+                },
+                save_checkpoints: {
+                    type: 'boolean',
+                },
+                checkpoint_interval: {
+                    type: 'number',
+                    minimum: 1,
+                },
+            },
+        },
+    },
+};
+const validate = ajv.compile(pluginConfigSchema);
+export function validateConfig(config) {
+    const valid = validate(config);
+    if (valid) {
+        // Additional custom validation
+        const customErrors = performCustomValidation(config);
+        if (customErrors.length > 0) {
+            return {
+                valid: false,
+                errors: customErrors,
+            };
+        }
+        return {
+            valid: true,
+            errors: [],
+        };
+    }
+    const errors = validate.errors?.map((err) => {
+        return `${err.instancePath} ${err.message}`;
+    }) || ['Unknown validation error'];
+    return {
+        valid: false,
+        errors,
+    };
+}
+function performCustomValidation(config) {
+    const errors = [];
+    // SECURITY FIX: Custom reward functions completely removed from type system
+    // Type system now prevents 'custom' at compile time
+    // This check is kept for runtime validation of external JSON configs
+    // Validate algorithm-specific configuration
+    if (config.algorithm.base === 'q_learning') {
+        if (!config.algorithm.learning_rate) {
+            errors.push('Q-Learning requires learning_rate');
+        }
+        if (!config.algorithm.discount_factor) {
+            errors.push('Q-Learning requires discount_factor');
+        }
+    }
+    if (config.algorithm.base === 'decision_transformer') {
+        if (!config.algorithm.state_dim) {
+            errors.push('Decision Transformer requires state_dim');
+        }
+        if (!config.algorithm.action_dim) {
+            errors.push('Decision Transformer requires action_dim');
+        }
+    }
+    // Validate training configuration
+    if (!config.training.online && !config.training.batch_size) {
+        errors.push('Offline training requires batch_size');
+    }
+    // Validate HNSW configuration
+    if (config.storage.hnsw?.enabled) {
+        if (config.storage.hnsw.M && (config.storage.hnsw.M < 2 || config.storage.hnsw.M > 100)) {
+            errors.push('HNSW M parameter must be between 2 and 100');
+        }
+        if (config.storage.hnsw.efConstruction && config.storage.hnsw.efConstruction < 10) {
+            errors.push('HNSW efConstruction must be at least 10');
+        }
+    }
+    return errors;
+}
+export function validatePluginName(name) {
+    return /^[a-z0-9-]+$/.test(name) && name.length >= 3 && name.length <= 50;
+}
+export function validateVersion(version) {
+    return /^\d+\.\d+\.\d+$/.test(version);
+}
+export function validateRewardFunction(func) {
+    try {
+        new Function('return ' + func);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/core/backend-interface.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Backend interface for vector database implementations
+ * Supports both native (better-sqlite3) and WASM (sql.js) backends
+ */
+import { Vector, SearchResult, SimilarityMetric, DatabaseConfig } from '../types';
+/**
+ * Abstract interface for vector database backends
+ */
+export interface VectorBackend {
+    /**
+     * Initialize the database with given configuration
+     */
+    initialize(config: DatabaseConfig): void;
+    /**
+     * Insert a single vector
+     * @returns The ID of the inserted vector
+     */
+    insert(vector: Vector): string;
+    /**
+     * Insert multiple vectors in a transaction
+     * @returns Array of IDs of inserted vectors
+     */
+    insertBatch(vectors: Vector[]): string[];
+    /**
+     * Search for k-nearest neighbors
+     */
+    search(queryEmbedding: number[], k: number, metric: SimilarityMetric, threshold: number): SearchResult[];
+    /**
+     * Get vector by ID
+     */
+    get(id: string): Vector | null;
+    /**
+     * Delete vector by ID
+     * @returns true if deleted, false if not found
+     */
+    delete(id: string): boolean;
+    /**
+     * Get database statistics
+     */
+    stats(): {
+        count: number;
+        size: number;
+    };
+    /**
+     * Close database connection and cleanup resources
+     */
+    close(): void;
+    /**
+     * Export database to binary format (for WASM persistence)
+     */
+    export?(): Uint8Array;
+    /**
+     * Import database from binary format (for WASM persistence)
+     */
+    import?(data: Uint8Array): void;
+}
+/**
+ * Backend type enum
+ */
+export declare enum BackendType {
+    NATIVE = "native",
+    WASM = "wasm"
+}
+/**
+ * Extended database configuration with backend selection
+ */
+export interface ExtendedDatabaseConfig extends DatabaseConfig {
+    backend?: BackendType;
+    wasmBinary?: Uint8Array;
+}
+//# sourceMappingURL=backend-interface.d.ts.map

package/dist/core/backend-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-interface.d.ts","sourceRoot":"","sources":["../../src/core/backend-interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAEzC;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAEzC;;OAEG;IACH,MAAM,CACJ,cAAc,EAAE,MAAM,EAAE,EACxB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,GAChB,YAAY,EAAE,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAEzC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,IAAI,UAAU,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB"}

package/dist/core/backend-interface.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Backend interface for vector database implementations
+ * Supports both native (better-sqlite3) and WASM (sql.js) backends
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendType = void 0;
+/**
+ * Backend type enum
+ */
+var BackendType;
+(function (BackendType) {
+    BackendType["NATIVE"] = "native";
+    BackendType["WASM"] = "wasm";
+})(BackendType || (exports.BackendType = BackendType = {}));
+//# sourceMappingURL=backend-interface.js.map

package/dist/core/backend-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-interface.js","sourceRoot":"","sources":["../../src/core/backend-interface.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmEH;;GAEG;AACH,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;AACf,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB"}

package/dist/core/backend-interface.mjs

@@ -0,0 +1,12 @@
+/**
+ * Backend interface for vector database implementations
+ * Supports both native (better-sqlite3) and WASM (sql.js) backends
+ */
+/**
+ * Backend type enum
+ */
+export var BackendType;
+(function (BackendType) {
+    BackendType["NATIVE"] = "native";
+    BackendType["WASM"] = "wasm";
+})(BackendType || (BackendType = {}));