RT-04-001 薄 SDK 与首期宿主接入
客户端、可信宿主、固定串行流程和 Studio 双入口的边界
本页说明 WP-RT-001的代码消费边界。公开类型与方法以固定版本 packages/client 为机器真源，本页不另建可执行 OpenAPI。实现与发布证据分别见 PROC-02-005。
客户端与可信宿主
createRuntimeClient 组合读与命令：历史/消息分页、原 Run/Job、稳定 clientRequestId 查询/提交、stop/resume/steer、人工回答及事件。createRuntimeHttpTransport 由宿主显式传入路由、会话/CSRF 策略和响应适配，没有默认 Studio 地址；未提供的能力返回 unsupported_operation。
SDK 不接受自报 subject/scope 作为授权，不携带数据库、repository、Planner、Worker 或供应 Key。可信宿主构造实际主体，核验产品/对象、上下文版本、原 Run 与 Platform 授权后调用 Runtime。泛型类型不构成脱敏边界，Host 必须投影白名单公开 DTO；领域采纳与候选归属由产品接收器决定。
提交前保存请求 ID；丢回执先查同一 ID，重试沿原身份/意图。网络失败不自动换 ID 或写入。人工决定保留原 command、revision 与 plan fingerprint；授权恢复不等于批准，不重派 UNKNOWN。steer 追加后续指导，不改写已冻结 Planner 请求、工具输入或原授权；已派发步骤先按原身份恢复。
fetch/SSE 的 Last-Event-ID 保持不透明字符串，不经过 Number。回调按序执行，调用方控制重连/Abort；不完整 EOF 不伪造交付，恢复读取原 Run。SDK 不自动重连/写入，HTTP 重定向不跨越配置来源，错误保留原游标恢复语义。
Studio 两个入口
全页与 Canvas 侧栏消费共同 SDK、Panel 与结果 renderer，选择同一会话/Run；切入口不新建执行权威。Canvas 选中内容为来源快照，服务端重验对象/版本，任意视觉连线不触发执行。图编辑、CAS 与领域采纳仍属 Studio，本包不实现完整 DAG。
公开过程呈现理解、计划、等待用户、生成、保存、候选送达和终态；交互从原持久状态恢复。等待、原命令重试、多标签和迟到事件不能重开已回答决定或重复提交。不展示私有思维链、内部提示词、冻结工具输入或供应 envelope。
独立宿主与固定流程
独立文档夹具从实际制品消费 SDK，经 loopback HTTP、独立会话/Origin/CSRF、受限 PG 角色和产品 inbox 验证对话到结果。合成 Planner 与本地确定性工具证明脱离 Studio 会话/内部表/import 的消费；不证明生产新 callerScope 或 Commerce 上线。
WorkflowEngine 无 Planner，定义包含具名版本、有限顺序、工具版本/输入、可选交付目标及至少一个持久批准点。定义冻结后重启读回同一实例；复用串行控制、Job/Attempt、Artifact、ResultSink 和 UNKNOWN 恢复，不另建生成链。Agent/Workflow 不能相互接管；首期不含 DAG、动态绑定、条件分支或运行中编辑。
兼容与发布
追加 schema 迁移，不改写原派发调用或旧 Planner 请求。client/server、宿主、镜像与 schema 成组固定；旧版能编译不代表能读新 schema。回退使用兼容新 schema 的应用/Worker，关闭新准入并恢复原任务；不 drop migration，不恢复旧钱包覆盖新账务，不双 Writer。
版本/迁移号及发布状态按最终回执登记，不把工作树、隔离测试或 Docs 发布当作业务灰度完成。
standalone或容器runner必须能在自身根内解析实际Runtime包与直接依赖，并对运行JS、package.json/exports与固定vendor制品核验；不能借工作树根模块的fallback使页面测试表面通过。具体框架的external/tracing配置留宿主，Linux最终镜像仍以实际运行制品验收。
CI 证据与发布制品
CI 的执行计算、证据保存和发布制品分别有明确归属：oceanway4 执行检查、测试和原生 amd64 打包；Infrastructure 提供受保护的归档客户端和异机接收器；镜像及签名/SBOM 随不可变摘要保存在镜像仓库。薄 SDK 与 Runtime 产品执行链不增加证据存储凭据或对象存储依赖。
归档按 repository/sourceSha/runId/runAttempt/job/artifact 绑定来源，Manifest 列出各文件大小与 SHA256，外部 Manifest 与压缩包内原件逐字一致。禁止路径穿越、重复成员、符号/硬链接和未列出文件；同一来源引用不可覆盖。客户端只有在主存储和异机存储都完整读回压缩包、逐文件验真后才返回成功回执。测试通过但归档失败时，发布门禁仍失败；GitHub Artifact 不再作为必需存储后端。
宿主客户端、配置和 known_hosts 由 root 保护；每个 Runner 独立身份及私有目录，SSH 接收器按公钥固定 Runner，只接受指定内容哈希的保存/读取，不接受任意命令或文件路径。首期只授权 Studio 仓库；扩展其他仓库须分别配置、联验。归档保留全量首期证据，不启用自动删除；主副本各保留所在文件系统至少 20% 空闲，容量不足时关闭归档门禁。
镜像摘要通过任务输出交接并从镜像仓库核实，构建元数据、不可变 manifest、SBOM 与签名验真回执纳入同一私有归档合同。源码合并、官方 CI、实际镜像、预发布、备份恢复和单账号业务灰度按 PROC-02-005分别取证；存储 canary 只证明归档通路。