fast-agent-mcp 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

{fast_agent_mcp-0.2.2.dist-info → fast_agent_mcp-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.2
+Version: 0.2.4
 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
@@ -251,6 +251,9 @@ Description-Content-Type: text/markdown
 
 ## Overview
 
+> [!TIP]
+> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not.
+
 **`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o family, o1/o3 family) are supported.
 
 The simple declarative syntax lets you concentrate on composing your Prompts and MCP Servers to [build effective agents](https://www.anthropic.com/research/building-effective-agents).
@@ -325,7 +328,6 @@ fast = FastAgent("Agent Example")
 @fast.agent(
   instruction="Given an object, respond only with an estimate of its size."
 )
-
 async def main():
   async with fast.run() as agent:
     await agent()
@@ -340,7 +342,7 @@ Specify a model with the `--model` switch - for example `uv run sizer.py --model
 
 ### Combining Agents and using MCP Servers
 
-_To generate examples use `fast-agent bootstrap workflow`. This example can be run with `uv run chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
+_To generate examples use `fast-agent bootstrap workflow`. This example can be run with `uv run workflow/chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
 
 Agents can be chained to build a workflow, using MCP Servers defined in the `fastagent.config.yaml` file:
 
@@ -357,12 +359,14 @@ Agents can be chained to build a workflow, using MCP Servers defined in the `fas
     Respond only with the post, never use hashtags.
     """,
 )
-
+@fast.chain(
+    name="post_writer",
+    sequence=["url_fetcher", "social_media"],
+)
 async def main():
     async with fast.run() as agent:
-        await agent.social_media(
-            await agent.url_fetcher("http://llmindset.co.uk/resources/mcp-hfspace/")
-        )
+        # using chain workflow
+        await agent.post_writer("http://llmindset.co.uk")
 ```
 
 All Agents and Workflows respond to `.send("message")` or `.prompt()` to begin a chat session.
@@ -370,7 +374,7 @@ All Agents and Workflows respond to `.send("message")` or `.prompt()` to begin a
 Saved as `social.py` we can now run this workflow from the command line with:
 
 ```bash
-uv run social.py --agent social_media --message "<url>"
+uv run workflow/chaining.py --agent post_writer --message "<url>"
 ```
 
 Add the `--quiet` switch to disable progress and message display and return only the final response - useful for simple automations.

{fast_agent_mcp-0.2.2.dist-info → fast_agent_mcp-0.2.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-mcp_agent/__init__.py,sha256=6ewnFA5JA8SUjWsWPVyjEQx5xfZKPbVz2WjavA55uvA,1683
+mcp_agent/__init__.py,sha256=-AIoeL4c9UAp_P4U0z-uIWTTmQWdihOis5nbQ5L_eao,1664
 mcp_agent/app.py,sha256=jBmzYM_o50g8vhlTgkkf5TGiBWNbXWViYnd0WANbpzo,10276
 mcp_agent/config.py,sha256=lI4B9VhF0qplez20cPeegxPA1ZcFBIxzepm_FOhW_08,10758
 mcp_agent/console.py,sha256=Gjf2QLFumwG1Lav__c07X_kZxxEUSkzV-1_-YbAwcwo,813
@@ -8,16 +8,16 @@ mcp_agent/event_progress.py,sha256=25iz0yyg-O4glMmtijcYpDdUmtUIKsCmR_8A52GgeC4,2
 mcp_agent/mcp_server_registry.py,sha256=r24xX4BYXj4BbWbU37uwuW9e1mFOYgpb258OMb21SaY,9928
 mcp_agent/progress_display.py,sha256=GeJU9VUt6qKsFVymG688hCMVCsAygG9ifiiEb5IcbN4,361
 mcp_agent/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_agent/agents/agent.py,sha256=yLKtYiAnXHjmjH61rkEtgZFc-9zIMKui7RPIHG-IrE8,3635
-mcp_agent/agents/base_agent.py,sha256=SEd45M5EU4UbmUvd54C0d1XCvQCClbx3apwa9DZ0_xw,19007
+mcp_agent/agents/agent.py,sha256=NKz8HTCdjIBDSJwl6EHU2NDnZcAtYiaYH3YnbVGrc3Q,3882
+mcp_agent/agents/base_agent.py,sha256=jQ91SBazFwGlwajveLvitMP5oLOQcuEXwUqwe0JPpd8,23203
 mcp_agent/agents/workflow/__init__.py,sha256=HloteEW6kalvgR0XewpiFAqaQlMPlPJYg5p3K33IUzI,25
-mcp_agent/agents/workflow/chain_agent.py,sha256=tsyWQd_USU9_N_ouUKp97ufn6rrJbxbGEzcNFHiccTA,6228
-mcp_agent/agents/workflow/evaluator_optimizer.py,sha256=vgnNGbvnnZv9vAJlyN_V0u7UCl8nu4NIJDTeo3jpjkw,13065
-mcp_agent/agents/workflow/orchestrator_agent.py,sha256=j-xulY2i1Jxry-iOJvXwUpp8-Vlhv0uZ5LknqCcMNjc,21230
+mcp_agent/agents/workflow/chain_agent.py,sha256=ff5ksaJiAm007MMl8QO4pBTTIgQLcf9GLZpRtYkfBJQ,6201
+mcp_agent/agents/workflow/evaluator_optimizer.py,sha256=ArM2CySsTY0gSPndox1DdjecRdNtWIj-Qm9ApUWkygw,13103
+mcp_agent/agents/workflow/orchestrator_agent.py,sha256=nf7_Rq3XOiLfLsZ7MHVKAMkhaWJIz5NkWe2xYFH3yqc,21409
 mcp_agent/agents/workflow/orchestrator_models.py,sha256=5P_aXADVT4Et8qT4e1cb9RelmHX5dCRrzu8j8T41Kdg,7230
 mcp_agent/agents/workflow/orchestrator_prompts.py,sha256=EXKEI174sshkZyPPEnWbwwNafzSPuA39MXL7iqG9cWc,9106
-mcp_agent/agents/workflow/parallel_agent.py,sha256=yGT0Ftg3kn1BdJ9k0Yy9tp9hcBu_99BMl9oVjJSUMWU,6866
-mcp_agent/agents/workflow/router_agent.py,sha256=PMm2fJsDekh_Bm5aQK2JOHbW-JarZ0ZFt6-4AiWdJOI,10337
+mcp_agent/agents/workflow/parallel_agent.py,sha256=denkFKrvZJZ4c3Cja9cx-EOUhd-mDO30UIU48WGMnEM,6901
+mcp_agent/agents/workflow/router_agent.py,sha256=iOIPhMP9-w-lho50obx1rvGphI_-7Hdr9E9ohlKmtJk,10484
 mcp_agent/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/cli/__main__.py,sha256=AVZ7tQFhU_sDOGuUGJq8ujgKtcxsYJBJwHbVaaiRDlI,166
 mcp_agent/cli/main.py,sha256=oumTbJPbiLFomm5IcdKJNjP3kXVkeYTxZEtYTkBBfLA,2742
@@ -26,19 +26,19 @@ mcp_agent/cli/commands/bootstrap.py,sha256=Pv3LQUQLK_5-8nbOQ6iibJI7awgD04P9xh6-V
 mcp_agent/cli/commands/config.py,sha256=jU2gl4d5YESrdUboh3u6mxf7CxVT-_DT_sK8Vuh3ajw,231
 mcp_agent/cli/commands/setup.py,sha256=iXsKrf31Szv4Umbk9JfR5as9HcivFJchhE1KKzHxyIo,6345
 mcp_agent/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_agent/core/agent_app.py,sha256=9c7V-gZKudl-6u2BB__aLEvC4iemJeWpyoI8fGpXsXk,10145
 mcp_agent/core/agent_types.py,sha256=Qyhvzy2CcD7wMaxavuMUOQnD_rg5LZ1RT3DwXVYaM1Q,1345
-mcp_agent/core/direct_agent_app.py,sha256=666Xe3ebFdNtZ2zq6YA_5ZJMupfydUldHuzCZLOiIW8,6559
 mcp_agent/core/direct_decorators.py,sha256=_kS0C9UbwRQ54z58vfUapFXXyJrm1XRVyLMuB7bL0b8,14471
-mcp_agent/core/direct_factory.py,sha256=uyPGZ20FkR1ObAARjAHHBP-dVyZG7meVZt2fdUpaUFk,17767
+mcp_agent/core/direct_factory.py,sha256=PGkQCeTd7ACd1aHwDWsPOQPyG5_NbC8U2wxzbldTJ1Q,17764
 mcp_agent/core/enhanced_prompt.py,sha256=loLFJfBgFaAxYqZednUJLLuunFiwrYQb60y1_wNJsgQ,17927
 mcp_agent/core/error_handling.py,sha256=xoyS2kLe0eG0bj2eSJCJ2odIhGUve2SbDR7jP-A-uRw,624
 mcp_agent/core/exceptions.py,sha256=ENAD_qGG67foxy6vDkIvc-lgopIUQy6O7zvNPpPXaQg,2289
-mcp_agent/core/fastagent.py,sha256=ImromTBDkkA1Lf8NPVaGHP6Qmn5BP0K9Q8SZnJQ4kHU,12025
+mcp_agent/core/fastagent.py,sha256=ttkBs2yYaZb1gsL6-iYaopSsBKUt4kVeddj16TuWZ2o,12477
 mcp_agent/core/interactive_prompt.py,sha256=04yoeOX2JLatr2tuOFfnb84GMwFUIBnBC7y1M_gqOM8,17692
-mcp_agent/core/mcp_content.py,sha256=u9x-W9JBphHySAOGOLw7dROplA-bdcZrgO5by6y2Cb4,6909
-mcp_agent/core/prompt.py,sha256=nEx_O9euFCX-o02b420MAVe6lH_IcgQRHnbFeAPrVt0,4274
+mcp_agent/core/mcp_content.py,sha256=2D7KHY9mG_vxoDwFLKvsPQV9VRIzHItM7V-jcEnACh8,8878
+mcp_agent/core/prompt.py,sha256=qnintOUGEoDPYLI9bu9G2OlgVMCe5ZPUZilgMzydXhc,7919
 mcp_agent/core/request_params.py,sha256=bEjWo86fqxdiWm2U5nPDd1uCUpcIQO9oiCinhB8lQN0,1185
-mcp_agent/core/validation.py,sha256=CLScPnMopneOCrmUppebxDFCnyovJ5xQwIL--d8WuD4,11211
+mcp_agent/core/validation.py,sha256=euK9FD7rn0px9mBMCBecWHChnZTNVIdc4452ruOTB0Q,11207
 mcp_agent/executor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/executor/decorator_registry.py,sha256=CozMdIzE1LyyBfE3_R_kuxb5yi-mi--u_czKOZRp6Dg,3832
 mcp_agent/executor/executor.py,sha256=MzLSnW9nHrLHYChR3oQa5B8dajQGX26q6-S2BJCxv0o,9507
@@ -50,11 +50,11 @@ mcp_agent/human_input/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 mcp_agent/human_input/handler.py,sha256=s712Z5ssTCwjL9-VKoIdP5CtgMh43YvepynYisiWTTA,3144
 mcp_agent/human_input/types.py,sha256=RtWBOVzy8vnYoQrc36jRLn8z8N3C4pDPMBN5vF6qM5Y,1476
 mcp_agent/llm/__init__.py,sha256=d8zgwG-bRFuwiMNMYkywg_qytk4P8lawyld_meuUmHI,68
-mcp_agent/llm/augmented_llm.py,sha256=PdEMlglHFCTenqVDWsvEj3iBZh5ljFP7ZBdMibTGUxQ,16861
+mcp_agent/llm/augmented_llm.py,sha256=3T7F-VcNc4_n7f9ODBcIhE1KYeFgACOdMslPG0FV624,18124
 mcp_agent/llm/augmented_llm_passthrough.py,sha256=_DC6lGYbXPMXBeJn9Ot2fq-fXJ5GP7HhRmlY9pNvJ2s,6033
 mcp_agent/llm/augmented_llm_playback.py,sha256=YVR2adzjMf9Q5WfYBytryWMRqJ87a3kNBnjxhApsMcU,3413
 mcp_agent/llm/memory.py,sha256=UakoBCJBf59JBtB6uyZM0OZjlxDW_VHtSfDs08ibVEc,3312
-mcp_agent/llm/model_factory.py,sha256=NFe-m8AmIyHWDVmspJR_nEDs02eBAttf6avesOjAOhs,8336
+mcp_agent/llm/model_factory.py,sha256=y65gUc8IyX8vbdK_oOIIjauIYk5h7jyrDAdjTlRdBcc,7655
 mcp_agent/llm/prompt_utils.py,sha256=yWQHykoK13QRF7evHUKxVF0SpVLN-Bsft0Yixzvn0g0,4825
 mcp_agent/llm/sampling_converter.py,sha256=C7wPBlmT0eD90XWabC22zkxsrVHKCrjwIwg6cG628cI,2926
 mcp_agent/llm/sampling_format_converter.py,sha256=xGz4odHpOcP7--eFaJaFtUR8eR9jxZS7MnLH6J7n0EU,1263
@@ -62,10 +62,10 @@ mcp_agent/llm/providers/__init__.py,sha256=heVxtmuqFJOnjjxHz4bWSqTAxXoN1E8twC_gQ
 mcp_agent/llm/providers/anthropic_utils.py,sha256=vYDN5G5jKMhD2CQg8veJYab7tvvzYkDMq8M1g_hUAQg,3275
 mcp_agent/llm/providers/augmented_llm_anthropic.py,sha256=9JXyweks5Joes4ERtmi2wX8i7ZsXydKM7IkMq7s7dIU,15429
 mcp_agent/llm/providers/augmented_llm_deepseek.py,sha256=SdYDqZZ9hM9sBvW1FSItNn_ENEKQXGNKwVHGnjqjyAA,1927
-mcp_agent/llm/providers/augmented_llm_generic.py,sha256=qh4I8_wwududAbYRHDTN3rwsRfwZ7PKf6VjHewK9azQ,1550
-mcp_agent/llm/providers/augmented_llm_openai.py,sha256=-EkkekxYn85QUXsCmqX6Mk8vUE91ZJCUxzL0N9-fHXg,18136
-mcp_agent/llm/providers/multipart_converter_anthropic.py,sha256=3eRu7MSkbvBzKLptNdC_u0QohU_6eJ1ikRTaT6yPm0Y,16650
-mcp_agent/llm/providers/multipart_converter_openai.py,sha256=-EUAVP7ZB5JzvVe4Gtn5av9syWyN74BoDzhK-sOpSdg,16709
+mcp_agent/llm/providers/augmented_llm_generic.py,sha256=IIgwPYsVGwDdL2mMYsc5seY3pVFblMwmnxoI5dbxras,1524
+mcp_agent/llm/providers/augmented_llm_openai.py,sha256=6ZUEOXW-cDENAizMPUKJhhklJyQf73IcyVqT9-3To80,18215
+mcp_agent/llm/providers/multipart_converter_anthropic.py,sha256=t5lHYGfFUacJldnrVtMNW-8gEMoto8Y7hJkDrnyZR-Y,16650
+mcp_agent/llm/providers/multipart_converter_openai.py,sha256=zCj0LBgd9FDG8aL_GeTrPo2ssloYnmC_Uj3ENWVUJAg,16753
 mcp_agent/llm/providers/openai_multipart.py,sha256=qKBn7d3jSabnJmVgWweVzqh8q9mBqr09fsPmP92niAQ,6899
 mcp_agent/llm/providers/openai_utils.py,sha256=T4bTCL9f7DsoS_zoKgQKv_FUv_4n98vgbvaUpdWZJr8,1875
 mcp_agent/llm/providers/sampling_converter_anthropic.py,sha256=35WzBWkPklnuMlu5S6XsQIq0YL58NOy8Ja6A_l4m6eM,1612
@@ -80,28 +80,30 @@ mcp_agent/logging/tracing.py,sha256=d5lSXakzzi5PtQpUkVkOnYaGX8NduGPq__S7vx-Ln8U,
 mcp_agent/logging/transport.py,sha256=m8YsLLu5T8eof_ndpLQs4gHOzqqEL98xsVwBwDsBfxI,17335
 mcp_agent/mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/mcp/gen_client.py,sha256=fAVwFVCgSamw4PwoWOV4wrK9TABx1S_zZv8BctRyF2k,3030
-mcp_agent/mcp/interfaces.py,sha256=YuE-wBtKIzaeejQ4YuzETIVlBJCun332ciez89Frijk,5858
+mcp_agent/mcp/interfaces.py,sha256=8fsQj8r7sMrIyrJHHbUIEP86SVLyXPpEI36KZq1abc0,6644
 mcp_agent/mcp/logger_textio.py,sha256=OpnqMam9Pu0oVzYQWFMhrX1dRg2f5Fqb3qqPA6QAATM,2778
 mcp_agent/mcp/mcp_activity.py,sha256=CajXCFWZ2cKEX9s4-HfNVAj471ePTVs4NOkvmIh65tE,592
 mcp_agent/mcp/mcp_agent_client_session.py,sha256=RMYNltc2pDIzxwEJSS5589RbvPO0KWV4Y3jSyAmhKf0,4181
 mcp_agent/mcp/mcp_agent_server.py,sha256=SnKJ9KCMnklGLHKZ9UsgAxd9IOKqiSCRPmQeTGu0CK8,1643
-mcp_agent/mcp/mcp_aggregator.py,sha256=q-NeCBiderNEf11qGsw8vJ3vssTxdvgJR5lpSFAijlo,36497
+mcp_agent/mcp/mcp_aggregator.py,sha256=jaWbOvb3wioECohZ47CubyxfJ5QkfNSshu1hwhZksG4,40486
 mcp_agent/mcp/mcp_connection_manager.py,sha256=desQBreHbIcjY7AidcDO6pFomHOx9oOZPOWIcHAx1K0,13761
 mcp_agent/mcp/mime_utils.py,sha256=difepNR_gpb4MpMLkBRAoyhDk-AjXUHTiqKvT_VwS1o,1805
-mcp_agent/mcp/prompt_message_multipart.py,sha256=Hzgb3hN8KEa3H6lxtu5I_Ifr6_F8uyRTuV5A5B-1m-g,3451
-mcp_agent/mcp/prompt_render.py,sha256=SHjHbK5RP2E1T9BOrDGHr4_5JOM6N_V1ClvBrKFeOGY,2907
+mcp_agent/mcp/prompt_message_multipart.py,sha256=IpIndd75tAcCbJbfqjpAF0tOUUP1TQceDbWoxO5gvpo,3684
+mcp_agent/mcp/prompt_render.py,sha256=k3v4BZDThGE2gGiOYVQtA6x8WTEdOuXIEnRafANhN1U,2996
 mcp_agent/mcp/prompt_serialization.py,sha256=-qmE6CmGyB-wmFqZ3L7PyJtidw8kmwuXpt6x1XHdJVk,15856
 mcp_agent/mcp/resource_utils.py,sha256=K4XY8bihmBMleRTZ2viMPiD2Y2HWxFnlgIJi6dd_PYE,6588
 mcp_agent/mcp/sampling.py,sha256=vzWrIdI1CyFSxDWO-O69TpD6RwQcCM694BqMlYPVtaw,4584
+mcp_agent/mcp/helpers/__init__.py,sha256=sKqwlUR3jSsd9PVJKjXtxHgZA1YOdzPtsSW4xVey77Q,52
+mcp_agent/mcp/helpers/content_helpers.py,sha256=KsD77eCr1O6gv2Fz7vlVZxLyBgqscgsS25OqSJ8ksoY,3349
 mcp_agent/mcp/prompts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/mcp/prompts/__main__.py,sha256=gr1Tdz9fcK0EXjEuZg_BOnKUmvhYq5AH2lFZicVyNb0,237
 mcp_agent/mcp/prompts/prompt_constants.py,sha256=Q9W0t3rOXl2LHIG9wcghApUV2QZ1iICuo7SwVwHUf3c,566
-mcp_agent/mcp/prompts/prompt_helpers.py,sha256=qhSdB4ZhLsU_h0nZyXXPnoSfgKsDNcYrH3rHdsvZIjw,10044
+mcp_agent/mcp/prompts/prompt_helpers.py,sha256=Joqo2t09pTKDP-Wge3G-ozPEHikzjaqwV6GVk8hNR50,7534
 mcp_agent/mcp/prompts/prompt_load.py,sha256=ohRvAzJwZvgrN_7iKzy0RA7ILWVlOoD8KvI1c0Xr_eI,3908
 mcp_agent/mcp/prompts/prompt_server.py,sha256=tXtQd4EnH86MmdAvHlXm4oOS1dWLSCW5PvoA7uU1TvA,16493
 mcp_agent/mcp/prompts/prompt_template.py,sha256=EejiqGkau8OizORNyKTUwUjrPof5V-hH1H_MBQoQfXw,15732
 mcp_agent/mcp_server/__init__.py,sha256=zBU51ITHIEPScd9nRafnhEddsWqXRPAAvHhkrbRI2_4,155
-mcp_agent/mcp_server/agent_server.py,sha256=I3jh2izfiUSQFZzboEavtp8DJpkx3tuaeLqRReOTuiM,4491
+mcp_agent/mcp_server/agent_server.py,sha256=vGMPy9ZjceqlOAnwDgm29bzjZegxChXZQHvj7OUs5Oo,4472
 mcp_agent/resources/examples/data-analysis/analysis-campaign.py,sha256=QdNdo0-7LR4Uzw61hEU_jVKmWyk6A9YpGo81kMwVobM,7267
 mcp_agent/resources/examples/data-analysis/analysis.py,sha256=M9z8Q4YC5OGuqSa5uefYmmfmctqMn-WqCSfg5LI407o,2609
 mcp_agent/resources/examples/data-analysis/fastagent.config.yaml,sha256=ini94PHyJCfgpjcjHKMMbGuHs6LIj46F1NwY0ll5HVk,1609
@@ -110,6 +112,7 @@ mcp_agent/resources/examples/in_dev/agent_build.py,sha256=eetMEdYDbmnRH4CLO7chpQ
 mcp_agent/resources/examples/in_dev/slides.py,sha256=-SEFeGIg9SLF253NIxmA0NjlanLe8CR1yjDBBp2LXgs,4904
 mcp_agent/resources/examples/internal/agent.py,sha256=RZOMb5cJzIY1k0V28YgrHcUFSt0Uy977towy4yJE7bA,502
 mcp_agent/resources/examples/internal/fastagent.config.yaml,sha256=7anEzFqlMg3i5T8fEiqGYSO3fgMGI5P2BRsOJKsKl8k,1983
+mcp_agent/resources/examples/internal/history_transfer.py,sha256=ETyX2wMMvUnMpUhu4ij9ZTpw2wQR6vPpBwlXJswPnhM,1157
 mcp_agent/resources/examples/internal/job.py,sha256=ANF3c01gHJ4O4pIxaAtC3rdgYqVObMySaCUBS4dApW4,4102
 mcp_agent/resources/examples/internal/prompt_category.py,sha256=kMvqNX_zu0sV-kTaAR3skc_tsq9t8QSEofciK0m4aJc,551
 mcp_agent/resources/examples/internal/prompt_sizing.py,sha256=bskgxulN57hVkc0V9W0fnjnqSRCK5Tkw9Ggf2MmGIVU,1989
@@ -132,8 +135,8 @@ mcp_agent/resources/examples/workflows/orchestrator.py,sha256=rOGilFTliWWnZ3Jx5w
 mcp_agent/resources/examples/workflows/parallel.py,sha256=n0dFN26QvYd2wjgohcaUBflac2SzXYx-bCyxMSousJE,1884
 mcp_agent/resources/examples/workflows/router.py,sha256=E4x_-c3l4YW9w1i4ARcDtkdeqIdbWEGfsMzwLYpdbVc,1677
 mcp_agent/ui/console_display.py,sha256=TVGDtJ37hc6UG0ei9g7ZPZZfFNeS1MYozt-Mx8HsPCk,9752
-fast_agent_mcp-0.2.2.dist-info/METADATA,sha256=868y8r88XRjKBhQk5rIJYVv6x1N1y7V-Wxwn0szRz6g,29647
-fast_agent_mcp-0.2.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.2.2.dist-info/entry_points.txt,sha256=qPM7vwtN1_KmP3dXehxgiCxUBHtqP7yfenZigztvY-w,226
-fast_agent_mcp-0.2.2.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
-fast_agent_mcp-0.2.2.dist-info/RECORD,,
+fast_agent_mcp-0.2.4.dist-info/METADATA,sha256=ZZc6lPJvUVd0k4Cw9nqy-tOrNjw5KtIlT_Cb8cOR0tk,29841
+fast_agent_mcp-0.2.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.2.4.dist-info/entry_points.txt,sha256=qPM7vwtN1_KmP3dXehxgiCxUBHtqP7yfenZigztvY-w,226
+fast_agent_mcp-0.2.4.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
+fast_agent_mcp-0.2.4.dist-info/RECORD,,

mcp_agent/__init__.py

@@ -16,7 +16,7 @@ from mcp.types import (
 
 # Core agent components
 from mcp_agent.agents.agent import Agent, AgentConfig
-from mcp_agent.core.direct_agent_app import DirectAgentApp
+from mcp_agent.core.agent_app import AgentApp
 
 # Workflow decorators
 from mcp_agent.core.direct_decorators import (
@@ -62,7 +62,7 @@ __all__ = [
     "PromptMessageMultipart",
     # FastAgent components
     "FastAgent",
-    "DirectAgentApp",
+    "AgentApp",
     # Workflow decorators
     "agent",
     "orchestrator",

mcp_agent/agents/agent.py

@@ -84,6 +84,11 @@ class Agent(BaseAgent):
         async def list_prompts_wrapper(agent_name):
             # Always call list_prompts on this agent regardless of agent_name
             return await self.list_prompts()
+            
+        # Define wrapper for list_resources function
+        async def list_resources_wrapper(agent_name):
+            # Always call list_resources on this agent regardless of agent_name
+            return await self.list_resources()
 
         # Start the prompt loop with just this agent
         return await prompt.prompt_loop(

mcp_agent/agents/base_agent.py

@@ -7,12 +7,25 @@ and delegates operations to an attached AugmentedLLMProtocol instance.
 
 import asyncio
 import uuid
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Type, TypeVar, Union
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
 
 from mcp.types import (
     CallToolResult,
     EmbeddedResource,
+    GetPromptResult,
     ListToolsResult,
+    PromptMessage,
     ReadResourceResult,
     TextContent,
     Tool,
@@ -102,24 +115,54 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         """
         await self.__aenter__()  # This initializes the connection manager and loads the servers
 
-    async def attach_llm(self, llm_factory: Union[Type[LLM], Callable[..., LLM]], **kwargs) -> LLM:
-        """
-        Create an LLM instance for the agent.
-
+    async def attach_llm(
+        self,
+        llm_factory: Union[Type[AugmentedLLMProtocol], Callable[..., AugmentedLLMProtocol]],
+        model: Optional[str] = None,
+        request_params: Optional[RequestParams] = None,
+        **additional_kwargs
+    ) -> AugmentedLLMProtocol:
+        """
+        Create and attach an LLM instance to this agent.
+        
+        Parameters have the following precedence (highest to lowest):
+        1. Explicitly passed parameters to this method
+        2. Agent's default_request_params
+        3. LLM's default values
+        
         Args:
-            llm_factory: A class or callable that constructs an AugmentedLLM or its subclass.
-                       The factory should accept keyword arguments matching the
-                       AugmentedLLM constructor parameters.
-            **kwargs: Additional keyword arguments to pass to the LLM constructor.
-
+            llm_factory: A class or callable that constructs an AugmentedLLM
+            model: Optional model name override
+            request_params: Optional request parameters override
+            **additional_kwargs: Additional parameters passed to the LLM constructor
+            
         Returns:
-            An instance of AugmentedLLM or one of its subclasses.
-        """
-
+            The created LLM instance
+        """
+        # Start with agent's default params
+        effective_params = self._default_request_params.model_copy() if self._default_request_params else None
+        
+        # Override with explicitly passed request_params
+        if request_params:
+            if effective_params:
+                # Update non-None values
+                for k, v in request_params.model_dump(exclude_unset=True).items():
+                    if v is not None:
+                        setattr(effective_params, k, v)
+            else:
+                effective_params = request_params
+        
+        # Override model if explicitly specified
+        if model and effective_params:
+            effective_params.model = model
+        
+        # Create the LLM instance
         self._llm = llm_factory(
-            agent=self, default_request_params=self._default_request_params, **kwargs
+            agent=self,
+            request_params=effective_params,
+            **additional_kwargs
         )
-
+        
         return self._llm
 
     async def shutdown(self) -> None:
@@ -154,27 +197,49 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         result: PromptMessageMultipart = await self.generate([Prompt.user(message)], request_params)
         return result.first_text()
 
-    async def send(self, message: Union[str, PromptMessageMultipart]) -> str:
+    async def send(self, message: Union[str, PromptMessage, PromptMessageMultipart]) -> str:
         """
         Send a message to the agent and get a response.
 
         Args:
-            message: Either a string message or a PromptMessageMultipart object
+            message: Message content in various formats:
+                - String: Converted to a user PromptMessageMultipart
+                - PromptMessage: Converted to PromptMessageMultipart
+                - PromptMessageMultipart: Used directly
 
         Returns:
             The agent's response as a string
         """
-
-        # Create a PromptMessageMultipart if we received a string
-        if isinstance(message, str):
-            prompt = Prompt.user(message)
-        else:
-            prompt = message
+        # Convert the input to a PromptMessageMultipart
+        prompt = self._normalize_message_input(message)
 
         # Use the LLM to generate a response
         response = await self.generate([prompt], None)
         return response.first_text()
 
+    def _normalize_message_input(
+        self, message: Union[str, PromptMessage, PromptMessageMultipart]
+    ) -> PromptMessageMultipart:
+        """
+        Convert a message of any supported type to PromptMessageMultipart.
+
+        Args:
+            message: Message in various formats (string, PromptMessage, or PromptMessageMultipart)
+
+        Returns:
+            A PromptMessageMultipart object
+        """
+        # Handle single message
+        if isinstance(message, str):
+            return Prompt.user(message)
+        elif isinstance(message, PromptMessage):
+            return PromptMessageMultipart(role=message.role, content=[message.content])
+        elif isinstance(message, PromptMessageMultipart):
+            return message
+        else:
+            # Try to convert to string as fallback
+            return Prompt.user(str(message))
+
     async def prompt(self, default_prompt: str = "") -> str:
         """
         Start an interactive prompt session with the agent.
@@ -360,10 +425,34 @@ class BaseAgent(MCPAggregator, AgentProtocol):
                 content=[TextContent(type="text", text=f"Error requesting human input: {str(e)}")],
             )
 
-    async def apply_prompt(self, prompt_name: str, arguments: Dict[str, str] | None = None) -> str:
+    async def get_prompt(
+        self,
+        prompt_name: str,
+        arguments: Dict[str, str] | None = None,
+        server_name: str | None = None,
+    ) -> GetPromptResult:
+        """
+        Get a prompt from a server.
+
+        Args:
+            prompt_name: Name of the prompt, optionally namespaced
+            arguments: Optional dictionary of arguments to pass to the prompt template
+            server_name: Optional name of the server to get the prompt from
+
+        Returns:
+            GetPromptResult containing the prompt information
+        """
+        return await super().get_prompt(prompt_name, arguments, server_name)
+
+    async def apply_prompt(
+        self,
+        prompt_name: str,
+        arguments: Dict[str, str] | None = None,
+        server_name: str | None = None,
+    ) -> str:
         """
         Apply an MCP Server Prompt by name and return the assistant's response.
-        Will search all available servers for the prompt if not namespaced.
+        Will search all available servers for the prompt if not namespaced and no server_name provided.
 
         If the last message in the prompt is from a user, this will automatically
         generate an assistant response to ensure we always end with an assistant message.
@@ -371,6 +460,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         Args:
             prompt_name: The name of the prompt to apply
             arguments: Optional dictionary of string arguments to pass to the prompt template
+            server_name: Optional name of the server to get the prompt from
 
         Returns:
             The assistant's response or error message
@@ -378,7 +468,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
 
         # Get the prompt - this will search all servers if needed
         self.logger.debug(f"Loading prompt '{prompt_name}'")
-        prompt_result = await self.get_prompt(prompt_name, arguments)
+        prompt_result = await self.get_prompt(prompt_name, arguments, server_name)
 
         if not prompt_result or not prompt_result.messages:
             error_msg = f"Prompt '{prompt_name}' could not be found or contains no messages"
@@ -386,10 +476,11 @@ class BaseAgent(MCPAggregator, AgentProtocol):
             return error_msg
 
         # Get the display name (namespaced version)
-        getattr(prompt_result, "namespaced_name", prompt_name)
+        namespaced_name = getattr(prompt_result, "namespaced_name", prompt_name)
+        self.logger.debug(f"Using prompt '{namespaced_name}'")
 
-        # Convert prompt messages to multipart format
-        multipart_messages = PromptMessageMultipart.to_multipart(prompt_result.messages)
+        # Convert prompt messages to multipart format using the safer method
+        multipart_messages = PromptMessageMultipart.from_get_prompt_result(prompt_result)
 
         # Always call generate to ensure LLM implementations can handle prompt templates
         # This is critical for stateful LLMs like PlaybackLLM
@@ -397,14 +488,14 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         return response.first_text()
 
     async def get_embedded_resources(
-        self, server_name: str, resource_name: str
+        self, resource_uri: str, server_name: str | None = None
     ) -> List[EmbeddedResource]:
         """
         Get a resource from an MCP server and return it as a list of embedded resources ready for use in prompts.
 
         Args:
-            server_name: Name of the MCP server to retrieve the resource from
-            resource_name: Name or URI of the resource to retrieve
+            resource_uri: URI of the resource to retrieve
+            server_name: Optional name of the MCP server to retrieve the resource from
 
         Returns:
             List of EmbeddedResource objects ready to use in a PromptMessageMultipart
@@ -413,7 +504,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
             ValueError: If the server doesn't exist or the resource couldn't be found
         """
         # Get the raw resource result
-        result: ReadResourceResult = await super().get_resource(server_name, resource_name)
+        result: ReadResourceResult = await self.get_resource(resource_uri, server_name)
 
         # Convert each resource content to an EmbeddedResource
         embedded_resources: List[EmbeddedResource] = []
@@ -427,24 +518,27 @@ class BaseAgent(MCPAggregator, AgentProtocol):
 
     async def with_resource(
         self,
-        prompt_content: Union[str, PromptMessageMultipart],
-        server_name: str,
-        resource_name: str,
+        prompt_content: Union[str, PromptMessage, PromptMessageMultipart],
+        resource_uri: str,
+        server_name: str | None = None,
     ) -> str:
         """
         Create a prompt with the given content and resource, then send it to the agent.
 
         Args:
-            prompt_content: Either a string message or an existing PromptMessageMultipart
-            server_name: Name of the MCP server to retrieve the resource from
-            resource_name: Name or URI of the resource to retrieve
+            prompt_content: Content in various formats:
+                - String: Converted to a user message with the text
+                - PromptMessage: Converted to PromptMessageMultipart
+                - PromptMessageMultipart: Used directly
+            resource_uri: URI of the resource to retrieve
+            server_name: Optional name of the MCP server to retrieve the resource from
 
         Returns:
             The agent's response as a string
         """
         # Get the embedded resources
         embedded_resources: List[EmbeddedResource] = await self.get_embedded_resources(
-            server_name, resource_name
+            resource_uri, server_name
         )
 
         # Create or update the prompt message
@@ -454,12 +548,19 @@ class BaseAgent(MCPAggregator, AgentProtocol):
             content = [TextContent(type="text", text=prompt_content)]
             content.extend(embedded_resources)
             prompt = PromptMessageMultipart(role="user", content=content)
+        elif isinstance(prompt_content, PromptMessage):
+            # Convert PromptMessage to PromptMessageMultipart and add resources
+            content = [prompt_content.content]
+            content.extend(embedded_resources)
+            prompt = PromptMessageMultipart(role=prompt_content.role, content=content)
         elif isinstance(prompt_content, PromptMessageMultipart):
             # Add resources to the existing prompt
             prompt = prompt_content
             prompt.content.extend(embedded_resources)
         else:
-            raise TypeError("prompt_content must be a string or PromptMessageMultipart")
+            raise TypeError(
+                "prompt_content must be a string, PromptMessage, or PromptMessageMultipart"
+            )
 
         response: PromptMessageMultipart = await self.generate([prompt], None)
         return response.first_text()
@@ -488,7 +589,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         prompt: List[PromptMessageMultipart],
         model: Type[ModelT],
         request_params: RequestParams | None = None,
-    ) -> ModelT | None:
+    ) -> Tuple[ModelT | None, PromptMessageMultipart]:
         """
         Apply the prompt and return the result as a Pydantic model.
         Delegates to the attached LLM.
@@ -520,3 +621,18 @@ class BaseAgent(MCPAggregator, AgentProtocol):
 
         response = await self.generate(prompts, request_params)
         return response.first_text()
+
+    @property
+    def message_history(self) -> List[PromptMessageMultipart]:
+        """
+        Return the agent's message history as PromptMessageMultipart objects.
+
+        This history can be used to transfer state between agents or for
+        analysis and debugging purposes.
+
+        Returns:
+            List of PromptMessageMultipart objects representing the conversation history
+        """
+        if self._llm:
+            return self._llm.message_history
+        return []

mcp_agent/agents/workflow/chain_agent.py

@@ -5,7 +5,7 @@ This provides an implementation that delegates operations to a sequence of
 other agents, chaining their outputs together.
 """
 
-from typing import Any, List, Optional, Type
+from typing import Any, List, Optional, Tuple, Type
 
 from mcp.types import TextContent
 
@@ -77,7 +77,7 @@ class ChainAgent(BaseAgent):
             response: PromptMessageMultipart = await self.agents[0].generate(multipart_messages)
             # Process the rest of the agents in the chain
             for agent in self.agents[1:]:
-                next_message = Prompt.user(response.content)
+                next_message = Prompt.user(response.content[0].text)
                 response = await agent.generate([next_message])
 
             return response
@@ -123,7 +123,7 @@ class ChainAgent(BaseAgent):
         prompt: List[PromptMessageMultipart],
         model: Type[ModelT],
         request_params: Optional[RequestParams] = None,
-    ) -> Optional[ModelT]:
+    ) -> Tuple[ModelT | None, PromptMessageMultipart]:
         """
         Chain the request through multiple agents and parse the final response.
 
@@ -137,16 +137,12 @@ class ChainAgent(BaseAgent):
         """
         # Generate response through the chain
         response = await self.generate(prompt, request_params)
-
-        # Let the last agent in the chain try to parse the response
-        if self.agents:
-            last_agent = self.agents[-1]
-            try:
-                return await last_agent.structured([response], model, request_params)
-            except Exception as e:
-                self.logger.warning(f"Failed to parse response from chain: {str(e)}")
-                return None
-        return None
+        last_agent = self.agents[-1]
+        try:
+            return await last_agent.structured([response], model, request_params)
+        except Exception as e:
+            self.logger.warning(f"Failed to parse response from chain: {str(e)}")
+            return None, Prompt.assistant("Failed to parse response from chain: {str(e)}")
 
     async def initialize(self) -> None:
         """

mcp_agent/agents/workflow/evaluator_optimizer.py

@@ -8,7 +8,7 @@ or a maximum number of refinements is attempted.
 """
 
 from enum import Enum
-from typing import Any, List, Optional, Type
+from typing import Any, List, Optional, Tuple, Type
 
 from pydantic import BaseModel, Field
 
@@ -139,7 +139,7 @@ class EvaluatorOptimizerAgent(BaseAgent):
 
             # Create evaluation message and get structured evaluation result
             eval_message = Prompt.user(eval_prompt)
-            evaluation_result = await self.evaluator_agent.structured(
+            evaluation_result, _ = await self.evaluator_agent.structured(
                 [eval_message], EvaluationResult, request_params
             )
 
@@ -202,7 +202,7 @@ class EvaluatorOptimizerAgent(BaseAgent):
         prompt: List[PromptMessageMultipart],
         model: Type[ModelT],
         request_params: Optional[RequestParams] = None,
-    ) -> Optional[ModelT]:
+    ) -> Tuple[ModelT | None, PromptMessageMultipart]:
         """
         Generate an optimized response and parse it into a structured format.