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
Describe the Assistant surface as Pulse Mobile chat
rcourtmana32356ae9422
diff --git a/cmd/pulse-mcp/README.md b/cmd/pulse-mcp/README.mdindex a4078f9326..034c1010a0 100644--- a/cmd/pulse-mcp/README.md+++ b/cmd/pulse-mcp/README.md@@ -12,7 +12,7 @@ governed actions.<!-- pulse-mcp-surface-contract:start -->- **Pulse Intelligence Core**: Canonical context, governed actions, safety gates, approval state, action audit, and verification shared by Pulse Assistant, Pulse MCP, and Pulse Patrol.- **Pulse Patrol**: Patrol is the first-party operations surface: it checks infrastructure, investigates issues, follows the chosen Patrol mode before acting, verifies outcomes, and records what happened.-- **Pulse Assistant** (the native Pulse surface): The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions. Affordances: tools.+- **Pulse Assistant** (the native Pulse surface): The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired. Affordances: tools.- **Pulse MCP**: The external-agent adapter that projects canonical Pulse Intelligence capabilities as MCP tools. Affordances: tools, resources, prompts, and capability metadata.<!-- pulse-mcp-surface-contract:end -->@@ -424,6 +424,6 @@ The companion worked example, `cmd/agent-probe`, walks the samesubstrate as a plain HTTP client and is a useful reference for anyonebuilding a non-MCP integration. Together the two binaries demonstratePulse Intelligence's external-agent profiles: stdio MCP and direct HTTP-API. Pulse Assistant remains the first-party in-app surface over the-same governed contracts; `pulse-mcp` is the adapter for users who prefer-an external agent host.+API. Pulse Patrol is the first-party operations surface over the same+governed contracts, and Pulse has no in-app chat window; `pulse-mcp` is+how you ask about your infrastructure from an external agent host.diff --git a/docs/AI.md b/docs/AI.mdindex a979eb0727..b2ebbcc767 100644--- a/docs/AI.md+++ b/docs/AI.md@@ -12,7 +12,7 @@ Pulse Intelligence is built around a shared **Pulse Intelligence Core**: CanonicThat core is deliberately surfaced with Patrol as the primary built-in operator and Assistant plus MCP as access paths over the same governed capabilities:1. **Pulse Patrol**: Patrol is the first-party operations surface: it checks infrastructure, investigates issues, follows the chosen Patrol mode before acting, verifies outcomes, and records what happened.-2. **Pulse Assistant**: The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions. Affordances: tools.+2. **Pulse Assistant**: The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired. Affordances: tools.3. **Pulse MCP**: The external-agent adapter that projects canonical Pulse Intelligence capabilities as MCP tools. Affordances: tools, resources, prompts, and capability metadata.<!-- pulse-intelligence-overview:end -->diff --git a/docs/release-control/v6/internal/subsystems/ai-runtime.md b/docs/release-control/v6/internal/subsystems/ai-runtime.mdindex 8b1c00c478..67a49aab94 100644--- a/docs/release-control/v6/internal/subsystems/ai-runtime.md+++ b/docs/release-control/v6/internal/subsystems/ai-runtime.md@@ -1735,8 +1735,9 @@ slot it returns an honest typed conflict; automatic scoped triggers retaintheir bounded internal requeue path.Pulse Intelligence presents Patrol as the primary first-party operations-surface. Pulse Assistant is the in-app contextual explanation, approval-card,-governed-action, verification, and handoff access path over Patrol work.+surface. Pulse Assistant is now only the chat surface Pulse Mobile uses over+the same governed tools; its in-app chat window and Patrol-work handoffs were+retired on 2026-10-22.`cmd/pulse-mcp/` is the external-agent adapter for MCP-speaking clients. Theadapter must stay thin: it fetches `/api/agent/capabilities`, projects thatcanonical manifest as MCP tools, and forwards calls to the declared API routes.@@ -7578,3 +7579,14 @@ fallback governance names drop it; the shared `pulse_question` declaration in`agentcapabilities` is unchanged. Patrol investigations, provider routing, model-boundarysanitizing, approvals, and the Pulse Mobile chat contract are unchanged.Proof: `agentic_question_tool_test.go` and the interaction scenario corpus.++The canonical manifest's Pulse Assistant surface description now names its+remaining role (2026-10-23): the chat surface Pulse Mobile uses over the same+governed tools, approvals, and verification, with the in-app web chat window+retired. It no longer calls the surface a handoff surface for Patrol findings,+which the retired window was. The generated `docs/AI.md` overview and+`cmd/pulse-mcp/README.md` surface block follow it, and the browser's fallback+affordances for an undeclared Assistant surface in+`frontend-modern/src/api/agentCapabilities.ts` no longer include interactive+questions, matching `DefaultSurfaceAffordancesForID`. Surface IDs, labels,+tools, and approval boundaries are unchanged.diff --git a/docs/release-control/v6/internal/subsystems/api-contracts.md b/docs/release-control/v6/internal/subsystems/api-contracts.mdindex 42a6e6f41d..2c2a21facc 100644--- a/docs/release-control/v6/internal/subsystems/api-contracts.md+++ b/docs/release-control/v6/internal/subsystems/api-contracts.md@@ -12511,3 +12511,11 @@ surface blocks follow it. `/api/ai/status` stays for the devhealth check. Proof: `route_inventory_test.go`,`router_routes_additional_test.go`, `security_regression_test.go`, and`frontend-modern/src/utils/__tests__/docsLinks.test.ts`.++The `/api/agent/capabilities` manifest's Pulse Assistant surface description+changed on 2026-10-23 to describe the Pulse Mobile chat surface instead of the+retired web chat's Patrol-finding handoff role. The surface ID, label, and+affordance fields keep their shape. The browser normalizer's fallback for an+undeclared Assistant surface (`frontend-modern/src/api/agentCapabilities.ts`)+now matches the backend default of tools only, so the External agents settings+panel never shows an "Interactive questions" badge.diff --git a/docs/release-control/v6/internal/subsystems/patrol-intelligence.md b/docs/release-control/v6/internal/subsystems/patrol-intelligence.mdindex 8b4bf0b36c..bcfec9a7f7 100644--- a/docs/release-control/v6/internal/subsystems/patrol-intelligence.md+++ b/docs/release-control/v6/internal/subsystems/patrol-intelligence.md@@ -1164,9 +1164,9 @@ horizontally scrolling rail that leaves a lifecycle view clipped or hidden.The default view owns only the ordered action queue. Legacy Patrol checks,investigations, and run history remain available under collapsed supportingcontext. The selected detail owns impact, related resources, evidence quality,-protection posture, timeline, next step, resource navigation, and the-contextual Assistant handoff. Assistant is absent before selection and receives-explanation-only typed context without action or approval authority. Browser+protection posture, timeline, next step, and resource navigation. Its+contextual Assistant handoff was removed with the retired chat window on+2026-10-22. Browserproof is `tests/integration/tests/91-operational-trust-attention-workbench.spec.ts`.The scan row must reduce evidence freshness/completeness into one plain phrase,omit protection posture when its state is unavailable, and use operator languagediff --git a/frontend-modern/browser-verification/e8fdd2daaf894b3b.json b/frontend-modern/browser-verification/e8fdd2daaf894b3b.jsonnew file mode 100644index 0000000000..16c492e89b--- /dev/null+++ b/frontend-modern/browser-verification/e8fdd2daaf894b3b.json@@ -0,0 +1,37 @@+{+ "version": 1,+ "base_sha": "070d2a0e53b8080d038ee0615393604a55a31b02",+ "verified_at": "2026-10-23T15:05:55Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/api/agentCapabilities.ts"+ ],+ "content_sha256": {+ "frontend-modern/src/api/agentCapabilities.ts": "af6bad03be959413da872305a3ccacda054bd7105b4c0dd40ce66111639514a9"+ },+ "routes": [+ "/settings/pulse-intelligence/agents"+ ],+ "viewports": [+ {+ "width": 1280,+ "height": 800+ },+ {+ "width": 390,+ "height": 844+ }+ ],+ "states": [+ "Private mock stack (embedded build of this change, mock mode, admin session) at 1280x800 and 390x844",+ "External agents > Show connector setup > Developer details > Patrol access model lists Pulse Intelligence Core, Pulse Patrol, Pulse Assistant and External agents",+ "Pulse Assistant entry shows Native surface and Actions badges only, with the description \"The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired.\"",+ "No \"Interactive questions\" badge anywhere on the page; External agents entry keeps External adapter, Actions, Resources, Prompts and Capability metadata",+ "Phone width: badges wrap inside their cards, document width equals the 390px viewport, no console errors"+ ],+ "interactions": [+ "Opened /settings/pulse-intelligence/agents with the existing dev-credential session on the localhost stack",+ "Clicked Show connector setup, then expanded Developer details and Patrol access model",+ "Reloaded at 390x844 and expanded the same disclosures"+ ]+}diff --git a/frontend-modern/public/docs/AI.md b/frontend-modern/public/docs/AI.mdindex a979eb0727..b2ebbcc767 100644--- a/frontend-modern/public/docs/AI.md+++ b/frontend-modern/public/docs/AI.md@@ -12,7 +12,7 @@ Pulse Intelligence is built around a shared **Pulse Intelligence Core**: CanonicThat core is deliberately surfaced with Patrol as the primary built-in operator and Assistant plus MCP as access paths over the same governed capabilities:1. **Pulse Patrol**: Patrol is the first-party operations surface: it checks infrastructure, investigates issues, follows the chosen Patrol mode before acting, verifies outcomes, and records what happened.-2. **Pulse Assistant**: The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions. Affordances: tools.+2. **Pulse Assistant**: The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired. Affordances: tools.3. **Pulse MCP**: The external-agent adapter that projects canonical Pulse Intelligence capabilities as MCP tools. Affordances: tools, resources, prompts, and capability metadata.<!-- pulse-intelligence-overview:end -->diff --git a/frontend-modern/src/api/__tests__/agentCapabilities.branchcov.test.ts b/frontend-modern/src/api/__tests__/agentCapabilities.branchcov.test.tsindex 4d1d8b4f9b..d0f44428bf 100644--- a/frontend-modern/src/api/__tests__/agentCapabilities.branchcov.test.ts+++ b/frontend-modern/src/api/__tests__/agentCapabilities.branchcov.test.ts@@ -125,7 +125,7 @@ describe('agentCapabilities branch coverage', () => {toolCount: 2,});expect(presentation?.detail).toBe(- '2 registry capabilities, 2 published capabilities, 2 native capabilities, Actions, Interactive questions',+ '2 registry capabilities, 2 published capabilities, 2 native capabilities, Actions',);expect(presentation?.title).toContain('Source: Assistant registry');});@@ -368,7 +368,7 @@ describe('agentCapabilities branch coverage', () => {affordances: { tools: false, resources: false },});- expect(normalized?.affordances).toEqual({ tools: true, interactiveQuestions: true });+ expect(normalized?.affordances).toEqual({ tools: true });});});@@ -497,7 +497,9 @@ describe('agentCapabilities branch coverage', () => {}),);- expect(entries[2]?.badges).toEqual(['Native surface', 'Actions', 'Interactive questions']);+ // The Assistant default offers no interactive questions: no Pulse+ // client can answer them since the web chat window was retired.+ expect(entries[2]?.badges).toEqual(['Native surface', 'Actions']);});it('projects only declared affordance badges for an external adapter surface', () => {diff --git a/frontend-modern/src/api/__tests__/agentCapabilities.test.ts b/frontend-modern/src/api/__tests__/agentCapabilities.test.tsindex 51308d8648..33bdd83bc3 100644--- a/frontend-modern/src/api/__tests__/agentCapabilities.test.ts+++ b/frontend-modern/src/api/__tests__/agentCapabilities.test.ts@@ -59,12 +59,11 @@ const surfaceContract = {id: 'pulse_assistant',label: 'Pulse Assistant',description:- 'The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions.',+ 'The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired.',native: true,externalAdapter: false,affordances: {tools: true,- interactiveQuestions: true,},},{@@ -222,9 +221,10 @@ describe('agent capabilities API client', () => {registryToolNames: ['pulse_query'],nativeToolNames: ['pulse_question'],capabilityNames: undefined,+ // The fallback for an undeclared Assistant surface offers no+ // interactive questions: no Pulse client can answer them.affordances: {tools: true,- interactiveQuestions: true,},});});@@ -248,7 +248,7 @@ describe('agent capabilities API client', () => {expect(presentation?.title).toContain('Source: Assistant registry');expect(presentation?.detail).toContain('1 registry capability');expect(presentation?.detail).toContain('1 native capability');- expect(presentation?.detail).toContain('Interactive questions');+ expect(presentation?.detail).not.toContain('Interactive questions');});it('uses manifest-owned external-adapter surface tool contracts before local fallback', () => {@@ -520,10 +520,10 @@ describe('agent capabilities API client', () => {expect(entries.map((entry) => entry.description)).toEqual(['Canonical context, governed actions, safety gates, approval state, action audit, and verification.','Patrol is the first-party operations surface: it checks infrastructure, investigates issues, follows the chosen Patrol mode before acting, verifies outcomes, and records what happened.',- 'The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions.',+ 'The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired.','The external-agent adapter.',]);- expect(entries[2]?.badges).toEqual(['Native surface', 'Actions', 'Interactive questions']);+ expect(entries[2]?.badges).toEqual(['Native surface', 'Actions']);expect(entries[3]?.badges).toEqual(['External adapter','Actions',diff --git a/frontend-modern/src/api/agentCapabilities.ts b/frontend-modern/src/api/agentCapabilities.tsindex 7ac2a15879..5263276734 100644--- a/frontend-modern/src/api/agentCapabilities.ts+++ b/frontend-modern/src/api/agentCapabilities.ts@@ -179,9 +179,10 @@ const DEFAULT_AGENT_MCP_ADAPTER: AgentMCPAdapterContract = {};const DEFAULT_AGENT_SURFACE_AFFORDANCES_BY_ID: Record<string, AgentSurfaceAffordanceContract> = {+ // No interactive questions: no Pulse client can answer pulse_question+ // since the web chat window was retired.pulse_assistant: {tools: true,- interactiveQuestions: true,},pulse_mcp: {tools: true,diff --git a/frontend-modern/src/components/Settings/__tests__/AgentIntegrationsPanel.test.tsx b/frontend-modern/src/components/Settings/__tests__/AgentIntegrationsPanel.test.tsxindex 16b9f7aca7..9e11200ac5 100644--- a/frontend-modern/src/components/Settings/__tests__/AgentIntegrationsPanel.test.tsx+++ b/frontend-modern/src/components/Settings/__tests__/AgentIntegrationsPanel.test.tsx@@ -48,7 +48,6 @@ const manifest: AgentCapabilitiesManifest = {externalAdapter: false,affordances: {tools: true,- interactiveQuestions: true,},},{@@ -316,7 +315,9 @@ describe('AgentIntegrationsPanel', () => {expect(screen.queryByText('Pulse MCP')).not.toBeInTheDocument();expect(screen.getByText('External adapter')).toBeInTheDocument();expect(screen.getAllByText('Actions').length).toBeGreaterThanOrEqual(2);- expect(screen.getByText('Interactive questions')).toBeInTheDocument();+ // No Pulse client can answer interactive questions since the web chat+ // window was retired, so no surface advertises them.+ expect(screen.queryByText('Interactive questions')).not.toBeInTheDocument();expect(screen.getByText('Capability metadata')).toBeInTheDocument();expect(screen.getByText('Live manifest details')).toBeInTheDocument();expect(screen.getByText('Manifest scopes:', { exact: false })).toBeInTheDocument();diff --git a/internal/agentcapabilities/manifest.go b/internal/agentcapabilities/manifest.goindex 2eeef3d5d9..181162c996 100644--- a/internal/agentcapabilities/manifest.go+++ b/internal/agentcapabilities/manifest.go@@ -723,7 +723,7 @@ var canonicalManifest = Manifest{{ID: SurfaceIDPulseAssistant,Label: "Pulse Assistant",- Description: "The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions.",+ Description: "The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired.",Native: true,ExternalAdapter: false,// No interactive questions: no Pulse client can answerdiff --git a/internal/agentcapabilities/manifest_test.go b/internal/agentcapabilities/manifest_test.goindex 2986be8783..75de59eb5a 100644--- a/internal/agentcapabilities/manifest_test.go+++ b/internal/agentcapabilities/manifest_test.go@@ -338,9 +338,9 @@ func TestCanonicalManifestPinsPulseIntelligenceSurfaceContract(t *testing.T) {if assistant.Label != "Pulse Assistant" || !assistant.Native || assistant.ExternalAdapter {t.Fatalf("Pulse Assistant surface contract = %+v", assistant)}- if !strings.Contains(assistant.Description, "contextual explanation") ||- !strings.Contains(assistant.Description, "Patrol findings") {- t.Fatalf("Pulse Assistant description must preserve contextual access-path role, got %q", assistant.Description)+ if !strings.Contains(assistant.Description, "Pulse Mobile") ||+ !strings.Contains(assistant.Description, "web chat window is retired") {+ t.Fatalf("Pulse Assistant description must name its Pulse Mobile-only role, got %q", assistant.Description)}// No interactive questions: no Pulse client can answer pulse_question.if !assistant.Affordances.Tools || assistant.Affordances.InteractiveQuestions ||diff --git a/internal/agentcapabilities/markdown_test.go b/internal/agentcapabilities/markdown_test.goindex be0dc6fbc5..e02c6f4595 100644--- a/internal/agentcapabilities/markdown_test.go+++ b/internal/agentcapabilities/markdown_test.go@@ -93,7 +93,7 @@ func TestPulseIntelligenceOverviewMarkdownProjectsManifestSurfaceContract(t *tes"shared **Pulse Intelligence Core**: Canonical context, governed actions, safety gates, approval state, action audit, and verification shared by Pulse Assistant, Pulse MCP, and Pulse Patrol.","Patrol as the primary built-in operator and Assistant plus MCP as access paths","1. **Pulse Patrol**: Patrol is the first-party operations surface: it checks infrastructure, investigates issues, follows the chosen Patrol mode before acting, verifies outcomes, and records what happened.",- "2. **Pulse Assistant**: The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions. Affordances: tools.",+ "2. **Pulse Assistant**: The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired. Affordances: tools.","3. **Pulse MCP**: The external-agent adapter that projects canonical Pulse Intelligence capabilities as MCP tools. Affordances: tools, resources, prompts, and capability metadata.",} {if !strings.Contains(got, expected) {@@ -122,7 +122,7 @@ func TestMCPSurfaceContractMarkdownProjectsManifestSurfaceContract(t *testing.T)for _, expected := range []string{"**Pulse Intelligence Core**: Canonical context, governed actions, safety gates, approval state, action audit, and verification shared by Pulse Assistant, Pulse MCP, and Pulse Patrol.","**Pulse Patrol**: Patrol is the first-party operations surface: it checks infrastructure, investigates issues, follows the chosen Patrol mode before acting, verifies outcomes, and records what happened.",- "**Pulse Assistant** (the native Pulse surface): The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions. Affordances: tools.",+ "**Pulse Assistant** (the native Pulse surface): The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired. Affordances: tools.","**Pulse MCP**: The external-agent adapter that projects canonical Pulse Intelligence capabilities as MCP tools. Affordances: tools, resources, prompts, and capability metadata.",} {if !strings.Contains(got, expected) {diff --git a/internal/api/contract_test.go b/internal/api/contract_test.goindex 114dcafa9d..e85797cd45 100644--- a/internal/api/contract_test.go+++ b/internal/api/contract_test.go@@ -20066,7 +20066,7 @@ func TestContract_PulseIntelligenceOverviewPinsPatrolPrimaryCore(t *testing.T) {"Patrol is the first-party operations surface: it checks infrastructure, investigates issues, follows the chosen Patrol mode before acting, verifies outcomes, and records what happened","Pulse Assistant","Pulse MCP",- "contextual explanation, approval, and handoff surface for Patrol findings",+ "The chat surface Pulse Mobile uses for operator questions","Pulse has no in-app chat window","connect an MCP client such as Claude Code, Codex, or OpenCode to `pulse-mcp`","New operational capabilities are added to the canonical API manifest first",diff --git a/scripts/release_control/ai_runtime_docs_policy_test.py b/scripts/release_control/ai_runtime_docs_policy_test.pyindex 521d72412b..168a27dbb5 100644--- a/scripts/release_control/ai_runtime_docs_policy_test.py+++ b/scripts/release_control/ai_runtime_docs_policy_test.py@@ -46,7 +46,7 @@ class AIRuntimeDocsPolicyTest(unittest.TestCase):normalized_content,)self.assertIn(- "Pulse Assistant**: The contextual explanation, approval, and handoff surface for Patrol findings, governed actions, verification, and operator questions. Affordances: tools.",+ "Pulse Assistant**: The chat surface Pulse Mobile uses for operator questions over the same governed tools, approvals, and verification; the in-app web chat window is retired. Affordances: tools.",normalized_content,)self.assertIn(