@codingame/monaco-vscode-api 31.0.1 → 32.0.0

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

@@ -33,154 +33,154 @@ const promptFileAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
         description: ( localize(
-            7509,
+            7822,
             "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(
-            7510,
+            7823,
             "The description of the reusable prompt, what it does and when to use it."
         ))
     },
     [PromptHeaderAttributes.argumentHint]: {
         type: "scalar",
         description: ( localize(
-            7511,
+            7824,
             "The argument-hint describes what inputs the prompt expects or supports."
         ))
     },
     [PromptHeaderAttributes.model]: {
         type: "scalar | sequence",
         description: ( localize(
-            7512,
+            7825,
             "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(7513, "The tools to use in this prompt.")),
+        description: ( localize(7826, "The tools to use in this prompt.")),
         defaults: ["[]", "['search', 'edit', 'web']"]
     },
     [PromptHeaderAttributes.agent]: {
         type: "scalar",
-        description: ( localize(7514, "The agent to use when running this prompt."))
+        description: ( localize(7827, "The agent to use when running this prompt."))
     },
     [PromptHeaderAttributes.mode]: {
         type: "scalar",
-        description: ( localize(7514, "The agent to use when running this prompt."))
+        description: ( localize(7827, "The agent to use when running this prompt."))
     }
 };
 const instructionAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
         description: ( localize(
-            7515,
+            7828,
             "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(
-            7516,
+            7829,
             "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(
-            7517,
+            7830,
             "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(7518, "One or more agents to exclude from using this instruction file."))
+        description: ( localize(7831, "One or more agents to exclude from using this instruction file."))
     }
 };
 const customAgentAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
-        description: ( localize(7519, "The name of the agent as shown in the UI."))
+        description: ( localize(7832, "The name of the agent as shown in the UI."))
     },
     [PromptHeaderAttributes.description]: {
         type: "scalar",
         description: ( localize(
-            7520,
+            7833,
             "The description of the custom agent, what it does and when to use it."
         ))
     },
     [PromptHeaderAttributes.argumentHint]: {
         type: "scalar",
         description: ( localize(
-            7521,
+            7834,
             "The argument-hint describes what inputs the custom agent expects or supports."
         ))
     },
     [PromptHeaderAttributes.model]: {
         type: "scalar | sequence",
         description: ( localize(
-            7522,
+            7835,
             "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(7523, "The set of tools that the custom agent has access to.")),
+        description: ( localize(7836, "The set of tools that the custom agent has access to.")),
         defaults: ["[]", "[search, edit, web]"]
     },
     [PromptHeaderAttributes.handOffs]: {
         type: "sequence",
-        description: ( localize(7524, "Possible handoff actions when the agent has completed its task."))
+        description: ( localize(7837, "Possible handoff actions when the agent has completed its task."))
     },
     [PromptHeaderAttributes.target]: {
         type: "scalar",
         description: ( localize(
-            7525,
+            7838,
             "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(7526, "Controls visibility of the agent.")),
+        description: ( localize(7839, "Controls visibility of the agent.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.agents]: {
         type: "sequence",
         description: ( localize(
-            7527,
+            7840,
             "One or more agents that this agent can use as subagents. Use '*' to specify all available agents."
         )),
         defaults: ["[\"*\"]"]
     },
     [PromptHeaderAttributes.userInvocable]: {
         type: "scalar",
-        description: ( localize(7528, "Whether the agent can be selected and invoked by users in the UI.")),
+        description: ( localize(7841, "Whether the agent can be selected and invoked by users in the UI.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.disableModelInvocation]: {
         type: "scalar",
-        description: ( localize(7529, "If true, prevents the agent from being invoked as a subagent.")),
+        description: ( localize(7842, "If true, prevents the agent from being invoked as a subagent.")),
         enums: booleanAttributeEnumValues
     },
     [PromptHeaderAttributes.advancedOptions]: {
         type: "map",
-        description: ( localize(7530, "Advanced options for custom agent behavior."))
+        description: ( localize(7843, "Advanced options for custom agent behavior."))
     },
     [GithubPromptHeaderAttributes.github]: {
         type: "map",
         description: ( localize(
-            7531,
+            7844,
             "GitHub-specific configuration for the agent, such as token permissions."
         ))
     },
     [PromptHeaderAttributes.hooks]: {
         type: "map",
         description: ( localize(
-            7532,
+            7845,
             "Lifecycle hooks scoped to this agent. Define hooks that run only while this agent is active."
         ))
     }
@@ -188,26 +188,26 @@ const customAgentAttributes = {
 const skillAttributes = {
     [PromptHeaderAttributes.name]: {
         type: "scalar",
-        description: ( localize(7533, "The name of the skill."))
+        description: ( localize(7846, "The name of the skill."))
     },
     [PromptHeaderAttributes.description]: {
         type: "scalar",
         description: ( localize(
-            7534,
+            7847,
             "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(
-            7535,
+            7848,
             "Hint shown during autocomplete to indicate expected arguments. Example: [issue-number] or [filename] [format]"
         ))
     },
     [PromptHeaderAttributes.userInvocable]: {
         type: "scalar",
         description: ( localize(
-            7536,
+            7849,
             "Set to false to hide from the / menu. Use for background knowledge users should not invoke directly. Default: true."
         )),
         enums: booleanAttributeEnumValues
@@ -215,22 +215,36 @@ const skillAttributes = {
     [PromptHeaderAttributes.disableModelInvocation]: {
         type: "scalar",
         description: ( localize(
-            7537,
+            7850,
             "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(7538, "License information for the skill."))
+        description: ( localize(7851, "License information for the skill."))
     },
     [PromptHeaderAttributes.compatibility]: {
         type: "scalar | map",
-        description: ( localize(7539, "Compatibility metadata for environments or runtimes."))
+        description: ( localize(7852, "Compatibility metadata for environments or runtimes."))
     },
     [PromptHeaderAttributes.metadata]: {
         type: "map",
-        description: ( localize(7540, "Additional metadata for the skill."))
+        description: ( localize(7853, "Additional metadata for the skill."))
+    },
+    [PromptHeaderAttributes.context]: {
+        type: "scalar",
+        description: ( localize(
+            7854,
+            "Controls how the skill is loaded. Set to 'fork' to spawn a subagent with the skill instructions instead of returning them inline."
+        )),
+        enums: [{
+            name: "fork",
+            description: ( localize(
+                7855,
+                "Spawn a subagent with the skill instructions injected as system context."
+            ))
+        }]
     }
 };
 const allAttributeNames = {
@@ -294,92 +308,92 @@ function getAttributeDefinition(attributeName, promptType, target) {
 }
 const knownGithubCopilotTools = [{
     name: SpecedToolAliases.execute,
-    description: ( localize(7541, "Execute commands"))
+    description: ( localize(7856, "Execute commands"))
 }, {
     name: SpecedToolAliases.read,
-    description: ( localize(7542, "Read files"))
+    description: ( localize(7857, "Read files"))
 }, {
     name: SpecedToolAliases.edit,
-    description: ( localize(7543, "Edit files"))
+    description: ( localize(7858, "Edit files"))
 }, {
     name: SpecedToolAliases.search,
-    description: ( localize(7544, "Search files"))
+    description: ( localize(7859, "Search files"))
 }, {
     name: SpecedToolAliases.agent,
-    description: ( localize(7545, "Use subagents"))
+    description: ( localize(7860, "Use subagents"))
 }];
 const knownClaudeTools = [{
     name: "Bash",
-    description: ( localize(7546, "Execute shell commands")),
+    description: ( localize(7861, "Execute shell commands")),
     toolEquivalent: [SpecedToolAliases.execute]
 }, {
     name: "Edit",
-    description: ( localize(7547, "Make targeted file edits")),
+    description: ( localize(7862, "Make targeted file edits")),
     toolEquivalent: ["edit/editNotebook", "edit/editFiles"]
 }, {
     name: "Glob",
-    description: ( localize(7548, "Find files by pattern")),
+    description: ( localize(7863, "Find files by pattern")),
     toolEquivalent: ["search/fileSearch"]
 }, {
     name: "Grep",
-    description: ( localize(7549, "Search file contents with regex")),
+    description: ( localize(7864, "Search file contents with regex")),
     toolEquivalent: ["search/textSearch"]
 }, {
     name: "Read",
-    description: ( localize(7550, "Read file contents")),
+    description: ( localize(7865, "Read file contents")),
     toolEquivalent: ["read/readFile", "read/getNotebookSummary"]
 }, {
     name: "Write",
-    description: ( localize(7551, "Create/overwrite files")),
+    description: ( localize(7866, "Create/overwrite files")),
     toolEquivalent: ["edit/createDirectory", "edit/createFile", "edit/createJupyterNotebook"]
 }, {
     name: "WebFetch",
-    description: ( localize(7552, "Fetch URL content")),
+    description: ( localize(7867, "Fetch URL content")),
     toolEquivalent: [SpecedToolAliases.web]
 }, {
     name: "WebSearch",
-    description: ( localize(7553, "Perform web searches")),
+    description: ( localize(7868, "Perform web searches")),
     toolEquivalent: [SpecedToolAliases.web]
 }, {
     name: "Task",
-    description: ( localize(7554, "Run subagents for complex tasks")),
+    description: ( localize(7869, "Run subagents for complex tasks")),
     toolEquivalent: [SpecedToolAliases.agent]
 }, {
     name: "Skill",
-    description: ( localize(7555, "Execute skills")),
+    description: ( localize(7870, "Execute skills")),
     toolEquivalent: []
 }, {
     name: "LSP",
-    description: ( localize(7556, "Code intelligence (requires plugin)")),
+    description: ( localize(7871, "Code intelligence (requires plugin)")),
     toolEquivalent: []
 }, {
     name: "NotebookEdit",
-    description: ( localize(7557, "Modify Jupyter notebooks")),
+    description: ( localize(7872, "Modify Jupyter notebooks")),
     toolEquivalent: ["edit/editNotebook"]
 }, {
     name: "AskUserQuestion",
-    description: ( localize(7558, "Ask multiple-choice questions")),
+    description: ( localize(7873, "Ask multiple-choice questions")),
     toolEquivalent: ["vscode/askQuestions"]
 }, {
     name: "MCPSearch",
-    description: ( localize(7559, "Searches for MCP tools when tool search is enabled")),
+    description: ( localize(7874, "Searches for MCP tools when tool search is enabled")),
     toolEquivalent: []
 }];
 const knownClaudeModels = [{
     name: "sonnet",
-    description: ( localize(7560, "Latest Claude Sonnet")),
+    description: ( localize(7875, "Latest Claude Sonnet")),
     modelEquivalent: "Claude Sonnet 4.5 (copilot)"
 }, {
     name: "opus",
-    description: ( localize(7561, "Latest Claude Opus")),
+    description: ( localize(7876, "Latest Claude Opus")),
     modelEquivalent: "Claude Opus 4.6 (copilot)"
 }, {
     name: "haiku",
-    description: ( localize(7562, "Latest Claude Haiku, fast for simple tasks")),
+    description: ( localize(7877, "Latest Claude Haiku, fast for simple tasks")),
     modelEquivalent: "Claude Haiku 4.5 (copilot)"
 }, {
     name: "inherit",
-    description: ( localize(7563, "Inherit model from parent agent or prompt")),
+    description: ( localize(7878, "Inherit model from parent agent or prompt")),
     modelEquivalent: undefined
 }];
 function mapClaudeModels(claudeModelNames) {
@@ -405,28 +419,28 @@ function mapClaudeTools(claudeToolNames) {
 const claudeAgentAttributes = {
     "name": {
         type: "scalar",
-        description: ( localize(7564, "Unique identifier using lowercase letters and hyphens (required)"))
+        description: ( localize(7879, "Unique identifier using lowercase letters and hyphens (required)"))
     },
     "description": {
         type: "scalar",
-        description: ( localize(7565, "When to delegate to this subagent (required)"))
+        description: ( localize(7880, "When to delegate to this subagent (required)"))
     },
     "tools": {
         type: "sequence",
-        description: ( localize(7566, "Array of tools the subagent can use. Inherits all tools if omitted")),
+        description: ( localize(7881, "Array of tools the subagent can use. Inherits all tools if omitted")),
         defaults: ["Read, Edit, Bash"],
         items: knownClaudeTools
     },
     "disallowedTools": {
         type: "sequence",
-        description: ( localize(7567, "Tools to deny, removed from inherited or specified list")),
+        description: ( localize(7882, "Tools to deny, removed from inherited or specified list")),
         defaults: ["Write, Edit, Bash"],
         items: knownClaudeTools
     },
     "model": {
         type: "scalar",
         description: ( localize(
-            7568,
+            7883,
             "Model to use: sonnet, opus, haiku, or inherit. Defaults to inherit."
         )),
         defaults: ["sonnet", "opus", "haiku", "inherit"],
@@ -435,77 +449,77 @@ const claudeAgentAttributes = {
     "permissionMode": {
         type: "scalar",
         description: ( localize(
-            7569,
+            7884,
             "Permission mode: default, acceptEdits, dontAsk, bypassPermissions, or plan."
         )),
         defaults: ["default", "acceptEdits", "dontAsk", "bypassPermissions", "plan"],
         enums: [{
             name: "default",
             description: ( localize(
-                7570,
+                7885,
                 "Standard behavior: prompts for permission on first use of each tool."
             ))
         }, {
             name: "acceptEdits",
-            description: ( localize(7571, "Automatically accepts file edit permissions for the session."))
+            description: ( localize(7886, "Automatically accepts file edit permissions for the session."))
         }, {
             name: "plan",
             description: ( localize(
-                7572,
+                7887,
                 "Plan Mode: Claude can analyze but not modify files or execute commands."
             ))
         }, {
             name: "delegate",
             description: ( localize(
-                7573,
+                7888,
                 "Coordination-only mode for agent team leads. Only available when an agent team is active."
             ))
         }, {
             name: "dontAsk",
             description: ( localize(
-                7574,
+                7889,
                 "Auto-denies tools unless pre-approved via /permissions or permissions.allow rules."
             ))
         }, {
             name: "bypassPermissions",
             description: ( localize(
-                7575,
+                7890,
                 "Skips all permission prompts (requires safe environment like containers)."
             ))
         }]
     },
     "skills": {
         type: "sequence",
-        description: ( localize(7576, "Skills to load into the subagent's context at startup."))
+        description: ( localize(7891, "Skills to load into the subagent's context at startup."))
     },
     "mcpServers": {
         type: "sequence",
-        description: ( localize(7577, "MCP servers available to this subagent."))
+        description: ( localize(7892, "MCP servers available to this subagent."))
     },
     "hooks": {
         type: "object",
-        description: ( localize(7578, "Lifecycle hooks scoped to this subagent."))
+        description: ( localize(7893, "Lifecycle hooks scoped to this subagent."))
     },
     "memory": {
         type: "scalar",
         description: ( localize(
-            7579,
+            7894,
             "Persistent memory scope: user, project, or local. Enables cross-session learning."
         )),
         defaults: ["user", "project", "local"],
         enums: [{
             name: "user",
-            description: ( localize(7580, "Remember learnings across all projects."))
+            description: ( localize(7895, "Remember learnings across all projects."))
         }, {
             name: "project",
             description: ( localize(
-                7581,
+                7896,
                 "The subagent's knowledge is project-specific and shareable via version control."
             ))
         }, {
             name: "local",
             description: ( localize(
-                7582,
+                7897,
                 "The subagent's knowledge is project-specific but should not be checked into version control."
             ))
         }]
@@ -515,14 +529,14 @@ const claudeRulesAttributes = {
     "description": {
         type: "scalar",
         description: ( localize(
-            7583,
+            7898,
             "A description of what this rule covers, used to provide context about when it applies."
         ))
     },
     "paths": {
         type: "sequence",
         description: ( localize(
-            7584,
+            7899,
             "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.d.ts

@@ -37,6 +37,7 @@ export declare namespace PromptHeaderAttributes {
     const userInvocable = "user-invocable";
     const disableModelInvocation = "disable-model-invocation";
     const hooks = "hooks";
+    const context = "context";
 }
 export declare class PromptHeader {
     readonly range: Range;
@@ -70,6 +71,7 @@ export declare class PromptHeader {
     get agents(): string[] | undefined;
     get userInvocable(): boolean | undefined;
     get disableModelInvocation(): boolean | undefined;
+    get context(): string | undefined;
     /**
      * Gets the raw 'hooks' attribute value from the header.
      * Returns the YAML map value if present, or undefined. The caller is

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

@@ -65,6 +65,7 @@ var PromptHeaderAttributes;
     PromptHeaderAttributes.userInvocable = "user-invocable";
     PromptHeaderAttributes.disableModelInvocation = "disable-model-invocation";
     PromptHeaderAttributes.hooks = "hooks";
+    PromptHeaderAttributes.context = "context";
 })(PromptHeaderAttributes || (PromptHeaderAttributes = {}));
 class PromptHeader {
     constructor(range, uri, linesWithEOL) {
@@ -316,6 +317,9 @@ class PromptHeader {
     get disableModelInvocation() {
         return this.getBooleanAttribute(PromptHeaderAttributes.disableModelInvocation);
     }
+    get context() {
+        return this.getStringAttribute(PromptHeaderAttributes.context);
+    }
     get hooksRaw() {
         const attr = this._parsedHeader.attributes.find(a => a.key === PromptHeaderAttributes.hooks);
         if (attr?.value.type === "map") {

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

@@ -82,7 +82,12 @@ export declare enum PromptFileSource {
     AgentsPersonal = "agents-personal",
     ConfigWorkspace = "config-workspace",
     ConfigPersonal = "config-personal",
+    UserData = "user-data",
     ExtensionContribution = "extension-contribution",
     ExtensionAPI = "extension-api",
     Plugin = "plugin"
 }
+/**
+ * Returns a human-readable description for a prompt file source.
+ */
+export declare function getSourceDescription(source: PromptFileSource): string | undefined;

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

@@ -1,4 +1,5 @@
 
+import { localize } from '../../../../../nls.js';
 
 const PROMPT_DOCUMENTATION_URL = "https://aka.ms/vscode-ghcp-prompt-snippets";
 const INSTRUCTIONS_DOCUMENTATION_URL = "https://aka.ms/vscode-ghcp-custom-instructions";
@@ -78,9 +79,36 @@ var PromptFileSource;
     PromptFileSource["AgentsPersonal"] = "agents-personal";
     PromptFileSource["ConfigWorkspace"] = "config-workspace";
     PromptFileSource["ConfigPersonal"] = "config-personal";
+    PromptFileSource["UserData"] = "user-data";
     PromptFileSource["ExtensionContribution"] = "extension-contribution";
     PromptFileSource["ExtensionAPI"] = "extension-api";
     PromptFileSource["Plugin"] = "plugin";
 })(PromptFileSource || (PromptFileSource = {}));
+function getSourceDescription(source) {
+    switch (source) {
+    case PromptFileSource.AgentsWorkspace:
+        return localize(8064, "Workspace");
+    case PromptFileSource.AgentsPersonal:
+        return localize(8065, "Global");
+    case PromptFileSource.GitHubWorkspace:
+        return localize(8066, "Workspace (only used by Copilot agents)");
+    case PromptFileSource.CopilotPersonal:
+        return localize(8067, "Global (only used by Copilot agents)");
+    case PromptFileSource.ClaudeWorkspace:
+        return localize(8068, "Workspace (only used by Claude agents)");
+    case PromptFileSource.ClaudeWorkspaceLocal:
+        return localize(8069, "Workspace (only used by Claude agents, usually git-ignored)");
+    case PromptFileSource.ClaudePersonal:
+        return localize(8070, "Global (only used by Claude agents)");
+    case PromptFileSource.UserData:
+        return localize(8071, "Global (roams with Settings Sync, only used by VS Code)");
+    case PromptFileSource.ConfigWorkspace:
+        return localize(8072, "Workspace (contributed from settings)");
+    case PromptFileSource.ConfigPersonal:
+        return localize(8073, "Global (contributed from settings)");
+    default:
+        return undefined;
+    }
+}
 
-export { 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, PromptFileSource, PromptsType, SKILL_DOCUMENTATION_URL, SKILL_LANGUAGE_ID, TROUBLESHOOT_COMMAND_NAME, TROUBLESHOOT_SKILL_PATH, Target, getLanguageIdForPromptsType, getPromptsTypeForLanguageId, isValidPromptType };
+export { 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, PromptFileSource, PromptsType, SKILL_DOCUMENTATION_URL, SKILL_LANGUAGE_ID, TROUBLESHOOT_COMMAND_NAME, TROUBLESHOOT_SKILL_PATH, Target, getLanguageIdForPromptsType, getPromptsTypeForLanguageId, getSourceDescription, isValidPromptType };