@ecsplico/editor 0.0.0-stage → 2.0.0

package/dist/features/ai/ghost-autocomplete.js

@@ -0,0 +1,204 @@
+import { ABILITY } from "../../core/schema/abilities.js";
+import { hasAbility } from "../../core/abilities.js";
+import { anchorResolverOf } from "../../core/doc-anchors.js";
+import { AI_COMPLETE_LIMITS } from "./protocol/complete.js";
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
+import { Decoration, DecorationSet } from "@tiptap/pm/view";
+//#region src/features/ai/ghost-autocomplete.ts
+const ghostAutocompleteKey = new PluginKey("ghostAutocomplete");
+/** Text of the caret's textblock, when the caret is an empty selection at the end of a non-empty, non-code textblock. */
+function blockTextAtEnd(state) {
+	const { selection } = state;
+	if (!(selection instanceof TextSelection) || !selection.empty) return null;
+	const { $head } = selection;
+	const block = $head.parent;
+	if (!block.isTextblock || block.type.spec.code || $head.parentOffset !== block.content.size) return null;
+	const text = block.textContent;
+	return text.trim() ? text : null;
+}
+/** Keeps a suggestion across a collaborator's change only if the caret block is untouched and the caret stayed with it. */
+function mapSuggestion(suggestion, tr, oldState, newState) {
+	const mapped = tr.mapping.mapResult(suggestion.pos);
+	if (mapped.deleted || newState.selection.head !== mapped.pos) return null;
+	const text = blockTextAtEnd(newState);
+	if (text === null || text !== oldState.doc.resolve(suggestion.pos).parent.textContent) return null;
+	return {
+		text: suggestion.text,
+		pos: mapped.pos
+	};
+}
+/** The suggestion source of the app behind `host`: `POST /api/ai/complete` on the profile of the `complete` slot. */
+function completionFetcher(host) {
+	return async (before, signal) => {
+		const { text } = await host.fetch("/api/ai/complete", {
+			method: "POST",
+			body: {
+				before,
+				model: host.modelRef("complete")
+			},
+			signal
+		});
+		return text;
+	};
+}
+/**
+* Inline AI autocomplete: after a typing pause at the end of a non-empty textblock, a short continuation is shown as grey
+* ghost text after the caret. Tab accepts it as normal text, Esc dismisses it; typing, caret moves and blur clear it.
+* The suggestion is a local widget decoration — never part of the document, so collaborators never see it.
+* On while the editor setting `ai.autocomplete` is (see `useEditorSettings`); turning it off clears the ghost.
+* Client-only: not part of `schemaExtensions()`.
+*/
+const ghostAutocomplete = (options) => Extension.create({
+	name: "ghostAutocomplete",
+	priority: 1e3,
+	addKeyboardShortcuts() {
+		return {
+			Tab: ({ editor }) => {
+				const suggestion = ghostAutocompleteKey.getState(editor.state)?.suggestion;
+				const { selection } = editor.state;
+				if (!suggestion || !selection.empty || selection.head !== suggestion.pos) return false;
+				const end = suggestion.pos + suggestion.text.length;
+				const tr = editor.state.tr.insertText(suggestion.text, suggestion.pos);
+				editor.view.dispatch(tr.setSelection(TextSelection.create(tr.doc, end)).scrollIntoView());
+				return true;
+			},
+			Escape: ({ editor }) => {
+				if (!ghostAutocompleteKey.getState(editor.state)?.suggestion) return false;
+				editor.view.dispatch(editor.state.tr.setMeta(ghostAutocompleteKey, { type: "clear" }));
+				return true;
+			}
+		};
+	},
+	addProseMirrorPlugins() {
+		const { editor } = this;
+		const { settings } = options;
+		let timer;
+		let inFlight = null;
+		function cancel() {
+			clearTimeout(timer);
+			timer = void 0;
+			inFlight?.abort();
+			inFlight = null;
+		}
+		function eligible(view) {
+			const { state } = view;
+			if (!settings.get().ai.autocomplete || !editor.isEditable || !view.hasFocus() || view.composing || blockTextAtEnd(state) === null) return false;
+			if (!hasAbility(editor, ABILITY.aiAutocomplete)) return false;
+			return !state.plugins.some((plugin) => {
+				const pluginState = plugin.getState(state);
+				return typeof pluginState === "object" && pluginState !== null && "query" in pluginState && "active" in pluginState && pluginState.active === true;
+			});
+		}
+		async function request(view, activity) {
+			timer = void 0;
+			const { state } = view;
+			if (ghostAutocompleteKey.getState(state)?.activity !== activity || !eligible(view)) return;
+			const pos = state.selection.head;
+			const blockText = blockTextAtEnd(state);
+			const before = state.doc.textBetween(Math.max(0, pos - AI_COMPLETE_LIMITS.before * 2), pos, "\n\n").slice(-AI_COMPLETE_LIMITS.before);
+			const controller = new AbortController();
+			inFlight = controller;
+			let text;
+			try {
+				text = await options.fetchSuggestion(before, controller.signal);
+			} catch {
+				return;
+			} finally {
+				if (inFlight === controller) inFlight = null;
+			}
+			if (controller.signal.aborted || !text || view.isDestroyed) return;
+			const now = view.state;
+			if (ghostAutocompleteKey.getState(now)?.activity !== activity || !eligible(view) || blockTextAtEnd(now) !== blockText) return;
+			view.dispatch(now.tr.setMeta(ghostAutocompleteKey, {
+				type: "show",
+				suggestion: {
+					text,
+					pos: now.selection.head
+				}
+			}));
+		}
+		return [new Plugin({
+			key: ghostAutocompleteKey,
+			state: {
+				init: () => ({
+					suggestion: null,
+					edits: 0,
+					activity: 0
+				}),
+				apply(tr, prev, oldState, newState) {
+					const meta = tr.getMeta(ghostAutocompleteKey);
+					const remote = anchorResolverOf(editor)?.isRemoteChange(tr) ?? false;
+					const edited = tr.docChanged && !remote;
+					const moved = tr.selectionSet && !remote;
+					let suggestion = prev.suggestion;
+					if (meta?.type === "show") suggestion = meta.suggestion;
+					else if (meta?.type === "clear" || edited || moved) suggestion = null;
+					else if (suggestion && tr.docChanged) suggestion = mapSuggestion(suggestion, tr, oldState, newState);
+					if (suggestion === prev.suggestion && !edited && !moved) return prev;
+					return {
+						suggestion,
+						edits: prev.edits + (edited ? 1 : 0),
+						activity: prev.activity + (edited || moved ? 1 : 0)
+					};
+				}
+			},
+			props: {
+				decorations(state) {
+					const suggestion = ghostAutocompleteKey.getState(state)?.suggestion;
+					if (!suggestion) return null;
+					const widget = Decoration.widget(suggestion.pos, () => {
+						const span = document.createElement("span");
+						span.className = "ghost-autocomplete";
+						span.contentEditable = "false";
+						span.setAttribute("aria-hidden", "true");
+						span.textContent = suggestion.text;
+						return span;
+					}, {
+						side: 1,
+						key: `ghost:${suggestion.text}`,
+						ignoreSelection: true
+					});
+					return DecorationSet.create(state.doc, [widget]);
+				},
+				handleDOMEvents: { blur(view) {
+					cancel();
+					if (ghostAutocompleteKey.getState(view.state)?.suggestion) view.dispatch(view.state.tr.setMeta(ghostAutocompleteKey, { type: "clear" }));
+					return false;
+				} }
+			},
+			view: (view) => {
+				let last = settings.get().ai.autocomplete;
+				const stop = settings.subscribe((value) => {
+					const enabled = value.ai.autocomplete;
+					if (enabled === last) return;
+					last = enabled;
+					if (enabled || view.isDestroyed) return;
+					cancel();
+					if (ghostAutocompleteKey.getState(view.state)?.suggestion) view.dispatch(view.state.tr.setMeta(ghostAutocompleteKey, { type: "clear" }));
+				});
+				return {
+					update(view, prevState) {
+						const next = ghostAutocompleteKey.getState(view.state);
+						const prev = ghostAutocompleteKey.getState(prevState);
+						if (!next || !prev) return;
+						if (!settings.get().ai.autocomplete) return cancel();
+						if (next.activity === prev.activity) return;
+						cancel();
+						if (next.edits === prev.edits || !eligible(view)) return;
+						const activity = next.activity;
+						timer = window.setTimeout(() => void request(view, activity), options.debounce);
+					},
+					destroy() {
+						stop();
+						cancel();
+					}
+				};
+			}
+		})];
+	}
+});
+//#endregion
+export { completionFetcher, ghostAutocomplete, ghostAutocompleteKey };
+
+//# sourceMappingURL=ghost-autocomplete.js.map

package/dist/features/ai/ghost-autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost-autocomplete.js","names":[],"sources":["../../../src/features/ai/ghost-autocomplete.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport { type EditorState, Plugin, PluginKey, TextSelection, type Transaction } from '@tiptap/pm/state'\nimport { Decoration, DecorationSet, type EditorView } from '@tiptap/pm/view'\nimport type { Store } from '../../core/store'\nimport { anchorResolverOf, hasAbility } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport type { EditorSettings, ModelSlot } from '../../settings'\nimport type { $Fetch } from 'ofetch'\nimport { AI_COMPLETE_LIMITS, type ModelRef } from './protocol'\n\nexport interface GhostAutocompleteOptions {\n  /** The app's shared settings: `ai.autocomplete` switches the suggestions on. */\n  settings: Store<EditorSettings>\n  /** Pause after the last keystroke before a suggestion is requested (ms). */\n  debounce: number\n  /** Fetches a continuation of `before` (document text up to the caret); '' for none. Must honour `signal`. */\n  fetchSuggestion: (before: string, signal: AbortSignal) => Promise<string>\n}\n\ninterface Suggestion { text: string, pos: number }\ninterface GhostState {\n  suggestion: Suggestion | null\n  /** Bumped by local edits: each bump starts a new pause, so at most one request follows it. */\n  edits: number\n  /** Bumped by local edits and caret moves: an in-flight request is stale once this changed. */\n  activity: number\n}\ntype GhostMeta = { type: 'show', suggestion: Suggestion } | { type: 'clear' }\n\nexport const ghostAutocompleteKey = new PluginKey<GhostState>('ghostAutocomplete')\n\n/** Text of the caret's textblock, when the caret is an empty selection at the end of a non-empty, non-code textblock. */\nfunction blockTextAtEnd(state: EditorState): string | null {\n  const { selection } = state\n  if (!(selection instanceof TextSelection) || !selection.empty) return null\n  const { $head } = selection\n  const block = $head.parent\n  if (!block.isTextblock || block.type.spec.code || $head.parentOffset !== block.content.size) return null\n  const text = block.textContent\n  return text.trim() ? text : null\n}\n\n/** Keeps a suggestion across a collaborator's change only if the caret block is untouched and the caret stayed with it. */\nfunction mapSuggestion(suggestion: Suggestion, tr: Transaction, oldState: EditorState, newState: EditorState): Suggestion | null {\n  const mapped = tr.mapping.mapResult(suggestion.pos)\n  if (mapped.deleted || newState.selection.head !== mapped.pos) return null\n  const text = blockTextAtEnd(newState)\n  if (text === null || text !== oldState.doc.resolve(suggestion.pos).parent.textContent) return null\n  return { text: suggestion.text, pos: mapped.pos }\n}\n\n/** What the suggestion source needs of the app: its HTTP client and the model profile of a slot (`useModelProfiles`). */\nexport interface CompletionHost {\n  fetch: $Fetch\n  modelRef: (slot: ModelSlot) => ModelRef\n}\n\n/** The suggestion source of the app behind `host`: `POST /api/ai/complete` on the profile of the `complete` slot. */\nexport function completionFetcher(host: CompletionHost): GhostAutocompleteOptions['fetchSuggestion'] {\n  return async (before, signal) => {\n    const { text } = await host.fetch<{ text: string }>('/api/ai/complete', { method: 'POST', body: { before, model: host.modelRef('complete') }, signal })\n    return text\n  }\n}\n\n/**\n * Inline AI autocomplete: after a typing pause at the end of a non-empty textblock, a short continuation is shown as grey\n * ghost text after the caret. Tab accepts it as normal text, Esc dismisses it; typing, caret moves and blur clear it.\n * The suggestion is a local widget decoration — never part of the document, so collaborators never see it.\n * On while the editor setting `ai.autocomplete` is (see `useEditorSettings`); turning it off clears the ghost.\n * Client-only: not part of `schemaExtensions()`.\n */\nexport const ghostAutocomplete = (options: GhostAutocompleteOptions) => Extension.create({\n  name: 'ghostAutocomplete',\n  // Runs its Tab/Escape bindings before ListItem's Tab (sinkListItem); both return false without a suggestion.\n  priority: 1000,\n\n  addKeyboardShortcuts() {\n    return {\n      Tab: ({ editor }) => {\n        const suggestion = ghostAutocompleteKey.getState(editor.state)?.suggestion\n        const { selection } = editor.state\n        if (!suggestion || !selection.empty || selection.head !== suggestion.pos) return false\n        const end = suggestion.pos + suggestion.text.length\n        const tr = editor.state.tr.insertText(suggestion.text, suggestion.pos)\n        editor.view.dispatch(tr.setSelection(TextSelection.create(tr.doc, end)).scrollIntoView())\n        return true\n      },\n      Escape: ({ editor }) => {\n        if (!ghostAutocompleteKey.getState(editor.state)?.suggestion) return false\n        editor.view.dispatch(editor.state.tr.setMeta(ghostAutocompleteKey, { type: 'clear' } satisfies GhostMeta))\n        return true\n      },\n    }\n  },\n\n  addProseMirrorPlugins() {\n    const { editor } = this\n    const { settings } = options\n    let timer: number | undefined\n    let inFlight: AbortController | null = null\n\n    function cancel() {\n      clearTimeout(timer)\n      timer = undefined\n      inFlight?.abort()\n      inFlight = null\n    }\n\n    function eligible(view: EditorView): boolean {\n      const { state } = view\n      if (!settings.get().ai.autocomplete || !editor.isEditable || !view.hasFocus() || view.composing || blockTextAtEnd(state) === null) return false\n      if (!hasAbility(editor, ABILITY.aiAutocomplete)) return false\n      // No ghost while an @tiptap/suggestion popup (e.g. `@` mentions) is open: its state is `{ active, query, … }`.\n      return !state.plugins.some((plugin) => {\n        const pluginState: unknown = plugin.getState(state)\n        return typeof pluginState === 'object' && pluginState !== null && 'query' in pluginState && 'active' in pluginState && pluginState.active === true\n      })\n    }\n\n    async function request(view: EditorView, activity: number) {\n      timer = undefined\n      const { state } = view\n      if (ghostAutocompleteKey.getState(state)?.activity !== activity || !eligible(view)) return\n      const pos = state.selection.head\n      const blockText = blockTextAtEnd(state)\n      // Positions count at least one per character, so twice the limit in positions covers the character limit.\n      const before = state.doc.textBetween(Math.max(0, pos - AI_COMPLETE_LIMITS.before * 2), pos, '\\n\\n').slice(-AI_COMPLETE_LIMITS.before)\n      const controller = new AbortController()\n      inFlight = controller\n      let text: string\n      try {\n        text = await options.fetchSuggestion(before, controller.signal)\n      } catch {\n        // Aborted, rate-limited (429) or failed: autocomplete is a silent nicety, so no ghost and no toast.\n        return\n      } finally {\n        if (inFlight === controller) inFlight = null\n      }\n      if (controller.signal.aborted || !text || view.isDestroyed) return\n      // Stale-response guard: no local edit or caret move since the request, and the caret block text is unchanged\n      // (a collaborator's change elsewhere may have shifted the caret position).\n      const now = view.state\n      if (ghostAutocompleteKey.getState(now)?.activity !== activity || !eligible(view) || blockTextAtEnd(now) !== blockText) return\n      view.dispatch(now.tr.setMeta(ghostAutocompleteKey, { type: 'show', suggestion: { text, pos: now.selection.head } } satisfies GhostMeta))\n    }\n\n    return [\n      new Plugin<GhostState>({\n        key: ghostAutocompleteKey,\n        state: {\n          init: () => ({ suggestion: null, edits: 0, activity: 0 }),\n          apply(tr, prev, oldState, newState) {\n            const meta = tr.getMeta(ghostAutocompleteKey) as GhostMeta | undefined\n            // A collaborator's edit (the collaboration feature's resolver tells); the user's own undo/redo is not remote.\n            const remote = anchorResolverOf(editor)?.isRemoteChange(tr) ?? false\n            const edited = tr.docChanged && !remote\n            const moved = tr.selectionSet && !remote\n            let suggestion = prev.suggestion\n            if (meta?.type === 'show') suggestion = meta.suggestion\n            else if (meta?.type === 'clear' || edited || moved) suggestion = null\n            else if (suggestion && tr.docChanged) suggestion = mapSuggestion(suggestion, tr, oldState, newState)\n            if (suggestion === prev.suggestion && !edited && !moved) return prev\n            return { suggestion, edits: prev.edits + (edited ? 1 : 0), activity: prev.activity + (edited || moved ? 1 : 0) }\n          },\n        },\n        props: {\n          decorations(state) {\n            const suggestion = ghostAutocompleteKey.getState(state)?.suggestion\n            if (!suggestion) return null\n            const widget = Decoration.widget(suggestion.pos, () => {\n              const span = document.createElement('span')\n              span.className = 'ghost-autocomplete'\n              span.contentEditable = 'false'\n              span.setAttribute('aria-hidden', 'true')\n              span.textContent = suggestion.text\n              return span\n            }, { side: 1, key: `ghost:${suggestion.text}`, ignoreSelection: true })\n            return DecorationSet.create(state.doc, [widget])\n          },\n          handleDOMEvents: {\n            blur(view) {\n              cancel()\n              if (ghostAutocompleteKey.getState(view.state)?.suggestion) {\n                view.dispatch(view.state.tr.setMeta(ghostAutocompleteKey, { type: 'clear' } satisfies GhostMeta))\n              }\n              return false\n            },\n          },\n        },\n        view: (view) => {\n          // Turned off (toolbar or settings): drop the pending request and the shown ghost right away.\n          let last = settings.get().ai.autocomplete\n          const stop = settings.subscribe((value) => {\n            const enabled = value.ai.autocomplete\n            if (enabled === last) return\n            last = enabled\n            if (enabled || view.isDestroyed) return\n            cancel()\n            if (ghostAutocompleteKey.getState(view.state)?.suggestion) {\n              view.dispatch(view.state.tr.setMeta(ghostAutocompleteKey, { type: 'clear' } satisfies GhostMeta))\n            }\n          })\n          return {\n            update(view, prevState) {\n              const next = ghostAutocompleteKey.getState(view.state)\n              const prev = ghostAutocompleteKey.getState(prevState)\n              if (!next || !prev) return\n              if (!settings.get().ai.autocomplete) return cancel()\n              if (next.activity === prev.activity) return\n              // Typing or a caret move: drop the pending pause and abort the in-flight request.\n              cancel()\n              // Only a local edit starts a new pause; caret moves alone never request.\n              if (next.edits === prev.edits || !eligible(view)) return\n              const activity = next.activity\n              timer = window.setTimeout(() => void request(view, activity), options.debounce)\n            },\n            destroy() {\n              stop()\n              cancel()\n            },\n          }\n        },\n      }),\n    ]\n  },\n})\n"],"mappings":"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"}

package/dist/features/ai/index.d.ts

@@ -0,0 +1,24 @@
+import { AiReview, AiReviewChange, AiReviewChangeSummary, AiReviewDecision, AiReviewHandle, AiReviewHunk, AiReviewOptions, AiReviewOutcome, AiReviewSkipReason, AiReviewState, acceptAiReview, aiReviewKey, rejectAiReview, setActiveAiReviewHunk, startAiReview } from "./ai-review.js";
+import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_OUTCOME_TEXT, AGENT_OP_TYPES, AGENT_TOOL, AgentOp, AgentOpContext, AgentOpFeedback, AgentOpOutcome, AgentOpProblem, AgentOpProblemReason, AgentOpType, AgentTextOptions, ModelAgentOp, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, checkAgentOps, documentBlockIds } from "./protocol/agent-ops.js";
+import { CHAT_LIMITS, CITATION_HREF_PREFIX, ChatBlock, ChatBlockModel, ChatCompositeKind, DocumentChatMessage, citationBlockId, documentChatMessages } from "./protocol/chat.js";
+import { AI_COMPLETE_LIMITS, AiCompleteMessage, cleanCompletion, completeMessages, completionReady } from "./protocol/complete.js";
+import { AI_LANGUAGE_KEYS, MODEL_REF_LIMITS, MODEL_SLOT_KEYS, ModelProfile, ModelRef, UserModelProfile, modelRefSchema } from "./protocol/models.js";
+import { AI_ID_PATTERN, aiBlockInputSchema, aiBlockSchema } from "./protocol/schemas.js";
+import { AI_LIMITS, AI_TASKS, AI_TASK_IDS, AiApplyMode, AiBlockInput, AiInput, AiMessage, AiTask, AiTaskId, blockTasks, inBlockTasks, withHeading, withTaskHeading } from "./protocol/tasks.js";
+import "./protocol/index.js";
+import { AgentScope, selectionScope } from "./agent-ops.js";
+import { AgentOpReview, AgentOpReviewOptions, AgentOpReviewState, AgentOpState, createAgentOpReview } from "./agent-op-review.js";
+import { AiApplyOutcome, AiResultAction, AiTarget, aiApplyFailure, applyAiResult, captureTarget, documentMarkdown, formatTaskResult, insertAtCaretLine, insertBlocksAtTarget, insertBlocksBelow, rangeMarkdown, resultBlocks, selectionMarkdown } from "./ai-apply.js";
+import { AI_MENU_AT_CARET, AI_MENU_FOR_SELECTION, AiMenuAction, aiMenuActionsOf, openAiMenuAtCaret, openAiMenuForSelection } from "./ai-menu.js";
+import { AiSelectionHighlight, aiSelectionHighlightKey, hideAiSelectionHighlight, showAiSelectionHighlight } from "./ai-selection-highlight.js";
+import { AiSseOutcome, postAiSse } from "./ai-sse.js";
+import { AiAssistant, AiAssistantOptions, AiAssistantState, AiRunBody, AiStatus, createAiAssistant } from "./assistant.js";
+import { aiBlockAction, aiSlashCommand, blockTextRange } from "./block-actions.js";
+import { documentChatText } from "./document-chat.js";
+import { DocumentChat, DocumentChatGeneration, DocumentChatOptions, DocumentChatState, DocumentChatTurn, createDocumentChat } from "./document-chat-model.js";
+import { AiUi, aiFeatureCore } from "./feature.js";
+import { GhostAutocompleteOptions, completionFetcher, ghostAutocomplete, ghostAutocompleteKey } from "./ghost-autocomplete.js";
+import { ModelProfilesModel, modelProfiles } from "./model-profiles.js";
+import { isRateLimited, notifyAiRateLimited } from "./rate-limit.js";
+import { AiSidebarFlow, AiSidebarFlowOptions, createAiSidebarFlow } from "./sidebar-flow.js";
+export { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_OUTCOME_TEXT, AGENT_OP_TYPES, AGENT_TOOL, AI_COMPLETE_LIMITS, AI_ID_PATTERN, AI_LANGUAGE_KEYS, AI_LIMITS, AI_MENU_AT_CARET, AI_MENU_FOR_SELECTION, AI_TASKS, AI_TASK_IDS, AgentOp, AgentOpContext, AgentOpFeedback, AgentOpOutcome, AgentOpProblem, AgentOpProblemReason, type AgentOpReview, type AgentOpReviewOptions, type AgentOpReviewState, type AgentOpState, AgentOpType, type AgentScope, AgentTextOptions, AiApplyMode, type AiApplyOutcome, type AiAssistant, type AiAssistantOptions, type AiAssistantState, AiBlockInput, AiCompleteMessage, AiInput, type AiMenuAction, AiMessage, type AiResultAction, AiReview, type AiReviewChange, type AiReviewChangeSummary, type AiReviewDecision, type AiReviewHandle, type AiReviewHunk, type AiReviewOptions, type AiReviewOutcome, type AiReviewSkipReason, type AiReviewState, type AiRunBody, AiSelectionHighlight, type AiSidebarFlow, type AiSidebarFlowOptions, type AiSseOutcome, type AiStatus, type AiTarget, AiTask, AiTaskId, type AiUi, CHAT_LIMITS, CITATION_HREF_PREFIX, ChatBlock, ChatBlockModel, ChatCompositeKind, type DocumentChat, type DocumentChatGeneration, DocumentChatMessage, type DocumentChatOptions, type DocumentChatState, type DocumentChatTurn, type GhostAutocompleteOptions, MODEL_REF_LIMITS, MODEL_SLOT_KEYS, ModelAgentOp, ModelProfile, type ModelProfilesModel, ModelRef, UserModelProfile, acceptAiReview, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, aiApplyFailure, aiBlockAction, aiBlockInputSchema, aiBlockSchema, aiFeatureCore, aiMenuActionsOf, aiReviewKey, aiSelectionHighlightKey, aiSlashCommand, applyAiResult, blockTasks, blockTextRange, captureTarget, checkAgentOps, citationBlockId, cleanCompletion, completeMessages, completionFetcher, completionReady, createAgentOpReview, createAiAssistant, createAiSidebarFlow, createDocumentChat, documentBlockIds, documentChatMessages, documentChatText, documentMarkdown, formatTaskResult, ghostAutocomplete, ghostAutocompleteKey, hideAiSelectionHighlight, inBlockTasks, insertAtCaretLine, insertBlocksAtTarget, insertBlocksBelow, isRateLimited, modelProfiles, modelRefSchema, notifyAiRateLimited, openAiMenuAtCaret, openAiMenuForSelection, postAiSse, rangeMarkdown, rejectAiReview, resultBlocks, selectionMarkdown, selectionScope, setActiveAiReviewHunk, showAiSelectionHighlight, startAiReview, withHeading, withTaskHeading };

package/dist/features/ai/index.js

@@ -0,0 +1,23 @@
+import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_OUTCOME_TEXT, AGENT_OP_TYPES, AGENT_TOOL, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, checkAgentOps, documentBlockIds } from "./protocol/agent-ops.js";
+import { CHAT_LIMITS, CITATION_HREF_PREFIX, citationBlockId, documentChatMessages } from "./protocol/chat.js";
+import { AI_COMPLETE_LIMITS, cleanCompletion, completeMessages, completionReady } from "./protocol/complete.js";
+import { AI_LANGUAGE_KEYS, MODEL_REF_LIMITS, MODEL_SLOT_KEYS, modelRefSchema } from "./protocol/models.js";
+import { AI_LIMITS, AI_TASKS, AI_TASK_IDS, blockTasks, inBlockTasks, withHeading, withTaskHeading } from "./protocol/tasks.js";
+import { AI_ID_PATTERN, aiBlockInputSchema, aiBlockSchema } from "./protocol/schemas.js";
+import { selectionScope } from "./agent-ops.js";
+import { aiApplyFailure, applyAiResult, captureTarget, documentMarkdown, formatTaskResult, insertAtCaretLine, insertBlocksAtTarget, insertBlocksBelow, rangeMarkdown, resultBlocks, selectionMarkdown } from "./ai-apply.js";
+import { AiReview, acceptAiReview, aiReviewKey, rejectAiReview, setActiveAiReviewHunk, startAiReview } from "./ai-review.js";
+import { createAgentOpReview } from "./agent-op-review.js";
+import { AI_MENU_AT_CARET, AI_MENU_FOR_SELECTION, aiMenuActionsOf, openAiMenuAtCaret, openAiMenuForSelection } from "./ai-menu.js";
+import { AiSelectionHighlight, aiSelectionHighlightKey, hideAiSelectionHighlight, showAiSelectionHighlight } from "./ai-selection-highlight.js";
+import { isRateLimited, notifyAiRateLimited } from "./rate-limit.js";
+import { postAiSse } from "./ai-sse.js";
+import { createAiAssistant } from "./assistant.js";
+import { aiBlockAction, aiSlashCommand, blockTextRange } from "./block-actions.js";
+import { documentChatText } from "./document-chat.js";
+import { createDocumentChat } from "./document-chat-model.js";
+import { completionFetcher, ghostAutocomplete, ghostAutocompleteKey } from "./ghost-autocomplete.js";
+import { modelProfiles } from "./model-profiles.js";
+import { aiFeatureCore } from "./feature.js";
+import { createAiSidebarFlow } from "./sidebar-flow.js";
+export { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_OUTCOME_TEXT, AGENT_OP_TYPES, AGENT_TOOL, AI_COMPLETE_LIMITS, AI_ID_PATTERN, AI_LANGUAGE_KEYS, AI_LIMITS, AI_MENU_AT_CARET, AI_MENU_FOR_SELECTION, AI_TASKS, AI_TASK_IDS, AiReview, AiSelectionHighlight, CHAT_LIMITS, CITATION_HREF_PREFIX, MODEL_REF_LIMITS, MODEL_SLOT_KEYS, acceptAiReview, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, aiApplyFailure, aiBlockAction, aiBlockInputSchema, aiBlockSchema, aiFeatureCore, aiMenuActionsOf, aiReviewKey, aiSelectionHighlightKey, aiSlashCommand, applyAiResult, blockTasks, blockTextRange, captureTarget, checkAgentOps, citationBlockId, cleanCompletion, completeMessages, completionFetcher, completionReady, createAgentOpReview, createAiAssistant, createAiSidebarFlow, createDocumentChat, documentBlockIds, documentChatMessages, documentChatText, documentMarkdown, formatTaskResult, ghostAutocomplete, ghostAutocompleteKey, hideAiSelectionHighlight, inBlockTasks, insertAtCaretLine, insertBlocksAtTarget, insertBlocksBelow, isRateLimited, modelProfiles, modelRefSchema, notifyAiRateLimited, openAiMenuAtCaret, openAiMenuForSelection, postAiSse, rangeMarkdown, rejectAiReview, resultBlocks, selectionMarkdown, selectionScope, setActiveAiReviewHunk, showAiSelectionHighlight, startAiReview, withHeading, withTaskHeading };

package/dist/features/ai/model-profiles.d.ts

@@ -0,0 +1,36 @@
+import { ModelSlot } from "../../settings/values.js";
+import "../../settings/index.js";
+import { ReadonlyStore, Store } from "../../core/store.js";
+import { EditorContext } from "../../core/context.js";
+import { ModelProfile, ModelRef, UserModelProfile } from "./protocol/models.js";
+import "./protocol/index.js";
+//#region src/features/ai/model-profiles.d.ts
+/** The model profiles of one app: see `modelProfiles`. */
+export interface ModelProfilesModel {
+  /** Server presets (`GET /api/ai/models`, without keys); empty until loaded. */
+  presets: ReadonlyStore<ModelProfile[]>;
+  /** This browser's own profiles (localStorage). Change them through `saveUserProfile`/`removeUserProfile`. */
+  userProfiles: Store<UserModelProfile[]>;
+  /** Presets, then user profiles. Reads the stores: call it again after either changed. */
+  profiles: () => ModelProfile[];
+  /**
+   * Profile a slot runs on: the one the settings assign to it, else the server's default preset for the slot, else the
+   * first preset; none before the presets loaded (unless the settings point at a user profile).
+   */
+  slotProfile: (slot: ModelSlot) => ModelProfile | undefined;
+  /** What AI requests send as `model`; works before the presets loaded (the default slot preset of `createEditor({ ai })`). */
+  modelRef: (slot: ModelSlot) => ModelRef;
+  saveUserProfile: (profile: UserModelProfile) => void;
+  /** Also resets every slot that ran on the profile to the server default. */
+  removeUserProfile: (id: string) => void;
+}
+/**
+ * Model profiles the AI features run on, shared by all editors of the app (cached per `createEditorContext`, never
+ * process-global): server presets (`GET /api/ai/models` through the context's HTTP client, requested once on first
+ * use, without keys) plus user profiles that live only in this browser's localStorage (their key goes with each
+ * request). Framework-free: `modelRef(slot)` is what AI requests send as `model`. Frameworks observe `presets`,
+ * `userProfiles` and `app.settings` (the slot assignment is `settings.ai.slots`).
+ */
+export declare function modelProfiles(app: EditorContext): ModelProfilesModel;
+//#endregion
+//# sourceMappingURL=model-profiles.d.ts.map

package/dist/features/ai/model-profiles.js

@@ -0,0 +1,111 @@
+import { MODEL_SLOTS } from "../../settings/values.js";
+import { createStore } from "../../core/store.js";
+import { z } from "zod";
+//#region src/features/ai/model-profiles.ts
+const STORAGE_KEY = "tiptap-editor:model-profiles";
+const storedProfileSchema = z.object({
+	id: z.string(),
+	label: z.string(),
+	endpoint: z.string(),
+	model: z.string(),
+	apiKey: z.string()
+});
+function storeUserProfiles(profiles) {
+	try {
+		localStorage.setItem(STORAGE_KEY, JSON.stringify(profiles));
+	} catch {}
+}
+function loadUserProfiles() {
+	try {
+		const stored = JSON.parse(localStorage.getItem(STORAGE_KEY) ?? "[]");
+		if (Array.isArray(stored)) return stored.flatMap((item) => {
+			const parsed = storedProfileSchema.safeParse(item);
+			return parsed.success ? [parsed.data] : [];
+		});
+	} catch {}
+	return [];
+}
+function createModelProfiles(app) {
+	const presets = createStore([]);
+	const userProfiles = createStore(loadUserProfiles());
+	/** Default preset id per slot as the server reports it; until then the app's public AI configuration. */
+	let serverSlots = null;
+	const defaultSlots = app.ai?.slots ?? {
+		complete: "",
+		rewrite: "",
+		generate: ""
+	};
+	app.fetch("/api/ai/models").then((response) => {
+		serverSlots = response.slots;
+		presets.set(response.presets);
+	}).catch((error) => {
+		console.warn("tiptap-editor: Modell-Presets konnten nicht geladen werden", error);
+	});
+	const profiles = () => [...presets.get(), ...userProfiles.get().map(({ id, label, endpoint, model }) => ({
+		id,
+		label,
+		endpoint,
+		model,
+		source: "user"
+	}))];
+	const slotProfile = (slot) => {
+		const chosen = app.settings.get().ai.slots[slot];
+		const defaultId = (serverSlots ?? defaultSlots)[slot];
+		return profiles().find((p) => p.id === chosen) ?? presets.get().find((p) => p.id === defaultId) ?? presets.get()[0];
+	};
+	const modelRef = (slot) => {
+		const profile = slotProfile(slot);
+		if (!profile) return { preset: (serverSlots ?? defaultSlots)[slot] };
+		const user = profile.source === "user" ? userProfiles.get().find((p) => p.id === profile.id) : void 0;
+		return user ? {
+			endpoint: user.endpoint,
+			model: user.model,
+			apiKey: user.apiKey
+		} : { preset: profile.id };
+	};
+	const saveUserProfile = (profile) => {
+		const current = userProfiles.get();
+		const index = current.findIndex((p) => p.id === profile.id);
+		const next = index < 0 ? [...current, profile] : current.map((p, i) => i === index ? profile : p);
+		userProfiles.set(next);
+		storeUserProfiles(next);
+	};
+	const removeUserProfile = (id) => {
+		const next = userProfiles.get().filter((p) => p.id !== id);
+		userProfiles.set(next);
+		storeUserProfiles(next);
+		const slots = app.settings.get().ai.slots;
+		if (MODEL_SLOTS.some((slot) => slots[slot] === id)) app.settings.update((s) => {
+			for (const slot of MODEL_SLOTS) if (s.ai.slots[slot] === id) delete s.ai.slots[slot];
+		});
+	};
+	return {
+		presets,
+		userProfiles,
+		profiles,
+		slotProfile,
+		modelRef,
+		saveUserProfile,
+		removeUserProfile
+	};
+}
+const models = /* @__PURE__ */ new WeakMap();
+/**
+* Model profiles the AI features run on, shared by all editors of the app (cached per `createEditorContext`, never
+* process-global): server presets (`GET /api/ai/models` through the context's HTTP client, requested once on first
+* use, without keys) plus user profiles that live only in this browser's localStorage (their key goes with each
+* request). Framework-free: `modelRef(slot)` is what AI requests send as `model`. Frameworks observe `presets`,
+* `userProfiles` and `app.settings` (the slot assignment is `settings.ai.slots`).
+*/
+function modelProfiles(app) {
+	let model = models.get(app);
+	if (!model) {
+		model = createModelProfiles(app);
+		models.set(app, model);
+	}
+	return model;
+}
+//#endregion
+export { modelProfiles };
+
+//# sourceMappingURL=model-profiles.js.map

package/dist/features/ai/model-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-profiles.js","names":[],"sources":["../../../src/features/ai/model-profiles.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { EditorContext } from '../../core/context'\nimport { createStore, type ReadonlyStore, type Store } from '../../core/store'\nimport { MODEL_SLOTS, type ModelSlot } from '../../settings'\nimport type { ModelProfile, ModelRef, UserModelProfile } from './protocol'\n\nconst STORAGE_KEY = 'tiptap-editor:model-profiles'\n\n/** The model profiles of one app: see `modelProfiles`. */\nexport interface ModelProfilesModel {\n  /** Server presets (`GET /api/ai/models`, without keys); empty until loaded. */\n  presets: ReadonlyStore<ModelProfile[]>\n  /** This browser's own profiles (localStorage). Change them through `saveUserProfile`/`removeUserProfile`. */\n  userProfiles: Store<UserModelProfile[]>\n  /** Presets, then user profiles. Reads the stores: call it again after either changed. */\n  profiles: () => ModelProfile[]\n  /**\n   * Profile a slot runs on: the one the settings assign to it, else the server's default preset for the slot, else the\n   * first preset; none before the presets loaded (unless the settings point at a user profile).\n   */\n  slotProfile: (slot: ModelSlot) => ModelProfile | undefined\n  /** What AI requests send as `model`; works before the presets loaded (the default slot preset of `createEditor({ ai })`). */\n  modelRef: (slot: ModelSlot) => ModelRef\n  saveUserProfile: (profile: UserModelProfile) => void\n  /** Also resets every slot that ran on the profile to the server default. */\n  removeUserProfile: (id: string) => void\n}\n\nconst storedProfileSchema = z.object({ id: z.string(), label: z.string(), endpoint: z.string(), model: z.string(), apiKey: z.string() })\n\nfunction storeUserProfiles(profiles: UserModelProfile[]) {\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(profiles))\n  }\n  catch {\n    // Storage unavailable (e.g. privacy mode): the profiles last for this session only.\n  }\n}\n\nfunction loadUserProfiles(): UserModelProfile[] {\n  try {\n    const stored: unknown = JSON.parse(localStorage.getItem(STORAGE_KEY) ?? '[]')\n    if (Array.isArray(stored)) {\n      return stored.flatMap((item) => {\n        const parsed = storedProfileSchema.safeParse(item)\n        return parsed.success ? [parsed.data] : []\n      })\n    }\n  }\n  catch {\n    // Unreadable or corrupt storage: no user profiles.\n  }\n  return []\n}\n\nfunction createModelProfiles(app: EditorContext): ModelProfilesModel {\n  const presets = createStore<ModelProfile[]>([])\n  const userProfiles = createStore<UserModelProfile[]>(loadUserProfiles())\n  /** Default preset id per slot as the server reports it; until then the app's public AI configuration. */\n  let serverSlots: Record<ModelSlot, string> | null = null\n  const defaultSlots: Record<ModelSlot, string> = app.ai?.slots ?? { complete: '', rewrite: '', generate: '' }\n\n  app.fetch<{ presets: ModelProfile[], slots: Record<ModelSlot, string> }>('/api/ai/models')\n    .then((response) => {\n      serverSlots = response.slots\n      presets.set(response.presets)\n    })\n    .catch((error) => {\n      // Requests keep using the default slot presets by id.\n      console.warn('tiptap-editor: Modell-Presets konnten nicht geladen werden', error)\n    })\n\n  const profiles = (): ModelProfile[] => [\n    ...presets.get(),\n    ...userProfiles.get().map(({ id, label, endpoint, model }) => ({ id, label, endpoint, model, source: 'user' as const })),\n  ]\n\n  const slotProfile = (slot: ModelSlot): ModelProfile | undefined => {\n    const chosen = app.settings.get().ai.slots[slot]\n    const defaultId = (serverSlots ?? defaultSlots)[slot]\n    return profiles().find(p => p.id === chosen)\n      ?? presets.get().find(p => p.id === defaultId)\n      ?? presets.get()[0]\n  }\n\n  const modelRef = (slot: ModelSlot): ModelRef => {\n    const profile = slotProfile(slot)\n    if (!profile) return { preset: (serverSlots ?? defaultSlots)[slot] }\n    const user = profile.source === 'user' ? userProfiles.get().find(p => p.id === profile.id) : undefined\n    return user ? { endpoint: user.endpoint, model: user.model, apiKey: user.apiKey } : { preset: profile.id }\n  }\n\n  const saveUserProfile = (profile: UserModelProfile) => {\n    const current = userProfiles.get()\n    const index = current.findIndex(p => p.id === profile.id)\n    const next = index < 0 ? [...current, profile] : current.map((p, i) => (i === index ? profile : p))\n    userProfiles.set(next)\n    storeUserProfiles(next)\n  }\n\n  const removeUserProfile = (id: string) => {\n    const next = userProfiles.get().filter(p => p.id !== id)\n    userProfiles.set(next)\n    storeUserProfiles(next)\n    const slots = app.settings.get().ai.slots\n    if (MODEL_SLOTS.some(slot => slots[slot] === id)) {\n      app.settings.update((s) => {\n        for (const slot of MODEL_SLOTS) {\n          if (s.ai.slots[slot] === id) delete s.ai.slots[slot]\n        }\n      })\n    }\n  }\n\n  return { presets, userProfiles, profiles, slotProfile, modelRef, saveUserProfile, removeUserProfile }\n}\n\nconst models = new WeakMap<EditorContext, ModelProfilesModel>()\n\n/**\n * Model profiles the AI features run on, shared by all editors of the app (cached per `createEditorContext`, never\n * process-global): server presets (`GET /api/ai/models` through the context's HTTP client, requested once on first\n * use, without keys) plus user profiles that live only in this browser's localStorage (their key goes with each\n * request). Framework-free: `modelRef(slot)` is what AI requests send as `model`. Frameworks observe `presets`,\n * `userProfiles` and `app.settings` (the slot assignment is `settings.ai.slots`).\n */\nexport function modelProfiles(app: EditorContext): ModelProfilesModel {\n  let model = models.get(app)\n  if (!model) {\n    model = createModelProfiles(app)\n    models.set(app, model)\n  }\n  return model\n}\n"],"mappings":"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"}

package/dist/features/ai/preview-extensions.js

@@ -0,0 +1,14 @@
+import { DocumentMarkdown } from "../../core/document-markdown.js";
+import { coreSchemaExtensions } from "../../core/schema/index.js";
+//#region src/features/ai/preview-extensions.ts
+/**
+* Extensions of a read-only AI preview next to `editor`: the nodes and marks of its schema without their node views
+* (a preview never needs a composite's or a media block's live view), plus Markdown. Without an editor, the core schema.
+*/
+function previewExtensions(editor) {
+	return [...editor ? editor.extensionManager.extensions.filter((extension) => extension.type !== "extension").map((extension) => extension.extend({ addNodeView: void 0 })) : coreSchemaExtensions(), DocumentMarkdown];
+}
+//#endregion
+export { previewExtensions };
+
+//# sourceMappingURL=preview-extensions.js.map

package/dist/features/ai/preview-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-extensions.js","names":[],"sources":["../../../src/features/ai/preview-extensions.ts"],"sourcesContent":["import type { AnyExtension, Editor } from '@tiptap/core'\nimport { DocumentMarkdown } from '../../core/document-markdown'\nimport { coreSchemaExtensions } from '../../core/schema'\n\n/**\n * Extensions of a read-only AI preview next to `editor`: the nodes and marks of its schema without their node views\n * (a preview never needs a composite's or a media block's live view), plus Markdown. Without an editor, the core schema.\n */\nexport function previewExtensions(editor: Editor | undefined): AnyExtension[] {\n  const schema = editor\n    ? editor.extensionManager.extensions.filter(extension => extension.type !== 'extension').map(extension => extension.extend({ addNodeView: undefined }))\n    : coreSchemaExtensions()\n  return [...schema, DocumentMarkdown]\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,kBAAkB,QAA4C;CAI5E,OAAO,CAAC,GAHO,SACX,OAAO,iBAAiB,WAAW,QAAO,cAAa,UAAU,SAAS,WAAW,CAAC,CAAC,KAAI,cAAa,UAAU,OAAO,EAAE,aAAa,KAAA,EAAU,CAAC,CAAC,IACpJ,qBAAqB,GACN,gBAAgB;AACrC"}

package/dist/features/ai/protocol/agent-ops.d.ts

@@ -0,0 +1,120 @@
+import { Locale } from "../../../i18n/index.js";
+//#region src/features/ai/protocol/agent-ops.d.ts
+/** Name of the tool the chat model calls to propose edits. */
+export declare const AGENT_TOOL = "edit_document";
+/** Per-turn limits: operations, Markdown per operation, IDs in a selection scope; retries after invalid IDs. */
+export declare const AGENT_LIMITS: {
+  readonly ops: 50;
+  readonly markdown: 8000;
+  readonly scope: 5000;
+  readonly retries: 2;
+};
+export declare const AGENT_OP_TYPES: readonly ["add", "update", "delete", "convert"];
+export type AgentOpType = typeof AGENT_OP_TYPES[number];
+/**
+ * One proposed edit as the model writes it: `update` replaces block `id` by `markdown`, `delete` removes block `id`,
+ * `add` inserts `markdown` (one or more blocks) after block `afterId` (`null`: at the start of the document), `convert`
+ * turns block `id` into the block type `to` (a `CONVERT_TARGET_IDS` entry or `composite:<kind>`), keeping its content.
+ */
+export type ModelAgentOp = {
+  type: 'update';
+  id: string;
+  markdown: string;
+} | {
+  type: 'delete';
+  id: string;
+} | {
+  type: 'add';
+  afterId: string | null;
+  markdown: string;
+} | {
+  type: 'convert';
+  id: string;
+  to: string;
+};
+/** A checked operation with the conversation-wide ID (`op1`, `op2`, …) that decisions refer to. */
+export type AgentOp = ModelAgentOp & {
+  op: string;
+};
+/**
+ * What became of an operation: decided in the review (`accepted`, `rejected`, `partial` for mixed hunks, `invalid`
+ * when its text changed underneath), still `pending`, or never reviewed: the review found nothing to show
+ * (`unchanged`, `missing` block, `overlap` with open AI changes, `empty` result), or the client refused it as out of
+ * scope (`blocked`).
+ */
+export declare const AGENT_OP_OUTCOMES: readonly ["accepted", "rejected", "partial", "invalid", "pending", "unchanged", "missing", "overlap", "empty", "blocked"];
+export type AgentOpOutcome = typeof AGENT_OP_OUTCOMES[number];
+/** Decision state of an earlier operation, sent with the next user message. */
+export interface AgentOpFeedback {
+  op: string;
+  type: AgentOpType;
+  target: string | null;
+  outcome: AgentOpOutcome;
+}
+/**
+ * Why an operation was dropped: unknown block ID, ID outside the scope, a missing/invalid field, a block edited twice,
+ * too many ops, a `convert` target that is not offered.
+ */
+export type AgentOpProblemReason = 'unknown' | 'scope' | 'field' | 'duplicate' | 'limit' | 'target';
+/** A dropped operation: its 1-based position in the tool call, type and target as far as readable, and the offending ID. */
+export interface AgentOpProblem {
+  index: number;
+  type: string | null;
+  id: string | null;
+  reason: AgentOpProblemReason;
+  detail: string;
+}
+/**
+ * Where operations may point: `known` IDs of the document; `allowed` the selection scope (null: the whole document);
+ * `targets` the block types `convert` may turn a block into; `locale` the language of the problem details (default `de`).
+ */
+export interface AgentOpContext {
+  known: (id: string) => boolean;
+  allowed: ReadonlySet<string> | null;
+  targets: ReadonlySet<string>;
+  locale?: Locale;
+}
+/** Block IDs of the chat document text (`[<id>] …` per line, see documentChatText). */
+export declare function documentBlockIds(document: string): Set<string>;
+/** The block an operation targets: `update`/`delete` its `id`, `add` its `afterId` (null: document start). */
+export declare function agentOpTarget(op: ModelAgentOp): string | null;
+/** How an outcome reads for the model, per locale; the chat shows the catalog's `ai.opTitle.*` texts. */
+export declare const AGENT_OP_OUTCOME_TEXT: Record<Locale, Record<AgentOpOutcome, string>>;
+/** Text options of the model-facing functions: `locale` selects the language (default `de`). */
+export interface AgentTextOptions {
+  locale?: Locale;
+}
+/** `update Block X`, `add nach Block X`, `add am Dokumentanfang`, `convert Block X → composite:task` (`to` when known); English with `locale: 'en'`. */
+export declare function agentOpSummary(op: {
+  type: AgentOpType;
+  target: string | null;
+  to?: string;
+}, { locale }?: AgentTextOptions): string;
+/**
+ * Checks the raw `ops` of `edit_document` calls: every ID must exist and lie in the scope (`add` in a selection scope
+ * needs an `afterId` from the selection), fields must be present, a `convert` target must be one of `targets`, and a
+ * block is updated, converted or deleted at most once. Returns the valid operations in order and the problems of the others;
+ * the problems' `detail` is written in `context.locale` (default `de`).
+ */
+export declare function checkAgentOps(raw: readonly unknown[], context: AgentOpContext): {
+  valid: ModelAgentOp[];
+  problems: AgentOpProblem[];
+};
+/** The problem for a tool call whose input was no object with the list `ops` (index 0), worded in `locale` (default `de`). */
+export declare function agentUnreadableProblem({ locale }?: AgentTextOptions): AgentOpProblem;
+/**
+ * Tool result asking the model to call `tool` (default `edit_document`, the host's own tool name when it exposes the
+ * operations under another one) again without the invalid operations' mistakes; worded in `locale` (default `de`).
+ * By default nothing was applied and the model resends the whole list; with `partial` the host already shows the
+ * valid operations, so the model resends only corrected versions of the listed ones.
+ */
+export declare function agentRetryMessage(problems: readonly AgentOpProblem[], scoped: boolean, { locale, tool, partial }?: AgentTextOptions & {
+  tool?: string;
+  partial?: boolean;
+}): string;
+/** Tool result of a past `edit_document` call: which operations were shown for review, and how many were dropped; worded in `locale` (default `de`). */
+export declare function agentShownMessage(ops: readonly AgentOp[], dropped: number, { locale }?: AgentTextOptions): string;
+/** „Entscheidungen zu deinen letzten Vorschlägen: op1 (update Block X) abgelehnt; …“ (English with `locale: 'en'`), or '' without feedback. */
+export declare function agentFeedbackText(feedback: readonly AgentOpFeedback[], { locale }?: AgentTextOptions): string;
+//#endregion
+//# sourceMappingURL=agent-ops.d.ts.map