scalemax 0.1.24 → 0.1.25

package/README.md

@@ -148,7 +148,7 @@ ScaleMax configures the official Codex custom-provider interface in `~/.codex/co
 
 ### Claude Code
 
-ScaleMax updates `~/.claude/settings.json` with `ANTHROPIC_BASE_URL=https://api.scalemax.pro`, gateway model discovery, and a cached `apiKeyHelper` that reads a private `~/.claude/scalemax.key` file. The raw key is not stored in the settings JSON. The Anthropic base URL intentionally has no `/v1` suffix because Claude Code adds `/v1/messages` itself. The CLI preserves unrelated settings, selects a live main model from the authenticated catalog (preferring `claude-opus-4-8`), pins authenticated Haiku for lightweight background work when available, and sets `CLAUDE_CODE_DISABLE_THINKING=1` because third-party Anthropic-compatible providers do not support Claude Code's proprietary extended-thinking control envelope. It verifies a one-token Messages request and, if verification fails, removes only the ScaleMax-managed changes. Claude Code picker aliases such as `claude-opus-4-8[1m]` are normalized by the gateway.
+ScaleMax updates `~/.claude/settings.json` with `ANTHROPIC_BASE_URL=https://api.scalemax.pro`, gateway model discovery, and a cached `apiKeyHelper` that reads a private `~/.claude/scalemax.key` file. The raw key is not stored in the settings JSON. Because Claude Code's gateway discovery only accepts IDs beginning with `claude` or `anthropic`, a catalog that includes Fable also receives a managed `ANTHROPIC_CUSTOM_MODEL_OPTION=fable-5` entry (with a friendly name and description), making `/model fable-5` selectable; any prior custom picker values are restored when ScaleMax configuration is removed. The Anthropic base URL intentionally has no `/v1` suffix because Claude Code adds `/v1/messages` itself. The CLI preserves unrelated settings, selects a live main model from the authenticated catalog (preferring `claude-opus-4-8`), pins authenticated Haiku for lightweight background work when available, and sets `CLAUDE_CODE_DISABLE_THINKING=1` because third-party Anthropic-compatible providers do not support Claude Code's proprietary extended-thinking control envelope. It verifies a one-token Messages request and, if verification fails, removes only the ScaleMax-managed changes. Claude Code picker aliases such as `claude-opus-4-8[1m]` are normalized by the gateway.
 
 ### OpenCode
 

package/dist/configure/claude.js

@@ -14,7 +14,29 @@ const discoveryKey = 'CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY';
 const fastModelKey = 'ANTHROPIC_DEFAULT_HAIKU_MODEL';
 const helperTtlKey = 'CLAUDE_CODE_API_KEY_HELPER_TTL_MS';
 const disableThinkingKey = 'CLAUDE_CODE_DISABLE_THINKING';
-const managedEnvKeys = ['ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_API_KEY', 'ANTHROPIC_BASE_URL', 'ANTHROPIC_MODEL', discoveryKey, fastModelKey, helperTtlKey, disableThinkingKey];
+// Claude Code's gateway discovery intentionally ignores model IDs that do not
+// start with `claude` or `anthropic`. Fable's public ScaleMax ID is
+// deliberately `fable-5`, so keep it selectable with the supported custom
+// picker entry as well as the normal discovery feed.
+const customModelOptionKey = 'ANTHROPIC_CUSTOM_MODEL_OPTION';
+const customModelOptionNameKey = 'ANTHROPIC_CUSTOM_MODEL_OPTION_NAME';
+const customModelOptionDescriptionKey = 'ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION';
+const fableModelId = 'fable-5';
+const fableModelName = 'Fable 5';
+const fableModelDescription = 'Fable 5 via ScaleMax';
+const managedEnvKeys = [
+    'ANTHROPIC_AUTH_TOKEN',
+    'ANTHROPIC_API_KEY',
+    'ANTHROPIC_BASE_URL',
+    'ANTHROPIC_MODEL',
+    customModelOptionKey,
+    customModelOptionNameKey,
+    customModelOptionDescriptionKey,
+    discoveryKey,
+    fastModelKey,
+    helperTtlKey,
+    disableThinkingKey
+];
 function secretPath(home) { return path.join(home, '.claude', 'scalemax.key'); }
 function helperCommand(home, platform) {
     const file = secretPath(home);
@@ -25,10 +47,17 @@ function helperCommand(home, platform) {
 function asRecord(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
 }
+function hasFableModel(ctx) {
+    return (ctx.models || []).some(model => {
+        const id = String(model.id || '').trim().toLowerCase();
+        return id === fableModelId || id === 'claude-fable-5';
+    });
+}
 export async function configure(ctx) {
     const file = clientConfigPath(id, ctx.home, ctx.platform);
     const model = preferredModel(ctx);
     const quick = fastModel(ctx);
+    const fable = hasFableModel(ctx);
     const baseUrl = anthropicOrigin(ctx.baseUrl);
     const apiKeyHelper = helperCommand(ctx.home, ctx.platform);
     const secret = await writeClientSecret(secretPath(ctx.home), ctx);
@@ -51,6 +80,25 @@ export async function configure(ctx) {
                 [helperTtlKey]: '900000',
                 [disableThinkingKey]: '1'
             };
+            if (fable) {
+                // This is a public model ID, not an upstream/provider alias. Claude
+                // Code's custom option bypasses its `claude*` discovery filter while
+                // still sending exactly `fable-5` to the configured gateway.
+                nextEnv[customModelOptionKey] = fableModelId;
+                nextEnv[customModelOptionNameKey] = fableModelName;
+                nextEnv[customModelOptionDescriptionKey] = fableModelDescription;
+            }
+            else if (oldMetadata.managedBy === 'ScaleMax CLI') {
+                // A key can be reconfigured from a Fable-enabled catalog to one that
+                // does not include Fable. Remove only the values this CLI previously
+                // managed, restoring any user values captured on the first configure.
+                for (const key of [customModelOptionKey, customModelOptionNameKey, customModelOptionDescriptionKey]) {
+                    if (Object.prototype.hasOwnProperty.call(previousEnv, key))
+                        nextEnv[key] = previousEnv[key];
+                    else if (nextEnv[key] === fableModelId || nextEnv[key] === fableModelName || nextEnv[key] === fableModelDescription)
+                        delete nextEnv[key];
+                }
+            }
             delete nextEnv.ANTHROPIC_AUTH_TOKEN;
             delete nextEnv.ANTHROPIC_API_KEY;
             if (quick)
@@ -70,6 +118,9 @@ export async function configure(ctx) {
                     fastModel: quick || null,
                     helperTtl: '900000',
                     disableThinking: '1',
+                    customModelOption: fable ? fableModelId : null,
+                    customModelOptionName: fable ? fableModelName : null,
+                    customModelOptionDescription: fable ? fableModelDescription : null,
                     apiKeyHelper,
                     authTokenSha256: crypto.createHash('sha256').update(ctx.apiKey).digest('hex'),
                     previousEnv,
@@ -89,7 +140,12 @@ export async function verify(ctx) {
     const settings = await fs.readJson(file);
     const env = asRecord(settings?.env);
     const model = String(env.ANTHROPIC_MODEL || '');
-    if (!modelIds(ctx).includes(model) || env.ANTHROPIC_BASE_URL !== anthropicOrigin(ctx.baseUrl) || settings.apiKeyHelper !== helperCommand(ctx.home, ctx.platform) || env.ANTHROPIC_AUTH_TOKEN || env.ANTHROPIC_API_KEY || env[discoveryKey] !== '1' || env[disableThinkingKey] !== '1') {
+    const fable = hasFableModel(ctx);
+    const customModelMatches = !fable
+        || (env[customModelOptionKey] === fableModelId
+            && env[customModelOptionNameKey] === fableModelName
+            && env[customModelOptionDescriptionKey] === fableModelDescription);
+    if (!modelIds(ctx).includes(model) || !customModelMatches || env.ANTHROPIC_BASE_URL !== anthropicOrigin(ctx.baseUrl) || settings.apiKeyHelper !== helperCommand(ctx.home, ctx.platform) || env.ANTHROPIC_AUTH_TOKEN || env.ANTHROPIC_API_KEY || env[discoveryKey] !== '1' || env[disableThinkingKey] !== '1') {
         throw new Error('Claude Code settings do not match the authenticated ScaleMax model catalog.');
     }
     await verifyClientSecret(secretPath(ctx.home), ctx);
@@ -143,6 +199,12 @@ export async function remove(ctx) {
         restore(helperTtlKey);
     if (env[disableThinkingKey] === managed.disableThinking)
         restore(disableThinkingKey);
+    if (env[customModelOptionKey] === managed.customModelOption)
+        restore(customModelOptionKey);
+    if (env[customModelOptionNameKey] === managed.customModelOptionName)
+        restore(customModelOptionNameKey);
+    if (env[customModelOptionDescriptionKey] === managed.customModelOptionDescription)
+        restore(customModelOptionDescriptionKey);
     if (!Object.prototype.hasOwnProperty.call(env, 'ANTHROPIC_AUTH_TOKEN'))
         restore('ANTHROPIC_AUTH_TOKEN');
     if (!Object.prototype.hasOwnProperty.call(env, 'ANTHROPIC_API_KEY'))

package/dist/configure/models.js

@@ -14,7 +14,6 @@ const preferredOpenAi = [
     'gpt-5.4',
     'gpt-5.4-mini',
     'gpt-5.3-codex',
-    'fable-5',
     'codex-auto-review'
 ];
 export function modelIds(ctx) {

package/dist/configure/templates.js

@@ -11,7 +11,7 @@ export function jsonConfig(client, apiKey, baseUrl, extra = {}) {
     }, null, 2) + '\n';
 }
 export function continueConfig(apiKey, baseUrl) {
-    const models = ['fable-5', 'gpt-5.6-sol', 'gpt-5.6-luna', 'gpt-5.6-terra', 'gpt-5.5', 'gpt-5.4', 'gpt-5.4-mini', 'gpt-5.3-codex', 'codex-auto-review'];
+    const models = ['gpt-5.6-sol', 'gpt-5.6-luna', 'gpt-5.6-terra', 'gpt-5.5', 'gpt-5.4', 'gpt-5.4-mini', 'gpt-5.3-codex', 'codex-auto-review'];
     return JSON.stringify({
         models: models.map(model => ({
             title: `ScaleMax ${model}`,

package/dist/configure/trae-solo.js

@@ -5,7 +5,7 @@ const id = 'trae-solo';
 const name = 'TRAE SOLO';
 export async function configure(ctx) {
     const file = clientConfigPath(id, ctx.home, ctx.platform);
-    const content = jsonConfig(name, '$SCALEMAX_API_KEY', ctx.baseUrl, { "officialSetup": ["Settings > Models > Add Model", "API format: OpenAI Chat Completions", `Request URL: ${ctx.baseUrl}/chat/completions or base URL ${ctx.baseUrl}`, "Use only a model ID returned by the authenticated catalog"], "recommendedModel": "fable-5" });
+    const content = jsonConfig(name, '$SCALEMAX_API_KEY', ctx.baseUrl, { "officialSetup": ["Settings > Models > Add Model", "API format: OpenAI Chat Completions", `Request URL: ${ctx.baseUrl}/chat/completions or base URL ${ctx.baseUrl}`, "Use only a model ID returned by the authenticated catalog"], "recommendedModel": "gpt-5.4-mini" });
     const result = await writeManagedConfig(ctx, id, name, file, content);
     return { ...result, message: 'setup guide written; enter these values in TRAE SOLO custom model settings' };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scalemax",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "Universal ScaleMax installer for AI coding clients",
   "type": "module",
   "bin": {