@ckeditor/ckeditor5-ai 48.4.0 → 48.5.0-alpha.1

package/dist/aiactions/aiactions.d.ts

@@ -13,7 +13,7 @@ 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";
+import { DocumentChanges } from "../aisdk/documentchanges.js";
 /**
 * @experimental **Experimental:** Some methods of this class are production-ready but experimental and may change
 * in minor releases without the standard deprecation policy. Check the changelog for migration guidance.
@@ -22,7 +22,7 @@ export declare class AIActions extends Plugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, Dialog, AIEditing, AIBalloon, DocumentCompare]>;
+	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, Dialog, AIEditing, AIBalloon, DocumentChanges]>;
 	/**
 	* @inheritDoc
 	*/

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

@@ -8,8 +8,7 @@
 import { AIInteraction, type AIInteractionOptions } from "../../aicore/model/aiinteraction.js";
 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 { AIContext, type AIContextItem } from "../../aicore/model/aicontext.js";
 import type { Editor } from "@ckeditor/ckeditor5-core";
 import { AIActionsReply } from "./aiactionsreply.js";
 export declare class AIActionsInteraction extends AIInteraction {
@@ -38,10 +37,10 @@ export declare class AIActionsInteraction extends AIInteraction {
 	*/
 	readonly model?: string;
 	/**
-	* Context references attached to the request. Combines the global `ai.defaultContext` entries that apply to the
+	* The context 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>;
+	readonly context: AIContext;
 	hasError: boolean;
 	/**
 	* Set when this interaction fires `interactionStopped` (see {@link module:ai/aicore/model/aiinteraction~AIInteraction#stop}).

package/dist/aichat/aichatcontroller.d.ts

@@ -14,7 +14,7 @@ import { type AIInteractionReplyCreatedEvent, type AIToolData } from "../aicore/
 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 { DocumentChanges } from "../aisdk/documentchanges.js";
 import { type AIChatFeedCustomElementView } from "./ui/feed/aichatfeedcustomelementview.js";
 /**
 * Implements integration layer between AI Chat feature UI and logic.
@@ -38,7 +38,7 @@ export declare class AIChatController extends ContextPlugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, DocumentCompare, AICore]>;
+	static get requires(): PluginDependenciesOf<[AIConnector, AIErrorSink, DocumentChanges, AICore]>;
 	/**
 	* @inheritDoc
 	*/
@@ -148,6 +148,15 @@ export declare class AIChatController extends ContextPlugin {
 	*/
 	removeSelectionFromChatContext(): void;
 	/**
+	* Adds a reference to an admin-managed context from the Context Library to the conversation context.
+	*
+	* @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 libraryContextId The identifier of the context to attach.
+	* @param [label] The label displayed on the context chip. Defaults to `libraryContextId`.
+	*/
+	addLibraryContextToChatContext(libraryContextId: string, label?: string): void;
+	/**
 	* Moves focus to the AI Chat prompt input field.
 	*
 	* @experimental **Experimental:** This is a production-ready API but may change in minor releases

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

@@ -43,6 +43,9 @@ export declare class AIChatContext extends AIContext {
 	* (notably by `AIReply`) to route modifications back to the source editor and root; non-document content items
 	* are turned into one context item each.
 	*
+	* The context references carried by the message are restored as pending items, so they keep being attached to
+	* every following message the way they were before the conversation was read back from history.
+	*
 	* 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 resolve a per-document outdated reason
@@ -80,11 +83,9 @@ export declare class AIChatContext extends AIContext {
 	*/
 	removeFromContext(uiId: string): void;
 	/**
-	* 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.
+	* Clears all pending context items, then re-adds the current document and the context references
+	* (`type: 'context'`) as read-only and hidden pending items, so that they are sent with the following messages.
+	* A context reference that is already read-only and hidden is left untouched.
 	*
 	* @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.
@@ -93,9 +94,9 @@ export declare class AIChatContext extends AIContext {
 	/**
 	* 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.
+	* A context reference never becomes a conversation item. It stays pending for as long as it is attached, which is
+	* what keeps it sent with every message and reported as being in context, so a second record of it could only go
+	* stale once it stops being attached.
 	*
 	* @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.
@@ -171,6 +172,15 @@ export declare class AIChatContext extends AIContext {
 	*/
 	removeSelectionFromContext(): void;
 	/**
+	* Adds a reference to an admin-managed context from the Context Library to the pending context items.
+	*
+	* @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 libraryContextId The identifier of the context to attach.
+	* @param [label] The label displayed on the context chip. Defaults to `libraryContextId`.
+	*/
+	addLibraryContextToContext(libraryContextId: string, label?: string): void;
+	/**
 	* Adds a URL to the context by uploading it and creating a context item.
 	* This method handles URL upload with proper error handling and progress tracking.
 	*

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

@@ -150,6 +150,10 @@ export declare class AIChatConversation extends AIChatConversationBase {
 	*/
 	addToolItemToContext(item: AIToolContextItem): void;
 	/**
+	* Adds a reference to an admin-managed context from the Context Library to the context.
+	*/
+	addLibraryContextToContext(libraryContextId: string, label?: string): void;
+	/**
 	* Adds a resource from a source provider to the context.
 	*/
 	addResourceToContext(source: AIContextProvider, resource: AIContextResource): void;

package/dist/aicore/aiconnector.d.ts

@@ -5,7 +5,7 @@
 import { type Editor, type Context, ContextPlugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
 import { CloudServices } from "@ckeditor/ckeditor5-cloud-services";
 import { type AIContextRequestPart, type AIContextItemType } from "./model/aicontext.js";
-import { type AIContextRef, type AIContextRefRequestData } from "./model/aicontextref.js";
+import { type AIContextRefRequestData } from "./model/aicontextref.js";
 import { type AICapabilitiesRequestData } from "./model/aicapabilities.js";
 import type { AIActionsNames } from "../aiactions/aiactions.js";
 import { type AIEditorConfig } from "./utils/geteditorconfig.js";
@@ -475,7 +475,7 @@ export type AIConnectorExecuteCustomActionData = {
 	message?: string;
 	model: string;
 	outputFormat: "plainText" | "html";
-	contexts?: Array<AIContextRef>;
+	contexts?: Array<AIContextRefRequestData>;
 };
 export type AIConnectorExecuteActionData = {
 	actionName: AIActionsNames;
@@ -483,7 +483,7 @@ export type AIConnectorExecuteActionData = {
 	args?: {
 		language?: string;
 	};
-	contexts?: Array<AIContextRef>;
+	contexts?: Array<AIContextRefRequestData>;
 };
 export type AIConnectorSystemReviewData = {
 	reviewName: string;
@@ -491,13 +491,13 @@ export type AIConnectorSystemReviewData = {
 	args?: {
 		language?: string;
 	};
-	contexts?: Array<AIContextRef>;
+	contexts?: Array<AIContextRefRequestData>;
 };
 export type AIConnectorCustomReviewData = {
 	content: string;
 	prompt?: string;
 	model: string;
-	contexts?: Array<AIContextRef>;
+	contexts?: Array<AIContextRefRequestData>;
 };
 export type AIConnectorProcessDocumentContentDocument = {
 	type: "document";
@@ -512,7 +512,7 @@ export type AIConnectorProcessDocumentData = {
 	prompt: string;
 	model: string;
 	capabilities?: AICapabilitiesRequestData;
-	contexts?: Array<AIContextRef>;
+	contexts?: Array<AIContextRefRequestData>;
 };
 export type AIConnectorProcessDocumentReply = {
 	documents: Array<{

package/dist/aicore/aierrorreporter.d.ts

@@ -7,12 +7,39 @@
 * @publicApi
 */
 import { ContextPlugin } from "@ckeditor/ckeditor5-core";
+import { type AICoreErrorSeverity, type AICoreErrorType } from "./errors/aicoreerror.js";
 /**
 * Payload of the {@link module:ai/aicore/aierrorreporter~AIErrorSinkErrorEvent} sink event.
+*
+* Error reporting services serialize only `name`, `message` and `stack` of an `Error`, so everything a
+* reported {@link module:ai/aicore/errors/aicoreerror~AICoreError} carries as its own properties is
+* flattened here. A subscriber can therefore classify and forward the failure without inspecting the
+* error itself.
 */
 export interface AIErrorSinkEventData {
 	error: unknown;
 	component: string;
+	/**
+	* {@link module:ai/aicore/errors/aicoreerror~AICoreError#code Code} of the reported error, for example
+	* `'ai-chat-file-upload-failed'`. `undefined` for errors that are not an `AICoreError`.
+	*/
+	code?: string;
+	/**
+	* {@link module:ai/aicore/errors/aicoreerror~AICoreError#type Classification} of the reported error.
+	* Use it to skip the failures that are not actionable telemetry: `'user'` (surfaced via UI) and
+	* `'network'` (transient). `undefined` for errors that are not an `AICoreError`.
+	*/
+	type?: AICoreErrorType;
+	/**
+	* {@link module:ai/aicore/errors/aicoreerror~AICoreError#severity Severity} of the reported error.
+	* `undefined` for errors that are not an `AICoreError`.
+	*/
+	severity?: AICoreErrorSeverity;
+	/**
+	* Metadata carried by the reported {@link module:ai/aicore/errors/aicoreerror~AICoreError#context error}
+	* merged with the catch-site {@link module:ai/aicore/aierrorreporter~AIErrorReporterOptions#context context},
+	* the latter winning on key conflicts. `undefined` when neither is present.
+	*/
 	context?: Record<string, unknown>;
 }
 /**
@@ -20,7 +47,8 @@ export interface AIErrorSinkEventData {
 */
 export interface AIErrorReporterOptions {
 	/**
-	* Catch-site context (operation labels, interaction/conversation IDs, etc.).
+	* Catch-site context (operation labels, interaction/conversation IDs, etc.). Merged over the
+	* context of the reported error.
 	*/
 	context?: Record<string, unknown>;
 }

package/dist/aicore/aigateway.d.ts

@@ -7,7 +7,7 @@
 * @publicApi
 */
 import { ContextPlugin, type PluginDependenciesOf, type Editor } from "@ckeditor/ckeditor5-core";
-import { DocumentCompare } from "@ckeditor/ckeditor5-collaboration-core";
+import { DocumentChanges } from "../aisdk/documentchanges.js";
 import { AICore } from "./aicore.js";
 import { type AIModels } from "./model/aimodels.js";
 import { AIResponseApplier } from "./pipeline/airesponseapplier.js";
@@ -81,7 +81,7 @@ export declare class AIGateway extends ContextPlugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[DocumentCompare, AICore]>;
+	static get requires(): PluginDependenciesOf<[DocumentChanges, AICore]>;
 	/**
 	* The shared model registry. Exposed here so headless gateways are self-sufficient — integrators can
 	* discover and resolve models (`getAvailableModels()`, `getModel()`, `resolveModel()`, …) without

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

@@ -26,7 +26,8 @@ export type AIContextRef = {
 * The request shape of a {@link module:ai/aicore/model/aicontextref~AIContextRef context reference}.
 *
 * The AI service expects a `type` discriminator, as a reference can share a request array with entries of other
-* types. It is added when the request is built, so it is not part of the reference shape the integrator provides.
+* types. It is added by {@link module:ai/aicore/model/aicontext~AIContext} when the request payload is built, so it is
+* not part of the reference shape the integrator provides.
 *
 * @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.

package/dist/aicore/utils/geteditorconfig.d.ts

@@ -24,6 +24,7 @@ import { type MultiLevelListConfig } from "@ckeditor/ckeditor5-list-multi-level"
 import { type StyleConfig } from "@ckeditor/ckeditor5-style";
 import { type TableConfig } from "@ckeditor/ckeditor5-table";
 import { type MediaEmbedConfig } from "@ckeditor/ckeditor5-media-embed";
+import { type GeneralHtmlSupportConfig } from "@ckeditor/ckeditor5-html-support";
 /**
 * Builds a compact, serializable snapshot of the editor's feature capabilities for the AI agent.
 *
@@ -53,6 +54,7 @@ export interface AIEditorConfig {
 	fontFamily?: FontFamilyConfig;
 	fontSize?: FontSizeConfig;
 	footnotes?: FootnotesConfig;
+	htmlSupport?: GeneralHtmlSupportConfig;
 	heading?: HeadingConfig;
 	highlight?: HighlightConfig;
 	image?: ImageConfig;

package/dist/aicore/utils/getoperationsfordocumentsuggestions.d.ts

@@ -5,16 +5,16 @@
 /**
 * @module ai/aicore/utils/getoperationsfordocumentsuggestions
 */
-import { type DocumentCompare, type DocumentCompareOptions } from "@ckeditor/ckeditor5-collaboration-core";
+import { type DocumentChanges, type DocumentChangesOptions } from "../../aisdk/documentchanges.js";
 import { type Operation } from "@ckeditor/ckeditor5-engine";
 import type { DocumentSuggestions } from "./builddocumentsuggestionsmap.js";
 /**
 * Returns operations that need to be applied to the editor documents to apply the AI reply.
 * The result is a `Map` keyed by `documentId`, each entry holding the operations for that document.
 */
-export declare function getOperationsForDocumentSuggestions({ documentSuggestions, transform, documentCompare, documentCompareOptions }: {
+export declare function getOperationsForDocumentSuggestions({ documentSuggestions, transform, documentChanges, documentChangesOptions }: {
 	documentSuggestions: Map<string, DocumentSuggestions>;
 	transform: boolean;
-	documentCompare: DocumentCompare;
-	documentCompareOptions: DocumentCompareOptions;
+	documentChanges: DocumentChanges;
+	documentChangesOptions: DocumentChangesOptions;
 }): Map<string, Array<Operation>>;

package/dist/aicore/utils/markoperationsasai.d.ts

@@ -6,10 +6,8 @@
 * @module ai/aicore/utils/markoperationsasai
 */
 import type { Operation } from "@ckeditor/ckeditor5-engine";
-/**
-* Identifiers used by built-in AI features when tagging the operations they produce.
-*/
-export type AIOperationSource = "chat" | "quickActions" | "api" | "review" | "translate" | (string & {});
+import type { AIOperationSource } from "@ckeditor/ckeditor5-collaboration-core";
+export type { AIOperationSource };
 /**
 * Sets the AI source identifier on a list of operations. After this call, every non-no-op operation has its
 * `_aiSource` field set to `source` and is preserved through collaborative transmission.

package/dist/aireviewcore/aireviewcoreediting.d.ts

@@ -8,7 +8,7 @@
 import { InsertOperation, MarkerOperation, ModelDocumentFragment, ModelPosition, ModelRange, type Operation } from "@ckeditor/ckeditor5-engine";
 import { type Emitter } from "@ckeditor/ckeditor5-utils";
 import { ContextPlugin, Editor, type Context, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
-import { DocumentCompare } from "@ckeditor/ckeditor5-collaboration-core";
+import { DocumentChanges } from "../aisdk/documentchanges.js";
 import { type AIReviewCheckResultChange } from "./model/aireviewcheckresultchange.js";
 import { AIEditing } from "../aicore/aiediting.js";
 import { type AIEditorRoot } from "../aicore/model/aieditorroot.js";
@@ -19,7 +19,7 @@ export declare class AIReviewCoreEditing extends ContextPlugin {
 	/**
 	* @inheritDoc
 	*/
-	static get requires(): PluginDependenciesOf<[DocumentCompare, AIEditing]>;
+	static get requires(): PluginDependenciesOf<[DocumentChanges, AIEditing]>;
 	/**
 	* @inheritDoc
 	*/

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

@@ -11,7 +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 { AIContext } from "../../aicore/model/aicontext.js";
 import { type Editor } from "@ckeditor/ckeditor5-core";
 declare const AIReviewCheckRunBase: ObservableMixinConstructor;
 /**
@@ -30,7 +30,7 @@ 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>, contexts?: Array<AIContextRef>);
+	constructor(documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, params?: Array<string>, args?: Record<string, any>, context?: AIContext);
 	/**
 	* Returns the document data obtained at the time of the check run.
 	*/

package/dist/aireviewmode/model/aireviewcustomcheckrun.d.ts

@@ -9,13 +9,13 @@ import { AIReviewCheckRun } from "../../aireviewcore/model/aireviewcheckrun.js";
 import { type AIConnector } from "../../aicore/aiconnector.js";
 import { type AIDocumentData } from "../../aireviewcore/aireviewcoreediting.js";
 import { type AIReviewCheck } from "../../aireviewcore/model/aireviewcheck.js";
-import { type AIContextRef } from "../../aicore/model/aicontextref.js";
+import { type AIContext } from "../../aicore/model/aicontext.js";
 /**
 * Represents a single custom review check
 * ({@link module:ai/aireviewmode/model/aireviewcheckcustom~AIReviewCheckCustom}) run and its results.
 */
 export declare class AIReviewCustomCheckRun extends AIReviewCheckRun {
-	constructor(prompt: string | undefined, model: string, documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, contexts?: Array<AIContextRef>);
+	constructor(prompt: string | undefined, model: string, documentData: AIDocumentData, sourceCheck: AIReviewCheck, connector: AIConnector, context?: AIContext);
 	/**
 	* @inheritDoc
 	*/

package/dist/aisdk/dataidassigner.d.ts

@@ -0,0 +1,20 @@
+/**
+* @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/aisdk/dataidassigner
+*/
+import { type Editor } from "@ckeditor/ckeditor5-core";
+import { type ViewDocumentFragment, type ViewElement } from "@ckeditor/ckeditor5-engine";
+/**
+* Assigns a unique `data-id` to the structural view elements that lack one — container, empty and raw elements, plus
+* any element containing an id-bearing descendant (skipping `<br>`). Existing ids are preserved.
+*/
+export declare class DataIdAssigner {
+	constructor(editor: Editor);
+	/**
+	* Assigns the missing `data-id`s across the given view fragment (or element).
+	*/
+	assign(view: ViewElement | ViewDocumentFragment): void;
+}

package/dist/aisdk/documentchanges.d.ts

@@ -0,0 +1,165 @@
+/**
+* @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/aisdk/documentchanges
+*/
+import { ContextPlugin, Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { ModelPosition, type ModelWriter, type ModelDocumentFragment, type ModelElement, type Operation } from "@ckeditor/ckeditor5-engine";
+import { DocumentChangesUtils } from "./documentchangesutils.js";
+export declare const DATA_ID_MODEL_ATTRIBUTE = "$elementId";
+export declare const DATA_ID_VIEW_ATTRIBUTE = "data-id";
+/**
+* The `DocumentChanges` plugin provides utilities to compare two documents or documents fragments, and provide set of operations
+* which need to be executed to transform one document into the other.
+*/
+export declare class DocumentChanges extends ContextPlugin {
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "DocumentChanges";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	static get requires(): PluginDependenciesOf<[DocumentChangesUtils]>;
+	init(): Promise<void>;
+	get editor(): Editor;
+	/**
+	* Compares two HTML strings and returns the operations that transform `dataBefore` into `dataAfter`.
+	*
+	* @param dataBefore The HTML to transform from.
+	* @param dataAfter The HTML to transform into.
+	* @param options Diffing options.
+	* @returns Operations that need to be applied to transform `dataBefore` into `dataAfter`.
+	*/
+	getDiff(dataBefore: string, dataAfter: string, options?: DocumentChangesOptions): Array<Operation>;
+	/**
+	* Returns `true` if given `operation` is an operation that marks a content to be removed. This kind of operations can be
+	* returned by {@link module:ai/aisdk/documentchanges~DocumentChanges#getOperations} if `markedDeletions` mode is enabled.
+	*
+	* @param operation
+	*/
+	isMarkedRemoveOperation(operation: Operation): boolean;
+	/**
+	* Applies the given operations (for example, the result of comparing two documents) to the model.
+	*
+	* Beyond applying the operations, this method reproduces the marker bookkeeping that the editing pipeline normally
+	* performs, so that existing markers behave the same as during regular editing:
+	*
+	* * markers affected by a move or merge are anchored, so they can be restored on undo;
+	* * marker operations have their `oldRange` reconciled with the live marker, as operations coming from a comparison
+	* have it set to `null`.
+	*
+	* Must be called inside a model change block; the operations are added to the given `writer`'s batch.
+	*
+	* @param writer Writer of the change block the operations are applied within.
+	* @param operations Operations to apply, in order.
+	*/
+	applyOperations(writer: ModelWriter, operations: Array<Operation>): void;
+}
+export interface DocumentChangesOptions {
+	anchor?: string | ModelPosition;
+	markDeletions: boolean;
+	/**
+	* The editor whose model/schema should be used for parsing and for resolving a string `anchor` (e.g. multi-root root names).
+	*/
+	targetEditor?: Editor;
+}
+export interface InsertOperationData {
+	type: "insert";
+	path: Path;
+	tokens: Array<ModelToken>;
+}
+export interface RemoveOperationData {
+	type: "remove";
+	path: Path;
+	howMany: number;
+}
+export interface SplitOperationData {
+	type: "split";
+	path: Path;
+}
+export interface MergeOperationData {
+	type: "merge";
+	path: Path;
+}
+export interface RenameOperationData {
+	type: "rename";
+	path: Path;
+	oldName: string;
+	newName: string;
+}
+export interface AttributeOperationData {
+	type: "attribute";
+	path: Path;
+	howMany: number;
+	key: string;
+	oldValue: string;
+	newValue: string;
+}
+export interface MarkerOperationData {
+	type: "marker";
+	name: string;
+	range: null | {
+		start: Path;
+		end: Path;
+	};
+}
+export interface UnwrapOperationData {
+	type: "unwrap";
+	path: Path;
+	howMany: number;
+}
+export interface WrapOperationData {
+	type: "wrap";
+	token: ModelElementToken;
+	range: {
+		start: Path;
+		end: Path;
+	};
+}
+export interface MarkedRemoveData {
+	type: "markedRemove";
+	range: {
+		start: Path;
+		end: Path;
+	};
+}
+export type OperationData = InsertOperationData | RemoveOperationData | SplitOperationData | MergeOperationData | RenameOperationData | AttributeOperationData | MarkerOperationData | UnwrapOperationData | WrapOperationData | MarkedRemoveData;
+export type ModelToken = ModelElementToken | ModelTextToken;
+export interface ModelElementToken {
+	type: "element";
+	element: ModelElement;
+	elementId: string;
+	/**
+	* Elements category.
+	*
+	* Describes how the element behaves and how it can change. It is used when comparing lists of model tokens to create a better diff.
+	*
+	* * `block` - elements like paragraphs, lists, or headings. Can be renamed. Can be created by splitting. Can be removed by merging.
+	* Its contents can be "moved around" by splitting or merging.
+	*
+	* * `container` - elements like blockquote. Cannot be renamed. Can be created by wrapping. Can be removed by unwrapping. Can be
+	* "resized" by having other elements be moved into or out of them.
+	*
+	* * `solid` - limit-like elements like table or image. Cannot be renamed, split or merged. Can be added by insertion and removed by
+	* deletion. If added or removed, all their content also should be treated as added or removed.
+	*/
+	category: "block" | "container" | "solid";
+	isStart: boolean;
+	limitId: string;
+}
+export interface ModelTextToken {
+	type: "text";
+	data: string;
+	parent: ModelElement | ModelDocumentFragment;
+	offset: number;
+	limitId: string;
+}
+export type Path = Array<number>;

package/dist/aisdk/documentchangesutils.d.ts

@@ -0,0 +1,15 @@
+/**
+* @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/aisdk/documentchangesutils
+*/
+import { ContextPlugin } from "@ckeditor/ckeditor5-core";
+export declare class DocumentChangesUtils extends ContextPlugin {
+	static get pluginName(): "DocumentChangesUtils";
+	static override get isOfficialPlugin(): true;
+	static override get isPremiumPlugin(): true;
+	init(): void;
+	override destroy(): void;
+}