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

package/dist/src/embedding/index.js

@@ -0,0 +1,2 @@
+export { EmbeddingSpaceMismatchError, applyRoleTemplate, assertEmbeddingSpaceCompatible, createEmbeddingSpaceIdentity, embeddingSpacesEqual } from './EmbeddingSpaceIdentity.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,8BAA8B,EAC9B,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,6BAA6B,CAAC"}

package/dist/src/examples/quic-sync-example.d.ts

@@ -0,0 +1,9 @@
+/**
+ * QUIC Synchronization Example
+ *
+ * Demonstrates how to use QUICServer, QUICClient, and SyncCoordinator
+ * for bidirectional synchronization between AgentDB instances.
+ */
+declare function exampleQUICSync(): Promise<void>;
+export { exampleQUICSync };
+//# sourceMappingURL=quic-sync-example.d.ts.map

package/dist/src/examples/quic-sync-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quic-sync-example.d.ts","sourceRoot":"","sources":["../../../src/examples/quic-sync-example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,iBAAe,eAAe,kBAwK7B;AAYD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/src/examples/quic-sync-example.js

@@ -0,0 +1,169 @@
+/**
+ * QUIC Synchronization Example
+ *
+ * Demonstrates how to use QUICServer, QUICClient, and SyncCoordinator
+ * for bidirectional synchronization between AgentDB instances.
+ */
+import { createDatabase } from '../db-fallback.js';
+import { QUICServer, QUICClient, SyncCoordinator, ReflexionMemory, SkillLibrary, EmbeddingService, } from '../controllers/index.js';
+async function exampleQUICSync() {
+    console.log('🚀 QUIC Synchronization Example\n');
+    // Initialize two database instances (simulating local and remote)
+    const localDB = await createDatabase('./local-agent.db');
+    const remoteDB = await createDatabase('./remote-agent.db');
+    // Initialize embedding services
+    const localEmbedder = new EmbeddingService({
+        model: 'Xenova/all-MiniLM-L6-v2',
+        dimension: 384,
+        provider: 'transformers',
+    });
+    const remoteEmbedder = new EmbeddingService({
+        model: 'Xenova/all-MiniLM-L6-v2',
+        dimension: 384,
+        provider: 'transformers',
+    });
+    // Initialize memory controllers
+    const localReflexion = new ReflexionMemory(localDB, localEmbedder);
+    const remoteReflexion = new ReflexionMemory(remoteDB, remoteEmbedder);
+    const remoteSkillLib = new SkillLibrary(remoteDB, remoteEmbedder);
+    try {
+        // ===== Setup Remote Server =====
+        console.log('📡 Setting up remote QUIC server...');
+        const server = new QUICServer(remoteDB, {
+            host: '0.0.0.0',
+            port: 4433,
+            authToken: 'secret-token-123',
+            maxConnections: 10,
+            rateLimit: {
+                maxRequestsPerMinute: 60,
+                maxBytesPerMinute: 10 * 1024 * 1024,
+            },
+        });
+        await server.start();
+        console.log('✓ Server started\n');
+        // ===== Setup Local Client =====
+        console.log('📱 Setting up local QUIC client...');
+        const client = new QUICClient({
+            serverHost: 'localhost',
+            serverPort: 4433,
+            authToken: 'secret-token-123',
+            maxRetries: 3,
+            retryDelayMs: 1000,
+            timeoutMs: 30000,
+            poolSize: 5,
+        });
+        await client.connect();
+        console.log('✓ Client connected\n');
+        // Test ping
+        console.log('🏓 Testing connection...');
+        const pingResult = await client.ping();
+        console.log(`✓ Ping: ${pingResult.latencyMs}ms\n`);
+        // ===== Add some data to remote =====
+        console.log('📝 Adding test data to remote database...');
+        await remoteReflexion.storeEpisode({
+            sessionId: 'test-session',
+            task: 'Calculate fibonacci',
+            input: 'n=10',
+            output: '55',
+            critique: 'Efficient implementation',
+            reward: 1.0,
+            success: true,
+            latencyMs: 150,
+            tokensUsed: 200,
+            tags: ['math', 'algorithm'],
+        });
+        await remoteSkillLib.createSkill({
+            name: 'fibonacci',
+            description: 'Calculate fibonacci numbers',
+            signature: {
+                inputs: { n: 'number' },
+                outputs: { result: 'number' },
+            },
+            code: 'function fib(n) { ... }',
+            successRate: 1.0,
+            uses: 5,
+            avgReward: 0.95,
+            avgLatencyMs: 100,
+        });
+        console.log('✓ Test data added\n');
+        // ===== Setup Sync Coordinator =====
+        console.log('🔄 Setting up sync coordinator...');
+        const coordinator = new SyncCoordinator({
+            db: localDB,
+            client: client,
+            server: server,
+            conflictStrategy: 'latest-wins',
+            batchSize: 100,
+            autoSync: false,
+        });
+        // ===== Perform Manual Sync =====
+        console.log('🔄 Starting synchronization...\n');
+        const syncReport = await coordinator.sync((progress) => {
+            console.log(`  [${progress.phase}] ${progress.message || ''}`);
+            if (progress.itemType) {
+                console.log(`    Syncing ${progress.itemType}: ${progress.current}/${progress.total}`);
+            }
+        });
+        console.log('\n📊 Sync Report:');
+        console.log(`  Success: ${syncReport.success}`);
+        console.log(`  Duration: ${syncReport.durationMs}ms`);
+        console.log(`  Items pulled: ${syncReport.itemsPulled}`);
+        console.log(`  Items pushed: ${syncReport.itemsPushed}`);
+        console.log(`  Conflicts resolved: ${syncReport.conflictsResolved}`);
+        console.log(`  Bytes transferred: ${syncReport.bytesTransferred}`);
+        if (syncReport.errors.length > 0) {
+            console.log(`  Errors: ${syncReport.errors.join(', ')}`);
+        }
+        // ===== Check Sync State =====
+        console.log('\n📊 Sync State:');
+        const state = coordinator.getSyncState();
+        console.log(`  Last sync: ${new Date(state.lastSyncAt).toISOString()}`);
+        console.log(`  Total items synced: ${state.totalItemsSynced}`);
+        console.log(`  Total bytes synced: ${state.totalBytesSynced}`);
+        console.log(`  Sync count: ${state.syncCount}`);
+        // ===== Server Status =====
+        console.log('\n📡 Server Status:');
+        const serverStatus = server.getStatus();
+        console.log(`  Running: ${serverStatus.isRunning}`);
+        console.log(`  Active connections: ${serverStatus.activeConnections}`);
+        console.log(`  Total requests: ${serverStatus.totalRequests}`);
+        // ===== Client Status =====
+        console.log('\n📱 Client Status:');
+        const clientStatus = client.getStatus();
+        console.log(`  Connected: ${clientStatus.isConnected}`);
+        console.log(`  Pool size: ${clientStatus.poolSize}`);
+        console.log(`  Active connections: ${clientStatus.activeConnections}`);
+        console.log(`  Total requests: ${clientStatus.totalRequests}`);
+        // ===== Enable Auto-Sync =====
+        console.log('\n🔄 Testing auto-sync...');
+        coordinator['config'].autoSync = true;
+        coordinator['config'].syncIntervalMs = 5000; // 5 seconds
+        coordinator['startAutoSync']();
+        console.log('✓ Auto-sync enabled (5s interval)');
+        // Wait for one auto-sync cycle
+        await new Promise((resolve) => setTimeout(resolve, 6000));
+        coordinator.stopAutoSync();
+        console.log('✓ Auto-sync disabled');
+        // ===== Cleanup =====
+        console.log('\n🧹 Cleaning up...');
+        await client.disconnect();
+        await server.stop();
+        console.log('✓ Cleanup complete');
+        console.log('\n✅ QUIC Sync example completed successfully!');
+    }
+    catch (error) {
+        console.error('\n❌ Error:', error);
+        throw error;
+    }
+}
+// Run example if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    exampleQUICSync()
+        .then(() => process.exit(0))
+        .catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+export { exampleQUICSync };
+//# sourceMappingURL=quic-sync-example.js.map

package/dist/src/examples/quic-sync-example.js.map

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

package/dist/src/examples/wasm-vector-usage.d.ts

@@ -0,0 +1,12 @@
+/**
+ * WASM Vector Search - Usage Examples
+ *
+ * Demonstrates how to use WASM-accelerated vector operations in AgentDB
+ */
+declare function basicSimilarity(): Promise<void>;
+declare function batchProcessing(): Promise<void>;
+declare function indexSearch(): Promise<void>;
+declare function enhancedEmbeddings(): Promise<void>;
+declare function documentSearch(): Promise<void>;
+export { basicSimilarity, batchProcessing, indexSearch, enhancedEmbeddings, documentSearch, };
+//# sourceMappingURL=wasm-vector-usage.d.ts.map

package/dist/src/examples/wasm-vector-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-vector-usage.d.ts","sourceRoot":"","sources":["../../../src/examples/wasm-vector-usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,iBAAe,eAAe,kBAa7B;AAGD,iBAAe,eAAe,kBA2B7B;AAGD,iBAAe,WAAW,kBA8CzB;AAGD,iBAAe,kBAAkB,kBAyDhC;AAGD,iBAAe,cAAc,kBA+C5B;AAwBD,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,CAAC"}

package/dist/src/examples/wasm-vector-usage.js

@@ -0,0 +1,190 @@
+/**
+ * WASM Vector Search - Usage Examples
+ *
+ * Demonstrates how to use WASM-accelerated vector operations in AgentDB
+ */
+// @ts-ignore - Optional dependency
+import Database from 'better-sqlite3';
+import { WASMVectorSearch } from '../controllers/WASMVectorSearch.js';
+import { EnhancedEmbeddingService } from '../controllers/EnhancedEmbeddingService.js';
+// Example 1: Basic Vector Similarity
+async function basicSimilarity() {
+    console.log('=== Example 1: Basic Vector Similarity ===\n');
+    const db = new Database(':memory:');
+    const wasmSearch = new WASMVectorSearch(db);
+    const vectorA = new Float32Array([1, 0, 0]);
+    const vectorB = new Float32Array([0.7, 0.7, 0]);
+    const similarity = wasmSearch.cosineSimilarity(vectorA, vectorB);
+    console.log(`Cosine similarity: ${similarity.toFixed(4)}\n`);
+    db.close();
+}
+// Example 2: Batch Vector Processing
+async function batchProcessing() {
+    console.log('=== Example 2: Batch Vector Processing ===\n');
+    const db = new Database(':memory:');
+    const wasmSearch = new WASMVectorSearch(db);
+    const query = new Float32Array(384).fill(0.5);
+    const vectors = [];
+    // Generate 1000 random vectors
+    for (let i = 0; i < 1000; i++) {
+        const vec = new Float32Array(384);
+        for (let j = 0; j < 384; j++) {
+            vec[j] = Math.random();
+        }
+        vectors.push(vec);
+    }
+    const startTime = performance.now();
+    const similarities = wasmSearch.batchSimilarity(query, vectors);
+    const duration = performance.now() - startTime;
+    console.log(`Processed ${vectors.length} vectors in ${duration.toFixed(2)}ms`);
+    console.log(`Throughput: ${((vectors.length / duration) * 1000).toFixed(0)} vectors/sec`);
+    console.log(`Average similarity: ${(similarities.reduce((a, b) => a + b) / similarities.length).toFixed(4)}\n`);
+    db.close();
+}
+// Example 3: Build and Search Index
+async function indexSearch() {
+    console.log('=== Example 3: Index Building and Search ===\n');
+    const db = new Database(':memory:');
+    const wasmSearch = new WASMVectorSearch(db, { indexThreshold: 500 });
+    const vectors = [];
+    const ids = [];
+    const dimensions = 128;
+    // Generate 1500 vectors
+    for (let i = 0; i < 1500; i++) {
+        const vec = new Float32Array(dimensions);
+        for (let j = 0; j < dimensions; j++) {
+            vec[j] = Math.random();
+        }
+        vectors.push(vec);
+        ids.push(i);
+    }
+    console.log(`Building index for ${vectors.length} vectors...`);
+    const buildStart = performance.now();
+    wasmSearch.buildIndex(vectors, ids);
+    const buildTime = performance.now() - buildStart;
+    console.log(`Index built in ${buildTime.toFixed(2)}ms\n`);
+    // Search the index
+    const query = new Float32Array(dimensions).fill(0.5);
+    const searchStart = performance.now();
+    const results = wasmSearch.searchIndex(query, 10, 0.5);
+    const searchTime = performance.now() - searchStart;
+    console.log(`Search completed in ${searchTime.toFixed(2)}ms`);
+    console.log(`Found ${results.length} results:\n`);
+    results.slice(0, 5).forEach((result, idx) => {
+        console.log(`  ${idx + 1}. ID: ${result.id}, Similarity: ${result.similarity.toFixed(4)}`);
+    });
+    const stats = wasmSearch.getStats();
+    console.log(`\nIndex stats:`);
+    console.log(`  WASM: ${stats.wasmAvailable}`);
+    console.log(`  SIMD: ${stats.simdAvailable}`);
+    console.log(`  Index size: ${stats.indexSize} vectors\n`);
+    db.close();
+}
+// Example 4: Enhanced Embedding Service
+async function enhancedEmbeddings() {
+    console.log('=== Example 4: Enhanced Embedding Service ===\n');
+    const embedder = new EnhancedEmbeddingService({
+        model: 'mock-model',
+        dimension: 384,
+        provider: 'local',
+        enableWASM: true,
+        enableBatchProcessing: true,
+        batchSize: 50,
+    });
+    await embedder.initialize();
+    // Batch embedding
+    const texts = [
+        'machine learning',
+        'artificial intelligence',
+        'deep learning',
+        'neural networks',
+        'natural language processing',
+    ];
+    console.log('Batch embedding texts...');
+    const startTime = performance.now();
+    const embeddings = await embedder.embedBatch(texts);
+    const duration = performance.now() - startTime;
+    console.log(`Embedded ${texts.length} texts in ${duration.toFixed(2)}ms`);
+    console.log(`Average time per text: ${(duration / texts.length).toFixed(2)}ms\n`);
+    // Text similarity
+    const similarity = await embedder.similarity('machine learning', 'deep learning');
+    console.log(`Similarity between "machine learning" and "deep learning": ${similarity.toFixed(4)}\n`);
+    // Semantic search
+    const corpus = [
+        'machine learning algorithms',
+        'artificial intelligence research',
+        'cooking pasta recipe',
+        'neural network training',
+        'travel destinations',
+        'deep learning frameworks',
+    ];
+    console.log('Finding most similar texts to "AI and ML"...');
+    const results = await embedder.findMostSimilar('AI and ML', corpus, 3);
+    results.forEach((result, idx) => {
+        console.log(`  ${idx + 1}. "${result.text}" - Similarity: ${result.similarity.toFixed(4)}`);
+    });
+    const stats = embedder.getStats();
+    console.log(`\nService stats:`);
+    console.log(`  Cache size: ${stats.cacheSize}`);
+    console.log(`  WASM enabled: ${stats.wasmEnabled}`);
+    console.log(`  SIMD enabled: ${stats.simdEnabled}\n`);
+}
+// Example 5: Realistic Use Case - Document Search
+async function documentSearch() {
+    console.log('=== Example 5: Realistic Document Search ===\n');
+    const documents = [
+        { id: 1, title: 'Introduction to Machine Learning', content: 'Machine learning is a subset of artificial intelligence...' },
+        { id: 2, title: 'Deep Learning Fundamentals', content: 'Deep learning uses neural networks with multiple layers...' },
+        { id: 3, title: 'Natural Language Processing', content: 'NLP enables computers to understand human language...' },
+        { id: 4, title: 'Computer Vision Basics', content: 'Computer vision allows machines to interpret visual data...' },
+        { id: 5, title: 'Italian Cuisine Recipes', content: 'Traditional Italian cooking techniques and pasta recipes...' },
+    ];
+    const embedder = new EnhancedEmbeddingService({
+        model: 'mock-model',
+        dimension: 384,
+        provider: 'local',
+        enableWASM: true,
+    });
+    await embedder.initialize();
+    // Embed all documents
+    console.log('Indexing documents...');
+    const docTexts = documents.map(d => `${d.title}. ${d.content}`);
+    const docEmbeddings = await embedder.embedBatch(docTexts);
+    // Search
+    const query = 'What are neural networks?';
+    console.log(`\nSearching for: "${query}"\n`);
+    const queryEmbedding = await embedder.embed(query);
+    const db = new Database(':memory:');
+    const wasmSearch = new WASMVectorSearch(db, { indexThreshold: 3 });
+    wasmSearch.buildIndex(docEmbeddings, documents.map(d => d.id));
+    const results = wasmSearch.searchIndex(queryEmbedding, 3);
+    console.log('Search results:');
+    results.forEach((result, idx) => {
+        const doc = documents.find(d => d.id === result.id);
+        console.log(`  ${idx + 1}. ${doc.title}`);
+        console.log(`     Relevance: ${(result.similarity * 100).toFixed(1)}%`);
+        console.log(`     Content: ${doc.content.substring(0, 60)}...`);
+        console.log();
+    });
+    db.close();
+}
+// Run all examples
+async function main() {
+    console.log('\n');
+    console.log('╔════════════════════════════════════════════════════════════════╗');
+    console.log('║     WASM Vector Search - Usage Examples                       ║');
+    console.log('╚════════════════════════════════════════════════════════════════╝');
+    console.log('\n');
+    await basicSimilarity();
+    await batchProcessing();
+    await indexSearch();
+    await enhancedEmbeddings();
+    await documentSearch();
+    console.log('✅ All examples completed successfully!\n');
+}
+// Execute if run directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}
+export { basicSimilarity, batchProcessing, indexSearch, enhancedEmbeddings, documentSearch, };
+//# sourceMappingURL=wasm-vector-usage.js.map

package/dist/src/examples/wasm-vector-usage.js.map

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

package/dist/src/governance/MetaHarnessGateway.d.ts

@@ -0,0 +1,55 @@
+export interface PromotionEvidence {
+    baseline: {
+        primary: number;
+        noopRate: number;
+        costPerWin: number;
+        regressed?: boolean;
+    };
+    candidate: {
+        primary: number;
+        noopRate: number;
+        costPerWin: number;
+        regressed?: boolean;
+    };
+    anchor?: {
+        baseline: number;
+        candidate: number;
+    };
+}
+export interface PromotionDecision {
+    promote: boolean;
+    reasons: string[];
+}
+type RuvectorMetaHarness = {
+    getMetaHarnessCapabilities(): Promise<unknown[]>;
+    evaluateMetaHarnessPromotion(evidence: PromotionEvidence): Promise<PromotionDecision>;
+    verifyMetaHarnessReplay(bundle: unknown, options?: {
+        pinnedGateFingerprint?: string;
+    }): Promise<Record<string, unknown>>;
+    scanMetaHarnessRewardHacks(trajectory: Record<string, unknown>): Promise<{
+        clean: boolean;
+        findings: unknown[];
+    }>;
+    assertMetaHarnessSafePayload(payload: unknown): Promise<void>;
+};
+type ModuleLoader = () => Promise<RuvectorMetaHarness>;
+/**
+ * Lazy governance boundary around ruvector's pinned MetaHarness integration.
+ * Candidate/Darwin execution is intentionally absent: AgentDB stores evidence
+ * and verifies promotion, but never executes research candidates over MCP.
+ */
+export declare class MetaHarnessGateway {
+    private readonly loader;
+    private pending;
+    constructor(loader?: ModuleLoader);
+    private load;
+    capabilities(): Promise<unknown[]>;
+    evaluatePromotion(evidence: PromotionEvidence): Promise<PromotionDecision>;
+    verifyReplay(bundle: unknown, pinnedGateFingerprint?: string): Promise<Record<string, unknown>>;
+    scanRewardHacks(trajectory: Record<string, unknown>): Promise<{
+        clean: boolean;
+        findings: unknown[];
+    }>;
+}
+export {};
+//# sourceMappingURL=MetaHarnessGateway.d.ts.map

package/dist/src/governance/MetaHarnessGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaHarnessGateway.d.ts","sourceRoot":"","sources":["../../../src/governance/MetaHarnessGateway.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,KAAK,mBAAmB,GAAG;IACzB,0BAA0B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,4BAA4B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtF,uBAAuB,CACrB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,0BAA0B,CACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACpD,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAqBvD;;;;GAIG;AACH,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,OAAO,CAA6C;gBAE/B,MAAM,GAAE,YAA4B;IAEjE,OAAO,CAAC,IAAI;IAKN,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlC,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO1E,YAAY,CAChB,MAAM,EAAE,OAAO,EACf,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAS7B,eAAe,CACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CAIpD"}

package/dist/src/governance/MetaHarnessGateway.js

@@ -0,0 +1,65 @@
+const defaultLoader = async () => {
+    const loaded = await import('ruvector');
+    const required = [
+        'getMetaHarnessCapabilities',
+        'evaluateMetaHarnessPromotion',
+        'verifyMetaHarnessReplay',
+        'scanMetaHarnessRewardHacks',
+        'assertMetaHarnessSafePayload',
+    ];
+    for (const name of required) {
+        if (typeof loaded[name] !== 'function') {
+            throw new Error(`Installed ruvector does not expose ${name}; install ruvector >= 0.2.40`);
+        }
+    }
+    return loaded;
+};
+/**
+ * Lazy governance boundary around ruvector's pinned MetaHarness integration.
+ * Candidate/Darwin execution is intentionally absent: AgentDB stores evidence
+ * and verifies promotion, but never executes research candidates over MCP.
+ */
+export class MetaHarnessGateway {
+    loader;
+    pending = null;
+    constructor(loader = defaultLoader) {
+        this.loader = loader;
+    }
+    load() {
+        this.pending ??= this.loader();
+        return this.pending;
+    }
+    async capabilities() {
+        return (await this.load()).getMetaHarnessCapabilities();
+    }
+    async evaluatePromotion(evidence) {
+        validatePromotionEvidence(evidence);
+        const api = await this.load();
+        await api.assertMetaHarnessSafePayload(evidence);
+        return api.evaluateMetaHarnessPromotion(evidence);
+    }
+    async verifyReplay(bundle, pinnedGateFingerprint) {
+        const api = await this.load();
+        await api.assertMetaHarnessSafePayload(bundle);
+        return api.verifyMetaHarnessReplay(bundle, pinnedGateFingerprint ? { pinnedGateFingerprint } : {});
+    }
+    async scanRewardHacks(trajectory) {
+        const api = await this.load();
+        return api.scanMetaHarnessRewardHacks(trajectory);
+    }
+}
+function validatePromotionEvidence(evidence) {
+    for (const side of ['baseline', 'candidate']) {
+        for (const field of ['primary', 'noopRate', 'costPerWin']) {
+            if (!Number.isFinite(evidence[side][field])) {
+                throw new TypeError(`${side}.${field} must be finite`);
+            }
+        }
+    }
+    if (evidence.anchor) {
+        if (!Number.isFinite(evidence.anchor.baseline) || !Number.isFinite(evidence.anchor.candidate)) {
+            throw new TypeError('anchor values must be finite');
+        }
+    }
+}
+//# sourceMappingURL=MetaHarnessGateway.js.map

package/dist/src/governance/MetaHarnessGateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaHarnessGateway.js","sourceRoot":"","sources":["../../../src/governance/MetaHarnessGateway.ts"],"names":[],"mappings":"AAoCA,MAAM,aAAa,GAAiB,KAAK,IAAI,EAAE;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAmC,CAAC;IAC1E,MAAM,QAAQ,GAAG;QACf,4BAA4B;QAC5B,8BAA8B;QAC9B,yBAAyB;QACzB,4BAA4B;QAC5B,8BAA8B;KACtB,CAAC;IACX,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,8BAA8B,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAGA;IAFrB,OAAO,GAAwC,IAAI,CAAC;IAE5D,YAA6B,SAAuB,aAAa;QAApC,WAAM,GAAN,MAAM,CAA8B;IAAG,CAAC;IAE7D,IAAI;QACV,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,0BAA0B,EAAE,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAA2B;QACjD,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,GAAG,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,GAAG,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAe,EACf,qBAA8B;QAE9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,GAAG,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,GAAG,CAAC,uBAAuB,CAChC,MAAM,EACN,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,UAAmC;QAEnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;CACF;AAED,SAAS,yBAAyB,CAAC,QAA2B;IAC5D,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,WAAW,CAAU,EAAE,CAAC;QACtD,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAU,EAAE,CAAC;YACnE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,IAAI,KAAK,iBAAiB,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9F,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/governance/RvfExperimentBranch.d.ts

@@ -0,0 +1,65 @@
+import type { PromotionDecision, PromotionEvidence } from './MetaHarnessGateway.js';
+import { MetaHarnessGateway } from './MetaHarnessGateway.js';
+interface GovernedRvfStore {
+    fileId(): Promise<string>;
+    parentId(): Promise<string>;
+    lineageDepth(): Promise<number>;
+    status(): Promise<{
+        totalVectors: number;
+        totalSegments: number;
+    }>;
+    segments(): Promise<Array<{
+        id: number;
+        segType: string;
+        payloadLength: number;
+    }>>;
+    verifyWitness(): {
+        valid: boolean;
+        entries: number;
+        error?: string;
+    };
+    derive(childPath: string): Promise<GovernedRvfStore>;
+    getStoragePath(): string;
+}
+export interface ExperimentAnchor {
+    repository: string;
+    commitSha: string;
+    benchmarkHash: string;
+    embeddingSpaceHash: string;
+    experimentalRevision: string;
+}
+export interface ExperimentReceipt {
+    schemaVersion: 1;
+    parentPath: string;
+    childPath: string;
+    parentFingerprint: string;
+    childFingerprint: string;
+    anchor: ExperimentAnchor;
+    decision: PromotionDecision;
+    receiptHash: string;
+}
+export declare class StaleExperimentBaselineError extends Error {
+    readonly code = "AGENTDB_STALE_EXPERIMENT_BASELINE";
+    constructor();
+}
+export declare class StaleExperimentRevisionError extends Error {
+    readonly code = "AGENTDB_STALE_EXPERIMENT_REVISION";
+    constructor();
+}
+export declare function assertExperimentRevisionCompatible(previous: ExperimentAnchor, next: ExperimentAnchor): void;
+/**
+ * Creates an isolated RVF COW candidate and authorizes it without mutating the
+ * authoritative parent. Actual path/alias promotion remains a trusted external
+ * transaction so candidate code never receives release authority.
+ */
+export declare class RvfExperimentBranch {
+    private readonly parent;
+    readonly candidate: GovernedRvfStore;
+    readonly anchor: ExperimentAnchor;
+    private readonly parentFingerprint;
+    private constructor();
+    static create(parent: GovernedRvfStore, childPath: string, anchor: ExperimentAnchor): Promise<RvfExperimentBranch>;
+    authorizePromotion(gateway: MetaHarnessGateway, evidence: PromotionEvidence): Promise<ExperimentReceipt>;
+}
+export {};
+//# sourceMappingURL=RvfExperimentBranch.d.ts.map

package/dist/src/governance/RvfExperimentBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RvfExperimentBranch.d.ts","sourceRoot":"","sources":["../../../src/governance/RvfExperimentBranch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,UAAU,gBAAgB;IACxB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACnF,aAAa,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrD,cAAc,IAAI,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,uCAAuC;;CAMrD;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,uCAAuC;;CAMrD;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,gBAAgB,GACrB,IAAI,CASN;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,SAAS,EAAE,gBAAgB;IACpC,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAJpC,OAAO;WAOM,MAAM,CACjB,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAczB,kBAAkB,CACtB,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAyB9B"}