Files
hapi/ios/Packages/HapiKit/Sources/HapiClient/Endpoints/MachineEndpoints.swift
T
14f2dd763e feat(ios): session citations, custom Claude models and chat status polish
- Copy a session citation from the list (native parity with the web
  reference text) and open the paired session list via
  hapicompanion://sessions.
- Load hub-wide custom Claude models in New Session with machine-catalog
  fallback, and show the transcript-resolved model in chat chrome.
- Render synthetic Claude API failures as error events instead of leaking
  the <synthetic> model or zero usage into the context meter.
- Refresh the session list returning from chat, request the list from Home,
  and update the home widget surfaces.

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

Co-Authored-By: HAPI <noreply@hapi.run>
Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-11-08 20:24:30 +08:00

100 lines
4.1 KiB
Swift

import Foundation
import HapiProtocol
/// Machines and spawning (`docs/api/client-contract/rest.md`).
extension APIClient {
/// `GET /api/machines` — online machines in the caller's namespace.
public func listMachines() async throws -> [Machine] {
let response: MachinesResponse = try await request(.get, "/api/machines")
return response.machines
}
/// `PATCH /api/machines/:id` — rename (≤ 64 chars; empty string clears
/// the custom name back to the hostname).
public func renameMachine(id: String, displayName: String) async throws {
struct RenameMachineRequest: Encodable {
let displayName: String
}
try await requestVoid(
.patch,
"/api/machines/\(encodePathComponent(id))",
body: RenameMachineRequest(displayName: displayName)
)
}
/// `POST /api/machines/:id/spawn`. The response is discriminated on
/// `type`, not HTTP status — a failed spawn is still HTTP 200 with
/// `.error`.
public func spawnSession(machineId: String, _ spawn: SpawnRequest) async throws -> SpawnResponse {
try await request(
.post,
"/api/machines/\(encodePathComponent(machineId))/spawn",
body: spawn
)
}
/// `GET /api/machines/:id/agent-availability` — executable/static-config
/// availability for every supported Agent. A runner lacking the RPC
/// answers 409 `runner_upgrade_required`.
public func machineAgentAvailability(machineId: String) async throws -> AgentAvailabilityResponse {
try await request(.get, "/api/machines/\(encodePathComponent(machineId))/agent-availability")
}
/// `POST /api/machines/:id/list-directory` (RPC envelope — check
/// `success`).
public func listMachineDirectory(
machineId: String,
path: String,
includeHidden: Bool = false
) async throws -> MachineListDirectoryResponse {
struct ListDirectoryRequest: Encodable {
let path: String
let includeHidden: Bool
}
return try await request(
.post,
"/api/machines/\(encodePathComponent(machineId))/list-directory",
body: ListDirectoryRequest(path: path, includeHidden: includeHidden)
)
}
/// `POST /api/machines/:id/paths/exists` (≤ 1000 paths).
public func machinePathsExist(
machineId: String,
paths: [String]
) async throws -> MachinePathsExistsResponse {
struct PathsExistsRequest: Encodable {
let paths: [String]
}
return try await request(
.post,
"/api/machines/\(encodePathComponent(machineId))/paths/exists",
body: PathsExistsRequest(paths: paths)
)
}
/// `GET /api/machines/:id/codex-models` — pre-spawn codex model catalog
/// (RPC envelope — check `success`). A runner without the machine-scoped
/// RPC answers 503 `rpc_target_missing`, surfaced as an ``APIError``
/// whose `code` the new-session form uses to hide the picker. Added in
/// A-M3c (endpoint documented in `docs/api/client-contract/rest.md`).
public func machineCodexModels(machineId: String) async throws -> CodexModelsResponse {
try await request(.get, "/api/machines/\(encodePathComponent(machineId))/codex-models")
}
/// `GET /api/machines/:id/claude-models` — the Claude CLI's own model
/// list for this machine (RPC envelope — check `success`). The create
/// form falls back to its static presets while loading or when a runner
/// lacks the RPC.
public func machineClaudeModels(machineId: String) async throws -> ClaudeModelsResponse {
try await request(.get, "/api/machines/\(encodePathComponent(machineId))/claude-models")
}
/// `GET /api/claude/custom-models` — model names configured for a custom
/// Anthropic-compatible endpoint. These must be offered explicitly because
/// Claude Code's model picker only knows Claude aliases.
public func claudeCustomModels() async throws -> ClaudeCustomModelsResponse {
try await request(.get, "/api/claude/custom-models")
}
}