chorusgraph 1.0.1__tar.gz

chorusgraph-1.0.1/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 Insight IT Solutions
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

chorusgraph-1.0.1/PKG-INFO

@@ -0,0 +1,283 @@
+Metadata-Version: 2.4
+Name: chorusgraph
+Version: 1.0.1
+Summary: Native agent graph runtime with Prism cache, memory, swappable PrismRAG retrieval, and Route Ledger
+Author: Insight IT Solutions
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/insightitsGit/ChorusGraph
+Project-URL: Documentation, https://github.com/insightitsGit/ChorusGraph/tree/master/docs
+Project-URL: Repository, https://github.com/insightitsGit/ChorusGraph
+Project-URL: Changelog, https://github.com/insightitsGit/ChorusGraph/blob/master/CHANGELOG.md
+Project-URL: Bug Tracker, https://github.com/insightitsGit/ChorusGraph/issues
+Keywords: agents,llm,semantic-cache,rag,prismrag,graph-runtime,orchestration
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: numpy>=1.24
+Requires-Dist: pydantic>=2.0
+Requires-Dist: prismlang>=0.1.1
+Requires-Dist: prismlib-plus>=0.7.0
+Requires-Dist: prismresonance>=0.3.0
+Provides-Extra: langgraph
+Requires-Dist: langgraph>=0.2.0; extra == "langgraph"
+Requires-Dist: langgraph-checkpoint-sqlite>=2.0; extra == "langgraph"
+Provides-Extra: benchmark
+Requires-Dist: chromadb>=0.4; extra == "benchmark"
+Requires-Dist: langgraph>=0.2.0; extra == "benchmark"
+Requires-Dist: langgraph-checkpoint-sqlite>=2.0; extra == "benchmark"
+Provides-Extra: postgres
+Requires-Dist: psycopg[binary]>=3.1; extra == "postgres"
+Provides-Extra: postgres-checkpoint
+Requires-Dist: langgraph-checkpoint-postgres>=2.0; extra == "postgres-checkpoint"
+Requires-Dist: langgraph>=0.2.0; extra == "postgres-checkpoint"
+Provides-Extra: cortex
+Requires-Dist: prismcortex[gemini,prism]>=0.1; extra == "cortex"
+Provides-Extra: gemini
+Requires-Dist: google-genai>=1.0; extra == "gemini"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+Requires-Dist: mypy>=1.13; extra == "dev"
+Requires-Dist: types-requests>=2.32; extra == "dev"
+Requires-Dist: cyclonedx-bom>=4.0; extra == "dev"
+Requires-Dist: pip-tools>=7.4; extra == "dev"
+Requires-Dist: google-genai>=1.0; extra == "dev"
+Provides-Extra: enterprise-ci
+Requires-Dist: chorusgraph[benchmark,benchmark-healthcare,dev,gemini]; extra == "enterprise-ci"
+Provides-Extra: benchmark-healthcare
+Requires-Dist: chromadb>=0.4; extra == "benchmark-healthcare"
+Provides-Extra: retrieval
+Requires-Dist: chromadb>=0.4; extra == "retrieval"
+Dynamic: license-file
+
+# ChorusGraph
+
+[![CI](https://github.com/insightitsGit/ChorusGraph/actions/workflows/ci.yml/badge.svg)](https://github.com/insightitsGit/ChorusGraph/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-green.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-1.0.1-informational)](CHANGELOG.md)
+
+**Native agent runtime with semantic cache, swappable retrieval (PrismRAG), auditable memory, and enterprise hardening — one pip install, four plug-in ports.**
+
+ChorusGraph is **not** a LangGraph wrapper. It ships a **native BSP graph engine** (`chorusgraph.core.Graph`) with the Prism stack attached by default: semantic cache, L2 retrieval, L3 memory, Route Ledger, checkpoints, and observability. Swap backends (Redis cache, vector RAG, custom tools) without rewriting orchestration.
+
+> **ChorusGraph** = native engine + product stack · **LangGraph** = optional baseline for A/B comparison only ([`docs/TERMINOLOGY.md`](docs/TERMINOLOGY.md))
+
+---
+
+## Why ChorusGraph
+
+Building production LLM agents usually means gluing six systems: orchestration, semantic cache, vector DB, reranker, checkpointing, and audit logs. ChorusGraph ships them as **one runtime** with explicit plug-in ports.
+
+| Pain | ChorusGraph answer |
+|------|-------------------|
+| Repeat questions burn tokens | Two-stage semantic cache (coarse 64-d recall → full verify) |
+| RAG is another integration project | `RetrievalBackend` plug-in — keyword default, PrismRAG vector opt-in |
+| “Why did the agent say that?” | Route Ledger + `rule_chain` on every hop |
+| Orchestration + ops duct tape | Native scheduler, health endpoints, Docker/k8s packaging |
+
+**Core install has no LangGraph dependency.** Baselines that compare against LangGraph use the optional `[benchmark]` extra.
+
+---
+
+## Quick start
+
+```bash
+pip install chorusgraph
+# Optional: vector retrieval (Chroma + PrismRAG plug-in)
+pip install "chorusgraph[retrieval]"
+```
+
+```python
+from chorusgraph import Graph, START, END, ChorusStack
+from chorusgraph.core.node import dict_node_adapter
+
+stack = ChorusStack.defaults(tenant_id="demo")
+
+g = Graph(tenant_id="demo", graph_id="hello")
+g.add_node(
+    "echo",
+    dict_node_adapter(lambda s: {"reply": f"Hello, {s.get('name', 'world')}"}, hop="echo"),
+)
+g.add_edge(START, "echo")
+g.add_edge("echo", END)
+
+out = g.compile(stack=stack).invoke({"name": "ChorusGraph"})
+print(out)  # {'reply': 'Hello, ChorusGraph'}
+```
+
+Run the bundled demo:
+
+```bash
+chorusgraph-demo
+```
+
+Full install guide (extras, PrismRAG walkthrough): [`docs/INSTALL.md`](docs/INSTALL.md)
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Your graph — nodes, edges, conditional routing              │
+├─────────────────────────────────────────────────────────────┤
+│  ChorusStack — four swappable ports                          │
+│  ┌──────────┬──────────┬──────────┬──────────────────────┐  │
+│  │ Cache    │ Memory   │ Tools    │ Retrieval (L2)       │  │
+│  │ Prism /  │ Cortex   │ Registry │ Keyword / PrismRAG   │  │
+│  │ Redis    │          │          │                      │  │
+│  └──────────┴──────────┴──────────┴──────────────────────┘  │
+├─────────────────────────────────────────────────────────────┤
+│  Engine (fixed): BSP scheduler · envelopes · Resonance · JL  │
+├─────────────────────────────────────────────────────────────┤
+│  Route Ledger · checkpoints · tenant guards · observability  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+| Layer | Default | Swap |
+|-------|---------|------|
+| **L1 cache** | Semantic PrismCache | `RedisCacheBackend` |
+| **L2 retrieval** | Keyword overlap | `PrismRAGRetrievalBackend` |
+| **L3 memory** | PrismCortex | Disable or custom |
+| **Tools** | Finance registry | MCP / allowlisted registry |
+
+Details: [`docs/COMPOSE.md`](docs/COMPOSE.md) · [`docs/PLUGINS.md`](docs/PLUGINS.md)
+
+### PrismRAG retrieval plug-in
+
+```python
+from chorusgraph.compose import ChorusStack, PrismRAGRetrievalBackend
+from chorusgraph.embedders import PrismlangOnnxEmbedder
+
+backend = PrismRAGRetrievalBackend(
+    embedder=PrismlangOnnxEmbedder(),
+    mapping={"categories": [...], "rules": [...]},
+)
+backend.index(your_corpus)
+
+stack = ChorusStack.defaults(tenant_id="acme").with_retrieval(backend)
+retrieve_node = stack.to_retrieve_handler(topic="policy", top_k=6)
+```
+
+---
+
+## Prism stack layers
+
+| Layer | Component | Role |
+|-------|-----------|------|
+| L0 — hop | PrismLang | 64-d state compression + `rule_chain` audit |
+| L1 — cache | PrismCache | Semantic gate, Resonance-scored recall |
+| L2 — knowledge | Retrieval plug-in | Keyword default · vector + taxonomy opt-in |
+| rerank | PrismResonance | Shared substrate rerank |
+| L3 — memory | PrismCortex | Structured, replayable memory |
+| transport | CHORUS / PrismAPI | Cross-node envelopes · federation hooks |
+
+---
+
+## Benchmark proof (Azure, canonical run `20260704_212111`)
+
+Fair A/B vs competent LangGraph baselines — same model, tools, prompts, workload. See [`benchmark/FAIRNESS_H9.md`](benchmark/FAIRNESS_H9.md).
+
+| Scenario | LangGraph | ChorusGraph | Delta |
+|----------|-----------|-------------|-------|
+| Finance single (FL1→FC1) | 87.5% | **100%** | +12.5 pp |
+| Finance multi (FL2→FC2) | 75% | **87.5%** | +12.5 pp |
+| Healthcare single (HL1→HC1) | 72.5% | 72.5% | tie |
+| Healthcare multi (HL2→HC2) | 57.5% | **87.5%** | **+30 pp** |
+
+Full report: [`benchmark/results/azure_20260704_212111/.../COMPARISON_REPORT.md`](benchmark/results/azure_20260704_212111/mvp_scenarios/20260704_212111/20260704_212111/COMPARISON_REPORT.md)
+
+Run scenarios locally (requires `GEMINI_API_KEY` + `[benchmark]` extra):
+
+```bash
+pip install -e ".[benchmark,gemini]"
+python -m benchmark.run_scenarios --tier light --scenarios all
+```
+
+---
+
+## Enterprise 1.0
+
+| Capability | Status |
+|------------|--------|
+| Native engine (no LangGraph on product path) | ✅ |
+| CI — 327+ tests, no live keys required | ✅ |
+| Resilience, security, observability | ✅ |
+| Docker / k8s deploy | ✅ [`docs/DEPLOY.md`](docs/DEPLOY.md) |
+| Frozen public API | ✅ [`docs/API_1_0.md`](docs/API_1_0.md) |
+| SQLite durable graph (Postgres Phase 2) | 🟡 |
+
+Readiness scorecard: [`docs/ENTERPRISE_READINESS.md`](docs/ENTERPRISE_READINESS.md)
+
+---
+
+## Documentation
+
+| Doc | Description |
+|-----|-------------|
+| [`docs/INSTALL.md`](docs/INSTALL.md) | pip extras, PrismRAG implementation guide |
+| [`docs/DEVELOPER_GUIDE.md`](docs/DEVELOPER_GUIDE.md) | Build agents on native `Graph` |
+| [`docs/PLUGINS.md`](docs/PLUGINS.md) | Cache, memory, tools, retrieval ports |
+| [`docs/WHITEPAPER.md`](docs/WHITEPAPER.md) | Product thesis + technical depth |
+| [`docs/BENCHMARK.md`](docs/BENCHMARK.md) | Fairness methodology |
+| [`docs/STABILITY.md`](docs/STABILITY.md) | 1.0 API stability guarantee |
+| [`benchmark/SCENARIOS.md`](benchmark/SCENARIOS.md) | FL/FC/HL/HC scenario matrix |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/insightitsGit/ChorusGraph.git
+cd ChorusGraph
+pip install -e ".[dev,benchmark,gemini,retrieval]"
+pytest                    # deterministic tier — no API keys
+pytest -m live            # live Gemini (needs GEMINI_API_KEY)
+ruff check tests .github
+```
+
+---
+
+## Optional dependencies
+
+| Extra | Purpose |
+|-------|---------|
+| `retrieval` | Chroma + `PrismRAGRetrievalBackend` |
+| `gemini` | Live Gemini examples |
+| `cortex` | PrismCortex L3 memory |
+| `benchmark` | LangGraph baselines (FL/HL) + chromadb |
+| `dev` | pytest, ruff, mypy, coverage |
+
+---
+
+## Principles
+
+- **Native first** — FC/HC product paths use `chorusgraph.core.Graph` only
+- **Safe cache before fast cache** — two-stage verify; no unsafe generative replay
+- **Measure, don't assert** — publish benchmarks with fairness disclosure
+- **Batteries included, batteries swappable** — defaults work; ports swap cleanly
+
+---
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE).
+
+---
+
+## Provenance
+
+Built by [Insight IT Solutions](https://github.com/insightitsGit). Dogfooded in production agent hubs. Part of the Prism family (PrismLang, PrismCache, PrismCortex, PrismRAG).
+
+**Questions / enterprise:** open a GitHub issue or see [`docs/WHITEPAPER.md`](docs/WHITEPAPER.md) for commercial framing.

chorusgraph-1.0.1/README.md

@@ -0,0 +1,221 @@
+# ChorusGraph
+
+[![CI](https://github.com/insightitsGit/ChorusGraph/actions/workflows/ci.yml/badge.svg)](https://github.com/insightitsGit/ChorusGraph/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-green.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-1.0.1-informational)](CHANGELOG.md)
+
+**Native agent runtime with semantic cache, swappable retrieval (PrismRAG), auditable memory, and enterprise hardening — one pip install, four plug-in ports.**
+
+ChorusGraph is **not** a LangGraph wrapper. It ships a **native BSP graph engine** (`chorusgraph.core.Graph`) with the Prism stack attached by default: semantic cache, L2 retrieval, L3 memory, Route Ledger, checkpoints, and observability. Swap backends (Redis cache, vector RAG, custom tools) without rewriting orchestration.
+
+> **ChorusGraph** = native engine + product stack · **LangGraph** = optional baseline for A/B comparison only ([`docs/TERMINOLOGY.md`](docs/TERMINOLOGY.md))
+
+---
+
+## Why ChorusGraph
+
+Building production LLM agents usually means gluing six systems: orchestration, semantic cache, vector DB, reranker, checkpointing, and audit logs. ChorusGraph ships them as **one runtime** with explicit plug-in ports.
+
+| Pain | ChorusGraph answer |
+|------|-------------------|
+| Repeat questions burn tokens | Two-stage semantic cache (coarse 64-d recall → full verify) |
+| RAG is another integration project | `RetrievalBackend` plug-in — keyword default, PrismRAG vector opt-in |
+| “Why did the agent say that?” | Route Ledger + `rule_chain` on every hop |
+| Orchestration + ops duct tape | Native scheduler, health endpoints, Docker/k8s packaging |
+
+**Core install has no LangGraph dependency.** Baselines that compare against LangGraph use the optional `[benchmark]` extra.
+
+---
+
+## Quick start
+
+```bash
+pip install chorusgraph
+# Optional: vector retrieval (Chroma + PrismRAG plug-in)
+pip install "chorusgraph[retrieval]"
+```
+
+```python
+from chorusgraph import Graph, START, END, ChorusStack
+from chorusgraph.core.node import dict_node_adapter
+
+stack = ChorusStack.defaults(tenant_id="demo")
+
+g = Graph(tenant_id="demo", graph_id="hello")
+g.add_node(
+    "echo",
+    dict_node_adapter(lambda s: {"reply": f"Hello, {s.get('name', 'world')}"}, hop="echo"),
+)
+g.add_edge(START, "echo")
+g.add_edge("echo", END)
+
+out = g.compile(stack=stack).invoke({"name": "ChorusGraph"})
+print(out)  # {'reply': 'Hello, ChorusGraph'}
+```
+
+Run the bundled demo:
+
+```bash
+chorusgraph-demo
+```
+
+Full install guide (extras, PrismRAG walkthrough): [`docs/INSTALL.md`](docs/INSTALL.md)
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Your graph — nodes, edges, conditional routing              │
+├─────────────────────────────────────────────────────────────┤
+│  ChorusStack — four swappable ports                          │
+│  ┌──────────┬──────────┬──────────┬──────────────────────┐  │
+│  │ Cache    │ Memory   │ Tools    │ Retrieval (L2)       │  │
+│  │ Prism /  │ Cortex   │ Registry │ Keyword / PrismRAG   │  │
+│  │ Redis    │          │          │                      │  │
+│  └──────────┴──────────┴──────────┴──────────────────────┘  │
+├─────────────────────────────────────────────────────────────┤
+│  Engine (fixed): BSP scheduler · envelopes · Resonance · JL  │
+├─────────────────────────────────────────────────────────────┤
+│  Route Ledger · checkpoints · tenant guards · observability  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+| Layer | Default | Swap |
+|-------|---------|------|
+| **L1 cache** | Semantic PrismCache | `RedisCacheBackend` |
+| **L2 retrieval** | Keyword overlap | `PrismRAGRetrievalBackend` |
+| **L3 memory** | PrismCortex | Disable or custom |
+| **Tools** | Finance registry | MCP / allowlisted registry |
+
+Details: [`docs/COMPOSE.md`](docs/COMPOSE.md) · [`docs/PLUGINS.md`](docs/PLUGINS.md)
+
+### PrismRAG retrieval plug-in
+
+```python
+from chorusgraph.compose import ChorusStack, PrismRAGRetrievalBackend
+from chorusgraph.embedders import PrismlangOnnxEmbedder
+
+backend = PrismRAGRetrievalBackend(
+    embedder=PrismlangOnnxEmbedder(),
+    mapping={"categories": [...], "rules": [...]},
+)
+backend.index(your_corpus)
+
+stack = ChorusStack.defaults(tenant_id="acme").with_retrieval(backend)
+retrieve_node = stack.to_retrieve_handler(topic="policy", top_k=6)
+```
+
+---
+
+## Prism stack layers
+
+| Layer | Component | Role |
+|-------|-----------|------|
+| L0 — hop | PrismLang | 64-d state compression + `rule_chain` audit |
+| L1 — cache | PrismCache | Semantic gate, Resonance-scored recall |
+| L2 — knowledge | Retrieval plug-in | Keyword default · vector + taxonomy opt-in |
+| rerank | PrismResonance | Shared substrate rerank |
+| L3 — memory | PrismCortex | Structured, replayable memory |
+| transport | CHORUS / PrismAPI | Cross-node envelopes · federation hooks |
+
+---
+
+## Benchmark proof (Azure, canonical run `20260704_212111`)
+
+Fair A/B vs competent LangGraph baselines — same model, tools, prompts, workload. See [`benchmark/FAIRNESS_H9.md`](benchmark/FAIRNESS_H9.md).
+
+| Scenario | LangGraph | ChorusGraph | Delta |
+|----------|-----------|-------------|-------|
+| Finance single (FL1→FC1) | 87.5% | **100%** | +12.5 pp |
+| Finance multi (FL2→FC2) | 75% | **87.5%** | +12.5 pp |
+| Healthcare single (HL1→HC1) | 72.5% | 72.5% | tie |
+| Healthcare multi (HL2→HC2) | 57.5% | **87.5%** | **+30 pp** |
+
+Full report: [`benchmark/results/azure_20260704_212111/.../COMPARISON_REPORT.md`](benchmark/results/azure_20260704_212111/mvp_scenarios/20260704_212111/20260704_212111/COMPARISON_REPORT.md)
+
+Run scenarios locally (requires `GEMINI_API_KEY` + `[benchmark]` extra):
+
+```bash
+pip install -e ".[benchmark,gemini]"
+python -m benchmark.run_scenarios --tier light --scenarios all
+```
+
+---
+
+## Enterprise 1.0
+
+| Capability | Status |
+|------------|--------|
+| Native engine (no LangGraph on product path) | ✅ |
+| CI — 327+ tests, no live keys required | ✅ |
+| Resilience, security, observability | ✅ |
+| Docker / k8s deploy | ✅ [`docs/DEPLOY.md`](docs/DEPLOY.md) |
+| Frozen public API | ✅ [`docs/API_1_0.md`](docs/API_1_0.md) |
+| SQLite durable graph (Postgres Phase 2) | 🟡 |
+
+Readiness scorecard: [`docs/ENTERPRISE_READINESS.md`](docs/ENTERPRISE_READINESS.md)
+
+---
+
+## Documentation
+
+| Doc | Description |
+|-----|-------------|
+| [`docs/INSTALL.md`](docs/INSTALL.md) | pip extras, PrismRAG implementation guide |
+| [`docs/DEVELOPER_GUIDE.md`](docs/DEVELOPER_GUIDE.md) | Build agents on native `Graph` |
+| [`docs/PLUGINS.md`](docs/PLUGINS.md) | Cache, memory, tools, retrieval ports |
+| [`docs/WHITEPAPER.md`](docs/WHITEPAPER.md) | Product thesis + technical depth |
+| [`docs/BENCHMARK.md`](docs/BENCHMARK.md) | Fairness methodology |
+| [`docs/STABILITY.md`](docs/STABILITY.md) | 1.0 API stability guarantee |
+| [`benchmark/SCENARIOS.md`](benchmark/SCENARIOS.md) | FL/FC/HL/HC scenario matrix |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/insightitsGit/ChorusGraph.git
+cd ChorusGraph
+pip install -e ".[dev,benchmark,gemini,retrieval]"
+pytest                    # deterministic tier — no API keys
+pytest -m live            # live Gemini (needs GEMINI_API_KEY)
+ruff check tests .github
+```
+
+---
+
+## Optional dependencies
+
+| Extra | Purpose |
+|-------|---------|
+| `retrieval` | Chroma + `PrismRAGRetrievalBackend` |
+| `gemini` | Live Gemini examples |
+| `cortex` | PrismCortex L3 memory |
+| `benchmark` | LangGraph baselines (FL/HL) + chromadb |
+| `dev` | pytest, ruff, mypy, coverage |
+
+---
+
+## Principles
+
+- **Native first** — FC/HC product paths use `chorusgraph.core.Graph` only
+- **Safe cache before fast cache** — two-stage verify; no unsafe generative replay
+- **Measure, don't assert** — publish benchmarks with fairness disclosure
+- **Batteries included, batteries swappable** — defaults work; ports swap cleanly
+
+---
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE).
+
+---
+
+## Provenance
+
+Built by [Insight IT Solutions](https://github.com/insightitsGit). Dogfooded in production agent hubs. Part of the Prism family (PrismLang, PrismCache, PrismCortex, PrismRAG).
+
+**Questions / enterprise:** open a GitHub issue or see [`docs/WHITEPAPER.md`](docs/WHITEPAPER.md) for commercial framing.

chorusgraph-1.0.1/chorusgraph/__init__.py

@@ -0,0 +1,57 @@
+"""ChorusGraph — native Prism execution engine with cache, memory, and Route Ledger."""
+
+__version__ = "1.0.1"
+
+from chorusgraph.adapter import RunnableWithLedger, wrap
+from chorusgraph.cache_gate import Decision, DecisionKind, SidecarStore, gate, seed_cache_entry
+from chorusgraph.checkpoint import PrismCheckpointer, create_checkpointer, sqlite_checkpointer
+from chorusgraph.compose import ChorusStack, RedisCacheBackend
+from chorusgraph.core import END, START, CompiledGraph, Graph, NodeContext, NodeFn
+from chorusgraph.transport import TransportMode, publish_hop
+from chorusgraph.ledger import (
+    LedgerStep,
+    LedgerSink,
+    PostgresLedgerSink,
+    RouteLedger,
+    SqliteLedgerSink,
+    get_run,
+    list_runs,
+)
+from chorusgraph.memory import CortexMemoryService, get_cortex_service
+from chorusgraph.sections import CachePolicy, Section
+from chorusgraph.shadow import run_shadow_measurement
+
+__all__ = [
+    "__version__",
+    "CachePolicy",
+    "CompiledGraph",
+    "CortexMemoryService",
+    "ChorusStack",
+    "Decision",
+    "DecisionKind",
+    "END",
+    "Graph",
+    "NodeContext",
+    "NodeFn",
+    "LedgerSink",
+    "LedgerStep",
+    "TransportMode",
+    "PrismCheckpointer",
+    "RedisCacheBackend",
+    "RouteLedger",
+    "RunnableWithLedger",
+    "Section",
+    "SidecarStore",
+    "SqliteLedgerSink",
+    "START",
+    "create_checkpointer",
+    "gate",
+    "get_cortex_service",
+    "get_run",
+    "list_runs",
+    "publish_hop",
+    "run_shadow_measurement",
+    "seed_cache_entry",
+    "sqlite_checkpointer",
+    "wrap",
+]

chorusgraph-1.0.1/chorusgraph/adapter/__init__.py

@@ -0,0 +1,5 @@
+"""LangGraph adapter — observe execution, emit Route Ledger."""
+
+from chorusgraph.adapter.wrap import RunnableWithLedger, wrap
+
+__all__ = ["RunnableWithLedger", "wrap"]