fast-agent-mcp 0.0.16__tar.gz → 0.1.1__tar.gz

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.0.16
+Version: 0.1.1
 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
@@ -235,7 +235,7 @@ Provides-Extra: temporal
 Requires-Dist: temporalio>=1.8.0; extra == 'temporal'
 Description-Content-Type: text/markdown
 
-## FastAgent
+## 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>
@@ -257,7 +257,7 @@ Evaluate how different models handle Agent and MCP Server calling tasks, then bu
 
 Prompts and configurations that define your Agent Applications are stored in simple files, with minimal boilerplate, enabling simple management and version control.
 
-Chat with individual Agents and Components before, during and after workflow execution to tune and diagnose your application.
+Chat with individual Agents and Components before, during and after workflow execution to tune and diagnose your application. Agents can request human input to get additional context for task completion.
 
 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/)
 
@@ -391,6 +391,21 @@ This starts an interactive session, which produces a short social media post for
 
 Chains can be incorporated in other workflows, or contain other workflow elements (including other Chains). You can set an `instruction` to precisely describe it's capabilities to other workflow steps if needed.
 
+### Human Input
+
+Agents can request Human Input to assist with a task or get additional context:
+
+```python
+@fast.agent(
+    instruction="An AI agent that assists with basic tasks. Request Human Input when needed.",
+    human_input=True,
+)
+
+await agent("print the next number in the sequence")
+```
+
+In the example `human_input.py`, the Agent will prompt the User for additional information to complete the task.
+
 ### Parallel
 
 The Parallel Workflow sends the same message to multiple Agents simultaneously (`fan-out`), then uses the `fan-in` Agent to process the combined content.
@@ -415,9 +430,13 @@ Look at the `parallel.py` workflow example for more examples. If you don't speci
 
 `parallel` is also useful to ensemble ideas from different LLMs.
 
+When using `parallel` in other workflows, specify an `instruction` to describe its operation.
+
 ### Evaluator-Optimizer
 
-Evaluator-Optimizers combine 2 agents: one to generate content (the `generator`), and the other to judge that content and provide actionable feedback (the `evaluator`). Messages are sent to the generator first, then the pair run in a loop until either the evaluator is satisfied with the quality, or the maximum number of refinements is reached.
+Evaluator-Optimizers combine 2 agents: one to generate content (the `generator`), and the other to judge that content and provide actionable feedback (the `evaluator`). Messages are sent to the generator first, then the pair run in a loop until either the evaluator is satisfied with the quality, or the maximum number of refinements is reached. The final result from the Generator is returned.
+
+If the Generator has `use_history` off, the previous iteration is returned when asking for improvements - otherwise conversational context is used.
 
 ```python
 @fast.evaluator_optimizer(
@@ -432,6 +451,8 @@ async with fast.run() as agent:
   await agent.researcher.send("produce a report on how to make the perfect espresso")
 ```
 
+When used in a workflow, it returns the last `generator` message as the result.
+
 See the `evaluator.py` workflow example, or `fast-agent bootstrap researcher` for a more complete example.
 
 ### Router
@@ -458,7 +479,7 @@ Given a complex task, the Orchestrator uses an LLM to generate a plan to divide
 )
 ```
 
-See `orchestrator.py` in the workflow examples.
+See the `orchestrator.py` or `agent_build.py` workflow example.
 
 ## Agent Features
 
@@ -540,7 +561,7 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
   name="route",                          # name of the router
   agents=["agent1", "agent2", "agent3"], # list of agent names router can delegate to
   model="o3-mini.high",                  # specify routing model
-  use_history=True,                      # router maintains chat history
+  use_history=False,                     # router maintains conversation history
   human_input=False,                     # whether router can request human input
 )
 ```
@@ -553,9 +574,10 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
   instruction="instruction",             # base instruction for the orchestrator
   agents=["agent1", "agent2"],           # list of agent names this orchestrator can use
   model="o3-mini.high",                  # specify orchestrator planning model
-  use_history=False,                     # orchestrator doesn't maintain chat history by default
+  use_history=False,                     # orchestrator doesn't maintain chat history (no effect).
   human_input=False,                     # whether orchestrator can request human input
   plan_type="full",                      # planning approach: "full" or "iterative"
+  max_iterations=5,                      # maximum number of full plan attempts, or iterations
 )
 ```
 
@@ -570,6 +592,7 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
 
 ### llmindset.co.uk fork:
 
+- Overhaul of Eval/Opt for Conversation Management
 - Remove instructor use for Orchestrator
 - Improved handling of Parallel/Fan-In and respose option
 - XML based generated prompts
@@ -590,9 +613,3 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
 - Numerous defect fixes
 
 ### Features to add.
-
-- Chat History Clear.
-
-```
-
-```

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/README.md

@@ -1,4 +1,4 @@
-## FastAgent
+## 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>
@@ -20,7 +20,7 @@ Evaluate how different models handle Agent and MCP Server calling tasks, then bu
 
 Prompts and configurations that define your Agent Applications are stored in simple files, with minimal boilerplate, enabling simple management and version control.
 
-Chat with individual Agents and Components before, during and after workflow execution to tune and diagnose your application.
+Chat with individual Agents and Components before, during and after workflow execution to tune and diagnose your application. Agents can request human input to get additional context for task completion.
 
 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/)
 
@@ -154,6 +154,21 @@ This starts an interactive session, which produces a short social media post for
 
 Chains can be incorporated in other workflows, or contain other workflow elements (including other Chains). You can set an `instruction` to precisely describe it's capabilities to other workflow steps if needed.
 
+### Human Input
+
+Agents can request Human Input to assist with a task or get additional context:
+
+```python
+@fast.agent(
+    instruction="An AI agent that assists with basic tasks. Request Human Input when needed.",
+    human_input=True,
+)
+
+await agent("print the next number in the sequence")
+```
+
+In the example `human_input.py`, the Agent will prompt the User for additional information to complete the task.
+
 ### Parallel
 
 The Parallel Workflow sends the same message to multiple Agents simultaneously (`fan-out`), then uses the `fan-in` Agent to process the combined content.
@@ -178,9 +193,13 @@ Look at the `parallel.py` workflow example for more examples. If you don't speci
 
 `parallel` is also useful to ensemble ideas from different LLMs.
 
+When using `parallel` in other workflows, specify an `instruction` to describe its operation.
+
 ### Evaluator-Optimizer
 
-Evaluator-Optimizers combine 2 agents: one to generate content (the `generator`), and the other to judge that content and provide actionable feedback (the `evaluator`). Messages are sent to the generator first, then the pair run in a loop until either the evaluator is satisfied with the quality, or the maximum number of refinements is reached.
+Evaluator-Optimizers combine 2 agents: one to generate content (the `generator`), and the other to judge that content and provide actionable feedback (the `evaluator`). Messages are sent to the generator first, then the pair run in a loop until either the evaluator is satisfied with the quality, or the maximum number of refinements is reached. The final result from the Generator is returned.
+
+If the Generator has `use_history` off, the previous iteration is returned when asking for improvements - otherwise conversational context is used.
 
 ```python
 @fast.evaluator_optimizer(
@@ -195,6 +214,8 @@ async with fast.run() as agent:
   await agent.researcher.send("produce a report on how to make the perfect espresso")
 ```
 
+When used in a workflow, it returns the last `generator` message as the result.
+
 See the `evaluator.py` workflow example, or `fast-agent bootstrap researcher` for a more complete example.
 
 ### Router
@@ -221,7 +242,7 @@ Given a complex task, the Orchestrator uses an LLM to generate a plan to divide
 )
 ```
 
-See `orchestrator.py` in the workflow examples.
+See the `orchestrator.py` or `agent_build.py` workflow example.
 
 ## Agent Features
 
@@ -303,7 +324,7 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
   name="route",                          # name of the router
   agents=["agent1", "agent2", "agent3"], # list of agent names router can delegate to
   model="o3-mini.high",                  # specify routing model
-  use_history=True,                      # router maintains chat history
+  use_history=False,                     # router maintains conversation history
   human_input=False,                     # whether router can request human input
 )
 ```
@@ -316,9 +337,10 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
   instruction="instruction",             # base instruction for the orchestrator
   agents=["agent1", "agent2"],           # list of agent names this orchestrator can use
   model="o3-mini.high",                  # specify orchestrator planning model
-  use_history=False,                     # orchestrator doesn't maintain chat history by default
+  use_history=False,                     # orchestrator doesn't maintain chat history (no effect).
   human_input=False,                     # whether orchestrator can request human input
   plan_type="full",                      # planning approach: "full" or "iterative"
+  max_iterations=5,                      # maximum number of full plan attempts, or iterations
 )
 ```
 
@@ -333,6 +355,7 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
 
 ### llmindset.co.uk fork:
 
+- Overhaul of Eval/Opt for Conversation Management
 - Remove instructor use for Orchestrator
 - Improved handling of Parallel/Fan-In and respose option
 - XML based generated prompts
@@ -353,9 +376,3 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
 - Numerous defect fixes
 
 ### Features to add.
-
-- Chat History Clear.
-
-```
-
-```

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.0.16"
+version = "0.1.1"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/src/mcp_agent/cli/commands/bootstrap.py

@@ -135,7 +135,7 @@ def copy_example_files(
 
 def show_overview():
     """Display an overview of available examples in a nicely formatted table."""
-    console.print("\n[bold cyan]FastAgent Example Applications[/bold cyan]")
+    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

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/src/mcp_agent/cli/commands/setup.py

@@ -185,7 +185,7 @@ def init(
     # Check for existing .gitignore
     needs_gitignore = not find_gitignore(config_path)
 
-    console.print("\n[bold]FastAgent Setup[/bold]\n")
+    console.print("\n[bold]fast-agent Setup[/bold]\n")
     console.print("This will create the following files:")
     console.print(f"  - {config_path}/fastagent.config.yaml")
     console.print(f"  - {config_path}/fastagent.secrets.yaml")
@@ -227,6 +227,9 @@ def init(
             console.print(
                 "2. Keep fastagent.secrets.yaml secure and never commit it to version control"
             )
+            console.print(
+                "3. Update fastagent.config.yaml to set a default model (currently system default is 'haiku')"
+            )
         console.print("\nTo get started, run:")
         console.print("  uv run agent.py")
     else:

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/src/mcp_agent/cli/main.py

@@ -22,7 +22,14 @@ console = Console()
 
 def show_welcome():
     """Show a welcome message with available commands."""
-    console.print("\n[bold]Welcome to MCP Agent![/bold]")
+    from importlib.metadata import version
+
+    try:
+        app_version = version("fast-agent-mcp")
+    except:  # noqa: E722
+        app_version = "unknown"
+
+    console.print(f"\n[bold]fast-agent (fast-agent-mcp) {app_version}[/bold]")
     console.print("Build effective agents using Model Context Protocol (MCP)")
 
     # Create a table for commands
@@ -41,8 +48,11 @@ def show_welcome():
     console.print("\n[bold]Getting Started:[/bold]")
     console.print("1. Set up a new project:")
     console.print("   fastagent setup")
-    console.print("\n2. Try an example workflow:")
-    console.print("   fastagent bootstrap create workflow")
+    console.print("\n2. Create Building Effective Agents  workflow examples:")
+    console.print("   fastagent bootstrap workflow")
+    console.print("\n3. Explore other examples:")
+    console.print("   fastagent bootstrap")
+
     console.print("\nUse --help with any command for more information")
     console.print("Example: fastagent bootstrap --help")
 

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/src/mcp_agent/core/agent_app.py

@@ -129,7 +129,7 @@ class AgentApp:
                     continue
 
             result = await self.send(agent, user_input)
-            
+
             # Check if current agent is a chain that should continue with final agent
             if agent_types.get(agent) == "Chain":
                 proxy = self._agents[agent]

{fast_agent_mcp-0.0.16 → fast_agent_mcp-0.1.1}/src/mcp_agent/core/enhanced_prompt.py

@@ -52,7 +52,7 @@ class AgentCompleter(Completer):
             "clear": "Clear the screen",
             "agents": "List available agents",
             "STOP": "Stop this prompting session and move to next workflow step",
-            "EXIT": "Exit FastAgent, terminating any running workflows",
+            "EXIT": "Exit fast-agent, terminating any running workflows",
             **(commands or {}),  # Allow custom commands to be passed in
         }
         if is_human_input:
@@ -319,7 +319,7 @@ async def handle_special_commands(command, agent_app=None):
         rich_print("  @agent_name    - Switch to agent")
         rich_print("  STOP           - Return control back to the workflow")
         rich_print(
-            "  EXIT           - Exit FastAgent, terminating any running workflows"
+            "  EXIT           - Exit fast-agent, terminating any running workflows"
         )
         rich_print("\n[bold]Keyboard Shortcuts:[/bold]")
         rich_print(
@@ -338,7 +338,7 @@ async def handle_special_commands(command, agent_app=None):
         return True
 
     elif command == "EXIT":
-        raise PromptExitError("User requested to exit FastAgent session")
+        raise PromptExitError("User requested to exit fast-agent session")
 
     elif command == "LIST_AGENTS":
         if available_agents: