/**
 * P1-13：previewTarget 的生命周期收口。
 *
 * previewTarget 是**当代 worker 的路由状态**，不是会话的持久属性：它指向那一代
 * CLI 在本机 loopback 上拉起来的 Web 服务。worker 一换代（refork / 切 CLI / adopt /
 * 崩溃退出 / suspend），或者会话被关闭，那个进程就没了，端口号随时可能被别的本机
 * 进程抢走 —— 留着它等于把一条已登录用户可达的同源代理路由，交给一个我们不再认识
 * 的进程。
 *
 * 所以每个「权威换代边界」都必须做两件事，缺一不可：
 *   1. **原子地**把 previewTarget 从内存与磁盘上同时抹掉（并进调用方自己的那次
 *      `updateSession`，失败可回滚，不留下「内存清了磁盘没清」的中间态）；
 *   2. 向 Dashboard 广播 `preview: null`，否则浏览器侧的会话卡片会继续显示预览入口，
 *      SSE/WS 也没有信号去断开既有的预览长连接。
 *
 * 这里只提供这两个动作的最小原语，好让每个边界按自己的事务形状组合：
 *   - `takeSessionPreviewTarget` —— 只摘字段（调用方随后自己 save，可回滚）；
 *   - `publishSessionPreviewCleared` —— 只广播；
 *   - `clearSessionPreviewTarget` —— 自带 save + 广播，给没有自带事务的边界用。
 */
import type { Session } from '../types.js';
/**
 * 摘掉内存里的 previewTarget，返回被摘掉的旧值（本来就没有则返回 undefined）。
 * 不落盘、不广播：调用方要把它并进自己的原子 `updateSession`，并在 save 失败时用
 * 返回值回滚。
 *
 * P1-3：`expectedRegisteredAt` 是可选的 revision 门槛——「作废我判定失效的那一次注册」，
 * 而不是「清空此刻的值」。判定失效与清理落地之间隔着一次跨进程往返，这中间会话完全
 * 可以合法地重注册一个新目标；无条件清空会把它一并抹掉，agent 刚拿到的
 * 「✓ Web 预览已注册」立刻变成空。`registeredAt` 是 ISO 串，天然就是这次注册的
 * revision。不传时保持原来的无条件语义（换代 / 关闭 / suspend 这些权威边界本来就
 * 该清掉「当前那个」，无论它是哪一次注册）。
 */
export declare function takeSessionPreviewTarget(session: Session, expectedRegisteredAt?: string): Session['previewTarget'];
/**
 * 广播「这个会话已经没有预览目标了」。走 `previewTarget: null` 而不是省略字段——
 * preview-contract 的投影把它翻译成浏览器可见的 `preview: null`，浏览器 store 据此
 * 丢弃旧描述符；省略字段则会被当成「本次 patch 不涉及预览」而保留旧值。
 */
export declare function publishSessionPreviewCleared(sessionId: string): void;
/**
 * 清 + 落盘 + 广播。返回是否真的清掉了东西（没有目标时不产生任何事件与写盘）。
 *
 * 落盘失败**不**回滚内存：此刻内存里的会话已经不再持有那个目标（这正是我们要的
 * fail-closed 方向），而下一次成功的 save 会让磁盘收敛。广播照发，Dashboard 立刻
 * 停止把用户导向一个已经不属于本会话的端口。
 *
 * P1-3：`expectedRegisteredAt` 见 `takeSessionPreviewTarget`。revision 不匹配时整条
 * 是 no-op（不写盘、不广播、返回 false），幂等语义不变——「本来就没有」与「已经不是
 * 那一个了」对调用方是同一件事：这次清理没有需要做的事。
 */
export declare function clearSessionPreviewTarget(session: Session, why: string, expectedRegisteredAt?: string): boolean;
//# sourceMappingURL=session-preview-registry.d.ts.map