@codingame/monaco-vscode-chat-service-override 37.1.0 → 37.3.0

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

@@ -0,0 +1,698 @@
+
+import { __decorate, __param } from '@codingame/monaco-vscode-api/external/tslib/tslib.es6';
+import { splitGlobAware, match } from '@codingame/monaco-vscode-api/vscode/vs/base/common/glob';
+import { ResourceMap, ResourceSet } from '@codingame/monaco-vscode-api/vscode/vs/base/common/map';
+import { Schemas } from '@codingame/monaco-vscode-api/vscode/vs/base/common/network';
+import { OperatingSystem } from '@codingame/monaco-vscode-api/vscode/vs/base/common/platform';
+import { basename, dirname } from '@codingame/monaco-vscode-api/vscode/vs/base/common/resources';
+import { escape } from '@codingame/monaco-vscode-api/vscode/vs/base/common/strings';
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { IConfigurationService } from '@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service';
+import { IFileService } from '@codingame/monaco-vscode-api/vscode/vs/platform/files/common/files.service';
+import { ILabelService } from '@codingame/monaco-vscode-api/vscode/vs/platform/label/common/label.service';
+import { ILogService } from '@codingame/monaco-vscode-api/vscode/vs/platform/log/common/log.service';
+import { IRemoteAgentService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/services/remote/common/remoteAgentService.service';
+import { ITelemetryService } from '@codingame/monaco-vscode-api/vscode/vs/platform/telemetry/common/telemetry.service';
+import { IWorkspaceContextService } from '@codingame/monaco-vscode-api/vscode/vs/platform/workspace/common/workspace.service';
+import { toPromptFileVariableEntry, PromptFileVariableKind, isPromptFileVariableEntry, IChatRequestVariableEntry, ChatRequestVariableSet, toToolVariableEntry, toPromptTextVariableEntry } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/attachments/chatVariableEntries';
+import { VSCodeToolReference } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/tools/languageModelToolsService';
+import { ILanguageModelToolsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/tools/languageModelToolsService.service';
+import { PromptsConfig } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/config/config';
+import { isInClaudeRulesFolder, isInClaudeAgentsFolder, isPromptOrInstructionsFile } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/config/promptFileLocations';
+import { isPromptFileTildePath } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptFileParser';
+import { newInstructionsCollectionEvent, newInstructionsCollectionDebugInfo, matchesSessionType, AgentInstructionFileType } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService';
+export { newInstructionsCollectionDebugInfo, newInstructionsCollectionEvent } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService';
+import { IPromptsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService.service';
+import { AGENT_DEBUG_LOG_FILE_LOGGING_ENABLED_SETTING, TROUBLESHOOT_SKILL_PATH } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
+import { OffsetRange } from '@codingame/monaco-vscode-api/vscode/vs/editor/common/core/ranges/offsetRange';
+import { ChatModeKind } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/constants';
+import { hash } from '@codingame/monaco-vscode-api/vscode/vs/base/common/hash';
+import { IAgentPluginService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/plugins/agentPluginService.service';
+import { IPathService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/services/path/common/pathService.service';
+
+let lastInstructionsCollectionResult;
+let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
+    constructor(
+        _modeKind,
+        _enabledTools,
+        _enabledSubagents,
+        _currentSessionType,
+        _promptsService,
+        _logService,
+        _labelService,
+        _configurationService,
+        _workspaceService,
+        _fileService,
+        _remoteAgentService,
+        _telemetryService,
+        _languageModelToolsService,
+        _agentPluginService,
+        _pathService
+    ) {
+        this._modeKind = _modeKind;
+        this._enabledTools = _enabledTools;
+        this._enabledSubagents = _enabledSubagents;
+        this._currentSessionType = _currentSessionType;
+        this._promptsService = _promptsService;
+        this._logService = _logService;
+        this._labelService = _labelService;
+        this._configurationService = _configurationService;
+        this._workspaceService = _workspaceService;
+        this._fileService = _fileService;
+        this._remoteAgentService = _remoteAgentService;
+        this._telemetryService = _telemetryService;
+        this._languageModelToolsService = _languageModelToolsService;
+        this._agentPluginService = _agentPluginService;
+        this._pathService = _pathService;
+        this._parseResults = ( new ResourceMap());
+    }
+    async _parseInstructionsFile(uri, token) {
+        if (( this._parseResults.has(uri))) {
+            return this._parseResults.get(uri);
+        }
+        try {
+            const result = await this._promptsService.parseNew(uri, token);
+            this._parseResults.set(uri, result);
+            return result;
+        } catch (error) {
+            this._logService.error(
+                `[InstructionsContextComputer] Failed to parse instruction file: ${uri}`,
+                error
+            );
+            return undefined;
+        }
+    }
+    async collect(variables, token) {
+        const startTime = performance.now();
+        const instructionFiles = await this._promptsService.getInstructionFiles(token);
+        this._logService.trace(
+            `[InstructionsContextComputer] ${instructionFiles.length} instruction files available.`
+        );
+        const telemetryEvent = newInstructionsCollectionEvent();
+        const debugInfo = newInstructionsCollectionDebugInfo();
+        const context = this._getContext(variables);
+        await this.addApplyingInstructions(instructionFiles, context, variables, telemetryEvent, debugInfo, token);
+        await this._addReferencedInstructions(variables, telemetryEvent, debugInfo, token);
+        await this._addAgentInstructions(variables, telemetryEvent, debugInfo, token);
+        const customizationsIndexVariable = await this._getCustomizationsIndex(instructionFiles, variables, telemetryEvent, debugInfo, token);
+        if (customizationsIndexVariable) {
+            variables.add(customizationsIndexVariable);
+            telemetryEvent.listedInstructionsCount++;
+        }
+        debugInfo.durationInMillis = performance.now() - startTime;
+        this.sendTelemetry(telemetryEvent);
+        lastInstructionsCollectionResult = {
+            telemetryEvent,
+            debugInfo
+        };
+    }
+    sendTelemetry(telemetryEvent) {
+        telemetryEvent.totalInstructionsCount = telemetryEvent.agentInstructionsCount + telemetryEvent.referencedInstructionsCount + telemetryEvent.applyingInstructionsCount + telemetryEvent.listedInstructionsCount;
+        this._telemetryService.publicLog2("instructionsCollected", telemetryEvent);
+    }
+    async _logSkillLoadedTelemetry(skills) {
+        try {
+            const pluginByUri = ( new ResourceMap());
+            const allPlugins = this._agentPluginService.plugins.get();
+            for (const plugin of allPlugins) {
+                pluginByUri.set(plugin.uri, plugin);
+            }
+            const hashOrEmpty = value => {
+                return value !== undefined ? String(hash(value)) : "";
+            };
+            for (const skill of skills) {
+                const skillPlugin = skill.pluginUri ? pluginByUri.get(skill.pluginUri) : undefined;
+                this._telemetryService.publicLog2("skillLoadedIntoContext", {
+                    skillNameHash: hashOrEmpty(skill.name),
+                    skillStorage: skill.storage,
+                    extensionIdHash: hashOrEmpty(skill.extension?.identifier.value),
+                    extensionVersion: skill.extension?.version ?? "",
+                    pluginNameHash: hashOrEmpty(skillPlugin?.label),
+                    pluginVersion: skillPlugin?.fromMarketplace?.version ?? ""
+                });
+            }
+        } catch (err) {
+            this._logService.error("[InstructionsContextComputer] Failed to log skill telemetry", err);
+        }
+    }
+    async addApplyingInstructions(instructionFiles, context, variables, telemetryEvent, debugInfo, token) {
+        const includeApplyingInstructions = this._configurationService.getValue(PromptsConfig.INCLUDE_APPLYING_INSTRUCTIONS);
+        if (!includeApplyingInstructions && this._modeKind !== ChatModeKind.Edit) {
+            this._logService.trace(
+                `[InstructionsContextComputer] includeApplyingInstructions is disabled and agent kind is not Edit. No applying instructions will be added.`
+            );
+            return;
+        }
+        const currentSessionType = this._currentSessionType;
+        for (const instructionFile of instructionFiles) {
+            if (token.isCancellationRequested) {
+                return;
+            }
+            const {
+                uri,
+                pattern
+            } = instructionFile;
+            if (!matchesSessionType(instructionFile.sessionTypes, currentSessionType)) {
+                continue;
+            }
+            if (!pattern) {
+                this._logService.trace(`[InstructionsContextComputer] No pattern (applyTo / paths) found: ${uri}`);
+                debugInfo.debugDetails.push({
+                    category: "skipped",
+                    name: ( basename(uri).toString()),
+                    uri,
+                    reason: ( localize(12531, "no applyTo pattern"))
+                });
+                continue;
+            }
+            const isClaudeRules = isInClaudeRulesFolder(uri);
+            if (( context.instructions.has(uri))) {
+                this._logService.trace(
+                    `[InstructionsContextComputer] Skipping already processed instruction file: ${uri}`
+                );
+                debugInfo.debugDetails.push({
+                    category: "skipped",
+                    name: ( basename(uri).toString()),
+                    uri,
+                    reason: ( localize(12532, "already processed"))
+                });
+                continue;
+            }
+            const match = this._matches(context.files, pattern);
+            if (match) {
+                this._logService.trace(
+                    `[InstructionsContextComputer] Match for ${uri} with ${match.pattern}${match.file ? ` for file ${match.file}` : ""}`
+                );
+                const reason = !match.file ? ( localize(12533, "automatically attached as pattern is **")) : ( localize(
+                    12534,
+                    "automatically attached as pattern {0} matches {1}",
+                    pattern,
+                    this._labelService.getUriLabel(match.file, {
+                        relative: true
+                    })
+                ));
+                variables.add(
+                    toPromptFileVariableEntry(uri, PromptFileVariableKind.Instruction, reason, true)
+                );
+                telemetryEvent.applyingInstructionsCount++;
+                debugInfo.debugDetails.push({
+                    category: "applying",
+                    name: ( basename(uri).toString()),
+                    uri,
+                    reason
+                });
+                if (isClaudeRules) {
+                    telemetryEvent.claudeRulesCount++;
+                }
+            } else {
+                this._logService.trace(`[InstructionsContextComputer] No match for ${uri} with ${pattern}`);
+                debugInfo.debugDetails.push({
+                    category: "skipped",
+                    name: ( basename(uri).toString()),
+                    uri,
+                    reason: ( localize(12535, "applyTo '{0}' did not match any attached files", pattern))
+                });
+            }
+        }
+    }
+    _getContext(attachedContext) {
+        const files = ( new ResourceSet());
+        const instructions = ( new ResourceSet());
+        for (const variable of attachedContext.asArray()) {
+            if (isPromptFileVariableEntry(variable)) {
+                instructions.add(variable.value);
+            } else {
+                const uri = IChatRequestVariableEntry.toUri(variable);
+                if (uri) {
+                    files.add(uri);
+                }
+            }
+        }
+        return {
+            files,
+            instructions
+        };
+    }
+    async _addAgentInstructions(variables, telemetryEvent, debugInfo, token) {
+        const logger = {
+            logInfo: message => this._logService.trace(`[InstructionsContextComputer] ${message}`)
+        };
+        const allCandidates = await this._promptsService.listAgentInstructions(token, logger);
+        const entries = ( new ChatRequestVariableSet());
+        const copilotEntries = ( new ChatRequestVariableSet());
+        for (const {
+            uri,
+            type
+        } of allCandidates) {
+            const varEntry = toPromptFileVariableEntry(uri, PromptFileVariableKind.Instruction, undefined, true);
+            entries.add(varEntry);
+            if (type === AgentInstructionFileType.copilotInstructionsMd) {
+                copilotEntries.add(varEntry);
+            }
+            telemetryEvent.agentInstructionsCount++;
+            if (type === AgentInstructionFileType.claudeMd) {
+                telemetryEvent.claudeMdCount++;
+            }
+            debugInfo.debugDetails.push({
+                category: "applying",
+                name: ( basename(uri).toString()),
+                uri,
+                reason: ( localize(12536, "always added"))
+            });
+            logger.logInfo(`Agent instruction file added: ${( uri.toString())}`);
+        }
+        if (copilotEntries.length > 0) {
+            await this._addReferencedInstructions(copilotEntries, telemetryEvent, debugInfo, token);
+            for (const entry of copilotEntries.asArray()) {
+                variables.add(entry);
+            }
+        }
+        for (const entry of entries.asArray()) {
+            variables.add(entry);
+        }
+    }
+    _matches(files, applyToPattern) {
+        const patterns = splitGlobAware(applyToPattern, ",");
+        const patterMatches = pattern => {
+            pattern = pattern.trim();
+            if (pattern.length === 0) {
+                return undefined;
+            }
+            if (pattern === "**" || pattern === "**/*" || pattern === "*") {
+                return {
+                    pattern
+                };
+            }
+            if (!pattern.startsWith("/") && !pattern.startsWith("**/")) {
+                pattern = "**/" + pattern;
+            }
+            for (const file of files) {
+                if (match(pattern, file.path, {
+                    ignoreCase: true
+                })) {
+                    return {
+                        pattern,
+                        file
+                    };
+                }
+            }
+            return undefined;
+        };
+        for (const pattern of patterns) {
+            const matchResult = patterMatches(pattern);
+            if (matchResult) {
+                return matchResult;
+            }
+        }
+        return undefined;
+    }
+    _getTool(referenceName) {
+        if (!this._enabledTools) {
+            return undefined;
+        }
+        const tool = this._languageModelToolsService.getToolByName(referenceName);
+        if (tool && this._enabledTools[tool.id]) {
+            return {
+                tool,
+                variable: `#tool:${this._languageModelToolsService.getFullReferenceName(tool)}`
+            };
+        }
+        return undefined;
+    }
+    async _getCustomizationsIndex(instructionFiles, _existingVariables, telemetryEvent, debugInfo, token) {
+        const readTool = this._getTool("readFile");
+        const runInTerminalTool = this._getTool("runInTerminal");
+        const fileReadTool = readTool ?? runInTerminalTool;
+        const runSubagentTool = this._getTool(VSCodeToolReference.runSubagent);
+        const skillTool = this._getTool("skill");
+        const currentSessionType = this._currentSessionType;
+        const remoteEnv = await this._remoteAgentService.getEnvironment();
+        const remoteOS = remoteEnv?.os;
+        const isRemote = this._remoteAgentService.getConnection() !== null;
+        const filePath = uri => getFilePath(uri, remoteOS, isRemote);
+        const entries = [];
+        if (fileReadTool) {
+            const searchNestedAgentMd = this._configurationService.getValue(PromptsConfig.USE_NESTED_AGENT_MD);
+            const agentsMdPromise = searchNestedAgentMd ? this._promptsService.listNestedAgentMDs(token) : Promise.resolve([]);
+            entries.push("<instructions>");
+            entries.push(
+                "Here is a list of instruction files that contain rules for working with this codebase."
+            );
+            entries.push(
+                "These files are important for understanding the codebase structure, conventions, and best practices."
+            );
+            entries.push(
+                "When an instruction file applies to your task (based on its description or applyTo pattern), follow the rules specified in it."
+            );
+            entries.push(
+                `If the file content is not already included in the context, use the ${fileReadTool.variable} tool to read it before proceeding. Use the exact value from the <file> element as-is with the tool; do not add or remove prefixes or otherwise modify it.`
+            );
+            entries.push(
+                "Only load instruction files when they are relevant to the current task. Do not eagerly load all instructions upfront."
+            );
+            entries.push(
+                "When modifying or creating files, check for instructions whose applyTo pattern matches the file path and follow them."
+            );
+            let hasContent = false;
+            for (const instruction of instructionFiles) {
+                if (!matchesSessionType(instruction.sessionTypes, currentSessionType)) {
+                    continue;
+                }
+                entries.push("<instruction>");
+                entries.push(`<file>${filePath(instruction.uri)}</file>`);
+                if (instruction.description) {
+                    entries.push(`<description>${escape(instruction.description)}</description>`);
+                }
+                if (instruction.pattern) {
+                    entries.push(`<applyTo>${escape(instruction.pattern)}</applyTo>`);
+                }
+                entries.push("</instruction>");
+                hasContent = true;
+            }
+            const agentsMdFiles = await agentsMdPromise;
+            for (const {
+                uri
+            } of agentsMdFiles) {
+                const folderName = this._labelService.getUriLabel(dirname(uri), {
+                    relative: true
+                });
+                const description = folderName.trim().length === 0 ? ( localize(12537, "Instructions for the workspace")) : ( localize(12538, "Instructions for folder '{0}'", folderName));
+                entries.push("<instruction>");
+                entries.push(`<file>${filePath(uri)}</file>`);
+                entries.push(`<description>${escape(description)}</description>`);
+                entries.push("</instruction>");
+                hasContent = true;
+            }
+            if (!hasContent) {
+                entries.length = 0;
+            } else {
+                entries.push("</instructions>", "", "");
+            }
+            const agentSkills = await this._promptsService.findAgentSkills(token);
+            const isFileLoggingEnabled = this._configurationService.getValue(AGENT_DEBUG_LOG_FILE_LOGGING_ENABLED_SETTING);
+            const modelInvocableSkills = agentSkills?.filter(skill => {
+                if (!skill.description) {
+                    debugInfo.debugDetails.push({
+                        category: "skipped",
+                        name: skill.name,
+                        uri: skill.uri,
+                        reason: ( localize(12539, "no description for model invocation"))
+                    });
+                    return false;
+                }
+                if (skill.disableModelInvocation) {
+                    debugInfo.debugDetails.push({
+                        category: "skipped",
+                        name: skill.name,
+                        uri: skill.uri,
+                        reason: ( localize(12540, "model invocation disabled"))
+                    });
+                    return false;
+                }
+                if (!matchesSessionType(skill.sessionTypes, currentSessionType)) {
+                    debugInfo.debugDetails.push({
+                        category: "skipped",
+                        name: skill.name,
+                        uri: skill.uri,
+                        reason: ( localize(12541, "session type not matched"))
+                    });
+                    return false;
+                }
+                if (!isFileLoggingEnabled && skill.uri.path.includes(TROUBLESHOOT_SKILL_PATH)) {
+                    debugInfo.debugDetails.push({
+                        category: "skipped",
+                        name: skill.name,
+                        uri: skill.uri,
+                        reason: ( localize(12542, "debug logging disabled"))
+                    });
+                    return false;
+                }
+                return true;
+            });
+            if (modelInvocableSkills && modelInvocableSkills.length > 0) {
+                this._logSkillLoadedTelemetry(modelInvocableSkills);
+                for (const skill of modelInvocableSkills) {
+                    debugInfo.debugDetails.push({
+                        category: "skill",
+                        name: skill.name,
+                        uri: skill.uri,
+                        reason: skill.storage
+                    });
+                }
+                const useSkillAdherencePrompt = this._configurationService.getValue(PromptsConfig.USE_SKILL_ADHERENCE_PROMPT);
+                const skillLoadTool = skillTool ?? fileReadTool;
+                entries.push("<skills>");
+                if (useSkillAdherencePrompt) {
+                    entries.push(
+                        "Skills provide specialized capabilities, domain knowledge, and refined workflows for producing high-quality outputs. Each skill folder contains tested instructions for specific domains like testing strategies, API design, or performance optimization. Multiple skills can be combined when a task spans different domains."
+                    );
+                    if (skillTool) {
+                        entries.push(
+                            `BLOCKING REQUIREMENT: When a skill applies to the user's request, you MUST invoke it IMMEDIATELY as your first action, BEFORE generating any other response or taking action on the task. Use ${skillTool.variable} with the skill name to load the relevant skill(s).`
+                        );
+                    } else {
+                        entries.push(
+                            `BLOCKING REQUIREMENT: When a skill applies to the user's request, you MUST load and read the SKILL.md file IMMEDIATELY as your first action, BEFORE generating any other response or taking action on the task. Use ${fileReadTool.variable} to load the relevant skill(s).`
+                        );
+                    }
+                    entries.push(
+                        "NEVER just mention or reference a skill in your response without actually loading it first. If a skill is relevant, load it before proceeding."
+                    );
+                    entries.push("How to determine if a skill applies:");
+                    entries.push(
+                        "1. Review the available skills below and match their descriptions against the user's request"
+                    );
+                    entries.push(
+                        "2. If any skill's domain overlaps with the task, load that skill immediately"
+                    );
+                    entries.push(
+                        "3. When multiple skills apply (e.g., a flowchart in documentation), load all relevant skills"
+                    );
+                    entries.push("Examples:");
+                    entries.push(
+                        `- "Help me write unit tests for this module" -> Load the testing skill via ${skillLoadTool.variable} FIRST, then proceed`
+                    );
+                    entries.push(
+                        `- "Optimize this slow function" -> Load the performance-profiling skill via ${skillLoadTool.variable} FIRST, then proceed`
+                    );
+                    entries.push(
+                        `- "Add a discount code field to checkout" -> Load both the checkout-flow and form-validation skills FIRST`
+                    );
+                    entries.push("Available skills:");
+                } else {
+                    if (skillTool) {
+                        entries.push(
+                            "Here is a list of skills that contain domain specific knowledge on a variety of topics."
+                        );
+                        entries.push(
+                            `When a user asks you to perform a task that falls within the domain of a skill, use the ${skillTool.variable} tool with the skill name to load it.`
+                        );
+                    } else {
+                        entries.push(
+                            "Here is a list of skills that contain domain specific knowledge on a variety of topics."
+                        );
+                        entries.push(
+                            "Each skill comes with a description of the topic and a file path that contains the detailed instructions."
+                        );
+                        entries.push(
+                            `When a user asks you to perform a task that falls within the domain of a skill, use the ${fileReadTool.variable} tool to acquire the full instructions from the file URI.`
+                        );
+                    }
+                }
+                const SKILL_DESCRIPTION_CHAR_BUDGET = 15000;
+                const TRUNCATED_NAMES_CHAR_BUDGET = 5000;
+                let skillCharCount = 0;
+                let truncatedAtIndex = modelInvocableSkills.length;
+                for (let i = 0; i < modelInvocableSkills.length; i++) {
+                    const skill = modelInvocableSkills[i];
+                    const skillEntry = [`<skill>`, `<name>${escape(skill.name)}</name>`];
+                    if (skill.description) {
+                        skillEntry.push(`<description>${escape(skill.description)}</description>`);
+                    }
+                    skillEntry.push(`<file>${filePath(skill.uri)}</file>`);
+                    skillEntry.push(`</skill>`);
+                    const entryLength = skillEntry.join("\n").length + 1;
+                    if (skillTool && skillCharCount + entryLength > SKILL_DESCRIPTION_CHAR_BUDGET) {
+                        truncatedAtIndex = i;
+                        break;
+                    }
+                    skillCharCount += entryLength;
+                    entries.push(...skillEntry);
+                }
+                if (truncatedAtIndex < modelInvocableSkills.length) {
+                    const truncatedSkills = modelInvocableSkills.slice(truncatedAtIndex);
+                    const names = [];
+                    let nameListLength = 0;
+                    for (const skill of truncatedSkills) {
+                        const escapedName = escape(skill.name);
+                        const addition = (names.length > 0 ? 2 : 0) + escapedName.length;
+                        if (nameListLength + addition > TRUNCATED_NAMES_CHAR_BUDGET) {
+                            break;
+                        }
+                        nameListLength += addition;
+                        names.push(escapedName);
+                    }
+                    const remaining = truncatedSkills.length - names.length;
+                    const nameList = names.join(", ");
+                    entries.push(
+                        remaining > 0 ? `Additional skills available (invoke by name): ${nameList}... and ${remaining} more` : `Additional skills available (invoke by name): ${nameList}`
+                    );
+                }
+                entries.push("</skills>", "", "");
+            }
+        }
+        if (runSubagentTool) {
+            const canUseAgent = (() => {
+                if (!this._enabledSubagents || this._enabledSubagents.includes("*")) {
+                    return agent => agent.visibility.agentInvocable && matchesSessionType(agent.sessionTypes, currentSessionType);
+                } else {
+                    const subagents = this._enabledSubagents;
+                    return agent => subagents.includes(agent.name) && matchesSessionType(agent.sessionTypes, currentSessionType);
+                }
+            })();
+            const agents = (await this._promptsService.getCustomAgents(token)).filter(a => a.enabled);
+            if (agents.length > 0) {
+                entries.push("<agents>");
+                entries.push("Here is a list of agents that can be used when running a subagent.");
+                entries.push(
+                    "Each agent has optionally a description with the agent's purpose and expertise. When asked to run a subagent, choose the most appropriate agent from this list."
+                );
+                entries.push(
+                    `Use the ${runSubagentTool.variable} tool with the agent name to run the subagent.`
+                );
+                for (const agent of agents) {
+                    if (canUseAgent(agent)) {
+                        entries.push("<agent>");
+                        entries.push(`<name>${escape(agent.name)}</name>`);
+                        if (agent.description) {
+                            entries.push(`<description>${escape(agent.description)}</description>`);
+                        }
+                        if (agent.argumentHint) {
+                            entries.push(`<argumentHint>${escape(agent.argumentHint)}</argumentHint>`);
+                        }
+                        entries.push("</agent>");
+                        debugInfo.debugDetails.push({
+                            category: "custom-agent",
+                            name: agent.name,
+                            uri: agent.uri
+                        });
+                        if (isInClaudeAgentsFolder(agent.uri)) {
+                            telemetryEvent.claudeAgentsCount++;
+                        }
+                    } else {
+                        debugInfo.debugDetails.push({
+                            category: "skipped",
+                            name: agent.name,
+                            uri: agent.uri,
+                            reason: ( localize(12543, "not invocable by model"))
+                        });
+                    }
+                }
+                entries.push("</agents>", "", "");
+            }
+        }
+        if (entries.length === 0) {
+            return undefined;
+        }
+        const content = entries.join("\n");
+        const toolReferences = [];
+        const collectToolReference = tool => {
+            if (tool) {
+                let offset = content.indexOf(tool.variable);
+                while (offset >= 0) {
+                    toolReferences.push(toToolVariableEntry(tool.tool, ( new OffsetRange(offset, offset + tool.variable.length))));
+                    offset = content.indexOf(tool.variable, offset + 1);
+                }
+            }
+        };
+        collectToolReference(fileReadTool);
+        collectToolReference(runSubagentTool);
+        collectToolReference(skillTool);
+        return toPromptTextVariableEntry(content, true, toolReferences);
+    }
+    async _addReferencedInstructions(attachedContext, telemetryEvent, debugInfo, token) {
+        const includeReferencedInstructions = this._configurationService.getValue(PromptsConfig.INCLUDE_REFERENCED_INSTRUCTIONS);
+        if (!includeReferencedInstructions && this._modeKind !== ChatModeKind.Edit) {
+            this._logService.trace(
+                `[InstructionsContextComputer] includeReferencedInstructions is disabled and agent kind is not Edit. No referenced instructions will be added.`
+            );
+            return;
+        }
+        const seen = ( new ResourceSet());
+        const todo = [];
+        for (const variable of attachedContext.asArray()) {
+            if (isPromptFileVariableEntry(variable)) {
+                if (!( seen.has(variable.value))) {
+                    todo.push(variable.value);
+                    seen.add(variable.value);
+                }
+            }
+        }
+        let next = todo.pop();
+        while (next) {
+            const result = await this._parseInstructionsFile(next, token);
+            if (result && result.body) {
+                const refsToCheck = [];
+                let userHome;
+                for (const ref of result.body.fileReferences) {
+                    if (isPromptFileTildePath(ref.content)) {
+                        userHome ??= await this._pathService.userHome();
+                    }
+                    const url = result.body.resolveFilePath(ref.content, userHome);
+                    if (url && !( seen.has(url)) && (isPromptOrInstructionsFile(url) || this._workspaceService.getWorkspaceFolder(url) !== undefined)) {
+                        refsToCheck.push({
+                            resource: url
+                        });
+                        seen.add(url);
+                    }
+                }
+                if (refsToCheck.length > 0) {
+                    const stats = await this._fileService.resolveAll(refsToCheck);
+                    for (let i = 0; i < stats.length; i++) {
+                        const stat = stats[i];
+                        const uri = refsToCheck[i].resource;
+                        if (stat.success && stat.stat?.isFile) {
+                            if (isPromptOrInstructionsFile(uri)) {
+                                todo.push(uri);
+                            }
+                            const reason = ( localize(12544, "Referenced by {0}", basename(next)));
+                            attachedContext.add(
+                                toPromptFileVariableEntry(uri, PromptFileVariableKind.InstructionReference, reason, true)
+                            );
+                            telemetryEvent.referencedInstructionsCount++;
+                            debugInfo.debugDetails.push({
+                                category: "referenced",
+                                name: ( basename(uri).toString()),
+                                uri,
+                                reason
+                            });
+                            this._logService.trace(`[InstructionsContextComputer] ${( uri.toString())} added, referenced by ${( next.toString())}`);
+                        }
+                    }
+                }
+            }
+            next = todo.pop();
+        }
+    }
+};
+ComputeAutomaticInstructions = ( __decorate([( __param(4, IPromptsService)), ( __param(5, ILogService)), ( __param(6, ILabelService)), ( __param(7, IConfigurationService)), ( __param(8, IWorkspaceContextService)), ( __param(9, IFileService)), ( __param(10, IRemoteAgentService)), ( __param(11, ITelemetryService)), ( __param(12, ILanguageModelToolsService)), ( __param(13, IAgentPluginService)), ( __param(14, IPathService))], ComputeAutomaticInstructions));
+function getFilePath(uri, remoteOS, isRemote = false) {
+    if (isRemote && uri.scheme === Schemas.file) {
+        return ( uri.with({
+            scheme: "vscode-local"
+        }).toString());
+    }
+    if (uri.scheme === Schemas.file || uri.scheme === Schemas.vscodeRemote) {
+        const fsPath = uri.fsPath;
+        if (remoteOS !== undefined) {
+            if (remoteOS === OperatingSystem.Windows) {
+                return fsPath.replace(/\//g, "\\");
+            }
+            return fsPath.replace(/\\/g, "/");
+        }
+        return fsPath;
+    }
+    return ( uri.toString());
+}
+
+export { ComputeAutomaticInstructions, getFilePath, lastInstructionsCollectionResult };