@absolutejs/ai 0.0.32 → 0.0.34

package/dist/ai/index.js

@@ -3685,10 +3685,13 @@ var CHART_MAX_POINTS = 24;
 var TABLE_MAX_COLUMNS = 8;
 var TABLE_MAX_ROWS = 30;
 var STAT_TILES_MAX = 6;
+var UI_ACTIONS_MAX = 3;
 var LABEL_MAX_CHARS = 80;
 var TITLE_MAX_CHARS = 120;
 var CELL_MAX_CHARS = 160;
 var UNIT_MAX_CHARS = 8;
+var ACTION_LABEL_MAX_CHARS = 40;
+var ACTION_TOOL_PATTERN = /^[a-z][a-z0-9_]{1,63}$/;
 var isRecord6 = (value) => typeof value === "object" && value !== null;
 var cleanString = (value, maxChars) => typeof value === "string" && value.trim().length > 0 ? value.trim().slice(0, maxChars) : null;
 var cleanStringArray = (value, maxItems, maxChars) => {
@@ -3712,6 +3715,40 @@ var cleanNumberArray = (value, maxItems) => {
   }
   return cleaned;
 };
+var parseUiActions = (value) => {
+  if (!Array.isArray(value) || value.length === 0)
+    return;
+  const actions = [];
+  for (const raw of value.slice(0, UI_ACTIONS_MAX)) {
+    if (!isRecord6(raw))
+      continue;
+    const label = cleanString(raw.label, ACTION_LABEL_MAX_CHARS);
+    const tool = typeof raw.tool === "string" && ACTION_TOOL_PATTERN.test(raw.tool) ? raw.tool : null;
+    if (!label || !tool || !isRecord6(raw.input))
+      continue;
+    actions.push({ input: raw.input, label, tool });
+  }
+  return actions.length > 0 ? actions : undefined;
+};
+var ACTIONS_SCHEMA = {
+  description: "Optional action buttons under the card (max 3): each invokes one of YOUR tools with a fully-resolved input when the member clicks it. Use real ids you looked up \u2014 never placeholders. Approval-gated tools queue their normal approval card.",
+  items: {
+    properties: {
+      input: {
+        description: "The exact tool input to send on click",
+        type: "object"
+      },
+      label: {
+        description: 'Short button label, e.g. "Create follow-up task"',
+        type: "string"
+      },
+      tool: { description: "The tool name to invoke", type: "string" }
+    },
+    required: ["label", "tool", "input"],
+    type: "object"
+  },
+  type: "array"
+};
 var parseChartSpec = (input) => {
   if (!isRecord6(input))
     return null;
@@ -3748,6 +3785,9 @@ var parseChartSpec = (input) => {
     spec.unitPrefix = unitPrefix;
   if (unitSuffix)
     spec.unitSuffix = unitSuffix;
+  const actions = parseUiActions(input.actions);
+  if (actions)
+    spec.actions = actions;
   return spec;
 };
 var parseTableSpec = (input) => {
@@ -3771,6 +3811,9 @@ var parseTableSpec = (input) => {
   const title = cleanString(input.title, TITLE_MAX_CHARS);
   if (title)
     spec.title = title;
+  const actions = parseUiActions(input.actions);
+  if (actions)
+    spec.actions = actions;
   return spec;
 };
 var parseStatTilesSpec = (input) => {
@@ -3795,7 +3838,11 @@ var parseStatTilesSpec = (input) => {
     }
     tiles.push(tile);
   }
-  return { tiles };
+  const spec = { tiles };
+  const actions = parseUiActions(input.actions);
+  if (actions)
+    spec.actions = actions;
+  return spec;
 };
 var SERIES_SCHEMA = {
   properties: {
@@ -3814,6 +3861,7 @@ var chartCard = {
   description: "Render a real chart inline in the chat from data you have (tool results, the conversation). Use whenever numbers COMPARE or TREND: revenue by partner (bar), pipeline over time (line), share of a whole (donut). Rules: bar/line take up to 8 series aligned to the same labels; donut takes exactly ONE series of non-negative values (one slice per label). Prefer a chart over a wall of numbers, but never invent data for it.",
   inputSchema: {
     properties: {
+      actions: ACTIONS_SCHEMA,
       labels: {
         description: "Category labels \u2014 x-axis for bar/line, slice names for donut (max 24)",
         items: { type: "string" },
@@ -3846,6 +3894,7 @@ var tableCard = {
   description: "Render a compact data table inline in the chat (max 8 columns \xD7 30 rows). Use for structured comparisons the member will scan \u2014 matches side by side, deal terms, task lists with dates. All cells are strings; format numbers yourself.",
   inputSchema: {
     properties: {
+      actions: ACTIONS_SCHEMA,
       columns: {
         description: "Column headers (max 8)",
         items: { type: "string" },
@@ -3869,6 +3918,7 @@ var statTilesCard = {
   description: "Render a row of headline stat tiles inline in the chat (max 6): a label, a big value, and an optional delta with direction. Use for the 2-4 numbers that ARE the answer \u2014 total attributed revenue, pipeline value, credits remaining \u2014 instead of burying them in prose.",
   inputSchema: {
     properties: {
+      actions: ACTIONS_SCHEMA,
       tiles: {
         description: "The tiles (max 6)",
         items: {
@@ -5046,6 +5096,7 @@ export {
   resolveRenderers,
   renderChartSvg,
   providerStatusPage,
+  parseUiActions,
   parseTableSpec,
   parseStatTilesSpec,
   parseChartSpec,
@@ -5078,6 +5129,7 @@ export {
   anthropic,
   alibaba,
   aiChat,
+  UI_ACTIONS_MAX,
   TABLE_MAX_ROWS,
   TABLE_MAX_COLUMNS,
   STAT_TILES_MAX,
@@ -5091,5 +5143,5 @@ export {
   BUILTIN_UI_CARDS
 };
 
-//# debugId=D43CDA3E59D2F6FB64756E2164756E21
+//# debugId=0E766AE845A0759F64756E2164756E21
 //# sourceMappingURL=index.js.map