agentdb 3.0.0-alpha.2 → 3.0.0-alpha.20

package/dist/src/db-test.js

@@ -0,0 +1,55 @@
+/**
+ * Test Database Factory - Uses better-sqlite3 when available for testing
+ *
+ * Integration tests need to create large datasets and run many queries,
+ * which can exceed sql.js WASM memory limit (64MB). This factory attempts
+ * to use better-sqlite3 for tests, falling back to sql.js if unavailable.
+ */
+let betterSqlite3 = null;
+/**
+ * Try to load better-sqlite3 (optional dependency)
+ */
+async function loadBetterSqlite3() {
+    if (betterSqlite3)
+        return betterSqlite3;
+    try {
+        betterSqlite3 = (await import('better-sqlite3')).default;
+        console.log('✅ Using better-sqlite3 for tests (no memory limit)');
+        return betterSqlite3;
+    }
+    catch (error) {
+        console.warn('⚠️  better-sqlite3 not available, falling back to sql.js (64MB memory limit)');
+        console.warn('   Install with: npm install --save-dev better-sqlite3');
+        return null;
+    }
+}
+/**
+ * Wrap better-sqlite3 to add sql.js-compatible save() method
+ */
+function wrapBetterSqlite3(db) {
+    // Add sql.js-compatible save() method (no-op for better-sqlite3)
+    if (!db.save) {
+        db.save = function () {
+            // better-sqlite3 auto-saves, so this is a no-op
+            return;
+        };
+    }
+    return db;
+}
+/**
+ * Create database for testing - prefers better-sqlite3, falls back to sql.js
+ */
+export async function createTestDatabase(filename, options) {
+    const BetterSqlite3 = await loadBetterSqlite3();
+    if (BetterSqlite3) {
+        // Use better-sqlite3 (native, no memory limit)
+        const db = new BetterSqlite3(filename, options);
+        return wrapBetterSqlite3(db);
+    }
+    else {
+        // Fall back to sql.js (WASM, 64MB limit)
+        const { createDatabase } = await import('./db-fallback.js');
+        return createDatabase(filename, options);
+    }
+}
+//# sourceMappingURL=db-test.js.map

package/dist/src/db-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-test.js","sourceRoot":"","sources":["../../src/db-test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,IAAI,aAAa,GAAQ,IAAI,CAAC;AAE9B;;GAEG;AACH,KAAK,UAAU,iBAAiB;IAC9B,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,IAAI,CAAC;QACH,aAAa,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAC7F,OAAO,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,EAAO;IAChC,iEAAiE;IACjE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACb,EAAE,CAAC,IAAI,GAAG;YACR,gDAAgD;YAChD,OAAO;QACT,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAa;IACtE,MAAM,aAAa,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAEhD,IAAI,aAAa,EAAE,CAAC;QAClB,+CAA+C;QAC/C,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC5D,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/src/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/src/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;IA6D9C;;OAEG;YACW,cAAc;IA+B5B;;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/src/db-unified.js

@@ -0,0 +1,281 @@
+/**
+ * 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 * 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';
+                        // Migration already initialized graphDb, skip initializeMode
+                        return;
+                    }
+                    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 — db-fallback prefers native better-sqlite3 when
+            // loadable and falls back to sql.js (WASM) otherwise (ruflo #2235 A).
+            const { createDatabase, getDatabaseInfo } = await import('./db-fallback.js');
+            this.sqliteDb = await createDatabase(this.config.path);
+            const info = getDatabaseInfo();
+            console.log(`⚠️  Using legacy SQLite mode (${info.implementation})`);
+            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 using ESM import
+        const { createDatabase } = await import('./db-fallback.js');
+        const sqliteDb = await 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.embed(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.embed(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.embed(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/src/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/src/embedding/EmbeddingSpaceIdentity.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Canonical identity for an embedding space.
+ *
+ * The hash is intentionally independent of object insertion order. It is safe
+ * to persist in RVF metadata, cache keys, experiment manifests, and receipts.
+ */
+export type EmbeddingRole = 'query' | 'passage';
+export type EmbeddingRolePolicy = {
+    kind: 'symmetric';
+} | {
+    kind: 'asymmetric';
+    prefixPolicy: string;
+    prefixPolicyVersion: string;
+    queryTemplate: string;
+    passageTemplate: string;
+};
+export type EmbeddingProvenanceType = 'user_claim' | 'agent_output' | 'system_observation' | 'tool_result' | 'unknown';
+export interface MemoryProvenance {
+    type: EmbeddingProvenanceType;
+    sourceId?: string;
+    runId?: string;
+    receiptId?: string;
+    createdAt?: string;
+    trust?: 'unverified' | 'verified' | 'signed';
+    signature?: string;
+}
+export interface EmbeddingSpaceIdentityInput {
+    modelId: string;
+    modelArtifactHash: string;
+    tokenizerHash: string;
+    promptTemplateHash: string;
+    poolingStrategy: string;
+    truncationLength: number;
+    outputDimension: number;
+    outputDtype: string;
+    normalization: string;
+    runtimeRevision: string;
+    distanceMetric: string;
+    rolePolicy: EmbeddingRolePolicy;
+}
+export interface EmbeddingSpaceIdentity extends EmbeddingSpaceIdentityInput {
+    schema: 'agentdb.embedding-space.v1';
+    hashAlgorithm: 'sha256';
+    hash: string;
+}
+export type EmbeddingCompatibilityOperation = 'cache-reuse' | 'corpus-mutation' | 'vector-read';
+export declare class EmbeddingSpaceMismatchError extends Error {
+    readonly expectedHash: string;
+    readonly actualHash: string;
+    readonly operation: EmbeddingCompatibilityOperation;
+    readonly code = "AGENTDB_EMBEDDING_SPACE_MISMATCH";
+    constructor(expectedHash: string, actualHash: string, operation: EmbeddingCompatibilityOperation);
+}
+export declare function createEmbeddingSpaceIdentity(input: EmbeddingSpaceIdentityInput): EmbeddingSpaceIdentity;
+export declare function embeddingSpacesEqual(left: Pick<EmbeddingSpaceIdentity, 'hash'>, right: Pick<EmbeddingSpaceIdentity, 'hash'>): boolean;
+export declare function assertEmbeddingSpaceCompatible(expected: Pick<EmbeddingSpaceIdentity, 'hash'>, actual: Pick<EmbeddingSpaceIdentity, 'hash'>, operation: EmbeddingCompatibilityOperation): void;
+export declare function applyRoleTemplate(template: string, text: string): string;
+//# sourceMappingURL=EmbeddingSpaceIdentity.d.ts.map

package/dist/src/embedding/EmbeddingSpaceIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingSpaceIdentity.d.ts","sourceRoot":"","sources":["../../../src/embedding/EmbeddingSpaceIdentity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAChD,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAC/B,YAAY,GACZ,cAAc,GACd,oBAAoB,GACpB,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,sBAAuB,SAAQ,2BAA2B;IACzE,MAAM,EAAE,4BAA4B,CAAC;IACrC,aAAa,EAAE,QAAQ,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,+BAA+B,GACvC,aAAa,GACb,iBAAiB,GACjB,aAAa,CAAC;AAElB,qBAAa,2BAA4B,SAAQ,KAAK;IAIlD,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,SAAS,EAAE,+BAA+B;IALrD,QAAQ,CAAC,IAAI,sCAAsC;gBAGxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,+BAA+B;CAOtD;AA8ED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CAoBxB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,EAC1C,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,GAC1C,OAAO,CAET;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,EAC9C,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,EAC5C,SAAS,EAAE,+BAA+B,GACzC,IAAI,CAIN;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxE"}

package/dist/src/embedding/EmbeddingSpaceIdentity.js

@@ -0,0 +1,137 @@
+/**
+ * Canonical identity for an embedding space.
+ *
+ * The hash is intentionally independent of object insertion order. It is safe
+ * to persist in RVF metadata, cache keys, experiment manifests, and receipts.
+ */
+export class EmbeddingSpaceMismatchError extends Error {
+    expectedHash;
+    actualHash;
+    operation;
+    code = 'AGENTDB_EMBEDDING_SPACE_MISMATCH';
+    constructor(expectedHash, actualHash, operation) {
+        super(`Embedding space mismatch for ${operation}: expected ${expectedHash}, received ${actualHash}`);
+        this.expectedHash = expectedHash;
+        this.actualHash = actualHash;
+        this.operation = operation;
+        this.name = 'EmbeddingSpaceMismatchError';
+    }
+}
+function canonicalize(value) {
+    if (value === null || typeof value !== 'object') {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalize).join(',')}]`;
+    }
+    const record = value;
+    return `{${Object.keys(record)
+        .sort()
+        .map(key => `${JSON.stringify(key)}:${canonicalize(record[key])}`)
+        .join(',')}}`;
+}
+// Small, dependency-free SHA-256 keeps identity creation synchronous in Node,
+// browsers, WASM hosts, and edge runtimes.
+function sha256(input) {
+    const bytes = new TextEncoder().encode(input);
+    const bitLength = bytes.length * 8;
+    const paddedLength = (((bytes.length + 9 + 63) >> 6) << 6);
+    const padded = new Uint8Array(paddedLength);
+    padded.set(bytes);
+    padded[bytes.length] = 0x80;
+    const view = new DataView(padded.buffer);
+    view.setUint32(paddedLength - 4, bitLength >>> 0, false);
+    view.setUint32(paddedLength - 8, Math.floor(bitLength / 0x100000000), false);
+    const constants = new Uint32Array([
+        0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1,
+        0x923f82a4, 0xab1c5ed5, 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3,
+        0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786,
+        0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+        0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147,
+        0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13,
+        0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 0xa2bfe8a1, 0xa81a664b,
+        0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+        0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a,
+        0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208,
+        0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2
+    ]);
+    const state = new Uint32Array([
+        0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a,
+        0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19
+    ]);
+    const words = new Uint32Array(64);
+    const rotate = (value, bits) => (value >>> bits) | (value << (32 - bits));
+    for (let offset = 0; offset < padded.length; offset += 64) {
+        for (let i = 0; i < 16; i++)
+            words[i] = view.getUint32(offset + i * 4, false);
+        for (let i = 16; i < 64; i++) {
+            const a = words[i - 15];
+            const b = words[i - 2];
+            const s0 = rotate(a, 7) ^ rotate(a, 18) ^ (a >>> 3);
+            const s1 = rotate(b, 17) ^ rotate(b, 19) ^ (b >>> 10);
+            words[i] = (words[i - 16] + s0 + words[i - 7] + s1) >>> 0;
+        }
+        let [a, b, c, d, e, f, g, h] = state;
+        for (let i = 0; i < 64; i++) {
+            const s1 = rotate(e, 6) ^ rotate(e, 11) ^ rotate(e, 25);
+            const choose = (e & f) ^ (~e & g);
+            const t1 = (h + s1 + choose + constants[i] + words[i]) >>> 0;
+            const s0 = rotate(a, 2) ^ rotate(a, 13) ^ rotate(a, 22);
+            const majority = (a & b) ^ (a & c) ^ (b & c);
+            const t2 = (s0 + majority) >>> 0;
+            h = g;
+            g = f;
+            f = e;
+            e = (d + t1) >>> 0;
+            d = c;
+            c = b;
+            b = a;
+            a = (t1 + t2) >>> 0;
+        }
+        state[0] = (state[0] + a) >>> 0;
+        state[1] = (state[1] + b) >>> 0;
+        state[2] = (state[2] + c) >>> 0;
+        state[3] = (state[3] + d) >>> 0;
+        state[4] = (state[4] + e) >>> 0;
+        state[5] = (state[5] + f) >>> 0;
+        state[6] = (state[6] + g) >>> 0;
+        state[7] = (state[7] + h) >>> 0;
+    }
+    return Array.from(state, word => word.toString(16).padStart(8, '0')).join('');
+}
+export function createEmbeddingSpaceIdentity(input) {
+    if (!input.modelArtifactHash || !input.tokenizerHash || !input.promptTemplateHash) {
+        throw new Error('Embedding space identity requires immutable model, tokenizer, and prompt hashes');
+    }
+    if (!Number.isInteger(input.truncationLength) || input.truncationLength <= 0) {
+        throw new Error('Embedding truncationLength must be a positive integer');
+    }
+    if (!Number.isInteger(input.outputDimension) || input.outputDimension <= 0) {
+        throw new Error('Embedding outputDimension must be a positive integer');
+    }
+    const payload = {
+        schema: 'agentdb.embedding-space.v1',
+        ...input,
+        rolePolicy: Object.freeze({ ...input.rolePolicy })
+    };
+    return Object.freeze({
+        ...payload,
+        hashAlgorithm: 'sha256',
+        hash: sha256(canonicalize(payload))
+    });
+}
+export function embeddingSpacesEqual(left, right) {
+    return left.hash === right.hash;
+}
+export function assertEmbeddingSpaceCompatible(expected, actual, operation) {
+    if (operation !== 'vector-read' && !embeddingSpacesEqual(expected, actual)) {
+        throw new EmbeddingSpaceMismatchError(expected.hash, actual.hash, operation);
+    }
+}
+export function applyRoleTemplate(template, text) {
+    if (!template.includes('{text}')) {
+        throw new Error('Embedding role template must contain {text}');
+    }
+    return template.replaceAll('{text}', text);
+}
+//# sourceMappingURL=EmbeddingSpaceIdentity.js.map

package/dist/src/embedding/EmbeddingSpaceIdentity.js.map

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

package/dist/src/embedding/index.d.ts

@@ -0,0 +1,3 @@
+export { EmbeddingSpaceMismatchError, applyRoleTemplate, assertEmbeddingSpaceCompatible, createEmbeddingSpaceIdentity, embeddingSpacesEqual } from './EmbeddingSpaceIdentity.js';
+export type { EmbeddingCompatibilityOperation, EmbeddingProvenanceType, EmbeddingRole, EmbeddingRolePolicy, EmbeddingSpaceIdentity, EmbeddingSpaceIdentityInput, MemoryProvenance } from './EmbeddingSpaceIdentity.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/embedding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,8BAA8B,EAC9B,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,+BAA+B,EAC/B,uBAAuB,EACvB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EACjB,MAAM,6BAA6B,CAAC"}