fast-agent-mcp 0.1.8__py3-none-any.whl → 0.1.9__py3-none-any.whl

{fast_agent_mcp-0.1.8.dist-info → fast_agent_mcp-0.1.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.1.8
+Version: 0.1.9
 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
@@ -212,7 +212,7 @@ Requires-Python: >=3.10
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.49.0
 Requires-Dist: fastapi>=0.115.6
-Requires-Dist: mcp==1.2.1
+Requires-Dist: mcp>=1.4.1
 Requires-Dist: numpy>=2.2.1
 Requires-Dist: openai>=1.63.2
 Requires-Dist: opentelemetry-distro>=0.50b0
@@ -259,6 +259,10 @@ The simple declarative syntax lets you concentrate on composing your Prompts and
 
 Evaluate how different models handle Agent and MCP Server calling tasks, then build multi-model workflows using the best provider for each task.
 
+`fast-agent` is now multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints (for supported models), via Prompts and MCP Tool Call results.
+
+> [!TIP] > `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site.
+
 ### Agent Application Development
 
 Prompts and configurations that define your Agent Applications are stored in simple files, with minimal boilerplate, enabling simple management and version control.
@@ -588,6 +592,19 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
 )
 ```
 
+### Multimodal Support
+
+Add Resources to prompts using either the inbuilt `prompt-server` or MCP Types directly. Convenience class are made available to do so simply, for example:
+
+#### MCP Tool Result Conversion
+
+LLM APIs have restrictions on the content types that can be returned as Tool Calls/Function results via their Chat Completions API's:
+
+- OpenAI supports Text
+- Anthropic supports Text and Image
+
+For MCP Tool Results, `ImageResources` and `EmbeddedResources` are converted to User Messages and added to the conversation.
+
 ### Prompts
 
 MCP Prompts are supported with `apply_prompt(name,arguments)`, which always returns an Assistant Message. If the last message from the MCP Server is a 'User' message, it is sent to the LLM for processing. Prompts applied to the Agent's Context are retained - meaning that with `use_history=False`, Agents can act as finely tuned responders.
@@ -605,8 +622,9 @@ Prompts can also be applied interactively through the interactive interface by u
 
 ### llmindset.co.uk fork:
 
+- Addition of MCP Prompts including Prompt Server and agent save/replay ability.
 - Overhaul of Eval/Opt for Conversation Management
-- Remove instructor use for Orchestrator
+- Removed instructor/double-llm calling - native structured outputs for OAI.
 - Improved handling of Parallel/Fan-In and respose option
 - XML based generated prompts
 - "FastAgent" style prototyping, with per-agent models
@@ -625,4 +643,8 @@ Prompts can also be applied interactively through the interactive interface by u
 - Declarative workflows
 - Numerous defect fixes
 
-### Features to add.
+### Features to add (Commmitted)
+
+- Run Agent as MCP Server, with interop
+- Multi-part content types supporing Vision, PDF and multi-part Text.
+- Improved test automation (supported by prompt_server.py and augmented_llm_playback.py)

{fast_agent_mcp-0.1.8.dist-info → fast_agent_mcp-0.1.9.dist-info}/RECORD

@@ -8,7 +8,7 @@ mcp_agent/event_progress.py,sha256=25iz0yyg-O4glMmtijcYpDdUmtUIKsCmR_8A52GgeC4,2
 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=DpsqvrQYsyHrn5nFnQ7wcB7fDRhV22LSVPWhVGLp93M,13497
+mcp_agent/agents/agent.py,sha256=foxgVBSjpRp697467-girJmAjmEylfDCXbXtI660wHI,13173
 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=DE6EZzspfzHwPK59x8vL4AIDHRQkVQ1Ja70XRGU1IQs,2753
@@ -17,7 +17,7 @@ mcp_agent/cli/commands/bootstrap.py,sha256=Rmwbuwl52eHfnya7fnwKk2J7nCsHpSh6irka4
 mcp_agent/cli/commands/config.py,sha256=32YTS5jmsYAs9QzAhjkG70_daAHqOemf4XbZBBSMz6g,204
 mcp_agent/cli/commands/setup.py,sha256=_SCpd6_PrixqbSaE72JQ7erIRkZnJGmh_3TvvwSzEiE,6392
 mcp_agent/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_agent/core/agent_app.py,sha256=ytZFkiqprFApi1sgYsIvojDMddX9G9M_zVkr5v8PIaE,27300
+mcp_agent/core/agent_app.py,sha256=6fzvExSmVSXyNo-Rq9Xvu0qUKjKHKjOpuhRfzCthV8o,29735
 mcp_agent/core/agent_types.py,sha256=yKiMbv9QO2dduq4zXmoMZlOZpXJZhM4oNwIq1-134FE,318
 mcp_agent/core/agent_utils.py,sha256=QMvwmxZyCqYhBzSyL9xARsxTuwdmlyjQvrPpsH36HnQ,1888
 mcp_agent/core/decorators.py,sha256=dkAah1eIuYsEfQISDryG0u2GrzNnsO_jyN7lhpQfNlM,16191
@@ -25,10 +25,10 @@ mcp_agent/core/enhanced_prompt.py,sha256=bykUEnnc1CEWODJwXvl4VGfCtrJPtVXU0D4mUgl
 mcp_agent/core/error_handling.py,sha256=D3HMW5odrbJvaKqcpCGj6eDXrbFcuqYaCZz7fyYiTu4,623
 mcp_agent/core/exceptions.py,sha256=a2-JGRwFFRoQEPuAq0JC5PhAJ5TO3xVJfdS4-VN29cw,2225
 mcp_agent/core/factory.py,sha256=TYtGtUKEVQi96uXQu3RddrpYGiUGolHMEATS57e4hgw,19074
-mcp_agent/core/fastagent.py,sha256=v8LN-Oux3X0zSnLeE_vtHYN8JR1nZakhO2CBdYbCGQI,19461
-mcp_agent/core/proxies.py,sha256=fUhuB3GoIdDIHg7rXn24O3C_tPiAzkZ9sTGuaQl4gxs,8827
-mcp_agent/core/server_validation.py,sha256=_59cn16nNT4HGPwg19HgxMtHK4MsdWYDUw_CuL-5xek,1696
-mcp_agent/core/simulator_registry.py,sha256=rcd1cyFGx8MAnN5O0UgwElmVKU_uoIBh9s24pxP33Jc,573
+mcp_agent/core/fastagent.py,sha256=CYor0u4Vqrn8XmYIaSEtfuLrJgF2YChJUAE_3xjRGmk,19659
+mcp_agent/core/mcp_content.py,sha256=rXT2C5gP9qgC-TI5F362ZLJi_erzcEOnlP9D2ZKK0i0,6860
+mcp_agent/core/prompt.py,sha256=R-X3kptu3ehV_SQeiGnP6F9HMN-92I8e73gnkQ1tDVs,4317
+mcp_agent/core/proxies.py,sha256=lawAc3mcoYlDpX9HwBc8tdh2oAr9YS_CT2LtbqXvuyg,8858
 mcp_agent/core/types.py,sha256=Zhi9iW7uiOfdpSt9NC0FCtGRFtJPg4mpZPK2aYi7a7M,817
 mcp_agent/core/validation.py,sha256=x0fsx5eLTawASFm9MDtEukwGOj_RTdY1OW064UihMR8,8309
 mcp_agent/eval/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -49,29 +49,41 @@ mcp_agent/logging/listeners.py,sha256=lx2Pq_SE0rsG3nF3TwDSxkmsWzdXxIUjuaWct-KOtJ
 mcp_agent/logging/logger.py,sha256=Tr009BnfGUKuZcdinnSin0Z_zIsfDNGdcnamw2rDHRQ,10604
 mcp_agent/logging/rich_progress.py,sha256=IEVFdFGA0nwg6pSt9Ydni5LCNYZZPKYMe-6DCi9pO4Y,4851
 mcp_agent/logging/tracing.py,sha256=jQivxKYl870oXakmyUk7TXuTQSvsIzpHwZlSQfy4b0c,5203
-mcp_agent/logging/transport.py,sha256=Oo7Rx5t7REZTnH-uVljK0JlehnBj-wInc_fx0zhd_zY,16139
+mcp_agent/logging/transport.py,sha256=MFgiCQ-YFP0tSMhDMpZCj585vflWcMydM4oyCFduVf0,17203
 mcp_agent/mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/mcp/gen_client.py,sha256=u0HwdJiw9YCerS5JC7JDuGgBh9oTcLd7vv9vPjwibXc,3025
 mcp_agent/mcp/mcp_activity.py,sha256=CajXCFWZ2cKEX9s4-HfNVAj471ePTVs4NOkvmIh65tE,592
 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=9NYawRUf0xFjE1v-7_7VWN6TwVgqhsnvIuTyAE0V-4I,36095
+mcp_agent/mcp/mcp_aggregator.py,sha256=X_SnSX-_CPye87Xst_h0XyO4Cd3EuxBCEvLhU1SlRkU,36045
 mcp_agent/mcp/mcp_connection_manager.py,sha256=EPJTKiEMKnFYpC37SOXiLriQL2YyhH0s6vvZWQRb_Mo,13663
+mcp_agent/mcp/mime_utils.py,sha256=difepNR_gpb4MpMLkBRAoyhDk-AjXUHTiqKvT_VwS1o,1805
+mcp_agent/mcp/prompt_message_multipart.py,sha256=U7IN0JStmy26akTXcqE4x90oWzm8xs1qa0VeKIyPKmE,1962
+mcp_agent/mcp/prompt_serialization.py,sha256=StcXV7V4fqqtCmOCXGCyYXx5vpwNhL2xr3RG_awwdqI,16056
+mcp_agent/mcp/resource_utils.py,sha256=x-hMxVH7moVY0PLV1LHkpzk8cihL8AJINtzRcaGsiSE,6358
 mcp_agent/mcp/stdio.py,sha256=tW075R5rQ-UlflXWFKIFDgCbWbuhKqxhiYolWvyEkFs,3985
+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_server.py,sha256=lGa-H2rXarVcbwrcjfhdZ0rGwggE9eytUko6soiJVXo,17375
+mcp_agent/mcp/prompts/prompt_template.py,sha256=NDnSVA0W1wayZHCVx27lfuVPoxlAz-FfBwiCEQG9Ixk,16324
 mcp_agent/mcp_server/__init__.py,sha256=SEWyU7aSFzdSk6iTYnrQu-llji5_P5dp3TaztCt_rzo,154
 mcp_agent/mcp_server/agent_server.py,sha256=SUBggPyrzWtBRUC5xIMpCxu6ei-6Vah3q9Si12BQ-zY,4444
 mcp_agent/resources/examples/data-analysis/analysis-campaign.py,sha256=EG-HhaDHltZ4hHAqhgfX_pHM2wem48aYhSIKJxyWHKc,7269
 mcp_agent/resources/examples/data-analysis/analysis.py,sha256=5zLoioZQNKUfXt1EXLrGX3TU06-0N06-L9Gtp9BIr6k,2611
 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/internal/agent.py,sha256=f-jTgYabV3nWCQm0ZP9NtSEWjx3nQbRngzArRufcELg,384
-mcp_agent/resources/examples/internal/fastagent.config.yaml,sha256=98vKDiGLnpshPBqrkbPPaeKrGZ13RWGBxXhJBb9Hv6M,1850
+mcp_agent/resources/examples/internal/agent.py,sha256=4EXhVJcX5mw2LuDqmZL4B4SM0zxMFmMou7NCEeoVeQ0,391
+mcp_agent/resources/examples/internal/fastagent.config.yaml,sha256=NF-plJ2ZMLZL8_YfdwmfsvRyafgsNEEHzsjm_p8vNlY,1858
 mcp_agent/resources/examples/internal/job.py,sha256=WEKIAANMEAuKr13__rYf3PqJeTAsNB_kqYqbqVYQlUM,4093
 mcp_agent/resources/examples/internal/prompt_category.py,sha256=b3tjkfrVIW1EPoDjr4mG87wlZ7D0Uju9eg6asXAYYpI,551
 mcp_agent/resources/examples/internal/prompt_sizing.py,sha256=UtQ_jvwS4yMh80PHhUQXJ9WXk-fqNYlqUMNTNkZosKM,2003
-mcp_agent/resources/examples/internal/sizer.py,sha256=FC9zTscPRStlaaeDFVUODnrD5ytGUa3sD0NkfrhiQOc,707
+mcp_agent/resources/examples/internal/sizer.py,sha256=RBq1qhYVKF2_qtRdvpKpRI3XIFpZ4eyBzhVjnlip-P8,356
 mcp_agent/resources/examples/internal/social.py,sha256=Cot2lg3PLhLm13gPdVFvFEN28-mm6x3-jHu2YsV4N3s,1707
 mcp_agent/resources/examples/mcp_researcher/researcher-eval.py,sha256=kNPjIU-JwE0oIBQKwhv6lZsUF_SPtYVkiEEbY1ZVZxk,1807
+mcp_agent/resources/examples/prompting/__init__.py,sha256=GG1zksC76L-wmerkjplWHwamelxl5vlY0YkRzgAq_v0,49
+mcp_agent/resources/examples/prompting/agent.py,sha256=gG2jQnRibO8OmljoFQAs9xxhCyHLCkVxJxQkfF7ykfY,607
+mcp_agent/resources/examples/prompting/fastagent.config.yaml,sha256=UR6LtCpeSIzkHsCrHJW1z-wE7AgmgKozS_IYcfcSAkc,1270
+mcp_agent/resources/examples/prompting/image_server.py,sha256=-6YWtzS-K5ofHtdoOk4uC3ZBFUyVELT9Fdck1RptcWg,1711
 mcp_agent/resources/examples/researcher/fastagent.config.yaml,sha256=bNOnID9OgdSBTUEhdimKB8LjaZLa1B6igmp-nxx8nr4,2271
 mcp_agent/resources/examples/researcher/researcher-eval.py,sha256=0qDjxun7CZ1cZ8JTa6G1v1XcpwGSSL6-qAZ35yI1-K4,1818
 mcp_agent/resources/examples/researcher/researcher-imp.py,sha256=Xfw2YAyjXd47pQz-uljgG5ii5x77fVuCP2XCivRDI48,7885
@@ -104,14 +116,23 @@ mcp_agent/workflows/intent_classifier/intent_classifier_llm.py,sha256=WSLUv2Casb
 mcp_agent/workflows/intent_classifier/intent_classifier_llm_anthropic.py,sha256=Hp4454IniWFxV4ml50Ml8ip9rS1La5FBn5pd7vm1FHA,1964
 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=5HVa2xGzKyBzlk1IePzGsgshcgT1vslpF00ug-Id15M,26884
-mcp_agent/workflows/llm/augmented_llm_anthropic.py,sha256=cUcEq5S9hoz2NBdo4jQBs-rBHFd71yOV9TEE7w-mzTw,24033
-mcp_agent/workflows/llm/augmented_llm_openai.py,sha256=dhlGasCbTOXiLrAutDNxWXEyZermPToZ5yZc_PWzxlc,26798
-mcp_agent/workflows/llm/augmented_llm_passthrough.py,sha256=YiP_SnYIGT5ObQros48i_TNywaIdN1Of9d4q9EdrJbI,2272
-mcp_agent/workflows/llm/enhanced_passthrough.py,sha256=rHNbb6pYllIuVMOhuzUbt63_6WlUnjm57Y7r59N1pnk,2388
+mcp_agent/workflows/llm/anthropic_utils.py,sha256=OFmsVmDQ22880duDWQrEeQEB47xtvujSYJ-fNw1lhi0,3712
+mcp_agent/workflows/llm/augmented_llm.py,sha256=9cWy-4yNG13w4oQgXmisgWTcm6aoJIRCYTX85Bkf-MI,30554
+mcp_agent/workflows/llm/augmented_llm_anthropic.py,sha256=opV4PTai2eoYUzJS0gCPGEy4pe-lT2Eo1Sao6Y_EIiY,20140
+mcp_agent/workflows/llm/augmented_llm_openai.py,sha256=OUSmvY2m6HU1JOK5nEzKDHpHReT0ffjoHDFHk6aYhoc,21002
+mcp_agent/workflows/llm/augmented_llm_passthrough.py,sha256=oZC9K90DdjvCQiQ-2yH1FGTTYsjPl9EMRx4n5_CihIM,3996
+mcp_agent/workflows/llm/augmented_llm_playback.py,sha256=5ypv3owJU6pscktqg9tkLQVKNgaA50e8OWmC1hAhrtE,4328
 mcp_agent/workflows/llm/llm_selector.py,sha256=G7pIybuBDwtmyxUDov_QrNYH2FoI0qFRu2JfoxWUF5Y,11045
-mcp_agent/workflows/llm/model_factory.py,sha256=b0monjiedzYvYZaKPgK44tppVDk14kBoVJHEzmjVl28,7153
+mcp_agent/workflows/llm/model_factory.py,sha256=UHePE5Ow03kpE44kjYtFGEhVFSYp0AY2yGri58yCBKU,7688
+mcp_agent/workflows/llm/openai_utils.py,sha256=GGkJF-nazA4HWrlmMKKLf0qSfl2gbSqo-rbMDoJs5mE,1895
 mcp_agent/workflows/llm/prompt_utils.py,sha256=EY3eddqnmc_YDUQJFysPnpTH6hr4r2HneeEmX76P8TQ,4948
+mcp_agent/workflows/llm/sampling_format_converter.py,sha256=-vN927eMyo0vYg9GkuWAUzYqQR_kpz4BLmukgNfm2K8,1457
+mcp_agent/workflows/llm/providers/__init__.py,sha256=qirdqAKIbw3BY1NBdGytH9tvpjOu0QNOqKAG2deD_U4,285
+mcp_agent/workflows/llm/providers/multipart_converter_anthropic.py,sha256=TO0zHEnqnOEVfCjM-qp-DGrJoSUPRWChjUPTRo2Gt9U,13463
+mcp_agent/workflows/llm/providers/multipart_converter_openai.py,sha256=IaHgR-bo5PJBd960kDJYnvinLmg0dtajg6ZXFYeLke0,17691
+mcp_agent/workflows/llm/providers/openai_multipart.py,sha256=RKkwssszD6jJpZ-Hj875uu5rbePrwzN7v43Ec69Ziwg,7566
+mcp_agent/workflows/llm/providers/sampling_converter_anthropic.py,sha256=vaM0QWzYP6VFAUwLLxRGpyB0erAQAJAhQed0eFT2jPQ,8916
+mcp_agent/workflows/llm/providers/sampling_converter_openai.py,sha256=yUTSF9fmcy-aNVd-9yGT2kGV7F0VAkYCQK5S8eImeIs,8436
 mcp_agent/workflows/orchestrator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/workflows/orchestrator/orchestrator.py,sha256=s8-_4CG4oRnvYAwUqqyevGLpy21IYtcNtsd_SbRZ8Fk,22125
 mcp_agent/workflows/orchestrator/orchestrator_models.py,sha256=1ldku1fYA_hu2F6K4l2C96mAdds05VibtSzSQrGm3yw,7321
@@ -130,8 +151,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.1.8.dist-info/METADATA,sha256=OsJut48Sg0EH8_PcwoKXZMkbeqAOPpFbJwrU5BLqSzk,28637
-fast_agent_mcp-0.1.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.1.8.dist-info/entry_points.txt,sha256=2IXtSmDK9XjWN__RWuRIJTgWyW17wJnJ_h-pb0pZAxo,174
-fast_agent_mcp-0.1.8.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
-fast_agent_mcp-0.1.8.dist-info/RECORD,,
+fast_agent_mcp-0.1.9.dist-info/METADATA,sha256=c7JIWUS2bWR5pQQ6cVPwzBOQspzzvB8I25zo3wRUCQg,29748
+fast_agent_mcp-0.1.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.1.9.dist-info/entry_points.txt,sha256=qPM7vwtN1_KmP3dXehxgiCxUBHtqP7yfenZigztvY-w,226
+fast_agent_mcp-0.1.9.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
+fast_agent_mcp-0.1.9.dist-info/RECORD,,

{fast_agent_mcp-0.1.8.dist-info → fast_agent_mcp-0.1.9.dist-info}/entry_points.txt

@@ -2,4 +2,5 @@
 fast-agent = mcp_agent.cli.__main__:app
 fast_agent = mcp_agent.cli.__main__:app
 fastagent = mcp_agent.cli.__main__:app
+prompt-server = mcp_agent.mcp.prompts.__main__:main
 silsila = mcp_agent.cli.__main__:app

mcp_agent/agents/agent.py

@@ -320,18 +320,20 @@ class Agent(MCPAggregator):
                 ],
             )
 
-    async def apply_prompt(self, prompt_name: str, arguments: dict[str, str] = None) -> str:
+    async def apply_prompt(
+        self, prompt_name: str, arguments: dict[str, str] = 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.
-        
+
         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.
 
         Args:
             prompt_name: The name of the prompt to apply
             arguments: Optional dictionary of string arguments to pass to the prompt template
-            
+
         Returns:
             The assistant's response or error message
         """
@@ -357,11 +359,3 @@ class Agent(MCPAggregator):
         # The LLM will automatically generate a response if needed
         result = await self._llm.apply_prompt_template(prompt_result, display_name)
         return result
-
-    # For backward compatibility
-    async def load_prompt(self, prompt_name: str, arguments: dict[str, str] = None) -> str:
-        """
-        Legacy method - use apply_prompt instead.
-        This is maintained for backward compatibility.
-        """
-        return await self.apply_prompt(prompt_name, arguments)

mcp_agent/core/agent_app.py

@@ -2,9 +2,10 @@
 Main application wrapper for interacting with agents.
 """
 
-from typing import Optional, Dict, TYPE_CHECKING
+from typing import Optional, Dict, Union, TYPE_CHECKING
 
 from mcp_agent.app import MCPApp
+from mcp_agent.mcp.prompt_message_multipart import PromptMessageMultipart
 from mcp_agent.progress_display import progress_display
 from mcp_agent.workflows.orchestrator.orchestrator import Orchestrator
 from mcp_agent.workflows.parallel.parallel_llm import ParallelLLM
@@ -37,16 +38,80 @@ class AgentApp:
         # Optional: set default agent for direct calls
         self._default = next(iter(agents)) if agents else None
 
-    async def send(self, agent_name: str, message: Optional[str]) -> str:
-        """Core message sending"""
-        if agent_name not in self._agents:
-            raise ValueError(f"No agent named '{agent_name}'")
+    async def send_prompt(
+        self, prompt: PromptMessageMultipart, agent_name: Optional[str] = None
+    ) -> str:
+        """
+        Send a PromptMessageMultipart to an agent
+
+        Args:
+            prompt: The PromptMessageMultipart to send
+            agent_name: The name of the agent to send to (uses default if None)
+
+        Returns:
+            The agent's response as a string
+        """
+        target = agent_name or self._default
+        if not target:
+            raise ValueError("No default agent available")
+
+        if target not in self._agents:
+            raise ValueError(f"No agent named '{target}'")
+
+        proxy = self._agents[target]
+        return await proxy.send_prompt(prompt)
+
+    async def send(
+        self,
+        message: Union[str, PromptMessageMultipart] = None,
+        agent_name: Optional[str] = None,
+    ) -> str:
+        """
+        Send a message to the default agent or specified agent
+
+        Args:
+            message: Either a string message or a PromptMessageMultipart object
+            agent_name: The name of the agent to send to (uses default if None)
+
+        Returns:
+            The agent's response as a string
+        """
+        target = agent_name or self._default
+        if not target:
+            raise ValueError("No default agent available")
+
+        if target not in self._agents:
+            raise ValueError(f"No agent named '{target}'")
 
-        if not message or "" == message:
-            return await self.prompt(agent_name)
+        proxy = self._agents[target]
+        return await proxy.send(message)
+
+    async def apply_prompt(
+        self,
+        prompt_name: str,
+        arguments: Optional[dict[str, str]] = None,
+        agent_name: Optional[str] = None,
+    ) -> str:
+        """
+        Apply an MCP Server Prompt by name and return the assistant's response
 
-        proxy = self._agents[agent_name]
-        return await proxy.generate_str(message)
+        Args:
+            prompt_name: The name of the prompt to apply
+            arguments: Optional dictionary of string arguments to pass to the prompt template
+            agent_name: The name of the agent to use (uses default if None)
+
+        Returns:
+            The assistant's response as a string
+        """
+        target = agent_name or self._default
+        if not target:
+            raise ValueError("No default agent available")
+
+        if target not in self._agents:
+            raise ValueError(f"No agent named '{target}'")
+
+        proxy = self._agents[target]
+        return await proxy.apply_prompt(prompt_name, arguments)
 
     async def prompt(self, agent_name: Optional[str] = None, default: str = "") -> str:
         """
@@ -506,7 +571,7 @@ class AgentApp:
                 if user_input == "":
                     continue
 
-            result = await self.send(agent, user_input)
+            result = await self.send(user_input, agent)
 
             # Check if current agent is a chain that should continue with final agent
             if agent_types.get(agent) == "Chain":
@@ -532,10 +597,21 @@ class AgentApp:
         return self._agents[name]
 
     async def __call__(
-        self, message: Optional[str] = "", agent_name: Optional[str] = None
+        self,
+        message: Optional[Union[str, PromptMessageMultipart]] = None,
+        agent_name: Optional[str] = None,
     ) -> str:
-        """Support: agent('message')"""
+        """
+        Support: agent('message') or agent(Prompt.user('message'))
+
+        Args:
+            message: Either a string message or a PromptMessageMultipart object
+            agent_name: The name of the agent to use (uses default if None)
+
+        Returns:
+            The agent's response as a string
+        """
         target = agent_name or self._default
         if not target:
             raise ValueError("No default agent available")
-        return await self.send(target, message)
+        return await self.send(message, target)

mcp_agent/core/fastagent.py

@@ -70,7 +70,12 @@ class FastAgent(ContextDependent):
     Provides a simplified way to create and manage agents using decorators.
     """
 
-    def __init__(self, name: str, config_path: Optional[str] = None):
+    def __init__(
+        self,
+        name: str,
+        config_path: Optional[str] = None,
+        ignore_unknown_args: bool = False,
+    ):
         """
         Initialize the decorator interface.
 
@@ -101,7 +106,12 @@ class FastAgent(ContextDependent):
             action="store_true",
             help="Disable progress display, tool and message logging for cleaner output",
         )
-        self.args = parser.parse_args()
+
+        if ignore_unknown_args:
+            known_args, _ = parser.parse_known_args()
+            self.args = known_args
+        else:
+            self.args = parser.parse_args()
 
         # Quiet mode will be handled in _load_config()
 
@@ -372,7 +382,7 @@ class FastAgent(ContextDependent):
 
                 # Create wrapper with all agents
                 wrapper = AgentApp(agent_app, active_agents)
-                
+
                 # Store reference to AgentApp in MCPApp for proxies to access
                 agent_app._agent_app = wrapper
 

mcp_agent/core/mcp_content.py

@@ -0,0 +1,222 @@
+"""
+Helper functions for creating MCP content types with minimal code.
+
+This module provides simple functions to create TextContent, ImageContent,
+EmbeddedResource, and other MCP content types with minimal boilerplate.
+"""
+
+import base64
+from pathlib import Path
+from typing import Literal, Optional, Union, List, Any
+
+from mcp.types import (
+    TextContent,
+    ImageContent,
+    EmbeddedResource,
+    TextResourceContents,
+    BlobResourceContents,
+)
+
+from mcp_agent.mcp.mime_utils import (
+    guess_mime_type,
+    is_binary_content,
+    is_image_mime_type,
+)
+
+
+def MCPText(
+    text: str,
+    role: Literal["user", "assistant"] = "user",
+    annotations: Optional[dict] = None,
+) -> dict:
+    """
+    Create a message with text content.
+
+    Args:
+        text: The text content
+        role: Role of the message, defaults to "user"
+        annotations: Optional annotations
+
+    Returns:
+        A dictionary with role and content that can be used in a prompt
+    """
+    return {
+        "role": role,
+        "content": TextContent(type="text", text=text, annotations=annotations),
+    }
+
+
+def MCPImage(
+    path: Union[str, Path] = None,
+    data: bytes = None,
+    mime_type: Optional[str] = None,
+    role: Literal["user", "assistant"] = "user",
+    annotations: Optional[dict] = None,
+) -> dict:
+    """
+    Create a message with image content.
+
+    Args:
+        path: Path to the image file
+        data: Raw image data bytes (alternative to path)
+        mime_type: Optional mime type, will be guessed from path if not provided
+        role: Role of the message, defaults to "user"
+        annotations: Optional annotations
+
+    Returns:
+        A dictionary with role and content that can be used in a prompt
+    """
+    if path is None and data is None:
+        raise ValueError("Either path or data must be provided")
+
+    if path is not None and data is not None:
+        raise ValueError("Only one of path or data can be provided")
+
+    if path is not None:
+        path = Path(path)
+        if not mime_type:
+            mime_type = guess_mime_type(str(path))
+        with open(path, "rb") as f:
+            data = f.read()
+
+    if not mime_type:
+        mime_type = "image/png"  # Default
+
+    b64_data = base64.b64encode(data).decode("ascii")
+
+    return {
+        "role": role,
+        "content": ImageContent(
+            type="image", data=b64_data, mimeType=mime_type, annotations=annotations
+        ),
+    }
+
+
+def MCPFile(
+    path: Union[str, Path],
+    mime_type: Optional[str] = None,
+    role: Literal["user", "assistant"] = "user",
+    annotations: Optional[dict] = None,
+) -> dict:
+    """
+    Create a message with an embedded resource from a file.
+
+    Args:
+        path: Path to the resource file
+        mime_type: Optional mime type, will be guessed from path if not provided
+        role: Role of the message, defaults to "user"
+        annotations: Optional annotations
+
+    Returns:
+        A dictionary with role and content that can be used in a prompt
+    """
+    path = Path(path)
+    uri = f"file://{path.absolute()}"
+
+    if not mime_type:
+        mime_type = guess_mime_type(str(path))
+
+    # Determine if this is text or binary content
+    is_binary = is_binary_content(mime_type)
+
+    if is_binary:
+        # Read as binary
+        binary_data = path.read_bytes()
+        b64_data = base64.b64encode(binary_data).decode("ascii")
+
+        resource = BlobResourceContents(uri=uri, blob=b64_data, mimeType=mime_type)
+    else:
+        # Read as text
+        try:
+            text_data = path.read_text(encoding="utf-8")
+            resource = TextResourceContents(uri=uri, text=text_data, mimeType=mime_type)
+        except UnicodeDecodeError:
+            # Fallback to binary if text read fails
+            binary_data = path.read_bytes()
+            b64_data = base64.b64encode(binary_data).decode("ascii")
+            resource = BlobResourceContents(
+                uri=uri, blob=b64_data, mimeType=mime_type or "application/octet-stream"
+            )
+
+    return {
+        "role": role,
+        "content": EmbeddedResource(
+            type="resource", resource=resource, annotations=annotations
+        ),
+    }
+
+
+
+def MCPPrompt(
+    *content_items, role: Literal["user", "assistant"] = "user"
+) -> List[dict]:
+    """
+    Create one or more prompt messages with various content types.
+
+    This function intelligently creates different content types:
+    - Strings become TextContent 
+    - File paths with image mime types become ImageContent
+    - File paths with text mime types or other mime types become EmbeddedResource
+    - Dicts with role and content are passed through unchanged
+    - Raw bytes become ImageContent
+
+    Args:
+        *content_items: Content items of various types
+        role: Role for all items (user or assistant)
+
+    Returns:
+        List of messages that can be used in a prompt
+    """
+    result = []
+
+    for item in content_items:
+        if isinstance(item, dict) and "role" in item and "content" in item:
+            # Already a fully formed message
+            result.append(item)
+        elif isinstance(item, str) and not Path(item).exists():
+            # Simple text content (that's not a file path)
+            result.append(MCPText(item, role=role))
+        elif isinstance(item, Path) or isinstance(item, str):
+            # File path - determine the content type based on mime type
+            path_str = str(item)
+            mime_type = guess_mime_type(path_str)
+            
+            if is_image_mime_type(mime_type):
+                # Image files (except SVG which is handled as text)
+                result.append(MCPImage(path=item, role=role))
+            else:
+                # All other file types (text documents, PDFs, SVGs, etc.)
+                result.append(MCPFile(path=item, role=role))
+        elif isinstance(item, bytes):
+            # Raw binary data, assume image
+            result.append(MCPImage(data=item, role=role))
+        else:
+            # Try to convert to string
+            result.append(MCPText(str(item), role=role))
+
+    return result
+
+
+def User(*content_items) -> List[dict]:
+    """Create user message(s) with various content types."""
+    return MCPPrompt(*content_items, role="user")
+
+
+def Assistant(*content_items) -> List[dict]:
+    """Create assistant message(s) with various content types."""
+    return MCPPrompt(*content_items, role="assistant")
+
+
+def create_message(content: Any, role: Literal["user", "assistant"] = "user") -> dict:
+    """
+    Create a single prompt message from content of various types.
+
+    Args:
+        content: Content of various types (str, Path, bytes, etc.)
+        role: Role of the message
+
+    Returns:
+        A dictionary with role and content that can be used in a prompt
+    """
+    messages = MCPPrompt(content, role=role)
+    return messages[0] if messages else {}