@claude-flow/cli 3.32.1 → 3.32.3

package/dist/src/memory/memory-initializer.d.ts

@@ -1,556 +0,0 @@
-/**
- * V3 Memory Initializer
- * Properly initializes the memory database with sql.js (WASM SQLite)
- * Includes pattern tables, vector embeddings, migration state tracking
- *
- * ADR-053: Routes through ControllerRegistry → AgentDB v3 when available,
- * falls back to raw sql.js for backwards compatibility.
- *
- * @module v3/cli/memory-initializer
- */
-export declare function getMemoryRoot(): string;
-/** For tests + the `memory configure` flow that mutates the config at runtime. */
-export declare function _resetMemoryRootCache(): void;
-/**
- * #2105: Resolve the full path to the SQLite memory database.
- * Precedence (highest to lowest):
- *   1. cliFlag             - explicit --path flag passed by a subcommand
- *   2. CLAUDE_FLOW_DB_PATH - full file-path override (new in #2105)
- *   3. getMemoryRoot()/memory.db - directory from CLAUDE_FLOW_MEMORY_PATH /
- *                                  config / default cwd/.swarm
- */
-export declare function resolveDbPath(cliFlag?: string): string;
-/**
- * Enhanced schema with pattern confidence, temporal decay, versioning
- * Vector embeddings enabled for semantic search
- */
-export declare const MEMORY_SCHEMA_V3 = "\n-- RuFlo V3 Memory Database\n-- Version: 3.0.0\n-- Features: Pattern learning, vector embeddings, temporal decay, migration tracking\n\nPRAGMA journal_mode = WAL;\nPRAGMA synchronous = NORMAL;\nPRAGMA foreign_keys = ON;\n\n-- ============================================\n-- CORE MEMORY TABLES\n-- ============================================\n\n-- Memory entries (main storage)\nCREATE TABLE IF NOT EXISTS memory_entries (\n  id TEXT PRIMARY KEY,\n  key TEXT NOT NULL,\n  namespace TEXT DEFAULT 'default',\n  content TEXT NOT NULL,\n  type TEXT DEFAULT 'semantic' CHECK(type IN ('semantic', 'episodic', 'procedural', 'working', 'pattern')),\n\n  -- Vector embedding for semantic search (stored as JSON array)\n  embedding TEXT,\n  embedding_model TEXT DEFAULT 'local',\n  embedding_dimensions INTEGER,\n\n  -- Metadata\n  tags TEXT, -- JSON array\n  metadata TEXT, -- JSON object\n  owner_id TEXT,\n\n  -- Timestamps\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  expires_at INTEGER,\n  last_accessed_at INTEGER,\n\n  -- Access tracking for hot/cold detection\n  access_count INTEGER DEFAULT 0,\n\n  -- Status\n  status TEXT DEFAULT 'active' CHECK(status IN ('active', 'archived', 'deleted')),\n\n  UNIQUE(namespace, key)\n);\n\n-- Indexes for memory entries\nCREATE INDEX IF NOT EXISTS idx_memory_namespace ON memory_entries(namespace);\nCREATE INDEX IF NOT EXISTS idx_memory_key ON memory_entries(key);\nCREATE INDEX IF NOT EXISTS idx_memory_type ON memory_entries(type);\nCREATE INDEX IF NOT EXISTS idx_memory_status ON memory_entries(status);\nCREATE INDEX IF NOT EXISTS idx_memory_created ON memory_entries(created_at);\nCREATE INDEX IF NOT EXISTS idx_memory_accessed ON memory_entries(last_accessed_at);\nCREATE INDEX IF NOT EXISTS idx_memory_owner ON memory_entries(owner_id);\n\n-- ============================================\n-- PATTERN LEARNING TABLES\n-- ============================================\n\n-- Learned patterns with confidence scoring and versioning\nCREATE TABLE IF NOT EXISTS patterns (\n  id TEXT PRIMARY KEY,\n\n  -- Pattern identification\n  name TEXT NOT NULL,\n  pattern_type TEXT NOT NULL CHECK(pattern_type IN (\n    'task-routing', 'error-recovery', 'optimization', 'learning',\n    'coordination', 'prediction', 'code-pattern', 'workflow'\n  )),\n\n  -- Pattern definition\n  condition TEXT NOT NULL, -- Regex or semantic match\n  action TEXT NOT NULL, -- What to do when pattern matches\n  description TEXT,\n\n  -- Confidence scoring (0.0 - 1.0)\n  confidence REAL DEFAULT 0.5,\n  success_count INTEGER DEFAULT 0,\n  failure_count INTEGER DEFAULT 0,\n\n  -- Temporal decay\n  decay_rate REAL DEFAULT 0.01, -- How fast confidence decays\n  half_life_days INTEGER DEFAULT 30, -- Days until confidence halves without use\n\n  -- Vector embedding for semantic pattern matching\n  embedding TEXT,\n  embedding_dimensions INTEGER,\n\n  -- Versioning\n  version INTEGER DEFAULT 1,\n  parent_id TEXT REFERENCES patterns(id),\n\n  -- Metadata\n  tags TEXT, -- JSON array\n  metadata TEXT, -- JSON object\n  source TEXT, -- Where the pattern was learned from\n\n  -- Timestamps\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  last_matched_at INTEGER,\n  last_success_at INTEGER,\n  last_failure_at INTEGER,\n\n  -- Status\n  status TEXT DEFAULT 'active' CHECK(status IN ('active', 'archived', 'deprecated', 'experimental'))\n);\n\n-- Indexes for patterns\nCREATE INDEX IF NOT EXISTS idx_patterns_type ON patterns(pattern_type);\nCREATE INDEX IF NOT EXISTS idx_patterns_confidence ON patterns(confidence DESC);\nCREATE INDEX IF NOT EXISTS idx_patterns_status ON patterns(status);\nCREATE INDEX IF NOT EXISTS idx_patterns_last_matched ON patterns(last_matched_at);\n\n-- Pattern evolution history (for versioning)\nCREATE TABLE IF NOT EXISTS pattern_history (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  pattern_id TEXT NOT NULL REFERENCES patterns(id),\n  version INTEGER NOT NULL,\n\n  -- Snapshot of pattern state\n  confidence REAL,\n  success_count INTEGER,\n  failure_count INTEGER,\n  condition TEXT,\n  action TEXT,\n\n  -- What changed\n  change_type TEXT CHECK(change_type IN ('created', 'updated', 'success', 'failure', 'decay', 'merged', 'split')),\n  change_reason TEXT,\n\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000)\n);\n\nCREATE INDEX IF NOT EXISTS idx_pattern_history_pattern ON pattern_history(pattern_id);\n\n-- ============================================\n-- LEARNING & TRAJECTORY TABLES\n-- ============================================\n\n-- Learning trajectories (SONA integration)\nCREATE TABLE IF NOT EXISTS trajectories (\n  id TEXT PRIMARY KEY,\n  session_id TEXT,\n\n  -- Trajectory state\n  status TEXT DEFAULT 'active' CHECK(status IN ('active', 'completed', 'failed', 'abandoned')),\n  verdict TEXT CHECK(verdict IN ('success', 'failure', 'partial', NULL)),\n\n  -- Context\n  task TEXT,\n  context TEXT, -- JSON object\n\n  -- Metrics\n  total_steps INTEGER DEFAULT 0,\n  total_reward REAL DEFAULT 0,\n\n  -- Timestamps\n  started_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  ended_at INTEGER,\n\n  -- Reference to extracted pattern (if any)\n  extracted_pattern_id TEXT REFERENCES patterns(id)\n);\n\n-- Trajectory steps\nCREATE TABLE IF NOT EXISTS trajectory_steps (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  trajectory_id TEXT NOT NULL REFERENCES trajectories(id),\n  step_number INTEGER NOT NULL,\n\n  -- Step data\n  action TEXT NOT NULL,\n  observation TEXT,\n  reward REAL DEFAULT 0,\n\n  -- Metadata\n  metadata TEXT, -- JSON object\n\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000)\n);\n\nCREATE INDEX IF NOT EXISTS idx_steps_trajectory ON trajectory_steps(trajectory_id);\n\n-- ============================================\n-- MIGRATION STATE TRACKING\n-- ============================================\n\n-- Migration state (for resume capability)\nCREATE TABLE IF NOT EXISTS migration_state (\n  id TEXT PRIMARY KEY,\n  migration_type TEXT NOT NULL, -- 'v2-to-v3', 'pattern', 'memory', etc.\n\n  -- Progress tracking\n  status TEXT DEFAULT 'pending' CHECK(status IN ('pending', 'in_progress', 'completed', 'failed', 'rolled_back')),\n  total_items INTEGER DEFAULT 0,\n  processed_items INTEGER DEFAULT 0,\n  failed_items INTEGER DEFAULT 0,\n  skipped_items INTEGER DEFAULT 0,\n\n  -- Current position (for resume)\n  current_batch INTEGER DEFAULT 0,\n  last_processed_id TEXT,\n\n  -- Source/destination info\n  source_path TEXT,\n  source_type TEXT,\n  destination_path TEXT,\n\n  -- Backup info\n  backup_path TEXT,\n  backup_created_at INTEGER,\n\n  -- Error tracking\n  last_error TEXT,\n  errors TEXT, -- JSON array of errors\n\n  -- Timestamps\n  started_at INTEGER,\n  completed_at INTEGER,\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000)\n);\n\n-- ============================================\n-- SESSION MANAGEMENT\n-- ============================================\n\n-- Sessions for context persistence\nCREATE TABLE IF NOT EXISTS sessions (\n  id TEXT PRIMARY KEY,\n\n  -- Session state\n  state TEXT NOT NULL, -- JSON object with full session state\n  status TEXT DEFAULT 'active' CHECK(status IN ('active', 'paused', 'completed', 'expired')),\n\n  -- Context\n  project_path TEXT,\n  branch TEXT,\n\n  -- Metrics\n  tasks_completed INTEGER DEFAULT 0,\n  patterns_learned INTEGER DEFAULT 0,\n\n  -- Timestamps\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  expires_at INTEGER\n);\n\n-- ============================================\n-- VECTOR INDEX METADATA (for HNSW)\n-- ============================================\n\n-- Track HNSW index state\nCREATE TABLE IF NOT EXISTS vector_indexes (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n\n  -- Index configuration\n  dimensions INTEGER NOT NULL,\n  metric TEXT DEFAULT 'cosine' CHECK(metric IN ('cosine', 'euclidean', 'dot')),\n\n  -- HNSW parameters\n  hnsw_m INTEGER DEFAULT 16,\n  hnsw_ef_construction INTEGER DEFAULT 200,\n  hnsw_ef_search INTEGER DEFAULT 100,\n\n  -- Quantization\n  quantization_type TEXT CHECK(quantization_type IN ('none', 'scalar', 'product')),\n  quantization_bits INTEGER DEFAULT 8,\n\n  -- Statistics\n  total_vectors INTEGER DEFAULT 0,\n  last_rebuild_at INTEGER,\n\n  created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000),\n  updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now') * 1000)\n);\n\n-- ============================================\n-- GRAPH EDGES (ADR-130 Phase 1)\n-- Unified knowledge graph backend \u2014 sql.js canonical store\n-- ============================================\n\n-- Unified graph edges table (ADR-130)\n-- Node IDs use domain-prefixed format: {domain}:{uuid}\n-- where domain in (mem, agent, task, entity, span, pattern)\nCREATE TABLE IF NOT EXISTS graph_edges (\n  id              TEXT PRIMARY KEY,          -- edge-{uuid}\n  source_id       TEXT NOT NULL,             -- domain-prefixed node ID\n  target_id       TEXT NOT NULL,             -- domain-prefixed node ID\n  relation        TEXT NOT NULL,             -- e.g. \"caused\", \"depends-on\", \"imports\"\n  weight          REAL DEFAULT 1.0,\n  -- Temporal / reliability semantics (ADR-130 \u00A7\"graph that forgets\" property)\n  confidence      REAL DEFAULT 1.0,          -- [0,1]; updated by JUDGE step\n  decay_rate      REAL DEFAULT 0.0,          -- per-day exponential decay applied at read time\n  last_reinforced TEXT,                      -- ISO-8601; set when CONSOLIDATE re-touches edge\n  witness_id      TEXT,                      -- FK to verification/witness-fixes.json (ADR-103)\n  -- Embedding storage: \"inline:{base64}\" | \"vector_indexes:{id}\" | NULL\n  embedding_ref   TEXT,\n  metadata        TEXT,                      -- JSON blob for plugin-specific fields\n  created_at      TEXT NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_graph_edges_source    ON graph_edges (source_id);\nCREATE INDEX IF NOT EXISTS idx_graph_edges_target    ON graph_edges (target_id);\nCREATE INDEX IF NOT EXISTS idx_graph_edges_relation  ON graph_edges (relation);\nCREATE INDEX IF NOT EXISTS idx_graph_edges_reinforced ON graph_edges (last_reinforced);\n\n-- ============================================\n-- SYSTEM METADATA\n-- ============================================\n\nCREATE TABLE IF NOT EXISTS metadata (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  updated_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)\n);\n";
-interface HNSWEntry {
-    id: string;
-    key: string;
-    namespace: string;
-    content: string;
-}
-interface HNSWIndex {
-    db: any;
-    entries: Map<string, HNSWEntry>;
-    dimensions: number;
-    initialized: boolean;
-}
-/**
- * Get or create the HNSW index singleton
- * Lazily initializes from SQLite data on first use
- */
-export declare function getHNSWIndex(options?: {
-    dbPath?: string;
-    dimensions?: number;
-    forceRebuild?: boolean;
-}): Promise<HNSWIndex | null>;
-/**
- * Add entry to HNSW index (with automatic persistence)
- */
-export declare function addToHNSWIndex(id: string, embedding: number[], entry: HNSWEntry): Promise<boolean>;
-/**
- * Search HNSW index (150x faster than brute-force)
- * Returns results sorted by similarity (highest first)
- */
-export declare function searchHNSWIndex(queryEmbedding: number[], options?: {
-    k?: number;
-    namespace?: string;
-}): Promise<Array<{
-    id: string;
-    key: string;
-    content: string;
-    score: number;
-    namespace: string;
-}> | null>;
-/**
- * Get HNSW index status
- */
-export declare function getHNSWStatus(): {
-    available: boolean;
-    initialized: boolean;
-    entryCount: number;
-    dimensions: number;
-};
-/**
- * Clear the HNSW index (for rebuilding)
- */
-export declare function clearHNSWIndex(): void;
-/**
- * Invalidate the in-memory HNSW cache so the next search rebuilds from DB.
- * Call this after deleting entries that had embeddings to prevent ghost
- * vectors from appearing in search results.
- */
-export declare function rebuildSearchIndex(): void;
-/**
- * Quantize a Float32 embedding to Int8 (4x memory reduction)
- * Uses symmetric quantization with scale factor stored per-vector
- *
- * @param embedding - Float32 embedding array
- * @returns Quantized Int8 array with scale factor
- */
-export declare function quantizeInt8(embedding: number[] | Float32Array): {
-    quantized: Int8Array;
-    scale: number;
-    zeroPoint: number;
-};
-/**
- * Dequantize Int8 back to Float32
- *
- * @param quantized - Int8 quantized array
- * @param scale - Scale factor from quantization
- * @param zeroPoint - Zero point (usually 0 for symmetric)
- * @returns Float32Array
- */
-export declare function dequantizeInt8(quantized: Int8Array, scale: number, zeroPoint?: number): Float32Array;
-/**
- * Compute cosine similarity between quantized vectors
- * Faster than dequantizing first
- */
-export declare function quantizedCosineSim(a: Int8Array, aScale: number, b: Int8Array, bScale: number): number;
-/**
- * Get quantization statistics for an embedding
- */
-export declare function getQuantizationStats(embedding: number[] | Float32Array): {
-    originalBytes: number;
-    quantizedBytes: number;
-    compressionRatio: number;
-};
-/**
- * Batch cosine similarity - compute query against multiple vectors
- * Optimized for V8 JIT with typed arrays
- * ~50μs per 1000 vectors (384-dim)
- */
-export declare function batchCosineSim(query: Float32Array | number[], vectors: (Float32Array | number[])[]): Float32Array;
-/**
- * Softmax normalization for attention scores
- * Numerically stable implementation
- */
-export declare function softmaxAttention(scores: Float32Array, temperature?: number): Float32Array;
-/**
- * Top-K selection with partial sort (O(n + k log k))
- * More efficient than full sort for small k
- */
-export declare function topKIndices(scores: Float32Array, k: number): number[];
-/**
- * Flash Attention-style search
- * Combines batch similarity, softmax, and top-k in one pass
- * Returns indices and attention weights
- */
-export declare function flashAttentionSearch(query: Float32Array | number[], vectors: (Float32Array | number[])[], options?: {
-    k?: number;
-    temperature?: number;
-    threshold?: number;
-}): {
-    indices: number[];
-    scores: Float32Array;
-    weights: Float32Array;
-};
-/**
- * Initial metadata to insert after schema creation
- */
-export declare function getInitialMetadata(backend: string): string;
-/**
- * Memory initialization result
- */
-export interface MemoryInitResult {
-    success: boolean;
-    /**
-     * #1791.6 — set when an existing database was found and `force` was not
-     * passed. The call is treated as a successful no-op rather than an error.
-     */
-    alreadyExists?: boolean;
-    backend: string;
-    dbPath: string;
-    schemaVersion: string;
-    tablesCreated: string[];
-    indexesCreated: string[];
-    features: {
-        vectorEmbeddings: boolean;
-        patternLearning: boolean;
-        temporalDecay: boolean;
-        hnswIndexing: boolean;
-        migrationTracking: boolean;
-    };
-    /** ADR-053: Controllers activated via ControllerRegistry */
-    controllers?: {
-        activated: string[];
-        failed: string[];
-        initTimeMs: number;
-    };
-    error?: string;
-}
-/**
- * Ensure memory_entries table has all required columns
- * Adds missing columns for older databases (e.g., 'content' column)
- */
-export declare function ensureSchemaColumns(dbPath: string): Promise<{
-    success: boolean;
-    columnsAdded: string[];
-    error?: string;
-}>;
-/**
- * Check for legacy database installations and migrate if needed
- */
-export declare function checkAndMigrateLegacy(options: {
-    dbPath: string;
-    verbose?: boolean;
-}): Promise<{
-    needsMigration: boolean;
-    legacyVersion?: string;
-    legacyEntries?: number;
-    migrated?: boolean;
-    migratedCount?: number;
-}>;
-/**
- * Self-heal an EXISTING memory database that is missing the `vector_indexes`
- * table or per-namespace rows.
- *
- * Why this exists: fresh installs create `vector_indexes` + seed rows, but a
- * DB written by an older CLI or by agentdb directly may have thousands of
- * embedded rows in `memory_entries` and NO `vector_indexes` table at all.
- * Two things break as a result:
- *   1. The statusline's vector count read collapsed to `0` (the count query
- *      referenced the missing table and failed whole — now split, but the
- *      HNSW flag still needs the table).
- *   2. #1941 — `memory_search` routes per namespace via `vector_indexes`; a
- *      namespace with no row returns 0 results even when entries exist.
- *
- * This is idempotent and conservative:
- *   - Does NOTHING (no writes) when the table already exists and every embedded
- *     namespace already has a row — the common already-healed path, hit on
- *     every MCP start, must not write to the live DB unnecessarily.
- *   - Before ANY write, runs `PRAGMA quick_check`; if the DB reports structural
- *     corruption it SKIPS the repair entirely (returns `corrupt:true`) rather
- *     than writing into a malformed btree and risking making it worse. The
- *     caller/user should recover via `sqlite3 old.db .recover | sqlite3 new.db`.
- *   - Does NOT checkpoint. mode=ro readers already see committed WAL frames, and
- *     forcing a checkpoint on a DB with a torn WAL could persist latent damage.
- *
- * When a repair IS needed and the DB is healthy: creates the table if absent,
- * seeds the fresh-install default rows, and backfills an accurate
- * `total_vectors` per namespace. Runs on the existing-DB path of
- * `initializeMemoryDatabase` (MCP start / `memory init`) and from `ruflo init`.
- *
- * Uses better-sqlite3 (WAL-safe, native). If the native module is unavailable
- * it is a silent no-op — the split statusline query already prevents the count
- * from zeroing; only the HNSW flag and namespace routing stay degraded.
- */
-/**
- * Auto-recover a structurally-corrupt memory DB into a clean one, universally
- * (better-sqlite3 only — no dependency on the external `sqlite3` CLI, which is
- * absent on many npx hosts). Safe by construction:
- *   1. Confirms corruption (quick_check) — no-op on a healthy DB.
- *   2. Acquires an EXCLUSIVE lock (BEGIN IMMEDIATE). If another process is
- *      writing, it SKIPS (returns reason:'writer-active') rather than racing a
- *      writer and losing its in-flight writes — the mistake that must not recur.
- *   3. Rebuilds a fresh DB table-by-table (schema + rows), skipping any single
- *      table whose pages won't scan so one bad table can't abort the whole
- *      rebuild.
- *   4. VERIFIES the rebuild (integrity_check == ok AND recovered
- *      memory_entries count >= the readable source count) BEFORE touching the
- *      original.
- *   5. Backs up the corrupt DB to `<db>.corrupt-<ts>.bak`, then atomically
- *      renames the verified rebuild into place and drops stale -wal/-shm.
- * On any failure the original + backup are left intact — never destructive.
- */
-export declare function recoverMemoryDatabase(dbPath: string, opts?: {
-    verbose?: boolean;
-}): Promise<{
-    recovered: boolean;
-    backupPath?: string;
-    rows?: number;
-    reason?: string;
-    restoredFromBackup?: boolean;
-    from?: string;
-    restoreReason?: string;
-}>;
-export declare function repairVectorIndexes(dbPath: string, opts?: {
-    verbose?: boolean;
-    autoRecover?: boolean;
-}): Promise<{
-    repaired: boolean;
-    tableCreated: boolean;
-    namespaces: string[];
-    corrupt?: boolean;
-    recovered?: boolean;
-    backupPath?: string;
-}>;
-/**
- * Initialize the memory database properly using sql.js
- */
-export declare function initializeMemoryDatabase(options: {
-    backend?: string;
-    dbPath?: string;
-    force?: boolean;
-    verbose?: boolean;
-    migrate?: boolean;
-}): Promise<MemoryInitResult>;
-/**
- * Check if memory database is properly initialized
- */
-export declare function checkMemoryInitialization(dbPath?: string): Promise<{
-    initialized: boolean;
-    version?: string;
-    backend?: string;
-    features?: {
-        vectorEmbeddings: boolean;
-        patternLearning: boolean;
-        temporalDecay: boolean;
-    };
-    tables?: string[];
-}>;
-/**
- * Apply temporal decay to patterns
- * Reduces confidence of patterns that haven't been used recently
- */
-export declare function applyTemporalDecay(dbPath?: string): Promise<{
-    success: boolean;
-    patternsDecayed: number;
-    error?: string;
-}>;
-/**
- * Lazy load ONNX embedding model
- * Only loads when first embedding is requested
- */
-export declare function loadEmbeddingModel(options?: {
-    modelPath?: string;
-    verbose?: boolean;
-}): Promise<{
-    success: boolean;
-    dimensions: number;
-    modelName: string;
-    loadTime?: number;
-    error?: string;
-}>;
-/**
- * Generate real embedding for text
- * Uses ONNX model if available, falls back to deterministic hash
- *
- * AUDIT #3: the `backend` field is the authoritative signal for whether the
- * returned vector carries real ONNX semantics ('onnx') or the deterministic
- * hash fallback ('mock'). The hash fallback produces inverted/meaningless
- * semantics, so operators MUST be able to tell the two apart even when the
- * `model` string reports a real model name (e.g. the AgentDB bridge always
- * labels its output 'Xenova/all-MiniLM-L6-v2' regardless of whether AgentDB's
- * own embedder is real or stubbed). Set `backend` truthfully by the path that
- * actually produced the vector. Do NOT change the embedding math.
- */
-export declare function generateEmbedding(text: string): Promise<{
-    embedding: number[];
-    dimensions: number;
-    model: string;
-    backend: 'onnx' | 'mock';
-}>;
-/**
- * Generate an embedding using ONLY the local model chain (transformers.js /
- * ruvector ONNX / hash fallback) — never the AgentDB bridge.
- *
- * #2312: this MUST stay bridge-free. `memory-bridge.ts` rescues a degraded
- * agentdb embedder by delegating to this module; if that delegation went
- * through `generateEmbedding` (bridge-first), the call would re-enter the
- * patched `agentdb.embedder.embed` and recurse unboundedly:
- *
- *   generateEmbedding → bridgeGenerateEmbedding → embedder.embed (patched)
- *     → generateEmbedding → … (heap OOM at ~4 GB on CI, no stack overflow
- *     because the cycle is async/microtask-driven)
- *
- * Keeping the local chain as its own export breaks that cycle structurally.
- */
-export declare function generateLocalEmbedding(text: string): Promise<{
-    embedding: number[];
-    dimensions: number;
-    model: string;
-    backend: 'onnx' | 'mock';
-}>;
-/**
- * Generate embeddings for multiple texts
- * Uses parallel execution for API-based providers (2-4x faster)
- * Note: Local ONNX inference is CPU-bound, so parallelism has limited benefit
- *
- * @param texts - Array of texts to embed
- * @param options - Batch options
- * @returns Array of embedding results with timing info
- */
-export declare function generateBatchEmbeddings(texts: string[], options?: {
-    concurrency?: number;
-    onProgress?: (completed: number, total: number) => void;
-}): Promise<{
-    results: Array<{
-        text: string;
-        embedding: number[];
-        dimensions: number;
-        model: string;
-    }>;
-    totalTime: number;
-    avgTime: number;
-}>;
-/**
- * Verify memory initialization works correctly
- * Tests: write, read, search, patterns
- */
-export declare function verifyMemoryInit(dbPath: string, options?: {
-    verbose?: boolean;
-}): Promise<{
-    success: boolean;
-    tests: {
-        name: string;
-        passed: boolean;
-        details?: string;
-        duration?: number;
-    }[];
-    summary: {
-        passed: number;
-        failed: number;
-        total: number;
-    };
-}>;
-/**
- * Store an entry directly using sql.js
- * This bypasses MCP and writes directly to the database
- */
-export declare function storeEntry(options: {
-    key: string;
-    value: string;
-    namespace?: string;
-    generateEmbeddingFlag?: boolean;
-    tags?: string[];
-    ttl?: number;
-    dbPath?: string;
-    upsert?: boolean;
-}): Promise<{
-    success: boolean;
-    id: string;
-    embedding?: {
-        dimensions: number;
-        model: string;
-    };
-    error?: string;
-}>;
-/**
- * Search entries using sql.js with vector similarity
- * Uses HNSW index for 150x faster search when available
- */
-export declare function searchEntries(options: {
-    query: string;
-    namespace?: string;
-    limit?: number;
-    threshold?: number;
-    dbPath?: string;
-}): Promise<{
-    success: boolean;
-    results: {
-        id: string;
-        key: string;
-        content: string;
-        score: number;
-        namespace: string;
-    }[];
-    searchTime: number;
-    error?: string;
-}>;
-/**
- * List all entries from the memory database
- */
-export declare function listEntries(options: {
-    namespace?: string;
-    limit?: number;
-    offset?: number;
-    dbPath?: string;
-    /** #2073: When true, include the entry's full `content` string in each result. */
-    includeContent?: boolean;
-}): Promise<{
-    success: boolean;
-    entries: {
-        id: string;
-        key: string;
-        namespace: string;
-        size: number;
-        accessCount: number;
-        createdAt: string;
-        updatedAt: string;
-        hasEmbedding: boolean;
-        /** #2073: Present when `includeContent: true` was requested. */
-        content?: string;
-    }[];
-    total: number;
-    error?: string;
-}>;
-/**
- * Get a specific entry from the memory database
- */
-export declare function getEntry(options: {
-    key: string;
-    namespace?: string;
-    dbPath?: string;
-}): Promise<{
-    success: boolean;
-    found: boolean;
-    entry?: {
-        id: string;
-        key: string;
-        namespace: string;
-        content: string;
-        accessCount: number;
-        createdAt: string;
-        updatedAt: string;
-        hasEmbedding: boolean;
-        tags: string[];
-    };
-    error?: string;
-}>;
-/**
- * Delete a memory entry by key and namespace
- * Issue #980: Properly supports namespaced entries
- */
-export declare function deleteEntry(options: {
-    key: string;
-    namespace?: string;
-    dbPath?: string;
-}): Promise<{
-    success: boolean;
-    deleted: boolean;
-    key: string;
-    namespace: string;
-    remainingEntries: number;
-    error?: string;
-}>;
-/**
- * Advisory O_EXCL lock scoped to a single memory.db file (`<dbPath>.lock`),
- * same stale-takeover pattern as services/global-ai-budget.ts. Only
- * meaningful between callers that opt into it (purgeNamespace does); it
- * cannot coordinate against writers that don't call this helper.
- */
-export declare function withMemoryDbLock<T>(dbPath: string, fn: () => Promise<T> | T): Promise<T>;
-export declare function purgeNamespace(options: {
-    namespace: string;
-    dbPath?: string;
-}): Promise<{
-    success: boolean;
-    deletedCount: number;
-    remainingEntries: number;
-    error?: string;
-}>;
-declare const _default: {
-    initializeMemoryDatabase: typeof initializeMemoryDatabase;
-    checkMemoryInitialization: typeof checkMemoryInitialization;
-    checkAndMigrateLegacy: typeof checkAndMigrateLegacy;
-    ensureSchemaColumns: typeof ensureSchemaColumns;
-    applyTemporalDecay: typeof applyTemporalDecay;
-    loadEmbeddingModel: typeof loadEmbeddingModel;
-    generateEmbedding: typeof generateEmbedding;
-    verifyMemoryInit: typeof verifyMemoryInit;
-    storeEntry: typeof storeEntry;
-    searchEntries: typeof searchEntries;
-    listEntries: typeof listEntries;
-    getEntry: typeof getEntry;
-    deleteEntry: typeof deleteEntry;
-    purgeNamespace: typeof purgeNamespace;
-    withMemoryDbLock: typeof withMemoryDbLock;
-    rebuildSearchIndex: typeof rebuildSearchIndex;
-    MEMORY_SCHEMA_V3: string;
-    getInitialMetadata: typeof getInitialMetadata;
-};
-export default _default;
-//# sourceMappingURL=memory-initializer.d.ts.map