@umituz/react-native-ai-groq-provider 1.0.3 → 1.0.5

package/dist/domain/entities/error.types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Custom error class for Groq operations
+ */
+export declare class GroqError extends Error {
+    type: GroqErrorType;
+    cause?: unknown;
+    constructor(type: GroqErrorType, message: string, cause?: unknown);
+}
+/**
+ * Error types for Groq operations
+ */
+export declare enum GroqErrorType {
+    /** API key is missing or invalid */
+    INVALID_API_KEY = "INVALID_API_KEY",
+    /** Configuration is missing or invalid */
+    MISSING_CONFIG = "MISSING_CONFIG",
+    /** Network error occurred */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /** Request was aborted */
+    ABORT_ERROR = "ABORT_ERROR",
+    /** Rate limit exceeded */
+    RATE_LIMIT_ERROR = "RATE_LIMIT_ERROR",
+    /** Insufficient quota */
+    QUOTA_EXCEEDED = "QUOTA_EXCEEDED",
+    /** Server error */
+    SERVER_ERROR = "SERVER_ERROR",
+    /** Unknown error occurred */
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Map HTTP status codes to error types
+ */
+export declare function mapHttpStatusToErrorType(status: number): GroqErrorType;
+//# sourceMappingURL=error.types.d.ts.map

package/dist/domain/entities/error.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.types.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/error.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAEzB,IAAI,EAAE,aAAa;IAEnB,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,aAAa,EAC1B,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,OAAO;CAKzB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,oCAAoC;IACpC,eAAe,oBAAoB;IACnC,0CAA0C;IAC1C,cAAc,mBAAmB;IACjC,6BAA6B;IAC7B,aAAa,kBAAkB;IAC/B,0BAA0B;IAC1B,WAAW,gBAAgB;IAC3B,0BAA0B;IAC1B,gBAAgB,qBAAqB;IACrC,yBAAyB;IACzB,cAAc,mBAAmB;IACjC,mBAAmB;IACnB,YAAY,iBAAiB;IAC7B,6BAA6B;IAC7B,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CActE"}

package/dist/domain/entities/error.types.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroqErrorType = exports.GroqError = void 0;
+exports.mapHttpStatusToErrorType = mapHttpStatusToErrorType;
+/**
+ * Custom error class for Groq operations
+ */
+class GroqError extends Error {
+    constructor(type, message, cause) {
+        super(message);
+        this.type = type;
+        this.cause = cause;
+        this.name = "GroqError";
+    }
+}
+exports.GroqError = GroqError;
+/**
+ * Error types for Groq operations
+ */
+var GroqErrorType;
+(function (GroqErrorType) {
+    /** API key is missing or invalid */
+    GroqErrorType["INVALID_API_KEY"] = "INVALID_API_KEY";
+    /** Configuration is missing or invalid */
+    GroqErrorType["MISSING_CONFIG"] = "MISSING_CONFIG";
+    /** Network error occurred */
+    GroqErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+    /** Request was aborted */
+    GroqErrorType["ABORT_ERROR"] = "ABORT_ERROR";
+    /** Rate limit exceeded */
+    GroqErrorType["RATE_LIMIT_ERROR"] = "RATE_LIMIT_ERROR";
+    /** Insufficient quota */
+    GroqErrorType["QUOTA_EXCEEDED"] = "QUOTA_EXCEEDED";
+    /** Server error */
+    GroqErrorType["SERVER_ERROR"] = "SERVER_ERROR";
+    /** Unknown error occurred */
+    GroqErrorType["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(GroqErrorType || (exports.GroqErrorType = GroqErrorType = {}));
+/**
+ * Map HTTP status codes to error types
+ */
+function mapHttpStatusToErrorType(status) {
+    if (status === 401 || status === 403) {
+        return GroqErrorType.INVALID_API_KEY;
+    }
+    if (status === 429) {
+        return GroqErrorType.RATE_LIMIT_ERROR;
+    }
+    if (status >= 500 && status < 600) {
+        return GroqErrorType.SERVER_ERROR;
+    }
+    if (status >= 400 && status < 500) {
+        return GroqErrorType.INVALID_API_KEY;
+    }
+    return GroqErrorType.UNKNOWN_ERROR;
+}
+//# sourceMappingURL=error.types.js.map

package/dist/domain/entities/error.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.types.js","sourceRoot":"","sources":["../../../src/domain/entities/error.types.ts"],"names":[],"mappings":";;;AAuCA,4DAcC;AArDD;;GAEG;AACH,MAAa,SAAU,SAAQ,KAAK;IAClC,YACS,IAAmB,EAC1B,OAAe,EACR,KAAe;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAe;QAEnB,UAAK,GAAL,KAAK,CAAU;QAGtB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AATD,8BASC;AAED;;GAEG;AACH,IAAY,aAiBX;AAjBD,WAAY,aAAa;IACvB,oCAAoC;IACpC,oDAAmC,CAAA;IACnC,0CAA0C;IAC1C,kDAAiC,CAAA;IACjC,6BAA6B;IAC7B,gDAA+B,CAAA;IAC/B,0BAA0B;IAC1B,4CAA2B,CAAA;IAC3B,0BAA0B;IAC1B,sDAAqC,CAAA;IACrC,yBAAyB;IACzB,kDAAiC,CAAA;IACjC,mBAAmB;IACnB,8CAA6B,CAAA;IAC7B,6BAA6B;IAC7B,gDAA+B,CAAA;AACjC,CAAC,EAjBW,aAAa,6BAAb,aAAa,QAiBxB;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,MAAc;IACrD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,aAAa,CAAC,eAAe,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC,gBAAgB,CAAC;IACxC,CAAC;IACD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAClC,OAAO,aAAa,CAAC,YAAY,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAClC,OAAO,aAAa,CAAC,eAAe,CAAC;IACvC,CAAC;IACD,OAAO,aAAa,CAAC,aAAa,CAAC;AACrC,CAAC"}

package/dist/domain/entities/groq.types.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Configuration for Groq client initialization
+ */
+export interface GroqConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for API requests (default: https://api.groq.com/openai/v1) */
+    baseUrl?: string;
+    /** Default timeout in milliseconds */
+    timeoutMs?: number;
+    /** Default model to use for text generation */
+    textModel?: string;
+}
+/**
+ * Generation configuration for AI requests
+ */
+export interface GroqGenerationConfig {
+    /** Controls randomness (0.0 - 2.0, default: 0.7) */
+    temperature?: number;
+    /** Maximum number of tokens to generate */
+    maxTokens?: number;
+    /** Nucleus sampling threshold (0.0 - 1.0) */
+    topP?: number;
+    /** Number of completions to generate */
+    n?: number;
+    /** Stop sequences */
+    stop?: string[];
+    /** Frequency penalty (-2.0 to 2.0) */
+    frequencyPenalty?: number;
+    /** Presence penalty (-2.0 to 2.0) */
+    presencePenalty?: number;
+}
+/**
+ * Message role in chat conversation
+ */
+export type GroqMessageRole = "system" | "user" | "assistant";
+/**
+ * Chat message structure
+ */
+export interface GroqMessage {
+    /** Role of the message sender */
+    role: GroqMessageRole;
+    /** Content of the message */
+    content: string;
+}
+/**
+ * Chat completion request
+ */
+export interface GroqChatRequest {
+    /** Model to use for generation */
+    model: string;
+    /** Array of messages in the conversation */
+    messages: GroqMessage[];
+    /** Generation configuration */
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    n?: number;
+    stop?: string[];
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    /** Enable streaming response */
+    stream?: boolean;
+}
+/**
+ * Chat completion response
+ */
+export interface GroqChatResponse {
+    /** Unique identifier for the response */
+    id: string;
+    /** Object type (chat.completion) */
+    object: string;
+    /** Timestamp of creation */
+    created: number;
+    /** Model used for generation */
+    model: string;
+    /** Array of completion choices */
+    choices: GroqChoice[];
+    /** Token usage information */
+    usage: GroqUsage;
+    /** System fingerprint (Groq specific) */
+    system_fingerprint?: string;
+    /** X Groq (Groq specific) */
+    x_groq?: {
+        id?: string;
+    };
+}
+/**
+ * Individual completion choice
+ */
+export interface GroqChoice {
+    /** Index of the choice */
+    index: number;
+    /** Generated message */
+    message: {
+        role: "assistant";
+        content: string;
+    };
+    /** Reason for finish (stop, length, etc.) */
+    finish_reason: GroqFinishReason;
+    /** Logprobs (optional) */
+    logprobs: null | object;
+}
+/**
+ * Finish reason types
+ */
+export type GroqFinishReason = "stop" | "length" | "content_filter";
+/**
+ * Token usage information
+ */
+export interface GroqUsage {
+    /** Number of tokens in the prompt */
+    prompt_tokens: number;
+    /** Number of tokens in the completion */
+    completion_tokens: number;
+    /** Total number of tokens used */
+    total_tokens: number;
+    /** Prompt time (Groq specific) */
+    prompt_time?: number;
+    /** Completion time (Groq specific) */
+    completion_time?: number;
+    /** Total time (Groq specific) */
+    total_time?: number;
+}
+/**
+ * Streaming chunk response
+ */
+export interface GroqChatChunk {
+    /** Unique identifier for the response */
+    id: string;
+    /** Object type (chat.completion.chunk) */
+    object: string;
+    /** Timestamp of creation */
+    created: number;
+    /** Model used for generation */
+    model: string;
+    /** Array of completion choices */
+    choices: GroqChunkChoice[];
+    /** System fingerprint (Groq specific) */
+    system_fingerprint?: string;
+    /** X Groq (Groq specific) */
+    x_groq?: {
+        id?: string;
+    };
+}
+/**
+ * Individual chunk choice for streaming
+ */
+export interface GroqChunkChoice {
+    /** Index of the choice */
+    index: number;
+    /** Delta message (partial content) */
+    delta: {
+        role?: "assistant";
+        content?: string;
+    };
+    /** Reason for finish (null if not finished) */
+    finish_reason: GroqFinishReason | null;
+    /** Logprobs (optional) */
+    logprobs: null | object;
+}
+/**
+ * API error response
+ */
+export interface GroqErrorResponse {
+    /** Error type */
+    error: {
+        /** Error message */
+        message: string;
+        /** Error type */
+        type: string;
+        /** Error code */
+        code?: string;
+    };
+}
+/**
+ * Configuration for a chat session
+ */
+export interface GroqChatConfig {
+    /** Model name override */
+    model?: string;
+    /** System instruction for the model */
+    systemInstruction?: string;
+    /** Generation config (temperature, maxTokens, etc.) */
+    generationConfig?: GroqGenerationConfig;
+    /** Initial conversation history */
+    history?: GroqMessage[];
+}
+/**
+ * Available Groq models
+ */
+export declare const GROQ_MODELS: {
+    /** Llama 3.1 8B - Fast and efficient (560 T/s) */
+    readonly LLAMA_3_1_8B_INSTANT: "llama-3.1-8b-instant";
+    /** Llama 3.3 70B - Versatile and powerful (280 T/s) */
+    readonly LLAMA_3_3_70B_VERSATILE: "llama-3.3-70b-versatile";
+    /** Llama 3.1 70B - Versatile (280 T/s) */
+    readonly LLAMA_3_1_70B_VERSATILE: "llama-3.1-70b-versatile";
+    /** GPT-OSS 20B - Experimental (1000 T/s) */
+    readonly GPT_OSS_20B: "openai/gpt-oss-20b";
+    /** GPT-OSS 120B - Large experimental model */
+    readonly GPT_OSS_120B: "openai/gpt-oss-120b";
+    /** Mixtral 8x7b - MoE model */
+    readonly MIXTRAL_8X7B: "mixtral-8x7b-32768";
+    /** Gemma 2 9B - Google's model */
+    readonly GEMMA_2_9B: "gemma2-9b-it";
+    /** Llama 4 Scout 17B - New model (30K T/s) */
+    readonly LLAMA_4_SCOUT_17B: "meta-llama/llama-4-scout-17b-16e-instruct";
+    /** Kimi K2 - Moonshot AI model */
+    readonly KIMI_K2_INSTRUCT: "moonshotai/kimi-k2-instruct";
+    /** Qwen 3 32B - Alibaba's model */
+    readonly QWEN3_32B: "qwen/qwen3-32b";
+};
+/**
+ * Default models for different use cases
+ */
+export declare const DEFAULT_MODELS: {
+    readonly TEXT: "llama-3.1-8b-instant";
+    readonly FAST: "llama-3.1-8b-instant";
+    readonly EXPERIMENTAL: "openai/gpt-oss-20b";
+};
+//# sourceMappingURL=groq.types.d.ts.map

package/dist/domain/entities/groq.types.d.ts.map

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

package/dist/domain/entities/groq.types.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MODELS = exports.GROQ_MODELS = void 0;
+/**
+ * Available Groq models
+ */
+exports.GROQ_MODELS = {
+    /** Llama 3.1 8B - Fast and efficient (560 T/s) */
+    LLAMA_3_1_8B_INSTANT: "llama-3.1-8b-instant",
+    /** Llama 3.3 70B - Versatile and powerful (280 T/s) */
+    LLAMA_3_3_70B_VERSATILE: "llama-3.3-70b-versatile",
+    /** Llama 3.1 70B - Versatile (280 T/s) */
+    LLAMA_3_1_70B_VERSATILE: "llama-3.1-70b-versatile",
+    /** GPT-OSS 20B - Experimental (1000 T/s) */
+    GPT_OSS_20B: "openai/gpt-oss-20b",
+    /** GPT-OSS 120B - Large experimental model */
+    GPT_OSS_120B: "openai/gpt-oss-120b",
+    /** Mixtral 8x7b - MoE model */
+    MIXTRAL_8X7B: "mixtral-8x7b-32768",
+    /** Gemma 2 9B - Google's model */
+    GEMMA_2_9B: "gemma2-9b-it",
+    /** Llama 4 Scout 17B - New model (30K T/s) */
+    LLAMA_4_SCOUT_17B: "meta-llama/llama-4-scout-17b-16e-instruct",
+    /** Kimi K2 - Moonshot AI model */
+    KIMI_K2_INSTRUCT: "moonshotai/kimi-k2-instruct",
+    /** Qwen 3 32B - Alibaba's model */
+    QWEN3_32B: "qwen/qwen3-32b",
+};
+/**
+ * Default models for different use cases
+ */
+exports.DEFAULT_MODELS = {
+    TEXT: exports.GROQ_MODELS.LLAMA_3_1_8B_INSTANT,
+    FAST: exports.GROQ_MODELS.LLAMA_3_1_8B_INSTANT,
+    EXPERIMENTAL: exports.GROQ_MODELS.GPT_OSS_20B,
+};
+//# sourceMappingURL=groq.types.js.map

package/dist/domain/entities/groq.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groq.types.js","sourceRoot":"","sources":["../../../src/domain/entities/groq.types.ts"],"names":[],"mappings":";;;AAyMA;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB,kDAAkD;IAClD,oBAAoB,EAAE,sBAAsB;IAC5C,uDAAuD;IACvD,uBAAuB,EAAE,yBAAyB;IAClD,0CAA0C;IAC1C,uBAAuB,EAAE,yBAAyB;IAClD,4CAA4C;IAC5C,WAAW,EAAE,oBAAoB;IACjC,8CAA8C;IAC9C,YAAY,EAAE,qBAAqB;IACnC,+BAA+B;IAC/B,YAAY,EAAE,oBAAoB;IAClC,kCAAkC;IAClC,UAAU,EAAE,cAAc;IAC1B,8CAA8C;IAC9C,iBAAiB,EAAE,2CAA2C;IAC9D,kCAAkC;IAClC,gBAAgB,EAAE,6BAA6B;IAC/C,mCAAmC;IACnC,SAAS,EAAE,gBAAgB;CACnB,CAAC;AAEX;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,mBAAW,CAAC,oBAAoB;IACtC,IAAI,EAAE,mBAAW,CAAC,oBAAoB;IACtC,YAAY,EAAE,mBAAW,CAAC,WAAW;CAC7B,CAAC"}

package/dist/domain/entities/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Domain Entities
+ */
+export * from "./groq.types";
+export * from "./models";
+export * from "./error.types";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/domain/entities/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Domain Entities
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./groq.types"), exports);
+__exportStar(require("./models"), exports);
+__exportStar(require("./error.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/domain/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/entities/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,2CAAyB;AACzB,gDAA8B"}

package/dist/domain/entities/models.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Model Types and Configurations
+ */
+/**
+ * Model capabilities
+ */
+export interface ModelCapabilities {
+    /** Supports streaming */
+    streaming: boolean;
+    /** Supports function calling */
+    functionCalling: boolean;
+    /** Supports vision */
+    vision: boolean;
+    /** Maximum context length */
+    maxContextLength: number;
+    /** Supports system instructions */
+    systemInstructions: boolean;
+}
+/**
+ * Model information
+ */
+export interface ModelInfo {
+    /** Model ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Model capabilities */
+    capabilities: ModelCapabilities;
+    /** Recommended temperature range */
+    temperatureRange: [number, number];
+    /** Speed in tokens/second */
+    speed?: number;
+    /** Cost per 1M tokens (input) */
+    costPerInput?: number;
+    /** Cost per 1M tokens (output) */
+    costPerOutput?: number;
+}
+/**
+ * Model registry with capabilities
+ */
+export declare const MODEL_REGISTRY: Record<string, ModelInfo>;
+/**
+ * Get model information
+ */
+export declare function getModelInfo(modelId: string): ModelInfo | undefined;
+/**
+ * Check if model supports a capability
+ */
+export declare function modelSupports(modelId: string, capability: keyof ModelCapabilities): boolean;
+//# sourceMappingURL=models.d.ts.map

package/dist/domain/entities/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,sBAAsB;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,YAAY,EAAE,iBAAiB,CAAC;IAChC,oCAAoC;IACpC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAuJpD,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,GAAG,OAAO,CAG3F"}

package/dist/domain/entities/models.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Model Types and Configurations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_REGISTRY = void 0;
+exports.getModelInfo = getModelInfo;
+exports.modelSupports = modelSupports;
+const groq_types_1 = require("./groq.types");
+/**
+ * Model registry with capabilities
+ */
+exports.MODEL_REGISTRY = {
+    [groq_types_1.GROQ_MODELS.LLAMA_3_1_8B_INSTANT]: {
+        id: groq_types_1.GROQ_MODELS.LLAMA_3_1_8B_INSTANT,
+        name: "Llama 3.1 8B Instant",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 560,
+        costPerInput: 0.05,
+        costPerOutput: 0.08,
+    },
+    [groq_types_1.GROQ_MODELS.LLAMA_3_3_70B_VERSATILE]: {
+        id: groq_types_1.GROQ_MODELS.LLAMA_3_3_70B_VERSATILE,
+        name: "Llama 3.3 70B Versatile",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 280,
+        costPerInput: 0.59,
+        costPerOutput: 0.79,
+    },
+    [groq_types_1.GROQ_MODELS.LLAMA_3_1_70B_VERSATILE]: {
+        id: groq_types_1.GROQ_MODELS.LLAMA_3_1_70B_VERSATILE,
+        name: "Llama 3.1 70B Versatile",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 280,
+        costPerInput: 0.59,
+        costPerOutput: 0.79,
+    },
+    [groq_types_1.GROQ_MODELS.GPT_OSS_20B]: {
+        id: groq_types_1.GROQ_MODELS.GPT_OSS_20B,
+        name: "GPT-OSS 20B",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 1000,
+        costPerInput: 0.075,
+        costPerOutput: 0.30,
+    },
+    [groq_types_1.GROQ_MODELS.GPT_OSS_120B]: {
+        id: groq_types_1.GROQ_MODELS.GPT_OSS_120B,
+        name: "GPT-OSS 120B",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 400,
+        costPerInput: 0.40,
+        costPerOutput: 0.40,
+    },
+    [groq_types_1.GROQ_MODELS.MIXTRAL_8X7B]: {
+        id: groq_types_1.GROQ_MODELS.MIXTRAL_8X7B,
+        name: "Mixtral 8x7B",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 32768,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 250,
+        costPerInput: 0.27,
+        costPerOutput: 0.27,
+    },
+    [groq_types_1.GROQ_MODELS.GEMMA_2_9B]: {
+        id: groq_types_1.GROQ_MODELS.GEMMA_2_9B,
+        name: "Gemma 2 9B IT",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 450,
+        costPerInput: 0.20,
+        costPerOutput: 0.20,
+    },
+    [groq_types_1.GROQ_MODELS.LLAMA_4_SCOUT_17B]: {
+        id: groq_types_1.GROQ_MODELS.LLAMA_4_SCOUT_17B,
+        name: "Llama 4 Scout 17B",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 30,
+        costPerInput: 0.15,
+        costPerOutput: 0.15,
+    },
+    [groq_types_1.GROQ_MODELS.KIMI_K2_INSTRUCT]: {
+        id: groq_types_1.GROQ_MODELS.KIMI_K2_INSTRUCT,
+        name: "Kimi K2 Instruct",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 60,
+        costPerInput: 0.12,
+        costPerOutput: 0.12,
+    },
+    [groq_types_1.GROQ_MODELS.QWEN3_32B]: {
+        id: groq_types_1.GROQ_MODELS.QWEN3_32B,
+        name: "Qwen 3 32B",
+        capabilities: {
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            maxContextLength: 131072,
+            systemInstructions: true,
+        },
+        temperatureRange: [0.0, 2.0],
+        speed: 60,
+        costPerInput: 0.10,
+        costPerOutput: 0.10,
+    },
+};
+/**
+ * Get model information
+ */
+function getModelInfo(modelId) {
+    return exports.MODEL_REGISTRY[modelId];
+}
+/**
+ * Check if model supports a capability
+ */
+function modelSupports(modelId, capability) {
+    const info = getModelInfo(modelId);
+    return Boolean(info?.capabilities[capability]);
+}
+//# sourceMappingURL=models.js.map

package/dist/domain/entities/models.js.map

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