rax-flow-providers 0.1.0

package/dist/host-bridge-adapter.js

@@ -0,0 +1,145 @@
+import { spawn } from "node:child_process";
+import { parseJsonObjectFromText } from "./utils.js";
+function parseShellCommand(input) {
+    const parts = input.match(/(?:[^\s"]+|"[^"]*")+/g) ?? [];
+    if (parts.length === 0) {
+        throw new Error("invalid_bridge_command");
+    }
+    const [command, ...rawArgs] = parts;
+    const args = rawArgs.map((arg) => arg.replace(/^"|"$/g, ""));
+    // `command` is defined here because parts.length > 0 is guaranteed above
+    return { command: command, args };
+}
+async function runBridgeCommand(commandSpec, payload, timeoutMs) {
+    const { command, args } = parseShellCommand(commandSpec);
+    return await new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: ["pipe", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        const timer = setTimeout(() => {
+            child.kill("SIGKILL");
+            reject(new Error("host_bridge_timeout"));
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                reject(new Error(`host_bridge_command_failed:${code}:${stderr}`));
+                return;
+            }
+            try {
+                const parsed = JSON.parse(stdout);
+                resolve(parsed);
+            }
+            catch {
+                resolve({ ok: true, output: stdout.trim(), model: "host-bridge-command" });
+            }
+        });
+        child.stdin.write(JSON.stringify(payload));
+        child.stdin.end();
+    });
+}
+function getGlobalBridge() {
+    const candidate = globalThis.__RAX_HOST_BRIDGE__;
+    if (typeof candidate === "function") {
+        return candidate;
+    }
+    return undefined;
+}
+export class HostBridgeAdapter {
+    model;
+    mode;
+    command;
+    timeoutMs;
+    constructor(options = {}) {
+        this.model = options.model ?? "host-managed";
+        this.mode = options.mode ?? "auto";
+        this.command = options.command;
+        this.timeoutMs = options.timeoutMs ?? 20000;
+    }
+    async callBridge(payload) {
+        const bridgeFn = getGlobalBridge();
+        if (bridgeFn) {
+            return await bridgeFn(payload);
+        }
+        if (this.command) {
+            return await runBridgeCommand(this.command, payload, this.timeoutMs);
+        }
+        if (this.mode === "bridge-only") {
+            throw new Error("host_bridge_missing");
+        }
+        return {
+            ok: true,
+            model: this.model,
+            latencyMs: 1,
+            output: payload.action === "callStructured"
+                ? {
+                    agent: "HostBridgeMock",
+                    success: true,
+                    confidence: 0.7,
+                    risks: ["latency"],
+                    logs: ["host bridge unavailable, using local mock response"],
+                    data: {
+                        summary: "Mock structured output from host adapter",
+                        nextAction: "configure_host_bridge"
+                    }
+                }
+                : `host-mock:${payload.prompt.slice(0, 240)}`
+        };
+    }
+    async callModel(prompt, options) {
+        const started = Date.now();
+        const res = await this.callBridge({ version: 1, action: "callModel", prompt, options });
+        if (!res.ok) {
+            throw new Error(`host_call_failed:${res.error ?? "unknown"}`);
+        }
+        return {
+            provider: "host",
+            model: res.model ?? options?.model ?? this.model,
+            latencyMs: res.latencyMs ?? Date.now() - started,
+            output: typeof res.output === "string" ? res.output : JSON.stringify(res.output ?? "")
+        };
+    }
+    async callStructured(prompt, schema, options) {
+        const started = Date.now();
+        const res = await this.callBridge({ version: 1, action: "callStructured", prompt, schema, options });
+        if (!res.ok) {
+            throw new Error(`host_structured_failed:${res.error ?? "unknown"}`);
+        }
+        let output = null;
+        if (res.output && typeof res.output === "object") {
+            output = res.output;
+        }
+        else if (typeof res.output === "string") {
+            output = parseJsonObjectFromText(res.output);
+        }
+        if (!output) {
+            throw new Error("host_structured_parse_failed");
+        }
+        return {
+            provider: "host",
+            model: res.model ?? options?.model ?? this.model,
+            latencyMs: res.latencyMs ?? Date.now() - started,
+            output
+        };
+    }
+    async healthCheck() {
+        if (this.mode === "mock")
+            return true;
+        if (getGlobalBridge())
+            return true;
+        if (this.command)
+            return true;
+        return this.mode === "auto";
+    }
+}
+//# sourceMappingURL=host-bridge-adapter.js.map

package/dist/host-bridge-adapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./error-mapper.js";
+export * from "./openai-adapter.js";
+export * from "./claude-adapter.js";
+export * from "./gemini-adapter.js";
+export * from "./groq-adapter.js";
+export * from "./mistral-adapter.js";
+export * from "./cohere-adapter.js";
+export * from "./rest-adapter.js";
+export * from "./host-bridge-adapter.js";
+export * from "./strategy.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from "./error-mapper.js";
+export * from "./openai-adapter.js";
+export * from "./claude-adapter.js";
+export * from "./gemini-adapter.js";
+export * from "./groq-adapter.js";
+export * from "./mistral-adapter.js";
+export * from "./cohere-adapter.js";
+export * from "./rest-adapter.js";
+export * from "./host-bridge-adapter.js";
+export * from "./strategy.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/mistral-adapter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file mistral-adapter.ts
+ * Mistral AI bridge adapter.
+ *
+ * API reference: https://docs.mistral.ai/api/
+ *
+ * • callModel      → POST /v1/chat/completions  (standard)
+ * • callStructured → same endpoint with `response_format: { type: "json_object" }`
+ *                    Mistral supports native JSON mode since 2024-02 on all
+ *                    large models.  For smaller models we fall back to
+ *                    system-prompt enforcement.
+ *
+ * Supported models: mistral-large-latest, mistral-small-latest,
+ *                   open-mixtral-8x22b, codestral-latest, etc.
+ */
+import { IModelProvider, ModelResponse, ProviderCallOptions } from "@rax-flow/core";
+export interface MistralAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    timeoutMs?: number;
+    /** Disable Mistral safe-prompt for structured tasks (default: false). */
+    safePrompt?: boolean;
+}
+export declare class MistralAdapter implements IModelProvider {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    private readonly safePrompt;
+    constructor(options: MistralAdapterOptions);
+    private supportsJsonMode;
+    private post;
+    private extractText;
+    callModel(prompt: string, options?: ProviderCallOptions): Promise<ModelResponse<string>>;
+    callStructured<T>(prompt: string, schema: object, options?: ProviderCallOptions): Promise<ModelResponse<T>>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=mistral-adapter.d.ts.map

package/dist/mistral-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral-adapter.d.ts","sourceRoot":"","sources":["../src/mistral-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAyDpF,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAe,YAAW,cAAc;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,OAAO,EAAE,qBAAqB;IAU1C,OAAO,CAAC,gBAAgB;YAIV,IAAI;IAgDlB,OAAO,CAAC,WAAW;IAMb,SAAS,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAkC3B,cAAc,CAAC,CAAC,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA4DtB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/dist/mistral-adapter.js

@@ -0,0 +1,172 @@
+/**
+ * @file mistral-adapter.ts
+ * Mistral AI bridge adapter.
+ *
+ * API reference: https://docs.mistral.ai/api/
+ *
+ * • callModel      → POST /v1/chat/completions  (standard)
+ * • callStructured → same endpoint with `response_format: { type: "json_object" }`
+ *                    Mistral supports native JSON mode since 2024-02 on all
+ *                    large models.  For smaller models we fall back to
+ *                    system-prompt enforcement.
+ *
+ * Supported models: mistral-large-latest, mistral-small-latest,
+ *                   open-mixtral-8x22b, codestral-latest, etc.
+ */
+import { parseJsonObjectFromText } from "./utils.js";
+import { RaxProviderError, mapHttpError, mapNetworkError, mapParseError, } from "./error-mapper.js";
+import { calculateCost } from "./pricing.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Adapter
+// ─────────────────────────────────────────────────────────────────────────────
+const VENDOR = "mistral";
+const DEFAULT_MODEL = "mistral-large-latest";
+const BASE_URL = "https://api.mistral.ai";
+/** Models known to support native json_object response_format. */
+const JSON_MODE_MODELS = new Set([
+    "mistral-large-latest",
+    "mistral-small-latest",
+    "codestral-latest",
+    "open-mixtral-8x22b",
+    "open-mistral-nemo",
+]);
+export class MistralAdapter {
+    apiKey;
+    baseUrl;
+    defaultModel;
+    timeoutMs;
+    safePrompt;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? BASE_URL;
+        this.defaultModel = options.defaultModel ?? DEFAULT_MODEL;
+        this.timeoutMs = options.timeoutMs ?? 25_000;
+        this.safePrompt = options.safePrompt ?? false;
+    }
+    // ── private helpers ────────────────────────────────────────────────────────
+    supportsJsonMode(model) {
+        return JSON_MODE_MODELS.has(model);
+    }
+    async post(body, context) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let res;
+        try {
+            res = await fetch(`${this.baseUrl}/v1/chat/completions`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            throw mapNetworkError(VENDOR, err);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const raw = await res.json().catch(() => ({}));
+        if (!res.ok) {
+            throw mapHttpError(VENDOR, res.status, raw, context);
+        }
+        const payload = raw;
+        // Mistral can signal content policy stop
+        const finishReason = payload.choices?.[0]?.finish_reason;
+        if (finishReason === "content_filter") {
+            throw new RaxProviderError(VENDOR, "content_filtered", "Mistral content policy rejection", { raw: payload });
+        }
+        return payload;
+    }
+    extractText(payload) {
+        return payload.choices?.[0]?.message?.content ?? "";
+    }
+    // ── IModelProvider ─────────────────────────────────────────────────────────
+    async callModel(prompt, options) {
+        const started = Date.now();
+        const model = options?.model ?? this.defaultModel;
+        const payload = await this.post({
+            model,
+            temperature: options?.temperature ?? 0.2,
+            max_tokens: options?.maxTokens ?? 1200,
+            safe_prompt: this.safePrompt,
+            messages: [{ role: "user", content: prompt }],
+        }, "callModel");
+        const usage = payload.usage
+            ? {
+                promptTokens: payload.usage.prompt_tokens ?? 0,
+                completionTokens: payload.usage.completion_tokens ?? 0,
+                totalTokens: payload.usage.total_tokens ?? 0,
+            }
+            : undefined;
+        return {
+            provider: VENDOR,
+            model,
+            latencyMs: Date.now() - started,
+            costUsd: calculateCost(model, usage),
+            usage,
+            output: this.extractText(payload),
+            raw: payload,
+        };
+    }
+    async callStructured(prompt, schema, options) {
+        const started = Date.now();
+        const model = options?.model ?? this.defaultModel;
+        const messages = [];
+        if (this.supportsJsonMode(model)) {
+            // Native JSON mode — schema hint via system prompt
+            messages.push({
+                role: "system",
+                content: `Respond with ONLY a valid JSON object that matches this schema:\n${JSON.stringify(schema, null, 2)}`,
+            });
+            messages.push({ role: "user", content: prompt });
+        }
+        else {
+            // Fallback for non-json-mode models: inline schema in user message
+            messages.push({
+                role: "user",
+                content: `${prompt}\n\nRespond ONLY with a JSON object matching this schema:\n${JSON.stringify(schema)}`,
+            });
+        }
+        const requestBody = {
+            model,
+            temperature: options?.temperature ?? 0,
+            max_tokens: options?.maxTokens ?? 1400,
+            safe_prompt: false, // disable safe rewrites on structured tasks
+            messages,
+        };
+        if (this.supportsJsonMode(model)) {
+            requestBody.response_format = { type: "json_object" };
+        }
+        const payload = await this.post(requestBody, "callStructured");
+        const text = this.extractText(payload);
+        const parsed = parseJsonObjectFromText(text);
+        if (!parsed) {
+            throw mapParseError(VENDOR, "callStructured", text);
+        }
+        const usage = payload.usage
+            ? {
+                promptTokens: payload.usage.prompt_tokens ?? 0,
+                completionTokens: payload.usage.completion_tokens ?? 0,
+                totalTokens: payload.usage.total_tokens ?? 0,
+            }
+            : undefined;
+        return {
+            provider: VENDOR,
+            model,
+            latencyMs: Date.now() - started,
+            costUsd: calculateCost(model, usage),
+            usage,
+            output: parsed,
+            raw: payload,
+        };
+    }
+    async healthCheck() {
+        return Boolean(this.apiKey && this.baseUrl);
+    }
+}
+//# sourceMappingURL=mistral-adapter.js.map

package/dist/mistral-adapter.js.map

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

package/dist/openai-adapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file openai-adapter.ts
+ * OpenAI bridge adapter.
+ *
+ * API reference: https://platform.openai.com/docs/api-reference/chat
+ */
+import { IModelProvider, IEmbeddingProvider, ModelResponse, ProviderCallOptions, EmbeddingResponse } from "@rax-flow/core";
+export interface OpenAIAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    timeoutMs?: number;
+}
+export declare class OpenAIAdapter implements IModelProvider, IEmbeddingProvider {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    constructor(options: OpenAIAdapterOptions);
+    /** @deprecated Pass an options object instead of positional args. */
+    constructor(apiKey: string, baseUrl?: string);
+    private supportsStrictJsonSchema;
+    private post;
+    private extractText;
+    callModel(prompt: string, options?: ProviderCallOptions): Promise<ModelResponse<string>>;
+    callStructured<T>(prompt: string, schema: object, options?: ProviderCallOptions): Promise<ModelResponse<T>>;
+    embed(texts: string[]): Promise<EmbeddingResponse>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=openai-adapter.d.ts.map

package/dist/openai-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-adapter.d.ts","sourceRoot":"","sources":["../src/openai-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAyD3H,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAc,YAAW,cAAc,EAAE,kBAAkB;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,oBAAoB;IACzC,qEAAqE;gBACzD,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAkB5C,OAAO,CAAC,wBAAwB;YAOlB,IAAI;IA0ClB,OAAO,CAAC,WAAW;IAMb,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAsBxF,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAoC3G,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0BlD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/openai-adapter.js

@@ -0,0 +1,171 @@
+/**
+ * @file openai-adapter.ts
+ * OpenAI bridge adapter.
+ *
+ * API reference: https://platform.openai.com/docs/api-reference/chat
+ */
+import { asString, parseJsonObjectFromText } from "./utils.js";
+import { calculateCost } from "./pricing.js";
+import { RaxProviderError, mapHttpError, mapNetworkError, mapParseError, } from "./error-mapper.js";
+const VENDOR = "openai";
+const DEFAULT_MODEL = "gpt-4.1-mini";
+const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+const STRICT_JSON_SCHEMA_MODELS = new Set([
+    "gpt-4o",
+    "gpt-4o-mini",
+    "gpt-4.1",
+    "gpt-4.1-mini",
+    "gpt-4.1-nano",
+    "gpt-4-turbo",
+    "o1",
+    "o1-mini",
+    "o3-mini",
+]);
+export class OpenAIAdapter {
+    apiKey;
+    baseUrl;
+    defaultModel;
+    timeoutMs;
+    constructor(optionsOrApiKey, legacyBaseUrl) {
+        if (typeof optionsOrApiKey === "string") {
+            this.apiKey = optionsOrApiKey;
+            this.baseUrl = legacyBaseUrl ?? DEFAULT_BASE_URL;
+            this.defaultModel = DEFAULT_MODEL;
+            this.timeoutMs = 30_000;
+        }
+        else {
+            this.apiKey = optionsOrApiKey.apiKey;
+            this.baseUrl = optionsOrApiKey.baseUrl ?? DEFAULT_BASE_URL;
+            this.defaultModel = optionsOrApiKey.defaultModel ?? DEFAULT_MODEL;
+            this.timeoutMs = optionsOrApiKey.timeoutMs ?? 30_000;
+        }
+    }
+    supportsStrictJsonSchema(model) {
+        for (const known of STRICT_JSON_SCHEMA_MODELS) {
+            if (model === known || model.startsWith(`${known}-`))
+                return true;
+        }
+        return false;
+    }
+    async post(body, context) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let res;
+        try {
+            res = await fetch(`${this.baseUrl}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            throw mapNetworkError(VENDOR, err);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const raw = await res.json().catch(() => ({}));
+        if (!res.ok)
+            throw mapHttpError(VENDOR, res.status, raw, context);
+        const payload = raw;
+        if (payload.error) {
+            const errMsg = payload.error.message ?? "unknown openai error";
+            const isRefusal = payload.error.type === "invalid_request_error" && /content_policy|moderat|filter/i.test(errMsg);
+            throw new RaxProviderError(VENDOR, isRefusal ? "content_filtered" : "invalid_request", errMsg, { raw: payload });
+        }
+        const finishReason = payload.choices?.[0]?.finish_reason;
+        if (finishReason === "content_filter") {
+            throw new RaxProviderError(VENDOR, "content_filtered", "OpenAI content policy rejection", { raw: payload });
+        }
+        return payload;
+    }
+    extractText(payload) {
+        const content = payload.choices?.[0]?.message?.content;
+        if (Array.isArray(content))
+            return content.map((c) => c.text ?? "").join("\n");
+        return content ?? "";
+    }
+    async callModel(prompt, options) {
+        const started = Date.now();
+        const model = options?.model ?? this.defaultModel;
+        const payload = await this.post({
+            model,
+            temperature: options?.temperature ?? 0.2,
+            max_tokens: options?.maxTokens ?? 1200,
+            messages: [{ role: "user", content: prompt }],
+        }, "callModel");
+        const usage = payload.usage ? {
+            promptTokens: payload.usage.prompt_tokens ?? 0,
+            completionTokens: payload.usage.completion_tokens ?? 0,
+            totalTokens: payload.usage.total_tokens ?? 0,
+        } : undefined;
+        return {
+            provider: VENDOR, model, latencyMs: Date.now() - started, costUsd: calculateCost(model, usage), usage,
+            output: this.extractText(payload), raw: payload,
+        };
+    }
+    async callStructured(prompt, schema, options) {
+        const started = Date.now();
+        const model = options?.model ?? this.defaultModel;
+        const body = {
+            model, temperature: options?.temperature ?? 0, max_tokens: options?.maxTokens ?? 1400,
+            messages: [{ role: "user", content: prompt }],
+        };
+        if (this.supportsStrictJsonSchema(model)) {
+            body.response_format = { type: "json_schema", json_schema: { name: "rax_flow_output", strict: true, schema } };
+        }
+        else {
+            body.response_format = { type: "json_object" };
+            body.messages = [
+                { role: "system", content: `Respond ONLY with a valid JSON object matching this schema:\n${JSON.stringify(schema, null, 2)}` },
+                { role: "user", content: prompt },
+            ];
+        }
+        const payload = await this.post(body, "callStructured");
+        const text = asString(this.extractText(payload) || "{}");
+        const parsed = parseJsonObjectFromText(text);
+        if (!parsed)
+            throw mapParseError(VENDOR, "callStructured", text);
+        const usage = payload.usage ? {
+            promptTokens: payload.usage.prompt_tokens ?? 0,
+            completionTokens: payload.usage.completion_tokens ?? 0,
+            totalTokens: payload.usage.total_tokens ?? 0,
+        } : undefined;
+        return {
+            provider: VENDOR, model, latencyMs: Date.now() - started, costUsd: calculateCost(model, usage), usage,
+            output: parsed, raw: payload,
+        };
+    }
+    async embed(texts) {
+        const res = await fetch(`${this.baseUrl}/embeddings`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                input: texts,
+                model: "text-embedding-3-small",
+            }),
+        });
+        if (!res.ok) {
+            const raw = await res.json().catch(() => ({}));
+            throw mapHttpError(VENDOR, res.status, raw, "embed");
+        }
+        const payload = (await res.json());
+        return {
+            vectors: payload.data.map((d) => d.embedding),
+            model: payload.model,
+            usage: { totalTokens: payload.usage.total_tokens }
+        };
+    }
+    async healthCheck() {
+        return Boolean(this.apiKey && this.baseUrl);
+    }
+}
+//# sourceMappingURL=openai-adapter.js.map

package/dist/openai-adapter.js.map

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

package/dist/pricing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file pricing.ts
+ * Token pricing catalog and cost calculation.
+ *
+ * Prices are in USD per 1M tokens unless specified.
+ * Updated: 2026-02 (simulated current date)
+ */
+/**
+ * Calculates the estimated cost in USD for a given usage.
+ */
+export declare function calculateCost(model: string, usage?: {
+    promptTokens: number;
+    completionTokens: number;
+}): number;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0DH;;GAEG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CAMR"}