fast-agent-mcp 0.2.37__py3-none-any.whl → 0.2.38__py3-none-any.whl

{fast_agent_mcp-0.2.37.dist-info → fast_agent_mcp-0.2.38.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.37
+Version: 0.2.38
 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.dist-info → fast_agent_mcp-0.2.38.dist-info}/RECORD

@@ -24,7 +24,7 @@ mcp_agent/cli/main.py,sha256=XjrgXMBaPKkVqAFo8T9LJz6Tp1-ivrKDOuNYWke99YA,3090
 mcp_agent/cli/terminal.py,sha256=GRwD-RGW7saIz2IOWZn5vD6JjiArscELBThm1GTFkuI,1065
 mcp_agent/cli/commands/check_config.py,sha256=JKOHniuMlU1bJ5vmyY7g05HDP7ZYGSQktl19bNx5I4Y,18775
 mcp_agent/cli/commands/go.py,sha256=LIsOJQuTdfCUcNm7JT-NQDU8cI-GCnYwYjN2VOWxvqs,8658
-mcp_agent/cli/commands/quickstart.py,sha256=QSL_LaXMutDJX4GObLHZ8ItaimxI6AY53K5wtwBw4cI,17071
+mcp_agent/cli/commands/quickstart.py,sha256=e4JkGwKGXxVn2yODn50NBxr5-49gqo_3IJVZTVOSPG4,17127
 mcp_agent/cli/commands/setup.py,sha256=eOEd4TL-b0DaDeSJMGOfNOsTEItoZ67W88eTP4aP-bo,6482
 mcp_agent/cli/commands/url_parser.py,sha256=5VdtcHRHzi67YignStVbz7u-rcvNNErw9oJLAUFOtEY,5855
 mcp_agent/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -127,7 +127,6 @@ mcp_agent/resources/examples/data-analysis/analysis-campaign.py,sha256=16gxrQ5kM
 mcp_agent/resources/examples/data-analysis/analysis.py,sha256=UaZk8RzsIj0TVXIM1kx71nfC_mlyJo-wAXlIHnrXH1I,2578
 mcp_agent/resources/examples/data-analysis/fastagent.config.yaml,sha256=ini94PHyJCfgpjcjHKMMbGuHs6LIj46F1NwY0ll5HVk,1609
 mcp_agent/resources/examples/data-analysis/mount-point/WA_Fn-UseC_-HR-Employee-Attrition.csv,sha256=pcMeOL1_r8m8MziE6xgbBrQbjl5Ijo98yycZn7O-dlk,227977
-mcp_agent/resources/examples/mcp/elicitations/README.md,sha256=sNYltJ89sORFl3Id-UFF4lZfpkxLSN_tGtpd0PgBDug,4474
 mcp_agent/resources/examples/mcp/elicitations/elicitation_account_server.py,sha256=ZrPcj0kv75QXvtN0J_vhCmwxycnAodv35adUBZ9_8Ss,2903
 mcp_agent/resources/examples/mcp/elicitations/elicitation_forms_server.py,sha256=n-qVogV2I0GYGwYe-8PG1DEvp4M3JzKHoYmemMEm6Ic,8831
 mcp_agent/resources/examples/mcp/elicitations/elicitation_game_server.py,sha256=z9kHdNc6XWjAWkvet7inVBIcYxfWoxU6n9iHrsEqU7A,6206
@@ -157,8 +156,8 @@ mcp_agent/resources/examples/workflows/short_story.md,sha256=XN9I2kzCcMmke3dE5F2
 mcp_agent/resources/examples/workflows/short_story.txt,sha256=X3y_1AyhLFN2AKzCKvucJtDgAFIJfnlbsbGZO5bBWu0,1187
 mcp_agent/tools/tool_definition.py,sha256=L3Pxl-uLEXqlVoo-bYuFTFALeI-2pIU44YgFhsTKEtM,398
 mcp_agent/ui/console_display.py,sha256=UKqax5V2TC0hkZZORmmd6UqUk0DGX7A25E3h1k9f42k,10982
-fast_agent_mcp-0.2.37.dist-info/METADATA,sha256=z1g7JwTXMAtWke8OD10kMWgGzJoD9LHNZtoi-a8YASA,30983
-fast_agent_mcp-0.2.37.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.2.37.dist-info/entry_points.txt,sha256=oKQeSUVn87pJv8_k1NQ7Ak8cXaaXHCnPAOJRCV_uUVg,230
-fast_agent_mcp-0.2.37.dist-info/licenses/LICENSE,sha256=Gx1L3axA4PnuK4FxsbX87jQ1opoOkSFfHHSytW6wLUU,10935
-fast_agent_mcp-0.2.37.dist-info/RECORD,,
+fast_agent_mcp-0.2.38.dist-info/METADATA,sha256=oFNrGrMZRDaOR125GzE7PhnjsMxTJGv2vD75Bz_suNY,30983
+fast_agent_mcp-0.2.38.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.2.38.dist-info/entry_points.txt,sha256=oKQeSUVn87pJv8_k1NQ7Ak8cXaaXHCnPAOJRCV_uUVg,230
+fast_agent_mcp-0.2.38.dist-info/licenses/LICENSE,sha256=Gx1L3axA4PnuK4FxsbX87jQ1opoOkSFfHHSytW6wLUU,10935
+fast_agent_mcp-0.2.38.dist-info/RECORD,,

mcp_agent/cli/commands/quickstart.py

@@ -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,
     },
@@ -252,7 +253,7 @@ def show_overview() -> None:
         "  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"
+        "  fastagent quickstart elicitations DIR   Create elicitation examples in 'elicitations' subdirectory\n\n"
         "[bold]Options:[/bold]\n"
         "  --force            Overwrite existing files\n\n"
         "[bold]Examples:[/bold]\n"
@@ -260,7 +261,7 @@ def show_overview() -> None:
         "  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"
+        "  fastagent quickstart elicitations .          Create elicitation form examples"
     )
     console.print(Panel(usage_text, title="Usage", border_style="blue"))
 

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! 🚀