@alquimia-ai/tools 2.3.0 → 2.5.0

package/dist/genui/index.mjs

@@ -172,6 +172,25 @@ function setPointer(model, pointer, value) {
 }
 
 // src/genui/actions.ts
+var DISMISS_ACTION = "userDismissedSurface";
+function buildDismissResult(surfaceId, userMessage) {
+  const said = typeof userMessage === "string" ? userMessage.trim() : "";
+  return {
+    action: DISMISS_ACTION,
+    surfaceId,
+    componentId: "",
+    data: {},
+    ...said ? { userMessage: said } : {}
+  };
+}
+function buildSurfaceResult(action) {
+  return {
+    action: action.action,
+    surfaceId: action.surfaceId,
+    componentId: action.componentId,
+    data: action.payload ?? {}
+  };
+}
 function classifyAction(action) {
   return action.wantResponse === true ? "agent-bound" : "local";
 }
@@ -209,7 +228,15 @@ var surfaceShape = z3.object({
 });
 var UAX31_ID = /^[\p{XID_Start}_][\p{XID_Continue}]*$/u;
 function validateProps(node, def2) {
-  const { id, component, children, child, binding, action, ...props } = node;
+  const {
+    id,
+    component: _component,
+    children: _children,
+    child: _child,
+    binding: _binding,
+    action: _action,
+    ...props
+  } = node;
   const parsed = def2.schema.safeParse(props);
   if (parsed.success) return { ok: true, value: parsed.data, errors: [] };
   return {
@@ -346,7 +373,9 @@ function buildGenuiClause(manifest, allowlist) {
     `Components: ${names.join(", ")}.`,
     `Style each component via the semantic vocabulary (never CSS, colors, or HTML): tone (${TONES.join("/")}), size (${SIZES.join("/")}), emphasis (low/medium/high), align (start/center/end), density (compact/comfortable), plus a component-specific variant where offered.`,
     "Data components MUST carry their data: Chart takes `data` (an array of row objects) + `series` (keys to plot) + `x` (the category key); Table takes `rows` (array of row objects) + `columns` ([{ key, header }] matching the row keys); List takes `items` (array); Stat takes `label`+`value`; KeyValue takes `data` (an object). Put the data inline on the component (or in dataModel referenced via `binding`).",
-    "To collect input, add a Button with an action { name, wantResponse: true }; its result (the data model) is returned to you. A surface with no such button is display-only.",
+    "To collect input, add a Button with an action { name, wantResponse: true }. You get back { action, surfaceId, componentId, data } \u2014 `data` is the collected data model and `componentId` is the id of the component that was acted on. A surface with no such button is display-only.",
+    "When you render several options to choose from (a grid of cards, each with its own button), give every option component a MEANINGFUL id (e.g. flight-NH107, hotel-memmo-alfama): `componentId` tells you which one the user picked, so never ask them to repeat a choice they already made.",
+    'The user may ignore an interactive surface and just type instead. You then receive action "userDismissedSurface" with their words in `userMessage` \u2014 treat it as their reply, answer it directly, and do not re-render the same surface or scold them for not using it.',
     "IMPORTANT: the rendered surface IS your reply \u2014 do NOT reproduce its content as text, markdown, or ASCII; a one-line intro at most.",
     "Prefer plain text for simple replies."
   ].join(" ");
@@ -3298,13 +3327,16 @@ export {
   ALIGNS,
   CORE_CATALOG_ID,
   DENSITIES,
+  DISMISS_ACTION,
   EMPHASES,
   SIZES,
   TONES,
   UNKNOWN_COMPONENT,
   assertSafeActionName,
+  buildDismissResult,
   buildGenuiClause,
   buildRenderUiSchema,
+  buildSurfaceResult,
   classifyAction,
   coreCatalog,
   core_v1_catalog_default as coreCatalogJson,