Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

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.md
index 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), `POST
Patrol settings rely on.
The panel loads on demand, so none of these requests is made until Patrol is
blocked 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 default
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
index 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 44px
targets.
The workspace mounts it through `lazy` and `Suspense` with no fallback, so the
setup 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 primitives
diff --git a/docs/release-control/v6/internal/subsystems/patrol-intelligence.md b/docs/release-control/v6/internal/subsystems/patrol-intelligence.md
index 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 readiness
provider as `readinessProvider`, so the panel's AI settings, provider and cost
code 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 header
diff --git a/frontend-modern/browser-verification/1968a550db2b2cdf.json b/frontend-modern/browser-verification/1968a550db2b2cdf.json
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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): PatrolRuntimeActionPresent
if (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.';