needle-cloud 2.0.2 → 2.1.0-dev.1779007136.henry-the-eighth.52864a7

package/dist/index.d.ts

@@ -335,7 +335,21 @@ type ChatSessionHandle$1 = {
     readonly chatUrl: string | null,
     /** Whether the WebSocket tool connection is active. Always false if no tools were provided. */
     readonly toolsConnected: boolean,
-    /** Close the session (WebSocket + cleanup). */
+    /**
+     * Stable identity of the underlying tool connection. `null` when the
+     * session has no tools (HTTP-only). Used by the server to route tool
+     * requests back to this specific session.
+     */
+    readonly instanceId: string | null,
+    /**
+     * Close the session (WebSocket + cleanup).
+     *
+     * **Node / CLI consumers MUST call this before exit** when the
+     * session was created with tools (i.e. holds an open WebSocket) —
+     * otherwise the open socket keeps Node's event loop alive and the
+     * process will hang. See `ToolConnectionHandle.close()` for the
+     * full lifecycle notes. Browsers handle this automatically.
+     */
     close(): void,
 }