@useago/sdk 1.4.4 → 1.5.2

package/dist/angular.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./AgoClient-CLmtYTJx.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)}unregisterNavigationFunction(){this.client.unregisterNavigationFunction()}registerPageStateFunction(e,t){this.client.registerPageStateFunction(e,t)}unregisterPageStateFunction(e){this.client.unregisterPageStateFunction(e)}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-5VGybmvz.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 r=s=>{i.next?.(s)};return e.on(t,r),{unsubscribe:()=>e.off(t,r)}}}}sendMessage(t,e){return this.client.sendMessage(t,e)}getConversations(){return this.client.getConversations()}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;

package/dist/angular.d.cts

@@ -28,6 +28,23 @@ declare interface AgoAttachment {
     isSafeImage: boolean;
 }
 
+export declare interface AgoAutoContinueOptions {
+    /** Function names whose invocation counts as "navigated". Default `["navigateToPage"]`. */
+    navigationFunctions?: string[];
+    /** Registered function that signals the destination has editable state. Default `"setPageState"`. */
+    pageStateFunctionName?: string;
+    /** The hidden continuation prompt. Override for i18n / tone. */
+    continuationPrompt?: string;
+    /** Max continuations per user gesture (guards navigate→continue→navigate loops). Default `1`. */
+    maxDepth?: number;
+    /** How long to wait for the destination page to register page-state before giving up. Default `4000`ms. */
+    readinessTimeoutMs?: number;
+    /** Extra settle delay after page-state appears, to let sibling state mount. Default `150`ms. */
+    settleMs?: number;
+    /** Opt-out escape hatch. Default `true`. */
+    enabled?: boolean;
+}
+
 /**
  * Main SDK client for AGO Chat integration
  */
@@ -41,6 +58,12 @@ declare class AgoClient {
     private warnedEmptyConversations;
     /** Paused turns awaiting auto-resume, keyed by assistant message id. */
     private pendingResumes;
+    /**
+     * Client function invocations held pending user approval, keyed by
+     * invocationId (the tool-call id). Populated when {@link requiresApproval}
+     * matches; drained by {@link approveFunction} / {@link rejectFunction}.
+     */
+    private pendingApprovals;
     /** App-provided gate deciding WHEN a paused turn resumes (see {@link registerResumeGate}). */
     private resumeGate;
     constructor(config: AgoConfig);
@@ -91,6 +114,24 @@ declare class AgoClient {
      */
     private maybeFlagEmptyReply;
     private handleClientFunctionInvocation;
+    /**
+     * Whether a client function invocation must wait for explicit user approval.
+     * True when the {@link AgoConfig.approvalPolicy} returns true OR the function
+     * was registered with `requiresApproval: true` — the two OR together.
+     */
+    private requiresApproval;
+    /**
+     * Approve a client function call held by the approval gate: run it, submit its
+     * result, and let the paused turn resume. No-op if the invocation is unknown
+     * (already handled, or never gated).
+     */
+    approveFunction(invocationId: string): Promise<void>;
+    /**
+     * Reject a client function call held by the approval gate: submit a rejection
+     * result so the agent sees the user declined, and let the paused turn resume
+     * (the agent decides what to do next). No-op if the invocation is unknown.
+     */
+    rejectFunction(invocationId: string): Promise<void>;
     /**
      * Get list of conversations
      */
@@ -120,8 +161,10 @@ declare class AgoClient {
      *
      * Opt-in on purpose — re-running functions on reload can be surprising (e.g. a
      * navigation function would navigate again), so the app decides. Returns the
-     * resumed turn's final message, or `null` when there was nothing to resume or
-     * some waiting function is not registered on this page.
+     * resumed turn's final message, or `null` when there was nothing to resume,
+     * some waiting function is not registered on this page, or a waiting call is
+     * gated by the approval policy (it is held for `approveFunction` /
+     * `rejectFunction` and the turn stays paused, exactly as on the live stream).
      */
     resumePendingClientFunctions(conversation: Conversation): Promise<AgoMessage | null>;
     /**
@@ -416,6 +459,15 @@ export declare interface AgoClientEvents {
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;
+    /**
+     * A client function call is held pending the user's approval (pause mode +
+     * an {@link AgoConfig.approvalPolicy}/`requiresApproval` match). The turn stays
+     * at `WAITING_CLIENT`; call `approveFunction(invocationId)` to run it and
+     * resume, or `rejectFunction(invocationId)` to decline. Fires after
+     * `function:invoke` (which still fires for every call) and instead of the
+     * call running immediately.
+     */
+    "function:awaiting-approval": ClientFunctionInvocation;
     "function:result": {
         invocationId: string;
         result: unknown;
@@ -476,14 +528,28 @@ export declare interface AgoConfig {
     warnOnEmptyReply?: boolean;
     /**
      * How the agent loop treats client function calls (requires backend support):
-     * - `"placeholder"` (default): the turn continues immediately on a placeholder
-     *   result; the real result is only visible to the agent on later turns.
-     * - `"pause"`: the turn stops on client function call(s) with status
+     * - `"pause"` (default): the turn stops on client function call(s) with status
      *   `WAITING_CLIENT`; once every result is submitted, the SDK resumes the SAME
      *   turn via `POST /messages/{id}/continue`, so the agent sees the real results.
+     * - `"placeholder"` (legacy): the turn continues immediately on a placeholder
+     *   result; the real result is only visible to the agent on later turns.
      * Older backends ignore the flag, so `"pause"` degrades to legacy behavior.
      */
     clientFunctionsMode?: ClientFunctionsMode;
+    /**
+     * Gate client function calls behind explicit user approval. Return `true` for
+     * an invocation the user must approve/reject before it runs; return `false`
+     * (or omit the policy) to let it run immediately as before.
+     *
+     * Only effective in pause mode (`clientFunctionsMode: "pause"`) — a gated call
+     * holds at `WAITING_CLIENT`, the SDK emits `function:awaiting-approval`, and it
+     * runs (and the turn resumes) only after `approveFunction(invocationId)`; a
+     * `rejectFunction(invocationId)` submits a rejection so the agent sees the
+     * decline. In placeholder mode there is no pause to hold, so the policy is a
+     * no-op and the call runs normally. A per-function `requiresApproval: true`
+     * also gates a call; the policy and the flag OR together.
+     */
+    approvalPolicy?: (invocation: ClientFunctionInvocation) => boolean;
     /**
      * Max serialized size (bytes) of a client function result before the SDK
      * replaces it with a flagged, truncated preview. Everything a handler
@@ -528,6 +594,11 @@ export declare interface AgoMessage {
 export declare interface AgoPageStateOptions {
     /** Name of the synthesized client function. Defaults to "setPageState". */
     functionName?: string;
+    /**
+     * Require explicit user approval before this state change runs. See
+     * {@link AgoConfig.approvalPolicy} — pause mode only. Defaults to `false`.
+     */
+    requiresApproval?: boolean;
 }
 
 export declare type AgoProvideOptions = AgoConfig;
@@ -609,6 +680,31 @@ export declare class AgoService {
     }>): void;
     /** Unregister navigation (function + current-page context) */
     unregisterNavigationFunction(): void;
+    /**
+     * Auto-continue the agent after it navigates, so a "go to page B and change X"
+     * request completes in one user gesture. Enable once (e.g. in your root
+     * component) and call the returned function on teardown:
+     *
+     * ```ts
+     * export class AppComponent implements OnDestroy {
+     *   private ago = inject(AgoService);
+     *   private router = inject(Router);
+     *   private stopAutoContinue = this.ago.enableAutoContinueAfterNavigation();
+     *
+     *   constructor() {
+     *     this.ago.registerNavigationFunction((path) => this.router.navigateByUrl(path), routes);
+     *   }
+     *
+     *   ngOnDestroy() {
+     *     this.stopAutoContinue();
+     *   }
+     * }
+     * ```
+     *
+     * See {@link attachAutoContinueAfterNavigation} for the pause-mode /
+     * placeholder-mode mechanics and the available options.
+     */
+    enableAutoContinueAfterNavigation(options?: AgoAutoContinueOptions): () => void;
     /** Register editable page-state controls (filters, sort, view mode…) */
     registerPageStateFunction(controls: AgoStateControl[], opts?: AgoPageStateOptions): void;
     /** Unregister a page-state function and its dynamic context */
@@ -684,6 +780,11 @@ declare interface ClientFunctionDefinition {
      * `Infinity` disables the guard for this function.
      */
     maxResultBytes?: number;
+    /**
+     * Require explicit user approval before this function runs. See
+     * {@link AgoConfig.approvalPolicy} — pause mode only. ORs with the policy.
+     */
+    requiresApproval?: boolean;
 }
 
 /**
@@ -710,6 +811,11 @@ declare type ClientFunctionRegisterOptions = Omit<ClientFunctionSchema, "name">
      * disables the guard for this function.
      */
     maxResultBytes?: number;
+    /**
+     * Require explicit user approval before this function runs. See
+     * {@link AgoConfig.approvalPolicy} — pause mode only. ORs with the policy.
+     */
+    requiresApproval?: boolean;
 };
 
 /**
@@ -750,6 +856,19 @@ declare interface ContextEntry {
     description?: string;
     /** Arbitrary structured data the AI should know about */
     data?: Record<string, unknown>;
+    /**
+     * Marks the entry as constant for the whole conversation. The backend then
+     * pins it right after the system prompt, where LLM providers cache it across
+     * turns, instead of re-processing it next to every new user message.
+     *
+     * Only set this when the entry's content is byte-identical on every message
+     * of a conversation (a schema, a capability list, static instructions). A
+     * stable entry that changes between messages invalidates the provider's
+     * cache for the entire conversation history, which costs more than leaving
+     * the flag off. Default: `false` (re-sent near the newest user message).
+     * Backends that don't know the flag ignore it.
+     */
+    stable?: boolean;
 }
 
 /**

package/dist/angular.d.ts

@@ -28,6 +28,23 @@ declare interface AgoAttachment {
     isSafeImage: boolean;
 }
 
+export declare interface AgoAutoContinueOptions {
+    /** Function names whose invocation counts as "navigated". Default `["navigateToPage"]`. */
+    navigationFunctions?: string[];
+    /** Registered function that signals the destination has editable state. Default `"setPageState"`. */
+    pageStateFunctionName?: string;
+    /** The hidden continuation prompt. Override for i18n / tone. */
+    continuationPrompt?: string;
+    /** Max continuations per user gesture (guards navigate→continue→navigate loops). Default `1`. */
+    maxDepth?: number;
+    /** How long to wait for the destination page to register page-state before giving up. Default `4000`ms. */
+    readinessTimeoutMs?: number;
+    /** Extra settle delay after page-state appears, to let sibling state mount. Default `150`ms. */
+    settleMs?: number;
+    /** Opt-out escape hatch. Default `true`. */
+    enabled?: boolean;
+}
+
 /**
  * Main SDK client for AGO Chat integration
  */
@@ -41,6 +58,12 @@ declare class AgoClient {
     private warnedEmptyConversations;
     /** Paused turns awaiting auto-resume, keyed by assistant message id. */
     private pendingResumes;
+    /**
+     * Client function invocations held pending user approval, keyed by
+     * invocationId (the tool-call id). Populated when {@link requiresApproval}
+     * matches; drained by {@link approveFunction} / {@link rejectFunction}.
+     */
+    private pendingApprovals;
     /** App-provided gate deciding WHEN a paused turn resumes (see {@link registerResumeGate}). */
     private resumeGate;
     constructor(config: AgoConfig);
@@ -91,6 +114,24 @@ declare class AgoClient {
      */
     private maybeFlagEmptyReply;
     private handleClientFunctionInvocation;
+    /**
+     * Whether a client function invocation must wait for explicit user approval.
+     * True when the {@link AgoConfig.approvalPolicy} returns true OR the function
+     * was registered with `requiresApproval: true` — the two OR together.
+     */
+    private requiresApproval;
+    /**
+     * Approve a client function call held by the approval gate: run it, submit its
+     * result, and let the paused turn resume. No-op if the invocation is unknown
+     * (already handled, or never gated).
+     */
+    approveFunction(invocationId: string): Promise<void>;
+    /**
+     * Reject a client function call held by the approval gate: submit a rejection
+     * result so the agent sees the user declined, and let the paused turn resume
+     * (the agent decides what to do next). No-op if the invocation is unknown.
+     */
+    rejectFunction(invocationId: string): Promise<void>;
     /**
      * Get list of conversations
      */
@@ -120,8 +161,10 @@ declare class AgoClient {
      *
      * Opt-in on purpose — re-running functions on reload can be surprising (e.g. a
      * navigation function would navigate again), so the app decides. Returns the
-     * resumed turn's final message, or `null` when there was nothing to resume or
-     * some waiting function is not registered on this page.
+     * resumed turn's final message, or `null` when there was nothing to resume,
+     * some waiting function is not registered on this page, or a waiting call is
+     * gated by the approval policy (it is held for `approveFunction` /
+     * `rejectFunction` and the turn stays paused, exactly as on the live stream).
      */
     resumePendingClientFunctions(conversation: Conversation): Promise<AgoMessage | null>;
     /**
@@ -416,6 +459,15 @@ export declare interface AgoClientEvents {
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;
+    /**
+     * A client function call is held pending the user's approval (pause mode +
+     * an {@link AgoConfig.approvalPolicy}/`requiresApproval` match). The turn stays
+     * at `WAITING_CLIENT`; call `approveFunction(invocationId)` to run it and
+     * resume, or `rejectFunction(invocationId)` to decline. Fires after
+     * `function:invoke` (which still fires for every call) and instead of the
+     * call running immediately.
+     */
+    "function:awaiting-approval": ClientFunctionInvocation;
     "function:result": {
         invocationId: string;
         result: unknown;
@@ -476,14 +528,28 @@ export declare interface AgoConfig {
     warnOnEmptyReply?: boolean;
     /**
      * How the agent loop treats client function calls (requires backend support):
-     * - `"placeholder"` (default): the turn continues immediately on a placeholder
-     *   result; the real result is only visible to the agent on later turns.
-     * - `"pause"`: the turn stops on client function call(s) with status
+     * - `"pause"` (default): the turn stops on client function call(s) with status
      *   `WAITING_CLIENT`; once every result is submitted, the SDK resumes the SAME
      *   turn via `POST /messages/{id}/continue`, so the agent sees the real results.
+     * - `"placeholder"` (legacy): the turn continues immediately on a placeholder
+     *   result; the real result is only visible to the agent on later turns.
      * Older backends ignore the flag, so `"pause"` degrades to legacy behavior.
      */
     clientFunctionsMode?: ClientFunctionsMode;
+    /**
+     * Gate client function calls behind explicit user approval. Return `true` for
+     * an invocation the user must approve/reject before it runs; return `false`
+     * (or omit the policy) to let it run immediately as before.
+     *
+     * Only effective in pause mode (`clientFunctionsMode: "pause"`) — a gated call
+     * holds at `WAITING_CLIENT`, the SDK emits `function:awaiting-approval`, and it
+     * runs (and the turn resumes) only after `approveFunction(invocationId)`; a
+     * `rejectFunction(invocationId)` submits a rejection so the agent sees the
+     * decline. In placeholder mode there is no pause to hold, so the policy is a
+     * no-op and the call runs normally. A per-function `requiresApproval: true`
+     * also gates a call; the policy and the flag OR together.
+     */
+    approvalPolicy?: (invocation: ClientFunctionInvocation) => boolean;
     /**
      * Max serialized size (bytes) of a client function result before the SDK
      * replaces it with a flagged, truncated preview. Everything a handler
@@ -528,6 +594,11 @@ export declare interface AgoMessage {
 export declare interface AgoPageStateOptions {
     /** Name of the synthesized client function. Defaults to "setPageState". */
     functionName?: string;
+    /**
+     * Require explicit user approval before this state change runs. See
+     * {@link AgoConfig.approvalPolicy} — pause mode only. Defaults to `false`.
+     */
+    requiresApproval?: boolean;
 }
 
 export declare type AgoProvideOptions = AgoConfig;
@@ -609,6 +680,31 @@ export declare class AgoService {
     }>): void;
     /** Unregister navigation (function + current-page context) */
     unregisterNavigationFunction(): void;
+    /**
+     * Auto-continue the agent after it navigates, so a "go to page B and change X"
+     * request completes in one user gesture. Enable once (e.g. in your root
+     * component) and call the returned function on teardown:
+     *
+     * ```ts
+     * export class AppComponent implements OnDestroy {
+     *   private ago = inject(AgoService);
+     *   private router = inject(Router);
+     *   private stopAutoContinue = this.ago.enableAutoContinueAfterNavigation();
+     *
+     *   constructor() {
+     *     this.ago.registerNavigationFunction((path) => this.router.navigateByUrl(path), routes);
+     *   }
+     *
+     *   ngOnDestroy() {
+     *     this.stopAutoContinue();
+     *   }
+     * }
+     * ```
+     *
+     * See {@link attachAutoContinueAfterNavigation} for the pause-mode /
+     * placeholder-mode mechanics and the available options.
+     */
+    enableAutoContinueAfterNavigation(options?: AgoAutoContinueOptions): () => void;
     /** Register editable page-state controls (filters, sort, view mode…) */
     registerPageStateFunction(controls: AgoStateControl[], opts?: AgoPageStateOptions): void;
     /** Unregister a page-state function and its dynamic context */
@@ -684,6 +780,11 @@ declare interface ClientFunctionDefinition {
      * `Infinity` disables the guard for this function.
      */
     maxResultBytes?: number;
+    /**
+     * Require explicit user approval before this function runs. See
+     * {@link AgoConfig.approvalPolicy} — pause mode only. ORs with the policy.
+     */
+    requiresApproval?: boolean;
 }
 
 /**
@@ -710,6 +811,11 @@ declare type ClientFunctionRegisterOptions = Omit<ClientFunctionSchema, "name">
      * disables the guard for this function.
      */
     maxResultBytes?: number;
+    /**
+     * Require explicit user approval before this function runs. See
+     * {@link AgoConfig.approvalPolicy} — pause mode only. ORs with the policy.
+     */
+    requiresApproval?: boolean;
 };
 
 /**
@@ -750,6 +856,19 @@ declare interface ContextEntry {
     description?: string;
     /** Arbitrary structured data the AI should know about */
     data?: Record<string, unknown>;
+    /**
+     * Marks the entry as constant for the whole conversation. The backend then
+     * pins it right after the system prompt, where LLM providers cache it across
+     * turns, instead of re-processing it next to every new user message.
+     *
+     * Only set this when the entry's content is byte-identical on every message
+     * of a conversation (a schema, a capability list, static instructions). A
+     * stable entry that changes between messages invalidates the provider's
+     * cache for the entire conversation history, which costs more than leaving
+     * the flag off. Default: `false` (re-sent near the newest user message).
+     * Backends that don't know the flag ignore it.
+     */
+    stable?: boolean;
 }
 
 /**

package/dist/angular.js

@@ -1,4 +1,5 @@
-import { t as o } from "./AgoClient-Ozz2b1dQ.js";
+import { t as o } from "./AgoClient-DXrH2AMi.js";
+import { t as c } 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");
@@ -48,6 +49,9 @@ var s = class {
   unregisterNavigationFunction() {
     this.client.unregisterNavigationFunction();
   }
+  enableAutoContinueAfterNavigation(t) {
+    return c(this.client, t);
+  }
   registerPageStateFunction(t, e) {
     this.client.registerPageStateFunction(t, e);
   }

package/dist/autoContinue-CC8K9mBU.js

@@ -0,0 +1,63 @@
+var N = "You have navigated the user to a new page. That page now exposes its editable state through the available setPageState function, and its current values in the page context. If the user's latest request also asked to change something on this page, call setPageState now to apply exactly those changes and nothing else. Otherwise, reply with a short confirmation only.";
+function p(e) {
+  return {
+    navigationFunctions: e?.navigationFunctions ?? ["navigateToPage"],
+    pageStateFunctionName: e?.pageStateFunctionName ?? "setPageState",
+    continuationPrompt: e?.continuationPrompt ?? N,
+    maxDepth: e?.maxDepth ?? 1,
+    readinessTimeoutMs: e?.readinessTimeoutMs ?? 4e3,
+    settleMs: e?.settleMs ?? 150,
+    enabled: e?.enabled ?? !0
+  };
+}
+function w(e, o) {
+  const a = typeof o == "function" ? () => p(o()) : () => p(o), t = {
+    navigated: !1,
+    pausedTurnNavigated: !1,
+    depth: 0,
+    runId: 0,
+    ourSendPending: !1
+  }, i = () => e.getRegisteredFunctions().some((n) => n.name === a().pageStateFunctionName), g = (n) => new Promise((s) => {
+    let l = !1;
+    const r = (I) => {
+      l || (l = !0, clearTimeout(S), e.off("context:changed", u), s(I));
+    }, v = () => setTimeout(() => r(n === t.runId && i()), a().settleMs), u = () => {
+      if (n !== t.runId) return r(!1);
+      i() && (e.off("context:changed", u), v());
+    }, S = setTimeout(() => r(!1), a().readinessTimeoutMs);
+    i() ? v() : e.on("context:changed", u);
+  }), P = async (n) => {
+    const s = ++t.runId;
+    if (!(!await g(s) || s !== t.runId)) {
+      t.depth += 1, t.ourSendPending = !0;
+      try {
+        await e.sendMessage(a().continuationPrompt, {
+          conversationId: n,
+          hidden: !0
+        });
+      } catch {
+        t.ourSendPending = !1;
+      }
+    }
+  }, d = (n) => {
+    a().navigationFunctions.includes(n.functionName) && (t.navigated = !0);
+  }, T = e.registerResumeGate(async () => {
+    a().enabled && t.pausedTurnNavigated && (t.pausedTurnNavigated = !1, await g(++t.runId));
+  }), f = () => {
+    t.pausedTurnNavigated = t.navigated, t.navigated = !1;
+  }, c = () => {
+    t.ourSendPending || (t.depth = 0, t.runId += 1);
+  }, h = (n) => {
+    t.ourSendPending = !1;
+    const s = t.navigated;
+    t.navigated = !1, a().enabled && s && (t.depth >= a().maxDepth || P(n.conversationId));
+  }, m = () => {
+    t.ourSendPending = !1;
+  };
+  return e.on("function:invoke", d), e.on("message:start", c), e.on("message:waiting-client", f), e.on("message:complete", h), e.on("message:error", m), () => {
+    t.runId += 1, T(), e.off("function:invoke", d), e.off("message:start", c), e.off("message:waiting-client", f), e.off("message:complete", h), e.off("message:error", m);
+  };
+}
+export {
+  w as t
+};

package/dist/autoContinue-CP9pJR-V.cjs

@@ -0,0 +1 @@
+var I="You have navigated the user to a new page. That page now exposes its editable state through the available setPageState function, and its current values in the page context. If the user's latest request also asked to change something on this page, call setPageState now to apply exactly those changes and nothing else. Otherwise, reply with a short confirmation only.";function p(e){return{navigationFunctions:e?.navigationFunctions??["navigateToPage"],pageStateFunctionName:e?.pageStateFunctionName??"setPageState",continuationPrompt:e?.continuationPrompt??I,maxDepth:e?.maxDepth??1,readinessTimeoutMs:e?.readinessTimeoutMs??4e3,settleMs:e?.settleMs??150,enabled:e?.enabled??!0}}function w(e,s){const a=typeof s=="function"?()=>p(s()):()=>p(s),t={navigated:!1,pausedTurnNavigated:!1,depth:0,runId:0,ourSendPending:!1},i=()=>e.getRegisteredFunctions().some(n=>n.name===a().pageStateFunctionName),g=n=>new Promise(o=>{let l=!1;const r=N=>{l||(l=!0,clearTimeout(S),e.off("context:changed",u),o(N))},v=()=>setTimeout(()=>r(n===t.runId&&i()),a().settleMs),u=()=>{if(n!==t.runId)return r(!1);i()&&(e.off("context:changed",u),v())},S=setTimeout(()=>r(!1),a().readinessTimeoutMs);i()?v():e.on("context:changed",u)}),P=async n=>{const o=++t.runId;if(!(!await g(o)||o!==t.runId)){t.depth+=1,t.ourSendPending=!0;try{await e.sendMessage(a().continuationPrompt,{conversationId:n,hidden:!0})}catch{t.ourSendPending=!1}}},d=n=>{a().navigationFunctions.includes(n.functionName)&&(t.navigated=!0)},T=e.registerResumeGate(async()=>{a().enabled&&t.pausedTurnNavigated&&(t.pausedTurnNavigated=!1,await g(++t.runId))}),f=()=>{t.pausedTurnNavigated=t.navigated,t.navigated=!1},c=()=>{t.ourSendPending||(t.depth=0,t.runId+=1)},h=n=>{t.ourSendPending=!1;const o=t.navigated;t.navigated=!1,a().enabled&&o&&(t.depth>=a().maxDepth||P(n.conversationId))},m=()=>{t.ourSendPending=!1};return e.on("function:invoke",d),e.on("message:start",c),e.on("message:waiting-client",f),e.on("message:complete",h),e.on("message:error",m),()=>{t.runId+=1,T(),e.off("function:invoke",d),e.off("message:start",c),e.off("message:waiting-client",f),e.off("message:complete",h),e.off("message:error",m)}}Object.defineProperty(exports,"attachAutoContinueAfterNavigation",{enumerable:!0,get:function(){return w}});

package/dist/{createConversationSession-CUkNp6mZ.cjs → createConversationSession-0WTqcCLK.cjs}

@@ -1 +1 @@
-const d=require("./createFormCollector-DHT1ObOb.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-1GKKwQV_.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-QIBN0gLx.js → createConversationSession-DPrrr70o.js}

@@ -1,4 +1,4 @@
-import { i as d } from "./createFormCollector-F3YJfsbg.js";
+import { i as d } from "./createFormCollector-DYh90kiG.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-1GKKwQV_.cjs

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