@theia/plugin 1.55.0-next.4 → 1.55.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.55.0-next.4+f6ace675e",
+  "version": "1.55.0",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -27,10 +27,10 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.54.0"
+    "@theia/ext-scripts": "1.55.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "f6ace675e712c3d2227d1cd19e9c905a6e4d9ad6"
+  "gitHead": "0e7a523b8e798679d2e098709c63bd7060e54c8a"
 }

package/src/theia.d.ts

@@ -23,6 +23,7 @@
 
 import './theia-extra';
 import './theia.proposed.canonicalUriProvider';
+import './theia.proposed.createFileSystemWatcher';
 import './theia.proposed.customEditorMove';
 import './theia.proposed.debugVisualization';
 import './theia.proposed.diffCommand';

package/src/theia.proposed.createFileSystemWatcher.ts

@@ -0,0 +1,65 @@
+// *****************************************************************************
+// Copyright (C) 2024 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// code copied and modified from https://github.com/microsoft/vscode/blob/release/1.93/src/vscode-dts/vscode.proposed.createFileSystemWatcher.d.ts
+
+declare module '@theia/plugin' {
+
+    export interface FileSystemWatcherOptions {
+
+        /**
+         * Ignore when files have been created.
+         */
+        readonly ignoreCreateEvents?: boolean;
+
+        /**
+         * Ignore when files have been changed.
+         */
+        readonly ignoreChangeEvents?: boolean;
+
+        /**
+         * Ignore when files have been deleted.
+         */
+        readonly ignoreDeleteEvents?: boolean;
+
+        /**
+         * An optional set of glob patterns to exclude from watching.
+         * Glob patterns are always matched relative to the watched folder.
+         */
+        readonly excludes: string[];
+    }
+
+    export namespace workspace {
+
+        /**
+         * A variant of {@link workspace.createFileSystemWatcher} that optionally allows to specify
+         * a set of glob patterns to exclude from watching.
+         *
+         * It provides the following advantages over the other {@link workspace.createFileSystemWatcher}
+         * method:
+         * - the configured excludes from `files.watcherExclude` setting are NOT applied
+         * - requests for recursive file watchers inside the opened workspace are NOT ignored
+         * - the watcher is ONLY notified for events from this request and not from any other watcher
+         *
+         * As such, this method is prefered in cases where you want full control over the watcher behavior
+         * without being impacted by settings or other watchers that are installed.
+         */
+        export function createFileSystemWatcher(pattern: RelativePattern, options?: FileSystemWatcherOptions): FileSystemWatcher;
+    }
+}

package/src/theia.proposed.mappedEditsProvider.d.ts

@@ -27,8 +27,24 @@ export module '@theia/plugin' {
         readonly ranges: Range[];
     }
 
+    export interface ConversationRequest {
+        readonly type: 'request';
+        readonly message: string;
+    }
+
+    export interface ConversationResponse {
+        readonly type: 'response';
+        readonly message: string;
+        readonly references?: DocumentContextItem[];
+    }
+
     export interface MappedEditsContext {
-        documents: DocumentContextItem[][];
+        readonly documents: DocumentContextItem[][];
+        /**
+         * The conversation that led to the current code block(s).
+         * The last conversation part contains the code block(s) for which the code mapper should provide edits.
+         */
+        readonly conversation?: (ConversationRequest | ConversationResponse)[];
     }
 
     /**
@@ -38,9 +54,8 @@ export module '@theia/plugin' {
         /**
          * Provide mapped edits for a given document.
          * @param document The document to provide mapped edits for.
-         * @param codeBlocks Code blocks that come from an LLM's reply.
-         *                  "Insert at cursor" in the panel chat only sends one edit that the user clicks on, but inline chat can send multiple blocks
-         *                  and let the lang server decide what to do with them.
+         * @param codeBlocks Code blocks that come from an LLM's reply. "Apply in Editor" in the panel chat only sends one edit that the user clicks on, but inline chat can send
+         * multiple blocks and let the lang server decide what to do with them.
          * @param context The context for providing mapped edits.
          * @param token A cancellation token.
          * @returns A provider result of text edits.
@@ -53,7 +68,33 @@ export module '@theia/plugin' {
         ): ProviderResult<WorkspaceEdit | null>;
     }
 
+    export interface MappedEditsRequest {
+        readonly codeBlocks: { code: string; resource: Uri }[];
+        // for every prior response that contains codeblocks, make sure we pass the code as well as the resources based on the reported codemapper URIs
+        readonly conversation: (ConversationRequest | ConversationResponse)[];
+    }
+
+    export interface MappedEditsResponseStream {
+        textEdit(target: Uri, edits: TextEdit | TextEdit[]): void;
+    }
+
+    export interface MappedEditsResult {
+        readonly errorMessage?: string;
+    }
+
+    /**
+     * Interface for providing mapped edits for a given document.
+     */
+    export interface MappedEditsProvider2 {
+        provideMappedEdits(
+            request: MappedEditsRequest,
+            result: MappedEditsResponseStream,
+            token: CancellationToken
+        ): ProviderResult<MappedEditsResult>;
+    }
+
     export namespace chat {
         export function registerMappedEditsProvider(documentSelector: DocumentSelector, provider: MappedEditsProvider): Disposable;
+        export function registerMappedEditsProvider2(provider: MappedEditsProvider2): Disposable;
     }
 }