@ecsplico/editor 2.0.0 → 2.1.1

package/dist/features/ai/components/AiSelectionMenu.vue.d.ts

@@ -5,7 +5,8 @@ import { Editor } from "@tiptap/vue-3";
  * (`selectionMenu`), the result streams into a preview and is applied over the range captured when the menu opened.
  * Caret mode (`/ai`, see `openAiMenuAtCaret`): the same popover opens at the caret with the `caretMenu` tasks and
  * `generate` as free prompt; the result is inserted at the caret line (`insertAtCaretLine`).
- * Needs the AiSelectionHighlight extension on the editor.
+ * Needs the AiSelectionHighlight extension on the editor. The flow (`createAiSelectionFlow`) owns every step; this
+ * component renders its state, places the popover and shows the preview.
  */
 type __VLS_Props = {
   editor: Editor;

package/dist/features/ai/components/AiSidebar.js

@@ -1,8 +1,8 @@
 import { conversionsOf } from "../../../core/pipeline.js";
-import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
-import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
 import { CHAT_LIMITS } from "../protocol/chat.js";
 import { AI_LIMITS, blockTasks, withTaskHeading } from "../protocol/tasks.js";
+import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
+import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
 import { selectionScope } from "../agent-ops.js";
 import { createAiSidebarFlow } from "../sidebar-flow.js";
 import { useNotifier } from "../../../vue/use-notifier.js";

package/dist/features/ai/components/DocumentChatAnswer.js

@@ -1,5 +1,5 @@
-import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
 import { citationBlockId } from "../protocol/chat.js";
+import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
 import { documentChatAnswerContent } from "../document-chat.js";
 import { previewExtensions } from "../preview-extensions.js";
 import { useNotifier } from "../../../vue/use-notifier.js";

package/dist/features/ai/components/DocumentChatOps.js

@@ -36,6 +36,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			invalid: "warning",
 			unchanged: "neutral",
 			missing: "warning",
+			stale: "warning",
 			overlap: "warning",
 			empty: "warning",
 			blocked: "warning"

package/dist/features/ai/components/DocumentChatOps.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentChatOps.js","names":["_openBlock","_createElementBlock","_Fragment","_renderList","_createVNode","_unref","_createElementVNode","_toDisplayString","_createBlock","_createCommentVNode"],"sources":["../../../../src/features/ai/components/DocumentChatOps.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { type ConversionProvider, conversionLabel, parseConversionTarget } from '../../../core'\nimport { AGENT_OP_OUTCOME_KEYS } from '../agent-ops'\nimport type { AgentOp, AgentOpOutcome, AgentOpProblem } from '../protocol'\nimport type { AgentOpState } from '../use-document-chat'\nimport { useUiKit } from '../../../vue/kit/use-ui-kit'\nimport { useEditorI18n } from '../../../vue/use-editor-i18n'\n\nconst { Alert: UAlert, Badge: UBadge, Button: UButton, Icon: UIcon } = useUiKit()\nconst { t } = useEditorI18n()\n\n/** The edit operations of one chat answer with their review state; open ones can be decided right here. */\nconst props = defineProps<{\n  ops: AgentOp[]\n  states: Record<string, AgentOpState>\n  /** Operations the server dropped (invalid block IDs after the retries). */\n  problems?: AgentOpProblem[]\n  /** The editor's conversion providers, to name `convert` targets. */\n  providers: readonly ConversionProvider[]\n}>()\n\nconst emit = defineEmits<{\n  decide: [id: string, accept: boolean]\n  reveal: [op: AgentOp]\n}>()\n\nconst ICONS: Record<AgentOp['type'], string> = { add: 'i-lucide-plus', update: 'i-lucide-pencil', delete: 'i-lucide-trash-2', convert: 'i-lucide-replace' }\n\nconst BADGE_COLORS: Record<AgentOpOutcome, 'primary' | 'success' | 'neutral' | 'warning' | 'info'> = {\n  pending: 'primary',\n  accepted: 'success',\n  rejected: 'neutral',\n  partial: 'info',\n  invalid: 'warning',\n  unchanged: 'neutral',\n  missing: 'warning',\n  overlap: 'warning',\n  empty: 'warning',\n  blocked: 'warning',\n}\n\nfunction label(op: AgentOp, snippet: string): string {\n  if (op.type === 'add') return op.afterId === null ? t('ai.op.addAtStart') : t('ai.op.addAfter', { snippet })\n  if (op.type === 'convert') {\n    const target = parseConversionTarget(props.providers, op.to)\n    return t('ai.op.convert', { target: target ? conversionLabel(props.providers, target, t).label : op.to, snippet })\n  }\n  return t(op.type === 'update' ? 'ai.op.update' : 'ai.op.delete', { snippet })\n}\n</script>\n\n<template>\n  <div class=\"mt-2 flex flex-col gap-1\">\n    <div\n      v-for=\"op in ops\"\n      :key=\"op.op\"\n      class=\"flex items-center gap-2 rounded-md border border-[var(--sk-border)] px-2 py-1\"\n      :data-agent-op=\"op.op\"\n    >\n      <UIcon :name=\"ICONS[op.type]\" class=\"size-4 shrink-0 text-[var(--sk-muted)]\" />\n      <button type=\"button\" class=\"min-w-0 flex-1 truncate text-left text-xs hover:underline\" :title=\"'markdown' in op ? op.markdown : undefined\" @click=\"emit('reveal', op)\">\n        {{ label(op, states[op.op]?.snippet ?? '') }}\n      </button>\n      <UBadge\n        v-if=\"states[op.op]\"\n        size=\"sm\"\n        variant=\"subtle\"\n        :color=\"BADGE_COLORS[states[op.op]!.outcome]\"\n        :label=\"t(AGENT_OP_OUTCOME_KEYS[states[op.op]!.outcome].badge)\"\n        :title=\"t(AGENT_OP_OUTCOME_KEYS[states[op.op]!.outcome].hover)\"\n      />\n      <template v-if=\"states[op.op]?.outcome === 'pending'\">\n        <UButton size=\"xs\" color=\"neutral\" variant=\"ghost\" icon=\"i-lucide-x\" :aria-label=\"t('ai.op.discard')\" @click=\"emit('decide', op.op, false)\" />\n        <UButton size=\"xs\" color=\"success\" variant=\"ghost\" icon=\"i-lucide-check\" :aria-label=\"t('ai.op.accept')\" @click=\"emit('decide', op.op, true)\" />\n      </template>\n    </div>\n    <UAlert\n      v-if=\"problems?.length\"\n      color=\"warning\"\n      variant=\"subtle\"\n      icon=\"i-lucide-triangle-alert\"\n      :title=\"problems.length === 1 ? t('ai.op.problems.one') : t('ai.op.problems.other', { n: problems.length })\"\n      :description=\"t('ai.op.problems.description')\"\n    />\n  </div>\n</template>\n"],"mappings":"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"}
+{"version":3,"file":"DocumentChatOps.js","names":["_openBlock","_createElementBlock","_Fragment","_renderList","_createVNode","_unref","_createElementVNode","_toDisplayString","_createBlock","_createCommentVNode"],"sources":["../../../../src/features/ai/components/DocumentChatOps.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { type ConversionProvider, conversionLabel, parseConversionTarget } from '../../../core'\nimport { AGENT_OP_OUTCOME_KEYS } from '../agent-ops'\nimport type { AgentOp, AgentOpOutcome, AgentOpProblem } from '../protocol'\nimport type { AgentOpState } from '../use-document-chat'\nimport { useUiKit } from '../../../vue/kit/use-ui-kit'\nimport { useEditorI18n } from '../../../vue/use-editor-i18n'\n\nconst { Alert: UAlert, Badge: UBadge, Button: UButton, Icon: UIcon } = useUiKit()\nconst { t } = useEditorI18n()\n\n/** The edit operations of one chat answer with their review state; open ones can be decided right here. */\nconst props = defineProps<{\n  ops: AgentOp[]\n  states: Record<string, AgentOpState>\n  /** Operations the server dropped (invalid block IDs after the retries). */\n  problems?: AgentOpProblem[]\n  /** The editor's conversion providers, to name `convert` targets. */\n  providers: readonly ConversionProvider[]\n}>()\n\nconst emit = defineEmits<{\n  decide: [id: string, accept: boolean]\n  reveal: [op: AgentOp]\n}>()\n\nconst ICONS: Record<AgentOp['type'], string> = { add: 'i-lucide-plus', update: 'i-lucide-pencil', delete: 'i-lucide-trash-2', convert: 'i-lucide-replace' }\n\nconst BADGE_COLORS: Record<AgentOpOutcome, 'primary' | 'success' | 'neutral' | 'warning' | 'info'> = {\n  pending: 'primary',\n  accepted: 'success',\n  rejected: 'neutral',\n  partial: 'info',\n  invalid: 'warning',\n  unchanged: 'neutral',\n  missing: 'warning',\n  stale: 'warning',\n  overlap: 'warning',\n  empty: 'warning',\n  blocked: 'warning',\n}\n\nfunction label(op: AgentOp, snippet: string): string {\n  if (op.type === 'add') return op.afterId === null ? t('ai.op.addAtStart') : t('ai.op.addAfter', { snippet })\n  if (op.type === 'convert') {\n    const target = parseConversionTarget(props.providers, op.to)\n    return t('ai.op.convert', { target: target ? conversionLabel(props.providers, target, t).label : op.to, snippet })\n  }\n  return t(op.type === 'update' ? 'ai.op.update' : 'ai.op.delete', { snippet })\n}\n</script>\n\n<template>\n  <div class=\"mt-2 flex flex-col gap-1\">\n    <div\n      v-for=\"op in ops\"\n      :key=\"op.op\"\n      class=\"flex items-center gap-2 rounded-md border border-[var(--sk-border)] px-2 py-1\"\n      :data-agent-op=\"op.op\"\n    >\n      <UIcon :name=\"ICONS[op.type]\" class=\"size-4 shrink-0 text-[var(--sk-muted)]\" />\n      <button type=\"button\" class=\"min-w-0 flex-1 truncate text-left text-xs hover:underline\" :title=\"'markdown' in op ? op.markdown : undefined\" @click=\"emit('reveal', op)\">\n        {{ label(op, states[op.op]?.snippet ?? '') }}\n      </button>\n      <UBadge\n        v-if=\"states[op.op]\"\n        size=\"sm\"\n        variant=\"subtle\"\n        :color=\"BADGE_COLORS[states[op.op]!.outcome]\"\n        :label=\"t(AGENT_OP_OUTCOME_KEYS[states[op.op]!.outcome].badge)\"\n        :title=\"t(AGENT_OP_OUTCOME_KEYS[states[op.op]!.outcome].hover)\"\n      />\n      <template v-if=\"states[op.op]?.outcome === 'pending'\">\n        <UButton size=\"xs\" color=\"neutral\" variant=\"ghost\" icon=\"i-lucide-x\" :aria-label=\"t('ai.op.discard')\" @click=\"emit('decide', op.op, false)\" />\n        <UButton size=\"xs\" color=\"success\" variant=\"ghost\" icon=\"i-lucide-check\" :aria-label=\"t('ai.op.accept')\" @click=\"emit('decide', op.op, true)\" />\n      </template>\n    </div>\n    <UAlert\n      v-if=\"problems?.length\"\n      color=\"warning\"\n      variant=\"subtle\"\n      icon=\"i-lucide-triangle-alert\"\n      :title=\"problems.length === 1 ? t('ai.op.problems.one') : t('ai.op.problems.other', { n: problems.length })\"\n      :description=\"t('ai.op.problems.description')\"\n    />\n  </div>\n</template>\n"],"mappings":"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"}

package/dist/features/ai/components/ModelQuickSwitch.js

@@ -1,8 +1,8 @@
+import { MODEL_SLOT_KEYS } from "../protocol/models.js";
 import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
 import { useEditorSettings } from "../../../vue/settings.js";
 import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
 import { useEditorUi } from "../../../vue/use-editor-ui.js";
-import { MODEL_SLOT_KEYS } from "../protocol/models.js";
 import { useModelProfiles } from "../use-model-profiles.js";
 import { computed, createBlock, defineComponent, openBlock, ref, unref } from "vue";
 //#region src/features/ai/components/ModelQuickSwitch.vue

package/dist/features/ai/components/SettingsAiTab.js

@@ -1,8 +1,8 @@
 import { AI_LANGUAGES, MODEL_SLOTS } from "../../../settings/values.js";
+import { AI_LANGUAGE_KEYS, MODEL_SLOT_KEYS } from "../protocol/models.js";
 import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
 import { useEditorSettings } from "../../../vue/settings.js";
 import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
-import { AI_LANGUAGE_KEYS, MODEL_SLOT_KEYS } from "../protocol/models.js";
 import _sfc_main$1 from "./ModelQuickSwitch.js";
 import _sfc_main$2 from "../../../vue/components/SettingsSection.js";
 import _sfc_main$3 from "./SettingsModelProfiles.js";

package/dist/features/ai/components/SettingsModelProfiles.js

@@ -1,7 +1,7 @@
 import { fetchErrorMessage } from "../../../core/fetch-error.js";
+import { modelRefSchema } from "../protocol/models.js";
 import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
 import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
-import { modelRefSchema } from "../protocol/models.js";
 import { isRateLimited } from "../rate-limit.js";
 import { useModelProfiles } from "../use-model-profiles.js";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, openBlock, ref, renderList, shallowRef, toDisplayString, unref, watch, withCtx, withModifiers } from "vue";

package/dist/features/ai/document-chat.d.ts

@@ -2,8 +2,9 @@ import { Editor, JSONContent } from "@tiptap/core";
 import { Node as Node$1 } from "@tiptap/pm/model";
 //#region src/features/ai/document-chat.d.ts
 /**
- * The document as sent to the chat: one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`),
- * with list markers and quote prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or
+ * The document as sent to the chat, in the line format of `protocol/block-lines.ts` (which also reads and describes
+ * it): one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`), with list markers and quote
+ * prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or
  * block quotes link to exactly that paragraph. A block container below the document (a composite: the schema flags it
  * `editorBlockContainer`, its title/description/tags rows `editorChrome`) is a header line `[<id>] ::: <kind> {meta} |
  * <title> | <description> | Tags: #a` (empty parts left out), its body blocks two spaces further in, and a closing

package/dist/features/ai/document-chat.js

@@ -2,13 +2,14 @@ import { blockIdOf, findBlockById } from "../../core/schema/block-ids.js";
 import { isBlockContainer, isChromeNode } from "../../core/schema/node-flags.js";
 import { isWrapperBlock } from "../../core/convert.js";
 import { parseBlocks } from "../../core/pipeline.js";
+import { TRUNCATED_LINE, blockLine, compositeChromePart, compositeLineClose, compositeLineHeader, continuedLinePrefix, listLinePrefix, nestedLinePrefix, quoteLinePrefix, singleBlockLine } from "./protocol/block-lines.js";
 import { CHAT_LIMITS, CITATION_HREF_PREFIX, citationBlockId } from "./protocol/chat.js";
 import { Fragment } from "@tiptap/pm/model";
 //#region src/features/ai/document-chat.ts
-const TRUNCATED = "[…] (Rest des Dokuments gekürzt)";
 /**
-* The document as sent to the chat: one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`),
-* with list markers and quote prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or
+* The document as sent to the chat, in the line format of `protocol/block-lines.ts` (which also reads and describes
+* it): one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`), with list markers and quote
+* prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or
 * block quotes link to exactly that paragraph. A block container below the document (a composite: the schema flags it
 * `editorBlockContainer`, its title/description/tags rows `editorChrome`) is a header line `[<id>] ::: <kind> {meta} |
 * <title> | <description> | Tags: #a` (empty parts left out), its body blocks two spaces further in, and a closing
@@ -36,25 +37,21 @@ function documentChatText(editor) {
 	const emit = (node, prefix, id) => {
 		const markdown = markdownOf(node);
 		if (!markdown) return;
-		const text = node.type.name === "codeBlock" ? markdown : markdown.replace(/\s*\n\s*/g, " ");
-		push(`${id ? `[${id}] ` : ""}${prefix}${text}`);
+		push(blockLine(id, prefix, node.type.name === "codeBlock" ? markdown : singleBlockLine(markdown)));
 	};
 	const container = (node, prefix, id) => {
-		const meta = node.attrs.meta;
-		const parts = [`::: ${String(node.attrs.kind)}${meta && typeof meta === "object" && Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : ""}`];
+		const chrome = [];
 		node.forEach((child) => {
-			if (!isChromeNode(child)) return;
-			const text = markdownOf(child).replace(/^(?:#+|>) ?/, "").replace(/\s*\n\s*/g, " ");
-			if (text) parts.push(text);
+			if (isChromeNode(child)) chrome.push(compositeChromePart(markdownOf(child)));
 		});
-		push(`${id ? `[${id}] ` : ""}${prefix}${parts.join(" | ")}`);
-		visit(node, `${prefix}  `, id);
-		push(`${prefix}  :::`);
+		push(blockLine(id, prefix, compositeLineHeader(String(node.attrs.kind), node.attrs.meta, chrome)));
+		visit(node, nestedLinePrefix(prefix), id);
+		push(compositeLineClose(prefix));
 	};
 	const wrapper = (node, prefix, id) => {
 		const header = markdownOf(node.copy(Fragment.empty)).split("\n")[0] ?? "";
-		if (header) push(`${id ? `[${id}] ` : ""}${prefix}${header}`);
-		visit(node, header ? `${prefix}  ` : prefix, id);
+		if (header) push(blockLine(id, prefix, header));
+		visit(node, header ? nestedLinePrefix(prefix) : prefix, id);
 	};
 	const visit = (node, prefix, parentId) => {
 		let current = prefix;
@@ -63,17 +60,17 @@ function documentChatText(editor) {
 			const id = blockIdOf(child) ?? parentId;
 			if (child.isTextblock || child.isLeaf) emit(child, current, id);
 			else if (isBlockContainer(child)) container(child, current, id);
-			else if (child.type.name === "blockquote") visit(child, `${current}> `, id);
+			else if (child.type.name === "blockquote") visit(child, quoteLinePrefix(current), id);
 			else if (child.type.name === "bulletList" || child.type.name === "orderedList") {
 				const start = Number(child.attrs.start ?? 1);
-				child.forEach((item, _o, i) => visit(item, `${current}${child.type.name === "orderedList" ? `${start + i}. ` : "- "}`, id));
+				child.forEach((item, _o, i) => visit(item, listLinePrefix(current, child.type.name === "orderedList", start + i), id));
 			} else if (isWrapperBlock(child)) wrapper(child, current, id);
 			else visit(child, current, id);
-			if (index === 0) current = prefix.replace(/(?:- |\d+\. )$/, (marker) => " ".repeat(marker.length));
+			if (index === 0) current = continuedLinePrefix(prefix);
 		});
 	};
 	visit(editor.state.doc, "", null);
-	if (full) lines.push(TRUNCATED);
+	if (full) lines.push(TRUNCATED_LINE);
 	return lines.join("\n");
 }
 /**

package/dist/features/ai/document-chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-chat.js","names":[],"sources":["../../../src/features/ai/document-chat.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { Fragment, type Node as PMNode } from '@tiptap/pm/model'\nimport { isWrapperBlock, parseBlocks } from '../../core'\nimport { blockIdOf, findBlockById, isBlockContainer, isChromeNode } from '../../core/schema'\nimport { CHAT_LIMITS, CITATION_HREF_PREFIX, citationBlockId } from './protocol'\n\n// i18n-ignore: the marker is part of the document text sent to the model\nconst TRUNCATED = '[…] (Rest des Dokuments gekürzt)'\n\n/**\n * The document as sent to the chat: one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`),\n * with list markers and quote prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or\n * block quotes link to exactly that paragraph. A block container below the document (a composite: the schema flags it\n * `editorBlockContainer`, its title/description/tags rows `editorChrome`) is a header line `[<id>] ::: <kind> {meta} |\n * <title> | <description> | Tags: #a` (empty parts left out), its body blocks two spaces further in, and a closing\n * `:::` line without ID at that indent. Any other non-list block with block content (a host block such as a callout) is\n * a header line `[<id>] <first line of its Markdown form without content>` (`!!! info`) with its body blocks two spaces\n * further in, each with its own ID and no closing line; if that header is empty, only the body blocks appear. Cut at\n * whole lines to fit `CHAT_LIMITS.document`.\n */\nexport function documentChatText(editor: Editor): string {\n  const lines: string[] = []\n  let size = 0\n  let full = false\n\n  const push = (line: string) => {\n    if (full || size + line.length + 1 > CHAT_LIMITS.document - TRUNCATED.length - 1) {\n      full = true\n      return\n    }\n    lines.push(line)\n    size += line.length + 1\n  }\n  const markdownOf = (node: PMNode) => editor.markdown!.serialize({ type: 'doc', content: [node.toJSON()] }).trim()\n\n  const emit = (node: PMNode, prefix: string, id: string | null) => {\n    const markdown = markdownOf(node)\n    if (!markdown) return\n    // Hard breaks and wrapped lines would start new \"blocks\"; code keeps its lines.\n    const text = node.type.name === 'codeBlock' ? markdown : markdown.replace(/\\s*\\n\\s*/g, ' ')\n    push(`${id ? `[${id}] ` : ''}${prefix}${text}`)\n  }\n\n  const container = (node: PMNode, prefix: string, id: string | null) => {\n    const meta: unknown = node.attrs.meta\n    const parts = [`::: ${String(node.attrs.kind)}${meta && typeof meta === 'object' && Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : ''}`]\n    node.forEach((child) => {\n      if (!isChromeNode(child)) return\n      // The chrome's own Markdown (`## title`, `> description`, `Tags: #a`) without the block markers.\n      const text = markdownOf(child).replace(/^(?:#+|>) ?/, '').replace(/\\s*\\n\\s*/g, ' ')\n      if (text) parts.push(text)\n    })\n    push(`${id ? `[${id}] ` : ''}${prefix}${parts.join(' | ')}`)\n    visit(node, `${prefix}  `, id)\n    push(`${prefix}  :::`)\n  }\n\n  // A host block with block content (a callout): its own Markdown form without content as the header line, the body\n  // blocks two spaces further in, each with its own ID, no closing line (the form has none).\n  const wrapper = (node: PMNode, prefix: string, id: string | null) => {\n    const header = markdownOf(node.copy(Fragment.empty)).split('\\n')[0] ?? ''\n    if (header) push(`${id ? `[${id}] ` : ''}${prefix}${header}`)\n    visit(node, header ? `${prefix}  ` : prefix, id)\n  }\n\n  const visit = (node: PMNode, prefix: string, parentId: string | null) => {\n    let current = prefix\n    node.forEach((child, _offset, index) => {\n      if (full || isChromeNode(child)) return\n      const id = blockIdOf(child) ?? parentId\n      if (child.isTextblock || child.isLeaf) emit(child, current, id)\n      else if (isBlockContainer(child)) container(child, current, id)\n      else if (child.type.name === 'blockquote') visit(child, `${current}> `, id)\n      else if (child.type.name === 'bulletList' || child.type.name === 'orderedList') {\n        const start = Number(child.attrs.start ?? 1)\n        child.forEach((item, _o, i) => visit(item, `${current}${child.type.name === 'orderedList' ? `${start + i}. ` : '- '}`, id))\n      }\n      else if (isWrapperBlock(child)) wrapper(child, current, id)\n      else visit(child, current, id)\n      // Later blocks of the same list item continue under its marker instead of repeating it.\n      if (index === 0) current = prefix.replace(/(?:- |\\d+\\. )$/, marker => ' '.repeat(marker.length))\n    })\n  }\n\n  visit(editor.state.doc, '', null)\n  if (full) lines.push(TRUNCATED)\n  return lines.join('\\n')\n}\n\n/**\n * Chat answer Markdown parsed for display with the pipeline of `editor` (speaker lines become segments where a feature\n * contributes them): quote links whose block exists in `doc` point to `#block-<id>`, and quote links to unknown blocks\n * lose the link (plain text).\n */\nexport function documentChatAnswerContent(editor: Editor, markdown: string, doc: PMNode | undefined): JSONContent {\n  const resolve = (node: JSONContent): JSONContent => {\n    const marks = node.marks?.flatMap((mark) => {\n      if (mark.type !== 'link') return [mark]\n      const id = citationBlockId(mark.attrs?.href)\n      if (id === null) return [mark]\n      return doc && findBlockById(doc, id) ? [{ ...mark, attrs: { ...mark.attrs, href: `${CITATION_HREF_PREFIX}${id}` } }] : []\n    })\n    return { ...node, ...(marks && { marks }), ...(node.content && { content: node.content.map(resolve) }) }\n  }\n  return resolve({ type: 'doc', content: parseBlocks(editor, markdown).blocks })\n}\n"],"mappings":"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"}
+{"version":3,"file":"document-chat.js","names":[],"sources":["../../../src/features/ai/document-chat.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { Fragment, type Node as PMNode } from '@tiptap/pm/model'\nimport { isWrapperBlock, parseBlocks } from '../../core'\nimport { blockIdOf, findBlockById, isBlockContainer, isChromeNode } from '../../core/schema'\nimport { blockLine, CHAT_LIMITS, CITATION_HREF_PREFIX, citationBlockId, compositeChromePart, compositeLineClose, compositeLineHeader, continuedLinePrefix, listLinePrefix, nestedLinePrefix, quoteLinePrefix, singleBlockLine, TRUNCATED_LINE } from './protocol'\n\n/**\n * The document as sent to the chat, in the line format of `protocol/block-lines.ts` (which also reads and describes\n * it): one line per text block, `[<block id>] <Markdown>` (e.g. `[…] **Anna:** Text`), with list markers and quote\n * prefixes after the ID. Nested blocks carry their own IDs, so quotes from list items or\n * block quotes link to exactly that paragraph. A block container below the document (a composite: the schema flags it\n * `editorBlockContainer`, its title/description/tags rows `editorChrome`) is a header line `[<id>] ::: <kind> {meta} |\n * <title> | <description> | Tags: #a` (empty parts left out), its body blocks two spaces further in, and a closing\n * `:::` line without ID at that indent. Any other non-list block with block content (a host block such as a callout) is\n * a header line `[<id>] <first line of its Markdown form without content>` (`!!! info`) with its body blocks two spaces\n * further in, each with its own ID and no closing line; if that header is empty, only the body blocks appear. Cut at\n * whole lines to fit `CHAT_LIMITS.document`.\n */\nexport function documentChatText(editor: Editor): string {\n  const lines: string[] = []\n  let size = 0\n  let full = false\n\n  const push = (line: string) => {\n    if (full || size + line.length + 1 > CHAT_LIMITS.document - TRUNCATED_LINE.length - 1) {\n      full = true\n      return\n    }\n    lines.push(line)\n    size += line.length + 1\n  }\n  const markdownOf = (node: PMNode) => editor.markdown!.serialize({ type: 'doc', content: [node.toJSON()] }).trim()\n\n  const emit = (node: PMNode, prefix: string, id: string | null) => {\n    const markdown = markdownOf(node)\n    if (!markdown) return\n    // Hard breaks and wrapped lines would start new \"blocks\"; code keeps its lines.\n    push(blockLine(id, prefix, node.type.name === 'codeBlock' ? markdown : singleBlockLine(markdown)))\n  }\n\n  const container = (node: PMNode, prefix: string, id: string | null) => {\n    const chrome: string[] = []\n    // The chrome's own Markdown (`## title`, `> description`, `Tags: #a`) without the block markers.\n    node.forEach((child) => {\n      if (isChromeNode(child)) chrome.push(compositeChromePart(markdownOf(child)))\n    })\n    push(blockLine(id, prefix, compositeLineHeader(String(node.attrs.kind), node.attrs.meta, chrome)))\n    visit(node, nestedLinePrefix(prefix), id)\n    push(compositeLineClose(prefix))\n  }\n\n  // A host block with block content (a callout): its own Markdown form without content as the header line, the body\n  // blocks two spaces further in, each with its own ID, no closing line (the form has none).\n  const wrapper = (node: PMNode, prefix: string, id: string | null) => {\n    const header = markdownOf(node.copy(Fragment.empty)).split('\\n')[0] ?? ''\n    if (header) push(blockLine(id, prefix, header))\n    visit(node, header ? nestedLinePrefix(prefix) : prefix, id)\n  }\n\n  const visit = (node: PMNode, prefix: string, parentId: string | null) => {\n    let current = prefix\n    node.forEach((child, _offset, index) => {\n      if (full || isChromeNode(child)) return\n      const id = blockIdOf(child) ?? parentId\n      if (child.isTextblock || child.isLeaf) emit(child, current, id)\n      else if (isBlockContainer(child)) container(child, current, id)\n      else if (child.type.name === 'blockquote') visit(child, quoteLinePrefix(current), id)\n      else if (child.type.name === 'bulletList' || child.type.name === 'orderedList') {\n        const start = Number(child.attrs.start ?? 1)\n        child.forEach((item, _o, i) => visit(item, listLinePrefix(current, child.type.name === 'orderedList', start + i), id))\n      }\n      else if (isWrapperBlock(child)) wrapper(child, current, id)\n      else visit(child, current, id)\n      // Later blocks of the same list item continue under its marker instead of repeating it.\n      if (index === 0) current = continuedLinePrefix(prefix)\n    })\n  }\n\n  visit(editor.state.doc, '', null)\n  if (full) lines.push(TRUNCATED_LINE)\n  return lines.join('\\n')\n}\n\n/**\n * Chat answer Markdown parsed for display with the pipeline of `editor` (speaker lines become segments where a feature\n * contributes them): quote links whose block exists in `doc` point to `#block-<id>`, and quote links to unknown blocks\n * lose the link (plain text).\n */\nexport function documentChatAnswerContent(editor: Editor, markdown: string, doc: PMNode | undefined): JSONContent {\n  const resolve = (node: JSONContent): JSONContent => {\n    const marks = node.marks?.flatMap((mark) => {\n      if (mark.type !== 'link') return [mark]\n      const id = citationBlockId(mark.attrs?.href)\n      if (id === null) return [mark]\n      return doc && findBlockById(doc, id) ? [{ ...mark, attrs: { ...mark.attrs, href: `${CITATION_HREF_PREFIX}${id}` } }] : []\n    })\n    return { ...node, ...(marks && { marks }), ...(node.content && { content: node.content.map(resolve) }) }\n  }\n  return resolve({ type: 'doc', content: parseBlocks(editor, markdown).blocks })\n}\n"],"mappings":"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"}

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

@@ -1,11 +1,12 @@
-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 { BLOCK_LINES_LABEL, BLOCK_LINE_COMPOSITE_TEXT, BLOCK_LINE_ECHO_TEXT, BLOCK_LINE_EXAMPLE, BLOCK_LINE_EXAMPLE_ID, BLOCK_LINE_EXAMPLE_TEXT, BLOCK_LINE_HOST_TEXT, BLOCK_LINE_IDS_HINT, BLOCK_LINE_INTRO, BLOCK_LINE_LIST_TEXT, BLOCK_LINE_MARKERS, BlockLines, TRUNCATED_LINE, blockLine, compositeChromePart, compositeLineClose, compositeLineHeader, continuedLinePrefix, listLinePrefix, nestedLinePrefix, quoteLinePrefix, readBlockLines, singleBlockLine, stripBlockLineEcho, stripListMarkerEcho } from "./protocol/block-lines.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 } 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 { AiReview, AiReviewChange, AiReviewChangeSummary, AiReviewDecision, AiReviewHandle, AiReviewHunk, AiReviewOptions, AiReviewOutcome, AiReviewSkipReason, AiReviewState, acceptAiReview, aiReviewKey, rejectAiReview, setActiveAiReviewHunk, startAiReview } from "./ai-review.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";
@@ -21,4 +22,5 @@ import { GhostAutocompleteOptions, completionFetcher, ghostAutocomplete, ghostAu
 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 };
+import { AI_SELECTION_MENU_KEY, AiSelectionFlow, AiSelectionFlowOptions, AiSelectionMode, AiSelectionRequest, AiSelectionState, createAiSelectionFlow } from "./selection-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_SELECTION_MENU_KEY, 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, type AiSelectionFlow, type AiSelectionFlowOptions, AiSelectionHighlight, type AiSelectionMode, type AiSelectionRequest, type AiSelectionState, type AiSidebarFlow, type AiSidebarFlowOptions, type AiSseOutcome, type AiStatus, type AiTarget, AiTask, AiTaskId, type AiUi, BLOCK_LINES_LABEL, BLOCK_LINE_COMPOSITE_TEXT, BLOCK_LINE_ECHO_TEXT, BLOCK_LINE_EXAMPLE, BLOCK_LINE_EXAMPLE_ID, BLOCK_LINE_EXAMPLE_TEXT, BLOCK_LINE_HOST_TEXT, BLOCK_LINE_IDS_HINT, BLOCK_LINE_INTRO, BLOCK_LINE_LIST_TEXT, BLOCK_LINE_MARKERS, BlockLines, 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, TRUNCATED_LINE, UserModelProfile, acceptAiReview, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, aiApplyFailure, aiBlockAction, aiBlockInputSchema, aiBlockSchema, aiFeatureCore, aiMenuActionsOf, aiReviewKey, aiSelectionHighlightKey, aiSlashCommand, applyAiResult, blockLine, blockTasks, blockTextRange, captureTarget, checkAgentOps, citationBlockId, cleanCompletion, completeMessages, completionFetcher, completionReady, compositeChromePart, compositeLineClose, compositeLineHeader, continuedLinePrefix, createAgentOpReview, createAiAssistant, createAiSelectionFlow, createAiSidebarFlow, createDocumentChat, documentChatMessages, documentChatText, documentMarkdown, formatTaskResult, ghostAutocomplete, ghostAutocompleteKey, hideAiSelectionHighlight, inBlockTasks, insertAtCaretLine, insertBlocksAtTarget, insertBlocksBelow, isRateLimited, listLinePrefix, modelProfiles, modelRefSchema, nestedLinePrefix, notifyAiRateLimited, openAiMenuAtCaret, openAiMenuForSelection, postAiSse, quoteLinePrefix, rangeMarkdown, readBlockLines, rejectAiReview, resultBlocks, selectionMarkdown, selectionScope, setActiveAiReviewHunk, showAiSelectionHighlight, singleBlockLine, startAiReview, stripBlockLineEcho, stripListMarkerEcho, withHeading, withTaskHeading };

package/dist/features/ai/index.js

@@ -1,4 +1,5 @@
-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 { BLOCK_LINES_LABEL, BLOCK_LINE_COMPOSITE_TEXT, BLOCK_LINE_ECHO_TEXT, BLOCK_LINE_EXAMPLE, BLOCK_LINE_EXAMPLE_ID, BLOCK_LINE_EXAMPLE_TEXT, BLOCK_LINE_HOST_TEXT, BLOCK_LINE_IDS_HINT, BLOCK_LINE_INTRO, BLOCK_LINE_LIST_TEXT, BLOCK_LINE_MARKERS, TRUNCATED_LINE, blockLine, compositeChromePart, compositeLineClose, compositeLineHeader, continuedLinePrefix, listLinePrefix, nestedLinePrefix, quoteLinePrefix, readBlockLines, singleBlockLine, stripBlockLineEcho, stripListMarkerEcho } from "./protocol/block-lines.js";
+import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_OUTCOME_TEXT, AGENT_OP_TYPES, AGENT_TOOL, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, checkAgentOps } 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";
@@ -20,4 +21,5 @@ import { completionFetcher, ghostAutocomplete, ghostAutocompleteKey } from "./gh
 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 };
+import { AI_SELECTION_MENU_KEY, createAiSelectionFlow } from "./selection-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_SELECTION_MENU_KEY, AI_TASKS, AI_TASK_IDS, AiReview, AiSelectionHighlight, BLOCK_LINES_LABEL, BLOCK_LINE_COMPOSITE_TEXT, BLOCK_LINE_ECHO_TEXT, BLOCK_LINE_EXAMPLE, BLOCK_LINE_EXAMPLE_ID, BLOCK_LINE_EXAMPLE_TEXT, BLOCK_LINE_HOST_TEXT, BLOCK_LINE_IDS_HINT, BLOCK_LINE_INTRO, BLOCK_LINE_LIST_TEXT, BLOCK_LINE_MARKERS, CHAT_LIMITS, CITATION_HREF_PREFIX, MODEL_REF_LIMITS, MODEL_SLOT_KEYS, TRUNCATED_LINE, acceptAiReview, agentFeedbackText, agentOpSummary, agentOpTarget, agentRetryMessage, agentShownMessage, agentUnreadableProblem, aiApplyFailure, aiBlockAction, aiBlockInputSchema, aiBlockSchema, aiFeatureCore, aiMenuActionsOf, aiReviewKey, aiSelectionHighlightKey, aiSlashCommand, applyAiResult, blockLine, blockTasks, blockTextRange, captureTarget, checkAgentOps, citationBlockId, cleanCompletion, completeMessages, completionFetcher, completionReady, compositeChromePart, compositeLineClose, compositeLineHeader, continuedLinePrefix, createAgentOpReview, createAiAssistant, createAiSelectionFlow, createAiSidebarFlow, createDocumentChat, documentChatMessages, documentChatText, documentMarkdown, formatTaskResult, ghostAutocomplete, ghostAutocompleteKey, hideAiSelectionHighlight, inBlockTasks, insertAtCaretLine, insertBlocksAtTarget, insertBlocksBelow, isRateLimited, listLinePrefix, modelProfiles, modelRefSchema, nestedLinePrefix, notifyAiRateLimited, openAiMenuAtCaret, openAiMenuForSelection, postAiSse, quoteLinePrefix, rangeMarkdown, readBlockLines, rejectAiReview, resultBlocks, selectionMarkdown, selectionScope, setActiveAiReviewHunk, showAiSelectionHighlight, singleBlockLine, startAiReview, stripBlockLineEcho, stripListMarkerEcho, withHeading, withTaskHeading };

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

@@ -1,4 +1,5 @@
 import { Locale } from "../../../i18n/index.js";
+import { BlockLines } from "./block-lines.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";
@@ -13,8 +14,9 @@ export declare const AGENT_OP_TYPES: readonly ["add", "update", "delete", "conve
 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.
+ * `add` inserts `markdown` (one or more blocks) after block `afterId` (`null`: at the start of the document; the key
+ * is required), `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';
@@ -38,11 +40,11 @@ export type AgentOp = ModelAgentOp & {
 };
 /**
  * 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`).
+ * when its text changed underneath), still `pending`, or never reviewed: the client found its block deleted since the
+ * document went to the model (`stale`) or refused it as out of scope (`blocked`), or the review found nothing to show
+ * (`unchanged`, `missing` block, `overlap` with open AI changes, `empty` result).
  */
-export declare const AGENT_OP_OUTCOMES: readonly ["accepted", "rejected", "partial", "invalid", "pending", "unchanged", "missing", "overlap", "empty", "blocked"];
+export declare const AGENT_OP_OUTCOMES: readonly ["accepted", "rejected", "partial", "invalid", "pending", "unchanged", "missing", "stale", "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 {
@@ -53,9 +55,10 @@ export interface AgentOpFeedback {
 }
 /**
  * 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.
+ * too many ops, a `convert` target that is not offered, a block inside another block that an operation of the same
+ * answer replaces or deletes (`inside`).
  */
-export type AgentOpProblemReason = 'unknown' | 'scope' | 'field' | 'duplicate' | 'limit' | 'target';
+export type AgentOpProblemReason = 'unknown' | 'scope' | 'field' | 'duplicate' | 'limit' | 'target' | 'inside';
 /** 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;
@@ -65,17 +68,16 @@ export interface AgentOpProblem {
   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`).
+ * Where operations may point: `lines` the block IDs of the document text and which blocks lie inside which (see
+ * `readBlockLines`); `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;
+  lines: BlockLines;
   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. */
@@ -91,10 +93,13 @@ export declare function agentOpSummary(op: {
   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`).
+ * Checks the raw `ops` of `edit_document` calls: every ID must exist and lie in the scope (`add` needs its `afterId`
+ * key, `null` for the document start, and in a selection scope an `afterId` from the selection), fields must be
+ * present, a `convert` target must be one of `targets`, a block is updated, converted or deleted at most once, and no
+ * operation may point into a block (`lines.below`) that another operation replaces (`update`) or deletes: the
+ * operation on the outer block wins. Several `add`s after the same block are fine; the client inserts them in the
+ * order they were written. 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[];