@ckeditor/ckeditor5-ai 48.1.0-alpha.4 → 48.1.0-alpha.6

package/dist/aichat/aichatcontroller.d.ts

@@ -162,7 +162,7 @@ export declare class AIChatController extends ContextPlugin {
      * Returns the ID under which conversations are grouped. All created conversations will have this `groupId` set. Conversation history
      * will fetch conversations with such `groupId`.
      *
-     * By default, this is equal to the document ID passed in editor configuration.
+     * This is equal to the channelId passed in context/editor configuration.
      */
     getGroupId(): string;
     /**

package/dist/aichat/model/aichatcontext.d.ts

@@ -8,7 +8,6 @@
  */
 import { type Editor } from '@ckeditor/ckeditor5-core';
 import { type AIConnector, type AIUserMessage } from '../../aicore/aiconnector.js';
-import { type AIEditingDocumentData } from '../../aicore/aiediting.js';
 import { type AIContextItemType, type AIContextTextResourceType, type AIContextItem, type AIContextItemRequestData, type AIDocumentContextSlice, type AIToolContextItem } from '../../aicore/model/aicontext.js';
 export declare const AI_CONTEXT_MODEL_EVENT_NAMES: readonly ["contextItemAdded", "contextItemRemoved", "contextItemLoadingEnded", "contextSent", "error", "addContextOptionsChanged", "sourceResourcesLoaded", "resourceStateChanged", "uploadProgressChanged"];
 declare const AIChatContext_base: {
@@ -34,14 +33,6 @@ export declare class AIChatContext extends /* #__PURE__ */ AIChatContext_base {
      * without the standard deprecation policy. Check the changelog for migration guidance.
      */
     init(): void;
-    /**
-     * Returns the editor / root / content that a document with the given id was uploaded from, or `undefined` if no such mapping exists
-     * (e.g. single-document upload path, or the id is unknown).
-     *
-     * @experimental **Experimental:** This is a production-ready API but may change in minor releases
-     * without the standard deprecation policy. Check the changelog for migration guidance.
-     */
-    getDocumentSource(documentId: string | undefined): AIChatContextDocumentSource | undefined;
     /**
      * Returns the source (editor / root / content / documentId) that a `data-id` in an AI response belongs to.
      *
@@ -55,15 +46,8 @@ export declare class AIChatContext extends /* #__PURE__ */ AIChatContext_base {
     }) | undefined;
     /**
      * Returns an `AIDocumentContextSlice` describing the position and bounds of a single uploaded document inside the concatenated
-     * reply context. Used by the apply/insert pipeline to diff and commit AI operations against the correct editor root.
-     *
-     * @experimental **Experimental:** This is a production-ready API but may change in minor releases
-     * without the standard deprecation policy. Check the changelog for migration guidance.
-     */
-    getDocumentContextSlice(documentId: string | undefined): AIDocumentContextSlice | undefined;
-    /**
-     * Same as {@link #getDocumentContextSlice} but resolved via a `data-id` that appears in the uploaded documents. A convenience
-     * for AI response handling where the server returns `data-id` references rather than our internal document ids.
+     * reply context, resolved via a `data-id` that appears in the uploaded documents. A convenience for AI response handling where
+     * the server returns `data-id` references rather than internal document ids.
      *
      * @experimental **Experimental:** This is a production-ready API but may change in minor releases
      * without the standard deprecation policy. Check the changelog for migration guidance.
@@ -85,27 +69,6 @@ export declare class AIChatContext extends /* #__PURE__ */ AIChatContext_base {
      * without the standard deprecation policy. Check the changelog for migration guidance.
      */
     populateFromMessage(content: AIUserMessage['content'][0]): Promise<AIContextItem>;
-    /**
-     * Batch-loads document content items from a historical user message, matches each to a live editor root by
-     * {@link module:core/editor/editorconfig~RootConfig#label `label`} and
-     * {@link module:core/editor/editorconfig~RootConfig#description `description`}, and populates the internal
-     * document-source maps so historical replies can route modifications to the correct root.
-     *
-     * Returns the assembled `current-document` context item together with a `hasUnmatched` flag that the caller
-     * should propagate to reply `areActionsDisabled` so suggestions from documents whose source root cannot be found
-     * are shown with a "from previous session" note.
-     *
-     * For single-document messages this method delegates to the single-fetch path ({@link #populateFromMessage})
-     * and assumes the conversation relates to the first editor / first non-graveyard root — `name` and
-     * `description` are not required in the single-document case.
-     *
-     * @experimental **Experimental:** This is a production-ready API but may change in minor releases
-     * without the standard deprecation policy. Check the changelog for migration guidance.
-     */
-    populateDocumentsFromUserMessage(messageContents: AIUserMessage['content'], editors: ReadonlyArray<Editor>): Promise<{
-        contextItem?: AIContextItem;
-        hasUnmatched: boolean;
-    }>;
     /**
      * Creates a context item from conversation content.
      */
@@ -206,25 +169,11 @@ export declare class AIChatContext extends /* #__PURE__ */ AIChatContext_base {
      * @param version Version number of the document for change tracking
      * @returns Promise that resolves when the document is updated
      */
-    updateCurrentDocument(content: string | undefined, version: number, sessionId: string | null, selections: Array<{
+    updateCurrentDocument(content: string | undefined, version: number, sessionId: string | null, channelId: string, rootName: string, selections: Array<{
         start: number;
         end: number;
         htmlFragment: string;
     }>): Promise<void>;
-    /**
-     * Updates the current document in the pending context using multiple per-root documents.
-     * This is the multi-root / multi-instance counterpart of
-     * {@link module:ai/aichat/model/aichatcontext~AIChatContext#updateCurrentDocument `updateCurrentDocument()`}: it uploads the documents
-     * in a single batch request and writes the returned ids (plus content, version, sessionId and selection) into the pending
-     * `current-document` context item's `documents` array. The id → `{ editor, rootName, content }` mapping is also stashed internally
-     * so downstream consumers can resolve a `documentId` from a streamed AI response back to the source editor and root.
-     *
-     * @experimental **Experimental:** This is a production-ready API but may change in minor releases
-     * without the standard deprecation policy. Check the changelog for migration guidance.
-     * @param documents Per-root document data to upload.
-     * @returns Promise that resolves when the documents are updated.
-     */
-    updateDocuments(documents: Array<AIEditingDocumentData>): Promise<void>;
     /**
      * @experimental **Experimental:** This is a production-ready API but may change in minor releases
      * without the standard deprecation policy. Check the changelog for migration guidance.
@@ -312,13 +261,13 @@ export type AIChatContextDocumentSource = {
     content: string;
     version: number;
     /**
-     * The `label` of the source editor root at upload time; used to match historical documents back to a live root when loading a
-     * conversation from history.
+     * The document's stored `name` — the source root's identifier as reported when the document was uploaded.
      */
     name?: string;
     /**
-     * The `description` of the source editor root at upload time; used alongside {@link #name} to disambiguate roots that share
-     * the same label.
+     * The document's stored `description`, taken from the source root's
+     * {@link module:core/editor/editorconfig~RootConfig root configuration}. The AI service uses descriptions to
+     * semantically distinguish roots when a user scopes a request to a specific area (e.g. "edit the title").
      */
     description?: string;
 };

package/dist/aichat/model/aichatconversation.d.ts

@@ -7,9 +7,8 @@
  */
 import { CKEditorError, type Locale } from '@ckeditor/ckeditor5-utils';
 import type { AIConnector, AIModelData } from '../../aicore/aiconnector.js';
-import { AIChatContext, type AIChatContextConfig, type AIChatContextDocumentSource, type AIContextProvider, type AIContextResource, type AIContextResourceState } from './aichatcontext.js';
-import { type AIEditingDocumentData } from '../../aicore/aiediting.js';
-import { type AIToolContextItem, type AIContextItem, type AIDocumentContextSlice } from '../../aicore/model/aicontext.js';
+import { AIChatContext, type AIChatContextConfig, type AIContextProvider, type AIContextResource, type AIContextResourceState } from './aichatcontext.js';
+import { type AIToolContextItem, type AIContextItem } from '../../aicore/model/aicontext.js';
 import { AICapabilities, type AICapabilitiesConfig } from '../../aicore/model/aicapabilities.js';
 import type { AIModels } from '../../aicore/model/aimodels.js';
 import { type Editor } from '@ckeditor/ckeditor5-core';
@@ -124,33 +123,20 @@ export declare class AIChatConversation extends /* #__PURE__ */ AIChatConversati
      */
     addCurrentDocumentToContext(label: string): void;
     /**
-     * Updates the current document in the context to contain the provided content and version.
+     * Updates the current document in the context to contain the necessary data.
      */
-    updateCurrentDocumentInContext({ content, version, sessionId, selections }: {
+    updateCurrentDocumentInContext({ content, version, sessionId, channelId, rootName, selections }: {
         content: string | undefined;
         version: number;
         sessionId: string | null;
+        channelId: string;
+        rootName: string;
         selections: Array<{
             start: number;
             end: number;
             htmlFragment: string;
         }>;
     }): Promise<void>;
-    /**
-     * Updates the documents in the context to contain the provided content and version.
-     */
-    updateDocumentsInContext(documents: Array<AIEditingDocumentData>): Promise<void>;
-    /**
-     * Returns the source (editor / root / content / documentId) that a `data-id` in an AI response belongs to.
-     */
-    getSourceByDataId(dataId: string | undefined): (AIChatContextDocumentSource & {
-        documentId: string;
-    }) | undefined;
-    /**
-     * Returns the `AIDocumentContextSlice` describing a single uploaded document — used by the apply/insert pipeline to diff against
-     * and commit operations to the correct editor root.
-     */
-    getDocumentContextSliceByDataId(dataId: string | undefined): AIDocumentContextSlice | undefined;
     /**
      * Returns the content of the current interaction's document.
      */

package/dist/aicore/aiconnector.d.ts

@@ -244,6 +244,8 @@ export type AIFetchDocumentReply = {
     attributes?: {
         version: number;
         sessionId: string | null;
+        channelId?: string;
+        rootName?: string;
     };
     name?: string;
     description?: string;
@@ -252,6 +254,8 @@ export type AIUploadDocumentData = {
     content: string | undefined;
     version: number;
     sessionId: string | null;
+    channelId: string;
+    rootName: string;
     selections: Array<{
         start: number;
         end: number;

package/dist/aicore/aiediting.d.ts

@@ -33,7 +33,7 @@ export declare class AIEditing extends ContextPlugin {
     /**
      * Returns the data and version of each document (one entry per editor root, excluding `$graveyard`).
      *
-     * `editor` and `rootName` identify the source of each entry so callers can remap AI modifications back to the editor and root
+     * `rootName` and `channelId` identify the source of each entry so callers can remap AI modifications back to the editor and root
      * they came from.
      */
     getDocumentData(): Promise<Array<AIEditingDocumentData>>;
@@ -65,6 +65,7 @@ export type AIEditingDocumentData = {
     content: string;
     version: number;
     sessionId: string;
+    channelId: string;
     selections: Array<{
         markerName: string;
         start: number;