@agentforge-io/llm-langchain 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { OpenAIProvider, type OpenAIProviderOptions, } from './providers/openai-provider';
 export { GeminiProvider, type GeminiProviderOptions, } from './providers/gemini-provider';
+export { GroqProvider, type GroqProviderOptions, } from './providers/groq-provider';

package/dist/index.js

@@ -16,8 +16,10 @@
 // The host wires which provider runs per tenant; this package only ships
 // the adapters, not the resolution logic.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GeminiProvider = exports.OpenAIProvider = void 0;
+exports.GroqProvider = exports.GeminiProvider = exports.OpenAIProvider = void 0;
 var openai_provider_1 = require("./providers/openai-provider");
 Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_provider_1.OpenAIProvider; } });
 var gemini_provider_1 = require("./providers/gemini-provider");
 Object.defineProperty(exports, "GeminiProvider", { enumerable: true, get: function () { return gemini_provider_1.GeminiProvider; } });
+var groq_provider_1 = require("./providers/groq-provider");
+Object.defineProperty(exports, "GroqProvider", { enumerable: true, get: function () { return groq_provider_1.GroqProvider; } });

package/dist/providers/groq-provider.d.ts

@@ -0,0 +1,15 @@
+import { OpenAIProvider, type OpenAIProviderOptions } from './openai-provider';
+export interface GroqProviderOptions extends Omit<OpenAIProviderOptions, 'baseURL' | 'organization'> {
+    /** Override the default base URL. Only useful for a proxy/test setup;
+     *  production points at https://api.groq.com/openai/v1. */
+    baseURL?: string;
+}
+/**
+ * Groq inference provider. Same wire format as OpenAI Chat Completions,
+ * just at a different endpoint. The class extends OpenAIProvider so we
+ * inherit the entire stream-event translation pipeline — only the
+ * default base URL changes.
+ */
+export declare class GroqProvider extends OpenAIProvider {
+    constructor(opts: GroqProviderOptions);
+}

package/dist/providers/groq-provider.js

@@ -0,0 +1,44 @@
+"use strict";
+// ─── Groq provider ──────────────────────────────────────────────────────────
+//
+// Groq runs OpenAI-compatible inference on their own LPU hardware — same
+// wire format as OpenAI's `/v1/chat/completions`, just at
+// `https://api.groq.com/openai/v1`. So this whole provider is the OpenAI
+// adapter with the base URL pinned + a different id/displayName for
+// telemetry attribution.
+//
+// Worth a separate class (not just an env override on OpenAIProvider)
+// because:
+//   - Groq's free tier is the killer feature; the platform wants to
+//     attribute spend / quota separately in the dashboard
+//   - The model catalog is DIFFERENT (Llama 3, Mixtral, Gemma, etc.) —
+//     hardcoding them in the platform registration would lie about
+//     which provider answered the turn
+//   - Capability flags can diverge: some Groq-hosted models don't
+//     expose tool calling even though OpenAI's catalog does
+//
+// Don't confuse with Grok (xAI). They sound alike but:
+//   - Grok = xAI's own model family ("grok-2", "grok-2-mini"), served
+//     at api.x.ai. Uses GrokProvider in the platform.
+//   - Groq = inference service serving open-weight models. Uses THIS
+//     provider in the platform.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroqProvider = void 0;
+const openai_provider_1 = require("./openai-provider");
+/**
+ * Groq inference provider. Same wire format as OpenAI Chat Completions,
+ * just at a different endpoint. The class extends OpenAIProvider so we
+ * inherit the entire stream-event translation pipeline — only the
+ * default base URL changes.
+ */
+class GroqProvider extends openai_provider_1.OpenAIProvider {
+    constructor(opts) {
+        super({
+            apiKey: opts.apiKey,
+            baseURL: opts.baseURL ?? 'https://api.groq.com/openai/v1',
+            id: opts.id ?? 'groq',
+            displayName: opts.displayName ?? 'Groq',
+        });
+    }
+}
+exports.GroqProvider = GroqProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/llm-langchain",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "LangChain-backed LLM providers (OpenAI, Grok, Gemini) implementing the framework-free `LLMProvider` contract from @agentforge-io/core. Drop-in replacements for AnthropicProvider — same stream events, same tool schema, no changes to the agent runner.",
   "license": "MIT",
   "main": "dist/index.js",