fast-agent-mcp 0.2.37__tar.gz → 0.2.39__tar.gz

{fast_agent_mcp-0.2.37 → fast_agent_mcp-0.2.39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.37
+Version: 0.2.39
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License

{fast_agent_mcp-0.2.37 → fast_agent_mcp-0.2.39}/pyproject.toml

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

{fast_agent_mcp-0.2.37 → fast_agent_mcp-0.2.39}/src/mcp_agent/cli/commands/quickstart.py

@@ -9,7 +9,7 @@ from rich.panel import Panel
 from rich.table import Table
 
 app = typer.Typer(
-    help="Create example applications",
+    help="Create fast-agent quickstarts",
     no_args_is_help=False,  # Allow showing our custom help instead
 )
 console = Console()
@@ -64,14 +64,15 @@ EXAMPLE_TYPES = {
         "Demonstrates collecting structured data with forms, AI-guided workflows,\n"
         "and custom handlers. Creates examples in an 'elicitations' subdirectory.",
         "files": [
+            "elicitation_account_server.py",
+            "elicitation_forms_server.py",
+            "elicitation_game_server.py",
+            "fastagent.config.yaml",
+            "fastagent.secrets.yaml.example",
             "forms_demo.py",
-            "account_creation.py",
             "game_character.py",
             "game_character_handler.py",
-            "elicitation_server.py",
-            "fastagent.config.yaml",
-            "fastagent.secrets.yaml.example",
-            "README.md",
+            "tool_call.py",
         ],
         "create_subdir": True,
     },
@@ -226,7 +227,7 @@ def copy_example_files(example_type: str, target_dir: Path, force: bool = False)
 
 def show_overview() -> None:
     """Display an overview of available examples in a nicely formatted table."""
-    console.print("\n[bold cyan]fast-agent Example Applications[/bold cyan]")
+    console.print("\n[bold cyan]fast-agent quickstarts[/bold cyan]")
     console.print("Build agents and compose workflows through practical examples\n")
 
     # Create a table for better organization
@@ -236,31 +237,23 @@ def show_overview() -> None:
     table.add_column("Files")
 
     for name, info in EXAMPLE_TYPES.items():
-        files_list = "\n".join(f"• {f}" for f in info["files"])
+        # Just show file count instead of listing all files
+        file_count = len(info["files"])
+        files_summary = f"{file_count} files"
         if "mount_point_files" in info:
-            files_list += "\n[blue]mount-point:[/blue]\n" + "\n".join(
-                f"• {f}" for f in info["mount_point_files"]
-            )
-        table.add_row(f"[green]{name}[/green]", info["description"], files_list)
+            mount_count = len(info["mount_point_files"])
+            files_summary += f"\n+ {mount_count} data files"
+        table.add_row(f"[green]{name}[/green]", info["description"], files_summary)
 
     console.print(table)
 
     # Show usage instructions in a panel
     usage_text = (
-        "[bold]Commands:[/bold]\n"
-        "  fastagent quickstart workflow DIR       Create workflow examples in DIR\n"
-        "  fastagent quickstart researcher DIR     Create researcher example in 'researcher' subdirectory\n"
-        "  fastagent quickstart data-analysis DIR  Create data analysis examples in 'data-analysis' subdirectory\n"
-        "  fastagent quickstart state-transfer DIR Create state transfer examples in 'state-transfer' subdirectory\n"
-        "  fastagent quickstart elicitations DIR   Create elicitation form examples in 'elicitations' subdirectory\n\n"
+        "[bold]Usage:[/bold]\n"
+        "  [cyan]fast-agent[/cyan] [green]quickstart[/green] [yellow]<name>[/yellow] [dim]\\[directory][/dim]\n\n"
+        "[dim]directory optionally overrides the default subdirectory name[/dim]\n\n"
         "[bold]Options:[/bold]\n"
-        "  --force            Overwrite existing files\n\n"
-        "[bold]Examples:[/bold]\n"
-        "  fastagent quickstart workflow .              Create in current directory\n"
-        "  fastagent quickstart researcher .            Create in researcher subdirectory\n"
-        "  fastagent quickstart data-analysis . --force Force overwrite files in data-analysis subdirectory\n"
-        "  fastagent quickstart state-transfer .        Create state transfer examples\n"
-        "  fastagent quickstart elicitations .          Create interactive form examples"
+        "  [cyan]--force[/cyan]            Overwrite existing files"
     )
     console.print(Panel(usage_text, title="Usage", border_style="blue"))
 
@@ -402,6 +395,6 @@ def _show_completion_message(example_type: str, created: list[str]) -> None:
 
 @app.callback(invoke_without_command=True)
 def main(ctx: typer.Context) -> None:
-    """Create example applications and learn FastAgent patterns."""
+    """Quickstart applications for fast-agent."""
     if ctx.invoked_subcommand is None:
         show_overview()

{fast_agent_mcp-0.2.37 → fast_agent_mcp-0.2.39}/src/mcp_agent/human_input/elicitation_form.py

@@ -302,7 +302,7 @@ class ElicitationForm:
         def submit_alt(event):
             self._accept()
 
-        @kb.add("escape")
+        @kb.add("escape", eager=True)
         def cancel(event):
             self._cancel()
 

fast_agent_mcp-0.2.37/examples/mcp/elicitations/README.md

@@ -1,157 +0,0 @@
-# Quick Start: MCP Elicitations
-
-This quickstart demonstrates **fast-agent**'s elicitation feature - a powerful way to collect structured data from users through forms and interactive prompts.
-
-## What are Elicitations?
-
-Elicitations allow MCP servers to request structured input from users through type-safe forms. This enables:
-- User preference collection
-- Account registration flows  
-- Configuration wizards
-- Interactive feedback forms
-- Any scenario requiring structured user input
-
-## Examples Included
-
-### 1. Forms Demo (`forms_demo.py`)
-A showcase of different form types with beautiful rich console output. Uses the passthrough model to display forms directly to users.
-
-```bash
-uv run forms_demo.py
-```
-
-This example demonstrates:
-- User profile collection
-- Preference settings
-- Simple yes/no ratings
-- Detailed feedback forms
-
-### 2. Account Creation Assistant (`account_creation.py`)
-An AI-powered account creation workflow where the LLM initiates the account signup process and the user fills out the form.
-
-```bash
-# Configure your LLM first (edit fastagent.config.yaml)
-uv run account_creation.py --model gpt-4o
-```
-
-This example shows:
-- LLM initiating elicitation via tool calls
-- User filling out the form (not the LLM)
-- Tool call errors when user cancels/declines
-- Success handling when form is completed
-
-### 3. Game Character Creator (`game_character.py` + `game_character_handler.py`)
-A whimsical example with custom elicitation handling, featuring animated dice rolls and visual effects.
-
-```bash
-uv run game_character.py
-```
-
-Features:
-- Custom elicitation handler (in separate module for clarity)
-- Animated progress bars and typewriter effects
-- Epic dice roll mechanics with cosmic bonuses
-- Interactive character creation with theatrical flair
-- Demonstrates proper handler file organization
-
-## Getting Started
-
-1. **Setup your environment:**
-   ```bash
-   # Activate your Python environment
-   source .venv/bin/activate  # or .venv\Scripts\activate on Windows
-   
-   # Install dependencies if needed
-   uv pip install fast-agent-mcp
-   ```
-
-2. **For the account creation example**, rename `fastagent.secrets.yaml.example` to `fastagent.secrets.yaml` and add your API keys.
-
-3. **Run an example:**
-   ```bash
-   # Try the forms demo first (quiet mode enabled programmatically)
-   uv run forms_demo.py
-   ```
-
-## How Elicitations Work
-
-### Elicitation Modes
-
-**fast-agent** supports these elicitation modes:
-
-1. **`forms`** - Shows forms to users (great with passthrough model)
-2. **`auto_cancel`** - Automatically cancels all elicitations
-3. **`none`** - No elicitation handling
-4. **Custom handler** - Use your own handler function (overrides mode setting)
-
-Configure modes in `fastagent.config.yaml`:
-
-```yaml
-mcp:
-  servers:
-    my_server:
-      command: "uv"
-      args: ["run", "server.py"]
-      elicitation:
-        mode: "forms"  # or "auto" or "custom"
-```
-
-### Creating Your Own Elicitations
-
-#### Basic Server-Side Elicitation
-
-```python
-from pydantic import BaseModel, Field
-
-class UserPrefs(BaseModel):
-    theme: str = Field(
-        description="Color theme",
-        json_schema_extra={
-            "enum": ["light", "dark"],
-            "enumNames": ["Light Mode", "Dark Mode"]
-        }
-    )
-    notifications: bool = Field(True, description="Enable notifications?")
-
-# In your MCP server:
-result = await mcp.get_context().elicit(
-    "Configure your preferences",
-    schema=UserPrefs
-)
-```
-
-#### Custom Elicitation Handler
-
-For advanced interactive experiences, create a custom handler:
-
-```python
-async def my_custom_handler(context, params) -> ElicitResult:
-    # Your custom logic here - animations, special effects, etc.
-    content = {"field": "value"}
-    return ElicitResult(action="accept", content=content)
-
-# Register with your agent:
-@fast.agent(
-    "my-agent",
-    servers=["my_server"],
-    elicitation_handler=my_custom_handler
-)
-```
-
-See `game_character_handler.py` for a complete example with animations and effects.
-
-## Next Steps
-
-- Explore the example code to understand different patterns
-- Try modifying the forms in `elicitation_server.py`
-- Create your own custom elicitation handlers
-- Check the [documentation](https://fast-agent.ai) for advanced features
-
-## Tips
-
-- Use `rich` for beautiful console output
-- Test with passthrough model first, then try real LLMs
-- Custom handlers enable creative interactions
-- Validate user input in your schemas using Pydantic
-
-Happy form building! 🚀

fast_agent_mcp-0.2.37/src/mcp_agent/resources/examples/mcp/elicitations/README.md

@@ -1,157 +0,0 @@
-# Quick Start: MCP Elicitations
-
-This quickstart demonstrates **fast-agent**'s elicitation feature - a powerful way to collect structured data from users through forms and interactive prompts.
-
-## What are Elicitations?
-
-Elicitations allow MCP servers to request structured input from users through type-safe forms. This enables:
-- User preference collection
-- Account registration flows  
-- Configuration wizards
-- Interactive feedback forms
-- Any scenario requiring structured user input
-
-## Examples Included
-
-### 1. Forms Demo (`forms_demo.py`)
-A showcase of different form types with beautiful rich console output. Uses the passthrough model to display forms directly to users.
-
-```bash
-uv run forms_demo.py
-```
-
-This example demonstrates:
-- User profile collection
-- Preference settings
-- Simple yes/no ratings
-- Detailed feedback forms
-
-### 2. Account Creation Assistant (`account_creation.py`)
-An AI-powered account creation workflow where the LLM initiates the account signup process and the user fills out the form.
-
-```bash
-# Configure your LLM first (edit fastagent.config.yaml)
-uv run account_creation.py --model gpt-4o
-```
-
-This example shows:
-- LLM initiating elicitation via tool calls
-- User filling out the form (not the LLM)
-- Tool call errors when user cancels/declines
-- Success handling when form is completed
-
-### 3. Game Character Creator (`game_character.py` + `game_character_handler.py`)
-A whimsical example with custom elicitation handling, featuring animated dice rolls and visual effects.
-
-```bash
-uv run game_character.py
-```
-
-Features:
-- Custom elicitation handler (in separate module for clarity)
-- Animated progress bars and typewriter effects
-- Epic dice roll mechanics with cosmic bonuses
-- Interactive character creation with theatrical flair
-- Demonstrates proper handler file organization
-
-## Getting Started
-
-1. **Setup your environment:**
-   ```bash
-   # Activate your Python environment
-   source .venv/bin/activate  # or .venv\Scripts\activate on Windows
-   
-   # Install dependencies if needed
-   uv pip install fast-agent-mcp
-   ```
-
-2. **For the account creation example**, rename `fastagent.secrets.yaml.example` to `fastagent.secrets.yaml` and add your API keys.
-
-3. **Run an example:**
-   ```bash
-   # Try the forms demo first (quiet mode enabled programmatically)
-   uv run forms_demo.py
-   ```
-
-## How Elicitations Work
-
-### Elicitation Modes
-
-**fast-agent** supports these elicitation modes:
-
-1. **`forms`** - Shows forms to users (great with passthrough model)
-2. **`auto_cancel`** - Automatically cancels all elicitations
-3. **`none`** - No elicitation handling
-4. **Custom handler** - Use your own handler function (overrides mode setting)
-
-Configure modes in `fastagent.config.yaml`:
-
-```yaml
-mcp:
-  servers:
-    my_server:
-      command: "uv"
-      args: ["run", "server.py"]
-      elicitation:
-        mode: "forms"  # or "auto" or "custom"
-```
-
-### Creating Your Own Elicitations
-
-#### Basic Server-Side Elicitation
-
-```python
-from pydantic import BaseModel, Field
-
-class UserPrefs(BaseModel):
-    theme: str = Field(
-        description="Color theme",
-        json_schema_extra={
-            "enum": ["light", "dark"],
-            "enumNames": ["Light Mode", "Dark Mode"]
-        }
-    )
-    notifications: bool = Field(True, description="Enable notifications?")
-
-# In your MCP server:
-result = await mcp.get_context().elicit(
-    "Configure your preferences",
-    schema=UserPrefs
-)
-```
-
-#### Custom Elicitation Handler
-
-For advanced interactive experiences, create a custom handler:
-
-```python
-async def my_custom_handler(context, params) -> ElicitResult:
-    # Your custom logic here - animations, special effects, etc.
-    content = {"field": "value"}
-    return ElicitResult(action="accept", content=content)
-
-# Register with your agent:
-@fast.agent(
-    "my-agent",
-    servers=["my_server"],
-    elicitation_handler=my_custom_handler
-)
-```
-
-See `game_character_handler.py` for a complete example with animations and effects.
-
-## Next Steps
-
-- Explore the example code to understand different patterns
-- Try modifying the forms in `elicitation_server.py`
-- Create your own custom elicitation handlers
-- Check the [documentation](https://fast-agent.ai) for advanced features
-
-## Tips
-
-- Use `rich` for beautiful console output
-- Test with passthrough model first, then try real LLMs
-- Custom handlers enable creative interactions
-- Validate user input in your schemas using Pydantic
-
-Happy form building! 🚀