@useago/sdk 1.13.0 → 1.13.2

package/dist/react.d.ts

@@ -116,6 +116,8 @@ declare class AgoClient {
     private config;
     /** Conversations already warned about an empty reply (one warning each). */
     private warnedEmptyConversations;
+    /** Client functions the backend has accepted from a WebMCP call report. */
+    private declaredExternally;
     /** Whether the placeholder-mode page-data warning has already been logged. */
     private warnedPageDataPlaceholder;
     /** `readPageData` companions this SDK registered, so cleanup only removes its own. */
@@ -152,6 +154,8 @@ declare class AgoClient {
     proactive: ProactiveController | null;
     /** Removes the mirrored WebMCP tools; `null` when the bridge is off. */
     private detachWebMCP;
+    /** The `listPages` companion is live. */
+    private listPagesRegistered;
     constructor(config: AgoConfig);
     private attachWebMCPBridge;
     /**
@@ -266,6 +270,11 @@ declare class AgoClient {
      */
     rejectFunction(invocationId: string): Promise<void>;
     /* Excluded from this release type: runExternalFunction */
+    /**
+     * Best-effort analytics for one WebMCP call. No agent: the caller is someone
+     * else's agent and cannot be known from `execute`.
+     */
+    private reportExternalCall;
     /**
      * Get a page of conversations, newest-first. `pageSize` is capped at 100 by
      * the backend (default 50). Returns the `{ data, has_more, total }` envelope
@@ -460,14 +469,15 @@ declare class AgoClient {
      * page of an entity. Flat arguments only: nested object parameters are not
      * reliably rendered to the model, so placeholders must not be named `page`.
      *
+     * For a large table, `{ catalogue: "onDemand" }` moves the route descriptions
+     * into a read-only `listPages` companion, leaving only the page names in the
+     * per-message schema. Routes may carry a `section` to group that companion.
+     *
      * @param navigate - A callback that performs the navigation (e.g. react-router's navigate)
      * @param routes - Map of route names to paths, with descriptions for the LLM
+     * @param opts - Where the catalogue lives; `"inline"` by default
      */
-    registerNavigationFunction(navigate: (path: string) => void, routes: Array<{
-        name: string;
-        path: string;
-        description: string;
-    }>): void;
+    registerNavigationFunction(navigate: (path: string) => void, routes: NavRoute[], opts?: AgoNavigationOptions): void;
     /**
      * Unregister the navigation function and its `current-page` context provider.
      */
@@ -975,6 +985,16 @@ export declare interface AgoMessage {
     createdAt: Date;
 }
 
+/**
+ * Where the route catalogue lives: `"inline"` (default) in `navigateToPage`'s
+ * description, or `"onDemand"` in a `listPages` companion's result.
+ */
+export declare type AgoNavigationOptions = {
+    catalogue?: "inline";
+} | {
+    catalogue: "onDemand";
+};
+
 /**
  * Prebuilt proactive-nudge toast: a small, always-dismissable bubble anchored
  * near the chat launcher. Never modal — it never blocks the page. Renders the
@@ -1148,6 +1168,8 @@ export declare interface AgoRoute {
     name: string;
     path: string;
     description: string;
+    /** Groups this route for `catalogue: "onDemand"`. Unused otherwise. */
+    section?: string;
 }
 
 /**
@@ -2050,6 +2072,15 @@ declare interface MockAgoClientOptions {
 
 declare type MockFn = (...args: any[]) => any;
 
+/** A navigable page. `path` may carry `:param` placeholders. */
+declare interface NavRoute {
+    name: string;
+    path: string;
+    description: string;
+    /** Only read under `catalogue: "onDemand"`. */
+    section?: string;
+}
+
 /**
  * Optional action attached to a nudge. Accepting a `functionName` action
  * executes the registered client function (same `FunctionRegistry` path as
@@ -2967,8 +2998,11 @@ export declare interface UseAgoFunctionOptions {
  *   { name: "settings", path: "/settings", description: "User settings" },
  * ]);
  * ```
+ *
+ * For a large route table, `{ catalogue: "onDemand" }` keeps the descriptions
+ * out of every message.
  */
-export declare function useAgoNavigation(navigate: (path: string) => void, routes: AgoRoute[]): void;
+export declare function useAgoNavigation(navigate: (path: string) => void, routes: AgoRoute[], opts?: AgoNavigationOptions): void;
 
 export declare type UseAgoOptions = AgoConfig;