@useago/sdk 1.7.1 → 1.9.0

package/CHANGELOG.md

@@ -5,6 +5,96 @@ All notable changes to `@useago/sdk` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.0] - 2026-08-28
+
+### Changed
+
+- **`setPageState` result shape.** `applied` is now an array of field names
+  (was a value map). The result also includes `unchanged: string[]` (always
+  present) and `rejected?: Record<string, string>` (present when any field was
+  refused). `success` is `false` when `rejected` is non-empty, `true` otherwise.
+
+### Added
+
+- **Per-field validation.** `setPageState` validates each field's type and enum
+  against the declared schema before calling `set()`. Unknown control names are
+  rejected with the list of available controls. A value equal to the current
+  `get()` is skipped without calling `set()`.
+- **Placeholder dropping.** `null`, `undefined`, and `""` are silently dropped
+  instead of being applied. They appear in no result bucket.
+- **`clearable` option on string controls.** When set, `""` means "clear the
+  field" and is applied instead of dropped. The SDK adds `""` to the enum (if
+  one exists) and appends a clearing hint to the description.
+- **Tagged setter outcomes.** `set()` can return `{ result: "rejected", reason }`
+  to refuse a value, or `{ result: "unchanged" }` to signal the field already
+  holds the requested state. Returning nothing (void) means applied.
+- **Result budget preservation.** When the result exceeds `maxResultBytes`, the
+  SDK preserves `success`, `applied`, `unchanged`, and `rejected` keys before
+  truncating `data`. Without a data source, oversized rejection reasons are
+  shortened in order rather than replaced wholesale.
+- **React `useAgoPageState` re-registration.** The hook re-registers when a
+  control's model-visible signature changes (name, description, schema,
+  `clearable`), so an enum populated by an async fetch updates the advertised
+  schema and runtime validation.
+- **Dev panel local function runner.** `initDevPanel({ enableFunctionRunner: true })`
+  adds a runner that executes registered functions locally via
+  `executeClientFunction`. The function list tracks route changes and the
+  diagnostic sections are collapsible.
+- **Dev panel disposal.** `initDevPanel` now returns an idempotent disposer that
+  removes its panels and unsubscribes all event handlers. Return it from a React
+  effect to keep one connected panel under Strict Mode.
+
+## [1.8.0] - 2026-08-11
+
+### Added
+
+- User feedback: a visitor can say that an answer, or a whole conversation, does
+  not work, and the report reaches the AGO feedback dashboard.
+  - `client.submitFeedback(messageId, rating, { reasons, comment })` now takes
+    what went wrong on top of the thumb. `reasons` is any of `"inaccurate"`,
+    `"incomplete"`, `"information_not_found"`, `"technical_issue"` (exported as
+    `FEEDBACK_REASONS`).
+  - `client.submitConversationFeedback(conversationId, rating, details?)` reports
+    a whole chat. Feedback is stored per message, so it attaches to the
+    conversation's last answer and returns that message id; pass
+    `details.lastMessageId` to skip the lookup.
+  - `feedback: true` on `mountChatWidget`, and `<ChatWidget feedback />`, render
+    a thumbs row under each finished answer with a "what went wrong?" panel on a
+    thumbs-down. Every string is overridable (`labels`), `askWhy: false` keeps
+    thumbs only, and `onSubmit` / `onError` report what went out.
+  - React: `useFeedback()` and `<MessageFeedback messageId={...} />`. Vue:
+    `useFeedback()`. Angular: `AgoService.submitFeedback` /
+    `submitConversationFeedback`.
+
+### Notes
+
+- The details need a backend that accepts them.
+  `POST /api/sdk/v1/messages/{id}/feedback` used to take `rating` only and
+  silently dropped everything else, so reasons and comments never reached the
+  dashboard. It now also takes `reasons` and `comment` and writes the same
+  feedback record the in-app modal creates. The demo account
+  (`https://playground.api.useago.com`) already runs it; a self-hosted tenant on
+  an older build still accepts the rating and ignores the details.
+
+## [1.7.2] - 2026-08-10
+
+### Changed
+
+- Every "try the SDK" instruction now points at the same public demo account
+  (`https://playground.api.useago.com`, agent `generic-guide`). The examples
+  under `examples/` still pointed at a second backend, so a reader following the
+  README and a reader cloning an example were testing against different
+  tenants. Docs, README, and examples now agree, and the wording is "demo
+  account" everywhere instead of a mix of "live demo", "demo backend", and
+  "demo endpoint".
+- The `config_missing_base_url` error hint names the demo account and its agent
+  slug, so the message is copy-pasteable on its own.
+- The copy-paste prompt for coding agents in the README now installs the SDK and
+  names the demo agent to wire up (`https://playground.api.useago.com`, agent
+  `generic-guide`). It only told the agent to read `llms-full.txt` and
+  integrate, so the install was implicit and the agent had to pick a `baseUrl`
+  and slug on its own. Pasting the prompt now ends on a chat that answers.
+
 ## [1.7.1] - 2026-08-10
 
 ### Fixed

package/README.md

@@ -24,8 +24,11 @@ resolve customer needs, without rebuilding the full customer-facing agent platfo
 > this into your agent and let it do the integration:
 >
 > ```text
-> Read https://raw.githubusercontent.com/useago/ago-sdk/refs/heads/main/llms-full.txt
-> and integrate the AGO chat SDK into this app.
+> Install the AGO chat SDK in this app: npm install @useago/sdk
+> Then read https://raw.githubusercontent.com/useago/ago-sdk/refs/heads/main/llms-full.txt
+> and wire up a working chat against the public demo agent:
+> baseUrl https://playground.api.useago.com, agent generic-guide.
+> It answers straight away, with no signup and no API key.
 > ```
 
 In two minutes you'll have a working chat on your page and an agent that can
@@ -64,8 +67,10 @@ export default function App() {
 ```
 
 Start your dev server. A chat panel renders on the page; type a message and
-watch the reply stream in. That's a complete integration. (`generic-guide` is a
-public demo agent; swap `baseUrl` and `agent` for your own once you have a tenant.)
+watch the reply stream in. That's a complete integration. (This is the public
+demo account: `https://playground.api.useago.com` with agent `generic-guide`. It
+needs no signup and no API key. Swap `baseUrl` and `agent` for your own once you
+have a tenant.)
 
 `ChatWidget` is the high-level component to get started in minutes. Everything it
 does is also exposed through hooks and APIs (`useChat`, `useMessages`, the raw
@@ -143,7 +148,12 @@ function InvoiceList() {
 Each control becomes one optional property of a single `setPageState` function,
 so the agent changes only what the user asked for. The current value from each
 `get()` is sent with every message, so the agent knows the state before it
-changes it. Vue and Angular have the same helper.
+changes it. The SDK validates type and enum before calling `set()`, skips values
+that match the current `get()`, and drops placeholders (`null`, `undefined`,
+`""`). The result reports each field in `applied`, `unchanged`, or `rejected`.
+Vue and Angular have the same helper. See
+[Page state shortcut](docs/general/functions-and-context.md#page-state-shortcut)
+for `clearable`, tagged setter outcomes, and the full result envelope.
 
 Add a `data` source and the agent also gets back **what the page now shows**, as
 the result of its own call, so it can answer "did you find dupont?" in the same
@@ -257,6 +267,43 @@ with that partial message instead of rejecting. Vue and Angular have the same
 `stop`, and the vanilla `mountChatWidget` handle gained `stop()`. Details in
 [Stop the answer](docs/general/core.md#stop-the-answer).
 
+## Let the user say "this answer doesn't work"
+
+Pass `feedback` and every finished answer gets a thumbs up / thumbs down. On a
+thumbs-down, a panel asks what went wrong: four reason chips
+(inaccurate, incomplete, information not found, technical issue) and a comment
+box.
+
+```tsx
+<ChatWidget feedback />
+```
+
+```ts
+// vanilla widget
+mountChatWidget("#chat", { config, feedback: true });
+```
+
+The thumb is sent the moment it is clicked, so the signal survives a user who
+ignores the panel. A bare rating is a reaction; a report with a reason or a
+comment also lands in the AGO feedback dashboard, the analytics and the CSV
+export, where someone can act on it.
+
+Driving it yourself, from any framework:
+
+```ts
+await ago.submitFeedback(messageId, "negative", {
+  reasons: ["inaccurate"],
+  comment: "The price it quoted is from last year.",
+});
+
+// the whole chat, not one answer (attached to its last answer)
+await ago.submitConversationFeedback(conversationId, "negative");
+```
+
+React and Vue have a `useFeedback()` hook/composable; React also exports the
+`<MessageFeedback messageId={...} />` row for a custom message list. Details in
+[Feedback](docs/general/widget.md#feedback).
+
 ## Show the source docs the agent retrieved
 
 Each assistant message carries the knowledge sources it used in `m.sources`
@@ -313,7 +360,7 @@ cd examples/simple-react
 npm install && npm run dev
 ```
 
-The examples ship pre-configured against the demo backend, so they answer
+The examples ship pre-configured against the demo account, so they answer
 immediately. [`examples/`](examples/) has one per stack: React (with
 react-router navigation), Vue, Angular, plain TypeScript, and no-build HTML.
 

package/dist/angular.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-B_u_d-XS.cjs"),c=require("./autoContinue-CP9pJR-V.cjs");var n=class{constructor(t){this.client=new o.AgoClient(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")}fromEvent(t){const e=this.client;return{subscribe(i){const s=r=>{i.next?.(r)};return e.on(t,s),{unsubscribe:()=>e.off(t,s)}}}}sendMessage(t,e){return this.client.sendMessage(t,e)}stop(){return this.client.stop()}stopMessage(t){return this.client.stopMessage(t)}isGenerating(){return this.client.isGenerating()}getConversations(){return this.client.getConversations().then(t=>t.data)}getConversation(t){return this.client.getConversation(t)}getMessages(t){return this.client.getMessages(t)}submitToolCallForm(t,e){return this.client.submitToolCallForm(t,e)}confirmToolCall(t){return this.client.confirmToolCall(t)}rejectToolCall(t){return this.client.rejectToolCall(t)}submitFeedback(t,e){return this.client.submitFeedback(t,e)}registerFunction(t,e,i){typeof t=="object"?this.client.registerFunction(t):this.client.registerFunction(t,e,i)}unregisterFunction(t){return this.client.unregisterFunction(t)}registerNavigationFunction(t,e){this.client.registerNavigationFunction(t,e)}unregisterNavigationFunction(){this.client.unregisterNavigationFunction()}enableAutoContinueAfterNavigation(t){return c.attachAutoContinueAfterNavigation(this.client,t)}registerPageStateFunction(t,e){this.client.registerPageStateFunction(t,e)}unregisterPageStateFunction(t){this.client.unregisterPageStateFunction(t)}on(t,e){this.client.on(t,e)}off(t,e){this.client.off(t,e)}updateConfig(t){this.client.updateConfig(t)}getClient(){return this.client}destroy(){this.client.destroy()}};function u(t){return{provide:n,useValue:new n(t)}}exports.AgoService=n;exports.provideAgo=u;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./types-D3YQl1jx.cjs"),c=require("./autoContinue-CP9pJR-V.cjs");var n=class{constructor(t){this.client=new r.AgoClient(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")}fromEvent(t){const e=this.client;return{subscribe(i){const s=o=>{i.next?.(o)};return e.on(t,s),{unsubscribe:()=>e.off(t,s)}}}}sendMessage(t,e){return this.client.sendMessage(t,e)}stop(){return this.client.stop()}stopMessage(t){return this.client.stopMessage(t)}isGenerating(){return this.client.isGenerating()}getConversations(){return this.client.getConversations().then(t=>t.data)}getConversation(t){return this.client.getConversation(t)}getMessages(t){return this.client.getMessages(t)}submitToolCallForm(t,e){return this.client.submitToolCallForm(t,e)}confirmToolCall(t){return this.client.confirmToolCall(t)}rejectToolCall(t){return this.client.rejectToolCall(t)}submitFeedback(t,e,i){return this.client.submitFeedback(t,e,i)}submitConversationFeedback(t,e,i){return this.client.submitConversationFeedback(t,e,i)}registerFunction(t,e,i){typeof t=="object"?this.client.registerFunction(t):this.client.registerFunction(t,e,i)}unregisterFunction(t){return this.client.unregisterFunction(t)}registerNavigationFunction(t,e){this.client.registerNavigationFunction(t,e)}unregisterNavigationFunction(){this.client.unregisterNavigationFunction()}enableAutoContinueAfterNavigation(t){return c.attachAutoContinueAfterNavigation(this.client,t)}registerPageStateFunction(t,e){this.client.registerPageStateFunction(t,e)}unregisterPageStateFunction(t){this.client.unregisterPageStateFunction(t)}on(t,e){this.client.on(t,e)}off(t,e){this.client.off(t,e)}updateConfig(t){this.client.updateConfig(t)}getClient(){return this.client}destroy(){this.client.destroy()}};function u(t){return{provide:n,useValue:new n(t)}}exports.AgoService=n;exports.FEEDBACK_REASONS=r.FEEDBACK_REASONS;exports.provideAgo=u;

package/dist/angular.d.cts

@@ -290,9 +290,40 @@ declare class AgoClient {
      */
     submitFormCollector(name: string, values: Record<string, unknown>): Promise<unknown>;
     /**
-     * Submit feedback for a message
+     * Report an answer: thumbs up/down, optionally with what went wrong.
+     *
+     * ```ts
+     * await client.submitFeedback(message.id, "negative", {
+     *   reasons: ["inaccurate"],
+     *   comment: "The price it quoted is from last year.",
+     * });
+     * ```
+     *
+     * A bare rating is a reaction (the thumbs counted in the dashboard). Adding a
+     * reason or a comment also files it in the feedback list, the analytics and
+     * the CSV export, so someone can act on it.
      */
-    submitFeedback(messageId: string, rating: "positive" | "negative"): Promise<void>;
+    submitFeedback(messageId: string, rating: FeedbackRating, details?: FeedbackDetails): Promise<void>;
+    /**
+     * Report a whole conversation ("this chat is not working").
+     *
+     * ```ts
+     * await client.submitConversationFeedback(conversationId, "negative", {
+     *   reasons: ["information_not_found"],
+     *   comment: "It never answered my question.",
+     * });
+     * ```
+     *
+     * Feedback is stored per message, so this attaches the report to the last
+     * answer of the conversation, which is the one the user is reacting to.
+     * Returns the message id it landed on.
+     *
+     * Pass `lastMessageId` when you already have it (the widget does) to skip the
+     * lookup round-trip.
+     */
+    submitConversationFeedback(conversationId: string, rating: FeedbackRating, details?: FeedbackDetails & {
+        lastMessageId?: string;
+    }): Promise<string>;
     /**
      * Register a client-side function that AGO can call.
      * Accepts either a definition object or (name, handler, schema) args.
@@ -969,8 +1000,12 @@ export declare class AgoService {
     confirmToolCall(toolCallId: string): Promise<void>;
     /** Reject a tool call */
     rejectToolCall(toolCallId: string): Promise<void>;
-    /** Submit feedback for a message */
-    submitFeedback(messageId: string, rating: "positive" | "negative"): Promise<void>;
+    /** Report an answer: thumbs up/down, optionally with what went wrong */
+    submitFeedback(messageId: string, rating: FeedbackRating, details?: FeedbackDetails): Promise<void>;
+    /** Report a whole conversation; lands on its last answer, whose id is returned */
+    submitConversationFeedback(conversationId: string, rating: FeedbackRating, details?: FeedbackDetails & {
+        lastMessageId?: string;
+    }): Promise<string>;
     /** Register a client-side function */
     registerFunction(definition: ClientFunctionDefinition): void;
     registerFunction(name: string, handler: ClientFunctionHandler, schema: ClientFunctionRegisterOptions): void;
@@ -1054,12 +1089,27 @@ export declare interface AgoStateControl<T = unknown> {
             enum?: (string | number)[];
         };
     };
+    /** String-only: `""` means "clear" instead of being dropped as filler. */
+    clearable?: boolean;
     /** Current value → pushed as dynamic context so the agent knows what to change. */
     get?: () => T;
     /** Apply the state change on the page. May be async. */
-    set: (value: T) => void | Promise<void>;
+    set: (value: T) => void | AgoStateSetResult | Promise<void | AgoStateSetResult>;
 }
 
+/**
+ * Tagged outcome a page setter may return to reject or mark unchanged.
+ *
+ * Returning nothing (void) means APPLY. Returning an unrecognized JS value
+ * (e.g. a string from an assignment expression) is also treated as APPLY.
+ */
+declare type AgoStateSetResult = {
+    result: "rejected";
+    reason: string;
+} | {
+    result: "unchanged";
+};
+
 /**
  * Single-object function definition — combines name, schema, and handler.
  *
@@ -1200,6 +1250,40 @@ export declare interface Conversation {
  */
 declare type DynamicContextProvider = () => ContextEntry | null | undefined;
 
+/** The four values of {@link FeedbackReason}, in dashboard order. */
+export declare const FEEDBACK_REASONS: readonly FeedbackReason[];
+
+/**
+ * Why the user is reporting a message (see `AgoClient.submitFeedback`).
+ *
+ * A rating on its own is a reaction (the thumbs count). Add a reason or a
+ * comment and the report also lands in the feedback dashboard, the analytics
+ * and the CSV export, where someone can act on it.
+ */
+export declare interface FeedbackDetails {
+    /** What went wrong. Several can apply at once. */
+    reasons?: FeedbackReason[];
+    /** The user's own words. Trimmed server-side; 5000 characters max. */
+    comment?: string;
+}
+
+/** Thumbs up / thumbs down on an answer. */
+export declare type FeedbackRating = "positive" | "negative";
+
+/**
+ * What went wrong with an answer. These are the four buckets the AGO feedback
+ * dashboard filters and charts on.
+ */
+export declare type FeedbackReason = 
+/** The answer states something false. */
+"inaccurate"
+/** The answer is right but stops short. */
+| "incomplete"
+/** The agent could not find the information. */
+| "information_not_found"
+/** Something broke: the widget, a tool call, the stream. */
+| "technical_issue";
+
 /**
  * The backend-stored shape returned by `GET /api/sdk/v1/forms/{name}` (see
  * {@link AgoClient.getFormCollector}). Mirrors the persistable subset of

package/dist/angular.d.ts

@@ -290,9 +290,40 @@ declare class AgoClient {
      */
     submitFormCollector(name: string, values: Record<string, unknown>): Promise<unknown>;
     /**
-     * Submit feedback for a message
+     * Report an answer: thumbs up/down, optionally with what went wrong.
+     *
+     * ```ts
+     * await client.submitFeedback(message.id, "negative", {
+     *   reasons: ["inaccurate"],
+     *   comment: "The price it quoted is from last year.",
+     * });
+     * ```
+     *
+     * A bare rating is a reaction (the thumbs counted in the dashboard). Adding a
+     * reason or a comment also files it in the feedback list, the analytics and
+     * the CSV export, so someone can act on it.
      */
-    submitFeedback(messageId: string, rating: "positive" | "negative"): Promise<void>;
+    submitFeedback(messageId: string, rating: FeedbackRating, details?: FeedbackDetails): Promise<void>;
+    /**
+     * Report a whole conversation ("this chat is not working").
+     *
+     * ```ts
+     * await client.submitConversationFeedback(conversationId, "negative", {
+     *   reasons: ["information_not_found"],
+     *   comment: "It never answered my question.",
+     * });
+     * ```
+     *
+     * Feedback is stored per message, so this attaches the report to the last
+     * answer of the conversation, which is the one the user is reacting to.
+     * Returns the message id it landed on.
+     *
+     * Pass `lastMessageId` when you already have it (the widget does) to skip the
+     * lookup round-trip.
+     */
+    submitConversationFeedback(conversationId: string, rating: FeedbackRating, details?: FeedbackDetails & {
+        lastMessageId?: string;
+    }): Promise<string>;
     /**
      * Register a client-side function that AGO can call.
      * Accepts either a definition object or (name, handler, schema) args.
@@ -969,8 +1000,12 @@ export declare class AgoService {
     confirmToolCall(toolCallId: string): Promise<void>;
     /** Reject a tool call */
     rejectToolCall(toolCallId: string): Promise<void>;
-    /** Submit feedback for a message */
-    submitFeedback(messageId: string, rating: "positive" | "negative"): Promise<void>;
+    /** Report an answer: thumbs up/down, optionally with what went wrong */
+    submitFeedback(messageId: string, rating: FeedbackRating, details?: FeedbackDetails): Promise<void>;
+    /** Report a whole conversation; lands on its last answer, whose id is returned */
+    submitConversationFeedback(conversationId: string, rating: FeedbackRating, details?: FeedbackDetails & {
+        lastMessageId?: string;
+    }): Promise<string>;
     /** Register a client-side function */
     registerFunction(definition: ClientFunctionDefinition): void;
     registerFunction(name: string, handler: ClientFunctionHandler, schema: ClientFunctionRegisterOptions): void;
@@ -1054,12 +1089,27 @@ export declare interface AgoStateControl<T = unknown> {
             enum?: (string | number)[];
         };
     };
+    /** String-only: `""` means "clear" instead of being dropped as filler. */
+    clearable?: boolean;
     /** Current value → pushed as dynamic context so the agent knows what to change. */
     get?: () => T;
     /** Apply the state change on the page. May be async. */
-    set: (value: T) => void | Promise<void>;
+    set: (value: T) => void | AgoStateSetResult | Promise<void | AgoStateSetResult>;
 }
 
+/**
+ * Tagged outcome a page setter may return to reject or mark unchanged.
+ *
+ * Returning nothing (void) means APPLY. Returning an unrecognized JS value
+ * (e.g. a string from an assignment expression) is also treated as APPLY.
+ */
+declare type AgoStateSetResult = {
+    result: "rejected";
+    reason: string;
+} | {
+    result: "unchanged";
+};
+
 /**
  * Single-object function definition — combines name, schema, and handler.
  *
@@ -1200,6 +1250,40 @@ export declare interface Conversation {
  */
 declare type DynamicContextProvider = () => ContextEntry | null | undefined;
 
+/** The four values of {@link FeedbackReason}, in dashboard order. */
+export declare const FEEDBACK_REASONS: readonly FeedbackReason[];
+
+/**
+ * Why the user is reporting a message (see `AgoClient.submitFeedback`).
+ *
+ * A rating on its own is a reaction (the thumbs count). Add a reason or a
+ * comment and the report also lands in the feedback dashboard, the analytics
+ * and the CSV export, where someone can act on it.
+ */
+export declare interface FeedbackDetails {
+    /** What went wrong. Several can apply at once. */
+    reasons?: FeedbackReason[];
+    /** The user's own words. Trimmed server-side; 5000 characters max. */
+    comment?: string;
+}
+
+/** Thumbs up / thumbs down on an answer. */
+export declare type FeedbackRating = "positive" | "negative";
+
+/**
+ * What went wrong with an answer. These are the four buckets the AGO feedback
+ * dashboard filters and charts on.
+ */
+export declare type FeedbackReason = 
+/** The answer states something false. */
+"inaccurate"
+/** The answer is right but stops short. */
+| "incomplete"
+/** The agent could not find the information. */
+| "information_not_found"
+/** Something broke: the widget, a tool call, the stream. */
+| "technical_issue";
+
 /**
  * The backend-stored shape returned by `GET /api/sdk/v1/forms/{name}` (see
  * {@link AgoClient.getFormCollector}). Mirrors the persistable subset of

package/dist/angular.js

@@ -1,5 +1,5 @@
-import { t as o } from "./AgoClient-BJjLTOw4.js";
-import { t as c } from "./autoContinue-CC8K9mBU.js";
+import { n as o, t as u } from "./types-CPga11Of.js";
+import { t as a } from "./autoContinue-CC8K9mBU.js";
 var s = 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");
@@ -43,8 +43,11 @@ var s = class {
   rejectToolCall(t) {
     return this.client.rejectToolCall(t);
   }
-  submitFeedback(t, e) {
-    return this.client.submitFeedback(t, e);
+  submitFeedback(t, e, i) {
+    return this.client.submitFeedback(t, e, i);
+  }
+  submitConversationFeedback(t, e, i) {
+    return this.client.submitConversationFeedback(t, e, i);
   }
   registerFunction(t, e, i) {
     typeof t == "object" ? this.client.registerFunction(t) : this.client.registerFunction(t, e, i);
@@ -59,7 +62,7 @@ var s = class {
     this.client.unregisterNavigationFunction();
   }
   enableAutoContinueAfterNavigation(t) {
-    return c(this.client, t);
+    return a(this.client, t);
   }
   registerPageStateFunction(t, e) {
     this.client.registerPageStateFunction(t, e);
@@ -83,7 +86,7 @@ var s = class {
     this.client.destroy();
   }
 };
-function l(t) {
+function g(t) {
   return {
     provide: s,
     useValue: new s(t)
@@ -91,5 +94,6 @@ function l(t) {
 }
 export {
   s as AgoService,
-  l as provideAgo
+  u as FEEDBACK_REASONS,
+  g as provideAgo
 };

package/dist/{createConversationSession-Bgvx753t.js → createConversationSession-BaaXBQ5b.js}

@@ -1,4 +1,4 @@
-import { h as d } from "./AgoClient-BJjLTOw4.js";
+import { g as d } from "./types-CPga11Of.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) => {
@@ -6,7 +6,7 @@ function v() {
     return (e === "x" ? r : r & 3 | 8).toString(16);
   });
 }
-function h(e = {}) {
+function D(e = {}) {
   const r = e.key ?? f, c = e.threadKey ?? g, u = e.ttlMs ?? y, l = e.storage ?? (typeof localStorage < "u" ? localStorage : void 0);
   let n = e.widgetId ?? "";
   if (!n && l) try {
@@ -54,5 +54,5 @@ function h(e = {}) {
   };
 }
 export {
-  h as t
+  D as t
 };

package/dist/createConversationSession-CU0b-t1W.cjs

@@ -0,0 +1 @@
+const d=require("./types-D3YQl1jx.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}),s=o.get();s.value!==null&&c(s.lastMessageAt)&&o.set({value:null,lastMessageAt:null});function c(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||c(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/{createFormCollector-CM3qjGcM.js → createFormCollector-Cf7kGhCB.js}

@@ -1,4 +1,4 @@
-import { h as R, v as w } from "./AgoClient-BJjLTOw4.js";
+import { g as R, y as w } from "./types-CPga11Of.js";
 var j = /^[a-zA-Z0-9_-]{1,40}$/, V = (s) => s == null || s === "";
 function S(s, e) {
   if ("anyOf" in s) return s.anyOf.some((c) => S(c, e));

package/dist/createFormCollector-DfN1xZBy.cjs

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

package/dist/{createMockClient-BDLW6tVc.js → createMockClient-5YF-ZbVu.js}

@@ -1,5 +1,5 @@
-function y(g = {}) {
-  const { overrides: u = {} } = g, a = {
+function y(u = {}) {
+  const { overrides: g = {} } = u, a = {
     id: "mock-msg-1",
     conversationId: "mock-conv-1",
     content: "Mock response",
@@ -10,7 +10,7 @@ function y(g = {}) {
     id: "mock-conv-1",
     title: "Mock Conversation",
     lastMessageDate: /* @__PURE__ */ new Date()
-  }, o = /* @__PURE__ */ new Map(), c = [], m = {
+  }, n = /* @__PURE__ */ new Map(), c = [], m = {
     sendMessage: async () => a,
     continueMessage: async () => a,
     stop: async () => null,
@@ -29,6 +29,7 @@ function y(g = {}) {
     },
     submitFeedback: async () => {
     },
+    submitConversationFeedback: async () => a.id,
     registerFunction: () => {
     },
     unregisterFunction: () => !0,
@@ -55,44 +56,44 @@ function y(g = {}) {
       post: async () => ({})
     }),
     emitProactiveEvent: (e, t) => {
-      const n = o.get(e);
-      n && [...n].forEach((s) => s(t));
+      const o = n.get(e);
+      o && [...o].forEach((s) => s(t));
     },
     on: (e, t) => {
-      o.has(e) || o.set(e, /* @__PURE__ */ new Set()), o.get(e).add(t);
+      n.has(e) || n.set(e, /* @__PURE__ */ new Set()), n.get(e).add(t);
     },
     off: (e, t) => {
-      o.get(e)?.delete(t);
+      n.get(e)?.delete(t);
     },
     once: (e, t) => {
-      const n = (...s) => {
-        o.get(e)?.delete(n), t(...s);
+      const o = (...s) => {
+        n.get(e)?.delete(o), t(...s);
       };
-      o.has(e) || o.set(e, /* @__PURE__ */ new Set()), o.get(e).add(n);
+      n.has(e) || n.set(e, /* @__PURE__ */ new Set()), n.get(e).add(o);
     },
-    waitFor: (e, t) => new Promise((n, s) => {
+    waitFor: (e, t) => new Promise((o, s) => {
       let r;
       const d = (f) => {
-        r && clearTimeout(r), o.get(e)?.delete(d), n(f);
+        r && clearTimeout(r), n.get(e)?.delete(d), o(f);
       };
-      o.has(e) || o.set(e, /* @__PURE__ */ new Set()), o.get(e).add(d), t?.timeout && (r = setTimeout(() => {
-        o.get(e)?.delete(d), s(/* @__PURE__ */ new Error(`waitFor("${e}") timed out after ${t.timeout}ms`));
+      n.has(e) || n.set(e, /* @__PURE__ */ new Set()), n.get(e).add(d), t?.timeout && (r = setTimeout(() => {
+        n.get(e)?.delete(d), s(/* @__PURE__ */ new Error(`waitFor("${e}") timed out after ${t.timeout}ms`));
       }, t.timeout));
     }),
     updateConfig: () => {
     },
     destroy: () => {
-      o.clear();
+      n.clear();
     },
-    ...u
+    ...g
   }, i = {};
-  for (const [e, t] of Object.entries(m)) i[e] = (...n) => (c.push({
+  for (const [e, t] of Object.entries(m)) i[e] = (...o) => (c.push({
     method: e,
-    args: n
-  }), t(...n));
+    args: o
+  }), t(...o));
   return i.proactive = null, i.__calls = c, i.__callsFor = (e) => c.filter((t) => t.method === e), i.__emitEvent = (e, t) => {
-    const n = o.get(e);
-    n && [...n].forEach((s) => s(t));
+    const o = n.get(e);
+    o && [...o].forEach((s) => s(t));
   }, i;
 }
 export {

package/dist/createMockClient-BZbOe-23.cjs

@@ -0,0 +1 @@
+function y(u={}){const{overrides:g={}}=u,a={id:"mock-msg-1",conversationId:"mock-conv-1",content:"Mock response",role:"assistant",status:"DONE",createdAt:new Date},l={id:"mock-conv-1",title:"Mock Conversation",lastMessageDate:new Date},n=new Map,c=[],m={sendMessage:async()=>a,continueMessage:async()=>a,stop:async()=>null,stopMessage:async()=>({status:"not_running"}),isGenerating:()=>!1,resumePendingClientFunctions:async()=>null,registerResumeGate:()=>()=>{},getConversations:async()=>[l],getConversation:async()=>l,getMessages:async()=>[a],submitToolCallForm:async()=>({status:"completed"}),confirmToolCall:async()=>{},rejectToolCall:async()=>{},submitFeedback:async()=>{},submitConversationFeedback:async()=>a.id,registerFunction:()=>{},unregisterFunction:()=>!0,getRegisteredFunctions:()=>[],executeClientFunction:async()=>{},getContextSnapshot:()=>null,notifyContextChanged:()=>{},setContext:()=>{},removeContext:()=>!0,addDynamicContext:()=>{},removeDynamicContext:()=>!0,registerNavigationFunction:()=>{},unregisterNavigationFunction:()=>{},getConfiguredAgent:()=>{},getHttp:()=>({get:async()=>({}),post:async()=>({})}),emitProactiveEvent:(e,t)=>{const o=n.get(e);o&&[...o].forEach(s=>s(t))},on:(e,t)=>{n.has(e)||n.set(e,new Set),n.get(e).add(t)},off:(e,t)=>{n.get(e)?.delete(t)},once:(e,t)=>{const o=(...s)=>{n.get(e)?.delete(o),t(...s)};n.has(e)||n.set(e,new Set),n.get(e).add(o)},waitFor:(e,t)=>new Promise((o,s)=>{let r;const d=f=>{r&&clearTimeout(r),n.get(e)?.delete(d),o(f)};n.has(e)||n.set(e,new Set),n.get(e).add(d),t?.timeout&&(r=setTimeout(()=>{n.get(e)?.delete(d),s(new Error(`waitFor("${e}") timed out after ${t.timeout}ms`))},t.timeout))}),updateConfig:()=>{},destroy:()=>{n.clear()},...g},i={};for(const[e,t]of Object.entries(m))i[e]=(...o)=>(c.push({method:e,args:o}),t(...o));return i.proactive=null,i.__calls=c,i.__callsFor=e=>c.filter(t=>t.method===e),i.__emitEvent=(e,t)=>{const o=n.get(e);o&&[...o].forEach(s=>s(t))},i}Object.defineProperty(exports,"createMockClient",{enumerable:!0,get:function(){return y}});