scalemax 0.1.5 → 0.1.7

package/README.md

@@ -98,15 +98,19 @@ SCALEMAX_API_KEY=sm_live_xxx scalemax models
 
 ## Supported clients
 
+`npx scalemax` now focuses on the supported non-VS-Code client set:
+
 - Codex
 - Cursor
+- TRAE SOLO
 - Claude Code
 - OpenCode
 - OpenClaw
 - Hermes
-- Continue
-- VS Code
-- Windsurf
+- Cherry Studio
+- API Code
+
+For clients without a stable official config file, the installer writes a ScaleMax setup guide under `~/.scalemax/` instead of modifying private app storage.
 
 ## Examples
 

package/dist/clients.js

@@ -2,31 +2,28 @@ import * as codexDetect from './detect/codex.js';
 import * as codexConfig from './configure/codex.js';
 import * as cursorDetect from './detect/cursor.js';
 import * as cursorConfig from './configure/cursor.js';
+import * as traeSoloDetect from './detect/trae-solo.js';
+import * as traeSoloConfig from './configure/trae-solo.js';
+import * as claudeDetect from './detect/claude.js';
+import * as claudeConfig from './configure/claude.js';
 import * as opencodeDetect from './detect/opencode.js';
 import * as opencodeConfig from './configure/opencode.js';
 import * as openclawDetect from './detect/openclaw.js';
 import * as openclawConfig from './configure/openclaw.js';
 import * as hermesDetect from './detect/hermes.js';
 import * as hermesConfig from './configure/hermes.js';
-import * as continueDetect from './detect/continue.js';
-import * as continueConfig from './configure/continue.js';
-import * as vscodeDetect from './detect/vscode.js';
-import * as vscodeConfig from './configure/vscode.js';
-import * as rooDetect from './detect/roo.js';
-import * as rooConfig from './configure/roo.js';
-import * as clineDetect from './detect/cline.js';
-import * as clineConfig from './configure/cline.js';
-import * as windsurfDetect from './detect/windsurf.js';
-import * as windsurfConfig from './configure/windsurf.js';
+import * as cherryStudioDetect from './detect/cherry-studio.js';
+import * as cherryStudioConfig from './configure/cherry-studio.js';
+import * as apiCodeDetect from './detect/api-code.js';
+import * as apiCodeConfig from './configure/api-code.js';
 export const clients = [
     { id: 'codex', name: 'Codex', detect: codexDetect.detect, install: codexConfig.install, configure: codexConfig.configure, verify: codexConfig.verify, launch: codexConfig.launch, remove: codexConfig.remove },
     { id: 'cursor', name: 'Cursor', detect: cursorDetect.detect, configure: cursorConfig.configure, remove: cursorConfig.remove },
+    { id: 'trae-solo', name: 'TRAE SOLO', detect: traeSoloDetect.detect, configure: traeSoloConfig.configure, remove: traeSoloConfig.remove },
+    { id: 'claude', name: 'Claude Code', detect: claudeDetect.detect, configure: claudeConfig.configure, remove: claudeConfig.remove },
     { id: 'opencode', name: 'OpenCode', detect: opencodeDetect.detect, configure: opencodeConfig.configure, remove: opencodeConfig.remove },
     { id: 'openclaw', name: 'OpenClaw', detect: openclawDetect.detect, configure: openclawConfig.configure, remove: openclawConfig.remove },
     { id: 'hermes', name: 'Hermes', detect: hermesDetect.detect, configure: hermesConfig.configure, remove: hermesConfig.remove },
-    { id: 'vscode', name: 'Continue Extension (VS Code)', detect: vscodeDetect.detect, configure: vscodeConfig.configure, remove: vscodeConfig.remove },
-    { id: 'roo', name: 'Roo Code (VS Code)', detect: rooDetect.detect, configure: rooConfig.configure, remove: rooConfig.remove },
-    { id: 'cline', name: 'Cline (VS Code)', detect: clineDetect.detect, configure: clineConfig.configure, remove: clineConfig.remove },
-    { id: 'continue', name: 'Continue', detect: continueDetect.detect, configure: continueConfig.configure, remove: continueConfig.remove },
-    { id: 'windsurf', name: 'Windsurf', detect: windsurfDetect.detect, configure: windsurfConfig.configure, remove: windsurfConfig.remove }
+    { id: 'cherry-studio', name: 'Cherry Studio', detect: cherryStudioDetect.detect, configure: cherryStudioConfig.configure, remove: cherryStudioConfig.remove },
+    { id: 'api-code', name: 'API Code', detect: apiCodeDetect.detect, configure: apiCodeConfig.configure, remove: apiCodeConfig.remove }
 ];

package/dist/commands/configure.js

@@ -4,6 +4,7 @@ import ora from 'ora';
 import { clients } from '../clients.js';
 import { SCALEMAX_BASE_URL } from '../constants.js';
 import { loadApiKey } from '../utils/keyStore.js';
+import { validateApiKey } from '../utils/api.js';
 import { homeDir } from '../utils/paths.js';
 export async function detectAll(home = homeDir()) {
     const ctx = { home, platform: process.platform, env: process.env };
@@ -38,33 +39,49 @@ async function maybeLaunchCodex(chosen, successful) {
     }
     console.log('\nIf Codex asks for authentication,\nit should already be configured to use ScaleMax.\n\nIf you still see the official login screen,\nthe configuration is incomplete or Codex rejected the generated auth/config files.\n');
 }
+function clientAllowedForScope(clientId, scope) {
+    if (scope === 'both')
+        return true;
+    if (clientId === 'claude')
+        return scope === 'anthropic';
+    if (clientId === 'api-code')
+        return true;
+    return scope === 'openai';
+}
+function scopeHint(scope) {
+    return scope === 'both' ? 'OpenAI + Claude' : scope === 'anthropic' ? 'Claude only' : 'OpenAI only';
+}
 export async function configureCommand(opts = {}) {
     const home = opts.home || homeDir();
     const apiKey = await loadApiKey(home);
     if (!apiKey)
         throw new Error('No ScaleMax API key found. Run `scalemax login` first.');
+    const keyInfo = await validateApiKey(apiKey);
+    const providerScope = keyInfo.key?.provider_scope || 'both';
+    const availableClients = clients.filter(c => clientAllowedForScope(c.id, providerScope));
+    console.log(chalk.dim(`API key scope: ${scopeHint(providerScope)}. Incompatible clients are hidden.`));
     const detections = await printDetected(home);
     const detectedIds = new Set(detections.filter(d => d.installed).map(d => d.id));
     let chosen;
     if (opts.all)
-        chosen = clients.filter(c => detectedIds.has(c.id)).map(c => c.id);
+        chosen = availableClients.filter(c => detectedIds.has(c.id)).map(c => c.id);
     else {
         const action = await select({ message: 'Configure', options: [
-                ...clients.map((c, idx) => ({ value: c.id, label: `${idx + 1}. ${c.name}${detectedIds.has(c.id) ? '' : ' (not detected)'}` })),
+                ...availableClients.map((c, idx) => ({ value: c.id, label: `${idx + 1}. ${c.name}${detectedIds.has(c.id) ? '' : ' (not detected)'}` })),
                 { value: 'all', label: 'A. Configure ALL detected clients' }
             ] });
         if (isCancel(action)) {
             cancel('Configuration cancelled.');
             return;
         }
-        chosen = action === 'all' ? clients.filter(c => detectedIds.has(c.id)).map(c => c.id) : [action];
+        chosen = action === 'all' ? availableClients.filter(c => detectedIds.has(c.id)).map(c => c.id) : [action];
     }
     if (chosen.length === 0) {
         console.log(chalk.yellow('No detected clients to configure.'));
         return;
     }
     const successful = new Set();
-    for (const client of clients.filter(c => chosen.includes(c.id))) {
+    for (const client of availableClients.filter(c => chosen.includes(c.id))) {
         const baseCtx = { home, platform: process.platform, env: process.env };
         if (client.install) {
             const spinner = ora(`Checking ${client.name}`).start();
@@ -79,7 +96,7 @@ export async function configureCommand(opts = {}) {
         }
         const spinner = ora(`Configuring ${client.name}`).start();
         try {
-            const ctx = { ...baseCtx, apiKey, baseUrl: SCALEMAX_BASE_URL };
+            const ctx = { ...baseCtx, apiKey, baseUrl: SCALEMAX_BASE_URL, providerScope };
             const res = await client.configure(ctx);
             spinner.succeed(`${client.name} ${res.message}`);
             if (client.verify) {

package/dist/commands/doctor.js

@@ -24,7 +24,7 @@ export async function doctorCommand(home = homeDir()) {
             failures++;
         }
         const st = ora('Checking streaming').start();
-        const stream = await testStreaming(key, res.models.find(m => m.id === 'gpt-5.5')?.id || res.models[0]?.id);
+        const stream = await testStreaming(key, res.models.find(m => m.id === 'fable-5')?.id || res.models[0]?.id);
         if (stream.ok)
             st.succeed('Streaming available');
         else {

package/dist/commands/login.js

@@ -5,6 +5,7 @@ import { validateApiKey } from '../utils/api.js';
 import { saveApiKey } from '../utils/keyStore.js';
 import { SCALEMAX_BASE_URL } from '../constants.js';
 import { homeDir } from '../utils/paths.js';
+import { sanitizeApiKey } from '../utils/apiKey.js';
 export async function loginCommand(home = homeDir()) {
     intro(chalk.cyan('ScaleMax Login'));
     const key = await password({ message: 'Paste your ScaleMax API Key:', mask: '•', validate(value) { return value.trim().length < 12 ? 'Enter a valid ScaleMax API key.' : undefined; } });
@@ -12,14 +13,15 @@ export async function loginCommand(home = homeDir()) {
         cancel('Login cancelled.');
         return;
     }
+    const sanitizedKey = sanitizeApiKey(key);
     const spinner = ora('Verifying API key').start();
-    const result = await validateApiKey(String(key).trim());
+    const result = await validateApiKey(sanitizedKey);
     if (!result.ok) {
         spinner.fail('Invalid API Key');
         throw new Error(result.error || 'Invalid API Key');
     }
-    await saveApiKey(String(key).trim(), SCALEMAX_BASE_URL, home);
-    spinner.succeed('API Key verified');
+    await saveApiKey(sanitizedKey, SCALEMAX_BASE_URL, home);
+    spinner.succeed(`API Key verified (${result.key?.provider_scope || 'both'} provider scope)`);
     outro(chalk.green('ScaleMax API key saved.'));
-    return String(key).trim();
+    return sanitizedKey;
 }

package/dist/configure/api-code.js

@@ -0,0 +1,15 @@
+import { clientConfigPath } from './paths.js';
+import { writeManagedConfig, removeManagedConfig } from './common.js';
+import { jsonConfig } from './templates.js';
+const id = 'api-code';
+const name = 'API Code';
+export async function configure(ctx) {
+    const file = clientConfigPath(id, ctx.home, ctx.platform);
+    const content = jsonConfig(name, ctx.apiKey, ctx.baseUrl, { "environment": { "SCALEMAX_API_KEY": "your ScaleMax API key", "SCALEMAX_BASE_URL": "https://api.scalemax.pro/v1" }, "node": "import OpenAI from 'openai';\nconst client = new OpenAI({ apiKey: process.env.SCALEMAX_API_KEY, baseURL: 'https://api.scalemax.pro/v1' });", "python": "from openai import OpenAI\nclient = OpenAI(api_key='...', base_url='https://api.scalemax.pro/v1')" });
+    const result = await writeManagedConfig(ctx, id, name, file, content);
+    return { ...result, message: 'API code examples written' };
+}
+export async function remove(ctx) {
+    const file = clientConfigPath(id, ctx.home, ctx.platform);
+    return removeManagedConfig(ctx, id, name, file);
+}

package/dist/configure/cherry-studio.js

@@ -0,0 +1,15 @@
+import { clientConfigPath } from './paths.js';
+import { writeManagedConfig, removeManagedConfig } from './common.js';
+import { jsonConfig } from './templates.js';
+const id = 'cherry-studio';
+const name = 'Cherry Studio';
+export async function configure(ctx) {
+    const file = clientConfigPath(id, ctx.home, ctx.platform);
+    const content = jsonConfig(name, ctx.apiKey, ctx.baseUrl, { "officialSetup": ["Settings > Model Service / Model Providers", "Provider type: OpenAI or OpenAI Compatible", "API host/base URL: https://api.scalemax.pro/v1", "Add ScaleMax model IDs or fetch from /v1/models"], "recommendedModel": "fable-5" });
+    const result = await writeManagedConfig(ctx, id, name, file, content);
+    return { ...result, message: 'setup guide written; enter these values in Cherry Studio model provider settings' };
+}
+export async function remove(ctx) {
+    const file = clientConfigPath(id, ctx.home, ctx.platform);
+    return removeManagedConfig(ctx, id, name, file);
+}

package/dist/configure/claude.js

@@ -1,12 +1,22 @@
 import { clientConfigPath } from './paths.js';
 import { writeManagedConfig, removeManagedConfig } from './common.js';
-import { jsonConfig } from './templates.js';
 const id = 'claude';
 const name = 'Claude Code';
 export async function configure(ctx) {
     const file = clientConfigPath(id, ctx.home, ctx.platform);
-    const content = jsonConfig(name, ctx.apiKey, ctx.baseUrl);
-    return writeManagedConfig(ctx, id, name, file, content);
+    const content = JSON.stringify({
+        env: {
+            ANTHROPIC_AUTH_TOKEN: ctx.apiKey,
+            ANTHROPIC_BASE_URL: ctx.baseUrl,
+            ANTHROPIC_MODEL: 'fable-5'
+        },
+        scalemax: {
+            managedBy: 'ScaleMax CLI',
+            note: 'Claude Code uses Anthropic Messages, not OpenAI Chat Completions. This file stores ScaleMax values, but Claude Code requires a ScaleMax Anthropic-compatible endpoint before it can work reliably.'
+        }
+    }, null, 2) + '\n';
+    const result = await writeManagedConfig(ctx, id, name, file, content);
+    return { ...result, message: 'settings written; Claude Code requires Anthropic-compatible ScaleMax endpoint' };
 }
 export async function remove(ctx) {
     const file = clientConfigPath(id, ctx.home, ctx.platform);

package/dist/configure/codex.js

@@ -8,9 +8,9 @@ import { commandExists } from '../utils/exec.js';
 const id = 'codex';
 const name = 'Codex';
 const provider = 'scalemax';
-const model = 'gpt-5.5';
+const model = 'fable-5';
 function codexConfig(baseUrl) {
-    return `# ${GENERATED_HEADER}\nmodel = "${model}"\nmodel_provider = "${provider}"\ndisable_response_storage = true\n# Recommended ScaleMax Codex models: gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex.\n# Provider-internal gpt-5.3-codex-spark is routed behind the public gpt-5.3-codex Codex slug.\n\n[model_providers.${provider}]\nname = "ScaleMax"\nbase_url = "${baseUrl}"\nwire_api = "responses"\nrequires_openai_auth = true\n`;
+    return `# ${GENERATED_HEADER}\nmodel = "${model}"\nmodel_provider = "${provider}"\ndisable_response_storage = true\n# Recommended ScaleMax Codex models: fable-5, fable-5-ultra, gpt-5.6-luna, gpt-5.6-terra, gpt-5.6-sol, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex.\n# Provider-internal gpt-5.3-codex-spark is routed behind the public gpt-5.3-codex Codex slug.\n\n[model_providers.${provider}]\nname = "ScaleMax"\nbase_url = "${baseUrl}"\nwire_api = "responses"\nrequires_openai_auth = true\n`;
 }
 function codexAuth(apiKey) {
     return JSON.stringify({ auth_mode: 'apikey', OPENAI_API_KEY: apiKey }, null, 2) + '\n';

package/dist/configure/opencode.js

@@ -1,11 +1,30 @@
 import { clientConfigPath } from './paths.js';
 import { writeManagedConfig, removeManagedConfig } from './common.js';
-import { jsonConfig } from './templates.js';
 const id = 'opencode';
 const name = 'OpenCode';
 export async function configure(ctx) {
     const file = clientConfigPath(id, ctx.home, ctx.platform);
-    const content = jsonConfig(name, ctx.apiKey, ctx.baseUrl);
+    const content = JSON.stringify({
+        $schema: 'https://opencode.ai/config.json',
+        provider: {
+            scalemax: {
+                npm: '@ai-sdk/openai-compatible',
+                name: 'ScaleMax',
+                options: { baseURL: ctx.baseUrl, apiKey: ctx.apiKey },
+                models: {
+                    'fable-5': { name: 'Fable 5' },
+                    'fable-5-ultra': { name: 'Fable 5 Ultra' },
+                    'gpt-5.6-luna': { name: 'GPT-5.6 Luna' },
+                    'gpt-5.6-terra': { name: 'GPT-5.6 Terra' },
+                    'gpt-5.6-sol': { name: 'GPT-5.6 Sol' },
+                    'gpt-5.4': { name: 'GPT-5.4' },
+                    'gpt-5.4-mini': { name: 'GPT-5.4 Mini' },
+                    'gpt-5.3-codex': { name: 'GPT-5.3 Codex' },
+                    'codex-auto-review': { name: 'Codex Auto Review' }
+                }
+            }
+        }
+    }, null, 2) + '\n';
     return writeManagedConfig(ctx, id, name, file, content);
 }
 export async function remove(ctx) {

package/dist/configure/paths.js

@@ -9,15 +9,13 @@ export function clientConfigPath(id, home, platform, env = process.env) {
     switch (id) {
         case 'codex': return codexConfigPath(home);
         case 'cursor': return platform === 'win32' ? path.join(app, 'Cursor', 'User', 'settings.json') : platform === 'darwin' ? path.join(home, 'Library', 'Application Support', 'Cursor', 'User', 'settings.json') : path.join(linux, 'Cursor', 'User', 'settings.json');
+        case 'trae-solo': return path.join(home, '.scalemax', 'trae-solo.setup.json');
         case 'claude': return path.join(home, '.claude', 'settings.json');
-        case 'opencode': return path.join(linux, 'opencode', 'config.json');
+        case 'opencode': return path.join(linux, 'opencode', 'opencode.json');
         case 'openclaw': return path.join(home, '.openclaw', 'config.json');
         case 'hermes': return path.join(home, '.hermes', 'config', 'scalemax.json');
-        case 'continue': return path.join(home, '.continue', 'config.json');
-        case 'roo': return path.join(home, '.scalemax', 'roo-code-vscode.manual.json');
-        case 'cline': return path.join(home, '.scalemax', 'cline-vscode.manual.json');
-        case 'vscode': return platform === 'win32' ? path.join(app, 'Code', 'User', 'settings.json') : platform === 'darwin' ? path.join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json') : path.join(linux, 'Code', 'User', 'settings.json');
-        case 'windsurf': return platform === 'win32' ? path.join(app, 'Windsurf', 'User', 'settings.json') : platform === 'darwin' ? path.join(home, 'Library', 'Application Support', 'Windsurf', 'User', 'settings.json') : path.join(linux, 'Windsurf', 'User', 'settings.json');
+        case 'cherry-studio': return path.join(home, '.scalemax', 'cherry-studio.setup.json');
+        case 'api-code': return path.join(home, '.scalemax', 'api-code.examples.json');
     }
 }
 export function installHints(id, home, platform, env = process.env) {
@@ -26,14 +24,12 @@ export function installHints(id, home, platform, env = process.env) {
     switch (id) {
         case 'codex': return [codexDir(home), path.join(linux, 'codex')];
         case 'cursor': return [platform === 'darwin' ? '/Applications/Cursor.app' : path.join(app, 'Cursor'), path.join(linux, 'Cursor')];
+        case 'trae-solo': return [platform === 'darwin' ? '/Applications/Trae.app' : path.join(app, 'Trae'), path.join(linux, 'Trae')];
         case 'claude': return [path.join(home, '.claude')];
         case 'opencode': return [path.join(linux, 'opencode')];
         case 'openclaw': return [path.join(home, '.openclaw'), path.join(linux, 'openclaw')];
         case 'hermes': return [path.join(home, '.hermes')];
-        case 'continue': return [path.join(home, '.continue')];
-        case 'roo': return [];
-        case 'cline': return [];
-        case 'vscode': return [platform === 'darwin' ? '/Applications/Visual Studio Code.app' : path.join(app, 'Code'), path.join(linux, 'Code')];
-        case 'windsurf': return [platform === 'darwin' ? '/Applications/Windsurf.app' : path.join(app, 'Windsurf'), path.join(linux, 'Windsurf')];
+        case 'cherry-studio': return [platform === 'darwin' ? '/Applications/Cherry Studio.app' : path.join(app, 'Cherry Studio'), path.join(linux, 'CherryStudio')];
+        case 'api-code': return [path.join(home, '.scalemax')];
     }
 }

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 = ['gpt-5.5', 'gpt-5.4', 'gpt-5.4-mini', 'gpt-5.3-codex', 'codex-auto-review'];
+    const models = ['fable-5', 'fable-5-ultra', 'gpt-5.6-luna', 'gpt-5.6-terra', 'gpt-5.6-sol', '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

@@ -0,0 +1,15 @@
+import { clientConfigPath } from './paths.js';
+import { writeManagedConfig, removeManagedConfig } from './common.js';
+import { jsonConfig } from './templates.js';
+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, ctx.apiKey, ctx.baseUrl, { "officialSetup": ["Settings > Models > Add Model", "API format: OpenAI Chat Completions", "Request URL: https://api.scalemax.pro/v1/chat/completions or base URL https://api.scalemax.pro/v1", "Model ID: fable-5 or another ScaleMax model"], "recommendedModel": "fable-5" });
+    const result = await writeManagedConfig(ctx, id, name, file, content);
+    return { ...result, message: 'setup guide written; enter these values in TRAE SOLO custom model settings' };
+}
+export async function remove(ctx) {
+    const file = clientConfigPath(id, ctx.home, ctx.platform);
+    return removeManagedConfig(ctx, id, name, file);
+}

package/dist/detect/api-code.js

@@ -0,0 +1,2 @@
+import { detectClient } from './common.js';
+export function detect(ctx) { return detectClient(ctx, 'api-code', 'API Code'); }

package/dist/detect/cherry-studio.js

@@ -0,0 +1,2 @@
+import { detectClient } from './common.js';
+export function detect(ctx) { return detectClient(ctx, 'cherry-studio', 'Cherry Studio'); }

package/dist/detect/common.js

@@ -1,30 +1,16 @@
 import fs from 'fs-extra';
 import { commandExists } from '../utils/exec.js';
 import { clientConfigPath, installHints } from '../configure/paths.js';
-function vscodeExtensionRoots(ctx) {
-    const app = ctx.env.APPDATA || '';
-    const xdg = ctx.env.XDG_DATA_HOME || pathJoin(ctx.home, '.local', 'share');
-    if (ctx.platform === 'win32')
-        return [pathJoin(ctx.home, '.vscode', 'extensions'), pathJoin(app, 'Code', 'User', 'globalStorage')];
-    if (ctx.platform === 'darwin')
-        return [pathJoin(ctx.home, '.vscode', 'extensions'), pathJoin(ctx.home, 'Library', 'Application Support', 'Code', 'User', 'globalStorage')];
-    return [pathJoin(ctx.home, '.vscode', 'extensions'), pathJoin(xdg, 'Code', 'User', 'globalStorage')];
-}
-function pathJoin(...parts) { return parts.filter(Boolean).join('/'); }
-async function detectVsCodeExtension(ctx, patterns) {
-    const hits = [];
-    for (const root of vscodeExtensionRoots(ctx)) {
-        const entries = await fs.readdir(root).catch(() => []);
-        for (const entry of entries) {
-            const lower = entry.toLowerCase();
-            if (patterns.some(pattern => lower.includes(pattern)))
-                hits.push(`${root}/${entry}`);
-        }
-    }
-    return hits;
-}
 const commands = {
-    codex: ['codex'], cursor: ['cursor'], claude: ['claude'], opencode: ['opencode'], openclaw: ['openclaw'], hermes: ['hermes'], continue: ['continue'], vscode: ['code'], roo: [], cline: [], windsurf: ['windsurf']
+    codex: ['codex'],
+    cursor: ['cursor'],
+    'trae-solo': ['trae', 'trae-solo'],
+    claude: ['claude'],
+    opencode: ['opencode'],
+    openclaw: ['openclaw'],
+    hermes: ['hermes'],
+    'cherry-studio': ['cherry-studio', 'cherrystudio'],
+    'api-code': []
 };
 export async function detectClient(ctx, id, name) {
     const paths = [clientConfigPath(id, ctx.home, ctx.platform, ctx.env), ...installHints(id, ctx.home, ctx.platform, ctx.env)];
@@ -36,11 +22,7 @@ export async function detectClient(ctx, id, name) {
     for (const cmd of commands[id])
         if (await commandExists(cmd))
             cmdHits.push(`command:${cmd}`);
-    const extensionHits = id === 'roo'
-        ? await detectVsCodeExtension(ctx, ['rooveterinaryinc.roo-cline', 'roo-cline', 'roo-code'])
-        : id === 'cline'
-            ? await detectVsCodeExtension(ctx, ['saoudrizwan.claude-dev', 'cline.cline'])
-            : [];
-    const hits = [...cmdHits, ...pathHits, ...extensionHits];
-    return { id, name, installed: hits.length > 0, reason: hits.length ? undefined : 'not detected', paths: hits };
+    const hits = [...cmdHits, ...pathHits];
+    const alwaysAvailable = id === 'api-code';
+    return { id, name, installed: hits.length > 0 || alwaysAvailable, reason: hits.length || alwaysAvailable ? undefined : 'not detected', paths: hits };
 }

package/dist/detect/trae-solo.js

@@ -0,0 +1,2 @@
+import { detectClient } from './common.js';
+export function detect(ctx) { return detectClient(ctx, 'trae-solo', 'TRAE SOLO'); }

package/dist/types/client.d.ts

@@ -1,4 +1,5 @@
-export type ClientId = 'codex' | 'cursor' | 'claude' | 'opencode' | 'openclaw' | 'hermes' | 'continue' | 'vscode' | 'roo' | 'cline' | 'windsurf';
+export type ClientId = 'codex' | 'cursor' | 'trae-solo' | 'claude' | 'opencode' | 'openclaw' | 'hermes' | 'cherry-studio' | 'api-code';
+export type ProviderScope = 'openai' | 'anthropic' | 'both';
 export interface ClientDefinition {
     id: ClientId;
     name: string;

package/dist/utils/api.d.ts

@@ -1,12 +1,20 @@
+export type ProviderScope = 'openai' | 'anthropic' | 'both';
 export interface ModelInfo {
     id: string;
     object?: string;
     owned_by?: string;
     display_name?: string;
 }
+export interface KeyMetadata {
+    provider_scope: ProviderScope;
+    mode?: string;
+    prefix?: string;
+    label?: string;
+}
 export declare function validateApiKey(apiKey: string): Promise<{
     ok: boolean;
     models: ModelInfo[];
+    key?: KeyMetadata;
     error?: string;
 }>;
 export declare function testStreaming(apiKey: string, model?: string): Promise<{

package/dist/utils/api.js

@@ -1,4 +1,5 @@
 import { SCALEMAX_BASE_URL } from '../constants.js';
+import { sanitizeApiKey } from './apiKey.js';
 async function friendlyError(res) {
     let body = '';
     try {
@@ -22,7 +23,7 @@ async function friendlyError(res) {
 async function request(path, apiKey, init = {}) {
     const headers = new Headers(init.headers);
     if (apiKey)
-        headers.set('Authorization', `Bearer ${apiKey}`);
+        headers.set('Authorization', `Bearer ${sanitizeApiKey(apiKey)}`);
     headers.set('Cache-Control', 'no-cache');
     if (!headers.has('Content-Type') && init.body)
         headers.set('Content-Type', 'application/json');
@@ -30,18 +31,23 @@ async function request(path, apiKey, init = {}) {
 }
 export async function validateApiKey(apiKey) {
     try {
-        const res = await request('/models', apiKey);
+        const authCheck = await request('/usage', apiKey);
+        if (!authCheck.ok)
+            return { ok: false, models: [], error: await friendlyError(authCheck) };
+        const usage = await authCheck.json().catch(() => ({}));
+        const keyMeta = { provider_scope: usage?.key?.provider_scope || 'both', mode: usage?.key?.mode, prefix: usage?.key?.prefix, label: usage?.key?.label };
+        const res = await request('/models');
         if (!res.ok)
-            return { ok: false, models: [], error: await friendlyError(res) };
+            return { ok: true, models: [], key: keyMeta, error: await friendlyError(res) };
         const data = await res.json();
-        return { ok: Array.isArray(data.data), models: data.data || [] };
+        return { ok: true, models: Array.isArray(data.data) ? data.data : [], key: keyMeta };
     }
     catch (err) {
         return { ok: false, models: [], error: err instanceof Error ? err.message : String(err) };
     }
 }
 export async function testStreaming(apiKey, model) {
-    const selected = model || 'gpt-5.5';
+    const selected = model || 'fable-5';
     try {
         const res = await request('/chat/completions', apiKey, { method: 'POST', body: JSON.stringify({ model: selected, stream: true, max_tokens: 8, messages: [{ role: 'user', content: 'Say OK' }] }) });
         if (!res.ok)

package/dist/utils/apiKey.d.ts

@@ -0,0 +1 @@
+export declare function sanitizeApiKey(input: unknown): string;

package/dist/utils/apiKey.js

@@ -0,0 +1,8 @@
+const ZERO_WIDTH_RE = /[\u200B-\u200D\uFEFF]/g;
+const ASCII_WHITESPACE_RE = /\s+/g;
+export function sanitizeApiKey(input) {
+    return String(input ?? '')
+        .replace(ZERO_WIDTH_RE, '')
+        .replace(ASCII_WHITESPACE_RE, '')
+        .trim();
+}

package/dist/utils/keyStore.js

@@ -2,15 +2,16 @@ import fs from 'fs-extra';
 import { KEY_ENV } from '../constants.js';
 import { scaleMaxConfigPath, scaleMaxDir } from './paths.js';
 import { readJson, writeJsonAtomic } from './fs.js';
+import { sanitizeApiKey } from './apiKey.js';
 export async function saveApiKey(apiKey, baseUrl, home) {
     await fs.ensureDir(scaleMaxDir(home), 0o700);
-    await writeJsonAtomic(scaleMaxConfigPath(home), { apiKey, baseUrl, updatedAt: new Date().toISOString() }, 0o600);
+    await writeJsonAtomic(scaleMaxConfigPath(home), { apiKey: sanitizeApiKey(apiKey), baseUrl, updatedAt: new Date().toISOString() }, 0o600);
 }
 export async function loadApiKey(home) {
     if (process.env[KEY_ENV])
-        return process.env[KEY_ENV];
+        return sanitizeApiKey(process.env[KEY_ENV]);
     const cfg = await readJson(scaleMaxConfigPath(home), {});
-    return cfg.apiKey;
+    return cfg.apiKey ? sanitizeApiKey(cfg.apiKey) : undefined;
 }
 export async function removeApiKey(home) {
     await fs.remove(scaleMaxConfigPath(home));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scalemax",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Universal ScaleMax installer for AI coding clients",
   "type": "module",
   "bin": {
@@ -51,12 +51,12 @@
     "installer",
     "codex",
     "cursor",
+    "trae-solo",
+    "claude-code",
     "opencode",
-    "continue",
-    "vscode",
-    "roo-code",
-    "cline",
-    "windsurf",
+    "openclaw",
+    "hermes",
+    "cherry-studio",
     "openai-compatible"
   ],
   "license": "MIT",

package/dist/configure/cline.d.ts

@@ -1,3 +0,0 @@
-import { ConfigureContext, ConfigureResult } from '../types/client.js';
-export declare function configure(ctx: ConfigureContext): Promise<ConfigureResult>;
-export declare function remove(_ctx: ConfigureContext): Promise<ConfigureResult>;

package/dist/configure/cline.js

@@ -1,13 +0,0 @@
-const id = 'cline';
-const name = 'Cline (VS Code)';
-export async function configure(ctx) {
-    return {
-        id,
-        name,
-        changed: false,
-        message: `detected. Open the extension settings and select API Provider: OpenAI Compatible; Base URL: ${ctx.baseUrl}; API Key: your ScaleMax key; Model ID: gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, or codex-auto-review. Official docs: https://docs.cline.bot/provider-config/openai-compatible`,
-    };
-}
-export async function remove(_ctx) {
-    return { id, name, changed: false, message: 'Roo/Cline settings are stored inside VS Code extension state. Remove or edit them from the extension settings UI.' };
-}

package/dist/configure/continue.js

@@ -1,12 +0,0 @@
-import { clientConfigPath } from './paths.js';
-import { writeManagedConfig, removeManagedConfig } from './common.js';
-import { continueConfig } from './templates.js';
-const id = 'continue';
-const name = 'Continue';
-export async function configure(ctx) {
-    const file = clientConfigPath(id, ctx.home, ctx.platform);
-    return writeManagedConfig(ctx, id, name, file, continueConfig(ctx.apiKey, ctx.baseUrl));
-}
-export async function remove(ctx) {
-    return removeManagedConfig(ctx, id, name, clientConfigPath(id, ctx.home, ctx.platform));
-}

package/dist/configure/roo.d.ts

@@ -1,3 +0,0 @@
-import { ConfigureContext, ConfigureResult } from '../types/client.js';
-export declare function configure(ctx: ConfigureContext): Promise<ConfigureResult>;
-export declare function remove(_ctx: ConfigureContext): Promise<ConfigureResult>;

package/dist/configure/roo.js

@@ -1,13 +0,0 @@
-const id = 'roo';
-const name = 'Roo Code (VS Code)';
-export async function configure(ctx) {
-    return {
-        id,
-        name,
-        changed: false,
-        message: `detected. Open the extension settings and select API Provider: OpenAI Compatible; Base URL: ${ctx.baseUrl}; API Key: your ScaleMax key; Model ID: gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, or codex-auto-review. Official docs: https://docs.roocode.com/providers/openai-compatible`,
-    };
-}
-export async function remove(_ctx) {
-    return { id, name, changed: false, message: 'Roo/Cline settings are stored inside VS Code extension state. Remove or edit them from the extension settings UI.' };
-}

package/dist/configure/vscode.js

@@ -1,13 +0,0 @@
-import { clientConfigPath } from './paths.js';
-import { removeManagedConfig, writeManagedConfig } from './common.js';
-import { continueConfig } from './templates.js';
-const id = 'vscode';
-const name = 'Continue Extension (VS Code)';
-export async function configure(ctx) {
-    const file = clientConfigPath('continue', ctx.home, ctx.platform);
-    return writeManagedConfig(ctx, id, name, file, continueConfig(ctx.apiKey, ctx.baseUrl));
-}
-export async function remove(ctx) {
-    const file = clientConfigPath('continue', ctx.home, ctx.platform);
-    return removeManagedConfig(ctx, id, name, file);
-}

package/dist/configure/windsurf.js

@@ -1,13 +0,0 @@
-import { clientConfigPath } from './paths.js';
-import { removeManagedConfig, writeMergedJsonConfig } from './common.js';
-import { editorSettings } from './templates.js';
-const id = 'windsurf';
-const name = 'Windsurf';
-export async function configure(ctx) {
-    const file = clientConfigPath(id, ctx.home, ctx.platform);
-    return writeMergedJsonConfig(ctx, id, name, file, existing => editorSettings(name, ctx.apiKey, ctx.baseUrl, existing));
-}
-export async function remove(ctx) {
-    const file = clientConfigPath(id, ctx.home, ctx.platform);
-    return removeManagedConfig(ctx, id, name, file);
-}

package/dist/detect/cline.js

@@ -1,2 +0,0 @@
-import { detectClient } from './common.js';
-export function detect(ctx) { return detectClient(ctx, 'cline', 'Cline (VS Code)'); }

package/dist/detect/continue.js

@@ -1,2 +0,0 @@
-import { detectClient } from './common.js';
-export function detect(ctx) { return detectClient(ctx, 'continue', 'Continue'); }

package/dist/detect/roo.js

@@ -1,2 +0,0 @@
-import { detectClient } from './common.js';
-export function detect(ctx) { return detectClient(ctx, 'roo', 'Roo Code (VS Code)'); }

package/dist/detect/vscode.d.ts

@@ -1,2 +0,0 @@
-import { DetectContext, DetectionResult } from '../types/client.js';
-export declare function detect(ctx: DetectContext): Promise<DetectionResult>;

package/dist/detect/vscode.js

@@ -1,2 +0,0 @@
-import { detectClient } from './common.js';
-export function detect(ctx) { return detectClient(ctx, 'vscode', 'VS Code'); }

package/dist/detect/windsurf.d.ts

@@ -1,2 +0,0 @@
-import { DetectContext, DetectionResult } from '../types/client.js';
-export declare function detect(ctx: DetectContext): Promise<DetectionResult>;

package/dist/detect/windsurf.js

@@ -1,2 +0,0 @@
-import { detectClient } from './common.js';
-export function detect(ctx) { return detectClient(ctx, 'windsurf', 'Windsurf'); }