diff --git a/README.md b/README.md index a4dd876..83ad6c4 100644 --- a/README.md +++ b/README.md @@ -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. +

+ OpenRath v2.0.0 durable runtime overview +

+ +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. | @@ -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: diff --git a/README_zh.md b/README_zh.md index a6195ef..5e42b89 100644 --- a/README_zh.md +++ b/README_zh.md @@ -60,6 +60,14 @@ OpenRath v2.0.0 最重要的变化,是 OpenRath 从一个可组合的 Python 进入可部署、可恢复、可运维的生产环境。原有以 Session 为核心的 Python API 保持不变;这个版本在其外层增加了一套生产级执行与运维体系。 +

+ OpenRath v2.0.0 持久化运行时概览 +

+ +这张图概括了 OpenRath 的生产执行路径:Python 定义先编译为不可变执行计划, +持久化 Run 由 Checkpoint、Lease、Effect 与 Interrupt 共同保障, +PostgreSQL、Redis 和 S3 兼容存储则构成生产环境的数据与信号层。 + | 生产环境关注点 | OpenRath 提供的能力 | | --- | --- | | 持久化执行 | 显式的 `@step` / `@router` 边界会编译成不可变执行计划;Run、Event 与 Checkpoint 能跨进程和 Worker 重启保留。 | @@ -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: diff --git a/assets/readme/diagrams/v2-durable-runtime.png b/assets/readme/diagrams/v2-durable-runtime.png new file mode 100644 index 0000000..1d5c2a3 Binary files /dev/null and b/assets/readme/diagrams/v2-durable-runtime.png differ