rax-flow-providers 0.1.0

package/dist/error-mapper.js

@@ -0,0 +1,132 @@
+/**
+ * @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.
+ */
+/** True when the caller should retry the *same* provider. */
+export const RETRYABLE_CODES = new Set([
+    "server_error",
+    "network_error",
+    "timeout",
+    "auth_quota_exceeded",
+]);
+/** True when the orchestrator should fall back to a *different* provider. */
+export const FALLBACK_CODES = new Set([
+    "auth_invalid",
+    "model_not_found",
+    "context_length_exceeded",
+    "content_filtered",
+    "bridge_unavailable",
+    "auth_quota_exceeded",
+]);
+// ─────────────────────────────────────────────────────────────────────────────
+// Error class
+// ─────────────────────────────────────────────────────────────────────────────
+export class RaxProviderError extends Error {
+    /** Machine-readable code driving orchestrator decisions. */
+    code;
+    /** HTTP status code if the error originated from an HTTP response. */
+    httpStatus;
+    /** Originating vendor name (e.g. "openai", "gemini"). */
+    vendor;
+    /** Whether the same provider should be retried. */
+    isRetryable;
+    /** Whether the orchestrator should fall back to another provider. */
+    shouldFallback;
+    /** Raw vendor error payload for observability. */
+    raw;
+    constructor(vendor, code, message, options) {
+        super(`[${vendor}] ${code}: ${message}`);
+        this.name = "RaxProviderError";
+        this.vendor = vendor;
+        this.code = code;
+        this.httpStatus = options?.httpStatus;
+        this.raw = options?.raw;
+        this.isRetryable = RETRYABLE_CODES.has(code);
+        this.shouldFallback = FALLBACK_CODES.has(code);
+        if (options?.cause) {
+            this.cause = options.cause;
+        }
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// HTTP response → RaxProviderError mapper
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 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 function mapHttpError(vendor, status, body, context) {
+    const msg = extractVendorMessage(body);
+    let code;
+    if (status === 401 || status === 403) {
+        code = "auth_invalid";
+    }
+    else if (status === 429) {
+        code = "auth_quota_exceeded";
+    }
+    else if (status === 404) {
+        code = "model_not_found";
+    }
+    else if (status === 400) {
+        // Heuristic sub-classification from message text
+        if (/context.length|token.limit|max.context/i.test(msg)) {
+            code = "context_length_exceeded";
+        }
+        else if (/filter|moderat|safety|policy|blocked/i.test(msg)) {
+            code = "content_filtered";
+        }
+        else {
+            code = "invalid_request";
+        }
+    }
+    else if (status >= 500) {
+        code = "server_error";
+    }
+    else {
+        code = "unknown";
+    }
+    return new RaxProviderError(vendor, code, `${context} failed — HTTP ${status}: ${msg}`, { httpStatus: status, raw: body });
+}
+/**
+ * Wraps a network-level exception (fetch threw) in a `RaxProviderError`.
+ */
+export function mapNetworkError(vendor, cause) {
+    const isTimeout = cause instanceof Error &&
+        (cause.name === "AbortError" || /timeout/i.test(cause.message));
+    return new RaxProviderError(vendor, isTimeout ? "timeout" : "network_error", cause instanceof Error ? cause.message : String(cause), { cause: cause instanceof Error ? cause : undefined });
+}
+/**
+ * Creates a structured-output parse failure error.
+ */
+export function mapParseError(vendor, context, raw) {
+    return new RaxProviderError(vendor, "parse_failed", `${context}: model output could not be parsed as JSON`, { raw });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function extractVendorMessage(body) {
+    if (typeof body === "string")
+        return body.slice(0, 300);
+    if (body && typeof body === "object") {
+        const b = body;
+        // Common shapes across vendors
+        const candidate = b["error"]?.["message"] ??
+            b["message"] ??
+            b["detail"] ??
+            b["error"] ??
+            b["msg"];
+        if (typeof candidate === "string")
+            return candidate.slice(0, 300);
+    }
+    return "(no message)";
+}
+//# sourceMappingURL=error-mapper.js.map

package/dist/error-mapper.js.map

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

package/dist/gemini-adapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file gemini-adapter.ts
+ * Google Gemini bridge adapter.
+ *
+ * API reference: https://ai.google.dev/api/generate-content
+ *
+ * • callModel   → POST /v1beta/models/{model}:generateContent
+ * • callStructured → same endpoint + responseMimeType "application/json" +
+ *                    responseSchema (Gemini native JSON mode, no prompt hack)
+ *
+ * Models: gemini-2.0-flash, gemini-2.0-flash-lite, gemini-1.5-pro, etc.
+ */
+import { IModelProvider, ModelResponse, ProviderCallOptions } from "@rax-flow/core";
+export interface GeminiAdapterOptions {
+    /** Google AI Studio or Vertex AI API key. */
+    apiKey: string;
+    /** Override base URL (e.g. for Vertex AI Express endpoints). */
+    baseUrl?: string;
+    /** Default model to use when none is specified per-call. */
+    defaultModel?: string;
+    /** Request timeout in ms (default: 30 000). */
+    timeoutMs?: number;
+}
+export declare class GeminiAdapter implements IModelProvider {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    constructor(options: GeminiAdapterOptions);
+    private endpoint;
+    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=gemini-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-adapter.d.ts","sourceRoot":"","sources":["../src/gemini-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAqDpF,MAAM,WAAW,oBAAoB;IACjC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,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;IASzC,OAAO,CAAC,QAAQ;YAIF,IAAI;IAkDlB,OAAO,CAAC,WAAW;IAQb,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;IA+CtB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/dist/gemini-adapter.js

@@ -0,0 +1,150 @@
+/**
+ * @file gemini-adapter.ts
+ * Google Gemini bridge adapter.
+ *
+ * API reference: https://ai.google.dev/api/generate-content
+ *
+ * • callModel   → POST /v1beta/models/{model}:generateContent
+ * • callStructured → same endpoint + responseMimeType "application/json" +
+ *                    responseSchema (Gemini native JSON mode, no prompt hack)
+ *
+ * Models: gemini-2.0-flash, gemini-2.0-flash-lite, gemini-1.5-pro, etc.
+ */
+import { parseJsonObjectFromText } from "./utils.js";
+import { RaxProviderError, mapHttpError, mapNetworkError, mapParseError, } from "./error-mapper.js";
+import { calculateCost } from "./pricing.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Adapter
+// ─────────────────────────────────────────────────────────────────────────────
+const VENDOR = "gemini";
+const DEFAULT_MODEL = "gemini-2.0-flash";
+const BASE_URL = "https://generativelanguage.googleapis.com";
+export class GeminiAdapter {
+    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 ────────────────────────────────────────────────────────
+    endpoint(model, suffix = ":generateContent") {
+        return `${this.baseUrl}/v1beta/models/${model}${suffix}?key=${this.apiKey}`;
+    }
+    async post(url, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let res;
+        try {
+            res = await fetch(url, {
+                method: "POST",
+                headers: { "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, "callModel");
+        }
+        // Gemini sometimes embeds error inside a 200 body
+        const payload = raw;
+        if (payload.error) {
+            throw mapHttpError(VENDOR, payload.error.code ?? 500, payload.error, "callModel");
+        }
+        // Safety filter rejection
+        const finishReason = payload.candidates?.[0]?.finishReason;
+        if (finishReason === "SAFETY" || finishReason === "RECITATION") {
+            throw new RaxProviderError(VENDOR, "content_filtered", `Generation stopped: ${finishReason}`, { raw: payload });
+        }
+        return payload;
+    }
+    extractText(payload) {
+        return (payload.candidates?.[0]?.content?.parts?.map((p) => p.text ?? "").join("\n") ?? "");
+    }
+    // ── IModelProvider ─────────────────────────────────────────────────────────
+    async callModel(prompt, options) {
+        const started = Date.now();
+        const model = options?.model ?? this.defaultModel;
+        const body = {
+            contents: [{ role: "user", parts: [{ text: prompt }] }],
+            generationConfig: {
+                temperature: options?.temperature ?? 0.2,
+                maxOutputTokens: options?.maxTokens ?? 1200,
+            },
+        };
+        const payload = await this.post(this.endpoint(model), body);
+        const output = this.extractText(payload);
+        const usage = payload.usageMetadata
+            ? {
+                promptTokens: payload.usageMetadata.promptTokenCount ?? 0,
+                completionTokens: payload.usageMetadata.candidatesTokenCount ?? 0,
+                totalTokens: payload.usageMetadata.totalTokenCount ?? 0,
+            }
+            : undefined;
+        return {
+            provider: VENDOR,
+            model,
+            latencyMs: Date.now() - started,
+            costUsd: calculateCost(model, usage),
+            usage,
+            output,
+            raw: payload,
+        };
+    }
+    async callStructured(prompt, schema, options) {
+        const started = Date.now();
+        const model = options?.model ?? this.defaultModel;
+        // Gemini native JSON mode: responseMimeType + responseSchema
+        const body = {
+            contents: [{ role: "user", parts: [{ text: prompt }] }],
+            generationConfig: {
+                temperature: options?.temperature ?? 0,
+                maxOutputTokens: options?.maxTokens ?? 1400,
+                responseMimeType: "application/json",
+                responseSchema: schema,
+            },
+        };
+        // Re-tag the context for HTTP error messages
+        const payload = await this.post(this.endpoint(model), body).catch((err) => {
+            if (err instanceof RaxProviderError)
+                throw err;
+            throw mapNetworkError(VENDOR, err);
+        });
+        const text = this.extractText(payload);
+        const parsed = parseJsonObjectFromText(text);
+        if (!parsed) {
+            throw mapParseError(VENDOR, "callStructured", text);
+        }
+        const usage = payload.usageMetadata
+            ? {
+                promptTokens: payload.usageMetadata.promptTokenCount ?? 0,
+                completionTokens: payload.usageMetadata.candidatesTokenCount ?? 0,
+                totalTokens: payload.usageMetadata.totalTokenCount ?? 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=gemini-adapter.js.map

package/dist/gemini-adapter.js.map

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

package/dist/groq-adapter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file groq-adapter.ts
+ * Groq Cloud bridge adapter.
+ *
+ * API reference: https://console.groq.com/docs/openai
+ *
+ * Groq exposes an **OpenAI-compatible** REST API, so the wire format is
+ * identical to OpenAI.  However there are Groq-specific behaviours:
+ *
+ * • Rate-limit headers: `x-ratelimit-*` (mapped to RaxProviderError)
+ * • Structured output: Groq supports `response_format: { type: "json_object" }`
+ *   but NOT yet OpenAI's strict `json_schema` mode on all models — we use the
+ *   json_object mode + system prompt enforcement as the safe universal path.
+ * • Models: llama-3.3-70b-versatile, llama3-8b-8192, mixtral-8x7b-32768, etc.
+ */
+import { IModelProvider, ModelResponse, ProviderCallOptions } from "@rax-flow/core";
+export interface GroqAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    timeoutMs?: number;
+}
+export declare class GroqAdapter implements IModelProvider {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly timeoutMs;
+    constructor(options: GroqAdapterOptions);
+    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=groq-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groq-adapter.d.ts","sourceRoot":"","sources":["../src/groq-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA6CpF,MAAM,WAAW,kBAAkB;IAC/B,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,WAAY,YAAW,cAAc;IAC9C,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,kBAAkB;YASzB,IAAI;IAyDlB,OAAO,CAAC,WAAW;IAMb,SAAS,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IA8B3B,cAAc,CAAC,CAAC,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA+CtB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/dist/groq-adapter.js

@@ -0,0 +1,152 @@
+/**
+ * @file groq-adapter.ts
+ * Groq Cloud bridge adapter.
+ *
+ * API reference: https://console.groq.com/docs/openai
+ *
+ * Groq exposes an **OpenAI-compatible** REST API, so the wire format is
+ * identical to OpenAI.  However there are Groq-specific behaviours:
+ *
+ * • Rate-limit headers: `x-ratelimit-*` (mapped to RaxProviderError)
+ * • Structured output: Groq supports `response_format: { type: "json_object" }`
+ *   but NOT yet OpenAI's strict `json_schema` mode on all models — we use the
+ *   json_object mode + system prompt enforcement as the safe universal path.
+ * • Models: llama-3.3-70b-versatile, llama3-8b-8192, mixtral-8x7b-32768, etc.
+ */
+import { parseJsonObjectFromText } from "./utils.js";
+import { RaxProviderError, mapHttpError, mapNetworkError, mapParseError, } from "./error-mapper.js";
+import { calculateCost } from "./pricing.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Adapter
+// ─────────────────────────────────────────────────────────────────────────────
+const VENDOR = "groq";
+const DEFAULT_MODEL = "llama-3.3-70b-versatile";
+const BASE_URL = "https://api.groq.com/openai/v1";
+export class GroqAdapter {
+    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 ?? 20_000;
+    }
+    // ── private helpers ────────────────────────────────────────────────────────
+    async post(body) {
+        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) {
+            // Groq returns 429 for both rate-limit and daily quota; differentiate
+            // by x-ratelimit-remaining-requests header when available
+            throw mapHttpError(VENDOR, res.status, raw, "callModel");
+        }
+        const payload = raw;
+        // Groq may embed error inside a 200 (rare but observed during testing)
+        if (payload.error) {
+            const isQuota = /quota|limit/i.test(payload.error.message ?? "");
+            throw new RaxProviderError(VENDOR, isQuota ? "auth_quota_exceeded" : "server_error", payload.error.message ?? "unknown groq error", { raw: payload });
+        }
+        // Safety / content filter
+        const finishReason = payload.choices?.[0]?.finish_reason;
+        if (finishReason === "content_filter") {
+            throw new RaxProviderError(VENDOR, "content_filtered", "Response blocked by Groq content filter", { 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,
+            messages: [{ role: "user", content: prompt }],
+        });
+        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;
+        // json_object mode: Groq requires at least one message to mention "JSON"
+        const systemMsg = {
+            role: "system",
+            content: `You MUST respond with valid JSON only.
+Schema to follow strictly:
+${JSON.stringify(schema, null, 2)}
+Do not include any text outside the JSON object.`,
+        };
+        const payload = await this.post({
+            model,
+            temperature: options?.temperature ?? 0,
+            max_tokens: options?.maxTokens ?? 1400,
+            response_format: { type: "json_object" },
+            messages: [systemMsg, { role: "user", content: prompt }],
+        });
+        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=groq-adapter.js.map

package/dist/groq-adapter.js.map

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

package/dist/host-bridge-adapter.d.ts

@@ -0,0 +1,20 @@
+import { IModelProvider, ModelResponse, ProviderCallOptions } from "@rax-flow/core";
+interface HostBridgeAdapterOptions {
+    model?: string;
+    mode?: "auto" | "bridge-only" | "mock";
+    command?: string;
+    timeoutMs?: number;
+}
+export declare class HostBridgeAdapter implements IModelProvider {
+    private readonly model;
+    private readonly mode;
+    private readonly command?;
+    private readonly timeoutMs;
+    constructor(options?: HostBridgeAdapterOptions);
+    private callBridge;
+    callModel(prompt: string, options?: ProviderCallOptions): Promise<ModelResponse<string>>;
+    callStructured<T>(prompt: string, schema: object, options?: ProviderCallOptions): Promise<ModelResponse<T>>;
+    healthCheck(): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=host-bridge-adapter.d.ts.map

package/dist/host-bridge-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge-adapter.d.ts","sourceRoot":"","sources":["../src/host-bridge-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAqBpF,UAAU,wBAAwB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkED,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,GAAE,wBAA6B;YAOpC,UAAU;IAmClB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAexF,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA0B3G,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAMtC"}