2 Commits

• Python: [BREAKING] Simplify API: ChatAgent -> Agent, ChatMessage -> Message (#3747)

  * [BREAKING] Rename ChatAgent -> Agent, ChatMessage -> Message, ChatClientProtocol -> SupportsChatGetResponse
  
  Simplify the public API by removing redundant 'Chat' prefix from core types:
  - ChatAgent -> Agent
  - RawChatAgent -> RawAgent
  - ChatMessage -> Message
  - ChatClientProtocol -> SupportsChatGetResponse
  
  Also renamed internal WorkflowMessage (was Message in _runner_context) to avoid collision.
  
  No backward compatibility aliases - this is a clean breaking change.
  
  * [BREAKING] Rename Agent chat_client parameter to client
  
  * Fix rebase issues: WorkflowMessage references and broken markdown links
  
  * Fix formatting and lint issues from code quality checks
  
  * Fix import ordering in workflow sample files
  
  * fixed rebase
  
  * Fix test failures: use WorkflowMessage and A2AMessage after ChatMessage→Message rename
  
  - Replace Message(data=..., source_id=...) with WorkflowMessage(...) in workflow tests
  - Fix isinstance check in A2A agent to use A2AMessage instead of Message
  - Fix import in test_workflow_observability.py (Message→WorkflowMessage)
  
  * Fix lint, fmt, and sample errors after ChatMessage→Message rename
  
  - Auto-fix 70+ ruff lint issues across samples (ChatMessage→Message refs)
  - Fix HostedVectorStoreContent→Content.from_hosted_vector_store in file search sample
  - Fix _normalize_messages→normalize_messages in custom agent sample
  - Fix context.terminate→raise MiddlewareTermination in middleware samples
  - Fix with_update_hook→with_transform_hook in override middleware sample
  - Add TOptions_co import back to custom_chat_client sample
  - Add noqa for FastAPI File() default in chatkit sample
  - Fix B023 loop variable capture in weather agent sample
  
  * fix: update Agent constructor calls from chat_client to client in declaration-only tool tests
  
  * fix: add register_cleanup to devui lazy-loading proxy and type stub
  
  * fixed tests and updated new pieces
  
  * fix agui typevar
  
  * fix merge errors
  
  * fix merge conflicts
  
  * fiux merge
  
  * Remove unused links
  
  ---------
  
  Co-authored-by: Evan Mattson <evan.mattson@microsoft.com>

  Eduard van Valkenburg · 2026-02-10 23:04:32 +00:00
  0521f5bed8
• Python: PR1 — New session and context provider types (side-by-side) (#3763)

  * PR1: Add core context provider types and tests
  
  New types in _sessions.py (no changes to existing code):
  - SessionContext: per-invocation state with extend_messages/get_messages/
    extend_instructions/extend_tools and read-only response property
  - _ContextProviderBase: base class with before_run/after_run hooks
  - _HistoryProviderBase: storage base with load/store flags, abstract
    get_messages/save_messages, default before_run/after_run
  - AgentSession: lightweight session with state dict, to_dict/from_dict
  - InMemoryHistoryProvider: built-in provider storing in session.state
  
  35 unit tests covering all classes and configuration flags.
  
  * feat: keyword-only params, stateless InMemoryHistoryProvider, deep serialization
  
  - Make before_run/after_run parameters keyword-only
  - InMemoryHistoryProvider stores ChatMessage objects directly (no per-cycle serialization)
  - Deep serialization via to_dict/from_dict only at session boundary
  - State type registry for automatic deserialization of registered types
  - Updated tests for new serialization approach
  
  * feat: add new-pattern provider implementations for external packages
  
  - _RedisContextProvider(BaseContextProvider) - Redis search/vector context
  - _RedisHistoryProvider(BaseHistoryProvider) - Redis-backed message storage
  - _Mem0ContextProvider(BaseContextProvider) - Mem0 semantic memory
  - _AzureAISearchContextProvider(BaseContextProvider) - Azure AI Search (semantic + agentic)
  
  All use temporary _ prefix names for side-by-side coexistence with existing providers.
  Will be renamed in PR2 when old ContextProvider/ChatMessageStore are removed.
  
  * test: add tests for new-pattern provider implementations
  
  - 32 tests for _RedisContextProvider and _RedisHistoryProvider
  - 29 tests for _Mem0ContextProvider
  - 17 tests for _AzureAISearchContextProvider
  
  * fix: address PR review comments and CI failures
  
  - Move module docstring before imports in _sessions.py (review comment)
  - Import TYPE_CHECKING unconditionally in Redis _context_provider.py (NameError on Python <3.12)
  - Fix Mem0 test_init_auto_creates_client_when_none to patch at class level
  
  * feat: add source attribution to extend_messages
  
  Set attribution marker in additional_properties for each message
  added via extend_messages(), matching the tool attribution pattern.
  Uses setdefault to preserve any existing attribution.
  
  * refactor: make attribution value a dict with source_id key
  
  * add attribution and use sets for filters
  
  * Add source_type to message attribution and copy messages in extend_messages
  
  - SessionContext.extend_messages now accepts source as str or object with
    source_id attribute; when an object is passed, its class name is recorded
    as source_type in the attribution dict
  - Messages are shallow-copied before attribution is added so callers'
    original objects are never mutated
  - Filter framework-internal keys (attribution) from A2A wire metadata
    to prevent leaking internal state over the wire
  
  * fix: correct mypy type: ignore comment from union-attr to attr-defined
  
  * set attribution to _attribution
  
  * adjusted naming of bools

  Eduard van Valkenburg · 2026-02-10 21:19:15 +00:00
  ac0e6b0ee1