文档
03 平台03 运行时05_过程

RT-05-001 Runtime 首批实现证据

独立仓库、制品边界、中性PG会话与Job、17项实库验证及尚未覆盖的范围

记录日期:2026-10-15。按用户授权建立私有仓库 Oceanway-AI/oceanway-runtime,本机位置runtime/oceanway-runtime。首批代码提交为be5d732d932848681dc7b121050dd68a633026d5,PR #1用于审查实现计划PR-01~03的本机子集;代码尚未接入Studio或生产。

本页固定首批历史实现事实、测试证据与边界;后续Artifact/ResultSink与Agent循环增量见本轮实现证据。工作包与GO状态仍只在开发清单登记;后续顺序以实现计划为准。

已实现的代码边界

代码本批实际内容
packages/clientoceanway.runtime.v1合同、状态、公开结果与错误;独立制品,无PG/执行器/凭据依赖。薄HTTP SDK尚未实现
packages/serverPostgreSQL repository、迁移、指纹、Context/Planner/Platform/Media/Asset/ResultSink端口;不导入Studio、Next路由或产品bootstrap
会话与运行Session/Thread/Message/AgentRun、冻结surface/profile/toolset/context快照、clientRunId幂等、单Thread活跃Run与冲突读回
独立任务Job可不关联Session、Thread或AgentRun;Job/Attempt、数据库时钟租约、fence、持久结果与终态保护
命令与事件幂等stop回执;取消尚未领取Job,保留在途Job。按scope事务顺序分配游标,重连可从原cursor恢复
兼容基础保留Studio旧指纹算法和固定向量;legacy映射唯一且不可变,Run/Job仅能映射终态。尚未接实际Studio legacy-reader

新数据仅写oceanway_runtime独立schema,无外键依赖Studio Conversation、creator资料或产品表。所有repository读写按subject/callerScope/product隔离;scope必须由可信宿主鉴权后注入,数据键本身不授予模型或资金操作。

租约过期只证明执行权丢失,Job转为UNKNOWN且不能再领取,旧fence不能完成或续租。当前只支持未知状态回读;正式原Operation恢复适配器仍需后续交接。不能把围栏理解为供应端已实现exactly-once。

已执行的本机验证

环境:macOS arm64、Node 24.6.0、pnpm 11.9.0、TypeScript 5.9.3、PostgreSQL 18.4。每次实库测试创建随机独立数据库与无superuser/createdb/createrole权限账号,结束清理本次资源;未读取产品数据库或.env。

门禁实际结果
build / typecheck / format两个包构建、类型及格式检查通过
模块与client制品边界源码依赖、package manifest和dist检查通过,无产品反向依赖或客户端数据库栈
独立宿主两个tarball在临时非Studio宿主安装;JS加载、严格TS及无Node全局的浏览器合同编译通过,不靠源码alias或工作区链接
旧指纹1项单测、5个固定向量通过;保留旧序列化字节口径,新repository拒绝不合法JSON
真实PostgreSQL17项通过,0跳过,覆盖下列故障与并发子集
依赖审计pnpm audit --audit-level=high通过,未报告已知漏洞

PG子集覆盖:并发迁移;重复提交;同ID不同意图与活跃Run冲突;跨subject/caller/product拒绝;终态CAS;无Agent父对象的direct Job;双Worker及旧fence;过期转UNKNOWN不重排;停止与在途分离;重连读回消息/Run/Job输出/回执/事件;legacy不可执行;非法输入;命令异意图冲突;DB不可变保护;异步前快照捕获;未提交事件的游标顺序;迁移checksum不兼容拒绝。

执行入口为RUNTIME_TEST_ADMIN_URL=<显式loopback /postgres fixture管理连接> pnpm verify,缺少实库即失败。CI在隔离PostgreSQL 18服务重复门禁,push验证与PR验证均成功,后续结果直接查看PR checks。fixture不会调用模型、供应生成POST或Platform资金写入。

固定证据在Runtime仓docs/verification/:source-baseline.json记录来源与已有dirty文件SHA,writer-inventory.md记录旧表/约束/Writer/原恢复路径,foundation-inputs.json固定33个代码、测试和构建输入的SHA,foundation.md记录执行结果。Studio已有57个、文档站已有14个未提交文件按原SHA保留;Platform源码未修改。

生产与后续范围

本首批快照不含Artifact/AssetPort保存、ResultSink和实际Agent循环。后续PR-04免费产物/候选纵切及PR-06串行Agent子集已另行实现,见增量证据;薄SDK/Panel、Studio真实Runtime消费、完整Workflow、真实LLM及独立API/Worker仍待交付,不据历史Job工具结果冒充这些能力。

Platform纯媒体Run v2只形成docs/platform-run-v2.md设计草案,已核对create/resume/retry、text门禁、预检事务和UNKNOWN/原账务限制;没有修改Go/OpenAPI或启用新callerScope。实际模型授权、资金与原供应结果仍归Platform,Runtime不引入钱包或Run预算。

本机来源为Studio c621a2024ca0c73fafc4144882b75b9f942dd4d5加既有工作树、Platform aa67267a3ea8970d837e6eda83e5aac6d0ffa3d7、文档站cde66b7aa757e2e7b71207c510deefd8dae33d85加既有工作树。线上镜像/配置、生产未终态/UNKNOWN/待保存、实际DDL漂移、备份恢复未在本批实时核验;不以本机HEAD或fixture替代。

当前回退为不加载新包、不启用新分区;没有生产数据迁移需要回放。旧Studio队列、原Operation及恢复器保持原Writer。正式产品启用、原任务接管及独立部署继续遵守迁移门禁,收费供应验证另行取得对应授权。

On this page