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

package/lib/browser/ai-configuration/categories/agent-detail-view.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentDetailView = void 0;
+const jsx_runtime_1 = require("@theia/core/shared/react/jsx-runtime");
+// *****************************************************************************
+// 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
+// *****************************************************************************
+const common_1 = require("@theia/ai-core/lib/common");
+const common_2 = require("@theia/ai-chat/lib/common");
+const core_1 = require("@theia/core");
+const browser_1 = require("@theia/core/lib/browser");
+const ai_configuration_view_contribution_1 = require("../ai-configuration-view-contribution");
+const React = require("@theia/core/shared/react");
+const ai_configuration_primitives_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/components/ai-configuration-primitives");
+const ai_configuration_item_row_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/components/ai-configuration-item-row");
+const ai_configuration_controls_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/components/ai-configuration-controls");
+const variant_set_card_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/components/variant-set-card");
+const language_model_renderer_1 = require("../language-model-renderer");
+const agent_notification_settings_1 = require("../components/agent-notification-settings");
+const agent_icon_1 = require("../agent-icon");
+const agent_detail_model_1 = require("./agent-detail-model");
+const agent_capabilities_settings_1 = require("./agent-capabilities-settings");
+/**
+ * The Agents item-detail page: enable/show-in-chat toggles, description, prompt
+ * templates, LLM requirements, used variables/functions, capabilities and
+ * notification settings. Owns its async state (parsed prompt parts + agent
+ * settings), reloading whenever {@link AgentDetailViewProps.revision} changes.
+ */
+const AgentDetailView = ({ agent, services, languageModels, languageModelAliases, revision, onOpenPromptSnippet, onOpenTool }) => {
+    const { agentService, aiSettingsService, variableService, promptService, languageModelRegistry, toolInvocationRegistry, commandService, settingsRowService } = services;
+    const [state, setState] = React.useState(undefined);
+    React.useEffect(() => {
+        let disposed = false;
+        (0, agent_detail_model_1.loadAgentDetail)(agent, services).then(loaded => {
+            if (!disposed) {
+                setState(loaded);
+            }
+        });
+        return () => { disposed = true; };
+    }, [agent, revision, aiSettingsService, promptService, variableService]);
+    const enabled = agentService.isEnabled(agent.id);
+    const toggleEnabled = React.useCallback(() => {
+        if (enabled) {
+            agentService.disableAgent(agent.id);
+        }
+        else {
+            agentService.enableAgent(agent.id);
+        }
+    }, [agent, agentService, enabled]);
+    const toggleShowInChat = React.useCallback(() => {
+        if (!enabled || !state) {
+            return;
+        }
+        aiSettingsService.updateAgentSettings(agent.id, { showInChat: !state.showInChat });
+    }, [agent, aiSettingsService, enabled, state]);
+    const handleNotificationTypeChange = React.useCallback(async (agentId, notificationType) => {
+        await aiSettingsService.updateAgentSettings(agentId, { completionNotification: notificationType });
+    }, [aiSettingsService]);
+    const openNotificationSettings = React.useCallback(() => {
+        commandService.executeCommand(ai_configuration_view_contribution_1.OPEN_AI_CONFIG_VIEW.id, common_1.PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE);
+    }, [commandService]);
+    const header = (0, jsx_runtime_1.jsx)(ai_configuration_primitives_1.AiConfigurationItemDetailHeader, { title: agent.name, iconClass: (0, agent_icon_1.getAgentIconClass)(agent), subtitle: core_1.nls.localizeByDefault('Id: {0}', agent.id), actions: (0, jsx_runtime_1.jsx)(AgentDetailToggles, { enabled: enabled, showInChat: state?.showInChat ?? true, showInChatVisible: (0, common_2.isChatAgent)(agent), onToggleEnabled: toggleEnabled, onToggleShowInChat: toggleShowInChat }) });
+    if (!state) {
+        return (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [header, (0, jsx_runtime_1.jsx)("div", { className: 'ai-agent-detail-loading', children: core_1.nls.localizeByDefault('Loading...') })] });
+    }
+    const globalVariables = Array.from(new Set([...state.parsed.globalVariables, ...agent.variables]));
+    const functions = Array.from(new Set([...state.parsed.functions, ...agent.functions]));
+    // Rows for the "Used by this agent" lists, rendered with the shared list so global variables,
+    // agent-specific variables and functions all look the same (replacing three custom renderers). Each
+    // shows a description when it has one and the lists are sorted alphabetically by label.
+    const byLabel = (rows) => [...rows].sort((a, b) => a.label.localeCompare(b.label));
+    const allVariables = variableService.getVariables();
+    const globalVariableRows = byLabel(globalVariables.map(id => {
+        const variable = allVariables.find(candidate => candidate.id === id);
+        return { id, label: variable?.name ?? id, description: variable?.description || undefined };
+    }));
+    const functionRows = byLabel(functions.map(id => ({ id, label: id, description: toolInvocationRegistry.getFunction(id)?.description || undefined })));
+    const agentSpecificNames = Array.from(new Set([...state.parsed.agentSpecificVariables, ...agent.agentSpecificVariables.map(v => v.name)]));
+    const agentSpecificRows = byLabel(agentSpecificNames.map(name => {
+        const declared = agent.agentSpecificVariables.find(v => v.name === name);
+        const undeclared = declared === undefined;
+        const notUsed = !state.parsed.agentSpecificVariables.includes(name) && declared?.usedInPrompt === true;
+        const status = undeclared
+            ? {
+                kind: 'warn', label: core_1.nls.localize('theia/ai/core/agentConfiguration/undeclared', 'Undeclared'),
+                tooltip: core_1.nls.localize('theia/ai/core/agentConfiguration/undeclaredTooltip', 'This variable is used in the prompt but has no description declared by the agent.')
+            }
+            : notUsed
+                ? {
+                    kind: 'warn', label: core_1.nls.localize('theia/ai/core/agentConfiguration/notUsedInPrompt', 'Not used in prompt'),
+                    tooltip: core_1.nls.localize('theia/ai/core/agentConfiguration/notUsedInPromptTooltip', 'This variable is declared by the agent but not referenced in the current prompt template.')
+                }
+                : undefined;
+        return { id: name, label: name, description: undeclared ? undefined : declared?.description || undefined, status };
+    }));
+    // Map each variant id to the display name used by the chat mode switcher (the agent's ChatMode names).
+    const variantLabels = {};
+    if ((0, common_2.isChatAgent)(agent) && agent.modes) {
+        for (const mode of agent.modes) {
+            variantLabels[mode.id] = mode.name;
+        }
+    }
+    return (0, jsx_runtime_1.jsxs)("div", { className: 'ai-agent-detail', children: [header, agent.description && (0, jsx_runtime_1.jsx)("div", { className: 'ai-agent-description', children: agent.description }), agent.prompts.length > 0 && (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("div", { className: 'settings-section-subcategory-title ai-settings-section-subcategory-title', children: core_1.nls.localizeByDefault('Prompts') }), (0, jsx_runtime_1.jsx)("div", { className: 'ai-configuration-item-list', children: agent.prompts.map(prompt => (0, jsx_runtime_1.jsx)(variant_set_card_1.VariantSetCard, { agentId: agent.id, promptVariantSetId: prompt.id, promptService: promptService, settingsRowService: settingsRowService, variantLabels: variantLabels }, agent.id + '.' + prompt.id)) })] }), (0, jsx_runtime_1.jsx)("div", { className: 'ai-lm-requirements', children: (0, jsx_runtime_1.jsx)(language_model_renderer_1.LanguageModelRenderer, { agent: agent, languageModels: languageModels, aiSettingsService: aiSettingsService, languageModelRegistry: languageModelRegistry, languageModelAliases: languageModelAliases, settingsRowService: settingsRowService }) }), (0, common_2.isChatAgent)(agent) && (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("div", { className: 'settings-section-subcategory-title ai-settings-section-subcategory-title', children: core_1.nls.localize('theia/ai/core/agentConfiguration/notificationSettings', 'Notification Settings') }), (0, jsx_runtime_1.jsx)(agent_notification_settings_1.AgentNotificationSettings, { agentId: agent.id, currentNotificationType: state.completionNotification, onNotificationTypeChange: handleNotificationTypeChange, onOpenNotificationSettings: openNotificationSettings, settingsRowService: settingsRowService })] }), state.parsed.capabilities.length > 0 && (0, jsx_runtime_1.jsx)(agent_capabilities_settings_1.AgentCapabilitiesSettings, { capabilities: state.parsed.capabilities, agentId: agent.id, savedOverrides: state.capabilityOverrides, aiSettingsService: aiSettingsService, settingsRowService: settingsRowService, onOpenPromptSnippet: onOpenPromptSnippet }), common_1.GenericCapabilitySelections.hasSelections(state.genericCapabilitySelections) && (0, jsx_runtime_1.jsx)(agent_capabilities_settings_1.AgentGenericCapabilitiesSettings, { agentId: agent.id, savedSelections: state.genericCapabilitySelections, aiSettingsService: aiSettingsService, settingsRowService: settingsRowService, onOpenPromptSnippet: onOpenPromptSnippet }), state.serverTools && state.serverTools.length > 0 && state.serverToolVendor && (0, jsx_runtime_1.jsx)(agent_capabilities_settings_1.AgentServerToolsSettings, { agentId: agent.id, tools: state.serverTools, vendor: state.serverToolVendor, savedSelections: state.serverToolSelections, aiSettingsService: aiSettingsService, settingsRowService: settingsRowService }), globalVariableRows.length > 0 && (0, jsx_runtime_1.jsx)(CollapsibleSubsection, { title: core_1.nls.localize('theia/ai/core/agentConfiguration/usedGlobalVariables', 'Used Global Variables'), count: globalVariableRows.length, children: (0, jsx_runtime_1.jsx)("div", { className: 'ai-configuration-item-list', children: globalVariableRows.map(row => (0, jsx_runtime_1.jsx)(ai_configuration_item_row_1.AiConfigurationItemRow, { label: row.label, description: row.description }, row.id)) }) }), agentSpecificRows.length > 0 && (0, jsx_runtime_1.jsx)(CollapsibleSubsection, { title: core_1.nls.localize('theia/ai/core/agentConfiguration/usedAgentSpecificVariables', 'Used Agent-Specific Variables'), count: agentSpecificRows.length, children: (0, jsx_runtime_1.jsx)("div", { className: 'ai-configuration-item-list', children: agentSpecificRows.map(row => (0, jsx_runtime_1.jsx)(ai_configuration_item_row_1.AiConfigurationItemRow, { label: row.label, description: row.description, status: row.status }, row.id)) }) }), functionRows.length > 0 && (0, jsx_runtime_1.jsx)(CollapsibleSubsection, { title: core_1.nls.localize('theia/ai/core/agentConfiguration/usedTools', 'Used Tools'), count: functionRows.length, children: (0, jsx_runtime_1.jsx)("div", { className: 'ai-configuration-item-list', children: functionRows.map(row => (0, jsx_runtime_1.jsx)(ai_configuration_item_row_1.AiConfigurationItemRow, { label: row.label, description: row.description, onActivateLabel: () => onOpenTool(row.id), labelTooltip: core_1.nls.localize('theia/ai/ide/agentConfiguration/showToolSettings', 'Show tool') }, row.id)) }) })] }, agent.id);
+};
+exports.AgentDetailView = AgentDetailView;
+/**
+ * A read-only detail subsection whose body collapses under a subcategory-styled header (chevron + item
+ * count). Collapsed by default to keep the agent page compact; the header matches the non-collapsible
+ * subcategory titles above it. Used for the "Used …" reference lists (variables, functions).
+ */
+const CollapsibleSubsection = ({ title, count, children }) => {
+    const [open, setOpen] = React.useState(false);
+    const toggle = React.useCallback(() => setOpen(previous => !previous), []);
+    const onKeyDown = React.useCallback((event) => {
+        if (event.key === 'Enter' || event.key === ' ') {
+            event.preventDefault();
+            toggle();
+        }
+    }, [toggle]);
+    return (0, jsx_runtime_1.jsxs)("div", { className: 'ai-collapsible-subsection', children: [(0, jsx_runtime_1.jsxs)("div", { className: 'settings-section-subcategory-title ai-settings-section-subcategory-title ai-collapsible-subsection-header', role: 'button', tabIndex: 0, "aria-expanded": open, onClick: toggle, onKeyDown: onKeyDown, children: [(0, jsx_runtime_1.jsx)("span", { "aria-hidden": 'true', className: `ai-collapsible-subsection-chevron ${(0, browser_1.codicon)(open ? 'chevron-down' : 'chevron-right')}` }), (0, jsx_runtime_1.jsx)("span", { children: title }), (0, jsx_runtime_1.jsx)("span", { className: 'ai-collapsible-subsection-count', children: count })] }), open && children] });
+};
+const AgentDetailToggles = ({ enabled, showInChat, showInChatVisible, onToggleEnabled, onToggleShowInChat }) => ((0, jsx_runtime_1.jsxs)("div", { className: 'agent-toggles', children: [(0, jsx_runtime_1.jsxs)("div", { className: 'agent-enable-toggle', title: core_1.nls.localize('theia/ai/core/agentConfiguration/enableAgent', 'Enable Agent'), children: [(0, jsx_runtime_1.jsx)("span", { className: 'toggle-label', children: core_1.nls.localize('theia/ai/core/agentConfiguration/enableAgent', 'Enable Agent') }), (0, jsx_runtime_1.jsx)(ai_configuration_controls_1.AiToggleSwitch, { checked: enabled, ariaLabel: core_1.nls.localize('theia/ai/core/agentConfiguration/enableAgent', 'Enable Agent'), onChange: onToggleEnabled })] }), showInChatVisible && (0, jsx_runtime_1.jsxs)("div", { className: `agent-enable-toggle${enabled ? '' : ' disabled'}`, title: core_1.nls.localize('theia/ai/core/agentConfiguration/showInChat', 'Show in Chat'), children: [(0, jsx_runtime_1.jsx)("span", { className: 'toggle-label', children: core_1.nls.localize('theia/ai/core/agentConfiguration/showInChat', 'Show in Chat') }), (0, jsx_runtime_1.jsx)(ai_configuration_controls_1.AiToggleSwitch, { checked: showInChat, disabled: !enabled, ariaLabel: core_1.nls.localize('theia/ai/core/agentConfiguration/showInChat', 'Show in Chat'), onChange: onToggleShowInChat })] })] }));
+//# sourceMappingURL=agent-detail-view.js.map

package/lib/browser/ai-configuration/categories/agent-detail-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detail-view.js","sourceRoot":"","sources":["../../../../src/browser/ai-configuration/categories/agent-detail-view.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,78 @@
+import { AgentService, AISettingsService, AIVariableService, CustomAgentsLocation, FrontendLanguageModelRegistry, LanguageModel, PromptFragmentCustomizationService, PromptService, ToolInvocationRegistry } from '@theia/ai-core/lib/common';
+import { LanguageModelAlias, LanguageModelAliasRegistry } from '@theia/ai-core/lib/common/language-model-alias';
+import { CommandService, DisposableCollection, Emitter, Event, ILogger, MessageService, URI } from '@theia/core';
+import { QuickInputService } from '@theia/core/lib/browser';
+import { SelectOption } from '@theia/core/lib/browser/widgets/select-component';
+import * as React from '@theia/core/shared/react';
+import { AiConfigurationCategory, AiConfigurationRenderContext, AiConfigurationSearchItem, AiConfigurationSearchProvider, AiConfigurationTreeItem } from '@theia/ai-core-ui/lib/browser/ai-configuration/ai-configuration-category';
+import { CollectionCategoryRenderer, AiConfigurationAddDescriptor } from '@theia/ai-core-ui/lib/browser/ai-configuration/renderers/collection-category-renderer';
+import { AiSettingsRowService } from '@theia/ai-core-ui/lib/browser/ai-configuration/components/ai-settings-row-service';
+import { AgentDetailServices } from './agent-detail-model';
+/** A candidate location for creating a new custom agent: its scope directory and `agents/` folder. */
+interface CustomAgentScopeOption {
+    scopeDir: URI;
+    agentsDir: URI;
+}
+/**
+ * The Agents category: a `collection` contributed onto the shared primitives.
+ * Owns the agent-related service logic (previously in `AIAgentConfigurationWidget`)
+ * and delegates the per-item detail to {@link AgentDetailView}.
+ */
+export declare class AgentsConfigurationCategory extends CollectionCategoryRenderer implements AiConfigurationCategory, AiConfigurationSearchProvider {
+    readonly id = "agents";
+    readonly label: string;
+    readonly description: string;
+    readonly iconClass: string;
+    readonly order = 400;
+    readonly kind: "collection";
+    protected readonly agentService: AgentService;
+    protected readonly languageModelRegistry: FrontendLanguageModelRegistry;
+    protected readonly promptFragmentCustomizationService: PromptFragmentCustomizationService;
+    protected readonly languageModelAliasRegistry: LanguageModelAliasRegistry;
+    protected readonly aiSettingsService: AISettingsService;
+    protected readonly variableService: AIVariableService;
+    protected readonly promptService: PromptService;
+    protected readonly quickInputService: QuickInputService;
+    protected readonly messageService: MessageService;
+    protected readonly settingsRowService: AiSettingsRowService;
+    protected readonly toolInvocationRegistry: ToolInvocationRegistry;
+    protected readonly commandService: CommandService;
+    protected readonly logger: ILogger;
+    protected readonly onDidChangeEmitter: Emitter<void>;
+    readonly onDidChange: Event<void>;
+    protected readonly toDispose: DisposableCollection;
+    /** Category-wide caches consumed by the item detail; refreshed on the corresponding service events. */
+    protected languageModels: LanguageModel[] | undefined;
+    protected languageModelAliases: LanguageModelAlias[];
+    /** Bumped on every upstream change so the item-detail view re-runs its async load. */
+    protected revision: number;
+    get renderer(): this;
+    protected get overviewListTitle(): string;
+    getOwnedPreferenceIds(): string[];
+    get search(): AiConfigurationSearchProvider;
+    protected init(): void;
+    protected fireChange(): void;
+    dispose(): void;
+    protected get categoryId(): string;
+    getTreeChildren(): AiConfigurationTreeItem[];
+    protected renderCategorySettings(ctx: AiConfigurationRenderContext): React.ReactNode;
+    protected getChatAgentOptions(): SelectOption[];
+    protected getNotificationTypeOptions(): SelectOption[];
+    getAddAction(ctx: AiConfigurationRenderContext): AiConfigurationAddDescriptor;
+    protected getEmptyMessage(): string;
+    protected renderItemHeader(): React.ReactNode;
+    protected renderItemSections(item: AiConfigurationTreeItem, ctx: AiConfigurationRenderContext): React.ReactNode;
+    protected get detailServices(): AgentDetailServices;
+    getSearchItems(): AiConfigurationSearchItem[];
+    /**
+     * Selects the candidate creation locations from the reported agent locations. Only `agents/`
+     * directories are considered (legacy `customAgents.yml` entries exist for discovery only). A
+     * scope is offered when it already contains an `agents/` folder; the preferred scope (the first
+     * one, i.e. `.agents`) is always kept so a fresh workspace defaults to `.agents` without
+     * surfacing empty fallback folders such as `.prompts`.
+     */
+    protected selectAgentScopeOptions(locations: CustomAgentsLocation[]): CustomAgentScopeOption[];
+    protected addCustomAgent(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=agents-configuration-category.d.ts.map

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

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

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

@@ -0,0 +1,352 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsConfigurationCategory = void 0;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("@theia/core/shared/react/jsx-runtime");
+// *****************************************************************************
+// 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
+// *****************************************************************************
+const common_1 = require("@theia/ai-core/lib/common");
+const agent_preferences_1 = require("@theia/ai-core/lib/common/agent-preferences");
+const language_model_alias_1 = require("@theia/ai-core/lib/common/language-model-alias");
+const ai_chat_preferences_1 = require("@theia/ai-chat/lib/common/ai-chat-preferences");
+const common_2 = require("@theia/ai-chat/lib/common");
+const core_1 = require("@theia/core");
+const browser_1 = require("@theia/core/lib/browser");
+const inversify_1 = require("@theia/core/shared/inversify");
+const ai_configuration_category_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/ai-configuration-category");
+const collection_category_renderer_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/renderers/collection-category-renderer");
+const ai_configuration_primitives_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/components/ai-configuration-primitives");
+const ai_settings_row_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/components/ai-settings-row");
+const ai_settings_row_service_1 = require("@theia/ai-core-ui/lib/browser/ai-configuration/components/ai-settings-row-service");
+const ai_ide_preferences_1 = require("../../../common/ai-ide-preferences");
+const agent_detail_view_1 = require("./agent-detail-view");
+const prompt_snippets_configuration_category_1 = require("./prompt-snippets-configuration-category");
+const agent_icon_1 = require("../agent-icon");
+/**
+ * The Agents category: a `collection` contributed onto the shared primitives.
+ * Owns the agent-related service logic (previously in `AIAgentConfigurationWidget`)
+ * and delegates the per-item detail to {@link AgentDetailView}.
+ */
+let AgentsConfigurationCategory = class AgentsConfigurationCategory extends collection_category_renderer_1.CollectionCategoryRenderer {
+    constructor() {
+        super(...arguments);
+        this.id = ai_configuration_category_1.AiConfigurationCategoryId.AGENTS;
+        this.label = core_1.nls.localizeByDefault('Agents');
+        this.description = core_1.nls.localize('theia/ai/ide/agentsConfiguration/description', 'The AI agents available in the IDE. Open an agent to configure its prompts, model and capabilities.');
+        this.iconClass = (0, browser_1.codicon)('copilot');
+        this.order = ai_configuration_category_1.AiConfigurationCategoryOrder.AGENTS;
+        this.kind = 'collection';
+        this.onDidChangeEmitter = new core_1.Emitter();
+        this.onDidChange = this.onDidChangeEmitter.event;
+        this.toDispose = new core_1.DisposableCollection(this.onDidChangeEmitter);
+        this.languageModelAliases = [];
+        /** Bumped on every upstream change so the item-detail view re-runs its async load. */
+        this.revision = 0;
+    }
+    get renderer() {
+        return this;
+    }
+    get overviewListTitle() {
+        return core_1.nls.localizeByDefault('Agents');
+    }
+    getOwnedPreferenceIds() {
+        return [
+            ai_chat_preferences_1.DEFAULT_CHAT_AGENT_PREF,
+            common_1.PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE,
+            ai_ide_preferences_1.PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST,
+            ai_ide_preferences_1.PREFERENCE_NAME_AGENT_MODE_ENABLED,
+            // Per-agent settings storage; edited through the agent detail pages, not as a raw row.
+            agent_preferences_1.AGENT_SETTINGS_PREF
+        ];
+    }
+    get search() {
+        return this;
+    }
+    init() {
+        this.languageModelRegistry.getLanguageModels().then(models => {
+            this.languageModels = models ?? [];
+            this.fireChange();
+        });
+        this.languageModelAliasRegistry.ready.then(() => {
+            this.languageModelAliases = this.languageModelAliasRegistry.getAliases();
+            this.toDispose.push(this.languageModelAliasRegistry.onDidChange(() => {
+                this.languageModelAliases = this.languageModelAliasRegistry.getAliases();
+                this.fireChange();
+            }));
+            this.fireChange();
+        });
+        this.toDispose.pushAll([
+            this.languageModelRegistry.onChange(({ models }) => {
+                this.languageModels = models;
+                this.fireChange();
+            }),
+            this.agentService.onDidChangeAgents(() => this.fireChange()),
+            this.promptService.onPromptsChange(() => this.fireChange()),
+            this.promptFragmentCustomizationService.onDidChangePromptFragmentCustomization(() => this.fireChange()),
+            this.aiSettingsService.onDidChange(() => this.fireChange())
+        ]);
+    }
+    fireChange() {
+        this.revision++;
+        this.onDidChangeEmitter.fire();
+    }
+    dispose() {
+        this.toDispose.dispose();
+    }
+    get categoryId() {
+        return this.id;
+    }
+    getTreeChildren() {
+        return this.agentService.getAllAgents().map(agent => {
+            const enabled = this.agentService.isEnabled(agent.id);
+            return {
+                id: agent.id,
+                label: agent.name,
+                iconClass: (0, agent_icon_1.getAgentIconClass)(agent),
+                description: agent.description,
+                status: {
+                    kind: enabled ? 'on' : 'off',
+                    label: enabled ? core_1.nls.localizeByDefault('Enabled') : core_1.nls.localizeByDefault('Disabled')
+                }
+            };
+        });
+    }
+    renderCategorySettings(ctx) {
+        return (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(ai_configuration_primitives_1.AiConfigurationSection, { title: core_1.nls.localize('theia/ai/ide/agentConfiguration/behavior', 'Behavior'), children: [(0, jsx_runtime_1.jsx)(ai_settings_row_1.AiSettingsRow, { service: this.settingsRowService, preferenceId: ai_ide_preferences_1.PREFERENCE_NAME_AGENT_MODE_ENABLED, label: core_1.nls.localize('theia/ai/ide/agentConfiguration/agentMode', 'Agent mode for Coder'), scope: ctx.scope, control: { type: 'boolean' }, onDidChange: ctx.update }), (0, jsx_runtime_1.jsx)(ai_settings_row_1.AiSettingsRow, { service: this.settingsRowService, preferenceId: ai_ide_preferences_1.PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST, label: core_1.nls.localize('theia/ai/ide/agentConfiguration/orchestratorExclude', 'Agents hidden from the orchestrator'), scope: ctx.scope, control: { type: 'array', placeholder: core_1.nls.localize('theia/ai/ide/agentConfiguration/orchestratorExcludePlaceholder', 'Add agent ID...') }, onDidChange: ctx.update })] }), (0, jsx_runtime_1.jsxs)(ai_configuration_primitives_1.AiConfigurationSection, { title: core_1.nls.localize('theia/ai/ide/agentConfiguration/defaults', 'Defaults'), children: [(0, jsx_runtime_1.jsx)(ai_settings_row_1.AiSettingsRow, { service: this.settingsRowService, preferenceId: ai_chat_preferences_1.DEFAULT_CHAT_AGENT_PREF, label: core_1.nls.localize('theia/ai/ide/agentConfiguration/defaultChatAgent', 'Default Chat Agent'), scope: ctx.scope, control: { type: 'select', options: this.getChatAgentOptions() }, onDidChange: ctx.update }), (0, jsx_runtime_1.jsx)(ai_settings_row_1.AiSettingsRow, { service: this.settingsRowService, preferenceId: common_1.PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE, scope: ctx.scope, control: { type: 'select', options: this.getNotificationTypeOptions() }, onDidChange: ctx.update })] })] });
+    }
+    getChatAgentOptions() {
+        // Leading empty entry so the (optional) preference can show and select its unset state, where Theia's
+        // built-in defaults apply. Without it the select would fall back to showing the first agent when unset.
+        const none = {
+            value: '',
+            label: core_1.nls.localize('theia/ai/ide/agentConfiguration/defaultChatAgentNone', 'Built-in default'),
+            description: core_1.nls.localize('theia/ai/ide/agentConfiguration/defaultChatAgentNoneDescription', 'No explicit default; Theia picks the default Chat Agent.')
+        };
+        return [none, ...this.agentService.getAllAgents()
+                .filter(agent => (0, common_2.isChatAgent)(agent))
+                .map(agent => ({ value: agent.id, label: agent.name }))];
+    }
+    getNotificationTypeOptions() {
+        return common_1.NOTIFICATION_TYPES.map(type => ({ value: type, label: common_1.NOTIFICATION_TYPE_LABELS[type] }));
+    }
+    getAddAction(ctx) {
+        return {
+            label: core_1.nls.localize('theia/ai/core/agentConfiguration/addCustomAgent', 'Add Custom Agent'),
+            iconClass: (0, browser_1.codicon)('add'),
+            run: () => this.addCustomAgent()
+        };
+    }
+    getEmptyMessage() {
+        return core_1.nls.localize('theia/ai/ide/agentConfiguration/noAgents', 'No agents are available.');
+    }
+    renderItemHeader() {
+        // The detail view renders its own header (with the enable / show-in-chat toggles).
+        return undefined;
+    }
+    renderItemSections(item, ctx) {
+        const agent = this.agentService.getAllAgents().find(candidate => candidate.id === item.id);
+        if (!agent) {
+            return undefined;
+        }
+        return (0, jsx_runtime_1.jsx)(agent_detail_view_1.AgentDetailView, { agent: agent, services: this.detailServices, languageModels: this.languageModels, languageModelAliases: this.languageModelAliases, revision: this.revision, onOpenPromptSnippet: fragmentId => ctx.navigate(prompt_snippets_configuration_category_1.PromptSnippetsConfiguration.selectionFor(fragmentId)), onOpenTool: toolName => ctx.navigate(ai_configuration_category_1.AiConfigurationTools.selectionFor(toolName)) });
+    }
+    get detailServices() {
+        return {
+            agentService: this.agentService,
+            aiSettingsService: this.aiSettingsService,
+            variableService: this.variableService,
+            promptService: this.promptService,
+            languageModelRegistry: this.languageModelRegistry,
+            toolInvocationRegistry: this.toolInvocationRegistry,
+            commandService: this.commandService,
+            settingsRowService: this.settingsRowService,
+            logger: this.logger
+        };
+    }
+    getSearchItems() {
+        const settingLabel = core_1.nls.localizeByDefault('Setting');
+        const items = [{
+                label: core_1.nls.localize('theia/ai/ide/agentConfiguration/agentMode', 'Agent mode for Coder'),
+                typeLabel: settingLabel,
+                categoryId: this.id,
+                target: { categoryId: this.id },
+                keywords: ai_ide_preferences_1.PREFERENCE_NAME_AGENT_MODE_ENABLED
+            }, {
+                label: core_1.nls.localize('theia/ai/ide/agentConfiguration/orchestratorExclude', 'Agents hidden from the orchestrator'),
+                typeLabel: settingLabel,
+                categoryId: this.id,
+                target: { categoryId: this.id, highlight: { rowId: ai_ide_preferences_1.PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST } },
+                keywords: ai_ide_preferences_1.PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST
+            }, {
+                label: core_1.nls.localize('theia/ai/ide/agentConfiguration/defaultChatAgent', 'Default Chat Agent'),
+                typeLabel: settingLabel,
+                categoryId: this.id,
+                target: { categoryId: this.id, highlight: { rowId: ai_chat_preferences_1.DEFAULT_CHAT_AGENT_PREF } },
+                keywords: ai_chat_preferences_1.DEFAULT_CHAT_AGENT_PREF
+            }, {
+                label: core_1.nls.localize('theia/ai/core/defaultNotification/title', 'Default Notification Type'),
+                typeLabel: settingLabel,
+                categoryId: this.id,
+                target: { categoryId: this.id, highlight: { rowId: common_1.PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE } },
+                keywords: common_1.PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE
+            }];
+        const agentTypeLabel = core_1.nls.localizeByDefault('Agent');
+        for (const agent of this.agentService.getAllAgents()) {
+            items.push({
+                label: agent.name,
+                typeLabel: agentTypeLabel,
+                categoryId: this.id,
+                target: { categoryId: this.id, itemId: agent.id },
+                keywords: `${agent.id} ${agent.description ?? ''}`
+            });
+        }
+        return items;
+    }
+    /**
+     * Selects the candidate creation locations from the reported agent locations. Only `agents/`
+     * directories are considered (legacy `customAgents.yml` entries exist for discovery only). A
+     * scope is offered when it already contains an `agents/` folder; the preferred scope (the first
+     * one, i.e. `.agents`) is always kept so a fresh workspace defaults to `.agents` without
+     * surfacing empty fallback folders such as `.prompts`.
+     */
+    selectAgentScopeOptions(locations) {
+        return locations
+            .filter(location => location.kind === 'agents-dir')
+            .filter((location, index) => index === 0 || location.exists)
+            .map(location => ({ scopeDir: location.uri.parent, agentsDir: location.uri }));
+    }
+    async addCustomAgent() {
+        const allLocations = await this.promptFragmentCustomizationService.getCustomAgentsLocations();
+        const scopeOptions = this.selectAgentScopeOptions(allLocations);
+        if (scopeOptions.length === 0) {
+            this.messageService.warn(core_1.nls.localize('theia/ai/ide/agentConfiguration/newAgent/noLocation', 'Cannot create a custom agent: no prompt-templates location is configured. Set a global or workspace prompt-templates folder and try again.'));
+            return;
+        }
+        let chosen = scopeOptions[0];
+        if (scopeOptions.length > 1) {
+            chosen = await new Promise((resolve, reject) => {
+                const quickPick = this.quickInputService.createQuickPick();
+                quickPick.title = core_1.nls.localize('theia/ai/ide/agentConfiguration/customAgentLocationQuickPick/title', 'Select location for the new custom agent');
+                quickPick.placeholder = core_1.nls.localize('theia/ai/ide/agentConfiguration/customAgentLocationQuickPick/placeholder', 'Choose where to create the agents/<id>/agent.md file');
+                quickPick.items = scopeOptions.map(opt => ({
+                    label: opt.scopeDir.path.toString(),
+                    description: opt.agentsDir.path.toString(),
+                    option: opt
+                }));
+                quickPick.onDidAccept(() => {
+                    const selected = quickPick.selectedItems[0];
+                    quickPick.dispose();
+                    if (selected?.option) {
+                        resolve(selected.option);
+                    }
+                    else {
+                        reject(new Error('No location selected'));
+                    }
+                });
+                quickPick.onDidHide(() => reject(new Error('Selection cancelled')));
+                quickPick.show();
+            }).catch(() => undefined) ?? scopeOptions[0];
+        }
+        const id = await this.quickInputService.input({
+            title: core_1.nls.localize('theia/ai/ide/agentConfiguration/newAgent/idTitle', 'New custom agent'),
+            prompt: core_1.nls.localize('theia/ai/ide/agentConfiguration/newAgent/idPrompt', 'Agent id (used as folder name under agents/)'),
+            placeHolder: 'my-agent',
+            validateInput: async (value) => /^[A-Za-z0-9._-]+$/.test(value)
+                ? undefined
+                : core_1.nls.localize('theia/ai/ide/agentConfiguration/newAgent/idInvalid', 'Use letters, digits, dash, underscore, or dot only.')
+        });
+        if (!id) {
+            return;
+        }
+        try {
+            await this.promptFragmentCustomizationService.createCustomAgentFile(chosen.scopeDir, {
+                id,
+                name: id,
+                description: core_1.nls.localize('theia/ai/ide/agentConfiguration/newAgent/defaultDescription', 'Custom agent. Edit this description in agent.md.'),
+                prompt: core_1.nls.localize('theia/ai/ide/agentConfiguration/newAgent/defaultPrompt', 'You are a helpful agent. Adjust this prompt to fit your needs.'),
+                defaultLLM: 'default/universal',
+                showInChat: true
+            });
+        }
+        catch (error) {
+            this.messageService.error(core_1.nls.localize('theia/ai/ide/agentConfiguration/newAgent/createFailed', 'Could not create the custom agent "{0}": {1}', id, error instanceof Error ? error.message : String(error)));
+        }
+    }
+};
+exports.AgentsConfigurationCategory = AgentsConfigurationCategory;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.AgentService),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "agentService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.LanguageModelRegistry),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "languageModelRegistry", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.PromptFragmentCustomizationService),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "promptFragmentCustomizationService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(language_model_alias_1.LanguageModelAliasRegistry),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "languageModelAliasRegistry", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.AISettingsService),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "aiSettingsService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.AIVariableService),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "variableService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.PromptService),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "promptService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(browser_1.QuickInputService),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "quickInputService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.MessageService),
+    tslib_1.__metadata("design:type", core_1.MessageService)
+], AgentsConfigurationCategory.prototype, "messageService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(ai_settings_row_service_1.AiSettingsRowService),
+    tslib_1.__metadata("design:type", ai_settings_row_service_1.AiSettingsRowService)
+], AgentsConfigurationCategory.prototype, "settingsRowService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.ToolInvocationRegistry),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "toolInvocationRegistry", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.CommandService),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "commandService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ILogger),
+    (0, inversify_1.named)('ai-ide:AgentsConfigurationCategory'),
+    tslib_1.__metadata("design:type", Object)
+], AgentsConfigurationCategory.prototype, "logger", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.postConstruct)(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", void 0)
+], AgentsConfigurationCategory.prototype, "init", null);
+exports.AgentsConfigurationCategory = AgentsConfigurationCategory = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], AgentsConfigurationCategory);
+//# sourceMappingURL=agents-configuration-category.js.map