docstrings - fix formatting (strands-agents#456)

Author: pgrayy

src/strands/agent/agent.py

@@ -479,9 +479,10 @@ async def stream_async(self, prompt: Union[str, list[ContentBlock]], **kwargs: A
             prompt: User input as text or list of ContentBlock objects for multi-modal content.
             **kwargs: Additional parameters to pass to the event loop.
 
-        Returns:
+        Yields:
             An async iterator that yields events. Each event is a dictionary containing
             information about the current state of processing, such as:
+
             - data: Text content being generated
             - complete: Whether this is the final chunk
             - current_tool_use: Information about tools being executed

src/strands/event_loop/streaming.py

@@ -253,7 +253,7 @@ async def process_stream(chunks: AsyncIterable[StreamEvent]) -> AsyncGenerator[d
     Args:
         chunks: The chunks of the response stream from the model.
 
-    Returns:
+    Yields:
         The reason for stopping, the constructed message, and the usage metrics.
     """
     stop_reason: StopReason = "end_turn"
@@ -306,7 +306,7 @@ async def stream_messages(
         messages: List of messages to send.
         tool_specs: The list of tool specs.
 
-    Returns:
+    Yields:
         The reason for stopping, the final message, and the usage metrics
     """
     logger.debug("model=<%s> | streaming messages", model)

src/strands/models/model.py

@@ -74,6 +74,7 @@ def stream(
         """Stream conversation with the model.
 
         This method handles the full lifecycle of conversing with the model:
+
         1. Format the messages, tool specs, and configuration into a streaming request
         2. Send the request to the model
         3. Yield the formatted message chunks

src/strands/tools/tools.py

@@ -207,7 +207,7 @@ async def stream(self, tool_use: ToolUse, invocation_state: dict[str, Any], **kw
             **kwargs: Additional keyword arguments for future extensibility.
 
         Yields:
-        Tool events with the last being the tool result.
+            Tool events with the last being the tool result.
         """
         if inspect.iscoroutinefunction(self._tool_func):
             result = await self._tool_func(tool_use, **invocation_state)

src/strands/types/tools.py

@@ -224,7 +224,7 @@ def stream(self, tool_use: ToolUse, invocation_state: dict[str, Any], **kwargs:
             invocation_state: Context for the tool invocation, including agent state.
             **kwargs: Additional keyword arguments for future extensibility.
 
-        Yield:
+        Yields:
             Tool events with the last being the tool result.
         """
         ...