@unclick/mcp-server 0.2.5 → 0.3.0

package/dist/memory/supabase.js

@@ -0,0 +1,209 @@
+/**
+ * Supabase backend for UnClick Memory.
+ *
+ * Cloud mode: data lives in the user's own Supabase project (BYOD).
+ * Requires SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY env vars.
+ */
+import { createClient } from "@supabase/supabase-js";
+let client = null;
+function getSupabase() {
+    if (client)
+        return client;
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY;
+    if (!url || !key) {
+        throw new Error("Missing SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY (or SUPABASE_ANON_KEY) environment variables. " +
+            "Set these in your MCP config's env block.");
+    }
+    client = createClient(url, key, {
+        auth: { persistSession: false, autoRefreshToken: false },
+    });
+    return client;
+}
+async function rpc(fn, params = {}) {
+    const sb = getSupabase();
+    const { data, error } = await sb.rpc(fn, params);
+    if (error)
+        throw new Error(`rpc(${fn}) failed: ${error.message}`);
+    return data;
+}
+function now() {
+    return new Date().toISOString();
+}
+function truncate(s, max = 8000) {
+    return s.length > max ? s.slice(0, max) + "\n...[truncated]" : s;
+}
+export class SupabaseBackend {
+    constructor() {
+        // Verify connection on creation
+        getSupabase();
+        console.error("UnClick Memory: Supabase cloud mode");
+    }
+    async getStartupContext(numSessions) {
+        return rpc("get_startup_context", { num_sessions: numSessions });
+    }
+    async searchMemory(query, maxResults) {
+        return rpc("search_memory", { search_query: query, max_results: maxResults });
+    }
+    async searchFacts(query) {
+        return rpc("search_facts", { search_query: query });
+    }
+    async searchLibrary(query) {
+        return rpc("search_library", { search_query: query });
+    }
+    async getLibraryDoc(slug) {
+        return rpc("get_library_doc", { doc_slug: slug });
+    }
+    async listLibrary() {
+        return rpc("list_library");
+    }
+    async writeSessionSummary(data) {
+        const sb = getSupabase();
+        const { data: row, error } = await sb.from("session_summaries").insert({
+            session_id: data.session_id,
+            summary: data.summary,
+            topics: data.topics,
+            open_loops: data.open_loops,
+            decisions: data.decisions,
+            platform: data.platform,
+            duration_minutes: data.duration_minutes,
+        }).select().single();
+        if (error)
+            throw error;
+        return { id: row.id };
+    }
+    async addFact(data) {
+        const sb = getSupabase();
+        const { data: row, error } = await sb.from("extracted_facts").insert({
+            fact: data.fact,
+            category: data.category,
+            confidence: data.confidence,
+            source_session_id: data.source_session_id ?? null,
+            source_type: "manual",
+            status: "active",
+            decay_tier: "hot",
+            last_accessed: now(),
+        }).select().single();
+        if (error)
+            throw error;
+        return { id: row.id };
+    }
+    async supersedeFact(oldId, newText, category, confidence) {
+        const params = { old_fact_id: oldId, new_fact_text: newText };
+        if (category !== undefined)
+            params.new_category = category;
+        if (confidence !== undefined)
+            params.new_confidence = confidence;
+        const data = await rpc("supersede_fact", params);
+        return String(data);
+    }
+    async logConversation(data) {
+        const sb = getSupabase();
+        const { error } = await sb.from("conversation_log").insert({
+            session_id: data.session_id,
+            role: data.role,
+            content: truncate(data.content),
+            has_code: data.has_code,
+        });
+        if (error)
+            throw error;
+    }
+    async getConversationDetail(sessionId) {
+        return rpc("get_conversation_detail", { sid: sessionId });
+    }
+    async storeCode(data) {
+        const sb = getSupabase();
+        const { data: row, error } = await sb.from("code_dumps").insert({
+            session_id: data.session_id,
+            language: data.language,
+            filename: data.filename ?? null,
+            content: truncate(data.content, 50000),
+            description: data.description ?? null,
+        }).select().single();
+        if (error)
+            throw error;
+        return { id: row.id };
+    }
+    async getBusinessContext() {
+        const sb = getSupabase();
+        const { data, error } = await sb.from("business_context").select("*").order("category").order("key");
+        if (error)
+            throw error;
+        return data ?? [];
+    }
+    async setBusinessContext(category, key, value, priority) {
+        const sb = getSupabase();
+        const row = {
+            category,
+            key,
+            value: typeof value === "string" ? (() => { try {
+                return JSON.parse(value);
+            }
+            catch {
+                return value;
+            } })() : value,
+            last_accessed: now(),
+            decay_tier: "hot",
+        };
+        if (priority !== undefined)
+            row.priority = priority;
+        const { error } = await sb.from("business_context")
+            .upsert(row, { onConflict: "category,key" })
+            .select().single();
+        if (error)
+            throw error;
+    }
+    async upsertLibraryDoc(data) {
+        const sb = getSupabase();
+        const { data: existing } = await sb.from("knowledge_library")
+            .select("id, version").eq("slug", data.slug).single();
+        if (existing) {
+            // DB trigger auto-archives old content and bumps version
+            const { error } = await sb.from("knowledge_library").update({
+                title: data.title,
+                category: data.category,
+                content: data.content,
+                tags: data.tags,
+                last_accessed: now(),
+                decay_tier: "hot",
+            }).eq("id", existing.id);
+            if (error)
+                throw error;
+            return `Library doc updated: "${data.title}" (v${existing.version + 1})`;
+        }
+        else {
+            const { error } = await sb.from("knowledge_library").insert({
+                slug: data.slug,
+                title: data.title,
+                category: data.category,
+                content: data.content,
+                tags: data.tags,
+                version: 1,
+                decay_tier: "hot",
+                last_accessed: now(),
+            });
+            if (error)
+                throw error;
+            return `Library doc created: "${data.title}" (v1)`;
+        }
+    }
+    async manageDecay() {
+        return rpc("manage_decay");
+    }
+    async getMemoryStatus() {
+        const sb = getSupabase();
+        const tables = ["business_context", "knowledge_library", "session_summaries", "extracted_facts", "conversation_log", "code_dumps"];
+        const counts = {};
+        for (const table of tables) {
+            const { count } = await sb.from(table).select("*", { count: "exact", head: true });
+            counts[table] = count;
+        }
+        const { data: factTiers } = await sb.from("extracted_facts").select("decay_tier").eq("status", "active");
+        const tiers = { hot: 0, warm: 0, cold: 0 };
+        for (const row of factTiers ?? []) {
+            tiers[row.decay_tier]++;
+        }
+        return { mode: "supabase", table_counts: counts, fact_decay_tiers: tiers };
+    }
+}
+//# sourceMappingURL=supabase.js.map

package/dist/memory/supabase.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Shared types for UnClick Memory backends (local + Supabase).
+ */
+export interface SessionSummaryInput {
+    session_id: string;
+    summary: string;
+    topics: string[];
+    open_loops: string[];
+    decisions: string[];
+    platform: string;
+    duration_minutes?: number;
+}
+export interface FactInput {
+    fact: string;
+    category: string;
+    confidence: number;
+    source_session_id?: string;
+}
+export interface ConversationInput {
+    session_id: string;
+    role: string;
+    content: string;
+    has_code: boolean;
+}
+export interface CodeInput {
+    session_id: string;
+    language: string;
+    filename?: string;
+    content: string;
+    description?: string;
+}
+export interface LibraryDocInput {
+    slug: string;
+    title: string;
+    category: string;
+    content: string;
+    tags: string[];
+}
+export interface MemoryBackend {
+    /** Load startup context (business context + recent sessions + hot facts). */
+    getStartupContext(numSessions: number): Promise<unknown>;
+    /** Full-text search across conversation logs. */
+    searchMemory(query: string, maxResults: number): Promise<unknown>;
+    /** Search extracted facts. */
+    searchFacts(query: string): Promise<unknown>;
+    /** Search knowledge library. */
+    searchLibrary(query: string): Promise<unknown>;
+    /** Get a specific library doc by slug. */
+    getLibraryDoc(slug: string): Promise<unknown>;
+    /** List all library documents. */
+    listLibrary(): Promise<unknown>;
+    /** Write end-of-session summary. */
+    writeSessionSummary(data: SessionSummaryInput): Promise<{
+        id: string;
+    }>;
+    /** Add an extracted fact. */
+    addFact(data: FactInput): Promise<{
+        id: string;
+    }>;
+    /** Replace a fact with a new version. */
+    supersedeFact(oldId: string, newText: string, category?: string, confidence?: number): Promise<string>;
+    /** Log a conversation message. */
+    logConversation(data: ConversationInput): Promise<void>;
+    /** Get full conversation log for a session. */
+    getConversationDetail(sessionId: string): Promise<unknown>;
+    /** Store a code block. */
+    storeCode(data: CodeInput): Promise<{
+        id: string;
+    }>;
+    /** Get all business context entries. */
+    getBusinessContext(): Promise<unknown[]>;
+    /** Set or update a business context entry. */
+    setBusinessContext(category: string, key: string, value: unknown, priority?: number): Promise<void>;
+    /** Create or update a knowledge library doc. */
+    upsertLibraryDoc(data: LibraryDocInput): Promise<string>;
+    /** Run memory decay management. */
+    manageDecay(): Promise<unknown>;
+    /** Get memory usage stats. */
+    getMemoryStatus(): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/memory/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for UnClick Memory backends (local + Supabase).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/monday-tool.js

@@ -39,13 +39,13 @@ export async function listMondayBoards(args) {
     try {
         const apiKey = getApiKey(args);
         const limit = Number(args.limit ?? 25);
-        const query = `
-      query($limit: Int) {
-        boards(limit: $limit) {
-          id name description state board_kind
-          columns { id title type }
-        }
-      }
+        const query = `
+      query($limit: Int) {
+        boards(limit: $limit) {
+          id name description state board_kind
+          columns { id title type }
+        }
+      }
     `;
         const data = await mondayQuery(apiKey, query, { limit });
         const boards = (data.boards ?? []);
@@ -62,14 +62,14 @@ export async function getMondayBoard(args) {
         const boardId = String(args.board_id ?? "").trim();
         if (!boardId)
             return { error: "board_id is required." };
-        const query = `
-      query($ids: [ID!]) {
-        boards(ids: $ids) {
-          id name description state board_kind
-          columns { id title type }
-          groups { id title color }
-        }
-      }
+        const query = `
+      query($ids: [ID!]) {
+        boards(ids: $ids) {
+          id name description state board_kind
+          columns { id title type }
+          groups { id title color }
+        }
+      }
     `;
         const data = await mondayQuery(apiKey, query, { ids: [boardId] });
         const boards = (data.boards ?? []);
@@ -87,18 +87,18 @@ export async function listMondayItems(args) {
         if (!boardId)
             return { error: "board_id is required." };
         const limit = Number(args.limit ?? 50);
-        const query = `
-      query($ids: [ID!], $limit: Int) {
-        boards(ids: $ids) {
-          items_page(limit: $limit) {
-            items {
-              id name state created_at updated_at
-              column_values { id text value }
-              group { id title }
-            }
-          }
-        }
-      }
+        const query = `
+      query($ids: [ID!], $limit: Int) {
+        boards(ids: $ids) {
+          items_page(limit: $limit) {
+            items {
+              id name state created_at updated_at
+              column_values { id text value }
+              group { id title }
+            }
+          }
+        }
+      }
     `;
         const data = await mondayQuery(apiKey, query, { ids: [boardId], limit });
         const boards = (data.boards ?? []);
@@ -120,12 +120,12 @@ export async function createMondayItem(args) {
         const itemName = String(args.item_name ?? "").trim();
         if (!itemName)
             return { error: "item_name is required." };
-        const mutation = `
-      mutation($board_id: ID!, $item_name: String!, $group_id: String, $column_values: JSON) {
-        create_item(board_id: $board_id, item_name: $item_name, group_id: $group_id, column_values: $column_values) {
-          id name state created_at
-        }
-      }
+        const mutation = `
+      mutation($board_id: ID!, $item_name: String!, $group_id: String, $column_values: JSON) {
+        create_item(board_id: $board_id, item_name: $item_name, group_id: $group_id, column_values: $column_values) {
+          id name state created_at
+        }
+      }
     `;
         const variables = { board_id: boardId, item_name: itemName };
         if (args.group_id)
@@ -157,12 +157,12 @@ export async function updateMondayItem(args) {
         const value = args.value;
         if (value === undefined)
             return { error: "value is required." };
-        const mutation = `
-      mutation($board_id: ID!, $item_id: ID!, $column_id: String!, $value: JSON!) {
-        change_column_value(board_id: $board_id, item_id: $item_id, column_id: $column_id, value: $value) {
-          id name
-        }
-      }
+        const mutation = `
+      mutation($board_id: ID!, $item_id: ID!, $column_id: String!, $value: JSON!) {
+        change_column_value(board_id: $board_id, item_id: $item_id, column_id: $column_id, value: $value) {
+          id name
+        }
+      }
     `;
         const data = await mondayQuery(apiKey, mutation, {
             board_id: boardId,
@@ -187,13 +187,13 @@ export async function searchMondayItems(args) {
         if (!query_text)
             return { error: "query is required." };
         const limit = Number(args.limit ?? 25);
-        const query = `
-      query($board_id: ID!, $query: String!, $limit: Int) {
-        items_by_multiple_column_values(board_id: $board_id, limit: $limit, column_id: "name", column_values: [$query]) {
-          id name state created_at updated_at
-          column_values { id text value }
-        }
-      }
+        const query = `
+      query($board_id: ID!, $query: String!, $limit: Int) {
+        items_by_multiple_column_values(board_id: $board_id, limit: $limit, column_id: "name", column_values: [$query]) {
+          id name state created_at updated_at
+          column_values { id text value }
+        }
+      }
     `;
         const data = await mondayQuery(apiKey, query, { board_id: boardId, query: query_text, limit });
         const items = (data.items_by_multiple_column_values ?? []);

package/dist/musicbrainz-tool.js

@@ -2,7 +2,7 @@
 // Uses the MusicBrainz REST API via fetch - no external dependencies.
 // No auth required. Identifies with a User-Agent header as required by MusicBrainz policy.
 const MB_BASE = "https://musicbrainz.org/ws/2";
-const MB_USER_AGENT = "UnClick/1.0 (creativelead@malamutemayhem.com)";
+const MB_USER_AGENT = "UnClick/1.0 (support@unclick.world)";
 // ─── API helper ───────────────────────────────────────────────────────────────
 async function mbCall(path, params = {}) {
     const url = new URL(`${MB_BASE}${path}`);

package/dist/musicbrainz-tool.js.map

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

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA6fnE,wBAAgB,YAAY,IAAI,MAAM,CAuNrC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA8lBnE,wBAAgB,YAAY,IAAI,MAAM,CAqPrC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD"}

package/dist/server.js

@@ -5,6 +5,7 @@ import { CATALOG, TOOL_MAP, ENDPOINT_MAP } from "./catalog.js";
 import { createClient } from "./client.js";
 import { ADDITIONAL_HANDLERS } from "./tool-wiring.js";
 import { LOCAL_CATALOG_HANDLERS } from "./local-catalog-handlers.js";
+import { MEMORY_HANDLERS } from "./memory/handlers.js";
 // ─── Search helper ──────────────────────────────────────────────────────────
 function searchTools(query, category) {
     const q = query.toLowerCase();
@@ -105,6 +106,97 @@ const META_TOOLS = [
             required: ["endpoint_id", "params"],
         },
     },
+    // ── UnClick Memory (persistent cross-session memory) ─────────────────────
+    // These 5 tools implement the session-start / session-end protocol agents
+    // should follow. The other 12 memory operations are available via unclick_call
+    // with endpoint_id like "memory.add_fact", "memory.search_memory", etc.
+    {
+        name: "get_startup_context",
+        description: "Load persistent UnClick Memory at session start. Returns business context (standing rules), " +
+            "recent session summaries, and hot facts. Call this FIRST in every new session to understand " +
+            "the user's ongoing projects, preferences, and open loops. Works zero-config locally, or with " +
+            "Supabase for cross-machine sync.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                num_sessions: {
+                    type: "number",
+                    description: "Number of recent session summaries to load (1-20, default 5)",
+                    default: 5,
+                },
+            },
+        },
+    },
+    {
+        name: "write_session_summary",
+        description: "Write a session summary at the end of a session. Critical for cross-session continuity. " +
+            "Call this BEFORE the session ends (when the user says goodbye, or context is running low). " +
+            "Include key decisions, open loops, and topics discussed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Unique session identifier (timestamp or UUID)" },
+                summary: { type: "string", description: "Narrative of what happened - decisions, work completed, problems solved" },
+                topics: { type: "array", items: { type: "string" }, description: "Topic tags for searchability" },
+                open_loops: { type: "array", items: { type: "string" }, description: "Unfinished tasks or questions to carry forward" },
+                decisions: { type: "array", items: { type: "string" }, description: "Key decisions made during the session" },
+                platform: { type: "string", description: "Platform this session ran on", default: "claude-code" },
+                duration_minutes: { type: "number", description: "Approximate session duration" },
+            },
+            required: ["session_id", "summary"],
+        },
+    },
+    {
+        name: "add_fact",
+        description: "Add a new atomic fact to UnClick Memory. One fact = one statement. " +
+            "Use when the user states a preference, makes a decision, or shares important info. " +
+            "Good: 'Team prefers Tailwind over CSS modules'. Bad: 'We talked about styling'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                fact: { type: "string", description: "The fact - a single atomic statement" },
+                category: {
+                    type: "string",
+                    description: "Category: preference, decision, technical, contact, project, general",
+                    default: "general",
+                },
+                confidence: { type: "number", minimum: 0, maximum: 1, default: 0.9 },
+                source_session_id: { type: "string", description: "Session ID where this fact was learned" },
+            },
+            required: ["fact"],
+        },
+    },
+    {
+        name: "search_memory",
+        description: "Full-text search across UnClick Memory conversation logs. Use when you need to recall " +
+            "something specific from a previous session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                max_results: { type: "number", minimum: 1, maximum: 50, default: 10 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "set_business_context",
+        description: "Add or update a standing rule in UnClick Memory (Layer 1). Business context is ALWAYS loaded " +
+            "at session start. Use for standing rules, client info, and preferences that are always relevant.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    description: "Category: identity, preference, client, workflow, technical, standing_rule",
+                },
+                key: { type: "string", description: "Unique key within category (e.g. 'timezone', 'preferred_stack')" },
+                value: { type: "string", description: "The value to store (plain text or JSON string)" },
+                priority: { type: "number", description: "Priority for loading order (higher = loaded first)" },
+            },
+            required: ["category", "key", "value"],
+        },
+    },
 ];
 const DIRECT_TOOLS = [
     {
@@ -468,6 +560,13 @@ export function createServer() {
         const { name, arguments: rawArgs } = request.params;
         const args = (rawArgs ?? {});
         try {
+            // ── UnClick Memory (direct tools + memory.* endpoints) ───────
+            if (MEMORY_HANDLERS[name]) {
+                const result = await MEMORY_HANDLERS[name](args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                };
+            }
             // ── Meta tools ──────────────────────────────────────────────
             if (name === "unclick_search") {
                 const results = searchTools(String(args.query ?? ""), args.category);
@@ -557,6 +656,17 @@ export function createServer() {
             if (name === "unclick_call") {
                 const endpointId = String(args.endpoint_id ?? "");
                 const params = (args.params ?? {});
+                // Memory endpoints: "memory.add_fact", "memory.store_code", etc.
+                if (endpointId.startsWith("memory.")) {
+                    const op = endpointId.slice("memory.".length);
+                    const memHandler = MEMORY_HANDLERS[op];
+                    if (memHandler) {
+                        const result = await memHandler(params);
+                        return {
+                            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                        };
+                    }
+                }
                 // Check local handlers first (avoids remote API dependency)
                 const localHandler = LOCAL_CATALOG_HANDLERS[endpointId];
                 if (localHandler) {
@@ -577,6 +687,15 @@ export function createServer() {
                         isError: true,
                     };
                 }
+                // Try ADDITIONAL_HANDLERS via dot-to-underscore key conversion ("foo.bar" -> "foo_bar")
+                const handlerKey = endpointId.replace(/\./g, "_");
+                const additionalHandler = ADDITIONAL_HANDLERS[handlerKey];
+                if (additionalHandler) {
+                    const result = await additionalHandler(params);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    };
+                }
                 // Fall back to remote API for endpoints without local implementations
                 const client = createClient();
                 const result = await client.call(entry.endpoint.method, entry.endpoint.path, params);