1.4 KiB
1.4 KiB
Tab Lifecycle Marks
- Agent-created tabs persist in the current ZCode process until the model explicitly calls
tab.close(), the user closes the tab/window, or the process exits. Claimed user tabs return to the user when released. tab.markDeliverable()keeps a user-facing result visible and releases it from browser control at turn cleanup.tab.markHandoff()keeps unfinished work visible and controllable by this session in a later turn.browser.tabs.finalize({ keep })changes only the tabs listed inkeep. Unlisted active/handoff tabs stay open; absence fromkeepis never an implicit close request.turnEndedcancels pending requests and releases explicit deliverables or unmarked claimed user tabs, but it never closes a tab; an explicit handoff remains controlled.closeSessionreleases surviving tabs back to the owning conversation without closing their views. Released tabs never become visible to a different conversation.browser.user.openTabs()only returns the current conversation's non-empty user tabs. Empty URLs and exactabout:blankplaceholders are intentionally omitted.- Closing every visible in-app browser tab in the current conversation requires both sources: close controlled tabs from
browser.tabs.list(), then claim and close user tabs returned bybrowser.user.openTabs(). Other conversations remain inaccessible.