# OpenRath v2.0.0 Durable Runtime

This page documents the Stable OpenRath `v2.0.0` durable Runtime and Agent
Server.

OpenRath v2 adds a durable execution plane and a tenant-scoped Agent Server
while retaining the v1 Python façade.

```text
Workflow methods
  @step / @router
        |
        v
canonical ExecutionPlan + immutable revision
        |
        v
Run -> Event -> Checkpoint -> Interrupt / Effect ledger
        |
        +--> embedded SQLite profile
        +--> PostgreSQL + optional Redis + S3-compatible production profile
        |
        v
tenant/project-scoped Agent Server HTTP + SSE API
```

## What v2 adds

| Layer | v2.0.0 capability |
| --- | --- |
| Definition | Explicit `@step` and `@router` boundaries compile into canonical plans with revision identity. |
| Durable runtime | Runs, immutable events, per-step checkpoints, cancellation, deadlines, retry, leases, fencing, interrupts, and effect reconciliation. |
| Storage | SQLite for embedded validation; PostgreSQL for the production durable store; optional Redis signaling and S3-compatible artifacts. |
| Agent Server | Tenant/project-scoped HTTP and SSE resources with explicit action grants and bounded request, page, queue, and stream behavior. |
| Governed adapters | Provider, Tool/MCP, Sandbox, and Memory calls receive reduced context and policy decisions. |
| Operations | OpenTelemetry hooks, migration tooling, Compose/Kubernetes references, SBOM, scans, and deployment tooling. |

## Choose a path

| Goal | Start here |
| --- | --- |
| Install the release asset and run one durable workflow locally | [Quickstart](quickstart.md) |
| Expose a workflow through HTTP/SSE and call it from Python | [Agent Server and Remote Client](agent-server.md) |
| Store outputs, evaluate revisions, and emit correlated telemetry | [Evaluation, Observability, and Artifacts](evaluation-observability-artifacts.md) |
| Understand production storage, rollout, and incidents | [Operations](operations.md) |
| Import v1 JSONL Sessions safely | [v1 → v2 migration](migration.md) |
| Review stability, authorization, and deprecation rules | [API and maintenance policy](api-policy.md) |
| Understand the security architecture and deployment controls | [Threat model](threat-model.md) |
| Look up the v2 Python surface | [v2 API reference](api-reference.md) |
| Inspect the Agent Server contract | [OpenAPI document](https://github.com/Rath-Team/OpenRath/blob/v2.0.0/deploy/docs/openapi-v2.json) |

## Compatibility and deployment

- The v1 Python façade remains supported in v2.0.0.
- The Agent Server exposes versioned `/v1` HTTP and SSE resources.
- v1 JSONL Sessions can be imported into the v2 history model.
- The embedded profile uses SQLite for local workflows.
- The service profile uses PostgreSQL with optional Redis signaling and
  S3-compatible artifact storage.
- The [operations guide](operations.md) covers rollout, backup, recovery, and
  incident workflows.

The exact release statement and downloadable artifacts are on the
[OpenRath v2.0.0 release page](https://github.com/Rath-Team/OpenRath/releases/tag/v2.0.0).

```{toctree}
---
maxdepth: 1
caption: OpenRath v2
---

quickstart
agent-server
evaluation-observability-artifacts
api-reference
operations
migration
api-policy
threat-model
```