fast-agent-mcp 0.2.16__py3-none-any.whl → 0.2.18__py3-none-any.whl

mcp_agent/config.py

@@ -139,40 +139,42 @@ class DeepSeekSettings(BaseModel):
     model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
 
 
-class GenericSettings(BaseModel):
+class GoogleSettings(BaseModel):
     """
     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 OpenRouterSettings(BaseModel):
+class GenericSettings(BaseModel):
     """
-    Settings for using OpenRouter models via its OpenAI-compatible API.
+    Settings for using OpenAI models in the fast-agent application.
     """
 
     api_key: str | None = None
 
-    base_url: str | None = None  # Optional override, defaults handled in provider
+    base_url: str | None = None
 
     model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
 
 
-class TemporalSettings(BaseModel):
+class OpenRouterSettings(BaseModel):
     """
-    Temporal settings for the fast-agent application.
+    Settings for using OpenRouter models via its OpenAI-compatible API.
     """
 
-    host: str
-    namespace: str = "default"
-    task_queue: str
     api_key: str | None = None
 
+    base_url: str | None = None  # Optional override, defaults handled in provider
+
+    model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
+
 
 class OpenTelemetrySettings(BaseModel):
     """
@@ -254,16 +256,14 @@ class Settings(BaseSettings):
     mcp: MCPSettings | None = MCPSettings()
     """MCP config, such as MCP servers"""
 
-    execution_engine: Literal["asyncio", "temporal"] = "asyncio"
+    execution_engine: Literal["asyncio"] = "asyncio"
     """Execution engine for the fast-agent application"""
 
     default_model: str | None = "haiku"
     """
     Default model for agents. Format is provider.model_name.<reasoning_effort>, for example openai.o3-mini.low
-    Aliases are provided for common models e.g. sonnet, haiku, gpt-4o, o3-mini etc.
+    Aliases are provided for common models e.g. sonnet, haiku, gpt-4.1, o3-mini etc.
     """
-    temporal: TemporalSettings | None = None
-    """Settings for Temporal workflow orchestration"""
 
     anthropic: AnthropicSettings | None = None
     """Settings for using Anthropic models in the fast-agent application"""
@@ -277,6 +277,9 @@ class Settings(BaseSettings):
     deepseek: DeepSeekSettings | None = None
     """Settings for using DeepSeek models in the fast-agent application"""
 
+    google: GoogleSettings | None = None
+    """Settings for using DeepSeek models in the fast-agent application"""
+
     openrouter: OpenRouterSettings | None = None
     """Settings for using OpenRouter models in the fast-agent application"""
 

mcp_agent/context.py

@@ -17,10 +17,6 @@ from opentelemetry.trace.propagation.tracecontext import TraceContextTextMapProp
 from pydantic import BaseModel, ConfigDict
 
 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.logging.events import EventFilter
@@ -54,7 +50,6 @@ class Context(BaseModel):
     # Registries
     server_registry: Optional[ServerRegistry] = None
     task_registry: Optional[ActivityRegistry] = None
-    decorator_registry: Optional[DecoratorRegistry] = None
 
     tracer: Optional[trace.Tracer] = None
 
@@ -142,18 +137,7 @@ async def configure_executor(config: "Settings"):
     """
     Configure the executor based on the application config.
     """
-    if config.execution_engine == "asyncio":
-        return AsyncioExecutor()
-    elif config.execution_engine == "temporal":
-        # Configure Temporal executor
-        from mcp_agent.executor.temporal import TemporalExecutor
-
-        executor = TemporalExecutor(config=config.temporal)
-        return executor
-    else:
-        # Default to asyncio executor
-        executor = AsyncioExecutor()
-        return executor
+    return AsyncioExecutor()
 
 
 async def initialize_context(
@@ -180,11 +164,9 @@ async def initialize_context(
     context.executor = await configure_executor(config)
     context.task_registry = ActivityRegistry()
 
-    context.decorator_registry = DecoratorRegistry()
-    register_asyncio_decorators(context.decorator_registry)
-
     # Store the tracer in context if needed
-    context.tracer = trace.get_tracer(config.otel.service_name)
+    if config.otel:
+        context.tracer = trace.get_tracer(config.otel.service_name)
 
     if store_globally:
         global _global_context
@@ -234,7 +216,7 @@ def get_current_context() -> Context:
 def get_current_config():
     """
     Get the current application config.
-    
+
     Returns the context config if available, otherwise falls back to global settings.
     """
     return get_current_context().config or get_settings()

mcp_agent/core/agent_types.py

@@ -34,8 +34,8 @@ class AgentConfig(BaseModel):
     human_input: bool = False
     agent_type: AgentType = AgentType.BASIC
 
-    @model_validator(mode='after')
-    def ensure_default_request_params(self) -> 'AgentConfig':
+    @model_validator(mode="after")
+    def ensure_default_request_params(self) -> "AgentConfig":
         """Ensure default_request_params exists with proper history setting"""
         if self.default_request_params is None:
             self.default_request_params = RequestParams(

mcp_agent/core/direct_decorators.py

@@ -224,7 +224,7 @@ def orchestrator(
     use_history: bool = False,
     human_input: bool = False,
     plan_type: Literal["full", "iterative"] = "full",
-    max_iterations: int = 30,
+    plan_iterations: int = 5,
 ) -> Callable[[AgentCallable[P, R]], DecoratedOrchestratorProtocol[P, R]]:
     """
     Decorator to create and register an orchestrator agent with type-safe signature.
@@ -260,7 +260,7 @@ def orchestrator(
             human_input=human_input,
             child_agents=agents,
             plan_type=plan_type,
-            max_iterations=max_iterations,
+            plan_iterations=plan_iterations,
         ),
     )
 

mcp_agent/core/direct_factory.py

@@ -138,7 +138,7 @@ async def create_agents_by_type(
             # Get common configuration
             config = agent_data["config"]
 
-                # Type-specific initialization based on the Enum type
+            # Type-specific initialization based on the Enum type
             # Note: Above we compared string values from config, here we compare Enum objects directly
             if agent_type == AgentType.BASIC:
                 # Create a basic agent
@@ -175,6 +175,7 @@ async def create_agents_by_type(
                     config=config,
                     context=app_instance.context,
                     agents=child_agents,
+                    plan_iterations=agent_data.get("plan_iterations", 5),
                     plan_type=agent_data.get("plan_type", "full"),
                 )
 

mcp_agent/core/enhanced_prompt.py

@@ -289,14 +289,19 @@ async def get_enhanced_input(
                 # Return a dictionary with select_prompt action instead of a string
                 # This way it will match what the command handler expects
                 return {"select_prompt": True, "prompt_name": None}
-            elif cmd == "prompt" and len(cmd_parts) > 1:
-                # Direct prompt selection with name or number
-                prompt_arg = cmd_parts[1].strip()
-                # Check if it's a number (use as index) or a name (use directly)
-                if prompt_arg.isdigit():
-                    return {"select_prompt": True, "prompt_index": int(prompt_arg)}
+            elif cmd == "prompt":
+                # Handle /prompt with no arguments the same way as /prompts
+                if len(cmd_parts) > 1:
+                    # Direct prompt selection with name or number
+                    prompt_arg = cmd_parts[1].strip()
+                    # Check if it's a number (use as index) or a name (use directly)
+                    if prompt_arg.isdigit():
+                        return {"select_prompt": True, "prompt_index": int(prompt_arg)}
+                    else:
+                        return f"SELECT_PROMPT:{prompt_arg}"
                 else:
-                    return f"SELECT_PROMPT:{prompt_arg}"
+                    # If /prompt is used without arguments, treat it the same as /prompts
+                    return {"select_prompt": True, "prompt_name": None}
             elif cmd == "exit":
                 return "EXIT"
             elif cmd.lower() == "stop":

mcp_agent/core/fastagent.py

@@ -9,7 +9,8 @@ import asyncio
 import sys
 from contextlib import asynccontextmanager
 from importlib.metadata import version as get_version
-from typing import TYPE_CHECKING, Any, Callable, Dict, Optional, TypeVar
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, TypeVar
 
 import yaml
 
@@ -54,9 +55,11 @@ from mcp_agent.core.validation import (
     validate_workflow_references,
 )
 from mcp_agent.logging.logger import get_logger
+from mcp_agent.mcp.prompts.prompt_load import load_prompt_multipart
 
 if TYPE_CHECKING:
     from mcp_agent.agents.agent import Agent
+    from mcp_agent.mcp.prompt_message_multipart import PromptMessageMultipart
 
 F = TypeVar("F", bound=Callable[..., Any])  # For decorated functions
 logger = get_logger(__name__)
@@ -90,12 +93,16 @@ class FastAgent:
         )
         parser.add_argument(
             "--agent",
+            default="default",
             help="Specify the agent to send a message to (used with --message)",
         )
         parser.add_argument(
             "-m",
             "--message",
-            help="Message to send to the specified agent (requires --agent)",
+            help="Message to send to the specified agent",
+        )
+        parser.add_argument(
+            "-p", "--prompt-file", help="Path to a prompt file to use (either text or JSON)"
         )
         parser.add_argument(
             "--quiet",
@@ -294,8 +301,8 @@ class FastAgent:
                     # Exit after server shutdown
                     raise SystemExit(0)
 
-                # Handle direct message sending if --agent and --message are provided
-                if hasattr(self, "args") and self.args.agent and self.args.message:
+                # Handle direct message sending if  --message is provided
+                if self.args.message:
                     agent_name = self.args.agent
                     message = self.args.message
 
@@ -321,6 +328,33 @@ class FastAgent:
                         print(f"\n\nError sending message to agent '{agent_name}': {str(e)}")
                         raise SystemExit(1)
 
+                if self.args.prompt_file:
+                    agent_name = self.args.agent
+                    prompt: List[PromptMessageMultipart] = load_prompt_multipart(
+                        Path(self.args.prompt_file)
+                    )
+                    if agent_name not in active_agents:
+                        available_agents = ", ".join(active_agents.keys())
+                        print(
+                            f"\n\nError: Agent '{agent_name}' not found. Available agents: {available_agents}"
+                        )
+                        raise SystemExit(1)
+
+                    try:
+                        # Get response from the agent
+                        agent = active_agents[agent_name]
+                        response = await agent.generate(prompt)
+
+                        # In quiet mode, just print the raw response
+                        # The chat display should already be turned off by the configuration
+                        if self.args.quiet:
+                            print(f"{response.last_text()}")
+
+                        raise SystemExit(0)
+                    except Exception as e:
+                        print(f"\n\nError sending message to agent '{agent_name}': {str(e)}")
+                        raise SystemExit(1)
+
                 yield wrapper
 
         except (
@@ -381,7 +415,7 @@ class FastAgent:
             handle_error(
                 e,
                 "Model Configuration Error",
-                "Common models: gpt-4o, o3-mini, sonnet, haiku. for o3, set reasoning effort with o3-mini.high",
+                "Common models: gpt-4.1, o3-mini, sonnet, haiku. for o3, set reasoning effort with o3-mini.high",
             )
         elif isinstance(e, CircularDependencyError):
             handle_error(

mcp_agent/core/interactive_prompt.py

@@ -153,8 +153,12 @@ class InteractivePrompt:
                             )
                         continue
 
-                # Skip further processing if command was handled
-                if command_result:
+                # Skip further processing if:
+                # 1. The command was handled (command_result is truthy)
+                # 2. The original input was a dictionary (special command like /prompt)
+                # 3. The command result itself is a dictionary (special command handling result)
+                # This fixes the issue where /prompt without arguments gets sent to the LLM
+                if command_result or isinstance(user_input, dict) or isinstance(command_result, dict):
                     continue
 
                 if user_input.upper() == "STOP":

mcp_agent/core/request_params.py

@@ -2,7 +2,7 @@
 Request parameters definitions for LLM interactions.
 """
 
-from typing import List
+from typing import Any, List
 
 from mcp import SamplingMessage
 from mcp.types import CreateMessageRequestParams
@@ -44,3 +44,7 @@ class RequestParams(CreateMessageRequestParams):
     Whether to allow multiple tool calls per iteration.
     Also known as multi-step tool use.
     """
+    response_format: Any | None = None
+    """
+    Override response format for structured calls. Prefer sending pydantic model - only use in exceptional circumstances
+    """

mcp_agent/core/validation.py

@@ -231,6 +231,12 @@ def get_dependencies_groups(
         if agent_type == AgentType.PARALLEL.value:
             # Parallel agents depend on their fan-out and fan-in agents
             dependencies[name].update(agent_data.get("parallel_agents", []))
+            # Also add explicit fan_out dependencies if present
+            if "fan_out" in agent_data:
+                dependencies[name].update(agent_data["fan_out"])
+            # Add explicit fan_in dependency if present
+            if "fan_in" in agent_data and agent_data["fan_in"]:
+                dependencies[name].add(agent_data["fan_in"])
         elif agent_type == AgentType.CHAIN.value:
             # Chain agents depend on the agents in their sequence
             dependencies[name].update(agent_data.get("sequence", []))
@@ -241,7 +247,12 @@ def get_dependencies_groups(
             # Orchestrator agents depend on their child agents
             dependencies[name].update(agent_data.get("child_agents", []))
         elif agent_type == AgentType.EVALUATOR_OPTIMIZER.value:
-            # Evaluator-Optimizer agents depend on their evaluation and optimization agents
+            # Evaluator-Optimizer agents depend on their evaluator and generator agents
+            if "evaluator" in agent_data:
+                dependencies[name].add(agent_data["evaluator"])
+            if "generator" in agent_data:
+                dependencies[name].add(agent_data["generator"])
+            # For backward compatibility - also check eval_optimizer_agents if present
             dependencies[name].update(agent_data.get("eval_optimizer_agents", []))
 
     # Check for cycles if not allowed

mcp_agent/executor/workflow_signal.py

@@ -7,8 +7,6 @@ from pydantic import BaseModel, ConfigDict
 
 SignalValueT = TypeVar("SignalValueT")
 
-# TODO: saqadri - handle signals properly that works with other execution backends like Temporal as well
-
 
 class Signal(BaseModel, Generic[SignalValueT]):
     """Represents a signal that can be sent to a workflow."""