@theia/ai-ide 1.75.0-next.8 → 1.75.0

package/src/browser/frontend-module.ts

@@ -23,6 +23,7 @@ import { ArchitectAgent } from './architect-agent';
 import { CoderAgent } from './coder-agent';
 import { SummarizeSessionCommandContribution } from './summarize-session-command-contribution';
 import {
+    AccessibleRootContribution,
     FileContentFunction,
     FileDiagnosticProvider,
     FindFilesByPattern,
@@ -31,6 +32,7 @@ import {
     WorkspaceFunctionScope
 } from './workspace-functions';
 import { WorkspaceSearchProvider } from './workspace-search-provider';
+import { MemoryDirectoryVariableContribution } from './memory-directory-variable-contribution';
 import {
     FrontendApplicationContribution,
     WidgetFactory,
@@ -67,13 +69,29 @@ import { AppTesterChatAgent } from './app-tester-chat-agent';
 import { GitHubChatAgent } from './github-chat-agent';
 import { CommandChatAgent } from '../common/command-chat-agents';
 import { ListChatContext, ResolveChatContext, AddFileToChatContext } from './context-functions';
-import { AIAgentConfigurationWidget } from './ai-configuration/agent-configuration-widget';
+import { AgentsConfigurationCategory } from './ai-configuration/categories/agents-configuration-category';
+import { GeneralConfigurationCategory } from './ai-configuration/categories/general-configuration-category';
+import { ModelsConfigurationCategory } from './ai-configuration/categories/models-configuration-category';
+import { ModelAliasesConfigurationCategory } from './ai-configuration/categories/model-aliases-configuration-category';
+import { VariablesConfigurationCategory } from './ai-configuration/categories/variables-configuration-category';
+import { TokenUsageConfigurationCategory } from './ai-configuration/categories/token-usage-configuration-category';
+import { ToolsConfigurationCategory } from './ai-configuration/categories/tools-configuration-category';
+import { PromptsAndSkillsConfigurationCategory } from './ai-configuration/categories/prompts-and-skills-configuration-category';
+import { PromptSnippetsConfigurationCategory } from './ai-configuration/categories/prompt-snippets-configuration-category';
+import { AiConfigurationOpenPreferenceRenderer, AiConfigurationOpenPreferenceRendererContribution } from './ai-configuration/ai-configuration-open-preference-renderer';
+import { PreferenceNodeRendererContribution } from '@theia/preferences/lib/browser/views/components/preference-node-renderer-creator';
+import { AiConfigurationBreadcrumbsContribution } from './ai-configuration/ai-configuration-breadcrumbs-contribution';
+import { BreadcrumbsContribution } from '@theia/core/lib/browser/breadcrumbs/breadcrumbs-constants';
+import { AiConfigurationLabelProviderContribution } from './ai-configuration/ai-configuration-label-provider-contribution';
+import { LabelProviderContribution } from '@theia/core/lib/browser/label-provider';
+import { AiConfigurationCategory } from '@theia/ai-core-ui/lib/browser/ai-configuration/ai-configuration-category';
 import { AIConfigurationSelectionService } from './ai-configuration/ai-configuration-service';
-import { AIAgentConfigurationViewContribution } from './ai-configuration/ai-configuration-view-contribution';
+import { AIConfigurationViewContribution } from './ai-configuration/ai-configuration-view-contribution';
 import { AIConfigurationContainerWidget } from './ai-configuration/ai-configuration-widget';
-import { AIVariableConfigurationWidget } from './ai-configuration/variable-configuration-widget';
+import { AiConfigurationDetailWidget } from './ai-configuration/ai-configuration-detail-widget';
+import { AiConfigurationTreeWidget, createAiConfigurationTreeContainer } from './ai-configuration/ai-configuration-tree-widget';
+import { AiConfigurationSearchWidget } from './ai-configuration/ai-configuration-search-widget';
 import { ContextFilesVariableContribution } from '../common/context-files-variable';
-import { AIToolsConfigurationWidget } from './ai-configuration/tools-configuration-widget';
 import { TabBarToolbarContribution } from '@theia/core/lib/browser/shell/tab-bar-toolbar';
 import { TemplatePreferenceContribution } from './template-preference-contribution';
 import { ChatWelcomeMessageProvider } from '@theia/ai-chat-ui/lib/browser/chat-tree-view';
@@ -83,19 +101,15 @@ import { ChatSessionItemActionContribution, DefaultChatSessionItemActionContribu
 import { AiAllowAllModeChatBanner } from './ai-allow-all-mode-chat-banner';
 import { ChatBannerProvider } from '@theia/ai-chat-ui/lib/browser/chat-banner-provider';
 import { DefaultChatAgentRecommendationService } from './default-chat-agent-recommendation-service';
-import { AITokenUsageConfigurationWidget } from './ai-configuration/token-usage-configuration-widget';
-import { AISkillsConfigurationWidget } from './ai-configuration/skills-configuration-widget';
 import { TaskContextSummaryVariableContribution } from './task-background-summary-variable';
 import { GitHubRepoVariableContribution } from './github-repo-variable-contribution';
 import { TaskContextFileStorageService } from './task-context-file-storage-service';
 import { TaskContextStorageService } from '@theia/ai-chat/lib/browser/task-context-service';
 import { bindRootContributionProvider, CommandContribution, PreferenceContribution } from '@theia/core';
-import { AIPromptFragmentsConfigurationWidget } from './ai-configuration/prompt-fragments-configuration-widget';
 import { BrowserAutomation, browserAutomationPath } from '../common/browser-automation-protocol';
 import { GitHubRepoService, githubRepoServicePath } from '../common/github-repo-protocol';
 import { CloseBrowserProvider, IsBrowserRunningProvider, LaunchBrowserProvider, QueryDomProvider } from './app-tester-chat-functions';
 import { GetSkillFileContent } from './skill-file-functions';
-import { ModelAliasesConfigurationWidget } from './ai-configuration/model-aliases-configuration-widget';
 import { aiIdePreferenceSchema } from '../common/ai-ide-preferences';
 import { AIActivationService } from '@theia/ai-core/lib/browser';
 import { AIIdeActivationServiceImpl } from './ai-ide-activation-service';
@@ -121,6 +135,8 @@ import { AddressGhReviewCommandContribution } from './address-pr-review-command-
 import { AppTesterCapabilityContribution } from './apptester-capability-contribution';
 import { GitHubCapabilityContribution } from './github-capability-contribution';
 import { ShellExecutionCapabilityContribution } from './shell-execution-capability-contribution';
+import { MemoryCapabilityContribution } from './memory-capability-contribution';
+import { OpenEditorsHintContribution } from './open-editors-hint-contribution';
 import { AgentModeConfirmationService, AgentModeConfirmationServiceImpl } from './agent-mode-confirmation-service';
 import { ExploreAgent } from './explore-agent';
 import { CodeReviewerAgent } from './code-reviewer-agent';
@@ -218,6 +234,11 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bind(WorkspaceFunctionScope).toSelf().inSingletonScope();
     bindToolProvider(WorkspaceSearchProvider, bind);
 
+    bindRootContributionProvider(bind, AccessibleRootContribution);
+    bind(MemoryDirectoryVariableContribution).toSelf().inSingletonScope();
+    bind(AIVariableContribution).toService(MemoryDirectoryVariableContribution);
+    bind(AccessibleRootContribution).toService(MemoryDirectoryVariableContribution);
+
     bindToolProvider(SuggestFileContent, bind);
     bindToolProvider(WriteFileContent, bind);
     bindToolProvider(TaskListProvider, bind);
@@ -235,6 +256,14 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bindToolProvider(ListChatContext, bind);
     bindToolProvider(ResolveChatContext, bind);
     bind(AIConfigurationSelectionService).toSelf().inSingletonScope();
+    // The container widget owns these children and disposes them when the view is closed. They must
+    // therefore be transient: a reopened container gets fresh children instead of injecting the
+    // already-disposed singletons from the previous instance (which rendered an empty view and logged
+    // "node does not belong to this tree" errors on layout restore).
+    bind(AiConfigurationSearchWidget).toSelf();
+    bind(AiConfigurationDetailWidget).toSelf();
+    bind(AiConfigurationTreeWidget)
+        .toDynamicValue(({ container }) => createAiConfigurationTreeContainer(container).get(AiConfigurationTreeWidget));
     bind(AIConfigurationContainerWidget).toSelf();
     bind(WidgetFactory)
         .toDynamicValue(ctx => ({
@@ -248,32 +277,46 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bindToolProvider(IsBrowserRunningProvider, bind);
     bindToolProvider(QueryDomProvider, bind);
 
-    bindViewContribution(bind, AIAgentConfigurationViewContribution);
-    bind(TabBarToolbarContribution).toService(AIAgentConfigurationViewContribution);
+    bindViewContribution(bind, AIConfigurationViewContribution);
+    bind(TabBarToolbarContribution).toService(AIConfigurationViewContribution);
 
-    bind(AIVariableConfigurationWidget).toSelf();
-    bind(WidgetFactory)
-        .toDynamicValue(ctx => ({
-            id: AIVariableConfigurationWidget.ID,
-            createWidget: () => ctx.container.get(AIVariableConfigurationWidget)
-        }))
-        .inSingletonScope();
+    bind(AgentsConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(AgentsConfigurationCategory);
 
-    bind(AIAgentConfigurationWidget).toSelf();
-    bind(WidgetFactory)
-        .toDynamicValue(ctx => ({
-            id: AIAgentConfigurationWidget.ID,
-            createWidget: () => ctx.container.get(AIAgentConfigurationWidget)
-        }))
-        .inSingletonScope();
+    bind(GeneralConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(GeneralConfigurationCategory);
 
-    bind(ModelAliasesConfigurationWidget).toSelf();
-    bind(WidgetFactory)
-        .toDynamicValue(ctx => ({
-            id: ModelAliasesConfigurationWidget.ID,
-            createWidget: () => ctx.container.get(ModelAliasesConfigurationWidget)
-        }))
-        .inSingletonScope();
+    bind(ModelsConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(ModelsConfigurationCategory);
+
+    bind(ModelAliasesConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(ModelAliasesConfigurationCategory);
+
+    bind(VariablesConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(VariablesConfigurationCategory);
+
+    bind(TokenUsageConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(TokenUsageConfigurationCategory);
+
+    bind(ToolsConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(ToolsConfigurationCategory);
+
+    bind(PromptsAndSkillsConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(PromptsAndSkillsConfigurationCategory);
+
+    bind(PromptSnippetsConfigurationCategory).toSelf().inSingletonScope();
+    bind(AiConfigurationCategory).toService(PromptSnippetsConfigurationCategory);
+
+    // Renders the Settings-UI "AI Features" placeholder as a button that opens the AI Configuration view (#316).
+    bind(AiConfigurationOpenPreferenceRenderer).toSelf();
+    bind(PreferenceNodeRendererContribution).to(AiConfigurationOpenPreferenceRendererContribution).inSingletonScope();
+
+    // Real Theia breadcrumbs for the AI Configuration view.
+    bind(AiConfigurationBreadcrumbsContribution).toSelf().inSingletonScope();
+    bind(BreadcrumbsContribution).toService(AiConfigurationBreadcrumbsContribution);
+    // Give the view's resource URI a readable name (window title, breadcrumbs) instead of "/".
+    bind(AiConfigurationLabelProviderContribution).toSelf().inSingletonScope();
+    bind(LabelProviderContribution).toService(AiConfigurationLabelProviderContribution);
 
     bindToolProvider(SimpleSuggestFileReplacements, bind);
     bindToolProvider(SimpleWriteFileReplacements, bind);
@@ -281,37 +324,12 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bindToolProvider(GetProposedFileState, bind);
     bindToolProvider(AddFileToChatContext, bind);
 
-    bind(AIToolsConfigurationWidget).toSelf();
-    bind(WidgetFactory)
-        .toDynamicValue(ctx => ({
-            id: AIToolsConfigurationWidget.ID,
-            createWidget: () => ctx.container.get(AIToolsConfigurationWidget)
-        }))
-        .inSingletonScope();
-
-    bind(AISkillsConfigurationWidget).toSelf();
-    bind(WidgetFactory)
-        .toDynamicValue(ctx => ({
-            id: AISkillsConfigurationWidget.ID,
-            createWidget: () => ctx.container.get(AISkillsConfigurationWidget)
-        }))
-        .inSingletonScope();
-
     bind(AIVariableContribution).to(ContextFilesVariableContribution).inSingletonScope();
 
     bind(PreferenceContribution).toConstantValue({ schema: AiConfigurationPreferences });
 
     bind(FrontendApplicationContribution).to(TemplatePreferenceContribution);
 
-    // Register the token usage configuration widget
-    bind(AITokenUsageConfigurationWidget).toSelf();
-    bind(WidgetFactory)
-        .toDynamicValue(ctx => ({
-            id: AITokenUsageConfigurationWidget.ID,
-            createWidget: () => ctx.container.get(AITokenUsageConfigurationWidget)
-        }))
-        .inSingletonScope();
-
     bind(TaskContextSummaryVariableContribution).toSelf().inSingletonScope();
     bind(AIVariableContribution).toService(TaskContextSummaryVariableContribution);
 
@@ -326,13 +344,6 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     rebind(TaskContextStorageService).toService(TaskContextFileStorageService);
 
     bind(CommandContribution).to(SummarizeSessionCommandContribution);
-    bind(AIPromptFragmentsConfigurationWidget).toSelf();
-    bind(WidgetFactory)
-        .toDynamicValue(ctx => ({
-            id: AIPromptFragmentsConfigurationWidget.ID,
-            createWidget: () => ctx.container.get(AIPromptFragmentsConfigurationWidget)
-        }))
-        .inSingletonScope();
 
     bindToolProvider(SuggestTerminalCommand, bind);
 
@@ -357,6 +368,8 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bind(FrontendApplicationContribution).to(AppTesterCapabilityContribution);
     bind(FrontendApplicationContribution).to(GitHubCapabilityContribution);
     bind(FrontendApplicationContribution).to(ShellExecutionCapabilityContribution);
+    bind(FrontendApplicationContribution).to(MemoryCapabilityContribution);
+    bind(FrontendApplicationContribution).to(OpenEditorsHintContribution);
 
     bind(FrontendApplicationContribution).to(CodeReviewCapabilityContribution);
     bind(FrontendApplicationContribution).to(PRReviewCapabilityContribution);

package/src/browser/github-chat-agent.ts

@@ -18,8 +18,8 @@ import { AbstractStreamParsingChatAgent } from '@theia/ai-chat/lib/common/chat-a
 import { ErrorChatResponseContentImpl, MarkdownChatResponseContentImpl, MutableChatRequestModel, QuestionResponseContentImpl } from '@theia/ai-chat/lib/common/chat-model';
 import { LanguageModelRequirement } from '@theia/ai-core/lib/common';
 import { MCPFrontendService, MCPServerDescription } from '@theia/ai-mcp/lib/common/mcp-server-manager';
-import { nls, CommandService } from '@theia/core';
-import { inject, injectable } from '@theia/core/shared/inversify';
+import { CommandService, ILogger, nls } from '@theia/core';
+import { inject, injectable, named } from '@theia/core/shared/inversify';
 import { MCP_SERVERS_PREF } from '@theia/ai-mcp/lib/common/mcp-preferences';
 import { PreferenceScope, PreferenceService } from '@theia/core/lib/common';
 import { PreferencesCommands } from '@theia/preferences/lib/browser/util/preference-types';
@@ -32,6 +32,9 @@ export const GitHubChatAgentId = 'GitHub';
 @injectable()
 export class GitHubChatAgent extends AbstractStreamParsingChatAgent {
 
+    @inject(ILogger) @named('ai-ide:GitHubChatAgent')
+    protected override readonly logger: ILogger;
+
     @inject(MCPFrontendService)
     protected readonly mcpService: MCPFrontendService;
 

package/src/browser/github-repo-variable-contribution.ts

@@ -14,8 +14,8 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 
-import { injectable, inject } from '@theia/core/shared/inversify';
-import { MaybePromise, nls } from '@theia/core';
+import { injectable, inject, named } from '@theia/core/shared/inversify';
+import { MaybePromise, nls, ILogger } from '@theia/core';
 import {
     AIVariableContribution,
     AIVariableResolver,
@@ -49,6 +49,9 @@ export class GitHubRepoVariableContribution implements AIVariableContribution, A
     @inject(GitHubRepoService)
     protected readonly gitHubRepoService: GitHubRepoService;
 
+    @inject(ILogger) @named('ai-ide:GitHubRepoVariableContribution')
+    protected readonly logger: ILogger;
+
     registerVariables(service: AIVariableService): void {
         service.registerResolver(GITHUB_REPO_NAME_VARIABLE, this);
     }
@@ -115,7 +118,7 @@ export class GitHubRepoVariableContribution implements AIVariableContribution, A
             };
 
         } catch (error) {
-            console.warn('Failed to resolve GitHub repository name:', error);
+            this.logger.warn('Failed to resolve GitHub repository name:', error);
             return { variable: request.variable, value: 'No GitHub repository is currently selected or detected.' };
         }
     }

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

@@ -18,7 +18,7 @@ import { ChatWelcomeMessageProvider } from '@theia/ai-chat-ui/lib/browser/chat-t
 import * as React from '@theia/core/shared/react';
 import { nls } from '@theia/core/lib/common/nls';
 import { inject, injectable, postConstruct } from '@theia/core/shared/inversify';
-import { codicon, CommonCommands, LocalizedMarkdown, MarkdownRenderer } from '@theia/core/lib/browser';
+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 { PreferenceService } from '@theia/core/lib/common';
@@ -388,15 +388,15 @@ Set up an API key for [OpenAI]({0}), [Anthropic]({1}), or [GoogleAI]({2}) or con
 Some agents (e.g. Claude Code) work without a provider. [Learn more](https://theia-ide.org/docs/user_ai/).
 `}
                 args={[
-                    `command:${CommonCommands.OPEN_PREFERENCES.id}?ai-features.openAiOfficial.openAiApiKey`,
-                    `command:${CommonCommands.OPEN_PREFERENCES.id}?ai-features.anthropic.AnthropicApiKey`,
-                    `command:${CommonCommands.OPEN_PREFERENCES.id}?ai-features.google.apiKey`
+                    `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`
                 ]}
                 markdownRenderer={this.markdownRenderer}
                 className="theia-WelcomeMessage-Content"
                 markdownOptions={{
                     supportHtml: true,
-                    isTrusted: { enabledCommands: [CommonCommands.OPEN_PREFERENCES.id] }
+                    isTrusted: { enabledCommands: [OPEN_AI_CONFIG_VIEW.id] }
                 }}
             />
             {errorMessages.length > 0 && (
@@ -415,8 +415,8 @@ 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(CommonCommands.OPEN_PREFERENCES.id, 'ai-features')}>
-                    {nls.localize('theia/ai/ide/openSettings', 'Open AI Settings')}
+                    onClick={() => this.commandRegistry.executeCommand(OPEN_AI_CONFIG_VIEW.id)}>
+                    {nls.localize('theia/ai/ide/openAiConfiguration', 'Open AI Configuration')}
                 </button>
                 <button
                     className="theia-button secondary"
@@ -474,9 +474,9 @@ Choose the agent to use by default. You can always override this by mentioning *
                     <LocalizedMarkdown
                         localizationKey="theia/ai/ide/moreAgentsAvailable"
                         defaultMarkdown='Use @AgentName to try others or configure a different default in [preferences]({0}).'
-                        args={[`command:${CommonCommands.OPEN_PREFERENCES.id}?ai-features.chat.defaultChatAgent`]}
+                        args={[`command:${OPEN_AI_CONFIG_VIEW.id}?ai-features.chat.defaultChatAgent`]}
                         markdownRenderer={this.markdownRenderer}
-                        markdownOptions={{ isTrusted: { enabledCommands: [CommonCommands.OPEN_PREFERENCES.id] } }}
+                        markdownOptions={{ isTrusted: { enabledCommands: [OPEN_AI_CONFIG_VIEW.id] } }}
                     />
                 </div>
             </div>
@@ -546,8 +546,8 @@ Choose the agent to use by default. You can always override this by mentioning *
             <div className="theia-WelcomeMessage-Actions">
                 <button
                     className="theia-button main"
-                    onClick={() => this.commandRegistry.executeCommand(CommonCommands.OPEN_PREFERENCES.id, 'ai-features')}>
-                    {nls.localize('theia/ai/ide/openSettings', 'Open AI Settings')}
+                    onClick={() => this.commandRegistry.executeCommand(OPEN_AI_CONFIG_VIEW.id)}>
+                    {nls.localize('theia/ai/ide/openAiConfiguration', 'Open AI Configuration')}
                 </button>
             </div>
             <LocalizedMarkdown

package/src/browser/memory-capability-contribution.spec.ts

@@ -0,0 +1,85 @@
+// *****************************************************************************
+// 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
+// *****************************************************************************
+
+import { expect } from 'chai';
+import { PromptService } from '@theia/ai-core';
+import { Container } from '@theia/core/shared/inversify';
+import {
+    FILE_CONTENT_FUNCTION_ID,
+    FIND_FILES_BY_PATTERN_FUNCTION_ID,
+    GET_WORKSPACE_FILE_LIST_FUNCTION_ID,
+    SEARCH_IN_WORKSPACE_FUNCTION_ID
+} from '../common/workspace-functions';
+import { WRITE_FILE_CONTENT_ID, WRITE_FILE_REPLACEMENTS_ID } from '../common/file-changeset-function-ids';
+import { MEMORY_DIRECTORY_VARIABLE } from './memory-directory-variable-contribution';
+import { MemoryCapabilityContribution } from './memory-capability-contribution';
+
+const registerFragment = (): { id: string, template: string } => {
+    const fragments: Array<{ id: string, template: string }> = [];
+    const container = new Container();
+    container.bind(PromptService).toConstantValue({
+        addBuiltInPromptFragment: (fragment: { id: string, template: string }) => fragments.push(fragment)
+    } as unknown as PromptService);
+    container.bind(MemoryCapabilityContribution).toSelf();
+    container.get(MemoryCapabilityContribution).onStart();
+
+    expect(fragments).to.have.lengthOf(1);
+    return fragments[0];
+};
+
+describe('MemoryCapabilityContribution', () => {
+
+    it('registers the memory fragment', () => {
+        const fragment = registerFragment();
+        expect(fragment.id).to.equal('memory');
+        expect(fragment.template).to.contain('## Memory');
+    });
+
+    it('starts the template with unindented front matter, so it parses as such', () => {
+        const { template } = registerFragment();
+        const lines = template.split('\n');
+        expect(lines[0]).to.equal('---');
+        expect(lines[1]).to.match(/^name: /);
+        expect(lines[2]).to.match(/^description: /);
+        expect(lines[3]).to.equal('---');
+    });
+
+    it('points the agent at the memory directory variable instead of a workspace path', () => {
+        const { template } = registerFragment();
+        expect(template).to.contain(`{{${MEMORY_DIRECTORY_VARIABLE.name}}}/wiki/index.md`);
+        expect(template).to.contain(`{{${MEMORY_DIRECTORY_VARIABLE.name}}}/raw/`);
+        expect(template).to.not.contain('.agents/memory');
+    });
+
+    it('resolves the date for raw filenames through the today variable', () => {
+        const { template } = registerFragment();
+        expect(template).to.contain('{{today:inIso8601}}');
+    });
+
+    it('instructs the agent to use the generic workspace tools', () => {
+        const { template } = registerFragment();
+        [
+            FILE_CONTENT_FUNCTION_ID,
+            FIND_FILES_BY_PATTERN_FUNCTION_ID,
+            GET_WORKSPACE_FILE_LIST_FUNCTION_ID,
+            SEARCH_IN_WORKSPACE_FUNCTION_ID,
+            WRITE_FILE_CONTENT_ID,
+            WRITE_FILE_REPLACEMENTS_ID
+        ].forEach(id => {
+            expect(template).to.contain(`~{${id}}`);
+        });
+    });
+});

package/src/browser/memory-capability-contribution.ts

@@ -0,0 +1,86 @@
+// *****************************************************************************
+// 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
+// *****************************************************************************
+
+import { FrontendApplicationContribution } from '@theia/core/lib/browser';
+import { inject, injectable } from '@theia/core/shared/inversify';
+import { PromptService } from '@theia/ai-core';
+import { nls } from '@theia/core';
+import { GET_WORKSPACE_FILE_LIST_FUNCTION_ID, FILE_CONTENT_FUNCTION_ID, SEARCH_IN_WORKSPACE_FUNCTION_ID, FIND_FILES_BY_PATTERN_FUNCTION_ID } from '../common/workspace-functions';
+import { WRITE_FILE_REPLACEMENTS_ID, WRITE_FILE_CONTENT_ID } from '../common/file-changeset-function-ids';
+import { MEMORY_DIRECTORY_VARIABLE } from './memory-directory-variable-contribution';
+
+@injectable()
+export class MemoryCapabilityContribution implements FrontendApplicationContribution {
+
+    @inject(PromptService)
+    protected readonly promptService: PromptService;
+
+    onStart(): void {
+        this.promptService.addBuiltInPromptFragment({
+            id: 'memory',
+            template: this.buildTemplate()
+        });
+    }
+
+    protected buildTemplate(): string {
+        const name = nls.localize('theia/ai/ide/memoryCapability/name', 'Memory');
+        const description = nls.localize('theia/ai/ide/memoryCapability/description',
+            'Lets the agent maintain a persistent, wiki-style knowledge base for the workspace, so this and future sessions '
+            + 'build on what came before instead of starting from scratch.');
+        const dir = `{{${MEMORY_DIRECTORY_VARIABLE.name}}}`;
+
+        return `---
+name: ${name}
+description: ${description}
+---
+
+## Memory
+
+Maintain a persistent knowledge base under \`${dir}\`, the same way a personal
+LLM-maintained wiki is built: raw material is ingested once, then incrementally *compiled* into a linked set of concept
+articles that you read from on every future task. The raw material itself is not the knowledge base — the compiled wiki is.
+
+That directory belongs to the current workspace but lies outside it, so what you learn about one project neither bleeds into
+the next nor shows up in the user's repository. Reach it with the ordinary file tools, prefixing every memory path with it.
+
+- \`${dir}/raw/\` — append-only ingest: session transcripts, pasted findings, anything worth preserving verbatim. Keep one
+  file per task, \`raw/<date>-<topic>.md\` with the \`yyyy-mm-dd\` prefix of {{today:inIso8601}} as the date: create it with
+  ~{${WRITE_FILE_CONTENT_ID}} as soon as there is something worth keeping and append later findings to it as new sections
+  (~{${WRITE_FILE_REPLACEMENTS_ID}}, so you don't re-emit the whole file). Only ever append to the current task's file — earlier
+  files and a single shared log are both off limits. Pruning \`raw/\` is the user's call, not yours.
+- \`${dir}/wiki/\` — the actual knowledge base: one short, single-concept \`.md\` article per topic (a project fact, a
+  convention, an environment quirk, a standing decision), cross-linked from \`wiki/index.md\` and from related articles. This is
+  what you read from, not \`raw/\`.
+- Start of task: read \`${dir}/wiki/index.md\` (~{${GET_WORKSPACE_FILE_LIST_FUNCTION_ID}} / ~{${FILE_CONTENT_FUNCTION_ID}})
+  and follow only the links relevant to the current task — browse the wiki, don't grep a diary. An empty memory directory simply
+  means this workspace has no memory yet: create \`wiki/index.md\` the first time you have something durable to record.
+- Compile, don't just log: when something durable comes up, fold it into the right existing article
+  (~{${WRITE_FILE_REPLACEMENTS_ID}}) or create a new one linked from \`index.md\` and its related articles — don't leave it
+  stranded only in \`raw/\`.
+- File outputs back in: substantial findings, decisions, or analysis produced during a task should be written into the wiki
+  article they inform, so future queries benefit from this session's work too, not just the next session's memory of it.
+- Lint occasionally: when asked to clean up memory, or an article looks stale, use ~{${SEARCH_IN_WORKSPACE_FUNCTION_ID}} /
+  ~{${FIND_FILES_BY_PATTERN_FUNCTION_ID}} across \`${dir}/wiki/\` to find contradictions, duplicate articles, and missing
+  links, then merge or fix them. Both take that directory as their search root.
+- Memory is yours to maintain unprompted — that is what separates it from the project info file described below, which is the
+  user's own description of the project and is only updated when they ask for it. Record what you learn in the wiki instead of
+  editing that file.
+- Keep the knowledge base to what belongs in it: what you learned about this project and how to work in it. It is not a place for
+  secrets, credentials, or copies of the user's files.
+
+Use judgement on what's worth compiling — a small number of accurate, well-linked articles beats an exhaustive log.`;
+    }
+}

package/src/browser/memory-directory-variable-contribution.spec.ts

@@ -0,0 +1,113 @@
+// *****************************************************************************
+// 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
+// *****************************************************************************
+
+import { expect } from 'chai';
+import { URI } from '@theia/core';
+import { Container } from '@theia/core/shared/inversify';
+import { WorkspaceMetadataStorageService, WorkspaceMetadataStore } from '@theia/workspace/lib/browser/metadata-storage';
+import { WorkspaceService } from '@theia/workspace/lib/browser/workspace-service';
+import { MEMORY_DIRECTORY_VARIABLE, MEMORY_METADATA_STORE_KEY, MemoryDirectoryVariableContribution } from './memory-directory-variable-contribution';
+
+describe('MemoryDirectoryVariableContribution', () => {
+
+    let contribution: MemoryDirectoryVariableContribution;
+    let location: URI;
+    let requestedKeys: string[];
+    let ensureExistsCalls: number;
+    let workspaceOpen: boolean;
+
+    beforeEach(() => {
+        location = new URI('file:///config/workspace-metadata/uuid/memory');
+        requestedKeys = [];
+        ensureExistsCalls = 0;
+        workspaceOpen = true;
+
+        const store = {
+            get location(): URI {
+                return location;
+            },
+            ensureExists: async () => {
+                ensureExistsCalls++;
+            }
+        } as unknown as WorkspaceMetadataStore;
+
+        const container = new Container();
+        container.bind(WorkspaceMetadataStorageService).toConstantValue({
+            getOrCreateStore: async (key: string) => {
+                requestedKeys.push(key);
+                if (!workspaceOpen) {
+                    throw new Error('Cannot create metadata store: no workspace is currently open');
+                }
+                return store;
+            }
+        } as WorkspaceMetadataStorageService);
+        container.bind(WorkspaceService).toConstantValue({
+            tryGetRoots: () => workspaceOpen ? [{ resource: new URI('file:///workspace') }] : []
+        } as unknown as WorkspaceService);
+        container.bind(MemoryDirectoryVariableContribution).toSelf();
+
+        contribution = container.get(MemoryDirectoryVariableContribution);
+    });
+
+    const resolve = (name: string = MEMORY_DIRECTORY_VARIABLE.name) =>
+        contribution.resolve({ variable: { ...MEMORY_DIRECTORY_VARIABLE, name } }, {});
+
+    it('resolves the variable to the memory store of the current workspace', async () => {
+        const resolved = await resolve();
+        expect(resolved?.value).to.equal(location.path.fsPath());
+        expect(requestedKeys).to.deep.equal([MEMORY_METADATA_STORE_KEY]);
+    });
+
+    it('creates the directory when the variable is resolved, but only once per location', async () => {
+        await resolve();
+        await resolve();
+        expect(ensureExistsCalls).to.equal(1);
+
+        location = new URI('file:///config/workspace-metadata/other/memory');
+        await resolve();
+        expect(ensureExistsCalls).to.equal(2);
+    });
+
+    it('contributes the memory directory as an accessible root', async () => {
+        expect((await contribution.getRoots()).map(root => root.toString())).to.deep.equal([location.toString()]);
+    });
+
+    it('follows the store location without needing invalidation', async () => {
+        await contribution.getRoots();
+        location = new URI('file:///config/workspace-metadata/other/memory');
+        expect((await contribution.getRoots())[0].toString()).to.equal(location.toString());
+    });
+
+    it('does not resolve other variables', async () => {
+        expect(await resolve('somethingElse')).to.be.undefined;
+    });
+
+    it('has neither a value nor a root without a workspace', async () => {
+        workspaceOpen = false;
+        expect(await resolve()).to.be.undefined;
+        expect(await contribution.getRoots()).to.be.empty;
+    });
+
+    it('drops the memory of a closed workspace instead of keeping the cached location', async () => {
+        // The store cannot compute a location without a workspace, so on close it keeps the one of the
+        // closed workspace. Nothing may be reachable through it any more.
+        expect((await resolve())?.value).to.equal(location.path.fsPath());
+
+        workspaceOpen = false;
+        expect(await resolve()).to.be.undefined;
+        expect(await contribution.getRoots()).to.be.empty;
+    });
+});