跳转至

子代理让渡交接

子代理注册表在 sessions_yield 中负责完成状态。被让渡的执行结束;被委派的任务及其完成受众仍然存在。注册表的请求方结算批次会在子项结算后启动后继轮次。Gateway 准入会在必要时将该后继附加到已暂停的子代理,并保留其原始请求方。

该设计同样适用于从交互式会话派生的编排器,以及从隔离的 cron 运行派生的编排器。Cron 负责投递计划结果,而注册表负责嵌套编排器的继续执行。

交接过程中的所有权

阶段 所有者 必需交接
执行中的请求方 已准入的代理轮次 子项使用 requesterTurnRunId 标识派生轮次。进度回调使用该轮次的实时权限。
显式让渡 注册表请求方让渡结算 持久化让渡意图,冻结子项运行 ID,推进批次代际,并清除旧的请求方轮次绑定。
等待子项 注册表生命周期和 requesterSettleWake 保留已捕获的完成结果,并安排应执行的批次。单独公告不得启动竞争性的继续执行。
结算分发 请求方结算唤醒投递 验证当前批次和 Gateway 所有者,为嵌套请求方分发幂等的内部继续执行,并记录其结果。
后继准入 Gateway 任务跟踪和暂停运行接管 在新准入的运行 ID 下继续暂停的任务,保留请求方谱系及其未完成的结算义务。
后继完成 注册表完成投递 将编排器的结果投递给其原始请求方。Cron 现有的继续执行和投递策略负责计划输出。

实现所有者是 subagent-registry-requester-yield.ts、 subagent-announce.requester-settle-wake.ts 和 agent-task-tracking.ts。adoptPausedSubagentRunForFollowUp 使用现有的 注册表替换操作;它不会创建第二个委派任务。 接管会清除仅子项的暂停通知,而不是将其带入完成。 实际的请求方完成批次保留其冻结的成员关系和代际。

在已让渡请求方中准入另一个轮次之前,恢复所有者会将其已结束执行的栅栏转移到当前持久子项批次。写入提交前会重新验证该批次;缺失或已接管的批次、无关的运行栅栏,以及未完成的恢复或投递工作仍保持栅栏状态。随后,后继获得自己的执行栅栏,因此完成它不会丢弃待处理的子项结果,并使后续用户输入可被准入。

显式 waitFor: "message" 在注册表接受等待后计为继续执行证据。该尝试会将这一事实带入终端回复呈现,因此已注册的消息等待不会产生缺少继续执行警告。被拒绝或未注册的等待不提供该证据。

私有子项结果会等待其派生轮次结算,之后才允许单独公告准入。正常结算会恢复每个已完成的私有子项,即使兄弟项仍在运行。显式让渡先分配冻结批次,然后在该所有者下恢复子项清理。迟到的公告失败不能替换批次的投递状态;已提交的投递证据仍然有效。重启激活会在恢复子项完成之前协调保留的请求方轮次绑定。

对于嵌套请求方,结算会在安排继续执行之前,将其暂停运行与子项唤醒批次一起持久化。这也涵盖在请求方让渡之前完成的子项:后继准入不得依赖于稍后的生命周期结束通知。后继保留同一任务,且来自前驱的延迟通知不能重新打开它。

当请求方执行结算唤醒继续执行时,其自身的完成批次仍可能被标记为分发中。让渡工具会将该确切批次从较早的待处理子项中排除:它不得为已在处理的结果承诺另一次唤醒。无关的待处理批次和新派生的工作保留其现有的完成所有权。

结算分发使用 subagent_settle 输入来源。单独公告和较旧的后代唤醒路径保留 subagent_announce:后者在分发后已经拥有其运行替换,并且不得在准入时触发暂停运行接管。来源对交接进行分类;实时 Gateway 准入和注册表所有权仍然授权它。

显式让渡批次必须在任何请求方深度都符合条件。普通嵌套波排除规则仍然保留:没有让渡批次的嵌套运行使用现有的后代结算路径。顶层 cron 排除规则也仍然保留;为 cron 会话启动独立的请求方结算轮次会与其调度器拥有的继续执行竞争。

不变量

注册表持久化所有者按运行串行化变更,并按排序顺序准入多运行批次。同步计划在准入后读取当前不可变已发布行,并返回替换行或删除。异步准备先发生;计划在提交前重新检查执行、取消、请求方和群组所有权。 回调在等待期间保留其观察到的所有权和唤醒进度。它们仅从自己已确认的发布推进这些观察。

SQLite worker 在写入前比较行版本摘要。外部变更会通过 read worker 刷新受影响行并重新执行计划,最多尝试三次。只有已确认的提交才会发布驻留行并通知读取者。未知写入结果会隔离这些行,直到规范恢复。终态行及其符合条件的会话状态事件一起提交;等效的重复终态回调保留进行中的清理权限。这不会更改任何模式或更新格式。

进程本地的回调所有权在元数据发布后仍然保留。在替换 Gateway 下的恢复通过同一行所有者获取新的运行时实例,因此来自已关闭 Gateway 的回调无法结算恢复的唤醒。

  • 单一完成所有者。 Yield 在关闭旧执行之前转移所有权。针对确切轮次和子批次的现有可见最终回执会阻止重新武装已完成的义务。成功的批次结算会使该代次退役;重复回调无法再次最终确定它。
  • 无恢复的权限。 无论是存储的 run ID 还是来源信息,都不会复活已关闭的执行。后继者通过正常的 Gateway 准入并获得新的执行权限。采用会保留任务谱系,而不是旧的工具、审批、通道或 worker 回调。取消、重置和所有者替换保留其现有的准入和清理门控。
  • 范围化自动化管理。 经过身份验证的 Control UI 管理员的显式 yield 可以将自动化管理转移到其经验证的请求者延续。注册表在 yield 前捕获实时权限,在整个批次持久化后提升它,并将新的管理授权绑定到被准入的后继者。它从不转移自动化创建、旧授权或直接用户身份。交接保持进程本地,并会被新的直接用户轮次、取消、会话重置或归档以及 Gateway 重启撤销。后继者绑定其运行范围后,该范围拥有该权益直到其关闭。退役已交付的子批次不能撤销仍在运行的请求者。新的直接用户轮次会退役自动化权益,而不是子批次单独保留的完成源。有效结果仍可在其原始调用者的限制下返回;它们从不借用新轮次的身份或权限。
  • 完成源保管。 注册将实时操作者源与执行分开保留。单个交付和请求者结算使用所捕获的权限上限,而不是稍后安排清理的异步调用者。已提交的结算、退役或源/Gateway 撤销会释放它;临时写入和同任务替换不能丢弃它。保留的结果在该释放之后不再保留可用权限,并且批次不能组合不兼容的操作者源。仅取消批次保留现有取消调用者的准入,而不是使用已撤销的目标来授权新轮次。混合结果/取消批次要求每个原始源保持实时且兼容。显式交付重试在实时时捕获其新准入的调用者,并仅在新交付代次提交后转移保管权;它不会重新打开已过期的源。重启仍然准入新的恢复所有者,而不是复活先前进程的能力。
  • 稳定受众。 嵌套唤醒使用内部交付。针对一个实时的 sessions_yield 暂停行的结算延续会采用该行;无关的跨会话消息不会采用该行。来自控制父级到其暂停的原生子级的普通 sessions_send 会通过显式 mode: "resume" 相同的精确代次准入所有者恢复现有任务。任务拥有的完成仍然是唯一的结果交付路径。显式 mode: "followup" 保持独立的活动跟踪,并保留子级的原始结果或待处理 yield 不变。命名新请求者的显式插件后续继续创建它们自己的交付义务。在暂停发布之前被准入的默认交付后续会在暂停发布时接收暂停行的请求者、完成保管和结算义务;绑定请求者的后续保留其自己的交付。
  • 确定性批次。 冻结的 run ID 会被排序。发现使用创建时间、完成时间和子会话身份作为平局决胜因素。被取代的子行会被排除。批次身份包括请求者身份、子 ID 和 yield 代次。
  • 有界交付。 现有限制保持不变:三次尝试、三次模糊传输重放和十次过期延迟。活动后代不会消耗过期延迟预算。对于在当前批次最早子级创建之前结束的执行,其交付簿记不能阻止其延续。与该批次重叠的活动后代和交付结算仍会保持唤醒;历史失败记录仍然可用。私有交接的观察超时不会取消底层 Gateway 轮次。当 Gateway 报告该轮次正在飞行时,结算观察同一请求,而不消耗失败尝试或丢弃子结果。Gateway 准入和执行保留它们自己的超时;显式取消仍会停止轮次。单个私有公告保留其交付截止时间,直到请求者执行开始;然后 Gateway 的请求者运行时预算适用。发现上限为 4,096 个字符,单个结果上限为 512,路由通知上限为 1,024。模糊重放重用其尝试键;它不声明跨 Gateway 重启的全局恰好一次交付。

yield 之后的进度

Yield 关闭旧执行,而不是委托的工作。当轮次否则将保持静默时,共享回复管道可以发送等待确认。原生子代理注册表保留完成义务,并通过其接受的完成路径唤醒请求者;进度文本不是子级已完成或其结果已交付的证明。

当结算恢复一个具有自动通道投递的顶层父任务时,OpenClaw 会在该延续执行期间保持通道的输入指示器处于活动状态。指示器在执行开始后启动,而不是在准入排队期间,并在调用结算、被取消或失去其所有者时停止。它遵循 typingMode: "never",使用 agents.defaults.typingIntervalSeconds 刷新频率,并且需要通道输入支持。私有和嵌套延续不会向外部通道发送活动。此活动信号不会更改已配置的消息队列模式,也不会恢复单个工具进度消息。

在 Telegram 和 Discord 上,已确认的 progress 草稿可以保留在让出回合的通告子任务处,而不是等待确认处。通道会继续渲染、限流并删除它;原生注册表只转发子任务状态和已准备的操作名称(绝不转发子任务正文、命令、参数或结果)。公共任务状态保持可见,同时禁用详细工具日志;streaming.progress.toolProgress 控制滚动诊断行。再次让出的恢复父任务会为其新的子任务保留同一草稿。当结算唤醒完成最后一个被跟踪的群组(最终、NO_REPLY 或终态失败)时,或当停止或重置取消子任务时,草稿会被删除。它是进程本地的:Gateway 重启不会恢复它。其他通道保留等待确认。让出的回合仍不会启动独立任务或流程投影。

进度卡片 保持为持久会话状态。父任务会随着工作推进以及子任务结果返回而更新自己的卡片。通过 子代理命令 和会话历史检查原生子任务状态或保留的消息。已保存的卡片或已存储的消息 ID 均不会授权新的执行或投递。

Cron 在开始其有界综合宽限期之前,会观察注册表的后代结算边界。让出的任务在最后一个工作进程结束与后继准入之间保持待定;后继及其完成投递必须在 cron 选择最终结果之前结算。执行等待、结算观察和综合共享现有的后续截止时间,并在 cron 取消时停止。挂起或永久失败的子任务投递保留注册表的终态语义,使 cron 的现有回退策略能够解决计划结果,而无需重试该投递。

有关工具行为,请参阅 子代理;有关通道展示,请参阅 进度草稿。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw