docs(runtime): note that a background structured tab re-publish is a no-op

The activate:false branch for an already-published session returns without
writing the snapshot or emitting, so it cannot re-surface a client whose
mirror lost the tab. Orchestration is safe from this only incidentally.
This commit is contained in:
Merge Sim
2026-09-05 08:30:22 -07:00
parent 8aed3e9787
commit c3a0cb90eb
@@ -76,6 +76,8 @@ export class OrcaRuntimeWithRestoreStructuredAgentSessionTabsOnce extends OrcaRu
const existing = this.mobileSessionTabsByWorktree.get(input.workspaceId)
const id = `agent-session:${input.sessionId}`
if (existing?.tabs.some((tab) => tab.id === id)) {
// A background re-publish is a no-op — no store write, no emit — so it cannot re-surface a
// client whose mirror lost the tab; healing one needs `activate` or an explicit republish.
if (!input.activate) {
return
}