Files
hapi/ios/Packages/HapiKit/Tests/HapiProtocolTests/WidgetSnapshotTests.swift
T
19fd3b91df fix(ios,hub): keep widget snapshots fresh in the background
- Include the latest assistant preview in the silent-push fingerprint so result-only changes wake the phone; the status-only fingerprint missed results that landed while a session stayed working.
- Coalesce WidgetKit reloads (60s) and reload only installed widget kinds, with a fallback when configuration lookup is empty; the previous every-update/all-kind reloads exhausted the system redraw budget.
- Wait for AppModel/hub restoration on a cold silent-push launch instead of clearing the last good snapshot.
- Use a 15-minute widget timeline fallback and 60-second hub push throttle.
- Add the medium Session Detail layout with in-card paging, plain-text previews, status labels, and the hidden-row indicator.

via [HAPI](https://hapi.run)

Co-Authored-By: HAPI <noreply@hapi.run>

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-11-07 22:00:26 +08:00

277 lines
11 KiB
Swift

import Foundation
import HapiProtocol
import Testing
@Suite("Widget snapshot")
struct WidgetSnapshotTests {
private func summary(
id: String,
active: Bool = true,
thinking: Bool = false,
pending: Int = 0,
kinds: [PendingRequestKind] = [],
updatedAt: Int,
lastUserMessageAt: Int? = nil,
lastUserMessagePreview: String? = nil,
lastAssistantMessagePreview: String? = nil,
name: String? = nil,
flavor: String? = nil,
path: String = "/Users/me/projects/hapi",
todo: TodoProgress? = nil,
backgroundTasks: Int = 0
) -> SessionSummary {
SessionSummary(
id: id,
active: active,
thinking: thinking,
activeAt: updatedAt,
updatedAt: updatedAt,
lastUserMessageAt: lastUserMessageAt,
lastUserMessagePreview: lastUserMessagePreview,
lastAssistantMessagePreview: lastAssistantMessagePreview,
metadata: SessionSummaryMetadata(name: name, path: path, flavor: flavor),
metadataVersion: 1,
agentStateVersion: 1,
todosUpdatedAt: 0,
todoProgress: todo,
pendingRequestsCount: pending,
pendingRequestKinds: kinds,
backgroundTaskCount: backgroundTasks
)
}
@Test func selectsAttentionFirstAndKeepsExactTotals() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [
summary(id: "working", thinking: true, updatedAt: now - 30_000, lastUserMessageAt: now - 90_000, name: "Fix widget"),
summary(id: "approval", pending: 2, kinds: [.permission], updatedAt: now - 20_000, name: "Review Android"),
summary(id: "input", pending: 1, kinds: [.input], updatedAt: now - 10_000, name: "Answer question"),
summary(id: "idle", thinking: false, updatedAt: now - 5_000, name: "Between turns"),
summary(id: "done", active: false, thinking: false, updatedAt: now - 4_000, name: "Old done"),
summary(id: "stale", active: false, thinking: false, updatedAt: now - 60 * 60 * 1000, name: "Too old")
],
hubUrl: "https://hub.example.com",
now: now,
recentWindowMs: 15 * 60 * 1000,
limit: 4
)
#expect(snapshot.sessions.map(\.id) == ["approval", "input", "working", "idle"])
#expect(snapshot.runningCount == 1)
#expect(snapshot.needsApprovalCount == 1)
#expect(snapshot.needsInputCount == 1)
#expect(snapshot.idleCount == 1)
#expect(snapshot.sessions.last?.status == .idle)
#expect(snapshot.sessions.first?.startedAt == nil)
#expect(snapshot.sessions.first?.project == "hapi")
#expect(snapshot.sessions.first?.title == "Review Android")
#expect(snapshot.generatedAt == now)
#expect(snapshot.hubUrl == "https://hub.example.com")
}
@Test func activeSessionsBetweenTurnsAreIdleNotDone() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [summary(id: "idle", active: true, thinking: false, updatedAt: now - 1_000, name: "Idle")],
hubUrl: "https://hub.example.com",
now: now
)
#expect(snapshot.sessions.first?.status == .idle)
#expect(snapshot.idleCount == 1)
#expect(snapshot.runningCount == 0)
}
@Test func dormantActiveSessionsStayInTheActiveGroup() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [
summary(
id: "dormant",
active: true,
thinking: false,
updatedAt: now - 60 * 60 * 1000,
name: "Dormant"
)
],
hubUrl: "https://hub.example.com",
now: now
)
#expect(snapshot.sessions.map(\.id) == ["dormant"])
#expect(snapshot.sessions.first?.status == .idle)
#expect(snapshot.idleCount == 1)
}
@Test func includesRecentlyCompletedSessionsWithinTheWindow() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [
summary(id: "recent", active: false, thinking: false, updatedAt: now - 1_000, name: "Recent"),
summary(id: "old", active: false, thinking: false, updatedAt: now - 16 * 60 * 1000, name: "Old")
],
hubUrl: "https://hub.example.com",
now: now
)
#expect(snapshot.sessions.map(\.id) == ["recent"])
#expect(snapshot.sessions.first?.status == .done)
#expect(snapshot.runningCount == 0)
#expect(snapshot.idleCount == 0)
}
@Test func titleFallsBackThroughTheSameOrderAsTheApp() {
var item = summary(id: "fallback-id", updatedAt: 1, path: "/repo/My Project")
#expect(WidgetSnapshotBuilder.title(for: item) == "My Project")
item.metadata?.promptTitle = "Prompt title"
#expect(WidgetSnapshotBuilder.title(for: item) == "Prompt title")
item.metadata?.summary = SessionSummaryMetadata.Summary(text: "Summary title")
#expect(WidgetSnapshotBuilder.title(for: item) == "Summary title")
item.metadata?.name = "Manual name"
#expect(WidgetSnapshotBuilder.title(for: item) == "Manual name")
}
@Test func carriesSingleLineLastUserMessagePreview() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [
summary(
id: "s1",
thinking: true,
updatedAt: now,
lastUserMessageAt: now,
lastUserMessagePreview: "line one\n line two",
name: "Session"
),
summary(id: "s2", thinking: true, updatedAt: now, name: "No preview")
],
hubUrl: "https://hub.example.com",
now: now
)
#expect(snapshot.sessions.first(where: { $0.id == "s1" })?.lastMessage == "line one line two")
#expect(snapshot.sessions.first(where: { $0.id == "s2" })?.lastMessage == nil)
}
@Test func stripsMarkdownFromWidgetPreviews() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [
summary(
id: "s1",
thinking: true,
updatedAt: now,
lastUserMessagePreview: "**fix** `login`",
lastAssistantMessagePreview: """
# Result
- **Done** [link](https://example.com)
1. next
""",
name: "Session"
)
],
hubUrl: "https://hub.example.com",
now: now
)
let session = snapshot.sessions.first
#expect(session?.lastMessage == "fix login")
#expect(session?.lastResult == "Result Done link next")
}
@Test func carriesAgentFlavorForTheRowIcon() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [
summary(id: "codex", thinking: true, updatedAt: now - 1_000, name: "Codex", flavor: "codex"),
summary(id: "unknown", thinking: true, updatedAt: now - 2_000, name: "Other")
],
hubUrl: "https://hub.example.com",
now: now
)
#expect(snapshot.sessions.first { $0.id == "codex" }?.flavor == "codex")
#expect(snapshot.sessions.first { $0.id == "unknown" }?.flavor == nil)
}
@Test func marksUnreadRowsFromTheReadWatermark() {
let now = 1_700_000_000_000
let snapshot = WidgetSnapshotBuilder.build(
sessions: [
summary(id: "running", thinking: true, updatedAt: now, name: "Running"),
summary(id: "unread", thinking: false, updatedAt: now, name: "Unread"),
summary(id: "read", thinking: false, updatedAt: now, name: "Read")
],
hubUrl: "https://hub.example.com",
unreadSessionIds: ["running", "unread"],
now: now
)
#expect(snapshot.sessions.first { $0.id == "running" }?.isUnread == true)
#expect(snapshot.sessions.first { $0.id == "unread" }?.isUnread == true)
#expect(snapshot.sessions.first { $0.id == "read" }?.isUnread == nil)
}
@Test func snapshotRoundTripsThroughTheAppGroupFile() throws {
let directory = FileManager.default.temporaryDirectory
.appendingPathComponent("WidgetSnapshotTests-\(UUID().uuidString)", isDirectory: true)
defer { try? FileManager.default.removeItem(at: directory) }
let snapshot = WidgetSnapshotBuilder.build(
sessions: [summary(id: "s1", thinking: true, updatedAt: 5_000, lastUserMessageAt: 4_000, name: "Session")],
hubUrl: "https://hub.example.com",
now: 5_000
)
try WidgetSnapshotStore.save(snapshot, to: directory)
#expect(WidgetSnapshotStore.load(from: directory) == snapshot)
}
@Test func pushUpdatesStatusAndTotals() throws {
let directory = FileManager.default.temporaryDirectory
.appendingPathComponent("WidgetSnapshotPush-\(UUID().uuidString)", isDirectory: true)
defer { try? FileManager.default.removeItem(at: directory) }
let initial = WidgetSnapshotBuilder.build(
sessions: [summary(id: "s1", thinking: true, updatedAt: 1_000, name: "Session")],
hubUrl: "https://hub.example.com",
now: 1_000
)
try WidgetSnapshotStore.save(initial, to: directory)
#expect(WidgetSnapshotStore.applyPush(
type: "permission-request", sessionId: "s1", sessionName: "Session", now: 2_000, in: directory
))
var updated = try #require(WidgetSnapshotStore.load(from: directory))
#expect(updated.sessions.first?.status == .needsApproval)
#expect(updated.sessions.first?.pendingCount == 1)
#expect(updated.sessions.first?.isUnread == true)
#expect(updated.runningCount == 0)
#expect(updated.needsApprovalCount == 1)
#expect(WidgetSnapshotStore.applyPush(
type: "ready", sessionId: "s1", sessionName: "Session", now: 3_000, in: directory
))
updated = try #require(WidgetSnapshotStore.load(from: directory))
#expect(updated.sessions.first?.status == .done)
#expect(updated.sessions.first?.pendingCount == 0)
#expect(updated.needsApprovalCount == 0)
#expect(WidgetSnapshotStore.applyPush(
type: "input-request", sessionId: "s2", sessionName: "New session", now: 4_000, in: directory
))
updated = try #require(WidgetSnapshotStore.load(from: directory))
#expect(updated.sessions.first?.id == "s2")
#expect(updated.sessions.first?.status == .needsInput)
#expect(updated.sessions.first?.isUnread == true)
#expect(updated.needsInputCount == 1)
#expect(!WidgetSnapshotStore.applyPush(
type: "unknown", sessionId: "s2", sessionName: nil, now: 5_000, in: directory
))
}
}