@theia/ai-ide 1.76.0-next.7 → 1.76.0

package/src/browser/ide-chat-welcome-message-provider.tsx

@@ -20,16 +20,16 @@ import { nls } from '@theia/core/lib/common/nls';
 import { inject, injectable, postConstruct } from '@theia/core/shared/inversify';
 import { codicon, LocalizedMarkdown, MarkdownRenderer } from '@theia/core/lib/browser';
 import { CommandRegistry, DisposableCollection, Emitter, Event, PreferenceScope } from '@theia/core';
-import { AgentService, FrontendLanguageModelRegistry } from '@theia/ai-core/lib/common';
+import { FrontendLanguageModelRegistry } from '@theia/ai-core/lib/common';
 import { PreferenceService } from '@theia/core/lib/common';
-import { DEFAULT_CHAT_AGENT_PREF, BYPASS_MODEL_REQUIREMENT_PREF, PERSISTED_SESSION_LIMIT_PREF, SESSION_STORAGE_PREF } from '@theia/ai-chat/lib/common/ai-chat-preferences';
-import { ChatAgentRecommendationService, ChatAgentService, ChatService } from '@theia/ai-chat/lib/common';
-import { ToolConfirmationManager } from '@theia/ai-chat/lib/browser/chat-tool-preference-bindings';
-import { DEFAULT_TOOL_CONFIRMATION_PREFERENCE, TOOL_CONFIRMATION_PREFERENCE, ToolConfirmationMode } from '@theia/ai-chat/lib/common/chat-tool-preferences';
-import { OPEN_AI_CONFIG_VIEW, OPEN_AI_CONFIG_VIEW_TOOLS } from './ai-configuration/ai-configuration-view-contribution';
+import { BYPASS_MODEL_REQUIREMENT_PREF, DEFAULT_CHAT_AGENT_PREF } from '@theia/ai-chat/lib/common/ai-chat-preferences';
+import { WalkthroughService } from '@theia/getting-started/lib/browser/walkthrough-service';
+import { OPEN_AI_CONFIG_VIEW } from './ai-configuration/ai-configuration-view-contribution';
 import { AIActivationService } from '@theia/ai-core/lib/browser';
 import { FrontendApplicationConfigProvider } from '@theia/core/lib/browser/frontend-application-config-provider';
 import { WorkspaceCommands } from '@theia/workspace/lib/browser/workspace-commands';
+import { AI_OPEN_GETTING_STARTED_WALKTHROUGH } from './ai-getting-started-commands';
+import { AI_GETTING_STARTED_WALKTHROUGH_ID } from './ai-getting-started-walkthrough';
 
 const TheiaIdeAiLogo = ({ width = 120, height = 120, className = '' }) =>
     <svg
@@ -59,6 +59,13 @@ const TheiaIdeAiLogo = ({ width = 120, height = 120, className = '' }) =>
         <circle cx="62" cy="84" r="2.5" fill="var(--theia-disabledForeground)" opacity="0.65" />
     </svg>;
 
+/**
+ * The welcome message of the chat view.
+ *
+ * It only covers what has to be shown right here: the states that keep the chat from working (no language
+ * model, AI turned off, workspace not trusted) and a one-line reminder of how to talk to the agents. Everything
+ * that teaches the AI features lives in the "Get started with AI" walkthrough, which each state links to.
+ */
 @injectable()
 export class IdeChatWelcomeMessageProvider implements ChatWelcomeMessageProvider {
 
@@ -76,31 +83,17 @@ export class IdeChatWelcomeMessageProvider implements ChatWelcomeMessageProvider
     @inject(PreferenceService)
     protected preferenceService: PreferenceService;
 
-    @inject(ChatAgentRecommendationService)
-    protected recommendationService: ChatAgentRecommendationService;
-
-    @inject(ChatAgentService)
-    protected chatAgentService: ChatAgentService;
-
-    @inject(AgentService)
-    protected agentService: AgentService;
-
-    @inject(ToolConfirmationManager)
-    protected readonly toolConfirmationManager: ToolConfirmationManager;
-
     @inject(AIActivationService)
     protected readonly activationService: AIActivationService;
 
-    @inject(ChatService)
-    protected readonly chatService: ChatService;
+    @inject(WalkthroughService)
+    protected readonly walkthroughService: WalkthroughService;
 
     protected readonly toDispose = new DisposableCollection();
     protected _hasReadyModels = false;
     protected _modelRequirementBypassed = false;
-    protected _defaultAgent = '';
+    protected _hasDefaultAgent = false;
     protected modelConfig: { hasModels: boolean; errorMessages: string[] } | undefined;
-    /** True once the user has any chat (active or persisted). Drives the compact "has-chats" welcome variant. */
-    protected hasAnyChat = false;
 
     protected readonly onStateChangedEmitter = new Emitter<void>();
 
@@ -118,44 +111,28 @@ export class IdeChatWelcomeMessageProvider implements ChatWelcomeMessageProvider
         );
         this.toDispose.push(
             this.preferenceService.onPreferenceChanged(e => {
-                if (e.preferenceName === DEFAULT_CHAT_AGENT_PREF) {
-                    const effectiveValue = this.preferenceService.get<string>(DEFAULT_CHAT_AGENT_PREF, '');
-                    if (this._defaultAgent !== effectiveValue) {
-                        this._defaultAgent = effectiveValue;
-                        this.notifyStateChanged();
-                    }
-                } else if (e.preferenceName === BYPASS_MODEL_REQUIREMENT_PREF) {
+                if (e.preferenceName === BYPASS_MODEL_REQUIREMENT_PREF) {
                     const effectiveValue = this.preferenceService.get<boolean>(BYPASS_MODEL_REQUIREMENT_PREF, false);
                     if (this._modelRequirementBypassed !== effectiveValue) {
                         this._modelRequirementBypassed = effectiveValue;
                         this.notifyStateChanged();
                     }
-                } else if (e.preferenceName === DEFAULT_TOOL_CONFIRMATION_PREFERENCE || e.preferenceName === TOOL_CONFIRMATION_PREFERENCE) {
-                    // Re-render so the tool-confirmation explainer is hidden once the user configures confirmation behavior.
-                    this.notifyStateChanged();
-                } else if (e.preferenceName === SESSION_STORAGE_PREF || e.preferenceName === PERSISTED_SESSION_LIMIT_PREF) {
-                    this.refreshHasAnyChat();
+                } else if (e.preferenceName === DEFAULT_CHAT_AGENT_PREF) {
+                    this.updateDefaultAgentState();
                 }
             })
         );
+        // The setup action disappears once the walkthrough is done.
         this.toDispose.push(
-            this.chatService.onSessionEvent(() => this.refreshHasAnyChat())
-        );
-        this.refreshHasAnyChat();
-        this.toDispose.push(
-            this.agentService.onDidChangeAgents(() => {
-                this.notifyStateChanged();
-            })
+            this.walkthroughService.onDidChangeWalkthroughs(() => this.notifyStateChanged())
         );
         this.analyzeModelConfiguration().then(config => {
             this.modelConfig = config;
             this.notifyStateChanged();
         });
         this.preferenceService.ready.then(() => {
-            const defaultAgentValue = this.preferenceService.get(DEFAULT_CHAT_AGENT_PREF, '');
-            const bypassValue = this.preferenceService.get(BYPASS_MODEL_REQUIREMENT_PREF, false);
-            this._defaultAgent = defaultAgentValue;
-            this._modelRequirementBypassed = bypassValue;
+            this._modelRequirementBypassed = this.preferenceService.get(BYPASS_MODEL_REQUIREMENT_PREF, false);
+            this.updateDefaultAgentState();
             this.notifyStateChanged();
         });
         // Listen to both canRun and activeStatus changes. They may change independent from each other.
@@ -171,6 +148,14 @@ export class IdeChatWelcomeMessageProvider implements ChatWelcomeMessageProvider
         );
     }
 
+    protected updateDefaultAgentState(): void {
+        const hasDefaultAgent = !!this.preferenceService.get<string>(DEFAULT_CHAT_AGENT_PREF, '');
+        if (this._hasDefaultAgent !== hasDefaultAgent) {
+            this._hasDefaultAgent = hasDefaultAgent;
+            this.notifyStateChanged();
+        }
+    }
+
     protected async checkLanguageModelStatus(): Promise<void> {
         const models = await this.languageModelRegistry.getLanguageModels();
         this._hasReadyModels = models.some(model => model.status.status === 'ready');
@@ -193,28 +178,6 @@ export class IdeChatWelcomeMessageProvider implements ChatWelcomeMessageProvider
         this.onStateChangedEmitter.fire();
     }
 
-    /**
-     * Recomputes {@link hasAnyChat} (true when the user has any titled active session or any
-     * persisted session on disk). Fires a state change when the flag flips so the welcome
-     * variant updates between the rich onboarding (no chats yet) and the compact mode.
-     */
-    protected async refreshHasAnyChat(): Promise<void> {
-        const hasTitledActive = this.chatService.getSessions().some(s => !!s.title);
-        let hasPersisted = false;
-        if (!hasTitledActive) {
-            try {
-                hasPersisted = await this.chatService.hasPersistedSessions();
-            } catch {
-                hasPersisted = false;
-            }
-        }
-        const next = hasTitledActive || hasPersisted;
-        if (this.hasAnyChat !== next) {
-            this.hasAnyChat = next;
-            this.notifyStateChanged();
-        }
-    }
-
     get hasReadyModels(): boolean {
         return this._hasReadyModels;
     }
@@ -223,31 +186,23 @@ export class IdeChatWelcomeMessageProvider implements ChatWelcomeMessageProvider
         return this._modelRequirementBypassed;
     }
 
-    get defaultAgent(): string {
-        return this._defaultAgent;
-    }
-
     /**
-     * Whether to show the tool-confirmation explainer on the welcome screen.
-     *
-     * Only shown while the user is still in the default state, i.e. every tool call is confirmed and
-     * no per-tool overrides exist. Once the user has changed the default mode (e.g. to always allow
-     * or to disable tools) or pre-approved individual tools (including via bulk approval), they are
-     * already aware of the mechanism, so the explainer is suppressed.
+     * Whether the getting started walkthrough still has something to offer. Once it is finished, the chat view
+     * stops advertising it.
      */
-    protected get shouldShowToolConfirmationInfo(): boolean {
-        return this.toolConfirmationManager.getDefaultConfirmationMode() === ToolConfirmationMode.CONFIRM
-            && Object.keys(this.toolConfirmationManager.getAllConfirmationSettings()).length === 0;
+    protected get hasPendingWalkthroughSteps(): boolean {
+        const { completed, total } = this.walkthroughService.getStepProgress(AI_GETTING_STARTED_WALKTHROUGH_ID);
+        return total > 0 && completed < total;
     }
 
+    protected openWalkthrough = () => this.commandRegistry.executeCommand(AI_OPEN_GETTING_STARTED_WALKTHROUGH.id);
+
+    protected openAiConfiguration = () => this.commandRegistry.executeCommand(OPEN_AI_CONFIG_VIEW.id);
+
     protected setModelRequirementBypassed(bypassed: boolean): void {
         this.preferenceService.set(BYPASS_MODEL_REQUIREMENT_PREF, bypassed, PreferenceScope.User);
     }
 
-    protected setDefaultAgent(agentId: string): void {
-        this.preferenceService.set(DEFAULT_CHAT_AGENT_PREF, agentId, PreferenceScope.User);
-    }
-
     dispose(): void {
         this.toDispose.dispose();
         this.onStateChangedEmitter.dispose();
@@ -257,87 +212,75 @@ export class IdeChatWelcomeMessageProvider implements ChatWelcomeMessageProvider
         if (!this._hasReadyModels && !this._modelRequirementBypassed) {
             return this.renderModelConfigurationScreen();
         }
-        if (!this._defaultAgent) {
-            return this.renderAgentSelectionScreen();
-        }
         return this.renderWelcomeScreen();
     }
 
     protected renderWelcomeScreen(): React.ReactNode {
-        if (this.hasAnyChat) {
-            // Returning user: keep a slim banner (logo + heading + one-line tip) above the
-            // sessions list so the chat view still has identity, but skip the verbose
-            // multi-paragraph tutorial.
-            return <div className={'theia-WelcomeMessage theia-WelcomeMessage-Compact'} key="normal-welcome-compact">
-                <TheiaIdeAiLogo className="theia-WelcomeMessage-Logo" width={64} height={64} />
-                <LocalizedMarkdown
-                    localizationKey="theia/ai/ide/chatWelcomeMessageShort"
-                    defaultMarkdown={`
-## Ask the {0} AI
-
-Use *@agent* to call a specialized agent and *#* (or {1}) to attach context. [Learn more](https://theia-ide.org/docs/user_ai/#chat).
-`}
-                    args={[
-                        FrontendApplicationConfigProvider.get().applicationName,
-                        '<span class="codicon codicon-attach"></span>'
-                    ]}
-                    markdownRenderer={this.markdownRenderer}
-                    className="theia-WelcomeMessage-Content"
-                    markdownOptions={{ supportHtml: true }}
-                />
-                {this.renderToolConfirmationAlert()}
-            </div>;
-        }
-        // First-time user: original full-length onboarding with the larger logo and the
-        // verbose agent/context paragraphs so the empty panel feels welcoming.
-        return <div className={'theia-WelcomeMessage theia-WelcomeMessage-Main'} key="normal-welcome">
-            <TheiaIdeAiLogo className="theia-WelcomeMessage-Logo" />
+        return <div className={'theia-WelcomeMessage theia-WelcomeMessage-Compact'} key="normal-welcome">
+            <TheiaIdeAiLogo className="theia-WelcomeMessage-Logo" width={64} height={64} />
             <LocalizedMarkdown
-                localizationKey="theia/ai/ide/chatWelcomeMessage"
+                localizationKey="theia/ai/ide/chatWelcomeMessageShort"
                 defaultMarkdown={`
-## Ask the {7} AI
-
-Use *@AgentName* to talk to a specialized agent, like *@{0}*, *@{1}*, or *@{2}*.
+## Ask the {0} AI
 
-Attach context with *#{3}*, *#{4}*, *#{5}*, or click {6}. [Learn more](https://theia-ide.org/docs/user_ai/#chat).
+Use *@agent* to call a specialized agent and *#* (or {1}) to attach context. [Learn more](https://theia-ide.org/docs/user_ai/#chat).
 `}
-                args={['Coder', 'Architect', 'Universal', 'file', '_f', 'selectedText', '<span class="codicon codicon-attach"></span>',
-                    FrontendApplicationConfigProvider.get().applicationName]}
+                args={[
+                    FrontendApplicationConfigProvider.get().applicationName,
+                    '<span class="codicon codicon-attach"></span>'
+                ]}
                 markdownRenderer={this.markdownRenderer}
                 className="theia-WelcomeMessage-Content"
                 markdownOptions={{ supportHtml: true }}
             />
-            {this.renderToolConfirmationAlert()}
+            {this.renderDefaultAgentAlert()}
+            {this.renderWalkthroughAction()}
         </div>;
     }
 
-    protected renderToolConfirmationAlert(): React.ReactNode {
-        if (!this.shouldShowToolConfirmationInfo) {
+    /**
+     * Nothing answers a message that does not name an agent while no default agent is configured, so the chat
+     * has to say so where the message is typed rather than leaving the first request to fail.
+     */
+    protected renderDefaultAgentAlert(): React.ReactNode {
+        if (this._hasDefaultAgent) {
             return undefined;
         }
         return (
             <div className="theia-alert theia-info-alert theia-WelcomeMessage-Alert">
                 <div className="theia-message-header">
                     <span className={codicon('info')}></span>
-                    <span>{nls.localize('theia/ai/ide/toolConfirmationInfo/header', 'Tool confirmation')}</span>
+                    <span>{nls.localize('theia/ai/ide/noDefaultAgent/header', 'No default agent')}</span>
                 </div>
                 <div className="theia-message-content">
                     <LocalizedMarkdown
-                        localizationKey="theia/ai/ide/toolConfirmationInfo"
-                        defaultMarkdown={
-                            'AI agents may want to use tools to act on your workspace. ' +
-                            'By default each tool call needs your confirmation. ' +
-                            'You can change this default or pre-approve individual tools in the [Tools configuration view]({0}).'
-                        }
-                        args={[`command:${OPEN_AI_CONFIG_VIEW_TOOLS.id}`]}
+                        localizationKey="theia/ai/ide/noDefaultAgent"
+                        defaultMarkdown={'Address an agent with *@AgentName*, or [choose the agent]({0}) that answers when you do not name one.'}
+                        args={[`command:${OPEN_AI_CONFIG_VIEW.id}?${DEFAULT_CHAT_AGENT_PREF}`]}
                         markdownRenderer={this.markdownRenderer}
-                        markdownOptions={{ isTrusted: { enabledCommands: [OPEN_AI_CONFIG_VIEW_TOOLS.id] } }}
+                        markdownOptions={{ isTrusted: { enabledCommands: [OPEN_AI_CONFIG_VIEW.id] } }}
                     />
                 </div>
             </div>
         );
     }
 
+    /**
+     * The entry point into the walkthrough, shown while it is unfinished.
+     */
+    protected renderWalkthroughAction(): React.ReactNode {
+        if (!this.hasPendingWalkthroughSteps) {
+            return undefined;
+        }
+        return <div className="theia-WelcomeMessage-Actions">
+            <button
+                className="theia-button secondary"
+                onClick={this.openWalkthrough}>
+                {AI_OPEN_GETTING_STARTED_WALKTHROUGH.label}
+            </button>
+        </div>;
+    }
+
     protected renderModelConfigurationScreen(): React.ReactNode {
         const config = this.modelConfig ?? { hasModels: false, errorMessages: [] };
         const { hasModels, errorMessages } = config;
@@ -383,20 +326,16 @@ This typically happens in custom IDE distributions where Theia AI language model
                 defaultMarkdown={`
 ## Configure a Language Model
 
-Set up an API key for [OpenAI]({0}), [Anthropic]({1}), or [GoogleAI]({2}) or configure another provider like Ollama in the settings.
+Set up an API key for a provider like OpenAI, Anthropic or GoogleAI, or connect a local one such as Ollama.
 
-Some agents (e.g. Claude Code) work without a provider. [Learn more](https://theia-ide.org/docs/user_ai/).
+New here? [Get started with AI]({0}) walks you through the setup.
 `}
-                args={[
-                    `command:${OPEN_AI_CONFIG_VIEW.id}?ai-features.openAiOfficial.openAiApiKey`,
-                    `command:${OPEN_AI_CONFIG_VIEW.id}?ai-features.anthropic.AnthropicApiKey`,
-                    `command:${OPEN_AI_CONFIG_VIEW.id}?ai-features.google.apiKey`
-                ]}
+                args={[`command:${AI_OPEN_GETTING_STARTED_WALKTHROUGH.id}`]}
                 markdownRenderer={this.markdownRenderer}
                 className="theia-WelcomeMessage-Content"
                 markdownOptions={{
                     supportHtml: true,
-                    isTrusted: { enabledCommands: [OPEN_AI_CONFIG_VIEW.id] }
+                    isTrusted: { enabledCommands: [AI_OPEN_GETTING_STARTED_WALKTHROUGH.id] }
                 }}
             />
             {errorMessages.length > 0 && (
@@ -415,7 +354,7 @@ Some agents (e.g. Claude Code) work without a provider. [Learn more](https://the
             <div className="theia-WelcomeMessage-Actions">
                 <button
                     className="theia-button main"
-                    onClick={() => this.commandRegistry.executeCommand(OPEN_AI_CONFIG_VIEW.id)}>
+                    onClick={this.openAiConfiguration}>
                     {nls.localize('theia/ai/ide/openAiConfiguration', 'Open AI Configuration')}
                 </button>
                 <button
@@ -427,62 +366,6 @@ Some agents (e.g. Claude Code) work without a provider. [Learn more](https://the
         </div>;
     }
 
-    protected renderAgentSelectionScreen(): React.ReactNode {
-        const recommendedAgents = this.recommendationService.getRecommendedAgents()
-            .filter(agent => this.chatAgentService.getAgent(agent.id) !== undefined);
-
-        return <div className={'theia-WelcomeMessage theia-WelcomeMessage-Main theia-WelcomeMessage-AgentSelection'} key="agent-selection">
-            <TheiaIdeAiLogo className="theia-WelcomeMessage-Logo" />
-            <LocalizedMarkdown
-                localizationKey="theia/ai/ide/selectDefaultAgent"
-                defaultMarkdown={`
-## Select a Default Chat Agent
-
-Choose the agent to use by default. You can always override this by mentioning *@AgentName* in your message.
-`}
-                markdownRenderer={this.markdownRenderer}
-                className="theia-WelcomeMessage-Content"
-            />
-            {recommendedAgents.length > 0 ? (
-                <div className="theia-WelcomeMessage-AgentButtons">
-                    {recommendedAgents.map(agent => (
-                        <button
-                            key={agent.id}
-                            className="theia-WelcomeMessage-AgentButton"
-                            onClick={() => this.setDefaultAgent(agent.id)}
-                            title={agent.description}>
-                            <span className={`theia-WelcomeMessage-AgentButton-Icon ${codicon('mention')}`}></span>
-                            <span className="theia-WelcomeMessage-AgentButton-Label">{agent.label}</span>
-                        </button>
-                    ))}
-                </div>
-            ) : (
-                <p className="theia-WelcomeMessage-SubNote">
-                    {nls.localize('theia/ai/ide/noRecommendedAgents', 'No recommended agents are available.')}
-                </p>
-            )}
-            <div className="theia-alert theia-info-alert theia-WelcomeMessage-Alert">
-                <div className="theia-message-header">
-                    <span className={codicon('info')}></span>
-                    <span>
-                        {recommendedAgents.length > 0
-                            ? nls.localize('theia/ai/ide/moreAgentsAvailable/header', 'More agents are available')
-                            : nls.localize('theia/ai/ide/configureAgent/header', 'Configure a default agent')}
-                    </span>
-                </div>
-                <div className="theia-message-content">
-                    <LocalizedMarkdown
-                        localizationKey="theia/ai/ide/moreAgentsAvailable"
-                        defaultMarkdown='Use @AgentName to try others or configure a different default in [preferences]({0}).'
-                        args={[`command:${OPEN_AI_CONFIG_VIEW.id}?ai-features.chat.defaultChatAgent`]}
-                        markdownRenderer={this.markdownRenderer}
-                        markdownOptions={{ isTrusted: { enabledCommands: [OPEN_AI_CONFIG_VIEW.id] } }}
-                    />
-                </div>
-            </div>
-        </div>;
-    }
-
     renderDisabledMessage(): React.ReactNode {
         if (this.activationService.isActive && !this.activationService.canRun) {
             return this.renderTrustRestrictedMessage();
@@ -521,8 +404,6 @@ Choose the agent to use by default. You can always override this by mentioning *
     }
 
     protected renderPreferenceDisabledMessage(): React.ReactNode {
-        const openAiHistory = 'aiHistory:open';
-
         return <div className={'theia-WelcomeMessage theia-WelcomeMessage-Main theia-WelcomeMessage-Disabled'} key="disabled-message">
             <TheiaIdeAiLogo className="theia-WelcomeMessage-Logo" />
             <div className="theia-WelcomeMessage-Content">
@@ -536,44 +417,26 @@ Choose the agent to use by default. You can always override this by mentioning *
                 <div className="theia-message-content">
                     <LocalizedMarkdown
                         localizationKey="theia/ai/ide/chatDisabledMessage/steps"
-                        defaultMarkdown={`1. Enable AI features in the settings
-2. Configure at least one LLM provider (e.g. OpenAI, Anthropic, GoogleAI or Ollama)
-3. Start chatting with powerful AI agents`}
+                        defaultMarkdown={'Turn the AI features on, connect a language model and pick an agent. '
+                            + '[Get started with AI]({0}) takes you through it step by step.'}
+                        args={[`command:${AI_OPEN_GETTING_STARTED_WALKTHROUGH.id}`]}
                         markdownRenderer={this.markdownRenderer}
+                        markdownOptions={{ isTrusted: { enabledCommands: [AI_OPEN_GETTING_STARTED_WALKTHROUGH.id] } }}
                     />
                 </div>
             </div>
             <div className="theia-WelcomeMessage-Actions">
                 <button
                     className="theia-button main"
-                    onClick={() => this.commandRegistry.executeCommand(OPEN_AI_CONFIG_VIEW.id)}>
+                    onClick={this.openAiConfiguration}>
                     {nls.localize('theia/ai/ide/openAiConfiguration', 'Open AI Configuration')}
                 </button>
+                <button
+                    className="theia-button secondary"
+                    onClick={this.openWalkthrough}>
+                    {AI_OPEN_GETTING_STARTED_WALKTHROUGH.label}
+                </button>
             </div>
-            <LocalizedMarkdown
-                localizationKey="theia/ai/ide/chatDisabledMessage/features"
-                defaultMarkdown={`This will activate the AI features in the app.
-
-Please support us by [providing feedback](https://github.com/eclipse-theia/theia)!
-
-Once the AI features are enabled, you can access the following views and features:
-- Code Completion
-- Terminal Assistance (via CTRL+I in a terminal)
-- This Chat View - available agents include:
-  - Coder Chat Agent
-  - Architect Chat Agent
-  - Universal Chat Agent
-- [AI History View]({0})
-- [AI Configuration View]({1})
-
-See [the documentation](https://theia-ide.org/docs/user_ai/) for more information.`}
-                args={[`command:${openAiHistory}`, `command:${OPEN_AI_CONFIG_VIEW.id}`]}
-                markdownRenderer={this.markdownRenderer}
-                className="theia-WelcomeMessage-Content"
-                markdownOptions={{
-                    isTrusted: { enabledCommands: [openAiHistory, OPEN_AI_CONFIG_VIEW.id] }
-                }}
-            />
         </div>;
     }
 }

package/src/browser/review/pr-review-capability-contribution.ts

@@ -99,7 +99,7 @@ Completeness is critical. Every review comment and every changed file must be in
     }
 
     protected buildLocalCheckoutTemplate(): string {
-        const name = nls.localize('theia/ai/ide/prReview/capability/localCheckout/name', 'Checkout');
+        const name = nls.localizeByDefault('Checkout');
         const description = nls.localize('theia/ai/ide/prReview/capability/localCheckout/description',
             'Checks out the pull request locally and protects existing worktree changes.');
 

package/src/browser/style/commit-message-overlay.css

@@ -0,0 +1,64 @@
+/********************************************************************************
+ * Copyright (C) 2026 EclipseSource GmbH.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+ ********************************************************************************/
+
+.theia-ai-commit-message-input-wrapper {
+    position: relative;
+}
+
+/* Reserve space on the right of the SCM input so user text does not run under the icon.
+   Selecting by descendant `textarea` instead of `#theia-scm-input-message` decouples this
+   rule from the SCM widget's element id (`ScmCommitWidget.Styles.INPUT_MESSAGE`), which
+   would otherwise silently break this layout if it ever gets renamed upstream. */
+.theia-ai-commit-message-input-wrapper textarea {
+    padding-right: 30px;
+}
+
+.theia-ai-commit-message-overlay {
+    position: absolute;
+    top: 4px;
+    right: 6px;
+    display: inline-flex;
+    pointer-events: auto;
+    /* Stay above the textarea so the button remains clickable. */
+    z-index: 1;
+}
+
+.theia-ai-commit-message-icon {
+    background: transparent;
+    border: none;
+    cursor: pointer;
+    padding: 2px;
+    color: var(--theia-icon-foreground);
+    opacity: 0.7;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: 3px;
+}
+
+.theia-ai-commit-message-icon:hover:not(:disabled) {
+    opacity: 1;
+    background-color: var(--theia-toolbar-hoverBackground);
+}
+
+.theia-ai-commit-message-icon:disabled {
+    opacity: 0.3;
+    cursor: default;
+}
+
+.theia-ai-commit-message-icon .codicon {
+    font-size: var(--theia-ui-font-size1);
+}

package/src/browser/style/index.css

@@ -23,6 +23,7 @@
 
 /* Import widget-specific styles */
 @import "./widgets/model-aliases-configuration.css";
+@import "./commit-message-overlay.css";
 
 /* Override preferences grid layout for AI Configuration widgets */
 .ai-configuration-widget.theia-settings-container {
@@ -869,7 +870,7 @@ button.agent-chip:focus-visible {
   padding-top: calc(var(--theia-ui-padding) * 8);
 }
 
-/* Compact greeting used when the home view also shows recent sessions */
+/* Compact greeting of a working chat: the onboarding itself lives in the getting started walkthrough */
 .theia-WelcomeMessage-Compact {
   padding-top: calc(var(--theia-ui-padding) * 2);
 }
@@ -1025,46 +1026,6 @@ button.agent-chip:focus-visible {
   margin-bottom: calc(var(--theia-ui-padding) * 0.25);
 }
 
-.theia-WelcomeMessage-AgentButtons {
-  display: flex;
-  flex-direction: column;
-  gap: var(--theia-ui-padding);
-  margin: calc(var(--theia-ui-padding) * 2) 0;
-}
-
-.theia-WelcomeMessage-AgentButton {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  gap: calc(var(--theia-ui-padding) * 0.5);
-  padding: calc(var(--theia-ui-padding) * 0.75) calc(var(--theia-ui-padding) * 1.5);
-  background-color: var(--theia-button-background);
-  color: var(--theia-button-foreground);
-  border: 1px solid var(--theia-button-border);
-  border-radius: 4px;
-  cursor: pointer;
-  font-size: var(--theia-ui-font-size1);
-  transition: background-color 0.15s;
-}
-
-.theia-WelcomeMessage-AgentButton:hover {
-  background-color: var(--theia-button-hoverBackground);
-}
-
-.theia-WelcomeMessage-AgentButton-Icon {
-  font-size: var(--theia-ui-font-size1);
-}
-
-.theia-WelcomeMessage-AgentButton-Label {
-  font-weight: 500;
-}
-
-.theia-WelcomeMessage-SubNote {
-  font-size: var(--theia-ui-font-size1);
-  color: var(--theia-descriptionForeground);
-  margin-top: calc(var(--theia-ui-padding) * 2);
-}
-
 .theia-WelcomeMessage-Alert {
   max-width: 350px;
   margin-top: calc(var(--theia-ui-padding) * 3);
@@ -2231,7 +2192,8 @@ button.agent-chip:focus-visible {
   margin: 0;
   padding: 4px 0;
   min-width: 180px;
-  max-height: 320px;
+  max-height: 200px;
+  box-sizing: border-box;
   overflow-y: auto;
 }