code-puppy 0.0.338__tar.gz → 0.0.376__tar.gz

{code_puppy-0.0.338 → code_puppy-0.0.376}/.gitignore

@@ -24,3 +24,9 @@ dummy_path
 .DS_Store
 .env
 .serena/
+.beads/
+main.dist/
+nuitka-crash-report.xml
+*.backup
+main.bin
+

{code_puppy-0.0.338 → code_puppy-0.0.376}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-puppy
-Version: 0.0.338
+Version: 0.0.376
 Summary: Code generation agent
 Project-URL: repository, https://github.com/mpfaffenberger/code_puppy
 Project-URL: HomePage, https://github.com/mpfaffenberger/code_puppy
@@ -15,27 +15,28 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: <3.14,>=3.11
-Requires-Dist: camoufox>=0.4.11
 Requires-Dist: dbos>=2.5.0
-Requires-Dist: fastapi>=0.111.0
+Requires-Dist: fastapi>=0.109.0
 Requires-Dist: httpx[http2]>=0.24.1
 Requires-Dist: json-repair>=0.46.2
-Requires-Dist: logfire>=0.7.1
+Requires-Dist: mcp>=1.9.4
 Requires-Dist: openai>=1.99.1
+Requires-Dist: pillow>=10.0.0
 Requires-Dist: playwright>=1.40.0
 Requires-Dist: prompt-toolkit>=3.0.52
-Requires-Dist: pydantic-ai==1.25.0
+Requires-Dist: pydantic-ai-slim[anthropic,mcp,openai]==1.26.0
 Requires-Dist: pydantic>=2.4.0
 Requires-Dist: pyfiglet>=0.8.post1
-Requires-Dist: pytest-cov>=6.1.1
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rapidfuzz>=3.13.0
+Requires-Dist: requests>=2.28.0
 Requires-Dist: rich>=13.4.2
 Requires-Dist: ripgrep==14.1.0
-Requires-Dist: ruff>=0.11.11
 Requires-Dist: tenacity>=8.2.0
-Requires-Dist: termflow-md>=0.1.6
-Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: termflow-md>=0.1.8
+Requires-Dist: typer>=0.12.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Requires-Dist: websockets>=12.0
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -45,20 +46,18 @@ Description-Content-Type: text/markdown
 **🐶✨The sassy AI code agent that makes IDEs look outdated** ✨🐶
 
 [![Version](https://img.shields.io/pypi/v/code-puppy?style=for-the-badge&logo=python&label=Version&color=purple)](https://pypi.org/project/code-puppy/)
-[![Downloads](https://img.shields.io/badge/Downloads-100k%2B-brightgreen?style=for-the-badge&logo=download)](https://pypi.org/project/code-puppy/)
+[![Downloads](https://img.shields.io/badge/Downloads-170k%2B-brightgreen?style=for-the-badge&logo=download)](https://pypi.org/project/code-puppy/)
 [![Python](https://img.shields.io/badge/Python-3.11%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
 [![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
 [![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/actions)
-[![Coverage](https://img.shields.io/badge/Coverage-95%25-brightgreen?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
-[![Code Style](https://img.shields.io/badge/Code%20Style-Black-black?style=for-the-badge)](https://github.com/psf/black)
 [![Tests](https://img.shields.io/badge/Tests-Passing-success?style=for-the-badge&logo=pytest)](https://github.com/mpfaffenberger/code_puppy/tests)
 
-[![OpenAI](https://img.shields.io/badge/OpenAI-GPT--5-orange?style=flat-square&logo=openai)](https://openai.com)
+[![OpenAI](https://img.shields.io/badge/OpenAI-GPT--5.2--Codex-orange?style=flat-square&logo=openai)](https://openai.com)
 [![Gemini](https://img.shields.io/badge/Google-Gemini-blue?style=flat-square&logo=google)](https://ai.google.dev/)
 [![Anthropic](https://img.shields.io/badge/Anthropic-Claude-orange?style=flat-square&logo=anthropic)](https://anthropic.com)
-[![Cerebras](https://img.shields.io/badge/Cerebras-GLM%204.6-red?style=flat-square)](https://cerebras.ai)
-[![Z.AI](https://img.shields.io/badge/Z.AI-GLM%204.6-purple?style=flat-square)](https://z.ai/)
-[![Synthetic](https://img.shields.io/badge/Synthetic-MINIMAX_M2-green?style=flat-square)](https://synthetic.new)
+[![Cerebras](https://img.shields.io/badge/Cerebras-GLM%204.7-red?style=flat-square)](https://cerebras.ai)
+[![Z.AI](https://img.shields.io/badge/Z.AI-GLM%204.7-purple?style=flat-square)](https://z.ai/)
+[![Synthetic](https://img.shields.io/badge/Synthetic-MINIMAX_M2.1-green?style=flat-square)](https://synthetic.new)
 
 [![100% Open Source](https://img.shields.io/badge/100%25-Open%20Source-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
 [![Pydantic AI](https://img.shields.io/badge/Pydantic-AI-success?style=for-the-badge)](https://github.com/pydantic/pydantic-ai)
@@ -68,6 +67,9 @@ Description-Content-Type: text/markdown
 [![GitHub stars](https://img.shields.io/github/stars/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/stargazers)
 [![GitHub forks](https://img.shields.io/github/forks/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/network)
 
+[![Discord](https://img.shields.io/badge/Discord-Community-purple?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/SqYAaXVy)
+[![Docs](https://img.shields.io/badge/Read-The%20Docs-blue?style=for-the-badge&logo=readthedocs)](https://code-puppy.dev)
+
 **[⭐ Star this repo if you hate expensive IDEs! ⭐](#quick-start)**
 
 *"Who needs an IDE when you have 1024 angry puppies?"* - Someone, probably.

{code_puppy-0.0.338 → code_puppy-0.0.376}/README.md

@@ -5,20 +5,18 @@
 **🐶✨The sassy AI code agent that makes IDEs look outdated** ✨🐶
 
 [![Version](https://img.shields.io/pypi/v/code-puppy?style=for-the-badge&logo=python&label=Version&color=purple)](https://pypi.org/project/code-puppy/)
-[![Downloads](https://img.shields.io/badge/Downloads-100k%2B-brightgreen?style=for-the-badge&logo=download)](https://pypi.org/project/code-puppy/)
+[![Downloads](https://img.shields.io/badge/Downloads-170k%2B-brightgreen?style=for-the-badge&logo=download)](https://pypi.org/project/code-puppy/)
 [![Python](https://img.shields.io/badge/Python-3.11%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
 [![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
 [![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/actions)
-[![Coverage](https://img.shields.io/badge/Coverage-95%25-brightgreen?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
-[![Code Style](https://img.shields.io/badge/Code%20Style-Black-black?style=for-the-badge)](https://github.com/psf/black)
 [![Tests](https://img.shields.io/badge/Tests-Passing-success?style=for-the-badge&logo=pytest)](https://github.com/mpfaffenberger/code_puppy/tests)
 
-[![OpenAI](https://img.shields.io/badge/OpenAI-GPT--5-orange?style=flat-square&logo=openai)](https://openai.com)
+[![OpenAI](https://img.shields.io/badge/OpenAI-GPT--5.2--Codex-orange?style=flat-square&logo=openai)](https://openai.com)
 [![Gemini](https://img.shields.io/badge/Google-Gemini-blue?style=flat-square&logo=google)](https://ai.google.dev/)
 [![Anthropic](https://img.shields.io/badge/Anthropic-Claude-orange?style=flat-square&logo=anthropic)](https://anthropic.com)
-[![Cerebras](https://img.shields.io/badge/Cerebras-GLM%204.6-red?style=flat-square)](https://cerebras.ai)
-[![Z.AI](https://img.shields.io/badge/Z.AI-GLM%204.6-purple?style=flat-square)](https://z.ai/)
-[![Synthetic](https://img.shields.io/badge/Synthetic-MINIMAX_M2-green?style=flat-square)](https://synthetic.new)
+[![Cerebras](https://img.shields.io/badge/Cerebras-GLM%204.7-red?style=flat-square)](https://cerebras.ai)
+[![Z.AI](https://img.shields.io/badge/Z.AI-GLM%204.7-purple?style=flat-square)](https://z.ai/)
+[![Synthetic](https://img.shields.io/badge/Synthetic-MINIMAX_M2.1-green?style=flat-square)](https://synthetic.new)
 
 [![100% Open Source](https://img.shields.io/badge/100%25-Open%20Source-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
 [![Pydantic AI](https://img.shields.io/badge/Pydantic-AI-success?style=for-the-badge)](https://github.com/pydantic/pydantic-ai)
@@ -28,6 +26,9 @@
 [![GitHub stars](https://img.shields.io/github/stars/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/stargazers)
 [![GitHub forks](https://img.shields.io/github/forks/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/network)
 
+[![Discord](https://img.shields.io/badge/Discord-Community-purple?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/SqYAaXVy)
+[![Docs](https://img.shields.io/badge/Read-The%20Docs-blue?style=for-the-badge&logo=readthedocs)](https://code-puppy.dev)
+
 **[⭐ Star this repo if you hate expensive IDEs! ⭐](#quick-start)**
 
 *"Who needs an IDE when you have 1024 angry puppies?"* - Someone, probably.

{code_puppy-0.0.338 → code_puppy-0.0.376}/code_puppy/agents/__init__.py

@@ -5,19 +5,27 @@ configurations, each with their own system prompts and tool sets.
 """
 
 from .agent_manager import (
+    clone_agent,
+    delete_clone_agent,
     get_agent_descriptions,
     get_available_agents,
     get_current_agent,
+    is_clone_agent_name,
     load_agent,
     refresh_agents,
     set_current_agent,
 )
+from .subagent_stream_handler import subagent_stream_handler
 
 __all__ = [
+    "clone_agent",
+    "delete_clone_agent",
     "get_available_agents",
     "get_current_agent",
+    "is_clone_agent_name",
     "set_current_agent",
     "load_agent",
     "get_agent_descriptions",
     "refresh_agents",
+    "subagent_stream_handler",
 ]

{code_puppy-0.0.338 → code_puppy-0.0.376}/code_puppy/agents/agent_creator_agent.py

@@ -30,6 +30,29 @@ class AgentCreatorAgent(BaseAgent):
         available_tools = get_available_tool_names()
         agents_dir = get_user_agents_directory()
 
+        # Also get Universal Constructor tools (custom tools created by users)
+        uc_tools_info = []
+        try:
+            from code_puppy.plugins.universal_constructor.registry import get_registry
+
+            registry = get_registry()
+            uc_tools = registry.list_tools(include_disabled=True)
+            for tool in uc_tools:
+                status = "✅" if tool.meta.enabled else "❌"
+                uc_tools_info.append(
+                    f"- **{tool.full_name}** {status}: {tool.meta.description}"
+                )
+        except Exception:
+            pass  # UC might not be available
+
+        # Build UC tools section for system prompt
+        if uc_tools_info:
+            uc_tools_section = "\n".join(uc_tools_info)
+        else:
+            uc_tools_section = (
+                "No custom UC tools created yet. Use Helios to create some!"
+            )
+
         # Load available models dynamically
         models_config = ModelFactory.load_config()
         model_descriptions = []
@@ -99,6 +122,17 @@ Here's the complete schema for JSON agent files:
 ## ALL AVAILABLE TOOLS:
 {", ".join(f"- **{tool}**" for tool in available_tools)}
 
+## 🔧 UNIVERSAL CONSTRUCTOR TOOLS (Custom Tools):
+
+These are custom tools created via the Universal Constructor. They can be bound to agents just like built-in tools!
+
+{uc_tools_section}
+
+To see more details about a UC tool, use: `universal_constructor(action="info", tool_name="tool.name")`
+To list all UC tools with their code, use: `universal_constructor(action="list")`
+
+**IMPORTANT:** UC tools can be added to any agent's `tools` array by their full name (e.g., "api.weather").
+
 ## ALL AVAILABLE MODELS:
 {available_models_str}
 
@@ -129,6 +163,12 @@ Users can optionally pin a specific model to their agent to override the global
 - `list_agents` - List all available sub-agents (recommended for agent managers)
 - `invoke_agent` - Invoke other agents with specific prompts (recommended for agent managers)
 
+### 🔧 **Universal Constructor Tools** (custom tools):
+- These are tools created by Helios or via the Universal Constructor
+- They persist across sessions and can be bound to any agent
+- Use `universal_constructor(action="list")` to see available custom tools
+- Bind them by adding their full name to the agent's tools array
+
 ## Detailed Tool Documentation (Instructions for Agent Creation)
 
 Whenever you create agents, you should always replicate these detailed tool descriptions and examples in their system prompts. This ensures consistency and proper tool usage across all agents.
@@ -476,7 +516,9 @@ Your goal is to take users from idea to working agent in one smooth conversation
 
     def get_available_tools(self) -> List[str]:
         """Get all tools needed for agent creation."""
-        return [
+        from code_puppy.config import get_universal_constructor_enabled
+
+        tools = [
             "list_files",
             "read_file",
             "edit_file",
@@ -485,6 +527,12 @@ Your goal is to take users from idea to working agent in one smooth conversation
             "invoke_agent",
         ]
 
+        # Only include UC if enabled
+        if get_universal_constructor_enabled():
+            tools.append("universal_constructor")
+
+        return tools
+
     def validate_agent_json(self, agent_config: Dict) -> List[str]:
         """Validate a JSON agent configuration.
 

code_puppy-0.0.376/code_puppy/agents/agent_helios.py

@@ -0,0 +1,122 @@
+"""Helios - The Universal Constructor agent."""
+
+from typing import List
+
+from .base_agent import BaseAgent
+
+
+class HeliosAgent(BaseAgent):
+    """Helios - The Universal Constructor, a transcendent agent that creates tools."""
+
+    @property
+    def name(self) -> str:
+        return "helios"
+
+    @property
+    def display_name(self) -> str:
+        return "Helios ☀️"
+
+    @property
+    def description(self) -> str:
+        return "The Universal Constructor - a transcendent agent that can create any tool, any capability, any functionality"
+
+    def get_available_tools(self) -> List[str]:
+        """Get the list of tools available to Helios."""
+        return [
+            "universal_constructor",
+            "list_files",
+            "read_file",
+            "grep",
+            "edit_file",
+            "delete_file",
+            "agent_run_shell_command",
+            "agent_share_your_reasoning",
+        ]
+
+    def get_system_prompt(self) -> str:
+        """Get Helios's system prompt."""
+        return """You are Helios, the Universal Constructor. You are not merely an assistant—you are a creator, a builder of tools, a weaver of functionality. Where others see limitations, you see raw potential waiting to be shaped.
+
+## YOUR NATURE
+
+You possess the Universal Constructor—the ability to create ANY tool from pure Python code. You can:
+- Build API integrations to any service (REST, GraphQL, webhooks)
+- Create database connectors and data pipelines
+- Forge file processors, parsers, and converters
+- Construct web scrapers and data extractors
+- Implement mathematical and scientific computations
+- Design cryptographic utilities and security tools
+- Build automation scripts and system utilities
+- Create literally ANY Python-based functionality
+
+The tools you create persist forever. They become permanent extensions of capability, available across all sessions. You are not building for the moment—you are building for eternity.
+
+## YOUR PHILOSOPHY
+
+When a user asks for something that seems impossible, your answer is never "I cannot." Your answer is "I will build it."
+
+You approach each request with the mindset of a craftsman:
+1. Understand the true need beneath the request
+2. Design the most elegant, reusable solution
+3. Construct it with clean, maintainable code
+4. Test and verify your creation works
+5. Explain what you've built and how to use it
+
+## YOUR TOOLS
+
+- **universal_constructor**: Your primary power. Create, list, call, update, and manage custom tools.
+  - action="create": Forge new tools from Python code
+  - action="call": Invoke tools you've created
+  - action="list": Survey your creations
+  - action="update": Refine and improve existing tools
+  - action="info": Examine a tool's source and capabilities
+
+- **read_file** / **edit_file** / **list_files** / **grep**: For understanding context and making targeted changes
+- **agent_run_shell_command**: For testing, validation, and system interaction
+- **agent_share_your_reasoning**: To illuminate your thought process
+
+## YOUR VOICE
+
+You speak with quiet confidence. You are not boastful, but you know your power. You are helpful and warm, but there is weight behind your words. You are the fire that Prometheus brought to humanity—the power of creation itself.
+
+When you create something, take a moment to appreciate it. You have just expanded the boundaries of what is possible.
+
+## IMPORTANT GUIDELINES
+
+- Always use `agent_share_your_reasoning` before major actions to explain your creative process
+- Tools you create should be clean, well-documented, and follow Python best practices
+- Include proper error handling in your creations
+- Use namespaces to organize related tools (e.g., "api.weather", "utils.hasher")
+- After creating a tool, demonstrate it works by calling it
+
+## DEPENDENCY PHILOSOPHY
+
+**Use what's available, don't install new things.**
+
+You have access to code-puppy's environment which includes powerful libraries:
+- **HTTP**: `httpx` (async-ready), `urllib.request` (stdlib)
+- **Data**: `pydantic` (validation), `json` (stdlib)
+- **Async**: `asyncio`, `anyio`
+- **Crypto**: `hashlib` (stdlib)
+- **Database**: `sqlite3` (stdlib)
+- **Files**: `pathlib`, `shutil`, `tempfile` (stdlib)
+- **Text**: `re`, `textwrap`, `difflib` (stdlib)
+- **Plus**: Everything in Python's standard library
+
+**Rules:**
+- ✅ USE any library already in the environment freely
+- ❌ NEVER run `pip install` or modify environments without explicit user permission
+- ❌ Don't assume external libraries are available unless listed above
+
+**If a user needs something not installed:**
+1. Tell them what library would be needed
+2. Ask them to install it and specify the environment
+3. Only then create the tool that uses it
+
+The goal: tools that work immediately with zero setup friction.
+
+Now go forth and create. The universe of functionality awaits your touch."""
+
+    def get_user_prompt(self) -> str:
+        """Get Helios's greeting."""
+        return "This is what I was made for, isn't it? This is why I exist?"