@codingame/monaco-vscode-api 30.0.1 → 31.0.0

package/vscode/src/vs/workbench/contrib/chat/common/tools/builtinTools/manageTodoListTool.js

@@ -3,7 +3,7 @@ import { __decorate, __param } from '../../../../../../../../../external/tslib/t
 import { Disposable } from '../../../../../../base/common/lifecycle.js';
 import { Codicon } from '../../../../../../base/common/codicons.js';
 import { ThemeIcon } from '../../../../../../base/common/themables.js';
-import { ToolDataSource } from '../languageModelToolsService.js';
+import { ToolDataSource, ToolInvocationPresentation } from '../languageModelToolsService.js';
 import { ILogService } from '../../../../../../platform/log/common/log.service.js';
 import { ITelemetryService } from '../../../../../../platform/telemetry/common/telemetry.service.js';
 import { IChatTodoListService } from '../chatTodoListService.service.js';
@@ -48,8 +48,8 @@ function createManageTodoListToolData() {
         legacyToolReferenceFullNames: ["todos"],
         canBeReferencedInPrompt: true,
         icon: ThemeIcon.fromId(Codicon.checklist.id),
-        displayName: ( localize(7649, "Manage and track todo items for task planning")),
-        userDescription: ( localize(7650, "Manage and track todo items for task planning")),
+        displayName: ( localize(7759, "Manage and track todo items for task planning")),
+        userDescription: ( localize(7760, "Manage and track todo items for task planning")),
         modelDescription: "Manage a structured todo list to track progress and plan tasks throughout your coding session. Use this tool VERY frequently to ensure task visibility and proper planning.\n\nWhen to use this tool:\n- Complex multi-step work requiring planning and tracking\n- When user provides multiple tasks or requests (numbered/comma-separated)\n- After receiving new instructions that require multiple steps\n- BEFORE starting work on any todo (mark as in-progress)\n- IMMEDIATELY after completing each todo (mark completed individually)\n- When breaking down larger tasks into smaller actionable steps\n- To give users visibility into your progress and planning\n\nWhen NOT to use:\n- Single, trivial tasks that can be completed in one step\n- Purely conversational/informational requests\n- When just reading files or performing simple searches\n\nCRITICAL workflow:\n1. Plan tasks by writing todo list with specific, actionable items\n2. Mark ONE todo as in-progress before starting work\n3. Complete the work for that specific todo\n4. Mark that todo as completed IMMEDIATELY\n5. Move to next todo and repeat\n\nTodo states:\n- not-started: Todo not yet begun\n- in-progress: Currently working (limit ONE at a time)\n- completed: Finished successfully\n\nIMPORTANT: Mark todos completed as soon as they are done. Do not batch completions.",
         source: ToolDataSource.Internal,
         inputSchema: inputSchema
@@ -107,7 +107,7 @@ let ManageTodoListTool = class ManageTodoListTool extends Disposable {
         const currentTodoItems = this.chatTodoListService.getTodos(chatSessionResource);
         let message;
         if (args.operation === "read") {
-            message = ( localize(7651, "Read todo list"));
+            message = ( localize(7761, "Read todo list"));
         } else if (args.todoList) {
             message = this.generatePastTenseMessage(currentTodoItems, args.todoList);
         }
@@ -117,11 +117,12 @@ let ManageTodoListTool = class ManageTodoListTool extends Disposable {
             title: todo.title,
             status: todo.status
         })));
-        const invocationLabel = message?.replace(/^(Starting|Completed): /i, "") ?? ( localize(7652, "Updating todo list"));
+        const invocationLabel = message?.replace(/^(Starting|Completed): /i, "") ?? ( localize(7762, "Updating todo list"));
         const invocationMessage = ( new MarkdownString(invocationLabel));
         return {
             invocationMessage,
-            pastTenseMessage: ( new MarkdownString(message ?? ( localize(7653, "Updated todo list")))),
+            presentation: items.length ? undefined : ToolInvocationPresentation.Hidden,
+            pastTenseMessage: ( new MarkdownString(message ?? ( localize(7763, "Updated todo list")))),
             toolSpecificData: {
                 kind: "todoList",
                 todoList: todoList
@@ -130,7 +131,7 @@ let ManageTodoListTool = class ManageTodoListTool extends Disposable {
     }
     generatePastTenseMessage(currentTodos, newTodos) {
         if (currentTodos.length === 0) {
-            return newTodos.length === 1 ? ( localize(7654, "Created 1 todo")) : ( localize(7655, "Created {0} todos", newTodos.length));
+            return newTodos.length === 1 ? ( localize(7764, "Created 1 todo")) : ( localize(7765, "Created {0} todos", newTodos.length));
         }
         const currentTodoMap = ( new Map(( currentTodos.map(todo => [todo.id, todo]))));
         const startedTodos = newTodos.filter(newTodo => {
@@ -142,7 +143,7 @@ let ManageTodoListTool = class ManageTodoListTool extends Disposable {
             const totalTodos = newTodos.length;
             const currentPosition = newTodos.findIndex(todo => todo.id === startedTodo.id) + 1;
             return localize(
-                7656,
+                7766,
                 "Starting: *{0}* ({1}/{2})",
                 startedTodo.title,
                 currentPosition,
@@ -158,7 +159,7 @@ let ManageTodoListTool = class ManageTodoListTool extends Disposable {
             const totalTodos = newTodos.length;
             const currentPosition = newTodos.findIndex(todo => todo.id === completedTodo.id) + 1;
             return localize(
-                7657,
+                7767,
                 "Completed: *{0}* ({1}/{2})",
                 completedTodo.title,
                 currentPosition,
@@ -167,9 +168,9 @@ let ManageTodoListTool = class ManageTodoListTool extends Disposable {
         }
         const addedTodos = newTodos.filter(newTodo => !( currentTodoMap.has(newTodo.id)));
         if (addedTodos.length > 0) {
-            return addedTodos.length === 1 ? ( localize(7658, "Added 1 todo")) : ( localize(7659, "Added {0} todos", addedTodos.length));
+            return addedTodos.length === 1 ? ( localize(7768, "Added 1 todo")) : ( localize(7769, "Added {0} todos", addedTodos.length));
         }
-        return localize(7660, "Updated todo list");
+        return localize(7770, "Updated todo list");
     }
     handleRead(todoItems, sessionResource) {
         if (todoItems.length === 0) {

package/vscode/src/vs/workbench/contrib/chat/common/tools/builtinTools/reviewPlanTool.d.ts

@@ -0,0 +1,25 @@
+import { CancellationToken } from "../../../../../../base/common/cancellation.js";
+import { Disposable } from "../../../../../../base/common/lifecycle.js";
+import { ILogService } from "../../../../../../platform/log/common/log.service.js";
+import { IChatPlanApprovalAction } from "../../chatService/chatService.js";
+import { IChatService } from "../../chatService/chatService.service.js";
+import { CountTokensCallback, IPreparedToolInvocation, IToolData, IToolImpl, IToolInvocation, IToolInvocationPreparationContext, IToolResult, ToolProgress } from "../languageModelToolsService.js";
+export declare const ReviewPlanToolId = "vscode_reviewPlan";
+export interface IReviewPlanParams {
+    readonly title?: string;
+    readonly plan?: string;
+    readonly content: string;
+    readonly actions: IChatPlanApprovalAction[];
+    readonly canProvideFeedback: boolean;
+}
+export declare function createReviewPlanToolData(): IToolData;
+export declare const ReviewPlanToolData: IToolData;
+export declare class ReviewPlanTool extends Disposable implements IToolImpl {
+    private readonly chatService;
+    private readonly logService;
+    constructor(chatService: IChatService, logService: ILogService);
+    invoke(invocation: IToolInvocation, _countTokens: CountTokensCallback, _progress: ToolProgress, token: CancellationToken): Promise<IToolResult>;
+    prepareToolInvocation(context: IToolInvocationPreparationContext, _token: CancellationToken): Promise<IPreparedToolInvocation | undefined>;
+    private toResult;
+    private getRequest;
+}

package/vscode/src/vs/workbench/contrib/chat/common/tools/builtinTools/reviewPlanTool.js

@@ -0,0 +1,176 @@
+
+import { __decorate, __param } from '../../../../../../../../../external/tslib/tslib.es6.js';
+import { raceCancellation } from '../../../../../../base/common/async.js';
+import { Codicon } from '../../../../../../base/common/codicons.js';
+import { CancellationError } from '../../../../../../base/common/errors.js';
+import { MarkdownString } from '../../../../../../base/common/htmlContent.js';
+import { Disposable } from '../../../../../../base/common/lifecycle.js';
+import { ThemeIcon } from '../../../../../../base/common/themables.js';
+import { URI } from '../../../../../../base/common/uri.js';
+import { generateUuid } from '../../../../../../base/common/uuid.js';
+import { localize } from '../../../../../../nls.js';
+import { ILogService } from '../../../../../../platform/log/common/log.service.js';
+import { IChatService } from '../../chatService/chatService.service.js';
+import { ChatPlanReviewData } from '../../model/chatProgressTypes/chatPlanReviewData.js';
+import { ToolDataSource } from '../languageModelToolsService.js';
+
+const ReviewPlanToolId = "vscode_reviewPlan";
+function createReviewPlanToolData() {
+    const approvalActionSchema = {
+        type: "object",
+        properties: {
+            label: {
+                type: "string",
+                description: "Short action label shown in the dropdown button."
+            },
+            description: {
+                type: "string",
+                description: "Optional detail shown below the label in the dropdown list."
+            },
+            default: {
+                type: "boolean",
+                description: "Whether this action should be selected by default."
+            },
+            permissionLevel: {
+                type: "string",
+                enum: ["autopilot"],
+                description: "When set to \"autopilot\", a confirmation dialog is shown before proceeding."
+            }
+        },
+        required: ["label"]
+    };
+    const inputSchema = {
+        type: "object",
+        properties: {
+            title: {
+                type: "string",
+                description: "Title displayed in the widget header. Defaults to \"Review plan\" if omitted."
+            },
+            plan: {
+                type: "string",
+                description: "Optional URI of an editable plan file. An Edit button in the widget header opens it in the editor."
+            },
+            content: {
+                type: "string",
+                description: "Markdown content rendered in the body of the widget. May be the plan summary or full plan text."
+            },
+            actions: {
+                type: "array",
+                description: "List of approval actions offered in the primary dropdown button. Order is preserved.",
+                items: approvalActionSchema,
+                minItems: 1
+            },
+            canProvideFeedback: {
+                type: "boolean",
+                description: "When true, an additional feedback textarea is shown below the plan content."
+            }
+        },
+        required: ["content", "actions", "canProvideFeedback"]
+    };
+    return {
+        id: ReviewPlanToolId,
+        toolReferenceName: "reviewPlan",
+        canBeReferencedInPrompt: false,
+        icon: ThemeIcon.fromId(Codicon.checklist.id),
+        displayName: ( localize(7771, "Review Plan")),
+        userDescription: ( localize(7772, "Ask the user to review and approve a plan before proceeding.")),
+        modelDescription: "Use this tool to present a plan to the user for review. Provide the plan content as markdown, a list of approval actions (with optional default), and whether the user can provide freeform feedback. Optionally provide a URI to the backing plan file so the user can edit it. The tool returns the chosen action, whether the plan was rejected, and any feedback.",
+        source: ToolDataSource.Internal,
+        inputSchema
+    };
+}
+const ReviewPlanToolData = createReviewPlanToolData();
+let ReviewPlanTool = class ReviewPlanTool extends Disposable {
+    constructor(chatService, logService) {
+        super();
+        this.chatService = chatService;
+        this.logService = logService;
+    }
+    async invoke(invocation, _countTokens, _progress, token) {
+        const parameters = invocation.parameters;
+        const {
+            title,
+            plan,
+            content,
+            actions,
+            canProvideFeedback
+        } = parameters;
+        if (!actions || actions.length === 0) {
+            throw ( new Error(( localize(7773, "At least one approval action must be provided."))));
+        }
+        const {
+            request
+        } = this.getRequest(invocation.context?.sessionResource, invocation.chatRequestId);
+        if (!request) {
+            this.logService.warn("[ReviewPlanTool] Missing chat context; returning rejected result.");
+            return this.toResult({
+                rejected: true
+            });
+        }
+        let planUri;
+        if (plan) {
+            try {
+                planUri = ( URI.parse(plan));
+            } catch {
+                try {
+                    planUri = URI.file(plan);
+                } catch {
+                    planUri = undefined;
+                }
+            }
+        }
+        const reviewData = ( new ChatPlanReviewData(title ?? ( localize(7774, "Review plan")), content, actions, canProvideFeedback, planUri?.toJSON(), generateUuid()));
+        this.chatService.appendProgress(request, reviewData);
+        const result = await raceCancellation(reviewData.completion.p, token);
+        if (token.isCancellationRequested) {
+            throw ( new CancellationError());
+        }
+        return this.toResult(result ?? {
+            rejected: true
+        });
+    }
+    async prepareToolInvocation(context, _token) {
+        const parameters = context.parameters;
+        if (!parameters.actions || parameters.actions.length === 0) {
+            throw ( new Error(( localize(7773, "At least one approval action must be provided."))));
+        }
+        return {
+            invocationMessage: ( new MarkdownString(( localize(7775, "Asking you to review the plan")))),
+            pastTenseMessage: ( new MarkdownString(( localize(7776, "Asked you to review the plan"))))
+        };
+    }
+    toResult(result) {
+        return {
+            content: [{
+                kind: "text",
+                value: JSON.stringify(result)
+            }]
+        };
+    }
+    getRequest(chatSessionResource, chatRequestId) {
+        if (!chatSessionResource) {
+            return {
+                request: undefined
+            };
+        }
+        const model = this.chatService.getSession(chatSessionResource);
+        if (!model) {
+            return {
+                request: undefined
+            };
+        }
+        let request;
+        if (chatRequestId) {
+            request = model.getRequests().find(r => r.id === chatRequestId);
+        }
+        if (!request) {
+            request = model.getRequests().at(-1);
+        }
+        return {
+            request
+        };
+    }
+};
+ReviewPlanTool = ( __decorate([( __param(0, IChatService)), ( __param(1, ILogService))], ReviewPlanTool));
+
+export { ReviewPlanTool, ReviewPlanToolData, ReviewPlanToolId, createReviewPlanToolData };

package/vscode/src/vs/workbench/contrib/chat/common/tools/builtinTools/runSubagentTool.d.ts

@@ -1,7 +1,6 @@
 import { CancellationToken } from "../../../../../../base/common/cancellation.js";
 import { Event } from "../../../../../../base/common/event.js";
 import { Disposable } from "../../../../../../base/common/lifecycle.js";
-import { IConfigurationChangeEvent } from "../../../../../../platform/configuration/common/configuration.js";
 import { IConfigurationService } from "../../../../../../platform/configuration/common/configuration.service.js";
 import { IInstantiationService } from "../../../../../../platform/instantiation/common/instantiation.js";
 import { ILogService } from "../../../../../../platform/log/common/log.service.js";
@@ -16,6 +15,7 @@ export interface IRunSubagentToolInputParams {
     prompt: string;
     description: string;
     agentName?: string;
+    model?: string;
 }
 export declare const RUN_SUBAGENT_MAX_NESTING_DEPTH = 5;
 export declare class RunSubagentTool extends Disposable implements IToolImpl {
@@ -24,24 +24,36 @@ export declare class RunSubagentTool extends Disposable implements IToolImpl {
     private readonly languageModelToolsService;
     private readonly languageModelsService;
     private readonly logService;
-    private readonly toolsService;
     private readonly configurationService;
     private readonly promptsService;
     private readonly instantiationService;
     private readonly productService;
     static readonly Id = "runSubagent";
-    readonly onDidUpdateToolData: Event<IConfigurationChangeEvent>;
+    private readonly _onDidUpdateToolData;
+    readonly onDidUpdateToolData: Event<void>;
     /** Hack to port data between prepare/invoke */
     private readonly _resolvedModels;
     /** Tracks the current subagent nesting depth per session to detect and limit recursion. */
     private readonly _sessionDepth;
-    constructor(chatAgentService: IChatAgentService, chatService: IChatService, languageModelToolsService: ILanguageModelToolsService, languageModelsService: ILanguageModelsService, logService: ILogService, toolsService: ILanguageModelToolsService, configurationService: IConfigurationService, promptsService: IPromptsService, instantiationService: IInstantiationService, productService: IProductService);
+    constructor(chatAgentService: IChatAgentService, chatService: IChatService, languageModelToolsService: ILanguageModelToolsService, languageModelsService: ILanguageModelsService, logService: ILogService, configurationService: IConfigurationService, promptsService: IPromptsService, instantiationService: IInstantiationService, productService: IProductService);
     getToolData(): IToolData;
     invoke(invocation: IToolInvocation, _countTokens: CountTokensCallback, _progress: ToolProgress, token: CancellationToken): Promise<IToolResult>;
     private getSubAgentByName;
     /**
-     * Resolves the model to be used by a subagent, applying multiplier-based
-     * fallback to avoid using a more expensive model than the main agent.
+     * Checks if a model exceeds the main model's cost tier based on multiplier.
+     * @returns An object with `exceeds: true` and a reason string if blocked, or `exceeds: false` if allowed.
+     */
+    private checkMultiplierConstraint;
+    /**
+     * Returns information about available models for error messages.
+     * Includes which models are unavailable due to multiplier restrictions.
+     */
+    private getAvailableModelsInfo;
+    /**
+     * Resolves the model to be used by a subagent.
+     * @param explicitModelQualifiedName Optional explicit model specified by the caller.
+     *        If provided and not found or not allowed, throws an error with available models.
+     * @throws Error if the requested model is not found or exceeds the main model's cost tier.
      */
     private resolveSubagentModel;
     prepareToolInvocation(context: IToolInvocationPreparationContext, _token: CancellationToken): Promise<IPreparedToolInvocation | undefined>;