scalemax 0.1.45 → 0.1.47

package/dist/commands/configure.js

@@ -221,6 +221,9 @@ export async function configureCommand(opts = {}) {
                 }
             }
             successful.add(client.id);
+            // Only after verification: a rolled-back client gets no usage advice.
+            if (res.tip)
+                console.log(chalk.cyan(`  Tip: ${res.tip}`));
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);

package/dist/commands/helper-bot.js

@@ -1049,7 +1049,8 @@ async function runOneHelperClientAction(kind, client, connection, home, requeste
         : client.id === 'cline'
             ? ' Restart Cline; reload VS Code too when using the extension.'
             : client.id === 'continue' ? ' Reload VS Code once so Continue loads the verified ScaleMax profile.' : '';
-    return `✅ Successfully completed: ${client.name} is configured and locally verified.${activation}`;
+    const tip = configured.tip ? ` Tip: ${configured.tip}` : '';
+    return `✅ Successfully completed: ${client.name} is configured and locally verified.${activation}${tip}`;
 }
 /** Execute only narrowly allowlisted ScaleMax client actions; never model-generated shell commands. */
 export async function executeHelperAction(question, connection, home, clientCatalog = clients, write = message => console.log(message)) {

package/dist/configure/cline.d.ts

@@ -1,4 +1,10 @@
 import { ConfigureContext, ConfigureResult, DetectContext, InstallContext, RemoveContext } from '../types/client.js';
+/**
+ * Printed after every successful configure. Cline only edits files and carries
+ * out a task in Act mode; Plan mode explores and plans, which customers read as
+ * a broken key. Same advice as the docs' Cline guide and troubleshooting page.
+ */
+export declare const CLINE_MODE_TIP = "Switch Cline to Act mode to let it edit files and run the task. Plan mode only reads and plans; nothing is wrong with your key.";
 export interface ClineExtensionSurface {
     path: string;
     version?: string;

package/dist/configure/cline.js

@@ -16,6 +16,12 @@ const extensionId = 'saoudrizwan.claude-dev';
 const cliProviderId = 'openai-native';
 const legacyProviderId = 'scalemax';
 const extensionCredentialHashKey = 'scalemaxManagedOpenAiApiKeySha256';
+/**
+ * Printed after every successful configure. Cline only edits files and carries
+ * out a task in Act mode; Plan mode explores and plans, which customers read as
+ * a broken key. Same advice as the docs' Cline guide and troubleshooting page.
+ */
+export const CLINE_MODE_TIP = 'Switch Cline to Act mode to let it edit files and run the task. Plan mode only reads and plans; nothing is wrong with your key.';
 function credentialSha256(value) {
     return crypto.createHash('sha256').update(value, 'utf8').digest('hex');
 }
@@ -518,6 +524,7 @@ export async function configure(ctx) {
             changed: false,
             path: configuredPaths[0],
             message: 'verified Cline configuration is already current',
+            tip: CLINE_MODE_TIP,
         };
     }
     let snapshots;
@@ -541,6 +548,7 @@ export async function configure(ctx) {
         changed: true,
         path: configuredPaths[0],
         message: `configured ${surfaces.cliSupported ? `CLI ${cliVersion}` : ''}${surfaces.cliSupported && surfaces.extensionSupported ? ' and ' : ''}${surfaces.extensionSupported ? `VS Code extension ${extensionVersion}` : ''} with one raw ScaleMax credential; restart Cline to activate`,
+        tip: CLINE_MODE_TIP,
         rollback,
     };
 }

package/dist/configure/models.js

@@ -1,6 +1,9 @@
 import { isAnthropicModel, isModelRouteAvailable, isRetiredModelId } from '../utils/api.js';
 const preferredAnthropic = [
     'claude-opus-5',
+    // Opus 5.5 ranks right after Opus 5, so claude-opus-5 stays the default
+    // for new installs; promoting 5.5 to the default is a separate decision.
+    'claude-opus-5-5',
     'claude-opus-4-8',
     'claude-sonnet-5',
     'claude-opus-4-7',

package/dist/configure/openclaw.js

@@ -42,7 +42,7 @@ function entries(ctx, ids, family) {
             id: modelId,
             name: modelName(ctx, modelId),
             input: family === 'anthropic' ? ['text', 'image'] : ['text'],
-            maxTokens: modelId === 'claude-opus-5'
+            maxTokens: (modelId === 'claude-opus-5' || modelId === 'claude-opus-5-5')
                 ? Math.min(metadata?.max_output_tokens || 128000, 128000)
                 : Math.min(metadata?.max_output_tokens || 4096, 4096)
         };

package/dist/configure/opencode.js

@@ -24,7 +24,7 @@ function providerConfig(ctx) {
                 tool_call: modelSupportsTools(ctx, modelId),
                 limit: {
                     context: metadata?.context_window || (modelId.startsWith('claude-') ? 200000 : 128000),
-                    output: modelId === 'claude-opus-5'
+                    output: (modelId === 'claude-opus-5' || modelId === 'claude-opus-5-5')
                         ? Math.min(metadata?.max_output_tokens || 128000, 128000)
                         : Math.min(metadata?.max_output_tokens || 4096, 4096)
                 }

package/dist/configure/roo-code.d.ts

@@ -1,4 +1,11 @@
 import { ConfigureContext, ConfigureResult, RemoveContext } from '../types/client.js';
+/**
+ * Printed after every successful configure. Roo's built-in Ask and Architect
+ * modes carry no `command` tool group, so the model truthfully answers that
+ * terminal tools are not available and nothing runs -- customers read that as
+ * a broken key. Same advice as the docs' Roo Code guide and troubleshooting page.
+ */
+export declare const ROO_CODE_MODE_TIP = "Run tasks in Code or Debug mode. Ask and Architect modes cannot run terminal commands, so Roo says \"terminal tools are not available\" there. Switch modes; nothing is wrong with your key.";
 export declare function configure(ctx: ConfigureContext): Promise<ConfigureResult>;
 export declare function verify(ctx: ConfigureContext): Promise<ConfigureResult>;
 export declare function remove(ctx: RemoveContext): Promise<ConfigureResult>;

package/dist/configure/roo-code.js

@@ -18,6 +18,13 @@ const claudeProfileId = 'scalemax-claude';
 const deepSeekProfileId = 'scalemax-deepseek';
 const glmProfileId = 'scalemax-glm-5-2';
 const rooMaximumOutputTokens = 384_000;
+/**
+ * Printed after every successful configure. Roo's built-in Ask and Architect
+ * modes carry no `command` tool group, so the model truthfully answers that
+ * terminal tools are not available and nothing runs -- customers read that as
+ * a broken key. Same advice as the docs' Roo Code guide and troubleshooting page.
+ */
+export const ROO_CODE_MODE_TIP = 'Run tasks in Code or Debug mode. Ask and Architect modes cannot run terminal commands, so Roo says "terminal tools are not available" there. Switch modes; nothing is wrong with your key.';
 function exactChatProfile(ctx, model) {
     if (model.trim().toLowerCase() === 'glm-5.2')
         return { name: glmProfileName, id: glmProfileId, model };
@@ -152,7 +159,7 @@ export async function configure(ctx) {
     const nextProfile = handoff(ctx);
     if (originalSettings === nextSettings && originalProfile === nextProfile) {
         await fs.chmod(profileFile, 0o600).catch(() => undefined);
-        return { id, name, changed: false, path: profileFile, message: 'supported Roo Code auto-import handoff is already current; reload VS Code to consume it' };
+        return { id, name, changed: false, path: profileFile, message: 'supported Roo Code auto-import handoff is already current; reload VS Code to consume it', tip: ROO_CODE_MODE_TIP };
     }
     await backupFile(settingsFile, ctx.home);
     await backupFile(profileFile, ctx.home);
@@ -175,6 +182,7 @@ export async function configure(ctx) {
         changed: true,
         path: profileFile,
         message: 'created a private, supported auto-import handoff; reload VS Code so Roo Code imports the profile into SecretStorage',
+        tip: ROO_CODE_MODE_TIP,
         rollback: snapshotRollback(snapshots, ctx.platform),
     };
 }

package/dist/types/client.d.ts

@@ -73,6 +73,8 @@ export interface ConfigureResult {
     changed: boolean;
     path?: string;
     message: string;
+    /** One-line usage advice printed after a successful configure (e.g. which agent mode can run tools). */
+    tip?: string;
     /** Restore the exact state captured immediately before this configure call. */
     rollback?: () => Promise<void>;
 }

package/package.json

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