@ckeditor/ckeditor5-ai 48.8.1-alpha.3 → 49.0.0-alpha.0

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

@@ -1,55 +1,51 @@
 /**
- * @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
- */
+* @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/aichatinteraction
- * @publicApi
- */
-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';
+* @module ai/aichat/model/aichatinteraction
+* @publicApi
+*/
+import { type AICapabilitiesConfig } from "../../aicore/model/aicapabilities.js";
+import { AIInteraction, type AIInteractionOptions } from "../../aicore/model/aiinteraction.js";
+import { AIContext, type AIContextItem } from "../../aicore/model/aicontext.js";
 export declare class AIChatInteraction extends AIInteraction {
-    /**
-     * The user message that was sent to the AI endpoint.
-     */
-    readonly userMessage: string;
-    /**
-     * The ID of the conversation that the interaction belongs to.
-     */
-    readonly conversationId: string;
-    /**
-     * The context items that were sent to the AI endpoint.
-     */
-    readonly contextItems: Map<string, AIContextItem>;
-    /**
-     * The capabilities settings that were sent to the AI endpoint.
-     */
-    readonly capabilities: AICapabilitiesConfig;
-    /**
-     * The model of the interaction.
-     */
-    readonly model: string;
-    /**
-     * Additional metadata properties passed together with the user message when it was submitted.
-     */
-    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;
+	/**
+	* The user message that was sent to the AI endpoint.
+	*/
+	readonly userMessage: string;
+	/**
+	* The ID of the conversation that the interaction belongs to.
+	*/
+	readonly conversationId: string;
+	/**
+	* The context items that were sent to the AI endpoint.
+	*/
+	readonly contextItems: Map<string, AIContextItem>;
+	/**
+	* The capabilities settings that were sent to the AI endpoint.
+	*/
+	readonly capabilities: AICapabilitiesConfig;
+	/**
+	* The model of the interaction.
+	*/
+	readonly model: string;
+	/**
+	* Additional metadata properties passed together with the user message when it was submitted.
+	*/
+	readonly attributes?: Record<string, unknown>;
+	/**
+	* The resolved context (default context merged with any injected contexts) attached to every message in the conversation.
+	*/
+	readonly context: AIContext;
+	constructor(options: AIChatInteractionOptions);
 }
 export type AIChatInteractionOptions = {
-    conversationId: string;
-    contextItems: Map<string, AIContextItem>;
-    capabilities: AICapabilitiesConfig;
-    userMessage: string;
-    model: string;
-    attributes?: Record<string, unknown>;
+	conversationId: string;
+	contextItems: Map<string, AIContextItem>;
+	capabilities: AICapabilitiesConfig;
+	userMessage: string;
+	model: string;
+	attributes?: Record<string, unknown>;
+	context?: AIContext;
 } & AIInteractionOptions;

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

@@ -1,106 +1,78 @@
 /**
- * @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
- */
+* @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/ui/aichatballoonview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type AISuggestionActionName } from './feed/aichatfeedsuggestionitemactionsview.js';
-import { type AISuggestionContentPartDefinition } from '../../aicore/utils/getsuggestionpartsfromreply.js';
-import { type AIContentRenderingStrategy } from '../../aicore/ui/suggestioncontainer/aisuggestionstreamablecontentview.js';
-import { AIBalloonView } from '../../aiballoon/ui/aiballoonview.js';
-import { ButtonView, FocusCycler, type ViewCollection } from '@ckeditor/ckeditor5-ui';
-import { type AIReplyChangeGroupState } from '../../aicore/model/aireply.js';
-import '../../../theme/aichat/aichatballoon.css';
-export type AIChatBalloonViewConfig = {
-    showApplyButton: boolean;
-    showSuggestButton: boolean;
-    availableActions: Array<AISuggestionActionName>;
-};
+* @module ai/aichat/ui/aichatballoonview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { AIBalloonView, type AIBalloonViewConfig } from "../../aiballoon/ui/aiballoonview.js";
+import { ButtonView, FocusCycler } from "@ckeditor/ckeditor5-ui";
+import { type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../../aicore/model/aireply.js";
+import { AISeparatorView } from "../../aicore/ui/aiseparatorview.js";
 /**
- * A view that displays the AI Chat suggestion preview in the `AIBalloon` dialog.
- *
- * It also injects previous and next suggestion buttons into the dialog header.
- */
+* A view that displays the AI Chat suggestion preview in the `AIBalloon` dialog.
+*
+* It also injects previous and next suggestion buttons into the dialog header.
+*/
 export declare class AIChatBalloonView extends AIBalloonView {
-    children: ViewCollection;
-    /**
-     * View that displays the next rotator button. Injected by `AIChatBalloon` into the dialog header.
-     */
-    nextButtonView: ButtonView;
-    /**
-     * View that displays the previous rotator button. Injected by `AIChatBalloon` into the dialog header.
-     */
-    previousButtonView: ButtonView;
-    /**
-     * Focus cycler for the balloon view that allows users to navigate through the balloon using the keyboard
-     * as well as focus the view on demand.
-     */
-    focusCycler: FocusCycler;
-    /**
-     * Observable property that indicates whether the suggestion display mode is "show changes".
-     */
-    showDiff: boolean;
-    /**
-     * Observable property that indicates whether the track changes are on.
-     */
-    isTrackChangesOn: boolean;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, config: AIChatBalloonViewConfig);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the first focusable child view.
-     */
-    focus(): void;
-    /**
-     * Focuses the last focusable child view.
-     */
-    focusLast(): void;
-    /**
-     * Updates the content of the balloon.
-     */
-    updateContent(options: {
-        part: AISuggestionContentPartDefinition;
-        renderingStrategy: AIContentRenderingStrategy;
-        abortSignal?: AbortSignal;
-        keepErrors?: boolean;
-    }): Promise<void>;
-    /**
-     * Sets the state of the suggestion part displayed in the balloon.
-     */
-    setState(state: AIReplyChangeGroupState): void;
-    /**
-     * Shows an error message in the balloon.
-     */
-    showError(message: string): void;
-    /**
-     * Hides the error message in the balloon and re-enables the toolbar buttons.
-     */
-    hideError(): void;
-    /**
-     * Displays a blocking error message and disables the toolbar buttons.
-     */
-    showBlockingError(message: string): void;
-    /**
-     * Toggles the visibility of the rotator buttons.
-     */
-    toggleRotatorButtonsVisibility(isVisible: boolean): void;
-    /**
-     * Toggles the enabled state of the content part toolbar based on the flag.
-     *
-     * * Those buttons may become disabled because there's an error in the view.
-     * * Those buttons may become disabled despite pending state of the suggestion part, for instance, if the suggestion
-     * was loaded from the history.
-     */
-    togglePartToolbarEnabled(isEnabled: boolean): void;
+	/**
+	* View that displays the next rotator button. Injected by `AIChatBalloon` into the dialog header.
+	*/
+	nextButtonView: ButtonView;
+	/**
+	* View that displays the previous rotator button. Injected by `AIChatBalloon` into the dialog header.
+	*/
+	previousButtonView: ButtonView;
+	/**
+	* View that displays the separator between the navigation buttons and the change counter.
+	*/
+	headerSeparatorView: AISeparatorView;
+	/**
+	* Focus cycler for the balloon view that allows users to navigate through the balloon using the keyboard
+	* as well as focus the view on demand.
+	*/
+	focusCycler: FocusCycler;
+	/**
+	* Observable property that indicates whether the suggestion display mode is "show changes".
+	*/
+	showDiff: boolean;
+	/**
+	* Whether the part toolbar actions are disabled by the reply itself (for example a history reply).
+	*
+	* @observable
+	*/
+	areActionsDisabled: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, config: AIBalloonViewConfig);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Focuses the first focusable child view.
+	*/
+	focus(): void;
+	/**
+	* Focuses the last focusable child view.
+	*/
+	focusLast(): void;
+	/**
+	* Sets the state of the suggestion part displayed in the balloon.
+	*/
+	setState(state: AIReplyChangeGroupState, outdatedReason?: AIReplyChangeGroupOutdatedReason): void;
+	/**
+	* Toggles the visibility of the rotator buttons.
+	*/
+	toggleRotatorButtonsVisibility(isVisible: boolean): void;
+	/**
+	* @inheritDoc
+	*/
+	override adjustWidthToEditable(domRoot: HTMLElement): void;
 }

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

@@ -1,129 +1,125 @@
 /**
- * @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
- */
+* @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/ui/aichatcontrolsview
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import { View, type BodyCollection } from '@ckeditor/ckeditor5-ui';
-import { type AIAddContextOptionsState, type AIContextProvider, type AIContextResourceState } from '../model/aichatcontext.js';
-import { type AIContextItem } from '../../aicore/model/aicontext.js';
-import { type AIModelData } from '../../aicore/aiconnector.js';
-import '../../../theme/aichat/aichat-controls.css';
-import '../../../theme/aichat/aichat-controls/prompt-input.css';
-import '../../../theme/aichat/aichat-controls/prompt-capabilities.css';
-import '../../../theme/aichat/aichat-controls/model-unavailable-message.css';
-import '../../../theme/aichat/aichat-controls/aichat-context-controls.css';
-import '../../../theme/aichat/aichat-controls/aichat-context-chip.css';
-import '../../../theme/aichat/aichat-controls/aichat-controls-button.css';
-import '../../../theme/aichat/aichat-controls/aichat-controls-loader.css';
-import '../../../theme/aichat/aichat-controls/aichat-context-controls-balloon-panels.css';
+* @module ai/aichat/ui/aichatcontrolsview
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { View, type BodyCollection } from "@ckeditor/ckeditor5-ui";
+import { type AIAddContextOptionsState, type AIContextProvider, type AIContextResourceState } from "../model/aichatcontext.js";
+import { type AIContextItem } from "../../aicore/model/aicontext.js";
+import { type AIModelData } from "../../aicore/aiconnector.js";
 export declare class AIChatControlsView extends View {
-    /**
-     * The loading state of the controls.
-     *
-     * @observable
-     */
-    isLoading: boolean;
-    /**
-     * The disabled state of the controls.
-     *
-     * @observable
-     */
-    isDisabled: boolean;
-    /**
-     * Indicates if the active model is available.
-     *
-     * @observable
-     */
-    isModelAvailable: boolean;
-    constructor(locale: Locale, options: {
-        bodyCollection: BodyCollection;
-        contextResourcesSearchInputVisibleFrom?: number;
-    });
-    /**
-     * Adds an item chip to the current context list.
-     */
-    addContextItem(contextItem: AIContextItem, isLoading: boolean): void;
-    /**
-     * Removes an item from the context as chip.
-     */
-    removeContextItem(id: string): void;
-    /**
-     * Sets the loading state of an item chip in the current context list.
-     */
-    setContextItemLoading(uiId: string, isLoading: boolean): void;
-    /**
-     * Sets the upload in progress state.
-     */
-    setIsUploadInProgress(isUploadInProgress: boolean): void;
-    /**
-     * Sets the conversation context chips.
-     */
-    setConversationContext(contextItems: Array<AIContextItem>): void;
-    /**
-     * Clears the pending context UI.
-     */
-    clearPendingContextUI(): void;
-    /**
-     * Clears the conversation context UI.
-     */
-    clearConversationContextUI(): void;
-    /**
-     * Updates the state of a specific resource in the balloon views.
-     */
-    updateResourceState(sourceId: string, resourceId: string, isInContext: boolean): void;
-    /**
-     * Sets the web search state.
-     */
-    setWebSearch(isWebSearchEnabled: boolean): void;
-    /**
-     * Sets the reasoning state.
-     */
-    setReasoning(isReasoningEnabled: boolean): void;
-    /**
-     * Resets the message input.
-     */
-    resetMessageInput(): void;
-    /**
-     * Sets the add context options.
-     */
-    setAddContextOptions(options: AIAddContextOptionsState): void;
-    /**
-     * Sets the placeholder text for the prompt input.
-     */
-    setInputPlaceholder(placeholder: string): void;
-    /**
-     * Sets model list dropdown.
-     */
-    setModelList(models: Array<AIModelData>, hideModels: boolean): void;
-    /**
-     * Sets the selected model in the model list dropdown.
-     */
-    setModel(model: AIModelData | null): void;
-    /**
-     * Enables the model selector in the prompt capabilities view.
-     */
-    enableModelSelector(): void;
-    /**
-     * Disables the model selector in the prompt capabilities view.
-     */
-    disableModelSelector(hideSelector: boolean): void;
-    /**
-     * Populates a source resource balloon with loaded resources.
-     */
-    populateSourceResourceBalloon(sourceId: string, source: AIContextProvider, resources: Array<AIContextResourceState>, uid: string): void;
-    /**
-     * Closes the source resource balloon and cleans up its state.
-     */
-    closeSourceResourceBalloon(sourceId: string): void;
-    /**
-     * Focuses the prompt input.
-     */
-    focusPromptInput(useHighlight?: boolean): void;
-    /**
-     * Sets the value of the prompt input.
-     */
-    setPromptInputValue(value: string): void;
+	/**
+	* Set while a response is streaming in.
+	*
+	* @observable
+	*/
+	isBusy: boolean;
+	/**
+	* The disabled state of the controls.
+	*
+	* @observable
+	*/
+	isDisabled: boolean;
+	/**
+	* Indicates if the active model is available.
+	*
+	* @observable
+	*/
+	isModelAvailable: boolean;
+	constructor(locale: Locale, options: {
+		bodyCollection: BodyCollection;
+		contextResourcesSearchInputVisibleFrom?: number;
+		filesEnabled: boolean;
+	});
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* Adds an item chip to the current context list.
+	*/
+	addContextItem(contextItem: AIContextItem, isLoading: boolean): void;
+	/**
+	* Removes an item from the context as chip.
+	*/
+	removeContextItem(id: string): void;
+	/**
+	* Sets the loading state of an item chip in the current context list.
+	*/
+	setContextItemLoading(uiId: string, isLoading: boolean): void;
+	/**
+	* Sets the upload in progress state.
+	*/
+	setIsUploadInProgress(isUploadInProgress: boolean): void;
+	/**
+	* Sets the conversation context chips.
+	*/
+	setConversationContext(contextItems: Array<AIContextItem>): void;
+	/**
+	* Clears the pending context UI.
+	*/
+	clearPendingContextUI(): void;
+	/**
+	* Clears the conversation context UI.
+	*/
+	clearConversationContextUI(): void;
+	/**
+	* Updates the state of a specific resource in the balloon views.
+	*/
+	updateResourceState(sourceId: string, resourceId: string, isInContext: boolean): void;
+	/**
+	* Sets the web search state.
+	*/
+	setWebSearch(isWebSearchEnabled: boolean): void;
+	/**
+	* Sets the reasoning state.
+	*/
+	setReasoning(isReasoningEnabled: boolean): void;
+	/**
+	* Resets the message input.
+	*/
+	resetMessageInput(): void;
+	/**
+	* Sets the add context options.
+	*/
+	setAddContextOptions(options: AIAddContextOptionsState): void;
+	/**
+	* Sets the placeholder text for the prompt input.
+	*/
+	setInputPlaceholder(placeholder: string): void;
+	/**
+	* Sets model list dropdown.
+	*/
+	setModelList(models: Array<AIModelData>, hideModels: boolean): void;
+	/**
+	* Sets the selected model in the model list dropdown.
+	*/
+	setModel(model: AIModelData | null): void;
+	/**
+	* Enables the model selector in the prompt capabilities view.
+	*/
+	enableModelSelector(): void;
+	/**
+	* Disables the model selector in the prompt capabilities view.
+	*/
+	disableModelSelector(hideSelector: boolean): void;
+	/**
+	* Populates a source resource balloon with loaded resources.
+	*/
+	populateSourceResourceBalloon(sourceId: string, source: AIContextProvider, resources: Array<AIContextResourceState>, uid: string): void;
+	/**
+	* Closes the source resource balloon and cleans up its state.
+	*/
+	closeSourceResourceBalloon(sourceId: string): void;
+	/**
+	* Focuses the prompt input.
+	*/
+	focusPromptInput(useHighlight?: boolean): void;
+	/**
+	* Sets the value of the prompt input.
+	*/
+	setPromptInputValue(value: string): void;
 }