/** * worktree/state.ts — 「模型工具已建好、等这一轮结束后再切」的待办单例。 * * ## 为什么要挂 globalThis * * `ctx.switchSession()` 会**重新求值扩展模块**(实测:模块级 `let loads = 0` 两次都是 1), * 模块级变量活不过一次会话替换。而 `allowlist.ts` / `sandbox-mode.ts` 已经踩过同一个坑 * (pi 的加载器也不保证两个扩展拿到同一个模块实例),所以这里沿用同一手法:状态放 * `globalThis` 上,谁 import 都读得到同一份。 * * ## 为什么需要「待办」而不是当场切 * * 模型工具是在**一个正在跑的回合里**被调用的;那时替换 runtime 会让 pi 判旧 ctx 过期, * 还会把这一轮的结果写丢。所以工具只建树 + 登记,等 `agent_settled`(这一轮真的结束) * 再派发内部命令完成切换。 */ /** 待进入的 worktree。 */ export interface Pending { /** worktree 的绝对路径。 */ path: string; /** 目标分支名。 */ branch: string; /** 主仓根:退出时要用。 */ repoRoot: string; /** 登记时间(毫秒)。 */ requestedAt: number; /** * `agent_settled` 已经为这条待办派发过 `/worktree __enter`(毫秒)。 * * 为什么需要这个标记:派发只是发一句话,真正消费待办的是那个命令;只有它能安全地清空 * (清早了命令就不知道要切到哪里)。而 `agent_settled` 每次运行结束都会触发,不能重复派发。 */ dispatchedAt?: number; } const KEY = Symbol.for("pi-worktree.pending"); type Host = Record; /** 当前待办;没有则 `undefined`。 */ export function getPending(): Pending | undefined { return (globalThis as unknown as Host)[KEY]; } /** 登记一条待办(覆盖旧的:同一时刻只可能有一个「下一站」)。 */ export function setPending(pending: Pending): void { (globalThis as unknown as Host)[KEY] = pending; } /** 清掉待办。 */ export function clearPending(): void { delete (globalThis as unknown as Host)[KEY]; } /** 标记「已为这条待办派发过切换命令」,避免每次 `agent_settled` 重复派发。 */ export function markDispatched(at: number = Date.now()): void { const pending = getPending(); if (pending) (globalThis as unknown as Host)[KEY] = { ...pending, dispatchedAt: at }; }