sumospace 0.1.0__tar.gz

sumospace-0.1.0/.gitignore

@@ -0,0 +1,74 @@
+# Build
+dist/
+build/
+*.egg-info/
+.eggs/
+pyproject.toml.bak
+
+# SumoSpace runtime
+.sumo_db/
+.sumo_audit/
+.sumo_desktop_db/
+.sumo_image_db/
+.sumo_finance_db/
+.sumo_cache/
+.sumo_secrets/
+examples/sumofinance
+*.jsonl
+*.log
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+develop-eggs/
+downloads/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environments
+.venv/
+venv/
+ENV/
+env/
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.project
+.pydevproject
+.settings/
+
+# Coverage / Testing
+.coverage
+htmlcov/
+coverage.xml
+.pytest_cache/
+.tox/
+.nox/
+nosetests.xml
+coverage.xml
+*.cover
+.stack-work/
+
+# OS
+.DS_Store
+Thumbs.db

sumospace-0.1.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.5.0] - 2026-05-02
+
+### Added
+- **Real-Time Streaming**: Added `kernel.stream_run()` to yield execution progress step-by-step, ideal for rendering UI updates without blocking until the end of the task.
+- **Execution Plan Caching**: Repeated tasks with identical contexts now bypass the committee deliberation phase, resulting in near-instant execution starts and significantly lower token usage.
+- **Multi-User Isolation**: Added `ScopeManager` to strictly isolate RAG context, audit logs, and memory between users (`user_id`), sessions (`session_id`), or projects (`project_id`).
+- **Telemetry Support**: Full OpenTelemetry (OTLP) tracing added for latency profiling. Enable via `SUMO_TELEMETRY_ENABLED=true`.
+- **Intelligent Context Truncation**: When codebase size exceeds token limits, the kernel now predictably sacrifices raw RAG results before discarding your core task instructions or recent memory.
+
+### Fixed
+- **Provider Reliability**: If your primary LLM provider (e.g. OpenAI) times out or hits rate limits (429/503), the kernel now gracefully falls back to a pre-initialized secondary provider (e.g. local HuggingFace) mid-run.
+- **Malformed Plan Recovery**: Local models occasionally output invalid JSON. The Committee now uses a 3-attempt retry loop with dynamic temperature bumping to self-correct formatting errors.
+- **Concurrency Deadlocks**: Fixed race conditions and file lock contention in `AuditLogger` and `MemoryManager` when running multiple concurrent kernels.
+- **Token Estimation Accuracy**: Fixed token estimation logic to prevent unexpected context window overflow crashes during large retrievals.
+- **Memory Leaks**: Proper cleanup of resources during `kernel.shutdown()`.
+
+### Changed
+- The `kernel.run()` method signature was updated to guarantee the return of a standard `ExecutionTrace`, safely capturing critical errors (`ConsensusFailedError`, `ExecutionHaltedError`) rather than throwing raw exceptions to your application.
+- Renamed CLI audit subcommands and their `AuditLogger` counterparts for exact 1:1 mapping (e.g., `sumo logs list` now calls `audit.list()`).
+- Deprecated `KernelConfig` in favor of the unified `SumoSettings`.
+
+### Security
+- Added robust path traversal safeguards to `ScopeManager` to prevent cross-tenant data leaks.
+- Added dependency isolation to `UniversalIngestor` to prevent arbitrary code execution during codebase parsing.

sumospace-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing to SumoSpace
+
+Thank you for investing your time in contributing to our project!
+
+## Architecture Overview
+SumoSpace is built around an autonomous, deliberative agent architecture:
+- **Classifier**: Determines if a task requires web search or codebase RAG.
+- **Committee**: A 3-agent group (Planner, Critic, Resolver) that agrees on a safe execution plan before taking action.
+- **Kernel**: The main orchestrator that manages lifecycles, memory, scopes, and tools.
+
+## Development Setup
+1. Clone the repository: `git clone https://github.com/omdeepb69/sumospace.git`
+2. Create a virtual environment: `python -m venv venv && source venv/bin/activate`
+3. Install dependencies: `pip install -e ".[dev]"`
+4. Run tests: `pytest`
+
+## Adding a New Provider
+
+To add support for a new LLM provider (e.g. Cohere, Groq):
+1. Subclass `BaseProvider` in `sumospace/providers.py`.
+2. Implement `initialize()`, `complete()`, and `stream()`.
+3. Register your provider in the `PROVIDERS` dict at the top of `providers.py` with a string key (e.g., `"cohere"`).
+4. Add any required optional dependencies to `pyproject.toml` (e.g., `cohere = ["cohere>=5.0.0"]`).
+5. Add settings fields to `SumoSettings` in `sumospace/settings.py` using the `SUMO_` prefix (e.g., `SUMO_COHERE_API_KEY`).
+6. Add a test in `tests/test_providers.py` using the mock pattern from existing tests to verify your implementation without hitting real APIs.
+7. Document the addition in `CHANGELOG.md` under the `### Added` section.
+
+## Adding a New Tool
+
+To give the agent new capabilities (e.g. interacting with Jira or AWS):
+1. Subclass `BaseTool` in `sumospace/tools.py`.
+2. Define the tool's `name`, `description`, `schema`, and `tags` as class attributes.
+3. Implement `async def run(self, **kwargs) -> ToolResult`. Ensure you gracefully catch errors and return `ToolResult(success=False, error=str(e))`.
+4. Register the tool in `ToolRegistry._register_defaults()` in `sumospace/tools.py`.
+5. Add a test in `tests/test_tools.py`.
+
+## Submitting Pull Requests
+- Ensure all new features have accompanying unit/integration tests.
+- Run `pytest` to verify nothing is broken.
+- Provide a clear, descriptive PR title and summary.

sumospace-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Omdeep Borkar
+
+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.