dsh-ssh-tui 0.6.2 → 0.6.4

package/lib/tui.js

@@ -29,8 +29,11 @@ import { commandAcceptsAttachments, forEachSessionEventAsync, isAssistantStreamE
 import { classifyApprovalDetailed, commandForApprovalRequest, isApprovalStatusArg, parseAutoApprovalMode } from './auto-approval.js';
 import { buildReviewUserMessage, parseReviewOutput, reviewSystemPrompt } from './approval-reviewer.js';
 import { loadProviderCatalog, mergeProviderEntries } from './provider-catalog.js';
+import { catalogContextWindow, catalogWindowIndex, suggestedRouteContextWindow, } from './context-window.js';
 import { formatFooterCwd } from './session-list.js';
 import { collectDiag, formatDiag } from './diag.js';
+import { presetLabel, profileFromArgv } from './preset-label.js';
+import { ensureRosterRows, rosterPatchPath } from './preset-rows.js';
 import { SessionStatsTracker, statsRowOf } from './stats.js';
 import { QUESTION_OPTION_KEYS, confirmAnswer, inspectClosesOn, moveQuestionCursor, optionsLength, questionSubmit, selectQuestionOptionByKey, } from './dialogs.js';
 import { commandSuggestions, localizedCommands } from './commands.js';
@@ -49,13 +52,13 @@ import { clipAnsiToWidth, hrefAtColumn, osc52Clipboard, paintedLinkHits, cursorV
 import { captureHangupSignals, composePaintOutput, detectSshSession, formatLinkQualityChip, HANGUP_CANCEL_TIMEOUT_MS, ignoreFurtherHangupSignals, isEscapePrefix, isHangupErrno, parseCursorPositionReply, PICKER_WINDOW, pickerWindowStart, probeTerminalRttMs, releaseHangupSignals, resolvePaintIntervalMs, waitUntilIdleOrTimeout, } from './paint.js';
 import { TerminalInputGuard } from './terminal-input.js';
 import { contextPressureAlertText, contextPressureRingColor, contextPressureView, formatContextPressureRing, describeProviderRoute, fitFooterStatsLine, fitFooterStatusLine, footerActivity, footerIdentityParts, footerStatsGroups, formatContextPressureChip, formatStatusReport, formatTokens, parseContextPressure, promptPressureTokens, providerUsesLocalOAuth, shouldIdleAutoCompact, } from './footer.js';
-import { crossedQuotaThresholds, DEEPSEEK_PUBLIC_BASE_URL, formatAccountBalance, formatFooterBalance, formatQuotaSnapshot, joinUrl, OPENAI_COMPAT_BALANCE_PATHS, OPENCODE_GO_USAGE_URL, OPENCODE_ZEN_BASE_URL, openCodeApiErrorMessage, openCodeSourceFor, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, quotaAlertText, quotaRefreshEverySteps, reasoningEffortsForDefault, SUPERGROK_BILLING_URL, tightestQuotaWindow, } from './quota.js';
+import { COMMAND_CODE_CREDITS_URL, COMMAND_CODE_SUBSCRIPTIONS_URL, COMMAND_CODE_USAGE_URL, commandCodePeriodStart, commandCodeSourceFor, crossedQuotaThresholds, DEEPSEEK_PUBLIC_BASE_URL, formatAccountBalance, formatFooterBalance, formatQuotaSnapshot, joinUrl, OPENAI_COMPAT_BALANCE_PATHS, OPENCODE_GO_USAGE_URL, OPENCODE_ZEN_BASE_URL, openCodeApiErrorMessage, openCodeSourceFor, parseCommandCodeQuota, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, quotaAlertText, quotaRefreshEverySteps, reasoningEffortsForDefault, SUPERGROK_BILLING_URL, tightestQuotaWindow, } from './quota.js';
 import { appendSubagentLog, applyTurnEndToPlan, cardCategoryLabel, cardCategoryOf, compactionHeaderText, formatCompactCommandError, isPromptInjectionMessage, matchTranscriptRows, parseFindQuery, parsePlanTodos, planCloseNudgeText, planMarkdownFromArgs, planDockNote, planIsLive, planTitleFromMarkdown, promptInjectionSources, promptInjectionTitle, subagentHeaderText, todoItemKind, todoProgressLabel, TODO_STATUS_MARK, } from './plan.js';
 import { buildToolHeader, compactEditPath, compactToolBursts, countDiffAddDel, countDiffLines, countOutputLines, diffMetaDiffs, diffStatToken, formatModelList, HIDDEN_TOOL_NAMES, parseExitStatus, planReviewOf, presentToolCall, READ_TOOL_NAMES, SHELL_TOOL_NAMES, toolBodyFitsWorkspace, toolBodyLines, toolTitle, wrappedToolBodyLineCount, } from './tool-present.js';
 export { clipAnsiToWidth, cursorVisualPosition, displayWidth, foldInputView, hrefAtColumn, osc52Clipboard, osc8Enabled, paintedLinkHits, fmtElapsedCompact, padAnsiToWidth, padToWidth, renderMarkdownLines, repeatToWidth, shimmerText, truncateToWidth, visibleWidth, waitCardCopy, waitSummaryFromReasoning, wrapWaitDetails, } from './term-text.js';
 export { captureHangupSignals, composePaintOutput, detectSshSession, formatLinkQualityChip, ignoreFurtherHangupSignals, isEscapePrefix, findCursorPositionReply, isHangupErrno, linkQualityOf, linkSignalPips, paintIntervalForRtt, paintLinkLabel, parseCursorPositionReply, pickerWindowStart, probeTerminalRttMs, releaseHangupSignals, resolvePaintIntervalMs, waitUntilIdleOrTimeout, writeBootSplash, } from './paint.js';
 export { CONTEXT_IDLE_COMPACT_RATIO, CONTEXT_PRESSURE_DANGER_RATIO, CONTEXT_PRESSURE_WARN_RATIO, CONTEXT_RING_EMPTY, CONTEXT_RING_SEGMENTS, contextPressureAlertText, contextPressureRingColor, contextPressureUsedTokens, contextPressureView, describeProviderRoute, dropFooterQuotaPlanName, fitFooterStatsLine, fitFooterStatusLine, footerActivity, footerIdentityParts, footerStatsGroups, formatContextPressureChip, formatContextPressureRing, formatContextPressureStatusLine, formatDuration, formatFooterQuota, formatQuotaBar, formatStatusReport, formatTokens, formatTokensPerSecond, parseContextPressure, promptPressureTokens, providerShortCode, providerUsesLocalOAuth, shouldIdleAutoCompact, subagentRouteLabel, } from './footer.js';
-export { crossedQuotaThresholds, formatAccountBalance, formatFooterBalance, formatOpenCodeGoUsage, formatQuotaSnapshot, formatQuotaStatusLine, joinUrl, openCodeSourceFor, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, quotaAlertText, quotaRefreshEverySteps, quotaRefreshEveryTurns, remainingPercentFromUsed, tightestQuotaWindow, } from './quota.js';
+export { commandCodePeriodStart, commandCodeSourceFor, crossedQuotaThresholds, formatAccountBalance, formatFooterBalance, formatOpenCodeGoUsage, formatQuotaSnapshot, formatQuotaStatusLine, joinUrl, openCodeSourceFor, parseCommandCodeQuota, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, quotaAlertText, quotaRefreshEverySteps, quotaRefreshEveryTurns, remainingPercentFromUsed, tightestQuotaWindow, } from './quota.js';
 export { commandAcceptsAttachments, forEachSessionEvent, isAssistantStreamEvent, isTokenDeltaChunk, listPersistenceHeaders, inspectPersistenceSession, sessionEventType, sessionEvents, settingsNamespace, streamChunkOf, streamFirstTokenTime, streamFrameAttemptId, streamFrameOwner, } from './dsh-compat.js';
 export { applyTurnEndToPlan, askSummary, cardCategoryOf, compactionHeaderText, formatCompactCommandError, isPromptInjectionMessage, matchTranscriptRows, parseFindQuery, parsePlanTodos, planCloseNudgeText, planDockNote, planIsLive, planTitleFromMarkdown, planTurnLeftOpen, promptInjectionSources, promptInjectionTitle, subagentHeaderText, todoProgressLabel, todoSummary, } from './plan.js';
 export { buildToolHeader, canMergeToolCall, compactEditPath, compactToolBursts, compactToolGroups, countDiffAddDel, countDiffLines, countOutputLines, diffMetaDiffs, diffStatToken, friendlyJsonLines, parseExitStatus, presentToolCall, READ_TOOL_NAMES, renderToolDiff, toolBodyFitsWorkspace, toolBodyLines, toolStateColor, toolStateLabel, wrappedToolBodyLineCount, } from './tool-present.js';
@@ -79,6 +82,12 @@ function installUserQuestionAnswerer(ctx, questions, ask) {
     });
 }
 const ROUTE_MEMORY_NS = ROUTE_MEMORY_NAMESPACE;
+/**
+ * The window llm-pi-ai falls back to when neither a model entry nor the
+ * installed catalog sizes a model. The wizard pre-fills it only so a route
+ * whose capacity nothing could discover still shows the number it will use.
+ */
+const HARNESS_DEFAULT_CONTEXT_WINDOW = 262_144;
 function providerTemplates() {
     return {
         official: {
@@ -94,6 +103,16 @@ function providerTemplates() {
             api: 'openai-responses',
             defaultModels: ['deepseek-v4-flash', 'deepseek-v4-pro'],
         },
+        // A fixed provider: its chat route is OpenAI-completions, but billing uses
+        // Command Code's own `/alpha/billing/credits` surface on the API root.
+        'command-code': {
+            label: t('onboard.providerCommandCode'),
+            defaultId: 'command-code',
+            defaultBaseUrl: 'https://api.commandcode.ai/provider/v1',
+            api: 'openai-completions',
+            defaultModels: ['deepseek/deepseek-v4.1-flash'],
+            defaultModelCapacity: { 'deepseek/deepseek-v4.1-flash': { contextWindow: 1_048_576 } },
+        },
         'openai-completions': {
             label: t('onboard.providerCompletions'),
             defaultId: 'my-gateway',
@@ -327,6 +346,62 @@ function effortChoices(ids) {
 function undeclaredEffortChoices() {
     return effortChoices(UNDECLARED_EFFORT_IDS);
 }
+/**
+ * The `reasoningEfforts` map `/setup` writes for a hand-declared
+ * OpenAI-compatible route.
+ *
+ * Such a route is absent from pi-ai's catalog, so `defaultReasoningEffort`
+ * resolves nothing before the profile is saved and the model would land as a
+ * bare `{ id }` entry. The Harness then reports that model as non-reasoning
+ * (`levels [off]`) and refuses every effort the TUI itself offers for an
+ * undeclared model. Declaring the offered vocabulary up front keeps the model
+ * dispatchable; no parameter is sent until an effort is selected.
+ * @returns the level-to-wire map, with `off` meaning "send no parameter".
+ */
+export function handDeclaredReasoningEfforts() {
+    return {
+        off: null,
+        ...Object.fromEntries(UNDECLARED_EFFORT_IDS.filter(id => id !== 'off').map(id => [id, id])),
+    };
+}
+/**
+ * Whether a wizard template speaks the OpenAI completions dialect whose
+ * `reasoning_effort` the TUI may declare without a catalog.
+ *
+ * The Responses dialect maps levels too, but its unset state materializes as
+ * `reasoning: { effort: "none" }`, which a custom gateway need not accept, so
+ * it keeps the existing undeclared behavior until an endpoint verifies it.
+ * @param providerType - the wizard template under test.
+ */
+function declaresOfferedReasoning(providerType) {
+    return providerType === 'openai-completions' || providerType === 'command-code';
+}
+/**
+ * The `reasoningEfforts` map `/setup` persists for one model entry.
+ *
+ * A hand-declared OpenAI-compatible completions route always receives the
+ * offered vocabulary; a catalog-backed route keeps whatever live model info
+ * resolved, preserving the existing behavior of redeclaring only the chosen
+ * default.
+ * @param providerType - the wizard template that produced the route.
+ * @param defaultEffort - the level resolved from live model info, if any.
+ * @returns the level-to-wire map, or `undefined` to declare nothing.
+ */
+export function onboardingReasoningEfforts(providerType, defaultEffort) {
+    if (declaresOfferedReasoning(providerType)) {
+        return handDeclaredReasoningEfforts();
+    }
+    return defaultEffort === undefined ? undefined : { off: null, [defaultEffort]: defaultEffort };
+}
+/** The id of one configured llm-pi-ai models entry, in either stored form. */
+function modelEntryId(raw) {
+    if (typeof raw === 'string')
+        return raw;
+    if (typeof raw === 'object' && raw !== null && typeof raw.id === 'string') {
+        return raw.id;
+    }
+    return undefined;
+}
 function localOAuthEffortChoices(modelId) {
     return effortChoices(modelId === 'grok-4.6'
         ? ['off', 'low', 'medium', 'high', 'xhigh']
@@ -369,6 +444,8 @@ export class SshTui {
     /** Web-aligned provider presets from the host's pi-ai catalog (undefined until loaded / when unreachable). */
     catalogPresets;
     catalogLoad;
+    /** Memoized id→window index over {@link catalogPresets}. */
+    catalogWindows;
     input = '';
     cursor = 0;
     inputFolded = false;
@@ -417,7 +494,7 @@ export class SshTui {
     disposers = [];
     userQuestionDisposer;
     presetId = 'standard';
-    presetName = t('mode.standard');
+    presetName = t('mode.preset.standard');
     useAlternateScreen;
     agentGone = false;
     onboarding;
@@ -531,7 +608,7 @@ export class SshTui {
         this.headlessDisplay = config.headlessDisplay === true;
         this.disconnectPolicy = config.disconnectPolicy ?? this.readDisconnectPolicy();
         this.presetId = config.presetId ?? 'standard';
-        this.presetName = config.presetName ?? this.presetId;
+        this.presetName = presetLabel(this.presetId, config.presetName, config.presetTrust);
         this.useAlternateScreen = process.env.DSH_TUI_NO_ALT_SCREEN !== '1' && process.env.DSH_TUI_NO_ALT_SCREEN !== 'true';
         this.paintLink = detectSshSession() ? 'ssh' : 'local';
         this.paintIntervalMs = resolvePaintIntervalMs(config.paintIntervalMs, process.env, {
@@ -540,6 +617,13 @@ export class SshTui {
         this.pushRow({ kind: 'brand-logo' });
         this.pushRow({ kind: 'system', text: t('boot.banner') });
         this.pushRow({ kind: 'system', text: t('boot.help') });
+        // The roster is a profile-layer row, so an install that predates it (or an
+        // in-app update, which only runs `dsh plugin add`) boots without one. Say
+        // so at boot: the banner's localized default hides the missing service, and
+        // the loss is not only `/mode` — the preset-owned tools are absent too.
+        if (this.ctx.get('agentPresets') === undefined) {
+            this.pushRow({ kind: 'system', text: t('mode.bootMissing') });
+        }
         if (config.cwdNotice !== undefined && config.cwdNotice !== '') {
             this.pushRow({ kind: /进入|Entered/u.test(config.cwdNotice) ? 'system' : 'error', text: config.cwdNotice });
         }
@@ -1028,6 +1112,7 @@ export class SshTui {
                 baseUrl: '',
                 key: '',
                 models: [],
+                modelCapacity: new Map(),
                 catalogPresets: undefined,
                 catalog: undefined,
                 providerCursor: 0,
@@ -2447,6 +2532,15 @@ export class SshTui {
                                 addDialog(t('onboard.modelsCatalogHint'));
                             addDialog(t('onboard.enterEsc'));
                             break;
+                        case 'context':
+                            addDialog(t('onboard.providerLine', { label: providerLabel }));
+                            addDialog(t('onboard.contextPrompt'));
+                            addDialog(t('onboard.contextValue', {
+                                value: String(ob.routeContextWindow ?? HARNESS_DEFAULT_CONTEXT_WINDOW),
+                            }));
+                            addDialog(t('onboard.contextHint'));
+                            addDialog(t('onboard.enterEsc'));
+                            break;
                         case 'confirm':
                             addDialog(t('onboard.confirmTitle'));
                             addDialog(t('onboard.confirmProvider', { label: providerLabel }));
@@ -2456,6 +2550,9 @@ export class SshTui {
                                 api: template.api ?? (ob.providerType === 'catalog' ? t('onboard.apiCatalog') : 'deepseek-official'),
                             }));
                             addDialog(t('onboard.confirmModels', { list: formatModelList(ob.models, 8) }));
+                            if (ob.routeContextWindow !== undefined) {
+                                addDialog(t('onboard.confirmContext', { value: String(ob.routeContextWindow) }));
+                            }
                             addDialog(t('onboard.confirmKey', {
                                 head: sliceCodePoints(ob.key, 6),
                                 tail: lastCodePoints(ob.key, 4),
@@ -4431,6 +4528,14 @@ export class SshTui {
         if (ids.has(modelId))
             return true;
         const modelEntry = { id: modelId };
+        // A model added here skips the wizard, so size it from the installed
+        // catalog the same way `/setup` does; the route default covers a miss.
+        const catalogWindows = this.catalogWindowIndexSource();
+        if (catalogWindows.size > 0) {
+            const contextWindow = catalogContextWindow(modelId, catalogWindows);
+            if (contextWindow !== undefined)
+                modelEntry.contextWindow = contextWindow;
+        }
         const reasoningEfforts = reasoningEffortsForDefault(profile.reasoning);
         if (reasoningEfforts !== undefined)
             modelEntry.reasoningEfforts = reasoningEfforts;
@@ -4682,6 +4787,8 @@ export class SshTui {
             })),
         }, 0, 1, currentIndex);
         const effort = choices.find(option => option.label === effortAnswer.selected[0])?.id;
+        if (isUndeclared && effort !== undefined)
+            await this.declareReasoningEffort(provider, modelId, effort);
         const next = {
             provider,
             model: modelId,
@@ -4977,7 +5084,61 @@ export class SshTui {
             return;
         await this.setReasoningEffort(provider, modelId, picked.id, isUndeclared);
     }
+    /**
+     * Persist one explicitly chosen level as a model's `reasoningEfforts`.
+     *
+     * `/effort` offers `low`…`max` for a model whose route declares nothing, but
+     * the selection alone cannot make the request legal: the Harness still
+     * resolves the model as non-reasoning and refuses it. Writing the chosen
+     * level — merged with whatever the entry already declares — keeps the
+     * selection and the declaration consistent. Only a route that explicitly
+     * speaks OpenAI Completions is amended: its dialect omits the parameter for
+     * `off` and was verified against a gateway, while another protocol may
+     * materialize an unset level as a value its endpoint refuses.
+     * @returns whether the entry now declares the level.
+     */
+    async declareReasoningEffort(provider, modelId, effort) {
+        const settings = this.ctx.get('settings');
+        const profile = this.piAiProviderProfile(provider);
+        if (settings === undefined || profile === undefined)
+            return false;
+        if (profile.api !== 'openai-completions')
+            return false;
+        const models = Array.isArray(profile.models) ? [...profile.models] : [];
+        const index = models.findIndex(raw => modelEntryId(raw) === modelId);
+        const existing = index >= 0 && typeof models[index] === 'object' && models[index] !== null
+            ? { ...models[index] }
+            : {};
+        const declared = existing.reasoningEfforts;
+        const efforts = typeof declared === 'object' && declared !== null && !Array.isArray(declared)
+            ? { ...declared }
+            : {};
+        if (efforts[effort] === effort && 'off' in efforts)
+            return true;
+        const entry = {
+            ...existing,
+            id: modelId,
+            reasoningEfforts: { ...efforts, off: null, [effort]: effort },
+        };
+        if (index >= 0)
+            models[index] = entry;
+        else
+            models.push(entry);
+        try {
+            await settings.mutate(settingsNamespace('llm-pi-ai'), [
+                { op: 'set', path: ['providers', provider, 'models'], value: models },
+            ]);
+            return true;
+        }
+        catch (error) {
+            this.pushRow({ kind: 'error', text: t('effort.declareFailed', { provider, model: modelId, error: errorChain(error) }) });
+            this.markDirty();
+            return false;
+        }
+    }
     async setReasoningEffort(provider, modelId, effort, isUndeclared) {
+        if (isUndeclared && effort !== undefined)
+            await this.declareReasoningEffort(provider, modelId, effort);
         const next = {
             provider,
             model: modelId,
@@ -5025,6 +5186,9 @@ export class SshTui {
                 return;
             }
             const targetEffort = parsed.kind === 'default' ? undefined : parsed.id;
+            if (effortOptions.length === 0 && targetEffort !== undefined) {
+                await this.declareReasoningEffort(provider, current.model, targetEffort);
+            }
             const next = {
                 ...current,
                 ...(targetEffort === undefined ? { reasoningEffort: undefined } : { reasoningEffort: ReasoningEffortId(targetEffort) }),
@@ -5064,6 +5228,9 @@ export class SshTui {
         const picked = choices.find(option => option.label === answer.selected[0]);
         if (picked === undefined)
             return;
+        if (effortOptions.length === 0 && picked.id !== undefined) {
+            await this.declareReasoningEffort(provider, current.model, picked.id);
+        }
         const next = {
             ...current,
             ...(picked.id === undefined
@@ -5176,8 +5343,28 @@ export class SshTui {
     /** /mode: pick an agent preset (standard / minimal / ptc / cordis / routing-suite / ...). */
     async runModeCommand(arg = '') {
         const agentPresets = this.ctx.get('agentPresets');
+        const direct = arg.trim().toLowerCase();
+        if (direct === 'fix' || direct === 'repair') {
+            await this.repairRoster();
+            return;
+        }
         if (agentPresets === undefined) {
-            this.pushRow({ kind: 'error', text: t('mode.missingService') });
+            // A terminal profile built on dsh-base composes no roster, and the
+            // plugin's bundle patch may not mount one; only the profile's user layer
+            // can. Report the exact row and offer the in-app repair: the install
+            // scripts are the checkout path, while an npm install and the in-app
+            // `dsh plugin add` update never run them.
+            const profile = profileFromArgv();
+            this.pushRow({
+                kind: 'error',
+                text: [
+                    t('mode.missingService'),
+                    t('mode.missingServiceHint', {
+                        profile,
+                        patch: rosterPatchPath(resolveDshHome(), profile),
+                    }),
+                ].join('\n'),
+            });
             this.markDirty();
             return;
         }
@@ -5187,12 +5374,16 @@ export class SshTui {
             this.markDirty();
             return;
         }
-        const direct = arg.trim().toLowerCase();
-        let selected = direct === ''
-            ? undefined
-            : presets.find(preset => preset.id.toLowerCase() === direct
-                || (preset.name ?? '').toLowerCase() === direct);
-        if (selected === undefined && direct !== '') {
+        // Shipped presets resolve through the TUI dictionary; a user-authored one
+        // keeps the name its own preset.yml published.
+        const labels = presets.map(preset => presetLabel(preset.id, preset.name, preset.trust));
+        const matchesDirect = (preset, label) => preset.id.toLowerCase() === direct
+            || (preset.name ?? '').trim().toLowerCase() === direct
+            || label.toLowerCase() === direct;
+        let index = direct === ''
+            ? -1
+            : presets.findIndex((preset, at) => matchesDirect(preset, labels[at] ?? preset.id));
+        if (index < 0 && direct !== '') {
             this.pushRow({
                 kind: 'error',
                 text: t('mode.unknown', { id: arg.trim(), available: presets.map(preset => preset.id).join(', ') }),
@@ -5200,20 +5391,31 @@ export class SshTui {
             this.markDirty();
             return;
         }
-        if (selected === undefined) {
+        if (index < 0 && direct === '') {
             const answer = await this.askQuestion({
                 id: 'mode-pick',
                 question: t('mode.pick'),
-                options: presets.map(preset => ({
-                    label: preset.name ?? preset.id,
-                    description: `${preset.id === this.presetId ? t('mode.currentPrefix') : ''}${preset.description ?? ''}`.trim(),
+                options: presets.map((preset, at) => ({
+                    label: labels[at] ?? preset.id,
+                    description: `${preset.id === this.presetId ? t('mode.currentPrefix') : ''}${preset.broken === undefined ? preset.description ?? '' : t('mode.brokenSuffix', { reason: preset.broken })}`.trim(),
                 })),
             });
-            selected = presets.find(preset => (preset.name ?? preset.id) === answer.selected[0]);
+            index = labels.indexOf(answer.selected[0] ?? '');
         }
+        if (index < 0)
+            return;
+        const selected = presets[index];
         if (selected === undefined)
             return;
-        const selectedName = selected.name ?? selected.id;
+        if (selected.broken !== undefined) {
+            this.pushRow({
+                kind: 'error',
+                text: t('mode.broken', { name: labels[index] ?? selected.id, reason: selected.broken }),
+            });
+            this.markDirty();
+            return;
+        }
+        const selectedName = labels[index] ?? selected.id;
         const hasWork = sessionEvents(this.agent.session).some(event => event.type === 'turn/start');
         if (!hasWork) {
             await agentPresets.recompose(this.agent.ctx, selected.id);
@@ -5230,6 +5432,28 @@ export class SshTui {
         await this.ctx.get('settings')?.update(settingsNamespace('agent-presets'), { default: selected.id });
         this.markDirty();
     }
+    /**
+     * `/mode fix`: write the roster row into this profile's user patch layer.
+     *
+     * The write only takes effect on the next launch — the loader composes the
+     * patch tree once at boot — so the report says so instead of pretending the
+     * running session gained a roster.
+     */
+    async repairRoster() {
+        const profile = profileFromArgv();
+        const patch = rosterPatchPath(resolveDshHome(), profile);
+        try {
+            const result = await ensureRosterRows(resolveDshHome(), profile);
+            this.pushRow({
+                kind: 'system',
+                text: result === 'present' ? t('mode.fixPresent', { patch }) : t('mode.fixWritten', { patch }),
+            });
+        }
+        catch (error) {
+            this.pushRow({ kind: 'error', text: t('mode.fixFailed', { patch, error: errorChain(error) }) });
+        }
+        this.markDirty();
+    }
     /** Current provider route selected for the running agent. */
     currentProvider() {
         // `agent.options` is authoritative for the launched agent; the selection
@@ -5281,6 +5505,37 @@ export class SshTui {
         }
         return payload;
     }
+    /**
+     * Command Code's quota: the rolling 5h/weekly windows and credit pool off
+     * `/alpha/billing/credits`, enriched by the subscription period and spend.
+     * Only the credits read is required; the two enrichment reads are
+     * best-effort so one failing endpoint cannot hide the windows.
+     * @param source - the recognized Command Code route.
+     */
+    async fetchCommandCodeQuota(source) {
+        const apiKey = await this.resolveCredential(source.apiKeyEnv);
+        if (apiKey === undefined)
+            throw new Error(t('usage.noCred', { env: source.apiKeyEnv }));
+        const headers = { authorization: `Bearer ${apiKey}`, accept: 'application/json' };
+        const credits = await this.fetchJson(COMMAND_CODE_CREDITS_URL, headers, source.label);
+        const subscription = await this.tryFetchJson(COMMAND_CODE_SUBSCRIPTIONS_URL, headers, source.label);
+        const since = commandCodePeriodStart(subscription);
+        const summaryUrl = since === undefined
+            ? COMMAND_CODE_USAGE_URL
+            : `${COMMAND_CODE_USAGE_URL}?since=${encodeURIComponent(since)}`;
+        const summary = await this.tryFetchJson(summaryUrl, headers, source.label);
+        return parseCommandCodeQuota({ credits, subscription, summary }, source.provider);
+    }
+    /** Best-effort JSON read for quota enrichment; a failure leaves the field out. */
+    async tryFetchJson(url, headers, label) {
+        try {
+            return await this.fetchJson(url, headers, label);
+        }
+        catch {
+            // Enrichment only: the required billing read already decided the outcome.
+            return undefined;
+        }
+    }
     /** Explain Zen metered billing instead of pretending it has a quota. */
     zenUsageText(source) {
         const usage = this.stats.usage;
@@ -5465,6 +5720,9 @@ export class SshTui {
             }
         }
         const llmPiAi = this.ctx.get('settings')?.get(settingsNamespace('llm-pi-ai'));
+        const commandCode = commandCodeSourceFor(provider, llmPiAi);
+        if (commandCode !== null)
+            return this.fetchCommandCodeQuota(commandCode);
         const source = openCodeSourceFor(provider, llmPiAi);
         if (source === null || source.flavor !== 'go')
             return undefined;
@@ -5910,7 +6168,8 @@ export class SshTui {
         if (text === '\r' || text === '\n') {
             const submit = questionSubmit(dialog, this.input);
             if (submit.kind === 'reject') {
-                // no selection: treat as cancel unless there are no options
+                // A list with options always answers with its highlight; this guards
+                // only a malformed question whose cursor names no option.
                 dialog.reject(new UserQuestionError('ask_user_question was cancelled', 'ASK_ABORTED'));
                 return;
             }
@@ -5947,6 +6206,7 @@ export class SshTui {
         const templateEntries = [
             { key: 'template:official', label: templates.official.label, detail: 'api.deepseek.com' },
             { key: 'template:opencode-go', label: templates['opencode-go'].label, detail: 'opencode.ai/zen/go · Responses' },
+            { key: 'template:command-code', label: templates['command-code'].label, detail: 'api.commandcode.ai · Completions' },
             { key: 'template:openai-completions', label: templates['openai-completions'].label, detail: 'openai-completions' },
             { key: 'template:openai-responses', label: templates['openai-responses'].label, detail: 'openai-responses' },
             { key: 'template:anthropic-messages', label: templates['anthropic-messages'].label, detail: 'anthropic-messages' },
@@ -5964,6 +6224,35 @@ export class SshTui {
         this.markDirty();
         return true;
     }
+    /** The installed catalog's id→window index, built once per catalog load. */
+    catalogWindowIndexSource() {
+        this.catalogWindows ??= catalogWindowIndex(this.catalogPresets ?? []);
+        return this.catalogWindows;
+    }
+    /**
+     * Size the wizard's picked models from the installed catalog, filling in the
+     * capacities the endpoint's listing did not disclose and recording them on
+     * the wizard state so the saved entries carry them.
+     * @param state - the wizard state whose `models` are being sized.
+     * @returns the windows discovered for this pick, by model id.
+     */
+    sizeOnboardingModels(state) {
+        const index = this.catalogWindowIndexSource();
+        const sized = new Map();
+        for (const id of state.models) {
+            const listed = state.modelCapacity?.get(id)?.contextWindow;
+            const window = listed ?? (index.size === 0 ? undefined : catalogContextWindow(id, index));
+            if (window === undefined)
+                continue;
+            sized.set(id, window);
+            if (listed === undefined) {
+                const capacity = state.modelCapacity?.get(id) ?? {};
+                state.modelCapacity ??= new Map();
+                state.modelCapacity.set(id, { ...capacity, contextWindow: window });
+            }
+        }
+        return sized;
+    }
     handleOnboardingChar(text) {
         const state = this.onboarding;
         if (state === undefined)
@@ -5982,6 +6271,7 @@ export class SshTui {
                     state.baseUrl = '';
                     state.key = '';
                     state.models = [];
+                    state.modelCapacity = new Map();
                     this.input = '';
                     this.cursor = 0;
                     if (entry.catalog !== undefined) {
@@ -6021,7 +6311,8 @@ export class SshTui {
             case 'id':
             case 'base-url':
             case 'key':
-            case 'models': {
+            case 'models':
+            case 'context': {
                 if (state.step === 'models' && text === '\x06') {
                     void this.fetchOnboardingModels();
                     return;
@@ -6048,8 +6339,11 @@ export class SshTui {
                     }
                     else if (state.step === 'models') {
                         const template = onboardTemplate(state);
+                        // Ctrl+F has already filled state.models; Enter accepts that
+                        // listing instead of discarding it for the template's placeholder
+                        // ids, which a generic gateway does not serve.
                         const parsed = value === ''
-                            ? template.defaultModels
+                            ? (state.models.length > 0 ? state.models : template.defaultModels)
                             : value.split(/[\s,，]+/u).filter(Boolean);
                         if (parsed.length === 0) {
                             this.pushRow({ kind: 'error', text: t('onboard.needModel') });
@@ -6058,6 +6352,18 @@ export class SshTui {
                         }
                         state.models = parsed;
                     }
+                    else if (state.step === 'context') {
+                        // Enter keeps the pre-filled value; a typed number overrides it.
+                        if (value !== '') {
+                            const parsed = Number.parseInt(value.replace(/[_,\s]/gu, ''), 10);
+                            if (!Number.isInteger(parsed) || parsed <= 0) {
+                                this.pushRow({ kind: 'error', text: t('onboard.contextInvalid', { value }) });
+                                this.markDirty();
+                                return;
+                            }
+                            state.routeContextWindow = parsed;
+                        }
+                    }
                     else {
                         state.baseUrl = value;
                     }
@@ -6091,6 +6397,7 @@ export class SshTui {
                     state.baseUrl = '';
                     state.key = '';
                     state.models = [];
+                    state.modelCapacity = new Map();
                     this.input = '';
                     this.cursor = 0;
                     this.markDirty();
@@ -6115,6 +6422,22 @@ export class SshTui {
             state.step = 'models';
         }
         else if (state.step === 'models') {
+            // Size the picks before the confirm step so the route default the wizard
+            // persists is derived, not guessed: the listing first, the installed
+            // catalog second. Only when some pick stayed unsized does the route
+            // default matter, and only then is a step shown for it.
+            const sized = this.sizeOnboardingModels(state);
+            const unsized = state.models.filter(id => !sized.has(id));
+            if (unsized.length === 0) {
+                state.step = 'confirm';
+            }
+            else {
+                state.routeContextWindow = suggestedRouteContextWindow(sized.values())
+                    ?? HARNESS_DEFAULT_CONTEXT_WINDOW;
+                state.step = 'context';
+            }
+        }
+        else if (state.step === 'context') {
             state.step = 'confirm';
         }
         this.input = '';
@@ -6166,6 +6489,13 @@ export class SshTui {
             }
             else {
                 state.models = ids;
+                state.modelCapacity = new Map(discovered.flatMap(model => {
+                    const capacity = {
+                        ...model.contextWindow === undefined ? {} : { contextWindow: model.contextWindow },
+                        ...model.maxTokens === undefined ? {} : { maxTokens: model.maxTokens },
+                    };
+                    return Object.keys(capacity).length === 0 ? [] : [[model.id, capacity]];
+                }));
                 this.input = '';
                 this.cursor = 0;
                 this.pushRow({ kind: 'system', text: t('onboard.fetchedModels', { count: ids.length, list: formatModelList(ids, 6) }) });
@@ -6219,14 +6549,20 @@ export class SshTui {
                 // to a supported level (if any) and persist it in both the profile
                 // and the default-model selection.
                 const llm = this.ctx.get('llm');
-                const defaultEffort = model !== undefined && llm !== undefined
-                    ? await defaultReasoningEffort(llm, state.providerId, model)
-                    : undefined;
-                const reasoningEfforts = defaultEffort === undefined
+                // A hand-declared OpenAI-compatible gateway has no pi-ai catalog entry,
+                // so nothing resolves its models before this profile is saved. Skip the
+                // live lookup there and declare the vocabulary the TUI offers instead.
+                const handDeclared = declaresOfferedReasoning(state.providerType);
+                const defaultEffort = handDeclared || model === undefined || llm === undefined
                     ? undefined
-                    : { off: null, [defaultEffort]: defaultEffort };
+                    : await defaultReasoningEffort(llm, state.providerId, model);
+                const reasoningEfforts = onboardingReasoningEfforts(state.providerType, defaultEffort === undefined ? undefined : String(defaultEffort));
                 const existing = this.piAiProviderProfile(state.providerId);
                 const existingModels = Array.isArray(existing?.models) ? existing.models : [];
+                // The confirm step can be reached without walking the models step (and
+                // a saved catalog answer may have landed after it), so size the picks
+                // here too: the call is idempotent and fills only missing windows.
+                this.sizeOnboardingModels(state);
                 const mergedIds = [];
                 const seen = new Set();
                 for (const id of state.models) {
@@ -6266,8 +6602,10 @@ export class SshTui {
                         }),
                     models: mergedIds.map(id => ({
                         id,
+                        ...(state.modelCapacity?.get(id) ?? template.defaultModelCapacity?.[id] ?? {}),
                         ...(reasoningEfforts === undefined ? {} : { reasoningEfforts }),
                     })),
+                    ...(state.routeContextWindow === undefined ? {} : { defaultContextWindow: state.routeContextWindow }),
                     ...(defaultEffort === undefined ? {} : { reasoning: defaultEffort }),
                 };
                 if (settings === undefined) {