fast-agent-mcp 0.0.15__tar.gz → 0.1.0__tar.gz

{fast_agent_mcp-0.0.15 → fast_agent_mcp-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.0.15
+Version: 0.1.0
 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>
@@ -259,14 +259,17 @@ Prompts and configurations that define your Agent Applications are stored in sim
 
 Chat with individual Agents and Components before, during and after workflow execution to tune and diagnose your application.
 
-Simple model selection makes testing Model <-> MCP Server interaction painless.
+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)
 
 ## Get started:
 
 Start by installing the [uv package manager](https://docs.astral.sh/uv/) for Python. Then:
 
 ```bash
-uv pip install fast-agent-mcp       # install fast-agent
+uv pip install fast-agent-mcp       # install fast-agent!
+
 fast-agent setup                    # create an example agent and config files
 uv run agent.py                     # run your first agent
 uv run agent.py --model=o3-mini.low # specify a model
@@ -275,6 +278,7 @@ fast-agent bootstrap workflow       # create "building effective agents" example
 
 Other bootstrap examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
 
+> [!TIP]
 > Windows Users - there are a couple of configuration changes needed for the Filesystem and Docker MCP Servers - necessary changes are detailed within the configuration files.
 
 ### Basic Agents
@@ -354,7 +358,7 @@ async def main():
         )
 ```
 
-All Agents and Workflows respond to `.send("message")` and `.prompt()` to begin a chat session.
+All Agents and Workflows respond to `.send("message")` or `.prompt()` to begin a chat session.
 
 Saved as `social.py` we can now run this workflow from the command line with:
 
@@ -362,7 +366,7 @@ Saved as `social.py` we can now run this workflow from the command line with:
 uv run social.py --agent social_media --message "<url>"
 ```
 
-Add the `--quiet` switch to only return the final response.
+Add the `--quiet` switch to only return the final response, which is useful for simple automations.
 
 ## Workflows
 
@@ -383,7 +387,7 @@ async with fast.run() as agent:
 
 ```
 
-This starts an interactive session, which produces a short social media post for a given URL. If a _chain_ is prompted, by default it returns to a chat with last Agent in the chain.
+This starts an interactive session, which produces a short social media post for a given URL. If a _chain_ is prompted it returns to a chat with last Agent in the chain. You can switch the agent to prompt by typing `@agent-name`.
 
 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.
 
@@ -407,13 +411,17 @@ The Parallel Workflow sends the same message to multiple Agents simultaneously (
 )
 ```
 
-Look at the `parallel.py` workflow example for more examples. If you don't specify a `fan-in` agent, the `parallel` returns Agent results verbatim.
+Look at the `parallel.py` workflow example for more examples. If you don't specify a `fan-in` agent, the `parallel` returns the combined Agent results verbatim.
+
+`parallel` is also useful to ensemble ideas from different LLMs.
 
-The 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(
@@ -428,6 +436,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,20 +468,107 @@ See `orchestrator.py` in the workflow examples.
 
 ## Agent Features
 
+### Calling Agents
+
+All definitions allow omitting the name and instructions arguments for brevity:
+
+```python
+@fast.agent("You are a helpful agent")          # Create an agent with a default name.
+@fast.agent("greeter","Respond cheerfully!")    # Create an agent with the name "greeter"
+
+moon_size = await agent("the moon")             # Call the default (first defined agent) with a message
+
+result = await agent.greeter("Good morning!")   # Send a message to an agent by name using dot notation
+result = await agent.greeter.send("Hello!")     # You can call 'send' explicitly
+
+await agent.greeter()                           # If no message is specified, a chat session will open
+await agent.greeter.prompt()                    # that can be made more explicit
+await agent.greeter.prompt(default_prompt="OK") # and supports setting a default prompt
+
+agent["greeter"].send("Good Evening!")          # Dictionary access is supported if preferred
+```
+
+### Defining Agents
+
+#### Basic Agent
+
 ```python
 @fast.agent(
-  name="agent",
-  instructions="instructions",
-  servers=["filesystem"],     # list of MCP Servers for the agent, configured in fastagent.config.yaml
-  model="o3-mini.high",       # specify a model for the agent
-  use_history=True,           # agent can maintain chat history
-  human_input=True,           # agent can request human input
+  name="agent",                          # name of the agent
+  instruction="You are a helpful Agent", # base instruction for the agent
+  servers=["filesystem"],                # list of MCP Servers for the agent
+  model="o3-mini.high",                  # specify a model for the agent
+  use_history=True,                      # agent maintains chat history
+  request_params={"temperature": 0.7},   # additional parameters for the LLM (or RequestParams())
+  human_input=True,                      # agent can request human input
 )
 ```
 
-### Human Input
+#### Chain
+
+```python
+@fast.chain(
+  name="chain",                          # name of the chain
+  sequence=["agent1", "agent2", ...],    # list of agents in execution order
+  instruction="instruction",             # instruction to describe the chain for other workflows
+  continue_with_final=True,              # open chat with agent at end of chain after prompting
+)
+```
 
-When `human_input` is set to true for an Agent, it is presented with the option to prompt the User for input.
+#### Parallel
+
+```python
+@fast.parallel(
+  name="parallel",                       # name of the parallel workflow
+  fan_out=["agent1", "agent2"],          # list of agents to run in parallel
+  fan_in="aggregator",                   # name of agent that combines results (optional)
+  instruction="instruction",             # instruction to describe the parallel for other workflows
+  include_request=True,                  # include original request in fan-in message
+)
+```
+
+#### Evaluator-Optimizer
+
+```python
+@fast.evaluator_optimizer(
+  name="researcher",                     # name of the workflow
+  generator="web_searcher",              # name of the content generator agent
+  evaluator="quality_assurance",         # name of the evaluator agent
+  min_rating="GOOD",                     # minimum acceptable quality (EXCELLENT, GOOD, FAIR, POOR)
+  max_refinements=3,                     # maximum number of refinement iterations
+)
+```
+
+#### Router
+
+```python
+@fast.router(
+  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=False,                     # router maintains conversation history
+  human_input=False,                     # whether router can request human input
+)
+```
+
+#### Orchestrator
+
+```python
+@fast.orchestrator(
+  name="orchestrator",                   # name of the orchestrator
+  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
+  human_input=False,                     # whether orchestrator can request human input
+  plan_type="full",                      # planning approach: "full" or "iterative"
+)
+```
+
+### 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.
 
 ## Project Notes
 
@@ -479,8 +576,12 @@ When `human_input` is set to true for an Agent, it is presented with the option
 
 ### 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
 - "FastAgent" style prototyping, with per-agent models
-- Api keys through Environment Variables
+- API keys through Environment Variables
 - Warm-up / Post-Workflow Agent Interactions
 - Quick Setup
 - Interactive Prompt Mode
@@ -493,7 +594,6 @@ When `human_input` is set to true for an Agent, it is presented with the option
 - OpenAI o1/o3-mini support with reasoning level
 - Enhanced Human Input Messaging and Handling
 - Declarative workflows
+- Numerous defect fixes
 
 ### Features to add.
-
-- Chat History Clear.

{fast_agent_mcp-0.0.15 → fast_agent_mcp-0.1.0}/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>
@@ -22,14 +22,17 @@ Prompts and configurations that define your Agent Applications are stored in sim
 
 Chat with individual Agents and Components before, during and after workflow execution to tune and diagnose your application.
 
-Simple model selection makes testing Model <-> MCP Server interaction painless.
+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)
 
 ## Get started:
 
 Start by installing the [uv package manager](https://docs.astral.sh/uv/) for Python. Then:
 
 ```bash
-uv pip install fast-agent-mcp       # install fast-agent
+uv pip install fast-agent-mcp       # install fast-agent!
+
 fast-agent setup                    # create an example agent and config files
 uv run agent.py                     # run your first agent
 uv run agent.py --model=o3-mini.low # specify a model
@@ -38,6 +41,7 @@ fast-agent bootstrap workflow       # create "building effective agents" example
 
 Other bootstrap examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
 
+> [!TIP]
 > Windows Users - there are a couple of configuration changes needed for the Filesystem and Docker MCP Servers - necessary changes are detailed within the configuration files.
 
 ### Basic Agents
@@ -117,7 +121,7 @@ async def main():
         )
 ```
 
-All Agents and Workflows respond to `.send("message")` and `.prompt()` to begin a chat session.
+All Agents and Workflows respond to `.send("message")` or `.prompt()` to begin a chat session.
 
 Saved as `social.py` we can now run this workflow from the command line with:
 
@@ -125,7 +129,7 @@ Saved as `social.py` we can now run this workflow from the command line with:
 uv run social.py --agent social_media --message "<url>"
 ```
 
-Add the `--quiet` switch to only return the final response.
+Add the `--quiet` switch to only return the final response, which is useful for simple automations.
 
 ## Workflows
 
@@ -146,7 +150,7 @@ async with fast.run() as agent:
 
 ```
 
-This starts an interactive session, which produces a short social media post for a given URL. If a _chain_ is prompted, by default it returns to a chat with last Agent in the chain.
+This starts an interactive session, which produces a short social media post for a given URL. If a _chain_ is prompted it returns to a chat with last Agent in the chain. You can switch the agent to prompt by typing `@agent-name`.
 
 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.
 
@@ -170,13 +174,17 @@ The Parallel Workflow sends the same message to multiple Agents simultaneously (
 )
 ```
 
-Look at the `parallel.py` workflow example for more examples. If you don't specify a `fan-in` agent, the `parallel` returns Agent results verbatim.
+Look at the `parallel.py` workflow example for more examples. If you don't specify a `fan-in` agent, the `parallel` returns the combined Agent results verbatim.
+
+`parallel` is also useful to ensemble ideas from different LLMs.
 
-The 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(
@@ -191,6 +199,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,20 +231,107 @@ See `orchestrator.py` in the workflow examples.
 
 ## Agent Features
 
+### Calling Agents
+
+All definitions allow omitting the name and instructions arguments for brevity:
+
+```python
+@fast.agent("You are a helpful agent")          # Create an agent with a default name.
+@fast.agent("greeter","Respond cheerfully!")    # Create an agent with the name "greeter"
+
+moon_size = await agent("the moon")             # Call the default (first defined agent) with a message
+
+result = await agent.greeter("Good morning!")   # Send a message to an agent by name using dot notation
+result = await agent.greeter.send("Hello!")     # You can call 'send' explicitly
+
+await agent.greeter()                           # If no message is specified, a chat session will open
+await agent.greeter.prompt()                    # that can be made more explicit
+await agent.greeter.prompt(default_prompt="OK") # and supports setting a default prompt
+
+agent["greeter"].send("Good Evening!")          # Dictionary access is supported if preferred
+```
+
+### Defining Agents
+
+#### Basic Agent
+
 ```python
 @fast.agent(
-  name="agent",
-  instructions="instructions",
-  servers=["filesystem"],     # list of MCP Servers for the agent, configured in fastagent.config.yaml
-  model="o3-mini.high",       # specify a model for the agent
-  use_history=True,           # agent can maintain chat history
-  human_input=True,           # agent can request human input
+  name="agent",                          # name of the agent
+  instruction="You are a helpful Agent", # base instruction for the agent
+  servers=["filesystem"],                # list of MCP Servers for the agent
+  model="o3-mini.high",                  # specify a model for the agent
+  use_history=True,                      # agent maintains chat history
+  request_params={"temperature": 0.7},   # additional parameters for the LLM (or RequestParams())
+  human_input=True,                      # agent can request human input
 )
 ```
 
-### Human Input
+#### Chain
+
+```python
+@fast.chain(
+  name="chain",                          # name of the chain
+  sequence=["agent1", "agent2", ...],    # list of agents in execution order
+  instruction="instruction",             # instruction to describe the chain for other workflows
+  continue_with_final=True,              # open chat with agent at end of chain after prompting
+)
+```
 
-When `human_input` is set to true for an Agent, it is presented with the option to prompt the User for input.
+#### Parallel
+
+```python
+@fast.parallel(
+  name="parallel",                       # name of the parallel workflow
+  fan_out=["agent1", "agent2"],          # list of agents to run in parallel
+  fan_in="aggregator",                   # name of agent that combines results (optional)
+  instruction="instruction",             # instruction to describe the parallel for other workflows
+  include_request=True,                  # include original request in fan-in message
+)
+```
+
+#### Evaluator-Optimizer
+
+```python
+@fast.evaluator_optimizer(
+  name="researcher",                     # name of the workflow
+  generator="web_searcher",              # name of the content generator agent
+  evaluator="quality_assurance",         # name of the evaluator agent
+  min_rating="GOOD",                     # minimum acceptable quality (EXCELLENT, GOOD, FAIR, POOR)
+  max_refinements=3,                     # maximum number of refinement iterations
+)
+```
+
+#### Router
+
+```python
+@fast.router(
+  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=False,                     # router maintains conversation history
+  human_input=False,                     # whether router can request human input
+)
+```
+
+#### Orchestrator
+
+```python
+@fast.orchestrator(
+  name="orchestrator",                   # name of the orchestrator
+  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
+  human_input=False,                     # whether orchestrator can request human input
+  plan_type="full",                      # planning approach: "full" or "iterative"
+)
+```
+
+### 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.
 
 ## Project Notes
 
@@ -242,8 +339,12 @@ When `human_input` is set to true for an Agent, it is presented with the option
 
 ### 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
 - "FastAgent" style prototyping, with per-agent models
-- Api keys through Environment Variables
+- API keys through Environment Variables
 - Warm-up / Post-Workflow Agent Interactions
 - Quick Setup
 - Interactive Prompt Mode
@@ -256,7 +357,6 @@ When `human_input` is set to true for an Agent, it is presented with the option
 - OpenAI o1/o3-mini support with reasoning level
 - Enhanced Human Input Messaging and Handling
 - Declarative workflows
+- Numerous defect fixes
 
 ### Features to add.
-
-- Chat History Clear.

{fast_agent_mcp-0.0.15 → fast_agent_mcp-0.1.0}/pyproject.toml

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

fast_agent_mcp-0.1.0/src/mcp_agent/cli/__main__.py

@@ -0,0 +1,7 @@
+from mcp_agent.cli.main import app
+
+# This must be here for the console entry points defined in pyproject.toml
+# DO NOT REMOVE!
+
+if __name__ == "__main__":
+    app()

{fast_agent_mcp-0.0.15 → fast_agent_mcp-0.1.0}/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.15 → fast_agent_mcp-0.1.0}/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.15 → fast_agent_mcp-0.1.0}/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.15 → fast_agent_mcp-0.1.0}/src/mcp_agent/config.py

@@ -313,17 +313,25 @@ def get_settings(config_path: str | None = None) -> Settings:
             with open(config_file, "r", encoding="utf-8") as f:
                 yaml_settings = yaml.safe_load(f) or {}
                 merged_settings = yaml_settings
-
-            # Look for secrets file in the same directory
-            for secrets_file in [
-                config_file.parent / "mcp-agent.secrets.yaml",
-                config_file.parent / "mcp_agent.secrets.yaml",
-                config_file.parent / "fastagent.secrets.yaml",
-            ]:
-                if secrets_file.exists():
-                    with open(secrets_file, "r", encoding="utf-8") as f:
-                        yaml_secrets = yaml.safe_load(f) or {}
-                        merged_settings = deep_merge(merged_settings, yaml_secrets)
+            # Look for secrets files recursively up the directory tree
+            # but stop after finding the first one
+            current_dir = config_file.parent
+            found_secrets = False
+            while current_dir != current_dir.parent and not found_secrets:
+                for secrets_filename in [
+                    "mcp-agent.secrets.yaml",
+                    "mcp_agent.secrets.yaml",
+                    "fastagent.secrets.yaml",
+                ]:
+                    secrets_file = current_dir / secrets_filename
+                    if secrets_file.exists():
+                        with open(secrets_file, "r", encoding="utf-8") as f:
+                            yaml_secrets = yaml.safe_load(f) or {}
+                            merged_settings = deep_merge(merged_settings, yaml_secrets)
+                            found_secrets = True
+                            break
+                if not found_secrets:
+                    current_dir = current_dir.parent
 
             _settings = Settings(**merged_settings)
             return _settings

{fast_agent_mcp-0.0.15 → fast_agent_mcp-0.1.0}/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.15 → fast_agent_mcp-0.1.0}/src/mcp_agent/core/enhanced_prompt.py

@@ -3,6 +3,7 @@ Enhanced prompt functionality with advanced prompt_toolkit features.
 """
 
 from typing import List
+from importlib.metadata import version
 from prompt_toolkit import PromptSession
 from prompt_toolkit.formatted_text import HTML
 from prompt_toolkit.history import InMemoryHistory
@@ -15,6 +16,12 @@ from rich import print as rich_print
 
 from mcp_agent.core.exceptions import PromptExitError
 
+# Get the application version
+try:
+    app_version = version("fast-agent-mcp")
+except:  # noqa: E722
+    app_version = "unknown"
+
 # Map of agent names to their history
 agent_histories = {}
 
@@ -45,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:
@@ -204,7 +211,7 @@ async def get_enhanced_input(
 
         shortcut_text = " | ".join(f"{key}:{action}" for key, action in shortcuts)
         return HTML(
-            f" <{toolbar_color}> {agent_name} </{toolbar_color}> | <b>Mode:</b> <{mode_style}> {mode_text} </{mode_style}> {newline} | {shortcut_text}"
+            f" <{toolbar_color}> {agent_name} </{toolbar_color}> | <b>Mode:</b> <{mode_style}> {mode_text} </{mode_style}> {newline} | {shortcut_text} | <dim>v{app_version}</dim>"
         )
 
     # Create session with history and completions
@@ -312,13 +319,14 @@ 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(
             "  Enter          - Submit (normal mode) / New line (multiline mode)"
         )
-        rich_print("  Ctrl+Enter      - Always submit (even in multiline mode)")
+        rich_print("  \\ + Enter     - Insert new line in normal mode")
+        rich_print("  Ctrl+Enter      - Always submit (in any mode)")
         rich_print("  Ctrl+T         - Toggle multiline mode")
         rich_print("  Ctrl+L         - Clear input")
         rich_print("  Up/Down        - Navigate history")
@@ -330,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: