Files
hapi/ios/Packages/HapiKit/Sources/HapiClient/SSE/VisibilityReporter.swift
T
weishu eed3dddb94 feat(ios): composer, permission actions, session config (A-M3ab)
Interaction layer turning the read-only chat into a working remote control,
mirroring the merged Android B-M3ab feature-for-feature (web authority where
the ports disagreed):

- ChatInteractor (HapiClient, fully swift-test covered): optimistic composer
  sends (appendOptimistic -> POST -> status settle), queue-by-default with a
  long-press Send&Steer intent while a turn is active, tap-to-retry on failed
  rows (steer retries degrade to queue), per-session drafts
  (UserDefaultsChatDrafts, hub-scoped keys, debounced + flushed on close).
- session_inactive (409) recovery: one POST /resume (current permissionMode)
  then retry; a superseding session id seeds the new window
  (MessageWindowControllers.seed), migrates the draft, retargets the
  optimistic row and emits sessionSuperseded -- ChatView/HomeView replace the
  navigation entry in place.
- Queued bar: uninvoked sends in web sort order with Cancel (optimistic
  DELETE; invoked-race ingests the authoritative row as sent), Edit
  (cancel + composer prefill, newer-draft guard) and Steer (invoked answers
  reconcile a missed consume); single-flight per-row op guard.
  reconcileQueuedState now runs on chat open and on session-pipe gap.
- Permission actions: flavor-exact bodies mirroring PermissionFooter.tsx --
  claude {} / allowTools (Bash(cmd)) / mode:acceptEdits, codex-family
  decision approved / approved_for_session / abort via deny -- plus
  AskUserQuestion flat answers (option cards, Other free text, no-questions
  fallback, cursor stable ids) and request_user_input nested answers
  (user_note suffix, required validation); optimistic Resolving /
  AlreadyHandled (404/409) overrides settled by the agentState patch.
  ChatPipeline now re-attaches the window row's client status so failed
  user rows actually render the retry affordance (web normalize.ts parity;
  the Android reference misses this overlay).
- Session config sheet (toolbar gear): catalog-driven permission-mode picker
  with tones, claude static model/effort catalogs (ModelCatalog port), codex
  models via new GET /sessions/:id/codex-models endpoint + wire types with
  per-model reasoning efforts; optimistic detail updates
  (SessionListStore.updateDetailLocal, new) rolled forward to server truth
  on error.
- Lifecycle: VisibilityReporter posts POST /api/visibility per tracked
  handshake subscriptionId on scene-phase flips (404 prunes); ChatSession
  exposes its subscriptionId and feeds the reporter; the global SSE pipe was
  already HubSession-lifetime on iOS.
- Tests: ChatInteractorTests transcribes the Android interaction suite
  against the real APIClient/AuthManager/SessionListStore/window registry
  with only HTTP scripted -- canonical JSON bodies asserted byte-for-byte
  (send/approve/deny/config), optimistic send happy/fail/retry, 409 resume
  both id paths, cancel invoked-race, steer reconcile, edit prefill,
  override lifecycle, config optimistic + rollback, drafts, abort.
2026-08-18 10:33:04 +08:00

58 lines
2.6 KiB
Swift

import Foundation
import HapiProtocol
/// `POST /api/visibility` reporting (A-M3ab — the Android `VisibilityReporter`
/// twin): tracks the hub-minted subscription id of every live SSE pipe (fed
/// by ``onHandshake(key:subscriptionId:)`` from each pipe's handshake) and
/// reports foreground/background flips so the hub can suppress redundant push
/// notifications while the app is visibly connected.
///
/// Connect-time visibility already rides the SSE URL (`SSEClient` sends
/// `visibility=visible`), so only *transitions after connect* need a POST. A
/// `404` means the subscription died server-side — the entry is dropped (the
/// reconnect handshake re-registers a fresh id). Entries for closed pipes
/// self-heal the same way: the next flip 404s and prunes them.
@MainActor
public final class VisibilityReporter {
private let setVisibility: @Sendable (String, VisibilityState) async throws -> Void
private var subscriptionIds: [String: String] = [:]
private var foreground = true
public init(setVisibility: @escaping @Sendable (String, VisibilityState) async throws -> Void) {
self.setVisibility = setVisibility
}
/// Handshake hook: remember `subscriptionId` for the pipe identified by
/// `key` (e.g. `"global"`, `"session:<id>"`). Nil ids (older hubs) are
/// ignored.
public func onHandshake(key: String, subscriptionId: String?) {
guard let subscriptionId else { return }
subscriptionIds[key] = subscriptionId
}
/// Lifecycle input: report the flip to every tracked live subscription.
public func setForeground(_ isForeground: Bool) {
guard foreground != isForeground else { return }
foreground = isForeground
let visibility: VisibilityState = isForeground ? .visible : .hidden
let snapshot = subscriptionIds
let post = setVisibility
Task { [weak self] in
for (key, subscriptionId) in snapshot {
do {
try await post(subscriptionId, visibility)
} catch let error as APIError where error.status == 404 {
// Dead subscription — forget it unless a reconnect
// already stored a fresh id under the same key.
if let self, self.subscriptionIds[key] == subscriptionId {
self.subscriptionIds.removeValue(forKey: key)
}
} catch {
// Transient/offline — the next flip retries, and the
// reconnect handshake re-syncs connect-time visibility.
}
}
}
}
}