theclawbay 0.3.25 → 0.3.26

package/README.md

@@ -1,6 +1,6 @@
 # theclawbay
 
-CLI for connecting Codex to The Claw Bay and optionally linking detected OpenClaw, OpenCode, Kilo, or experimental Trae installs.
+CLI for connecting Codex, OpenClaw, OpenCode, Kilo, and experimental Trae to The Claw Bay.
 
 ## Install
 
@@ -16,9 +16,9 @@ Get your API key from `https://theclawbay.com/dashboard`.
 theclawbay setup --api-key <apiKey>
 ```
 
-If OpenClaw, OpenCode, or Kilo are already installed, setup offers them as optional add-ons during the same flow.
-
-On Windows, detected Trae installs can also be patched experimentally through the same setup flow.
+In an interactive terminal, setup shows one picker for Codex, OpenClaw, OpenCode, Kilo, and Windows Trae.
+Detected integrations are preselected when recommended, undetected ones stay visible but cannot be selected,
+and you can toggle items with arrow keys plus `Enter` or by pressing their number.
 
 ## Optional
 

package/dist/commands/setup.js

@@ -40,7 +40,7 @@ const SHELL_END = "# theclawbay-shell-managed:end";
 const OPENCLAW_PROVIDER_ID = DEFAULT_PROVIDER_ID;
 const HISTORY_PROVIDER_NEUTRALIZE_SOURCES = new Set(["openai", "theclawbay-wan", DEFAULT_PROVIDER_ID]);
 const HISTORY_PROVIDER_DB_MIGRATE_SOURCES = ["openai", "theclawbay-wan"];
-const OPTIONAL_SETUP_CLIENT_IDS = ["openclaw", "opencode", "kilo", "trae"];
+const SETUP_CLIENT_IDS = ["codex", "openclaw", "opencode", "kilo", "trae"];
 const TRAE_PATCH_MARKER = "theclawbay-trae-patch";
 const TRAE_BUNDLE_BACKUP_SUFFIX = ".theclawbay-managed-backup";
 const TRAE_TARGET_FUNCTION_START = "async setOriginModelListMapAndCache(e,t=!0){";
@@ -175,7 +175,7 @@ function shellQuote(value) {
 function modelDisplayName(modelId) {
     return MODEL_DISPLAY_NAMES[modelId] ?? modelId;
 }
-function parseOptionalClientFlags(raw) {
+function parseSetupClientFlags(raw) {
     if (!raw)
         return null;
     const parts = raw
@@ -184,46 +184,51 @@ function parseOptionalClientFlags(raw) {
         .filter(Boolean);
     const selected = new Set();
     for (const part of parts) {
-        if (part === "codex")
-            continue;
-        if (OPTIONAL_SETUP_CLIENT_IDS.includes(part)) {
+        if (SETUP_CLIENT_IDS.includes(part)) {
             selected.add(part);
             continue;
         }
-        throw new Error(`unknown client "${part}". Supported values: codex, openclaw, opencode, kilo, trae.`);
+        throw new Error(`unknown client "${part}". Supported values: ${SETUP_CLIENT_IDS.join(", ")}.`);
     }
     return selected;
 }
-async function promptForOptionalClients(clients) {
-    const detected = clients.filter((client) => client.detected);
-    const selected = new Set(detected.filter((client) => client.recommended).map((client) => client.id));
-    if (detected.length === 0 || !process.stdin.isTTY || !process.stdout.isTTY) {
+async function promptForSetupClients(clients) {
+    const selected = new Set(clients.filter((client) => client.detected && client.recommended).map((client) => client.id));
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
         return selected;
     }
-    const options = detected.map((client) => ({
+    const options = clients.map((client) => ({
         ...client,
-        checked: selected.has(client.id),
+        checked: client.detected && selected.has(client.id),
     }));
     return new Promise((resolve) => {
         let cursor = 0;
         let settled = false;
+        let hint = clients.some((client) => client.detected)
+            ? "Detected integrations are preselected. Undetected ones stay visible but disabled."
+            : "No supported local clients are detected yet. Continue will just save your managed config and API key env.";
         const stdin = process.stdin;
         const stdout = process.stdout;
         const wasRaw = stdin.isRaw;
+        const continueIndex = options.length;
         const clearScreen = () => {
             stdout.write("\x1b[2J\x1b[H");
         };
+        const selectedCount = () => options.filter((option) => option.checked).length;
         const render = () => {
             clearScreen();
-            stdout.write("Optional local client setup\n");
-            stdout.write("Use ↑/↓ to move, Space to toggle, Enter to continue.\n\n");
+            stdout.write("Choose local clients to configure\n");
+            stdout.write(`Use ↑/↓ to move, Enter to toggle the highlighted integration, or press 1-${options.length} to toggle directly.\n`);
+            stdout.write("Move to Continue and press Enter when you're ready.\n\n");
             for (const [index, option] of options.entries()) {
                 const pointer = index === cursor ? ">" : " ";
-                const mark = option.checked ? "[x]" : "[ ]";
-                const badge = option.recommended ? "recommended" : "optional";
-                stdout.write(`${pointer} ${mark} ${option.label}  ${badge}\n`);
+                const mark = option.detected ? (option.checked ? "[x]" : "[ ]") : "[-]";
+                const badge = option.detected ? (option.recommended ? "recommended" : "optional") : "not detected";
+                stdout.write(`${pointer} ${index + 1}. ${mark} ${option.label}  ${badge}\n`);
             }
-            stdout.write("\n");
+            const continuePointer = cursor === continueIndex ? ">" : " ";
+            stdout.write(`${continuePointer} Continue with ${selectedCount()} selected integration${selectedCount() === 1 ? "" : "s"}\n`);
+            stdout.write(`\n${hint}\n`);
         };
         const finish = () => {
             if (settled)
@@ -238,34 +243,66 @@ async function promptForOptionalClients(clients) {
             const finalSelection = new Set(options.filter((option) => option.checked).map((option) => option.id));
             resolve(finalSelection);
         };
+        const toggleOption = (index) => {
+            const option = options[index];
+            if (!option)
+                return;
+            cursor = index;
+            if (!option.detected) {
+                hint = `${option.label} is not detected on this machine yet, so it cannot be selected.`;
+                render();
+                return;
+            }
+            option.checked = !option.checked;
+            hint = `${option.label} ${option.checked ? "selected" : "cleared"}.`;
+            render();
+        };
         const onKeypress = (_str, key) => {
             if (key.ctrl && key.name === "c") {
                 stdout.write("\x1b[?25h");
                 process.exit(130);
             }
             if (key.name === "up" || key.name === "k") {
-                cursor = (cursor - 1 + options.length) % options.length;
+                cursor = (cursor - 1 + options.length + 1) % (options.length + 1);
                 render();
                 return;
             }
             if (key.name === "down" || key.name === "j") {
-                cursor = (cursor + 1) % options.length;
+                cursor = (cursor + 1) % (options.length + 1);
                 render();
                 return;
             }
             if (key.name === "space") {
-                options[cursor].checked = !options[cursor].checked;
-                render();
+                if (cursor === continueIndex) {
+                    finish();
+                    return;
+                }
+                toggleOption(cursor);
+                return;
+            }
+            const directSelection = Number.parseInt(key.sequence ?? "", 10);
+            if (Number.isInteger(directSelection) && directSelection >= 1 && directSelection <= options.length) {
+                toggleOption(directSelection - 1);
                 return;
             }
             if (key.name === "a") {
-                const nextValue = options.some((option) => !option.checked);
-                for (const option of options)
+                const detectedOptions = options.filter((option) => option.detected);
+                const nextValue = detectedOptions.some((option) => !option.checked);
+                for (const option of detectedOptions)
                     option.checked = nextValue;
+                hint = `${nextValue ? "Selected" : "Cleared"} all detected integrations.`;
                 render();
                 return;
             }
             if (key.name === "return" || key.name === "enter") {
+                if (cursor === continueIndex) {
+                    finish();
+                    return;
+                }
+                toggleOption(cursor);
+                return;
+            }
+            if (key.name === "c") {
                 finish();
             }
         };
@@ -277,10 +314,10 @@ async function promptForOptionalClients(clients) {
         render();
     });
 }
-function resolveOptionalClientSelection(params) {
-    const { optionalClients, flagSelection, skipPrompt } = params;
+function resolveSetupClientSelection(params) {
+    const { setupClients, flagSelection, skipPrompt } = params;
     if (flagSelection) {
-        for (const client of optionalClients) {
+        for (const client of setupClients) {
             if (!flagSelection.has(client.id))
                 continue;
             if (!client.detected) {
@@ -289,10 +326,10 @@ function resolveOptionalClientSelection(params) {
         }
         return Promise.resolve(flagSelection);
     }
-    const defaults = new Set(optionalClients.filter((client) => client.detected && client.recommended).map((client) => client.id));
+    const defaults = new Set(setupClients.filter((client) => client.detected && client.recommended).map((client) => client.id));
     if (skipPrompt)
         return Promise.resolve(defaults);
-    return promptForOptionalClients(optionalClients);
+    return promptForSetupClients(setupClients);
 }
 async function fetchBackendModelIds(backendUrl, apiKey) {
     const url = `${trimTrailingSlash(backendUrl)}/api/codex-auth/v1/proxy/v1/models`;
@@ -334,6 +371,21 @@ function kiloStorageCandidates() {
     }
     return candidates;
 }
+async function detectCodexClient() {
+    if (hasCommand("codex"))
+        return true;
+    const candidates = [
+        node_path_1.default.join(paths_1.codexDir, "config.toml"),
+        node_path_1.default.join(paths_1.codexDir, "auth.json"),
+        node_path_1.default.join(paths_1.codexDir, "history.jsonl"),
+        node_path_1.default.join(paths_1.codexDir, "sessions"),
+    ];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate))
+            return true;
+    }
+    return false;
+}
 async function detectKiloClient() {
     if (hasCommand("kilo"))
         return true;
@@ -691,155 +743,184 @@ class SetupCommand extends base_command_1.BaseCommand {
                 throw new Error('API key is required. Run "theclawbay setup --api-key <key>".');
             const backendRaw = flags.backend ?? (0, api_key_1.tryInferBackendUrlFromApiKey)(apiKey) ?? managed?.backendUrl ?? DEFAULT_BACKEND_URL;
             const backendUrl = normalizeUrl(backendRaw, "--backend");
-            await (0, config_1.writeManagedConfig)({ backendUrl, apiKey });
-            const resolved = await resolveModels(backendUrl, apiKey);
-            const codexConfigPath = await writeCodexConfig({ backendUrl, model: resolved.model, apiKey });
-            const updatedShellFiles = await persistApiKeyEnv(apiKey);
-            const updatedVsCodeEnvFiles = await persistVsCodeServerEnvSource();
-            const sessionMigration = await (0, codex_history_migration_1.migrateSessionProviders)({
-                codexHome: paths_1.codexDir,
-                migrationStateFile: MIGRATION_STATE_FILE,
-                neutralizeSources: HISTORY_PROVIDER_NEUTRALIZE_SOURCES,
-            });
-            const authSeed = await (0, codex_auth_seeding_1.ensureCodexApiKeyAuth)({
-                codexHome: paths_1.codexDir,
-                apiKey,
-            });
-            const stateDbMigration = await (0, codex_history_migration_1.migrateStateDbProviders)({
-                codexHome: paths_1.codexDir,
-                targetProvider: DEFAULT_PROVIDER_ID,
-                sourceProviders: HISTORY_PROVIDER_DB_MIGRATE_SOURCES,
-            });
-            const modelCacheMigration = await (0, codex_model_cache_migration_1.ensureCodexModelCacheHasGpt54)({
-                codexHome: paths_1.codexDir,
-            });
-            const optionalClients = [
+            const [codexDetected, kiloDetected, traeDetected] = await Promise.all([
+                detectCodexClient(),
+                detectKiloClient(),
+                detectTraeClient(),
+            ]);
+            const setupClients = [
+                {
+                    id: "codex",
+                    label: "Codex CLI, VS Code extension, and Codex app",
+                    detected: codexDetected,
+                    recommended: true,
+                },
                 {
                     id: "openclaw",
                     label: "OpenClaw",
                     detected: hasCommand("openclaw"),
                     recommended: true,
-                    command: "openclaw",
                 },
                 {
                     id: "opencode",
                     label: "OpenCode",
                     detected: hasCommand("opencode"),
                     recommended: true,
-                    command: "opencode",
                 },
                 {
                     id: "kilo",
                     label: "Kilo Code",
-                    detected: await detectKiloClient(),
+                    detected: kiloDetected,
                     recommended: true,
-                    command: "kilo",
                 },
                 {
                     id: "trae",
                     label: "Trae (experimental)",
-                    detected: await detectTraeClient(),
+                    detected: traeDetected,
                     recommended: false,
-                    command: "Trae",
                 },
             ];
-            const selectedOptionalClients = await resolveOptionalClientSelection({
-                optionalClients,
-                flagSelection: parseOptionalClientFlags(flags.clients),
+            const selectedSetupClients = await resolveSetupClientSelection({
+                setupClients,
+                flagSelection: parseSetupClientFlags(flags.clients),
                 skipPrompt: flags.yes,
             });
+            let resolved = null;
+            if (selectedSetupClients.size > 0) {
+                resolved = await resolveModels(backendUrl, apiKey);
+            }
+            await (0, config_1.writeManagedConfig)({ backendUrl, apiKey });
+            const updatedShellFiles = await persistApiKeyEnv(apiKey);
+            let codexConfigPath = null;
+            let updatedVsCodeEnvFiles = [];
+            let sessionMigration = null;
+            let authSeed = null;
+            let stateDbMigration = null;
+            let modelCacheMigration = null;
             let openClawConfigPath = null;
             let openClawCliWarning = null;
             let openCodePath = null;
             let kiloConfigPath = null;
             let traeBundlePathPatched = null;
-            if (selectedOptionalClients.has("openclaw")) {
+            if (selectedSetupClients.has("codex")) {
+                codexConfigPath = await writeCodexConfig({ backendUrl, model: resolved?.model ?? DEFAULT_CODEX_MODEL, apiKey });
+                updatedVsCodeEnvFiles = await persistVsCodeServerEnvSource();
+                sessionMigration = await (0, codex_history_migration_1.migrateSessionProviders)({
+                    codexHome: paths_1.codexDir,
+                    migrationStateFile: MIGRATION_STATE_FILE,
+                    neutralizeSources: HISTORY_PROVIDER_NEUTRALIZE_SOURCES,
+                });
+                authSeed = await (0, codex_auth_seeding_1.ensureCodexApiKeyAuth)({
+                    codexHome: paths_1.codexDir,
+                    apiKey,
+                });
+                stateDbMigration = await (0, codex_history_migration_1.migrateStateDbProviders)({
+                    codexHome: paths_1.codexDir,
+                    targetProvider: DEFAULT_PROVIDER_ID,
+                    sourceProviders: HISTORY_PROVIDER_DB_MIGRATE_SOURCES,
+                });
+                modelCacheMigration = await (0, codex_model_cache_migration_1.ensureCodexModelCacheHasGpt54)({
+                    codexHome: paths_1.codexDir,
+                });
+            }
+            if (selectedSetupClients.has("openclaw")) {
                 const openClawResult = await setupOpenClaw({
                     backendUrl,
-                    model: resolved.model,
-                    models: resolved.models,
+                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
                     apiKey,
                 });
                 openClawConfigPath = openClawResult.configPath;
                 openClawCliWarning = openClawResult.cliWarning ?? null;
             }
-            if (selectedOptionalClients.has("opencode")) {
+            if (selectedSetupClients.has("opencode")) {
                 openCodePath = await writeOpenCodeConfig({
                     backendUrl,
-                    model: resolved.model,
-                    models: resolved.models,
+                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
                     apiKey,
                 });
             }
-            if (selectedOptionalClients.has("kilo")) {
+            if (selectedSetupClients.has("kilo")) {
                 kiloConfigPath = await writeKiloConfig({
                     backendUrl,
-                    model: resolved.model,
-                    models: resolved.models,
+                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
                     apiKey,
                 });
             }
-            if (selectedOptionalClients.has("trae")) {
+            if (selectedSetupClients.has("trae")) {
                 traeBundlePathPatched = await patchTraeBundle({
                     backendUrl,
-                    model: resolved.model,
+                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
                     apiKey,
-                    models: resolved.models,
+                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
                 });
             }
             this.log("Setup complete");
             this.log(`- Managed config: ${paths_1.managedConfigPath}`);
             this.log(`- Backend: ${backendUrl}`);
-            this.log(`- Codex config: ${codexConfigPath}`);
-            this.log(`- Codex model: ${resolved.model}`);
-            this.log("- Recommended base setup: Codex CLI, Codex VS Code extension, and the Codex app");
-            if (resolved.note)
-                this.log(resolved.note);
-            if (sessionMigration.rewritten > 0) {
-                this.log(`- Conversations: updated ${sessionMigration.rewritten}/${sessionMigration.scanned} local sessions for cross-provider visibility.`);
-            }
-            else if (sessionMigration.fastSkipped) {
-                this.log("- Conversations: already migrated (fast check).");
-            }
-            else {
-                this.log("- Conversations: no local sessions required migration.");
-            }
-            if (sessionMigration.retimed > 0) {
-                this.log(`- Conversation ordering: repaired timestamps on ${sessionMigration.retimed} local sessions.`);
+            if (selectedSetupClients.size === 0) {
+                this.log("- Local clients: none selected; saved managed config and API key env only.");
             }
-            if (stateDbMigration.updated > 0) {
-                this.log(`- Conversation cache: relabeled ${stateDbMigration.updated} local Codex history rows for The Claw Bay.`);
-            }
-            else if (stateDbMigration.failed.length > 0) {
-                const detail = stateDbMigration.warning ? ` ${stateDbMigration.warning}` : "";
-                this.log(`- Conversation cache: could not update local Codex history DB.${detail}`);
-            }
-            if (modelCacheMigration.action === "seeded") {
-                this.log("- Codex model cache: added GPT-5.4 to the local picker cache.");
-            }
-            else if (modelCacheMigration.action === "created") {
-                this.log("- Codex model cache: created a local picker cache with GPT-5.4.");
-            }
-            else if (modelCacheMigration.action === "refreshed") {
-                this.log("- Codex model cache: refreshed the local picker cache for GPT-5.4.");
-            }
-            else if (modelCacheMigration.action === "already_seeded") {
-                this.log("- Codex model cache: GPT-5.4 was already seeded locally.");
-            }
-            else if (modelCacheMigration.action === "already_present") {
-                this.log("- Codex model cache: GPT-5.4 already existed locally.");
-            }
-            else if (modelCacheMigration.warning) {
-                this.log(`- Codex model cache: ${modelCacheMigration.warning}`);
+            if (resolved?.note)
+                this.log(resolved.note);
+            this.log(`- API key env: ${ENV_FILE}`);
+            this.log(`- Shell profiles updated: ${updatedShellFiles.join(", ")}`);
+            if (selectedSetupClients.has("codex")) {
+                this.log(`- Codex: configured (${codexConfigPath})`);
+                if (resolved)
+                    this.log(`- Codex model: ${resolved.model}`);
+                this.log(`- VS Code env hooks updated: ${updatedVsCodeEnvFiles.join(", ")}`);
+                if (sessionMigration?.rewritten) {
+                    this.log(`- Conversations: updated ${sessionMigration.rewritten}/${sessionMigration.scanned} local sessions for cross-provider visibility.`);
+                }
+                else if (sessionMigration?.fastSkipped) {
+                    this.log("- Conversations: already migrated (fast check).");
+                }
+                else if (sessionMigration) {
+                    this.log("- Conversations: no local sessions required migration.");
+                }
+                if ((sessionMigration?.retimed ?? 0) > 0) {
+                    this.log(`- Conversation ordering: repaired timestamps on ${sessionMigration?.retimed ?? 0} local sessions.`);
+                }
+                if ((stateDbMigration?.updated ?? 0) > 0) {
+                    this.log(`- Conversation cache: relabeled ${stateDbMigration?.updated ?? 0} local Codex history rows for The Claw Bay.`);
+                }
+                else if ((stateDbMigration?.failed.length ?? 0) > 0) {
+                    const detail = stateDbMigration?.warning ? ` ${stateDbMigration.warning}` : "";
+                    this.log(`- Conversation cache: could not update local Codex history DB.${detail}`);
+                }
+                if (modelCacheMigration?.action === "seeded") {
+                    this.log("- Codex model cache: added GPT-5.4 to the local picker cache.");
+                }
+                else if (modelCacheMigration?.action === "created") {
+                    this.log("- Codex model cache: created a local picker cache with GPT-5.4.");
+                }
+                else if (modelCacheMigration?.action === "refreshed") {
+                    this.log("- Codex model cache: refreshed the local picker cache for GPT-5.4.");
+                }
+                else if (modelCacheMigration?.action === "already_seeded") {
+                    this.log("- Codex model cache: GPT-5.4 was already seeded locally.");
+                }
+                else if (modelCacheMigration?.action === "already_present") {
+                    this.log("- Codex model cache: GPT-5.4 already existed locally.");
+                }
+                else if (modelCacheMigration?.warning) {
+                    this.log(`- Codex model cache: ${modelCacheMigration.warning}`);
+                }
+                else if (modelCacheMigration) {
+                    this.log("- Codex model cache: no change.");
+                }
+            }
+            else if (codexDetected) {
+                this.log("- Codex: detected but skipped");
             }
             else {
-                this.log("- Codex model cache: no change.");
+                this.log("- Codex: not detected (skipped)");
             }
-            this.log(`- API key env: ${ENV_FILE}`);
-            this.log(`- Shell profiles updated: ${updatedShellFiles.join(", ")}`);
-            this.log(`- VS Code env hooks updated: ${updatedVsCodeEnvFiles.join(", ")}`);
-            const openClawDetected = optionalClients.find((client) => client.id === "openclaw")?.detected ?? false;
-            if (selectedOptionalClients.has("openclaw")) {
+            const openClawDetected = setupClients.find((client) => client.id === "openclaw")?.detected ?? false;
+            if (selectedSetupClients.has("openclaw")) {
                 this.log(`- OpenClaw: configured (${openClawConfigPath})`);
                 if (openClawCliWarning)
                     this.log(`- OpenClaw: ${openClawCliWarning}`);
@@ -850,8 +931,8 @@ class SetupCommand extends base_command_1.BaseCommand {
             else {
                 this.log("- OpenClaw: not detected (skipped)");
             }
-            const openCodeDetected = optionalClients.find((client) => client.id === "opencode")?.detected ?? false;
-            if (selectedOptionalClients.has("opencode")) {
+            const openCodeDetected = setupClients.find((client) => client.id === "opencode")?.detected ?? false;
+            if (selectedSetupClients.has("opencode")) {
                 this.log(`- OpenCode: configured (${openCodePath})`);
             }
             else if (openCodeDetected) {
@@ -860,8 +941,7 @@ class SetupCommand extends base_command_1.BaseCommand {
             else {
                 this.log("- OpenCode: not detected (skipped)");
             }
-            const kiloDetected = optionalClients.find((client) => client.id === "kilo")?.detected ?? false;
-            if (selectedOptionalClients.has("kilo")) {
+            if (selectedSetupClients.has("kilo")) {
                 this.log(`- Kilo Code: configured (${kiloConfigPath})`);
             }
             else if (kiloDetected) {
@@ -870,10 +950,9 @@ class SetupCommand extends base_command_1.BaseCommand {
             else {
                 this.log("- Kilo Code: not detected (skipped)");
             }
-            const traeDetected = optionalClients.find((client) => client.id === "trae")?.detected ?? false;
-            if (selectedOptionalClients.has("trae")) {
+            if (selectedSetupClients.has("trae")) {
                 this.log(`- Trae: experimental bundle patch installed (${traeBundlePathPatched})`);
-                this.log(`- Trae: replaced Builder and SoloCoder model lists with ${resolved.models.length} TheClawBay models.`);
+                this.log(`- Trae: replaced Builder and SoloCoder model lists with ${resolved?.models.length ?? 1} TheClawBay models.`);
                 this.log(`- Trae: restart Trae and select a TheClawBay model inside Trae to test it.`);
             }
             else if (traeDetected) {
@@ -882,22 +961,22 @@ class SetupCommand extends base_command_1.BaseCommand {
             else {
                 this.log("- Trae: not detected (skipped)");
             }
-            if (authSeed.action === "seeded") {
+            if (authSeed?.action === "seeded") {
                 this.log("- Codex login state: seeded local API-key auth for Codex UI.");
             }
-            else if (authSeed.action === "updated") {
+            else if (authSeed?.action === "updated") {
                 this.log("- Codex login state: refreshed the Claw Bay API-key auth seed.");
             }
-            else if (authSeed.action === "already_seeded") {
+            else if (authSeed?.action === "already_seeded") {
                 this.log("- Codex login state: the Claw Bay API-key auth was already seeded.");
             }
-            else if (authSeed.action === "already_present") {
+            else if (authSeed?.action === "already_present") {
                 this.log("- Codex login state: preserved existing local Codex auth.");
             }
-            else if (authSeed.warning) {
+            else if (authSeed?.warning) {
                 this.log(`- Codex login state: ${authSeed.warning}`);
             }
-            else {
+            else if (authSeed) {
                 this.log("- Codex login state: no change.");
             }
             this.log("Next: restart terminal/VS Code window only if you rely on the The Claw Bay API key in your own scripts.");
@@ -917,7 +996,7 @@ SetupCommand.flags = {
     }),
     clients: core_1.Flags.string({
         required: false,
-        description: "Optional detected add-ons to configure: codex, openclaw, opencode, kilo, trae",
+        description: "Detected local clients to configure: codex, openclaw, opencode, kilo, trae",
     }),
     yes: core_1.Flags.boolean({
         required: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theclawbay",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "description": "CLI for connecting Codex, OpenClaw, OpenCode, Kilo, and experimental Trae to The Claw Bay.",
   "license": "MIT",
   "bin": {