@ckeditor/ckeditor5-ai 48.3.1-alpha.1 → 48.4.0-alpha.0

package/dist/aiactions/aiactions.d.ts

@@ -11,6 +11,7 @@ import { AIConnector } from "../aicore/aiconnector.js";
 import { AIErrorSink } from "../aicore/aierrorreporter.js";
 import { Dialog } from "@ckeditor/ckeditor5-ui";
 import { AIEditing } from "../aicore/aiediting.js";
+import { type AIContextRef } from "../aicore/model/aicontextref.js";
 import { AIBalloon } from "../aiballoon/aiballoon.js";
 import { DocumentCompare } from "@ckeditor/ckeditor5-collaboration-core";
 /**
@@ -72,11 +73,45 @@ export type AIActionsNames = "continue" | "fix-grammar" | "improve-writing" | "m
 * Defines the parameters for an AI action executed via
 * {@link module:ai/aiactions/aiactions~AIActions#executeAction `executeAction()`}.
 *
-* For system actions, provide `actionName`. For custom actions, provide `userMessage` and `model`.
+* The definition supports a few different shapes, depending on the action type and its prompt source:
+*
+* A system action runs one of the predefined actions. Provide its `actionName`.
+*
+* ```ts
+* {
+*	actionName: 'improve-writing'
+* }
+* ```
+*
+* A custom action runs an inline prompt. Provide the `model` together with a `userMessage` that carries the prompt.
+*
+* ```ts
+* {
+*	model: 'claude-4-6-sonnet',
+*	userMessage: 'Rewrite the selected text in a more formal tone.'
+* }
+* ```
+*
+* A custom action can also rely on a context reference instead of an inline prompt. In that case neither `actionName`
+* nor `userMessage` is set, and the referenced context is passed through `contexts`.
+*
+* ```ts
+* {
+*	model: 'claude-4-6-sonnet',
+*	contexts: [ { id: 'style-guide', promptId: 'improve-writing' } ]
+* }
+* ```
 */
 export type AIActionDefinition = {
 	actionName?: AIActionsNames;
 	args?: Record<string, string>;
 	userMessage?: string;
 	model?: string;
+	/**
+	* Context references attached to the action.
+	*
+	* @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.
+	*/
+	contexts?: Array<AIContextRef>;
 };

package/dist/aiactions/model/aiactionsinteraction.d.ts

@@ -9,6 +9,7 @@ import { AIInteraction, type AIInteractionOptions } from "../../aicore/model/aii
 import { type AIConnectorRequest } from "../../aicore/aiconnector.js";
 import { type AIActionsNames, type AIActionDefinition } from "../aiactions.js";
 import { type AIContextItem } from "../../aicore/model/aicontext.js";
+import { type AIContextRef } from "../../aicore/model/aicontextref.js";
 import type { Editor } from "@ckeditor/ckeditor5-core";
 import { AIActionsReply } from "./aiactionsreply.js";
 export declare class AIActionsInteraction extends AIInteraction {
@@ -36,13 +37,18 @@ export declare class AIActionsInteraction extends AIInteraction {
 	* The model of the command. Specified only for custom actions.
 	*/
 	readonly model?: string;
+	/**
+	* Context references attached to the request. Combines the global `ai.defaultContext` entries that apply to the
+	* invoked action with the action's own context.
+	*/
+	readonly contexts?: Array<AIContextRef>;
 	hasError: boolean;
 	/**
 	* Set when this interaction fires `interactionStopped` (see {@link module:ai/aicore/model/aiinteraction~AIInteraction#stop}).
 	*/
 	stoppedExplicitly: boolean;
 	constructor(options: AIActionsInteractionOptions);
-	sendRequest(): Promise<AIConnectorRequest>;
+	sendRequest(): AIConnectorRequest;
 	getDocumentContext(): AIContextItem | undefined;
 	/**
 	* Override createReply to use the same content that was sent to AI for comparison.

package/dist/aiassistant/aiassistantui.d.ts

@@ -10,9 +10,6 @@ import { Plugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckedit
 import { Dialog } from "@ckeditor/ckeditor5-ui";
 import { AIAssistantEditing } from "./aiassistantediting.js";
 import { AIAdapter } from "./adapters/aiadapter.js";
-import "../../theme/aiassistant/ai.css";
-import "../../theme/aiassistant/ai-dropdown.css";
-import "../../theme/aiassistant/ai-form.css";
 import { ClipboardMarkersUtils } from "@ckeditor/ckeditor5-clipboard";
 /**
 * The UI plugin of the AI assistant.

package/dist/aiballoon/aiballoon.d.ts

@@ -7,7 +7,6 @@
 */
 import { ContextPlugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
 import { AIEditing } from "../aicore/aiediting.js";
-import "../../theme/aiballoon/aiballoon.css";
 import { type ModelRange } from "@ckeditor/ckeditor5-engine";
 import { type AIBalloonView, AI_BALLOON_VIEW_EVENT_NAMES } from "./ui/aiballoonview.js";
 /**

package/dist/aichat/aichatballoon.d.ts

@@ -9,7 +9,7 @@ import { type Editor, Plugin, type PluginDependenciesOf } from "@ckeditor/ckedit
 import { AIBalloon, type AIBalloonConfig } from "../aiballoon/aiballoon.js";
 import { type AISuggestionContentPartDefinition } from "../aicore/utils/getsuggestionpartsfromreply.js";
 import { type AIContentRenderingStrategy } from "../aicore/ui/suggestioncontainer/aisuggestionstreamablecontentview.js";
-import { type AIReplyChangeGroupState } from "../aicore/model/aireply.js";
+import { type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../aicore/model/aireply.js";
 import { Dialog } from "@ckeditor/ckeditor5-ui";
 /**
 * The plugin responsible for the AI Balloon dialog in the Chat UI.
@@ -66,11 +66,16 @@ export declare class AIChatBalloon extends Plugin {
 	/**
 	* Sets the state of the suggestion part displayed in the balloon (accepted, rejected, pending, etc.).
 	*/
-	setState(state: AIReplyChangeGroupState): void;
+	setState(state: AIReplyChangeGroupState, outdatedReason?: AIReplyChangeGroupOutdatedReason): void;
+	/**
+	* Updates the read-only state of the previewed suggestion's target editor. Called by the controller.
+	*/
+	setTargetReadOnly(isReadOnly: boolean): void;
 }
 type AIChatBalloonConfig = AIBalloonConfig & {
 	areActionsDisabled: boolean;
 	showRotator: boolean;
+	isTargetReadOnly: boolean;
 };
 /**
 * Event fired when user toggles the suggestion display mode.

package/dist/aichat/aichatcontroller.d.ts

@@ -11,7 +11,9 @@ import { AIConnector } from "../aicore/aiconnector.js";
 import { AIErrorSink } from "../aicore/aierrorreporter.js";
 import { AIChatConversation, type AIChatInteractionCreatedEvent } from "./model/aichatconversation.js";
 import { type AIInteractionReplyCreatedEvent, type AIToolData } from "../aicore/model/aiinteraction.js";
+import { type AIContextRef } from "../aicore/model/aicontextref.js";
 import { type AIChatInteraction } from "./model/aichatinteraction.js";
+import { AICore } from "../aicore/aicore.js";
 import { DocumentCompare } from "@ckeditor/ckeditor5-collaboration-core";
 import { type AIChatFeedCustomElementView } from "./ui/feed/aichatfeedcustomelementview.js";
 /**
@@ -36,7 +38,7 @@ export declare class AIChatController extends ContextPlugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, DocumentCompare]>;
+	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, DocumentCompare, AICore]>;
 	/**
 	* @inheritDoc
 	*/
@@ -157,14 +159,21 @@ export declare class AIChatController extends ContextPlugin {
 	*
 	* @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.
+	* @param options.contexts Additional context references attached to every message of this conversation, merged with
+	* the {@link module:ai/aiconfig~AIConfig#defaultContext global default context} resolved for the `chat` feature.
+	* Used by features that seed a conversation (for example AI Quick Actions) to inject their own context.
+	*
+	* @experimental **Experimental:** The `contexts` option is a production-ready API but may change in minor releases
+	* without the standard deprecation policy. Check the changelog for migration guidance.
 	*/
 	startConversation(options?: {
 		modelId?: string;
+		contexts?: Array<AIContextRef>;
 	}): Promise<void>;
 	/**
 	* Submits a user message to the currently active conversation.
 	*/
-	sendMessage(messageData: AIChatUserMessageData): Promise<void>;
+	sendMessage({ message, attributes }: AIChatUserMessageData): Promise<void>;
 	/**
 	* Returns the ID under which conversations are grouped. All created conversations will have this `groupId` set. Conversation history
 	* will fetch conversations with such `groupId`.
@@ -183,6 +192,7 @@ export declare class AIChatController extends ContextPlugin {
 	protected _startConversationSafely(options?: {
 		id?: string;
 		modelId?: string;
+		contexts?: Array<AIContextRef>;
 	}): Promise<void>;
 }
 /**

package/dist/aichat/aichatui.d.ts

@@ -12,13 +12,12 @@ import { type AIContextItem } from "../aicore/model/aicontext.js";
 import { type Document } from "../aicore/utils/htmlparser.js";
 import { type AICapabilitiesConfig } from "../aicore/model/aicapabilities.js";
 import { type AIChatInputPaste } from "./utils/resolvepaste.js";
-import { type AIReply, type AIReplyChangeGroupState } from "../aicore/model/aireply.js";
+import { type AIReply, type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../aicore/model/aireply.js";
 import { type AISuggestionContentPartDefinition } from "../aicore/utils/getsuggestionpartsfromreply.js";
-import { type AIChatConversationInitializedEvent } from "./model/aichatconversation.js";
+import { type AISuggestionGating } from "../aicore/ui/suggestioncontainer/aisuggestionbodyview.js";
 import { type AIModelData, type AISource } from "../aicore/aiconnector.js";
 import { type AIChatInteraction } from "./model/aichatinteraction.js";
 import { type AIContentRenderingStrategy } from "../aicore/ui/suggestioncontainer/aisuggestionstreamablecontentview.js";
-import "../../theme/aichat/aichat.css";
 import { type AIChatFeedCustomElementView } from "./ui/feed/aichatfeedcustomelementview.js";
 export declare class AIChatUI extends ContextPlugin {
 	/**
@@ -40,7 +39,9 @@ export declare class AIChatUI extends ContextPlugin {
 	/**
 	* The busy state of the UI.
 	*
-	* It is set to `true` when there are AI response being streamed or rendered.
+	* It is set to `true` when the UI is busy for any reason, e.g.:
+	* - The AI response is still being streamed or rendered.
+	* - A whole conversation from history is still being loaded or rendered.
 	*
 	* @observable
 	*/
@@ -52,6 +53,10 @@ export declare class AIChatUI extends ContextPlugin {
 	*/
 	isModelAvailable: boolean;
 	/**
+	* @observable
+	*/
+	isChatStreaming: boolean;
+	/**
 	* @inheritDoc
 	*/
 	constructor(context: Context | Editor);
@@ -59,7 +64,9 @@ export declare class AIChatUI extends ContextPlugin {
 	/**
 	* Creates a new conversation by greeting the user.
 	*/
-	createConversation(data: AIChatConversationInitializedEvent["args"][0]): void;
+	createConversation({ availableModels }: {
+		availableModels: Array<AIModelData>;
+	}): void;
 	/**
 	* Adds a generic message to the chat feed.
 	*/
@@ -135,8 +142,13 @@ export declare class AIChatUI extends ContextPlugin {
 		id: string;
 		index: number;
 		state: AIReplyChangeGroupState;
+		outdatedReason?: AIReplyChangeGroupOutdatedReason;
 	}): void;
 	/**
+	* Applies the gating state to a suggestion reply's views.
+	*/
+	setSuggestionGating(replyId: string, gating: AISuggestionGating): void;
+	/**
 	* Sets the part active or not (active parts are those currently previewed in a dialog by the user).
 	*/
 	setFeedItemAIReplySuggestionPartActive(options: {
@@ -156,7 +168,7 @@ export declare class AIChatUI extends ContextPlugin {
 	* Handles the user stopping the interaction. It terminates all scheduled UI update promises and unlocks the UI
 	* immediately.
 	*/
-	stopInteraction(interaction: AIChatInteraction): void;
+	stopInteraction(interaction?: AIChatInteraction): void;
 	/**
 	* Handles the interaction finishing due to lack of data to process (or an error). Waits for all pending UI
 	* updates to finish, then unlocks the UI.
@@ -263,8 +275,10 @@ export declare class AIChatUI extends ContextPlugin {
 	startAutoScroll(options?: {
 		smooth?: boolean;
 	}): void;
+	stopAutoScroll(): void;
 	disableControls(): void;
 	enableControls(): void;
+	toggleConversationLoading(updatedIsBusy: boolean): void;
 }
 /**
 * An event fired when the user starts a new conversation.

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

@@ -7,10 +7,8 @@
 * @publicApi
 */
 import { type Editor } from "@ckeditor/ckeditor5-core";
-import { type ObservableMixinConstructor } from "@ckeditor/ckeditor5-utils";
 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";
-declare const AIChatContextBase: ObservableMixinConstructor;
+import { AIContext, type AIContextItemType, type AIContextTextResourceType, type AIContextItem, type AIContextItemRequestData, 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"];
 /**
 * Manages the context of the current conversation.
@@ -18,7 +16,7 @@ export declare const AI_CONTEXT_MODEL_EVENT_NAMES: readonly ["contextItemAdded",
 * @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 declare class AIChatContext extends AIChatContextBase {
+export declare class AIChatContext extends AIContext {
 	constructor({ connector, config, ownerId }: {
 		connector: AIConnector;
 		config?: AIChatContextConfig;
@@ -45,17 +43,18 @@ export declare class AIChatContext extends AIChatContextBase {
 	* (notably by `AIReply`) to route modifications back to the source editor and root; non-document content items
 	* are turned into one context item each.
 	*
-	* Returns the assembled context items together with a `hasUnmatched` flag — set when at least one document could
+	* Returns the assembled context items together with `unmatchedDocumentIds` — the IDs of documents that could
 	* not be matched to a live editor root via `attributes.channelId` (compared against the editor's
-	* `collaboration.channelId` config) and `attributes.rootName`. Callers should propagate `hasUnmatched` to reply
-	* `areActionsDisabled` so suggestions from unmatched roots are shown with a "from previous session" note.
-	*
+	* `collaboration.channelId` config) and `attributes.rootName`. Callers resolve a per-document outdated reason
+	* from these IDs so suggestions from unmatched roots render as outdated while their matched siblings stay
+	* actionable.
 	* @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.
 	*/
-	populateFromMessage(messageContents: AIUserMessage["content"], editors: ReadonlyArray<Editor>): Promise<{
+	populateFromMessage(messageContents: AIUserMessage["content"], editors: ReadonlyArray<Editor>, defaultContextIds?: Set<string>): Promise<{
 		contextItems: Map<string, AIContextItem>;
 		hasUnmatched: boolean;
+		unmatchedDocumentIds: Set<string>;
 	}>;
 	/**
 	* Creates a context item from a single non-document conversation content entry. Document content items are
@@ -83,6 +82,10 @@ export declare class AIChatContext extends AIChatContextBase {
 	/**
 	* Clears all pending context items and adds the current document to the conversation context if it exists.
 	*
+	* Context references (`type: 'context'`) are non-persistent and are skipped here: the backend does not store them
+	* in the conversation state, so they must be re-attached to every message for as long as the user keeps them
+	* selected. Skipping them also keeps their chips visible and removable.
+	*
 	* @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.
 	*/
@@ -90,6 +93,10 @@ export declare class AIChatContext extends AIChatContextBase {
 	/**
 	* Adds context items to the conversation context and clears the pending context items.
 	*
+	* Context references (`type: 'context'`) are non-persistent and never become conversation items: the backend does
+	* not store them in the conversation state (they are re-attached to every message while selected), and tracking
+	* them here would keep reporting the resource as in context after the user removes its chip.
+	*
 	* @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.
 	*/
@@ -150,6 +157,10 @@ export declare class AIChatContext extends AIChatContextBase {
 	*/
 	addCurrentDocumentToContext(label: string): void;
 	/**
+	* Returns context item for current document context, or undefined if the document context is not added.
+	*/
+	getCurrentDocumentContext(): AIContextItem | undefined;
+	/**
 	* @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.
 	*/
@@ -384,6 +395,15 @@ export type AIChatContextConfig = {
 		enabled: boolean;
 	};
 	/**
+	* When this option is enabled, the contexts available to the current token are offered in the context picker as a
+	* built-in source, excluding any context referenced by the global `ai.defaultContext` configuration.
+	*
+	* @default false
+	*/
+	contextLibrary?: {
+		enabled: boolean;
+	};
+	/**
 	* The configuration of the custom options in the context menu.
 	*
 	* Each configured {@link module:ai/aichat/model/aichatcontext~AIContextProvider} represents a single menu option that, when clicked,
@@ -660,4 +680,3 @@ export type AIContextCustomItem = {
 	icon?: string;
 	callback: () => void;
 };
-export {};

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

@@ -9,6 +9,7 @@ import { type EmitterMixinConstructor, type Locale } from "@ckeditor/ckeditor5-u
 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 { type AIEditing } from "../../aicore/aiediting.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";
@@ -98,6 +99,7 @@ export declare class AIChatConversation extends AIChatConversationBase {
 		userMessage: string;
 		attributes?: Record<string, unknown>;
 	}): Promise<void>;
+	stopProcessing(): void;
 	/**
 	* Creates a new interaction and stores it in the conversation.
 	*/
@@ -272,9 +274,16 @@ export type AIChatConversationOptions = {
 	selectedModelId?: string;
 	isFromHistory: boolean;
 	/**
-	* Returns the session id of the given editor. Used by the conversation when detecting whether a stored
+	* Returns the session ID of the given editor. Used by the conversation when detecting whether a stored
 	* AI chat reply was created during the current editing session of its source editor.
 	*/
 	getSessionId: (editor: Editor) => string;
+	/**
+	* The {@link module:ai/aicore/aiediting~AIEditing} context plugin. The conversation uses its context-level utilities
+	* (e.g. {@link module:ai/aicore/aiediting~AIEditing#getDocumentData} and
+	* {@link module:ai/aicore/aiediting~AIEditing#getEditorsVersions}) to refresh the current-document context, instead of
+	* reaching for individual editor instances.
+	*/
+	aiEditing: AIEditing;
 };
 export {};

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

@@ -8,7 +8,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 { AIContext, type AIContextItem } from "../../aicore/model/aicontext.js";
 export declare class AIChatInteraction extends AIInteraction {
 	/**
 	* The user message that was sent to the AI endpoint.
@@ -34,6 +34,10 @@ export declare class AIChatInteraction extends AIInteraction {
 	* 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 = {
@@ -43,4 +47,5 @@ export type AIChatInteractionOptions = {
 	userMessage: string;
 	model: string;
 	attributes?: Record<string, unknown>;
+	context?: AIContext;
 } & AIInteractionOptions;

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

@@ -11,8 +11,7 @@ import { type AISuggestionContentPartDefinition } from "../../aicore/utils/getsu
 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";
+import { type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../../aicore/model/aireply.js";
 export type AIChatBalloonViewConfig = {
 	showApplyButton: boolean;
 	showSuggestButton: boolean;
@@ -47,6 +46,18 @@ export declare class AIChatBalloonView extends AIBalloonView {
 	*/
 	isTrackChangesOn: boolean;
 	/**
+	* Whether the target editor is read-only. Forwarded to the part toolbar to disable the write actions (apply, suggest).
+	*
+	* @observable
+	*/
+	isTargetReadOnly: 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: AIChatBalloonViewConfig);
@@ -82,29 +93,13 @@ export declare class AIChatBalloonView extends AIBalloonView {
 	/**
 	* Sets the state of the suggestion part displayed in the balloon.
 	*/
-	setState(state: AIReplyChangeGroupState): void;
+	setState(state: AIReplyChangeGroupState, outdatedReason?: AIReplyChangeGroupOutdatedReason): void;
 	/**
 	* Shows an error message in the balloon.
 	*/
 	override showError(message: string): void;
 	/**
-	* Hides the error message in the balloon and re-enables the toolbar buttons.
-	*/
-	override hideError(): void;
-	/**
-	* Displays a blocking error message and disables the toolbar buttons.
-	*/
-	override 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;
 }

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

@@ -10,15 +10,6 @@ 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";
 export declare class AIChatControlsView extends View {
 	/**
 	* The loading state of the controls.

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

@@ -17,17 +17,9 @@ import { AIChatFeedErrorItemView } from "./feed/aichatfeederroritemview.js";
 import { AIChatFeedInteractionHeaderView } from "./feed/aichatfeedinteractionheaderview.js";
 import { type AISuggestionContentPartDefinition } from "../../aicore/utils/getsuggestionpartsfromreply.js";
 import { AIChatFeedCustomElementView } from "./feed/aichatfeedcustomelementview.js";
-import { type AIReplyChangeGroupState } from "../../aicore/model/aireply.js";
+import { type AIReplyChangeGroupState, type AIReplyChangeGroupOutdatedReason } from "../../aicore/model/aireply.js";
 import { type AISource } from "../../aicore/aiconnector.js";
-import "../../../theme/aichat/aichatfeed.css";
-import "../../../theme/aichat/aichatcontent/_base.css";
-import "../../../theme/aichat/aichatcontent/_typography.css";
-import "../../../theme/aichat/aichatcontent/_link.css";
-import "../../../theme/aichat/aichatcontent/_code.css";
-import "../../../theme/aichat/aichatcontent/_list.css";
-import "../../../theme/aichat/aichatcontent/_table.css";
-import "../../../theme/aichat/aichatcontent/_blockquote.css";
-import "../../../theme/aichat/aichatcontent/_hr.css";
+import { type AISuggestionGating } from "../../aicore/ui/suggestioncontainer/aisuggestionbodyview.js";
 /**
 * A view that displays the chat feed with various items.
 */
@@ -80,11 +72,13 @@ export declare class AIChatFeedView extends View {
 		abortSignal: AbortSignal;
 		skipLoadingEffects?: boolean;
 	}): Promise<void>;
-	updateSuggestionPartState({ id, index, state }: {
+	updateSuggestionPartState({ id, index, state, outdatedReason }: {
 		id: string;
 		index: number;
 		state: AIReplyChangeGroupState;
+		outdatedReason?: AIReplyChangeGroupOutdatedReason;
 	}): void;
+	updateSuggestionGating(replyId: string, gating: AISuggestionGating): void;
 	/**
 	* Sets the part active or not (active parts are those currently previewed in a dialog by the user).
 	*/

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

@@ -12,10 +12,6 @@ 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";
-import "../../../theme/common/aibutton.css";
-import "../../../theme/common/aicolor.css";
-import "../../../theme/common/aitrackchanges.css";
 /**
 * The main view of the AI chat plugin.
 *

package/dist/aichat/ui/controls/aichatdropzoneview.d.ts

@@ -14,6 +14,10 @@ import { type Locale } from "@ckeditor/ckeditor5-utils";
 * through one listener.
 */
 export declare class AIChatDropZoneView extends View {
+	/**
+	* @observable
+	*/
+	isEnabled: boolean;
 	constructor(locale: Locale);
 	attach(target: HTMLElement): void;
 }

package/dist/aichat/ui/controls/aichatpromptcapabilitiesview.d.ts

@@ -7,6 +7,7 @@
 */
 import { type Locale } from "@ckeditor/ckeditor5-utils";
 import { View } from "@ckeditor/ckeditor5-ui";
+import { AIModelSelectorView } from "../../../aicore/ui/aimodelselectorview.js";
 import { type AIModelData } from "../../../aicore/aiconnector.js";
 /**
 * Manages the prompt capabilities UI for AI chat, including web search, commands functionality, and model selection.
@@ -25,39 +26,14 @@ export declare class AIChatPromptCapabilitiesView extends View {
 	*/
 	reasoningActive: boolean;
 	/**
-	* Determines the model display mode:
-	* * 'selector' – shows the dropdown,
-	* * 'name' – shows the model name,
-	* * 'hidden' – hides both.
-	*
-	* @observable
-	*/
-	modelDisplayMode: "selector" | "name" | "hidden";
-	/**
-	* Indicates whether the model selection UI is enabled. The selection gets disabled
-	* after the first message is sent to the API, as the model cannot be changed then.
+	* Indicates whether the model selection UI is enabled. The selection gets disabled after the first
+	* message is sent to the API, as the model cannot be changed then.
 	*
 	* @observable
 	*/
 	modelSelectorEnabled: boolean;
-	/**
-	* The ID of the currently active model.
-	*
-	* @observable
-	*/
-	activeModelId: string | null;
-	/**
-	* The name of the currently active model.
-	*
-	* @observable
-	*/
-	activeModelName: string | null;
 	constructor(locale: Locale);
 	/**
-	* Sets model list dropdown.
-	*/
-	setModelList(models: Array<AIModelData>, hideModels: boolean): void;
-	/**
 	* Sets the web search state.
 	*/
 	setWebSearch(isWebSearchEnabled: boolean): void;
@@ -66,7 +42,11 @@ export declare class AIChatPromptCapabilitiesView extends View {
 	*/
 	setReasoning(isReasoningEnabled: boolean): void;
 	/**
-	* Sets the selected model.
+	* Populates the model selector with the given models.
+	*/
+	setModelList(models: Array<AIModelData>, hideModels: boolean): void;
+	/**
+	* Reflects the selected model in the selector and the capability buttons.
 	*/
 	setModel(model: AIModelData | null): void;
 	/**
@@ -74,10 +54,15 @@ export declare class AIChatPromptCapabilitiesView extends View {
 	*/
 	enableModelSelector(): void;
 	/**
-	* Disables the model selector dropdown.
+	* Disables the model selector dropdown, optionally hiding it entirely.
 	*/
 	disableModelSelector(hideSelector: boolean): void;
 }
+/**
+* Creates the shared model selector configured for AI Chat: chat-specific CSS classes, per-model
+* capability rendering, and the "disabled" tooltip shown once the model can no longer be changed.
+*/
+export declare function createChatModelSelector(locale: Locale): AIModelSelectorView;
 export type AIChatUIToggleWebSearchEvent = {
 	name: "toggleWebSearch";
 	args: [];