@blokkli/editor 2.0.0-alpha.64 → 2.0.0-alpha.65

package/dist/module.d.mts

@@ -1,6 +1,6 @@
 import { NuxtModule } from 'nuxt/schema';
-import { M as ModuleOptions } from './shared/editor.BDyiQvbV.mjs';
-export { a as ModuleHooks } from './shared/editor.BDyiQvbV.mjs';
+import { M as ModuleOptions } from './shared/editor.S5sA3rij.mjs';
+export { a as ModuleHooks } from './shared/editor.S5sA3rij.mjs';
 import 'consola';
 import '../dist/global/types/definitions.js';
 import '../dist/global/types/theme.js';

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@blokkli/editor",
   "configKey": "blokkli",
-  "version": "2.0.0-alpha.64",
+  "version": "2.0.0-alpha.65",
   "compatibility": {
     "nuxt": ">=3.15.0"
   },

package/dist/module.mjs

@@ -19,7 +19,7 @@ import 'typescript';
 import 'oxc-walker';
 
 const name = "@blokkli/editor";
-const version = "2.0.0-alpha.64";
+const version = "2.0.0-alpha.65";
 
 function validateOption(optionKey, option, icons) {
   const errors = [];
@@ -1203,6 +1203,11 @@ class ModuleHelper {
    * module and enabled sub-modules. Flushed by {@link applyBuildConfig}.
    */
   packageDependencies = /* @__PURE__ */ new Set();
+  /**
+   * npm packages that must resolve to a single copy across the whole app.
+   * Flushed to Vite's resolve.dedupe by {@link applyBuildConfig}.
+   */
+  dedupedPackages = /* @__PURE__ */ new Set();
   isDev;
   isModuleBuild;
   isPrepare;
@@ -1279,11 +1284,28 @@ class ModuleHelper {
       this.packageDependencies.add(name);
     }
   }
+  /**
+   * Declare packages that must only ever exist once in the module graph.
+   *
+   * Libraries that rely on `instanceof` checks or module-level registries break
+   * when a project's install tree ends up with two copies (e.g. a hoisted
+   * version plus an older one nested under a transitive dependency). Forcing
+   * resolution to a single copy makes the editor work regardless of how the
+   * host project's package manager arranged node_modules.
+   *
+   * @param names - Bare package specifiers (e.g. 'prosemirror-model').
+   */
+  addDedupedPackage(...names) {
+    for (const name of names) {
+      this.dedupedPackages.add(name);
+    }
+  }
   /**
    * Apply collected build configuration to the Nuxt/Vite config.
    *
    * Called once by the core module after every module's setup has run, so it
-   * sees the full set of {@link addPackageDependency} registrations.
+   * sees the full set of {@link addPackageDependency} and
+   * {@link addDedupedPackage} registrations.
    */
   applyBuildConfig() {
     this.nuxt.options.vite.optimizeDeps ??= {};
@@ -1295,6 +1317,13 @@ class ModuleHelper {
       }
       include.push(name);
     }
+    this.nuxt.options.vite.resolve ??= {};
+    const dedupe = this.nuxt.options.vite.resolve.dedupe ??= [];
+    for (const name of this.dedupedPackages) {
+      if (!dedupe.includes(name)) {
+        dedupe.push(name);
+      }
+    }
   }
   addAlias(name, path) {
     this.nuxt.options.alias[name] = path;
@@ -4695,6 +4724,23 @@ const module$1 = defineNuxtModule({
       "qrcode.vue",
       "twgl.js"
     );
+    helper.addDedupedPackage(
+      "@tiptap/core",
+      "@tiptap/pm",
+      "prosemirror-changeset",
+      "prosemirror-commands",
+      "prosemirror-dropcursor",
+      "prosemirror-gapcursor",
+      "prosemirror-history",
+      "prosemirror-inputrules",
+      "prosemirror-keymap",
+      "prosemirror-model",
+      "prosemirror-schema-list",
+      "prosemirror-state",
+      "prosemirror-tables",
+      "prosemirror-transform",
+      "prosemirror-view"
+    );
     helper.applyBuildConfig();
     helper.addComponent("BlokkliField");
     helper.addComponent("BlokkliEditable");

package/dist/modules/agent/index.d.mts

@@ -1,4 +1,4 @@
-import { B as BlokkliModule } from '../../shared/editor.BDyiQvbV.mjs';
+import { B as BlokkliModule } from '../../shared/editor.S5sA3rij.mjs';
 import 'nuxt/schema';
 import 'consola';
 import '../../../dist/global/types/definitions.js';

package/dist/modules/agent/runtime/app/helpers/mutationResult.d.ts

@@ -1,4 +1,5 @@
 import type { BlokkliApp } from '#blokkli/editor/types/app';
+import type { MutationResponseLike } from '#blokkli/editor/adapter';
 /**
  * Tree-shaped entry in the `newParagraphs` payload returned by mutation tools.
  *
@@ -27,6 +28,17 @@ export type NewParagraphNode = {
  * round-trips are needed.
  */
 export declare function buildNewParagraphsTree(newUuids: string[], app: BlokkliApp, itemEntityType: string): NewParagraphNode[];
+/**
+ * Compose an agent-facing error message from a rejected mutation response.
+ *
+ * Backends return structured `violations` (field-level constraint failures)
+ * and/or plain `errors`. Violations carry the useful context (which field on
+ * which entity failed and why), so they're preferred; the generic `errors`
+ * list (e.g. Drupal's catch-all "Entity Violations") is only used as a
+ * fallback when no violations are present. The result is surfaced to the LLM
+ * so it can correct the mutation (e.g. supply the missing required field).
+ */
+export declare function formatMutationFailure(response: MutationResponseLike<any> | undefined): string;
 /**
  * Count every node in a `newParagraphs` tree, including nested children.
  *

package/dist/modules/agent/runtime/app/helpers/mutationResult.js

@@ -35,6 +35,40 @@ export function buildNewParagraphsTree(newUuids, app, itemEntityType) {
   }
   return roots;
 }
+function violationLocation(violation) {
+  const parts = [];
+  if (violation.propertyPath) {
+    parts.push(violation.propertyPath);
+  }
+  if (violation.entityUuid) {
+    const entity = violation.entityType ?? "entity";
+    parts.push(
+      violation.propertyPath ? `(${entity} ${violation.entityUuid})` : `${entity} ${violation.entityUuid}`
+    );
+  }
+  return parts.join(" ");
+}
+export function formatMutationFailure(response) {
+  if (!response) {
+    return "The mutation failed: the backend returned no response.";
+  }
+  const violations = response.violations ?? [];
+  if (violations.length) {
+    const lines = violations.map((violation) => {
+      const location = violationLocation(violation);
+      return location ? `- ${location}: ${violation.message}` : `- ${violation.message}`;
+    });
+    return `The mutation was rejected by the backend:
+${lines.join("\n")}`;
+  }
+  const errors = (response.errors ?? []).filter(Boolean);
+  if (errors.length) {
+    const lines = errors.map((error) => `- ${error}`);
+    return `The mutation was rejected by the backend:
+${lines.join("\n")}`;
+  }
+  return "The mutation was rejected by the backend.";
+}
 export function countNewParagraphs(nodes) {
   let total = 0;
   for (const node of nodes) {

package/dist/modules/agent/runtime/app/providers/toolsProvider.js

@@ -11,7 +11,10 @@ import {
   asRecord,
   splitMeta
 } from "#blokkli/agent/app/helpers";
-import { buildNewParagraphsTree } from "#blokkli/agent/app/helpers/mutationResult";
+import {
+  buildNewParagraphsTree,
+  formatMutationFailure
+} from "#blokkli/agent/app/helpers/mutationResult";
 import { mcpTools } from "#blokkli-build/agent-client";
 import { itemEntityType } from "#blokkli-build/config";
 import { generateId } from "#blokkli/agent/app/helpers/id";
@@ -95,14 +98,19 @@ export default function toolsProvider({
     if (setLabel) setLabel(action.label);
     async function applyMutation() {
       const uuidsBefore = state.getAllUuids();
-      await state.mutateWithLoadingState(() => action.apply(adapter));
+      const response = await state.applyMutationSilently(
+        () => action.apply(adapter)
+      );
+      if (!response || !response.success) {
+        return { ok: false, error: formatMutationFailure(response) };
+      }
       const newUuids = state.getAllUuids().filter((uuid) => !uuidsBefore.includes(uuid));
       const selectUuids = newUuids.length ? newUuids : action.affectedUuids || [];
       if (selectUuids.length) {
         app.eventBus.emit("select", selectUuids);
         app.eventBus.emit("scrollSelectionIntoView", {});
       }
-      return newUuids;
+      return { ok: true, result: buildMutationResult(newUuids), meta: {} };
     }
     function buildMutationResult(newUuids) {
       const newParagraphs = action.type === "add" ? buildNewParagraphsTree(newUuids, app, itemEntityType) : [];
@@ -114,13 +122,11 @@ export default function toolsProvider({
       };
     }
     if (autoApprove.value || !toolDef.requiresApproval) {
-      const newUuids = await applyMutation();
-      return { ok: true, result: buildMutationResult(newUuids), meta: {} };
+      return applyMutation();
     }
     const approved = await waitForApproval(action);
     if (approved) {
-      const newUuids = await applyMutation();
-      return { ok: true, result: buildMutationResult(newUuids), meta: {} };
+      return applyMutation();
     }
     if (action.revert) action.revert();
     return { ok: true, result: { success: false, rejected: true }, meta: {} };

package/dist/modules/agent/runtime/app/tools/add_paragraphs/index.d.ts

@@ -1,11 +1,22 @@
 import { z } from 'zod';
 type OptionValue = string | boolean | number | string[];
+/**
+ * The accepted input shapes for a single content-field value, mirroring
+ * `contentFieldValueSchema`. Normalized to `CanonicalFieldValue` before use.
+ */
+type ContentFieldInput = string | {
+    uri: string;
+    title?: string;
+} | {
+    entityType: string;
+    entityId: string;
+} | {
+    target_id: string;
+    target_type?: string;
+};
 type BlockInput = {
     bundle: string;
-    contentFields?: Record<string, string | {
-        entityType: string;
-        entityId: string;
-    }>;
+    contentFields?: Record<string, ContentFieldInput>;
     options?: Record<string, OptionValue>;
     children?: Record<string, BlockInput[]>;
 };

package/dist/modules/agent/runtime/app/tools/add_paragraphs/index.js

@@ -17,23 +17,48 @@ import { validateFieldCardinality } from "../../helpers/validation.js";
 import { getFieldKey } from "#blokkli/helpers";
 import { optionValueToStorable } from "#blokkli/editor/helpers/options";
 import { countNewParagraphs } from "#blokkli/agent/app/helpers/mutationResult";
-const contentFieldValueSchema = z.union([
-  z.string().describe(
-    "Text value for plain/markup content fields, or a URL string (starting with http) for link content fields"
-  ),
-  z.object({
-    entityType: z.string().describe('Entity type (e.g., "media", "node")'),
-    entityId: z.string().describe("Entity ID")
-  }).describe(
-    "Entity reference for reference content fields (media, content references)"
-  )
-]);
+const contentFieldValueSchema = z.union(
+  [
+    z.string().describe(
+      "Text for plain/markup fields, or a URL/link URI (https://\u2026, mailto:, tel:, internal:/path, entity:type/id) for link fields."
+    ),
+    z.object({
+      uri: z.string().describe("The link target: an absolute URL or a backend link URI."),
+      title: z.string().optional().describe(
+        "Optional link text. Accepted, but the URI is what gets stored \u2014 some backends do not persist the title yet."
+      )
+    }).describe("Link field value with an optional title."),
+    z.object({
+      entityType: z.string().describe('Entity type (e.g. "media", "node").'),
+      entityId: z.string().describe("Entity ID.")
+    }).describe(
+      "Entity reference for reference fields (media, content references), from search_media / search_content results."
+    ),
+    z.object({
+      target_id: z.string().describe("The referenced entity ID."),
+      target_type: z.string().optional().describe("The referenced entity type, if known.")
+    }).describe(
+      "Entity reference in the backend-native { target_id } shape (equivalent to { entityType, entityId })."
+    )
+  ],
+  {
+    error: "Content field value must be one of: a text/URL string; a link object { uri, title? }; or an entity reference { entityType, entityId } or { target_id, target_type? }."
+  }
+);
 const contentFieldsSchema = z.record(
   z.string().describe("The content field name"),
   contentFieldValueSchema
 ).optional().describe(
   "Content field values to set on the new paragraph, keyed by field name. Use this to set text content and media/entity references in one step."
 );
+function normalizeContentFieldValue(value) {
+  if (typeof value === "string") return value;
+  if ("uri" in value) return value.uri;
+  if ("target_id" in value) {
+    return { entityType: value.target_type ?? "", entityId: value.target_id };
+  }
+  return { entityType: value.entityType, entityId: value.entityId };
+}
 const blockSchema = z.object({
   bundle: z.string().describe("The paragraph bundle to add"),
   contentFields: contentFieldsSchema,
@@ -54,7 +79,10 @@ export const paramsSchema = z.object({
 });
 function validateContentFields(ctx, block, path) {
   if (!block.contentFields) return void 0;
-  for (const [fieldName, fieldValue] of Object.entries(block.contentFields)) {
+  for (const [fieldName, rawFieldValue] of Object.entries(
+    block.contentFields
+  )) {
+    const fieldValue = normalizeContentFieldValue(rawFieldValue);
     const editableConfig = ctx.app.types.editableFieldConfig.forName(
       ctx.itemEntityType,
       block.bundle,
@@ -76,7 +104,7 @@ function validateContentFields(ctx, block, path) {
     }
     if (droppableConfig) {
       if (typeof fieldValue === "string" && droppableConfig.type !== "link") {
-        return `${path}: Field "${fieldName}" is a reference field and expects { entityType, entityId }, got a string.`;
+        return `${path}: Field "${fieldName}" is a reference field and expects { entityType, entityId } (or { target_id }), got a string.`;
       }
     }
   }
@@ -161,7 +189,7 @@ function buildEventBlocks(ctx, blocks, parentBundle) {
     const blockUuid = generateUUID();
     const values = block.contentFields ? Object.entries(block.contentFields).map(([fieldName, fieldValue]) => ({
       fieldName,
-      fieldValue
+      fieldValue: normalizeContentFieldValue(fieldValue)
     })) : void 0;
     let options;
     if (block.options) {
@@ -229,7 +257,7 @@ function collectAllUuids(blocks) {
 export const resultSchema = mutationResultSchema;
 export default defineBlokkliAgentTool({
   name: "add_paragraphs",
-  description: "Add one or more new paragraphs to the page. Supports nested structures via the `children` property \u2014 define entire paragraph trees in a single call. IMPORTANT: Always provide content field values (text, media/entity references) directly via contentFields, instead of adding empty paragraphs! For reference content fields (media), set the value to { entityType, entityId } from search_media results. NOTE: You can ONLY provide content fields, NOT paragraph fields! For nested paragraphs, use the `children` property keyed by paragraph field name. You can also set paragraph options inline via the `options` property (key-value pairs). The success result mirrors the input shape: each top-level entry in `newParagraphs` includes its own `children` keyed by paragraph field, so the structure round-trips and a nested child does NOT appear as a sibling \u2014 treat the tree as the source of truth instead of guessing from order.",
+  description: "Add one or more new paragraphs to the page. Supports nested structures via the `children` property \u2014 define entire paragraph trees in a single call. IMPORTANT: Always provide content field values (text, media/entity references) directly via contentFields, instead of adding empty paragraphs! For reference content fields (media), set the value to { entityType, entityId } from search_media results. For link fields, set a URL string or { uri, title }. NOTE: You can ONLY provide content fields, NOT paragraph fields! For nested paragraphs, use the `children` property keyed by paragraph field name. You can also set paragraph options inline via the `options` property (key-value pairs). The success result mirrors the input shape: each top-level entry in `newParagraphs` includes its own `children` keyed by paragraph field, so the structure round-trips and a nested child does NOT appear as a sibling \u2014 treat the tree as the source of truth instead of guessing from order.",
   category: "mutation",
   lazy: false,
   prunedSummary: (r) => r.success ? `added ${countNewParagraphs(r.newParagraphs ?? [])} paragraphs` : "rejected",

package/dist/modules/agent/runtime/server/server-tools/load_tools/index.d.ts

@@ -1,7 +1,5 @@
 import { z } from 'zod';
 declare const _default: import("..").ServerSideTool<z.ZodObject<{
-    tools: z.ZodArray<z.ZodEnum<{
-        [x: string]: string;
-    }>>;
+    tools: z.ZodArray<z.ZodString>;
 }, z.core.$strip>>;
 export default _default;

package/dist/modules/agent/runtime/server/server-tools/load_tools/index.js

@@ -5,7 +5,9 @@ export default defineServerSideTool({
   description: 'Load additional tools by name before using them. You must call this before using any tool listed under "Additional Tools" in the system prompt.',
   inputSchema(ctx) {
     return z.object({
-      tools: z.array(z.enum(ctx.lazyToolNames)).describe("Tool names to activate")
+      tools: z.array(z.string()).describe(
+        ctx.lazyToolNames.length ? `Tool names to activate. Loadable tools: ${ctx.lazyToolNames.join(", ")}.` : "Tool names to activate."
+      )
     });
   },
   isAvailable(ctx) {

package/dist/modules/charts/index.d.mts

@@ -1,4 +1,4 @@
-import { B as BlokkliModule } from '../../shared/editor.BDyiQvbV.mjs';
+import { B as BlokkliModule } from '../../shared/editor.S5sA3rij.mjs';
 import 'nuxt/schema';
 import 'consola';
 import '../../../dist/global/types/definitions.js';

package/dist/modules/drupal/index.d.mts

@@ -1,4 +1,4 @@
-import { B as BlokkliModule } from '../../shared/editor.BDyiQvbV.mjs';
+import { B as BlokkliModule } from '../../shared/editor.S5sA3rij.mjs';
 import 'nuxt/schema';
 import 'consola';
 import '../../../dist/global/types/definitions.js';

package/dist/modules/iframes/index.d.mts

@@ -1,4 +1,4 @@
-import { B as BlokkliModule } from '../../shared/editor.BDyiQvbV.mjs';
+import { B as BlokkliModule } from '../../shared/editor.S5sA3rij.mjs';
 import 'nuxt/schema';
 import 'consola';
 import '../../../dist/global/types/definitions.js';

package/dist/modules/index.d.mts

@@ -1,4 +1,4 @@
-export { b as Blokkli, B as BlokkliModule, d as defineBlokkliModule } from '../shared/editor.BDyiQvbV.mjs';
+export { b as Blokkli, B as BlokkliModule, d as defineBlokkliModule } from '../shared/editor.S5sA3rij.mjs';
 import 'nuxt/schema';
 import 'consola';
 import '../../dist/global/types/definitions.js';

package/dist/modules/readability/index.d.mts

@@ -1,4 +1,4 @@
-import { B as BlokkliModule } from '../../shared/editor.BDyiQvbV.mjs';
+import { B as BlokkliModule } from '../../shared/editor.S5sA3rij.mjs';
 import 'nuxt/schema';
 import 'consola';
 import '../../../dist/global/types/definitions.js';

package/dist/modules/table-of-contents/index.d.mts

@@ -1,4 +1,4 @@
-import { B as BlokkliModule } from '../../shared/editor.BDyiQvbV.mjs';
+import { B as BlokkliModule } from '../../shared/editor.S5sA3rij.mjs';
 import 'nuxt/schema';
 import 'consola';
 import '../../../dist/global/types/definitions.js';

package/dist/runtime/editor/components/FlexTextarea/index.d.vue.ts

@@ -28,8 +28,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     onSubmit?: (() => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
-    minHeight: number;
     maxHeight: number;
+    minHeight: number;
     onBeforePaste: (data: ClipboardData) => boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/editor/components/FlexTextarea/index.vue.d.ts

@@ -28,8 +28,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     onSubmit?: (() => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
-    minHeight: number;
     maxHeight: number;
+    minHeight: number;
     onBeforePaste: (data: ClipboardData) => boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/editor/plugins/ItemAction/index.d.vue.ts

@@ -99,8 +99,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     disabled: boolean | string;
     icon: BlokkliIcon;
     active: boolean;
-    weight: number | string | "last";
     tourText: string;
+    weight: number | string | "last";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/editor/plugins/ItemAction/index.vue.d.ts

@@ -99,8 +99,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     disabled: boolean | string;
     icon: BlokkliIcon;
     active: boolean;
-    weight: number | string | "last";
     tourText: string;
+    weight: number | string | "last";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/editor/plugins/Sidebar/Detached/index.d.vue.ts

@@ -34,8 +34,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
         width: number;
         height: number;
     };
-    minWidth: number;
     minHeight: number;
+    minWidth: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/editor/plugins/Sidebar/Detached/index.vue.d.ts

@@ -34,8 +34,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
         width: number;
         height: number;
     };
-    minWidth: number;
     minHeight: number;
+    minWidth: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/editor/plugins/Sidebar/index.d.vue.ts

@@ -200,9 +200,9 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
         width: number;
         height: number;
     };
-    tourText: string;
-    minWidth: number;
     minHeight: number;
+    minWidth: number;
+    tourText: string;
     region: SidebarRegion;
     tooltipTitle: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {

package/dist/runtime/editor/plugins/Sidebar/index.vue.d.ts

@@ -200,9 +200,9 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
         width: number;
         height: number;
     };
-    tourText: string;
-    minWidth: number;
     minHeight: number;
+    minWidth: number;
+    tourText: string;
     region: SidebarRegion;
     tooltipTitle: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {

package/dist/runtime/editor/providers/state.d.ts

@@ -1,5 +1,5 @@
 import { type Ref, type ComputedRef } from 'vue';
-import type { BlokkliAdapter, AdapterContext } from '../adapter/index.js';
+import type { BlokkliAdapter, AdapterContext, MutationResponseLike } from '../adapter/index.js';
 import type { FieldListItem } from '#blokkli/types';
 import { type BlokkliEventBus } from '#blokkli/editor/events';
 import type { TextProvider } from './texts.js';
@@ -116,6 +116,22 @@ export type StateProvider = {
      *   response, or `null`/`undefined` to no-op.
      */
     applyMutationState: (rawState: unknown) => void;
+    /**
+     * Run an adapter mutation with the loading lock, but return the raw response
+     * instead of a boolean and never emit an error toast.
+     *
+     * Like {@link mutateWithLoadingState} it locks the body for the duration of
+     * the call and applies any returned `state`, but it does NOT throw or show a
+     * global error message on failure. The caller receives the full
+     * {@link MutationResponseLike} and is responsible for surfacing violations —
+     * used by the agent tool runner, where the conversation UI already indicates
+     * that a tool errored and a global editor toast would be redundant.
+     *
+     * @param callback - Function that performs the mutation.
+     * @returns The raw mutation response, or `undefined` if no callback was
+     *   provided or it resolved to no response.
+     */
+    applyMutationSilently: (callback: () => Promise<MutationResponseLike<any>> | undefined) => Promise<MutationResponseLike<any> | undefined>;
     /**
      * Current edit mode.
      *

package/dist/runtime/editor/providers/state.js

@@ -319,6 +319,19 @@ export default async function(eventBus, adapter, context, $t, providerKey, permi
     unlockBody();
     return false;
   };
+  const applyMutationSilently = async (callback) => {
+    if (!callback) {
+      return void 0;
+    }
+    lockBody();
+    try {
+      const response = await callback();
+      applyMutationState(response?.state);
+      return response;
+    } finally {
+      unlockBody();
+    }
+  };
   async function loadState() {
     try {
       const state = await adapter.loadState();
@@ -401,6 +414,7 @@ export default async function(eventBus, adapter, context, $t, providerKey, permi
     lastChanged: readonly(lastChanged),
     mutateWithLoadingState,
     applyMutationState,
+    applyMutationSilently,
     editMode,
     canEdit,
     isLoading: readonly(isLoading),

package/dist/shared/{editor.BDyiQvbV.d.mts → editor.S5sA3rij.d.mts}

@@ -264,6 +264,11 @@ declare class ModuleHelper implements ValidationInterface {
      * module and enabled sub-modules. Flushed by {@link applyBuildConfig}.
      */
     private packageDependencies;
+    /**
+     * npm packages that must resolve to a single copy across the whole app.
+     * Flushed to Vite's resolve.dedupe by {@link applyBuildConfig}.
+     */
+    private dedupedPackages;
     readonly isDev: boolean;
     readonly isModuleBuild: boolean;
     readonly isPrepare: boolean;
@@ -305,11 +310,24 @@ declare class ModuleHelper implements ValidationInterface {
      * @param names - Bare package specifiers (e.g. 'echarts', '@tiptap/core').
      */
     addPackageDependency(...names: string[]): void;
+    /**
+     * Declare packages that must only ever exist once in the module graph.
+     *
+     * Libraries that rely on `instanceof` checks or module-level registries break
+     * when a project's install tree ends up with two copies (e.g. a hoisted
+     * version plus an older one nested under a transitive dependency). Forcing
+     * resolution to a single copy makes the editor work regardless of how the
+     * host project's package manager arranged node_modules.
+     *
+     * @param names - Bare package specifiers (e.g. 'prosemirror-model').
+     */
+    addDedupedPackage(...names: string[]): void;
     /**
      * Apply collected build configuration to the Nuxt/Vite config.
      *
      * Called once by the core module after every module's setup has run, so it
-     * sees the full set of {@link addPackageDependency} registrations.
+     * sees the full set of {@link addPackageDependency} and
+     * {@link addDedupedPackage} registrations.
      */
     applyBuildConfig(): void;
     addAlias(name: string, path: string): void;

package/dist/types.d.mts

@@ -4,6 +4,6 @@ declare module '@nuxt/schema' {
   interface NuxtHooks extends ModuleHooks {}
 }
 
-export { type ModuleHooks } from './shared/editor.BDyiQvbV.mjs'
+export { type ModuleHooks } from './shared/editor.S5sA3rij.mjs'
 
 export { type ModuleOptions, default } from './module.mjs'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blokkli/editor",
-  "version": "2.0.0-alpha.64",
+  "version": "2.0.0-alpha.65",
   "description": "Interactive page building experience for Nuxt",
   "keywords": [
     "cms",