@absolutejs/ai 0.3.2 → 0.3.3

package/dist/ai/ui/index.js

@@ -1,81 +1,24 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __name = (target, name) => {
-  Object.defineProperty(target, "name", {
-    value: name,
-    enumerable: false,
-    configurable: true
-  });
-  return target;
-};
-var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
-var __typeError = (msg) => {
-  throw TypeError(msg);
-};
-var __defNormalProp = (obj, key, value) => (key in obj) ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
-var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
-var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
-var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
-var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
-var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
-var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
-var __expectFn = (fn) => fn !== undefined && typeof fn !== "function" ? __typeError("Function expected") : fn;
-var __decoratorContext = (kind, name, done, metadata, fns) => ({
-  kind: __decoratorStrings[kind],
-  name,
-  metadata,
-  addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null))
-});
-var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
-var __runInitializers = (array, flags, self, value) => {
-  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length;i < n; i++)
-    flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
-  return value;
-};
-var __decorateElement = (array, flags, name, decorators, target, extra) => {
-  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
-  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
-  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
-  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : {
-    get [name]() {
-      return __privateGet(this, extra);
-    },
-    set [name](x) {
-      __privateSet(this, extra, x);
-    }
-  }, name));
-  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
-  for (var i = decorators.length - 1;i >= 0; i--) {
-    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
-    if (k) {
-      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => (name in x) };
-      if (k ^ 3)
-        access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
-      if (k > 2)
-        access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
-    }
-    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? undefined : { get: desc.get, set: desc.set } : target, ctx);
-    done._ = 1;
-    if (k ^ 4 || it === undefined)
-      __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
-    else if (typeof it !== "object" || it === null)
-      __typeError("Object expected");
-    else
-      __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
-  }
-  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
-};
-
 // src/ai/ui/uiCards.ts
+class UiCardValidationError extends Error {
+  card;
+  constructor(card) {
+    super(`UI card "${card}" was not rendered: input failed validation. Correct the input to match the tool schema and retry.`);
+    this.name = "UiCardValidationError";
+    this.card = card;
+  }
+}
 var createUiCards = (definitions) => {
   const byName = new Map(definitions.map((definition) => [definition.name, definition]));
   const tools = Object.fromEntries(definitions.map((definition) => [
     definition.name,
     {
       description: definition.description,
-      handler: () => definition.ack,
+      handler: async (input) => {
+        if (definition.parse(input) === null) {
+          throw new UiCardValidationError(definition.name);
+        }
+        return definition.ack;
+      },
       input: definition.inputSchema
     }
   ]));
@@ -119,6 +62,9 @@ var UI_ACTIONS_MAX = 3;
 var FORM_MAX_FIELDS = 8;
 var FORM_SELECT_MAX_OPTIONS = 12;
 var CHOICE_MAX_OPTIONS = 8;
+var CHOICE_TITLE_MAX_CHARS = 600;
+var CHOICE_LABEL_MAX_CHARS = 600;
+var CHOICE_DESCRIPTION_MAX_CHARS = 2000;
 var CONFIRM_CONSEQUENCE_MAX_CHARS = 500;
 var DIFF_MAX_FILES = 6;
 var DIFF_MAX_LINES = 400;
@@ -375,18 +321,29 @@ var parseFormSpec = (input) => {
   applyCardId(spec, input.cardId);
   return spec;
 };
+var completeString = (value, maxChars) => {
+  if (typeof value !== "string")
+    return null;
+  const text = value.trim();
+  return text.length > 0 && text.length <= maxChars ? text : null;
+};
+var optionalCompleteString = (value, maxChars) => value === undefined || typeof value === "string" && value.trim().length <= maxChars;
 var parseChoiceOption = (raw) => {
   if (!isRecord(raw))
     return null;
-  const id = cleanId(raw.id);
-  const label = cleanString(raw.label, LABEL_MAX_CHARS);
+  const id = completeString(raw.id, CARD_ID_MAX_CHARS);
+  const label = completeString(raw.label, CHOICE_LABEL_MAX_CHARS);
   if (!id || !label)
     return null;
+  if (!CARD_ID_PATTERN.test(id))
+    return null;
+  if (!optionalCompleteString(raw.description, CHOICE_DESCRIPTION_MAX_CHARS) || !optionalCompleteString(raw.badge, BADGE_MAX_CHARS))
+    return null;
   const option = { id, label };
-  const description = cleanString(raw.description, DESCRIPTION_MAX_CHARS);
+  const description = completeString(raw.description, CHOICE_DESCRIPTION_MAX_CHARS);
   if (description)
     option.description = description;
-  const badge = cleanString(raw.badge, BADGE_MAX_CHARS);
+  const badge = completeString(raw.badge, BADGE_MAX_CHARS);
   if (badge)
     option.badge = badge;
   return option;
@@ -394,15 +351,21 @@ var parseChoiceOption = (raw) => {
 var parseChoiceSpec = (input) => {
   if (!isRecord(input))
     return null;
-  const title = cleanString(input.title, TITLE_MAX_CHARS);
+  const title = completeString(input.title, CHOICE_TITLE_MAX_CHARS);
+  if (!optionalCompleteString(input.description, CHOICE_DESCRIPTION_MAX_CHARS))
+    return null;
+  if (input.cardId !== undefined && (typeof input.cardId !== "string" || !CARD_ID_PATTERN.test(input.cardId.trim())))
+    return null;
+  if (!isRecord(input.submit) || !completeString(input.submit.label, ACTION_LABEL_MAX_CHARS))
+    return null;
   const [submit] = parseUiActions([input.submit]) ?? [];
   if (!title || !submit)
     return null;
-  if (!Array.isArray(input.options) || input.options.length === 0)
+  if (!Array.isArray(input.options) || input.options.length === 0 || input.options.length > CHOICE_MAX_OPTIONS)
     return null;
   const options = [];
   const seen = new Set;
-  for (const raw of input.options.slice(0, CHOICE_MAX_OPTIONS)) {
+  for (const raw of input.options) {
     const option = parseChoiceOption(raw);
     if (!option || seen.has(option.id))
       return null;
@@ -410,7 +373,7 @@ var parseChoiceSpec = (input) => {
     options.push(option);
   }
   const spec = { options, submit, title };
-  const description = cleanString(input.description, DESCRIPTION_MAX_CHARS);
+  const description = completeString(input.description, CHOICE_DESCRIPTION_MAX_CHARS);
   if (description)
     spec.description = description;
   if (input.multi === true)
@@ -724,12 +687,17 @@ var formCard = {
 };
 var choiceCard = {
   ack: "(choice card rendered inline — the member picks an option, which runs the bound tool with their selection merged in. Do not re-ask in text; wait for the selection)",
-  description: "Render a structured choice card whenever the member must pick between concrete options (which plan, which duplicate record to keep, which time slot) — never ask them to 'reply 1 or 2' in prose. Give every option a stable id; on selection the host merges { choice: id } (or { choices: [ids] } when multi is true) into submit.input and invokes submit.tool exactly like a clicked action button, so put everything you already resolved into submit.input. Max 8 options.",
+  description: "Render a structured choice card whenever the member must pick between concrete options (which plan, which duplicate record to keep, which time slot) — never ask them to 'reply 1 or 2' in prose. Give every option a stable id; on selection the host merges { choice: id } (or { choices: [ids] } when multi is true) into submit.input and invokes submit.tool exactly like a clicked action button, so put everything you already resolved into submit.input. Max 8 options. Use complete, concise labels; put supporting detail in descriptions. Titles and labels allow 600 characters, descriptions 2000. Inputs over these limits are rejected, never truncated.",
   inputSchema: {
     properties: {
-      cardId: CARD_ID_SCHEMA,
+      cardId: {
+        ...CARD_ID_SCHEMA,
+        maxLength: CARD_ID_MAX_CHARS,
+        pattern: CARD_ID_PATTERN.source
+      },
       description: {
-        description: "Optional one-line helper text under the title",
+        description: "Optional helper text under the title",
+        maxLength: CHOICE_DESCRIPTION_MAX_CHARS,
         type: "string"
       },
       multi: {
@@ -742,28 +710,52 @@ var choiceCard = {
           properties: {
             badge: {
               description: 'Tiny annotation beside the label, e.g. "recommended"',
+              maxLength: BADGE_MAX_CHARS,
               type: "string"
             },
             description: {
-              description: "One-line explanation of the option",
+              description: "Supporting explanation of the option",
+              maxLength: CHOICE_DESCRIPTION_MAX_CHARS,
               type: "string"
             },
             id: {
               description: "Stable option id merged into submit.input on selection (letters/digits/_/-)",
+              maxLength: CARD_ID_MAX_CHARS,
+              pattern: CARD_ID_PATTERN.source,
               type: "string"
             },
-            label: { description: "What the member sees", type: "string" }
+            label: {
+              description: "The complete option, without cutting off words",
+              maxLength: CHOICE_LABEL_MAX_CHARS,
+              minLength: 1,
+              type: "string"
+            }
           },
           required: ["id", "label"],
           type: "object"
         },
+        maxItems: CHOICE_MAX_OPTIONS,
+        minItems: 1,
         type: "array"
       },
       submit: {
         ...ACTION_BINDING_SCHEMA,
+        properties: {
+          ...ACTION_BINDING_SCHEMA.properties,
+          label: {
+            ...ACTION_BINDING_SCHEMA.properties.label,
+            maxLength: ACTION_LABEL_MAX_CHARS,
+            minLength: 1
+          }
+        },
         description: "The submit binding: the tool to run once a choice is made. The selection is merged into input as { choice: id } (or { choices: [ids] })"
       },
-      title: { description: "The decision being made", type: "string" }
+      title: {
+        description: "The complete decision being made",
+        maxLength: CHOICE_TITLE_MAX_CHARS,
+        minLength: 1,
+        type: "string"
+      }
     },
     required: ["title", "options", "submit"],
     type: "object"
@@ -999,7 +991,7 @@ var niceTicks = (min, max) => {
   const span = max - min || 1;
   const rough = span / TICK_TARGET;
   const power = Math.pow(10, Math.floor(Math.log10(rough)));
-  const candidates = [1, 2, 5, 10].map((step2) => step2 * power);
+  const candidates = [1, 2, 5, 10].map((step) => step * power);
   const step = candidates.find((candidate) => candidate >= rough) ?? candidates[candidates.length - 1] ?? rough;
   const start = Math.floor(min / step) * step;
   const ticks = [];
@@ -1168,7 +1160,10 @@ export {
   CHART_MAX_POINTS,
   CHART_MAX_SERIES,
   CHART_TYPES,
+  CHOICE_DESCRIPTION_MAX_CHARS,
+  CHOICE_LABEL_MAX_CHARS,
   CHOICE_MAX_OPTIONS,
+  CHOICE_TITLE_MAX_CHARS,
   CONFIRM_CONSEQUENCE_MAX_CHARS,
   CREDENTIAL_MAX_KEYS,
   DARK_UI_THEME,
@@ -1184,6 +1179,7 @@ export {
   TABLE_MAX_COLUMNS,
   TABLE_MAX_ROWS,
   UI_ACTIONS_MAX,
+  UiCardValidationError,
   chartCard,
   choiceCard,
   confirmCard,
@@ -1207,5 +1203,5 @@ export {
   tableCard
 };
 
-//# debugId=85591FD149BAB8A464756E2164756E21
+//# debugId=5FA77A0F06ADA10F64756E2164756E21
 //# sourceMappingURL=index.js.map