@codingame/monaco-vscode-api 31.0.1 → 32.0.1

package/vscode/src/vs/workbench/contrib/chat/common/model/chatModel.js

@@ -5,7 +5,7 @@ import { BugIndicatingError } from '../../../../../base/common/errors.js';
 import { encodeHex, VSBuffer, decodeHex } from '../../../../../base/common/buffer.js';
 import { Emitter } from '../../../../../base/common/event.js';
 import { MarkdownString, isMarkdownString } from '../../../../../base/common/htmlContent.js';
-import { Disposable, MutableDisposable } from '../../../../../base/common/lifecycle.js';
+import { DisposableStore, Disposable, MutableDisposable } from '../../../../../base/common/lifecycle.js';
 import { ResourceMap } from '../../../../../base/common/map.js';
 import { revive } from '../../../../../base/common/marshalling.js';
 import { Schemas } from '../../../../../base/common/network.js';
@@ -26,6 +26,8 @@ import { IChatToolInvocation, ChatResponseClearToPreviousToolInvocationReason, R
 import { IChatService } from '../chatService/chatService.service.js';
 import { ChatAgentLocation, ChatModeKind } from '../constants.js';
 import { ChatToolInvocation } from './chatProgressTypes/chatToolInvocation.js';
+import { ChatPlanReviewData } from './chatProgressTypes/chatPlanReviewData.js';
+import { ChatQuestionCarouselData } from './chatProgressTypes/chatQuestionCarouselData.js';
 import { ToolDataSource } from '../tools/languageModelToolsService.js';
 import { ModifiedFileEntryState } from '../editing/chatEditingService.js';
 import { IChatEditingService } from '../editing/chatEditingService.service.js';
@@ -34,7 +36,7 @@ import { IChatAgentService } from '../participants/chatAgents.service.js';
 import { reviveParsedChatRequest, ChatRequestTextPart } from '../requestParser/chatParserTypes.js';
 import { chatSessionResourceToId, LocalChatSessionUri } from './chatUri.js';
 import { observableFromEvent } from '../../../../../base/common/observableInternal/observables/observableFromEvent.js';
-import { autorunSelfDisposable, autorun } from '../../../../../base/common/observableInternal/reactions/autorun.js';
+import { registerAutorunSelfDisposable, autorun } from '../../../../../base/common/observableInternal/reactions/autorun.js';
 import { constObservable } from '../../../../../base/common/observableInternal/observables/constObservable.js';
 import { observableValueOpts } from '../../../../../base/common/observableInternal/observables/observableValueOpts.js';
 import { observableValue } from '../../../../../base/common/observableInternal/observables/observableValue.js';
@@ -283,6 +285,7 @@ class AbstractResponse {
             case "progressTask":
             case "progressTaskSerialized":
             case "warning":
+            case "info":
                 segment = {
                     text: part.content.value
                 };
@@ -304,7 +307,7 @@ class AbstractResponse {
             blocks.push(currentBlockSegments.join(""));
         }
         if (hasEditGroupsAfterLastClear) {
-            blocks.push(( localize(7409, "Made changes.")));
+            blocks.push(( localize(7729, "Made changes.")));
         }
         return blocks.join("\n\n");
     }
@@ -376,11 +379,12 @@ class Response extends AbstractResponse {
             kind: "treeData",
             treeData: v
         }))));
-        this._onDidChangeValue = ( new Emitter());
+        this._store = ( new DisposableStore());
+        this._onDidChangeValue = this._store.add(( new Emitter()));
         this._citations = [];
     }
     dispose() {
-        this._onDidChangeValue.dispose();
+        this._store.dispose();
     }
     clear() {
         this._responseParts = [];
@@ -412,12 +416,12 @@ class Response extends AbstractResponse {
         if (progress.kind === "clearToPreviousToolInvocation") {
             if (progress.reason === ChatResponseClearToPreviousToolInvocationReason.CopyrightContentRetry) {
                 this.clearToPreviousToolInvocation(( localize(
-                    7410,
+                    7730,
                     "Response cleared due to possible match to public code, retrying with modified prompt."
                 )));
             } else if (progress.reason === ChatResponseClearToPreviousToolInvocationReason.FilteredContentRetry) {
                 this.clearToPreviousToolInvocation(( localize(
-                    7411,
+                    7731,
                     "Response cleared due to content safety filters, retrying with modified prompt."
                 )));
             } else {
@@ -481,7 +485,7 @@ class Response extends AbstractResponse {
                 this._contentChanged(false);
             });
         } else if (progress.kind === "toolInvocation") {
-            autorunSelfDisposable(reader => {
+            registerAutorunSelfDisposable(this._store, reader => {
                 progress.state.read(reader);
                 this._contentChanged(false);
                 if (IChatToolInvocation.isComplete(progress, reader)) {
@@ -502,6 +506,22 @@ class Response extends AbstractResponse {
         this._citations.push(citation);
         this._contentChanged();
     }
+    resolveInlineReference(resolveId, resolvedReference) {
+        for (let i = 0; i < this._responseParts.length; i++) {
+            const current = this._responseParts[i];
+            if (current.kind !== "inlineReference" || current.resolveId !== resolveId) {
+                continue;
+            }
+            this._responseParts[i] = {
+                ...current,
+                inlineReference: resolvedReference.inlineReference,
+                name: resolvedReference.name ?? current.name
+            };
+            this._contentChanged();
+            return true;
+        }
+        return false;
+    }
     _mergeOrPushTextEditGroup(uri, edits, done, isExternalEdit) {
         for (const candidate of this._responseParts) {
             if (candidate.kind === "textEditGroup" && !candidate.done && isEqual(candidate.uri, uri)) {
@@ -749,17 +769,17 @@ class ChatResponseModel extends Disposable {
                         return title ? (isMarkdownString(title) ? title.value : title) : undefined;
                     }
                     if (state.type === IChatToolInvocation.StateKind.WaitingForPostApproval) {
-                        return localize(7412, "Approve tool result?");
+                        return localize(7732, "Approve tool result?");
                     }
                 }
                 if (part.kind === "confirmation" && !part.isUsed) {
                     return part.title;
                 }
                 if (part.kind === "questionCarousel" && !part.isUsed) {
-                    return localize(7413, "Answer questions to continue...");
+                    return localize(7733, "Answer questions to continue...");
                 }
                 if (part.kind === "planReview" && !part.isUsed) {
-                    return localize(7414, "Review the plan to continue...");
+                    return localize(7734, "Review the plan to continue...");
                 }
                 if (part.kind === "elicitation2" && part.state.read(r) === ElicitationState.Pending) {
                     const title = part.title;
@@ -818,6 +838,9 @@ class ChatResponseModel extends Disposable {
     updateContent(responsePart, quiet) {
         this._response.updateContent(responsePart, quiet);
     }
+    resolveInlineReference(resolveId, resolvedReference) {
+        return this._response.resolveInlineReference(resolveId, resolvedReference);
+    }
     addUndoStop(undoStop) {
         this._onDidChange.fire({
             reason: "undoStop",
@@ -882,6 +905,10 @@ class ChatResponseModel extends Disposable {
         for (const part of this._response.value) {
             if (part.kind === "toolInvocation" && part instanceof ChatToolInvocation) {
                 part.cancelFromStreaming(ToolConfirmKind.Skipped);
+            } else if (part instanceof ChatPlanReviewData) {
+                part.dismiss();
+            } else if (part instanceof ChatQuestionCarouselData) {
+                part.dismiss(undefined);
             }
         }
         this._modelState.set({
@@ -1069,6 +1096,12 @@ let ChatModel = ChatModel_1 = class ChatModel extends Disposable {
     setRepoData(data) {
         this._repoData = data;
     }
+    get workingDirectory() {
+        return this._workingDirectory;
+    }
+    setWorkingDirectory(uri) {
+        this._workingDirectory = uri;
+    }
     getPendingRequests() {
         return this._pendingRequests;
     }
@@ -1266,6 +1299,7 @@ let ChatModel = ChatModel_1 = class ChatModel extends Disposable {
         this.dataSerializer = dataRef?.serializer;
         this._initialResponderUsername = initialData?.responderUsername;
         this._repoData = isValidFullData && initialData.repoData ? initialData.repoData : undefined;
+        this._workingDirectory = isValidFullData && initialData.workingDirectory ? ( URI.parse(initialData.workingDirectory)) : undefined;
         if (isValidFullData && initialData.pendingRequests) {
             this._pendingRequests = this._deserializePendingRequests(initialData.pendingRequests);
         }
@@ -1759,7 +1793,8 @@ let ChatModel = ChatModel_1 = class ChatModel extends Disposable {
             sessionId: this.sessionId,
             creationDate: this._timestamp,
             customTitle: this._customTitle,
-            inputState: this.inputModel.toJSON()
+            inputState: this.inputModel.toJSON(),
+            workingDirectory: this._workingDirectory?.toString()
         };
     }
     dispose() {
@@ -1809,7 +1844,7 @@ function getCodeCitationsMessage(citations) {
         return "";
     }
     const licenseTypes = citations.reduce((set, c) => set.add(c.license), ( new Set()));
-    const label = licenseTypes.size === 1 ? ( localize(7415, "Similar code found with 1 license type", licenseTypes.size)) : ( localize(7416, "Similar code found with {0} license types", licenseTypes.size));
+    const label = licenseTypes.size === 1 ? ( localize(7735, "Similar code found with 1 license type", licenseTypes.size)) : ( localize(7736, "Similar code found with {0} license types", licenseTypes.size));
     return label;
 }
 function serializeSendOptions(options) {

package/vscode/src/vs/workbench/contrib/chat/common/model/chatProgressTypes/chatElicitationRequestPart.d.ts

@@ -13,13 +13,20 @@ export declare class ChatElicitationRequestPart implements IChatElicitationReque
     readonly source?: ToolDataSource | undefined;
     readonly moreActions?: IAction[] | undefined;
     readonly onHide?: (() => void) | undefined;
+    readonly riskAssessment?: {
+        toolId: string;
+        parameters: unknown;
+    } | undefined;
     readonly kind = "elicitation2";
     state: import("../../../../../../base/common/observable.js").ISettableObservable<ElicitationState, void>;
     acceptedResult?: Record<string, unknown>;
     private readonly _isHiddenValue;
     readonly isHidden: IObservable<boolean>;
     reject?: (() => Promise<void>) | undefined;
-    constructor(title: string | IMarkdownString, message: string | IMarkdownString, subtitle: string | IMarkdownString, acceptButtonLabel: string, rejectButtonLabel: string | undefined, _accept: (value: IAction | true) => Promise<ElicitationState>, reject?: () => Promise<ElicitationState>, source?: ToolDataSource | undefined, moreActions?: IAction[] | undefined, onHide?: (() => void) | undefined);
+    constructor(title: string | IMarkdownString, message: string | IMarkdownString, subtitle: string | IMarkdownString, acceptButtonLabel: string, rejectButtonLabel: string | undefined, _accept: (value: IAction | true) => Promise<ElicitationState>, reject?: () => Promise<ElicitationState>, source?: ToolDataSource | undefined, moreActions?: IAction[] | undefined, onHide?: (() => void) | undefined, riskAssessment?: {
+        toolId: string;
+        parameters: unknown;
+    } | undefined);
     accept(value: IAction | true): Promise<void>;
     hide(): void;
     toJSON(): {

package/vscode/src/vs/workbench/contrib/chat/common/model/chatProgressTypes/chatElicitationRequestPart.js

@@ -5,7 +5,7 @@ import { observableValue } from '../../../../../../base/common/observableInterna
 
 class ChatElicitationRequestPart {
     constructor(title, message, subtitle, acceptButtonLabel, rejectButtonLabel,
-    _accept, reject, source, moreActions, onHide) {
+    _accept, reject, source, moreActions, onHide, riskAssessment) {
         this.title = title;
         this.message = message;
         this.subtitle = subtitle;
@@ -15,6 +15,7 @@ class ChatElicitationRequestPart {
         this.source = source;
         this.moreActions = moreActions;
         this.onHide = onHide;
+        this.riskAssessment = riskAssessment;
         this.kind = 'elicitation2';
         this.state = observableValue('state', ElicitationState.Pending);
         this._isHiddenValue = observableValue('isHidden', false);

package/vscode/src/vs/workbench/contrib/chat/common/model/chatProgressTypes/chatPlanReviewData.d.ts

@@ -22,5 +22,7 @@ export declare class ChatPlanReviewData implements IChatPlanReview {
     draftFeedback: string | undefined;
     draftCollapsed: boolean | undefined;
     constructor(title: string, content: string, actions: IChatPlanApprovalAction[], canProvideFeedback: boolean, planUri?: UriComponents | undefined, resolveId?: string | undefined, data?: IChatPlanReviewResult | undefined, isUsed?: boolean | undefined, source?: ToolDataSource | undefined);
+    /** Dismiss without a user choice (e.g. the response was cancelled). */
+    dismiss(): void;
     toJSON(): IChatPlanReview;
 }

package/vscode/src/vs/workbench/contrib/chat/common/model/chatProgressTypes/chatPlanReviewData.js

@@ -25,6 +25,15 @@ class ChatPlanReviewData {
         this.kind = "planReview";
         this.completion = ( new DeferredPromise());
     }
+    dismiss() {
+        if (this.isUsed) {
+            return;
+        }
+        this.isUsed = true;
+        this.draftFeedback = undefined;
+        this.draftCollapsed = undefined;
+        void this.completion.complete(undefined);
+    }
     toJSON() {
         return {
             kind: this.kind,

package/vscode/src/vs/workbench/contrib/chat/common/model/chatProgressTypes/chatQuestionCarouselData.d.ts

@@ -28,6 +28,11 @@ export declare class ChatQuestionCarouselData implements IChatQuestionCarousel {
      * directly in the associated terminal instead of using the carousel UI.
      */
     dismissedByTerminalInput?: boolean;
+    /**
+     * Marks the carousel as dismissed with the given answers and clears draft
+     * state. Safe to call multiple times — subsequent calls are no-ops.
+     */
+    dismiss(answers: IChatQuestionAnswers | undefined): void;
     constructor(questions: IChatQuestion[], allowSkip: boolean, resolveId?: string | undefined, data?: IChatQuestionAnswers | undefined, isUsed?: boolean | undefined, message?: (string | IMarkdownString) | undefined, source?: ToolDataSource | undefined, terminalId?: string | undefined);
     toJSON(): IChatQuestionCarousel;
 }

package/vscode/src/vs/workbench/contrib/chat/common/model/chatProgressTypes/chatQuestionCarouselData.js

@@ -2,6 +2,19 @@
 import { DeferredPromise } from '../../../../../../base/common/async.js';
 
 class ChatQuestionCarouselData {
+    dismiss(answers) {
+        if (this.isUsed) {
+            return;
+        }
+        this.data = answers ?? {};
+        this.isUsed = true;
+        this.draftAnswers = undefined;
+        this.draftCurrentIndex = undefined;
+        this.draftCollapsed = undefined;
+        void this.completion.complete({
+            answers
+        });
+    }
     constructor(questions, allowSkip, resolveId, data, isUsed, message, source, terminalId) {
         this.questions = questions;
         this.allowSkip = allowSkip;

package/vscode/src/vs/workbench/contrib/chat/common/model/chatProgressTypes/chatToolInvocation.js

@@ -69,7 +69,7 @@ class ChatToolInvocation {
         if (startOptions.startInStreaming) {
             defaultMessage = toolData.displayName;
         } else if (startOptions.startInCancelled) {
-            defaultMessage = startOptions.cancelReasonMessage ?? ( localize(7417, "Tool \"{0}\" was denied", toolData.displayName));
+            defaultMessage = startOptions.cancelReasonMessage ?? ( localize(7737, "Tool \"{0}\" was denied", toolData.displayName));
         }
         this.invocationMessage = preparedInvocation?.invocationMessage ?? defaultMessage;
         this.pastTenseMessage = preparedInvocation?.pastTenseMessage;

package/vscode/src/vs/workbench/contrib/chat/common/participants/chatAgents.d.ts

@@ -132,12 +132,18 @@ export interface IChatAgentRequest {
     locationData?: Revived<IChatLocationData>;
     acceptedConfirmationData?: unknown[];
     rejectedConfirmationData?: unknown[];
-    agentHostSessionConfig?: Record<string, string>;
+    agentHostSessionConfig?: Record<string, unknown>;
     userSelectedModelId?: string;
     modelConfiguration?: IStringDictionary<unknown>;
     userSelectedTools?: UserSelectedTools;
     modeInstructions?: IChatRequestModeInstructions;
     editedFileEvents?: IChatAgentEditedFileEvent[];
+    /**
+     * The working directory URI for the session, if set.
+     * In the agents window, each session can have its own working directory
+     * that differs from the current workspace folders.
+     */
+    workingDirectory?: URI;
     /**
      * Collected hooks configuration for this request.
      * Contains all hooks defined in hooks .json files, organized by hook type.

package/vscode/src/vs/workbench/contrib/chat/common/participants/chatAgents.js

@@ -233,7 +233,7 @@ let ChatAgentService = class ChatAgentService extends Disposable {
     setRequestTools(id, requestId, tools) {
         const data = this._agents.get(id);
         if (!data?.impl) {
-            throw ( new Error(`No activated agent with id "${id}"`));
+            return;
         }
         data.impl.setRequestTools?.(requestId, tools);
     }

package/vscode/src/vs/workbench/contrib/chat/common/participants/chatSlashCommands.service.d.ts

@@ -19,5 +19,5 @@ export interface IChatSlashCommandService {
         followUp: IChatFollowup[];
     } | void>;
     getCommands(location: ChatAgentLocation, mode: ChatModeKind): Array<IChatSlashData>;
-    hasCommand(id: string): boolean;
+    hasCommand(id: string, sessionType: string): boolean;
 }

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

@@ -0,0 +1,50 @@
+import { IDisposable } from "../../../../../base/common/lifecycle.js";
+import { IObservable } from "../../../../../base/common/observable.js";
+import { URI } from "../../../../../base/common/uri.js";
+import { SyncDescriptor0 } from "../../../../../platform/instantiation/common/descriptors.js";
+import { type INamedPluginResource, type IMcpServerDefinition, type IParsedHookCommand } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/platform/agentPlugins/common/pluginParsers";
+import { ContributionEnablementState, IEnablementModel } from "../enablement.js";
+import { HookType } from "../promptSyntax/hookTypes.js";
+import { IMarketplacePlugin } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/workbench/contrib/chat/common/plugins/pluginMarketplaceService";
+export interface IAgentPluginHook {
+    readonly type: HookType;
+    readonly hooks: readonly IParsedHookCommand[];
+    /** URI where this hook is defined -- not unique, multiple hooks may be in a manifest */
+    readonly uri: URI;
+    readonly originalId: string;
+}
+export type IAgentPluginCommand = INamedPluginResource;
+export type IAgentPluginSkill = INamedPluginResource;
+export type IAgentPluginAgent = INamedPluginResource;
+export type IAgentPluginInstruction = INamedPluginResource;
+export type IAgentPluginMcpServerDefinition = IMcpServerDefinition;
+export interface IAgentPlugin {
+    readonly uri: URI;
+    /** Human-readable display name for the plugin. */
+    readonly label: string;
+    readonly enablement: IObservable<ContributionEnablementState>;
+    /** Removes this plugin from its discovery source (config or installed storage). */
+    remove(): void;
+    readonly hooks: IObservable<readonly IAgentPluginHook[]>;
+    readonly commands: IObservable<readonly IAgentPluginCommand[]>;
+    readonly skills: IObservable<readonly IAgentPluginSkill[]>;
+    readonly agents: IObservable<readonly IAgentPluginAgent[]>;
+    readonly instructions: IObservable<readonly IAgentPluginInstruction[]>;
+    readonly mcpServerDefinitions: IObservable<readonly IAgentPluginMcpServerDefinition[]>;
+    /** Set when the plugin was installed from a marketplace repository. */
+    readonly fromMarketplace?: IMarketplacePlugin;
+}
+export interface IAgentPluginDiscovery extends IDisposable {
+    readonly plugins: IObservable<readonly IAgentPlugin[]>;
+    start(enablementModel: IEnablementModel): void;
+}
+export declare function getCanonicalPluginCommandId(plugin: {
+    readonly uri: URI;
+}, commandName: string): string;
+declare class AgentPluginDiscoveryRegistry {
+    private readonly _discovery;
+    register(descriptor: SyncDescriptor0<IAgentPluginDiscovery>): void;
+    getAll(): readonly SyncDescriptor0<IAgentPluginDiscovery>[];
+}
+export declare const agentPluginDiscoveryRegistry: AgentPluginDiscoveryRegistry;
+export {};

package/vscode/src/vs/workbench/contrib/chat/common/plugins/agentPluginService.js

@@ -0,0 +1,32 @@
+
+import { basename } from '../../../../../base/common/resources.js';
+
+function getCanonicalPluginCommandId(plugin, commandName) {
+    const pluginSegment = basename(plugin.uri);
+    const prefix = normalizePluginToken(pluginSegment);
+    const normalizedCommand = normalizePluginToken(commandName);
+    if (normalizedCommand.startsWith(`${prefix}:`)) {
+        return normalizedCommand;
+    }
+    if (prefix === normalizedCommand) {
+        return prefix;
+    }
+    return `${prefix}:${normalizedCommand}`;
+}
+function normalizePluginToken(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9_.:-]/g, "-").replace(/-+/g, "-").replace(/^[-:.]+|[-:.]+$/g, "");
+}
+class AgentPluginDiscoveryRegistry {
+    constructor() {
+        this._discovery = [];
+    }
+    register(descriptor) {
+        this._discovery.push(descriptor);
+    }
+    getAll() {
+        return this._discovery;
+    }
+}
+const agentPluginDiscoveryRegistry = ( new AgentPluginDiscoveryRegistry());
+
+export { agentPluginDiscoveryRegistry, getCanonicalPluginCommandId };

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

@@ -1,6 +1,6 @@
 import { IObservable } from "../../../../../base/common/observable.js";
 import { IEnablementModel } from "../enablement.js";
-import { IAgentPlugin } from "@codingame/monaco-vscode-chat-service-override/vscode/vs/workbench/contrib/chat/common/plugins/agentPluginService";
+import { IAgentPlugin } from "./agentPluginService.js";
 export declare const IAgentPluginService: import("../../../../../platform/instantiation/common/instantiation.js").ServiceIdentifier<IAgentPluginService>;
 export interface IAgentPluginService {
     readonly _serviceBrand: undefined;

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

@@ -5,7 +5,23 @@ export declare const IPluginGitService: import("../../../../../platform/instanti
 * Abstracts git operations used by the agent plugin system.
 *
 * Concrete behavior depends on the platform-specific implementation that is
-* registered for this service.
+* registered for this service. The current decision matrix is:
+*
+* | Deployment flavor                  | Implementation                  | Materialisation strategy                                | Test fixture                                                           |
+* | ---------------------------------- | ------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------- |
+* | Desktop (no remote AHP)            | `NativePluginGitCommandService` | Real `git` via `ILocalGitService` in the shared process | `chat/test/electron-browser/pluginGitCommandService.test.ts`           |
+* | Desktop + remote AHP backend       | `NativePluginGitCommandService` | Real `git` locally; server pulls dir via AHP FS         | + `platform/agentHost/test/node/agentPluginManager.test.ts`            |
+* | Web standalone (no AHP)            | `BrowserPluginGitCommandService`| GitHub tarball fetch + extract into virtual FS          | `chat/test/browser/pluginGitCommandService.test.ts`                    |
+* | Web + remote AHP backend           | `BrowserPluginGitCommandService`| Tarball locally; server pulls dir via AHP FS            | + `platform/agentHost/test/node/agentPluginManager.test.ts`            |
+*
+* The "+ remote AHP" rows reuse the local impl unchanged: the server-side
+* `AgentPluginManager` consumes the already-materialised plugin dir through
+* the AHP filesystem provider (`agent-client:`), so its test fixture is
+* agnostic to which client impl wrote the bytes.
+*
+* A future "server-side clone" path (Approach B) would add a fifth arm
+* where the server itself runs `git clone` based on a typed git-source
+* variant of `CustomizationRef`. That work is not yet implemented.
 */
 export interface IPluginGitService {
     readonly _serviceBrand: undefined;

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

@@ -44,4 +44,15 @@ export interface IPluginMarketplaceService {
     * that clone a repo first, then need to discover its plugins.
     */
     readPluginsFromDirectory(repoDir: URI, reference: IMarketplaceReference): Promise<IMarketplacePlugin[]>;
+    /**
+    * Reads a single-plugin manifest (e.g. `.claude-plugin/plugin.json`) at the
+    * root of an already-cloned repository directory and returns a synthesised
+    * {@link IMarketplacePlugin} describing the repository as a single plugin.
+    * Used by direct-install flows when {@link readPluginsFromDirectory} finds
+    * no marketplace index.
+    *
+    * Returns `undefined` when no recognised manifest is present at the repo
+    * root.
+    */
+    readSinglePluginManifest(repoDir: URI, reference: IMarketplaceReference): Promise<IMarketplacePlugin | undefined>;
 }