feat: add Keywords AI as a new LLM provider

- Add Keywords AI provider with gateway API and observability features
- Implement KeywordsAiHandler using OpenAI-compatible API
- Add Enable Logging toggle (sends disable_log: true when disabled)
- Support dynamic model fetching from Keywords AI API
- Add UI settings component with API key, base URL, and logging options
- Add i18n translations for Keywords AI settings

Closes #10962

Author: roomote

packages/types/src/provider-settings.ts

@@ -46,6 +46,7 @@ export const dynamicProviders = [
 	"litellm",
 	"deepinfra",
 	"io-intelligence",
+	"keywords-ai",
 	"requesty",
 	"unbound",
 	"roo",
@@ -399,6 +400,13 @@ const ioIntelligenceSchema = apiModelIdProviderModelSchema.extend({
 	ioIntelligenceApiKey: z.string().optional(),
 })
 
+const keywordsAiSchema = baseProviderSettingsSchema.extend({
+	keywordsAiApiKey: z.string().optional(),
+	keywordsAiBaseUrl: z.string().optional(),
+	keywordsAiModelId: z.string().optional(),
+	keywordsAiEnableLogging: z.boolean().optional(),
+})
+
 const qwenCodeSchema = apiModelIdProviderModelSchema.extend({
 	qwenCodeOauthPath: z.string().optional(),
 })
@@ -455,6 +463,7 @@ export const providerSettingsSchemaDiscriminated = z.discriminatedUnion("apiProv
 	fireworksSchema.merge(z.object({ apiProvider: z.literal("fireworks") })),
 	featherlessSchema.merge(z.object({ apiProvider: z.literal("featherless") })),
 	ioIntelligenceSchema.merge(z.object({ apiProvider: z.literal("io-intelligence") })),
+	keywordsAiSchema.merge(z.object({ apiProvider: z.literal("keywords-ai") })),
 	qwenCodeSchema.merge(z.object({ apiProvider: z.literal("qwen-code") })),
 	rooSchema.merge(z.object({ apiProvider: z.literal("roo") })),
 	vercelAiGatewaySchema.merge(z.object({ apiProvider: z.literal("vercel-ai-gateway") })),
@@ -496,6 +505,7 @@ export const providerSettingsSchema = z.object({
 	...fireworksSchema.shape,
 	...featherlessSchema.shape,
 	...ioIntelligenceSchema.shape,
+	...keywordsAiSchema.shape,
 	...qwenCodeSchema.shape,
 	...rooSchema.shape,
 	...vercelAiGatewaySchema.shape,
@@ -530,6 +540,7 @@ export const modelIdKeys = [
 	"litellmModelId",
 	"huggingFaceModelId",
 	"ioIntelligenceModelId",
+	"keywordsAiModelId",
 	"vercelAiGatewayModelId",
 	"deepInfraModelId",
 ] as const satisfies readonly (keyof ProviderSettings)[]
@@ -582,6 +593,7 @@ export const modelIdKeysByProvider: Record<TypicalProvider, ModelIdKey> = {
 	fireworks: "apiModelId",
 	featherless: "apiModelId",
 	"io-intelligence": "ioIntelligenceModelId",
+	"keywords-ai": "keywordsAiModelId",
 	roo: "apiModelId",
 	"vercel-ai-gateway": "vercelAiGatewayModelId",
 }
@@ -716,6 +728,7 @@ export const MODELS_BY_PROVIDER: Record<
 	litellm: { id: "litellm", label: "LiteLLM", models: [] },
 	openrouter: { id: "openrouter", label: "OpenRouter", models: [] },
 	requesty: { id: "requesty", label: "Requesty", models: [] },
+	"keywords-ai": { id: "keywords-ai", label: "Keywords AI", models: [] },
 	unbound: { id: "unbound", label: "Unbound", models: [] },
 	deepinfra: { id: "deepinfra", label: "DeepInfra", models: [] },
 	"vercel-ai-gateway": { id: "vercel-ai-gateway", label: "Vercel AI Gateway", models: [] },

packages/types/src/providers/index.ts

@@ -11,6 +11,7 @@ export * from "./gemini.js"
 export * from "./groq.js"
 export * from "./huggingface.js"
 export * from "./io-intelligence.js"
+export * from "./keywords-ai.js"
 export * from "./lite-llm.js"
 export * from "./lm-studio.js"
 export * from "./mistral.js"
@@ -45,6 +46,7 @@ import { fireworksDefaultModelId } from "./fireworks.js"
 import { geminiDefaultModelId } from "./gemini.js"
 import { groqDefaultModelId } from "./groq.js"
 import { ioIntelligenceDefaultModelId } from "./io-intelligence.js"
+import { keywordsAiDefaultModelId } from "./keywords-ai.js"
 import { litellmDefaultModelId } from "./lite-llm.js"
 import { mistralDefaultModelId } from "./mistral.js"
 import { moonshotDefaultModelId } from "./moonshot.js"
@@ -136,6 +138,8 @@ export function getProviderDefaultModelId(
 			return featherlessDefaultModelId
 		case "io-intelligence":
 			return ioIntelligenceDefaultModelId
+		case "keywords-ai":
+			return keywordsAiDefaultModelId
 		case "roo":
 			return rooDefaultModelId
 		case "qwen-code":

packages/types/src/providers/keywords-ai.ts

@@ -0,0 +1,16 @@
+import type { ModelInfo } from "../model.js"
+
+// Keywords AI
+// https://keywordsai.co
+export const keywordsAiDefaultModelId = "gpt-4o"
+
+export const keywordsAiDefaultModelInfo: ModelInfo = {
+	maxTokens: 16384,
+	contextWindow: 128_000,
+	supportsImages: true,
+	supportsPromptCache: false,
+	inputPrice: 2.5,
+	outputPrice: 10.0,
+	description:
+		"GPT-4o is OpenAI's most advanced multimodal model that's faster and cheaper than GPT-4 Turbo with stronger vision capabilities.",
+}

src/api/index.ts

@@ -32,6 +32,7 @@ import {
 	QwenCodeHandler,
 	SambaNovaHandler,
 	IOIntelligenceHandler,
+	KeywordsAiHandler,
 	DoubaoHandler,
 	ZAiHandler,
 	FireworksHandler,
@@ -185,6 +186,8 @@ export function buildApiHandler(configuration: ProviderSettings): ApiHandler {
 			return new FireworksHandler(options)
 		case "io-intelligence":
 			return new IOIntelligenceHandler(options)
+		case "keywords-ai":
+			return new KeywordsAiHandler(options)
 		case "roo":
 			// Never throw exceptions from provider constructors
 			// The provider-proxy server will handle authentication and return appropriate error codes

src/api/providers/fetchers/keywords-ai.ts

@@ -0,0 +1,59 @@
+import axios from "axios"
+
+import type { ModelInfo } from "@roo-code/types"
+
+import { parseApiPrice } from "../../../shared/cost"
+
+const KEYWORDS_AI_DEFAULT_BASE_URL = "https://api.keywordsai.co/api"
+
+export async function getKeywordsAiModels(apiKey?: string, baseUrl?: string): Promise<Record<string, ModelInfo>> {
+	const models: Record<string, ModelInfo> = {}
+
+	try {
+		const headers: Record<string, string> = {}
+
+		if (apiKey) {
+			headers["Authorization"] = `Bearer ${apiKey}`
+		}
+
+		const resolvedBaseUrl = baseUrl || KEYWORDS_AI_DEFAULT_BASE_URL
+		const modelsUrl = new URL("v1/models", resolvedBaseUrl)
+
+		const response = await axios.get(modelsUrl.toString(), { headers })
+		const rawModels = response.data.data
+
+		for (const rawModel of rawModels) {
+			// Determine reasoning capabilities based on model ID
+			const reasoningBudget =
+				rawModel.supports_reasoning && (rawModel.id.includes("claude") || rawModel.id.includes("gemini-2.5"))
+			const reasoningEffort =
+				rawModel.supports_reasoning &&
+				(rawModel.id.includes("openai") ||
+					rawModel.id.includes("gpt") ||
+					rawModel.id.includes("o1") ||
+					rawModel.id.includes("o3"))
+
+			const modelInfo: ModelInfo = {
+				maxTokens: rawModel.max_output_tokens || rawModel.max_tokens,
+				contextWindow: rawModel.context_window || rawModel.context_length,
+				supportsPromptCache: rawModel.supports_caching || false,
+				supportsImages: rawModel.supports_vision || false,
+				supportsReasoningBudget: reasoningBudget,
+				supportsReasoningEffort: reasoningEffort,
+				inputPrice: parseApiPrice(rawModel.input_price || rawModel.input_cost),
+				outputPrice: parseApiPrice(rawModel.output_price || rawModel.output_cost),
+				description: rawModel.description,
+				cacheWritesPrice: parseApiPrice(rawModel.caching_price || rawModel.cache_write_price),
+				cacheReadsPrice: parseApiPrice(rawModel.cached_price || rawModel.cache_read_price),
+			}
+
+			models[rawModel.id] = modelInfo
+		}
+	} catch (error) {
+		console.error(
+			`Error fetching Keywords AI models: ${JSON.stringify(error, Object.getOwnPropertyNames(error), 2)}`,
+		)
+	}
+
+	return models
+}

src/api/providers/fetchers/modelCache.ts

@@ -25,6 +25,7 @@ import { GetModelsOptions } from "../../../shared/api"
 import { getOllamaModels } from "./ollama"
 import { getLMStudioModels } from "./lmstudio"
 import { getIOIntelligenceModels } from "./io-intelligence"
+import { getKeywordsAiModels } from "./keywords-ai"
 import { getDeepInfraModels } from "./deepinfra"
 import { getHuggingFaceModels } from "./huggingface"
 import { getRooModels } from "./roo"
@@ -93,6 +94,9 @@ async function fetchModelsFromProvider(options: GetModelsOptions): Promise<Model
 		case "io-intelligence":
 			models = await getIOIntelligenceModels(options.apiKey)
 			break
+		case "keywords-ai":
+			models = await getKeywordsAiModels(options.apiKey, options.baseUrl)
+			break
 		case "vercel-ai-gateway":
 			models = await getVercelAiGatewayModels()
 			break

src/api/providers/index.ts

@@ -11,6 +11,7 @@ export { GeminiHandler } from "./gemini"
 export { GroqHandler } from "./groq"
 export { HuggingFaceHandler } from "./huggingface"
 export { IOIntelligenceHandler } from "./io-intelligence"
+export { KeywordsAiHandler } from "./keywords-ai"
 export { LiteLLMHandler } from "./lite-llm"
 export { LmStudioHandler } from "./lm-studio"
 export { MistralHandler } from "./mistral"