Repository Public
1import Foundation2import Observation34/// Verified state of one Claude Code session, built exclusively from hook events (never from5/// terminal text). `status` is derived from the last events; `verified` says which facts came from hooks.6public struct ClaudeSessionInfo: Sendable, Hashable, Identifiable {7 public enum Status: String, Sendable { case starting, idle, working, waitingForPermission, waitingForInput, ended }89 public var id: String { sessionID }10 public let sessionID: String11 public var projectDirectory: String?12 public var transcriptPath: String?13 public var permissionMode: String?14 public var status: Status = .starting15 public var lastEvent: String?16 public var lastEventAt: Date?17 public var lastTool: String?18 public var lastToolInput: String?19 public var pendingPermission: (tool: String, input: String)? {20 get { _pendingTool.map { ($0, _pendingInput ?? "") } }21 set { _pendingTool = newValue?.tool; _pendingInput = newValue?.input }22 }23 private var _pendingTool: String?24 private var _pendingInput: String?25 public var lastNotification: String?26 public var lastAssistantMessage: String?27 public var eventCount = 028 public var toolUseCount = 029 public var startedAt: Date?30 public var endedAt: Date?31 public var activeSubagents = 03233 public init(sessionID: String) { self.sessionID = sessionID }3435 /// Applies an event and returns whether the session now needs the user's attention.36 public mutating func apply(_ event: HookEvent) -> Bool {37 eventCount += 138 lastEvent = event.headline39 lastEventAt = event.receivedAt40 if let cwd = event.cwd { projectDirectory = cwd }41 if let t = event.transcriptPath { transcriptPath = t }42 if let m = event.permissionMode { permissionMode = m }43 var attention = false44 switch event.event {45 case .sessionStart:46 status = .idle47 startedAt = startedAt ?? event.receivedAt48 endedAt = nil49 case .userPromptSubmit:50 status = .working51 pendingPermission = nil52 case .preToolUse:53 status = .working54 lastTool = event.toolName55 lastToolInput = event.toolInput?.summary56 toolUseCount += 157 case .postToolUse, .postToolUseFailure:58 status = .working59 pendingPermission = nil60 case .permissionRequest:61 status = .waitingForPermission62 pendingPermission = (event.toolName ?? "tool", event.toolInput?.summary ?? "")63 attention = true64 case .notification:65 lastNotification = event.message ?? event.title66 switch event.notificationType {67 case "permission_prompt":68 status = .waitingForPermission69 if pendingPermission == nil { pendingPermission = ("permission", event.message ?? "") }70 attention = true71 case "idle_prompt", "agent_needs_input", "elicitation_dialog":72 status = .waitingForInput73 attention = true74 default: break75 }76 case .stop:77 status = .idle78 pendingPermission = nil79 lastAssistantMessage = event.lastAssistantMessage80 attention = true81 case .subagentStart: activeSubagents += 182 case .subagentStop: activeSubagents = max(0, activeSubagents - 1)83 case .sessionEnd:84 status = .ended85 endedAt = event.receivedAt86 pendingPermission = nil87 default: break88 }89 return attention90 }91}9293/// Main-actor registry of Claude sessions seen through hooks. Sessions launched by NEXTERM carry the94/// UUID NEXTERM passed to `--session-id`, which is how a hook event is matched to a pane.95@MainActor96@Observable97public final class ClaudeSessionTracker {98 public private(set) var sessions: [String: ClaudeSessionInfo] = [:]99 public private(set) var recentEvents: [HookEvent] = []100 public var maxRecentEvents = 200101 /// Called when a session needs attention (permission, input, finished turn).102 public var attentionHandler: ((ClaudeSessionInfo, HookEvent) -> Void)?103104 public init() {}105106 public func handle(_ event: HookEvent) {107 var info = sessions[event.sessionID] ?? ClaudeSessionInfo(sessionID: event.sessionID)108 let attention = info.apply(event)109 sessions[event.sessionID] = info110 recentEvents.append(event)111 if recentEvents.count > maxRecentEvents { recentEvents.removeFirst(recentEvents.count - maxRecentEvents) }112 if attention { attentionHandler?(info, event) }113 }114115 public func session(_ id: String) -> ClaudeSessionInfo? { sessions[id] }116117 public func forget(_ id: String) { sessions.removeValue(forKey: id) }118119 public var orderedSessions: [ClaudeSessionInfo] {120 sessions.values.sorted { ($0.lastEventAt ?? .distantPast) > ($1.lastEventAt ?? .distantPast) }121 }122}123