@absolutejs/ai 0.0.34 → 0.0.35

package/dist/ai/index.js

@@ -3680,18 +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) => {
@@ -3844,6 +3856,58 @@ var parseStatTilesSpec = (input) => {
     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: {
     name: { description: "Series name (shown in the legend)", type: "string" },
@@ -3946,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",
@@ -5099,6 +5228,7 @@ export {
   parseUiActions,
   parseTableSpec,
   parseStatTilesSpec,
+  parseFormSpec,
   parseChartSpec,
   parseAIMessage,
   openaiResponses,
@@ -5115,6 +5245,7 @@ export {
   generateAIWithTools,
   generateAI,
   gemini,
+  formCard,
   fetchProviderApiStatus,
   deepseek,
   createUiCards,
@@ -5136,6 +5267,9 @@ export {
   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,
@@ -5143,5 +5277,5 @@ export {
   BUILTIN_UI_CARDS
 };
 
-//# debugId=0E766AE845A0759F64756E2164756E21
+//# debugId=975418BCAB9B044864756E2164756E21
 //# sourceMappingURL=index.js.map