Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 9 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,15 @@ composable Python framework and becomes a durable runtime designed for
production deployment. The existing Session-first Python API remains intact;
the release adds a production execution and operations layer around it.

<p align="center">
<img src="assets/readme/diagrams/v2-durable-runtime.png" alt="OpenRath v2.0.0 durable runtime overview" width="860" />
</p>

The diagram summarizes this production path: Python definitions compile into
immutable plans, durable Runs are governed by checkpoints, leases, effects, and
interrupts, and PostgreSQL, Redis, and S3-compatible storage provide the
operational data plane.

| Production concern | What OpenRath provides |
| --- | --- |
| Durable execution | Explicit `@step` / `@router` boundaries compile into immutable execution plans. Runs, Events, and Checkpoints survive process and worker restarts. |
Expand All @@ -70,22 +79,6 @@ the release adds a production execution and operations layer around it.
| Security and tenancy | Agent Server tokens carry explicit action grants; tenant/project scope, policy checks, secret references, trust labels, and audit remain separate boundaries. |
| Production operations | PostgreSQL is the durable source of truth, Redis can accelerate signaling, S3-compatible storage holds artifacts, and health, migration, telemetry, container, and Kubernetes references are included. |

```text
@step / @router
|
v
ExecutionPlan -> Run -> Event -> Checkpoint
| |
| +-> Interrupt / Effect Ledger
|
+-> PostgreSQL durable state
+-> optional Redis signals
+-> S3-compatible artifacts
|
v
Agent Server HTTP + SSE
```

Embedded mode remains useful inside a trusted process. Agent Server mode is the
strict production profile:

Expand Down
24 changes: 8 additions & 16 deletions README_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,14 @@ OpenRath v2.0.0 最重要的变化,是 OpenRath 从一个可组合的 Python
进入可部署、可恢复、可运维的生产环境。原有以 Session 为核心的 Python API
保持不变;这个版本在其外层增加了一套生产级执行与运维体系。

<p align="center">
<img src="assets/readme/diagrams/v2-durable-runtime.png" alt="OpenRath v2.0.0 持久化运行时概览" width="860" />
</p>

这张图概括了 OpenRath 的生产执行路径:Python 定义先编译为不可变执行计划,
持久化 Run 由 Checkpoint、Lease、Effect 与 Interrupt 共同保障,
PostgreSQL、Redis 和 S3 兼容存储则构成生产环境的数据与信号层。

| 生产环境关注点 | OpenRath 提供的能力 |
| --- | --- |
| 持久化执行 | 显式的 `@step` / `@router` 边界会编译成不可变执行计划;Run、Event 与 Checkpoint 能跨进程和 Worker 重启保留。 |
Expand All @@ -69,22 +77,6 @@ OpenRath v2.0.0 最重要的变化,是 OpenRath 从一个可组合的 Python
| 安全与租户隔离 | Agent Server Token 使用显式 Action Grant;Tenant/Project Scope、Policy、Secret Reference、Trust Label 与 Audit 保持为独立边界。 |
| 生产运维 | PostgreSQL 是持久化事实来源,Redis 可加速信号传递,S3 兼容存储保存 Artifact,并提供健康检查、迁移、遥测、容器与 Kubernetes 参考。 |

```text
@step / @router
|
v
ExecutionPlan -> Run -> Event -> Checkpoint
| |
| +-> Interrupt / Effect Ledger
|
+-> PostgreSQL 持久化状态
+-> 可选 Redis 信号
+-> S3 兼容 Artifact
|
v
Agent Server HTTP + SSE
```

Embedded mode 仍适合可信进程内部使用。Agent Server mode 是严格的生产
Profile:

Expand Down
Binary file added assets/readme/diagrams/v2-durable-runtime.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading