HEAVEN Tree REPL
Hierarchical Embodied Autonomously Validating Evolution Network Tree REPL - A modular tree navigation system with persistent state, pathway recording, and agent management capabilities.
Features
- Geometric Tree Navigation: Navigate through hierarchical structures using coordinate-based addressing (0.1.2.3)
- Live Variable Persistence: Session variables persist throughout navigation and execution
- Pathway Recording & Templates: Record navigation sequences and convert them to reusable templates
- RSI Analysis: Pattern recognition, crystallization, and optimization insights
- Agent Management: Support for both user-level and agent-level tree shells with approval workflows
- Modular Architecture: Clean separation of concerns with mixin-based design
Installation
pip install heaven-tree-repl
Quick Start
from heaven_tree_repl import TreeShell
# Create a basic tree configuration
config = {
"app_id": "my_app",
"domain": "example",
"role": "assistant",
"nodes": {
"root": {
"type": "Menu",
"prompt": "Main Menu",
"description": "Root menu",
"options": {
"1": "math_ops"
}
},
"math_ops": {
"type": "Callable",
"prompt": "Math Operations",
"description": "Perform mathematical operations",
"function_name": "_test_add",
"args_schema": {"a": "int", "b": "int"}
}
}
}
# Initialize TreeShell
shell = TreeShell(config)
# Navigate and execute
response = shell.handle_command("1") # Navigate to math_ops
response = shell.handle_command('1 {"a": 5, "b": 3}') # Execute with args
Architecture
The system is built using a modular mixin architecture:
- TreeShellBase: Core navigation and state management
- MetaOperationsMixin: Variable management and session operations
- PathwayManagementMixin: Recording, saving, and template analysis
- CommandHandlersMixin: Navigation and interaction commands
- RSIAnalysisMixin: Pattern recognition and crystallization
- ExecutionEngineMixin: Core action execution
- AgentManagementMixin: Agent and user tree repl classes
Agent Support
The system supports both user-level and agent-level interactions:
from heaven_tree_repl import UserTreeShell, AgentTreeShell
# User shell with approval capabilities
user_shell = UserTreeShell()
# Agent shell with quarantine restrictions
agent_shell = AgentTreeShell(config, session_id="agent_001",
approval_callback=user_shell._receive_agent_approval_request)
Development Roadmap
See docs/DEVELOPMENT_ROADMAP.md for the complete phased development plan:
- Phase 1: Prompt Engineering Agent Prototype (Current)
- Phase 2: General Adaptor Layer
- Phase 3: Universal Agent App Generator
- Phase 4: Game Mechanics Integration
- Phase 5: Enhanced Base Library
- Phase 6: Advanced Integrations (MCP, Full HEAVEN)
Future game mechanics specifications are in docs/future_implementations/.
Development
# Clone the repository
git clone https://github.com/yourusername/heaven-tree-repl.git
cd heaven-tree-repl
# Install in development mode
pip install -e .[dev]
# Run tests
pytest
License
MIT License - see LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.# Domain chain system implemented
1 maintainer
Metadata
1 maintainer
Release files for heaven-tree-repl 0.1.38
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| heaven_tree_repl-0.1.38.tar.gz | 179.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| heaven_tree_repl-0.1.38-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 323.8 kB
Release files / heaven_tree_repl-0.1.38.tar.gz
| Download URL | heaven_tree_repl-0.1.38.tar.gz |
|---|---|
| Size | 179.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9104e2c26a6a685d6aba36abaf3b7db5c987dc250f1d094196bb65c23b10a198
|
|
BLAKE2b-256 checksum How to use checksums |
a8c53e2c40e7d8b372b968772f2455a4a0155a113b2e9e0efb344f6d07289e52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.6
|
Release files / heaven_tree_repl-0.1.38-py3-none-any.whl
| Download URL | heaven_tree_repl-0.1.38-py3-none-any.whl |
|---|---|
| Size | 144.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d4ed050a0e4a35f3ed922722e6bcee77bcc76b826656cb0eb1d5902b4211e3e9
|
|
BLAKE2b-256 checksum How to use checksums |
0a8768469f4dd048e1d3fa7b63e7f4820b313b00341572ed227f13c361baa744
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.6
|
Security for heaven-tree-repl 0.1.38
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
