@codingame/monaco-vscode-api 37.0.0 → 37.2.0

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

@@ -1,298 +0,0 @@
-
-import { __decorate, __param } from '../../../../../../../../../external/tslib/tslib.es6.js';
-import { Disposable } from '../../../../../../base/common/lifecycle.js';
-import { Codicon } from '../../../../../../base/common/codicons.js';
-import { ThemeIcon } from '../../../../../../base/common/themables.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';
-import { localize } from '../../../../../../nls.js';
-import { MarkdownString } from '../../../../../../base/common/htmlContent.js';
-import { URI } from '../../../../../../base/common/uri.js';
-
-const ManageTodoListToolToolId = "manage_todo_list";
-function createManageTodoListToolData() {
-    const inputSchema = {
-        type: "object",
-        properties: {
-            todoList: {
-                type: "array",
-                description: "Complete array of all todo items. Must include ALL items - both existing and new.",
-                items: {
-                    type: "object",
-                    properties: {
-                        id: {
-                            type: "number",
-                            description: "Unique identifier for the todo. Use sequential numbers starting from 1."
-                        },
-                        title: {
-                            type: "string",
-                            description: "Concise action-oriented todo label (3-7 words). Displayed in UI."
-                        },
-                        status: {
-                            type: "string",
-                            enum: ["not-started", "in-progress", "completed"],
-                            description: "not-started: Not begun | in-progress: Currently working (max 1) | completed: Fully finished with no blockers"
-                        }
-                    },
-                    required: ["id", "title", "status"]
-                }
-            }
-        },
-        required: ["todoList"]
-    };
-    return {
-        id: ManageTodoListToolToolId,
-        toolReferenceName: "todo",
-        legacyToolReferenceFullNames: ["todos"],
-        canBeReferencedInPrompt: true,
-        icon: ThemeIcon.fromId(Codicon.checklist.id),
-        displayName: ( localize(10681, "Manage and track todo items for task planning")),
-        userDescription: ( localize(10682, "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
-    };
-}
-createManageTodoListToolData();
-let ManageTodoListTool = class ManageTodoListTool extends Disposable {
-    constructor(chatTodoListService, logService, telemetryService) {
-        super();
-        this.chatTodoListService = chatTodoListService;
-        this.logService = logService;
-        this.telemetryService = telemetryService;
-    }
-    async invoke(invocation, _countTokens, _progress, _token) {
-        const args = invocation.parameters;
-        let chatSessionResource = invocation.context?.sessionResource;
-        if (!chatSessionResource && args.operation === "read" && args.chatSessionResource) {
-            try {
-                chatSessionResource = ( URI.parse(args.chatSessionResource));
-            } catch (error) {
-                this.logService.error("ManageTodoListTool: Invalid chatSessionResource URI", error);
-            }
-        }
-        if (!chatSessionResource) {
-            return {
-                content: [{
-                    kind: "text",
-                    value: "Error: No session resource available"
-                }]
-            };
-        }
-        this.logService.debug(`ManageTodoListTool: Invoking with options ${JSON.stringify(args)}`);
-        try {
-            if (args.operation === "read") {
-                return this.handleReadOperation(chatSessionResource);
-            } else {
-                return this.handleWriteOperation(args, chatSessionResource);
-            }
-        } catch (error) {
-            const errorMessage = `Error: ${error instanceof Error ? error.message : "Unknown error"}`;
-            return {
-                content: [{
-                    kind: "text",
-                    value: errorMessage
-                }]
-            };
-        }
-    }
-    async prepareToolInvocation(context, _token) {
-        const args = context.parameters;
-        const chatSessionResource = context.chatSessionResource;
-        if (!chatSessionResource) {
-            return undefined;
-        }
-        const currentTodoItems = this.chatTodoListService.getTodos(chatSessionResource);
-        let message;
-        if (args.operation === "read") {
-            message = ( localize(10683, "Read todo list"));
-        } else if (args.todoList) {
-            message = this.generatePastTenseMessage(currentTodoItems, args.todoList);
-        }
-        const items = args.todoList ?? currentTodoItems;
-        const todoList = ( items.map(todo => ({
-            id: ( todo.id.toString()),
-            title: todo.title,
-            status: todo.status
-        })));
-        const invocationLabel = message?.replace(/^(Starting|Completed): /i, "") ?? ( localize(10684, "Updating todo list"));
-        const invocationMessage = ( new MarkdownString(invocationLabel));
-        return {
-            invocationMessage,
-            presentation: items.length ? undefined : ToolInvocationPresentation.Hidden,
-            pastTenseMessage: ( new MarkdownString(message ?? ( localize(10685, "Updated todo list")))),
-            toolSpecificData: {
-                kind: "todoList",
-                todoList: todoList
-            }
-        };
-    }
-    generatePastTenseMessage(currentTodos, newTodos) {
-        if (currentTodos.length === 0 && newTodos.length > 0) {
-            return newTodos.length === 1 ? ( localize(10686, "Created 1 todo")) : ( localize(10687, "Created {0} todos", newTodos.length));
-        }
-        const currentTodoMap = ( new Map(( currentTodos.map(todo => [todo.id, todo]))));
-        const startedTodos = newTodos.filter(newTodo => {
-            const currentTodo = currentTodoMap.get(newTodo.id);
-            return currentTodo && currentTodo.status !== "in-progress" && newTodo.status === "in-progress";
-        });
-        if (startedTodos.length > 0) {
-            const startedTodo = startedTodos[0];
-            const totalTodos = newTodos.length;
-            const currentPosition = newTodos.findIndex(todo => todo.id === startedTodo.id) + 1;
-            return localize(
-                10688,
-                "Starting: *{0}* ({1}/{2})",
-                startedTodo.title,
-                currentPosition,
-                totalTodos
-            );
-        }
-        const completedTodos = newTodos.filter(newTodo => {
-            const currentTodo = currentTodoMap.get(newTodo.id);
-            return currentTodo && currentTodo.status !== "completed" && newTodo.status === "completed";
-        });
-        if (completedTodos.length > 0) {
-            const completedTodo = completedTodos[0];
-            const totalTodos = newTodos.length;
-            const currentPosition = newTodos.findIndex(todo => todo.id === completedTodo.id) + 1;
-            return localize(
-                10689,
-                "Completed: *{0}* ({1}/{2})",
-                completedTodo.title,
-                currentPosition,
-                totalTodos
-            );
-        }
-        const addedTodos = newTodos.filter(newTodo => !( currentTodoMap.has(newTodo.id)));
-        if (addedTodos.length > 0) {
-            return addedTodos.length === 1 ? ( localize(10690, "Added 1 todo")) : ( localize(10691, "Added {0} todos", addedTodos.length));
-        }
-        return localize(10692, "Updated todo list");
-    }
-    handleRead(todoItems, sessionResource) {
-        if (todoItems.length === 0) {
-            return "No todo list found.";
-        }
-        const markdownTaskList = this.formatTodoListAsMarkdownTaskList(todoItems);
-        return `# Todo List\n\n${markdownTaskList}`;
-    }
-    handleReadOperation(chatSessionResource) {
-        const todoItems = this.chatTodoListService.getTodos(chatSessionResource);
-        const readResult = this.handleRead(todoItems, chatSessionResource);
-        const statusCounts = this.calculateStatusCounts(todoItems);
-        this.telemetryService.publicLog2("todoListToolInvoked", {
-            operation: "read",
-            notStartedCount: statusCounts.notStartedCount,
-            inProgressCount: statusCounts.inProgressCount,
-            completedCount: statusCounts.completedCount
-        });
-        return {
-            content: [{
-                kind: "text",
-                value: readResult
-            }]
-        };
-    }
-    handleWriteOperation(args, chatSessionResource) {
-        if (!args.todoList) {
-            return {
-                content: [{
-                    kind: "text",
-                    value: "Error: todoList is required for write operation"
-                }]
-            };
-        }
-        const todoList = ( args.todoList.map(parsedTodo => ({
-            id: parsedTodo.id,
-            title: parsedTodo.title,
-            status: parsedTodo.status
-        })));
-        const existingTodos = this.chatTodoListService.getTodos(chatSessionResource);
-        const changes = this.calculateTodoChanges(existingTodos, todoList);
-        this.chatTodoListService.setTodos(chatSessionResource, todoList);
-        const statusCounts = this.calculateStatusCounts(todoList);
-        const warnings = [];
-        if (todoList.length < 3) {
-            warnings.push(
-                "Warning: Small todo list (<3 items). This task might not need a todo list."
-            );
-        } else if (todoList.length > 10) {
-            warnings.push(
-                "Warning: Large todo list (>10 items). Consider keeping the list focused and actionable."
-            );
-        }
-        if (changes > 3) {
-            warnings.push(
-                "Warning: Did you mean to update so many todos at the same time? Consider working on them one by one."
-            );
-        }
-        this.telemetryService.publicLog2("todoListToolInvoked", {
-            operation: "write",
-            notStartedCount: statusCounts.notStartedCount,
-            inProgressCount: statusCounts.inProgressCount,
-            completedCount: statusCounts.completedCount
-        });
-        return {
-            content: [{
-                kind: "text",
-                value: `Successfully wrote todo list${warnings.length ? "\n\n" + warnings.join("\n") : ""}`
-            }],
-            toolMetadata: {
-                warnings: warnings
-            }
-        };
-    }
-    calculateStatusCounts(todos) {
-        const notStartedCount = todos.filter(todo => todo.status === "not-started").length;
-        const inProgressCount = todos.filter(todo => todo.status === "in-progress").length;
-        const completedCount = todos.filter(todo => todo.status === "completed").length;
-        return {
-            notStartedCount,
-            inProgressCount,
-            completedCount
-        };
-    }
-    formatTodoListAsMarkdownTaskList(todoList) {
-        if (todoList.length === 0) {
-            return "";
-        }
-        return ( todoList.map(todo => {
-            let checkbox;
-            switch (todo.status) {
-            case "completed":
-                checkbox = "[x]";
-                break;
-            case "in-progress":
-                checkbox = "[-]";
-                break;
-            case "not-started":
-            default:
-                checkbox = "[ ]";
-                break;
-            }
-            const lines = [`- ${checkbox} ${todo.title}`];
-            return lines.join("\n");
-        })).join("\n");
-    }
-    calculateTodoChanges(oldList, newList) {
-        let modified = 0;
-        const minLen = Math.min(oldList.length, newList.length);
-        for (let i = 0; i < minLen; i++) {
-            const o = oldList[i];
-            const n = newList[i];
-            if (o.title !== n.title || o.status !== n.status) {
-                modified++;
-            }
-        }
-        const added = Math.max(0, newList.length - oldList.length);
-        const removed = Math.max(0, oldList.length - newList.length);
-        const totalChanges = added + removed + modified;
-        return totalChanges;
-    }
-};
-ManageTodoListTool = ( __decorate([( __param(0, IChatTodoListService)), ( __param(1, ILogService)), ( __param(2, ITelemetryService))], ManageTodoListTool));
-
-export { ManageTodoListTool, ManageTodoListToolToolId, createManageTodoListToolData };

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

@@ -1,25 +0,0 @@
-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

@@ -1,177 +0,0 @@
-
-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 \"Plan summary\" 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(10693, "Review Plan")),
-        userDescription: ( localize(10694, "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(10695, "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(10696, "Plan summary")), content, actions, canProvideFeedback, planUri?.toJSON(), generateUuid()));
-        this.chatService.appendProgress(request, reviewData);
-        const result = await raceCancellation(reviewData.completion.p, token);
-        if (token.isCancellationRequested) {
-            reviewData.dismiss();
-            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(10695, "At least one approval action must be provided."))));
-        }
-        return {
-            invocationMessage: ( new MarkdownString(( localize(10697, "Asking you to review the plan")))),
-            pastTenseMessage: ( new MarkdownString(( localize(10698, "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,73 +0,0 @@
-import { CancellationToken } from "../../../../../../base/common/cancellation.js";
-import { type Event } from "../../../../../../base/common/event.js";
-import { Disposable } from "../../../../../../base/common/lifecycle.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";
-import { IProductService } from "../../../../../../platform/product/common/productService.service.js";
-import { ITelemetryService } from "../../../../../../platform/telemetry/common/telemetry.service.js";
-import { IChatService } from "../../chatService/chatService.service.js";
-import { ILanguageModelsService } from "../../languageModels.service.js";
-import { IChatAgentService } from "../../participants/chatAgents.service.js";
-import { IPromptsService } from "../../promptSyntax/service/promptsService.service.js";
-import { CountTokensCallback, IPreparedToolInvocation, IToolData, IToolImpl, IToolInvocation, IToolInvocationPreparationContext, IToolResult, ToolProgress } from "../languageModelToolsService.js";
-import { ILanguageModelToolsService } from "../languageModelToolsService.service.js";
-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 {
-    private readonly chatAgentService;
-    private readonly chatService;
-    private readonly languageModelToolsService;
-    private readonly languageModelsService;
-    private readonly logService;
-    private readonly configurationService;
-    private readonly promptsService;
-    private readonly instantiationService;
-    private readonly productService;
-    private readonly telemetryService;
-    static readonly Id = "runSubagent";
-    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;
-    private _autoModelResolution;
-    constructor(chatAgentService: IChatAgentService, chatService: IChatService, languageModelToolsService: ILanguageModelToolsService, languageModelsService: ILanguageModelsService, logService: ILogService, configurationService: IConfigurationService, promptsService: IPromptsService, instantiationService: IInstantiationService, productService: IProductService, telemetryService: ITelemetryService);
-    getToolData(): IToolData;
-    invoke(invocation: IToolInvocation, _countTokens: CountTokensCallback, _progress: ToolProgress, token: CancellationToken): Promise<IToolResult>;
-    private getSubAgentByName;
-    /**
-     * 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.
-     * @param currentModeInstructions The current agent inherited when no subagent is requested.
-     *        Its configured model keeps precedence over the Auto default.
-     * @throws Error if the requested model is not found or exceeds the main model's cost tier.
-     */
-    private resolveSubagentModel;
-    private inheritedAgentHasModel;
-    private isSelectableForAgentMode;
-    private findEligibleAutoModelId;
-    private resolveAutoModelId;
-    private activateAutoModel;
-    prepareToolInvocation(context: IToolInvocationPreparationContext, _token: CancellationToken): Promise<IPreparedToolInvocation | undefined>;
-    private normalizeRequestedAgentName;
-    private getCurrentModeInstructions;
-    private validateSubagentAllowed;
-}