@blokkli/editor 2.0.0-alpha.38 → 2.0.0-alpha.39

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

@@ -1,13 +1,14 @@
 import { z } from "zod";
 import { defineBlokkliAgentTool } from "#blokkli/agent/app/composables";
-const nodeSchema = z.object({
-  description: z.string().optional(),
-  impact: z.string().optional(),
-  scores: z.record(z.string(), z.number()).optional()
-});
+function impactToLevel(impact) {
+  if (impact === "critical" || impact === "serious") return "hard";
+  if (impact === "moderate") return "ok";
+  return "good";
+}
 const textResultSchema = z.object({
   text: z.string(),
-  nodes: z.array(nodeSchema)
+  level: z.enum(["good", "ok", "hard"]),
+  scores: z.record(z.string(), z.number())
 });
 const paramsSchema = z.object({
   texts: z.array(z.string()).describe(
@@ -19,7 +20,7 @@ const resultSchema = z.object({
 });
 export default defineBlokkliAgentTool({
   name: "check_readability_for_texts",
-  description: "Check readability scores for one or more text strings. Returns readability 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 metrics (LIX, CLI, ARI) for each text. Use this to evaluate whether a rewritten text has better readability before applying it.',
   category: "query",
   lazy: true,
   modes: ["readonly", "editing", "translating", "review"],
@@ -36,16 +37,14 @@ export default defineBlokkliAgentTool({
     const { analyze, $t } = ctx.app;
     await analyze.ensureInitialized();
     const rawResults = await analyze.runOnTexts(params.texts, "readability");
-    const results = rawResults.map(
-      (tr) => ({
+    const results = rawResults.map((tr) => {
+      const node = tr.nodes[0];
+      return {
         text: tr.text,
-        nodes: tr.nodes.map((node) => ({
-          description: node.description,
-          impact: node.impact,
-          scores: node.scores
-        }))
-      })
-    );
+        level: impactToLevel(node?.impact),
+        scores: node?.scores ?? {}
+      };
+    });
     return {
       label: $t(
         "aiAgentCheckReadabilityDone",

package/dist/modules/agent/runtime/app/tools/{analyze_content → get_readability_issues}/index.js

@@ -20,12 +20,13 @@ function resolveTargetInfo(target) {
   let fieldName;
   let fieldEl;
   let el = target;
-  while (el && el !== blockEl) {
+  while (el) {
     if (el.dataset.blokkliEditableField) {
       fieldName = el.dataset.blokkliEditableField;
       fieldEl = el;
       break;
     }
+    if (el === blockEl) break;
     el = el.parentElement;
   }
   const fieldText = fieldEl?.textContent?.trim() || void 0;
@@ -33,7 +34,7 @@ function resolveTargetInfo(target) {
 }
 export default defineBlokkliAgentTool({
   name: "get_readability_issues",
-  description: "Run all readability analyzers against the full page. Returns an object keyed by paragraph UUID and field name, with the current field value and a list of issues. Each issue contains the flagged text segment, impact, and scores. Use the result to call batch_rewrite_text directly.",
+  description: "Run all readability analyzers against the full page. Returns an object keyed by paragraph UUID and field name, with the current field value and a list of issues. Each issue contains the flagged text segment, impact, and scores. Use the result to call update_text_fields directly.",
   category: "query",
   volatile: true,
   lazy: true,

package/dist/modules/agent/runtime/app/tools/{batch_rewrite_text → update_text_fields}/Component.d.vue.ts

@@ -4,6 +4,11 @@ type __VLS_Props = {
     context: McpToolContext;
     params: BatchRewriteParams;
 };
+export type BatchRewriteDetailItem = {
+    fieldLabel: string;
+    before: string;
+    after: string;
+};
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     done: (result: {
         acceptedCount: number;
@@ -13,6 +18,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         label: string;
         agentMessage?: string | undefined;
         historyIndex?: number | undefined;
+    } & {
+        _details?: BatchRewriteDetailItem[];
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onDone?: ((result: {
@@ -23,6 +30,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         label: string;
         agentMessage?: string | undefined;
         historyIndex?: number | undefined;
+    } & {
+        _details?: BatchRewriteDetailItem[];
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/modules/agent/runtime/app/tools/{batch_rewrite_text → update_text_fields}/Component.vue

@@ -10,21 +10,28 @@
 "
     @cancel="rejectAll"
   >
-    <div
-      v-if="!isApplying"
-      class="bk-batch-rewrite-list"
-      @mouseleave="onMouseLeave"
-    >
-      <ItemComponent
-        v-for="item in items"
-        :key="item.id"
-        v-model:selected="selected[item.id]"
-        v-model:reason="reasons[item.id]"
-        :uuid="item.uuid"
-        :field-name="item.fieldName"
-        :field-label="item.fieldLabel"
-        :new-value="item.value"
-      />
+    <div v-if="!isApplying">
+      <div class="bk-batch-rewrite-mode-selector">
+        <FormRadioTabs
+          :id="'batch-rewrite-diff-mode-' + id"
+          v-model="diffMode"
+          :options="diffModeOptions"
+          :label="$t('diffModeLabel', 'Display')"
+        />
+      </div>
+      <div class="bk-batch-rewrite-list" @mouseleave="onMouseLeave">
+        <ItemComponent
+          v-for="item in items"
+          :key="item.id"
+          v-model:selected="selected[item.id]"
+          v-model:reason="reasons[item.id]"
+          :uuid="item.uuid"
+          :field-name="item.fieldName"
+          :field-label="item.fieldLabel"
+          :new-value="item.value"
+          :diff-mode="diffMode"
+        />
+      </div>
     </div>
 
     <template #actions>
@@ -40,8 +47,8 @@
 </template>
 
 <script setup>
-import { computed, useBlokkli, ref, reactive, onMounted } from "#imports";
-import { Icon } from "#blokkli/editor/components";
+import { computed, useBlokkli, ref, reactive, onMounted, useId } from "#imports";
+import { Icon, FormRadioTabs } from "#blokkli/editor/components";
 import ToolCard from "../../features/agent/Panel/ToolCard/index.vue";
 import ItemComponent from "./Item.vue";
 import { itemEntityType } from "#blokkli-build/config";
@@ -56,36 +63,63 @@ const {
   blocks,
   context: editorContext,
   types,
-  eventBus
+  directive,
+  eventBus,
+  storage
 } = useBlokkli();
+const id = useId();
+const diffMode = storage.use("diffMode", "inline");
+const diffModeOptions = computed(() => [
+  { value: "inline", label: $t("diffModeInline", "Inline") },
+  { value: "side_by_side", label: $t("diffModeSideBySide", "Both") },
+  { value: "after", label: $t("diffModeAfter", "After") }
+]);
 const isApplying = ref(false);
 onMounted(() => {
   if (props.params.requireApproval === false) {
     applySelected();
   }
 });
-function resolveFieldLabel(uuid, fieldName) {
-  let entityType;
-  let bundle;
+function resolveHost(uuid) {
   if (uuid === editorContext.value.entityUuid) {
-    entityType = editorContext.value.entityType;
-    bundle = editorContext.value.entityBundle;
-  } else {
-    const block = blocks.getBlock(uuid);
-    if (!block) {
-      return fieldName;
-    }
-    entityType = itemEntityType;
-    bundle = block.bundle;
+    return {
+      entityType: editorContext.value.entityType,
+      bundle: editorContext.value.entityBundle
+    };
   }
+  const block = blocks.getBlock(uuid);
+  if (!block) return null;
+  return { entityType: itemEntityType, bundle: block.bundle };
+}
+function resolveFieldLabel(uuid, fieldName) {
+  const host = resolveHost(uuid);
+  if (!host) return fieldName;
   const config = types.editableFieldConfig.forName(
-    entityType,
-    bundle,
+    host.entityType,
+    host.bundle,
     fieldName
   );
   return config?.label || fieldName;
 }
+function getCurrentValue(uuid, fieldName) {
+  const host = resolveHost(uuid);
+  if (!host) return null;
+  const el = directive.findEditableElement(fieldName, {
+    type: host.entityType,
+    bundle: host.bundle,
+    uuid
+  });
+  if (!el) return null;
+  const cfg = types.editableFieldConfig.forName(
+    host.entityType,
+    host.bundle,
+    fieldName
+  );
+  if (!cfg || cfg.type === "table") return null;
+  return cfg.type === "plain" ? el.textContent || "" : el.innerHTML;
+}
 let idCounter = 0;
+const beforeValues = /* @__PURE__ */ new Map();
 const items = Object.entries(props.params.uuids).flatMap(
   ([uuid, fields]) => Object.entries(fields).map(([fieldName, value]) => ({
     id: idCounter++,
@@ -94,7 +128,13 @@ const items = Object.entries(props.params.uuids).flatMap(
     fieldLabel: resolveFieldLabel(uuid, fieldName),
     value
   }))
-);
+).filter((item) => {
+  const current = getCurrentValue(item.uuid, item.fieldName);
+  if (current !== null) {
+    beforeValues.set(item.id, current);
+  }
+  return current === null || current !== item.value;
+});
 const selected = reactive(
   Object.fromEntries(items.map((item) => [item.id, true]))
 );
@@ -162,12 +202,18 @@ async function applySelected() {
   } else if (rejectedWithoutReason.length > 2) {
     agentMessage = "Some changes were rejected without a reason. Ask the user what they would like to change instead.";
   }
+  const _details = items.filter((item) => selected[item.id]).map((item) => ({
+    fieldLabel: item.fieldLabel,
+    before: beforeValues.get(item.id) || "",
+    after: item.value
+  }));
   emit("done", {
     acceptedCount,
     rejectedByUser,
     label,
     agentMessage,
-    historyIndex: state.currentMutationIndex.value
+    historyIndex: state.currentMutationIndex.value,
+    _details
   });
 }
 function rejectAll() {

package/dist/modules/agent/runtime/app/tools/{batch_rewrite_text → update_text_fields}/Component.vue.d.ts

@@ -4,6 +4,11 @@ type __VLS_Props = {
     context: McpToolContext;
     params: BatchRewriteParams;
 };
+export type BatchRewriteDetailItem = {
+    fieldLabel: string;
+    before: string;
+    after: string;
+};
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     done: (result: {
         acceptedCount: number;
@@ -13,6 +18,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         label: string;
         agentMessage?: string | undefined;
         historyIndex?: number | undefined;
+    } & {
+        _details?: BatchRewriteDetailItem[];
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onDone?: ((result: {
@@ -23,6 +30,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         label: string;
         agentMessage?: string | undefined;
         historyIndex?: number | undefined;
+    } & {
+        _details?: BatchRewriteDetailItem[];
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/modules/agent/runtime/app/tools/update_text_fields/Details/index.d.vue.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    details: unknown;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/modules/agent/runtime/app/tools/update_text_fields/Details/index.vue

@@ -0,0 +1,24 @@
+<template>
+  <div class="bk-batch-rewrite-details">
+    <div
+      v-for="(item, index) in items"
+      :key="index"
+      class="bk-batch-rewrite-details-item"
+    >
+      <div class="bk-batch-rewrite-details-label">{{ item.fieldLabel }}</div>
+      <DiffDisplay :before="item.before" :after="item.after" mode="inline" />
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { computed } from "#imports";
+import { DiffDisplay } from "#blokkli/editor/components";
+const props = defineProps({
+  details: { type: null, required: true }
+});
+const items = computed(() => {
+  if (!Array.isArray(props.details)) return [];
+  return props.details;
+});
+</script>

package/dist/modules/agent/runtime/app/tools/update_text_fields/Details/index.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    details: unknown;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/modules/agent/runtime/app/tools/{batch_rewrite_text → update_text_fields}/Item.d.vue.ts

@@ -1,8 +1,10 @@
+import type { DiffDisplayMode } from '#blokkli/editor/components/DiffViewer/DiffDisplay/index.vue';
 type __VLS_Props = {
     uuid: string;
     fieldName: string;
     fieldLabel: string;
     newValue: string;
+    diffMode: DiffDisplayMode;
 };
 type __VLS_ModelProps = {
     'selected'?: boolean;

package/dist/modules/agent/runtime/app/tools/{batch_rewrite_text → update_text_fields}/Item.vue

@@ -9,8 +9,12 @@
       <span>{{ fieldLabel }}</span>
     </label>
     <div class="bk-batch-rewrite-change">
-      <div @click.prevent="onChange">
-        <DiffValue :before="override.originalValue" :after="newValue" />
+      <div>
+        <DiffDisplay
+          :before="override.originalValue"
+          :after="newValue"
+          :mode="diffMode"
+        />
       </div>
       <div v-if="!selected" class="bk-batch-rewrite-reason">
         <FlexTextarea
@@ -33,14 +37,15 @@
 
 <script setup>
 import { watch, onBeforeUnmount, useBlokkli, nextTick } from "#imports";
-import { DiffValue, FlexTextarea } from "#blokkli/editor/components";
+import { DiffDisplay, FlexTextarea } from "#blokkli/editor/components";
 import { useEditableFieldOverride } from "#blokkli/editor/composables";
 import { itemEntityType } from "#blokkli-build/config";
 const props = defineProps({
   uuid: { type: String, required: true },
   fieldName: { type: String, required: true },
   fieldLabel: { type: String, required: true },
-  newValue: { type: String, required: true }
+  newValue: { type: String, required: true },
+  diffMode: { type: String, required: true }
 });
 const selected = defineModel("selected", { type: Boolean, ...{ default: false } });
 const reason = defineModel("reason", { type: String, ...{ default: "" } });

package/dist/modules/agent/runtime/app/tools/{batch_rewrite_text → update_text_fields}/Item.vue.d.ts

@@ -1,8 +1,10 @@
+import type { DiffDisplayMode } from '#blokkli/editor/components/DiffViewer/DiffDisplay/index.vue';
 type __VLS_Props = {
     uuid: string;
     fieldName: string;
     fieldLabel: string;
     newValue: string;
+    diffMode: DiffDisplayMode;
 };
 type __VLS_ModelProps = {
     'selected'?: boolean;

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

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { defineBlokkliAgentTool } from "#blokkli/agent/app/composables";
+import Component from "./Component.vue";
+import DetailsComponent from "./Details/index.vue";
+const paramsSchema = z.object({
+  uuids: z.record(z.string(), z.record(z.string(), z.string())).describe(
+    "A map of paragraph uuids containing a map of field names to field values."
+  ),
+  requireApproval: z.boolean().optional().describe("Whether to show the approval UI.")
+});
+const resultSchema = z.object({
+  acceptedCount: z.number().describe("Number of changes accepted by the user"),
+  rejectedByUser: z.record(
+    z.string(),
+    z.record(
+      z.string(),
+      z.object({
+        reasonForRejection: z.string().describe(
+          "Reason provided by the user for rejecting, empty if no reason given"
+        )
+      })
+    )
+  ).describe(
+    "Map of rejected paragraph UUID to field name to rejection details"
+  ),
+  label: z.string().describe("Human-readable summary shown in the UI"),
+  agentMessage: z.string().optional().describe(
+    "Detailed message for the agent, replaces label in the LLM context"
+  ),
+  historyIndex: z.number().optional().describe("The mutation history index after applying changes")
+});
+export default defineBlokkliAgentTool({
+  name: "update_text_fields",
+  description: 'Update text content fields on one or more paragraphs, identified by UUID. Set requireApproval to true when the user should confirm the changes first. EXAMPLE: { "uuids": { "<UUID>": { "title": "New title", "text": "New text" } } }',
+  category: "mutation",
+  prunedSummary: (r) => `${r.acceptedCount || 0} accepted, ${Object.keys(r.rejectedByUser || {}).length} rejected`,
+  modes: ["editing", "translating"],
+  label($t) {
+    return $t("aiAgentBatchRewriteTextRunning", "Rewriting multiple texts...");
+  },
+  paramsSchema,
+  resultSchema,
+  requiredAdapterMethods: ["updateFieldValueBatched"],
+  component: Component,
+  detailsComponent: DetailsComponent,
+  buildDetails: (result) => result,
+  execute(_ctx, params) {
+    return params;
+  },
+  mockParams: () => ({
+    uuids: {
+      "4526d2d0-f122-4093-902f-e2f00a433981": {
+        title: "Seamlessly integrates in any Nuxt setup",
+        tagline: "Great Developer Experience"
+      },
+      "9485812c-0ecd-4699-85b2-3a031d47a0a1": {
+        text: "<ul><li>Fully responsive design</li><li>Touch gestures and smooth interactions</li><li>All editing features available on mobile</li><li>Optimized for tablets</li></ul>"
+      },
+      "67a9e26f-8028-4283-8b7d-8f836355b949": {
+        text: "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p><p>Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p><p>Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.</p><p>Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p><p>Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra.</p>"
+      },
+      "3a2617ed-6844-4d39-859c-82869f4ea5aa": {
+        text: "<ul><li>Auto import block components</li><li>Directly define options inside the component</li><li>Support for import chunks</li></ul>"
+      }
+    },
+    requireApproval: true
+  }),
+  mockParamsVariants: () => [
+    {
+      uuids: {
+        "dev-long-text-block": {
+          text: "<h2>The Architecture Behind bl\xF6kkli</h2><p>At its core, bl\xF6kkli is a Nuxt module that injects an editing overlay on top of your existing page. When you enter edit mode, the overlay activates and wraps each block with interactive handles for selection, dragging, and inline editing. The key insight is that your page components render exactly as they would in production \u2014 bl\xF6kkli never replaces them with editor-specific versions. Instead, it reads the DOM to understand the page structure and provides editing affordances on top.</p><p>The provider system is how bl\xF6kkli shares state across the editor. Rather than a single global store, functionality is split into focused providers: one for selection state, one for UI, one for DOM operations, one for animations, and so on. Each provider is injected via Vue provide/inject at the appropriate level \u2014 some are global, some are per-field, some are per-block. This granularity prevents unnecessary reactivity and keeps the editor fast even on complex pages.</p><p>Code generation plays a crucial role in the developer experience. When you run the dev server, bl\xF6kkli scans your block components, extracts their <code>defineBlokkli()</code> calls, and generates TypeScript definitions into the <code>.nuxt/blokkli/</code> directory. These generated types power autocomplete for block bundles, option keys, field names, and adapter methods. The result is that typos and mismatches are caught by your IDE before you even save the file.</p><p>The mutation system deserves special attention. Every change the user makes in the editor is captured as a discrete mutation object with a type, target, and payload. Mutations are queued and sent to the adapter in order. The adapter can batch them, validate them, or reject them. This design makes undo/redo straightforward \u2014 the editor simply replays or reverts mutations. It also makes the AI agent possible, because the agent produces the same mutation objects as manual editing.</p><p>Theming is handled through CSS custom properties defined in JSON theme files. Each theme specifies RGB values for color palettes, and the editor resolves them at runtime. Switching themes is instant because it only updates CSS variables \u2014 no components re-render. The built-in themes (nuxt, fire, gruvbox) demonstrate the range, but creating a custom theme is just a matter of defining your color values in a JSON file and referencing it in your Nuxt config.</p>"
+        }
+      },
+      requireApproval: true
+    }
+  ]
+});

package/dist/modules/agent/runtime/app/types/index.d.ts

@@ -189,6 +189,17 @@ export type McpToolDefinition<TParamsSchema extends z.ZodType = z.ZodType, TResu
      * - Mutation tools (no component): `MutationToolResult`
      */
     prunedSummary?: (result: TComponent extends Component ? z.infer<TResultSchema> : TCategory extends 'query' ? z.infer<TResultSchema> : MutationToolResult) => string;
+    /**
+     * Optional callback that extracts detail data from the tool result.
+     * Called after tool execution. The returned value is stored in memory
+     * (not persisted) and passed to detailsComponent when expanded.
+     */
+    buildDetails?: (result: any) => unknown;
+    /**
+     * Optional Vue component rendered inside the collapsible details area.
+     * Receives { details: unknown } as props (the value from buildDetails).
+     */
+    detailsComponent?: Component;
     /**
      * Optional function returning mock params for styling/debugging.
      * When provided, the debug view will render the component with these params.
@@ -244,6 +255,13 @@ declare const userConversationItemSchema: z.ZodObject<{
         type: z.ZodLiteral<"text">;
         id: z.ZodString;
         content: z.ZodString;
+        format: z.ZodEnum<{
+            code: "code";
+            markdown: "markdown";
+            html: "html";
+            plaintext: "plaintext";
+            csv: "csv";
+        }>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 /**
@@ -280,7 +298,7 @@ declare const serverToolConversationItemSchema: z.ZodObject<{
     timestamp: z.ZodNumber;
     type: z.ZodLiteral<"server_tool">;
     tool: z.ZodEnum<{
-        load_skill: "load_skill";
+        load_skills: "load_skills";
         load_tools: "load_tools";
         create_plan: "create_plan";
         complete_plan_step: "complete_plan_step";
@@ -310,6 +328,13 @@ export declare const conversationItemSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         type: z.ZodLiteral<"text">;
         id: z.ZodString;
         content: z.ZodString;
+        format: z.ZodEnum<{
+            code: "code";
+            markdown: "markdown";
+            html: "html";
+            plaintext: "plaintext";
+            csv: "csv";
+        }>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
@@ -333,7 +358,7 @@ export declare const conversationItemSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     timestamp: z.ZodNumber;
     type: z.ZodLiteral<"server_tool">;
     tool: z.ZodEnum<{
-        load_skill: "load_skill";
+        load_skills: "load_skills";
         load_tools: "load_tools";
         create_plan: "create_plan";
         complete_plan_step: "complete_plan_step";
@@ -370,10 +395,12 @@ export type ConversationItem = z.infer<typeof conversationItemSchema> | UnknownC
  * Only one active item can exist at a time. When complete, it's pushed to conversation history.
  */
 export type ActiveItem = AssistantConversationItem | ToolConversationItem;
+export type AttachmentFormat = 'plaintext' | 'markdown' | 'html' | 'csv' | 'code';
 export type TextAttachment = {
     type: 'text';
     id: string;
     content: string;
+    format: AttachmentFormat;
 };
 export type Attachment = TextAttachment;
 export {};

package/dist/modules/agent/runtime/app/types/index.js

@@ -11,7 +11,8 @@ const userConversationItemSchema = conversationItemBase.extend({
     z.object({
       type: z.literal("text"),
       id: z.string(),
-      content: z.string()
+      content: z.string(),
+      format: z.enum(["plaintext", "markdown", "html", "csv", "code"])
     })
   ).optional()
 });
@@ -29,7 +30,7 @@ const toolConversationItemSchema = conversationItemBase.extend({
 const serverToolConversationItemSchema = conversationItemBase.extend({
   type: z.literal("server_tool"),
   tool: z.enum([
-    "load_skill",
+    "load_skills",
     "load_tools",
     "create_plan",
     "complete_plan_step",

package/dist/modules/agent/runtime/server/Session.d.ts

@@ -18,12 +18,14 @@ export declare class Session {
     lazyToolNames: string[];
     /** Names of lazy tools that have been activated via load_tools */
     activatedLazyTools: Set<string>;
-    /** Names of skills that have been loaded via load_skill */
+    /** Names of skills that have been loaded via load_skills */
     loadedSkills: Set<string>;
     /** Page context received from client on init */
     pageContext?: PageContext;
     /** Current plan (null when no plan is active) */
     plan: ServerPlan | null;
+    /** Whether any real work (non-server tool calls) happened since the last plan step started */
+    planStepHasWork: boolean;
     /** Pending plan approval promise resolver */
     pendingPlanApproval: {
         resolve: (approved: boolean) => void;
@@ -32,6 +34,8 @@ export declare class Session {
     private unprunedMessages;
     /** Last generic tool definitions for transcript */
     private lastTools;
+    /** Last raw request payload for transcript (dev only) */
+    private lastDebugPayload;
     /** Bundled tool metadata map for server-side resolution */
     private bundledToolMap;
     /** Cache for resolved JSON Schemas (Zod→JSON Schema is deterministic) */