@codingame/monaco-vscode-api 33.0.9 → 34.0.0

package/vscode/src/vs/platform/agentHost/common/state/protocolUpgrade.d.ts

@@ -1,4 +1,4 @@
-import type { UnsupportedProtocolVersionErrorData } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/platform/agentHost/common/state/protocol/errors";
+import type { UnsupportedProtocolVersionErrorData } from "./protocol/errors.js";
 /**
  * Name of the JSON-RPC method that, when invoked on an agent host spawned
  * by the VS Code CLI, asks the CLI to check for a server upgrade and

package/vscode/src/vs/platform/agentHost/common/state/sessionProtocol.d.ts

@@ -1,9 +1,12 @@
 export type { JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, } from "./protocol/messages.js";
-export type { AhpClientNotification, AhpNotification, AhpRequest, AhpResponse, AhpServerNotification, AhpSuccessResponse, CommandMap, ClientNotificationMap, NotificationMap, NotificationMethodParams, ProtocolMessage, ServerNotificationMap, } from "./protocol/messages.js";
-export type { CreateSessionParams, DirectoryEntry, DispatchActionParams, DisposeSessionParams, FetchTurnsParams, FetchTurnsResult, InitializeParams, InitializeResult, ListSessionsParams, ListSessionsResult, ReconnectParams, ReconnectReplayResult, ReconnectResult, ReconnectSnapshotResult, ResourceCopyParams, ResourceCopyResult, ResourceDeleteParams, ResourceDeleteResult, ResourceListParams, ResourceListResult, ResourceMoveParams, ResourceMoveResult, ResourceReadParams, ResourceReadResult, ResourceWriteParams, ResourceWriteResult, SubscribeParams, UnsubscribeParams, } from "./protocol/commands.js";
-export { ContentEncoding, ReconnectResultType } from "./protocol/commands.js";
-export { AhpErrorCodes, JsonRpcErrorCodes } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/platform/agentHost/common/state/protocol/errors";
-export type { AhpErrorCode, JsonRpcErrorCode } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/platform/agentHost/common/state/protocol/errors";
+export type { AhpClientNotification, AhpNotification, AhpRequest, AhpResponse, AhpServerNotification, AhpSuccessResponse, CommandMap, ClientNotificationMap, ProtocolMessage, ServerNotificationMap, } from "./protocol/messages.js";
+export type { CreateSessionParams, DirectoryEntry, DispatchActionParams, DisposeSessionParams, FetchTurnsParams, FetchTurnsResult, InitializeParams, InitializeResult, ListSessionsParams, ListSessionsResult, ReconnectParams, ReconnectReplayResult, ReconnectResult, ReconnectSnapshotResult, ResourceCopyParams, ResourceCopyResult, ResourceDeleteParams, ResourceDeleteResult, ResourceListParams, ResourceListResult, ResourceMkdirParams, ResourceMkdirResult, ResourceMoveParams, ResourceMoveResult, ResourceReadParams, ResourceReadResult, ResourceResolveParams, ResourceResolveResult, ResourceWriteParams, ResourceWriteResult, SubscribeParams, UnsubscribeParams, } from "./protocol/commands.js";
+export type { CreateResourceWatchParams, CreateResourceWatchResult, } from "./protocol/channels-resource-watch/commands.js";
+export { ContentEncoding, ReconnectResultType, ResourceType, ResourceWriteMode } from "./protocol/commands.js";
+export { ResourceChangeType } from "./protocol/channels-resource-watch/state.js";
+export type { ResourceChange, ResourceWatchState } from "./protocol/channels-resource-watch/state.js";
+export { AhpErrorCodes, JsonRpcErrorCodes } from "./protocol/errors.js";
+export type { AhpErrorCode, JsonRpcErrorCode } from "./protocol/errors.js";
 export type { Snapshot as IStateSnapshot } from "./protocol/state.js";
 export declare const JSON_RPC_PARSE_ERROR: -32700;
 export declare const JSON_RPC_INTERNAL_ERROR: -32603;

package/vscode/src/vs/platform/agentHost/common/state/sessionProtocol.js

@@ -1,5 +1,8 @@
 
-export { ContentEncoding, ReconnectResultType } from './protocol/commands.js';
+export { ContentEncoding, ReconnectResultType, ResourceType, ResourceWriteMode } from './protocol/common/commands.js';
+import './protocol/channels-session/commands.js';
+import './protocol/channels-changeset/commands.js';
+export { ResourceChangeType } from './protocol/channels-resource-watch/state.js';
 
 const AHP_UNSUPPORTED_PROTOCOL_VERSION = -32005;
 function isJsonRpcRequest(msg) {

package/vscode/src/vs/platform/agentHost/common/state/sessionState.d.ts

@@ -1,6 +1,8 @@
 import { URI as ResourceURI } from "../../../../base/common/uri.js";
-import { ToolResultFileEditContent, type ActiveTurn, type RootState, type SessionState, type SessionSummary, type ToolCallCancelledState, type ToolCallCompletedState, type ToolCallResult, type ToolCallState, type ToolResultContent, type ToolResultSubagentContent, type URI as ProtocolURI, type UserMessage, TerminalState } from "./protocol/state.js";
-export { type ActiveTurn, type AgentInfo, type ConfigPropertySchema, type ConfigSchema, type ContentRef, type ErrorInfo, type ProjectInfo, type MarkdownResponsePart, type MessageAttachment, type MessageResourceAttachment, type ReasoningResponsePart, type ResponsePart, type RootState, type SessionActiveClient, type SessionConfigState, type FileEdit as ISessionFileDiff, type ModelSelection, type SessionModelInfo, type SessionState, type SessionSummary, type Snapshot, type TerminalState, type ToolAnnotations, type ToolCallCancelledState, type ToolCallCompletedState, type ToolCallPendingConfirmationState, type ToolCallPendingResultConfirmationState, type ToolCallResponsePart, type ToolCallResult, type ToolCallRunningState, type ToolCallState, type ToolCallStreamingState, type ToolDefinition, type CustomizationRef, type SessionCustomization, type ToolResultEmbeddedResourceContent as IToolResultBinaryContent, type ToolResultContent, type ToolResultFileEditContent, type ToolResultSubagentContent, type ToolResultTextContent, type Turn, type UsageInfo, type UserMessage, type PendingMessage, type StringOrMarkdown, type URI, type SessionInputRequest, type SessionInputQuestion, type SessionInputAnswer, type SessionInputOption, CustomizationStatus, MessageAttachmentKind, PendingMessageKind, PolicyState, ResponsePartKind, SessionInputAnswerState, SessionInputAnswerValueKind, SessionInputQuestionKind, SessionInputResponseKind, SessionLifecycle, SessionStatus, ToolCallConfirmationReason, ToolCallCancellationReason, ToolCallStatus, ToolResultContentType, TurnState, } from "./protocol/state.js";
+import { IProductService } from "../../../product/common/productService.service.js";
+import { TerminalState, ToolResultFileEditContent, type ActiveTurn, type ChangesetState, type URI as ProtocolURI, type RootState, type SessionState, type SessionSummary, type TextRange, type ToolCallCancelledState, type ToolCallCompletedState, type ToolCallResult, type ToolCallState, type ToolResultContent, type ToolResultSubagentContent, type Message } from "./protocol/state.js";
+export { ChangesetOperationScope, ChangesetOperationStatus, ChangesetStatus, CustomizationLoadStatus, CustomizationType, MessageAttachmentKind, MessageKind, PendingMessageKind, PolicyState, ResponsePartKind, SessionInputAnswerState, SessionInputAnswerValueKind, SessionInputQuestionKind, SessionInputResponseKind, SessionLifecycle, SessionStatus, ToolCallCancellationReason, ToolCallConfirmationReason, ToolCallContributorKind, ToolCallStatus, ToolResultContentType, TurnState, type ActiveTurn, type AgentCustomization, type AgentInfo, type AgentSelection, type ChangesetFile, type ChangesetOperation, type ChangesetState, type ChangesetSummary, type ChildCustomization, type ClientPluginCustomization, type ConfigPropertySchema, type ConfigSchema, type ContentRef, type Customization, type CustomizationDegradedState, type CustomizationErrorState, type CustomizationLoadedState, type CustomizationLoadingState, type CustomizationLoadState, type DirectoryCustomization, type ErrorInfo, type HookCustomization, type FileEdit as ISessionFileDiff, type ToolResultEmbeddedResourceContent as IToolResultBinaryContent, type MarkdownResponsePart, type McpServerCustomization, type MessageAttachment, type MessageResourceAttachment, type ModelSelection, type PendingMessage, type PluginCustomization, type ProjectInfo, type PromptCustomization, type ReasoningResponsePart, type ResponsePart, type RootState, type RuleCustomization, type SessionActiveClient, type SessionConfigState, type SessionInputAnswer, type SessionInputOption, type SessionInputQuestion, type SessionInputRequest, type SessionModelInfo, type SessionState, type SessionSummary, type SkillCustomization, type Snapshot, type StringOrMarkdown, type TerminalState, type ToolAnnotations, type ToolCallCancelledState, type ToolCallCompletedState, type ToolCallPendingConfirmationState, type ToolCallPendingResultConfirmationState, type ToolCallResponsePart, type ToolCallResult, type ToolCallRunningState, type ToolCallState, type ToolCallStreamingState, type ToolCallContributor, type ToolDefinition, type ToolResultContent, type ToolResultFileEditContent, type ToolResultSubagentContent, type ToolResultTextContent, type Turn, type URI, type UsageInfo, type Message } from "./protocol/state.js";
+export { ChangesetOperationTargetKind, type ChangesetOperationFollowUp, type ChangesetOperationTarget } from "./protocol/commands.js";
 /**
  * The kind of file edit operation. Derived from the presence/absence of
  * `before`/`after` in {@link ToolResultFileEditContent}.
@@ -16,7 +18,67 @@ export declare enum FileEditKind {
     Rename = "rename"
 }
 /** URI for the root state subscription. */
-export declare const ROOT_STATE_URI = "agenthost:/root";
+export declare const ROOT_STATE_URI = "ahp-root://";
+/** Scheme used by {@link ROOT_STATE_URI}. */
+export declare const AHP_ROOT_SCHEME = "ahp-root";
+/** Scheme used by resource-watch channel URIs (`ahp-resource-watch:/<encoded>`). */
+export declare const AHP_RESOURCE_WATCH_SCHEME = "ahp-resource-watch";
+/**
+ * Encode a resource-watch descriptor into its canonical channel URI. The
+ * descriptor is serialised into the URI path so the receiver can recover
+ * the watch parameters without any server-side bookkeeping — subscribe is
+ * the only point where state is materialised (an `IFileService` watcher
+ * is attached on the first subscriber and held through a grace window
+ * after the last drops).
+ */
+export declare function buildResourceWatchChannelUri(descriptor: {
+    readonly root: string;
+    readonly recursive?: boolean;
+    readonly excludes?: {
+        items: readonly string[];
+    };
+    readonly includes?: {
+        items: readonly string[];
+    };
+}): string;
+/**
+ * Inverse of {@link buildResourceWatchChannelUri}. Returns `undefined` if
+ * `uri` is not a well-formed `ahp-resource-watch:` URI — callers should
+ * surface that as a not-found error to the client.
+ */
+export declare function parseResourceWatchChannelUri(uri: string): {
+    root: string;
+    recursive: boolean;
+    excludes?: {
+        items: string[];
+    };
+    includes?: {
+        items: string[];
+    };
+} | undefined;
+/** Returns `true` when `uri` identifies a resource-watch channel. */
+export declare function isAhpResourceWatchChannel(uri: string): boolean;
+/**
+ * Returns `true` when `uri` identifies the root channel, regardless of
+ * whether the caller passes the canonical wire form (`'ahp-root://'`) or a
+ * variant that has been round-tripped through the workbench {@link URI} class
+ * (which normalizes the authority-less form to `'ahp-root:'`). Always prefer
+ * this helper over a direct `=== ROOT_STATE_URI` comparison so the two
+ * spellings stay interchangeable.
+ */
+export declare function isAhpRootChannel(uri: string): boolean;
+/**
+ * Mints a session-unique opaque id for a customization, derived from its
+ * source URI and (when present) its `range` within the source. Plugins MAY
+ * declare multiple children (e.g. MCP servers, hooks) inside the same
+ * manifest file; including the range disambiguates them without an extra
+ * mapping table.
+ *
+ * The range is appended as a reserved `#range=` query-style suffix; any
+ * existing `#` in the URI is percent-encoded first so a source URI that
+ * already contains a fragment cannot collide with a ranged id.
+ */
+export declare function customizationId(uri: string, range?: TextRange): string;
 /**
  * A tool call in a terminal state, stored in completed turns.
  */
@@ -68,16 +130,18 @@ export declare function isSubagentSession(uri: ProtocolURI | ResourceURI): boole
 export declare function buildSubagentSessionUriPrefix(parentSession: ProtocolURI | ResourceURI): string;
 export declare function createRootState(): RootState;
 export declare function createSessionState(summary: SessionSummary): SessionState;
-export declare function createActiveTurn(id: string, userMessage: UserMessage): ActiveTurn;
+export declare function createActiveTurn(id: string, message: Message): ActiveTurn;
 export declare enum StateComponents {
     Root = 0,
     Session = 1,
-    Terminal = 2
+    Terminal = 2,
+    Changeset = 3
 }
 export type ComponentToState = {
     [StateComponents.Root]: RootState;
     [StateComponents.Session]: SessionState;
     [StateComponents.Terminal]: TerminalState;
+    [StateComponents.Changeset]: ChangesetState;
 };
 /**
  * VS Code-side alias for the protocol's open `_meta` property bag on
@@ -137,3 +201,57 @@ export declare function readSessionGitState(meta: SessionMeta | undefined): ISes
  * Returns `undefined` if the result would be empty.
  */
 export declare function withSessionGitState(meta: SessionMeta | undefined, gitState: ISessionGitState | undefined): SessionMeta | undefined;
+/**
+ * VS Code-side alias for the protocol's open `_meta` property bag on
+ * {@link RootState}. Keys SHOULD be namespaced to avoid collisions; values MUST
+ * be JSON-serializable.
+ */
+export type RootMeta = Record<string, unknown>;
+/**
+ * Reserved key under {@link RootMeta} for the well-known host-build payload.
+ * Value at this key, when present, MUST be shaped like {@link IHostBuildInfo}.
+ * This is a VS Code-specific convention layered on top of the protocol's
+ * generic `_meta` bag — the protocol itself does not know about build info.
+ */
+export declare const ROOT_META_HOST_BUILD_KEY = "hostBuild";
+/**
+ * Build information about the program hosting the agent host (the VS Code CLI),
+ * carried under {@link RootMeta} at {@link ROOT_META_HOST_BUILD_KEY}. Lets a
+ * client see which build is hosting it — useful when inspecting the output of a
+ * remote agent host.
+ *
+ * All fields except {@link version} are optional — a build that does not track
+ * a particular field should omit it.
+ */
+export interface IHostBuildInfo {
+    /** Product version (e.g. `1.96.0`). */
+    readonly version: string;
+    /** Commit SHA of the build, if known. */
+    readonly commit?: string;
+    /** Build date (ISO 8601), if known. */
+    readonly date?: string;
+    /** Release quality (e.g. `stable`, `insider`), if known. */
+    readonly quality?: string;
+}
+/**
+ * Derives {@link IHostBuildInfo} from the host's {@link IProductService}.
+ */
+export declare function hostBuildInfoFromProduct(productService: IProductService): IHostBuildInfo;
+/**
+ * Reads the well-known host-build payload from {@link RootMeta}, if present.
+ * Returns `undefined` when the meta bag is absent or the value at the host-build
+ * key is not a plain object with a string `version`. Optional fields with wrong
+ * types are silently dropped.
+ */
+export declare function readHostBuildInfo(meta: RootMeta | undefined): IHostBuildInfo | undefined;
+/**
+ * Returns a new {@link RootMeta} with the host-build payload set to
+ * `buildInfo`, or with the slot removed if `buildInfo` is `undefined`. Returns
+ * `undefined` if the result would be empty.
+ */
+export declare function withHostBuildInfo(meta: RootMeta | undefined, buildInfo: IHostBuildInfo | undefined): RootMeta | undefined;
+/**
+ * Formats {@link IHostBuildInfo} as a short single-line human-readable string,
+ * e.g. `1.96.0 (commit abc1234, 2024-01-02T03:04:05Z, insider)`.
+ */
+export declare function formatHostBuildInfo(info: IHostBuildInfo): string;

package/vscode/src/vs/platform/agentHost/common/state/sessionState.js

@@ -1,10 +1,16 @@
 
+import '../../../../base/common/lazy.js';
 import '../../../../base/common/errors.js';
-import '../../../../base/common/charCode.js';
-import '../../../../base/common/marshallingIds.js';
-import '../../../../base/common/path.js';
-import '../../../../base/common/platform.js';
-export { CustomizationStatus, MessageAttachmentKind, PendingMessageKind, PolicyState, ResponsePartKind, SessionInputAnswerState, SessionInputAnswerValueKind, SessionInputQuestionKind, SessionInputResponseKind, SessionLifecycle, SessionStatus, ToolCallCancellationReason, ToolCallConfirmationReason, ToolCallStatus, ToolResultContentType, TurnState } from './protocol/state.js';
+import '../../../../base/common/lifecycle.js';
+import { URI } from '../../../../base/common/uri.js';
+export { PolicyState } from './protocol/channels-root/state.js';
+export { CustomizationLoadStatus, CustomizationType, MessageAttachmentKind, MessageKind, PendingMessageKind, ResponsePartKind, SessionInputAnswerState, SessionInputAnswerValueKind, SessionInputQuestionKind, SessionInputResponseKind, SessionLifecycle, SessionStatus, ToolCallCancellationReason, ToolCallConfirmationReason, ToolCallContributorKind, ToolCallStatus, ToolResultContentType, TurnState } from './protocol/channels-session/state.js';
+import './protocol/channels-terminal/state.js';
+export { ChangesetOperationScope, ChangesetOperationStatus, ChangesetStatus } from './protocol/channels-changeset/state.js';
+import './protocol/channels-resource-watch/state.js';
+import './protocol/common/commands.js';
+import './protocol/channels-session/commands.js';
+export { ChangesetOperationTargetKind } from './protocol/channels-changeset/commands.js';
 
 var FileEditKind;
 (function(FileEditKind) {
@@ -13,12 +19,29 @@ var FileEditKind;
     FileEditKind["Delete"] = "delete";
     FileEditKind["Rename"] = "rename";
 })(FileEditKind || (FileEditKind = {}));
-const ROOT_STATE_URI = "agenthost:/root";
+const ROOT_STATE_URI = "ahp-root://";
+const AHP_ROOT_SCHEME = "ahp-root";
+function isAhpRootChannel(uri) {
+    if (uri === ROOT_STATE_URI) {
+        return true;
+    }
+    try {
+        return URI.parse(uri).scheme === AHP_ROOT_SCHEME;
+    } catch {
+        return false;
+    }
+}
+function customizationId(uri, range) {
+    {
+        return uri;
+    }
+}
 var StateComponents;
 (function(StateComponents) {
     StateComponents[StateComponents["Root"] = 0] = "Root";
     StateComponents[StateComponents["Session"] = 1] = "Session";
     StateComponents[StateComponents["Terminal"] = 2] = "Terminal";
+    StateComponents[StateComponents["Changeset"] = 3] = "Changeset";
 })(StateComponents || (StateComponents = {}));
 
-export { FileEditKind, ROOT_STATE_URI, StateComponents };
+export { AHP_ROOT_SCHEME, FileEditKind, ROOT_STATE_URI, StateComponents, customizationId, isAhpRootChannel };

package/vscode/src/vs/platform/agentPlugins/common/pluginParsers.d.ts

@@ -0,0 +1,171 @@
+import { URI } from "../../../base/common/uri.js";
+import { IFileService } from "../../files/common/files.service.js";
+import { IMcpServerConfiguration } from "../../mcp/common/mcpPlatformTypes.js";
+import { type AgentCustomization, type HookCustomization, type McpServerCustomization, type RuleCustomization, type SkillCustomization } from "../../agentHost/common/state/protocol/state.js";
+/** A single hook command to execute. Platform resolution happens at conversion time. */
+export interface IParsedHookCommand {
+    /** Cross-platform default command. */
+    readonly command?: string;
+    /** Windows-specific command. */
+    readonly windows?: string;
+    /** Linux-specific command. */
+    readonly linux?: string;
+    /** macOS-specific command. */
+    readonly osx?: string;
+    /** Working directory. */
+    readonly cwd?: URI;
+    /** Environment variables. */
+    readonly env?: Record<string, string>;
+    /** Timeout in seconds. */
+    readonly timeout?: number;
+    /** URI of the file this hook was defined in. */
+    readonly sourceUri?: URI;
+}
+export declare namespace IParsedHookCommand {
+    function isEquals(a: IParsedHookCommand | undefined, b: IParsedHookCommand | undefined): boolean;
+}
+/** A group of hooks for a single lifecycle event. */
+export interface IParsedHookGroup {
+    /** Canonical hook type identifier (e.g. `'SessionStart'`, `'PreToolUse'`). */
+    readonly type: string;
+    /** The commands to execute for this hook type. */
+    readonly commands: readonly IParsedHookCommand[];
+    /** URI where this hook is defined. */
+    readonly uri: URI;
+    /** Original key as it appears in the hook file. */
+    readonly originalId: string;
+    /**
+     * Protocol-level projection of this hook group as a child customization.
+     * Multiple groups parsed from the same file share the same `customization.id`
+     * so consumers can dedupe by id when collecting customizations.
+     */
+    readonly customization: HookCustomization;
+}
+export interface IMcpServerDefinition {
+    readonly name: string;
+    readonly configuration: IMcpServerConfiguration;
+    readonly uri: URI;
+    /** Protocol-level projection of this MCP server as a child customization. */
+    readonly customization: McpServerCustomization;
+}
+/** A named resource (skill, agent, command, or instruction) within a plugin. */
+export interface INamedPluginResource {
+    readonly uri: URI;
+    readonly name: string;
+    /**
+     * Optional short description, populated for resources whose readers
+     * parse it from the file's YAML frontmatter (e.g. agents).
+     */
+    readonly description?: string;
+}
+/** A parsed agent paired with its protocol-level child customization. */
+export interface IParsedAgent extends INamedPluginResource {
+    readonly customization: AgentCustomization;
+}
+/** A parsed skill paired with its protocol-level child customization. */
+export interface IParsedSkill extends INamedPluginResource {
+    readonly customization: SkillCustomization;
+}
+/** A parsed rule (instruction) paired with its protocol-level child customization. */
+export interface IParsedRule extends INamedPluginResource {
+    readonly customization: RuleCustomization;
+}
+/** The result of parsing a single plugin directory. */
+export interface IParsedPlugin {
+    readonly hooks: readonly IParsedHookGroup[];
+    readonly mcpServers: readonly IMcpServerDefinition[];
+    readonly skills: readonly IParsedSkill[];
+    readonly agents: readonly IParsedAgent[];
+    readonly instructions: readonly IParsedRule[];
+}
+export declare enum PluginFormat {
+    Copilot = 0,
+    Claude = 1,
+    OpenPlugin = 2
+}
+export interface IPluginFormatConfig {
+    readonly format: PluginFormat;
+    readonly manifestPath: string;
+    readonly hookConfigPath: string;
+    readonly pluginRootToken: string | undefined;
+    readonly pluginRootEnvVar: string | undefined;
+    /** Parses hooks from a JSON object using the format's conventions. */
+    parseHooks(hookUri: URI, json: unknown, pluginUri: URI, workspaceRoot: URI | undefined, userHome: string): IParsedHookGroup[];
+}
+export declare function detectPluginFormat(pluginUri: URI, fileService: IFileService): Promise<IPluginFormatConfig>;
+export interface IComponentPathConfig {
+    readonly paths: readonly string[];
+    readonly exclusive: boolean;
+}
+/**
+ * Parses a manifest component path field into a normalized config.
+ * Supports `undefined`, `string`, `string[]`, and `{ paths: string[], exclusive?: boolean }`.
+ */
+export declare function parseComponentPathConfig(raw: unknown): IComponentPathConfig;
+/**
+ * Resolves the directories to scan for a given component type, combining
+ * the default directory with any custom paths from the manifest config.
+ * Paths that resolve outside the boundary are silently ignored.
+ * @param boundaryUri The outermost directory that resolved paths must stay within. Defaults to {@link pluginUri}.
+ */
+export declare function resolveComponentDirs(pluginUri: URI, defaultDir: string, config: IComponentPathConfig, boundaryUri?: URI): readonly URI[];
+/**
+ * Extracts the MCP server map from a raw JSON value. Accepts both the
+ * wrapped format `{ mcpServers: { … } }` and the flat format.
+ */
+export declare function resolveMcpServersMap(raw: unknown): Record<string, unknown> | undefined;
+/**
+ * Normalizes a raw JSON value into a typed MCP server configuration.
+ */
+export declare function normalizeMcpServerConfiguration(rawConfig: unknown): IMcpServerConfiguration | undefined;
+/**
+ * Replaces a plugin-root token in a shell command string with the
+ * given fsPath, shell-quoting if the path contains special characters.
+ */
+export declare function shellQuotePluginRootInCommand(command: string, fsPath: string, token: string): string;
+/**
+ * Replaces plugin-root token references in MCP server definition string fields
+ * with the plugin root filesystem path.
+ */
+export declare function interpolateMcpPluginRoot(def: IMcpServerDefinition, fsPath: string, token: string, envVar: string): IMcpServerDefinition;
+/**
+ * Converts bare `${VAR}` environment-variable references to VS Code `${env:VAR}` syntax.
+ */
+export declare function convertBareEnvVarsToVsCodeSyntax(def: IMcpServerDefinition): IMcpServerDefinition;
+/**
+ * Applies plugin-root token interpolation to hook commands for
+ * Claude and OpenPlugin formats.
+ */
+export declare function interpolateHookPluginRoot(hookUri: URI, json: unknown, pluginUri: URI, workspaceRoot: URI | undefined, userHome: string, token: string, envVar: string): IParsedHookGroup[];
+export declare function readJsonFile(uri: URI, fileService: IFileService): Promise<unknown | undefined>;
+export declare function pathExists(resource: URI, fileService: IFileService): Promise<boolean>;
+export declare function readSkills(pluginRoot: URI, dirs: readonly URI[], fileService: IFileService): Promise<readonly INamedPluginResource[]>;
+export declare function readMarkdownComponents(dirs: readonly URI[], fileService: IFileService): Promise<readonly INamedPluginResource[]>;
+/**
+ * Reads rule/instruction files from plugin `rules` component directories.
+ *
+ * Open Plugins rules are conventionally `.mdc` files. We also accept
+ * `.instructions.md` for compatibility with VS Code-discovered instructions
+ * bundled as synthetic plugins.
+ */
+export declare function readInstructionComponents(dirs: readonly URI[], fileService: IFileService): Promise<readonly INamedPluginResource[]>;
+/**
+ * Reads `.md` files in agent directories and enriches each entry with
+ * the optional `name` / `description` from YAML frontmatter. Falls back
+ * to the file-derived name when frontmatter is missing or unreadable.
+ */
+export declare function readAgentComponents(dirs: readonly URI[], fileService: IFileService): Promise<readonly INamedPluginResource[]>;
+export declare function parseAgentFile(uri: URI, fileService: IFileService): Promise<{
+    name: string;
+    description?: string;
+}>;
+export declare function parseSkillFile(uri: URI, fileService: IFileService): Promise<{
+    description?: string;
+}>;
+export declare function parseMcpServerDefinitionMap(definitionURI: URI, raw: unknown, pluginFsPath: string, formatConfig: IPluginFormatConfig): IMcpServerDefinition[];
+/**
+ * Parses a plugin directory to extract hooks, MCP servers, skills, agents,
+ * and instructions.
+ * This is the main entry point for the agent host to discover plugin contents.
+ */
+export declare function parsePlugin(pluginUri: URI, fileService: IFileService, workspaceRoot: URI | undefined, userHome: string, boundaryUri?: URI): Promise<IParsedPlugin>;