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

package/dist/aidocumentprocessing/aidocumentprocessinggateway.d.ts

@@ -7,27 +7,50 @@
 * @publicApi
 */
 import { ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
-import { AIConnector, type AIModelData } from "../aicore/aiconnector.js";
+import type { AIEditorRoot } from "../aicore/model/aieditorroot.js";
+import { AIConnector } from "../aicore/aiconnector.js";
+import { AICore } from "../aicore/aicore.js";
+import { type AIModels } from "../aicore/model/aimodels.js";
 import { AIEditing } from "../aicore/aiediting.js";
 import { AIGateway, type AIRunBaseOptions, type AIGatewayApplyOptions } from "../aicore/aigateway.js";
+import { type AICapabilitiesConfigAdvanced } from "../aicore/model/aicapabilities.js";
 import { AIDocumentProcessingRunResult } from "./model/aidocumentprocessingrunresult.js";
+import { AIRunResult } from "../aicore/model/airunresult.js";
 export type AIDocumentProcessingRunOptions = AIRunBaseOptions & {
 	/**
 	* The model that will be used to run the document processing request.
-	* The ids of an AI models can be acquired
-	* via {@link module:ai/aidocumentprocessing/aidocumentprocessinggateway~AIDocumentProcessingGateway#getAvailableModels} call.
+	* The IDs of an AI models can be acquired
+	* via {@link module:ai/aicore/model/aimodels~AIModels#getAvailableModels} call.
 	*/
 	model: string;
+	/**
+	* The roots to process. When omitted, every non-`$graveyard` root across every editor in the current
+	* {@link module:core/context~Context `Context`} is processed. When provided, only the listed roots are
+	* processed; the order of entries in `roots` is treated as a set-membership filter and does not affect
+	* the payload order.
+	*
+	* Each entry's `channelId` must match the `collaboration.channelId` config of the target editor instance.
+	* `rootName` must match an existing, non-`$graveyard` root within that editor.
+	*/
+	roots?: Array<AIEditorRoot>;
+	/**
+	* Per-call AI capability directives. `webSearch` toggles web search; `reasoning` toggles reasoning and
+	* optionally selects a level
+	* (see {@link module:ai/aicore/model/aicapabilities~AIReasoningLevel AIReasoningLevel}).
+	* Omitting the option or leaving all flags falsy disables both capabilities for this call.
+	*/
+	capabilities?: AICapabilitiesConfigAdvanced;
 };
 /**
 * Headless, stateless API for performing AI-powered transformations on entire documents through the `/documents/process` endpoint.
 * Similar to sending a single message through the {@link module:ai/aichat/aichat~AIChat AI Chat plugin}.
 *
-* This API provides a simple document-processing workflow: a single `prompt` is applied to a single `document`, producing
-* a transformed document with all AI-generated changes already applied.
+* This API provides a simple document-processing workflow: a single `prompt` is applied to one or more documents,
+* producing transformed documents with all AI-generated changes already applied.
 *
-* For multi-root editors, only the first non-`$graveyard` root is processed. Other roots are neither sent to the endpoint nor
-* modified when the transformation result is applied.
+* By default, every non-`$graveyard` root across every editor in the context is processed. To restrict a run to a
+* subset of roots, pass the `roots` option to
+* {@link module:ai/aidocumentprocessing/aidocumentprocessinggateway~AIDocumentProcessingGateway#processDocument}.
 */
 export declare class AIDocumentProcessingGateway extends ContextPlugin {
 	/**
@@ -37,7 +60,16 @@ export declare class AIDocumentProcessingGateway extends ContextPlugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIConnector, AIEditing, AIGateway]>;
+	static get requires(): PluginDependenciesOf<[AIConnector, AIEditing, AIGateway, AICore]>;
+	/**
+	* The shared model registry. Exposed here so headless gateways are self-sufficient — integrators can
+	* discover and resolve models (`getAvailableModels()`, `getModel()`, `resolveModel()`, …) without
+	* reaching for the `AICore` plugin directly.
+	*
+	* @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.
+	*/
+	get models(): AIModels;
 	/**
 	* @inheritDoc
 	*/
@@ -47,31 +79,22 @@ export declare class AIDocumentProcessingGateway extends ContextPlugin {
 	*/
 	static override get isPremiumPlugin(): true;
 	/**
-	* Returns the list of AI models that can be used with document processing API.
-	*
-	* This is a convenience proxy to the {@link module:ai/aicore/aigateway~AIGateway#getAvailableModels} method.
-	*
-	* @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.
-	*/
-	getAvailableModels(): Promise<Array<AIModelData>>;
-	/**
-	* Runs the document processing request and returns
-	* the {@link module:ai/aidocumentprocessing/model/aidocumentprocessingrunresult~AIDocumentProcessingRunResult detailed result}.
+	* Runs the document processing request and returns an
+	* {@link module:ai/aicore/model/airunresult~AIRunResult AIRunResult} — a container with one
+	* {@link module:ai/aidocumentprocessing/model/aidocumentprocessingrunresult~AIDocumentProcessingRunResult
+	* AIDocumentProcessingRunResult} per root and whole-run `status` / `error`.
 	*
 	* The result can then be applied to the editor via {@link #applyResult}. Transport, parsing, and merge failures
 	* are surfaced via `status: 'error'` plus the `error` field, not thrown. Aborts (via `options.signal`) are reported
 	* as `status: 'aborted'`.
 	*
-	* In multi-root editors, only the first non-`$graveyard` root is sent to the endpoint and reflected in the returned
-	* result. Other roots are ignored.
-	*
 	* @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 prompt The prompt to run against the document.
-	* @param options Optional `signal` to allow aborting the run.
+	* @param options Run options: required `model`, optional `roots` to restrict the run to a subset of roots, optional `signal`
+	* to abort the run, and optional `capabilities` asking the AI service to use web search or reasoning for this call.
 	*/
-	processDocument(prompt: string, options: AIDocumentProcessingRunOptions): Promise<AIDocumentProcessingRunResult>;
+	processDocument(prompt: string, options: AIDocumentProcessingRunOptions): Promise<AIRunResult<AIDocumentProcessingRunResult>>;
 	/**
 	* Applies the document processing result (produced by {@link #processDocument}) to the editor content, either as direct
 	* changes or as track changes suggestions.
@@ -83,5 +106,5 @@ export declare class AIDocumentProcessingGateway extends ContextPlugin {
 	* @param result The result of a completed run.
 	* @param applyOptions Options for applying the changes to the editor content.
 	*/
-	applyResult(result: AIDocumentProcessingRunResult, applyOptions: AIGatewayApplyOptions): void;
+	applyResult(result: AIRunResult<AIDocumentProcessingRunResult>, applyOptions: AIGatewayApplyOptions): void;
 }

package/dist/aidocumentprocessing/model/aidocumentprocessingrunresult.d.ts

@@ -6,11 +6,11 @@
 * @module ai/aidocumentprocessing/model/aidocumentprocessingrunresult
 * @publicApi
 */
-import { AIRunResult } from "../../aicore/model/airunresult.js";
+import { AIRunSingleRootResult } from "../../aicore/model/airunsinglerootresult.js";
 /**
 * The result of an AI document processing run.
 */
-export declare class AIDocumentProcessingRunResult extends AIRunResult {
+export declare class AIDocumentProcessingRunResult extends AIRunSingleRootResult {
 	/**
 	* The summary of changes produced by the run.
 	*/

package/dist/aieditorintegration/aitogglebutton/aitogglebuttonui.d.ts

@@ -8,7 +8,6 @@
 */
 import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
 import { AITabs } from "../../aitabs/aitabs.js";
-import "../../../theme/aieditorintegration/aitogglebutton.css";
 /**
 * Registers the `toggleAi` toolbar button that toggles the visibility of AI tabs.
 *

package/dist/aiquickactions/aiquickactions.d.ts

@@ -10,6 +10,7 @@ import { type Editor, Plugin, type PluginDependenciesOf } from "@ckeditor/ckedit
 import { AIQuickActionsUI } from "./aiquickactionsui.js";
 import { AIQuickActionsEditing } from "./aiquickactionsediting.js";
 import { AIActions } from "../aiactions/aiactions.js";
+import { type AIContextRef } from "../aicore/model/aicontextref.js";
 /**
 * The AI Quick Actions feature.
 *
@@ -107,7 +108,7 @@ export interface AIQuickActionsConfig {
 	*/
 	extraCommands?: Array<AIQuickActionCustomDefinition>;
 	/**
-	* The ids of the commands to remove from the AI Quick Actions feature. Removing all commands from a specific category
+	* The IDs of the commands to remove from the AI Quick Actions feature. Removing all commands from a specific category
 	* will remove the category from the user interface.
 	*
 	* The defaults are as follows:
@@ -216,10 +217,6 @@ export interface AIQuickActionCustomBaseDefinition {
 	*/
 	readonly type: AIQuickActionType;
 	/**
-	* The prompt to be sent to the AI model when the action is executed.
-	*/
-	readonly prompt: string;
-	/**
 	* The AI model to use for the action. For `'action'` type, if not specified, the default model will be used.
 	* For `'chat'` type, if not specified, the model currently selected in the AI Chat will be used.
 	*/
@@ -228,8 +225,14 @@ export interface AIQuickActionCustomBaseDefinition {
 /**
 * A custom AI quick action definition.
 *
-* An example of an action that inserts content in the editor. The `model` property is optional — if not specified,
-* the default model (from `ai.models.defaultModelId` configuration or the first available model) will be used:
+* The action needs a prompt source, provided in one of three ways:
+*
+* * an inline `prompt` string - sent as the prompt,
+* * a `context` reference - the referenced context drives the action (for example through a prompt it contains),
+* * both - the inline `prompt` is used and the `context` is attached as additional reference material (for example a file).
+*
+* The `model` property is optional. If not specified, the default model (from the `ai.models.defaultModelId`
+* configuration or the first available model) is used.
 *
 * ```ts
 * {
@@ -240,10 +243,54 @@ export interface AIQuickActionCustomBaseDefinition {
 *	model: 'claude-4-6-sonnet'
 * }
 * ```
+*
+* The same action using a `context` reference instead of an inline `prompt`:
+*
+* ```ts
+* {
+*	id: 'add-quote-from-famous-person',
+*	label: 'Add a quote from a famous person',
+*	context: { id: 'my-context', promptId: 'add-quote' },
+*	type: 'action',
+*	model: 'claude-4-6-sonnet'
+* }
+* ```
+*
+* An inline `prompt` combined with a `context` that attaches a single file as reference material:
+*
+* ```ts
+* {
+*	id: 'add-quote-from-famous-person',
+*	label: 'Add a quote from a famous person',
+*	prompt: 'Add a quote from a known person, which would make sense in the context of the selected text.',
+*	context: { id: 'my-context', fileId: 'famous-quotes' },
+*	type: 'action',
+*	model: 'claude-4-6-sonnet'
+* }
+* ```
 */
-export interface AIQuickActionCustomActionDefinition extends AIQuickActionCustomBaseDefinition {
+export type AIQuickActionCustomActionDefinition = AIQuickActionCustomBaseDefinition & {
 	type: "action";
-}
+	/**
+	* The prompt to be sent to the AI model when the action is executed.
+	*
+	* At least one prompt source is required: an inline `prompt`, a `context` that carries a prompt (a whole context
+	* or a `promptId` reference), or both. A `context` that references only a single file (`fileId`) cannot drive the
+	* action on its own and must be combined with an inline `prompt`.
+	*/
+	readonly prompt?: string;
+	/**
+	* A context reference attached to the action.
+	*
+	* When no inline `prompt` is provided, the referenced context drives the action (a whole context or a `promptId`
+	* reference). When combined with an inline `prompt`, it is attached as additional reference material (for example
+	* a single file).
+	*
+	* @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.
+	*/
+	readonly context?: AIContextRef;
+};
 /**
 * A custom AI quick action definition that interacts with {@link module:ai/aichat/aichat~AIChat AI Chat}.
 *
@@ -264,6 +311,10 @@ export interface AIQuickActionCustomActionDefinition extends AIQuickActionCustom
 export interface AIQuickActionCustomChatDefinition extends AIQuickActionCustomBaseDefinition {
 	type: "chat";
 	/**
+	* The prompt to be sent to the AI Chat when the action is executed.
+	*/
+	readonly prompt: string;
+	/**
 	* The prompt shown in the AI Chat UI when the action is executed. If not specified, the `prompt` property value will be used.
 	*/
 	displayedPrompt: string;

package/dist/aiquickactions/aiquickactionsui.d.ts

@@ -6,11 +6,10 @@ import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
 import { type Locale } from "@ckeditor/ckeditor5-utils";
 import { AIErrorSink } from "../aicore/aierrorreporter.js";
 import { BalloonToolbar } from "@ckeditor/ckeditor5-ui";
+import { AICore } from "../aicore/aicore.js";
 import { AIConnector } from "../aicore/aiconnector.js";
-import "../../theme/common/aibutton.css";
-import "../../theme/common/aicolor.css";
-import "../../theme/aiquickactions/aiquickactions.css";
 import { type AIQuickActionType } from "./aiquickactions.js";
+import { type AIContextRef } from "../aicore/model/aicontextref.js";
 /**
 * UI plugin for AI Quick Actions that provides a set of predefined AI-powered tools.
 *
@@ -26,7 +25,7 @@ export declare class AIQuickActionsUI extends Plugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[BalloonToolbar, AIConnector, AIErrorSink]>;
+	static get requires(): PluginDependenciesOf<[BalloonToolbar, AIConnector, AIErrorSink, AICore]>;
 	/**
 	* @inheritDoc
 	*/
@@ -124,6 +123,13 @@ export type AIQuickActionDefinition = {
 	*/
 	prompt?: string;
 	/**
+	* Optional reference to a context 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.
+	*/
+	context?: AIContextRef;
+	/**
 	* Optional model to be used.
 	*/
 	model?: string;

package/dist/aiquickactions/ui/balloon/aiactionsballoonview.d.ts

@@ -12,7 +12,6 @@ import { type AIMiniToolbarConfig } from "../../../aicore/ui/suggestioncontainer
 import { type AIContentRenderingStrategy } from "../../../aicore/ui/suggestioncontainer/aisuggestionstreamablecontentview.js";
 import { type AISuggestionContentPartDefinition } from "../../../aicore/utils/getsuggestionpartsfromreply.js";
 import { AIBalloonView } from "../../../aiballoon/ui/aiballoonview.js";
-import "../../../../theme/aiquickactions/aiquickactionsballoon.css";
 /**
 * Event names that can be fired by the AI Balloon view.
 */
@@ -41,6 +40,12 @@ export declare class AIActionsBalloonView extends AIBalloonView implements ViewW
 	* It is set to `true` when there are AI response being streamed or rendered.
 	*/
 	isBusy: boolean;
+	/**
+	* Whether the target editor is read-only. When `true`, the apply/suggest buttons are disabled (running is still allowed).
+	*
+	* @observable
+	*/
+	isTargetReadOnly: boolean;
 	constructor(locale: Locale, config: AIActionsBalloonViewConfig);
 	/**
 	* @inheritDoc

package/dist/aireviewcore/aireviewcorecheckregistry.d.ts

@@ -5,9 +5,7 @@
 /**
 * @module ai/aireviewcore/aireviewcorecheckregistry
 */
-import { ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
-import { AIConnector } from "../aicore/aiconnector.js";
-import { AIErrorSink } from "../aicore/aierrorreporter.js";
+import { ContextPlugin, type PluginDependencies } from "@ckeditor/ckeditor5-core";
 import type { AIReviewCheckList } from "./model/aireviewchecklist.js";
 /**
 * Base class for feature-specific check-list registries.
@@ -18,7 +16,7 @@ export declare abstract class AIReviewCoreCheckRegistry<T extends AIReviewCheckL
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink]>;
+	static get requires(): PluginDependencies;
 	/**
 	* @inheritDoc
 	*/

package/dist/aireviewcore/aireviewcoreediting.d.ts

@@ -11,6 +11,10 @@ import { ContextPlugin, Editor, type Context, type PluginDependenciesOf } from "
 import { DocumentCompare } from "@ckeditor/ckeditor5-collaboration-core";
 import { type AIReviewCheckResultChange } from "./model/aireviewcheckresultchange.js";
 import { AIEditing } from "../aicore/aiediting.js";
+import { type AIEditorRoot } from "../aicore/model/aieditorroot.js";
+import { type AIReviewCheckRun } from "./model/aireviewcheckrun.js";
+import { AIRunResult } from "../aicore/model/airunresult.js";
+import { AICheckRunSingleRootResult } from "./model/aichecksinglerootresult.js";
 export declare class AIReviewCoreEditing extends ContextPlugin {
 	/**
 	* @inheritDoc
@@ -41,15 +45,32 @@ export declare class AIReviewCoreEditing extends ContextPlugin {
 	*/
 	afterInit(): void;
 	/**
-	* Returns the data (as string and flat list of container elements) and version of the current document.
+	* Collects the document data (`content`, per-block `elements`, `roots`, `documentVersion`) sent to the AI
+	* endpoint. When `options.roots` is provided, only the listed roots are included; when omitted, every
+	* non-`$graveyard` root across every editor in the `Context` is included.
 	*
-	* This method also applied `data-id` attributes to all elements that are direct parents of text nodes.
-	* These attributes are used by AI API to determine that given element can be changed.
+	* Throws `ai-reviewcoreediting-empty-roots` for an explicitly empty `roots` array, and
+	* `ai-reviewcoreediting-root-not-found` (with `{ channelId, rootName }` on the error data) for any entry
+	* that does not resolve to a live, non-`$graveyard` root.
+	*/
+	getDocumentData(options?: {
+		roots?: Array<AIEditorRoot>;
+	}): AIDocumentData;
+	/**
+	* Runs an already-constructed check-run and returns an
+	* {@link module:ai/aicore/model/airunresult~AIRunResult}. On success the result holds one
+	* {@link module:ai/aireviewcore/model/aichecksinglerootresult~AICheckRunSingleRootResult} per root the check-run
+	* covered; on whole-run failures (transport / parse errors or abort) `results` stays empty and the outcome
+	* is described by `status` and `error`.
 	*
-	* Additionally, each element is converted from model to HTML string in the context of the entire structure
-	* to ensure that the conversion is accurate (e.g. table cells need to be inside a table row, which needs to be inside a table).
+	* @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 checkRun The check-run to execute.
+	* @param options `signal` for aborting the run.
 	*/
-	getDocumentData(): AIDocumentData;
+	runCheck(checkRun: AIReviewCheckRun, options?: {
+		signal?: AbortSignal;
+	}): Promise<AIRunResult<AICheckRunSingleRootResult>>;
 	/**
 	* Compares two pieces of content, calculates operations, groups them and returns diffed content
 	* and additional data for each group.
@@ -112,7 +133,14 @@ export declare class AIReviewCoreEditing extends ContextPlugin {
 	diffContent(editor: Editor, contentInitial: string, contentNew: string, asSingleGroup?: boolean): Array<AIReviewCoreChangeData>;
 	markChangePositionInEditorContent(changes: Array<AIReviewCheckResultChange>, documentData: AIDocumentData): void;
 	clearAllMarkers(): void;
+	/**
+	* Locks all context editors read-only during a review. Programmatic accept/apply still works. Released by
+	* {@link #switchToEdit}.
+	*/
 	switchToReadOnly(): void;
+	/**
+	* Releases the read-only lock added by {@link #switchToReadOnly} from all editors attached to the context.
+	*/
 	switchToEdit(): void;
 	applyChange(changeIds: Array<string>, aiSource?: string | null): void;
 	rejectChange(changeId: string): void;
@@ -178,6 +206,14 @@ export type AIDocumentData = {
 	*/
 	content: string;
 	elements: Map<string, AIDocumentDataElement>;
+	/**
+	* Every root this document data covers, in the natural document iteration order (editor order ×
+	* `editor.model.document.getRoots()` order). When
+	* {@link module:ai/aireviewcore/aireviewcoreediting~AIReviewCoreEditing#getDocumentData} was called
+	* without a `roots` filter, this is every non-`$graveyard` root across every editor in the context.
+	* When called with a filter, this is exactly the roots that appear in it.
+	*/
+	roots: Array<AIEditorRoot>;
 };
 export type AIDiffResult = {
 	content: string;
@@ -208,6 +244,7 @@ export type AIReviewCoreChangeRange = {
 export type AIReviewCoreChangeData = AIReviewCoreChangeRange & {
 	content: () => string;
 	context: () => string;
+	wrapperTag?: string;
 };
 export type AIReviewCoreChangeMarkerClickedEvent = {
 	name: "changeMarkerClicked";

package/dist/aireviewcore/aireviewcoreui.d.ts

@@ -12,12 +12,6 @@ import { type AIReviewCheckResultChange } from "./model/aireviewcheckresultchang
 import { AITabs } from "../aitabs/aitabs.js";
 import { type AIReviewCoreView } from "./ui/aireviewcoreview.js";
 export declare const AI_REVIEW_MODE_UI_EVENT_NAMES: readonly ["getReviewCheckList", "runReviewCheck", "abortReviewStream", "toggleDiff", "acceptAllChanges", "leaveReviewCoreResultList", "activateChange", "deactivateChange", "acceptChange", "dismissChange", "learnMore", "finishReview", "retryReview"];
-import "../../theme/common/aiheader.css";
-import "../../theme/common/ainotification.css";
-import "../../theme/common/aibutton.css";
-import "../../theme/common/aicolor.css";
-import "../../theme/common/aitrackchanges.css";
-import "../../theme/aireviewcore/aireviewcore.css";
 export declare abstract class AIReviewCoreUI extends ContextPlugin {
 	/**
 	* @inheritDoc
@@ -52,14 +46,13 @@ export declare abstract class AIReviewCoreUI extends ContextPlugin {
 	* Shows the result of a review check run.
 	*/
 	showCheckRunResults(data: AIReviewCheckRunUpdatedEvent["args"][0]): void;
-	showCheckRunResult(result: {
-		contentDiffed: string;
-		id: string;
-	}): void;
+	showCheckRunResult(result: AIReviewCheckResultChange): void;
 	showGeneralResultsErrorView(): void;
 	showGeneralReviewCoreErrorView(errorMessage?: string): void;
 	showChunkErrorView(): void;
+	showUnsupportedInlineChangeView(): void;
 	setCheckResultTitle(title: string, subtitle?: string): void;
+	setAcceptAllEnabled(isEnabled: boolean): void;
 	setActiveStateInResults(id: string): void;
 	resetActiveStateInResults(): void;
 	updateChangeState(id: string, status: AIReviewCheckResultChange["status"]): void;

package/dist/aireviewcore/model/aichecksinglerootresult.d.ts

@@ -0,0 +1,22 @@
+/**
+* @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/aireviewcore/model/aichecksinglerootresult
+* @publicApi
+*/
+import { type AIRunChangeData } from "../../aicore/aigateway.js";
+import { AIRunSingleRootResult } from "../../aicore/model/airunsinglerootresult.js";
+/**
+* The result of a single AI check run, scoped to a single root. Adds `affectedBlocks` on top of
+* {@link module:ai/aicore/model/airunsinglerootresult~AIRunSingleRootResult}.
+*/
+export declare class AICheckRunSingleRootResult extends AIRunSingleRootResult {
+	/**
+	* The list of top-level blocks that were affected by the run. Returns a fresh copy on every call —
+	* mutating the returned array does not affect the result's internal state.
+	*/
+	get affectedBlocks(): ReadonlyArray<AIRunChangeData>;
+	set affectedBlocks(value: Array<AIRunChangeData>);
+}

package/dist/aireviewcore/model/aireviewcheckresultchange.d.ts

@@ -6,6 +6,7 @@
 * @module ai/aireviewcore/model/aireviewcheckresultchange
 */
 import { type ObservableMixinConstructor } from "@ckeditor/ckeditor5-utils";
+import { type Editor } from "@ckeditor/ckeditor5-core";
 import { type Operation } from "@ckeditor/ckeditor5-engine";
 import { type AIReviewCheckResult } from "./aireviewcheckresult.js";
 import { type AIReviewCoreChangeData } from "../aireviewcoreediting.js";
@@ -27,6 +28,11 @@ export declare class AIReviewCheckResultChange extends AIReviewCheckResultChange
 	*/
 	readonly parent: AIReviewCheckResult;
 	/**
+	* The editor this change targets (where accepting it writes). Used to gate accepting the change by that
+	* editor's read-only state.
+	*/
+	readonly editor: Editor;
+	/**
 	* The status of the change.
 	*
 	* @observable
@@ -47,8 +53,13 @@ export declare class AIReviewCheckResultChange extends AIReviewCheckResultChange
 	/**
 	* Creates a new instance of the AIReviewCheckResult.
 	*/
-	constructor(id: string, data: AIReviewCoreChangeData, parent: AIReviewCheckResult);
+	constructor(id: string, data: AIReviewCoreChangeData, parent: AIReviewCheckResult, editor: Editor);
 	get contentDiffed(): string;
+	/**
+	* Semantic element the preview should render this change's content under (an inline root's own element, for example
+	* `h2`), or `undefined` for a block root, where the default `div` host is used.
+	*/
+	get wrapperTag(): string | undefined;
 	get operations(): ReadonlyArray<Operation>;
 	get operationsIsolated(): ReadonlyArray<Operation>;
 }

package/dist/aireviewcore/model/aireviewcheckrun.d.ts

@@ -11,6 +11,7 @@ import { AIReviewCheckResultChange } from "./aireviewcheckresultchange.js";
 import { type AIReviewCheck } from "./aireviewcheck.js";
 import { type AIReviewCoreChangeData, type AIDocumentData } from "../aireviewcoreediting.js";
 import { type AIConnector } from "../../aicore/aiconnector.js";
+import { type AIContextRef } from "../../aicore/model/aicontextref.js";
 import { type Editor } from "@ckeditor/ckeditor5-core";
 declare const AIReviewCheckRunBase: ObservableMixinConstructor;
 /**
@@ -29,16 +30,24 @@ export declare abstract class AIReviewCheckRun extends AIReviewCheckRunBase {
 	* The call ID returned by the AI API when the check run is started.
 	*/
 	callId?: string;
-	constructor(documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, params?: Array<string>, args?: Record<string, any>);
+	constructor(documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, params?: Array<string>, args?: Record<string, any>, contexts?: Array<AIContextRef>);
 	/**
 	* Returns the document data obtained at the time of the check run.
 	*/
 	get documentData(): AIDocumentData;
 	/**
+	* The check this run was constructed against.
+	*/
+	get sourceCheck(): AIReviewCheck;
+	/**
 	* Returns the number of successfully processed results.
 	*/
 	get processedResultsCount(): number;
 	/**
+	* Whether a proposed change was dropped because it would introduce block content into an inline root.
+	*/
+	get hasUnsupportedInlineChange(): boolean;
+	/**
 	* Returns the check title.
 	*/
 	get title(): string;
@@ -123,6 +132,7 @@ export type AIReviewCheckResultAddedEvent = {
 		result: AIReviewCheckResult;
 		source: AIReviewCheckRun;
 		editor: Editor;
+		rootName: string;
 	}];
 };
 export type AIReviewCheckResultReadyEvent = {

package/dist/aireviewcore/types.d.ts

@@ -5,6 +5,7 @@
 /**
 * @module ai/aireviewcore/types
 */
+import { type AIContextRef } from "../aicore/model/aicontextref.js";
 export interface AIReviewCheckBaseDefinition {
 	id: string;
 	commandId: string;
@@ -20,7 +21,12 @@ export interface AIReviewCheckDefinition extends AIReviewCheckBaseDefinition {
 }
 export interface AIReviewCheckExtraDefinition extends AIReviewCheckBaseDefinition {
 	isExtra: true;
-	prompt: string;
+	prompt?: string;
+	/**
+	* @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.
+	*/
+	context?: AIContextRef;
 	model?: string;
 }
 export type AIReviewCheckOptions = {

package/dist/aireviewcore/ui/aireviewcoreballoonsuggestionview.d.ts

@@ -9,8 +9,6 @@ import { type Locale } from "@ckeditor/ckeditor5-utils";
 import { BalloonPanelView, type BodyCollection } from "@ckeditor/ckeditor5-ui";
 import { AIReviewCoreReviewCheckListItemResultsView } from "./aireviewcorechecklistitemresultview.js";
 import type { AIReviewCheckResultChange } from "../model/aireviewcheckresultchange.js";
-import "../../../theme/aireviewcore/aireviewcore-balloon-panel-suggestion.css";
-import "../../../theme/aireviewcore/aireviewcore-check-run-result.css";
 export declare class AIReviewCoreBalloonSuggestionItemView extends BalloonPanelView {
 	/**
 	* Creates an instance of the review core suggestion panel view.

package/dist/aireviewcore/ui/aireviewcorechecklistitemresultview.d.ts

@@ -36,8 +36,15 @@ export declare class AIReviewCoreReviewCheckListItemResultsView extends View {
 	status: AIReviewCheckResultChange["status"];
 	readonly id: string;
 	constructor(locale: Locale, id: string);
+	override render(): void;
 	setItemAsActive(): void;
 	setItemAsInactive(): void;
+	/**
+	* Sets the previewed content, rendering it under `tag` (an inline root's semantic element, for example `h2`) instead
+	* of the default `div`. The host element is swapped in place when the tag changes so the preview matches the editable
+	* and shares its `ck-content` styling. The CSS classes are preserved.
+	*/
+	updateResponseContent(html: string, tag?: string): void;
 }
 export type AIReviewCoreDeactivateChangeEventData = {
 	origin: "panel";

package/dist/aireviewcore/ui/aireviewcorecustomcheckview.d.ts

@@ -5,7 +5,7 @@
 /**
 * @module ai/aireviewcore/ui/aireviewcorecustomcheckview
 */
-import { type Locale, KeystrokeHandler, FocusTracker } from "@ckeditor/ckeditor5-utils";
+import { KeystrokeHandler, FocusTracker } from "@ckeditor/ckeditor5-utils";
 import { View, ButtonView, LabeledFieldView, FocusCycler } from "@ckeditor/ckeditor5-ui";
 import { AIReviewCorePromptInputView } from "./aireviewcorepromptinputview.js";
 export declare class AIReviewCoreCustomCheckView extends View {
@@ -23,32 +23,14 @@ export declare class AIReviewCoreCustomCheckView extends View {
 	readonly focusCycler: FocusCycler;
 	prompt: string;
 	modelId: string;
-	/**
-	* Determines the model display mode:
-	* * 'selector' – shows the dropdown,
-	* * 'name' – shows the model name,
-	* * 'hidden' – hides both.
-	*
-	* @observable
-	*/
-	modelDisplayMode: "selector" | "name" | "hidden";
-	/**
-	* The name of the currently active model.
-	*
-	* @observable
-	*/
-	activeModelName: string | null;
 	submitButtonView: ButtonView;
 	cancelButtonView: ButtonView;
 	promptInputView: LabeledFieldView<AIReviewCorePromptInputView>;
 	actionsFooterView: View;
-	constructor(locale: Locale, check: AIReviewCoreCustomCheckView["_check"], hideModels?: boolean);
 	/**
 	* @inheritDoc
 	*/
 	override render(): void;
-	get modelDefaultValue(): string;
-	get modelDefaultLabel(): string;
 	/**
 	* Resets the form to its default state.
 	*/