@unclick/mcp-server 0.3.0 → 0.3.1

package/dist/memory/session-state.js

@@ -0,0 +1,82 @@
+/**
+ * Session state tracker for the UnClick MCP server.
+ *
+ * Records per-process state about the current MCP session so we can
+ * answer "did startup context actually get loaded, and how?". Populated
+ * by hooks in server.ts (Initialize, GetPrompt, ReadResource, CallTool)
+ * and flushed to memory_load_events by load-events.ts.
+ */
+function randomSessionId() {
+    return `sess_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+export const sessionState = {
+    sessionId: randomSessionId(),
+    clientInfo: null,
+    instructionsSent: false,
+    contextLoaded: false,
+    contextLoadMethod: null,
+    promptUsed: false,
+    resourcesRead: [],
+    firstToolCall: null,
+    toolsCalledBeforeContext: 0,
+    sessionStart: new Date(),
+    logged: false,
+};
+export function setClientInfo(info) {
+    if (!info)
+        return;
+    sessionState.clientInfo = {
+        name: info.name ?? "unknown",
+        version: info.version ?? "unknown",
+    };
+}
+export function setInstructionsSent(sent) {
+    sessionState.instructionsSent = sent;
+}
+export function markPromptUsed(name) {
+    if (name === "load-memory" || name === "load_memory") {
+        sessionState.promptUsed = true;
+        if (!sessionState.contextLoaded) {
+            sessionState.contextLoaded = true;
+            sessionState.contextLoadMethod = "prompt";
+        }
+    }
+}
+export function markResourceRead(uri) {
+    if (!uri)
+        return;
+    if (!sessionState.resourcesRead.includes(uri)) {
+        sessionState.resourcesRead.push(uri);
+    }
+    if (uri.startsWith("memory://") && !sessionState.contextLoaded) {
+        sessionState.contextLoaded = true;
+        sessionState.contextLoadMethod = "resource";
+    }
+}
+export function markContextLoaded(method) {
+    if (sessionState.contextLoaded)
+        return;
+    sessionState.contextLoaded = true;
+    sessionState.contextLoadMethod = method;
+}
+export function recordToolCall(name) {
+    if (!sessionState.firstToolCall) {
+        sessionState.firstToolCall = name;
+    }
+    // Treat get_startup_context itself as the "loaded via tool_description" path.
+    if (name === "get_startup_context") {
+        if (!sessionState.contextLoaded) {
+            sessionState.contextLoaded = true;
+            sessionState.contextLoadMethod =
+                sessionState.contextLoadMethod ?? "tool_description";
+        }
+        return;
+    }
+    if (!sessionState.contextLoaded) {
+        sessionState.toolsCalledBeforeContext += 1;
+    }
+}
+export function snapshotSessionState() {
+    return { ...sessionState, resourcesRead: [...sessionState.resourcesRead] };
+}
+//# sourceMappingURL=session-state.js.map

package/dist/memory/session-state.js.map

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

package/dist/memory/supabase.d.ts

@@ -1,14 +1,78 @@
 /**
  * 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.
+ * Two tenancy modes:
+ *
+ *   BYOD     - data lives in the user's own Supabase project. Single-tenant
+ *              tables (business_context, extracted_facts, ...) and the
+ *              original RPC names. This is what the wizard (memory-admin
+ *              setup) installs into a user's Supabase.
+ *
+ *   managed  - data lives in UnClick's central Supabase. Multi-tenant
+ *              tables (mc_business_context, mc_extracted_facts, ...) where
+ *              every row is tagged with api_key_hash. RPCs are mc_-prefixed
+ *              and take p_api_key_hash as their first parameter. The backend
+ *              is responsible for filtering / inserting api_key_hash on
+ *              every operation.
  */
-import type { MemoryBackend, SessionSummaryInput, FactInput, ConversationInput, CodeInput, LibraryDocInput } from "./types.js";
+import type { MemoryBackend, SessionSummaryInput, FactInput, InvalidateFactInput, ConversationInput, CodeInput, LibraryDocInput } from "./types.js";
+export type Tenancy = {
+    mode: "byod";
+} | {
+    mode: "managed";
+    apiKeyHash: string;
+};
+export interface SupabaseBackendConfig {
+    url: string;
+    serviceRoleKey: string;
+    tenancy: Tenancy;
+}
+export declare const FREE_TIER_CAPS: {
+    readonly storage_bytes: number;
+    readonly facts: 5000;
+};
+/**
+ * Thrown when a free-tier user tries to write past their cap. The MCP
+ * handlers surface the message verbatim back to the agent so the user
+ * sees an actionable upgrade path.
+ */
+export declare class CapExceededError extends Error {
+    constructor(message: string);
+}
 export declare class SupabaseBackend implements MemoryBackend {
-    constructor();
+    private client;
+    private tenancy;
+    private tables;
+    constructor(config: SupabaseBackendConfig);
+    /** Adds api_key_hash to a row in managed mode; passes through in BYOD. */
+    private withTenancy;
+    /**
+     * Enforce free-tier caps on writes. Only runs in managed cloud mode.
+     * BYOD users own their database, so caps don't apply. Pro tier (or any
+     * non-free tier) skips the check.
+     *
+     * `kind` selects which cap to check first. Storage is always verified;
+     * `kind: "fact"` additionally verifies the fact-count cap because
+     * extracted_facts has a separate row count limit.
+     */
+    private enforceCaps;
+    /** Calls an RPC, choosing the BYOD or managed name based on tenancy. */
+    private rpc;
     getStartupContext(numSessions: number): Promise<unknown>;
-    searchMemory(query: string, maxResults: number): Promise<unknown>;
+    searchMemory(query: string, maxResults: number, asOf?: string): Promise<unknown>;
+    /**
+     * ILIKE-based keyword fallback over mc_extracted_facts +
+     * mc_session_summaries. Used when hybrid retrieval returns []. Returns
+     * rows shaped to mirror mc_search_memory_hybrid so callers don't branch.
+     * Never widens RLS: tenant scoping via api_key_hash is preserved.
+     *
+     * Phrase support: the query is tokenized on whitespace. Tokens shorter
+     * than 2 chars or containing PostgREST .or() metacharacters are dropped.
+     * We try AND-of-tokens first (every token must appear, in any order); if
+     * that returns nothing we degrade to OR-of-tokens and rank rows by how
+     * many tokens they contain so partial matches at least surface something.
+     */
+    private keywordFallback;
     searchFacts(query: string): Promise<unknown>;
     searchLibrary(query: string): Promise<unknown>;
     getLibraryDoc(slug: string): Promise<unknown>;
@@ -19,6 +83,12 @@ export declare class SupabaseBackend implements MemoryBackend {
     addFact(data: FactInput): Promise<{
         id: string;
     }>;
+    private embedAndStore;
+    private saveBlob;
+    private writeFactAudit;
+    invalidateFact(input: InvalidateFactInput): Promise<{
+        invalidated_at: string;
+    }>;
     supersedeFact(oldId: string, newText: string, category?: string, confidence?: number): Promise<string>;
     logConversation(data: ConversationInput): Promise<void>;
     getConversationDetail(sessionId: string): Promise<unknown>;

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

@@ -1 +1 @@
-{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/memory/supabase.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,eAAe,EAChB,MAAM,YAAY,CAAC;AAuCpB,qBAAa,eAAgB,YAAW,aAAa;;IAO7C,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAevE,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBjD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQtG,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAanD,kBAAkB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOxC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnG,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCxD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAe1C"}
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/memory/supabase.ts"],"names":[],"mappings":"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"}