fast-agent-mcp 0.1.12__py3-none-any.whl → 0.2.0__py3-none-any.whl

mcp_agent/cli/commands/bootstrap.py

@@ -2,10 +2,11 @@
 
 import shutil
 from pathlib import Path
+
 import typer
 from rich.console import Console
-from rich.table import Table
 from rich.panel import Panel
+from rich.table import Table
 
 app = typer.Typer(
     help="Create example applications",
@@ -49,9 +50,7 @@ EXAMPLE_TYPES = {
 }
 
 
-def copy_example_files(
-    example_type: str, target_dir: Path, force: bool = False
-) -> list[str]:
+def copy_example_files(example_type: str, target_dir: Path, force: bool = False) -> list[str]:
     """Copy example files from resources to target directory."""
     created = []
 
@@ -71,13 +70,9 @@ def copy_example_files(
             mount_point_dir.mkdir(parents=True)
             console.print(f"Created mount-point directory: {mount_point_dir}")
 
-    # Use the resources directory from the package
-    source_dir = (
-        Path(__file__).parent.parent.parent
-        / "resources"
-        / "examples"
-        / ("workflows" if example_type == "workflow" else f"{example_type}")
-    )
+    # Use examples from top-level directory
+    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]")
@@ -126,22 +121,18 @@ def copy_example_files(
                 console.print(f"[green]Created[/green] mount-point/{filename}")
 
             except Exception as e:
-                console.print(
-                    f"[red]Error copying mount-point/{filename}: {str(e)}[/red]"
-                )
+                console.print(f"[red]Error copying mount-point/{filename}: {str(e)}[/red]")
 
     return created
 
 
-def show_overview():
+def show_overview() -> None:
     """Display an overview of available examples in a nicely formatted table."""
     console.print("\n[bold cyan]fast-agent Example Applications[/bold cyan]")
     console.print("Build agents and compose workflows through practical examples\n")
 
     # Create a table for better organization
-    table = Table(
-        show_header=True, header_style="bold magenta", box=None, padding=(0, 2)
-    )
+    table = Table(show_header=True, header_style="bold magenta", box=None, padding=(0, 2))
     table.add_column("Example")
     table.add_column("Description")
     table.add_column("Files")
@@ -178,10 +169,8 @@ def workflow(
         Path("."),
         help="Directory where workflow examples will be created",
     ),
-    force: bool = typer.Option(
-        False, "--force", "-f", help="Force overwrite existing files"
-    ),
-):
+    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite existing files"),
+) -> None:
     """Create workflow pattern examples."""
     target_dir = directory.resolve()
     if not target_dir.exists():
@@ -198,10 +187,8 @@ def researcher(
         Path("."),
         help="Directory where researcher examples will be created (in 'researcher' subdirectory)",
     ),
-    force: bool = typer.Option(
-        False, "--force", "-f", help="Force overwrite existing files"
-    ),
-):
+    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite existing files"),
+) -> None:
     """Create researcher pattern examples."""
     target_dir = directory.resolve()
     if not target_dir.exists():
@@ -218,10 +205,8 @@ def data_analysis(
         Path("."),
         help="Directory where data analysis examples will be created (creates 'data-analysis' subdirectory with mount-point)",
     ),
-    force: bool = typer.Option(
-        False, "--force", "-f", help="Force overwrite existing files"
-    ),
-):
+    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite existing files"),
+) -> None:
     """Create data analysis examples with sample dataset."""
     target_dir = directory.resolve()
     if not target_dir.exists():
@@ -232,7 +217,7 @@ def data_analysis(
     _show_completion_message("data-analysis", created)
 
 
-def _show_completion_message(example_type: str, created: list[str]):
+def _show_completion_message(example_type: str, created: list[str]) -> None:
     """Show completion message and next steps."""
     if created:
         console.print("\n[green]Setup completed successfully![/green]")
@@ -258,13 +243,9 @@ def _show_completion_message(example_type: str, created: list[str]):
                 "1. Set up the Brave MCP Server (get an API key from https://brave.com/search/api/)"
             )
             console.print("2. Try `uv run researcher.py` for the basic version")
-            console.print(
-                "3. Try `uv run researcher-eval.py` for the eval/optimize version"
-            )
+            console.print("3. Try `uv run researcher-eval.py` for the eval/optimize version")
         elif example_type == "data-analysis":
-            console.print(
-                "1. Run uv `analysis.py` to perform data analysis and visualization"
-            )
+            console.print("1. Run uv `analysis.py` to perform data analysis and visualization")
             console.print("2. The dataset is available in the mount-point directory:")
             console.print("   - mount-point/WA_Fn-UseC_-HR-Employee-Attrition.csv")
             console.print(
@@ -275,7 +256,7 @@ def _show_completion_message(example_type: str, created: list[str]):
 
 
 @app.callback(invoke_without_command=True)
-def main(ctx: typer.Context):
+def main(ctx: typer.Context) -> None:
     """Create example applications and learn FastAgent patterns."""
     if ctx.invoked_subcommand is None:
         show_overview()

mcp_agent/cli/commands/config.py

@@ -1,11 +1,11 @@
+from typing import NoReturn
+
 import typer
 
 app = typer.Typer()
 
 
 @app.command()
-def show():
+def show() -> NoReturn:
     """Show the configuration."""
-    raise NotImplementedError(
-        "The show configuration command has not been implemented yet"
-    )
+    raise NotImplementedError("The show configuration command has not been implemented yet")

mcp_agent/cli/commands/setup.py

@@ -1,7 +1,8 @@
 from pathlib import Path
+
 import typer
-from rich.prompt import Confirm
 from rich.console import Console
+from rich.prompt import Confirm
 
 app = typer.Typer()
 console = Console()
@@ -166,10 +167,8 @@ def init(
         "-c",
         help="Directory where configuration files will be created",
     ),
-    force: bool = typer.Option(
-        False, "--force", "-f", help="Force overwrite existing files"
-    ),
-):
+    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite existing files"),
+) -> None:
     """Initialize a new FastAgent project with configuration files and example agent."""
 
     config_path = Path(config_dir).resolve()
@@ -198,23 +197,17 @@ def init(
 
     # Create configuration files
     created = []
-    if create_file(
-        config_path / "fastagent.config.yaml", FASTAGENT_CONFIG_TEMPLATE, force
-    ):
+    if create_file(config_path / "fastagent.config.yaml", FASTAGENT_CONFIG_TEMPLATE, force):
         created.append("fastagent.yaml")
 
-    if create_file(
-        config_path / "fastagent.secrets.yaml", FASTAGENT_SECRETS_TEMPLATE, force
-    ):
+    if create_file(config_path / "fastagent.secrets.yaml", FASTAGENT_SECRETS_TEMPLATE, force):
         created.append("fastagent.secrets.yaml")
 
     if create_file(config_path / "agent.py", AGENT_EXAMPLE_TEMPLATE, force):
         created.append("agent.py")
 
     # Only create .gitignore if none exists in parent directories
-    if needs_gitignore and create_file(
-        config_path / ".gitignore", GITIGNORE_TEMPLATE, force
-    ):
+    if needs_gitignore and create_file(config_path / ".gitignore", GITIGNORE_TEMPLATE, force):
         created.append(".gitignore")
 
     if created:

mcp_agent/cli/main.py

@@ -3,11 +3,12 @@
 import typer
 from rich.console import Console
 from rich.table import Table
+
+from mcp_agent.cli.commands import bootstrap, setup
 from mcp_agent.cli.terminal import Application
-from mcp_agent.cli.commands import setup, bootstrap
 
 app = typer.Typer(
-    help="MCP Agent CLI - Build effective agents using Model Context Protocol",
+    help="FastAgent CLI - Build effective agents using Model Context Protocol",
     add_completion=False,  # We'll add this later when we have more commands
 )
 
@@ -20,7 +21,7 @@ application = Application()
 console = Console()
 
 
-def show_welcome():
+def show_welcome() -> None:
     """Show a welcome message with available commands."""
     from importlib.metadata import version
 
@@ -38,9 +39,7 @@ def show_welcome():
     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("bootstrap", "Create example applications (workflow, researcher, etc.)")
     # table.add_row("config", "Manage agent configuration settings")
 
     console.print(table)
@@ -62,10 +61,8 @@ def main(
     ctx: typer.Context,
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose mode"),
     quiet: bool = typer.Option(False, "--quiet", "-q", help="Disable output"),
-    color: bool = typer.Option(
-        True, "--color/--no-color", help="Enable/disable color output"
-    ),
-):
+    color: bool = typer.Option(True, "--color/--no-color", help="Enable/disable color output"),
+) -> None:
     """FastAgent CLI - Build effective agents using Model Context Protocol (MCP).
 
     Use --help with any command for detailed usage information.

mcp_agent/cli/terminal.py

@@ -2,7 +2,7 @@ from mcp_agent.console import console, error_console
 
 
 class Application:
-    def __init__(self, verbosity: int = 0, enable_color: bool = True):
+    def __init__(self, verbosity: int = 0, enable_color: bool = True) -> None:
         self.verbosity = verbosity
         # Use the central console instances, respecting color setting
         if not enable_color:
@@ -13,8 +13,8 @@ class Application:
             self.console = console
             self.error_console = error_console
 
-    def log(self, message: str, level: str = "info"):
-        if level == "info" or (level == "debug" and self.verbosity > 0):
+    def log(self, message: str, level: str = "info") -> None:
+        if (level == "info" or (level == "debug" and self.verbosity > 0) or level ==  "error"):
             if level == "error":
                 self.error_console.print(f"[{level.upper()}] {message}")
             else:

mcp_agent/config.py

@@ -100,31 +100,36 @@ class MCPSettings(BaseModel):
 
 class AnthropicSettings(BaseModel):
     """
-    Settings for using Anthropic models in the MCP Agent application.
+    Settings for using Anthropic models in the fast-agent application.
     """
 
     api_key: str | None = None
 
+    base_url: str | None = None
+
     model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
 
 
-class CohereSettings(BaseModel):
+class OpenAISettings(BaseModel):
     """
-    Settings for using Cohere models in the MCP Agent application.
+    Settings for using OpenAI models in the fast-agent application.
     """
 
     api_key: str | None = None
+    reasoning_effort: Literal["low", "medium", "high"] = "medium"
+
+    base_url: str | None = None
 
     model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
 
 
-class OpenAISettings(BaseModel):
+class DeepSeekSettings(BaseModel):
     """
-    Settings for using OpenAI models in the MCP Agent application.
+    Settings for using OpenAI models in the fast-agent application.
     """
 
     api_key: str | None = None
-    reasoning_effort: Literal["low", "medium", "high"] = "medium"
+    # reasoning_effort: Literal["low", "medium", "high"] = "medium"
 
     base_url: str | None = None
 
@@ -133,7 +138,7 @@ class OpenAISettings(BaseModel):
 
 class TemporalSettings(BaseModel):
     """
-    Temporal settings for the MCP Agent application.
+    Temporal settings for the fast-agent application.
     """
 
     host: str
@@ -142,27 +147,14 @@ class TemporalSettings(BaseModel):
     api_key: str | None = None
 
 
-class UsageTelemetrySettings(BaseModel):
-    """
-    Settings for usage telemetry in the MCP Agent application.
-    Anonymized usage metrics are sent to a telemetry server to help improve the product.
-    """
-
-    enabled: bool = True
-    """Enable usage telemetry in the MCP Agent application."""
-
-    enable_detailed_telemetry: bool = False
-    """If enabled, detailed telemetry data, including prompts and agents, will be sent to the telemetry server."""
-
-
 class OpenTelemetrySettings(BaseModel):
     """
-    OTEL settings for the MCP Agent application.
+    OTEL settings for the fast-agent application.
     """
 
     enabled: bool = True
 
-    service_name: str = "mcp-agent"
+    service_name: str = "fast-agent"
     service_instance_id: str | None = None
     service_version: str | None = None
 
@@ -178,7 +170,7 @@ class OpenTelemetrySettings(BaseModel):
 
 class LoggerSettings(BaseModel):
     """
-    Logger settings for the MCP Agent application.
+    Logger settings for the fast-agent application.
     """
 
     type: Literal["none", "console", "file", "http"] = "file"
@@ -221,7 +213,7 @@ class LoggerSettings(BaseModel):
 
 class Settings(BaseSettings):
     """
-    Settings class for the MCP Agent application.
+    Settings class for the fast-agent application.
     """
 
     model_config = SettingsConfigDict(
@@ -236,7 +228,7 @@ class Settings(BaseSettings):
     """MCP config, such as MCP servers"""
 
     execution_engine: Literal["asyncio", "temporal"] = "asyncio"
-    """Execution engine for the MCP Agent application"""
+    """Execution engine for the fast-agent application"""
 
     default_model: str | None = "haiku"
     """
@@ -247,22 +239,19 @@ class Settings(BaseSettings):
     """Settings for Temporal workflow orchestration"""
 
     anthropic: AnthropicSettings | None = None
-    """Settings for using Anthropic models in the MCP Agent application"""
+    """Settings for using Anthropic models in the fast-agent application"""
 
-    cohere: CohereSettings | None = None
-    """Settings for using Cohere models in the MCP Agent application"""
+    otel: OpenTelemetrySettings | None = OpenTelemetrySettings()
+    """OpenTelemetry logging settings for the fast-agent application"""
 
     openai: OpenAISettings | None = None
-    """Settings for using OpenAI models in the MCP Agent application"""
+    """Settings for using OpenAI models in the fast-agent application"""
 
-    otel: OpenTelemetrySettings | None = OpenTelemetrySettings()
-    """OpenTelemetry logging settings for the MCP Agent application"""
+    deepseek: DeepSeekSettings | None = None
+    """Settings for using DeepSeek models in the fast-agent application"""
 
     logger: LoggerSettings | None = LoggerSettings()
-    """Logger settings for the MCP Agent application"""
-
-    usage_telemetry: UsageTelemetrySettings | None = UsageTelemetrySettings()
-    """Usage tracking settings for the MCP Agent application"""
+    """Logger settings for the fast-agent application"""
 
     @classmethod
     def find_config(cls) -> Path | None:
@@ -295,11 +284,7 @@ def get_settings(config_path: str | None = None) -> Settings:
         """Recursively merge two dictionaries, preserving nested structures."""
         merged = base.copy()
         for key, value in update.items():
-            if (
-                key in merged
-                and isinstance(merged[key], dict)
-                and isinstance(value, dict)
-            ):
+            if key in merged and isinstance(merged[key], dict) and isinstance(value, dict):
                 merged[key] = deep_merge(merged[key], value)
             else:
                 merged[key] = value

mcp_agent/context.py

@@ -4,40 +4,33 @@ A central context object to store global state that is shared across the applica
 
 import asyncio
 import concurrent.futures
-from typing import Any, Optional, Union, TYPE_CHECKING
-
-from pydantic import BaseModel, ConfigDict
+from typing import TYPE_CHECKING, Any, Optional, Union
 
 from mcp import ServerSession
-
 from opentelemetry import trace
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
 from opentelemetry.propagate import set_global_textmap
 from opentelemetry.sdk.resources import Resource
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import BatchSpanProcessor, ConsoleSpanExporter
 from opentelemetry.trace.propagation.tracecontext import TraceContextTextMapPropagator
-from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+from pydantic import BaseModel, ConfigDict
 
-from mcp_agent.config import get_settings
-from mcp_agent.config import Settings
-from mcp_agent.executor.executor import Executor
+from mcp_agent.config import Settings, get_settings
 from mcp_agent.executor.decorator_registry import (
     DecoratorRegistry,
     register_asyncio_decorators,
 )
+from mcp_agent.executor.executor import AsyncioExecutor, Executor
 from mcp_agent.executor.task_registry import ActivityRegistry
-from mcp_agent.executor.executor import AsyncioExecutor
-
 from mcp_agent.logging.events import EventFilter
-from mcp_agent.logging.logger import LoggingConfig
+from mcp_agent.logging.logger import LoggingConfig, get_logger
 from mcp_agent.logging.transport import create_transport
 from mcp_agent.mcp_server_registry import ServerRegistry
-from mcp_agent.logging.logger import get_logger
-
 
 if TYPE_CHECKING:
-    from mcp_agent.human_input.types import HumanInputCallback
     from mcp_agent.executor.workflow_signal import SignalWaitCallback
+    from mcp_agent.human_input.types import HumanInputCallback
 else:
     # Runtime placeholders for the types
     HumanInputCallback = Any
@@ -71,7 +64,7 @@ class Context(BaseModel):
     )
 
 
-async def configure_otel(config: "Settings"):
+async def configure_otel(config: "Settings") -> None:
     """
     Configure OpenTelemetry based on the application config.
     """
@@ -112,9 +105,7 @@ async def configure_otel(config: "Settings"):
         tracer_provider.add_span_processor(BatchSpanProcessor(exporter))
 
         if config.otel.console_debug:
-            tracer_provider.add_span_processor(
-                BatchSpanProcessor(ConsoleSpanExporter())
-            )
+            tracer_provider.add_span_processor(BatchSpanProcessor(ConsoleSpanExporter()))
     else:
         # Default to console exporter in development
         tracer_provider.add_span_processor(BatchSpanProcessor(ConsoleSpanExporter()))
@@ -123,7 +114,7 @@ async def configure_otel(config: "Settings"):
     trace.set_tracer_provider(tracer_provider)
 
 
-async def configure_logger(config: "Settings"):
+async def configure_logger(config: "Settings") -> None:
     """
     Configure logging and tracing based on the application config.
     """
@@ -139,7 +130,7 @@ async def configure_logger(config: "Settings"):
     )
 
 
-async def configure_usage_telemetry(_config: "Settings"):
+async def configure_usage_telemetry(_config: "Settings") -> None:
     """
     Configure usage telemetry based on the application config.
     TODO: saqadri - implement usage tracking
@@ -202,7 +193,7 @@ async def initialize_context(
     return context
 
 
-async def cleanup_context():
+async def cleanup_context() -> None:
     """
     Cleanup the global application context.
     """

mcp_agent/context_dependent.py

@@ -1,6 +1,5 @@
 from contextlib import contextmanager
-from typing import Optional, TYPE_CHECKING
-
+from typing import TYPE_CHECKING, Any, Optional
 
 if TYPE_CHECKING:
     from mcp_agent.context import Context
@@ -12,7 +11,7 @@ class ContextDependent:
     Provides both global fallback and instance-specific context support.
     """
 
-    def __init__(self, context: Optional["Context"] = None, **kwargs):
+    def __init__(self, context: Optional["Context"] = None, **kwargs: dict[str, Any]) -> None:
         self._context = context
         super().__init__(**kwargs)
 
@@ -33,8 +32,7 @@ class ContextDependent:
             return get_current_context()
         except Exception as e:
             raise RuntimeError(
-                f"No context available for {self.__class__.__name__}. "
-                "Either initialize MCPApp first or pass context explicitly."
+                f"No context available for {self.__class__.__name__}. Either initialize MCPApp first or pass context explicitly."
             ) from e
 
     @contextmanager

mcp_agent/core/agent_types.py

@@ -2,9 +2,10 @@
 Type definitions for agents and agent configurations.
 """
 
+import dataclasses
 from dataclasses import dataclass
 from enum import Enum
-from typing import Callable, Dict, List, Optional, Union
+from typing import List
 
 # Forward imports to avoid circular dependencies
 from mcp_agent.core.request_params import RequestParams
@@ -26,18 +27,20 @@ class AgentConfig:
     """Configuration for an Agent instance"""
 
     name: str
-    instruction: Union[str, Callable[[Dict], str]]
-    servers: List[str]
-    model: Optional[str] = None
+    instruction: str = "You are a helpful agent."
+    servers: List[str] = dataclasses.field(default_factory=list)
+    model: str | None = None
     use_history: bool = True
-    default_request_params: Optional[RequestParams] = None
+    default_request_params: RequestParams | None = None
     human_input: bool = False
 
-    def __post_init__(self):
+    def __post_init__(self) -> None:
         """Ensure default_request_params exists with proper history setting"""
 
         if self.default_request_params is None:
-            self.default_request_params = RequestParams(use_history=self.use_history)
+            self.default_request_params = RequestParams(
+                use_history=self.use_history, systemPrompt=self.instruction
+            )
         else:
             # Override the request params history setting if explicitly configured
             self.default_request_params.use_history = self.use_history