@ckeditor/ckeditor5-ai 48.0.1 → 48.1.0-alpha.1

package/ckeditor5-metadata.json

@@ -38,7 +38,7 @@
 			"className": "AITranslate",
 			"description": "Introduces AI-powered content translations with translated content preview, suggestions, and configurable list of languages",
 			"docs": "features/ai/ckeditor-ai-overview.html",
-			"path": "src/aitranslate/aitranslate.js"
+			"path": "src/aitranslate/aitranslate.ts"
 		},
 		{
 			"name": "AI Quick Actions",

package/dist/aiballoon/aiballoon.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module ai/aiballoon/aiballoon
  */
-import { ContextPlugin } from '@ckeditor/ckeditor5-core';
+import { ContextPlugin, type Editor } from '@ckeditor/ckeditor5-core';
 import { AIEditing } from '../aicore/aiediting.js';
 import '../../theme/aiballoon/aiballoon.css';
 import { type ModelRange } from '@ckeditor/ckeditor5-engine';
@@ -26,6 +26,13 @@ export interface AIBalloonConfig {
     mainView: AIBalloonView;
     ranges: Array<ModelRange>;
     class: string;
+    /**
+     * The editor the balloon should anchor to. When provided (multi-root / multi-instance setups), it takes precedence over the
+     * focus-based heuristic used by {@link module:ai/aicore/utils/geteditorfromcontext~getEditorFromContext} — otherwise clicking a
+     * chat-sidebar suggestion chip routes the balloon to whichever editor happens to be focused, which collapses dialog positioning
+     * when the chip's target range lives on a different editor or root.
+     */
+    targetEditor?: Editor;
 }
 /**
  * The AI Balloon plugin provides a balloon dialog interface for displaying and interacting with AI suggestions.

package/dist/aichat/aichatcontroller.d.ts

@@ -147,8 +147,13 @@ export declare class AIChatController extends ContextPlugin {
     focusPromptInput(): void;
     /**
      * Creates a new, empty conversation.
+     *
+     * @param options Optional parameters for starting the conversation.
+     * @param options.modelId If provided, this model will be selected for the new conversation instead of the default one.
      */
-    startConversation(): Promise<void>;
+    startConversation(options?: {
+        modelId?: string;
+    }): Promise<void>;
     /**
      * Submits a user message to the currently active conversation.
      */
@@ -162,8 +167,16 @@ export declare class AIChatController extends ContextPlugin {
     getGroupId(): string;
     /**
      * Starts an AI chat conversation safely, catching and logging any errors.
+     *
+     * @param options Options for starting the conversation.
+     * @param options.id Optional conversation ID. If provided, initializes an existing conversation.
+     * If not defined, starts a new conversation with a generated ID.
+     * @param options.modelId Optional model ID to use for the conversation. If not provided, the default model is used.
      */
-    protected _startConversationSafely(id?: string): Promise<void>;
+    protected _startConversationSafely(options?: {
+        id?: string;
+        modelId?: string;
+    }): Promise<void>;
 }
 /**
  * Data for the message send by the user in the AI chat.

package/dist/aichat/aichatui.d.ts

@@ -124,8 +124,8 @@ export declare class AIChatUI extends ContextPlugin {
     updateFeedItemAIReplySuggestionContent(options: {
         id: string;
         parts: Array<AISuggestionContentPartDefinition>;
-        renderingStrategy?: AIContentRenderingStrategy;
         isDone?: boolean;
+        skipLoadingEffects?: boolean;
     }): Promise<void>;
     /**
      * Updates the state of a content part by its index.
@@ -238,7 +238,6 @@ export declare class AIChatUI extends ContextPlugin {
      * Clears the loading message of the chat feed.
      */
     clearLoadingMessage(): void;
-    setIsMaximized(isMaximized: boolean): void;
     /**
      * Populates a source resource balloon with loaded resources.
      */
@@ -256,7 +255,9 @@ export declare class AIChatUI extends ContextPlugin {
      */
     focusPromptInput(useHighlight?: boolean): void;
     scrollFeedToSuggestion(replyId: string, partIndex: number): void;
-    startAutoScroll(): void;
+    startAutoScroll(options?: {
+        smooth?: boolean;
+    }): void;
     disableControls(): void;
     enableControls(): void;
 }

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

@@ -2,8 +2,14 @@
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
+/**
+ * @module ai/aichat/model/aichatcontext
+ * @publicApi
+ */
+import { type Editor } from '@ckeditor/ckeditor5-core';
 import { type AIConnector, type AIUserMessage } from '../../aicore/aiconnector.js';
-import { type AIContextItemType, type AIContextTextResourceType, type AIContextItem, type AIContextItemRequestData, type AIToolContextItem } from '../../aicore/model/aicontext.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: {
     new (): import("@ckeditor/ckeditor5-utils").Observable;
@@ -28,6 +34,41 @@ 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.
+     *
+     * Relied on by the suggestion balloon flow when a single reply's change groups span multiple uploaded documents.
+     *
+     * @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.
+     */
+    getSourceByDataId(dataId: string | undefined): (AIChatContextDocumentSource & {
+        documentId: string;
+    }) | 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.
+     *
+     * @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.
+     */
+    getDocumentContextSliceByDataId(dataId: string | undefined): AIDocumentContextSlice | undefined;
     /**
      * Returns the pending context items that will be sent to the AI endpoint in the next interaction.
      *
@@ -44,6 +85,27 @@ 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.
      */
@@ -149,6 +211,20 @@ export declare class AIChatContext extends /* #__PURE__ */ AIChatContext_base {
         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.
@@ -224,6 +300,28 @@ export declare class AIChatContext extends /* #__PURE__ */ AIChatContext_base {
      */
     addResourceToContext(source: AIContextProvider, resource: AIContextResource): Promise<void>;
 }
+/**
+ * A uploaded-document source stored on the chat context, keyed by the id returned by the `/documents/batch` endpoint.
+ *
+ * @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.
+ */
+export type AIChatContextDocumentSource = {
+    editor: Editor;
+    rootName: string;
+    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.
+     */
+    name?: string;
+    /**
+     * The `description` of the source editor root at upload time; used alongside {@link #name} to disambiguate roots that share
+     * the same label.
+     */
+    description?: string;
+};
 export type AIChatContextItemAddedEvent = {
     name: 'contextItemAdded';
     args: [

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

@@ -5,10 +5,11 @@
 /**
  * @module ai/aichat/model/aichatconversation
  */
-import { CKEditorError } from '@ckeditor/ckeditor5-utils';
+import { CKEditorError, type Locale } from '@ckeditor/ckeditor5-utils';
 import type { AIConnector, AIModelData } from '../../aicore/aiconnector.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 { 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 { AICapabilities, type AICapabilitiesConfig } from '../../aicore/model/aicapabilities.js';
 import type { AIModels } from '../../aicore/model/aimodels.js';
 import { type Editor } from '@ckeditor/ckeditor5-core';
@@ -135,6 +136,21 @@ export declare class AIChatConversation extends /* #__PURE__ */ AIChatConversati
             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.
      */
@@ -276,6 +292,12 @@ export type AIChatConversationOptions = {
     connector: AIConnector;
     chatModels: AIModels;
     getEditor?: () => Editor;
+    getEditors?: () => Array<Editor>;
+    /**
+     * Locale forwarded to {@link module:ai/aichat/model/aichatinteraction~AIChatInteraction interactions} (and through them to
+     * replies) for translating internal user-facing strings — see {@link module:ai/aicore/model/aiinteraction~AIInteractionOptions}.
+     */
+    locale?: Locale;
     conversationId: string;
     group: string;
     selectedModelId?: string;

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

@@ -9,6 +9,7 @@
 import { type AICapabilitiesConfig } from '../../aicore/model/aicapabilities.js';
 import { AIInteraction, type AIInteractionOptions } from '../../aicore/model/aiinteraction.js';
 import { type AIContextItem } from '../../aicore/model/aicontext.js';
+import { type AIReply } from '../../aicore/model/aireply.js';
 export declare class AIChatInteraction extends AIInteraction {
     /**
      * The user message that was sent to the AI endpoint.
@@ -35,6 +36,14 @@ export declare class AIChatInteraction extends AIInteraction {
      */
     readonly attributes?: Record<string, unknown>;
     constructor(options: AIChatInteractionOptions);
+    /**
+     * @inheritDoc
+     *
+     * For multi-root / multi-instance conversations, the `documentContextContent` is the concatenation of all uploaded documents'
+     * HTML. The server can send a single modification-delta stream whose `data-id`s span several source documents, so the reply needs
+     * a combined view when computing change groups. The single-document path keeps the base behavior.
+     */
+    createReply(options: Parameters<AIInteraction['createReply']>[0]): AIReply;
 }
 export type AIChatInteractionOptions = {
     conversationId: string;

package/dist/aichat/ui/aichatfeedview.d.ts

@@ -28,20 +28,14 @@ export declare class AIChatFeedView extends View {
      * A collection of feed items.
      */
     readonly children: ViewCollection<AIChatFeedItemView>;
-    /**
-     * The pending state of the feed. It indicates whether the feed is currently processing
-     * a response, meaning there is an active interaction.
-     *
-     * @observable
-     */
-    isPending: boolean;
     /**
      * The loading message displayed when the feed is processing a response.
      *
+     * When set, it gets displayed together with a loader spinner.
+     *
      * @observable
      */
     loadingMessage: string;
-    isLoadingSkeletonVisible: boolean;
     /**
      * @observable
      */
@@ -72,11 +66,11 @@ export declare class AIChatFeedView extends View {
         abortSignal: AbortSignal;
     }): Promise<void>;
     updateWebSources(id: string, sources: Array<AISource>): Promise<void>;
-    updateSuggestionItem({ id, parts, renderingStrategy, abortSignal }: {
+    updateSuggestionItem({ id, parts, abortSignal, skipLoadingEffects }: {
         id: string;
         parts: Array<AISuggestionContentPartDefinition>;
-        renderingStrategy: AIContentRenderingStrategy;
         abortSignal: AbortSignal;
+        skipLoadingEffects?: boolean;
     }): Promise<void>;
     updateSuggestionPartState({ id, index, state }: {
         id: string;
@@ -110,6 +104,9 @@ export declare class AIChatFeedView extends View {
      */
     hasItem(id: string): boolean;
     scrollToSuggestion(replyId: string, partIndex: number): void;
+    /**
+     * Sets the loading message of the chat feed.
+     */
     setLoadingMessage(message: string): void;
     /**
      * Toggles the loading skeleton in the feed.
@@ -117,8 +114,12 @@ export declare class AIChatFeedView extends View {
     toggleLoadingSkeleton(isLoading: boolean): void;
     /**
      * Starts the auto-scrolling of the feed.
+     *
+     * @param options.smooth When `false`, the scroll jumps instantly instead of animating. Defaults to `true`.
      */
-    startAutoScroll(): void;
+    startAutoScroll(options?: {
+        smooth?: boolean;
+    }): void;
     /**
      * Stops the auto-scrolling of the feed.
      */

package/dist/aichat/ui/aichatview.d.ts

@@ -6,9 +6,10 @@
  * @module ai/aichat/ui/aichatview
  */
 import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type FormHeaderView, View } from '@ckeditor/ckeditor5-ui';
+import { View } from '@ckeditor/ckeditor5-ui';
 import { AIChatFeedView } from './aichatfeedview.js';
 import { AIChatControlsView } from './aichatcontrolsview.js';
+import { AIHeaderView } from '../../aicore/ui/aiheaderview.js';
 import { AIDisclaimerView } from '../../aicore/ui/aidisclaimerview.js';
 import { type AIContextProvider, type AIContextResourceState } from '../../aichat/model/aichatcontext.js';
 import '../../../theme/common/ainotification.css';
@@ -21,7 +22,7 @@ import '../../../theme/common/aitrackchanges.css';
  * It contains the header, feed and controls views.
  */
 export declare class AIChatView extends View {
-    chatHeader: FormHeaderView;
+    chatHeader: AIHeaderView;
     chatFeed: AIChatFeedView;
     chatControls: AIChatControlsView;
     chatDisclaimer: AIDisclaimerView;

package/dist/aichat/ui/controls/resources/aichatcontextresourcesview.d.ts

@@ -20,7 +20,7 @@ export declare class AIChatContextResourcesView extends View {
      * Creates a new AI context resources view.
      *
      * @param locale The locale instance for internationalization
-     * @param source The AI context provider source for this resources view
+     * @param options.source The AI context provider source for this resources view.
      */
     constructor(locale: Locale, options: {
         source: AIContextProvider;

package/dist/aichat/ui/feed/aichatfeedsuggestionitemview.d.ts

@@ -12,7 +12,6 @@ import { type AISuggestionActionName } from './aichatfeedsuggestionitemactionsvi
 import { type AIReplyChangeGroupState } from '../../../aicore/model/aireply.js';
 import { type AISource } from '../../../aicore/aiconnector.js';
 import { type AISuggestionBodyViewContentPartView } from '../../../aicore/ui/suggestioncontainer/aisuggestioncontentpartview.js';
-import { type AIContentRenderingStrategy } from '../../../aicore/ui/suggestioncontainer/aisuggestionstreamablecontentview.js';
 import { type BodyCollection } from '@ckeditor/ckeditor5-ui';
 /**
  * A view for an AI suggestion item in the AI chat feed.
@@ -39,8 +38,8 @@ export declare class AIChatFeedSuggestionItemView extends AIChatFeedItemView {
      */
     updateContent(options: {
         parts: Array<AISuggestionContentPartDefinition>;
-        renderingStrategy: AIContentRenderingStrategy;
         abortSignal: AbortSignal;
+        skipLoadingEffects?: boolean;
     }): Promise<void>;
     /**
      * Updates the state of a content part by its index.

package/dist/aichat/utils/eventnames.d.ts

@@ -2,4 +2,4 @@
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-export declare const AI_CHAT_UI_EVENT_NAMES: readonly ["showChangeInText", "insertSuggestion", "applySuggestion", "rejectSuggestion", "mouseOverSuggestion", "mouseLeaveSuggestion", "toggleSuggestionDisplayMode", "like", "dislike", "startConversation", "resizeTabs", "sendUserMessage", "abortPromptStream", "addDocumentToContext", "addFileToContext", "addUrlToContext", "executeCustomItemCallback", "addResourceToContext", "removeContextItem", "loadSourceResources", "toggleWebSearch", "toggleReasoning", "selectModel"];
+export declare const AI_CHAT_UI_EVENT_NAMES: readonly ["showChangeInText", "insertSuggestion", "applySuggestion", "rejectSuggestion", "mouseOverSuggestion", "mouseLeaveSuggestion", "toggleSuggestionDisplayMode", "like", "dislike", "startConversation", "sendUserMessage", "abortPromptStream", "addDocumentToContext", "addFileToContext", "addUrlToContext", "executeCustomItemCallback", "addResourceToContext", "removeContextItem", "loadSourceResources", "toggleWebSearch", "toggleReasoning", "selectModel"];

package/dist/aichat/utils/promisequeue.d.ts

@@ -6,9 +6,6 @@ declare const PromiseQueue_base: {
     new (): import("@ckeditor/ckeditor5-utils").Emitter;
     prototype: import("@ckeditor/ckeditor5-utils").Emitter;
 };
-/**
- * @module ai/aichat/utils/promisequeue
- */
 export declare class PromiseQueue extends PromiseQueue_base {
     isProcessing: boolean;
     /**

package/dist/aichathistory/aichathistoryui.d.ts

@@ -8,7 +8,7 @@
 import { type Context, type Editor, ContextPlugin } from '@ckeditor/ckeditor5-core';
 import { AITabs } from '../aitabs/aitabs.js';
 import '../../theme/aichat/aichathistory.css';
-export declare const AI_CHAT_HISTORY_UI_EVENT_NAMES: readonly ["showConversationHistory", "removeConversation", "editConversationTitle", "setConversationPinned", "selectConversation", "openChat", "resizeTabs"];
+export declare const AI_CHAT_HISTORY_UI_EVENT_NAMES: readonly ["showConversationHistory", "removeConversation", "editConversationTitle", "setConversationPinned", "selectConversation", "startConversation"];
 export declare class AIChatHistoryUI extends ContextPlugin {
     /**
      * @inheritDoc
@@ -58,7 +58,6 @@ export declare class AIChatHistoryUI extends ContextPlugin {
      * Hides the error message in the history view.
      */
     hideError(): void;
-    setIsMaximized(isMaximized: boolean): void;
 }
 export type AIChatHistoryItemData = {
     id: string;
@@ -105,7 +104,3 @@ export type AIChatHistoryUISetPinnedEvent = {
         }
     ];
 };
-export type AIChatHistoryUIOpenChatEvent = {
-    name: 'openChat';
-    args: [];
-};

package/dist/aichathistory/ui/aichathistorylistitemview.d.ts

@@ -16,6 +16,7 @@ interface AIChatHistoryListItemViewConfig {
 declare const AIChatHistoryListItemView_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof ListItemView, import("@ckeditor/ckeditor5-collaboration-core").ConfirmApi>;
 export declare class AIChatHistoryListItemView extends /* #__PURE__ -- @preserve */ AIChatHistoryListItemView_base {
     id: string;
+    title: string;
     isVisible: boolean;
     pinned: boolean;
     isEdit: boolean;

package/dist/aichathistory/ui/aichathistoryview.d.ts

@@ -6,19 +6,11 @@
  * @module ai/aichathistory/ui/aichathistoryview
  */
 import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { View, ButtonView } from '@ckeditor/ckeditor5-ui';
+import { View } from '@ckeditor/ckeditor5-ui';
+import { AIHeaderView } from '../../aicore/ui/aiheaderview.js';
 import { type AIChatHistoryCategoryData } from '../aichathistoryui.js';
 export declare class AIChatHistoryView extends View {
-    /**
-     * The button to resize the chat view.
-     */
-    readonly resizeButton?: ButtonView;
-    /**
-     * Indicates whether the tabs view is maximized.
-     *
-     * @observable
-     */
-    isMaximized: boolean;
+    headerView: AIHeaderView;
     hasItems: boolean;
     isLoading: boolean;
     errorMessage: string;

package/dist/aiconfig.d.ts

@@ -138,6 +138,14 @@ export interface AIContainerBase {
      * Whether the AI interface should be visible when the editor is created.
      */
     visibleByDefault?: boolean;
+    /**
+     * When `true`, clicking the active tab button collapses the panel and toggles the
+     * `ck-ai-tabs_collapsed` CSS class on the AI tabs DOM element. Clicking the tab again expands
+     * it back. When `false`, clicking the active tab button is a no-op.
+     *
+     * Defaults to `false`.
+     */
+    collapsible?: boolean;
 }
 /**
  * The configuration of the AI user interface container in the sidebar mode. Provide an existing DOM

package/dist/aicore/aiconnector.d.ts

@@ -63,6 +63,16 @@ export declare class AIConnector extends ContextPlugin {
      * Gets a document from the AI API for a specific conversation.
      */
     uploadDocument(conversationId: string, content: string, attributes?: Record<string, unknown>): AIUploadRequest;
+    /**
+     * Uploads multiple documents to the AI API for a specific conversation in a single batch request.
+     *
+     * The endpoint returns an array of replies in the same order as the input documents.
+     */
+    uploadDocuments(conversationId: string, documents: Array<AIUploadDocumentData>): AIBatchUploadRequest;
+    /**
+     * Fetches multiple documents by their IDs from a conversation in a single batch request.
+     */
+    fetchDocuments(conversationId: string, documentIds: Array<string>): AIBatchFetchDocumentsRequest;
     /**
      * Fetches the list of conversations from the AI API.
      */
@@ -183,6 +193,7 @@ export type AIMessageEventModificationDelta = {
     data: {
         id: string;
         textDelta: string;
+        documentId: string;
     };
 };
 export type AIMessageEventMcpToolNotification = {
@@ -234,6 +245,25 @@ export type AIFetchDocumentReply = {
         version: number;
         sessionId: string | null;
     };
+    name?: string;
+    description?: string;
+};
+export type AIUploadDocumentData = {
+    content: string | undefined;
+    version: number;
+    sessionId: string | null;
+    selections: Array<{
+        start: number;
+        end: number;
+        htmlFragment: string;
+    }>;
+    name?: string;
+    description?: string;
+};
+export type AIBatchFetchDocumentsReply = Array<AIFetchDocumentReply>;
+export type AIBatchFetchDocumentsRequest = {
+    getDocuments: () => Promise<AIBatchFetchDocumentsReply>;
+    abortController: AbortController;
 };
 export type AIFetchDocumentRequest = {
     getDocument: () => Promise<AIFetchDocumentReply>;
@@ -246,6 +276,13 @@ export type AIUploadRequest = {
     getId: () => Promise<AIUploadReply>;
     abortController: AbortController;
 };
+export type AIBatchUploadReply = Array<{
+    id: string;
+}>;
+export type AIBatchUploadRequest = {
+    getIds: () => Promise<AIBatchUploadReply>;
+    abortController: AbortController;
+};
 export type AIConversationItem = {
     id: string;
     title: string;

package/dist/aicore/aiediting.d.ts

@@ -31,19 +31,12 @@ export declare class AIEditing extends ContextPlugin {
      */
     get sessionId(): string;
     /**
-     * Returns the data and version of the current document.
+     * 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
+     * they came from.
      */
-    getDocumentData(): Promise<{
-        content: string;
-        version: number;
-        sessionId: string;
-        selections: Array<{
-            markerName: string;
-            start: number;
-            end: number;
-            htmlFragment: string;
-        }>;
-    }>;
+    getDocumentData(): Promise<Array<AIEditingDocumentData>>;
     afterInit(): Promise<void>;
     /**
      * Displays a fake visual selection on given ranges.
@@ -61,6 +54,26 @@ export declare class AIEditing extends ContextPlugin {
     hideFakeVisualSelection(id: string): void;
     modelToDataWithIds(modelFragment: ModelDocumentFragment): Promise<string>;
 }
+/**
+ * A single document entry returned by {@link module:ai/aicore/aiediting~AIEditing#getDocumentData `AIEditing#getDocumentData()`}. One
+ * entry per editor model root (excluding `$graveyard`); `editor` + `rootName` identify the source root so callers can route AI
+ * modifications back to the correct place.
+ */
+export type AIEditingDocumentData = {
+    editor: Editor;
+    rootName: string;
+    content: string;
+    version: number;
+    sessionId: string;
+    selections: Array<{
+        markerName: string;
+        start: number;
+        end: number;
+        htmlFragment: string;
+    }>;
+    name?: string;
+    description?: string;
+};
 type FakeSelectionData = {
     /**
      * Ranges on which fake selection should be shown.

package/dist/aicore/model/aicontext.d.ts

@@ -6,6 +6,24 @@
  * @module ai/aicore/model/aicontext
  * @publicApi
  */
+import type { Editor } from '@ckeditor/ckeditor5-core';
+/**
+ * Locates a `data-id` from AI chat document HTML in a specific editor model root (multi-editor / multi-root contexts).
+ */
+export type AIDataIdDocumentSource = {
+    editor: Editor;
+    rootName: string;
+};
+/**
+ * One concatenation segment of the AI chat document HTML (single editor model root). The post-AI portion of the merged document that
+ * belongs to this slice is recovered by routing each top-level child via `AIReply#dataIdDocumentSources`, not by index.
+ */
+export type AIDocumentContextSlice = {
+    editor: Editor;
+    rootName: string;
+    html: string;
+    version: number;
+};
 /**
  * The type of context item.
  *