@ckeditor/ckeditor5-ai 48.2.0-alpha.7 → 48.3.0-alpha.0

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

@@ -1,84 +1,81 @@
 /**
- * @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/aicore/model/aimodels
- * @publicApi
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { type AIConnector, type AIModelData } from '../../aicore/aiconnector.js';
+* @module ai/aicore/model/aimodels
+* @publicApi
+*/
+import { type EmitterMixinConstructor, type Locale } from "@ckeditor/ckeditor5-utils";
+import { type AIConnector, type AIModelData } from "../../aicore/aiconnector.js";
+declare const AIModelsBase: EmitterMixinConstructor;
 /**
- * Configuration for AI models.
- */
+* Configuration for AI models.
+*/
 export interface AIModelsConfig {
-    /**
-     * Decides which model is selected by default across all AI features.
-     */
-    defaultModelId?: string;
-    /**
-     * Decides which models are visible in model selectors across all AI features.
-     */
-    displayedModels?: string | Array<string>;
-    /**
-     * Decides whether the model selector UI is visible across all AI features (Chat and Review Mode).
-     *
-     * When `true`:
-     * * If multiple models are available, the model selector dropdown is shown.
-     * * If only one model is available, the model name is displayed instead of the selector.
-     *
-     * When `false`, the model UI will not be shown no matter how many models are available.
-     *
-     * @default true
-     */
-    showModelSelector?: boolean;
+	/**
+	* Decides which model is selected by default across all AI features.
+	*/
+	defaultModelId?: string;
+	/**
+	* Decides which models are visible in model selectors across all AI features.
+	*/
+	displayedModels?: string | Array<string>;
+	/**
+	* Decides whether the model selector UI is visible across all AI features (Chat and Review Mode).
+	*
+	* When `true`:
+	* * If multiple models are available, the model selector dropdown is shown.
+	* * If only one model is available, the model name is displayed instead of the selector.
+	*
+	* When `false`, the model UI will not be shown no matter how many models are available.
+	*
+	* @default true
+	*/
+	showModelSelector?: boolean;
 }
-declare const AIModels_base: {
-    new (): import("@ckeditor/ckeditor5-utils").Emitter;
-    prototype: import("@ckeditor/ckeditor5-utils").Emitter;
-};
 /**
- * Stores the list of available AI models acquired from the AI connector.
- */
-export declare class AIModels extends /* #__PURE__ */ AIModels_base {
-    /**
-     * @inheritDoc
-     */
-    constructor({ connector, config, locale }: {
-        connector: AIConnector;
-        config?: AIModelsConfig;
-        locale: Locale;
-    });
-    /**
-     * Returns a list of available models.
-     */
-    getAll(): Promise<Array<AIModelData>>;
-    /**
-     * Returns a list of available models, which corresponds to {@link #getAll all models} narrowed down
-     * by the `ai.models.displayedModels` configuration.
-     *
-     * By default, only models marked with `recommended: true` are returned. However, models explicitly
-     * configured via `ai.models.displayedModels` are always included, even if not recommended.
-     *
-     * **Note:** `displayedModels` may include ids, names, and/or providers.
-     */
-    getAvailableModels(): Promise<Array<AIModelData>>;
-    /**
-     * Returns a specific AI model from among {@link #getAll all models} by its id.
-     *
-     * **Note:** `'auto'` id always matches the `'agent*'` model.
-     */
-    getModel(modelId?: string): Promise<AIModelData | null>;
-    /**
-     * Returns default AI model among the {@link #getAvailableModels available models} accounting for the
-     * `ai.models.defaultModelId` configuration.
-     *
-     * **Note**: If `'auto'` id was specified as `defaultModelId` in the configuration, it will match the `'agent*'` model.
-     */
-    getDefault(): Promise<AIModelData | null>;
-    /**
-     * Checks whether the given model is available among the {@link #getAvailableModels available models}.
-     */
-    isAvailable(model: AIModelData): Promise<boolean>;
+* Stores the list of available AI models acquired from the AI connector.
+*/
+export declare class AIModels extends AIModelsBase {
+	/**
+	* @inheritDoc
+	*/
+	constructor({ connector, config, locale }: {
+		connector: AIConnector;
+		config?: AIModelsConfig;
+		locale: Locale;
+	});
+	/**
+	* Returns a list of available models.
+	*/
+	getAll(): Promise<Array<AIModelData>>;
+	/**
+	* Returns a list of available models, which corresponds to {@link #getAll all models} narrowed down
+	* by the `ai.models.displayedModels` configuration.
+	*
+	* By default, only models marked with `recommended: true` are returned. However, models explicitly
+	* configured via `ai.models.displayedModels` are always included, even if not recommended.
+	*
+	* **Note:** `displayedModels` may include ids, names, and/or providers.
+	*/
+	getAvailableModels(): Promise<Array<AIModelData>>;
+	/**
+	* Returns a specific AI model from among {@link #getAll all models} by its id.
+	*
+	* **Note:** `'auto'` id always matches the `'agent*'` model.
+	*/
+	getModel(modelId?: string): Promise<AIModelData | null>;
+	/**
+	* Returns default AI model among the {@link #getAvailableModels available models} accounting for the
+	* `ai.models.defaultModelId` configuration.
+	*
+	* **Note**: If `'auto'` id was specified as `defaultModelId` in the configuration, it will match the `'agent*'` model.
+	*/
+	getDefault(): Promise<AIModelData | null>;
+	/**
+	* Checks whether the given model is available among the {@link #getAvailableModels available models}.
+	*/
+	isAvailable(model: AIModelData): Promise<boolean>;
 }
 export {};

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

@@ -1,137 +1,131 @@
 /**
- * @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/aicore/model/aireply
- * @publicApi
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { Element, type Document } from '../utils/htmlparser.js';
-import { type Editor } from '@ckeditor/ckeditor5-core';
-import { type AISuggestionContentPartDefinition } from '../utils/getsuggestionpartsfromreply.js';
-import type { AISource } from '../aiconnector.js';
+* @module ai/aicore/model/aireply
+* @publicApi
+*/
+import { type Locale, type ObservableMixinConstructor } from "@ckeditor/ckeditor5-utils";
+import { Element, type Document } from "../utils/htmlparser.js";
+import { type Editor } from "@ckeditor/ckeditor5-core";
+import { type AISuggestionContentPartDefinition } from "../utils/getsuggestionpartsfromreply.js";
+import type { AISource } from "../aiconnector.js";
+declare const _AIReplyBase: ObservableMixinConstructor;
 /**
- * The type of the reply. It can be one of the following:
- *
- * * `modification`: A content change suggestion made by the AI endpoint.
- * * `text`: A generic text response.
- */
-export type AIReplyType = 'modification' | 'text';
-declare const AIReply_base: {
-    new (): import("@ckeditor/ckeditor5-utils").Observable;
-    prototype: import("@ckeditor/ckeditor5-utils").Observable;
-};
+* The type of the reply. It can be one of the following:
+*
+* * `modification`: A content change suggestion made by the AI endpoint.
+* * `text`: A generic text response.
+*/
+export type AIReplyType = "modification" | "text";
 /**
- * Represents a single reply from the AI endpoint.
- *
- * A reply's {@link #content} can be updated using the {@link #appendContent} method.
- */
-export declare class AIReply extends /* #__PURE__ */ AIReply_base {
-    /**
-     * The ID of the reply.
-     */
-    readonly id: string;
-    /**
-     * The ID of the interaction that the reply belongs to.
-     */
-    readonly interactionId: string;
-    /**
-     * The type of the reply.
-     */
-    readonly type: AIReplyType;
-    /**
-     * The content of the reply as received from AI endpoint. It stores separate content for each document.
-     */
-    content: Map<string, string>;
-    /**
-     * The sources of the reply. Used for web search reply.
-     */
-    sources: Array<AISource>;
-    /**
-     * The parsed content of the reply.
-     *
-     * This property is automatically updated after reply {@link #content} changes. You can add a listener to `replyContentUpdated` event
-     * in order to react to these changes.
-     *
-     * Note, that this property type is not DOM Document, but a simplified version provided by `domhandler` library.
-     */
-    parsedContent: Map<string, Document>;
-    /**
-     * Whether the reply is done. The reply is done once the AI endpoint emitted the last chunk of the content
-     * that matches the reply's type or the reply was interrupted (user stop, error, connection drop).
-     *
-     * See {@link #isComplete} for more information about the reply's completion state.
-     *
-     * @observable
-     */
-    isDone: boolean;
-    /**
-     * Whether the reply finished organically, i.e. the stream ran out of chunks naturally.
-     *
-     * This is `false` while streaming, and also `false` if the reply was stopped or errored before the stream ended.
-     *
-     * See {@link #isDone} for more information.
-     *
-     * @observable
-     */
-    isComplete: boolean;
-    /**
-     * @inheritDoc
-     */
-    constructor({ type, isDone, isComplete, interactionId, areActionsDisabled, isFromHistory, documentContextContent, locale, id, channelsToEditors }: {
-        type: AIReplyType;
-        interactionId: string;
-        channelsToEditors: Map<string, Editor>;
-        areActionsDisabled?: boolean;
-        isFromHistory?: boolean;
-        isDone?: boolean;
-        isComplete?: boolean;
-        documentContextContent?: Array<{
-            id?: string;
-            content?: string;
-            channelId: string;
-            rootName?: string;
-        }>;
-        locale?: Locale;
-        id?: string;
-    });
-    /**
-     * Appends new content to the reply. Text replies and any plain-text fragments default to the `'text'` bucket;
-     * modification replies route by `documentId` to the per-document buckets in {@link #content}.
-     */
-    appendContent(content: string, documentId?: string): void;
-    /**
-     * Destroys the reply.
-     */
-    destroy(): void;
+* Represents a single reply from the AI endpoint.
+*
+* A reply's {@link #content} can be updated using the {@link #appendContent} method.
+*/
+export declare class AIReply extends _AIReplyBase {
+	/**
+	* The ID of the reply.
+	*/
+	readonly id: string;
+	/**
+	* The ID of the interaction that the reply belongs to.
+	*/
+	readonly interactionId: string;
+	/**
+	* The type of the reply.
+	*/
+	readonly type: AIReplyType;
+	/**
+	* The content of the reply as received from AI endpoint. It stores separate content for each document.
+	*/
+	content: Map<string, string>;
+	/**
+	* The sources of the reply. Used for web search reply.
+	*/
+	sources: Array<AISource>;
+	/**
+	* The parsed content of the reply.
+	*
+	* This property is automatically updated after reply {@link #content} changes. You can add a listener to `replyContentUpdated` event
+	* in order to react to these changes.
+	*
+	* Note, that this property type is not DOM Document, but a simplified version provided by `domhandler` library.
+	*/
+	parsedContent: Map<string, Document>;
+	/**
+	* Whether the reply is done. The reply is done once the AI endpoint emitted the last chunk of the content
+	* that matches the reply's type or the reply was interrupted (user stop, error, connection drop).
+	*
+	* See {@link #isComplete} for more information about the reply's completion state.
+	*
+	* @observable
+	*/
+	isDone: boolean;
+	/**
+	* Whether the reply finished organically, i.e. the stream ran out of chunks naturally.
+	*
+	* This is `false` while streaming, and also `false` if the reply was stopped or errored before the stream ended.
+	*
+	* See {@link #isDone} for more information.
+	*
+	* @observable
+	*/
+	isComplete: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor({ type, isDone, isComplete, interactionId, areActionsDisabled, isFromHistory, documentContextContent, locale, id, channelsToEditors }: {
+		type: AIReplyType;
+		interactionId: string;
+		channelsToEditors: Map<string, Editor>;
+		areActionsDisabled?: boolean;
+		isFromHistory?: boolean;
+		isDone?: boolean;
+		isComplete?: boolean;
+		documentContextContent?: Array<{
+			id?: string;
+			content?: string;
+			channelId: string;
+			rootName?: string;
+		}>;
+		locale?: Locale;
+		id?: string;
+	});
+	/**
+	* Appends new content to the reply. Text replies and any plain-text fragments default to the `'text'` bucket;
+	* modification replies route by `documentId` to the per-document buckets in {@link #content}.
+	*/
+	appendContent(content: string, documentId?: string): void;
+	/**
+	* Destroys the reply.
+	*/
+	destroy(): void;
 }
 /**
- * An event emitted by an {@link module:ai/aicore/model/aireply~AIReply} when it's
- * {@link module:ai/aicore/model/aireply~AIReply#content} gets updated or the reply is marked as done.
- *
- * @eventName ~AIReply#replyContentUpdated
- */
+* An event emitted by an {@link module:ai/aicore/model/aireply~AIReply} when it's
+* {@link module:ai/aicore/model/aireply~AIReply#content} gets updated or the reply is marked as done.
+*
+* @eventName ~AIReply#replyContentUpdated
+*/
 export type AIReplyContentUpdatedEvent = {
-    name: 'replyContentUpdated';
-    args: [
-        reply: AIReply,
-        updatedChangeGroups?: Array<AIReplyChangeGroup>
-    ];
+	name: "replyContentUpdated";
+	args: [reply: AIReply, updatedChangeGroups?: Array<AIReplyChangeGroup>];
 };
 export type AIReplyHotNode = {
-    node: Element;
-    id: string;
-    type: AISuggestionContentPartDefinition['type'];
-    anchorId?: string | null;
+	node: Element;
+	id: string;
+	type: AISuggestionContentPartDefinition["type"];
+	anchorId?: string | null;
 };
 export type AIReplyChangeGroup = {
-    readonly changes: Array<AIReplyHotNode>;
-    readonly documentId: string;
-    readonly editor: Editor;
-    readonly rootName: string;
-    index: number;
-    state: AIReplyChangeGroupState;
+	readonly changes: Array<AIReplyHotNode>;
+	readonly documentId: string;
+	readonly editor: Editor | undefined;
+	readonly rootName: string;
+	index: number;
+	state: AIReplyChangeGroupState;
 };
-export type AIReplyChangeGroupState = 'pending' | 'accepted' | 'rejected' | 'outdated';
+export type AIReplyChangeGroupState = "pending" | "accepted" | "rejected" | "outdated";
 export {};

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

@@ -1,95 +1,95 @@
 /**
- * @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/aicore/model/airunresult
- * @publicApi
- */
-import { type Editor } from '@ckeditor/ckeditor5-core';
-import { type CKEditorError } from '@ckeditor/ckeditor5-utils';
+* @module ai/aicore/model/airunresult
+* @publicApi
+*/
+import { type Editor } from "@ckeditor/ckeditor5-core";
+import { type CKEditorError } from "@ckeditor/ckeditor5-utils";
 /**
- * The status of an AI run, reported by the {@link module:ai/aicore/model/airunresult~AIRunResult#status `status`}.
- */
-export type AIRunStatus = 'initialized' | 'completed' | 'aborted' | 'error';
+* The status of an AI run, reported by the {@link module:ai/aicore/model/airunresult~AIRunResult#status `status`}.
+*/
+export type AIRunStatus = "initialized" | "completed" | "aborted" | "error";
 /**
- * The shape of the data accepted by the {@link module:ai/aicore/model/airunresult~AIRunResult} constructor.
- */
+* The shape of the data accepted by the {@link module:ai/aicore/model/airunresult~AIRunResult} constructor.
+*/
 export type AIRunResultInput = {
-    /**
-     * The editor that is the source of content for the AI run.
-     */
-    editor: Editor;
-    /**
-     * Name of the editor root the AI run targets.
-     */
-    rootName: string;
-    /**
-     * Collaboration channel id captured at the start of the run.
-     */
-    channelId?: string;
-    /**
-     * AI editing session id captured at the start of the run.
-     */
-    sessionId: string;
+	/**
+	* The editor that is the source of content for the AI run.
+	*/
+	editor: Editor;
+	/**
+	* Name of the editor root the AI run targets.
+	*/
+	rootName: string;
+	/**
+	* Collaboration channel id captured at the start of the run.
+	*/
+	channelId?: string;
+	/**
+	* AI editing session id captured at the start of the run.
+	*/
+	sessionId: string;
 };
 /**
- * The result of an AI run.
- */
+* The result of an AI run.
+*/
 export declare class AIRunResult {
-    constructor(data: AIRunResultInput);
-    /**
-     * Outcome of the run. Anything other than `'completed'` means the run did not finish successfully — see {@link #error} for details.
-     */
-    get status(): AIRunStatus;
-    /**
-     * The editor the AI run was performed against.
-     */
-    get editor(): Editor;
-    /**
-     * Name of the editor root the AI run targeted.
-     */
-    get rootName(): string;
-    /**
-     * Collaboration channel id captured at the start of the run.
-     */
-    get channelId(): string | undefined;
-    /**
-     * AI editing session id captured at the start of the run.
-     */
-    get sessionId(): string;
-    /**
-     * Document version captured when the run started. `undefined` until the run starts.
-     */
-    get documentVersion(): number | undefined;
-    set documentVersion(value: number);
-    /**
-     * The pre-run document snapshot as captured at the time the run started, with `data-id` attributes preserved.
-     * `undefined` until the run starts.
-     */
-    get contentRawOld(): string | undefined;
-    set contentRawOld(value: string);
-    /**
-     * The post-run document snapshot with all returned suggestions merged in, with `data-id` attributes preserved.
-     * Equals {@link #contentRawOld} when the run produced no suggestions. `undefined` until the run completes.
-     */
-    get contentRawNew(): string | undefined;
-    set contentRawNew(value: string);
-    /**
-     * The {@link #contentRawOld} with `data-id` attributes stripped. Suitable for surfacing to end-users.
-     */
-    get contentOld(): string;
-    /**
-     * The {@link #contentRawNew} with `data-id` attributes stripped. Suitable for surfacing to end-users.
-     */
-    get contentNew(): string;
-    /**
-     * The error that caused the run to fail.
-     */
-    get error(): Error | undefined;
-    set error(value: CKEditorError | undefined);
-    /**
-     * Marks the run as aborted. Reflected via {@link #status}.
-     */
-    abort(): void;
+	constructor(data: AIRunResultInput);
+	/**
+	* Outcome of the run. Anything other than `'completed'` means the run did not finish successfully — see {@link #error} for details.
+	*/
+	get status(): AIRunStatus;
+	/**
+	* The editor the AI run was performed against.
+	*/
+	get editor(): Editor;
+	/**
+	* Name of the editor root the AI run targeted.
+	*/
+	get rootName(): string;
+	/**
+	* Collaboration channel id captured at the start of the run.
+	*/
+	get channelId(): string | undefined;
+	/**
+	* AI editing session id captured at the start of the run.
+	*/
+	get sessionId(): string;
+	/**
+	* Document version captured when the run started. `undefined` until the run starts.
+	*/
+	get documentVersion(): number | undefined;
+	set documentVersion(value: number);
+	/**
+	* The pre-run document snapshot as captured at the time the run started, with `data-id` attributes preserved.
+	* `undefined` until the run starts.
+	*/
+	get contentRawOld(): string | undefined;
+	set contentRawOld(value: string);
+	/**
+	* The post-run document snapshot with all returned suggestions merged in, with `data-id` attributes preserved.
+	* Equals {@link #contentRawOld} when the run produced no suggestions. `undefined` until the run completes.
+	*/
+	get contentRawNew(): string | undefined;
+	set contentRawNew(value: string);
+	/**
+	* The {@link #contentRawOld} with `data-id` attributes stripped. Suitable for surfacing to end-users.
+	*/
+	get contentOld(): string;
+	/**
+	* The {@link #contentRawNew} with `data-id` attributes stripped. Suitable for surfacing to end-users.
+	*/
+	get contentNew(): string;
+	/**
+	* The error that caused the run to fail.
+	*/
+	get error(): Error | undefined;
+	set error(value: CKEditorError | undefined);
+	/**
+	* Marks the run as aborted. Reflected via {@link #status}.
+	*/
+	abort(): void;
 }