@compilr-dev/sdk 0.10.15 → 0.10.17

package/dist/tools/interactive-flow-tool.js

@@ -283,6 +283,20 @@ function validateQuestion(node, allNodes, errors) {
                         nodeId: node.id,
                     });
                 }
+                // Proposal options exist to compare tradeoffs — they MUST have at
+                // least one pro or one con. An option with neither is a sign the
+                // agent should have used single mode with `choices[].description`
+                // (a label + explanation) rather than proposal mode (which is for
+                // comparing tradeoffs).
+                const hasPros = Array.isArray(opt.pros) && opt.pros.length > 0;
+                const hasCons = Array.isArray(opt.cons) && opt.cons.length > 0;
+                if (!hasPros && !hasCons) {
+                    errors.push({
+                        code: 'INVALID_NODE_TYPE',
+                        message: `Question '${node.id}' option at index ${String(i)} ('${typeof opt.label === 'string' ? opt.label : opt.id}') has no pros or cons. Proposal mode is for comparing tradeoffs — every option needs at least one pro OR one con. If your options are just label + description (no tradeoffs to compare), use single mode with choices[].description instead.`,
+                        nodeId: node.id,
+                    });
+                }
                 if (opt.icon !== undefined)
                     checkIcon(opt.icon, node.id, errors);
             }
@@ -651,9 +665,15 @@ export function createInteractiveFlowTool(handler) {
             '     "next": "<nodeId>"   // OR { "byAnswer": { "yes": "<id>", "no": "<id>" }, "default": "<id>" }\n' +
             '   }\n' +
             '   input.mode can be: single | multi | text | proposal\n' +
-            '   - single/multi: choices[] required, each with id + label\n' +
-            '   - proposal: options[] with id + label + optional pros[] + cons[]\n' +
-            '   - text: placeholder + multiline optional\n\n' +
+            '   - single: choices[] (id + label, optional description + icon).\n' +
+            '       PICK THIS for "pick one from a list" — even when each option has\n' +
+            '       a description. Descriptions belong on choices, not in proposal.\n' +
+            '   - multi: choices[] (same shape as single), optional min/max.\n' +
+            '   - proposal: options[] (id + label + pros[] + cons[]).\n' +
+            '       PICK THIS ONLY when each option has tradeoffs to compare\n' +
+            '       (at least one pro OR one con per option). If your options\n' +
+            '       are just label + description (no tradeoffs), use single mode.\n' +
+            '   - text: placeholder + multiline optional.\n\n' +
             '2. INFO (show, no input):\n' +
             '   { "type": "info", "id": "<id>", "title": "<header>", "body": "<markdown>", "next": "<nodeId>" }\n\n' +
             '3. BRANCH (pure routing, no UI):\n' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.15",
+  "version": "0.10.17",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -56,7 +56,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@compilr-dev/agents": "^0.5.8",
+    "@compilr-dev/agents": "^0.5.9",
     "@compilr-dev/logger": "^0.1.0",
     "@compilr-dev/sdk": "^0.10.2",
     "ajv": "^6.14.0",