@yourgpt/llm-sdk 2.5.1-beta.2 → 2.5.1-beta.3

package/dist/adapters/index.js

@@ -487,6 +487,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
     if (baseUrl.includes("generativelanguage.googleapis.com")) return "google";
     if (baseUrl.includes("x.ai")) return "xai";
     if (baseUrl.includes("azure")) return "azure";
+    if (baseUrl.includes("fireworks.ai")) return "fireworks";
     return "openai";
   }
   async getClient() {

package/dist/adapters/index.mjs

@@ -485,6 +485,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
     if (baseUrl.includes("generativelanguage.googleapis.com")) return "google";
     if (baseUrl.includes("x.ai")) return "xai";
     if (baseUrl.includes("azure")) return "azure";
+    if (baseUrl.includes("fireworks.ai")) return "fireworks";
     return "openai";
   }
   async getClient() {

package/dist/providers/fireworks/index.d.mts

@@ -1,5 +1,7 @@
 import { L as LanguageModel } from '../../types-BkQCSiIt.mjs';
+import { A as AIProvider } from '../../types-BSSiJW2o.mjs';
 import 'zod';
+import '../../base-tNgbBaSo.mjs';
 
 /**
  * Fireworks Provider
@@ -46,4 +48,67 @@ interface FireworksProviderOptions {
  */
 declare function fireworks(modelId: string, options?: FireworksProviderOptions): LanguageModel;
 
-export { type FireworksProviderOptions, fireworks as createFireworks, fireworks };
+/**
+ * Fireworks Provider
+ *
+ * Fireworks.ai is a high-performance inference platform for open-source models
+ * (Llama, DeepSeek, Qwen, Mixtral, Gemma, and more).
+ *
+ * Uses an OpenAI-compatible API — set FIREWORKS_API_KEY in your environment.
+ *
+ * @see https://fireworks.ai/docs
+ *
+ * @example
+ * ```ts
+ * // Modern pattern — returns LanguageModel directly
+ * import { fireworks } from '@yourgpt/llm-sdk/fireworks';
+ * import { generateText } from '@yourgpt/llm-sdk';
+ *
+ * const result = await generateText({
+ *   model: fireworks('accounts/fireworks/models/llama-v3p1-70b-instruct'),
+ *   prompt: 'Hello!',
+ * });
+ *
+ * // Runtime pattern — returns AIProvider for createRuntime / fallback chain
+ * import { createFireworks } from '@yourgpt/llm-sdk/fireworks';
+ * import { createRuntime } from '@yourgpt/llm-sdk';
+ *
+ * const provider = createFireworks({ apiKey: '...' });
+ * const runtime = createRuntime({ provider, model: 'accounts/fireworks/models/deepseek-v3p1' });
+ * ```
+ */
+
+interface FireworksProviderConfig {
+    /** API key (defaults to FIREWORKS_API_KEY env var) */
+    apiKey?: string;
+    /** Base URL for API */
+    baseUrl?: string;
+}
+/**
+ * Create a Fireworks provider (callable, for use with createRuntime).
+ *
+ * Fireworks exposes an OpenAI-compatible API, so this reuses the OpenAI adapter
+ * pointed at the Fireworks base URL — the same approach used by Together AI and
+ * OpenRouter. The adapter speaks the runtime's API (generate/stream, rawMessages,
+ * message:delta/end events) and sets `stream_options.include_usage`, so streaming
+ * usage is reported correctly for credit accounting.
+ *
+ * @example
+ * ```typescript
+ * import { createFireworks } from '@yourgpt/llm-sdk/fireworks';
+ * import { createRuntime } from '@yourgpt/llm-sdk';
+ *
+ * const fireworks = createFireworks({ apiKey: '...' });
+ * const runtime = createRuntime({
+ *   provider: fireworks,
+ *   model: 'accounts/fireworks/models/deepseek-v3p1',
+ * });
+ *
+ * // Handle incoming chat requests
+ * return runtime.handleRequest(request);
+ * ```
+ */
+declare function createFireworks(config?: FireworksProviderConfig): AIProvider;
+declare const createFireworksProvider: typeof createFireworks;
+
+export { type FireworksProviderConfig, type FireworksProviderOptions, createFireworks, fireworks as createFireworksModel, createFireworksProvider, fireworks };

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

@@ -1,5 +1,7 @@
 import { L as LanguageModel } from '../../types-BkQCSiIt.js';
+import { A as AIProvider } from '../../types-BQ31QIsA.js';
 import 'zod';
+import '../../base-C58Dsr9p.js';
 
 /**
  * Fireworks Provider
@@ -46,4 +48,67 @@ interface FireworksProviderOptions {
  */
 declare function fireworks(modelId: string, options?: FireworksProviderOptions): LanguageModel;
 
-export { type FireworksProviderOptions, fireworks as createFireworks, fireworks };
+/**
+ * Fireworks Provider
+ *
+ * Fireworks.ai is a high-performance inference platform for open-source models
+ * (Llama, DeepSeek, Qwen, Mixtral, Gemma, and more).
+ *
+ * Uses an OpenAI-compatible API — set FIREWORKS_API_KEY in your environment.
+ *
+ * @see https://fireworks.ai/docs
+ *
+ * @example
+ * ```ts
+ * // Modern pattern — returns LanguageModel directly
+ * import { fireworks } from '@yourgpt/llm-sdk/fireworks';
+ * import { generateText } from '@yourgpt/llm-sdk';
+ *
+ * const result = await generateText({
+ *   model: fireworks('accounts/fireworks/models/llama-v3p1-70b-instruct'),
+ *   prompt: 'Hello!',
+ * });
+ *
+ * // Runtime pattern — returns AIProvider for createRuntime / fallback chain
+ * import { createFireworks } from '@yourgpt/llm-sdk/fireworks';
+ * import { createRuntime } from '@yourgpt/llm-sdk';
+ *
+ * const provider = createFireworks({ apiKey: '...' });
+ * const runtime = createRuntime({ provider, model: 'accounts/fireworks/models/deepseek-v3p1' });
+ * ```
+ */
+
+interface FireworksProviderConfig {
+    /** API key (defaults to FIREWORKS_API_KEY env var) */
+    apiKey?: string;
+    /** Base URL for API */
+    baseUrl?: string;
+}
+/**
+ * Create a Fireworks provider (callable, for use with createRuntime).
+ *
+ * Fireworks exposes an OpenAI-compatible API, so this reuses the OpenAI adapter
+ * pointed at the Fireworks base URL — the same approach used by Together AI and
+ * OpenRouter. The adapter speaks the runtime's API (generate/stream, rawMessages,
+ * message:delta/end events) and sets `stream_options.include_usage`, so streaming
+ * usage is reported correctly for credit accounting.
+ *
+ * @example
+ * ```typescript
+ * import { createFireworks } from '@yourgpt/llm-sdk/fireworks';
+ * import { createRuntime } from '@yourgpt/llm-sdk';
+ *
+ * const fireworks = createFireworks({ apiKey: '...' });
+ * const runtime = createRuntime({
+ *   provider: fireworks,
+ *   model: 'accounts/fireworks/models/deepseek-v3p1',
+ * });
+ *
+ * // Handle incoming chat requests
+ * return runtime.handleRequest(request);
+ * ```
+ */
+declare function createFireworks(config?: FireworksProviderConfig): AIProvider;
+declare const createFireworksProvider: typeof createFireworks;
+
+export { type FireworksProviderConfig, type FireworksProviderOptions, createFireworks, fireworks as createFireworksModel, createFireworksProvider, fireworks };