@theia/ai-core-ui 1.75.0-next.8 → 1.75.0

package/lib/browser/ai-core-ui-frontend-module.d.ts

@@ -1,3 +1,4 @@
+import '../../src/browser/style/index.css';
 import { ContainerModule } from '@theia/core/shared/inversify';
 declare const _default: ContainerModule;
 export default _default;

package/lib/browser/ai-core-ui-frontend-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-core-ui-frontend-module.d.ts","sourceRoot":"","sources":["../../src/browser/ai-core-ui-frontend-module.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;;AAK/D,wBAGG"}
+{"version":3,"file":"ai-core-ui-frontend-module.d.ts","sourceRoot":"","sources":["../../src/browser/ai-core-ui-frontend-module.ts"],"names":[],"mappings":"AAgBA,OAAO,mCAAmC,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;;AAU/D,wBASG"}

package/lib/browser/ai-core-ui-frontend-module.js

@@ -15,12 +15,23 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 Object.defineProperty(exports, "__esModule", { value: true });
+require("../../src/browser/style/index.css");
 const inversify_1 = require("@theia/core/shared/inversify");
 const core_1 = require("@theia/core");
 const agent_preferences_1 = require("@theia/ai-core/lib/common/agent-preferences");
 const ai_core_preferences_1 = require("@theia/ai-core/lib/common/ai-core-preferences");
+const ai_configuration_category_1 = require("./ai-configuration/ai-configuration-category");
+const ai_configuration_category_registry_1 = require("./ai-configuration/ai-configuration-category-registry");
+const ai_configuration_selection_model_1 = require("./ai-configuration/ai-configuration-selection-model");
+const ai_settings_row_service_1 = require("./ai-configuration/components/ai-settings-row-service");
+const ai_configuration_setting_commands_1 = require("./ai-configuration/ai-configuration-setting-commands");
 exports.default = new inversify_1.ContainerModule(bind => {
     bind(core_1.PreferenceContribution).toConstantValue({ schema: agent_preferences_1.AgentSettingsPreferenceSchema });
     bind(core_1.PreferenceContribution).toConstantValue({ schema: ai_core_preferences_1.aiCorePreferenceSchema });
+    (0, core_1.bindRootContributionProvider)(bind, ai_configuration_category_1.AiConfigurationCategory);
+    bind(ai_configuration_category_registry_1.AiConfigurationCategoryRegistry).toSelf().inSingletonScope();
+    bind(ai_configuration_selection_model_1.AiConfigurationSelectionModel).toSelf().inSingletonScope();
+    bind(ai_settings_row_service_1.AiSettingsRowService).toSelf().inSingletonScope();
+    (0, ai_configuration_setting_commands_1.bindAiConfigurationSettingCommands)(bind);
 });
 //# sourceMappingURL=ai-core-ui-frontend-module.js.map

package/lib/browser/ai-core-ui-frontend-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-core-ui-frontend-module.js","sourceRoot":"","sources":["../../src/browser/ai-core-ui-frontend-module.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;;AAEhF,4DAA+D;AAC/D,sCAAqD;AACrD,mFAA4F;AAC5F,uFAAuF;AAEvF,kBAAe,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IACtC,IAAI,CAAC,6BAAsB,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,iDAA6B,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC,6BAAsB,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,4CAAsB,EAAE,CAAC,CAAC;AACrF,CAAC,CAAC,CAAC"}
+{"version":3,"file":"ai-core-ui-frontend-module.js","sourceRoot":"","sources":["../../src/browser/ai-core-ui-frontend-module.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;;AAEhF,6CAA2C;AAE3C,4DAA+D;AAC/D,sCAAmF;AACnF,mFAA4F;AAC5F,uFAAuF;AACvF,4FAAuF;AACvF,8GAAwG;AACxG,0GAAoG;AACpG,mGAA6F;AAC7F,4GAA0G;AAE1G,kBAAe,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IACtC,IAAI,CAAC,6BAAsB,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,iDAA6B,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC,6BAAsB,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,4CAAsB,EAAE,CAAC,CAAC;IAEjF,IAAA,mCAA4B,EAAC,IAAI,EAAE,mDAAuB,CAAC,CAAC;IAC5D,IAAI,CAAC,oEAA+B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAClE,IAAI,CAAC,gEAA6B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAChE,IAAI,CAAC,8CAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACvD,IAAA,sEAAkC,EAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@theia/ai-core-ui",
-  "version": "1.75.0-next.8+c4452ce29",
+  "version": "1.75.0",
   "description": "Theia - AI Core UI",
   "dependencies": {
-    "@theia/ai-core": "1.75.0-next.8+c4452ce29",
-    "@theia/core": "1.75.0-next.8+c4452ce29",
+    "@theia/ai-core": "1.75.0",
+    "@theia/core": "1.75.0",
+    "@theia/preferences": "1.75.0",
     "tslib": "^2.8.1"
   },
   "main": "lib/common",
@@ -42,10 +43,10 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.74.0"
+    "@theia/ext-scripts": "1.75.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "c4452ce290653826389aa42dfddfabe461c1dcc8"
+  "gitHead": "6d8e911f05f0fd9a13d76797e79b21ee3f038bc2"
 }

package/src/browser/ai-configuration/ai-configuration-category-registry.spec.ts

@@ -0,0 +1,137 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// 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 'reflect-metadata';
+
+import { expect } from 'chai';
+import { Emitter } from '@theia/core';
+import { Container, ContainerModule, inject, injectable } from '@theia/core/shared/inversify';
+import { bindContributionProvider } from '@theia/core/lib/common';
+import { AiConfigurationCategory, AiConfigurationSearchItem } from './ai-configuration-category';
+import { AiConfigurationCategoryRegistry } from './ai-configuration-category-registry';
+
+class DummyCategory implements AiConfigurationCategory {
+    readonly renderer = {};
+    protected readonly onDidChangeEmitter = new Emitter<void>();
+    readonly onDidChange = this.onDidChangeEmitter.event;
+    constructor(
+        readonly id: string,
+        readonly order?: number,
+        readonly contributed?: boolean,
+        protected readonly searchItems: AiConfigurationSearchItem[] = []
+    ) { }
+    readonly label = this.id;
+    readonly iconClass = 'codicon codicon-gear';
+    readonly kind = 'single-page' as const;
+    get search(): { getSearchItems(): AiConfigurationSearchItem[] } | undefined {
+        return this.searchItems.length ? { getSearchItems: () => this.searchItems } : undefined;
+    }
+    fireChange(): void {
+        this.onDidChangeEmitter.fire();
+    }
+}
+
+describe('AiConfigurationCategoryRegistry', () => {
+
+    function createRegistry(...categories: AiConfigurationCategory[]): AiConfigurationCategoryRegistry {
+        const container = new Container();
+        container.load(new ContainerModule(bind => {
+            bindContributionProvider(bind, AiConfigurationCategory);
+            categories.forEach(category => bind(AiConfigurationCategory).toConstantValue(category));
+            bind(AiConfigurationCategoryRegistry).toSelf().inSingletonScope();
+        }));
+        return container.get(AiConfigurationCategoryRegistry);
+    }
+
+    it('resolves to an empty list when nothing is contributed', () => {
+        const registry = createRegistry();
+        expect(registry.getCategories()).to.deep.equal([]);
+    });
+
+    it('aggregates an empty search index when nothing is contributed', () => {
+        const registry = createRegistry();
+        expect(registry.getSearchItems()).to.deep.equal([]);
+    });
+
+    it('orders categories ascending by order', () => {
+        const registry = createRegistry(
+            new DummyCategory('c', 300),
+            new DummyCategory('a', 100),
+            new DummyCategory('b', 200)
+        );
+        expect(registry.getCategories().map(c => c.id)).to.deep.equal(['a', 'b', 'c']);
+    });
+
+    it('sorts contributed categories after all built-ins regardless of order', () => {
+        const registry = createRegistry(
+            new DummyCategory('ext', 1, true),
+            new DummyCategory('builtin', 900)
+        );
+        expect(registry.getCategories().map(c => c.id)).to.deep.equal(['builtin', 'ext']);
+    });
+
+    it('resolves a category by id', () => {
+        const registry = createRegistry(new DummyCategory('a', 100), new DummyCategory('b', 200));
+        expect(registry.getCategory('b')?.id).to.equal('b');
+        expect(registry.getCategory('missing')).to.equal(undefined);
+    });
+
+    it('aggregates the search index across categories that provide one', () => {
+        const item = (label: string, categoryId: string): AiConfigurationSearchItem =>
+            ({ label, typeLabel: 'Setting', categoryId, target: { categoryId } });
+        const registry = createRegistry(
+            new DummyCategory('a', 100, false, [item('a1', 'a')]),
+            new DummyCategory('b', 200),
+            new DummyCategory('c', 300, false, [item('c1', 'c'), item('c2', 'c')])
+        );
+        expect(registry.getSearchItems().map(i => i.label)).to.deep.equal(['a1', 'c1', 'c2']);
+    });
+
+    it('refires onDidChange when a contributed category changes', () => {
+        const category = new DummyCategory('a', 100);
+        const registry = createRegistry(category);
+        let fired = 0;
+        registry.onDidChange(() => fired++);
+        category.fireChange();
+        expect(fired).to.equal(1);
+    });
+
+    it('resolves without recursion when a contributed category injects the registry', () => {
+        // A category may inject the registry (e.g. to navigate across categories). The registry must not
+        // resolve its contributions during its own construction, or that closes a dependency cycle.
+        @injectable()
+        class RegistryInjectingCategory implements AiConfigurationCategory {
+            readonly id = 'self';
+            readonly label = 'self';
+            readonly iconClass = 'codicon codicon-gear';
+            readonly kind = 'single-page' as const;
+            readonly renderer = {};
+            @inject(AiConfigurationCategoryRegistry)
+            readonly registry: AiConfigurationCategoryRegistry;
+        }
+        const container = new Container();
+        container.load(new ContainerModule(bind => {
+            bindContributionProvider(bind, AiConfigurationCategory);
+            bind(RegistryInjectingCategory).toSelf().inSingletonScope();
+            bind(AiConfigurationCategory).toService(RegistryInjectingCategory);
+            bind(AiConfigurationCategoryRegistry).toSelf().inSingletonScope();
+        }));
+        const registry = container.get(AiConfigurationCategoryRegistry);
+        // Listening wires the aggregation, which resolves the contribution that injects this very registry.
+        expect(() => registry.onDidChange(() => { })).to.not.throw();
+        expect(registry.getCategories().map(category => category.id)).to.deep.equal(['self']);
+    });
+});

package/src/browser/ai-configuration/ai-configuration-category-registry.ts

@@ -0,0 +1,79 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// 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 { ContributionProvider, Emitter, Event } from '@theia/core';
+import { inject, injectable, named } from '@theia/core/shared/inversify';
+import { AiConfigurationCategory, AiConfigurationSearchItem } from './ai-configuration-category';
+
+/**
+ * Collects all contributed {@link AiConfigurationCategory} instances and exposes
+ * them ordered for the AI Configuration view. Refires an aggregated
+ * {@link onDidChange} whenever any category changes.
+ */
+@injectable()
+export class AiConfigurationCategoryRegistry {
+
+    @inject(ContributionProvider) @named(AiConfigurationCategory)
+    protected readonly contributions: ContributionProvider<AiConfigurationCategory>;
+
+    protected readonly onDidChangeEmitter = new Emitter<void>();
+    /**
+     * Wires the aggregation lazily on first listen rather than in `@postConstruct`: a category may itself
+     * inject this registry (e.g. to navigate across categories), so resolving all contributions during the
+     * registry's own construction would create a dependency cycle.
+     */
+    readonly onDidChange: Event<void> = (listener, thisArgs, disposables) => {
+        this.wire();
+        return this.onDidChangeEmitter.event(listener, thisArgs, disposables);
+    };
+
+    protected wired = false;
+
+    /** Subscribes once to every category's own change event so this registry can refire an aggregated one. */
+    protected wire(): void {
+        if (this.wired) {
+            return;
+        }
+        this.wired = true;
+        for (const category of this.contributions.getContributions()) {
+            category.onDidChange?.(() => this.onDidChangeEmitter.fire());
+        }
+    }
+
+    /**
+     * Returns the categories ordered ascending by {@link AiConfigurationCategory.order}
+     * (defaulting to `0`); `contributed` categories always sort after built-ins.
+     */
+    getCategories(): AiConfigurationCategory[] {
+        return this.contributions.getContributions().slice().sort((a, b) => {
+            const contributedA = a.contributed ? 1 : 0;
+            const contributedB = b.contributed ? 1 : 0;
+            if (contributedA !== contributedB) {
+                return contributedA - contributedB;
+            }
+            return (a.order ?? 0) - (b.order ?? 0);
+        });
+    }
+
+    getCategory(id: string): AiConfigurationCategory | undefined {
+        return this.contributions.getContributions().find(category => category.id === id);
+    }
+
+    /** Aggregated deep-search index across all categories that provide one. */
+    getSearchItems(): AiConfigurationSearchItem[] {
+        return this.getCategories().flatMap(category => category.search?.getSearchItems() ?? []);
+    }
+}

package/src/browser/ai-configuration/ai-configuration-category.ts

@@ -0,0 +1,246 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// 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 { Event } from '@theia/core';
+// Type-only, so this contribution point stays free of a runtime dependency on the rendering component.
+import type { AiConfigurationOrigin } from './components/ai-configuration-origin-badge';
+
+/**
+ * Contribution point for a category shown in the AI Configuration view.
+ *
+ * Both built-in and externally contributed categories use this identical path;
+ * there is no privileged API. Categories are collected via a
+ * {@link ContributionProvider} and ordered by {@link AiConfigurationCategory.order}
+ * by the {@link AiConfigurationCategoryRegistry}.
+ */
+export const AiConfigurationCategory = Symbol('AiConfigurationCategory');
+
+/**
+ * A `single-page` category renders one detail page; a `collection` category
+ * exposes tree children and renders an overview plus (optionally) per-item detail.
+ */
+export type AiConfigurationCategoryKind = 'single-page' | 'collection';
+
+/**
+ * Spaced ordering scale for the built-in categories, leaving room for
+ * future built-ins and extensions to slot in between. Assigned to
+ * {@link AiConfigurationCategory.order}. Categories with `contributed: true`
+ * always sort after all built-ins, regardless of their `order`.
+ */
+export namespace AiConfigurationCategoryOrder {
+    export const GENERAL = 100;
+    export const MODELS = 200;
+    export const MODEL_ALIASES = 300;
+    export const AGENTS = 400;
+    export const PROMPTS_AND_SKILLS = 500;
+    export const PROMPT_SNIPPETS = 550;
+    export const VARIABLES = 600;
+    export const MCP_SERVERS = 700;
+    export const TOOLS = 800;
+    export const TOKEN_USAGE = 900;
+}
+
+/**
+ * Canonical ids of the built-in categories. Shared so that the categories
+ * (contributed from `ai-ide` and `ai-mcp`), navigation targets, and the legacy
+ * `OPEN_AI_CONFIG_VIEW` tab-id mapping all reference the same stable strings.
+ */
+export namespace AiConfigurationCategoryId {
+    export const GENERAL = 'general';
+    export const MODELS = 'models';
+    export const MODEL_ALIASES = 'model-aliases';
+    export const AGENTS = 'agents';
+    export const PROMPTS_AND_SKILLS = 'prompts-and-skills';
+    export const PROMPT_SNIPPETS = 'prompt-snippets';
+    export const VARIABLES = 'variables';
+    export const MCP_SERVERS = 'mcp-servers';
+    export const TOOLS = 'tools';
+    export const TOKEN_USAGE = 'token-usage';
+}
+
+/**
+ * Navigation into the Tools category's per-tool list. Shared here because the lists that link to it are
+ * spread across packages (an agent's used tools in `@theia/ai-ide`, a server's tools in `@theia/ai-mcp`)
+ * while the page itself lives in `@theia/ai-ide`, which those packages cannot all import.
+ */
+export namespace AiConfigurationTools {
+    /**
+     * Prefix of the `data-ai-config-row-id` the Tools page puts on each tool row. The tool's registry name
+     * completes it — for an MCP tool that is `mcp_<server>_<tool>`, not the bare name shown per server.
+     */
+    export const ROW_ID_PREFIX = 'tool:';
+
+    /** Navigation target that scrolls to and flashes `toolName`'s row, where its confirmation mode is set. */
+    export function selectionFor(toolName: string): AiConfigurationSelection {
+        return {
+            categoryId: AiConfigurationCategoryId.TOOLS,
+            highlight: { rowId: ROW_ID_PREFIX + toolName }
+        };
+    }
+}
+
+/**
+ * The scope a category's settings are read from and written to.
+ *
+ * The view currently always renders the `user` scope; selecting a scope is not implemented yet.
+ */
+export type AiConfigurationScope = 'user' | 'workspace' | 'folder';
+
+export interface AiConfigurationCategory {
+    /** Stable id; used as the tree-node id and in navigation targets. */
+    readonly id: string;
+    /** Localized label shown in the tree and breadcrumb. */
+    readonly label: string;
+    /** Optional one-line description shown under the category name in the detail-page header. */
+    readonly description?: string;
+    /** `codicon(...)` class shown in the tree, breadcrumb, and cards. */
+    readonly iconClass: string;
+    /** Ascending sort; defaults to `0`. Built-ins use a spaced scale. */
+    readonly order?: number;
+    readonly kind: AiConfigurationCategoryKind;
+    /** When `true`, grouped under "Contributed by extensions". Built-ins omit or set `false`. */
+    readonly contributed?: boolean;
+
+    readonly renderer: AiConfigurationCategoryRenderer;
+    /** Optional: items contributed to the tree-level (deep) search index. */
+    readonly search?: AiConfigurationSearchProvider;
+
+    /** Fire to refresh tree children/count badge, overview, and search index. */
+    readonly onDidChange?: Event<void>;
+    dispose?(): void;
+}
+
+/**
+ * Produces the React nodes that drop into the detail-pane primitives.
+ *
+ * A `single-page` category implements {@link renderPage}; a `collection`
+ * category implements {@link getTreeChildren} + {@link renderOverview} and,
+ * optionally, {@link renderItemDetail}.
+ */
+export interface AiConfigurationCategoryRenderer {
+    /** Single-page body (e.g. General, Models, Prompts & Skills, Tools, Token Usage). */
+    renderPage?(ctx: AiConfigurationRenderContext): React.ReactNode;
+
+    /**
+     * Collection overview (category node selected): category-level settings +
+     * filter slot + item card grid + add action + empty state.
+     */
+    renderOverview?(ctx: AiConfigurationRenderContext): React.ReactNode;
+
+    /**
+     * Collection children (items) shown inline in the tree and mirrored as
+     * overview cards. Order is preserved.
+     */
+    getTreeChildren?(): AiConfigurationTreeItem[];
+
+    /**
+     * Collection item detail (child selected). `itemId` is a {@link getTreeChildren} id.
+     * Optional: e.g. Variables have no editable detail (read-only card only).
+     */
+    renderItemDetail?(itemId: string, ctx: AiConfigurationRenderContext): React.ReactNode;
+
+    /**
+     * The `ai-features.*` preference ids this category surfaces or manages. Used by the catch-all
+     * "Advanced" category to render only the preferences no dedicated category already covers, so that
+     * every AI preference stays reachable (AI preferences are hidden from the Settings UI) without being
+     * shown twice. Best-effort: a missing id merely shows up in the catch-all too, it is never lost.
+     */
+    getOwnedPreferenceIds?(): string[];
+
+    /**
+     * The "create item" action of a `collection` category (e.g. adding a custom agent or an MCP server).
+     * Rendered both on the overview and as an inline action on the category's tree node, so it is reachable
+     * without opening the page first. Omit it for categories whose items are not user-created.
+     */
+    getAddAction?(ctx: AiConfigurationRenderContext): AiConfigurationAddDescriptor | undefined;
+}
+
+/** A category's "create item" action: what to call it, and what to run. */
+export interface AiConfigurationAddDescriptor {
+    readonly label: string;
+    readonly iconClass?: string;
+    run(): void;
+}
+
+export interface AiConfigurationTreeItem {
+    readonly id: string;
+    readonly label: string;
+    /**
+     * Short labels shown as badges next to the item's name, for what it *is* rather than what it is doing
+     * (which is {@link status}). Use {@link origins} for where the item came from, which is a badge of its
+     * own kind: it carries an icon and leads somewhere.
+     */
+    readonly tags?: string[];
+    /**
+     * Where the item came from, when that is not the user - an AI registry entry, an Agent Plugin. Shown
+     * next to the item's name on the overview and, unchanged, on the item's detail header, so that
+     * provenance reads the same in both places.
+     */
+    readonly origins?: AiConfigurationOrigin[];
+    /** Status badge shown on the overview card and the item detail header. */
+    readonly status?: AiConfigurationItemStatus;
+    /** Short text for the overview card. */
+    readonly description?: string;
+    /** Overrides the category icon for this item, e.g. a per-agent icon. */
+    readonly iconClass?: string;
+}
+
+export interface AiConfigurationItemStatus {
+    readonly kind: 'on' | 'off' | 'warn' | 'error';
+    /** Short, human-readable badge text, e.g. "Enabled", "Ready". */
+    readonly label: string;
+    /** Optional longer hover detail; falls back to {@link label}. */
+    readonly tooltip?: string;
+}
+
+export interface AiConfigurationSearchProvider {
+    /**
+     * Called to (re)build this category's slice of the deep-search index.
+     * Rebuilt on the category's `onDidChange`.
+     */
+    getSearchItems(): AiConfigurationSearchItem[];
+}
+
+export interface AiConfigurationSearchItem {
+    readonly label: string;
+    /** Small type badge, e.g. "MCP server", "Prompt", "Setting". */
+    readonly typeLabel: string;
+    readonly categoryId: string;
+    /** Where selecting the result navigates. */
+    readonly target: AiConfigurationSelection;
+    /** Extra text folded into the match key (ids, descriptions). */
+    readonly keywords?: string;
+}
+
+export interface AiConfigurationSelection {
+    readonly categoryId: string;
+    /** `undefined` => single-page body / collection overview. */
+    readonly itemId?: string;
+    /**
+     * Optional row/setting to scroll-to and flash after navigating. `rowId` is matched against the
+     * `data-ai-config-row-id` attribute the shared setting rows carry.
+     */
+    readonly highlight?: { readonly rowId: string };
+}
+
+export interface AiConfigurationRenderContext {
+    /** Scope the rows read from and write to. Always `user` for now; per-scope editing is not wired up yet. */
+    readonly scope: AiConfigurationScope;
+    /** Select another node (used by cards, links, "used by" chips). */
+    navigate(selection: AiConfigurationSelection): void;
+    /** Ask the detail host to re-render the current category body. */
+    update(): void;
+}

package/src/browser/ai-configuration/ai-configuration-selection-model.ts

@@ -0,0 +1,42 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// 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 { Emitter, Event } from '@theia/core';
+import { injectable } from '@theia/core/shared/inversify';
+import { AiConfigurationSelection } from './ai-configuration-category';
+
+/**
+ * Shared selection bus for the AI Configuration view. The tree, the detail host,
+ * and renderers navigate through this single model instead of talking directly
+ * to each other.
+ */
+@injectable()
+export class AiConfigurationSelectionModel {
+
+    protected selection: AiConfigurationSelection | undefined;
+
+    protected readonly onDidChangeSelectionEmitter = new Emitter<AiConfigurationSelection | undefined>();
+    readonly onDidChangeSelection: Event<AiConfigurationSelection | undefined> = this.onDidChangeSelectionEmitter.event;
+
+    getSelection(): AiConfigurationSelection | undefined {
+        return this.selection;
+    }
+
+    select(selection: AiConfigurationSelection | undefined): void {
+        this.selection = selection;
+        this.onDidChangeSelectionEmitter.fire(selection);
+    }
+}

package/src/browser/ai-configuration/ai-configuration-setting-commands.spec.ts

@@ -0,0 +1,82 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// 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 { Command, CommandRegistry, PreferenceScope } from '@theia/core';
+import {
+    AiConfigurationSettingCommandArgs,
+    AiConfigurationSettingCommandContribution,
+    AiConfigurationSettingCommands
+} from './ai-configuration-setting-commands';
+
+interface Handler { execute(args: unknown): unknown; isVisible?(args: unknown): boolean; isEnabled?(args: unknown): boolean }
+
+function setup(): { handlers: Map<string, Handler>; setCalls: Array<[string, unknown, PreferenceScope, string | undefined]>; copied: string[] } {
+    const setCalls: Array<[string, unknown, PreferenceScope, string | undefined]> = [];
+    const copied: string[] = [];
+    const contribution = new AiConfigurationSettingCommandContribution();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (contribution as any).aiConfigurationService = {
+        set: (id: string, value: unknown, scope: PreferenceScope, resourceUri?: string) => { setCalls.push([id, value, scope, resourceUri]); return Promise.resolve(); }
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (contribution as any).clipboardService = { writeText: (text: string) => { copied.push(text); } };
+    const handlers = new Map<string, Handler>();
+    contribution.registerCommands({ registerCommand: (command: Command, handler: Handler) => handlers.set(command.id, handler) } as unknown as CommandRegistry);
+    return { handlers, setCalls, copied };
+}
+
+const args: AiConfigurationSettingCommandArgs = { id: 'ai-features.chat.foo', value: true, scope: PreferenceScope.User };
+
+describe('AiConfigurationSettingCommandContribution', () => {
+
+    it('resets a setting in the row scope via AiConfigurationService (not the Settings widget)', () => {
+        const { handlers, setCalls } = setup();
+        handlers.get(AiConfigurationSettingCommands.RESET.id)!.execute({ ...args, scope: PreferenceScope.Workspace, resourceUri: 'file:///ws' });
+        expect(setCalls).to.deep.equal([['ai-features.chat.foo', undefined, PreferenceScope.Workspace, 'file:///ws']]);
+    });
+
+    it('resets via the supplied callback for non-preference (e.g. per-agent) rows, without touching AiConfigurationService', () => {
+        const { handlers, setCalls } = setup();
+        let called = 0;
+        const reset = handlers.get(AiConfigurationSettingCommands.RESET.id)!;
+        expect(reset.isVisible!({ reset: () => called++ })).to.equal(true);
+        reset.execute({ reset: () => called++ });
+        expect(called).to.equal(1);
+        expect(setCalls).to.be.empty;
+    });
+
+    it('hides the copy commands for non-preference (callback-only) rows', () => {
+        const { handlers } = setup();
+        expect(handlers.get(AiConfigurationSettingCommands.COPY_ID.id)!.isVisible!({ reset: () => undefined })).to.equal(false);
+        expect(handlers.get(AiConfigurationSettingCommands.COPY_JSON.id)!.isVisible!({ reset: () => undefined })).to.equal(false);
+    });
+
+    it('copies the setting id and the JSON entry', () => {
+        const { handlers, copied } = setup();
+        handlers.get(AiConfigurationSettingCommands.COPY_ID.id)!.execute(args);
+        handlers.get(AiConfigurationSettingCommands.COPY_JSON.id)!.execute(args);
+        expect(copied).to.deep.equal(['ai-features.chat.foo', '"ai-features.chat.foo": true']);
+    });
+
+    it('guards the commands against malformed arguments', () => {
+        const { handlers } = setup();
+        const reset = handlers.get(AiConfigurationSettingCommands.RESET.id)!;
+        expect(reset.isVisible!(args)).to.equal(true);
+        expect(reset.isVisible!({ id: 'x' })).to.equal(false); // missing scope
+        expect(reset.isVisible!(undefined)).to.equal(false);
+    });
+});