mirror of
https://github.com/awizemann/scarf.git
synced 2026-05-10 18:44:45 +00:00
Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 4757b5ae49 |
@@ -173,10 +173,6 @@ v0.10.0 introduced the **Tool Gateway** — paid Nous Portal subscribers route w
|
|||||||
|
|
||||||
**Keep `ModelCatalogService.overlayOnlyProviders` in sync** with `HERMES_OVERLAYS` in `~/.hermes/hermes-agent/hermes_cli/providers.py`. When Hermes adds a new overlay-only provider, mirror the entry (display name, base URL, auth type, subscription-gated flag, doc URL) or the picker won't reach it.
|
**Keep `ModelCatalogService.overlayOnlyProviders` in sync** with `HERMES_OVERLAYS` in `~/.hermes/hermes-agent/hermes_cli/providers.py`. When Hermes adds a new overlay-only provider, mirror the entry (display name, base URL, auth type, subscription-gated flag, doc URL) or the picker won't reach it.
|
||||||
|
|
||||||
**Keep `ModelCatalogService.modelAliases` in sync** with Hermes's deprecated-model-ID map (currently release-notes-only upstream; the canonical successor lives in `hermes_cli/providers.py` if/when upstream tracks it in code). Drift here means a user's old model ID stops resolving in the picker even though Hermes still accepts it at runtime.
|
|
||||||
|
|
||||||
**Keep `ModelCatalogService.demotedProviders` in sync** with the deprioritized-provider list in `hermes-agent/hermes_cli/providers.py`. Drift means Vercel AI Gateway (or any future demoted provider) sorts in the wrong position in Scarf's picker.
|
|
||||||
|
|
||||||
## Kanban v3: drag-and-drop board + per-project tenants (v2.7.5)
|
## Kanban v3: drag-and-drop board + per-project tenants (v2.7.5)
|
||||||
|
|
||||||
Scarf v2.7.5 promotes Kanban from a read-only list to a full board with drag-and-drop, every Hermes write verb wired up, and per-project boards bound to a Scarf-minted tenant slug. The list view is preserved as a `Board | List` toggle for accessibility / narrow-window fallback.
|
Scarf v2.7.5 promotes Kanban from a read-only list to a full board with drag-and-drop, every Hermes write verb wired up, and per-project boards bound to a Scarf-minted tenant slug. The list view is preserved as a `Board | List` toggle for accessibility / narrow-window fallback.
|
||||||
|
|||||||
@@ -0,0 +1,34 @@
|
|||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// Errors thrown by `CuratorService`. Each case carries enough detail
|
||||||
|
/// to render a user-actionable message — the view model surfaces these
|
||||||
|
/// inline as a banner above the leaderboard rather than blocking with a
|
||||||
|
/// modal alert.
|
||||||
|
public enum CuratorError: Error, LocalizedError, Sendable {
|
||||||
|
/// `hermes` binary couldn't be located.
|
||||||
|
case cliMissing
|
||||||
|
/// Subprocess returned non-zero exit. `stderr` may carry a synthetic
|
||||||
|
/// message when the transport itself failed.
|
||||||
|
case nonZeroExit(verb: String, code: Int32, stderr: String)
|
||||||
|
/// JSON decoding failed. Underlying message wrapped for diagnostics.
|
||||||
|
case decoding(verb: String, message: String)
|
||||||
|
/// Generic transport error — process couldn't start, IO failed, etc.
|
||||||
|
case transport(message: String)
|
||||||
|
|
||||||
|
public var errorDescription: String? {
|
||||||
|
switch self {
|
||||||
|
case .cliMissing:
|
||||||
|
return "Hermes CLI couldn't be found. Install Hermes v0.13+ and ensure it's on your PATH."
|
||||||
|
case .nonZeroExit(let verb, let code, let stderr):
|
||||||
|
let trimmed = stderr.trimmingCharacters(in: .whitespacesAndNewlines)
|
||||||
|
if trimmed.isEmpty {
|
||||||
|
return "`hermes curator \(verb)` exited with code \(code)."
|
||||||
|
}
|
||||||
|
return trimmed
|
||||||
|
case .decoding(let verb, let message):
|
||||||
|
return "Couldn't decode `hermes curator \(verb)` output: \(message)"
|
||||||
|
case .transport(let message):
|
||||||
|
return message
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -667,27 +667,6 @@ public struct HermesConfig: Sendable {
|
|||||||
/// useful for cost auditing and screen-recording demos.
|
/// useful for cost auditing and screen-recording demos.
|
||||||
public var runtimeMetadataFooter: Bool
|
public var runtimeMetadataFooter: Bool
|
||||||
|
|
||||||
// -- Hermes v0.13 additions ----------------------------------------
|
|
||||||
|
|
||||||
/// `image_gen.model` (v0.13+) — overrides the per-provider default
|
|
||||||
/// image-gen model. Empty string means "let Hermes pick the
|
|
||||||
/// provider default". Hermes v0.12 advertised this key but ignored
|
|
||||||
/// it; Scarf's `AuxiliaryTab` only renders the picker when
|
|
||||||
/// `HermesCapabilities.hasImageGenModel` is `true`.
|
|
||||||
public var imageGenModel: String
|
|
||||||
|
|
||||||
/// `openrouter.response_cache.enabled` (v0.13+) — when true, Hermes
|
|
||||||
/// asks OpenRouter to cache responses for repeat prompts within a
|
|
||||||
/// session. Off by default in Scarf's parser per WS-6 plan
|
|
||||||
/// recommendation. UI gated on
|
|
||||||
/// `HermesCapabilities.hasOpenRouterResponseCache`.
|
|
||||||
// TODO(WS-6-Q1): the exact YAML key shape is provisional. Verify
|
|
||||||
// against a v0.13 host's `hermes config check` output before
|
|
||||||
// shipping (see WS-6-plan §Open Questions #1). Candidate alternative
|
|
||||||
// shapes: `providers.openrouter.response_cache_enabled` or
|
|
||||||
// `prompt_caching.openrouter.enabled`.
|
|
||||||
public var openrouterResponseCacheEnabled: Bool
|
|
||||||
|
|
||||||
// Grouped blocks
|
// Grouped blocks
|
||||||
public var display: DisplaySettings
|
public var display: DisplaySettings
|
||||||
public var terminal: TerminalSettings
|
public var terminal: TerminalSettings
|
||||||
@@ -768,15 +747,11 @@ public struct HermesConfig: Sendable {
|
|||||||
homeAssistant: HomeAssistantSettings,
|
homeAssistant: HomeAssistantSettings,
|
||||||
cacheTTL: String = "5m",
|
cacheTTL: String = "5m",
|
||||||
redactionEnabled: Bool = false,
|
redactionEnabled: Bool = false,
|
||||||
runtimeMetadataFooter: Bool = false,
|
runtimeMetadataFooter: Bool = false
|
||||||
imageGenModel: String = "",
|
|
||||||
openrouterResponseCacheEnabled: Bool = false
|
|
||||||
) {
|
) {
|
||||||
self.cacheTTL = cacheTTL
|
self.cacheTTL = cacheTTL
|
||||||
self.redactionEnabled = redactionEnabled
|
self.redactionEnabled = redactionEnabled
|
||||||
self.runtimeMetadataFooter = runtimeMetadataFooter
|
self.runtimeMetadataFooter = runtimeMetadataFooter
|
||||||
self.imageGenModel = imageGenModel
|
|
||||||
self.openrouterResponseCacheEnabled = openrouterResponseCacheEnabled
|
|
||||||
self.model = model
|
self.model = model
|
||||||
self.provider = provider
|
self.provider = provider
|
||||||
self.maxTurns = maxTurns
|
self.maxTurns = maxTurns
|
||||||
|
|||||||
@@ -0,0 +1,124 @@
|
|||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// One entry in the `hermes curator list-archived` output. Decoded
|
||||||
|
/// tolerantly via `decodeIfPresent` so a stripped-down host (or a future
|
||||||
|
/// Hermes that drops one of the optional columns) doesn't crash the view.
|
||||||
|
///
|
||||||
|
/// Only `name` is required — every other field is optional and the
|
||||||
|
/// computed `*Label` accessors render `"—"` for missing values.
|
||||||
|
public struct HermesCuratorArchivedSkill: Sendable, Equatable, Identifiable, Codable {
|
||||||
|
public var id: String { name }
|
||||||
|
public let name: String
|
||||||
|
public let category: String?
|
||||||
|
public let archivedAt: String?
|
||||||
|
public let reason: String?
|
||||||
|
public let sizeBytes: Int?
|
||||||
|
public let path: String?
|
||||||
|
|
||||||
|
public init(
|
||||||
|
name: String,
|
||||||
|
category: String? = nil,
|
||||||
|
archivedAt: String? = nil,
|
||||||
|
reason: String? = nil,
|
||||||
|
sizeBytes: Int? = nil,
|
||||||
|
path: String? = nil
|
||||||
|
) {
|
||||||
|
self.name = name
|
||||||
|
self.category = category
|
||||||
|
self.archivedAt = archivedAt
|
||||||
|
self.reason = reason
|
||||||
|
self.sizeBytes = sizeBytes
|
||||||
|
self.path = path
|
||||||
|
}
|
||||||
|
|
||||||
|
private enum CodingKeys: String, CodingKey {
|
||||||
|
case name
|
||||||
|
case category
|
||||||
|
case archivedAt = "archived_at"
|
||||||
|
case reason
|
||||||
|
case sizeBytes = "size_bytes"
|
||||||
|
case path
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(from decoder: Decoder) throws {
|
||||||
|
let c = try decoder.container(keyedBy: CodingKeys.self)
|
||||||
|
self.name = try c.decode(String.self, forKey: .name)
|
||||||
|
self.category = try c.decodeIfPresent(String.self, forKey: .category)
|
||||||
|
self.archivedAt = try c.decodeIfPresent(String.self, forKey: .archivedAt)
|
||||||
|
self.reason = try c.decodeIfPresent(String.self, forKey: .reason)
|
||||||
|
self.sizeBytes = try c.decodeIfPresent(Int.self, forKey: .sizeBytes)
|
||||||
|
self.path = try c.decodeIfPresent(String.self, forKey: .path)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func encode(to encoder: Encoder) throws {
|
||||||
|
var c = encoder.container(keyedBy: CodingKeys.self)
|
||||||
|
try c.encode(name, forKey: .name)
|
||||||
|
try c.encodeIfPresent(category, forKey: .category)
|
||||||
|
try c.encodeIfPresent(archivedAt, forKey: .archivedAt)
|
||||||
|
try c.encodeIfPresent(reason, forKey: .reason)
|
||||||
|
try c.encodeIfPresent(sizeBytes, forKey: .sizeBytes)
|
||||||
|
try c.encodeIfPresent(path, forKey: .path)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// "4.4 KB" / "1.2 MB" / "—" for nil. Uses the SI byte formatter so
|
||||||
|
/// the labels match what Finder shows.
|
||||||
|
public var sizeLabel: String {
|
||||||
|
guard let bytes = sizeBytes else { return "—" }
|
||||||
|
let formatter = ByteCountFormatter()
|
||||||
|
formatter.allowedUnits = [.useAll]
|
||||||
|
formatter.countStyle = .file
|
||||||
|
return formatter.string(fromByteCount: Int64(bytes))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// `2026-04-22` (ISO date prefix) / "—". Hermes returns full ISO
|
||||||
|
/// timestamps with seconds + Z; the date prefix is what the user
|
||||||
|
/// actually wants in the archived list.
|
||||||
|
public var archivedAtLabel: String {
|
||||||
|
guard let iso = archivedAt, !iso.isEmpty else { return "—" }
|
||||||
|
// Trim to date prefix if it looks like a full ISO timestamp.
|
||||||
|
if let tIdx = iso.firstIndex(of: "T") {
|
||||||
|
return String(iso[..<tIdx])
|
||||||
|
}
|
||||||
|
return iso
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Result of `hermes curator prune --dry-run` — what would be removed
|
||||||
|
/// if the user confirms. The view derives `totalCount` from
|
||||||
|
/// `wouldRemove.count` so the wire shape stays flat.
|
||||||
|
public struct CuratorPruneSummary: Sendable, Equatable, Codable {
|
||||||
|
public let wouldRemove: [HermesCuratorArchivedSkill]
|
||||||
|
public let totalBytes: Int
|
||||||
|
public var totalCount: Int { wouldRemove.count }
|
||||||
|
|
||||||
|
public init(wouldRemove: [HermesCuratorArchivedSkill], totalBytes: Int) {
|
||||||
|
self.wouldRemove = wouldRemove
|
||||||
|
self.totalBytes = totalBytes
|
||||||
|
}
|
||||||
|
|
||||||
|
private enum CodingKeys: String, CodingKey {
|
||||||
|
case wouldRemove = "would_remove"
|
||||||
|
case totalBytes = "total_bytes"
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(from decoder: Decoder) throws {
|
||||||
|
let c = try decoder.container(keyedBy: CodingKeys.self)
|
||||||
|
self.wouldRemove = try c.decodeIfPresent([HermesCuratorArchivedSkill].self, forKey: .wouldRemove) ?? []
|
||||||
|
self.totalBytes = try c.decodeIfPresent(Int.self, forKey: .totalBytes) ?? 0
|
||||||
|
}
|
||||||
|
|
||||||
|
public func encode(to encoder: Encoder) throws {
|
||||||
|
var c = encoder.container(keyedBy: CodingKeys.self)
|
||||||
|
try c.encode(wouldRemove, forKey: .wouldRemove)
|
||||||
|
try c.encode(totalBytes, forKey: .totalBytes)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// "12.3 KB" / "—" for empty. Convenience for the confirm sheet header.
|
||||||
|
public var totalBytesLabel: String {
|
||||||
|
guard totalBytes > 0 else { return "—" }
|
||||||
|
let formatter = ByteCountFormatter()
|
||||||
|
formatter.allowedUnits = [.useAll]
|
||||||
|
formatter.countStyle = .file
|
||||||
|
return formatter.string(fromByteCount: Int64(totalBytes))
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -284,18 +284,7 @@ public extension HermesConfig {
|
|||||||
homeAssistant: homeAssistant,
|
homeAssistant: homeAssistant,
|
||||||
cacheTTL: str("prompt_caching.cache_ttl", default: "5m"),
|
cacheTTL: str("prompt_caching.cache_ttl", default: "5m"),
|
||||||
redactionEnabled: bool("redaction.enabled", default: false),
|
redactionEnabled: bool("redaction.enabled", default: false),
|
||||||
runtimeMetadataFooter: bool("agent.runtime_metadata_footer", default: false),
|
runtimeMetadataFooter: bool("agent.runtime_metadata_footer", default: false)
|
||||||
// -- v0.13 additions -------------------------------------
|
|
||||||
// TODO(WS-6-Q1): the `openrouter.response_cache.enabled`
|
|
||||||
// key shape is provisional pending verification against a
|
|
||||||
// v0.13 `hermes config check`. If upstream uses a different
|
|
||||||
// path (e.g. `providers.openrouter.response_cache_enabled`
|
|
||||||
// or nested under `prompt_caching`), update this single
|
|
||||||
// line + the matching `setSetting` key in
|
|
||||||
// `SettingsViewModel.setOpenRouterResponseCache`. Default
|
|
||||||
// is `false` per WS-6-plan §Open Questions #2.
|
|
||||||
imageGenModel: str("image_gen.model", default: ""),
|
|
||||||
openrouterResponseCacheEnabled: bool("openrouter.response_cache.enabled", default: false)
|
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,358 @@
|
|||||||
|
import Foundation
|
||||||
|
#if canImport(os)
|
||||||
|
import os
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Async, transport-aware client for `hermes curator …`. Wraps the v0.12
|
||||||
|
/// verbs (`status / run / pause / resume / pin / unpin / restore`) plus
|
||||||
|
/// the v0.13 archive surface (`archive / prune / list-archived` and a
|
||||||
|
/// synchronous-blocking `run`).
|
||||||
|
///
|
||||||
|
/// **Concurrency.** Pure-I/O `actor` — no UI state. View models hold a
|
||||||
|
/// service reference and `await` methods. Each public method dispatches
|
||||||
|
/// the underlying CLI invocation through `Task.detached(priority:
|
||||||
|
/// .utility)` so two concurrent reads from the VM don't queue end-to-end
|
||||||
|
/// on a single thread. Mirrors `KanbanService` shape exactly.
|
||||||
|
///
|
||||||
|
/// **Capability gating happens at the call site, not in the service.**
|
||||||
|
/// `runNow(synchronous:timeout:)` takes a flag from the VM (the VM reads
|
||||||
|
/// `HermesCapabilities.hasCuratorArchive` to decide). The service stays
|
||||||
|
/// version-agnostic — only the timeout differs in practice.
|
||||||
|
public actor CuratorService {
|
||||||
|
#if canImport(os)
|
||||||
|
private static let logger = Logger(subsystem: "com.scarf", category: "CuratorService")
|
||||||
|
#endif
|
||||||
|
|
||||||
|
private let context: ServerContext
|
||||||
|
|
||||||
|
public init(context: ServerContext) {
|
||||||
|
self.context = context
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - Reads
|
||||||
|
|
||||||
|
/// Run `hermes curator status` and parse stdout via
|
||||||
|
/// `HermesCuratorStatusParser`. Combines the text output with the
|
||||||
|
/// on-disk `.curator_state` JSON for richer last-run metadata.
|
||||||
|
/// Never throws — a transport failure resolves to `.empty` so the
|
||||||
|
/// view always has something to render.
|
||||||
|
public func status() async -> HermesCuratorStatus {
|
||||||
|
let context = self.context
|
||||||
|
return await Task.detached(priority: .utility) { () -> HermesCuratorStatus in
|
||||||
|
let textResult = Self.runHermesSync(context: context, args: ["curator", "status"], timeout: 30)
|
||||||
|
let stateData = context.readData(context.paths.curatorStateFile)
|
||||||
|
return HermesCuratorStatusParser.parse(text: textResult.output, stateFileJSON: stateData)
|
||||||
|
}.value
|
||||||
|
}
|
||||||
|
|
||||||
|
/// `hermes curator list-archived [--json]`. Prefers JSON; falls back
|
||||||
|
/// to a defensive text parser. Empty / "no archived skills" sentinel
|
||||||
|
/// folds to `[]`.
|
||||||
|
public func listArchived() async throws -> [HermesCuratorArchivedSkill] {
|
||||||
|
// TODO(WS-4-Q2): confirm `--json` is supported on v0.13
|
||||||
|
// `list-archived`. If not, drop the flag and rely on the text
|
||||||
|
// parser path. Until then we pass `--json` and parse the output
|
||||||
|
// tolerantly.
|
||||||
|
let args = ["curator", "list-archived", "--json"]
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: args, timeout: 30)
|
||||||
|
|
||||||
|
// If --json isn't recognized, the CLI typically emits
|
||||||
|
// "unrecognized arguments: --json" or similar to stderr and
|
||||||
|
// exits non-zero. Retry without the flag and parse text.
|
||||||
|
if code != 0 {
|
||||||
|
let lower = (stderr + stdout).lowercased()
|
||||||
|
if lower.contains("unrecognized") || lower.contains("unknown") || lower.contains("no such option") {
|
||||||
|
let (c2, out2, err2) = await runHermes(args: ["curator", "list-archived"], timeout: 30)
|
||||||
|
try ensureSuccess(code: c2, stdout: out2, stderr: err2, verb: "list-archived")
|
||||||
|
return Self.parseListArchivedText(out2)
|
||||||
|
}
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "list-archived")
|
||||||
|
}
|
||||||
|
|
||||||
|
let trimmed = stdout.trimmingCharacters(in: .whitespacesAndNewlines)
|
||||||
|
if trimmed.isEmpty || trimmed.lowercased().contains("no archived skills") {
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
// Try JSON first — may also be a text dump if Hermes ignored `--json`.
|
||||||
|
if let data = trimmed.data(using: .utf8),
|
||||||
|
let arr = try? JSONDecoder().decode([HermesCuratorArchivedSkill].self, from: data) {
|
||||||
|
return arr
|
||||||
|
}
|
||||||
|
// Some builds wrap in `{"archived": [...]}` envelope.
|
||||||
|
struct Wrapper: Decodable { let archived: [HermesCuratorArchivedSkill] }
|
||||||
|
if let data = trimmed.data(using: .utf8),
|
||||||
|
let wrapped = try? JSONDecoder().decode(Wrapper.self, from: data) {
|
||||||
|
return wrapped.archived
|
||||||
|
}
|
||||||
|
// Text fallback — defensive parse.
|
||||||
|
return Self.parseListArchivedText(stdout)
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - Writes (legacy v0.12 verbs; service form)
|
||||||
|
|
||||||
|
public func runNow(synchronous: Bool, timeout: TimeInterval) async throws {
|
||||||
|
// TODO(WS-4-Q4): default 600s for v0.13 sync runs. No Cancel
|
||||||
|
// button in v2.8 (transport.cancel parity not guaranteed across
|
||||||
|
// LocalTransport / SSHTransport).
|
||||||
|
let resolvedTimeout = synchronous ? timeout : 30
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: ["curator", "run"], timeout: resolvedTimeout)
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "run")
|
||||||
|
}
|
||||||
|
|
||||||
|
public func pause() async throws {
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: ["curator", "pause"], timeout: 15)
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "pause")
|
||||||
|
}
|
||||||
|
|
||||||
|
public func resume() async throws {
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: ["curator", "resume"], timeout: 15)
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "resume")
|
||||||
|
}
|
||||||
|
|
||||||
|
public func pin(_ name: String) async throws {
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: ["curator", "pin", name], timeout: 15)
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "pin")
|
||||||
|
}
|
||||||
|
|
||||||
|
public func unpin(_ name: String) async throws {
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: ["curator", "unpin", name], timeout: 15)
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "unpin")
|
||||||
|
}
|
||||||
|
|
||||||
|
public func restore(_ name: String) async throws {
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: ["curator", "restore", name], timeout: 30)
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "restore")
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - Writes (new in v0.13)
|
||||||
|
|
||||||
|
/// `hermes curator archive <name>` — non-destructive; moves the
|
||||||
|
/// skill from the active set to the archived set. No `--json` is
|
||||||
|
/// expected; the verb's success channel is the exit code.
|
||||||
|
public func archive(_ name: String) async throws {
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: ["curator", "archive", name], timeout: 30)
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "archive")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// `hermes curator prune [--dry-run]`. Destructive when `dryRun`
|
||||||
|
/// is `false` — removes everything currently archived from disk.
|
||||||
|
/// Returns a `CuratorPruneSummary` describing what was (or would be)
|
||||||
|
/// removed. On `dryRun=false`, the wire shape may not include the
|
||||||
|
/// `would_remove` list — the caller should not depend on it; the
|
||||||
|
/// archived list is empty after a successful destructive prune.
|
||||||
|
@discardableResult
|
||||||
|
public func prune(dryRun: Bool) async throws -> CuratorPruneSummary {
|
||||||
|
// TODO(WS-4-Q1): confirm v0.13 ships `--dry-run`. If not, fall
|
||||||
|
// back to enumerating via `list-archived` and treat any prune
|
||||||
|
// call as destructive. The retry-without-flag path below covers
|
||||||
|
// the "unrecognized argument" case automatically.
|
||||||
|
var args = ["curator", "prune"]
|
||||||
|
if dryRun { args.append("--dry-run") }
|
||||||
|
// `--json` requested for the dry-run path so we can parse the
|
||||||
|
// would-remove list. Destructive mode runs without --json since
|
||||||
|
// we only need the exit code.
|
||||||
|
if dryRun { args.append("--json") }
|
||||||
|
|
||||||
|
let (code, stdout, stderr) = await runHermes(args: args, timeout: 60)
|
||||||
|
|
||||||
|
// Detect "unrecognized --dry-run" / "unknown --json" gracefully.
|
||||||
|
if code != 0 {
|
||||||
|
let lower = (stderr + stdout).lowercased()
|
||||||
|
let unrecognized = lower.contains("unrecognized") || lower.contains("unknown") || lower.contains("no such option")
|
||||||
|
if dryRun && unrecognized {
|
||||||
|
// Q1 fallback: enumerate via list-archived. Caller still
|
||||||
|
// uses this summary for confirm-sheet display.
|
||||||
|
let archived = try await listArchived()
|
||||||
|
let total = archived.compactMap { $0.sizeBytes }.reduce(0, +)
|
||||||
|
return CuratorPruneSummary(wouldRemove: archived, totalBytes: total)
|
||||||
|
}
|
||||||
|
try ensureSuccess(code: code, stdout: stdout, stderr: stderr, verb: "prune")
|
||||||
|
}
|
||||||
|
|
||||||
|
if dryRun {
|
||||||
|
return Self.parsePruneDryRun(stdout)
|
||||||
|
}
|
||||||
|
return CuratorPruneSummary(wouldRemove: [], totalBytes: 0)
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - Pure parsers (nonisolated; safe to call from VMs without awaits)
|
||||||
|
|
||||||
|
/// Parse a `list-archived --json` payload. Tolerates the bare-array
|
||||||
|
/// shape, the `{"archived": [...]}` envelope, and "no archived
|
||||||
|
/// skills" / empty-string sentinels. Returns `[]` for any of the
|
||||||
|
/// empty cases. Throws `CuratorError.decoding` only when the input
|
||||||
|
/// is non-empty and clearly not JSON.
|
||||||
|
public nonisolated static func parseListArchived(stdout: String) throws -> [HermesCuratorArchivedSkill] {
|
||||||
|
let trimmed = stdout.trimmingCharacters(in: .whitespacesAndNewlines)
|
||||||
|
if trimmed.isEmpty || trimmed.lowercased().contains("no archived skills") {
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
guard let data = trimmed.data(using: .utf8) else {
|
||||||
|
throw CuratorError.decoding(verb: "list-archived", message: "non-UTF8 stdout")
|
||||||
|
}
|
||||||
|
if let arr = try? JSONDecoder().decode([HermesCuratorArchivedSkill].self, from: data) {
|
||||||
|
return arr
|
||||||
|
}
|
||||||
|
struct Wrapper: Decodable { let archived: [HermesCuratorArchivedSkill] }
|
||||||
|
if let wrapped = try? JSONDecoder().decode(Wrapper.self, from: data) {
|
||||||
|
return wrapped.archived
|
||||||
|
}
|
||||||
|
// Last resort: text fallback.
|
||||||
|
let parsed = parseListArchivedText(stdout)
|
||||||
|
if !parsed.isEmpty {
|
||||||
|
return parsed
|
||||||
|
}
|
||||||
|
throw CuratorError.decoding(verb: "list-archived", message: "stdout was neither JSON nor a recognised text list")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Defensive text parser for `list-archived` output when `--json`
|
||||||
|
/// isn't supported. Format inferred from `curator status`: one row
|
||||||
|
/// per non-blank line, leading whitespace, name in column 1, then
|
||||||
|
/// optional `archived=YYYY-MM-DD`, `size=NNNN`, `reason=...` k/v
|
||||||
|
/// pairs. Blank lines, header lines, and the empty-state sentinel
|
||||||
|
/// are skipped.
|
||||||
|
public nonisolated static func parseListArchivedText(_ text: String) -> [HermesCuratorArchivedSkill] {
|
||||||
|
var rows: [HermesCuratorArchivedSkill] = []
|
||||||
|
for raw in text.split(separator: "\n") {
|
||||||
|
let line = raw.trimmingCharacters(in: .whitespaces)
|
||||||
|
if line.isEmpty { continue }
|
||||||
|
let lower = line.lowercased()
|
||||||
|
// Skip header / sentinel lines.
|
||||||
|
if lower.hasPrefix("name") && lower.contains("archived") { continue }
|
||||||
|
if lower.contains("no archived skills") { continue }
|
||||||
|
if line.unicodeScalars.allSatisfy({ $0.value == 0x2500 || $0.properties.isWhitespace }) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
// Skip lines that look like JSON / non-row chrome — `{`,
|
||||||
|
// `}`, `[`, `]` at the start or quotes / colons mean we're
|
||||||
|
// parsing a malformed JSON dump, not a row table.
|
||||||
|
if let first = line.first, "{[}]\":,".contains(first) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
// Find the first whitespace-separated token as the name; if
|
||||||
|
// the name carries an `=` it's a header chip we should skip.
|
||||||
|
let parts = line.split(whereSeparator: { $0 == "\t" || $0 == " " }).map(String.init)
|
||||||
|
guard let name = parts.first, !name.contains("=") else { continue }
|
||||||
|
// Reject names that look like punctuation / JSON fragments.
|
||||||
|
if name.contains("\"") || name.contains(":") || name.contains("{") || name.contains("}") || name.contains("[") || name.contains("]") {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
// Pull k=v pairs from the remainder.
|
||||||
|
var archivedAt: String?
|
||||||
|
var sizeBytes: Int?
|
||||||
|
var reason: String?
|
||||||
|
var category: String?
|
||||||
|
var path: String?
|
||||||
|
for token in parts.dropFirst() {
|
||||||
|
guard let eq = token.firstIndex(of: "=") else { continue }
|
||||||
|
let key = String(token[..<eq])
|
||||||
|
let value = String(token[token.index(after: eq)...])
|
||||||
|
switch key {
|
||||||
|
case "archived", "archived_at":
|
||||||
|
archivedAt = value
|
||||||
|
case "size", "size_bytes":
|
||||||
|
sizeBytes = Int(value)
|
||||||
|
case "reason":
|
||||||
|
reason = value
|
||||||
|
case "category":
|
||||||
|
category = value
|
||||||
|
case "path":
|
||||||
|
path = value
|
||||||
|
default:
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
rows.append(
|
||||||
|
HermesCuratorArchivedSkill(
|
||||||
|
name: name,
|
||||||
|
category: category,
|
||||||
|
archivedAt: archivedAt,
|
||||||
|
reason: reason,
|
||||||
|
sizeBytes: sizeBytes,
|
||||||
|
path: path
|
||||||
|
)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return rows
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Parse a `prune --dry-run --json` payload. Tolerates an empty
|
||||||
|
/// payload (returns a zero summary) and the `{would_remove: [],
|
||||||
|
/// total_bytes: N}` shape.
|
||||||
|
public nonisolated static func parsePruneDryRun(_ stdout: String) -> CuratorPruneSummary {
|
||||||
|
let trimmed = stdout.trimmingCharacters(in: .whitespacesAndNewlines)
|
||||||
|
guard !trimmed.isEmpty else {
|
||||||
|
return CuratorPruneSummary(wouldRemove: [], totalBytes: 0)
|
||||||
|
}
|
||||||
|
if let data = trimmed.data(using: .utf8),
|
||||||
|
let summary = try? JSONDecoder().decode(CuratorPruneSummary.self, from: data) {
|
||||||
|
return summary
|
||||||
|
}
|
||||||
|
// Tolerate a bare-array fallback (some Hermes builds may print
|
||||||
|
// just the would-remove list when --json is missing the wrapper).
|
||||||
|
if let data = trimmed.data(using: .utf8),
|
||||||
|
let arr = try? JSONDecoder().decode([HermesCuratorArchivedSkill].self, from: data) {
|
||||||
|
let total = arr.compactMap { $0.sizeBytes }.reduce(0, +)
|
||||||
|
return CuratorPruneSummary(wouldRemove: arr, totalBytes: total)
|
||||||
|
}
|
||||||
|
// Last-resort text parse for "would remove N skills (X bytes)".
|
||||||
|
return CuratorPruneSummary(wouldRemove: [], totalBytes: 0)
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - CLI invocation
|
||||||
|
|
||||||
|
private nonisolated func runHermes(
|
||||||
|
args: [String],
|
||||||
|
timeout: TimeInterval
|
||||||
|
) async -> (exitCode: Int32, stdout: String, stderr: String) {
|
||||||
|
let context = self.context
|
||||||
|
return await Task.detached(priority: .utility) { () -> (Int32, String, String) in
|
||||||
|
let result = Self.runHermesSync(context: context, args: args, timeout: timeout)
|
||||||
|
return (result.exitCode, result.output, result.stderr)
|
||||||
|
}.value
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Synchronous, transport-level invocation. `output` is stdout; the
|
||||||
|
/// caller usually only reads `output` for parser input but sometimes
|
||||||
|
/// needs `stderr` (e.g. to detect "unrecognized argument" patterns).
|
||||||
|
private nonisolated static func runHermesSync(
|
||||||
|
context: ServerContext,
|
||||||
|
args: [String],
|
||||||
|
timeout: TimeInterval
|
||||||
|
) -> (exitCode: Int32, output: String, stderr: String) {
|
||||||
|
let transport = context.makeTransport()
|
||||||
|
do {
|
||||||
|
let result = try transport.runProcess(
|
||||||
|
executable: context.paths.hermesBinary,
|
||||||
|
args: args,
|
||||||
|
stdin: nil,
|
||||||
|
timeout: timeout
|
||||||
|
)
|
||||||
|
return (result.exitCode, result.stdoutString, result.stderrString)
|
||||||
|
} catch let error as TransportError {
|
||||||
|
let message = error.diagnosticStderr.isEmpty
|
||||||
|
? (error.errorDescription ?? "transport error")
|
||||||
|
: error.diagnosticStderr
|
||||||
|
return (-1, "", message)
|
||||||
|
} catch {
|
||||||
|
return (-1, "", error.localizedDescription)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private nonisolated func ensureSuccess(
|
||||||
|
code: Int32,
|
||||||
|
stdout: String,
|
||||||
|
stderr: String,
|
||||||
|
verb: String
|
||||||
|
) throws {
|
||||||
|
guard code != 0 else { return }
|
||||||
|
if code == -1 && stderr.lowercased().contains("hermes binary not found") {
|
||||||
|
throw CuratorError.cliMissing
|
||||||
|
}
|
||||||
|
let combined = stderr.isEmpty ? stdout : stderr
|
||||||
|
#if canImport(os)
|
||||||
|
Self.logger.warning("curator \(verb) exit=\(code, privacy: .public) stderr=\(combined, privacy: .public)")
|
||||||
|
#endif
|
||||||
|
throw CuratorError.nonZeroExit(verb: verb, code: code, stderr: combined)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -155,20 +155,9 @@ public struct ModelCatalogService: Sendable {
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
return byID.values.sorted { lhs, rhs in
|
return byID.values.sorted { lhs, rhs in
|
||||||
// Subscription-gated first (Nous Portal).
|
|
||||||
if lhs.subscriptionGated != rhs.subscriptionGated {
|
if lhs.subscriptionGated != rhs.subscriptionGated {
|
||||||
return lhs.subscriptionGated
|
return lhs.subscriptionGated
|
||||||
}
|
}
|
||||||
// Demoted last (Vercel AI Gateway, per Hermes v0.13). The
|
|
||||||
// axis is unconditional — we don't gate on the Hermes
|
|
||||||
// version because "Vercel mid-alphabet on v0.12, bottom on
|
|
||||||
// v0.13" would be more confusing than the consistent
|
|
||||||
// "Vercel last" treatment for everyone.
|
|
||||||
let lDemoted = Self.demotedProviders.contains(lhs.providerID)
|
|
||||||
let rDemoted = Self.demotedProviders.contains(rhs.providerID)
|
|
||||||
if lDemoted != rDemoted {
|
|
||||||
return !lDemoted
|
|
||||||
}
|
|
||||||
return lhs.providerName.localizedCaseInsensitiveCompare(rhs.providerName) == .orderedAscending
|
return lhs.providerName.localizedCaseInsensitiveCompare(rhs.providerName) == .orderedAscending
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -246,10 +235,7 @@ public struct ModelCatalogService: Sendable {
|
|||||||
public func provider(for modelID: String) -> HermesProviderInfo? {
|
public func provider(for modelID: String) -> HermesProviderInfo? {
|
||||||
guard let catalog = loadCatalog() else { return nil }
|
guard let catalog = loadCatalog() else { return nil }
|
||||||
for (providerID, p) in catalog {
|
for (providerID, p) in catalog {
|
||||||
// Resolve any model-rename alias for this provider before
|
if p.models?[modelID] != nil {
|
||||||
// checking the catalog — see `modelAliases` for rationale.
|
|
||||||
let resolved = resolveModelAlias(providerID: providerID, modelID: modelID)
|
|
||||||
if p.models?[resolved] != nil {
|
|
||||||
return HermesProviderInfo(
|
return HermesProviderInfo(
|
||||||
providerID: providerID,
|
providerID: providerID,
|
||||||
providerName: p.name ?? providerID,
|
providerName: p.name ?? providerID,
|
||||||
@@ -313,17 +299,14 @@ public struct ModelCatalogService: Sendable {
|
|||||||
/// Look up a specific model by provider + ID. Returns nil if not in the
|
/// Look up a specific model by provider + ID. Returns nil if not in the
|
||||||
/// catalog (e.g., free-typed custom model).
|
/// catalog (e.g., free-typed custom model).
|
||||||
public func model(providerID: String, modelID: String) -> HermesModelInfo? {
|
public func model(providerID: String, modelID: String) -> HermesModelInfo? {
|
||||||
// Resolve any model-rename alias for this provider before
|
|
||||||
// checking the catalog — see `modelAliases` for rationale.
|
|
||||||
let resolved = resolveModelAlias(providerID: providerID, modelID: modelID)
|
|
||||||
guard let catalog = loadCatalog(),
|
guard let catalog = loadCatalog(),
|
||||||
let provider = catalog[providerID],
|
let provider = catalog[providerID],
|
||||||
let raw = provider.models?[resolved] else { return nil }
|
let raw = provider.models?[modelID] else { return nil }
|
||||||
return HermesModelInfo(
|
return HermesModelInfo(
|
||||||
providerID: providerID,
|
providerID: providerID,
|
||||||
providerName: provider.name ?? providerID,
|
providerName: provider.name ?? providerID,
|
||||||
modelID: resolved,
|
modelID: modelID,
|
||||||
modelName: raw.name ?? resolved,
|
modelName: raw.name ?? modelID,
|
||||||
contextWindow: raw.limit?.context,
|
contextWindow: raw.limit?.context,
|
||||||
maxOutput: raw.limit?.output,
|
maxOutput: raw.limit?.output,
|
||||||
costInput: raw.cost?.input,
|
costInput: raw.cost?.input,
|
||||||
@@ -361,14 +344,10 @@ public struct ModelCatalogService: Sendable {
|
|||||||
/// HTTP 404 at runtime. Catch that at save time, not 6 hours later.
|
/// HTTP 404 at runtime. Catch that at save time, not 6 hours later.
|
||||||
public func validateModel(_ modelID: String, for providerID: String) -> ModelValidation {
|
public func validateModel(_ modelID: String, for providerID: String) -> ModelValidation {
|
||||||
ScarfMon.measure(.diskIO, "modelCatalog.validateModel") {
|
ScarfMon.measure(.diskIO, "modelCatalog.validateModel") {
|
||||||
let raw = modelID.trimmingCharacters(in: .whitespacesAndNewlines)
|
let trimmed = modelID.trimmingCharacters(in: .whitespacesAndNewlines)
|
||||||
guard !raw.isEmpty else {
|
guard !trimmed.isEmpty else {
|
||||||
return .invalid(providerName: providerID, suggestions: [])
|
return .invalid(providerName: providerID, suggestions: [])
|
||||||
}
|
}
|
||||||
// Resolve any model-rename alias before lookup so configs
|
|
||||||
// referencing a deprecated ID (e.g. `x-ai/grok-4.20-beta`)
|
|
||||||
// validate against the canonical successor.
|
|
||||||
let trimmed = resolveModelAlias(providerID: providerID, modelID: raw)
|
|
||||||
|
|
||||||
// Overlay-only providers (Nous Portal, OpenAI Codex, Qwen
|
// Overlay-only providers (Nous Portal, OpenAI Codex, Qwen
|
||||||
// OAuth, …) serve their own catalogs that aren't mirrored to
|
// OAuth, …) serve their own catalogs that aren't mirrored to
|
||||||
@@ -454,78 +433,6 @@ public struct ModelCatalogService: Sendable {
|
|||||||
let output: Int?
|
let output: Int?
|
||||||
}
|
}
|
||||||
|
|
||||||
// MARK: - Model aliases (model rename resolution)
|
|
||||||
|
|
||||||
/// Hermes deprecates model IDs across releases. When a stored config
|
|
||||||
/// `model.default` references a deprecated ID, resolve to its
|
|
||||||
/// canonical successor. Lossless — we never rewrite the user's
|
|
||||||
/// `config.yaml`; the alias just lets `validateModel` /
|
|
||||||
/// `model(providerID:modelID:)` / `provider(for:)` succeed against
|
|
||||||
/// the new ID.
|
|
||||||
///
|
|
||||||
/// Keys are slash-joined `providerID/modelID` to disambiguate
|
|
||||||
/// across providers — even if `vercel` later adds a `grok-4.20-beta`
|
|
||||||
/// alias on its own, the openrouter resolution shouldn't fire.
|
|
||||||
/// Values are the bare resolved model ID (no provider prefix).
|
|
||||||
///
|
|
||||||
/// **Schema is Swift-primary.** Mirror new entries into Hermes's
|
|
||||||
/// upstream deprecation map in `hermes_cli/providers.py` if/when
|
|
||||||
/// upstream tracks renames in code (today they're release-notes
|
|
||||||
/// only).
|
|
||||||
public static let modelAliases: [String: String] = [
|
|
||||||
// v0.13: x-ai dropped the `-beta` suffix once Grok 4.20 GA'd.
|
|
||||||
// The model is the same one served at the same OpenRouter slot;
|
|
||||||
// only the marketing identifier changed.
|
|
||||||
// TODO(WS-6-Q4): verify whether OpenRouter retired the
|
|
||||||
// `x-ai/grok-4.20-beta` slot entirely. Either way the alias is
|
|
||||||
// correct (cosmetic if old slot stays live, load-bearing if it
|
|
||||||
// 404s).
|
|
||||||
"openrouter/x-ai/grok-4.20-beta": "x-ai/grok-4.20",
|
|
||||||
"xai/grok-4.20-beta": "grok-4.20",
|
|
||||||
"vercel/xai/grok-4.20-beta": "xai/grok-4.20",
|
|
||||||
]
|
|
||||||
|
|
||||||
/// Resolve a stored model identifier through the alias map. Returns
|
|
||||||
/// the input unchanged when no alias exists. Pure function — used at
|
|
||||||
/// read time everywhere a config'd model ID is rendered, validated,
|
|
||||||
/// or sent to Hermes.
|
|
||||||
public func resolveModelAlias(providerID: String, modelID: String) -> String {
|
|
||||||
let composite = "\(providerID)/\(modelID)"
|
|
||||||
return Self.modelAliases[composite] ?? modelID
|
|
||||||
}
|
|
||||||
|
|
||||||
// MARK: - Demoted providers (sort tail)
|
|
||||||
|
|
||||||
/// Provider IDs that Hermes v0.13 explicitly deprioritizes in the
|
|
||||||
/// picker. `loadProviders()` sorts these to the tail of the list,
|
|
||||||
/// after the alphabetical group, so users who haven't manually
|
|
||||||
/// chosen Vercel as their gateway don't end up there by default.
|
|
||||||
/// Mirrors Hermes's deprioritized-provider list in
|
|
||||||
/// `hermes-agent/hermes_cli/providers.py`.
|
|
||||||
public static let demotedProviders: Set<String> = [
|
|
||||||
"vercel",
|
|
||||||
]
|
|
||||||
|
|
||||||
// MARK: - Image-generation model allowlist (curated)
|
|
||||||
|
|
||||||
/// Known image-generation models, used to pre-populate the
|
|
||||||
/// `image_gen.model` picker on the Auxiliary tab. The list is
|
|
||||||
/// curated — `models_dev_cache.json` doesn't tag image-capable
|
|
||||||
/// models, so we maintain this by hand on Hermes version bumps.
|
|
||||||
/// Always free-form-typeable on the picker too, so missing entries
|
|
||||||
/// don't block users with non-listed image providers.
|
|
||||||
///
|
|
||||||
/// Order: most-likely-to-be-chosen first.
|
|
||||||
public static let imageGenModels: [HermesImageGenModel] = [
|
|
||||||
.init(modelID: "openai/gpt-image-1", display: "OpenAI · gpt-image-1", providerHint: "openai"),
|
|
||||||
.init(modelID: "google/imagen-4", display: "Google · Imagen 4", providerHint: "google-vertex"),
|
|
||||||
.init(modelID: "google/imagen-3", display: "Google · Imagen 3", providerHint: "google-vertex"),
|
|
||||||
.init(modelID: "stability/stable-image-ultra", display: "Stability · Stable Image Ultra", providerHint: "stability"),
|
|
||||||
.init(modelID: "fal-ai/flux-pro-1.1", display: "fal · FLUX 1.1 Pro", providerHint: "fal"),
|
|
||||||
.init(modelID: "black-forest-labs/flux-1.1-pro", display: "Black Forest Labs · FLUX 1.1 Pro", providerHint: "openrouter"),
|
|
||||||
.init(modelID: "openai/dall-e-3", display: "OpenAI · DALL·E 3", providerHint: "openai"),
|
|
||||||
]
|
|
||||||
|
|
||||||
// MARK: - Hermes overlay providers
|
// MARK: - Hermes overlay providers
|
||||||
|
|
||||||
/// The 11 providers Hermes surfaces via `hermes model` that have no
|
/// The 11 providers Hermes surfaces via `hermes model` that have no
|
||||||
@@ -631,27 +538,6 @@ public struct ModelCatalogService: Sendable {
|
|||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Curated entry for the `image_gen.model` picker on the Auxiliary
|
|
||||||
/// tab. Hermes v0.13 honors a top-level `image_gen.model` key but the
|
|
||||||
/// models.dev catalog has no `image: true` tag, so we maintain a
|
|
||||||
/// short hand-curated allowlist keyed by display order. The picker
|
|
||||||
/// always allows free-form-typing too, so any provider's model ID
|
|
||||||
/// works regardless of whether it appears here.
|
|
||||||
public struct HermesImageGenModel: Sendable, Identifiable, Hashable {
|
|
||||||
public let modelID: String
|
|
||||||
public let display: String
|
|
||||||
/// Hint at which provider serves this model — surfaced as a
|
|
||||||
/// "Configure provider X first" advisory but never enforced.
|
|
||||||
public let providerHint: String?
|
|
||||||
public var id: String { modelID }
|
|
||||||
|
|
||||||
public init(modelID: String, display: String, providerHint: String?) {
|
|
||||||
self.modelID = modelID
|
|
||||||
self.display = display
|
|
||||||
self.providerHint = providerHint
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Scarf-side mirror of `HermesOverlay` from hermes-agent's
|
/// Scarf-side mirror of `HermesOverlay` from hermes-agent's
|
||||||
/// `hermes_cli/providers.py`. Describes a provider that isn't in the
|
/// `hermes_cli/providers.py`. Describes a provider that isn't in the
|
||||||
/// models.dev catalog.
|
/// models.dev catalog.
|
||||||
|
|||||||
@@ -4,17 +4,19 @@ import Observation
|
|||||||
import os
|
import os
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
/// Mac + iOS view model for the v0.12 Curator surface.
|
/// Mac + iOS view model for the Curator surface (v0.12 base + v0.13
|
||||||
|
/// archive/prune additions).
|
||||||
///
|
///
|
||||||
/// Drives `hermes curator status / run / pause / resume / pin / unpin /
|
/// Drives `hermes curator status / run / pause / resume / pin / unpin /
|
||||||
/// restore` plus a parsed view of `~/.hermes/skills/.curator_state`
|
/// restore` plus (v0.13+) `archive`, `prune`, `list-archived`. All CLI
|
||||||
/// JSON. The CLI doesn't ship a `--json` flag for `status`, so we
|
/// invocations route through `CuratorService` (the actor) so polling
|
||||||
/// text-parse stdout (HermesCuratorStatusParser) and use the state
|
/// and writes share the same concurrency model and a single error path.
|
||||||
/// file for richer last-run metadata.
|
|
||||||
///
|
///
|
||||||
/// Capability-gated: callers should construct this only when
|
/// Capability-gated: callers should construct this only when
|
||||||
/// `HermesCapabilities.hasCurator` is true. The view model does not
|
/// `HermesCapabilities.hasCurator` is true. Archive-aware UI surfaces
|
||||||
/// gate itself — the gate happens at sidebar/tab routing time.
|
/// (Archive button, Archived section, Prune…) gate independently on
|
||||||
|
/// `hasCuratorArchive`. The view model itself doesn't gate — it exposes
|
||||||
|
/// every method and the View decides what to render.
|
||||||
@Observable
|
@Observable
|
||||||
@MainActor
|
@MainActor
|
||||||
public final class CuratorViewModel {
|
public final class CuratorViewModel {
|
||||||
@@ -27,20 +29,50 @@ public final class CuratorViewModel {
|
|||||||
public private(set) var status: HermesCuratorStatus = .empty
|
public private(set) var status: HermesCuratorStatus = .empty
|
||||||
public private(set) var isLoading = false
|
public private(set) var isLoading = false
|
||||||
public private(set) var lastReportMarkdown: String?
|
public private(set) var lastReportMarkdown: String?
|
||||||
|
|
||||||
|
// Archive state (v0.13+ only — populated by `loadArchive()` on hosts
|
||||||
|
// where `hasCuratorArchive` is true).
|
||||||
|
public private(set) var archivedSkills: [HermesCuratorArchivedSkill] = []
|
||||||
|
public private(set) var isLoadingArchive = false
|
||||||
|
|
||||||
|
// Prune state — `pruneSummary` non-nil while the confirm sheet is
|
||||||
|
// mid-flight; `isPruning` flips during the destructive step.
|
||||||
|
public private(set) var pruneSummary: CuratorPruneSummary?
|
||||||
|
public private(set) var isPruning = false
|
||||||
|
|
||||||
|
// Track which active-skill row is currently being archived so the
|
||||||
|
// row chrome can show an inline spinner without blocking the rest.
|
||||||
|
public private(set) var pendingArchiveName: String?
|
||||||
|
|
||||||
|
/// Happy-path success toast ("Pinned X", "Resumed", "Archived
|
||||||
|
/// legacy-helper"). Auto-clears 3s after assignment.
|
||||||
public var transientMessage: String?
|
public var transientMessage: String?
|
||||||
|
|
||||||
|
/// Failure path — populated by every CLI verb when it throws. Shown
|
||||||
|
/// as an inline yellow banner above the status summary so users
|
||||||
|
/// don't have to dismiss a modal alert during a high-frequency
|
||||||
|
/// surface like the leaderboard. Manually dismissed via the View's
|
||||||
|
/// "x" button (sets to nil).
|
||||||
|
public var errorMessage: String?
|
||||||
|
|
||||||
|
@ObservationIgnored
|
||||||
|
private let service: CuratorService
|
||||||
|
|
||||||
public init(context: ServerContext) {
|
public init(context: ServerContext) {
|
||||||
self.context = context
|
self.context = context
|
||||||
|
self.service = CuratorService(context: context)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// MARK: - Loads
|
||||||
|
|
||||||
public func load() async {
|
public func load() async {
|
||||||
isLoading = true
|
isLoading = true
|
||||||
defer { isLoading = false }
|
defer { isLoading = false }
|
||||||
let context = self.context
|
let context = self.context
|
||||||
// v2.8 — instrumented. Curator load fires `hermes curator
|
// v2.8 — instrumented. Curator load fires `hermes curator
|
||||||
// status` (CLI subprocess) plus 1-2 file reads; on remote
|
// status` (CLI subprocess) plus 1-2 file reads; on remote each
|
||||||
// each is a separate SSH RTT. Visibility lets future captures
|
// is a separate SSH RTT. Visibility lets future captures show
|
||||||
// show how often the report file is missing or oversized.
|
// how often the report file is missing or oversized.
|
||||||
let parsed = await ScarfMon.measureAsync(.diskIO, "curator.load") {
|
let parsed = await ScarfMon.measureAsync(.diskIO, "curator.load") {
|
||||||
await Task.detached(priority: .userInitiated) { () -> (HermesCuratorStatus, String?) in
|
await Task.detached(priority: .userInitiated) { () -> (HermesCuratorStatus, String?) in
|
||||||
let textResult = Self.runCuratorStatus(context: context)
|
let textResult = Self.runCuratorStatus(context: context)
|
||||||
@@ -69,46 +101,156 @@ public final class CuratorViewModel {
|
|||||||
self.lastReportMarkdown = parsed.1
|
self.lastReportMarkdown = parsed.1
|
||||||
}
|
}
|
||||||
|
|
||||||
public func runNow() async {
|
/// Refresh the archived-skills list. No-op on hosts without
|
||||||
await runAndReload(args: ["curator", "run"], successMessage: "Curator run started")
|
/// `hasCuratorArchive` — the caller gates the call.
|
||||||
|
public func loadArchive() async {
|
||||||
|
isLoadingArchive = true
|
||||||
|
defer { isLoadingArchive = false }
|
||||||
|
do {
|
||||||
|
archivedSkills = try await service.listArchived()
|
||||||
|
} catch {
|
||||||
|
archivedSkills = []
|
||||||
|
errorMessage = (error as? LocalizedError)?.errorDescription
|
||||||
|
?? error.localizedDescription
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - Writes (v0.12)
|
||||||
|
|
||||||
|
/// Run the curator manually. On v0.13+ hosts this blocks for the
|
||||||
|
/// duration of the run (default 600s timeout); pre-v0.13 returns
|
||||||
|
/// immediately. Caller passes the capability-decided flag.
|
||||||
|
public func runNow(synchronous: Bool, timeout: TimeInterval = 600) async {
|
||||||
|
await runWithReload(
|
||||||
|
verb: "run",
|
||||||
|
successMessage: synchronous ? "Curator run complete" : "Curator run started"
|
||||||
|
) {
|
||||||
|
try await self.service.runNow(synchronous: synchronous, timeout: timeout)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
public func pause() async {
|
public func pause() async {
|
||||||
await runAndReload(args: ["curator", "pause"], successMessage: "Curator paused")
|
await runWithReload(verb: "pause", successMessage: "Curator paused") {
|
||||||
|
try await self.service.pause()
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
public func resume() async {
|
public func resume() async {
|
||||||
await runAndReload(args: ["curator", "resume"], successMessage: "Curator resumed")
|
await runWithReload(verb: "resume", successMessage: "Curator resumed") {
|
||||||
|
try await self.service.resume()
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
public func pin(_ skill: String) async {
|
public func pin(_ skill: String) async {
|
||||||
await runAndReload(args: ["curator", "pin", skill], successMessage: "Pinned \(skill)")
|
await runWithReload(verb: "pin", successMessage: "Pinned \(skill)") {
|
||||||
|
try await self.service.pin(skill)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
public func unpin(_ skill: String) async {
|
public func unpin(_ skill: String) async {
|
||||||
await runAndReload(args: ["curator", "unpin", skill], successMessage: "Unpinned \(skill)")
|
await runWithReload(verb: "unpin", successMessage: "Unpinned \(skill)") {
|
||||||
|
try await self.service.unpin(skill)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
public func restore(_ skill: String) async {
|
public func restore(_ skill: String) async {
|
||||||
await runAndReload(args: ["curator", "restore", skill], successMessage: "Restored \(skill)")
|
await runWithReload(verb: "restore", successMessage: "Restored \(skill)") {
|
||||||
|
try await self.service.restore(skill)
|
||||||
|
}
|
||||||
|
// Restore drops the entry from the archived list — refresh it
|
||||||
|
// so the row disappears immediately.
|
||||||
|
await loadArchive()
|
||||||
}
|
}
|
||||||
|
|
||||||
private func runAndReload(args: [String], successMessage: String) async {
|
// MARK: - Writes (v0.13)
|
||||||
let context = self.context
|
|
||||||
let exitCode = await Task.detached(priority: .userInitiated) {
|
public func archive(_ skill: String) async {
|
||||||
Self.runHermes(context: context, args: args).exitCode
|
pendingArchiveName = skill
|
||||||
}.value
|
await runWithReload(verb: "archive", successMessage: "Archived \(skill)") {
|
||||||
transientMessage = exitCode == 0 ? successMessage : "Command failed"
|
try await self.service.archive(skill)
|
||||||
|
}
|
||||||
|
pendingArchiveName = nil
|
||||||
|
await loadArchive()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Stage 1 of the bulk-prune flow. Calls `prune --dry-run` and
|
||||||
|
/// populates `pruneSummary`; the View binds its confirm sheet to
|
||||||
|
/// the non-nil presence of this property.
|
||||||
|
public func planPrune() async {
|
||||||
|
do {
|
||||||
|
pruneSummary = try await service.prune(dryRun: true)
|
||||||
|
} catch {
|
||||||
|
errorMessage = (error as? LocalizedError)?.errorDescription
|
||||||
|
?? error.localizedDescription
|
||||||
|
pruneSummary = nil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Stage 2 of the bulk-prune flow. Destructive — removes everything
|
||||||
|
/// currently archived. Clears `pruneSummary` regardless of outcome
|
||||||
|
/// so the confirm sheet dismisses.
|
||||||
|
public func confirmPrune() async {
|
||||||
|
isPruning = true
|
||||||
|
do {
|
||||||
|
_ = try await service.prune(dryRun: false)
|
||||||
|
transientMessage = "Pruned archived skills"
|
||||||
|
errorMessage = nil
|
||||||
|
await loadArchive()
|
||||||
await load()
|
await load()
|
||||||
// Auto-clear toast after 3s.
|
scheduleTransientClear()
|
||||||
|
} catch {
|
||||||
|
errorMessage = (error as? LocalizedError)?.errorDescription
|
||||||
|
?? error.localizedDescription
|
||||||
|
}
|
||||||
|
isPruning = false
|
||||||
|
pruneSummary = nil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel the in-flight prune-confirm flow without running.
|
||||||
|
public func cancelPrune() {
|
||||||
|
pruneSummary = nil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// User-driven dismissal of the inline error banner.
|
||||||
|
public func dismissError() {
|
||||||
|
errorMessage = nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - Helpers
|
||||||
|
|
||||||
|
/// Run a service call, route success → `transientMessage`, failure
|
||||||
|
/// → `errorMessage`, and reload `status` either way. Mirrors the
|
||||||
|
/// previous `runAndReload` helper but goes through the typed
|
||||||
|
/// service surface.
|
||||||
|
private func runWithReload(
|
||||||
|
verb: String,
|
||||||
|
successMessage: String,
|
||||||
|
body: @escaping @Sendable () async throws -> Void
|
||||||
|
) async {
|
||||||
|
do {
|
||||||
|
try await body()
|
||||||
|
transientMessage = successMessage
|
||||||
|
errorMessage = nil
|
||||||
|
await load()
|
||||||
|
scheduleTransientClear()
|
||||||
|
} catch {
|
||||||
|
let message = (error as? LocalizedError)?.errorDescription
|
||||||
|
?? error.localizedDescription
|
||||||
|
errorMessage = message
|
||||||
|
transientMessage = nil
|
||||||
|
await load()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private func scheduleTransientClear() {
|
||||||
Task { @MainActor [weak self] in
|
Task { @MainActor [weak self] in
|
||||||
try? await Task.sleep(nanoseconds: 3_000_000_000)
|
try? await Task.sleep(nanoseconds: 3_000_000_000)
|
||||||
self?.transientMessage = nil
|
self?.transientMessage = nil
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Wrap the transport-level `runProcess` so the call sites don't
|
// MARK: - Legacy sync helpers (kept for `load`'s detached path)
|
||||||
/// have to reach for it directly. Combined stdout+stderr.
|
|
||||||
nonisolated private static func runHermes(
|
nonisolated private static func runHermes(
|
||||||
context: ServerContext,
|
context: ServerContext,
|
||||||
args: [String]
|
args: [String]
|
||||||
|
|||||||
@@ -151,4 +151,169 @@ import Foundation
|
|||||||
#expect(parsed?.patchCount == 2)
|
#expect(parsed?.patchCount == 2)
|
||||||
#expect(parsed?.lastActivityLabel == "2026-04-25")
|
#expect(parsed?.lastActivityLabel == "2026-04-25")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// MARK: - v0.13 list-archived / prune fixtures (WS-4)
|
||||||
|
|
||||||
|
/// Empty JSON array → `[]`. Locks in the happy-path no-archives shape.
|
||||||
|
@Test func listArchivedEmpty() throws {
|
||||||
|
let result = try CuratorService.parseListArchived(stdout: "[]")
|
||||||
|
#expect(result.isEmpty)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Three archives with full optional fields. Asserts each
|
||||||
|
/// optional value decodes through `decodeIfPresent` and that
|
||||||
|
/// the computed labels resolve.
|
||||||
|
@Test func listArchivedThreeSkills() throws {
|
||||||
|
let json = """
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"name": "legacy-helper",
|
||||||
|
"category": "templates",
|
||||||
|
"archived_at": "2026-04-22T03:14:09Z",
|
||||||
|
"reason": "stale: 91d unused",
|
||||||
|
"size_bytes": 4521,
|
||||||
|
"path": "/Users/u/.hermes/skills/.archived/legacy-helper"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "old-translator",
|
||||||
|
"category": "user",
|
||||||
|
"archived_at": "2026-04-23T10:00:00Z",
|
||||||
|
"reason": "consolidated with translator",
|
||||||
|
"size_bytes": 8192
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "minimal"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
"""
|
||||||
|
let result = try CuratorService.parseListArchived(stdout: json)
|
||||||
|
#expect(result.count == 3)
|
||||||
|
#expect(result[0].name == "legacy-helper")
|
||||||
|
#expect(result[0].category == "templates")
|
||||||
|
#expect(result[0].reason == "stale: 91d unused")
|
||||||
|
#expect(result[0].sizeBytes == 4521)
|
||||||
|
#expect(result[0].archivedAtLabel == "2026-04-22")
|
||||||
|
#expect(result[0].path == "/Users/u/.hermes/skills/.archived/legacy-helper")
|
||||||
|
|
||||||
|
// Tolerant: only `name` set on the third row.
|
||||||
|
#expect(result[2].name == "minimal")
|
||||||
|
#expect(result[2].category == nil)
|
||||||
|
#expect(result[2].reason == nil)
|
||||||
|
#expect(result[2].archivedAtLabel == "—")
|
||||||
|
#expect(result[2].sizeLabel == "—")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// `{"archived": [...]}` envelope is also accepted.
|
||||||
|
@Test func listArchivedEnvelope() throws {
|
||||||
|
let json = """
|
||||||
|
{"archived": [
|
||||||
|
{"name": "envelope-skill", "size_bytes": 1024}
|
||||||
|
]}
|
||||||
|
"""
|
||||||
|
let result = try CuratorService.parseListArchived(stdout: json)
|
||||||
|
#expect(result.count == 1)
|
||||||
|
#expect(result[0].name == "envelope-skill")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Text fallback when `--json` isn't supported. Each row carries
|
||||||
|
/// the name in column 1 plus k=v chips for the optional fields.
|
||||||
|
@Test func listArchivedTextFallback() {
|
||||||
|
let text = """
|
||||||
|
legacy-helper archived=2026-04-22 size=4521 reason=stale
|
||||||
|
old-translator archived=2026-04-23 size=8192
|
||||||
|
minimal-row
|
||||||
|
"""
|
||||||
|
let result = CuratorService.parseListArchivedText(text)
|
||||||
|
#expect(result.count == 3)
|
||||||
|
#expect(result[0].name == "legacy-helper")
|
||||||
|
#expect(result[0].archivedAt == "2026-04-22")
|
||||||
|
#expect(result[0].sizeBytes == 4521)
|
||||||
|
#expect(result[0].reason == "stale")
|
||||||
|
#expect(result[2].name == "minimal-row")
|
||||||
|
#expect(result[2].sizeBytes == nil)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Empty-state sentinel folds to `[]` (parallel to KanbanService's
|
||||||
|
/// `"no matching tasks"` handling).
|
||||||
|
@Test func listArchivedNoArchivedSentinel() throws {
|
||||||
|
let result = try CuratorService.parseListArchived(stdout: "no archived skills\n")
|
||||||
|
#expect(result.isEmpty)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Whitespace-only stdout also folds to empty.
|
||||||
|
@Test func listArchivedWhitespaceFoldsToEmpty() throws {
|
||||||
|
let result = try CuratorService.parseListArchived(stdout: " \n\n")
|
||||||
|
#expect(result.isEmpty)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Decode failure (clearly non-JSON, non-text) throws. We accept
|
||||||
|
/// JSON, the envelope, the empty sentinel, or text rows; anything
|
||||||
|
/// else surfaces as a `CuratorError.decoding`.
|
||||||
|
@Test func listArchivedNonsenseThrows() throws {
|
||||||
|
do {
|
||||||
|
_ = try CuratorService.parseListArchived(stdout: "{garbage")
|
||||||
|
Issue.record("expected decoding throw")
|
||||||
|
} catch let error as CuratorError {
|
||||||
|
if case .decoding = error {
|
||||||
|
// expected
|
||||||
|
} else {
|
||||||
|
Issue.record("unexpected error \(error)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Prune-dry-run JSON with `would_remove` + `total_bytes`.
|
||||||
|
@Test func pruneDryRunHappyPath() {
|
||||||
|
let json = """
|
||||||
|
{
|
||||||
|
"would_remove": [
|
||||||
|
{"name": "stale-a", "size_bytes": 1000},
|
||||||
|
{"name": "stale-b", "size_bytes": 2000}
|
||||||
|
],
|
||||||
|
"total_bytes": 3000
|
||||||
|
}
|
||||||
|
"""
|
||||||
|
let summary = CuratorService.parsePruneDryRun(json)
|
||||||
|
#expect(summary.totalCount == 2)
|
||||||
|
#expect(summary.totalBytes == 3000)
|
||||||
|
#expect(summary.wouldRemove.first?.name == "stale-a")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Zero-skill prune is a valid dry-run (no archives).
|
||||||
|
@Test func pruneDryRunZeroSkills() {
|
||||||
|
let json = """
|
||||||
|
{"would_remove": [], "total_bytes": 0}
|
||||||
|
"""
|
||||||
|
let summary = CuratorService.parsePruneDryRun(json)
|
||||||
|
#expect(summary.totalCount == 0)
|
||||||
|
#expect(summary.totalBytes == 0)
|
||||||
|
#expect(summary.totalBytesLabel == "—")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bare-array fallback: some Hermes builds may print just the
|
||||||
|
/// would-remove list when the wrapper is missing.
|
||||||
|
@Test func pruneDryRunBareArrayFallback() {
|
||||||
|
let json = """
|
||||||
|
[{"name": "lonely", "size_bytes": 500}]
|
||||||
|
"""
|
||||||
|
let summary = CuratorService.parsePruneDryRun(json)
|
||||||
|
#expect(summary.totalCount == 1)
|
||||||
|
#expect(summary.totalBytes == 500)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Empty / whitespace stdout → zero summary (no decoding throw).
|
||||||
|
@Test func pruneDryRunEmptyStaysSafe() {
|
||||||
|
let summary = CuratorService.parsePruneDryRun(" \n")
|
||||||
|
#expect(summary.totalCount == 0)
|
||||||
|
#expect(summary.totalBytes == 0)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Verify the size label uses the byte formatter (not raw bytes).
|
||||||
|
@Test func archivedSkillSizeLabelFormats() {
|
||||||
|
let big = HermesCuratorArchivedSkill(name: "x", sizeBytes: 1_500_000)
|
||||||
|
// ByteCountFormatter produces a localized label; just verify
|
||||||
|
// it's non-empty and not raw "1500000".
|
||||||
|
#expect(!big.sizeLabel.isEmpty)
|
||||||
|
#expect(big.sizeLabel != "1500000")
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -310,74 +310,6 @@ import Foundation
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// MARK: - ModelCatalogService — WS-6 (v0.13)
|
|
||||||
|
|
||||||
@Test func vercelAIGatewayDemotedToBottom() throws {
|
|
||||||
// Build a minimal catalog with vercel + alphabetically-later
|
|
||||||
// providers, then assert vercel sorts after them. Locks the
|
|
||||||
// demoted-axis sort comparator added in WS-6.
|
|
||||||
let json = """
|
|
||||||
{
|
|
||||||
"anthropic": { "name": "Anthropic", "models": {} },
|
|
||||||
"vercel": { "name": "Vercel AI Gateway", "models": {} },
|
|
||||||
"zonk": { "name": "Zonk Provider", "models": {} }
|
|
||||||
}
|
|
||||||
"""
|
|
||||||
let tmp = FileManager.default.temporaryDirectory
|
|
||||||
.appendingPathComponent("scarf-models-\(UUID().uuidString).json")
|
|
||||||
try json.write(to: tmp, atomically: true, encoding: .utf8)
|
|
||||||
defer { try? FileManager.default.removeItem(at: tmp) }
|
|
||||||
let svc = ModelCatalogService(path: tmp.path)
|
|
||||||
let providers = svc.loadProviders().filter { !$0.isOverlay }
|
|
||||||
let names = providers.map(\.providerName)
|
|
||||||
// anthropic first (alpha), zonk next (alpha), vercel last
|
|
||||||
// (demoted) — even though `vercel` < `zonk` alphabetically.
|
|
||||||
#expect(names.last == "Vercel AI Gateway")
|
|
||||||
let vercelIdx = names.firstIndex(of: "Vercel AI Gateway") ?? -1
|
|
||||||
let zonkIdx = names.firstIndex(of: "Zonk Provider") ?? -1
|
|
||||||
#expect(vercelIdx > zonkIdx)
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test func grok420BetaAliasResolvesToGrok420() {
|
|
||||||
let svc = ModelCatalogService(path: "/tmp/scarf-nonexistent-\(UUID().uuidString).json")
|
|
||||||
// OpenRouter's old `-beta` ID resolves to the GA name.
|
|
||||||
#expect(svc.resolveModelAlias(providerID: "openrouter", modelID: "x-ai/grok-4.20-beta")
|
|
||||||
== "x-ai/grok-4.20")
|
|
||||||
// xAI direct provider keeps the same shape minus prefix.
|
|
||||||
#expect(svc.resolveModelAlias(providerID: "xai", modelID: "grok-4.20-beta")
|
|
||||||
== "grok-4.20")
|
|
||||||
// Non-aliased ID passes through unchanged.
|
|
||||||
#expect(svc.resolveModelAlias(providerID: "anthropic", modelID: "claude-4.7-opus")
|
|
||||||
== "claude-4.7-opus")
|
|
||||||
// Cross-provider isolation: same modelID on a different
|
|
||||||
// provider isn't aliased — composite key in `modelAliases`
|
|
||||||
// disambiguates by providerID.
|
|
||||||
#expect(svc.resolveModelAlias(providerID: "fictional", modelID: "x-ai/grok-4.20-beta")
|
|
||||||
== "x-ai/grok-4.20-beta")
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test func imageGenModelAllowlistShape() {
|
|
||||||
// Lock the curated list size + a few sentinel entries so
|
|
||||||
// unintentional edits get caught in review. Free-form-typing
|
|
||||||
// bypasses the allowlist, so additions/removals here are
|
|
||||||
// purely UX (which models surface as picker rows).
|
|
||||||
let models = ModelCatalogService.imageGenModels
|
|
||||||
#expect(models.count >= 5)
|
|
||||||
#expect(models.contains(where: { $0.modelID == "openai/gpt-image-1" }))
|
|
||||||
#expect(models.contains(where: { $0.modelID == "google/imagen-4" }))
|
|
||||||
// Every entry has a non-empty display + a non-empty modelID.
|
|
||||||
for m in models {
|
|
||||||
#expect(!m.modelID.isEmpty)
|
|
||||||
#expect(!m.display.isEmpty)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test func demotedProvidersContainsVercel() {
|
|
||||||
// Minimal lock-in for the demoted-providers static set. Mirrors
|
|
||||||
// Hermes's deprioritized-provider list in providers.py.
|
|
||||||
#expect(ModelCatalogService.demotedProviders.contains("vercel"))
|
|
||||||
}
|
|
||||||
|
|
||||||
// MARK: - ProjectDashboardService
|
// MARK: - ProjectDashboardService
|
||||||
|
|
||||||
@Test func projectDashboardServiceRegistryRoundTrip() throws {
|
@Test func projectDashboardServiceRegistryRoundTrip() throws {
|
||||||
|
|||||||
@@ -92,27 +92,6 @@ import Foundation
|
|||||||
#expect(c.security.redactSecrets == true)
|
#expect(c.security.redactSecrets == true)
|
||||||
#expect(c.compression.enabled == true)
|
#expect(c.compression.enabled == true)
|
||||||
#expect(c.voice.ttsProvider == "edge")
|
#expect(c.voice.ttsProvider == "edge")
|
||||||
// v0.13 additions default to empty / off when the YAML omits
|
|
||||||
// them — pre-v0.13 hosts produce this exact shape.
|
|
||||||
#expect(c.imageGenModel == "")
|
|
||||||
#expect(c.openrouterResponseCacheEnabled == false)
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test func parsesImageGenAndOpenRouterCache() {
|
|
||||||
// WS-6: round-trip the two new top-level v0.13 keys. If the
|
|
||||||
// OpenRouter key shape changes upstream (see TODO(WS-6-Q1)),
|
|
||||||
// this test is the single touchpoint that pins the parser
|
|
||||||
// line + setter key + UI binding to a single shape.
|
|
||||||
let yaml = """
|
|
||||||
image_gen:
|
|
||||||
model: openai/gpt-image-1
|
|
||||||
openrouter:
|
|
||||||
response_cache:
|
|
||||||
enabled: true
|
|
||||||
"""
|
|
||||||
let c = HermesConfig(yaml: yaml)
|
|
||||||
#expect(c.imageGenModel == "openai/gpt-image-1")
|
|
||||||
#expect(c.openrouterResponseCacheEnabled == true)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test func parsesTopLevelModel() {
|
@Test func parsesTopLevelModel() {
|
||||||
|
|||||||
@@ -13,11 +13,24 @@ import ScarfDesign
|
|||||||
/// `HermesCapabilities.hasCurator` is true.
|
/// `HermesCapabilities.hasCurator` is true.
|
||||||
struct CuratorView: View {
|
struct CuratorView: View {
|
||||||
@State private var viewModel: CuratorViewModel
|
@State private var viewModel: CuratorViewModel
|
||||||
|
@Environment(\.hermesCapabilities) private var capabilitiesStore
|
||||||
|
|
||||||
|
// TODO(WS-9): add a read-only "Archived" section mirroring the Mac
|
||||||
|
// surface (no per-row Restore/Prune mutations on iOS in this
|
||||||
|
// release). Gate on `capabilitiesStore?.capabilities.hasCuratorArchive`.
|
||||||
|
|
||||||
init(context: ServerContext) {
|
init(context: ServerContext) {
|
||||||
_viewModel = State(initialValue: CuratorViewModel(context: context))
|
_viewModel = State(initialValue: CuratorViewModel(context: context))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Whether the connected host runs curator synchronously. Threaded
|
||||||
|
/// into `runNow` so v0.13+ hosts block-with-spinner; pre-v0.13 fire
|
||||||
|
/// and forget. WS-9 will surface a richer iOS progress affordance
|
||||||
|
/// alongside the read-only Archived section.
|
||||||
|
private var archiveAvailable: Bool {
|
||||||
|
capabilitiesStore?.capabilities.hasCuratorArchive ?? false
|
||||||
|
}
|
||||||
|
|
||||||
var body: some View {
|
var body: some View {
|
||||||
List {
|
List {
|
||||||
Section {
|
Section {
|
||||||
@@ -115,7 +128,7 @@ struct CuratorView: View {
|
|||||||
private var actionFooter: some View {
|
private var actionFooter: some View {
|
||||||
HStack(spacing: 8) {
|
HStack(spacing: 8) {
|
||||||
Button {
|
Button {
|
||||||
Task { await viewModel.runNow() }
|
Task { await viewModel.runNow(synchronous: archiveAvailable, timeout: 600) }
|
||||||
} label: {
|
} label: {
|
||||||
Label("Run now", systemImage: "play.fill")
|
Label("Run now", systemImage: "play.fill")
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,122 @@
|
|||||||
|
import SwiftUI
|
||||||
|
import ScarfCore
|
||||||
|
import ScarfDesign
|
||||||
|
|
||||||
|
/// Mac sub-view rendered between the active-skill leaderboards and the
|
||||||
|
/// last-report block on Hermes v0.13+ hosts. Lists everything currently
|
||||||
|
/// archived (`hermes curator list-archived`) with per-row Restore + a
|
||||||
|
/// bulk Prune affordance routed through the parent's confirm sheet.
|
||||||
|
///
|
||||||
|
/// Empty-state copy explains what archive means — useful when the
|
||||||
|
/// curator hasn't run yet on a fresh install (no archives ≠ a problem).
|
||||||
|
struct CuratorArchivedSection: View {
|
||||||
|
let archived: [HermesCuratorArchivedSkill]
|
||||||
|
let isLoading: Bool
|
||||||
|
let onRestore: (String) -> Void
|
||||||
|
let onPruneAll: () -> Void
|
||||||
|
|
||||||
|
var body: some View {
|
||||||
|
ScarfCard {
|
||||||
|
VStack(alignment: .leading, spacing: ScarfSpace.s2) {
|
||||||
|
header
|
||||||
|
if isLoading && archived.isEmpty {
|
||||||
|
loadingRow
|
||||||
|
} else if archived.isEmpty {
|
||||||
|
emptyState
|
||||||
|
} else {
|
||||||
|
rows
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private var header: some View {
|
||||||
|
HStack(alignment: .firstTextBaseline) {
|
||||||
|
ScarfSectionHeader("Archived")
|
||||||
|
Spacer()
|
||||||
|
Text("\(archived.count) skill\(archived.count == 1 ? "" : "s")")
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
if !archived.isEmpty {
|
||||||
|
Button("Prune All…") {
|
||||||
|
onPruneAll()
|
||||||
|
}
|
||||||
|
.buttonStyle(ScarfDestructiveButton())
|
||||||
|
.help("Remove every archived skill from disk. Cannot be undone.")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private var loadingRow: some View {
|
||||||
|
HStack(spacing: ScarfSpace.s2) {
|
||||||
|
ProgressView().controlSize(.small)
|
||||||
|
Text("Loading archived skills…")
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
Spacer()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private var emptyState: some View {
|
||||||
|
VStack(alignment: .leading, spacing: ScarfSpace.s1) {
|
||||||
|
Text("No archived skills.")
|
||||||
|
.scarfStyle(.body)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
Text("The curator moves stale or redundant skills here on its weekly review. Until then, this list stays empty.")
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundFaint)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private var rows: some View {
|
||||||
|
VStack(alignment: .leading, spacing: ScarfSpace.s1) {
|
||||||
|
ForEach(archived) { skill in
|
||||||
|
ArchivedSkillRow(
|
||||||
|
skill: skill,
|
||||||
|
onRestore: { onRestore(skill.name) }
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private struct ArchivedSkillRow: View {
|
||||||
|
let skill: HermesCuratorArchivedSkill
|
||||||
|
let onRestore: () -> Void
|
||||||
|
|
||||||
|
var body: some View {
|
||||||
|
HStack(alignment: .center, spacing: ScarfSpace.s2) {
|
||||||
|
Image(systemName: "archivebox.fill")
|
||||||
|
.font(.system(size: 12))
|
||||||
|
.foregroundStyle(ScarfColor.foregroundFaint)
|
||||||
|
VStack(alignment: .leading, spacing: 2) {
|
||||||
|
Text(skill.name)
|
||||||
|
.scarfStyle(.body)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundPrimary)
|
||||||
|
.lineLimit(1)
|
||||||
|
if let reason = skill.reason, !reason.isEmpty {
|
||||||
|
Text(reason)
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
.lineLimit(1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
.frame(maxWidth: .infinity, alignment: .leading)
|
||||||
|
Text(skill.archivedAtLabel)
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundFaint)
|
||||||
|
.frame(width: 96, alignment: .trailing)
|
||||||
|
Text(skill.sizeLabel)
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundFaint)
|
||||||
|
.frame(width: 72, alignment: .trailing)
|
||||||
|
Button("Restore") {
|
||||||
|
onRestore()
|
||||||
|
}
|
||||||
|
.buttonStyle(ScarfPrimaryButton())
|
||||||
|
.controlSize(.small)
|
||||||
|
.help("Restore \(skill.name) to the active skill set")
|
||||||
|
}
|
||||||
|
.padding(.vertical, 2)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,123 @@
|
|||||||
|
import SwiftUI
|
||||||
|
import ScarfCore
|
||||||
|
import ScarfDesign
|
||||||
|
|
||||||
|
/// Destructive-confirm sheet for `hermes curator prune` (bulk).
|
||||||
|
///
|
||||||
|
/// Pattern matches `TemplateUninstallSheet`: enumerate every entry that
|
||||||
|
/// will be removed, surface the total count + bytes, and require an
|
||||||
|
/// explicit click on a red `ScarfDestructiveButton` ("Prune
|
||||||
|
/// permanently") before kicking off the destructive call. Cancel owns
|
||||||
|
/// the keyboard default action so an accidental Enter-press doesn't
|
||||||
|
/// nuke the archive.
|
||||||
|
struct CuratorPruneConfirmSheet: View {
|
||||||
|
@Environment(\.dismiss) private var dismiss
|
||||||
|
let summary: CuratorPruneSummary
|
||||||
|
let isPruning: Bool
|
||||||
|
let onConfirm: () -> Void
|
||||||
|
let onCancel: () -> Void
|
||||||
|
|
||||||
|
var body: some View {
|
||||||
|
VStack(alignment: .leading, spacing: 0) {
|
||||||
|
header
|
||||||
|
.padding(.bottom, ScarfSpace.s2)
|
||||||
|
ScarfDivider()
|
||||||
|
ScrollView {
|
||||||
|
VStack(alignment: .leading, spacing: ScarfSpace.s2) {
|
||||||
|
ForEach(summary.wouldRemove) { skill in
|
||||||
|
row(skill: skill)
|
||||||
|
}
|
||||||
|
if summary.wouldRemove.isEmpty {
|
||||||
|
Text("Nothing currently archived. Nothing to prune.")
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
.padding(.vertical, ScarfSpace.s2)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
.padding(.vertical, ScarfSpace.s2)
|
||||||
|
}
|
||||||
|
ScarfDivider()
|
||||||
|
footer
|
||||||
|
.padding(.top, ScarfSpace.s2)
|
||||||
|
}
|
||||||
|
.frame(minWidth: 520, minHeight: 380)
|
||||||
|
.padding(ScarfSpace.s4)
|
||||||
|
}
|
||||||
|
|
||||||
|
private var header: some View {
|
||||||
|
VStack(alignment: .leading, spacing: ScarfSpace.s1) {
|
||||||
|
HStack(alignment: .firstTextBaseline) {
|
||||||
|
Text("Prune Archived Skills")
|
||||||
|
.scarfStyle(.title2)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundPrimary)
|
||||||
|
Spacer()
|
||||||
|
if summary.totalCount > 0 {
|
||||||
|
ScarfBadge("\(summary.totalCount)", kind: .danger)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Text("This permanently deletes every archived skill from disk. Restoring an archived skill is no longer possible after pruning.")
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
.fixedSize(horizontal: false, vertical: true)
|
||||||
|
if summary.totalBytes > 0 {
|
||||||
|
Text("Total to remove: \(summary.totalBytesLabel)")
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundFaint)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private func row(skill: HermesCuratorArchivedSkill) -> some View {
|
||||||
|
HStack(spacing: ScarfSpace.s2) {
|
||||||
|
Image(systemName: "minus.circle")
|
||||||
|
.foregroundStyle(ScarfColor.danger)
|
||||||
|
.font(.caption)
|
||||||
|
VStack(alignment: .leading, spacing: 2) {
|
||||||
|
Text(skill.name)
|
||||||
|
.scarfStyle(.body)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundPrimary)
|
||||||
|
.lineLimit(1)
|
||||||
|
if let reason = skill.reason, !reason.isEmpty {
|
||||||
|
Text(reason)
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
.lineLimit(1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Spacer()
|
||||||
|
Text(skill.archivedAtLabel)
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundFaint)
|
||||||
|
.frame(width: 96, alignment: .trailing)
|
||||||
|
Text(skill.sizeLabel)
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundFaint)
|
||||||
|
.frame(width: 72, alignment: .trailing)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private var footer: some View {
|
||||||
|
HStack {
|
||||||
|
Button("Cancel") {
|
||||||
|
onCancel()
|
||||||
|
dismiss()
|
||||||
|
}
|
||||||
|
.buttonStyle(ScarfGhostButton())
|
||||||
|
// Cancel owns .defaultAction so accidental Enter-presses
|
||||||
|
// don't trigger the destructive button (template-uninstall
|
||||||
|
// pattern recommended in the WS-4 plan).
|
||||||
|
.keyboardShortcut(.defaultAction)
|
||||||
|
.disabled(isPruning)
|
||||||
|
Spacer()
|
||||||
|
if isPruning {
|
||||||
|
ProgressView().controlSize(.small)
|
||||||
|
}
|
||||||
|
Button("Prune permanently") {
|
||||||
|
onConfirm()
|
||||||
|
}
|
||||||
|
.buttonStyle(ScarfDestructiveButton())
|
||||||
|
.disabled(isPruning || summary.wouldRemove.isEmpty)
|
||||||
|
.accessibilityIdentifier("curatorPrune.confirm")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -2,18 +2,16 @@ import SwiftUI
|
|||||||
import ScarfCore
|
import ScarfCore
|
||||||
import ScarfDesign
|
import ScarfDesign
|
||||||
|
|
||||||
/// Modal that lists archived skills (state ≠ active) and exposes a
|
/// Legacy v0.12 fallback for restoring an archived skill by typed
|
||||||
/// one-click "Restore" action per row. v0.12 archives are recoverable —
|
/// name. Hermes v0.12 didn't ship `curator list-archived`, so the only
|
||||||
/// `hermes curator restore <name>` brings the skill back into
|
/// way to restore was to remember the skill name and pass it through
|
||||||
/// `~/.hermes/skills/<category>/<name>/` and re-marks it active.
|
/// `hermes curator restore <name>`.
|
||||||
///
|
///
|
||||||
/// The Curator's `status` text doesn't enumerate archived skills with
|
/// **v0.13+ flow (preferred):** `CuratorArchivedSection` renders a
|
||||||
/// names; we surface what's available (counts + pinned list) and rely
|
/// per-skill list with a one-click Restore button per row — no typing
|
||||||
/// on the user knowing the names. Hermes ergo does an interactive
|
/// required. This sheet stays reachable from the overflow menu only on
|
||||||
/// `--name` arg if missing — but Scarf prefers explicit selection so
|
/// pre-v0.13 hosts (gated by `!hasCuratorArchive`). Don't delete this
|
||||||
/// users don't have to remember names. For v2.6 we render a free-form
|
/// file even after WS-4 ships; v0.12 hosts still depend on it.
|
||||||
/// text field; once Hermes ships a `curator list-archived` (tracked
|
|
||||||
/// upstream), swap to a pickable list.
|
|
||||||
struct CuratorRestoreSheet: View {
|
struct CuratorRestoreSheet: View {
|
||||||
let viewModel: CuratorViewModel
|
let viewModel: CuratorViewModel
|
||||||
|
|
||||||
|
|||||||
@@ -2,57 +2,52 @@ import SwiftUI
|
|||||||
import ScarfCore
|
import ScarfCore
|
||||||
import ScarfDesign
|
import ScarfDesign
|
||||||
|
|
||||||
/// Mac UI for Hermes v0.12's autonomous skill curator.
|
/// Mac UI for Hermes's autonomous skill curator (v0.12 base + v0.13
|
||||||
|
/// archive/prune surface).
|
||||||
///
|
///
|
||||||
/// Surfaces the running state (enabled / paused / disabled), last-run
|
/// Surfaces the running state (enabled / paused / disabled), last-run
|
||||||
/// metadata, agent-created skill counts, and the most/least-active /
|
/// metadata, agent-created skill counts, the most/least-active /
|
||||||
/// least-recently-active leaderboards. Pin-and-restore actions hit
|
/// least-recently-active leaderboards, and on v0.13+ hosts the new
|
||||||
/// `hermes curator pin/unpin/restore` via CuratorViewModel.
|
/// archived-skills section + per-row Archive button on each leaderboard
|
||||||
|
/// entry. Pin / unpin / restore / archive / prune route through
|
||||||
|
/// CuratorViewModel → CuratorService.
|
||||||
///
|
///
|
||||||
/// Capability-gated upstream: AppCoordinator only wires the sidebar
|
/// Capability-gated upstream: AppCoordinator only wires the sidebar
|
||||||
/// item when `HermesCapabilities.hasCurator` is true. This view assumes
|
/// item when `HermesCapabilities.hasCurator` is true. Archive surfaces
|
||||||
/// it's reachable on a v0.12+ host.
|
/// gate independently on `hasCuratorArchive`; pre-v0.13 hosts see the
|
||||||
|
/// v2.7.x layout unchanged (legacy `CuratorRestoreSheet` reachable from
|
||||||
|
/// the overflow menu, no Archive section, fire-and-forget Run Now).
|
||||||
struct CuratorView: View {
|
struct CuratorView: View {
|
||||||
@State private var viewModel: CuratorViewModel
|
@State private var viewModel: CuratorViewModel
|
||||||
@State private var showRestoreSheet = false
|
@State private var showRestoreSheet = false
|
||||||
|
|
||||||
|
@Environment(\.hermesCapabilities) private var capabilitiesStore
|
||||||
|
|
||||||
init(context: ServerContext) {
|
init(context: ServerContext) {
|
||||||
_viewModel = State(initialValue: CuratorViewModel(context: context))
|
_viewModel = State(initialValue: CuratorViewModel(context: context))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Single source of truth for "v0.13 archive surface visible". Read
|
||||||
|
/// once in `body` and threaded into sub-views. Defensive default to
|
||||||
|
/// `false` so previews / smoke tests behave like a pre-v0.13 host.
|
||||||
|
private var archiveAvailable: Bool {
|
||||||
|
capabilitiesStore?.capabilities.hasCuratorArchive ?? false
|
||||||
|
}
|
||||||
|
|
||||||
var body: some View {
|
var body: some View {
|
||||||
ScrollView {
|
ScrollView {
|
||||||
VStack(alignment: .leading, spacing: ScarfSpace.s4) {
|
VStack(alignment: .leading, spacing: ScarfSpace.s4) {
|
||||||
ScarfPageHeader(
|
ScarfPageHeader(
|
||||||
"Curator",
|
"Curator",
|
||||||
subtitle: "Autonomous skill maintenance — Hermes v0.12+"
|
subtitle: archiveAvailable
|
||||||
|
? "Autonomous skill maintenance — archive, prune, restore"
|
||||||
|
: "Autonomous skill maintenance — Hermes v0.12+"
|
||||||
) {
|
) {
|
||||||
HStack(spacing: ScarfSpace.s2) {
|
headerActions
|
||||||
if viewModel.isLoading {
|
|
||||||
ProgressView().controlSize(.small)
|
|
||||||
}
|
|
||||||
Button("Run Now") {
|
|
||||||
Task { await viewModel.runNow() }
|
|
||||||
}
|
|
||||||
.buttonStyle(ScarfPrimaryButton())
|
|
||||||
.disabled(viewModel.isLoading)
|
|
||||||
Menu {
|
|
||||||
switch viewModel.status.state {
|
|
||||||
case .paused:
|
|
||||||
Button("Resume") { Task { await viewModel.resume() } }
|
|
||||||
case .enabled:
|
|
||||||
Button("Pause") { Task { await viewModel.pause() } }
|
|
||||||
default:
|
|
||||||
EmptyView()
|
|
||||||
}
|
|
||||||
Button("Restore Archived…") {
|
|
||||||
showRestoreSheet = true
|
|
||||||
}
|
|
||||||
.disabled(viewModel.status.archivedSkills == 0)
|
|
||||||
} label: {
|
|
||||||
Image(systemName: "ellipsis.circle")
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if let errorMessage = viewModel.errorMessage {
|
||||||
|
errorBanner(errorMessage)
|
||||||
}
|
}
|
||||||
|
|
||||||
if let toast = viewModel.transientMessage {
|
if let toast = viewModel.transientMessage {
|
||||||
@@ -64,6 +59,19 @@ struct CuratorView: View {
|
|||||||
pinnedSection
|
pinnedSection
|
||||||
activityTables
|
activityTables
|
||||||
|
|
||||||
|
if archiveAvailable {
|
||||||
|
CuratorArchivedSection(
|
||||||
|
archived: viewModel.archivedSkills,
|
||||||
|
isLoading: viewModel.isLoadingArchive,
|
||||||
|
onRestore: { name in
|
||||||
|
Task { await viewModel.restore(name) }
|
||||||
|
},
|
||||||
|
onPruneAll: {
|
||||||
|
Task { await viewModel.planPrune() }
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
if let report = viewModel.lastReportMarkdown {
|
if let report = viewModel.lastReportMarkdown {
|
||||||
lastReportSection(markdown: report)
|
lastReportSection(markdown: report)
|
||||||
}
|
}
|
||||||
@@ -71,10 +79,84 @@ struct CuratorView: View {
|
|||||||
.padding(ScarfSpace.s4)
|
.padding(ScarfSpace.s4)
|
||||||
}
|
}
|
||||||
.background(ScarfColor.backgroundPrimary)
|
.background(ScarfColor.backgroundPrimary)
|
||||||
.task { await viewModel.load() }
|
.task {
|
||||||
|
await viewModel.load()
|
||||||
|
if archiveAvailable {
|
||||||
|
await viewModel.loadArchive()
|
||||||
|
}
|
||||||
|
}
|
||||||
.sheet(isPresented: $showRestoreSheet) {
|
.sheet(isPresented: $showRestoreSheet) {
|
||||||
CuratorRestoreSheet(viewModel: viewModel)
|
CuratorRestoreSheet(viewModel: viewModel)
|
||||||
}
|
}
|
||||||
|
.sheet(
|
||||||
|
isPresented: Binding(
|
||||||
|
get: { viewModel.pruneSummary != nil },
|
||||||
|
set: { isShown in
|
||||||
|
if !isShown { viewModel.cancelPrune() }
|
||||||
|
}
|
||||||
|
)
|
||||||
|
) {
|
||||||
|
if let summary = viewModel.pruneSummary {
|
||||||
|
CuratorPruneConfirmSheet(
|
||||||
|
summary: summary,
|
||||||
|
isPruning: viewModel.isPruning,
|
||||||
|
onConfirm: {
|
||||||
|
Task { await viewModel.confirmPrune() }
|
||||||
|
},
|
||||||
|
onCancel: {
|
||||||
|
viewModel.cancelPrune()
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@ViewBuilder
|
||||||
|
private var headerActions: some View {
|
||||||
|
HStack(spacing: ScarfSpace.s2) {
|
||||||
|
if viewModel.isLoading {
|
||||||
|
ProgressView().controlSize(.small)
|
||||||
|
}
|
||||||
|
Button("Run Now") {
|
||||||
|
Task {
|
||||||
|
await viewModel.runNow(
|
||||||
|
synchronous: archiveAvailable,
|
||||||
|
timeout: 600
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
.buttonStyle(ScarfPrimaryButton())
|
||||||
|
.disabled(viewModel.isLoading)
|
||||||
|
.help(archiveAvailable
|
||||||
|
? "Curator runs synchronously on Hermes v0.13+. Usually 10–90s."
|
||||||
|
: "Trigger a curator run. Returns immediately on pre-v0.13 hosts.")
|
||||||
|
|
||||||
|
Menu {
|
||||||
|
switch viewModel.status.state {
|
||||||
|
case .paused:
|
||||||
|
Button("Resume") { Task { await viewModel.resume() } }
|
||||||
|
case .enabled:
|
||||||
|
Button("Pause") { Task { await viewModel.pause() } }
|
||||||
|
default:
|
||||||
|
EmptyView()
|
||||||
|
}
|
||||||
|
|
||||||
|
if archiveAvailable {
|
||||||
|
Divider()
|
||||||
|
Button("Prune Archived…", role: .destructive) {
|
||||||
|
Task { await viewModel.planPrune() }
|
||||||
|
}
|
||||||
|
.disabled(viewModel.archivedSkills.isEmpty && !viewModel.isLoadingArchive)
|
||||||
|
} else {
|
||||||
|
Button("Restore Archived…") {
|
||||||
|
showRestoreSheet = true
|
||||||
|
}
|
||||||
|
.disabled(viewModel.status.archivedSkills == 0)
|
||||||
|
}
|
||||||
|
} label: {
|
||||||
|
Image(systemName: "ellipsis.circle")
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private var statusSummary: some View {
|
private var statusSummary: some View {
|
||||||
@@ -206,6 +288,10 @@ struct CuratorView: View {
|
|||||||
}
|
}
|
||||||
.buttonStyle(.plain)
|
.buttonStyle(.plain)
|
||||||
.help(viewModel.status.pinnedNames.contains(row.name) ? "Pinned" : "Pin skill")
|
.help(viewModel.status.pinnedNames.contains(row.name) ? "Pinned" : "Pin skill")
|
||||||
|
|
||||||
|
if archiveAvailable {
|
||||||
|
archiveButton(for: row.name)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
.padding(.vertical, 2)
|
.padding(.vertical, 2)
|
||||||
}
|
}
|
||||||
@@ -213,6 +299,25 @@ struct CuratorView: View {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ViewBuilder
|
||||||
|
private func archiveButton(for name: String) -> some View {
|
||||||
|
if viewModel.pendingArchiveName == name {
|
||||||
|
ProgressView()
|
||||||
|
.controlSize(.small)
|
||||||
|
.frame(width: 14, height: 14)
|
||||||
|
} else {
|
||||||
|
Button {
|
||||||
|
Task { await viewModel.archive(name) }
|
||||||
|
} label: {
|
||||||
|
Image(systemName: "archivebox")
|
||||||
|
.font(.system(size: 12))
|
||||||
|
}
|
||||||
|
.buttonStyle(.plain)
|
||||||
|
.help("Archive (move out of active set)")
|
||||||
|
.disabled(viewModel.pendingArchiveName != nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
private func counterChip(label: String, value: Int) -> some View {
|
private func counterChip(label: String, value: Int) -> some View {
|
||||||
Text("\(label) \(value)")
|
Text("\(label) \(value)")
|
||||||
.font(ScarfFont.monoSmall)
|
.font(ScarfFont.monoSmall)
|
||||||
@@ -277,6 +382,35 @@ struct CuratorView: View {
|
|||||||
.background(ScarfColor.accentTint)
|
.background(ScarfColor.accentTint)
|
||||||
.clipShape(RoundedRectangle(cornerRadius: ScarfRadius.md))
|
.clipShape(RoundedRectangle(cornerRadius: ScarfRadius.md))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Inline yellow banner for CLI failures. Non-blocking — sits above
|
||||||
|
/// the status summary and dismisses with the "x" so users can keep
|
||||||
|
/// interacting with the leaderboard. Mirrors the pattern in
|
||||||
|
/// KanbanBoardView.
|
||||||
|
private func errorBanner(_ message: String) -> some View {
|
||||||
|
HStack(alignment: .top, spacing: ScarfSpace.s2) {
|
||||||
|
Image(systemName: "exclamationmark.triangle.fill")
|
||||||
|
.foregroundStyle(ScarfColor.warning)
|
||||||
|
Text(message)
|
||||||
|
.scarfStyle(.caption)
|
||||||
|
.foregroundStyle(ScarfColor.foregroundPrimary)
|
||||||
|
.frame(maxWidth: .infinity, alignment: .leading)
|
||||||
|
Button {
|
||||||
|
viewModel.dismissError()
|
||||||
|
} label: {
|
||||||
|
Image(systemName: "xmark.circle.fill")
|
||||||
|
.foregroundStyle(ScarfColor.foregroundMuted)
|
||||||
|
}
|
||||||
|
.buttonStyle(.plain)
|
||||||
|
.help("Dismiss")
|
||||||
|
}
|
||||||
|
.padding(.horizontal, ScarfSpace.s3)
|
||||||
|
.padding(.vertical, ScarfSpace.s2)
|
||||||
|
.background(
|
||||||
|
RoundedRectangle(cornerRadius: ScarfRadius.md)
|
||||||
|
.fill(ScarfColor.warning.opacity(0.12))
|
||||||
|
)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Simple `FlowLayout` for the pinned-skill chips. Custom layout
|
/// Simple `FlowLayout` for the pinned-skill chips. Custom layout
|
||||||
|
|||||||
@@ -195,24 +195,6 @@ final class SettingsViewModel {
|
|||||||
setSetting("auxiliary.\(task).timeout", value: String(value))
|
setSetting("auxiliary.\(task).timeout", value: String(value))
|
||||||
}
|
}
|
||||||
|
|
||||||
// MARK: - Image generation (v0.13+)
|
|
||||||
|
|
||||||
/// `image_gen.model` — overrides the per-provider default image
|
|
||||||
/// model (Hermes v0.13+). Empty string clears the override.
|
|
||||||
/// Capability-gated in `AuxiliaryTab` so pre-v0.13 hosts never
|
|
||||||
/// invoke this setter.
|
|
||||||
func setImageGenModel(_ value: String) { setSetting("image_gen.model", value: value) }
|
|
||||||
|
|
||||||
/// `openrouter.response_cache.enabled` — toggles OpenRouter
|
|
||||||
/// response caching for repeat prompts (Hermes v0.13+).
|
|
||||||
/// Capability-gated in `AuxiliaryTab` so pre-v0.13 hosts never
|
|
||||||
/// invoke this setter.
|
|
||||||
// TODO(WS-6-Q1): the YAML key path is provisional — keep in lockstep
|
|
||||||
// with `HermesConfig+YAML.swift`'s parser line.
|
|
||||||
func setOpenRouterResponseCache(_ value: Bool) {
|
|
||||||
setSetting("openrouter.response_cache.enabled", value: value ? "true" : "false")
|
|
||||||
}
|
|
||||||
|
|
||||||
// MARK: - Security / Privacy
|
// MARK: - Security / Privacy
|
||||||
|
|
||||||
func setRedactSecrets(_ value: Bool) { setSetting("security.redact_secrets", value: value ? "true" : "false") }
|
func setRedactSecrets(_ value: Bool) { setSetting("security.redact_secrets", value: value ? "true" : "false") }
|
||||||
|
|||||||
@@ -139,23 +139,6 @@ struct AuxiliaryTab: View {
|
|||||||
auxRows(for: task.key)
|
auxRows(for: task.key)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
// -- Hermes v0.13 additions ---------------------------------
|
|
||||||
// Image-gen model picker. Hermes v0.13 honors `image_gen.model`
|
|
||||||
// as a top-level YAML key; pre-v0.13 hosts ignore it silently.
|
|
||||||
// Hide the section on pre-v0.13 hosts to spare users a
|
|
||||||
// "I set this and nothing happened" trap.
|
|
||||||
if capabilitiesStore?.capabilities.hasImageGenModel ?? false {
|
|
||||||
SettingsSection(title: "Image Generation", icon: "photo") {
|
|
||||||
imageGenRow
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// OpenRouter response caching toggle (v0.13+). Same hide-on-
|
|
||||||
// pre-v0.13 rationale: the toggle no-ops on older Hermes hosts.
|
|
||||||
if capabilitiesStore?.capabilities.hasOpenRouterResponseCache ?? false {
|
|
||||||
SettingsSection(title: "OpenRouter", icon: "shippingbox") {
|
|
||||||
openRouterResponseCacheRow
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// Unknown / unrecognised aux tasks present in config.yaml.
|
// Unknown / unrecognised aux tasks present in config.yaml.
|
||||||
// Shown only when at least one such key is present so the
|
// Shown only when at least one such key is present so the
|
||||||
// typical user with a clean config never sees this section.
|
// typical user with a clean config never sees this section.
|
||||||
@@ -242,60 +225,6 @@ struct AuxiliaryTab: View {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// MARK: - v0.13 surfaces
|
|
||||||
|
|
||||||
/// Image-gen model picker — curated allowlist + free-form custom
|
|
||||||
/// entry. Capability-gated by the caller; this view assumes the
|
|
||||||
/// host honors `image_gen.model` (Hermes v0.13+).
|
|
||||||
@ViewBuilder
|
|
||||||
private var imageGenRow: some View {
|
|
||||||
let value = viewModel.config.imageGenModel
|
|
||||||
Picker("Model", selection: Binding(
|
|
||||||
get: { value },
|
|
||||||
set: { viewModel.setImageGenModel($0) }
|
|
||||||
)) {
|
|
||||||
Text("Provider default").tag("")
|
|
||||||
Divider()
|
|
||||||
ForEach(ModelCatalogService.imageGenModels) { model in
|
|
||||||
Text(model.display).tag(model.modelID)
|
|
||||||
}
|
|
||||||
// User has set a custom value not in the curated list;
|
|
||||||
// preserve it as a tagged option so the picker renders the
|
|
||||||
// actual selection rather than collapsing to "Provider
|
|
||||||
// default".
|
|
||||||
if !value.isEmpty
|
|
||||||
&& !ModelCatalogService.imageGenModels.contains(where: { $0.modelID == value }) {
|
|
||||||
Divider()
|
|
||||||
Text(value + " (custom)").tag(value)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
.pickerStyle(.menu)
|
|
||||||
EditableTextField(label: "Custom model ID", value: value) { newValue in
|
|
||||||
viewModel.setImageGenModel(newValue.trimmingCharacters(in: .whitespaces))
|
|
||||||
}
|
|
||||||
Text("Used for image generation calls. Leave as Provider default unless your provider documents a specific model ID for image-gen.")
|
|
||||||
.font(.caption2)
|
|
||||||
.foregroundStyle(.tertiary)
|
|
||||||
.padding(.horizontal, 12)
|
|
||||||
.padding(.bottom, 4)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// OpenRouter response-caching toggle (Hermes v0.13+). Off by
|
|
||||||
/// default; surfaced for users with highly repeated prompts who
|
|
||||||
/// want OpenRouter to cache identical-prompt responses.
|
|
||||||
@ViewBuilder
|
|
||||||
private var openRouterResponseCacheRow: some View {
|
|
||||||
let isOn = viewModel.config.openrouterResponseCacheEnabled
|
|
||||||
ToggleRow(label: "Response caching", isOn: isOn) { newValue in
|
|
||||||
viewModel.setOpenRouterResponseCache(newValue)
|
|
||||||
}
|
|
||||||
Text("OpenRouter caches identical prompts within a session to reduce token costs. Off by default — enable when your workload has highly repeated prompts.")
|
|
||||||
.font(.caption2)
|
|
||||||
.foregroundStyle(.tertiary)
|
|
||||||
.padding(.horizontal, 12)
|
|
||||||
.padding(.bottom, 4)
|
|
||||||
}
|
|
||||||
|
|
||||||
private func auxModel(for key: String) -> AuxiliaryModel {
|
private func auxModel(for key: String) -> AuxiliaryModel {
|
||||||
switch key {
|
switch key {
|
||||||
case "vision": return viewModel.config.auxiliary.vision
|
case "vision": return viewModel.config.auxiliary.vision
|
||||||
|
|||||||
Reference in New Issue
Block a user