Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Send unreachable Patrol providers to Provider & Models
rcourtmanc76522e64ed2
diff --git a/docs/release-control/v6/internal/subsystems/api-contracts.md b/docs/release-control/v6/internal/subsystems/api-contracts.mdindex 230e3ed2a2..a63a544277 100644--- a/docs/release-control/v6/internal/subsystems/api-contracts.md+++ b/docs/release-control/v6/internal/subsystems/api-contracts.md@@ -32,6 +32,8 @@ only when the cost model slows the untouched default), `POSTPatrol settings rely on.The panel loads on demand, so none of these requests is made until Patrol isblocked and the operator starts setup.+The `provider_connection` readiness cause is read as it is: it changes only+where the Patrol page sends the operator, not any payload.### Patrol autonomy reports the Pro defaultdiff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.mdindex a63101efec..9bfb3079d7 100644--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md@@ -29,6 +29,8 @@ phone width the cards stack two per row and the action buttons keep 44pxtargets.The workspace mounts it through `lazy` and `Suspense` with no fallback, so thesetup card shows the panel once its chunk loads.+An unreachable provider keeps the existing setup card and `ButtonLink`, now+pointing at Provider & Models.### Patrol header default-mode notice uses existing primitivesdiff --git a/docs/release-control/v6/internal/subsystems/patrol-intelligence.md b/docs/release-control/v6/internal/subsystems/patrol-intelligence.mdindex 509844aef4..6c1ae7b5bf 100644--- a/docs/release-control/v6/internal/subsystems/patrol-intelligence.md+++ b/docs/release-control/v6/internal/subsystems/patrol-intelligence.md@@ -49,6 +49,11 @@ and `frontend-modern/src/utils/__tests__/patrolRuntimeActions.test.ts`.The workspace loads `PatrolSetupPanel.tsx` lazily, passing the readinessprovider as `readinessProvider`, so the panel's AI settings, provider and costcode stays out of the `AIIntelligence` chunk and its bundle budget.+An unreachable provider (`provider_connection`: wrong URL, server down,+network) also routes the setup action to Provider & Models, with the subtitle+`PATROL_WORKSPACE_UNREACHABLE_DESCRIPTION` and no model-check hint, but it does+not open the setup panel: a passing network blip must not ask a cloud user to+re-enter a key that works.### Pro default notice and the not-running headerdiff --git a/frontend-modern/browser-verification/1968a550db2b2cdf.json b/frontend-modern/browser-verification/1968a550db2b2cdf.jsonnew file mode 100644index 0000000000..250ef331ae--- /dev/null+++ b/frontend-modern/browser-verification/1968a550db2b2cdf.json@@ -0,0 +1,39 @@+{+ "version": 1,+ "base_sha": "7989a9b970fcb09952d613c45a1c39a9dd13e233",+ "verified_at": "2026-10-12T22:45:00Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/features/patrol/patrolControlPresentation.ts",+ "frontend-modern/src/utils/patrolRuntimeActions.ts"+ ],+ "content_sha256": {+ "frontend-modern/src/features/patrol/patrolControlPresentation.ts": "ec5db5a7333c9de7ca1f448d183f7df09b4da9422978c73d7069c8bff73779a4",+ "frontend-modern/src/utils/patrolRuntimeActions.ts": "a2c695e69af93268f6d07a3c8c48847b5ccf52c9d1b88b4f8c471ac945f7b78a"+ },+ "routes": [+ "/patrol"+ ],+ "viewports": [+ {+ "width": 1280,+ "height": 900+ },+ {+ "width": 375,+ "height": 812+ }+ ],+ "states": [+ "Saved Ollama URL with nothing listening, patrol model ollama:qwen3:8b (readiness cause provider_connection): setup card subtitle 'Pulse cannot reach your AI provider. Check its address and status on Provider & Models.', reason 'Provider connection issue', single action 'Open Provider & Models' to /settings/pulse-intelligence/provider, no 'run the model check' hint, no setup panel",+ "Phone width: no horizontal overflow, action 44px"+ ],+ "interactions": [+ "Reload after the import fix: no console ReferenceError or TypeError"+ ],+ "browser": {+ "client": "Claude desktop browser pane",+ "engine": "Chromium"+ },+ "scope": "Dev server on this branch proxied to a private non-mock pulse-enterprise stack on :7681 with a dev Pro licence; the unreachable provider state was set through PUT /api/settings/ai/update."+}diff --git a/frontend-modern/src/features/patrol/__tests__/patrolControlPresentation.test.ts b/frontend-modern/src/features/patrol/__tests__/patrolControlPresentation.test.tsindex d97157f6a9..2bcaa9e491 100644--- a/frontend-modern/src/features/patrol/__tests__/patrolControlPresentation.test.ts+++ b/frontend-modern/src/features/patrol/__tests__/patrolControlPresentation.test.ts@@ -19,6 +19,7 @@ import {PATROL_WORKSPACE_QUEUE_TITLE,PATROL_WORKSPACE_CONNECT_DESCRIPTION,PATROL_WORKSPACE_RECONNECT_DESCRIPTION,+ PATROL_WORKSPACE_UNREACHABLE_DESCRIPTION,PATROL_WORKSPACE_SETUP_DESCRIPTION,} from '../patrolControlPresentation';@@ -41,6 +42,10 @@ describe('patrolControlPresentation', () => {expect(getPatrolWorkspaceSetupDescription('provider_auth')).toBe(PATROL_WORKSPACE_RECONNECT_DESCRIPTION,);+ expect(getPatrolWorkspaceSetupDescription('provider_connection')).toBe(+ PATROL_WORKSPACE_UNREACHABLE_DESCRIPTION,+ );+ expect(PATROL_WORKSPACE_UNREACHABLE_DESCRIPTION).not.toMatch(/tool check/);});it.each([diff --git a/frontend-modern/src/features/patrol/patrolControlPresentation.ts b/frontend-modern/src/features/patrol/patrolControlPresentation.tsindex 3079f09eb9..13c92a2618 100644--- a/frontend-modern/src/features/patrol/patrolControlPresentation.ts+++ b/frontend-modern/src/features/patrol/patrolControlPresentation.ts@@ -12,7 +12,11 @@ import {} from '@/utils/aiFindingPresentation';import type { PatrolWorkTypeComposition } from '@/utils/aiFindingPresentation';import { getPatrolRunCoverageSummary } from '@/utils/patrolRunPresentation';-import { isPatrolConfigLevelCause, PATROL_PROVIDER_AUTH_CAUSE } from '@/utils/patrolRuntimeActions';+import {+ isPatrolConfigLevelCause,+ PATROL_PROVIDER_AUTH_CAUSE,+ PATROL_PROVIDER_CONNECTION_CAUSE,+} from '@/utils/patrolRuntimeActions';import type { UpgradeDestination } from '@/utils/upgradeNavigation';export const PATROL_AUTONOMY_POLICY_PRESENTATION: Record<@@ -64,6 +68,9 @@ export const PATROL_WORKSPACE_CONNECT_DESCRIPTION =export const PATROL_WORKSPACE_RECONNECT_DESCRIPTION ='Your AI provider refused Patrol’s connection. Reconnect it so Patrol can run.';+export const PATROL_WORKSPACE_UNREACHABLE_DESCRIPTION =+ 'Pulse cannot reach your AI provider. Check its address and status on Provider & Models.';+export const PATROL_WORKSPACE_SETUP_ACTIVE_DESCRIPTION ='Connect a model and check it here. Patrol starts once the check passes.';@@ -72,6 +79,7 @@ export function getPatrolWorkspaceSetupDescription(cause?: string | null): strin// No provider or AI off: the model check is not the next step yet.if (isPatrolConfigLevelCause(cause ?? undefined)) return PATROL_WORKSPACE_CONNECT_DESCRIPTION;if (cause === PATROL_PROVIDER_AUTH_CAUSE) return PATROL_WORKSPACE_RECONNECT_DESCRIPTION;+ if (cause === PATROL_PROVIDER_CONNECTION_CAUSE) return PATROL_WORKSPACE_UNREACHABLE_DESCRIPTION;return PATROL_WORKSPACE_SETUP_DESCRIPTION;}diff --git a/frontend-modern/src/utils/__tests__/patrolRuntimeActions.test.ts b/frontend-modern/src/utils/__tests__/patrolRuntimeActions.test.tsindex 8f5190e41c..118c70bfba 100644--- a/frontend-modern/src/utils/__tests__/patrolRuntimeActions.test.ts+++ b/frontend-modern/src/utils/__tests__/patrolRuntimeActions.test.ts@@ -17,6 +17,8 @@ describe('patrolRuntimeActions', () => {expect(isPatrolConnectCause('provider_auth')).toBe(true);expect(isPatrolConnectCause('provider_not_configured')).toBe(true);expect(isPatrolConnectCause('model_unsupported_tools')).toBe(false);+ // Unreachable is not a reconnect: a network blip must not ask for a working key again.+ expect(isPatrolConnectCause('provider_connection')).toBe(false);for (const cause of ['model_unsupported_tools',PATROL_BUDGET_EXHAUSTED_CAUSE,@@ -41,7 +43,12 @@ describe('patrolRuntimeActions', () => {it('routes config-level causes to Provider & Models instead of the model check', () => {// A refused key is fixed where the key lives, not by re-running the model check.- for (const cause of ['assistant_disabled', 'provider_not_configured', 'provider_auth']) {+ for (const cause of [+ 'assistant_disabled',+ 'provider_not_configured',+ 'provider_auth',+ 'provider_connection',+ ]) {expect(getPatrolSetupAction(cause)).toEqual({label: 'Open Provider & Models',href: '/settings/pulse-intelligence/provider',@@ -66,6 +73,8 @@ describe('patrolRuntimeActions', () => {it('suppresses the tool-check hint for config-level causes', () => {expect(getPatrolSetupHint('assistant_disabled')).toBe('');expect(getPatrolSetupHint('provider_not_configured')).toBe('');+ // "Provider connectivity can be healthy" is false when the provider is unreachable.+ expect(getPatrolSetupHint('provider_connection')).toBe('');expect(getPatrolSetupHint('model_not_selected')).toContain('run the model check');expect(getPatrolSetupHint(undefined)).toContain('run the model check');});diff --git a/frontend-modern/src/utils/patrolRuntimeActions.ts b/frontend-modern/src/utils/patrolRuntimeActions.tsindex 0b539cb509..d67989bfd7 100644--- a/frontend-modern/src/utils/patrolRuntimeActions.ts+++ b/frontend-modern/src/utils/patrolRuntimeActions.ts@@ -27,6 +27,15 @@ export const PATROL_PROVIDER_AUTH_CAUSE = 'provider_auth';export const isPatrolConnectCause = (cause?: string): boolean =>isPatrolConfigLevelCause(cause) || cause === PATROL_PROVIDER_AUTH_CAUSE;+// Pulse could not reach the saved provider (wrong URL, server down, network).+// The model check cannot fix that; the provider's URL and its test live on+// Provider & Models. It is not a setup-panel cause, because a passing network+// blip would ask a cloud user for a key that is fine.+export const PATROL_PROVIDER_CONNECTION_CAUSE = 'provider_connection';++const isPatrolProviderSettingsCause = (cause?: string): boolean =>+ isPatrolConnectCause(cause) || cause === PATROL_PROVIDER_CONNECTION_CAUSE;+export const getPatrolProviderSettingsAction = (): PatrolRuntimeActionPresentation => ({...PATROL_PROVIDER_SETTINGS_ACTION,});@@ -40,7 +49,7 @@ export const getPatrolSetupAction = (cause?: string): PatrolRuntimeActionPresentif (cause === PATROL_BUDGET_EXHAUSTED_CAUSE) {return { label: 'Raise the cost budget', href: settingsTabPath('system-ai') };}- if (isPatrolConnectCause(cause)) {+ if (isPatrolProviderSettingsCause(cause)) {return { label: 'Open Provider & Models', href: settingsTabPath('system-ai') };}return { ...PATROL_PROVIDER_SETTINGS_ACTION };@@ -52,7 +61,7 @@ export const getPatrolSetupHint = (cause?: string): string => {if (cause === PATROL_BUDGET_EXHAUSTED_CAUSE) {return '';}- if (isPatrolConnectCause(cause)) {+ if (isPatrolProviderSettingsCause(cause)) {return '';}return 'Open Patrol settings and run the model check. Provider connectivity can be healthy even when the selected model cannot use Patrol tools.';