@theia/plugin-ext 1.73.0-next.7 → 1.73.0

package/src/common/lm-tool-protocol.ts

@@ -0,0 +1,102 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource.
+//
+// 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
+// *****************************************************************************
+
+import { CancellationToken } from '@theia/core/lib/common/cancellation';
+
+export interface LanguageModelToolDto {
+    name: string;
+    description?: string;
+    inputSchema?: object;
+    tags?: string[];
+}
+
+export interface ToolResultTextPartDto {
+    type: 'text';
+    value: string;
+}
+
+export interface ToolResultDataPartDto {
+    type: 'data';
+    base64: string;
+    mimeType: string;
+}
+
+export interface ToolResultPromptTsxPartDto {
+    type: 'prompt-tsx';
+    value: unknown;
+}
+
+export interface ToolResultUnknownPartDto {
+    type: 'unknown';
+    json: string;
+}
+
+export type ToolResultPartDto = ToolResultTextPartDto | ToolResultDataPartDto | ToolResultPromptTsxPartDto | ToolResultUnknownPartDto;
+
+export interface LanguageModelToolResultDto {
+    content: ToolResultPartDto[];
+}
+
+export interface LanguageModelToolInvocationErrorDto {
+    error: string;
+}
+
+export type ToolInvocationResult = LanguageModelToolResultDto | LanguageModelToolInvocationErrorDto;
+
+export const isToolInvocationError = (result: ToolInvocationResult): result is LanguageModelToolInvocationErrorDto =>
+    typeof result === 'object' && 'error' in result && !('content' in result);
+
+export function uint8ArrayToBase64(data: Uint8Array): string {
+    let binary = '';
+    for (let i = 0; i < data.byteLength; i++) {
+        binary += String.fromCharCode(data[i]);
+    }
+    return btoa(binary);
+}
+
+export function base64ToUint8Array(base64: string): Uint8Array {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+
+/**
+ * Main side of the language model tools registry.
+ */
+export interface LanguageModelToolsMain {
+    /**
+     * Register a language model tool.
+     */
+    $registerTool(handle: number, name: string, metadata: LanguageModelToolDto, pluginId: string): Promise<void>;
+
+    /**
+     * Unregister a language model tool.
+     */
+    $unregisterTool(handle: number): void;
+}
+
+/**
+ * Extension side of the language model tools registry.
+ */
+export interface LanguageModelToolsExt {
+    /**
+     * Invoke a language model tool.
+     */
+    $invokeTool(handle: number, argsString: string, token?: CancellationToken): Promise<ToolInvocationResult>;
+}

package/src/common/plugin-api-rpc-model.ts

@@ -343,6 +343,11 @@ export interface DocumentHighlightProvider {
     provideDocumentHighlights(model: monaco.editor.ITextModel, position: monaco.Position, token: monaco.CancellationToken): DocumentHighlight[] | undefined;
 }
 
+export interface MultiDocumentHighlightDto {
+    uri: UriComponents;
+    highlights: DocumentHighlight[];
+}
+
 export interface FormattingOptions {
     tabSize: number;
     insertSpaces: boolean;

package/src/common/plugin-api-rpc.ts

@@ -46,6 +46,7 @@ import {
     InlineValue,
     InlineValueContext,
     DocumentHighlight,
+    MultiDocumentHighlightDto,
     FormattingOptions,
     ChainedCacheId,
     Definition,
@@ -129,6 +130,7 @@ import { TreeDelta } from '@theia/test/lib/common/tree-delta';
 import { TestItemDTO, TestOutputDTO, TestRunDTO, TestRunProfileDTO, TestRunRequestDTO, TestStateChangeDTO } from './test-types';
 import { ArgumentProcessor } from './commands';
 import { McpServerDefinitionRegistryMain, McpServerDefinitionRegistryExt } from './lm-protocol';
+import { LanguageModelToolsMain, LanguageModelToolsExt } from './lm-tool-protocol';
 
 export interface PreferenceData {
     [scope: number]: any;
@@ -1824,6 +1826,8 @@ export interface LanguagesExt {
     $provideEvaluatableExpression(handle: number, resource: UriComponents, position: Position, token: CancellationToken): Promise<EvaluatableExpression | undefined>;
     $provideInlineValues(handle: number, resource: UriComponents, range: Range, context: InlineValueContext, token: CancellationToken): Promise<InlineValue[] | undefined>;
     $provideDocumentHighlights(handle: number, resource: UriComponents, position: Position, token: CancellationToken): Promise<DocumentHighlight[] | undefined>;
+    $provideMultiDocumentHighlights(handle: number, resource: UriComponents, position: Position, otherResources: UriComponents[], token: CancellationToken):
+        Promise<MultiDocumentHighlightDto[] | undefined>;
     $provideDocumentFormattingEdits(handle: number, resource: UriComponents,
         options: FormattingOptions, token: CancellationToken): Promise<TextEdit[] | undefined>;
     $provideDocumentRangeFormattingEdits(handle: number, resource: UriComponents, range: Range,
@@ -1919,6 +1923,7 @@ export interface LanguagesMain {
     $registerInlineValuesProvider(handle: number, pluginInfo: PluginInfo, selector: SerializedDocumentFilter[]): void;
     $emitInlineValuesEvent(eventHandle: number, event?: any): void;
     $registerDocumentHighlightProvider(handle: number, pluginInfo: PluginInfo, selector: SerializedDocumentFilter[]): void;
+    $registerMultiDocumentHighlightProvider(handle: number, pluginInfo: PluginInfo, selector: SerializedDocumentFilter[]): void;
     $registerQuickFixProvider(handle: number, pluginInfo: PluginInfo, selector: SerializedDocumentFilter[], codeActionKinds?: string[], documentation?: CodeActionProviderDocumentation): void;
     $clearDiagnostics(id: string): void;
     $changeDiagnostics(id: string, delta: [string, MarkerData[]][]): void;
@@ -2476,7 +2481,8 @@ export const PLUGIN_RPC_CONTEXT = {
     LOCALIZATION_MAIN: createProxyIdentifier<LocalizationMain>('LocalizationMain'),
     TESTING_MAIN: createProxyIdentifier<TestingMain>('TestingMain'),
     URI_MAIN: createProxyIdentifier<UriMain>('UriMain'),
-    MCP_SERVER_DEFINITION_REGISTRY_MAIN: createProxyIdentifier<McpServerDefinitionRegistryMain>('McpServerDefinitionRegistryMain')
+    MCP_SERVER_DEFINITION_REGISTRY_MAIN: createProxyIdentifier<McpServerDefinitionRegistryMain>('McpServerDefinitionRegistryMain'),
+    LM_TOOLS_MAIN: createProxyIdentifier<LanguageModelToolsMain>('LanguageModelToolsMain')
 };
 
 export const MAIN_RPC_CONTEXT = {
@@ -2521,7 +2527,8 @@ export const MAIN_RPC_CONTEXT = {
     TELEMETRY_EXT: createProxyIdentifier<TelemetryExt>('TelemetryExt)'),
     TESTING_EXT: createProxyIdentifier<TestingExt>('TestingExt'),
     URI_EXT: createProxyIdentifier<UriExt>('UriExt'),
-    MCP_SERVER_DEFINITION_REGISTRY_EXT: createProxyIdentifier<McpServerDefinitionRegistryExt>('McpServerDefinitionRegistryExt')
+    MCP_SERVER_DEFINITION_REGISTRY_EXT: createProxyIdentifier<McpServerDefinitionRegistryExt>('McpServerDefinitionRegistryExt'),
+    LM_TOOLS_EXT: createProxyIdentifier<LanguageModelToolsExt>('LanguageModelToolsExt')
 };
 
 export interface TasksExt {

package/src/common/plugin-protocol.ts

@@ -113,6 +113,7 @@ export interface PluginPackageContribution {
     notebookRenderer?: PluginNotebookRendererContribution[];
     notebookPreload?: PluginPackageNotebookPreload[];
     mcpServerDefinitionProviders?: PluginPackageMcpServerDefinitionProviderContribution[];
+    languageModelTools?: PluginPackageLanguageModelToolContribution[];
 }
 
 export interface PluginPackageNotebook {
@@ -141,6 +142,14 @@ export interface PluginPackageMcpServerDefinitionProviderContribution {
     description?: string;
 }
 
+export interface PluginPackageLanguageModelToolContribution {
+    name: string;
+    modelDescription?: string;
+    userDescription?: string;
+    inputSchema?: object;
+    tags?: string[];
+}
+
 export interface PluginPackageAuthenticationProvider {
     id: string;
     label: string;

package/src/hosted/node/hosted-plugin-localization-service.ts

@@ -18,11 +18,11 @@ import * as path from 'path';
 import * as fs from '@theia/core/shared/fs-extra';
 import { LazyLocalization, LocalizationProvider } from '@theia/core/lib/node/i18n/localization-provider';
 import { Localization } from '@theia/core/lib/common/i18n/localization';
-import { inject, injectable } from '@theia/core/shared/inversify';
+import { inject, injectable, named } from '@theia/core/shared/inversify';
 import { DeployedPlugin, Localization as PluginLocalization, PluginIdentifiers, Translation } from '../../common';
 import { EnvVariablesServer } from '@theia/core/lib/common/env-variables';
 import { BackendApplicationContribution } from '@theia/core/lib/node';
-import { Disposable, DisposableCollection, isObject, MaybePromise, nls, Path, URI } from '@theia/core';
+import { Disposable, DisposableCollection, isObject, MaybePromise, nls, Path, URI, ILogger } from '@theia/core';
 import { Deferred } from '@theia/core/lib/common/promise-util';
 import { LanguagePackBundle, LanguagePackService } from '../../common/language-pack-service';
 
@@ -48,6 +48,9 @@ export class HostedPluginLocalizationService implements BackendApplicationContri
     @inject(EnvVariablesServer)
     protected readonly envVariables: EnvVariablesServer;
 
+    @inject(ILogger) @named('plugin-ext:HostedPluginLocalizationService')
+    protected readonly logger: ILogger;
+
     protected localizationDisposeMap = new Map<string, Disposable>();
     protected translationConfigFiles: Map<string, string> = new Map();
 
@@ -162,7 +165,7 @@ export class HostedPluginLocalizationService implements BackendApplicationContri
                 return Localization.localize(localization, fullKey, original);
             }) as DeployedPlugin;
         } catch (err) {
-            console.error(`Failed to localize plugin '${pluginId}'.`, err);
+            this.logger.error(`Failed to localize plugin '${pluginId}'.`, err);
         }
         return plugin;
     }

package/src/hosted/node/plugin-deployer-handler-impl.ts

@@ -15,7 +15,7 @@
 // *****************************************************************************
 
 import * as fs from '@theia/core/shared/fs-extra';
-import { injectable, inject } from '@theia/core/shared/inversify';
+import { injectable, inject, named } from '@theia/core/shared/inversify';
 import { ILogger } from '@theia/core';
 import {
     PluginDeployerHandler, PluginDeployerEntry, PluginEntryPoint, DeployedPlugin,
@@ -29,7 +29,7 @@ import { PluginUninstallationManager } from '../../main/node/plugin-uninstallati
 
 @injectable()
 export class PluginDeployerHandlerImpl implements PluginDeployerHandler {
-    @inject(ILogger)
+    @inject(ILogger) @named('plugin-ext:PluginDeployerHandlerImpl')
     protected readonly logger: ILogger;
 
     @inject(HostedPluginReader)
@@ -128,7 +128,7 @@ export class PluginDeployerHandlerImpl implements PluginDeployerHandler {
             }
             return dependencies;
         } catch (e) {
-            console.error(`Failed to load plugin dependencies from '${pluginPath}' path`, e);
+            this.logger.error(`Failed to load plugin dependencies from '${pluginPath}' path`, e);
             return undefined;
         }
     }
@@ -211,13 +211,13 @@ export class PluginDeployerHandlerImpl implements PluginDeployerHandler {
                 return false;
             }
             await Promise.all(Array.from(sourceLocations,
-                location => fs.remove(location).catch(err => console.error(`Failed to remove source for ${pluginId} at ${location}`, err))));
+                location => fs.remove(location).catch(err => this.logger.error(`Failed to remove source for ${pluginId} at ${location}`, err))));
             this.sourceLocations.delete(pluginId);
             this.localizationService.undeployLocalizations(pluginId);
             this.uninstallationManager.markAsUninstalled(pluginId);
             return true;
         } catch (e) {
-            console.error('Error uninstalling plugin', e);
+            this.logger.error('Error uninstalling plugin', e);
             return false;
         }
     }

package/src/hosted/node/plugin-host-module.ts

@@ -37,6 +37,7 @@ import { TerminalServiceExtImpl } from '../../plugin/terminal-ext';
 import { InternalSecretsExt, SecretsExtImpl } from '../../plugin/secrets-ext';
 import { setupPluginHostLogger } from './plugin-host-logger';
 import { LmExtImpl } from '../../plugin/lm-ext';
+import { LanguageModelToolsExtImpl } from '../../plugin/lm-tool-ext';
 import { EncodingService } from '@theia/core/lib/common/encoding-service';
 
 export default new ContainerModule(bind => {
@@ -66,6 +67,7 @@ export default new ContainerModule(bind => {
     bind(PreferenceRegistryExtImpl).toSelf().inSingletonScope();
     bind(DebugExtImpl).toSelf().inSingletonScope();
     bind(LmExtImpl).toSelf().inSingletonScope();
+    bind(LanguageModelToolsExtImpl).toSelf().inSingletonScope();
     bind(EncodingService).toSelf().inSingletonScope();
     bind(EditorsAndDocumentsExtImpl).toSelf().inSingletonScope();
     bind(WorkspaceExtImpl).toSelf().inSingletonScope();