@unclick/mcp-server 0.2.5 → 0.3.1

package/dist/memory/handlers.js

@@ -0,0 +1,219 @@
+/**
+ * Memory operation handlers for @unclick/mcp-server.
+ *
+ * Wraps the 17 memory operations (get_startup_context, search_memory, add_fact,
+ * write_session_summary, etc.) as plain async functions that take a single
+ * params object. Used by both direct MCP tools and the unclick_call meta-tool.
+ */
+import { getBackend } from "./db.js";
+import { buildToolGuidance, classifyTools, reportToolDetections, } from "./tool-awareness.js";
+import { resolveAgent, filterContextByLayers } from "./agent.js";
+import { emitSignal } from "../signals/emit.js";
+import { buildSearchMemoryCard } from "../cards/search-memory-card.js";
+function currentApiKeyHash() {
+    return process.env.UNCLICK_API_KEY_HASH ?? null;
+}
+function str(v, fallback = "") {
+    return typeof v === "string" ? v : fallback;
+}
+function num(v, fallback) {
+    return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function arr(v) {
+    return Array.isArray(v) ? v.map(String) : [];
+}
+function bool(v, fallback = false) {
+    return typeof v === "boolean" ? v : fallback;
+}
+export const MEMORY_HANDLERS = {
+    async get_startup_context(args) {
+        const db = await getBackend();
+        const slug = typeof args.agent_slug === "string" ? args.agent_slug : undefined;
+        const id = typeof args.agent_id === "string" ? args.agent_id : undefined;
+        const [baseContext, resolved] = await Promise.all([
+            db.getStartupContext(num(args.num_sessions, 5)),
+            resolveAgent({ agent_slug: slug, agent_id: id }),
+        ]);
+        // Optional: if the client passed the list of other tools in this session,
+        // classify them and attach tool_guidance so the agent can nudge the user.
+        const sessionTools = Array.isArray(args.session_tools)
+            ? args.session_tools.map(String).filter(Boolean)
+            : [];
+        let tool_guidance = undefined;
+        if (sessionTools.length > 0) {
+            const detections = classifyTools(sessionTools);
+            const nudgeable = await reportToolDetections(detections);
+            tool_guidance = buildToolGuidance(detections, nudgeable);
+        }
+        if (!resolved) {
+            if (tool_guidance === undefined)
+                return baseContext;
+            return { ...baseContext, tool_guidance };
+        }
+        const scoped = filterContextByLayers(baseContext, resolved.enabled_memory_layers);
+        const result = {
+            agent: {
+                id: resolved.agent.id,
+                slug: resolved.agent.slug,
+                name: resolved.agent.name,
+                role: resolved.agent.role,
+                description: resolved.agent.description,
+                system_prompt: resolved.agent.system_prompt,
+                is_default: resolved.agent.is_default,
+            },
+            enabled_tools: resolved.enabled_tools,
+            enabled_memory_layers: resolved.enabled_memory_layers,
+            memory: scoped && typeof scoped === "object" ? scoped : { _raw: baseContext },
+        };
+        if (tool_guidance !== undefined)
+            result.tool_guidance = tool_guidance;
+        return result;
+    },
+    async search_memory(args) {
+        const db = await getBackend();
+        const asOf = typeof args.as_of === "string" ? args.as_of : undefined;
+        const query = str(args.query);
+        const results = await db.searchMemory(query, num(args.max_results, 10), asOf);
+        // Phase 1 Wizard wrap: opt-in card alongside the existing array payload.
+        // Defaults off to keep backward compatibility for current consumers.
+        if (bool(args.include_card, false)) {
+            return { results, card: buildSearchMemoryCard(query, results) };
+        }
+        return results;
+    },
+    async search_facts(args) {
+        const db = await getBackend();
+        return db.searchFacts(str(args.query));
+    },
+    async search_library(args) {
+        const db = await getBackend();
+        return db.searchLibrary(str(args.query));
+    },
+    async get_library_doc(args) {
+        const db = await getBackend();
+        return db.getLibraryDoc(str(args.slug));
+    },
+    async list_library() {
+        const db = await getBackend();
+        return db.listLibrary();
+    },
+    async write_session_summary(args) {
+        const db = await getBackend();
+        const result = await db.writeSessionSummary({
+            session_id: str(args.session_id),
+            summary: str(args.summary),
+            topics: arr(args.topics),
+            open_loops: arr(args.open_loops),
+            decisions: arr(args.decisions),
+            platform: str(args.platform, "claude-code"),
+            duration_minutes: typeof args.duration_minutes === "number" ? args.duration_minutes : undefined,
+        });
+        const hash = currentApiKeyHash();
+        if (hash) {
+            void emitSignal({
+                apiKeyHash: hash,
+                tool: "memory",
+                action: "session_saved",
+                severity: "info",
+                summary: "Session summary saved to memory",
+                deepLink: "/admin/memory?tab=sessions",
+            });
+        }
+        return result;
+    },
+    async add_fact(args) {
+        const db = await getBackend();
+        const result = await db.addFact({
+            fact: str(args.fact),
+            category: str(args.category, "general"),
+            confidence: num(args.confidence, 0.9),
+            source_session_id: typeof args.source_session_id === "string" ? args.source_session_id : undefined,
+            valid_from: typeof args.valid_from === "string" ? args.valid_from : undefined,
+            extractor_id: typeof args.extractor_id === "string" ? args.extractor_id : undefined,
+            prompt_version: typeof args.prompt_version === "string" ? args.prompt_version : undefined,
+            model_id: typeof args.model_id === "string" ? args.model_id : undefined,
+            preserve_as_blob: typeof args.preserve_as_blob === "boolean" ? args.preserve_as_blob : false,
+            commit_sha: typeof args.commit_sha === "string" ? args.commit_sha : undefined,
+            pr_number: typeof args.pr_number === "number" ? Math.floor(args.pr_number) : undefined,
+        });
+        const hash = currentApiKeyHash();
+        if (hash) {
+            const preview = str(args.fact).slice(0, 80);
+            void emitSignal({
+                apiKeyHash: hash,
+                tool: "memory",
+                action: "fact_saved",
+                severity: "info",
+                summary: preview ? `Fact saved: ${preview}` : "Fact saved to memory",
+                deepLink: "/admin/memory?tab=facts",
+            });
+        }
+        return result;
+    },
+    async supersede_fact(args) {
+        const db = await getBackend();
+        const newId = await db.supersedeFact(str(args.old_fact_id), str(args.new_fact_text), typeof args.new_category === "string" ? args.new_category : undefined, typeof args.new_confidence === "number" ? args.new_confidence : undefined);
+        return { new_fact_id: newId };
+    },
+    async log_conversation(args) {
+        const db = await getBackend();
+        await db.logConversation({
+            session_id: str(args.session_id),
+            role: str(args.role),
+            content: str(args.content),
+            has_code: bool(args.has_code),
+        });
+        return { logged: true };
+    },
+    async get_conversation_detail(args) {
+        const db = await getBackend();
+        return db.getConversationDetail(str(args.session_id));
+    },
+    async store_code(args) {
+        const db = await getBackend();
+        return db.storeCode({
+            session_id: str(args.session_id),
+            language: str(args.language, "typescript"),
+            filename: typeof args.filename === "string" ? args.filename : undefined,
+            content: str(args.code || args.content),
+            description: typeof args.description === "string" ? args.description : undefined,
+        });
+    },
+    async get_business_context() {
+        const db = await getBackend();
+        return db.getBusinessContext();
+    },
+    async set_business_context(args) {
+        const db = await getBackend();
+        await db.setBusinessContext(str(args.category), str(args.key), args.value, typeof args.priority === "number" ? args.priority : undefined);
+        return { set: true, category: str(args.category), key: str(args.key) };
+    },
+    async upsert_library_doc(args) {
+        const db = await getBackend();
+        const msg = await db.upsertLibraryDoc({
+            slug: str(args.slug),
+            title: str(args.title),
+            category: str(args.category, "reference"),
+            content: str(args.content),
+            tags: arr(args.tags),
+        });
+        return { message: msg };
+    },
+    async manage_decay() {
+        const db = await getBackend();
+        return db.manageDecay();
+    },
+    async memory_status() {
+        const db = await getBackend();
+        return db.getMemoryStatus();
+    },
+    async invalidate_fact(args) {
+        const db = await getBackend();
+        return db.invalidateFact({
+            fact_id: str(args.fact_id),
+            reason: typeof args.reason === "string" ? args.reason : undefined,
+            session_id: typeof args.session_id === "string" ? args.session_id : undefined,
+        });
+    },
+};
+//# sourceMappingURL=handlers.js.map

package/dist/memory/handlers.js.map

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

package/dist/memory/instrumentation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Instrumentation surface for UnClick Memory.
+ *
+ * Two related responsibilities live here:
+ *
+ * 1. Low-level event logger. Writes a single row per event to
+ *    memory_load_events (local JSON in dev, Supabase table in cloud).
+ *    Used by the MCP Resources ReadResource handler and other callers
+ *    that want to record a memory-related event directly.
+ *
+ * 2. Thin wrappers over session-state.ts so server.ts can keep its
+ *    request handlers focused on protocol work while still recording
+ *    which autoload path (instructions / prompt / resource / tool
+ *    description) actually reached the agent. The session snapshot is
+ *    flushed to memory_load_events by load-events.ts on the first tool
+ *    call.
+ */
+import { type AutoloadMethod } from "./session-state.js";
+export interface MemoryLoadEvent {
+    tool_name: string;
+    params?: Record<string, unknown>;
+    result_bytes?: number;
+    created_at: string;
+}
+export declare function logMemoryLoadEvent(event: Omit<MemoryLoadEvent, "created_at">): void;
+/** Called from the Initialize handler. */
+export declare function trackInitialize(clientInfo: {
+    name?: string;
+    version?: string;
+} | undefined, instructionsSent: boolean): void;
+/** Called from GetPromptRequest handler for any prompt read. */
+export declare function trackPromptUsed(name: string): void;
+/** Called from ReadResourceRequest handler for any resource read. */
+export declare function trackResourceRead(uri: string): void;
+/** Explicit hook for code paths that load context outside of the
+ *  prompt / resource / instructions flow (e.g. direct RPC or manual). */
+export declare function trackManualLoad(method?: AutoloadMethod): void;
+//# sourceMappingURL=instrumentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/memory/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAK5B,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqCD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAAG,IAAI,CAYnF;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAC7B,UAAU,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC3D,gBAAgB,EAAE,OAAO,GACxB,IAAI,CAMN;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;yEACyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,GAAE,cAAyB,GAAG,IAAI,CAEvE"}

package/dist/memory/instrumentation.js

@@ -0,0 +1,97 @@
+/**
+ * Instrumentation surface for UnClick Memory.
+ *
+ * Two related responsibilities live here:
+ *
+ * 1. Low-level event logger. Writes a single row per event to
+ *    memory_load_events (local JSON in dev, Supabase table in cloud).
+ *    Used by the MCP Resources ReadResource handler and other callers
+ *    that want to record a memory-related event directly.
+ *
+ * 2. Thin wrappers over session-state.ts so server.ts can keep its
+ *    request handlers focused on protocol work while still recording
+ *    which autoload path (instructions / prompt / resource / tool
+ *    description) actually reached the agent. The session snapshot is
+ *    flushed to memory_load_events by load-events.ts on the first tool
+ *    call.
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import * as crypto from "crypto";
+import { markPromptUsed, markResourceRead, markContextLoaded, setClientInfo, setInstructionsSent, } from "./session-state.js";
+const DATA_DIR = path.join(os.homedir(), ".unclick", "memory");
+const TABLE = "memory_load_events";
+function appendLocal(row) {
+    try {
+        fs.mkdirSync(DATA_DIR, { recursive: true });
+        const file = path.join(DATA_DIR, `${TABLE}.json`);
+        let rows = [];
+        if (fs.existsSync(file)) {
+            try {
+                rows = JSON.parse(fs.readFileSync(file, "utf8"));
+                if (!Array.isArray(rows))
+                    rows = [];
+            }
+            catch {
+                rows = [];
+            }
+        }
+        rows.push(row);
+        const tmp = file + ".tmp";
+        fs.writeFileSync(tmp, JSON.stringify(rows, null, 2));
+        fs.renameSync(tmp, file);
+    }
+    catch {
+        // instrumentation must never crash the caller
+    }
+}
+async function insertSupabase(row) {
+    try {
+        const { createClient } = await import("@supabase/supabase-js");
+        const url = process.env.SUPABASE_URL;
+        const key = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY;
+        if (!url || !key)
+            return;
+        const sb = createClient(url, key, { auth: { persistSession: false, autoRefreshToken: false } });
+        await sb.from(TABLE).insert(row);
+    }
+    catch {
+        // table may not exist yet (chunk 0 installs it); ignore
+    }
+}
+export function logMemoryLoadEvent(event) {
+    const row = {
+        id: crypto.randomUUID(),
+        created_at: new Date().toISOString(),
+        ...event,
+    };
+    if (process.env.SUPABASE_URL) {
+        void insertSupabase(row);
+    }
+    else {
+        appendLocal(row);
+    }
+}
+/** Called from the Initialize handler. */
+export function trackInitialize(clientInfo, instructionsSent) {
+    setClientInfo(clientInfo);
+    setInstructionsSent(instructionsSent);
+    if (instructionsSent) {
+        markContextLoaded("instructions");
+    }
+}
+/** Called from GetPromptRequest handler for any prompt read. */
+export function trackPromptUsed(name) {
+    markPromptUsed(name);
+}
+/** Called from ReadResourceRequest handler for any resource read. */
+export function trackResourceRead(uri) {
+    markResourceRead(uri);
+}
+/** Explicit hook for code paths that load context outside of the
+ *  prompt / resource / instructions flow (e.g. direct RPC or manual). */
+export function trackManualLoad(method = "manual") {
+    markContextLoaded(method);
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/memory/instrumentation.js.map

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

package/dist/memory/load-events.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Load event logger for the UnClick MCP server.
+ *
+ * Fires a single memory_load_events row per session on the first tool
+ * call, capturing everything session-state.ts has observed up to that
+ * point (client info, whether instructions were sent, whether the
+ * load-memory prompt fired, which memory:// resources were read, etc.).
+ *
+ * Designed to be fire-and-forget: any failure is swallowed so
+ * instrumentation never breaks an agent's actual tool call.
+ */
+/**
+ * Log a tool call event. Safe to call on every tool invocation: the first
+ * call writes the memory_load_events row for this session, subsequent
+ * calls are no-ops (we only care about the initial load pattern).
+ */
+export declare function logToolCall(toolName: string): Promise<void>;
+//# sourceMappingURL=load-events.d.ts.map

package/dist/memory/load-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-events.d.ts","sourceRoot":"","sources":["../../src/memory/load-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8CH;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjE"}

package/dist/memory/load-events.js

@@ -0,0 +1,61 @@
+/**
+ * Load event logger for the UnClick MCP server.
+ *
+ * Fires a single memory_load_events row per session on the first tool
+ * call, capturing everything session-state.ts has observed up to that
+ * point (client info, whether instructions were sent, whether the
+ * load-memory prompt fired, which memory:// resources were read, etc.).
+ *
+ * Designed to be fire-and-forget: any failure is swallowed so
+ * instrumentation never breaks an agent's actual tool call.
+ */
+import * as crypto from "crypto";
+import { sessionState, recordToolCall, } from "./session-state.js";
+const MEMORY_API_BASE = process.env.UNCLICK_MEMORY_BASE_URL ||
+    process.env.UNCLICK_SITE_URL ||
+    "https://unclick.world";
+function sha256hex(input) {
+    return crypto.createHash("sha256").update(input).digest("hex");
+}
+function buildPayload(state) {
+    const apiKey = process.env.UNCLICK_API_KEY;
+    return {
+        api_key_hash: apiKey ? sha256hex(apiKey) : null,
+        session_id: state.sessionId,
+        client_name: state.clientInfo?.name ?? null,
+        client_version: state.clientInfo?.version ?? null,
+        first_tool: state.firstToolCall,
+        context_loaded: state.contextLoaded,
+        tools_called_before_context: state.toolsCalledBeforeContext,
+        instructions_sent: state.instructionsSent,
+        prompt_used: state.promptUsed,
+        resource_read: state.resourcesRead.length > 0,
+        autoload_method: state.contextLoadMethod ?? "none",
+    };
+}
+async function sendEvent(payload) {
+    const apiKey = process.env.UNCLICK_API_KEY;
+    const headers = { "Content-Type": "application/json" };
+    if (apiKey)
+        headers.Authorization = `Bearer ${apiKey}`;
+    await fetch(`${MEMORY_API_BASE}/api/memory-admin?action=log_tool_event`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(payload),
+    });
+}
+/**
+ * Log a tool call event. Safe to call on every tool invocation: the first
+ * call writes the memory_load_events row for this session, subsequent
+ * calls are no-ops (we only care about the initial load pattern).
+ */
+export async function logToolCall(toolName) {
+    recordToolCall(toolName);
+    if (sessionState.logged)
+        return;
+    sessionState.logged = true;
+    const payload = buildPayload(sessionState);
+    // Fire-and-forget. Never let instrumentation break a tool call.
+    sendEvent(payload).catch(() => { });
+}
+//# sourceMappingURL=load-events.js.map

package/dist/memory/load-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-events.js","sourceRoot":"","sources":["../../src/memory/load-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,cAAc,GAEf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,eAAe,GACnB,OAAO,CAAC,GAAG,CAAC,uBAAuB;IACnC,OAAO,CAAC,GAAG,CAAC,gBAAgB;IAC5B,uBAAuB,CAAC;AAE1B,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,YAAY,CAAC,KAAmB;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/C,UAAU,EAAE,KAAK,CAAC,SAAS;QAC3B,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,IAAI,IAAI;QAC3C,cAAc,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,IAAI,IAAI;QACjD,UAAU,EAAE,KAAK,CAAC,aAAa;QAC/B,cAAc,EAAE,KAAK,CAAC,aAAa;QACnC,2BAA2B,EAAE,KAAK,CAAC,wBAAwB;QAC3D,iBAAiB,EAAE,KAAK,CAAC,gBAAgB;QACzC,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;QAC7C,eAAe,EAAE,KAAK,CAAC,iBAAiB,IAAI,MAAM;KACnD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAgC;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;IAC/E,IAAI,MAAM;QAAE,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,EAAE,CAAC;IACvD,MAAM,KAAK,CAAC,GAAG,eAAe,yCAAyC,EAAE;QACvE,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,YAAY,CAAC,MAAM;QAAE,OAAO;IAChC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC;IAE3B,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC3C,gEAAgE;IAChE,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/memory/local.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Local JSON file storage backend for UnClick Memory.
+ *
+ * Zero-config mode: no accounts, no keys, no database setup.
+ * Memory is stored as JSON files in ~/.unclick/memory/
+ *
+ * This is the default when no SUPABASE_URL is set.
+ * Upgrade to Supabase for cloud sync across machines.
+ */
+import type { MemoryBackend, SessionSummaryInput, FactInput, InvalidateFactInput, ConversationInput, CodeInput, LibraryDocInput } from "./types.js";
+export declare class LocalBackend implements MemoryBackend {
+    constructor();
+    getStartupContext(numSessions: number): Promise<unknown>;
+    searchMemory(query: string, maxResults: number): Promise<unknown>;
+    searchFacts(query: string): Promise<unknown>;
+    searchLibrary(query: string): Promise<unknown>;
+    getLibraryDoc(slug: string): Promise<unknown>;
+    listLibrary(): Promise<unknown>;
+    writeSessionSummary(data: SessionSummaryInput): Promise<{
+        id: string;
+    }>;
+    addFact(data: FactInput): Promise<{
+        id: string;
+    }>;
+    supersedeFact(oldId: string, newText: string, category?: string, confidence?: number): Promise<string>;
+    logConversation(data: ConversationInput): Promise<void>;
+    getConversationDetail(sessionId: string): Promise<unknown>;
+    storeCode(data: CodeInput): Promise<{
+        id: string;
+    }>;
+    getBusinessContext(): Promise<unknown[]>;
+    setBusinessContext(category: string, key: string, value: unknown, priority?: number): Promise<void>;
+    upsertLibraryDoc(data: LibraryDocInput): Promise<string>;
+    manageDecay(): Promise<unknown>;
+    getMemoryStatus(): Promise<unknown>;
+    invalidateFact(_input: InvalidateFactInput): Promise<{
+        invalidated_at: string;
+    }>;
+}
+//# sourceMappingURL=local.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/memory/local.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,eAAe,EAChB,MAAM,YAAY,CAAC;AAoIpB,qBAAa,YAAa,YAAW,aAAa;;IAM1C,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDxD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQjE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB7C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAM/B,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBvE,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBjD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BtG,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO1D,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBnD,kBAAkB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKxC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BnG,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAgDxD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgD/B,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBnC,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CAGvF"}