rax-flow-providers 0.1.0

package/dist/claude-adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file claude-adapter.ts
+ * Anthropic Claude bridge adapter.
+ *
+ * API reference: https://docs.anthropic.com/en/api/messages
+ *
+ * • callModel      → POST /v1/messages  (plain text, streaming=false)
+ * • callStructured → same endpoint using Claude's tool_use mechanism
+ *                    (the structured extraction tool), which is the most
+ *                    reliable way to get valid JSON from Claude without
+ *                    prompt-hacking.  Falls back to prompt-only for
+ *                    claude-3-haiku which may not have tool_use.
+ *
+ * Supported models: claude-opus-4-5, claude-sonnet-4-5,
+ *                   claude-3-7-sonnet-latest, claude-3-5-sonnet-latest,
+ *                   claude-3-5-haiku-latest, claude-3-haiku-20240307
+ */
+import { IModelProvider, ModelResponse, ProviderCallOptions } from "@rax-flow/core";
+export interface ClaudeAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    timeoutMs?: number;
+}
+export declare class ClaudeAdapter implements IModelProvider {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    constructor(options: ClaudeAdapterOptions);
+    /** @deprecated Pass an options object instead. */
+    constructor(apiKey: string, baseUrl?: string);
+    private supportsToolUse;
+    private post;
+    private extractText;
+    private extractToolInput;
+    callModel(prompt: string, options?: ProviderCallOptions): Promise<ModelResponse<string>>;
+    callStructured<T>(prompt: string, schema: object, options?: ProviderCallOptions): Promise<ModelResponse<T>>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=claude-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../src/claude-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAoEpF,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;IAClD,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,kDAAkD;gBACtC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAoB5C,OAAO,CAAC,eAAe;YAST,IAAI;IAkDlB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,gBAAgB;IAUlB,SAAS,CACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAiC3B,cAAc,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA2GtB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/claude-adapter.js

@@ -0,0 +1,236 @@
+/**
+ * @file claude-adapter.ts
+ * Anthropic Claude bridge adapter.
+ *
+ * API reference: https://docs.anthropic.com/en/api/messages
+ *
+ * • callModel      → POST /v1/messages  (plain text, streaming=false)
+ * • callStructured → same endpoint using Claude's tool_use mechanism
+ *                    (the structured extraction tool), which is the most
+ *                    reliable way to get valid JSON from Claude without
+ *                    prompt-hacking.  Falls back to prompt-only for
+ *                    claude-3-haiku which may not have tool_use.
+ *
+ * Supported models: claude-opus-4-5, claude-sonnet-4-5,
+ *                   claude-3-7-sonnet-latest, claude-3-5-sonnet-latest,
+ *                   claude-3-5-haiku-latest, claude-3-haiku-20240307
+ */
+import { asString, parseJsonObjectFromText } from "./utils.js";
+import { RaxProviderError, mapHttpError, mapNetworkError, mapParseError, } from "./error-mapper.js";
+import { calculateCost } from "./pricing.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Adapter
+// ─────────────────────────────────────────────────────────────────────────────
+const VENDOR = "claude";
+const DEFAULT_MODEL = "claude-3-5-sonnet-latest";
+const DEFAULT_BASE_URL = "https://api.anthropic.com";
+const ANTHROPIC_VERSION = "2023-06-01";
+/** Models that reliably support tool_use for structured output extraction. */
+const TOOL_USE_MODELS = new Set([
+    "claude-opus-4-5",
+    "claude-sonnet-4-5",
+    "claude-3-7-sonnet-latest",
+    "claude-3-5-sonnet-latest",
+    "claude-3-5-haiku-latest",
+    "claude-3-opus-20240229",
+    "claude-3-sonnet-20240229",
+]);
+export class ClaudeAdapter {
+    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;
+        }
+    }
+    // ── private helpers ────────────────────────────────────────────────────────
+    supportsToolUse(model) {
+        for (const known of TOOL_USE_MODELS) {
+            if (model === known || model.startsWith(`${known}-`) || model.startsWith("claude-3-5") || model.startsWith("claude-3-7") || model.startsWith("claude-opus") || model.startsWith("claude-sonnet")) {
+                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}/v1/messages`, {
+                method: "POST",
+                headers: {
+                    "x-api-key": this.apiKey,
+                    "anthropic-version": ANTHROPIC_VERSION,
+                    "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;
+        // Anthropic embeds errors inside 200 (type: "error")
+        if (payload.type === "error" && payload.error) {
+            const errType = payload.error.type ?? "";
+            const errMsg = payload.error.message ?? "unknown claude error";
+            const code = errType === "overloaded_error" ? "server_error" :
+                errType === "rate_limit_error" ? "auth_quota_exceeded" :
+                    errType === "authentication_error" ? "auth_invalid" :
+                        (errType.includes("content") || errType.includes("safety")) ? "content_filtered" :
+                            "unknown";
+            throw new RaxProviderError(VENDOR, code, errMsg, { raw: payload });
+        }
+        return payload;
+    }
+    extractText(payload) {
+        return (payload.content
+            ?.filter((c) => c.type === "text")
+            .map((c) => c.text)
+            .join("\n") ?? "");
+    }
+    extractToolInput(payload) {
+        const toolBlock = payload.content?.find((c) => c.type === "tool_use");
+        return toolBlock?.input ?? null;
+    }
+    // ── IModelProvider ─────────────────────────────────────────────────────────
+    async callModel(prompt, options) {
+        const started = Date.now();
+        const model = options?.model ?? this.defaultModel;
+        const payload = await this.post({
+            model,
+            max_tokens: options?.maxTokens ?? 1200,
+            temperature: options?.temperature ?? 0.2,
+            messages: [{ role: "user", content: prompt }],
+        }, "callModel");
+        const usage = payload.usage
+            ? {
+                promptTokens: payload.usage.input_tokens ?? 0,
+                completionTokens: payload.usage.output_tokens ?? 0,
+                totalTokens: (payload.usage.input_tokens ?? 0) + (payload.usage.output_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;
+        if (this.supportsToolUse(model)) {
+            // ── Tool-use path (most reliable for structured output) ────────────────
+            const extractionTool = {
+                name: "structured_output",
+                description: "Extract the required structured data and return it as JSON.",
+                input_schema: schema,
+            };
+            const payload = await this.post({
+                model,
+                max_tokens: options?.maxTokens ?? 1400,
+                temperature: options?.temperature ?? 0,
+                messages: [{ role: "user", content: prompt }],
+                tools: [extractionTool],
+                tool_choice: { type: "tool", name: "structured_output" },
+            }, "callStructured");
+            const usage = payload.usage
+                ? {
+                    promptTokens: payload.usage.input_tokens ?? 0,
+                    completionTokens: payload.usage.output_tokens ?? 0,
+                    totalTokens: (payload.usage.input_tokens ?? 0) + (payload.usage.output_tokens ?? 0),
+                }
+                : undefined;
+            const toolInput = this.extractToolInput(payload);
+            if (toolInput && typeof toolInput === "object") {
+                return {
+                    provider: VENDOR,
+                    model,
+                    latencyMs: Date.now() - started,
+                    costUsd: calculateCost(model, usage),
+                    usage,
+                    output: toolInput,
+                    raw: payload,
+                };
+            }
+            // If tool_use block missing, fall through to text parsing
+            const textFallback = this.extractText(payload);
+            const parsed = parseJsonObjectFromText(textFallback);
+            if (parsed) {
+                return {
+                    provider: VENDOR,
+                    model,
+                    latencyMs: Date.now() - started,
+                    costUsd: calculateCost(model, usage),
+                    usage,
+                    output: parsed,
+                    raw: payload,
+                };
+            }
+            throw mapParseError(VENDOR, "callStructured", textFallback);
+        }
+        // ── Prompt-only path (claude-3-haiku and legacy models) ─────────────────
+        const strictPrompt = [
+            prompt,
+            "",
+            "Return ONLY valid JSON matching this schema (no other text):",
+            JSON.stringify(schema, null, 2),
+        ].join("\n");
+        const payload = await this.post({
+            model,
+            max_tokens: options?.maxTokens ?? 1400,
+            temperature: 0,
+            messages: [{ role: "user", content: strictPrompt }],
+        }, "callStructured");
+        const usage = payload.usage
+            ? {
+                promptTokens: payload.usage.input_tokens ?? 0,
+                completionTokens: payload.usage.output_tokens ?? 0,
+                totalTokens: (payload.usage.input_tokens ?? 0) + (payload.usage.output_tokens ?? 0),
+            }
+            : undefined;
+        const text = this.extractText(payload);
+        const parsed = parseJsonObjectFromText(asString(text));
+        if (!parsed) {
+            throw mapParseError(VENDOR, "callStructured", text);
+        }
+        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=claude-adapter.js.map

package/dist/claude-adapter.js.map

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

package/dist/cohere-adapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file cohere-adapter.ts
+ * Cohere bridge adapter (Command R / Command R+).
+ *
+ * API reference: https://docs.cohere.com/reference/chat
+ *
+ * • callModel      → POST /v2/chat  (v2 chat API — streaming=false)
+ * • callStructured → same endpoint with response_format="json_object"
+ *                    and a JSON schema injected via system_prompt
+ *
+ * Supported models: command-r-plus-08-2024, command-r-08-2024,
+ *                   command-r7b-12-2024, command-a-03-2025, etc.
+ *
+ * Notes:
+ * - Cohere v2 uses "message" field not "messages" for single-turn.
+ * - Structured JSON is supported via response_format + preamble (system).
+ */
+import { IModelProvider, ModelResponse, ProviderCallOptions } from "@rax-flow/core";
+export interface CohereAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    timeoutMs?: number;
+}
+export declare class CohereAdapter implements IModelProvider {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    constructor(options: CohereAdapterOptions);
+    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=cohere-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cohere-adapter.d.ts","sourceRoot":"","sources":["../src/cohere-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA0DpF,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAc,YAAW,cAAc;IAChD,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;YAS3B,IAAI;IAkDlB,OAAO,CAAC,WAAW;IAWb,SAAS,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAmC3B,cAAc,CAAC,CAAC,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAyDtB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/dist/cohere-adapter.js

@@ -0,0 +1,160 @@
+/**
+ * @file cohere-adapter.ts
+ * Cohere bridge adapter (Command R / Command R+).
+ *
+ * API reference: https://docs.cohere.com/reference/chat
+ *
+ * • callModel      → POST /v2/chat  (v2 chat API — streaming=false)
+ * • callStructured → same endpoint with response_format="json_object"
+ *                    and a JSON schema injected via system_prompt
+ *
+ * Supported models: command-r-plus-08-2024, command-r-08-2024,
+ *                   command-r7b-12-2024, command-a-03-2025, etc.
+ *
+ * Notes:
+ * - Cohere v2 uses "message" field not "messages" for single-turn.
+ * - Structured JSON is supported via response_format + preamble (system).
+ */
+import { parseJsonObjectFromText } from "./utils.js";
+import { RaxProviderError, mapHttpError, mapNetworkError, mapParseError, } from "./error-mapper.js";
+import { calculateCost } from "./pricing.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Adapter
+// ─────────────────────────────────────────────────────────────────────────────
+const VENDOR = "cohere";
+const DEFAULT_MODEL = "command-r-plus-08-2024";
+const BASE_URL = "https://api.cohere.com";
+export class CohereAdapter {
+    apiKey;
+    baseUrl;
+    defaultModel;
+    timeoutMs;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? BASE_URL;
+        this.defaultModel = options.defaultModel ?? DEFAULT_MODEL;
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+    }
+    // ── private helpers ────────────────────────────────────────────────────────
+    async post(body, context) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let res;
+        try {
+            res = await fetch(`${this.baseUrl}/v2/chat`, {
+                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;
+        // Cohere finish reasons that signal a safety block
+        if (payload.finish_reason === "MAX_TOKENS" &&
+            !payload.message?.content?.length) {
+            throw new RaxProviderError(VENDOR, "content_filtered", "Cohere response truncated without content — possible safety block", { raw: payload });
+        }
+        return payload;
+    }
+    extractText(payload) {
+        return (payload.message?.content
+            ?.filter((c) => c.type === "text")
+            .map((c) => c.text ?? "")
+            .join("\n") ?? "");
+    }
+    // ── 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,
+            messages: [{ role: "user", content: prompt }],
+        }, "callModel");
+        const inputTokens = payload.usage?.billed_units?.input_tokens ?? 0;
+        const outputTokens = payload.usage?.billed_units?.output_tokens ?? 0;
+        const usage = payload.usage?.billed_units
+            ? {
+                promptTokens: inputTokens,
+                completionTokens: outputTokens,
+                totalTokens: inputTokens + outputTokens,
+            }
+            : 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;
+        // Cohere json_object mode with schema embedded in system message
+        const systemContent = [
+            "You are a JSON generation assistant.",
+            "ALWAYS respond with ONLY a valid JSON object.",
+            "The JSON must strictly follow this schema:",
+            JSON.stringify(schema, null, 2),
+        ].join("\n");
+        const payload = await this.post({
+            model,
+            temperature: options?.temperature ?? 0,
+            max_tokens: options?.maxTokens ?? 1400,
+            response_format: {
+                type: "json_object",
+                json_schema: schema,
+            },
+            messages: [
+                { role: "system", content: systemContent },
+                { role: "user", content: prompt },
+            ],
+        }, "callStructured");
+        const text = this.extractText(payload);
+        const parsed = parseJsonObjectFromText(text);
+        if (!parsed) {
+            throw mapParseError(VENDOR, "callStructured", text);
+        }
+        const inputTokens = payload.usage?.billed_units?.input_tokens ?? 0;
+        const outputTokens = payload.usage?.billed_units?.output_tokens ?? 0;
+        const usage = payload.usage?.billed_units
+            ? {
+                promptTokens: inputTokens,
+                completionTokens: outputTokens,
+                totalTokens: inputTokens + outputTokens,
+            }
+            : 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=cohere-adapter.js.map

package/dist/cohere-adapter.js.map

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

package/dist/error-mapper.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file error-mapper.ts
+ * Standardized error taxonomy for all vendor bridge adapters.
+ *
+ * Every adapter MUST throw a `RaxProviderError` (or a subclass) so that the
+ * orchestrator / recovery engine can make uniform decisions on retry,
+ * fallback, and escalation without inspecting vendor-specific strings.
+ */
+export type RaxErrorCode = "auth_invalid" | "auth_quota_exceeded" | "model_not_found" | "context_length_exceeded" | "content_filtered" | "invalid_request" | "server_error" | "network_error" | "timeout" | "parse_failed" | "structured_schema_mismatch" | "bridge_unavailable" | "unknown";
+/** True when the caller should retry the *same* provider. */
+export declare const RETRYABLE_CODES: ReadonlySet<RaxErrorCode>;
+/** True when the orchestrator should fall back to a *different* provider. */
+export declare const FALLBACK_CODES: ReadonlySet<RaxErrorCode>;
+export declare class RaxProviderError extends Error {
+    /** Machine-readable code driving orchestrator decisions. */
+    readonly code: RaxErrorCode;
+    /** HTTP status code if the error originated from an HTTP response. */
+    readonly httpStatus?: number;
+    /** Originating vendor name (e.g. "openai", "gemini"). */
+    readonly vendor: string;
+    /** Whether the same provider should be retried. */
+    readonly isRetryable: boolean;
+    /** Whether the orchestrator should fall back to another provider. */
+    readonly shouldFallback: boolean;
+    /** Raw vendor error payload for observability. */
+    readonly raw?: unknown;
+    constructor(vendor: string, code: RaxErrorCode, message: string, options?: {
+        httpStatus?: number;
+        raw?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Maps a non-2xx HTTP response to a `RaxProviderError`.
+ * Each adapter calls this after detecting `!res.ok`.
+ *
+ * @param vendor  - The adapter name string (e.g. "gemini")
+ * @param status  - HTTP status code
+ * @param body    - Pre-parsed response body (may be any shape)
+ * @param context - "callModel" | "callStructured" for message clarity
+ */
+export declare function mapHttpError(vendor: string, status: number, body: unknown, context: "callModel" | "callStructured"): RaxProviderError;
+/**
+ * Wraps a network-level exception (fetch threw) in a `RaxProviderError`.
+ */
+export declare function mapNetworkError(vendor: string, cause: unknown): RaxProviderError;
+/**
+ * Creates a structured-output parse failure error.
+ */
+export declare function mapParseError(vendor: string, context: "callStructured", raw: string): RaxProviderError;
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../src/error-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,YAAY,GAClB,cAAc,GACd,qBAAqB,GACrB,iBAAiB,GACjB,yBAAyB,GACzB,kBAAkB,GAClB,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,SAAS,GACT,cAAc,GACd,4BAA4B,GAC5B,oBAAoB,GACpB,SAAS,CAAC;AAEhB,6DAA6D;AAC7D,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,YAAY,CAKpD,CAAC;AAEH,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,YAAY,CAOnD,CAAC;AAMH,qBAAa,gBAAiB,SAAQ,KAAK;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;gBAGnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CActE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,WAAW,GAAG,gBAAgB,GACxC,gBAAgB,CAgClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAWhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,GACZ,gBAAgB,CAOlB"}