acex-devkit 2.8.0__tar.gz → 2.10.0__tar.gz

{acex_devkit-2.8.0 → acex_devkit-2.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acex-devkit
-Version: 2.8.0
+Version: 2.10.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.8.0 → acex_devkit-2.10.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "acex-devkit"
-version = "2.8.0"
+version = "2.10.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.8.0 → acex_devkit-2.10.0}/src/acex_devkit/models/__init__.py

@@ -3,6 +3,8 @@
 from .agent_manifest import (
     AckResult,
     AgentConfigResponse,
+    AgentNodeSet,
+    AgentNodeSetResult,
     CollectionAgentManifest,
     ManifestTarget,
 )
@@ -116,10 +118,11 @@ from .management_connection import (
 from .ned import Ned
 from .node_response import (
     AssetRefType,
+    NodeAdminStatus,
     NodeCreate,
     NodeListItem,
+    NodeProvisionStatus,
     NodeResponse,
-    NodeStatus,
     NodeUpdate,
 )
 from .pagination import PaginatedResponse
@@ -168,7 +171,8 @@ __all__ = [
     "NodeListItem",
     "NodeUpdate",
     "AssetRefType",
-    "NodeStatus",
+    "NodeAdminStatus",
+    "NodeProvisionStatus",
     "CredentialBase",
     "CredentialFieldBase",
     "CredentialFieldResponse",
@@ -207,6 +211,8 @@ __all__ = [
     "ManifestTarget",
     "AckResult",
     "AgentConfigResponse",
+    "AgentNodeSet",
+    "AgentNodeSetResult",
     "LldpNeighborBase",
     "LldpNeighborEntry",
     "LldpNeighborUpload",

{acex_devkit-2.8.0 → acex_devkit-2.10.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.8.0 → acex_devkit-2.10.0}/src/acex_devkit/models/collection_agent.py

@@ -15,7 +15,8 @@ class CollectionAgentMatchRuleBase(BaseModel):
     site: str | None = None
     vendor: str | None = None
     os: str | None = None
-    status: str | None = None
+    admin_status: str | None = None
+    provision_status: str | None = None
     role: str | None = None
 
 

{acex_devkit-2.8.0 → acex_devkit-2.10.0}/src/acex_devkit/models/node_response.py

@@ -18,18 +18,32 @@ class AssetRefType(StrEnum):
     asset_cluster = "asset_cluster"
 
 
-class NodeStatus(StrEnum):
+class NodeAdminStatus(StrEnum):
+    """Operator intent for the node."""
+
     planned = "planned"
-    init = "init"
     active = "active"
     decommissioned = "decommissioned"
 
 
+class NodeProvisionStatus(StrEnum):
+    """Where the node's device is in the provisioning lifecycle. Set by the provisioning flow, not by operators."""
+
+    unprovisioned = "unprovisioned"  # never provisioned by ACEX
+    adopted = "adopted"  # brownfield: already running when brought under management
+    pending = "pending"  # ZTP armed, waiting for the device to show up
+    bootstrapping = "bootstrapping"  # bootstrap config fetched, waiting for SSH reachability
+    provisioning = "provisioning"  # full config being pushed and verified
+    provisioned = "provisioned"  # provisioned by ACEX and verified
+    failed = "failed"
+
+
 class NodeBase(BaseModel):
     asset_ref_id: int
     asset_ref_type: AssetRefType | None = None
     logical_node_id: int
-    status: NodeStatus | None = None
+    admin_status: NodeAdminStatus | None = None
+    provision_status: NodeProvisionStatus | None = None
 
 
 class NodeListItem(PersistedResponse, NodeBase):
@@ -53,7 +67,8 @@ class NodeUpdate(BaseModel):
     asset_ref_id: int | None = None
     asset_ref_type: AssetRefType | None = None
     logical_node_id: int | None = None
-    status: NodeStatus | None = None
+    admin_status: NodeAdminStatus | None = None
+    provision_status: NodeProvisionStatus | None = None
 
 
 class NodeResponse(PersistedResponse, NodeBase):
@@ -67,7 +82,8 @@ class NodeResponse(PersistedResponse, NodeBase):
 __all__ = [
     "LogicalNodeResponse",
     "AssetRefType",
-    "NodeStatus",
+    "NodeAdminStatus",
+    "NodeProvisionStatus",
     "NodeBase",
     "NodeListItem",
     "NodeResponse",

{acex_devkit-2.8.0 → acex_devkit-2.10.0}/src/acex_devkit/models/telemetry_agent.py

@@ -30,7 +30,8 @@ class TelemetryAgentMatchRuleBase(BaseModel):
     site: str | None = None
     vendor: str | None = None
     os: str | None = None
-    status: str | None = None
+    admin_status: str | None = None
+    provision_status: str | None = None
     role: str | None = None