fast-agent-mcp 0.2.9__tar.gz → 0.2.11__tar.gz

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/.gitignore

@@ -191,3 +191,5 @@ fastagent.jsonl
 tests/integration/resources/fastagent.jsonl
 fastagent.jsonl
 tests/e2e/workflow/weather_location.txt
+tests/integration/prompt-state/multipart.json
+tests/integration/prompt-state/history.json

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.9
+Version: 0.2.11
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>, Sarmad Qadri <sarmad@lastmileai.dev>
 License:                                  Apache License
@@ -209,6 +209,7 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
+Requires-Dist: a2a-types>=0.1.0
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.49.0
 Requires-Dist: fastapi>=0.115.6
@@ -252,7 +253,7 @@ 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.
+> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. llms.txt link is 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. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o family, o1/o3 family) are supported.
 
@@ -282,10 +283,10 @@ uv pip install fast-agent-mcp       # install fast-agent!
 fast-agent setup                    # create an example agent and config files
 uv run agent.py                     # run your first agent
 uv run agent.py --model=o3-mini.low # specify a model
-fast-agent bootstrap workflow       # create "building effective agents" examples
+fast-agent quickstart workflow       # create "building effective agents" examples
 ```
 
-Other bootstrap examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
+Other quickstart examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
 
 > [!TIP]
 > Windows Users - there are a couple of configuration changes needed for the Filesystem and Docker MCP Servers - necessary changes are detailed within the configuration files.
@@ -341,7 +342,7 @@ Specify a model with the `--model` switch - for example `uv run sizer.py --model
 
 ### Combining Agents and using MCP Servers
 
-_To generate examples use `fast-agent bootstrap workflow`. This example can be run with `uv run workflow/chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
+_To generate examples use `fast-agent quickstart workflow`. This example can be run with `uv run workflow/chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
 
 Agents can be chained to build a workflow, using MCP Servers defined in the `fastagent.config.yaml` file:
 
@@ -463,7 +464,7 @@ async with fast.run() as agent:
 
 When used in a workflow, it returns the last `generator` message as the result.
 
-See the `evaluator.py` workflow example, or `fast-agent bootstrap researcher` for a more complete example.
+See the `evaluator.py` workflow example, or `fast-agent quickstart researcher` for a more complete example.
 
 ### Router
 

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/README.md

@@ -10,7 +10,7 @@
 ## Overview
 
 > [!TIP]
-> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not.
+> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. llms.txt link is 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. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o family, o1/o3 family) are supported.
 
@@ -40,10 +40,10 @@ uv pip install fast-agent-mcp       # install fast-agent!
 fast-agent setup                    # create an example agent and config files
 uv run agent.py                     # run your first agent
 uv run agent.py --model=o3-mini.low # specify a model
-fast-agent bootstrap workflow       # create "building effective agents" examples
+fast-agent quickstart workflow       # create "building effective agents" examples
 ```
 
-Other bootstrap examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
+Other quickstart examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
 
 > [!TIP]
 > Windows Users - there are a couple of configuration changes needed for the Filesystem and Docker MCP Servers - necessary changes are detailed within the configuration files.
@@ -99,7 +99,7 @@ Specify a model with the `--model` switch - for example `uv run sizer.py --model
 
 ### Combining Agents and using MCP Servers
 
-_To generate examples use `fast-agent bootstrap workflow`. This example can be run with `uv run workflow/chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
+_To generate examples use `fast-agent quickstart workflow`. This example can be run with `uv run workflow/chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
 
 Agents can be chained to build a workflow, using MCP Servers defined in the `fastagent.config.yaml` file:
 
@@ -221,7 +221,7 @@ async with fast.run() as agent:
 
 When used in a workflow, it returns the last `generator` message as the result.
 
-See the `evaluator.py` workflow example, or `fast-agent bootstrap researcher` for a more complete example.
+See the `evaluator.py` workflow example, or `fast-agent quickstart researcher` for a more complete example.
 
 ### Router
 

fast_agent_mcp-0.2.11/examples/mcp/state-transfer/agent_one.py

@@ -0,0 +1,18 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent agent_one (mcp server)")
+
+
+# Define the agent
+@fast.agent(name="agent_one", instruction="You are a helpful AI Agent.")
+async def main():
+    # use the --model command line switch or agent arguments to change model
+    async with fast.run() as agent:
+        await agent.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.2.11/examples/mcp/state-transfer/agent_two.py

@@ -0,0 +1,18 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent agent_two (mcp client)")
+
+
+# Define the agent
+@fast.agent(name="agent_two", instruction="You are a helpful AI Agent.", servers=["agent_one"])
+async def main():
+    # use the --model command line switch or agent arguments to change model
+    async with fast.run() as agent:
+        await agent.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.2.11/examples/mcp/state-transfer/fastagent.config.yaml

@@ -0,0 +1,27 @@
+# Model string takes format:
+#   <provider>.<model_string>.<reasoning_effort?> (e.g. anthropic.claude-3-5-sonnet-20241022 or openai.o3-mini.low)
+#
+# Can be overriden with a command line switch --model=<model>, or within the Agent decorator.
+# Check here for current details: https://fast-agent.ai/models/
+
+# set the default model for fast-agent below:
+default_model: gpt-4o
+
+# Logging and Console Configuration:
+logger:
+  # Switched off to avoid polluting the console
+  progress_display: false
+
+  # Show chat User/Assistant messages on the console
+  show_chat: true
+  # Show tool calls on the console
+  show_tools: true
+  # Truncate long tool responses on the console
+  truncate_tools: true
+
+# MCP Servers
+mcp:
+  servers:
+    agent_one:
+      transport: sse
+      url: http://localhost:8001/sse

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.2.9"
+version = "0.2.11"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -30,6 +30,7 @@ dependencies = [
     "openai>=1.63.2",
     "prompt-toolkit>=3.0.50",
     "aiohttp>=3.11.13",
+    "a2a-types>=0.1.0",
 ]
 
 [project.optional-dependencies]
@@ -64,6 +65,8 @@ include = [
     "src/mcp_agent/**/*.yaml",
     "src/mcp_agent/**/*.yml",
     "src/mcp_agent/**/*.csv",
+    "src/mcp_agent/**/*.txt",    
+    "src/mcp_agent/**/*.example",    
     "examples/**/*.py",
     "examples/**/*.yaml",
     "examples/**/*.yml",
@@ -72,6 +75,10 @@ include = [
     "examples/**/*.md",
     "examples/**/*.css",
     "examples/**/mount-point/*.csv",
+    "examples/workflows/short_story.txt",
+    "examples/mcp/**/*.py",
+    "examples/mcp/**/*.yaml",
+    "examples/mcp/**/*.example",
 ]
 
 [tool.pytest.ini_options]
@@ -95,11 +102,11 @@ dev = [
     "tomli>=2.2.1",
     "pytest>=7.4.0",
     "pytest-asyncio>=0.21.1",
+    "pytest-cov>=6.1.1",
 ]
 
 [project.scripts]
 fast-agent = "mcp_agent.cli.__main__:app"
-fast_agent = "mcp_agent.cli.__main__:app"
 fastagent = "mcp_agent.cli.__main__:app"
 silsila = "mcp_agent.cli.__main__:app"
 prompt-server = "mcp_agent.mcp.prompts.__main__:main"

fast_agent_mcp-0.2.9/src/mcp_agent/cli/commands/bootstrap.py → fast_agent_mcp-0.2.11/src/mcp_agent/cli/commands/quickstart.py

@@ -47,6 +47,18 @@ EXAMPLE_TYPES = {
         "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": [
+            "agent_one.py",
+            "agent_two.py",
+            "fastagent.config.yaml",
+            "fastagent.secrets.yaml.example",
+        ],
+        "create_subdir": True,
+    },
 }
 
 
@@ -75,28 +87,54 @@ def copy_example_files(example_type: str, target_dir: Path, force: bool = False)
 
     try:
         # First try to find examples in the package resources
-        source_dir = (
-            files("mcp_agent")
-            .joinpath("resources")
-            .joinpath("examples")
-            .joinpath("workflows" if example_type == "workflow" else f"{example_type}")
-        )
+        if example_type == "state-transfer":
+            # The state-transfer example is in the mcp subdirectory
+            source_dir = (
+                files("mcp_agent")
+                .joinpath("resources")
+                .joinpath("examples")
+                .joinpath("mcp")
+                .joinpath("state-transfer")
+            )
+        else:
+            # Other examples are at the top level of examples
+            source_dir = (
+                files("mcp_agent")
+                .joinpath("resources")
+                .joinpath("examples")
+                .joinpath("workflows" if example_type == "workflow" else f"{example_type}")
+            )
+
+        # 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]"
+            )
             # 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"
+            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]")
+    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"
+        else:
             source_dir = (
                 package_dir
                 / "examples"
                 / ("workflows" if example_type == "workflow" else f"{example_type}")
             )
-    except (ImportError, ModuleNotFoundError, ValueError):
-        # Fall back to the top-level directory if the resource finding fails
-        package_dir = Path(__file__).parent.parent.parent.parent.parent
-        source_dir = (
-            package_dir
-            / "examples"
-            / ("workflows" if example_type == "workflow" else f"{example_type}")
-        )
 
     if not source_dir.exists():
         console.print(f"[red]Error: Source directory not found: {source_dir}[/red]")
@@ -116,7 +154,14 @@ def copy_example_files(example_type: str, target_dir: Path, force: bool = False)
                 continue
 
             shutil.copy2(source, target)
-            created.append(str(target.relative_to(target_dir.parent)))
+            try:
+                # This can fail in test environments where the target is not relative to target_dir.parent
+                rel_path = str(target.relative_to(target_dir.parent))
+            except ValueError:
+                # Fallback to just the filename
+                rel_path = f"{example_type}/{filename}"
+
+            created.append(rel_path)
             console.print(f"[green]Created[/green] {created[-1]}")
 
         except Exception as e:
@@ -174,15 +219,17 @@ def show_overview() -> None:
     # Show usage instructions in a panel
     usage_text = (
         "[bold]Commands:[/bold]\n"
-        "  fastagent bootstrap workflow DIR      Create workflow examples in DIR\n"
-        "  fastagent bootstrap researcher DIR    Create researcher example in 'researcher' subdirectory\n"
-        "  fastagent bootstrap data-analysis DIR Create data analysis examples in 'data-analysis' subdirectory\n\n"
+        "  fastagent quickstart workflow DIR      Create workflow examples in DIR\n"
+        "  fastagent quickstart researcher DIR    Create researcher example in 'researcher' subdirectory\n"
+        "  fastagent quickstart data-analysis DIR Create data analysis examples in 'data-analysis' subdirectory\n"
+        "  fastagent quickstart state-transfer DIR Create state transfer examples in 'state-transfer' subdirectory\n\n"
         "[bold]Options:[/bold]\n"
         "  --force            Overwrite existing files\n\n"
         "[bold]Examples:[/bold]\n"
-        "  fastagent bootstrap workflow .              Create in current directory\n"
-        "  fastagent bootstrap researcher .            Create in researcher subdirectory\n"
-        "  fastagent bootstrap data-analysis . --force Force overwrite files in data-analysis subdirectory"
+        "  fastagent quickstart workflow .              Create in current directory\n"
+        "  fastagent quickstart researcher .            Create in researcher subdirectory\n"
+        "  fastagent quickstart data-analysis . --force Force overwrite files in data-analysis subdirectory\n"
+        "  fastagent quickstart state-transfer .        Create state transfer examples"
     )
     console.print(Panel(usage_text, title="Usage", border_style="blue"))
 
@@ -241,6 +288,24 @@ def data_analysis(
     _show_completion_message("data-analysis", created)
 
 
+@app.command()
+def state_transfer(
+    directory: Path = typer.Argument(
+        Path("."),
+        help="Directory where state transfer examples will be created (in 'state-transfer' subdirectory)",
+    ),
+    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite existing files"),
+) -> None:
+    """Create state transfer example showing state passing between agents."""
+    target_dir = directory.resolve()
+    if not target_dir.exists():
+        target_dir.mkdir(parents=True)
+        console.print(f"Created directory: {target_dir}")
+
+    created = copy_example_files("state-transfer", target_dir, force)
+    _show_completion_message("state-transfer", created)
+
+
 def _show_completion_message(example_type: str, created: list[str]) -> None:
     """Show completion message and next steps."""
     if created:
@@ -275,6 +340,8 @@ def _show_completion_message(example_type: str, created: list[str]) -> None:
             console.print(
                 "On Windows platforms, please edit the fastagent.config.yaml and adjust the volume mount point."
             )
+        elif example_type == "state-transfer":
+            console.print("Check https://fast-agent.ai for quick start walkthroughs")
     else:
         console.print("\n[yellow]No files were created.[/yellow]")
 

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/src/mcp_agent/cli/commands/setup.py

@@ -55,12 +55,18 @@ FASTAGENT_SECRETS_TEMPLATE = """
 # FastAgent Secrets Configuration
 # WARNING: Keep this file secure and never commit to version control
 
-# Alternatively set OPENAI_API_KEY and ANTHROPIC_API_KEY environment variables. Config file takes precedence.
+# Alternatively set OPENAI_API_KEY, ANTHROPIC_API_KEY or other environment variables. 
+# Keys in the configuration file override environment variables.
 
 openai:
     api_key: <your-api-key-here>
 anthropic:
     api_key: <your-api-key-here>
+deepseek:
+    api_key: <your-api-key-here>
+openrouter:
+    api_key: <your-api-key-here>
+
 
 # Example of setting an MCP Server environment variable
 mcp:
@@ -116,15 +122,15 @@ import asyncio
 from mcp_agent.core.fastagent import FastAgent
 
 # Create the application
-fast = FastAgent("FastAgent Example")
+fast = FastAgent("fast-agent example")
 
 
 # Define the agent
-@fast.agent(instruction="You are a helpful AI Agent", servers=["fetch"])
+@fast.agent(instruction="You are a helpful AI Agent")
 async def main():
     # use the --model command line switch or agent arguments to change model
     async with fast.run() as agent:
-        await agent()
+        await agent.interactive()
 
 
 if __name__ == "__main__":

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/src/mcp_agent/cli/main.py

@@ -4,7 +4,7 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
-from mcp_agent.cli.commands import bootstrap, setup
+from mcp_agent.cli.commands import quickstart, setup
 from mcp_agent.cli.terminal import Application
 
 app = typer.Typer(
@@ -14,7 +14,8 @@ app = typer.Typer(
 
 # Subcommands
 app.add_typer(setup.app, name="setup", help="Set up a new agent project")
-app.add_typer(bootstrap.app, name="bootstrap", help="Create example applications")
+app.add_typer(quickstart.app, name="bootstrap", help="Create example applications")
+app.add_typer(quickstart.app, name="quickstart", help="Create example applications")
 
 # Shared application context
 application = Application()
@@ -39,7 +40,7 @@ def show_welcome() -> None:
     table.add_column("Description")
 
     table.add_row("setup", "Set up a new agent project with configuration files")
-    table.add_row("bootstrap", "Create example applications (workflow, researcher, etc.)")
+    table.add_row("quickstart", "Create example applications (workflow, researcher, etc.)")
     # table.add_row("config", "Manage agent configuration settings")
 
     console.print(table)
@@ -48,12 +49,12 @@ def show_welcome() -> None:
     console.print("1. Set up a new project:")
     console.print("   fastagent setup")
     console.print("\n2. Create Building Effective Agents  workflow examples:")
-    console.print("   fastagent bootstrap workflow")
+    console.print("   fastagent quickstart workflow")
     console.print("\n3. Explore other examples:")
-    console.print("   fastagent bootstrap")
+    console.print("   fastagent quickstart")
 
     console.print("\nUse --help with any command for more information")
-    console.print("Example: fastagent bootstrap --help")
+    console.print("Example: fastagent quickstart --help")
 
 
 @app.callback(invoke_without_command=True)
@@ -74,6 +75,7 @@ def main(
     # Handle version flag
     if version:
         from importlib.metadata import version as get_version
+
         try:
             app_version = get_version("fast-agent-mcp")
         except:  # noqa: E722

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/src/mcp_agent/config.py

@@ -70,6 +70,9 @@ class MCPServerSettings(BaseModel):
     """The arguments for the server command."""
 
     read_timeout_seconds: int | None = None
+    """The timeout in seconds for the session."""
+
+    read_transport_sse_timeout_seconds: int = 300
     """The timeout in seconds for the server connection."""
 
     url: str | None = None

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/src/mcp_agent/llm/providers/augmented_llm_generic.py

@@ -40,8 +40,8 @@ class GenericAugmentedLLM(OpenAIAugmentedLLM):
         return api_key or "ollama"
 
     def _base_url(self) -> str:
-        base_url = None
+        base_url = os.getenv("GENERIC_BASE_URL", DEFAULT_OLLAMA_BASE_URL)
         if self.context.config and self.context.config.generic:
             base_url = self.context.config.generic.base_url
 
-        return base_url if base_url else DEFAULT_OLLAMA_BASE_URL
+        return base_url

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/src/mcp_agent/llm/providers/augmented_llm_openrouter.py

@@ -4,7 +4,7 @@ from mcp_agent.core.exceptions import ProviderKeyError
 from mcp_agent.core.request_params import RequestParams
 from mcp_agent.llm.providers.augmented_llm_openai import OpenAIAugmentedLLM
 
-OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
+DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
 # No single default model for OpenRouter, users must specify full path
 DEFAULT_OPENROUTER_MODEL = None 
 
@@ -63,7 +63,7 @@ class OpenRouterAugmentedLLM(OpenAIAugmentedLLM):
 
     def _base_url(self) -> str:
         """Retrieve the OpenRouter base URL from config or use the default."""
-        base_url = OPENROUTER_BASE_URL # Default
+        base_url = os.getenv("OPENROUTER_BASE_URL", DEFAULT_OPENROUTER_BASE_URL)  # Default
         config = self.context.config
         
         # Check config file for override

{fast_agent_mcp-0.2.9 → fast_agent_mcp-0.2.11}/src/mcp_agent/mcp/mcp_connection_manager.py

@@ -271,7 +271,11 @@ class MCPConnectionManager(ContextDependent):
                 logger.debug(f"{server_name}: Creating stdio client with custom error handler")
                 return stdio_client(server_params, errlog=error_handler)
             elif config.transport == "sse":
-                return sse_client(config.url, config.headers)
+                return sse_client(
+                    config.url,
+                    config.headers,
+                    sse_read_timeout=config.read_transport_sse_timeout_seconds,
+                )
             else:
                 raise ValueError(f"Unsupported transport: {config.transport}")