fix(state): docstring accuracy + forward token_prefix through create_redis_state

- Corrects the observability example in RedisStateAdapter docstring
  (KEYS only returns key names, not values)
- create_redis_state factory now accepts/forwards token_prefix to
  keep the factory and direct-instantiation paths aligned

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: patrick-chinchill

src/chat_sdk/state/redis.py

@@ -368,8 +368,9 @@ class IoRedisStateAdapter(RedisStateAdapter):
     cross-runtime Redis sharing, not a security boundary.
 
     Enables migrations like "drain TS, then flip Python on" with tokens
-    identifiable by runtime-of-origin at a glance when inspecting
-    ``KEYS chat:lock:*`` in Redis.
+    identifiable by runtime-of-origin at a glance — e.g. reading a lock's
+    value via ``GET chat-sdk:lock:<thread_id>``, or in any logs/trace IDs
+    where the token is surfaced on release/extend failures.
     """
 
     def __init__(self, *, token_prefix: str = "ioredis", **kwargs: Any) -> None:
@@ -386,10 +387,20 @@ def create_redis_state(
     url: str | None = None,
     client: Any | None = None,
     key_prefix: str = "chat-sdk",
+    token_prefix: str = "redis",
 ) -> RedisStateAdapter:
     """Create a new Redis state adapter.
 
     Either provide a ``url`` or an existing ``client``.  If neither is given,
     the ``REDIS_URL`` environment variable is used.
+
+    ``token_prefix`` defaults to ``"redis"`` to match
+    :class:`RedisStateAdapter`'s default; pass ``"ioredis"`` (or instantiate
+    :class:`IoRedisStateAdapter`) for TS interop.
     """
-    return RedisStateAdapter(url=url, client=client, key_prefix=key_prefix)
+    return RedisStateAdapter(
+        url=url,
+        client=client,
+        key_prefix=key_prefix,
+        token_prefix=token_prefix,
+    )

tests/test_state_redis.py

@@ -13,7 +13,11 @@
 import pytest
 
 from chat_sdk.errors import StateNotConnectedError
-from chat_sdk.state.redis import IoRedisStateAdapter, RedisStateAdapter
+from chat_sdk.state.redis import (
+    IoRedisStateAdapter,
+    RedisStateAdapter,
+    create_redis_state,
+)
 from chat_sdk.types import Lock, QueueEntry
 
 # ============================================================================
@@ -689,6 +693,31 @@ async def test_extend_lock_works_with_custom_prefix(self, mock_redis: MockRedis)
         finally:
             await adapter.disconnect()
 
+    @pytest.mark.asyncio
+    async def test_create_redis_state_default_token_prefix(self, mock_redis: MockRedis):
+        """create_redis_state() defaults to 'redis' token prefix (back-compat)."""
+        adapter = create_redis_state(client=mock_redis, key_prefix="test")
+        await adapter.connect()
+        try:
+            lock = await adapter.acquire_lock("thread-1", 30_000)
+            assert lock is not None
+            assert lock.token.startswith("redis_")
+            assert not lock.token.startswith("ioredis_")
+        finally:
+            await adapter.disconnect()
+
+    @pytest.mark.asyncio
+    async def test_create_redis_state_forwards_token_prefix(self, mock_redis: MockRedis):
+        """create_redis_state(token_prefix=...) forwards through to the adapter."""
+        adapter = create_redis_state(client=mock_redis, key_prefix="test", token_prefix="ioredis")
+        await adapter.connect()
+        try:
+            lock = await adapter.acquire_lock("thread-1", 30_000)
+            assert lock is not None
+            assert lock.token.startswith("ioredis_")
+        finally:
+            await adapter.disconnect()
+
 
 # ============================================================================
 # Lists: append with maxLength