@buoy-gg/agent-core 7.0.41 → 7.0.42

package/lib/module/blocks/uiTool.js

@@ -1,1399 +1,9 @@
-"use strict";
+"use strict";import{validateParams as j}from"../catalog/validateParams";import{signature as x}from"../catalog/signature";import{idFactory as k}from"./runId";import{CAPS as c,MODEL_KINDS as u}from"./types";export const UI_TOOL_NAME="buoy_ui";const f={type:"string",enum:["muted","accent","warning","danger","info"]};const d={type:"object",properties:{label:{type:"string",description:"Button text, 1\u20134 words."},primary:{type:"boolean"},send:{type:"string",description:"Text sent as the user's next message when tapped."},dispatch:{type:"object",description:"A Buoy action to run when tapped \u2014 same policy and undo as if you called it.",properties:{toolId:{type:"string"},action:{type:"string"},params:{type:"object"}},required:["toolId","action"]},openTool:{type:"object",properties:{toolId:{type:"string"},select:{type:"string"}},required:["toolId"]},minimize:{type:"boolean",description:"Collapse the chat so the user can look at the app."}},required:["label"],additionalProperties:false};const v={anyOf:[{type:"string"},{type:"object",properties:{text:{type:"string"},tone:f},required:["text"]}]};export const UI_PARAMS={choice:{type:"object",properties:{question:{type:"string",description:"`title` is accepted as a synonym."},title:{type:"string",description:"Synonym for `question`."},options:{type:"array",maxItems:c.choiceOptions,items:{type:"object",properties:{id:{type:"string"},label:{type:"string"},detail:{type:"string"}},required:["id","label"]}},allowFreeText:{type:"boolean"}},required:["options"],additionalProperties:false},confirm:{type:"object",properties:{title:{type:"string",description:'Optional heading. Defaults to "Confirm".'},change:{type:"string",description:"What will change, in the user's words. `message` is accepted as a synonym."},message:{type:"string",description:"Synonym for `change`."},consequence:{type:"string"},approveLabel:{type:"string"},declineLabel:{type:"string"}},required:[],additionalProperties:false},input:{type:"object",properties:{label:{type:"string"},type:{type:"string",enum:["text","number","secret"]},placeholder:{type:"string"},submitLabel:{type:"string"}},required:["label"],additionalProperties:false},table:{type:"object",properties:{title:{type:"string"},columns:{type:"array",maxItems:4,items:{type:"string"}},rows:{type:"array",items:{type:"array",items:v}},total:{type:"number"}},required:["columns","rows"],additionalProperties:false},keyValue:{type:"object",properties:{title:{type:"string"},pairs:{type:"array",items:{type:"object",properties:{key:{type:"string"},value:{}},required:["key"]}}},required:["pairs"],additionalProperties:false},list:{type:"object",properties:{title:{type:"string"},items:{type:"array",items:{type:"object",properties:{id:{type:"string"},title:{type:"string"},subtitle:{type:"string"},trailing:{type:"string"},image:{type:"string",description:"Only a URL you read from the app in this conversation."},tone:f,action:d},required:["title"]}},total:{type:"number"}},required:["items"],additionalProperties:false},imageGrid:{type:"object",properties:{title:{type:"string"},images:{type:"array",maxItems:c.gridMax,items:{type:"object",properties:{url:{type:"string",description:"Only a URL you read from the app in this conversation."},alt:{type:"string",description:"What the picture IS \u2014 the name. Shown as the tile's heading and read by VoiceOver. `title` is accepted as a synonym; when neither is given it is filled from the caption or the file name."},caption:{type:"string",description:"The line under the name \u2014 stats, price, status."}},required:["url"]}},total:{type:"number"}},required:["images"],additionalProperties:false},diff:{type:"object",properties:{title:{type:"string"},changes:{type:"array",items:{type:"object",properties:{path:{type:"string"},before:{},after:{}},required:["path"]}}},required:["changes"],additionalProperties:false},chart:{type:"object",properties:{title:{type:"string"},bars:{type:"array",maxItems:c.chartBars,items:{type:"object",properties:{label:{type:"string"},value:{type:"number"},unit:{type:"string"},tone:f},required:["label","value"]}},max:{type:"number"}},required:["bars"],additionalProperties:false},steps:{type:"object",properties:{title:{type:"string"},steps:{type:"array",items:{type:"object",properties:{text:{type:"string"},state:{type:"string",enum:["todo","done","failed"]}},required:["text"]}}},required:["steps"],additionalProperties:false},code:{type:"object",properties:{title:{type:"string"},language:{type:"string",enum:["json","text"]},text:{type:"string"}},required:["text"],additionalProperties:false},actions:{type:"object",properties:{actions:{type:"array",maxItems:c.actions,items:d}},required:["actions"],additionalProperties:false},suggestions:{type:"object",properties:{chips:{type:"array",maxItems:4,items:{type:"object",properties:{label:{type:"string"},send:{type:"string"}},required:["label"]}}},required:["chips"],additionalProperties:false},multiSelect:{type:"object",properties:{question:{type:"string"},options:{type:"array",maxItems:12,items:{type:"object",properties:{id:{type:"string"},label:{type:"string"},detail:{type:"string"}},required:["id","label"]}},min:{type:"number"},max:{type:"number"},submitLabel:{type:"string"}},required:["question","options"],additionalProperties:false},select:{type:"object",properties:{label:{type:"string"},options:{type:"array",maxItems:100,items:{type:"object",properties:{id:{type:"string"},label:{type:"string"},detail:{type:"string"}},required:["id","label"]}},searchable:{type:"boolean"}},required:["label","options"],additionalProperties:false},slider:{type:"object",properties:{label:{type:"string"},min:{type:"number"},max:{type:"number"},step:{type:"number"},value:{type:"number"},unit:{type:"string"}},required:["label","min","max"],additionalProperties:false},dateTime:{type:"object",properties:{label:{type:"string"},mode:{type:"string",enum:["date","time","datetime"]},presets:{type:"array",items:{type:"object",properties:{label:{type:"string"},value:{type:"string"}},required:["label","value"]}}},required:["label"],additionalProperties:false},form:{type:"object",properties:{title:{type:"string"},fields:{type:"array",maxItems:6,items:{type:"object"}},submitLabel:{type:"string"}},required:["fields"],additionalProperties:false},proposal:{type:"object",properties:{title:{type:"string"},change:{type:"string"},fields:{type:"array",maxItems:6,items:{type:"object"}},consequence:{type:"string"},approveLabel:{type:"string"}},required:["title","change","fields"],additionalProperties:false},claim:{type:"object",properties:{text:{type:"string"},sources:{type:"array",maxItems:4,items:{type:"object",properties:{label:{type:"string"},detail:{type:"string"}},required:["label"]}},verify:d},required:["text","sources"],additionalProperties:false},details:{type:"object",properties:{summary:{type:"string"},body:{type:"string"},open:{type:"boolean"}},required:["summary","body"],additionalProperties:false},compare:{type:"object",properties:{title:{type:"string"},left:{type:"object",properties:{title:{type:"string"},pairs:{type:"array",items:{type:"object"}}},required:["title","pairs"]},right:{type:"object",properties:{title:{type:"string"},pairs:{type:"array",items:{type:"object"}}},required:["title","pairs"]}},required:["left","right"],additionalProperties:false},card:{type:"object",properties:{title:{type:"string"},subtitle:{type:"string"},image:{type:"string"},facts:{type:"array",maxItems:6,items:{type:"object",properties:{label:{type:"string"},value:{type:"string"},tone:f},required:["label","value"]}},actions:{type:"array",maxItems:c.actions,items:d}},required:["title"],additionalProperties:false},cardCarousel:{type:"object",properties:{title:{type:"string"},cards:{type:"array",maxItems:8,items:{type:"object"}},total:{type:"number"}},required:["cards"],additionalProperties:false},sparkline:{type:"object",properties:{title:{type:"string"},series:{type:"array",maxItems:120,items:{type:"number"}},unit:{type:"string"},label:{type:"string"},current:{type:"number"}},required:["series"],additionalProperties:false},plan:{type:"object",properties:{title:{type:"string"},steps:{type:"array",maxItems:10,items:{type:"object",properties:{text:{type:"string"},state:{type:"string",enum:["todo","running","done","failed"]}},required:["text"]}},pending:{type:"boolean"},actions:{type:"array",maxItems:c.actions,items:d}},required:["title","steps"],additionalProperties:false},finding:{type:"object",properties:{title:{type:"string"},evidence:{type:"array",items:{type:"object",properties:{label:{type:"string"},value:{type:"string"},tone:f},required:["label","value"]}},actions:{type:"array",maxItems:c.actions,items:d}},required:["title","evidence"],additionalProperties:false}};const a=e=>!!e&&typeof e==="object"&&!Array.isArray(e);const y=e=>typeof e==="string"&&e.trim()?e.trim():void 0;const b=e=>e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"").slice(0,40)||"option";const P={choice:{options:["choices","items"]},multiSelect:{options:["choices","items"],question:["title","label"]},select:{options:["choices","items"],label:["title","question"]},input:{label:["title","question","prompt"]},slider:{label:["title"]},dateTime:{label:["title"]},table:{rows:["data","items"],columns:["headers","header"]},keyValue:{pairs:["items","fields","rows","entries"]},list:{items:["rows","entries","data"]},imageGrid:{images:["items","urls","data","pictures"]},diff:{changes:["items","rows","diffs"]},chart:{bars:["items","data","values"]},steps:{steps:["items"]},code:{text:["code","content"]},actions:{actions:["items","buttons"]},suggestions:{chips:["items","suggestions","options","questions"]},finding:{evidence:["items","rows"]},claim:{text:["claim","statement"],sources:["items","evidence"]},details:{summary:["title","label"],body:["text","detail"]},card:{title:["name"]},cardCarousel:{cards:["items"]},sparkline:{series:["data","values","points"]},plan:{steps:["items"]},form:{fields:["items","inputs"]},proposal:{fields:["items","inputs"]}};function S(e,t){if(!t)return;for(const[i,r]of Object.entries(t)){if(e[i]!==void 0)continue;for(const o of r){if(e[o]===void 0)continue;e[i]=e[o];delete e[o];break}}}function n(e,t,i){const r=e[t];if(Array.isArray(r))e[t]=r.map(i)}function s(e,t,i){if(e[t]!==void 0)return;for(const r of i){if(e[r]===void 0)continue;e[t]=e[r];delete e[r];return}}const g=e=>{if(typeof e==="string")return{id:b(e),label:e};if(!a(e))return e;const t={...e};s(t,"label",["name","text","title"]);s(t,"id",["value","key"]);s(t,"detail",["description","subtitle"]);const i=y(t.label);if(i&&y(t.id)===void 0)t.id=b(i);return t};const m=e=>{if(typeof e==="string")return{label:e};if(!a(e))return e;const t={...e};s(t,"label",["name","text","title","question"]);return t};const h=e=>{if(typeof e==="string")return{text:e};if(!a(e))return e;const t={...e};s(t,"text",["label","title","step","description"]);return t};const I=e=>{if(typeof e==="string")return{url:e,alt:q(e)};if(!a(e))return e;const t={...e};s(t,"url",["image","src","uri","href"]);s(t,"alt",["title","name","label"]);s(t,"caption",["subtitle","description","detail"]);if(y(t.alt)===void 0){const i=y(t.url);t.alt=y(t.caption)??(i?q(i):"Image")}return t};function q(e){const t=e.split(/[?#]/)[0]??e;const i=t.split("/").filter(Boolean).pop()??"Image";return i.replace(/\.[a-z0-9]{1,5}$/i,"")||"Image"}const w=e=>{if(typeof e==="string")return{title:e};if(!a(e))return e;const t={...e};s(t,"title",["name","label"]);s(t,"subtitle",["description","detail","caption"]);s(t,"image",["url","thumbnail","img","src"]);s(t,"trailing",["value","right"]);return t};const A=e=>{if(!a(e))return e;const t={...e};s(t,"label",["name","title","key"]);s(t,"value",["count","amount","n"]);return t};const L=e=>{if(!a(e))return e;const t={...e};s(t,"key",["label","name","field"]);return t};const E=e=>{if(!a(e))return e;const t={...e};s(t,"label",["name","key","title"]);s(t,"value",["text","detail","description"]);return t};const O=e=>{if(!a(e))return e;const t={...e};s(t,"path",["field","key","name","label"]);s(t,"before",["from","old","previous"]);s(t,"after",["to","new","current"]);return t};const $={choice:e=>n(e,"options",g),multiSelect:e=>n(e,"options",g),select:e=>n(e,"options",g),suggestions:e=>n(e,"chips",m),actions:e=>n(e,"actions",m),steps:e=>n(e,"steps",h),plan:e=>{n(e,"steps",h);n(e,"actions",m)},imageGrid:e=>n(e,"images",I),list:e=>n(e,"items",w),chart:e=>n(e,"bars",A),diff:e=>n(e,"changes",O),claim:e=>n(e,"sources",m),finding:e=>{n(e,"evidence",E);n(e,"actions",m)},card:e=>n(e,"actions",m),keyValue:e=>{if(a(e.pairs)){e.pairs=Object.entries(e.pairs).map(([t,i])=>({key:t,value:i}))}n(e,"pairs",L)},table:e=>{const t=Array.isArray(e.columns)?e.columns.map(i=>String(i)):void 0;if(!t?.length)return;n(e,"rows",i=>{if(!a(i))return i;const r=Object.keys(i);return t.map(o=>i[o]??i[r.find(p=>p.toLowerCase()===o.toLowerCase())??""]??"")})},sparkline:e=>{n(e,"series",t=>{if(typeof t==="number")return t;if(typeof t==="string"&&t.trim()!==""&&Number.isFinite(Number(t))){return Number(t)}if(a(t)){const i=t.value??t.y??t.n;if(typeof i==="number")return i}return t})},code:e=>{const t=y(e.language)?.toLowerCase();if(t&&t!=="json"&&t!=="text")e.language="text"}};export function normaliseUiParams(e,t){const i=a(t)?{...t}:{};S(i,P[e]);$[e]?.(i);return i}export function uiParamsHelp(){const e=u.map(t=>`- ${t}: ${x(UI_PARAMS[t])}`).join("\n");return`The block's fields. \`*\` marks a required one; everything else is optional. Send EXACTLY these names \u2014 a field that is not listed is rejected.
 
-/**
- * `buoy_ui` — the one tool the model uses to SHOW or ASK instead of writing
- * prose. One tool with `action` as the block kind, like every other Buoy
- * tool, so tool selection stays good; the params are the block itself.
- *
- * Validation is the same `validateParams` every other action gets, and an
- * invalid block goes back as a schema error for self-correction. A valid
- * block is stamped with an id and yielded as a `block` event; an Ask block
- * also ends the turn (see runAgentTurn).
- */
-import { validateParams } from "../catalog/validateParams";
-import { signature } from "../catalog/signature";
-import { idFactory } from "./runId";
-import { CAPS, MODEL_KINDS } from "./types";
-export const UI_TOOL_NAME = "buoy_ui";
-const tone = {
-  type: "string",
-  enum: ["muted", "accent", "warning", "danger", "info"]
-};
-const action = {
-  type: "object",
-  properties: {
-    label: {
-      type: "string",
-      description: "Button text, 1–4 words."
-    },
-    primary: {
-      type: "boolean"
-    },
-    send: {
-      type: "string",
-      description: "Text sent as the user's next message when tapped."
-    },
-    dispatch: {
-      type: "object",
-      description: "A Buoy action to run when tapped — same policy and undo as if you called it.",
-      properties: {
-        toolId: {
-          type: "string"
-        },
-        action: {
-          type: "string"
-        },
-        params: {
-          type: "object"
-        }
-      },
-      required: ["toolId", "action"]
-    },
-    openTool: {
-      type: "object",
-      properties: {
-        toolId: {
-          type: "string"
-        },
-        select: {
-          type: "string"
-        }
-      },
-      required: ["toolId"]
-    },
-    minimize: {
-      type: "boolean",
-      description: "Collapse the chat so the user can look at the app."
-    }
-  },
-  required: ["label"],
-  additionalProperties: false
-};
-const cell = {
-  anyOf: [{
-    type: "string"
-  }, {
-    type: "object",
-    properties: {
-      text: {
-        type: "string"
-      },
-      tone
-    },
-    required: ["text"]
-  }]
-};
+${e}`}const C={choice:"ASK the user to pick one of 2\u20135 options when a request could mean different things. Ends your turn; their pick comes back as their next message.",confirm:"ASK before a change you are guessing at (a shape you haven't read, a user you invented, anything destructive). Ends your turn.",input:"ASK for one value you need (an order id, a quantity). Ends your turn.",table:"Show rows of comparable facts \u2014 prices before/after, requests, counts. \u22644 columns, \u22648 rows; put the rest in total.",keyValue:"Show one record's fields \u2014 a profile, a store's state, a stored value.",list:"Show several things with a title each \u2014 items, orders, users. Add image only from URLs you read. Each item may carry one action.",imageGrid:"Show pictures \u2014 menu items, loaded images. Only URLs you read from the app in this conversation; a URL you did not read is dropped. \u226424; grid up to 6, carousel after.",diff:"Show what changed: path, before, after. Use for compare questions and after any write.",chart:"Show numbers side by side as bars \u2014 render counts, timings, sizes. \u22648 bars.",steps:"Show a procedure or a plan as a checklist (to reproduce, to test).",code:"Show a raw value only when the user asked for the raw thing.",actions:"Offer up to two buttons for what to do next instead of writing 'say X and I'll\u2026'. Use send for a chat reply, dispatch to run an action directly, minimize to let them look at the app.",finding:"Report something worth filing: a title plus evidence rows (request \u2192 status, screen \u2192 what it showed). Add a button to reproduce or open the tool.",suggestions:"Offer 2\u20134 follow-up questions the user might ask next. Put it last.",multiSelect:"ASK the user to pick several (which stores, which keys). Ends your turn.",select:"ASK the user to pick one from a long list (routes, stores) \u2014 searchable. Ends your turn.",slider:"ASK for a number in a range (a delay, a quantity). Ends your turn.",dateTime:"ASK for a date or time. Ends your turn.",form:"ASK for several coupled values at once. Ends your turn.",proposal:"ASK to approve a change whose values the user may edit first. Ends your turn.",claim:"State one fact with the evidence chips it rests on and a Verify button that re-reads it.",details:"A collapsed detail the user can open \u2014 long explanations, raw values.",compare:"Two things side by side with differences highlighted.",card:"One entity: title, image, facts, up to two actions.",cardCarousel:"3\u20138 cards to scan and pick from (scenarios, snapshots, items).",sparkline:"A series over time \u2014 FPS, memory, request timing.",plan:"Before multi-step work: the steps you intend, with Go/Stop. Update states as you go."};export function uiProviderTool(){const e=u.join(" | ");const t=u.map(o=>`- ${o}: ${C[o]}`).join("\n");const i=`Show the user something richer than text, or ask them something. Blocks render inline in the chat BELOW your text, as the last thing in your answer \u2014 so say what is coming and what it means first, then let the block land. Never repeat its contents in the text. Kinds: ${e}.`;const r=`Rules: choice/confirm/input END your turn \u2014 send them last, alone, with no other tool calls, and the answer arrives as the user's next message. Never put URLs, ids or numbers in a block that you did not read from a tool result in this conversation. Prefer the smallest block that answers.`;return{name:UI_TOOL_NAME,description:`${i}
+${t}
 
-/** Per-kind param schemas. Keys are block kinds; `kind` itself is the `action`. */
-// Keyed by BlockKind, not ModelKind: the definitions for kinds that are no
-// longer offered to the model are kept so restoring one is adding its name
-// back to MODEL_KINDS. Only MODEL_KINDS decides what is offered.
-export const UI_PARAMS = {
-  choice: {
-    type: "object",
-    properties: {
-      question: {
-        type: "string",
-        description: "`title` is accepted as a synonym."
-      },
-      title: {
-        type: "string",
-        description: "Synonym for `question`."
-      },
-      options: {
-        type: "array",
-        maxItems: CAPS.choiceOptions,
-        items: {
-          type: "object",
-          properties: {
-            id: {
-              type: "string"
-            },
-            label: {
-              type: "string"
-            },
-            detail: {
-              type: "string"
-            }
-          },
-          required: ["id", "label"]
-        }
-      },
-      allowFreeText: {
-        type: "boolean"
-      }
-    },
-    // `question` is satisfied by `title` too — see normaliseChoice. Same
-    // lesson the confirm block cost us: a schema that rejects the obvious
-    // synonym sends a model into a retry loop and the user is never asked.
-    required: ["options"],
-    additionalProperties: false
-  },
-  confirm: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string",
-        description: "Optional heading. Defaults to \"Confirm\"."
-      },
-      change: {
-        type: "string",
-        description: "What will change, in the user's words. `message` is accepted as a synonym."
-      },
-      message: {
-        type: "string",
-        description: "Synonym for `change`."
-      },
-      consequence: {
-        type: "string"
-      },
-      approveLabel: {
-        type: "string"
-      },
-      declineLabel: {
-        type: "string"
-      }
-    },
-    // ONLY `change` is required, and `message` satisfies it (see
-    // normaliseConfirm). Requiring both `title` AND `change` while rejecting
-    // `message` sent a live model into a four-attempt failure loop — it kept
-    // sending the universal {title, message} shape, and the validator
-    // answered "change: required" then "title: required", which reads as
-    // contradictory. It gave up and the user never got asked.
-    required: [],
-    additionalProperties: false
-  },
-  input: {
-    type: "object",
-    properties: {
-      label: {
-        type: "string"
-      },
-      type: {
-        type: "string",
-        enum: ["text", "number", "secret"]
-      },
-      placeholder: {
-        type: "string"
-      },
-      submitLabel: {
-        type: "string"
-      }
-    },
-    required: ["label"],
-    additionalProperties: false
-  },
-  table: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      columns: {
-        type: "array",
-        maxItems: 4,
-        items: {
-          type: "string"
-        }
-      },
-      rows: {
-        type: "array",
-        items: {
-          type: "array",
-          items: cell
-        }
-      },
-      total: {
-        type: "number"
-      }
-    },
-    required: ["columns", "rows"],
-    additionalProperties: false
-  },
-  keyValue: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      pairs: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            key: {
-              type: "string"
-            },
-            value: {}
-          },
-          required: ["key"]
-        }
-      }
-    },
-    required: ["pairs"],
-    additionalProperties: false
-  },
-  list: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      items: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            id: {
-              type: "string"
-            },
-            title: {
-              type: "string"
-            },
-            subtitle: {
-              type: "string"
-            },
-            trailing: {
-              type: "string"
-            },
-            image: {
-              type: "string",
-              description: "Only a URL you read from the app in this conversation."
-            },
-            tone,
-            action
-          },
-          required: ["title"]
-        }
-      },
-      total: {
-        type: "number"
-      }
-    },
-    required: ["items"],
-    additionalProperties: false
-  },
-  imageGrid: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      images: {
-        type: "array",
-        maxItems: CAPS.gridMax,
-        items: {
-          type: "object",
-          properties: {
-            url: {
-              type: "string",
-              description: "Only a URL you read from the app in this conversation."
-            },
-            alt: {
-              type: "string",
-              description: "What the picture IS — the name. Shown as the tile's heading and read by VoiceOver. `title` is accepted as a synonym; when neither is given it is filled from the caption or the file name."
-            },
-            caption: {
-              type: "string",
-              description: "The line under the name — stats, price, status."
-            }
-          },
-          // `alt` used to be required and models kept omitting it while
-          // sending `title` instead, which cost a whole round to a field the
-          // block can derive. See normaliseImages.
-          required: ["url"]
-        }
-      },
-      total: {
-        type: "number"
-      }
-    },
-    required: ["images"],
-    additionalProperties: false
-  },
-  diff: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      changes: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            path: {
-              type: "string"
-            },
-            before: {},
-            after: {}
-          },
-          required: ["path"]
-        }
-      }
-    },
-    required: ["changes"],
-    additionalProperties: false
-  },
-  chart: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      bars: {
-        type: "array",
-        maxItems: CAPS.chartBars,
-        items: {
-          type: "object",
-          properties: {
-            label: {
-              type: "string"
-            },
-            value: {
-              type: "number"
-            },
-            unit: {
-              type: "string"
-            },
-            tone
-          },
-          required: ["label", "value"]
-        }
-      },
-      max: {
-        type: "number"
-      }
-    },
-    required: ["bars"],
-    additionalProperties: false
-  },
-  steps: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      steps: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            text: {
-              type: "string"
-            },
-            state: {
-              type: "string",
-              enum: ["todo", "done", "failed"]
-            }
-          },
-          required: ["text"]
-        }
-      }
-    },
-    required: ["steps"],
-    additionalProperties: false
-  },
-  code: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      language: {
-        type: "string",
-        enum: ["json", "text"]
-      },
-      text: {
-        type: "string"
-      }
-    },
-    required: ["text"],
-    additionalProperties: false
-  },
-  actions: {
-    type: "object",
-    properties: {
-      actions: {
-        type: "array",
-        maxItems: CAPS.actions,
-        items: action
-      }
-    },
-    required: ["actions"],
-    additionalProperties: false
-  },
-  suggestions: {
-    type: "object",
-    properties: {
-      chips: {
-        type: "array",
-        maxItems: 4,
-        items: {
-          type: "object",
-          properties: {
-            label: {
-              type: "string"
-            },
-            send: {
-              type: "string"
-            }
-          },
-          required: ["label"]
-        }
-      }
-    },
-    required: ["chips"],
-    additionalProperties: false
-  },
-  multiSelect: {
-    type: "object",
-    properties: {
-      question: {
-        type: "string"
-      },
-      options: {
-        type: "array",
-        maxItems: 12,
-        items: {
-          type: "object",
-          properties: {
-            id: {
-              type: "string"
-            },
-            label: {
-              type: "string"
-            },
-            detail: {
-              type: "string"
-            }
-          },
-          required: ["id", "label"]
-        }
-      },
-      min: {
-        type: "number"
-      },
-      max: {
-        type: "number"
-      },
-      submitLabel: {
-        type: "string"
-      }
-    },
-    required: ["question", "options"],
-    additionalProperties: false
-  },
-  select: {
-    type: "object",
-    properties: {
-      label: {
-        type: "string"
-      },
-      options: {
-        type: "array",
-        maxItems: 100,
-        items: {
-          type: "object",
-          properties: {
-            id: {
-              type: "string"
-            },
-            label: {
-              type: "string"
-            },
-            detail: {
-              type: "string"
-            }
-          },
-          required: ["id", "label"]
-        }
-      },
-      searchable: {
-        type: "boolean"
-      }
-    },
-    required: ["label", "options"],
-    additionalProperties: false
-  },
-  slider: {
-    type: "object",
-    properties: {
-      label: {
-        type: "string"
-      },
-      min: {
-        type: "number"
-      },
-      max: {
-        type: "number"
-      },
-      step: {
-        type: "number"
-      },
-      value: {
-        type: "number"
-      },
-      unit: {
-        type: "string"
-      }
-    },
-    required: ["label", "min", "max"],
-    additionalProperties: false
-  },
-  dateTime: {
-    type: "object",
-    properties: {
-      label: {
-        type: "string"
-      },
-      mode: {
-        type: "string",
-        enum: ["date", "time", "datetime"]
-      },
-      presets: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            label: {
-              type: "string"
-            },
-            value: {
-              type: "string"
-            }
-          },
-          required: ["label", "value"]
-        }
-      }
-    },
-    required: ["label"],
-    additionalProperties: false
-  },
-  form: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      fields: {
-        type: "array",
-        maxItems: 6,
-        items: {
-          type: "object"
-        }
-      },
-      submitLabel: {
-        type: "string"
-      }
-    },
-    required: ["fields"],
-    additionalProperties: false
-  },
-  proposal: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      change: {
-        type: "string"
-      },
-      fields: {
-        type: "array",
-        maxItems: 6,
-        items: {
-          type: "object"
-        }
-      },
-      consequence: {
-        type: "string"
-      },
-      approveLabel: {
-        type: "string"
-      }
-    },
-    required: ["title", "change", "fields"],
-    additionalProperties: false
-  },
-  claim: {
-    type: "object",
-    properties: {
-      text: {
-        type: "string"
-      },
-      sources: {
-        type: "array",
-        maxItems: 4,
-        items: {
-          type: "object",
-          properties: {
-            label: {
-              type: "string"
-            },
-            detail: {
-              type: "string"
-            }
-          },
-          required: ["label"]
-        }
-      },
-      verify: action
-    },
-    required: ["text", "sources"],
-    additionalProperties: false
-  },
-  details: {
-    type: "object",
-    properties: {
-      summary: {
-        type: "string"
-      },
-      body: {
-        type: "string"
-      },
-      open: {
-        type: "boolean"
-      }
-    },
-    required: ["summary", "body"],
-    additionalProperties: false
-  },
-  compare: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      left: {
-        type: "object",
-        properties: {
-          title: {
-            type: "string"
-          },
-          pairs: {
-            type: "array",
-            items: {
-              type: "object"
-            }
-          }
-        },
-        required: ["title", "pairs"]
-      },
-      right: {
-        type: "object",
-        properties: {
-          title: {
-            type: "string"
-          },
-          pairs: {
-            type: "array",
-            items: {
-              type: "object"
-            }
-          }
-        },
-        required: ["title", "pairs"]
-      }
-    },
-    required: ["left", "right"],
-    additionalProperties: false
-  },
-  card: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      subtitle: {
-        type: "string"
-      },
-      image: {
-        type: "string"
-      },
-      facts: {
-        type: "array",
-        maxItems: 6,
-        items: {
-          type: "object",
-          properties: {
-            label: {
-              type: "string"
-            },
-            value: {
-              type: "string"
-            },
-            tone
-          },
-          required: ["label", "value"]
-        }
-      },
-      actions: {
-        type: "array",
-        maxItems: CAPS.actions,
-        items: action
-      }
-    },
-    required: ["title"],
-    additionalProperties: false
-  },
-  cardCarousel: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      cards: {
-        type: "array",
-        maxItems: 8,
-        items: {
-          type: "object"
-        }
-      },
-      total: {
-        type: "number"
-      }
-    },
-    required: ["cards"],
-    additionalProperties: false
-  },
-  sparkline: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      series: {
-        type: "array",
-        maxItems: 120,
-        items: {
-          type: "number"
-        }
-      },
-      unit: {
-        type: "string"
-      },
-      label: {
-        type: "string"
-      },
-      current: {
-        type: "number"
-      }
-    },
-    required: ["series"],
-    additionalProperties: false
-  },
-  plan: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      steps: {
-        type: "array",
-        maxItems: 10,
-        items: {
-          type: "object",
-          properties: {
-            text: {
-              type: "string"
-            },
-            state: {
-              type: "string",
-              enum: ["todo", "running", "done", "failed"]
-            }
-          },
-          required: ["text"]
-        }
-      },
-      pending: {
-        type: "boolean"
-      },
-      actions: {
-        type: "array",
-        maxItems: CAPS.actions,
-        items: action
-      }
-    },
-    required: ["title", "steps"],
-    additionalProperties: false
-  },
-  finding: {
-    type: "object",
-    properties: {
-      title: {
-        type: "string"
-      },
-      evidence: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            label: {
-              type: "string"
-            },
-            value: {
-              type: "string"
-            },
-            tone
-          },
-          required: ["label", "value"]
-        }
-      },
-      actions: {
-        type: "array",
-        maxItems: CAPS.actions,
-        items: action
-      }
-    },
-    required: ["title", "evidence"],
-    additionalProperties: false
-  }
-};
+${r}`,summaryDescription:`${i}
 
-/* ------------------------------------------------------------------------ *
- * Accepting the shape models actually send.
- *
- * The same lesson as `catalog/normalizeParams.ts`, learned again on the block
- * tool: A MECHANICAL ALIAS MUST NEVER COST A TURN. Measured on a live device
- * (gateway #182-#184, gpt-4.1), one `imageGrid` + `suggestions` pair took
- * THREE rounds to land — `items` for `images`, `items` for `chips`, a missing
- * `alt`, then chips as bare strings. Half the turn, and because the model
- * rewrites its prose on every round the user read the same closing paragraph
- * four times.
- *
- * None of those were disagreements about meaning. They were field names, and
- * the model had never been shown them (see `uiProviderTool`, which now sends
- * the signatures). This layer covers the rest: the container the model reached
- * for, the item shape it flattened, the synonym it preferred.
- *
- * The rule for what belongs here: the correction has to be MECHANICAL — one
- * unambiguous reading, no guess about intent. Renaming `items` to `images` on
- * an imageGrid is mechanical. Inventing a caption is not.
- *
- * Runs BEFORE `validateParams`, unlike `normaliseChoice`/`normaliseConfirm`
- * below it, which predate this and work by listing their synonyms in the
- * schema instead. Pre-validation is the better seam: an alias renamed here
- * never has to appear in the schema at all, and `additionalProperties: false`
- * keeps its meaning.
- * ------------------------------------------------------------------------ */
-
-const isRec = v => !!v && typeof v === "object" && !Array.isArray(v);
-const text = v => typeof v === "string" && v.trim() ? v.trim() : undefined;
-
-/** `Ship it now` -> `ship-it-now`, for an option that arrived without an id. */
-const slug = label => label.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40) || "option";
-
-/**
- * Canonical field name -> the names models send instead. Applied only when
- * the canonical field is absent, so a model that sent both keeps its own.
- */
-const FIELD_ALIASES = {
-  choice: {
-    options: ["choices", "items"]
-  },
-  multiSelect: {
-    options: ["choices", "items"],
-    question: ["title", "label"]
-  },
-  select: {
-    options: ["choices", "items"],
-    label: ["title", "question"]
-  },
-  input: {
-    label: ["title", "question", "prompt"]
-  },
-  slider: {
-    label: ["title"]
-  },
-  dateTime: {
-    label: ["title"]
-  },
-  table: {
-    rows: ["data", "items"],
-    columns: ["headers", "header"]
-  },
-  keyValue: {
-    pairs: ["items", "fields", "rows", "entries"]
-  },
-  list: {
-    items: ["rows", "entries", "data"]
-  },
-  imageGrid: {
-    images: ["items", "urls", "data", "pictures"]
-  },
-  diff: {
-    changes: ["items", "rows", "diffs"]
-  },
-  chart: {
-    bars: ["items", "data", "values"]
-  },
-  steps: {
-    steps: ["items"]
-  },
-  code: {
-    text: ["code", "content"]
-  },
-  actions: {
-    actions: ["items", "buttons"]
-  },
-  suggestions: {
-    chips: ["items", "suggestions", "options", "questions"]
-  },
-  finding: {
-    evidence: ["items", "rows"]
-  },
-  claim: {
-    text: ["claim", "statement"],
-    sources: ["items", "evidence"]
-  },
-  details: {
-    summary: ["title", "label"],
-    body: ["text", "detail"]
-  },
-  card: {
-    title: ["name"]
-  },
-  cardCarousel: {
-    cards: ["items"]
-  },
-  sparkline: {
-    series: ["data", "values", "points"]
-  },
-  plan: {
-    steps: ["items"]
-  },
-  form: {
-    fields: ["items", "inputs"]
-  },
-  proposal: {
-    fields: ["items", "inputs"]
-  }
-};
-
-/** Rename in place: `canonical <- first alias present`, canonical wins. */
-function applyAliases(params, aliases) {
-  if (!aliases) return;
-  for (const [canonical, alts] of Object.entries(aliases)) {
-    if (params[canonical] !== undefined) continue;
-    for (const alt of alts) {
-      if (params[alt] === undefined) continue;
-      params[canonical] = params[alt];
-      delete params[alt];
-      break;
-    }
-  }
-}
-
-/** Map one array field through a coercion, leaving a non-array untouched. */
-function eachItem(params, field, fn) {
-  const arr = params[field];
-  if (Array.isArray(arr)) params[field] = arr.map(fn);
-}
-
-/** Rename inside an item object, canonical wins — the per-item `applyAliases`. */
-function renameIn(item, canonical, alts) {
-  if (item[canonical] !== undefined) return;
-  for (const alt of alts) {
-    if (item[alt] === undefined) continue;
-    item[canonical] = item[alt];
-    delete item[alt];
-    return;
-  }
-}
-
-/** `"Ship it"` or `{value,name}` -> `{id, label}`. Options carry a required id. */
-const normaliseOption = raw => {
-  if (typeof raw === "string") return {
-    id: slug(raw),
-    label: raw
-  };
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "label", ["name", "text", "title"]);
-  renameIn(item, "id", ["value", "key"]);
-  renameIn(item, "detail", ["description", "subtitle"]);
-  const label = text(item.label);
-  if (label && text(item.id) === undefined) item.id = slug(label);
-  return item;
-};
-
-/** `"Compare their HP"` -> `{label}`. Chips and buttons. */
-const normaliseLabelled = raw => {
-  if (typeof raw === "string") return {
-    label: raw
-  };
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "label", ["name", "text", "title", "question"]);
-  return item;
-};
-
-/** `"Open the bag"` -> `{text}`. Steps and plans. */
-const normaliseStep = raw => {
-  if (typeof raw === "string") return {
-    text: raw
-  };
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "text", ["label", "title", "step", "description"]);
-  return item;
-};
-
-/**
- * The imageGrid item, and the only coercion here that fills a field rather
- * than renaming one.
- *
- * `alt` is what the tile shows as its heading and what VoiceOver reads, so it
- * cannot be empty — but every model reaches for `title` first, and refusing
- * that cost a whole round on the wire. Derive it, in the order a person would:
- * the name it gave, else the caption, else the file name it came from.
- */
-const normaliseImage = raw => {
-  if (typeof raw === "string") return {
-    url: raw,
-    alt: fileName(raw)
-  };
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "url", ["image", "src", "uri", "href"]);
-  renameIn(item, "alt", ["title", "name", "label"]);
-  renameIn(item, "caption", ["subtitle", "description", "detail"]);
-  if (text(item.alt) === undefined) {
-    const url = text(item.url);
-    item.alt = text(item.caption) ?? (url ? fileName(url) : "Image");
-  }
-  return item;
-};
-
-/** `…/official-artwork/25.png?x=1` -> `25`. Last resort for a missing alt. */
-function fileName(url) {
-  const path = url.split(/[?#]/)[0] ?? url;
-  const last = path.split("/").filter(Boolean).pop() ?? "Image";
-  return last.replace(/\.[a-z0-9]{1,5}$/i, "") || "Image";
-}
-const normaliseListItem = raw => {
-  if (typeof raw === "string") return {
-    title: raw
-  };
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "title", ["name", "label"]);
-  renameIn(item, "subtitle", ["description", "detail", "caption"]);
-  renameIn(item, "image", ["url", "thumbnail", "img", "src"]);
-  renameIn(item, "trailing", ["value", "right"]);
-  return item;
-};
-const normaliseBar = raw => {
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "label", ["name", "title", "key"]);
-  renameIn(item, "value", ["count", "amount", "n"]);
-  return item;
-};
-const normalisePair = raw => {
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "key", ["label", "name", "field"]);
-  return item;
-};
-const normaliseEvidence = raw => {
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "label", ["name", "key", "title"]);
-  renameIn(item, "value", ["text", "detail", "description"]);
-  return item;
-};
-const normaliseChange = raw => {
-  if (!isRec(raw)) return raw;
-  const item = {
-    ...raw
-  };
-  renameIn(item, "path", ["field", "key", "name", "label"]);
-  renameIn(item, "before", ["from", "old", "previous"]);
-  renameIn(item, "after", ["to", "new", "current"]);
-  return item;
-};
-
-/**
- * Per-kind fixes that are more than a rename. Each one is still mechanical:
- * one reading, no guess about what the model meant.
- */
-const SHAPE_FIXES = {
-  choice: p => eachItem(p, "options", normaliseOption),
-  multiSelect: p => eachItem(p, "options", normaliseOption),
-  select: p => eachItem(p, "options", normaliseOption),
-  suggestions: p => eachItem(p, "chips", normaliseLabelled),
-  actions: p => eachItem(p, "actions", normaliseLabelled),
-  steps: p => eachItem(p, "steps", normaliseStep),
-  plan: p => {
-    eachItem(p, "steps", normaliseStep);
-    eachItem(p, "actions", normaliseLabelled);
-  },
-  imageGrid: p => eachItem(p, "images", normaliseImage),
-  list: p => eachItem(p, "items", normaliseListItem),
-  chart: p => eachItem(p, "bars", normaliseBar),
-  diff: p => eachItem(p, "changes", normaliseChange),
-  claim: p => eachItem(p, "sources", normaliseLabelled),
-  finding: p => {
-    eachItem(p, "evidence", normaliseEvidence);
-    eachItem(p, "actions", normaliseLabelled);
-  },
-  card: p => eachItem(p, "actions", normaliseLabelled),
-  keyValue: p => {
-    // `{pairs: {hp: 35, attack: 55}}` — the object map is what a model reaches
-    // for when the block is "one record's fields", and it means exactly one
-    // thing.
-    if (isRec(p.pairs)) {
-      p.pairs = Object.entries(p.pairs).map(([key, value]) => ({
-        key,
-        value
-      }));
-    }
-    eachItem(p, "pairs", normalisePair);
-  },
-  table: p => {
-    // Rows as OBJECTS keyed by the column names, instead of positional
-    // arrays. Only resolvable when `columns` is there to give the order —
-    // without it there is no single reading, so it is left to the validator.
-    const columns = Array.isArray(p.columns) ? p.columns.map(c => String(c)) : undefined;
-    if (!columns?.length) return;
-    eachItem(p, "rows", row => {
-      if (!isRec(row)) return row;
-      const keys = Object.keys(row);
-      return columns.map(col => row[col] ?? row[keys.find(k => k.toLowerCase() === col.toLowerCase()) ?? ""] ?? "");
-    });
-  },
-  sparkline: p => {
-    // `[{value: 12}]` or `["12"]` -> `[12]`. The block draws numbers.
-    eachItem(p, "series", point => {
-      if (typeof point === "number") return point;
-      if (typeof point === "string" && point.trim() !== "" && Number.isFinite(Number(point))) {
-        return Number(point);
-      }
-      if (isRec(point)) {
-        const v = point.value ?? point.y ?? point.n;
-        if (typeof v === "number") return v;
-      }
-      return point;
-    });
-  },
-  code: p => {
-    // The enum is json|text. A model naming the real language ("javascript",
-    // "tsx") means "not JSON", and bouncing the block over a label nobody
-    // renders differently is the definition of a wasted turn.
-    const language = text(p.language)?.toLowerCase();
-    if (language && language !== "json" && language !== "text") p.language = "text";
-  }
-};
-
-/**
- * The whole pre-validation pass. Returns a NEW object — the caller's params
- * come straight off the model's tool call and are echoed back in the trace.
- */
-export function normaliseUiParams(kind, raw) {
-  const params = isRec(raw) ? {
-    ...raw
-  } : {};
-  applyAliases(params, FIELD_ALIASES[kind]);
-  SHAPE_FIXES[kind]?.(params);
-  return params;
-}
-
-/* ------------------------------------------------------------------------ *
- * The signatures the model is shown.
- *
- * `uiProviderTool` used to send `params: { type: "object" }` and 26 lines of
- * prose about what each kind is FOR — and not one field name. The model was
- * being asked to guess `images` vs `items` and `chips` vs `options`, and it
- * guessed wrong three rounds running. Rendered from `UI_PARAMS` rather than
- * written out, so the thing the model reads can never drift from the thing
- * the validator enforces.
- * ------------------------------------------------------------------------ */
-
-/** The `Fields per kind` block sent in the `params` property description. */
-export function uiParamsHelp() {
-  const lines = MODEL_KINDS.map(k => `- ${k}: ${signature(UI_PARAMS[k])}`).join("\n");
-  return `The block's fields. \`*\` marks a required one; everything else is optional. Send EXACTLY these names — a field that is not listed is rejected.\n\n${lines}`;
-}
-const KIND_HELP = {
-  choice: "ASK the user to pick one of 2–5 options when a request could mean different things. Ends your turn; their pick comes back as their next message.",
-  confirm: "ASK before a change you are guessing at (a shape you haven't read, a user you invented, anything destructive). Ends your turn.",
-  input: "ASK for one value you need (an order id, a quantity). Ends your turn.",
-  table: "Show rows of comparable facts — prices before/after, requests, counts. ≤4 columns, ≤8 rows; put the rest in total.",
-  keyValue: "Show one record's fields — a profile, a store's state, a stored value.",
-  list: "Show several things with a title each — items, orders, users. Add image only from URLs you read. Each item may carry one action.",
-  imageGrid: "Show pictures — menu items, loaded images. Only URLs you read from the app in this conversation; a URL you did not read is dropped. ≤24; grid up to 6, carousel after.",
-  diff: "Show what changed: path, before, after. Use for compare questions and after any write.",
-  chart: "Show numbers side by side as bars — render counts, timings, sizes. ≤8 bars.",
-  steps: "Show a procedure or a plan as a checklist (to reproduce, to test).",
-  code: "Show a raw value only when the user asked for the raw thing.",
-  actions: "Offer up to two buttons for what to do next instead of writing 'say X and I'll…'. Use send for a chat reply, dispatch to run an action directly, minimize to let them look at the app.",
-  finding: "Report something worth filing: a title plus evidence rows (request → status, screen → what it showed). Add a button to reproduce or open the tool.",
-  suggestions: "Offer 2–4 follow-up questions the user might ask next. Put it last.",
-  multiSelect: "ASK the user to pick several (which stores, which keys). Ends your turn.",
-  select: "ASK the user to pick one from a long list (routes, stores) — searchable. Ends your turn.",
-  slider: "ASK for a number in a range (a delay, a quantity). Ends your turn.",
-  dateTime: "ASK for a date or time. Ends your turn.",
-  form: "ASK for several coupled values at once. Ends your turn.",
-  proposal: "ASK to approve a change whose values the user may edit first. Ends your turn.",
-  claim: "State one fact with the evidence chips it rests on and a Verify button that re-reads it.",
-  details: "A collapsed detail the user can open — long explanations, raw values.",
-  compare: "Two things side by side with differences highlighted.",
-  card: "One entity: title, image, facts, up to two actions.",
-  cardCarousel: "3–8 cards to scan and pick from (scenarios, snapshots, items).",
-  sparkline: "A series over time — FPS, memory, request timing.",
-  plan: "Before multi-step work: the steps you intend, with Go/Stop. Update states as you go."
-};
-
-/** The provider-facing tool definition. */
-export function uiProviderTool() {
-  const kinds = MODEL_KINDS.join(" | ");
-  const help = MODEL_KINDS.map(k => `- ${k}: ${KIND_HELP[k]}`).join("\n");
-  const intro = `Show the user something richer than text, or ask them something. Blocks render inline in the chat BELOW your text, as the last thing in your answer — so say what is coming and what it means first, then let the block land. Never repeat its contents in the text. Kinds: ${kinds}.`;
-  const rules = `Rules: choice/confirm/input END your turn — send them last, alone, with no other tool calls, and the answer arrives as the user's next message. Never put URLs, ids or numbers in a block that you did not read from a tool result in this conversation. Prefer the smallest block that answers.`;
-  return {
-    name: UI_TOOL_NAME,
-    description: `${intro}\n${help}\n\n${rules}`,
-    // The split the OpenAI adapter serializes (see ProviderTool): the prose
-    // fits its 1024-char cap, the per-kind help rides on the `action`
-    // property, where nothing is capped. Before the split that cap cut this
-    // tool off inside the kind list and the Rules never reached the model.
-    summaryDescription: `${intro}\n\n${rules}`,
-    actionsBlock: `Kinds:\n${help}`,
-    inputSchema: {
-      type: "object",
-      properties: {
-        action: {
-          type: "string",
-          enum: [...MODEL_KINDS],
-          description: "The block kind."
-        },
-        // The per-kind field names, rendered from UI_PARAMS. Nothing caps a
-        // property description on either protocol (see ProviderTool), so this
-        // reaches the model whole — which the prose alone never did.
-        params: {
-          type: "object",
-          description: uiParamsHelp()
-        }
-      },
-      required: ["action", "params"],
-      additionalProperties: false
-    }
-  };
-}
-const nextUiId = idFactory("ui");
-
-/** Validate a `buoy_ui` call and build the block. */
-/**
- * Accept the shape models actually send for a confirm. `message` is the
- * near-universal field name, and `title` alone is a perfectly clear ask —
- * so fold them into the block's own vocabulary rather than bouncing the
- * call. Returns null only when there is genuinely nothing to agree to.
- */
-function normaliseConfirm(params) {
-  const str = v => typeof v === "string" && v.trim() ? v.trim() : undefined;
-  const {
-    message,
-    ...rest
-  } = params;
-  const change = str(rest.change) ?? str(message) ?? str(rest.title);
-  if (!change) return null;
-  // When both arrived, the one we didn't use as `change` still carries
-  // meaning — keep it as the consequence line rather than dropping it.
-  const spare = str(rest.change) ? str(message) : undefined;
-  return {
-    ...rest,
-    title: str(rest.title) ?? "Confirm",
-    change,
-    consequence: str(rest.consequence) ?? spare
-  };
-}
-
-/** Accept `title` where the schema says `question` — see normaliseConfirm. */
-function normaliseChoice(params) {
-  const str = v => typeof v === "string" && v.trim() ? v.trim() : undefined;
-  const {
-    title,
-    ...rest
-  } = params;
-  const question = str(rest.question) ?? str(title);
-  if (!question) return null;
-  return {
-    ...rest,
-    question
-  };
-}
-export function buildUiBlock(input) {
-  const kind = input.action;
-  if (!kind || !MODEL_KINDS.includes(kind)) {
-    return {
-      ok: false,
-      errors: [`"action" must be one of: ${MODEL_KINDS.join(", ")}`]
-    };
-  }
-  // `kind` is already known to be in MODEL_KINDS, so a missing schema means a
-  // kind was offered without one — a build mistake, not model input.
-  const schema = UI_PARAMS[kind];
-  if (!schema) {
-    return {
-      ok: false,
-      errors: [`"${kind}" is offered but has no schema — this is a Buoy bug, not your call.`]
-    };
-  }
-  // Aliases and item shapes FIRST, so a field name never costs a round trip.
-  let params = normaliseUiParams(kind, input.params);
-  const check = validateParams(params, schema);
-  if (!check.ok) return {
-    ok: false,
-    errors: check.errors
-  };
-  if (kind === "choice") {
-    const fixed = normaliseChoice(params);
-    if (!fixed) {
-      return {
-        ok: false,
-        errors: ['choice needs the question being asked: pass `question` (or `title`), e.g. { "question": "Which checkout?", "options": [...] }']
-      };
-    }
-    params = fixed;
-  }
-  if (kind === "confirm") {
-    const fixed = normaliseConfirm(params);
-    if (!fixed) {
-      return {
-        ok: false,
-        errors: ['confirm needs what the user is agreeing to: pass `change` (or `message`), e.g. { "change": "Wipe all app storage", "consequence": "This cannot be undone." }']
-      };
-    }
-    params = fixed;
-  }
-  const block = {
-    ...params,
-    kind,
-    id: nextUiId(),
-    source: "model"
-  };
-  return {
-    ok: true,
-    errors: [],
-    block
-  };
-}
-//# sourceMappingURL=uiTool.js.map
+${r}`,actionsBlock:`Kinds:
+${t}`,inputSchema:{type:"object",properties:{action:{type:"string",enum:[...u],description:"The block kind."},params:{type:"object",description:uiParamsHelp()}},required:["action","params"],additionalProperties:false}}}const T=k("ui");function U(e){const t=l=>typeof l==="string"&&l.trim()?l.trim():void 0;const{message:i,...r}=e;const o=t(r.change)??t(i)??t(r.title);if(!o)return null;const p=t(r.change)?t(i):void 0;return{...r,title:t(r.title)??"Confirm",change:o,consequence:t(r.consequence)??p}}function K(e){const t=p=>typeof p==="string"&&p.trim()?p.trim():void 0;const{title:i,...r}=e;const o=t(r.question)??t(i);if(!o)return null;return{...r,question:o}}export function buildUiBlock(e){const t=e.action;if(!t||!u.includes(t)){return{ok:false,errors:[`"action" must be one of: ${u.join(", ")}`]}}const i=UI_PARAMS[t];if(!i){return{ok:false,errors:[`"${t}" is offered but has no schema \u2014 this is a Buoy bug, not your call.`]}}let r=normaliseUiParams(t,e.params);const o=j(r,i);if(!o.ok)return{ok:false,errors:o.errors};if(t==="choice"){const l=K(r);if(!l){return{ok:false,errors:['choice needs the question being asked: pass `question` (or `title`), e.g. { "question": "Which checkout?", "options": [...] }']}}r=l}if(t==="confirm"){const l=U(r);if(!l){return{ok:false,errors:['confirm needs what the user is agreeing to: pass `change` (or `message`), e.g. { "change": "Wipe all app storage", "consequence": "This cannot be undone." }']}}r=l}const p={...r,kind:t,id:T(),source:"model"};return{ok:true,errors:[],block:p}}