@adminiumjs/llm 0.1.0-rc.1

package/dist/prompt/token-estimate.js

@@ -0,0 +1,20 @@
+/**
+ * The `chars / 3.6` heuristic token estimator (06-llm-assist.md §2, §4.5).
+ *
+ * Deliberately provider-agnostic and conservative: it slightly over-counts for
+ * typical English + JSON so a prompt that "fits" the budget fits every supported
+ * provider's real tokenizer with headroom. Pure and deterministic — no model
+ * download, no network, no `Date.now`/`Math.random`.
+ */
+/** Characters-per-token divisor (§4.5: `tokens ≈ ceil(chars / 3.6)`). */
+export const CHARS_PER_TOKEN = 3.6;
+/**
+ * Estimate the input-token count of `text` as `ceil(text.length / 3.6)`.
+ * Empty input is 0 tokens.
+ */
+export function estimateTokens(text) {
+    if (text.length === 0)
+        return 0;
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+//# sourceMappingURL=token-estimate.js.map

package/dist/prompt/token-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.js","sourceRoot":"","sources":["../../src/prompt/token-estimate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;AAClD,CAAC"}

package/dist/prompt/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Prompt-builder contract types (06-llm-assist.md §4.1, §4.4, §2).
+ *
+ * These are additive to T01's `response/schema.ts` + top-level `types.ts`: they
+ * name the builder's INPUT (`PromptInput`), the requested-section vocabulary
+ * (§4.4), the injected allow-lists, and the builder's OUTPUT (`PromptArtifact`).
+ * `PromptInput.schemaIr` is the engine IR (`DatabaseModel`) and `stats` is the
+ * engine's `StatsResult[]` (the shape every adapter's `collectTableStats`
+ * returns) — the doc's aspirational `SchemaIr` / `TableStats[]` names map onto
+ * these landed types.
+ *
+ * Browser-safe: type-only engine imports (erased at build), no runtime edge.
+ */
+import type { DatabaseModel, StatsResult } from '@adminium/engine';
+import type { LocaleCode } from '../response/schema.js';
+/**
+ * The ten decision groups the prompt asks for, mapped 1:1 to response keys
+ * (§4.4). The wizard lets the user deselect groups (all on by default); a
+ * deselected section's numbered decision block is removed from the rendered
+ * user text and its key becomes optional-and-ignored downstream.
+ */
+export declare const REQUESTED_SECTIONS: readonly ["labels", "groups", "enums", "relations", "keys", "templates", "widgets", "pii", "icons", "microcopy"];
+export type RequestedSection = (typeof REQUESTED_SECTIONS)[number];
+/** All ten sections, in canonical order — the default when the user deselects nothing. */
+export declare const ALL_SECTIONS: readonly RequestedSection[];
+/**
+ * Section → the 1-based number of its decision block in {@link PROMPT_V1_USER}
+ * (§5.2). The builder keeps the original numbering (never renumbers) so the
+ * cross-references inside the template — "for decision 6", "Skip decisions 2 and
+ * 7" — stay valid even when blocks are dropped; deselected blocks simply leave a
+ * gap in the sequence.
+ */
+export declare const SECTION_DECISION_NUMBER: Readonly<Record<RequestedSection, number>>;
+/**
+ * The closed vocabularies bounding what the model may suggest, injected as
+ * `{{ALLOWED_PAGE_TEMPLATE_IDS_JSON}}` / `{{ALLOWED_WIDGET_IDS_JSON}}`. In
+ * production these are `LLM_ALLOWED_TEMPLATES` / `LLM_ALLOWED_WIDGETS` from
+ * `@adminium/widgets` (derived from the live registries so prompt and runtime
+ * cannot drift — 06 §5). They are INJECTED rather than imported here to keep
+ * `@adminium/llm` browser-safe and dependency-minimal: the allow-lists live in
+ * the widgets *main* barrel, which pulls the React render layer, whereas this
+ * package must import only pure-Zod/pure-TS types (mirrors the engine rule that
+ * only the `@adminium/widgets/page-config` leaf may be imported). The server /
+ * dashboard callers, which already depend on `@adminium/widgets`, pass them in.
+ */
+export interface AllowedVocabularies {
+    /** `LLM_ALLOWED_TEMPLATES` — recommendable page-template ids. */
+    templates: readonly string[];
+    /** `LLM_ALLOWED_WIDGETS` — the curated dashboard-widget subset. */
+    widgets: readonly string[];
+}
+/**
+ * Sampling opt-in. `null` (default) ⇒ SAMPLE-FREE: no cell value from any table
+ * appears anywhere in the prompt (§1 invariant 5, acceptance criterion 8). When
+ * set, the sampling block adds up to `maxValuesPerColumn` most-common values +
+ * ordered min/max — but NEVER for PII-suspected or secret columns.
+ */
+export type Sampling = null | {
+    maxValuesPerColumn: number;
+};
+/**
+ * One (possibly chunked) prompt's worth of input. `schemaIr` is the
+ * post-inclusion IR (only included tables; PII-masked columns still listed as
+ * structure, flagged so the model can confirm/deny — §4.1).
+ */
+export interface PromptInput {
+    /** `adminium_schema_snapshots.id` this prompt was built from (recorded, not injected). */
+    snapshotId: string;
+    /** The classified schema IR (05-introspection-engine.md). */
+    schemaIr: DatabaseModel;
+    /** Aggregate statistics, one per table (engine `collectTableStats` output). */
+    stats: readonly StatsResult[];
+    /** Subset of the 8 canonical locales; MUST include `en_US` (§4.1). */
+    locales: readonly LocaleCode[];
+    /** Which decision groups to request (§4.4). Empty ⇒ treated as all sections. */
+    sections: readonly RequestedSection[];
+    /** `null` = sample-free (default). */
+    sampling: Sampling;
+    /** ULID; echoed (optionally) by the response. */
+    runId: string;
+    /** Present only for a chunked run (§4.5); the chunker (T04) fills it. */
+    chunk?: PromptChunkInfo;
+}
+/** Chunk placement for a map-phase prompt (§4.5). `index` is 1-based for display. */
+export interface PromptChunkInfo {
+    index: number;
+    total: number;
+    /** Qualified ids of out-of-chunk FK targets rendered as `"stub": true` context. */
+    stubTables: readonly string[];
+}
+/** Provider-agnostic input-token budget per prompt (§4.5). */
+export declare const DEFAULT_TOKEN_BUDGET = 60000;
+export interface BuildPromptOptions {
+    /** The closed vocabularies bounding suggestions (see {@link AllowedVocabularies}). */
+    allowed: AllowedVocabularies;
+    /** Input-token budget for the assembled user section (§4.5). Default {@link DEFAULT_TOKEN_BUDGET}. */
+    tokenBudget?: number;
+}
+/**
+ * One map-phase prompt. For an unchunked run the artifact carries exactly one
+ * chunk (`index: 1, total: 1`). The chunker (T04) produces the multi-chunk case;
+ * this shape is what it packs.
+ */
+export interface PromptChunk {
+    /** 1-based position; `1` and `total: 1` for an unchunked run. */
+    index: number;
+    total: number;
+    /** The system section sent for this chunk (identical across chunks). */
+    system: string;
+    /** The rendered user section for this chunk. */
+    user: string;
+    /** BYO flattening: `=== SYSTEM ===\n…\n\n=== USER ===\n…` (byte-identical between markers). */
+    byo: string;
+    /** `ceil(chars / 3.6)` over the flattened document (§4.5). */
+    tokenEstimate: number;
+}
+/**
+ * `buildPrompt(input, opts)` output. `system`/`user` are the direct-path
+ * messages; `byo` is their flattened copyable document; `chunks` holds the
+ * map-phase prompts (one entry when unchunked). `tokenEstimate` is over `byo`
+ * (what BYO shows under the copy button).
+ */
+export interface PromptArtifact {
+    system: string;
+    user: string;
+    byo: string;
+    chunks: PromptChunk[];
+    tokenEstimate: number;
+    /** Whether the assembled user section exceeds `opts.tokenBudget` (chunking hint for T04). */
+    overBudget: boolean;
+    /** The active sections after normalizing `input.sections` (empty ⇒ all). */
+    sections: readonly RequestedSection[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompt/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,kHAWrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,0FAA0F;AAC1F,eAAO,MAAM,YAAY,EAAE,SAAS,gBAAgB,EAAuB,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAW9E,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,mEAAmE;IACnE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAID;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG;IAAE,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC;AAI7D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,EAAE,aAAa,CAAC;IACxB,+EAA+E;IAC/E,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,sEAAsE;IACtE,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,sCAAsC;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAID,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,OAAO,EAAE,mBAAmB,CAAC;IAC7B,sGAAsG;IACtG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,UAAU,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACvC"}

package/dist/prompt/types.js

@@ -0,0 +1,44 @@
+// ─── Requested sections (§4.4) ───────────────────────────────────────────────
+/**
+ * The ten decision groups the prompt asks for, mapped 1:1 to response keys
+ * (§4.4). The wizard lets the user deselect groups (all on by default); a
+ * deselected section's numbered decision block is removed from the rendered
+ * user text and its key becomes optional-and-ignored downstream.
+ */
+export const REQUESTED_SECTIONS = [
+    'labels',
+    'groups',
+    'enums',
+    'relations',
+    'keys',
+    'templates',
+    'widgets',
+    'pii',
+    'icons',
+    'microcopy',
+];
+/** All ten sections, in canonical order — the default when the user deselects nothing. */
+export const ALL_SECTIONS = REQUESTED_SECTIONS;
+/**
+ * Section → the 1-based number of its decision block in {@link PROMPT_V1_USER}
+ * (§5.2). The builder keeps the original numbering (never renumbers) so the
+ * cross-references inside the template — "for decision 6", "Skip decisions 2 and
+ * 7" — stay valid even when blocks are dropped; deselected blocks simply leave a
+ * gap in the sequence.
+ */
+export const SECTION_DECISION_NUMBER = {
+    labels: 1,
+    groups: 2,
+    enums: 3,
+    relations: 4,
+    keys: 5,
+    templates: 6,
+    widgets: 7,
+    pii: 8,
+    icons: 9,
+    microcopy: 10,
+};
+// ─── Builder options ─────────────────────────────────────────────────────────
+/** Provider-agnostic input-token budget per prompt (§4.5). */
+export const DEFAULT_TOKEN_BUDGET = 60_000;
+//# sourceMappingURL=types.js.map

package/dist/prompt/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/prompt/types.ts"],"names":[],"mappings":"AAiBA,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,WAAW;IACX,MAAM;IACN,WAAW;IACX,SAAS;IACT,KAAK;IACL,OAAO;IACP,WAAW;CACH,CAAC;AAIX,0FAA0F;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAgC,kBAAkB,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA+C;IACjF,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;IACV,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,EAAE;CACd,CAAC;AAmEF,gFAAgF;AAEhF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC"}

package/dist/providers/anthropic.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAOA,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA4D5E"}

package/dist/providers/anthropic.js

@@ -0,0 +1,65 @@
+/**
+ * Anthropic Messages API client (06-llm-assist.md §3.1). Auth: `x-api-key` +
+ * `anthropic-version`; POST `/v1/messages` in the Messages wire format. Fetch
+ * only, no SDK. Enrichment temperature is fixed at 0 (asserted).
+ */
+import { pingComplete, requestJson, toCompleteResult } from './http.js';
+import { listAnthropicModels } from './model-catalog.js';
+import { assertEnrichmentTemperature, ProviderError, requireApiKey, requireModel, stripTrailingSlash, } from './types.js';
+const ANTHROPIC_VERSION = '2023-06-01';
+const DEFAULT_BASE_URL = 'https://api.anthropic.com';
+export function createAnthropicClient(config) {
+    const apiKey = requireApiKey(config, 'anthropic');
+    const baseUrl = config.baseUrl ? stripTrailingSlash(config.baseUrl) : DEFAULT_BASE_URL;
+    const timeoutMs = config.timeoutMs;
+    const headers = () => ({
+        'content-type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': ANTHROPIC_VERSION,
+    });
+    const client = {
+        id: 'anthropic',
+        async listModels() {
+            return listAnthropicModels({
+                apiKey,
+                baseUrl,
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+            });
+        },
+        async complete(req) {
+            assertEnrichmentTemperature(req.temperature, 'anthropic');
+            const json = await requestJson({
+                provider: 'anthropic',
+                method: 'POST',
+                url: `${baseUrl}/v1/messages`,
+                headers: headers(),
+                apiKey,
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+                body: {
+                    model: req.model,
+                    max_tokens: req.maxTokens,
+                    temperature: req.temperature,
+                    system: req.system,
+                    messages: req.messages.map((m) => ({ role: m.role, content: m.content })),
+                },
+            });
+            const text = (json.content ?? [])
+                .filter((block) => block.type === 'text' && typeof block.text === 'string')
+                .map((block) => block.text ?? '')
+                .join('');
+            if (text.length === 0) {
+                throw new ProviderError({
+                    provider: 'anthropic',
+                    code: 'bad_response',
+                    message: 'anthropic: response contained no text content',
+                });
+            }
+            return toCompleteResult(text, json.usage?.input_tokens, json.usage?.output_tokens);
+        },
+        async test() {
+            return pingComplete(client, requireModel(config, 'anthropic'));
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=anthropic.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAErF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAyB3E"}

package/dist/providers/factory.js

@@ -0,0 +1,37 @@
+/**
+ * Dispatches a `ProviderConfig` to the matching client constructor (§3.1).
+ * `adminium-managed` is intentionally unsupported here — that Cloud-relay client
+ * ships in M12, not this wave — and requesting it is a `config` error.
+ */
+import { createAnthropicClient } from './anthropic.js';
+import { createOllamaClient } from './ollama.js';
+import { createOpenAiCompatibleClient } from './openai-compatible.js';
+import { createOpenAiClient } from './openai.js';
+import { ProviderError } from './types.js';
+export function createProviderClient(config) {
+    switch (config.provider) {
+        case 'anthropic':
+            return createAnthropicClient(config);
+        case 'openai':
+            return createOpenAiClient(config);
+        case 'openai-compatible':
+            return createOpenAiCompatibleClient(config);
+        case 'ollama':
+            return createOllamaClient(config);
+        case 'adminium-managed':
+            throw new ProviderError({
+                provider: 'adminium-managed',
+                code: 'config',
+                message: 'the adminium-managed provider is not available in this build (M12)',
+            });
+        default: {
+            const exhaustive = config.provider;
+            throw new ProviderError({
+                provider: 'anthropic',
+                code: 'config',
+                message: `unknown provider: ${String(exhaustive)}`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/providers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAA4C,MAAM,YAAY,CAAC;AAErF,MAAM,UAAU,oBAAoB,CAAC,MAAsB;IACzD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,mBAAmB;YACtB,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;QAC9C,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,kBAAkB;YACrB,MAAM,IAAI,aAAa,CAAC;gBACtB,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,oEAAoE;aAC9E,CAAC,CAAC;QACL,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC,QAAQ,CAAC;YAC1C,MAAM,IAAI,aAAa,CAAC;gBACtB,QAAQ,EAAE,WAAW;gBACrB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,qBAAqB,MAAM,CAAC,UAAU,CAAC,EAAE;aACnD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/providers/http.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared fetch plumbing for the provider clients (06-llm-assist.md §3): one
+ * JSON request helper with a timeout, deterministic error mapping to
+ * `ProviderError`, and — the security-critical part (acceptance §10) — a secret
+ * scrubber that guarantees the API key never survives into a thrown/logged
+ * surface. Global `fetch` only; no SDKs, browser-safe.
+ */
+import { type CompleteResult, type ProviderClient, type ProviderId } from './types.js';
+/**
+ * Removes every occurrence of `secret` from `text`. Applied to any
+ * provider-supplied error body before it is placed in a `ProviderError.message`,
+ * so an echoed Authorization header or key fragment can never leak. A no-op when
+ * there is no secret to protect.
+ */
+export declare function scrubSecret(text: string, secret: string | undefined): string;
+/**
+ * Return an error safe to attach as a `ProviderError.cause` (acceptance §10): the
+ * key must not survive into ANY logged/inspected surface, and consumers walk the
+ * `[cause]` chain (`console.error`, `util.inspect`, pino/winston serializers).
+ * The original error's `message` — and its `stack`, which embeds the message —
+ * can echo an outgoing Authorization header, so when the secret appears anywhere
+ * in it we replace it with a fresh scrubbed `Error` (no key in message or stack).
+ * When there is no secret, or it does not appear, the original error is returned
+ * unchanged so genuine network diagnostics (DNS, ECONNREFUSED) are preserved.
+ */
+export declare function scrubCause(err: unknown, secret: string | undefined): unknown;
+export interface RequestJsonOptions {
+    provider: ProviderId;
+    url: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: unknown;
+    /** The secret to scrub from any error text (never sent anywhere else). */
+    apiKey?: string;
+    /** Abort after this many ms; defaults to `DEFAULT_TIMEOUT_MS`. */
+    timeoutMs?: number;
+}
+/**
+ * Performs a JSON request and parses the response, or throws a `ProviderError`.
+ * Non-2xx → status-mapped error (body scrubbed + snippeted); fetch rejection →
+ * `network`; our own abort → `timeout`; unparseable 2xx body → `bad_response`.
+ */
+export declare function requestJson<T>(opts: RequestJsonOptions): Promise<T>;
+/**
+ * Shared `ProviderClient.test()` implementation: a 1-token, temperature-0 ping
+ * through the client's own `complete()`, timing the round-trip. `performance.now`
+ * is intentionally not a determinism hazard — latency never feeds a prompt or diff.
+ */
+export declare function pingComplete(client: ProviderClient, model: string): Promise<{
+    ok: true;
+    model: string;
+    latencyMs: number;
+}>;
+/** Builds a `CompleteResult`, attaching `usage` only when both token counts are known. */
+export declare function toCompleteResult(text: string, inputTokens: number | undefined, outputTokens: number | undefined): CompleteResult;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/providers/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EAEnB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQ5E;AAUD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAyDzE;AAUD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAUzD;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,cAAc,CAMhB"}

package/dist/providers/http.js

@@ -0,0 +1,148 @@
+/**
+ * Shared fetch plumbing for the provider clients (06-llm-assist.md §3): one
+ * JSON request helper with a timeout, deterministic error mapping to
+ * `ProviderError`, and — the security-critical part (acceptance §10) — a secret
+ * scrubber that guarantees the API key never survives into a thrown/logged
+ * surface. Global `fetch` only; no SDKs, browser-safe.
+ */
+import { DEFAULT_TIMEOUT_MS, ProviderError, } from './types.js';
+/**
+ * Removes every occurrence of `secret` from `text`. Applied to any
+ * provider-supplied error body before it is placed in a `ProviderError.message`,
+ * so an echoed Authorization header or key fragment can never leak. A no-op when
+ * there is no secret to protect.
+ */
+export function scrubSecret(text, secret) {
+    if (secret === undefined || secret.length === 0)
+        return text;
+    return text.split(secret).join('[REDACTED]');
+}
+/**
+ * Return an error safe to attach as a `ProviderError.cause` (acceptance §10): the
+ * key must not survive into ANY logged/inspected surface, and consumers walk the
+ * `[cause]` chain (`console.error`, `util.inspect`, pino/winston serializers).
+ * The original error's `message` — and its `stack`, which embeds the message —
+ * can echo an outgoing Authorization header, so when the secret appears anywhere
+ * in it we replace it with a fresh scrubbed `Error` (no key in message or stack).
+ * When there is no secret, or it does not appear, the original error is returned
+ * unchanged so genuine network diagnostics (DNS, ECONNREFUSED) are preserved.
+ */
+export function scrubCause(err, secret) {
+    if (secret === undefined || secret.length === 0)
+        return err;
+    const message = err instanceof Error ? err.message : String(err);
+    const stack = err instanceof Error ? (err.stack ?? '') : '';
+    if (!message.includes(secret) && !stack.includes(secret))
+        return err;
+    const scrubbed = new Error(scrubSecret(message, secret));
+    if (err instanceof Error)
+        scrubbed.name = err.name;
+    return scrubbed;
+}
+function codeForStatus(status) {
+    if (status === 401 || status === 403)
+        return 'auth';
+    if (status === 404)
+        return 'not_found';
+    if (status === 429)
+        return 'rate_limit';
+    if (status >= 500)
+        return 'server';
+    return 'http';
+}
+/**
+ * Performs a JSON request and parses the response, or throws a `ProviderError`.
+ * Non-2xx → status-mapped error (body scrubbed + snippeted); fetch rejection →
+ * `network`; our own abort → `timeout`; unparseable 2xx body → `bad_response`.
+ */
+export async function requestJson(opts) {
+    const { provider, url, method = 'GET', headers, body, apiKey } = opts;
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => {
+        controller.abort();
+    }, timeoutMs);
+    const init = { method, signal: controller.signal };
+    if (headers !== undefined)
+        init.headers = headers;
+    if (body !== undefined)
+        init.body = JSON.stringify(body);
+    let res;
+    try {
+        res = await fetch(url, init);
+    }
+    catch (err) {
+        if (controller.signal.aborted) {
+            throw new ProviderError({
+                provider,
+                code: 'timeout',
+                message: `${provider}: request timed out after ${String(timeoutMs)}ms`,
+            });
+        }
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new ProviderError({
+            provider,
+            code: 'network',
+            message: `${provider}: network request failed (${scrubSecret(detail, apiKey)})`,
+            cause: scrubCause(err, apiKey),
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!res.ok) {
+        const raw = await safeText(res);
+        const snippet = scrubSecret(raw, apiKey).slice(0, 500);
+        throw new ProviderError({
+            provider,
+            code: codeForStatus(res.status),
+            status: res.status,
+            message: `${provider}: HTTP ${String(res.status)}${snippet ? ` — ${snippet}` : ''}`,
+        });
+    }
+    try {
+        return (await res.json());
+    }
+    catch (err) {
+        throw new ProviderError({
+            provider,
+            code: 'bad_response',
+            status: res.status,
+            message: `${provider}: response body was not valid JSON`,
+            cause: scrubCause(err, apiKey),
+        });
+    }
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Shared `ProviderClient.test()` implementation: a 1-token, temperature-0 ping
+ * through the client's own `complete()`, timing the round-trip. `performance.now`
+ * is intentionally not a determinism hazard — latency never feeds a prompt or diff.
+ */
+export async function pingComplete(client, model) {
+    const start = performance.now();
+    await client.complete({
+        system: '',
+        messages: [{ role: 'user', content: 'ping' }],
+        model,
+        maxTokens: 1,
+        temperature: 0,
+    });
+    return { ok: true, model, latencyMs: Math.round(performance.now() - start) };
+}
+/** Builds a `CompleteResult`, attaching `usage` only when both token counts are known. */
+export function toCompleteResult(text, inputTokens, outputTokens) {
+    const result = { text };
+    if (typeof inputTokens === 'number' && typeof outputTokens === 'number') {
+        result.usage = { inputTokens, outputTokens };
+    }
+    return result;
+}
+//# sourceMappingURL=http.js.map

package/dist/providers/http.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@adminium/llm` provider clients barrel (06-llm-assist.md §3). The direct-API
+ * wire layer: fetch-based clients for Anthropic / OpenAI / OpenAI-compatible /
+ * Ollama, their model catalogs, and the shared `ProviderClient` contract +
+ * typed `ProviderError`. Browser-safe (global `fetch` only, no SDKs).
+ */
+export * from './types.js';
+export * from './http.js';
+export * from './model-catalog.js';
+export * from './anthropic.js';
+export * from './openai.js';
+export * from './openai-compatible.js';
+export * from './ollama.js';
+export * from './factory.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@adminium/llm` provider clients barrel (06-llm-assist.md §3). The direct-API
+ * wire layer: fetch-based clients for Anthropic / OpenAI / OpenAI-compatible /
+ * Ollama, their model catalogs, and the shared `ProviderClient` contract +
+ * typed `ProviderError`. Browser-safe (global `fetch` only, no SDKs).
+ */
+export * from './types.js';
+export * from './http.js';
+export * from './model-catalog.js';
+export * from './anthropic.js';
+export * from './openai.js';
+export * from './openai-compatible.js';
+export * from './ollama.js';
+export * from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/providers/model-catalog.d.ts

@@ -0,0 +1,21 @@
+import { type ModelInfo } from './types.js';
+export declare const ANTHROPIC_STATIC_MODELS: readonly ModelInfo[];
+export declare const OPENAI_STATIC_MODELS: readonly ModelInfo[];
+export interface CatalogFetchOptions {
+    apiKey?: string;
+    baseUrl: string;
+    timeoutMs?: number;
+}
+/** `GET {baseUrl}/v1/models`; on any failure returns the static Anthropic list. */
+export declare function listAnthropicModels(opts: CatalogFetchOptions): Promise<ModelInfo[]>;
+/** `GET {baseUrl}/models` filtered to chat models; on any failure returns the static OpenAI list. */
+export declare function listOpenAiModels(opts: CatalogFetchOptions): Promise<ModelInfo[]>;
+/**
+ * `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 declare function listOpenAiCompatibleModels(opts: CatalogFetchOptions): Promise<ModelInfo[]>;
+/** `GET {baseUrl}/api/tags`; no static fallback — propagates `ProviderError` on failure. */
+export declare function listOllamaModels(opts: CatalogFetchOptions): Promise<ModelInfo[]>;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/providers/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../src/providers/model-catalog.ts"],"names":[],"mappings":"AAYA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAI3D,eAAO,MAAM,uBAAuB,EAAE,SAAS,SAAS,EAMvD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAAS,SAAS,EAKpD,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,mFAAmF;AACnF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAiBzF;AAoBD,qGAAqG;AACrG,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAiBtF;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAmBhG;AAMD,4FAA4F;AAC5F,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAStF"}