fix: only construct agent when explicitly requested as a listener argument

mwbrooks · mwbrooks · commit 721b634279df · 2026-02-15T22:08:18.000-08:00
diff --git a/slack_bolt/kwargs_injection/async_utils.py b/slack_bolt/kwargs_injection/async_utils.py
@@ -86,7 +86,7 @@ def build_async_required_kwargs(
             all_available_args[k] = v
 
     # Defer agent creation to avoid constructing AsyncBoltAgent on every request
-    if "agent" in required_arg_names or "args" in required_arg_names:
+    if "agent" in required_arg_names:
         from slack_bolt.agent.async_agent import AsyncBoltAgent
 
         all_available_args["agent"] = AsyncBoltAgent(
@@ -96,12 +96,11 @@ def build_async_required_kwargs(
             team_id=request.context.team_id,
             user_id=request.context.user_id,
         )
-        if "agent" in required_arg_names:
-            warnings.warn(
-                "The agent listener argument is experimental and may change in future versions.",
-                category=ExperimentalWarning,
-                stacklevel=2,  # Point to the caller, not this internal helper
-            )
+        warnings.warn(
+            "The agent listener argument is experimental and may change in future versions.",
+            category=ExperimentalWarning,
+            stacklevel=2,  # Point to the caller, not this internal helper
+        )
 
     if len(required_arg_names) > 0:
         # To support instance/class methods in a class for listeners/middleware,
diff --git a/slack_bolt/kwargs_injection/utils.py b/slack_bolt/kwargs_injection/utils.py
@@ -85,7 +85,7 @@ def build_required_kwargs(
             all_available_args[k] = v
 
     # Defer agent creation to avoid constructing BoltAgent on every request
-    if "agent" in required_arg_names or "args" in required_arg_names:
+    if "agent" in required_arg_names:
         from slack_bolt.agent.agent import BoltAgent
 
         all_available_args["agent"] = BoltAgent(
@@ -95,12 +95,11 @@ def build_required_kwargs(
             team_id=request.context.team_id,
             user_id=request.context.user_id,
         )
-        if "agent" in required_arg_names:
-            warnings.warn(
-                "The agent listener argument is experimental and may change in future versions.",
-                category=ExperimentalWarning,
-                stacklevel=2,  # Point to the caller, not this internal helper
-            )
+        warnings.warn(
+            "The agent listener argument is experimental and may change in future versions.",
+            category=ExperimentalWarning,
+            stacklevel=2,  # Point to the caller, not this internal helper
+        )
 
     if len(required_arg_names) > 0:
         # To support instance/class methods in a class for listeners/middleware,
