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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.6
+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,9 +209,9 @@ 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.66.0
+Requires-Dist: anthropic>=0.68.0
 Requires-Dist: azure-identity>=1.14.0
 Requires-Dist: boto3>=1.35.0
 Requires-Dist: deprecated>=1.2.18
@@ -220,7 +220,7 @@ Requires-Dist: fastapi>=0.115.6
 Requires-Dist: google-genai>=1.33.0
 Requires-Dist: keyring>=24.3.1
 Requires-Dist: mcp==1.14.0
-Requires-Dist: openai>=1.106.1
+Requires-Dist: openai>=1.108.0
 Requires-Dist: opentelemetry-distro>=0.55b0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.7.0
 Requires-Dist: opentelemetry-instrumentation-anthropic>=0.43.1; python_version >= '3.10' and python_version < '4.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.6 → 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.6 → fast_agent_mcp-0.3.8}/examples/setup/fastagent.config.yaml

@@ -7,10 +7,10 @@
 # Accepts aliases for Anthropic Models: haiku, haiku3, sonnet, sonnet35, opus, opus3
 # and OpenAI Models: gpt-4.1, gpt-4.1-mini, o1, o1-mini, o3-mini
 #
-# If not specified, defaults to "haiku".
+# If not specified, defaults to "gpt-5-mini.low".
 # Can be overriden with a command line switch --model=<model>, or within the Agent constructor.
 
-default_model: haiku
+default_model: gpt-5-mini.low
 # mcp-ui support: disabled, enabled or auto. "auto" opens the web browser on the asset automatically
 # mcp_ui_output_dir: ".fast-agent/ui"  # Where to write MCP-UI HTML files (relative to CWD if not absolute)
 # mcp_ui_mode: enabled

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

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.3.6"
+version = "0.3.8"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -23,8 +23,8 @@ dependencies = [
     "pyyaml>=6.0.2",
     "rich>=14.1.0",
     "typer>=0.15.1",
-    "anthropic>=0.66.0",
-    "openai>=1.106.1",
+    "anthropic>=0.68.0",
+    "openai>=1.108.0",
     "azure-identity>=1.14.0",
     "boto3>=1.35.0",
     "prompt-toolkit>=3.0.51",
@@ -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.6 → fast_agent_mcp-0.3.8}/src/fast_agent/__init__.py

@@ -27,8 +27,11 @@ from fast_agent.config import (
     XAISettings,
 )
 
+# Prompt helpers (safe - no heavy dependencies)
+from fast_agent.mcp.prompt import Prompt
+
 # Type definitions and enums (safe - no dependencies)
-from fast_agent.types import LlmStopReason, RequestParams
+from fast_agent.types import LlmStopReason, PromptMessageExtended, RequestParams
 
 
 def __getattr__(name: str):
@@ -91,6 +94,8 @@ def __getattr__(name: str):
 if TYPE_CHECKING:  # pragma: no cover - typing aid only
     # Provide a concrete import path for type checkers/IDEs
     from fast_agent.core.fastagent import FastAgent as FastAgent  # noqa: F401
+    from fast_agent.mcp.prompt import Prompt as Prompt  # noqa: F401
+    from fast_agent.types import PromptMessageExtended as PromptMessageExtended  # noqa: F401
 
 
 __all__ = [
@@ -127,6 +132,9 @@ __all__ = [
     # Type definitions and enums (eagerly loaded)
     "LlmStopReason",
     "RequestParams",
+    "PromptMessageExtended",
+    # Prompt helpers (eagerly loaded)
+    "Prompt",
     # Agents (lazy loaded)
     "LlmAgent",
     "LlmDecorator",

{fast_agent_mcp-0.3.6 → fast_agent_mcp-0.3.8}/src/fast_agent/agents/agent_types.py

@@ -3,7 +3,7 @@ Type definitions for agents and agent configurations.
 """
 
 from dataclasses import dataclass, field
-from enum import Enum
+from enum import StrEnum, auto
 from typing import Dict, List, Optional
 
 from mcp.client.session import ElicitationFnT
@@ -12,18 +12,18 @@ from mcp.client.session import ElicitationFnT
 from fast_agent.types import RequestParams
 
 
-class AgentType(Enum):
+class AgentType(StrEnum):
     """Enumeration of supported agent types."""
 
-    LLM = "llm"  # simple llm delegator
-    BASIC = "agent"
-    CUSTOM = "custom"
-    ORCHESTRATOR = "orchestrator"
-    PARALLEL = "parallel"
-    EVALUATOR_OPTIMIZER = "evaluator_optimizer"
-    ROUTER = "router"
-    CHAIN = "chain"
-    ITERATIVE_PLANNER = "iterative_planner"
+    LLM = auto()
+    BASIC = auto()
+    CUSTOM = auto()
+    ORCHESTRATOR = auto()
+    PARALLEL = auto()
+    EVALUATOR_OPTIMIZER = auto()
+    ROUTER = auto()
+    CHAIN = auto()
+    ITERATIVE_PLANNER = auto()
 
 
 @dataclass

{fast_agent_mcp-0.3.6 → 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__(
@@ -81,56 +81,71 @@ class LlmAgent(LlmDecorator):
         """
 
         # Determine display content based on stop reason if not provided
-        if additional_message is None:
-            # Generate additional message based on stop reason
-            match message.stop_reason:
-                case LlmStopReason.END_TURN:
-                    # No additional message needed for normal end turn
-                    additional_message_text = None
-
-                case LlmStopReason.MAX_TOKENS:
-                    additional_message_text = Text(
+        additional_segments: List[Text] = []
+
+        # Generate additional message based on stop reason
+        match message.stop_reason:
+            case LlmStopReason.END_TURN:
+                pass
+
+            case LlmStopReason.MAX_TOKENS:
+                additional_segments.append(
+                    Text(
                         "\n\nMaximum output tokens reached - generation stopped.",
                         style="dim red italic",
                     )
+                )
 
-                case LlmStopReason.SAFETY:
-                    additional_message_text = Text(
-                        "\n\nContent filter activated - generation stopped.", style="dim red italic"
+            case LlmStopReason.SAFETY:
+                additional_segments.append(
+                    Text(
+                        "\n\nContent filter activated - generation stopped.",
+                        style="dim red italic",
                     )
+                )
 
-                case LlmStopReason.PAUSE:
-                    additional_message_text = Text(
-                        "\n\nLLM has requested a pause.", style="dim green italic"
-                    )
+            case LlmStopReason.PAUSE:
+                additional_segments.append(
+                    Text("\n\nLLM has requested a pause.", style="dim green italic")
+                )
 
-                case LlmStopReason.STOP_SEQUENCE:
-                    additional_message_text = Text(
-                        "\n\nStop Sequence activated - generation stopped.", style="dim red italic"
+            case LlmStopReason.STOP_SEQUENCE:
+                additional_segments.append(
+                    Text(
+                        "\n\nStop Sequence activated - generation stopped.",
+                        style="dim red italic",
                     )
+                )
 
-                case LlmStopReason.TOOL_USE:
-                    if None is message.last_text():
-                        additional_message_text = Text(
-                            "The assistant requested tool calls", style="dim green italic"
-                        )
-                    else:
-                        additional_message_text = None
+            case LlmStopReason.TOOL_USE:
+                if None is message.last_text():
+                    additional_segments.append(
+                        Text("The assistant requested tool calls", style="dim green italic")
+                    )
 
-                case _:
-                    if message.stop_reason:
-                        additional_message_text = Text(
+            case _:
+                if message.stop_reason:
+                    additional_segments.append(
+                        Text(
                             f"\n\nGeneration stopped for an unhandled reason ({message.stop_reason})",
                             style="dim red italic",
                         )
-                    else:
-                        additional_message_text = None
-        else:
-            # Use provided additional message
-            additional_message_text = (
-                additional_message if isinstance(additional_message, Text) else None
+                    )
+
+        if additional_message is not None:
+            additional_segments.append(
+                additional_message
+                if isinstance(additional_message, Text)
+                else Text(str(additional_message))
             )
 
+        additional_message_text = None
+        if additional_segments:
+            combined = Text()
+            for segment in additional_segments:
+                combined += segment
+            additional_message_text = combined
+
         message_text = message.last_text() or ""
 
         # Use provided name/model or fall back to defaults
@@ -182,9 +197,11 @@ class LlmAgent(LlmDecorator):
 
         # TODO -- we should merge the request parameters here with the LLM defaults?
         # TODO - manage error catch, recovery, pause
-        result = await super().generate_impl(messages, request_params, tools)
+        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
 
-        await self.show_assistant_message(result)
+        await self.show_assistant_message(result, additional_message=summary_text)
         return result
 
     async def structured_impl(
@@ -196,8 +213,11 @@ class LlmAgent(LlmDecorator):
         if "user" == messages[-1].role:
             self.show_user_message(message=messages[-1])
 
-        result, message = await super().structured_impl(messages, model, request_params)
-        await self.show_assistant_message(message=message)
+        (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
+        await self.show_assistant_message(message=message, additional_message=summary_text)
         return result, message
 
     # async def show_prompt_loaded(