fast-agent-mcp 0.2.17__py3-none-any.whl → 0.2.19__py3-none-any.whl

{fast_agent_mcp-0.2.17.dist-info → fast_agent_mcp-0.2.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.17
+Version: 0.2.19
 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
@@ -214,16 +214,16 @@ Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.49.0
 Requires-Dist: fastapi>=0.115.6
 Requires-Dist: mcp==1.6.0
-Requires-Dist: numpy>=2.2.1
 Requires-Dist: openai>=1.63.2
 Requires-Dist: opentelemetry-distro>=0.50b0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.29.0
+Requires-Dist: opentelemetry-instrumentation-anthropic>=0.39.3
+Requires-Dist: opentelemetry-instrumentation-openai>=0.39.3
 Requires-Dist: prompt-toolkit>=3.0.50
 Requires-Dist: pydantic-settings>=2.7.0
 Requires-Dist: pydantic>=2.10.4
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=13.9.4
-Requires-Dist: scikit-learn>=1.6.0
 Requires-Dist: typer>=0.15.1
 Provides-Extra: dev
 Requires-Dist: anthropic>=0.42.0; extra == 'dev'
@@ -251,7 +251,7 @@ 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. llms.txt link is here: https://fast-agent.ai/llms.txt
+> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. There is also an LLMs.txt [here](https://fast-agent.ai/llms.txt)
 
 **`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/gpt-4.1 family, o1/o3 family) are supported.
 
@@ -259,7 +259,8 @@ The simple declarative syntax lets you concentrate on composing your Prompts and
 
 `fast-agent` is multi-modal, supporting Images and PDFs for both Anthropic and OpenAI endpoints via Prompts, Resources and MCP Tool Call results. The inclusion of passthrough and playback LLMs enable rapid development and test of Python glue-code for your applications.
 
-> [!TIP] > `fast-agent` is now MCP Native! Coming Soon - Full Documentation Site and Further MCP Examples.
+> [!IMPORTANT]
+> `fast-agent` The fast-agent documentation repo is here: https://github.com/evalstate/fast-agent-docs. Please feel free to submit PRs for documentation, experience reports or other content you think others may find helpful. All help and feedback warmly received.
 
 ### Agent Application Development
 
@@ -449,10 +450,10 @@ If the Generator has `use_history` off, the previous iteration is returned when
 
 ```python
 @fast.evaluator_optimizer(
-  name="researcher"
-  generator="web_searcher"
-  evaluator="quality_assurance"
-  min_rating="EXCELLENT"
+  name="researcher",
+  generator="web_searcher",
+  evaluator="quality_assurance",
+  min_rating="EXCELLENT",
   max_refinements=3
 )
 
@@ -470,8 +471,8 @@ Routers use an LLM to assess a message, and route it to the most appropriate Age
 
 ```python
 @fast.router(
-  name="route"
-  agents["agent1","agent2","agent3"]
+  name="route",
+  agents=["agent1","agent2","agent3"]
 )
 ```
 
@@ -483,7 +484,7 @@ Given a complex task, the Orchestrator uses an LLM to generate a plan to divide
 
 ```python
 @fast.orchestrator(
-  name="orchestrate"
+  name="orchestrate",
   agents=["task1","task2","task3"]
 )
 ```
@@ -523,7 +524,7 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
   servers=["filesystem"],                # list of MCP Servers for the agent
   model="o3-mini.high",                  # specify a model for the agent
   use_history=True,                      # agent maintains chat history
-  request_params=RequestParams(temperature= 0.7)), # additional parameters for the LLM (or RequestParams())
+  request_params=RequestParams(temperature= 0.7), # additional parameters for the LLM (or RequestParams())
   human_input=True,                      # agent can request human input
 )
 ```
@@ -535,7 +536,7 @@ agent["greeter"].send("Good Evening!")          # Dictionary access is supported
   name="chain",                          # name of the chain
   sequence=["agent1", "agent2", ...],    # list of agents in execution order
   instruction="instruction",             # instruction to describe the chain for other workflows
-  cumulative=False                       # whether to accumulate messages through the chain
+  cumulative=False,                      # whether to accumulate messages through the chain
   continue_with_final=True,              # open chat with agent at end of chain after prompting
 )
 ```

{fast_agent_mcp-0.2.17.dist-info → fast_agent_mcp-0.2.19.dist-info}/RECORD

@@ -1,53 +1,54 @@
 mcp_agent/__init__.py,sha256=-AIoeL4c9UAp_P4U0z-uIWTTmQWdihOis5nbQ5L_eao,1664
 mcp_agent/app.py,sha256=WRsiUdwy_9IAnaGRDwuLm7pzgQpt2wgsg10vBOpfcwM,5539
-mcp_agent/config.py,sha256=eEknK8I7DCrh1iGqzva0TemHMzjlbfhFhgwULqaKjDs,12218
+mcp_agent/config.py,sha256=4MB8QBwGb6MPPRc85p-xdCzRloGwpWsPfEgxsoS_4N0,12159
 mcp_agent/console.py,sha256=Gjf2QLFumwG1Lav__c07X_kZxxEUSkzV-1_-YbAwcwo,813
-mcp_agent/context.py,sha256=GEZQ64UCvLj6bRXGNm35Hxd5jxrI_P52vhC3opnWwsg,7246
+mcp_agent/context.py,sha256=fHyDjeZpHYRBOCVY58hVcFQxybOXSJmuui2o51kLbuA,7307
 mcp_agent/context_dependent.py,sha256=QXfhw3RaQCKfscEEBRGuZ3sdMWqkgShz2jJ1ivGGX1I,1455
 mcp_agent/event_progress.py,sha256=3dqk5Pn1tAG_m_wn4IPNwLWLyzm7CyKIidqHN-4l-JY,2736
 mcp_agent/mcp_server_registry.py,sha256=pSD3euU-Oc2LAVenqkLU7UmutAzk6A9liYVLjCj4J70,10068
 mcp_agent/progress_display.py,sha256=GeJU9VUt6qKsFVymG688hCMVCsAygG9ifiiEb5IcbN4,361
 mcp_agent/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/agents/agent.py,sha256=GgaUHoilgqzh9PQYr5k2WiPj4pagwicf9-ZLFsHkNNo,3848
-mcp_agent/agents/base_agent.py,sha256=c_jhC6tt6LdvS1IY4AVdMNj3n_OtluzHQ1-_NEOseEQ,25039
+mcp_agent/agents/base_agent.py,sha256=fjDr01-hZ9sB3ghI4DlXYVePP0s5f9pmtLH-N3X8bRg,25294
 mcp_agent/agents/workflow/__init__.py,sha256=HloteEW6kalvgR0XewpiFAqaQlMPlPJYg5p3K33IUzI,25
 mcp_agent/agents/workflow/chain_agent.py,sha256=eIlImirrSXkqBJmPuAJgOKis81Cl6lZEGM0-6IyaUV8,6105
 mcp_agent/agents/workflow/evaluator_optimizer.py,sha256=ysUMGM2NzeCIutgr_vXH6kUPpZMw0cX4J_Wl1r8eT84,13296
 mcp_agent/agents/workflow/orchestrator_agent.py,sha256=byZe4bx7D_7BSZZ3hN8BNUWVFPYeqeUwDUCLTRC8mlI,21583
 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=GQTxAqwrPEdle-rPWMvoLOuzE_X69_HYEgYSm98eXdM,7087
-mcp_agent/agents/workflow/router_agent.py,sha256=NugAJcA1ooZ-TNLNh7H26xIFChZoryxofJ7fTkrw4cU,9128
+mcp_agent/agents/workflow/parallel_agent.py,sha256=JaQFp35nmAdoBRLAwx8BfnK7kirVq9PMw24LQ3ZEzoc,7705
+mcp_agent/agents/workflow/router_agent.py,sha256=yZUUhAmni2wAutQJ32EQ264Uh_MIriVP-AmhKFrYTeQ,9472
 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=m0Ndb8y5qCfYyTDBDaJ4g1TuUiX-xtTKNJJDPsltw6o,2884
+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=9Ryxo_fLInm3YKdYv46yLrAJgnQtMisGreu6Kkriw2g,16677
+mcp_agent/cli/commands/go.py,sha256=DJpmq4n-p5r8BXH10UqBOexmLND-zSODl5f-w4noR5Q,4304
 mcp_agent/cli/commands/quickstart.py,sha256=SM3CHMzDgvTxIpKjFuX9BrS_N1vRoXNBDaO90aWx1Rk,14586
-mcp_agent/cli/commands/setup.py,sha256=hToVzlCDucf1RI6Jri7BPuSeNA6Y67ONG-nyUT-n7tE,6472
+mcp_agent/cli/commands/setup.py,sha256=eOEd4TL-b0DaDeSJMGOfNOsTEItoZ67W88eTP4aP-bo,6482
 mcp_agent/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/core/agent_app.py,sha256=5nQJNo8DocIRWiX4pVKAHUZF8s6HWpc-hJnfzl_1v1c,9697
 mcp_agent/core/agent_types.py,sha256=bQVQMTwKH7qHIJsNglj4C_d6PNFBBzC_0RIkcENSII4,1459
 mcp_agent/core/direct_decorators.py,sha256=aaVR4G6a8H9pVg6X_PGEZ8GzreP0ZO1-48ksIKvMNDI,14452
 mcp_agent/core/direct_factory.py,sha256=d96OM1yS3eIocIiaA9FQt6C2zr6VDUyCJBTZCp_D4bs,17912
-mcp_agent/core/enhanced_prompt.py,sha256=kEgeD7F1s8LRZDc3Xr6CIxQxewxXy9z-0xZsxfIblsY,18851
+mcp_agent/core/enhanced_prompt.py,sha256=bzvcengS7XzHWB7NWhyxHM3hhO2HI4zP5DbGXAOw0Jw,19155
 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=NahciY0tY6K-rvSzkSgahzGXAWa-1nN2JgMlvRTze6E,18645
-mcp_agent/core/interactive_prompt.py,sha256=9s5c-XXGAKAqYh1SUVQIMRGFIcxfFjkaPmke1tyInaA,23854
+mcp_agent/core/fastagent.py,sha256=OkS1mazgMUJyA02RbW-9z2nI6XQ4kKCLfyjgAkgv0O8,22708
+mcp_agent/core/interactive_prompt.py,sha256=w3VyRzW4hzn0xhWZRwo_qRRAD5WVSrJYe8QDe1XZ55Y,24252
 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=loYf13DN7e-DsdYRd37jWkJWJGwVBL-iFkcANP1J60Q,1366
-mcp_agent/core/validation.py,sha256=Kmio1Xx-xNyCVd03RLfTxofEAWmVDPxUnQoyOSUMjR0,11445
+mcp_agent/core/validation.py,sha256=RIBKFlh0GJg4rTcFQXoXp8A0sK1HpsCigKcYSK3gFaY,12090
 mcp_agent/executor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_agent/executor/executor.py,sha256=MzLSnW9nHrLHYChR3oQa5B8dajQGX26q6-S2BJCxv0o,9507
+mcp_agent/executor/executor.py,sha256=E44p6d-o3OMRoP_dNs_cDnyti91LQ3P9eNU88mSi1kc,9462
 mcp_agent/executor/task_registry.py,sha256=PCALFeYtkQrPBg4RBJnlA0aDI8nHclrNkHGUS4kV3W8,1242
 mcp_agent/executor/workflow_signal.py,sha256=Cg1uZBk3fn8kXhPOg-wINNuVaf3v9pvLD6NbqWy5Z6E,11142
 mcp_agent/human_input/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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=4zKEErhSROrcc1fojCXRFb13UlaOzWvB0jO_XdlcCWM,23378
+mcp_agent/llm/augmented_llm.py,sha256=fP2uWIFY9qaEuY0mehti4A3NjhvGuj-TebLI0FVTbcM,23380
 mcp_agent/llm/augmented_llm_passthrough.py,sha256=zHcctNpwg4EFJvD1x9Eg443SVX-uyzFphLikwF_yVE0,6288
 mcp_agent/llm/augmented_llm_playback.py,sha256=6L_RWIK__R67oZK7u3Xt3hWy1T2LnHXIO-efqgP3tPw,4177
 mcp_agent/llm/memory.py,sha256=HQ_c1QemOUjrkY6Z2omE6BG5fXga7y4jN7KCMOuGjPs,3345
@@ -59,11 +60,11 @@ mcp_agent/llm/sampling_converter.py,sha256=C7wPBlmT0eD90XWabC22zkxsrVHKCrjwIwg6c
 mcp_agent/llm/sampling_format_converter.py,sha256=xGz4odHpOcP7--eFaJaFtUR8eR9jxZS7MnLH6J7n0EU,1263
 mcp_agent/llm/providers/__init__.py,sha256=heVxtmuqFJOnjjxHz4bWSqTAxXoN1E8twC_gQ_yJpHk,265
 mcp_agent/llm/providers/anthropic_utils.py,sha256=vYDN5G5jKMhD2CQg8veJYab7tvvzYkDMq8M1g_hUAQg,3275
-mcp_agent/llm/providers/augmented_llm_anthropic.py,sha256=GuqBJvkaM8SQ3NYBnMlKrV56dACLafhKec-Hl84qOi8,15344
-mcp_agent/llm/providers/augmented_llm_deepseek.py,sha256=MHsCffnrXpiWdUCpVTUblILVBTQtBnbX7atwny0X2N8,1210
+mcp_agent/llm/providers/augmented_llm_anthropic.py,sha256=poouQMsDoZSH-5a_TL2Z2EFPSqFlsAgXuKuYcqge-Gg,15468
+mcp_agent/llm/providers/augmented_llm_deepseek.py,sha256=NiZK5nv91ZS2VgVFXpbsFNFYLsLcppcbo_RstlRMd7I,1145
 mcp_agent/llm/providers/augmented_llm_generic.py,sha256=5Uq8ZBhcFuQTt7koP_5ykolREh2iWu8zKhNbh3pM9lQ,1210
 mcp_agent/llm/providers/augmented_llm_google.py,sha256=N0a2fphVtkvNYxKQpEX6J4tlO1C_mRw4sw3LBXnrOeI,1130
-mcp_agent/llm/providers/augmented_llm_openai.py,sha256=YDumEOjuhvAcqOOdw6xsy902lyC30iqgl1V2lS6PfTA,13911
+mcp_agent/llm/providers/augmented_llm_openai.py,sha256=XFFoIMmXCoigC98zrR0_1c7DsyS4ep7hLvklmdn4jqU,14085
 mcp_agent/llm/providers/augmented_llm_openrouter.py,sha256=V_TlVKm92GHBxYIo6gpvH_6cAaIdppS25Tz6x5T7LW0,2341
 mcp_agent/llm/providers/multipart_converter_anthropic.py,sha256=t5lHYGfFUacJldnrVtMNW-8gEMoto8Y7hJkDrnyZR-Y,16650
 mcp_agent/llm/providers/multipart_converter_openai.py,sha256=XPIulWntNpZWNGWrc240StPzok2RqrDAV7OigDwQ1uU,15850
@@ -77,15 +78,14 @@ mcp_agent/logging/json_serializer.py,sha256=qkfxnR9ka6OgvwSpM2CggELbEtzzkApm0s_K
 mcp_agent/logging/listeners.py,sha256=_S4Jp5_KWp0kUfrx4BxDdNCeQK3MNT3Zi9AaolPri7A,6648
 mcp_agent/logging/logger.py,sha256=l02OGX_c5FOyH0rspd4ZvnkJcbb0FahhUhlh2KI8mqE,10724
 mcp_agent/logging/rich_progress.py,sha256=oY9fjb4Tyw6887v8sgO6EGIK4lnmIoR3NNxhA_-Ln_M,4893
-mcp_agent/logging/tracing.py,sha256=d5lSXakzzi5PtQpUkVkOnYaGX8NduGPq__S7vx-Ln8U,5187
 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=PAou8znAl2HgtvfCpLQOZFbKra9F72OcVRfBJbboNX8,6965
 mcp_agent/mcp/logger_textio.py,sha256=vljC1BtNTCxBAda9ExqNB-FwVNUZIuJT3h1nWmCjMws,3172
 mcp_agent/mcp/mcp_agent_client_session.py,sha256=RMYNltc2pDIzxwEJSS5589RbvPO0KWV4Y3jSyAmhKf0,4181
-mcp_agent/mcp/mcp_aggregator.py,sha256=YVLqcv5dS5Z8yEpQggru69NzqQBFKpXG8_CG0XAN3qk,40219
-mcp_agent/mcp/mcp_connection_manager.py,sha256=FGFF3DruVcHD_8J-VadrRyyrOiiq-N9-_ZzIdx4NUOA,13973
+mcp_agent/mcp/mcp_aggregator.py,sha256=RjRcYHMKt5Wn85JWVar6X0hZLYtBeHrctiBBAK5AYcc,40584
+mcp_agent/mcp/mcp_connection_manager.py,sha256=R_oGvFkolZJ_i3SizIIlKS_NPjXscsWLSOf1x9Zu0dM,14008
 mcp_agent/mcp/mime_utils.py,sha256=difepNR_gpb4MpMLkBRAoyhDk-AjXUHTiqKvT_VwS1o,1805
 mcp_agent/mcp/prompt_message_multipart.py,sha256=BDwRdNwyWHb2q2bccDb2iR2VlORqVvkvoG3xYzcMpCE,4403
 mcp_agent/mcp/prompt_render.py,sha256=k3v4BZDThGE2gGiOYVQtA6x8WTEdOuXIEnRafANhN1U,2996
@@ -143,8 +143,8 @@ mcp_agent/resources/examples/workflows/parallel.py,sha256=DQ5vY5-h8Qa5QHcYjsWXhZ
 mcp_agent/resources/examples/workflows/router.py,sha256=E4x_-c3l4YW9w1i4ARcDtkdeqIdbWEGfsMzwLYpdbVc,1677
 mcp_agent/resources/examples/workflows/short_story.txt,sha256=X3y_1AyhLFN2AKzCKvucJtDgAFIJfnlbsbGZO5bBWu0,1187
 mcp_agent/ui/console_display.py,sha256=TVGDtJ37hc6UG0ei9g7ZPZZfFNeS1MYozt-Mx8HsPCk,9752
-fast_agent_mcp-0.2.17.dist-info/METADATA,sha256=qH-sDtu59orBDwzB0M73kx9CZUfey-5g2izt3Ewjz0A,29893
-fast_agent_mcp-0.2.17.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.2.17.dist-info/entry_points.txt,sha256=bRniFM5zk3Kix5z7scX0gf9VnmGQ2Cz_Q1Gh7Ir4W00,186
-fast_agent_mcp-0.2.17.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
-fast_agent_mcp-0.2.17.dist-info/RECORD,,
+fast_agent_mcp-0.2.19.dist-info/METADATA,sha256=slU0l8N_MAEEmGn3bla4jeHibkCq3DGTtngvii6xrro,30142
+fast_agent_mcp-0.2.19.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.2.19.dist-info/entry_points.txt,sha256=bRniFM5zk3Kix5z7scX0gf9VnmGQ2Cz_Q1Gh7Ir4W00,186
+fast_agent_mcp-0.2.19.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
+fast_agent_mcp-0.2.19.dist-info/RECORD,,

mcp_agent/agents/base_agent.py

@@ -31,6 +31,7 @@ from mcp.types import (
     TextContent,
     Tool,
 )
+from opentelemetry import trace
 from pydantic import BaseModel
 
 from mcp_agent.core.agent_types import AgentConfig, AgentType
@@ -92,6 +93,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         )
 
         self._context = context
+        self.tracer = trace.get_tracer(__name__)
         self.name = self.config.name
         self.instruction = self.config.instruction
         self.functions = functions or []
@@ -588,7 +590,8 @@ class BaseAgent(MCPAggregator, AgentProtocol):
             The LLM's response as a PromptMessageMultipart
         """
         assert self._llm
-        return await self._llm.generate(multipart_messages, request_params)
+        with self.tracer.start_as_current_span(f"Agent: '{self.name}' generate"):
+            return await self._llm.generate(multipart_messages, request_params)
 
     async def structured(
         self,
@@ -609,7 +612,8 @@ class BaseAgent(MCPAggregator, AgentProtocol):
             An instance of the specified model, or None if coercion fails
         """
         assert self._llm
-        return await self._llm.structured(multipart_messages, model, request_params)
+        with self.tracer.start_as_current_span(f"Agent: '{self.name}' structured"):
+            return await self._llm.structured(multipart_messages, model, request_params)
 
     async def apply_prompt_messages(
         self, prompts: List[PromptMessageMultipart], request_params: RequestParams | None = None

mcp_agent/agents/workflow/parallel_agent.py

@@ -2,6 +2,7 @@ import asyncio
 from typing import Any, List, Optional, Tuple
 
 from mcp.types import TextContent
+from opentelemetry import trace
 
 from mcp_agent.agents.agent import Agent
 from mcp_agent.agents.base_agent import BaseAgent
@@ -18,7 +19,7 @@ class ParallelAgent(BaseAgent):
     This workflow performs both the fan-out and fan-in operations using LLMs.
     From the user's perspective, an input is specified and the output is returned.
     """
-    
+
     @property
     def agent_type(self) -> AgentType:
         """Return the type of this agent."""
@@ -62,31 +63,37 @@ class ParallelAgent(BaseAgent):
         Returns:
             The aggregated response from the fan-in agent
         """
-        # Execute all fan-out agents in parallel
-        responses: List[PromptMessageMultipart] = await asyncio.gather(
-            *[agent.generate(multipart_messages, request_params) for agent in self.fan_out_agents]
-        )
 
-        # Extract the received message from the input
-        received_message: Optional[str] = (
-            multipart_messages[-1].all_text() if multipart_messages else None
-        )
+        tracer = trace.get_tracer(__name__)
+        with tracer.start_as_current_span(f"Parallel: '{self.name}' generate"):
+            # Execute all fan-out agents in parallel
+            responses: List[PromptMessageMultipart] = await asyncio.gather(
+                *[
+                    agent.generate(multipart_messages, request_params)
+                    for agent in self.fan_out_agents
+                ]
+            )
 
-        # Convert responses to strings for aggregation
-        string_responses = []
-        for response in responses:
-            string_responses.append(response.all_text())
+            # Extract the received message from the input
+            received_message: Optional[str] = (
+                multipart_messages[-1].all_text() if multipart_messages else None
+            )
 
-        # Format the responses and send to the fan-in agent
-        aggregated_prompt = self._format_responses(string_responses, received_message)
+            # Convert responses to strings for aggregation
+            string_responses = []
+            for response in responses:
+                string_responses.append(response.all_text())
 
-        # Create a new multipart message with the formatted responses
-        formatted_prompt = PromptMessageMultipart(
-            role="user", content=[TextContent(type="text", text=aggregated_prompt)]
-        )
+            # Format the responses and send to the fan-in agent
+            aggregated_prompt = self._format_responses(string_responses, received_message)
+
+            # Create a new multipart message with the formatted responses
+            formatted_prompt = PromptMessageMultipart(
+                role="user", content=[TextContent(type="text", text=aggregated_prompt)]
+            )
 
-        # Use the fan-in agent to aggregate the responses
-        return await self.fan_in_agent.generate([formatted_prompt], request_params)
+            # Use the fan-in agent to aggregate the responses
+            return await self.fan_in_agent.generate([formatted_prompt], request_params)
 
     def _format_responses(self, responses: List[Any], message: Optional[str] = None) -> str:
         """
@@ -116,7 +123,7 @@ class ParallelAgent(BaseAgent):
 
     async def structured(
         self,
-        prompt: List[PromptMessageMultipart],
+        multipart_messages: List[PromptMessageMultipart],
         model: type[ModelT],
         request_params: Optional[RequestParams] = None,
     ) -> Tuple[ModelT | None, PromptMessageMultipart]:
@@ -133,27 +140,35 @@ class ParallelAgent(BaseAgent):
         Returns:
             An instance of the specified model, or None if coercion fails
         """
-        # Generate parallel responses first
-        responses: List[PromptMessageMultipart] = await asyncio.gather(
-            *[agent.generate(prompt, request_params) for agent in self.fan_out_agents]
-        )
 
-        # Extract the received message
-        received_message: Optional[str] = prompt[-1].all_text() if prompt else None
+        tracer = trace.get_tracer(__name__)
+        with tracer.start_as_current_span(f"Parallel: '{self.name}' generate"):
+            # Generate parallel responses first
+            responses: List[PromptMessageMultipart] = await asyncio.gather(
+                *[
+                    agent.generate(multipart_messages, request_params)
+                    for agent in self.fan_out_agents
+                ]
+            )
 
-        # Convert responses to strings
-        string_responses = [response.all_text() for response in responses]
+            # Extract the received message
+            received_message: Optional[str] = (
+                multipart_messages[-1].all_text() if multipart_messages else None
+            )
 
-        # Format the responses for the fan-in agent
-        aggregated_prompt = self._format_responses(string_responses, received_message)
+            # Convert responses to strings
+            string_responses = [response.all_text() for response in responses]
 
-        # Create a multipart message
-        formatted_prompt = PromptMessageMultipart(
-            role="user", content=[TextContent(type="text", text=aggregated_prompt)]
-        )
+            # Format the responses for the fan-in agent
+            aggregated_prompt = self._format_responses(string_responses, received_message)
+
+            # Create a multipart message
+            formatted_prompt = PromptMessageMultipart(
+                role="user", content=[TextContent(type="text", text=aggregated_prompt)]
+            )
 
-        # Use the fan-in agent to parse the structured output
-        return await self.fan_in_agent.structured([formatted_prompt], model, request_params)
+            # Use the fan-in agent to parse the structured output
+            return await self.fan_in_agent.structured([formatted_prompt], model, request_params)
 
     async def initialize(self) -> None:
         """

mcp_agent/agents/workflow/router_agent.py

@@ -7,6 +7,7 @@ by determining the best agent for a request and dispatching to it.
 
 from typing import TYPE_CHECKING, Callable, List, Optional, Tuple, Type
 
+from opentelemetry import trace
 from pydantic import BaseModel
 
 from mcp_agent.agents.agent import Agent
@@ -158,17 +159,18 @@ class RouterAgent(BaseAgent):
         Returns:
             The response from the selected agent
         """
+        tracer = trace.get_tracer(__name__)
+        with tracer.start_as_current_span(f"Routing: '{self.name}' generate"):
+            route, warn = await self._route_request(multipart_messages[-1])
 
-        route, warn = await self._route_request(multipart_messages[-1])
+            if not route:
+                return Prompt.assistant(warn or "No routing result or warning received")
 
-        if not route:
-            return Prompt.assistant(warn or "No routing result or warning received")
+            # Get the selected agent
+            agent: Agent = self.agent_map[route.agent]
 
-        # Get the selected agent
-        agent: Agent = self.agent_map[route.agent]
-
-        # Dispatch the request to the selected agent
-        return await agent.generate(multipart_messages, request_params)
+            # Dispatch the request to the selected agent
+            return await agent.generate(multipart_messages, request_params)
 
     async def structured(
         self,
@@ -187,18 +189,21 @@ class RouterAgent(BaseAgent):
         Returns:
             The parsed response from the selected agent, or None if parsing fails
         """
-        route, warn = await self._route_request(multipart_messages[-1])
 
-        if not route:
-            return None, Prompt.assistant(
-                warn or "No routing result or warning received (structured)"
-            )
+        tracer = trace.get_tracer(__name__)
+        with tracer.start_as_current_span(f"Routing: '{self.name}' structured"):
+            route, warn = await self._route_request(multipart_messages[-1])
+
+            if not route:
+                return None, Prompt.assistant(
+                    warn or "No routing result or warning received (structured)"
+                )
 
-        # Get the selected agent
-        agent: Agent = self.agent_map[route.agent]
+            # Get the selected agent
+            agent: Agent = self.agent_map[route.agent]
 
-        # Dispatch the request to the selected agent
-        return await agent.structured(multipart_messages, model, request_params)
+            # Dispatch the request to the selected agent
+            return await agent.structured(multipart_messages, model, request_params)
 
     async def _route_request(
         self, message: PromptMessageMultipart

mcp_agent/cli/commands/go.py

@@ -0,0 +1,133 @@
+"""Run an interactive agent directly from the command line."""
+
+import asyncio
+import sys
+from typing import List, Optional
+
+import typer
+
+from mcp_agent.core.fastagent import FastAgent
+
+app = typer.Typer(
+    help="Run an interactive agent directly from the command line without creating an agent.py file"
+)
+
+async def _run_agent(
+    name: str = "FastAgent CLI",
+    instruction: str = "You are a helpful AI Agent.",
+    config_path: Optional[str] = None,
+    server_list: Optional[List[str]] = None,
+    model: Optional[str] = None,
+) -> None:
+    """Async implementation to run an interactive agent."""
+
+    # Create the FastAgent instance with CLI arg parsing enabled
+    # It will automatically parse args like --model, --quiet, etc.
+    fast_kwargs = {
+        "name": name,
+        "config_path": config_path,
+        "ignore_unknown_args": True,
+    }
+    
+    fast = FastAgent(**fast_kwargs)
+
+    # Define the agent with specified parameters
+    agent_kwargs = {"instruction": instruction}
+    if server_list:
+        agent_kwargs["servers"] = server_list
+    if model:
+        agent_kwargs["model"] = model
+    
+    @fast.agent(**agent_kwargs)
+    async def cli_agent():
+        async with fast.run() as agent:
+            await agent.interactive()
+
+    # Run the agent
+    await cli_agent()
+
+def run_async_agent(
+    name: str, 
+    instruction: str, 
+    config_path: Optional[str] = None, 
+    servers: Optional[str] = None,
+    model: Optional[str] = None
+):
+    """Run the async agent function with proper loop handling."""
+    server_list = servers.split(',') if servers else None
+    
+    # Check if we're already in an event loop
+    try:
+        loop = asyncio.get_event_loop()
+        if loop.is_running():
+            # We're inside a running event loop, so we can't use asyncio.run
+            # Instead, create a new loop
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+    except RuntimeError:
+        # No event loop exists, so we'll create one
+        loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(loop)
+    
+    try:
+        loop.run_until_complete(_run_agent(
+            name=name, 
+            instruction=instruction, 
+            config_path=config_path, 
+            server_list=server_list,
+            model=model
+        ))
+    finally:
+        try:
+            # Clean up the loop
+            tasks = asyncio.all_tasks(loop)
+            for task in tasks:
+                task.cancel()
+            
+            # Run the event loop until all tasks are done
+            if sys.version_info >= (3, 7):
+                loop.run_until_complete(asyncio.gather(*tasks, return_exceptions=True))
+            loop.run_until_complete(loop.shutdown_asyncgens())
+            loop.close()
+        except Exception:
+            pass
+
+@app.callback(invoke_without_command=True)
+def go(
+    ctx: typer.Context,
+    name: str = typer.Option("FastAgent CLI", "--name", help="Name for the agent"),
+    instruction: str = typer.Option(
+        "You are a helpful AI Agent.", "--instruction", "-i", help="Instruction for the agent"
+    ),
+    config_path: Optional[str] = typer.Option(
+        None, "--config-path", "-c", help="Path to config file"
+    ),
+    servers: Optional[str] = typer.Option(
+        None, "--servers", help="Comma-separated list of server names to enable from config"
+    ),
+    model: Optional[str] = typer.Option(
+        None, "--model", help="Override the default model (e.g., haiku, sonnet, gpt-4)"
+    ),
+) -> None:
+    """
+    Run an interactive agent directly from the command line.
+
+    Example:
+        fast-agent go --model=haiku --instruction="You are a coding assistant" --servers=fetch,filesystem
+
+    This will start an interactive session with the agent, using the specified model
+    and instruction. It will use the default configuration from fastagent.config.yaml
+    unless --config-path is specified.
+
+    Common options:
+        --model: Override the default model (e.g., --model=haiku)
+        --quiet: Disable progress display and logging
+        --servers: Comma-separated list of server names to enable from config
+    """
+    run_async_agent(
+        name=name, 
+        instruction=instruction, 
+        config_path=config_path, 
+        servers=servers,
+        model=model
+    )

mcp_agent/cli/commands/setup.py

@@ -221,7 +221,7 @@ def init(
         if "fastagent.secrets.yaml" in created:
             console.print("\n[yellow]Important:[/yellow] Remember to:")
             console.print(
-                "1. Add your API keys to fastagent.secrets.yaml or set OPENAI_API_KEY and ANTHROPIC_API_KEY environment variables"
+                "1. Add your API keys to fastagent.secrets.yaml, or set environment variables. Use [cyan]fast-agent check[/cyan] to verify."
             )
             console.print(
                 "2. Keep fastagent.secrets.yaml secure and never commit it to version control"

mcp_agent/cli/main.py

@@ -4,7 +4,7 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
-from mcp_agent.cli.commands import check_config, quickstart, setup
+from mcp_agent.cli.commands import check_config, go, quickstart, setup
 from mcp_agent.cli.terminal import Application
 
 app = typer.Typer(
@@ -13,6 +13,7 @@ app = typer.Typer(
 )
 
 # Subcommands
+app.add_typer(go.app, name="go", help="Run an interactive agent directly from the command line")
 app.add_typer(setup.app, name="setup", help="Set up a new agent project")
 app.add_typer(check_config.app, name="check", help="Show or diagnose fast-agent configuration")
 app.add_typer(quickstart.app, name="bootstrap", help="Create example applications")
@@ -39,14 +40,15 @@ def show_welcome() -> None:
     table.add_column("Command", style="green")
     table.add_column("Description")
 
-    table.add_row("setup", "Create a new agent and configuration files")
+    table.add_row("[bold]go[/bold]", "Start an interactive session with an agent")
+    table.add_row("setup", "Create a new agent template and configuration files")
     table.add_row("check", "Show or diagnose fast-agent configuration")
     table.add_row("quickstart", "Create example applications (workflow, researcher, etc.)")
 
     console.print(table)
 
     console.print(
-        "\n[italic]get started with:[/italic] [cyan]fast-agent[/cyan] [green]setup[/green]"
+        "\n[italic]get started with:[/italic] [bold][cyan]fast-agent[/cyan][/bold] [green]setup[/green]"
     )
 
 

mcp_agent/config.py

@@ -181,13 +181,11 @@ class OpenTelemetrySettings(BaseModel):
     OTEL settings for the fast-agent application.
     """
 
-    enabled: bool = True
+    enabled: bool = False
 
     service_name: str = "fast-agent"
-    service_instance_id: str | None = None
-    service_version: str | None = None
 
-    otlp_endpoint: str | None = None
+    otlp_endpoint: str = "http://localhost:4318/v1/traces"
     """OTLP endpoint for OpenTelemetry tracing"""
 
     console_debug: bool = False