v0.61.2
Version 0.61.2 (March 2026)
Released: March 17, 2026
This release adds automatic reconnection support for WebSocket streams, updates the OpenAPI specification, and includes minor bug fixes.
1. NEW FEATURES
WebSocket Auto-Reconnect
_MistWebsocket now supports automatic reconnection with configurable parameters:
auto_reconnect— Enable/disable auto-reconnect (default:False)max_reconnect_attempts— Maximum reconnect attempts before giving up (default:5)reconnect_backoff— Base backoff delay in seconds, with exponential increase (default:2.0)
When enabled, the WebSocket automatically reconnects on transient failures using exponential backoff. User-initiated disconnect() calls are respected during reconnection attempts.
ws = mistapi.websockets.sites.DeviceStatsEvents(
apisession,
site_ids=["<site_id>"],
auto_reconnect=True,
max_reconnect_attempts=5,
reconnect_backoff=2.0
)
ws.connect(run_in_background=True)2. API CHANGES (OpenAPI 2602.1.7)
Updated to mist_openapi spec version 2602.1.7.
Insights API
getSiteInsightMetrics()— Now usesmetricsas a query parameter instead of a path parametergetSiteInsightMetricsForAP()— New function to retrieve insight metrics for a specific APgetSiteInsightMetricsForClient()— Changedmetricpath parameter tometricsquery parametergetSiteInsightMetricsForGateway()— Changedmetricpath parameter tometricsquery parameter
Stats API
getOrgStats()— Removedstart,end,duration,limit,pagequery parameterslistOrgSiteStats()— Removedstart,end,durationquery parameters
3. BUG FIXES
- Fixed
ShellSession.recv()to gracefully handle socket timeout reset when the connection is already closed - Fixed thread-safety (TOCTOU) race conditions in
ShellSessionby capturing WebSocket reference in local variables acrossdisconnect(),connected,send(),recv(), andresize()methods - Fixed thread-safety race condition in
_MistWebsocket.disconnect()with local variable capture
Version 0.61.1 (March 2026)
Released: March 15, 2026
This release improves async support with a new arun() helper, makes the Device Utilities module fully non-blocking, adds VT100 terminal emulation for screen-based commands, and introduces interactive SSH shell access for EX/SRX devices. (PR #16)