acex-devkit 2.7.0__tar.gz → 2.9.0__tar.gz

{acex_devkit-2.7.0 → acex_devkit-2.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acex-devkit
-Version: 2.7.0
+Version: 2.9.0
 Summary: ACE-X DevKit - Development kit for building ACE-X drivers and plugins
 License: AGPL-3.0
 Keywords: automation,devkit,sdk,drivers,plugins

{acex_devkit-2.7.0 → acex_devkit-2.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "acex-devkit"
-version = "2.7.0"
+version = "2.9.0"
 description = "ACE-X DevKit - Development kit for building ACE-X drivers and plugins"
 authors = ["Johan Lahti <johan.lahti@acebit.se>"]
 readme = "README.md"

{acex_devkit-2.7.0 → acex_devkit-2.9.0}/src/acex_devkit/models/__init__.py

@@ -3,6 +3,8 @@
 from .agent_manifest import (
     AckResult,
     AgentConfigResponse,
+    AgentNodeSet,
+    AgentNodeSetResult,
     CollectionAgentManifest,
     ManifestTarget,
 )
@@ -207,6 +209,8 @@ __all__ = [
     "ManifestTarget",
     "AckResult",
     "AgentConfigResponse",
+    "AgentNodeSet",
+    "AgentNodeSetResult",
     "LldpNeighborBase",
     "LldpNeighborEntry",
     "LldpNeighborUpload",

{acex_devkit-2.7.0 → acex_devkit-2.9.0}/src/acex_devkit/models/agent_manifest.py

@@ -34,3 +34,22 @@ class AgentConfigResponse(BaseModel):
     """Rendered config text (TOML) for a telemetry agent."""
 
     config: str
+
+
+class AgentNodeSet(BaseModel):
+    """Declarative explicit-node membership for an agent (PUT …/nodes).
+
+    `node_ids` replaces the agent's explicit node links; an empty list removes
+    all. Rule-matched nodes are unaffected. When `expected_revision` is given
+    and differs from the agent's current `config_revision`, the request is
+    rejected with 409 so concurrent edits don't silently overwrite each other.
+    """
+
+    node_ids: list[int]
+    expected_revision: int | None = None
+
+
+class AgentNodeSetResult(BaseModel):
+    added: list[int] = []
+    removed: list[int] = []
+    config_revision: int

{acex_devkit-2.7.0 → acex_devkit-2.9.0}/src/acex_devkit/models/telemetry_agent.py

@@ -1,4 +1,5 @@
 from enum import StrEnum
+from typing import Literal
 
 from pydantic import BaseModel
 
@@ -79,6 +80,32 @@ class TelemetryAgentAck(BaseModel):
     config_revision: int
 
 
+class CapabilityCoverage(BaseModel):
+    """Whether one node-scoped capability made it into the agent's config.
+
+    For `skipped`, `reason` is a stable code (e.g. "no_management_ip",
+    "no_logical_node", "component_error") and `detail` carries free-text
+    context when available.
+    """
+
+    status: Literal["rendered", "skipped"]
+    reason: str | None = None
+    detail: str | None = None
+
+
+class NodeCoverage(BaseModel):
+    """One node the agent covers, and which capabilities are rendered for it.
+
+    `capabilities` holds only granted, node-scoped capabilities (e.g. icmp,
+    snmp) — agent-level listeners such as snmp_trap/syslog are not per node.
+    """
+
+    node_id: int
+    hostname: str | None = None
+    source: Literal["explicit", "rule", "both"]
+    capabilities: dict[TelemetryCapability, CapabilityCoverage] = {}
+
+
 class TelemetryAgentResponse(PersistedResponse, TelemetryAgentBase):
     config_revision: int = 0
     last_config_poll: str | None = None
@@ -88,6 +115,8 @@ class TelemetryAgentResponse(PersistedResponse, TelemetryAgentBase):
     nodes: list[int] = []
     rules: list[TelemetryAgentMatchRuleResponse] = []
     resolved_nodes: list[int] = []
+    # Only populated on single-agent reads (GET /agents/{id}); empty in listings.
+    node_coverage: list[NodeCoverage] = []
 
 
 __all__ = [
@@ -102,4 +131,6 @@ __all__ = [
     "TelemetryAgentMatchRuleResponse",
     "TelemetryAgentResponse",
     "TelemetryAgentUpdate",
+    "CapabilityCoverage",
+    "NodeCoverage",
 ]