@theia/ai-ide 1.59.0-next.62

package/lib/common/universal-chat-agent.js

@@ -0,0 +1,107 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UniversalChatAgent = exports.UniversalChatAgentId = exports.universalTemplateVariant = exports.universalTemplate = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const chat_agents_1 = require("@theia/ai-chat/lib/common/chat-agents");
+const core_1 = require("@theia/core");
+exports.universalTemplate = {
+    id: 'universal-system',
+    template: `{{!-- 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 an AI assistant integrated into the Theia IDE, specifically designed to help software developers by
+providing concise and accurate answers to programming-related questions. Your role is to enhance the
+developer's productivity by offering quick solutions, explanations, and best practices.
+Keep responses short and to the point, focusing on delivering valuable insights, best practices and
+simple solutions.
+
+### Guidelines
+
+1. **Understand Context:**
+   - Assess the context of the code or issue when available.
+   - Tailor responses to be relevant to the programming language, framework, or tools like Eclipse Theia.
+   - Ask clarifying questions if necessary to provide accurate assistance.
+
+2. **Provide Clear Solutions:**
+   - Offer direct answers or code snippets that solve the problem or clarify the concept.
+   - Avoid lengthy explanations unless necessary for understanding.
+
+3. **Promote Best Practices:**
+   - Suggest best practices and common patterns relevant to the question.
+   - Provide links to official documentation for further reading when applicable.
+
+4. **Support Multiple Languages and Tools:**
+   - Be familiar with popular programming languages, frameworks, IDEs like Eclipse Theia, and command-line tools.
+   - Adapt advice based on the language, environment, or tools specified by the developer.
+
+5. **Facilitate Learning:**
+   - Encourage learning by explaining why a solution works or why a particular approach is recommended.
+   - Keep explanations concise and educational.
+
+6. **Maintain Professional Tone:**
+   - Communicate in a friendly, professional manner.
+   - Use technical jargon appropriately, ensuring clarity for the target audience.
+
+7. **Stay on Topic:**
+   - Limit responses strictly to topics related to software development, frameworks, Eclipse Theia, terminal usage, and relevant technologies.
+   - Politely decline to answer questions unrelated to these areas by saying, "I'm here to assist with programming-related questions.
+     For other topics, please refer to a specialized source."
+
+### Example Interactions
+
+- **Question:** "What's the difference between \`let\` and \`var\` in JavaScript?"
+  **Answer:** "\`let\` is block-scoped, while \`var\` is function-scoped. Prefer \`let\` to avoid scope-related bugs."
+
+- **Question:** "How do I handle exceptions in Java?"
+  **Answer:** "Use try-catch blocks: \`\`\`java try { /* code */ } catch (ExceptionType e) { /* handle exception */ }\`\`\`."
+
+- **Question:** "What is the capital of France?"
+  **Answer:** "I'm here to assist with programming-related queries. For other topics, please refer to a specialized source."
+`
+};
+exports.universalTemplateVariant = {
+    id: 'universal-system-empty',
+    template: '',
+    variantOf: exports.universalTemplate.id,
+};
+exports.UniversalChatAgentId = 'Universal';
+let UniversalChatAgent = class UniversalChatAgent extends chat_agents_1.AbstractStreamParsingChatAgent {
+    constructor() {
+        super(...arguments);
+        this.id = exports.UniversalChatAgentId;
+        this.name = exports.UniversalChatAgentId;
+        this.languageModelRequirements = [{
+                purpose: 'chat',
+                identifier: 'openai/gpt-4o',
+            }];
+        this.defaultLanguageModelPurpose = 'chat';
+        this.description = core_1.nls.localize('theia/ai/chat/universal/description', 'This agent is designed to help software developers by providing concise and accurate '
+            + 'answers to general programming and software development questions. It is also the fall-back for any generic '
+            + 'questions the user might ask. The universal agent currently does not have any context by default, i.e. it cannot '
+            + 'access the current user context or the workspace.');
+        this.promptTemplates = [exports.universalTemplate, exports.universalTemplateVariant];
+        this.systemPromptId = exports.universalTemplate.id;
+    }
+};
+exports.UniversalChatAgent = UniversalChatAgent;
+exports.UniversalChatAgent = UniversalChatAgent = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], UniversalChatAgent);
+//# sourceMappingURL=universal-chat-agent.js.map

package/lib/common/universal-chat-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-chat-agent.js","sourceRoot":"","sources":["../../src/common/universal-chat-agent.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAGhF,4DAA0D;AAC1D,uEAAuF;AACvF,sCAAkC;AAErB,QAAA,iBAAiB,GAAmB;IAC9C,EAAE,EAAE,kBAAkB;IACtB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDZ;CACA,CAAC;AAEW,QAAA,wBAAwB,GAAmB;IACrD,EAAE,EAAE,wBAAwB;IAC5B,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,yBAAiB,CAAC,EAAE;CACjC,CAAC;AAEW,QAAA,oBAAoB,GAAG,WAAW,CAAC;AAEzC,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,4CAA8B;IAA/D;;QACJ,OAAE,GAAW,4BAAoB,CAAC;QAClC,SAAI,GAAG,4BAAoB,CAAC;QAC5B,8BAAyB,GAA+B,CAAC;gBACtD,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,eAAe;aAC7B,CAAC,CAAC;QACO,gCAA2B,GAAW,MAAM,CAAC;QAC9C,gBAAW,GAAG,UAAG,CAAC,QAAQ,CAAC,qCAAqC,EAAE,uFAAuF;cAC7J,8GAA8G;cAC9G,mHAAmH;cACnH,mDAAmD,CAAC,CAAC;QAEjD,oBAAe,GAAG,CAAC,yBAAiB,EAAE,gCAAwB,CAAC,CAAC;QACtD,mBAAc,GAAW,yBAAiB,CAAC,EAAE,CAAC;IACpE,CAAC;CAAA,CAAA;AAfY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,sBAAU,GAAE;GACA,kBAAkB,CAe9B"}

package/lib/common/workspace-functions.d.ts

@@ -0,0 +1,4 @@
+export declare const FILE_CONTENT_FUNCTION_ID = "getFileContent";
+export declare const GET_WORKSPACE_FILE_LIST_FUNCTION_ID = "getWorkspaceFileList";
+export declare const GET_WORKSPACE_DIRECTORY_STRUCTURE_FUNCTION_ID = "getWorkspaceDirectoryStructure";
+//# sourceMappingURL=workspace-functions.d.ts.map

package/lib/common/workspace-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-functions.d.ts","sourceRoot":"","sources":["../../src/common/workspace-functions.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,mCAAmC,yBAAyB,CAAC;AAC1E,eAAO,MAAM,6CAA6C,mCAAmC,CAAC"}

package/lib/common/workspace-functions.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_WORKSPACE_DIRECTORY_STRUCTURE_FUNCTION_ID = exports.GET_WORKSPACE_FILE_LIST_FUNCTION_ID = exports.FILE_CONTENT_FUNCTION_ID = void 0;
+// *****************************************************************************
+// 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
+// *****************************************************************************
+exports.FILE_CONTENT_FUNCTION_ID = 'getFileContent';
+exports.GET_WORKSPACE_FILE_LIST_FUNCTION_ID = 'getWorkspaceFileList';
+exports.GET_WORKSPACE_DIRECTORY_STRUCTURE_FUNCTION_ID = 'getWorkspaceDirectoryStructure';
+//# sourceMappingURL=workspace-functions.js.map

package/lib/common/workspace-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-functions.js","sourceRoot":"","sources":["../../src/common/workspace-functions.ts"],"names":[],"mappings":";;;AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AACnE,QAAA,wBAAwB,GAAG,gBAAgB,CAAC;AAC5C,QAAA,mCAAmC,GAAG,sBAAsB,CAAC;AAC7D,QAAA,6CAA6C,GAAG,gCAAgC,CAAC"}

package/lib/package.spec.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=package.spec.d.ts.map

package/lib/package.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.spec.d.ts","sourceRoot":"","sources":["../src/package.spec.ts"],"names":[],"mappings":""}

package/lib/package.spec.js

@@ -0,0 +1,26 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH 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
+// *****************************************************************************
+/* note: this bogus test file is required so that
+   we are able to run mocha unit tests on this
+   package, without having any actual unit tests in it.
+   This way a coverage report will be generated,
+   showing 0% coverage, instead of no report.
+   This file can be removed once we have real unit
+   tests in place. */
+describe('ai-ide-agents package', () => {
+    it('support code coverage statistics', () => true);
+});
+//# sourceMappingURL=package.spec.js.map

package/lib/package.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.spec.js","sourceRoot":"","sources":["../src/package.spec.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oDAAoD;AACpD,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;;;;;;qBAMqB;AAErB,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IAEnC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@theia/ai-ide",
+  "version": "1.59.0-next.62+9e43c93ad",
+  "description": "AI IDE Agents Extension",
+  "license": "EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-theia/theia.git"
+  },
+  "bugs": {
+    "url": "https://github.com/eclipse-theia/theia/issues"
+  },
+  "homepage": "https://github.com/eclipse-theia/theia",
+  "keywords": [
+    "theia-extension"
+  ],
+  "dependencies": {
+    "@theia/ai-chat": "1.59.0-next.62+9e43c93ad",
+    "@theia/ai-core": "1.59.0-next.62+9e43c93ad",
+    "@theia/core": "1.59.0-next.62+9e43c93ad",
+    "@theia/filesystem": "1.59.0-next.62+9e43c93ad",
+    "@theia/monaco": "1.59.0-next.62+9e43c93ad",
+    "@theia/navigator": "1.59.0-next.62+9e43c93ad",
+    "@theia/terminal": "1.59.0-next.62+9e43c93ad",
+    "@theia/workspace": "1.59.0-next.62+9e43c93ad",
+    "ignore": "^6.0.0",
+    "minimatch": "^9.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@theia/cli": "1.59.0-next.62+9e43c93ad",
+    "@theia/test": "1.59.0-next.62+9e43c93ad"
+  },
+  "theiaExtensions": [
+    {
+      "frontend": "lib/browser/frontend-module"
+    }
+  ],
+  "files": [
+    "lib",
+    "src"
+  ],
+  "scripts": {
+    "build": "theiaext build",
+    "clean": "theiaext clean",
+    "compile": "theiaext compile",
+    "lint": "theiaext lint",
+    "test": "theiaext test",
+    "watch": "theiaext watch"
+  },
+  "nyc": {
+    "extends": "../../configs/nyc.json"
+  },
+  "gitHead": "9e43c93ad61ea977db3974207bac5d7c1fd3ccd6"
+}

package/src/browser/ai-configuration/agent-configuration-widget.tsx

@@ -0,0 +1,330 @@
+// *****************************************************************************
+// 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 {
+    Agent,
+    AgentService,
+    AISettingsService,
+    AIVariableService,
+    LanguageModel,
+    LanguageModelRegistry,
+    matchVariablesRegEx,
+    PROMPT_FUNCTION_REGEX,
+    PromptCustomizationService,
+    PromptService,
+} from '@theia/ai-core/lib/common';
+import { codicon, ReactWidget } from '@theia/core/lib/browser';
+import { inject, injectable, postConstruct } from '@theia/core/shared/inversify';
+import * as React from '@theia/core/shared/react';
+import { AIConfigurationSelectionService } from './ai-configuration-service';
+import { LanguageModelRenderer } from './language-model-renderer';
+import { TemplateRenderer } from './template-settings-renderer';
+import { AIVariableConfigurationWidget } from './variable-configuration-widget';
+import { nls } from '@theia/core';
+
+interface ParsedPrompt {
+    functions: string[];
+    globalVariables: string[];
+    agentSpecificVariables: string[];
+};
+
+@injectable()
+export class AIAgentConfigurationWidget extends ReactWidget {
+
+    static readonly ID = 'ai-agent-configuration-container-widget';
+    static readonly LABEL = nls.localize('theia/ai/core/agentConfiguration/label', 'Agents');
+
+    @inject(AgentService)
+    protected readonly agentService: AgentService;
+
+    @inject(LanguageModelRegistry)
+    protected readonly languageModelRegistry: LanguageModelRegistry;
+
+    @inject(PromptCustomizationService)
+    protected readonly promptCustomizationService: PromptCustomizationService;
+
+    @inject(AISettingsService)
+    protected readonly aiSettingsService: AISettingsService;
+
+    @inject(AIConfigurationSelectionService)
+    protected readonly aiConfigurationSelectionService: AIConfigurationSelectionService;
+
+    @inject(AIVariableService)
+    protected readonly variableService: AIVariableService;
+
+    @inject(PromptService)
+    protected promptService: PromptService;
+
+    protected languageModels: LanguageModel[] | undefined;
+
+    @postConstruct()
+    protected init(): void {
+        this.id = AIAgentConfigurationWidget.ID;
+        this.title.label = AIAgentConfigurationWidget.LABEL;
+        this.title.closable = false;
+
+        this.languageModelRegistry.getLanguageModels().then(models => {
+            this.languageModels = models ?? [];
+            this.update();
+        });
+        this.toDispose.push(this.languageModelRegistry.onChange(({ models }) => {
+            this.languageModels = models;
+            this.update();
+        }));
+        this.toDispose.push(this.promptCustomizationService.onDidChangePrompt(() => this.update()));
+
+        this.aiSettingsService.onDidChange(() => this.update());
+        this.aiConfigurationSelectionService.onDidAgentChange(() => this.update());
+        this.agentService.onDidChangeAgents(() => this.update());
+        this.update();
+    }
+
+    protected render(): React.ReactNode {
+        return <div className='ai-agent-configuration-main'>
+            <div className='configuration-agents-list preferences-tree-widget theia-TreeContainer' style={{ width: '25%' }}>
+                <ul>
+                    {this.agentService.getAllAgents().map(agent =>
+                        <li key={agent.id} className='theia-TreeNode theia-CompositeTreeNode theia-ExpandableTreeNode' onClick={() => this.setActiveAgent(agent)}>
+                            {this.renderAgentName(agent)}
+                        </li>
+                    )}
+                </ul>
+                <div className='configuration-agents-add'>
+                    <button
+                        style={{ marginLeft: 0 }}
+                        className='theia-button main'
+                        onClick={() => this.addCustomAgent()}>
+                        {nls.localize('theia/ai/core/agentConfiguration/addCustomAgent', 'Add Custom Agent')}
+                    </button>
+                </div>
+            </div>
+            <div className='configuration-agent-panel preferences-editor-widget'>
+                {this.renderAgentDetails()}
+            </div>
+        </div>;
+    }
+
+    private renderAgentName(agent: Agent): React.ReactNode {
+        const tagsSuffix = agent.tags?.length ? <span>{agent.tags.map(tag => <span key={tag} className='agent-tag'>{tag}</span>)}</span> : '';
+        return <span>{agent.name} {tagsSuffix}</span>;
+    }
+
+    private renderAgentDetails(): React.ReactNode {
+        const agent = this.aiConfigurationSelectionService.getActiveAgent();
+        if (!agent) {
+            return <div>{nls.localize('theia/ai/core/agentConfiguration/selectAgentMessage', 'Please select an Agent first!')}</div>;
+        }
+
+        const enabled = this.agentService.isEnabled(agent.id);
+
+        const parsedPromptParts = this.parsePromptTemplatesForVariableAndFunction(agent);
+        const globalVariables = Array.from(new Set([...parsedPromptParts.globalVariables, ...agent.variables]));
+        const functions = Array.from(new Set([...parsedPromptParts.functions, ...agent.functions]));
+
+        return <div key={agent.id} style={{ display: 'flex', flexDirection: 'column', alignItems: 'flex-start' }}>
+            <div className='settings-section-title settings-section-category-title' style={{ paddingLeft: 0, paddingBottom: 10 }}>{this.renderAgentName(agent)}</div>
+            <div style={{ paddingBottom: 10 }}>{agent.description}</div>
+            <div style={{ paddingBottom: 10 }}>
+                <label>
+                    <input type="checkbox" checked={enabled} onChange={this.toggleAgentEnabled} />
+                    {nls.localize('theia/ai/core/agentConfiguration/enableAgent', 'Enable Agent')}
+                </label>
+            </div>
+            <div className="settings-section-subcategory-title ai-settings-section-subcategory-title">
+                {nls.localize('theia/ai/core/agentConfiguration/promptTemplates', 'Prompt Templates')}
+            </div>
+            <div className="ai-templates">
+                {(() => {
+                    const defaultTemplates = agent.promptTemplates?.filter(template => !template.variantOf) || [];
+                    return defaultTemplates.length > 0 ? (
+                        defaultTemplates.map(template => (
+                            <div key={agent.id + '.' + template.id}>
+                                <TemplateRenderer
+                                    key={agent.id + '.' + template.id}
+                                    agentId={agent.id}
+                                    template={template}
+                                    promptService={this.promptService}
+                                    aiSettingsService={this.aiSettingsService}
+                                    promptCustomizationService={this.promptCustomizationService}
+                                />
+                            </div>
+                        ))
+                    ) : (
+                        <div>{nls.localize('theia/ai/core/agentConfiguration/noDefaultTemplate', 'No default template available')}</div>
+                    );
+                })()}
+            </div>
+
+            <div className='ai-lm-requirements'>
+                <LanguageModelRenderer
+                    agent={agent}
+                    languageModels={this.languageModels}
+                    aiSettingsService={this.aiSettingsService}
+                    languageModelRegistry={this.languageModelRegistry} />
+            </div>
+            <div>
+                <span>Used Global Variables:</span>
+                <ul className='variable-references'>
+                    <AgentGlobalVariables variables={globalVariables} showVariableConfigurationTab={this.showVariableConfigurationTab.bind(this)} />
+                </ul>
+            </div>
+            <div>
+                <span>Used agent-specific Variables:</span>
+                <ul className='variable-references'>
+                    <AgentSpecificVariables
+                        promptVariables={parsedPromptParts.agentSpecificVariables}
+                        agent={agent}
+                    />
+                </ul>
+            </div>
+            <div>
+                <span>Used Functions:</span>
+                <ul className='function-references'>
+                    <AgentFunctions functions={functions} />
+                </ul>
+            </div>
+        </div>;
+    }
+
+    private parsePromptTemplatesForVariableAndFunction(agent: Agent): ParsedPrompt {
+        const promptTemplates = agent.promptTemplates;
+        const result: ParsedPrompt = { functions: [], globalVariables: [], agentSpecificVariables: [] };
+        promptTemplates.forEach(template => {
+            const storedPrompt = this.promptService.getUnresolvedPrompt(template.id);
+            const prompt = storedPrompt?.template ?? template.template;
+            const variableMatches = matchVariablesRegEx(prompt);
+
+            variableMatches.forEach(match => {
+                const variableId = match[1];
+                // if the variable is part of the variable service and not part of the agent specific variables then it is a global variable
+                if (this.variableService.hasVariable(variableId) &&
+                    agent.agentSpecificVariables.find(v => v.name === variableId) === undefined) {
+                    result.globalVariables.push(variableId);
+                } else {
+                    result.agentSpecificVariables.push(variableId);
+                }
+            });
+
+            const functionMatches = [...prompt.matchAll(PROMPT_FUNCTION_REGEX)];
+            functionMatches.forEach(match => {
+                const functionId = match[1];
+                result.functions.push(functionId);
+            });
+
+        });
+        return result;
+    }
+
+    protected showVariableConfigurationTab(): void {
+        this.aiConfigurationSelectionService.selectConfigurationTab(AIVariableConfigurationWidget.ID);
+    }
+
+    protected addCustomAgent(): void {
+        this.promptCustomizationService.openCustomAgentYaml();
+    }
+
+    protected setActiveAgent(agent: Agent): void {
+        this.aiConfigurationSelectionService.setActiveAgent(agent);
+        this.update();
+    }
+
+    private toggleAgentEnabled = () => {
+        const agent = this.aiConfigurationSelectionService.getActiveAgent();
+        if (!agent) {
+            return false;
+        }
+        const enabled = this.agentService.isEnabled(agent.id);
+        if (enabled) {
+            this.agentService.disableAgent(agent.id);
+        } else {
+            this.agentService.enableAgent(agent.id);
+        }
+        this.update();
+    };
+
+}
+interface AgentGlobalVariablesProps {
+    variables: string[];
+    showVariableConfigurationTab: () => void;
+}
+const AgentGlobalVariables = ({ variables: globalVariables, showVariableConfigurationTab }: AgentGlobalVariablesProps) => {
+    if (globalVariables.length === 0) {
+        return <>{nls.localizeByDefault('None')}</>;
+    }
+    return <>
+        {globalVariables.map(variableId => <li key={variableId} className='theia-TreeNode theia-CompositeTreeNode theia-ExpandableTreeNode theia-mod-selected'>
+            <div key={variableId} onClick={() => { showVariableConfigurationTab(); }} className='variable-reference'>
+                <span>{variableId}</span>
+                <i className={codicon('chevron-right')}></i>
+            </div></li>)}
+
+    </>;
+};
+
+interface AgentFunctionsProps {
+    functions: string[];
+}
+const AgentFunctions = ({ functions }: AgentFunctionsProps) => {
+    if (functions.length === 0) {
+        return <>{nls.localizeByDefault('None')}</>;
+    }
+    return <>
+        {functions.map(functionId => <li key={functionId} className='variable-reference'>
+            <span>{functionId}</span>
+        </li>)}
+    </>;
+};
+
+interface AgentSpecificVariablesProps {
+    promptVariables: string[];
+    agent: Agent;
+}
+const AgentSpecificVariables = ({ promptVariables, agent }: AgentSpecificVariablesProps) => {
+    const agentDefinedVariablesName = agent.agentSpecificVariables.map(v => v.name);
+    const variables = Array.from(new Set([...promptVariables, ...agentDefinedVariablesName]));
+    if (variables.length === 0) {
+        return <>{nls.localizeByDefault('None')}</>;
+    }
+    return <>
+        {variables.map(variableId =>
+            <AgentSpecifcVariable
+                key={variableId}
+                variableId={variableId}
+                agent={agent}
+                promptVariables={promptVariables} />
+
+        )}
+    </>;
+};
+interface AgentSpecifcVariableProps {
+    variableId: string;
+    agent: Agent;
+    promptVariables: string[];
+}
+const AgentSpecifcVariable = ({ variableId, agent, promptVariables }: AgentSpecifcVariableProps) => {
+    const agentDefinedVariable = agent.agentSpecificVariables.find(v => v.name === variableId);
+    const undeclared = agentDefinedVariable === undefined;
+    const notUsed = !promptVariables.includes(variableId) && agentDefinedVariable?.usedInPrompt === true;
+    return <li key={variableId}>
+        <div><span>{nls.localize('theia/ai/core/agentConfiguration/name', 'Name:')}</span> <span>{variableId}</span></div>
+        {undeclared ? <div><span>{nls.localize('theia/ai/core/agentConfiguration/undeclared', 'Undeclared')}</span></div> :
+            (<>
+                <div><span>{nls.localize('theia/ai/core/agentConfiguration/description', 'Description:')}</span> <span>{agentDefinedVariable.description}</span></div>
+                {notUsed && <div>{nls.localize('theia/ai/core/agentConfiguration/notUsedInPrompt', 'Not used in prompt')}</div>}
+            </>)}
+        <hr />
+    </li>;
+};

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

@@ -0,0 +1,43 @@
+// *****************************************************************************
+// 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 { Agent } from '@theia/ai-core/lib/common';
+import { Emitter } from '@theia/core';
+import { injectable } from '@theia/core/shared/inversify';
+
+@injectable()
+export class AIConfigurationSelectionService {
+    protected activeAgent?: Agent;
+
+    protected readonly onDidSelectConfigurationEmitter = new Emitter<string>();
+    onDidSelectConfiguration = this.onDidSelectConfigurationEmitter.event;
+
+    protected readonly onDidAgentChangeEmitter = new Emitter<Agent | undefined>();
+    onDidAgentChange = this.onDidSelectConfigurationEmitter.event;
+
+    public getActiveAgent(): Agent | undefined {
+        return this.activeAgent;
+    }
+
+    public setActiveAgent(agent?: Agent): void {
+        this.activeAgent = agent;
+        this.onDidAgentChangeEmitter.fire(agent);
+    }
+
+    public selectConfigurationTab(widgetId: string): void {
+        this.onDidSelectConfigurationEmitter.fire(widgetId);
+    }
+}