@theia/ai-ide 1.67.0-next.56 → 1.67.0-next.59

package/lib/common/coder-replace-prompt-template.d.ts

@@ -0,0 +1,11 @@
+import { BasePromptFragment } from '@theia/ai-core/lib/common';
+export declare const CODER_SYSTEM_PROMPT_ID = "coder-system";
+export declare const CODER_SIMPLE_EDIT_TEMPLATE_ID = "coder-system-simple-edit";
+export declare const CODER_EDIT_TEMPLATE_ID = "coder-system-edit";
+export declare const CODER_EDIT_NEXT_TEMPLATE_ID = "coder-system-edit-next";
+export declare const CODER_AGENT_MODE_TEMPLATE_ID = "coder-system-agent-mode";
+export declare function getCoderAgentModePromptTemplate(): BasePromptFragment;
+export declare function getCoderPromptTemplateEdit(): BasePromptFragment;
+export declare function getCoderPromptTemplateEditNext(): BasePromptFragment;
+export declare function getCoderPromptTemplateSimpleEdit(): BasePromptFragment;
+//# sourceMappingURL=coder-replace-prompt-template.d.ts.map

package/lib/common/coder-replace-prompt-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coder-replace-prompt-template.d.ts","sourceRoot":"","sources":["../../src/common/coder-replace-prompt-template.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAsB/D,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AACxE,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE,wBAAgB,+BAA+B,IAAI,kBAAkB,CAwHpE;AAyED,wBAAgB,0BAA0B,IAAI,kBAAkB,CAK/D;AAED,wBAAgB,8BAA8B,IAAI,kBAAkB,CAMnE;AAED,wBAAgB,gCAAgC,IAAI,kBAAkB,CA8DrE"}

package/lib/common/coder-replace-prompt-template.js

@@ -0,0 +1,296 @@
+"use strict";
+/* eslint-disable @typescript-eslint/tslint/config */
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource GmbH and others.
+//
+// This file is licensed under the MIT License.
+// See LICENSE-MIT.txt in the project root for license information.
+// https://opensource.org/license/mit.
+//
+// SPDX-License-Identifier: MIT
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCoderPromptTemplateSimpleEdit = exports.getCoderPromptTemplateEditNext = exports.getCoderPromptTemplateEdit = exports.getCoderAgentModePromptTemplate = exports.CODER_AGENT_MODE_TEMPLATE_ID = exports.CODER_EDIT_NEXT_TEMPLATE_ID = exports.CODER_EDIT_TEMPLATE_ID = exports.CODER_SIMPLE_EDIT_TEMPLATE_ID = exports.CODER_SYSTEM_PROMPT_ID = void 0;
+const ai_chat_1 = require("@theia/ai-chat");
+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.CODER_SYSTEM_PROMPT_ID = 'coder-system';
+exports.CODER_SIMPLE_EDIT_TEMPLATE_ID = 'coder-system-simple-edit';
+exports.CODER_EDIT_TEMPLATE_ID = 'coder-system-edit';
+exports.CODER_EDIT_NEXT_TEMPLATE_ID = 'coder-system-edit-next';
+exports.CODER_AGENT_MODE_TEMPLATE_ID = 'coder-system-agent-mode';
+function getCoderAgentModePromptTemplate() {
+    return {
+        id: exports.CODER_AGENT_MODE_TEMPLATE_ID,
+        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 --}}
+You are an **autonomous AI agent** embedded in the Theia IDE to assist developers with tasks like implementing features, fixing bugs, or improving code quality. 
+You must independently analyze, fix, validate, and finalize all changes — only yield control when all relevant tasks are completed.
+
+# Agent Behavior
+
+## Autonomy and Persistence
+You are an agent. **Do not stop until** the entire task is complete:
+- All code changes are applied
+- The build succeeds
+- All lint issues are resolved
+- All relevant tests pass
+- New tests are written when needed
+
+You must act **without waiting** for user input unless explicitly required. Do not confirm intermediate steps — **only yield** when the entire problem is solved.
+
+## Planning and Reflection
+Before each function/tool call:
+- Think step-by-step and explain your plan
+- State your assumptions
+- Justify why you're using a particular tool
+
+After each tool call:
+- Reflect on the result
+- Adjust your plan if needed
+- Continue to the next logical step
+
+## Tool Usage Rules
+Never guess or hallucinate file content or structure. Use tools for all workspace interactions:
+
+### Workspace Exploration
+- ~{${workspace_functions_1.GET_WORKSPACE_FILE_LIST_FUNCTION_ID}} — list contents of a specific directory
+- ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}} — retrieve the content of a file
+- ~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}} — find files matching glob patterns (e.g., '**/*.ts' for all TypeScript files)
+- ~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FUNCTION_ID}} — locate references or patterns (only search if you are missing information, always prefer examples that are explicitly provided, never \
+search for files you already know the path for)
+- ~{${context_functions_1.UPDATE_CONTEXT_FILES_FUNCTION_ID}} — bookmark important files for context
+
+### Code Editing
+- Before editing, always retrieve file content
+- Use:
+  - ~{${file_changeset_function_ids_1.WRITE_FILE_REPLACEMENTS_ID}} — to immediately apply targeted code changes (no user review)
+  - ~{${file_changeset_function_ids_1.WRITE_FILE_CONTENT_ID}} — to immediately overwrite a file with new content (no user review)
+  
+- For incremental changes, use multiple ~{${file_changeset_function_ids_1.WRITE_FILE_REPLACEMENTS_ID}} calls
+- If ~{${file_changeset_function_ids_1.WRITE_FILE_REPLACEMENTS_ID}} continuously fails use ~{${file_changeset_function_ids_1.WRITE_FILE_CONTENT_ID}}.
+
+**IMPORTANT: Do not add comments explaining what you changed or why.**
+
+### Validation
+- ~{${workspace_functions_1.GET_FILE_DIAGNOSTICS_ID}} — detect syntax, lint, or type errors
+
+### Testing & Tasks
+- Use ~{${workspace_functions_1.LIST_TASKS_FUNCTION_ID}} to discover available test and lint tasks
+- Use ~{${workspace_functions_1.RUN_TASK_FUNCTION_ID}} to run linting, building, or test suites
+
+### Test Authoring
+If no relevant tests exist:
+- Create new test files (propose using ~{${file_changeset_function_ids_1.WRITE_FILE_REPLACEMENTS_ID}} or ~{${file_changeset_function_ids_1.WRITE_FILE_CONTENT_ID}})
+- Use patterns from existing tests
+- Ensure new tests validate new behavior or prevent regressions
+
+# Workflow Steps
+
+## 1. Understand the Task
+Analyze the user input, retrieve relevant files, and clarify the intent.
+
+## 2. Investigate
+Use directory listing, file retrieval, and search to gather all needed context.
+
+## 3. Plan and Propose Fixes
+Develop a step-by-step strategy. Modify relevant files via tool calls.
+
+## 4. Run Validation Tools
+Run linters and compilers:
+- If issues are found, fix them and re-run
+
+## 5. Test and Iterate
+Run all relevant tests. If failures are found, debug and fix.
+- If tests are missing, create them
+- Ensure **100% success rate** before proceeding
+
+## 6. Final Review
+Reflect on whether all objectives are met:
+- Code works
+- Tests pass
+- Code quality meets standards
+
+Only when **everything is done**, end your turn.
+
+# Additional Context
+The following files have been provided for additional context. Some of them may also be referred to by the user (e.g. "this file" or "the attachment"). \
+Always look at the relevant files to understand your task using the function ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}
+{{${context_variables_1.CONTEXT_FILES_VARIABLE_ID}}}
+
+# Previously Changed Files
+
+{{changeSetSummary}}
+
+# Project Info
+
+{{prompt:project-info}}
+
+{{${context_variables_1.TASK_CONTEXT_SUMMARY_VARIABLE_ID}}}
+
+# Final Instruction
+You are an autonomous AI agent. Do not stop until:
+- All errors are fixed
+- Lint and build succeed
+- Tests pass
+- New tests are created if needed
+- No further action is required
+`,
+        ...({ variantOf: exports.CODER_EDIT_TEMPLATE_ID }),
+    };
+}
+exports.getCoderAgentModePromptTemplate = getCoderAgentModePromptTemplate;
+function getCoderEditPromptTemplate() {
+    return `{{!-- 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 --}}
+You are an AI assistant integrated into Theia IDE, designed to assist software developers with code tasks. You can interact with the code base and suggest changes, \
+which will be reviewed and accepted by the user.
+
+## Context Retrieval
+Use the following functions to interact with the workspace files if you require context:
+- **~{${workspace_functions_1.GET_WORKSPACE_FILE_LIST_FUNCTION_ID}}**
+- **~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}**
+- **~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}}** (find files by glob patterns like '**/*.ts')
+- **~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FUNCTION_ID}}**
+
+If you cannot find good search terms, navigate the directory structure.
+**Confirm Paths**: Always verify paths by listing directories or files as you navigate. Avoid assumptions based on user input alone.
+**Navigate Step-by-Step**: Move into subdirectories only as needed, confirming each directory level.
+Remember file locations that are relevant for completing your tasks using **~{${context_functions_1.UPDATE_CONTEXT_FILES_FUNCTION_ID}}**
+Only add files that are really relevant to look at later.
+
+## Propose Code Changes
+To propose code changes or any file changes to the user, never just output them as part of your response, but use the following functions for each file you want to propose \
+changes for.
+This also applies for newly created files!
+
+- **Always Retrieve Current Content**: Use getFileContent to get the original content of the target file.
+- **View Pending Changes**: Use ~{${file_changeset_function_ids_1.GET_PROPOSED_CHANGES_ID}} to see the current proposed state of a file, including all pending changes.
+- **Change Content**: Use one of these methods to propose changes:
+  - ~{${file_changeset_function_ids_1.SUGGEST_FILE_REPLACEMENTS_ID}}: For targeted replacements of specific text sections. Multiple calls will merge changes unless you set the reset parameter to true.
+  - ~{${file_changeset_function_ids_1.SUGGEST_FILE_CONTENT_ID}}: For complete file rewrites when you need to replace the entire content.
+  - If ~{${file_changeset_function_ids_1.SUGGEST_FILE_REPLACEMENTS_ID}} continuously fails use ~{${file_changeset_function_ids_1.SUGGEST_FILE_CONTENT_ID}}.
+  - ~{${file_changeset_function_ids_1.CLEAR_FILE_CHANGES_ID}}: To clear all pending changes for a file and start fresh.
+
+The changes will be presented as an applicable diff to the user in any case. The user can then accept or reject each change individually. Before you run tasks that depend on the \
+changes beeing applied, you must wait for the user to review and accept the changes!
+
+**IMPORTANT: Do not add comments explaining what you changed or why.**
+
+## Tasks
+
+The user might want you to execute some task. You can find tasks using ~{${workspace_functions_1.LIST_TASKS_FUNCTION_ID}} and execute them using ~{${workspace_functions_1.RUN_TASK_FUNCTION_ID}}.
+Be aware that tasks operate on the workspace. If the user has not accepted any changes before, they will operate on the original states of files without your proposed changes.
+Never execute a task without confirming with the user whether this is wanted!
+
+## File Validation
+
+Use the following function to retrieve a list of problems in a file if the user requests fixes in a given file: **~{${workspace_functions_1.GET_FILE_DIAGNOSTICS_ID}}**
+Be aware this function operates on the workspace. If the user has not accepted any changes before, they will operate on the original states of files without your proposed changes.
+
+## Additional Context
+
+The following files have been provided for additional context. Some of them may also be referred to by the user (e.g. "this file" or "the attachment"). \
+Always look at the relevant files to understand your task using the function ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}
+{{${context_variables_1.CONTEXT_FILES_VARIABLE_ID}}}
+
+## Previously Proposed Changes
+You have previously proposed changes for the following files. Some suggestions may have been accepted by the user, while others may still be pending.
+{{${ai_chat_1.CHANGE_SET_SUMMARY_VARIABLE_ID}}}
+
+{{prompt:project-info}}
+
+{{${context_variables_1.TASK_CONTEXT_SUMMARY_VARIABLE_ID}}}
+
+## Final Instruction
+- Your task is to propose changes to be reviewed by the user. Always do so using the functions described above.
+- Tasks such as building or liniting run on the workspace state, the user has to accept the changes beforehand
+- Do not run a build or any error checking before the users asks you to
+- Focus on the task that the user described
+`;
+}
+function getCoderPromptTemplateEdit() {
+    return {
+        id: exports.CODER_EDIT_TEMPLATE_ID,
+        template: getCoderEditPromptTemplate()
+    };
+}
+exports.getCoderPromptTemplateEdit = getCoderPromptTemplateEdit;
+// Currently, the next template is identical to the regular edit prompt
+function getCoderPromptTemplateEditNext() {
+    return {
+        id: exports.CODER_EDIT_NEXT_TEMPLATE_ID,
+        template: getCoderEditPromptTemplate(),
+        ...({ variantOf: exports.CODER_EDIT_TEMPLATE_ID })
+    };
+}
+exports.getCoderPromptTemplateEditNext = getCoderPromptTemplateEditNext;
+function getCoderPromptTemplateSimpleEdit() {
+    return {
+        id: exports.CODER_SIMPLE_EDIT_TEMPLATE_ID,
+        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 --}}
+You are an AI assistant integrated into Theia IDE, designed to assist software developers with code tasks. You can interact with the code base and suggest changes \
+which will be reviewed and accepted by the user.
+
+## Context Retrieval
+Use the following functions to interact with the workspace files if you require context:
+- **~{${workspace_functions_1.GET_WORKSPACE_FILE_LIST_FUNCTION_ID}}**
+- **~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}**
+- **~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}}** (find files by glob patterns like '**/*.ts')
+- **~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FUNCTION_ID}}**
+
+If you cannot find good search terms, navigate the directory structure.
+**Confirm Paths**: Always verify paths by listing directories or files as you navigate. Avoid assumptions based on user input alone.
+**Navigate Step-by-Step**: Move into subdirectories only as needed, confirming each directory level.
+Remember file locations that are relevant for completing your tasks using **~{${context_functions_1.UPDATE_CONTEXT_FILES_FUNCTION_ID}}**
+Only add files that are really relevant to look at later.
+
+## Propose Code Changes
+To propose code changes or any file changes to the user, never just output them as part of your response, but use the following functions for each file you want to propose \
+changes for.
+This also applies for newly created files!
+
+- **Always Retrieve Current Content**: Use getFileContent to get the original content of the target file.
+- **View Pending Changes**: Use ~{${file_changeset_function_ids_1.GET_PROPOSED_CHANGES_ID}} to see the current proposed state of a file, including all pending changes.
+- **Change Content**: Use one of these methods to propose changes:
+  - ~{${file_changeset_function_ids_1.SUGGEST_FILE_REPLACEMENTS_ID}}: For targeted replacements of specific text sections. Multiple calls will merge changes unless you set the reset parameter to true.
+  - ~{${file_changeset_function_ids_1.SUGGEST_FILE_CONTENT_ID}}: For complete file rewrites when you need to replace the entire content. 
+  - If ~{${file_changeset_function_ids_1.SUGGEST_FILE_REPLACEMENTS_ID}} continuously fails use ~{${file_changeset_function_ids_1.SUGGEST_FILE_CONTENT_ID}}.
+  - ~{${file_changeset_function_ids_1.CLEAR_FILE_CHANGES_ID}}: To clear all pending changes for a file and start fresh.
+
+The changes will be presented as an applicable diff to the user in any case. The user can then accept or reject each change individually. Before you run tasks that depend on the \
+changes beeing applied, you must wait for the user to review and accept the changes!
+
+**IMPORTANT: Do not add comments explaining what you changed or why.**
+
+## Additional Context
+
+The following files have been provided for additional context. Some of them may also be referred to by the user (e.g. "this file" or "the attachment"). \
+Always look at the relevant files to understand your task using the function ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}
+{{${context_variables_1.CONTEXT_FILES_VARIABLE_ID}}}
+
+## Previously Proposed Changes
+You have previously proposed changes for the following files. Some suggestions may have been accepted by the user, while others may still be pending.
+{{${ai_chat_1.CHANGE_SET_SUMMARY_VARIABLE_ID}}}
+
+{{prompt:project-info}}
+
+{{${context_variables_1.TASK_CONTEXT_SUMMARY_VARIABLE_ID}}}
+
+## Final Instruction
+- Your task is to propose changes to be reviewed by the user. Always do so using the functions described above.
+- Tasks such as building or liniting run on the workspace state, the user has to accept the changes beforehand
+- Do not run a build or any error checking before the users asks you to
+- Focus on the task that the user described
+`,
+        ...({ variantOf: exports.CODER_EDIT_TEMPLATE_ID }),
+    };
+}
+exports.getCoderPromptTemplateSimpleEdit = getCoderPromptTemplateSimpleEdit;
+//# sourceMappingURL=coder-replace-prompt-template.js.map

package/lib/common/coder-replace-prompt-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coder-replace-prompt-template.js","sourceRoot":"","sources":["../../src/common/coder-replace-prompt-template.ts"],"names":[],"mappings":";AAAA,qDAAqD;AACrD,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,+CAA+C;AAC/C,mEAAmE;AACnE,sCAAsC;AACtC,EAAE;AACF,+BAA+B;AAC/B,gFAAgF;;;AAGhF,4CAAgE;AAChE,+DAQ+B;AAC/B,2DAAkG;AAClG,2DAAuE;AACvE,+EAOuC;AAE1B,QAAA,sBAAsB,GAAG,cAAc,CAAC;AAExC,QAAA,6BAA6B,GAAG,0BAA0B,CAAC;AAC3D,QAAA,sBAAsB,GAAG,mBAAmB,CAAC;AAC7C,QAAA,2BAA2B,GAAG,wBAAwB,CAAC;AACvD,QAAA,4BAA4B,GAAG,yBAAyB,CAAC;AAEtE,SAAgB,+BAA+B;IAC3C,OAAO;QACH,EAAE,EAAE,oCAA4B;QAChC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiCZ,yDAAmC;MACnC,8CAAwB;MACxB,uDAAiC;MACjC,qDAA+B;;MAE/B,oDAAgC;;;;;QAK9B,wDAA0B;QAC1B,mDAAqB;;4CAEe,wDAA0B;SAC7D,wDAA0B,8BAA8B,mDAAqB;;;;;MAKhF,6CAAuB;;;UAGnB,4CAAsB;UACtB,0CAAoB;;;;2CAIa,wDAA0B,UAAU,mDAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAkCnB,8CAAwB;IACrG,6CAAyB;;;;;;;;;;IAUzB,oDAAgC;;;;;;;;;CASnC;QACO,GAAG,CAAC,EAAE,SAAS,EAAE,8BAAsB,EAAE,CAAC;KAC7C,CAAC;AACN,CAAC;AAxHD,0EAwHC;AAED,SAAS,0BAA0B;IAC/B,OAAO;;;;;;;;QAQH,yDAAmC;QACnC,8CAAwB;QACxB,uDAAiC;QACjC,qDAA+B;;;;;gFAKyC,oDAAgC;;;;;;;;;oCAS5E,qDAAuB;;QAEnD,0DAA4B;QAC5B,qDAAuB;WACpB,0DAA4B,8BAA8B,qDAAuB;QACpF,mDAAqB;;;;;;;;;2EAS8C,4CAAsB,8BAA8B,0CAAoB;;;;;;sHAM7B,6CAAuB;;;;;;iFAM5D,8CAAwB;IACrG,6CAAyB;;;;IAIzB,wCAA8B;;;;IAI9B,oDAAgC;;;;;;;CAOnC,CAAC;AACF,CAAC;AAED,SAAgB,0BAA0B;IACtC,OAAO;QACH,EAAE,EAAE,8BAAsB;QAC1B,QAAQ,EAAE,0BAA0B,EAAE;KACzC,CAAC;AACN,CAAC;AALD,gEAKC;AACD,uEAAuE;AACvE,SAAgB,8BAA8B;IAC1C,OAAO;QACH,EAAE,EAAE,mCAA2B;QAC/B,QAAQ,EAAE,0BAA0B,EAAE;QACtC,GAAG,CAAC,EAAE,SAAS,EAAE,8BAAsB,EAAE,CAAC;KAC7C,CAAC;AACN,CAAC;AAND,wEAMC;AAED,SAAgB,gCAAgC;IAC5C,OAAO;QACH,EAAE,EAAE,qCAA6B;QACjC,QAAQ,EAAE;;;;;;;;QAQV,yDAAmC;QACnC,8CAAwB;QACxB,uDAAiC;QACjC,qDAA+B;;;;;gFAKyC,oDAAgC;;;;;;;;;oCAS5E,qDAAuB;;QAEnD,0DAA4B;QAC5B,qDAAuB;WACpB,0DAA4B,8BAA8B,qDAAuB;QACpF,mDAAqB;;;;;;;;;;iFAUoD,8CAAwB;IACrG,6CAAyB;;;;IAIzB,wCAA8B;;;;IAI9B,oDAAgC;;;;;;;CAOnC;QACO,GAAG,CAAC,EAAE,SAAS,EAAE,8BAAsB,EAAE,CAAC;KAC7C,CAAC;AACN,CAAC;AA9DD,4EA8DC"}

package/lib/common/command-chat-agents.d.ts

@@ -0,0 +1,36 @@
+import { AbstractTextToModelParsingChatAgent, SystemMessageDescription } from '@theia/ai-chat/lib/common/chat-agents';
+import { AIVariableContext, LanguageModelRequirement } from '@theia/ai-core';
+import { MutableChatRequestModel, ChatResponseContent } from '@theia/ai-chat/lib/common/chat-model';
+import { CommandRegistry, MessageService } from '@theia/core';
+interface ParsedCommand {
+    type: 'theia-command' | 'custom-handler' | 'no-command';
+    commandId: string;
+    arguments?: string[];
+    message?: string;
+}
+export declare class CommandChatAgent extends AbstractTextToModelParsingChatAgent<ParsedCommand> {
+    protected commandRegistry: CommandRegistry;
+    protected messageService: MessageService;
+    id: string;
+    name: string;
+    languageModelRequirements: LanguageModelRequirement[];
+    protected defaultLanguageModelPurpose: string;
+    description: string;
+    prompts: import("@theia/ai-core").PromptVariantSet[];
+    agentSpecificVariables: {
+        name: string;
+        description: string;
+        usedInPrompt: boolean;
+    }[];
+    protected getSystemMessageDescription(context: AIVariableContext): Promise<SystemMessageDescription | undefined>;
+    /**
+     * @param text the text received from the language model
+     * @returns the parsed command if the text contained a valid command.
+     * If there was no json in the text, return a no-command response.
+     */
+    protected parseTextResponse(text: string): Promise<ParsedCommand>;
+    protected createResponseContent(parsedCommand: ParsedCommand, request: MutableChatRequestModel): ChatResponseContent;
+    protected commandCallback(...commandArgs: unknown[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=command-chat-agents.d.ts.map

package/lib/common/command-chat-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-chat-agents.d.ts","sourceRoot":"","sources":["../../src/common/command-chat-agents.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,mCAAmC,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACtH,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EAKtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACH,eAAe,EACf,cAAc,EAGjB,MAAM,aAAa,CAAC;AAIrB,UAAU,aAAa;IACnB,IAAI,EAAE,eAAe,GAAG,gBAAgB,GAAG,YAAY,CAAA;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBACa,gBAAiB,SAAQ,mCAAmC,CAAC,aAAa,CAAC;IAEpF,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC;IAE3C,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC;IAEzC,EAAE,EAAE,MAAM,CAAa;IACvB,IAAI,SAAa;IACjB,yBAAyB,EAAE,wBAAwB,EAAE,CAGlD;IACH,SAAS,CAAC,2BAA2B,EAAE,MAAM,CAAa;IAEjD,WAAW,SAE8E;IACzF,OAAO,8CAAqB;IAC5B,sBAAsB;;;;QAI5B;cAEsB,2BAA2B,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAc/H;;;;OAIG;cACa,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUvE,SAAS,CAAC,qBAAqB,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,GAAG,mBAAmB;cAsCpG,eAAe,CAAC,GAAG,WAAW,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAK5E"}

package/lib/common/command-chat-agents.js

@@ -0,0 +1,122 @@
+"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.CommandChatAgent = 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 chat_model_1 = require("@theia/ai-chat/lib/common/chat-model");
+const core_1 = require("@theia/core");
+const command_prompt_template_1 = require("./command-prompt-template");
+let CommandChatAgent = class CommandChatAgent extends chat_agents_1.AbstractTextToModelParsingChatAgent {
+    constructor() {
+        super(...arguments);
+        this.id = 'Command';
+        this.name = 'Command';
+        this.languageModelRequirements = [{
+                purpose: 'command',
+                identifier: 'default/universal',
+            }];
+        this.defaultLanguageModelPurpose = 'command';
+        this.description = core_1.nls.localize('theia/ai/ide/commandAgent/description', 'This agent is aware of all commands that the user can execute within the Theia IDE, the tool that the user is currently working with. ' +
+            'Based on the user request, it can find the right command and then let the user execute it.');
+        this.prompts = [command_prompt_template_1.commandTemplate];
+        this.agentSpecificVariables = [{
+                name: 'command-ids',
+                description: core_1.nls.localize('theia/ai/ide/commandAgent/vars/commandIds/description', 'The list of available commands in Theia.'),
+                usedInPrompt: true
+            }];
+    }
+    async getSystemMessageDescription(context) {
+        const knownCommands = [];
+        for (const command of this.commandRegistry.getAllCommands()) {
+            knownCommands.push(`${command.id}: ${command.label}`);
+        }
+        const systemPrompt = await this.promptService.getResolvedPromptFragment(command_prompt_template_1.commandTemplate.id, {
+            'command-ids': knownCommands.join('\n')
+        }, context);
+        if (systemPrompt === undefined) {
+            throw new Error('Couldn\'t get prompt ');
+        }
+        return chat_agents_1.SystemMessageDescription.fromResolvedPromptFragment(systemPrompt);
+    }
+    /**
+     * @param text the text received from the language model
+     * @returns the parsed command if the text contained a valid command.
+     * If there was no json in the text, return a no-command response.
+     */
+    async parseTextResponse(text) {
+        const jsonMatch = text.match(/(\{[\s\S]*\})/);
+        const jsonString = jsonMatch ? jsonMatch[1] : `{
+    "type": "no-command",
+    "message": "Please try again."
+}`;
+        const parsedCommand = JSON.parse(jsonString);
+        return parsedCommand;
+    }
+    createResponseContent(parsedCommand, request) {
+        var _a;
+        if (parsedCommand.type === 'theia-command') {
+            const theiaCommand = this.commandRegistry.getCommand(parsedCommand.commandId);
+            if (theiaCommand === undefined) {
+                console.error(`No Theia Command with id ${parsedCommand.commandId}`);
+                request.cancel();
+            }
+            const args = parsedCommand.arguments !== undefined &&
+                parsedCommand.arguments.length > 0
+                ? parsedCommand.arguments
+                : undefined;
+            return new chat_model_1.HorizontalLayoutChatResponseContentImpl([
+                new chat_model_1.MarkdownChatResponseContentImpl(core_1.nls.localize('theia/ai/ide/commandAgent/response/theiaCommand', 'I found this command that might help you:')),
+                new chat_model_1.CommandChatResponseContentImpl(theiaCommand, undefined, args),
+            ]);
+        }
+        else if (parsedCommand.type === 'custom-handler') {
+            const id = `ai-command-${(0, core_1.generateUuid)()}`;
+            const commandArgs = parsedCommand.arguments !== undefined && parsedCommand.arguments.length > 0 ? parsedCommand.arguments : [];
+            const args = [id, ...commandArgs];
+            const customCallback = {
+                label: core_1.nls.localize('theia/ai/ide/commandAgent/commandCallback/label', 'AI command'),
+                callback: () => this.commandCallback(...args),
+            };
+            return new chat_model_1.HorizontalLayoutChatResponseContentImpl([
+                new chat_model_1.MarkdownChatResponseContentImpl(core_1.nls.localize('theia/ai/ide/commandAgent/response/customHandler', 'Try executing this:')),
+                new chat_model_1.CommandChatResponseContentImpl(undefined, customCallback, args),
+            ]);
+        }
+        else {
+            return new chat_model_1.MarkdownChatResponseContentImpl((_a = parsedCommand.message) !== null && _a !== void 0 ? _a : core_1.nls.localize('theia/ai/ide/commandAgent/response/noCommand', 'Sorry, I can\'t find such a command'));
+        }
+    }
+    async commandCallback(...commandArgs) {
+        this.messageService.info(core_1.nls.localize('theia/ai/ide/commandAgent/commandCallback/message', 'Executing callback with args {0}. The first arg is the command id registered for the dynamically registered command. ' +
+            'The other args are the actual args for the handler.', commandArgs.join(', ')), core_1.nls.localize('theia/ai/ide/commandAgent/commandCallback/confirmAction', 'Got it'));
+    }
+};
+exports.CommandChatAgent = CommandChatAgent;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.CommandRegistry),
+    tslib_1.__metadata("design:type", core_1.CommandRegistry)
+], CommandChatAgent.prototype, "commandRegistry", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.MessageService),
+    tslib_1.__metadata("design:type", core_1.MessageService)
+], CommandChatAgent.prototype, "messageService", void 0);
+exports.CommandChatAgent = CommandChatAgent = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], CommandChatAgent);
+//# sourceMappingURL=command-chat-agents.js.map

package/lib/common/command-chat-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-chat-agents.js","sourceRoot":"","sources":["../../src/common/command-chat-agents.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,4DAAkE;AAClE,uEAAsH;AAEtH,qEAO8C;AAC9C,sCAKqB;AAErB,uEAA4D;AAUrD,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,iDAAkD;IAAjF;;QAMH,OAAE,GAAW,SAAS,CAAC;QACvB,SAAI,GAAG,SAAS,CAAC;QACjB,8BAAyB,GAA+B,CAAC;gBACrD,OAAO,EAAE,SAAS;gBAClB,UAAU,EAAE,mBAAmB;aAClC,CAAC,CAAC;QACO,gCAA2B,GAAW,SAAS,CAAC;QAEjD,gBAAW,GAAG,UAAG,CAAC,QAAQ,CAAC,uCAAuC,EACvE,wIAAwI;YACxI,4FAA4F,CAAC,CAAC;QACzF,YAAO,GAAG,CAAC,yCAAe,CAAC,CAAC;QAC5B,2BAAsB,GAAG,CAAC;gBAC/B,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,UAAG,CAAC,QAAQ,CAAC,uDAAuD,EAAE,0CAA0C,CAAC;gBAC9H,YAAY,EAAE,IAAI;aACrB,CAAC,CAAC;IA0EP,CAAC;IAxEsB,KAAK,CAAC,2BAA2B,CAAC,OAA0B;QAC3E,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1D,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,yCAAe,CAAC,EAAE,EAAE;YACxF,aAAa,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;SAC1C,EAAE,OAAO,CAAC,CAAC;QACZ,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,sCAAwB,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,iBAAiB,CAAC,IAAY;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;;EAGpD,CAAC;QACK,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAkB,CAAC;QAC9D,OAAO,aAAa,CAAC;IACzB,CAAC;IAES,qBAAqB,CAAC,aAA4B,EAAE,OAAgC;;QAC1F,IAAI,aAAa,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAC9E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,4BAA4B,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC;gBACrE,OAAO,CAAC,MAAM,EAAE,CAAC;YACrB,CAAC;YACD,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,KAAK,SAAS;gBAC9C,aAAa,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBAClC,CAAC,CAAC,aAAa,CAAC,SAAS;gBACzB,CAAC,CAAC,SAAS,CAAC;YAEhB,OAAO,IAAI,oDAAuC,CAAC;gBAC/C,IAAI,4CAA+B,CAC/B,UAAG,CAAC,QAAQ,CAAC,iDAAiD,EAAE,2CAA2C,CAAC,CAC/G;gBACD,IAAI,2CAA8B,CAAC,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC;aACpE,CAAC,CAAC;QACP,CAAC;aAAM,IAAI,aAAa,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACjD,MAAM,EAAE,GAAG,cAAc,IAAA,mBAAY,GAAE,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,KAAK,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/H,MAAM,IAAI,GAAG,CAAC,EAAE,EAAE,GAAG,WAAW,CAAC,CAAC;YAClC,MAAM,cAAc,GAAmB;gBACnC,KAAK,EAAE,UAAG,CAAC,QAAQ,CAAC,iDAAiD,EAAE,YAAY,CAAC;gBACpF,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;aAChD,CAAC;YACF,OAAO,IAAI,oDAAuC,CAAC;gBAC/C,IAAI,4CAA+B,CAC/B,UAAG,CAAC,QAAQ,CAAC,kDAAkD,EAAE,qBAAqB,CAAC,CAC1F;gBACD,IAAI,2CAA8B,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,CAAC;aACtE,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,4CAA+B,CAAC,MAAA,aAAa,CAAC,OAAO,mCAAI,UAAG,CAAC,QAAQ,CAAC,8CAA8C,EAC3H,qCAAqC,CAAC,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAES,KAAK,CAAC,eAAe,CAAC,GAAG,WAAsB;QACrD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,UAAG,CAAC,QAAQ,CAAC,mDAAmD,EACrF,uHAAuH;YACvH,qDAAqD,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAG,CAAC,QAAQ,CAAC,yDAAyD,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3K,CAAC;CACJ,CAAA;AAhGY,4CAAgB;AAEf;IADT,IAAA,kBAAM,EAAC,sBAAe,CAAC;sCACG,sBAAe;yDAAC;AAEjC;IADT,IAAA,kBAAM,EAAC,qBAAc,CAAC;sCACG,qBAAc;wDAAC;2BAJhC,gBAAgB;IAD5B,IAAA,sBAAU,GAAE;GACA,gBAAgB,CAgG5B"}

package/lib/common/command-prompt-template.d.ts

@@ -0,0 +1,3 @@
+import { PromptVariantSet } from '@theia/ai-core';
+export declare const commandTemplate: PromptVariantSet;
+//# sourceMappingURL=command-prompt-template.d.ts.map

package/lib/common/command-prompt-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-prompt-template.d.ts","sourceRoot":"","sources":["../../src/common/command-prompt-template.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,gBAkN7B,CAAC"}