snipara-sandbox 2.2.0__tar.gz

snipara_sandbox-2.2.0/.env.example

@@ -0,0 +1,134 @@
+# Environment Variables Template
+
+# Copy this file to .env and fill in your values
+
+# ==============================================================================
+# Core Configuration
+# ==============================================================================
+
+# LLM Backend: litellm, openai, anthropic
+# RLM_BACKEND=litellm
+
+# Model identifier (e.g., gpt-4o-mini, claude-3-sonnet-20240229)
+# RLM_MODEL=gpt-4o-mini
+
+# Temperature: 0.0-2.0 (lower = more deterministic)
+# RLM_TEMPERATURE=0.0
+
+# API Key (or use provider-specific env vars like OPENAI_API_KEY)
+# RLM_API_KEY=
+
+# ==============================================================================
+# Execution Environment
+# ==============================================================================
+
+# Environment: local, docker, wasm
+# RLM_ENVIRONMENT=local
+
+# ==============================================================================
+# Resource Limits
+# ==============================================================================
+
+# Maximum recursion depth
+# RLM_MAX_DEPTH=4
+
+# Maximum tool calls per completion
+# RLM_MAX_SUBCALLS=12
+
+# Token budget per completion
+# RLM_TOKEN_BUDGET=8000
+
+# Maximum tool calls budget
+# RLM_TOOL_BUDGET=20
+
+# Timeout in seconds
+# RLM_TIMEOUT_SECONDS=120
+
+# ==============================================================================
+# Parallel Execution
+# ==============================================================================
+
+# Enable parallel tool execution
+# RLM_PARALLEL_TOOLS=false
+
+# Maximum concurrent tool executions
+# RLM_MAX_PARALLEL=5
+
+# ==============================================================================
+# Docker Configuration (when RLM_ENVIRONMENT=docker)
+# ==============================================================================
+
+# Docker image to use
+# RLM_DOCKER_IMAGE=python:3.11-slim
+
+# CPU limit (e.g., 1.0, 2.0)
+# RLM_DOCKER_CPUS=1.0
+
+# Memory limit (e.g., 512m, 1g, 2g)
+# RLM_DOCKER_MEMORY=512m
+
+# Disable network access (recommended: true)
+# RLM_DOCKER_NETWORK_DISABLED=true
+
+# Docker exec timeout
+# RLM_DOCKER_TIMEOUT=30
+
+# ==============================================================================
+# Logging Configuration
+# ==============================================================================
+
+# Log directory
+# RLM_LOG_DIR=./logs
+
+# Verbose output
+# RLM_VERBOSE=false
+
+# Log level: DEBUG, INFO, WARNING, ERROR
+# RLM_LOG_LEVEL=INFO
+
+# ==============================================================================
+# Security Configuration
+# ==============================================================================
+
+# Allowed file paths (comma-separated, empty = current directory only)
+# RLM_ALLOWED_PATHS=
+
+# ==============================================================================
+# Snipara Configuration (Optional but Recommended)
+# ==============================================================================
+
+# Snipara API key (get from https://snipara.com/dashboard)
+# SNIPARA_API_KEY=
+
+# Snipara project slug
+# SNIPARA_PROJECT_SLUG=
+
+# Snipara base URL (default: https://api.snipara.com/mcp)
+# SNIPARA_BASE_URL=https://api.snipara.com/mcp
+
+# Enable memory tools (Tier 2: rlm_remember, rlm_recall, etc.)
+# RLM_MEMORY_ENABLED=false
+
+# ==============================================================================
+# Provider-Specific API Keys (Optional)
+# ==============================================================================
+
+# OpenAI
+# OPENAI_API_KEY=
+
+# Anthropic
+# ANTHROPIC_API_KEY=
+
+# Google Vertex AI
+# GOOGLE_API_KEY=
+# GOOGLE_APPLICATION_CREDENTIALS=
+
+# AWS Bedrock
+# AWS_ACCESS_KEY_ID=
+# AWS_SECRET_ACCESS_KEY=
+# AWS_REGION_NAME=us-east-1
+
+# Azure OpenAI
+# AZURE_API_KEY=
+# AZURE_API_BASE=
+# AZURE_API_VERSION=2023-05-15

snipara_sandbox-2.2.0/.gitignore

@@ -0,0 +1,90 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.env.local
+.venv
+env/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# Logs
+logs/
+*.log
+
+# Local config
+rlm.toml
+.rlm/
+.mcp.json
+
+# Docker
+.docker/
+
+# OS
+.DS_Store
+Thumbs.db

snipara_sandbox-2.2.0/.pre-commit-config.yaml

@@ -0,0 +1,32 @@
+# Pre-commit hooks for rlm-runtime
+# Install: pip install pre-commit && pre-commit install
+# Manual run: pre-commit run --all-files
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.2
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [--fix]
+      # Run the formatter
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+
+  - repo: local
+    hooks:
+      - id: pytest-quick
+        name: pytest (quick smoke test)
+        entry: pytest tests/unit/ -x -q --no-cov
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-push]  # Only run on push, not every commit

snipara_sandbox-2.2.0/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [2.2.0] - 2026-05-11
+
+### Changed
+
+- Renamed the published Python distribution to `snipara-sandbox`.
+- Added the `snipara-sandbox` CLI while keeping `rlm` as a legacy command alias.
+- Added the `snipara_sandbox` Python import surface while keeping `rlm` imports compatible.
+- Renamed public MCP server identity and agent tools to Snipara-first names, with legacy `rlm_*` aliases retained.
+- Switched generated API key examples to the `snp-` prefix.
+- Updated documentation, install scripts, and package metadata for the `Snipara/snipara-sandbox` repository.
+
+## [2.1.3] - 2026-04-29
+
+### Added
+
+- `snipara-sandbox config show` for inspecting the effective runtime configuration.
+- `--json` output for `snipara-sandbox config show`.
+
+### Changed
+
+- Added documentation links for the config inspection command in the README and configuration guide.
+- Bumped the package version to `2.1.3` for release.
+
+## [2.1.2] - 2026-04-29
+
+### Fixed
+
+- `rlm --version` now works from the root CLI entrypoint.
+- CLI version output now reflects the source version and the installed package version when they differ.
+- Project `.env` files are loaded automatically by the CLI and config loader, so `snipara-sandbox doctor` and `snipara-sandbox run` no longer depend on manual `source .env`.
+- Failed runs now return non-zero exit codes instead of reporting `success: true`.
+- CLI JSON mode now emits clean JSON without debug logs mixed into stdout.
+- `--max-depth 0` is rejected immediately with a clear error.
+
+### Changed
+
+- Added explicit failure propagation to `RLMResult`.
+- Added tests covering CLI version handling, `.env` loading, JSON output, and max-depth validation.
+- Documented the confirmed bugs, fixes, and remaining notes in `docs/snipara-sandbox-audit-2026-04-29.md`.
+
+### Notes
+
+- `--max-depth 1` is still a tight setting and may fail on prompts that need at least one extra recursive or tool step.
+- The repository's GitHub release workflow attempted trusted publishing, but PyPI rejected the repo as an invalid trusted publisher. The `2.1.2` package was published successfully with the existing local PyPI token fallback.

snipara_sandbox-2.2.0/CONTRIBUTING.md

@@ -0,0 +1,310 @@
+# Contributing to Snipara Sandbox
+
+Thank you for your interest in contributing to Snipara Sandbox! This document provides guidelines and information for contributors.
+
+## Code of Conduct
+
+By participating in this project, you agree to maintain a respectful and inclusive environment for everyone.
+
+## Getting Started
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/Snipara/snipara-sandbox
+cd snipara-sandbox
+
+# Create a virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install development dependencies
+pip install -e ".[dev]"
+
+# Verify setup
+snipara-sandbox doctor
+pytest
+```
+
+### Project Structure
+
+```
+snipara-sandbox/
+├── src/rlm/
+│   ├── backends/       # LLM backend adapters
+│   ├── cli/            # Command-line interface
+│   ├── core/           # Core orchestrator and types
+│   ├── logging/        # Trajectory logging
+│   ├── mcp/            # MCP server for Claude
+│   ├── repl/           # REPL environments (local, docker, wasm)
+│   ├── tools/          # Builtin tools and registry
+│   └── visualizer/     # Trajectory visualizer
+├── tests/              # Test suite
+├── docs/               # Documentation
+└── examples/           # Example scripts
+```
+
+## Development Workflow
+
+### 1. Create a Branch
+
+```bash
+git checkout -b feature/your-feature-name
+# or
+git checkout -b fix/your-bug-fix
+```
+
+### 2. Make Changes
+
+Follow these guidelines:
+
+- Write clear, readable code
+- Add type hints to all functions
+- Include docstrings for public APIs
+- Update tests for new functionality
+- Update documentation as needed
+
+### 3. Run Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=rlm --cov-report=html
+
+# Run specific tests
+pytest tests/unit/test_repl_local.py
+
+# Run tests matching a pattern
+pytest -k "test_execute"
+```
+
+### 4. Lint and Format
+
+```bash
+# Check linting
+ruff check src/
+
+# Auto-fix issues
+ruff check --fix src/
+
+# Check formatting
+ruff format --check src/
+
+# Auto-format
+ruff format src/
+
+# Type checking
+mypy src/
+```
+
+### 5. Commit Changes
+
+Write clear commit messages:
+
+```bash
+# Good commit messages
+git commit -m "Add WebAssembly REPL using Pyodide"
+git commit -m "Fix token counting in recursive completion"
+git commit -m "Update configuration documentation"
+
+# Bad commit messages
+git commit -m "Fix stuff"
+git commit -m "WIP"
+```
+
+### 6. Submit Pull Request
+
+1. Push your branch to GitHub
+2. Open a Pull Request against `master`
+3. Fill out the PR template
+4. Wait for CI checks to pass
+5. Request review
+
+## Coding Standards
+
+### Python Style
+
+We follow PEP 8 with these additions:
+
+- Line length: 100 characters
+- Use type hints everywhere
+- Use `from __future__ import annotations` for forward references
+
+```python
+from __future__ import annotations
+
+def process_data(
+    items: list[str],
+    options: dict[str, Any] | None = None,
+) -> ProcessResult:
+    """Process a list of items.
+
+    Args:
+        items: List of items to process
+        options: Optional processing options
+
+    Returns:
+        ProcessResult with the processed data
+
+    Raises:
+        ValueError: If items is empty
+    """
+    if not items:
+        raise ValueError("Items cannot be empty")
+    ...
+```
+
+### Documentation Style
+
+Use Google-style docstrings:
+
+```python
+def example_function(param1: str, param2: int = 10) -> dict[str, Any]:
+    """Short description of the function.
+
+    Longer description if needed. Can span multiple lines
+    and include examples.
+
+    Args:
+        param1: Description of param1
+        param2: Description of param2
+
+    Returns:
+        Description of return value
+
+    Raises:
+        ValueError: When param1 is invalid
+
+    Example:
+        ```python
+        result = example_function("test", 20)
+        print(result)
+        ```
+    """
+```
+
+### Testing Standards
+
+- Write tests for all new functionality
+- Use descriptive test names
+- Use fixtures for common setup
+- Test both success and error cases
+
+```python
+import pytest
+from snipara_sandbox.repl.local import LocalREPL
+
+@pytest.fixture
+def repl():
+    return LocalREPL(timeout=30)
+
+@pytest.mark.asyncio
+async def test_execute_simple_code(repl):
+    """Test executing simple Python code."""
+    result = await repl.execute("print(2 + 2)")
+    assert result.output.strip() == "4"
+    assert result.error is None
+
+@pytest.mark.asyncio
+async def test_execute_with_syntax_error(repl):
+    """Test that syntax errors are handled properly."""
+    result = await repl.execute("print(")
+    assert result.error is not None
+    assert "SyntaxError" in result.error
+```
+
+## Priority Areas
+
+We welcome contributions in these areas:
+
+### High Priority
+
+1. **Test Coverage** - Help us reach 90%+ coverage
+2. **Documentation** - Improve guides and examples
+3. **Bug Fixes** - Fix reported issues
+
+### Medium Priority
+
+4. **WebAssembly REPL** - Improve Pyodide integration
+5. **New Tools** - Create useful community tools
+6. **Performance** - Optimize token usage and latency
+
+### Low Priority
+
+7. **New Backends** - Add support for more LLM providers
+8. **Observability** - Add metrics and tracing
+
+## Reporting Issues
+
+### Bug Reports
+
+Include:
+- Python version
+- Snipara Sandbox version (`snipara-sandbox version`)
+- Steps to reproduce
+- Expected vs actual behavior
+- Error messages/logs
+
+### Feature Requests
+
+Include:
+- Use case description
+- Proposed solution
+- Alternatives considered
+
+## Pull Request Guidelines
+
+### PR Title Format
+
+```
+type: short description
+
+Examples:
+feat: add streaming support for completions
+fix: handle empty response from LLM
+docs: update configuration guide
+test: add tests for Docker REPL
+refactor: simplify tool registry
+```
+
+### PR Description Template
+
+```markdown
+## Summary
+Brief description of changes
+
+## Changes
+- List of specific changes
+- Another change
+
+## Testing
+How was this tested?
+
+## Checklist
+- [ ] Tests pass locally
+- [ ] Linting passes
+- [ ] Documentation updated
+- [ ] Type hints added
+```
+
+## Release Process
+
+Releases are managed by maintainers:
+
+1. Update version in `pyproject.toml`
+2. Update CHANGELOG.md
+3. Create GitHub release
+4. CI automatically publishes to PyPI
+
+## Getting Help
+
+- **Questions**: Open a GitHub Discussion
+- **Bugs**: Open a GitHub Issue
+- **Security**: Email security@snipara.com
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the Apache 2.0 License.