feat: expose health_label + exposure_mode on discover Node (ADR-044)

Parse the directory's ADR-044 composed health label and ADR-043 8-category
exposure_mode from /v1/discover into the Node model. Both optional — None
against directories predating v1.10.0 (forward-compatible). Bump 0.7.10→0.7.12
to align all three SDKs. Verified in docker (python:3.12): 20 tests pass.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: RobLe3

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "iicp-client"
-version = "0.7.10"
+version = "0.7.12"
 description = "Official Python client SDK for the IICP protocol"
 readme = "README.md"
 license = {text = "Apache-2.0"}

src/iicp_client/client.py

@@ -89,6 +89,8 @@ async def discover_async(
                 region=n.get("region", ""),
                 latency_estimate_ms=n.get("latency_estimate_ms"),
                 reputation_score=n.get("reputation_score"),
+                health_label=n.get("health_label"),
+                exposure_mode=n.get("exposure_mode"),
             )
             for n in raw_nodes
         ]

src/iicp_client/types.py

@@ -110,6 +110,11 @@ class Node:
     region: str
     latency_estimate_ms: int | None = None
     reputation_score: float | None = None
+    # ADR-044 — composed health label (healthy/degraded/impaired/critical/offline)
+    # and ADR-043 8-category network exposure. Both optional: present only when
+    # the directory is on v1.10.0+; None against older directories.
+    health_label: str | None = None
+    exposure_mode: str | None = None
 
 
 @dataclass

tests/test_client.py

@@ -34,6 +34,9 @@
             "score": 0.95,
             "available": True,
             "region": "eu-west",
+            # ADR-044 / ADR-043 fields (directory v1.10.0+)
+            "health_label": "healthy",
+            "exposure_mode": "ipv4_public_direct",
         }
     ]
 }
@@ -78,6 +81,20 @@ def test_discover_returns_node_list():
     assert len(result.nodes) == 1
     assert result.nodes[0].node_id == "node-abc"
     assert result.nodes[0].score == 0.95
+    # ADR-044 — health_label + exposure_mode parsed from discover
+    assert result.nodes[0].health_label == "healthy"
+    assert result.nodes[0].exposure_mode == "ipv4_public_direct"
+
+
+@respx.mock
+def test_discover_health_fields_default_none_against_old_directory():
+    # A directory predating v1.10.0 omits the fields; parsing must not break.
+    legacy = {"nodes": [{"node_id": "n1", "endpoint": NODE, "score": 0.5, "available": True, "region": "eu"}]}
+    respx.get(DISCOVER_URL).mock(return_value=httpx.Response(200, json=legacy))
+    client = IicpClient(ClientConfig(directory_url=DIRECTORY))
+    result = client.discover("urn:iicp:intent:llm:chat:v1")
+    assert result.nodes[0].health_label is None
+    assert result.nodes[0].exposure_mode is None
 
 
 @respx.mock