Files
openclaw/apps/macos/Sources/OpenClaw/OnboardingView+Monitoring.swift
Peter Steinberger 96f0983a85 fix(onboarding): skip setup for configured gateways and require inference first (#102883)
* fix(crestodian): keep onboarding RPCs restart-safe

* fix(profiles): isolate approval state migrations

* fix(crestodian): bypass configured gateway setup

* test(crestodian): type onboarding mocks

* fix(onboarding): require inference before Crestodian

* fix(onboarding): enforce verified inference handoff

* fix(macos): reset setup on gateway endpoint edits

* chore(i18n): refresh native source inventory

* fix(gateway): keep socket on request cancellation

* test(packaging): require workspace templates

* fix(onboarding): bind setup to verified inference

* fix(onboarding): align inference gate contracts

* fix(crestodian): classify concurrent policy rejection

* test(crestodian): expect registry restoration

* fix(onboarding): bind setup to configured gateways

* fix(codex): preserve startup phase deadlines

* test(crestodian): match fail-closed policy ordering

* test(onboarding): assert bound gateway handoff

* fix(codex): bind runtime resolution to spawn cwd

* test(crestodian): assert policy rejection order

* fix(cli): preserve gateway routing across restarts

* fix(macos): fail closed during gateway edits

* test(macos): cover gateway route generation races

* chore: keep release notes out of onboarding PR

* fix(ci): refresh onboarding generated checks

* style(swift): align gateway channel formatting

* fix(ci): refresh plugin SDK surface budgets

* fix(ci): resync native string inventory

* refactor(swift): split gateway channel support

* test(doctor): isolate plugin compatibility registry

* test(macos): isolate gateway onboarding fixtures

* test(macos): assert gateway lease health ordering

* fix(codex): reconcile computer-use startup changes
2026-07-11 10:25:14 -07:00

216 lines
7.7 KiB
Swift

import Foundation
import OpenClawIPC
extension OnboardingView {
@MainActor
func refreshPerms() async {
await permissionMonitor.refreshNow()
}
@MainActor
func request(_ cap: Capability) async {
guard !isRequesting else { return }
isRequesting = true
defer { isRequesting = false }
_ = await PermissionManager.ensure([cap], interactive: true)
await self.refreshPerms()
}
func updatePermissionMonitoring(for pageIndex: Int) {
PermissionMonitoringSupport.setMonitoring(
pageIndex == permissionsPageIndex,
monitoring: &monitoringPermissions)
}
func updateDiscoveryMonitoring(for pageIndex: Int) {
let isConnectionPage = pageIndex == connectionPageIndex
let shouldMonitor = isConnectionPage
if shouldMonitor, !monitoringDiscovery {
monitoringDiscovery = true
Task { @MainActor in
try? await Task.sleep(nanoseconds: 150_000_000)
guard self.monitoringDiscovery else { return }
self.gatewayDiscovery.start()
await self.refreshLocalGatewayProbe()
}
} else if !shouldMonitor, monitoringDiscovery {
monitoringDiscovery = false
gatewayDiscovery.stop()
}
}
func updateMonitoring(for pageIndex: Int) {
self.updatePermissionMonitoring(for: pageIndex)
self.updateDiscoveryMonitoring(for: pageIndex)
self.maybeInstallCLI(for: pageIndex)
self.maybeStartAISetup(for: pageIndex)
}
func maybeInstallCLI(for pageIndex: Int) {
if pageIndex == cliPageIndex, cliExecutableReady {
self.startExistingCLIActivationIfNeeded()
return
}
guard Self.shouldAutoInstallCLI(
onCLIPage: pageIndex == cliPageIndex,
isLocal: state.connectionMode == .local,
visible: onboardingVisible,
statusKnown: cliStatusKnown,
executableReady: cliExecutableReady,
installed: cliInstalled,
installing: installingCLI)
else { return }
self.startCLIInstall()
}
static func shouldAutoInstallCLI(
onCLIPage: Bool,
isLocal: Bool,
visible: Bool,
statusKnown: Bool,
executableReady: Bool,
installed: Bool,
installing: Bool) -> Bool
{
onCLIPage && isLocal && visible && statusKnown && !executableReady && !installed && !installing
}
func startExistingCLIActivationIfNeeded() {
guard Self.shouldStartExistingCLIActivation(
isLocal: state.connectionMode == .local,
executableReady: cliExecutableReady,
installing: installingCLI)
else { return }
// Keep the CLI setup gate in the page order until its Gateway is reachable.
cliInstalled = false
installingCLI = true
cliInstallPhase = .startingService
OnboardingController.shared.setWindowCloseEnabled(false)
OnboardingController.shared.busyReason = "OpenClaw is starting the Gateway service."
cliStatus = "Starting OpenClaw Gateway…"
Task { @MainActor in await self.finishExistingCLIActivation() }
}
static func shouldStartExistingCLIActivation(
isLocal: Bool,
executableReady: Bool,
installing: Bool) -> Bool
{
isLocal && executableReady && !installing
}
func finishExistingCLIActivation() async {
defer {
installingCLI = false
cliInstallPhase = .idle
OnboardingController.shared.setWindowCloseEnabled(true)
OnboardingController.shared.busyReason = nil
}
let result = await CLIInstaller.activateLocalGateway()
guard state.connectionMode == .local else {
cliInstalled = true
return
}
switch result {
case .ready:
cliInstalled = true
cliStatus = "OpenClaw Gateway is ready."
case .deferred:
cliInstalled = false
cliStatus = "OpenClaw is paused. Resume it, then retry setup to start the Gateway."
case .failed:
cliInstalled = false
cliStatus = "OpenClaw is installed, but the Gateway did not start. Retry setup."
}
}
func startCLIInstall() {
guard self.onboardingVisible, !installingCLI else { return }
installingCLI = true
OnboardingController.shared.setWindowCloseEnabled(false)
// Cmd-W bypasses the disabled close button; the delegate asks first.
OnboardingController.shared.busyReason = "OpenClaw is installing the Gateway service."
Task { @MainActor in await self.runCLIInstall() }
}
func stopPermissionMonitoring() {
PermissionMonitoringSupport.stopMonitoring(&monitoringPermissions)
}
func stopDiscovery() {
guard monitoringDiscovery else { return }
monitoringDiscovery = false
gatewayDiscovery.stop()
}
func runCLIInstall() async {
self.cliInstallPhase = .installing
defer {
self.installingCLI = false
self.cliInstallPhase = .idle
OnboardingController.shared.setWindowCloseEnabled(true)
OnboardingController.shared.busyReason = nil
}
guard let target = CLIInstallPrompter.shared.installTargetForCurrentBuild() else {
cliStatus = "CLI installation cancelled."
return
}
let installed = await CLIInstaller.install(target: target) { message in
self.cliStatus = message
}
guard installed else { return }
cliExecutableReady = true
cliInstallLocation = CLIInstaller.managedExecutableLocation()
cliStatus = "Starting OpenClaw Gateway…"
// The step checklist shows one spinner at a time: install first,
// then the service start.
self.cliInstallPhase = .startingService
switch await CLIInstaller.activateLocalGateway() {
case .ready:
cliStatus = "OpenClaw Gateway is ready."
case .deferred:
cliStatus = "OpenClaw is installed. The Gateway will start when This Mac is active and resumed."
case .failed:
cliStatus = "OpenClaw was installed, but the Gateway did not start. Retry setup."
return
}
cliInstalled = true
}
func refreshCLIStatus() async {
let status = await CLIInstaller.status()
// A startup probe may still be running when the user reaches the install page.
// Never let that stale result replace live installation progress.
guard self.onboardingVisible, !Task.isCancelled, !installingCLI else { return }
cliInstallLocation = status.location
cliExecutableReady = status.isReady
cliInstalled = status.isReady
cliStatusKnown = true
cliStatus = status.message
self.startExistingCLIActivationIfNeeded()
self.maybeInstallCLI(for: self.activePageIndex)
}
func refreshLocalGatewayProbe() async {
let port = GatewayEnvironment.gatewayPort()
let desc = await PortGuardian.shared.describe(port: port)
await MainActor.run {
guard let desc else {
self.localGatewayProbe = nil
return
}
let command = desc.command.trimmingCharacters(in: .whitespacesAndNewlines)
let expectedTokens = ["node", "openclaw", "tsx", "pnpm", "bun"]
let lower = command.lowercased()
let expected = expectedTokens.contains { lower.contains($0) }
self.localGatewayProbe = LocalGatewayProbe(
port: port,
pid: desc.pid,
command: command,
expected: expected)
}
}
}