Files
hapi/ios/Packages/HapiKit/Sources/HapiProtocol/Catalog/ModelCatalog.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

138 lines
4.9 KiB
Swift

import Foundation
// Static model / effort catalogs — data port of `shared/src/models.ts`
// (`CLAUDE_MODEL_LABELS`) and `shared/src/effort.ts` (`CLAUDE_EFFORT_LABELS`),
// plus the composer option-list builders from
// `web/src/components/AssistantChat/claudeModelOptions.ts` /
// `claudeEffortOptions.ts` (mirroring the Android port's
// `core/protocol/.../catalog/Models.kt`). Codex-family model lists are NOT
// static — they come from `GET /api/sessions/:id/codex-models` per session.
/// `CLAUDE_MODEL_LABELS` / `CLAUDE_MODEL_PRESETS`.
public enum ClaudeModels {
/// Preset ids in declaration (picker) order.
public static let presets: [String] = [
"sonnet",
"sonnet[1m]",
"opus",
"opus[1m]",
"fable",
"fable[1m]",
]
private static let labels: [String: String] = [
"sonnet": "Sonnet",
"sonnet[1m]": "Sonnet 1M",
"opus": "Opus",
"opus[1m]": "Opus 1M",
"fable": "Fable",
"fable[1m]": "Fable 1M",
]
/// `getClaudeModelLabel`: trimmed lookup; unknown/blank → nil.
public static func label(for model: String?) -> String? {
let trimmed = model?.trimmingCharacters(in: .whitespaces) ?? ""
guard !trimmed.isEmpty else { return nil }
return labels[trimmed]
}
}
/// `CLAUDE_EFFORT_LABELS` / `CLAUDE_EFFORT_LEVELS`.
public enum ClaudeEfforts {
/// Levels in ascending order.
public static let levels: [String] = ["low", "medium", "high", "xhigh", "max"]
private static let labels: [String: String] = [
"low": "Low",
"medium": "Medium",
"high": "High",
"xhigh": "XHigh",
"max": "Max",
]
public static func label(for level: String) -> String? {
labels[level]
}
}
/// One picker row: `value == nil` means "clear back to the agent default"
/// (wire `model: null` / `effort: null`).
public struct CatalogOption: Equatable, Hashable, Sendable {
public let value: String?
public let label: String
public init(value: String?, label: String) {
self.value = value
self.label = label
}
}
/// Option-list builders for the session config sheet.
public enum ModelCatalog {
/// `normalizeClaudeComposerModel`: `auto`/`default`/blank collapse to nil
/// (the Default row).
public static func normalizeClaudeModel(_ model: String?) -> String? {
let trimmed = model?.trimmingCharacters(in: .whitespaces) ?? ""
if trimmed.isEmpty || trimmed == "auto" || trimmed == "default" {
return nil
}
return trimmed
}
/// `getClaudeComposerModelOptions`: Default first, then a synthetic row
/// for a current model outside the preset list, then the presets.
public static func claudeModelOptions(currentModel: String?) -> [CatalogOption] {
let normalized = normalizeClaudeModel(currentModel)
var options = [CatalogOption(value: nil, label: "Default")]
if let normalized, !ClaudeModels.presets.contains(normalized) {
options.append(CatalogOption(
value: normalized,
label: ClaudeModels.label(for: normalized) ?? normalized
))
}
for preset in ClaudeModels.presets {
options.append(CatalogOption(
value: preset,
label: ClaudeModels.label(for: preset) ?? preset
))
}
return options
}
/// `normalizeClaudeComposerEffort`: lowercased; `auto`/`default`/blank → nil.
public static func normalizeClaudeEffort(_ effort: String?) -> String? {
let trimmed = effort?.trimmingCharacters(in: .whitespaces).lowercased() ?? ""
if trimmed.isEmpty || trimmed == "auto" || trimmed == "default" {
return nil
}
return trimmed
}
/// `getClaudeComposerEffortOptions`: Auto first, synthetic current, then
/// the levels.
public static func claudeEffortOptions(currentEffort: String?) -> [CatalogOption] {
let normalized = normalizeClaudeEffort(currentEffort)
var options = [CatalogOption(value: nil, label: "Auto")]
if let normalized, !ClaudeEfforts.levels.contains(normalized) {
options.append(CatalogOption(
value: normalized,
label: ClaudeEfforts.label(for: normalized) ?? capitalizedFirst(normalized)
))
}
for level in ClaudeEfforts.levels {
options.append(CatalogOption(
value: level,
label: ClaudeEfforts.label(for: level) ?? capitalizedFirst(level)
))
}
return options
}
/// Kotlin `replaceFirstChar { uppercase }` twin, shared with the codex
/// effort rows built from wire level ids.
public static func capitalizedFirst(_ value: String) -> String {
guard let first = value.first else { return value }
return first.uppercased() + value.dropFirst()
}
}