@tangle-network/agent-interface 0.17.1 → 0.18.0

package/dist/interaction.d.ts

@@ -49,6 +49,7 @@ export declare const InteractionFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     multi: z.ZodOptional<z.ZodBoolean>;
+    allowCustom: z.ZodOptional<z.ZodBoolean>;
     default: z.ZodOptional<z.ZodArray<z.ZodString>>;
     name: z.ZodString;
     label: z.ZodString;
@@ -92,6 +93,7 @@ export declare const InteractionAnswerSpecSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         multi: z.ZodOptional<z.ZodBoolean>;
+        allowCustom: z.ZodOptional<z.ZodBoolean>;
         default: z.ZodOptional<z.ZodArray<z.ZodString>>;
         name: z.ZodString;
         label: z.ZodString;
@@ -190,6 +192,7 @@ export declare const InteractionRequestSchema: z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             multi: z.ZodOptional<z.ZodBoolean>;
+            allowCustom: z.ZodOptional<z.ZodBoolean>;
             default: z.ZodOptional<z.ZodArray<z.ZodString>>;
             name: z.ZodString;
             label: z.ZodString;
@@ -261,6 +264,8 @@ export type LegacyQuestion = {
         description?: string;
     }>;
     multiSelect?: boolean;
+    /** When true the select field accepts write-in answers beyond `options`. */
+    allowCustom?: boolean;
 };
 /**
  * Build an answer spec from the legacy `question` event shape. Each question

package/dist/interaction.js

@@ -62,6 +62,12 @@ export const InteractionFieldSchema = z.discriminatedUnion("type", [
             .min(1),
         /** When true the user may pick more than one option. */
         multi: z.boolean().optional(),
+        /**
+         * When true the answer may contain write-in values outside `options`
+         * (e.g. a rendered "Other…" choice carrying the user's own text).
+         * Write-ins must still be non-empty strings.
+         */
+        allowCustom: z.boolean().optional(),
         default: z.array(z.string()).optional(),
     }),
     /** Like `text` but the value is sensitive (token/key) and must be masked. */
@@ -185,6 +191,7 @@ export function questionAnswerSpec(questions) {
                 label: q.question,
                 required: true,
                 multi: q.multiSelect === true,
+                ...(q.allowCustom === true ? { allowCustom: true } : {}),
                 options: q.options.map((o) => ({ value: o.label, label: o.label, description: o.description })),
             };
         }
@@ -239,8 +246,16 @@ export function validateInteractionAnswer(spec, data) {
                     errors.push(`field "${field.name}" requires a selection`);
                 const allowed = new Set(field.options.map((o) => o.value));
                 for (const choice of v) {
-                    if (!allowed.has(choice))
-                        errors.push(`field "${field.name}" has invalid option "${choice}"`);
+                    if (allowed.has(choice))
+                        continue;
+                    if (field.allowCustom === true) {
+                        // Write-ins are open but stay fail-closed on shape: string, non-blank.
+                        if (typeof choice !== "string" || choice.trim() === "") {
+                            errors.push(`field "${field.name}" has blank write-in value`);
+                        }
+                        continue;
+                    }
+                    errors.push(`field "${field.name}" has invalid option "${choice}"`);
                 }
                 break;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",