+
+
+ +
+
+
+ +
+
+## Description
+
+The `@theia/api-provider-sample` extension is a programming example showing how to define and provide a custom API object for _plugins_ to use.
+The purpose of the extension is to:
+- provide developers with realistic coding examples of providing custom API objects
+- provide easy-to-use and test examples for features when reviewing pull requests
+
+The extension is for reference and test purposes only and is not published on `npm` (`private: true`).
+
+### Greeting of the Day
+
+The sample defines a `gotd` API that plugins can import and use to obtain tailored messages with which to greet the world, for example in their activation function.
+
+The source code is laid out in the `src/` tree as follows:
+
+- `gotd.d.ts` — the TypeScript definition of the `gotd` API object that plugins import to interact with the "Greeting of the Day" service
+- `plugin/` — the API initialization script and the implementation of the API objects (`GreetingExt` and similar interfaces).
+ All code in this directory runs exclusively in the separate plugin-host Node process, isolated from the main Theia process, together with either headless plugins or the backend of VS Code plugins.
+ The `GreetingExtImpl` and similar classes communicate with the actual API implementation (`GreetingMainImpl` etc.) classes in the main Theia process via RPC
+- `node/` — the API classes implementing `GreetingMain` and similar interfaces and the Inversify bindings that register the API provider.
+ All code in this directory runs in the main Theia Node process
+ - `common/` — the RPC API Ext/Main interface definitions corresponding to the backend of the `gotd` plugin API
+
+## Additional Information
+
+- [Theia - GitHub](https://github.com/eclipse-theia/theia)
+- [Theia - Website](https://theia-ide.org/)
+
+## License
+
+- [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
+- [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
+
+## Trademark
+"Theia" is a trademark of the Eclipse Foundation
+https://www.eclipse.org/theia
diff --git a/examples/api-provider-sample/package.json b/examples/api-provider-sample/package.json
new file mode 100644
index 0000000000000..410a1d085df1e
--- /dev/null
+++ b/examples/api-provider-sample/package.json
@@ -0,0 +1,42 @@
+{
+ "private": true,
+ "name": "@theia/api-provider-sample",
+ "version": "1.54.0",
+ "description": "Theia - Example code to demonstrate Theia API Provider Extensions",
+ "dependencies": {
+ "@theia/core": "1.54.0",
+ "@theia/plugin-ext": "1.54.0",
+ "@theia/plugin-ext-headless": "1.54.0"
+ },
+ "theiaExtensions": [
+ {
+ "backend": "lib/node/gotd-backend-module"
+ }
+ ],
+ "keywords": [
+ "theia-extension"
+ ],
+ "license": "EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0",
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/eclipse-theia/theia.git"
+ },
+ "bugs": {
+ "url": "https://github.com/eclipse-theia/theia/issues"
+ },
+ "homepage": "https://github.com/eclipse-theia/theia",
+ "files": [
+ "lib",
+ "src"
+ ],
+ "types": "src/gotd.d.ts",
+ "scripts": {
+ "lint": "theiaext lint",
+ "build": "theiaext build",
+ "watch": "theiaext watch",
+ "clean": "theiaext clean"
+ },
+ "devDependencies": {
+ "@theia/ext-scripts": "1.54.0"
+ }
+}
diff --git a/examples/api-provider-sample/src/common/plugin-api-rpc.ts b/examples/api-provider-sample/src/common/plugin-api-rpc.ts
new file mode 100644
index 0000000000000..87f34925ce0c0
--- /dev/null
+++ b/examples/api-provider-sample/src/common/plugin-api-rpc.ts
@@ -0,0 +1,70 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource 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
+// *****************************************************************************
+import { createProxyIdentifier } from '@theia/plugin-ext/lib/common/rpc-protocol';
+import type { greeting } from '../gotd';
+import { Event } from '@theia/core';
+
+export enum GreetingKind {
+ DIRECT = 1,
+ QUIRKY = 2,
+ SNARKY = 3,
+}
+
+export interface GreeterData {
+ readonly uuid: string;
+ greetingKinds: greeting.GreetingKind[];
+};
+
+export const GreetingMain = Symbol('GreetingMain');
+export interface GreetingMain {
+ $getMessage(greeterId: string): Promise+ +
+
+ECLIPSE THEIA - API PROVIDER SAMPLE
+ ++ +
+
+
+ +
+
+
+ +
+
+## Description
+
+The `@theia/ai-chat-ui` extension contributes the `AI Chat` view.\
+The `AI Chat view` can be used to easily communicate with a language model.
+
+It is based on `@theia/ai-chat`.
+
+## Additional Information
+
+- [Theia - GitHub](https://github.com/eclipse-theia/theia)
+- [Theia - Website](https://theia-ide.org/)
+
+## License
+
+- [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
+- [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
+
+## Trademark
+"Theia" is a trademark of the Eclipse Foundation
+https://www.eclipse.org/theia
diff --git a/packages/ai-chat-ui/package.json b/packages/ai-chat-ui/package.json
new file mode 100644
index 0000000000000..0edf7837f7294
--- /dev/null
+++ b/packages/ai-chat-ui/package.json
@@ -0,0 +1,58 @@
+{
+ "name": "@theia/ai-chat-ui",
+ "version": "1.54.0",
+ "description": "Theia - AI Chat UI Extension",
+ "dependencies": {
+ "@theia/ai-core": "1.54.0",
+ "@theia/ai-chat": "1.54.0",
+ "@theia/core": "1.54.0",
+ "@theia/editor": "1.54.0",
+ "@theia/filesystem": "1.54.0",
+ "@theia/monaco": "1.54.0",
+ "@theia/monaco-editor-core": "1.83.101",
+ "@theia/editor-preview": "1.54.0",
+ "@theia/workspace": "1.54.0",
+ "minimatch": "^5.1.0",
+ "tslib": "^2.6.2",
+ "uuid": "^9.0.1"
+ },
+ "publishConfig": {
+ "access": "public"
+ },
+ "theiaExtensions": [
+ {
+ "frontend": "lib/browser/ai-chat-ui-frontend-module",
+ "secondaryWindow": "lib/browser/ai-chat-ui-frontend-module"
+ }
+ ],
+ "keywords": [
+ "theia-extension"
+ ],
+ "license": "EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0",
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/eclipse-theia/theia.git"
+ },
+ "bugs": {
+ "url": "https://github.com/eclipse-theia/theia/issues"
+ },
+ "homepage": "https://github.com/eclipse-theia/theia",
+ "files": [
+ "lib",
+ "src"
+ ],
+ "scripts": {
+ "build": "theiaext build",
+ "clean": "theiaext clean",
+ "compile": "theiaext compile",
+ "lint": "theiaext lint",
+ "test": "theiaext test",
+ "watch": "theiaext watch"
+ },
+ "devDependencies": {
+ "@theia/ext-scripts": "1.54.0"
+ },
+ "nyc": {
+ "extends": "../../configs/nyc.json"
+ }
+}
diff --git a/packages/ai-chat-ui/src/browser/ai-chat-ui-contribution.ts b/packages/ai-chat-ui/src/browser/ai-chat-ui-contribution.ts
new file mode 100644
index 0000000000000..3c7c25eac7472
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/ai-chat-ui-contribution.ts
@@ -0,0 +1,171 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { inject, injectable } from '@theia/core/shared/inversify';
+import { CommandRegistry, QuickInputButton, QuickInputService, QuickPickItem } from '@theia/core';
+import { Widget } from '@theia/core/lib/browser';
+import { AI_CHAT_NEW_CHAT_WINDOW_COMMAND, AI_CHAT_SHOW_CHATS_COMMAND, ChatCommands } from './chat-view-commands';
+import { ChatAgentLocation, ChatService } from '@theia/ai-chat';
+import { AbstractViewContribution } from '@theia/core/lib/browser/shell/view-contribution';
+import { TabBarToolbarContribution, TabBarToolbarRegistry } from '@theia/core/lib/browser/shell/tab-bar-toolbar';
+import { ChatViewWidget } from './chat-view-widget';
+import { Deferred } from '@theia/core/lib/common/promise-util';
+import { SecondaryWindowHandler } from '@theia/core/lib/browser/secondary-window-handler';
+
+export const AI_CHAT_TOGGLE_COMMAND_ID = 'aiChat:toggle';
+
+@injectable()
+export class AIChatContribution extends AbstractViewContribution+ +
+
+ECLIPSE THEIA - AI Chat UI EXTENSION
+ ++ +
+
;
+};
diff --git a/packages/ai-chat-ui/src/browser/chat-node-toolbar-action-contribution.ts b/packages/ai-chat-ui/src/browser/chat-node-toolbar-action-contribution.ts
new file mode 100644
index 0000000000000..1a52d4867e185
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-node-toolbar-action-contribution.ts
@@ -0,0 +1,63 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { RequestNode, ResponseNode } from './chat-tree-view';
+
+export interface ChatNodeToolbarAction {
+ /**
+ * The command to execute when the item is selected. The handler will receive the `RequestNode` or `ResponseNode` as first argument.
+ */
+ commandId: string;
+ /**
+ * Icon class name(s) for the item (e.g. 'codicon codicon-feedback').
+ */
+ icon: string;
+ /**
+ * Priority among the items. Can be negative. The smaller the number the left-most the item will be placed in the toolbar. It is `0` by default.
+ */
+ priority?: number;
+ /**
+ * Optional tooltip for the item.
+ */
+ tooltip?: string;
+}
+
+/**
+ * Clients implement this interface if they want to contribute to the toolbar of chat nodes.
+ *
+ * ### Example
+ * ```ts
+ * bind(ChatNodeToolbarActionContribution).toDynamicValue(context => ({
+ * getToolbarActions: (args: RequestNode | ResponseNode) => {
+ * if (isResponseNode(args)) {
+ * return [{
+ * commandId: 'core.about',
+ * icon: 'codicon codicon-feedback',
+ * tooltip: 'Show about dialog on response nodes'
+ * }];
+ * } else {
+ * return [];
+ * }
+ * }
+ * }));
+ * ```
+ */
+export const ChatNodeToolbarActionContribution = Symbol('ChatNodeToolbarActionContribution');
+export interface ChatNodeToolbarActionContribution {
+ /**
+ * Returns the toolbar actions for the given node.
+ */
+ getToolbarActions(node: RequestNode | ResponseNode): ChatNodeToolbarAction[];
+}
diff --git a/packages/ai-chat-ui/src/browser/chat-response-part-renderer.ts b/packages/ai-chat-ui/src/browser/chat-response-part-renderer.ts
new file mode 100644
index 0000000000000..17743805aa59d
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-response-part-renderer.ts
@@ -0,0 +1,25 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { ChatResponseContent } from '@theia/ai-chat/lib/common';
+import { ReactNode } from '@theia/core/shared/react';
+import { ResponseNode } from './chat-tree-view/chat-view-tree-widget';
+
+export const ChatResponsePartRenderer = Symbol('ChatResponsePartRenderer');
+export interface ChatResponsePartRenderer
+
+
+
+ Enter your question
+
+ {
+ inProgress ? {
+ if (lastRequest) {
+ props.onCancel(lastRequest);
+ }
+ setInProgress(false);
+ }} /> :
+ submit(editorRef.current?.document.textEditorModel.getValue() || '')}
+ style={{ cursor: !props.isEnabled ? 'default' : 'pointer', opacity: !props.isEnabled ? 0.5 : 1 }}
+ />
+ }
+
+
+
+ );
+ }
+
+ protected renderTitle(response: CodeChatResponseContent): ReactNode {
+ const uri = response.location?.uri;
+ const position = response.location?.position;
+ if (uri && position) {
+ return {this.getTitle(response.location?.uri, response.language)};
+ }
+ return this.getTitle(response.location?.uri, response.language);
+ }
+
+ private getTitle(uri: URI | undefined, language: string | undefined): string {
+ // If there is a URI, use the file name as the title. Otherwise, use the language as the title.
+ // If there is no language, use a generic fallback title.
+ return uri?.path?.toString().split('/').pop() ?? language ?? 'Generated Code';
+ }
+
+ /**
+ * Opens a file and moves the cursor to the specified position.
+ *
+ * @param uri - The URI of the file to open.
+ * @param position - The position to move the cursor to, specified as {line, character}.
+ */
+ async openFileAtPosition(uri: URI, position: Position): Promise
+
+
+ {this.renderTitle(response)}
+
+
+
+ this.handleContextMenuEvent(parentNode, e, response.code)}>
+
+ The command has the id "{response.command.id}" but it is not executable from the Chat window.
;
+
+ }
+ }
+ return ;
+ }
+ private onCommand(arg: CommandChatResponseContent): void {
+ if (arg.customCallback) {
+ arg.customCallback.callback().catch(e => { console.error(e); });
+ } else if (arg.command) {
+ this.commandService.executeCommand(arg.command.id, ...(arg.arguments ?? [])).catch(e => { console.error(e); });
+ } else {
+ console.warn('No command or custom callback provided in command chat response content');
+ }
+ }
+}
diff --git a/packages/ai-chat-ui/src/browser/chat-response-renderer/error-part-renderer.tsx b/packages/ai-chat-ui/src/browser/chat-response-renderer/error-part-renderer.tsx
new file mode 100644
index 0000000000000..4a8fc593d9b50
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-response-renderer/error-part-renderer.tsx
@@ -0,0 +1,35 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { ChatResponsePartRenderer } from '../chat-response-part-renderer';
+import { injectable } from '@theia/core/shared/inversify';
+import { ChatResponseContent, ErrorChatResponseContent } from '@theia/ai-chat/lib/common';
+import { ReactNode } from '@theia/core/shared/react';
+import * as React from '@theia/core/shared/react';
+
+@injectable()
+export class ErrorPartRenderer implements ChatResponsePartRenderer{response.error.message}
;
+ }
+
+}
diff --git a/packages/ai-chat-ui/src/browser/chat-response-renderer/horizontal-layout-part-renderer.tsx b/packages/ai-chat-ui/src/browser/chat-response-renderer/horizontal-layout-part-renderer.tsx
new file mode 100644
index 0000000000000..79ef8d1b9e483
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-response-renderer/horizontal-layout-part-renderer.tsx
@@ -0,0 +1,59 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { ChatResponsePartRenderer } from '../chat-response-part-renderer';
+import { inject, injectable, named } from '@theia/core/shared/inversify';
+import {
+ ChatResponseContent,
+ HorizontalLayoutChatResponseContent,
+} from '@theia/ai-chat/lib/common';
+import { ReactNode } from '@theia/core/shared/react';
+import * as React from '@theia/core/shared/react';
+import { ContributionProvider } from '@theia/core';
+import { ResponseNode } from '../chat-tree-view/chat-view-tree-widget';
+
+@injectable()
+export class HorizontalLayoutPartRenderer
+ implements ChatResponsePartRenderer
+ {response.content.map(content => {
+ const renderer = contributions
+ .map(c => ({
+ prio: c.canHandle(content),
+ renderer: c,
+ }))
+ .sort((a, b) => b.prio - a.prio)[0].renderer;
+ return renderer.render(content, parentNode);
+ })}
+
+ );
+ }
+}
diff --git a/packages/ai-chat-ui/src/browser/chat-response-renderer/index.ts b/packages/ai-chat-ui/src/browser/chat-response-renderer/index.ts
new file mode 100644
index 0000000000000..b0846e52fe1c2
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-response-renderer/index.ts
@@ -0,0 +1,23 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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
+// *****************************************************************************
+export * from './ai-editor-manager';
+export * from './code-part-renderer';
+export * from './command-part-renderer';
+export * from './error-part-renderer';
+export * from './horizontal-layout-part-renderer';
+export * from './markdown-part-renderer';
+export * from './text-part-renderer';
+export * from './toolcall-part-renderer';
diff --git a/packages/ai-chat-ui/src/browser/chat-response-renderer/markdown-part-renderer.tsx b/packages/ai-chat-ui/src/browser/chat-response-renderer/markdown-part-renderer.tsx
new file mode 100644
index 0000000000000..8fba51ad2fcbd
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-response-renderer/markdown-part-renderer.tsx
@@ -0,0 +1,90 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { ChatResponsePartRenderer } from '../chat-response-part-renderer';
+import { injectable } from '@theia/core/shared/inversify';
+import {
+ ChatResponseContent,
+ InformationalChatResponseContent,
+ MarkdownChatResponseContent,
+} from '@theia/ai-chat/lib/common';
+import { ReactNode, useEffect, useRef } from '@theia/core/shared/react';
+import * as React from '@theia/core/shared/react';
+import * as markdownit from '@theia/core/shared/markdown-it';
+import * as DOMPurify from '@theia/core/shared/dompurify';
+import { MarkdownString } from '@theia/core/lib/common/markdown-rendering';
+
+@injectable()
+export class MarkdownPartRenderer implements ChatResponsePartRenderer
+ {response.finished ?
+
+ Ran {response.name}
+ {this.tryPrettyPrintJson(response)}
+
+ :
;
+
+ }
+
+ private tryPrettyPrintJson(response: ToolCallChatResponseContent): string | undefined {
+ let responseContent = response.result;
+ try {
+ if (response.result) {
+ responseContent = JSON.stringify(JSON.parse(response.result), undefined, 2);
+ }
+ } catch (e) {
+ // fall through
+ }
+ return responseContent;
+ }
+}
+
+const Spinner = () => (
+
+);
diff --git a/packages/ai-chat-ui/src/browser/chat-tree-view/chat-view-tree-container.ts b/packages/ai-chat-ui/src/browser/chat-tree-view/chat-view-tree-container.ts
new file mode 100644
index 0000000000000..9550de109ec0a
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-tree-view/chat-view-tree-container.ts
@@ -0,0 +1,32 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { createTreeContainer, TreeProps } from '@theia/core/lib/browser';
+import { interfaces } from '@theia/core/shared/inversify';
+import { ChatViewTreeWidget } from './chat-view-tree-widget';
+
+const CHAT_VIEW_TREE_PROPS = {
+ multiSelect: false,
+ search: false,
+} as TreeProps;
+
+export function createChatViewTreeWidget(parent: interfaces.Container): ChatViewTreeWidget {
+ const child = createTreeContainer(parent, {
+ props: CHAT_VIEW_TREE_PROPS,
+ widget: ChatViewTreeWidget,
+ });
+ return child.get(ChatViewTreeWidget);
+}
diff --git a/packages/ai-chat-ui/src/browser/chat-tree-view/chat-view-tree-widget.tsx b/packages/ai-chat-ui/src/browser/chat-tree-view/chat-view-tree-widget.tsx
new file mode 100644
index 0000000000000..19d7daacdd9b8
--- /dev/null
+++ b/packages/ai-chat-ui/src/browser/chat-tree-view/chat-view-tree-widget.tsx
@@ -0,0 +1,403 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 {
+ ChatAgentService,
+ ChatModel,
+ ChatProgressMessage,
+ ChatRequestModel,
+ ChatResponseContent,
+ ChatResponseModel,
+} from '@theia/ai-chat';
+import { CommandRegistry, ContributionProvider } from '@theia/core';
+import {
+ codicon,
+ CommonCommands,
+ CompositeTreeNode,
+ ContextMenuRenderer,
+ Key,
+ KeyCode,
+ NodeProps,
+ TreeModel,
+ TreeNode,
+ TreeProps,
+ TreeWidget,
+} from '@theia/core/lib/browser';
+import {
+ inject,
+ injectable,
+ named,
+ postConstruct
+} from '@theia/core/shared/inversify';
+import * as React from '@theia/core/shared/react';
+
+import { ChatNodeToolbarActionContribution } from '../chat-node-toolbar-action-contribution';
+import { ChatResponsePartRenderer } from '../chat-response-part-renderer';
+import { useMarkdownRendering } from '../chat-response-renderer/markdown-part-renderer';
+
+// TODO Instead of directly operating on the ChatRequestModel we could use an intermediate view model
+export interface RequestNode extends TreeNode {
+ request: ChatRequestModel
+}
+export const isRequestNode = (node: TreeNode): node is RequestNode => 'request' in node;
+
+// TODO Instead of directly operating on the ChatResponseModel we could use an intermediate view model
+export interface ResponseNode extends TreeNode {
+ response: ChatResponseModel
+}
+export const isResponseNode = (node: TreeNode): node is ResponseNode => 'response' in node;
+
+function isEnterKey(e: React.KeyboardEvent): boolean {
+ return Key.ENTER.keyCode === KeyCode.createKeyCode(e.nativeEvent).key?.keyCode;
+}
+
+@injectable()
+export class ChatViewTreeWidget extends TreeWidget {
+ static readonly ID = 'chat-tree-widget';
+ static readonly CONTEXT_MENU = ['chat-tree-context-menu'];
+
+ @inject(ContributionProvider) @named(ChatResponsePartRenderer)
+ protected readonly chatResponsePartRenderers: ContributionProviderRan {response.name}
+{this.tryPrettyPrintJson(response)}
+
+
;
+ }
+
+ private renderLinkButton(title: string, openCommandId: string): React.ReactNode {
+ return this.commandRegistry.executeCommand(openCommandId)}
+ onKeyDown={e => isEnterKey(e) && this.commandRegistry.executeCommand(openCommandId)}>
+ {title}
+ ;
+ }
+
+ private mapRequestToNode(request: ChatRequestModel): RequestNode {
+ return {
+ id: request.id,
+ parent: this.model.root as CompositeTreeNode,
+ request
+ };
+ }
+
+ private mapResponseToNode(response: ChatResponseModel): ResponseNode {
+ return {
+ id: response.id,
+ parent: this.model.root as CompositeTreeNode,
+ response
+ };
+ }
+
+ /**
+ * Tracks the ChatModel handed over.
+ * Tracking multiple chat models will result in a weird UI
+ */
+ public trackChatModel(chatModel: ChatModel): void {
+ this.recreateModelTree(chatModel);
+ chatModel.getRequests().forEach(request => {
+ if (!request.response.isComplete) {
+ request.response.onDidChange(() => this.scheduleUpdateScrollToRow());
+ }
+ });
+ this.toDispose.push(
+ chatModel.onDidChange(event => {
+ this.recreateModelTree(chatModel);
+ if (event.kind === 'addRequest' && !event.request.response.isComplete) {
+ event.request.response.onDidChange(() => this.scheduleUpdateScrollToRow());
+ }
+ })
+ );
+ }
+
+ protected override getScrollToRow(): number | undefined {
+ if (this.shouldScrollToEnd) {
+ return this.rows.size;
+ }
+ return super.getScrollToRow();
+ }
+
+ private async recreateModelTree(chatModel: ChatModel): Promise
+
+
+ 🚀 Experimental AI Feature Available!
+
+
+
+ Currently, all AI Features are disabled!
+
+ How to Enable Experimental AI Features:
+
+
+
+ To enable the experimental AI features, please go to + {this.renderLinkButton('the settings menu', CommonCommands.OPEN_PREFERENCES.id)} + and locate the AI Features section.
+-
+
- Toggle the switch for 'Ai-features: Enable'. +
- Provide at least one LLM provider (e.g. OpenAI), also see the documentation + for more information. +
This will activate the new AI capabilities in the app. Please remember, these features are still in development, so they may change or be unstable. 🚧
+
+
+ Currently Supported Views and Features:
+
+
+ Once the experimental AI features are enabled, you can access the following views and features:
+-
+
- Code Completion +
- Terminal Assistance (via CTRL+I in a terminal) +
- This Chat View (features the following agents):
+
-
+
- Universal Chat Agent +
- Workspace Chat Agent +
- Command Chat Agent +
- Orchestrator Chat Agent +
+ - {this.renderLinkButton('AI History View', 'aiHistory:open')} +
- {this.renderLinkButton('AI Configuration View', 'aiConfiguration:open')} +
See the documentation for more information.
+ this.handleContextMenu(node, e)}>
+ {this.renderAgent(node)}
+ {this.renderDetail(node)}
+
+
+
+
+ {this.getAgentLabel(node)}
+ {inProgress && Generating} +
+ {!inProgress &&
+ toolbarContributions.length > 0 &&
+ toolbarContributions.map(action =>
+ {
+ e.stopPropagation();
+ this.commandRegistry.executeCommand(action.commandId, node);
+ }}
+ onKeyDown={e => {
+ if (isEnterKey(e)) {
+ e.stopPropagation();
+ this.commandRegistry.executeCommand(action.commandId, node);
+ }
+ }}
+ role='button'
+ >
+ )}
+
+
+ {!node.response.isComplete
+ && node.response.response.content.length === 0
+ && node.response.progressMessages.map((c, i) =>
+
+ );
+ }
+
+ private getChatResponsePartRenderer(content: ChatResponseContent, node: ResponseNode): React.ReactNode {
+ const renderer = this.chatResponsePartRenderers.getContributions().reduce<[number, ChatResponsePartRenderer{this.getChatResponsePartRenderer(c, node)}
+ )}
+ Error: No renderer found
;
+ }
+ return renderer.render(content, node);
+ }
+
+ protected handleContextMenu(node: TreeNode | undefined, event: React.MouseEvent
+
+);
+
+const Indicator = (progressMessage: ChatProgressMessage) => (
+
+ {progressMessage.status === 'inProgress' &&
+
+ }
+ {progressMessage.status === 'completed' &&
+
+ }
+ {progressMessage.status === 'failed' &&
+
+ }
+
+);
diff --git a/packages/filesystem/src/typings/nsfw/index.d.ts b/packages/ai-chat-ui/src/browser/chat-tree-view/index.ts
similarity index 84%
rename from packages/filesystem/src/typings/nsfw/index.d.ts
rename to packages/ai-chat-ui/src/browser/chat-tree-view/index.ts
index 0573effb0d4c1..b3a2fd606e01a 100644
--- a/packages/filesystem/src/typings/nsfw/index.d.ts
+++ b/packages/ai-chat-ui/src/browser/chat-tree-view/index.ts
@@ -1,5 +1,5 @@
// *****************************************************************************
-// Copyright (C) 2018 Ericsson and others.
+// Copyright (C) 2024 EclipseSource GmbH.
//
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License v. 2.0 which is available at
@@ -14,5 +14,5 @@
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
// *****************************************************************************
-// eslint-disable-next-line spaced-comment
-///
+
+
+ +
+
+
+ +
+
+## Description
+
+The `@theia/ai-chat` extension provides the concept of a language model chat to Theia.
+It serves as the basis for `@theia/ai-chat-ui` to provide the Chat UI.
+
+## Additional Information
+
+- [Theia - GitHub](https://github.com/eclipse-theia/theia)
+- [Theia - Website](https://theia-ide.org/)
+
+## License
+
+- [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
+- [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
+
+## Trademark
+"Theia" is a trademark of the Eclipse Foundation
+https://www.eclipse.org/theia
diff --git a/packages/ai-chat/package.json b/packages/ai-chat/package.json
new file mode 100644
index 0000000000000..bc6843dc6fe42
--- /dev/null
+++ b/packages/ai-chat/package.json
@@ -0,0 +1,53 @@
+{
+ "name": "@theia/ai-chat",
+ "version": "1.54.0",
+ "description": "Theia - AI Chat Extension",
+ "dependencies": {
+ "@theia/ai-core": "1.54.0",
+ "@theia/ai-history": "1.54.0",
+ "@theia/core": "1.54.0",
+ "@theia/filesystem": "1.54.0",
+ "@theia/workspace": "1.54.0",
+ "minimatch": "^5.1.0",
+ "tslib": "^2.6.2"
+ },
+ "publishConfig": {
+ "access": "public"
+ },
+ "main": "lib/common",
+ "theiaExtensions": [
+ {
+ "frontend": "lib/browser/ai-chat-frontend-module"
+ }
+ ],
+ "keywords": [
+ "theia-extension"
+ ],
+ "license": "EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0",
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/eclipse-theia/theia.git"
+ },
+ "bugs": {
+ "url": "https://github.com/eclipse-theia/theia/issues"
+ },
+ "homepage": "https://github.com/eclipse-theia/theia",
+ "files": [
+ "lib",
+ "src"
+ ],
+ "scripts": {
+ "build": "theiaext build",
+ "clean": "theiaext clean",
+ "compile": "theiaext compile",
+ "lint": "theiaext lint",
+ "test": "theiaext test",
+ "watch": "theiaext watch"
+ },
+ "devDependencies": {
+ "@theia/ext-scripts": "1.54.0"
+ },
+ "nyc": {
+ "extends": "../../configs/nyc.json"
+ }
+}
diff --git a/packages/ai-chat/src/browser/ai-chat-frontend-module.ts b/packages/ai-chat/src/browser/ai-chat-frontend-module.ts
new file mode 100644
index 0000000000000..396bcb7331a06
--- /dev/null
+++ b/packages/ai-chat/src/browser/ai-chat-frontend-module.ts
@@ -0,0 +1,93 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// 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 { Agent, AgentService, AIVariableContribution } from '@theia/ai-core/lib/common';
+import { bindContributionProvider } from '@theia/core';
+import { FrontendApplicationContribution, PreferenceContribution } from '@theia/core/lib/browser';
+import { ContainerModule } from '@theia/core/shared/inversify';
+import {
+ ChatAgent,
+ ChatAgentService,
+ ChatAgentServiceImpl,
+ ChatRequestParser,
+ ChatRequestParserImpl,
+ ChatService,
+ DefaultChatAgentId
+} from '../common';
+import { ChatAgentsVariableContribution } from '../common/chat-agents-variable-contribution';
+import { CommandChatAgent } from '../common/command-chat-agents';
+import { CustomChatAgent } from '../common/custom-chat-agent';
+import { OrchestratorChatAgent, OrchestratorChatAgentId } from '../common/orchestrator-chat-agent';
+import { DefaultResponseContentFactory, DefaultResponseContentMatcherProvider, ResponseContentMatcherProvider } from '../common/response-content-matcher';
+import { UniversalChatAgent } from '../common/universal-chat-agent';
+import { aiChatPreferences } from './ai-chat-preferences';
+import { AICustomAgentsFrontendApplicationContribution } from './custom-agent-frontend-application-contribution';
+import { FrontendChatServiceImpl } from './frontend-chat-service';
+import { CustomAgentFactory } from './custom-agent-factory';
+
+export default new ContainerModule(bind => {
+ bindContributionProvider(bind, Agent);
+ bindContributionProvider(bind, ChatAgent);
+
+ bind(ChatAgentServiceImpl).toSelf().inSingletonScope();
+ bind(ChatAgentService).toService(ChatAgentServiceImpl);
+ bind(DefaultChatAgentId).toConstantValue({ id: OrchestratorChatAgentId });
+
+ bindContributionProvider(bind, ResponseContentMatcherProvider);
+ bind(DefaultResponseContentMatcherProvider).toSelf().inSingletonScope();
+ bind(ResponseContentMatcherProvider).toService(DefaultResponseContentMatcherProvider);
+ bind(DefaultResponseContentFactory).toSelf().inSingletonScope();
+
+ bind(AIVariableContribution).to(ChatAgentsVariableContribution).inSingletonScope();
+
+ bind(ChatRequestParserImpl).toSelf().inSingletonScope();
+ bind(ChatRequestParser).toService(ChatRequestParserImpl);
+
+ bind(FrontendChatServiceImpl).toSelf().inSingletonScope();
+ bind(ChatService).toService(FrontendChatServiceImpl);
+
+ bind(OrchestratorChatAgent).toSelf().inSingletonScope();
+ bind(Agent).toService(OrchestratorChatAgent);
+ bind(ChatAgent).toService(OrchestratorChatAgent);
+
+ bind(UniversalChatAgent).toSelf().inSingletonScope();
+ bind(Agent).toService(UniversalChatAgent);
+ bind(ChatAgent).toService(UniversalChatAgent);
+
+ bind(CommandChatAgent).toSelf().inSingletonScope();
+ bind(Agent).toService(CommandChatAgent);
+ bind(ChatAgent).toService(CommandChatAgent);
+
+ bind(PreferenceContribution).toConstantValue({ schema: aiChatPreferences });
+
+ bind(CustomChatAgent).toSelf();
+ bind(CustomAgentFactory).toFactory+ +
+
+ECLIPSE THEIA - AI Chat EXTENSION
+ ++ +