@ponythewhite/base-context 1.0.0 → 1.0.1

package/dist/modes/interactive/interactive-mode.js

@@ -5,12 +5,11 @@ import * as path from "node:path";
 import { supportsFastMode, } from "@ponythewhite/base-context-ai";
 import { BUILTIN_MCP_CATALOG } from "@ponythewhite/base-context-ai/mcp";
 import { CombinedAutocompleteProvider, Container, Loader, Markdown, matchesKey, ProcessTerminal, Spacer, setKeybindings, Text, TruncatedText, TUI, truncateToWidth, visibleWidth, } from "@ponythewhite/base-context-tui";
-import { spawn, spawnSync } from "child_process";
+import { spawnSync } from "child_process";
 import { buildDaemonUpdateRestartReport, launchDaemonUpdateRestartCoordinator, resolveDaemonUpdateRestartSocketPath, selectedUpdateInstallation, } from "../../cli/daemon-update-restart.js";
 import { createCliSubprocessLaunchSpec } from "../../cli/subprocess-launch.js";
-import { APP_NAME, APP_TITLE, getAgentDir, getAgentTracesLogPath, getDebugLogPath, getLogsDir, getPhysicalPackageDir, getShareViewerUrl, SELF_UPDATE_INTERACTIVE_CHILD_ENV, SELF_UPDATE_NOT_ATTEMPTED_EXIT_CODE, VERSION, } from "../../config.js";
+import { APP_NAME, APP_TITLE, getAgentDir, getDebugLogPath, getLogsDir, getPhysicalPackageDir, SELF_UPDATE_INTERACTIVE_CHILD_ENV, SELF_UPDATE_NOT_ATTEMPTED_EXIT_CODE, VERSION, } from "../../config.js";
 import { AGENT_MESSAGE_RECEIVED_PREVIEW_LABEL, isAgentSessionMessage, startsAgentRun, } from "../../core/agent-messages.js";
-import { getPrimeAgentTraceCredential, previewAgentTraceFile, uploadAgentTraceFile, uploadAllAgentTraces, } from "../../core/agent-traces.js";
 import { isNoModelsAvailableMessage } from "../../core/auth-guidance.js";
 import { DEFAULT_HEARTBEAT_DELIVERY_MODE, parseHeartbeatCommand, } from "../../core/cron-jobs.js";
 import { FooterDataProvider } from "../../core/footer-data-provider.js";
@@ -20,15 +19,12 @@ import { runMcpManagementCommand } from "../../core/mcp/mcp-command.js";
 import { bashOutputToText, COMPACTION_OUTCOME_CUSTOM_TYPE, createHeartbeatPromptMessage, HEARTBEAT_PROMPT_PREVIEW_LABEL, isCompactionOutcomeMessage, isRefinementOutcomeMessage, isSessionSlashCommandMessage, isSessionSlashCommandResultMessage, REFINEMENT_OUTCOME_CUSTOM_TYPE, SESSION_SLASH_COMMAND_CUSTOM_TYPE, SESSION_SLASH_COMMAND_RESULT_CUSTOM_TYPE, } from "../../core/messages.js";
 import { findExactModelReferenceMatch, resolveModelScopeFromModels } from "../../core/model-resolver.js";
 import { parseNewSessionCommand } from "../../core/new-session-command.js";
-import { resolvePrimeAgentTracesBaseUrl } from "../../core/prime-inference-auth.js";
-import { resolvePrimeInferencePostLoginModelAction } from "../../core/prime-inference-model-selection.js";
 import { parseCommandArgs } from "../../core/prompt-templates.js";
 import { formatMissingSessionCwdPrompt, MissingSessionCwdError } from "../../core/session-cwd.js";
 import { SessionImportFileNotFoundError } from "../../core/session-import-errors.js";
 import { resolveSessionPath, SessionSelectorError, SessionSelectorNotFoundError } from "../../core/session-resolver.js";
 import { parseSkillBlock } from "../../core/skill-blocks.js";
 import { BUILTIN_SLASH_COMMANDS, builtinSlashCommandTakesArgument, isBuiltinSlashCommandName, parseSlashCommand, resolveBuiltinSlashCommandName, } from "../../core/slash-commands.js";
-import { captureAgentCommandUsed, captureOnboardingCompleted, } from "../../core/telemetry.js";
 import { truncateTail } from "../../core/tools/truncate.js";
 import { getOwnedInstallation } from "../../owned-install-layout.js";
 import { assertProductStatePath } from "../../runtime-paths.js";
@@ -51,7 +47,6 @@ import { AgentMessageComponent } from "./components/agent-message.js";
 import { ArminComponent } from "./components/armin.js";
 import { AssistantMessageComponent } from "./components/assistant-message.js";
 import { BashExecutionComponent } from "./components/bash-execution.js";
-import { BorderedLoader } from "./components/bordered-loader.js";
 import { BranchSummaryMessageComponent } from "./components/branch-summary-message.js";
 import { showFullPaneOverlay } from "./components/centered-overlay.js";
 import { CompactionOutcomeMessageComponent, MalformedCompactionOutcomeMessageComponent, } from "./components/compaction-outcome-message.js";
@@ -75,7 +70,6 @@ import { HeartbeatManagerComponent } from "./components/heartbeat-manager.js";
 import { InjectedPromptMessageComponent, isInjectedPromptMessage } from "./components/injected-prompt-message.js";
 import { formatKeyText, keyHint, keyText, rawKeyHint } from "./components/keybinding-hints.js";
 import { createMermaidMarkdownTransform } from "./components/mermaid.js";
-import { PrimeOnboardingSplashComponent } from "./components/prime-onboarding-splash.js";
 import { MalformedRefinementOutcomeMessageComponent, RefinementOutcomeMessageComponent, } from "./components/refinement-outcome-message.js";
 import { ScopedModelsSelectorComponent } from "./components/scoped-models-selector.js";
 import { SettingsSelectorComponent } from "./components/settings-selector.js";
@@ -92,7 +86,7 @@ import { UserMessageSelectorComponent } from "./components/user-message-selector
 import { FeatureHintDeck } from "./feature-hints.js";
 import { scopeHeartbeatsToSession } from "./heartbeat-scope.js";
 import { collectMarkedImages, evictImagesToBudget, formatImageMarker, imageMarkerIds, remapImageMarkers, } from "./image-markers.js";
-import { isOnboardingModelReady, shouldRunOnboarding, shouldRunPrimeCliOnboardingSplash, } from "./onboarding.js";
+import { isOnboardingModelReady, shouldRunOnboarding } from "./onboarding.js";
 import { QueueSelection } from "./queue-selection.js";
 import { formatResumeHint } from "./resume-hint.js";
 import { getAvailableThemes, getAvailableThemesWithPaths, getEditorTheme, getMarkdownTheme, getThemeByName, initTheme, onThemeChange, setRegisteredThemes, setTheme, setThemeInstance, stopThemeWatcher, Theme, theme, } from "./theme/theme.js";
@@ -558,6 +552,7 @@ export class InteractiveMode {
     version;
     startHint = getRandomStartHint();
     isInitialized = false;
+    initializationPromise;
     onInputCallback;
     submittedInputBehavior = "steer";
     latestEditorPromptStash;
@@ -568,6 +563,7 @@ export class InteractiveMode {
     retainedSubmissionGenerations = new WeakMap();
     admitPendingStartupPrompts;
     agentsViewRequest;
+    isReturningToAgentsView = false;
     loadingAnimation = undefined;
     workingMessage = undefined;
     workingVisible = true;
@@ -679,7 +675,6 @@ export class InteractiveMode {
     refineLoader = undefined;
     retryLoader = undefined;
     retryCountdown = undefined;
-    traceUploadAllAbortController = undefined;
     queueSelection = new QueueSelection();
     isApplyingQueueSelectionText = false;
     queueMutationChain = Promise.resolve();
@@ -1069,7 +1064,8 @@ export class InteractiveMode {
         }
     }
     async run() {
-        await this.init();
+        this.initializationPromise = this.init();
+        await this.initializationPromise;
         this.restorePromptStashOnOpen();
         // Global, environment-scoped notices (app update, extension updates, tmux setup)
         // belong on the agents view, not in a conversation. When the agents view already
@@ -1227,11 +1223,13 @@ export class InteractiveMode {
                 this.showWarning(modelFallbackMessage);
             }
         };
-        await this.runStartupOnboarding();
-        showDeferredStartupNotifications();
-        showModelFallbackWarning();
-        void this.maybeWarnAboutAnthropicSubscriptionAuth();
-        void deliverStartupPrompts().then(() => settleStartupPrompts("admitted"), () => settleStartupPrompts("admitted"));
+        if (!this.isShuttingDown && !this.isReturningToAgentsView) {
+            await this.runStartupOnboarding();
+            showDeferredStartupNotifications();
+            showModelFallbackWarning();
+            void this.maybeWarnAboutAnthropicSubscriptionAuth();
+            void deliverStartupPrompts().then(() => settleStartupPrompts("admitted"), () => settleStartupPrompts("admitted"));
+        }
         // Enter/Alt+Enter submit directly through AgentConnection. Wait for the
         // lifecycle signal exactly once; a returned editor value has already been
         // admitted and must never be submitted again here.
@@ -1277,9 +1275,6 @@ export class InteractiveMode {
     shouldRunOnboarding() {
         return shouldRunOnboarding(this.getOnboardingState());
     }
-    shouldRunPrimeCliOnboardingSplash() {
-        return shouldRunPrimeCliOnboardingSplash(this.getOnboardingState());
-    }
     markOnboardingShown() {
         if (!this.settingsManager.getOnboardingShown()) {
             this.settingsManager.setOnboardingShown(true);
@@ -1289,71 +1284,21 @@ export class InteractiveMode {
         if (!this.shouldRunOnboarding()) {
             return false;
         }
-        const startedAt = Date.now();
-        const showPrimeCliSplash = this.shouldRunPrimeCliOnboardingSplash();
-        let outcome = "aborted";
-        try {
+        const setupCompleted = await this.runOnboardingFlow();
+        if (setupCompleted && isOnboardingModelReady(this.getOnboardingState())) {
             this.markOnboardingShown();
             await this.settingsManager.flush();
-            await this.runOnboardingFlow(showPrimeCliSplash);
-            outcome = isOnboardingModelReady(this.getOnboardingState()) ? "success" : "aborted";
-            return true;
-        }
-        catch (error) {
-            outcome = "error";
-            throw error;
-        }
-        finally {
-            const model = this.getCurrentModel();
-            const authStatus = model ? this.modelRegistry.getProviderAuthStatus(model.provider) : undefined;
-            const storedCredential = model ? this.modelRegistry.authStorage.get(model.provider) : undefined;
-            void captureOnboardingCompleted({
-                agentDir: getAgentDir(),
-                settingsManager: this.settingsManager,
-                durationMs: Date.now() - startedAt,
-                outcome,
-                provider: model?.provider,
-                authSource: authStatus?.source,
-                storedCredentialType: storedCredential?.type,
-            }).catch(() => { });
-        }
-    }
-    async showOnboardingModelSelection(splash) {
-        try {
-            await this.showConfigurationMenu("models");
-        }
-        finally {
-            splash.dismiss();
         }
+        return true;
     }
-    async runOnboardingFlow(showPrimeCliSplash = this.shouldRunPrimeCliOnboardingSplash()) {
+    async runOnboardingFlow() {
         this.modelRegistry.refresh();
-        if (showPrimeCliSplash) {
-            const splash = await this.showOnboardingSplash("choose a model");
-            if (!splash) {
-                return;
-            }
-            await this.showOnboardingModelSelection(splash);
-            return;
-        }
-        const availableModels = await this.getModelCandidates();
-        if (availableModels.length > 0) {
-            await this.showConfigurationMenu("models");
-            return;
-        }
-        const splash = await this.showOnboardingSplash();
-        if (!splash) {
-            return;
-        }
-        splash.showProgress("Signing in to Prime Intellect...");
-        const authResult = await this.createAuthFlows().runPrimeInferenceLogin();
-        if (authResult.status !== "success") {
-            splash.dismiss();
-            return;
+        const model = this.getCurrentModel();
+        if (model) {
+            const authFlows = this.createAuthFlows();
+            return this.ensureModelProviderConfigured(model, authFlows, authFlows.getLoginProviderOptions());
         }
-        splash.showProgress("Preparing models...");
-        await this.prepareForModelSelectionAfterLogin(authResult);
-        await this.showOnboardingModelSelection(splash);
+        return this.showConfigurationMenu("providers", undefined, true);
     }
     getMarkdownThemeWithSettings() {
         return {
@@ -1923,7 +1868,7 @@ export class InteractiveMode {
             do {
                 this.heartbeatRefreshRequested = false;
                 const heartbeats = await connection.listHeartbeats();
-                if (this.agentConnection !== connection)
+                if (this.isShuttingDown || this.isReturningToAgentsView || this.agentConnection !== connection)
                     return;
                 this.applyHeartbeatCatalog(heartbeats);
             } while (this.heartbeatRefreshRequested);
@@ -2107,7 +2052,6 @@ export class InteractiveMode {
             this.isBashRunning() ||
             this.getRetryAttempt() > 0 ||
             this.connectionState?.sessionActions.active !== undefined ||
-            this.traceUploadAllAbortController !== undefined ||
             this.sideQuestionEvent?.status === "running");
     }
     getRetryAttempt() {
@@ -2168,7 +2112,8 @@ export class InteractiveMode {
         this.patchConnectionState({ sessionActions: (await this.agentConnection.getState()).sessionActions });
         this.refreshQueueSelectionFromState();
         this.updatePendingMessagesDisplay();
-        await this.refreshHeartbeatCatalog().catch(() => undefined);
+        // Optional tray metadata must not delay opening or leaving a chat.
+        void this.refreshHeartbeatCatalog().catch(() => undefined);
         await this.updateAvailableProviderCount();
         this.updateEditorBorderColor();
         this.updateTerminalTitle();
@@ -3780,13 +3725,6 @@ export class InteractiveMode {
                     this.ui.requestRender();
                     return;
                 }
-                if (commandName) {
-                    void captureAgentCommandUsed({
-                        agentDir: getAgentDir(),
-                        settingsManager: this.settingsManager,
-                        commandName,
-                    }).catch(() => { });
-                }
                 if (commandName === "btw") {
                     this.editor.setText("");
                     await this.handleSideQuestion(commandArgs);
@@ -3833,11 +3771,6 @@ export class InteractiveMode {
                     this.editor.setText("");
                     return;
                 }
-                if (commandName === "share" && !commandArgs) {
-                    await this.handleShareCommand();
-                    this.editor.setText("");
-                    return;
-                }
                 if (commandName === "copy" && !commandArgs) {
                     await this.handleCopyCommand();
                     this.editor.setText("");
@@ -3848,6 +3781,11 @@ export class InteractiveMode {
                     this.editor.setText("");
                     return;
                 }
+                if (commandName === "agents") {
+                    this.editor.setText("");
+                    await this.handleAgentsCommand(commandArgs);
+                    return;
+                }
                 if (commandName === "rlm-max-depth") {
                     this.editor.setText("");
                     await this.handleRlmMaxDepthCommand(commandArgs);
@@ -3865,11 +3803,6 @@ export class InteractiveMode {
                     this.editor.setText("");
                     return;
                 }
-                if (commandName === "traces") {
-                    await this.handleTracesCommand(canonicalCommandText);
-                    this.editor.setText("");
-                    return;
-                }
                 if (commandName === "context" && !commandArgs) {
                     this.echoLocalCommand(text);
                     await this.handleContextCommand();
@@ -4130,6 +4063,7 @@ export class InteractiveMode {
                 // by teardown must neither prompt nor mutate the editor/durable stash.
                 if (submissionOutcome === "lifecycle-cancelled" ||
                     this.isShuttingDown ||
+                    this.isReturningToAgentsView ||
                     this.agentsViewRequest ||
                     this.promptStashSessionId !== submissionSessionId) {
                     // The editor is already torn down, but its shared session stash outlives
@@ -4151,6 +4085,7 @@ export class InteractiveMode {
                     // rejection must be retained rather than overwrite newer input or vanish.
                     const rejectedDraft = submittedDraft ?? { text };
                     const canRestore = !this.isShuttingDown &&
+                        !this.isReturningToAgentsView &&
                         !this.agentsViewRequest &&
                         submissionGeneration === this.inputSubmissionGeneration &&
                         this.editor.getText().length === 0;
@@ -4174,7 +4109,7 @@ export class InteractiveMode {
                 this.ui.requestRender();
             }
             finally {
-                if (this.isShuttingDown || this.agentsViewRequest) {
+                if (this.isShuttingDown || this.isReturningToAgentsView || this.agentsViewRequest) {
                     submissionOutcome = "lifecycle-cancelled";
                 }
                 if (submissionOutcome === "admitted" &&
@@ -5653,7 +5588,6 @@ export class InteractiveMode {
         this.showCtrlCExitHint();
     }
     interruptOrClearInput() {
-        this.traceUploadAllAbortController?.abort(new Error("Trace upload cancelled"));
         if (this.sideQuestionEvent?.status === "running") {
             this.abortSideQuestion(this.sideQuestionEvent.id, true);
         }
@@ -5773,11 +5707,15 @@ export class InteractiveMode {
         await this.returnToAgentsView();
     }
     async returnToAgentsView(request = "agents_view") {
-        if (this.isShuttingDown || this.agentsViewRequest)
+        if (this.isShuttingDown || this.isReturningToAgentsView)
+            return;
+        this.isReturningToAgentsView = true;
+        // Keep startup's connection alive without blocking an explicit shutdown.
+        await this.initializationPromise?.catch(() => undefined);
+        if (this.isShuttingDown)
             return;
-        this.stashDraftForAgentsView();
-        this.agentsViewRequest = request;
         this.isShuttingDown = true;
+        this.stashDraftForAgentsView();
         this.unregisterSignalHandlers();
         await this.teardownSessionUi({ preserveAltScreen: true });
         let handoffComplete = false;
@@ -5787,6 +5725,7 @@ export class InteractiveMode {
             }
             finally {
                 await this.options.onShutdown?.();
+                this.agentsViewRequest = request;
                 this.onInputCallback?.(undefined);
                 handoffComplete = true;
             }
@@ -6867,7 +6806,7 @@ export class InteractiveMode {
     showModelSelector(initialSearchInput) {
         void this.showConfigurationMenu("models", initialSearchInput);
     }
-    showConfigurationMenu(initialTab, initialModelSearch) {
+    showConfigurationMenu(initialTab, initialModelSearch, providerFirst = this.getCurrentModel() === undefined) {
         const modelCatalog = this.getCachedModelCandidates();
         const authFlows = this.createAuthFlows();
         const providerOptions = authFlows.getLoginProviderOptions();
@@ -6900,12 +6839,12 @@ export class InteractiveMode {
                 handle?.focus();
                 this.ui.requestRender();
             };
-            const finish = () => {
+            const finish = (modelSelected = false) => {
                 if (settled)
                     return;
                 settled = true;
                 hide();
-                resolve();
+                resolve(modelSelected);
             };
             const refreshModels = (force) => {
                 const refreshPromise = this.getModelSelectorRefreshPromise({ force });
@@ -6921,9 +6860,24 @@ export class InteractiveMode {
                         this.showError(error instanceof Error ? error.message : String(error));
                 });
             };
+            const showProviderModels = (providerId) => {
+                menu.updateModels(this.getCurrentModel(), this.getCachedModelCandidates(), this.connectionConfiguredProviders);
+                if (providerFirst)
+                    menu.showProviderModels(providerId);
+                else
+                    menu.setActiveTab("models");
+                refreshModels(true);
+            };
             const authenticate = (provider, tab) => {
                 if (settled)
                     return;
+                if (providerFirst &&
+                    tab === "providers" &&
+                    (this.connectionConfiguredProviders.has(provider.id) ||
+                        this.modelRegistry.getProviderAuthStatus(provider.id).configured)) {
+                    showProviderModels(provider.id);
+                    return;
+                }
                 void authFlows
                     .loginProvider(provider)
                     .then(async (authResult) => {
@@ -6944,10 +6898,7 @@ export class InteractiveMode {
                         await this.handleReloadCommand();
                         return;
                     }
-                    await this.prepareForModelSelectionAfterLogin(authResult);
-                    menu.updateModels(this.getCurrentModel(), this.getCachedModelCandidates(), this.connectionConfiguredProviders);
-                    menu.setActiveTab("models");
-                    refreshModels(true);
+                    showProviderModels(authResult.providerId);
                 })
                     .catch((error) => {
                     handle?.focus();
@@ -6956,6 +6907,7 @@ export class InteractiveMode {
             };
             menu = new ConfigurationMenuComponent({
                 initialTab,
+                providerFirst,
                 tui: this.ui,
                 authStorage: this.modelRegistry.authStorage,
                 providerOptions,
@@ -6990,7 +6942,7 @@ export class InteractiveMode {
                         }
                         finally {
                             if (completed)
-                                finish();
+                                finish(true);
                         }
                     })();
                 },
@@ -7295,50 +7247,6 @@ export class InteractiveMode {
             return this.handleFatalRuntimeError("Failed to resume session", error);
         }
     }
-    showOnboardingSplash(continueActionLabel) {
-        return new Promise((resolve) => {
-            let settled = false;
-            let dismissed = false;
-            let handle;
-            let selector;
-            const settle = (result) => {
-                if (settled) {
-                    return;
-                }
-                settled = true;
-                resolve(result);
-            };
-            const dismiss = () => {
-                if (dismissed) {
-                    return;
-                }
-                dismissed = true;
-                selector?.dispose();
-                handle?.hide();
-                this.ui.requestRender();
-            };
-            selector = new PrimeOnboardingSplashComponent(() => {
-                selector?.dispose();
-                settle({
-                    showProgress: (message) => selector?.showProgress(message),
-                    dismiss,
-                });
-            }, () => {
-                dismiss();
-                settle(undefined);
-            }, {
-                getRows: () => this.ui.terminal.rows,
-                requestRender: () => this.ui.requestRender(),
-                ...(continueActionLabel ? { continueActionLabel } : {}),
-            });
-            handle = this.ui.showOverlay(selector, {
-                width: "100%",
-                maxHeight: "100%",
-                row: 0,
-                col: 0,
-            });
-        });
-    }
     createAuthFlows() {
         return new ProviderAuthFlows({
             ui: this.ui,
@@ -7357,40 +7265,6 @@ export class InteractiveMode {
             },
         });
     }
-    async prepareForModelSelectionAfterLogin(authResult) {
-        const currentModel = this.getCurrentModel();
-        // The agent core uses unknown/unknown as its no-model sentinel.
-        const selectedModel = currentModel?.provider === "unknown" && currentModel.id === "unknown" ? undefined : currentModel;
-        let action = resolvePrimeInferencePostLoginModelAction(authResult, selectedModel, this.modelRegistry);
-        if (!action.openModelPicker) {
-            return false;
-        }
-        if (!selectedModel) {
-            try {
-                const availableModels = await this.getConnectionAvailableModels();
-                action = resolvePrimeInferencePostLoginModelAction(authResult, selectedModel, {
-                    find: (provider, modelId) => availableModels.find((model) => model.provider === provider && model.id === modelId) ??
-                        this.modelRegistry.find(provider, modelId),
-                });
-            }
-            catch {
-                // Preserve the registry fallback so selection can still report a specific failure below.
-            }
-        }
-        if (action.fallbackModel) {
-            try {
-                await this.applySelectedModel(action.fallbackModel);
-                await this.settingsManager.flush();
-            }
-            catch (error) {
-                this.showError(`Prime Inference login succeeded, but the default model could not be selected: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        }
-        else if (!selectedModel) {
-            this.showError("Prime Inference login succeeded, but the default GLM 5.2 model is unavailable.");
-        }
-        return true;
-    }
     async handleMcpCommand(args) {
         const argv = parseCommandArgs((args ?? "").trim());
         const [sub, server] = argv;
@@ -7431,7 +7305,7 @@ export class InteractiveMode {
                 const successMessage = verb === "removed"
                     ? `Removed MCP server "${name}" (${transport}). It is no longer available through mcp.`
                     : usesOAuth
-                        ? `${verb === "replaced" ? "Replaced" : "Added"} MCP server "${name}" (${transport}). OAuth is unavailable until the Base Context provider contract is validated. Use explicit bearer-token or API-key configuration instead.`
+                        ? `${verb === "replaced" ? "Replaced" : "Added"} MCP server "${name}" (${transport}). Run /mcp login ${name} to connect its OAuth account.`
                         : `${verb === "replaced" ? "Replaced" : "Added"} MCP server "${name}" (${transport}). Available next turn through mcp.`;
                 await this.reloadAfterMcpChange(usesOAuth ? successMessage : result.message, successMessage);
             }
@@ -7760,93 +7634,6 @@ export class InteractiveMode {
             await this.handleFatalRuntimeError("Failed to import session", error);
         }
     }
-    async handleShareCommand() {
-        // Check if gh is available and logged in
-        try {
-            const authResult = spawnSync("gh", ["auth", "status"], { encoding: "utf-8" });
-            if (authResult.status !== 0) {
-                this.showError("GitHub CLI is not logged in. Run 'gh auth login' first.");
-                return;
-            }
-        }
-        catch {
-            this.showError("GitHub CLI (gh) is not installed. Install it from https://cli.github.com/");
-            return;
-        }
-        // Export to a temp file
-        const tmpFile = path.join(os.tmpdir(), "session.html");
-        try {
-            await this.agentConnection.exportToHtml(tmpFile);
-        }
-        catch (error) {
-            this.showError(`Failed to export session: ${error instanceof Error ? error.message : "Unknown error"}`);
-            return;
-        }
-        // Show cancellable loader, replacing the editor
-        const loader = new BorderedLoader(this.ui, theme, "Creating gist...");
-        this.editorContainer.clear();
-        this.editorContainer.addChild(loader);
-        this.ui.setFocus(loader);
-        this.ui.requestRender();
-        const restoreEditor = () => {
-            loader.dispose();
-            this.editorContainer.clear();
-            this.editorContainer.addChild(this.editor);
-            this.ui.setFocus(this.editor);
-            try {
-                fs.unlinkSync(tmpFile);
-            }
-            catch {
-                // Ignore cleanup errors
-            }
-        };
-        // Create a secret gist asynchronously
-        let proc = null;
-        loader.onAbort = () => {
-            proc?.kill();
-            restoreEditor();
-            this.showStatus("Share cancelled");
-        };
-        try {
-            const result = await new Promise((resolve) => {
-                proc = spawn("gh", ["gist", "create", "--public=false", tmpFile]);
-                let stdout = "";
-                let stderr = "";
-                proc.stdout?.on("data", (data) => {
-                    stdout += data.toString();
-                });
-                proc.stderr?.on("data", (data) => {
-                    stderr += data.toString();
-                });
-                proc.on("close", (code) => resolve({ stdout, stderr, code }));
-            });
-            if (loader.signal.aborted)
-                return;
-            restoreEditor();
-            if (result.code !== 0) {
-                const errorMsg = result.stderr?.trim() || "Unknown error";
-                this.showError(`Failed to create gist: ${errorMsg}`);
-                return;
-            }
-            // Extract gist ID from the URL returned by gh
-            // gh returns something like: https://gist.github.com/username/GIST_ID
-            const gistUrl = result.stdout?.trim();
-            const gistId = gistUrl?.split("/").pop();
-            if (!gistId) {
-                this.showError("Failed to parse gist ID from gh output");
-                return;
-            }
-            // Create the preview URL
-            const previewUrl = getShareViewerUrl(gistId);
-            this.showStatus(`Share URL: ${previewUrl}\nGist: ${gistUrl}`);
-        }
-        catch (error) {
-            if (!loader.signal.aborted) {
-                restoreEditor();
-                this.showError(`Failed to create gist: ${error instanceof Error ? error.message : "Unknown error"}`);
-            }
-        }
-    }
     async handleCopyCommand() {
         const text = await this.agentConnection.getLastAssistantText();
         if (!text) {
@@ -7880,6 +7667,23 @@ export class InteractiveMode {
         this.chatContainer.addChild(new Text(theme.fg("dim", `Session name set: ${name}`), 1, 0));
         this.ui.requestRender();
     }
+    async handleAgentsCommand(args) {
+        const value = args.trim();
+        const maxSubagents = Number(value);
+        if (value && (!/^\d+$/.test(value) || !Number.isSafeInteger(maxSubagents))) {
+            this.showWarning("Usage: /agents [N]. N must be a non-negative safe integer; 0 disables new subagent spawns.");
+            return;
+        }
+        try {
+            const status = value
+                ? await this.agentConnection.setRlmMaxSubagents(maxSubagents)
+                : await this.agentConnection.getRlmMaxSubagentsStatus();
+            this.showStatus(`The current maximum number of concurrent subagents is ${status.maxSubagents}.`);
+        }
+        catch (error) {
+            this.showError(error instanceof Error ? error.message : String(error));
+        }
+    }
     async handleRlmMaxDepthCommand(args) {
         const tokens = args ? args.split(/\s+/) : [];
         if (tokens.length === 0) {
@@ -7979,236 +7783,6 @@ export class InteractiveMode {
         this.chatContainer.addChild(new Text(prompt, 1, 0));
         this.ui.requestRender();
     }
-    formatTraceUploadResult(result) {
-        switch (result.status) {
-            case "uploaded":
-                return `Trace uploaded (${result.bytesStored.toLocaleString()} bytes).`;
-            case "disabled":
-                return "Trace sharing is disabled.";
-            case "unchanged":
-                return "Trace is already uploaded; no new content since the last upload.";
-            case "missing_credentials":
-                return "Trace sharing needs a Prime API key. Run /traces login.";
-            case "no_session_file":
-                return "Current session has no persisted trace yet.";
-            case "empty_session":
-                return "Current session trace is empty.";
-            case "invalid_session":
-                return `Trace upload skipped: ${result.message}.`;
-            case "too_large":
-                return `Trace upload skipped: session file is ${result.size.toLocaleString()} bytes; limit is ${result.maxBytes.toLocaleString()} bytes.`;
-            case "failed":
-                if (result.statusCode === 404) {
-                    return "Trace upload endpoint was not found. The platform API may not be deployed yet, or BASE_CONTEXT_TRACES_BASE_URL points at the wrong API.";
-                }
-                return `Trace upload failed: ${result.statusCode ? `HTTP ${result.statusCode}: ` : ""}${result.message}. See ${getAgentTracesLogPath()} for details.`;
-        }
-    }
-    async uploadCurrentTraceOnce() {
-        const state = await this.agentConnection.getState();
-        return uploadAgentTraceFile({
-            sessionFile: state.sessionFile,
-            authStorage: this.modelRegistry.authStorage,
-            settingsManager: this.settingsManager,
-            requireEnabled: false,
-            reloadConfig: false,
-        });
-    }
-    async previewCurrentTrace() {
-        const state = await this.agentConnection.getState();
-        const result = await previewAgentTraceFile({ sessionFile: state.sessionFile });
-        let info;
-        switch (result.status) {
-            case "no_session_file":
-                info = "Trace preview is unavailable until the current session has a persisted assistant response.";
-                break;
-            case "empty_session":
-                info = "The current trace is empty.";
-                break;
-            case "invalid_session":
-            case "failed":
-                info = `Trace preview failed: ${result.message}.`;
-                break;
-            case "ready":
-                info = this.formatTracePreview(result);
-                break;
-        }
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(info, 1, 0));
-        this.ui.requestRender();
-    }
-    formatTracePreview(result) {
-        const lines = [
-            theme.bold("Trace Preview"),
-            theme.fg("dim", "Nothing has been uploaded by this command."),
-            "",
-            `${theme.fg("dim", "File:")} ${result.sessionFile}`,
-            `${theme.fg("dim", "Size:")} ${result.size.toLocaleString()} bytes`,
-            `${theme.fg("dim", "Uploadable:")} ${result.uploadable ? "Yes" : `No (limit ${result.maxBytes.toLocaleString()} bytes)`}`,
-            `${theme.fg("dim", "Endpoint:")} ${result.endpoint}`,
-            `${theme.fg("dim", "Session ID:")} ${result.sessionId}`,
-            `${theme.fg("dim", "Trace ID:")} ${result.traceId}`,
-        ];
-        if (result.parentSessionId) {
-            lines.push(`${theme.fg("dim", "Parent session:")} ${result.parentSessionId}`);
-        }
-        if (result.gitRepo) {
-            lines.push(`${theme.fg("dim", "Git repository:")} ${result.gitRepo}`);
-        }
-        if (result.gitCommit) {
-            lines.push(`${theme.fg("dim", "Git commit:")} ${result.gitCommit}`);
-        }
-        lines.push("", theme.bold("Raw JSONL payload preview"));
-        if (result.contentPreview) {
-            lines.push(result.contentPreview);
-            if (result.truncated) {
-                lines.push("", theme.fg("dim", "Preview truncated; upload sends the complete file."));
-            }
-        }
-        else {
-            lines.push(theme.fg("dim", "Payload omitted because the trace exceeds the upload limit."));
-        }
-        return lines.join("\n");
-    }
-    async uploadAllTraces(sessionDir, signal) {
-        return uploadAllAgentTraces({
-            authStorage: this.modelRegistry.authStorage,
-            settingsManager: this.settingsManager,
-            sessionDir,
-            requireEnabled: false,
-            reloadConfig: false,
-            signal,
-            onProgress: ({ completed, total }) => {
-                if (total > 0 && (completed === 0 || completed === total || completed % 10 === 0)) {
-                    this.showStatus(`Uploading traces: ${completed.toLocaleString()}/${total.toLocaleString()} (${keyText("app.clear")} to cancel)`);
-                }
-            },
-        });
-    }
-    async handleTracesCommand(text) {
-        const command = text
-            .replace(/^\/traces\b/, "")
-            .trim()
-            .toLowerCase() || "status";
-        if (command === "status") {
-            await this.settingsManager.reload().catch(() => undefined);
-            const credential = await getPrimeAgentTraceCredential(this.modelRegistry.authStorage);
-            const state = await this.agentConnection.getState();
-            const info = [
-                theme.bold("Trace Sharing"),
-                "",
-                `${theme.fg("dim", "Automatic uploads:")} ${this.settingsManager.getAgentTracesEnabled() ? "Enabled" : "Disabled"}`,
-                `${theme.fg("dim", "Credential:")} ${credential?.label ?? "Not configured"}`,
-                `${theme.fg("dim", "Endpoint:")} ${resolvePrimeAgentTracesBaseUrl()}`,
-                `${theme.fg("dim", "Session file:")} ${state.sessionFile ?? "In-memory"}`,
-                "",
-                theme.fg("dim", "Commands: /traces on, /traces off, /traces preview, /traces upload-current, /traces upload-all, /traces login"),
-            ].join("\n");
-            this.chatContainer.addChild(new Spacer(1));
-            this.chatContainer.addChild(new Text(info, 1, 0));
-            this.ui.requestRender();
-            return;
-        }
-        if (command === "off" || command === "disable") {
-            this.settingsManager.setAgentTracesEnabled(false);
-            await this.settingsManager.flush();
-            this.showStatus("Trace sharing disabled.");
-            return;
-        }
-        if (command === "login") {
-            await this.createAuthFlows().runPrimeAgentTracesLogin();
-            return;
-        }
-        if (command === "preview") {
-            await this.previewCurrentTrace();
-            return;
-        }
-        if (command === "on" || command === "enable") {
-            let credential = await getPrimeAgentTraceCredential(this.modelRegistry.authStorage);
-            if (!credential) {
-                const authResult = await this.createAuthFlows().runPrimeAgentTracesLogin();
-                if (authResult.status !== "success") {
-                    return;
-                }
-                credential = await getPrimeAgentTraceCredential(this.modelRegistry.authStorage);
-            }
-            if (!credential) {
-                this.showError("Trace sharing needs a Prime API key.");
-                return;
-            }
-            this.settingsManager.setAgentTracesEnabled(true);
-            await this.settingsManager.flush();
-            const uploadResult = await this.uploadCurrentTraceOnce();
-            const uploadMessage = uploadResult.status === "no_session_file" || uploadResult.status === "empty_session"
-                ? "Current session will upload after the first assistant response."
-                : this.formatTraceUploadResult(uploadResult);
-            this.showStatus(`Trace sharing enabled. ${uploadMessage}`);
-            return;
-        }
-        if (command === "upload" || command === "upload-current") {
-            const credential = await getPrimeAgentTraceCredential(this.modelRegistry.authStorage);
-            if (!credential) {
-                this.showError("Trace sharing needs a Prime API key. Run /traces login.");
-                return;
-            }
-            const uploadResult = await this.uploadCurrentTraceOnce();
-            const message = this.formatTraceUploadResult(uploadResult);
-            if (uploadResult.status === "failed") {
-                this.showError(message);
-            }
-            else {
-                this.showStatus(message);
-            }
-            return;
-        }
-        if (command === "upload-all") {
-            const credential = await getPrimeAgentTraceCredential(this.modelRegistry.authStorage);
-            if (!credential) {
-                this.showError("Trace sharing needs a Prime API key. Run /traces login.");
-                return;
-            }
-            if (this.traceUploadAllAbortController) {
-                this.showWarning("A trace upload is already running. Cancel it before starting another.");
-                return;
-            }
-            const state = await this.agentConnection.getState();
-            const abortController = new AbortController();
-            this.traceUploadAllAbortController = abortController;
-            let result;
-            try {
-                result = await this.uploadAllTraces(state.sessionDir, abortController.signal);
-            }
-            finally {
-                if (this.traceUploadAllAbortController === abortController) {
-                    this.traceUploadAllAbortController = undefined;
-                }
-            }
-            if (abortController.signal.aborted) {
-                this.showStatus("Trace upload cancelled.");
-                return;
-            }
-            if (result.total === 0) {
-                this.showStatus("No persisted traces were found.");
-                return;
-            }
-            const summary = [
-                `Uploaded ${result.uploaded.toLocaleString()} of ${result.total.toLocaleString()} traces`,
-                result.skipped > 0 ? `${result.skipped.toLocaleString()} skipped` : undefined,
-                result.failed > 0 ? `${result.failed.toLocaleString()} failed` : undefined,
-                `${result.bytesStored.toLocaleString()} bytes stored`,
-            ]
-                .filter((part) => part !== undefined)
-                .join("; ");
-            if (result.failed > 0) {
-                this.showWarning(`${summary}. See ${getAgentTracesLogPath()} for details.`);
-            }
-            else {
-                this.showStatus(`${summary}.`);
-            }
-            return;
-        }
-        this.showWarning("Usage: /traces [status|on|off|preview|upload|upload-current|upload-all|login]");
-    }
     async handleContextCommand() {
         let info;
         try {