Python: [BREAKING] update context provider APIs, middleware, and per-service-call history persistence (#4992)

* Rename provider base APIs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Allow provider-added chat and function middleware

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Simulate service-stored history per model call

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fix typing regressions in CI

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fix response ID suppression review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Rename per-service-call history persistence APIs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address context persistence review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Stabilize markdown sample docs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Persist service continuation state per call

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

python/packages/redis/agent_framework_redis/_context_provider.py

@@ -1,9 +1,9 @@
 # Copyright (c) Microsoft. All rights reserved.
 
-"""New-pattern Redis context provider using BaseContextProvider.
+"""New-pattern Redis context provider using ContextProvider.
 
 This module provides ``RedisContextProvider``, built on the new
-:class:`BaseContextProvider` hooks pattern.
+:class:`ContextProvider` hooks pattern.
 """
 
 from __future__ import annotations
@@ -16,7 +16,7 @@ from typing import TYPE_CHECKING, Any, ClassVar, Literal
 
 import numpy as np
 from agent_framework import Message
-from agent_framework._sessions import AgentSession, BaseContextProvider, SessionContext
+from agent_framework._sessions import AgentSession, ContextProvider, SessionContext
 from agent_framework.exceptions import (
     AgentException,
     IntegrationInvalidRequestException,
@@ -41,8 +41,8 @@ if TYPE_CHECKING:
     from agent_framework._agents import SupportsAgentRun
 
 
-class RedisContextProvider(BaseContextProvider):
-    """Redis context provider using the new BaseContextProvider hooks pattern.
+class RedisContextProvider(ContextProvider):
+    """Redis context provider using the new ContextProvider hooks pattern.
 
     Stores context in Redis and retrieves scoped context via full-text or
     optional hybrid vector search.

python/packages/redis/agent_framework_redis/_history_provider.py

@@ -1,9 +1,9 @@
 # Copyright (c) Microsoft. All rights reserved.
 
-"""New-pattern Redis history provider using BaseHistoryProvider.
+"""New-pattern Redis history provider using HistoryProvider.
 
 This module provides ``RedisHistoryProvider``, built on the new
-:class:`BaseHistoryProvider` hooks pattern.
+:class:`HistoryProvider` hooks pattern.
 """
 
 from __future__ import annotations
@@ -13,12 +13,12 @@ from typing import Any, ClassVar
 
 import redis.asyncio as redis
 from agent_framework import Message
-from agent_framework._sessions import BaseHistoryProvider
+from agent_framework._sessions import HistoryProvider
 from redis.credentials import CredentialProvider
 
 
-class RedisHistoryProvider(BaseHistoryProvider):
-    """Redis-backed history provider using the new BaseHistoryProvider hooks pattern.
+class RedisHistoryProvider(HistoryProvider):
+    """Redis-backed history provider using the new HistoryProvider hooks pattern.
 
     Stores conversation history in Redis Lists, with each session isolated by a
     unique Redis key.

python/packages/redis/tests/test_providers.py

@@ -475,7 +475,7 @@ class TestRedisHistoryProviderClear:
 
 
 class TestRedisHistoryProviderBeforeAfterRun:
-    """Test before_run/after_run integration via BaseHistoryProvider defaults."""
+    """Test before_run/after_run integration via HistoryProvider defaults."""
 
     async def test_before_run_loads_history(self, mock_redis_client: MagicMock):
         msg = Message(role="user", contents=["old msg"])