@bman654/clodex 2.14.1 → 2.15.0

package/README.md

@@ -42,6 +42,7 @@ clodex claude                  # 5. launch Claude Code on an OpenAI model
 | OpenAI | API key | Fully supported by the clodex maintainer |
 | OpenAI (ChatGPT / Codex plan) | OAuth | Fully supported by the clodex maintainer |
 | OpenCode Go | API key | Community-supported — maintained by its contributor |
+| Custom OpenAI-compatible server (OpenRouter, vLLM, …) | API key, or none | Community-supported — maintained by its contributor |
 
 **Community-supported** means the maintainer holds no account for that service,
 so it cannot be exercised against the live API here or debugged when the vendor
@@ -285,7 +286,7 @@ Two things worth knowing about the numbers:
 | Subcommand | Effect |
 | --- | --- |
 | *(none)* | Provider hub wizard |
-| `add` | Add OpenAI or OpenCode Go with an API key, or sign in with ChatGPT |
+| `add` | Add OpenAI or OpenCode Go with an API key, add a custom OpenAI-compatible server by base URL, or sign in with ChatGPT |
 | `auth openai` | Sign in with ChatGPT/Codex-plan OAuth (device code; `--browser` for workspaces that disable device codes) |
 | `list` | Show configured providers |
 | `remove <id>` | Remove a provider by id |
@@ -293,6 +294,8 @@ Two things worth knowing about the numbers:
 
 Providers supported: `openai` (API key, platform.openai.com), `openai-oauth` (ChatGPT/Codex plan), and `opencode-go` (OpenCode Go API key). OpenCode Go exposes its Anthropic Messages and Chat Completions models; Responses-only entries are intentionally excluded. See [OpenCode Go provider](docs/opencode-go.md).
 
+A **custom OpenAI-compatible server** is any OpenAI-style API, given by its base URL (the part before `/chat/completions`), such as `https://openrouter.ai/api/v1`. `providers add` asks for a name, the base URL and an API key (leave it empty for a local server without auth), lists the server's models to check the connection, and saves the provider as `custom-<name>`. Its models then appear in `clodex models`; once saved as favorites they are addressed as `clodex:custom-<name>:<model>` and can be given a short alias with `clodex models --alias`. The base URL is checked before anything is saved: plain `http://` is accepted only after you confirm it, and only for loopback or private-network addresses, and an `https://` URL whose host is, or resolves to, a loopback (`127.0.0.0/8`, `::1`), private, link-local, unique-local, carrier-grade-NAT or well-known cloud-metadata address is refused. A model's id and name are stored with surrounding whitespace trimmed, and a model whose trimmed id or name still contains a control character is skipped, whether the list is fetched by `providers add` or by `providers refresh-models`, and error text from the server is shown with control characters replaced by spaces. Only the OpenAI-compatible kind is offered in the menu.
+
 ### `clodex install-vscode-launcher`
 
 Windows only. Builds `%USERPROFILE%\.clodex\bin\clodex-claude.exe`, the executable the Claude Code VS Code extension can use as its `claudeCode.claudeProcessWrapper`, so chats in the editor launch Claude Code through `clodex-claude` (on Windows npm installs that wrapper as three script shims — extensionless, `.cmd`, `.ps1` — and no executable the extension can spawn). It compiles a short C# source shipped in the package with the compiler already inside the .NET Framework — nothing is downloaded — and prints the setting to paste; it never edits VS Code or Claude settings. The paths to `node.exe` and the clodex install are compiled in, so re-run it after switching Node versions or moving clodex. Setup guide: [docs/windows-setup.md](docs/windows-setup.md).

package/dist/{chunk-3NCDMS7N.js → chunk-5TG736TX.js}

@@ -491,6 +491,17 @@ var PROVIDER_ID_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
 function isValidProviderId(id) {
   return PROVIDER_ID_PATTERN.test(id);
 }
+function slugifyProviderId(displayName) {
+  const base = displayName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  if (!base) return "custom-provider";
+  if (isValidProviderId(base)) return base;
+  const trimmed = base.replace(/^-+|-+$/g, "");
+  return isValidProviderId(trimmed) ? trimmed : `custom-${trimmed.slice(0, 40)}`;
+}
+function customProviderId(displayName) {
+  const slug = slugifyProviderId(displayName);
+  return slug.startsWith("custom-") ? slug : `custom-${slug}`;
+}
 
 // src/registry/io.ts
 var DIR_MODE = 448;
@@ -2130,6 +2141,8 @@ export {
   storeActiveOAuthAccount,
   clearActiveOAuthAccount,
   isValidProviderId,
+  slugifyProviderId,
+  customProviderId,
   ensureSecureAppHome,
   loadRegistry,
   loadRegistryStrict,
@@ -2193,4 +2206,4 @@ export {
   planRestoreOnly,
   collectPristineFacts
 };
-//# sourceMappingURL=chunk-3NCDMS7N.js.map
+//# sourceMappingURL=chunk-5TG736TX.js.map