@useago/sdk 1.13.2 → 1.13.3

package/dist/widget.d.cts

@@ -729,6 +729,11 @@ declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /** A validated form collector submission is about to call its submit target. */
+    "form:submitting": {
+        name: string;
+        values: Record<string, unknown>;
+    };
     /**
      * A form collector submitted successfully. `result` is the raw submit response
      * (POST body / handler return value / backend relay result) — the third-party
@@ -1993,6 +1998,11 @@ export declare interface MountChatWidgetOptions {
         id: string;
         content: string;
     }) => void;
+    /** Called after validation, just before the form submission starts. */
+    onFormSubmitting?: (data: {
+        name: string;
+        values: Record<string, unknown>;
+    }) => void;
     /**
      * Called when a form collector submits successfully. `result` is the raw submit
      * response (the third-party API's answer); `values` are the submitted fields.
@@ -2799,16 +2809,21 @@ declare interface TranscribeAudioOptions {
     signal?: AbortSignal;
 }
 
-/** The MCP behavior hints AGO has no equivalent for. */
+/** Metadata for tools exposed through the WebMCP bridge. */
 declare interface WebMCPToolMeta {
     /**
-     * Both default to `false`, so only set what is true: `readOnlyHint` marks a
-     * function that changes nothing, `untrustedContentHint` one whose result may
-     * carry third-party text.
+     * Optional WebMCP metadata; all fields default to `false` in WebMCP.
+     * These annotations do not affect AGO's in-app agent or approval behavior.
      */
     annotations?: {
+        /** The tool only reads data and does not change state. */
         readOnlyHint?: boolean;
+        /** The output contains content untrusted by the tool author. */
         untrustedContentHint?: boolean;
+        /** Significant, real-world, or irreversible effects; independent of requiresApproval. */
+        consequentialHint?: boolean;
+        /** Intended for debugging and developer tooling. */
+        debugging?: boolean;
     };
     /**
      * This function navigates. The WebMCP call is held open until the function

package/dist/widget.d.ts

@@ -729,6 +729,11 @@ declare interface AgoClientEvents {
         result: unknown;
         error?: string;
     };
+    /** A validated form collector submission is about to call its submit target. */
+    "form:submitting": {
+        name: string;
+        values: Record<string, unknown>;
+    };
     /**
      * A form collector submitted successfully. `result` is the raw submit response
      * (POST body / handler return value / backend relay result) — the third-party
@@ -1993,6 +1998,11 @@ export declare interface MountChatWidgetOptions {
         id: string;
         content: string;
     }) => void;
+    /** Called after validation, just before the form submission starts. */
+    onFormSubmitting?: (data: {
+        name: string;
+        values: Record<string, unknown>;
+    }) => void;
     /**
      * Called when a form collector submits successfully. `result` is the raw submit
      * response (the third-party API's answer); `values` are the submitted fields.
@@ -2799,16 +2809,21 @@ declare interface TranscribeAudioOptions {
     signal?: AbortSignal;
 }
 
-/** The MCP behavior hints AGO has no equivalent for. */
+/** Metadata for tools exposed through the WebMCP bridge. */
 declare interface WebMCPToolMeta {
     /**
-     * Both default to `false`, so only set what is true: `readOnlyHint` marks a
-     * function that changes nothing, `untrustedContentHint` one whose result may
-     * carry third-party text.
+     * Optional WebMCP metadata; all fields default to `false` in WebMCP.
+     * These annotations do not affect AGO's in-app agent or approval behavior.
      */
     annotations?: {
+        /** The tool only reads data and does not change state. */
         readOnlyHint?: boolean;
+        /** The output contains content untrusted by the tool author. */
         untrustedContentHint?: boolean;
+        /** Significant, real-world, or irreversible effects; independent of requiresApproval. */
+        consequentialHint?: boolean;
+        /** Intended for debugging and developer tooling. */
+        debugging?: boolean;
     };
     /**
      * This function navigates. The WebMCP call is held open until the function