feat: release mistapi 0.64.0 (#35)

* fix(makefile): update OpenAPI submodule handling in generate target

* feat(marvisclient): add Marvis client events definitions API endpoint

* feat(orgs): add AOSCX and EdgeConnect register command APIs

* fix(oauth): clarify Oauth2 provider name in function docstrings

* feat(devices): add new APIs for searching site device flow records and managing Zigbee events

* feat(inventory): add 'magic' filter to searchOrgInventory for device claim codes

* feat(orgs): enhance searchOrgJsiAssetsAndContracts with additional filtering options

* fix(nac_clients): rename edr_provider to edr_providers for consistency in query parameters

* feat(iotendpoints): add countSiteIotEndpoints and rejoinSiteIotEndpointZigbee functions with detailed API documentation

* fix(nac_clients): correct spelling of "organization" in docstring for mdm_provider parameter

* feat(stats): add 'wired' filter to getSiteCallsSummary and listSiteTroubleshootCalls functions

* feat(mxedge): add utility functions for site-level and organization-level Mist Edges

* feat(ap): add remote capture functions to AP utilities

* feat(shell): reorganize shell imports and add remote capture functionality

* feat(srx): reorganize shell imports and add remote capture functionality

* feat(ssr): reorganize miscellaneous imports and add remote capture functionality

* feat(orgs): add PcapEvents WebSocket class for organization packet capture

* feat(tests): add unit tests for remote packet capture utilities

* chore: update version to 0.64.0 in project files

* docs: add 0.64.0 changelog

* docs: document remote capture breaking changes

* bump dependencies

* test: restore lazy import modules after mocking

* Change wired check to handle None value

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* docs: update examples in remote pcap functions to use UUID format

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Author: tmunzer-AIDE

CHANGELOG.md

@@ -1,5 +1,68 @@
 # CHANGELOG
 
+## Version 0.64.0 (September 2026)
+
+**Released**: September 15, 2026
+
+This release updates the generated API bindings and adds remote packet capture helpers for AP, EX, SRX, SSR, and Mist Edge devices, including streamed organization-level capture events.
+
+---
+
+### 1. NEW FEATURES
+
+#### **Remote Packet Capture Utilities**
+Added packet capture helpers that start captures and collect streamed results through WebSockets:
+- AP wired and wireless captures through `remotePcapWired()` and `remotePcapWireless()`.
+- EX, SRX, and SSR interface captures through `remotePcap()`.
+- Site-level and organization-level Mist Edge captures through the new `mistapi.device_utils.mxedge` module.
+- Organization packet capture events through `mistapi.websockets.orgs.PcapEvents`.
+
+#### **Generated API Additions**
+- Added site device flow-record search and Zigbee event management APIs.
+- Added IoT endpoint counting and Zigbee rejoin APIs.
+- Added AOS-CX and EdgeConnect registration command APIs.
+- Added Marvis client event definitions and new JSI asset and contract filters.
+- Added the `magic` claim-code filter to organization inventory searches and the `wired` filter to site call summaries and troubleshoot-call listings.
+
+---
+
+### 2. BREAKING CHANGES
+
+#### **Remote Capture Argument Structure**
+The `remotePcap()` helpers for EX, SRX, and SSR devices now accept a single `device_interfaces` mapping instead of separate `device_id` and `port_ids` arguments. Each device ID maps to its interfaces, and each interface maps to an optional per-interface tcpdump expression. Use `None` when an interface does not need its own expression; the existing `tcpdump_expression` argument remains the capture-wide filter.
+
+```python
+# Before
+ex.remotePcap(
+  apisession,
+  site_id,
+  device_id,
+  ["ge-0/0/0", "ge-0/0/1"],
+  tcpdump_expression="udp",
+)
+
+# Now
+ex.remotePcap(
+  apisession,
+  site_id,
+  {
+    device_id: {
+      "ge-0/0/0": None,
+      "ge-0/0/1": "port 443",
+    }
+  },
+  tcpdump_expression="udp",
+)
+```
+
+This change also allows one capture request to target multiple EX, SRX, or SSR devices. The AP `remotePcapWired()` and `remotePcapWireless()` signatures are unchanged.
+
+#### **Generated Naming Corrections**
+- Renamed the organization `aos` API module to `aoscx` to match the platform name.
+- Renamed the NAC client query argument from `edr_provider` to `edr_providers` to match the API parameter.
+
+---
+
 ## Version 0.63.3 (July 2026)
 
 **Released**: July 14, 2026

Makefile

@@ -15,6 +15,10 @@ help: ## Show this help message
 	@echo 'Targets:'
 	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z0-9_-]+:.*?## / {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
 
+update-openapi:
+	git submodule sync --recursive
+	git submodule update --init --recursive --remote --checkout mist_openapi
+
 setup-openapi: ## Initialize or update OpenAPI submodule
 	@if [ ! -d "mist_openapi/.git" ]; then \
 		echo "Initializing OpenAPI submodule..."; \
@@ -23,7 +27,7 @@ setup-openapi: ## Initialize or update OpenAPI submodule
 	@echo "Updating OpenAPI submodule..."; \
 	git submodule update --remote mist_openapi
 
-generate: setup-openapi ## Run the code generation script
+generate: update-openapi ## Run the code generation script
 	echo "Updating version in pyproject.toml to $(VERSION)"
 	sed -e "s/version = .*/version = \"$(VERSION)\"/g" pyproject.toml > new_pyproject.toml
 	mv new_pyproject.toml pyproject.toml

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mistapi"
-version = "0.63.3"
+version = "0.64.0"
 authors = [{ name = "Thomas Munzer", email = "tmunzer@juniper.net" }]
 description = "Python package to simplify the Mist System APIs usage"
 keywords = ["Mist", "Juniper", "API"]

src/mistapi/__version.py

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

src/mistapi/api/v1/const/__init__.py

@@ -28,6 +28,7 @@
     insight_metrics,
     languages,
     license_types,
+    marvisclient_events,
     marvisclient_versions,
     mxedge_events,
     mxedge_models,
@@ -58,6 +59,7 @@
     "insight_metrics",
     "languages",
     "license_types",
+    "marvisclient_events",
     "marvisclient_versions",
     "mxedge_events",
     "mxedge_models",

src/mistapi/api/v1/const/marvisclient_events.py

@@ -0,0 +1,35 @@
+"""
+--------------------------------------------------------------------------------
+------------------------- Mist API Python CLI Session --------------------------
+
+    Written by: Thomas Munzer (tmunzer@juniper.net)
+    Github    : https://github.com/tmunzer/mistapi_python
+
+    This package is licensed under the MIT License.
+
+--------------------------------------------------------------------------------
+"""
+
+from mistapi import APISession as _APISession
+from mistapi.__api_response import APIResponse as _APIResponse
+
+
+def listMarvisClientEventsDefinitions(mist_session: _APISession) -> _APIResponse:
+    """
+    API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/constants/definitions/list-marvis-client-events-definitions
+
+    PARAMS
+    -----------
+    mistapi.APISession : mist_session
+        mistapi session including authentication and Mist host information
+
+    RETURN
+    -----------
+    mistapi.APIResponse
+        response from the API call
+    """
+
+    uri = "/api/v1/const/marvisclient_events"
+    query_params: dict[str, str] = {}
+    resp = mist_session.mist_get(uri=uri, query=query_params)
+    return resp

src/mistapi/api/v1/login/oauth.py

@@ -28,6 +28,7 @@ def getOauth2AuthorizationUrlForLogin(
     PATH PARAMS
     -----------
     provider : str
+      Oauth2 provider name
 
     QUERY PARAMS
     ------------
@@ -60,6 +61,7 @@ def unlinkOauth2Provider(mist_session: _APISession, provider: str) -> _APIRespon
     PATH PARAMS
     -----------
     provider : str
+      Oauth2 provider name
 
     RETURN
     -----------
@@ -87,6 +89,7 @@ def loginOauth2(
     PATH PARAMS
     -----------
     provider : str
+      Oauth2 provider name
 
     BODY PARAMS
     -----------

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

@@ -16,7 +16,7 @@
     admins,
     alarms,
     alarmtemplates,
-    aos,
+    aoscx,
     apitokens,
     aptemplates,
     assetfilters,
@@ -30,6 +30,7 @@
     crl,
     deviceprofiles,
     devices,
+    edgeconnect,
     events,
     evpn_topologies,
     exports,
@@ -102,7 +103,7 @@
     "admins",
     "alarms",
     "alarmtemplates",
-    "aos",
+    "aoscx",
     "apitokens",
     "aptemplates",
     "assetfilters",
@@ -116,6 +117,7 @@
     "crl",
     "deviceprofiles",
     "devices",
+    "edgeconnect",
     "events",
     "evpn_topologies",
     "exports",

src/mistapi/api/v1/orgs/aos.py src/mistapi/api/v1/orgs/aoscx.pysrc/mistapi/api/v1/orgs/aos.py renamed to src/mistapi/api/v1/orgs/aoscx.py

@@ -14,9 +14,9 @@
 from mistapi.__api_response import APIResponse as _APIResponse
 
 
-def getOrgAosRegisterCmd(mist_session: _APISession, org_id: str) -> _APIResponse:
+def getOrgAoscxRegisterCmd(mist_session: _APISession, org_id: str) -> _APIResponse:
     """
-    API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/orgs/devices/aos/get-org-aos-register-cmd
+    API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/orgs/devices/aoscx/get-org-aoscx-register-cmd
 
     PARAMS
     -----------
@@ -33,7 +33,7 @@ def getOrgAosRegisterCmd(mist_session: _APISession, org_id: str) -> _APIResponse
         response from the API call
     """
 
-    uri = f"/api/v1/orgs/{org_id}/aos/register_cmd"
+    uri = f"/api/v1/orgs/{org_id}/aoscx/register_cmd"
     query_params: dict[str, str] = {}
     resp = mist_session.mist_get(uri=uri, query=query_params)
     return resp

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

@@ -175,6 +175,7 @@ def countOrgDeviceEvents(
     model: str | None = None,
     text: str | None = None,
     type: str | None = None,
+    includes: str | None = None,
     start: str | None = None,
     end: str | None = None,
     duration: str | None = None,
@@ -195,7 +196,7 @@ def countOrgDeviceEvents(
     QUERY PARAMS
     ------------
     distinct : str{'ap', 'apfw', 'model', 'org_id', 'site_id', 'text', 'timestamp', 'type'}, default: model
-      Field used to group this count response. enum: `ap`, `apfw`, `model`, `org_id`, `site_id`, `text`, `timestamp`, `type`
+      Field used to group this count response. enum: `ap`, `apfw`, `model`, `org_id`, `site_id`, `status`, `text`, `timestamp`, `type`
     site_id : str
       Filter results by site identifier
     ap : str
@@ -208,6 +209,8 @@ def countOrgDeviceEvents(
       Filter results by event message text
     type : str
       See [List Device Events Definitions](/#operations/listDeviceEventsDefinitions)
+    includes : str
+      Keyword to include events from additional indices (e.g. ext_tunnel for ext tunnel events)
     start : str
       Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
     end : str
@@ -239,6 +242,8 @@ def countOrgDeviceEvents(
         query_params["text"] = str(text)
     if type:
         query_params["type"] = str(type)
+    if includes:
+        query_params["includes"] = str(includes)
     if start:
         query_params["start"] = str(start)
     if end:
@@ -295,7 +300,7 @@ def searchOrgDeviceEvents(
     last_by : str
       Return last/recent event for passed in field
     includes : str
-      Keyword to include events from additional indices (e.g. ext_tunnel for prisma events)
+      Keyword to include events from additional indices (e.g. ext_tunnel for ext tunnel events)
     limit : int, default: 100
       Maximum number of results to return per page
     start : str