agentdb 1.6.0 → 2.0.0-alpha.1

package/dist/db-unified.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Unified Database Layer for AgentDB v2
+ *
+ * Architecture:
+ * - PRIMARY: RuVector GraphDatabase (@ruvector/graph-node) for new databases
+ * - FALLBACK: SQLite (sql.js) for legacy databases
+ *
+ * Detection Logic:
+ * 1. Check if database file exists
+ * 2. If exists, check file signature to determine type
+ * 3. If new database or .graph extension → use GraphDatabase
+ * 4. If .db extension and SQLite signature → use SQLite (legacy mode)
+ *
+ * Migration:
+ * - Provides migration tool to convert SQLite → GraphDatabase
+ * - Maintains backward compatibility with existing databases
+ */
+import { GraphDatabaseAdapter } from './backends/graph/GraphDatabaseAdapter.js';
+export type DatabaseMode = 'graph' | 'sqlite-legacy';
+export interface UnifiedDatabaseConfig {
+    path: string;
+    dimensions?: number;
+    forceMode?: DatabaseMode;
+    autoMigrate?: boolean;
+}
+/**
+ * Unified Database - Smart detection and mode selection
+ */
+export declare class UnifiedDatabase {
+    private mode;
+    private graphDb?;
+    private sqliteDb?;
+    private config;
+    constructor(config: UnifiedDatabaseConfig);
+    /**
+     * Initialize database with automatic mode detection
+     */
+    initialize(embedder: any): Promise<void>;
+    /**
+     * Initialize the selected database mode
+     */
+    private initializeMode;
+    /**
+     * Check if file is a SQLite database
+     */
+    private isSQLiteDatabase;
+    /**
+     * Migrate SQLite database to RuVector GraphDatabase
+     */
+    private migrateSQLiteToGraph;
+    /**
+     * Get the active database mode
+     */
+    getMode(): DatabaseMode;
+    /**
+     * Get the graph database (if in graph mode)
+     */
+    getGraphDatabase(): GraphDatabaseAdapter | undefined;
+    /**
+     * Get the SQLite database (if in legacy mode)
+     */
+    getSQLiteDatabase(): any | undefined;
+    /**
+     * Execute a query (auto-routes to correct database)
+     */
+    query(queryOrCypher: string): Promise<any>;
+    /**
+     * Close database
+     */
+    close(): void;
+}
+/**
+ * Create unified database (smart mode detection)
+ */
+export declare function createUnifiedDatabase(path: string, embedder: any, options?: Partial<UnifiedDatabaseConfig>): Promise<UnifiedDatabase>;
+//# sourceMappingURL=db-unified.d.ts.map

package/dist/db-unified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-unified.d.ts","sourceRoot":"","sources":["../src/db-unified.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,oBAAoB,EAA4B,MAAM,0CAA0C,CAAC;AAK1G,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,eAAe,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,CAAM;IACvB,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAKzC;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA2D9C;;OAEG;YACW,cAAc;IA6B5B;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,oBAAoB;IAoGlC;;OAEG;IACH,OAAO,IAAI,YAAY;IAIvB;;OAEG;IACH,gBAAgB,IAAI,oBAAoB,GAAG,SAAS;IAIpD;;OAEG;IACH,iBAAiB,IAAI,GAAG,GAAG,SAAS;IAIpC;;OAEG;IACG,KAAK,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAUhD;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,GAAG,EACb,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACvC,OAAO,CAAC,eAAe,CAAC,CAY1B"}

package/dist/db-unified.js

@@ -0,0 +1,278 @@
+/**
+ * Unified Database Layer for AgentDB v2
+ *
+ * Architecture:
+ * - PRIMARY: RuVector GraphDatabase (@ruvector/graph-node) for new databases
+ * - FALLBACK: SQLite (sql.js) for legacy databases
+ *
+ * Detection Logic:
+ * 1. Check if database file exists
+ * 2. If exists, check file signature to determine type
+ * 3. If new database or .graph extension → use GraphDatabase
+ * 4. If .db extension and SQLite signature → use SQLite (legacy mode)
+ *
+ * Migration:
+ * - Provides migration tool to convert SQLite → GraphDatabase
+ * - Maintains backward compatibility with existing databases
+ */
+import { GraphDatabaseAdapter } from './backends/graph/GraphDatabaseAdapter.js';
+import { getDatabaseImplementation } from './db-fallback.js';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Unified Database - Smart detection and mode selection
+ */
+export class UnifiedDatabase {
+    mode;
+    graphDb;
+    sqliteDb;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.mode = 'graph'; // Default to graph mode
+    }
+    /**
+     * Initialize database with automatic mode detection
+     */
+    async initialize(embedder) {
+        const dbPath = this.config.path;
+        // Check if user forced a specific mode
+        if (this.config.forceMode) {
+            this.mode = this.config.forceMode;
+            await this.initializeMode(embedder);
+            return;
+        }
+        // Auto-detect based on file extension and content
+        if (fs.existsSync(dbPath)) {
+            const ext = path.extname(dbPath);
+            // .graph extension = always use graph mode
+            if (ext === '.graph') {
+                this.mode = 'graph';
+                console.log('🔍 Detected .graph extension → Using RuVector GraphDatabase');
+            }
+            // .db extension = check if it's SQLite
+            else if (ext === '.db') {
+                const isLegacySQLite = await this.isSQLiteDatabase(dbPath);
+                if (isLegacySQLite) {
+                    this.mode = 'sqlite-legacy';
+                    console.log('🔍 Detected legacy SQLite database');
+                    // Offer migration if autoMigrate is enabled
+                    if (this.config.autoMigrate) {
+                        console.log('🔄 Auto-migration enabled, will migrate to GraphDatabase...');
+                        await this.migrateSQLiteToGraph(dbPath, embedder);
+                        this.mode = 'graph';
+                    }
+                    else {
+                        console.log('ℹ️  Running in legacy SQLite mode');
+                        console.log('💡 To migrate to RuVector Graph: set autoMigrate: true');
+                    }
+                }
+                else {
+                    // Not SQLite, use graph mode
+                    this.mode = 'graph';
+                    console.log('🔍 Using RuVector GraphDatabase');
+                }
+            }
+            else {
+                // Unknown extension, default to graph
+                this.mode = 'graph';
+            }
+        }
+        else {
+            // New database - use graph mode (recommended)
+            this.mode = 'graph';
+            console.log('✨ Creating new RuVector GraphDatabase');
+            // Suggest .graph extension if not using it
+            if (!dbPath.endsWith('.graph') && !dbPath.endsWith('.db')) {
+                console.log('💡 Tip: Use .graph extension for clarity (e.g., agentdb.graph)');
+            }
+        }
+        await this.initializeMode(embedder);
+    }
+    /**
+     * Initialize the selected database mode
+     */
+    async initializeMode(embedder) {
+        if (this.mode === 'graph') {
+            // Use RuVector GraphDatabase
+            const config = {
+                storagePath: this.config.path,
+                dimensions: this.config.dimensions || 384,
+                distanceMetric: 'Cosine'
+            };
+            this.graphDb = new GraphDatabaseAdapter(config, embedder);
+            await this.graphDb.initialize();
+            console.log('✅ RuVector GraphDatabase ready (Primary Mode)');
+            console.log('   - Cypher queries enabled');
+            console.log('   - Hypergraph support active');
+            console.log('   - ACID transactions available');
+            console.log('   - 131K+ ops/sec batch inserts');
+        }
+        else {
+            // Use legacy SQLite
+            const impl = await getDatabaseImplementation();
+            this.sqliteDb = await require('./db-fallback.js').createDatabase(this.config.path);
+            console.log('⚠️  Using legacy SQLite mode');
+            console.log('   - Limited to SQL queries');
+            console.log('   - No hypergraph support');
+            console.log('   - Consider migration to GraphDatabase');
+        }
+    }
+    /**
+     * Check if file is a SQLite database
+     */
+    async isSQLiteDatabase(filePath) {
+        try {
+            const buffer = fs.readFileSync(filePath);
+            // SQLite databases start with "SQLite format 3\0"
+            const signature = buffer.slice(0, 16).toString();
+            return signature.startsWith('SQLite format 3');
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Migrate SQLite database to RuVector GraphDatabase
+     */
+    async migrateSQLiteToGraph(sqlitePath, embedder) {
+        console.log('🔄 Starting migration from SQLite to RuVector Graph...');
+        const startTime = Date.now();
+        // Load SQLite database
+        const sqliteImpl = await getDatabaseImplementation();
+        const sqliteDb = await require('./db-fallback.js').createDatabase(sqlitePath);
+        // Create new GraphDatabase
+        const graphPath = sqlitePath.replace(/\.db$/, '.graph');
+        const graphConfig = {
+            storagePath: graphPath,
+            dimensions: this.config.dimensions || 384,
+            distanceMetric: 'Cosine'
+        };
+        const graphDb = new GraphDatabaseAdapter(graphConfig, embedder);
+        await graphDb.initialize();
+        // Migrate episodes
+        console.log('   📦 Migrating episodes...');
+        const episodes = sqliteDb.prepare('SELECT * FROM episodes').all();
+        for (const ep of episodes) {
+            // Generate embedding for episode
+            const text = `${ep.task} ${ep.input || ''} ${ep.output || ''}`;
+            const embedding = await embedder.generateEmbedding(text);
+            await graphDb.storeEpisode({
+                id: `ep-${ep.id}`,
+                sessionId: ep.session_id,
+                task: ep.task,
+                reward: ep.reward,
+                success: ep.success === 1,
+                input: ep.input,
+                output: ep.output,
+                critique: ep.critique,
+                createdAt: ep.created_at,
+                tokensUsed: ep.tokens_used,
+                latencyMs: ep.latency_ms
+            }, embedding);
+        }
+        console.log(`   ✅ Migrated ${episodes.length} episodes`);
+        // Migrate skills
+        console.log('   📦 Migrating skills...');
+        const skills = sqliteDb.prepare('SELECT * FROM skills').all();
+        for (const skill of skills) {
+            const text = `${skill.name} ${skill.description} ${skill.code}`;
+            const embedding = await embedder.generateEmbedding(text);
+            await graphDb.storeSkill({
+                id: `skill-${skill.id}`,
+                name: skill.name,
+                description: skill.description,
+                code: skill.code,
+                usageCount: skill.usage_count,
+                avgReward: skill.avg_reward,
+                createdAt: skill.created_at,
+                updatedAt: skill.updated_at,
+                tags: skill.tags
+            }, embedding);
+        }
+        console.log(`   ✅ Migrated ${skills.length} skills`);
+        // Migrate causal edges
+        console.log('   📦 Migrating causal relationships...');
+        const edges = sqliteDb.prepare('SELECT * FROM causal_edges').all();
+        for (const edge of edges) {
+            const text = edge.mechanism;
+            const embedding = await embedder.generateEmbedding(text);
+            await graphDb.createCausalEdge({
+                from: `ep-${edge.from_memory_id}`,
+                to: `ep-${edge.to_memory_id}`,
+                mechanism: edge.mechanism,
+                uplift: edge.uplift,
+                confidence: edge.confidence,
+                sampleSize: edge.sample_size
+            }, embedding);
+        }
+        console.log(`   ✅ Migrated ${edges.length} causal edges`);
+        const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+        console.log(`\n🎉 Migration complete in ${duration}s!`);
+        console.log(`   Old SQLite: ${sqlitePath}`);
+        console.log(`   New Graph: ${graphPath}`);
+        console.log(`\n💡 Backup your SQLite file and update path to use .graph`);
+        // Close SQLite
+        sqliteDb.close();
+        // Update config to use new graph database
+        this.config.path = graphPath;
+        this.graphDb = graphDb;
+    }
+    /**
+     * Get the active database mode
+     */
+    getMode() {
+        return this.mode;
+    }
+    /**
+     * Get the graph database (if in graph mode)
+     */
+    getGraphDatabase() {
+        return this.graphDb;
+    }
+    /**
+     * Get the SQLite database (if in legacy mode)
+     */
+    getSQLiteDatabase() {
+        return this.sqliteDb;
+    }
+    /**
+     * Execute a query (auto-routes to correct database)
+     */
+    async query(queryOrCypher) {
+        if (this.mode === 'graph') {
+            // Execute Cypher query
+            return await this.graphDb.query(queryOrCypher);
+        }
+        else {
+            // Execute SQL query
+            return this.sqliteDb.prepare(queryOrCypher).all();
+        }
+    }
+    /**
+     * Close database
+     */
+    close() {
+        if (this.graphDb) {
+            this.graphDb.close();
+        }
+        if (this.sqliteDb) {
+            this.sqliteDb.close();
+        }
+    }
+}
+/**
+ * Create unified database (smart mode detection)
+ */
+export async function createUnifiedDatabase(path, embedder, options) {
+    const config = {
+        path,
+        dimensions: options?.dimensions || 384,
+        forceMode: options?.forceMode,
+        autoMigrate: options?.autoMigrate ?? false // Default: manual migration
+    };
+    const db = new UnifiedDatabase(config);
+    await db.initialize(embedder);
+    return db;
+}
+//# sourceMappingURL=db-unified.js.map

package/dist/db-unified.js.map

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

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export { ReasoningBank } from './controllers/ReasoningBank.js';
 export { EmbeddingService } from './controllers/EmbeddingService.js';
 export { EnhancedEmbeddingService } from './controllers/EnhancedEmbeddingService.js';
 export { WASMVectorSearch } from './controllers/WASMVectorSearch.js';
+export { HNSWIndex } from './controllers/HNSWIndex.js';
 export { createDatabase } from './db-fallback.js';
 export { BatchOperations } from './optimizations/BatchOperations.js';
 export { QueryOptimizer } from './optimizations/QueryOptimizer.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAGxC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAGxC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -20,8 +20,9 @@ export { ReasoningBank } from './controllers/ReasoningBank.js';
 // Embedding services
 export { EmbeddingService } from './controllers/EmbeddingService.js';
 export { EnhancedEmbeddingService } from './controllers/EnhancedEmbeddingService.js';
-// WASM acceleration
+// WASM acceleration and HNSW indexing
 export { WASMVectorSearch } from './controllers/WASMVectorSearch.js';
+export { HNSWIndex } from './controllers/HNSWIndex.js';
 // Database utilities
 export { createDatabase } from './db-fallback.js';
 // Optimizations

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,qBAAqB;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,WAAW;AACX,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAExC,4CAA4C;AAC5C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF,sCAAsC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,qBAAqB;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,WAAW;AACX,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAExC,4CAA4C;AAC5C,cAAc,wBAAwB,CAAC"}

package/dist/malp/core/ccc.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Concordance Correlation Coefficient (CCC) Module
+ *
+ * Provides functions for computing CCC and related metrics.
+ * CCC measures agreement between two continuous measurements.
+ */
+import { Vector } from './linalg';
+/**
+ * Components of the CCC calculation
+ */
+export interface CCCComponents {
+    /** Pearson correlation coefficient */
+    rho: number;
+    /** Mean of first variable */
+    muX: number;
+    /** Mean of second variable */
+    muY: number;
+    /** Standard deviation of first variable */
+    sigmaX: number;
+    /** Standard deviation of second variable */
+    sigmaY: number;
+    /** Location shift component (bias) */
+    locationShift: number;
+    /** Scale shift component */
+    scaleShift: number;
+    /** Precision (correlation) */
+    precision: number;
+    /** Accuracy (bias correction factor) */
+    accuracy: number;
+}
+/**
+ * Result of CCC computation
+ */
+export interface CCCResult {
+    /** Concordance Correlation Coefficient (-1 to 1) */
+    ccc: number;
+    /** Detailed components breakdown */
+    components: CCCComponents;
+}
+/**
+ * Compute Concordance Correlation Coefficient
+ *
+ * CCC measures agreement between two continuous measurements.
+ * Range: [-1, 1], where 1 = perfect agreement
+ *
+ * Formula: CCC = 2 * cov(x,y) / (var(x) + var(y) + (mean(x) - mean(y))^2)
+ *
+ * @param x - First variable (reference/gold standard)
+ * @param y - Second variable (new/test method)
+ * @returns CCC result with components
+ */
+export declare function computeCCC(x: number[] | Vector, y: number[] | Vector): CCCResult;
+/**
+ * Alternative implementation using explicit formula
+ * Same as computeCCC but more explicit
+ */
+export declare function calculateCCC(x: number[] | Vector, y: number[] | Vector): CCCResult;
+/**
+ * Compute gradient of CCC with respect to predictions
+ *
+ * Useful for optimization algorithms that maximize CCC.
+ *
+ * @param x - Observed values
+ * @param y - Predicted values
+ * @returns Gradient vector
+ */
+export declare function computeCCCGradient(x: number[] | Vector, y: number[] | Vector): number[];
+/**
+ * Compute diagonal of Hessian matrix for CCC
+ * (approximate second derivatives)
+ *
+ * @param x - Observed values
+ * @param y - Predicted values
+ * @returns Diagonal Hessian elements
+ */
+export declare function computeCCCHessianDiagonal(x: number[] | Vector, y: number[] | Vector): number[];
+/**
+ * CCC-based loss function (negative CCC for minimization)
+ *
+ * @param x - Observed values
+ * @param y - Predicted values
+ * @returns Negative CCC (for minimization)
+ */
+export declare function cccLoss(x: number[] | Vector, y: number[] | Vector): number;
+/**
+ * Interpret CCC value
+ *
+ * @param ccc - CCC value
+ * @returns Human-readable interpretation
+ */
+export declare function interpretCCC(ccc: number): string;
+/**
+ * Validate CCC value is within expected range
+ *
+ * @param ccc - CCC value to validate
+ * @throws Error if CCC is outside [-1, 1] range
+ */
+export declare function validateCCC(ccc: number): void;
+//# sourceMappingURL=ccc.d.ts.map

package/dist/malp/core/ccc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccc.d.ts","sourceRoot":"","sources":["../../../src/malp/core/ccc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAoD,MAAM,UAAU,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnB,SAAS,CAsDX;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnB,SAAS,CAEX;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnB,MAAM,EAAE,CA6BV;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EACpB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GACnB,MAAM,EAAE,CA4BV;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYhD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ7C"}