@theia/ai-external-api 1.76.0-next.33

package/README.md

@@ -0,0 +1,83 @@
+<div align='center'>
+
+<br />
+
+<img src='https://raw.githubusercontent.com/eclipse-theia/theia/master/logo/theia.svg?sanitize=true' alt='theia-ext-logo' width='100px' />
+
+<h2>ECLIPSE THEIA - AI EXTERNAL API EXTENSION</h2>
+
+<hr />
+
+</div>
+
+## Description
+
+This package exposes an HTTP API on the Theia backend that allows external tools
+(control planes, dashboards, CLIs) to inspect the AI chat sessions of a running Theia
+instance, to follow session changes as a push stream, to open or restore sessions in
+the IDE, to send prompts to sessions, and to create new sessions.
+
+Session data is provided live by the connected frontends: each frontend registers itself with
+the backend and is queried on demand. Sessions that are restored (in memory) in a connected
+frontend are reported with their full state; persisted sessions that have not been restored
+are reported with their persisted metadata and `"restored": false`. If no frontend is
+connected, the session list is empty. Sessions that an agent delegated to another agent are
+listed alongside top-level ones and carry `parentSessionId` and `rootSessionId`, so consumers
+can group them as the IDE's session list does.
+
+Session *status* uses the aggregated per-session status of `ChatModel.status`
+(`@theia/ai-chat`): `idle`, `running`, `awaitingApproval`, `awaitingToolCall`,
+`awaitingInput`, or `failed`. Persisted sessions that are not restored report `failed` if
+their last request ended in an error and `idle` otherwise.
+
+### Enabling the API
+
+The endpoints are contributed to the external API server of `@theia/external-api`, which is
+disabled by default and configured through the `externalApi.*` user preferences (delivery
+mode, port, hostname, and bearer token). See the `@theia/external-api` README for the
+configuration and its security considerations.
+
+### API Endpoints
+
+| Endpoint | Purpose |
+|---|---|
+| `GET /api/ai/sessions` | List the sessions, most recently used first. |
+| `POST /api/ai/sessions` | Create a session, optionally sending an initial prompt. |
+| `GET /api/ai/sessions/events` | Follow the session list as server-sent events. |
+| `GET /api/ai/sessions/:id` | Read one session including its conversation. |
+| `POST /api/ai/sessions/:id/prompt` | Send a prompt to the session. |
+| `POST /api/ai/sessions/:id/open` | Show the session in the chat view of a connected frontend. |
+| `POST /api/ai/sessions/:id/restore` | Restore the session without focusing it. |
+
+The endpoints, their request and response bodies, and their error responses are documented in
+the [API reference](https://github.com/eclipse-theia/theia/blob/master/packages/ai-external-api/doc/api-reference.md).
+The API also describes itself: all endpoints are published, with descriptions and schemas,
+in the OpenAPI document served at `GET /api/openapi.json` (see `@theia/external-api`), e.g.
+to generate clients or MCP tool definitions.
+
+### Security Considerations
+
+- Chat histories can contain sensitive workspace content. Configure an `externalApi.token`
+  and mind the security considerations of `@theia/external-api`.
+- The creation and prompt endpoints trigger agent execution: they start language model
+  requests and, depending on the configured tool confirmation settings, tool calls in the
+  user's IDE. Do not expose them without a token.
+- The open and restore endpoints affect the IDE: opening raises the chat view in the user's
+  frontend, creating switches the active session, and restoring loads persisted session data
+  into memory.
+
+## Additional Information
+
+- [API documentation for `@theia/ai-external-api`](https://eclipse-theia.github.io/theia/docs/next/modules/_theia_ai-external-api.html)
+- [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>

package/lib/browser/ai-external-api-frontend-contribution.d.ts

@@ -0,0 +1,28 @@
+import { ChatService, ChatSession } from '@theia/ai-chat/lib/common/chat-service';
+import { Disposable } from '@theia/core';
+import { FrontendApplicationContribution } from '@theia/core/lib/browser';
+import { ExternalChatSessionBackendService } from '../common/external-chat-session-provider';
+/**
+ * Connects this frontend to the external session API of the backend.
+ *
+ * Injecting the {@link ExternalChatSessionBackendService} proxy on application start eagerly
+ * establishes the RPC connection through which the backend queries this frontend for session
+ * information. In the other direction, this contribution observes the frontend's chat sessions
+ * and notifies the backend about changes that are visible to external API clients (session
+ * lifecycle, titles, and status), debounced to coalesce bursts of changes.
+ */
+export declare class AIExternalApiFrontendContribution implements FrontendApplicationContribution {
+    /** Debounce delay in milliseconds for change notifications to the backend. */
+    protected readonly notifyDelay = 200;
+    /** Maximum time in milliseconds a continuously changing session may defer a notification. */
+    protected readonly notifyMaxDelay = 1000;
+    protected readonly backendService: ExternalChatSessionBackendService;
+    protected readonly chatService: ChatService;
+    /** Status listeners per tracked session, disposed when the session is deleted. */
+    protected readonly sessionListeners: Map<string, Disposable>;
+    protected readonly notifyBackend: import("lodash").DebouncedFunc<() => void>;
+    onStart(): void;
+    /** Notifies the backend about status changes of the given session until the session is deleted. */
+    protected trackSession(session: ChatSession): void;
+}
+//# sourceMappingURL=ai-external-api-frontend-contribution.d.ts.map

package/lib/browser/ai-external-api-frontend-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-frontend-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/ai-external-api-frontend-contribution.ts"],"names":[],"mappings":"AAiBA,OAAO,EACH,WAAW,EAAE,WAAW,EAC3B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAG1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAE7F;;;;;;;;GAQG;AACH,qBACa,iCAAkC,YAAW,+BAA+B;IAErF,8EAA8E;IAC9E,SAAS,CAAC,QAAQ,CAAC,WAAW,OAAO;IACrC,6FAA6F;IAC7F,SAAS,CAAC,QAAQ,CAAC,cAAc,QAAQ;IAGzC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,iCAAiC,CAAC;IAGrE,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAE5C,kFAAkF;IAClF,SAAS,CAAC,QAAQ,CAAC,gBAAgB,0BAAiC;IAEpE,SAAS,CAAC,QAAQ,CAAC,aAAa,6CAI9B;IAEF,OAAO,IAAI,IAAI;IAoBf,mGAAmG;IACnG,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAUrD"}

package/lib/browser/ai-external-api-frontend-contribution.js

@@ -0,0 +1,88 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIExternalApiFrontendContribution = void 0;
+const tslib_1 = require("tslib");
+const chat_model_1 = require("@theia/ai-chat/lib/common/chat-model");
+const chat_service_1 = require("@theia/ai-chat/lib/common/chat-service");
+const inversify_1 = require("@theia/core/shared/inversify");
+const debounce = require("@theia/core/shared/lodash.debounce");
+const external_chat_session_provider_1 = require("../common/external-chat-session-provider");
+/**
+ * Connects this frontend to the external session API of the backend.
+ *
+ * Injecting the {@link ExternalChatSessionBackendService} proxy on application start eagerly
+ * establishes the RPC connection through which the backend queries this frontend for session
+ * information. In the other direction, this contribution observes the frontend's chat sessions
+ * and notifies the backend about changes that are visible to external API clients (session
+ * lifecycle, titles, and status), debounced to coalesce bursts of changes.
+ */
+let AIExternalApiFrontendContribution = class AIExternalApiFrontendContribution {
+    constructor() {
+        /** Debounce delay in milliseconds for change notifications to the backend. */
+        this.notifyDelay = 200;
+        /** Maximum time in milliseconds a continuously changing session may defer a notification. */
+        this.notifyMaxDelay = 1000;
+        /** Status listeners per tracked session, disposed when the session is deleted. */
+        this.sessionListeners = new Map();
+        this.notifyBackend = debounce(() => this.backendService.notifySessionsChanged(), this.notifyDelay, { maxWait: this.notifyMaxDelay });
+    }
+    onStart() {
+        this.chatService.onSessionEvent(event => {
+            if ((0, chat_service_1.isActiveSessionChangedEvent)(event)) {
+                // which session is active is not visible to external API clients
+                return;
+            }
+            if ((0, chat_service_1.isSessionCreatedEvent)(event)) {
+                const session = this.chatService.getSession(event.sessionId);
+                if (session) {
+                    this.trackSession(session);
+                }
+            }
+            else if ((0, chat_service_1.isSessionDeletedEvent)(event)) {
+                this.sessionListeners.get(event.sessionId)?.dispose();
+                this.sessionListeners.delete(event.sessionId);
+            }
+            this.notifyBackend();
+        });
+        this.chatService.getSessions().forEach(session => this.trackSession(session));
+    }
+    /** Notifies the backend about status changes of the given session until the session is deleted. */
+    trackSession(session) {
+        if (this.sessionListeners.has(session.id)) {
+            return;
+        }
+        this.sessionListeners.set(session.id, session.model.onDidChange(event => {
+            if (chat_model_1.ChatChangeEvent.isStatusChangedEvent(event)) {
+                this.notifyBackend();
+            }
+        }));
+    }
+};
+exports.AIExternalApiFrontendContribution = AIExternalApiFrontendContribution;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(external_chat_session_provider_1.ExternalChatSessionBackendService),
+    tslib_1.__metadata("design:type", Object)
+], AIExternalApiFrontendContribution.prototype, "backendService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(chat_service_1.ChatService),
+    tslib_1.__metadata("design:type", Object)
+], AIExternalApiFrontendContribution.prototype, "chatService", void 0);
+exports.AIExternalApiFrontendContribution = AIExternalApiFrontendContribution = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], AIExternalApiFrontendContribution);
+//# sourceMappingURL=ai-external-api-frontend-contribution.js.map

package/lib/browser/ai-external-api-frontend-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-frontend-contribution.js","sourceRoot":"","sources":["../../src/browser/ai-external-api-frontend-contribution.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,qEAAuE;AACvE,yEAEgD;AAGhD,4DAAkE;AAClE,+DAAgE;AAChE,6FAA6F;AAE7F;;;;;;;;GAQG;AAEI,IAAM,iCAAiC,GAAvC,MAAM,iCAAiC;IAAvC;QAEH,8EAA8E;QAC3D,gBAAW,GAAG,GAAG,CAAC;QACrC,6FAA6F;QAC1E,mBAAc,GAAG,IAAI,CAAC;QAQzC,kFAAkF;QAC/D,qBAAgB,GAAG,IAAI,GAAG,EAAsB,CAAC;QAEjD,kBAAa,GAAG,QAAQ,CACvC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,EACjD,IAAI,CAAC,WAAW,EAChB,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,CACnC,CAAC;IAiCN,CAAC;IA/BG,OAAO;QACH,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE;YACpC,IAAI,IAAA,0CAA2B,EAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,iEAAiE;gBACjE,OAAO;YACX,CAAC;YACD,IAAI,IAAA,oCAAqB,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC7D,IAAI,OAAO,EAAE,CAAC;oBACV,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC;YACL,CAAC;iBAAM,IAAI,IAAA,oCAAqB,EAAC,KAAK,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;gBACtD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAClD,CAAC;YACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAClF,CAAC;IAED,mGAAmG;IACzF,YAAY,CAAC,OAAoB;QACvC,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACxC,OAAO;QACX,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YACpE,IAAI,4BAAe,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,IAAI,CAAC,aAAa,EAAE,CAAC;YACzB,CAAC;QACL,CAAC,CAAC,CAAC,CAAC;IACR,CAAC;CACJ,CAAA;AArDY,8EAAiC;AAQvB;IADlB,IAAA,kBAAM,EAAC,kEAAiC,CAAC;;yEAC2B;AAGlD;IADlB,IAAA,kBAAM,EAAC,0BAAW,CAAC;;sEACwB;4CAXnC,iCAAiC;IAD7C,IAAA,sBAAU,GAAE;GACA,iCAAiC,CAqD7C"}

package/lib/browser/ai-external-api-frontend-contribution.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai-external-api-frontend-contribution.spec.d.ts.map

package/lib/browser/ai-external-api-frontend-contribution.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-frontend-contribution.spec.d.ts","sourceRoot":"","sources":["../../src/browser/ai-external-api-frontend-contribution.spec.ts"],"names":[],"mappings":""}

package/lib/browser/ai-external-api-frontend-contribution.spec.js

@@ -0,0 +1,102 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsdom_1 = require("@theia/core/lib/browser/test/jsdom");
+const disableJSDOM = (0, jsdom_1.enableJSDOM)();
+const frontend_application_config_provider_1 = require("@theia/core/lib/browser/frontend-application-config-provider");
+frontend_application_config_provider_1.FrontendApplicationConfigProvider.set({});
+const core_1 = require("@theia/core");
+const chai_1 = require("chai");
+const ai_external_api_frontend_contribution_1 = require("./ai-external-api-frontend-contribution");
+disableJSDOM();
+describe('AIExternalApiFrontendContribution', () => {
+    function trackedSession(id) {
+        const modelChanges = new core_1.Emitter();
+        return {
+            session: { id, model: { onDidChange: modelChanges.event } },
+            fireStatusChanged: () => modelChanges.fire({ kind: 'statusChanged' }),
+            fireOtherModelChange: () => modelChanges.fire({ kind: 'responseChanged' })
+        };
+    }
+    function startContribution(initialSessions = []) {
+        const sessionEvents = new core_1.Emitter();
+        const sessions = [...initialSessions];
+        const chatService = {
+            onSessionEvent: sessionEvents.event,
+            getSessions: () => sessions.map(tracked => tracked.session),
+            getSession: (id) => sessions.find(tracked => tracked.session.id === id)?.session
+        };
+        let count = 0;
+        const contribution = new ai_external_api_frontend_contribution_1.AIExternalApiFrontendContribution();
+        contribution['chatService'] = chatService;
+        contribution['backendService'] = { notifySessionsChanged: () => count++ };
+        contribution.onStart();
+        return {
+            sessionEvents,
+            addSession: tracked => sessions.push(tracked),
+            removeSession: id => sessions.splice(sessions.findIndex(tracked => tracked.session.id === id), 1),
+            notifications: () => count
+        };
+    }
+    /** Waits long enough for a debounced notification to be delivered. */
+    function settle() {
+        return new Promise(resolve => setTimeout(resolve, 300));
+    }
+    it('notifies the backend when a session is created', async () => {
+        const context = startContribution();
+        context.addSession(trackedSession('1'));
+        context.sessionEvents.fire({ type: 'created', sessionId: '1' });
+        await settle();
+        (0, chai_1.expect)(context.notifications()).to.equal(1);
+    });
+    it('notifies the backend on session status changes', async () => {
+        const tracked = trackedSession('1');
+        const context = startContribution([tracked]);
+        tracked.fireStatusChanged();
+        await settle();
+        (0, chai_1.expect)(context.notifications()).to.equal(1);
+    });
+    it('coalesces bursts of changes into a single notification', async () => {
+        const tracked = trackedSession('1');
+        const context = startContribution([tracked]);
+        context.sessionEvents.fire({ type: 'renamed', sessionId: '1' });
+        tracked.fireStatusChanged();
+        tracked.fireStatusChanged();
+        await settle();
+        (0, chai_1.expect)(context.notifications()).to.equal(1);
+    });
+    it('ignores changes that are not visible to external clients', async () => {
+        const tracked = trackedSession('1');
+        const context = startContribution([tracked]);
+        context.sessionEvents.fire({ type: 'activeChange', sessionId: '1' });
+        tracked.fireOtherModelChange();
+        await settle();
+        (0, chai_1.expect)(context.notifications()).to.equal(0);
+    });
+    it('stops observing deleted sessions', async () => {
+        const tracked = trackedSession('1');
+        const context = startContribution([tracked]);
+        context.removeSession('1');
+        context.sessionEvents.fire({ type: 'deleted', sessionId: '1' });
+        await settle();
+        (0, chai_1.expect)(context.notifications()).to.equal(1);
+        tracked.fireStatusChanged();
+        await settle();
+        (0, chai_1.expect)(context.notifications()).to.equal(1);
+    });
+});
+//# sourceMappingURL=ai-external-api-frontend-contribution.spec.js.map

package/lib/browser/ai-external-api-frontend-contribution.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-frontend-contribution.spec.js","sourceRoot":"","sources":["../../src/browser/ai-external-api-frontend-contribution.spec.ts"],"names":[],"mappings":"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"}

package/lib/browser/ai-external-api-frontend-module.d.ts

@@ -0,0 +1,4 @@
+import { ContainerModule } from '@theia/core/shared/inversify';
+declare const _default: ContainerModule;
+export default _default;
+//# sourceMappingURL=ai-external-api-frontend-module.d.ts.map

package/lib/browser/ai-external-api-frontend-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-frontend-module.d.ts","sourceRoot":"","sources":["../../src/browser/ai-external-api-frontend-module.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;;AAK/D,wBAwBG"}

package/lib/browser/ai-external-api-frontend-module.js

@@ -0,0 +1,47 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const browser_1 = require("@theia/core/lib/browser");
+const service_connection_provider_1 = require("@theia/core/lib/browser/messaging/service-connection-provider");
+const inversify_1 = require("@theia/core/shared/inversify");
+const external_chat_session_provider_1 = require("../common/external-chat-session-provider");
+const ai_external_api_frontend_contribution_1 = require("./ai-external-api-frontend-contribution");
+const frontend_external_chat_session_provider_1 = require("./frontend-external-chat-session-provider");
+exports.default = new inversify_1.ContainerModule(bind => {
+    bind(frontend_external_chat_session_provider_1.FrontendExternalChatSessionProvider).toSelf().inSingletonScope();
+    bind(external_chat_session_provider_1.ExternalChatSessionProvider).toService(frontend_external_chat_session_provider_1.FrontendExternalChatSessionProvider);
+    bind(external_chat_session_provider_1.ExternalChatSessionBackendService).toDynamicValue(ctx => {
+        const connection = ctx.container.get(service_connection_provider_1.RemoteConnectionProvider);
+        const provider = ctx.container.get(external_chat_session_provider_1.ExternalChatSessionProvider);
+        // expose only the provider interface over RPC: handing out the implementation itself
+        // would make all of its methods, including the internal ones, remotely callable
+        const exposed = {
+            getWorkspace: () => provider.getWorkspace(),
+            getSessions: () => provider.getSessions(),
+            getSessionSummary: sessionId => provider.getSessionSummary(sessionId),
+            getSession: sessionId => provider.getSession(sessionId),
+            openSession: sessionId => provider.openSession(sessionId),
+            restoreSession: sessionId => provider.restoreSession(sessionId),
+            sendPrompt: (sessionId, prompt) => provider.sendPrompt(sessionId, prompt),
+            createSession: request => provider.createSession(request)
+        };
+        return connection.createProxy(external_chat_session_provider_1.EXTERNAL_CHAT_SESSION_PROVIDER_PATH, exposed);
+    }).inSingletonScope();
+    bind(ai_external_api_frontend_contribution_1.AIExternalApiFrontendContribution).toSelf().inSingletonScope();
+    bind(browser_1.FrontendApplicationContribution).toService(ai_external_api_frontend_contribution_1.AIExternalApiFrontendContribution);
+});
+//# sourceMappingURL=ai-external-api-frontend-module.js.map

package/lib/browser/ai-external-api-frontend-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-frontend-module.js","sourceRoot":"","sources":["../../src/browser/ai-external-api-frontend-module.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAEhF,qDAA0E;AAC1E,+GAAoI;AACpI,4DAA+D;AAC/D,6FAA+J;AAC/J,mGAA4F;AAC5F,uGAAgG;AAEhG,kBAAe,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IACtC,IAAI,CAAC,6EAAmC,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACtE,IAAI,CAAC,4DAA2B,CAAC,CAAC,SAAS,CAAC,6EAAmC,CAAC,CAAC;IAEjF,IAAI,CAAC,kEAAiC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;QACzD,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAA4B,sDAAwB,CAAC,CAAC;QAC1F,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAA8B,4DAA2B,CAAC,CAAC;QAC7F,qFAAqF;QACrF,gFAAgF;QAChF,MAAM,OAAO,GAAgC;YACzC,YAAY,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE;YAC3C,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE;YACzC,iBAAiB,EAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACrE,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;YACvD,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC;YACzD,cAAc,EAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC;YAC/D,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;YACzE,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC;SAC5D,CAAC;QACF,OAAO,UAAU,CAAC,WAAW,CAAoC,oEAAmC,EAAE,OAAO,CAAC,CAAC;IACnH,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEtB,IAAI,CAAC,yEAAiC,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACpE,IAAI,CAAC,yCAA+B,CAAC,CAAC,SAAS,CAAC,yEAAiC,CAAC,CAAC;AACvF,CAAC,CAAC,CAAC"}

package/lib/browser/frontend-external-chat-session-provider.d.ts

@@ -0,0 +1,63 @@
+import { ChatAgentService } from '@theia/ai-chat/lib/common/chat-agent-service';
+import { ChatService, ChatSession } from '@theia/ai-chat/lib/common/chat-service';
+import { ChatSessionMetadata } from '@theia/ai-chat/lib/common/chat-session-store';
+import { PreferenceService } from '@theia/core';
+import { ILogger } from '@theia/core/lib/common/logger';
+import { WorkspaceService } from '@theia/workspace/lib/browser';
+import { ExternalChatMessage, ExternalChatPrompt, ExternalChatPromptResult, ExternalChatSessionCreateRequest, ExternalChatSessionCreateResult, ExternalChatSessionDetail, ExternalChatSessionProvider, ExternalChatSessionSummary } from '../common/external-chat-session-provider';
+/**
+ * Answers the backend's external session queries from this frontend's {@link ChatService}.
+ *
+ * Reports sessions that are restored (live) in this frontend with their full state, and
+ * persisted sessions that have not been restored with their persisted metadata. Live sessions
+ * are attributed to the workspace this frontend has opened; persisted sessions only when
+ * sessions are persisted per workspace, as the global session store holds sessions saved
+ * from any workspace.
+ */
+export declare class FrontendExternalChatSessionProvider implements ExternalChatSessionProvider {
+    /** Number of trailing conversation lines included in a summary's preview. */
+    protected readonly previewLineCount = 5;
+    /** Maximum length of a single preview line; longer lines are truncated. */
+    protected readonly previewLineLength = 200;
+    protected readonly logger: ILogger;
+    protected readonly chatService: ChatService;
+    protected readonly agentService: ChatAgentService;
+    protected readonly workspaceService: WorkspaceService;
+    protected readonly preferenceService: PreferenceService;
+    getSessions(): Promise<ExternalChatSessionSummary[]>;
+    getSessionSummary(sessionId: string): Promise<ExternalChatSessionSummary | undefined>;
+    getSession(sessionId: string): Promise<ExternalChatSessionDetail | undefined>;
+    openSession(sessionId: string): Promise<boolean>;
+    restoreSession(sessionId: string): Promise<ExternalChatSessionDetail | undefined>;
+    sendPrompt(sessionId: string, prompt: ExternalChatPrompt): Promise<ExternalChatPromptResult | undefined>;
+    createSession(request: ExternalChatSessionCreateRequest): Promise<ExternalChatSessionCreateResult>;
+    getWorkspace(): Promise<string | undefined>;
+    protected getWorkspaceUri(): Promise<string | undefined>;
+    /**
+     * Returns the workspace to attribute persisted sessions to: this frontend's workspace when
+     * sessions are persisted per workspace, and `undefined` when they are persisted globally,
+     * as the global session store holds sessions saved from any workspace.
+     */
+    protected getPersistedSessionsWorkspace(workspace: string | undefined): Promise<string | undefined>;
+    /** Returns the metadata of all persisted sessions, or an empty list if reading the persisted index fails. */
+    protected getPersistedMetadata(): Promise<ChatSessionMetadata[]>;
+    protected toDetail(session: ChatSession, workspace: string | undefined): ExternalChatSessionDetail;
+    protected toSummary(session: ChatSession, workspace: string | undefined): ExternalChatSessionSummary;
+    /** Reduces the metadata of a persisted session that is not restored to a summary. */
+    protected toPersistedSummary(metadata: ChatSessionMetadata, workspace: string | undefined): ExternalChatSessionSummary;
+    /**
+     * Reduces the session's conversation to plain-text messages, similar to the message history
+     * sent to the language model for the next request. In-progress responses are included with
+     * their content so far.
+     */
+    protected toMessages(session: ChatSession): ExternalChatMessage[];
+    /**
+     * Returns the last few non-empty lines of the conversation, or `undefined` for an empty
+     * conversation. Walks the conversation from the end so that only as many entries as the
+     * preview needs are rendered, however long the conversation is.
+     */
+    protected toPreview(session: ChatSession): string | undefined;
+    /** Splits an entry into its non-empty, truncated preview lines. */
+    protected toPreviewLines(text: string | undefined): string[];
+}
+//# sourceMappingURL=frontend-external-chat-session-provider.d.ts.map

package/lib/browser/frontend-external-chat-session-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-external-chat-session-provider.d.ts","sourceRoot":"","sources":["../../src/browser/frontend-external-chat-session-provider.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAGhF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAoB,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACH,mBAAmB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,+BAA+B,EACpI,yBAAyB,EAAE,2BAA2B,EAAE,0BAA0B,EACrF,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;GAQG;AACH,qBACa,mCAAoC,YAAW,2BAA2B;IAEnF,6EAA6E;IAC7E,SAAS,CAAC,QAAQ,CAAC,gBAAgB,KAAK;IACxC,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,CAAC,iBAAiB,OAAO;IAG3C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAGnC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAG5C,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAGlD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAGtD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAElD,WAAW,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAWpD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC;IAUrF,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAU7E,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAQjF,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAwBxG,aAAa,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,+BAA+B,CAAC;IA4BlG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;cAIjC,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK9D;;;;OAIG;cACa,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAMzG,6GAA6G;cAC7F,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAStE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,yBAAyB;IAOlG,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,0BAA0B;IAgBpG,qFAAqF;IACrF,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,0BAA0B;IAetH;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,mBAAmB,EAAE;IAcjE;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS;IAa7D,mEAAmE;IACnE,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE;CAM/D"}