@codingame/monaco-vscode-api 31.0.0 → 32.0.0

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

@@ -155,7 +155,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                     category: "skipped",
                     name: ( basename(uri).toString()),
                     uri,
-                    reason: ( localize(7453, "no applyTo pattern"))
+                    reason: ( localize(7765, "no applyTo pattern"))
                 });
                 continue;
             }
@@ -168,7 +168,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                     category: "skipped",
                     name: ( basename(uri).toString()),
                     uri,
-                    reason: ( localize(7454, "already processed"))
+                    reason: ( localize(7766, "already processed"))
                 });
                 continue;
             }
@@ -177,8 +177,8 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                 this._logService.trace(
                     `[InstructionsContextComputer] Match for ${uri} with ${match.pattern}${match.file ? ` for file ${match.file}` : ""}`
                 );
-                const reason = !match.file ? ( localize(7455, "automatically attached as pattern is **")) : ( localize(
-                    7456,
+                const reason = !match.file ? ( localize(7767, "automatically attached as pattern is **")) : ( localize(
+                    7768,
                     "automatically attached as pattern {0} matches {1}",
                     pattern,
                     this._labelService.getUriLabel(match.file, {
@@ -204,7 +204,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                     category: "skipped",
                     name: ( basename(uri).toString()),
                     uri,
-                    reason: ( localize(7457, "applyTo '{0}' did not match any attached files", pattern))
+                    reason: ( localize(7769, "applyTo '{0}' did not match any attached files", pattern))
                 });
             }
         }
@@ -251,7 +251,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                 category: "applying",
                 name: ( basename(uri).toString()),
                 uri,
-                reason: ( localize(7458, "always added"))
+                reason: ( localize(7770, "always added"))
             });
             logger.logInfo(`Agent instruction file added: ${( uri.toString())}`);
         }
@@ -316,6 +316,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
     async _getCustomizationsIndex(instructionFiles, _existingVariables, telemetryEvent, debugInfo, token) {
         const readTool = this._getTool("readFile");
         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;
@@ -332,22 +333,27 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                 "These files are important for understanding the codebase structure, conventions, and best practices."
             );
             entries.push(
-                "Please make sure to follow the rules specified in these files when working with the codebase."
+                "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 is not already available as attachment, use the ${readTool.variable} tool to acquire it.`
+                `If the file content is not already included in the context, use the ${readTool.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."
             );
-            entries.push("Make sure to acquire the instructions before working with the codebase.");
             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>${instruction.description}</description>`);
                 }
-                entries.push(`<file>${filePath(instruction.uri)}</file>`);
                 if (instruction.pattern) {
                     entries.push(`<applyTo>${instruction.pattern}</applyTo>`);
                 }
@@ -361,10 +367,10 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                 const folderName = this._labelService.getUriLabel(dirname(uri), {
                     relative: true
                 });
-                const description = folderName.trim().length === 0 ? ( localize(7459, "Instructions for the workspace")) : ( localize(7460, "Instructions for folder '{0}'", folderName));
+                const description = folderName.trim().length === 0 ? ( localize(7771, "Instructions for the workspace")) : ( localize(7772, "Instructions for folder '{0}'", folderName));
                 entries.push("<instruction>");
-                entries.push(`<description>${description}</description>`);
                 entries.push(`<file>${filePath(uri)}</file>`);
+                entries.push(`<description>${description}</description>`);
                 entries.push("</instruction>");
                 hasContent = true;
             }
@@ -376,12 +382,21 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
             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(7773, "no description for model invocation"))
+                    });
+                    return false;
+                }
                 if (skill.disableModelInvocation) {
                     debugInfo.debugDetails.push({
                         category: "skipped",
                         name: skill.name,
                         uri: skill.uri,
-                        reason: ( localize(7461, "model invocation disabled"))
+                        reason: ( localize(7774, "model invocation disabled"))
                     });
                     return false;
                 }
@@ -390,7 +405,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                         category: "skipped",
                         name: skill.name,
                         uri: skill.uri,
-                        reason: ( localize(7462, "session type not matched"))
+                        reason: ( localize(7775, "session type not matched"))
                     });
                     return false;
                 }
@@ -399,7 +414,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                         category: "skipped",
                         name: skill.name,
                         uri: skill.uri,
-                        reason: ( localize(7463, "debug logging disabled"))
+                        reason: ( localize(7776, "debug logging disabled"))
                     });
                     return false;
                 }
@@ -416,16 +431,23 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                     });
                 }
                 const useSkillAdherencePrompt = this._configurationService.getValue(PromptsConfig.USE_SKILL_ADHERENCE_PROMPT);
+                const skillLoadTool = skillTool ?? readTool;
                 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 ${readTool.variable} to load the relevant skill(s).`
+                        );
+                    }
                     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 ${readTool.variable} to load the relevant skill(s).`
-                    );
-                    entries.push(
-                        "NEVER just mention or reference a skill in your response without actually reading it first. If a skill is relevant, load it before proceeding."
+                        "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(
@@ -439,34 +461,72 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                     );
                     entries.push("Examples:");
                     entries.push(
-                        `- "Help me write unit tests for this module" -> Load the testing skill via ${readTool.variable} FIRST, then proceed`
+                        `- "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 ${readTool.variable} FIRST, then proceed`
+                        `- "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 {
-                    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 ${readTool.variable} tool to acquire the full instructions from the file URI.`
-                    );
+                    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 ${readTool.variable} tool to acquire the full instructions from the file URI.`
+                        );
+                    }
                 }
-                for (const skill of modelInvocableSkills) {
-                    entries.push("<skill>");
-                    entries.push(`<name>${skill.name}</name>`);
+                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>${skill.name}</name>`];
                     if (skill.description) {
-                        entries.push(`<description>${skill.description}</description>`);
+                        skillEntry.push(`<description>${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 addition = (names.length > 0 ? 2 : 0) + skill.name.length;
+                        if (nameListLength + addition > TRUNCATED_NAMES_CHAR_BUDGET) {
+                            break;
+                        }
+                        nameListLength += addition;
+                        names.push(skill.name);
                     }
-                    entries.push(`<file>${filePath(skill.uri)}</file>`);
-                    entries.push("</skill>");
+                    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>", "", "");
             }
@@ -481,7 +541,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                     return agent => subagents.includes(agent.name) && matchesSessionType(agent.sessionTypes, currentSessionType);
                 }
             })();
-            const agents = await this._promptsService.getCustomAgents(token);
+            const agents = (await this._promptsService.getCustomAgents(token)).filter(a => a.enabled);
             if (generalPurposeAgentEnabled || agents.length > 0) {
                 entries.push("<agents>");
                 entries.push("Here is a list of agents that can be used when running a subagent.");
@@ -523,7 +583,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                             category: "skipped",
                             name: agent.name,
                             uri: agent.uri,
-                            reason: ( localize(7464, "not invocable by model"))
+                            reason: ( localize(7777, "not invocable by model"))
                         });
                     }
                 }
@@ -546,6 +606,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
         };
         collectToolReference(readTool);
         collectToolReference(runSubagentTool);
+        collectToolReference(skillTool);
         return toPromptTextVariableEntry(content, true, toolReferences);
     }
     async _addReferencedInstructions(attachedContext, telemetryEvent, debugInfo, token) {
@@ -589,7 +650,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                             if (isPromptOrInstructionsFile(uri)) {
                                 todo.push(uri);
                             }
-                            const reason = ( localize(7465, "Referenced by {0}", basename(next)));
+                            const reason = ( localize(7778, "Referenced by {0}", basename(next)));
                             attachedContext.add(
                                 toPromptFileVariableEntry(uri, PromptFileVariableKind.InstructionReference, reason, true)
                             );

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

@@ -95,10 +95,6 @@ export declare namespace PromptsConfig {
      * Configuration key for enabling Claude hooks.
      */
     const USE_CLAUDE_HOOKS = "chat.useClaudeHooks";
-    /**
-     * Configuration key for enabling hooks defined in custom agent frontmatter.
-     */
-    const USE_CUSTOM_AGENT_HOOKS = "chat.useCustomAgentHooks";
     /**
      * Configuration key for enabling stronger skill adherence prompt (experimental).
      */

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

@@ -19,7 +19,6 @@ var PromptsConfig;
     PromptsConfig.USE_AGENT_SKILLS = "chat.useAgentSkills";
     PromptsConfig.USE_CHAT_HOOKS = "chat.useHooks";
     PromptsConfig.USE_CLAUDE_HOOKS = "chat.useClaudeHooks";
-    PromptsConfig.USE_CUSTOM_AGENT_HOOKS = "chat.useCustomAgentHooks";
     PromptsConfig.USE_SKILL_ADHERENCE_PROMPT = "chat.experimental.useSkillAdherencePrompt";
     PromptsConfig.INCLUDE_APPLYING_INSTRUCTIONS = "chat.includeApplyingInstructions";
     PromptsConfig.INCLUDE_REFERENCED_INSTRUCTIONS = "chat.includeReferencedInstructions";
@@ -62,7 +61,7 @@ var PromptsConfig;
                 const storage = isTildePath(path) ? PromptsStorage.user : PromptsStorage.local;
                 paths.push({
                     path,
-                    source: storage === PromptsStorage.local ? PromptFileSource.ConfigPersonal : PromptFileSource.ConfigWorkspace,
+                    source: storage === PromptsStorage.local ? PromptFileSource.ConfigWorkspace : PromptFileSource.ConfigPersonal,
                     storage
                 });
             }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/config/promptFileLocations.d.ts

@@ -21,6 +21,10 @@ export declare const AGENT_FILE_EXTENSION = ".agent.md";
  * Skill file name (case insensitive).
  */
 export declare const SKILL_FILENAME = "SKILL.md";
+/**
+ * Check if a filename is a skill file (case insensitive).
+ */
+export declare function isSkillFilename(filename: string): boolean;
 /**
  * Regex for valid skill names: lowercase alphanumeric and hyphens only.
  */
@@ -81,12 +85,17 @@ export declare const CLAUDE_RULES_SOURCE_FOLDER = ".claude/rules";
  * Hooks folder.
  */
 export declare const HOOKS_SOURCE_FOLDER = ".github/hooks";
+/**
+ * Subset of {@link PromptFileSource} values that can appear on folder-based
+ * prompt source configurations (excludes extension/plugin-only sources).
+ */
+export type PromptFolderSource = Exclude<PromptFileSource, PromptFileSource.ExtensionContribution | PromptFileSource.ExtensionAPI | PromptFileSource.Plugin>;
 /**
  * Prompt source folder path with source and storage type.
  */
 export interface IPromptSourceFolder {
     readonly path: string;
-    readonly source: PromptFileSource;
+    readonly source: PromptFolderSource;
     readonly storage: PromptsStorage.local | PromptsStorage.user;
 }
 /**
@@ -94,9 +103,9 @@ export interface IPromptSourceFolder {
  */
 export interface IResolvedPromptSourceFolder {
     readonly uri: URI;
-    readonly parent: URI;
+    readonly searchRoot: URI;
     readonly filePattern: string | undefined;
-    readonly source: PromptFileSource;
+    readonly source: PromptFolderSource;
     readonly storage: PromptsStorage.local | PromptsStorage.user;
     /**
      * The original path string before resolution (e.g., '~/.copilot/agents' or '.github/agents').

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

@@ -2,12 +2,16 @@
 import { dirname, basename } from '../../../../../../base/common/resources.js';
 import { PromptFileSource, PromptsType } from '../promptTypes.js';
 import { PromptsStorage } from '../service/promptsService.js';
+import { compareIgnoreCase } from '../../../../../../base/common/strings.js';
 
 const PROMPT_FILE_EXTENSION = ".prompt.md";
 const INSTRUCTION_FILE_EXTENSION = ".instructions.md";
 const LEGACY_MODE_FILE_EXTENSION = ".chatmode.md";
 const AGENT_FILE_EXTENSION = ".agent.md";
 const SKILL_FILENAME = "SKILL.md";
+function isSkillFilename(filename) {
+    return compareIgnoreCase(filename, SKILL_FILENAME) === 0;
+}
 const VALID_SKILL_NAME_REGEX = /^[a-z0-9-]+$/;
 const AGENT_MD_FILENAME = "AGENTS.md";
 const CLAUDE_MD_FILENAME = "CLAUDE.md";
@@ -23,25 +27,25 @@ const CLAUDE_AGENTS_SOURCE_FOLDER = ".claude/agents";
 const COPILOT_USER_AGENTS_SOURCE_FOLDER = "~/.copilot/agents";
 const CLAUDE_RULES_SOURCE_FOLDER = ".claude/rules";
 const DEFAULT_SKILL_SOURCE_FOLDERS = [{
-    path: ".github/skills",
-    source: PromptFileSource.GitHubWorkspace,
-    storage: PromptsStorage.local
-}, {
     path: ".agents/skills",
     source: PromptFileSource.AgentsWorkspace,
     storage: PromptsStorage.local
+}, {
+    path: ".github/skills",
+    source: PromptFileSource.GitHubWorkspace,
+    storage: PromptsStorage.local
 }, {
     path: ".claude/skills",
     source: PromptFileSource.ClaudeWorkspace,
     storage: PromptsStorage.local
-}, {
-    path: "~/.copilot/skills",
-    source: PromptFileSource.CopilotPersonal,
-    storage: PromptsStorage.user
 }, {
     path: "~/.agents/skills",
     source: PromptFileSource.AgentsPersonal,
     storage: PromptsStorage.user
+}, {
+    path: "~/.copilot/skills",
+    source: PromptFileSource.CopilotPersonal,
+    storage: PromptsStorage.user
 }, {
     path: "~/.claude/skills",
     source: PromptFileSource.ClaudePersonal,
@@ -77,14 +81,14 @@ const DEFAULT_AGENT_SOURCE_FOLDERS = [{
     path: CLAUDE_AGENTS_SOURCE_FOLDER,
     source: PromptFileSource.ClaudeWorkspace,
     storage: PromptsStorage.local
-}, {
-    path: "~/" + CLAUDE_AGENTS_SOURCE_FOLDER,
-    source: PromptFileSource.ClaudePersonal,
-    storage: PromptsStorage.user
 }, {
     path: COPILOT_USER_AGENTS_SOURCE_FOLDER,
     source: PromptFileSource.CopilotPersonal,
     storage: PromptsStorage.user
+}, {
+    path: "~/" + CLAUDE_AGENTS_SOURCE_FOLDER,
+    source: PromptFileSource.ClaudePersonal,
+    storage: PromptsStorage.user
 }];
 const DEFAULT_HOOK_FILE_PATHS = [{
     path: ".github/hooks",
@@ -134,7 +138,7 @@ function getPromptFileType(fileUri) {
     if (filename.endsWith(LEGACY_MODE_FILE_EXTENSION) || filename.endsWith(AGENT_FILE_EXTENSION)) {
         return PromptsType.agent;
     }
-    if (filename.toLowerCase() === SKILL_FILENAME.toLowerCase()) {
+    if (isSkillFilename(filename)) {
         return PromptsType.skill;
     }
     if (filename.endsWith(".md") && filename !== "README.md" && isInAgentsFolder(fileUri)) {
@@ -202,8 +206,8 @@ function getCleanPromptName(fileUri) {
     if (fileName === COPILOT_CUSTOM_INSTRUCTIONS_FILENAME) {
         return basename(fileUri, ".md");
     }
-    if (fileName.toLowerCase() === SKILL_FILENAME.toLowerCase()) {
-        return basename(fileUri, ".md");
+    if (isSkillFilename(fileName)) {
+        return getSkillFolderName(fileUri);
     }
     if (fileName.endsWith(".md") && fileName !== "README.md" && isInAgentsFolder(fileUri)) {
         return basename(fileUri, ".md");
@@ -214,4 +218,4 @@ function getCleanPromptName(fileUri) {
     return basename(fileUri);
 }
 
-export { AGENTS_SOURCE_FOLDER, AGENT_FILE_EXTENSION, AGENT_MD_FILENAME, CLAUDE_AGENTS_SOURCE_FOLDER, CLAUDE_CONFIG_FOLDER, CLAUDE_LOCAL_MD_FILENAME, CLAUDE_MD_FILENAME, CLAUDE_RULES_SOURCE_FOLDER, COPILOT_CUSTOM_INSTRUCTIONS_FILENAME, COPILOT_USER_AGENTS_SOURCE_FOLDER, DEFAULT_AGENT_SOURCE_FOLDERS, DEFAULT_HOOK_FILE_PATHS, DEFAULT_INSTRUCTIONS_SOURCE_FOLDERS, DEFAULT_PROMPT_SOURCE_FOLDERS, DEFAULT_SKILL_SOURCE_FOLDERS, GITHUB_CONFIG_FOLDER, INSTRUCTIONS_DEFAULT_SOURCE_FOLDER, INSTRUCTION_FILE_EXTENSION, LEGACY_MODE_DEFAULT_SOURCE_FOLDER, LEGACY_MODE_FILE_EXTENSION, PROMPT_DEFAULT_SOURCE_FOLDER, PROMPT_FILE_EXTENSION, SKILL_FILENAME, VALID_SKILL_NAME_REGEX, getCleanPromptName, getPromptFileDefaultLocations, getPromptFileExtension, getPromptFileType, getSkillFolderName, isInClaudeAgentsFolder, isInClaudeRulesFolder, isInCopilotAgentsFolder, isPromptOrInstructionsFile };
+export { AGENTS_SOURCE_FOLDER, AGENT_FILE_EXTENSION, AGENT_MD_FILENAME, CLAUDE_AGENTS_SOURCE_FOLDER, CLAUDE_CONFIG_FOLDER, CLAUDE_LOCAL_MD_FILENAME, CLAUDE_MD_FILENAME, CLAUDE_RULES_SOURCE_FOLDER, COPILOT_CUSTOM_INSTRUCTIONS_FILENAME, COPILOT_USER_AGENTS_SOURCE_FOLDER, DEFAULT_AGENT_SOURCE_FOLDERS, DEFAULT_HOOK_FILE_PATHS, DEFAULT_INSTRUCTIONS_SOURCE_FOLDERS, DEFAULT_PROMPT_SOURCE_FOLDERS, DEFAULT_SKILL_SOURCE_FOLDERS, GITHUB_CONFIG_FOLDER, INSTRUCTIONS_DEFAULT_SOURCE_FOLDER, INSTRUCTION_FILE_EXTENSION, LEGACY_MODE_DEFAULT_SOURCE_FOLDER, LEGACY_MODE_FILE_EXTENSION, PROMPT_DEFAULT_SOURCE_FOLDER, PROMPT_FILE_EXTENSION, SKILL_FILENAME, VALID_SKILL_NAME_REGEX, getCleanPromptName, getPromptFileDefaultLocations, getPromptFileExtension, getPromptFileType, getSkillFolderName, isInClaudeAgentsFolder, isInClaudeRulesFolder, isInCopilotAgentsFolder, isPromptOrInstructionsFile, isSkillFilename };

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

@@ -0,0 +1,50 @@
+import { URI } from "../../../../../base/common/uri.js";
+import { IHookCommand, extractHookCommandsFromItem } from "./hookSchema.js";
+import { HookType } from "./hookTypes.js";
+export { extractHookCommandsFromItem };
+/**
+ * Resolves a Claude hook type name to our abstract HookType.
+ */
+export declare function resolveClaudeHookType(name: string): HookType | undefined;
+/**
+ * Gets the Claude hook type name for a given abstract HookType.
+ * Returns undefined if the hook type is not supported in Claude.
+ */
+export declare function getClaudeHookTypeName(hookType: HookType): string | undefined;
+/**
+ * Result of parsing Claude hooks file.
+ */
+export interface IParseClaudeHooksResult {
+    /**
+     * The parsed hooks by type.
+     */
+    readonly hooks: Map<HookType, {
+        hooks: IHookCommand[];
+        originalId: string;
+    }>;
+    /**
+     * Whether all hooks from this file were disabled via `disableAllHooks: true`.
+     */
+    readonly disabledAllHooks: boolean;
+}
+/**
+ * Parses hooks from a Claude settings.json file.
+ * Claude format:
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [
+ *       { "matcher": "Bash", "hooks": [{ "type": "command", "command": "..." }] }
+ *     ]
+ *   }
+ * }
+ *
+ * Or simpler format:
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [{ "type": "command", "command": "..." }]
+ *   }
+ * }
+ *
+ * If the file has `disableAllHooks: true` at the top level, all hooks are filtered out.
+ */
+export declare function parseClaudeHooks(json: unknown, workspaceRootUri: URI | undefined, userHome: string): IParseClaudeHooksResult;

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

@@ -0,0 +1,77 @@
+
+import { toHookType, extractHookCommandsFromItem } from './hookSchema.js';
+import { HOOKS_BY_TARGET } from './hookTypes.js';
+import { Target } from './promptTypes.js';
+
+let _hookTypeToClaudeName;
+function getHookTypeToClaudeNameMap() {
+    if (!_hookTypeToClaudeName) {
+        _hookTypeToClaudeName = ( new Map());
+        for (const [claudeName, hookType] of Object.entries(HOOKS_BY_TARGET[Target.Claude])) {
+            _hookTypeToClaudeName.set(hookType, claudeName);
+        }
+    }
+    return _hookTypeToClaudeName;
+}
+function resolveClaudeHookType(name) {
+    return HOOKS_BY_TARGET[Target.Claude][name];
+}
+function getClaudeHookTypeName(hookType) {
+    return getHookTypeToClaudeNameMap().get(hookType);
+}
+function parseClaudeHooks(json, workspaceRootUri, userHome) {
+    const result = ( new Map());
+    if (!json || typeof json !== "object") {
+        return {
+            hooks: result,
+            disabledAllHooks: false
+        };
+    }
+    const root = json;
+    if (root.disableAllHooks === true) {
+        return {
+            hooks: result,
+            disabledAllHooks: true
+        };
+    }
+    const hooks = root.hooks;
+    if (!hooks || typeof hooks !== "object") {
+        return {
+            hooks: result,
+            disabledAllHooks: false
+        };
+    }
+    const hooksObj = hooks;
+    for (const originalId of ( Object.keys(hooksObj))) {
+        const hookType = resolveClaudeHookType(originalId) ?? toHookType(originalId);
+        if (!hookType) {
+            continue;
+        }
+        const hookArray = hooksObj[originalId];
+        if (!Array.isArray(hookArray)) {
+            continue;
+        }
+        const commands = [];
+        for (const item of hookArray) {
+            const extracted = extractHookCommandsFromItem(item, workspaceRootUri, userHome);
+            commands.push(...extracted);
+        }
+        if (commands.length > 0) {
+            const existing = result.get(hookType);
+            if (existing) {
+                existing.hooks.push(...commands);
+            } else {
+                result.set(hookType, {
+                    hooks: commands,
+                    originalId
+                });
+            }
+        }
+    }
+    return {
+        hooks: result,
+        disabledAllHooks: false
+    };
+}
+
+export { extractHookCommandsFromItem, getClaudeHookTypeName, parseClaudeHooks, resolveClaudeHookType };