bikky 0.1.0

package/dist/mcp/api.js

@@ -0,0 +1,150 @@
+/**
+ * External API helpers — Qdrant REST client, LLM chat, logging.
+ * Credentials come from config (~/.bikky/config.json) or env vars.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { embed, getEmbeddingDimensions, getEmbeddingConfig, initEmbedding, chatCompletion, initLLM } from "../llm/index.js";
+export { embed, getEmbeddingDimensions, getEmbeddingConfig, initEmbedding };
+import { createLogger } from "../logger.js";
+import { BIKKY_DIR, LOG_DIR, loadConfig } from "../config.js";
+// ---------------------------------------------------------------------------
+// Config
+// ---------------------------------------------------------------------------
+export const MEMORY_DIR = BIKKY_DIR;
+let collectionName = "bikky";
+export function getCollection() { return collectionName; }
+export function setCollection(name) { collectionName = name; }
+fs.mkdirSync(MEMORY_DIR, { recursive: true });
+fs.mkdirSync(LOG_DIR, { recursive: true });
+let llmInitialized = false;
+// ---------------------------------------------------------------------------
+// Runtime state — populated at startup
+// ---------------------------------------------------------------------------
+export let qdrantUrl = null;
+export let qdrantApiKey = null;
+export let ready = false;
+export function setQdrantUrl(v) { qdrantUrl = v; }
+export function setQdrantApiKey(v) { qdrantApiKey = v; }
+export function setReady(v) { ready = v; }
+// ---------------------------------------------------------------------------
+// Logging (to file only — stdout/stderr are MCP stdio transport)
+// ---------------------------------------------------------------------------
+export const log = createLogger("memory-mcp", path.join(LOG_DIR, "mcp.log"), {
+    maxSize: 2 * 1024 * 1024,
+    maxFiles: 3,
+});
+// ---------------------------------------------------------------------------
+// LLM Chat Completion (for distillation)
+// ---------------------------------------------------------------------------
+export async function chatComplete(systemPrompt, userPrompt) {
+    if (!llmInitialized) {
+        const cfg = loadConfig();
+        initLLM({
+            config: {
+                provider: cfg.llm.provider,
+                ollama_url: cfg.llm.base_url,
+                ollama_model: cfg.llm.model,
+                openai_api_key: cfg.llm.api_key ?? null,
+                openai_model: cfg.llm.model,
+                bedrock_region: cfg.llm.bedrock_region,
+                bedrock_model: cfg.llm.model,
+            },
+            logger: log,
+        });
+        llmInitialized = true;
+    }
+    const result = await chatCompletion({
+        messages: [
+            { role: "system", content: systemPrompt },
+            { role: "user", content: userPrompt },
+        ],
+        max_tokens: 1000,
+        temperature: 0.3,
+    });
+    if (!result)
+        throw new Error("LLM chat completion failed");
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Qdrant REST Client
+// ---------------------------------------------------------------------------
+function qdrantHeaders() {
+    return {
+        "Content-Type": "application/json",
+        "api-key": qdrantApiKey ?? "",
+    };
+}
+export async function qdrantReq(method, urlPath, body) {
+    const url = `${qdrantUrl}${urlPath}`;
+    const opts = { method, headers: qdrantHeaders() };
+    if (body)
+        opts.body = JSON.stringify(body);
+    const resp = await fetch(url, opts);
+    if (!resp.ok) {
+        const text = await resp.text();
+        throw new Error(`Qdrant ${method} ${urlPath} failed (${resp.status}): ${text}`);
+    }
+    return resp.json();
+}
+export async function ensureCollection(indexes) {
+    const col = getCollection();
+    let exists = false;
+    try {
+        await qdrantReq("GET", `/collections/${col}`);
+        log("INFO", `Collection '${col}' exists ✓`);
+        exists = true;
+    }
+    catch (e) {
+        if (!(e instanceof Error && e.message.includes("404")))
+            throw e;
+    }
+    if (!exists) {
+        await qdrantReq("PUT", `/collections/${col}`, {
+            vectors: { size: getEmbeddingDimensions(), distance: "Cosine" },
+        });
+        log("INFO", `Collection '${col}' created`);
+    }
+    for (const idx of indexes) {
+        try {
+            await qdrantReq("PUT", `/collections/${col}/index`, idx);
+        }
+        catch (e) {
+            log("WARN", `Index creation for ${idx.field_name}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    log("INFO", "Payload indexes created");
+}
+export async function qdrantUpsert(id, vector, payload) {
+    return qdrantReq("PUT", `/collections/${getCollection()}/points`, {
+        points: [{ id, vector, payload }],
+    });
+}
+export async function qdrantSearch(vector, filter, limit = 5) {
+    return qdrantReq("POST", `/collections/${getCollection()}/points/search`, {
+        vector,
+        filter: filter ?? undefined,
+        limit,
+        with_payload: true,
+    });
+}
+export async function qdrantScroll(filter, limit = 10) {
+    return qdrantReq("POST", `/collections/${getCollection()}/points/scroll`, {
+        filter,
+        limit,
+        with_payload: true,
+    });
+}
+export async function qdrantSetPayload(ids, payload) {
+    return qdrantReq("POST", `/collections/${getCollection()}/points/payload`, {
+        points: ids,
+        payload,
+    });
+}
+export async function qdrantGetPoints(ids) {
+    return qdrantReq("POST", `/collections/${getCollection()}/points`, {
+        ids,
+        with_payload: true,
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/mcp/api.js.map

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

package/dist/mcp/helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pure helper functions for the Memory MCP server.
+ *
+ * Every function here is pure (or depends only on its inputs + Date.now()).
+ */
+import type { FactPayload, FilterParams, QdrantFilter, QdrantPoint } from "./types.js";
+export declare function contentHash(category: string, content: string): string;
+/** Days between an ISO timestamp and now. Returns Infinity for null/undefined. */
+export declare function daysSince(isoTimestamp: string | undefined | null): number;
+/** The most recent "activity" timestamp for a fact (verified > reinforced > created). */
+export declare function lastActivityDate(payload: FactPayload): string | undefined;
+/**
+ * Compute effective confidence using exponential decay.
+ * Categories with null half-life (session_summary, distilled) don't decay.
+ */
+export declare function computeEffectiveConfidence(payload: FactPayload): number;
+/**
+ * Freshness score for recall re-ranking.
+ * 1.0 for facts < 7 days old, linear decay to 0.3 at 180 days, floor at 0.3.
+ */
+export declare function computeFreshnessScore(payload: FactPayload): number;
+/** Reinforcement score: min(reinforcement_count / 5, 1.0). */
+export declare function computeReinforcementScore(payload: FactPayload): number;
+/**
+ * Combined re-ranking score for recall results.
+ * Blends vector similarity with freshness, reinforcement, importance, and confidence decay.
+ */
+export declare function computeCombinedScore(point: QdrantPoint): number;
+/** Check if a fact is stale (old + not recently reinforced/verified). */
+export declare function isStale(payload: FactPayload): boolean;
+/** Build a Qdrant filter object from optional params. */
+export declare function buildFilter(params?: FilterParams): QdrantFilter | undefined;
+/** Format a Qdrant point into a human-readable fact string. */
+export declare function formatFact(point: QdrantPoint): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/mcp/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/mcp/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOvF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrE;AAMD,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAGzE;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAEzE;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAOvE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAKlE;AAED,8DAA8D;AAC9D,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAO/D;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAErD;AAMD,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,MAAM,GAAE,YAAiB,GAAG,YAAY,GAAG,SAAS,CAgC/E;AAMD,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAyBrD"}

package/dist/mcp/helpers.js

@@ -0,0 +1,152 @@
+/**
+ * Pure helper functions for the Memory MCP server.
+ *
+ * Every function here is pure (or depends only on its inputs + Date.now()).
+ */
+import crypto from "node:crypto";
+import { DECAY_HALF_LIFE, DECAY_DEFAULT_HALF_LIFE, STALENESS_DAYS } from "./taxonomy.js";
+// ---------------------------------------------------------------------------
+// Hashing
+// ---------------------------------------------------------------------------
+export function contentHash(category, content) {
+    const normalized = `${category}:${content.toLowerCase().trim().replace(/\s+/g, " ")}`;
+    return crypto.createHash("sha256").update(normalized).digest("hex");
+}
+// ---------------------------------------------------------------------------
+// Time helpers
+// ---------------------------------------------------------------------------
+/** Days between an ISO timestamp and now. Returns Infinity for null/undefined. */
+export function daysSince(isoTimestamp) {
+    if (!isoTimestamp)
+        return Infinity;
+    return Math.max(0, (Date.now() - new Date(isoTimestamp).getTime()) / 86400000);
+}
+/** The most recent "activity" timestamp for a fact (verified > reinforced > created). */
+export function lastActivityDate(payload) {
+    return payload.last_verified_at ?? payload.last_reinforced_at ?? payload.created_at;
+}
+// ---------------------------------------------------------------------------
+// Scoring functions (all computed at read time, never mutate stored data)
+// ---------------------------------------------------------------------------
+/**
+ * Compute effective confidence using exponential decay.
+ * Categories with null half-life (session_summary, distilled) don't decay.
+ */
+export function computeEffectiveConfidence(payload) {
+    const cat = payload.category;
+    const halfLife = cat in DECAY_HALF_LIFE ? DECAY_HALF_LIFE[cat] : DECAY_DEFAULT_HALF_LIFE;
+    if (halfLife === null || halfLife === undefined)
+        return payload.confidence;
+    const days = daysSince(lastActivityDate(payload));
+    const decayFactor = Math.pow(0.5, days / halfLife);
+    return Math.round(payload.confidence * decayFactor * 100) / 100;
+}
+/**
+ * Freshness score for recall re-ranking.
+ * 1.0 for facts < 7 days old, linear decay to 0.3 at 180 days, floor at 0.3.
+ */
+export function computeFreshnessScore(payload) {
+    const days = daysSince(lastActivityDate(payload));
+    if (days <= 7)
+        return 1.0;
+    if (days >= 180)
+        return 0.3;
+    return 1.0 - (days - 7) * (0.7 / 173);
+}
+/** Reinforcement score: min(reinforcement_count / 5, 1.0). */
+export function computeReinforcementScore(payload) {
+    return Math.min((payload.reinforcement_count || 1) / 5, 1.0);
+}
+/**
+ * Combined re-ranking score for recall results.
+ * Blends vector similarity with freshness, reinforcement, importance, and confidence decay.
+ */
+export function computeCombinedScore(point) {
+    const vectorScore = point.score ?? 0;
+    const freshness = computeFreshnessScore(point.payload);
+    const reinforcement = computeReinforcementScore(point.payload);
+    const importance = point.payload.importance ?? 0.5;
+    const confidenceDecay = computeEffectiveConfidence(point.payload) / Math.max(point.payload.confidence, 0.01);
+    return (vectorScore * 0.55 + freshness * 0.15 + reinforcement * 0.1 + importance * 0.1) * (0.7 + 0.3 * confidenceDecay);
+}
+/** Check if a fact is stale (old + not recently reinforced/verified). */
+export function isStale(payload) {
+    return daysSince(lastActivityDate(payload)) > STALENESS_DAYS;
+}
+// ---------------------------------------------------------------------------
+// Filter building
+// ---------------------------------------------------------------------------
+/** Build a Qdrant filter object from optional params. */
+export function buildFilter(params = {}) {
+    const { category, domain, kind, entity, since, until, excludeSuperseded = true, metadata } = params;
+    const must = [];
+    if (excludeSuperseded) {
+        must.push({ is_null: { key: "superseded_by" } });
+    }
+    if (category) {
+        must.push({ key: "category", match: { value: category } });
+    }
+    if (domain) {
+        must.push({ key: "domain", match: { value: domain } });
+    }
+    if (kind) {
+        must.push({ key: "kind", match: { value: kind } });
+    }
+    if (entity) {
+        must.push({ key: "entities", match: { value: entity.toLowerCase() } });
+    }
+    if (since && until) {
+        must.push({ key: "created_at", range: { gte: since, lte: until } });
+    }
+    else if (since) {
+        must.push({ key: "created_at", range: { gte: since } });
+    }
+    else if (until) {
+        must.push({ key: "created_at", range: { lte: until } });
+    }
+    if (metadata && typeof metadata === "object") {
+        for (const [k, v] of Object.entries(metadata)) {
+            must.push({ key: `metadata.${k}`, match: { value: v } });
+        }
+    }
+    return must.length > 0 ? { must } : undefined;
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+/** Format a Qdrant point into a human-readable fact string. */
+export function formatFact(point) {
+    const p = point.payload;
+    const effectiveConf = computeEffectiveConfidence(p);
+    const stale = isStale(p);
+    const parts = [`${stale ? "🕰️ " : ""}[${p.category}] ${p.content}`];
+    if (p.domain && p.domain !== "work")
+        parts.push(`domain: ${p.domain}`);
+    if (p.kind && p.kind !== "fact")
+        parts.push(`kind: ${p.kind}`);
+    if (p.entities?.length)
+        parts.push(`entities: ${p.entities.join(", ")}`);
+    if (effectiveConf < p.confidence) {
+        parts.push(`confidence: ${p.confidence} → effective: ${effectiveConf}`);
+    }
+    else {
+        parts.push(`confidence: ${p.confidence}`);
+    }
+    if (p.reinforcement_count > 1)
+        parts.push(`reinforced: ${p.reinforcement_count}x`);
+    if ((p.verification_count ?? 0) > 0)
+        parts.push(`verified: ${p.verification_count}x`);
+    if (p.metadata && Object.keys(p.metadata).length > 0) {
+        const metaPairs = Object.entries(p.metadata).map(([k, v]) => `${k}=${v}`).join(", ");
+        parts.push(`metadata: {${metaPairs}}`);
+    }
+    if (p.created_at)
+        parts.push(`created: ${p.created_at}`);
+    parts.push(`id: ${point.id}`);
+    if (point.score !== undefined)
+        parts.push(`score: ${point.score.toFixed(3)}`);
+    if (point._combinedScore !== undefined)
+        parts.push(`rank: ${point._combinedScore.toFixed(3)}`);
+    return parts.join(" | ");
+}
+//# sourceMappingURL=helpers.js.map

package/dist/mcp/helpers.js.map

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

package/dist/mcp/helpers.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for pure helper functions in the Memory MCP server.
+ */
+export {};
+//# sourceMappingURL=helpers.test.d.ts.map

package/dist/mcp/helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.d.ts","sourceRoot":"","sources":["../../src/mcp/helpers.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}