fast-agent-mcp 0.2.57__py3-none-any.whl → 0.3.0__py3-none-any.whl

{mcp_agent → fast_agent}/resources/examples/mcp/elicitations/elicitation_forms_server.py

@@ -100,11 +100,25 @@ async def product_review() -> ReadResourceResult:
             },
         )
         review_text: str = Field(
-            description="Tell us about your experience", min_length=10, max_length=1000
+            description="Tell us about your experience",
+            default="""Great product!
+Here's what I loved:
+
+- Excellent build quality
+- Fast shipping
+- Works as advertised
+
+One minor issue:
+- Instructions could be clearer
+
+Overall, highly recommended!""",
+            min_length=10,
+            max_length=1000
         )
 
     result = await mcp.get_context().elicit(
-        "Share your product review - Help others make informed decisions!", schema=ProductReview
+        "Share your product review - Help others make informed decisions!",
+        schema=ProductReview,
     )
 
     match result:
@@ -140,6 +154,7 @@ async def account_settings() -> ReadResourceResult:
         email_notifications: bool = Field(True, description="Receive email notifications?")
         marketing_emails: bool = Field(False, description="Subscribe to marketing emails?")
         theme: str = Field(
+            "dark",
             description="Choose your preferred theme",
             json_schema_extra={
                 "enum": ["light", "dark", "auto"],
@@ -147,7 +162,9 @@ async def account_settings() -> ReadResourceResult:
             },
         )
         privacy_public: bool = Field(False, description="Make your profile public?")
-        items_per_page: int = Field(description="Items to show per page (10-100)", ge=10, le=100)
+        items_per_page: int = Field(
+            25, description="Items to show per page (10-100)", ge=10, le=100
+        )
 
     result = await mcp.get_context().elicit("Update your account settings", schema=AccountSettings)
 
@@ -182,7 +199,11 @@ async def service_appointment() -> ReadResourceResult:
 
     class ServiceAppointment(BaseModel):
         customer_name: str = Field(description="Your full name", min_length=2, max_length=50)
+        phone_number: str = Field(
+            "555-", description="Contact phone number", min_length=10, max_length=20
+        )
         vehicle_type: str = Field(
+            default="sedan",
             description="What type of vehicle do you have?",
             json_schema_extra={
                 "enum": ["sedan", "suv", "truck", "motorcycle", "other"],
@@ -205,6 +226,7 @@ async def service_appointment() -> ReadResourceResult:
             lines = [
                 "🔧 Service Appointment Scheduled!",
                 f"👤 Customer: {data.customer_name}",
+                f"📞 Phone: {data.phone_number}",
                 f"🚗 Vehicle: {data.vehicle_type.title()}",
                 f"🚙 Loaner needed: {'Yes' if data.needs_loaner else 'No'}",
                 f"📅 Appointment: {data.appointment_time}",

{mcp_agent → fast_agent}/resources/examples/mcp/elicitations/forms_demo.py

@@ -13,8 +13,8 @@ import asyncio
 from rich.console import Console
 from rich.panel import Panel
 
-from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.mcp.helpers.content_helpers import get_resource_text
+from fast_agent.core.fastagent import FastAgent
+from fast_agent.mcp.helpers.content_helpers import get_resource_text
 
 fast = FastAgent("Elicitation Forms Demo", quiet=True)
 console = Console()
@@ -38,7 +38,7 @@ async def main():
         console.print(
             "[dim]Demonstrates: string validation, email format, URL format, date format[/dim]"
         )
-        result = await agent.get_resource("elicitation://event-registration")
+        result = await agent["forms-demo"].get_resource("elicitation://event-registration")
 
         if result_text := get_resource_text(result):
             panel = Panel(

{mcp_agent → fast_agent}/resources/examples/mcp/elicitations/game_character.py

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

{mcp_agent → fast_agent}/resources/examples/mcp/elicitations/game_character_handler.py

@@ -17,7 +17,7 @@ from rich.progress import BarColumn, Progress, TextColumn
 from rich.prompt import Confirm
 from rich.table import Table
 
-from mcp_agent.logging.logger import get_logger
+from fast_agent.core.logging.logger import get_logger
 
 if TYPE_CHECKING:
     from mcp import ClientSession

{mcp_agent → fast_agent}/resources/examples/mcp/elicitations/tool_call.py

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

{mcp_agent → fast_agent}/resources/examples/mcp/state-transfer/agent_one.py

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

{mcp_agent → fast_agent}/resources/examples/mcp/state-transfer/agent_two.py

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

{mcp_agent → fast_agent}/resources/examples/researcher/researcher-eval.py

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

{mcp_agent → fast_agent}/resources/examples/researcher/researcher-imp.py

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

{mcp_agent → fast_agent}/resources/examples/researcher/researcher.py

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

{mcp_agent → fast_agent}/resources/examples/tensorzero/agent.py

@@ -1,7 +1,7 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.core.request_params import RequestParams
+from fast_agent.core.fastagent import FastAgent
+from fast_agent.llm.request_params import RequestParams
 
 # Explicitly provide the path to the config file in the current directory
 CONFIG_FILE = "fastagent.config.yaml"

{mcp_agent → fast_agent}/resources/examples/tensorzero/image_demo.py

@@ -6,9 +6,9 @@ from typing import List, Union
 
 from mcp.types import ImageContent, TextContent
 
-from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.core.prompt import Prompt
-from mcp_agent.core.request_params import RequestParams
+from fast_agent.core.fastagent import FastAgent
+from fast_agent.core.prompt import Prompt
+from fast_agent.llm.request_params import RequestParams
 
 AGENT_NAME = "tensorzero_image_tester"
 TENSORZERO_MODEL = "tensorzero.test_chat"

{mcp_agent → fast_agent}/resources/examples/tensorzero/simple_agent.py

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

{mcp_agent → fast_agent}/resources/examples/workflows/chaining.py

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

{mcp_agent → fast_agent}/resources/examples/workflows/evaluator.py

@@ -4,7 +4,7 @@ This demonstrates creating an optimizer and evaluator to iteratively improve con
 
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("Evaluator-Optimizer")
@@ -18,7 +18,7 @@ fast = FastAgent("Evaluator-Optimizer")
     candidate details, and company information. Tailor the response to the company and job requirements.
     """,
     servers=["fetch"],
-    model="gpt-4.1-nano",
+    model="gpt-5-nano.low",
     use_history=True,
 )
 # Define evaluator agent
@@ -40,7 +40,7 @@ fast = FastAgent("Evaluator-Optimizer")
     Summarize your evaluation as a structured response with:
     - Overall quality rating.
     - Specific feedback and areas for improvement.""",
-    model="sonnet",
+    model="o3-mini.medium",
 )
 # Define the evaluator-optimizer workflow
 @fast.evaluator_optimizer(

{mcp_agent → fast_agent}/resources/examples/workflows/human_input.py

@@ -4,7 +4,7 @@ Agent which demonstrates Human Input tool
 
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("Human Input")
@@ -12,14 +12,16 @@ fast = FastAgent("Human Input")
 
 # Define the agent
 @fast.agent(
-    instruction="An AI agent that assists with basic tasks. Request Human Input when needed.",
+    instruction="An AI agent that assists with basic tasks. Request Human Input when needed - for example"
+    "if being asked to predict a number sequence or pretending to take pizza orders.",
     human_input=True,
 )
 async def main() -> None:
     async with fast.run() as agent:
         # this usually causes the LLM to request the Human Input Tool
         await agent("print the next number in the sequence")
-        await agent.prompt(default_prompt="STOP")
+        await agent("pretend to be a pizza restaurant and take the users order")
+        await agent.interactive(default_prompt="STOP")
 
 
 if __name__ == "__main__":

{mcp_agent → fast_agent}/resources/examples/workflows/orchestrator.py

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

{mcp_agent → fast_agent}/resources/examples/workflows/parallel.py

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

{mcp_agent → fast_agent}/resources/examples/workflows/router.py

@@ -9,7 +9,7 @@ import asyncio
 
 from rich.console import Console
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent(
@@ -26,11 +26,13 @@ SAMPLE_REQUESTS = [
 
 @fast.agent(
     name="fetcher",
+    model="haiku",
     instruction="""You are an agent, with a tool enabling you to fetch URLs.""",
     servers=["fetch"],
 )
 @fast.agent(
     name="code_expert",
+    model="haiku",
     instruction="""You are an expert in code analysis and software engineering.
     When asked about code, architecture, or development practices,
     you provide thorough and practical insights.""",
@@ -38,12 +40,13 @@ SAMPLE_REQUESTS = [
 )
 @fast.agent(
     name="general_assistant",
+    model="haiku",
     instruction="""You are a knowledgeable assistant that provides clear,
     well-reasoned responses about general topics, concepts, and principles.""",
 )
 @fast.router(
     name="route",
-    model="gpt-4.1",
+    model="sonnet",
     agents=["code_expert", "general_assistant", "fetcher"],
 )
 async def main() -> None:

fast_agent/resources/setup/.gitignore

@@ -0,0 +1,24 @@
+# Secrets
+fastagent.secrets.yaml
+
+# Python cache/bytecode
+__pycache__/
+*.py[cod]
+
+# Local env and virtualenvs
+.env
+.venv/
+venv/
+env/
+
+# OS cruft
+.DS_Store
+Thumbs.db
+
+# Logs/artifacts
+fastagent.jsonl
+*.jsonl
+
+# Editors (optional)
+.idea/
+.vscode/

fast_agent/resources/setup/agent.py

@@ -0,0 +1,18 @@
+import asyncio
+
+from fast_agent.core.fastagent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent example")
+
+
+# Define the agent
+@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.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent/resources/setup/fastagent.config.yaml

@@ -0,0 +1,44 @@
+# FastAgent Configuration File
+
+# Default Model Configuration:
+#
+# Takes format:
+#   <provider>.<model_string>.<reasoning_effort?> (e.g. anthropic.claude-3-5-sonnet-20241022 or openai.o3-mini.low)
+# Accepts aliases for Anthropic Models: haiku, haiku3, sonnet, sonnet35, opus, opus3
+# and OpenAI Models: gpt-4.1, gpt-4.1-mini, o1, o1-mini, o3-mini
+#
+# If not specified, defaults to "haiku".
+# Can be overriden with a command line switch --model=<model>, or within the Agent constructor.
+
+default_model: haiku
+# mcp-ui support: disabled, enabled or auto. "auto" opens the web browser on the asset automatically
+# mcp_ui_mode: enabled
+
+# Logging and Console Configuration:
+logger:
+  # level: "debug" | "info" | "warning" | "error"
+  # type: "none" | "console" | "file" | "http"
+  # path: "/path/to/logfile.jsonl"
+
+  # Switch the progress display on or off
+  progress_display: true
+
+  # 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:
+    fetch:
+      command: "uvx"
+      args: ["mcp-server-fetch"]
+    filesystem:
+      command: "npx"
+      args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    huggingface:
+      transport: "http"
+      url: "https://huggingface.co/mcp"

fast_agent/resources/setup/fastagent.secrets.yaml.example

@@ -0,0 +1,38 @@
+# FastAgent Secrets Configuration
+# WARNING: Keep this file secure and never commit to version control
+
+# 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>
+deepseek:
+  api_key: <your-api-key-here>
+google:
+  api_key: <your-api-key-here>
+googleoai:
+  api_key: <your-api-key-here>
+azure:
+  api_key: <your-api-key-here>
+  base_url: "https://...resource_name....openai.azure.com/" # Resource name (do NOT include if using base_url)
+  azure_deployment: "gpt-4.1" # Required - the model deployment name
+#  api_version: "2024-10-21"
+xai:
+  api_key: <your-api-key-here>
+hf:
+  api_key: <your-HF_TOKEN-here>
+groq:
+  api_key: <your-api-key-here>
+
+# Example of setting an MCP Server environment variable
+mcp:
+  servers:
+    brave:
+      env:
+        BRAVE_API_KEY: <your-api-key-here>