Metadata-Version: 2.4
Name: coreason-workspace-env
Version: 0.1.10
Summary: Scalable, Async, Multi-Tenant LangGraph Platform
Author-email: "Gowtham A Rao, MD, PhD" <gowtham.rao@coreason.ai>
License: Prosperity 3.0
License-File: LICENSE
License-File: NOTICE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.14
Requires-Dist: alembic>=1.13.0
Requires-Dist: asyncpg>=0.31.0
Requires-Dist: cryptography>=44.0.0
Requires-Dist: deepagents-code>=0.1.0
Requires-Dist: dowhy>=0.11
Requires-Dist: e2b-code-interpreter>=1.0.0
Requires-Dist: fastapi>=0.100
Requires-Dist: fastmcp>=1.0.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: jsonpatch>=1.33
Requires-Dist: langgraph-checkpoint-postgres>=3.1.0
Requires-Dist: langgraph>=0.2.20
Requires-Dist: libcst>=1.8.6
Requires-Dist: networkx>=3.0
Requires-Dist: opentelemetry-api>=1.25.0
Requires-Dist: opentelemetry-exporter-otlp>=1.25.0
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.58b0
Requires-Dist: opentelemetry-sdk>=1.25.0
Requires-Dist: oras>=0.2.0
Requires-Dist: pandas>=2.0
Requires-Dist: prompt-toolkit>=3.0.52
Requires-Dist: psycopg-binary>=3.3.4
Requires-Dist: psycopg2-binary>=2.9.12
Requires-Dist: pyarrow>=14.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: rocrate>=0.9.0
Requires-Dist: structlog>=24.1.0
Requires-Dist: typer>=0.9.0
Requires-Dist: uvicorn>=0.20
Requires-Dist: websockets>=15.0.1
Description-Content-Type: text/markdown

# CoReason Workspace Environment

[![Python](https://img.shields.io/badge/Python-3.14-3776AB.svg?style=flat&logo=python&logoColor=white)](https://www.python.org)
[![License: Prosperity 3.0](https://img.shields.io/badge/License-Prosperity_3.0-blue.svg)](https://prosperitylicense.com/versions/3.0.0)
[![Build](https://img.shields.io/badge/Build-Passing-brightgreen.svg)]()
[![Coverage](https://img.shields.io/badge/Coverage-94%25-brightgreen.svg)]()
[![Powered By: AI](https://img.shields.io/badge/Powered%20By-CoReason%20AI-FF4500.svg)](https://coreason.ai)
<br>
[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
[![OpenSSF Scorecard](https://img.shields.io/ossf-scorecard/github.com/CoReason-AI/coreason-workspace-env?label=OpenSSF)](https://scorecard.dev/viewer/?uri=github.com/CoReason-AI/coreason-workspace-env)
[![TruffleHog](https://img.shields.io/github/actions/workflow/status/CoReason-AI/coreason-workspace-env/trufflehog.yml?branch=main&label=TruffleHog)](https://github.com/CoReason-AI/coreason-workspace-env/actions/workflows/trufflehog.yml)
[![Security: Bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)

**Tech Stack:**
[![DeepAgents](https://img.shields.io/badge/deepagents-%E2%9C%A8-blue)](https://github.com/langchain-ai/deepagents)
[![FastAPI](https://img.shields.io/badge/FastAPI-0.100+-009688?style=flat&logo=fastapi&logoColor=white)]()
[![MCP](https://img.shields.io/badge/MCP-Server-8A2BE2?style=flat)]()
[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-Checkpointer-4169E1?style=flat&logo=postgresql&logoColor=white)]()
[![ClickHouse](https://img.shields.io/badge/ClickHouse-OLAP-FFCC01?style=flat&logo=clickhouse&logoColor=black)]()
[![Redis](https://img.shields.io/badge/Redis-PubSub-DC382D?style=flat&logo=redis&logoColor=white)]()
[![Vault](https://img.shields.io/badge/HashiCorp_Vault-Secrets-000000?style=flat&logo=hashicorp-vault&logoColor=white)]()
[![Docker](https://img.shields.io/badge/Docker-Containers-2496ED?style=flat&logo=docker&logoColor=white)]()

**The Headless Agent Development Platform.**

`coreason-workspace-env` is a LangGraph DeepAgent-based, multi-user, project-oriented, opinionated platform where humans and AI agents collaborate to design, build, test, and deploy opinionated agentic platforms — each seamlessly deployable as MCP servers (Model Context Protocol).

## Documentation

Full documentation is built using MkDocs. 

**To view the documentation locally:**
```bash
uv sync --all-extras
uv run mkdocs serve
```

### Key Pillars
1. **[DeepAgent Pattern](docs/core_architecture.md#deepagent-pattern--declarative-manifests)**: YAML-driven progressive disclosure and structured eventing (Accordion UX).
2. **[Builder-Validator-Approver](docs/vignette_mangalore_news.md#4-delegation-and-the-builder-validator-approver-workflow)**: Strict separation of duties and deterministic artifact validation.
3. **[Epistemic Firewall](docs/core_architecture.md#the-epistemic-firewall-zero-trust-rag)**: Zero-trust knowledge retrieval and strict provenance tracking.
4. **[Interaction Surfaces](docs/interaction_surfaces.md)**: Complete parity across MCP, REST API, CLI, WebSocket (JSON Patch Streaming), and SDK.

## Maintenance & Rules

For guidelines on how AI agents must modify this repository, see `AGENTS.md`.

## Observability
We strictly use Langfuse for local LLM tracing via Harbor.
- **Linux/Mac**: Run `harbor up langfuse`.
- **Windows**: Harbor is built for WSL2. You can spin up the stack natively from PowerShell using our bridge script:
  ```powershell
  .\scripts\start_observability.ps1
  ```