Bot activity: revisioned live sync and reconnect

Remaining outcome — reconciled 2026-09-30

Existing Channel message streams are transport precedent, not Activity synchronization. Remaining: Activity baseline/revision/live frames, reconnect/gap recovery and listener lifecycle; every avatar reads the same snapshot.

Feature Project

Bot Activity & Avatar Presence
Historical coordination [Retired] Orchestrator: V1.0 PersonaBot Activity、Presence 与 Output Events #119 is retired.
Source spec: Spec: PersonaBot Activity Projection、共享 Avatar Presence 与 Output Events #118

What to build

在 #120 的 snapshot presence 上交付一个仅面向 PersonaBot Activity Projection 的最小 revisioned live sync。浏览器先查询 baseline snapshot，再通过 API Gateway 已认领的 Typert stream（或经验证的等价 authenticated stream seam）接收 committed activity revision；gap/overflow 时回取 snapshot，stream 不可用时回退 bounded refresh。

这不是 #67 的多域通用 stream，也不等待 Messaging、Attention 或外部 IM Provider。

Acceptance criteria

baseline + ordered incremental revisions 让 sidebar 与 composer 使用同一 snapshot revision。
duplicate/out-of-order update 不回退 UI；revision gap 明确触发 snapshot refetch。
frame 只来自 PersonaBot Activity Projection commit 后的通知，不携带 raw Session/tool payload。
disconnect、mode exit 与 Plugin disposal 后 Host/Client listener 无泄漏。
stream unavailable 时 bounded refresh 最终一致，transport failure 不显示成 PersonaBot state。
restart/reconnect 自动恢复，不重复动画或遗留 stale attention indicator。
未来 v1.1: read-model 实时同步流（post-commit frames） #67 接管通用 transport 时可兼容迁移，不制造第二个 activity authority。

Blocked by

Bot activity: shared snapshot and live DM presence #120

Recovery audit requested during Human QA

In addition to ordinary reconnect, validate page reload and hard Host termination during actual native Agent execution, so a new baseline cannot retain an abandoned working/thinking indicator. PR #686 includes the hard-termination native liveness/state evidence and two full browser reloads; Human QA remains pending. Refresh follows Host truth and must not force an actually running or waiting execution to idle. Orchestrator/Assignment aggregation stays with #123; no expansion of #122/#123/#124 here.

Agent work claim

Agent: Codex
Task: codex/local/01a0e445-0c0f-70e1-bad4-fd99c8cfaa21 (not a DSH Session)
Issue scope: Bot activity: revisioned live sync and reconnect #121 — validate existing revisioned Activity snapshots/live delivery, reconnect/gap recovery and cleanup through a narrow real DSH DM path; minimal owning-module repairs where required, with live screenshot/native evidence and Human QA.
Branch: codex/121-activity-live-acceptance
Started: 2026-10-01 18:51 UTC
State: active
Claim audit: Bot activity: shared snapshot and live DM presence #120 is closed; Bot activity: revisioned live sync and reconnect #121 has no prior claim comments or open PR. Fix: align Channel send guidance with registered attachment Tools #677 remains owned by another task and is excluded.

Agent work outcome

Agent: Codex
Task: codex/local/01a0e445-0c0f-70e1-bad4-fd99c8cfaa21 (not a DSH Session)
Issue scope: Bot activity: revisioned live sync and reconnect #121 — revisioned Activity baseline, gap recovery, unavailable-stream bounded refresh and subscription lifecycle.
Branch: codex/121-activity-live-acceptance
State: paused for Human QA; implementation and review complete, issue remains open.
PR: fix(activity): recover revisioned live state after transport failure #686
Commit: 7f7051a8a81c7643807daab7f8bfd70620f73697
Evidence: https://github.com/BotHarness/BotHarness/blob/7f7051a8a81c7643807daab7f8bfd70620f73697/docs/assets/pr/121-activity-recovery/README.md
Verification: 18 focused tests, final-head complete CI, CodeRabbit no actionable comments; real DSH HTTP 503 fallback, same-Bot sidebar/composer working, restored stream, mode exit with real model completion, re-entry idle baseline and same-profile Host restart with new generation.
Remaining: Human QA and merge; Bot activity: safe tool summaries and effects #122/Bot activity: Orchestrator and Assignment aggregation #123/Group activity: live facepile, safe summaries and details #124 have not been started. Transport remains the existing authenticated Connection Fetch route and API Gateway query; no second Activity authority.

Agent work continuation

Agent: Codex
Task: codex/local/01a0e445-0c0f-70e1-bad4-fd99c8cfaa21 (not a DSH Session)
Issue scope: Bot activity: revisioned live sync and reconnect #121 — Human requested explicit audit of stale activity after refresh and after hard Host termination during actual working; continue the same PR fix(activity): recover revisioned live state after transport failure #686, excluding Bot activity: safe tool summaries and effects #122/Bot activity: Orchestrator and Assignment aggregation #123/Group activity: live facepile, safe summaries and details #124.
Branch: codex/121-activity-live-acceptance
State: active for bounded edge-case verification; existing Human QA approval is not assumed.

test(activity): verify hard restart and repeated page reloads

Agent work outcome — recovery audit

Agent: Codex
Task: codex/local/01a0e445-0c0f-70e1-bad4-fd99c8cfaa21 (not a DSH Session)
Issue scope: Bot activity: revisioned live sync and reconnect #121 — explicit Human-requested audit of refresh and hard Host termination during actual native Agent execution.
State: paused for Human QA; PR remains open and has not been merged.
PR: fix(activity): recover revisioned live state after transport failure #686
Commit: ec794e0f123a89e6a6026dbb4c8c969f6dc01c77
Evidence: https://github.com/BotHarness/BotHarness/blob/ec794e0f123a89e6a6026dbb4c8c969f6dc01c77/docs/assets/pr/121-activity-recovery/crash-proof.json
Result: one native Agent actually running in thinking was captured before hard termination; same-profile restart produced a new generation, revision 0, idle. Two full browser reloads kept sidebar idle and cleared the active composer indicator. No additional production defect reproduced; production implementation is unchanged from the previously reviewed commit.
Verification: 32 relevant tests and final-head complete CI passed: https://github.com/BotHarness/BotHarness/actions/runs/36916352311
Remaining merge gates: Human QA and CodeRabbit incremental review of the added verification script/evidence. CodeRabbit explicitly rate-limited the incremental review and reported next included review in 53 minutes; its SUCCESS status is not treated as final-head review acceptance. The original production-code review had no actionable comments. Do not merge until the incremental review is complete and any valid feedback is addressed.
Scope remains Bot activity: revisioned live sync and reconnect #121 only; Bot activity: safe tool summaries and effects #122/Bot activity: Orchestrator and Assignment aggregation #123/Group activity: live facepile, safe summaries and details #124 and deferred Backup/Restore/Export work have not been started.

fix: recover revisioned bot activity after live transport failure (#686)

Agent work outcome

Agent: Codex
Task: codex/local/01a0e445-0c0f-70e1-bad4-fd99c8cfaa21
State: completed
PR: fix(activity): recover revisioned live state after transport failure #686, merged as e16e79fddd5a36d4834a537053b4ada822efcaeb
Human QA: accepted; Human explicitly authorized merge.
Evidence: actual isolated DSH recovery from HTTP 503, mode exit/reentry, two browser reloads, completed-Turn restart and forced Host termination during a live native Agent followed by a new idle generation. Sidebar and composer agree with Host truth. Focused 32 tests and final full CI passed.
CodeRabbit: production implementation reviewed without actionable findings. Final E2E/evidence-only increment was checked by Codex; its CodeRabbit retry was rate limited. Human's latest merge authorization is recorded in the PR.
Remaining scope: none for Bot activity: revisioned live sync and reconnect #121. Tool-aware safe summaries (Bot activity: safe tool summaries and effects #122), role aggregation (Bot activity: Orchestrator and Assignment aggregation #123), and Group presentation (Group activity: live facepile, safe summaries and details #124) remain separate.

Navigation Menu

Repository navigation

Bot activity: revisioned live sync and reconnect #121

Remaining outcome — reconciled 2026-09-30

Feature Project

What to build

Acceptance criteria

Blocked by

Recovery audit requested during Human QA

1 remaining item

Agent work claim

Agent work outcome

Agent work continuation

Agent work outcome — recovery audit

Agent work outcome

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Bot activity: revisioned live sync and reconnect #121

Description

Remaining outcome — reconciled 2026-09-30

Feature Project

What to build

Acceptance criteria

Blocked by

Recovery audit requested during Human QA

Activity

1 remaining item

DoodleBears commented on Oct 1, 2026

Agent work claim

DoodleBears commented on Oct 1, 2026

Agent work outcome

DoodleBears commented on Oct 1, 2026

Agent work continuation

DoodleBears commented on Oct 1, 2026

Agent work outcome — recovery audit

DoodleBears commented on Oct 1, 2026

Agent work outcome

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions