@useago/sdk 1.0.8 → 1.0.9

package/README.md

@@ -3,9 +3,20 @@
 [![npm version](https://img.shields.io/npm/v/@useago/sdk.svg)](https://www.npmjs.com/package/@useago/sdk)
 [![types](https://img.shields.io/npm/types/@useago/sdk.svg)](https://www.npmjs.com/package/@useago/sdk)
 
-**The agent layer for your frontend stack.** AGO's agents plug into React, Vue,
-Angular or plain TypeScript like any other dependency: send a message, stream
-the reply, and let the agent call **your** code and navigate **your** UI.
+**The customer-facing agent platform for your product.**
+
+AGO embeds AI agents directly into your frontend stack: React, Vue, Angular or
+plain TypeScript. Send messages, stream responses, expose frontend actions, and
+let agents guide users, trigger workflows, or operate **your** UI.
+
+Internal agent platforms help employees work faster. Customer-facing agents are
+a different problem. They have to be reliable, safe, measurable, brand-aligned,
+and integrated into the product experience.
+
+AGO provides the operating layer behind the SDK: business and user context, tool
+orchestration, evaluations, quality monitoring, security controls, human
+fallback, and continuous improvement. Your team ships product-native agents that
+resolve customer needs, without rebuilding the full customer-facing agent platform.
 
 In two minutes you'll have a working chat on your page and an agent that can
 navigate your app. The quickstart below uses **React**; every other stack gets

package/dist/angular.d.cts

@@ -572,7 +572,7 @@ declare interface FormCollectorDefinition<V = Record<string, unknown>> {
 
 /**
  * Shape of a form's fields. Mirrors a client function's `parameters` (so the same
- * object feeds the store, the update function, and the dynamic context). Additionally allows the SDK-only per-field `requiredWhen`, which {@link toWireParameters} removes before the schema reaches the LLM.
+ * object feeds the store, the update function, and the dynamic context). Additionally allows the SDK-only per-field `requiredWhen`, which {@link toWireParameters} removes from the LLM tool's `parameters` (the full schema still reaches the agent via dynamic context).
  */
 declare interface FormCollectorSchema {
     type: "object";
@@ -589,17 +589,32 @@ declare interface FormField {
 }
 
 /**
- * A field's conditional-requiredness rule. The field becomes required exactly
- * when the controlling `property` matches `value` against the answers collected
- * so far:
+ * A field's conditional-requiredness rule: either a single {@link FormFieldLeafCondition}
+ * or a boolean combination of rules. `anyOf` is OR (true when any nested rule
+ * holds); `allOf` is AND (true when every nested rule holds). Both nest
+ * arbitrarily, so you can mix them, e.g.
+ * `{ anyOf: [{ property: "a", op: ">=", value: 1 }, { property: "b", value: "1" }] }`.
+ * An empty `anyOf` is never required; an empty `allOf` is always required.
+ *
+ * Stripped from the LLM tool's `parameters` (see {@link toWireParameters}), but the
+ * full schema, `requiredWhen` included, still reaches the agent via the dynamic
+ * context so it knows when each field becomes required.
+ */
+declare type FormFieldCondition = FormFieldLeafCondition | {
+    anyOf: FormFieldCondition[];
+} | {
+    allOf: FormFieldCondition[];
+};
+
+/**
+ * A single leaf comparison. The field it guards becomes required exactly when the
+ * controlling `property` matches `value` against the answers collected so far:
  * - a single `value`, no `op` — equality (compared as strings);
  * - a single `value` with `op` — numeric comparison (both sides coerced to numbers);
  * - an array `value`, no `op` — "one of": matches when the property equals any
  *   listed value.
- *
- * SDK-only — it is stripped from the schema before it reaches the LLM tool
  */
-declare interface FormFieldCondition {
+declare interface FormFieldLeafCondition {
     /** The controlling field whose value the rule tests. */
     property: string;
     /** Comparison operator; omitted means equality. Ignored when `value` is an array. */
@@ -620,7 +635,8 @@ declare interface FormFieldSchema {
     default?: unknown;
     /**
      * Makes the field required only while this condition holds. Drives the dynamic
-     * `missing` list; stripped before the LLM tool — see {@link toWireParameters}.
+     * `missing` list; stripped from the LLM tool's `parameters` (still sent to the
+     * agent via dynamic context). See {@link toWireParameters}.
      */
     requiredWhen?: FormFieldCondition;
 }

package/dist/angular.d.ts

@@ -572,7 +572,7 @@ declare interface FormCollectorDefinition<V = Record<string, unknown>> {
 
 /**
  * Shape of a form's fields. Mirrors a client function's `parameters` (so the same
- * object feeds the store, the update function, and the dynamic context). Additionally allows the SDK-only per-field `requiredWhen`, which {@link toWireParameters} removes before the schema reaches the LLM.
+ * object feeds the store, the update function, and the dynamic context). Additionally allows the SDK-only per-field `requiredWhen`, which {@link toWireParameters} removes from the LLM tool's `parameters` (the full schema still reaches the agent via dynamic context).
  */
 declare interface FormCollectorSchema {
     type: "object";
@@ -589,17 +589,32 @@ declare interface FormField {
 }
 
 /**
- * A field's conditional-requiredness rule. The field becomes required exactly
- * when the controlling `property` matches `value` against the answers collected
- * so far:
+ * A field's conditional-requiredness rule: either a single {@link FormFieldLeafCondition}
+ * or a boolean combination of rules. `anyOf` is OR (true when any nested rule
+ * holds); `allOf` is AND (true when every nested rule holds). Both nest
+ * arbitrarily, so you can mix them, e.g.
+ * `{ anyOf: [{ property: "a", op: ">=", value: 1 }, { property: "b", value: "1" }] }`.
+ * An empty `anyOf` is never required; an empty `allOf` is always required.
+ *
+ * Stripped from the LLM tool's `parameters` (see {@link toWireParameters}), but the
+ * full schema, `requiredWhen` included, still reaches the agent via the dynamic
+ * context so it knows when each field becomes required.
+ */
+declare type FormFieldCondition = FormFieldLeafCondition | {
+    anyOf: FormFieldCondition[];
+} | {
+    allOf: FormFieldCondition[];
+};
+
+/**
+ * A single leaf comparison. The field it guards becomes required exactly when the
+ * controlling `property` matches `value` against the answers collected so far:
  * - a single `value`, no `op` — equality (compared as strings);
  * - a single `value` with `op` — numeric comparison (both sides coerced to numbers);
  * - an array `value`, no `op` — "one of": matches when the property equals any
  *   listed value.
- *
- * SDK-only — it is stripped from the schema before it reaches the LLM tool
  */
-declare interface FormFieldCondition {
+declare interface FormFieldLeafCondition {
     /** The controlling field whose value the rule tests. */
     property: string;
     /** Comparison operator; omitted means equality. Ignored when `value` is an array. */
@@ -620,7 +635,8 @@ declare interface FormFieldSchema {
     default?: unknown;
     /**
      * Makes the field required only while this condition holds. Drives the dynamic
-     * `missing` list; stripped before the LLM tool — see {@link toWireParameters}.
+     * `missing` list; stripped from the LLM tool's `parameters` (still sent to the
+     * agent via dynamic context). See {@link toWireParameters}.
      */
     requiredWhen?: FormFieldCondition;
 }

package/dist/{createConversationSession-BwYNMZWq.cjs → createConversationSession-C0diFTUk.cjs}

@@ -1 +1 @@
-const d=require("./createFormCollector-BHHEW6uX.cjs");var f="ago_widget_id",g="ago_last_thread",y=7200*1e3;function v(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{const r=Math.floor(Math.random()*16);return(e==="x"?r:r&3|8).toString(16)})}function _(e={}){const r=e.key??f,i=e.threadKey??g,u=e.ttlMs??y,l=e.storage??(typeof localStorage<"u"?localStorage:void 0);let n=e.widgetId??"";if(!n&&l)try{n=l.getItem(r)??""}catch{}if(n||(n=v()),l)try{l.setItem(r,n)}catch{}const o=d.createStore({value:null,lastMessageAt:null},{key:i,storage:l}),c=o.get();c.value!==null&&s(c.lastMessageAt)&&o.set({value:null,lastMessageAt:null});function s(t){return t===null?!0:Number.isFinite(u)?Date.now()-t>u:!1}return{widgetId:n,key:r,getLastActiveThread(){const{value:t,lastMessageAt:a}=o.get();return t===null||s(a)?null:t},setActiveThread(t,a){const x=a==null?null:a instanceof Date?a.getTime():a;o.set({value:t,lastMessageAt:x})},clear(){o.set({value:null,lastMessageAt:null})}}}Object.defineProperty(exports,"createConversationSession",{enumerable:!0,get:function(){return _}});
+const d=require("./createFormCollector-BI3DXaew.cjs");var f="ago_widget_id",g="ago_last_thread",y=7200*1e3;function v(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{const r=Math.floor(Math.random()*16);return(e==="x"?r:r&3|8).toString(16)})}function _(e={}){const r=e.key??f,i=e.threadKey??g,u=e.ttlMs??y,l=e.storage??(typeof localStorage<"u"?localStorage:void 0);let n=e.widgetId??"";if(!n&&l)try{n=l.getItem(r)??""}catch{}if(n||(n=v()),l)try{l.setItem(r,n)}catch{}const o=d.createStore({value:null,lastMessageAt:null},{key:i,storage:l}),c=o.get();c.value!==null&&s(c.lastMessageAt)&&o.set({value:null,lastMessageAt:null});function s(t){return t===null?!0:Number.isFinite(u)?Date.now()-t>u:!1}return{widgetId:n,key:r,getLastActiveThread(){const{value:t,lastMessageAt:a}=o.get();return t===null||s(a)?null:t},setActiveThread(t,a){const x=a==null?null:a instanceof Date?a.getTime():a;o.set({value:t,lastMessageAt:x})},clear(){o.set({value:null,lastMessageAt:null})}}}Object.defineProperty(exports,"createConversationSession",{enumerable:!0,get:function(){return _}});

package/dist/{createConversationSession-DrCMdwkV.js → createConversationSession-CR-71aLR.js}

@@ -1,4 +1,4 @@
-import { i as d } from "./createFormCollector-QyojCH_-.js";
+import { i as d } from "./createFormCollector-CFt1_QSL.js";
 var f = "ago_widget_id", g = "ago_last_thread", y = 7200 * 1e3;
 function v() {
   return typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (e) => {

package/dist/createFormCollector-BI3DXaew.cjs

@@ -0,0 +1 @@
+const C=require("./AgoClient-B3-WGVne.cjs");function W(n,e){const a=e?e.storage??(typeof localStorage<"u"?localStorage:void 0):void 0;let s=n;if(e&&a)try{const m=a.getItem(e.key);m!=null&&(s=JSON.parse(m))}catch{}const i=new Set,c=()=>i.forEach(m=>m(s));function b(){if(e&&a)try{a.setItem(e.key,JSON.stringify(s))}catch{}}return{get:()=>s,set:m=>{s=m,b(),c()},subscribe:m=>(i.add(m),()=>{i.delete(m)})}}var T=/^[a-zA-Z0-9_-]{1,40}$/,x=n=>n==null||n==="";function v(n,e){if("anyOf"in n)return n.anyOf.some(c=>v(c,e));if("allOf"in n)return n.allOf.every(c=>v(c,e));const a=e[n.property];if(x(a))return!1;if(Array.isArray(n.value))return n.value.some(c=>String(a)===String(c));if(!n.op)return String(a)===String(n.value);const s=Number(a),i=Number(n.value);if(Number.isNaN(s)||Number.isNaN(i))return!1;switch(n.op){case">=":return s>=i;case"<=":return s<=i;case">":return s>i;case"<":return s<i;default:return C.logger.warn(`Unknown requiredWhen op "${n.op}"; treating as not required.`),!1}}function h(n,e){const a=n.properties??{},s=new Set;for(const c of n.required??[]){const b=a[c]?.requiredWhen;(!b||v(b,e))&&s.add(c)}for(const[c,b]of Object.entries(a))b.requiredWhen&&v(b.requiredWhen,e)&&s.add(c);const i=[...s].filter(c=>x(e[c]));return{missing:i,complete:i.length===0}}function R(n){const e={};for(const[a,s]of Object.entries(n.properties??{}))e[a]={type:s.type,...s.description!=null&&{description:s.description},...s.enum&&{enum:s.enum},...s.default!==void 0&&{default:s.default}};return{type:"object",properties:e,required:[]}}function A(n){const{name:e,description:a,schema:s}=n;if(!T.test(e))throw new Error(`Invalid form collector name "${e}": must match ${T} (it becomes the update_/submit_ function names).`);const i=typeof n.submit=="string"?n.submit?{via:"client",url:n.submit}:!1:n.submit??!1;n.autoSubmit===!0&&!i&&C.logger.warn(`FormCollector "${e}": autoSubmit is ignored because no submit target is configured.`);const c=(n.autoSubmit??!0)&&!!i,b=s.properties??{},m=t=>{const r={};for(const[u,o]of Object.entries(t)){const l=b[u];if(l)if(o==null)r[u]=o;else if(l.type==="number"||l.type==="integer"){const d=typeof o=="number"?o:Number(o);r[u]=Number.isNaN(d)?o:d}else l.type==="boolean"?r[u]=typeof o=="boolean"?o:o==="true"?!0:o==="false"?!1:!!o:r[u]=o}return r},S=n.initialValues??{},f=W({values:S,submitted:!1}),$=t=>{const r=f.get(),u={...r,values:{...r.values,...t}};return f.set(u),u};let g=null;const F=(t,r)=>{g?.emitFormEvent("form:error",{name:e,values:t,error:r})};let y=null;const I=async()=>{const{values:t}=f.get(),{complete:r,missing:u}=h(s,t);if(!r)return{ok:!1,missing:u};if(!i)return{ok:!1,error:"No submit target configured for this form collector."};const o=t;try{let l;if(i.via==="client")if("handler"in i)l=await i.handler(o);else{const d=await fetch(i.url,{method:"POST",headers:{"Content-Type":"application/json"},credentials:"include",body:JSON.stringify(o)});if(!d.ok){const j=`Submit failed: HTTP ${d.status}`;return F(o,j),{ok:!1,error:j}}l=await d.json().catch(()=>{})}else{if(!g)return{ok:!1,error:"Backend submit requires install(client) (or useFormCollector) first."};l=await g.submitFormCollector(e,o)}return f.set({...f.get(),submitted:!0,submitResult:l}),g?.emitFormEvent("form:submitted",{name:e,values:o,result:l}),{ok:!0,result:l}}catch(l){const d=l instanceof Error?l.message:"Submit failed";return C.logger.error(`FormCollector "${e}" submit failed:`,l),F(o,d),{ok:!1,error:d}}},N=()=>y||(y=(async()=>{try{return await I()}finally{y=null}})(),y),k=async()=>{if(!c||!i)return null;const{values:t,submitted:r}=f.get();return r||!h(s,t).complete?null:N()},O={name:`update_${e}`,description:`Fill or update fields of the "${e}" form. ${a} Pass any subset of fields; call it repeatedly to fill the form as the user provides information. Returns the current values and which required fields are still missing.`,parameters:R(s),handler:async t=>{const r=$(m(t)),{missing:u}=h(s,r.values),o=await k();return o?o.ok?{ok:!0,values:r.values,missing:u,submitted:!0}:{ok:!0,values:r.values,missing:u,submitted:!1,submitError:o.error}:{ok:!0,values:r.values,missing:u}}},p=[O];i&&!c&&p.push({name:`submit_${e}`,description:`Submit the completed "${e}" form. Only call this once every required field is collected and the user has confirmed. If fields are missing it returns them instead of submitting.`,parameters:{type:"object",properties:{}},handler:()=>N()});const V="client__",q=i?`submit_${e}`:null,J=t=>{const r=t.functionName??t.toolName;if(r)return r.startsWith(V)?r.slice(8):r},_=t=>{let r={...S},u=!1;for(const o of t){const l=J(o);l===O.name?o.arguments&&(r={...r,...m(o.arguments)}):q&&l===q&&o.status?.toLowerCase()==="done"&&(u=!0)}f.set({values:r,submitted:u})},w=`form:${e}`,E=()=>{const{values:t,submitted:r}=f.get(),{missing:u,complete:o}=h(s,t),l=i?c?" The form is submitted automatically as soon as every required field is filled, so there is no submit function to call.":` When nothing is missing and the user confirms, call submit_${e}.`:"",d=r?`The "${e}" form has been submitted.`:`You are currently collecting information from the user to fill the "${e}" form.`;return{name:`Form: ${e}`,description:`${d} ${a} Some fields are conditionally required; the requiredWhen field in the schema tells you when each becomes required. The form schema is the following: ${JSON.stringify(s)}. Data collected so far: ${JSON.stringify(t)}. Call update_${e} with any fields the user provides; ask only for what is still missing.${l}`,data:{values:t,missing:u,complete:o,submitted:r}}},P=t=>{_((t.messages??[]).flatMap(r=>r.toolCalls??[]))};return{name:e,store:f,functions:p,contextKey:w,contextProvider:E,install:t=>{g=t;for(const u of p)t.register(u);t.addDynamicContext(w,E);const r=f.subscribe(()=>t.notifyContextChanged());return t.on("conversation:loaded",P),()=>{r();for(const u of p)t.unregisterFunction(u.name);t.removeDynamicContext(w),t.off("conversation:loaded",P),g===t&&(g=null)}},hydrate:_,submit:N,getValues:()=>f.get().values,setValues:t=>{$(m(t)),k()},reset:()=>{f.set({values:S,submitted:!1})},getStatus:()=>h(s,f.get().values)}}async function B(n,e){const a=await n.getFormCollector(e.name);return A({name:a.name,description:e.description??a.description,schema:e.schema??a.schema,submit:e.submit??a.submit,initialValues:e.initialValues,autoSubmit:e.autoSubmit??a.autoSubmit})}Object.defineProperty(exports,"createFormCollector",{enumerable:!0,get:function(){return A}});Object.defineProperty(exports,"createStore",{enumerable:!0,get:function(){return W}});Object.defineProperty(exports,"deriveFormStatus",{enumerable:!0,get:function(){return h}});Object.defineProperty(exports,"loadFormCollector",{enumerable:!0,get:function(){return B}});

package/dist/{createFormCollector-QyojCH_-.js → createFormCollector-CFt1_QSL.js}

@@ -1,70 +1,72 @@
-import { c as w } from "./AgoClient-QcTtrN7u.js";
-function A(o, e) {
+import { c as $ } from "./AgoClient-QcTtrN7u.js";
+function A(s, e) {
   const a = e ? e.storage ?? (typeof localStorage < "u" ? localStorage : void 0) : void 0;
-  let s = o;
+  let n = s;
   if (e && a) try {
     const m = a.getItem(e.key);
-    m != null && (s = JSON.parse(m));
+    m != null && (n = JSON.parse(m));
   } catch {
   }
-  const i = /* @__PURE__ */ new Set(), c = () => i.forEach((m) => m(s));
+  const o = /* @__PURE__ */ new Set(), c = () => o.forEach((m) => m(n));
   function b() {
     if (e && a) try {
-      a.setItem(e.key, JSON.stringify(s));
+      a.setItem(e.key, JSON.stringify(n));
     } catch {
     }
   }
   return {
-    get: () => s,
+    get: () => n,
     set: (m) => {
-      s = m, b(), c();
+      n = m, b(), c();
     },
-    subscribe: (m) => (i.add(m), () => {
-      i.delete(m);
+    subscribe: (m) => (o.add(m), () => {
+      o.delete(m);
     })
   };
 }
-var x = /^[a-zA-Z0-9_-]{1,40}$/, W = (o) => o == null || o === "";
-function P(o, e) {
-  const a = e[o.property];
+var P = /^[a-zA-Z0-9_-]{1,40}$/, W = (s) => s == null || s === "";
+function v(s, e) {
+  if ("anyOf" in s) return s.anyOf.some((c) => v(c, e));
+  if ("allOf" in s) return s.allOf.every((c) => v(c, e));
+  const a = e[s.property];
   if (W(a)) return !1;
-  if (Array.isArray(o.value)) return o.value.some((c) => String(a) === String(c));
-  if (!o.op) return String(a) === String(o.value);
-  const s = Number(a), i = Number(o.value);
-  if (Number.isNaN(s) || Number.isNaN(i)) return !1;
-  switch (o.op) {
+  if (Array.isArray(s.value)) return s.value.some((c) => String(a) === String(c));
+  if (!s.op) return String(a) === String(s.value);
+  const n = Number(a), o = Number(s.value);
+  if (Number.isNaN(n) || Number.isNaN(o)) return !1;
+  switch (s.op) {
     case ">=":
-      return s >= i;
+      return n >= o;
     case "<=":
-      return s <= i;
+      return n <= o;
     case ">":
-      return s > i;
+      return n > o;
     case "<":
-      return s < i;
+      return n < o;
     default:
-      return w.warn(`Unknown requiredWhen op "${o.op}"; treating as not required.`), !1;
+      return $.warn(`Unknown requiredWhen op "${s.op}"; treating as not required.`), !1;
   }
 }
-function g(o, e) {
-  const a = o.properties ?? {}, s = /* @__PURE__ */ new Set();
-  for (const c of o.required ?? []) {
+function y(s, e) {
+  const a = s.properties ?? {}, n = /* @__PURE__ */ new Set();
+  for (const c of s.required ?? []) {
     const b = a[c]?.requiredWhen;
-    (!b || P(b, e)) && s.add(c);
+    (!b || v(b, e)) && n.add(c);
   }
-  for (const [c, b] of Object.entries(a)) b.requiredWhen && P(b.requiredWhen, e) && s.add(c);
-  const i = [...s].filter((c) => W(e[c]));
+  for (const [c, b] of Object.entries(a)) b.requiredWhen && v(b.requiredWhen, e) && n.add(c);
+  const o = [...n].filter((c) => W(e[c]));
   return {
-    missing: i,
-    complete: i.length === 0
+    missing: o,
+    complete: o.length === 0
   };
 }
-function J(o) {
+function J(s) {
   const e = {};
-  for (const [a, s] of Object.entries(o.properties ?? {})) e[a] = {
-    type: s.type,
-    ...s.description != null && { description: s.description },
-    ...s.enum && { enum: s.enum },
-    ...s.default !== void 0 && { default: s.default }
+  for (const [a, n] of Object.entries(s.properties ?? {})) e[a] = {
+    type: n.type,
+    ...n.description != null && { description: n.description },
+    ...n.enum && { enum: n.enum },
+    ...n.default !== void 0 && { default: n.default }
   };
   return {
     type: "object",
@@ -72,30 +74,30 @@ function J(o) {
     required: []
   };
 }
-function R(o) {
-  const { name: e, description: a, schema: s } = o;
-  if (!x.test(e)) throw new Error(`Invalid form collector name "${e}": must match ${x} (it becomes the update_/submit_ function names).`);
-  const i = typeof o.submit == "string" ? o.submit ? {
+function R(s) {
+  const { name: e, description: a, schema: n } = s;
+  if (!P.test(e)) throw new Error(`Invalid form collector name "${e}": must match ${P} (it becomes the update_/submit_ function names).`);
+  const o = typeof s.submit == "string" ? s.submit ? {
     via: "client",
-    url: o.submit
-  } : !1 : o.submit ?? !1;
-  o.autoSubmit === !0 && !i && w.warn(`FormCollector "${e}": autoSubmit is ignored because no submit target is configured.`);
-  const c = (o.autoSubmit ?? !0) && !!i, b = s.properties ?? {}, m = (t) => {
+    url: s.submit
+  } : !1 : s.submit ?? !1;
+  s.autoSubmit === !0 && !o && $.warn(`FormCollector "${e}": autoSubmit is ignored because no submit target is configured.`);
+  const c = (s.autoSubmit ?? !0) && !!o, b = n.properties ?? {}, m = (t) => {
     const r = {};
-    for (const [u, n] of Object.entries(t)) {
+    for (const [u, i] of Object.entries(t)) {
       const l = b[u];
       if (l)
-        if (n == null) r[u] = n;
+        if (i == null) r[u] = i;
         else if (l.type === "number" || l.type === "integer") {
-          const d = typeof n == "number" ? n : Number(n);
-          r[u] = Number.isNaN(d) ? n : d;
-        } else l.type === "boolean" ? r[u] = typeof n == "boolean" ? n : n === "true" ? !0 : n === "false" ? !1 : !!n : r[u] = n;
+          const d = typeof i == "number" ? i : Number(i);
+          r[u] = Number.isNaN(d) ? i : d;
+        } else l.type === "boolean" ? r[u] = typeof i == "boolean" ? i : i === "true" ? !0 : i === "false" ? !1 : !!i : r[u] = i;
     }
     return r;
-  }, v = o.initialValues ?? {}, f = A({
-    values: v,
+  }, S = s.initialValues ?? {}, f = A({
+    values: S,
     submitted: !1
-  }), $ = (t) => {
+  }), C = (t) => {
     const r = f.get(), u = {
       ...r,
       values: {
@@ -106,7 +108,7 @@ function R(o) {
     return f.set(u), u;
   };
   let h = null;
-  const C = (t, r) => {
+  const k = (t, r) => {
     h?.emitFormEvent("form:error", {
       name: e,
       values: t,
@@ -115,31 +117,31 @@ function R(o) {
   };
   let p = null;
   const j = async () => {
-    const { values: t } = f.get(), { complete: r, missing: u } = g(s, t);
+    const { values: t } = f.get(), { complete: r, missing: u } = y(n, t);
     if (!r) return {
       ok: !1,
       missing: u
     };
-    if (!i) return {
+    if (!o) return {
       ok: !1,
       error: "No submit target configured for this form collector."
     };
-    const n = t;
+    const i = t;
     try {
       let l;
-      if (i.via === "client") if ("handler" in i) l = await i.handler(n);
+      if (o.via === "client") if ("handler" in o) l = await o.handler(i);
       else {
-        const d = await fetch(i.url, {
+        const d = await fetch(o.url, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           credentials: "include",
-          body: JSON.stringify(n)
+          body: JSON.stringify(i)
         });
         if (!d.ok) {
-          const O = `Submit failed: HTTP ${d.status}`;
-          return C(n, O), {
+          const x = `Submit failed: HTTP ${d.status}`;
+          return k(i, x), {
             ok: !1,
-            error: O
+            error: x
           };
         }
         l = await d.json().catch(() => {
@@ -150,7 +152,7 @@ function R(o) {
           ok: !1,
           error: "Backend submit requires install(client) (or useFormCollector) first."
         };
-        l = await h.submitFormCollector(e, n);
+        l = await h.submitFormCollector(e, i);
       }
       return f.set({
         ...f.get(),
@@ -158,7 +160,7 @@ function R(o) {
         submitResult: l
       }), h?.emitFormEvent("form:submitted", {
         name: e,
-        values: n,
+        values: i,
         result: l
       }), {
         ok: !0,
@@ -166,28 +168,28 @@ function R(o) {
       };
     } catch (l) {
       const d = l instanceof Error ? l.message : "Submit failed";
-      return w.error(`FormCollector "${e}" submit failed:`, l), C(n, d), {
+      return $.error(`FormCollector "${e}" submit failed:`, l), k(i, d), {
         ok: !1,
         error: d
       };
     }
-  }, S = () => p || (p = (async () => {
+  }, N = () => p || (p = (async () => {
     try {
       return await j();
     } finally {
       p = null;
     }
-  })(), p), k = async () => {
-    if (!c || !i) return null;
+  })(), p), F = async () => {
+    if (!c || !o) return null;
     const { values: t, submitted: r } = f.get();
-    return r || !g(s, t).complete ? null : S();
-  }, F = {
+    return r || !y(n, t).complete ? null : N();
+  }, q = {
     name: `update_${e}`,
     description: `Fill or update fields of the "${e}" form. ${a} Pass any subset of fields; call it repeatedly to fill the form as the user provides information. Returns the current values and which required fields are still missing.`,
-    parameters: J(s),
+    parameters: J(n),
     handler: async (t) => {
-      const r = $(m(t)), { missing: u } = g(s, r.values), n = await k();
-      return n ? n.ok ? {
+      const r = C(m(t)), { missing: u } = y(n, r.values), i = await F();
+      return i ? i.ok ? {
         ok: !0,
         values: r.values,
         missing: u,
@@ -197,49 +199,49 @@ function R(o) {
         values: r.values,
         missing: u,
         submitted: !1,
-        submitError: n.error
+        submitError: i.error
       } : {
         ok: !0,
         values: r.values,
         missing: u
       };
     }
-  }, y = [F];
-  i && !c && y.push({
+  }, g = [q];
+  o && !c && g.push({
     name: `submit_${e}`,
     description: `Submit the completed "${e}" form. Only call this once every required field is collected and the user has confirmed. If fields are missing it returns them instead of submitting.`,
     parameters: {
       type: "object",
       properties: {}
     },
-    handler: () => S()
+    handler: () => N()
   });
-  const I = "client__", q = i ? `submit_${e}` : null, V = (t) => {
+  const I = "client__", O = o ? `submit_${e}` : null, V = (t) => {
     const r = t.functionName ?? t.toolName;
     if (r)
       return r.startsWith(I) ? r.slice(8) : r;
   }, _ = (t) => {
-    let r = { ...v }, u = !1;
-    for (const n of t) {
-      const l = V(n);
-      l === F.name ? n.arguments && (r = {
+    let r = { ...S }, u = !1;
+    for (const i of t) {
+      const l = V(i);
+      l === q.name ? i.arguments && (r = {
         ...r,
-        ...m(n.arguments)
-      }) : q && l === q && n.status?.toLowerCase() === "done" && (u = !0);
+        ...m(i.arguments)
+      }) : O && l === O && i.status?.toLowerCase() === "done" && (u = !0);
     }
     f.set({
       values: r,
       submitted: u
     });
-  }, N = `form:${e}`, E = () => {
-    const { values: t, submitted: r } = f.get(), { missing: u, complete: n } = g(s, t), l = i ? c ? " The form is submitted automatically as soon as every required field is filled, so there is no submit function to call." : ` When nothing is missing and the user confirms, call submit_${e}.` : "", d = r ? `The "${e}" form has been submitted.` : `You are currently collecting information from the user to fill the "${e}" form.`;
+  }, w = `form:${e}`, E = () => {
+    const { values: t, submitted: r } = f.get(), { missing: u, complete: i } = y(n, t), l = o ? c ? " The form is submitted automatically as soon as every required field is filled, so there is no submit function to call." : ` When nothing is missing and the user confirms, call submit_${e}.` : "", d = r ? `The "${e}" form has been submitted.` : `You are currently collecting information from the user to fill the "${e}" form.`;
     return {
       name: `Form: ${e}`,
-      description: `${d} ${a} There are conditionnals questions/values to collected, you can find this information with the requiredWhen field in the form. The form schema is the following: ${JSON.stringify(s)}. Data collected so far: ${JSON.stringify(t)}. Call update_${e} with any fields the user provides; ask only for what is still missing.${l}`,
+      description: `${d} ${a} Some fields are conditionally required; the requiredWhen field in the schema tells you when each becomes required. The form schema is the following: ${JSON.stringify(n)}. Data collected so far: ${JSON.stringify(t)}. Call update_${e} with any fields the user provides; ask only for what is still missing.${l}`,
       data: {
         values: t,
         missing: u,
-        complete: n,
+        complete: i,
         submitted: r
       }
     };
@@ -249,37 +251,37 @@ function R(o) {
   return {
     name: e,
     store: f,
-    functions: y,
-    contextKey: N,
+    functions: g,
+    contextKey: w,
     contextProvider: E,
     install: (t) => {
       h = t;
-      for (const u of y) t.register(u);
-      t.addDynamicContext(N, E);
+      for (const u of g) t.register(u);
+      t.addDynamicContext(w, E);
       const r = f.subscribe(() => t.notifyContextChanged());
       return t.on("conversation:loaded", T), () => {
         r();
-        for (const u of y) t.unregisterFunction(u.name);
-        t.removeDynamicContext(N), t.off("conversation:loaded", T), h === t && (h = null);
+        for (const u of g) t.unregisterFunction(u.name);
+        t.removeDynamicContext(w), t.off("conversation:loaded", T), h === t && (h = null);
       };
     },
     hydrate: _,
-    submit: S,
+    submit: N,
     getValues: () => f.get().values,
     setValues: (t) => {
-      $(m(t)), k();
+      C(m(t)), F();
     },
     reset: () => {
       f.set({
-        values: v,
+        values: S,
         submitted: !1
       });
     },
-    getStatus: () => g(s, f.get().values)
+    getStatus: () => y(n, f.get().values)
   };
 }
-async function L(o, e) {
-  const a = await o.getFormCollector(e.name);
+async function L(s, e) {
+  const a = await s.getFormCollector(e.name);
   return R({
     name: a.name,
     description: e.description ?? a.description,
@@ -291,7 +293,7 @@ async function L(o, e) {
 }
 export {
   A as i,
-  g as n,
+  y as n,
   L as r,
   R as t
 };

package/dist/devtools.d.cts

@@ -495,7 +495,7 @@ declare interface FormCollectorDefinition<V = Record<string, unknown>> {
 
 /**
  * Shape of a form's fields. Mirrors a client function's `parameters` (so the same
- * object feeds the store, the update function, and the dynamic context). Additionally allows the SDK-only per-field `requiredWhen`, which {@link toWireParameters} removes before the schema reaches the LLM.
+ * object feeds the store, the update function, and the dynamic context). Additionally allows the SDK-only per-field `requiredWhen`, which {@link toWireParameters} removes from the LLM tool's `parameters` (the full schema still reaches the agent via dynamic context).
  */
 declare interface FormCollectorSchema {
     type: "object";
@@ -512,17 +512,32 @@ declare interface FormField {
 }
 
 /**
- * A field's conditional-requiredness rule. The field becomes required exactly
- * when the controlling `property` matches `value` against the answers collected
- * so far:
+ * A field's conditional-requiredness rule: either a single {@link FormFieldLeafCondition}
+ * or a boolean combination of rules. `anyOf` is OR (true when any nested rule
+ * holds); `allOf` is AND (true when every nested rule holds). Both nest
+ * arbitrarily, so you can mix them, e.g.
+ * `{ anyOf: [{ property: "a", op: ">=", value: 1 }, { property: "b", value: "1" }] }`.
+ * An empty `anyOf` is never required; an empty `allOf` is always required.
+ *
+ * Stripped from the LLM tool's `parameters` (see {@link toWireParameters}), but the
+ * full schema, `requiredWhen` included, still reaches the agent via the dynamic
+ * context so it knows when each field becomes required.
+ */
+declare type FormFieldCondition = FormFieldLeafCondition | {
+    anyOf: FormFieldCondition[];
+} | {
+    allOf: FormFieldCondition[];
+};
+
+/**
+ * A single leaf comparison. The field it guards becomes required exactly when the
+ * controlling `property` matches `value` against the answers collected so far:
  * - a single `value`, no `op` — equality (compared as strings);
  * - a single `value` with `op` — numeric comparison (both sides coerced to numbers);
  * - an array `value`, no `op` — "one of": matches when the property equals any
  *   listed value.
- *
- * SDK-only — it is stripped from the schema before it reaches the LLM tool
  */
-declare interface FormFieldCondition {
+declare interface FormFieldLeafCondition {
     /** The controlling field whose value the rule tests. */
     property: string;
     /** Comparison operator; omitted means equality. Ignored when `value` is an array. */
@@ -543,7 +558,8 @@ declare interface FormFieldSchema {
     default?: unknown;
     /**
      * Makes the field required only while this condition holds. Drives the dynamic
-     * `missing` list; stripped before the LLM tool — see {@link toWireParameters}.
+     * `missing` list; stripped from the LLM tool's `parameters` (still sent to the
+     * agent via dynamic context). See {@link toWireParameters}.
      */
     requiredWhen?: FormFieldCondition;
 }