@codingame/monaco-vscode-chat-service-override 22.1.9 → 23.0.0

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/languageProviders/promptDocumentSemanticTokensProvider.js

@@ -1,7 +1,8 @@
 
 import { __decorate, __param } from '@codingame/monaco-vscode-api/external/tslib/tslib.es6';
-import { getPromptsTypeForLanguageId } from '@codingame/monaco-vscode-e28ac690-06d5-5ee9-92d1-02df70296354-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
+import { getPromptsTypeForLanguageId } from '@codingame/monaco-vscode-8d4ef243-d8c1-540d-9f11-38df46f54c9f-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
 import { IPromptsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService.service';
+import { isGithubTarget } from './promptValidator.js';
 
 let PromptDocumentSemanticTokensProvider = class PromptDocumentSemanticTokensProvider {
     constructor(promptsService) {
@@ -13,11 +14,14 @@ let PromptDocumentSemanticTokensProvider = class PromptDocumentSemanticTokensPro
         if (!promptType) {
             return undefined;
         }
-        const parser = this.promptsService.getParsedPromptFile(model);
-        if (!parser.body) {
+        const promptAST = this.promptsService.getParsedPromptFile(model);
+        if (!promptAST.body) {
             return undefined;
         }
-        const variableReferences = parser.body.variableReferences;
+        if (isGithubTarget(promptType, promptAST.header?.target)) {
+            return undefined;
+        }
+        const variableReferences = promptAST.body.variableReferences;
         if (!variableReferences.length) {
             return undefined;
         }
@@ -28,9 +32,10 @@ let PromptDocumentSemanticTokensProvider = class PromptDocumentSemanticTokensPro
             ? a.range.startColumn - b.range.startColumn
             : a.range.startLineNumber - b.range.startLineNumber);
         for (const ref of ordered) {
+            const extraCharCount = '#tool:'.length;
             const line = ref.range.startLineNumber - 1;
-            const char = ref.range.startColumn - 2;
-            const length = ref.range.endColumn - ref.range.startColumn + 1;
+            const char = ref.range.startColumn - extraCharCount - 1;
+            const length = ref.range.endColumn - ref.range.startColumn + extraCharCount;
             const deltaLine = line - lastLine;
             const deltaChar = deltaLine === 0 ? char - lastChar : char;
             data.push(deltaLine, deltaChar, length, 0 , 0 );

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/languageProviders/promptHeaderAutocompletion.d.ts

@@ -25,9 +25,8 @@ export declare class PromptHeaderAutocompletion implements CompletionItemProvide
      * completion items based on the provided arguments.
      */
     provideCompletionItems(model: ITextModel, position: Position, context: CompletionContext, token: CancellationToken): Promise<CompletionList | undefined>;
-    private providePropertyCompletions;
+    private provideAttributeNameCompletions;
     private provideValueCompletions;
-    private removeUsedProperties;
     private getValueSuggestions;
     private getModelNames;
     private provideToolCompletions;

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/languageProviders/promptHeaderAutocompletion.js

@@ -8,10 +8,12 @@ import { ILanguageModelChatMetadata } from '@codingame/monaco-vscode-api/vscode/
 import { ILanguageModelsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/languageModels.service';
 import { ILanguageModelToolsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/languageModelToolsService.service';
 import { IChatModeService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatModes.service';
-import { getPromptsTypeForLanguageId, PromptsType } from '@codingame/monaco-vscode-e28ac690-06d5-5ee9-92d1-02df70296354-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
+import { getPromptsTypeForLanguageId, PromptsType } from '@codingame/monaco-vscode-8d4ef243-d8c1-540d-9f11-38df46f54c9f-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
 import { IPromptsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService.service';
 import { Iterable } from '@codingame/monaco-vscode-api/vscode/vs/base/common/iterator';
-import { getValidAttributeNames } from './promptValidator.js';
+import { PromptHeaderAttributes } from '@codingame/monaco-vscode-8d4ef243-d8c1-540d-9f11-38df46f54c9f-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptFileParser';
+import { isGithubTarget, getValidAttributeNames, knownGithubCopilotTools } from './promptValidator.js';
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
 
 let PromptHeaderAutocompletion = class PromptHeaderAutocompletion {
     constructor(promptsService, languageModelsService, languageModelToolsService, chatModeService) {
@@ -27,12 +29,12 @@ let PromptHeaderAutocompletion = class PromptHeaderAutocompletion {
         if (!promptType) {
             return undefined;
         }
-        const parser = this.promptsService.getParsedPromptFile(model);
-        const header = parser.header;
+        const parsedAST = this.promptsService.getParsedPromptFile(model);
+        const header = parsedAST.header;
         if (!header) {
             return undefined;
         }
-        const headerRange = parser.header.range;
+        const headerRange = parsedAST.header.range;
         if (position.lineNumber < headerRange.startLineNumber || position.lineNumber >= headerRange.endLineNumber) {
             return undefined;
         }
@@ -40,34 +42,37 @@ let PromptHeaderAutocompletion = class PromptHeaderAutocompletion {
         const colonIndex = lineText.indexOf(':');
         const colonPosition = colonIndex !== -1 ? ( new Position(position.lineNumber, colonIndex + 1)) : undefined;
         if (!colonPosition || position.isBeforeOrEqual(colonPosition)) {
-            return this.providePropertyCompletions(model, position, headerRange, colonPosition, promptType);
+            return this.provideAttributeNameCompletions(model, position, header, colonPosition, promptType);
         }
         else if (colonPosition && colonPosition.isBefore(position)) {
             return this.provideValueCompletions(model, position, header, colonPosition, promptType);
         }
         return undefined;
     }
-    async providePropertyCompletions(model, position, headerRange, colonPosition, promptType) {
+    async provideAttributeNameCompletions(model, position, header, colonPosition, promptType) {
         const suggestions = [];
-        const supportedProperties = ( new Set(getValidAttributeNames(promptType, false)));
-        this.removeUsedProperties(supportedProperties, model, headerRange, position);
-        const getInsertText = (property) => {
+        const isGitHubTarget = isGithubTarget(promptType, header.target);
+        const attributesToPropose = ( new Set(getValidAttributeNames(promptType, false, isGitHubTarget)));
+        for (const attr of header.attributes) {
+            attributesToPropose.delete(attr.key);
+        }
+        const getInsertText = (key) => {
             if (colonPosition) {
-                return property;
+                return key;
             }
-            const valueSuggestions = this.getValueSuggestions(promptType, property);
+            const valueSuggestions = this.getValueSuggestions(promptType, key);
             if (valueSuggestions.length > 0) {
-                return `${property}: \${0:${valueSuggestions[0]}}`;
+                return `${key}: \${0:${valueSuggestions[0]}}`;
             }
             else {
-                return `${property}: \$0`;
+                return `${key}: \$0`;
             }
         };
-        for (const property of supportedProperties) {
+        for (const attribute of attributesToPropose) {
             const item = {
-                label: property,
+                label: attribute,
                 kind: CompletionItemKind.Property,
-                insertText: getInsertText(property),
+                insertText: getInsertText(attribute),
                 insertTextRules: CompletionItemInsertTextRule.InsertAsSnippet,
                 range: ( new Range(
                     position.lineNumber,
@@ -83,12 +88,13 @@ let PromptHeaderAutocompletion = class PromptHeaderAutocompletion {
     async provideValueCompletions(model, position, header, colonPosition, promptType) {
         const suggestions = [];
         const lineContent = model.getLineContent(position.lineNumber);
-        const property = lineContent.substring(0, colonPosition.column - 1).trim();
-        if (!getValidAttributeNames(promptType, true).includes(property)) {
+        const attribute = lineContent.substring(0, colonPosition.column - 1).trim();
+        const isGitHubTarget = isGithubTarget(promptType, header.target);
+        if (!getValidAttributeNames(promptType, true, isGitHubTarget).includes(attribute)) {
             return undefined;
         }
-        if (promptType === PromptsType.prompt || promptType === PromptsType.mode) {
-            const result = this.provideToolCompletions(model, position, header);
+        if (promptType === PromptsType.prompt || promptType === PromptsType.agent) {
+            const result = this.provideToolCompletions(model, position, header, isGitHubTarget);
             if (result) {
                 return result;
             }
@@ -98,7 +104,7 @@ let PromptHeaderAutocompletion = class PromptHeaderAutocompletion {
             return undefined;
         }
         const whilespaceAfterColon = (lineContent.substring(colonPosition.column).match(/^\s*/)?.[0].length) ?? 0;
-        const values = this.getValueSuggestions(promptType, property);
+        const values = this.getValueSuggestions(promptType, attribute);
         for (const value of values) {
             const item = {
                 label: value,
@@ -113,37 +119,60 @@ let PromptHeaderAutocompletion = class PromptHeaderAutocompletion {
             };
             suggestions.push(item);
         }
+        if (attribute === PromptHeaderAttributes.handOffs && (promptType === PromptsType.agent)) {
+            const value = [
+                '',
+                '  - label: Start Implementation',
+                '    agent: agent',
+                '    prompt: Implement the plan',
+                '    send: true'
+            ].join('\n');
+            const item = {
+                label: ( localize(5844, "Handoff Example")),
+                kind: CompletionItemKind.Value,
+                insertText: whilespaceAfterColon === 0 ? ` ${value}` : value,
+                range: ( new Range(
+                    position.lineNumber,
+                    colonPosition.column + whilespaceAfterColon + 1,
+                    position.lineNumber,
+                    model.getLineMaxColumn(position.lineNumber)
+                )),
+            };
+            suggestions.push(item);
+        }
         return { suggestions };
     }
-    removeUsedProperties(properties, model, headerRange, position) {
-        for (let i = headerRange.startLineNumber; i <= headerRange.endLineNumber; i++) {
-            if (i !== position.lineNumber) {
-                const lineText = model.getLineContent(i);
-                const colonIndex = lineText.indexOf(':');
-                if (colonIndex !== -1) {
-                    const property = lineText.substring(0, colonIndex).trim();
-                    properties.delete(property);
+    getValueSuggestions(promptType, attribute) {
+        switch (attribute) {
+            case PromptHeaderAttributes.applyTo:
+                if (promptType === PromptsType.instructions) {
+                    return [`'**'`, `'**/*.ts, **/*.js'`, `'**/*.php'`, `'**/*.py'`];
+                }
+                break;
+            case PromptHeaderAttributes.agent:
+            case PromptHeaderAttributes.mode:
+                if (promptType === PromptsType.prompt) {
+                    const agents = this.chatModeService.getModes();
+                    const suggestions = [];
+                    for (const agent of Iterable.concat(agents.builtin, agents.custom)) {
+                        suggestions.push(agent.name.get());
+                    }
+                    return suggestions;
+                }
+            case PromptHeaderAttributes.target:
+                if (promptType === PromptsType.agent) {
+                    return ['vscode', 'github-copilot'];
+                }
+                break;
+            case PromptHeaderAttributes.tools:
+                if (promptType === PromptsType.prompt || promptType === PromptsType.agent) {
+                    return ['[]', `['search', 'edit', 'fetch']`];
+                }
+                break;
+            case PromptHeaderAttributes.model:
+                if (promptType === PromptsType.prompt || promptType === PromptsType.agent) {
+                    return this.getModelNames(promptType === PromptsType.agent);
                 }
-            }
-        }
-    }
-    getValueSuggestions(promptType, property) {
-        if (promptType === PromptsType.instructions && property === 'applyTo') {
-            return [`'**'`, `'**/*.ts, **/*.js'`, `'**/*.php'`, `'**/*.py'`];
-        }
-        if (promptType === PromptsType.prompt && property === 'mode') {
-            const modes = this.chatModeService.getModes();
-            const suggestions = [];
-            for (const mode of Iterable.concat(modes.builtin, modes.custom)) {
-                suggestions.push(mode.name);
-            }
-            return suggestions;
-        }
-        if (property === 'tools' && (promptType === PromptsType.prompt || promptType === PromptsType.mode)) {
-            return ['[]', `['search', 'edit', 'fetch']`];
-        }
-        if (property === 'model' && (promptType === PromptsType.prompt || promptType === PromptsType.mode)) {
-            return this.getModelNames(promptType === PromptsType.mode);
         }
         return [];
     }
@@ -159,14 +188,15 @@ let PromptHeaderAutocompletion = class PromptHeaderAutocompletion {
         }
         return result;
     }
-    provideToolCompletions(model, position, header) {
-        const toolsAttr = header.getAttribute('tools');
+    provideToolCompletions(model, position, header, isGitHubTarget) {
+        const toolsAttr = header.getAttribute(PromptHeaderAttributes.tools);
         if (!toolsAttr || toolsAttr.value.type !== 'array' || !toolsAttr.range.containsPosition(position)) {
             return undefined;
         }
         const getSuggestions = (toolRange) => {
             const suggestions = [];
-            for (const toolName of this.languageModelToolsService.getQualifiedToolNames()) {
+            const toolNames = isGitHubTarget ? ( Object.keys(knownGithubCopilotTools)) : this.languageModelToolsService.getQualifiedToolNames();
+            for (const toolName of toolNames) {
                 let insertText;
                 if (!toolRange.isEmpty()) {
                     const firstChar = model.getValueInRange(toolRange).charCodeAt(0);

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/languageProviders/promptHovers.d.ts

@@ -24,5 +24,6 @@ export declare class PromptHoverProvider implements HoverProvider {
     private getToolHoverByName;
     private getToolsetHover;
     private getModelHover;
-    private getModeHover;
+    private getAgentHover;
+    private getHandsOffHover;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/languageProviders/promptHovers.js

@@ -6,10 +6,12 @@ import { ILanguageModelChatMetadata } from '@codingame/monaco-vscode-api/vscode/
 import { ILanguageModelsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/languageModels.service';
 import { ToolSet } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/languageModelToolsService';
 import { ILanguageModelToolsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/languageModelToolsService.service';
-import { isBuiltinChatMode } from '@codingame/monaco-vscode-c2deffc4-ad68-5e63-8f95-9b89e0fc6898-common/vscode/vs/workbench/contrib/chat/common/chatModes';
+import { isBuiltinChatMode } from '@codingame/monaco-vscode-2339d6ac-d6bb-53cd-95ee-81911735d1c7-common/vscode/vs/workbench/contrib/chat/common/chatModes';
 import { IChatModeService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatModes.service';
-import { getPromptsTypeForLanguageId, PromptsType } from '@codingame/monaco-vscode-e28ac690-06d5-5ee9-92d1-02df70296354-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
+import { getPromptsTypeForLanguageId, PromptsType } from '@codingame/monaco-vscode-8d4ef243-d8c1-540d-9f11-38df46f54c9f-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
 import { IPromptsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService.service';
+import { PromptHeaderAttributes, Target } from '@codingame/monaco-vscode-8d4ef243-d8c1-540d-9f11-38df46f54c9f-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptFileParser';
+import { isGithubTarget, knownGithubCopilotTools } from './promptValidator.js';
 
 let PromptHoverProvider = class PromptHoverProvider {
     constructor(promptsService, languageModelToolsService, languageModelsService, chatModeService) {
@@ -30,12 +32,12 @@ let PromptHoverProvider = class PromptHoverProvider {
         if (!promptType) {
             return undefined;
         }
-        const parser = this.promptsService.getParsedPromptFile(model);
-        if (parser.header?.range.containsPosition(position)) {
-            return this.provideHeaderHover(position, promptType, parser.header);
+        const promptAST = this.promptsService.getParsedPromptFile(model);
+        if (promptAST.header?.range.containsPosition(position)) {
+            return this.provideHeaderHover(position, promptType, promptAST.header);
         }
-        if (parser.body?.range.containsPosition(position)) {
-            return this.provideBodyHover(position, parser.body);
+        if (promptAST.body?.range.containsPosition(position)) {
+            return this.provideBodyHover(position, promptAST.body);
         }
         return undefined;
     }
@@ -50,66 +52,112 @@ let PromptHoverProvider = class PromptHoverProvider {
     }
     async provideHeaderHover(position, promptType, header) {
         if (promptType === PromptsType.instructions) {
-            const descriptionRange = header.getAttribute('description')?.range;
-            if (descriptionRange?.containsPosition(position)) {
-                return this.createHover(( localize(
-                    5638,
-                    'The description of the instruction file. It can be used to provide additional context or information about the instructions and is passed to the language model as part of the prompt.'
-                )), descriptionRange);
-            }
-            const applyToRange = header.getAttribute('applyTo')?.range;
-            if (applyToRange?.containsPosition(position)) {
-                return this.createHover(( localize(
-                    5639,
-                    'One or more glob pattern (separated by comma) that describe for which files the instructions apply to. Based on these patterns, the file is automatically included in the prompt, when the context contains a file that matches one or more of these patterns. Use `**` when you want this file to always be added.\nExample: `**/*.ts`, `**/*.js`, `client/**`'
-                )), applyToRange);
+            for (const attribute of header.attributes) {
+                if (attribute.range.containsPosition(position)) {
+                    switch (attribute.key) {
+                        case PromptHeaderAttributes.name:
+                            return this.createHover(( localize(
+                                5845,
+                                'The name of the instruction file as shown in the UI. If not set, the name is derived from the file name.'
+                            )), attribute.range);
+                        case PromptHeaderAttributes.description:
+                            return this.createHover(( localize(
+                                5846,
+                                'The description of the instruction file. It can be used to provide additional context or information about the instructions and is passed to the language model as part of the prompt.'
+                            )), attribute.range);
+                        case PromptHeaderAttributes.applyTo:
+                            return this.createHover(( localize(
+                                5847,
+                                'One or more glob pattern (separated by comma) that describe for which files the instructions apply to. Based on these patterns, the file is automatically included in the prompt, when the context contains a file that matches one or more of these patterns. Use `**` when you want this file to always be added.\nExample: `**/*.ts`, `**/*.js`, `client/**`'
+                            )), attribute.range);
+                    }
+                }
             }
         }
-        else if (promptType === PromptsType.mode) {
-            const descriptionRange = header.getAttribute('description')?.range;
-            if (descriptionRange?.containsPosition(position)) {
-                return this.createHover(( localize(
-                    5640,
-                    'The description of the mode file. It can be used to provide additional context or information about the mode to the mode author.'
-                )), descriptionRange);
-            }
-            const model = header.getAttribute('model');
-            if (model?.range.containsPosition(position)) {
-                return this.getModelHover(model, model.range, ( localize(5641, 'The model to use in this mode.')));
-            }
-            const tools = header.getAttribute('tools');
-            if (tools?.range.containsPosition(position)) {
-                return this.getToolHover(tools, position, ( localize(5642, 'The tools to use in this mode.')));
+        else if (promptType === PromptsType.agent) {
+            const isGitHubTarget = isGithubTarget(promptType, header.target);
+            for (const attribute of header.attributes) {
+                if (attribute.range.containsPosition(position)) {
+                    switch (attribute.key) {
+                        case PromptHeaderAttributes.name:
+                            return this.createHover(( localize(5848, 'The name of the agent as shown in the UI.')), attribute.range);
+                        case PromptHeaderAttributes.description:
+                            return this.createHover(( localize(
+                                5849,
+                                'The description of the custom agent, what it does and when to use it.'
+                            )), attribute.range);
+                        case PromptHeaderAttributes.argumentHint:
+                            return this.createHover(( localize(
+                                5850,
+                                'The argument-hint describes what inputs the custom agent expects or supports.'
+                            )), attribute.range);
+                        case PromptHeaderAttributes.model:
+                            return this.getModelHover(attribute, attribute.range, ( localize(5851, 'Specify the model that runs this custom agent.')), isGitHubTarget);
+                        case PromptHeaderAttributes.tools:
+                            return this.getToolHover(attribute, position, ( localize(5852, 'The set of tools that the custom agent has access to.')), header.target);
+                        case PromptHeaderAttributes.handOffs:
+                            return this.getHandsOffHover(attribute, position, isGitHubTarget);
+                        case PromptHeaderAttributes.target:
+                            return this.createHover(( localize(
+                                5853,
+                                'The target to which the header attributes like tools apply to. Possible values are `github-copilot` and `vscode`.'
+                            )), attribute.range);
+                    }
+                }
             }
         }
         else {
-            const descriptionRange = header.getAttribute('description')?.range;
-            if (descriptionRange?.containsPosition(position)) {
-                return this.createHover(( localize(
-                    5643,
-                    'The description of the prompt file. It can be used to provide additional context or information about the prompt to the prompt author.'
-                )), descriptionRange);
-            }
-            const model = header.getAttribute('model');
-            if (model?.range.containsPosition(position)) {
-                return this.getModelHover(model, model.range, ( localize(5644, 'The model to use in this prompt.')));
-            }
-            const tools = header.getAttribute('tools');
-            if (tools?.range.containsPosition(position)) {
-                return this.getToolHover(tools, position, ( localize(5645, 'The tools to use in this prompt.')));
-            }
-            const mode = header.getAttribute('mode');
-            if (mode?.range.containsPosition(position)) {
-                return this.getModeHover(mode, position, ( localize(5646, 'The mode to use in this prompt.')));
+            for (const attribute of header.attributes) {
+                if (attribute.range.containsPosition(position)) {
+                    switch (attribute.key) {
+                        case PromptHeaderAttributes.name:
+                            return this.createHover(( localize(
+                                5854,
+                                'The name of the prompt. This is also the name of the slash command that will run this prompt.'
+                            )), attribute.range);
+                        case PromptHeaderAttributes.description:
+                            return this.createHover(( localize(
+                                5855,
+                                'The description of the reusable prompt, what it does and when to use it.'
+                            )), attribute.range);
+                        case PromptHeaderAttributes.argumentHint:
+                            return this.createHover(( localize(
+                                5856,
+                                'The argument-hint describes what inputs the prompt expects or supports.'
+                            )), attribute.range);
+                        case PromptHeaderAttributes.model:
+                            return this.getModelHover(attribute, attribute.range, ( localize(5857, 'The model to use in this prompt.')), false);
+                        case PromptHeaderAttributes.tools:
+                            return this.getToolHover(attribute, position, ( localize(5858, 'The tools to use in this prompt.')), Target.VSCode);
+                        case PromptHeaderAttributes.agent:
+                        case PromptHeaderAttributes.mode:
+                            return this.getAgentHover(attribute, position);
+                    }
+                }
             }
         }
         return undefined;
     }
-    getToolHover(node, position, baseMessage) {
+    getToolHover(node, position, baseMessage, target) {
         if (node.value.type === 'array') {
             for (const toolName of node.value.items) {
                 if (toolName.type === 'string' && toolName.range.containsPosition(position)) {
-                    return this.getToolHoverByName(toolName.value, toolName.range);
+                    let toolNameValue = toolName.value;
+                    if (target === undefined) {
+                        toolNameValue = this.languageModelToolsService.mapGithubToolName(toolNameValue);
+                    }
+                    if (target === Target.VSCode || target === undefined) {
+                        const description = this.getToolHoverByName(toolNameValue, toolName.range);
+                        if (description) {
+                            return description;
+                        }
+                    }
+                    if (target === Target.GitHubCopilot || target === undefined) {
+                        const description = knownGithubCopilotTools[toolNameValue];
+                        if (description) {
+                            return this.createHover(description, toolName.range);
+                        }
+                    }
                 }
             }
         }
@@ -122,14 +170,14 @@ let PromptHoverProvider = class PromptHoverProvider {
                 return this.getToolsetHover(tool, range);
             }
             else {
-                return this.createHover(tool.modelDescription, range);
+                return this.createHover(tool.userDescription ?? tool.modelDescription, range);
             }
         }
         return undefined;
     }
     getToolsetHover(toolSet, range) {
         const lines = [];
-        lines.push(( localize(5647, 'ToolSet: {0}\n\n', toolSet.referenceName)));
+        lines.push(( localize(5859, 'ToolSet: {0}\n\n', toolSet.referenceName)));
         if (toolSet.description) {
             lines.push(toolSet.description);
         }
@@ -138,16 +186,19 @@ let PromptHoverProvider = class PromptHoverProvider {
         }
         return this.createHover(lines.join('\n'), range);
     }
-    getModelHover(node, range, baseMessage) {
+    getModelHover(node, range, baseMessage, isGitHubTarget) {
+        if (isGitHubTarget) {
+            return this.createHover(baseMessage + '\n\n' + ( localize(5860, 'Note: This attribute is not used when target is github-copilot.')), range);
+        }
         if (node.value.type === 'string') {
             for (const id of this.languageModelsService.getLanguageModelIds()) {
                 const meta = this.languageModelsService.lookupLanguageModel(id);
                 if (meta && ILanguageModelChatMetadata.matchesQualifiedName(node.value.value, meta)) {
                     const lines = [];
                     lines.push(baseMessage + '\n');
-                    lines.push(( localize(5648, '- Name: {0}', meta.name)));
-                    lines.push(( localize(5649, '- Family: {0}', meta.family)));
-                    lines.push(( localize(5650, '- Vendor: {0}', meta.vendor)));
+                    lines.push(( localize(5861, '- Name: {0}', meta.name)));
+                    lines.push(( localize(5862, '- Family: {0}', meta.family)));
+                    lines.push(( localize(5863, '- Vendor: {0}', meta.vendor)));
                     if (meta.tooltip) {
                         lines.push('', '', meta.tooltip);
                     }
@@ -157,34 +208,41 @@ let PromptHoverProvider = class PromptHoverProvider {
         }
         return this.createHover(baseMessage, range);
     }
-    getModeHover(mode, position, baseMessage) {
+    getAgentHover(agentAttribute, position) {
         const lines = [];
-        const value = mode.value;
+        const value = agentAttribute.value;
         if (value.type === 'string' && value.range.containsPosition(position)) {
-            const mode = this.chatModeService.findModeByName(value.value);
-            if (mode) {
-                const description = mode.description.get() || (isBuiltinChatMode(mode) ? ( localize(5651, 'Built-in chat mode')) : ( localize(5652, 'Custom chat mode')));
-                lines.push(`\`${mode.name}\`: ${description}`);
+            const agent = this.chatModeService.findModeByName(value.value);
+            if (agent) {
+                const description = agent.description.get() || (isBuiltinChatMode(agent) ? ( localize(5864, 'Built-in agent')) : ( localize(5865, 'Custom agent')));
+                lines.push(`\`${agent.name.get()}\`: ${description}`);
             }
         }
         else {
-            const modes = this.chatModeService.getModes();
-            lines.push(( localize(5653, 'The chat mode to use when running this prompt.')));
+            const agents = this.chatModeService.getModes();
+            lines.push(( localize(5866, 'The agent to use when running this prompt.')));
             lines.push('');
-            lines.push(( localize(5654, '**Built-in modes:**')));
-            for (const mode of modes.builtin) {
-                lines.push(`- \`${mode.name}\`: ${mode.description.get() || mode.label}`);
+            lines.push(( localize(5867, '**Built-in agents:**')));
+            for (const agent of agents.builtin) {
+                lines.push(`- \`${agent.name.get()}\`: ${agent.description.get() || agent.label.get()}`);
             }
-            if (modes.custom.length > 0) {
+            if (agents.custom.length > 0) {
                 lines.push('');
-                lines.push(( localize(5655, '**Custom modes:**')));
-                for (const mode of modes.custom) {
-                    const description = mode.description.get();
-                    lines.push(`- \`${mode.name}\`: ${description || ( localize(5652, 'Custom chat mode'))}`);
+                lines.push(( localize(5868, '**Custom agents:**')));
+                for (const agent of agents.custom) {
+                    const description = agent.description.get();
+                    lines.push(`- \`${agent.name.get()}\`: ${description || ( localize(5865, 'Custom agent'))}`);
                 }
             }
         }
-        return this.createHover(lines.join('\n'), mode.range);
+        return this.createHover(lines.join('\n'), agentAttribute.range);
+    }
+    getHandsOffHover(attribute, position, isGitHubTarget) {
+        const handoffsBaseMessage = ( localize(5869, 'Possible handoff actions when the agent has completed its task.'));
+        if (isGitHubTarget) {
+            return this.createHover(handoffsBaseMessage + '\n\n' + ( localize(5870, 'Note: This attribute is not used when target is github-copilot.')), attribute.range);
+        }
+        return this.createHover(handoffsBaseMessage, attribute.range);
     }
 };
 PromptHoverProvider = ( __decorate([

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/languageProviders/promptLinkProvider.js

@@ -7,14 +7,14 @@ let PromptLinkProvider = class PromptLinkProvider {
         this.promptsService = promptsService;
     }
     async provideLinks(model, token) {
-        const parser = this.promptsService.getParsedPromptFile(model);
-        if (!parser.body) {
+        const promptAST = this.promptsService.getParsedPromptFile(model);
+        if (!promptAST.body) {
             return;
         }
         const links = [];
-        for (const ref of parser.body.fileReferences) {
+        for (const ref of promptAST.body.fileReferences) {
             if (!ref.isMarkdownLink) {
-                const url = parser.body.resolveFilePath(ref.content);
+                const url = promptAST.body.resolveFilePath(ref.content);
                 if (url) {
                     links.push({ range: ref.range, url });
                 }