/** * 每条会话当前待批的权限请求集合。 * * `requires_action_details` 只保留 worker 上报的最新一条;Web UI 需要知道 * 真实队列长度(多条工具同时等待审批),因此在服务端按 request_id 记账: * control_request 进入时登记完整请求(重连水合要用工具名/输入/规则建议), * worker 回执(control_response / control_cancel_request)、回合结束或 * 会话归档时移除。 * * Web 的 permission_response 只是「已发出决定」——POST 受理不等于 worker * 收到,因此这里只记 decision/sentAt、不销账;worker 的 control_response / * control_cancel_request 回来才移除。否则网络在 POST 与 worker 之间断开时 * 计数会先掉到 0、agent 却仍在阻塞。 */ export type PendingPermissionDecision = 'allow' | 'deny' export interface PendingPermissionRecord { requestId: string toolName: string toolInput: Record description?: string suggestions?: unknown[] /** 对应工具卡的 tool_use id — Web 用它把审批卡精确挂到并行工具中的一张。 */ toolUseId?: string /** Web 已发出的决定;回执到达前用于渲染「已允许/已拒绝 · 同步中」。 */ decision?: PendingPermissionDecision /** Web 已发出决定、等待 worker 回执的时间戳(epoch ms)。 */ sentAt?: number } export interface PendingPermissionDetails { toolName?: string toolInput?: Record description?: string suggestions?: unknown[] toolUseId?: string } const pendingBySession = new Map>() export function registerPendingPermission( sessionId: string, requestId: string, details?: PendingPermissionDetails, ): void { if (!requestId) return let requests = pendingBySession.get(sessionId) if (!requests) { requests = new Map() pendingBySession.set(sessionId, requests) } const existing = requests.get(requestId) requests.set(requestId, { requestId, toolName: details?.toolName ?? existing?.toolName ?? 'unknown', toolInput: details?.toolInput ?? existing?.toolInput ?? {}, description: details?.description ?? existing?.description, suggestions: details?.suggestions ?? existing?.suggestions, toolUseId: details?.toolUseId ?? existing?.toolUseId, decision: existing?.decision, sentAt: existing?.sentAt, }) } /** Web 已发出决定 — 记下决定与时间但保留条目,等 worker 回执再销账。 */ export function markPendingPermissionResponded( sessionId: string, requestId: string, decision?: PendingPermissionDecision, now = Date.now(), ): void { if (!requestId) return const record = pendingBySession.get(sessionId)?.get(requestId) if (!record) return record.sentAt = now if (decision) record.decision = decision } /** @returns true when a record existed and was removed. */ export function resolvePendingPermission( sessionId: string, requestId: string, ): boolean { const requests = pendingBySession.get(sessionId) if (!requests) return false const existed = requests.delete(requestId) if (requests.size === 0) pendingBySession.delete(sessionId) return existed } export function clearPendingPermissions(sessionId: string): void { pendingBySession.delete(sessionId) } export function getPendingPermissionCount(sessionId: string): number { return pendingBySession.get(sessionId)?.size ?? 0 } /** 重连水合用的完整快照 — 按到达顺序返回。 */ export function getPendingPermissions( sessionId: string, ): PendingPermissionRecord[] { return Array.from(pendingBySession.get(sessionId)?.values() ?? []) } /** 测试隔离用 —— 生产代码不应调用。 */ export function resetPendingPermissionsForTests(): void { pendingBySession.clear() }