docs: update api refs

Author: flekschas

agents/skills/mcp-web/api-reference-core.md

@@ -140,6 +140,15 @@ get connected(): boolean
 
 Whether the client is currently connected to the bridge server.
 
+```ts
+get connecting(): boolean
+```
+
+Whether the instance is currently attempting to connect to the bridge.
+
+Returns `true` during the connection/authentication handshake,
+before `connected` becomes `true` or the connection fails.
+
 **Methods:**
 
 ```ts
@@ -320,6 +329,15 @@ addStateTools<T>(optionsOrCreated: {
   } | CreatedStateTools<T>): [ToolDefinition, ToolDefinition | ToolDefinition[], () => void]
 ```
 
+```ts
+onConnectionStateChange(listener: () => void): () => void
+```
+
+Subscribe to connection state changes.
+
+The listener is called whenever `connected` or `connecting` changes.
+Returns an unsubscribe function.
+
 ```ts
 disconnect(): void
 ```

agents/skills/mcp-web/api-reference-integrations.md

@@ -14,6 +14,12 @@ mcpWeb: MCPWeb
 
 The MCPWeb instance for registering tools and making queries.
 
+```ts
+isConnecting: boolean
+```
+
+Whether the MCPWeb instance is currently attempting to connect.
+
 ```ts
 isConnected: boolean
 ```
@@ -117,6 +123,9 @@ Internal hook for managing MCPWeb connection lifecycle.
 Connects on mount and disconnects on unmount.
 Returns reactive connection state for triggering re-renders.
 
+Subscribes to MCPWeb's connection state changes so that reconnection
+attempts (e.g. after a WebSocket drop) are reflected in React state.
+
 Handles React StrictMode's double-mount behavior by using a ref to track
 whether we should actually disconnect on cleanup.
 

docs/api/core.md

@@ -140,6 +140,15 @@ get connected(): boolean
 
 Whether the client is currently connected to the bridge server.
 
+```ts
+get connecting(): boolean
+```
+
+Whether the instance is currently attempting to connect to the bridge.
+
+Returns `true` during the connection/authentication handshake,
+before `connected` becomes `true` or the connection fails.
+
 **Methods:**
 
 ```ts
@@ -320,6 +329,15 @@ addStateTools<T>(optionsOrCreated: {
   } | CreatedStateTools<T>): [ToolDefinition, ToolDefinition | ToolDefinition[], () => void]
 ```
 
+```ts
+onConnectionStateChange(listener: () => void): () => void
+```
+
+Subscribe to connection state changes.
+
+The listener is called whenever `connected` or `connecting` changes.
+Returns an unsubscribe function.
+
 ```ts
 disconnect(): void
 ```

docs/api/integrations.md

@@ -14,6 +14,12 @@ mcpWeb: MCPWeb
 
 The MCPWeb instance for registering tools and making queries.
 
+```ts
+isConnecting: boolean
+```
+
+Whether the MCPWeb instance is currently attempting to connect.
+
 ```ts
 isConnected: boolean
 ```
@@ -117,6 +123,9 @@ Internal hook for managing MCPWeb connection lifecycle.
 Connects on mount and disconnects on unmount.
 Returns reactive connection state for triggering re-renders.
 
+Subscribes to MCPWeb's connection state changes so that reconnection
+attempts (e.g. after a WebSocket drop) are reflected in React state.
+
 Handles React StrictMode's double-mount behavior by using a ref to track
 whether we should actually disconnect on cleanup.