fast-agent-mcp 0.0.7__py3-none-any.whl → 0.0.8__py3-none-any.whl

{fast_agent_mcp-0.0.7.dist-info → fast_agent_mcp-0.0.8.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.0.7
-Summary: Build, Test, Deploy composable MCP Agent Workflows.
+Version: 0.0.8
+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
                                    Version 2.0, January 2004
@@ -219,7 +219,6 @@ Requires-Dist: opentelemetry-distro>=0.50b0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.29.0
 Requires-Dist: pydantic-settings>=2.7.0
 Requires-Dist: pydantic>=2.10.4
-Requires-Dist: pyreadline3>=3.5.4
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=13.9.4
 Requires-Dist: scikit-learn>=1.6.0
@@ -238,35 +237,37 @@ Description-Content-Type: text/markdown
 ## FastAgent
 
 <p align="center">
-<a href="https://pypi.org/project/mcp-agent/"><img src="https://img.shields.io/pypi/v/mcp-agent?color=%2334D058&label=pypi" /></a>
-<a href="https://github.com/lastmile-ai/mcp-agent/issues"><img src="https://img.shields.io/github/issues-raw/lastmile-ai/mcp-agent" /></a>
+<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>
+<a href="https://github.com/evalstate/fast-agent/issues"><img src="https://img.shields.io/github/issues-raw/evalstate/fast-agent" /></a>
 <a href="https://lmai.link/discord/mcp-agent"><img src="https://shields.io/discord/1089284610329952357" alt="discord" /></a>
-<img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/mcp-agent?label=pypi%20%7C%20downloads"/>
-<a href="https://github.com/lastmile-ai/mcp-agent/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/mcp-agent" /></a>
+<img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/fast-agent-mcp?label=pypi%20%7C%20downloads"/>
+<a href="https://github.com/evalstate/fast-agent-mcp/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/fast-agent-mcp" /></a>
 </p>
 
 ## Overview
 
-**`mcp-agent`** is a simple, composable framework to build agents using [Model Context Protocol](https://modelcontextprotocol.io/introduction).
+**`fast-agent`** lets you define, test and compose agents and tools in minutes. 
 
-**Inspiration**: Anthropic announced 2 foundational updates for AI application developers:
+### Get started:
 
-1. [Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) - a standardized interface to let any software be accessible to AI assistants via MCP servers.
-2. [Building Effective Agents](https://www.anthropic.com/research/building-effective-agents) - a seminal writeup on simple, composable patterns for building production-ready AI agents.
+Install the [uv package manager](https://docs.astral.sh/uv/).
 
-`mcp-agent` puts these two foundational pieces into an AI application framework:
+`uv pip install fast-agent-mcp` - download fast-agent
 
-1. It handles the pesky business of managing the lifecycle of MCP server connections so you don't have to.
-2. It implements every pattern described in Building Effective Agents, and does so in a _composable_ way, allowing you to chain these patterns together.
-3. **Bonus**: It implements [OpenAI's Swarm](https://github.com/openai/swarm) pattern for multi-agent orchestration, but in a model-agnostic way.
+`fast-agent setup` - setup an agent and configuration files.
 
-Altogether, this is the simplest and easiest way to build robust agent applications. Much like MCP, this project is in early development.
-We welcome all kinds of [contributions](/CONTRIBUTING.md), feedback and your help in growing this to become a new standard.
+`uv run agent.py` - run and interact with your first agent.
+
+`fast-agent bootstrap workflow` - generate example agents demonstrating each of the workflows from Anthropic's "[Building Effective Agents](https://www.anthropic.com/research/building-effective-agents)" paper.
+
+It's built on top of [mcp-agent](todo).
 
 ### llmindset.co.uk fork:
 
-- "FastAgent" style prototyping
-- Interactive Mode
+- "FastAgent" style prototyping, with per-agent models
+- Warm-up / Post-Workflow Agent Interactions
+- Quick Setup
+- Interactive Prompt Mode
 - Simple Model Selection with aliases
 - User/Assistant and Tool Call message display
 - MCP Sever Environment Variable support
@@ -274,49 +275,13 @@ We welcome all kinds of [contributions](/CONTRIBUTING.md), feedback and your hel
 - Comprehensive Progress display
 - JSONL file logging with secret revokation
 - OpenAI o1/o3-mini support with reasoning level
-- Enhaned Human Input Messaging and Handling
+- Enhanced Human Input Messaging and Handling
+- Declarative workflows
 
 ## Get Started
 
 We recommend using [uv](https://docs.astral.sh/uv/) to manage your Python projects:
 
-```bash
-uv add "mcp-agent"
-```
-
-Alternatively:
-
-```bash
-pip install mcp-agent
-```
-
-### Quickstart
-
-> [!TIP]
-> The [`examples`](/examples) directory has several example applications to get started with.
-> To run an example, clone this repo, then:
->
-> ```bash
-> cd examples/mcp_basic_agent # Or any other example
-> cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml # Update API keys
-> uv run main.py
-> ```
-
 ## Table of Contents
 
-## Workflows
-
-mcp-agent provides implementations for every pattern in Anthropic’s [Building Effective Agents](https://www.anthropic.com/research/building-effective-agents), as well as the OpenAI [Swarm](https://github.com/openai/swarm) pattern.
-Each pattern is model-agnostic, and exposed as an `AugmentedLLM`, making everything very composable.
-
-</details>
-
-### Signaling and Human Input
-
-**Signaling**: The framework can pause/resume tasks. The agent or LLM might “signal” that it needs user input, so the workflow awaits. A developer may signal during a workflow to seek approval or review before continuing with a workflow.
-
-**Human Input**: If an Agent has a `human_input_callback`, the LLM can call a `__human_input__` tool to request user input mid-workflow.
-
-## Contributing
-
 We welcome any and all kinds of contributions. Please see the [CONTRIBUTING guidelines](./CONTRIBUTING.md) to get started.

{fast_agent_mcp-0.0.7.dist-info → fast_agent_mcp-0.0.8.dist-info}/RECORD

@@ -1,22 +1,25 @@
 mcp_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_agent/app.py,sha256=QbOBEo7vfVqf5U0F44UawIcYZjPT8KZj2uMOHC4W2lQ,10420
+mcp_agent/app.py,sha256=LJ8-9_hTnDOjX0KxRYRu9OPqDcj-fAQSSfS4Oo2m0D8,10550
 mcp_agent/config.py,sha256=mShpoyIAGeyQKMH9gUCAXBZ2HNF3SM2KoMjSMpPQnmg,10210
 mcp_agent/console.py,sha256=Gjf2QLFumwG1Lav__c07X_kZxxEUSkzV-1_-YbAwcwo,813
 mcp_agent/context.py,sha256=qzwUrexZXVBzFiNkYI4xjztdGxuuiDWZbWrQgVhA-vE,8126
 mcp_agent/context_dependent.py,sha256=TGqRLzYCOnsWGoaD1HtrliYtWo8MeaWCQk6ePUmyYCw,1446
-mcp_agent/event_progress.py,sha256=GL3peoEnDx_mdOCeCCVRqZOCSqUDVi_JRfrl_24oD-4,2488
+mcp_agent/event_progress.py,sha256=uolrsdEuXQ8_8iAspb_w3HHp_yY22QfVyysuQaAhnOg,2641
 mcp_agent/mcp_server_registry.py,sha256=5x30L1IlmC18JASl7NQbZYHMqPWS3ay0f_3U3uleaMM,9884
 mcp_agent/progress_display.py,sha256=GeJU9VUt6qKsFVymG688hCMVCsAygG9ifiiEb5IcbN4,361
 mcp_agent/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_agent/agents/agent.py,sha256=0NRcOk4u8e9dbAo9NKHIZzl5Brm_NtW08bW3sNuPn5A,9686
+mcp_agent/agents/agent.py,sha256=utMR_QWKD1_MqWE_fYY-xqUMKtGlekW0laJfduU6Ckw,9831
 mcp_agent/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/cli/__main__.py,sha256=bhxe66GYqy0q78OQhi7dkuubY1Tn0bQL6hU5Nn47E34,73
 mcp_agent/cli/main.py,sha256=wyOvUg0BihD1NpoiFcIaOruevgaHxs1-Xy_bnwb1Ik4,2449
 mcp_agent/cli/terminal.py,sha256=5fqrKlJvIpKEuvpvZ653OueQSYFFktBEbosjr2ucMUc,1026
-mcp_agent/cli/commands/bootstrap.py,sha256=fCso2NxcokA_wGg3RHoUKVKiGxxlSv2X74nsvN1oskA,7503
+mcp_agent/cli/commands/bootstrap.py,sha256=mVng2bZPKfVEULrOPI7sQQaENAJwU-3SsGZb10mbu6Q,10614
 mcp_agent/cli/commands/config.py,sha256=32YTS5jmsYAs9QzAhjkG70_daAHqOemf4XbZBBSMz6g,204
-mcp_agent/cli/commands/setup.py,sha256=nmiAgYvgGbOkFPbZNeMl-pgLo50NeP4HKb60YhmJbqg,6024
-mcp_agent/core/fastagent.py,sha256=BG4BqXZkiMQa_VwljU4ciQbmYtn3TwbMQX4jkF-uaO0,36504
+mcp_agent/cli/commands/setup.py,sha256=Km4-EFJljjMU5XjsSa-srg_7lbPuH5e40sx4lQDkia4,6198
+mcp_agent/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_agent/core/exceptions.py,sha256=xDdhYh83ni3t0NiXQTEL0_Yyx0qQxBPQL1gSwRToeaw,1469
+mcp_agent/core/fastagent.py,sha256=WuT0B9XpGM7XowJivNkRcIm-0BthlObVtoNwcBaNKCA,40641
+mcp_agent/core/server_validation.py,sha256=_59cn16nNT4HGPwg19HgxMtHK4MsdWYDUw_CuL-5xek,1696
 mcp_agent/eval/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/executor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/executor/decorator_registry.py,sha256=eONv5WvIcjKd43jVqeP7iB2EkAK-ErhdmXt6ogN0K_w,3848
@@ -33,7 +36,7 @@ mcp_agent/logging/events.py,sha256=qfYJnrqgXdujV-nl-iOwBEBh6HMraowBI4zeAWPPU4A,3
 mcp_agent/logging/json_serializer.py,sha256=pa_mf0i0YKpLsGq3THuITFUdAbmae-dv1OPOLbcS0to,5782
 mcp_agent/logging/listeners.py,sha256=lx2Pq_SE0rsG3nF3TwDSxkmsWzdXxIUjuaWct-KOtJ8,6631
 mcp_agent/logging/logger.py,sha256=Tr009BnfGUKuZcdinnSin0Z_zIsfDNGdcnamw2rDHRQ,10604
-mcp_agent/logging/rich_progress.py,sha256=-GTOKZsa3KPsebfjCCkoGRyILGxDkDFPSfJyUk-8ia0,4142
+mcp_agent/logging/rich_progress.py,sha256=ExVCEPfk01BaspOy60o5rnsfnr1aT6UKO0OWGDXYT5s,4560
 mcp_agent/logging/tracing.py,sha256=jQivxKYl870oXakmyUk7TXuTQSvsIzpHwZlSQfy4b0c,5203
 mcp_agent/logging/transport.py,sha256=Oo7Rx5t7REZTnH-uVljK0JlehnBj-wInc_fx0zhd_zY,16139
 mcp_agent/mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -42,16 +45,19 @@ mcp_agent/mcp/mcp_activity.py,sha256=CajXCFWZ2cKEX9s4-HfNVAj471ePTVs4NOkvmIh65tE
 mcp_agent/mcp/mcp_agent_client_session.py,sha256=NtWcQhjmnnaR3yYcYj2d2lh-m563NexZUa57K1tAjeM,9477
 mcp_agent/mcp/mcp_agent_server.py,sha256=xP09HZTeguJi4Fq0p3fjLBP55uSYe5AdqM90xCgn9Ho,1639
 mcp_agent/mcp/mcp_aggregator.py,sha256=SQNErk20jTT_5cHTQ9zQBYEsAedd6QEweQj-YSzkdOo,14602
-mcp_agent/mcp/mcp_connection_manager.py,sha256=PfDH7fHMk-D3m-DxHsWU0PdcuXJ9rInxMA0-yC6Hv2U,11392
+mcp_agent/mcp/mcp_connection_manager.py,sha256=tdz2B2BxmO2gBDPe4r6eEnUp4QpwD0p0-ag5J_hle-w,11750
 mcp_agent/mcp/stdio.py,sha256=tW075R5rQ-UlflXWFKIFDgCbWbuhKqxhiYolWvyEkFs,3985
-mcp_agent/resources/examples/decorator/main.py,sha256=nHJ33S9icOQPHTzXYQ_bPQclAiVLNdzIHQ3uAiecVhU,712
-mcp_agent/resources/examples/decorator/optimizer.py,sha256=Mwz3Vgc01vqdAKeboZWHWyeWIi9rWx_xeNpKswb58fc,3378
-mcp_agent/resources/examples/decorator/orchestrator.py,sha256=yaga9f4CyZ6Ex_KHYUzp8gxramNBcWTJ2f6oVkp1hj0,2770
-mcp_agent/resources/examples/decorator/parallel.py,sha256=Jq1HI8j6_smVva6wRKKbgxzE7R48ZbQ9HtAkXisVg1E,3221
-mcp_agent/resources/examples/decorator/router.py,sha256=ZBHUbsoBXHHa1UD8sogF29Tl5NvMFv37H2i8W9ooZnw,1806
-mcp_agent/resources/examples/decorator/tiny.py,sha256=YCNdiNehOTU0B_-RSeI2LDqa00AZWod2_w39pWd0or0,490
-mcp_agent/resources/examples/mcp_researcher/main-evalopt.py,sha256=NI1vujVuLeTrcF8dM_ipZZ3Tg-1AL35CaltmuzxWrU4,1807
-mcp_agent/resources/examples/mcp_researcher/main.py,sha256=jPRafm7jbpHKkX_dQiYGG3Sw-e1Dm86q-JZT-WZDhM0,1425
+mcp_agent/resources/examples/data-analysis/analysis.py,sha256=LrfbuK68JqcB9Y21NMedJ8RiEVU5Kr6jOIRLGmwz524,1379
+mcp_agent/resources/examples/data-analysis/fastagent.config.yaml,sha256=VwoXyaxAuLNUm7dtRj5rTxeFDSM_wRhhX_HZunb8jUI,422
+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_researcher/researcher-eval.py,sha256=NI1vujVuLeTrcF8dM_ipZZ3Tg-1AL35CaltmuzxWrU4,1807
+mcp_agent/resources/examples/mcp_researcher/researcher.py,sha256=jPRafm7jbpHKkX_dQiYGG3Sw-e1Dm86q-JZT-WZDhM0,1425
+mcp_agent/resources/examples/workflows/chaining.py,sha256=o9vf45BtJP6PT7kCYfIyNTcJrVGnMeKCUD37vI0cepw,770
+mcp_agent/resources/examples/workflows/evaluator.py,sha256=ByILFY7PsA8UXtmNa4YtLIGSsnVfZVjKlHGH9G0ie2I,3069
+mcp_agent/resources/examples/workflows/human_input.py,sha256=RlUch5A8N9pb3REusiIAZKfAGTxWWE82s1Npmkfbg1Y,625
+mcp_agent/resources/examples/workflows/orchestrator.py,sha256=pt6HTyJl5r5zR6FUICi05-Eaulyh_W-PAfh9XCbuuRc,2986
+mcp_agent/resources/examples/workflows/parallel.py,sha256=cNYcIcsdo0-KK-S7KEPCc11aWELeVlQJdJ2LIC9xgDs,3090
+mcp_agent/resources/examples/workflows/router.py,sha256=XT_ewCrxPxdUTMCYQGw34qZQ3GGu8TYY_v5Lige8By4,1707
 mcp_agent/telemetry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/telemetry/usage_tracking.py,sha256=ePujKMSjPxB7k6X34DGaVlnsV1728mcWZq38OqahiCU,501
 mcp_agent/workflows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -71,8 +77,8 @@ mcp_agent/workflows/intent_classifier/intent_classifier_llm_anthropic.py,sha256=
 mcp_agent/workflows/intent_classifier/intent_classifier_llm_openai.py,sha256=zj76WlTYnSCYjBQ_IDi5vFBQGmNwYaoUq1rT730sY98,1940
 mcp_agent/workflows/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/workflows/llm/augmented_llm.py,sha256=o5Vdn1sAgVBhmetilbiYJuVz5BAtEhNcwGMEBGNzU_A,22960
-mcp_agent/workflows/llm/augmented_llm_anthropic.py,sha256=JrgwAdY569qsNrh5UeIJbUl8yctGN-BFv3XClwD4oXM,19365
-mcp_agent/workflows/llm/augmented_llm_openai.py,sha256=hxTw0LMhNnu09mF4M6Z7expwRJHNk9utq4VqqcLqJ9A,22980
+mcp_agent/workflows/llm/augmented_llm_anthropic.py,sha256=jowYvWBdVspxQhcvZt14iL_1kEZK2t4f6Wzgn_8zLaY,21048
+mcp_agent/workflows/llm/augmented_llm_openai.py,sha256=RqsbX0Fc5By1AvQ2N85hxzz0d84mVwuPggslxwqSJVM,24190
 mcp_agent/workflows/llm/llm_selector.py,sha256=G7pIybuBDwtmyxUDov_QrNYH2FoI0qFRu2JfoxWUF5Y,11045
 mcp_agent/workflows/llm/model_factory.py,sha256=cAjG8UxzUC_wcB6mPaMfEhwnGnVS4-IOmOXDabO1_0g,6119
 mcp_agent/workflows/orchestrator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -93,8 +99,8 @@ mcp_agent/workflows/swarm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 mcp_agent/workflows/swarm/swarm.py,sha256=-lAIeSWDqbGHGRPTvjiP9nIKWvxxy9DAojl9yQzO1Pw,11050
 mcp_agent/workflows/swarm/swarm_anthropic.py,sha256=pW8zFx5baUWGd5Vw3nIDF2oVOOGNorij4qvGJKdYPcs,1624
 mcp_agent/workflows/swarm/swarm_openai.py,sha256=wfteywvAGkT5bLmIxX_StHJq8144whYmCRnJASAjOes,1596
-fast_agent_mcp-0.0.7.dist-info/METADATA,sha256=H8C_2qY8kSMD0x-zBrlO8legmofje3p5ra-yDfCukAI,17770
-fast_agent_mcp-0.0.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.0.7.dist-info/entry_points.txt,sha256=2IXtSmDK9XjWN__RWuRIJTgWyW17wJnJ_h-pb0pZAxo,174
-fast_agent_mcp-0.0.7.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
-fast_agent_mcp-0.0.7.dist-info/RECORD,,
+fast_agent_mcp-0.0.8.dist-info/METADATA,sha256=tPypBpbGkwNNIRHnJJF7Nn68O1bJHIdV3WFvVup3xyI,15914
+fast_agent_mcp-0.0.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.0.8.dist-info/entry_points.txt,sha256=2IXtSmDK9XjWN__RWuRIJTgWyW17wJnJ_h-pb0pZAxo,174
+fast_agent_mcp-0.0.8.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
+fast_agent_mcp-0.0.8.dist-info/RECORD,,

mcp_agent/agents/agent.py

@@ -43,6 +43,7 @@ class AgentConfig:
     model: Optional[str] = None
     use_history: bool = True
     default_request_params: Optional[RequestParams] = None
+    human_input: bool = False
 
     def __post_init__(self):
         """Ensure default_request_params exists with proper history setting"""
@@ -103,10 +104,13 @@ class Agent(MCPAggregator):
         # Map function names to tools
         self._function_tool_map: Dict[str, FastTool] = {}
 
-        self.human_input_callback: HumanInputCallback | None = human_input_callback
-        if not human_input_callback:
-            if self.context.human_input_handler:
-                self.human_input_callback = self.context.human_input_handler
+        if not self.config.human_input:
+            self.human_input_callback = None
+        else:
+            self.human_input_callback: HumanInputCallback | None = human_input_callback
+            if not human_input_callback:
+                if self.context.human_input_handler:
+                    self.human_input_callback = self.context.human_input_handler
 
     async def initialize(self):
         """

mcp_agent/app.py

@@ -154,7 +154,11 @@ class MCPApp:
                 "agent_name": "mcp_application_loop",
             },
         )
-        await cleanup_context()
+        try:
+            await cleanup_context()
+        except asyncio.CancelledError:
+            self.logger.debug("Cleanup cancelled error during shutdown")
+
         self._context = None
         self._initialized = False