centra-sdk 0.1.52.dev2__tar.gz → 0.1.53__tar.gz

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: centra-sdk
-Version: 0.1.52.dev2
+Version: 0.1.53
 Summary: 
 License: MIT
 Author: ivasylenko
@@ -33,6 +33,7 @@ The **Centra SDK** is a UNOFFICIAL FastAPI-based SDK designed to simplify the in
 - [Quick Start](#quick-start)
 - [Router Modules](#router-modules)
 - [Models and Data Types](#models-and-data-types)
+- [Aggregator Compatibility](#aggregator-compatibility-min_aggregator_sdk_version)
 - [API Documentation](#api-documentation)
 
 ## Overview
@@ -383,6 +384,39 @@ def validate_k8s_service_port(v, handler, info):
 
 ```
 
+## Aggregator Compatibility (`min_aggregator_sdk_version`)
+
+Every integration built with this SDK declares the **minimum centra-sdk version
+its aggregator must be running** to host it. ILM uses this to gate
+distribution: an environment whose aggregators run an older centra-sdk than the
+floor simply isn't offered the integration (shown in ILM as *"aggregator SDK too
+old (needs vX)"* — expected, not an error). The value is reported, with the
+SDK version the integration was built with, by the `discover-sdk-compat` CLI
+command that every connector exposes:
+
+```bash
+$ cli discover-sdk-compat --format json
+{"status": "okay", "sdk_version": "0.1.52", "min_aggregator_sdk_version": "0.1.45"}
+```
+
+### Adjusting the floor
+
+The floor is a single constant — **`MIN_AGGREGATOR_SDK_VERSION` in
+[`utils/sdk_version.py`](utils/sdk_version.py)**. That file's module docstring is
+the authoritative, step-by-step guide (`HOW TO ADJUST`). In short:
+
+- **When:** bump it **only** when a change in this SDK genuinely requires a newer
+  aggregator runtime (a new aggregator-side endpoint/field/protocol the
+  integration depends on). Purely integration-side changes (helpers, bugfixes,
+  fields the aggregator ignores) must **not** raise it — a too-high floor needlessly
+  locks integrations out of older-but-still-capable environments.
+- **How:** set the constant to the *released* centra-sdk version that added the
+  required aggregator-side support (e.g. `"0.1.45"`), bump `version` in
+  `sdk/pyproject.toml` as usual, and commit. Nothing else to wire — the CLI
+  reports it and ILM gates on it automatically.
+- **Rules of thumb:** keep `MIN_AGGREGATOR_SDK_VERSION` ≤ this package's own
+  version; only ever raise it; when in doubt, leave it.
+
 ## API Documentation
 
 Once your application is running, you can access:

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/README.md

@@ -10,6 +10,7 @@ The **Centra SDK** is a UNOFFICIAL FastAPI-based SDK designed to simplify the in
 - [Quick Start](#quick-start)
 - [Router Modules](#router-modules)
 - [Models and Data Types](#models-and-data-types)
+- [Aggregator Compatibility](#aggregator-compatibility-min_aggregator_sdk_version)
 - [API Documentation](#api-documentation)
 
 ## Overview
@@ -360,6 +361,39 @@ def validate_k8s_service_port(v, handler, info):
 
 ```
 
+## Aggregator Compatibility (`min_aggregator_sdk_version`)
+
+Every integration built with this SDK declares the **minimum centra-sdk version
+its aggregator must be running** to host it. ILM uses this to gate
+distribution: an environment whose aggregators run an older centra-sdk than the
+floor simply isn't offered the integration (shown in ILM as *"aggregator SDK too
+old (needs vX)"* — expected, not an error). The value is reported, with the
+SDK version the integration was built with, by the `discover-sdk-compat` CLI
+command that every connector exposes:
+
+```bash
+$ cli discover-sdk-compat --format json
+{"status": "okay", "sdk_version": "0.1.52", "min_aggregator_sdk_version": "0.1.45"}
+```
+
+### Adjusting the floor
+
+The floor is a single constant — **`MIN_AGGREGATOR_SDK_VERSION` in
+[`utils/sdk_version.py`](utils/sdk_version.py)**. That file's module docstring is
+the authoritative, step-by-step guide (`HOW TO ADJUST`). In short:
+
+- **When:** bump it **only** when a change in this SDK genuinely requires a newer
+  aggregator runtime (a new aggregator-side endpoint/field/protocol the
+  integration depends on). Purely integration-side changes (helpers, bugfixes,
+  fields the aggregator ignores) must **not** raise it — a too-high floor needlessly
+  locks integrations out of older-but-still-capable environments.
+- **How:** set the constant to the *released* centra-sdk version that added the
+  required aggregator-side support (e.g. `"0.1.45"`), bump `version` in
+  `sdk/pyproject.toml` as usual, and commit. Nothing else to wire — the CLI
+  reports it and ILM gates on it automatically.
+- **Rules of thumb:** keep `MIN_AGGREGATOR_SDK_VERSION` ≤ this package's own
+  version; only ever raise it; when in doubt, leave it.
+
 ## API Documentation
 
 Once your application is running, you can access:

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "centra-sdk"
-version = "0.1.52.dev2"
+version = "0.1.53"
 description = ""
 authors = [
     {name = "ivasylenko", email = "ivasylen@akamai.com"}

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/dependencies.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/main.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/common/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/common/common.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/common/inventory.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/config/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/config/switches.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/consumer/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/consumer/agents.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/consumer/enforcement.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/k8s/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/k8s/k8s_inventory.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/operations/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/operations/aws/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/aws/accounts.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/aws/flowlogs.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/operations/azure/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/azure/setup.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/config.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/operations/gcp/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/gcp/setup.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/health.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/info.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/log.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/operations/onboard.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

centra_sdk-0.1.53/src/centra_sdk/models/connector/v1/provider/__init__.py

@@ -0,0 +1,3 @@
+# generated by fastapi-codegen:
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/provider/inventory.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 
@@ -23,6 +23,21 @@ class NetworkConnections(BaseModel, GcSerializer):
     reachable_networks: List[str] = Field(..., alias='reachable-networks')
 
 
+class Labels(RootModel[List[Label]]):
+    model_config = ConfigDict(
+        populate_by_name=True,
+        from_attributes=True,
+    )
+    root: List[Label]
+
+    def __getattr__(self, attr: str):
+        return getattr(self.root, attr)
+
+    def __iter__(self):
+        for item in self.root:
+            yield item
+
+
 class InventoryAssetType(Enum):
     VMS = 'vms'
     K8S_SERVICES = 'k8s_services'
@@ -69,21 +84,6 @@ class NetworkTopology(RootModel[List[NetworkConnections]]):
             yield item
 
 
-class Labels(RootModel[List[Label]]):
-    model_config = ConfigDict(
-        populate_by_name=True,
-        from_attributes=True,
-    )
-    root: List[Label]
-
-    def __getattr__(self, attr: str):
-        return getattr(self.root, attr)
-
-    def __iter__(self):
-        for item in self.root:
-            yield item
-
-
 class Inventory(RootModel[List[InventoryItem]]):
     model_config = ConfigDict(
         populate_by_name=True,

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/provider/lookup.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/provider/networks.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/provider/reveal.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/v1/provider/switch_observability.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/models/connector/version.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   filename:  /home/circleci/project/guardicore/connector
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/account.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/agents.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/authentication.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/control.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/enforcement.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/flow_logs.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/health.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/info.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/inventory.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/logging.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/onboarding.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/operations.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/setup.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/switch_observability.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/routers/switches.py

@@ -1,6 +1,6 @@
 # generated by fastapi-codegen:
 #   filename:  connector
-#   timestamp: 2026-05-29T10:08:16+00:00
+#   timestamp: 2026-06-01T04:15:31+00:00
 
 from __future__ import annotations
 

{centra_sdk-0.1.52.dev2 → centra_sdk-0.1.53}/src/centra_sdk/utils/gc_cli.py

@@ -25,6 +25,7 @@ from rich.table import Table
 
 from centra_sdk.models.connector.v1.operations.config import ConfigOpts
 from centra_sdk.models.connector.v1.operations.onboard import IntegrationCapabilities, InfraCapabilities
+from centra_sdk.utils.sdk_version import MIN_AGGREGATOR_SDK_VERSION, installed_sdk_version
 
 # Constants
 OUTPUT_FORMAT_TABLE = 'table'
@@ -363,6 +364,116 @@ class DiscoverIntegrationCapabilitiesResponse(CliResponse):
 
         return self.value
 
+
+@dataclass
+class DiscoverSdkCompatResponse(CliResponse):
+    """Response wrapper for SDK-compatibility discovery operations.
+
+    Reports the centra-sdk version this integration was built with and the
+    minimum centra-sdk version an aggregator runtime must have to run it.
+
+    Attributes:
+        sdk_version: The installed centra-sdk version (built-with), or None
+        min_aggregator_sdk_version: The aggregator-runtime floor for this SDK
+    """
+    sdk_version: Optional[str] = None
+    min_aggregator_sdk_version: Optional[str] = None
+
+    @property
+    def title(self) -> str:
+        """Get the title for table display.
+
+        Returns:
+            Title string for SDK-compatibility table output
+        """
+        return "SDK Compatibility"
+
+    @classmethod
+    def success(cls, sdk_version: Optional[str], min_aggregator_sdk_version: Optional[str]) -> 'DiscoverSdkCompatResponse':
+        """Create a successful SDK-compatibility discovery response.
+
+        Args:
+            sdk_version: The installed centra-sdk version (may be None if unresolvable)
+            min_aggregator_sdk_version: The declared aggregator-runtime floor
+
+        Returns:
+            DiscoverSdkCompatResponse instance with success status
+        """
+        return cls(
+            status=STATUS_OK,
+            message="SDK compatibility discovery successful",
+            sdk_version=sdk_version,
+            min_aggregator_sdk_version=min_aggregator_sdk_version
+        )
+
+    @classmethod
+    def error(cls, error_message: str) -> 'DiscoverSdkCompatResponse':
+        """Create an error SDK-compatibility discovery response.
+
+        Args:
+            error_message: Description of the error that occurred
+
+        Returns:
+            DiscoverSdkCompatResponse instance with error status
+        """
+        return cls(
+            status=STATUS_ERROR,
+            message=error_message
+        )
+
+    @property
+    def value(self) -> Dict[str, Any]:
+        """Get the SDK-compatibility result as serializable data.
+
+        Returns:
+            Dictionary containing status, sdk_version, and the aggregator floor
+        """
+        if self.status == STATUS_ERROR:
+            return {"status": self.status, "message": self.message}
+
+        return {
+            "status": self.status,
+            "message": self.message,
+            "sdk_version": self.sdk_version,
+            "min_aggregator_sdk_version": self.min_aggregator_sdk_version
+        }
+
+    def print(self, format: str = 'json'):
+        """Print the response in the specified format.
+
+        Args:
+            format: Output format ('json' or 'table')
+        """
+        response_fmt = self.format(format)
+        if isinstance(response_fmt, Table):
+            rprint(response_fmt)
+        else:
+            print(response_fmt)
+
+    def format(self, output_format: OutputFormat) -> Union[Table, str]:
+        """Format the SDK-compatibility info based on the requested output format.
+
+        Args:
+            output_format: Desired output format
+
+        Returns:
+            Formatted output as Table or JSON string
+        """
+        if output_format == OUTPUT_FORMAT_JSON:
+            return json.dumps(self.value)
+
+        # table format
+        if output_format == OUTPUT_FORMAT_TABLE:
+            if self.status == STATUS_ERROR:
+                return self.format_table([{"status": self.status, "message": self.message}])
+            return self.format_table([{
+                "sdk_version": str(self.sdk_version),
+                "min_aggregator_sdk_version": str(self.min_aggregator_sdk_version)
+            }])
+
+        return self.value
+
+
 @dataclass
 class DiscoverInfraCapabilitiesResponse(CliResponse):
     """Response wrapper for infrastructure capabilities discovery operations.
@@ -545,6 +656,28 @@ class CliHandler(ABC):
         except Exception as e:
             return DiscoverMetadataResponse.error(f"Error during metadata discovery: {e}")
 
+    def discover_sdk_compat(self) -> DiscoverSdkCompatResponse:
+        """Handle SDK-compatibility discovery command.
+
+        Reports the centra-sdk version this integration was built with (the
+        installed package version inside the image) and the minimum centra-sdk
+        version an aggregator runtime must have to run it. Concrete on the base
+        handler so every integration reports automatically with no author
+        changes.
+
+        If the installed version cannot be resolved, the response is still a
+        success with ``sdk_version`` set to ``None`` -- the declared floor
+        (``min_aggregator_sdk_version``) is the authoritative gate value, so an
+        unresolvable installed version must not turn this into an error.
+
+        Returns:
+            DiscoverSdkCompatResponse with the installed and minimum versions
+        """
+        return DiscoverSdkCompatResponse.success(
+            sdk_version=installed_sdk_version(),
+            min_aggregator_sdk_version=MIN_AGGREGATOR_SDK_VERSION,
+        )
+
     @staticmethod
     def _validate_metadata_folder(source_folder):
         """Validate that the source folder contains required files."""
@@ -737,6 +870,37 @@ def _discover_infra_capabilities_command():
     return discover_infra_capabilities
 
 
+def _discover_sdk_compat_command():
+    """Create the discover-sdk-compat command function."""
+    @click.command()
+    @click.option('--format', 'output_format', type=click.Choice([OUTPUT_FORMAT_TABLE, OUTPUT_FORMAT_JSON]),
+                 default=OUTPUT_FORMAT_JSON, help='Output format')
+    @pass_context
+    def discover_sdk_compat(ctx, output_format: OutputFormat):
+        """Discover and display the SDK-compatibility information.
+
+        This command reports the centra-sdk version this integration was built
+        with and the minimum centra-sdk version an aggregator runtime must have
+        to run it. The output can be formatted as either a human-readable table
+        or machine-parseable JSON.
+
+        Examples:
+            # Display SDK compatibility in JSON format
+            cli discover-sdk-compat --format json
+
+            # Display SDK compatibility in table format
+            cli discover-sdk-compat --format table
+        """
+        try:
+            ret = CliHandler.from_context(ctx).discover_sdk_compat()
+            ret.print(output_format)
+        except Exception as e:
+            ret = DiscoverSdkCompatResponse.error(f"Error while discovering SDK compatibility: {e}")
+            ret.print(OUTPUT_FORMAT_JSON)
+            sys.exit(1)
+    return discover_sdk_compat
+
+
 def get_default_commands() -> List[click.Command]:
     """Get the default CLI commands.
     
@@ -754,7 +918,8 @@ def get_default_commands() -> List[click.Command]:
         _health_check_command(),
         _discover_metadata_command(),
         _discover_integration_capabilities_command(),
-        _discover_infra_capabilities_command()
+        _discover_infra_capabilities_command(),
+        _discover_sdk_compat_command()
     ]
 
 
@@ -779,7 +944,7 @@ def create_cli(handler: 'CliHandler', prog_name: str = "cli", commands: Optional
         app = create_cli(handler, "my-cli", commands=custom_commands)
     """
     @click.group(name="cli")
-    @click.version_option(version="1.0.0", prog_name=prog_name)
+    @click.version_option(version=installed_sdk_version() or "1.0.0", prog_name=prog_name)
     @pass_context
     def cli_group(ctx):
         ctx.ensure_object(dict)

centra_sdk-0.1.53/src/centra_sdk/utils/sdk_version.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+"""centra-sdk version helpers for SDK-compatibility discovery.
+
+This module exposes the two values used by the ``discover-sdk-compat`` CLI
+command (see :mod:`centra_sdk.utils.gc_cli`), which ILM reads to decide whether
+an integration built with this SDK can run on a given Centra environment:
+
+* ``MIN_AGGREGATOR_SDK_VERSION`` -- the aggregator-runtime floor (see the big
+  "HOW TO ADJUST" block below).
+* ``installed_sdk_version()`` -- the centra-sdk version actually installed in
+  the integration image at runtime.
+
+This file ships in the SDK source and survives codegen because ``sdk/utils/``
+is copied verbatim into ``src/centra_sdk/utils/`` by ``sdk/scripts/generate.py``.
+
+────────────────────────────────────────────────────────────────────────────
+HOW TO ADJUST ``MIN_AGGREGATOR_SDK_VERSION``  (read this before changing it)
+────────────────────────────────────────────────────────────────────────────
+
+WHAT IT MEANS
+    "An aggregator must have **at least** this centra-sdk version installed in
+    its runtime to run integrations built with THIS release of the SDK."
+    ILM compares it against every aggregator's reported installed centra-sdk
+    version. If an environment's newest aggregator is older than this floor,
+    ILM will NOT distribute integrations built with this SDK to that
+    environment -- it surfaces them in the UI as "aggregator SDK too old
+    (needs vX)". That is expected behaviour, not an error.
+
+WHEN TO BUMP IT  (rare -- most releases do NOT touch this)
+    Bump it ONLY when a change in this SDK makes an integration unable to run
+    on an older aggregator runtime, e.g. you:
+      • call a new aggregator-side gRPC/HTTP endpoint or field that older
+        aggregators don't implement;
+      • rely on aggregator behaviour/protocol added in a specific centra-sdk
+        version;
+      • change the wire contract in a way the aggregator must understand.
+    If your change is purely integration-side (a new helper, a bugfix, a new
+    model field the aggregator ignores), DO NOT bump it -- a higher floor
+    needlessly locks integrations out of older-but-still-capable environments.
+
+HOW TO BUMP IT  (one line + the usual version bump)
+    1. Set the value below to the *released* centra-sdk version in which the
+       aggregator gained the support your change depends on (e.g. "0.1.45").
+       Use a real published version string, MAJOR.MINOR.PATCH.
+    2. Bump ``version`` in ``sdk/pyproject.toml`` as usual (every PR does this).
+    3. Commit. That's it -- nothing else to wire:
+         • ``discover-sdk-compat`` reports the new floor automatically;
+         • ILM's extractor persists it and gates distribution on it.
+
+RULES OF THUMB
+    • Keep ``MIN_AGGREGATOR_SDK_VERSION`` <= this package's own version. You
+      can't require an aggregator runtime newer than the SDK that declares it.
+    • Only ever raise it, and only to a version that has actually shipped to
+      aggregators. Lowering it is almost never correct (it would claim older
+      aggregators can run integrations that in fact need newer support).
+    • When in doubt, leave it. A too-low floor lets a genuinely-incompatible
+      install through; a too-high floor just delays rollout to older
+      environments.
+
+WORKED EXAMPLE
+    You add a call to an aggregator endpoint that only exists from centra-sdk
+    0.1.45 onward, and you're releasing this as 0.1.52::
+
+        MIN_AGGREGATOR_SDK_VERSION = "0.1.45"   # <- raise from "0.1.39"
+        # sdk/pyproject.toml: version = "0.1.52"
+
+    Result: ILM distributes 0.1.52-built integrations only to environments
+    whose aggregators run centra-sdk >= 0.1.45; older environments show
+    "needs Centra SDK >= 0.1.45" until their aggregators are upgraded.
+────────────────────────────────────────────────────────────────────────────
+"""
+
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+from typing import Optional
+
+# Distribution name on PyPI (import name is ``centra_sdk``).
+_PACKAGE_NAME = "centra-sdk"
+
+# ===========================================================================
+# The aggregator-runtime floor for integrations built with THIS release.
+#
+# >>> To change this, read the "HOW TO ADJUST MIN_AGGREGATOR_SDK_VERSION"
+#     block in this module's docstring (just above). <<<
+#
+# Short version: bump ONLY when this SDK needs a newer aggregator runtime; set
+# it to the released centra-sdk version that added the required aggregator-side
+# support; keep it <= this package's own version; otherwise leave it alone.
+# ===========================================================================
+# Current floor: 0.1.39 -- the aggregator's actual baseline centra-sdk runtime.
+MIN_AGGREGATOR_SDK_VERSION: str = "0.1.39"
+
+
+def installed_sdk_version() -> Optional[str]:
+    """Return the installed centra-sdk package version, or ``None``.
+
+    Resolves ``importlib.metadata.version("centra-sdk")``. When the package
+    metadata is not available (``PackageNotFoundError`` -- typically a source
+    checkout that was never installed), returns ``None`` rather than raising so
+    that callers can degrade gracefully.
+
+    Returns:
+        The installed centra-sdk version string, or ``None`` if unresolvable.
+    """
+    try:
+        return _pkg_version(_PACKAGE_NAME)
+    except PackageNotFoundError:
+        return None

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/common/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/config/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/consumer/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/k8s/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/operations/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/operations/aws/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/operations/azure/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/operations/gcp/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00

centra_sdk-0.1.52.dev2/src/centra_sdk/models/connector/v1/provider/__init__.py

@@ -1,3 +0,0 @@
-# generated by fastapi-codegen:
-#   filename:  /Users/ivasylen/Code/contracts/guardicore/connector
-#   timestamp: 2026-05-29T10:08:16+00:00