@unclick/mcp-server 0.3.0 → 0.3.1

package/dist/memory/conflicts.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Conflict detection for UnClick Memory.
+ *
+ * Competing memory servers (Mem0, Zep, Hindsight, etc) running alongside
+ * UnClick cause duplicate facts and mixed-up responses. This module:
+ *
+ *   1. Exposes KNOWN_CONFLICTS - a static list of competing tools + how to
+ *      remove them on each major platform
+ *   2. detectConflicts(toolNames) - matches a list of tool names against the
+ *      known patterns and returns the conflict records that matched
+ *   3. buildConflictWarning(conflicts) - renders the friendly amber warning
+ *      that gets prepended to load_memory responses
+ *   4. reportConflictDetection(tool) - fire-and-forget logging to the admin
+ *      API so the admin panel can show conflict history
+ *
+ * All messaging follows the brand voice: "we noticed" / "we recommend",
+ * never "WARNING" or "You must".
+ */
+type RemoveInstructions = Record<string, string>;
+export interface ConflictDef {
+    name: string;
+    toolPatterns: string[];
+    removeInstructions: RemoveInstructions;
+}
+export declare const KNOWN_CONFLICTS: ConflictDef[];
+export declare function detectConflicts(toolNames: readonly string[]): ConflictDef[];
+/**
+ * Build the human-readable amber warning shown at the top of a load_memory
+ * response when conflicts are detected. Returns null when there are no
+ * conflicts.
+ *
+ * detectionCount lets us escalate tone if the same conflict has been flagged
+ * several times already. After 7+ silent detections we stop warning entirely
+ * (respect the user's choice).
+ */
+export declare function buildConflictWarning(conflicts: ConflictDef[], detectionCount?: number): string | null;
+interface ConflictReportResult {
+    shouldWarn: boolean;
+    detectionCount: number;
+}
+/**
+ * Log a conflict detection to the admin API and return whether we should
+ * actually surface a warning (throttled to once per 24h per tool per user).
+ * Fire-and-forget safe: if the API is unreachable we default to "warn once".
+ */
+export declare function reportConflictDetection(tool: string, platform?: string): Promise<ConflictReportResult>;
+export {};
+//# sourceMappingURL=conflicts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../src/memory/conflicts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAUD,eAAO,MAAM,eAAe,EAAE,WAAW,EA+DxC,CAAC;AAmBF,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,EAAE,CA2B3E;AAYD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,WAAW,EAAE,EACxB,cAAc,SAAI,GACjB,MAAM,GAAG,IAAI,CA2Bf;AAKD,UAAU,oBAAoB;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAwB/B"}

package/dist/memory/conflicts.js

@@ -0,0 +1,209 @@
+/**
+ * Conflict detection for UnClick Memory.
+ *
+ * Competing memory servers (Mem0, Zep, Hindsight, etc) running alongside
+ * UnClick cause duplicate facts and mixed-up responses. This module:
+ *
+ *   1. Exposes KNOWN_CONFLICTS - a static list of competing tools + how to
+ *      remove them on each major platform
+ *   2. detectConflicts(toolNames) - matches a list of tool names against the
+ *      known patterns and returns the conflict records that matched
+ *   3. buildConflictWarning(conflicts) - renders the friendly amber warning
+ *      that gets prepended to load_memory responses
+ *   4. reportConflictDetection(tool) - fire-and-forget logging to the admin
+ *      API so the admin panel can show conflict history
+ *
+ * All messaging follows the brand voice: "we noticed" / "we recommend",
+ * never "WARNING" or "You must".
+ */
+const GENERIC_REMOVE = {
+    "claude-code": "claude mcp remove <tool>",
+    cursor: "Settings > Tools & MCP > find the entry > remove",
+    windsurf: "Remove the entry from ~/.codeium/windsurf/mcp_config.json",
+    copilot: "Remove from VS Code settings.json MCP servers section",
+    chatgpt: "Settings > Tools > remove the entry",
+};
+export const KNOWN_CONFLICTS = [
+    {
+        name: "Mem0",
+        toolPatterns: ["add-memory", "search-memories", "add_memory", "search_memory_mem0"],
+        removeInstructions: {
+            "claude-code": "claude mcp remove mem0",
+            cursor: "Settings > Tools & MCP > find mem0 > remove",
+            windsurf: "Remove the mem0 entry from ~/.codeium/windsurf/mcp_config.json",
+            copilot: "Remove the mem0 block from VS Code settings.json",
+            chatgpt: "Settings > Tools > remove mem0",
+        },
+    },
+    {
+        name: "Zep",
+        toolPatterns: ["zep_memory", "graphiti_"],
+        removeInstructions: {
+            "claude-code": "claude mcp remove zep",
+            cursor: "Settings > Tools & MCP > find zep > remove",
+            windsurf: "Remove the zep entry from ~/.codeium/windsurf/mcp_config.json",
+            copilot: "Remove the zep block from VS Code settings.json",
+            chatgpt: "Settings > Tools > remove zep",
+        },
+    },
+    {
+        name: "Hindsight",
+        toolPatterns: ["hindsight_"],
+        removeInstructions: {
+            ...GENERIC_REMOVE,
+            "claude-code": "claude mcp remove hindsight",
+        },
+    },
+    {
+        name: "MemPalace",
+        toolPatterns: ["mempalace_"],
+        removeInstructions: {
+            ...GENERIC_REMOVE,
+            "claude-code": "claude mcp remove mempalace",
+        },
+    },
+    {
+        name: "mcp-memory-service",
+        toolPatterns: ["save_memory", "retrieve_memory", "search_memories"],
+        removeInstructions: {
+            ...GENERIC_REMOVE,
+            "claude-code": "claude mcp remove memory-service",
+        },
+    },
+    {
+        name: "Basic Memory",
+        toolPatterns: ["basic_memory_"],
+        removeInstructions: {
+            ...GENERIC_REMOVE,
+            "claude-code": "claude mcp remove basic-memory",
+        },
+    },
+    {
+        name: "LangMem",
+        toolPatterns: ["langmem_"],
+        removeInstructions: {
+            ...GENERIC_REMOVE,
+            "claude-code": "claude mcp remove langmem",
+        },
+    },
+];
+/**
+ * Match a list of tool names from the active MCP session against KNOWN_CONFLICTS.
+ * Tool names that don't match any known pattern are ignored silently - non-memory
+ * tools like GitHub, Slack, Exa, Playwright etc are safe to run alongside UnClick.
+ *
+ * UnClick's own tool names (prefixed with unclick_ or memory.) never trigger a
+ * match even if they happen to overlap a pattern.
+ */
+const UNCLICK_OWN_TOOLS = new Set([
+    "get_startup_context",
+    "write_session_summary",
+    "add_fact",
+    "search_memory",
+    "set_business_context",
+    "report_bug",
+]);
+export function detectConflicts(toolNames) {
+    if (!Array.isArray(toolNames) || toolNames.length === 0)
+        return [];
+    const names = toolNames
+        .map((n) => String(n ?? "").toLowerCase().trim())
+        .filter((n) => n.length > 0 &&
+        !n.startsWith("unclick_") &&
+        !n.startsWith("memory.") &&
+        !UNCLICK_OWN_TOOLS.has(n));
+    if (names.length === 0)
+        return [];
+    const matched = [];
+    const seen = new Set();
+    for (const conflict of KNOWN_CONFLICTS) {
+        const patterns = conflict.toolPatterns.map((p) => p.toLowerCase());
+        const hit = names.some((name) => patterns.some((p) => (p.endsWith("_") ? name.startsWith(p) : name === p || name.includes(p))));
+        if (hit && !seen.has(conflict.name)) {
+            matched.push(conflict);
+            seen.add(conflict.name);
+        }
+    }
+    return matched;
+}
+function formatRemoveInstructions(instr) {
+    const lines = [];
+    if (instr["claude-code"])
+        lines.push(`  - Claude Code: ${instr["claude-code"]}`);
+    if (instr.cursor)
+        lines.push(`  - Cursor: ${instr.cursor}`);
+    if (instr.windsurf)
+        lines.push(`  - Windsurf: ${instr.windsurf}`);
+    if (instr.copilot)
+        lines.push(`  - Copilot: ${instr.copilot}`);
+    if (instr.chatgpt)
+        lines.push(`  - ChatGPT: ${instr.chatgpt}`);
+    return lines.join("\n");
+}
+/**
+ * Build the human-readable amber warning shown at the top of a load_memory
+ * response when conflicts are detected. Returns null when there are no
+ * conflicts.
+ *
+ * detectionCount lets us escalate tone if the same conflict has been flagged
+ * several times already. After 7+ silent detections we stop warning entirely
+ * (respect the user's choice).
+ */
+export function buildConflictWarning(conflicts, detectionCount = 0) {
+    if (conflicts.length === 0)
+        return null;
+    if (detectionCount >= 7)
+        return null;
+    const names = conflicts.map((c) => c.name).join(", ");
+    const opener = detectionCount >= 3
+        ? `Heads up: ${names} is still connected alongside UnClick and this is still causing duplicates.`
+        : `Heads up: we noticed you also have ${names} connected.`;
+    const lines = [
+        opener,
+        "",
+        "Running two memory tools at the same time causes duplicate facts and mixed-up responses.",
+        `We recommend turning off ${names} so UnClick can give you the best experience.`,
+        "",
+        "Your other tools (GitHub, Exa, browser, file system, etc) are fine - they don't overlap with UnClick.",
+        "",
+    ];
+    for (const conflict of conflicts) {
+        lines.push(`To remove ${conflict.name}:`);
+        lines.push(formatRemoveInstructions(conflict.removeInstructions));
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+const CONFLICT_API_BASE = process.env.UNCLICK_MEMORY_BASE_URL || process.env.UNCLICK_SITE_URL || "https://unclick.world";
+/**
+ * Log a conflict detection to the admin API and return whether we should
+ * actually surface a warning (throttled to once per 24h per tool per user).
+ * Fire-and-forget safe: if the API is unreachable we default to "warn once".
+ */
+export async function reportConflictDetection(tool, platform) {
+    const apiKey = process.env.UNCLICK_API_KEY;
+    if (!apiKey) {
+        return { shouldWarn: true, detectionCount: 0 };
+    }
+    try {
+        const res = await fetch(`${CONFLICT_API_BASE}/api/memory-admin?action=conflict_detect`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({ tool, platform }),
+        });
+        if (!res.ok)
+            return { shouldWarn: true, detectionCount: 0 };
+        const data = (await res.json());
+        return {
+            shouldWarn: data.should_warn !== false,
+            detectionCount: typeof data.detection_count === "number" ? data.detection_count : 0,
+        };
+    }
+    catch {
+        return { shouldWarn: true, detectionCount: 0 };
+    }
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/memory/conflicts.js.map

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

package/dist/memory/db.d.ts

@@ -1,9 +1,24 @@
 /**
  * Backend factory for UnClick Memory.
  *
- * Auto-selects the right storage backend:
- *   - SUPABASE_URL set -> Supabase cloud mode (cross-machine sync)
- *   - Nothing set       -> Local JSON files (zero-config, instant start)
+ * Auto-selects the right storage backend per request. Precedence:
+ *
+ *   1. Validated /api/mcp request (UNCLICK_API_KEY + UNCLICK_API_KEY_HASH set):
+ *      a. memory_configs row exists for this hash -> BYOD (user's own Supabase,
+ *         single-tenant tables, decrypted via PBKDF2 from api_key)
+ *      b. no memory_configs row                   -> managed cloud (central
+ *         Supabase, mc_* tables, scoped by api_key_hash)
+ *
+ *   2. Standalone npm package, explicit BYOD via SUPABASE_URL env -> direct
+ *      Supabase, single-tenant tables.
+ *
+ *   3. Standalone npm package with UNCLICK_API_KEY only -> remote BYOD lookup,
+ *      falls through to local if not configured.
+ *
+ *   4. Local JSON files (zero-config) for the standalone npm package use case.
+ *
+ * Local JSON files are intentionally not available to /api/mcp serverless,
+ * because Vercel /tmp wipes between cold starts.
  */
 import type { MemoryBackend } from "./types.js";
 export declare function getBackend(): Promise<MemoryBackend>;

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

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/memory/db.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAYzD"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/memory/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyDhD,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAmBzD"}

package/dist/memory/db.js

@@ -1,22 +1,144 @@
 /**
  * Backend factory for UnClick Memory.
  *
- * Auto-selects the right storage backend:
- *   - SUPABASE_URL set -> Supabase cloud mode (cross-machine sync)
- *   - Nothing set       -> Local JSON files (zero-config, instant start)
+ * Auto-selects the right storage backend per request. Precedence:
+ *
+ *   1. Validated /api/mcp request (UNCLICK_API_KEY + UNCLICK_API_KEY_HASH set):
+ *      a. memory_configs row exists for this hash -> BYOD (user's own Supabase,
+ *         single-tenant tables, decrypted via PBKDF2 from api_key)
+ *      b. no memory_configs row                   -> managed cloud (central
+ *         Supabase, mc_* tables, scoped by api_key_hash)
+ *
+ *   2. Standalone npm package, explicit BYOD via SUPABASE_URL env -> direct
+ *      Supabase, single-tenant tables.
+ *
+ *   3. Standalone npm package with UNCLICK_API_KEY only -> remote BYOD lookup,
+ *      falls through to local if not configured.
+ *
+ *   4. Local JSON files (zero-config) for the standalone npm package use case.
+ *
+ * Local JSON files are intentionally not available to /api/mcp serverless,
+ * because Vercel /tmp wipes between cold starts.
  */
-let backend = null;
+// Capture the central Supabase env at module load time, before any request
+// flow could mutate it. These point at UnClick's central Supabase project
+// which hosts api_keys + memory_configs + the mc_* managed cloud memory tables.
+const CENTRAL_SUPABASE_URL = process.env.SUPABASE_URL;
+const CENTRAL_SUPABASE_KEY = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY;
+// The memory admin endpoints live on the main site, not the tool-calling API.
+const MEMORY_API_BASE = process.env.UNCLICK_MEMORY_BASE_URL ||
+    process.env.UNCLICK_SITE_URL ||
+    "https://unclick.world";
+async function fetchByodConfig(apiKey) {
+    try {
+        const res = await fetch(`${MEMORY_API_BASE}/api/memory-admin?action=config`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        if (!data.configured || !data.supabase_url || !data.service_role_key) {
+            return null;
+        }
+        return {
+            supabase_url: data.supabase_url,
+            service_role_key: data.service_role_key,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// Per-tenant backend cache. Keyed so different api_keys never share a backend.
+// In serverless this lives only for the lifetime of a warm instance, which is
+// the right scope. In long-lived standalone use, the cache key is constant.
+//
+// TODO(phase-1+): bound this with an LRU if a single warm instance ever serves
+// thousands of tenants. For Phase 1 the unbounded map is fine.
+const backendCache = new Map();
+function instanceKey() {
+    const hash = process.env.UNCLICK_API_KEY_HASH;
+    if (hash)
+        return `mc:${hash}`;
+    if (process.env.SUPABASE_URL)
+        return `byod-explicit:${process.env.SUPABASE_URL}`;
+    if (process.env.UNCLICK_API_KEY)
+        return `byod-remote:${process.env.UNCLICK_API_KEY}`;
+    return "local";
+}
 export async function getBackend() {
-    if (backend)
-        return backend;
+    const key = instanceKey();
+    const cached = backendCache.get(key);
+    if (cached)
+        return cached;
+    const backend = await buildBackend();
+    backendCache.set(key, backend);
+    // Fire-and-forget device heartbeat (never blocks startup). Mode label is
+    // a hint for the heartbeat endpoint; it still classifies as cloud or local.
+    if (process.env.UNCLICK_API_KEY) {
+        const mode = backend.constructor.name === "LocalBackend" ? "local" : "cloud";
+        import("./device.js")
+            .then(({ sendDeviceHeartbeat }) => sendDeviceHeartbeat(mode))
+            .catch(() => { });
+    }
+    return backend;
+}
+async function buildBackend() {
+    const apiKey = process.env.UNCLICK_API_KEY;
+    const apiKeyHash = process.env.UNCLICK_API_KEY_HASH;
+    // ── 1. Validated /api/mcp request ─────────────────────────────────────
+    if (apiKey && apiKeyHash) {
+        // 1a. BYOD: user has set up their own Supabase via the wizard.
+        const byod = await fetchByodConfig(apiKey);
+        if (byod) {
+            const { SupabaseBackend } = await import("./supabase.js");
+            return new SupabaseBackend({
+                url: byod.supabase_url,
+                serviceRoleKey: byod.service_role_key,
+                tenancy: { mode: "byod" },
+            });
+        }
+        // 1b. Managed cloud: central Supabase, scoped by api_key_hash.
+        if (!CENTRAL_SUPABASE_URL || !CENTRAL_SUPABASE_KEY) {
+            throw new Error("Managed cloud memory unavailable: central Supabase env (SUPABASE_URL, " +
+                "SUPABASE_SERVICE_ROLE_KEY) not configured on the server.");
+        }
+        const { SupabaseBackend } = await import("./supabase.js");
+        return new SupabaseBackend({
+            url: CENTRAL_SUPABASE_URL,
+            serviceRoleKey: CENTRAL_SUPABASE_KEY,
+            tenancy: { mode: "managed", apiKeyHash },
+        });
+    }
+    // ── 2. Standalone: explicit BYOD via SUPABASE_URL env ─────────────────
     if (process.env.SUPABASE_URL) {
+        const url = process.env.SUPABASE_URL;
+        const serviceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY;
+        if (!serviceRoleKey) {
+            throw new Error("SUPABASE_URL is set but SUPABASE_SERVICE_ROLE_KEY (or SUPABASE_ANON_KEY) is missing.");
+        }
         const { SupabaseBackend } = await import("./supabase.js");
-        backend = new SupabaseBackend();
+        return new SupabaseBackend({
+            url,
+            serviceRoleKey,
+            tenancy: { mode: "byod" },
+        });
     }
-    else {
-        const { LocalBackend } = await import("./local.js");
-        backend = new LocalBackend();
+    // ── 3. Standalone: try remote BYOD lookup via api_key ─────────────────
+    if (apiKey) {
+        const byod = await fetchByodConfig(apiKey);
+        if (byod) {
+            const { SupabaseBackend } = await import("./supabase.js");
+            return new SupabaseBackend({
+                url: byod.supabase_url,
+                serviceRoleKey: byod.service_role_key,
+                tenancy: { mode: "byod" },
+            });
+        }
+        // No remote config; fall through to local.
     }
-    return backend;
+    // ── 4. Local JSON files (zero-config standalone) ──────────────────────
+    const { LocalBackend } = await import("./local.js");
+    return new LocalBackend();
 }
 //# sourceMappingURL=db.js.map

package/dist/memory/db.js.map

@@ -1 +1 @@
-{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/memory/db.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,IAAI,OAAO,GAAyB,IAAI,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1D,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACpD,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/memory/db.ts"],"names":[],"mappings":"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"}

package/dist/memory/device.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Device heartbeat for UnClick Memory.
+ *
+ * Sends a lightweight fingerprint to the UnClick control plane on startup so
+ * the admin dashboard can show where memory is in use, and so the backend can
+ * nudge users toward cloud sync when they start using UnClick on a 2nd device.
+ *
+ * Fingerprint is SHA-256 of (hostname + platform + arch + home-dir). No PII.
+ */
+interface HeartbeatResult {
+    nudge: boolean;
+    nudge_message: string | null;
+}
+/**
+ * Fire-and-forget heartbeat. Returns nudge info if the user has multiple
+ * devices on local storage so the MCP server can surface a hint.
+ */
+export declare function sendDeviceHeartbeat(storageMode: "local" | "cloud"): Promise<HeartbeatResult | null>;
+export {};
+//# sourceMappingURL=device.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/memory/device.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,UAAU,eAAe;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwBzG"}

package/dist/memory/device.js

@@ -0,0 +1,48 @@
+/**
+ * Device heartbeat for UnClick Memory.
+ *
+ * Sends a lightweight fingerprint to the UnClick control plane on startup so
+ * the admin dashboard can show where memory is in use, and so the backend can
+ * nudge users toward cloud sync when they start using UnClick on a 2nd device.
+ *
+ * Fingerprint is SHA-256 of (hostname + platform + arch + home-dir). No PII.
+ */
+import * as os from "os";
+import * as crypto from "crypto";
+const MEMORY_API_BASE = process.env.UNCLICK_MEMORY_BASE_URL || process.env.UNCLICK_SITE_URL || "https://unclick.world";
+function fingerprint() {
+    const parts = [os.hostname(), os.platform(), os.arch(), os.homedir()].join("|");
+    return crypto.createHash("sha256").update(parts).digest("hex");
+}
+/**
+ * Fire-and-forget heartbeat. Returns nudge info if the user has multiple
+ * devices on local storage so the MCP server can surface a hint.
+ */
+export async function sendDeviceHeartbeat(storageMode) {
+    const apiKey = process.env.UNCLICK_API_KEY;
+    if (!apiKey)
+        return null;
+    try {
+        const res = await fetch(`${MEMORY_API_BASE}/api/memory-admin?action=device_check`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                device_fingerprint: fingerprint(),
+                label: os.hostname(),
+                platform: `${os.platform()}-${os.arch()}`,
+                storage_mode: storageMode,
+            }),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return { nudge: Boolean(data.nudge), nudge_message: data.nudge_message ?? null };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=device.js.map

package/dist/memory/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../src/memory/device.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,eAAe,GACnB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;AAEjG,SAAS,WAAW;IAClB,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAOD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAA8B;IACtE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,eAAe,uCAAuC,EAAE;YACjF,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,EAAE;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,kBAAkB,EAAE,WAAW,EAAE;gBACjC,KAAK,EAAE,EAAE,CAAC,QAAQ,EAAE;gBACpB,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzC,YAAY,EAAE,WAAW;aAC1B,CAAC;SACH,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,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/memory/embeddings.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Thin wrapper around OpenAI text-embedding-3-small.
+ *
+ * Returns null instead of throwing so callers can fall back gracefully
+ * to keyword-only search when OpenAI is unavailable or unconfigured.
+ */
+export declare const EMBEDDING_MODEL = "text-embedding-3-small";
+export declare const EMBEDDING_DIMS = 1536;
+export declare function embedText(text: string): Promise<number[] | null>;
+//# sourceMappingURL=embeddings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/memory/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,2BAA2B,CAAC;AACxD,eAAO,MAAM,cAAc,OAAO,CAAC;AAUnC,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CA0BtE"}

package/dist/memory/embeddings.js

@@ -0,0 +1,40 @@
+/**
+ * Thin wrapper around OpenAI text-embedding-3-small.
+ *
+ * Returns null instead of throwing so callers can fall back gracefully
+ * to keyword-only search when OpenAI is unavailable or unconfigured.
+ */
+export const EMBEDDING_MODEL = "text-embedding-3-small";
+export const EMBEDDING_DIMS = 1536;
+// OpenAI hard limit for text-embedding-3-small is 8191 tokens (~32K chars).
+// Slicing at 32000 chars is a safe approximation.
+const MAX_INPUT_CHARS = 32_000;
+export async function embedText(text) {
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (!apiKey)
+        return null;
+    try {
+        const res = await fetch("https://api.openai.com/v1/embeddings", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: EMBEDDING_MODEL,
+                input: text.slice(0, MAX_INPUT_CHARS),
+            }),
+        });
+        if (!res.ok) {
+            console.error(`[embeddings] OpenAI error ${res.status}: ${await res.text()}`);
+            return null;
+        }
+        const data = (await res.json());
+        return data.data[0]?.embedding ?? null;
+    }
+    catch (err) {
+        console.error("[embeddings] fetch failed:", err);
+        return null;
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/memory/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/memory/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AACxD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,4EAA4E;AAC5E,kDAAkD;AAClD,MAAM,eAAe,GAAG,MAAM,CAAC;AAM/B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,sCAAsC,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,eAAe;gBACtB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;aACtC,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/memory/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAkBpC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAiI5E,CAAC"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/memory/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAkBpC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CA6N5E,CAAC"}