fast-agent-mcp 0.1.10__tar.gz → 0.1.12__tar.gz

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.1.10
+Version: 0.1.12
 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
@@ -212,7 +212,7 @@ Requires-Python: >=3.10
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.49.0
 Requires-Dist: fastapi>=0.115.6
-Requires-Dist: mcp>=1.4.1
+Requires-Dist: mcp>=1.5.0
 Requires-Dist: numpy>=2.2.1
 Requires-Dist: openai>=1.63.2
 Requires-Dist: opentelemetry-distro>=0.50b0
@@ -241,10 +241,9 @@ Provides-Extra: temporal
 Requires-Dist: temporalio>=1.8.0; extra == 'temporal'
 Description-Content-Type: text/markdown
 
-## fast-agent
-
 <p align="center">
 <a href="https://pypi.org/project/fast-agent-mcp/"><img src="https://img.shields.io/pypi/v/fast-agent-mcp?color=%2334D058&label=pypi" /></a>
+<a href="#"><img src="https://github.com/evalstate/fast-agent/actions/workflows/main-checks.yml/badge.svg" /></a>
 <a href="https://github.com/evalstate/fast-agent/issues"><img src="https://img.shields.io/github/issues-raw/evalstate/fast-agent" /></a>
 <a href="https://lmai.link/discord/mcp-agent"><img src="https://shields.io/discord/1089284610329952357" alt="discord" /></a>
 <img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/fast-agent-mcp?label=pypi%20%7C%20downloads"/>
@@ -253,16 +252,14 @@ Description-Content-Type: text/markdown
 
 ## Overview
 
-**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes.
+**`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.
 
 The simple declarative syntax lets you concentrate on composing your Prompts and MCP Servers to [build effective agents](https://www.anthropic.com/research/building-effective-agents).
 
-Evaluate how different models handle Agent and MCP Server calling tasks, then build multi-model workflows using the best provider for each task.
-
-`fast-agent` is now multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints (for supported models), via Prompts, Resources and MCP Tool Call results.
+`fast-agent` is multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints via Prompts, Resources and MCP Tool Call results. The inclusion of passthrough and playback LLMs enable rapid development and test of Python glue-code for your applications.
 
 > [!TIP]
-> `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site.
+> `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site and Further MCP Examples.
 
 ### Agent Application Development
 
@@ -272,7 +269,7 @@ Chat with individual Agents and Components before, during and after workflow exe
 
 Simple model selection makes testing Model <-> MCP Server interaction painless. You can read more about the motivation behind this project [here](https://llmindset.co.uk/resources/fast-agent/)
 
-![fast-agent](https://github.com/user-attachments/assets/3e692103-bf97-489a-b519-2d0fee036369)
+![2025-03-23-fast-agent](https://github.com/user-attachments/assets/8f6dbb69-43e3-4633-8e12-5572e9614728)
 
 ## Get started:
 
@@ -597,6 +594,14 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
 
 Add Resources to prompts using either the inbuilt `prompt-server` or MCP Types directly. Convenience class are made available to do so simply, for example:
 
+```python
+  summary: str =  await agent.with_resource(
+      "Summarise this PDF please",
+      "mcp_server",
+      "resource://fast-agent/sample.pdf",
+  )
+```
+
 #### MCP Tool Result Conversion
 
 LLM APIs have restrictions on the content types that can be returned as Tool Calls/Function results via their Chat Completions API's:
@@ -612,40 +617,33 @@ MCP Prompts are supported with `apply_prompt(name,arguments)`, which always retu
 
 Prompts can also be applied interactively through the interactive interface by using the `/prompt` command.
 
+### Sampling
+
+Sampling LLMs are configured per Client/Server pair. Specify the model name in fastagent.config.yaml as follows:
+
+```yaml
+mcp:
+  servers:
+    sampling_resource:
+      command: "uv"
+      args: ["run", "sampling_resource_server.py"]
+      sampling:
+        model: "haiku"
+```
+
 ### Secrets File
 
 > [!TIP]
 > fast-agent will look recursively for a fastagent.secrets.yaml file, so you only need to manage this at the root folder of your agent definitions.
 
+### Interactive Shell
+
+![fast-agent](https://github.com/user-attachments/assets/3e692103-bf97-489a-b519-2d0fee036369)
+
 ## Project Notes
 
 `fast-agent` builds on the [`mcp-agent`](https://github.com/lastmile-ai/mcp-agent) project by Sarmad Qadri.
 
-### llmindset.co.uk fork:
-
-- Addition of MCP Prompts including Prompt Server and agent save/replay ability.
-- Overhaul of Eval/Opt for Conversation Management
-- Removed instructor/double-llm calling - native structured outputs for OAI.
-- Improved handling of Parallel/Fan-In and respose option
-- XML based generated prompts
-- "FastAgent" style prototyping, with per-agent models
-- API keys through Environment Variables
-- Warm-up / Post-Workflow Agent Interactions
-- Quick Setup
-- Interactive Prompt Mode
-- Simple Model Selection with aliases
-- User/Assistant and Tool Call message display
-- MCP Sever Environment Variable support
-- MCP Roots support
-- Comprehensive Progress display
-- JSONL file logging with secret revokation
-- OpenAI o1/o3-mini support with reasoning level
-- Enhanced Human Input Messaging and Handling
-- Declarative workflows
-- Numerous defect fixes
-
-### Features to add (Commmitted)
-
-- Run Agent as MCP Server, with interop
-- Multi-part content types supporing Vision, PDF and multi-part Text.
-- Improved test automation (supported by prompt_server.py and augmented_llm_playback.py)
+### Contributing
+
+Contributions and PRs are welcome - feel free to raise issues to discuss. Full guidelines for contributing and roadmap coming very soon. Get in touch!

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/README.md

@@ -1,7 +1,6 @@
-## fast-agent
-
 <p align="center">
 <a href="https://pypi.org/project/fast-agent-mcp/"><img src="https://img.shields.io/pypi/v/fast-agent-mcp?color=%2334D058&label=pypi" /></a>
+<a href="#"><img src="https://github.com/evalstate/fast-agent/actions/workflows/main-checks.yml/badge.svg" /></a>
 <a href="https://github.com/evalstate/fast-agent/issues"><img src="https://img.shields.io/github/issues-raw/evalstate/fast-agent" /></a>
 <a href="https://lmai.link/discord/mcp-agent"><img src="https://shields.io/discord/1089284610329952357" alt="discord" /></a>
 <img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/fast-agent-mcp?label=pypi%20%7C%20downloads"/>
@@ -10,16 +9,14 @@
 
 ## Overview
 
-**`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes.
+**`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.
 
 The simple declarative syntax lets you concentrate on composing your Prompts and MCP Servers to [build effective agents](https://www.anthropic.com/research/building-effective-agents).
 
-Evaluate how different models handle Agent and MCP Server calling tasks, then build multi-model workflows using the best provider for each task.
-
-`fast-agent` is now multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints (for supported models), via Prompts, Resources and MCP Tool Call results.
+`fast-agent` is multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints via Prompts, Resources and MCP Tool Call results. The inclusion of passthrough and playback LLMs enable rapid development and test of Python glue-code for your applications.
 
 > [!TIP]
-> `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site.
+> `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site and Further MCP Examples.
 
 ### Agent Application Development
 
@@ -29,7 +26,7 @@ Chat with individual Agents and Components before, during and after workflow exe
 
 Simple model selection makes testing Model <-> MCP Server interaction painless. You can read more about the motivation behind this project [here](https://llmindset.co.uk/resources/fast-agent/)
 
-![fast-agent](https://github.com/user-attachments/assets/3e692103-bf97-489a-b519-2d0fee036369)
+![2025-03-23-fast-agent](https://github.com/user-attachments/assets/8f6dbb69-43e3-4633-8e12-5572e9614728)
 
 ## Get started:
 
@@ -354,6 +351,14 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
 
 Add Resources to prompts using either the inbuilt `prompt-server` or MCP Types directly. Convenience class are made available to do so simply, for example:
 
+```python
+  summary: str =  await agent.with_resource(
+      "Summarise this PDF please",
+      "mcp_server",
+      "resource://fast-agent/sample.pdf",
+  )
+```
+
 #### MCP Tool Result Conversion
 
 LLM APIs have restrictions on the content types that can be returned as Tool Calls/Function results via their Chat Completions API's:
@@ -369,40 +374,33 @@ MCP Prompts are supported with `apply_prompt(name,arguments)`, which always retu
 
 Prompts can also be applied interactively through the interactive interface by using the `/prompt` command.
 
+### Sampling
+
+Sampling LLMs are configured per Client/Server pair. Specify the model name in fastagent.config.yaml as follows:
+
+```yaml
+mcp:
+  servers:
+    sampling_resource:
+      command: "uv"
+      args: ["run", "sampling_resource_server.py"]
+      sampling:
+        model: "haiku"
+```
+
 ### Secrets File
 
 > [!TIP]
 > fast-agent will look recursively for a fastagent.secrets.yaml file, so you only need to manage this at the root folder of your agent definitions.
 
+### Interactive Shell
+
+![fast-agent](https://github.com/user-attachments/assets/3e692103-bf97-489a-b519-2d0fee036369)
+
 ## Project Notes
 
 `fast-agent` builds on the [`mcp-agent`](https://github.com/lastmile-ai/mcp-agent) project by Sarmad Qadri.
 
-### llmindset.co.uk fork:
-
-- Addition of MCP Prompts including Prompt Server and agent save/replay ability.
-- Overhaul of Eval/Opt for Conversation Management
-- Removed instructor/double-llm calling - native structured outputs for OAI.
-- Improved handling of Parallel/Fan-In and respose option
-- XML based generated prompts
-- "FastAgent" style prototyping, with per-agent models
-- API keys through Environment Variables
-- Warm-up / Post-Workflow Agent Interactions
-- Quick Setup
-- Interactive Prompt Mode
-- Simple Model Selection with aliases
-- User/Assistant and Tool Call message display
-- MCP Sever Environment Variable support
-- MCP Roots support
-- Comprehensive Progress display
-- JSONL file logging with secret revokation
-- OpenAI o1/o3-mini support with reasoning level
-- Enhanced Human Input Messaging and Handling
-- Declarative workflows
-- Numerous defect fixes
-
-### Features to add (Commmitted)
-
-- Run Agent as MCP Server, with interop
-- Multi-part content types supporing Vision, PDF and multi-part Text.
-- Improved test automation (supported by prompt_server.py and augmented_llm_playback.py)
+### Contributing
+
+Contributions and PRs are welcome - feel free to raise issues to discuss. Full guidelines for contributing and roadmap coming very soon. Get in touch!

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.1.10"
+version = "0.1.12"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -16,7 +16,7 @@ classifiers = [
 requires-python = ">=3.10"
 dependencies = [
     "fastapi>=0.115.6",
-    "mcp>=1.4.1",
+    "mcp>=1.5.0",
     "opentelemetry-distro>=0.50b0",
     "opentelemetry-exporter-otlp-proto-http>=1.29.0",
     "pydantic-settings>=2.7.0",

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/agents/agent.py

@@ -1,6 +1,5 @@
 import asyncio
 import uuid
-from dataclasses import dataclass
 from typing import Callable, Dict, List, Optional, TypeVar, Union, TYPE_CHECKING
 
 from mcp.server.fastmcp.tools import Tool as FastTool
@@ -16,7 +15,7 @@ from mcp_agent.mcp.prompt_message_multipart import PromptMessageMultipart
 
 from mcp_agent.core.exceptions import PromptExitError
 from mcp_agent.mcp.mcp_aggregator import MCPAggregator
-from mcp_agent.workflows.llm.augmented_llm import RequestParams
+from mcp_agent.core.agent_types import AgentConfig
 from mcp_agent.human_input.types import (
     HumanInputCallback,
     HumanInputRequest,
@@ -38,28 +37,6 @@ LLM = TypeVar("LLM", bound=AugmentedLLM)
 HUMAN_INPUT_TOOL_NAME = "__human_input__"
 
 
-@dataclass
-class AgentConfig:
-    """Configuration for an Agent instance"""
-
-    name: str
-    instruction: Union[str, Callable[[Dict], str]]
-    servers: List[str]
-    model: Optional[str] = None
-    use_history: bool = True
-    default_request_params: Optional[RequestParams] = None
-    human_input: bool = False
-
-    def __post_init__(self):
-        """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)
-        else:
-            # Override the request params history setting if explicitly configured
-            self.default_request_params.use_history = self.use_history
-
-
 class Agent(MCPAggregator):
     """
     An Agent is an entity that has access to a set of MCP servers and can interact with them.

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/app.py

@@ -11,7 +11,6 @@ from mcp_agent.logging.logger import get_logger
 from mcp_agent.executor.workflow_signal import SignalWaitCallback
 from mcp_agent.human_input.types import HumanInputCallback
 from mcp_agent.human_input.handler import console_input_callback
-from mcp_agent.workflows.llm.llm_selector import ModelSelector
 
 R = TypeVar("R")
 
@@ -44,7 +43,6 @@ class MCPApp:
         human_input_callback: Optional[HumanInputCallback] = console_input_callback,
         signal_notification: Optional[SignalWaitCallback] = None,
         upstream_session: Optional["ServerSession"] = None,
-        model_selector: ModelSelector = None,
     ):
         """
         Initialize the application with a name and optional settings.
@@ -55,7 +53,6 @@ class MCPApp:
             human_input_callback: Callback for handling human input
             signal_notification: Callback for getting notified on workflow signals/events.
             upstream_session: Optional upstream session if the MCPApp is running as a server to an MCP client.
-            initialize_model_selector: Initializes the built-in ModelSelector to help with model selection. Defaults to False.
         """
         self.name = name
 
@@ -64,7 +61,6 @@ class MCPApp:
         self._human_input_callback = human_input_callback
         self._signal_notification = signal_notification
         self._upstream_session = upstream_session
-        self._model_selector = model_selector
 
         self._workflows: Dict[str, Type] = {}  # id to workflow class
         self._logger = None
@@ -128,7 +124,6 @@ class MCPApp:
         self._context.human_input_handler = self._human_input_callback
         self._context.signal_notification = self._signal_notification
         self._context.upstream_session = self._upstream_session
-        self._context.model_selector = self._model_selector
 
         self._initialized = True
         self.logger.info(

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/config.py

@@ -18,6 +18,12 @@ class MCPServerAuthSettings(BaseModel):
     model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
 
 
+class MCPSamplingSettings(BaseModel):
+    model: str = "haiku"
+
+    model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
+
+
 class MCPRootSettings(BaseModel):
     """Represents a root directory configuration for an MCP server."""
 
@@ -81,6 +87,9 @@ class MCPServerSettings(BaseModel):
     env: Dict[str, str] | None = None
     """Environment variables to pass to the server process."""
 
+    sampling: MCPSamplingSettings | None = None
+    """Sampling settings for this Client/Server pair"""
+
 
 class MCPSettings(BaseModel):
     """Configuration for all MCP servers."""

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/context.py

@@ -32,7 +32,6 @@ from mcp_agent.logging.events import EventFilter
 from mcp_agent.logging.logger import LoggingConfig
 from mcp_agent.logging.transport import create_transport
 from mcp_agent.mcp_server_registry import ServerRegistry
-from mcp_agent.workflows.llm.llm_selector import ModelSelector
 from mcp_agent.logging.logger import get_logger
 
 
@@ -58,7 +57,6 @@ class Context(BaseModel):
     human_input_handler: Optional[HumanInputCallback] = None
     signal_notification: Optional[SignalWaitCallback] = None
     upstream_session: Optional[ServerSession] = None  # TODO: saqadri - figure this out
-    model_selector: Optional[ModelSelector] = None
 
     # Registries
     server_registry: Optional[ServerRegistry] = None

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/core/agent_app.py

@@ -113,6 +113,35 @@ class AgentApp:
         proxy = self._agents[target]
         return await proxy.apply_prompt(prompt_name, arguments)
 
+    async def with_resource(
+        self,
+        prompt_content: Union[str, PromptMessageMultipart],
+        server_name: str,
+        resource_name: str,
+        agent_name: Optional[str] = None,
+    ) -> str:
+        """
+        Create a prompt with the given content and resource, then send it to the agent.
+
+        Args:
+            prompt_content: Either a string message or an existing PromptMessageMultipart
+            server_name: Name of the MCP server to retrieve the resource from
+            resource_name: Name or URI of the resource to retrieve
+            agent_name: The name of the agent to use (uses default if None)
+
+        Returns:
+            The agent's response as a string
+        """
+        target = agent_name or self._default
+        if not target:
+            raise ValueError("No default agent available")
+
+        if target not in self._agents:
+            raise ValueError(f"No agent named '{target}'")
+
+        proxy = self._agents[target]
+        return await proxy.with_resource(prompt_content, server_name, resource_name)
+
     async def prompt(self, agent_name: Optional[str] = None, default: str = "") -> str:
         """
         Interactive prompt for sending messages with advanced features.

fast_agent_mcp-0.1.12/src/mcp_agent/core/agent_types.py

@@ -0,0 +1,43 @@
+"""
+Type definitions for agents and agent configurations.
+"""
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import Callable, Dict, List, Optional, Union
+
+# Forward imports to avoid circular dependencies
+from mcp_agent.core.request_params import RequestParams
+
+
+class AgentType(Enum):
+    """Enumeration of supported agent types."""
+
+    BASIC = "agent"
+    ORCHESTRATOR = "orchestrator"
+    PARALLEL = "parallel"
+    EVALUATOR_OPTIMIZER = "evaluator_optimizer"
+    ROUTER = "router"
+    CHAIN = "chain"
+
+
+@dataclass
+class AgentConfig:
+    """Configuration for an Agent instance"""
+
+    name: str
+    instruction: Union[str, Callable[[Dict], str]]
+    servers: List[str]
+    model: Optional[str] = None
+    use_history: bool = True
+    default_request_params: Optional[RequestParams] = None
+    human_input: bool = False
+
+    def __post_init__(self):
+        """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)
+        else:
+            # Override the request params history setting if explicitly configured
+            self.default_request_params.use_history = self.use_history

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/core/decorators.py

@@ -4,9 +4,8 @@ Contains decorator definitions extracted from fastagent.py.
 """
 
 from typing import Callable, Dict, List, Optional, TypeVar, Literal
-from mcp_agent.agents.agent import AgentConfig
+from mcp_agent.core.agent_types import AgentConfig, AgentType
 from mcp_agent.workflows.llm.augmented_llm import RequestParams
-from mcp_agent.core.agent_types import AgentType
 
 T = TypeVar("T")  # For the wrapper classes
 

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/core/error_handling.py

@@ -20,4 +20,4 @@ def handle_error(e: Exception, error_type: str, suggestion: str = None) -> None:
         print("\nDetails:")
         print(e.details)
     if suggestion:
-        print(f"\n{suggestion}")
+        print(f"\n{suggestion}")

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/core/factory.py

@@ -5,7 +5,8 @@ Factory functions for creating agent and workflow instances.
 from typing import Dict, Any, Optional, TypeVar, Callable
 
 from mcp_agent.app import MCPApp
-from mcp_agent.agents.agent import Agent, AgentConfig
+from mcp_agent.agents.agent import Agent
+from mcp_agent.core.agent_types import AgentConfig, AgentType
 from mcp_agent.event_progress import ProgressAction
 from mcp_agent.workflows.evaluator_optimizer.evaluator_optimizer import (
     EvaluatorOptimizerLLM,
@@ -16,8 +17,6 @@ from mcp_agent.workflows.llm.model_factory import ModelFactory
 from mcp_agent.workflows.orchestrator.orchestrator import Orchestrator
 from mcp_agent.workflows.parallel.parallel_llm import ParallelLLM
 from mcp_agent.workflows.router.router_llm import LLMRouter
-
-from mcp_agent.core.agent_types import AgentType
 from mcp_agent.core.exceptions import AgentConfigError
 from mcp_agent.core.proxies import (
     BaseAgentProxy,

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/core/mcp_content.py

@@ -146,7 +146,6 @@ def MCPFile(
     }
 
 
-
 def MCPPrompt(
     *content_items, role: Literal["user", "assistant"] = "user"
 ) -> List[dict]:
@@ -154,7 +153,7 @@ def MCPPrompt(
     Create one or more prompt messages with various content types.
 
     This function intelligently creates different content types:
-    - Strings become TextContent 
+    - Strings become TextContent
     - File paths with image mime types become ImageContent
     - File paths with text mime types or other mime types become EmbeddedResource
     - Dicts with role and content are passed through unchanged
@@ -180,7 +179,7 @@ def MCPPrompt(
             # File path - determine the content type based on mime type
             path_str = str(item)
             mime_type = guess_mime_type(path_str)
-            
+
             if is_image_mime_type(mime_type):
                 # Image files (except SVG which is handled as text)
                 result.append(MCPImage(path=item, role=role))

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/core/proxies.py

@@ -1,6 +1,9 @@
 """
 Proxy classes for agent interactions.
 These proxies provide a consistent interface for interacting with different types of agents.
+
+FOR COMPATIBILITY WITH LEGACY MCP-AGENT CODE
+
 """
 
 from typing import List, Optional, Dict, Union, TYPE_CHECKING

fast_agent_mcp-0.1.12/src/mcp_agent/core/request_params.py

@@ -0,0 +1,43 @@
+"""
+Request parameters definitions for LLM interactions.
+"""
+
+from pydantic import Field
+from mcp.types import CreateMessageRequestParams
+
+
+class RequestParams(CreateMessageRequestParams):
+    """
+    Parameters to configure the AugmentedLLM 'generate' requests.
+    """
+
+    messages: None = Field(exclude=True, default=None)
+    """
+    Ignored. 'messages' are removed from CreateMessageRequestParams 
+    to avoid confusion with the 'message' parameter on 'generate' method.
+    """
+
+    maxTokens: int = 2048
+    """The maximum number of tokens to sample, as requested by the server."""
+
+    model: str | None = None
+    """
+    The model to use for the LLM generation.
+    If specified, this overrides the 'modelPreferences' selection criteria.
+    """
+
+    use_history: bool = True
+    """
+    Include the message history in the generate request.
+    """
+
+    max_iterations: int = 10
+    """
+    The maximum number of iterations to run the LLM for.
+    """
+
+    parallel_tool_calls: bool = True
+    """
+    Whether to allow multiple tool calls per iteration.
+    Also known as multi-step tool use.
+    """

{fast_agent_mcp-0.1.10 → fast_agent_mcp-0.1.12}/src/mcp_agent/core/types.py

@@ -7,7 +7,9 @@ from typing import Dict, Union, TypeAlias, TYPE_CHECKING
 from mcp_agent.agents.agent import Agent
 from mcp_agent.workflows.orchestrator.orchestrator import Orchestrator
 from mcp_agent.workflows.parallel.parallel_llm import ParallelLLM
-from mcp_agent.workflows.evaluator_optimizer.evaluator_optimizer import EvaluatorOptimizerLLM
+from mcp_agent.workflows.evaluator_optimizer.evaluator_optimizer import (
+    EvaluatorOptimizerLLM,
+)
 from mcp_agent.workflows.router.router_llm import LLMRouter
 
 # Avoid circular imports
@@ -19,4 +21,4 @@ WorkflowType: TypeAlias = Union[
     Orchestrator, ParallelLLM, EvaluatorOptimizerLLM, LLMRouter
 ]
 AgentOrWorkflow: TypeAlias = Union[Agent, WorkflowType]
-ProxyDict: TypeAlias = Dict[str, "BaseAgentProxy"]  # Forward reference as string
+ProxyDict: TypeAlias = Dict[str, "BaseAgentProxy"]  # Forward reference as string