@absolutejs/ai 0.0.33 → 0.0.35

package/dist/ai/index.js

@@ -3680,15 +3680,30 @@ var createUiCards = (definitions) => {
 };
 // src/ai/ui/catalog.ts
 var CHART_TYPES = ["bar", "line", "donut"];
+var FORM_FIELD_TYPES = [
+  "text",
+  "textarea",
+  "number",
+  "select",
+  "date",
+  "checkbox"
+];
 var CHART_MAX_SERIES = 8;
 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 FORM_MAX_FIELDS = 8;
+var FORM_SELECT_MAX_OPTIONS = 12;
 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 DESCRIPTION_MAX_CHARS = 280;
+var ACTION_TOOL_PATTERN = /^[a-z][a-z0-9_]{1,63}$/;
+var FIELD_NAME_PATTERN = /^[a-z][a-zA-Z0-9_]{0,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 +3727,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 +3797,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 +3823,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 +3850,63 @@ var parseStatTilesSpec = (input) => {
     }
     tiles.push(tile);
   }
-  return { tiles };
+  const spec = { tiles };
+  const actions = parseUiActions(input.actions);
+  if (actions)
+    spec.actions = actions;
+  return spec;
+};
+var parseFormField = (raw) => {
+  if (!isRecord6(raw))
+    return null;
+  const name = typeof raw.name === "string" && FIELD_NAME_PATTERN.test(raw.name) ? raw.name : null;
+  const label = cleanString(raw.label, LABEL_MAX_CHARS);
+  const type = FORM_FIELD_TYPES.find((entry) => entry === raw.type);
+  if (!name || !label || !type)
+    return null;
+  const field = { label, name, type };
+  const placeholder = cleanString(raw.placeholder, LABEL_MAX_CHARS);
+  if (placeholder)
+    field.placeholder = placeholder;
+  if (raw.required === true)
+    field.required = true;
+  const value = cleanString(raw.value, CELL_MAX_CHARS);
+  if (value)
+    field.value = value;
+  const options = cleanStringArray(raw.options, FORM_SELECT_MAX_OPTIONS, LABEL_MAX_CHARS);
+  if (options)
+    field.options = options;
+  if (type === "select" && !options)
+    return null;
+  return field;
+};
+var parseFormFields = (value) => {
+  if (!Array.isArray(value) || value.length === 0)
+    return null;
+  const fields = [];
+  const seen = new Set;
+  for (const raw of value.slice(0, FORM_MAX_FIELDS)) {
+    const field = parseFormField(raw);
+    if (!field || seen.has(field.name))
+      return null;
+    seen.add(field.name);
+    fields.push(field);
+  }
+  return fields;
+};
+var parseFormSpec = (input) => {
+  if (!isRecord6(input))
+    return null;
+  const title = cleanString(input.title, TITLE_MAX_CHARS);
+  const fields = parseFormFields(input.fields);
+  const [submit] = parseUiActions([input.submit]) ?? [];
+  if (!title || !fields || !submit)
+    return null;
+  const spec = { fields, submit, title };
+  const description = cleanString(input.description, DESCRIPTION_MAX_CHARS);
+  if (description)
+    spec.description = description;
+  return spec;
 };
 var SERIES_SCHEMA = {
   properties: {
@@ -3814,6 +3925,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 +3958,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 +3982,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: {
@@ -3896,7 +4010,72 @@ var statTilesCard = {
   name: "render_stat_tiles",
   parse: parseStatTilesSpec
 };
-var BUILTIN_UI_CARDS = [chartCard, tableCard, statTilesCard];
+var formCard = {
+  ack: "(form rendered inline \u2014 the member fills and submits it, which runs the bound tool with their values. Do NOT re-ask for these values in text; wait for the submission)",
+  description: "Render an inline form when you need SEVERAL structured inputs from the member before running a tool (task details, scheduling constraints, outreach parameters) \u2014 one form beats asking field-by-field in prose. Bind submit to one of YOUR tools with any values you already know pre-filled in submit.input; on submit the member's field values are merged into submit.input under each field's name and the tool runs exactly like a clicked action button. Field names must therefore be the tool's actual input property names. Never use it for values you could look up yourself.",
+  inputSchema: {
+    properties: {
+      description: {
+        description: "Optional one-line helper text under the title",
+        type: "string"
+      },
+      fields: {
+        description: "The inputs to collect (max 8). Each field's name must be a real input property of the submit tool.",
+        items: {
+          properties: {
+            label: { description: "Human label for the field", type: "string" },
+            name: {
+              description: 'Tool-input property name the value submits under, e.g. "title"',
+              type: "string"
+            },
+            options: {
+              description: "Choices \u2014 required for select fields (max 12)",
+              items: { type: "string" },
+              type: "array"
+            },
+            placeholder: { type: "string" },
+            required: { type: "boolean" },
+            type: { enum: [...FORM_FIELD_TYPES], type: "string" },
+            value: {
+              description: 'Prefill value (checkbox: "true"/"false")',
+              type: "string"
+            }
+          },
+          required: ["name", "label", "type"],
+          type: "object"
+        },
+        type: "array"
+      },
+      submit: {
+        description: "The submit binding: label for the button, the tool to run, and any input values you already resolved (real ids, never placeholders)",
+        properties: {
+          input: {
+            description: "Pre-resolved input values; field values are merged in on top under their field names",
+            type: "object"
+          },
+          label: {
+            description: 'Button label, e.g. "Create task"',
+            type: "string"
+          },
+          tool: { description: "The tool name to invoke", type: "string" }
+        },
+        required: ["label", "tool", "input"],
+        type: "object"
+      },
+      title: { description: "Short form title", type: "string" }
+    },
+    required: ["title", "fields", "submit"],
+    type: "object"
+  },
+  name: "render_form",
+  parse: parseFormSpec
+};
+var BUILTIN_UI_CARDS = [
+  chartCard,
+  tableCard,
+  statTilesCard,
+  formCard
+];
 // src/ai/ui/svg.ts
 var LIGHT_UI_THEME = {
   grid: "#e4e4e0",
@@ -5046,8 +5225,10 @@ export {
   resolveRenderers,
   renderChartSvg,
   providerStatusPage,
+  parseUiActions,
   parseTableSpec,
   parseStatTilesSpec,
+  parseFormSpec,
   parseChartSpec,
   parseAIMessage,
   openaiResponses,
@@ -5064,6 +5245,7 @@ export {
   generateAIWithTools,
   generateAI,
   gemini,
+  formCard,
   fetchProviderApiStatus,
   deepseek,
   createUiCards,
@@ -5078,12 +5260,16 @@ export {
   anthropic,
   alibaba,
   aiChat,
+  UI_ACTIONS_MAX,
   TABLE_MAX_ROWS,
   TABLE_MAX_COLUMNS,
   STAT_TILES_MAX,
   ProviderError,
   PROVIDER_STATUS_PAGES,
   LIGHT_UI_THEME,
+  FORM_SELECT_MAX_OPTIONS,
+  FORM_MAX_FIELDS,
+  FORM_FIELD_TYPES,
   DARK_UI_THEME,
   CHART_TYPES,
   CHART_MAX_SERIES,
@@ -5091,5 +5277,5 @@ export {
   BUILTIN_UI_CARDS
 };
 
-//# debugId=D43CDA3E59D2F6FB64756E2164756E21
+//# debugId=975418BCAB9B044864756E2164756E21
 //# sourceMappingURL=index.js.map