nucleic-remote-ios/NucleicRemote/Shared/SessionActivityAttributes.swift

import ActivityKit
import Foundation

/// The one aggregate Live Activity (UX_IOS §5.3, aggregate per §11.4 — a single Activity
/// respects iOS's budget better than one per session). It answers "what is Nucleic doing right
/// now?" at a glance: the headline counts (running / waiting / approvals), the total churn in
/// flight, and a few of the most urgent sessions with their state and diff. Shared between the
/// app (which starts/updates it) and the widget extension (which renders it).
///
/// Deliberately free of `NucleicProtocol` types — the widget extension links only this file, so
/// the state carries plain value types and its own small `Backend`/`Kind` enums rather than the
/// wire `BackendID`/`SessionStatus`.
struct NucleicSessionAttributes: ActivityAttributes {
    /// The agent behind a session — drives a row's provider tag/tint.
    enum Backend: String, Codable, Hashable {
        case claude, codex, grok, other

        var label: String {
            switch self {
            case .claude: "Claude"
            case .codex: "Codex"
            case .grok: "Grok"
            case .other: "Agent"
            }
        }
    }

    /// A session's live state, collapsed to what the glance needs — drives each row's glyph/tint.
    enum Kind: String, Codable, Hashable {
        case running        // agent actively working a turn
        case provisioning   // worktree/setup spinning up
        case approval       // blocked on a human approval decision (loudest)
        case needsInput     // turn ended asking the user something
        case done           // turn finished its work; nothing required
        case error          // errored / interrupted
        case idle           // created, not yet working
    }

    /// One agent session surfaced in the activity's detail rows.
    struct SessionLine: Codable, Hashable, Identifiable {
        var id: String
        /// The session's title (falls back to the project name upstream).
        var title: String
        /// Project the session belongs to.
        var project: String
        var backend: Backend
        var kind: Kind
        /// A compact right-aligned status: its diff ("3 files +42 −7"), "2 to approve",
        /// "Waiting on you", "Working…", etc.
        var detail: String
    }

    struct ContentState: Codable, Hashable {
        /// Sessions actively working a turn.
        var runningCount: Int
        /// Sessions blocked on the user (approval or next prompt) — the loud number.
        var needsYouCount: Int
        /// Total individual approval decisions waiting across all sessions — the "act now" count.
        var approvalCount: Int
        /// Aggregate worktree churn across the active sessions.
        var filesChanged: Int
        var linesAdded: Int
        var linesRemoved: Int
        /// The most urgent sessions, attention-first (capped, typically ≤3): the detail rows.
        var lines: [SessionLine]

        /// The single most urgent session (drives the compact/minimal regions).
        var top: SessionLine? { lines.first }
        /// Whether anything needs the user (waiting session or a pending approval).
        var needsAttention: Bool { needsYouCount > 0 || approvalCount > 0 }
        /// Whether any worktree has uncommitted changes to summarize.
        var hasChurn: Bool { filesChanged > 0 }
    }

    /// The paired Mac's name (static for the Activity's lifetime).
    var hostName: String
}