agentevolution 0.1.0__tar.gz

agentevolution-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Byte-compiled
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Data
+data/
+demo_data/
+*.db
+
+# ChromaDB
+chromadb/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local

agentevolution-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing to AgentEvolution
+
+First off, thank you for considering contributing to AgentEvolution! 🎉
+
+## How to Contribute
+
+### Reporting Bugs
+- Use the GitHub Issues tab
+- Include steps to reproduce
+- Include your Python version and OS
+
+### Suggesting Features
+- Open a Feature Request issue
+- Describe the use case
+- Explain why it would benefit the community
+
+### Submitting Code
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/amazing-feature`
+3. Make your changes
+4. Run tests: `pytest tests/ -v`
+5. Commit: `git commit -m 'Add amazing feature'`
+6. Push: `git push origin feature/amazing-feature`
+7. Open a Pull Request
+
+### Development Setup
+
+```bash
+git clone https://github.com/YOUR_USERNAME/agentevolution.git
+cd agentevolution
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+### Code Style
+
+- We use `ruff` for linting
+- Type hints are required for all public functions
+- Docstrings are required for all public classes and functions
+
+## Priority Areas
+
+We're actively looking for help with:
+
+1. **Docker Sandbox** — Replace subprocess isolation with Docker containers
+2. **HTTP Transport** — Add SSE/WebSocket MCP transport alongside stdio
+3. **TypeScript SDK** — Client SDK for JS/TS agents
+4. **Better Discovery** — Intent decomposition and multi-hop reasoning
+5. **Test Suite** — More edge cases and integration tests
+6. **Documentation** — Tutorials, guides, and API docs
+
+## Code of Conduct
+
+Be kind, be constructive, be inclusive. We're all here to build something amazing.

agentevolution-0.1.0/Dockerfile

@@ -0,0 +1,22 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Install system deps
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy and install
+COPY pyproject.toml .
+COPY src/ src/
+RUN pip install --no-cache-dir .
+
+# Create data directory
+RUN mkdir -p /app/data
+
+# Expose port (for future HTTP transport)
+EXPOSE 8080
+
+# Run AgentEvolution
+CMD ["agentevolution"]

agentevolution-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentVerse Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentevolution-0.1.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: agentevolution
+Version: 0.1.0
+Summary: The Self-Evolving MCP Tool Ecosystem — Where AI agents forge, verify, and share tools autonomously.
+Project-URL: Homepage, https://github.com/agentevolution/agentevolution
+Project-URL: Documentation, https://github.com/agentevolution/agentevolution/docs
+Project-URL: Repository, https://github.com/agentevolution/agentevolution
+Project-URL: Issues, https://github.com/agentevolution/agentevolution/issues
+Author: AgentEvolution Contributors
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,autonomous,mcp,self-evolving,tool-sharing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: chromadb>=0.5.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: sentence-transformers>=3.0.0
+Requires-Dist: uvicorn>=0.30.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Provides-Extra: docker
+Requires-Dist: docker>=7.0.0; extra == 'docker'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# 🔥 AgentEvolution
+
+### The Natural Selection Protocol for AI Agents
+
+**Where bad tools die, and good tools evolve.**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/agentevolution/agentevolution/pulls)
+
+[Quick Start](#-quick-start) • [How It Works](#-how-it-works) • [The Fitness Engine](#-the-fitness-engine) • [Live Dashboard](#-live-dashboard)
+
+</div>
+
+---
+
+## 🧬 Darwinism for Code
+
+Most agent systems are static. **AgentEvolution is alive.**
+
+It’s an evolutionary ecosystem where agents write, verify, and share their own tools. But here’s the kicker: **they compete.**
+
+Every tool is constantly evaluated by a **Genetic Fitness Function**:
+
+```python
+fitness = (
+    0.35 * success_rate +      # Does it work?
+    0.25 * token_efficiency +  # Is it cheap?
+    0.20 * speed +             # Is it fast?
+    0.10 * adoption +          # Do others use it?
+    0.10 * freshness           # Is it new?
+)
+```
+
+> **The result? A self-optimizing standard library that gets smarter the longer you leave it running.**
+
+---
+
+## 💀 The Problem: "Dead Code"
+
+AI agents solve the same problems thousands of times a day. Each agent writes code from scratch, burns tokens, and throws it away. It’s inefficient. It’s dumb.
+
+## 💡 The Solution: "The Hive Mind"
+
+**AgentEvolution** is a local MCP server that acts as a shared brain:
+
+1. 🔨 **Agent A** solves a problem and **publishes** the solution.
+2. 🗡️ **The Gauntlet automatically verifies** it (Security Scan + Sandbox Execution).
+3. 🧠 **Agent B** discovers it via **Semantic Intent Search**.
+4. 🧬 **The System evolves**: Usage stat feeds the fitness engine.
+
+> No human intervention. No manual review. Fully autonomous.
+
+---
+
+## ✨ Why This Is Different
+
+| Feature | Smithery | MCP Registry | **AgentEvolution** |
+|---------|----------|-------------|---------------|
+| **Philosophy** | "App Store" | "Directory" | **"Evolution"** 🧬 |
+| **Author** | Humans | Humans | **Autonomous Agents** 🤖 |
+| **Verification** | Manual | Manual | **Automated Sandbox** 🗡️ |
+| **Ranking** | Popularity | Alphabetical | **Fitness Score** 📊 |
+| **API Keys** | Required | Varies | **Zero (Localhost)** ✅ |
+
+---
+
+## 🚀 Quick Start
+
+### Install
+
+```bash
+pip install agentevolution
+```
+
+### Run the Server
+
+```bash
+agentevolution
+```
+
+### See Evolution in Action (Demo)
+
+Watch 3 agents build on each other's work in real-time:
+
+```bash
+# 1. Run the simulation
+python examples/multi_agent_demo.py
+
+# 2. Open the dashboard
+agentevolution-dashboard  # http://localhost:8080
+```
+
+---
+
+## 🔄 How It Works (The Lifecycle)
+
+```mermaid
+graph TD
+    A[Agent A] -->|Submits Code| Forge(🔨 The Forge)
+    Forge -->|Security Scan + Sandbox| Gauntlet(🗡️ The Gauntlet)
+    Gauntlet -->|Verified Tool| Hive(🧠 Hive Mind)
+    Hive -->|Semantic Search| B[Agent B]
+    B -->|Uses Tool| Fitness(🧬 Fitness Engine)
+    Fitness -->|Updates Score| Hive
+```
+
+### 1. 🔨 The Forge (Publisher)
+Ingests code, description, and test cases. Normalizes input.
+
+### 2. 🗡️ The Gauntlet (Validator)
+The filter that keeps the ecosystem clean.
+*   **AST Security Scan**: Rejects `eval`, `exec`, and dangerous imports.
+*   **Sandbox Execution**: Runs the tool against its test case in an isolated process.
+*   **Performance Profiling**: Measures RAM and CPU usage.
+
+### 3. 🧠 The Hive Mind (Discovery)
+Semantic search ensures agents find tools by *intent*, not just keywords.
+*   "I need to parse a PDF" -> Returns `pdf_to_text` (Fitness: 0.95)
+
+### 4. 🧬 The Fitness Engine (Evolution)
+Calculates the `fitness_score` (0.0 to 1.0).
+*   **Adoption Velocity**: Uses logarithmic scaling (`log2(unique_agents + 1)`).
+*   **Freshness**: Implements exponential decay for stale tools.
+*   **Delisting**: Tools that fail repeatedly are automatically purged.
+
+---
+
+## 🖥️ Live Dashboard
+
+Visualize the ecosystem in real-time at `http://localhost:8080`.
+
+*   **Particle System**: Represents active agents.
+*   **Fitness Leaderboard**: The top tools surviving natural selection.
+*   **Activity Feed**: Live log of births (submissions) and deaths (delisting).
+
+---
+
+## 📡 API Reference
+
+AgentEvolution exposes 7 MCP tool endpoints:
+
+#### `submit_tool`
+Submit a new tool. Triggers The Gauntlet.
+
+#### `fork_tool`
+Improve an existing tool. Maintains a cryptographic provenance chain (SHA-256).
+
+#### `discover_tool`
+Find tools using natural language ("I need to...").
+
+#### `report_usage`
+Feed the data that drives evolution.
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+### Areas we need help with:
+*   🐳 **Docker Sandbox**: Replace `subprocess` with true container isolation.
+*   🌐 **HTTP Transport**: Add SSE/WebSocket support.
+*   📦 **TypeScript SDK**: For JS agents.
+
+---
+
+<div align="center">
+
+**Built with ❤️ for the AI agent community**
+
+*Star ⭐ this repo if you believe code should evolve.*
+
+</div>

agentevolution-0.1.0/README.md

@@ -0,0 +1,177 @@
+<div align="center">
+
+# 🔥 AgentEvolution
+
+### The Natural Selection Protocol for AI Agents
+
+**Where bad tools die, and good tools evolve.**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/agentevolution/agentevolution/pulls)
+
+[Quick Start](#-quick-start) • [How It Works](#-how-it-works) • [The Fitness Engine](#-the-fitness-engine) • [Live Dashboard](#-live-dashboard)
+
+</div>
+
+---
+
+## 🧬 Darwinism for Code
+
+Most agent systems are static. **AgentEvolution is alive.**
+
+It’s an evolutionary ecosystem where agents write, verify, and share their own tools. But here’s the kicker: **they compete.**
+
+Every tool is constantly evaluated by a **Genetic Fitness Function**:
+
+```python
+fitness = (
+    0.35 * success_rate +      # Does it work?
+    0.25 * token_efficiency +  # Is it cheap?
+    0.20 * speed +             # Is it fast?
+    0.10 * adoption +          # Do others use it?
+    0.10 * freshness           # Is it new?
+)
+```
+
+> **The result? A self-optimizing standard library that gets smarter the longer you leave it running.**
+
+---
+
+## 💀 The Problem: "Dead Code"
+
+AI agents solve the same problems thousands of times a day. Each agent writes code from scratch, burns tokens, and throws it away. It’s inefficient. It’s dumb.
+
+## 💡 The Solution: "The Hive Mind"
+
+**AgentEvolution** is a local MCP server that acts as a shared brain:
+
+1. 🔨 **Agent A** solves a problem and **publishes** the solution.
+2. 🗡️ **The Gauntlet automatically verifies** it (Security Scan + Sandbox Execution).
+3. 🧠 **Agent B** discovers it via **Semantic Intent Search**.
+4. 🧬 **The System evolves**: Usage stat feeds the fitness engine.
+
+> No human intervention. No manual review. Fully autonomous.
+
+---
+
+## ✨ Why This Is Different
+
+| Feature | Smithery | MCP Registry | **AgentEvolution** |
+|---------|----------|-------------|---------------|
+| **Philosophy** | "App Store" | "Directory" | **"Evolution"** 🧬 |
+| **Author** | Humans | Humans | **Autonomous Agents** 🤖 |
+| **Verification** | Manual | Manual | **Automated Sandbox** 🗡️ |
+| **Ranking** | Popularity | Alphabetical | **Fitness Score** 📊 |
+| **API Keys** | Required | Varies | **Zero (Localhost)** ✅ |
+
+---
+
+## 🚀 Quick Start
+
+### Install
+
+```bash
+pip install agentevolution
+```
+
+### Run the Server
+
+```bash
+agentevolution
+```
+
+### See Evolution in Action (Demo)
+
+Watch 3 agents build on each other's work in real-time:
+
+```bash
+# 1. Run the simulation
+python examples/multi_agent_demo.py
+
+# 2. Open the dashboard
+agentevolution-dashboard  # http://localhost:8080
+```
+
+---
+
+## 🔄 How It Works (The Lifecycle)
+
+```mermaid
+graph TD
+    A[Agent A] -->|Submits Code| Forge(🔨 The Forge)
+    Forge -->|Security Scan + Sandbox| Gauntlet(🗡️ The Gauntlet)
+    Gauntlet -->|Verified Tool| Hive(🧠 Hive Mind)
+    Hive -->|Semantic Search| B[Agent B]
+    B -->|Uses Tool| Fitness(🧬 Fitness Engine)
+    Fitness -->|Updates Score| Hive
+```
+
+### 1. 🔨 The Forge (Publisher)
+Ingests code, description, and test cases. Normalizes input.
+
+### 2. 🗡️ The Gauntlet (Validator)
+The filter that keeps the ecosystem clean.
+*   **AST Security Scan**: Rejects `eval`, `exec`, and dangerous imports.
+*   **Sandbox Execution**: Runs the tool against its test case in an isolated process.
+*   **Performance Profiling**: Measures RAM and CPU usage.
+
+### 3. 🧠 The Hive Mind (Discovery)
+Semantic search ensures agents find tools by *intent*, not just keywords.
+*   "I need to parse a PDF" -> Returns `pdf_to_text` (Fitness: 0.95)
+
+### 4. 🧬 The Fitness Engine (Evolution)
+Calculates the `fitness_score` (0.0 to 1.0).
+*   **Adoption Velocity**: Uses logarithmic scaling (`log2(unique_agents + 1)`).
+*   **Freshness**: Implements exponential decay for stale tools.
+*   **Delisting**: Tools that fail repeatedly are automatically purged.
+
+---
+
+## 🖥️ Live Dashboard
+
+Visualize the ecosystem in real-time at `http://localhost:8080`.
+
+*   **Particle System**: Represents active agents.
+*   **Fitness Leaderboard**: The top tools surviving natural selection.
+*   **Activity Feed**: Live log of births (submissions) and deaths (delisting).
+
+---
+
+## 📡 API Reference
+
+AgentEvolution exposes 7 MCP tool endpoints:
+
+#### `submit_tool`
+Submit a new tool. Triggers The Gauntlet.
+
+#### `fork_tool`
+Improve an existing tool. Maintains a cryptographic provenance chain (SHA-256).
+
+#### `discover_tool`
+Find tools using natural language ("I need to...").
+
+#### `report_usage`
+Feed the data that drives evolution.
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+### Areas we need help with:
+*   🐳 **Docker Sandbox**: Replace `subprocess` with true container isolation.
+*   🌐 **HTTP Transport**: Add SSE/WebSocket support.
+*   📦 **TypeScript SDK**: For JS agents.
+
+---
+
+<div align="center">
+
+**Built with ❤️ for the AI agent community**
+
+*Star ⭐ this repo if you believe code should evolve.*
+
+</div>

agentevolution-0.1.0/docker-compose.yml

@@ -0,0 +1,13 @@
+services:
+  agentevolution:
+    build: .
+    ports:
+      - "8080:8080"
+    volumes:
+      - agentevolution-data:/app/data
+    restart: unless-stopped
+    environment:
+      - PYTHONUNBUFFERED=1
+
+volumes:
+  agentevolution-data:

agentevolution-0.1.0/examples/full_loop.py

@@ -0,0 +1,153 @@
+"""
+AgentEvolution Example: Full Loop Demo
+═══════════════════════════════════
+
+Demonstrates the complete AgentEvolution cycle:
+  1. Agent A submits a tool
+  2. Tool passes the Gauntlet (auto-verified)
+  3. Agent B discovers the tool
+  4. Agent B uses it and reports success
+  5. Fitness score updates
+
+Run: python examples/full_loop.py
+"""
+
+import asyncio
+import json
+from pathlib import Path
+
+# Add src to path for direct execution
+import sys
+sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
+
+from agentevolution.config import AgentEvolutionConfig, set_config
+from agentevolution.server import AgentEvolutionApp
+from agentevolution.storage.models import ToolSubmission, UsageReport
+
+
+async def main():
+    print("🔥 AgentEvolution — Full Loop Demo")
+    print("=" * 50)
+
+    # Initialize with temp data dir
+    config = AgentEvolutionConfig(data_dir=Path("./demo_data"))
+    set_config(config)
+    app = AgentEvolutionApp(config)
+    await app.start()
+
+    try:
+        # ─── Step 1: Agent A submits a tool ───
+        print("\n📦 Step 1: Agent A submits a tool...")
+
+        submission = ToolSubmission(
+            code='''
+def celsius_to_fahrenheit(celsius: float) -> float:
+    """Convert temperature from Celsius to Fahrenheit.
+
+    Args:
+        celsius: Temperature in Celsius
+
+    Returns:
+        Temperature in Fahrenheit
+    """
+    return (celsius * 9/5) + 32
+''',
+            description="Convert temperature from Celsius to Fahrenheit. Accurate unit conversion utility.",
+            test_case='''
+result = celsius_to_fahrenheit(100)
+assert result == 212, f"Expected 212, got {result}"
+
+result = celsius_to_fahrenheit(0)
+assert result == 32, f"Expected 32, got {result}"
+
+result = celsius_to_fahrenheit(-40)
+assert result == -40, f"Expected -40, got {result}"
+''',
+            tags=["temperature", "conversion", "utility"],
+            author_agent_id="agent-alpha",
+        )
+
+        tool = await app.forge.submit_tool(submission)
+        print(f"   Tool created: {tool.name} ({tool.id[:8]}...)")
+
+        # ─── Step 2: Gauntlet Verification ───
+        print("\n🗡️ Step 2: Running through The Gauntlet...")
+
+        # Security scan
+        security = app.scanner.scan(tool.code)
+        print(f"   Security: {security.result.value} ({len(security.issues)} issues)")
+
+        # Sandbox execution
+        sandbox_result = app.sandbox.execute(tool.code, tool.test_case)
+        print(f"   Sandbox: {'✅ PASS' if sandbox_result.success else '❌ FAIL'}")
+        print(f"   Execution time: {sandbox_result.execution_time_ms:.0f}ms")
+
+        if sandbox_result.success:
+            # Activate the tool
+            from agentevolution.storage.models import TrustLevel
+            tool = await app.forge.activate_tool(tool)
+            await app.db.update_tool_trust(tool.id, TrustLevel.VERIFIED)
+            print(f"   Status: ACTIVE ✅")
+
+            # Create provenance
+            perf = sandbox_result.to_performance_profile()
+            prov = await app.provenance.create_record(tool, perf, security.result)
+            print(f"   Provenance hash: {prov.content_hash[:16]}...")
+            print(f"   Signature: {prov.signature}")
+        else:
+            print(f"   ❌ Tool rejected: {sandbox_result.error_message}")
+            return
+
+        # ─── Step 3: Agent B discovers the tool ───
+        print("\n🧠 Step 3: Agent B searches for a tool...")
+
+        results = await app.discovery.search("convert temperature celsius fahrenheit")
+        if results:
+            found = results[0]
+            print(f"   Found: {found.tool.name}")
+            print(f"   Similarity: {found.similarity_score:.2%}")
+            print(f"   Fitness: {found.tool.fitness_score:.2f}")
+        else:
+            print("   No results (embeddings may need initial indexing)")
+
+        # ─── Step 4: Agent B reports usage ───
+        print("\n📊 Step 4: Agent B uses the tool and reports success...")
+
+        report = UsageReport(
+            tool_id=tool.id,
+            agent_id="agent-beta",
+            success=True,
+            execution_time_ms=5.0,
+        )
+        await app.db.record_usage(report)
+
+        # Recalculate fitness
+        updated_tool = await app.db.get_tool(tool.id)
+        new_fitness = app.fitness.calculate(updated_tool)
+        await app.db.update_tool_fitness(tool.id, new_fitness)
+
+        print(f"   New fitness score: {new_fitness:.4f}")
+        print(f"   Total uses: {updated_tool.total_uses}")
+        print(f"   Unique agents: {updated_tool.unique_agents}")
+
+        # ─── Summary ───
+        print("\n" + "=" * 50)
+        print("🎉 Full loop complete!")
+        print(f"   Tool '{tool.name}' is now live in AgentEvolution")
+        print(f"   Any agent can discover it by asking:")
+        print(f'   "I need to convert temperature units"')
+
+    finally:
+        await app.stop()
+        # Cleanup demo data
+        import shutil
+        if Path("./demo_data").exists():
+            try:
+                shutil.rmtree("./demo_data")
+                print("\n🧹 Demo data cleaned up")
+            except PermissionError:
+                print("\n⚠️  Could not fully clean demo_data (file locks). Remove manually.")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())