memkin 0.4.0

package/dist/server/mcp.d.ts

@@ -0,0 +1,292 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type IngestDeps } from "../collectors/feishu/docs/ingest.js";
+import { type HandleKind, type HandleStrength } from "../core/person-identity.js";
+import type { MemoryFilter, SourceRef } from "../core/types.js";
+import type { LLMProvider } from "../extractors/providers/types.js";
+import type { ChunkStore } from "../store/chunks.js";
+import type { Database } from "../store/database.js";
+import type { EmbeddingService } from "../store/embedding.js";
+import type { GraphStore } from "../store/graph.js";
+import type { Page, PageStore } from "../store/pages.js";
+import type { SearchEngine } from "../store/search.js";
+import type { TagStore } from "../store/tags.js";
+import type { TimelineStore } from "../store/timeline.js";
+import type { SynthScope } from "../synth/index.js";
+export interface StoreContext {
+    db: Database;
+    pages: PageStore;
+    chunks: ChunkStore;
+    search: SearchEngine;
+    graph: GraphStore;
+    tags: TagStore;
+    timeline: TimelineStore;
+    embedding: EmbeddingService;
+}
+export interface McpServerOptions {
+    exposeLegacyTools?: boolean;
+    readOnly?: boolean;
+    version?: string;
+    /** LLM provider for synthesis tools (synthesize/recall). When omitted, synthesize/recall return a structured INVALID_ARGUMENT error. */
+    provider?: LLMProvider;
+    /** Model id recorded in synthesis result meta. */
+    synthModel?: string;
+}
+interface ToolError {
+    error: {
+        code: "NOT_FOUND" | "INVALID_ARGUMENT" | "INVALID_DATE" | "WRITE_FAILED" | "INTERNAL_ERROR";
+        message: string;
+        suggestion?: string;
+    };
+}
+export declare function createMcpToolHandlers(stores: StoreContext, options?: McpServerOptions): {
+    query: (args: MemoryFilter & {
+        query: string;
+    }) => Promise<import("../store/search.js").SearchResult[] | ToolError>;
+    search: (args: MemoryFilter & {
+        query: string;
+    }) => Promise<import("../store/search.js").SearchResult[] | ToolError>;
+    get_page_context: ({ slug, include, limit, }: {
+        slug: string;
+        include?: {
+            links?: boolean;
+            backlinks?: boolean;
+            timeline?: boolean;
+            chunks?: boolean;
+        };
+        limit?: number;
+    }) => Promise<ToolError | {
+        page: Page;
+        tags: string[];
+        links: import("../store/graph.js").EnrichedLinkRow[];
+        backlinks: import("../store/graph.js").EnrichedLinkRow[];
+        timeline: import("../store/timeline.js").TimelineEntry[];
+        chunks: import("../store/chunks.js").Chunk[] | undefined;
+        provenance: SourceRef | undefined;
+    }>;
+    timeline_feed: (args: MemoryFilter & {
+        query?: string;
+    }) => Promise<import("../store/timeline.js").TimelineFeedEntry[] | ToolError>;
+    explore_graph: ({ slug, depth, direction, }: {
+        slug: string;
+        depth?: number;
+        direction?: "in" | "out" | "both";
+    }) => Promise<import("../store/graph.js").TraverseResult | ToolError>;
+    get_page: ({ slug }: {
+        slug: string;
+    }) => Promise<Page | ToolError>;
+    put_page: ({ slug, content }: {
+        slug: string;
+        content: string;
+    }) => Promise<ToolError | {
+        ok: boolean;
+        slug: string;
+        changed: boolean;
+        content_hash: string;
+        previous_hash: string | undefined;
+        updated_at: string;
+    }>;
+    list_pages: (opts?: {
+        type?: string;
+        limit?: number;
+    }) => Promise<Page[]>;
+    get_chunks: ({ slug, limit }: {
+        slug: string;
+        limit?: number;
+    }) => Promise<import("../store/chunks.js").Chunk[] | ToolError>;
+    manage_links: ({ action, from, to, type, context, provenance, }: {
+        action: "add" | "remove";
+        from: string;
+        to: string;
+        type?: string;
+        context?: string;
+        provenance?: SourceRef | Record<string, unknown>;
+    }) => Promise<ToolError | {
+        ok: boolean;
+        action: "remove" | "add";
+        from: string;
+        to: string;
+    }>;
+    add_link: ({ from, to, type, context, }: {
+        from: string;
+        to: string;
+        type?: string;
+        context?: string;
+    }) => Promise<ToolError | {
+        ok: boolean;
+        action: "remove" | "add";
+        from: string;
+        to: string;
+    }>;
+    remove_link: ({ from, to }: {
+        from: string;
+        to: string;
+    }) => Promise<ToolError | {
+        ok: boolean;
+        action: "remove" | "add";
+        from: string;
+        to: string;
+    }>;
+    get_links: ({ slug, limit }: {
+        slug: string;
+        limit?: number;
+    }) => Promise<import("../store/graph.js").LinkRow[] | ToolError>;
+    get_backlinks: ({ slug, limit }: {
+        slug: string;
+        limit?: number;
+    }) => Promise<import("../store/graph.js").LinkRow[] | ToolError>;
+    traverse_graph: ({ slug, depth, direction, }: {
+        slug: string;
+        depth?: number;
+        direction?: "in" | "out" | "both";
+    }) => Promise<import("../store/graph.js").TraverseResult>;
+    manage_tags: ({ action, slug, tags, }: {
+        action: "add" | "remove";
+        slug: string;
+        tags: string[];
+    }) => Promise<ToolError | {
+        ok: boolean;
+        action: "remove" | "add";
+        slug: string;
+        tags: string[];
+    }>;
+    add_tag: ({ slug, tag }: {
+        slug: string;
+        tag: string;
+    }) => Promise<ToolError | {
+        ok: boolean;
+        action: "remove" | "add";
+        slug: string;
+        tags: string[];
+    }>;
+    remove_tag: ({ slug, tag }: {
+        slug: string;
+        tag: string;
+    }) => Promise<ToolError | {
+        ok: boolean;
+        action: "remove" | "add";
+        slug: string;
+        tags: string[];
+    }>;
+    get_tags: ({ slug }: {
+        slug: string;
+    }) => Promise<string[] | ToolError>;
+    add_timeline_entry: (entry: {
+        slug: string;
+        date: string;
+        summary: string;
+        detail?: string;
+        source?: string;
+        provenance?: SourceRef | Record<string, unknown>;
+    }) => Promise<ToolError | {
+        ok: boolean;
+        slug: string;
+        date: string;
+        summary: string;
+    }>;
+    get_timeline: ({ slug, limit }: {
+        slug: string;
+        limit?: number;
+    }) => Promise<import("../store/timeline.js").TimelineEntry[] | ToolError>;
+    get_health: () => Promise<{
+        status: string;
+        pages: number;
+        chunks: number;
+        mcp_version: string;
+        mcp_contract_version: string;
+        legacy_tools_exposed: boolean;
+        read_only: boolean;
+        capabilities: {
+            tools: boolean;
+            resources: boolean;
+            prompts: boolean;
+            structured_output: boolean;
+            streamable_http: boolean;
+        };
+    }>;
+    get_session_context: ({ days }: {
+        days?: number;
+    }) => Promise<string>;
+    list_signals_by_entity: ({ entity_slug, signal_types, limit, }: {
+        entity_slug: string;
+        signal_types?: string[];
+        limit?: number;
+    }) => Promise<{
+        slug: string;
+        title: string;
+        type: string;
+        frontmatter: Record<string, unknown>;
+    }[]>;
+    get_entity_profile: ({ entity_slug }: {
+        entity_slug: string;
+    }) => Promise<{
+        page: Awaited<ReturnType<PageStore["getPage"]>>;
+        signals: Record<string, Array<{
+            slug: string;
+            title: string;
+            frontmatter: Record<string, unknown>;
+        }>>;
+        timeline: Awaited<ReturnType<TimelineStore["getTimeline"]>>;
+    }>;
+    link_person_alias: ({ canonical_slug, kind, value, strength, }: {
+        canonical_slug: string;
+        kind: HandleKind;
+        value: string;
+        strength?: HandleStrength;
+    }) => Promise<{
+        ok: boolean;
+        canonical_slug: string;
+        handles: import("../core/person-identity.js").PersonHandle[];
+    }>;
+    list_person_handles: ({ canonical_slug }: {
+        canonical_slug: string;
+    }) => Promise<import("../core/person-identity.js").PersonHandle[]>;
+    remove_person_alias: ({ kind, value }: {
+        kind: HandleKind;
+        value: string;
+    }) => Promise<{
+        ok: boolean;
+    }>;
+    merge_persons: ({ from, into }: {
+        from: string;
+        into: string;
+    }) => Promise<{
+        ok: boolean;
+        merged: string;
+        into: string;
+        handles: import("../core/person-identity.js").PersonHandle[];
+    }>;
+    recanonicalize_person: ({ from, to }: {
+        from: string;
+        to: string;
+    }) => Promise<{
+        ok: boolean;
+        from: string;
+        to: string;
+        handles: import("../core/person-identity.js").PersonHandle[];
+    }>;
+    synthesize: ({ intent, scope }: {
+        intent: string;
+        scope?: SynthScope;
+    }) => Promise<import("../synth/types").SynthesisResult | ToolError>;
+    recall: ({ entity, query, time, }: {
+        entity?: string;
+        query?: string;
+        time?: {
+            from: string;
+            to: string;
+        };
+    }) => Promise<import("../synth/types").SynthesisResult | ToolError>;
+    prep_for_person: ({ person, goal }: {
+        person: string;
+        goal?: string;
+    }) => Promise<import("../synth/types").SynthesisResult | ToolError>;
+    daily_report: ({ date }: {
+        date?: string;
+    }) => Promise<import("../synth/types").SynthesisResult | ToolError>;
+    troubleshoot: ({ query }: {
+        query: string;
+    }) => Promise<import("../synth/types").SynthesisResult | ToolError>;
+};
+export declare function createMcpServer(stores: StoreContext, options?: McpServerOptions, ingestDeps?: IngestDeps): McpServer;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/server/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/server/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAMtF,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,qCAAqC,CAAC;AACvF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EAEpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkBpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wIAAwI;IACxI,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE;QACL,IAAI,EAAE,WAAW,GAAG,kBAAkB,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,CAAC;QAC5F,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAgLD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB;kBAOlE,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;mBAK/B,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;kDASlD;QACD,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QACzF,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;;;;;;;;;0BA8B2B,YAAY,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;iDAS1D;QACD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;KACnC;yBAQoB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;kCACD;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;wBAiCjD;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;kCAKjB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;qEAejE;QACD,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClD;;;;;;6CA4BE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;;;;;;gCAQiC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;;;;;;iCAE3B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;qCAK5B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;kDASpE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;KACnC;2CAKE;QACD,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB;;;;;;6BAoB8B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;;;;;;gCAE1B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;;;;;;yBAEpC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;gCAKT;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClD;;;;;;oCAaqC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;oCA4BtC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;oEAK9C;QACD,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;;;;;;0CAEqC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;;;;;;;;;oEAS1D;QACD,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,UAAU,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,cAAc,CAAC;KAC3B;;;;;8CAIyC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;2CAEvB;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;;;oCAI1C;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;;;0CAIxB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;;;;;;oCAMlC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAA;KAAE;uCAyBzE;QACD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;KACrC;wCAuByC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;6BA2B5C;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;8BAsBhB;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;EAsBpD;AA0+BD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,gBAAqB,EAC9B,UAAU,CAAC,EAAE,UAAU,GACtB,SAAS,CAoBX"}