capacitor-gleap-plugin 15.3.4 → 15.4.0

package/CapacitorGleapPlugin.podspec

@@ -13,6 +13,6 @@ Pod::Spec.new do |s|
   s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
   s.ios.deployment_target = '14.0'
   s.dependency 'Capacitor'
-  s.dependency 'Gleap', '15.3.4'
+  s.dependency 'Gleap', '15.4.0'
   s.swift_version = '5.1'
 end

package/README.md

@@ -39,7 +39,9 @@ Please install the plugin version from our capacitor-v4 brunch with `npm install
 * [`setTags(...)`](#settags)
 * [`setNetworkLogsBlacklist(...)`](#setnetworklogsblacklist)
 * [`setNetworkLogPropsToIgnore(...)`](#setnetworklogpropstoignore)
-* [`setAiTools(...)`](#setaitools)
+* [`registerAgentTool(...)`](#registeragenttool)
+* [`sendAgentToolResult(...)`](#sendagenttoolresult)
+* [`addListener('agentToolExecution', ...)`](#addlisteneragenttoolexecution-)
 * [`setTicketAttribute(...)`](#setticketattribute)
 * [`unsetTicketAttribute(...)`](#unsetticketattribute)
 * [`clearTicketAttributes()`](#clearticketattributes)
@@ -299,21 +301,60 @@ Set network logs props to ignore
 --------------------
 
 
-### setAiTools(...)
+### registerAgentTool(...)
 
 ```typescript
-setAiTools(options: { tools: { name: string; description: string; response: string; executionType: "auto" | "button"; parameters: { name: string; description: string; type: "string" | "number" | "boolean"; required: boolean; enums?: string[]; }[]; }[]; }) => Promise<{ aiToolsSet: boolean; }>
+registerAgentTool(options: { name: string; }) => Promise<void>
 ```
 
-Sets the AI tools to use
+Registers a Frontend tool defined on your AI agent in the Gleap dashboard.
+Prefer the `registerAgentTool(name, handler)` helper exported by this
+package — it wires the agentToolExecution event and result round-trip for
+you.
 
-| Param         | Type                                                                                                                                                                                                                                                       |
-| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`options`** | <code>{ tools: { name: string; description: string; response: string; executionType: 'auto' \| 'button'; parameters: { name: string; description: string; type: 'string' \| 'number' \| 'boolean'; required: boolean; enums?: string[]; }[]; }[]; }</code> |
+| Param         | Type                           |
+| ------------- | ------------------------------ |
+| **`options`** | <code>{ name: string; }</code> |
 
-**Returns:** <code>Promise&lt;{ aiToolsSet: boolean; }&gt;</code>
+**Since:** 15.0.0
 
-**Since:** 13.5.0
+--------------------
+
+
+### sendAgentToolResult(...)
+
+```typescript
+sendAgentToolResult(options: { executionId: string; result: string; }) => Promise<void>
+```
+
+Resolves a pending agent tool execution with the handler's result.
+Used by the `registerAgentTool(name, handler)` helper.
+
+| Param         | Type                                                  |
+| ------------- | ----------------------------------------------------- |
+| **`options`** | <code>{ executionId: string; result: string; }</code> |
+
+**Since:** 15.0.0
+
+--------------------
+
+
+### addListener('agentToolExecution', ...)
+
+```typescript
+addListener(eventName: 'agentToolExecution', listenerFunc: (data: { executionId: string; name: string; params: any; }) => void) => Promise<PluginListenerHandle>
+```
+
+Called when a registered agent tool should execute.
+
+| Param              | Type                                                                                |
+| ------------------ | ----------------------------------------------------------------------------------- |
+| **`eventName`**    | <code>'agentToolExecution'</code>                                                   |
+| **`listenerFunc`** | <code>(data: { executionId: string; name: string; params: any; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 15.0.0
 
 --------------------
 
@@ -1643,6 +1684,13 @@ Creates a new function.
 | **`value`** | <code>string</code>            |
 
 
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
 #### GleapEventMessage
 
 | Prop       | Type                |

package/android/build.gradle

@@ -55,5 +55,5 @@ dependencies {
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
-    implementation group: 'io.gleap', name: 'gleap-android-sdk', version: '15.3.1'
+    implementation group: 'io.gleap', name: 'gleap-android-sdk', version: '15.4.0'
 }

package/android/src/main/java/io/gleapplugins/capacitor/GleapPlugin.java

@@ -12,13 +12,13 @@ import com.getcapacitor.annotation.CapacitorPlugin;
 import com.getcapacitor.annotation.Permission;
 import io.gleap.APPLICATIONTYPE;
 import io.gleap.Gleap;
-import io.gleap.GleapAiTool;
-import io.gleap.GleapAiToolParameter;
 import io.gleap.GleapLogLevel;
 import io.gleap.GleapNotInitialisedException;
 import io.gleap.GleapSessionProperties;
 import io.gleap.SurveyType;
 import io.gleap.callbacks.AiToolExecutedCallback;
+import io.gleap.callbacks.GleapAgentToolHandler;
+import io.gleap.callbacks.GleapAgentToolResultCallback;
 import io.gleap.callbacks.InitializedCallback;
 import io.gleap.callbacks.ConfigLoadedCallback;
 import io.gleap.callbacks.CustomActionCallback;
@@ -37,6 +37,9 @@ import java.io.OutputStream;
 import java.util.ArrayList;
 import java.util.Base64;
 import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
@@ -54,6 +57,7 @@ import org.json.JSONObject;
 public class GleapPlugin extends Plugin {
 
     private Gleap implementation;
+    private final Map<String, GleapAgentToolResultCallback> pendingAgentToolExecutions = new ConcurrentHashMap<>();
 
     @Override
     public void load() {
@@ -315,87 +319,53 @@ public class GleapPlugin extends Plugin {
         call.resolve(ret);
     }
 
+    /**
+     * Registers the handler for a dashboard-defined Frontend tool. Executions
+     * round-trip to JS via the agentToolExecution event and sendAgentToolResult.
+     */
     @PluginMethod
-    public void setAiTools(PluginCall call) {
-        JSONArray toolsArray = call.getArray("tools");
-        if (toolsArray == null) {
-            call.reject("Must provide tools");
+    public void registerAgentTool(PluginCall call) {
+        final String name = call.getString("name");
+        if (name == null || name.isEmpty()) {
+            call.reject("Must provide a name");
             return;
         }
 
-        List<GleapAiTool> aiTools = new ArrayList<>();
-
-        for (int i = 0; i < toolsArray.length(); i++) {
-            JSONObject toolDict = toolsArray.optJSONObject(i);
-            if (toolDict == null) {
-                continue; // Skip if it's not a JSONObject
-            }
-
-            String name = toolDict.optString("name", null);
-            String toolDescription = toolDict.optString("description", null);
-            String response = toolDict.optString("response", null);
-            String executionType = toolDict.optString("executionType", null);
-            JSONArray parametersArray = toolDict.optJSONArray("parameters");
-
-            if (name == null || toolDescription == null || response == null || parametersArray == null) {
-                continue; // Skip if any required fields are missing
-            }
-
-            List<GleapAiToolParameter> parameters = new ArrayList<>();
-
-            for (int j = 0; j < parametersArray.length(); j++) {
-                JSONObject paramDict = parametersArray.optJSONObject(j);
-                if (paramDict == null) {
-                    continue; // Skip if it's not a JSONObject
-                }
-
-                String paramName = paramDict.optString("name", null);
-                String paramDescription = paramDict.optString("description", null);
-                String type = paramDict.optString("type", null);
-                boolean required = paramDict.optBoolean("required", false);
-                JSONArray enumArray = paramDict.optJSONArray
-                        ("enum");
-                String[] enums = null;
-                if (enumArray != null) {
-                    enums = new String[enumArray.length()];
-                    for (int k = 0; k < enumArray.length(); k++) {
-                        enums[k] = enumArray.optString(k);
-                    }
-                }
-
-                if (paramName == null || paramDescription == null || type == null) {
-                    continue; // Skip if any required parameter fields are missing
-                }
+        implementation.registerAgentTool(name, new GleapAgentToolHandler() {
+            @Override
+            public void execute(JSONObject params, GleapAgentToolResultCallback callback) {
+                String executionId = UUID.randomUUID().toString();
+                pendingAgentToolExecutions.put(executionId, callback);
 
-                GleapAiToolParameter parameter = new GleapAiToolParameter(
-                        paramName,
-                        paramDescription,
-                        type,
-                        required,
-                        enums
-                );
+                JSObject eventData = new JSObject();
+                eventData.put("executionId", executionId);
+                eventData.put("name", name);
+                eventData.put("params", params != null ? params : new JSONObject());
 
-                parameters.add(parameter);
+                notifyListeners("agentToolExecution", eventData);
             }
+        });
 
-            GleapAiTool aiTool = new GleapAiTool(
-                    name,
-                    toolDescription,
-                    response,
-                    executionType,
-                    parameters.toArray(new GleapAiToolParameter[0]) // Convert List to Array
-            );
+        call.resolve();
+    }
 
-            aiTools.add(aiTool);
+    /**
+     * Resolves a pending agent tool execution with the handler's result.
+     */
+    @PluginMethod
+    public void sendAgentToolResult(PluginCall call) {
+        String executionId = call.getString("executionId");
+        if (executionId == null || executionId.isEmpty()) {
+            call.reject("Must provide an executionId");
+            return;
         }
 
-        // Set the AI tools using the static method from Gleap SDK
-        Gleap.getInstance().setAiTools(aiTools.toArray(new GleapAiTool[0])); // Convert List to Array
+        GleapAgentToolResultCallback callback = pendingAgentToolExecutions.remove(executionId);
+        if (callback != null) {
+            callback.onResult(call.getString("result"));
+        }
 
-        // Build Json object and resolve success
-        JSObject ret = new JSObject();
-        ret.put("aiToolsSet", true);
-        call.resolve(ret);
+        call.resolve();
     }
 
     /**

package/dist/docs.json

@@ -244,25 +244,74 @@
         "slug": "setnetworklogpropstoignore"
       },
       {
-        "name": "setAiTools",
-        "signature": "(options: { tools: { name: string; description: string; response: string; executionType: \"auto\" | \"button\"; parameters: { name: string; description: string; type: \"string\" | \"number\" | \"boolean\"; required: boolean; enums?: string[]; }[]; }[]; }) => Promise<{ aiToolsSet: boolean; }>",
+        "name": "registerAgentTool",
+        "signature": "(options: { name: string; }) => Promise<void>",
         "parameters": [
           {
             "name": "options",
             "docs": "",
-            "type": "{ tools: { name: string; description: string; response: string; executionType: 'auto' | 'button'; parameters: { name: string; description: string; type: 'string' | 'number' | 'boolean'; required: boolean; enums?: string[] | undefined; }[]; }[]; }"
+            "type": "{ name: string; }"
           }
         ],
-        "returns": "Promise<{ aiToolsSet: boolean; }>",
+        "returns": "Promise<void>",
         "tags": [
           {
             "name": "since",
-            "text": "13.5.0"
+            "text": "15.0.0"
           }
         ],
-        "docs": "Sets the AI tools to use",
+        "docs": "Registers a Frontend tool defined on your AI agent in the Gleap dashboard.\nPrefer the `registerAgentTool(name, handler)` helper exported by this\npackage — it wires the agentToolExecution event and result round-trip for\nyou.",
         "complexTypes": [],
-        "slug": "setaitools"
+        "slug": "registeragenttool"
+      },
+      {
+        "name": "sendAgentToolResult",
+        "signature": "(options: { executionId: string; result: string; }) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "{ executionId: string; result: string; }"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "15.0.0"
+          }
+        ],
+        "docs": "Resolves a pending agent tool execution with the handler's result.\nUsed by the `registerAgentTool(name, handler)` helper.",
+        "complexTypes": [],
+        "slug": "sendagenttoolresult"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'agentToolExecution', listenerFunc: (data: { executionId: string; name: string; params: any; }) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'agentToolExecution'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(data: { executionId: string; name: string; params: any; }) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "15.0.0"
+          }
+        ],
+        "docs": "Called when a registered agent tool should execute.",
+        "complexTypes": [
+          "PluginListenerHandle"
+        ],
+        "slug": "addlisteneragenttoolexecution-"
       },
       {
         "name": "setTicketAttribute",
@@ -4348,6 +4397,22 @@
         }
       ]
     },
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
+        }
+      ]
+    },
     {
       "name": "GleapEventMessage",
       "slug": "gleapeventmessage",

package/dist/esm/definitions.d.ts

@@ -1,3 +1,4 @@
+import type { PluginListenerHandle } from '@capacitor/core';
 export declare type CallbackID = string;
 export interface GleapEventMessage {
     name: string;
@@ -148,27 +149,36 @@ export interface GleapPlugin {
         propsToIgnoreSet: boolean;
     }>;
     /**
-    * Sets the AI tools to use
+    * Registers a Frontend tool defined on your AI agent in the Gleap dashboard.
+    * Prefer the `registerAgentTool(name, handler)` helper exported by this
+    * package — it wires the agentToolExecution event and result round-trip for
+    * you.
     *
-    * @since 13.5.0
+    * @since 15.0.0
     */
-    setAiTools(options: {
-        tools: {
-            name: string;
-            description: string;
-            response: string;
-            executionType: "auto" | "button";
-            parameters: {
-                name: string;
-                description: string;
-                type: "string" | "number" | "boolean";
-                required: boolean;
-                enums?: string[];
-            }[];
-        }[];
-    }): Promise<{
-        aiToolsSet: boolean;
-    }>;
+    registerAgentTool(options: {
+        name: string;
+    }): Promise<void>;
+    /**
+    * Resolves a pending agent tool execution with the handler's result.
+    * Used by the `registerAgentTool(name, handler)` helper.
+    *
+    * @since 15.0.0
+    */
+    sendAgentToolResult(options: {
+        executionId: string;
+        result: string;
+    }): Promise<void>;
+    /**
+    * Called when a registered agent tool should execute.
+    *
+    * @since 15.0.0
+    */
+    addListener(eventName: 'agentToolExecution', listenerFunc: (data: {
+        executionId: string;
+        name: string;
+        params: any;
+    }) => void): Promise<PluginListenerHandle>;
     /**
     * Sets the value of a ticket attribute
     *

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type CallbackID = string;\n\nexport interface GleapEventMessage {\n  name: string,\n  data?: any,\n}\n\nexport type GleapEventCallback = (message: GleapEventMessage | null, err?: any) => void;\n\nexport interface GleapPlugin {\n  /**\n  * Initialize Gleap with an API key\n  *\n  * @since 7.0.0\n  */\n  initialize(options: {\n    API_KEY: string;\n  }): Promise<{\n    initialized: boolean;\n  }>;\n\n  /**\n  * Set user identity\n  *\n  * @since 7.0.0\n  */\n  identify(options: {\n    userId: string;\n    userHash?: string;\n    name?: string;\n    email?: string;\n    phone?: string;\n    companyId?: string;\n    companyName?: string;\n    avatar?: string;\n    sla?: number;\n    plan?: string;\n    value?: number;\n    customData?: Object;\n  }): Promise<{\n    identify: boolean;\n  }>;\n\n  /**\n  * Update user properties\n  *\n  * @since 13.2.1\n  */\n  updateContact(options: {\n    name?: string;\n    email?: string;\n    phone?: string;\n    companyId?: string;\n    companyName?: string;\n    avatar?: string;\n    sla?: number;\n    plan?: string;\n    value?: number;\n    customData?: Object;\n  }): Promise<{\n    identify: boolean;\n  }>;\n\n  /**\n  * Clear user identity\n  *\n  * @since 7.0.0\n  */\n  clearIdentity(): Promise<{\n    clearIdentity: boolean;\n  }>;\n\n  /**\n  * Get the current user identity\n  *\n  * @since 8.1.0\n  */\n  getIdentity(): Promise<{\n    identity: {\n      userId: string;\n      name?: string;\n      email?: string;\n      phone?: string;\n      value?: number;\n    };\n  }>;\n\n  /**\n  * User identified status.\n  *\n  * @since 8.1.0\n  */\n  isUserIdentified(): Promise<{\n    isUserIdentified: boolean;\n  }>;\n\n  /**\n  * Submit a custom log message with the given level\n  *\n  * @since 7.0.0\n  */\n  log(options: {\n    message: string;\n    logLevel?: \"ERROR\" | \"WARNING\" | \"INFO\";\n  }): Promise<{\n    logged: boolean;\n  }>;\n\n  /**\n  * Manually show a survey.\n  *\n  * @since 8.5.1\n  */\n  showSurvey(options: {\n    surveyId: string;\n    format?: \"survey\" | \"survey_full\";\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Add custom data\n  *\n  * @since 7.0.0\n  */\n  attachCustomData(options: {\n    data: any;\n  }): Promise<{\n    attachedCustomData: boolean;\n  }>;\n\n  /**\n  * Set tags\n  *\n  * @since 8.6.0\n  */\n  setTags(options: {\n    tags: string[];\n  }): Promise<{\n    tagsSet: boolean;\n  }>;\n\n  /**\n  * Set network logs blacklist\n  *\n  * @since 13.2.1\n  */\n  setNetworkLogsBlacklist(options: {\n    blacklist: string[];\n  }): Promise<{\n    blacklistSet: boolean;\n  }>;\n\n  /**\n  * Set network logs props to ignore\n  *\n  * @since 13.2.1\n  */\n  setNetworkLogPropsToIgnore(options: {\n    propsToIgnore: string[];\n  }): Promise<{\n    propsToIgnoreSet: boolean;\n  }>;\n\n  /**\n  * Sets the AI tools to use\n  *\n  * @since 13.5.0\n  */\n  setAiTools(options: {\n    tools: {\n      name: string;\n      description: string;\n      response: string;\n      executionType: \"auto\" | \"button\";\n      parameters: {\n        name: string;\n        description: string;\n        type: \"string\" | \"number\" | \"boolean\";\n        required: boolean;\n        enums?: string[];\n      }[];\n    }[];\n  }): Promise<{\n    aiToolsSet: boolean;\n  }>;\n\n  /**\n  * Sets the value of a ticket attribute\n  *\n  * @since 13.5.0\n  */\n  setTicketAttribute(options: {\n    key: string;\n    value: string;\n  }): Promise<{\n    setTicketAttribute: boolean;\n  }>;\n\n  /**\n  * Unset a ticket attribute\n  *\n  * @since 14.1.0\n  */\n  unsetTicketAttribute(options: {\n    key: string;\n  }): Promise<{\n    unsetTicketAttribute: boolean;\n  }>;\n\n  /**\n  * Clear all ticket attributes\n  *\n  * @since 14.1.0\n  */\n  clearTicketAttributes(): Promise<{\n    clearTicketAttributes: boolean;\n  }>;\n\n  /**\n  * Set custom data\n  *\n  * @since 7.0.0\n  */\n  setCustomData(options: {\n    key: string;\n    value: string;\n  }): Promise<{\n    setCustomData: boolean;\n  }>;\n\n  /**\n  * Remove custom data by key\n  *\n  * @since 7.0.0\n  */\n  removeCustomData(options: {\n    key: string;\n  }): Promise<{\n    removedCustomData: boolean;\n  }>;\n\n  /**\n  * Clear custom data\n  *\n  * @since 7.0.0\n  */\n  clearCustomData(): Promise<{\n    clearedCustomData: boolean;\n  }>;\n\n  /**\n  * Log event to Gleap\n  *\n  * @since 8.0.0\n  */\n  trackEvent(options: {\n    name: string;\n    data?: any;\n  }): Promise<{\n    loggedEvent: boolean;\n  }>;\n\n  /**\n  * Track a page view\n  *\n  * @since 8.4.1\n  */\n  trackPage(options: {\n    pageName: string;\n  }): Promise<{\n    trackedPage: boolean;\n  }>;\n\n  /**\n   * \n   *\n   * @since 7.0.0\n   */\n  setEventCallback(\n    callback: GleapEventCallback,\n  ): Promise<CallbackID>;\n\n  /**\n * Log event to Gleap\n *\n * @since 7.0.0\n */\n  sendSilentCrashReport(options: {\n    description: string,\n    severity?: \"LOW\" | \"MEDIUM\" | \"HIGH\";\n    dataExclusion?: {\n      customData: Boolean;\n      metaData: Boolean;\n      attachments: Boolean;\n      consoleLog: Boolean;\n      networkLogs: Boolean;\n      customEventLog: Boolean;\n      screenshot: Boolean;\n      replays: Boolean;\n    };\n  }): Promise<{\n    sentSilentBugReport: boolean;\n  }>;\n\n  /**\n  * Prefills the widget's form data\n  *\n  * @since 7.0.0\n  */\n  preFillForm(options: {\n    data: any;\n  }): Promise<{\n    preFilledForm: boolean;\n  }>;\n\n  /**\n  * Add attachment as bas64 string\n  *\n  * @since 7.0.0\n  */\n  addAttachment(options: {\n    base64data: string;\n    name: string;\n  }): Promise<{\n    attachmentAdded: boolean;\n  }>;\n\n  /**\n  * All attachments removed\n  *\n  * @since 7.0.0\n  */\n  removeAllAttachments(): Promise<{\n    allAttachmentsRemoved: boolean;\n  }>;\n\n  /**\n  * Open widget\n  *\n  * @since 7.0.0\n  */\n  open(): Promise<{\n    openedWidget: boolean;\n  }>;\n\n  /**\n  * Open news\n  *\n  * @since 8.4.0\n  */\n  openNews(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    openedNews: boolean;\n  }>;\n\n  /**\n  * Open news article\n  *\n  * @since 8.4.0\n  */\n  openNewsArticle(options: {\n    articleId: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open help center\n  *\n  * @since 8.4.0\n  */\n  openHelpCenter(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open help center article\n  *\n  * @since 8.4.0\n  */\n  openHelpCenterArticle(options: {\n    articleId: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Ask the AI a question\n  *\n  * @since 15.0.0\n  */\n  askAI(options: {\n    question: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open help center collection\n  *\n  * @since 8.4.0\n  */\n  openHelpCenterCollection(options: {\n    collectionId: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Search help center\n  *\n  * @since 8.4.0\n  */\n  searchHelpCenter(options: {\n    term: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open feature requests\n  *\n  * @since 8.4.0\n  */\n  openFeatureRequests(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    openedFeatureRequests: boolean;\n  }>;\n\n  /**\n  * Close widget\n  *\n  * @since 7.0.0\n  */\n  close(): Promise<{\n    closedWidget: boolean;\n  }>;\n\n  /**\n  * Check widget status code\n  *\n  * @since 7.0.0\n  */\n  isOpened(): Promise<{\n    isOpened: boolean;\n  }>;\n\n  /**\n * Start feedback flow\n *\n * @since 7.0.0\n */\n  startFeedbackFlow(options: {\n    feedbackFlow?: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    startedFeedbackFlow: boolean;\n  }>;\n\n  /**\n * Start a classic form\n *\n * @since 13.1.0\n */\n  startClassicForm(options: {\n    formId?: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    classicFormStarted: boolean;\n  }>;\n\n  /**\n * Start a new conversation\n *\n * @since 13.1.0\n */\n  startConversation(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    conversationStarted: boolean;\n  }>;\n\n  /**\n * Opens the conversations tab.\n *\n * @since 13.9.0\n */\n  openConversation(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    conversationsOpened: boolean;\n  }>;\n\n  /**\n * Start bot\n *\n * @since 10.0.3\n */\n  startBot(options: {\n    botId?: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    startedBot: boolean;\n  }>;\n\n  /**\n * Show or hide the feedback button.\n *\n * @since 8.0.0\n */\n  showFeedbackButton(options: {\n    show?: boolean;\n  }): Promise<{\n    feedbackButtonShown: boolean;\n  }>;\n\n  /**\n* Disable in app notifications.\n*\n* @since 8.6.1\n*/\n  setDisableInAppNotifications(options: {\n    disableInAppNotifications?: boolean;\n  }): Promise<{\n    inAppNotificationsDisabled: boolean;\n  }>;\n\n  /**\n * Set Language\n *\n * @since 7.0.0\n */\n  setLanguage(options: {\n    languageCode: string;\n  }): Promise<{\n    setLanguage: string;\n  }>;\n\n  /**\n * Disable console log overwrite\n *\n * @since 7.0.0\n */\n  disableConsoleLogOverwrite(): Promise<{\n    consoleLogDisabled: boolean;\n  }>;\n\n  /**\n * Enable debug console log\n *\n * @since 7.0.0\n */\n  enableDebugConsoleLog(): Promise<{\n    debugConsoleLogEnabled: boolean;\n  }>;\n\n  /**\n * Set the notification container offset\n *\n * @since 15.2.0\n */\n  setNotificationContainerOffset(options: {\n    x: number;\n    y: number;\n  }): Promise<{\n    notificationContainerOffsetSet: boolean;\n  }>;\n\n}"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport type CallbackID = string;\n\nexport interface GleapEventMessage {\n  name: string,\n  data?: any,\n}\n\nexport type GleapEventCallback = (message: GleapEventMessage | null, err?: any) => void;\n\nexport interface GleapPlugin {\n  /**\n  * Initialize Gleap with an API key\n  *\n  * @since 7.0.0\n  */\n  initialize(options: {\n    API_KEY: string;\n  }): Promise<{\n    initialized: boolean;\n  }>;\n\n  /**\n  * Set user identity\n  *\n  * @since 7.0.0\n  */\n  identify(options: {\n    userId: string;\n    userHash?: string;\n    name?: string;\n    email?: string;\n    phone?: string;\n    companyId?: string;\n    companyName?: string;\n    avatar?: string;\n    sla?: number;\n    plan?: string;\n    value?: number;\n    customData?: Object;\n  }): Promise<{\n    identify: boolean;\n  }>;\n\n  /**\n  * Update user properties\n  *\n  * @since 13.2.1\n  */\n  updateContact(options: {\n    name?: string;\n    email?: string;\n    phone?: string;\n    companyId?: string;\n    companyName?: string;\n    avatar?: string;\n    sla?: number;\n    plan?: string;\n    value?: number;\n    customData?: Object;\n  }): Promise<{\n    identify: boolean;\n  }>;\n\n  /**\n  * Clear user identity\n  *\n  * @since 7.0.0\n  */\n  clearIdentity(): Promise<{\n    clearIdentity: boolean;\n  }>;\n\n  /**\n  * Get the current user identity\n  *\n  * @since 8.1.0\n  */\n  getIdentity(): Promise<{\n    identity: {\n      userId: string;\n      name?: string;\n      email?: string;\n      phone?: string;\n      value?: number;\n    };\n  }>;\n\n  /**\n  * User identified status.\n  *\n  * @since 8.1.0\n  */\n  isUserIdentified(): Promise<{\n    isUserIdentified: boolean;\n  }>;\n\n  /**\n  * Submit a custom log message with the given level\n  *\n  * @since 7.0.0\n  */\n  log(options: {\n    message: string;\n    logLevel?: \"ERROR\" | \"WARNING\" | \"INFO\";\n  }): Promise<{\n    logged: boolean;\n  }>;\n\n  /**\n  * Manually show a survey.\n  *\n  * @since 8.5.1\n  */\n  showSurvey(options: {\n    surveyId: string;\n    format?: \"survey\" | \"survey_full\";\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Add custom data\n  *\n  * @since 7.0.0\n  */\n  attachCustomData(options: {\n    data: any;\n  }): Promise<{\n    attachedCustomData: boolean;\n  }>;\n\n  /**\n  * Set tags\n  *\n  * @since 8.6.0\n  */\n  setTags(options: {\n    tags: string[];\n  }): Promise<{\n    tagsSet: boolean;\n  }>;\n\n  /**\n  * Set network logs blacklist\n  *\n  * @since 13.2.1\n  */\n  setNetworkLogsBlacklist(options: {\n    blacklist: string[];\n  }): Promise<{\n    blacklistSet: boolean;\n  }>;\n\n  /**\n  * Set network logs props to ignore\n  *\n  * @since 13.2.1\n  */\n  setNetworkLogPropsToIgnore(options: {\n    propsToIgnore: string[];\n  }): Promise<{\n    propsToIgnoreSet: boolean;\n  }>;\n\n  /**\n  * Registers a Frontend tool defined on your AI agent in the Gleap dashboard.\n  * Prefer the `registerAgentTool(name, handler)` helper exported by this\n  * package — it wires the agentToolExecution event and result round-trip for\n  * you.\n  *\n  * @since 15.0.0\n  */\n  registerAgentTool(options: {\n    name: string;\n  }): Promise<void>;\n\n  /**\n  * Resolves a pending agent tool execution with the handler's result.\n  * Used by the `registerAgentTool(name, handler)` helper.\n  *\n  * @since 15.0.0\n  */\n  sendAgentToolResult(options: {\n    executionId: string;\n    result: string;\n  }): Promise<void>;\n\n  /**\n  * Called when a registered agent tool should execute.\n  *\n  * @since 15.0.0\n  */\n  addListener(\n    eventName: 'agentToolExecution',\n    listenerFunc: (data: {\n      executionId: string;\n      name: string;\n      params: any;\n    }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n  * Sets the value of a ticket attribute\n  *\n  * @since 13.5.0\n  */\n  setTicketAttribute(options: {\n    key: string;\n    value: string;\n  }): Promise<{\n    setTicketAttribute: boolean;\n  }>;\n\n  /**\n  * Unset a ticket attribute\n  *\n  * @since 14.1.0\n  */\n  unsetTicketAttribute(options: {\n    key: string;\n  }): Promise<{\n    unsetTicketAttribute: boolean;\n  }>;\n\n  /**\n  * Clear all ticket attributes\n  *\n  * @since 14.1.0\n  */\n  clearTicketAttributes(): Promise<{\n    clearTicketAttributes: boolean;\n  }>;\n\n  /**\n  * Set custom data\n  *\n  * @since 7.0.0\n  */\n  setCustomData(options: {\n    key: string;\n    value: string;\n  }): Promise<{\n    setCustomData: boolean;\n  }>;\n\n  /**\n  * Remove custom data by key\n  *\n  * @since 7.0.0\n  */\n  removeCustomData(options: {\n    key: string;\n  }): Promise<{\n    removedCustomData: boolean;\n  }>;\n\n  /**\n  * Clear custom data\n  *\n  * @since 7.0.0\n  */\n  clearCustomData(): Promise<{\n    clearedCustomData: boolean;\n  }>;\n\n  /**\n  * Log event to Gleap\n  *\n  * @since 8.0.0\n  */\n  trackEvent(options: {\n    name: string;\n    data?: any;\n  }): Promise<{\n    loggedEvent: boolean;\n  }>;\n\n  /**\n  * Track a page view\n  *\n  * @since 8.4.1\n  */\n  trackPage(options: {\n    pageName: string;\n  }): Promise<{\n    trackedPage: boolean;\n  }>;\n\n  /**\n   * \n   *\n   * @since 7.0.0\n   */\n  setEventCallback(\n    callback: GleapEventCallback,\n  ): Promise<CallbackID>;\n\n  /**\n * Log event to Gleap\n *\n * @since 7.0.0\n */\n  sendSilentCrashReport(options: {\n    description: string,\n    severity?: \"LOW\" | \"MEDIUM\" | \"HIGH\";\n    dataExclusion?: {\n      customData: Boolean;\n      metaData: Boolean;\n      attachments: Boolean;\n      consoleLog: Boolean;\n      networkLogs: Boolean;\n      customEventLog: Boolean;\n      screenshot: Boolean;\n      replays: Boolean;\n    };\n  }): Promise<{\n    sentSilentBugReport: boolean;\n  }>;\n\n  /**\n  * Prefills the widget's form data\n  *\n  * @since 7.0.0\n  */\n  preFillForm(options: {\n    data: any;\n  }): Promise<{\n    preFilledForm: boolean;\n  }>;\n\n  /**\n  * Add attachment as bas64 string\n  *\n  * @since 7.0.0\n  */\n  addAttachment(options: {\n    base64data: string;\n    name: string;\n  }): Promise<{\n    attachmentAdded: boolean;\n  }>;\n\n  /**\n  * All attachments removed\n  *\n  * @since 7.0.0\n  */\n  removeAllAttachments(): Promise<{\n    allAttachmentsRemoved: boolean;\n  }>;\n\n  /**\n  * Open widget\n  *\n  * @since 7.0.0\n  */\n  open(): Promise<{\n    openedWidget: boolean;\n  }>;\n\n  /**\n  * Open news\n  *\n  * @since 8.4.0\n  */\n  openNews(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    openedNews: boolean;\n  }>;\n\n  /**\n  * Open news article\n  *\n  * @since 8.4.0\n  */\n  openNewsArticle(options: {\n    articleId: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open help center\n  *\n  * @since 8.4.0\n  */\n  openHelpCenter(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open help center article\n  *\n  * @since 8.4.0\n  */\n  openHelpCenterArticle(options: {\n    articleId: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Ask the AI a question\n  *\n  * @since 15.0.0\n  */\n  askAI(options: {\n    question: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open help center collection\n  *\n  * @since 8.4.0\n  */\n  openHelpCenterCollection(options: {\n    collectionId: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Search help center\n  *\n  * @since 8.4.0\n  */\n  searchHelpCenter(options: {\n    term: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    opened: boolean;\n  }>;\n\n  /**\n  * Open feature requests\n  *\n  * @since 8.4.0\n  */\n  openFeatureRequests(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    openedFeatureRequests: boolean;\n  }>;\n\n  /**\n  * Close widget\n  *\n  * @since 7.0.0\n  */\n  close(): Promise<{\n    closedWidget: boolean;\n  }>;\n\n  /**\n  * Check widget status code\n  *\n  * @since 7.0.0\n  */\n  isOpened(): Promise<{\n    isOpened: boolean;\n  }>;\n\n  /**\n * Start feedback flow\n *\n * @since 7.0.0\n */\n  startFeedbackFlow(options: {\n    feedbackFlow?: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    startedFeedbackFlow: boolean;\n  }>;\n\n  /**\n * Start a classic form\n *\n * @since 13.1.0\n */\n  startClassicForm(options: {\n    formId?: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    classicFormStarted: boolean;\n  }>;\n\n  /**\n * Start a new conversation\n *\n * @since 13.1.0\n */\n  startConversation(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    conversationStarted: boolean;\n  }>;\n\n  /**\n * Opens the conversations tab.\n *\n * @since 13.9.0\n */\n  openConversation(options: {\n    showBackButton?: boolean;\n  }): Promise<{\n    conversationsOpened: boolean;\n  }>;\n\n  /**\n * Start bot\n *\n * @since 10.0.3\n */\n  startBot(options: {\n    botId?: string;\n    showBackButton?: boolean;\n  }): Promise<{\n    startedBot: boolean;\n  }>;\n\n  /**\n * Show or hide the feedback button.\n *\n * @since 8.0.0\n */\n  showFeedbackButton(options: {\n    show?: boolean;\n  }): Promise<{\n    feedbackButtonShown: boolean;\n  }>;\n\n  /**\n* Disable in app notifications.\n*\n* @since 8.6.1\n*/\n  setDisableInAppNotifications(options: {\n    disableInAppNotifications?: boolean;\n  }): Promise<{\n    inAppNotificationsDisabled: boolean;\n  }>;\n\n  /**\n * Set Language\n *\n * @since 7.0.0\n */\n  setLanguage(options: {\n    languageCode: string;\n  }): Promise<{\n    setLanguage: string;\n  }>;\n\n  /**\n * Disable console log overwrite\n *\n * @since 7.0.0\n */\n  disableConsoleLogOverwrite(): Promise<{\n    consoleLogDisabled: boolean;\n  }>;\n\n  /**\n * Enable debug console log\n *\n * @since 7.0.0\n */\n  enableDebugConsoleLog(): Promise<{\n    debugConsoleLogEnabled: boolean;\n  }>;\n\n  /**\n * Set the notification container offset\n *\n * @since 15.2.0\n */\n  setNotificationContainerOffset(options: {\n    x: number;\n    y: number;\n  }): Promise<{\n    notificationContainerOffsetSet: boolean;\n  }>;\n\n}"]}

package/dist/esm/index.d.ts

@@ -1,4 +1,11 @@
 import type { GleapPlugin } from './definitions';
 declare const Gleap: GleapPlugin;
+/**
+ * Registers the handler for a Frontend tool defined on your AI agent in the
+ * Gleap dashboard. The agent calls the handler with the configured parameters
+ * and waits for the returned result (string or object, which gets
+ * stringified).
+ */
+declare const registerAgentTool: (name: string, handler: (params: any) => any | Promise<any>) => Promise<void>;
 export * from './definitions';
-export { Gleap };
+export { Gleap, registerAgentTool };

package/dist/esm/index.js

@@ -2,6 +2,57 @@ import { registerPlugin } from '@capacitor/core';
 const Gleap = registerPlugin('Gleap', {
     web: () => import('./web').then(m => new m.GleapWeb()),
 });
+const registeredAgentTools = {};
+let agentToolListenerAttached = false;
+/**
+ * Registers the handler for a Frontend tool defined on your AI agent in the
+ * Gleap dashboard. The agent calls the handler with the configured parameters
+ * and waits for the returned result (string or object, which gets
+ * stringified).
+ */
+const registerAgentTool = async (name, handler) => {
+    if (!name || typeof handler !== 'function') {
+        return;
+    }
+    registeredAgentTools[name] = handler;
+    if (!agentToolListenerAttached) {
+        agentToolListenerAttached = true;
+        await Gleap.addListener('agentToolExecution', async (data) => {
+            var _a;
+            try {
+                const { executionId, name: toolName, params } = data !== null && data !== void 0 ? data : {};
+                if (!executionId || !toolName) {
+                    return;
+                }
+                let result;
+                const toolHandler = registeredAgentTools[toolName];
+                if (!toolHandler) {
+                    result = `No handler registered for tool '${toolName}' in the app. Register one via Gleap.registerAgentTool('${toolName}', handler).`;
+                }
+                else {
+                    try {
+                        const handlerResult = await toolHandler(params !== null && params !== void 0 ? params : {});
+                        result =
+                            typeof handlerResult === 'string'
+                                ? handlerResult
+                                : JSON.stringify(handlerResult !== null && handlerResult !== void 0 ? handlerResult : '');
+                        if (!result) {
+                            result = 'The action completed without returning a result.';
+                        }
+                    }
+                    catch (error) {
+                        result = `Tool execution failed: ${(_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : 'unknown error'}`;
+                    }
+                }
+                await Gleap.sendAgentToolResult({ executionId, result });
+            }
+            catch (exp) {
+                // Ignore.
+            }
+        });
+    }
+    await Gleap.registerAgentTool({ name });
+};
 export * from './definitions';
-export { Gleap };
+export { Gleap, registerAgentTool };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,KAAK,GAAG,cAAc,CAAc,OAAO,EAAE;IACjD,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;CACvD,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { GleapPlugin } from './definitions';\n\nconst Gleap = registerPlugin<GleapPlugin>('Gleap', {\n  web: () => import('./web').then(m => new m.GleapWeb()),\n});\n\nexport * from './definitions';\nexport { Gleap };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,KAAK,GAAG,cAAc,CAAc,OAAO,EAAE;IACjD,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAEtB,EAAE,CAAC;AACP,IAAI,yBAAyB,GAAG,KAAK,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,KAAK,EAC7B,IAAY,EACZ,OAA4C,EAC7B,EAAE;IACjB,IAAI,CAAC,IAAI,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;QAC1C,OAAO;KACR;IAED,oBAAoB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAErC,IAAI,CAAC,yBAAyB,EAAE;QAC9B,yBAAyB,GAAG,IAAI,CAAC;QAEjC,MAAM,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;;YACzD,IAAI;gBACF,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAK,EAAU,CAAC;gBACpE,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,EAAE;oBAC7B,OAAO;iBACR;gBAED,IAAI,MAAM,CAAC;gBACX,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;gBACnD,IAAI,CAAC,WAAW,EAAE;oBAChB,MAAM,GAAG,mCAAmC,QAAQ,2DAA2D,QAAQ,cAAc,CAAC;iBACvI;qBAAM;oBACL,IAAI;wBACF,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAC;wBACtD,MAAM;4BACJ,OAAO,aAAa,KAAK,QAAQ;gCAC/B,CAAC,CAAC,aAAa;gCACf,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,EAAE,CAAC,CAAC;wBAC1C,IAAI,CAAC,MAAM,EAAE;4BACX,MAAM,GAAG,kDAAkD,CAAC;yBAC7D;qBACF;oBAAC,OAAO,KAAU,EAAE;wBACnB,MAAM,GAAG,0BACP,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,mCAAI,eACpB,EAAE,CAAC;qBACJ;iBACF;gBAED,MAAM,KAAK,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;aAC1D;YAAC,OAAO,GAAG,EAAE;gBACZ,UAAU;aACX;QACH,CAAC,CAAC,CAAC;KACJ;IAED,MAAM,KAAK,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { GleapPlugin } from './definitions';\n\nconst Gleap = registerPlugin<GleapPlugin>('Gleap', {\n  web: () => import('./web').then(m => new m.GleapWeb()),\n});\n\nconst registeredAgentTools: {\n  [name: string]: (params: any) => any | Promise<any>;\n} = {};\nlet agentToolListenerAttached = false;\n\n/**\n * Registers the handler for a Frontend tool defined on your AI agent in the\n * Gleap dashboard. The agent calls the handler with the configured parameters\n * and waits for the returned result (string or object, which gets\n * stringified).\n */\nconst registerAgentTool = async (\n  name: string,\n  handler: (params: any) => any | Promise<any>,\n): Promise<void> => {\n  if (!name || typeof handler !== 'function') {\n    return;\n  }\n\n  registeredAgentTools[name] = handler;\n\n  if (!agentToolListenerAttached) {\n    agentToolListenerAttached = true;\n\n    await Gleap.addListener('agentToolExecution', async data => {\n      try {\n        const { executionId, name: toolName, params } = data ?? ({} as any);\n        if (!executionId || !toolName) {\n          return;\n        }\n\n        let result;\n        const toolHandler = registeredAgentTools[toolName];\n        if (!toolHandler) {\n          result = `No handler registered for tool '${toolName}' in the app. Register one via Gleap.registerAgentTool('${toolName}', handler).`;\n        } else {\n          try {\n            const handlerResult = await toolHandler(params ?? {});\n            result =\n              typeof handlerResult === 'string'\n                ? handlerResult\n                : JSON.stringify(handlerResult ?? '');\n            if (!result) {\n              result = 'The action completed without returning a result.';\n            }\n          } catch (error: any) {\n            result = `Tool execution failed: ${\n              error?.message ?? 'unknown error'\n            }`;\n          }\n        }\n\n        await Gleap.sendAgentToolResult({ executionId, result });\n      } catch (exp) {\n        // Ignore.\n      }\n    });\n  }\n\n  await Gleap.registerAgentTool({ name });\n};\n\nexport * from './definitions';\nexport { Gleap, registerAgentTool };\n"]}

package/dist/esm/web.d.ts

@@ -5,29 +5,21 @@ export declare class GleapWeb extends WebPlugin implements GleapPlugin {
         [key: string]: GleapEventCallback;
     };
     static initialized: boolean;
+    static agentToolExecutionCounter: number;
+    private pendingAgentToolExecutions;
     initialize(options: {
         API_KEY: string;
     }): Promise<{
         initialized: boolean;
     }>;
     registerCallbackListeners(): void;
-    setAiTools(options: {
-        tools: {
-            name: string;
-            description: string;
-            response: string;
-            executionType: 'auto' | 'button';
-            parameters: {
-                name: string;
-                description: string;
-                type: 'string' | 'number' | 'boolean';
-                required: boolean;
-                enums?: string[] | undefined;
-            }[];
-        }[];
-    }): Promise<{
-        aiToolsSet: boolean;
-    }>;
+    registerAgentTool(options: {
+        name: string;
+    }): Promise<void>;
+    sendAgentToolResult(options: {
+        executionId: string;
+        result: string;
+    }): Promise<void>;
     setTicketAttribute(options: {
         key: string;
         value: string;