fast-agent-mcp 0.3.7__tar.gz → 0.3.8__tar.gz

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.7
+Version: 0.3.8
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License
@@ -209,7 +209,7 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.13.5
-Requires-Dist: a2a-sdk>=0.3.0
+Requires-Dist: a2a-sdk>=0.3.6
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.68.0
 Requires-Dist: azure-identity>=1.14.0

fast_agent_mcp-0.3.8/examples/a2a/agent_executor.py

@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+from contextlib import AsyncExitStack
+from typing import TYPE_CHECKING, cast
+
+from a2a.server.agent_execution import AgentExecutor, RequestContext
+from a2a.utils import new_agent_text_message
+
+from fast_agent import FastAgent
+
+if TYPE_CHECKING:
+    from a2a.server.events import EventQueue
+    from a2a.types import AgentCard
+
+    from fast_agent.core.agent_app import AgentApp
+    from fast_agent.interfaces import AgentProtocol
+
+DEFAULT_AGENT_NAME = "helper"
+
+fast = FastAgent(
+    "A2A FastAgent Demo",
+    parse_cli_args=False,
+    quiet=True,
+)
+
+
+@fast.agent(
+    name=DEFAULT_AGENT_NAME,
+    instruction="You are a helpful AI agent answering incoming A2A messages.",
+    default=True,
+)
+async def helper() -> None:
+    """Default agent registered with FastAgent."""
+    pass
+
+
+class FastAgentExecutor(AgentExecutor):
+    """AgentExecutor that proxies requests to a FastAgent runtime."""
+
+    def __init__(self, default_agent_name: str = DEFAULT_AGENT_NAME) -> None:
+        self._stack = AsyncExitStack()
+        self._agents: AgentApp | None = None
+        self._default_agent_name = default_agent_name
+
+    async def _agents_app(self) -> AgentApp:
+        """Ensure the FastAgent runtime is running and return the AgentApp."""
+        if self._agents is None:
+            self._agents = await self._stack.enter_async_context(fast.run())
+        return self._agents
+
+    async def _agent(self, agent_name: str | None = None) -> AgentProtocol:
+        """Return the requested agent or fall back to the default agent."""
+        app = await self._agents_app()
+        agents_map = cast("dict[str, AgentProtocol]", getattr(app, "_agents"))
+
+        if agent_name and agent_name in agents_map:
+            return agents_map[agent_name]
+
+        if self._default_agent_name and self._default_agent_name in agents_map:
+            return agents_map[self._default_agent_name]
+
+        for candidate in agents_map.values():
+            config = getattr(candidate, "config", None)
+            if config is not None and getattr(config, "default", False):
+                return candidate
+
+        return next(iter(agents_map.values()))
+
+    async def execute(
+        self,
+        context: RequestContext,
+        event_queue: EventQueue,
+    ) -> None:
+        message = context.get_user_input().strip()
+        if not message:
+            return
+
+        agent = await self._agent()
+        response = await agent.send(message)
+        await event_queue.enqueue_event(new_agent_text_message(response))
+
+    async def cancel(self, context: RequestContext, event_queue: EventQueue) -> None:
+        raise Exception("cancel not supported")
+
+    async def agent_card(self, agent_name: str | None = None) -> AgentCard:
+        """Return the FastAgent-provided AgentCard for the given agent."""
+        agent = await self._agent(agent_name)
+        return await agent.agent_card()
+
+    async def shutdown(self) -> None:
+        """Close the FastAgent runtime."""
+        await self._stack.aclose()
+        self._agents = None

fast_agent_mcp-0.3.8/examples/a2a/server.py

@@ -0,0 +1,53 @@
+import asyncio
+
+from a2a.server.apps import A2AStarletteApplication
+from a2a.server.request_handlers import DefaultRequestHandler
+from a2a.server.tasks import InMemoryTaskStore
+from a2a.types import AgentCard, TransportProtocol
+from agent_executor import FastAgentExecutor
+from uvicorn import Config, Server
+
+HOST = "0.0.0.0"
+PORT = 9999
+
+
+def _with_server_url(card: AgentCard) -> AgentCard:
+    """Inject JSON-RPC transport details while preserving FastAgent metadata."""
+    base_url = f"http://localhost:{PORT}/"
+    return card.model_copy(
+        update={
+            "url": base_url,
+            "preferred_transport": TransportProtocol.jsonrpc,
+            "additional_interfaces": [],
+            "supports_authenticated_extended_card": False,
+            "default_input_modes": ["text"],
+            "default_output_modes": ["text"],
+        }
+    )
+
+
+async def main() -> None:
+    executor = FastAgentExecutor()
+    agent_card = _with_server_url(await executor.agent_card())
+
+    request_handler = DefaultRequestHandler(
+        agent_executor=executor,
+        task_store=InMemoryTaskStore(),
+    )
+
+    server = A2AStarletteApplication(
+        agent_card=agent_card,
+        http_handler=request_handler,
+    )
+
+    config = Config(server.build(), host=HOST, port=PORT)
+    uvicorn_server = Server(config)
+
+    try:
+        await uvicorn_server.serve()
+    finally:
+        await executor.shutdown()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/examples/fastapi/fastapi-advanced.py

@@ -2,11 +2,11 @@ from contextlib import asynccontextmanager
 
 from fastapi import Body, FastAPI, HTTPException
 
+from fast_agent import PromptMessageExtended
 from fast_agent.agents import McpAgent
 from fast_agent.agents.agent_types import AgentConfig
 from fast_agent.core import Core
 from fast_agent.core.direct_factory import get_model_factory
-from fast_agent.mcp import PromptMessageExtended
 
 core = Core(name="fast-agent core")
 

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.3.7"
+version = "0.3.8"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -36,7 +36,7 @@ dependencies = [
     "opentelemetry-instrumentation-google-genai>=0.3b0",
     "tensorzero>=2025.7.5",
     "deprecated>=1.2.18",
-    "a2a-sdk>=0.3.0",
+    "a2a-sdk>=0.3.6",
     "email-validator>=2.2.0",
     "pyperclip>=1.9.0",
     "keyring>=24.3.1",

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/agents/llm_agent.py

@@ -45,7 +45,7 @@ class LlmAgent(LlmDecorator):
 
     This class provides LLM-specific functionality including UI display methods,
     tool call tracking, and chat interaction patterns while delegating core
-    LLM operations to the attached AugmentedLLMProtocol.
+    LLM operations to the attached FastAgentLLMProtocol.
     """
 
     def __init__(
@@ -134,7 +134,9 @@ class LlmAgent(LlmDecorator):
 
         if additional_message is not None:
             additional_segments.append(
-                additional_message if isinstance(additional_message, Text) else Text(str(additional_message))
+                additional_message
+                if isinstance(additional_message, Text)
+                else Text(str(additional_message))
             )
 
         additional_message_text = None
@@ -197,9 +199,7 @@ class LlmAgent(LlmDecorator):
         # TODO - manage error catch, recovery, pause
         result, summary = await self._generate_with_summary(messages, request_params, tools)
 
-        summary_text = (
-            Text(f"\n\n{summary.message}", style="dim red italic") if summary else None
-        )
+        summary_text = Text(f"\n\n{summary.message}", style="dim red italic") if summary else None
 
         await self.show_assistant_message(result, additional_message=summary_text)
         return result
@@ -216,9 +216,7 @@ class LlmAgent(LlmDecorator):
         (result, message), summary = await self._structured_with_summary(
             messages, model, request_params
         )
-        summary_text = (
-            Text(f"\n\n{summary.message}", style="dim red italic") if summary else None
-        )
+        summary_text = Text(f"\n\n{summary.message}", style="dim red italic") if summary else None
         await self.show_assistant_message(message=message, additional_message=summary_text)
         return result, message
 

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/agents/llm_decorator.py

@@ -57,7 +57,6 @@ from fast_agent.types import PromptMessageExtended, RequestParams
 # Define a TypeVar for models
 ModelT = TypeVar("ModelT", bound=BaseModel)
 
-# Define a TypeVar for AugmentedLLM and its subclasses
 LLM = TypeVar("LLM", bound=FastAgentLLMProtocol)
 
 
@@ -533,9 +532,7 @@ class LlmDecorator(AgentProtocol):
         if isinstance(block, EmbeddedResource):
             resource = getattr(block, "resource", None)
             mime = getattr(resource, "mimeType", None)
-            if isinstance(resource, TextResourceContents) or (
-                mime and is_text_mime_type(mime)
-            ):
+            if isinstance(resource, TextResourceContents) or (mime and is_text_mime_type(mime)):
                 return mime or "text/plain", "text"
             if mime and mime.startswith("image/"):
                 return mime, "vision"
@@ -593,9 +590,7 @@ class LlmDecorator(AgentProtocol):
             entries.append(metadata_text)
         return entries
 
-    def _build_removed_summary(
-        self, removed: List[_RemovedBlock]
-    ) -> RemovedContentSummary | None:
+    def _build_removed_summary(self, removed: List[_RemovedBlock]) -> RemovedContentSummary | None:
         if not removed:
             return None
 

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/agents/mcp_agent.py

@@ -2,7 +2,7 @@
 Base Agent class that implements the AgentProtocol interface.
 
 This class provides default implementations of the standard agent methods
-and delegates operations to an attached AugmentedLLMProtocol instance.
+and delegates operations to an attached FastAgentLLMProtocol instance.
 """
 
 import asyncio
@@ -52,7 +52,6 @@ from fast_agent.types import PromptMessageExtended, RequestParams
 # Define a TypeVar for models
 ModelT = TypeVar("ModelT", bound=BaseModel)
 
-# Define a TypeVar for AugmentedLLM and its subclasses
 LLM = TypeVar("LLM", bound=FastAgentLLMProtocol)
 
 if TYPE_CHECKING:
@@ -67,7 +66,7 @@ class McpAgent(ABC, ToolAgent):
     A base Agent class that implements the AgentProtocol interface.
 
     This class provides default implementations of the standard agent methods
-    and delegates LLM operations to an attached AugmentedLLMProtocol instance.
+    and delegates LLM operations to an attached FastAgentLLMProtocol instance.
     """
 
     def __init__(

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/cli/commands/auth.py

@@ -293,7 +293,9 @@ def main(
 
 @app.command()
 def login(
-    target: str = typer.Argument(..., help="Server name (from config) or identity (base URL)"),
+    target: Optional[str] = typer.Argument(
+        None, help="Server name (from config) or identity (base URL)"
+    ),
     transport: Optional[str] = typer.Option(
         None, "--transport", help="Transport for identity mode: http or sse"
     ),
@@ -311,6 +313,17 @@ def login(
     cfg = None
     resolved_transport = None
 
+    if target is None or not target.strip():
+        typer.echo("Provide a server name or identity URL to log in.")
+        typer.echo(
+            "Example: `fast-agent auth login my-server` "
+            "or `fast-agent auth login https://example.com`."
+        )
+        typer.echo("Run `fast-agent auth login --help` for more details.")
+        raise typer.Exit(1)
+
+    target = target.strip()
+
     if "://" in target:
         # Identity mode
         base = _derive_base_server_url(target)

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/core/logging/listeners.py

@@ -55,7 +55,8 @@ def convert_log_event(event: Event) -> "ProgressEvent | None":
             if progress_message:  # Only override if message is non-empty
                 details = progress_message
 
-    elif "augmented_llm" in namespace:
+    # TODO: there must be a better way :D?!
+    elif "llm" in namespace:
         model = event_data.get("model", "")
 
         # For all augmented_llm events, put model info in details column

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/interfaces.py

@@ -47,7 +47,7 @@ ModelT = TypeVar("ModelT", bound=BaseModel)
 
 
 class LLMFactoryProtocol(Protocol):
-    """Protocol for LLM factory functions that create AugmentedLLM instances."""
+    """Protocol for LLM factory functions that create FastAgentLLM instances."""
 
     def __call__(self, agent: "LlmAgentProtocol", **kwargs: Any) -> "FastAgentLLMProtocol": ...
 
@@ -59,7 +59,7 @@ class ModelFactoryFunctionProtocol(Protocol):
 
 
 class FastAgentLLMProtocol(Protocol):
-    """Protocol defining the interface for augmented LLMs"""
+    """Protocol defining the interface for LLMs"""
 
     async def structured(
         self,

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/llm/model_database.py

@@ -164,7 +164,11 @@ class ModelDatabase:
     )
 
     # FIXME: xAI has not documented the max output tokens for Grok 4. Using Grok 3 as a placeholder. Will need to update when available (if ever)
-    GROK_4 = ModelParameters(context_window=256000, max_output_tokens=16385, tokenizes=XAI_VISION)
+    GROK_4 = ModelParameters(context_window=256000, max_output_tokens=16385, tokenizes=TEXT_ONLY)
+
+    GROK_4_VLM = ModelParameters(
+        context_window=2000000, max_output_tokens=16385, tokenizes=XAI_VISION
+    )
 
     # Source for Grok 3 max output: https://www.reddit.com/r/grok/comments/1j7209p/exploring_grok_3_beta_output_capacity_a_simple/
     # xAI does not document Grok 3 max output tokens, using the above source as a reference.
@@ -240,6 +244,8 @@ class ModelDatabase:
         "gemini-2.5-flash-preview-05-20": GEMINI_FLASH,
         "gemini-2.5-pro-preview-05-06": GEMINI_PRO,
         # xAI Grok Models
+        "grok-4-fast-reasoning": GROK_4_VLM,
+        "grok-4-fast-non-reasoning": GROK_4_VLM,
         "grok-4": GROK_4,
         "grok-4-0709": GROK_4,
         "grok-3": GROK_3,

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/llm/model_factory.py

@@ -12,9 +12,6 @@ from fast_agent.llm.internal.slow import SlowLLM
 from fast_agent.llm.provider_types import Provider
 from fast_agent.types import RequestParams
 
-# from fast_agent.workflows.llm.augmented_llm_deepseek import DeekSeekAugmentedLLM
-
-
 # Type alias for LLM classes
 LLMClass = Union[Type[PassthroughLLM], Type[PlaybackLLM], Type[SilentLLM], Type[SlowLLM], type]
 
@@ -123,6 +120,8 @@ class ModelFactory:
         "kimi": "groq.moonshotai/kimi-k2-instruct-0905",
         "gpt-oss": "groq.openai/gpt-oss-120b",
         "gpt-oss-20b": "groq.openai/gpt-oss-20b",
+        "grok-4-fast": "xai.grok-4-fast-non-reasoning",
+        "grok-4-fast-reasoning": "xai.grok-4-fast-reasoning",
     }
 
     @staticmethod

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/llm/provider/bedrock/llm_bedrock.py

@@ -126,7 +126,7 @@ class ModelCapabilities:
 
 class BedrockLLM(FastAgentLLM[BedrockMessageParam, BedrockMessage]):
     """
-    AWS Bedrock implementation of AugmentedLLM using the Converse API.
+    AWS Bedrock implementation of FastAgentLLM using the Converse API.
     Supports all Bedrock models including Nova, Claude, Meta, etc.
     """
 

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/llm/provider/google/llm_google_native.py

@@ -36,10 +36,8 @@ GOOGLE_EXCLUDE_FIELDS = {
     FastAgentLLM.PARAM_MESSAGES,  # Handled by contents
     FastAgentLLM.PARAM_MODEL,  # Handled during client/call setup
     FastAgentLLM.PARAM_SYSTEM_PROMPT,  # Handled by system_instruction in config
-    # AugmentedLLM.PARAM_PARALLEL_TOOL_CALLS, # Handled by tool_config in config
-    FastAgentLLM.PARAM_USE_HISTORY,  # Handled by AugmentedLLM base / this class's logic
+    FastAgentLLM.PARAM_USE_HISTORY,  # Handled by FastAgentLLM base / this class's logic
     FastAgentLLM.PARAM_MAX_ITERATIONS,  # Handled by this class's loop
-    # Add any other OpenAI-specific params not applicable to google.genai
     FastAgentLLM.PARAM_MCP_METADATA,
 }.union(FastAgentLLM.BASE_EXCLUDE_FIELDS)
 

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/llm/provider/openai/llm_azure.py

@@ -23,7 +23,7 @@ DEFAULT_AZURE_API_VERSION = "2024-10-21"
 
 class AzureOpenAILLM(OpenAILLM):
     """
-    Azure OpenAI implementation extending OpenAIAugmentedLLM.
+    Azure OpenAI implementation extending OpenAILLM.
     Handles both API Key and DefaultAzureCredential authentication.
     """
 

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/llm/provider/openai/llm_tensorzero_openai.py

@@ -26,7 +26,7 @@ class TensorZeroOpenAILLM(OpenAILLM):
         self._t0_function_name = kwargs.get("model", "")
 
         super().__init__(*args, provider=Provider.TENSORZERO, **kwargs)
-        self.logger.info("TensorZeroOpenAIAugmentedLLM initialized.")
+        self.logger.info("TensorZeroOpenAILLM initialized.")
 
     def _initialize_default_params(self, kwargs: dict) -> RequestParams:
         """

{fast_agent_mcp-0.3.7 → fast_agent_mcp-0.3.8}/src/fast_agent/llm/request_params.py

@@ -11,7 +11,7 @@ from pydantic import Field
 
 class RequestParams(CreateMessageRequestParams):
     """
-    Parameters to configure the AugmentedLLM 'generate' requests.
+    Parameters to configure the FastAgentLLM 'generate' requests.
     """
 
     messages: List[SamplingMessage] = Field(exclude=True, default=[])