refactor(sessions): rename to RedisSessionMemoryService (0.0.8) (#21)

* refactor(sessions): rename to RedisSessionMemoryService; bump to 0.0.8

Rename the session service to match the managed Redis Agent Memory
"session memory" terminology and ADK's <Backend>SessionService convention:

- RedisWorkingMemorySessionService -> RedisSessionMemoryService
- RedisWorkingMemorySessionServiceConfig -> RedisSessionMemoryServiceConfig
- module sessions/working_memory.py -> sessions/session_memory.py

The old names remain as deprecated aliases that emit a DeprecationWarning
and will be removed in 0.1.0. RedisLongTermMemoryService is unchanged.

Docs, examples, and tests move to the new names. Bump version to 0.0.8
and add CHANGELOG entries.

* fix(sessions): keep legacy working_memory module path importable

Address PR review feedback:

- Add a compatibility shim at adk_redis/sessions/working_memory.py that
  re-exports the session classes and emits a DeprecationWarning on import,
  so `from adk_redis.sessions.working_memory import ...` keeps working
  until 0.1.0.
- Cover the legacy module path in tests/test_imports.py.
- Move the `warnings` import (and importlib/sys helpers) to module scope
  in the test, per the no-inline-imports project standard.
- Note the module-path shim in the CHANGELOG Deprecated section.

Author: nkanu17

CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.0.8] - 2026-06-24
+
+### Changed
+
+- Renamed `RedisWorkingMemorySessionService` to `RedisSessionMemoryService`
+  and `RedisWorkingMemorySessionServiceConfig` to
+  `RedisSessionMemoryServiceConfig`, aligning with the managed Redis Agent
+  Memory "session memory" terminology and ADK's `<Backend>SessionService`
+  convention. The module `adk_redis.sessions.working_memory` moved to
+  `adk_redis.sessions.session_memory`. Docs and examples now use the new
+  names.
+
+### Deprecated
+
+- `RedisWorkingMemorySessionService` and
+  `RedisWorkingMemorySessionServiceConfig` remain as deprecated aliases that
+  emit a `DeprecationWarning` and will be removed in 0.1.0. Switch to
+  `RedisSessionMemoryService` / `RedisSessionMemoryServiceConfig`.
+- The old module path `adk_redis.sessions.working_memory` remains as a
+  compatibility shim that re-exports the classes and emits a
+  `DeprecationWarning` on import. It will be removed in 0.1.0. Import from
+  `adk_redis.sessions.session_memory` or the top-level `adk_redis` package.
+
 ## [0.0.7] - 2026-06-18
 
 ### Added

README.md

@@ -72,12 +72,12 @@ from google.adk.runners import Runner
 from adk_redis import (
     RedisLongTermMemoryService,
     RedisLongTermMemoryServiceConfig,
-    RedisWorkingMemorySessionService,
-    RedisWorkingMemorySessionServiceConfig,
+    RedisSessionMemoryService,
+    RedisSessionMemoryServiceConfig,
 )
 
-session_service = RedisWorkingMemorySessionService(
-    config=RedisWorkingMemorySessionServiceConfig(
+session_service = RedisSessionMemoryService(
+    config=RedisSessionMemoryServiceConfig(
         backend="redis-agent-memory",
         api_base_url="http://localhost:8088",
         api_key="...",

SKILL.md

@@ -94,12 +94,12 @@ from google.adk.runners import Runner
 from adk_redis import (
     RedisLongTermMemoryService,
     RedisLongTermMemoryServiceConfig,
-    RedisWorkingMemorySessionService,
-    RedisWorkingMemorySessionServiceConfig,
+    RedisSessionMemoryService,
+    RedisSessionMemoryServiceConfig,
 )
 
-session_service = RedisWorkingMemorySessionService(
-    config=RedisWorkingMemorySessionServiceConfig(
+session_service = RedisSessionMemoryService(
+    config=RedisSessionMemoryServiceConfig(
         api_base_url="http://localhost:8000",
     ),
 )

docs/concepts/adk_overview.md

@@ -37,7 +37,7 @@ flowchart TD
 
 | ADK Interface | `adk-redis` implementation | Concept page |
 |---------------|---------------------------|-------------|
-| `BaseSessionService` | `RedisWorkingMemorySessionService` | [Sessions + Memory Services](sessions.md) |
+| `BaseSessionService` | `RedisSessionMemoryService` | [Sessions + Memory Services](sessions.md) |
 | `BaseMemoryService` | `RedisLongTermMemoryService` | [Sessions + Memory Services](sessions.md) |
 | `BaseTool` | Search tools (`RedisVectorSearchTool`, `RedisHybridSearchTool`, etc.) and memory tools (`SearchMemoryTool`, `CreateMemoryTool`, etc.) | [Search Tools](search.md), [Memory MCP + Tools](memory.md) |
 | Model callbacks | `LLMResponseCache` with `RedisVLCacheProvider` or `LangCacheProvider` | [Semantic Caching](caching.md) |

docs/concepts/sessions.md

@@ -1,6 +1,6 @@
 # Sessions + Memory with Services
 
-Use `RedisWorkingMemorySessionService` and `RedisLongTermMemoryService` when you want the ADK `Runner` to manage sessions and memory automatically. Plug them in and let the framework handle the rest.
+Use `RedisSessionMemoryService` and `RedisLongTermMemoryService` when you want the ADK `Runner` to manage sessions and memory automatically. Plug them in and let the framework handle the rest.
 
 ## Quick Reference
 
@@ -54,12 +54,12 @@ from google.adk.runners import Runner
 from adk_redis import (
     RedisLongTermMemoryService,
     RedisLongTermMemoryServiceConfig,
-    RedisWorkingMemorySessionService,
-    RedisWorkingMemorySessionServiceConfig,
+    RedisSessionMemoryService,
+    RedisSessionMemoryServiceConfig,
 )
 
-session_service = RedisWorkingMemorySessionService(
-    config=RedisWorkingMemorySessionServiceConfig(
+session_service = RedisSessionMemoryService(
+    config=RedisSessionMemoryServiceConfig(
         backend="redis-agent-memory",
         api_base_url="http://localhost:8000",
         api_key="...",
@@ -103,7 +103,7 @@ adk web .
 
 ## Configuration
 
-### Session Service (`RedisWorkingMemorySessionServiceConfig`)
+### Session Service (`RedisSessionMemoryServiceConfig`)
 
 | Option | Default | Description |
 |--------|---------|-------------|

docs/examples/index.md

@@ -11,7 +11,7 @@ directory and explains what it demonstrates.
 
 | Example | What it shows |
 |---------|---------------|
-| [**Simple Redis memory**](https://github.com/redis-developer/adk-redis/tree/main/examples/simple_redis_memory) | Minimal agent with `RedisWorkingMemorySessionService` and `RedisLongTermMemoryService`. |
+| [**Simple Redis memory**](https://github.com/redis-developer/adk-redis/tree/main/examples/simple_redis_memory) | Minimal agent with `RedisSessionMemoryService` and `RedisLongTermMemoryService`. |
 | [**Fitness coach (MCP)**](https://github.com/redis-developer/adk-redis/tree/main/examples/fitness_coach_mcp) | MCP-based memory with `McpToolset` and Agent Memory Server. |
 | [**Travel agent (hybrid)**](https://github.com/redis-developer/adk-redis/tree/main/examples/travel_agent_memory_hybrid) | Framework-managed sessions + memory with vector search over travel docs. |
 | [**Travel agent (tools)**](https://github.com/redis-developer/adk-redis/tree/main/examples/travel_agent_memory_tools) | Same travel agent using LLM-controlled memory tools instead of framework services. |

docs/for-ais-only/BUILD_AND_TEST.md

@@ -46,7 +46,7 @@ should ship with tests in the matching subdirectory under `tests/`.
 ## Running a single test
 
 ```
-uv run pytest tests/sessions/test_working_memory.py::<test_name> -vv
+uv run pytest tests/sessions/test_session_memory.py::<test_name> -vv
 uv run pytest tests/tools/test_vector_search.py -vv
 ```
 

docs/for-ais-only/FAILURE_MODES.md

@@ -13,7 +13,7 @@ service method, and any prompt fragments together.
 
 ## Sessions and memory go through Agent Memory Server, not Redis directly
 
-Both `RedisWorkingMemorySessionService` and `RedisLongTermMemoryService`
+Both `RedisSessionMemoryService` and `RedisLongTermMemoryService`
 talk to Agent Memory Server, not raw Redis. Reaching into Redis from
 either service bypasses dedup, summarization, embedding, and the
 working-to-long-term promotion pipeline. Stay on the AMS client.

docs/for-ais-only/REPOSITORY_MAP.md

@@ -15,9 +15,9 @@ src/adk_redis/
                           session, search, tool, and cache classes).
   _version.py             Build-time version string.
   sessions/
-    __init__.py           Re-exports RedisWorkingMemorySessionService.
-    working_memory.py     ADK BaseSessionService implementation backed by
-                          Redis Agent Memory Server working memory.
+    __init__.py           Re-exports RedisSessionMemoryService.
+    session_memory.py     ADK BaseSessionService implementation backed by
+                          Redis Agent Memory or Agent Memory Server.
   memory/
     __init__.py           Re-exports RedisLongTermMemoryService and the
                           memory tools (Memory Prompt / Search / Create /
@@ -50,7 +50,7 @@ tests/
   test_imports.py              Smoke test for every public re-export.
   test_version.py              `__version__` is set.
   sessions/
-    test_working_memory.py     RedisWorkingMemorySessionService end-to-end.
+    test_session_memory.py     RedisSessionMemoryService end-to-end.
   memory/
     test_long_term_memory.py   RedisLongTermMemoryService end-to-end.
   tools/
@@ -77,7 +77,7 @@ tests/
 
 | Feature | Module(s) |
 |---|---|
-| Working-memory session storage | `sessions/working_memory.py` |
+| Session storage (session memory) | `sessions/session_memory.py` |
 | Long-term memory + Memory Server proxy | `memory/long_term_memory.py`, `memory/_utils.py` |
 | ADK Memory tools (FunctionTool wrappers) | `tools/memory/` |
 | MCP (RedisVL or AMS) | Use ADK's native `McpToolset` directly; no adk-redis wrapper. |
@@ -92,9 +92,10 @@ tests/
   `FunctionTool` plus a thin RedisVL query. Tools are independent; copy
   the closest existing one. Wire it through `tools/__init__.py` and the
   re-export in `adk_redis/__init__.py`.
-- **The session service.** `sessions/working_memory.py` implements ADK's
-  `BaseSessionService`. It calls Agent Memory Server working-memory
-  endpoints; do not reach into Redis directly from the session layer.
+- **The session service.** `sessions/session_memory.py` implements ADK's
+  `BaseSessionService`. It calls the configured memory backend (Redis Agent
+  Memory or the self-hosted Agent Memory Server working-memory endpoints); do
+  not reach into Redis directly from the session layer.
 - **The memory service.** `memory/long_term_memory.py` implements ADK's
   `BaseMemoryService`. The memory tools under `tools/memory/` are thin
   `FunctionTool` wrappers and must keep parameter names aligned with

docs/llms.txt

@@ -28,14 +28,14 @@ For task-oriented recipes, browse the
 - [Redis setup](user_guide/how_to_guides/redis_setup.md): start Redis 8.4 locally or in Redis Cloud.
 - [Managed memory setup](user_guide/how_to_guides/managed_memory_setup.md): connect to the managed Redis Agent Memory backend.
 - [Memory server setup](user_guide/how_to_guides/memory_server_setup.md): run Agent Memory Server.
-- [Session service](user_guide/how_to_guides/session_service.md): wire `RedisWorkingMemorySessionService`.
+- [Session service](user_guide/how_to_guides/session_service.md): wire `RedisSessionMemoryService`.
 - [Memory service](user_guide/how_to_guides/memory_service.md): wire `RedisLongTermMemoryService`.
 - [Search tools](user_guide/how_to_guides/search_tools.md): use the five search tools and the RedisVL MCP toolset.
 - [Semantic cache](user_guide/how_to_guides/semantic_cache.md): add self-hosted or managed semantic caching.
 
 ## API reference
 
-- [Sessions](api/python/sessions.md): `RedisWorkingMemorySessionService`, `RedisWorkingMemorySessionServiceConfig`.
+- [Sessions](api/python/sessions.md): `RedisSessionMemoryService`, `RedisSessionMemoryServiceConfig`.
 - [Memory](api/python/memory.md): `RedisLongTermMemoryService`, `RedisLongTermMemoryServiceConfig`.
 - [Tools](api/python/tools.md): search tools, memory tools, MCP toolset helpers.
 - [Cache](api/python/cache.md): cache providers, `LLMResponseCache`, `ToolCache`, callback factories.