fast-agent-mcp 0.3.3__tar.gz → 0.3.5__tar.gz

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/.gitignore

@@ -200,3 +200,4 @@ fastagent.jsonl
 
 tests/e2e/smoke/base/weather_location.txt
 tests/integration/roots/fastagent.jsonl
+.fast-agent/

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.3.3
+Version: 0.3.5
 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.7
+Requires-Python: >=3.13.5
 Requires-Dist: a2a-sdk>=0.3.0
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.66.0
@@ -218,6 +218,7 @@ Requires-Dist: deprecated>=1.2.18
 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.14.0
 Requires-Dist: openai>=1.106.1
 Requires-Dist: opentelemetry-distro>=0.55b0
@@ -321,7 +322,7 @@ Here is the complete `sizer.py` Agent application, with boilerplate code:
 
 ```python
 import asyncio
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("Agent Example")
@@ -380,6 +381,42 @@ uv run workflow/chaining.py --agent post_writer --message "<url>"
 
 Add the `--quiet` switch to disable progress and message display and return only the final response - useful for simple automations.
 
+## MCP OAuth (v2.1)
+
+For SSE and HTTP MCP servers, OAuth is enabled by default with minimal configuration. A local callback server is used to capture the authorization code, with a paste-URL fallback if the port is unavailable.
+
+- Minimal per-server settings in `fastagent.config.yaml`:
+
+```yaml
+mcp:
+  servers:
+    myserver:
+      transport: http # or sse
+      url: http://localhost:8001/mcp # or /sse for SSE servers
+      auth:
+        oauth: true # default: true
+        redirect_port: 3030 # default: 3030
+        redirect_path: /callback # default: /callback
+        # scope: "user"       # optional; if omitted, server defaults are used
+```
+
+- The OAuth client uses PKCE and in-memory token storage (no tokens written to disk).
+- Token persistence: by default, tokens are stored securely in your OS keychain via `keyring`. If a keychain is unavailable (e.g., headless container), in-memory storage is used for the session.
+- To force in-memory only per server, set:
+
+```yaml
+mcp:
+  servers:
+    myserver:
+      transport: http
+      url: http://localhost:8001/mcp
+      auth:
+        oauth: true
+        persist: memory
+```
+
+- To disable OAuth for a specific server , set `auth.oauth: false` for that server.
+
 ## Workflows
 
 ### Chain

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/README.md

@@ -83,7 +83,7 @@ Here is the complete `sizer.py` Agent application, with boilerplate code:
 
 ```python
 import asyncio
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("Agent Example")
@@ -142,6 +142,42 @@ uv run workflow/chaining.py --agent post_writer --message "<url>"
 
 Add the `--quiet` switch to disable progress and message display and return only the final response - useful for simple automations.
 
+## MCP OAuth (v2.1)
+
+For SSE and HTTP MCP servers, OAuth is enabled by default with minimal configuration. A local callback server is used to capture the authorization code, with a paste-URL fallback if the port is unavailable.
+
+- Minimal per-server settings in `fastagent.config.yaml`:
+
+```yaml
+mcp:
+  servers:
+    myserver:
+      transport: http # or sse
+      url: http://localhost:8001/mcp # or /sse for SSE servers
+      auth:
+        oauth: true # default: true
+        redirect_port: 3030 # default: 3030
+        redirect_path: /callback # default: /callback
+        # scope: "user"       # optional; if omitted, server defaults are used
+```
+
+- The OAuth client uses PKCE and in-memory token storage (no tokens written to disk).
+- Token persistence: by default, tokens are stored securely in your OS keychain via `keyring`. If a keychain is unavailable (e.g., headless container), in-memory storage is used for the session.
+- To force in-memory only per server, set:
+
+```yaml
+mcp:
+  servers:
+    myserver:
+      transport: http
+      url: http://localhost:8001/mcp
+      auth:
+        oauth: true
+        persist: memory
+```
+
+- To disable OAuth for a specific server , set `auth.oauth: false` for that server.
+
 ## Workflows
 
 ### Chain

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/custom-agents/agent.py

@@ -1,7 +1,7 @@
 import asyncio
 
-from fast_agent.agents.mcp_agent import McpAgent
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
+from fast_agent.agents import McpAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/data-analysis/analysis-campaign.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.llm.fastagent_llm import RequestParams
 
 # Create the application

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/data-analysis/analysis.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("Data Analysis (Roots)")

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/fastapi/fastapi-advanced.py

@@ -2,8 +2,8 @@ from contextlib import asynccontextmanager
 
 from fastapi import Body, FastAPI, HTTPException
 
+from fast_agent.agents import McpAgent
 from fast_agent.agents.agent_types import AgentConfig
-from fast_agent.agents.mcp_agent import McpAgent
 from fast_agent.core import Core
 from fast_agent.core.direct_factory import get_model_factory
 from fast_agent.mcp import PromptMessageExtended

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/fastapi/fastapi-simple.py

@@ -3,7 +3,7 @@ from contextlib import asynccontextmanager
 from fastapi import FastAPI, HTTPException
 from pydantic import BaseModel
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create FastAgent without parsing CLI args (plays nice with uvicorn)
 fast = FastAgent("fast-agent demo", parse_cli_args=False, quiet=True)

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/mcp/elicitations/forms_demo.py

@@ -13,7 +13,7 @@ import asyncio
 from rich.console import Console
 from rich.panel import Panel
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.mcp.helpers.content_helpers import get_resource_text
 
 fast = FastAgent("Elicitation Forms Demo", quiet=True)

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/mcp/elicitations/game_character.py

@@ -14,7 +14,7 @@ from game_character_handler import game_character_elicitation_handler
 from rich.console import Console
 from rich.panel import Panel
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.mcp.helpers.content_helpers import get_resource_text
 
 fast = FastAgent("Game Character Creator", quiet=True)

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/mcp/elicitations/tool_call.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/mcp/mcp-filtering/test_mcp_filtering.py

@@ -1,7 +1,7 @@
 import asyncio
 import sys
 
-from fast_agent.core.fastagent import FastAgent, PromptExitError
+from fast_agent import FastAgent, PromptExitError
 
 fast_agent = FastAgent(name="MCP Filtering Demo", parse_cli_args=False, quiet=False)
 

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/mcp/state-transfer/agent_one.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent agent_one (mcp server)")

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/mcp/state-transfer/agent_two.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent agent_two (mcp client)")

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/mcp/vision-examples/example1.py

@@ -1,7 +1,7 @@
 import asyncio
 from pathlib import Path
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.core.prompt import Prompt
 
 # Create the application

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/mcp/vision-examples/example2.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/mcp/vision-examples/example3.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/otel/agent.py

@@ -3,7 +3,7 @@ from typing import Annotated
 
 from pydantic import BaseModel, Field
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.core.prompt import Prompt
 from fast_agent.llm.request_params import RequestParams
 

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/otel/agent2.py

@@ -3,7 +3,7 @@ from typing import Annotated
 
 from pydantic import BaseModel, Field
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.core.prompt import Prompt
 from fast_agent.llm.request_params import RequestParams
 

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/researcher/researcher-eval.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 agents = FastAgent(name="Researcher Agent (EO)")
 

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/researcher/researcher-imp.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 agents = FastAgent(name="Enhanced Researcher")
 

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/researcher/researcher.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # from rich import print
 

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5/examples}/setup/agent.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5/examples}/setup/fastagent.config.yaml

@@ -12,6 +12,7 @@
 
 default_model: haiku
 # 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
 
 # Logging and Console Configuration:
@@ -40,5 +41,4 @@ mcp:
       command: "npx"
       args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
     huggingface:
-      transport: "http"
-      url: "https://huggingface.co/mcp"
+      url: "https://huggingface.co/mcp?login"

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/tensorzero/agent.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.llm.request_params import RequestParams
 
 # Explicitly provide the path to the config file in the current directory

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/tensorzero/image_demo.py

@@ -6,7 +6,7 @@ from typing import List, Union
 
 from mcp.types import ImageContent, TextContent
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.core.prompt import Prompt
 from fast_agent.llm.request_params import RequestParams
 

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/tensorzero/simple_agent.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 CONFIG_FILE = "fastagent.config.yaml"
 fast = FastAgent("fast-agent example", config_path=CONFIG_FILE, ignore_unknown_args=True)

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/workflows/chaining.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("Agent Chaining")

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/workflows/evaluator.py

@@ -4,7 +4,7 @@ This demonstrates creating an optimizer and evaluator to iteratively improve con
 
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("Evaluator-Optimizer")

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/workflows/human_input.py

@@ -4,7 +4,7 @@ Agent which demonstrates Human Input tool
 
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("Human Input")

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/examples/workflows/orchestrator.py

@@ -4,7 +4,7 @@ This demonstrates creating multiple agents and an orchestrator to coordinate the
 
 import asyncio
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent("Orchestrator-Workers")

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/workflows/parallel.py

@@ -5,7 +5,7 @@ Parallel Workflow showing Fan Out and Fan In agents, using different models
 import asyncio
 from pathlib import Path
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 from fast_agent.core.prompt import Prompt
 
 # Create the application

{fast_agent_mcp-0.3.3/src/fast_agent/resources → fast_agent_mcp-0.3.5}/examples/workflows/router.py

@@ -9,7 +9,7 @@ import asyncio
 
 from rich.console import Console
 
-from fast_agent.core.fastagent import FastAgent
+from fast_agent import FastAgent
 
 # Create the application
 fast = FastAgent(

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.3.3"
+version = "0.3.5"
 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.7"
+requires-python = ">=3.13.5"
 dependencies = [
     "fastapi>=0.115.6",
     "mcp==1.14.0",
@@ -39,6 +39,7 @@ dependencies = [
     "a2a-sdk>=0.3.0",
     "email-validator>=2.2.0",
     "pyperclip>=1.9.0",
+    "keyring>=24.3.1",
 ]
 
 # For Azure OpenAI with DefaultAzureCredential support, install with: pip install fast-agent-mcp[azure]

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/src/fast_agent/__init__.py

@@ -1,5 +1,6 @@
 """fast-agent - An MCP native agent application framework"""
-from typing import TYPE_CHECKING as _TYPE_CHECKING
+
+from typing import TYPE_CHECKING
 
 # Configuration and settings (safe - pure Pydantic models)
 from fast_agent.config import (
@@ -73,10 +74,12 @@ def __getattr__(name: str):
 
         return ToolAgent
     elif name == "McpAgent":
+        # Import directly from submodule to avoid package re-import cycles
         from fast_agent.agents.mcp_agent import McpAgent
 
         return McpAgent
     elif name == "FastAgent":
+        # Import from the canonical implementation to avoid recursive imports
         from fast_agent.core.fastagent import FastAgent
 
         return FastAgent
@@ -85,7 +88,8 @@ def __getattr__(name: str):
 
 
 # Help static analyzers/IDEs resolve symbols and signatures without importing at runtime.
-if _TYPE_CHECKING:  # pragma: no cover - typing aid only
+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
 
 
@@ -124,7 +128,6 @@ __all__ = [
     "LlmStopReason",
     "RequestParams",
     # Agents (lazy loaded)
-    "ToolAgentSynchronous",
     "LlmAgent",
     "LlmDecorator",
     "ToolAgent",

fast_agent_mcp-0.3.5/src/fast_agent/agents/__init__.py

@@ -0,0 +1,85 @@
+"""
+Fast Agent - Agent implementations and workflow patterns.
+
+This module re-exports agent classes with lazy imports to avoid circular
+dependencies during package initialization while preserving a clean API:
+
+    from fast_agent.agents import McpAgent, ToolAgent, LlmAgent
+"""
+
+from typing import TYPE_CHECKING
+
+from fast_agent.agents.agent_types import AgentConfig
+
+
+def __getattr__(name: str):
+    """Lazily resolve agent classes to avoid import cycles."""
+    if name == "LlmAgent":
+        from .llm_agent import LlmAgent
+
+        return LlmAgent
+    elif name == "LlmDecorator":
+        from .llm_decorator import LlmDecorator
+
+        return LlmDecorator
+    elif name == "ToolAgent":
+        from .tool_agent import ToolAgent
+
+        return ToolAgent
+    elif name == "McpAgent":
+        from .mcp_agent import McpAgent
+
+        return McpAgent
+    elif name == "ChainAgent":
+        from .workflow.chain_agent import ChainAgent
+
+        return ChainAgent
+    elif name == "EvaluatorOptimizerAgent":
+        from .workflow.evaluator_optimizer import EvaluatorOptimizerAgent
+
+        return EvaluatorOptimizerAgent
+    elif name == "IterativePlanner":
+        from .workflow.iterative_planner import IterativePlanner
+
+        return IterativePlanner
+    elif name == "ParallelAgent":
+        from .workflow.parallel_agent import ParallelAgent
+
+        return ParallelAgent
+    elif name == "RouterAgent":
+        from .workflow.router_agent import RouterAgent
+
+        return RouterAgent
+    else:
+        raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+
+if TYPE_CHECKING:  # pragma: no cover - type checking only
+    from .llm_agent import LlmAgent as LlmAgent  # noqa: F401
+    from .llm_decorator import LlmDecorator as LlmDecorator  # noqa: F401
+    from .mcp_agent import McpAgent as McpAgent  # noqa: F401
+    from .tool_agent import ToolAgent as ToolAgent  # noqa: F401
+    from .workflow.chain_agent import ChainAgent as ChainAgent  # noqa: F401
+    from .workflow.evaluator_optimizer import (
+        EvaluatorOptimizerAgent as EvaluatorOptimizerAgent,
+    )  # noqa: F401
+    from .workflow.iterative_planner import IterativePlanner as IterativePlanner  # noqa: F401
+    from .workflow.parallel_agent import ParallelAgent as ParallelAgent  # noqa: F401
+    from .workflow.router_agent import RouterAgent as RouterAgent  # noqa: F401
+
+
+__all__ = [
+    # Core agents
+    "LlmAgent",
+    "LlmDecorator",
+    "ToolAgent",
+    "McpAgent",
+    # Workflow agents
+    "ChainAgent",
+    "EvaluatorOptimizerAgent",
+    "IterativePlanner",
+    "ParallelAgent",
+    "RouterAgent",
+    # Types
+    "AgentConfig",
+]

{fast_agent_mcp-0.3.3 → fast_agent_mcp-0.3.5}/src/fast_agent/cli/__main__.py

@@ -13,14 +13,17 @@ def main():
         # Check if first arg is not already a subcommand
         first_arg = sys.argv[1]
 
-        if first_arg not in KNOWN_SUBCOMMANDS and any(
-            arg in sys.argv or any(arg.startswith(opt + "=") for opt in GO_SPECIFIC_OPTIONS)
-            for arg in sys.argv
-        ):
+        # Only auto-route if any known go-specific options are present
+        has_go_options = any(
+            (arg in GO_SPECIFIC_OPTIONS) or any(arg.startswith(opt + "=") for opt in GO_SPECIFIC_OPTIONS)
+            for arg in sys.argv[1:]
+        )
+
+        if first_arg not in KNOWN_SUBCOMMANDS and has_go_options:
             # Find where to insert 'go' - before the first go-specific option
             insert_pos = 1
             for i, arg in enumerate(sys.argv[1:], 1):
-                if arg in GO_SPECIFIC_OPTIONS or any(
+                if (arg in GO_SPECIFIC_OPTIONS) or any(
                     arg.startswith(opt + "=") for opt in GO_SPECIFIC_OPTIONS
                 ):
                     insert_pos = i