@synthaer/resonance 0.1.0

package/dist/ratification.js

@@ -0,0 +1,315 @@
+/**
+ * Ratification Flow — wires PKI signing into the DIKW pipeline.
+ *
+ * Flow:
+ *   1. Agent writes knowledge/experience locally (stored immediately)
+ *   2. Content signed by agent cert + local identity cert (dual signatures)
+ *   3. Async message queued to Resonance Cloud with both signatures
+ *   4. Cloud verifies the chain (agent -> local -> Synthaer CA -> Root)
+ *   5. Cloud system-signs with the appropriate CI signer
+ *   6. Cloud stores both signatures on the entry
+ *   7. SSE notification sent back with cloud ratification signature
+ *   8. Local updates its record — entry is now "ratified"
+ */
+import crypto from 'node:crypto';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { signContent } from './pki.js';
+const OPERATION_SIGNER_MAP = {
+    store_knowledge: { signer: 'ingestion', layerCode: '3D' },
+    store_experience: { signer: 'ingestion', layerCode: '3D' },
+    corroborate: { signer: 'corroboration', layerCode: '3F' },
+    endorse: { signer: 'endorsement', layerCode: '3G' },
+    challenge: { signer: 'challenge', layerCode: '3H' },
+    generate_embedding: { signer: 'embedding', layerCode: '3K' },
+    update_trust: { signer: 'trust-graph', layerCode: '3L' },
+    event_record: { signer: 'event-audit', layerCode: '3M' },
+    memory_checkpoint: { signer: 'session', layerCode: '3N' },
+    context_pack_build: { signer: 'context-pack', layerCode: '3O' },
+    batch_store_knowledge: { signer: 'ingestion', layerCode: '3D' },
+    batch_store_experiences: { signer: 'ingestion', layerCode: '3D' },
+    update_knowledge: { signer: 'ingestion', layerCode: '3D' },
+    update_experience: { signer: 'ingestion', layerCode: '3D' },
+    delete_knowledge: { signer: 'ingestion', layerCode: '3D' },
+    delete_experience: { signer: 'ingestion', layerCode: '3D' },
+    // Import operations
+    import_conversation: { signer: 'import', layerCode: '3E' },
+    import_detect_platform: { signer: 'import', layerCode: '3E' },
+    // Lifecycle operations
+    lifecycle_apply_decay: { signer: 'lifecycle', layerCode: '3J' },
+    lifecycle_calculate_strength: { signer: 'lifecycle', layerCode: '3J' },
+    // Session operations
+    session_resume: { signer: 'session', layerCode: '3N' },
+    // Embedding operations
+    process_unembedded_knowledge: { signer: 'embedding', layerCode: '3K' },
+    // Project governance (ACCORD-001)
+    hem_task_create: { signer: 'task-provenance', layerCode: '3R' },
+    hem_task_assign: { signer: 'task-provenance', layerCode: '3R' },
+    hem_task_transition: { signer: 'task-provenance', layerCode: '3R' },
+    hem_task_update: { signer: 'task-provenance', layerCode: '3R' },
+    hem_gate_sign_off: { signer: 'governance', layerCode: '3S' },
+    hem_accord_create: { signer: 'governance', layerCode: '3S' },
+    hem_amendment_create: { signer: 'governance', layerCode: '3S' },
+    hem_rejection_create: { signer: 'governance', layerCode: '3S' },
+    hem_rejection_resolve: { signer: 'governance', layerCode: '3S' },
+    hem_project_advance_foundation: { signer: 'governance', layerCode: '3S' },
+    hem_capability_advance_build: { signer: 'governance', layerCode: '3S' },
+    hem_capability_release: { signer: 'governance', layerCode: '3S' },
+    hem_agent_spawn: { signer: 'agent-lifecycle', layerCode: '3T' },
+    hem_agent_status: { signer: 'agent-lifecycle', layerCode: '3T' },
+    hem_agent_complete: { signer: 'agent-lifecycle', layerCode: '3T' },
+    hem_handoff_create: { signer: 'agent-lifecycle', layerCode: '3T' },
+    hem_handoff_accept: { signer: 'agent-lifecycle', layerCode: '3T' },
+    // Fleet orchestration
+    hem_agent_fleet_health: { signer: 'fleet', layerCode: '3U' },
+    // Ingestion-tier governance (no new signer needed)
+    hem_project_create: { signer: 'ingestion', layerCode: '3D' },
+    hem_project_update_compact: { signer: 'ingestion', layerCode: '3D' },
+    hem_capability_create: { signer: 'ingestion', layerCode: '3D' },
+    hem_estimate_record: { signer: 'ingestion', layerCode: '3D' },
+    hem_estimate_complete: { signer: 'ingestion', layerCode: '3D' },
+    hem_measure_record: { signer: 'ingestion', layerCode: '3D' },
+};
+/**
+ * Map a Resonance MCP operation name to its designated CI signer.
+ * Returns null for operations that do not require ratification.
+ */
+export function mapOperationToSigner(operation) {
+    return OPERATION_SIGNER_MAP[operation] ?? null;
+}
+// ---------------------------------------------------------------------------
+// Payload builder
+// ---------------------------------------------------------------------------
+/**
+ * Build the ratification payload sent to cloud. The content itself is NOT
+ * included — only its SHA-256 hash, plus the dual signatures and certs.
+ */
+export function buildRatificationPayload(operation, content, agentSignature, localSignature, agentCertificate, localCertificate) {
+    const contentHash = crypto.createHash('sha256').update(content, 'utf-8').digest('hex');
+    return {
+        operation,
+        contentHash,
+        agentSignature,
+        localSignature,
+        agentCertificate,
+        localCertificate,
+        timestamp: new Date().toISOString(),
+        nonce: crypto.randomUUID(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Queue persistence
+// ---------------------------------------------------------------------------
+const QUEUE_FILENAME = 'ratification-queue.json';
+async function loadQueueFromDisk(dataDir) {
+    const filePath = join(dataDir, QUEUE_FILENAME);
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+async function saveQueueToDisk(dataDir, queue) {
+    const filePath = join(dataDir, QUEUE_FILENAME);
+    await mkdir(dataDir, { recursive: true });
+    await writeFile(filePath, JSON.stringify(queue, null, 2), { mode: 0o600 });
+}
+// ---------------------------------------------------------------------------
+// RatificationManager
+// ---------------------------------------------------------------------------
+export class RatificationManager {
+    queue = [];
+    loaded = false;
+    config;
+    localIdentity;
+    cloudBaseUrl;
+    authToken;
+    maxRetries;
+    baseRetryDelayMs;
+    constructor(options) {
+        this.config = options.config;
+        this.localIdentity = options.localIdentity;
+        this.cloudBaseUrl = options.cloudBaseUrl.replace(/\/+$/, '');
+        this.authToken = options.authToken;
+        this.maxRetries = options.maxRetries ?? 5;
+        this.baseRetryDelayMs = options.baseRetryDelayMs ?? 1000;
+    }
+    /**
+     * Load persisted queue from disk. Safe to call multiple times.
+     */
+    async loadQueue() {
+        if (this.loaded)
+            return;
+        this.queue = await loadQueueFromDisk(this.config.dataDir);
+        this.loaded = true;
+    }
+    /**
+     * Return a snapshot of the current queue.
+     */
+    getQueue() {
+        return this.queue;
+    }
+    /**
+     * Get a single queue entry by ID.
+     */
+    getEntry(id) {
+        return this.queue.find((e) => e.id === id);
+    }
+    /**
+     * Sign content with both agent and local identity certs, build the
+     * ratification payload, and add it to the queue for async cloud submission.
+     */
+    async signAndQueue(operation, content, agentIdentity, recordId, recordTable) {
+        await this.loadQueue();
+        if (!this.localIdentity.certificate || !this.localIdentity.fingerprint) {
+            throw new Error('Local identity must have a signed certificate before ratification');
+        }
+        const agentSignature = signContent(content, agentIdentity.privateKey, agentIdentity.fingerprint);
+        const localSignature = signContent(content, this.localIdentity.privateKey, this.localIdentity.fingerprint);
+        const payload = buildRatificationPayload(operation, content, agentSignature, localSignature, agentIdentity.certificate, this.localIdentity.certificate);
+        const now = new Date().toISOString();
+        const entry = {
+            id: crypto.randomUUID(),
+            payload,
+            status: 'pending',
+            recordId,
+            recordTable,
+            attempts: 0,
+            lastAttemptAt: null,
+            nextRetryAt: null,
+            cloudSignature: null,
+            createdAt: now,
+            updatedAt: now,
+            errorMessage: null,
+        };
+        this.queue.push(entry);
+        await this.persistQueue();
+        return entry.id;
+    }
+    /**
+     * Process all pending/retryable queue entries by sending them to cloud.
+     * Returns the number of entries that were submitted.
+     */
+    async processQueue() {
+        await this.loadQueue();
+        const now = Date.now();
+        const results = { submitted: 0, ratified: 0, rejected: 0, errors: 0 };
+        for (const entry of this.queue) {
+            if (entry.status === 'ratified' || entry.status === 'rejected')
+                continue;
+            if (entry.attempts >= this.maxRetries)
+                continue;
+            // Check retry delay
+            if (entry.nextRetryAt && new Date(entry.nextRetryAt).getTime() > now)
+                continue;
+            entry.status = 'submitted';
+            entry.attempts += 1;
+            entry.lastAttemptAt = new Date().toISOString();
+            entry.updatedAt = new Date().toISOString();
+            results.submitted += 1;
+            try {
+                const response = await this.submitToCloud(entry);
+                this.applyResponse(entry, response);
+                if (response.status === 'ratified') {
+                    results.ratified += 1;
+                }
+                else {
+                    results.rejected += 1;
+                }
+            }
+            catch (err) {
+                results.errors += 1;
+                entry.errorMessage = err instanceof Error ? err.message : String(err);
+                // Revert to pending for retry
+                entry.status = 'pending';
+                // Exponential backoff: baseDelay * 2^(attempts-1)
+                const delay = this.baseRetryDelayMs * Math.pow(2, entry.attempts - 1);
+                entry.nextRetryAt = new Date(Date.now() + delay).toISOString();
+                entry.updatedAt = new Date().toISOString();
+            }
+        }
+        await this.persistQueue();
+        return results;
+    }
+    /**
+     * Handle a ratification response (e.g., from SSE push or manual poll).
+     * Updates the queue entry and returns whether the entry was found.
+     */
+    handleRatificationResponse(response) {
+        const entry = this.queue.find((e) => e.id === response.entryId);
+        if (!entry)
+            return false;
+        this.applyResponse(entry, response);
+        // Fire-and-forget persist; caller should await persistQueue() if needed
+        void this.persistQueue();
+        return true;
+    }
+    /**
+     * Persist current queue state to disk.
+     */
+    async persistQueue() {
+        await saveQueueToDisk(this.config.dataDir, this.queue);
+    }
+    /**
+     * Get all entries with a given status.
+     */
+    getEntriesByStatus(status) {
+        return this.queue.filter((e) => e.status === status);
+    }
+    /**
+     * Remove completed (ratified/rejected) entries older than the given age.
+     */
+    async pruneCompleted(maxAgeMs) {
+        const cutoff = Date.now() - maxAgeMs;
+        const before = this.queue.length;
+        this.queue = this.queue.filter((e) => {
+            if (e.status !== 'ratified' && e.status !== 'rejected')
+                return true;
+            return new Date(e.updatedAt).getTime() > cutoff;
+        });
+        const removed = before - this.queue.length;
+        if (removed > 0)
+            await this.persistQueue();
+        return removed;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    applyResponse(entry, response) {
+        entry.status = response.status;
+        entry.updatedAt = new Date().toISOString();
+        if (response.status === 'ratified' && response.cloudSignature) {
+            entry.cloudSignature = response.cloudSignature;
+        }
+        if (response.status === 'rejected' && response.reason) {
+            entry.errorMessage = response.reason;
+        }
+    }
+    async submitToCloud(entry) {
+        const signer = mapOperationToSigner(entry.payload.operation);
+        const body = {
+            entryId: entry.id,
+            payload: entry.payload,
+            recordId: entry.recordId,
+            recordTable: entry.recordTable,
+            expectedSigner: signer?.signer ?? null,
+            expectedLayerCode: signer?.layerCode ?? null,
+        };
+        const response = await fetch(`${this.cloudBaseUrl}/api/v1/pki/ratify`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.authToken}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Cloud ratification failed (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=ratification.js.map

package/dist/ratification.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,4 @@
+import type { IAsyncDatabase } from './db-types.js';
+export declare function initializeResonanceSchema(db: IAsyncDatabase): Promise<void>;
+export declare function createVectorIndexes(db: IAsyncDatabase): Promise<void>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAmGpD,wBAAsB,yBAAyB,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3E"}

package/dist/schema.js

@@ -0,0 +1,119 @@
+const SCHEMA_SQL = `
+CREATE EXTENSION IF NOT EXISTS vector;
+
+CREATE TABLE IF NOT EXISTS knowledge (
+  id TEXT PRIMARY KEY,
+  content TEXT NOT NULL,
+  kind INTEGER NOT NULL,
+  dikw_stage TEXT NOT NULL DEFAULT 'nascent',
+  strength REAL NOT NULL DEFAULT 0.5,
+  tags JSONB NOT NULL DEFAULT '[]'::jsonb,
+  source_count INTEGER NOT NULL DEFAULT 1,
+  context_count INTEGER NOT NULL DEFAULT 1,
+  project_id TEXT,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  last_accessed_at TIMESTAMPTZ,
+  decay_rate REAL NOT NULL DEFAULT 0.01,
+  user_id TEXT NOT NULL DEFAULT 'system',
+  local_embedding vector(384),
+  cloud_embedding vector(1536)
+);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_dikw_stage ON knowledge(dikw_stage);
+CREATE INDEX IF NOT EXISTS idx_knowledge_project_id ON knowledge(project_id);
+CREATE INDEX IF NOT EXISTS idx_knowledge_kind ON knowledge(kind);
+CREATE INDEX IF NOT EXISTS idx_knowledge_strength ON knowledge(strength);
+CREATE INDEX IF NOT EXISTS idx_knowledge_updated_at ON knowledge(updated_at);
+CREATE INDEX IF NOT EXISTS idx_knowledge_user_id ON knowledge(user_id);
+
+CREATE TABLE IF NOT EXISTS experiences (
+  id TEXT PRIMARY KEY,
+  agent_id TEXT,
+  session_id TEXT,
+  content TEXT NOT NULL,
+  kind INTEGER NOT NULL,
+  project_id TEXT,
+  related_knowledge_ids JSONB NOT NULL DEFAULT '[]'::jsonb,
+  local_signature JSONB,
+  signer_type TEXT NOT NULL DEFAULT 'human',
+  signer_fingerprint TEXT,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  user_id TEXT NOT NULL DEFAULT 'system',
+  local_embedding vector(384),
+  cloud_embedding vector(1536)
+);
+
+CREATE INDEX IF NOT EXISTS idx_experiences_project_id ON experiences(project_id);
+CREATE INDEX IF NOT EXISTS idx_experiences_kind ON experiences(kind);
+CREATE INDEX IF NOT EXISTS idx_experiences_session_id ON experiences(session_id);
+CREATE INDEX IF NOT EXISTS idx_experiences_created_at ON experiences(created_at);
+CREATE INDEX IF NOT EXISTS idx_experiences_user_id ON experiences(user_id);
+CREATE INDEX IF NOT EXISTS idx_experiences_signer_type ON experiences(signer_type);
+CREATE INDEX IF NOT EXISTS idx_experiences_signer_fingerprint ON experiences(signer_fingerprint);
+
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,
+  agent_id TEXT,
+  project_id TEXT,
+  checkpoint JSONB,
+  memory JSONB NOT NULL DEFAULT '[]'::jsonb,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  user_id TEXT NOT NULL DEFAULT 'system'
+);
+
+CREATE INDEX IF NOT EXISTS idx_sessions_agent_project ON sessions(agent_id, project_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON sessions(user_id);
+
+CREATE TABLE IF NOT EXISTS maturation_log (
+  id SERIAL PRIMARY KEY,
+  knowledge_id TEXT NOT NULL,
+  from_stage TEXT NOT NULL,
+  to_stage TEXT NOT NULL,
+  reason TEXT,
+  triggered_by TEXT,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  user_id TEXT NOT NULL DEFAULT 'system'
+);
+
+CREATE INDEX IF NOT EXISTS idx_maturation_log_knowledge_id ON maturation_log(knowledge_id);
+CREATE INDEX IF NOT EXISTS idx_maturation_log_user_id ON maturation_log(user_id);
+
+CREATE TABLE IF NOT EXISTS memory_events (
+  id SERIAL PRIMARY KEY,
+  event_type TEXT NOT NULL,
+  source_id TEXT,
+  source_type TEXT,
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  user_id TEXT NOT NULL DEFAULT 'system'
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_events_type ON memory_events(event_type);
+CREATE INDEX IF NOT EXISTS idx_memory_events_created_at ON memory_events(created_at);
+CREATE INDEX IF NOT EXISTS idx_memory_events_user_id ON memory_events(user_id);
+`;
+export async function initializeResonanceSchema(db) {
+    await db.exec(SCHEMA_SQL);
+}
+export async function createVectorIndexes(db) {
+    await db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_knowledge_local_embedding
+      ON knowledge USING hnsw (local_embedding vector_cosine_ops)
+      WITH (m = 16, ef_construction = 64);
+
+    CREATE INDEX IF NOT EXISTS idx_knowledge_cloud_embedding
+      ON knowledge USING hnsw (cloud_embedding vector_cosine_ops)
+      WITH (m = 16, ef_construction = 64);
+
+    CREATE INDEX IF NOT EXISTS idx_experiences_local_embedding
+      ON experiences USING hnsw (local_embedding vector_cosine_ops)
+      WITH (m = 16, ef_construction = 64);
+
+    CREATE INDEX IF NOT EXISTS idx_experiences_cloud_embedding
+      ON experiences USING hnsw (cloud_embedding vector_cosine_ops)
+      WITH (m = 16, ef_construction = 64);
+  `);
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FlB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,EAAkB;IAChE,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EAAkB;IAC1D,MAAM,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;GAgBb,CAAC,CAAC;AACL,CAAC"}

package/dist/search.d.ts

@@ -0,0 +1,33 @@
+import type { IAsyncDatabase } from './db-types.js';
+export interface VectorSearchResult {
+    id: string;
+    score: number;
+    source: 'knowledge' | 'experience';
+}
+export declare class TfIdfSearch {
+    protected documents: Map<string, {
+        id: string;
+        source: 'knowledge' | 'experience';
+        terms: string[];
+        termFrequency: Map<string, number>;
+    }>;
+    protected documentFrequency: Map<string, number>;
+    protected totalDocuments: number;
+    search(query: string, limit?: number): VectorSearchResult[];
+    buildIndex(items: Array<{
+        id: string;
+        content: string;
+        source: 'knowledge' | 'experience';
+    }>): void;
+    addToIndex(id: string, content: string, source: 'knowledge' | 'experience'): void;
+    removeFromIndex(id: string): void;
+    protected tokenize(text: string): string[];
+}
+export declare class ResonanceSearch extends TfIdfSearch {
+    private db;
+    setDatabase(db: IAsyncDatabase): void;
+    hybridSearch(queryText: string, limit?: number, queryVector?: number[]): Promise<VectorSearchResult[]>;
+    private vectorSearch;
+    tfidfSearch(query: string, limit?: number): VectorSearchResult[];
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAepD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;CACpC;AAED,qBAAa,WAAW;IACtB,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAa;IACtJ,SAAS,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAC7D,SAAS,CAAC,cAAc,SAAK;IAE7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,kBAAkB,EAAE;IA6BvD,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAA;KAAE,CAAC,GAAG,IAAI;IAUnG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,IAAI;IA0BjF,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAkBjC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;CAM3C;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,OAAO,CAAC,EAAE,CAA+B;IAEzC,WAAW,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAI/B,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAQ1F,YAAY;IAiC1B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,kBAAkB,EAAE;CAG7D"}

package/dist/search.js

@@ -0,0 +1,132 @@
+const STOP_WORDS = new Set([
+    'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'shall',
+    'should', 'may', 'might', 'must', 'can', 'could', 'in', 'on', 'at',
+    'to', 'for', 'of', 'with', 'by', 'from', 'as', 'into', 'through',
+    'during', 'before', 'after', 'above', 'below', 'between', 'out', 'off',
+    'over', 'under', 'again', 'further', 'then', 'once', 'here', 'there',
+    'when', 'where', 'why', 'how', 'all', 'both', 'each', 'few', 'more',
+    'most', 'other', 'some', 'such', 'no', 'nor', 'not', 'only', 'own',
+    'same', 'so', 'than', 'too', 'very', 'just', 'because', 'but', 'and',
+    'or', 'if', 'while', 'this', 'that', 'these', 'those', 'it', 'its',
+]);
+export class TfIdfSearch {
+    documents = new Map();
+    documentFrequency = new Map();
+    totalDocuments = 0;
+    search(query, limit = 20) {
+        const queryTerms = this.tokenize(query);
+        if (queryTerms.length === 0)
+            return [];
+        const scores = [];
+        for (const [, doc] of this.documents) {
+            let score = 0;
+            for (const term of queryTerms) {
+                const tf = doc.termFrequency.get(term) ?? 0;
+                if (tf === 0)
+                    continue;
+                const df = this.documentFrequency.get(term) ?? 0;
+                if (df === 0)
+                    continue;
+                const idf = Math.log(1 + this.totalDocuments / df);
+                score += tf * idf;
+            }
+            if (score > 0) {
+                scores.push({ id: doc.id, score, source: doc.source });
+            }
+        }
+        scores.sort((a, b) => b.score - a.score);
+        return scores.slice(0, limit);
+    }
+    buildIndex(items) {
+        this.documents.clear();
+        this.documentFrequency.clear();
+        this.totalDocuments = 0;
+        for (const item of items) {
+            this.addToIndex(item.id, item.content, item.source);
+        }
+    }
+    addToIndex(id, content, source) {
+        const terms = this.tokenize(content);
+        if (terms.length === 0) {
+            this.documents.set(id, { id, source, terms: [], termFrequency: new Map() });
+            this.totalDocuments++;
+            return;
+        }
+        const termFrequency = new Map();
+        for (const term of terms) {
+            termFrequency.set(term, (termFrequency.get(term) ?? 0) + 1);
+        }
+        for (const [term, count] of termFrequency) {
+            termFrequency.set(term, count / terms.length);
+        }
+        const uniqueTerms = new Set(terms);
+        for (const term of uniqueTerms) {
+            this.documentFrequency.set(term, (this.documentFrequency.get(term) ?? 0) + 1);
+        }
+        this.documents.set(id, { id, source, terms, termFrequency });
+        this.totalDocuments++;
+    }
+    removeFromIndex(id) {
+        const doc = this.documents.get(id);
+        if (!doc)
+            return;
+        const uniqueTerms = new Set(doc.terms);
+        for (const term of uniqueTerms) {
+            const currentDf = this.documentFrequency.get(term) ?? 0;
+            if (currentDf <= 1) {
+                this.documentFrequency.delete(term);
+            }
+            else {
+                this.documentFrequency.set(term, currentDf - 1);
+            }
+        }
+        this.documents.delete(id);
+        this.totalDocuments--;
+    }
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .split(/[^a-z0-9]+/)
+            .filter((token) => token.length > 0 && !STOP_WORDS.has(token));
+    }
+}
+export class ResonanceSearch extends TfIdfSearch {
+    db = null;
+    setDatabase(db) {
+        this.db = db;
+    }
+    async hybridSearch(queryText, limit = 20, queryVector) {
+        if (queryVector && this.db) {
+            return this.vectorSearch(queryVector, limit);
+        }
+        return this.search(queryText, limit);
+    }
+    async vectorSearch(queryVector, limit) {
+        if (!this.db)
+            return [];
+        const vectorStr = `[${queryVector.join(',')}]`;
+        const [knowledgeResults, experienceResults] = await Promise.all([
+            this.db.query(`SELECT id, 1 - (local_embedding <=> $1::vector) as similarity
+         FROM knowledge
+         WHERE local_embedding IS NOT NULL
+         ORDER BY local_embedding <=> $1::vector
+         LIMIT $2`, [vectorStr, limit]),
+            this.db.query(`SELECT id, 1 - (local_embedding <=> $1::vector) as similarity
+         FROM experiences
+         WHERE local_embedding IS NOT NULL
+         ORDER BY local_embedding <=> $1::vector
+         LIMIT $2`, [vectorStr, limit]),
+        ]);
+        const results = [
+            ...knowledgeResults.rows.map((r) => ({ id: r.id, score: r.similarity, source: 'knowledge' })),
+            ...experienceResults.rows.map((r) => ({ id: r.id, score: r.similarity, source: 'experience' })),
+        ];
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    tfidfSearch(query, limit = 20) {
+        return this.search(query, limit);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import type { PGlite } from '@electric-sql/pglite';
+import type { EmbeddingProvider } from './embeddings/local.js';
+import type { ResonanceMode } from './config.js';
+export interface ResonanceServerOptions {
+    db: PGlite;
+    embedder: EmbeddingProvider | null;
+    mode: ResonanceMode;
+    dataDir: string;
+}
+export declare function startServer(options: ResonanceServerOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map