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

package/lib/browser/ai-getting-started-contribution.js

@@ -0,0 +1,70 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiGettingStartedContribution = void 0;
+const tslib_1 = require("tslib");
+const preferences_1 = require("@theia/core/lib/common/preferences");
+const message_service_1 = require("@theia/core/lib/common/message-service");
+const nls_1 = require("@theia/core/lib/common/nls");
+const common_1 = require("@theia/ai-chat/lib/common");
+const ai_chat_preferences_1 = require("@theia/ai-chat/lib/common/ai-chat-preferences");
+const walkthrough_commands_1 = require("@theia/getting-started/lib/common/walkthrough-commands");
+const inversify_1 = require("@theia/core/shared/inversify");
+const ai_getting_started_walkthrough_1 = require("./ai-getting-started-walkthrough");
+const ai_getting_started_commands_1 = require("./ai-getting-started-commands");
+/**
+ * Opens the AI getting started walkthrough from anywhere - the chat view, the command palette or a menu -
+ * without every caller having to know the walkthrough id.
+ */
+let AiGettingStartedContribution = class AiGettingStartedContribution {
+    registerCommands(commands) {
+        // Deliberately not gated on the AI features being enabled: this is where they get enabled.
+        commands.registerCommand(ai_getting_started_commands_1.AI_OPEN_GETTING_STARTED_WALKTHROUGH, {
+            execute: () => commands.executeCommand(walkthrough_commands_1.WalkthroughCommands.OPEN_WALKTHROUGH.id, ai_getting_started_walkthrough_1.AI_GETTING_STARTED_WALKTHROUGH_ID)
+        });
+        commands.registerCommand(ai_getting_started_commands_1.AI_SET_DEFAULT_CHAT_AGENT, {
+            execute: (agentId) => this.setDefaultChatAgent(agentId),
+            isEnabled: (agentId) => typeof agentId === 'string' && !!agentId
+        });
+    }
+    /**
+     * Writes the default chat agent preference and says so: the walkthrough offers this as a button, and
+     * without the message the only feedback would be the step ticking itself off further up the page.
+     */
+    async setDefaultChatAgent(agentId) {
+        await this.preferenceService.set(ai_chat_preferences_1.DEFAULT_CHAT_AGENT_PREF, agentId, preferences_1.PreferenceScope.User);
+        const label = this.chatAgentService.getAgent(agentId)?.name ?? agentId;
+        this.messageService.info(nls_1.nls.localize('theia/ai/ide/defaultChatAgentSet', 'The default chat agent is now {0}.', label));
+    }
+};
+exports.AiGettingStartedContribution = AiGettingStartedContribution;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(preferences_1.PreferenceService),
+    tslib_1.__metadata("design:type", Object)
+], AiGettingStartedContribution.prototype, "preferenceService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(message_service_1.MessageService),
+    tslib_1.__metadata("design:type", message_service_1.MessageService)
+], AiGettingStartedContribution.prototype, "messageService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.ChatAgentService),
+    tslib_1.__metadata("design:type", Object)
+], AiGettingStartedContribution.prototype, "chatAgentService", void 0);
+exports.AiGettingStartedContribution = AiGettingStartedContribution = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], AiGettingStartedContribution);
+//# sourceMappingURL=ai-getting-started-contribution.js.map

package/lib/browser/ai-getting-started-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-getting-started-contribution.js","sourceRoot":"","sources":["../../src/browser/ai-getting-started-contribution.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAGhF,oEAAwF;AACxF,4EAAwE;AACxE,oDAAiD;AACjD,sDAA6D;AAC7D,uFAAwF;AACxF,iGAA6F;AAC7F,4DAAkE;AAClE,qFAAqF;AACrF,+EAA+G;AAE/G;;;GAGG;AAEI,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IAWrC,gBAAgB,CAAC,QAAyB;QACtC,2FAA2F;QAC3F,QAAQ,CAAC,eAAe,CAAC,iEAAmC,EAAE;YAC1D,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,0CAAmB,CAAC,gBAAgB,CAAC,EAAE,EAAE,kEAAiC,CAAC;SACrH,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,CAAC,uDAAyB,EAAE;YAChD,OAAO,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;YAC/D,SAAS,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO;SAC5E,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,mBAAmB,CAAC,OAAe;QAC/C,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,6CAAuB,EAAE,OAAO,EAAE,6BAAe,CAAC,IAAI,CAAC,CAAC;QACzF,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,OAAO,CAAC;QACvE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAG,CAAC,QAAQ,CAAC,kCAAkC,EAAE,oCAAoC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5H,CAAC;CACJ,CAAA;AA/BY,oEAA4B;AAGlB;IADlB,IAAA,kBAAM,EAAC,+BAAiB,CAAC;;uEAC8B;AAGrC;IADlB,IAAA,kBAAM,EAAC,gCAAc,CAAC;sCACY,gCAAc;oEAAC;AAG/B;IADlB,IAAA,kBAAM,EAAC,yBAAgB,CAAC;;sEAC6B;uCAT7C,4BAA4B;IADxC,IAAA,sBAAU,GAAE;GACA,4BAA4B,CA+BxC"}

package/lib/browser/ai-getting-started-walkthrough.d.ts

@@ -0,0 +1,41 @@
+import { ChatAgentRecommendationService } from '@theia/ai-chat/lib/common';
+import { WalkthroughProvider } from '@theia/getting-started/lib/common/walkthrough-provider';
+import { WalkthroughDefinition, WalkthroughStepDefinition } from '@theia/getting-started/lib/common/walkthrough-types';
+/**
+ * Id of the walkthrough that guides a new user through setting up and using the AI features.
+ * Also the argument of the `walkthrough.open` command.
+ */
+export declare const AI_GETTING_STARTED_WALKTHROUGH_ID = "ai-features.getting-started";
+/**
+ * Contributes the "Get started with AI" walkthrough to the welcome page: the single, progress-tracked path
+ * from disabled AI features to a first answer in the chat.
+ */
+export declare class AiGettingStartedWalkthroughProvider implements WalkthroughProvider {
+    protected readonly recommendationService: ChatAgentRecommendationService;
+    protected walkthrough: WalkthroughDefinition | undefined;
+    getWalkthroughs(): WalkthroughDefinition[];
+    protected get applicationName(): string;
+    /** Deep-links into the AI Configuration view, which takes a category id or an `ai-features.*` preference id. */
+    protected aiConfiguration(target?: string): string;
+    protected createWalkthrough(): WalkthroughDefinition;
+    /**
+     * The opening slide, carrying what the welcome page used to announce in its AI banner: what the features
+     * are, that they are opt-in and may incur costs, and the invitation to the community behind them.
+     */
+    protected createAiSupportStep(): WalkthroughStepDefinition;
+    protected createEnableStep(): WalkthroughStepDefinition;
+    protected createModelStep(): WalkthroughStepDefinition;
+    protected createAgentStep(): WalkthroughStepDefinition;
+    /**
+     * One action per recommended agent, each setting it as the default right away.
+     *
+     * Every link stands alone in its paragraph, which is what the welcome page renders as a button, so this
+     * reads like the buttons the chat welcome used to offer. Products customize the list through
+     * {@link ChatAgentRecommendationService}.
+     */
+    protected renderAgentChoices(): string;
+    protected createFirstQuestionStep(): WalkthroughStepDefinition;
+    protected createToolConfirmationStep(): WalkthroughStepDefinition;
+    protected createGoFurtherStep(): WalkthroughStepDefinition;
+}
+//# sourceMappingURL=ai-getting-started-walkthrough.d.ts.map

package/lib/browser/ai-getting-started-walkthrough.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-getting-started-walkthrough.d.ts","sourceRoot":"","sources":["../../src/browser/ai-getting-started-walkthrough.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAO3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAYvH;;;GAGG;AACH,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAM/E;;;GAGG;AACH,qBACa,mCAAoC,YAAW,mBAAmB;IAG3E,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;IAEzE,SAAS,CAAC,WAAW,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAEzD,eAAe,IAAI,qBAAqB,EAAE;IAM1C,SAAS,KAAK,eAAe,IAAI,MAAM,CAEtC;IAED,gHAAgH;IAChH,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlD,SAAS,CAAC,iBAAiB,IAAI,qBAAqB;IAkBpD;;;OAGG;IACH,SAAS,CAAC,mBAAmB,IAAI,yBAAyB;IAsB1D,SAAS,CAAC,gBAAgB,IAAI,yBAAyB;IAavD,SAAS,CAAC,eAAe,IAAI,yBAAyB;IAsBtD,SAAS,CAAC,eAAe,IAAI,yBAAyB;IAkBtD;;;;;;OAMG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAWtC,SAAS,CAAC,uBAAuB,IAAI,yBAAyB;IAkB9D,SAAS,CAAC,0BAA0B,IAAI,yBAAyB;IAkBjE,SAAS,CAAC,mBAAmB,IAAI,yBAAyB;CAuB7D"}

package/lib/browser/ai-getting-started-walkthrough.js

@@ -0,0 +1,225 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiGettingStartedWalkthroughProvider = exports.AI_GETTING_STARTED_WALKTHROUGH_ID = void 0;
+const tslib_1 = require("tslib");
+const ai_chat_ui_contribution_1 = require("@theia/ai-chat-ui/lib/browser/ai-chat-ui-contribution");
+const common_1 = require("@theia/ai-chat/lib/common");
+const ai_chat_preferences_1 = require("@theia/ai-chat/lib/common/ai-chat-preferences");
+const ai_activation_service_1 = require("@theia/ai-core/lib/browser/ai-activation-service");
+const ai_configuration_category_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/ai-configuration-category");
+const frontend_application_config_provider_1 = require("@theia/core/lib/browser/frontend-application-config-provider");
+const perspective_service_1 = require("@theia/core/lib/browser/perspective-service");
+const nls_1 = require("@theia/core/lib/common/nls");
+const inversify_1 = require("@theia/core/shared/inversify");
+const workspace_commands_1 = require("@theia/workspace/lib/browser/workspace-commands");
+const ai_getting_started_commands_1 = require("./ai-getting-started-commands");
+const ai_configuration_view_contribution_1 = require("./ai-configuration/ai-configuration-view-contribution");
+const ai_walkthrough_context_keys_1 = require("./ai-walkthrough-context-keys");
+/**
+ * Id of the walkthrough that guides a new user through setting up and using the AI features.
+ * Also the argument of the `walkthrough.open` command.
+ */
+exports.AI_GETTING_STARTED_WALKTHROUGH_ID = 'ai-features.getting-started';
+const AI_DOC_URL = 'https://theia-ide.org/docs/user_ai/';
+const THEIA_AI_DOC_URL = 'https://theia-ide.org/docs/theia_ai/';
+const FEEDBACK_URL = 'https://github.com/eclipse-theia/theia/issues/new/choose';
+/**
+ * Contributes the "Get started with AI" walkthrough to the welcome page: the single, progress-tracked path
+ * from disabled AI features to a first answer in the chat.
+ */
+let AiGettingStartedWalkthroughProvider = class AiGettingStartedWalkthroughProvider {
+    getWalkthroughs() {
+        // Built on demand rather than in the field initializer, so that the localization is in place.
+        this.walkthrough ??= this.createWalkthrough();
+        return [this.walkthrough];
+    }
+    get applicationName() {
+        return frontend_application_config_provider_1.FrontendApplicationConfigProvider.get().applicationName;
+    }
+    /** Deep-links into the AI Configuration view, which takes a category id or an `ai-features.*` preference id. */
+    aiConfiguration(target) {
+        return `command:${ai_configuration_view_contribution_1.OPEN_AI_CONFIG_VIEW.id}${target ? `?${target}` : ''}`;
+    }
+    createWalkthrough() {
+        return {
+            id: exports.AI_GETTING_STARTED_WALKTHROUGH_ID,
+            icon: 'sparkle',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/title', 'Get started with AI'),
+            description: nls_1.nls.localize('theia/ai/ide/walkthrough/description', 'Set up the AI features of {0} and learn how to work with them.', this.applicationName),
+            steps: [
+                this.createAiSupportStep(),
+                this.createEnableStep(),
+                this.createModelStep(),
+                this.createAgentStep(),
+                this.createFirstQuestionStep(),
+                this.createToolConfirmationStep(),
+                this.createGoFurtherStep()
+            ]
+        };
+    }
+    /**
+     * The opening slide, carrying what the welcome page used to announce in its AI banner: what the features
+     * are, that they are opt-in and may incur costs, and the invitation to the community behind them.
+     */
+    createAiSupportStep() {
+        return {
+            id: 'ai-support',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/aiSupport/title', 'AI support in {0}', this.applicationName),
+            description: nls_1.nls.localize('theia/ai/ide/walkthrough/aiSupport/description', `
+{0} comes with AI support: chat with specialized agents about your project, let them change code and run tasks, complete code as you type and get help in the terminal.
+
+These features are disabled by default, so that you can opt in at your own discretion.
+
+Once enabled, they may generate continuous requests to the language models you provide access to. This might incur costs that you need to monitor closely.
+
+[Read the documentation]({1}).
+
+We welcome your feedback, contributions and sponsorship! Visit the [GitHub project]({2}) to support the ongoing development. Thank you for being part of our community!
+
+All of this is built on Theia AI, the framework for AI-powered tools and IDEs, published as a stable release. [Read the framework documentation]({3}).
+`, this.applicationName, AI_DOC_URL, FEEDBACK_URL, THEIA_AI_DOC_URL).trim(),
+            // Reading it is done once the user acts on it, either by following a link or by turning the features on.
+            completionEvents: [`onContext:${ai_activation_service_1.ENABLE_AI_CONTEXT_KEY}`, `onLink:${AI_DOC_URL}`]
+        };
+    }
+    createEnableStep() {
+        return {
+            id: 'enable-ai',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/enableAi/title', 'Turn on the AI features'),
+            description: nls_1.nls.localize('theia/ai/ide/walkthrough/enableAi/description', `
+Nothing is sent anywhere until you switch the AI features on, and you can switch them off again at any time.
+
+[Open the AI Configuration]({0}) and enable them there.
+`, this.aiConfiguration(ai_activation_service_1.ENABLE_AI_CONTEXT_KEY)).trim(),
+            completionEvents: [`onContext:${ai_activation_service_1.ENABLE_AI_CONTEXT_KEY}`]
+        };
+    }
+    createModelStep() {
+        return {
+            id: 'connect-model',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/connectModel/title', 'Connect a language model'),
+            description: nls_1.nls.localize('theia/ai/ide/walkthrough/connectModel/description', `
+Add an API key for a hosted provider:
+
+- [OpenAI]({0})
+- [Anthropic]({1})
+- [Google]({2})
+
+Prefer to stay local or use another service? Ollama, llamafile and any OpenAI-compatible endpoint can be set up in the [Models]({3}) page.
+
+Some agents bring their own model, for example Claude Code, and work without a provider.
+`, this.aiConfiguration('ai-features.openAiOfficial.openAiApiKey'), this.aiConfiguration('ai-features.anthropic.AnthropicApiKey'), this.aiConfiguration('ai-features.google.apiKey'), this.aiConfiguration(ai_configuration_category_1.AiConfigurationCategoryId.MODELS)).trim(),
+            completionEvents: [`onContext:${ai_walkthrough_context_keys_1.AI_MODEL_READY_CONTEXT_KEY}`]
+        };
+    }
+    createAgentStep() {
+        const intro = nls_1.nls.localize('theia/ai/ide/walkthrough/chooseAgent/intro', `
+Every chat request goes to an agent, and one of them answers whenever you do not name one yourself.
+
+**Set your default agent:**
+`).trim();
+        const outro = nls_1.nls.localize('theia/ai/ide/walkthrough/chooseAgent/outro', `
+You can also [choose the default agent]({0}) in the settings, and address another one for a single message by starting it with *@AgentName*.
+The [Agents]({1}) page lists them all.
+`, this.aiConfiguration(ai_chat_preferences_1.DEFAULT_CHAT_AGENT_PREF), this.aiConfiguration(ai_configuration_category_1.AiConfigurationCategoryId.AGENTS)).trim();
+        return {
+            id: 'choose-agent',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/chooseAgent/title', 'Choose your default agent'),
+            description: [intro, this.renderAgentChoices(), outro].filter(part => !!part).join('\n\n'),
+            completionEvents: [`onContext:${ai_walkthrough_context_keys_1.AI_DEFAULT_AGENT_CONTEXT_KEY}`]
+        };
+    }
+    /**
+     * One action per recommended agent, each setting it as the default right away.
+     *
+     * Every link stands alone in its paragraph, which is what the welcome page renders as a button, so this
+     * reads like the buttons the chat welcome used to offer. Products customize the list through
+     * {@link ChatAgentRecommendationService}.
+     */
+    renderAgentChoices() {
+        return this.recommendationService.getRecommendedAgents()
+            .map(agent => {
+            const command = `command:${ai_getting_started_commands_1.AI_SET_DEFAULT_CHAT_AGENT.id}?${encodeURIComponent(JSON.stringify(agent.id))}`;
+            // Carried as the link title, so what the agent is good at stays available as a tooltip.
+            const title = agent.description ? ` "${agent.description.replace(/"/g, '')}"` : '';
+            return `[@${agent.label}](${command}${title})`;
+        })
+            .join('\n\n');
+    }
+    createFirstQuestionStep() {
+        return {
+            id: 'first-question',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/firstQuestion/title', 'Ask your first question'),
+            description: nls_1.nls.localize('theia/ai/ide/walkthrough/firstQuestion/description', `
+[Open the AI Chat]({0}) and ask something about your project.
+
+Two things make the answers a lot better:
+
+- *@AgentName* picks the agent for this message, for example *@Coder*.
+- *#* attaches context, for example *#file* or *#selectedText*. The paperclip button next to the input does the same.
+
+The chat remembers your sessions, so you can pick a conversation up later.
+`, `command:${ai_chat_ui_contribution_1.AI_CHAT_TOGGLE_COMMAND_ID}`).trim(),
+            completionEvents: [`onContext:${ai_walkthrough_context_keys_1.AI_CHAT_USED_CONTEXT_KEY}`]
+        };
+    }
+    createToolConfirmationStep() {
+        return {
+            id: 'tool-confirmation',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/toolConfirmation/title', 'Stay in control of what agents do'),
+            description: nls_1.nls.localize('theia/ai/ide/walkthrough/toolConfirmation/description', `
+Agents act on your workspace through tools: they read files, run terminal commands or edit code.
+
+Every tool call asks for your confirmation first. In the [Tools]({0}) page you can change that default or pre-approve the tools you trust.
+
+AI features stay off entirely while a workspace is not trusted. [Manage workspace trust]({1}) to decide per project.
+`, `command:${ai_configuration_view_contribution_1.OPEN_AI_CONFIG_VIEW_TOOLS.id}`, `command:${workspace_commands_1.WorkspaceCommands.MANAGE_WORKSPACE_TRUST.id}`).trim(),
+            completionEvents: [
+                `onContext:${ai_walkthrough_context_keys_1.AI_TOOL_CONFIRMATION_CONFIGURED_CONTEXT_KEY}`,
+                `onLink:command:${ai_configuration_view_contribution_1.OPEN_AI_CONFIG_VIEW_TOOLS.id}`
+            ]
+        };
+    }
+    createGoFurtherStep() {
+        return {
+            id: 'go-further',
+            title: nls_1.nls.localize('theia/ai/ide/walkthrough/goFurther/title', 'Go further'),
+            description: nls_1.nls.localize('theia/ai/ide/walkthrough/goFurther/description', `
+The chat is only the beginning. AI also completes code as you type and assists in the terminal with *Ctrl+I*.
+
+- [Prompts and skills]({0}): read and adapt the instructions the agents work with.
+- [MCP servers]({1}): add tools beyond the ones {3} ships with.
+- [Token usage]({2}): see what your requests consume.
+- [Switch Perspective]({5}) (experimental): the *AI First* layout moves the chat into the main area, with the explorer and source control on the right.
+
+The AI History view, where available, shows what was actually sent to the model.
+
+There is more in [the documentation]({4}) - and your feedback is always welcome.
+`, this.aiConfiguration(ai_configuration_category_1.AiConfigurationCategoryId.PROMPTS_AND_SKILLS), this.aiConfiguration(ai_configuration_category_1.AiConfigurationCategoryId.MCP_SERVERS), this.aiConfiguration(ai_configuration_category_1.AiConfigurationCategoryId.TOKEN_USAGE), this.applicationName, AI_DOC_URL, `command:${perspective_service_1.PerspectiveServiceImpl.SWITCH_PERSPECTIVE_COMMAND.id}`).trim()
+        };
+    }
+};
+exports.AiGettingStartedWalkthroughProvider = AiGettingStartedWalkthroughProvider;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.ChatAgentRecommendationService),
+    tslib_1.__metadata("design:type", Object)
+], AiGettingStartedWalkthroughProvider.prototype, "recommendationService", void 0);
+exports.AiGettingStartedWalkthroughProvider = AiGettingStartedWalkthroughProvider = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], AiGettingStartedWalkthroughProvider);
+//# sourceMappingURL=ai-getting-started-walkthrough.js.map

package/lib/browser/ai-getting-started-walkthrough.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-getting-started-walkthrough.js","sourceRoot":"","sources":["../../src/browser/ai-getting-started-walkthrough.ts"],"names":[],"mappings":"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"}

package/lib/browser/ai-getting-started-walkthrough.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai-getting-started-walkthrough.spec.d.ts.map

package/lib/browser/ai-getting-started-walkthrough.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-getting-started-walkthrough.spec.d.ts","sourceRoot":"","sources":["../../src/browser/ai-getting-started-walkthrough.spec.ts"],"names":[],"mappings":""}

package/lib/browser/ai-getting-started-walkthrough.spec.js

@@ -0,0 +1,124 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsdom_1 = require("@theia/core/lib/browser/test/jsdom");
+let disableJSDOM = (0, jsdom_1.enableJSDOM)();
+const frontend_application_config_provider_1 = require("@theia/core/lib/browser/frontend-application-config-provider");
+frontend_application_config_provider_1.FrontendApplicationConfigProvider.set({});
+const chai_1 = require("chai");
+const ai_activation_service_1 = require("@theia/ai-core/lib/browser/ai-activation-service");
+const ai_getting_started_walkthrough_1 = require("./ai-getting-started-walkthrough");
+const ai_walkthrough_context_keys_1 = require("./ai-walkthrough-context-keys");
+disableJSDOM();
+/** The commands the walkthrough is allowed to link to; each one is registered by one of the AI packages. */
+const KNOWN_COMMANDS = new Set([
+    'aiConfiguration:open',
+    'aiConfiguration:openTools',
+    'aiChat:toggle',
+    'workspace:manageTrust',
+    'perspective.switch',
+    'ai.setDefaultChatAgent'
+]);
+const KNOWN_CONTEXT_KEYS = new Set([
+    ai_activation_service_1.ENABLE_AI_CONTEXT_KEY,
+    ai_walkthrough_context_keys_1.AI_MODEL_READY_CONTEXT_KEY,
+    ai_walkthrough_context_keys_1.AI_CHAT_USED_CONTEXT_KEY,
+    ai_walkthrough_context_keys_1.AI_DEFAULT_AGENT_CONTEXT_KEY,
+    ai_walkthrough_context_keys_1.AI_TOOL_CONFIRMATION_CONFIGURED_CONTEXT_KEY
+]);
+describe('AiGettingStartedWalkthroughProvider', () => {
+    let walkthrough;
+    /** The recommended agents a product contributes, which the agent step turns into one link each. */
+    const recommendedAgents = [
+        { id: 'Coder', label: 'Coder', description: 'Code generation and modification' },
+        { id: 'Architect', label: 'Architect', description: 'High-level design and architecture' }
+    ];
+    function createProvider() {
+        const provider = new ai_getting_started_walkthrough_1.AiGettingStartedWalkthroughProvider();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        provider.recommendationService = { getRecommendedAgents: () => recommendedAgents };
+        return provider;
+    }
+    function agentStepOf(provider) {
+        return provider.getWalkthroughs()[0].steps.find(step => step.id === 'choose-agent').description;
+    }
+    before(() => {
+        disableJSDOM = (0, jsdom_1.enableJSDOM)();
+        frontend_application_config_provider_1.FrontendApplicationConfigProvider.set({});
+        walkthrough = createProvider().getWalkthroughs()[0];
+    });
+    after(() => disableJSDOM());
+    it('should contribute the getting started walkthrough', () => {
+        const walkthroughs = createProvider().getWalkthroughs();
+        (0, chai_1.expect)(walkthroughs).to.have.lengthOf(1);
+        (0, chai_1.expect)(walkthroughs[0].id).to.equal(ai_getting_started_walkthrough_1.AI_GETTING_STARTED_WALKTHROUGH_ID);
+        (0, chai_1.expect)(walkthroughs[0].steps.map(step => step.id)).to.deep.equal(['ai-support', 'enable-ai', 'connect-model', 'choose-agent', 'first-question', 'tool-confirmation', 'go-further']);
+    });
+    it('should offer every recommended agent as an action that sets it as the default', () => {
+        const description = agentStepOf(createProvider());
+        for (const agent of recommendedAgents) {
+            // Alone in its paragraph, which is what the welcome page renders as a button, and carrying the
+            // agent's description as the link title so it stays available as a tooltip.
+            (0, chai_1.expect)(description, `action for ${agent.id}`).to.include(`\n\n[@${agent.label}](command:ai.setDefaultChatAgent?${encodeURIComponent(JSON.stringify(agent.id))} "${agent.description}")`);
+        }
+    });
+    it('should keep the preference row reachable', () => {
+        (0, chai_1.expect)(agentStepOf(createProvider())).to.include('command:aiConfiguration:open?ai-features.chat.defaultChatAgent');
+    });
+    it('should give every step an id, a title and a description', () => {
+        const ids = walkthrough.steps.map(step => step.id);
+        (0, chai_1.expect)(new Set(ids).size).to.equal(ids.length);
+        for (const step of walkthrough.steps) {
+            (0, chai_1.expect)(step.title, `title of ${step.id}`).to.not.be.empty;
+            (0, chai_1.expect)(step.description, `description of ${step.id}`).to.not.be.empty;
+        }
+    });
+    it('should substitute every placeholder', () => {
+        for (const step of walkthrough.steps) {
+            (0, chai_1.expect)(step.title, `title of ${step.id}`).to.not.match(/\{\d+\}/);
+            (0, chai_1.expect)(step.description, `description of ${step.id}`).to.not.match(/\{\d+\}/);
+        }
+        (0, chai_1.expect)(walkthrough.description).to.not.match(/\{\d+\}/);
+    });
+    it('should only link to commands that exist', () => {
+        for (const step of walkthrough.steps) {
+            for (const match of step.description.matchAll(/\(command:([^?)]+)/g)) {
+                (0, chai_1.expect)(KNOWN_COMMANDS, `command of ${step.id}`).to.include(match[1]);
+            }
+        }
+    });
+    it('should only complete on context keys that are published, so that steps also tick for an already configured user', () => {
+        for (const step of walkthrough.steps) {
+            for (const event of step.completionEvents ?? []) {
+                if (event.startsWith('onContext:')) {
+                    (0, chai_1.expect)(KNOWN_CONTEXT_KEYS, `context key of ${step.id}`).to.include(event.substring('onContext:'.length));
+                }
+                else {
+                    // An `onLink:` event only ever fires for a link the step actually offers.
+                    (0, chai_1.expect)(event, `completion event of ${step.id}`).to.match(/^onLink:/);
+                    (0, chai_1.expect)(step.description, `link of ${step.id}`).to.include(`(${event.substring('onLink:'.length)})`);
+                }
+            }
+        }
+    });
+    it('should have a completion event for every step that can be verified', () => {
+        const withoutCompletion = walkthrough.steps.filter(step => !step.completionEvents?.length).map(step => step.id);
+        // The closing step only points at further reading, so there is nothing to observe; it is marked done by hand.
+        (0, chai_1.expect)(withoutCompletion).to.deep.equal(['go-further']);
+    });
+});
+//# sourceMappingURL=ai-getting-started-walkthrough.spec.js.map

package/lib/browser/ai-getting-started-walkthrough.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-getting-started-walkthrough.spec.js","sourceRoot":"","sources":["../../src/browser/ai-getting-started-walkthrough.spec.ts"],"names":[],"mappings":"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"}

package/lib/browser/ai-walkthrough-context-keys.d.ts

@@ -0,0 +1,55 @@
+import { ChatService } from '@theia/ai-chat/lib/common';
+import { FrontendLanguageModelRegistry } from '@theia/ai-core/lib/common';
+import { ContextKey, ContextKeyService } from '@theia/core/lib/browser/context-key-service';
+import { FrontendApplicationContribution } from '@theia/core/lib/browser/frontend-application-contribution';
+import { DisposableCollection } from '@theia/core/lib/common/disposable';
+import { PreferenceService } from '@theia/core/lib/common/preferences';
+/** True as soon as at least one language model is ready to be used. */
+export declare const AI_MODEL_READY_CONTEXT_KEY = "ai.hasReadyLanguageModel";
+/** True as soon as the user has held at least one conversation with an agent. */
+export declare const AI_CHAT_USED_CONTEXT_KEY = "ai.chat.hasRequest";
+/** True while a default chat agent is configured. */
+export declare const AI_DEFAULT_AGENT_CONTEXT_KEY = "ai.chat.hasDefaultAgent";
+/** True once the user has decided how tool calls are confirmed, instead of staying on the default. */
+export declare const AI_TOOL_CONFIRMATION_CONFIGURED_CONTEXT_KEY = "ai.chat.toolConfirmationConfigured";
+/**
+ * Publishes the state that the getting started walkthrough observes to tick off its steps.
+ *
+ * The keys describe what the user achieved rather than what they clicked. A step is therefore only completed
+ * once the setup actually works, and a user who configured everything before ever opening the walkthrough
+ * finds it completed rather than waiting for changes that already happened.
+ */
+export declare class AiWalkthroughContextKeys implements FrontendApplicationContribution {
+    protected readonly contextKeyService: ContextKeyService;
+    protected readonly languageModelRegistry: FrontendLanguageModelRegistry;
+    protected readonly chatService: ChatService;
+    protected readonly preferenceService: PreferenceService;
+    protected readonly toDispose: DisposableCollection;
+    protected hasReadyLanguageModel: ContextKey<boolean>;
+    protected hasChatRequest: ContextKey<boolean>;
+    protected hasDefaultAgent: ContextKey<boolean>;
+    protected toolConfirmationConfigured: ContextKey<boolean>;
+    protected init(): void;
+    protected updateModelState(): Promise<void>;
+    /**
+     * A session gets its title from its first exchange, so a titled or persisted session means the user has
+     * asked something. Once true, the key stays true: the achievement does not go away when a chat is deleted.
+     */
+    protected updateChatState(): Promise<void>;
+    protected updateDefaultAgentState(): void;
+    /**
+     * The user has taken a stance on tool confirmation as soon as they changed the default mode or
+     * pre-approved individual tools.
+     */
+    protected updateToolConfirmationState(): void;
+    /**
+     * Whether a preference carries a value the user set, rather than the one the product ships.
+     *
+     * The effective value cannot answer this: a product is free to ship its own confirmation defaults, and
+     * reading those back as a decision would tick the step for a user who never saw it. An empty object does
+     * not count either, since that is what resetting the per-tool settings leaves behind.
+     */
+    protected isSetByUser(preferenceName: string): boolean;
+    onStop(): void;
+}
+//# sourceMappingURL=ai-walkthrough-context-keys.d.ts.map

package/lib/browser/ai-walkthrough-context-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-walkthrough-context-keys.d.ts","sourceRoot":"","sources":["../../src/browser/ai-walkthrough-context-keys.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AACrE,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAC7D,qDAAqD;AACrD,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,sGAAsG;AACtG,eAAO,MAAM,2CAA2C,uCAAuC,CAAC;AAEhG;;;;;;GAMG;AACH,qBACa,wBAAyB,YAAW,+BAA+B;IAG5E,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAGxD,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;IAGxE,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAG5C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAExD,SAAS,CAAC,QAAQ,CAAC,SAAS,uBAA8B;IAE1D,SAAS,CAAC,qBAAqB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACrD,SAAS,CAAC,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9C,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/C,SAAS,CAAC,0BAA0B,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAG1D,SAAS,CAAC,IAAI,IAAI,IAAI;cAwBN,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjD;;;OAGG;cACa,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhD,SAAS,CAAC,uBAAuB,IAAI,IAAI;IAIzC;;;OAGG;IACH,SAAS,CAAC,2BAA2B,IAAI,IAAI;IAM7C;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAOtD,MAAM,IAAI,IAAI;CAGjB"}