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.
- massgen/__init__.py +1 -1
- massgen/agent_config.py +17 -0
- massgen/api_params_handler/_api_params_handler_base.py +1 -0
- massgen/api_params_handler/_chat_completions_api_params_handler.py +15 -2
- massgen/api_params_handler/_claude_api_params_handler.py +8 -1
- massgen/api_params_handler/_gemini_api_params_handler.py +73 -0
- massgen/api_params_handler/_response_api_params_handler.py +8 -1
- massgen/backend/base.py +83 -0
- massgen/backend/{base_with_mcp.py → base_with_custom_tool_and_mcp.py} +286 -15
- massgen/backend/capabilities.py +6 -6
- massgen/backend/chat_completions.py +200 -103
- massgen/backend/claude.py +115 -18
- massgen/backend/claude_code.py +378 -14
- massgen/backend/docs/CLAUDE_API_RESEARCH.md +3 -3
- massgen/backend/gemini.py +1333 -1629
- massgen/backend/gemini_mcp_manager.py +545 -0
- massgen/backend/gemini_trackers.py +344 -0
- massgen/backend/gemini_utils.py +43 -0
- massgen/backend/grok.py +39 -6
- massgen/backend/response.py +147 -81
- massgen/cli.py +605 -110
- massgen/config_builder.py +376 -27
- massgen/configs/README.md +123 -80
- massgen/configs/basic/multi/three_agents_default.yaml +3 -3
- massgen/configs/basic/single/single_agent.yaml +1 -1
- massgen/configs/providers/openai/gpt5_nano.yaml +3 -3
- massgen/configs/tools/custom_tools/claude_code_custom_tool_example.yaml +32 -0
- massgen/configs/tools/custom_tools/claude_code_custom_tool_example_no_path.yaml +28 -0
- massgen/configs/tools/custom_tools/claude_code_custom_tool_with_mcp_example.yaml +40 -0
- massgen/configs/tools/custom_tools/claude_code_custom_tool_with_wrong_mcp_example.yaml +38 -0
- massgen/configs/tools/custom_tools/claude_code_wrong_custom_tool_with_mcp_example.yaml +38 -0
- massgen/configs/tools/custom_tools/claude_custom_tool_example.yaml +24 -0
- massgen/configs/tools/custom_tools/claude_custom_tool_example_no_path.yaml +22 -0
- massgen/configs/tools/custom_tools/claude_custom_tool_with_mcp_example.yaml +35 -0
- massgen/configs/tools/custom_tools/claude_custom_tool_with_wrong_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/claude_wrong_custom_tool_with_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/gemini_custom_tool_example.yaml +24 -0
- massgen/configs/tools/custom_tools/gemini_custom_tool_example_no_path.yaml +22 -0
- massgen/configs/tools/custom_tools/gemini_custom_tool_with_mcp_example.yaml +35 -0
- massgen/configs/tools/custom_tools/gemini_custom_tool_with_wrong_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/gemini_wrong_custom_tool_with_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/github_issue_market_analysis.yaml +94 -0
- massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_example.yaml +24 -0
- massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_example_no_path.yaml +22 -0
- massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_with_mcp_example.yaml +35 -0
- massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_with_wrong_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/gpt5_nano_wrong_custom_tool_with_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/gpt_oss_custom_tool_example.yaml +25 -0
- massgen/configs/tools/custom_tools/gpt_oss_custom_tool_example_no_path.yaml +23 -0
- massgen/configs/tools/custom_tools/gpt_oss_custom_tool_with_mcp_example.yaml +34 -0
- massgen/configs/tools/custom_tools/gpt_oss_custom_tool_with_wrong_mcp_example.yaml +34 -0
- massgen/configs/tools/custom_tools/gpt_oss_wrong_custom_tool_with_mcp_example.yaml +34 -0
- massgen/configs/tools/custom_tools/grok3_mini_custom_tool_example.yaml +24 -0
- massgen/configs/tools/custom_tools/grok3_mini_custom_tool_example_no_path.yaml +22 -0
- massgen/configs/tools/custom_tools/grok3_mini_custom_tool_with_mcp_example.yaml +35 -0
- massgen/configs/tools/custom_tools/grok3_mini_custom_tool_with_wrong_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/grok3_mini_wrong_custom_tool_with_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/qwen_api_custom_tool_example.yaml +25 -0
- massgen/configs/tools/custom_tools/qwen_api_custom_tool_example_no_path.yaml +23 -0
- massgen/configs/tools/custom_tools/qwen_api_custom_tool_with_mcp_example.yaml +36 -0
- massgen/configs/tools/custom_tools/qwen_api_custom_tool_with_wrong_mcp_example.yaml +34 -0
- massgen/configs/tools/custom_tools/qwen_api_wrong_custom_tool_with_mcp_example.yaml +34 -0
- massgen/configs/tools/custom_tools/qwen_local_custom_tool_example.yaml +24 -0
- massgen/configs/tools/custom_tools/qwen_local_custom_tool_example_no_path.yaml +22 -0
- massgen/configs/tools/custom_tools/qwen_local_custom_tool_with_mcp_example.yaml +35 -0
- massgen/configs/tools/custom_tools/qwen_local_custom_tool_with_wrong_mcp_example.yaml +33 -0
- massgen/configs/tools/custom_tools/qwen_local_wrong_custom_tool_with_mcp_example.yaml +33 -0
- massgen/configs/tools/filesystem/claude_code_context_sharing.yaml +1 -1
- massgen/configs/tools/planning/five_agents_discord_mcp_planning_mode.yaml +7 -29
- massgen/configs/tools/planning/five_agents_filesystem_mcp_planning_mode.yaml +5 -6
- massgen/configs/tools/planning/five_agents_notion_mcp_planning_mode.yaml +4 -4
- massgen/configs/tools/planning/five_agents_twitter_mcp_planning_mode.yaml +4 -4
- massgen/configs/tools/planning/gpt5_mini_case_study_mcp_planning_mode.yaml +2 -2
- massgen/configs/voting/gemini_gpt_voting_sensitivity.yaml +67 -0
- massgen/formatter/_chat_completions_formatter.py +104 -0
- massgen/formatter/_claude_formatter.py +120 -0
- massgen/formatter/_gemini_formatter.py +448 -0
- massgen/formatter/_response_formatter.py +88 -0
- massgen/frontend/coordination_ui.py +4 -2
- massgen/logger_config.py +35 -3
- massgen/message_templates.py +56 -6
- massgen/orchestrator.py +512 -16
- massgen/stream_chunk/base.py +3 -0
- massgen/tests/custom_tools_example.py +392 -0
- massgen/tests/mcp_test_server.py +17 -7
- massgen/tests/test_config_builder.py +423 -0
- massgen/tests/test_custom_tools.py +401 -0
- massgen/tests/test_intelligent_planning_mode.py +643 -0
- massgen/tests/test_tools.py +127 -0
- massgen/token_manager/token_manager.py +13 -4
- massgen/tool/README.md +935 -0
- massgen/tool/__init__.py +39 -0
- massgen/tool/_async_helpers.py +70 -0
- massgen/tool/_basic/__init__.py +8 -0
- massgen/tool/_basic/_two_num_tool.py +24 -0
- massgen/tool/_code_executors/__init__.py +10 -0
- massgen/tool/_code_executors/_python_executor.py +74 -0
- massgen/tool/_code_executors/_shell_executor.py +61 -0
- massgen/tool/_exceptions.py +39 -0
- massgen/tool/_file_handlers/__init__.py +10 -0
- massgen/tool/_file_handlers/_file_operations.py +218 -0
- massgen/tool/_manager.py +634 -0
- massgen/tool/_registered_tool.py +88 -0
- massgen/tool/_result.py +66 -0
- massgen/tool/_self_evolution/_github_issue_analyzer.py +369 -0
- massgen/tool/docs/builtin_tools.md +681 -0
- massgen/tool/docs/exceptions.md +794 -0
- massgen/tool/docs/execution_results.md +691 -0
- massgen/tool/docs/manager.md +887 -0
- massgen/tool/docs/workflow_toolkits.md +529 -0
- massgen/tool/workflow_toolkits/__init__.py +57 -0
- massgen/tool/workflow_toolkits/base.py +55 -0
- massgen/tool/workflow_toolkits/new_answer.py +126 -0
- massgen/tool/workflow_toolkits/vote.py +167 -0
- {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/METADATA +87 -129
- {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/RECORD +120 -44
- {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/WHEEL +0 -0
- {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/entry_points.txt +0 -0
- {massgen-0.1.0a3.dist-info → massgen-0.1.2.dist-info}/licenses/LICENSE +0 -0
- {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.
|
|
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://
|
|
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 ::
|
|
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.
|
|
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.
|
|
183
|
-
- [v0.0.3 - v0.
|
|
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.
|
|
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.
|
|
216
|
-
|
|
217
|
-
**🎉 Released: October 17, 2025**
|
|
219
|
+
## 🆕 Latest Features (v0.1.2)
|
|
218
220
|
|
|
219
|
-
|
|
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
|
-
**
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
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
|
-
|
|
231
|
-
|
|
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
|
-
|
|
234
|
-
|
|
235
|
-
|
|
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 **[
|
|
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.
|
|
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:
|
|
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/
|
|
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/
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
-
→
|
|
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/
|
|
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.
|
|
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.
|
|
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.
|
|
1085
|
+
### Recent Achievements (v0.1.2)
|
|
1075
1086
|
|
|
1076
|
-
**🎉 Released: October
|
|
1087
|
+
**🎉 Released: October 22, 2025**
|
|
1077
1088
|
|
|
1078
|
-
####
|
|
1079
|
-
- **
|
|
1080
|
-
- **
|
|
1081
|
-
- **
|
|
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
|
-
####
|
|
1084
|
-
- **
|
|
1085
|
-
- **
|
|
1086
|
-
- **
|
|
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
|
-
####
|
|
1090
|
-
- **
|
|
1091
|
-
- **
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
✅ **
|
|
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.
|
|
1211
|
+
### v0.1.3 Roadmap
|
|
1248
1212
|
|
|
1249
|
-
Version 0.1.
|
|
1213
|
+
Version 0.1.3 focuses on general interoperability and enterprise collaboration:
|
|
1250
1214
|
|
|
1251
1215
|
#### Required Features
|
|
1252
|
-
- **
|
|
1253
|
-
- **
|
|
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
|
-
- **
|
|
1261
|
-
- **
|
|
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.
|
|
1223
|
+
For detailed milestones and technical specifications, see the [full v0.1.3 roadmap](ROADMAP.md).
|
|
1266
1224
|
|
|
1267
1225
|
---
|
|
1268
1226
|
|