websocket tools added

Author: tmunzer-AIDE

.gitmodules

@@ -1,4 +1,4 @@
 [submodule "mist_openapi"]
 	path = mist_openapi
 	url = https://github.com/mistsys/mist_openapi.git
-	branch = 2602.1.2
+	branch = master

mist_openapi

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mistapi"
-version = "0.60.3"
+version = "0.55.15"
 authors = [{ name = "Thomas Munzer", email = "tmunzer@juniper.net" }]
 description = "Python package to simplify the Mist System APIs usage"
 keywords = ["Mist", "Juniper", "API"]
@@ -35,14 +35,17 @@ dependencies = [
 "Bug Tracker" = "https://github.com/tmunzer/mistapi_python/issues"
 
 # UV-specific configuration
-[tool.uv.scripts]
-test   = "pytest"
-lint   = "ruff check src/"
-fmt    = "ruff format src/"
-build  = "python -m build"
-
-[tool.uv]
-dev-dependencies = [
+#[tool.uv]
+#preview = true
+
+#[tool.uv.scripts]
+#test   = "pytest"
+#lint   = "ruff check src/"
+#fmt    = "ruff format src/"
+#build  = "python -m build"
+
+[dependency-groups]
+dev = [
   # Testing dependencies
   "pytest>=8.4.0",
   "pytest-cov>=6.1.1",

pyproject.toml

@@ -15,6 +15,7 @@
 from mistapi import api as api
 from mistapi import cli as cli
 from mistapi import websockets as websockets
+from mistapi import utils as utils
 from mistapi.__pagination import get_all as get_all
 from mistapi.__pagination import get_next as get_next
 from mistapi.__version import __author__ as __author__

src/mistapi/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "0.60.3"
+__version__ = "0.55.15"
 __author__ = "Thomas Munzer <tmunzer@juniper.net>"

src/mistapi/__version.py

@@ -144,38 +144,43 @@ def searchOrgAlarms(
     search_after: str | None = None,
 ) -> _APIResponse:
     """
-    API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/orgs/alarms/search-org-alarms
-
-    PARAMS
-    -----------
-    mistapi.APISession : mist_session
-        mistapi session including authentication and Mist host information
-
-    PATH PARAMS
-    -----------
-    org_id : str
-
-    QUERY PARAMS
-    ------------
-    site_id : str
-    group : str{'infrastructure', 'marvis', 'security'}
-      Alarm group. enum: `infrastructure`, `marvis`, `security`
-    severity : str{'critical', 'info', 'warn'}
-      Severity of the alarm. enum: `critical`, `info`, `warn`
-    type : str
-    ack_admin_name : str
-    acked : bool
-    start : str
-    end : str
-    duration : str, default: 1d
-    limit : int, default: 100
-    sort : str, default: timestamp
-    search_after : str
-
-    RETURN
-    -----------
-    mistapi.APIResponse
-        response from the API call
+        API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/orgs/alarms/search-org-alarms
+
+        PARAMS
+        -----------
+        mistapi.APISession : mist_session
+            mistapi session including authentication and Mist host information
+
+        PATH PARAMS
+        -----------
+        org_id : str
+
+        QUERY PARAMS
+        ------------
+        site_id : str
+        group : str{'infrastructure', 'marvis', 'security'}
+          Alarm group. enum: `infrastructure`, `marvis`, `security`.
+    The `marvis` group is used to retrieve AI-driven network issue detections.
+    Known Marvis alarm types include: `bad_cable`, `bad_wan_uplink`, `dns_failure`,
+    `arp_failure`, `auth_failure`, `dhcp_failure`, `missing_vlan`,
+    `negotiation_mismatch`, `port_flap`. Results include resolution status
+    (`status`, `resolved_time`) and affected entity details."
+        severity : str{'critical', 'info', 'warn'}
+          Severity of the alarm. enum: `critical`, `info`, `warn`
+        type : str
+        ack_admin_name : str
+        acked : bool
+        start : str
+        end : str
+        duration : str, default: 1d
+        limit : int, default: 100
+        sort : str, default: timestamp
+        search_after : str
+
+        RETURN
+        -----------
+        mistapi.APIResponse
+            response from the API call
     """
 
     uri = f"/api/v1/orgs/{org_id}/alarms/search"

src/mistapi/api/v1/orgs/alarms.py

@@ -260,7 +260,7 @@ def searchOrgDeviceEvents(
     ------------
     mac : str
     model : str
-    device_type : str{'all', 'ap', 'gateway', 'switch'}, default: ap
+    device_type : str, default: ap
     text : str
     timestamp : str
     type : str

src/mistapi/api/v1/orgs/devices.py

@@ -316,8 +316,8 @@ def searchOrgInventory(
     org_id: str,
     type: str | None = None,
     mac: str | None = None,
-    vc_mac: str | None = None,
-    master_mac: str | None = None,
+    model: str | None = None,
+    name: str | None = None,
     site_id: str | None = None,
     serial: str | None = None,
     master: str | None = None,
@@ -345,14 +345,15 @@ def searchOrgInventory(
     ------------
     type : str{'ap', 'gateway', 'switch'}, default: ap
     mac : str
-    vc_mac : str
-    master_mac : str
+    model : str
+    name : str
     site_id : str
     serial : str
     master : str
     sku : str
     version : str
-    status : str
+    status : str{'connected', 'disconnected'}
+      Device status. enum: `connected`, `disconnected`
     text : str
     limit : int, default: 100
     sort : str, default: timestamp
@@ -370,10 +371,10 @@ def searchOrgInventory(
         query_params["type"] = str(type)
     if mac:
         query_params["mac"] = str(mac)
-    if vc_mac:
-        query_params["vc_mac"] = str(vc_mac)
-    if master_mac:
-        query_params["master_mac"] = str(master_mac)
+    if model:
+        query_params["model"] = str(model)
+    if name:
+        query_params["name"] = str(name)
     if site_id:
         query_params["site_id"] = str(site_id)
     if serial:

src/mistapi/api/v1/orgs/inventory.py

@@ -245,9 +245,15 @@ def searchOrgJsiAssetsAndContracts(
     sku: str | None = None,
     status: str | None = None,
     warranty_type: str | None = None,
-    eol_duration: str | None = None,
-    eos_duration: str | None = None,
+    eol_after: str | None = None,
+    eol_before: str | None = None,
+    eos_after: str | None = None,
+    eos_before: str | None = None,
+    version_eos_after: str | None = None,
+    version_eos_before: str | None = None,
     has_support: bool | None = None,
+    sirt_id: str | None = None,
+    pbn_id: str | None = None,
     text: str | None = None,
     limit: int | None = None,
     sort: str | None = None,
@@ -275,9 +281,15 @@ def searchOrgJsiAssetsAndContracts(
       Device status
     warranty_type : str{'Standard Hardware Warranty', 'Enhanced Hardware Warranty', 'Dead On Arrival Warranty', 'Limited Lifetime Warranty', 'Software Warranty', 'Limited Lifetime Warranty for WLA', 'Warranty-JCPO EOL (DOA Not Included)', 'MIST Enhanced Hardware Warranty', 'MIST Standard Warranty', 'Determine Lifetime warranty'}
       Device warranty type
-    eol_duration : str
-    eos_duration : str
+    eol_after : str
+    eol_before : str
+    eos_after : str
+    eos_before : str
+    version_eos_after : str
+    version_eos_before : str
     has_support : bool
+    sirt_id : str
+    pbn_id : str
     text : str
     limit : int, default: 100
     sort : str, default: timestamp
@@ -303,12 +315,24 @@ def searchOrgJsiAssetsAndContracts(
         query_params["status"] = str(status)
     if warranty_type:
         query_params["warranty_type"] = str(warranty_type)
-    if eol_duration:
-        query_params["eol_duration"] = str(eol_duration)
-    if eos_duration:
-        query_params["eos_duration"] = str(eos_duration)
+    if eol_after:
+        query_params["eol_after"] = str(eol_after)
+    if eol_before:
+        query_params["eol_before"] = str(eol_before)
+    if eos_after:
+        query_params["eos_after"] = str(eos_after)
+    if eos_before:
+        query_params["eos_before"] = str(eos_before)
+    if version_eos_after:
+        query_params["version_eos_after"] = str(version_eos_after)
+    if version_eos_before:
+        query_params["version_eos_before"] = str(version_eos_before)
     if has_support:
         query_params["has_support"] = str(has_support)
+    if sirt_id:
+        query_params["sirt_id"] = str(sirt_id)
+    if pbn_id:
+        query_params["pbn_id"] = str(pbn_id)
     if text:
         query_params["text"] = str(text)
     if limit:

src/mistapi/api/v1/orgs/jsi.py

@@ -410,7 +410,7 @@ def listOrgDevicesStats(
 
     QUERY PARAMS
     ------------
-    type : str{'all', 'ap', 'gateway', 'switch'}, default: ap
+    type : str, default: ap
     status : str{'all', 'connected', 'disconnected'}, default: all
     site_id : str
     mac : str