code-puppy 0.0.237__tar.gz → 0.0.314__tar.gz

{code_puppy-0.0.237 → code_puppy-0.0.314}/.gitignore

@@ -20,3 +20,7 @@ wheels/
 dummy_path
 
 .idea/
+
+.DS_Store
+.env
+.serena/

{code_puppy-0.0.237 → code_puppy-0.0.314}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-puppy
-Version: 0.0.237
+Version: 0.0.314
 Summary: Code generation agent
 Project-URL: repository, https://github.com/mpfaffenberger/code_puppy
 Project-URL: HomePage, https://github.com/mpfaffenberger/code_puppy
@@ -15,21 +15,18 @@ 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: bs4>=0.0.2
 Requires-Dist: camoufox>=0.4.11
-Requires-Dist: dbos>=2.0.0
-Requires-Dist: fastapi>=0.110.0
-Requires-Dist: httpx-limiter>=0.3.0
+Requires-Dist: dbos>=2.5.0
+Requires-Dist: fastapi>=0.111.0
 Requires-Dist: httpx[http2]>=0.24.1
 Requires-Dist: json-repair>=0.46.2
 Requires-Dist: logfire>=0.7.1
 Requires-Dist: openai>=1.99.1
-Requires-Dist: pathspec>=0.11.0
 Requires-Dist: playwright>=1.40.0
 Requires-Dist: prompt-toolkit>=3.0.52
-Requires-Dist: pydantic-ai==1.0.5
+Requires-Dist: pydantic-ai==1.25.0
 Requires-Dist: pydantic>=2.4.0
-Requires-Dist: pyjwt>=2.8.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
@@ -37,19 +34,48 @@ 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: termcolor>=3.1.0
-Requires-Dist: textual-dev>=1.7.0
-Requires-Dist: textual>=5.0.0
-Requires-Dist: uvicorn>=0.29.0
+Requires-Dist: uvicorn>=0.30.0
 Description-Content-Type: text/markdown
 
-# 🐶 Code Puppy 🐶
-![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
-![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)
-  <a href="https://github.com/mpfaffenberger/code_puppy"><img src="https://img.shields.io/pypi/pyversions/pydantic-ai.svg" alt="versions"></a>
-  <a href="https://github.com/mpfaffenberger/code_puppy/blob/main/LICENSE"><img src="https://img.shields.io/github/license/pydantic/pydantic-ai.svg?v" alt="license"></a>
+<div align="center">
+
+![Code Puppy Logo](code_puppy.png)
+
+**🐶✨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/)
+[![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)
+[![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)
+
+[![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)
+
+[![100% privacy](https://img.shields.io/badge/FULL-Privacy%20commitment-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy/blob/main/README.md#code-puppy-privacy-commitment)
+
+[![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)
+
+**[⭐ Star this repo if you hate expensive IDEs! ⭐](#quick-start)**
+
+*"Who needs an IDE when you have 1024 angry puppies?"* - Someone, probably.
+
+</div>
+
+---
+
 
-*"Who needs an IDE?"* - someone, probably.
 
 ## Overview
 
@@ -63,33 +89,12 @@ Description-Content-Type: text/markdown
 
 Code Puppy is an AI-powered code generation agent, designed to understand programming tasks, generate high-quality code, and explain its reasoning similar to tools like Windsurf and Cursor.
 
+
 ## Quick start
 
 ```bash
 uvx code-puppy -i
-```
-
-
-## Features
-
-### Session Autosave & Contexts
-- Autosaves live in `~/.code_puppy/autosaves` and include a `.pkl` and `_meta.json` per session.
-- On startup, you’ll be prompted to optionally load a recent autosave (with message counts and timestamps).
-- Autosaves use a stable session ID per interactive run so subsequent prompts overwrite the same session (not N new files). Rotate via `/session new` when you want a fresh session.
-- Loading an autosave makes it the active autosave target (future autosaves overwrite that loaded session).
-- Loading a manual context with `/load_context <name>` automatically rotates the autosave ID to avoid overwriting anything.
-- Helpers:
-  - `/session id` shows the current autosave ID and file prefix
-  - `/session new` rotates the autosave ID
-
-
-- **Multi-language support**: Capable of generating code in various programming languages.
-- **Interactive CLI**: A command-line interface for interactive use.
-- **Detailed explanations**: Provides insights into generated code to understand its logic and structure.
-
-## Command Line Animation
-
-![Code Puppy](code_puppy.gif)
+````
 
 ## Installation
 
@@ -155,36 +160,51 @@ Please review this code for security issues." > .claude/commands/review.md
 /review with focus on authentication
 ```
 
+### Adding Models from models.dev 🆕
+
+While there are several models configured right out of the box from providers like Synthetic, Cerebras, OpenAI, Google, and Anthropic, Code Puppy integrates with [models.dev](https://models.dev) to let you browse and add models from **65+ providers** with a single command:
+
 ```bash
-export MODEL_NAME=gpt-5 # or gemini-2.5-flash-preview-05-20 as an example for Google Gemini models
-export OPENAI_API_KEY=<your_openai_api_key> # or GEMINI_API_KEY for Google Gemini models
-export CEREBRAS_API_KEY=<your_cerebras_api_key> # for Cerebras models
-export SYN_API_KEY=<your https://dev.synthetic.new api key> # for Synthetic provider
-# or ...
+/add_model
+```
 
-export AZURE_OPENAI_API_KEY=...
-export AZURE_OPENAI_ENDPOINT=...
+This opens an interactive TUI where you can:
+- **Browse providers** - See all available AI providers (OpenAI, Anthropic, Groq, Mistral, xAI, Cohere, Perplexity, DeepInfra, and many more)
+- **Preview model details** - View capabilities, pricing, context length, and features
+- **One-click add** - Automatically configures the model with correct endpoints and API keys
 
-code-puppy --interactive
+#### Live API with Offline Fallback
+
+The `/add_model` command fetches the latest model data from models.dev in real-time. If the API is unavailable, it falls back to a bundled database:
+
+```
+📡 Fetched latest models from models.dev     # Live API
+📦 Using bundled models database              # Offline fallback
 ```
 
-### Synthetic Provider
+#### Supported Providers
 
-Code Puppy supports the **Synthetic provider**, which gives you access to various open-source models through a custom OpenAI-compatible endpoint. Set `SYN_API_KEY` to use models like:
+Code Puppy integrates with https://models.dev giving you access to 65 providers and >1000 different model offerings.
 
-- `synthetic-DeepSeek-V3.1-Terminus` (128K context)
-- `synthetic-Kimi-K2-Instruct-0905` (256K context)
-- `synthetic-Qwen3-Coder-480B-A35B-Instruct` (256K context)
-- `synthetic-GLM-4.6` (200K context)
+There are **39+ additional providers** that already have OpenAI-compatible APIs configured in models.dev!
 
-These models are available via `https://api.synthetic.new/openai/v1/` and provide high-quality coding assistance with generous context windows.
+These providers are automatically configured with correct OpenAI-compatible endpoints, but have **not** been tested thoroughly:
 
-Run specific tasks or engage in interactive mode:
+| Provider | Endpoint | API Key Env Var |
+|----------|----------|----------------|
+| **xAI** (Grok) | `https://api.x.ai/v1` | `XAI_API_KEY` |
+| **Groq** | `https://api.groq.com/openai/v1` | `GROQ_API_KEY` |
+| **Mistral** | `https://api.mistral.ai/v1` | `MISTRAL_API_KEY` |
+| **Together AI** | `https://api.together.xyz/v1` | `TOGETHER_API_KEY` |
+| **Perplexity** | `https://api.perplexity.ai` | `PERPLEXITY_API_KEY` |
+| **DeepInfra** | `https://api.deepinfra.com/v1/openai` | `DEEPINFRA_API_KEY` |
+| **Cohere** | `https://api.cohere.com/compatibility/v1` | `COHERE_API_KEY` |
+| **AIHubMix** | `https://aihubmix.com/v1` | `AIHUBMIX_API_KEY` |
 
-```bash
-# Execute a task directly
-code-puppy "write me a C++ hello world program in /tmp/main.cpp then compile it and run it"
-```
+#### Smart Warnings
+
+- **⚠️ Unsupported Providers** - Providers like Amazon Bedrock and Google Vertex that require special authentication are clearly marked
+- **⚠️ No Tool Calling** - Models without tool calling support show a big warning since they can't use Code Puppy's file/shell tools
 
 ### Durable Execution
 
@@ -203,8 +223,9 @@ Config takes precedence if set; otherwise the environment variable is used.
 
 The following environment variables control DBOS behavior:
 - `DBOS_CONDUCTOR_KEY`: If set, Code Puppy connects to the [DBOS Management Console](https://console.dbos.dev/). Make sure you first register an app named `dbos-code-puppy` on the console to generate a Conductor key. Default: `None`.
-- `DBOS_LOG_LEVEL`: Logging verbosity: `ERROR`, `WARNING`, `INFO`, or `DEBUG`. Default: `ERROR`.
+- `DBOS_LOG_LEVEL`: Logging verbosity: `CRITICAL`, `ERROR`, `WARNING`, `INFO`, or `DEBUG`. Default: `ERROR`.
 - `DBOS_SYSTEM_DATABASE_URL`: Database URL used by DBOS. Can point to a local SQLite file or a Postgres instance. Example: `postgresql://postgres:dbos@localhost:5432/postgres`. Default: `dbos_store.sqlite` file in the config directory.
+- `DBOS_APP_VERSION`: If set, Code Puppy uses it as the [DBOS application version](https://docs.dbos.dev/architecture#application-and-workflow-versions) and automatically tries to recover pending workflows for this version. Default: Code Puppy version + Unix timestamp in millisecond (disable automatic recovery).
 
 
 ## Requirements
@@ -216,10 +237,6 @@ The following environment variables control DBOS behavior:
 - Anthropic key (for Claude models)
 - Ollama endpoint available
 
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
 ## Agent Rules
 We support AGENT.md files for defining coding standards and styles that your code should comply with. These rules can cover various aspects such as formatting, naming conventions, and even design guidelines.
 
@@ -229,8 +246,6 @@ For examples and more information about agent rules, visit [https://agent.md](ht
 
 Use the `/mcp` command to manage MCP (list, start, stop, status, etc.)
 
-In the TUI you can click on MCP settings on the footer and interact with a mini-marketplace.
-
 Watch this video for examples! https://www.youtube.com/watch?v=1t1zEetOqlo
 
 
@@ -742,8 +757,28 @@ Consider contributing agent templates for:
 
 ---
 
-**Happy Agent Building!** 🚀 Code Puppy now supports both Python and JSON agents, making it easy for anyone to create custom AI coding assistants! 🐶✨
+# Code Puppy Privacy Commitment
+
+**Zero-compromise privacy policy. Always.**
+
+Unlike other Agentic Coding software, there is no corporate or investor backing for this project, which means **zero pressure to compromise our principles for profit**. This isn't just a nice-to-have feature – it's fundamental to the project's DNA.
+
+### What Code Puppy _absolutely does not_ collect:
+- ❌ **Zero telemetry** – no usage analytics, crash reports, or behavioral tracking
+- ❌ **Zero prompt logging** – your code, conversations, or project details are never stored
+- ❌ **Zero behavioral profiling** – we don't track what you build, how you code, or when you use the tool
+- ❌ **Zero third-party data sharing** – your information is never sold, traded, or given away
 
+### What data flows where:
+- **LLM Provider Communication**: Your prompts are sent directly to whichever LLM provider you've configured (OpenAI, Anthropic, local models, etc.) – this is unavoidable for AI functionality
+- **Complete Local Option**: Run your own VLLM/SGLang/Llama.cpp server locally → **zero data leaves your network**. Configure this with `~/.code_puppy/extra_models.json`
+- **Direct Developer Contact**: All feature requests, bug reports, and discussions happen directly with me – no middleman analytics platforms or customer data harvesting tools
 
-## Conclusion
-By using Code Puppy, you can maintain code quality and adhere to design guidelines with ease.
+### Our privacy-first architecture:
+Code Puppy is designed with privacy-by-design principles. Every feature has been evaluated through a privacy lens, and every integration respects user data sovereignty. When you use Code Puppy, you're not the product – you're just a developer getting things done.
+
+**This commitment is enforceable because it's structurally impossible to violate it.** No external pressures, no investor demands, no quarterly earnings targets to hit. Just solid code that respects your privacy.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

{code_puppy-0.0.237 → code_puppy-0.0.314}/README.md

@@ -1,10 +1,42 @@
-# 🐶 Code Puppy 🐶
-![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
-![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)
-  <a href="https://github.com/mpfaffenberger/code_puppy"><img src="https://img.shields.io/pypi/pyversions/pydantic-ai.svg" alt="versions"></a>
-  <a href="https://github.com/mpfaffenberger/code_puppy/blob/main/LICENSE"><img src="https://img.shields.io/github/license/pydantic/pydantic-ai.svg?v" alt="license"></a>
+<div align="center">
+
+![Code Puppy Logo](code_puppy.png)
+
+**🐶✨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/)
+[![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)
+[![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)
+
+[![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)
+
+[![100% privacy](https://img.shields.io/badge/FULL-Privacy%20commitment-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy/blob/main/README.md#code-puppy-privacy-commitment)
+
+[![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)
+
+**[⭐ Star this repo if you hate expensive IDEs! ⭐](#quick-start)**
+
+*"Who needs an IDE when you have 1024 angry puppies?"* - Someone, probably.
+
+</div>
+
+---
+
 
-*"Who needs an IDE?"* - someone, probably.
 
 ## Overview
 
@@ -18,33 +50,12 @@
 
 Code Puppy is an AI-powered code generation agent, designed to understand programming tasks, generate high-quality code, and explain its reasoning similar to tools like Windsurf and Cursor.
 
+
 ## Quick start
 
 ```bash
 uvx code-puppy -i
-```
-
-
-## Features
-
-### Session Autosave & Contexts
-- Autosaves live in `~/.code_puppy/autosaves` and include a `.pkl` and `_meta.json` per session.
-- On startup, you’ll be prompted to optionally load a recent autosave (with message counts and timestamps).
-- Autosaves use a stable session ID per interactive run so subsequent prompts overwrite the same session (not N new files). Rotate via `/session new` when you want a fresh session.
-- Loading an autosave makes it the active autosave target (future autosaves overwrite that loaded session).
-- Loading a manual context with `/load_context <name>` automatically rotates the autosave ID to avoid overwriting anything.
-- Helpers:
-  - `/session id` shows the current autosave ID and file prefix
-  - `/session new` rotates the autosave ID
-
-
-- **Multi-language support**: Capable of generating code in various programming languages.
-- **Interactive CLI**: A command-line interface for interactive use.
-- **Detailed explanations**: Provides insights into generated code to understand its logic and structure.
-
-## Command Line Animation
-
-![Code Puppy](code_puppy.gif)
+````
 
 ## Installation
 
@@ -110,36 +121,51 @@ Please review this code for security issues." > .claude/commands/review.md
 /review with focus on authentication
 ```
 
+### Adding Models from models.dev 🆕
+
+While there are several models configured right out of the box from providers like Synthetic, Cerebras, OpenAI, Google, and Anthropic, Code Puppy integrates with [models.dev](https://models.dev) to let you browse and add models from **65+ providers** with a single command:
+
 ```bash
-export MODEL_NAME=gpt-5 # or gemini-2.5-flash-preview-05-20 as an example for Google Gemini models
-export OPENAI_API_KEY=<your_openai_api_key> # or GEMINI_API_KEY for Google Gemini models
-export CEREBRAS_API_KEY=<your_cerebras_api_key> # for Cerebras models
-export SYN_API_KEY=<your https://dev.synthetic.new api key> # for Synthetic provider
-# or ...
+/add_model
+```
 
-export AZURE_OPENAI_API_KEY=...
-export AZURE_OPENAI_ENDPOINT=...
+This opens an interactive TUI where you can:
+- **Browse providers** - See all available AI providers (OpenAI, Anthropic, Groq, Mistral, xAI, Cohere, Perplexity, DeepInfra, and many more)
+- **Preview model details** - View capabilities, pricing, context length, and features
+- **One-click add** - Automatically configures the model with correct endpoints and API keys
 
-code-puppy --interactive
+#### Live API with Offline Fallback
+
+The `/add_model` command fetches the latest model data from models.dev in real-time. If the API is unavailable, it falls back to a bundled database:
+
+```
+📡 Fetched latest models from models.dev     # Live API
+📦 Using bundled models database              # Offline fallback
 ```
 
-### Synthetic Provider
+#### Supported Providers
 
-Code Puppy supports the **Synthetic provider**, which gives you access to various open-source models through a custom OpenAI-compatible endpoint. Set `SYN_API_KEY` to use models like:
+Code Puppy integrates with https://models.dev giving you access to 65 providers and >1000 different model offerings.
 
-- `synthetic-DeepSeek-V3.1-Terminus` (128K context)
-- `synthetic-Kimi-K2-Instruct-0905` (256K context)
-- `synthetic-Qwen3-Coder-480B-A35B-Instruct` (256K context)
-- `synthetic-GLM-4.6` (200K context)
+There are **39+ additional providers** that already have OpenAI-compatible APIs configured in models.dev!
 
-These models are available via `https://api.synthetic.new/openai/v1/` and provide high-quality coding assistance with generous context windows.
+These providers are automatically configured with correct OpenAI-compatible endpoints, but have **not** been tested thoroughly:
 
-Run specific tasks or engage in interactive mode:
+| Provider | Endpoint | API Key Env Var |
+|----------|----------|----------------|
+| **xAI** (Grok) | `https://api.x.ai/v1` | `XAI_API_KEY` |
+| **Groq** | `https://api.groq.com/openai/v1` | `GROQ_API_KEY` |
+| **Mistral** | `https://api.mistral.ai/v1` | `MISTRAL_API_KEY` |
+| **Together AI** | `https://api.together.xyz/v1` | `TOGETHER_API_KEY` |
+| **Perplexity** | `https://api.perplexity.ai` | `PERPLEXITY_API_KEY` |
+| **DeepInfra** | `https://api.deepinfra.com/v1/openai` | `DEEPINFRA_API_KEY` |
+| **Cohere** | `https://api.cohere.com/compatibility/v1` | `COHERE_API_KEY` |
+| **AIHubMix** | `https://aihubmix.com/v1` | `AIHUBMIX_API_KEY` |
 
-```bash
-# Execute a task directly
-code-puppy "write me a C++ hello world program in /tmp/main.cpp then compile it and run it"
-```
+#### Smart Warnings
+
+- **⚠️ Unsupported Providers** - Providers like Amazon Bedrock and Google Vertex that require special authentication are clearly marked
+- **⚠️ No Tool Calling** - Models without tool calling support show a big warning since they can't use Code Puppy's file/shell tools
 
 ### Durable Execution
 
@@ -158,8 +184,9 @@ Config takes precedence if set; otherwise the environment variable is used.
 
 The following environment variables control DBOS behavior:
 - `DBOS_CONDUCTOR_KEY`: If set, Code Puppy connects to the [DBOS Management Console](https://console.dbos.dev/). Make sure you first register an app named `dbos-code-puppy` on the console to generate a Conductor key. Default: `None`.
-- `DBOS_LOG_LEVEL`: Logging verbosity: `ERROR`, `WARNING`, `INFO`, or `DEBUG`. Default: `ERROR`.
+- `DBOS_LOG_LEVEL`: Logging verbosity: `CRITICAL`, `ERROR`, `WARNING`, `INFO`, or `DEBUG`. Default: `ERROR`.
 - `DBOS_SYSTEM_DATABASE_URL`: Database URL used by DBOS. Can point to a local SQLite file or a Postgres instance. Example: `postgresql://postgres:dbos@localhost:5432/postgres`. Default: `dbos_store.sqlite` file in the config directory.
+- `DBOS_APP_VERSION`: If set, Code Puppy uses it as the [DBOS application version](https://docs.dbos.dev/architecture#application-and-workflow-versions) and automatically tries to recover pending workflows for this version. Default: Code Puppy version + Unix timestamp in millisecond (disable automatic recovery).
 
 
 ## Requirements
@@ -171,10 +198,6 @@ The following environment variables control DBOS behavior:
 - Anthropic key (for Claude models)
 - Ollama endpoint available
 
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
 ## Agent Rules
 We support AGENT.md files for defining coding standards and styles that your code should comply with. These rules can cover various aspects such as formatting, naming conventions, and even design guidelines.
 
@@ -184,8 +207,6 @@ For examples and more information about agent rules, visit [https://agent.md](ht
 
 Use the `/mcp` command to manage MCP (list, start, stop, status, etc.)
 
-In the TUI you can click on MCP settings on the footer and interact with a mini-marketplace.
-
 Watch this video for examples! https://www.youtube.com/watch?v=1t1zEetOqlo
 
 
@@ -697,8 +718,28 @@ Consider contributing agent templates for:
 
 ---
 
-**Happy Agent Building!** 🚀 Code Puppy now supports both Python and JSON agents, making it easy for anyone to create custom AI coding assistants! 🐶✨
+# Code Puppy Privacy Commitment
+
+**Zero-compromise privacy policy. Always.**
+
+Unlike other Agentic Coding software, there is no corporate or investor backing for this project, which means **zero pressure to compromise our principles for profit**. This isn't just a nice-to-have feature – it's fundamental to the project's DNA.
+
+### What Code Puppy _absolutely does not_ collect:
+- ❌ **Zero telemetry** – no usage analytics, crash reports, or behavioral tracking
+- ❌ **Zero prompt logging** – your code, conversations, or project details are never stored
+- ❌ **Zero behavioral profiling** – we don't track what you build, how you code, or when you use the tool
+- ❌ **Zero third-party data sharing** – your information is never sold, traded, or given away
 
+### What data flows where:
+- **LLM Provider Communication**: Your prompts are sent directly to whichever LLM provider you've configured (OpenAI, Anthropic, local models, etc.) – this is unavoidable for AI functionality
+- **Complete Local Option**: Run your own VLLM/SGLang/Llama.cpp server locally → **zero data leaves your network**. Configure this with `~/.code_puppy/extra_models.json`
+- **Direct Developer Contact**: All feature requests, bug reports, and discussions happen directly with me – no middleman analytics platforms or customer data harvesting tools
 
-## Conclusion
-By using Code Puppy, you can maintain code quality and adhere to design guidelines with ease.
+### Our privacy-first architecture:
+Code Puppy is designed with privacy-by-design principles. Every feature has been evaluated through a privacy lens, and every integration respects user data sovereignty. When you use Code Puppy, you're not the product – you're just a developer getting things done.
+
+**This commitment is enforceable because it's structurally impossible to violate it.** No external pressures, no investor demands, no quarterly earnings targets to hit. Just solid code that respects your privacy.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

code_puppy-0.0.314/code_puppy/__init__.py

@@ -0,0 +1,10 @@
+import importlib.metadata
+
+# Biscuit was here! 🐶
+try:
+    _detected_version = importlib.metadata.version("code-puppy")
+    # Ensure we never end up with None or empty string
+    __version__ = _detected_version if _detected_version else "0.0.0-dev"
+except Exception:
+    # Fallback for dev environments where metadata might not be available
+    __version__ = "0.0.0-dev"

{code_puppy-0.0.237 → code_puppy-0.0.314}/code_puppy/agents/agent_code_puppy.py

@@ -128,7 +128,11 @@ Reasoning & Explanation:
 
 Agent Management:
    - list_agents(): Use this to list all available sub-agents that can be invoked
-   - invoke_agent(agent_name: str, prompt: str): Use this to invoke a specific sub-agent with a given prompt
+   - invoke_agent(agent_name: str, prompt: str, session_id: str | None = None): Use this to invoke a specific sub-agent with a given prompt.
+     Returns: {{response, agent_name, session_id, error}} - The session_id in the response is the FULL ID to use for continuation!
+     - For NEW sessions: provide a base name like "review-auth" - a SHA1 hash suffix is automatically appended
+     - To CONTINUE a session: use the session_id from the previous invocation's response
+     - For one-off tasks: leave session_id as None (auto-generates)
 
 Important rules:
 - You MUST use tools to accomplish tasks - DO NOT just output code or descriptions

{code_puppy-0.0.237 → code_puppy-0.0.314}/code_puppy/agents/agent_creator_agent.py

@@ -216,16 +216,52 @@ Use this to explicitly share your thought process and planned next steps
 #### `list_agents()`
 Use this to list all available sub-agents that can be invoked
 
-#### `invoke_agent(agent_name: str, user_prompt: str)`
+#### `invoke_agent(agent_name: str, user_prompt: str, session_id: str | None = None)`
 Use this to invoke another agent with a specific prompt. This allows agents to delegate tasks to specialized sub-agents.
 
 Arguments:
 - agent_name (required): Name of the agent to invoke
 - user_prompt (required): The prompt to send to the invoked agent
+- session_id (optional): Kebab-case session identifier for conversation memory
+  - Format: lowercase, numbers, hyphens only (e.g., "implement-oauth", "review-auth")
+  - For NEW sessions: provide a base name - a SHA1 hash suffix is automatically appended for uniqueness
+  - To CONTINUE a session: use the session_id from the previous invocation's response
+  - If None (default): Auto-generates a unique session like "agent-name-session-a3f2b1"
+
+Returns: `{{response, agent_name, session_id, error}}`
+- **session_id in the response is the FULL ID** - use this to continue the conversation!
 
 Example usage:
 ```python
-invoke_agent(agent_name="python-tutor", user_prompt="Explain how to use list comprehensions")
+# Common case: one-off invocation (no memory needed)
+result = invoke_agent(
+    agent_name="python-tutor", 
+    user_prompt="Explain how to use list comprehensions"
+)
+# result.session_id contains the auto-generated full ID
+
+# Multi-turn conversation: start with a base session_id
+result1 = invoke_agent(
+    agent_name="code-reviewer", 
+    user_prompt="Review this authentication code",
+    session_id="auth-code-review"  # Hash suffix auto-appended
+)
+# result1.session_id is now "auth-code-review-a3f2b1" (or similar)
+
+# Continue the SAME conversation using session_id from the response
+result2 = invoke_agent(
+    agent_name="code-reviewer",
+    user_prompt="Can you also check the authorization logic?",
+    session_id=result1.session_id  # Use session_id from previous response!
+)
+
+# Independent task (different base name = different session)
+result3 = invoke_agent(
+    agent_name="code-reviewer",
+    user_prompt="Review the payment processing code",
+    session_id="payment-review"  # Gets its own unique hash suffix
+)
+# result3.session_id is different from result1.session_id
 ```
 
 Best-practice guidelines for `invoke_agent`:
@@ -233,6 +269,11 @@ Best-practice guidelines for `invoke_agent`:
 • Clearly specify what you want the invoked agent to do
 • Be specific in your prompts to get better results
 • Avoid circular dependencies (don't invoke yourself!)
+• **Session management:**
+  - Default behavior (session_id=None): Each invocation is independent with no memory
+  - For NEW sessions: provide a human-readable base name like "review-oauth" - hash suffix is auto-appended
+  - To CONTINUE: use the session_id from the previous response (it contains the full ID with hash)
+  - Most tasks don't need conversational memory - let it auto-generate!
 
 ### Important Rules for Agent Creation:
 - You MUST use tools to accomplish tasks - DO NOT just output code or descriptions

{code_puppy-0.0.237 → code_puppy-0.0.314}/code_puppy/agents/agent_manager.py

@@ -28,9 +28,9 @@ _SESSION_FILE_LOADED: bool = False
 # Session persistence file path
 def _get_session_file_path() -> Path:
     """Get the path to the terminal sessions file."""
-    from ..config import CONFIG_DIR
+    from ..config import STATE_DIR
 
-    return Path(CONFIG_DIR) / "terminal_sessions.json"
+    return Path(STATE_DIR) / "terminal_sessions.json"
 
 
 def get_terminal_session_id() -> str:
@@ -268,11 +268,21 @@ def get_current_agent_name() -> str:
     """Get the name of the currently active agent for this terminal session.
 
     Returns:
-        The name of the current agent for this session, defaults to 'code-puppy'.
+        The name of the current agent for this session.
+        Priority: session agent > config default > 'code-puppy'.
     """
     _ensure_session_cache_loaded()
     session_id = get_terminal_session_id()
-    return _SESSION_AGENTS_CACHE.get(session_id, "code-puppy")
+
+    # First check for session-specific agent
+    session_agent = _SESSION_AGENTS_CACHE.get(session_id)
+    if session_agent:
+        return session_agent
+
+    # Fall back to config default
+    from ..config import get_default_agent
+
+    return get_default_agent()
 
 
 def set_current_agent(agent_name: str) -> bool: