From ddc4c827a70e020c675e23beb489ca1b1197e508 Mon Sep 17 00:00:00 2001
From: diegosouzapw <diegosouzapw@users.noreply.github.com>
Date: Sat, 1 Aug 2026 23:13:08 -0300
Subject: [PATCH] feat(providers): add LLMGateway and LLM Kiwi registries

---
 .../providers/registry/llm-kiwi/index.ts      | 14 ++++++++
 .../providers/registry/llmgateway/index.ts    | 11 ++++++
 .../unit/free-tier-providers-wave1-c.test.ts  | 34 +++++++++++++++++++
 3 files changed, 59 insertions(+)
 create mode 100644 open-sse/config/providers/registry/llm-kiwi/index.ts
 create mode 100644 open-sse/config/providers/registry/llmgateway/index.ts
 create mode 100644 tests/unit/free-tier-providers-wave1-c.test.ts

diff --git a/open-sse/config/providers/registry/llm-kiwi/index.ts b/open-sse/config/providers/registry/llm-kiwi/index.ts
new file mode 100644
index 0000000000..d929afec29
--- /dev/null
+++ b/open-sse/config/providers/registry/llm-kiwi/index.ts
@@ -0,0 +1,14 @@
+import type { RegistryEntry } from "../../shared.ts";
+import { buildOpenAiCompatibleRegistryEntry } from "../../shared.ts";
+
+export const llmKiwiProvider: RegistryEntry = buildOpenAiCompatibleRegistryEntry({
+  id: "llm-kiwi",
+  alias: "llmkiwi",
+  baseUrl: "https://api.llm.kiwi/v1/chat/completions",
+  modelsUrl: "https://api.llm.kiwi/v1/models",
+  models: [
+    { id: "auto", name: "Auto" },
+    { id: "hrLLM", name: "hrLLM" },
+  ],
+  passthroughModels: true,
+});
diff --git a/open-sse/config/providers/registry/llmgateway/index.ts b/open-sse/config/providers/registry/llmgateway/index.ts
new file mode 100644
index 0000000000..972a3a8930
--- /dev/null
+++ b/open-sse/config/providers/registry/llmgateway/index.ts
@@ -0,0 +1,11 @@
+import type { RegistryEntry } from "../../shared.ts";
+import { buildOpenAiCompatibleRegistryEntry } from "../../shared.ts";
+
+export const llmgatewayProvider: RegistryEntry = buildOpenAiCompatibleRegistryEntry({
+  id: "llmgateway",
+  alias: "llmgateway",
+  baseUrl: "https://api.llmgateway.io/v1/chat/completions",
+  modelsUrl: "https://api.llmgateway.io/v1/models",
+  models: [],
+  passthroughModels: true,
+});
diff --git a/tests/unit/free-tier-providers-wave1-c.test.ts b/tests/unit/free-tier-providers-wave1-c.test.ts
new file mode 100644
index 0000000000..cd05c6caea
--- /dev/null
+++ b/tests/unit/free-tier-providers-wave1-c.test.ts
@@ -0,0 +1,34 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { llmKiwiProvider } from "../../open-sse/config/providers/registry/llm-kiwi/index.ts";
+import { llmgatewayProvider } from "../../open-sse/config/providers/registry/llmgateway/index.ts";
+
+test("llmgateway uses a dynamic OpenAI-compatible Bearer API", () => {
+  assert.equal(llmgatewayProvider.id, "llmgateway");
+  assert.equal(llmgatewayProvider.alias, "llmgateway");
+  assert.equal(llmgatewayProvider.format, "openai");
+  assert.equal(llmgatewayProvider.executor, "default");
+  assert.equal(llmgatewayProvider.authType, "apikey");
+  assert.equal(llmgatewayProvider.authHeader, "bearer");
+  assert.equal(llmgatewayProvider.baseUrl, "https://api.llmgateway.io/v1/chat/completions");
+  assert.equal(llmgatewayProvider.modelsUrl, "https://api.llmgateway.io/v1/models");
+  assert.equal(llmgatewayProvider.passthroughModels, true);
+  assert.deepEqual(llmgatewayProvider.models, []);
+});
+
+test("llm-kiwi seeds only its confirmed free models while retaining live discovery", () => {
+  assert.equal(llmKiwiProvider.id, "llm-kiwi");
+  assert.equal(llmKiwiProvider.alias, "llmkiwi");
+  assert.equal(llmKiwiProvider.format, "openai");
+  assert.equal(llmKiwiProvider.executor, "default");
+  assert.equal(llmKiwiProvider.authType, "apikey");
+  assert.equal(llmKiwiProvider.authHeader, "bearer");
+  assert.equal(llmKiwiProvider.baseUrl, "https://api.llm.kiwi/v1/chat/completions");
+  assert.equal(llmKiwiProvider.modelsUrl, "https://api.llm.kiwi/v1/models");
+  assert.equal(llmKiwiProvider.passthroughModels, true);
+  assert.deepEqual(llmKiwiProvider.models, [
+    { id: "auto", name: "Auto" },
+    { id: "hrLLM", name: "hrLLM" },
+  ]);
+});