memhook 0.2.0

package/dist/src/providers/anthropic.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Anthropic provider — Haiku 4.5 default for memhook.
+ *
+ * Wire format:
+ *   POST https://api.anthropic.com/v1/messages
+ *   Headers: x-api-key, anthropic-version
+ *   Body: { model, max_tokens, system: [{type, text, cache_control}], messages }
+ *
+ * Anthropic-specific concepts (ephemeral prompt caching, `anthropic-beta`
+ * headers) are passed via `AnthropicProviderOptions` at construction time, NOT
+ * through the shared `SelectionRequest` — so the OpenAI and Ollama adapters
+ * never see them. Cache control TTL "1h" is GA in 2026; no beta header is
+ * required, but a non-empty `betaHeaders` list still maps to `anthropic-beta`
+ * for forward-compat.
+ *
+ * Retry: single retry on 429/503 with 500ms backoff (max 2 attempts), via the
+ * shared `postJsonWithRetry` transport.
+ */
+import type { Provider, ProviderConfig, SelectionRequest, SelectionResponse } from "./types.js";
+/** Anthropic-only knobs, kept off the shared provider interface. */
+export interface AnthropicProviderOptions {
+    betaHeaders?: string[];
+    cacheControlTtl?: "5m" | "1h";
+}
+export declare class AnthropicProvider implements Provider {
+    private readonly config;
+    private readonly options;
+    readonly name = "anthropic";
+    private readonly apiKey;
+    constructor(config: ProviderConfig, options?: AnthropicProviderOptions);
+    select(req: SelectionRequest): Promise<SelectionResponse>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/src/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAGpB,oEAAoE;AACpE,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC/B;AAOD,qBAAa,iBAAkB,YAAW,QAAQ;IAK9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,wBAA6B;IAOnD,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAuChE"}

package/dist/src/providers/anthropic.js

@@ -0,0 +1,98 @@
+/**
+ * Anthropic provider — Haiku 4.5 default for memhook.
+ *
+ * Wire format:
+ *   POST https://api.anthropic.com/v1/messages
+ *   Headers: x-api-key, anthropic-version
+ *   Body: { model, max_tokens, system: [{type, text, cache_control}], messages }
+ *
+ * Anthropic-specific concepts (ephemeral prompt caching, `anthropic-beta`
+ * headers) are passed via `AnthropicProviderOptions` at construction time, NOT
+ * through the shared `SelectionRequest` — so the OpenAI and Ollama adapters
+ * never see them. Cache control TTL "1h" is GA in 2026; no beta header is
+ * required, but a non-empty `betaHeaders` list still maps to `anthropic-beta`
+ * for forward-compat.
+ *
+ * Retry: single retry on 429/503 with 500ms backoff (max 2 attempts), via the
+ * shared `postJsonWithRetry` transport.
+ */
+import { postJsonWithRetry } from "./http.js";
+const ANTHROPIC_VERSION = "2023-06-01";
+const DEFAULT_BASE_URL = "https://api.anthropic.com/v1/messages";
+const RETRY_BACKOFF_MS = 500;
+const RETRY_STATUSES = [429, 503];
+export class AnthropicProvider {
+    config;
+    options;
+    name = "anthropic";
+    apiKey;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.options = options;
+        if (!config.apiKey)
+            throw new Error("AnthropicProvider: apiKey is required");
+        if (!config.model)
+            throw new Error("AnthropicProvider: model is required");
+        this.apiKey = config.apiKey;
+    }
+    async select(req) {
+        const ttl = this.options.cacheControlTtl;
+        const body = JSON.stringify({
+            model: this.config.model,
+            max_tokens: req.maxOutputTokens,
+            system: [
+                {
+                    type: "text",
+                    text: req.systemPrompt,
+                    cache_control: ttl ? { type: "ephemeral", ttl } : { type: "ephemeral" },
+                },
+            ],
+            messages: [{ role: "user", content: req.userPrompt }],
+        });
+        const headers = {
+            "Content-Type": "application/json",
+            "x-api-key": this.apiKey,
+            "anthropic-version": ANTHROPIC_VERSION,
+        };
+        const betas = this.options.betaHeaders ?? [];
+        if (betas.length > 0)
+            headers["anthropic-beta"] = betas.join(",");
+        const { json, httpStatus, latencyMs } = await postJsonWithRetry({
+            url: this.config.baseUrl ?? DEFAULT_BASE_URL,
+            headers,
+            body,
+            timeoutMs: req.timeoutMs,
+            retryStatuses: RETRY_STATUSES,
+            backoffMs: RETRY_BACKOFF_MS,
+        });
+        return {
+            rawText: extractText(json),
+            usage: extractUsage(json),
+            latencyMs,
+            httpStatus,
+        };
+    }
+}
+function extractText(json) {
+    if (!json)
+        return "";
+    const content = json["content"];
+    if (!Array.isArray(content))
+        return "";
+    const first = content[0];
+    return typeof first?.text === "string" ? first.text : "";
+}
+function extractUsage(json) {
+    const usage = json?.["usage"] ?? {};
+    const num = (key) => {
+        const v = usage[key];
+        return typeof v === "number" ? v : 0;
+    };
+    return {
+        inputTokens: num("input_tokens"),
+        outputTokens: num("output_tokens"),
+        cacheCreateTokens: num("cache_creation_input_tokens"),
+        cacheReadTokens: num("cache_read_input_tokens"),
+    };
+}
+//# sourceMappingURL=anthropic.js.map

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

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

package/dist/src/providers/factory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Provider factory — builds the configured provider from `MemhookConfig`.
+ *
+ * The router imports only this factory, never the concrete adapter classes, so
+ * provider selection lives in exactly one place. The `never` default arm gives
+ * a compile error if a new `provider.type` union member is added without a
+ * matching case here.
+ *
+ * Construction may throw (e.g. a required field missing) — the router wraps the
+ * call in try/catch and falls back to empty `additionalContext` (fail-soft).
+ */
+import type { Provider } from "./types.js";
+import type { MemhookConfig } from "../config.js";
+export declare function createProvider(cfg: MemhookConfig, apiKey: string | undefined): Provider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/providers/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAsBvF"}

package/dist/src/providers/factory.js

@@ -0,0 +1,37 @@
+/**
+ * Provider factory — builds the configured provider from `MemhookConfig`.
+ *
+ * The router imports only this factory, never the concrete adapter classes, so
+ * provider selection lives in exactly one place. The `never` default arm gives
+ * a compile error if a new `provider.type` union member is added without a
+ * matching case here.
+ *
+ * Construction may throw (e.g. a required field missing) — the router wraps the
+ * call in try/catch and falls back to empty `additionalContext` (fail-soft).
+ */
+import { AnthropicProvider } from "./anthropic.js";
+import { OpenAIProvider } from "./openai.js";
+import { OllamaProvider } from "./ollama.js";
+export function createProvider(cfg, apiKey) {
+    const base = {
+        model: cfg.provider.model,
+        ...(apiKey !== undefined && { apiKey }),
+        ...(cfg.provider.baseUrl !== undefined && { baseUrl: cfg.provider.baseUrl }),
+    };
+    switch (cfg.provider.type) {
+        case "anthropic":
+            return new AnthropicProvider(base, {
+                betaHeaders: cfg.provider.betaHeaders,
+                cacheControlTtl: cfg.selection.cacheControlTtl,
+            });
+        case "openai":
+            return new OpenAIProvider(base);
+        case "ollama":
+            return new OllamaProvider(base);
+        default: {
+            const exhaustive = cfg.provider.type;
+            throw new Error(`createProvider: unknown provider type ${String(exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/src/providers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/providers/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,cAAc,CAAC,GAAkB,EAAE,MAA0B;IAC3E,MAAM,IAAI,GAAmB;QAC3B,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK;QACzB,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;KAC7E,CAAC;IAEF,QAAQ,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,WAAW;YACd,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE;gBACjC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,WAAW;gBACrC,eAAe,EAAE,GAAG,CAAC,SAAS,CAAC,eAAe;aAC/C,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/providers/http.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared HTTP transport for providers — one audited network path.
+ *
+ * Every provider POSTs JSON and wants the same behaviour: an AbortController
+ * timeout, a single retry on a transient failure (network error or a
+ * retryable status), latency measurement, and a tolerant JSON parse that
+ * never throws on a malformed body. Centralising it keeps the fail-soft
+ * contract verifiable in one place (failsoft-auditor rules 4 + 7) instead of
+ * being re-implemented per adapter.
+ *
+ * Semantics (identical to memhook v0.1's Anthropic path):
+ *   - max 2 attempts.
+ *   - attempt 1 throws (network error) -> backoff, retry.
+ *   - attempt 1 returns a retryable status -> backoff, retry.
+ *   - attempt 2 throws -> rethrow (caller's try/catch -> fail-soft).
+ *   - otherwise return the parsed body (or null if the body wasn't JSON).
+ */
+export interface PostJsonOptions {
+    url: string;
+    headers: Record<string, string>;
+    body: string;
+    timeoutMs: number;
+    /** HTTP statuses worth a single retry (e.g. 429, 503). */
+    retryStatuses: readonly number[];
+    backoffMs: number;
+}
+export interface RawHttpResult {
+    /** Parsed JSON body, or null when the body was absent/not valid JSON. */
+    json: Record<string, unknown> | null;
+    httpStatus: number;
+    latencyMs: number;
+}
+export declare function postJsonWithRetry(opts: PostJsonOptions): Promise<RawHttpResult>;
+//# sourceMappingURL=http.d.ts.map

package/dist/src/providers/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/providers/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAuCrF"}

package/dist/src/providers/http.js

@@ -0,0 +1,60 @@
+/**
+ * Shared HTTP transport for providers — one audited network path.
+ *
+ * Every provider POSTs JSON and wants the same behaviour: an AbortController
+ * timeout, a single retry on a transient failure (network error or a
+ * retryable status), latency measurement, and a tolerant JSON parse that
+ * never throws on a malformed body. Centralising it keeps the fail-soft
+ * contract verifiable in one place (failsoft-auditor rules 4 + 7) instead of
+ * being re-implemented per adapter.
+ *
+ * Semantics (identical to memhook v0.1's Anthropic path):
+ *   - max 2 attempts.
+ *   - attempt 1 throws (network error) -> backoff, retry.
+ *   - attempt 1 returns a retryable status -> backoff, retry.
+ *   - attempt 2 throws -> rethrow (caller's try/catch -> fail-soft).
+ *   - otherwise return the parsed body (or null if the body wasn't JSON).
+ */
+export async function postJsonWithRetry(opts) {
+    let last = null;
+    for (let attempt = 1; attempt <= 2; attempt++) {
+        const started = Date.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), opts.timeoutMs);
+        let resp;
+        try {
+            resp = await fetch(opts.url, {
+                method: "POST",
+                headers: opts.headers,
+                body: opts.body,
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (attempt === 1) {
+                await sleep(opts.backoffMs);
+                continue;
+            }
+            throw err;
+        }
+        clearTimeout(timer);
+        const latencyMs = Date.now() - started;
+        const status = resp.status;
+        if (attempt === 1 && opts.retryStatuses.includes(status)) {
+            await sleep(opts.backoffMs);
+            continue;
+        }
+        const json = (await resp.json().catch(() => null));
+        last = { json, httpStatus: status, latencyMs };
+        break;
+    }
+    if (!last) {
+        throw new Error("postJsonWithRetry: no response after retries");
+    }
+    return last;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=http.js.map

package/dist/src/providers/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/providers/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmBH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAqB;IAC3D,IAAI,IAAI,GAAyB,IAAI,CAAC;IACtC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,IAAc,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC3B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;gBAClB,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,IAAI,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAmC,CAAC;QACrF,IAAI,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/C,MAAM;IACR,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/providers/ollama.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ollama provider — local models, `llama3.1` default.
+ *
+ * Wire format (native chat endpoint, NOT the OpenAI-compat layer):
+ *   POST http://localhost:11434/api/chat
+ *   No Authorization header (local Ollama needs no key).
+ *   Body: { model, messages, stream:false, format:"json", options:{temperature,num_predict} }
+ *
+ * The native `/api/chat` is preferred over `/v1/chat/completions` because it
+ * exposes deterministic `options` first-class, returns a flat
+ * `message.content` + top-level token counts (matching memhook's response
+ * shape), and requires no dummy `api_key` the OpenAI-compat clients demand.
+ * `stream:false` forces a single JSON body (otherwise the response is
+ * newline-delimited chunks that would break parsing). `format:"json"` nudges
+ * weaker local models toward parseable output; the router's `extractJsonArray`
+ * still pulls the basename array out tolerantly.
+ *
+ * Fail-soft notes: a missing model (404 `model 'x' not found`) or a stopped
+ * daemon (ECONNREFUSED) surfaces as empty `rawText` / a thrown fetch, both of
+ * which the router treats as an empty selection. Cold model load can be slow,
+ * so the config layer gives Ollama a more generous default timeout.
+ */
+import type { Provider, ProviderConfig, SelectionRequest, SelectionResponse } from "./types.js";
+export declare class OllamaProvider implements Provider {
+    private readonly config;
+    readonly name = "ollama";
+    constructor(config: ProviderConfig);
+    select(req: SelectionRequest): Promise<SelectionResponse>;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/src/providers/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/providers/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAUpB,qBAAa,cAAe,YAAW,QAAQ;IAGjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,YAAY;gBAEI,MAAM,EAAE,cAAc;IAI7C,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmChE"}

package/dist/src/providers/ollama.js

@@ -0,0 +1,89 @@
+/**
+ * Ollama provider — local models, `llama3.1` default.
+ *
+ * Wire format (native chat endpoint, NOT the OpenAI-compat layer):
+ *   POST http://localhost:11434/api/chat
+ *   No Authorization header (local Ollama needs no key).
+ *   Body: { model, messages, stream:false, format:"json", options:{temperature,num_predict} }
+ *
+ * The native `/api/chat` is preferred over `/v1/chat/completions` because it
+ * exposes deterministic `options` first-class, returns a flat
+ * `message.content` + top-level token counts (matching memhook's response
+ * shape), and requires no dummy `api_key` the OpenAI-compat clients demand.
+ * `stream:false` forces a single JSON body (otherwise the response is
+ * newline-delimited chunks that would break parsing). `format:"json"` nudges
+ * weaker local models toward parseable output; the router's `extractJsonArray`
+ * still pulls the basename array out tolerantly.
+ *
+ * Fail-soft notes: a missing model (404 `model 'x' not found`) or a stopped
+ * daemon (ECONNREFUSED) surfaces as empty `rawText` / a thrown fetch, both of
+ * which the router treats as an empty selection. Cold model load can be slow,
+ * so the config layer gives Ollama a more generous default timeout.
+ */
+import { postJsonWithRetry } from "./http.js";
+const DEFAULT_BASE_URL = "http://localhost:11434/api/chat";
+const RETRY_BACKOFF_MS = 500;
+// No HTTP status is worth retrying for a local daemon (404 model-not-found /
+// 400 won't fix on retry); the shared transport still retries once on a thrown
+// network error, covering a transient connection blip.
+const RETRY_STATUSES = [];
+export class OllamaProvider {
+    config;
+    name = "ollama";
+    constructor(config) {
+        this.config = config;
+        if (!config.model)
+            throw new Error("OllamaProvider: model is required");
+    }
+    async select(req) {
+        const body = JSON.stringify({
+            model: this.config.model,
+            messages: [
+                { role: "system", content: req.systemPrompt },
+                { role: "user", content: req.userPrompt },
+            ],
+            stream: false,
+            format: "json",
+            options: {
+                temperature: 0,
+                num_predict: req.maxOutputTokens,
+            },
+        });
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        const { json, httpStatus, latencyMs } = await postJsonWithRetry({
+            url: this.config.baseUrl ?? DEFAULT_BASE_URL,
+            headers,
+            body,
+            timeoutMs: req.timeoutMs,
+            retryStatuses: RETRY_STATUSES,
+            backoffMs: RETRY_BACKOFF_MS,
+        });
+        return {
+            rawText: extractText(json),
+            usage: extractUsage(json),
+            latencyMs,
+            httpStatus,
+        };
+    }
+}
+function extractText(json) {
+    if (!json)
+        return "";
+    const message = json["message"];
+    return typeof message?.content === "string" ? message.content : "";
+}
+function extractUsage(json) {
+    const num = (key) => {
+        const v = json?.[key];
+        return typeof v === "number" ? v : 0;
+    };
+    return {
+        inputTokens: num("prompt_eval_count"),
+        outputTokens: num("eval_count"),
+        cacheCreateTokens: 0,
+        cacheReadTokens: 0,
+    };
+}
+//# sourceMappingURL=ollama.js.map

package/dist/src/providers/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../../src/providers/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,gBAAgB,GAAG,iCAAiC,CAAC;AAC3D,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,6EAA6E;AAC7E,+EAA+E;AAC/E,uDAAuD;AACvD,MAAM,cAAc,GAAG,EAAW,CAAC;AAEnC,MAAM,OAAO,cAAc;IAGI;IAFpB,IAAI,GAAG,QAAQ,CAAC;IAEzB,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;QACjD,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAqB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,YAAY,EAAE;gBAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE;aAC1C;YACD,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,WAAW,EAAE,CAAC;gBACd,WAAW,EAAE,GAAG,CAAC,eAAe;aACjC;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,iBAAiB,CAAC;YAC9D,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,gBAAgB;YAC5C,OAAO;YACP,IAAI;YACJ,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,aAAa,EAAE,cAAc;YAC7B,SAAS,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;YAC1B,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;YACzB,SAAS;YACT,UAAU;SACX,CAAC;IACJ,CAAC;CACF;AAED,SAAS,WAAW,CAAC,IAAoC;IACvD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAsC,CAAC;IACrE,OAAO,OAAO,OAAO,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,YAAY,CAAC,IAAoC;IACxD,MAAM,GAAG,GAAG,CAAC,GAAW,EAAU,EAAE;QAClC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC;IACF,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,mBAAmB,CAAC;QACrC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC;QAC/B,iBAAiB,EAAE,CAAC;QACpB,eAAe,EAAE,CAAC;KACnB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * OpenAI provider — `gpt-4o-mini` default.
+ *
+ * Wire format:
+ *   POST https://api.openai.com/v1/chat/completions
+ *   Headers: Authorization: Bearer <key>
+ *   Body: { model, messages: [{role:system},{role:user}], max_tokens, temperature }
+ *
+ * The static catalog is sent as the leading `system` message and the variable
+ * user prompt last, so OpenAI's automatic prompt caching (exact-prefix match,
+ * ≥1024 tokens) can engage on a large catalog with no per-request flag.
+ *
+ * We deliberately do NOT set `response_format`: the router's `extractJsonArray`
+ * already tolerantly pulls the basename array out of the raw text (and the
+ * shared system prompt asks for a bare JSON array, which JSON-object mode would
+ * fight). This keeps the adapter symmetric with Anthropic/Ollama — every
+ * provider returns `rawText` and the router owns parsing. `gpt-4o-mini` is a
+ * non-reasoning model, so plain `max_tokens` + `temperature: 0` apply (reasoning
+ * models would require `max_completion_tokens` and reject `temperature`).
+ *
+ * Retry: single retry on 429/5xx with 500ms backoff, via the shared transport.
+ */
+import type { Provider, ProviderConfig, SelectionRequest, SelectionResponse } from "./types.js";
+export declare class OpenAIProvider implements Provider {
+    private readonly config;
+    readonly name = "openai";
+    private readonly apiKey;
+    constructor(config: ProviderConfig);
+    select(req: SelectionRequest): Promise<SelectionResponse>;
+}
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAOpB,qBAAa,cAAe,YAAW,QAAQ;IAIjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEH,MAAM,EAAE,cAAc;IAM7C,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgChE"}

package/dist/src/providers/openai.js

@@ -0,0 +1,94 @@
+/**
+ * OpenAI provider — `gpt-4o-mini` default.
+ *
+ * Wire format:
+ *   POST https://api.openai.com/v1/chat/completions
+ *   Headers: Authorization: Bearer <key>
+ *   Body: { model, messages: [{role:system},{role:user}], max_tokens, temperature }
+ *
+ * The static catalog is sent as the leading `system` message and the variable
+ * user prompt last, so OpenAI's automatic prompt caching (exact-prefix match,
+ * ≥1024 tokens) can engage on a large catalog with no per-request flag.
+ *
+ * We deliberately do NOT set `response_format`: the router's `extractJsonArray`
+ * already tolerantly pulls the basename array out of the raw text (and the
+ * shared system prompt asks for a bare JSON array, which JSON-object mode would
+ * fight). This keeps the adapter symmetric with Anthropic/Ollama — every
+ * provider returns `rawText` and the router owns parsing. `gpt-4o-mini` is a
+ * non-reasoning model, so plain `max_tokens` + `temperature: 0` apply (reasoning
+ * models would require `max_completion_tokens` and reject `temperature`).
+ *
+ * Retry: single retry on 429/5xx with 500ms backoff, via the shared transport.
+ */
+import { postJsonWithRetry } from "./http.js";
+const DEFAULT_BASE_URL = "https://api.openai.com/v1/chat/completions";
+const RETRY_BACKOFF_MS = 500;
+const RETRY_STATUSES = [429, 500, 502, 503, 504];
+export class OpenAIProvider {
+    config;
+    name = "openai";
+    apiKey;
+    constructor(config) {
+        this.config = config;
+        if (!config.apiKey)
+            throw new Error("OpenAIProvider: apiKey is required");
+        if (!config.model)
+            throw new Error("OpenAIProvider: model is required");
+        this.apiKey = config.apiKey;
+    }
+    async select(req) {
+        const body = JSON.stringify({
+            model: this.config.model,
+            messages: [
+                { role: "system", content: req.systemPrompt },
+                { role: "user", content: req.userPrompt },
+            ],
+            max_tokens: req.maxOutputTokens,
+            temperature: 0,
+        });
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        const { json, httpStatus, latencyMs } = await postJsonWithRetry({
+            url: this.config.baseUrl ?? DEFAULT_BASE_URL,
+            headers,
+            body,
+            timeoutMs: req.timeoutMs,
+            retryStatuses: RETRY_STATUSES,
+            backoffMs: RETRY_BACKOFF_MS,
+        });
+        return {
+            rawText: extractText(json),
+            usage: extractUsage(json),
+            latencyMs,
+            httpStatus,
+        };
+    }
+}
+function extractText(json) {
+    if (!json)
+        return "";
+    const choices = json["choices"];
+    if (!Array.isArray(choices))
+        return "";
+    const first = choices[0];
+    const content = first?.message?.content;
+    return typeof content === "string" ? content : "";
+}
+function extractUsage(json) {
+    const usage = json?.["usage"] ?? {};
+    const num = (key) => {
+        const v = usage[key];
+        return typeof v === "number" ? v : 0;
+    };
+    const details = usage["prompt_tokens_details"] ?? {};
+    const cachedTokens = typeof details["cached_tokens"] === "number" ? details["cached_tokens"] : 0;
+    return {
+        inputTokens: num("prompt_tokens"),
+        outputTokens: num("completion_tokens"),
+        cacheCreateTokens: 0,
+        cacheReadTokens: cachedTokens,
+    };
+}
+//# sourceMappingURL=openai.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Provider interface — memhook abstracts the LLM call behind a common shape.
+ *
+ * The contract is deliberately provider-agnostic: a provider takes a
+ * `SelectionRequest` (system prompt + user prompt + caps) and returns a
+ * normalised `SelectionResponse` (raw text + token usage + latency). The
+ * router owns parsing the raw text into a basename array, so every provider
+ * looks identical from the pipeline's point of view.
+ *
+ * Provider-specific concepts must NOT leak here. Anthropic's ephemeral cache
+ * control and `anthropic-beta` headers live in `AnthropicProviderOptions`
+ * (passed to the Anthropic adapter's constructor), never on this interface.
+ *
+ * v0.2 ships AnthropicProvider, OpenAIProvider and OllamaProvider, built via
+ * `createProvider()` in `factory.ts`.
+ */
+export interface ProviderConfig {
+    /** API key. Optional — local providers (Ollama) require none. */
+    apiKey?: string;
+    model: string;
+    /** Override the provider's default API endpoint. */
+    baseUrl?: string;
+}
+export interface SelectionRequest {
+    systemPrompt: string;
+    userPrompt: string;
+    maxOutputTokens: number;
+    timeoutMs: number;
+}
+export interface UsageBreakdown {
+    inputTokens: number;
+    outputTokens: number;
+    /** Cache-write tokens. 0 for providers without explicit cache control. */
+    cacheCreateTokens: number;
+    /** Cache-read tokens (Anthropic `cache_read`, OpenAI `cached_tokens`). */
+    cacheReadTokens: number;
+}
+export interface SelectionResponse {
+    rawText: string;
+    usage: UsageBreakdown;
+    latencyMs: number;
+    httpStatus: number;
+}
+export interface Provider {
+    readonly name: string;
+    select(req: SelectionRequest): Promise<SelectionResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3D"}

package/dist/src/providers/types.js

@@ -0,0 +1,18 @@
+/**
+ * Provider interface — memhook abstracts the LLM call behind a common shape.
+ *
+ * The contract is deliberately provider-agnostic: a provider takes a
+ * `SelectionRequest` (system prompt + user prompt + caps) and returns a
+ * normalised `SelectionResponse` (raw text + token usage + latency). The
+ * router owns parsing the raw text into a basename array, so every provider
+ * looks identical from the pipeline's point of view.
+ *
+ * Provider-specific concepts must NOT leak here. Anthropic's ephemeral cache
+ * control and `anthropic-beta` headers live in `AnthropicProviderOptions`
+ * (passed to the Anthropic adapter's constructor), never on this interface.
+ *
+ * v0.2 ships AnthropicProvider, OpenAIProvider and OllamaProvider, built via
+ * `createProvider()` in `factory.ts`.
+ */
+export {};
+//# sourceMappingURL=types.js.map