bikky 0.3.1 → 0.3.3

package/dist/mcp/tools.integration.itest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * End-to-end integration test against a real Qdrant Cloud collection.
+ *
+ * **OPT-IN.** This file uses the `.itest.ts` extension so the default
+ * `dist/**\/*.test.js` glob does NOT pick it up. Run explicitly with:
+ *
+ *   BIKKY_INTEGRATION=1 npm run test:integration
+ *
+ * Required env (or in ~/.bikky/config.json — loadConfig merges env):
+ *   - BIKKY_INTEGRATION=1   (master gate)
+ *   - QDRANT_URL            (Qdrant Cloud REST URL)
+ *   - QDRANT_API_KEY        (Qdrant Cloud API key)
+ *   - embedding provider config (defaults from ~/.bikky/config.json)
+ *
+ * Behaviour:
+ *   - Creates a uuid-suffixed throwaway collection (`bikky-it-<short>`).
+ *   - Drops it in `after()` regardless of pass/fail.
+ *   - Exercises the real handlers from registerTools() against live Qdrant +
+ *     real embeddings — validating filter shapes, payload indexes, vector
+ *     dimensions, and the dedup similarity thresholds for real.
+ */
+export {};
+//# sourceMappingURL=tools.integration.itest.d.ts.map

package/dist/mcp/tools.integration.itest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.integration.itest.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.integration.itest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/mcp/tools.integration.itest.js

@@ -0,0 +1,172 @@
+/**
+ * End-to-end integration test against a real Qdrant Cloud collection.
+ *
+ * **OPT-IN.** This file uses the `.itest.ts` extension so the default
+ * `dist/**\/*.test.js` glob does NOT pick it up. Run explicitly with:
+ *
+ *   BIKKY_INTEGRATION=1 npm run test:integration
+ *
+ * Required env (or in ~/.bikky/config.json — loadConfig merges env):
+ *   - BIKKY_INTEGRATION=1   (master gate)
+ *   - QDRANT_URL            (Qdrant Cloud REST URL)
+ *   - QDRANT_API_KEY        (Qdrant Cloud API key)
+ *   - embedding provider config (defaults from ~/.bikky/config.json)
+ *
+ * Behaviour:
+ *   - Creates a uuid-suffixed throwaway collection (`bikky-it-<short>`).
+ *   - Drops it in `after()` regardless of pass/fail.
+ *   - Exercises the real handlers from registerTools() against live Qdrant +
+ *     real embeddings — validating filter shapes, payload indexes, vector
+ *     dimensions, and the dedup similarity thresholds for real.
+ */
+import { describe, it, before, after } from "node:test";
+import assert from "node:assert/strict";
+import { randomUUID } from "node:crypto";
+import { registerTools } from "./tools.js";
+import { setQdrantUrl, setQdrantApiKey, setReady, setCollection, initEmbedding, ensureCollection, qdrantReq, } from "./api.js";
+import { QDRANT_INDEXES } from "./taxonomy.js";
+import { loadConfig } from "../config.js";
+const enabled = process.env.BIKKY_INTEGRATION === "1" &&
+    Boolean(process.env.QDRANT_URL || loadConfig().qdrant_url) &&
+    Boolean(process.env.QDRANT_API_KEY || loadConfig().qdrant_api_key);
+function makeFakeServer() {
+    const handlers = new Map();
+    const server = {
+        tool(name, _desc, _schema, handler) {
+            handlers.set(name, handler);
+        },
+    };
+    return { server, handlers };
+}
+let handlers;
+let collectionName;
+function textOf(result) {
+    return result.content[0]?.text ?? "";
+}
+async function invoke(name, args) {
+    const h = handlers.get(name);
+    if (!h)
+        throw new Error(`Handler '${name}' not registered`);
+    return h(args);
+}
+describe("mcp/tools — Qdrant integration", { skip: !enabled }, () => {
+    before(async () => {
+        const cfg = loadConfig();
+        const url = process.env.QDRANT_URL ?? cfg.qdrant_url;
+        const apiKey = process.env.QDRANT_API_KEY ?? cfg.qdrant_api_key;
+        if (!url || !apiKey)
+            throw new Error("Qdrant URL / API key missing");
+        collectionName = `bikky-it-${randomUUID().slice(0, 8)}`;
+        setQdrantUrl(url);
+        setQdrantApiKey(apiKey);
+        setCollection(collectionName);
+        initEmbedding({
+            provider: cfg.embedding.provider,
+            baseUrl: cfg.embedding.base_url,
+            model: cfg.embedding.model,
+            dimensions: cfg.embedding.dimensions,
+            apiKey: cfg.embedding.api_key,
+        });
+        await ensureCollection(QDRANT_INDEXES);
+        setReady(true);
+        const fake = makeFakeServer();
+        registerTools(fake.server);
+        handlers = fake.handlers;
+    });
+    after(async () => {
+        try {
+            if (collectionName) {
+                await qdrantReq("DELETE", `/collections/${collectionName}`);
+            }
+        }
+        finally {
+            setReady(false);
+            setQdrantUrl(null);
+            setQdrantApiKey(null);
+        }
+    });
+    // Shared state across the ordered scenarios below.
+    let fact1Id;
+    let fact2Id;
+    it("inserts two distinct facts", async () => {
+        const r1 = JSON.parse(textOf(await invoke("memory_store", {
+            content: "Qdrant Cloud free tier provides 1GB storage with no credit card required",
+            category: "infrastructure",
+            entities: ["qdrant", "qdrant-cloud"],
+        })));
+        assert.equal(r1.action, "inserted");
+        fact1Id = r1.fact_id;
+        const r2 = JSON.parse(textOf(await invoke("memory_store", {
+            content: "OpenAI text-embedding-3-small produces 1536-dimensional vectors",
+            category: "infrastructure",
+            entities: ["openai", "embeddings"],
+        })));
+        assert.equal(r2.action, "inserted");
+        fact2Id = r2.fact_id;
+        assert.notEqual(fact1Id, fact2Id);
+    });
+    it("reinforces on exact content-hash match", async () => {
+        const r = JSON.parse(textOf(await invoke("memory_store", {
+            content: "Qdrant Cloud free tier provides 1GB storage with no credit card required",
+            category: "infrastructure",
+            entities: ["qdrant"],
+        })));
+        assert.equal(r.action, "reinforced");
+        assert.equal(r.fact_id, fact1Id);
+        assert.ok(r.reinforcement_count >= 2);
+    });
+    it("reinforces on a near-duplicate via real-vector similarity", async () => {
+        // Paraphrase of fact 1 — same meaning, different wording.
+        const r = JSON.parse(textOf(await invoke("memory_store", {
+            content: "Qdrant Cloud's free plan offers 1GB of storage and does not require a credit card",
+            category: "infrastructure",
+            entities: ["qdrant"],
+        })));
+        // Either reinforced (preferred — proves the 0.92 threshold) or inserted
+        // with a similar_facts entry pointing at fact1 (proves we're at least in
+        // the related band). The first case is the strong assertion; we log if it
+        // falls through so a maintainer can re-tune thresholds per embedding model.
+        if (r.action === "reinforced") {
+            assert.equal(r.fact_id, fact1Id);
+        }
+        else {
+            assert.equal(r.action, "inserted", `unexpected action: ${r.action}`);
+            const similar = (r.similar_facts ?? []);
+            const match = similar.find((s) => s.id === fact1Id);
+            assert.ok(match, `expected paraphrase to reinforce or appear in similar_facts; got ${JSON.stringify(r)}`);
+            // eslint-disable-next-line no-console
+            console.warn(`[integration] paraphrase landed in related band (score=${match.score}) — consider tuning THRESHOLD_DUPLICATE for this embedding model`);
+        }
+    });
+    it("recalls a stored fact via semantic search", async () => {
+        const result = await invoke("memory_recall", {
+            query: "What does the Qdrant free tier include?",
+            limit: 5,
+        });
+        const text = textOf(result);
+        assert.match(text, /1GB|free tier/i);
+    });
+    it("aggregates facts about an entity", async () => {
+        const result = await invoke("memory_entity", { name: "qdrant" });
+        const text = textOf(result);
+        assert.match(text, /Facts about qdrant/);
+        assert.match(text, /1GB|free tier/i);
+    });
+    it("forgets a fact and excludes it from subsequent recall", async () => {
+        const forgetResult = JSON.parse(textOf(await invoke("memory_forget", {
+            fact_id: fact2Id,
+            reason: "integration-test cleanup",
+        })));
+        assert.equal(forgetResult.status, "forgotten");
+        // Recall something the forgotten fact would have matched.
+        const recallResult = await invoke("memory_recall", {
+            query: "OpenAI embedding dimensions",
+            limit: 10,
+        });
+        const text = textOf(recallResult);
+        // Fact 2 should not appear (it was the only one about embedding dimensions
+        // we inserted). A "no matching facts" response is acceptable.
+        assert.doesNotMatch(text, /1536-dimensional/);
+    });
+});
+//# sourceMappingURL=tools.integration.itest.js.map

package/dist/mcp/tools.integration.itest.js.map

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