Skip to content

A tiny friend in your Mac's notch and on your iPhone that keeps an eye on your AI coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more. Approve from the notch or your Lock Screen.

9.8 KB
Raw Blame
#if PHONE_LINK
import AppKit
import CloudKit

// MARK: - The last turn, for the iPhone
//
// Built from the hook events HookServer already receives: UserPromptSubmit
// starts a turn, Pre/PostToolUse add actions (commands with their output,
// edits with their diff), Stop adds the final answer. One encrypted `Turn`
// record per session pill, replaced at each turn; nothing else is kept.
// Runs only while the iPhone sync is on; no timer.

@MainActor
final class TurnRecorder {
    static let shared = TurnRecorder()

    private let container = CKContainer(identifier: CloudProbe.containerID)
    private var database: CKDatabase { container.privateCloudDatabase }
    private var running = false
    private var turns: [String: TurnSnapshot] = [:]
    private var dirty: Set<String> = []
    private var flushTask: Task<Void, Never>?

    // Size limits: a turn stays well under CloudKit's 1 MB per record.
    private let maxActions = 200
    private let maxLinesPerFile = 600
    private let maxTotalLines = 4000
    private let maxOutput = 1500
    private let maxFinal = 12_000

    /// The Claude Code session last seen on a pill and its folder, for
    /// instructions sent from the iPhone (InstructionRunner).
    func lastSession(for pillId: String) -> (sessionId: String, cwd: String)? {
        guard let info = sessions[pillId], !info.sessionId.isEmpty, !info.cwd.isEmpty else { return nil }
        return info
    }
    private var sessions: [String: (sessionId: String, cwd: String)] = [:]

    func start() {
        running = true
        log("turn recorder on")
    }

    func stop() {
        running = false
        flushTask?.cancel(); flushTask = nil
        let ids = turns.keys.map {
            CKRecord.ID(recordName: TurnSnapshot.recordName(for: $0), zoneID: SessionSnapshot.zoneID)
        }
        turns = [:]
        dirty = []
        if !ids.isEmpty {
            Task { _ = try? await database.modifyRecords(saving: [], deleting: ids, savePolicy: .changedKeys, atomically: false) }
        }
    }

    /// Called by HookServer for every event of a session pill.
    func record(event: String, payload: [String: Any], pillId: String) {
        guard running, PillCatalog.isSession(pillId) else { return }
        let sessionId = payload["session_id"] as? String ?? payload["conversation_id"] as? String ?? ""
        let cwd = payload["cwd"] as? String ?? ""
        let now = Date()
        if !sessionId.isEmpty, !cwd.isEmpty { sessions[pillId] = (sessionId, cwd) }

        switch event {
        case "UserPromptSubmit":
            let prompt = payload["prompt"] as? String ?? ""
            turns[pillId] = TurnSnapshot(pillId: pillId, sessionId: sessionId,
                                         project: URL(fileURLWithPath: cwd).lastPathComponent,
                                         prompt: String(prompt.prefix(8000)), actions: [], files: [],
                                         finalMessage: "", startedAt: now, endedAt: nil)

        case "PreToolUse":
            let tool = payload["tool_name"] as? String ?? "Tool"
            guard tool != "AskUserQuestion" else { return }
            var turn = current(pillId, sessionId: sessionId, cwd: cwd)
            guard turn.actions.count < maxActions else { return }
            let input = payload["tool_input"] as? [String: Any] ?? [:]
            turn.actions.append(TurnAction(tool: tool, summary: Self.summary(tool: tool, input: input), date: now))
            turns[pillId] = turn

        case "PostToolUse", "PostToolUseFailure":
            let tool = payload["tool_name"] as? String ?? "Tool"
            guard tool != "AskUserQuestion" else { return }
            var turn = current(pillId, sessionId: sessionId, cwd: cwd)
            let input = payload["tool_input"] as? [String: Any] ?? [:]
            let summary = Self.summary(tool: tool, input: input)
            // The matching PreToolUse action, latest first; one is added if it was missed.
            var index = turn.actions.lastIndex { $0.tool == tool && $0.summary == summary && $0.output.isEmpty && $0.fileIndex == nil }
            if index == nil, turn.actions.count < maxActions {
                turn.actions.append(TurnAction(tool: tool, summary: summary, date: now))
                index = turn.actions.count - 1
            }
            guard let index else { return }
            turn.actions[index].failed = event == "PostToolUseFailure"
            turn.actions[index].output = Self.output(payload, limit: maxOutput)
            if event == "PostToolUse", let diff = Self.fileDiff(tool: tool, input: input) {
                let used = turn.files.reduce(0) { $0 + $1.lines.count }
                let budget = max(0, min(maxLinesPerFile, maxTotalLines - used))
                turn.files.append(TurnFile(diff: diff, maxLines: budget))
                turn.actions[index].fileIndex = turn.files.count - 1
            }
            turns[pillId] = turn

        case "Stop", "StopFailure":
            var turn = current(pillId, sessionId: sessionId, cwd: cwd)
            let final = (payload["last_assistant_message"] as? String) ?? (payload["message"] as? String) ?? ""
            turn.finalMessage = String(final.prefix(maxFinal))
            turn.endedAt = now
            turns[pillId] = turn

        default:
            return
        }
        dirty.insert(pillId)
        scheduleFlush(soon: event == "Stop" || event == "StopFailure" || event == "UserPromptSubmit")
    }

    /// The turn in progress, or a new one when the prompt wasn't seen (Codex, app started mid-turn).
    private func current(_ pillId: String, sessionId: String, cwd: String) -> TurnSnapshot {
        if let turn = turns[pillId], turn.endedAt == nil { return turn }
        return TurnSnapshot(pillId: pillId, sessionId: sessionId,
                            project: URL(fileURLWithPath: cwd).lastPathComponent,
                            prompt: "", actions: [], files: [], finalMessage: "", startedAt: Date(), endedAt: nil)
    }

    // MARK: Writing

    private func scheduleFlush(soon: Bool) {
        if soon { flushTask?.cancel(); flushTask = nil }
        guard flushTask == nil else { return }
        flushTask = Task {
            try? await Task.sleep(for: .seconds(soon ? 0.5 : 2))
            guard !Task.isCancelled else { return }
            flushTask = nil
            await flush()
        }
    }

    private func flush() async {
        let ids = dirty
        dirty = []
        let records = ids.compactMap { id -> CKRecord? in
            guard let turn = turns[id], let json = try? JSONEncoder().encode(turn),
                  let payload = String(data: json, encoding: .utf8) else { return nil }
            let record = CKRecord(recordType: TurnSnapshot.recordType,
                                  recordID: CKRecord.ID(recordName: TurnSnapshot.recordName(for: id),
                                                        zoneID: SessionSnapshot.zoneID))
            record["pillId"] = id
            record["updatedAt"] = Date()
            record.encryptedValues["payload"] = payload
            return record
        }
        guard !records.isEmpty else { return }
        do {
            _ = try await database.modifyRecords(saving: records, deleting: [], savePolicy: .allKeys, atomically: false)
        } catch {
            log("turn publish failed: \(error.localizedDescription)")
        }
    }

    // MARK: Reading the hook payloads

    static func summary(tool: String, input: [String: Any]) -> String {
        let keys = ["command", "file_path", "path", "pattern", "url", "query", "description", "prompt"]
        for key in keys {
            if let value = input[key] as? String, !value.isEmpty { return String(value.prefix(600)) }
        }
        return ""
    }

    /// What a command printed, or the error.
    static func output(_ payload: [String: Any], limit: Int) -> String {
        var text = ""
        if let error = payload["error"] as? String {
            text = error
        } else if let response = payload["tool_response"] as? [String: Any] {
            let stdout = response["stdout"] as? String ?? ""
            let stderr = response["stderr"] as? String ?? ""
            text = [stdout, stderr].filter { !$0.isEmpty }.joined(separator: "\n")
        } else if let response = payload["tool_response"] as? String {
            text = response
        }
        let trimmed = text.trimmingCharacters(in: .whitespacesAndNewlines)
        return trimmed.count > limit ? String(trimmed.prefix(limit)) + "\n…" : trimmed
    }

    static func fileDiff(tool: String, input: [String: Any]) -> FileDiff? {
        guard let path = input["file_path"] as? String else { return nil }
        switch tool {
        case "Edit":
            guard let old = input["old_string"] as? String, let new = input["new_string"] as? String else { return nil }
            return DiffEngine.fromEdit(old: old, new: new, path: path)
        case "MultiEdit":
            guard let edits = input["edits"] as? [[String: Any]] else { return nil }
            var added = 0, removed = 0, hunks: [DiffHunk] = [], tooLarge = false
            for edit in edits {
                guard let old = edit["old_string"] as? String, let new = edit["new_string"] as? String else { continue }
                let d = DiffEngine.fromEdit(old: old, new: new, path: path)
                added += d.added; removed += d.removed
                hunks += d.hunks
                tooLarge = tooLarge || d.tooLarge
            }
            return FileDiff(path: path, added: added, removed: removed, hunks: hunks, tooLarge: tooLarge, isNewFile: false)
        case "Write":
            guard let content = input["content"] as? String else { return nil }
            return DiffEngine.fromNew(content: content, path: path)
        default:
            return nil
        }
    }

    private func log(_ message: String) {
        CloudProbe.shared.log("[turn] \(message)")
    }
}
#endif