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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.11
+Version: 0.3.12
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License
@@ -211,7 +211,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.13.5
 Requires-Dist: a2a-sdk>=0.3.6
 Requires-Dist: aiohttp>=3.11.13
-Requires-Dist: anthropic>=0.68.0
+Requires-Dist: anthropic>=0.69.0
 Requires-Dist: azure-identity>=1.14.0
 Requires-Dist: boto3>=1.35.0
 Requires-Dist: deprecated>=1.2.18
@@ -219,8 +219,8 @@ Requires-Dist: email-validator>=2.2.0
 Requires-Dist: fastapi>=0.115.6
 Requires-Dist: google-genai>=1.33.0
 Requires-Dist: keyring>=24.3.1
-Requires-Dist: mcp==1.15.0
-Requires-Dist: openai>=1.109.1
+Requires-Dist: mcp==1.16.0
+Requires-Dist: openai>=2.1.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.12/examples/new-api/fastagent.config.yaml

@@ -0,0 +1,8 @@
+mcp:
+  servers:
+    filesystem:
+      command: "npx"
+      args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    fetch:
+      command: "uvx"
+      args: ["mcp-server-fetch"]

fast_agent_mcp-0.3.12/examples/new-api/simple_mcp.py

@@ -0,0 +1,47 @@
+"""
+Demonstration of changing MCP settings dynamically.
+
+Technically applicable to any setting, but MCP I found to be the most difficult due to MCP Aggregation at the startup.
+"""
+
+import asyncio
+
+from fast_agent.agents.agent_types import AgentConfig
+from fast_agent.agents.mcp_agent import McpAgent
+from fast_agent.core.core_app import Core
+from fast_agent.llm.model_factory import ModelFactory
+
+
+async def main():
+    core: Core = Core()
+    await core.initialize()
+
+    # Create agent configuration
+    config = AgentConfig(
+        name="dynamic_bot",
+        model="gpt-4o-mini",
+        servers=[  # Do not forget to add the servers here
+            "fetch",
+        ],
+    )
+
+    agent = McpAgent(
+        config,
+        connection_persistence=True,
+        context=core.context,
+    )
+
+    # Attach the LLM
+    await agent.attach_llm(ModelFactory.create_factory("gpt-4o-mini"))
+    await agent.initialize()  # MCP Agents need to be initialized before use
+
+    # Test the agent
+    result = await agent.send(
+        "Tell me about fast-agent framework. Find info at https://fast-agent.ai/ and summarize it."
+    )
+    print(result)
+    await core.cleanup()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.3.12/examples/tool-use-agent/agent.py

@@ -0,0 +1,33 @@
+import asyncio
+
+from fast_agent import FastAgent
+from fast_agent.agents.agent_types import AgentConfig
+from fast_agent.agents.tool_agent import ToolAgent
+from fast_agent.context import Context
+
+
+def get_video_call_transcript(video_id: str) -> str:
+    return "Assistant: Hi, how can I assist you today?\n\nCustomer: Hi, I wanted to ask you about last invoice I received..."
+
+
+class CustomToolAgent(ToolAgent):
+    def __init__(
+        self,
+        config: AgentConfig,
+        context: Context | None = None,
+    ):
+        tools = [get_video_call_transcript]
+        super().__init__(config, tools, context)
+
+
+fast = FastAgent("Example Tool Use Application")
+
+
+@fast.custom(CustomToolAgent)
+async def main() -> None:
+    async with fast.run() as agent:
+        await agent.default.generate("What is the topic of the video call no.1234?")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.3.12/examples/tool-use-agent/fastagent.config.yaml

@@ -0,0 +1,7 @@
+execution_engine: asyncio
+default_model: gpt-4.1
+
+logger:
+  type: file
+  level: error
+  truncate_tools: true

{fast_agent_mcp-0.3.11 → fast_agent_mcp-0.3.12}/hatch_build.py

@@ -25,17 +25,17 @@ class CustomBuildHook(BuildHookInterface):
             print("Fast-agent build: Cleared existing resources/setup directory")
 
         # Define source to target mappings
+        # Examples:
+        #  examples/workflows -> src/fast_agent/resources/examples/workflows
+        #  examples/mcp/elicitations -> src/fast_agent/resources/examples/mcp/elicitations
+        EXAMPLES_DIR = Path("src") / "fast_agent" / "resources" / "examples"
         example_mappings = {
-            # examples/workflows -> src/fast_agent/resources/examples/workflows
-            "examples/workflows": "src/fast_agent/resources/examples/workflows",
-            # examples/researcher -> src/fast_agent/resources/examples/researcher
-            "examples/researcher": "src/fast_agent/resources/examples/researcher",
-            # examples/data-analysis -> src/fast_agent/resources/examples/data-analysis
-            "examples/data-analysis": "src/fast_agent/resources/examples/data-analysis",
-            # examples/mcp/state-transfer -> src/fast_agent/resources/examples/mcp/state-transfer
-            "examples/mcp/state-transfer": "src/fast_agent/resources/examples/mcp/state-transfer",
-            "examples/mcp/elicitations": "src/fast_agent/resources/examples/mcp/elicitations",
-            "examples/tensorzero": "src/fast_agent/resources/examples/tensorzero",
+            "examples/workflows": EXAMPLES_DIR / "workflows",
+            "examples/researcher": EXAMPLES_DIR / "researcher",
+            "examples/data-analysis": EXAMPLES_DIR / "data-analysis",
+            "examples/mcp/state-transfer": EXAMPLES_DIR / "mcp" / "state-transfer",
+            "examples/mcp/elicitations": EXAMPLES_DIR / "mcp" / "elicitations",
+            "examples/tensorzero": EXAMPLES_DIR / "tensorzero",
         }
 
         # Define setup template mapping (editable templates -> packaged resources)

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

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.3.11"
+version = "0.3.12"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -15,7 +15,7 @@ classifiers = [
 requires-python = ">=3.13.5"
 dependencies = [
     "fastapi>=0.115.6",
-    "mcp==1.15.0",
+    "mcp==1.16.0",
     "opentelemetry-distro>=0.55b0",
     "opentelemetry-exporter-otlp-proto-http>=1.7.0",
     "pydantic-settings>=2.7.0",
@@ -23,8 +23,8 @@ dependencies = [
     "pyyaml>=6.0.2",
     "rich>=14.1.0",
     "typer>=0.15.1",
-    "anthropic>=0.68.0",
-    "openai>=1.109.1",
+    "anthropic>=0.69.0",
+    "openai>=2.1.0",
     "azure-identity>=1.14.0",
     "boto3>=1.35.0",
     "prompt-toolkit>=3.0.52",

{fast_agent_mcp-0.3.11 → fast_agent_mcp-0.3.12}/src/fast_agent/agents/llm_decorator.py

@@ -314,6 +314,13 @@ class LlmDecorator(AgentProtocol):
         # Otherwise treat the string as plain content (ignore arguments here)
         return await self.send(prompt)
 
+    def clear(self, *, clear_prompts: bool = False) -> None:
+        """Reset conversation state while optionally retaining applied prompt templates."""
+
+        if not self._llm:
+            return
+        self._llm.clear(clear_prompts=clear_prompts)
+
     async def structured(
         self,
         messages: Union[

{fast_agent_mcp-0.3.11 → fast_agent_mcp-0.3.12}/src/fast_agent/agents/tool_agent.py

@@ -1,4 +1,4 @@
-from typing import Any, Callable, Dict, List
+from typing import Any, Callable, Dict, List, Sequence
 
 from mcp.server.fastmcp.tools.base import Tool as FastMCPTool
 from mcp.types import CallToolResult, ListToolsResult, Tool
@@ -35,7 +35,7 @@ class ToolAgent(LlmAgent):
     def __init__(
         self,
         config: AgentConfig,
-        tools: list[FastMCPTool | Callable] = [],
+        tools: Sequence[FastMCPTool | Callable] = [],
         context: Context | None = None,
     ) -> None:
         super().__init__(config=config, context=context)

{fast_agent_mcp-0.3.11 → fast_agent_mcp-0.3.12}/src/fast_agent/cli/commands/quickstart.py

@@ -1,6 +1,8 @@
 """Bootstrap command to create example applications."""
 
 import shutil
+from dataclasses import dataclass
+from importlib.resources import files
 from pathlib import Path
 
 import typer
@@ -16,12 +18,27 @@ app = typer.Typer(
 )
 console = shared_console
 
-EXAMPLE_TYPES = {
-    "workflow": {
-        "description": "Example workflows, demonstrating each of the patterns in Anthropic's\n"
-        "'Building Effective Agents' paper. Some agents use the 'fetch'\n"
-        "and filesystem MCP Servers.",
-        "files": [
+
+BASE_EXAMPLES_DIR = files("fast_agent").joinpath("resources").joinpath("examples")
+
+
+@dataclass
+class ExampleConfig:
+    description: str
+    files: list[str]
+    create_subdir: bool
+    path_in_examples: list[str]
+    mount_point_files: list[str] | None = None
+
+
+_EXAMPLE_CONFIGS = {
+    "workflow": ExampleConfig(
+        description=(
+            "Example workflows, demonstrating each of the patterns in Anthropic's\n"
+            "'Building Effective Agents' paper. Some agents use the 'fetch'\n"
+            "and filesystem MCP Servers."
+        ),
+        files=[
             "chaining.py",
             "evaluator.py",
             "human_input.py",
@@ -31,41 +48,53 @@ EXAMPLE_TYPES = {
             "short_story.txt",
             "fastagent.config.yaml",
         ],
-        "create_subdir": True,
-    },
-    "researcher": {
-        "description": "Research agent example with additional evaluation/optimization\n"
-        "example. Uses Brave Search and Docker MCP Servers.\n"
-        "Creates examples in a 'researcher' subdirectory.",
-        "files": ["researcher.py", "researcher-eval.py", "fastagent.config.yaml"],
-        "create_subdir": True,
-    },
-    "data-analysis": {
-        "description": "Data analysis agent examples that demonstrate working with\n"
-        "datasets, performing statistical analysis, and generating visualizations.\n"
-        "Creates examples in a 'data-analysis' subdirectory with mount-point for data.\n"
-        "Uses MCP 'roots' feature for mapping",
-        "files": ["analysis.py", "fastagent.config.yaml"],
-        "mount_point_files": ["WA_Fn-UseC_-HR-Employee-Attrition.csv"],
-        "create_subdir": True,
-    },
-    "state-transfer": {
-        "description": "Example demonstrating state transfer between multiple agents.\n"
-        "Shows how state can be passed between agent runs to maintain context.\n"
-        "Creates examples in a 'state-transfer' subdirectory.",
-        "files": [
+        create_subdir=True,
+        path_in_examples=["workflows"],
+    ),
+    "researcher": ExampleConfig(
+        description=(
+            "Research agent example with additional evaluation/optimization\n"
+            "example. Uses Brave Search and Docker MCP Servers.\n"
+            "Creates examples in a 'researcher' subdirectory."
+        ),
+        files=["researcher.py", "researcher-eval.py", "fastagent.config.yaml"],
+        create_subdir=True,
+        path_in_examples=["researcher"],
+    ),
+    "data-analysis": ExampleConfig(
+        description=(
+            "Data analysis agent examples that demonstrate working with\n"
+            "datasets, performing statistical analysis, and generating visualizations.\n"
+            "Creates examples in a 'data-analysis' subdirectory with mount-point for data.\n"
+            "Uses MCP 'roots' feature for mapping"
+        ),
+        files=["analysis.py", "fastagent.config.yaml"],
+        mount_point_files=["WA_Fn-UseC_-HR-Employee-Attrition.csv"],
+        create_subdir=True,
+        path_in_examples=["data-analysis"],
+    ),
+    "state-transfer": ExampleConfig(
+        description=(
+            "Example demonstrating state transfer between multiple agents.\n"
+            "Shows how state can be passed between agent runs to maintain context.\n"
+            "Creates examples in a 'state-transfer' subdirectory."
+        ),
+        files=[
             "agent_one.py",
             "agent_two.py",
             "fastagent.config.yaml",
             "fastagent.secrets.yaml.example",
         ],
-        "create_subdir": True,
-    },
-    "elicitations": {
-        "description": "Interactive form examples using MCP elicitations feature.\n"
-        "Demonstrates collecting structured data with forms, AI-guided workflows,\n"
-        "and custom handlers. Creates examples in an 'elicitations' subdirectory.",
-        "files": [
+        create_subdir=True,
+        path_in_examples=["mcp", "state-transfer"],
+    ),
+    "elicitations": ExampleConfig(
+        description=(
+            "Interactive form examples using MCP elicitations feature.\n"
+            "Demonstrates collecting structured data with forms, AI-guided workflows,\n"
+            "and custom handlers. Creates examples in an 'elicitations' subdirectory."
+        ),
+        files=[
             "elicitation_account_server.py",
             "elicitation_forms_server.py",
             "elicitation_game_server.py",
@@ -76,13 +105,16 @@ EXAMPLE_TYPES = {
             "game_character_handler.py",
             "tool_call.py",
         ],
-        "create_subdir": True,
-    },
-    "tensorzero": {
-        "description": "A complete example showcasing the TensorZero integration.\n"
-        "Includes the T0 Gateway, an MCP server, an interactive agent, and \n"
-        "multi-modal functionality.",
-        "files": [
+        create_subdir=True,
+        path_in_examples=["mcp", "elicitations"],
+    ),
+    "tensorzero": ExampleConfig(
+        description=(
+            "A complete example showcasing the TensorZero integration.\n"
+            "Includes the T0 Gateway, an MCP server, an interactive agent, and \n"
+            "multi-modal functionality."
+        ),
+        files=[
             ".env.sample",
             "Makefile",
             "README.md",
@@ -93,105 +125,64 @@ EXAMPLE_TYPES = {
             "simple_agent.py",
             "mcp_server/",
             "demo_images/",
-            "tensorzero_config/"
+            "tensorzero_config/",
         ],
-        "create_subdir": True,
-    },
+        create_subdir=True,
+        path_in_examples=["elicitations"],
+    ),
 }
 
 
+def _development_mode_fallback(example_info: ExampleConfig) -> Path:
+    """Fallback function for development mode."""
+    package_dir = Path(__file__).parent.parent.parent.parent.parent
+    for dir in example_info.path_in_examples:
+        package_dir = package_dir / dir
+    console.print(f"[blue]Using development directory: {package_dir}[/blue]")
+    return package_dir
+
+
 def copy_example_files(example_type: str, target_dir: Path, force: bool = False) -> list[str]:
     """Copy example files from resources to target directory."""
-    created = []
-
     # Determine if we should create a subdirectory for this example type
-    example_info = EXAMPLE_TYPES[example_type]
-    if example_info["create_subdir"]:
+    example_info = _EXAMPLE_CONFIGS.get(example_type, None)
+    if example_info is None:
+        console.print(f"Example type '{example_type}' not found.")
+        return []
+
+    if example_info.create_subdir:
         target_dir = target_dir / example_type
         if not target_dir.exists():
             target_dir.mkdir(parents=True)
             console.print(f"Created subdirectory: {target_dir}")
 
-    # Create mount-point directory if needed
-    mount_point_files = example_info.get("mount_point_files", [])
-    if mount_point_files:
-        mount_point_dir = target_dir / "mount-point"
-        if not mount_point_dir.exists():
-            mount_point_dir.mkdir(parents=True)
-            console.print(f"Created mount-point directory: {mount_point_dir}")
-
     # Try to use examples from the installed package first, or fall back to the top-level directory
-    from importlib.resources import files
-
     try:
         # First try to find examples in the package resources
-        if example_type == "state-transfer":
-            # The state-transfer example is in the mcp subdirectory
-            source_dir = (
-                files("fast_agent")
-                .joinpath("resources")
-                .joinpath("examples")
-                .joinpath("mcp")
-                .joinpath("state-transfer")
-            )
-        elif example_type == "elicitations":
-            # The elicitations example is in the mcp subdirectory
-            source_dir = (
-                files("fast_agent")
-                .joinpath("resources")
-                .joinpath("examples")
-                .joinpath("mcp")
-                .joinpath("elicitations")
-            )
-        else:
-            # Other examples are at the top level of examples
-            source_dir = (
-                files("fast_agent")
-                .joinpath("resources")
-                .joinpath("examples")
-                .joinpath("workflows" if example_type == "workflow" else f"{example_type}")
-            )
+        source_dir = BASE_EXAMPLES_DIR
+        for dir in example_info.path_in_examples:
+            source_dir = source_dir.joinpath(dir)
 
         # Check if we found a valid directory
         if not source_dir.is_dir():
             console.print(
-                f"[yellow]Resource directory not found: {source_dir}. Falling back to development mode.[/yellow]"
+                f"[yellow]Resource directory not found: {source_dir}. "
+                "Falling back to development mode.[/yellow]"
             )
             # Fall back to the top-level directory for development mode
-            package_dir = Path(__file__).parent.parent.parent.parent.parent
-            if example_type == "state-transfer":
-                source_dir = package_dir / "examples" / "mcp" / "state-transfer"
-            elif example_type == "elicitations":
-                source_dir = package_dir / "examples" / "mcp" / "elicitations"
-            else:
-                source_dir = (
-                    package_dir
-                    / "examples"
-                    / ("workflows" if example_type == "workflow" else f"{example_type}")
-                )
-            console.print(f"[blue]Using development directory: {source_dir}[/blue]")
+            source_dir = _development_mode_fallback(example_info)
     except (ImportError, ModuleNotFoundError, ValueError) as e:
         console.print(
             f"[yellow]Error accessing resources: {e}. Falling back to development mode.[/yellow]"
         )
-        # Fall back to the top-level directory if the resource finding fails
-        package_dir = Path(__file__).parent.parent.parent.parent.parent
-        if example_type == "state-transfer":
-            source_dir = package_dir / "examples" / "mcp" / "state-transfer"
-        elif example_type == "elicitations":
-            source_dir = package_dir / "examples" / "mcp" / "elicitations"
-        else:
-            source_dir = (
-                package_dir
-                / "examples"
-                / ("workflows" if example_type == "workflow" else f"{example_type}")
-            )
+        source_dir = _development_mode_fallback(example_info)
 
     if not source_dir.exists():
         console.print(f"[red]Error: Source directory not found: {source_dir}[/red]")
-        return created
+        return []
 
-    for filename in example_info["files"]:
+    created = []
+    for filename in example_info.files:
         source = source_dir / filename
         target = target_dir / filename
 
@@ -213,16 +204,23 @@ def copy_example_files(example_type: str, target_dir: Path, force: bool = False)
                 rel_path = f"{example_type}/{filename}"
 
             created.append(rel_path)
-            console.print(f"[green]Created[/green] {created[-1]}")
+            console.print(f"[green]Created[/green] {rel_path}")
 
         except Exception as e:
             console.print(f"[red]Error copying {filename}: {str(e)}[/red]")
 
     # Copy mount-point files if any
+    mount_point_files = example_info.mount_point_files or []
     if mount_point_files:
-        source_mount_point = source_dir / "mount-point"
+        mount_point_dir = target_dir / "mount-point"
+
+        # Create mount-point directory if needed
+        if not mount_point_dir.exists():
+            mount_point_dir.mkdir(parents=True)
+            console.print(f"Created mount-point directory: {mount_point_dir}")
+
         for filename in mount_point_files:
-            source = source_mount_point / filename
+            source = source_dir / "mount-point" / filename
             target = mount_point_dir / filename
 
             try:
@@ -253,10 +251,14 @@ def copy_project_template(source_dir: Path, dest_dir: Path, console: Console, fo
     """
     if dest_dir.exists():
         if force:
-            console.print(f"[yellow]--force specified. Removing existing directory: {dest_dir}[/yellow]")
+            console.print(
+                f"[yellow]--force specified. Removing existing directory: {dest_dir}[/yellow]"
+            )
             shutil.rmtree(dest_dir)
         else:
-            console.print(f"[bold yellow]Directory '{dest_dir.name}' already exists.[/bold yellow] Use --force to overwrite.")
+            console.print(
+                f"[bold yellow]Directory '{dest_dir.name}' already exists.[/bold yellow] Use --force to overwrite."
+            )
             return False
 
     try:
@@ -278,14 +280,14 @@ def show_overview() -> None:
     table.add_column("Description")
     table.add_column("Files")
 
-    for name, info in EXAMPLE_TYPES.items():
+    for name, info in _EXAMPLE_CONFIGS.items():
         # Just show file count instead of listing all files
-        file_count = len(info["files"])
+        file_count = len(info.files)
         files_summary = f"{file_count} files"
-        if "mount_point_files" in info:
-            mount_count = len(info["mount_point_files"])
-            files_summary += f"\n+ {mount_count} data files"
-        table.add_row(f"[green]{name}[/green]", info["description"], files_summary)
+        mount_files = info.mount_point_files
+        if mount_files:
+            files_summary += f"\n+ {len(mount_files)} data files"
+        table.add_row(f"[green]{name}[/green]", info.description, files_summary)
 
     console.print(table)
 
@@ -445,7 +447,9 @@ def tensorzero(
         Path("."),
         help="Directory where the 'tensorzero' project folder will be created.",
     ),
-    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite if project directory exists"),
+    force: bool = typer.Option(
+        False, "--force", "-f", help="Force overwrite if project directory exists"
+    ),
 ):
     """Create the TensorZero project example."""
     console.print("[bold green]Setting up the TensorZero quickstart example...[/bold green]")
@@ -454,13 +458,18 @@ def tensorzero(
 
     # --- Find Source Directory ---
     from importlib.resources import files
+
     try:
         # This path MUST match the "to" path from hatch_build.py
-        source_dir = files("fast_agent").joinpath("resources").joinpath("examples").joinpath("tensorzero")
+        source_dir = (
+            files("fast_agent").joinpath("resources").joinpath("examples").joinpath("tensorzero")
+        )
         if not source_dir.is_dir():
             raise FileNotFoundError  # Fallback to dev mode if resource isn't a dir
     except (ImportError, ModuleNotFoundError, FileNotFoundError):
-        console.print("[yellow]Package resources not found. Falling back to development mode.[/yellow]")
+        console.print(
+            "[yellow]Package resources not found. Falling back to development mode.[/yellow]"
+        )
         # This path is relative to the project root in a development environment
         source_dir = Path(__file__).parent.parent.parent.parent / "examples" / "tensorzero"
 
@@ -486,7 +495,9 @@ def tensorzero(
             "   [dim]Then, open the new '.env' file and add your OpenAI or Anthropic API key.[/dim]"
         )
 
-        console.print("\n3. [bold]Start the required services (TensorZero Gateway & MCP Server):[/bold]")
+        console.print(
+            "\n3. [bold]Start the required services (TensorZero Gateway & MCP Server):[/bold]"
+        )
         console.print("   [cyan]docker compose up --build -d[/cyan]")
         console.print(
             "   [dim](This builds and starts the necessary containers in the background)[/dim]"
@@ -499,7 +510,9 @@ def tensorzero(
 
 @app.command(name="t0", help="Alias for the TensorZero quickstart.", hidden=True)
 def t0_alias(
-    directory: Path = typer.Argument(Path("."), help="Directory for the 'tensorzero' project folder."),
+    directory: Path = typer.Argument(
+        Path("."), help="Directory for the 'tensorzero' project folder."
+    ),
     force: bool = typer.Option(False, "--force", "-f", help="Force overwrite"),
 ):
     """Alias for the `tensorzero` command."""