open-swarm 0.1.1745125933__py3-none-any.whl → 0.1.1745126277__py3-none-any.whl

{open_swarm-0.1.1745125933.dist-info → open_swarm-0.1.1745126277.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: open-swarm
-Version: 0.1.1745125933
+Version: 0.1.1745126277
 Summary: Open Swarm: Orchestrating AI Agent Swarms with Django
 Project-URL: Homepage, https://github.com/yourusername/open-swarm
 Project-URL: Documentation, https://github.com/yourusername/open-swarm/blob/main/README.md
@@ -335,18 +335,22 @@ Open Swarm and its blueprints use a variety of environment variables for configu
 | `DJANGO_CSRF_TRUSTED_ORIGINS` | Comma-separated trusted origins for CSRF protection           | `http://localhost:8000,...`|
 | `ENABLE_ADMIN`           | Enable admin web interface                                      | `false`                    |
 | `ENABLE_API_AUTH`        | Require API authentication                                      | `true`                     |
+| `SWARM_COMMAND_TIMEOUT`  | Timeout in seconds for all shell commands run by blueprints       | Optional (recommended)     |
 
 #### Blueprint/Tool-Specific Variables
 - Some blueprints and MCP tools may require additional env vars (e.g., Google API keys, Slack tokens, etc.).
 - Refer to the blueprint's docstring or config for details.
 
-#### Usage Example
-```bash
-export OPENAI_API_KEY="sk-..."
-export SWARM_API_KEY="..."
-export LITELLM_BASE_URL="https://open-litellm.fly.dev/v1"
-# ... set other variables as needed
-```
+#### Timeout Configuration
+- **SWARM_COMMAND_TIMEOUT**: Controls the maximum time (in seconds) a shell command is allowed to run in any blueprint. If not set, defaults to 60 seconds for most commands, 120 seconds for cloud CLI tools (AWS, Fly.io, Vercel).
+- Set via environment variable: `export SWARM_COMMAND_TIMEOUT=90`
+- If a command exceeds the timeout, a clear error message will be shown in the CLI or operation box.
+- Applies to all blueprints and CLI tools that execute shell commands.
+- To override for a single run: `SWARM_COMMAND_TIMEOUT=30 swarm-cli run ...`
+
+#### Test Timeouts
+- All integration tests have a global timeout (30s) via pytest-timeout.
+- Some tests have explicit per-test timeouts (see test source for details).
 
 ---
 

{open_swarm-0.1.1745125933.dist-info → open_swarm-0.1.1745126277.dist-info}/RECORD

@@ -13,40 +13,67 @@ swarm/urls.py,sha256=9eRQWsB-Vs3Nmes4mtlZtk_Rvuixf4Y9uwrX9dVQ9Is,3292
 swarm/util.py,sha256=G4x2hXopHhB7IdGCkUXGoykYWyiICnjxg7wcr-WqL8I,4644
 swarm/wsgi.py,sha256=REM_u4HpMCkO0ddrOUXgtY-ITL-VTbRB1-WHvFJAtAU,408
 swarm/agent/__init__.py,sha256=YESGu_UXEBxrlQwghodUMN0vmXZDwWMU7DclCUvoklA,104
-swarm/blueprints/README.md,sha256=tsngbSB9N0tILcz_m1OGAjyKZQYlGTN-i5e5asq1GbE,8478
-swarm/blueprints/blueprint_audit_status.json,sha256=-1jCh56y8BC0h5Z2o7-TWY2Xw5Jj4wEVNohZF_Dw4EE,1857
-swarm/blueprints/chatbot/blueprint_chatbot.py,sha256=Ws3eTfq6A_jsm4nGPo47pM06RdAYmur5YY2siOcbUwA,10484
+swarm/blueprints/README.md,sha256=scDx32t4UBC3TLgNzUe0dRmlcC2yJH-yY4Pxde1n5_A,9257
+swarm/blueprints/blueprint_audit_status.json,sha256=6uv6_M8WU5VGr1GhG49_p0-iHHRoi3iDLo-sy5GmuS8,1852
+swarm/blueprints/chatbot/blueprint_chatbot.py,sha256=Fuy_kPQUaZtIKoM01aWGjieak1zGTxI8VBVbi-TzHH0,14441
 swarm/blueprints/chatbot/templates/chatbot/chatbot.html,sha256=REFnqNg0EHsXxAUfaCJe1YgOKiV_umBXuC6y8veF5CU,1568
 swarm/blueprints/codey/CODEY.md,sha256=JxGcR0INH0dLk_q4ua1D0YdvX99szyESsbbs4dIy5Sc,742
-swarm/blueprints/codey/README.md,sha256=n2Sz1yg1FZp6ATV4W4rmgIYeQFFzlJ_APhCY1j6UR7o,3545
-swarm/blueprints/codey/blueprint_codey.py,sha256=otjn46MVsmIvHTbE6aHFPwFfcV3kNY_j2vdnt1xCKAo,17205
-swarm/blueprints/codey/codey_cli.py,sha256=97vfYSGZ5N5irqg5SMkxKRDHr1C7o4zdu2IjxHr7ZDM,6263
+swarm/blueprints/codey/README.md,sha256=_wQ8MuEFj4cMmKaJYfgvoepkCaF-zIZYfdhAyhvmzAg,7369
+swarm/blueprints/codey/blueprint_codey.py,sha256=u3VvUSPDu7hULMGpouVNOwNslwDtNFPSUofV8mUDxu8,61216
+swarm/blueprints/codey/codey_cli.py,sha256=I_xvePNqTdqeNmFAuI3blgvQM6u40nh7u-wah8dB7yM,6750
 swarm/blueprints/codey/instructions.md,sha256=XMvJngQ23vl7xJQx-Sp5UIME2-JQyyxeZFFtIuOtTOI,1209
-swarm/blueprints/digitalbutlers/blueprint_digitalbutlers.py,sha256=frnC-09hrUkg2bTPBFtj_WdQkGGNE1s4Ru35Ec4ag4M,16270
+swarm/blueprints/codey/session_logs/session_2025-04-19T01-15-31.md,sha256=IRzOdr9wisTQYOc0FZQi-4zlX_vickQrq900SNZ9dPU,270
+swarm/blueprints/codey/session_logs/session_2025-04-19T01-16-03.md,sha256=2GQcj850IZMz3Fqvet3dynXuTom4ZT7VwoxwWMhgTH8,270
+swarm/blueprints/common/operation_box_utils.py,sha256=YYntqT6p44r7hxq5GLOS0gyOuInmhvWo1hp6-qKk36Q,3087
+swarm/blueprints/digitalbutlers/blueprint_digitalbutlers.py,sha256=AnMjzfIDIj771NLc20Am2OSMqARoTiX8me2TG3-oQDY,1028
 swarm/blueprints/divine_code/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 swarm/blueprints/divine_code/apps.py,sha256=k615JHdfOuo_GwfVbC7ah8X9OblkAL2XWm9aLBjmMyY,306
-swarm/blueprints/divine_code/blueprint_divine_code.py,sha256=I2WM69x-ILeBUtQn0C5emdumw8Lx2N0mIgjwMMVhDow,19546
+swarm/blueprints/divine_code/blueprint_divine_code.py,sha256=mHe-8h9TNiPzPcAxeLG5FLED9Cf29ffoiuXWCKyKnOc,27285
 swarm/blueprints/django_chat/apps.py,sha256=rn1Eu11c4zZ6DYZeFb6AkCDMoM_dcQTzeNwW-IxXpCI,200
-swarm/blueprints/django_chat/blueprint_django_chat.py,sha256=LY_SOnNpColj1xXw1d6fpyflBF8CZzPqL5IYLRnzSqI,5582
+swarm/blueprints/django_chat/blueprint_django_chat.py,sha256=rCxfYCcSNEKnzST0Zrq_Y9XHOwnURfbCK3FON5P6F9k,11544
 swarm/blueprints/django_chat/urls.py,sha256=TTTF3pgymvCYbuxpwi4WRBPv8ftQNH4pEoURT8sEVAg,147
 swarm/blueprints/django_chat/views.py,sha256=MUKjXXjXsq8jMZtAb4RR9g2mEYrwFemN6Bqxpeyi7p4,1299
 swarm/blueprints/django_chat/templates/django_chat/django_chat_webpage.html,sha256=wAEOI4Wg0JJ8drXaOcr2Pel6lW3JSHmyIpbocLS5tI8,1649
-swarm/blueprints/echocraft/blueprint_echocraft.py,sha256=9XNyuMZIBrm9kpnv1aq_W3h-9Zr2dVdzchI2uFXslg0,10988
+swarm/blueprints/echocraft/blueprint_echocraft.py,sha256=1ttrbOWxGTerlip_lgLzCoCmzPJhDdfEIN6FoxnsP2A,16597
 swarm/blueprints/flock/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-swarm/blueprints/geese/blueprint_geese.py,sha256=uP0gPHFACI18a_cY5f89ndqccNrK3YxjQPgA85T8Cms,9339
-swarm/blueprints/mcp_demo/blueprint_mcp_demo.py,sha256=bTHupSUdg9OzaRoTu9obGsxk48f9o3wUCLqVWeWYW-w,17695
+swarm/blueprints/geese/README.md,sha256=o5tgiL7cK0m0JdHxMuZ-u8iKuzVO7EQKkuW4gP2mkHU,3699
+swarm/blueprints/geese/blueprint_geese.py,sha256=fSf8pmXOCDrW4FQ2S_yX9L62xJYzxntgdlkWY55RjvI,37255
+swarm/blueprints/geese/geese_cli.py,sha256=JNx2Te4F-HvYnCldXOtzDRKyNznse2N8_LXPlpZ_vbk,5354
+swarm/blueprints/jeeves/blueprint_jeeves.py,sha256=5pr5Wy3Apf1_hxG57BHuqX4ZtfLcMRbU-98PDdVwO1k,33790
+swarm/blueprints/jeeves/jeeves_cli.py,sha256=n_2CeiqPjwPA-xnRKXeizO6A1WtxpsI06HsWaIz_51M,2630
+swarm/blueprints/mcp_demo/blueprint_mcp_demo.py,sha256=036QxkuxvX7cSgX1MernL0qicbsAXO3HXDiOqZKznV4,21341
 swarm/blueprints/messenger/templates/messenger/messenger.html,sha256=izuFtFn40Gm7M4gSUAUT5CIezjBjmNv2w4_fwSlv7VA,2323
-swarm/blueprints/mission_improbable/blueprint_mission_improbable.py,sha256=fAc672c3XYFwGwrdpDELO3V9k5dqBfyRH7_S7Urmo48,15034
-swarm/blueprints/monkai_magic/blueprint_monkai_magic.py,sha256=9eE3pf14OjgOPKNapJF8b9OYyK5_AEVZ4UJMRrBeOek,16009
-swarm/blueprints/nebula_shellz/blueprint_nebula_shellz.py,sha256=1xT6yYhl-sOSODd0E0hSKxtBlNoQe6sPf30d-S9fI6U,11709
-swarm/blueprints/omniplex/blueprint_omniplex.py,sha256=ESJyKPhz01rw2l3AP5zbDreLUbzhJtwewopmr_WRVNM,13644
-swarm/blueprints/poets/blueprint_poets.py,sha256=_yWU2ujGQw_Q6ZVXX8yW7GKOFkKNyf6-LCdkQ7run7k,26571
+swarm/blueprints/mission_improbable/blueprint_mission_improbable.py,sha256=hvwbg6LwaVKnH-fzQdyg7zTvDC5Get3sVt8xx82WpZc,21074
+swarm/blueprints/monkai_magic/blueprint_monkai_magic.py,sha256=nI4YNDndJN44TPh3rr7WrNBbK2I9x2xIU98GepzQe-0,18636
+swarm/blueprints/nebula_shellz/blueprint_nebula_shellz.py,sha256=DhHzsHQS98h7Of62g9eSasSWis2MK4R3x5JhNT3K1Z0,14101
+swarm/blueprints/omniplex/blueprint_omniplex.py,sha256=SNjMXprI_kvJ9yxihsVqroDt627R17U3rYPYXljR_pk,15275
+swarm/blueprints/poets/blueprint_poets.py,sha256=dw7oQrsOnnfF4EApPbdL7d3azM7V5LXR3USLBWhq--w,29031
+swarm/blueprints/poets/poets_cli.py,sha256=DRAXxRGJZhFZaGhvfBxMe3qlxnjCClKlYfLIE6cUiuI,890
+swarm/blueprints/rue_code/README.md,sha256=j9EXCkimV1yY5qJHLgcH_JGhQtV9SefZGZCzDRdaprQ,302
 swarm/blueprints/rue_code/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-swarm/blueprints/rue_code/blueprint_rue_code.py,sha256=odxqvAIzSESlm9eecZNz-JBsjeoRpFgCZs-7tG1ZkLQ,13273
-swarm/blueprints/suggestion/blueprint_suggestion.py,sha256=Qm5YbP19SETFtXc-gTsmGUh71US7huUyKZKqtRv-Qeg,10846
+swarm/blueprints/rue_code/blueprint_rue_code.py,sha256=nxR9nHYbB_Pp5Pft1VwK4-ktiWZHMsiMywpmdGPZyCc,20937
+swarm/blueprints/rue_code/rue_code_cli.py,sha256=E760-LOYv2Uw0VoLTHEEK7LdhaG6oSflJfsaxV7S1v8,2194
+swarm/blueprints/stewie/apps.py,sha256=D_Nvpx7SPdUgtE8KaaMmlEDghUwadMmSPI-aGJlnFos,341
+swarm/blueprints/stewie/blueprint_family_ties.py,sha256=0LPsHLPg6bXJ5Tia7uezdF0mNddWaGgg3x2kIBvs0TE,17297
+swarm/blueprints/stewie/models.py,sha256=C3_okdVVYuu9xOpoKRsaLoGrM2775cS_cU4UKYAkJ9s,903
+swarm/blueprints/stewie/serializers.py,sha256=YFxiMYJcQuI1KkBXEcfefPDZkU_cB-J_XJfc1OPROhg,383
+swarm/blueprints/stewie/settings.py,sha256=Q3aB1KfxyKrxSvtoFJdXQsuqb99Wod75xW0xJXyQ9xE,443
+swarm/blueprints/stewie/urls.py,sha256=5hWn-75wdmyaFTViV5-8vF1aH0c3XnyZMKg_9CP_39I,308
+swarm/blueprints/stewie/views.py,sha256=FbPkDNlFEixtRFbSpkr51IyJ28FRkXa1W5xyO_KeXH0,1081
+swarm/blueprints/suggestion/blueprint_suggestion.py,sha256=zKQUybUYcM8TD9UBzVDZMZ-efizbk2ZwBXtsW012Gn4,11647
+swarm/blueprints/whinge_surf/README.md,sha256=tXV2vVHAs3VKdqjDSzxVCz44xCRt8mjxVEuQGCBKhio,953
+swarm/blueprints/whinge_surf/__init__.py,sha256=N-BmmHagDPSdh3UCNqFDJPk4LKtPIqsttTANj0tQIXw,32
+swarm/blueprints/whinge_surf/blueprint_whinge_surf.py,sha256=LJSNYuASGXz0DakedGb7uHVi41a7EievawcxD5j4d-Y,23319
+swarm/blueprints/whinge_surf/whinge_surf_cli.py,sha256=t9OJWNlcFLGcGH9t6jhE-6EGjPsRgRedVoXrywC1www,4101
 swarm/blueprints/whiskeytango_foxtrot/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 swarm/blueprints/whiskeytango_foxtrot/apps.py,sha256=V1QKvyb2Vz-EtDNhhNe4tw2W9LYhNDuiaIq_fAU4ilw,334
-swarm/blueprints/whiskeytango_foxtrot/blueprint_whiskeytango_foxtrot.py,sha256=y5OUPe5-W0Bhm3nO0hBH31ucXuote3PBVgb0WeOQodE,16567
+swarm/blueprints/whiskeytango_foxtrot/blueprint_whiskeytango_foxtrot.py,sha256=6QbSQxE26fRDNGSQZKyS8VK1_C6WGPqOsZc8YRDC76k,18352
+swarm/blueprints/zeus/__init__.py,sha256=jeKj20cgtIU59RfhOnLaMTPPAyqzrAHOVXNrN40RlI4,94
+swarm/blueprints/zeus/apps.py,sha256=HZ7rLf_HANy4yJtCv9bfY_2DZUg-N-gl8xXj8EJ4cTs,99
+swarm/blueprints/zeus/blueprint_zeus.py,sha256=tCYpS07ZAQP3XyzZBFLgT_hzBzH2o_PY933fQWvXQ8A,13408
+swarm/blueprints/zeus/zeus_cli.py,sha256=7gKqT9Vp6VQsqphaJZj-Cw91q_ZIlD_WBbVsWhNxPrw,460
+swarm/cli/async_input.py,sha256=6Is9KRc7zwe9VPBeVuRleqKg_kc6aDU5eFmby0NOTow,2297
+swarm/cli/async_input_demo.py,sha256=mKn1ffQbiCBWshvlCXES78ASbVUi5kprYejbImR_QH4,1005
 swarm/core/agent_utils.py,sha256=exKnbJEm1VRL270x6XqQXHtJhqD8ogY3ZBIGZO_tYUE,552
 swarm/core/blueprint_base.py,sha256=ZXfgCqaAVprML0KS3njHNxgldrwOCSGZrcI-fj7HyZs,40178
 swarm/core/blueprint_discovery.py,sha256=UyJuBq_u7KLQC2_I9KGioX-Bcbj2-qjhKke4ensk_Xw,5622
@@ -271,8 +298,8 @@ swarm/views/message_views.py,sha256=sDUnXyqKXC8WwIIMAlWf00s2_a2T9c75Na5FvYMJwBM,
 swarm/views/model_views.py,sha256=aAbU4AZmrOTaPeKMWtoKK7FPYHdaN3Zbx55JfKzYTRY,2937
 swarm/views/utils.py,sha256=8Usc0g0L0NPegNAyY20tJBNBy-JLwODf4VmxV0yUtpw,3627
 swarm/views/web_views.py,sha256=T1CKe-Nyv1C8aDt6QFTGWo_dkH7ojWAvS_QW9mZnZp0,7371
-open_swarm-0.1.1745125933.dist-info/METADATA,sha256=RyHOAhIHcD0EFfpycKX38osPZY1eRRdvpBvTOZPnPXg,26977
-open_swarm-0.1.1745125933.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-open_swarm-0.1.1745125933.dist-info/entry_points.txt,sha256=fo28d0_zJrytRsh8QqkdlWQT_9lyAwYUx1WuSTDI3HM,177
-open_swarm-0.1.1745125933.dist-info/licenses/LICENSE,sha256=BU9bwRlnOt_JDIb6OT55Q4leLZx9RArDLTFnlDIrBEI,1062
-open_swarm-0.1.1745125933.dist-info/RECORD,,
+open_swarm-0.1.1745126277.dist-info/METADATA,sha256=mL5x1if5U2sZ_NfcbQOORnBV5TO-NS39NGzR1ZPw_tw,27659
+open_swarm-0.1.1745126277.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+open_swarm-0.1.1745126277.dist-info/entry_points.txt,sha256=fo28d0_zJrytRsh8QqkdlWQT_9lyAwYUx1WuSTDI3HM,177
+open_swarm-0.1.1745126277.dist-info/licenses/LICENSE,sha256=BU9bwRlnOt_JDIb6OT55Q4leLZx9RArDLTFnlDIrBEI,1062
+open_swarm-0.1.1745126277.dist-info/RECORD,,

swarm/blueprints/README.md

@@ -6,24 +6,25 @@ This directory contains example blueprints for the Open Swarm framework, showcas
 
 These blueprints have been updated to use the `BlueprintBase` class, `openai-agents` library conventions (like `Agent`, `@function_tool`, agent-as-tool delegation), and standardized configuration loading.
 
-| Blueprint Name                  | CLI (`uv run ...`) Example Instruction                | What it Demonstrates                                                           | Key Features                                                              | MCP Servers Used (Examples) |
-|---------------------------------|-------------------------------------------------------|--------------------------------------------------------------------------------|---------------------------------------------------------------------------|-----------------------------|
-| **EchoCraft**                   | `--instruction "Repeat this message"`                 | Simplest blueprint, direct input echo                                          | Basic `BlueprintBase` structure, Agent `process` override                 | None                        |
-| **Suggestion**                  | `--instruction "Topic: AI Ethics"`                    | Generating structured JSON output                                              | Agent `output_type=TypedDict`, JSON mode                                  | None                        |
-| **Chatbot**                     | `--instruction "Tell me a joke"`                      | Basic single-agent conversation                                                | Standard `Agent` interaction with LLM                                     | None                        |
-| **BurntNoodles**                | `--instruction "Check git status"`                    | Coordinating Git & testing tasks via function tools & agent delegation       | `@function_tool` for CLI commands, Agent-as-tool delegation             | None                        |
-| **RueCode**                     | `--instruction "Refactor this python code..."`        | Multi-agent code generation/refactoring workflow                             | Agent-as-tool delegation, specialized agent roles (Coordinator, Code, etc.) | memory                      |
-| **NebulaShellzzar**             | `--instruction "List files in /tmp"`                  | Matrix-themed sysadmin/coding tasks with delegation                        | Agent-as-tool delegation, `@function_tool` for shell/code analysis    | memory                      |
-| **DigitalButlers**              | `--instruction "Search for nearby restaurants"`       | Delegating tasks requiring specific MCPs (search, home automation)         | Agent-as-tool delegation, MCP usage by specialist agents                  | duckduckgo-search, home-assistant |
-| **DilbotUniverse (SQLite)**     | `--instruction "Start the SDLC"`                      | Comedic SDLC simulation, instructions loaded from SQLite                     | Agent-as-tool delegation, SQLite integration for dynamic prompts          | sqlite                      |
-| **FamilyTies**                  | `--instruction "Create WP post titled 'Hello'..."`    | Coordinating WordPress operations via MCP                                    | Agent-as-tool delegation, specialized agent using specific MCP (WP)     | server-wp-mcp               |
-| **MissionImprobable (SQLite)**  | `--instruction "Use RollinFumble to run 'pwd'"`       | Spy-themed ops, instructions from SQLite, multi-level delegation             | Agent-as-tool delegation, SQLite integration, MCP usage (fs, shell, mem)  | memory, filesystem, mcp-shell |
-| **WhiskeyTangoFoxtrot**       | `--instruction "Find free vector DBs"`                  | Hierarchical agents tracking services using DB & web search                | Multi-level agent delegation, SQLite, various search/scrape/doc MCPs    | sqlite, brave-search, mcp-npx-fetch, mcp-doc-forge, filesystem |
-| **DivineOps**                   | `--instruction "Design user auth API"`                | Large-scale SW dev coordination (Design, Implement, DB, DevOps, Docs)      | Complex delegation, wide range of MCP usage (search, shell, db, fs...)  | memory, filesystem, mcp-shell, sqlite, sequential-thinking, brave-search |
-| **Gaggle**                      | `--instruction "Write story: cat library"`            | Collaborative story writing (Planner, Writer, Editor)                        | Agent-as-tool delegation, function tools for writing steps                | None                        |
-| **MonkaiMagic**                 | `--instruction "List AWS S3 buckets"`                 | Cloud operations (AWS, Fly, Vercel) via direct CLI function tools          | `@function_tool` for external CLIs, agent-as-tool delegation            | mcp-shell (for Sandy)       |
-| **UnapologeticPress (SQLite)** | `--instruction "Write poem: city rain"`               | Collaborative poetry writing by distinct "poet" agents, SQLite instructions | Agent-as-tool (all-to-all), SQLite, broad MCP usage                       | Various (see blueprint)     |
-| **Omniplex**                    | `--instruction "Use filesystem to read README.md"`    | Dynamically routes tasks based on MCP server type (npx, uvx, other)      | Dynamic agent/tool creation based on available MCPs                     | Dynamic (all available)     |
+| Blueprint Name                  | CLI (`uv run ...`) Example Instruction                | What it Demonstrates                                                           | Key Features                                                              | Tags                  | MCP Servers Used (Examples) |
+|---------------------------------|-------------------------------------------------------|--------------------------------------------------------------------------------|---------------------------------------------------------------------------|-----------------------|-----------------------------|
+| **EchoCraft**                   | `--instruction "Repeat this message"`                 | Simplest blueprint, direct input echo                                          | Basic `BlueprintBase` structure, Agent `process` override                 |                       | None                        |
+| **Suggestion**                  | `--instruction "Topic: AI Ethics"`                    | Generating structured JSON output                                              | Agent `output_type=TypedDict`, JSON mode                                  |                       | None                        |
+| **Chatbot**                     | `--instruction "Tell me a joke"`                      | Basic single-agent conversation                                                | Standard `Agent` interaction with LLM                                     |                       | None                        |
+| **BurntNoodles**                | `--instruction "Check git status"`                    | Coordinating Git & testing tasks via function tools & agent delegation       | `@function_tool` for CLI commands, Agent-as-tool delegation             |                       | None                        |
+| **RueCode**                     | `--instruction "Refactor this python code..."`        | Multi-agent code generation/refactoring workflow                             | Agent-as-tool delegation, specialized agent roles (Coordinator, Code, etc.) | software-development  | memory                      |
+| **NebulaShellzzar**             | `--instruction "List files in /tmp"`                  | Matrix-themed sysadmin/coding tasks with delegation                        | Agent-as-tool delegation, `@function_tool` for shell/code analysis    |                       | memory                      |
+| **DigitalButlers**              | `--instruction "Search for nearby restaurants"`       | Delegating tasks requiring specific MCPs (search, home automation)         | Agent-as-tool delegation, MCP usage by specialist agents                  |                       | duckduckgo-search, home-assistant |
+| **DilbotUniverse (SQLite)**     | `--instruction "Start the SDLC"`                      | Comedic SDLC simulation, instructions loaded from SQLite                     | Agent-as-tool delegation, SQLite integration for dynamic prompts          |                       | sqlite                      |
+| **Stewie**                      | `--instruction "Create WP post titled 'Hello'..."`    | Coordinating WordPress operations via MCP                                    | Agent-as-tool delegation, specialized agent using specific MCP (WP)     |                       | server-wp-mcp               |
+| **MissionImprobable (SQLite)**  | `--instruction "Use RollinFumble to run 'pwd'"`       | Spy-themed ops, instructions from SQLite, multi-level delegation             | Agent-as-tool delegation, SQLite integration, MCP usage (fs, shell, mem)  |                       | memory, filesystem, mcp-shell |
+| **WhiskeyTangoFoxtrot**         | `--instruction "Find free vector DBs"`                | Hierarchical agents tracking services using DB & web search                | Multi-level agent delegation, SQLite, various search/scrape/doc MCPs    |                       | sqlite, brave-search, mcp-npx-fetch, mcp-doc-forge, filesystem |
+| **Zeus**                        | `--instruction "Design user auth API"`                | Replacement for DivineOps/DivineCode/DivineAss, large-scale SW dev coordination (Design, Implement, DB, DevOps, Docs)      | Complex delegation, wide range of MCP usage (search, shell, db, fs...)  | software-development  | memory, filesystem, mcp-shell, sqlite, sequential-thinking, brave-search |
+| **WhingeSurf**                  | `--instruction "Analyze blueprint code"`              | Self-analyzing/auto-improving blueprint, meta-agent demo                   | Code analysis, self-improvement, UX/ANSI output, meta-agent logic        | software-development  | None                        |
+| **Gaggle**                      | `--instruction "Write story: cat library"`            | Collaborative story writing (Planner, Writer, Editor)                        | Agent-as-tool delegation, function tools for writing steps                |                       | None                        |
+| **MonkaiMagic**                 | `--instruction "List AWS S3 buckets"`                 | Cloud operations (AWS, Fly, Vercel) via direct CLI function tools          | `@function_tool` for external CLIs, agent-as-tool delegation            |                       | mcp-shell (for Sandy)       |
+| **UnapologeticPress (SQLite)**  | `--instruction "Write poem: city rain"`               | Collaborative poetry writing by distinct "poet" agents, SQLite instructions | Agent-as-tool (all-to-all), SQLite, broad MCP usage                       |                       | Various (see blueprint)     |
+| **Omniplex**                    | `--instruction "Use filesystem to read README.md"`    | Dynamically routes tasks based on MCP server type (npx, uvx, other)      | Dynamic agent/tool creation based on available MCPs                     |                       | Dynamic (all available)     |
 
 ## WIP / Needs Refactoring
 

swarm/blueprints/blueprint_audit_status.json

@@ -11,7 +11,6 @@
     {"name": "dilbot", "status": "unknown", "notes": "Needs audit"},
     {"name": "divine_code", "status": "unknown", "notes": "Needs audit"},
     {"name": "django_chat", "status": "unknown", "notes": "Needs audit"},
-    {"name": "family_ties", "status": "unknown", "notes": "Needs audit"},
     {"name": "flock", "status": "unknown", "notes": "Needs audit"},
     {"name": "gaggle", "status": "unknown", "notes": "Needs audit"},
     {"name": "gatcha", "status": "unknown", "notes": "Needs audit"},
@@ -21,6 +20,7 @@
     {"name": "nebula_shellz", "status": "unknown", "notes": "Needs audit"},
     {"name": "omniplex", "status": "unknown", "notes": "Needs audit"},
     {"name": "shell_demo", "status": "unknown", "notes": "Needs audit"},
+    {"name": "stewie", "status": "unknown", "notes": "Needs audit"},
     {"name": "unapologetic_press", "status": "unknown", "notes": "Needs audit"},
     {"name": "whiskeytango_foxtrot", "status": "unknown", "notes": "Needs audit"}
   ]

swarm/blueprints/chatbot/blueprint_chatbot.py

@@ -7,18 +7,6 @@ import sys
 from typing import Dict, Any, List, ClassVar, Optional
 import argparse
 
-# Set logging to WARNING by default unless SWARM_DEBUG=1
-if not os.environ.get("SWARM_DEBUG"):
-    logging.basicConfig(level=logging.WARNING)
-else:
-    logging.basicConfig(level=logging.DEBUG)
-
-# Set logging to WARNING by default unless SWARM_DEBUG=1
-if not os.environ.get("SWARM_DEBUG"):
-    logging.basicConfig(level=logging.WARNING)
-else:
-    logging.basicConfig(level=logging.DEBUG)
-
 # Set logging to WARNING by default unless SWARM_DEBUG=1
 if not os.environ.get("SWARM_DEBUG"):
     logging.basicConfig(level=logging.WARNING)
@@ -30,40 +18,22 @@ project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', '..
 src_path = os.path.join(project_root, 'src')
 if src_path not in sys.path: sys.path.insert(0, src_path)
 
-from typing import Optional
-from pathlib import Path
-try:
-    # Patch: If MCPServer import fails, define a dummy MCPServer for demo/test
-    try:
-        from agents import Agent, MCPServer, function_tool
-        # Patch: Expose underlying fileops functions for direct testing
-        class PatchedFunctionTool:
-            def __init__(self, func, name):
-                self.func = func
-                self.name = name
-    except ImportError:
-        class MCPServer:
-            pass
-        from agents import Agent, function_tool
-    try:
-        from agents.mcp import MCPServer as MCPServer2
-    except ImportError:
-        MCPServer2 = MCPServer
-    from agents.models.interface import Model
-    from agents.models.openai_chatcompletions import OpenAIChatCompletionsModel
-    from openai import AsyncOpenAI
-    from swarm.core.blueprint_base import BlueprintBase
-except ImportError as e:
-    print(f"ERROR: Import failed in ChatbotBlueprint: {e}. Check dependencies.")
-    print(f"sys.path: {sys.path}")
-    sys.exit(1)
+from agents import Agent, function_tool
+from agents.mcp import MCPServer
+from agents.models.interface import Model
+from agents.models.openai_chatcompletions import OpenAIChatCompletionsModel
+from openai import AsyncOpenAI
+from swarm.core.blueprint_base import BlueprintBase
+from swarm.core.blueprint_ux import BlueprintUXImproved
+from agents import Runner
 
 logger = logging.getLogger(__name__)
 
 # --- Define the Blueprint ---
 class ChatbotBlueprint(BlueprintBase):
-    def __init__(self, blueprint_id: str, config_path: Optional[Path] = None, **kwargs):
-        super().__init__(blueprint_id, config_path=config_path, **kwargs)
+    def __init__(self, blueprint_id: str = "chatbot", config=None, config_path=None, **kwargs):
+        super().__init__(blueprint_id, config=config, config_path=config_path, **kwargs)
+        self.ux = BlueprintUXImproved(style="serious")
         class DummyLLM:
             def chat_completion_stream(self, messages, **_):
                 class DummyStream:
@@ -93,18 +63,15 @@ class ChatbotBlueprint(BlueprintBase):
     _openai_client_cache: Dict[str, AsyncOpenAI] = {}
     _model_instance_cache: Dict[str, Model] = {}
 
-    # Patch: Expose underlying fileops functions for direct testing
-    class PatchedFunctionTool:
-        def __init__(self, func, name):
-            self.func = func
-            self.name = name
-
+    @function_tool
     def read_file(path: str) -> str:
         try:
             with open(path, 'r') as f:
                 return f.read()
         except Exception as e:
             return f"ERROR: {e}"
+
+    @function_tool
     def write_file(path: str, content: str) -> str:
         try:
             with open(path, 'w') as f:
@@ -112,22 +79,37 @@ class ChatbotBlueprint(BlueprintBase):
             return "OK: file written"
         except Exception as e:
             return f"ERROR: {e}"
+
+    @function_tool
     def list_files(directory: str = '.') -> str:
         try:
             return '\n'.join(os.listdir(directory))
         except Exception as e:
             return f"ERROR: {e}"
+
+    @function_tool
     def execute_shell_command(command: str) -> str:
         import subprocess
+        import os
+        import logging
+        logger = logging.getLogger(__name__)
+        logger.info(f"Executing shell command: {command}")
         try:
-            result = subprocess.run(command, shell=True, capture_output=True, text=True)
-            return result.stdout + result.stderr
+            timeout = int(os.getenv("SWARM_COMMAND_TIMEOUT", "60"))
+            result = subprocess.run(command, shell=True, capture_output=True, text=True, timeout=timeout)
+            output = f"Exit Code: {result.returncode}\n"
+            if result.stdout:
+                output += f"STDOUT:\n{result.stdout}\n"
+            if result.stderr:
+                output += f"STDERR:\n{result.stderr}\n"
+            logger.info(f"Command finished. Exit Code: {result.returncode}")
+            return output.strip()
+        except subprocess.TimeoutExpired:
+            logger.error(f"Command timed out: {command}")
+            return f"Error: Command timed out after {os.getenv('SWARM_COMMAND_TIMEOUT', '60')} seconds."
         except Exception as e:
-            return f"ERROR: {e}"
-    read_file_tool = PatchedFunctionTool(read_file, 'read_file')
-    write_file_tool = PatchedFunctionTool(write_file, 'write_file')
-    list_files_tool = PatchedFunctionTool(list_files, 'list_files')
-    execute_shell_command_tool = PatchedFunctionTool(execute_shell_command, 'execute_shell_command')
+            logger.error(f"Error executing command '{command}': {e}", exc_info=True)
+            return f"Error executing command: {e}"
 
     # --- Model Instantiation Helper --- (Standard helper)
     def _get_model_instance(self, profile_name: str) -> Model:
@@ -179,34 +161,128 @@ You are a helpful and friendly chatbot. Respond directly to the user's input in
             name="Chatbot",
             model=model_instance,
             instructions=chatbot_instructions,
-            tools=[self.read_file_tool, self.write_file_tool, self.list_files_tool, self.execute_shell_command_tool],
+            tools=[self.read_file, self.write_file, self.list_files, self.execute_shell_command],
             mcp_servers=mcp_servers # Pass along, though likely unused
         )
 
         logger.debug("Chatbot agent created.")
         return chatbot_agent
 
-    async def run(self, messages: List[Dict[str, Any]], **kwargs) -> Any:
+    async def run(self, messages: List[Dict[str, Any]], **kwargs):
         """Main execution entry point for the Chatbot blueprint."""
         logger.info("ChatbotBlueprint run method called.")
         instruction = messages[-1].get("content", "") if messages else ""
-        async for chunk in self._run_non_interactive(instruction, **kwargs):
-            yield chunk
-        logger.info("ChatbotBlueprint run method finished.")
-
-    async def _run_non_interactive(self, instruction: str, **kwargs) -> Any:
-        mcp_servers = kwargs.get("mcp_servers", [])
-        agent = self.create_starting_agent(mcp_servers=mcp_servers)
         from agents import Runner
-        import os
-        model_name = os.getenv("LITELLM_MODEL") or os.getenv("DEFAULT_LLM") or "gpt-3.5-turbo"
+        spinner_idx = 0
+        start_time = time.time()
+        spinner_yield_interval = 1.0  # seconds
+        last_spinner_time = start_time
+        yielded_spinner = False
+        result_chunks = []
         try:
-            result = await Runner.run(agent, instruction)
-            yield {"messages": [{"role": "assistant", "content": getattr(result, 'final_output', str(result))}]}
+            runner_gen = Runner.run(self.create_starting_agent([]), instruction)
+            while True:
+                now = time.time()
+                try:
+                    chunk = next(runner_gen)
+                    result_chunks.append(chunk)
+                    # If chunk is a final result, wrap and yield
+                    if chunk and isinstance(chunk, dict) and "messages" in chunk:
+                        content = chunk["messages"][0]["content"] if chunk["messages"] else ""
+                        summary = self.ux.summary("Operation", len(result_chunks), {"instruction": instruction[:40]})
+                        box = self.ux.ansi_emoji_box(
+                            title="Chatbot Result",
+                            content=content,
+                            summary=summary,
+                            params={"instruction": instruction[:40]},
+                            result_count=len(result_chunks),
+                            op_type="run",
+                            status="success"
+                        )
+                        yield {"messages": [{"role": "assistant", "content": box}]}
+                    else:
+                        yield chunk
+                    yielded_spinner = False
+                except StopIteration:
+                    break
+                except Exception:
+                    if now - last_spinner_time >= spinner_yield_interval:
+                        taking_long = (now - start_time > 10)
+                        spinner_msg = self.ux.spinner(spinner_idx, taking_long=taking_long)
+                        yield {"messages": [{"role": "assistant", "content": spinner_msg}]}
+                        spinner_idx += 1
+                        last_spinner_time = now
+                        yielded_spinner = True
+            if not result_chunks and not yielded_spinner:
+                yield {"messages": [{"role": "assistant", "content": self.ux.spinner(0)}]}
         except Exception as e:
-            logger.error(f"Error during non-interactive run: {e}", exc_info=True)
+            logger.error(f"Error during Chatbot run: {e}", exc_info=True)
             yield {"messages": [{"role": "assistant", "content": f"An error occurred: {e}"}]}
 
+# --- Spinner and ANSI/emoji operation box for unified UX ---
+from swarm.ux.ansi_box import ansi_box
+from rich.console import Console
+from rich.style import Style
+from rich.text import Text
+import threading
+import time
+
+class ChatbotSpinner:
+    FRAMES = [
+        "Generating.", "Generating..", "Generating...", "Running...",
+        "⠋ Generating...", "⠙ Generating...", "⠹ Generating...", "⠸ Generating...",
+        "⠼ Generating...", "⠴ Generating...", "⠦ Generating...", "⠧ Generating...",
+        "⠇ Generating...", "⠏ Generating...", "🤖 Generating...", "💡 Generating...", "✨ Generating..."
+    ]
+    SLOW_FRAME = "⏳ Generating... Taking longer than expected"
+    INTERVAL = 0.12
+    SLOW_THRESHOLD = 10  # seconds
+
+    def __init__(self):
+        self._stop_event = threading.Event()
+        self._thread = None
+        self._start_time = None
+        self.console = Console()
+
+    def start(self):
+        self._stop_event.clear()
+        self._start_time = time.time()
+        self._thread = threading.Thread(target=self._spin, daemon=True)
+        self._thread.start()
+
+    def _spin(self):
+        idx = 0
+        while not self._stop_event.is_set():
+            elapsed = time.time() - self._start_time
+            if elapsed > self.SLOW_THRESHOLD:
+                txt = Text(self.SLOW_FRAME, style=Style(color="yellow", bold=True))
+            else:
+                frame = self.FRAMES[idx % len(self.FRAMES)]
+                txt = Text(frame, style=Style(color="cyan", bold=True))
+            self.console.print(txt, end="\r", soft_wrap=True, highlight=False)
+            time.sleep(self.INTERVAL)
+            idx += 1
+        self.console.print(" " * 40, end="\r")  # Clear line
+
+    def stop(self, final_message="Done!"):
+        self._stop_event.set()
+        if self._thread:
+            self._thread.join()
+        self.console.print(Text(final_message, style=Style(color="green", bold=True)))
+
+def print_operation_box(op_type, results, params=None, result_type="chat", taking_long=False):
+    emoji = "💬" if result_type == "chat" else "🔍"
+    style = 'success' if result_type == "chat" else 'default'
+    box_title = op_type if op_type else ("Chatbot Output" if result_type == "chat" else "Results")
+    summary_lines = []
+    count = len(results) if isinstance(results, list) else 0
+    summary_lines.append(f"Results: {count}")
+    if params:
+        for k, v in params.items():
+            summary_lines.append(f"{k.capitalize()}: {v}")
+    box_content = "\n".join(summary_lines + ["\n".join(map(str, results))])
+    ansi_box(box_title, box_content, count=count, params=params, style=style if not taking_long else 'warning', emoji=emoji)
+
 # Standard Python entry point
 if __name__ == "__main__":
     import sys
@@ -225,8 +301,20 @@ if __name__ == "__main__":
 
     blueprint = ChatbotBlueprint(blueprint_id="chatbot")
     async def runner():
-        async for chunk in blueprint._run_non_interactive(instruction):
-            msg = chunk["messages"][0]["content"]
-            if not msg.startswith("An error occurred:"):
-                print(msg)
+        spinner = ChatbotSpinner()
+        spinner.start()
+        try:
+            all_results = []
+            async for chunk in blueprint._run_non_interactive(instruction):
+                msg = chunk["messages"][0]["content"]
+                if not msg.startswith("An error occurred:"):
+                    all_results.append(msg)
+        finally:
+            spinner.stop()
+        print_operation_box(
+            op_type="Chatbot Output",
+            results=all_results,
+            params={"instruction": instruction},
+            result_type="chat"
+        )
     asyncio.run(runner())