@codingame/monaco-vscode-api 28.4.1 → 29.0.0

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

@@ -33,159 +33,159 @@ const promptFileAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
         description: ( localize(
-            7092,
+            7315,
             "The name of the prompt. This is also the name of the slash command that will run this prompt."
         ))
     },
     [PromptHeaderAttributes.description]: {
         type: "scalar",
         description: ( localize(
-            7093,
+            7316,
             "The description of the reusable prompt, what it does and when to use it."
         ))
     },
     [PromptHeaderAttributes.argumentHint]: {
         type: "scalar",
         description: ( localize(
-            7094,
+            7317,
             "The argument-hint describes what inputs the prompt expects or supports."
         ))
     },
     [PromptHeaderAttributes.model]: {
         type: "scalar | sequence",
         description: ( localize(
-            7095,
+            7318,
             "The model to use in this prompt. Can also be a list of models. The first available model will be used."
         ))
     },
     [PromptHeaderAttributes.tools]: {
         type: "scalar | sequence",
-        description: ( localize(7096, "The tools to use in this prompt.")),
+        description: ( localize(7319, "The tools to use in this prompt.")),
         defaults: ["[]", "['search', 'edit', 'web']"]
     },
     [PromptHeaderAttributes.agent]: {
         type: "scalar",
-        description: ( localize(7097, "The agent to use when running this prompt."))
+        description: ( localize(7320, "The agent to use when running this prompt."))
     },
     [PromptHeaderAttributes.mode]: {
         type: "scalar",
-        description: ( localize(7097, "The agent to use when running this prompt."))
+        description: ( localize(7320, "The agent to use when running this prompt."))
     }
 };
 const instructionAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
         description: ( localize(
-            7098,
+            7321,
             "The name of the instruction file as shown in the UI. If not set, the name is derived from the file name."
         ))
     },
     [PromptHeaderAttributes.description]: {
         type: "scalar",
         description: ( localize(
-            7099,
+            7322,
             "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."
         ))
     },
     [PromptHeaderAttributes.applyTo]: {
         type: "scalar",
         description: ( localize(
-            7100,
+            7323,
             "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/**`"
         )),
         defaults: ["'**'", "'**/*.ts, **/*.js'", "'**/*.php'", "'**/*.py'"]
     },
     [PromptHeaderAttributes.excludeAgent]: {
         type: "scalar | sequence",
-        description: ( localize(7101, "One or more agents to exclude from using this instruction file."))
+        description: ( localize(7324, "One or more agents to exclude from using this instruction file."))
     }
 };
 const customAgentAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
-        description: ( localize(7102, "The name of the agent as shown in the UI."))
+        description: ( localize(7325, "The name of the agent as shown in the UI."))
     },
     [PromptHeaderAttributes.description]: {
         type: "scalar",
         description: ( localize(
-            7103,
+            7326,
             "The description of the custom agent, what it does and when to use it."
         ))
     },
     [PromptHeaderAttributes.argumentHint]: {
         type: "scalar",
         description: ( localize(
-            7104,
+            7327,
             "The argument-hint describes what inputs the custom agent expects or supports."
         ))
     },
     [PromptHeaderAttributes.model]: {
         type: "scalar | sequence",
         description: ( localize(
-            7105,
+            7328,
             "Specify the model that runs this custom agent. Can also be a list of models. The first available model will be used."
         ))
     },
     [PromptHeaderAttributes.tools]: {
         type: "scalar | sequence",
-        description: ( localize(7106, "The set of tools that the custom agent has access to.")),
+        description: ( localize(7329, "The set of tools that the custom agent has access to.")),
         defaults: ["[]", "[search, edit, web]"]
     },
     [PromptHeaderAttributes.handOffs]: {
         type: "sequence",
-        description: ( localize(7107, "Possible handoff actions when the agent has completed its task."))
+        description: ( localize(7330, "Possible handoff actions when the agent has completed its task."))
     },
     [PromptHeaderAttributes.target]: {
         type: "scalar",
         description: ( localize(
-            7108,
+            7331,
             "The target to which the header attributes like tools apply to. Possible values are `github-copilot` and `vscode`."
         )),
         enums: targetAttributeEnumValues
     },
     [PromptHeaderAttributes.infer]: {
         type: "scalar",
-        description: ( localize(7109, "Controls visibility of the agent.")),
+        description: ( localize(7332, "Controls visibility of the agent.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.agents]: {
         type: "sequence",
         description: ( localize(
-            7110,
+            7333,
             "One or more agents that this agent can use as subagents. Use '*' to specify all available agents."
         )),
         defaults: ["[\"*\"]"]
     },
     [PromptHeaderAttributes.userInvocable]: {
         type: "scalar",
-        description: ( localize(7111, "Whether the agent can be selected and invoked by users in the UI.")),
+        description: ( localize(7334, "Whether the agent can be selected and invoked by users in the UI.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.userInvokable]: {
         type: "scalar",
-        description: ( localize(7112, "Deprecated. Use user-invocable instead.")),
+        description: ( localize(7335, "Deprecated. Use user-invocable instead.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.disableModelInvocation]: {
         type: "scalar",
-        description: ( localize(7113, "If true, prevents the agent from being invoked as a subagent.")),
+        description: ( localize(7336, "If true, prevents the agent from being invoked as a subagent.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.advancedOptions]: {
         type: "map",
-        description: ( localize(7114, "Advanced options for custom agent behavior."))
+        description: ( localize(7337, "Advanced options for custom agent behavior."))
     },
     [GithubPromptHeaderAttributes.github]: {
         type: "map",
         description: ( localize(
-            7115,
+            7338,
             "GitHub-specific configuration for the agent, such as token permissions."
         ))
     },
     [PromptHeaderAttributes.hooks]: {
         type: "map",
         description: ( localize(
-            7116,
+            7339,
             "Lifecycle hooks scoped to this agent. Define hooks that run only while this agent is active."
         ))
     }
@@ -193,54 +193,54 @@ const customAgentAttributes = {
 const skillAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
-        description: ( localize(7117, "The name of the skill."))
+        description: ( localize(7340, "The name of the skill."))
     },
     [PromptHeaderAttributes.description]: {
         type: "scalar",
         description: ( localize(
-            7118,
+            7341,
             "The description of the skill. The description is added to every request and will be used by the agent to decide when to load the skill."
         ))
     },
     [PromptHeaderAttributes.argumentHint]: {
         type: "scalar",
         description: ( localize(
-            7119,
+            7342,
             "Hint shown during autocomplete to indicate expected arguments. Example: [issue-number] or [filename] [format]"
         ))
     },
     [PromptHeaderAttributes.userInvocable]: {
         type: "scalar",
         description: ( localize(
-            7120,
+            7343,
             "Set to false to hide from the / menu. Use for background knowledge users should not invoke directly. Default: true."
         )),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.userInvokable]: {
         type: "scalar",
-        description: ( localize(7121, "Deprecated. Use user-invocable instead.")),
+        description: ( localize(7344, "Deprecated. Use user-invocable instead.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.disableModelInvocation]: {
         type: "scalar",
         description: ( localize(
-            7122,
+            7345,
             "Set to true to prevent the agent from automatically loading this skill. Use for workflows you want to trigger manually with /name. Default: false."
         )),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.license]: {
         type: "scalar | map",
-        description: ( localize(7123, "License information for the skill."))
+        description: ( localize(7346, "License information for the skill."))
     },
     [PromptHeaderAttributes.compatibility]: {
         type: "scalar | map",
-        description: ( localize(7124, "Compatibility metadata for environments or runtimes."))
+        description: ( localize(7347, "Compatibility metadata for environments or runtimes."))
     },
     [PromptHeaderAttributes.metadata]: {
         type: "map",
-        description: ( localize(7125, "Additional metadata for the skill."))
+        description: ( localize(7348, "Additional metadata for the skill."))
     }
 };
 const allAttributeNames = {
@@ -304,92 +304,92 @@ function getAttributeDefinition(attributeName, promptType, target) {
 }
 const knownGithubCopilotTools = [{
     name: SpecedToolAliases.execute,
-    description: ( localize(7126, "Execute commands"))
+    description: ( localize(7349, "Execute commands"))
 }, {
     name: SpecedToolAliases.read,
-    description: ( localize(7127, "Read files"))
+    description: ( localize(7350, "Read files"))
 }, {
     name: SpecedToolAliases.edit,
-    description: ( localize(7128, "Edit files"))
+    description: ( localize(7351, "Edit files"))
 }, {
     name: SpecedToolAliases.search,
-    description: ( localize(7129, "Search files"))
+    description: ( localize(7352, "Search files"))
 }, {
     name: SpecedToolAliases.agent,
-    description: ( localize(7130, "Use subagents"))
+    description: ( localize(7353, "Use subagents"))
 }];
 const knownClaudeTools = [{
     name: "Bash",
-    description: ( localize(7131, "Execute shell commands")),
+    description: ( localize(7354, "Execute shell commands")),
     toolEquivalent: [SpecedToolAliases.execute]
 }, {
     name: "Edit",
-    description: ( localize(7132, "Make targeted file edits")),
+    description: ( localize(7355, "Make targeted file edits")),
     toolEquivalent: ["edit/editNotebook", "edit/editFiles"]
 }, {
     name: "Glob",
-    description: ( localize(7133, "Find files by pattern")),
+    description: ( localize(7356, "Find files by pattern")),
     toolEquivalent: ["search/fileSearch"]
 }, {
     name: "Grep",
-    description: ( localize(7134, "Search file contents with regex")),
+    description: ( localize(7357, "Search file contents with regex")),
     toolEquivalent: ["search/textSearch"]
 }, {
     name: "Read",
-    description: ( localize(7135, "Read file contents")),
+    description: ( localize(7358, "Read file contents")),
     toolEquivalent: ["read/readFile", "read/getNotebookSummary"]
 }, {
     name: "Write",
-    description: ( localize(7136, "Create/overwrite files")),
+    description: ( localize(7359, "Create/overwrite files")),
     toolEquivalent: ["edit/createDirectory", "edit/createFile", "edit/createJupyterNotebook"]
 }, {
     name: "WebFetch",
-    description: ( localize(7137, "Fetch URL content")),
+    description: ( localize(7360, "Fetch URL content")),
     toolEquivalent: [SpecedToolAliases.web]
 }, {
     name: "WebSearch",
-    description: ( localize(7138, "Perform web searches")),
+    description: ( localize(7361, "Perform web searches")),
     toolEquivalent: [SpecedToolAliases.web]
 }, {
     name: "Task",
-    description: ( localize(7139, "Run subagents for complex tasks")),
+    description: ( localize(7362, "Run subagents for complex tasks")),
     toolEquivalent: [SpecedToolAliases.agent]
 }, {
     name: "Skill",
-    description: ( localize(7140, "Execute skills")),
+    description: ( localize(7363, "Execute skills")),
     toolEquivalent: []
 }, {
     name: "LSP",
-    description: ( localize(7141, "Code intelligence (requires plugin)")),
+    description: ( localize(7364, "Code intelligence (requires plugin)")),
     toolEquivalent: []
 }, {
     name: "NotebookEdit",
-    description: ( localize(7142, "Modify Jupyter notebooks")),
+    description: ( localize(7365, "Modify Jupyter notebooks")),
     toolEquivalent: ["edit/editNotebook"]
 }, {
     name: "AskUserQuestion",
-    description: ( localize(7143, "Ask multiple-choice questions")),
+    description: ( localize(7366, "Ask multiple-choice questions")),
     toolEquivalent: ["vscode/askQuestions"]
 }, {
     name: "MCPSearch",
-    description: ( localize(7144, "Searches for MCP tools when tool search is enabled")),
+    description: ( localize(7367, "Searches for MCP tools when tool search is enabled")),
     toolEquivalent: []
 }];
 const knownClaudeModels = [{
     name: "sonnet",
-    description: ( localize(7145, "Latest Claude Sonnet")),
+    description: ( localize(7368, "Latest Claude Sonnet")),
     modelEquivalent: "Claude Sonnet 4.5 (copilot)"
 }, {
     name: "opus",
-    description: ( localize(7146, "Latest Claude Opus")),
+    description: ( localize(7369, "Latest Claude Opus")),
     modelEquivalent: "Claude Opus 4.6 (copilot)"
 }, {
     name: "haiku",
-    description: ( localize(7147, "Latest Claude Haiku, fast for simple tasks")),
+    description: ( localize(7370, "Latest Claude Haiku, fast for simple tasks")),
     modelEquivalent: "Claude Haiku 4.5 (copilot)"
 }, {
     name: "inherit",
-    description: ( localize(7148, "Inherit model from parent agent or prompt")),
+    description: ( localize(7371, "Inherit model from parent agent or prompt")),
     modelEquivalent: undefined
 }];
 function mapClaudeModels(claudeModelNames) {
@@ -415,28 +415,28 @@ function mapClaudeTools(claudeToolNames) {
 const claudeAgentAttributes = {
     "name": {
         type: "scalar",
-        description: ( localize(7149, "Unique identifier using lowercase letters and hyphens (required)"))
+        description: ( localize(7372, "Unique identifier using lowercase letters and hyphens (required)"))
     },
     "description": {
         type: "scalar",
-        description: ( localize(7150, "When to delegate to this subagent (required)"))
+        description: ( localize(7373, "When to delegate to this subagent (required)"))
     },
     "tools": {
         type: "sequence",
-        description: ( localize(7151, "Array of tools the subagent can use. Inherits all tools if omitted")),
+        description: ( localize(7374, "Array of tools the subagent can use. Inherits all tools if omitted")),
         defaults: ["Read, Edit, Bash"],
         items: knownClaudeTools
     },
     "disallowedTools": {
         type: "sequence",
-        description: ( localize(7152, "Tools to deny, removed from inherited or specified list")),
+        description: ( localize(7375, "Tools to deny, removed from inherited or specified list")),
         defaults: ["Write, Edit, Bash"],
         items: knownClaudeTools
     },
     "model": {
         type: "scalar",
         description: ( localize(
-            7153,
+            7376,
             "Model to use: sonnet, opus, haiku, or inherit. Defaults to inherit."
         )),
         defaults: ["sonnet", "opus", "haiku", "inherit"],
@@ -445,77 +445,77 @@ const claudeAgentAttributes = {
     "permissionMode": {
         type: "scalar",
         description: ( localize(
-            7154,
+            7377,
             "Permission mode: default, acceptEdits, dontAsk, bypassPermissions, or plan."
         )),
         defaults: ["default", "acceptEdits", "dontAsk", "bypassPermissions", "plan"],
         enums: [{
             name: "default",
             description: ( localize(
-                7155,
+                7378,
                 "Standard behavior: prompts for permission on first use of each tool."
             ))
         }, {
             name: "acceptEdits",
-            description: ( localize(7156, "Automatically accepts file edit permissions for the session."))
+            description: ( localize(7379, "Automatically accepts file edit permissions for the session."))
         }, {
             name: "plan",
             description: ( localize(
-                7157,
+                7380,
                 "Plan Mode: Claude can analyze but not modify files or execute commands."
             ))
         }, {
             name: "delegate",
             description: ( localize(
-                7158,
+                7381,
                 "Coordination-only mode for agent team leads. Only available when an agent team is active."
             ))
         }, {
             name: "dontAsk",
             description: ( localize(
-                7159,
+                7382,
                 "Auto-denies tools unless pre-approved via /permissions or permissions.allow rules."
             ))
         }, {
             name: "bypassPermissions",
             description: ( localize(
-                7160,
+                7383,
                 "Skips all permission prompts (requires safe environment like containers)."
             ))
         }]
     },
     "skills": {
         type: "sequence",
-        description: ( localize(7161, "Skills to load into the subagent's context at startup."))
+        description: ( localize(7384, "Skills to load into the subagent's context at startup."))
     },
     "mcpServers": {
         type: "sequence",
-        description: ( localize(7162, "MCP servers available to this subagent."))
+        description: ( localize(7385, "MCP servers available to this subagent."))
     },
     "hooks": {
         type: "object",
-        description: ( localize(7163, "Lifecycle hooks scoped to this subagent."))
+        description: ( localize(7386, "Lifecycle hooks scoped to this subagent."))
     },
     "memory": {
         type: "scalar",
         description: ( localize(
-            7164,
+            7387,
             "Persistent memory scope: user, project, or local. Enables cross-session learning."
         )),
         defaults: ["user", "project", "local"],
         enums: [{
             name: "user",
-            description: ( localize(7165, "Remember learnings across all projects."))
+            description: ( localize(7388, "Remember learnings across all projects."))
         }, {
             name: "project",
             description: ( localize(
-                7166,
+                7389,
                 "The subagent's knowledge is project-specific and shareable via version control."
             ))
         }, {
             name: "local",
             description: ( localize(
-                7167,
+                7390,
                 "The subagent's knowledge is project-specific but should not be checked into version control."
             ))
         }]
@@ -525,14 +525,14 @@ const claudeRulesAttributes = {
     "description": {
         type: "scalar",
         description: ( localize(
-            7168,
+            7391,
             "A description of what this rule covers, used to provide context about when it applies."
         ))
     },
     "paths": {
         type: "sequence",
         description: ( localize(
-            7169,
+            7392,
             "Array of glob patterns that describe for which files the rule applies. Based on these patterns, the file is automatically included in the prompt when the context contains a file that matches.\nExample: `['src/**/*.ts', 'test/**']`"
         ))
     }

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

@@ -250,7 +250,7 @@ class PromptHeader {
                             model = prop.value.value;
                         }
                     }
-                    if (agent && label && prompt !== undefined) {
+                    if (agent && label?.trim() && prompt !== undefined) {
                         const handoff = {
                             agent,
                             label,

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

@@ -27,6 +27,26 @@ export declare const SKILL_LANGUAGE_ID = "skill";
  * Prompt and instructions files language selector.
  */
 export declare const ALL_PROMPTS_LANGUAGE_SELECTOR: LanguageSelector;
+/**
+ * Configuration key for enabling the agent debug log feature.
+ */
+export declare const AGENT_DEBUG_LOG_ENABLED_SETTING = "github.copilot.chat.agentDebugLog.enabled";
+/**
+ * Configuration key for enabling file logging for the agent debug log.
+ */
+export declare const AGENT_DEBUG_LOG_FILE_LOGGING_ENABLED_SETTING = "github.copilot.chat.agentDebugLog.fileLogging.enabled";
+/**
+ * The name of the troubleshoot slash command / skill.
+ */
+export declare const TROUBLESHOOT_COMMAND_NAME = "troubleshoot";
+/**
+ * URI scheme used by the Copilot extension for built-in skills.
+ */
+export declare const COPILOT_SKILL_URI_SCHEME = "copilot-skill";
+/**
+ * Path fragment that identifies the troubleshoot skill in a URI.
+ */
+export declare const TROUBLESHOOT_SKILL_PATH = "troubleshoot/SKILL.md";
 /**
  * The language id for a prompts type.
  */

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

@@ -15,6 +15,11 @@ const ALL_PROMPTS_LANGUAGE_SELECTOR = [
     AGENT_LANGUAGE_ID,
     SKILL_LANGUAGE_ID
 ];
+const AGENT_DEBUG_LOG_ENABLED_SETTING = "github.copilot.chat.agentDebugLog.enabled";
+const AGENT_DEBUG_LOG_FILE_LOGGING_ENABLED_SETTING = "github.copilot.chat.agentDebugLog.fileLogging.enabled";
+const TROUBLESHOOT_COMMAND_NAME = "troubleshoot";
+const COPILOT_SKILL_URI_SCHEME = "copilot-skill";
+const TROUBLESHOOT_SKILL_PATH = "troubleshoot/SKILL.md";
 function getLanguageIdForPromptsType(type) {
     switch (type) {
     case PromptsType.prompt:
@@ -64,4 +69,4 @@ var Target;
     Target["Undefined"] = "undefined";
 })(Target || (Target = {}));
 
-export { AGENT_DOCUMENTATION_URL, AGENT_LANGUAGE_ID, ALL_PROMPTS_LANGUAGE_SELECTOR, HOOK_DOCUMENTATION_URL, INSTRUCTIONS_DOCUMENTATION_URL, INSTRUCTIONS_LANGUAGE_ID, PROMPT_DOCUMENTATION_URL, PROMPT_LANGUAGE_ID, PromptsType, SKILL_DOCUMENTATION_URL, SKILL_LANGUAGE_ID, Target, getLanguageIdForPromptsType, getPromptsTypeForLanguageId, isValidPromptType };
+export { AGENT_DEBUG_LOG_ENABLED_SETTING, AGENT_DEBUG_LOG_FILE_LOGGING_ENABLED_SETTING, AGENT_DOCUMENTATION_URL, AGENT_LANGUAGE_ID, ALL_PROMPTS_LANGUAGE_SELECTOR, COPILOT_SKILL_URI_SCHEME, HOOK_DOCUMENTATION_URL, INSTRUCTIONS_DOCUMENTATION_URL, INSTRUCTIONS_LANGUAGE_ID, PROMPT_DOCUMENTATION_URL, PROMPT_LANGUAGE_ID, PromptsType, SKILL_DOCUMENTATION_URL, SKILL_LANGUAGE_ID, TROUBLESHOOT_COMMAND_NAME, TROUBLESHOOT_SKILL_PATH, Target, getLanguageIdForPromptsType, getPromptsTypeForLanguageId, isValidPromptType };

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

@@ -1,4 +1,5 @@
 import { URI } from "../../../../../../base/common/uri.js";
+import { ContextKeyExpression } from "../../../../../../platform/contextkey/common/contextkey.js";
 import { ExtensionIdentifier, IExtensionDescription } from "../../../../../../platform/extensions/common/extensions.js";
 import { IChatModeInstructions, IVariableReference } from "../../chatModes.js";
 import { PromptsType, Target } from "../promptTypes.js";
@@ -52,7 +53,8 @@ export declare enum PromptsStorage {
     local = "local",
     user = "user",
     extension = "extension",
-    plugin = "plugin"
+    plugin = "plugin",
+    internal = "internal"
 }
 /**
  * The type of source for extension agents.
@@ -65,7 +67,7 @@ export declare enum ExtensionAgentSourceType {
  * Represents a prompt path with its type.
  * This is used for both prompt files and prompt source folders.
  */
-export type IPromptPath = IExtensionPromptPath | ILocalPromptPath | IUserPromptPath | IPluginPromptPath;
+export type IPromptPath = IExtensionPromptPath | ILocalPromptPath | IUserPromptPath | IPluginPromptPath | IInternalPromptPath;
 export interface IPromptPathBase {
     /**
      * URI of the prompt.
@@ -104,6 +106,9 @@ export interface IPluginPromptPath extends IPromptPathBase {
     readonly storage: PromptsStorage.plugin;
     readonly pluginUri: URI;
 }
+export interface IInternalPromptPath extends IPromptPathBase {
+    readonly storage: PromptsStorage.internal;
+}
 export type IAgentSource = {
     readonly storage: PromptsStorage.extension;
     readonly extensionId: ExtensionIdentifier;
@@ -113,6 +118,8 @@ export type IAgentSource = {
 } | {
     readonly storage: PromptsStorage.plugin;
     readonly pluginUri: URI;
+} | {
+    readonly storage: PromptsStorage.internal;
 };
 /**
  * The visibility/availability of an agent.
@@ -192,6 +199,7 @@ export interface IChatPromptSlashCommand {
     readonly argumentHint: string | undefined;
     readonly promptPath: IPromptPath;
     readonly parsedPromptFile: ParsedPromptFile;
+    readonly when: ContextKeyExpression | undefined;
 }
 export interface IAgentSkill {
     readonly uri: URI;
@@ -208,6 +216,11 @@ export interface IAgentSkill {
      * Use for background knowledge users shouldn't invoke directly.
      */
     readonly userInvocable: boolean;
+    /**
+     * Optional context key expression. When set, the skill is only available
+     * when this expression evaluates to true against a scoped context.
+     */
+    readonly when?: ContextKeyExpression;
 }
 /**
  * Type of agent instruction file.
@@ -262,12 +275,6 @@ export interface IPromptFileDiscoveryResult {
 export interface IPromptSourceFolderResult {
     readonly uri: URI;
     readonly storage: PromptsStorage;
-    /** Whether the folder exists on disk */
-    readonly exists: boolean;
-    /** Number of matching files found in this folder */
-    readonly fileCount: number;
-    /** Error message if resolution failed */
-    readonly errorMessage?: string;
 }
 /**
  * Summary of prompt file discovery for a specific type.
@@ -275,7 +282,7 @@ export interface IPromptSourceFolderResult {
 export interface IPromptDiscoveryInfo {
     readonly type: PromptsType;
     readonly files: readonly IPromptFileDiscoveryResult[];
-    /** Source folders that were searched, with their existence and file count */
+    /** Source folders that were searched */
     readonly sourceFolders?: readonly IPromptSourceFolderResult[];
 }
 export interface IConfiguredHooksInfo {

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

@@ -10,6 +10,7 @@ var PromptsStorage;
     PromptsStorage["user"] = "user";
     PromptsStorage["extension"] = "extension";
     PromptsStorage["plugin"] = "plugin";
+    PromptsStorage["internal"] = "internal";
 })(PromptsStorage || (PromptsStorage = {}));
 var ExtensionAgentSourceType;
 (function (ExtensionAgentSourceType) {