memkin 0.4.0

package/dist/core/canonicalize.js

@@ -0,0 +1,141 @@
+export function canonicalize(block) {
+    const source_type = inferSourceType(block.channel);
+    const interaction_tags = inferInteractionTags(block, source_type);
+    const canonical_markdown = buildMarkdown(block, source_type);
+    return { block, source_type, interaction_tags, canonical_markdown };
+}
+function inferSourceType(channel) {
+    if (channel.startsWith("mail/"))
+        return "email";
+    if (channel.startsWith("dm/"))
+        return "dm";
+    if (channel.startsWith("docs/"))
+        return "document";
+    if (channel.startsWith("calendar/") || channel === "tasks")
+        return "structured";
+    return "chat";
+}
+function inferInteractionTags(block, sourceType) {
+    const tags = [];
+    if (block.messages.some((m) => m.direction === "sent")) {
+        tags.push("sent");
+    }
+    if (sourceType === "email") {
+        const hasSentReply = block.messages.some((m) => m.direction === "sent" && m.metadata?.thread_id);
+        if (hasSentReply)
+            tags.push("reply");
+    }
+    if (sourceType === "dm") {
+        tags.push("dm");
+    }
+    return tags;
+}
+function buildMarkdown(block, sourceType) {
+    switch (sourceType) {
+        case "email":
+            return canonicalizeEmail(block.messages);
+        case "chat":
+        case "dm":
+            return canonicalizeChat(block.messages);
+        case "document":
+            return canonicalizeDocument(block.messages);
+        case "structured":
+        case "calendar":
+        case "task":
+            return canonicalizeStructured(block.messages);
+        default:
+            return canonicalizeChat(block.messages);
+    }
+}
+// --- Email adapter ---
+const REPLY_CHAIN_RE = /\n\s*On .{10,80} wrote:\s*\n[\s\S]*/;
+const QUOTE_BLOCK_RE = /\n(>{3,}[^\n]*\n?)+/g;
+const ORIGINAL_MSG_RE = /\n\s*---+\s*Original Message\s*---+[\s\S]*/i;
+const FOOTER_PATTERNS = [
+    /unsubscribe/i,
+    /view in browser/i,
+    /all rights reserved/i,
+    /此邮件由系统自动发送/,
+    /请勿回复/,
+    /Microsoft Teams meeting/i,
+    /Join on your computer/i,
+    /Join with a video conferencing device/i,
+];
+function canonicalizeEmail(messages) {
+    return messages
+        .map((msg) => {
+        const splitIdx = msg.content.indexOf("\n\n");
+        let subject = "";
+        let body = msg.content;
+        if (splitIdx > 0) {
+            subject = msg.content.slice(0, splitIdx);
+            body = msg.content.slice(splitIdx + 2);
+        }
+        // Strip reply chains
+        body = body.replace(REPLY_CHAIN_RE, "");
+        body = body.replace(QUOTE_BLOCK_RE, "");
+        body = body.replace(ORIGINAL_MSG_RE, "");
+        // Strip footers (find first footer marker from top, cut from there)
+        const lines = body.split("\n");
+        let cutoff = lines.length;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (FOOTER_PATTERNS.some((p) => p.test(line))) {
+                cutoff = i;
+                break;
+            }
+        }
+        body = lines.slice(0, cutoff).join("\n").trimEnd();
+        // Build structured output
+        const to = Array.isArray(msg.metadata?.to) ? msg.metadata.to.join(", ") : "";
+        const cc = Array.isArray(msg.metadata?.cc) ? msg.metadata.cc.join(", ") : "";
+        let header = "---\n";
+        header += `From: ${msg.contact}\n`;
+        if (subject)
+            header += `Subject: ${subject}\n`;
+        header += `Date: ${msg.timestamp}\n`;
+        if (to)
+            header += `To: ${to}\n`;
+        if (cc)
+            header += `CC: ${cc}\n`;
+        header += "---\n";
+        return `${header}${body}`;
+    })
+        .join("\n\n");
+}
+// --- Chat/DM adapter ---
+function canonicalizeChat(messages) {
+    return messages.map((msg) => `[${msg.timestamp}] ${msg.contact}: ${msg.content}`).join("\n");
+}
+// --- Document adapter ---
+function canonicalizeDocument(messages) {
+    return messages.map((m) => m.content.trim()).join("\n\n");
+}
+// --- Structured adapter (calendar/tasks) ---
+function canonicalizeStructured(messages) {
+    return messages
+        .map((msg) => {
+        const meta = msg.metadata ?? {};
+        const metaLines = [];
+        if (meta.event_id)
+            metaLines.push(`Event: ${meta.event_id}`);
+        if (meta.task_id)
+            metaLines.push(`Task: ${meta.task_id}`);
+        if (meta.location)
+            metaLines.push(`Location: ${meta.location}`);
+        if (meta.status)
+            metaLines.push(`Status: ${meta.status}`);
+        if (meta.priority)
+            metaLines.push(`Priority: ${meta.priority}`);
+        if (meta.due_date)
+            metaLines.push(`Due: ${meta.due_date}`);
+        if (Array.isArray(meta.attendees))
+            metaLines.push(`Attendees: ${meta.attendees.join(", ")}`);
+        if (Array.isArray(meta.assignees))
+            metaLines.push(`Assignees: ${meta.assignees.join(", ")}`);
+        const metaBlock = metaLines.length > 0 ? `${metaLines.join("\n")}\n\n` : "";
+        return `${metaBlock}${msg.content.trim()}`;
+    })
+        .join("\n\n");
+}
+//# sourceMappingURL=canonicalize.js.map

package/dist/core/canonicalize.js.map

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

package/dist/core/concurrency.d.ts

@@ -0,0 +1,2 @@
+export declare function pMap<T, R>(items: T[], fn: (item: T) => Promise<R>, concurrency: number): Promise<R[]>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/core/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/core/concurrency.ts"],"names":[],"mappings":"AAAA,wBAAsB,IAAI,CAAC,CAAC,EAAE,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd"}

package/dist/core/concurrency.js

@@ -0,0 +1,14 @@
+export async function pMap(items, fn, concurrency) {
+    const results = new Array(items.length);
+    let idx = 0;
+    async function worker() {
+        while (idx < items.length) {
+            const i = idx++;
+            results[i] = await fn(items[i]);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/core/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/core/concurrency.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,KAAU,EACV,EAA2B,EAC3B,WAAmB;IAEnB,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,KAAK,UAAU,MAAM;QACnB,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Configuration loader for Memkin
+ * Loads YAML config files with environment variable interpolation
+ * and recursive merging with defaults
+ */
+import type { FeishuDocSourceConfig } from "../collectors/feishu/types.js";
+/**
+ * Privacy configuration interface
+ */
+export interface PrivacyConfig {
+    enabled: boolean;
+    mode: "reversible" | "irreversible";
+    redact_phone: boolean;
+    redact_id_card: boolean;
+    redact_bank_card: boolean;
+    redact_email: boolean;
+    redact_url: boolean;
+    blocked_words: string[];
+    replacement: string;
+}
+/**
+ * LLM provider configuration interface
+ */
+export interface LLMConfig {
+    provider: string;
+    model: string;
+    base_url?: string;
+    api_key?: string;
+    filter_model?: string;
+    filter_provider?: string;
+}
+/**
+ * Block builder configuration interface
+ */
+export interface BlockBuilderConfig {
+    block_gap_minutes: number;
+    max_block_tokens: number;
+    max_block_messages: number;
+}
+/**
+ * Adapter configuration for file and gbrain
+ */
+export interface AdapterConfig {
+    enabled: boolean;
+    output_dir: string;
+}
+/**
+ * Adapters configuration interface
+ */
+export interface AdaptersConfig {
+    file?: AdapterConfig;
+    gbrain?: AdapterConfig;
+}
+/**
+ * Source configuration for each data source
+ */
+export interface SourceConfig {
+    enabled: boolean;
+    base_dir?: string;
+}
+/**
+ * Sources configuration interface
+ */
+export interface FeishuSourceConfig {
+    enabled?: boolean;
+    auth_mode?: "bot" | "user";
+    app_id: string;
+    app_secret: string;
+    lark_bin?: string;
+    auto_include_new_groups?: boolean;
+    base_url?: string;
+    rate_limit_qps?: number;
+    sources: {
+        messages?: {
+            enabled: boolean;
+            chat_ids: string[];
+            lookback_days?: number;
+            overlap_ms?: number;
+        };
+        calendar?: {
+            enabled: boolean;
+            calendar_ids: string[];
+        };
+        docs?: FeishuDocSourceConfig;
+        tasks?: {
+            enabled: boolean;
+        };
+        dm?: {
+            enabled: boolean;
+            dm_chat_ids?: string[];
+            self_open_id?: string;
+            lookback_days?: number;
+            overlap_ms?: number;
+        };
+        message_search?: {
+            enabled: boolean;
+            chat_types?: Array<"p2p" | "group">;
+            query?: string;
+            sender_type?: "user" | "bot";
+            exclude_sender_type?: "user" | "bot";
+            lookback_days?: number;
+            overlap_ms?: number;
+            page_size?: number;
+        };
+        mail?: {
+            enabled: boolean;
+            lookback_days?: number;
+            overlap_ms?: number;
+            fetch_concurrency?: number;
+        };
+    };
+}
+export interface SourcesConfig {
+    "claude-code"?: SourceConfig;
+    codex?: SourceConfig;
+    hermes?: SourceConfig;
+    feishu?: FeishuSourceConfig;
+}
+/**
+ * Managed postgres sub-configuration (engine: managed).
+ * The database_url is derived at runtime; no explicit URL is needed.
+ */
+export interface ManagedStoreConfig {
+    runtime_dir?: string;
+}
+/**
+ * Store configuration for data persistence
+ */
+export interface StoreConfig {
+    engine?: "pglite" | "postgres" | "managed";
+    data_dir?: string;
+    database_url?: string;
+    pool_size?: number;
+    managed?: ManagedStoreConfig;
+}
+/**
+ * Embedding configuration for vector storage
+ */
+export interface EmbeddingConfig {
+    provider: "openai" | "ollama";
+    model: string;
+    dimensions: number;
+    api_key?: string;
+    base_url?: string;
+}
+/**
+ * Server configuration for HTTP and MCP
+ */
+export interface ServerConfig {
+    http_port: number;
+    mcp_transport: "stdio" | "sse" | "streamable_http";
+    /**
+     * Bind host for the `serve` HTTP API + Web UI. Defaults to loopback
+     * (127.0.0.1). Setting a non-loopback host (e.g. 0.0.0.0) requires an auth
+     * token; the CLI `--host` flag overrides this.
+     */
+    host?: string;
+    /**
+     * Bearer token required on `/api/*` and `/mcp`. When set, auth is enforced on
+     * every interface (including loopback). Env `MEMKIN_AUTH_TOKEN` overrides.
+     * Required whenever `host` is non-loopback.
+     */
+    auth_token?: string;
+}
+export interface McpHttpConfig {
+    enabled: boolean;
+    bind_host: string;
+    port: number;
+    allowed_origins: string[];
+    allowed_hosts: string[];
+    auth_token_env?: string;
+    read_only: boolean;
+}
+export interface McpConfig {
+    expose_legacy_tools: boolean;
+    http: McpHttpConfig;
+}
+export interface SchedulerSourceConfig {
+    enabled?: boolean;
+    interval_secs?: number;
+}
+export interface SchedulerConfig {
+    enabled: boolean;
+    tick_interval_secs: number;
+    defaults: {
+        interval_secs: number;
+    };
+    sources: Record<string, SchedulerSourceConfig>;
+}
+export interface PipelineOptsConfig {
+    block_concurrency?: number;
+}
+/**
+ * Person communication profile configuration (Spec 8 §9).
+ * Disabled by default. allow/deny gate per-person opt-in/out by canonical slug.
+ */
+export interface ProfileConfig {
+    enabled: boolean;
+    allow: string[];
+    deny: string[];
+    min_sample_size: number;
+    /** Hours to add to UTC for the active-hours histogram (default 8 for CN workplace). */
+    tz_offset_hours: number;
+}
+/**
+ * Retrieval-quality configuration (Spec 10).
+ * pool_by_page: best-chunk-per-page pooling for query() (default on).
+ * llm_rewrite: optional LLM-based query rewrite before retrieval (default off).
+ */
+export interface SearchConfig {
+    pool_by_page: boolean;
+    llm_rewrite: boolean;
+}
+/**
+ * Complete configuration interface
+ */
+export interface Config {
+    privacy: PrivacyConfig;
+    llm: LLMConfig;
+    block_builder: BlockBuilderConfig;
+    adapters: AdaptersConfig;
+    sources: SourcesConfig;
+    store: StoreConfig;
+    embedding: EmbeddingConfig;
+    server: ServerConfig;
+    mcp: McpConfig;
+    scheduler?: SchedulerConfig;
+    pipeline?: PipelineOptsConfig;
+    profile: ProfileConfig;
+    search: SearchConfig;
+}
+/**
+ * Validates StoreConfig at runtime.
+ * @param s - The store config section.
+ * @param missingEnv - Names of env vars that were NOT resolved (still placeholders).
+ * @throws Error if the config is invalid.
+ */
+export declare function validateStoreConfig(s: StoreConfig, missingEnv?: string[]): void;
+export interface ConfigContext {
+    readonly configPath: string;
+    readonly projectRoot: string;
+    readonly missingEnvVars: string[];
+}
+export interface LoadedConfig extends Config {
+    readonly __context: ConfigContext;
+}
+export declare function resolveConfigPath(explicit?: string): string;
+/**
+ * Load configuration from YAML file
+ * Performs environment variable interpolation and merges with defaults
+ *
+ * @param filePath - Path to YAML config file (default: discovered memkin.yaml)
+ * @returns Loaded and merged configuration
+ * @throws Error if file cannot be read or parsed
+ */
+export declare function loadConfig(filePath?: string): LoadedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

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