memkin 0.4.0

package/dist/server/config-routes.js

@@ -0,0 +1,122 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { Hono } from "hono";
+import { parse } from "yaml";
+import { LarkCliHttpClient } from "../collectors/feishu/lark-cli-client.js";
+import { maskDatabaseUrl, maskSecret } from "../config-center/secrets.js";
+import { validateDraft } from "../config-center/validation.js";
+import { testEmbeddingConnection, testLLMConnection } from "../setup/connection-tests.js";
+import { generateConfigYaml } from "../setup/generate-config.js";
+export function createConfigRoutes(opts) {
+    const app = new Hono();
+    app.get("/api/config", (c) => {
+        if (!existsSync(opts.configPath))
+            return c.json({});
+        const raw = readFileSync(opts.configPath, "utf-8");
+        const parsed = (parse(raw) ?? {});
+        if (parsed.llm?.api_key)
+            parsed.llm.api_key = maskSecret(parsed.llm.api_key);
+        if (parsed.embedding?.api_key)
+            parsed.embedding.api_key = maskSecret(parsed.embedding.api_key);
+        if (parsed.sources?.feishu?.app_secret) {
+            parsed.sources.feishu.app_secret = maskSecret(parsed.sources.feishu.app_secret);
+        }
+        if (parsed.store?.database_url) {
+            parsed.store.database_url = maskDatabaseUrl(parsed.store.database_url);
+        }
+        return c.json(parsed);
+    });
+    app.post("/api/config", async (c) => {
+        const body = await c.req.json();
+        const isMasked = (v) => typeof v === "string" && v.includes("****");
+        if (isMasked(body.llm?.api_key) ||
+            isMasked(body.embedding?.api_key) ||
+            isMasked(body.sources?.feishu?.app_secret) ||
+            isMasked(body.store?.database_url)) {
+            let existing = {};
+            if (existsSync(opts.configPath)) {
+                existing = (parse(readFileSync(opts.configPath, "utf-8")) ?? {});
+            }
+            if (isMasked(body.llm?.api_key) && body.llm) {
+                body.llm.api_key = existing.llm?.api_key ?? body.llm.api_key;
+            }
+            if (isMasked(body.embedding?.api_key) && body.embedding) {
+                body.embedding.api_key = existing.embedding?.api_key ?? body.embedding.api_key;
+            }
+            if (isMasked(body.sources?.feishu?.app_secret) && body.sources?.feishu) {
+                body.sources.feishu.app_secret =
+                    existing.sources?.feishu?.app_secret ?? body.sources.feishu.app_secret;
+            }
+            if (isMasked(body.store?.database_url) && body.store) {
+                body.store.database_url = existing.store?.database_url ?? body.store.database_url;
+            }
+        }
+        const diagnostics = validateDraft(body);
+        if (diagnostics.some((d) => d.severity === "error")) {
+            return c.json({ ok: false, diagnostics }, 422);
+        }
+        const yaml = generateConfigYaml(body);
+        mkdirSync(dirname(opts.configPath), { recursive: true });
+        writeFileSync(opts.configPath, yaml, "utf-8");
+        opts.onConfigSaved?.();
+        return c.json({ ok: true, diagnostics });
+    });
+    app.post("/api/test/llm", async (c) => {
+        const body = await c.req.json();
+        const start = Date.now();
+        const result = await testLLMConnection({
+            provider: body.provider,
+            model: body.model,
+            baseUrl: body.base_url,
+            apiKey: body.api_key,
+        });
+        return c.json({ ...result, latency_ms: Date.now() - start });
+    });
+    app.post("/api/test/embedding", async (c) => {
+        const body = await c.req.json();
+        if (body.provider === "ollama") {
+            const baseUrl = body.base_url ?? "http://localhost:11434";
+            try {
+                const res = await fetch(`${baseUrl.replace(/\/$/, "")}/api/tags`, {
+                    signal: AbortSignal.timeout(3000),
+                });
+                return c.json({
+                    ok: res.ok,
+                    error: res.ok ? undefined : `Ollama responded with ${res.status}`,
+                });
+            }
+            catch (err) {
+                return c.json({ ok: false, error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        const result = await testEmbeddingConnection(body.base_url ?? "https://api.openai.com/v1", body.api_key ?? "", body.model ?? "");
+        return c.json(result);
+    });
+    app.get("/api/feishu/health", async (c) => {
+        const client = new LarkCliHttpClient(opts.larkBin);
+        try {
+            const result = await client.healthCheck();
+            return c.json(result);
+        }
+        catch (err) {
+            return c.json({ ok: false, message: err instanceof Error ? err.message : String(err) }, 500);
+        }
+    });
+    app.get("/api/feishu/groups", async (c) => {
+        const client = new LarkCliHttpClient(opts.larkBin);
+        try {
+            const result = await client.request("GET", "/open-apis/im/v1/chats", { params: { page_size: "100" } });
+            const items = result.data?.items ?? [];
+            return c.json({ groups: items.map((i) => ({ id: i.chat_id, name: i.name })) });
+        }
+        catch (err) {
+            return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+        }
+    });
+    app.post("/api/setup/complete", (c) => {
+        opts.onSetupComplete?.();
+        return c.json({ ok: true });
+    });
+    return app;
+}
+//# sourceMappingURL=config-routes.js.map

package/dist/server/config-routes.js.map

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

package/dist/server/context.d.ts

@@ -0,0 +1,13 @@
+import type { GraphStore } from "../store/graph.js";
+import type { PageStore } from "../store/pages.js";
+import type { TagStore } from "../store/tags.js";
+import type { TimelineStore } from "../store/timeline.js";
+interface ContextStores {
+    pages: PageStore;
+    graph: GraphStore;
+    tags: TagStore;
+    timeline: TimelineStore;
+}
+export declare function getSessionContext(stores: ContextStores, days?: number): Promise<string>;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/server/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,UAAU,aAAa;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DxF"}

package/dist/server/context.js

@@ -0,0 +1,47 @@
+export async function getSessionContext(stores, days = 7) {
+    const since = new Date(Date.now() - days * 86_400_000).toISOString();
+    const [projects, decisions, allTasks, prefs, entities] = await Promise.all([
+        stores.pages.listPages({ type: "project", sort: "updated_at", order: "desc", limit: 5 }),
+        stores.pages.listPages({ type: "decision", sort: "updated_at", order: "desc", limit: 5 }),
+        stores.pages.listPages({ type: "task", sort: "updated_at", order: "desc", limit: 50 }),
+        stores.pages.listPages({ type: "preference", sort: "updated_at", order: "desc", limit: 10 }),
+        stores.pages.listPages({ type: "person", sort: "updated_at", order: "desc", limit: 5 }),
+    ]);
+    // Filter tasks to open ones
+    const openTasks = allTasks.filter((t) => t.frontmatter.status === "open");
+    // Parse `since` as a Date for reliable comparison against DB timestamps
+    const sinceDate = new Date(since);
+    const isRecent = (ts) => new Date(ts) >= sinceDate;
+    const recentDecisions = decisions.filter((d) => isRecent(d.updated_at));
+    const recentProjects = projects.filter((p) => isRecent(p.updated_at));
+    const lines = [`## 近期工作概览（最近 ${days} 天）`, ""];
+    if (recentProjects.length > 0) {
+        lines.push(`**活跃项目**：${recentProjects.map((p) => p.slug).join(", ")}`);
+    }
+    if (recentDecisions.length > 0) {
+        lines.push(`**关键决策**（最近 ${Math.min(recentDecisions.length, 3)} 条）：`);
+        for (const d of recentDecisions.slice(0, 3)) {
+            const date = new Date(d.updated_at).toISOString().slice(0, 10);
+            lines.push(`- ${date} ${d.title}`);
+        }
+    }
+    if (openTasks.length > 0) {
+        lines.push(`**待办**（open tasks，共 ${openTasks.length} 条）：`);
+        for (const t of openTasks.slice(0, 5)) {
+            lines.push(`- ${t.title} [${t.slug}]`);
+        }
+    }
+    if (prefs.length > 0) {
+        lines.push(`**已知偏好**（共 ${prefs.length} 条）：`);
+        for (const p of prefs.slice(0, 3)) {
+            lines.push(`- ${p.title}`);
+        }
+    }
+    if (entities.length > 0) {
+        lines.push(`**关键人物**：${entities.map((e) => `${e.title} [${e.slug}]`).join(", ")}`);
+    }
+    lines.push("");
+    lines.push('如需细节：`query("关键词")` 语义检索，或 `get_entity_profile("<entity-slug>")` 查看人物/项目档案。');
+    return lines.join("\n");
+}
+//# sourceMappingURL=context.js.map

package/dist/server/context.js.map

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

package/dist/server/entity.d.ts

@@ -0,0 +1,25 @@
+import type { GraphStore } from "../store/graph.js";
+import type { PageStore } from "../store/pages.js";
+import type { TimelineStore } from "../store/timeline.js";
+interface EntityStores {
+    pages: PageStore;
+    graph: GraphStore;
+    timeline: TimelineStore;
+}
+export declare function listSignalsByEntity(stores: EntityStores, entitySlug: string, signalTypes?: string[], limit?: number): Promise<Array<{
+    slug: string;
+    title: string;
+    type: string;
+    frontmatter: Record<string, unknown>;
+}>>;
+export declare function getEntityProfile(stores: EntityStores, entitySlug: string): Promise<{
+    page: Awaited<ReturnType<PageStore["getPage"]>>;
+    signals: Record<string, Array<{
+        slug: string;
+        title: string;
+        frontmatter: Record<string, unknown>;
+    }>>;
+    timeline: Awaited<ReturnType<TimelineStore["getTimeline"]>>;
+}>;
+export {};
+//# sourceMappingURL=entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/server/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,UAAU,YAAY;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,KAAK,SAAK,GACT,OAAO,CACR,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAC3F,CAaA;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,CACb,MAAM,EACN,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAC7E,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAC7D,CAAC,CAsBD"}

package/dist/server/entity.js

@@ -0,0 +1,34 @@
+export async function listSignalsByEntity(stores, entitySlug, signalTypes, limit = 20) {
+    const backlinks = await stores.graph.getBacklinksEnriched(entitySlug);
+    let signals = backlinks.map((b) => ({
+        slug: b.from_slug,
+        title: b.page.title,
+        type: b.page.type,
+        frontmatter: b.page.frontmatter,
+    }));
+    if (signalTypes && signalTypes.length > 0) {
+        const typeSet = new Set(signalTypes);
+        signals = signals.filter((s) => typeSet.has(s.type));
+    }
+    return signals.slice(0, limit);
+}
+export async function getEntityProfile(stores, entitySlug) {
+    const [page, backlinks, timeline] = await Promise.all([
+        stores.pages.getPage(entitySlug),
+        stores.graph.getBacklinksEnriched(entitySlug),
+        stores.timeline.getTimeline(entitySlug),
+    ]);
+    const signals = {};
+    for (const b of backlinks) {
+        const type = b.page.type;
+        if (!signals[type])
+            signals[type] = [];
+        signals[type].push({
+            slug: b.from_slug,
+            title: b.page.title,
+            frontmatter: b.page.frontmatter,
+        });
+    }
+    return { page, signals, timeline };
+}
+//# sourceMappingURL=entity.js.map

package/dist/server/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/server/entity.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAoB,EACpB,UAAkB,EAClB,WAAsB,EACtB,KAAK,GAAG,EAAE;IAIV,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACtE,IAAI,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,SAAS;QACjB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;QACnB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;QACjB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW;KAChC,CAAC,CAAC,CAAC;IACJ,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACrC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAoB,EACpB,UAAkB;IASlB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC;KACxC,CAAC,CAAC;IAEH,MAAM,OAAO,GAGT,EAAE,CAAC;IACP,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,CAAC,CAAC,SAAS;YACjB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;YACnB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC"}

package/dist/server/event-bus.d.ts

@@ -0,0 +1,35 @@
+import { EventEmitter } from "node:events";
+export interface SignalNewEvent {
+    slug: string;
+    type: string;
+    title: string;
+    summary: string;
+}
+export interface PipelineStartEvent {
+    platform: string;
+    timestamp: string;
+}
+export interface PipelineEndEvent {
+    platform: string;
+    stats: {
+        written: number;
+        skipped: number;
+        errors: number;
+    };
+    timestamp: string;
+}
+export interface PipelineErrorEvent {
+    platform: string;
+    error: string;
+    timestamp: string;
+}
+interface EventMap {
+    "signal:new": [SignalNewEvent];
+    "pipeline:start": [PipelineStartEvent];
+    "pipeline:end": [PipelineEndEvent];
+    "pipeline:error": [PipelineErrorEvent];
+}
+export declare class EventBus extends EventEmitter<EventMap> {
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/server/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/server/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,QAAQ;IAChB,YAAY,EAAE,CAAC,cAAc,CAAC,CAAC;IAC/B,gBAAgB,EAAE,CAAC,kBAAkB,CAAC,CAAC;IACvC,cAAc,EAAE,CAAC,gBAAgB,CAAC,CAAC;IACnC,gBAAgB,EAAE,CAAC,kBAAkB,CAAC,CAAC;CACxC;AAED,qBAAa,QAAS,SAAQ,YAAY,CAAC,QAAQ,CAAC;CAAG"}

package/dist/server/event-bus.js

@@ -0,0 +1,4 @@
+import { EventEmitter } from "node:events";
+export class EventBus extends EventEmitter {
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/server/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/server/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiC3C,MAAM,OAAO,QAAS,SAAQ,YAAsB;CAAG"}

package/dist/server/mcp-http-runtime.d.ts

@@ -0,0 +1,28 @@
+export interface McpHttpConfigSubset {
+    bind_host: string;
+    port: number;
+    allowed_origins: string[];
+    allowed_hosts: string[];
+    read_only: boolean;
+    auth_token_env?: string;
+}
+export interface McpHttpFlags {
+    mcpBind?: string;
+    mcpPort?: number;
+    mcpReadWrite?: boolean;
+    mcpAllowedHost?: string[];
+    daemonInstanceId?: string;
+}
+export interface McpHttpRuntime {
+    bind: string;
+    port: number;
+    allowedOrigins: string[];
+    allowedHosts: string[];
+    readOnly: boolean;
+    instanceId?: string;
+}
+export declare function resolveMcpHttpRuntime(cfg: McpHttpConfigSubset, flags: McpHttpFlags): McpHttpRuntime;
+export declare function assertLoopbackOrThrow(rt: {
+    bind: string;
+}): void;
+//# sourceMappingURL=mcp-http-runtime.d.ts.map

package/dist/server/mcp-http-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http-runtime.d.ts","sourceRoot":"","sources":["../../src/server/mcp-http-runtime.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,YAAY,GAClB,cAAc,CAiBhB;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOhE"}

package/dist/server/mcp-http-runtime.js

@@ -0,0 +1,24 @@
+import { isPublicBindHost } from "./mcp-http.js";
+export function resolveMcpHttpRuntime(cfg, flags) {
+    const bind = flags.mcpBind ?? cfg.bind_host;
+    const port = flags.mcpPort ?? cfg.port;
+    const readOnly = flags.mcpReadWrite ? false : cfg.read_only;
+    // When the port is overridden, explicit --mcp-allowed-host wins for allowedHosts.
+    // allowedOrigins are ALWAYS regenerated for the resolved port (independent of explicit hosts).
+    const allowedHosts = flags.mcpAllowedHost && flags.mcpAllowedHost.length > 0
+        ? flags.mcpAllowedHost
+        : flags.mcpPort !== undefined
+            ? [`127.0.0.1:${port}`, `localhost:${port}`]
+            : cfg.allowed_hosts;
+    const allowedOrigins = flags.mcpPort !== undefined
+        ? [`http://127.0.0.1:${port}`, `http://localhost:${port}`]
+        : cfg.allowed_origins;
+    return { bind, port, allowedOrigins, allowedHosts, readOnly, instanceId: flags.daemonInstanceId };
+}
+export function assertLoopbackOrThrow(rt) {
+    if (isPublicBindHost(rt.bind)) {
+        throw new Error(`Refusing to start: bind host "${rt.bind}" is not loopback. ` +
+            `Memkin's always-on daemon is loopback-only (127.0.0.1). Remote access is not supported in this version.`);
+    }
+}
+//# sourceMappingURL=mcp-http-runtime.js.map

package/dist/server/mcp-http-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http-runtime.js","sourceRoot":"","sources":["../../src/server/mcp-http-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA4BjD,MAAM,UAAU,qBAAqB,CACnC,GAAwB,EACxB,KAAmB;IAEnB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;IAC5D,kFAAkF;IAClF,+FAA+F;IAC/F,MAAM,YAAY,GAChB,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QACrD,CAAC,CAAC,KAAK,CAAC,cAAc;QACtB,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;YAC3B,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,EAAE,aAAa,IAAI,EAAE,CAAC;YAC5C,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;IAC1B,MAAM,cAAc,GAClB,KAAK,CAAC,OAAO,KAAK,SAAS;QACzB,CAAC,CAAC,CAAC,oBAAoB,IAAI,EAAE,EAAE,oBAAoB,IAAI,EAAE,CAAC;QAC1D,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC;IAC1B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAoB;IACxD,IAAI,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,iCAAiC,EAAE,CAAC,IAAI,qBAAqB;YAC3D,yGAAyG,CAC5G,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/server/mcp-http.d.ts

@@ -0,0 +1,41 @@
+import { Hono } from "hono";
+import { type StoreContext } from "./mcp.js";
+export interface McpHttpHealth {
+    instanceId?: string;
+    pid?: number;
+    engine?: string;
+    version?: string;
+    loadedConfigHash?: string;
+    /** FIX 5: port/bind echoed in /health so isReady() port/bind checks are load-bearing. */
+    port?: number;
+    bind?: string;
+    dbProbe?: () => Promise<boolean>;
+    /** Optional probe for managed-Postgres health. If provided: false → 503 (treated same as dbProbe false). */
+    pgProbe?: () => Promise<boolean>;
+}
+export interface McpHttpOptions {
+    allowedOrigins: string[];
+    allowedHosts: string[];
+    authToken?: string;
+    exposeLegacyTools?: boolean;
+    readOnly?: boolean;
+    enableJsonResponse?: boolean;
+    health?: McpHttpHealth;
+}
+export interface McpHttpSecurityError {
+    code: "FORBIDDEN_ORIGIN" | "FORBIDDEN_HOST" | "UNAUTHORIZED";
+    message: string;
+    suggestion: string;
+}
+export type McpHttpAuthorization = {
+    ok: true;
+} | {
+    ok: false;
+    status: 401 | 403;
+    error: McpHttpSecurityError;
+};
+/** Delegates to the shared loopback definition in server-security.ts (single source of truth). */
+export declare function isPublicBindHost(host: string): boolean;
+export declare function authorizeMcpHttpRequest(request: Request, options: Pick<McpHttpOptions, "allowedOrigins" | "allowedHosts" | "authToken">): McpHttpAuthorization;
+export declare function createMcpHttpApp(stores: StoreContext, options: McpHttpOptions): Hono;
+//# sourceMappingURL=mcp-http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http.d.ts","sourceRoot":"","sources":["../../src/server/mcp-http.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAG9D,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,4GAA4G;IAC5G,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAalE,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,gBAAgB,GAAG,cAAc,GAAG,WAAW,CAAC,GAC7E,oBAAoB,CAwCtB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAwFpF"}

package/dist/server/mcp-http.js

@@ -0,0 +1,139 @@
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { Hono } from "hono";
+import { createMcpServer } from "./mcp.js";
+import { isLoopbackHost, tokensMatch } from "./server-security.js";
+function matchesAllowed(value, allowed) {
+    if (!value || allowed.length === 0)
+        return true;
+    return allowed.includes("*") || allowed.includes(value);
+}
+function bearerToken(request) {
+    const auth = request.headers.get("authorization");
+    if (auth?.startsWith("Bearer "))
+        return auth.slice("Bearer ".length);
+    return request.headers.get("x-memkin-mcp-token") ?? undefined;
+}
+/** Delegates to the shared loopback definition in server-security.ts (single source of truth). */
+export function isPublicBindHost(host) {
+    return !isLoopbackHost(host);
+}
+export function authorizeMcpHttpRequest(request, options) {
+    const origin = request.headers.get("origin");
+    if (!matchesAllowed(origin, options.allowedOrigins)) {
+        return {
+            ok: false,
+            status: 403,
+            error: {
+                code: "FORBIDDEN_ORIGIN",
+                message: "Origin is not allowed for Memkin MCP HTTP",
+                suggestion: "Use a configured local origin or add the trusted origin explicitly.",
+            },
+        };
+    }
+    const host = request.headers.get("host");
+    if (!matchesAllowed(host, options.allowedHosts)) {
+        return {
+            ok: false,
+            status: 403,
+            error: {
+                code: "FORBIDDEN_HOST",
+                message: "Host is not allowed for Memkin MCP HTTP",
+                suggestion: "Use a configured local host or add the trusted host explicitly.",
+            },
+        };
+    }
+    if (options.authToken && !tokensMatch(options.authToken, bearerToken(request))) {
+        return {
+            ok: false,
+            status: 401,
+            error: {
+                code: "UNAUTHORIZED",
+                message: "MCP HTTP requires a valid bearer token",
+                suggestion: "Retry with `Authorization: Bearer <token>` from the configured env var.",
+            },
+        };
+    }
+    return { ok: true };
+}
+export function createMcpHttpApp(stores, options) {
+    const app = new Hono();
+    app.get("/health", async (c) => {
+        let dbOk = true;
+        if (options.health?.dbProbe) {
+            try {
+                dbOk = await options.health.dbProbe();
+            }
+            catch {
+                dbOk = false;
+            }
+        }
+        let pgOk;
+        if (options.health?.pgProbe) {
+            try {
+                pgOk = await options.health.pgProbe();
+            }
+            catch {
+                pgOk = false;
+            }
+        }
+        // isReady: both db and pg (if present) must be ok
+        const isReady = dbOk && (pgOk === undefined || pgOk);
+        const body = {
+            status: isReady ? "ok" : "degraded",
+            transport: "streamable_http",
+            auth_required: Boolean(options.authToken),
+            read_only: options.readOnly ?? false,
+            db_ok: dbOk,
+            instance_id: options.health?.instanceId,
+            pid: options.health?.pid,
+            engine: options.health?.engine,
+            version: options.health?.version,
+            loaded_config_hash: options.health?.loadedConfigHash,
+            // FIX 5: emit port/bind so isReady() port/bind checks are load-bearing
+            port: options.health?.port,
+            bind: options.health?.bind,
+        };
+        // Only include pg_ok when a pgProbe was configured
+        if (pgOk !== undefined) {
+            body.pg_ok = pgOk;
+        }
+        return c.json(body, isReady ? 200 : 503);
+    });
+    app.all("/mcp", async (c) => {
+        const authorization = authorizeMcpHttpRequest(c.req.raw, options);
+        if (!authorization.ok) {
+            return c.json({ error: authorization.error }, authorization.status);
+        }
+        if (c.req.method === "OPTIONS") {
+            return new Response(null, { status: 204 });
+        }
+        const transport = new WebStandardStreamableHTTPServerTransport({
+            allowedHosts: options.allowedHosts,
+            allowedOrigins: options.allowedOrigins,
+            enableDnsRebindingProtection: true,
+            enableJsonResponse: options.enableJsonResponse ?? true,
+            sessionIdGenerator: undefined,
+        });
+        const server = createMcpServer(stores, {
+            exposeLegacyTools: options.exposeLegacyTools,
+            readOnly: options.readOnly,
+        });
+        try {
+            await server.connect(transport);
+            return transport.handleRequest(c.req.raw);
+        }
+        catch (err) {
+            await server.close().catch(() => undefined);
+            const message = err instanceof Error ? err.message : String(err);
+            return c.json({
+                error: {
+                    code: "MCP_CONNECT_FAILED",
+                    message: `Failed to connect Memkin MCP HTTP transport: ${message}`,
+                    suggestion: "Retry the request; if it persists, inspect Memkin server logs.",
+                },
+            }, 500);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=mcp-http.js.map

package/dist/server/mcp-http.js.map

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