@celigo/api-specs 0.2.213 → 0.2.215

package/dist/agent.yml

@@ -743,6 +743,40 @@ components:
               type: boolean
               readOnly: true
               description: When true, the platform considers this agent offline based on heartbeat state.
+            workerHealthy:
+              type: boolean
+              readOnly: true
+              description: |-
+                Whether the agent's worker reported healthy on its last heartbeat.
+                Absent means never reported (older agents). Only an explicit
+                `false` means the worker is down. The Agents page reads this field
+                and `offlineReason` for the status badge and its reason. Source-only:
+                the semantics are read from the platform's agent-eligibility rule;
+                the probe account has no agents, so no live response has shown the
+                field yet.
+              examples:
+                - true
+            offlineReason:
+              type: string
+              readOnly: true
+              enum:
+                - agent_unauthorized
+                - agent_unreachable
+                - heartbeat_stale
+                - worker_unhealthy
+              x-enumDescriptions:
+                agent_unauthorized: The agent's credentials were rejected, so its heartbeats and tunnel are refused.
+                agent_unreachable: The platform could not reach the agent over its tunnel.
+                heartbeat_stale: No heartbeat arrived within the freshness window.
+                worker_unhealthy: 'The agent''s last heartbeat reported `workerHealthy: false`.'
+              description: |-
+                Why the platform last marked this agent offline. Absent when the
+                agent is online or was marked offline before this field existed.
+                Source-only, as `workerHealthy`: the values and their meanings are
+                read from the platform's heartbeat handling and have not been
+                observed in a live response on the probe account.
+              examples:
+                - heartbeat_stale
             _accessLevel:
               type: string
               readOnly: true