@llui/agent 0.0.42 → 0.0.43

package/dist/client/rpc/list-actions.js

@@ -210,6 +210,18 @@ function compileRouteGate(src) {
     routeGateCache.set(src, fn);
     return fn;
 }
+/**
+ * Sentinel returned by `synthesizeBare` for fields whose schema is
+ * `'unknown'` — the synthesizer can't make up a value, so it tells
+ * callers to omit the field from the synthesized example. Emitting
+ * `null` (the previous behavior) bit us in production: agents
+ * copied the literal `null`, the validator let it through (it
+ * exempts unknowns), and the consumer code crashed on `null.kind` /
+ * `null.length` etc. Symbol values are dropped silently by
+ * `JSON.stringify`, so even a missed filter site can't leak this
+ * to the wire.
+ */
+const OMIT = Symbol('synthesize.omit');
 function synthesizePayload(variant, fields) {
     const out = { type: variant };
     for (const [name, descriptor] of Object.entries(fields)) {
@@ -219,7 +231,10 @@ function synthesizePayload(variant, fields) {
         // fields always appear.
         if (optional && priority !== 'should')
             continue;
-        out[name] = exampleValue(descriptor);
+        const value = exampleValue(descriptor);
+        if (value === OMIT)
+            continue;
+        out[name] = value;
     }
     return out;
 }
@@ -320,16 +335,16 @@ function synthesizeBare(t) {
             return 0;
         if (t === 'boolean')
             return false;
-        return null; // 'unknown' or unrecognized keyword → placeholder
+        return OMIT; // 'unknown' or unrecognized — caller drops the field
     }
     if (t === null || typeof t !== 'object')
-        return null;
+        return OMIT;
     const obj = t;
     if ('enum' in obj && Array.isArray(obj.enum)) {
         // First option doubles as the canonical example. Native value type
         // round-trips (string/number/boolean) since the compiler preserved
         // the literal kind on emit.
-        return obj.enum[0] ?? null;
+        return obj.enum[0] ?? OMIT;
     }
     if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {
         // Recurse into the nested shape. Same optional-skip rule as the
@@ -341,14 +356,22 @@ function synthesizeBare(t) {
             const pri = isShould(descriptor);
             if (isOpt && pri !== 'should')
                 continue;
-            out[name] = exampleValue(descriptor);
+            const value = exampleValue(descriptor);
+            if (value === OMIT)
+                continue;
+            out[name] = value;
         }
         return out;
     }
     if (obj.kind === 'array') {
         // Wrap the synthesized element in a one-item array. Lets the LLM
         // see the per-entry shape without us guessing at array length.
-        return [synthesizeBare(obj.element)];
+        // If the element schema is 'unknown', return an empty array
+        // rather than `[null]` — the empty array signals "this is an
+        // array, shape unknown" without putting a misleading literal in
+        // the example.
+        const elementValue = synthesizeBare(obj.element);
+        return elementValue === OMIT ? [] : [elementValue];
     }
     if (obj.kind === 'discriminated-union') {
         // Synthesize the FIRST branch as the concrete example. The full
@@ -362,7 +385,7 @@ function synthesizeBare(t) {
         const discriminant = String(obj.discriminant);
         const firstEntry = Object.entries(variants).at(0);
         if (!firstEntry)
-            return null;
+            return OMIT;
         const [firstValue, firstFields] = firstEntry;
         const branch = { [discriminant]: firstValue };
         for (const [name, descriptor] of Object.entries(firstFields)) {
@@ -370,10 +393,13 @@ function synthesizeBare(t) {
             const pri = isShould(descriptor);
             if (isOpt && pri !== 'should')
                 continue;
-            branch[name] = exampleValue(descriptor);
+            const value = exampleValue(descriptor);
+            if (value === OMIT)
+                continue;
+            branch[name] = value;
         }
         return branch;
     }
-    return null;
+    return OMIT;
 }
 //# sourceMappingURL=list-actions.js.map

package/dist/client/rpc/list-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-actions.js","sourceRoot":"","sources":["../../../src/client/rpc/list-actions.ts"],"names":[],"mappings":"AAuFA,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAA;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAA;IACtD,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAA;IAChD,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7D,mEAAmE;IACnE,oEAAoE;IACpE,qEAAqE;IACrE,+DAA+D;IAC/D,4DAA4D;IAC5D,kEAAkE;IAClE,6DAA6D;IAC7D,gEAAgE;IAChE,yDAAyD;IACzD,aAAa;IACb,MAAM,mBAAmB,GAAG,aAAa,KAAK,IAAI,CAAA;IAClD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;IAElC,MAAM,GAAG,GAAiC,EAAE,CAAA;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAE9B,sEAAsE;IACtE,oEAAoE;IACpE,oEAAoE;IACpE,2BAA2B;IAC3B,EAAE;IACF,oEAAoE;IACpE,iEAAiE;IACjE,gEAAgE;IAChE,oEAAoE;IACpE,kEAAkE;IAClE,qEAAqE;IACrE,mEAAmE;IACnE,mEAAmE;IACnE,mDAAmD;IACnD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC;YAAE,SAAQ;QACvD,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,GAAG,EAAE,YAAY,KAAK,YAAY;YAAE,SAAQ;QAChD,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC;YAAE,SAAQ;QAC1C,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACnB,MAAM,aAAa,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACjD,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;YAC3B,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,KAAK;YAC9C,YAAY,EAAE,GAAG,EAAE,YAAY,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;YAC1E,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,IAAI;YAC7B,QAAQ,EAAE,GAAG,EAAE,QAAQ,IAAI,EAAE;YAC7B,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACvB,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;SAClE,CAAC,CAAA;IACJ,CAAC;IAED,qEAAqE;IACrE,gEAAgE;IAChE,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,GAAG,EAAE,YAAY,KAAK,YAAY;YAAE,SAAQ;QAChD,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC;YAAE,SAAQ;QAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAA;QAC7B,MAAM,aAAa,GAAG,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC5C,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;YAC3B,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,KAAK;YAC9C,YAAY,EAAE,GAAG,EAAE,YAAY,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;YAC1E,MAAM,EAAE,mBAAmB;YAC3B,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YACvD,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,IAAI;YAC7B,QAAQ,EAAE,GAAG,EAAE,QAAQ,IAAI,EAAE;YAC7B,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;YACvB,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;SAClE,CAAC,CAAA;IACJ,CAAC;IAED,oEAAoE;IACpE,qEAAqE;IACrE,2DAA2D;IAC3D,gEAAgE;IAChE,qEAAqE;IACrE,oEAAoE;IACpE,kEAAkE;IAClE,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAQ;QAC/B,IAAI,GAAG,CAAC,YAAY,KAAK,YAAY;YAAE,SAAQ;QAC/C,IAAI,CAAC,GAAG,CAAC,gBAAgB;YAAE,SAAQ;QACnC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC;YAAE,SAAQ;QAC1C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjB,MAAM,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;QACxC,GAAG,CAAC,IAAI,CAAC;YACP,OAAO;YACP,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,YAAY,EAAE,GAAG,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;YACzE,MAAM,EAAE,mBAAmB;YAC3B,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;YAC/D,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;SACpD,CAAC,CAAA;IACJ,CAAC;IAED,qEAAqE;IACrE,mEAAmE;IACnE,mEAAmE;IACnE,gEAAgE;IAChE,EAAE;IACF,qEAAqE;IACrE,kEAAkE;IAClE,qEAAqE;IACrE,sEAAsE;IACtE,gDAAgD;IAChD,EAAE;IACF,mEAAmE;IACnE,iEAAiE;IACjE,mEAAmE;IACnE,6DAA6D;IAC7D,yDAAyD;IACzD,kEAAkE;IAClE,sBAAsB;IACtB,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAQ;YAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;YAChC,IAAI,GAAG,EAAE,YAAY,KAAK,YAAY;gBAAE,SAAQ;YAChD,IAAI,mBAAmB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAQ;YACrE,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC;gBAAE,SAAQ;YAC1C,GAAG,CAAC,IAAI,CAAC;gBACP,OAAO;gBACP,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,eAAe,EAAE,GAAG,CAAC,eAAe;gBACpC,YAAY,EAAE,YAAY;gBAC1B,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC;gBAC/C,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,UAAU,EAAE,iBAAiB,CAAC,MAAM,CAAC;aACtC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAA;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH;;;;;;;;;;;;;GAaG;AACH,SAAS,eAAe,CAAC,GAAmC,EAAE,KAAc;IAC1E,MAAM,GAAG,GAAG,GAAG,EAAE,SAAS,CAAA;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IACvC,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuC,CAAA;AACrE,SAAS,gBAAgB,CAAC,GAAW;IACnC,IAAI,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAA;IACjB,IAAI,CAAC;QACH,EAAE,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,GAAG,CAAgC,CAAA;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA;IACjB,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC3B,OAAO,EAAE,CAAA;AACX,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe,EAAE,MAAsC;IAChF,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACtD,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;QACrC,gEAAgE;QAChE,wBAAwB;QACxB,IAAI,QAAQ,IAAI,QAAQ,KAAK,QAAQ;YAAE,SAAQ;QAC/C,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACtC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,iBAAiB,CACxB,MAAsC;IAEtC,MAAM,GAAG,GAA0C,EAAE,CAAA;IACrD,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,QAAQ,CACf,IAAY,EACZ,CAAiB,EACjB,GAA0C;IAE1C,gDAAgD;IAChD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAClC,CAAC;QACD,iEAAiE;QACjE,kEAAkE;QAClE,iEAAiE;QACjE,8DAA8D;QAC9D,+DAA+D;QAC/D,kBAAkB;QAClB,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QACvD,CAAC;QACD,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC/B,OAAM;IACR,CAAC;IACD,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,CAAU,EAAE,GAA0C;IACxF,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAM;IAC/C,MAAM,GAAG,GAAG,CAA4B,CAAA;IACxC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjF,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAuC,CAAC,EAAE,CAAC;YAC7F,QAAQ,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,CAAA;QAC9C,CAAC;QACD,OAAM;IACR,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,IAAI,IAAI,EAAE,GAAG,CAAC,OAAyB,EAAE,GAAG,CAAC,CAAA;IAC3D,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACvC,2DAA2D;QAC3D,kEAAkE;QAClE,gEAAgE;QAChE,6DAA6D;QAC7D,kDAAkD;QAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAA0D,CAAA;QAC/E,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI;gBACJ,IAAI,EAAE,+BAA+B,YAAY,iBAAiB,WAAW;qBAC1E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;qBACpB,IAAI,CAAC,IAAI,CAAC,GAAG;aACjB,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,QAAQ,CAAC,GAAG,IAAI,IAAI,YAAY,IAAI,SAAS,KAAK,SAAS,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,CAAA;YAChF,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,CAAiB;IACnC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAA;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,CAAiB;IACjC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,CAAiB;IACrC,6DAA6D;IAC7D,MAAM,CAAC,GACL,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC;QAClC,CAAC,CAAC,CAAC,CAAC,IAAI;QACR,CAAC,CAAE,CAE+D,CAAA;IACtE,OAAO,cAAc,CAAC,CAAU,CAAC,CAAA;AACnC,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAA;QAC7B,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAA;QAC5B,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;QACjC,OAAO,IAAI,CAAA,CAAC,kDAAkD;IAChE,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACpD,MAAM,GAAG,GAAG,CAA4B,CAAA;IACxC,IAAI,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,mEAAmE;QACnE,mEAAmE;QACnE,4BAA4B;QAC5B,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC5B,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjF,gEAAgE;QAChE,+DAA+D;QAC/D,oCAAoC;QACpC,MAAM,GAAG,GAA4B,EAAE,CAAA;QACvC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAuC,CAAC,EAAE,CAAC;YAC7F,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;YACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;YAChC,IAAI,KAAK,IAAI,GAAG,KAAK,QAAQ;gBAAE,SAAQ;YACvC,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;QACtC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACzB,iEAAiE;QACjE,+DAA+D;QAC/D,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IACtC,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACvC,gEAAgE;QAChE,2DAA2D;QAC3D,iEAAiE;QACjE,6DAA6D;QAC7D,gEAAgE;QAChE,6DAA6D;QAC7D,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,GAAG,CAAC,QAA0D,CAAA;QAC/E,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACjD,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAA;QAC5B,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,UAAU,CAAA;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAA;QACtE,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;YACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;YAChC,IAAI,KAAK,IAAI,GAAG,KAAK,QAAQ;gBAAE,SAAQ;YACvC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;QACzC,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["import type { MessageAnnotations } from '../../protocol.js'\nimport type { MsgSchemaShape, MsgSchemaField } from '../factory.js'\n\ntype Binding = { variant: string }\ntype Annotations = Record<string, MessageAnnotations>\n\nexport type ListActionsHost = {\n  getState(): unknown\n  getBindingDescriptors(): Binding[] | null\n  getMsgAnnotations(): Annotations | null\n  getMsgSchema(): MsgSchemaShape | null\n  getAgentAffordances(): ((state: unknown) => Array<{ type: string; [k: string]: unknown }>) | null\n}\n\n/**\n * `dispatchMode` on each action is `'shared'` (human can also click via\n * a UI affordance) or `'agent-only'` (no UI binding — agent is the only\n * dispatcher). `'human-only'` variants are filtered out before this\n * point — they never reach the LLM.\n *\n * `source` distinguishes WHERE the affordance came from:\n *   - `'binding'` — a tagged event handler is currently mounted in a\n *     live scope (refcount > 0). Variants inside dead branches —\n *     `show({when: false})`, unmounted `branch()` cases, removed `each`\n *     items — auto-vanish from this set as their lifetimes dispose.\n *     This is the framework's \"what can the user click right now\"\n *     answer, and it's the default surface for the agent.\n *   - `'always-affordable'` — either the app's `agentAffordances(state)`\n *     hook listed the variant, or the variant carries the\n *     `@alwaysAffordable` JSDoc tag. Both are the explicit \"agent can\n *     reach this even when no live UI binding maps to it\" knob — bulk\n *     seed ops (`Matrix/AddAlternatives`) and similar agent-driven\n *     paths typically land here.\n *   - `'schema'` — variant is annotated `@agentOnly` (the canonical\n *     \"no UI button maps to this; the agent is the only dispatcher\")\n *     and isn't already covered above. The payload is schema-synthesized\n *     and the agent fills it in.\n *\n * `'shared'` variants WITHOUT a live binding, without\n * `agentAffordances` mention, and without `@alwaysAffordable` are\n * **deliberately hidden**. They're reachable through UI navigation —\n * the human user can't click them right now, and dispatching them\n * blindly would mutate state that drives `show()`/`branch()` gates,\n * popping hidden UI subtrees into view in places the user didn't\n * navigate to.\n */\nexport type ListActionsResult = {\n  actions: Array<{\n    variant: string\n    /**\n     * Human-readable phrase from `@intent(\"…\")`, or `null` when the\n     * variant is unannotated. Mirror of LapActionsResponse.intent —\n     * callers should treat `null` as a documentation gap and not as\n     * \"missing label, fall back to variant name\".\n     */\n    intent: string | null\n    requiresConfirm: boolean\n    dispatchMode: 'shared' | 'agent-only'\n    source: 'binding' | 'always-affordable' | 'schema'\n    selectorHint: string | null\n    payloadHint: object | null\n    /** Cautionary text from `@warning` JSDoc, or null. */\n    warning: string | null\n    /** Concrete examples from `@example` JSDoc, in source order. */\n    examples: string[]\n    /**\n     * Effect kinds this variant emits, from `@emits(\"k1\", \"k2\")`.\n     * Empty when not annotated. Lets the agent know what side\n     * effects fire — useful for batching (\"100 dispatches × cloud-\n     * save = bad\") and for confirming destructive flows.\n     */\n    emits: string[]\n    /**\n     * Per-field guidance lifted from `@should(\"…\")` JSDoc on payload\n     * fields. Path is dot/bracket notation rooted at the payload\n     * (e.g. `\"cells\"` for a top-level field, `\"cells[].meta\"` for an\n     * array element's nested field). Useful when the field is typed\n     * as `unknown` or as a polymorphic shape — the hint says \"type\n     * matches the criterion's kind: number for quantity, …\" so the\n     * agent doesn't have to guess from the bare schema.\n     *\n     * Empty when no field on this variant carries an `@should` hint.\n     */\n    fieldHints: Array<{ path: string; hint: string }>\n  }>\n}\n\nexport function handleListActions(host: ListActionsHost): ListActionsResult {\n  const annotations = host.getMsgAnnotations() ?? {}\n  const state = host.getState()\n  const descriptors = host.getBindingDescriptors() ?? []\n  const affordancesFn = host.getAgentAffordances()\n  const affordances = affordancesFn ? affordancesFn(state) : []\n  // When the app provides `agentAffordances(state)`, it's opted into\n  // explicit affordance control: only state-relevant Msgs are listed.\n  // `@agentOnly` schema-source variants are then filtered to those the\n  // hook returned — so a bulk-edit Msg like `Matrix/AddCriteria`\n  // doesn't surface on the home page just because it's tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default (\"everything's available unless you say\n  // otherwise\") since flipping that without explicit opt-in would\n  // break consumers who rely on schema-source surfacing of\n  // bulk Msgs.\n  const explicitAffordances = affordancesFn !== null\n  const affordanceVariants = new Set(affordances.map((m) => m.type))\n  const schema = host.getMsgSchema()\n\n  const out: ListActionsResult['actions'] = []\n  const seen = new Set<string>()\n\n  // From bindings — these have UI affordances by definition, so they're\n  // either 'shared' (default) or, in the malformed case where someone\n  // bound an `@agentOnly` Msg in a view, 'agent-only'. Either way the\n  // agent can dispatch them.\n  //\n  // Filtered against the Msg schema: a binding whose variant isn't in\n  // the user's Msg union is a library-internal Msg leaking through\n  // `tagSend` translator wiring (the sortable component's `move`,\n  // `drop`, `cancel`, etc. — they're routed into the user's update.ts\n  // via a different shape but their lib names slip into the binding\n  // registry). The agent has no use for those names — `would_dispatch`\n  // / `send_message` would reject them as `unknown-variant` anyway —\n  // so they pollute the affordance list. When a schema is available,\n  // the schema's variant set is the source of truth.\n  for (const d of descriptors) {\n    if (schema && !(d.variant in schema.variants)) continue\n    const ann = annotations[d.variant]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(d.variant)\n    const variantSchema = schema?.variants[d.variant]\n    out.push({\n      variant: d.variant,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'binding',\n      selectorHint: null,\n      payloadHint: null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `agentAffordances(state)` — the integrator's explicit list of\n  // currently-reachable Msgs, with concrete payloads they author.\n  for (const msg of affordances) {\n    const ann = annotations[msg.type]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(msg.type)\n    const { type, ...rest } = msg\n    const variantSchema = schema?.variants[type]\n    out.push({\n      variant: type,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: Object.keys(rest).length > 0 ? rest : null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `@alwaysAffordable` annotations — the per-variant equivalent\n  // of `agentAffordances`. Variants tagged this way surface regardless\n  // of whether a live binding maps to them, so bulk seed ops\n  // (`Matrix/AddAlternatives`) and similar agent-driven paths are\n  // available even when their UI counterparts (if any) aren't mounted.\n  // The payload is schema-synthesized — `agentAffordances` is the way\n  // to ship a concrete pre-filled payload alongside the affordance.\n  for (const [variant, ann] of Object.entries(annotations)) {\n    if (seen.has(variant)) continue\n    if (ann.dispatchMode === 'human-only') continue\n    if (!ann.alwaysAffordable) continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(variant)\n    const fields = schema?.variants[variant]\n    out.push({\n      variant,\n      intent: ann.intent,\n      requiresConfirm: ann.requiresConfirm,\n      dispatchMode: ann.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: fields ? synthesizePayload(variant, fields) : null,\n      warning: ann.warning,\n      examples: ann.examples,\n      emits: ann.emits,\n      fieldHints: fields ? collectFieldHints(fields) : [],\n    })\n  }\n\n  // From schema — variants that aren't already surfaced above and that\n  // the author marked `@agentOnly`. The canonical \"no UI button maps\n  // to this; the agent is the only dispatcher.\" Bulk edits, imports,\n  // admin operations that have no human-facing affordance at all.\n  //\n  // `'shared'` variants WITHOUT a live binding stay hidden here — they\n  // are reachable through UI navigation, and dispatching them while\n  // their UI subtree is unmounted would pop hidden state in places the\n  // user didn't navigate to. The explicit knobs are `@alwaysAffordable`\n  // (handled above) or `agentAffordances(state)`.\n  //\n  // When the app provides `agentAffordances`, this pass is filtered:\n  // an `@agentOnly` variant only surfaces if the hook returned it.\n  // That makes route-gated bulk Msgs (`Matrix/AddCriteria` available\n  // only when a matrix is loaded) work as expected — they stop\n  // appearing on the home page just because they're tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default.\n  if (schema) {\n    for (const [variant, fields] of Object.entries(schema.variants)) {\n      if (seen.has(variant)) continue\n      const ann = annotations[variant]\n      if (ann?.dispatchMode !== 'agent-only') continue\n      if (explicitAffordances && !affordanceVariants.has(variant)) continue\n      if (!passesRouteGate(ann, state)) continue\n      out.push({\n        variant,\n        intent: ann.intent,\n        requiresConfirm: ann.requiresConfirm,\n        dispatchMode: 'agent-only',\n        source: 'schema',\n        selectorHint: null,\n        payloadHint: synthesizePayload(variant, fields),\n        warning: ann.warning,\n        examples: ann.examples,\n        emits: ann.emits,\n        fieldHints: collectFieldHints(fields),\n      })\n    }\n  }\n\n  return { actions: out }\n}\n\n/**\n * Build an example payload object the LLM can fill in. Required\n * fields always appear; optional fields appear only when annotated\n * `@should` (LLM is encouraged to fill them in). Fields without a\n * concrete primitive type (`'unknown'`) emit `null` placeholders the\n * LLM is expected to replace.\n *\n * The first key is `type` so the payload reads as a complete Msg\n * shape — copy-paste-ready into `send_message`.\n */\n/**\n * Evaluate `@routeGated(\"predicate\")` against the current state.\n * Returns true (variant passes) when:\n *   - the variant has no `@routeGated` annotation, OR\n *   - the predicate evaluates truthy with `state` bound.\n *\n * Predicate is compiled lazily via `new Function('state', 'return (' +\n * src + ')')` and cached in a module-level Map. Compile failures\n * (syntactically broken predicates) degrade to \"true\" so a single\n * malformed annotation doesn't paralyze the affordance pass — the\n * build-time linter is the right place to catch syntactic issues.\n * Evaluation throws fail-closed (return false) since a predicate that\n * crashes on the current state shouldn't surface the variant.\n */\nfunction passesRouteGate(ann: MessageAnnotations | undefined, state: unknown): boolean {\n  const src = ann?.routeGate\n  if (!src) return true\n  const predicate = compileRouteGate(src)\n  try {\n    return Boolean(predicate(state))\n  } catch {\n    return false\n  }\n}\n\nconst routeGateCache = new Map<string, (state: unknown) => boolean>()\nfunction compileRouteGate(src: string): (state: unknown) => boolean {\n  let fn = routeGateCache.get(src)\n  if (fn) return fn\n  try {\n    fn = new Function('state', `return (${src})`) as (state: unknown) => boolean\n  } catch {\n    fn = () => true\n  }\n  routeGateCache.set(src, fn)\n  return fn\n}\n\nfunction synthesizePayload(variant: string, fields: Record<string, MsgSchemaField>): object {\n  const out: Record<string, unknown> = { type: variant }\n  for (const [name, descriptor] of Object.entries(fields)) {\n    const optional = isOptional(descriptor)\n    const priority = isShould(descriptor)\n    // Skip optional fields unless they're @should-flagged. Required\n    // fields always appear.\n    if (optional && priority !== 'should') continue\n    out[name] = exampleValue(descriptor)\n  }\n  return out\n}\n\n/**\n * Walk a variant's field tree and collect every `@should` hint into a\n * flat list keyed by field path. Path conventions:\n *   - top-level field: `\"cells\"`\n *   - nested object property: `\"cells.value\"`\n *   - array element: `\"cells[]\"` for the element itself; descendants\n *     use `\"cells[].meta\"` and so on.\n *\n * Surfaces the same hints that show up nested inside\n * `description.messages.variants[X].field.hint` so callers don't have\n * to dig through the schema tree to find them.\n */\nfunction collectFieldHints(\n  fields: Record<string, MsgSchemaField>,\n): Array<{ path: string; hint: string }> {\n  const out: Array<{ path: string; hint: string }> = []\n  for (const [name, descriptor] of Object.entries(fields)) {\n    walkHint(name, descriptor, out)\n  }\n  return out\n}\n\nfunction walkHint(\n  path: string,\n  d: MsgSchemaField,\n  out: Array<{ path: string; hint: string }>,\n): void {\n  // Rich descriptor with a hint at this position.\n  if (typeof d === 'object' && d !== null && 'type' in d) {\n    if (typeof d.hint === 'string' && d.hint.length > 0) {\n      out.push({ path, hint: d.hint })\n    }\n    // `@validates(...)` predicates surface alongside `@should` hints\n    // so the agent sees the constraint at affordance time rather than\n    // only as a post-dispatch rejection. The verbatim predicate text\n    // is what the runtime evaluates; agents trained on JS read it\n    // directly. Prefix `validates: ` to disambiguate from freeform\n    // `@should` text.\n    if (typeof d.validates === 'string' && d.validates.length > 0) {\n      out.push({ path, hint: `validates: ${d.validates}` })\n    }\n    walkHintBare(path, d.type, out)\n    return\n  }\n  walkHintBare(path, d, out)\n}\n\nfunction walkHintBare(path: string, t: unknown, out: Array<{ path: string; hint: string }>): void {\n  if (t === null || typeof t !== 'object') return\n  const obj = t as Record<string, unknown>\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      walkHint(`${path}.${name}`, descriptor, out)\n    }\n    return\n  }\n  if (obj.kind === 'array') {\n    walkHint(`${path}[]`, obj.element as MsgSchemaField, out)\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthetic hint at the union's path summarizing the legal\n    // discriminant values. Lets the agent see \"format expects one of:\n    // exact, range, compound\" without walking the full schema. Then\n    // walk each branch's per-field hints with a path-suffix that\n    // disambiguates which branch the hint applies to.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const legalValues = Object.keys(variants)\n    if (legalValues.length > 0) {\n      out.push({\n        path,\n        hint: `Discriminated union — set \\`${discriminant}\\` to one of: ${legalValues\n          .map((v) => `'${v}'`)\n          .join(', ')}.`,\n      })\n    }\n    for (const [discValue, fields] of Object.entries(variants)) {\n      for (const [fieldName, fieldDesc] of Object.entries(fields)) {\n        walkHint(`${path}(${discriminant}=${discValue}).${fieldName}`, fieldDesc, out)\n      }\n    }\n  }\n}\n\nfunction isOptional(d: MsgSchemaField): boolean {\n  return typeof d === 'object' && 'type' in d && d.optional === true\n}\n\nfunction isShould(d: MsgSchemaField): 'should' | undefined {\n  return typeof d === 'object' && 'type' in d ? d.priority : undefined\n}\n\nfunction exampleValue(d: MsgSchemaField): unknown {\n  // Unwrap rich descriptor to get the bare type for synthesis.\n  const t =\n    typeof d === 'object' && 'type' in d\n      ? d.type\n      : (d as\n          | Exclude<MsgSchemaField, object>\n          | Extract<MsgSchemaField, { kind?: string; enum?: string[] }>)\n  return synthesizeBare(t as never)\n}\n\nfunction synthesizeBare(t: unknown): unknown {\n  if (typeof t === 'string') {\n    if (t === 'string') return ''\n    if (t === 'number') return 0\n    if (t === 'boolean') return false\n    return null // 'unknown' or unrecognized keyword → placeholder\n  }\n  if (t === null || typeof t !== 'object') return null\n  const obj = t as Record<string, unknown>\n  if ('enum' in obj && Array.isArray(obj.enum)) {\n    // First option doubles as the canonical example. Native value type\n    // round-trips (string/number/boolean) since the compiler preserved\n    // the literal kind on emit.\n    return obj.enum[0] ?? null\n  }\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    // Recurse into the nested shape. Same optional-skip rule as the\n    // top-level synthesizer: required fields appear, optional ones\n    // appear only when @should-flagged.\n    const out: Record<string, unknown> = {}\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      out[name] = exampleValue(descriptor)\n    }\n    return out\n  }\n  if (obj.kind === 'array') {\n    // Wrap the synthesized element in a one-item array. Lets the LLM\n    // see the per-entry shape without us guessing at array length.\n    return [synthesizeBare(obj.element)]\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthesize the FIRST branch as the concrete example. The full\n    // shape (every legal branch + its payload) is preserved in\n    // `description.messages.variants[X]` from `describe_app`, so the\n    // agent that needs another branch reads the schema directly.\n    // `collectFieldHints` adds a synthetic enumeration of the legal\n    // `<discriminant>` values onto the hint surface so the agent\n    // doesn't have to dig into the schema for the simple case.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const firstEntry = Object.entries(variants).at(0)\n    if (!firstEntry) return null\n    const [firstValue, firstFields] = firstEntry\n    const branch: Record<string, unknown> = { [discriminant]: firstValue }\n    for (const [name, descriptor] of Object.entries(firstFields)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      branch[name] = exampleValue(descriptor)\n    }\n    return branch\n  }\n  return null\n}\n"]}
+{"version":3,"file":"list-actions.js","sourceRoot":"","sources":["../../../src/client/rpc/list-actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MessageAnnotations } from '../../protocol.js'\nimport type { MsgSchemaShape, MsgSchemaField } from '../factory.js'\n\ntype Binding = { variant: string }\ntype Annotations = Record<string, MessageAnnotations>\n\nexport type ListActionsHost = {\n  getState(): unknown\n  getBindingDescriptors(): Binding[] | null\n  getMsgAnnotations(): Annotations | null\n  getMsgSchema(): MsgSchemaShape | null\n  getAgentAffordances(): ((state: unknown) => Array<{ type: string; [k: string]: unknown }>) | null\n}\n\n/**\n * `dispatchMode` on each action is `'shared'` (human can also click via\n * a UI affordance) or `'agent-only'` (no UI binding — agent is the only\n * dispatcher). `'human-only'` variants are filtered out before this\n * point — they never reach the LLM.\n *\n * `source` distinguishes WHERE the affordance came from:\n *   - `'binding'` — a tagged event handler is currently mounted in a\n *     live scope (refcount > 0). Variants inside dead branches —\n *     `show({when: false})`, unmounted `branch()` cases, removed `each`\n *     items — auto-vanish from this set as their lifetimes dispose.\n *     This is the framework's \"what can the user click right now\"\n *     answer, and it's the default surface for the agent.\n *   - `'always-affordable'` — either the app's `agentAffordances(state)`\n *     hook listed the variant, or the variant carries the\n *     `@alwaysAffordable` JSDoc tag. Both are the explicit \"agent can\n *     reach this even when no live UI binding maps to it\" knob — bulk\n *     seed ops (`Matrix/AddAlternatives`) and similar agent-driven\n *     paths typically land here.\n *   - `'schema'` — variant is annotated `@agentOnly` (the canonical\n *     \"no UI button maps to this; the agent is the only dispatcher\")\n *     and isn't already covered above. The payload is schema-synthesized\n *     and the agent fills it in.\n *\n * `'shared'` variants WITHOUT a live binding, without\n * `agentAffordances` mention, and without `@alwaysAffordable` are\n * **deliberately hidden**. They're reachable through UI navigation —\n * the human user can't click them right now, and dispatching them\n * blindly would mutate state that drives `show()`/`branch()` gates,\n * popping hidden UI subtrees into view in places the user didn't\n * navigate to.\n */\nexport type ListActionsResult = {\n  actions: Array<{\n    variant: string\n    /**\n     * Human-readable phrase from `@intent(\"…\")`, or `null` when the\n     * variant is unannotated. Mirror of LapActionsResponse.intent —\n     * callers should treat `null` as a documentation gap and not as\n     * \"missing label, fall back to variant name\".\n     */\n    intent: string | null\n    requiresConfirm: boolean\n    dispatchMode: 'shared' | 'agent-only'\n    source: 'binding' | 'always-affordable' | 'schema'\n    selectorHint: string | null\n    payloadHint: object | null\n    /** Cautionary text from `@warning` JSDoc, or null. */\n    warning: string | null\n    /** Concrete examples from `@example` JSDoc, in source order. */\n    examples: string[]\n    /**\n     * Effect kinds this variant emits, from `@emits(\"k1\", \"k2\")`.\n     * Empty when not annotated. Lets the agent know what side\n     * effects fire — useful for batching (\"100 dispatches × cloud-\n     * save = bad\") and for confirming destructive flows.\n     */\n    emits: string[]\n    /**\n     * Per-field guidance lifted from `@should(\"…\")` JSDoc on payload\n     * fields. Path is dot/bracket notation rooted at the payload\n     * (e.g. `\"cells\"` for a top-level field, `\"cells[].meta\"` for an\n     * array element's nested field). Useful when the field is typed\n     * as `unknown` or as a polymorphic shape — the hint says \"type\n     * matches the criterion's kind: number for quantity, …\" so the\n     * agent doesn't have to guess from the bare schema.\n     *\n     * Empty when no field on this variant carries an `@should` hint.\n     */\n    fieldHints: Array<{ path: string; hint: string }>\n  }>\n}\n\nexport function handleListActions(host: ListActionsHost): ListActionsResult {\n  const annotations = host.getMsgAnnotations() ?? {}\n  const state = host.getState()\n  const descriptors = host.getBindingDescriptors() ?? []\n  const affordancesFn = host.getAgentAffordances()\n  const affordances = affordancesFn ? affordancesFn(state) : []\n  // When the app provides `agentAffordances(state)`, it's opted into\n  // explicit affordance control: only state-relevant Msgs are listed.\n  // `@agentOnly` schema-source variants are then filtered to those the\n  // hook returned — so a bulk-edit Msg like `Matrix/AddCriteria`\n  // doesn't surface on the home page just because it's tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default (\"everything's available unless you say\n  // otherwise\") since flipping that without explicit opt-in would\n  // break consumers who rely on schema-source surfacing of\n  // bulk Msgs.\n  const explicitAffordances = affordancesFn !== null\n  const affordanceVariants = new Set(affordances.map((m) => m.type))\n  const schema = host.getMsgSchema()\n\n  const out: ListActionsResult['actions'] = []\n  const seen = new Set<string>()\n\n  // From bindings — these have UI affordances by definition, so they're\n  // either 'shared' (default) or, in the malformed case where someone\n  // bound an `@agentOnly` Msg in a view, 'agent-only'. Either way the\n  // agent can dispatch them.\n  //\n  // Filtered against the Msg schema: a binding whose variant isn't in\n  // the user's Msg union is a library-internal Msg leaking through\n  // `tagSend` translator wiring (the sortable component's `move`,\n  // `drop`, `cancel`, etc. — they're routed into the user's update.ts\n  // via a different shape but their lib names slip into the binding\n  // registry). The agent has no use for those names — `would_dispatch`\n  // / `send_message` would reject them as `unknown-variant` anyway —\n  // so they pollute the affordance list. When a schema is available,\n  // the schema's variant set is the source of truth.\n  for (const d of descriptors) {\n    if (schema && !(d.variant in schema.variants)) continue\n    const ann = annotations[d.variant]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(d.variant)\n    const variantSchema = schema?.variants[d.variant]\n    out.push({\n      variant: d.variant,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'binding',\n      selectorHint: null,\n      payloadHint: null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `agentAffordances(state)` — the integrator's explicit list of\n  // currently-reachable Msgs, with concrete payloads they author.\n  for (const msg of affordances) {\n    const ann = annotations[msg.type]\n    if (ann?.dispatchMode === 'human-only') continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(msg.type)\n    const { type, ...rest } = msg\n    const variantSchema = schema?.variants[type]\n    out.push({\n      variant: type,\n      intent: ann?.intent ?? null,\n      requiresConfirm: ann?.requiresConfirm ?? false,\n      dispatchMode: ann?.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: Object.keys(rest).length > 0 ? rest : null,\n      warning: ann?.warning ?? null,\n      examples: ann?.examples ?? [],\n      emits: ann?.emits ?? [],\n      fieldHints: variantSchema ? collectFieldHints(variantSchema) : [],\n    })\n  }\n\n  // From `@alwaysAffordable` annotations — the per-variant equivalent\n  // of `agentAffordances`. Variants tagged this way surface regardless\n  // of whether a live binding maps to them, so bulk seed ops\n  // (`Matrix/AddAlternatives`) and similar agent-driven paths are\n  // available even when their UI counterparts (if any) aren't mounted.\n  // The payload is schema-synthesized — `agentAffordances` is the way\n  // to ship a concrete pre-filled payload alongside the affordance.\n  for (const [variant, ann] of Object.entries(annotations)) {\n    if (seen.has(variant)) continue\n    if (ann.dispatchMode === 'human-only') continue\n    if (!ann.alwaysAffordable) continue\n    if (!passesRouteGate(ann, state)) continue\n    seen.add(variant)\n    const fields = schema?.variants[variant]\n    out.push({\n      variant,\n      intent: ann.intent,\n      requiresConfirm: ann.requiresConfirm,\n      dispatchMode: ann.dispatchMode === 'agent-only' ? 'agent-only' : 'shared',\n      source: 'always-affordable',\n      selectorHint: null,\n      payloadHint: fields ? synthesizePayload(variant, fields) : null,\n      warning: ann.warning,\n      examples: ann.examples,\n      emits: ann.emits,\n      fieldHints: fields ? collectFieldHints(fields) : [],\n    })\n  }\n\n  // From schema — variants that aren't already surfaced above and that\n  // the author marked `@agentOnly`. The canonical \"no UI button maps\n  // to this; the agent is the only dispatcher.\" Bulk edits, imports,\n  // admin operations that have no human-facing affordance at all.\n  //\n  // `'shared'` variants WITHOUT a live binding stay hidden here — they\n  // are reachable through UI navigation, and dispatching them while\n  // their UI subtree is unmounted would pop hidden state in places the\n  // user didn't navigate to. The explicit knobs are `@alwaysAffordable`\n  // (handled above) or `agentAffordances(state)`.\n  //\n  // When the app provides `agentAffordances`, this pass is filtered:\n  // an `@agentOnly` variant only surfaces if the hook returned it.\n  // That makes route-gated bulk Msgs (`Matrix/AddCriteria` available\n  // only when a matrix is loaded) work as expected — they stop\n  // appearing on the home page just because they're tagged\n  // `@agentOnly`. Apps without `agentAffordances` keep the previous\n  // permissive default.\n  if (schema) {\n    for (const [variant, fields] of Object.entries(schema.variants)) {\n      if (seen.has(variant)) continue\n      const ann = annotations[variant]\n      if (ann?.dispatchMode !== 'agent-only') continue\n      if (explicitAffordances && !affordanceVariants.has(variant)) continue\n      if (!passesRouteGate(ann, state)) continue\n      out.push({\n        variant,\n        intent: ann.intent,\n        requiresConfirm: ann.requiresConfirm,\n        dispatchMode: 'agent-only',\n        source: 'schema',\n        selectorHint: null,\n        payloadHint: synthesizePayload(variant, fields),\n        warning: ann.warning,\n        examples: ann.examples,\n        emits: ann.emits,\n        fieldHints: collectFieldHints(fields),\n      })\n    }\n  }\n\n  return { actions: out }\n}\n\n/**\n * Build an example payload object the LLM can fill in. Required\n * fields always appear; optional fields appear only when annotated\n * `@should` (LLM is encouraged to fill them in). Fields without a\n * concrete primitive type (`'unknown'`) emit `null` placeholders the\n * LLM is expected to replace.\n *\n * The first key is `type` so the payload reads as a complete Msg\n * shape — copy-paste-ready into `send_message`.\n */\n/**\n * Evaluate `@routeGated(\"predicate\")` against the current state.\n * Returns true (variant passes) when:\n *   - the variant has no `@routeGated` annotation, OR\n *   - the predicate evaluates truthy with `state` bound.\n *\n * Predicate is compiled lazily via `new Function('state', 'return (' +\n * src + ')')` and cached in a module-level Map. Compile failures\n * (syntactically broken predicates) degrade to \"true\" so a single\n * malformed annotation doesn't paralyze the affordance pass — the\n * build-time linter is the right place to catch syntactic issues.\n * Evaluation throws fail-closed (return false) since a predicate that\n * crashes on the current state shouldn't surface the variant.\n */\nfunction passesRouteGate(ann: MessageAnnotations | undefined, state: unknown): boolean {\n  const src = ann?.routeGate\n  if (!src) return true\n  const predicate = compileRouteGate(src)\n  try {\n    return Boolean(predicate(state))\n  } catch {\n    return false\n  }\n}\n\nconst routeGateCache = new Map<string, (state: unknown) => boolean>()\nfunction compileRouteGate(src: string): (state: unknown) => boolean {\n  let fn = routeGateCache.get(src)\n  if (fn) return fn\n  try {\n    fn = new Function('state', `return (${src})`) as (state: unknown) => boolean\n  } catch {\n    fn = () => true\n  }\n  routeGateCache.set(src, fn)\n  return fn\n}\n\n/**\n * Sentinel returned by `synthesizeBare` for fields whose schema is\n * `'unknown'` — the synthesizer can't make up a value, so it tells\n * callers to omit the field from the synthesized example. Emitting\n * `null` (the previous behavior) bit us in production: agents\n * copied the literal `null`, the validator let it through (it\n * exempts unknowns), and the consumer code crashed on `null.kind` /\n * `null.length` etc. Symbol values are dropped silently by\n * `JSON.stringify`, so even a missed filter site can't leak this\n * to the wire.\n */\nconst OMIT = Symbol('synthesize.omit')\n\nfunction synthesizePayload(variant: string, fields: Record<string, MsgSchemaField>): object {\n  const out: Record<string, unknown> = { type: variant }\n  for (const [name, descriptor] of Object.entries(fields)) {\n    const optional = isOptional(descriptor)\n    const priority = isShould(descriptor)\n    // Skip optional fields unless they're @should-flagged. Required\n    // fields always appear.\n    if (optional && priority !== 'should') continue\n    const value = exampleValue(descriptor)\n    if (value === OMIT) continue\n    out[name] = value\n  }\n  return out\n}\n\n/**\n * Walk a variant's field tree and collect every `@should` hint into a\n * flat list keyed by field path. Path conventions:\n *   - top-level field: `\"cells\"`\n *   - nested object property: `\"cells.value\"`\n *   - array element: `\"cells[]\"` for the element itself; descendants\n *     use `\"cells[].meta\"` and so on.\n *\n * Surfaces the same hints that show up nested inside\n * `description.messages.variants[X].field.hint` so callers don't have\n * to dig through the schema tree to find them.\n */\nfunction collectFieldHints(\n  fields: Record<string, MsgSchemaField>,\n): Array<{ path: string; hint: string }> {\n  const out: Array<{ path: string; hint: string }> = []\n  for (const [name, descriptor] of Object.entries(fields)) {\n    walkHint(name, descriptor, out)\n  }\n  return out\n}\n\nfunction walkHint(\n  path: string,\n  d: MsgSchemaField,\n  out: Array<{ path: string; hint: string }>,\n): void {\n  // Rich descriptor with a hint at this position.\n  if (typeof d === 'object' && d !== null && 'type' in d) {\n    if (typeof d.hint === 'string' && d.hint.length > 0) {\n      out.push({ path, hint: d.hint })\n    }\n    // `@validates(...)` predicates surface alongside `@should` hints\n    // so the agent sees the constraint at affordance time rather than\n    // only as a post-dispatch rejection. The verbatim predicate text\n    // is what the runtime evaluates; agents trained on JS read it\n    // directly. Prefix `validates: ` to disambiguate from freeform\n    // `@should` text.\n    if (typeof d.validates === 'string' && d.validates.length > 0) {\n      out.push({ path, hint: `validates: ${d.validates}` })\n    }\n    walkHintBare(path, d.type, out)\n    return\n  }\n  walkHintBare(path, d, out)\n}\n\nfunction walkHintBare(path: string, t: unknown, out: Array<{ path: string; hint: string }>): void {\n  if (t === null || typeof t !== 'object') return\n  const obj = t as Record<string, unknown>\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      walkHint(`${path}.${name}`, descriptor, out)\n    }\n    return\n  }\n  if (obj.kind === 'array') {\n    walkHint(`${path}[]`, obj.element as MsgSchemaField, out)\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthetic hint at the union's path summarizing the legal\n    // discriminant values. Lets the agent see \"format expects one of:\n    // exact, range, compound\" without walking the full schema. Then\n    // walk each branch's per-field hints with a path-suffix that\n    // disambiguates which branch the hint applies to.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const legalValues = Object.keys(variants)\n    if (legalValues.length > 0) {\n      out.push({\n        path,\n        hint: `Discriminated union — set \\`${discriminant}\\` to one of: ${legalValues\n          .map((v) => `'${v}'`)\n          .join(', ')}.`,\n      })\n    }\n    for (const [discValue, fields] of Object.entries(variants)) {\n      for (const [fieldName, fieldDesc] of Object.entries(fields)) {\n        walkHint(`${path}(${discriminant}=${discValue}).${fieldName}`, fieldDesc, out)\n      }\n    }\n  }\n}\n\nfunction isOptional(d: MsgSchemaField): boolean {\n  return typeof d === 'object' && 'type' in d && d.optional === true\n}\n\nfunction isShould(d: MsgSchemaField): 'should' | undefined {\n  return typeof d === 'object' && 'type' in d ? d.priority : undefined\n}\n\nfunction exampleValue(d: MsgSchemaField): unknown {\n  // Unwrap rich descriptor to get the bare type for synthesis.\n  const t =\n    typeof d === 'object' && 'type' in d\n      ? d.type\n      : (d as\n          | Exclude<MsgSchemaField, object>\n          | Extract<MsgSchemaField, { kind?: string; enum?: string[] }>)\n  return synthesizeBare(t as never)\n}\n\nfunction synthesizeBare(t: unknown): unknown {\n  if (typeof t === 'string') {\n    if (t === 'string') return ''\n    if (t === 'number') return 0\n    if (t === 'boolean') return false\n    return OMIT // 'unknown' or unrecognized — caller drops the field\n  }\n  if (t === null || typeof t !== 'object') return OMIT\n  const obj = t as Record<string, unknown>\n  if ('enum' in obj && Array.isArray(obj.enum)) {\n    // First option doubles as the canonical example. Native value type\n    // round-trips (string/number/boolean) since the compiler preserved\n    // the literal kind on emit.\n    return obj.enum[0] ?? OMIT\n  }\n  if (obj.kind === 'object' && obj.shape !== null && typeof obj.shape === 'object') {\n    // Recurse into the nested shape. Same optional-skip rule as the\n    // top-level synthesizer: required fields appear, optional ones\n    // appear only when @should-flagged.\n    const out: Record<string, unknown> = {}\n    for (const [name, descriptor] of Object.entries(obj.shape as Record<string, MsgSchemaField>)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      const value = exampleValue(descriptor)\n      if (value === OMIT) continue\n      out[name] = value\n    }\n    return out\n  }\n  if (obj.kind === 'array') {\n    // Wrap the synthesized element in a one-item array. Lets the LLM\n    // see the per-entry shape without us guessing at array length.\n    // If the element schema is 'unknown', return an empty array\n    // rather than `[null]` — the empty array signals \"this is an\n    // array, shape unknown\" without putting a misleading literal in\n    // the example.\n    const elementValue = synthesizeBare(obj.element)\n    return elementValue === OMIT ? [] : [elementValue]\n  }\n  if (obj.kind === 'discriminated-union') {\n    // Synthesize the FIRST branch as the concrete example. The full\n    // shape (every legal branch + its payload) is preserved in\n    // `description.messages.variants[X]` from `describe_app`, so the\n    // agent that needs another branch reads the schema directly.\n    // `collectFieldHints` adds a synthetic enumeration of the legal\n    // `<discriminant>` values onto the hint surface so the agent\n    // doesn't have to dig into the schema for the simple case.\n    const variants = obj.variants as Record<string, Record<string, MsgSchemaField>>\n    const discriminant = String(obj.discriminant)\n    const firstEntry = Object.entries(variants).at(0)\n    if (!firstEntry) return OMIT\n    const [firstValue, firstFields] = firstEntry\n    const branch: Record<string, unknown> = { [discriminant]: firstValue }\n    for (const [name, descriptor] of Object.entries(firstFields)) {\n      const isOpt = isOptional(descriptor)\n      const pri = isShould(descriptor)\n      if (isOpt && pri !== 'should') continue\n      const value = exampleValue(descriptor)\n      if (value === OMIT) continue\n      branch[name] = value\n    }\n    return branch\n  }\n  return OMIT\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llui/agent",
-  "version": "0.0.42",
+  "version": "0.0.43",
   "type": "module",
   "sideEffects": false,
   "exports": {