Update doc strings for invocation_state

Author: zastrowm

src/strands/tools/decorator.py

@@ -265,7 +265,8 @@ def inject_special_parameters(
         Args:
             validated_input: The validated input parameters (modified in place).
             tool_use: The tool use request containing tool invocation details.
-            invocation_state: Context for the tool invocation, including agent state.
+            invocation_state: Caller-provided kwargs that were passed to the agent when it was invoked (agent(),
+                              agent.invoke_async(), etc.).
         """
         if self._context_param and self._context_param in self.signature.parameters:
             tool_context = ToolContext(
@@ -435,7 +436,8 @@ async def stream(self, tool_use: ToolUse, invocation_state: dict[str, Any], **kw
 
         Args:
             tool_use: The tool use specification from the Agent.
-            invocation_state: Context for the tool invocation, including agent state.
+            invocation_state: Caller-provided kwargs that were passed to the agent when it was invoked (agent(),
+                              agent.invoke_async(), etc.).
             **kwargs: Additional keyword arguments for future extensibility.
 
         Yields:

src/strands/types/tools.py

@@ -132,8 +132,8 @@ class ToolContext:
         tool_use: The complete ToolUse object containing tool invocation details.
         agent: The Agent instance executing this tool, providing access to conversation history,
                model configuration, and other agent state.
-        invocation_state: Keyword arguments passed to agent invocation methods (agent(), agent.invoke_async(), etc.).
-                          Provides access to invocation-specific context and parameters.
+        invocation_state: Caller-provided kwargs that were passed to the agent when it was invoked (agent(),
+                          agent.invoke_async(), etc.).
 
     Note:
         This class is intended to be instantiated by the SDK. Direct construction by users
@@ -249,7 +249,8 @@ def stream(self, tool_use: ToolUse, invocation_state: dict[str, Any], **kwargs:
 
         Args:
             tool_use: The tool use request containing tool ID and parameters.
-            invocation_state: Context for the tool invocation, including agent state.
+            invocation_state: Caller-provided kwargs that were passed to the agent when it was invoked (agent(),
+                              agent.invoke_async(), etc.).
             **kwargs: Additional keyword arguments for future extensibility.
 
         Yields: