massgen 0.1.0a3__py3-none-any.whl → 0.1.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of massgen might be problematic. Click here for more details.

Files changed (120) hide show
  1. massgen/__init__.py +1 -1
  2. massgen/agent_config.py +17 -0
  3. massgen/api_params_handler/_api_params_handler_base.py +1 -0
  4. massgen/api_params_handler/_chat_completions_api_params_handler.py +15 -2
  5. massgen/api_params_handler/_claude_api_params_handler.py +8 -1
  6. massgen/api_params_handler/_gemini_api_params_handler.py +73 -0
  7. massgen/api_params_handler/_response_api_params_handler.py +8 -1
  8. massgen/backend/base.py +83 -0
  9. massgen/backend/{base_with_mcp.py → base_with_custom_tool_and_mcp.py} +286 -15
  10. massgen/backend/capabilities.py +6 -6
  11. massgen/backend/chat_completions.py +200 -103
  12. massgen/backend/claude.py +115 -18
  13. massgen/backend/claude_code.py +378 -14
  14. massgen/backend/docs/CLAUDE_API_RESEARCH.md +3 -3
  15. massgen/backend/gemini.py +1333 -1629
  16. massgen/backend/gemini_mcp_manager.py +545 -0
  17. massgen/backend/gemini_trackers.py +344 -0
  18. massgen/backend/gemini_utils.py +43 -0
  19. massgen/backend/grok.py +39 -6
  20. massgen/backend/response.py +147 -81
  21. massgen/cli.py +605 -110
  22. massgen/config_builder.py +376 -27
  23. massgen/configs/README.md +123 -80
  24. massgen/configs/basic/multi/three_agents_default.yaml +3 -3
  25. massgen/configs/basic/single/single_agent.yaml +1 -1
  26. massgen/configs/providers/openai/gpt5_nano.yaml +3 -3
  27. massgen/configs/tools/custom_tools/claude_code_custom_tool_example.yaml +32 -0
  28. massgen/configs/tools/custom_tools/claude_code_custom_tool_example_no_path.yaml +28 -0
  29. massgen/configs/tools/custom_tools/claude_code_custom_tool_with_mcp_example.yaml +40 -0
  30. massgen/configs/tools/custom_tools/claude_code_custom_tool_with_wrong_mcp_example.yaml +38 -0
  31. massgen/configs/tools/custom_tools/claude_code_wrong_custom_tool_with_mcp_example.yaml +38 -0
  32. massgen/configs/tools/custom_tools/claude_custom_tool_example.yaml +24 -0
  33. massgen/configs/tools/custom_tools/claude_custom_tool_example_no_path.yaml +22 -0
  34. massgen/configs/tools/custom_tools/claude_custom_tool_with_mcp_example.yaml +35 -0
  35. massgen/configs/tools/custom_tools/claude_custom_tool_with_wrong_mcp_example.yaml +33 -0
  36. massgen/configs/tools/custom_tools/claude_wrong_custom_tool_with_mcp_example.yaml +33 -0
  37. massgen/configs/tools/custom_tools/gemini_custom_tool_example.yaml +24 -0
  38. massgen/configs/tools/custom_tools/gemini_custom_tool_example_no_path.yaml +22 -0
  39. massgen/configs/tools/custom_tools/gemini_custom_tool_with_mcp_example.yaml +35 -0
  40. massgen/configs/tools/custom_tools/gemini_custom_tool_with_wrong_mcp_example.yaml +33 -0
  41. massgen/configs/tools/custom_tools/gemini_wrong_custom_tool_with_mcp_example.yaml +33 -0
  42. massgen/configs/tools/custom_tools/github_issue_market_analysis.yaml +94 -0
  43. massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_example.yaml +24 -0
  44. massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_example_no_path.yaml +22 -0
  45. massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_with_mcp_example.yaml +35 -0
  46. massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_with_wrong_mcp_example.yaml +33 -0
  47. massgen/configs/tools/custom_tools/gpt5_nano_wrong_custom_tool_with_mcp_example.yaml +33 -0
  48. massgen/configs/tools/custom_tools/gpt_oss_custom_tool_example.yaml +25 -0
  49. massgen/configs/tools/custom_tools/gpt_oss_custom_tool_example_no_path.yaml +23 -0
  50. massgen/configs/tools/custom_tools/gpt_oss_custom_tool_with_mcp_example.yaml +34 -0
  51. massgen/configs/tools/custom_tools/gpt_oss_custom_tool_with_wrong_mcp_example.yaml +34 -0
  52. massgen/configs/tools/custom_tools/gpt_oss_wrong_custom_tool_with_mcp_example.yaml +34 -0
  53. massgen/configs/tools/custom_tools/grok3_mini_custom_tool_example.yaml +24 -0
  54. massgen/configs/tools/custom_tools/grok3_mini_custom_tool_example_no_path.yaml +22 -0
  55. massgen/configs/tools/custom_tools/grok3_mini_custom_tool_with_mcp_example.yaml +35 -0
  56. massgen/configs/tools/custom_tools/grok3_mini_custom_tool_with_wrong_mcp_example.yaml +33 -0
  57. massgen/configs/tools/custom_tools/grok3_mini_wrong_custom_tool_with_mcp_example.yaml +33 -0
  58. massgen/configs/tools/custom_tools/qwen_api_custom_tool_example.yaml +25 -0
  59. massgen/configs/tools/custom_tools/qwen_api_custom_tool_example_no_path.yaml +23 -0
  60. massgen/configs/tools/custom_tools/qwen_api_custom_tool_with_mcp_example.yaml +36 -0
  61. massgen/configs/tools/custom_tools/qwen_api_custom_tool_with_wrong_mcp_example.yaml +34 -0
  62. massgen/configs/tools/custom_tools/qwen_api_wrong_custom_tool_with_mcp_example.yaml +34 -0
  63. massgen/configs/tools/custom_tools/qwen_local_custom_tool_example.yaml +24 -0
  64. massgen/configs/tools/custom_tools/qwen_local_custom_tool_example_no_path.yaml +22 -0
  65. massgen/configs/tools/custom_tools/qwen_local_custom_tool_with_mcp_example.yaml +35 -0
  66. massgen/configs/tools/custom_tools/qwen_local_custom_tool_with_wrong_mcp_example.yaml +33 -0
  67. massgen/configs/tools/custom_tools/qwen_local_wrong_custom_tool_with_mcp_example.yaml +33 -0
  68. massgen/configs/tools/filesystem/claude_code_context_sharing.yaml +1 -1
  69. massgen/configs/tools/planning/five_agents_discord_mcp_planning_mode.yaml +7 -29
  70. massgen/configs/tools/planning/five_agents_filesystem_mcp_planning_mode.yaml +5 -6
  71. massgen/configs/tools/planning/five_agents_notion_mcp_planning_mode.yaml +4 -4
  72. massgen/configs/tools/planning/five_agents_twitter_mcp_planning_mode.yaml +4 -4
  73. massgen/configs/tools/planning/gpt5_mini_case_study_mcp_planning_mode.yaml +2 -2
  74. massgen/configs/voting/gemini_gpt_voting_sensitivity.yaml +67 -0
  75. massgen/formatter/_chat_completions_formatter.py +104 -0
  76. massgen/formatter/_claude_formatter.py +120 -0
  77. massgen/formatter/_gemini_formatter.py +448 -0
  78. massgen/formatter/_response_formatter.py +88 -0
  79. massgen/frontend/coordination_ui.py +4 -2
  80. massgen/logger_config.py +35 -3
  81. massgen/message_templates.py +56 -6
  82. massgen/orchestrator.py +512 -16
  83. massgen/stream_chunk/base.py +3 -0
  84. massgen/tests/custom_tools_example.py +392 -0
  85. massgen/tests/mcp_test_server.py +17 -7
  86. massgen/tests/test_config_builder.py +423 -0
  87. massgen/tests/test_custom_tools.py +401 -0
  88. massgen/tests/test_intelligent_planning_mode.py +643 -0
  89. massgen/tests/test_tools.py +127 -0
  90. massgen/token_manager/token_manager.py +13 -4
  91. massgen/tool/README.md +935 -0
  92. massgen/tool/__init__.py +39 -0
  93. massgen/tool/_async_helpers.py +70 -0
  94. massgen/tool/_basic/__init__.py +8 -0
  95. massgen/tool/_basic/_two_num_tool.py +24 -0
  96. massgen/tool/_code_executors/__init__.py +10 -0
  97. massgen/tool/_code_executors/_python_executor.py +74 -0
  98. massgen/tool/_code_executors/_shell_executor.py +61 -0
  99. massgen/tool/_exceptions.py +39 -0
  100. massgen/tool/_file_handlers/__init__.py +10 -0
  101. massgen/tool/_file_handlers/_file_operations.py +218 -0
  102. massgen/tool/_manager.py +634 -0
  103. massgen/tool/_registered_tool.py +88 -0
  104. massgen/tool/_result.py +66 -0
  105. massgen/tool/_self_evolution/_github_issue_analyzer.py +369 -0
  106. massgen/tool/docs/builtin_tools.md +681 -0
  107. massgen/tool/docs/exceptions.md +794 -0
  108. massgen/tool/docs/execution_results.md +691 -0
  109. massgen/tool/docs/manager.md +887 -0
  110. massgen/tool/docs/workflow_toolkits.md +529 -0
  111. massgen/tool/workflow_toolkits/__init__.py +57 -0
  112. massgen/tool/workflow_toolkits/base.py +55 -0
  113. massgen/tool/workflow_toolkits/new_answer.py +126 -0
  114. massgen/tool/workflow_toolkits/vote.py +167 -0
  115. {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/METADATA +87 -129
  116. {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/RECORD +120 -44
  117. {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/WHEEL +0 -0
  118. {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/entry_points.txt +0 -0
  119. {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/licenses/LICENSE +0 -0
  120. {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: massgen
3
- Version: 0.1.0a3
3
+ Version: 0.1.2
4
4
  Summary: Multi-Agent Scaling System - A powerful framework for collaborative AI
5
5
  Author-email: MassGen Team <contact@massgen.dev>
6
6
  License: Apache-2.0
@@ -8,9 +8,9 @@ Project-URL: Homepage, https://github.com/Leezekun/MassGen
8
8
  Project-URL: Repository, https://github.com/Leezekun/MassGen
9
9
  Project-URL: Bug Reports, https://github.com/Leezekun/MassGen/issues
10
10
  Project-URL: Source, https://github.com/Leezekun/MassGen
11
- Project-URL: Documentation, https://github.com/Leezekun/MassGen/blob/main/README.md
11
+ Project-URL: Documentation, https://docs.massgen.ai/en/latest/
12
12
  Keywords: ai,multi-agent,collaboration,orchestration,llm,claude,gemini,gpt,xai
13
- Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Development Status :: 4 - Beta
14
14
  Classifier: Intended Audience :: Developers
15
15
  Classifier: Intended Audience :: Science/Research
16
16
  Classifier: Operating System :: OS Independent
@@ -48,6 +48,7 @@ Requires-Dist: pillow>=11.3.0
48
48
  Requires-Dist: ag2>=0.9.10
49
49
  Requires-Dist: pyautogen>=0.10.0
50
50
  Requires-Dist: vertexai>=1.71.1
51
+ Requires-Dist: pytest>=8.4.2
51
52
  Provides-Extra: dev
52
53
  Requires-Dist: pytest>=7.0.0; extra == "dev"
53
54
  Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -92,6 +93,9 @@ Dynamic: license-file
92
93
  <a href="LICENSE">
93
94
  <img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License" style="margin-right: 5px;">
94
95
  </a>
96
+ <a href="https://docs.massgen.ai">
97
+ <img src="https://img.shields.io/badge/docs-massgen.ai-blue.svg" alt="Documentation" style="margin-right: 5px;">
98
+ </a>
95
99
  <a href="https://discord.massgen.ai">
96
100
  <img src="https://img.shields.io/discord/1153072414184452236?color=7289da&label=chat&logo=discord&style=flat-square" alt="Join our Discord">
97
101
  </a>
@@ -134,7 +138,7 @@ This project started with the "threads of thought" and "iterative refinement" id
134
138
  <details open>
135
139
  <summary><h3>🆕 Latest Features</h3></summary>
136
140
 
137
- - [v0.1.0 Features](#-latest-features-v010)
141
+ - [v0.1.2 Features](#-latest-features-v012)
138
142
  </details>
139
143
 
140
144
  <details open>
@@ -179,15 +183,15 @@ This project started with the "threads of thought" and "iterative refinement" id
179
183
  <summary><h3>🗺️ Roadmap</h3></summary>
180
184
 
181
185
  - Recent Achievements
182
- - [v0.1.0](#recent-achievements-v010)
183
- - [v0.0.3 - v0.0.32](#previous-achievements-v003---v0032)
186
+ - [v0.1.2](#recent-achievements-v012)
187
+ - [v0.0.3 - v0.1.1](#previous-achievements-v003---v011)
184
188
  - [Key Future Enhancements](#key-future-enhancements)
185
189
  - Bug Fixes & Backend Improvements
186
190
  - Advanced Agent Collaboration
187
191
  - Expanded Model, Tool & Agent Integrations
188
192
  - Improved Performance & Scalability
189
193
  - Enhanced Developer Experience
190
- - [v0.1.1 Roadmap](#v011-roadmap)
194
+ - [v0.1.3 Roadmap](#v013-roadmap)
191
195
  </details>
192
196
 
193
197
  <details open>
@@ -212,27 +216,36 @@ This project started with the "threads of thought" and "iterative refinement" id
212
216
 
213
217
  ---
214
218
 
215
- ## 🆕 Latest Features (v0.1.0)
216
-
217
- **🎉 Released: October 17, 2025**
219
+ ## 🆕 Latest Features (v0.1.2)
218
220
 
219
- **What's New in v0.1.0:**
220
- - **📦 PyPI Package** - Official pip installation: `pip install massgen`
221
- - **📖 Comprehensive Documentation** - Full Sphinx docs at [massgen.readthedocs.io](https://massgen.readthedocs.io)
222
- - **🎯 Interactive Setup Wizard** - Guided configuration for first-time users
223
- - **🚀 Simplified Commands** - Clean `massgen` CLI with `@examples/` prefix for built-in configs
221
+ **🎉 Released: October 22, 2025**
224
222
 
225
- **Get Started with v0.1.0:**
226
- ```bash
227
- # Install from PyPI
228
- pip install massgen
223
+ **What's New in v0.1.2:**
224
+ - **🧠 Intelligent Planning Mode** - Automatic question analysis for safe MCP tool blocking
225
+ - **🎭 Claude 4.5 Haiku Support** - Access to latest Claude Haiku model
226
+ - **🔍 Grok Web Search Fix** - Improved web search functionality in Grok backend
229
227
 
230
- # Run the interactive setup wizard
231
- massgen
228
+ **Key Improvements:**
229
+ - Automatically determines if questions require irreversible operations
230
+ - Read-only MCP operations allowed during coordination for better decisions
231
+ - Write operations automatically blocked for safety
232
+ - Zero configuration required - works transparently
233
+ - Enhanced model support with latest Claude 4.5 Haiku
232
234
 
233
- # Start using with example configurations
234
- massgen --config @examples/basic/multi/three_agents_default \
235
- "Analyze the pros and cons of renewable energy"
235
+ **Get Started with v0.1.2:**
236
+ ```bash
237
+ # Install or upgrade from PyPI
238
+ pip install --upgrade massgen
239
+
240
+ # Try intelligent planning mode with MCP tools
241
+ # (Please read the YAML file for required API keys: DISCORD_TOKEN, OPENAI_API_KEY, etc.)
242
+ massgen --config @examples/tools/planning/five_agents_discord_mcp_planning_mode \
243
+ "Check recent messages in our development channel, summarize the discussion, and post a helpful response about the current topic."
244
+
245
+ # Use latest Claude 4.5 Haiku model
246
+ # (Requires ANTHROPIC_API_KEY in .env)
247
+ massgen --model claude-haiku-4-5-20251001 \
248
+ "Summarize the latest AI developments"
236
249
  ```
237
250
 
238
251
  → [See full release history and examples](massgen/configs/README.md#release-history--examples)
@@ -282,7 +295,7 @@ This collaborative approach ensures that the final output leverages collective i
282
295
 
283
296
  ---
284
297
 
285
- > 📖 **Complete Documentation:** For comprehensive guides, API reference, and detailed examples, visit **[massgen.readthedocs.io](https://massgen.readthedocs.io)**
298
+ > 📖 **Complete Documentation:** For comprehensive guides, API reference, and detailed examples, visit **[MassGen Official Documentation](https://docs.massgen.ai/)**
286
299
 
287
300
  ---
288
301
 
@@ -321,7 +334,7 @@ massgen "Your question here"
321
334
  massgen --config @examples/basic/multi/three_agents_default "Your question"
322
335
  ```
323
336
 
324
- → See [Installation Guide](https://massgen.readthedocs.io/en/latest/quickstart/installation.html) for complete setup instructions.
337
+ → See [Installation Guide](https://docs.massgen.ai/en/latest/quickstart/installation.html) for complete setup instructions.
325
338
 
326
339
  **Method 2: Development Installation** (for contributors):
327
340
 
@@ -336,7 +349,7 @@ pip install -e .
336
349
  # Or with uv (faster)
337
350
  uv pip install -e .
338
351
 
339
- # Optional: AG2 framework integration
352
+ # Optional: External framework integration
340
353
  pip install -e ".[external]"
341
354
  ```
342
355
 
@@ -367,13 +380,13 @@ git clone https://github.com/Leezekun/MassGen.git
367
380
  cd MassGen
368
381
  uv tool install -e .
369
382
  # Now run from any directory
370
- uv tool run massgen --config @examples/basic_multi "Question"
383
+ uv tool run massgen --config @examples/basic/multi/three_agents_default "Question"
371
384
  ```
372
385
 
373
386
  **Backwards compatibility (uv run):**
374
387
  ```bash
375
388
  cd /path/to/MassGen
376
- uv run massgen --config @examples/basic_multi "Question"
389
+ uv run massgen --config @examples/basic/multi/three_agents_default "Question"
377
390
  uv run python -m massgen.cli --config config.yaml "Question"
378
391
  ```
379
392
 
@@ -411,11 +424,11 @@ OPENROUTER_API_KEY=...
411
424
 
412
425
  MassGen automatically loads API keys from `.env` in your current directory.
413
426
 
414
- → **Complete setup guide with all providers:** See [API Key Configuration](https://massgen.readthedocs.io/en/latest/quickstart/installation.html#api-key-configuration) in the docs
427
+ → **Complete setup guide with all providers:** See [API Key Configuration](https://docs.massgen.ai/en/latest/quickstart/installation.html#api-key-configuration) in the docs
415
428
 
416
429
  **Get API keys:**
417
430
  - [OpenAI](https://platform.openai.com/api-keys) | [Claude](https://docs.anthropic.com/en/api/overview) | [Gemini](https://ai.google.dev/gemini-api/docs) | [Grok](https://docs.x.ai/docs/overview)
418
- - [Azure OpenAI](https://learn.microsoft.com/en-us/azure/ai-services/openai/) | [Cerebras](https://inference-docs.cerebras.ai/introduction) | [More providers...](https://massgen.readthedocs.io/en/latest/reference/supported_models.html)
431
+ - [Azure OpenAI](https://learn.microsoft.com/en-us/azure/ai-services/openai/) | [Cerebras](https://inference-docs.cerebras.ai/introduction) | [More providers...](https://docs.massgen.ai/en/latest/reference/supported_models.html)
419
432
 
420
433
  ### 3. 🧩 Supported Models and Tools
421
434
 
@@ -446,7 +459,7 @@ The system currently supports multiple model providers with advanced capabilitie
446
459
  - Zero-cost usage reporting
447
460
  - Support for LLaMA, Mistral, Qwen and other open-weight models
448
461
 
449
- → For complete model list and configuration details, see [Supported Models](https://massgen.readthedocs.io/en/latest/reference/supported_models.html)
462
+ → For complete model list and configuration details, see [Supported Models](https://docs.massgen.ai/en/latest/reference/supported_models.html)
450
463
 
451
464
  #### Tools
452
465
 
@@ -466,13 +479,13 @@ MassGen agents can leverage various tools to enhance their problem-solving capab
466
479
 
467
480
  **Note:** Audio/video multimodal support (NEW in v0.0.30) is available through Chat Completions-based providers like OpenRouter and Qwen API. See configuration examples: [`single_openrouter_audio_understanding.yaml`](massgen/configs/basic/single/single_openrouter_audio_understanding.yaml), [`single_qwen_video_understanding.yaml`](massgen/configs/basic/single/single_qwen_video_understanding.yaml)
468
481
 
469
- → For detailed backend capabilities and tool integration guides, see [User Guide - Backends](https://massgen.readthedocs.io/en/latest/user_guide/backends.html)
482
+ → For detailed backend capabilities and tool integration guides, see [User Guide - Backends](https://docs.massgen.ai/en/latest/user_guide/backends.html)
470
483
 
471
484
  ---
472
485
 
473
486
  ### 4. 🏃 Run MassGen
474
487
 
475
- > **Complete Usage Guide:** For all usage modes, advanced features, and interactive multi-turn sessions, see [Running MassGen](https://massgen.readthedocs.io/en/latest/quickstart/running-massgen.html)
488
+ > **Complete Usage Guide:** For all usage modes, advanced features, and interactive multi-turn sessions, see [Running MassGen](https://docs.massgen.ai/en/latest/quickstart/running-massgen.html)
476
489
 
477
490
  #### 🚀 Getting Started
478
491
 
@@ -636,7 +649,7 @@ agents:
636
649
 
637
650
  → [View more MCP examples](massgen/configs/tools/mcp/)
638
651
 
639
- → For comprehensive MCP integration guide, see [MCP Integration](https://massgen.readthedocs.io/en/latest/user_guide/mcp_integration.html)
652
+ → For comprehensive MCP integration guide, see [MCP Integration](https://docs.massgen.ai/en/latest/user_guide/mcp_integration.html)
640
653
 
641
654
  #### **4. File System Operations & Workspace Management**
642
655
 
@@ -715,7 +728,7 @@ orchestrator:
715
728
  >
716
729
  > The agents will execute file operations without additional confirmation once permissions are granted.
717
730
 
718
- → For comprehensive file operations guide, see [File Operations](https://massgen.readthedocs.io/en/latest/user_guide/file_operations.html)
731
+ → For comprehensive file operations guide, see [File Operations](https://docs.massgen.ai/en/latest/user_guide/file_operations.html)
719
732
 
720
733
  #### **5. Project Integration & User Context Paths (NEW in v0.0.21)**
721
734
 
@@ -841,9 +854,7 @@ agents:
841
854
  cwd: "workspace1" # → .massgen/workspaces/workspace1/
842
855
  ```
843
856
 
844
- [Learn more about project integration](massgen/mcp_tools/permissions_and_context_files.md)
845
-
846
- → For comprehensive project integration guide, see [Project Integration](https://massgen.readthedocs.io/en/latest/user_guide/project_integration.html)
857
+ For comprehensive project integration guide, see [Project Integration](https://docs.massgen.ai/en/latest/user_guide/project_integration.html)
847
858
 
848
859
  **Security Considerations:**
849
860
  - **Agent ID Safety**: Avoid using agent+incremental digits for IDs (e.g., `agent1`, `agent2`). This may cause ID exposure during voting
@@ -865,7 +876,7 @@ massgen --config @examples/tools/mcp/claude_mcp_example \
865
876
  **OpenAI (GPT-5 Series with MCP - v0.0.17+)**
866
877
  ```bash
867
878
  # GPT-5 with weather and external tools
868
- massgen --config @examples/tools/mcp/gpt5_mini_mcp_example \
879
+ massgen --config @examples/tools/mcp/gpt5_nano_mcp_example \
869
880
  "What's the weather of Tokyo"
870
881
  ```
871
882
 
@@ -1053,14 +1064,14 @@ All sessions are automatically logged with detailed information for debugging an
1053
1064
  - **Agent Outputs** (`agent_outputs/`): Complete output history and final presentations from all agents
1054
1065
  - **Debug Log** (`massgen.log`): Complete system operations, API calls, tool usage, and error traces (use `--debug` for verbose logging)
1055
1066
 
1056
- → For comprehensive logging guide and debugging techniques, see [Logging & Debugging](https://massgen.readthedocs.io/en/latest/user_guide/logging.html)
1067
+ → For comprehensive logging guide and debugging techniques, see [Logging & Debugging](https://docs.massgen.ai/en/latest/user_guide/logging.html)
1057
1068
 
1058
1069
  ## 💡 Case Studies
1059
1070
 
1060
1071
  To see how MassGen works in practice, check out these detailed case studies based on real session logs:
1061
1072
 
1062
1073
  - [**MassGen Case Studies**](docs/case_studies/README.md)
1063
- - [**Case Studies Documentation**](https://massgen.readthedocs.io/en/latest/examples/case_studies.html) - Browse case studies online
1074
+ - [**Case Studies Documentation**](https://docs.massgen.ai/en/latest/examples/case_studies.html) - Browse case studies online
1064
1075
 
1065
1076
  ---
1066
1077
 
@@ -1071,90 +1082,45 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
1071
1082
 
1072
1083
  ⚠️ **Early Stage Notice:** As MassGen is in active development, please expect upcoming breaking architecture changes as we continue to refine and improve the system.
1073
1084
 
1074
- ### Recent Achievements (v0.1.0)
1085
+ ### Recent Achievements (v0.1.2)
1075
1086
 
1076
- **🎉 Released: October 17, 2025**
1087
+ **🎉 Released: October 22, 2025**
1077
1088
 
1078
- #### PyPI Package Release
1079
- - **Official Distribution**: MassGen now available via `pip install massgen`
1080
- - **Simplified Installation**: No need to clone repository for standard usage
1081
- - **Global Access**: Run `massgen` command from any directory after pip install
1089
+ #### Intelligent Planning Mode
1090
+ - **Automatic Question Analysis**: New `_analyze_question_irreversibility()` method in orchestrator determines if MCP operations are reversible
1091
+ - **Selective Tool Blocking**: Granular control with `set_planning_mode_blocked_tools()`, `get_planning_mode_blocked_tools()`, and `is_mcp_tool_blocked()` methods
1092
+ - **Dynamic Behavior**: Read-only MCP operations allowed during coordination, write operations blocked for safety
1093
+ - **Zero Configuration**: Works transparently without setup
1094
+ - **Multi-Workspace Support**: Planning mode works across different workspaces without conflicts
1095
+ - **Test Coverage**: Comprehensive tests in `massgen/tests/test_intelligent_planning_mode.py`
1096
+ - **Documentation**: Complete guide in `docs/case_studies/INTELLIGENT_PLANNING_MODE.md`
1082
1097
 
1083
- #### Comprehensive Documentation
1084
- - **Sphinx Documentation**: Full documentation site at [massgen.readthedocs.io](https://massgen.readthedocs.io)
1085
- - **Complete User Guide**: Installation, configuration, usage modes, and API reference
1086
- - **Case Studies**: Real-world examples with session logs and outcomes
1087
- - **Structured Navigation**: Getting Started, User Guide, Reference, Examples, and Development sections
1098
+ #### Model Support & Improvements
1099
+ - **Claude 4.5 Haiku**: Added latest Claude Haiku model `claude-haiku-4-5-20251001`
1100
+ - **Model Priority Updates**: Reorganized Claude model list with updated defaults (`claude-sonnet-4-5-20250929`)
1101
+ - **Grok Web Search Fix**: Resolved `extra_body` parameter handling for Grok's Live Search API with new `_add_grok_search_params()` method
1088
1102
 
1089
- #### Interactive Setup Wizard
1090
- - **Guided Configuration**: Step-by-step wizard for first-time users
1091
- - **Use Case Presets**: Research, Code, Q&A, Data Analysis, and more
1092
- - **API Key Management**: Centralized configuration in `~/.config/massgen/`
1093
- - **Smart Defaults**: Auto-configured tools based on selected use case
1103
+ #### Configuration Updates
1104
+ - **Planning Mode Configs**: Updated 5 configurations in `massgen/configs/tools/planning/` with selective blocking examples
1105
+ - **Default Configuration**: Updated `three_agents_default.yaml` with Grok-4-fast model
1094
1106
 
1095
- #### Enhanced CLI Experience
1096
- - **Simplified Commands**: Clean `massgen` command with intuitive syntax
1097
- - **Built-in Examples**: `@examples/` prefix for instant access to configurations
1098
- - **Backwards Compatibility**: Existing git clone workflows continue to work
1107
+ ### Previous Achievements (v0.0.3 - v0.1.1)
1099
1108
 
1100
- ### Recent Achievements (v0.0.32)
1109
+ **Custom Tools System (v0.1.1)**: User-defined Python function registration using `ToolManager` class in `massgen/tool/_manager.py`, cross-backend support alongside MCP servers, builtin/MCP/custom tool categories with automatic discovery, 40+ examples in `massgen/configs/tools/custom_tools/`, voting sensitivity controls with three-tier quality system (lenient/balanced/strict), answer novelty detection preventing duplicates
1101
1110
 
1102
- **🎉 Released: October 15, 2025**
1111
+ **Backend Enhancements (v0.1.1)**: Gemini architecture refactoring with extracted MCP management (`gemini_mcp_manager.py`), tracking (`gemini_trackers.py`), and utilities, new capabilities registry in `massgen/backend/capabilities.py` documenting feature support across backends
1103
1112
 
1104
- #### Docker Execution Mode
1105
- - **Container-Based Isolation**: Secure command execution in isolated Docker containers preventing host filesystem access
1106
- - **Persistent State Management**: Packages and dependencies persist across conversation turns eliminating redundant setup
1107
- - **Multi-Agent Support**: Each agent receives dedicated isolated container enabling safe parallel execution
1108
- - **Configurable Security**: Resource limits (CPU, memory), network isolation modes, and read-only volume mounts
1113
+ **PyPI Package Release (v0.1.0)**: Official distribution via `pip install massgen` with simplified installation, global `massgen` command accessible from any directory, comprehensive Sphinx documentation at [docs.massgen.ai](https://docs.massgen.ai/), interactive setup wizard with use case presets and API key management, enhanced CLI with `@examples/` prefix for built-in configurations
1109
1114
 
1110
- **⚠️ Docker Setup Required:**
1111
- To use Docker execution mode, complete these steps before running:
1112
- 1. **Docker Engine 28.0.0+** installed and running (`docker ps` should work)
1113
- 2. **Python docker library**: `uv pip install -e ".[docker]"` or `pip install docker>=7.0.0`
1114
- 3. **Build Docker image**: `bash massgen/docker/build.sh` (from repository root)
1115
- 4. **📚 Full setup guide**: See `massgen/docker/README.md` for complete instructions
1115
+ **Docker Execution Mode (v0.0.32)**: Container-based isolation with secure command execution in isolated Docker containers preventing host filesystem access, persistent state management with packages and dependencies persisting across conversation turns, multi-agent support with dedicated isolated containers for each agent, configurable security with resource limits (CPU, memory), network isolation modes, and read-only volume mounts
1116
1116
 
1117
- #### MCP Architecture Refactoring
1118
- - **Simplified Client**: Renamed `MultiMCPClient` to `MCPClient` reflecting streamlined architecture
1119
- - **Code Consolidation**: Removed deprecated modules and consolidated duplicate MCP protocol handling
1120
- - **Improved Maintainability**: Standardized type hints, enhanced error handling, cleaner code organization
1117
+ **MCP Architecture Refactoring (v0.0.32)**: Simplified client with renamed `MultiMCPClient` to `MCPClient` reflecting streamlined architecture, code consolidation by removing deprecated modules and consolidating duplicate MCP protocol handling, improved maintainability with standardized type hints, enhanced error handling, and cleaner code organization
1121
1118
 
1122
- #### Claude Code Docker Integration
1123
- - **Automatic Tool Management**: Bash tool automatically disabled in Docker mode routing commands through execute_command
1124
- - **MCP Auto-Permissions**: Automatic approval for MCP tools while preserving security validation
1125
- - **Enhanced Guidance**: System messages prevent git repository confusion between host and container environments
1119
+ **Claude Code Docker Integration (v0.0.32)**: Automatic tool management with Bash tool automatically disabled in Docker mode routing commands through execute_command, MCP auto-permissions with automatic approval for MCP tools while preserving security validation, enhanced guidance with system messages preventing git repository confusion between host and container environments
1126
1120
 
1127
- #### Configuration and Testing
1128
- - **Docker Documentation**: `massgen/docker/README.md` with setup guide and build scripts
1129
- - **Example Configurations**: `docker_simple.yaml`, `docker_multi_agent.yaml`, `docker_with_resource_limits.yaml`, `docker_claude_code.yaml`, `docker_verification.yaml`
1130
- - **Testing**: Comprehensive test suite validating Docker and local execution modes
1121
+ **Universal Command Execution (v0.0.31)**: MCP-based execute_command tool works across Claude, Gemini, OpenAI, and Chat Completions providers, comprehensive security with permission management and command filtering, code execution in planning mode for safer coordination
1131
1122
 
1132
- ### Recent Achievements (v0.0.31)
1133
-
1134
- **🎉 Released: October 13, 2025**
1135
-
1136
- #### Universal Code Execution
1137
- - **MCP-Based Tool**: New `execute_command` tool works across Claude, Gemini, OpenAI, and Chat Completions backends
1138
- - **AG2-Inspired Security**: Permission management and command filtering (whitelist/blacklist patterns)
1139
- - **Planning Mode Support**: Code execution in planning mode for safer coordination
1140
-
1141
- #### AG2 Group Chat Integration
1142
- - **Multi-Agent Conversations**: Native support using AG2's GroupChat and GroupChatManager frameworks
1143
- - **Smart Speaker Selection**: Automatic, round-robin, or manual selection powered by LLMs
1144
- - **Enhanced Adapter**: AG2 adapter supporting native group chat coordination
1145
-
1146
- #### Audio & Video Generation
1147
- - **Audio Tools**: Text-to-speech and transcription capabilities
1148
- - **Video Generation**: Integration with OpenAI's Sora-2 API for video creation
1149
- - **Multimodal Expansion**: Extended capabilities beyond text and images
1150
-
1151
- ### Previous Achievements (v0.0.3 - v0.0.32)
1152
-
1153
- <div style="max-height: 600px; overflow-y: auto; transition: max-height 0.3s ease;">
1154
-
1155
- ✅ **Universal Command Execution (v0.0.31)**: MCP-based execute_command tool works across Claude, Gemini, OpenAI, and Chat Completions providers, AG2-inspired security with permission management and command filtering, code execution in planning mode for safer coordination
1156
-
1157
- ✅ **AG2 Group Chat Integration (v0.0.31)**: Multi-agent conversations using AG2's GroupChat and GroupChatManager frameworks, smart speaker selection (automatic, round-robin, manual) powered by LLMs, enhanced AG2 adapter supporting native group chat coordination
1123
+ **External Framework Integration (v0.0.31)**: Multi-agent conversations using external framework group chat patterns, smart speaker selection (automatic, round-robin, manual) powered by LLMs, enhanced adapter supporting native group chat coordination
1158
1124
 
1159
1125
  ✅ **Audio & Video Generation (v0.0.31)**: Audio tools for text-to-speech and transcription, video generation using OpenAI's Sora-2 API, multimodal expansion beyond text and images
1160
1126
 
@@ -1168,7 +1134,7 @@ To use Docker execution mode, complete these steps before running:
1168
1134
 
1169
1135
  ✅ **File Operation Safety (v0.0.29)**: Read-before-delete enforcement with `FileOperationTracker` class, `PathPermissionManager` integration with operation tracking methods, enhanced file operation safety mechanisms
1170
1136
 
1171
- ✅ **AG2 Framework Integration (v0.0.28)**: Adapter system for external agent frameworks, AG2 ConversableAgent and AssistantAgent support with async execution, code execution in multiple environments (Local, Docker, Jupyter, YepCode), 4 ready-to-use AG2 configurations
1137
+ ✅ **External Framework Integration (v0.0.28)**: Adapter system for external agent frameworks with async execution, code execution in multiple environments (Local, Docker, Jupyter, YepCode), ready-to-use configurations for framework integration
1172
1138
 
1173
1139
  ✅ **Multimodal Support - Image Processing (v0.0.27)**: New `stream_chunk` module for multimodal content, image generation and understanding capabilities, file upload and search for document Q&A, Claude Sonnet 4.5 support, enhanced workspace multimodal tools
1174
1140
 
@@ -1232,8 +1198,6 @@ To use Docker execution mode, complete these steps before running:
1232
1198
 
1233
1199
  ✅ **Extended Provider Ecosystem**: Support for 15+ providers including Cerebras AI, Together AI, Fireworks AI, Groq, Nebius AI Studio, and OpenRouter
1234
1200
 
1235
- </div>
1236
-
1237
1201
  ### Key Future Enhancements
1238
1202
 
1239
1203
  - **Bug Fixes & Backend Improvements:** Fixing image generation path issues and adding Claude multimodal support
@@ -1244,25 +1208,19 @@ To use Docker execution mode, complete these steps before running:
1244
1208
 
1245
1209
  We welcome community contributions to achieve these goals.
1246
1210
 
1247
- ### v0.1.1 Roadmap
1211
+ ### v0.1.3 Roadmap
1248
1212
 
1249
- Version 0.1.1 focuses on developer experience improvements and PyPI distribution:
1213
+ Version 0.1.3 focuses on general interoperability and enterprise collaboration:
1250
1214
 
1251
1215
  #### Required Features
1252
- - **Configuration Builder CLI**: Interactive command-line tool for generating and validating MassGen configurations
1253
- - **PyPI Package Release v0.1.0**: Official PyPI package representing new usage paradigm with easy pip installation
1254
-
1255
- #### Optional Features
1256
- - **Nested Chat Integration**: Complete AG2 nested chat pattern support for hierarchical agent conversations
1257
- - **DSPy Integration**: Framework integration for prompt optimization and systematic agent improvement
1216
+ - **General Interoperability**: Enable MassGen to orchestrate agents from multiple external frameworks with unified interface
1217
+ - **Final Agent Submit/Restart Tools**: Enable final agent to decide whether to submit or restart orchestration
1258
1218
 
1259
1219
  Key technical approach:
1260
- - **Config Builder**: Interactive prompts, configuration templates, validation and error checking, preset support
1261
- - **PyPI Package**: Production-ready distribution with proper dependencies, documentation, and migration guide
1262
- - **Nested Chat**: AG2 integration for hierarchical conversations with parent-child agent relationships
1263
- - **DSPy**: Prompt optimization, performance tuning, and systematic agent improvement workflows
1220
+ - **Framework Integration**: Multi-agent coordination supporting external agent frameworks with specialized agent roles (researcher, analyst, critic, synthesizer)
1221
+ - **Submit/Restart**: Multi-step task verification with access to previous agents' responses and workspaces
1264
1222
 
1265
- For detailed milestones and technical specifications, see the [full v0.1.1 roadmap](ROADMAP.md).
1223
+ For detailed milestones and technical specifications, see the [full v0.1.3 roadmap](ROADMAP.md).
1266
1224
 
1267
1225
  ---
1268
1226