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

package/lib/browser/ai-configuration/ai-configuration-category-registry.d.ts

@@ -0,0 +1,29 @@
+import { ContributionProvider, Emitter, Event } from '@theia/core';
+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.
+ */
+export declare class AiConfigurationCategoryRegistry {
+    protected readonly contributions: ContributionProvider<AiConfigurationCategory>;
+    protected readonly onDidChangeEmitter: 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>;
+    protected wired: boolean;
+    /** Subscribes once to every category's own change event so this registry can refire an aggregated one. */
+    protected wire(): void;
+    /**
+     * Returns the categories ordered ascending by {@link AiConfigurationCategory.order}
+     * (defaulting to `0`); `contributed` categories always sort after built-ins.
+     */
+    getCategories(): AiConfigurationCategory[];
+    getCategory(id: string): AiConfigurationCategory | undefined;
+    /** Aggregated deep-search index across all categories that provide one. */
+    getSearchItems(): AiConfigurationSearchItem[];
+}
+//# sourceMappingURL=ai-configuration-category-registry.d.ts.map

package/lib/browser/ai-configuration/ai-configuration-category-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-configuration-category-registry.d.ts","sourceRoot":"","sources":["../../../src/browser/ai-configuration/ai-configuration-category-registry.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAEjG;;;;GAIG;AACH,qBACa,+BAA+B;IAGxC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC,uBAAuB,CAAC,CAAC;IAEhF,SAAS,CAAC,QAAQ,CAAC,kBAAkB,gBAAuB;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAG/B;IAEF,SAAS,CAAC,KAAK,UAAS;IAExB,0GAA0G;IAC1G,SAAS,CAAC,IAAI,IAAI,IAAI;IAUtB;;;OAGG;IACH,aAAa,IAAI,uBAAuB,EAAE;IAW1C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAI5D,2EAA2E;IAC3E,cAAc,IAAI,yBAAyB,EAAE;CAGhD"}

package/lib/browser/ai-configuration/ai-configuration-category-registry.js

@@ -0,0 +1,83 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiConfigurationCategoryRegistry = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@theia/core");
+const inversify_1 = require("@theia/core/shared/inversify");
+const ai_configuration_category_1 = require("./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.
+ */
+let AiConfigurationCategoryRegistry = class AiConfigurationCategoryRegistry {
+    constructor() {
+        this.onDidChangeEmitter = new core_1.Emitter();
+        /**
+         * 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.
+         */
+        this.onDidChange = (listener, thisArgs, disposables) => {
+            this.wire();
+            return this.onDidChangeEmitter.event(listener, thisArgs, disposables);
+        };
+        this.wired = false;
+    }
+    /** Subscribes once to every category's own change event so this registry can refire an aggregated one. */
+    wire() {
+        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() {
+        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) {
+        return this.contributions.getContributions().find(category => category.id === id);
+    }
+    /** Aggregated deep-search index across all categories that provide one. */
+    getSearchItems() {
+        return this.getCategories().flatMap(category => category.search?.getSearchItems() ?? []);
+    }
+};
+exports.AiConfigurationCategoryRegistry = AiConfigurationCategoryRegistry;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ContributionProvider),
+    (0, inversify_1.named)(ai_configuration_category_1.AiConfigurationCategory),
+    tslib_1.__metadata("design:type", Object)
+], AiConfigurationCategoryRegistry.prototype, "contributions", void 0);
+exports.AiConfigurationCategoryRegistry = AiConfigurationCategoryRegistry = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], AiConfigurationCategoryRegistry);
+//# sourceMappingURL=ai-configuration-category-registry.js.map

package/lib/browser/ai-configuration/ai-configuration-category-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-configuration-category-registry.js","sourceRoot":"","sources":["../../../src/browser/ai-configuration/ai-configuration-category-registry.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,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,sCAAmE;AACnE,4DAAyE;AACzE,2EAAiG;AAEjG;;;;GAIG;AAEI,IAAM,+BAA+B,GAArC,MAAM,+BAA+B;IAArC;QAKgB,uBAAkB,GAAG,IAAI,cAAO,EAAQ,CAAC;QAC5D;;;;WAIG;QACM,gBAAW,GAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE;YACpE,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1E,CAAC,CAAC;QAEQ,UAAK,GAAG,KAAK,CAAC;IAoC5B,CAAC;IAlCG,0GAA0G;IAChG,IAAI;QACV,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO;QACX,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAC3D,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,aAAa;QACT,OAAO,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC/D,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;gBAChC,OAAO,YAAY,GAAG,YAAY,CAAC;YACvC,CAAC;YACD,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,2EAA2E;IAC3E,cAAc;QACV,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7F,CAAC;CACJ,CAAA;AApDY,0EAA+B;AAGrB;IADlB,IAAA,kBAAM,EAAC,2BAAoB,CAAC;IAAE,IAAA,iBAAK,EAAC,mDAAuB,CAAC;;sEACmB;0CAHvE,+BAA+B;IAD3C,IAAA,sBAAU,GAAE;GACA,+BAA+B,CAoD3C"}

package/lib/browser/ai-configuration/ai-configuration-category-registry.spec.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=ai-configuration-category-registry.spec.d.ts.map

package/lib/browser/ai-configuration/ai-configuration-category-registry.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-configuration-category-registry.spec.d.ts","sourceRoot":"","sources":["../../../src/browser/ai-configuration/ai-configuration-category-registry.spec.ts"],"names":[],"mappings":"AAgBA,OAAO,kBAAkB,CAAC"}

package/lib/browser/ai-configuration/ai-configuration-category-registry.spec.js

@@ -0,0 +1,122 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+require("reflect-metadata");
+const chai_1 = require("chai");
+const core_1 = require("@theia/core");
+const inversify_1 = require("@theia/core/shared/inversify");
+const common_1 = require("@theia/core/lib/common");
+const ai_configuration_category_1 = require("./ai-configuration-category");
+const ai_configuration_category_registry_1 = require("./ai-configuration-category-registry");
+class DummyCategory {
+    constructor(id, order, contributed, searchItems = []) {
+        this.id = id;
+        this.order = order;
+        this.contributed = contributed;
+        this.searchItems = searchItems;
+        this.renderer = {};
+        this.onDidChangeEmitter = new core_1.Emitter();
+        this.onDidChange = this.onDidChangeEmitter.event;
+        this.label = this.id;
+        this.iconClass = 'codicon codicon-gear';
+        this.kind = 'single-page';
+    }
+    get search() {
+        return this.searchItems.length ? { getSearchItems: () => this.searchItems } : undefined;
+    }
+    fireChange() {
+        this.onDidChangeEmitter.fire();
+    }
+}
+describe('AiConfigurationCategoryRegistry', () => {
+    function createRegistry(...categories) {
+        const container = new inversify_1.Container();
+        container.load(new inversify_1.ContainerModule(bind => {
+            (0, common_1.bindContributionProvider)(bind, ai_configuration_category_1.AiConfigurationCategory);
+            categories.forEach(category => bind(ai_configuration_category_1.AiConfigurationCategory).toConstantValue(category));
+            bind(ai_configuration_category_registry_1.AiConfigurationCategoryRegistry).toSelf().inSingletonScope();
+        }));
+        return container.get(ai_configuration_category_registry_1.AiConfigurationCategoryRegistry);
+    }
+    it('resolves to an empty list when nothing is contributed', () => {
+        const registry = createRegistry();
+        (0, chai_1.expect)(registry.getCategories()).to.deep.equal([]);
+    });
+    it('aggregates an empty search index when nothing is contributed', () => {
+        const registry = createRegistry();
+        (0, chai_1.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));
+        (0, chai_1.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));
+        (0, chai_1.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));
+        (0, chai_1.expect)(registry.getCategory('b')?.id).to.equal('b');
+        (0, chai_1.expect)(registry.getCategory('missing')).to.equal(undefined);
+    });
+    it('aggregates the search index across categories that provide one', () => {
+        const item = (label, categoryId) => ({ 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')]));
+        (0, chai_1.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();
+        (0, chai_1.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.
+        let RegistryInjectingCategory = class RegistryInjectingCategory {
+            constructor() {
+                this.id = 'self';
+                this.label = 'self';
+                this.iconClass = 'codicon codicon-gear';
+                this.kind = 'single-page';
+                this.renderer = {};
+            }
+        };
+        tslib_1.__decorate([
+            (0, inversify_1.inject)(ai_configuration_category_registry_1.AiConfigurationCategoryRegistry),
+            tslib_1.__metadata("design:type", ai_configuration_category_registry_1.AiConfigurationCategoryRegistry)
+        ], RegistryInjectingCategory.prototype, "registry", void 0);
+        RegistryInjectingCategory = tslib_1.__decorate([
+            (0, inversify_1.injectable)()
+        ], RegistryInjectingCategory);
+        const container = new inversify_1.Container();
+        container.load(new inversify_1.ContainerModule(bind => {
+            (0, common_1.bindContributionProvider)(bind, ai_configuration_category_1.AiConfigurationCategory);
+            bind(RegistryInjectingCategory).toSelf().inSingletonScope();
+            bind(ai_configuration_category_1.AiConfigurationCategory).toService(RegistryInjectingCategory);
+            bind(ai_configuration_category_registry_1.AiConfigurationCategoryRegistry).toSelf().inSingletonScope();
+        }));
+        const registry = container.get(ai_configuration_category_registry_1.AiConfigurationCategoryRegistry);
+        // Listening wires the aggregation, which resolves the contribution that injects this very registry.
+        (0, chai_1.expect)(() => registry.onDidChange(() => { })).to.not.throw();
+        (0, chai_1.expect)(registry.getCategories().map(category => category.id)).to.deep.equal(['self']);
+    });
+});
+//# sourceMappingURL=ai-configuration-category-registry.spec.js.map

package/lib/browser/ai-configuration/ai-configuration-category-registry.spec.js.map

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

package/lib/browser/ai-configuration/ai-configuration-category.d.ts

@@ -0,0 +1,204 @@
+import { Event } from '@theia/core';
+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 declare const AiConfigurationCategory: unique symbol;
+/**
+ * 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 declare namespace AiConfigurationCategoryOrder {
+    const GENERAL = 100;
+    const MODELS = 200;
+    const MODEL_ALIASES = 300;
+    const AGENTS = 400;
+    const PROMPTS_AND_SKILLS = 500;
+    const PROMPT_SNIPPETS = 550;
+    const VARIABLES = 600;
+    const MCP_SERVERS = 700;
+    const TOOLS = 800;
+    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 declare namespace AiConfigurationCategoryId {
+    const GENERAL = "general";
+    const MODELS = "models";
+    const MODEL_ALIASES = "model-aliases";
+    const AGENTS = "agents";
+    const PROMPTS_AND_SKILLS = "prompts-and-skills";
+    const PROMPT_SNIPPETS = "prompt-snippets";
+    const VARIABLES = "variables";
+    const MCP_SERVERS = "mcp-servers";
+    const TOOLS = "tools";
+    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 declare 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.
+     */
+    const ROW_ID_PREFIX = "tool:";
+    /** Navigation target that scrolls to and flashes `toolName`'s row, where its confirmation mode is set. */
+    function selectionFor(toolName: string): AiConfigurationSelection;
+}
+/**
+ * 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;
+}
+//# sourceMappingURL=ai-configuration-category.d.ts.map

package/lib/browser/ai-configuration/ai-configuration-category.d.ts.map

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

package/lib/browser/ai-configuration/ai-configuration-category.js

@@ -0,0 +1,86 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiConfigurationTools = exports.AiConfigurationCategoryId = exports.AiConfigurationCategoryOrder = exports.AiConfigurationCategory = void 0;
+/**
+ * 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}.
+ */
+exports.AiConfigurationCategory = Symbol('AiConfigurationCategory');
+/**
+ * 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`.
+ */
+var AiConfigurationCategoryOrder;
+(function (AiConfigurationCategoryOrder) {
+    AiConfigurationCategoryOrder.GENERAL = 100;
+    AiConfigurationCategoryOrder.MODELS = 200;
+    AiConfigurationCategoryOrder.MODEL_ALIASES = 300;
+    AiConfigurationCategoryOrder.AGENTS = 400;
+    AiConfigurationCategoryOrder.PROMPTS_AND_SKILLS = 500;
+    AiConfigurationCategoryOrder.PROMPT_SNIPPETS = 550;
+    AiConfigurationCategoryOrder.VARIABLES = 600;
+    AiConfigurationCategoryOrder.MCP_SERVERS = 700;
+    AiConfigurationCategoryOrder.TOOLS = 800;
+    AiConfigurationCategoryOrder.TOKEN_USAGE = 900;
+})(AiConfigurationCategoryOrder || (exports.AiConfigurationCategoryOrder = AiConfigurationCategoryOrder = {}));
+/**
+ * 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.
+ */
+var AiConfigurationCategoryId;
+(function (AiConfigurationCategoryId) {
+    AiConfigurationCategoryId.GENERAL = 'general';
+    AiConfigurationCategoryId.MODELS = 'models';
+    AiConfigurationCategoryId.MODEL_ALIASES = 'model-aliases';
+    AiConfigurationCategoryId.AGENTS = 'agents';
+    AiConfigurationCategoryId.PROMPTS_AND_SKILLS = 'prompts-and-skills';
+    AiConfigurationCategoryId.PROMPT_SNIPPETS = 'prompt-snippets';
+    AiConfigurationCategoryId.VARIABLES = 'variables';
+    AiConfigurationCategoryId.MCP_SERVERS = 'mcp-servers';
+    AiConfigurationCategoryId.TOOLS = 'tools';
+    AiConfigurationCategoryId.TOKEN_USAGE = 'token-usage';
+})(AiConfigurationCategoryId || (exports.AiConfigurationCategoryId = AiConfigurationCategoryId = {}));
+/**
+ * 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.
+ */
+var AiConfigurationTools;
+(function (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.
+     */
+    AiConfigurationTools.ROW_ID_PREFIX = 'tool:';
+    /** Navigation target that scrolls to and flashes `toolName`'s row, where its confirmation mode is set. */
+    function selectionFor(toolName) {
+        return {
+            categoryId: AiConfigurationCategoryId.TOOLS,
+            highlight: { rowId: AiConfigurationTools.ROW_ID_PREFIX + toolName }
+        };
+    }
+    AiConfigurationTools.selectionFor = selectionFor;
+})(AiConfigurationTools || (exports.AiConfigurationTools = AiConfigurationTools = {}));
+//# sourceMappingURL=ai-configuration-category.js.map

package/lib/browser/ai-configuration/ai-configuration-category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-configuration-category.js","sourceRoot":"","sources":["../../../src/browser/ai-configuration/ai-configuration-category.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,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;;;AAMhF;;;;;;;GAOG;AACU,QAAA,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAQzE;;;;;GAKG;AACH,IAAiB,4BAA4B,CAW5C;AAXD,WAAiB,4BAA4B;IAC5B,oCAAO,GAAG,GAAG,CAAC;IACd,mCAAM,GAAG,GAAG,CAAC;IACb,0CAAa,GAAG,GAAG,CAAC;IACpB,mCAAM,GAAG,GAAG,CAAC;IACb,+CAAkB,GAAG,GAAG,CAAC;IACzB,4CAAe,GAAG,GAAG,CAAC;IACtB,sCAAS,GAAG,GAAG,CAAC;IAChB,wCAAW,GAAG,GAAG,CAAC;IAClB,kCAAK,GAAG,GAAG,CAAC;IACZ,wCAAW,GAAG,GAAG,CAAC;AACnC,CAAC,EAXgB,4BAA4B,4CAA5B,4BAA4B,QAW5C;AAED;;;;GAIG;AACH,IAAiB,yBAAyB,CAWzC;AAXD,WAAiB,yBAAyB;IACzB,iCAAO,GAAG,SAAS,CAAC;IACpB,gCAAM,GAAG,QAAQ,CAAC;IAClB,uCAAa,GAAG,eAAe,CAAC;IAChC,gCAAM,GAAG,QAAQ,CAAC;IAClB,4CAAkB,GAAG,oBAAoB,CAAC;IAC1C,yCAAe,GAAG,iBAAiB,CAAC;IACpC,mCAAS,GAAG,WAAW,CAAC;IACxB,qCAAW,GAAG,aAAa,CAAC;IAC5B,+BAAK,GAAG,OAAO,CAAC;IAChB,qCAAW,GAAG,aAAa,CAAC;AAC7C,CAAC,EAXgB,yBAAyB,yCAAzB,yBAAyB,QAWzC;AAED;;;;GAIG;AACH,IAAiB,oBAAoB,CAcpC;AAdD,WAAiB,oBAAoB;IACjC;;;OAGG;IACU,kCAAa,GAAG,OAAO,CAAC;IAErC,0GAA0G;IAC1G,SAAgB,YAAY,CAAC,QAAgB;QACzC,OAAO;YACH,UAAU,EAAE,yBAAyB,CAAC,KAAK;YAC3C,SAAS,EAAE,EAAE,KAAK,EAAE,qBAAA,aAAa,GAAG,QAAQ,EAAE;SACjD,CAAC;IACN,CAAC;IALe,iCAAY,eAK3B,CAAA;AACL,CAAC,EAdgB,oBAAoB,oCAApB,oBAAoB,QAcpC"}

package/lib/browser/ai-configuration/ai-configuration-selection-model.d.ts

@@ -0,0 +1,15 @@
+import { Emitter, Event } from '@theia/core';
+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.
+ */
+export declare class AiConfigurationSelectionModel {
+    protected selection: AiConfigurationSelection | undefined;
+    protected readonly onDidChangeSelectionEmitter: Emitter<AiConfigurationSelection | undefined>;
+    readonly onDidChangeSelection: Event<AiConfigurationSelection | undefined>;
+    getSelection(): AiConfigurationSelection | undefined;
+    select(selection: AiConfigurationSelection | undefined): void;
+}
+//# sourceMappingURL=ai-configuration-selection-model.d.ts.map

package/lib/browser/ai-configuration/ai-configuration-selection-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-configuration-selection-model.d.ts","sourceRoot":"","sources":["../../../src/browser/ai-configuration/ai-configuration-selection-model.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;GAIG;AACH,qBACa,6BAA6B;IAEtC,SAAS,CAAC,SAAS,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAE1D,SAAS,CAAC,QAAQ,CAAC,2BAA2B,gDAAuD;IACrG,QAAQ,CAAC,oBAAoB,EAAE,KAAK,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAA0C;IAEpH,YAAY,IAAI,wBAAwB,GAAG,SAAS;IAIpD,MAAM,CAAC,SAAS,EAAE,wBAAwB,GAAG,SAAS,GAAG,IAAI;CAIhE"}

package/lib/browser/ai-configuration/ai-configuration-selection-model.js

@@ -0,0 +1,44 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiConfigurationSelectionModel = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@theia/core");
+const inversify_1 = require("@theia/core/shared/inversify");
+/**
+ * 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.
+ */
+let AiConfigurationSelectionModel = class AiConfigurationSelectionModel {
+    constructor() {
+        this.onDidChangeSelectionEmitter = new core_1.Emitter();
+        this.onDidChangeSelection = this.onDidChangeSelectionEmitter.event;
+    }
+    getSelection() {
+        return this.selection;
+    }
+    select(selection) {
+        this.selection = selection;
+        this.onDidChangeSelectionEmitter.fire(selection);
+    }
+};
+exports.AiConfigurationSelectionModel = AiConfigurationSelectionModel;
+exports.AiConfigurationSelectionModel = AiConfigurationSelectionModel = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], AiConfigurationSelectionModel);
+//# sourceMappingURL=ai-configuration-selection-model.js.map

package/lib/browser/ai-configuration/ai-configuration-selection-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-configuration-selection-model.js","sourceRoot":"","sources":["../../../src/browser/ai-configuration/ai-configuration-selection-model.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,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,sCAA6C;AAC7C,4DAA0D;AAG1D;;;;GAIG;AAEI,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAAnC;QAIgB,gCAA2B,GAAG,IAAI,cAAO,EAAwC,CAAC;QAC5F,yBAAoB,GAAgD,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC;IAUxH,CAAC;IARG,YAAY;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,SAA+C;QAClD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACJ,CAAA;AAfY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,sBAAU,GAAE;GACA,6BAA6B,CAezC"}