@useago/sdk 0.3.3 → 0.3.4

package/dist/react.d.cts

@@ -359,8 +359,20 @@ export declare interface ChatWidgetProps {
     height?: string | number;
     /** URL of a logo to display in the header */
     logoUrl?: string;
-    /** Show the agent name above assistant messages. Defaults to `true`. */
+    /** Show the agent name above assistant messages. Defaults to `false`. */
     showAgentName?: boolean;
+    /**
+     * Conversational forms the agent can fill and submit during the chat. Each
+     * config is installed as a {@link createFormCollector} (its `update_<name>` /
+     * `submit_<name>` functions + dynamic context) for the lifetime of the widget.
+     */
+    forms?: CreateFormCollectorOptions[];
+    /**
+     * How clicking a suggested follow-up reply behaves. Defaults to sending the
+     * reply as a new user message. Pass a handler to override, or `false` to
+     * render the suggestions as non-interactive.
+     */
+    onFollowUpClick?: ((reply: string) => void) | false;
     /** Additional CSS class */
     className?: string;
     /** Callback when a message is sent */
@@ -455,7 +467,29 @@ export declare interface Conversation {
     messages?: AgoMessage[];
 }
 
-declare interface CreateFormCollectorOptions<V = Record<string, unknown>> {
+/**
+ * Wire one schema into a conversational form: an observable store, an
+ * `update_<name>` client function the agent calls to fill fields, a dynamic-context
+ * provider that tells the agent what's still missing, and an optional submit.
+ *
+ * ```ts
+ * const order = createFormCollector({
+ *   name: "order",
+ *   description: "The order the user wants to place",
+ *   schema: {
+ *     type: "object",
+ *     properties: { product: { type: "string" }, quantity: { type: "number" } },
+ *     required: ["product", "quantity"],
+ *   },
+ *   submit: { via: "client", url: "/api/orders" },
+ * });
+ * order.install(client);
+ * order.store.subscribe((s) => render(s));
+ * ```
+ */
+export declare function createFormCollector<V = Record<string, unknown>>(options: CreateFormCollectorOptions<V>): FormCollector<V>;
+
+export declare interface CreateFormCollectorOptions<V = Record<string, unknown>> {
     /** Short identifier; becomes the `update_<name>` / `submit_<name>` function names. */
     name: string;
     /** What the form is, for the LLM. */
@@ -488,7 +522,7 @@ export declare function createMockClient(options?: MockAgoClientOptions): MockAg
  */
 declare type DynamicContextProvider = () => ContextEntry | null | undefined;
 
-declare interface FormCollector<V = Record<string, unknown>> {
+export declare interface FormCollector<V = Record<string, unknown>> {
     name: string;
     /** Observable store driving the form UI (read via `useAgoStore`). */
     store: Store<FormCollectorState<V>>;
@@ -512,10 +546,10 @@ declare interface FormCollector<V = Record<string, unknown>> {
  * `parameters`, so one schema feeds the store, the update function, and the
  * dynamic context with no second type.
  */
-declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
+export declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
 
 /** Live state held in the collector's store. */
-declare interface FormCollectorState<V = Record<string, unknown>> {
+export declare interface FormCollectorState<V = Record<string, unknown>> {
     /** Field values collected so far. */
     values: Partial<V>;
     /** Required field names still empty. */
@@ -544,7 +578,7 @@ declare interface FormSchema {
 }
 
 /** Result returned by `submit()` / the generated `submit_<name>` function. */
-declare interface FormSubmitResult {
+export declare interface FormSubmitResult {
     ok: boolean;
     missing?: string[];
     result?: unknown;
@@ -569,8 +603,13 @@ export declare const Message: default_2.FC<MessageProps>;
 export declare interface MessageProps {
     message: AgoMessage;
     className?: string;
-    /** Show the agent name above assistant messages. Defaults to `true`. */
+    /** Show the agent name above assistant messages. Defaults to `false`. */
     showAgentName?: boolean;
+    /**
+     * Called when the user clicks a suggested follow-up reply. When omitted the
+     * follow-up buttons render but are not interactive (backwards-compatible).
+     */
+    onFollowUpClick?: (reply: string) => void;
 }
 
 declare type MessageStatus = "IN_PROGRESS" | "DONE" | "ERROR" | "TODO" | "CANCELED";
@@ -648,7 +687,7 @@ declare interface Store<T> {
  *   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 | {
+export declare type SubmitConfig<V = Record<string, unknown>> = string | {
     via: "client";
     url: string;
 } | {

package/dist/react.d.ts

@@ -359,8 +359,20 @@ export declare interface ChatWidgetProps {
     height?: string | number;
     /** URL of a logo to display in the header */
     logoUrl?: string;
-    /** Show the agent name above assistant messages. Defaults to `true`. */
+    /** Show the agent name above assistant messages. Defaults to `false`. */
     showAgentName?: boolean;
+    /**
+     * Conversational forms the agent can fill and submit during the chat. Each
+     * config is installed as a {@link createFormCollector} (its `update_<name>` /
+     * `submit_<name>` functions + dynamic context) for the lifetime of the widget.
+     */
+    forms?: CreateFormCollectorOptions[];
+    /**
+     * How clicking a suggested follow-up reply behaves. Defaults to sending the
+     * reply as a new user message. Pass a handler to override, or `false` to
+     * render the suggestions as non-interactive.
+     */
+    onFollowUpClick?: ((reply: string) => void) | false;
     /** Additional CSS class */
     className?: string;
     /** Callback when a message is sent */
@@ -455,7 +467,29 @@ export declare interface Conversation {
     messages?: AgoMessage[];
 }
 
-declare interface CreateFormCollectorOptions<V = Record<string, unknown>> {
+/**
+ * Wire one schema into a conversational form: an observable store, an
+ * `update_<name>` client function the agent calls to fill fields, a dynamic-context
+ * provider that tells the agent what's still missing, and an optional submit.
+ *
+ * ```ts
+ * const order = createFormCollector({
+ *   name: "order",
+ *   description: "The order the user wants to place",
+ *   schema: {
+ *     type: "object",
+ *     properties: { product: { type: "string" }, quantity: { type: "number" } },
+ *     required: ["product", "quantity"],
+ *   },
+ *   submit: { via: "client", url: "/api/orders" },
+ * });
+ * order.install(client);
+ * order.store.subscribe((s) => render(s));
+ * ```
+ */
+export declare function createFormCollector<V = Record<string, unknown>>(options: CreateFormCollectorOptions<V>): FormCollector<V>;
+
+export declare interface CreateFormCollectorOptions<V = Record<string, unknown>> {
     /** Short identifier; becomes the `update_<name>` / `submit_<name>` function names. */
     name: string;
     /** What the form is, for the LLM. */
@@ -488,7 +522,7 @@ export declare function createMockClient(options?: MockAgoClientOptions): MockAg
  */
 declare type DynamicContextProvider = () => ContextEntry | null | undefined;
 
-declare interface FormCollector<V = Record<string, unknown>> {
+export declare interface FormCollector<V = Record<string, unknown>> {
     name: string;
     /** Observable store driving the form UI (read via `useAgoStore`). */
     store: Store<FormCollectorState<V>>;
@@ -512,10 +546,10 @@ declare interface FormCollector<V = Record<string, unknown>> {
  * `parameters`, so one schema feeds the store, the update function, and the
  * dynamic context with no second type.
  */
-declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
+export declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
 
 /** Live state held in the collector's store. */
-declare interface FormCollectorState<V = Record<string, unknown>> {
+export declare interface FormCollectorState<V = Record<string, unknown>> {
     /** Field values collected so far. */
     values: Partial<V>;
     /** Required field names still empty. */
@@ -544,7 +578,7 @@ declare interface FormSchema {
 }
 
 /** Result returned by `submit()` / the generated `submit_<name>` function. */
-declare interface FormSubmitResult {
+export declare interface FormSubmitResult {
     ok: boolean;
     missing?: string[];
     result?: unknown;
@@ -569,8 +603,13 @@ export declare const Message: default_2.FC<MessageProps>;
 export declare interface MessageProps {
     message: AgoMessage;
     className?: string;
-    /** Show the agent name above assistant messages. Defaults to `true`. */
+    /** Show the agent name above assistant messages. Defaults to `false`. */
     showAgentName?: boolean;
+    /**
+     * Called when the user clicks a suggested follow-up reply. When omitted the
+     * follow-up buttons render but are not interactive (backwards-compatible).
+     */
+    onFollowUpClick?: (reply: string) => void;
 }
 
 declare type MessageStatus = "IN_PROGRESS" | "DONE" | "ERROR" | "TODO" | "CANCELED";
@@ -648,7 +687,7 @@ declare interface Store<T> {
  *   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 | {
+export declare type SubmitConfig<V = Record<string, unknown>> = string | {
     via: "client";
     url: string;
 } | {