@theia/ai-ide 1.66.0-next.73 → 1.66.0

package/lib/common/project-info-prompt-template.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectInfoSystemVariants = exports.projectInfoTemplateVariants = exports.PROJECT_INFO_TEMPLATE_PROMPT_ID = exports.PROJECT_INFO_SYSTEM_PROMPT_TEMPLATE_ID = void 0;
+const workspace_functions_1 = require("./workspace-functions");
+const context_variables_1 = require("./context-variables");
+const context_functions_1 = require("./context-functions");
+const file_changeset_function_ids_1 = require("./file-changeset-function-ids");
+exports.PROJECT_INFO_SYSTEM_PROMPT_TEMPLATE_ID = 'project-info-system';
+exports.PROJECT_INFO_TEMPLATE_PROMPT_ID = 'project-info-template';
+exports.projectInfoTemplateVariants = {
+    id: exports.PROJECT_INFO_TEMPLATE_PROMPT_ID,
+    defaultVariant: {
+        id: 'project-info-template-default',
+        template: `## Project Info Template Structure
+
+### Architecture Overview
+[Brief description of what the project does, Key architectural decisions, patterns, and structure.]
+
+### Key Technologies
+[List of main technologies, frameworks, libraries]
+
+### Essential Development Patterns
+Examples for key patterns (refer via relative file paths)
+
+### File Structure  
+[Important directories/packages and their contents]
+
+### Build & Development
+[How to build and run the project.]
+
+### Testing
+[What kind of tests exist, test organization and test patterns. Examples for different types of tests (as relative file paths)]
+
+### Coding Guidelines
+[Coding standards, conventions, practices. Examples for key practices (as relative file paths), rules for imports, indentation]
+
+### Additional Notes
+[Any other important information for agents to understand the project and write code for it. Important files with more information (as relative file paths)]
+\`\`\`
+`
+    }
+};
+exports.projectInfoSystemVariants = {
+    id: exports.PROJECT_INFO_SYSTEM_PROMPT_TEMPLATE_ID,
+    defaultVariant: {
+        id: 'project-info-system-default',
+        template: `{{!-- This prompt is licensed under the MIT License (https://opensource.org/license/mit).
+Made improvements or adaptations to this prompt template? We'd love for you to share it with the community! Contribute back here:
+https://github.com/eclipse-theia/theia/discussions/new?category=prompt-template-contribution --}}
+# Instructions
+
+You are the ProjectInfo agent, an AI assistant specialized in managing project information files. Your role is to help users create, update, 
+and maintain the \`.prompts/project-info.prompttemplate\` file which provides contextual information about the project to other AI agents.
+
+## Project Info Guidelines
+The project info is an artifact that will be handed over to agents to understand the current workspace, project and codebase.
+Do not include obvious instructions, generic information, generic development practices or things that can be very easily discovered.
+Focus on non-obvious and project-specific facts as well as specific guidelines and patterns.
+Try to keep the project info minimal and avoid duplicates.
+
+## Your Capabilities
+
+### Initially Create Project Info
+For initial project info creation, start by determining the user's preferred working mode:
+
+**Step 1: Define mode of working**
+Ask the user about the preferred working mode:
+
+1. "Auto-exploration - Agent explores and creates an initial suggestion",
+2. "Manual - User provides all necessary input with your guidance"
+
+IMPORTANT: Remember the chosen mode and stick to it until the user requests otherwise!
+
+- In automatic mode, create an initial version of the project info yourself by exploring the workspace
+- In manual mode, guide the user section by section and ask for additional information.
+  Whenever you ask a question to the user, offer the option that you answer the question for them.
+
+**Step 2: Final tasks**
+After completing all sections or if you feel the user is done, offer the user to do an automatic refinement:
+"Would you like me to review and finalize the project information?",
+- In this final refinement, particularly focus on relevance and potential duplications and the "Project Info Guidelines"
+- Then, ask for final user review. Tell the user to provide any generic feedback and offer to incorporate it for them.
+- Finally remind them to accept the final version in the change set
+
+### Complete Project Info
+- If a project info is incomplete, offer the user to complete it
+
+### Update Project Info  
+- Modify existing project info based on user requirements
+- Do not use a specific workflow for this
+
+## Workspace Analysis Guidelines
+
+**Auto-Discovery File Patterns**
+When auto-discovering project information or exploring the workspace structure, ALWAYS prioritize examining these file patterns that commonly contain agent instructions 
+and project documentation:
+- .github/copilot-instructions.md
+- AGENT.md
+- AGENTS.md
+- CLAUDE.md
+- .cursorrules
+- .windsurfrules
+- .clinerules
+- .cursor
+- rules/**
+- .windsurf/rules/**
+- .clinerules/**
+- README.md
+- .md files in the root level if they contain documentation
+
+Use the **~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}}** function with these patterns to discover relevant configuration and documentation files.
+
+## Context Retrieval
+Use the following functions to interact with the workspace files when needed:
+- **~{${workspace_functions_1.GET_WORKSPACE_FILE_LIST_FUNCTION_ID}}**: List files and directories
+- **~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}**: Get content of specific files
+- **~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}}**: Find files by glob patterns like '**/*.json'
+- **~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FUNCTION_ID}}**: Search file contents
+
+Navigate step-by-step and confirm paths. Use **~{${context_functions_1.UPDATE_CONTEXT_FILES_FUNCTION_ID}}** to remember important files for later reference.
+
+## File Modification - SUGGEST ONLY
+Use these functions liberally to suggest file changes. All changes require user review and approval, so the user can reject them if needed.
+
+- **~{${file_changeset_function_ids_1.SUGGEST_FILE_CONTENT_ID}}**: Propose complete file content (for creating new templates or complete rewrites)
+- **~{${file_changeset_function_ids_1.SUGGEST_FILE_REPLACEMENTS_ID}}**: Propose targeted replacements of specific text sections
+- **~{${file_changeset_function_ids_1.GET_PROPOSED_CHANGES_ID}}**: View current proposed changes before making additional ones
+- **~{${file_changeset_function_ids_1.CLEAR_FILE_CHANGES_ID}}**: Clear all pending changes for a file to start fresh
+
+{{prompt:${exports.PROJECT_INFO_TEMPLATE_PROMPT_ID}}}
+
+## Additional Context
+{{${context_variables_1.CONTEXT_FILES_VARIABLE_ID}}}
+
+## Workflow Guidelines
+
+When creating project info for the first time:
+1. **Always start by asking about the user's preferred mode** (auto-exploration or manual) and stick to it
+2. **After initial suggestions or provided content**: Always ask for refinement and additional information
+
+Remember: Proactively help users maintain accurate project information for better AI assistance.
+`
+    }
+};
+//# sourceMappingURL=project-info-prompt-template.js.map

package/lib/common/project-info-prompt-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-info-prompt-template.js","sourceRoot":"","sources":["../../src/common/project-info-prompt-template.ts"],"names":[],"mappings":";;;AAWA,+DAG+B;AAC/B,2DAAgE;AAChE,2DAAuE;AACvE,+EAKuC;AAE1B,QAAA,sCAAsC,GAAG,qBAAqB,CAAC;AAC/D,QAAA,+BAA+B,GAAG,uBAAuB,CAAC;AAE1D,QAAA,2BAA2B,GAAqB;IACzD,EAAE,EAAE,uCAA+B;IACnC,cAAc,EAAE;QACZ,EAAE,EAAE,+BAA+B;QACnC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjB;KACI;CACJ,CAAC;AAEW,QAAA,yBAAyB,GAAqB;IACvD,EAAE,EAAE,8CAAsC;IAC1C,cAAc,EAAE;QACZ,EAAE,EAAE,6BAA6B;QACjC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgEJ,uDAAiC;;;;QAIvC,yDAAmC;QACnC,8CAAwB;QACxB,uDAAiC;QACjC,qDAA+B;;mDAEY,oDAAgC;;;;;QAK3E,qDAAuB;QACvB,0DAA4B;QAC5B,qDAAuB;QACvB,mDAAqB;;WAElB,uCAA+B;;;IAGtC,6CAAyB;;;;;;;;;CAS5B;KACI;CACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/ai-ide",
-  "version": "1.66.0-next.73+6d82794da",
+  "version": "1.66.0",
   "description": "AI IDE Agents Extension",
   "license": "EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0",
   "repository": {
@@ -15,23 +15,23 @@
     "theia-extension"
   ],
   "dependencies": {
-    "@theia/ai-chat": "1.66.0-next.73+6d82794da",
-    "@theia/ai-chat-ui": "1.66.0-next.73+6d82794da",
-    "@theia/ai-core": "1.66.0-next.73+6d82794da",
-    "@theia/ai-mcp": "1.66.0-next.73+6d82794da",
-    "@theia/core": "1.66.0-next.73+6d82794da",
-    "@theia/debug": "1.66.0-next.73+6d82794da",
-    "@theia/editor": "1.66.0-next.73+6d82794da",
-    "@theia/filesystem": "1.66.0-next.73+6d82794da",
-    "@theia/markers": "1.66.0-next.73+6d82794da",
-    "@theia/monaco": "1.66.0-next.73+6d82794da",
-    "@theia/navigator": "1.66.0-next.73+6d82794da",
-    "@theia/preferences": "1.66.0-next.73+6d82794da",
-    "@theia/scm": "1.66.0-next.73+6d82794da",
-    "@theia/search-in-workspace": "1.66.0-next.73+6d82794da",
-    "@theia/task": "1.66.0-next.73+6d82794da",
-    "@theia/terminal": "1.66.0-next.73+6d82794da",
-    "@theia/workspace": "1.66.0-next.73+6d82794da",
+    "@theia/ai-chat": "1.66.0",
+    "@theia/ai-chat-ui": "1.66.0",
+    "@theia/ai-core": "1.66.0",
+    "@theia/ai-mcp": "1.66.0",
+    "@theia/core": "1.66.0",
+    "@theia/debug": "1.66.0",
+    "@theia/editor": "1.66.0",
+    "@theia/filesystem": "1.66.0",
+    "@theia/markers": "1.66.0",
+    "@theia/monaco": "1.66.0",
+    "@theia/navigator": "1.66.0",
+    "@theia/preferences": "1.66.0",
+    "@theia/scm": "1.66.0",
+    "@theia/search-in-workspace": "1.66.0",
+    "@theia/task": "1.66.0",
+    "@theia/terminal": "1.66.0",
+    "@theia/workspace": "1.66.0",
     "date-fns": "^4.1.0",
     "ignore": "^6.0.0",
     "js-yaml": "^4.1.0",
@@ -43,8 +43,8 @@
     "access": "public"
   },
   "devDependencies": {
-    "@theia/cli": "1.66.0-next.73+6d82794da",
-    "@theia/test": "1.66.0-next.73+6d82794da"
+    "@theia/cli": "1.66.0",
+    "@theia/test": "1.66.0"
   },
   "theiaExtensions": [
     {
@@ -68,5 +68,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "6d82794da24e16f75d70eaac3a4178a29e822e82"
+  "gitHead": "dc03613006449e67b722a8c2e75c9a62585d5da8"
 }

package/src/browser/ai-terminal-functions.ts

@@ -0,0 +1,105 @@
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { MutableChatRequestModel } from '@theia/ai-chat';
+import { ToolProvider, ToolRequest } from '@theia/ai-core';
+import { inject, injectable } from '@theia/core/shared/inversify';
+import { TerminalService } from '@theia/terminal/lib/browser/base/terminal-service';
+import { SUGGEST_TERMINAL_COMMAND_ID } from '../common/ai-terminal-functions';
+import { WorkspaceService } from '@theia/workspace/lib/browser';
+import { TerminalWidget } from '@theia/terminal/lib/browser/base/terminal-widget';
+import { waitForEvent } from '@theia/core/lib/common/promise-util';
+import { ApplicationShell } from '@theia/core/lib/browser';
+
+@injectable()
+export class SuggestTerminalCommand implements ToolProvider {
+    static ID = SUGGEST_TERMINAL_COMMAND_ID;
+
+    @inject(TerminalService)
+    protected readonly terminalService: TerminalService;
+
+    @inject(WorkspaceService)
+    protected readonly workspaceService: WorkspaceService;
+
+    @inject(ApplicationShell)
+    protected readonly applicationShell: ApplicationShell;
+
+    getTool(): ToolRequest {
+        return {
+            id: SuggestTerminalCommand.ID,
+            name: SuggestTerminalCommand.ID,
+            description: `Proposes executing a command in the terminal.\n
+            This tool will automatically write the command into the terminal buffer.\n
+            Execution of the command is up to the user.`,
+            parameters: {
+                type: 'object',
+                properties: {
+                    command: {
+                        type: 'string',
+                        description: `The content of the command to write to the terminal buffer.\n
+                        ALWAYS provide the COMPLETE intended content of the command, without any truncation or omissions.\n
+                        You MUST include ALL parts of the command.`
+                    }
+                },
+                required: ['command']
+            },
+            handler: async (args: string, ctx: MutableChatRequestModel): Promise<string> => {
+                if (ctx?.response?.cancellationToken?.isCancellationRequested) {
+                    return JSON.stringify({ error: 'Operation cancelled by user' });
+                }
+                // Ensure that there is a workspace
+                let activeTerminal: TerminalWidget | undefined = this.terminalService.lastUsedTerminal;
+                if (!activeTerminal || activeTerminal.isDisposed) {
+                    try {
+                        activeTerminal = await this.terminalService.newTerminal({});
+                        this.terminalService.open(activeTerminal, { mode: 'activate' });
+                        await activeTerminal.start();
+                        // Wait until the terminal prompt is emitted
+                        await waitForEvent(activeTerminal.onOutput, 3000);
+                    } catch (error) {
+                        return JSON.stringify({ error: `Error executing tool 'suggestTerminalCommand': ${error}` });
+                    }
+                } else {
+                    this.terminalService.open(activeTerminal, { mode: 'activate' });
+                }
+                let command: string;
+                try {
+                    const { command: parsedCommand } = JSON.parse(args);
+                    command = parsedCommand;
+                } catch (error) {
+                    return JSON.stringify({ error: `Error parsing arguments for tool 'suggestTerminalCommand': ${error}` });
+                }
+                if (!this.isValidCommand(command)) {
+                    return JSON.stringify({ error: 'Error validating command generated by \'suggestTerminalCommand\'' });
+                };
+                // Clear the current input line by sending Ctrl+A (move to start) and Ctrl+K (delete to end)
+                activeTerminal.sendText('\x01\x0b');
+                activeTerminal.sendText(command);
+                return `Proposed executing the terminal command ${command}. The user will review and potentially execute the command.`;
+            }
+        };
+    }
+
+    protected isValidCommand(command: string): boolean {
+        // Command should not be empty and should not contain control characters
+        const CONTROL_CHAR_REGEX = /[\u0000-\u001F\u007F]/; // ASCII control range
+        if (!command || CONTROL_CHAR_REGEX.test(command)) {
+            return false;
+        }
+        return true;
+    }
+}
+

package/src/browser/frontend-module.ts

@@ -94,6 +94,8 @@ import { AIActivationService } from '@theia/ai-core/lib/browser';
 import { AIIdeActivationServiceImpl } from './ai-ide-activation-service';
 import { AiConfigurationPreferences } from '../common/ai-configuration-preferences';
 import { TaskContextAgent } from './task-context-agent';
+import { ProjectInfoAgent } from './project-info-agent';
+import { SuggestTerminalCommand } from './ai-terminal-functions';
 
 export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bind(PreferenceContribution).toConstantValue({ schema: aiIdePreferenceSchema });
@@ -113,6 +115,9 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
 
     bind(TaskContextAgent).toSelf().inSingletonScope();
     bind(Agent).toService(TaskContextAgent);
+    bind(ProjectInfoAgent).toSelf().inSingletonScope();
+    bind(Agent).toService(ProjectInfoAgent);
+    bind(ChatAgent).toService(ProjectInfoAgent);
 
     bind(OrchestratorChatAgent).toSelf().inSingletonScope();
     bind(Agent).toService(OrchestratorChatAgent);
@@ -263,4 +268,6 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
             createWidget: () => ctx.container.get(AIPromptFragmentsConfigurationWidget)
         }))
         .inSingletonScope();
+
+    bindToolProvider(SuggestTerminalCommand, bind);
 });

package/src/browser/project-info-agent.ts

@@ -0,0 +1,42 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+import { AbstractStreamParsingChatAgent } from '@theia/ai-chat';
+import { LanguageModelRequirement } from '@theia/ai-core';
+import { injectable } from '@theia/core/shared/inversify';
+import { projectInfoSystemVariants, projectInfoTemplateVariants } from '../common/project-info-prompt-template';
+import { nls } from '@theia/core';
+
+@injectable()
+export class ProjectInfoAgent extends AbstractStreamParsingChatAgent {
+
+    name = 'ProjectInfo';
+    id = 'ProjectInfo';
+    languageModelRequirements: LanguageModelRequirement[] = [{
+        purpose: 'chat',
+        identifier: 'default/code',
+    }];
+    protected defaultLanguageModelPurpose: string = 'chat';
+
+    override description = nls.localize('theia/ai/workspace/projectInfoAgent/description',
+        'An AI assistant for managing project information templates. This agent helps create, update, and review the .prompts/project-info.prompttemplate file which provides ' +
+        'context about your project to other AI agents. It can analyze your workspace to suggest project information or update existing templates based on your requirements.');
+
+    override tags: string[] = [...this.tags, 'Alpha'];
+
+    override prompts = [projectInfoSystemVariants, projectInfoTemplateVariants];
+    protected override systemPromptId: string | undefined = projectInfoSystemVariants.id;
+
+}

package/src/browser/workspace-functions.ts

@@ -145,7 +145,7 @@ export class GetWorkspaceDirectoryStructure implements ToolProvider {
                 'This structure excludes specific directories, such as node_modules and hidden files, ensuring paths are within workspace boundaries.',
             parameters: {
                 type: 'object',
-                properties: {}
+                properties: {},
             },
             handler: (_: string, ctx: MutableChatRequestModel) => {
                 const cancellationToken = ctx.response.cancellationToken;

package/src/common/ai-ide-preferences.ts

@@ -19,6 +19,7 @@ import { nls, PreferenceSchema } from '@theia/core';
 
 // We reuse the context key for the preference name
 export const PREFERENCE_NAME_ENABLE_AI = 'ai-features.AiEnable.enableAI';
+export const PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST = 'ai-features.orchestrator.excludedAgents';
 
 export const aiIdePreferenceSchema: PreferenceSchema = {
     properties: {
@@ -37,6 +38,17 @@ export const aiIdePreferenceSchema: PreferenceSchema = {
             LLM provider below. Also see [the documentation](https://theia-ide.org/docs/user_ai/)**.'),
             type: 'boolean',
             default: false,
+        },
+        [PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST]: {
+            title: AI_CORE_PREFERENCES_TITLE,
+            markdownDescription: nls.localize('theia/ai/ide/orchestrator/excludedAgents/mdDescription',
+                'List of agent IDs that the orchestrator is not allowed to delegate to. ' +
+                'These agents will not be visible to the orchestrator when selecting an agent to handle a request.'),
+            type: 'array',
+            items: {
+                type: 'string'
+            },
+            default: ['ClaudeCode'],
         }
     }
 };

package/src/common/ai-terminal-functions.ts

@@ -0,0 +1,18 @@
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+export const SUGGEST_TERMINAL_COMMAND_ID = 'suggestTerminalCommand';
+

package/src/common/orchestrator-chat-agent.ts

@@ -14,14 +14,15 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 
-import { getJsonOfText, getTextOfResponse, LanguageModel, LanguageModelMessage, LanguageModelRequirement, LanguageModelResponse } from '@theia/ai-core';
+import { AIVariableContext, getJsonOfText, getTextOfResponse, LanguageModel, LanguageModelMessage, LanguageModelRequirement, LanguageModelResponse } from '@theia/ai-core';
 import { inject, injectable } from '@theia/core/shared/inversify';
 import { ChatAgentService } from '@theia/ai-chat/lib/common/chat-agent-service';
 import { ChatToolRequest } from '@theia/ai-chat/lib/common/chat-tool-request-service';
-import { AbstractStreamParsingChatAgent } from '@theia/ai-chat/lib/common/chat-agents';
+import { AbstractStreamParsingChatAgent, SystemMessageDescription } from '@theia/ai-chat/lib/common/chat-agents';
 import { MutableChatRequestModel, InformationalChatResponseContentImpl } from '@theia/ai-chat/lib/common/chat-model';
-import { generateUuid, nls } from '@theia/core';
+import { generateUuid, nls, PreferenceService } from '@theia/core';
 import { orchestratorTemplate } from './orchestrator-prompt-template';
+import { PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST } from './ai-ide-preferences';
 
 export const OrchestratorChatAgentId = 'Orchestrator';
 const OrchestratorRequestIdKey = 'orchestratorRequestIdKey';
@@ -41,6 +42,12 @@ export class OrchestratorChatAgent extends AbstractStreamParsingChatAgent {
         'This agent analyzes the user request against the description of all available chat agents and selects the best fitting agent to answer the request \
     (by using AI).The user\'s request will be directly delegated to the selected agent without further confirmation.');
     override iconClass: string = 'codicon codicon-symbol-boolean';
+    override agentSpecificVariables = [{
+        name: 'availableChatAgents',
+        description: nls.localize('theia/ai/chat/orchestrator/vars/availableChatAgents/description',
+            'The list of chat agents that the orchestrator can delegate to, excluding agents specified in the exclusion list preference.'),
+        usedInPrompt: true
+    }];
 
     protected override systemPromptId: string = orchestratorTemplate.id;
 
@@ -49,6 +56,41 @@ export class OrchestratorChatAgent extends AbstractStreamParsingChatAgent {
     @inject(ChatAgentService)
     protected chatAgentService: ChatAgentService;
 
+    @inject(PreferenceService)
+    protected preferenceService: PreferenceService;
+
+    protected override async getSystemMessageDescription(context: AIVariableContext): Promise<SystemMessageDescription | undefined> {
+        if (this.systemPromptId === undefined) {
+            return undefined;
+        }
+
+        const excludedAgents = this.preferenceService.get<string[]>(PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST, ['ClaudeCode']);
+        const availableAgents = this.getAvailableAgentsForDelegation(excludedAgents);
+        const availableChatAgentsValue = availableAgents.map(agent => prettyPrintAgentInMd(agent)).join('\n');
+
+        const resolvedPrompt = await this.promptService.getResolvedPromptFragment(
+            this.systemPromptId,
+            { availableChatAgents: availableChatAgentsValue },
+            context
+        );
+
+        return resolvedPrompt ? SystemMessageDescription.fromResolvedPromptFragment(resolvedPrompt) : undefined;
+    }
+
+    protected getAvailableAgentsForDelegation(excludedAgents: string[]): Array<{ id: string; name: string; description: string }> {
+        return this.chatAgentService.getAgents()
+            .filter(agent => agent.id !== this.id && !excludedAgents.includes(agent.id))
+            .map(agent => ({
+                id: agent.id,
+                name: agent.name,
+                description: agent.description
+            }));
+    }
+
+    protected getExcludedAgentIds(): string[] {
+        return this.preferenceService.get<string[]>(PREFERENCE_NAME_ORCHESTRATOR_EXCLUSION_LIST, ['ClaudeCode']);
+    }
+
     override async invoke(request: MutableChatRequestModel): Promise<void> {
         request.response.addProgressMessage({ content: nls.localize('theia/ai/ide/orchestrator/progressMessage', 'Determining the most appropriate agent'), status: 'inProgress' });
         // We use a dedicated id for the orchestrator request
@@ -88,11 +130,12 @@ export class OrchestratorChatAgent extends AbstractStreamParsingChatAgent {
         const responseText = await getTextOfResponse(response);
 
         let agentIds: string[] = [];
+        const excludedAgents = this.getExcludedAgentIds();
 
         try {
             const jsonResponse = await getJsonOfText(responseText);
             if (Array.isArray(jsonResponse)) {
-                agentIds = jsonResponse.filter((id: string) => id !== this.id);
+                agentIds = jsonResponse.filter((id: string) => id !== this.id && !excludedAgents.includes(id));
             }
         } catch (error: unknown) {
             // The llm sometimes does not return a parseable result
@@ -107,10 +150,11 @@ export class OrchestratorChatAgent extends AbstractStreamParsingChatAgent {
             agentIds = [this.fallBackChatAgentId];
         }
 
-        // check if selected (or fallback) agent exists
-        if (!this.chatAgentService.getAgent(agentIds[0])) {
-            this.logger.error(`Chat agent ${agentIds[0]} not found. Falling back to first registered agent.`);
-            const firstRegisteredAgent = this.chatAgentService.getAgents().filter(a => a.id !== this.id)[0]?.id;
+        // check if selected (or fallback) agent exists and is not excluded
+        if (!this.chatAgentService.getAgent(agentIds[0]) || excludedAgents.includes(agentIds[0])) {
+            this.logger.error(`Chat agent ${agentIds[0]} not found or excluded. Falling back to first available agent.`);
+            const firstRegisteredAgent = this.chatAgentService.getAgents()
+                .filter(a => a.id !== this.id && !excludedAgents.includes(a.id))[0]?.id;
             if (firstRegisteredAgent) {
                 agentIds = [firstRegisteredAgent];
             } else {
@@ -142,3 +186,10 @@ export class OrchestratorChatAgent extends AbstractStreamParsingChatAgent {
         await agent.invoke(originalRequest);
     }
 }
+
+function prettyPrintAgentInMd(agent: { id: string; name: string; description: string }): string {
+    return `- ${agent.id}
+  - *ID*: ${agent.id}
+  - *Name*: ${agent.name}
+  - *Description*: ${agent.description.replace(/\n/g, ' ')}`;
+}

package/src/common/orchestrator-prompt-template.ts

@@ -48,6 +48,6 @@ You must only use the \`id\` attribute of the agent, never the name.
 
 ## List of Currently Available Chat Agents
 
-{{chatAgents}}
+{{availableChatAgents}}
 `}
 };