@unclick/mcp-server 0.3.0 → 0.3.1

package/dist/memory/__tests__/bitemporal.test.js

@@ -0,0 +1,148 @@
+/**
+ * Acceptance tests for Chunk 2: bi-temporal schema, provenance, and blob preservation.
+ *
+ * These tests are skipped unless SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY are present.
+ * Run with: tsx --test src/memory/__tests__/bitemporal.test.ts
+ */
+import { describe, it, before, after } from "node:test";
+import assert from "node:assert/strict";
+import { createHash } from "node:crypto";
+// ---- Pure unit helpers (no I/O) ----
+function contentHash(text) {
+    return createHash("sha256").update(text.trim().toLowerCase()).digest("hex");
+}
+function cosine(a, b) {
+    let dot = 0, na = 0, nb = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        na += a[i] * a[i];
+        nb += b[i] * b[i];
+    }
+    return na === 0 || nb === 0 ? 0 : dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+// Near-dup collapse: given scored candidates with embeddings, return de-duped set.
+// Mirrors the SQL dominated CTE logic.
+function nearDupCollapse(candidates, threshold = 0.9) {
+    const dominated = new Set();
+    for (let i = 0; i < candidates.length; i++) {
+        for (let j = 0; j < candidates.length; j++) {
+            if (i === j)
+                continue;
+            const sim = cosine(candidates[i].embedding, candidates[j].embedding);
+            if (sim >= threshold) {
+                // The lower-scored one is dominated; ties broken by id (LEAST)
+                if (candidates[j].score < candidates[i].score ||
+                    (candidates[j].score === candidates[i].score && candidates[j].id > candidates[i].id)) {
+                    dominated.add(candidates[j].id);
+                }
+            }
+        }
+    }
+    return candidates.filter((c) => !dominated.has(c.id)).map((c) => c.id);
+}
+// ---- Unit tests (always run) ----
+describe("contentHash", () => {
+    it("is stable for identical text", () => {
+        const h1 = contentHash("User prefers TypeScript");
+        const h2 = contentHash("User prefers TypeScript");
+        assert.equal(h1, h2);
+    });
+    it("normalises whitespace and case", () => {
+        const h1 = contentHash("  USER PREFERS TYPESCRIPT  ");
+        const h2 = contentHash("user prefers typescript");
+        assert.equal(h1, h2);
+    });
+    it("differs for distinct text", () => {
+        assert.notEqual(contentHash("fact A"), contentHash("fact B"));
+    });
+});
+describe("nearDupCollapse (pure)", () => {
+    it("keeps both candidates when cosine < threshold", () => {
+        // Orthogonal vectors - cosine = 0
+        const a = { id: "a", score: 0.9, embedding: [1, 0, 0] };
+        const b = { id: "b", score: 0.8, embedding: [0, 1, 0] };
+        const kept = nearDupCollapse([a, b]);
+        assert.deepEqual(kept.sort(), ["a", "b"]);
+    });
+    it("drops the lower-scored duplicate when cosine >= 0.9", () => {
+        // Nearly identical vectors
+        const base = [0.9, 0.1, 0.05];
+        const near = [0.91, 0.1, 0.04];
+        const a = { id: "a", score: 0.9, embedding: base };
+        const b = { id: "b", score: 0.5, embedding: near };
+        const kept = nearDupCollapse([a, b]);
+        assert.deepEqual(kept, ["a"]);
+    });
+    it("breaks ties by id (LEAST wins)", () => {
+        const v = [1, 0];
+        const a = { id: "aaa", score: 0.7, embedding: v };
+        const b = { id: "zzz", score: 0.7, embedding: v };
+        const kept = nearDupCollapse([a, b]);
+        assert.deepEqual(kept, ["aaa"]);
+    });
+    it("handles single candidate", () => {
+        const kept = nearDupCollapse([{ id: "x", score: 1.0, embedding: [1, 0] }]);
+        assert.deepEqual(kept, ["x"]);
+    });
+});
+// ---- Integration tests (skipped without live creds) ----
+const LIVE = !!(process.env.SUPABASE_URL && process.env.SUPABASE_SERVICE_ROLE_KEY);
+describe("Supabase bi-temporal integration", { skip: !LIVE }, () => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let _db;
+    let testSession;
+    before(async () => {
+        const { SupabaseBackend } = await import("../supabase.js");
+        _db = new SupabaseBackend();
+        testSession = `test-chunk2-${Date.now()}`;
+    });
+    it("exact-hash dedup: inserting same fact twice returns same id", async () => {
+        const { SupabaseBackend } = await import("../supabase.js");
+        const backend = new SupabaseBackend();
+        const factText = `dedup-test-${Date.now()}`;
+        const r1 = await backend.addFact({ fact: factText, category: "test", confidence: 0.9, source_session_id: testSession });
+        const r2 = await backend.addFact({ fact: factText, category: "test", confidence: 0.9, source_session_id: testSession });
+        assert.equal(r1.id, r2.id, "second insert should return existing fact id");
+    });
+    it("bi-temporal: invalidated fact excluded from search, visible via as_of", async () => {
+        const { SupabaseBackend } = await import("../supabase.js");
+        const backend = new SupabaseBackend();
+        const factText = `invalidate-test-${Date.now()}`;
+        // Insert fact and record timestamp
+        const { id } = await backend.addFact({ fact: factText, category: "test", confidence: 0.9, source_session_id: testSession });
+        const afterInsert = new Date().toISOString();
+        // Invalidate it
+        await backend.invalidateFact({ fact_id: id, reason: "test cleanup", session_id: testSession });
+        // Search now - should NOT appear
+        const nowResults = await backend.searchFacts(factText);
+        const ids = nowResults.map((r) => r.id);
+        assert.ok(!ids.includes(id), "invalidated fact should not appear in current search");
+        // Search as_of before invalidation - should appear
+        const pastResults = await backend.searchMemory(factText, 10, afterInsert);
+        const pastIds = pastResults.map((r) => r.id);
+        assert.ok(pastIds.includes(id), "invalidated fact should appear in as_of query before invalidation");
+    });
+    it("preserve_as_blob: stores canonical doc and returns fact_ids", async () => {
+        if (!process.env.OPENAI_API_KEY) {
+            console.log("  skipping preserve_as_blob test (no OPENAI_API_KEY)");
+            return;
+        }
+        const { SupabaseBackend } = await import("../supabase.js");
+        const backend = new SupabaseBackend();
+        const blob = `User works at Acme Corp. They prefer TypeScript. They live in Seattle. Session: ${testSession}`;
+        const result = await backend.addFact({
+            fact: blob,
+            category: "blob",
+            confidence: 0.9,
+            source_session_id: testSession,
+            preserve_as_blob: true,
+        });
+        assert.ok(result.id, "should return canonical doc id");
+        assert.ok(Array.isArray(result.fact_ids), "should return extracted fact_ids array");
+        assert.ok(result.fact_ids.length >= 1, "should have extracted at least one atomic fact");
+    });
+    after(async () => {
+        // Best-effort: nothing to clean up since invalidated facts stay in DB
+    });
+});
+//# sourceMappingURL=bitemporal.test.js.map

package/dist/memory/__tests__/bitemporal.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitemporal.test.js","sourceRoot":"","sources":["../../../src/memory/__tests__/bitemporal.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,uCAAuC;AAEvC,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,MAAM,CAAC,CAAW,EAAE,CAAW;IACtC,IAAI,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,mFAAmF;AACnF,uCAAuC;AACvC,SAAS,eAAe,CACtB,UAAqE,EACrE,SAAS,GAAG,GAAG;IAEf,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC;gBAAE,SAAS;YACtB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACrE,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;gBACrB,+DAA+D;gBAC/D,IACE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK;oBACzC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EACpF,CAAC;oBACD,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,oCAAoC;AAEpC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,EAAE,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;QAClD,MAAM,EAAE,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,EAAE,GAAG,WAAW,CAAC,6BAA6B,CAAC,CAAC;QACtD,MAAM,EAAE,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,kCAAkC;QAClC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,2BAA2B;QAC3B,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjB,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,2DAA2D;AAE3D,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEnF,QAAQ,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;IACjE,8DAA8D;IAC9D,IAAI,GAAQ,CAAC;IACb,IAAI,WAAmB,CAAC;IAExB,MAAM,CAAC,KAAK,IAAI,EAAE;QAChB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC3D,GAAG,GAAG,IAAK,eAAgD,EAAE,CAAC;QAC9D,WAAW,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAK,eAAuB,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAAC;QACxH,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAAC;QACxH,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,8CAA8C,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAK,eAAuB,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,mBAAmB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAEjD,mCAAmC;QACnC,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAAC;QAC5H,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE7C,gBAAgB;QAChB,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;QAE/F,iCAAiC;QACjC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAc,CAAC;QACpE,MAAM,GAAG,GAAI,UAAoC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,sDAAsD,CAAC,CAAC;QAErF,mDAAmD;QACnD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,CAAc,CAAC;QACvF,MAAM,OAAO,GAAI,WAAqC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,mEAAmE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAK,eAAuB,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,mFAAmF,WAAW,EAAE,CAAC;QAC9G,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC;YACnC,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,GAAG;YACf,iBAAiB,EAAE,WAAW;YAC9B,gBAAgB,EAAE,IAAI;SACvB,CAAwC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,gCAAgC,CAAC,CAAC;QACvD,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,wCAAwC,CAAC,CAAC;QACpF,MAAM,CAAC,EAAE,CAAE,MAAM,CAAC,QAAqB,CAAC,MAAM,IAAI,CAAC,EAAE,gDAAgD,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,sEAAsE;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/memory/__tests__/hybrid-search.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tests for hybrid RRF search logic.
+ *
+ * Run: npx tsx --test src/memory/__tests__/hybrid-search.test.ts
+ * (from packages/mcp-server directory)
+ *
+ * Tests:
+ *   1. RRF scoring math (pure function, no DB required)
+ *   2. embedText graceful null return when OPENAI_API_KEY absent
+ *   3. Acceptance test: semantic query finds fact that keyword search misses
+ *      (requires SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY + OPENAI_API_KEY)
+ */
+export {};
+//# sourceMappingURL=hybrid-search.test.d.ts.map

package/dist/memory/__tests__/hybrid-search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-search.test.d.ts","sourceRoot":"","sources":["../../../src/memory/__tests__/hybrid-search.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/memory/__tests__/hybrid-search.test.js

@@ -0,0 +1,304 @@
+/**
+ * Tests for hybrid RRF search logic.
+ *
+ * Run: npx tsx --test src/memory/__tests__/hybrid-search.test.ts
+ * (from packages/mcp-server directory)
+ *
+ * Tests:
+ *   1. RRF scoring math (pure function, no DB required)
+ *   2. embedText graceful null return when OPENAI_API_KEY absent
+ *   3. Acceptance test: semantic query finds fact that keyword search misses
+ *      (requires SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY + OPENAI_API_KEY)
+ */
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+function computeRRFScore(input) {
+    const k = input.k ?? 60;
+    const kwContrib = input.kwRank !== undefined ? 1 / (k + input.kwRank) : 0;
+    const vecContrib = input.vecRank !== undefined ? 1 / (k + input.vecRank) : 0;
+    const rrf = kwContrib + vecContrib;
+    const recency = Math.exp(-input.ageDays / 90);
+    const final = rrf * input.confidence * recency;
+    return { rrf, final };
+}
+describe("RRF scoring math", () => {
+    test("row in both lanes scores higher than row in one lane", () => {
+        const both = computeRRFScore({ kwRank: 1, vecRank: 1, confidence: 1, ageDays: 0 });
+        const kwOnly = computeRRFScore({ kwRank: 1, confidence: 1, ageDays: 0 });
+        const vecOnly = computeRRFScore({ vecRank: 1, confidence: 1, ageDays: 0 });
+        assert.ok(both.rrf > kwOnly.rrf, "both > kw-only");
+        assert.ok(both.rrf > vecOnly.rrf, "both > vec-only");
+    });
+    test("RRF rank 1 beats rank 50 in same lane", () => {
+        const top = computeRRFScore({ kwRank: 1, confidence: 1, ageDays: 0 });
+        const bottom = computeRRFScore({ kwRank: 50, confidence: 1, ageDays: 0 });
+        assert.ok(top.rrf > bottom.rrf);
+    });
+    test("recency decay: 0-day-old > 90-day-old > 180-day-old", () => {
+        const base = { kwRank: 1, confidence: 1, k: 60 };
+        const fresh = computeRRFScore({ ...base, ageDays: 0 });
+        const mid = computeRRFScore({ ...base, ageDays: 90 });
+        const old = computeRRFScore({ ...base, ageDays: 180 });
+        assert.ok(fresh.final > mid.final, "fresh > mid");
+        assert.ok(mid.final > old.final, "mid > old");
+        // 90-day decay factor should be ~1/e ≈ 0.368
+        assert.ok(Math.abs(mid.final / fresh.final - Math.exp(-1)) < 0.001, "90d decay ≈ 1/e");
+    });
+    test("confidence 0.9 row can beat confidence 1.0 row with better RRF", () => {
+        // A result ranked 1st in both lanes at 0.9 confidence should beat a result
+        // ranked 50th in one lane at 1.0 confidence with same recency.
+        const highRRF = computeRRFScore({ kwRank: 1, vecRank: 1, confidence: 0.9, ageDays: 0 });
+        const lowRRF = computeRRFScore({ kwRank: 50, confidence: 1.0, ageDays: 0 });
+        assert.ok(highRRF.final > lowRRF.final);
+    });
+    test("RRF k=60 exact values for rank 1", () => {
+        // 1/(60+1) = 0.016393...
+        const score = computeRRFScore({ kwRank: 1, confidence: 1, ageDays: 0 });
+        assert.ok(Math.abs(score.rrf - 1 / 61) < 1e-10);
+    });
+    test("row absent from both lanes scores 0", () => {
+        const score = computeRRFScore({ confidence: 1, ageDays: 0 });
+        assert.equal(score.rrf, 0);
+        assert.equal(score.final, 0);
+    });
+});
+// ─── 2. embedText returns null when key absent ────────────────────────────────
+describe("embedText", () => {
+    test("returns null when OPENAI_API_KEY is not set", async () => {
+        // Ensure the env var is absent for this test
+        const saved = process.env.OPENAI_API_KEY;
+        delete process.env.OPENAI_API_KEY;
+        try {
+            // Dynamic import so it picks up the (now absent) env var at call time
+            const { embedText } = await import("../embeddings.js");
+            const result = await embedText("test query");
+            assert.equal(result, null);
+        }
+        finally {
+            if (saved !== undefined)
+                process.env.OPENAI_API_KEY = saved;
+        }
+    });
+});
+// ─── 2b. Keyword-fallback regression (P0) ─────────────────────────────────────
+//
+// Reproduces the production bug: a fact with NULL embedding whose proper-noun
+// content does not survive plainto_tsquery('english', ...) tokenization.
+// Hybrid returns []. ILIKE fallback must surface the row anyway.
+describe("acceptance: keyword fallback restores search when hybrid returns []", () => {
+    test("ILIKE fallback finds proper-noun fact with NULL embedding", async () => {
+        const url = process.env.TEST_SUPABASE_URL ?? process.env.SUPABASE_URL;
+        const key = process.env.TEST_SUPABASE_SERVICE_ROLE_KEY ?? process.env.SUPABASE_SERVICE_ROLE_KEY;
+        if (!url || !key) {
+            console.log("    [skipped] set SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY to run");
+            return;
+        }
+        const { createClient } = await import("@supabase/supabase-js");
+        const supabase = createClient(url, key, { auth: { persistSession: false, autoRefreshToken: false } });
+        const factText = "Test owner is Chris Byrne for P0 search-memory regression";
+        const { data: inserted, error: insertErr } = await supabase
+            .from("extracted_facts")
+            .insert({
+            fact: factText,
+            category: "test",
+            confidence: 0.9,
+            status: "active",
+            source_type: "test",
+            decay_tier: "hot",
+            // Deliberately leave embedding NULL to simulate legacy / un-backfilled rows
+        })
+            .select("id")
+            .single();
+        assert.ok(!insertErr, `insert failed: ${insertErr?.message}`);
+        const factId = inserted.id;
+        try {
+            // Force the keyword path by removing OPENAI_API_KEY: searchMemory will
+            // skip the hybrid lane and exercise keywordFallback directly.
+            const savedOpenAI = process.env.OPENAI_API_KEY;
+            delete process.env.OPENAI_API_KEY;
+            try {
+                const { SupabaseBackend } = await import("../supabase.js");
+                const backend = new SupabaseBackend({
+                    url,
+                    serviceRoleKey: key,
+                    tenancy: { mode: "byod" },
+                });
+                const results = (await backend.searchMemory("Chris", 10));
+                assert.ok(Array.isArray(results), "fallback should return an array");
+                const ids = results.map((r) => r.id);
+                assert.ok(ids.includes(factId), `Expected fact ${factId} via ILIKE fallback. Got ${ids.length} rows: ${JSON.stringify(results.slice(0, 3))}`);
+                console.log(`    [passed] keyword fallback surfaced fact at position ${ids.indexOf(factId) + 1}`);
+            }
+            finally {
+                if (savedOpenAI !== undefined)
+                    process.env.OPENAI_API_KEY = savedOpenAI;
+            }
+        }
+        finally {
+            await supabase.from("extracted_facts").delete().eq("id", factId);
+        }
+    });
+    // Phrase-query regression: a multi-word query like "active Fishbowl topic"
+    // used to ILIKE the literal whole string and miss any fact whose words were
+    // present but interleaved with other words. The fix tokenizes the query and
+    // ANDs each token; if AND returns nothing it degrades to OR-of-tokens.
+    test("multi-word query finds facts containing all tokens in any order (AND mode)", async () => {
+        const url = process.env.TEST_SUPABASE_URL ?? process.env.SUPABASE_URL;
+        const key = process.env.TEST_SUPABASE_SERVICE_ROLE_KEY ?? process.env.SUPABASE_SERVICE_ROLE_KEY;
+        if (!url || !key) {
+            console.log("    [skipped] set SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY to run");
+            return;
+        }
+        const { createClient } = await import("@supabase/supabase-js");
+        const supabase = createClient(url, key, { auth: { persistSession: false, autoRefreshToken: false } });
+        const factText = "Current Fishbowl thread tracks the active topic for Phase 1.1 hotfix";
+        const { data: inserted, error: insertErr } = await supabase
+            .from("extracted_facts")
+            .insert({
+            fact: factText,
+            category: "test",
+            confidence: 0.9,
+            status: "active",
+            source_type: "test",
+            decay_tier: "hot",
+        })
+            .select("id")
+            .single();
+        assert.ok(!insertErr, `insert failed: ${insertErr?.message}`);
+        const factId = inserted.id;
+        try {
+            const savedOpenAI = process.env.OPENAI_API_KEY;
+            delete process.env.OPENAI_API_KEY;
+            try {
+                const { SupabaseBackend } = await import("../supabase.js");
+                const backend = new SupabaseBackend({ url, serviceRoleKey: key, tenancy: { mode: "byod" } });
+                // All three tokens appear in the fact, but not as a contiguous phrase.
+                const results = (await backend.searchMemory("active Fishbowl topic", 10));
+                const ids = results.map((r) => r.id);
+                assert.ok(ids.includes(factId), `Expected fact ${factId} via tokenized AND. Got: ${JSON.stringify(results.slice(0, 3))}`);
+            }
+            finally {
+                if (savedOpenAI !== undefined)
+                    process.env.OPENAI_API_KEY = savedOpenAI;
+            }
+        }
+        finally {
+            await supabase.from("extracted_facts").delete().eq("id", factId);
+        }
+    });
+    test("OR fallback surfaces best partial match when no fact contains every token", async () => {
+        const url = process.env.TEST_SUPABASE_URL ?? process.env.SUPABASE_URL;
+        const key = process.env.TEST_SUPABASE_SERVICE_ROLE_KEY ?? process.env.SUPABASE_SERVICE_ROLE_KEY;
+        if (!url || !key) {
+            console.log("    [skipped] set SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY to run");
+            return;
+        }
+        const { createClient } = await import("@supabase/supabase-js");
+        const supabase = createClient(url, key, { auth: { persistSession: false, autoRefreshToken: false } });
+        // Fact contains "architecture" but not "thread". Query is "architecture
+        // thread nonexistent" so AND-of-tokens returns []; OR-of-tokens should
+        // still surface this row because it matches one token.
+        const factText = "Memory architecture uses six layers including bitemporal facts";
+        const { data: inserted, error: insertErr } = await supabase
+            .from("extracted_facts")
+            .insert({
+            fact: factText,
+            category: "test",
+            confidence: 0.8,
+            status: "active",
+            source_type: "test",
+            decay_tier: "hot",
+        })
+            .select("id")
+            .single();
+        assert.ok(!insertErr, `insert failed: ${insertErr?.message}`);
+        const factId = inserted.id;
+        try {
+            const savedOpenAI = process.env.OPENAI_API_KEY;
+            delete process.env.OPENAI_API_KEY;
+            try {
+                const { SupabaseBackend } = await import("../supabase.js");
+                const backend = new SupabaseBackend({ url, serviceRoleKey: key, tenancy: { mode: "byod" } });
+                const results = (await backend.searchMemory("architecture thread zzznonexistentzzz", 10));
+                const ids = results.map((r) => r.id);
+                assert.ok(ids.includes(factId), `Expected fact ${factId} via OR-of-tokens fallback. Got: ${JSON.stringify(results.slice(0, 3))}`);
+            }
+            finally {
+                if (savedOpenAI !== undefined)
+                    process.env.OPENAI_API_KEY = savedOpenAI;
+            }
+        }
+        finally {
+            await supabase.from("extracted_facts").delete().eq("id", factId);
+        }
+    });
+});
+// ─── 3. Acceptance test (LOCOMO-style) ────────────────────────────────────────
+//
+// Requires real credentials. Skipped automatically when env vars are absent.
+// This is the key regression test: a query that previously returned [] should
+// now return the expected fact in top-5 after backfill.
+describe("acceptance: hybrid search finds semantically similar fact", () => {
+    test("'preference for functional programming' found by 'avoids OOP' query", async () => {
+        const url = process.env.TEST_SUPABASE_URL ?? process.env.SUPABASE_URL;
+        const key = process.env.TEST_SUPABASE_SERVICE_ROLE_KEY ?? process.env.SUPABASE_SERVICE_ROLE_KEY;
+        const openaiKey = process.env.OPENAI_API_KEY;
+        if (!url || !key || !openaiKey) {
+            console.log("    [skipped] set SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, OPENAI_API_KEY to run");
+            return;
+        }
+        const { createClient } = await import("@supabase/supabase-js");
+        const { embedText, EMBEDDING_MODEL } = await import("../embeddings.js");
+        const supabase = createClient(url, key, {
+            auth: { persistSession: false, autoRefreshToken: false },
+        });
+        // Insert a test fact
+        const factText = "User strongly prefers functional programming over object-oriented patterns";
+        const { data: inserted, error: insertErr } = await supabase
+            .from("extracted_facts")
+            .insert({
+            fact: factText,
+            category: "preference",
+            confidence: 0.95,
+            status: "active",
+            source_type: "test",
+            decay_tier: "hot",
+        })
+            .select("id")
+            .single();
+        assert.ok(!insertErr, `insert failed: ${insertErr?.message}`);
+        const factId = inserted.id;
+        try {
+            // Embed the fact
+            const factEmbedding = await embedText(factText);
+            assert.ok(factEmbedding, "failed to embed fact");
+            await supabase
+                .from("extracted_facts")
+                .update({
+                embedding: JSON.stringify(factEmbedding),
+                embedding_model: EMBEDDING_MODEL,
+                embedding_created_at: new Date().toISOString(),
+            })
+                .eq("id", factId);
+            // Search with a semantically related but keyword-different query
+            const query = "avoids class hierarchies and OOP";
+            const queryEmbedding = await embedText(query);
+            assert.ok(queryEmbedding, "failed to embed query");
+            const { data: results, error: searchErr } = await supabase.rpc("search_memory_hybrid", {
+                search_query: query,
+                query_embedding: queryEmbedding,
+                max_results: 5,
+            });
+            assert.ok(!searchErr, `hybrid search failed: ${searchErr?.message}`);
+            assert.ok(Array.isArray(results), "results should be array");
+            const ids = results.map((r) => r.id);
+            assert.ok(ids.includes(factId), `Expected fact ${factId} in top-5. Got: ${JSON.stringify(results)}`);
+            console.log(`    [passed] fact found at position ${ids.indexOf(factId) + 1} of ${ids.length}`);
+        }
+        finally {
+            // Clean up
+            await supabase.from("extracted_facts").delete().eq("id", factId);
+        }
+    });
+});
+//# sourceMappingURL=hybrid-search.test.js.map

package/dist/memory/__tests__/hybrid-search.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-search.test.js","sourceRoot":"","sources":["../../../src/memory/__tests__/hybrid-search.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAexC,SAAS,eAAe,CAAC,KAAe;IAItC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACxB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,SAAS,GAAG,UAAU,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC;IAC/C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAChE,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACnD,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QACjD,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAClD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC9C,6CAA6C;QAC7C,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,2EAA2E;QAC3E,+DAA+D;QAC/D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,yBAAyB;QACzB,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,IAAI,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC7D,6CAA6C;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACzC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAClC,IAAI,CAAC;YACH,sEAAsE;YACtE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AACjF,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,iEAAiE;AAEjE,QAAQ,CAAC,qEAAqE,EAAE,GAAG,EAAE;IACnF,IAAI,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAChG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;YACjF,OAAO;QACT,CAAC;QACD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAEtG,MAAM,QAAQ,GAAG,2DAA2D,CAAC;QAC7E,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ;aACxD,IAAI,CAAC,iBAAiB,CAAC;aACvB,MAAM,CAAC;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;YACjB,4EAA4E;SAC7E,CAAC;aACD,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,kBAAkB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAI,QAA2B,CAAC,EAAE,CAAC;QAE/C,IAAI,CAAC;YACH,uEAAuE;YACvE,8DAA8D;YAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAC3D,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;oBAClC,GAAG;oBACH,cAAc,EAAE,GAAG;oBACnB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;iBAC1B,CAAC,CAAC;gBACH,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAA0B,CAAC;gBACnF,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,iCAAiC,CAAC,CAAC;gBACrE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACrC,MAAM,CAAC,EAAE,CACP,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EACpB,iBAAiB,MAAM,4BAA4B,GAAG,CAAC,MAAM,UAAU,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAC7G,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,2DAA2D,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpG,CAAC;oBAAS,CAAC;gBACT,IAAI,WAAW,KAAK,SAAS;oBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,WAAW,CAAC;YAC1E,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,uEAAuE;IACvE,IAAI,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAChG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;YACjF,OAAO;QACT,CAAC;QACD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAEtG,MAAM,QAAQ,GAAG,sEAAsE,CAAC;QACxF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ;aACxD,IAAI,CAAC,iBAAiB,CAAC;aACvB,MAAM,CAAC;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;SAClB,CAAC;aACD,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,kBAAkB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAI,QAA2B,CAAC,EAAE,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAC3D,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC7F,uEAAuE;gBACvE,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAA0B,CAAC;gBACnG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACrC,MAAM,CAAC,EAAE,CACP,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EACpB,iBAAiB,MAAM,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CACzF,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,IAAI,WAAW,KAAK,SAAS;oBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,WAAW,CAAC;YAC1E,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAChG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;YACjF,OAAO;QACT,CAAC;QACD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAEtG,wEAAwE;QACxE,uEAAuE;QACvE,uDAAuD;QACvD,MAAM,QAAQ,GAAG,gEAAgE,CAAC;QAClF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ;aACxD,IAAI,CAAC,iBAAiB,CAAC;aACvB,MAAM,CAAC;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;SAClB,CAAC;aACD,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,kBAAkB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAI,QAA2B,CAAC,EAAE,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAC3D,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC7F,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAA0B,CAAC;gBACnH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACrC,MAAM,CAAC,EAAE,CACP,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EACpB,iBAAiB,MAAM,oCAAoC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CACjG,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,IAAI,WAAW,KAAK,SAAS;oBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,WAAW,CAAC;YAC1E,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,wDAAwD;AAExD,QAAQ,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACzE,IAAI,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAChG,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAE7C,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;YAChG,OAAO;QACT,CAAC;QAED,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC/D,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAExE,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE;YACtC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE;SACzD,CAAC,CAAC;QAEH,qBAAqB;QACrB,MAAM,QAAQ,GAAG,4EAA4E,CAAC;QAC9F,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ;aACxD,IAAI,CAAC,iBAAiB,CAAC;aACvB,MAAM,CAAC;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,YAAY;YACtB,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;SAClB,CAAC;aACD,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,kBAAkB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAI,QAA2B,CAAC,EAAE,CAAC;QAE/C,IAAI,CAAC;YACH,iBAAiB;YACjB,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;YACjD,MAAM,QAAQ;iBACX,IAAI,CAAC,iBAAiB,CAAC;iBACvB,MAAM,CAAC;gBACN,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;gBACxC,eAAe,EAAE,eAAe;gBAChC,oBAAoB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC/C,CAAC;iBACD,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAEpB,iEAAiE;YACjE,MAAM,KAAK,GAAG,kCAAkC,CAAC;YACjD,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;YAEnD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,CAC5D,sBAAsB,EACtB;gBACE,YAAY,EAAE,KAAK;gBACnB,eAAe,EAAE,cAAc;gBAC/B,WAAW,EAAE,CAAC;aACf,CACF,CAAC;YACF,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,yBAAyB,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YACrE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAC,CAAC;YAE7D,MAAM,GAAG,GAAI,OAAiC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC5B,iBAAiB,MAAM,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CACpE,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,uCAAuC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;gBAAS,CAAC;YACT,WAAW;YACX,MAAM,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/memory/agent.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Agent profile resolver for the MCP server.
+ *
+ * Calls the central UnClick API (admin_agent_resolve) to fetch the active
+ * agent's persona, scoped tools, and scoped memory layers. When no agent
+ * exists for the user, returns null and the server falls back to default
+ * behaviour (all tools, all memory layers).
+ */
+export type MemoryLayerKey = "business_context" | "extracted_facts" | "session_summaries" | "knowledge_library" | "conversation_log" | "code_dumps";
+export interface AgentProfile {
+    id: string;
+    name: string;
+    slug: string;
+    role: string;
+    description: string | null;
+    system_prompt: string | null;
+    is_default: boolean;
+}
+export interface ResolvedAgent {
+    agent: AgentProfile;
+    enabled_tools: string[];
+    enabled_memory_layers: MemoryLayerKey[];
+}
+export declare function resolveAgent(opts: {
+    agent_slug?: string;
+    agent_id?: string;
+}): Promise<ResolvedAgent | null>;
+/**
+ * Strip memory layer keys from a startup-context response that the active
+ * agent isn't allowed to see. When enabledLayers is empty we treat that as
+ * "all layers" (backward compatible default).
+ */
+export declare function filterContextByLayers(context: unknown, enabledLayers: MemoryLayerKey[]): unknown;
+//# sourceMappingURL=agent.d.ts.map

package/dist/memory/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/memory/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB,EAAE,cAAc,EAAE,CAAC;CACzC;AAQD,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAoChC;AAWD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,cAAc,EAAE,GAC9B,OAAO,CAQT"}

package/dist/memory/agent.js

@@ -0,0 +1,69 @@
+/**
+ * Agent profile resolver for the MCP server.
+ *
+ * Calls the central UnClick API (admin_agent_resolve) to fetch the active
+ * agent's persona, scoped tools, and scoped memory layers. When no agent
+ * exists for the user, returns null and the server falls back to default
+ * behaviour (all tools, all memory layers).
+ */
+const MEMORY_API_BASE = process.env.UNCLICK_MEMORY_BASE_URL || process.env.UNCLICK_SITE_URL || "https://unclick.world";
+export async function resolveAgent(opts) {
+    const apiKey = process.env.UNCLICK_API_KEY;
+    if (!apiKey)
+        return null;
+    const params = new URLSearchParams();
+    if (opts.agent_slug)
+        params.set("agent_slug", opts.agent_slug);
+    if (opts.agent_id)
+        params.set("agent_id", opts.agent_id);
+    const qs = params.toString();
+    const url = `${MEMORY_API_BASE}/api/memory-admin?action=admin_agent_resolve${qs ? `&${qs}` : ""}`;
+    try {
+        const res = await fetch(url, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        if (!data.agent)
+            return null;
+        const enabledTools = (data.tools ?? [])
+            .filter((t) => t.is_enabled)
+            .map((t) => t.connector_id);
+        const enabledLayers = (data.memory_scope ?? [])
+            .filter((l) => l.is_enabled)
+            .map((l) => l.memory_layer);
+        return {
+            agent: data.agent,
+            enabled_tools: enabledTools,
+            enabled_memory_layers: enabledLayers,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+const ALL_LAYERS = [
+    "business_context",
+    "extracted_facts",
+    "session_summaries",
+    "knowledge_library",
+    "conversation_log",
+    "code_dumps",
+];
+/**
+ * Strip memory layer keys from a startup-context response that the active
+ * agent isn't allowed to see. When enabledLayers is empty we treat that as
+ * "all layers" (backward compatible default).
+ */
+export function filterContextByLayers(context, enabledLayers) {
+    if (enabledLayers.length === 0 || !context || typeof context !== "object")
+        return context;
+    const blocked = ALL_LAYERS.filter((l) => !enabledLayers.includes(l));
+    const out = { ...context };
+    for (const layer of blocked) {
+        delete out[layer];
+    }
+    return out;
+}
+//# sourceMappingURL=agent.js.map

package/dist/memory/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/memory/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,eAAe,GACnB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;AAgCjG,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAGlC;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,IAAI,CAAC,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,GAAG,eAAe,+CAC5B,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAClB,EAAE,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;SAC/C,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAE7B,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;aACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAE9B,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;aAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAA8B,CAAC,CAAC;QAEhD,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,YAAY;YAC3B,qBAAqB,EAAE,aAAa;SACrC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAqB;IACnC,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,YAAY;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,aAA+B;IAE/B,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC1F,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,GAAG,GAA4B,EAAE,GAAI,OAAmC,EAAE,CAAC;IACjF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}