fast-agent-mcp 0.3.12__tar.gz → 0.3.13__tar.gz

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.12
+Version: 0.3.13
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License
@@ -208,7 +208,7 @@ License-File: LICENSE
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.13.5
+Requires-Python: <3.14,>=3.13.5
 Requires-Dist: a2a-sdk>=0.3.6
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.69.0
@@ -249,15 +249,24 @@ Description-Content-Type: text/markdown
 ## Overview
 
 > [!TIP]
-> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. There is also an LLMs.txt [here](https://fast-agent.ai/llms.txt)
+> Please see : https://fast-agent.ai for latest documentation. There is also an LLMs.txt [here](https://fast-agent.ai/llms.txt)
 
-**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Model support is comprehensive with native support for Anthropic, OpenAI and Google as well as Azure, Ollama, Deepseek and dozens of others via TensorZero.
+**`fast-agent`** enables you to create and interact with sophisticated multimodal Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling and Elicitations.
 
-![multi_model_trim](https://github.com/user-attachments/assets/c8bf7474-2c41-4ef3-8924-06e29907d7c6)
+<!-- ![multi_model_trim](https://github.com/user-attachments/assets/c8bf7474-2c41-4ef3-8924-06e29907d7c6) -->
 
 The simple declarative syntax lets you concentrate on composing your Prompts and MCP Servers to [build effective agents](https://www.anthropic.com/research/building-effective-agents).
 
-`fast-agent` is multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints via Prompts, Resources and MCP Tool Call results. The inclusion of passthrough and playback LLMs enable rapid development and test of Python glue-code for your applications.
+Model support is comprehensive with native support for Anthropic, OpenAI and Google providers as well as Azure, Ollama, Deepseek and dozens of others via TensorZero. Structured Outputs, PDF and Vision support is simple to use and well tested. Passthrough and Playback LLMs enable rapid development and test of Python glue-code for your applications.
+
+<img width="800"  alt="MCP Transport Diagnostics" src="https://github.com/user-attachments/assets/e26472de-58d9-4726-8bdd-01eb407414cf" />
+
+
+`fast-agent` is the only tool that allows you to inspect Streamable HTTP Transport usage - a critical feature for ensuring reliable, compliant deployments. OAuth is supported with KeyRing storage for secrets. Use the `fast-agent auth` command to manage.
+
+
+
+
 
 > [!IMPORTANT]
 >

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/README.md

@@ -10,15 +10,24 @@
 ## Overview
 
 > [!TIP]
-> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. There is also an LLMs.txt [here](https://fast-agent.ai/llms.txt)
+> Please see : https://fast-agent.ai for latest documentation. There is also an LLMs.txt [here](https://fast-agent.ai/llms.txt)
 
-**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Model support is comprehensive with native support for Anthropic, OpenAI and Google as well as Azure, Ollama, Deepseek and dozens of others via TensorZero.
+**`fast-agent`** enables you to create and interact with sophisticated multimodal Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling and Elicitations.
 
-![multi_model_trim](https://github.com/user-attachments/assets/c8bf7474-2c41-4ef3-8924-06e29907d7c6)
+<!-- ![multi_model_trim](https://github.com/user-attachments/assets/c8bf7474-2c41-4ef3-8924-06e29907d7c6) -->
 
 The simple declarative syntax lets you concentrate on composing your Prompts and MCP Servers to [build effective agents](https://www.anthropic.com/research/building-effective-agents).
 
-`fast-agent` is multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints via Prompts, Resources and MCP Tool Call results. The inclusion of passthrough and playback LLMs enable rapid development and test of Python glue-code for your applications.
+Model support is comprehensive with native support for Anthropic, OpenAI and Google providers as well as Azure, Ollama, Deepseek and dozens of others via TensorZero. Structured Outputs, PDF and Vision support is simple to use and well tested. Passthrough and Playback LLMs enable rapid development and test of Python glue-code for your applications.
+
+<img width="800"  alt="MCP Transport Diagnostics" src="https://github.com/user-attachments/assets/e26472de-58d9-4726-8bdd-01eb407414cf" />
+
+
+`fast-agent` is the only tool that allows you to inspect Streamable HTTP Transport usage - a critical feature for ensuring reliable, compliant deployments. OAuth is supported with KeyRing storage for secrets. Use the `fast-agent auth` command to manage.
+
+
+
+
 
 > [!IMPORTANT]
 >

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.3.12"
+version = "0.3.13"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -12,7 +12,7 @@ classifiers = [
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent"
 ]
-requires-python = ">=3.13.5"
+requires-python = ">=3.13.5,<3.14"
 dependencies = [
     "fastapi>=0.115.6",
     "mcp==1.16.0",

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/src/fast_agent/agents/llm_agent.py

@@ -170,7 +170,7 @@ class LlmAgent(LlmDecorator):
                 combined += segment
             additional_message_text = combined
 
-        message_text = message.last_text() or ""
+        message_text = message
 
         # Use provided name/model or fall back to defaults
         display_name = name if name is not None else self.name

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/src/fast_agent/llm/provider/google/google_converter.py

@@ -53,6 +53,14 @@ class GoogleConverter:
             if key in unsupported_keys:
                 continue  # Skip this key
 
+            # Rewrite unsupported 'const' to a safe form for Gemini tools
+            # - For string const, convert to enum [value]
+            # - For non-string const (booleans/numbers), drop the constraint
+            if key == "const":
+                if isinstance(value, str):
+                    cleaned_schema["enum"] = [value]
+                continue
+
             if (
                 key == "format"
                 and schema.get("type") == "string"
@@ -140,9 +148,8 @@ class GoogleConverter:
                     )
                 elif is_resource_content(part_content):
                     assert isinstance(part_content, EmbeddedResource)
-                    if (
-                        "application/pdf" == part_content.resource.mimeType
-                        and isinstance(part_content.resource, BlobResourceContents)
+                    if "application/pdf" == part_content.resource.mimeType and isinstance(
+                        part_content.resource, BlobResourceContents
                     ):
                         pdf_bytes = base64.b64decode(part_content.resource.blob)
                         parts.append(

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/src/fast_agent/mcp/mcp_agent_client_session.py

@@ -4,6 +4,7 @@ It adds logging and supports sampling requests.
 """
 
 from datetime import timedelta
+from time import perf_counter
 from typing import TYPE_CHECKING
 
 from mcp import ClientSession, ServerNotification
@@ -207,6 +208,7 @@ class MCPAgentClientSession(ClientSession, ContextDependent):
     ) -> ReceiveResultT:
         logger.debug("send_request: request=", data=request.model_dump())
         request_id = getattr(self, "_request_id", None)
+        start_time = perf_counter()
         try:
             result = await super().send_request(
                 request=request,
@@ -220,6 +222,7 @@ class MCPAgentClientSession(ClientSession, ContextDependent):
                 data=result.model_dump() if result is not None else "no response returned",
             )
             self._attach_transport_channel(request_id, result)
+            self._attach_transport_elapsed(result, perf_counter() - start_time)
             return result
         except Exception as e:
             # Handle connection errors cleanly
@@ -250,6 +253,16 @@ class MCPAgentClientSession(ClientSession, ContextDependent):
             # If result cannot be mutated, ignore silently
             pass
 
+    @staticmethod
+    def _attach_transport_elapsed(result, elapsed: float | None) -> None:
+        if result is None or elapsed is None:
+            return
+        try:
+            setattr(result, "transport_elapsed", max(elapsed, 0.0))
+        except Exception:
+            # Ignore if result is immutable
+            pass
+
     async def _received_notification(self, notification: ServerNotification) -> None:
         """
         Can be overridden by subclasses to handle a notification without needing

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/src/fast_agent/mcp/mcp_connection_manager.py

@@ -38,6 +38,8 @@ from fast_agent.mcp.streamable_http_tracking import tracking_streamablehttp_clie
 from fast_agent.mcp.transport_tracking import TransportChannelMetrics
 
 if TYPE_CHECKING:
+    from mcp.client.auth import OAuthClientProvider
+
     from fast_agent.context import Context
     from fast_agent.mcp_server_registry import ServerRegistry
 
@@ -65,6 +67,38 @@ def _add_none_to_context(context_manager):
     return StreamingContextAdapter(context_manager)
 
 
+def _prepare_headers_and_auth(
+    server_config: MCPServerSettings,
+) -> tuple[dict[str, str], Optional["OAuthClientProvider"], set[str]]:
+    """
+    Prepare request headers and determine if OAuth authentication should be used.
+
+    Returns a copy of the headers, an OAuth auth provider when applicable, and the set
+    of user-supplied authorization header keys.
+    """
+    headers: dict[str, str] = dict(server_config.headers or {})
+    auth_header_keys = {"authorization", "x-hf-authorization"}
+    user_provided_auth_keys = {key for key in headers if key.lower() in auth_header_keys}
+
+    # OAuth is only relevant for SSE/HTTP transports and should be skipped when the
+    # user has already supplied explicit Authorization headers.
+    if server_config.transport not in ("sse", "http") or user_provided_auth_keys:
+        return headers, None, user_provided_auth_keys
+
+    oauth_auth = build_oauth_provider(server_config)
+    if oauth_auth is not None:
+        # Scrub Authorization headers so OAuth-managed credentials are the only ones sent.
+        for header_name in (
+            "Authorization",
+            "authorization",
+            "X-HF-Authorization",
+            "x-hf-authorization",
+        ):
+            headers.pop(header_name, None)
+
+    return headers, oauth_auth, user_provided_auth_keys
+
+
 class ServerConnection:
     """
     Represents a long-lived MCP server connection, including:
@@ -113,7 +147,9 @@ class ServerConnection:
         self.server_implementation: Implementation | None = None
         self.client_capabilities: dict | None = None
         self.server_instructions_available: bool = False
-        self.server_instructions_enabled: bool = server_config.include_instructions if server_config else True
+        self.server_instructions_enabled: bool = (
+            server_config.include_instructions if server_config else True
+        )
         self.session_id: str | None = None
         self._get_session_id_cb: GetSessionIdCallback | None = None
         self.transport_metrics: TransportChannelMetrics | None = None
@@ -404,7 +440,9 @@ class MCPConnectionManager(ContextDependent):
 
         logger.debug(f"{server_name}: Found server configuration=", data=config.model_dump())
 
-        transport_metrics = TransportChannelMetrics() if config.transport in ("http", "stdio") else None
+        transport_metrics = (
+            TransportChannelMetrics() if config.transport in ("http", "stdio") else None
+        )
 
         def transport_context_factory():
             if config.transport == "stdio":
@@ -425,7 +463,9 @@ class MCPConnectionManager(ContextDependent):
 
                 channel_hook = transport_metrics.record_event if transport_metrics else None
                 return _add_none_to_context(
-                    tracking_stdio_client(server_params, channel_hook=channel_hook, errlog=error_handler)
+                    tracking_stdio_client(
+                        server_params, channel_hook=channel_hook, errlog=error_handler
+                    )
                 )
             elif config.transport == "sse":
                 if not config.url:
@@ -434,12 +474,12 @@ class MCPConnectionManager(ContextDependent):
                     )
                 # Suppress MCP library error spam
                 self._suppress_mcp_sse_errors()
-                oauth_auth = build_oauth_provider(config)
-                # If using OAuth, strip any pre-existing Authorization headers to avoid conflicts
-                headers = dict(config.headers or {})
-                if oauth_auth is not None:
-                    headers.pop("Authorization", None)
-                    headers.pop("X-HF-Authorization", None)
+                headers, oauth_auth, user_auth_keys = _prepare_headers_and_auth(config)
+                if user_auth_keys:
+                    logger.debug(
+                        f"{server_name}: Using user-specified auth header(s); skipping OAuth provider.",
+                        user_auth_headers=sorted(user_auth_keys),
+                    )
                 return _add_none_to_context(
                     sse_client(
                         config.url,
@@ -453,19 +493,22 @@ class MCPConnectionManager(ContextDependent):
                     raise ValueError(
                         f"Server '{server_name}' uses http transport but no url is specified"
                     )
-                oauth_auth = build_oauth_provider(config)
-                headers = dict(config.headers or {})
-                if oauth_auth is not None:
-                    headers.pop("Authorization", None)
-                    headers.pop("X-HF-Authorization", None)
+                headers, oauth_auth, user_auth_keys = _prepare_headers_and_auth(config)
+                if user_auth_keys:
+                    logger.debug(
+                        f"{server_name}: Using user-specified auth header(s); skipping OAuth provider.",
+                        user_auth_headers=sorted(user_auth_keys),
+                    )
                 channel_hook = None
                 if transport_metrics is not None:
+
                     def channel_hook(event):
                         try:
                             transport_metrics.record_event(event)
                         except Exception:  # pragma: no cover - defensive guard
                             logger.debug(
-                                "%s: transport metrics hook failed", server_name,
+                                "%s: transport metrics hook failed",
+                                server_name,
                                 exc_info=True,
                             )
 

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/src/fast_agent/ui/console_display.py

@@ -6,6 +6,7 @@ from mcp.types import CallToolResult
 from rich.panel import Panel
 from rich.text import Text
 
+from fast_agent.constants import REASONING
 from fast_agent.ui import console
 from fast_agent.ui.mcp_ui_utils import UILink
 from fast_agent.ui.mermaid_utils import (
@@ -144,6 +145,25 @@ class ConsoleDisplay:
         self._markup = config.logger.enable_markup if config else True
         self._escape_xml = True
 
+    @staticmethod
+    def _format_elapsed(elapsed: float) -> str:
+        """Format elapsed seconds for display."""
+        if elapsed < 0:
+            elapsed = 0.0
+        if elapsed < 0.001:
+            return "<1ms"
+        if elapsed < 1:
+            return f"{elapsed * 1000:.0f}ms"
+        if elapsed < 10:
+            return f"{elapsed:.2f}s"
+        if elapsed < 60:
+            return f"{elapsed:.1f}s"
+        minutes, seconds = divmod(elapsed, 60)
+        if minutes < 60:
+            return f"{int(minutes)}m {seconds:02.0f}s"
+        hours, minutes = divmod(int(minutes), 60)
+        return f"{hours}h {minutes:02d}m"
+
     def display_message(
         self,
         content: Any,
@@ -156,6 +176,7 @@ class ConsoleDisplay:
         is_error: bool = False,
         truncate_content: bool = True,
         additional_message: Text | None = None,
+        pre_content: Text | None = None,
     ) -> None:
         """
         Unified method to display formatted messages to the console.
@@ -170,6 +191,8 @@ class ConsoleDisplay:
             max_item_length: Optional max length for bottom metadata items (with ellipsis)
             is_error: For tool results, whether this is an error (uses red color)
             truncate_content: Whether to truncate long content
+            additional_message: Optional Rich Text appended after the main content
+            pre_content: Optional Rich Text shown before the main content
         """
         # Get configuration for this message type
         config = MESSAGE_CONFIGS[message_type]
@@ -191,6 +214,8 @@ class ConsoleDisplay:
         self._create_combined_separator_status(left, right_info)
 
         # Display the content
+        if pre_content and pre_content.plain:
+            console.console.print(pre_content, markup=self._markup)
         self._display_content(
             content, truncate_content, is_error, message_type, check_markdown_markers=False
         )
@@ -544,7 +569,7 @@ class ConsoleDisplay:
 
         # Build transport channel info for bottom bar
         channel = getattr(result, "transport_channel", None)
-        bottom_metadata = None
+        bottom_metadata_items: List[str] = []
         if channel:
             # Format channel info for bottom bar
             if channel == "post-json":
@@ -560,7 +585,13 @@ class ConsoleDisplay:
             else:
                 transport_info = channel.upper()
 
-            bottom_metadata = [transport_info]
+            bottom_metadata_items.append(transport_info)
+
+        elapsed = getattr(result, "transport_elapsed", None)
+        if isinstance(elapsed, (int, float)):
+            bottom_metadata_items.append(self._format_elapsed(float(elapsed)))
+
+        bottom_metadata = bottom_metadata_items or None
 
         # Build right info (without channel info)
         right_info = f"[dim]tool result - {status}[/dim]"
@@ -724,8 +755,26 @@ class ConsoleDisplay:
         # Extract text from PromptMessageExtended if needed
         from fast_agent.types import PromptMessageExtended
 
+        pre_content: Text | None = None
+
         if isinstance(message_text, PromptMessageExtended):
             display_text = message_text.last_text() or ""
+
+            channels = message_text.channels or {}
+            reasoning_blocks = channels.get(REASONING) or []
+            if reasoning_blocks:
+                from fast_agent.mcp.helpers.content_helpers import get_text
+
+                reasoning_segments = []
+                for block in reasoning_blocks:
+                    text = get_text(block)
+                    if text:
+                        reasoning_segments.append(text)
+
+                if reasoning_segments:
+                    joined = "\n".join(reasoning_segments)
+                    if joined.strip():
+                        pre_content = Text(joined, style="dim default")
         else:
             display_text = message_text
 
@@ -743,6 +792,7 @@ class ConsoleDisplay:
             max_item_length=max_item_length,
             truncate_content=False,  # Assistant messages shouldn't be truncated
             additional_message=additional_message,
+            pre_content=pre_content,
         )
 
         # Handle mermaid diagrams separately (after the main message)

{fast_agent_mcp-0.3.12 → fast_agent_mcp-0.3.13}/src/fast_agent/ui/mcp_display.py

@@ -54,6 +54,17 @@ class Colours:
     TEXT_CYAN = "cyan"
 
 
+# Symbol definitions for timelines and legends
+SYMBOL_IDLE = "·"
+SYMBOL_ERROR = "●"
+SYMBOL_RESPONSE = "▼"
+SYMBOL_NOTIFICATION = "●"
+SYMBOL_REQUEST = "◆"
+SYMBOL_STDIO_ACTIVITY = "●"
+SYMBOL_PING = "●"
+SYMBOL_DISABLED = "▽"
+
+
 # Color mappings for different contexts
 TIMELINE_COLORS = {
     "error": Colours.ERROR,
@@ -263,11 +274,19 @@ def _build_inline_timeline(buckets: Iterable[str]) -> str:
     for state in buckets:
         color = TIMELINE_COLORS.get(state, Colours.NONE)
         if state in {"idle", "none"}:
-            symbol = "·"
+            symbol = SYMBOL_IDLE
         elif state == "request":
-            symbol = "◆"  # Diamond for requests - rare and important
+            symbol = SYMBOL_REQUEST
+        elif state == "notification":
+            symbol = SYMBOL_NOTIFICATION
+        elif state == "error":
+            symbol = SYMBOL_ERROR
+        elif state == "ping":
+            symbol = SYMBOL_PING
+        elif state == "disabled":
+            symbol = SYMBOL_DISABLED
         else:
-            symbol = "●"  # Circle for other activity
+            symbol = SYMBOL_RESPONSE
         timeline += f"[bold {color}]{symbol}[/bold {color}]"
     timeline += " [dim]now[/dim]"
     return timeline
@@ -416,7 +435,12 @@ def _render_channel_summary(status: ServerStatus, indent: str, total_width: int)
         elif arrow_style == Colours.ARROW_ERROR and "GET" in label:
             # Highlight GET stream errors in red to match the arrow indicator
             label_style = Colours.TEXT_ERROR
-        elif channel.request_count == 0 and channel.response_count == 0:
+        elif (
+            channel.request_count == 0
+            and channel.response_count == 0
+            and channel.notification_count == 0
+            and (channel.ping_count or 0) == 0
+        ):
             # No activity = dim
             label_style = Colours.TEXT_DIM
         else:
@@ -431,19 +455,26 @@ def _render_channel_summary(status: ServerStatus, indent: str, total_width: int)
             for bucket_state in channel.activity_buckets:
                 color = timeline_color_map.get(bucket_state, "dim")
                 if bucket_state in {"idle", "none"}:
-                    symbol = "·"
+                    symbol = SYMBOL_IDLE
                 elif is_stdio:
-                    # For STDIO, all activity shows as filled circles since types are combined
-                    symbol = "●"
+                    symbol = SYMBOL_STDIO_ACTIVITY
                 elif bucket_state == "request":
-                    symbol = "◆"  # Diamond for requests - rare and important
+                    symbol = SYMBOL_REQUEST
+                elif bucket_state == "notification":
+                    symbol = SYMBOL_NOTIFICATION
+                elif bucket_state == "error":
+                    symbol = SYMBOL_ERROR
+                elif bucket_state == "ping":
+                    symbol = SYMBOL_PING
+                elif bucket_state == "disabled":
+                    symbol = SYMBOL_DISABLED
                 else:
-                    symbol = "●"  # Circle for other activity
+                    symbol = SYMBOL_RESPONSE
                 line.append(symbol, style=f"bold {color}")
         else:
             # Show dim dots for no activity
             for _ in range(20):
-                line.append("·", style="black dim")
+                line.append(SYMBOL_IDLE, style="black dim")
         line.append(" now", style="dim")
 
         # Metrics - different layouts for stdio vs HTTP
@@ -548,11 +579,17 @@ def _render_channel_summary(status: ServerStatus, indent: str, total_width: int)
             if i > 0:
                 footer.append(" ", style="dim")
             if name == "idle":
-                symbol = "·"
+                symbol = SYMBOL_IDLE
             elif name == "request":
-                symbol = "◆"  # Diamond for requests
+                symbol = SYMBOL_REQUEST
+            elif name == "notification":
+                symbol = SYMBOL_NOTIFICATION
+            elif name == "error":
+                symbol = SYMBOL_ERROR
+            elif name == "ping":
+                symbol = SYMBOL_PING
             else:
-                symbol = "●"
+                symbol = SYMBOL_RESPONSE
             footer.append(symbol, style=f"{color}")
             footer.append(f" {name}", style="dim")
 
@@ -619,7 +656,7 @@ async def render_mcp_status(agent, indent: str = "") -> None:
 
         header_label = Text(indent)
         header_label.append("▎", style=Colours.TEXT_CYAN)
-        header_label.append("●", style=f"dim {Colours.TEXT_CYAN}")
+        header_label.append(SYMBOL_RESPONSE, style=f"dim {Colours.TEXT_CYAN}")
         header_label.append(f" [{index:2}] ", style=Colours.TEXT_CYAN)
         header_label.append(server, style=f"{Colours.TEXT_INFO} bold")
         render_header(header_label)