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

package/lib/common/external-chat-session-provider.d.ts

@@ -0,0 +1,213 @@
+import { ChatSessionStatus } from '@theia/ai-chat/lib/common/chat-model';
+import { IJSONSchema } from '@theia/core/lib/common/json-schema';
+import { RestBodySchema } from '@theia/external-api/lib/common/rest-body-schema';
+/** Base path of the external AI session HTTP API. */
+export declare const AI_SESSIONS_API_PATH = "/api/ai/sessions";
+/** RPC path on which each frontend registers its {@link ExternalChatSessionProvider} with the backend. */
+export declare const EXTERNAL_CHAT_SESSION_PROVIDER_PATH = "/services/ai-external-api/session-provider";
+/**
+ * Chat session summary as exposed by the external session list endpoint.
+ */
+export interface ExternalChatSessionSummary {
+    id: string;
+    title?: string;
+    status: ChatSessionStatus;
+    /** Timestamp in milliseconds since epoch of the last interaction with the session. */
+    lastInteraction?: number;
+    /**
+     * URI of the workspace the session belongs to, or `undefined` if its frontend has no open
+     * workspace. Also `undefined` for not-restored sessions when sessions are persisted
+     * globally, as the global session store holds sessions saved from any workspace.
+     */
+    workspace?: string;
+    /** The last few lines of the conversation as plain text, or `undefined` for an empty conversation. */
+    preview?: string;
+    /** ID of the agent driving the session, or `undefined` if no agent is pinned to the session. */
+    agentId?: string;
+    /** Human-readable name of the agent driving the session, or `undefined` if no agent is pinned or the agent is not registered. */
+    agentName?: string;
+    /**
+     * ID of the session that delegated this one, or `undefined` for a top-level session.
+     * Delegated sessions are listed alongside top-level ones; use this to group them.
+     */
+    parentSessionId?: string;
+    /** ID of the topmost session of the delegation chain, or `undefined` for a top-level session. */
+    rootSessionId?: string;
+    /**
+     * Whether the session is restored (live) in a connected frontend. Sessions that are only
+     * persisted report metadata only: their status is reduced to `idle` or `failed` and they
+     * carry neither a preview nor messages until they are restored.
+     */
+    restored: boolean;
+}
+export declare namespace ExternalChatSessionSummary {
+    /** JSON Schema of {@link ExternalChatSessionSummary}, published in the OpenAPI document. */
+    const SCHEMA: IJSONSchema;
+}
+/**
+ * A single entry of the simplified conversation exposed by the external session detail endpoint.
+ *
+ * The conversation is reduced to plain text, similar to the message history sent to the language
+ * model for the next request: tool calls, thinking, and errors are rendered as text, while
+ * internal details such as content ids, branches, or serialization metadata are not exposed.
+ */
+export interface ExternalChatMessage {
+    /** Author of the entry. */
+    actor: 'user' | 'ai';
+    /** Plain-text representation of the entry. */
+    text: string;
+}
+export declare namespace ExternalChatMessage {
+    /** JSON Schema of {@link ExternalChatMessage}, published in the OpenAPI document. */
+    const SCHEMA: IJSONSchema;
+}
+/**
+ * Chat session detail as exposed by the external session detail endpoint.
+ */
+export interface ExternalChatSessionDetail extends ExternalChatSessionSummary {
+    /**
+     * The session's conversation reduced to plain-text messages, oldest first.
+     * Absent when the session is not restored (see {@link ExternalChatSessionSummary.restored}).
+     */
+    messages?: ExternalChatMessage[];
+}
+export declare namespace ExternalChatSessionDetail {
+    /** JSON Schema of {@link ExternalChatSessionDetail}, published in the OpenAPI document. */
+    const SCHEMA: IJSONSchema;
+}
+/**
+ * Prompt sent to an existing session through the external API.
+ */
+export interface ExternalChatPrompt {
+    /** The prompt text, including optional `@agent` mentions and variable references. */
+    text: string;
+    /**
+     * Cancel an in-progress request (including pending tool calls) before sending.
+     * Without this flag, prompting a session whose status is in progress is rejected as busy.
+     */
+    interrupt?: boolean;
+}
+export declare namespace ExternalChatPrompt {
+    /** JSON Schema of {@link ExternalChatPrompt}; bodies of the prompt endpoint are validated against it. */
+    const SCHEMA: RestBodySchema<ExternalChatPrompt>;
+}
+/**
+ * Result of sending a prompt: the created request, or the reason the prompt was rejected.
+ *
+ * `busy` means a request was in progress and `interrupt` was not set; `noAgent` means no
+ * agent was available to handle the prompt (none mentioned, none pinned, no default configured).
+ */
+export type ExternalChatPromptResult = {
+    sent: {
+        sessionId: string;
+        requestId: string;
+    };
+} | {
+    failure: 'busy' | 'noAgent';
+};
+/**
+ * Session creation request as accepted by the external session creation endpoint.
+ */
+export interface ExternalChatSessionCreateRequest {
+    /**
+     * URI of the workspace in which to create the session. The session is created in a
+     * frontend that has this workspace open. May be omitted when all connected frontends
+     * share the same workspace.
+     */
+    workspace?: string;
+    /** ID of the agent to pin to the session. When omitted, the default agent handles prompts. */
+    agentId?: string;
+    /** Initial prompt to send right after creation. */
+    prompt?: string;
+    /**
+     * Raise the chat view in the IDE. Note that the created session becomes the active
+     * session of its frontend in any case.
+     */
+    focus?: boolean;
+}
+export declare namespace ExternalChatSessionCreateRequest {
+    /** JSON Schema of {@link ExternalChatSessionCreateRequest}; bodies of the creation endpoint are validated against it. */
+    const SCHEMA: RestBodySchema<ExternalChatSessionCreateRequest>;
+}
+/**
+ * Result of a session creation: the created session, or the reason creation was rejected.
+ *
+ * `unknownAgent` means the requested agent id is not registered. `noAgent` means the initial
+ * prompt could not be handled because no agent was available (the session is not kept in that
+ * case). `noFrontend` means no connected frontend is available to create the session.
+ * `workspaceNotFound` means no connected frontend matches the requested workspace.
+ * `ambiguousWorkspace` means no workspace was given and the connected frontends have
+ * different workspaces open.
+ */
+export type ExternalChatSessionCreateResult = {
+    created: {
+        session: ExternalChatSessionSummary;
+        requestId?: string;
+    };
+} | {
+    failure: 'unknownAgent' | 'noAgent' | 'noFrontend' | 'workspaceNotFound' | 'ambiguousWorkspace';
+};
+export declare const ExternalChatSessionProvider: unique symbol;
+/**
+ * Provides chat session information and session actions for the external API.
+ *
+ * Implemented by each frontend and registered with the backend over RPC. The backend
+ * queries the registered providers on demand when external clients call the HTTP API.
+ */
+export interface ExternalChatSessionProvider {
+    /** Returns the URI of the workspace this frontend has opened, or `undefined` if none. */
+    getWorkspace(): Promise<string | undefined>;
+    /**
+     * Returns summaries of all sessions known to this frontend: sessions restored in memory
+     * as well as persisted sessions that have not been restored (reported with their
+     * persisted metadata and `restored: false`).
+     */
+    getSessions(): Promise<ExternalChatSessionSummary[]>;
+    /**
+     * Returns the summary of the given session, or `undefined` if the session is unknown to this
+     * frontend. Used to pick the frontend a session action is routed to, so it must stay cheap:
+     * unlike {@link getSession} it does not carry the conversation.
+     */
+    getSessionSummary(sessionId: string): Promise<ExternalChatSessionSummary | undefined>;
+    /**
+     * Returns the detail of the given session, or `undefined` if the session is unknown to this
+     * frontend. For persisted sessions that are not restored, the detail carries no messages.
+     */
+    getSession(sessionId: string): Promise<ExternalChatSessionDetail | undefined>;
+    /**
+     * Restores the given session if necessary and shows it in this frontend's chat view.
+     * Returns `false` if the session is unknown to this frontend.
+     */
+    openSession(sessionId: string): Promise<boolean>;
+    /**
+     * Restores the given session in this frontend without focusing it. Returns the detail of
+     * the restored session, or `undefined` if the session is unknown to this frontend.
+     */
+    restoreSession(sessionId: string): Promise<ExternalChatSessionDetail | undefined>;
+    /**
+     * Sends a prompt to the given session, restoring it first if necessary. Returns `undefined`
+     * if the session is unknown to this frontend.
+     */
+    sendPrompt(sessionId: string, prompt: ExternalChatPrompt): Promise<ExternalChatPromptResult | undefined>;
+    /**
+     * Creates a new session in this frontend and sends the initial prompt, if one is given.
+     * The created session becomes the frontend's active session. The request's `workspace` is
+     * ignored; routing to a matching frontend is the backend's responsibility.
+     */
+    createSession(request: ExternalChatSessionCreateRequest): Promise<ExternalChatSessionCreateResult>;
+}
+export declare const ExternalChatSessionBackendService: unique symbol;
+/**
+ * Backend side of the {@link ExternalChatSessionProvider} connection.
+ *
+ * Invoked by each frontend to inform the backend about session changes so that the backend
+ * can push updates to external event stream clients.
+ */
+export interface ExternalChatSessionBackendService {
+    /**
+     * Notifies the backend that the sessions of the calling frontend changed in a way visible
+     * to the external API (session created/deleted/renamed or session status changed).
+     */
+    notifySessionsChanged(): void;
+}
+//# sourceMappingURL=external-chat-session-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"external-chat-session-provider.d.ts","sourceRoot":"","sources":["../../src/common/external-chat-session-provider.ts"],"names":[],"mappings":"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"}

package/lib/common/external-chat-session-provider.js

@@ -0,0 +1,147 @@
+"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.ExternalChatSessionBackendService = exports.ExternalChatSessionProvider = exports.ExternalChatSessionCreateRequest = exports.ExternalChatPrompt = exports.ExternalChatSessionDetail = exports.ExternalChatMessage = exports.ExternalChatSessionSummary = exports.EXTERNAL_CHAT_SESSION_PROVIDER_PATH = exports.AI_SESSIONS_API_PATH = void 0;
+const chat_model_1 = require("@theia/ai-chat/lib/common/chat-model");
+/** Base path of the external AI session HTTP API. */
+exports.AI_SESSIONS_API_PATH = '/api/ai/sessions';
+/** RPC path on which each frontend registers its {@link ExternalChatSessionProvider} with the backend. */
+exports.EXTERNAL_CHAT_SESSION_PROVIDER_PATH = '/services/ai-external-api/session-provider';
+var ExternalChatSessionSummary;
+(function (ExternalChatSessionSummary) {
+    /** JSON Schema of {@link ExternalChatSessionSummary}, published in the OpenAPI document. */
+    ExternalChatSessionSummary.SCHEMA = {
+        type: 'object',
+        required: ['id', 'status', 'restored'],
+        properties: {
+            id: { type: 'string', description: 'Unique session id.' },
+            title: { type: 'string', description: 'Session title, if one has been set or generated.' },
+            status: {
+                type: 'string',
+                enum: [...chat_model_1.ChatSessionStatus.VALUES],
+                description: 'Aggregated session status, derived from the state of the last request. '
+                    + "'awaitingApproval' and 'awaitingInput' mean the session is blocked on the user."
+            },
+            lastInteraction: { type: 'number', description: 'Timestamp in milliseconds since epoch of the last interaction with the session.' },
+            workspace: {
+                type: 'string',
+                description: "URI of the workspace the session belongs to; absent when the session's frontend has no open workspace "
+                    + 'and for not-restored sessions when sessions are persisted globally.'
+            },
+            preview: {
+                type: 'string',
+                description: 'The last few lines of the conversation as plain text; absent for an empty conversation and for sessions that are not restored.'
+            },
+            agentId: { type: 'string', description: 'ID of the agent driving the session; absent when no agent is pinned to the session.' },
+            agentName: { type: 'string', description: 'Human-readable name of the agent driving the session.' },
+            parentSessionId: {
+                type: 'string',
+                description: 'ID of the session that delegated this one; absent for a top-level session. '
+                    + 'Delegated sessions are listed alongside top-level ones; use this to group them.'
+            },
+            rootSessionId: {
+                type: 'string',
+                description: 'ID of the topmost session of the delegation chain; absent for a top-level session.'
+            },
+            restored: {
+                type: 'boolean',
+                description: 'Whether the session is restored in a connected frontend. Sessions that are not restored report persisted metadata only.'
+            }
+        }
+    };
+})(ExternalChatSessionSummary || (exports.ExternalChatSessionSummary = ExternalChatSessionSummary = {}));
+var ExternalChatMessage;
+(function (ExternalChatMessage) {
+    /** JSON Schema of {@link ExternalChatMessage}, published in the OpenAPI document. */
+    ExternalChatMessage.SCHEMA = {
+        type: 'object',
+        required: ['actor', 'text'],
+        properties: {
+            actor: { type: 'string', enum: ['user', 'ai'], description: 'Author of the entry.' },
+            text: { type: 'string', description: 'Plain-text representation of the entry.' }
+        }
+    };
+})(ExternalChatMessage || (exports.ExternalChatMessage = ExternalChatMessage = {}));
+var ExternalChatSessionDetail;
+(function (ExternalChatSessionDetail) {
+    /** JSON Schema of {@link ExternalChatSessionDetail}, published in the OpenAPI document. */
+    ExternalChatSessionDetail.SCHEMA = {
+        ...ExternalChatSessionSummary.SCHEMA,
+        properties: {
+            ...ExternalChatSessionSummary.SCHEMA.properties,
+            messages: {
+                type: 'array',
+                items: ExternalChatMessage.SCHEMA,
+                description: "The session's conversation reduced to plain-text messages, oldest first. Absent when the session is not restored."
+            }
+        }
+    };
+})(ExternalChatSessionDetail || (exports.ExternalChatSessionDetail = ExternalChatSessionDetail = {}));
+var ExternalChatPrompt;
+(function (ExternalChatPrompt) {
+    /** JSON Schema of {@link ExternalChatPrompt}; bodies of the prompt endpoint are validated against it. */
+    ExternalChatPrompt.SCHEMA = {
+        type: 'object',
+        required: ['text'],
+        additionalProperties: false,
+        properties: {
+            text: {
+                type: 'string',
+                pattern: '\\S',
+                description: 'The prompt text, including optional `@agent` mentions and variable references. Must not be blank.'
+            },
+            interrupt: {
+                type: 'boolean',
+                description: 'Cancel an in-progress request (including pending tool calls) before sending. '
+                    + 'Without this flag, prompting a session whose status is in progress is rejected as busy.'
+            }
+        }
+    };
+})(ExternalChatPrompt || (exports.ExternalChatPrompt = ExternalChatPrompt = {}));
+var ExternalChatSessionCreateRequest;
+(function (ExternalChatSessionCreateRequest) {
+    /** JSON Schema of {@link ExternalChatSessionCreateRequest}; bodies of the creation endpoint are validated against it. */
+    ExternalChatSessionCreateRequest.SCHEMA = {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            workspace: {
+                type: 'string',
+                pattern: '\\S',
+                description: 'URI of the workspace in which to create the session. The session is created in a frontend that has this workspace open. '
+                    + 'May be omitted when all connected frontends share the same workspace.'
+            },
+            agentId: {
+                type: 'string',
+                pattern: '\\S',
+                description: 'ID of the agent to pin to the session. When omitted, the default agent handles prompts.'
+            },
+            prompt: {
+                type: 'string',
+                pattern: '\\S',
+                description: 'Initial prompt to send right after creation. Must not be blank when given.'
+            },
+            focus: {
+                type: 'boolean',
+                description: 'Raise the chat view in the IDE. The created session becomes the active session of its frontend in any case.'
+            }
+        }
+    };
+})(ExternalChatSessionCreateRequest || (exports.ExternalChatSessionCreateRequest = ExternalChatSessionCreateRequest = {}));
+exports.ExternalChatSessionProvider = Symbol('ExternalChatSessionProvider');
+exports.ExternalChatSessionBackendService = Symbol('ExternalChatSessionBackendService');
+//# sourceMappingURL=external-chat-session-provider.js.map

package/lib/common/external-chat-session-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-chat-session-provider.js","sourceRoot":"","sources":["../../src/common/external-chat-session-provider.ts"],"names":[],"mappings":"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"}

package/lib/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './external-chat-session-provider';
+//# sourceMappingURL=index.d.ts.map

package/lib/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAgBA,cAAc,kCAAkC,CAAC"}

package/lib/common/index.js

@@ -0,0 +1,20 @@
+"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 tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./external-chat-session-provider"), exports);
+//# sourceMappingURL=index.js.map

package/lib/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.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,2EAAiD"}

package/lib/node/ai-external-api-backend-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-backend-module.d.ts.map

package/lib/node/ai-external-api-backend-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-backend-module.d.ts","sourceRoot":"","sources":["../../src/node/ai-external-api-backend-module.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;;AAM/D,wBAiBG"}

package/lib/node/ai-external-api-backend-module.js

@@ -0,0 +1,38 @@
+"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 core_1 = require("@theia/core");
+const inversify_1 = require("@theia/core/shared/inversify");
+const external_api_contribution_1 = require("@theia/external-api/lib/node/external-api-contribution");
+const external_chat_session_provider_1 = require("../common/external-chat-session-provider");
+const ai_external_api_endpoint_1 = require("./ai-external-api-endpoint");
+const external_chat_session_registry_1 = require("./external-chat-session-registry");
+exports.default = new inversify_1.ContainerModule(bind => {
+    bind(external_chat_session_registry_1.ExternalChatSessionRegistry).toSelf().inSingletonScope();
+    bind(ai_external_api_endpoint_1.AIExternalApiEndpoint).toSelf().inSingletonScope();
+    bind(external_api_contribution_1.ExternalApiContribution).toService(ai_external_api_endpoint_1.AIExternalApiEndpoint);
+    bind(core_1.ConnectionHandler).toDynamicValue(ctx => new core_1.RpcConnectionHandler(external_chat_session_provider_1.EXTERNAL_CHAT_SESSION_PROVIDER_PATH, provider => {
+        const registry = ctx.container.get(external_chat_session_registry_1.ExternalChatSessionRegistry);
+        registry.addProvider(provider);
+        provider.onDidCloseConnection(() => registry.removeProvider(provider));
+        const backendService = {
+            notifySessionsChanged: () => registry.notifySessionsChanged()
+        };
+        return backendService;
+    })).inSingletonScope();
+});
+//# sourceMappingURL=ai-external-api-backend-module.js.map

package/lib/node/ai-external-api-backend-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-backend-module.js","sourceRoot":"","sources":["../../src/node/ai-external-api-backend-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,sCAAsE;AACtE,4DAA+D;AAC/D,sGAAiG;AACjG,6FAA+J;AAC/J,yEAAmE;AACnE,qFAA+E;AAE/E,kBAAe,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IACtC,IAAI,CAAC,4DAA2B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAE9D,IAAI,CAAC,gDAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxD,IAAI,CAAC,mDAAuB,CAAC,CAAC,SAAS,CAAC,gDAAqB,CAAC,CAAC;IAE/D,IAAI,CAAC,wBAAiB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CACzC,IAAI,2BAAoB,CAA8B,oEAAmC,EAAE,QAAQ,CAAC,EAAE;QAClG,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,4DAA2B,CAAC,CAAC;QAChE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC/B,QAAQ,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvE,MAAM,cAAc,GAAsC;YACtD,qBAAqB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,qBAAqB,EAAE;SAChE,CAAC;QACF,OAAO,cAAc,CAAC;IAC1B,CAAC,CAAC,CACL,CAAC,gBAAgB,EAAE,CAAC;AACzB,CAAC,CAAC,CAAC"}

package/lib/node/ai-external-api-endpoint.d.ts

@@ -0,0 +1,31 @@
+import { ExternalApiContribution, ExternalApiContributionDocumentation } from '@theia/external-api/lib/node/external-api-contribution';
+import { ExternalApiRouter } from '@theia/external-api/lib/node/external-api-router';
+import { RestResult } from '@theia/external-api/lib/node/rest-result';
+import { ExternalChatPrompt, ExternalChatSessionCreateRequest } from '../common/external-chat-session-provider';
+import { ExternalChatSessionRegistry } from './external-chat-session-registry';
+/**
+ * Contributes the AI session API to the external API server:
+ * - `GET /api/ai/sessions` lists all sessions (restored and persisted) with id, title, status,
+ *   agent, workspace, last interaction time, and a short plain-text preview of the conversation.
+ * - `POST /api/ai/sessions` creates a session in a frontend matching the requested workspace,
+ *   optionally pinning an agent and sending an initial prompt.
+ * - `GET /api/ai/sessions/events` streams the session list as server-sent events, pushing an
+ *   updated list whenever sessions change.
+ * - `GET /api/ai/sessions/:id` returns a single session including its conversation reduced to
+ *   plain-text messages (persisted sessions report metadata only until restored).
+ * - `POST /api/ai/sessions/:id/open` shows the session in the chat view of a connected frontend.
+ * - `POST /api/ai/sessions/:id/restore` restores a persisted session and returns its detail.
+ * - `POST /api/ai/sessions/:id/prompt` sends a prompt to the session.
+ *
+ * The endpoints are served on the external API port and are token-protected when an
+ * external API token is configured (see `@theia/external-api`).
+ */
+export declare class AIExternalApiEndpoint implements ExternalApiContribution {
+    readonly path = "/api/ai/sessions";
+    readonly documentation: ExternalApiContributionDocumentation;
+    protected readonly registry: ExternalChatSessionRegistry;
+    configure(router: ExternalApiRouter): void;
+    protected createSession(request: ExternalChatSessionCreateRequest): Promise<RestResult>;
+    protected sendPrompt(sessionId: string, prompt: ExternalChatPrompt): Promise<RestResult>;
+}
+//# sourceMappingURL=ai-external-api-endpoint.d.ts.map

package/lib/node/ai-external-api-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-external-api-endpoint.d.ts","sourceRoot":"","sources":["../../src/node/ai-external-api-endpoint.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,uBAAuB,EAAE,oCAAoC,EAAE,MAAM,wDAAwD,CAAC;AACvI,OAAO,EAAE,iBAAiB,EAA0B,MAAM,kDAAkD,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AACtE,OAAO,EACmB,kBAAkB,EAAE,gCAAgC,EAC7E,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AA8B/E;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,qBAAsB,YAAW,uBAAuB;IAEjE,QAAQ,CAAC,IAAI,sBAAwB;IAErC,QAAQ,CAAC,aAAa,EAAE,oCAAoC,CAG1D;IAGF,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAEzD,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;cAiF1B,aAAa,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,UAAU,CAAC;cAmB7E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAUjG"}