@blokkli/editor 2.0.0-alpha.58 → 2.0.0-alpha.59

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

@@ -14,13 +14,15 @@ const paramsSchema = z.object({
 });
 export default defineBlokkliAgentTool({
   name: "add_media_paragraph",
-  description: "Add a paragraph using a media item from the library. Use search_media first to find media items, then use this tool to add one to the page. Requires user approval.",
+  description: "Add a paragraph using a media item from the library. Use search_media first to find media items, then use this tool to add one to the page.",
   category: "mutation",
   prunedSummary: (r) => r.success ? "added media paragraph" : "rejected",
   modes: ["editing"],
   lazy: true,
   label($t) {
-    return $t("aiAgentAddMediaBlockRunning", "Adding media block...");
+    return $t("aiAgentAddMediaBlockRunning", "Adding media block", {
+      more: true
+    });
   },
   paramsSchema,
   resultSchema: mutationResultSchema,

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

@@ -7,12 +7,15 @@ import {
   positionSchema,
   optionValueSchema
 } from "../schemas.js";
-import { resolvePosition, validateOptionValue } from "../helpers.js";
-import { itemEntityType } from "#blokkli-build/config";
 import {
-  getAvailableOptions,
-  optionValueToStorable
-} from "#blokkli/editor/helpers/options";
+  resolvePosition,
+  validateOptionValue,
+  getResolvedOptions,
+  resolveHost
+} from "../helpers.js";
+import { validateFieldCardinality } from "../../helpers/validation.js";
+import { getFieldKey } from "#blokkli/helpers";
+import { optionValueToStorable } from "#blokkli/editor/helpers/options";
 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"
@@ -80,20 +83,15 @@ function validateContentFields(ctx, block, path) {
 }
 function validateBlockOptions(ctx, block, path, parentBundle) {
   if (!block.options) return void 0;
-  const { definitions } = ctx.app;
-  const definition = definitions.getBlockDefinition(
+  const availableOptions = getResolvedOptions(
+    ctx.app,
     block.bundle,
     "default",
     parentBundle
   );
-  if (!definition) {
+  if (!availableOptions) {
     return `${path}: Paragraph definition not found for bundle "${block.bundle}".`;
   }
-  const availableOptions = getAvailableOptions(
-    definition.options,
-    definition.globalOptions,
-    definitions.globalOptions.value
-  );
   for (const [key, value] of Object.entries(block.options)) {
     const optionDef = availableOptions.find((o) => o.property === key);
     if (!optionDef) {
@@ -140,6 +138,9 @@ function validateBlockTree(ctx, blocks, allowedBundles, fieldLabel, pathPrefix,
           return `${path}: Paragraph field "${childFieldName}" does not exist on bundle "${block.bundle}". ` + (availableBlockFields.length ? `Available paragraph fields: ${availableBlockFields.join(", ")}` : "This bundle has no paragraph fields.");
         }
         if (!childBlocks.length) continue;
+        if (childFieldConfig.cardinality !== -1 && childBlocks.length > childFieldConfig.cardinality) {
+          return `${path}: Field "${childFieldName}" can only hold ${childFieldConfig.cardinality} paragraph(s), but ${childBlocks.length} were provided.`;
+        }
         const childError = validateBlockTree(
           ctx,
           childBlocks,
@@ -155,7 +156,6 @@ function validateBlockTree(ctx, blocks, allowedBundles, fieldLabel, pathPrefix,
   return void 0;
 }
 function buildEventBlocks(ctx, blocks, parentBundle) {
-  const { definitions } = ctx.app;
   return blocks.map((block) => {
     const blockUuid = generateUUID();
     const values = block.contentFields ? Object.entries(block.contentFields).map(([fieldName, fieldValue]) => ({
@@ -164,17 +164,13 @@ function buildEventBlocks(ctx, blocks, parentBundle) {
     })) : void 0;
     let options;
     if (block.options) {
-      const definition = definitions.getBlockDefinition(
+      const availableOptions = getResolvedOptions(
+        ctx.app,
         block.bundle,
         "default",
         parentBundle
       );
-      if (definition) {
-        const availableOptions = getAvailableOptions(
-          definition.options,
-          definition.globalOptions,
-          definitions.globalOptions.value
-        );
+      if (availableOptions) {
         options = {};
         for (const [key, value] of Object.entries(block.options)) {
           const optionDef = availableOptions.find((o) => o.property === key);
@@ -237,21 +233,20 @@ export default defineBlokkliAgentTool({
   prunedSummary: (r) => r.success ? `added ${r.newParagraphs?.length || 0} paragraphs` : "rejected",
   modes: ["editing"],
   label($t) {
-    return $t("aiAgentAddBlocksRunning", "Adding blocks...");
+    return $t("aiAgentAddBlocksRunning", "Adding blocks", { more: true });
   },
   paramsSchema,
   resultSchema: mutationResultSchema,
   requiredAdapterMethods: ["addNewBlocks"],
   execute(ctx, params) {
-    const { types, context, blocks } = ctx.app;
-    const isRootEntity = params.parent.uuid === context.value.entityUuid;
-    const entityType = isRootEntity ? context.value.entityType : itemEntityType;
-    const bundle = isRootEntity ? context.value.entityBundle : blocks.getBlock(params.parent.uuid)?.bundle;
-    if (!bundle) {
+    const { types } = ctx.app;
+    const host = resolveHost(ctx.app, params.parent.uuid);
+    if (!host) {
       return {
-        error: "Parent not found."
+        error: `Parent paragraph "${params.parent.uuid}" not found. Use get_page_structure or get_child_paragraphs to find a valid parent UUID.`
       };
     }
+    const { entityType, bundle, isRoot: isRootEntity } = host;
     const field = types.getFieldConfig(entityType, bundle, params.parent.field);
     if (!field) {
       const availableFields = types.fieldConfig.forEntityTypeAndBundle(entityType, bundle).map((f) => f.name);
@@ -259,6 +254,20 @@ export default defineBlokkliAgentTool({
         error: `Field "${params.parent.field}" not found on bundle "${bundle}". Available fields: ${availableFields.length ? availableFields.join(", ") : "none"}. Use get_child_paragraphs to get the correct parent object.`
       };
     }
+    const cardinality = validateFieldCardinality(
+      ctx.app,
+      {
+        type: entityType,
+        uuid: params.parent.uuid,
+        fieldName: params.parent.field,
+        bundle
+      },
+      getFieldKey(params.parent.uuid, params.parent.field),
+      params.paragraphs.length
+    );
+    if (!cardinality.valid) {
+      return { error: cardinality.error };
+    }
     if (!isRootEntity) {
       if (ctx.app.permissions.blockHasRestrictedAncestor(params.parent.uuid)) {
         return {

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

@@ -1,9 +1,9 @@
 import { z } from "zod";
 import { defineBlokkliAgentTool } from "#blokkli/agent/app/composables";
 import { mutationResultSchema, parentSchema, positionSchema } from "../schemas.js";
-import { resolvePosition } from "../helpers.js";
+import { resolvePosition, resolveHost } from "../helpers.js";
 import { requireBundlePermission } from "../../helpers/validation.js";
-import { fromLibraryBlockBundle, itemEntityType } from "#blokkli-build/config";
+import { fromLibraryBlockBundle } from "#blokkli-build/config";
 const paramsSchema = z.object({
   libraryItemUuid: z.string().describe(
     "The UUID of the reusable paragraph to add (from search_reusable_paragraphs results)"
@@ -21,7 +21,9 @@ export default defineBlokkliAgentTool({
   modes: ["editing"],
   lazy: true,
   label($t) {
-    return $t("aiAgentAddLibraryItemRunning", "Adding reusable block...");
+    return $t("aiAgentAddLibraryItemRunning", "Adding reusable block", {
+      more: true
+    });
   },
   paramsSchema,
   resultSchema: mutationResultSchema,
@@ -38,20 +40,18 @@ export default defineBlokkliAgentTool({
         error: "Permission denied: target parent is inside a block with restricted editing permissions"
       };
     }
-    const { types, fields, context, blocks, $t } = ctx.app;
+    const { types, fields, $t } = ctx.app;
     const field = fields.find(params.parent.uuid, params.parent.field);
     if (!field) {
       return {
         error: `Field not found: ${params.parent.field} on entity ${params.parent.uuid}`
       };
     }
-    const isRootEntity = params.parent.uuid === context.value.entityUuid;
-    const parentEntityType = isRootEntity ? context.value.entityType : itemEntityType;
-    const parentBundle = isRootEntity ? context.value.entityBundle : blocks.getBlock(params.parent.uuid)?.bundle;
-    if (parentBundle) {
+    const host = resolveHost(ctx.app, params.parent.uuid);
+    if (host) {
       const fieldConfig = types.getFieldConfig(
-        parentEntityType,
-        parentBundle,
+        host.entityType,
+        host.bundle,
         params.parent.field
       );
       if (fieldConfig?.allowedBundles.length && !fieldConfig.allowedBundles.includes(fromLibraryBlockBundle)) {

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

@@ -11,13 +11,13 @@ const paramsSchema = z.object({
 });
 export default defineBlokkliAgentTool({
   name: "add_template",
-  description: "Add a template to the page. Templates are copied when added, so changes to the added paragraphs won't affect other pages using the same template. Requires user approval before the template is actually added.",
+  description: "Add a template to the page. Templates are copied when added, so changes to the added paragraphs won't affect other pages using the same template.",
   category: "mutation",
   prunedSummary: (r) => r.success ? `added template (${r.newParagraphs?.length || 0} paragraphs)` : "rejected",
   lazy: true,
   modes: ["editing"],
   label($t) {
-    return $t("aiAgentAddTemplateRunning", "Adding template...");
+    return $t("aiAgentAddTemplateRunning", "Adding template", { more: true });
   },
   paramsSchema,
   resultSchema: mutationResultSchema,

package/dist/modules/agent/runtime/app/tools/ask_question/Component.vue

@@ -1,43 +1,40 @@
 <template>
-  <ToolCard
-    icon="bk_mdi_help"
-    :title="params.question"
-    class="bk-agent-tool-question"
-    @cancel="cancel"
-  >
-    <div class="bk-agent-tool-question-inner">
+  <ToolCard icon="bk_mdi_help" :title="params.question" @cancel="cancel">
+    <div class="_bk_p-10 bk-agent-tool-question-list">
       <FormCheckboxes
         v-if="params.multiSelect"
         id="ask-question"
         v-model="selectedMulti"
-        label=""
         :options="params.options"
+        class="bk-agent-tool-question-options"
       />
 
-      <div v-else>
+      <template v-else>
         <FormRadio
           id="ask-question"
           v-model="selectedSingle"
-          label=""
           :options="radioOptions"
+          class="bk-agent-tool-question-options"
         />
-        <div v-if="isOtherSelected" class="bk-agent-tool-question-other">
+        <div v-if="isOtherSelected" class="_bk_px-10 _bk_pt-5 _bk_pb-5">
           <textarea
             ref="otherTextarea"
             v-model="otherText"
-            class="bk-form-input"
+            class="bk-form-input bk-is-small _bk_mt-10"
             :rows="2"
             :placeholder="
-  $t('aiAgentAskQuestionOtherPlaceholder', 'Type your answer...')
+  $t('aiAgentAskQuestionOtherPlaceholder', 'Type your answer', {
+    more: true
+  })
 "
           />
         </div>
-      </div>
+      </template>
     </div>
 
     <template #actions>
       <button
-        class="bk-button bk-is-small bk-is-lime bk-is-fullwidth"
+        class="bk-button bk-is-small bk-scheme-lime bk-is-fullwidth"
         :disabled="!hasSelection"
         @click="confirm"
       >
@@ -117,3 +114,16 @@ function cancel() {
   emit("done", { selected: null, label: $t("aiAgentCancelled", "Cancelled") });
 }
 </script>
+
+<style>/*! tailwindcss v4.2.4 | MIT License | https://tailwindcss.com */
+:is(.bk-agent-tool-question-list .bk-radio,.bk-agent-tool-question-list .bk-checkbox) input + span {
+  font-size: var(--text-sm, 14px);
+  line-height: var(--bk-tw-leading, var(--text-sm--line-height, calc(1.25 / 0.875)));
+  --bk-tw-font-weight: var(--font-weight-medium, 500);
+  font-weight: var(--font-weight-medium, 500);
+}
+.bk-agent-tool-question-options  > div {
+  display: grid;
+  gap: 5px;
+}
+</style>

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

@@ -5,7 +5,7 @@ declare const paramsSchema: z.ZodObject<{
         value: z.ZodString;
         label: z.ZodString;
     }, z.core.$strip>>;
-    multiSelect: z.ZodDefault<z.ZodBoolean>;
+    multiSelect: any;
     paragraphUuids: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 declare const resultSchema: z.ZodObject<{

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

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { defineBlokkliAgentTool } from "#blokkli/agent/app/composables";
+import { booleanParam } from "#blokkli/agent/shared/toolParams";
 import Component from "./Component.vue";
 const optionSchema = z.object({
   value: z.string().describe("The option value"),
@@ -8,9 +9,9 @@ const optionSchema = z.object({
 const paramsSchema = z.object({
   question: z.string().describe("The question to ask the user"),
   options: z.array(optionSchema).describe("Available options to choose from"),
-  multiSelect: z.boolean().default(false).describe(
+  multiSelect: booleanParam(
     `Allow selecting multiple options. If false, the user has the option to enter a custom option if none of the options are good.`
-  ),
+  ).default(false),
   paragraphUuids: z.array(z.string()).optional().describe(
     "Optional UUIDs of paragraphs this question relates to. When provided, these paragraphs will be highlighted on the page."
   )
@@ -25,7 +26,7 @@ export default defineBlokkliAgentTool({
   category: "query",
   modes: ["readonly", "editing", "translating", "review"],
   label($t) {
-    return $t("aiAgentAskQuestionRunning", "Waiting for answer...");
+    return $t("aiAgentAskQuestionRunning", "Waiting for answer", { more: true });
   },
   paramsSchema,
   resultSchema,
@@ -49,7 +50,7 @@ export default defineBlokkliAgentTool({
   }),
   mockParamsVariants: () => [
     {
-      question: "Which sections should be included on the page?",
+      question: "Which of the following sections should be included on the page?",
       options: [
         { value: "hero", label: "Hero" },
         { value: "features", label: "Features" },

package/dist/modules/agent/runtime/app/tools/{check_readability → check_readability_for_texts}/index.js

@@ -1,14 +1,11 @@
 import { z } from "zod";
 import { defineBlokkliAgentTool } from "#blokkli/agent/app/composables";
-function bandToLevel(band) {
-  if (band === "hard") return "hard";
-  if (band === "ok") return "ok";
-  return "good";
-}
+import { worstReadability } from "../readability.js";
 const textResultSchema = z.object({
   text: z.string(),
-  level: z.enum(["good", "ok", "hard"]),
-  score: z.number()
+  level: z.enum(["good", "ok", "hard", "unknown"]),
+  score: z.number().nullable(),
+  note: z.string().optional()
 });
 const paramsSchema = z.object({
   texts: z.array(z.string()).describe(
@@ -20,14 +17,14 @@ const resultSchema = z.object({
 });
 export default defineBlokkliAgentTool({
   name: "check_readability_for_texts",
-  description: 'Check readability scores for one or more text strings. Returns a readability level ("good", "ok", or "hard") and metrics (LIX, CLI, ARI) for each text. Use this to evaluate whether a rewritten text has better readability before applying it.',
+  description: 'Check readability scores for one or more text strings. Returns a readability level ("good", "ok", or "hard") and a score for each text. Use this to evaluate whether a rewritten text has better readability before applying it. Texts too short to score reliably return level "unknown" and score null.',
   category: "query",
   lazy: true,
   modes: ["readonly", "editing", "translating", "review"],
   requiredAdapterMethods: ["getAnalyzers"],
   isAvailable: (app) => app.readability.isAvailable.value,
   label($t) {
-    return $t("aiAgentCheckReadabilityRunning", "Checking readability...");
+    return $t("checkingReadability", "Checking readability", { more: true });
   },
   prunedSummary: (r) => {
     return `checked readability for ${r.results.length} texts`;
@@ -40,21 +37,17 @@ export default defineBlokkliAgentTool({
     const results = [];
     for (const text of params.texts) {
       const chunks = await readability.analyzeText(text, langcode);
-      let worstLevel = "good";
-      let worstScore = 0;
-      for (const chunk of chunks) {
-        if (chunk.band === null || chunk.score === null) continue;
-        const level = bandToLevel(chunk.band);
-        if (level === "hard" || level === "ok" && worstLevel === "good") {
-          worstLevel = level;
-          worstScore = chunk.score;
-        }
+      const worst = worstReadability(chunks);
+      if (!worst) {
+        results.push({
+          text,
+          level: "unknown",
+          score: null,
+          note: "Text too short to score reliably."
+        });
+      } else {
+        results.push({ text, level: worst.level, score: worst.score });
       }
-      results.push({
-        text,
-        level: worstLevel,
-        score: worstScore
-      });
     }
     return {
       label: $t(

package/dist/modules/agent/runtime/app/tools/delegate_text_rewrite/Component.d.vue.ts

@@ -1,22 +1,11 @@
 import type { McpToolContext } from '#blokkli/agent/app/types';
 import type { ComponentParams } from './index.js';
-import type { UsageTurn } from '#blokkli/agent/shared/types';
 type __VLS_Props = {
     context: McpToolContext;
     params: ComponentParams;
 };
-export type StreamTextFieldsDetailItem = {
-    fieldLabel: string;
-    before: string;
-    after: string;
-    mode: 'full' | 'patch';
-    operations: Array<{
-        search: string;
-        replace: string;
-    }>;
-};
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    done: (result: {
+    done: (result: ComponentToolResult<{
         acceptedCount: number;
         rejectedByUser: Record<string, Record<string, {
             reasonForRejection: string;
@@ -24,13 +13,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         label: string;
         agentMessage?: string | undefined;
         historyIndex?: number | undefined;
-    } & {
-        _details?: StreamTextFieldsDetailItem[];
-        _usage?: UsageTurn;
-        _skipLlmResponse?: boolean;
-    }) => any;
+    }>) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onDone?: ((result: {
+    onDone?: ((result: ComponentToolResult<{
         acceptedCount: number;
         rejectedByUser: Record<string, Record<string, {
             reasonForRejection: string;
@@ -38,11 +23,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         label: string;
         agentMessage?: string | undefined;
         historyIndex?: number | undefined;
-    } & {
-        _details?: StreamTextFieldsDetailItem[];
-        _usage?: UsageTurn;
-        _skipLlmResponse?: boolean;
-    }) => any) | undefined;
+    }>) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;