massgen 0.1.4__py3-none-any.whl → 0.1.5__py3-none-any.whl

{massgen-0.1.4.dist-info → massgen-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: massgen
-Version: 0.1.4
+Version: 0.1.5
 Summary: Multi-Agent Scaling System - A powerful framework for collaborative AI
 Author-email: MassGen Team <contact@massgen.dev>
 License: Apache-2.0
@@ -54,6 +54,7 @@ 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: mem0ai>=1.0.0
 Requires-Dist: reportlab>=4.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
@@ -121,7 +122,7 @@ Dynamic: license-file
 
 <p align="center">
   <a href="https://www.youtube.com/watch?v=Dp2oldJJImw">
-    <img src="assets/thumbnail.png" alt="MassGen case study -- Berkeley Agentic AI Summit Question" width="800">
+    <img src="docs/source/_static/images/thumbnail.png" alt="MassGen case study -- Berkeley Agentic AI Summit Question" width="800">
   </a>
 </p>
 
@@ -150,7 +151,7 @@ This project started with the "threads of thought" and "iterative refinement" id
 <details open>
 <summary><h3>🆕 Latest Features</h3></summary>
 
-- [v0.1.4 Features](#-latest-features-v014)
+- [v0.1.5 Features](#-latest-features-v015)
 </details>
 
 <details open>
@@ -195,16 +196,15 @@ This project started with the "threads of thought" and "iterative refinement" id
 <summary><h3>🗺️ Roadmap</h3></summary>
 
 - Recent Achievements
-  - [v0.1.4](#recent-achievements-v014)
-  - [v0.1.3](#recent-achievements-v013)
-  - [v0.0.3 - v0.1.2](#previous-achievements-v003---v012)
+  - [v0.1.5](#recent-achievements-v015)
+  - [v0.0.3 - v0.1.4](#previous-achievements-v003---v014)
 - [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.5 Roadmap](#v015-roadmap)
+- [v0.1.6 Roadmap](#v016-roadmap)
 </details>
 
 <details open>
@@ -229,37 +229,49 @@ This project started with the "threads of thought" and "iterative refinement" id
 
 ---
 
-## 🆕 Latest Features (v0.1.4)
+## 🆕 Latest Features (v0.1.5)
 
-**🎉 Released: October 27, 2025**
+**🎉 Released: October 2025**
 
-**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
+**What's New in v0.1.5:**
+- **🧠 Long-Term Memory System** - Semantic memory with retrieval across sessions
+- **🗜️ Automatic Context Compression** - Smart compression when approaching token limits
+- **🔄 Memory Sharing for Multi-Turn Conversations** - Agents access knowledge from previous turns
 
 **Key Improvements:**
-- 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
+- Persistent memory via mem0 integration with vector storage
+- Conversational memory for short-term context tracking
+- Context monitoring with real-time token usage tracking
+- Session management for memory isolation and continuation
+- Qdrant vector database integration for semantic search
 
-**Get Started with v0.1.4:**
+**Get Started with v0.1.5:**
 ```bash
 # Install or upgrade from PyPI
 pip install --upgrade massgen
 
-# 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."
+# Multi-agent collaboration with context compression
+massgen --config @examples/memory/gpt5mini_gemini_context_window_management \
+  "Analyze the MassGen codebase comprehensively. Create an architecture document that explains: (1) Core components and their responsibilities, (2) How different modules interact, (3) Key design patterns used, (4) Main entry points and request flows. Read > 30 files to build a complete understanding."
 
-# 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."
+# Research-to-implementation workflow with memory persistence
+# Prerequisites: Start Qdrant and crawl4ai Docker containers
+docker run -d -p 6333:6333 -p 6334:6334 \
+  -v $(pwd)/.massgen/qdrant_storage:/qdrant/storage:z qdrant/qdrant
+docker run -d -p 11235:11235 --name crawl4ai --shm-size=1g unclecode/crawl4ai:latest
 
-# 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)."
+# Session 1 - Research phase:
+massgen --config @examples/memory/gpt5mini_gemini_research_to_implementation \
+  "Use crawl4ai to research the latest multi-agent AI papers and techniques from 2025. Focus on: coordination mechanisms, voting strategies, tool-use patterns, and architectural innovations."
+
+# Session 2 - Implementation analysis (continue in same session):
+# "Based on the multi-agent research from earlier, which techniques should we implement in MassGen to make it more state-of-the-art? Consider MassGen's current architecture and what would be most impactful."
+
+→ See [Multi-Turn Persistent Memory Case Study](docs/source/examples/case_studies/multi-turn-persistent-memory.md) for detailed analysis
+
+# Test automatic context compression
+massgen --config @examples/memory/single_agent_compression_test \
+  "Analyze the MassGen codebase comprehensively. Create an architecture document that explains: (1) Core components and their responsibilities, (2) How different modules interact, (3) Key design patterns used, (4) Main entry points and request flows. Read > 30 files to build a complete understanding."
 ```
 
 → [See full release history and examples](massgen/configs/README.md#release-history--examples)
@@ -481,17 +493,20 @@ MassGen agents can leverage various tools to enhance their problem-solving capab
 
 **Supported Built-in Tools by Backend:**
 
-| Backend | Live Search | Code Execution | File Operations | MCP Support | Multimodal (Image/Audio/Video) | Advanced Features |
-|---------|:-----------:|:--------------:|:---------------:|:-----------:|:----------:|:-----------------|
-| **Azure OpenAI** (NEW in v0.0.10) | ❌ | ❌ | ❌ | ❌ | ❌ | Code interpreter, Azure deployment management |
-| **Claude API**  | ✅ | ✅ | ✅ | ✅ | ✅ | Web search, code interpreter, **MCP integration** |
-| **Claude Code** | ✅ | ✅ | ✅ | ✅ | ✅<br/>*Image* | **Native Claude Code SDK, comprehensive dev tools, MCP integration** |
-| **Gemini API** | ✅ | ✅ | ✅ | ✅ | ✅<br/>*Image* | Web search, code execution, **MCP integration**|
-| **Grok API** | ✅ | ❌ | ✅ | ✅ | ❌ | Web search, **MCP integration** |
-| **OpenAI API** | ✅ | ✅ | ✅ | ✅ | ✅<br/>*Image* | Web search, code interpreter, **MCP integration** |
-| **ZAI API** | ❌ | ❌ | ✅ | ✅ | ❌ | **MCP integration** |
-
-**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)
+| Backend | Live Search | Code Execution | File Operations | MCP Support | Multimodal Understanding | Multimodal Generation | Advanced Features |
+|---------|:-----------:|:--------------:|:---------------:|:-----------:|:------------------------:|:---------------------:|:-----------------|
+| **Azure OpenAI** (NEW in v0.0.10) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | Code interpreter, Azure deployment management |
+| **Claude API**  | ✅ | ✅ | ✅ | ✅ | ✅<br/>*via custom tools* | ✅<br/>*via custom tools* | Web search, code interpreter, **MCP integration** |
+| **Claude Code** | ✅ | ✅ | ✅ | ✅ | ✅<br/>*Image (native)*<br/>*Audio/Video/Docs (custom tools)* | ✅<br/>*via custom tools* | **Native Claude Code SDK, comprehensive dev tools, MCP integration** |
+| **Gemini API** | ✅ | ✅ | ✅ | ✅ | ✅<br/>*Image (native)*<br/>*Audio/Video/Docs (custom tools)* | ✅<br/>*via custom tools* | Web search, code execution, **MCP integration**|
+| **Grok API** | ✅ | ❌ | ✅ | ✅ | ✅<br/>*via custom tools* | ✅<br/>*via custom tools* | Web search, **MCP integration** |
+| **OpenAI API** | ✅ | ✅ | ✅ | ✅ | ✅<br/>*Image (native)*<br/>*Audio/Video/Docs (custom tools)* | ✅<br/>*via custom tools* | Web search, code interpreter, **MCP integration** |
+| **ZAI API** | ❌ | ❌ | ✅ | ✅ | ✅<br/>*via custom tools* | ✅<br/>*via custom tools* | **MCP integration** |
+
+**Notes:**
+- **Multimodal Understanding** (NEW in v0.1.3): Analyze images, audio, video, and documents via custom tools using OpenAI GPT-4.1 - works with any backend
+- **Multimodal Generation** (NEW in v0.1.4): Generate images, videos, audio, and documents via custom tools using OpenAI APIs - works with any backend
+- See custom tool configurations: [`understand_image.yaml`](massgen/configs/tools/custom_tools/multimodal_tools/understand_image.yaml), [`text_to_image_generation_single.yaml`](massgen/configs/tools/custom_tools/multimodal_tools/text_to_image_generation_single.yaml)
 
 → For detailed backend capabilities and tool integration guides, see [User Guide - Backends](https://docs.massgen.ai/en/latest/user_guide/backends.html)
 
@@ -1084,6 +1099,10 @@ 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:
 
+**Featured:**
+- [**Multi-Turn Persistent Memory**](docs/source/examples/case_studies/multi-turn-persistent-memory.md) - Research-to-implementation workflow demonstrating memory system (v0.1.5) | [📹 Watch Demo](https://youtu.be/wWxxFgyw40Y)
+
+**All Case Studies:**
 - [**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
 
@@ -1096,49 +1115,63 @@ 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.4)
+### Recent Achievements (v0.1.5)
+
+**🎉 Released: October 2025**
+
+#### Memory System
+- **PersistentMemory**: Long-term semantic memory storage via mem0 integration with fact extraction and retrieval across sessions
+- **ConversationMemory**: Short-term verbatim message tracking for active conversation context
+- **Automatic Context Compression**: Smart compression when approaching token limits with configurable thresholds (trigger_threshold, target_ratio)
+- **Cross-Agent Memory Sharing**: Agents share memory with turn-aware filtering to prevent temporal information leakage
+- **Context Monitoring**: Real-time token usage tracking with automatic compression triggers
+- **Session Management**: Memory isolation and continuation across runs with session naming support
+- **Qdrant Integration**: Vector database support for efficient semantic search in both server and local modes
+- **Configurable Memory Providers**: Support for OpenAI, Anthropic, Groq, and other mem0-compatible LLM and embedding providers
+
+#### Memory Configuration
+- **Global and Per-Agent Control**: Enable/disable memory at system or individual agent level
+- **Compression Settings**: Configurable trigger thresholds and target ratios for context window management
+- **Retrieval Configuration**: Customizable retrieval limits and smart filtering to exclude recent messages
+- **Memory Persistence**: Session continuation with named sessions for cross-session memory access
+
+#### Configuration Files
+- `gpt5mini_gemini_context_window_management.yaml` - Multi-agent with automatic context compression
+- `gpt5mini_gemini_research_to_implementation.yaml` - Research-to-implementation workflow with memory
+- `gpt5mini_high_reasoning_gemini.yaml` - High reasoning agents with memory integration
+- `gpt5mini_gemini_baseline_research_to_implementation.yaml` - Baseline research workflow for comparison
+- `single_agent_compression_test.yaml` - Single agent testing context compression behavior
 
-**🎉 Released: October 27, 2025**
+#### Documentation
+- Complete memory system user guide: `docs/source/user_guide/memory.rst`
+- Design decisions documentation explaining architectural choices
+- API reference for PersistentMemory, ConversationMemory, and ContextMonitor classes
+- Comprehensive troubleshooting guide and monitoring instructions
 
-#### 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
+#### Testing Infrastructure
+- Memory test suite: `test_agent_memory.py`, `test_conversation_memory.py`, `test_orchestrator_memory.py`, `test_persistent_memory.py`
 
-#### 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`
+### Previous Achievements (v0.0.3 - v0.1.4)
 
-#### Web Scraping Capabilities
-- **Crawl4AI Tool**: `crawl4ai_tool` enables intelligent web scraping with LLM-powered content extraction and customizable patterns
+✅ **Multimodal Generation Tools (v0.1.4)**: Create images from text via DALL-E API, generate videos from descriptions, text-to-speech with audio transcription support, document generation for PDF/DOCX/XLSX/PPTX formats, image transformation capabilities for existing images
 
-#### 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
+✅ **Binary File Protection (v0.1.4)**: Automatic blocking prevents text tools from accessing 40+ binary file types including images, videos, audio, archives, and Office documents, intelligent error messages guide users to appropriate specialized tools for binary content
 
-### Previous Achievements (v0.0.3 - v0.1.3)
+✅ **Crawl4AI Integration (v0.1.4)**: Intelligent web scraping with LLM-powered content extraction and customizable extraction patterns for structured data retrieval from websites
 
-✅ **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
+✅ **Post-Evaluation Workflow (v0.1.3)**: Winning agents evaluate their own answers before submission with submit and restart capabilities, supports answer confirmation and orchestration restart with feedback across all backends
 
-✅ **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`
+✅ **Multimodal Understanding Tools (v0.1.3)**: Analyze images, transcribe audio, extract video frames, and process documents (PDF/DOCX/XLSX/PPTX) with structured JSON output, works across all backends via OpenAI GPT-4.1 integration
 
-✅ **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`
+✅ **Docker Sudo Mode (v0.1.3)**: Privileged command execution in Docker containers for system-level operations requiring elevated permissions
 
-✅ **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`
+✅ **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
 
-✅ **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
+✅ **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
 
 ✅ **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
 
-✅ **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
+✅ **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 all backends
 
 ✅ **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
 
@@ -1238,21 +1271,21 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
 
 We welcome community contributions to achieve these goals.
 
-### v0.1.5 Roadmap
+### v0.1.6 Roadmap
 
-Version 0.1.5 focuses on Docker integration for MCP tools and backend code refactoring:
+Version 0.1.6 focuses on backend code refactoring for improved maintainability and developer experience:
 
-#### Required Features
-- **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
+#### Planned Features
+- **Backend Code Refactoring**: Major code refactoring for improved maintainability and developer experience with better code organization, modularity, and architectural improvements
 
 Key technical approach:
-- **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
+- **Code Architecture**: Enhanced code organization with improved modularity and separation of concerns
+- **Developer Experience**: Simplified backend extension points, improved API clarity, better error handling and debugging support
+- **Quality Assurance**: Comprehensive testing to ensure no functionality regressions
 
-**Target Release**: October 30, 2025 (Wednesday @ 9am PT)
+**Target Release**: November 1, 2025 (Friday @ 9am PT)
 
-For detailed milestones and technical specifications, see the [full v0.1.5 roadmap](ROADMAP_v0.1.5.md).
+For detailed milestones and technical specifications, see the [full v0.1.6 roadmap](ROADMAP_v0.1.6.md).
 
 ---
 

{massgen-0.1.4.dist-info → massgen-0.1.5.dist-info}/RECORD

@@ -1,12 +1,12 @@
-massgen/__init__.py,sha256=Y3QKga-0ROs3uzv-pD1qOQhJeYGeUR1sW0W7vCyb3NI,7974
+massgen/__init__.py,sha256=FVfyqtltRkkz28-ckPTLKvNAPCLV6tPss8DqaZ_moA8,7974
 massgen/agent_config.py,sha256=wC4_V858My4yDvajLDqo0A84hSNqzj9kEU7v_9fl6RQ,33136
-massgen/chat_agent.py,sha256=Oa1yv_yzfe2twbeqCM9LGzVOXA93p13RTE35Ks-XCpk,18903
-massgen/cli.py,sha256=3VNtpflBKfTSrr1Dj07iFMMH-YhnoCDcJWWlmJ2vNW0,114861
+massgen/chat_agent.py,sha256=YYvU60wwjY3upOePVS27-3MPlkME7HzrYCx8B772OSo,37698
+massgen/cli.py,sha256=dLvvijXB-WdquJTK2NqGkA7BVBJ2wkn-peFsYHEVVZ8,130307
 massgen/config_builder.py,sha256=J881XcXqUwX_fGNAahGK0RG-zJbkWHYS-O-C8y6rWxA,142182
 massgen/coordination_tracker.py,sha256=_r8Man3uomovpXKHrlc4YBI030tkuavYQ-6fEk2JsfM,28201
 massgen/logger_config.py,sha256=BalZOpvGyeejyI5Q8e8aa9OG3dvYf7VaR-k7u9MLZBg,25457
 massgen/message_templates.py,sha256=yVtynIjwn4bG6bUJ5uAW174LO6-w7jYbG07KCJTDpcY,55900
-massgen/orchestrator.py,sha256=oRj_JHNZqKrM3pWkyrQawqPyLL2HujepGc3q5E8tu88,167064
+massgen/orchestrator.py,sha256=6QNicDee7A5BY5BcaLKI0RWFtStzDEfgvkwOa4yJ_lU,175696
 massgen/utils.py,sha256=dWsLMoRRCwBtzDe8vJQ8mfKDTpyLqstC1aH8L4j2clE,3077
 massgen/adapters/__init__.py,sha256=lYDbplvbiRfXup5e_Q3GzvGujP3V0vqElEJqVfQog2Q,726
 massgen/adapters/ag2_adapter.py,sha256=71I1acslxIrTPDWTkiTICsp2lyRrrc_F4SwQqa2K_vY,18465
@@ -55,7 +55,7 @@ massgen/backend/docs/OPENAI_response_streaming.md,sha256=ees0GpokNKgg_aAuAODJifD
 massgen/backend/docs/inference_backend.md,sha256=NNxvh6JWc2BPWLQrAJKXsXAyvggT-_KRHmboulYNw7Y,6372
 massgen/backend/docs/permissions_and_context_files.md,sha256=PWWbSHlLN51Icqz5FMRA68Xm0dkl65r84pi3AKcL1lQ,40516
 massgen/configs/BACKEND_CONFIGURATION.md,sha256=eJL8dBpGnb3o705R0Uk5QbWanKG9C30jFd8U3gqlbeE,13051
-massgen/configs/README.md,sha256=-ppvDyrZiedSfG7u6SKEPJRPx6KDwBcbKBlwBpXM-1k,32527
+massgen/configs/README.md,sha256=sciV_NIhxs89MITjrBfSWXoIZ1Bb5ixe0fI-mNE56DY,35369
 massgen/configs/ag2/ag2_case_study.yaml,sha256=kiQanWKY3VyZD6Sl-0ZBMOcWoOWU2AF26IJKKhKak4k,767
 massgen/configs/ag2/ag2_coder.yaml,sha256=jtIBULpg55BthnQ-YRXrJ1xG7Q_IqK-1N5qCitC_A_4,1131
 massgen/configs/ag2/ag2_coder_case_study.yaml,sha256=3mE5mq9zU7V6RZ_XsgiA_-4S04zCNCAYPH7FmTE1suE,1273
@@ -101,6 +101,11 @@ massgen/configs/debug/code_execution/command_filtering_whitelist.yaml,sha256=Eix
 massgen/configs/debug/code_execution/docker_verification.yaml,sha256=fx4CiJM1z7lptY7efOwI8ZCuiYOUgeGnZkcEm6pLJe0,1495
 massgen/configs/docs/DISCORD_MCP_SETUP.md,sha256=T1RhdPV8d6-cnVts-zvz-zoxv2xOtzz8e6eJthOpC2c,7377
 massgen/configs/docs/TWITTER_MCP_ENESCINAR_SETUP.md,sha256=j_BRC5b6IXj8j8lkmi040DYGdl00XHtLD6_XiW3G0Oo,2657
+massgen/configs/memory/gpt5mini_gemini_baseline_research_to_implementation.yaml,sha256=uYE7sqTu4ae-FLztw6ZZG4X-wwrcQnd1e51Q9DXUw5E,3665
+massgen/configs/memory/gpt5mini_gemini_context_window_management.yaml,sha256=8onQ_070HOT1iBzJL0EI6AAXxlMdPTe3aanTV9WmUtM,8134
+massgen/configs/memory/gpt5mini_gemini_research_to_implementation.yaml,sha256=KkdxtyfrKmqi9A_uL3ghANsxjht7RWLk3hubW7bqZZc,4337
+massgen/configs/memory/gpt5mini_high_reasoning_gemini.yaml,sha256=xC0nYXEhxQbgPtOOpMw5evcmifGYLaHvOlv3i8kM-7k,3919
+massgen/configs/memory/single_agent_compression_test.yaml,sha256=pL9LOLa3PL3PlNs6dYEcYE3uOVW6081vq6B8z8PvRGw,1976
 massgen/configs/providers/azure/azure_openai_multi.yaml,sha256=9aEPTv1dyu26fCC6MA_gzKnG_MehNE_cdT3r6t5Uccc,831
 massgen/configs/providers/azure/azure_openai_single.yaml,sha256=r_E7hwtGP5goWro6VH02DMW1Q1kOO3Z2tzLK5C3L9y0,642
 massgen/configs/providers/claude/claude.yaml,sha256=IOvxJ2s4_RC5zWRk3sBsiVwaL2XGhShfjJJ_mhCHzZ0,340
@@ -169,6 +174,7 @@ massgen/configs/tools/custom_tools/qwen_local_custom_tool_example_no_path.yaml,s
 massgen/configs/tools/custom_tools/qwen_local_custom_tool_with_mcp_example.yaml,sha256=zfvh9RNycLiPAauQmw0_qEAO2qaHBAf-sAvYpKiP87s,1609
 massgen/configs/tools/custom_tools/qwen_local_custom_tool_with_wrong_mcp_example.yaml,sha256=73JeuKxgCHz6nkquj5mANDcTBkW8Cg1zjCVtUGqYdJM,1587
 massgen/configs/tools/custom_tools/qwen_local_wrong_custom_tool_with_mcp_example.yaml,sha256=ruGn-4X-ObShSY3ZqtTSxee6_TmBniJRKF7I_3to4CM,1561
+massgen/configs/tools/custom_tools/multimodal_tools/playwright_with_img_understanding.yaml,sha256=V4K3I7sv1AVWH_8skm_ZntCAny21MSu5nvIbWALjg3w,3594
 massgen/configs/tools/custom_tools/multimodal_tools/text_to_file_generation_multi.yaml,sha256=RcZ2oJHPdsCxH2gFZOyXTZRFuuxCPtVJRnpPxjXPmKM,3334
 massgen/configs/tools/custom_tools/multimodal_tools/text_to_file_generation_single.yaml,sha256=Jl9ixbRi9LvdnSia6zOIJ5SJJr_B57WYfI5nlUum1Ko,1608
 massgen/configs/tools/custom_tools/multimodal_tools/text_to_image_generation_multi.yaml,sha256=1LYKeh5EXFgECbGe2QsQFRN4OsZAiAC-Z02iio3gheo,1946
@@ -181,6 +187,7 @@ massgen/configs/tools/custom_tools/multimodal_tools/understand_audio.yaml,sha256
 massgen/configs/tools/custom_tools/multimodal_tools/understand_file.yaml,sha256=WHXS0vdUTYBojBOP-ZenwJIv85Z5LVEadCK08CMvnnc,1366
 massgen/configs/tools/custom_tools/multimodal_tools/understand_image.yaml,sha256=i67DM3NoOPmWKGrW_lIno8vEFZwD3HEBFfZA9kOE4hQ,1316
 massgen/configs/tools/custom_tools/multimodal_tools/understand_video.yaml,sha256=5-KLpYnVsJLOinv0-z1wUh1zTB9NltxfaNqw-aNOx9k,1350
+massgen/configs/tools/custom_tools/multimodal_tools/understand_video_example.yaml,sha256=LfdJxppclGnz764y-9BR_d0ksmUA89Y5DAeqs6ch1og,1664
 massgen/configs/tools/custom_tools/multimodal_tools/youtube_video_analysis.yaml,sha256=ih8hHLjETAOreye6HEbxc6AntCeUSQ2-uf01lyjOeg4,2102
 massgen/configs/tools/filesystem/cc_gpt5_gemini_filesystem.yaml,sha256=eCnljU999bu5GG7Sl1ANdkojxnjU1vvQltmtcMjpiCM,831
 massgen/configs/tools/filesystem/claude_code_context_sharing.yaml,sha256=MvNtesvnJC2nvq5cXkCzwt7oR2ApeO3xtmrZzy8Jjks,3060
@@ -275,6 +282,22 @@ massgen/mcp_tools/docs/client.md,sha256=5xLWgJXzXTCVf3Aa4c96HJmr5l5ik413ZIxchIBo
 massgen/mcp_tools/docs/config_validator.md,sha256=E22jptaS5FXWiERmq_k9AgPMCRUVVquCH3pUadg5XLo,15729
 massgen/mcp_tools/docs/exceptions.md,sha256=8pNfzHHhQ6t_Ife9Hh3dsS2-E3_JlGvzvBcJnD4bqKY,34229
 massgen/mcp_tools/docs/security.md,sha256=qCB3iVk-WH7Mppe0Ra9-w2_Rip0jrNiDM0OtCHXTcFQ,26184
+massgen/memory/README.md,sha256=nI168IWvg_totfPnXw8CiPtOGcMwZwz13wLlSoDoJPY,7538
+massgen/memory/__init__.py,sha256=MmtPbiQe0jwbqyBLptQGmq78FppWa3ptpef2Et4JK1w,789
+massgen/memory/_base.py,sha256=l1TXptDMl960HXcNDfiyD2aENB4IoW_pM4-zNhG7PPs,5783
+massgen/memory/_compression.py,sha256=Qdd1ED6Lazx3-o1Dt3iUfAGDdmeIbn-odcwaz9I_Shk,8300
+massgen/memory/_context_monitor.py,sha256=EIBibihvYtg3gKdMexzqCJsLbHoA6qApa_zy4tQ1LZU,7611
+massgen/memory/_conversation.py,sha256=arLvoRfL5bylIwOFKDuZnXVi3p0nCvCqAPlc5nAH-GQ,8189
+massgen/memory/_fact_extraction_prompts.py,sha256=e2Jmh8uDXAFNblIsYIRhcoh1ORzOb399sr3k8PTuM4s,14924
+massgen/memory/_mem0_adapters.py,sha256=JLbC6dD2NA98Ci7VuHzc6hcuMjOYQLLIsuG8r2oGrpg,8871
+massgen/memory/_persistent.py,sha256=P2kciQTa5sZRlZ1edcxsVuKgo5u8lBFDiKWGefucUOg,27884
+massgen/memory/docker-compose.qdrant.yml,sha256=eE8voIsOrgSJ_jWuvJ492Crz17sKgIoD13XKZpqr7Io,935
+massgen/memory/examples.py,sha256=Z089ZtRRHv01kX1v35-PG9IenbEQAGA4dVAZaHD81Rc,7552
+massgen/memory/docs/DESIGN.md,sha256=vM9GuWqhxkLRICZ7UyPpcxXL1N-pdvr-r1H9j5ANb34,12885
+massgen/memory/docs/QUICKSTART.md,sha256=ItQ10tHiC9EsgtKo3vIw4LlXSuVGzfvjmgGgPALJkMY,10438
+massgen/memory/docs/SUMMARY.md,sha256=LdMkesNPJTC2zeJiktkeinyK9iTwOXX8GMGniAQLHtM,9485
+massgen/memory/docs/agent_use_memory.md,sha256=pDyd_EHD9AY3D4SjhEYXUrTNSQBTJsiBGLGmgqlX78M,13547
+massgen/memory/docs/orchestrator_use_memory.md,sha256=eKrDZUmqLrd8EjGObdYOuML-wtJhkpRPSqL9d7QilUs,22853
 massgen/stream_chunk/__init__.py,sha256=fc8Jn-Ow2ZKFWJR72DRA6r65_CtViM9NLvWGT-TrhU4,898
 massgen/stream_chunk/base.py,sha256=NubSk62R_ngr13IBTqz6HACnfh-LAsmkgzZ93nkj-fM,2810
 massgen/stream_chunk/multimodal.py,sha256=ojaO-1EFnhA0H94YczxmkP6f0XV3lvTlb62Lc-JgltI,7916
@@ -284,6 +307,7 @@ massgen/tests/custom_tools_example.py,sha256=-f6_iGfEipznkKVKdzZwgGyQXw9JzOm9Lwc
 massgen/tests/mcp_test_server.py,sha256=hx1dKMxFufzynG6sCd2117ma0ywPy9hiVjkUsAxtsP8,5660
 massgen/tests/multi_turn_conversation_design.md,sha256=q9vMFNZ-LOTqZdI8oOWAQjPIY773s_mOXptq582Pk6E,7501
 massgen/tests/multiturn_llm_input_analysis.md,sha256=Xw8PX0oAIbF_zjlRXCA62EpX1xAOGUq9brYl3UkyAR0,6997
+massgen/tests/test_agent_memory.py,sha256=bTTPIkyecYRm7yu9f5080xxQcdDIKW45EFCj-RrP4Us,18541
 massgen/tests/test_azure_openai_backend.py,sha256=a9JFdCnDDkG_PKjLxN8QqBwyzP_aNNlP543iST2pyPw,6663
 massgen/tests/test_backend_capabilities.py,sha256=MXIO-4ia07a-95JbyyBeIlz79B-eResn8ej2fpiX6II,10966
 massgen/tests/test_backend_event_loop_all.py,sha256=vfTlD2spAYVITGgwQzntFmvN_W10sSqO0XGpgESmmNQ,5565
@@ -297,6 +321,7 @@ massgen/tests/test_claude_code_orchestrator.py,sha256=1bFLHQSgPqw2ecPjoZpsSg5lw8
 massgen/tests/test_cli_backends.py,sha256=6KPYnNgwGYRCGIXJTNWBCBHK1w8ylrBWFqt_HBWlelk,5918
 massgen/tests/test_code_execution.py,sha256=fbXNg7NeUpuodpixeR7WhNAAtk9Je1VLwQQfw6N3CYU,30099
 massgen/tests/test_config_builder.py,sha256=OcDfeVcKp_7zUruujNwKkpf0pwQ5f5ZzrgnHQYiEA2g,17781
+massgen/tests/test_conversation_memory.py,sha256=o_wrjvVYB113Y24JF0s6n1Re51ly1GKDG-1LhDxlyqk,11398
 massgen/tests/test_custom_tools.py,sha256=zUOjlZdT1eC7jgx28Z3TfzUTqFvAmRumK2Uv-lq1f3E,12905
 massgen/tests/test_external_agent_backend.py,sha256=1ImeUo0tQIdaG7ASn1X-rkuHBuAUrmk3d4l8U4LaJHI,3948
 massgen/tests/test_final_presentation_fallback.py,sha256=aMG9-6TjWseGPvY_zHOiKpdi5I4jHTMUEURaIu-5oNw,8985
@@ -310,7 +335,9 @@ massgen/tests/test_message_context_building.py,sha256=8AXcVDtv0R8uI-1PVLwYVFSWP-
 massgen/tests/test_multimodal_size_limits.py,sha256=y5UAb48PqgSnsB467GRU50A0Rmi8f-hr6FpEGU40BCk,14968
 massgen/tests/test_orchestration_restart.py,sha256=YqYXokEdQuzC9u8xFAkSMSbDKtRUk2Vu2eoKxt66iOk,7239
 massgen/tests/test_orchestrator_final_presentation.py,sha256=Yt0-IACu0PGe4IpoGW7mpBDNdyFW_6W5Q1Hzry3gAys,1238
+massgen/tests/test_orchestrator_memory.py,sha256=SjzvrvYLnpaU9U5mmOy8ZD5FZ67gbUBZg1qglXqG9kI,22162
 massgen/tests/test_path_permission_manager.py,sha256=DjOQvhUE6Tg4UGGJzl8AwnFnlvQgJf2WaUVvebkK8UA,88275
+massgen/tests/test_persistent_memory.py,sha256=W9qiKEapoTLYExGZ2xALMQtfHDjVeuacCA4mwbMVpTo,15037
 massgen/tests/test_rich_terminal_display.py,sha256=r-SfoWf8T1P-cwZTnbVp3AYuxr-98h0K7XqI8Y5tcR4,12157
 massgen/tests/test_timeout.py,sha256=35Lecz6WHPZXN_B1ru-XYQQhRr-Npx_LoqemsTQk7sE,5082
 massgen/tests/test_tools.py,sha256=GnJNNB-cZj142txDwJKzN0zUKd0wb_p7lRWNJnB0qkc,3594
@@ -318,8 +345,12 @@ massgen/tests/test_v3_3agents.py,sha256=YARcuU3bc61BJhgMlojJ-AaHyIC__C31KzPf5W9f
 massgen/tests/test_v3_simple.py,sha256=MCJkqnCldRmPhZF0IMvWyjbO9Xjz-_uv1rZqtW2kniw,6544
 massgen/tests/test_v3_three_agents.py,sha256=t76yek3DRFJpgs4hiuc9BT5VKyU_RwgHcthZxjM8otM,9266
 massgen/tests/test_v3_two_agents.py,sha256=G3WJuMdCjMdp0WItur48IGJ69B4HBs5RhpDjYJayzHo,5768
+massgen/tests/memory/test_agent_compression.py,sha256=1OD2sXrfEGm7NIzIYAo4lMOnSleAEacaAlN7Qn3Kac8,5707
+massgen/tests/memory/test_context_window_management.py,sha256=VnuEykGYZnS_OMVX4LJbHOxvq6wqGKGSY9WrLfqzTWw,10948
+massgen/tests/memory/test_force_compression.py,sha256=NBo52hWJOdBLvQsPAh812QMAOeTgC52zIA3mmHS_mY0,5749
+massgen/tests/memory/test_simple_compression.py,sha256=8WFSucWaHkHRA8lMJ5jm1Ki6ypHoVI4UXIaxFYLah1g,4889
 massgen/token_manager/__init__.py,sha256=SxFK64M3S69E51d1M37pq38O39mIZp-9TMxAspwR3wY,143
-massgen/token_manager/token_manager.py,sha256=rp1DY6KYLK9QSaAZh6IBlAwpTgwSr7PRWxd-9Ifh4bs,16586
+massgen/token_manager/token_manager.py,sha256=5S5uzLw2Zec9P3bYA1lPNluxgFg_wi6W151pGuHfb-Y,16903
 massgen/tool/README.md,sha256=wauBHnWMUIQiGendrYUeUFW7LesRznGpJx9TR5qJpEU,24365
 massgen/tool/__init__.py,sha256=YrLYvYDtVcTKs6WtwF4rtR90uoLGMmXXTedTq9GiIY4,1114
 massgen/tool/_async_helpers.py,sha256=SyfWZ_fLLq2knwM5j4TaYVV1cTWElxWRSzH1FkapcL8,2411
@@ -357,6 +388,9 @@ massgen/tool/workflow_toolkits/base.py,sha256=VcT6JOhtusYTwpc6FOdgG2Z-99ImsMNKud
 massgen/tool/workflow_toolkits/new_answer.py,sha256=x2KfMs0rM9_sJmIVYQf8Acq_NNXMIIFrmZBRFpP6y9I,4482
 massgen/tool/workflow_toolkits/post_evaluation.py,sha256=Zrp0sSdiiMm4IfiublcUAM-vMg-Duqp5WwJmVH9Rvng,9040
 massgen/tool/workflow_toolkits/vote.py,sha256=u-Tqr45OjkoaNajriLUYeQZnM69Am0M8HR-_yrDpasA,6106
+massgen/tools/__init__.py,sha256=e3V3j0F68KDQDdpkn6KUsbHds_asbfC0nVWVgmhnwjI,204
+massgen/tools/_planning_mcp_server.py,sha256=iWKGTl9XUwjlv3s44V945LwBpMDzvxVAfU7Z3Mt09Qg,16343
+massgen/tools/planning_dataclasses.py,sha256=srCMAi3-LGPjVSJ2rHUQvI-IAp32PEXE7evlG7MAGPw,14021
 massgen/v1/README.md,sha256=37ZEbNR0O5IcdqQXkqtvNCpmVX1Z_dO4HGcKreaP-0E,13631
 massgen/v1/__init__.py,sha256=hZUuhjtGlLJ-QW4Ty2V4IMlaoUB5oP0TSl0XeuCoWqU,2733
 massgen/v1/agent.py,sha256=toEN1JM1pop4ZqZj2zqCCJJtxHtMUPjTQgEI4hvnh8s,25341
@@ -377,9 +411,9 @@ massgen/v1/examples/fast-4o-mini-config.yaml,sha256=t7zmN8sWQrrWivjaBB9w_WHFDnU-
 massgen/v1/examples/fast_config.yaml,sha256=BDBCpSYJPzTZi9vAEGsCZ3lt3JV25RN-4Nf_17JAhUU,846
 massgen/v1/examples/production.yaml,sha256=hrNqzOqlQG1sL-5U8ZlA8QpCwGSoiCtqMu7Mi2gOd9s,2002
 massgen/v1/examples/single_agent.yaml,sha256=h8ysGIwPjvgnpRxTcBqw5nBz5D2MTXI_Ygdn4D9RdIA,1256
-massgen-0.1.4.dist-info/licenses/LICENSE,sha256=_r2TwhSv0GcpGeIKfwbz9z2qzOI62FHCfgSfnZ1z2fc,11386
-massgen-0.1.4.dist-info/METADATA,sha256=m3amrQv6_rRc2F9cr8bhYoPHz5rNp6Xa2h-9UjfevFg,63126
-massgen-0.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-massgen-0.1.4.dist-info/entry_points.txt,sha256=On6OV7swWO0StsAXeOri3MzmuxhO9C-PUvKW-5pJ6gA,49
-massgen-0.1.4.dist-info/top_level.txt,sha256=jm8ZxEGdkjsh8aPWXvCpnexL_S2ZRkFeT9vl6vIm_3I,8
-massgen-0.1.4.dist-info/RECORD,,
+massgen-0.1.5.dist-info/licenses/LICENSE,sha256=_r2TwhSv0GcpGeIKfwbz9z2qzOI62FHCfgSfnZ1z2fc,11386
+massgen-0.1.5.dist-info/METADATA,sha256=SRbvef4OIuyrgINJNRR7FW2UB7XK1aBpGWkkMekxYb4,65974
+massgen-0.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+massgen-0.1.5.dist-info/entry_points.txt,sha256=On6OV7swWO0StsAXeOri3MzmuxhO9C-PUvKW-5pJ6gA,49
+massgen-0.1.5.dist-info/top_level.txt,sha256=jm8ZxEGdkjsh8aPWXvCpnexL_S2ZRkFeT9vl6vIm_3I,8
+massgen-0.1.5.dist-info/RECORD,,