@prenta/core 0.118.0

package/dist/ai/models.js

@@ -0,0 +1,126 @@
+/**
+ * Model catalog orchestration: live sync (with curated normalization), curated
+ * fallback, and resolution of a configured-but-missing model to an `unavailable`
+ * entry so the UI can warn without silently dropping the admin's choice.
+ */
+import { AI_CONFIG_COLLECTION, getAIConfig, putAIConfig, resolveProviderKey, } from './config-store.js';
+import { curatedFallbackCatalog, modelsMatch, normalizeModel, } from './catalog.js';
+import { listModels as adapterListModels } from './providers/index.js';
+export { AI_CONFIG_COLLECTION };
+function adapterContextFor(conn, apiKey) {
+    return {
+        apiKey,
+        baseUrl: conn.baseUrl,
+        organizationId: conn.organizationId,
+        projectId: conn.projectId,
+    };
+}
+/**
+ * Sync the model catalog for a provider connection. Attempts a live listing;
+ * on any failure falls back to the curated catalog so the selector is never
+ * empty. Persists the result on the `__ai_config__` document under
+ * `catalog[connectionId]` and stamps `lastModelSyncAt`.
+ */
+export async function syncModels(db, connectionId) {
+    const config = await getAIConfig(db);
+    const conn = config.providers.find((p) => p.id === connectionId);
+    if (!conn)
+        throw new Error('Provider connection not found');
+    const now = new Date().toISOString();
+    const apiKey = await resolveProviderKey(conn);
+    let models;
+    let fromFallback = false;
+    let warning;
+    if (!apiKey) {
+        models = curatedFallbackCatalog(conn.provider, now);
+        fromFallback = true;
+        warning = 'No API key configured; showing the curated model list.';
+    }
+    else {
+        try {
+            const ids = await adapterListModels(conn.provider, adapterContextFor(conn, apiKey));
+            if (ids.length === 0) {
+                models = curatedFallbackCatalog(conn.provider, now);
+                fromFallback = true;
+                warning = 'The provider returned no models; showing the curated list.';
+            }
+            else {
+                models = ids.map((providerModelId) => normalizeModel({
+                    provider: conn.provider,
+                    providerModelId,
+                    source: 'provider',
+                    status: 'available',
+                    lastSyncedAt: now,
+                }));
+            }
+        }
+        catch (err) {
+            models = curatedFallbackCatalog(conn.provider, now);
+            fromFallback = true;
+            warning =
+                err instanceof Error
+                    ? `Live model listing failed (${err.message}); showing the curated list.`
+                    : 'Live model listing failed; showing the curated list.';
+        }
+    }
+    const entry = { models, lastSyncedAt: now, fromFallback };
+    const nextProviders = config.providers.map((p) => p.id === connectionId ? { ...p, lastModelSyncAt: now } : p);
+    await putAIConfig(db, {
+        ...config,
+        providers: nextProviders,
+        catalog: { ...(config.catalog ?? {}), [connectionId]: entry },
+    }, conn.updatedBy || 'system');
+    return { models, fromFallback, warning };
+}
+/**
+ * Read the cached catalog for a connection (or all connections). Falls back to
+ * the curated catalog for connections that have never been synced so the UI
+ * always has something to show.
+ */
+export async function getModels(db, params) {
+    const config = await getAIConfig(db);
+    const now = new Date().toISOString();
+    const out = [];
+    const conns = config.providers.filter((p) => {
+        if (params?.connectionId)
+            return p.id === params.connectionId;
+        if (params?.provider)
+            return p.provider === params.provider;
+        return true;
+    });
+    for (const conn of conns) {
+        const cached = config.catalog?.[conn.id];
+        if (cached?.models?.length)
+            out.push(...cached.models);
+        else
+            out.push(...curatedFallbackCatalog(conn.provider, now));
+    }
+    // De-dupe by normalized id, preferring the first (cached/live) occurrence.
+    const seen = new Set();
+    return out.filter((m) => (seen.has(m.id) ? false : (seen.add(m.id), true)));
+}
+/**
+ * Resolve a configured model id to a catalog entry. When the id is no longer in
+ * the catalog (provider removed/renamed it) returns a synthesized `unavailable`
+ * model so the caller can keep the setting and warn the user.
+ */
+export function resolveModelOrUnavailable(modelId, catalog) {
+    if (!modelId)
+        return null;
+    const found = catalog.find((m) => modelsMatch(m.id, modelId) || modelsMatch(m.providerModelId, modelId));
+    if (found)
+        return found;
+    const parts = modelId.split(':');
+    const provider = parts[0] ?? '';
+    const providerModelId = parts.slice(1).join(':') || modelId;
+    return normalizeModel({
+        provider: (['openai', 'anthropic', 'xai', 'custom'].includes(provider)
+            ? provider
+            : 'custom'),
+        providerModelId,
+        source: 'config',
+        status: 'unavailable',
+        lastSyncedAt: new Date().toISOString(),
+    });
+}
+//# sourceMappingURL=models.js.map

package/dist/ai/models.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Anthropic adapter. Uses the `/v1/models` listing endpoint with `x-api-key`
+ * and the required `anthropic-version` header. Hostname is fixed.
+ */
+import type { AIConnectionTestResult } from '../types.js';
+import { type AdapterContext, type GenerateTextOptions, type GenerateTextResult } from './http.js';
+export declare function testConnection(ctx: AdapterContext): Promise<AIConnectionTestResult>;
+export declare function listModels(ctx: AdapterContext): Promise<string[]>;
+export declare function generateText(ctx: AdapterContext, opts: GenerateTextOptions): Promise<GenerateTextResult>;
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAKxB,MAAM,WAAW,CAAA;AAalB,wBAAsB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqBzF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQvE;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA6B7B"}

package/dist/ai/providers/anthropic.js

@@ -0,0 +1,63 @@
+/**
+ * Anthropic adapter. Uses the `/v1/models` listing endpoint with `x-api-key`
+ * and the required `anthropic-version` header. Hostname is fixed.
+ */
+import { adapterHttpErrorFromResponse, extractModelIds, messageFromStatus, statusFromHttp, timedFetch, } from './http.js';
+const ANTHROPIC_BASE = 'https://api.anthropic.com/v1';
+const ANTHROPIC_VERSION = '2023-06-01';
+function anthropicNum(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : 0;
+}
+function headers(ctx) {
+    return { 'x-api-key': ctx.apiKey, 'anthropic-version': ANTHROPIC_VERSION };
+}
+export async function testConnection(ctx) {
+    const testedAt = new Date().toISOString();
+    if (!ctx.apiKey) {
+        return { ok: false, status: 'needs_setup', message: messageFromStatus('needs_setup'), testedAt };
+    }
+    try {
+        const res = await timedFetch(`${ANTHROPIC_BASE}/models`, { method: 'GET', headers: headers(ctx) }, ctx);
+        const status = statusFromHttp(res.status);
+        return { ok: status === 'connected', status, message: messageFromStatus(status), testedAt };
+    }
+    catch {
+        return {
+            ok: false,
+            status: 'provider_down',
+            message: messageFromStatus('provider_down'),
+            testedAt,
+        };
+    }
+}
+export async function listModels(ctx) {
+    const res = await timedFetch(`${ANTHROPIC_BASE}/models`, { method: 'GET', headers: headers(ctx) }, ctx);
+    if (!res.ok)
+        throw new Error(`Anthropic model listing failed (${res.status})`);
+    return extractModelIds(await res.json());
+}
+export async function generateText(ctx, opts) {
+    const res = await timedFetch(`${ANTHROPIC_BASE}/messages`, {
+        method: 'POST',
+        headers: { ...headers(ctx), 'content-type': 'application/json' },
+        body: JSON.stringify({
+            model: opts.model,
+            max_tokens: opts.maxTokens ?? 1024,
+            ...(opts.system ? { system: opts.system } : {}),
+            ...(typeof opts.temperature === 'number' ? { temperature: opts.temperature } : {}),
+            messages: [{ role: 'user', content: opts.prompt }],
+        }),
+    }, ctx);
+    if (!res.ok)
+        throw await adapterHttpErrorFromResponse(res);
+    const payload = (await res.json());
+    const block = payload.content?.find((b) => b.type === 'text') ?? payload.content?.[0];
+    const promptTokens = anthropicNum(payload.usage?.input_tokens);
+    const completionTokens = anthropicNum(payload.usage?.output_tokens);
+    return {
+        text: typeof block?.text === 'string' ? block.text : '',
+        usage: { promptTokens, completionTokens, totalTokens: promptTokens + completionTokens },
+        model: opts.model,
+    };
+}
+//# sourceMappingURL=anthropic.js.map

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

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

package/dist/ai/providers/custom.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom OpenAI-compatible provider adapter. The base URL is admin-controlled,
+ * so it is SSRF-validated and DNS-resolved before any request. Falls back to an
+ * empty model list (manual entry in the UI) when the endpoint doesn't support
+ * `/models`.
+ */
+import type { AIConnectionTestResult } from '../types.js';
+import { type AdapterContext, type GenerateTextOptions, type GenerateTextResult } from './http.js';
+export declare function testConnection(ctx: AdapterContext): Promise<AIConnectionTestResult>;
+export declare function listModels(ctx: AdapterContext): Promise<string[]>;
+export declare function generateText(ctx: AdapterContext, opts: GenerateTextOptions): Promise<GenerateTextResult>;
+//# sourceMappingURL=custom.d.ts.map

package/dist/ai/providers/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/custom.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAQxB,MAAM,WAAW,CAAA;AAMlB,wBAAsB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiDzF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWvE;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}

package/dist/ai/providers/custom.js

@@ -0,0 +1,76 @@
+/**
+ * Custom OpenAI-compatible provider adapter. The base URL is admin-controlled,
+ * so it is SSRF-validated and DNS-resolved before any request. Falls back to an
+ * empty model list (manual entry in the UI) when the endpoint doesn't support
+ * `/models`.
+ */
+import { assertSafeBaseUrl, extractModelIds, messageFromStatus, openAiChat, statusFromHttp, timedFetch, trimTrailingSlash, } from './http.js';
+function headers(ctx) {
+    return { authorization: `Bearer ${ctx.apiKey}` };
+}
+export async function testConnection(ctx) {
+    const testedAt = new Date().toISOString();
+    if (!ctx.baseUrl) {
+        return {
+            ok: false,
+            status: 'needs_setup',
+            message: 'A base URL is required for a custom provider.',
+            testedAt,
+        };
+    }
+    try {
+        await assertSafeBaseUrl(ctx.baseUrl);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            status: 'unknown',
+            message: err instanceof Error ? err.message : 'Invalid base URL.',
+            testedAt,
+        };
+    }
+    if (!ctx.apiKey) {
+        return { ok: false, status: 'needs_setup', message: messageFromStatus('needs_setup'), testedAt };
+    }
+    try {
+        const res = await timedFetch(`${trimTrailingSlash(ctx.baseUrl)}/models`, { method: 'GET', headers: headers(ctx) }, ctx);
+        // A 404 likely means the endpoint doesn't implement /models; the connection
+        // itself may still be usable with a manually-entered model id.
+        if (res.status === 404) {
+            return {
+                ok: true,
+                status: 'connected',
+                message: 'Connected. This endpoint does not list models; enter a model id manually.',
+                testedAt,
+            };
+        }
+        const status = statusFromHttp(res.status);
+        return { ok: status === 'connected', status, message: messageFromStatus(status), testedAt };
+    }
+    catch {
+        return {
+            ok: false,
+            status: 'provider_down',
+            message: messageFromStatus('provider_down'),
+            testedAt,
+        };
+    }
+}
+export async function listModels(ctx) {
+    if (!ctx.baseUrl)
+        return [];
+    await assertSafeBaseUrl(ctx.baseUrl);
+    const res = await timedFetch(`${trimTrailingSlash(ctx.baseUrl)}/models`, { method: 'GET', headers: headers(ctx) }, ctx);
+    if (res.status === 404)
+        return [];
+    if (!res.ok)
+        throw new Error(`Custom provider model listing failed (${res.status})`);
+    return extractModelIds(await res.json());
+}
+export async function generateText(ctx, opts) {
+    if (!ctx.baseUrl)
+        throw new Error('A base URL is required for a custom provider.');
+    await assertSafeBaseUrl(ctx.baseUrl);
+    return openAiChat(ctx.baseUrl, { authorization: `Bearer ${ctx.apiKey}` }, ctx, opts);
+}
+//# sourceMappingURL=custom.js.map

package/dist/ai/providers/custom.js.map

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

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

@@ -0,0 +1,66 @@
+/**
+ * Shared HTTP helpers for AI provider adapters: a timeout-bounded fetch, a
+ * status->AIConnectionStatus mapper, and an SSRF guard for custom base URLs.
+ * Built-in providers use fixed hostnames; only custom endpoints are
+ * admin-controlled and therefore validated/resolved.
+ */
+import type { AIConnectionStatus } from '../types.js';
+export interface AdapterContext {
+    apiKey: string;
+    baseUrl?: string;
+    organizationId?: string;
+    projectId?: string;
+    /** Injectable fetch for tests; defaults to global `fetch`. */
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}
+/** Map an HTTP response status to a connection-health value. */
+export declare function statusFromHttp(status: number): AIConnectionStatus;
+/** A short, safe message for a status (never contains the key). */
+export declare function messageFromStatus(status: AIConnectionStatus, httpStatus?: number): string;
+/** Best-effort extraction of a provider error message from a JSON error body. */
+export declare function extractProviderErrorMessage(payload: unknown): string | undefined;
+export declare function timedFetch(url: string, init: RequestInit, ctx: AdapterContext): Promise<Response>;
+/**
+ * Validate a custom provider base URL against SSRF (no private/internal hosts,
+ * https/http only) AND resolve its DNS to defend against rebinding. Throws on
+ * rejection with a safe message.
+ */
+export declare function assertSafeBaseUrl(baseUrl: string): Promise<void>;
+/** Strip a trailing slash so we can append `/models` etc. cleanly. */
+export declare function trimTrailingSlash(url: string): string;
+export interface GenerateTextOptions {
+    /** Provider-native model id (e.g. `gpt-4o`, `claude-sonnet-4-6`). */
+    model: string;
+    prompt: string;
+    system?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface GenerateTextResult {
+    text: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Provider-native model id that produced the result. */
+    model: string;
+}
+/** Build an adapter error from a non-2xx response, including provider detail when safe. */
+export declare function adapterHttpErrorFromResponse(res: Response): Promise<AdapterHttpError>;
+/**
+ * Call an OpenAI-compatible `/chat/completions` endpoint. Shared by the OpenAI,
+ * xAI, and custom adapters (all speak the same wire format). `base` must already
+ * be validated/SSRF-checked by the caller for admin-controlled endpoints.
+ */
+export declare function openAiChat(base: string, headers: Record<string, string>, ctx: AdapterContext, opts: GenerateTextOptions): Promise<GenerateTextResult>;
+/** Error carrying a mapped connection status so the runtime can react sensibly. */
+export declare class AdapterHttpError extends Error {
+    readonly connectionStatus: AIConnectionStatus;
+    readonly httpStatus: number;
+    constructor(connectionStatus: AIConnectionStatus, httpStatus: number, detail?: string);
+}
+/** Best-effort extraction of model ids from an OpenAI-compatible list payload. */
+export declare function extractModelIds(payload: unknown): string[];
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAMjE;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBzF;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAchF;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAetE;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9E,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;CACd;AAMD,2FAA2F;AAC3F,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgB3F;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAsC7B;AAED,mFAAmF;AACnF,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM;gBADlB,gBAAgB,EAAE,kBAAkB,EACpC,UAAU,EAAE,MAAM,EAC3B,MAAM,CAAC,EAAE,MAAM;CAOlB;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAS1D"}

package/dist/ai/providers/http.js

@@ -0,0 +1,185 @@
+/**
+ * Shared HTTP helpers for AI provider adapters: a timeout-bounded fetch, a
+ * status->AIConnectionStatus mapper, and an SSRF guard for custom base URLs.
+ * Built-in providers use fixed hostnames; only custom endpoints are
+ * admin-controlled and therefore validated/resolved.
+ */
+import { resolveAndCheck, validateWebhookUrl } from '../../security/webhook.js';
+/** Map an HTTP response status to a connection-health value. */
+export function statusFromHttp(status) {
+    if (status >= 200 && status < 300)
+        return 'connected';
+    if (status === 401 || status === 403)
+        return 'invalid_key';
+    if (status === 429)
+        return 'rate_limited';
+    if (status >= 500)
+        return 'provider_down';
+    return 'unknown';
+}
+/** A short, safe message for a status (never contains the key). */
+export function messageFromStatus(status, httpStatus) {
+    switch (status) {
+        case 'connected':
+            return 'Connection successful.';
+        case 'invalid_key':
+            return 'The API key was rejected (invalid or unauthorized).';
+        case 'rate_limited':
+            return 'The provider rate-limited the request. Try again shortly.';
+        case 'provider_down':
+            return 'The provider returned a server error. It may be temporarily unavailable.';
+        case 'needs_setup':
+            return 'No API key is configured for this provider.';
+        default:
+            if (httpStatus === 400 || httpStatus === 422) {
+                return 'The provider rejected the request. Check the selected model in Settings > AI.';
+            }
+            if (httpStatus === 404) {
+                return 'The provider endpoint or model was not found.';
+            }
+            return 'Could not determine connection status.';
+    }
+}
+/** Best-effort extraction of a provider error message from a JSON error body. */
+export function extractProviderErrorMessage(payload) {
+    if (!payload || typeof payload !== 'object')
+        return undefined;
+    const root = payload;
+    const nested = root.error;
+    if (nested && typeof nested === 'object') {
+        const message = nested.message;
+        if (typeof message === 'string' && message.trim())
+            return message.trim();
+    }
+    const message = root.message;
+    if (typeof message === 'string' && message.trim())
+        return message.trim();
+    return undefined;
+}
+export async function timedFetch(url, init, ctx) {
+    const doFetch = ctx.fetchImpl ?? globalThis.fetch;
+    if (typeof doFetch !== 'function') {
+        throw new Error('fetch is not available in this runtime');
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), ctx.timeoutMs ?? 10_000);
+    try {
+        return await doFetch(url, { ...init, redirect: 'error', signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Validate a custom provider base URL against SSRF (no private/internal hosts,
+ * https/http only) AND resolve its DNS to defend against rebinding. Throws on
+ * rejection with a safe message.
+ */
+export async function assertSafeBaseUrl(baseUrl) {
+    const check = validateWebhookUrl(baseUrl);
+    if (!check.valid) {
+        throw new Error(`Unsafe base URL: ${check.error ?? 'invalid'}`);
+    }
+    let host;
+    try {
+        host = new URL(baseUrl).hostname;
+    }
+    catch {
+        throw new Error('Unsafe base URL: invalid URL');
+    }
+    const resolved = await resolveAndCheck(host);
+    if (!resolved.safe) {
+        throw new Error(`Unsafe base URL: ${resolved.error ?? 'resolves to a private address'}`);
+    }
+}
+/** Strip a trailing slash so we can append `/models` etc. cleanly. */
+export function trimTrailingSlash(url) {
+    return url.replace(/\/+$/, '');
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : 0;
+}
+/** Build an adapter error from a non-2xx response, including provider detail when safe. */
+export async function adapterHttpErrorFromResponse(res) {
+    const status = statusFromHttp(res.status);
+    let detail;
+    try {
+        const text = await res.text();
+        if (text.trim()) {
+            try {
+                detail = extractProviderErrorMessage(JSON.parse(text));
+            }
+            catch {
+                detail = text.replace(/\s+/g, ' ').trim().slice(0, 300);
+            }
+        }
+    }
+    catch {
+        // Body read failures should not hide the HTTP status.
+    }
+    return new AdapterHttpError(status, res.status, detail);
+}
+/**
+ * Call an OpenAI-compatible `/chat/completions` endpoint. Shared by the OpenAI,
+ * xAI, and custom adapters (all speak the same wire format). `base` must already
+ * be validated/SSRF-checked by the caller for admin-controlled endpoints.
+ */
+export async function openAiChat(base, headers, ctx, opts) {
+    const messages = [];
+    if (opts.system)
+        messages.push({ role: 'system', content: opts.system });
+    messages.push({ role: 'user', content: opts.prompt });
+    const res = await timedFetch(`${trimTrailingSlash(base)}/chat/completions`, {
+        method: 'POST',
+        headers: { ...headers, 'content-type': 'application/json' },
+        body: JSON.stringify({
+            model: opts.model,
+            messages,
+            max_tokens: opts.maxTokens ?? 1024,
+            ...(typeof opts.temperature === 'number' ? { temperature: opts.temperature } : {}),
+        }),
+    }, ctx);
+    if (!res.ok) {
+        throw await adapterHttpErrorFromResponse(res);
+    }
+    const payload = (await res.json());
+    const text = payload.choices?.[0]?.message?.content;
+    const promptTokens = num(payload.usage?.prompt_tokens);
+    const completionTokens = num(payload.usage?.completion_tokens);
+    return {
+        text: typeof text === 'string' ? text : '',
+        usage: {
+            promptTokens,
+            completionTokens,
+            totalTokens: num(payload.usage?.total_tokens) || promptTokens + completionTokens,
+        },
+        model: opts.model,
+    };
+}
+/** Error carrying a mapped connection status so the runtime can react sensibly. */
+export class AdapterHttpError extends Error {
+    connectionStatus;
+    httpStatus;
+    constructor(connectionStatus, httpStatus, detail) {
+        const base = messageFromStatus(connectionStatus, httpStatus);
+        const safeDetail = detail?.replace(/\s+/g, ' ').trim().slice(0, 500);
+        super(safeDetail ? `${base} ${safeDetail}` : base);
+        this.connectionStatus = connectionStatus;
+        this.httpStatus = httpStatus;
+        this.name = 'AdapterHttpError';
+    }
+}
+/** Best-effort extraction of model ids from an OpenAI-compatible list payload. */
+export function extractModelIds(payload) {
+    const data = payload?.data;
+    if (!Array.isArray(data))
+        return [];
+    const ids = [];
+    for (const entry of data) {
+        const id = entry?.id;
+        if (typeof id === 'string' && id.trim())
+            ids.push(id.trim());
+    }
+    return ids;
+}
+//# sourceMappingURL=http.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Provider adapter dispatcher. Selects the right adapter by provider key and
+ * exposes a uniform `testConnection` / `listModels` surface to the catalog and
+ * route layers.
+ */
+import type { AIConnectionTestResult, AIProviderKey } from '../types.js';
+import type { AdapterContext, GenerateTextOptions, GenerateTextResult } from './http.js';
+export type { AdapterContext, GenerateTextOptions, GenerateTextResult } from './http.js';
+interface ProviderAdapter {
+    testConnection(ctx: AdapterContext): Promise<AIConnectionTestResult>;
+    listModels(ctx: AdapterContext): Promise<string[]>;
+    generateText(ctx: AdapterContext, opts: GenerateTextOptions): Promise<GenerateTextResult>;
+}
+export declare function getAdapter(provider: AIProviderKey): ProviderAdapter;
+export declare function testConnection(provider: AIProviderKey, ctx: AdapterContext): Promise<AIConnectionTestResult>;
+export declare function listModels(provider: AIProviderKey, ctx: AdapterContext): Promise<string[]>;
+export declare function generateText(provider: AIProviderKey, ctx: AdapterContext, opts: GenerateTextOptions): Promise<GenerateTextResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAIxF,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAExF,UAAU,eAAe;IACvB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACpE,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAClD,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAC1F;AASD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,eAAe,CAEnE;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE1F;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAE7B"}

package/dist/ai/providers/index.js

@@ -0,0 +1,28 @@
+/**
+ * Provider adapter dispatcher. Selects the right adapter by provider key and
+ * exposes a uniform `testConnection` / `listModels` surface to the catalog and
+ * route layers.
+ */
+import * as anthropic from './anthropic.js';
+import * as custom from './custom.js';
+import * as openai from './openai.js';
+import * as xai from './xai.js';
+const ADAPTERS = {
+    openai,
+    anthropic,
+    xai,
+    custom,
+};
+export function getAdapter(provider) {
+    return ADAPTERS[provider] ?? custom;
+}
+export function testConnection(provider, ctx) {
+    return getAdapter(provider).testConnection(ctx);
+}
+export function listModels(provider, ctx) {
+    return getAdapter(provider).listModels(ctx);
+}
+export function generateText(provider, ctx, opts) {
+    return getAdapter(provider).generateText(ctx, opts);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAU/B,MAAM,QAAQ,GAA2C;IACvD,MAAM;IACN,SAAS;IACT,GAAG;IACH,MAAM;CACP,CAAA;AAED,MAAM,UAAU,UAAU,CAAC,QAAuB;IAChD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAuB,EACvB,GAAmB;IAEnB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAuB,EAAE,GAAmB;IACrE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAuB,EACvB,GAAmB,EACnB,IAAyB;IAEzB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AACrD,CAAC"}