feat: add NeuronPool as a first-class OpenAI-compatible provider

apps/cli/src/lib/utils/context-window.ts

@@ -66,6 +66,7 @@ function getModelIdForProvider(config: ProviderSettings): string | undefined {
 		case providerIdentifiers.deepseek:
 		case providerIdentifiers.fireworks:
 		case providerIdentifiers.friendli:
+		case providerIdentifiers.neuronpool:
 		case providerIdentifiers.gemini:
 		case providerIdentifiers.geminiCli:
 		case providerIdentifiers.mistral:

packages/types/src/__tests__/provider-identifiers.test.ts

@@ -43,6 +43,7 @@ const expectedProviderIdentifiers = [
 	"baseten",
 	"fireworks",
 	"friendli",
+	"neuronpool",
 	"gemini",
 	"gemini-cli",
 	"mistral",

packages/types/src/global-settings.ts

@@ -335,6 +335,7 @@ export const SECRET_STATE_KEYS = [
 	"zaiApiKey",
 	"fireworksApiKey",
 	"friendliApiKey",
+	"neuronpoolApiKey",
 	"vercelAiGatewayApiKey",
 	"opencodeGoApiKey",
 	"kenariApiKey",

packages/types/src/provider-identifiers.ts

@@ -25,6 +25,7 @@ export const providerIdentifiers = {
 	baseten: "baseten",
 	fireworks: "fireworks",
 	friendli: "friendli",
+	neuronpool: "neuronpool",
 	gemini: "gemini",
 	geminiCli: "gemini-cli",
 	mistral: "mistral",

packages/types/src/provider-settings.ts

@@ -30,6 +30,7 @@ import {
 	deepSeekModels,
 	fireworksModels,
 	friendliModels,
+	neuronpoolModels,
 	geminiModels,
 	mistralModels,
 	moonshotModels,
@@ -430,6 +431,11 @@ export const MODELS_BY_PROVIDER: Record<
 		label: "Friendli",
 		models: Object.keys(friendliModels),
 	},
+	[providerIdentifiers.neuronpool]: {
+		id: providerIdentifiers.neuronpool,
+		label: "NeuronPool",
+		models: Object.keys(neuronpoolModels),
+	},
 	[providerIdentifiers.gemini]: {
 		id: providerIdentifiers.gemini,
 		label: "Google Gemini",

packages/types/src/provider-settings/index.ts

@@ -26,6 +26,7 @@ import { sambaNovaProviderDefinition } from "./sambanova.js"
 import { zaiProviderDefinition } from "./zai.js"
 import { fireworksProviderDefinition } from "./fireworks.js"
 import { friendliProviderDefinition } from "./friendli.js"
+import { neuronpoolProviderDefinition } from "./neuronpool.js"
 import { qwenCodeProviderDefinition } from "./qwen-code.js"
 import { vercelAiGatewayProviderDefinition } from "./vercel-ai-gateway.js"
 import { opencodeGoProviderDefinition } from "./opencode-go.js"
@@ -77,6 +78,7 @@ export const providerDefinitionList = [
 	zaiProviderDefinition,
 	fireworksProviderDefinition,
 	friendliProviderDefinition,
+	neuronpoolProviderDefinition,
 	qwenCodeProviderDefinition,
 	vercelAiGatewayProviderDefinition,
 	opencodeGoProviderDefinition,

packages/types/src/provider-settings/neuronpool.ts

@@ -0,0 +1,20 @@
+import { z } from "zod"
+
+import { providerIdentifiers } from "../provider-identifiers.js"
+import {
+	API_MODEL_ID_FIELD,
+	apiModelIdProviderModelShape,
+	createModelIdAccessor,
+	createProviderDefinition,
+} from "./common.js"
+
+export const neuronpoolProviderDefinition = createProviderDefinition({
+	apiProvider: providerIdentifiers.neuronpool,
+	modelIdKey: API_MODEL_ID_FIELD,
+	getModelId: createModelIdAccessor(API_MODEL_ID_FIELD),
+	schema: {
+		...apiModelIdProviderModelShape,
+		neuronpoolApiKey: z.string().optional(),
+		neuronpoolBaseUrl: z.string().optional(),
+	},
+})

packages/types/src/providers/index.ts

@@ -31,6 +31,7 @@ export * from "./zai.js"
 export * from "./minimax.js"
 export * from "./mimo.js"
 export * from "./zoo-gateway.js"
+export * from "./neuronpool.js"
 
 import { anthropicDefaultModelId } from "./anthropic.js"
 import { basetenDefaultModelId } from "./baseten.js"
@@ -61,6 +62,7 @@ import { internationalZAiDefaultModelId, mainlandZAiDefaultModelId } from "./zai
 import { minimaxDefaultModelId } from "./minimax.js"
 import { mimoDefaultModelId } from "./mimo.js"
 import { zooGatewayDefaultModelId } from "./zoo-gateway.js"
+import { neuronpoolDefaultModelId } from "./neuronpool.js"
 
 // Import the ProviderName type from provider-settings to avoid duplication
 import type { ProviderName } from "../provider-settings.js"
@@ -123,6 +125,8 @@ export function getProviderDefaultModelId(
 			return fireworksDefaultModelId
 		case providerIdentifiers.friendli:
 			return friendliDefaultModelId
+		case providerIdentifiers.neuronpool:
+			return neuronpoolDefaultModelId
 		case providerIdentifiers.qwenCode:
 			return qwenCodeDefaultModelId
 		case providerIdentifiers.poe:

packages/types/src/providers/neuronpool.ts

@@ -0,0 +1,80 @@
+import type { ModelInfo } from "../model.js"
+
+// NeuronPool — OpenAI-compatible social compute / public marketplace.
+// Live catalog: GET {baseURL}/models  (default https://neuronpool.damnknee.workers.dev/v1)
+export type NeuronPoolModelId =
+	| "gpt-oss-20b"
+	| "llama-3.2-1b-instruct"
+	| "llama-3.1-8b-instruct"
+	| "qwen2.5-7b-instruct"
+	| "gemma-3-12b-it"
+	| "qwen3-30b-a3b"
+	| "neuronpool-tiny-chat"
+
+export const neuronpoolDefaultModelId: NeuronPoolModelId = "gpt-oss-20b"
+
+const chatDefaults = {
+	supportsImages: false,
+	supportsPromptCache: false,
+	maxTokens: 4096,
+} as const
+
+export const neuronpoolDefaultModelInfo: ModelInfo = {
+	...chatDefaults,
+	contextWindow: 131_072,
+	inputPrice: 0.015,
+	outputPrice: 0.07,
+	description: "gpt-oss-20b via NeuronPool (OpenAI-compatible chat + tools).",
+}
+
+export const neuronpoolModels = {
+	"gpt-oss-20b": {
+		...chatDefaults,
+		contextWindow: 131_072,
+		inputPrice: 0.015,
+		outputPrice: 0.07,
+		description: "gpt-oss-20b via NeuronPool.",
+	},
+	"llama-3.2-1b-instruct": {
+		...chatDefaults,
+		contextWindow: 131_072,
+		inputPrice: 0.005,
+		outputPrice: 0.01,
+		description: "Llama 3.2 1B Instruct via NeuronPool.",
+	},
+	"llama-3.1-8b-instruct": {
+		...chatDefaults,
+		contextWindow: 131_072,
+		inputPrice: 0.02,
+		outputPrice: 0.03,
+		description: "Llama 3.1 8B Instruct via NeuronPool.",
+	},
+	"qwen2.5-7b-instruct": {
+		...chatDefaults,
+		contextWindow: 32_768,
+		inputPrice: 0.02,
+		outputPrice: 0.03,
+		description: "Qwen2.5 7B Instruct via NeuronPool.",
+	},
+	"gemma-3-12b-it": {
+		...chatDefaults,
+		contextWindow: 131_072,
+		inputPrice: 0.04,
+		outputPrice: 0.06,
+		description: "Gemma 3 12B IT via NeuronPool.",
+	},
+	"qwen3-30b-a3b": {
+		...chatDefaults,
+		contextWindow: 32_768,
+		inputPrice: 0.06,
+		outputPrice: 0.09,
+		description: "Qwen3 30B A3B via NeuronPool.",
+	},
+	"neuronpool-tiny-chat": {
+		...chatDefaults,
+		contextWindow: 4096,
+		inputPrice: 0.001,
+		outputPrice: 0.002,
+		description: "In-house tiny chat model for smoke tests.",
+	},
+} as const satisfies Record<NeuronPoolModelId, ModelInfo>

src/api/__tests__/index.spec.ts

@@ -48,6 +48,7 @@ import {
 	MistralHandler,
 	MoonshotHandler,
 	NanoGptHandler,
+	NeuronPoolHandler,
 	OpenAiCodexHandler,
 	OpenAiHandler,
 	OpenAiNativeHandler,
@@ -97,6 +98,7 @@ const expectedHandlers = {
 	[providerIdentifiers.zai]: ZAiHandler,
 	[providerIdentifiers.fireworks]: FireworksHandler,
 	[providerIdentifiers.friendli]: FriendliHandler,
+	[providerIdentifiers.neuronpool]: NeuronPoolHandler,
 	[providerIdentifiers.vercelAiGateway]: VercelAiGatewayHandler,
 	[providerIdentifiers.opencodeGo]: OpencodeGoHandler,
 	[providerIdentifiers.kenari]: KenariHandler,

src/api/index.ts

@@ -39,6 +39,7 @@ import {
 	ZAiHandler,
 	FireworksHandler,
 	FriendliHandler,
+	NeuronPoolHandler,
 	VercelAiGatewayHandler,
 	OpencodeGoHandler,
 	KenariHandler,
@@ -219,6 +220,8 @@ export function buildApiHandler(configuration: ProviderSettings): ApiHandler {
 			return new FireworksHandler(options)
 		case providerIdentifiers.friendli:
 			return new FriendliHandler(options)
+		case providerIdentifiers.neuronpool:
+			return new NeuronPoolHandler(options)
 		case providerIdentifiers.vercelAiGateway:
 			return new VercelAiGatewayHandler(options)
 		case providerIdentifiers.opencodeGo: