feat: emit "MCPHubApprovalWindow(Opened/Closed)" events for custom integrations (rel #236)

Author: ravitemer

doc/configuration.md

@@ -321,13 +321,14 @@ require("mcphub").setup({
 - `params.action` - Either "use_mcp_tool" or "access_mcp_resource"
 - `params.uri` - Resource URI (for resource access)
 - `params.is_auto_approved_in_server` - Boolean indicating if tool is configured for auto-approval in servers.json
-
 **Return values:**
 - `true` - Auto-approve the call
 - `false` - Show confirmation prompt
 - `string` - Deny with error message
 - `nil` - Show confirmation prompt (same as false)
 
+**Events:** When the confirmation window is shown, MCPHub fires `MCPHubApprovalWindowOpened` and `MCPHubApprovalWindowClosed` events that can be used for sound notifications or other integrations.
+
 #### Server-Level Auto-Approval
 
 For fine-grained control per server or tool, configure auto-approval using the `autoApprove` field in your `servers.json`. You can also toggle auto-approval from the Hub UI using the `a` keymap on individual servers or tools. See [servers.json configuration](/mcp/servers_json#auto-approval-configuration) for detailed examples and configuration options.

lua/mcphub/extensions/shared.lua

@@ -266,10 +266,30 @@ function M.show_mcp_tool_prompt(params)
         end
     end
 
-    return require("mcphub.utils.ui").confirm(lines, {
+    -- Fire event before showing confirmation window
+    utils.fire("MCPHubApprovalWindowOpened", {
+        action = action_name,
+        server_name = server_name,
+        tool_name = tool_name,
+        uri = uri,
+        arguments = arguments,
+    })
+    local confirmed, cancelled = require("mcphub.utils.ui").confirm(lines, {
         min_width = 70,
         max_width = 100,
     })
+    -- Fire event after user makes decision
+    utils.fire("MCPHubApprovalWindowClosed", {
+        action = action_name,
+        server_name = server_name,
+        tool_name = tool_name,
+        uri = uri,
+        arguments = arguments,
+        confirmed = confirmed,
+        cancelled = cancelled,
+    })
+
+    return confirmed, cancelled
 end
 
 ---@param parsed_params MCPHub.ParsedParams