aim-ws-token-management

What problem does it solve?

This Skill helps you prevent and resolve WebSocket mass disconnects caused by expired access tokens, misapplied JWT TTL configuration, and clients reconnecting with stale credentials.

Core Features & Use Cases

• Diagnose WS token expiry disconnect storms: Identify whether the gateway is proactively closing connections with a token-expired status and correlate it with load-test timelines.
• Verify and correct JWT TTL wiring: Trace TTL configuration from YAML through the JWTIssuer into the shared JWT manager, ensuring the configured AccessTTL is actually used when generating tokens.
• Fix WSClient reconnect behavior with automatic token renewal: Ensure reconnect attempts refresh tokens via REST before reopening WS connections, preventing repeated 401 upgrade failures.
• Ensure load-test token pipeline supplies refresh metadata: Confirm benchmark scenarios populate refresh_token, expires_at, and device_id so the refresh flow can succeed.

Quick Start

Ask the AI to explain why WS connections drop at ~5 minutes during your load test, then give a step-by-step checklist to confirm TTL config flow and validate WSClient auto-refresh is using the same token manager instance.