massgen 0.1.2__tar.gz → 0.1.4__tar.gz

{massgen-0.1.2 → massgen-0.1.4}/CHANGELOG.md

@@ -7,16 +7,151 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Recent Releases
 
+**v0.1.4 (October 2025)** - Multimodal Generation Tools & Binary File Protection
+Comprehensive generation tools for images, videos, audio, and documents with OpenAI APIs, binary file blocking for security, web crawling integration, and enhanced documentation infrastructure.
+
+**v0.1.3 (October 2025)** - Post-Evaluation Tools & Multimodal Understanding
+Post-evaluation workflow with submit/restart capabilities, custom multimodal understanding tools, Docker sudo mode, and enhanced config builder.
+
 **v0.1.2 (October 2025)** - Intelligent Planning Mode & Model Updates
 Automatic irreversibility analysis for MCP tools, selective tool blocking, Claude 4.5 Haiku support, and Grok web search improvements.
 
-**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`.
+## [0.1.4] - 2025-10-27
 
----
+### Added
+- **Multimodal Generation Tools**: Comprehensive generation capabilities via OpenAI APIs
+  - New `text_to_image_generation` tool for generating images from text prompts using DALL-E models
+  - New `text_to_video_generation` tool for generating videos from text prompts
+  - New `text_to_speech_continue_generation` tool for text-to-speech with continuation support
+  - New `text_to_speech_transcription_generation` tool for audio transcription and generation
+  - New `text_to_file_generation` tool for generating documents (PDF, DOCX, XLSX, PPTX)
+  - New `image_to_image_generation` tool for image-to-image transformations
+  - Implemented in `massgen/tool/_multimodal_tools/` with 6 new modules
+
+- **Binary File Protection System**: Enhanced security for file operations
+  - New binary file blocking in `PathPermissionManager` preventing text tools from reading binary files
+  - Added `BINARY_FILE_EXTENSIONS` set covering images, videos, audio, archives, executables, and Office documents
+  - New `_validate_binary_file_access()` method with intelligent tool suggestions
+  - Prevents context pollution by blocking Read, read_text_file, and read_file tools from binary files
+  - Comprehensive test suite in `test_binary_file_blocking.py`
+
+- **Crawl4AI Web Scraping Integration**: Advanced web content extraction tool
+  - New `crawl4ai_tool` for intelligent web scraping with LLM-powered extraction
+  - Implemented in `massgen/tool/_web_tools/crawl4ai_tool.py`
+
+### Changed
+- **Multimodal File Size Limits**: Enhanced validation and automatic handling
+  - Automatic image resizing for files exceeding size limits
+  - Comprehensive size limit test suite in `test_multimodal_size_limits.py`
+  - Enhanced validation in understand_audio and understand_video tools
+
+### Documentations, Configurations and Resources
+
+- **PyPI Package Documentation**: Standalone README for PyPI distribution
+  - New `README_PYPI.md` with comprehensive package documentation
+  - Improved package metadata and installation instructions
+
+- **Release Management Documentation**: Comprehensive release workflow guide
+  - New `docs/dev_notes/release_checklist.md` with step-by-step release procedures
+  - Detailed checklist for testing, documentation, and deployment
+
+- **Binary File Protection Documentation**: Enhanced protected paths user guide
+  - Updated `docs/source/user_guide/protected_paths.rst` with binary file protection section
+  - Documents 40+ protected binary file types and specialized tool suggestions
+
+- **Enhanced Pre-commit Hooks**: Improved code quality automation
+  - Updated `.pre-commit-config.yaml` with additional checks
+  - Better README synchronization and validation
+
+- **Documentation Automation**: CI/CD for documentation deployment
+  - New `.github/workflows/docs-automation.yml` for automated doc builds
+  - Removed legacy docs.yml workflow
+
+- **Configuration Examples**: 9 new YAML configuration files
+  - **Generation Tools**: 8 multimodal generation configurations
+    - `text_to_image_generation_single.yaml` and `text_to_image_generation_multi.yaml`
+    - `text_to_video_generation_single.yaml` and `text_to_video_generation_multi.yaml`
+    - `text_to_speech_generation_single.yaml` and `text_to_speech_generation_multi.yaml`
+    - `text_to_file_generation_single.yaml` and `text_to_file_generation_multi.yaml`
+  - **Web Scraping**: `crawl4ai_example.yaml` for Crawl4AI integration
+
+### Technical Details
+- **Major Focus**: Multimodal generation tools, binary file protection system, web scraping integration
+- **Contributors**: @qidanrui @ncrispino @sonichi @Henry-811 and the MassGen team
+
+## [0.1.3] - 2025-10-24
+
+### Added
+- **Post-Evaluation Workflow Tools**: Submit and restart capabilities for winning agents
+  - New `PostEvaluationToolkit` class in `massgen/tool/workflow_toolkits/post_evaluation.py`
+  - `submit` tool for confirming final answers
+  - `restart_orchestration` tool for restarting with improvements and feedback
+  - Post-evaluation phase where winning agent evaluates its own answer
+  - Support for all API formats (Claude, Response API, Chat Completions)
+  - Configuration parameter `enable_post_evaluation_tools` for opt-in/out
+
+- **Custom Multimodal Understanding Tools**: Active tools for analyzing workspace files using OpenAI's GPT-4.1 API
+  - New `understand_image` tool for analyzing images (PNG, JPEG, JPG) with detailed metadata extraction
+  - New `understand_audio` tool for transcribing and analyzing audio files (WAV, MP3, FLAC, OGG)
+  - New `understand_video` tool for extracting frames and analyzing video content (MP4, AVI, MOV, WEBM)
+  - New `understand_file` tool for processing documents (PDF, DOCX, XLSX, PPTX) with text and metadata extraction
+  - Works with any backend (uses OpenAI for analysis)
+  - Returns structured JSON with comprehensive metadata
+
+- **Docker Sudo Mode**: Enhanced Docker execution with privileged command support
+  - New `use_sudo` parameter for Docker execution
+  - Sudo mode for commands requiring elevated privileges
+  - Enhanced security instructions and documentation
+  - Test coverage in `test_code_execution.py`
+
+### Changed
+- **Interactive Config Builder Enhancement**: Improved workflow and provider handling
+  - Better flow from automatic setup to config builder
+  - Auto-detection of environment variables
+  - Improved provider-specific configuration handling
+  - Integrated multimodal tools selection in config wizard
+
+### Fixed
+- **System Message Warning**: Resolved deprecated system message configuration warning
+  - Fixed system message handling in `agent_config.py`
+  - Updated chat agent to properly handle system messages
+  - Removed deprecated warning messages
+
+- **Config Builder Issues**: Multiple configuration builder improvements
+  - Fixed config display errors
+  - Improved config saving across different provider types
+  - Better error handling for missing configurations
+
+### Documentations, Configurations and Resources
+
+- **Multimodal Tools Documentation**: Comprehensive documentation for new multimodal tools
+  - `docs/source/user_guide/multimodal.rst`: Updated with custom tools section
+  - `massgen/tool/docs/multimodal_tools.md`: Complete 779-line technical documentation
+
+- **Docker Sudo Mode Documentation**: Enhanced Docker execution documentation
+  - `docs/source/user_guide/code_execution.rst`: Added 98 lines documenting sudo mode
+  - `massgen/docker/README.md`: Updated with sudo mode instructions
+
+- **Configuration Examples**: New example configurations
+  - `configs/tools/multimodal_tools/understand_image.yaml`: Image analysis configuration
+  - `configs/tools/multimodal_tools/understand_audio.yaml`: Audio transcription configuration
+  - `configs/tools/multimodal_tools/understand_video.yaml`: Video analysis configuration
+  - `configs/tools/multimodal_tools/understand_file.yaml`: Document processing configuration
+
+- **Example Resources**: New test resources for v0.1.3 features
+  - `massgen/configs/resources/v0.1.3-example/multimodality.jpg`: Image example
+  - `massgen/configs/resources/v0.1.3-example/Sherlock_Holmes.mp3`: Audio example
+  - `massgen/configs/resources/v0.1.3-example/oppenheimer_trailer_1920.mp4`: Video example
+  - `massgen/configs/resources/v0.1.3-example/TUMIX.pdf`: PDF document example
+
+- **Case Studies**: New case study demonstrating v0.1.3 features
+  - `docs/source/examples/case_studies/multimodal-case-study-video-analysis.md`: Meta-level demonstration of multimodal video understanding with agents analyzing their own case study videos
+
+### Technical Details
+- **Major Focus**: Post-evaluation workflow tools, custom multimodal understanding tools, Docker sudo mode
+- **Contributors**: @ncrispino @qidanrui @sonichi @Henry-811 and the MassGen team
 
 ## [0.1.2] - 2025-10-22
 
@@ -50,7 +185,7 @@ Official PyPI release with enhanced documentation and installation via `pip inst
 ### Documentations, Configurations and Resources
 
 - **Intelligent Planning Mode Case Study**: Complete feature documentation
-  - `docs/case_studies/INTELLIGENT_PLANNING_MODE.md`: Comprehensive guide for automatic planning mode
+  - `docs/source/examples/case_studies/INTELLIGENT_PLANNING_MODE.md`: Comprehensive guide for automatic planning mode
   - Demonstrates automatic irreversibility detection
   - Shows read/write operation classification
   - Includes examples for Discord, filesystem, and Twitter operations
@@ -130,7 +265,7 @@ Official PyPI release with enhanced documentation and installation via `pip inst
 ### 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`
+  - `docs/source/examples/case_studies/universal-code-execution-mcp.md`
   - Demonstrates pytest test creation and execution across backends
   - Shows command validation, security layers, and result interpretation
 

{massgen-0.1.2 → massgen-0.1.4}/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.3. If you want to contribute, please contribute to the `dev/v0.1.3` branch.
+> **Important**: Our next version is v0.1.5. If you want to contribute, please contribute to the `dev/v0.1.5` 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.3
-git checkout -b feature/your-feature-name upstream/dev/v0.1.3
+# Create feature branch from dev/v0.1.5
+git checkout -b feature/your-feature-name upstream/dev/v0.1.5
 ```
 
 ### 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.2`
+- Base branch: `dev/v0.1.5`
 - 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.3` branch
+- [ ] PR targets `dev/v0.1.5` branch
 
 ### PR Description Should Include
 
@@ -603,7 +603,7 @@ Every feature needs documentation! Here's how to decide where and what to write.
 - Feature is significant enough to showcase
 - Following case-driven development methodology
 
-**Location:** `docs/case_studies/feature_name.md`
+**Location:** `docs/source/examples/case_studies/feature_name.md`
 
 **Examples:**
 - `claude-code-workspace-management.md`
@@ -645,7 +645,7 @@ Every feature needs documentation! Here's how to decide where and what to write.
                 ┌──────────────┐
                 │ Write Case   │
                 │ Study        │
-                │ (case_studies/)│
+                │ (source/examples/case_studies/)│
                 └──────────────┘
 ```
 
@@ -659,7 +659,7 @@ Every feature needs documentation! Here's how to decide where and what to write.
 | **CHANGELOG** | Every PR | `CHANGELOG.md` | ✅ Yes |
 | **Examples** | **Every feature** | `docs/source/examples/` | ✅ **ALWAYS** |
 | **Design Doc** | Complex implementation | `docs/dev_notes/` | ⚠️ Optional |
-| **Case Study** | Demonstrate real-world usage | `docs/case_studies/` | ⚠️ Optional but expected |
+| **Case Study** | Demonstrate real-world usage | `docs/source/examples/case_studies/` | ⚠️ Optional but expected |
 
 #### 6. Documentation Quality Standards
 

{massgen-0.1.2 → massgen-0.1.4}/MANIFEST.in

@@ -1,4 +1,5 @@
 include README.md
+include README_PYPI.md
 include LICENSE
 include CONTRIBUTING.md
 include CHANGELOG.md

{massgen-0.1.2 → massgen-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: massgen
-Version: 0.1.2
+Version: 0.1.4
 Summary: Multi-Agent Scaling System - A powerful framework for collaborative AI
 Author-email: MassGen Team <contact@massgen.dev>
 License: Apache-2.0
@@ -49,6 +49,12 @@ Requires-Dist: ag2>=0.9.10
 Requires-Dist: pyautogen>=0.10.0
 Requires-Dist: vertexai>=1.71.1
 Requires-Dist: pytest>=8.4.2
+Requires-Dist: python-docx>=1.2.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: python-pptx>=1.0.2
+Requires-Dist: opencv-python>=4.12.0.88
+Requires-Dist: pypdf2>=3.0.1
+Requires-Dist: reportlab>=4.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -83,23 +89,29 @@ Provides-Extra: all
 Dynamic: license-file
 
 <p align="center">
-  <img src="assets/logo.png" alt="MassGen Logo" width="360" />
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Leezekun/MassGen/main/assets/logo-dark.png">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Leezekun/MassGen/main/assets/logo.png">
+    <img src="https://raw.githubusercontent.com/Leezekun/MassGen/main/assets/logo.png" alt="MassGen Logo" width="360" />
+  </picture>
 </p>
 
-<p align="center">
-  <a href="https://www.python.org/downloads/">
-    <img src="https://img.shields.io/badge/python-3.11+-blue.svg" alt="Python 3.11+" style="margin-right: 5px;">
-  </a>
-  <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>
-</p>
+<div align="center">
+
+[![Docs](https://img.shields.io/badge/docs-massgen.ai-blue?style=flat-square&logo=readthedocs&logoColor=white)](https://docs.massgen.ai)
+[![GitHub Stars](https://img.shields.io/github/stars/Leezekun/MassGen?style=flat-square&logo=github&color=181717&logoColor=white)](https://github.com/Leezekun/MassGen)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-green?style=flat-square)](LICENSE)
+
+</div>
+
+<div align="center">
+
+[![Follow on X](https://img.shields.io/badge/FOLLOW%20ON%20X-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.massgen.ai)
+[![Follow on LinkedIn](https://img.shields.io/badge/FOLLOW%20ON%20LINKEDIN-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/company/massgen-ai)
+[![Join our Discord](https://img.shields.io/badge/JOIN%20OUR%20DISCORD-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.massgen.ai)
+
+</div>
 
 <h1 align="center">🚀 MassGen: Multi-Agent Scaling System for GenAI</h1>
 
@@ -109,7 +121,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="assets/thumbnail.png" alt="MassGen case study -- Berkeley Agentic AI Summit Question" width="800">
   </a>
 </p>
 
@@ -138,7 +150,7 @@ This project started with the "threads of thought" and "iterative refinement" id
 <details open>
 <summary><h3>🆕 Latest Features</h3></summary>
 
-- [v0.1.2 Features](#-latest-features-v012)
+- [v0.1.4 Features](#-latest-features-v014)
 </details>
 
 <details open>
@@ -183,15 +195,16 @@ This project started with the "threads of thought" and "iterative refinement" id
 <summary><h3>🗺️ Roadmap</h3></summary>
 
 - Recent Achievements
-  - [v0.1.2](#recent-achievements-v012)
-  - [v0.0.3 - v0.1.1](#previous-achievements-v003---v011)
+  - [v0.1.4](#recent-achievements-v014)
+  - [v0.1.3](#recent-achievements-v013)
+  - [v0.0.3 - v0.1.2](#previous-achievements-v003---v012)
 - [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.3 Roadmap](#v013-roadmap)
+- [v0.1.5 Roadmap](#v015-roadmap)
 </details>
 
 <details open>
@@ -216,36 +229,37 @@ This project started with the "threads of thought" and "iterative refinement" id
 
 ---
 
-## 🆕 Latest Features (v0.1.2)
+## 🆕 Latest Features (v0.1.4)
 
-**🎉 Released: October 22, 2025**
+**🎉 Released: October 27, 2025**
 
-**What's New in v0.1.2:**
-- **🧠 Intelligent Planning Mode** - Automatic question analysis for safe MCP tool blocking
-- **🎭 Claude 4.5 Haiku Support** - Access to latest Claude Haiku model
-- **🔍 Grok Web Search Fix** - Improved web search functionality in Grok backend
+**What's New in v0.1.4:**
+- **🎨 Multimodal Generation Tools** - Create images, videos, audio, and documents with AI
+- **🔒 Binary File Protection** - Automatic security preventing accidental binary file reads
+- **🕷️ Crawl4AI Integration** - Intelligent web scraping with LLM-powered extraction
 
 **Key Improvements:**
-- Automatically determines if questions require irreversible operations
-- Read-only MCP operations allowed during coordination for better decisions
-- Write operations automatically blocked for safety
-- Zero configuration required - works transparently
-- Enhanced model support with latest Claude 4.5 Haiku
+- 6 new generation tools: text-to-image, text-to-video, text-to-speech, text-to-file, image-to-image
+- Binary file protection for 40+ file types with smart tool suggestions
+- Web crawling with customizable extraction patterns
+- Enhanced documentation and automation infrastructure
 
-**Get Started with v0.1.2:**
+**Get Started with v0.1.4:**
 ```bash
 # Install or upgrade from PyPI
 pip install --upgrade massgen
 
-# Try intelligent planning mode with MCP tools
-# (Please read the YAML file for required API keys: DISCORD_TOKEN, OPENAI_API_KEY, etc.)
-massgen --config @examples/tools/planning/five_agents_discord_mcp_planning_mode \
-  "Check recent messages in our development channel, summarize the discussion, and post a helpful response about the current topic."
+# Generate an image from text
+massgen --config @examples/tools/custom_tools/multimodal_tools/text_to_image_generation_single \
+  "Please generate an image of a cat in space."
 
-# Use latest Claude 4.5 Haiku model
-# (Requires ANTHROPIC_API_KEY in .env)
-massgen --model claude-haiku-4-5-20251001 \
-  "Summarize the latest AI developments"
+# Generate a video from text
+massgen --config @examples/tools/custom_tools/multimodal_tools/text_to_video_generation_single \
+  "Generate a 4 seconds video with neon-lit alley at night, light rain, slow push-in, cinematic."
+
+# Generate documents (PDF, DOCX, etc.)
+massgen --config @examples/tools/custom_tools/multimodal_tools/text_to_file_generation_single \
+  "Please generate a comprehensive technical report about the latest developments in Large Language Models (LLMs)."
 ```
 
 → [See full release history and examples](massgen/configs/README.md#release-history--examples)
@@ -949,7 +963,7 @@ massgen --config @examples/tools/code-execution/multi_agent_playwright_automatio
   "Navigate to https://news.ycombinator.com, extract the top 10 stories, and create a summary report"
 ```
 
-→ [**See detailed case studies**](docs/case_studies/README.md) with real session logs and outcomes
+→ [**See detailed case studies**](docs/source/examples/case_studies/README.md) with real session logs and outcomes
 
 #### Interactive Mode & Advanced Usage
 
@@ -1070,7 +1084,7 @@ All sessions are automatically logged with detailed information for debugging an
 
 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)
+- [**MassGen Case Studies**](docs/source/examples/case_studies/README.md)
 - [**Case Studies Documentation**](https://docs.massgen.ai/en/latest/examples/case_studies.html) - Browse case studies online
 
 ---
@@ -1078,33 +1092,49 @@ To see how MassGen works in practice, check out these detailed case studies base
 
 ## 🗺️ Roadmap
 
-MassGen is currently in its foundational stage, with a focus on parallel, asynchronous multi-agent collaboration and orchestration. Our roadmap is centered on transforming this foundation into a highly robust, intelligent, and user-friendly system, while enabling frontier research and exploration. An earlier version of MassGen can be found [here](./massgen/v1).
+MassGen is currently in its foundational stage, with a focus on parallel, asynchronous multi-agent collaboration and orchestration. Our roadmap is centered on transforming this foundation into a highly robust, intelligent, and user-friendly system, while enabling frontier research and exploration.
 
 ⚠️ **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.2)
+### Recent Achievements (v0.1.4)
+
+**🎉 Released: October 27, 2025**
+
+#### Multimodal Generation Tools
+- **Text-to-Image**: `text_to_image_generation` tool creates images from text prompts via DALL-E API
+- **Text-to-Video**: `text_to_video_generation` tool generates videos from text descriptions
+- **Text-to-Speech**: `text_to_speech_continue_generation` and `text_to_speech_transcription_generation` tools for audio generation and transcription
+- **Text-to-File**: `text_to_file_generation` tool creates documents in PDF, DOCX, XLSX, and PPTX formats
+- **Image-to-Image**: `image_to_image_generation` tool transforms existing images
 
-**🎉 Released: October 22, 2025**
+#### Binary File Protection
+- **Automatic Blocking**: `PathPermissionManager` now prevents text-based read tools from accessing binary files
+- **Protected File Types**: 40+ extensions including images (.jpg, .png), videos (.mp4, .avi), audio (.mp3, .wav), archives (.zip, .tar), executables (.exe, .dll), and Office documents (.pdf, .docx, .xlsx, .pptx)
+- **Intelligent Guidance**: Error messages automatically suggest appropriate specialized tools (e.g., "use understand_image tool" for .jpg files)
+- **Test Coverage**: `test_binary_file_blocking.py`
 
-#### Intelligent Planning Mode
-- **Automatic Question Analysis**: New `_analyze_question_irreversibility()` method in orchestrator determines if MCP operations are reversible
-- **Selective Tool Blocking**: Granular control with `set_planning_mode_blocked_tools()`, `get_planning_mode_blocked_tools()`, and `is_mcp_tool_blocked()` methods
-- **Dynamic Behavior**: Read-only MCP operations allowed during coordination, write operations blocked for safety
-- **Zero Configuration**: Works transparently without setup
-- **Multi-Workspace Support**: Planning mode works across different workspaces without conflicts
-- **Test Coverage**: Comprehensive tests in `massgen/tests/test_intelligent_planning_mode.py`
-- **Documentation**: Complete guide in `docs/case_studies/INTELLIGENT_PLANNING_MODE.md`
+#### Web Scraping Capabilities
+- **Crawl4AI Tool**: `crawl4ai_tool` enables intelligent web scraping with LLM-powered content extraction and customizable patterns
 
-#### Model Support & Improvements
-- **Claude 4.5 Haiku**: Added latest Claude Haiku model `claude-haiku-4-5-20251001`
-- **Model Priority Updates**: Reorganized Claude model list with updated defaults (`claude-sonnet-4-5-20250929`)
-- **Grok Web Search Fix**: Resolved `extra_body` parameter handling for Grok's Live Search API with new `_add_grok_search_params()` method
+#### Documentation & Infrastructure
+  - **Generation Tools**: 8 multimodal generation configurations
+    - `text_to_image_generation_single.yaml` and `text_to_image_generation_multi.yaml`
+    - `text_to_video_generation_single.yaml` and `text_to_video_generation_multi.yaml`
+    - `text_to_speech_generation_single.yaml` and `text_to_speech_generation_multi.yaml`
+    - `text_to_file_generation_single.yaml` and `text_to_file_generation_multi.yaml`
+  - **Web Scraping**: `crawl4ai_example.yaml` for Crawl4AI integration
 
-#### Configuration Updates
-- **Planning Mode Configs**: Updated 5 configurations in `massgen/configs/tools/planning/` with selective blocking examples
-- **Default Configuration**: Updated `three_agents_default.yaml` with Grok-4-fast model
+### Previous Achievements (v0.0.3 - v0.1.3)
 
-### Previous Achievements (v0.0.3 - v0.1.1)
+✅ **Post-Evaluation Workflow (v0.1.3)**: `PostEvaluationToolkit` class with submit tool for confirming final answers and restart tool for orchestration restart with feedback, winning agent evaluates answer before submission, universal backend support (Claude, Response API, Chat Completions), opt-in via `enable_post_evaluation_tools` parameter
+
+✅ **Multimodal Understanding Tools (v0.1.3)**: `understand_image` for PNG/JPEG analysis, `understand_audio` for WAV/MP3 transcription, `understand_video` for MP4/AVI frame extraction, `understand_file` for PDF/DOCX processing, cross-backend support via OpenAI GPT-4.1, structured JSON output, configurations: `understand_image.yaml`, `understand_audio.yaml`, `understand_video.yaml`, `understand_file.yaml`
+
+✅ **Docker Sudo Mode (v0.1.3)**: `use_sudo` parameter for privileged Docker execution, system-level command support in containers, enhanced security documentation, test coverage in `test_code_execution.py`
+
+✅ **Intelligent Planning Mode (v0.1.2)**: Automatic question analysis determining operation irreversibility via `_analyze_question_irreversibility()` in orchestrator, selective tool blocking with `set_planning_mode_blocked_tools()` and `is_mcp_tool_blocked()` methods, read-only MCP operations during coordination with write operations blocked, zero-configuration transparent operation, multi-workspace support, comprehensive tests in `test_intelligent_planning_mode.py`, complete guide in `docs/dev_notes/intelligent_planning_mode.md`
+
+✅ **Model Updates (v0.1.2)**: Claude 4.5 Haiku model `claude-haiku-4-5-20251001`, reorganized Claude model priorities with `claude-sonnet-4-5-20250929` default, Grok web search fix with `_add_grok_search_params()` method for proper `extra_body` parameter handling, 5 updated planning mode configurations in `configs/tools/planning/`, updated `three_agents_default.yaml` with Grok-4-fast
 
 ✅ **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
 
@@ -1208,19 +1238,21 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
 
 We welcome community contributions to achieve these goals.
 
-### v0.1.3 Roadmap
+### v0.1.5 Roadmap
 
-Version 0.1.3 focuses on general interoperability and enterprise collaboration:
+Version 0.1.5 focuses on Docker integration for MCP tools and backend code refactoring:
 
 #### Required Features
-- **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
+- **Running MCP Tools in Docker**: Containerized execution environment for MCP tools with enhanced security and isolation
+- **Backend Code Refactoring**: Major code refactoring for improved maintainability and developer experience
 
 Key technical approach:
-- **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
+- **Docker Integration**: Secure execution of third-party MCP tools in isolated Docker containers with resource limits and network isolation
+- **Backend Improvements**: Enhanced code organization, modularity, and architectural improvements for better maintainability
+
+**Target Release**: October 30, 2025 (Wednesday @ 9am PT)
 
-For detailed milestones and technical specifications, see the [full v0.1.3 roadmap](ROADMAP.md).
+For detailed milestones and technical specifications, see the [full v0.1.5 roadmap](ROADMAP_v0.1.5.md).
 
 ---