SPB Git

Repository Public

ClaudeSessionTracker.swift 4.9 KB 123 lines swift

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
Files main
Menu

Theme