memkin 0.4.0

package/dist/extractors/providers/anthropic.js

@@ -0,0 +1,67 @@
+/**
+ * Anthropic-compatible LLM Provider
+ * Uses fetch to call Anthropic Messages API directly
+ */
+export function createAnthropicProvider(config) {
+    const { apiKey, model, baseUrl = "https://api.anthropic.com" } = config;
+    return {
+        async chat(messages, opts) {
+            const url = `${baseUrl}/v1/messages`;
+            const system = messages
+                .filter((m) => m.role === "system")
+                .map((m) => m.content)
+                .join("\n\n");
+            const anthropicMessages = messages
+                .filter((m) => m.role !== "system")
+                .map((m) => ({ role: m.role, content: m.content }));
+            const requestBody = {
+                model,
+                messages: anthropicMessages,
+                max_tokens: opts?.maxTokens ?? 4096,
+                thinking: { type: "disabled" },
+            };
+            if (system)
+                requestBody.system = system;
+            if (opts?.temperature !== undefined)
+                requestBody.temperature = opts.temperature;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 180_000);
+            let response;
+            try {
+                response = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        "x-api-key": apiKey,
+                        "anthropic-version": "2023-06-01",
+                    },
+                    body: JSON.stringify(requestBody),
+                    signal: controller.signal,
+                });
+            }
+            catch (err) {
+                throw new Error(`Anthropic API request failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+            const data = (await response.json());
+            if (data.error) {
+                throw new Error(`Anthropic API error: ${data.error.message}`);
+            }
+            if (!data.content || data.content.length === 0) {
+                throw new Error("Anthropic API returned no content");
+            }
+            let content = data.content
+                .filter((b) => b.type === "text" && b.text && b.text.trim().length > 0)
+                .map((b) => b.text ?? "")
+                .join("");
+            content = content.replace(/<think>[\s\S]*?<\/think>\s*/g, "").trim();
+            if (!content) {
+                throw new Error("Anthropic API returned empty text content");
+            }
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/extractors/providers/anthropic.js.map

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

package/dist/extractors/providers/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LLM Provider factory
+ * Creates provider instances based on configuration
+ */
+import type { LLMConfig } from "../../core/config.js";
+import type { LLMProvider } from "./types.js";
+export declare function createLLMProvider(config: LLMConfig): LLMProvider;
+export { createAnthropicProvider } from "./anthropic.js";
+export { createMockProvider } from "./mock.js";
+export { createOpenAIProvider } from "./openai.js";
+export type { ChatMessage, LLMOpts, LLMProvider } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extractors/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extractors/providers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAiChE;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/extractors/providers/index.js

@@ -0,0 +1,41 @@
+/**
+ * LLM Provider factory
+ * Creates provider instances based on configuration
+ */
+import { createAnthropicProvider } from "./anthropic.js";
+import { createMockProvider } from "./mock.js";
+import { createOpenAIProvider } from "./openai.js";
+export function createLLMProvider(config) {
+    const { provider, model, api_key, base_url } = config;
+    switch (provider) {
+        case "openai": {
+            if (!api_key) {
+                throw new Error("OpenAI provider requires api_key in config");
+            }
+            return createOpenAIProvider({
+                apiKey: api_key,
+                model,
+                baseUrl: base_url,
+            });
+        }
+        case "anthropic": {
+            if (!api_key) {
+                throw new Error("Anthropic provider requires api_key in config");
+            }
+            return createAnthropicProvider({
+                apiKey: api_key,
+                model,
+                baseUrl: base_url,
+            });
+        }
+        case "mock": {
+            return createMockProvider(new Map());
+        }
+        default:
+            throw new Error(`Unsupported LLM provider: ${provider}. Supported: openai, anthropic, mock`);
+    }
+}
+export { createAnthropicProvider } from "./anthropic.js";
+export { createMockProvider } from "./mock.js";
+export { createOpenAIProvider } from "./openai.js";
+//# sourceMappingURL=index.js.map

package/dist/extractors/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extractors/providers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEtD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,oBAAoB,CAAC;gBAC1B,MAAM,EAAE,OAAO;gBACf,KAAK;gBACL,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,uBAAuB,CAAC;gBAC7B,MAAM,EAAE,OAAO;gBACf,KAAK;gBACL,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,OAAO,kBAAkB,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,sCAAsC,CAAC,CAAC;IACjG,CAAC;AACH,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/extractors/providers/mock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Mock LLM Provider for testing
+ * Returns predefined responses based on prompt matching
+ */
+import type { LLMProvider } from "./types.js";
+/**
+ * Create a mock LLM provider that returns predefined responses
+ * Useful for testing and development without real API calls
+ *
+ * @param responses - Map of prompt patterns to responses (matched case-insensitively)
+ * @returns Mock LLM provider
+ */
+export declare function createMockProvider(responses: Map<string, string>): LLMProvider;
+//# sourceMappingURL=mock.d.ts.map

package/dist/extractors/providers/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/extractors/providers/mock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAwB,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CA2B9E"}

package/dist/extractors/providers/mock.js

@@ -0,0 +1,37 @@
+/**
+ * Mock LLM Provider for testing
+ * Returns predefined responses based on prompt matching
+ */
+/**
+ * Create a mock LLM provider that returns predefined responses
+ * Useful for testing and development without real API calls
+ *
+ * @param responses - Map of prompt patterns to responses (matched case-insensitively)
+ * @returns Mock LLM provider
+ */
+export function createMockProvider(responses) {
+    return {
+        async chat(messages, _opts) {
+            // Concatenate all message content to form the prompt
+            const prompt = messages
+                .map((msg) => msg.content)
+                .join(" ")
+                .toLowerCase();
+            // Try to find a matching response
+            // First try exact matches, then try partial matches
+            for (const [pattern, response] of responses.entries()) {
+                if (prompt === pattern.toLowerCase()) {
+                    return response;
+                }
+            }
+            // Try partial matches (pattern contained in prompt)
+            for (const [pattern, response] of responses.entries()) {
+                if (pattern === "" || prompt.includes(pattern.toLowerCase())) {
+                    return response;
+                }
+            }
+            throw new Error(`No mock response found for prompt: "${prompt.substring(0, 100)}..."`);
+        },
+    };
+}
+//# sourceMappingURL=mock.js.map

package/dist/extractors/providers/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../../src/extractors/providers/mock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA8B;IAC/D,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,QAAuB,EAAE,KAAe;YACjD,qDAAqD;YACrD,MAAM,MAAM,GAAG,QAAQ;iBACpB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;iBACzB,IAAI,CAAC,GAAG,CAAC;iBACT,WAAW,EAAE,CAAC;YAEjB,kCAAkC;YAClC,oDAAoD;YACpD,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,IAAI,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;oBACrC,OAAO,QAAQ,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,oDAAoD;YACpD,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,IAAI,OAAO,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC7D,OAAO,QAAQ,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACzF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/extractors/providers/openai.d.ts

@@ -0,0 +1,15 @@
+/**
+ * OpenAI-compatible LLM Provider
+ * Uses fetch to call OpenAI API directly, supports custom base_url for proxies/local servers.
+ * Auto-detects unsupported parameters (temperature, response_format) on first call
+ * and falls back gracefully for third-party proxy compatibility.
+ */
+import type { LLMProvider } from "./types.js";
+interface OpenAIConfig {
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+}
+export declare function createOpenAIProvider(config: OpenAIConfig): LLMProvider;
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/extractors/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/extractors/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAwB,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpE,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CA6GtE"}

package/dist/extractors/providers/openai.js

@@ -0,0 +1,109 @@
+/**
+ * OpenAI-compatible LLM Provider
+ * Uses fetch to call OpenAI API directly, supports custom base_url for proxies/local servers.
+ * Auto-detects unsupported parameters (temperature, response_format) on first call
+ * and falls back gracefully for third-party proxy compatibility.
+ */
+export function createOpenAIProvider(config) {
+    const { apiKey, model } = config;
+    // Normalise base_url: strip trailing slash and trailing /v1 so we always append /v1/...
+    const baseUrl = (config.baseUrl ?? "https://api.openai.com")
+        .replace(/\/+$/, "")
+        .replace(/\/v1$/, "");
+    const url = `${baseUrl}/v1/chat/completions`;
+    // Track which optional features the endpoint supports (auto-detected on first use)
+    let supportsTemperature = null;
+    let supportsJsonFormat = null;
+    async function doFetch(body) {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify(body),
+        });
+        return (await response.json());
+    }
+    function buildBody(messages, opts) {
+        const body = { model, messages };
+        if (opts?.maxTokens !== undefined)
+            body.max_tokens = opts.maxTokens;
+        if (opts?.temperature !== undefined && supportsTemperature !== false) {
+            body.temperature = opts.temperature;
+        }
+        if (opts?.responseFormat === "json" && supportsJsonFormat !== false) {
+            body.response_format = { type: "json_object" };
+        }
+        return body;
+    }
+    function isApiError(data) {
+        return Boolean(data.error);
+    }
+    function extractContent(data) {
+        if (!data.choices || data.choices.length === 0) {
+            throw new Error("API returned no choices in response");
+        }
+        const choice = data.choices[0];
+        if (!choice.message) {
+            throw new Error("API response choice has no message");
+        }
+        let content = choice.message.content ?? "";
+        content = content.replace(/<think>[\s\S]*?<\/think>\s*/g, "").trim();
+        return content;
+    }
+    return {
+        async chat(messages, opts) {
+            // First attempt: with all supported optional params
+            const body = buildBody(messages, opts);
+            const data = await doFetch(body);
+            if (!isApiError(data)) {
+                // Success — mark features as supported if we sent them
+                if (body.temperature !== undefined)
+                    supportsTemperature = true;
+                if (body.response_format !== undefined)
+                    supportsJsonFormat = true;
+                return extractContent(data);
+            }
+            // API error — try stripping optional params one at a time
+            const errorMsg = data.error?.message ?? "";
+            const errorCode = data.error?.code ?? "";
+            const errorType = data.error?.type ?? "";
+            const isParamError = errorCode === "bad_response_status_code" ||
+                errorType === "bad_response_status_code" ||
+                errorType === "invalid_request_error" ||
+                /temperature|response_format|json/i.test(errorMsg);
+            if (!isParamError) {
+                throw new Error(`API error: ${errorMsg}`);
+            }
+            // Retry without optional params
+            const retryBody = { model, messages };
+            if (opts?.maxTokens !== undefined)
+                retryBody.max_tokens = opts.maxTokens;
+            // Try without response_format first (most common culprit)
+            if (body.response_format !== undefined) {
+                const noFormatBody = { ...body };
+                delete noFormatBody.response_format;
+                const retryData = await doFetch(noFormatBody);
+                if (!isApiError(retryData)) {
+                    supportsJsonFormat = false;
+                    if (noFormatBody.temperature !== undefined)
+                        supportsTemperature = true;
+                    return extractContent(retryData);
+                }
+            }
+            // Try with only required params (no temperature, no response_format)
+            const minimalData = await doFetch(retryBody);
+            if (!isApiError(minimalData)) {
+                if (body.temperature !== undefined)
+                    supportsTemperature = false;
+                if (body.response_format !== undefined)
+                    supportsJsonFormat = false;
+                return extractContent(minimalData);
+            }
+            // Everything failed
+            throw new Error(`API error: ${minimalData.error?.message ?? errorMsg}`);
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/extractors/providers/openai.js.map

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

package/dist/extractors/providers/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LLM Provider interface and types
+ * Unified interface for calling Language Models
+ */
+/**
+ * Chat message in the OpenAI format
+ */
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+/**
+ * Options for LLM chat completion
+ */
+export interface LLMOpts {
+    temperature?: number;
+    maxTokens?: number;
+    responseFormat?: "json" | "text";
+}
+/**
+ * LLM Provider interface
+ * Implementations provide chat completion functionality
+ */
+export interface LLMProvider {
+    chat(messages: ChatMessage[], opts?: LLMOpts): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/extractors/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extractors/providers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE"}

package/dist/extractors/providers/types.js

@@ -0,0 +1,6 @@
+/**
+ * LLM Provider interface and types
+ * Unified interface for calling Language Models
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extractors/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extractors/providers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/extractors/signal-extractor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Signal Extractor - Core LLM-based signal extraction
+ *
+ * Orchestrates the extraction of structured signals from conversation blocks:
+ * 1. Formats conversation into readable text
+ * 2. Calls LLM with structured JSON schema
+ * 3. Validates output with Zod
+ * 4. Retries once on validation failure with error feedback
+ * 5. Returns BlockResult (ok/failed) - never returns empty on failure
+ */
+import type { BlockResult, CanonicalisedBlock, ConversationBlock, SourceRef } from "../core/types.js";
+import type { LLMProvider } from "./providers/types.js";
+/**
+ * Signal Extractor interface
+ */
+export interface SignalExtractor {
+    extract(input: CanonicalisedBlock | ConversationBlock): Promise<BlockResult>;
+}
+/**
+ * Build a "Detected Structural Signals" hint section from quick-entity extraction.
+ * Returns empty string when no entities are found (no section injected).
+ * Exported for unit testing.
+ */
+export declare function buildEntityHintsSection(text: string): string;
+export declare function buildSourceRef(input: ConversationBlock | CanonicalisedBlock): SourceRef;
+/**
+ * Create a signal extractor with the given LLM provider
+ */
+export declare function createSignalExtractor(provider: LLMProvider): SignalExtractor;
+//# sourceMappingURL=signal-extractor.d.ts.map

package/dist/extractors/signal-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/signal-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EAGjB,SAAS,EAEV,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAsDrE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAWD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB5D;AA6ED,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,CAuDvF;AA2BD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,eAAe,CAwH5E"}