massgen 0.1.0a2__tar.gz → 0.1.1__tar.gz

{massgen-0.1.0a2 → massgen-0.1.1}/CHANGELOG.md

@@ -7,18 +7,108 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Recent Releases
 
+**v0.1.1 (October 2025)** - Custom Tools, Voting Controls & Documentation
+Custom Python function tools, voting sensitivity controls, interactive config builder, and comprehensive Sphinx documentation.
+
 **v0.1.0 (October 2025)** - PyPI Package & Documentation
 Official PyPI release with enhanced documentation and installation via `pip install massgen`.
 
 **v0.0.32 (October 2025)** - Docker Execution Mode
 Isolated command execution in Docker containers with resource limits and multi-agent support.
 
-**v0.0.31 (October 2025)** - Code Execution, AG2 Integration, Multimodal
-MCP-based command execution across all backends, AG2 framework integration, and audio/video generation.
-
 ---
 
-## [0.1.0] - 2025-10-15 (PyPI Release)
+## [0.1.1] - 2025-10-20
+
+### Added
+- **Custom Tools System**: Complete framework for registering and executing user-defined Python functions as tools
+  - New `ToolManager` class in `massgen/tool/_manager.py` for centralized tool registration and lifecycle management
+  - Support for custom tools alongside MCP servers across all backends (Claude, Gemini, OpenAI Response API, Chat Completions, Claude Code)
+  - Three tool categories: builtin, mcp, and custom tools
+  - Automatic tool discovery with name prefixing and conflict resolution
+  - Tool validation with parameter schema enforcement
+  - Comprehensive test coverage in `test_custom_tools.py`
+
+- **Voting Sensitivity & Answer Novelty Controls**: Three-tier system for multi-agent coordination
+  - New `voting_sensitivity` parameter with three levels: "lenient", "balanced", "strict"
+  - "Lenient": Accepts any reasonable answer
+  - "Balanced": Default middle ground
+  - "Strict": High-quality requirement
+  - Answer novelty detection with `_check_answer_novelty()` method in `orchestrator.py` preventing duplicate answers
+  - Configurable `max_new_answers_per_agent` limiting submissions per agent
+  - Token-based similarity thresholds (50-70% overlap) for duplicate detection
+
+- **Interactive Configuration Builder**: Wizard for creating YAML configurations
+  - New `config_builder.py` module with step-by-step prompts
+  - Guided workflow for backend selection, model configuration, and API key setup
+  - Model-specific parameter handling (temperature, reasoning, verbosity)
+  - Tool enablement options (MCP servers, custom tools, builtin tools)
+  - Configuration validation and preview before saving
+  - Integration with `massgen --config-builder` command
+
+- **Backend Capabilities Registry**: Centralized feature support tracking
+  - New `capabilities.py` module in `massgen/backend/` documenting backend capabilities
+  - Feature matrix showing MCP, custom tools, multimodal, and code execution support
+  - Runtime capability queries for backend selection
+
+### Changed
+- **Gemini Backend Architecture**: Major refactoring for improved maintainability
+  - Extracted MCP management into `gemini_mcp_manager.py`
+  - Extracted tracking logic into `gemini_trackers.py`
+  - Extracted utilities into `gemini_utils.py`
+  - New API params handler `_gemini_api_params_handler.py`
+  - Improved session management and tool execution flow
+
+- **Python Version Requirements**: Updated minimum supported version
+  - Changed from Python 3.10+ to Python 3.11+ in `pyproject.toml`
+  - Ensures compatibility with modern type hints and async features
+
+- **API Key Setup Command**: Simplified command name
+  - Renamed `massgen --setup-keys` to `massgen --setup` for brevity
+  - Maintained all functionality for interactive API key configuration
+
+- **Configuration Examples**: Updated example commands
+  - Changed from `python -m massgen.cli` to simplified `massgen` command
+  - Updated 40+ configuration files for consistency
+
+### Fixed
+- **CLI Configuration Selection**: Resolved error with large config lists
+  - Fixed crash when using `massgen --select` with many available configurations
+  - Improved pagination and display of configuration options
+  - Enhanced error handling for configuration discovery
+
+- **CLI Help System**: Improved documentation display
+  - Fixed help text formatting in `massgen --help`
+  - Better organization of command options and examples
+
+### Documentations, Configurations and Resources
+
+- **Case Study: Universal Code Execution via MCP**: Comprehensive v0.0.31 feature documentation
+  - `docs/case_studies/universal-code-execution-mcp.md`
+  - Demonstrates pytest test creation and execution across backends
+  - Shows command validation, security layers, and result interpretation
+
+- **Documentation Updates**: Enhanced existing documentation
+  - Added custom tools user guide and integration examples
+  - Reorganized case studies for improved navigation
+  - Updated configuration schema with new voting and tools parameters
+
+- **Custom Tools Examples**: 40+ example configurations
+  - Basic single-tool setups for each backend
+  - Multi-agent configurations with custom tools
+  - Integration examples combining MCP and custom tools
+  - Located in `configs/tools/custom_tools/`
+
+- **Voting Sensitivity Examples**: Configuration examples for voting controls
+  - `configs/voting/gemini_gpt_voting_sensitivity.yaml`
+  - Demonstrates lenient, balanced, and strict voting modes
+  - Shows answer novelty threshold configuration
+
+### Technical Details
+- **Major Focus**: Custom tools system, voting sensitivity controls, interactive config builder, and comprehensive documentation
+- **Contributors**: @qidanrui @ncrispino @praneeth999 @sonichi @Eric-Shang @Henry-811 and the MassGen team
+
+## [0.1.0] - 2025-10-17 (PyPI Release)
 
 ### Added
 - **PyPI Package Release**: Official MassGen package available on PyPI for easy installation via pip

{massgen-0.1.0a2 → massgen-0.1.1}/CONTRIBUTING.md

@@ -267,7 +267,7 @@ Create a `.env` file in the `massgen` directory as described in [README](README.
 
 ## 🔧 Development Workflow
 
-> **Important**: Our next version is v0.1.1. If you want to contribute, please contribute to the `dev/v0.1.1` branch.
+> **Important**: Our next version is v0.1.2. If you want to contribute, please contribute to the `dev/v0.1.2` branch.
 
 ### 1. Create Feature Branch
 
@@ -275,8 +275,8 @@ Create a `.env` file in the `massgen` directory as described in [README](README.
 # Fetch latest changes from upstream
 git fetch upstream
 
-# Create feature branch from dev/v0.1.1
-git checkout -b feature/your-feature-name upstream/dev/v0.1.1
+# Create feature branch from dev/v0.1.2
+git checkout -b feature/your-feature-name upstream/dev/v0.1.2
 ```
 
 ### 2. Make Your Changes
@@ -373,7 +373,7 @@ git push origin feature/your-feature-name
 ```
 
 Then create a pull request on GitHub:
-- Base branch: `dev/v0.1.1`
+- Base branch: `dev/v0.1.2`
 - Compare branch: `feature/your-feature-name`
 - Add clear description of changes
 - Link any related issues
@@ -479,7 +479,7 @@ Have a significant feature idea not covered by existing tracks?
 - [ ] Tests pass locally
 - [ ] Documentation is updated if needed
 - [ ] Commit messages follow convention
-- [ ] PR targets `dev/v0.1.1` branch
+- [ ] PR targets `dev/v0.1.2` branch
 
 ### PR Description Should Include
 

{massgen-0.1.0a2 → massgen-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: massgen
-Version: 0.1.0a2
+Version: 0.1.1
 Summary: Multi-Agent Scaling System - A powerful framework for collaborative AI
 Author-email: MassGen Team <contact@massgen.dev>
 License: Apache-2.0
@@ -8,9 +8,9 @@ Project-URL: Homepage, https://github.com/Leezekun/MassGen
 Project-URL: Repository, https://github.com/Leezekun/MassGen
 Project-URL: Bug Reports, https://github.com/Leezekun/MassGen/issues
 Project-URL: Source, https://github.com/Leezekun/MassGen
-Project-URL: Documentation, https://github.com/Leezekun/MassGen/blob/main/README.md
+Project-URL: Documentation, https://docs.massgen.ai/en/latest/
 Keywords: ai,multi-agent,collaboration,orchestration,llm,claude,gemini,gpt,xai
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Operating System :: OS Independent
@@ -48,6 +48,7 @@ Requires-Dist: pillow>=11.3.0
 Requires-Dist: ag2>=0.9.10
 Requires-Dist: pyautogen>=0.10.0
 Requires-Dist: vertexai>=1.71.1
+Requires-Dist: pytest>=8.4.2
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -82,7 +83,7 @@ Provides-Extra: all
 Dynamic: license-file
 
 <p align="center">
-  <img src="assets/logo.png" alt="MassGen Logo" width="360" />
+  <img src="https://raw.githubusercontent.com/Leezekun/MassGen/main/assets/logo.png" alt="MassGen Logo" width="360" />
 </p>
 
 <p align="center">
@@ -92,6 +93,9 @@ Dynamic: license-file
   <a href="LICENSE">
     <img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License" style="margin-right: 5px;">
   </a>
+  <a href="https://docs.massgen.ai">
+    <img src="https://img.shields.io/badge/docs-massgen.ai-blue.svg" alt="Documentation" style="margin-right: 5px;">
+  </a>
   <a href="https://discord.massgen.ai">
     <img src="https://img.shields.io/discord/1153072414184452236?color=7289da&label=chat&logo=discord&style=flat-square" alt="Join our Discord">
   </a>
@@ -105,7 +109,7 @@ Dynamic: license-file
 
 <p align="center">
   <a href="https://www.youtube.com/watch?v=Dp2oldJJImw">
-    <img src="assets/massgen-demo.gif" alt="MassGen case study -- Berkeley Agentic AI Summit Question" width="800">
+    <img src="https://raw.githubusercontent.com/Leezekun/MassGen/main/assets/massgen-demo.gif" alt="MassGen case study -- Berkeley Agentic AI Summit Question" width="800">
   </a>
 </p>
 
@@ -134,7 +138,7 @@ This project started with the "threads of thought" and "iterative refinement" id
 <details open>
 <summary><h3>🆕 Latest Features</h3></summary>
 
-- [v0.1.0 Features](#-latest-features-v010)
+- [v0.1.1 Features](#-latest-features-v011)
 </details>
 
 <details open>
@@ -179,15 +183,15 @@ This project started with the "threads of thought" and "iterative refinement" id
 <summary><h3>🗺️ Roadmap</h3></summary>
 
 - Recent Achievements
-  - [v0.1.0](#recent-achievements-v010)
-  - [v0.0.3 - v0.0.32](#previous-achievements-v003---v0032)
+  - [v0.1.1](#recent-achievements-v011)
+  - [v0.0.3 - v0.1.0](#previous-achievements-v003---v010)
 - [Key Future Enhancements](#key-future-enhancements)
   - Bug Fixes & Backend Improvements
   - Advanced Agent Collaboration
   - Expanded Model, Tool & Agent Integrations
   - Improved Performance & Scalability
   - Enhanced Developer Experience
-- [v0.1.1 Roadmap](#v011-roadmap)
+- [v0.1.2 Roadmap](#v012-roadmap)
 </details>
 
 <details open>
@@ -212,27 +216,36 @@ This project started with the "threads of thought" and "iterative refinement" id
 
 ---
 
-## 🆕 Latest Features (v0.1.0)
+## 🆕 Latest Features (v0.1.1)
+
+**🎉 Released: October 20, 2025**
+
+**What's New in v0.1.1:**
+- **🔧 Custom Tools System** - Register your own Python functions as tools
+- **⚖️ Voting Sensitivity Controls** - Three-tier quality control for multi-agent consensus
+- **🎯 Configuration Builder** - Interactive wizard to create custom configs
+- **📊 Backend Capabilities Registry** - Centralized feature support tracking
+- **🔬 Self-Evolution Capability** - Agents autonomously analyze GitHub issues and market trends for feature prioritization
 
-**🎉 Released: October 17, 2025**
+[![MassGen v0.1.1 Custom Tools & Voting Demo](https://img.youtube.com/vi/eXK_oF177zY/0.jpg)](https://youtu.be/eXK_oF177zY)
 
-**What's New in v0.1.0:**
-- **📦 PyPI Package** - Official pip installation: `pip install massgen`
-- **📖 Comprehensive Documentation** - Full Sphinx docs at [massgen.readthedocs.io](https://massgen.readthedocs.io)
-- **🎯 Interactive Setup Wizard** - Guided configuration for first-time users
-- **🚀 Simplified Commands** - Clean `massgen` CLI with `@examples/` prefix for built-in configs
+*Watch the v0.1.1 demo showcasing custom Python tool registration and three-tier voting sensitivity controls for multi-agent quality assurance*
 
-**Get Started with v0.1.0:**
+**Get Started with v0.1.1:**
 ```bash
-# Install from PyPI
-pip install massgen
+# Install or upgrade from PyPI
+pip install --upgrade massgen
 
-# Run the interactive setup wizard
-massgen
+# Create a configuration with the interactive builder
+massgen --setup
 
-# Start using with example configurations
-massgen --config @examples/basic/multi/three_agents_default \
-  "Analyze the pros and cons of renewable energy"
+# Try custom tools with agents
+massgen --config @examples/tools/custom_tools/claude_custom_tool_example \
+  "What's the sum of 123 and 456?"
+
+# Use voting sensitivity controls for quality assurance
+massgen --config @examples/voting/gemini_gpt_voting_sensitivity \
+  "What are the pros and cons of renewable energy?"
 ```
 
 → [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
 
 ---
 
-> 📖 **Complete Documentation:** For comprehensive guides, API reference, and detailed examples, visit **[massgen.readthedocs.io](https://massgen.readthedocs.io)**
+> 📖 **Complete Documentation:** For comprehensive guides, API reference, and detailed examples, visit **[MassGen Official Documentation](https://docs.massgen.ai/)**
 
 ---
 
@@ -321,7 +334,7 @@ massgen "Your question here"
 massgen --config @examples/basic/multi/three_agents_default "Your question"
 ```
 
-→ See [Installation Guide](https://massgen.readthedocs.io/en/latest/quickstart/installation.html) for complete setup instructions.
+→ See [Installation Guide](https://docs.massgen.ai/en/latest/quickstart/installation.html) for complete setup instructions.
 
 **Method 2: Development Installation** (for contributors):
 
@@ -336,7 +349,7 @@ pip install -e .
 # Or with uv (faster)
 uv pip install -e .
 
-# Optional: AG2 framework integration
+# Optional: External framework integration
 pip install -e ".[external]"
 ```
 
@@ -367,13 +380,13 @@ git clone https://github.com/Leezekun/MassGen.git
 cd MassGen
 uv tool install -e .
 # Now run from any directory
-uv tool run massgen --config @examples/basic_multi "Question"
+uv tool run massgen --config @examples/basic/multi/three_agents_default "Question"
 ```
 
 **Backwards compatibility (uv run):**
 ```bash
 cd /path/to/MassGen
-uv run massgen --config @examples/basic_multi "Question"
+uv run massgen --config @examples/basic/multi/three_agents_default "Question"
 uv run python -m massgen.cli --config config.yaml "Question"
 ```
 
@@ -411,11 +424,11 @@ OPENROUTER_API_KEY=...
 
 MassGen automatically loads API keys from `.env` in your current directory.
 
-→ **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
+→ **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
 
 **Get API keys:**
  - [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)
- - [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)
+ - [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)
 
 ### 3. 🧩 Supported Models and Tools
 
@@ -446,7 +459,7 @@ The system currently supports multiple model providers with advanced capabilitie
   - Zero-cost usage reporting
   - Support for LLaMA, Mistral, Qwen and other open-weight models
 
-→ For complete model list and configuration details, see [Supported Models](https://massgen.readthedocs.io/en/latest/reference/supported_models.html)
+→ For complete model list and configuration details, see [Supported Models](https://docs.massgen.ai/en/latest/reference/supported_models.html)
 
 #### Tools
 
@@ -466,13 +479,13 @@ MassGen agents can leverage various tools to enhance their problem-solving capab
 
 **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)
 
-→ For detailed backend capabilities and tool integration guides, see [User Guide - Backends](https://massgen.readthedocs.io/en/latest/user_guide/backends.html)
+→ For detailed backend capabilities and tool integration guides, see [User Guide - Backends](https://docs.massgen.ai/en/latest/user_guide/backends.html)
 
 ---
 
 ### 4. 🏃 Run MassGen
 
-> **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)
+> **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)
 
 #### 🚀 Getting Started
 
@@ -636,7 +649,7 @@ agents:
 
 → [View more MCP examples](massgen/configs/tools/mcp/)
 
-→ For comprehensive MCP integration guide, see [MCP Integration](https://massgen.readthedocs.io/en/latest/user_guide/mcp_integration.html)
+→ For comprehensive MCP integration guide, see [MCP Integration](https://docs.massgen.ai/en/latest/user_guide/mcp_integration.html)
 
 #### **4. File System Operations & Workspace Management**
 
@@ -715,7 +728,7 @@ orchestrator:
 >
 > The agents will execute file operations without additional confirmation once permissions are granted.
 
-→ For comprehensive file operations guide, see [File Operations](https://massgen.readthedocs.io/en/latest/user_guide/file_operations.html)
+→ For comprehensive file operations guide, see [File Operations](https://docs.massgen.ai/en/latest/user_guide/file_operations.html)
 
 #### **5. Project Integration & User Context Paths (NEW in v0.0.21)**
 
@@ -841,9 +854,7 @@ agents:
       cwd: "workspace1"                 # → .massgen/workspaces/workspace1/
 ```
 
-→ [Learn more about project integration](massgen/mcp_tools/permissions_and_context_files.md)
-
-→ For comprehensive project integration guide, see [Project Integration](https://massgen.readthedocs.io/en/latest/user_guide/project_integration.html)
+→ For comprehensive project integration guide, see [Project Integration](https://docs.massgen.ai/en/latest/user_guide/project_integration.html)
 
 **Security Considerations:**
 - **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 \
 **OpenAI (GPT-5 Series with MCP - v0.0.17+)**
 ```bash
 # GPT-5 with weather and external tools
-massgen --config @examples/tools/mcp/gpt5_mini_mcp_example \
+massgen --config @examples/tools/mcp/gpt5_nano_mcp_example \
   "What's the weather of Tokyo"
 ```
 
@@ -1053,14 +1064,14 @@ All sessions are automatically logged with detailed information for debugging an
 - **Agent Outputs** (`agent_outputs/`): Complete output history and final presentations from all agents
 - **Debug Log** (`massgen.log`): Complete system operations, API calls, tool usage, and error traces (use `--debug` for verbose logging)
 
-→ For comprehensive logging guide and debugging techniques, see [Logging & Debugging](https://massgen.readthedocs.io/en/latest/user_guide/logging.html)
+→ For comprehensive logging guide and debugging techniques, see [Logging & Debugging](https://docs.massgen.ai/en/latest/user_guide/logging.html)
 
 ## 💡 Case Studies
 
 To see how MassGen works in practice, check out these detailed case studies based on real session logs:
 
 - [**MassGen Case Studies**](docs/case_studies/README.md)
-- [**Case Studies Documentation**](https://massgen.readthedocs.io/en/latest/examples/case_studies.html) - Browse case studies online
+- [**Case Studies Documentation**](https://docs.massgen.ai/en/latest/examples/case_studies.html) - Browse case studies online
 
 ---
 
@@ -1071,90 +1082,43 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
 
 ⚠️ **Early Stage Notice:** As MassGen is in active development, please expect upcoming breaking architecture changes as we continue to refine and improve the system.
 
-### Recent Achievements (v0.1.0)
-
-**🎉 Released: October 17, 2025**
+### Recent Achievements (v0.1.1)
 
-#### PyPI Package Release
-- **Official Distribution**: MassGen now available via `pip install massgen`
-- **Simplified Installation**: No need to clone repository for standard usage
-- **Global Access**: Run `massgen` command from any directory after pip install
+**🎉 Released: October 20, 2025**
 
-#### Comprehensive Documentation
-- **Sphinx Documentation**: Full documentation site at [massgen.readthedocs.io](https://massgen.readthedocs.io)
-- **Complete User Guide**: Installation, configuration, usage modes, and API reference
-- **Case Studies**: Real-world examples with session logs and outcomes
-- **Structured Navigation**: Getting Started, User Guide, Reference, Examples, and Development sections
+#### Custom Tools System
+- **User-Defined Functions**: Register Python functions as tools using `ToolManager` class in `massgen/tool/_manager.py`
+- **Cross-Backend Support**: Works alongside MCP servers across all backends (Claude, Gemini, OpenAI, Chat Completions, Claude Code)
+- **Tool Categories**: Builtin, MCP, and custom tools with automatic discovery and conflict resolution
+- **40+ Examples**: Ready-to-use configurations in `massgen/configs/tools/custom_tools/`
 
-#### Interactive Setup Wizard
-- **Guided Configuration**: Step-by-step wizard for first-time users
-- **Use Case Presets**: Research, Code, Q&A, Data Analysis, and more
-- **API Key Management**: Centralized configuration in `~/.config/massgen/`
-- **Smart Defaults**: Auto-configured tools based on selected use case
+#### Voting Sensitivity & Answer Quality Controls
+- **Three-Tier System**: "lenient", "balanced", "strict" voting modes
+- **Answer Novelty Detection**: Prevents duplicate submissions with configurable similarity thresholds
+- **Quality Assurance**: Configurable `max_new_answers_per_agent` and token-based overlap detection
+- **Configuration**: `massgen/configs/voting/gemini_gpt_voting_sensitivity.yaml`
 
-#### Enhanced CLI Experience
-- **Simplified Commands**: Clean `massgen` command with intuitive syntax
-- **Built-in Examples**: `@examples/` prefix for instant access to configurations
-- **Backwards Compatibility**: Existing git clone workflows continue to work
+#### Backend & Documentation Enhancements
+- **Gemini Refactoring**: Extracted MCP management (`gemini_mcp_manager.py`), tracking (`gemini_trackers.py`), and utilities
+- **Capabilities Registry**: New `massgen/backend/capabilities.py` documenting feature support across backends
+- **Documentation Updates**: Enhanced custom tools guide, reorganized case studies, updated configuration schema
+- **Case Studies**:
+  - `docs/case_studies/github-issue-market-analysis.md` - Custom tools with GitHub issue market analysis (v0.1.1)
+  - `docs/case_studies/universal-code-execution-mcp.md` - MCP code execution across backends (v0.0.31)
 
-### Recent Achievements (v0.0.32)
+### Previous Achievements (v0.0.3 - v0.1.0)
 
-**🎉 Released: October 15, 2025**
+✅ **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
 
-#### Docker Execution Mode
-- **Container-Based Isolation**: Secure command execution in isolated Docker containers preventing host filesystem access
-- **Persistent State Management**: Packages and dependencies persist across conversation turns eliminating redundant setup
-- **Multi-Agent Support**: Each agent receives dedicated isolated container enabling safe parallel execution
-- **Configurable Security**: Resource limits (CPU, memory), network isolation modes, and read-only volume mounts
+✅ **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
 
-**⚠️ Docker Setup Required:**
-To use Docker execution mode, complete these steps before running:
-1. **Docker Engine 28.0.0+** installed and running (`docker ps` should work)
-2. **Python docker library**: `uv pip install -e ".[docker]"` or `pip install docker>=7.0.0`
-3. **Build Docker image**: `bash massgen/docker/build.sh` (from repository root)
-4. **📚 Full setup guide**: See `massgen/docker/README.md` for complete instructions
+✅ **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
 
-#### MCP Architecture Refactoring
-- **Simplified Client**: Renamed `MultiMCPClient` to `MCPClient` reflecting streamlined architecture
-- **Code Consolidation**: Removed deprecated modules and consolidated duplicate MCP protocol handling
-- **Improved Maintainability**: Standardized type hints, enhanced error handling, cleaner code organization
+✅ **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
 
-#### Claude Code Docker Integration
-- **Automatic Tool Management**: Bash tool automatically disabled in Docker mode routing commands through execute_command
-- **MCP Auto-Permissions**: Automatic approval for MCP tools while preserving security validation
-- **Enhanced Guidance**: System messages prevent git repository confusion between host and container environments
+✅ **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
 
-#### Configuration and Testing
-- **Docker Documentation**: `massgen/docker/README.md` with setup guide and build scripts
-- **Example Configurations**: `docker_simple.yaml`, `docker_multi_agent.yaml`, `docker_with_resource_limits.yaml`, `docker_claude_code.yaml`, `docker_verification.yaml`
-- **Testing**: Comprehensive test suite validating Docker and local execution modes
-
-### Recent Achievements (v0.0.31)
-
-**🎉 Released: October 13, 2025**
-
-#### Universal Code Execution
-- **MCP-Based Tool**: New `execute_command` tool works across Claude, Gemini, OpenAI, and Chat Completions backends
-- **AG2-Inspired Security**: Permission management and command filtering (whitelist/blacklist patterns)
-- **Planning Mode Support**: Code execution in planning mode for safer coordination
-
-#### AG2 Group Chat Integration
-- **Multi-Agent Conversations**: Native support using AG2's GroupChat and GroupChatManager frameworks
-- **Smart Speaker Selection**: Automatic, round-robin, or manual selection powered by LLMs
-- **Enhanced Adapter**: AG2 adapter supporting native group chat coordination
-
-#### Audio & Video Generation
-- **Audio Tools**: Text-to-speech and transcription capabilities
-- **Video Generation**: Integration with OpenAI's Sora-2 API for video creation
-- **Multimodal Expansion**: Extended capabilities beyond text and images
-
-### Previous Achievements (v0.0.3 - v0.0.32)
-
-<div style="max-height: 600px; overflow-y: auto; transition: max-height 0.3s ease;">
-
-✅ **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
-
-✅ **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
+✅ **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
 
 ✅ **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
 
@@ -1168,7 +1132,7 @@ To use Docker execution mode, complete these steps before running:
 
 ✅ **File Operation Safety (v0.0.29)**: Read-before-delete enforcement with `FileOperationTracker` class, `PathPermissionManager` integration with operation tracking methods, enhanced file operation safety mechanisms
 
-✅ **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
+✅ **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
 
 ✅ **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
 
@@ -1232,8 +1196,6 @@ To use Docker execution mode, complete these steps before running:
 
 ✅ **Extended Provider Ecosystem**: Support for 15+ providers including Cerebras AI, Together AI, Fireworks AI, Groq, Nebius AI Studio, and OpenRouter
 
-</div>
-
 ### Key Future Enhancements
 
 -   **Bug Fixes & Backend Improvements:** Fixing image generation path issues and adding Claude multimodal support
@@ -1244,25 +1206,21 @@ To use Docker execution mode, complete these steps before running:
 
 We welcome community contributions to achieve these goals.
 
-### v0.1.1 Roadmap
+### v0.1.2 Roadmap
 
-Version 0.1.1 focuses on developer experience improvements and PyPI distribution:
+Version 0.1.2 focuses on enterprise collaboration and intelligent agent workflows:
 
 #### Required Features
-- **Configuration Builder CLI**: Interactive command-line tool for generating and validating MassGen configurations
-- **PyPI Package Release v0.1.0**: Official PyPI package representing new usage paradigm with easy pip installation
-
-#### Optional Features
-- **Nested Chat Integration**: Complete AG2 nested chat pattern support for hierarchical agent conversations
-- **DSPy Integration**: Framework integration for prompt optimization and systematic agent improvement
+- **General Interoperability**: Enable MassGen to orchestrate agents from multiple external frameworks with unified interface
+- **Final Agent Submit/Restart Tools**: Enable final agent to decide whether to submit or restart orchestration
+- **Memory Module - Phase 1**: Long-term memory implementation using mem0 for reasoning and document understanding
 
 Key technical approach:
-- **Config Builder**: Interactive prompts, configuration templates, validation and error checking, preset support
-- **PyPI Package**: Production-ready distribution with proper dependencies, documentation, and migration guide
-- **Nested Chat**: AG2 integration for hierarchical conversations with parent-child agent relationships
-- **DSPy**: Prompt optimization, performance tuning, and systematic agent improvement workflows
+- **Framework Integration**: Multi-agent coordination supporting external agent frameworks with specialized agent roles (researcher, analyst, critic, synthesizer)
+- **Submit/Restart**: Multi-step task verification with access to previous agents' responses and workspaces
+- **Memory Module**: Session-based memory management with persistent context across conversations
 
-For detailed milestones and technical specifications, see the [full v0.1.1 roadmap](ROADMAP.md).
+For detailed milestones and technical specifications, see the [full v0.1.2 roadmap](ROADMAP.md).
 
 ---