@useago/sdk 0.4.7 → 1.0.1

package/dist/{AgoClient-BrYhSO5M.js → AgoClient-CZYNL25R.js}

@@ -14,11 +14,11 @@ var d = class extends Error {
   constructor(e, t) {
     super(e, "network_error"), this.originalError = t, this.name = "AgoNetworkError";
   }
-}, g = class extends d {
+}, m = class extends d {
   constructor(e) {
     super(e, "stream_error"), this.name = "AgoStreamError";
   }
-}, m = class extends d {
+}, g = class extends d {
   constructor(e, t, s) {
     super(e, "function_error"), this.functionName = t, this.originalError = s, this.name = "AgoFunctionError";
   }
@@ -133,10 +133,10 @@ var E = class {
   }
   register(e, t, s) {
     if (typeof e == "object") {
-      const { name: i, handler: o, description: a, parameters: l } = e;
+      const { name: i, handler: o, description: a, parameters: c } = e;
       return this.register(i, o, {
         description: a,
-        parameters: l
+        parameters: c
       });
     }
     const r = e;
@@ -164,13 +164,13 @@ var E = class {
   }
   async execute(e, t) {
     const s = this.functions.get(e);
-    if (!s) throw new m(`Function "${e}" is not registered`, e);
+    if (!s) throw new g(`Function "${e}" is not registered`, e);
     n.log(`Executing function: ${e}`, t);
     try {
       const r = await s.handler(t);
       return n.log(`Function ${e} completed:`, r), r;
     } catch (r) {
-      throw n.error(`Function ${e} failed:`, r), new m(`Function "${e}" execution failed: ${r instanceof Error ? r.message : "Unknown error"}`, e, r instanceof Error ? r : void 0);
+      throw n.error(`Function ${e} failed:`, r), new g(`Function "${e}" execution failed: ${r instanceof Error ? r.message : "Unknown error"}`, e, r instanceof Error ? r : void 0);
     }
   }
   clear() {
@@ -217,7 +217,7 @@ var E = class {
     this.callbacks = e, this.buffer = "", this.message = {}, this.toolCalls = [], this.sources = [], this.followUpReplies = [], this.isFirstChunk = !0, this.answerCompleteEmitted = !1;
   }
   async processStream(e) {
-    if (!e.body) throw new g("Response has no body");
+    if (!e.body) throw new m("Response has no body");
     const t = e.body.getReader(), s = new TextDecoder();
     try {
       for (; ; ) {
@@ -228,7 +228,7 @@ var E = class {
       }
       return this.buffer.trim() && this.processBuffer(), this.buildFinalMessage();
     } catch (r) {
-      const i = r instanceof Error ? r : new g("Stream processing failed");
+      const i = r instanceof Error ? r : new m("Stream processing failed");
       throw this.callbacks.onError?.(i), i;
     } finally {
       t.releaseLock();
@@ -376,14 +376,14 @@ var S = class {
       agent_id: s?.agentId || o
     };
     r.length > 0 && (a.client_functions = r), i && (a.client_context = i);
-    let l;
+    let c;
     if (s?.files && s.files.length > 0) {
-      const c = new FormData();
-      c.append("content", t), s.conversationId && c.append("conversation_id", s.conversationId), (s.agentId || o) && c.append("agent_id", s.agentId || o || ""), r.length > 0 && c.append("client_functions", JSON.stringify(r)), i && c.append("client_context", JSON.stringify(i));
-      for (const v of s.files) c.append("files", v);
-      l = await this.httpClient.postFormData("/api/sdk/v1/messages", c);
-    } else l = await this.httpClient.postStream("/api/sdk/v1/messages", a);
-    return this.processSSEResponse(l);
+      const l = new FormData();
+      l.append("content", t), s.conversationId && l.append("conversation_id", s.conversationId), (s.agentId || o) && l.append("agent_id", s.agentId || o || ""), r.length > 0 && l.append("client_functions", JSON.stringify(r)), i && l.append("client_context", JSON.stringify(i));
+      for (const v of s.files) l.append("files", v);
+      c = await this.httpClient.postFormData("/api/sdk/v1/messages", l);
+    } else c = await this.httpClient.postStream("/api/sdk/v1/messages", a);
+    return this.processSSEResponse(c);
   }
   async processSSEResponse(t) {
     return new k({
@@ -483,6 +483,15 @@ var S = class {
   async rejectToolCall(t) {
     await this.httpClient.post(`/api/tool-calls/${t}/reject/`);
   }
+  async getFormCollector(t) {
+    const s = await this.httpClient.get(`/api/sdk/v1/forms/${encodeURIComponent(t)}`);
+    return {
+      name: s.name,
+      description: s.description,
+      schema: s.schema,
+      submit: s.submit ?? void 0
+    };
+  }
   async submitFormCollector(t, s) {
     return this.httpClient.post("/api/sdk/v1/forms/submit", {
       destination: t,
@@ -509,10 +518,10 @@ var S = class {
     const r = s.map((o) => o.name), i = s.map((o) => `- "${o.name}": ${o.description}`).join(`
 `);
     this.registerFunction("navigateToPage", async (o) => {
-      const a = o.page, l = s.find((c) => c.name === a);
-      return l ? (t(l.path), {
+      const a = o.page, c = s.find((l) => l.name === a);
+      return c ? (t(c.path), {
         success: !0,
-        navigatedTo: l.path
+        navigatedTo: c.path
       }) : {
         success: !1,
         error: `Unknown page: ${a}`
@@ -590,7 +599,7 @@ export {
   _ as a,
   h as c,
   u as d,
-  g as f,
+  m as f,
   x as i,
   d as l,
   S as n,
@@ -598,5 +607,5 @@ export {
   k as r,
   n as s,
   $ as t,
-  m as u
+  g as u
 };

package/dist/angular.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-CPqPT5s6.cjs");var n=class{constructor(e){this.client=new o.AgoClient(e),this.messages$=this.fromEvent("message:complete"),this.chunks$=this.fromEvent("message:chunk"),this.errors$=this.fromEvent("message:error"),this.messageStart$=this.fromEvent("message:start")}fromEvent(e){const t=this.client;return{subscribe(i){const s=r=>{i.next?.(r)};return t.on(e,s),{unsubscribe:()=>t.off(e,s)}}}}sendMessage(e,t){return this.client.sendMessage(e,t)}getConversations(){return this.client.getConversations()}getConversation(e){return this.client.getConversation(e)}getMessages(e){return this.client.getMessages(e)}submitToolCallForm(e,t){return this.client.submitToolCallForm(e,t)}confirmToolCall(e){return this.client.confirmToolCall(e)}rejectToolCall(e){return this.client.rejectToolCall(e)}submitFeedback(e,t){return this.client.submitFeedback(e,t)}registerFunction(e,t,i){typeof e=="object"?this.client.registerFunction(e):this.client.registerFunction(e,t,i)}unregisterFunction(e){return this.client.unregisterFunction(e)}registerNavigationFunction(e,t){this.client.registerNavigationFunction(e,t)}on(e,t){this.client.on(e,t)}off(e,t){this.client.off(e,t)}updateConfig(e){this.client.updateConfig(e)}getClient(){return this.client}destroy(){this.client.destroy()}};function c(e){return{provide:n,useValue:new n(e)}}exports.AgoService=n;exports.provideAgo=c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-0x2Du_62.cjs");var n=class{constructor(e){this.client=new o.AgoClient(e),this.messages$=this.fromEvent("message:complete"),this.chunks$=this.fromEvent("message:chunk"),this.errors$=this.fromEvent("message:error"),this.messageStart$=this.fromEvent("message:start")}fromEvent(e){const t=this.client;return{subscribe(i){const s=r=>{i.next?.(r)};return t.on(e,s),{unsubscribe:()=>t.off(e,s)}}}}sendMessage(e,t){return this.client.sendMessage(e,t)}getConversations(){return this.client.getConversations()}getConversation(e){return this.client.getConversation(e)}getMessages(e){return this.client.getMessages(e)}submitToolCallForm(e,t){return this.client.submitToolCallForm(e,t)}confirmToolCall(e){return this.client.confirmToolCall(e)}rejectToolCall(e){return this.client.rejectToolCall(e)}submitFeedback(e,t){return this.client.submitFeedback(e,t)}registerFunction(e,t,i){typeof e=="object"?this.client.registerFunction(e):this.client.registerFunction(e,t,i)}unregisterFunction(e){return this.client.unregisterFunction(e)}registerNavigationFunction(e,t){this.client.registerNavigationFunction(e,t)}on(e,t){this.client.on(e,t)}off(e,t){this.client.off(e,t)}updateConfig(e){this.client.updateConfig(e)}getClient(){return this.client}destroy(){this.client.destroy()}};function c(e){return{provide:n,useValue:new n(e)}}exports.AgoService=n;exports.provideAgo=c;

package/dist/angular.d.cts

@@ -53,6 +53,13 @@ declare class AgoClient {
      * Reject a tool call
      */
     rejectToolCall(toolCallId: string): Promise<void>;
+    /**
+     * Fetch a backend-stored form collector definition by name (the single source
+     * of truth for the form's description, schema, and submit target). Used by
+     * `loadFormCollector` / the name-only form of `useFormCollector` so the schema
+     * lives in the backend instead of being hardcoded in client code.
+     */
+    getFormCollector(name: string): Promise<FormCollectorDefinition>;
     /**
      * Relay a completed form collector's values to a server-configured destination.
      *
@@ -477,6 +484,30 @@ export declare interface Conversation {
  */
 declare type DynamicContextProvider = () => ContextEntry | null | undefined;
 
+/**
+ * The backend-stored shape returned by `GET /api/sdk/v1/forms/{name}` (see
+ * {@link AgoClient.getFormCollector}). Mirrors the persistable subset of
+ * {@link CreateFormCollectorOptions}: the `submit` here is never the client-only
+ * `handler` variant (a function can't be stored server-side).
+ */
+declare interface FormCollectorDefinition<V = Record<string, unknown>> {
+    name: string;
+    description: string;
+    schema: FormCollectorSchema;
+    /** Server-stored submit target, if any. Absent means collect-only. */
+    submit?: SubmitConfig<V>;
+}
+
+/**
+ * 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.
+ */
+declare interface FormCollectorSchema {
+    type: "object";
+    properties: Record<string, FormFieldSchema>;
+    required?: string[];
+}
+
 declare interface FormField {
     type: "string" | "number" | "boolean" | "array";
     title?: string;
@@ -485,6 +516,43 @@ declare interface FormField {
     default?: unknown;
 }
 
+/**
+ * A field's conditional-requiredness rule. The field 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 {
+    /** The controlling field whose value the rule tests. */
+    property: string;
+    /** Comparison operator; omitted means equality. Ignored when `value` is an array. */
+    op?: ">=" | "<=" | ">" | "<";
+    /**
+     * The value(s) to test the controlling field against. A single value is an
+     * equality (or, with `op`, a numeric comparison); an array is an "is one of"
+     * membership test, e.g. `value: ["1", "2", "3"]`.
+     */
+    value: string | number | Array<string | number>;
+}
+
+/** A single field's schema: the wire-legal keys plus the SDK-only `requiredWhen`. */
+declare interface FormFieldSchema {
+    type: string;
+    description?: string;
+    enum?: string[];
+    default?: unknown;
+    /**
+     * Makes the field required only while this condition holds. Drives the dynamic
+     * `missing` list; stripped before the LLM tool — see {@link toWireParameters}.
+     */
+    requiredWhen?: FormFieldCondition;
+}
+
 /**
  * Form schema for tool calls requiring user input
  */
@@ -541,6 +609,27 @@ declare interface SendMessageOptions {
     files?: File[];
 }
 
+/**
+ * Where a completed form is sent.
+ * - `"https://..."` (a bare string) — shorthand for `{ via: "client", url }`: the browser
+ *   POSTs the values to that URL.
+ * - `{ via: "client", url }` — same, written out.
+ * - `{ via: "client", handler }` — the browser runs your own submit logic.
+ * - `{ via: "backend", destination }` — the browser relays the values to the backend,
+ *   which forwards them to the server-configured destination (URL + secret stay server-side).
+ * - `false` — collect only, no submit function.
+ */
+declare type SubmitConfig<V = Record<string, unknown>> = string | {
+    via: "client";
+    url: string;
+} | {
+    via: "client";
+    handler: (values: V) => Promise<unknown> | unknown;
+} | {
+    via: "backend";
+    destination: string;
+} | false;
+
 /**
  * Tool call data from SSE stream
  */

package/dist/angular.d.ts

@@ -53,6 +53,13 @@ declare class AgoClient {
      * Reject a tool call
      */
     rejectToolCall(toolCallId: string): Promise<void>;
+    /**
+     * Fetch a backend-stored form collector definition by name (the single source
+     * of truth for the form's description, schema, and submit target). Used by
+     * `loadFormCollector` / the name-only form of `useFormCollector` so the schema
+     * lives in the backend instead of being hardcoded in client code.
+     */
+    getFormCollector(name: string): Promise<FormCollectorDefinition>;
     /**
      * Relay a completed form collector's values to a server-configured destination.
      *
@@ -477,6 +484,30 @@ export declare interface Conversation {
  */
 declare type DynamicContextProvider = () => ContextEntry | null | undefined;
 
+/**
+ * The backend-stored shape returned by `GET /api/sdk/v1/forms/{name}` (see
+ * {@link AgoClient.getFormCollector}). Mirrors the persistable subset of
+ * {@link CreateFormCollectorOptions}: the `submit` here is never the client-only
+ * `handler` variant (a function can't be stored server-side).
+ */
+declare interface FormCollectorDefinition<V = Record<string, unknown>> {
+    name: string;
+    description: string;
+    schema: FormCollectorSchema;
+    /** Server-stored submit target, if any. Absent means collect-only. */
+    submit?: SubmitConfig<V>;
+}
+
+/**
+ * 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.
+ */
+declare interface FormCollectorSchema {
+    type: "object";
+    properties: Record<string, FormFieldSchema>;
+    required?: string[];
+}
+
 declare interface FormField {
     type: "string" | "number" | "boolean" | "array";
     title?: string;
@@ -485,6 +516,43 @@ declare interface FormField {
     default?: unknown;
 }
 
+/**
+ * A field's conditional-requiredness rule. The field 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 {
+    /** The controlling field whose value the rule tests. */
+    property: string;
+    /** Comparison operator; omitted means equality. Ignored when `value` is an array. */
+    op?: ">=" | "<=" | ">" | "<";
+    /**
+     * The value(s) to test the controlling field against. A single value is an
+     * equality (or, with `op`, a numeric comparison); an array is an "is one of"
+     * membership test, e.g. `value: ["1", "2", "3"]`.
+     */
+    value: string | number | Array<string | number>;
+}
+
+/** A single field's schema: the wire-legal keys plus the SDK-only `requiredWhen`. */
+declare interface FormFieldSchema {
+    type: string;
+    description?: string;
+    enum?: string[];
+    default?: unknown;
+    /**
+     * Makes the field required only while this condition holds. Drives the dynamic
+     * `missing` list; stripped before the LLM tool — see {@link toWireParameters}.
+     */
+    requiredWhen?: FormFieldCondition;
+}
+
 /**
  * Form schema for tool calls requiring user input
  */
@@ -541,6 +609,27 @@ declare interface SendMessageOptions {
     files?: File[];
 }
 
+/**
+ * Where a completed form is sent.
+ * - `"https://..."` (a bare string) — shorthand for `{ via: "client", url }`: the browser
+ *   POSTs the values to that URL.
+ * - `{ via: "client", url }` — same, written out.
+ * - `{ via: "client", handler }` — the browser runs your own submit logic.
+ * - `{ via: "backend", destination }` — the browser relays the values to the backend,
+ *   which forwards them to the server-configured destination (URL + secret stay server-side).
+ * - `false` — collect only, no submit function.
+ */
+declare type SubmitConfig<V = Record<string, unknown>> = string | {
+    via: "client";
+    url: string;
+} | {
+    via: "client";
+    handler: (values: V) => Promise<unknown> | unknown;
+} | {
+    via: "backend";
+    destination: string;
+} | false;
+
 /**
  * Tool call data from SSE stream
  */

package/dist/angular.js

@@ -1,4 +1,4 @@
-import { t as o } from "./AgoClient-BrYhSO5M.js";
+import { t as o } from "./AgoClient-CZYNL25R.js";
 var n = class {
   constructor(t) {
     this.client = new o(t), this.messages$ = this.fromEvent("message:complete"), this.chunks$ = this.fromEvent("message:chunk"), this.errors$ = this.fromEvent("message:error"), this.messageStart$ = this.fromEvent("message:start");

package/dist/{createConversationSession-CGRO0bs2.cjs → createConversationSession-BLZvXMmM.cjs}

@@ -1 +1 @@
-const d=require("./createFormCollector-DaWZsBsI.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-Ca8wRrxc.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-Dmqd80DX.js → createConversationSession-Bmqj2rSS.js}

@@ -1,4 +1,4 @@
-import { r as d } from "./createFormCollector-CPS2phYq.js";
+import { i as d } from "./createFormCollector-Bk0DRhUf.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-Bk0DRhUf.js

@@ -0,0 +1,257 @@
+import { s as _ } from "./AgoClient-CZYNL25R.js";
+function E(n, e) {
+  const i = e ? e.storage ?? (typeof localStorage < "u" ? localStorage : void 0) : void 0;
+  let t = n;
+  if (e && i) try {
+    const c = i.getItem(e.key);
+    c != null && (t = JSON.parse(c));
+  } catch {
+  }
+  const a = /* @__PURE__ */ new Set(), f = () => a.forEach((c) => c(t));
+  function d() {
+    if (e && i) try {
+      i.setItem(e.key, JSON.stringify(t));
+    } catch {
+    }
+  }
+  return {
+    get: () => t,
+    set: (c) => {
+      t = c, d(), f();
+    },
+    subscribe: (c) => (a.add(c), () => {
+      a.delete(c);
+    })
+  };
+}
+var F = /^[a-zA-Z0-9_-]{1,40}$/, O = (n) => n == null || n === "";
+function q(n, e) {
+  const i = e[n.property];
+  if (O(i)) return !1;
+  if (Array.isArray(n.value)) return n.value.some((f) => String(i) === String(f));
+  if (!n.op) return String(i) === String(n.value);
+  const t = Number(i), a = Number(n.value);
+  if (Number.isNaN(t) || Number.isNaN(a)) return !1;
+  switch (n.op) {
+    case ">=":
+      return t >= a;
+    case "<=":
+      return t <= a;
+    case ">":
+      return t > a;
+    case "<":
+      return t < a;
+    default:
+      return _.warn(`Unknown requiredWhen op "${n.op}"; treating as not required.`), !1;
+  }
+}
+function g(n, e) {
+  const i = n.properties ?? {}, t = /* @__PURE__ */ new Set();
+  for (const f of n.required ?? []) {
+    const d = i[f]?.requiredWhen;
+    (!d || q(d, e)) && t.add(f);
+  }
+  for (const [f, d] of Object.entries(i)) d.requiredWhen && q(d.requiredWhen, e) && t.add(f);
+  const a = [...t].filter((f) => O(e[f]));
+  return {
+    missing: a,
+    complete: a.length === 0
+  };
+}
+function P(n) {
+  const e = {};
+  for (const [i, t] of Object.entries(n.properties ?? {})) e[i] = {
+    type: t.type,
+    ...t.description != null && { description: t.description },
+    ...t.enum && { enum: t.enum },
+    ...t.default !== void 0 && { default: t.default }
+  };
+  return {
+    type: "object",
+    properties: e,
+    required: []
+  };
+}
+function W(n) {
+  const { name: e, description: i, schema: t } = n;
+  if (!F.test(e)) throw new Error(`Invalid form collector name "${e}": must match ${F} (it becomes the update_/submit_ function names).`);
+  const a = typeof n.submit == "string" ? n.submit ? {
+    via: "client",
+    url: n.submit
+  } : !1 : n.submit ?? !1, f = t.properties ?? {}, d = (r) => {
+    const s = {};
+    for (const [u, o] of Object.entries(r)) {
+      const l = f[u];
+      if (l)
+        if (o == null) s[u] = o;
+        else if (l.type === "number" || l.type === "integer") {
+          const h = typeof o == "number" ? o : Number(o);
+          s[u] = Number.isNaN(h) ? o : h;
+        } else l.type === "boolean" ? s[u] = typeof o == "boolean" ? o : o === "true" ? !0 : o === "false" ? !1 : !!o : s[u] = o;
+    }
+    return s;
+  }, c = n.initialValues ?? {}, m = E({
+    values: c,
+    submitted: !1
+  }), v = (r) => {
+    const s = m.get(), u = {
+      ...s,
+      values: {
+        ...s.values,
+        ...r
+      }
+    };
+    return m.set(u), u;
+  };
+  let b = null;
+  const N = async () => {
+    const { values: r } = m.get(), { complete: s, missing: u } = g(t, r);
+    if (!s) return {
+      ok: !1,
+      missing: u
+    };
+    if (!a) return {
+      ok: !1,
+      error: "No submit target configured for this form collector."
+    };
+    const o = r;
+    try {
+      let l;
+      if (a.via === "client") if ("handler" in a) l = await a.handler(o);
+      else {
+        const h = await fetch(a.url, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          credentials: "include",
+          body: JSON.stringify(o)
+        });
+        if (!h.ok) return {
+          ok: !1,
+          error: `Submit failed: HTTP ${h.status}`
+        };
+        l = await h.json().catch(() => {
+        });
+      }
+      else {
+        if (!b) return {
+          ok: !1,
+          error: "Backend submit requires install(client) (or useFormCollector) first."
+        };
+        l = await b.submitFormCollector(a.destination, o);
+      }
+      return m.set({
+        ...m.get(),
+        submitted: !0
+      }), {
+        ok: !0,
+        result: l
+      };
+    } catch (l) {
+      const h = l instanceof Error ? l.message : "Submit failed";
+      return _.error(`FormCollector "${e}" submit failed:`, l), {
+        ok: !1,
+        error: h
+      };
+    }
+  }, $ = {
+    name: `update_${e}`,
+    description: `Fill or update fields of the "${e}" form. ${i} 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: P(t),
+    handler: (r) => {
+      const s = v(d(r)), { missing: u } = g(t, s.values);
+      return {
+        ok: !0,
+        values: s.values,
+        missing: u
+      };
+    }
+  }, p = [$];
+  a && 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 T = "client__", S = a ? `submit_${e}` : null, x = (r) => {
+    const s = r.functionName ?? r.toolName;
+    if (s)
+      return s.startsWith(T) ? s.slice(8) : s;
+  }, w = (r) => {
+    let s = { ...c }, u = !1;
+    for (const o of r) {
+      const l = x(o);
+      l === $.name ? o.arguments && (s = {
+        ...s,
+        ...d(o.arguments)
+      }) : S && l === S && o.status?.toLowerCase() === "done" && (u = !0);
+    }
+    m.set({
+      values: s,
+      submitted: u
+    });
+  }, y = `form:${e}`, C = () => {
+    const { values: r, submitted: s } = m.get(), { missing: u, complete: o } = g(t, r), l = a ? ` When nothing is missing and the user confirms, call submit_${e}.` : "", h = s ? `The "${e}" form has been submitted.` : `You are currently collecting information from the user to fill the "${e}" form.`;
+    return {
+      name: `Form: ${e}`,
+      description: `${h} ${i} 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(t)}. Data collected so far: ${JSON.stringify(r)}. Call update_${e} with any fields the user provides; ask only for what is still missing.${l}`,
+      data: {
+        values: r,
+        missing: u,
+        complete: o,
+        submitted: s
+      }
+    };
+  }, k = (r) => {
+    w((r.messages ?? []).flatMap((s) => s.toolCalls ?? []));
+  };
+  return {
+    name: e,
+    store: m,
+    functions: p,
+    contextKey: y,
+    contextProvider: C,
+    install: (r) => {
+      b = r;
+      for (const u of p) r.register(u);
+      r.addDynamicContext(y, C);
+      const s = m.subscribe(() => r.notifyContextChanged());
+      return r.on("conversation:loaded", k), () => {
+        s();
+        for (const u of p) r.unregisterFunction(u.name);
+        r.removeDynamicContext(y), r.off("conversation:loaded", k), b === r && (b = null);
+      };
+    },
+    hydrate: w,
+    submit: N,
+    getValues: () => m.get().values,
+    setValues: (r) => {
+      v(d(r));
+    },
+    reset: () => {
+      m.set({
+        values: c,
+        submitted: !1
+      });
+    },
+    getStatus: () => g(t, m.get().values)
+  };
+}
+async function V(n, e) {
+  const i = await n.getFormCollector(e.name);
+  return W({
+    name: i.name,
+    description: e.description ?? i.description,
+    schema: e.schema ?? i.schema,
+    submit: e.submit ?? i.submit,
+    initialValues: e.initialValues
+  });
+}
+export {
+  E as i,
+  g as n,
+  V as r,
+  W as t
+};

package/dist/createFormCollector-Ca8wRrxc.cjs

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