@dungle-scrubs/hippo 0.1.0

package/dist/server/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Server configuration — resolved from environment variables.
+ *
+ * All config comes from env vars. No config files. The server
+ * needs: a database path, embedding API credentials, and LLM
+ * API credentials.
+ */
+import type { EmbeddingProviderConfig } from "../providers/embedding.js";
+import type { LlmProviderConfig } from "../providers/llm.js";
+/** Fully resolved server configuration. */
+export interface ServerConfig {
+    readonly db: string;
+    readonly embedding: EmbeddingProviderConfig;
+    readonly llm: LlmProviderConfig;
+    readonly port: number;
+    readonly transport: "http" | "stdio";
+}
+/**
+ * Resolve server configuration from environment variables.
+ *
+ * Required:
+ *   HIPPO_DB          — SQLite database path
+ *   HIPPO_EMBED_KEY   — Embedding API key
+ *   HIPPO_LLM_KEY     — LLM API key
+ *
+ * Optional:
+ *   HIPPO_TRANSPORT        — "http" (default) or "stdio"
+ *   HIPPO_PORT             — HTTP port (default: 3100)
+ *   HIPPO_EMBED_URL        — Embedding base URL (default: https://api.openai.com/v1)
+ *   HIPPO_EMBED_MODEL      — Embedding model (default: text-embedding-3-small)
+ *   HIPPO_EMBED_DIMENSIONS — Embedding dimensions (optional)
+ *   HIPPO_LLM_URL          — LLM base URL (default: https://openrouter.ai/api/v1)
+ *   HIPPO_LLM_MODEL        — LLM model (default: google/gemini-flash-2.0)
+ *
+ * @returns Resolved ServerConfig
+ */
+export declare function resolveConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/server/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAoB5C"}

package/dist/server/config.js

@@ -0,0 +1,71 @@
+/**
+ * Server configuration — resolved from environment variables.
+ *
+ * All config comes from env vars. No config files. The server
+ * needs: a database path, embedding API credentials, and LLM
+ * API credentials.
+ */
+/**
+ * Read a required environment variable, throwing if missing.
+ *
+ * @param key - Environment variable name
+ * @returns The value
+ * @throws Error if the variable is not set
+ */
+function required(key) {
+    const value = process.env[key];
+    if (!value) {
+        throw new Error(`Missing required environment variable: ${key}`);
+    }
+    return value;
+}
+/**
+ * Read an optional environment variable with a default.
+ *
+ * @param key - Environment variable name
+ * @param fallback - Default value if not set
+ * @returns The value or default
+ */
+function optional(key, fallback) {
+    return process.env[key] ?? fallback;
+}
+/**
+ * Resolve server configuration from environment variables.
+ *
+ * Required:
+ *   HIPPO_DB          — SQLite database path
+ *   HIPPO_EMBED_KEY   — Embedding API key
+ *   HIPPO_LLM_KEY     — LLM API key
+ *
+ * Optional:
+ *   HIPPO_TRANSPORT        — "http" (default) or "stdio"
+ *   HIPPO_PORT             — HTTP port (default: 3100)
+ *   HIPPO_EMBED_URL        — Embedding base URL (default: https://api.openai.com/v1)
+ *   HIPPO_EMBED_MODEL      — Embedding model (default: text-embedding-3-small)
+ *   HIPPO_EMBED_DIMENSIONS — Embedding dimensions (optional)
+ *   HIPPO_LLM_URL          — LLM base URL (default: https://openrouter.ai/api/v1)
+ *   HIPPO_LLM_MODEL        — LLM model (default: google/gemini-flash-2.0)
+ *
+ * @returns Resolved ServerConfig
+ */
+export function resolveConfig() {
+    const transport = optional("HIPPO_TRANSPORT", "http");
+    const dimensionsStr = process.env.HIPPO_EMBED_DIMENSIONS;
+    return {
+        db: required("HIPPO_DB"),
+        embedding: {
+            apiKey: required("HIPPO_EMBED_KEY"),
+            baseUrl: optional("HIPPO_EMBED_URL", "https://api.openai.com/v1"),
+            dimensions: dimensionsStr ? Number.parseInt(dimensionsStr, 10) : undefined,
+            model: optional("HIPPO_EMBED_MODEL", "text-embedding-3-small"),
+        },
+        llm: {
+            apiKey: required("HIPPO_LLM_KEY"),
+            baseUrl: optional("HIPPO_LLM_URL", "https://openrouter.ai/api/v1"),
+            model: optional("HIPPO_LLM_MODEL", "google/gemini-flash-2.0"),
+        },
+        port: Number.parseInt(optional("HIPPO_PORT", "3100"), 10),
+        transport,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/server/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,GAAW,EAAE,QAAgB;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAqB,CAAC;IAC1E,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAEzD,OAAO;QACN,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC;QACxB,SAAS,EAAE;YACV,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC;YACnC,OAAO,EAAE,QAAQ,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;YACjE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAC1E,KAAK,EAAE,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,CAAC;SAC9D;QACD,GAAG,EAAE;YACJ,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC;YACjC,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC;YAClE,KAAK,EAAE,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;SAC7D;QACD,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QACzD,SAAS;KACT,CAAC;AACH,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Hippo MCP server — exposes memory tools over MCP protocol.
+ *
+ * Supports HTTP/SSE (multi-client) and STDIO (single-client) transports.
+ * Embedding and LLM are configured via environment variables — consumers
+ * send text, hippo handles vectorization and extraction.
+ *
+ * Every tool call includes an `agent_id` parameter for multi-agent
+ * support on a shared database.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/server/index.js

@@ -0,0 +1,372 @@
+#!/usr/bin/env node
+/**
+ * Hippo MCP server — exposes memory tools over MCP protocol.
+ *
+ * Supports HTTP/SSE (multi-client) and STDIO (single-client) transports.
+ * Embedding and LLM are configured via environment variables — consumers
+ * send text, hippo handles vectorization and extraction.
+ *
+ * Every tool call includes an `agent_id` parameter for multi-agent
+ * support on a shared database.
+ */
+import { createServer } from "node:http";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import Database from "better-sqlite3";
+import { z } from "zod";
+import { prepareStatements } from "../db.js";
+import { classifyConflict, extractFacts } from "../extractor.js";
+import { contentHash } from "../hash.js";
+import { createEmbeddingProvider } from "../providers/embedding.js";
+import { createLlmProvider } from "../providers/llm.js";
+import { initSchema, verifyEmbeddingModel } from "../schema.js";
+import { chunkEmbedding, cosineSimilarity, embeddingToBuffer } from "../similarity.js";
+import { effectiveStrength, recencyScore, retrievalBoost, STRENGTH_FLOOR, searchScore, } from "../strength.js";
+import { ulid } from "../ulid.js";
+import { resolveConfig } from "./config.js";
+// ── Setup ────────────────────────────────────────────────────────────
+const config = resolveConfig();
+const db = new Database(config.db);
+initSchema(db);
+verifyEmbeddingModel(db, config.embedding.model);
+const stmts = prepareStatements(db);
+const embed = createEmbeddingProvider(config.embedding);
+const llm = createLlmProvider(config.llm);
+const mcp = new McpServer({
+    name: "hippo",
+    version: "0.1.0", // x-release-please-version
+});
+// ── Tool: remember_facts ─────────────────────────────────────────────
+mcp.tool("remember_facts", "Extract and store facts from text. Handles conflict resolution: duplicates strengthen, superseding facts replace old ones.", {
+    agent_id: z.string().describe("Agent namespace for memory isolation"),
+    text: z.string().max(10_000).describe("Text containing facts to extract and remember"),
+}, async ({ agent_id, text }) => {
+    const facts = await extractFacts(text, llm);
+    if (facts.length === 0) {
+        return { content: [{ type: "text", text: "No facts extracted." }] };
+    }
+    const results = [];
+    for (const { fact, intensity } of facts) {
+        const embedding = await embed(fact);
+        const embeddingBuf = embeddingToBuffer(embedding);
+        const now = new Date().toISOString();
+        // Find similar existing facts
+        const existing = stmts.getActiveChunksByAgent.all(agent_id, "fact", 200);
+        let bestSim = 0;
+        let bestChunk = null;
+        for (const chunk of existing) {
+            const sim = cosineSimilarity(embedding, chunkEmbedding(chunk));
+            if (sim > bestSim) {
+                bestSim = sim;
+                bestChunk = chunk;
+            }
+        }
+        if (bestSim > 0.93 && bestChunk) {
+            // Auto-DUPLICATE
+            const newIntensity = (bestChunk.running_intensity * bestChunk.encounter_count + intensity) /
+                (bestChunk.encounter_count + 1);
+            stmts.reinforceChunk.run({
+                id: bestChunk.id,
+                last_accessed_at: now,
+                running_intensity: newIntensity,
+            });
+            results.push(`reinforced: "${fact}"`);
+        }
+        else if (bestSim >= 0.78 && bestChunk) {
+            // LLM tiebreaker
+            const classification = await classifyConflict(fact, bestChunk.content, llm);
+            if (classification === "DUPLICATE") {
+                const newIntensity = (bestChunk.running_intensity * bestChunk.encounter_count + intensity) /
+                    (bestChunk.encounter_count + 1);
+                stmts.reinforceChunk.run({
+                    id: bestChunk.id,
+                    last_accessed_at: now,
+                    running_intensity: newIntensity,
+                });
+                results.push(`reinforced: "${fact}"`);
+            }
+            else if (classification === "SUPERSEDES") {
+                const newId = ulid();
+                db.transaction(() => {
+                    stmts.insertChunk.run({
+                        access_count: 0,
+                        agent_id,
+                        content: fact,
+                        content_hash: null,
+                        created_at: now,
+                        embedding: embeddingBuf,
+                        encounter_count: 1,
+                        id: newId,
+                        kind: "fact",
+                        last_accessed_at: now,
+                        metadata: null,
+                        running_intensity: intensity,
+                        superseded_by: null,
+                    });
+                    stmts.supersedeChunk.run(newId, bestChunk.id);
+                })();
+                results.push(`superseded: "${fact}" (replaced "${bestChunk.content}")`);
+            }
+            else {
+                // DISTINCT
+                stmts.insertChunk.run({
+                    access_count: 0,
+                    agent_id,
+                    content: fact,
+                    content_hash: null,
+                    created_at: now,
+                    embedding: embeddingBuf,
+                    encounter_count: 1,
+                    id: ulid(),
+                    kind: "fact",
+                    last_accessed_at: now,
+                    metadata: null,
+                    running_intensity: intensity,
+                    superseded_by: null,
+                });
+                results.push(`new: "${fact}"`);
+            }
+        }
+        else {
+            // NEW
+            stmts.insertChunk.run({
+                access_count: 0,
+                agent_id,
+                content: fact,
+                content_hash: null,
+                created_at: now,
+                embedding: embeddingBuf,
+                encounter_count: 1,
+                id: ulid(),
+                kind: "fact",
+                last_accessed_at: now,
+                metadata: null,
+                running_intensity: intensity,
+                superseded_by: null,
+            });
+            results.push(`new: "${fact}"`);
+        }
+    }
+    return { content: [{ type: "text", text: results.join("\n") }] };
+});
+// ── Tool: store_memory ───────────────────────────────────────────────
+mcp.tool("store_memory", "Store raw content as a memory chunk. Deduplicates by content hash — storing the same text twice strengthens the existing memory instead of creating a duplicate.", {
+    agent_id: z.string().describe("Agent namespace for memory isolation"),
+    content: z.string().max(50_000).describe("Content to store as a memory"),
+    metadata: z.string().optional().describe("Optional JSON metadata"),
+}, async ({ agent_id, content, metadata }) => {
+    const hash = contentHash(content);
+    const now = new Date().toISOString();
+    // Check for duplicate
+    const existing = stmts.getMemoryByHash.get(agent_id, hash);
+    if (existing) {
+        const boosted = retrievalBoost(existing.running_intensity);
+        stmts.reinforceChunk.run({
+            id: existing.id,
+            last_accessed_at: now,
+            running_intensity: boosted,
+        });
+        return {
+            content: [{ type: "text", text: `Memory already exists (strengthened): ${existing.id}` }],
+        };
+    }
+    const embedding = await embed(content);
+    const id = ulid();
+    stmts.insertChunk.run({
+        access_count: 0,
+        agent_id,
+        content,
+        content_hash: hash,
+        created_at: now,
+        embedding: embeddingToBuffer(embedding),
+        encounter_count: 1,
+        id,
+        kind: "memory",
+        last_accessed_at: now,
+        metadata: metadata ?? null,
+        running_intensity: 0.5,
+        superseded_by: null,
+    });
+    return { content: [{ type: "text", text: `Stored memory: ${id}` }] };
+});
+// ── Tool: recall_memories ────────────────────────────────────────────
+mcp.tool("recall_memories", "Semantic search over stored facts and memories. Returns results ranked by relevance, strength, and recency.", {
+    agent_id: z.string().describe("Agent namespace for memory isolation"),
+    limit: z.number().min(1).max(50).default(10).describe("Max results to return"),
+    query: z.string().describe("What to search for in memory"),
+}, async ({ agent_id, limit, query }) => {
+    const queryEmbedding = await embed(query);
+    const now = new Date();
+    const allChunks = stmts.getAllActiveChunksByAgent.all(agent_id, 10_000);
+    const scored = [];
+    for (const chunk of allChunks) {
+        const similarity = cosineSimilarity(queryEmbedding, chunkEmbedding(chunk));
+        if (similarity < 0.1)
+            continue;
+        const hoursSince = (now.getTime() - new Date(chunk.last_accessed_at).getTime()) / (1000 * 60 * 60);
+        const strength = effectiveStrength(chunk.running_intensity, chunk.access_count, hoursSince);
+        if (strength < STRENGTH_FLOOR)
+            continue;
+        const daysSince = (now.getTime() - new Date(chunk.created_at).getTime()) / (1000 * 60 * 60 * 24);
+        const recency = recencyScore(daysSince);
+        scored.push({ chunk, score: searchScore(similarity, strength, recency) });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    const top = scored.slice(0, limit);
+    // Retrieval boost
+    for (const { chunk } of top) {
+        try {
+            stmts.touchChunk.run({
+                id: chunk.id,
+                last_accessed_at: now.toISOString(),
+                running_intensity: retrievalBoost(chunk.running_intensity),
+            });
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    if (top.length === 0) {
+        return { content: [{ type: "text", text: "No memories found." }] };
+    }
+    const lines = top.map((r, i) => `${i + 1}. [${r.chunk.kind}] (score: ${r.score.toFixed(3)}) ${r.chunk.content}`);
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+});
+// ── Tool: forget_memory ──────────────────────────────────────────────
+mcp.tool("forget_memory", "Forget memories matching a description. Embeds the description, finds semantically similar chunks, and hard-deletes them.", {
+    agent_id: z.string().describe("Agent namespace for memory isolation"),
+    description: z.string().describe("Description of what to forget"),
+    threshold: z.number().min(0).max(1).default(0.7).describe("Minimum similarity to delete"),
+}, async ({ agent_id, description, threshold }) => {
+    const queryEmbedding = await embed(description);
+    const allChunks = stmts.getAllActiveChunksByAgent.all(agent_id, 10_000);
+    const toDelete = [];
+    for (const chunk of allChunks) {
+        const sim = cosineSimilarity(queryEmbedding, chunkEmbedding(chunk));
+        if (sim >= threshold) {
+            toDelete.push(chunk);
+        }
+    }
+    if (toDelete.length === 0) {
+        return { content: [{ type: "text", text: "No matching memories found to forget." }] };
+    }
+    db.transaction(() => {
+        for (const chunk of toDelete) {
+            stmts.clearSupersededBy.run(chunk.id, agent_id);
+            stmts.deleteChunk.run(chunk.id);
+        }
+    })();
+    const lines = toDelete.map((c) => `- [${c.kind}] ${c.content}`);
+    return {
+        content: [
+            { type: "text", text: `Forgot ${toDelete.length} memory(s):\n${lines.join("\n")}` },
+        ],
+    };
+});
+// ── Tool: recall_memory_block ────────────────────────────────────────
+mcp.tool("recall_memory_block", "Read the contents of a named memory block (key-value text buffer like persona, objectives, etc.).", {
+    agent_id: z.string().describe("Agent namespace"),
+    key: z.string().describe("Block key (e.g. persona, objectives)"),
+}, async ({ agent_id, key }) => {
+    const row = stmts.getBlockByKey.get(agent_id, key);
+    if (!row) {
+        return { content: [{ type: "text", text: `Block "${key}" not found.` }] };
+    }
+    return { content: [{ type: "text", text: row.value }] };
+});
+// ── Tool: replace_memory_block ───────────────────────────────────────
+mcp.tool("replace_memory_block", "Find and replace text within a named memory block. Returns error if block doesn't exist or text not found.", {
+    agent_id: z.string().describe("Agent namespace"),
+    key: z.string().describe("Block key"),
+    new_text: z.string().describe("Replacement text"),
+    old_text: z.string().min(1).describe("Text to find"),
+}, async ({ agent_id, key, new_text, old_text }) => {
+    const row = stmts.getBlockByKey.get(agent_id, key);
+    if (!row) {
+        return {
+            content: [{ type: "text", text: `Block "${key}" not found.` }],
+            isError: true,
+        };
+    }
+    if (!row.value.includes(old_text)) {
+        return {
+            content: [{ type: "text", text: `Text not found in block "${key}".` }],
+            isError: true,
+        };
+    }
+    const updated = row.value.replace(old_text, new_text);
+    stmts.upsertBlock.run({ agent_id, key, updated_at: new Date().toISOString(), value: updated });
+    return { content: [{ type: "text", text: `Updated block "${key}".` }] };
+});
+// ── Tool: append_memory_block ────────────────────────────────────────
+mcp.tool("append_memory_block", "Append text to a named memory block. Creates the block if it doesn't exist.", {
+    agent_id: z.string().describe("Agent namespace"),
+    content: z.string().describe("Text to append"),
+    key: z.string().describe("Block key"),
+}, async ({ agent_id, content, key }) => {
+    const row = stmts.getBlockByKey.get(agent_id, key);
+    const newValue = row ? row.value + content : content;
+    stmts.upsertBlock.run({
+        agent_id,
+        key,
+        updated_at: new Date().toISOString(),
+        value: newValue,
+    });
+    const sizeBytes = new TextEncoder().encode(newValue).byteLength;
+    let msg = `Appended to block "${key}" (${sizeBytes} bytes).`;
+    if (sizeBytes > 100_000) {
+        msg += " Warning: block exceeds 100KB.";
+    }
+    return { content: [{ type: "text", text: msg }] };
+});
+// ── Transport ────────────────────────────────────────────────────────
+if (config.transport === "stdio") {
+    const transport = new StdioServerTransport();
+    await mcp.connect(transport);
+    console.error("Hippo MCP server running on stdio");
+}
+else {
+    const transports = new Map();
+    const httpServer = createServer(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+        // Health check
+        if (url.pathname === "/health") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok" }));
+            return;
+        }
+        // SSE endpoint — new connections
+        if (url.pathname === "/sse" && req.method === "GET") {
+            const transport = new SSEServerTransport("/messages", res);
+            transports.set(transport.sessionId, transport);
+            transport.onclose = () => {
+                transports.delete(transport.sessionId);
+            };
+            await mcp.connect(transport);
+            return;
+        }
+        // Message endpoint — client POSTs to this
+        if (url.pathname === "/messages" && req.method === "POST") {
+            const sessionId = url.searchParams.get("sessionId");
+            if (!sessionId || !transports.has(sessionId)) {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Invalid or missing sessionId" }));
+                return;
+            }
+            // biome-ignore lint/style/noNonNullAssertion: checked in the guard above
+            const transport = transports.get(sessionId);
+            await transport.handlePostMessage(req, res);
+            return;
+        }
+        res.writeHead(404);
+        res.end("Not found");
+    });
+    httpServer.listen(config.port, () => {
+        console.error(`Hippo MCP server listening on http://localhost:${config.port}`);
+        console.error(`  SSE endpoint: GET  /sse`);
+        console.error(`  Messages:     POST /messages?sessionId=<id>`);
+        console.error(`  Health:       GET  /health`);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

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

package/dist/similarity.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Compute cosine similarity between two Float32Array embeddings.
+ *
+ * @param a - First embedding vector
+ * @param b - Second embedding vector
+ * @returns Cosine similarity in range [-1, 1]
+ * @throws If vectors have different lengths or are zero-length
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/**
+ * Deserialize embedding BLOB from SQLite into Float32Array.
+ *
+ * Copies through Uint8Array to guarantee 4-byte alignment.
+ * better-sqlite3 typically returns offset-0 Buffers, but the spec
+ * doesn't guarantee it and Float32Array requires aligned access.
+ *
+ * @param buf - Buffer containing raw float32 bytes
+ * @returns Float32Array embedding
+ */
+export declare function bufferToEmbedding(buf: Buffer): Float32Array;
+/**
+ * Serialize Float32Array to Buffer for SQLite BLOB storage.
+ *
+ * Creates a copy so the returned Buffer is independent of the source array.
+ *
+ * @param embedding - Float32Array embedding
+ * @returns Buffer for BLOB column
+ */
+export declare function embeddingToBuffer(embedding: Float32Array): Buffer;
+/**
+ * Extract and deserialize a chunk's embedding BLOB into Float32Array.
+ *
+ * Centralizes the Buffer cast from better-sqlite3's runtime type.
+ *
+ * @param chunk - A chunk row from SQLite
+ * @returns Float32Array embedding
+ */
+export declare function chunkEmbedding(chunk: {
+    readonly embedding: Buffer;
+}): Float32Array;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CA4BzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAK3D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAElF"}

package/dist/similarity.js

@@ -0,0 +1,70 @@
+/**
+ * Compute cosine similarity between two Float32Array embeddings.
+ *
+ * @param a - First embedding vector
+ * @param b - Second embedding vector
+ * @returns Cosine similarity in range [-1, 1]
+ * @throws If vectors have different lengths or are zero-length
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector length mismatch: ${a.length} vs ${b.length}`);
+    }
+    if (a.length === 0) {
+        throw new Error("Cannot compute cosine similarity of zero-length vectors");
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        // biome-ignore lint/style/noNonNullAssertion: loop bounded by length
+        const ai = a[i];
+        // biome-ignore lint/style/noNonNullAssertion: loop bounded by length
+        const bi = b[i];
+        dot += ai * bi;
+        normA += ai * ai;
+        normB += bi * bi;
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom === 0) {
+        return 0;
+    }
+    return dot / denom;
+}
+/**
+ * Deserialize embedding BLOB from SQLite into Float32Array.
+ *
+ * Copies through Uint8Array to guarantee 4-byte alignment.
+ * better-sqlite3 typically returns offset-0 Buffers, but the spec
+ * doesn't guarantee it and Float32Array requires aligned access.
+ *
+ * @param buf - Buffer containing raw float32 bytes
+ * @returns Float32Array embedding
+ */
+export function bufferToEmbedding(buf) {
+    const bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    return new Float32Array(bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength));
+}
+/**
+ * Serialize Float32Array to Buffer for SQLite BLOB storage.
+ *
+ * Creates a copy so the returned Buffer is independent of the source array.
+ *
+ * @param embedding - Float32Array embedding
+ * @returns Buffer for BLOB column
+ */
+export function embeddingToBuffer(embedding) {
+    return Buffer.copyBytesFrom(embedding);
+}
+/**
+ * Extract and deserialize a chunk's embedding BLOB into Float32Array.
+ *
+ * Centralizes the Buffer cast from better-sqlite3's runtime type.
+ *
+ * @param chunk - A chunk row from SQLite
+ * @returns Float32Array embedding
+ */
+export function chunkEmbedding(chunk) {
+    return bufferToEmbedding(chunk.embedding);
+}
+//# sourceMappingURL=similarity.js.map

package/dist/similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.js","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAChE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,qEAAqE;QACrE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACjB,qEAAqE;QACrE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACjB,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;QACf,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;QACjB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACV,CAAC;IAED,OAAO,GAAG,GAAG,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC5C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACzE,OAAO,IAAI,YAAY,CACtB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CACzE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAuB;IACxD,OAAO,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqC;IACnE,OAAO,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC"}