@codingame/monaco-vscode-api 27.0.0 → 28.0.0

package/vscode/src/vs/workbench/contrib/chat/common/plugins/pluginInstallService.service.d.ts

@@ -5,14 +5,10 @@ export interface IPluginInstallService {
     readonly _serviceBrand: undefined;
     /**
     * Clones the marketplace repository (if not already cached) and registers
-    * the plugin's source directory in the user's `chat.plugins.paths` config.
+    * the plugin in the marketplace service's installed plugins storage.
     */
     installPlugin(plugin: IMarketplacePlugin): Promise<void>;
     /**
-    * Removes the plugin from `chat.plugins.paths` config.
-    */
-    uninstallPlugin(pluginUri: URI): Promise<void>;
-    /**
     * Pulls the latest changes for an already-cloned marketplace repository.
     */
     updatePlugin(plugin: IMarketplacePlugin): Promise<void>;

package/vscode/src/vs/workbench/contrib/chat/common/plugins/pluginMarketplaceService.service.d.ts

@@ -1,11 +1,21 @@
 import { CancellationToken } from "../../../../../base/common/cancellation.js";
 import { Event } from "../../../../../base/common/event.js";
+import { IObservable } from "../../../../../base/common/observable.js";
 import { URI } from "../../../../../base/common/uri.js";
-import { IMarketplacePlugin } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/workbench/contrib/chat/common/plugins/pluginMarketplaceService";
+import { IMarketplaceInstalledPlugin, IMarketplacePlugin, IMarketplaceReference } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/workbench/contrib/chat/common/plugins/pluginMarketplaceService";
 export declare const IPluginMarketplaceService: import("../../../../../platform/instantiation/common/instantiation.js").ServiceIdentifier<IPluginMarketplaceService>;
 export interface IPluginMarketplaceService {
     readonly _serviceBrand: undefined;
     readonly onDidChangeMarketplaces: Event<void>;
+    /** Installed marketplace plugins, backed by storage. */
+    readonly installedPlugins: IObservable<readonly IMarketplaceInstalledPlugin[]>;
     fetchMarketplacePlugins(token: CancellationToken): Promise<IMarketplacePlugin[]>;
-    getMarketplacePluginMetadata(pluginUri: URI): Promise<IMarketplacePlugin | undefined>;
+    getMarketplacePluginMetadata(pluginUri: URI): IMarketplacePlugin | undefined;
+    addInstalledPlugin(pluginUri: URI, plugin: IMarketplacePlugin): void;
+    removeInstalledPlugin(pluginUri: URI): void;
+    setInstalledPluginEnabled(pluginUri: URI, enabled: boolean): void;
+    /** Returns whether the given marketplace has been explicitly trusted by the user. */
+    isMarketplaceTrusted(ref: IMarketplaceReference): boolean;
+    /** Records that the user trusts the given marketplace, persisted permanently. */
+    trustMarketplace(ref: IMarketplaceReference): void;
 }

package/vscode/src/vs/workbench/contrib/chat/common/plugins/pluginSource.d.ts

@@ -0,0 +1,53 @@
+import { URI } from "../../../../../base/common/uri.js";
+import { IEnsureRepositoryOptions, IPullRepositoryOptions } from "./agentPluginRepositoryService.js";
+import { IMarketplacePlugin, IPluginSourceDescriptor, PluginSourceKind } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/workbench/contrib/chat/common/plugins/pluginMarketplaceService";
+/**
+ * Per-kind strategy that centralizes install-path computation, source
+ * provisioning, update, label formatting, and uninstall cleanup for a
+ * single {@link PluginSourceKind}.
+ *
+ * Implementations are created via {@link IInstantiationService} so they
+ * can dependency-inject any services they need (git commands, file service,
+ * terminal service, etc.).
+ */
+export interface IPluginSource {
+    readonly kind: PluginSourceKind;
+    /**
+     * Compute the local cache URI where this source's plugin files live.
+     * @param cacheRoot The root cache directory for all agent plugins.
+     */
+    getInstallUri(cacheRoot: URI, descriptor: IPluginSourceDescriptor): URI;
+    /**
+     * Ensure the plugin source is available locally (clone, npm install, etc.).
+     * Returns the install directory URI.
+     */
+    ensure(cacheRoot: URI, plugin: IMarketplacePlugin, options?: IEnsureRepositoryOptions): Promise<URI>;
+    /**
+     * Update an already-installed plugin source (git pull, npm update, etc.).
+     */
+    update(cacheRoot: URI, plugin: IMarketplacePlugin, options?: IPullRepositoryOptions): Promise<void>;
+    /**
+     * Returns the on-disk directory to delete when this plugin is
+     * uninstalled, or `undefined` if no cleanup is needed.
+     *
+     * Marketplace-relative sources return `undefined` because they share
+     * a marketplace repository cache. Direct sources (github, url, npm,
+     * pip) return the directory they own.
+     */
+    getCleanupTarget(cacheRoot: URI, descriptor: IPluginSourceDescriptor): URI | undefined;
+    /**
+     * Returns a human-readable label for a source descriptor of this kind,
+     * suitable for error messages and UI display.
+     */
+    getLabel(descriptor: IPluginSourceDescriptor): string;
+    /**
+     * For package-manager sources (npm, pip): run the terminal install
+     * command and return the resulting plugin directory, or `undefined`
+     * if the user cancelled or the command failed.
+     *
+     * Not implemented by non-package-manager sources.
+     */
+    runInstall?(installDir: URI, pluginDir: URI, plugin: IMarketplacePlugin): Promise<{
+        pluginDir: URI;
+    } | undefined>;
+}

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

@@ -138,8 +138,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(6925, "Automatically attached as pattern is **")) : ( localize(
-                    6926,
+                const reason = !match.file ? ( localize(7044, "Automatically attached as pattern is **")) : ( localize(
+                    7045,
                     "Automatically attached as pattern {0} matches {1}",
                     pattern,
                     this._labelService.getUriLabel(match.file, {
@@ -324,7 +324,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                 const folderName = this._labelService.getUriLabel(dirname(uri), {
                     relative: true
                 });
-                const description = folderName.trim().length === 0 ? ( localize(6927, "Instructions for the workspace")) : ( localize(6928, "Instructions for folder '{0}'", folderName));
+                const description = folderName.trim().length === 0 ? ( localize(7046, "Instructions for the workspace")) : ( localize(7047, "Instructions for folder '{0}'", folderName));
                 entries.push("<instruction>");
                 entries.push(`<description>${description}</description>`);
                 entries.push(`<file>${filePath(uri)}</file>`);
@@ -492,7 +492,7 @@ let ComputeAutomaticInstructions = class ComputeAutomaticInstructions {
                             if (isPromptOrInstructionsFile(uri)) {
                                 todo.push(uri);
                             }
-                            const reason = ( localize(6929, "Referenced by {0}", basename(next)));
+                            const reason = ( localize(7048, "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,6 +95,10 @@ 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,6 +19,7 @@ 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";

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

@@ -61,6 +61,10 @@ export declare const AGENTS_SOURCE_FOLDER = ".github/agents";
  * Claude agents folder.
  */
 export declare const CLAUDE_AGENTS_SOURCE_FOLDER = ".claude/agents";
+/**
+ * Copilot user agents folder.
+ */
+export declare const COPILOT_USER_AGENTS_SOURCE_FOLDER = "~/.copilot/agents";
 /**
  * Claude rules folder.
  */
@@ -144,6 +148,10 @@ export declare const DEFAULT_HOOK_FILE_PATHS: readonly IPromptSourceFolder[];
  * Helper function to check if a file is directly in the .claude/agents/ folder.
  */
 export declare function isInClaudeAgentsFolder(fileUri: URI): boolean;
+/**
+ * Helper function to check if a file is directly in the ~/.copilot/agents/ folder.
+ */
+export declare function isInCopilotAgentsFolder(fileUri: URI): boolean;
 /**
  * Helper function to check if a file is inside the .claude/rules/ folder (including subfolders).
  * Claude rules files (.md) in this folder are treated as instruction files.

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

@@ -22,8 +22,8 @@ const INSTRUCTIONS_DEFAULT_SOURCE_FOLDER = ".github/instructions";
 const LEGACY_MODE_DEFAULT_SOURCE_FOLDER = ".github/chatmodes";
 const AGENTS_SOURCE_FOLDER = ".github/agents";
 const CLAUDE_AGENTS_SOURCE_FOLDER = ".claude/agents";
+const COPILOT_USER_AGENTS_SOURCE_FOLDER = "~/.copilot/agents";
 const CLAUDE_RULES_SOURCE_FOLDER = ".claude/rules";
-const HOOKS_SOURCE_FOLDER = ".github/hooks";
 var PromptFileSource;
 (function(PromptFileSource) {
     PromptFileSource["GitHubWorkspace"] = "github-workspace";
@@ -98,6 +98,10 @@ const DEFAULT_AGENT_SOURCE_FOLDERS = [{
     path: "~/" + CLAUDE_AGENTS_SOURCE_FOLDER,
     source: PromptFileSource.ClaudePersonal,
     storage: PromptsStorage.user
+}, {
+    path: COPILOT_USER_AGENTS_SOURCE_FOLDER,
+    source: PromptFileSource.CopilotPersonal,
+    storage: PromptsStorage.user
 }];
 const DEFAULT_HOOK_FILE_PATHS = [{
     path: ".github/hooks",
@@ -118,12 +122,16 @@ const DEFAULT_HOOK_FILE_PATHS = [{
 }];
 function isInAgentsFolder(fileUri) {
     const dir = dirname(fileUri.path);
-    return dir.endsWith("/" + AGENTS_SOURCE_FOLDER) || dir.endsWith("/" + CLAUDE_AGENTS_SOURCE_FOLDER);
+    return dir.endsWith("/" + AGENTS_SOURCE_FOLDER) || dir.endsWith("/" + CLAUDE_AGENTS_SOURCE_FOLDER) || isInCopilotAgentsFolder(fileUri);
 }
 function isInClaudeAgentsFolder(fileUri) {
     const dir = dirname(fileUri.path);
     return dir.endsWith("/" + CLAUDE_AGENTS_SOURCE_FOLDER);
 }
+function isInCopilotAgentsFolder(fileUri) {
+    const dir = dirname(fileUri.path);
+    return dir.endsWith(COPILOT_USER_AGENTS_SOURCE_FOLDER.substring(1));
+}
 function isInClaudeRulesFolder(fileUri) {
     const path = fileUri.path;
     return path.includes("/" + CLAUDE_RULES_SOURCE_FOLDER + "/");
@@ -216,4 +224,4 @@ function getCleanPromptName(fileUri) {
     return basename(fileUri.path);
 }
 
-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, DEFAULT_AGENT_SOURCE_FOLDERS, DEFAULT_HOOK_FILE_PATHS, DEFAULT_INSTRUCTIONS_SOURCE_FOLDERS, DEFAULT_PROMPT_SOURCE_FOLDERS, DEFAULT_SKILL_SOURCE_FOLDERS, HOOKS_SOURCE_FOLDER, INSTRUCTIONS_DEFAULT_SOURCE_FOLDER, INSTRUCTION_FILE_EXTENSION, LEGACY_MODE_DEFAULT_SOURCE_FOLDER, LEGACY_MODE_FILE_EXTENSION, PROMPT_DEFAULT_SOURCE_FOLDER, PROMPT_FILE_EXTENSION, PromptFileSource, SKILL_FILENAME, getCleanPromptName, getPromptFileDefaultLocations, getPromptFileExtension, getPromptFileType, isInClaudeAgentsFolder, isInClaudeRulesFolder, 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, INSTRUCTIONS_DEFAULT_SOURCE_FOLDER, INSTRUCTION_FILE_EXTENSION, LEGACY_MODE_DEFAULT_SOURCE_FOLDER, LEGACY_MODE_FILE_EXTENSION, PROMPT_DEFAULT_SOURCE_FOLDER, PROMPT_FILE_EXTENSION, PromptFileSource, SKILL_FILENAME, getCleanPromptName, getPromptFileDefaultLocations, getPromptFileExtension, getPromptFileType, isInClaudeAgentsFolder, isInClaudeRulesFolder, isInCopilotAgentsFolder, isPromptOrInstructionsFile };

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

@@ -1,78 +1,9 @@
 import { IJSONSchema } from "../../../../../base/common/jsonSchema.js";
 import { URI } from "../../../../../base/common/uri.js";
 import { OperatingSystem } from "../../../../../base/common/platform.js";
-/**
- * Enum of available hook types that can be configured in hooks .json
- */
-export declare enum HookType {
-    SessionStart = "SessionStart",
-    UserPromptSubmit = "UserPromptSubmit",
-    PreToolUse = "PreToolUse",
-    PostToolUse = "PostToolUse",
-    PreCompact = "PreCompact",
-    SubagentStart = "SubagentStart",
-    SubagentStop = "SubagentStop",
-    Stop = "Stop"
-}
-/**
- * Maps Copilot CLI hook type names to our abstract HookType.
- * Copilot CLI uses camelCase names.
- */
-export declare const COPILOT_CLI_HOOK_TYPE_MAP: {
-    readonly sessionStart: HookType.SessionStart;
-    readonly userPromptSubmitted: HookType.UserPromptSubmit;
-    readonly preToolUse: HookType.PreToolUse;
-    readonly postToolUse: HookType.PostToolUse;
-};
-/**
- * String literal type derived from HookType enum values.
- */
-export type HookTypeValue = `${HookType}`;
-/**
- * Metadata for hook types including localized labels and descriptions
- */
-export declare const HOOK_TYPES: readonly [
-    {
-        readonly id: HookType.SessionStart;
-        readonly label: string;
-        readonly description: string;
-    },
-    {
-        readonly id: HookType.UserPromptSubmit;
-        readonly label: string;
-        readonly description: string;
-    },
-    {
-        readonly id: HookType.PreToolUse;
-        readonly label: string;
-        readonly description: string;
-    },
-    {
-        readonly id: HookType.PostToolUse;
-        readonly label: string;
-        readonly description: string;
-    },
-    {
-        readonly id: HookType.PreCompact;
-        readonly label: string;
-        readonly description: string;
-    },
-    {
-        readonly id: HookType.SubagentStart;
-        readonly label: string;
-        readonly description: string;
-    },
-    {
-        readonly id: HookType.SubagentStop;
-        readonly label: string;
-        readonly description: string;
-    },
-    {
-        readonly id: HookType.Stop;
-        readonly label: string;
-        readonly description: string;
-    }
-];
+import { HookType } from "./hookTypes.js";
+import { Target } from "./promptTypes.js";
+import { IMapValue } from "./promptFileParser.js";
 /**
  * A single hook command configuration.
  */
@@ -101,25 +32,23 @@ export interface IHookCommand {
  * Collected hooks for a chat request, organized by hook type.
  * This is passed to the extension host so it knows what hooks are available.
  */
-export interface IChatRequestHooks {
-    readonly [HookType.SessionStart]?: readonly IHookCommand[];
-    readonly [HookType.UserPromptSubmit]?: readonly IHookCommand[];
-    readonly [HookType.PreToolUse]?: readonly IHookCommand[];
-    readonly [HookType.PostToolUse]?: readonly IHookCommand[];
-    readonly [HookType.PreCompact]?: readonly IHookCommand[];
-    readonly [HookType.SubagentStart]?: readonly IHookCommand[];
-    readonly [HookType.SubagentStop]?: readonly IHookCommand[];
-    readonly [HookType.Stop]?: readonly IHookCommand[];
-}
+export type ChatRequestHooks = {
+    readonly [K in HookType]?: readonly IHookCommand[];
+};
+/**
+ * Merges two sets of hooks by concatenating the command arrays for each hook type.
+ * Additional hooks are appended after the base hooks.
+ */
+export declare function mergeHooks(base: ChatRequestHooks | undefined, additional: ChatRequestHooks): ChatRequestHooks;
+/**
+ * Descriptions for hook command fields, used by both the JSON schema and the hover provider.
+ */
+export declare const HOOK_COMMAND_FIELD_DESCRIPTIONS: Record<string, string>;
 export declare const hookFileSchema: IJSONSchema;
 /**
  * URI for the hook schema registration.
  */
 export declare const HOOK_SCHEMA_URI = "vscode://schemas/hooks";
-/**
- * Glob pattern for hook files.
- */
-export declare const HOOK_FILE_GLOB = ".github/hooks/*.json";
 /**
  * Normalizes a raw hook type identifier to the canonical HookType enum value.
  * Only matches exact enum values. For tool-specific naming conventions (e.g., Claude, Copilot CLI),
@@ -167,3 +96,42 @@ export declare function formatHookCommandLabel(hook: IHookCommand, os: Operating
  * @param userHome The user's home directory path for tilde expansion
  */
 export declare function resolveHookCommand(raw: Record<string, unknown>, workspaceRootUri: URI | undefined, userHome: string): IHookCommand | undefined;
+/**
+ * Helper to extract hook commands from an item that could be:
+ * 1. A direct command object: { type: 'command', command: '...' }
+ * 2. A nested structure with matcher (Claude style): { matcher: '...', hooks: [{ type: 'command', command: '...' }] }
+ *
+ * This allows Copilot format to handle Claude-style entries if pasted.
+ * Also handles Claude's leniency where 'type' field can be omitted.
+ */
+export declare function extractHookCommandsFromItem(item: unknown, workspaceRootUri: URI | undefined, userHome: string): IHookCommand[];
+/**
+ * Parses hooks from a subagent's YAML frontmatter `hooks` attribute.
+ *
+ * Supports two formats for hook entries:
+ *
+ * 1. **Direct command** (our format, without matcher):
+ * ```yaml
+ * hooks:
+ *   PreToolUse:
+ *     - type: command
+ *       command: "./scripts/validate.sh"
+ * ```
+ *
+ * 2. **Nested with matcher** (Claude Code format):
+ * ```yaml
+ * hooks:
+ *   PreToolUse:
+ *     - matcher: "Bash"
+ *       hooks:
+ *         - type: command
+ *           command: "./scripts/validate.sh"
+ * ```
+ *
+ * @param hooksMap The raw YAML map value from the `hooks` frontmatter attribute.
+ * @param workspaceRootUri Workspace root for resolving relative `cwd` paths.
+ * @param userHome User home directory path for tilde expansion.
+ * @param target The agent's target, used to resolve hook type names correctly.
+ * @returns Resolved hooks organized by hook type, ready for use in {@link ChatRequestHooks}.
+ */
+export declare function parseSubagentHooksFromYaml(hooksMap: IMapValue, workspaceRootUri: URI | undefined, userHome: string, target?: Target): ChatRequestHooks;