@adminiumjs/llm 0.1.0-rc.1

package/dist/providers/model-catalog.js

@@ -0,0 +1,121 @@
+/**
+ * Model catalog (06-llm-assist.md §3.1 matrix): static fallback lists plus the
+ * live `listModels()` fetchers each client delegates to. Fetchers hit the
+ * provider's model-list endpoint and fall back per the matrix:
+ *   - anthropic / openai → live, else the static list below
+ *   - openai-compatible  → live, tolerate 404 → `[]` (user free-texts the model)
+ *   - ollama             → live only (local models vary; no static fallback)
+ *
+ * The static ids are a conservative snapshot for offline/first-run UX; the live
+ * fetch is always attempted first, so a stale entry here never blocks a real model.
+ */
+import { requestJson } from './http.js';
+import { ProviderError } from './types.js';
+// ─── Static fallback lists ───────────────────────────────────────────────────
+export const ANTHROPIC_STATIC_MODELS = [
+    { id: 'claude-opus-4-8', label: 'Claude Opus 4.8' },
+    { id: 'claude-opus-4-7', label: 'Claude Opus 4.7' },
+    { id: 'claude-sonnet-5', label: 'Claude Sonnet 5' },
+    { id: 'claude-sonnet-4-6', label: 'Claude Sonnet 4.6' },
+    { id: 'claude-haiku-4-5', label: 'Claude Haiku 4.5' },
+];
+export const OPENAI_STATIC_MODELS = [
+    { id: 'gpt-4o', label: 'GPT-4o' },
+    { id: 'gpt-4o-mini', label: 'GPT-4o mini' },
+    { id: 'gpt-4.1', label: 'GPT-4.1' },
+    { id: 'gpt-4.1-mini', label: 'GPT-4.1 mini' },
+];
+const ANTHROPIC_VERSION = '2023-06-01';
+/** `GET {baseUrl}/v1/models`; on any failure returns the static Anthropic list. */
+export async function listAnthropicModels(opts) {
+    const apiKey = opts.apiKey ?? '';
+    try {
+        const json = await requestJson({
+            provider: 'anthropic',
+            url: `${opts.baseUrl}/v1/models`,
+            headers: { 'x-api-key': apiKey, 'anthropic-version': ANTHROPIC_VERSION },
+            apiKey,
+            ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+        });
+        const models = (json.data ?? [])
+            .filter((m) => typeof m.id === 'string')
+            .map((m) => ({ id: m.id, label: m.display_name ?? m.id }));
+        return models.length > 0 ? models : [...ANTHROPIC_STATIC_MODELS];
+    }
+    catch {
+        return [...ANTHROPIC_STATIC_MODELS];
+    }
+}
+/**
+ * True for ids that name a chat/completions-capable OpenAI model usable for
+ * enrichment. The o-series reasoning models (`o1`/`o3`/`o4-*`) are deliberately
+ * EXCLUDED: the Chat Completions contract this client speaks (`max_tokens` +
+ * `temperature: 0`, both fixed by §3.1) is rejected by those models — they
+ * require `max_completion_tokens` and forbid `temperature ≠ 1`, so every
+ * enrichment call on them 400s. Since temperature 0 is a non-negotiable
+ * determinism mandate (`assertEnrichmentTemperature`), offering them would be a
+ * guaranteed dead end; we filter them out of the catalog entirely.
+ */
+function isOpenAiChatModel(id) {
+    return /gpt|chatgpt/i.test(id);
+}
+/** `GET {baseUrl}/models` filtered to chat models; on any failure returns the static OpenAI list. */
+export async function listOpenAiModels(opts) {
+    const apiKey = opts.apiKey ?? '';
+    try {
+        const json = await requestJson({
+            provider: 'openai',
+            url: `${opts.baseUrl}/models`,
+            headers: { authorization: `Bearer ${apiKey}` },
+            apiKey,
+            ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+        });
+        const models = (json.data ?? [])
+            .filter((m) => typeof m.id === 'string' && isOpenAiChatModel(m.id))
+            .map((m) => ({ id: m.id, label: m.id }));
+        return models.length > 0 ? models : [...OPENAI_STATIC_MODELS];
+    }
+    catch {
+        return [...OPENAI_STATIC_MODELS];
+    }
+}
+/**
+ * `GET {baseUrl}/models` for an OpenAI-compatible endpoint. A 404 (endpoint not
+ * implemented) is tolerated → `[]`, signalling the UI to offer a free-text model
+ * field. Other failures (auth, network, 5xx) propagate as `ProviderError`.
+ */
+export async function listOpenAiCompatibleModels(opts) {
+    const apiKey = opts.apiKey;
+    const headers = {};
+    if (apiKey !== undefined && apiKey.trim() !== '')
+        headers['authorization'] = `Bearer ${apiKey}`;
+    try {
+        const json = await requestJson({
+            provider: 'openai-compatible',
+            url: `${opts.baseUrl}/models`,
+            headers,
+            ...(apiKey !== undefined ? { apiKey } : {}),
+            ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+        });
+        return (json.data ?? [])
+            .filter((m) => typeof m.id === 'string')
+            .map((m) => ({ id: m.id, label: m.id }));
+    }
+    catch (err) {
+        if (err instanceof ProviderError && err.code === 'not_found')
+            return [];
+        throw err;
+    }
+}
+/** `GET {baseUrl}/api/tags`; no static fallback — propagates `ProviderError` on failure. */
+export async function listOllamaModels(opts) {
+    const json = await requestJson({
+        provider: 'ollama',
+        url: `${opts.baseUrl}/api/tags`,
+        ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+    });
+    return (json.models ?? [])
+        .filter((m) => typeof m.name === 'string')
+        .map((m) => ({ id: m.name, label: m.name }));
+}
+//# sourceMappingURL=model-catalog.js.map

package/dist/providers/model-catalog.js.map

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

package/dist/providers/ollama.d.ts

@@ -0,0 +1,3 @@
+import { type ProviderClient, type ProviderConfig } from './types.js';
+export declare function createOllamaClient(config: ProviderConfig): ProviderClient;
+//# sourceMappingURL=ollama.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/providers/ollama.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAgDzE"}

package/dist/providers/ollama.js

@@ -0,0 +1,55 @@
+/**
+ * Local Ollama client (06-llm-assist.md §3.1): no auth, `baseUrl` defaults to
+ * `http://localhost:11434`. POST `/api/chat` (non-streaming); `GET /api/tags`
+ * for the model list. The only direct provider promoted in Electron offline mode.
+ * temperature (fixed 0) goes in `options` per the Ollama chat API.
+ */
+import { pingComplete, requestJson, toCompleteResult } from './http.js';
+import { listOllamaModels } from './model-catalog.js';
+import { assertEnrichmentTemperature, ProviderError, requireModel, stripTrailingSlash, } from './types.js';
+const DEFAULT_BASE_URL = 'http://localhost:11434';
+export function createOllamaClient(config) {
+    const baseUrl = config.baseUrl ? stripTrailingSlash(config.baseUrl) : DEFAULT_BASE_URL;
+    const timeoutMs = config.timeoutMs;
+    const client = {
+        id: 'ollama',
+        async listModels() {
+            return listOllamaModels({ baseUrl, ...(timeoutMs !== undefined ? { timeoutMs } : {}) });
+        },
+        async complete(req) {
+            assertEnrichmentTemperature(req.temperature, 'ollama');
+            const messages = [];
+            if (req.system.length > 0)
+                messages.push({ role: 'system', content: req.system });
+            for (const m of req.messages)
+                messages.push({ role: m.role, content: m.content });
+            const json = await requestJson({
+                provider: 'ollama',
+                method: 'POST',
+                url: `${baseUrl}/api/chat`,
+                headers: { 'content-type': 'application/json' },
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+                body: {
+                    model: req.model,
+                    messages,
+                    stream: false,
+                    options: { temperature: req.temperature, num_predict: req.maxTokens },
+                },
+            });
+            const text = json.message?.content;
+            if (typeof text !== 'string' || text.length === 0) {
+                throw new ProviderError({
+                    provider: 'ollama',
+                    code: 'bad_response',
+                    message: 'ollama: response contained no message content',
+                });
+            }
+            return toCompleteResult(text, json.prompt_eval_count, json.eval_count);
+        },
+        async test() {
+            return pingComplete(client, requireModel(config, 'ollama'));
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=ollama.js.map

package/dist/providers/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../src/providers/ollama.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,2BAA2B,EAC3B,aAAa,EACb,YAAY,EACZ,kBAAkB,GAGnB,MAAM,YAAY,CAAC;AAEpB,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAQlD,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACvF,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAEnC,MAAM,MAAM,GAAmB;QAC7B,EAAE,EAAE,QAAQ;QAEZ,KAAK,CAAC,UAAU;YACd,OAAO,gBAAgB,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,GAAG;YAChB,2BAA2B,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAwC,EAAE,CAAC;YACzD,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAClF,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAElF,MAAM,IAAI,GAAG,MAAM,WAAW,CAAqB;gBACjD,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,GAAG,OAAO,WAAW;gBAC1B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,IAAI,EAAE;oBACJ,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,QAAQ;oBACR,MAAM,EAAE,KAAK;oBACb,OAAO,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,CAAC,SAAS,EAAE;iBACtE;aACF,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;YACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,aAAa,CAAC;oBACtB,QAAQ,EAAE,QAAQ;oBAClB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,+CAA+C;iBACzD,CAAC,CAAC;YACL,CAAC;YACD,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACzE,CAAC;QAED,KAAK,CAAC,IAAI;YACR,OAAO,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/providers/openai-compatible.d.ts

@@ -0,0 +1,3 @@
+import { type ProviderClient, type ProviderConfig } from './types.js';
+export declare function createOpenAiCompatibleClient(config: ProviderConfig): ProviderClient;
+//# sourceMappingURL=openai-compatible.d.ts.map

package/dist/providers/openai-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../src/providers/openai-compatible.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA2CnF"}

package/dist/providers/openai-compatible.js

@@ -0,0 +1,50 @@
+/**
+ * OpenAI-compatible client (06-llm-assist.md §3.1): same Chat Completions wire
+ * format as OpenAI against a user-supplied `baseUrl` (Groq, Together, vLLM, LM
+ * Studio, …). The Bearer key is optional; the model-list endpoint may be absent,
+ * so a 404 is tolerated → empty list → free-text model field in the UI.
+ */
+import { buildOpenAiChatBody, parseOpenAiChatResponse, } from './openai.js';
+import { pingComplete, requestJson } from './http.js';
+import { listOpenAiCompatibleModels } from './model-catalog.js';
+import { assertEnrichmentTemperature, requireBaseUrl, requireModel, } from './types.js';
+export function createOpenAiCompatibleClient(config) {
+    const baseUrl = requireBaseUrl(config, 'openai-compatible');
+    const apiKey = config.apiKey; // optional
+    const hasKey = apiKey !== undefined && apiKey.trim() !== '';
+    const timeoutMs = config.timeoutMs;
+    const headers = () => {
+        const h = { 'content-type': 'application/json' };
+        if (hasKey)
+            h['authorization'] = `Bearer ${apiKey ?? ''}`;
+        return h;
+    };
+    const client = {
+        id: 'openai-compatible',
+        async listModels() {
+            return listOpenAiCompatibleModels({
+                baseUrl,
+                ...(hasKey ? { apiKey } : {}),
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+            });
+        },
+        async complete(req) {
+            assertEnrichmentTemperature(req.temperature, 'openai-compatible');
+            const json = await requestJson({
+                provider: 'openai-compatible',
+                method: 'POST',
+                url: `${baseUrl}/chat/completions`,
+                headers: headers(),
+                ...(hasKey ? { apiKey } : {}),
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+                body: buildOpenAiChatBody(req),
+            });
+            return parseOpenAiChatResponse(json, 'openai-compatible');
+        },
+        async test() {
+            return pingComplete(client, requireModel(config, 'openai-compatible'));
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=openai-compatible.js.map

package/dist/providers/openai-compatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.js","sourceRoot":"","sources":["../../src/providers/openai-compatible.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,YAAY,GAGb,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,4BAA4B,CAAC,MAAsB;IACjE,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW;IACzC,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAEnC,MAAM,OAAO,GAAG,GAA2B,EAAE;QAC3C,MAAM,CAAC,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QACzE,IAAI,MAAM;YAAE,CAAC,CAAC,eAAe,CAAC,GAAG,UAAU,MAAM,IAAI,EAAE,EAAE,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,MAAM,MAAM,GAAmB;QAC7B,EAAE,EAAE,mBAAmB;QAEvB,KAAK,CAAC,UAAU;YACd,OAAO,0BAA0B,CAAC;gBAChC,OAAO;gBACP,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,GAAG;YAChB,2BAA2B,CAAC,GAAG,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;YAClE,MAAM,IAAI,GAAG,MAAM,WAAW,CAAqB;gBACjD,QAAQ,EAAE,mBAAmB;gBAC7B,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,GAAG,OAAO,mBAAmB;gBAClC,OAAO,EAAE,OAAO,EAAE;gBAClB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,IAAI,EAAE,mBAAmB,CAAC,GAAG,CAAC;aAC/B,CAAC,CAAC;YACH,OAAO,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAC5D,CAAC;QAED,KAAK,CAAC,IAAI;YACR,OAAO,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACzE,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,18 @@
+import { type CompleteRequest, type CompleteResult, type ProviderClient, type ProviderConfig, type ProviderId } from './types.js';
+export interface OpenAiChatResponse {
+    choices?: {
+        message?: {
+            content?: string | null;
+        };
+    }[];
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+    };
+}
+/** Builds the Chat Completions request body, prepending the system message when present. */
+export declare function buildOpenAiChatBody(req: CompleteRequest): Record<string, unknown>;
+/** Extracts assistant text + token usage from a Chat Completions response. */
+export declare function parseOpenAiChatResponse(json: OpenAiChatResponse, provider: ProviderId): CompleteResult;
+export declare function createOpenAiClient(config: ProviderConfig): ProviderClient;
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAOA,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,EAAE,CAAC;IACtD,KAAK,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUjF;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,UAAU,GAAG,cAAc,CAUtG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAqCzE"}

package/dist/providers/openai.js

@@ -0,0 +1,68 @@
+/**
+ * OpenAI Chat Completions client (06-llm-assist.md §3.1). Auth: `Authorization:
+ * Bearer`; POST `/v1/chat/completions`. The wire-format helpers are exported and
+ * reused by the openai-compatible client. Fetch only, temperature fixed at 0.
+ */
+import { pingComplete, requestJson, toCompleteResult } from './http.js';
+import { listOpenAiModels } from './model-catalog.js';
+import { assertEnrichmentTemperature, ProviderError, requireApiKey, requireModel, stripTrailingSlash, } from './types.js';
+const DEFAULT_BASE_URL = 'https://api.openai.com/v1';
+/** Builds the Chat Completions request body, prepending the system message when present. */
+export function buildOpenAiChatBody(req) {
+    const messages = [];
+    if (req.system.length > 0)
+        messages.push({ role: 'system', content: req.system });
+    for (const m of req.messages)
+        messages.push({ role: m.role, content: m.content });
+    return {
+        model: req.model,
+        max_tokens: req.maxTokens,
+        temperature: req.temperature,
+        messages,
+    };
+}
+/** Extracts assistant text + token usage from a Chat Completions response. */
+export function parseOpenAiChatResponse(json, provider) {
+    const text = json.choices?.[0]?.message?.content;
+    if (typeof text !== 'string' || text.length === 0) {
+        throw new ProviderError({
+            provider,
+            code: 'bad_response',
+            message: `${provider}: response contained no message content`,
+        });
+    }
+    return toCompleteResult(text, json.usage?.prompt_tokens, json.usage?.completion_tokens);
+}
+export function createOpenAiClient(config) {
+    const apiKey = requireApiKey(config, 'openai');
+    const baseUrl = config.baseUrl ? stripTrailingSlash(config.baseUrl) : DEFAULT_BASE_URL;
+    const timeoutMs = config.timeoutMs;
+    const headers = () => ({
+        'content-type': 'application/json',
+        authorization: `Bearer ${apiKey}`,
+    });
+    const client = {
+        id: 'openai',
+        async listModels() {
+            return listOpenAiModels({ apiKey, baseUrl, ...(timeoutMs !== undefined ? { timeoutMs } : {}) });
+        },
+        async complete(req) {
+            assertEnrichmentTemperature(req.temperature, 'openai');
+            const json = await requestJson({
+                provider: 'openai',
+                method: 'POST',
+                url: `${baseUrl}/chat/completions`,
+                headers: headers(),
+                apiKey,
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+                body: buildOpenAiChatBody(req),
+            });
+            return parseOpenAiChatResponse(json, 'openai');
+        },
+        async test() {
+            return pingComplete(client, requireModel(config, 'openai'));
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=openai.js.map

package/dist/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/providers/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Provider client contracts (06-llm-assist.md §3.1). The `ProviderClient`
+ * interface below is reproduced VERBATIM from the doc — it is the wire-layer
+ * boundary every direct-API path speaks through. Everything here is browser-safe
+ * (pure TS + global `fetch`/`AbortController`); no provider SDKs, no `node:*`.
+ */
+import type { ProviderId } from '../types.js';
+export type { ProviderId } from '../types.js';
+export interface ProviderClient {
+    readonly id: ProviderId;
+    listModels(): Promise<{
+        id: string;
+        label: string;
+    }[]>;
+    complete(req: {
+        system: string;
+        messages: {
+            role: 'user' | 'assistant';
+            content: string;
+        }[];
+        model: string;
+        maxTokens: number;
+        temperature: number;
+    }): Promise<{
+        text: string;
+        usage?: {
+            inputTokens: number;
+            outputTokens: number;
+        };
+    }>;
+    test(): Promise<{
+        ok: true;
+        model: string;
+        latencyMs: number;
+    }>;
+}
+/**
+ * Resolved provider configuration a client is constructed from (§3.2). The
+ * `apiKey` is the DECRYPTED value: the server decrypts `llm.apiKey` (AES-256-GCM,
+ * see `crypto.ts`) before building a client, and the client keeps it only in the
+ * request header — never in a log, error, or thrown value (acceptance §10).
+ */
+export interface ProviderConfig {
+    provider: ProviderId;
+    /** Required for `anthropic`/`openai`; optional for `openai-compatible`; unused for `ollama`. */
+    apiKey?: string;
+    /** Required for `openai-compatible`; defaults to `http://localhost:11434` for `ollama`. */
+    baseUrl?: string;
+    /** Selected model id — required to `complete()` / `test()`. */
+    model?: string;
+    /** Response budget passed as `maxTokens`; default `16_000`. */
+    maxOutputTokens?: number;
+    /** Per-request timeout in ms; default `60_000`. */
+    timeoutMs?: number;
+}
+/** Structural alias for `ProviderClient.complete`'s argument (not part of the verbatim interface). */
+export interface CompleteRequest {
+    system: string;
+    messages: {
+        role: 'user' | 'assistant';
+        content: string;
+    }[];
+    model: string;
+    maxTokens: number;
+    temperature: number;
+}
+/** Structural alias for `ProviderClient.complete`'s result. */
+export interface CompleteResult {
+    text: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/** One entry in a model list (structural alias for `ProviderClient.listModels`'s element). */
+export interface ModelInfo {
+    id: string;
+    label: string;
+}
+export declare const DEFAULT_MAX_OUTPUT_TOKENS: 16000;
+export declare const DEFAULT_TIMEOUT_MS: 60000;
+/**
+ * Every non-2xx response and network/timeout failure is mapped to this. It is
+ * deliberately narrow and NEVER carries the API key: constructors scrub the
+ * secret out of any provider-supplied error body before it reaches a `message`.
+ */
+export type ProviderErrorCode = 'config' | 'network' | 'timeout' | 'auth' | 'rate_limit' | 'not_found' | 'server' | 'http' | 'bad_response';
+export interface ProviderErrorInit {
+    provider: ProviderId;
+    code: ProviderErrorCode;
+    message: string;
+    status?: number;
+    cause?: unknown;
+}
+export declare class ProviderError extends Error {
+    readonly name = "ProviderError";
+    readonly provider: ProviderId;
+    readonly code: ProviderErrorCode;
+    readonly status?: number;
+    constructor(init: ProviderErrorInit);
+}
+/**
+ * Enrichment runs are deterministic: temperature is fixed at 0, non-negotiable
+ * (§3.1). This asserts it at the client boundary so a misconfigured caller fails
+ * loudly rather than producing non-reproducible diffs.
+ */
+export declare function assertEnrichmentTemperature(temperature: number, provider: ProviderId): void;
+export declare function requireApiKey(config: ProviderConfig, provider: ProviderId): string;
+export declare function requireBaseUrl(config: ProviderConfig, provider: ProviderId): string;
+export declare function requireModel(config: ProviderConfig, provider: ProviderId): string;
+export declare function stripTrailingSlash(url: string): string;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/providers/types.js

@@ -0,0 +1,55 @@
+export const DEFAULT_MAX_OUTPUT_TOKENS = 16_000;
+export const DEFAULT_TIMEOUT_MS = 60_000;
+export class ProviderError extends Error {
+    name = 'ProviderError';
+    provider;
+    code;
+    status;
+    constructor(init) {
+        super(init.message, init.cause === undefined ? undefined : { cause: init.cause });
+        this.provider = init.provider;
+        this.code = init.code;
+        if (init.status !== undefined)
+            this.status = init.status;
+    }
+}
+// ─── Guards ──────────────────────────────────────────────────────────────────
+/**
+ * Enrichment runs are deterministic: temperature is fixed at 0, non-negotiable
+ * (§3.1). This asserts it at the client boundary so a misconfigured caller fails
+ * loudly rather than producing non-reproducible diffs.
+ */
+export function assertEnrichmentTemperature(temperature, provider) {
+    if (temperature !== 0) {
+        throw new ProviderError({
+            provider,
+            code: 'config',
+            message: `enrichment runs require temperature 0 (received ${String(temperature)})`,
+        });
+    }
+}
+export function requireApiKey(config, provider) {
+    const raw = config.apiKey;
+    if (raw === undefined || raw.trim() === '') {
+        throw new ProviderError({ provider, code: 'config', message: `${provider} requires an API key` });
+    }
+    return raw;
+}
+export function requireBaseUrl(config, provider) {
+    const raw = config.baseUrl;
+    if (raw === undefined || raw.trim() === '') {
+        throw new ProviderError({ provider, code: 'config', message: `${provider} requires a baseUrl` });
+    }
+    return stripTrailingSlash(raw);
+}
+export function requireModel(config, provider) {
+    const raw = config.model;
+    if (raw === undefined || raw.trim() === '') {
+        throw new ProviderError({ provider, code: 'config', message: `${provider} requires a model` });
+    }
+    return raw;
+}
+export function stripTrailingSlash(url) {
+    return url.replace(/\/+$/, '');
+}
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAoEA,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAe,CAAC;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAe,CAAC;AA4BlD,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpB,IAAI,GAAG,eAAe,CAAC;IAChC,QAAQ,CAAa;IACrB,IAAI,CAAoB;IACxB,MAAM,CAAU;IAEzB,YAAY,IAAuB;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3D,CAAC;CACF;AAED,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAmB,EAAE,QAAoB;IACnF,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,aAAa,CAAC;YACtB,QAAQ;YACR,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,mDAAmD,MAAM,CAAC,WAAW,CAAC,GAAG;SACnF,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAsB,EAAE,QAAoB;IACxE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,QAAQ,sBAAsB,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,QAAoB;IACzE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,QAAQ,qBAAqB,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAsB,EAAE,QAAoB;IACvE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;IACzB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,QAAQ,mBAAmB,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/response/errors.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Validation error model shared by the whole response pipeline
+ * (06-llm-assist.md §7.2). Every stage — extract, parse, version, Zod, locale,
+ * referential, run-binding — reports through the ONE {@link LlmValidationError}
+ * shape so the paste UI and the CLI `--dry-run` can render a single precise
+ * per-path list (§7.2).
+ *
+ * Two axes matter downstream:
+ *  - `code` — the machine code (§7.2/§7.3 tables), rendered verbatim.
+ *  - `severity` — how the pipeline reacts:
+ *      • `fatal`   → rejects the whole run (stays `awaiting_response` / `failed`).
+ *      • `item`    → drops only the offending suggestion; the rest applies
+ *                    (acceptance criterion 4 — a hallucinated table must not
+ *                    discard 200 good labels).
+ *      • `warning` → nothing dropped; surfaced as information (icon fallback,
+ *                    run-id mismatch).
+ *
+ * This module is pure data + string formatting: no Zod, no engine, no I/O — so
+ * it is safe for `@adminium/dashboard` (browser) to pull transitively.
+ */
+/** Every code the pipeline can emit (§7.2 stages + §7.3 referential list). */
+export declare const LLM_VALIDATION_CODES: readonly ["LLM_JSON_PARSE", "LLM_TRUNCATED", "LLM_VERSION_MISMATCH", "LLM_MODEL_DECLINED", "LLM_SCHEMA_INVALID", "LLM_LOCALE_KEYS", "LLM_UNKNOWN_TABLE", "LLM_UNKNOWN_COLUMN", "LLM_BAD_DISPLAY_COLUMN", "LLM_NOT_AN_ENUM", "LLM_ENUM_VALUES", "LLM_UNKNOWN_RELATION", "LLM_RELATION_INVALID", "LLM_UNKNOWN_TEMPLATE", "LLM_UNKNOWN_WIDGET", "LLM_WIDGET_BINDING", "LLM_GROUP_INVALID", "LLM_UNKNOWN_ICON", "LLM_RUN_MISMATCH"];
+export type LlmValidationCode = (typeof LLM_VALIDATION_CODES)[number];
+export type LlmValidationSeverity = 'fatal' | 'item' | 'warning';
+/**
+ * One validation failure. `path` is a JSON path into the response
+ * (`tables[3].table`, `dashboards[0].widgets[5].metricColumn`, `schema_version`,
+ * or `''` for the whole document) so the UI can point at the exact field.
+ * `message` is a human sentence rendered verbatim (§7.2).
+ */
+export interface LlmValidationError {
+    code: LlmValidationCode;
+    severity: LlmValidationSeverity;
+    /** JSON path into the response; `''` = the whole document. */
+    path: string;
+    message: string;
+    /** Extra remediation line (e.g. the §4.3 regeneration hint). */
+    hint?: string;
+    /** Stable §8.1 suggestion id of the dropped suggestion, when one applies. */
+    suggestionId?: string;
+}
+/** The fixed severity of a code (§7.2 "Failure class" column). */
+export declare function severityOf(code: LlmValidationCode): LlmValidationSeverity;
+export declare function isFatal(error: LlmValidationError): boolean;
+/**
+ * Render a Zod (or hand-built) path array as the pipeline's JSON-path string.
+ * Numeric segments become `[n]`; string segments join with `.`; the first
+ * segment carries no leading dot (`tables[3].table`, not `.tables[3].table`).
+ */
+export declare function formatJsonPath(segments: ReadonlyArray<string | number | symbol>): string;
+/**
+ * Build a validation error, stamping the code's fixed severity. `hint` /
+ * `suggestionId` are set only when provided (respects
+ * `exactOptionalPropertyTypes`).
+ */
+export declare function makeError(code: LlmValidationCode, path: string, message: string, extra?: {
+    hint?: string;
+    suggestionId?: string;
+}): LlmValidationError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/response/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/response/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,iaAwBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAYD,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAIzE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAWxF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,kBAAkB,CAUpB"}