piphi-runtime-kit-python 0.4.2__py3-none-any.whl → 0.4.3__py3-none-any.whl

piphi_runtime_kit_python/__init__.py

@@ -8,7 +8,18 @@ from .runtime.auth import (
     format_runtime_auth_sync_log,
     mask_token,
 )
-from .runtime.config_sync import ConfigSyncCoordinator, build_sync_response, reconcile_config_ids
+from .runtime.config_sync import (
+    CORE_BASE_URL_ENV_NAME,
+    DEFAULT_RUNTIME_CONFIG_SNAPSHOT_FILENAME,
+    DEFAULT_RUNTIME_VOLUME_DIR,
+    RUNTIME_CONFIG_SNAPSHOT_PATH_ENV_NAME,
+    ConfigSyncCoordinator,
+    build_sync_response,
+    load_runtime_config_snapshot,
+    reconcile_config_ids,
+    resolve_core_base_url,
+    resolve_runtime_config_snapshot_path,
+)
 from .runtime.configuration import (
     build_config_apply_response,
     build_config_remove_response,
@@ -109,6 +120,10 @@ __all__ = [
     "CoreUnavailableError",
     "CoreUnexpectedResponseError",
     "DEFAULT_CORE_CLIENT_TIMEOUT_SECONDS",
+    "CORE_BASE_URL_ENV_NAME",
+    "DEFAULT_RUNTIME_CONFIG_SNAPSHOT_FILENAME",
+    "DEFAULT_RUNTIME_VOLUME_DIR",
+    "RUNTIME_CONFIG_SNAPSHOT_PATH_ENV_NAME",
     "DEFAULT_RUNTIME_CONTAINER_ID_ENV_NAME",
     "DEFAULT_RUNTIME_INTERNAL_TOKEN_ENV_NAME",
     "RUNTIME_CONTAINER_ID_HEADER_NAME",
@@ -169,6 +184,7 @@ __all__ = [
     "format_discovery_attempt_log",
     "format_event_log",
     "format_runtime_auth_sync_log",
+    "load_runtime_config_snapshot",
     "mask_token",
     "MqttBrokerConfig",
     "MqttJsonClient",
@@ -176,6 +192,8 @@ __all__ = [
     "normalize_event_payload",
     "redact_config_secrets",
     "reconcile_config_ids",
+    "resolve_core_base_url",
+    "resolve_runtime_config_snapshot_path",
     "runtime_lifespan",
     "schedule_event_delivery",
     "schedule_telemetry_delivery",

piphi_runtime_kit_python/runtime/config_sync.py

@@ -3,6 +3,9 @@ from __future__ import annotations
 """Helpers for basic config-sync orchestration and generation tracking."""
 
 from dataclasses import dataclass
+import json
+import os
+from pathlib import Path
 from typing import Awaitable, Callable, TypeVar
 
 from ..schemas import RuntimeConfig, RuntimeConfigSnapshot, RuntimeConfigSyncResponse
@@ -10,6 +13,77 @@ from .state import RuntimeProcessState
 
 TConfig = TypeVar("TConfig", bound=RuntimeConfig)
 
+CORE_BASE_URL_ENV_NAME = "PIPHI_CORE_BASE_URL"
+RUNTIME_CONTAINER_ID_ENV_NAME = "PIPHI_CONTAINER_ID"
+RUNTIME_CONFIG_SNAPSHOT_PATH_ENV_NAME = "PIPHI_CONFIG_SNAPSHOT_PATH"
+DEFAULT_RUNTIME_VOLUME_DIR = "/.piphinetwork"
+DEFAULT_RUNTIME_CONFIG_SNAPSHOT_FILENAME = "configs.json"
+
+
+def resolve_core_base_url(default: str | None = None) -> str | None:
+    """Resolve Core's base URL from the managed-runtime environment."""
+    value = (os.getenv(CORE_BASE_URL_ENV_NAME) or "").strip().rstrip("/")
+    if value:
+        return value
+    return default.rstrip("/") if isinstance(default, str) and default.strip() else default
+
+
+def resolve_runtime_config_snapshot_path(
+    *,
+    container_id: str | None = None,
+    volume_dir: str | Path = DEFAULT_RUNTIME_VOLUME_DIR,
+) -> Path:
+    """Resolve the local config snapshot path mounted by PiPhi Core."""
+    explicit_path = (os.getenv(RUNTIME_CONFIG_SNAPSHOT_PATH_ENV_NAME) or "").strip()
+    if explicit_path:
+        return Path(explicit_path)
+
+    resolved_container_id = (
+        str(container_id or "").strip()
+        or (os.getenv(RUNTIME_CONTAINER_ID_ENV_NAME) or "").strip()
+    )
+    if resolved_container_id:
+        return Path(volume_dir).joinpath(f"{resolved_container_id}.json")
+    return Path(volume_dir).joinpath(DEFAULT_RUNTIME_CONFIG_SNAPSHOT_FILENAME)
+
+
+def load_runtime_config_snapshot(
+    *,
+    path: str | Path | None = None,
+    container_id: str | None = None,
+    volume_dir: str | Path = DEFAULT_RUNTIME_VOLUME_DIR,
+) -> RuntimeConfigSnapshot | None:
+    """Load Core's last known config snapshot from the mounted runtime volume.
+
+    Missing, unreadable, or invalid snapshots return ``None`` so integrations can
+    treat snapshot rehydration as a safe startup fallback rather than a crash
+    trigger.
+    """
+    snapshot_path = (
+        Path(path)
+        if path is not None
+        else resolve_runtime_config_snapshot_path(
+            container_id=container_id,
+            volume_dir=volume_dir,
+        )
+    )
+    try:
+        raw_payload = snapshot_path.read_text(encoding="utf-8")
+    except (FileNotFoundError, OSError):
+        return None
+
+    try:
+        payload = json.loads(raw_payload)
+    except json.JSONDecodeError:
+        return None
+    if not isinstance(payload, dict):
+        return None
+
+    try:
+        return RuntimeConfigSnapshot.model_validate(payload)
+    except ValueError:
+        return None
+
 
 def reconcile_config_ids(
     *,

piphi_runtime_kit_python/runtime/health.py

@@ -15,6 +15,7 @@ def _build_runtime_snapshot(runtime_context: RuntimeContext) -> dict[str, Any]:
         "core_auth_present": bool(runtime_context.auth.internal_token),
         "core_http_client_bound": process_state.core_http_client is not None,
         "current_generation": process_state.current_generation,
+        "config_generation": process_state.current_generation,
         "pending_task_count": len(
             [task for task in process_state.background_tasks if not task.done()]
         ),

piphi_runtime_kit_python/schemas.py

@@ -35,12 +35,34 @@ class RuntimeConfig(BaseModel):
 
 class RuntimeConfigSnapshot(BaseModel):
     """Snapshot payload sent from PiPhi Core to an integration runtime."""
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    schema_version: int | None = Field(
+        default=None,
+        validation_alias=AliasChoices("schema_version", "schemaVersion"),
+    )
     container_id: str
     integration_id: str | None = None
     driver_pid: int | None = None
     reason: str | None = None
     generation: int | None = None
+    updated_at: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("updated_at", "updatedAt"),
+    )
     configs: list[RuntimeConfig] = Field(default_factory=list)
+    deleted_config_ids: list[str] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("deleted_config_ids", "deletedConfigIds"),
+    )
+    config_hash: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("config_hash", "configHash"),
+    )
+    internal_token: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("internal_token", "internalToken"),
+    )
 
 
 class RuntimeConfigSyncResponse(BaseModel):

{piphi_runtime_kit_python-0.4.2.dist-info → piphi_runtime_kit_python-0.4.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: piphi-runtime-kit-python
-Version: 0.4.2
+Version: 0.4.3
 Summary: PiPhi Network runtime integration helpers
 Keywords: piphi,runtime,integration,iot
 Author-Email: KelvinSan <support@piphi.network>

{piphi_runtime_kit_python-0.4.2.dist-info → piphi_runtime_kit_python-0.4.3.dist-info}/RECORD

@@ -1,21 +1,21 @@
-piphi_runtime_kit_python-0.4.2.dist-info/METADATA,sha256=th_AhsVfZ_at7LDyKQv7ZA1EVxiasOUwoSdTxQvdulI,30849
-piphi_runtime_kit_python-0.4.2.dist-info/WHEEL,sha256=Z36eTX6lG3PITRleSd5hAZHCcz52yg3c0JQVxKBbLW0,90
-piphi_runtime_kit_python-0.4.2.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-piphi_runtime_kit_python-0.4.2.dist-info/licenses/LICENSE,sha256=pS6szQI4X7qAin1ODdoDp-XwZvsFy6ZZ28-JAwGHgzo,1070
-piphi_runtime_kit_python/__init__.py,sha256=P8yx6C1P88xuXWuf3D58d5zhUD-pprhBhbVeyNbDaJQ,6013
+piphi_runtime_kit_python-0.4.3.dist-info/METADATA,sha256=E79yjhZ5noVak87XO3vqqmXAPPcpwnnHCQ6ARARjN_U,30849
+piphi_runtime_kit_python-0.4.3.dist-info/WHEEL,sha256=Z36eTX6lG3PITRleSd5hAZHCcz52yg3c0JQVxKBbLW0,90
+piphi_runtime_kit_python-0.4.3.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+piphi_runtime_kit_python-0.4.3.dist-info/licenses/LICENSE,sha256=pS6szQI4X7qAin1ODdoDp-XwZvsFy6ZZ28-JAwGHgzo,1070
+piphi_runtime_kit_python/__init__.py,sha256=PYHFtcA1h8JY3HaOAoPfTX4u9jgiYrXV25NStwQaVKk,6548
 piphi_runtime_kit_python/adapters/__init__.py,sha256=3jBhPZSBN3Qo7MKHlxAol2jPU3cK23BXHR2oTlircsw,361
 piphi_runtime_kit_python/adapters/fastapi.py,sha256=1QcOBYprg6AmQVrkI8g61NIelBB_7BTbdvNaMvG2-s8,2098
 piphi_runtime_kit_python/fastapi.py,sha256=OZ-ds2-g32kB4YkF90D5bM4vVVjpOWPtrNC-WdhDNyo,361
 piphi_runtime_kit_python/runtime/__init__.py,sha256=0WxNbgGodqba-uiJILOAuU3EwZhBtXeDyw6sYhduWzg,3717
 piphi_runtime_kit_python/runtime/auth.py,sha256=hL90c3K5pJgEpPdNGJ7ds6mqeN4tmjC3I8igfNam_L4,4648
-piphi_runtime_kit_python/runtime/config_sync.py,sha256=IzsH5AGxnISISWx8OYfNMTk2O20kbW4fBvBEGwO_cYg,5625
+piphi_runtime_kit_python/runtime/config_sync.py,sha256=ellgkNQmEGLVFH81VdvxpleQdG_bEmmRdpBkmykdbA4,8078
 piphi_runtime_kit_python/runtime/configuration.py,sha256=4kkoJeENOhJHeNvC9QDu81ejDJUQJG7S5GmQG1sv3YQ,3631
 piphi_runtime_kit_python/runtime/context.py,sha256=CwXgrivciBd7eTREn0u0zjqkDPy6VthASW-gsoZqCTg,1109
 piphi_runtime_kit_python/runtime/discovery.py,sha256=uH6rJ4BnLVukTCxu2QwvN8yJhsI_fcT29VEat62oBcY,2274
 piphi_runtime_kit_python/runtime/dispatch.py,sha256=QcbA9B5izyyg0znlKHq94dbr-oqHVxKW2LCjrQKYfkY,7341
 piphi_runtime_kit_python/runtime/errors.py,sha256=_mjqmJLsdM5NfrTwb6YFkhheqPfn6Df-QtAKgl9U6QU,4120
 piphi_runtime_kit_python/runtime/events.py,sha256=JcvrTZlJ-vgY237jTDVOAVTbSxbcuh9u2QCdOGyuduA,6543
-piphi_runtime_kit_python/runtime/health.py,sha256=9YO0K_UCJKTe6uSFLgb1kStr5dAgtIUc8Ha0dnRi2vA,1880
+piphi_runtime_kit_python/runtime/health.py,sha256=3pds8SYSUql2w2ijegbszwm0HK69VzfIrwz42bN97yk,1943
 piphi_runtime_kit_python/runtime/identity.py,sha256=cth0_QHR9R5LTdp-6DPD1IhM8cYJT5HB1OUQYW7kLGs,2762
 piphi_runtime_kit_python/runtime/lifespan.py,sha256=mVSdZZAS66xlcnlzAwkztFjzw_l2pyLrJqULJsb0Ezk,2850
 piphi_runtime_kit_python/runtime/mqtt.py,sha256=JKMN5zxg1BcOidu7TaYnuRD3HuoAJ_WcvXMTTSlAteo,6069
@@ -24,5 +24,5 @@ piphi_runtime_kit_python/runtime/starter.py,sha256=j5C4GOOcRHNLJ-HYu8fmf3bE00baD
 piphi_runtime_kit_python/runtime/state.py,sha256=4xvQGTT59DF9rXHAtM3kDyV_UGg2a9tLPvGiCp_PFMc,674
 piphi_runtime_kit_python/runtime/tasks.py,sha256=gMd-2K96jMU8tCPvI12xdWxuyNt5gsLDss2QWOoM94k,1241
 piphi_runtime_kit_python/runtime/telemetry.py,sha256=RN6SFrhmAZ7aJLyioQMBzJEFsxQgOjjA1pV5qNeaR4E,4279
-piphi_runtime_kit_python/schemas.py,sha256=LGz53OHmWwUEQb_nHbVBgRDGVGowJPT53S2P7otP3lo,9073
-piphi_runtime_kit_python-0.4.2.dist-info/RECORD,,
+piphi_runtime_kit_python/schemas.py,sha256=9jlsfmvz-O2YeoB0SVopXY7NhFlb1zgynez0NXEZkVE,9849
+piphi_runtime_kit_python-0.4.3.dist-info/RECORD,,