@heventure/model-provider-x 0.1.0 → 0.1.1

package/dist/cli/args.js

@@ -32,6 +32,9 @@ export function parseCliArgs(argv) {
             case "--name":
                 options.providerName = next();
                 break;
+            case "--provider":
+                options.providerPreset = next();
+                break;
             case "--print":
                 options.print = true;
                 break;
@@ -89,6 +92,7 @@ Options:
   --api-key <key>      Optional API key. Written into config when provided.
   --name <name>        Provider display name.
   --id <id>            Provider id used under provider.<id>.
+  --provider <id>      Use a built-in provider preset, for example lmstudio or openai.
   --models <list>      Comma-separated model ids. Skips interactive model selection.
   --config <path>      OpenCode config path to write.
   --print              Print generated JSON and do not write config.

package/dist/cli/index.js

@@ -8,6 +8,8 @@ import { startProxyServer } from "../proxy/server.js";
 import { getDefaultClaudeSettingsPath, writeClaudeCodeSettings } from "../targets/claude-code.js";
 import { HelpRequested, parseModelSelection } from "./args.js";
 import { commandUsage, parseCommand } from "./commands.js";
+import { createModelChoices } from "./model-choices.js";
+import { createProviderChoices, getProviderPreset } from "./provider-presets.js";
 import { canUseTui, multiSelectChoices, renderIntro, selectChoice } from "./tui.js";
 async function main() {
     try {
@@ -62,15 +64,16 @@ export async function runCli(options) {
     const rl = createInterface({ input, output });
     try {
         output.write(canUseTui() ? renderIntro() : "model-provider-x\n\n");
-        const providerName = await requiredOption(rl, options.providerName, "Provider name");
-        const providerId = await requiredOption(rl, options.providerId ?? slugify(providerName), "Provider id");
-        const baseURL = await requiredOption(rl, options.baseURL, "API base URL");
-        const apiKey = options.apiKey ?? (await rl.question("API key (optional): "));
+        const providerDefaults = await resolveProviderDefaults(rl, options);
+        const providerName = await requiredOption(rl, options.providerName ?? providerDefaults.name, "Provider name");
+        const providerId = await requiredOption(rl, options.providerId ?? providerDefaults.id ?? slugify(providerName), "Provider id");
+        const baseURL = await requiredOption(rl, options.baseURL ?? providerDefaults.baseURL, "API base URL");
+        const apiKey = await resolveApiKey(rl, options.apiKey, providerDefaults.preset);
         output.write("Fetching models...\n");
         const fetched = await validateAndFetchModels({ baseURL, apiKey });
         const selectedModels = options.models ??
             (canUseTui()
-                ? await multiSelectChoices("Select models", fetched.models.map((model) => ({ label: model, value: model })))
+                ? await multiSelectChoices("Select models", createModelChoices(fetched.models))
                 : parseModelSelection(await rl.question(formatModelPrompt(fetched.models)), fetched.models));
         const fragment = buildProviderConfig({
             providerId,
@@ -114,15 +117,16 @@ async function runClaudeCodeSetup(command) {
     const rl = createInterface({ input, output });
     try {
         output.write(canUseTui() ? renderIntro() : "model-provider-x\n\n");
-        const providerName = await requiredOption(rl, command.options.providerName, "Provider name");
-        const providerId = await requiredOption(rl, command.profileId ?? command.options.providerId ?? slugify(providerName), "Provider id");
-        const baseURL = await requiredOption(rl, command.options.baseURL, "API base URL");
-        const apiKey = command.options.apiKey ?? (await rl.question("Upstream API key (optional): "));
+        const providerDefaults = await resolveProviderDefaults(rl, command.options);
+        const providerName = await requiredOption(rl, command.options.providerName ?? providerDefaults.name, "Provider name");
+        const providerId = await requiredOption(rl, command.profileId ?? command.options.providerId ?? providerDefaults.id ?? slugify(providerName), "Provider id");
+        const baseURL = await requiredOption(rl, command.options.baseURL ?? providerDefaults.baseURL, "API base URL");
+        const apiKey = await resolveApiKey(rl, command.options.apiKey, providerDefaults.preset, "Upstream API key");
         output.write("Fetching models...\n");
         const fetched = await validateAndFetchModels({ baseURL, apiKey });
         const selectedModels = command.options.models ??
             (canUseTui()
-                ? await multiSelectChoices("Select Claude Code gateway models", fetched.models.map((model) => ({ label: model, value: model })))
+                ? await multiSelectChoices("Select Claude Code gateway models", createModelChoices(fetched.models))
                 : parseModelSelection(await rl.question(formatModelPrompt(fetched.models)), fetched.models));
         const toolConfigPath = getDefaultToolConfigPath();
         const config = await upsertProviderProfile(toolConfigPath, {
@@ -163,6 +167,32 @@ async function requiredOption(rl, value, label) {
     }
     return answer.trim();
 }
+async function resolveProviderDefaults(rl, options) {
+    if (options.baseURL) {
+        return {};
+    }
+    const presetId = options.providerPreset ?? (canUseTui() ? await selectChoice("Choose provider", createProviderChoices()) : undefined);
+    if (!presetId || presetId === "custom") {
+        return {};
+    }
+    const preset = getProviderPreset(presetId);
+    if (!preset) {
+        throw new Error(`Unknown provider preset: ${presetId}`);
+    }
+    return {
+        id: preset.id,
+        name: preset.name,
+        baseURL: preset.baseURL,
+        preset
+    };
+}
+async function resolveApiKey(rl, apiKey, preset, label = "API key") {
+    if (apiKey !== undefined) {
+        return apiKey;
+    }
+    const suffix = preset?.apiKeyRequired ? "" : " (optional)";
+    return rl.question(`${label}${suffix}: `);
+}
 async function chooseConfigPath(rl, providerId, yes) {
     const configs = await discoverOpenCodeConfigs({ providerId });
     if (configs.length === 0) {

package/dist/cli/model-choices.js

@@ -0,0 +1,17 @@
+const likelyUnsupportedModelName = /\b(?:embed|embedding|embeddings|bge|e5|nomic-embed)\b/i;
+export function createModelChoices(models) {
+    return models.map((model) => {
+        if (!isLikelyUnsupportedModelName(model)) {
+            return { label: model, value: model, selected: true };
+        }
+        return {
+            label: model,
+            value: model,
+            hint: "suspected unsupported model",
+            selected: false
+        };
+    });
+}
+export function isLikelyUnsupportedModelName(model) {
+    return likelyUnsupportedModelName.test(model);
+}

package/dist/cli/provider-presets.js

@@ -0,0 +1,24 @@
+const providerPresets = [
+    { id: "unsloth", name: "Unsloth Local", baseURL: "http://localhost:8888/v1", apiKeyRequired: false },
+    { id: "lmstudio", name: "LM Studio", baseURL: "http://localhost:1234/v1", apiKeyRequired: false },
+    { id: "ollama", name: "Ollama", baseURL: "http://localhost:11434/v1", apiKeyRequired: false },
+    { id: "vllm", name: "vLLM", baseURL: "http://localhost:8000/v1", apiKeyRequired: false },
+    { id: "openai", name: "OpenAI", baseURL: "https://api.openai.com/v1", apiKeyRequired: true },
+    { id: "openrouter", name: "OpenRouter", baseURL: "https://openrouter.ai/api/v1", apiKeyRequired: true }
+];
+export function getProviderPresets() {
+    return [...providerPresets];
+}
+export function getProviderPreset(id) {
+    return providerPresets.find((preset) => preset.id === id);
+}
+export function createProviderChoices() {
+    return [
+        ...providerPresets.map((preset) => ({
+            label: preset.name,
+            value: preset.id,
+            hint: preset.baseURL
+        })),
+        { label: "Custom provider", value: "custom", hint: "enter URL and API key manually" }
+    ];
+}

package/dist/cli/tui.js

@@ -45,7 +45,9 @@ export async function selectChoice(title, choices, streams = { input: process.st
     return selected.value;
 }
 export async function multiSelectChoices(title, choices, streams = { input: process.stdin, output: process.stdout }) {
-    let selected = new Set(choices.map((choice, index) => (choice.disabled ? -1 : index)).filter((index) => index >= 0));
+    let selected = new Set(choices
+        .map((choice, index) => (choice.disabled || choice.selected === false ? -1 : index))
+        .filter((index) => index >= 0));
     const choice = await runKeyMenu((cursor) => renderMultiSelect(title, choices, cursor, selected), choices, streams, (key, cursor) => {
         if (key.name === "space") {
             selected = toggleSelectedIndex(selected, cursor);

package/dist/core/provider.js

@@ -26,9 +26,14 @@ export async function validateAndFetchModels(input, fetchImpl = globalThis.fetch
     if (!isModelListResponse(body)) {
         throw new Error("Expected /models to return an object with a data array");
     }
-    const models = [...new Set(body.data.map((model) => model.id.trim()).filter(Boolean))];
+    const models = [
+        ...new Set(body.data
+            .filter(isOpenCodeCompatibleModel)
+            .map((model) => model.id.trim())
+            .filter(Boolean))
+    ];
     if (models.length === 0) {
-        throw new Error("Provider returned no model ids");
+        throw new Error("Provider returned no OpenCode-compatible model ids");
     }
     return { baseURL, models };
 }
@@ -59,3 +64,9 @@ function isModelListResponse(body) {
         Array.isArray(body.data) &&
         body.data.every((model) => typeof model === "object" && model !== null && typeof model.id === "string"));
 }
+function isOpenCodeCompatibleModel(model) {
+    if (typeof model.type !== "string") {
+        return true;
+    }
+    return ["llm", "chat", "completion", "text-generation"].includes(model.type.trim().toLowerCase());
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heventure/model-provider-x",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TUI configurator and local API proxy for wiring custom model providers into OpenCode and Claude Code.",
   "private": false,
   "license": "MIT",