docs: client pool, isolated scopes, and abandon detection

[Aryex]

Summary

Document the Client-Instance Pool, Isolated Execution Scopes, and Abandon Detection features across Python, Java, Node.js, and Go.

⚠️ Attention: This PR was generated automatically. Verify that all relevant pages have been updated.

Source Commits

• be92bbc — feat: cross-language client pool and isolated execution scopes (#6338)
• 65e607b — feat: add abandon detection for pool-borrowed clients (#6642)

Changes

• Added how-to/client-pool.mdx — guide covering pool configuration, creation, borrow/release patterns, metrics, abandon detection, and limitations
• Added how-to/isolated-scope.mdx — guide covering scope acquisition, WATCH/MULTI/EXEC OCC retry patterns, cluster mode routing, and limitations
• Updated astro.config.mjs sidebar to include both new pages
• Added abandon_timeout_ms to the configuration table
• Added "Abandon Detection" section documenting the background monitor, activity refresh, blocking command exclusion, custom timeout configuration, and disable instructions
• Removed the "No abandon detection" limitation (now resolved)

Context

PR #6338 added a cross-language client-instance pool and isolated execution scopes. PR #6642 followed up with abandon detection — a background monitor that reclaims pool-borrowed clients after a configurable inactivity timeout. The timer resets on every command sent, and blocking commands are automatically excluded. These guides document the public API for all features with practical code examples in all four languages.

cc @jduo @jeremyprime

---

This PR was generated by the automated documentation pipeline.

[Aryex]

📝 Updated PR description with 65e607b — feat: add abandon detection for pool-borrowed clients (#6642)

Changes in this update:

• Added abandon_timeout_ms to the Configuration table
• Added new "Abandon Detection" section with configuration and disable examples across all 4 languages
• Removed the "No abandon detection" limitation (now resolved)

[jeremyprime]

Multiple incorrect examples in both files. Here is AI summary:

client-pool.mdx:

Section	Language	Issue
Create a Pool	Node	Should be two args: ClientPool.create(clientConfig, { maxSize: 10, ... })
Borrow and Return	Python (manual)	_get_or_create_client() is private — remove manual example, keep only borrow() context manager
Borrow and Return	Java	acquire().get() returns PooledGlideClient (AutoCloseable). Fix: try (var client = pool.acquire().get()) { client.set(...); }
Borrow and Return	Go	Acquire(ctx) returns (int64, error), not a client. Need GetClient(clientID) then defer client.Close()
Pool Metrics	Java	No PoolMetrics class — use pool.getIdleCount(), pool.getActiveCount(), pool.getTotalCount()
Pool Metrics	Node	pool.metrics() → pool.getMetrics()
Pool Metrics	Go	No Metrics() struct — use pool.IdleCount(), pool.ActiveCount(), pool.TotalCount()
Close the Pool	Node	pool.close() is synchronous — remove await

isolated-scope.mdx:

Section	Language	Issue
Acquire a Scope	Node	No client.scopedConnection() — use IsolatedScope.acquire(client, connectionRequestBytes, routingKey)
Acquire a Scope	Node	scope.close() / scope.release() is synchronous — remove await
Acquire a Scope	Go	No ScopeOptions struct — use positional args: client.ScopedConnection(ctx, timeout, routingKey)

[jeremyprime]

Multiple incorrect examples in both files. Here is AI summary:

client-pool.mdx:

Section Language Issue
Create a Pool Node Should be two args: ClientPool.create(clientConfig, { maxSize: 10, ... })
Borrow and Return Python (manual) _get_or_create_client() is private — remove manual example, keep only borrow() context manager
Borrow and Return Java acquire().get() returns PooledGlideClient (AutoCloseable). Fix: try (var client = pool.acquire().get()) { client.set(...); }
Borrow and Return Go Acquire(ctx) returns (int64, error), not a client. Need GetClient(clientID) then defer client.Close()
Pool Metrics Java No PoolMetrics class — use pool.getIdleCount(), pool.getActiveCount(), pool.getTotalCount()
Pool Metrics Node pool.metrics() → pool.getMetrics()
Pool Metrics Go No Metrics() struct — use pool.IdleCount(), pool.ActiveCount(), pool.TotalCount()
Close the Pool Node pool.close() is synchronous — remove await
isolated-scope.mdx:

Section Language Issue
Acquire a Scope Node No client.scopedConnection() — use IsolatedScope.acquire(client, connectionRequestBytes, routingKey)
Acquire a Scope Node scope.close() / scope.release() is synchronous — remove await
Acquire a Scope Go No ScopeOptions struct — use positional args: client.ScopedConnection(ctx, timeout, routingKey)

Fixed in fb340ea.

[jeremyprime]

Will keep this as draft until conn pool and scoped conn issues are addressed: https://github.com/valkey-io/valkey-glide/issues?q=is%3Aissue%20state%3Aopen%20label%3Apool%2Fscope