microsoft-agents-hosting-core 0.4.0.dev14__py3-none-any.whl → 0.4.0.dev16__py3-none-any.whl

microsoft_agents/hosting/core/channel_service_adapter.py

@@ -213,21 +213,21 @@ class ChannelServiceAdapter(ChannelAdapter, ABC):
         claims_identity = self.create_claims_identity(agent_app_id)
         claims_identity.claims[AuthenticationConstants.SERVICE_URL_CLAIM] = service_url
 
-        # Create a UserTokenClient instance for the application to use. (For example, in the OAuthPrompt.)
-        user_token_client: UserTokenClient = (
-            await self._channel_service_client_factory.create_user_token_client(
-                claims_identity
-            )
-        )
-
         # Create a turn context and run the pipeline.
         context = self._create_turn_context(
             claims_identity,
             None,
-            user_token_client,
             callback,
         )
 
+        # Create a UserTokenClient instance for the application to use. (For example, in the OAuthPrompt.)
+        user_token_client: UserTokenClient = (
+            await self._channel_service_client_factory.create_user_token_client(
+                context, claims_identity
+            )
+        )
+        context.turn_state[self.USER_TOKEN_CLIENT_KEY] = user_token_client
+
         # Create the connector client to use for outbound requests.
         connector_client: ConnectorClient = (
             await self._channel_service_client_factory.create_connector_client(
@@ -264,22 +264,21 @@ class ChannelServiceAdapter(ChannelAdapter, ABC):
         callback: Callable[[TurnContext], Awaitable],
     ):
 
-        # Create a UserTokenClient instance for the application to use. (For example, in the OAuthPrompt.)
-        user_token_client: UserTokenClient = (
-            await self._channel_service_client_factory.create_user_token_client(
-                claims_identity
-            )
-        )
-
         # Create a turn context and run the pipeline.
         context = self._create_turn_context(
             claims_identity,
             audience,
-            user_token_client,
             callback,
             activity=continuation_activity,
         )
 
+        user_token_client: UserTokenClient = (
+            await self._channel_service_client_factory.create_user_token_client(
+                context, claims_identity
+            )
+        )
+        context.turn_state[self.USER_TOKEN_CLIENT_KEY] = user_token_client
+
         # Create the connector client to use for outbound requests.
         connector_client: ConnectorClient = (
             await self._channel_service_client_factory.create_connector_client(
@@ -338,22 +337,22 @@ class ChannelServiceAdapter(ChannelAdapter, ABC):
         ):
             use_anonymous_auth_callback = True
 
-        # Create a UserTokenClient instance for the OAuth flow.
-        user_token_client: UserTokenClient = (
-            await self._channel_service_client_factory.create_user_token_client(
-                claims_identity, use_anonymous_auth_callback
-            )
-        )
-
         # Create a turn context and run the pipeline.
         context = self._create_turn_context(
             claims_identity,
             outgoing_audience,
-            user_token_client,
             callback,
             activity=activity,
         )
 
+        # Create a UserTokenClient instance for the OAuth flow.
+        user_token_client: UserTokenClient = (
+            await self._channel_service_client_factory.create_user_token_client(
+                context, claims_identity, use_anonymous_auth_callback
+            )
+        )
+        context.turn_state[self.USER_TOKEN_CLIENT_KEY] = user_token_client
+
         # Create the connector client to use for outbound requests.
         connector_client: ConnectorClient = (
             await self._channel_service_client_factory.create_connector_client(
@@ -425,14 +424,12 @@ class ChannelServiceAdapter(ChannelAdapter, ABC):
         self,
         claims_identity: ClaimsIdentity,
         oauth_scope: str,
-        user_token_client: UserTokenClientBase,
         callback: Callable[[TurnContext], Awaitable],
         activity: Optional[Activity] = None,
     ) -> TurnContext:
         context = TurnContext(self, activity, claims_identity)
 
         context.turn_state[self.AGENT_IDENTITY_KEY] = claims_identity
-        context.turn_state[self.USER_TOKEN_CLIENT_KEY] = user_token_client
         context.turn_state[self.AGENT_CALLBACK_HANDLER_KEY] = callback
         context.turn_state[self.CHANNEL_SERVICE_FACTORY_KEY] = (
             self._channel_service_client_factory

microsoft_agents/hosting/core/channel_service_client_factory_base.py

@@ -6,12 +6,14 @@ from microsoft_agents.hosting.core.connector import (
     ConnectorClientBase,
     UserTokenClientBase,
 )
+from microsoft_agents.hosting.core.turn_context import TurnContext
 
 
 class ChannelServiceClientFactoryBase(Protocol):
     @abstractmethod
     async def create_connector_client(
         self,
+        context: TurnContext,
         claims_identity: ClaimsIdentity,
         service_url: str,
         audience: str,
@@ -32,7 +34,10 @@ class ChannelServiceClientFactoryBase(Protocol):
 
     @abstractmethod
     async def create_user_token_client(
-        self, claims_identity: ClaimsIdentity, use_anonymous: bool = False
+        self,
+        context: TurnContext,
+        claims_identity: ClaimsIdentity,
+        use_anonymous: bool = False,
     ) -> UserTokenClientBase:
         """
         Creates the appropriate UserTokenClientBase instance.

microsoft_agents/hosting/core/connector/client/connector_client.py

@@ -122,8 +122,12 @@ class AttachmentsOperations(AttachmentsBase):
 
 class ConversationsOperations(ConversationsBase):
 
-    def __init__(self, client: ClientSession):
+    def __init__(self, client: ClientSession, **kwargs):
         self.client = client
+        self._max_conversation_id_length = kwargs.get("max_conversation_id_length", 200)
+
+    def _normalize_conversation_id(self, conversation_id: str) -> str:
+        return conversation_id[: self._max_conversation_id_length]
 
     async def get_conversations(
         self, continuation_token: Optional[str] = None
@@ -193,11 +197,16 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId and activityId are required")
 
+        print("\n*3")
+        print(conversation_id)
+        print("\n*3")
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/activities/{activity_id}"
 
         logger.info(
             f"Replying to activity: {activity_id} in conversation: {conversation_id}. Activity type is {body.type}"
         )
+
         async with self.client.post(
             url,
             json=body.model_dump(
@@ -216,7 +225,8 @@ class ConversationsOperations(ConversationsBase):
             logger.info(
                 f"Reply to conversation/activity: {result.get('id')}, {activity_id}"
             )
-            return ResourceResponse.model_validate(result)
+
+        return ResourceResponse.model_validate(result)
 
     async def send_to_conversation(
         self, conversation_id: str, body: Activity
@@ -235,6 +245,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId is required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/activities"
 
         logger.info(
@@ -271,6 +282,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId and activityId are required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/activities/{activity_id}"
 
         logger.info(
@@ -303,6 +315,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId and activityId are required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/activities/{activity_id}"
 
         logger.info(
@@ -332,6 +345,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId is required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/attachments"
 
         # Convert the AttachmentData to a dictionary
@@ -371,6 +385,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId is required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/members"
 
         logger.info(f"Getting conversation members for conversation: {conversation_id}")
@@ -402,6 +417,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId and memberId are required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/members/{member_id}"
 
         logger.info(
@@ -434,6 +450,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId and memberId are required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/members/{member_id}"
 
         logger.info(
@@ -464,6 +481,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId and activityId are required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/activities/{activity_id}/members"
 
         logger.info(
@@ -507,6 +525,7 @@ class ConversationsOperations(ConversationsBase):
         if continuation_token is not None:
             params["continuationToken"] = continuation_token
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/pagedmembers"
 
         logger.info(
@@ -540,6 +559,7 @@ class ConversationsOperations(ConversationsBase):
             )
             raise ValueError("conversationId is required")
 
+        conversation_id = self._normalize_conversation_id(conversation_id)
         url = f"v3/conversations/{conversation_id}/activities/history"
 
         logger.info(f"Sending conversation history to conversation: {conversation_id}")

microsoft_agents/hosting/core/rest_channel_service_client_factory.py

@@ -1,4 +1,3 @@
-import re
 from typing import Optional
 import logging
 
@@ -33,6 +32,52 @@ class RestChannelServiceClientFactory(ChannelServiceClientFactoryBase):
         self._token_service_endpoint = token_service_endpoint
         self._token_service_audience = token_service_audience
 
+    async def _get_agentic_token(self, context: TurnContext, service_url: str) -> str:
+        logger.info(
+            "Creating connector client for agentic request to service_url: %s",
+            service_url,
+        )
+
+        if not context.identity:
+            raise ValueError("context.identity is required for agentic activities")
+
+        connection = self._connection_manager.get_token_provider(
+            context.identity, service_url
+        )
+        if not hasattr(connection, "_msal_configuration"):
+            raise TypeError(
+                "Connection does not support MSAL configuration for agentic token retrieval"
+            )
+
+        if connection._msal_configuration.ALT_BLUEPRINT_ID:
+            logger.debug(
+                "Using alternative blueprint ID for agentic token retrieval: %s",
+                connection._msal_configuration.ALT_BLUEPRINT_ID,
+            )
+            connection = self._connection_manager.get_connection(
+                connection._msal_configuration.ALT_BLUEPRINT_ID
+            )
+
+        agent_instance_id = context.activity.get_agentic_instance_id()
+        if not agent_instance_id:
+            raise ValueError("Agent instance ID is required for agentic identity role")
+
+        if context.activity.recipient.role == RoleTypes.agentic_identity:
+            token, _ = await connection.get_agentic_instance_token(agent_instance_id)
+        else:
+            agentic_user = context.activity.get_agentic_user()
+            if not agentic_user:
+                raise ValueError("Agentic user is required for agentic user role")
+            token = await connection.get_agentic_user_token(
+                agent_instance_id,
+                agentic_user,
+                [AuthenticationConstants.APX_PRODUCTION_SCOPE],
+            )
+
+        if not token:
+            raise ValueError("Failed to obtain token for agentic activity")
+        return token
+
     async def create_connector_client(
         self,
         context: TurnContext,
@@ -42,6 +87,8 @@ class RestChannelServiceClientFactory(ChannelServiceClientFactoryBase):
         scopes: Optional[list[str]] = None,
         use_anonymous: bool = False,
     ) -> ConnectorClientBase:
+        if not context or not claims_identity:
+            raise TypeError("context and claims_identity are required")
         if not service_url:
             raise TypeError(
                 "RestChannelServiceClientFactory.create_connector_client: service_url can't be None or Empty"
@@ -52,50 +99,7 @@ class RestChannelServiceClientFactory(ChannelServiceClientFactoryBase):
             )
 
         if context.activity.is_agentic_request():
-            logger.info(
-                "Creating connector client for agentic request to service_url: %s",
-                service_url,
-            )
-
-            if not context.identity:
-                raise ValueError("context.identity is required for agentic activities")
-
-            connection = self._connection_manager.get_token_provider(
-                context.identity, service_url
-            )
-
-            # TODO: clean up linter
-            if connection._msal_configuration.ALT_BLUEPRINT_ID:
-                logger.debug(
-                    "Using alternative blueprint ID for agentic token retrieval: %s",
-                    connection._msal_configuration.ALT_BLUEPRINT_ID,
-                )
-                connection = self._connection_manager.get_connection(
-                    connection._msal_configuration.ALT_BLUEPRINT_ID
-                )
-
-            agent_instance_id = context.activity.get_agentic_instance_id()
-            if not agent_instance_id:
-                raise ValueError(
-                    "Agent instance ID is required for agentic identity role"
-                )
-
-            if context.activity.recipient.role == RoleTypes.agentic_identity:
-                token, _ = await connection.get_agentic_instance_token(
-                    agent_instance_id
-                )
-            else:
-                agentic_user = context.activity.get_agentic_user()
-                if not agentic_user:
-                    raise ValueError("Agentic user is required for agentic user role")
-                token = await connection.get_agentic_user_token(
-                    agent_instance_id,
-                    agentic_user,
-                    [AuthenticationConstants.APX_PRODUCTION_SCOPE],
-                )
-
-            if not token:
-                raise ValueError("Failed to obtain token for agentic activity")
+            token = await self._get_agentic_token(context, service_url)
         else:
             token_provider: AccessTokenProviderBase = (
                 self._connection_manager.get_token_provider(
@@ -115,18 +119,40 @@ class RestChannelServiceClientFactory(ChannelServiceClientFactoryBase):
         )
 
     async def create_user_token_client(
-        self, claims_identity: ClaimsIdentity, use_anonymous: bool = False
+        self,
+        context: TurnContext,
+        claims_identity: ClaimsIdentity,
+        use_anonymous: bool = False,
     ) -> UserTokenClient:
+        """Create a UserTokenClient for the given context and claims identity.
+
+        :param context: The TurnContext for the current turn of conversation.
+        :param claims_identity: The ClaimsIdentity of the user.
+        :param use_anonymous: Whether to use an anonymous token provider.
+        """
+        if not context or not claims_identity:
+            raise ValueError("context and claims_identity are required")
+
         if use_anonymous:
             return UserTokenClient(endpoint=self._token_service_endpoint, token="")
 
-        token_provider = self._connection_manager.get_token_provider(
-            claims_identity, self._token_service_endpoint
-        )
+        if context.activity.is_agentic_request():
+            token = await self._get_agentic_token(context, self._token_service_endpoint)
+        else:
+            scopes = [f"{self._token_service_audience}/.default"]
+
+            token_provider = self._connection_manager.get_token_provider(
+                claims_identity, self._token_service_endpoint
+            )
+
+            token = await token_provider.get_access_token(
+                self._token_service_audience, scopes
+            )
+
+        if not token:
+            logger.error("Failed to obtain token for user token client")
+            raise ValueError("Failed to obtain token for user token client")
 
-        token = await token_provider.get_access_token(
-            self._token_service_audience, [f"{self._token_service_audience}/.default"]
-        )
         return UserTokenClient(
             endpoint=self._token_service_endpoint,
             token=token,

microsoft_agents/hosting/core/storage/__init__.py

@@ -7,8 +7,10 @@ from .transcript_logger import (
     ConsoleTranscriptLogger,
     TranscriptLoggerMiddleware,
     FileTranscriptLogger,
+    PagedResult,
 )
 from .transcript_store import TranscriptStore
+from .transcript_file_store import FileTranscriptStore
 
 __all__ = [
     "StoreItem",
@@ -21,4 +23,6 @@ __all__ = [
     "TranscriptLoggerMiddleware",
     "TranscriptStore",
     "FileTranscriptLogger",
+    "FileTranscriptStore",
+    "PagedResult",
 ]

microsoft_agents/hosting/core/storage/transcript_file_store.py

@@ -0,0 +1,267 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+import re
+
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Union
+
+from .transcript_logger import TranscriptLogger
+from .transcript_logger import PagedResult
+from .transcript_info import TranscriptInfo
+
+from microsoft_agents.activity import Activity  # type: ignore
+
+
+class FileTranscriptStore(TranscriptLogger):
+    """
+    Python port of the .NET FileTranscriptStore which creates a single
+    `.transcript` file per conversation and appends each Activity as newline-delimited JSON.
+
+    Layout on disk:
+        <root>/<channelId>/<conversationId>.transcript
+
+    - Each line is a JSON object representing one Activity.
+    - Methods are async to match the Agents SDK shape.
+
+    Notes
+    -----
+    * Continuation tokens are simple integer byte offsets encoded as strings.
+    * Activities are written using UTF-8 with newline separators (JSONL).
+    * Filenames are sanitized to avoid path traversal and invalid characters.
+
+    Inspired by the .NET design for FileTranscriptLogger. See:
+      - Microsoft.Bot.Builder FileTranscriptLogger docs (for behavior)  [DOTNET]
+      - Microsoft.Agents.Storage.Transcript namespace overview           [AGENTS]
+    """
+
+    def __init__(self, root_folder: Union[str, Path]) -> None:
+        self._root = Path(root_folder).expanduser().resolve()
+        self._root.mkdir(parents=True, exist_ok=True)
+
+        # precompiled regex for safe names (letters, digits, dash, underscore, dot)
+        self._safe = re.compile(r"[^A-Za-z0-9._-]+")
+
+    # -------- Logger surface --------
+
+    async def log_activity(self, activity: Activity) -> None:
+        """
+        Asynchronously persist a transcript activity to the file system.
+        This method computes the transcript file path based on the activity’s channel
+        and conversation identifiers, ensures the directory exists, and appends the
+        activity data to the transcript file in JSON format using a background thread.
+        If the activity lacks a timestamp, one is assigned prior to serialization.
+        :param activity: The activity to log.
+        """
+        if not activity:
+            raise ValueError("Activity is required")
+
+        channel_id, conversation_id = _get_ids(activity)
+        file_path = self._file_path(channel_id, conversation_id)
+        file_path.parent.mkdir(parents=True, exist_ok=True)
+
+        # Ensure a stable timestamp property if absent
+        # Write in a background thread to avoid blocking the event loop
+        def _write() -> None:
+            # Normalize to a dict to ensure json serializable content.
+            if not activity.timestamp:
+                activity.timestamp = _utc_iso_now()
+
+            with open(file_path, "a", encoding="utf-8", newline="\n") as f:
+                f.write(activity.model_dump_json(exclude_none=True, exclude_unset=True))
+                f.write("\n")
+
+        await asyncio.to_thread(_write)
+
+    # -------- Store surface --------
+
+    async def list_transcripts(self, channel_id: str) -> PagedResult[TranscriptInfo]:
+        """
+        List transcripts (conversations) for a channel.
+        :param channel_id: The channel ID to list transcripts for."""
+        channel_dir = self._channel_dir(channel_id)
+
+        def _list() -> List[TranscriptInfo]:
+            if not channel_dir.exists():
+                return []
+            results: List[TranscriptInfo] = []
+            for p in channel_dir.glob("*.transcript"):
+                # mtime is a reasonable proxy for 'created/updated'
+                created = datetime.fromtimestamp(p.stat().st_mtime, tz=timezone.utc)
+                results.append(
+                    TranscriptInfo(
+                        channel_id=_sanitize(self._safe, channel_id),
+                        conversation_id=p.stem,
+                        created_on=created,
+                    )
+                )
+            # Sort newest first (consistent, useful default)
+            results.sort(key=lambda t: t.created_on, reverse=True)
+            return results
+
+        items = await asyncio.to_thread(_list)
+        return PagedResult(items=items, continuation_token=None)
+
+    async def get_transcript_activities(
+        self,
+        channel_id: str,
+        conversation_id: str,
+        continuation_token: Optional[str] = None,
+        start_date: Optional[datetime] = None,
+        page_bytes: int = 512 * 1024,
+    ) -> PagedResult[Activity]:
+        """
+        Read activities from the transcript file (paged by byte size).
+        :param channel_id: The channel ID of the conversation.
+        :param conversation_id: The conversation ID to read activities from.
+        :param continuation_token: Optional continuation token (byte offset as string).
+        :param start_date: Optional filter to only include activities on or after this date.
+        :param page_bytes: Maximum number of bytes to read (default: 512kB).
+        :return: A PagedResult containing a list of Activities and an optional continuation token.
+        """
+        file_path = self._file_path(channel_id, conversation_id)
+
+        def _read_page() -> Tuple[List[Activity], Optional[str]]:
+            if not file_path.exists():
+                return [], None
+
+            offset = int(continuation_token) if continuation_token else 0
+            results: List[Activity] = []
+
+            with open(file_path, "rb") as f:
+                f.seek(0, os.SEEK_END)
+                end = f.tell()
+                if offset > end:
+                    return [], None
+                f.seek(offset)
+                # Read a chunk
+                raw = f.read(page_bytes)
+                # Extend to end of current line to avoid cutting a JSON record in half
+                # (read until newline or EOF)
+                while True:
+                    ch = f.read(1)
+                    if not ch:
+                        break
+                    raw += ch
+                    if ch == b"\n":
+                        break
+
+                next_offset = f.tell()
+            # Decode and split lines
+            text = raw.decode("utf-8", errors="ignore")
+            lines = [ln for ln in text.splitlines() if ln.strip()]
+
+            # Parse JSONL
+            for ln in lines:
+                try:
+                    a = Activity.model_validate_json(ln)
+                except Exception:
+                    # Skip malformed lines
+                    continue
+                if start_date:
+                    if a.timestamp and a.timestamp < start_date.astimezone(
+                        timezone.utc
+                    ):
+                        continue
+                results.append(a)
+
+            token = str(next_offset) if next_offset < end else None
+            return results, token
+
+        items, token = await asyncio.to_thread(_read_page)
+        return PagedResult(items=items, continuation_token=token)
+
+    async def delete_transcript(self, channel_id: str, conversation_id: str) -> None:
+        """Delete the specified conversation transcript file (no-op if absent)."""
+        file_path = self._file_path(channel_id, conversation_id)
+
+        def _delete() -> None:
+            try:
+                file_path.unlink(missing_ok=True)
+            except Exception:
+                # Best-effort deletion: ignore failures (locked file, etc.)
+                pass
+
+        await asyncio.to_thread(_delete)
+
+    # ----------------------------
+    # Helpers
+    # ----------------------------
+
+    def _channel_dir(self, channel_id: str) -> Path:
+        return self._root / _sanitize(self._safe, channel_id)
+
+    def _file_path(self, channel_id: str, conversation_id: str) -> Path:
+        safe_channel = _sanitize(self._safe, channel_id)
+        safe_conv = _sanitize(self._safe, conversation_id)
+        return self._root / safe_channel / f"{safe_conv}.transcript"
+
+
+# ----------------------------
+# Module-level helpers
+# ----------------------------
+
+
+def _sanitize(pattern: re.Pattern[str], value: str) -> str:
+    # Replace path-separators and illegal filename chars with '-'
+    value = (value or "").strip().replace(os.sep, "-").replace("/", "-")
+    value = pattern.sub("-", value)
+    return value or "unknown"
+
+
+def _get_ids(activity: Activity) -> Tuple[str, str]:
+    # Works with both dict-like and object-like Activity
+    def _get(obj: Any, *path: str) -> Optional[Any]:
+        cur = obj
+        for key in path:
+            if cur is None:
+                return None
+            if isinstance(cur, dict):
+                cur = cur.get(key)
+            else:
+                cur = getattr(cur, key, None)
+        return cur
+
+    channel_id = _get(activity, "channel_id") or _get(activity, "channelId")
+    conversation_id = _get(activity, "conversation", "id")
+    if not channel_id or not conversation_id:
+        raise ValueError("Activity must include channel_id and conversation.id")
+    return str(channel_id), str(conversation_id)
+
+
+def _to_plain_dict(activity: Activity) -> Dict[str, Any]:
+
+    if isinstance(activity, dict):
+        return activity
+    # Best-effort conversion for dataclass/attr/objects
+    try:
+        import dataclasses
+
+        if dataclasses.is_dataclass(activity):
+            return dataclasses.asdict(activity)  # type: ignore[arg-type]
+    except Exception:
+        pass
+    try:
+        return json.loads(
+            json.dumps(activity, default=lambda o: getattr(o, "__dict__", str(o)))
+        )
+    except Exception:
+        # Fallback: minimal projection
+        channel_id, conversation_id = _get_ids(activity)
+        return {
+            "type": getattr(activity, "type", "message"),
+            "id": getattr(activity, "id", None),
+            "channel_id": channel_id,
+            "conversation": {"id": conversation_id},
+            "text": getattr(activity, "text", None),
+        }
+
+
+def _utc_iso_now() -> str:
+    return datetime.now(timezone.utc).isoformat()

microsoft_agents/hosting/core/storage/transcript_logger.py

@@ -5,16 +5,28 @@ import random
 import string
 import json
 
+from typing import Any, Optional
 from abc import ABC, abstractmethod
 from datetime import datetime, timezone
 from queue import Queue
 from typing import Awaitable, Callable, List, Optional
+from dataclasses import dataclass
 
 from microsoft_agents.activity import Activity, ChannelAccount
 from microsoft_agents.activity.activity import ConversationReference
 from microsoft_agents.activity.activity_types import ActivityTypes
 from microsoft_agents.activity.conversation_reference import ActivityEventNames
 from microsoft_agents.hosting.core.middleware_set import Middleware, TurnContext
+from typing import Generic, TypeVar
+
+
+T = TypeVar("T")
+
+
+@dataclass
+class PagedResult(Generic[T]):
+    items: List[T]
+    continuation_token: Optional[str] = None
 
 
 class TranscriptLogger(ABC):

microsoft_agents/hosting/core/storage/transcript_memory_store.py

@@ -4,7 +4,7 @@
 from threading import Lock
 from datetime import datetime, timezone
 from typing import List
-from .transcript_logger import TranscriptLogger
+from .transcript_logger import TranscriptLogger, PagedResult
 from .transcript_info import TranscriptInfo
 from microsoft_agents.activity import Activity
 
@@ -52,7 +52,7 @@ class TranscriptMemoryStore(TranscriptLogger):
         conversation_id: str,
         continuation_token: str = None,
         start_date: datetime = datetime.min.replace(tzinfo=timezone.utc),
-    ) -> tuple[list[Activity], str]:
+    ) -> PagedResult[Activity]:
         """
         Retrieves activities for a given channel and conversation, optionally filtered by start_date.
 
@@ -60,7 +60,7 @@ class TranscriptMemoryStore(TranscriptLogger):
         :param conversation_id: The conversation ID to filter activities.
         :param continuation_token: (Unused) Token for pagination.
         :param start_date: Only activities with timestamp >= start_date are returned. None timestamps are treated as datetime.min.
-        :return: A tuple containing the filtered list of Activity objects and a continuation token (always None).
+        :return: A PagedResult containing the filtered list of Activity objects and a continuation token (always None).
         :raises ValueError: If channel_id or conversation_id is None.
         """
         if not channel_id:
@@ -98,7 +98,9 @@ class TranscriptMemoryStore(TranscriptLogger):
                 >= start_date
             ]
 
-            return filtered_sorted_activities, None
+            return PagedResult(
+                items=filtered_sorted_activities, continuation_token=None
+            )
 
     async def delete_transcript(self, channel_id: str, conversation_id: str) -> None:
         """
@@ -126,13 +128,13 @@ class TranscriptMemoryStore(TranscriptLogger):
 
     async def list_transcripts(
         self, channel_id: str, continuation_token: str = None
-    ) -> tuple[list[TranscriptInfo], str]:
+    ) -> PagedResult[TranscriptInfo]:
         """
         Lists all transcripts (unique conversation IDs) for a given channel.
 
         :param channel_id: The channel ID to list transcripts for.
         :param continuation_token: (Unused) Token for pagination.
-        :return: A tuple containing a list of TranscriptInfo objects and a continuation token (always None).
+        :return: A PagedResult containing a list of TranscriptInfo objects and a continuation token (always None).
         :raises ValueError: If channel_id is None.
         """
         if not channel_id:
@@ -151,4 +153,4 @@ class TranscriptMemoryStore(TranscriptLogger):
                 TranscriptInfo(channel_id=channel_id, conversation_id=conversation_id)
                 for conversation_id in conversations
             ]
-            return transcript_infos, None
+            return PagedResult(items=transcript_infos, continuation_token=None)

{microsoft_agents_hosting_core-0.4.0.dev14.dist-info → microsoft_agents_hosting_core-0.4.0.dev16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-core
-Version: 0.4.0.dev14
+Version: 0.4.0.dev16
 Summary: Core library for Microsoft Agents
 Author: Microsoft Corporation
 Project-URL: Homepage, https://github.com/microsoft/Agents
@@ -8,7 +8,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
-Requires-Dist: microsoft-agents-activity==0.4.0.dev14
+Requires-Dist: microsoft-agents-activity==0.4.0.dev16
 Requires-Dist: pyjwt>=2.10.1
 Requires-Dist: isodate>=0.6.1
 Requires-Dist: azure-core>=1.30.0

{microsoft_agents_hosting_core-0.4.0.dev14.dist-info → microsoft_agents_hosting_core-0.4.0.dev16.dist-info}/RECORD

@@ -4,11 +4,11 @@ microsoft_agents/hosting/core/agent.py,sha256=K8v84y8ULP7rbcMKg8LxaM3haAq7f1oHFC
 microsoft_agents/hosting/core/card_factory.py,sha256=UDmPEpOk2SpEr9ShN9Q0CiaI_GTD3qjHgkDMOWinW9I,6926
 microsoft_agents/hosting/core/channel_adapter.py,sha256=zEfQILXagYujO_dTsqvTbqdegeOW4qEHP8SdJb_IPEY,10088
 microsoft_agents/hosting/core/channel_api_handler_protocol.py,sha256=Nl4aOqpADWLAeIueI166TEmPwZX4XYnOiVGH9lzBuaY,4411
-microsoft_agents/hosting/core/channel_service_adapter.py,sha256=_OOgiatjpK70K7WMsx7x-VjEuizZgMyVYKMtTzfM2zs,17483
-microsoft_agents/hosting/core/channel_service_client_factory_base.py,sha256=n4K1jBEca2lW1bF0RS5MlA4FcA469HxqdhcyZNSiN_U,1465
+microsoft_agents/hosting/core/channel_service_adapter.py,sha256=UdJKZIcp0xR8oMDpQWhbdc6MtqBsU-gVcN7ksHZVbHY,17412
+microsoft_agents/hosting/core/channel_service_client_factory_base.py,sha256=UKYz8gCJmmwTRwCBle8O_dSGhflVsRRf2fPFZgYgzWo,1609
 microsoft_agents/hosting/core/message_factory.py,sha256=F9QJBF4yBupHXxOW984ZzZomVEG57t9IUnTHwub-lX0,7822
 microsoft_agents/hosting/core/middleware_set.py,sha256=TBsBs4KwAfKyHlQTlG4bl1y5UjkBzeMDs5w7LNB-Bi4,2585
-microsoft_agents/hosting/core/rest_channel_service_client_factory.py,sha256=JIl9wRQI2OEgdMA43_s4Y8RtdJwsJ2Q2uIH1-iZ745I,5025
+microsoft_agents/hosting/core/rest_channel_service_client_factory.py,sha256=TBdgg_5nsmH1Ouhpsb7bV4OzdS-jKQxb9t9j45PevP4,6122
 microsoft_agents/hosting/core/turn_context.py,sha256=df7TB1uXurgoAk338OF6taVfVgS58v662A9D9-GLP64,14794
 microsoft_agents/hosting/core/_oauth/__init__.py,sha256=7KvwQEiINtA6KFlpgOLWF0acxtkS4hu-qlqHlQWH7AI,310
 microsoft_agents/hosting/core/_oauth/_flow_state.py,sha256=WgvwVbEVsVb5ax75BleCVfGDs-Zw3beDZGlzW6jraCg,2185
@@ -68,7 +68,7 @@ microsoft_agents/hosting/core/connector/get_product_info.py,sha256=SDxPqBCzzQLEU
 microsoft_agents/hosting/core/connector/user_token_base.py,sha256=kEJxGMMl-RYzqDKqjwjQPvc-acih0cJo3hOEjmmom5I,1195
 microsoft_agents/hosting/core/connector/user_token_client_base.py,sha256=JTkbG70YXEnAQA_2yJn9dUGQ-hSCwNgU0C-V8y7kGEI,376
 microsoft_agents/hosting/core/connector/client/__init__.py,sha256=6JdKhmm7btmo0omxMBd8PJbtGFk0cnMwVUoStyW7Ft0,143
-microsoft_agents/hosting/core/connector/client/connector_client.py,sha256=o1sT5-mQVEgJta3HGAVmEE5GLOteCkzfjEZaCmEG6l0,22337
+microsoft_agents/hosting/core/connector/client/connector_client.py,sha256=kN9SFbZTReXHjfJji1mJsFmlmvSyaq3hI-bV09W32r8,23473
 microsoft_agents/hosting/core/connector/client/user_token_client.py,sha256=a6Y4pD8Ae-pEFA8FrXgb_mb0TzWjo81TMeDaRPqcGIw,10896
 microsoft_agents/hosting/core/connector/teams/__init__.py,sha256=3ZMPGYyZ15EwvfQzfJJQy1J58oIt4InSxibl3BN6R54,100
 microsoft_agents/hosting/core/connector/teams/teams_connector_client.py,sha256=XGQDTYHrA_I9n9JlxGST5eesjsFhz2dnSaMSuyoFnKU,12676
@@ -76,17 +76,18 @@ microsoft_agents/hosting/core/state/__init__.py,sha256=yckKi1wg_86ng-DL9Q3R49QiW
 microsoft_agents/hosting/core/state/agent_state.py,sha256=p6AoKSPNpPR6Ubw_APjrQ_KyaQ9AqRYS63n4HcmMnzs,13211
 microsoft_agents/hosting/core/state/state_property_accessor.py,sha256=kpiNnzkZ6el-oRITRbRkk1Faa_CPFxpJQdvSGxIJP70,1392
 microsoft_agents/hosting/core/state/user_state.py,sha256=zEigX-sroNAyoQAxQjG1OgmJQKjk1zOkdeqylFg7M2E,1484
-microsoft_agents/hosting/core/storage/__init__.py,sha256=X2jWX0qc2YdFNhwOct5Q7VJ9Q5VnOpKB0RqC7HG2_Qs,611
+microsoft_agents/hosting/core/storage/__init__.py,sha256=Df_clI0uMRgcr4Td-xkP83bU_mGae7_gRMhtVDPZDmE,729
 microsoft_agents/hosting/core/storage/_type_aliases.py,sha256=VCKtjiCBrhEsGSm3zVVSSccdoiY02GYhABvrLjhAcz8,72
 microsoft_agents/hosting/core/storage/error_handling.py,sha256=zH34d7s4pJG_uajpBWhrtTpH2eMy88kSKaqvOqtbgzY,1265
 microsoft_agents/hosting/core/storage/memory_storage.py,sha256=NADem1wQE1MOG1qMriYw4NjILHEBDbIG5HT6wvHfG2M,2353
 microsoft_agents/hosting/core/storage/storage.py,sha256=vft_Kw4pkzo8NnBEyDx7gAn1Ndg2I9ePaxnuxbKVHzs,3227
 microsoft_agents/hosting/core/storage/store_item.py,sha256=4LSkuI0H0lgWig88YoHFn6BP8Bx44YbyuvqBvaBNdEM,276
+microsoft_agents/hosting/core/storage/transcript_file_store.py,sha256=7-ngOW5AuVPEHiAZJeZe_a5Qn4lQxlAiexjAwPiOJJU,10112
 microsoft_agents/hosting/core/storage/transcript_info.py,sha256=5VN32j99tshChAffvuZ6D3GH3ABCZsQGHC_bYDAwFOk,328
-microsoft_agents/hosting/core/storage/transcript_logger.py,sha256=PxAZTZVFRC2q_i1JABo-JFOPEv9QyXCMe5wZdiiq6_g,8007
-microsoft_agents/hosting/core/storage/transcript_memory_store.py,sha256=xdX4CtyDczN5jCoi-ZtXzBZq52ahsk3IQ_Y6qkmub8U,6323
+microsoft_agents/hosting/core/storage/transcript_logger.py,sha256=_atDk3CJ05fIVMhlWGNa91IiM9bGLmOhasFko8Lxjhk,8237
+microsoft_agents/hosting/core/storage/transcript_memory_store.py,sha256=v1Ud9LSs8m5c9_Fa8i49SuAjw80dX1hDciqbRduDEOE,6444
 microsoft_agents/hosting/core/storage/transcript_store.py,sha256=ka74o0WvI5GhMZcFqSxVdamBhGzZcDZe6VNkG-sMy74,1944
-microsoft_agents_hosting_core-0.4.0.dev14.dist-info/METADATA,sha256=9YJpYQ6DRGc6APQll2KtKeM4t0pccibqAbKltcwtEXA,586
-microsoft_agents_hosting_core-0.4.0.dev14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-microsoft_agents_hosting_core-0.4.0.dev14.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
-microsoft_agents_hosting_core-0.4.0.dev14.dist-info/RECORD,,
+microsoft_agents_hosting_core-0.4.0.dev16.dist-info/METADATA,sha256=xGmh4XPcm_fgm2ehlFAy0l959WNGh8575S5zhiHADsI,586
+microsoft_agents_hosting_core-0.4.0.dev16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microsoft_agents_hosting_core-0.4.0.dev16.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
+microsoft_agents_hosting_core-0.4.0.dev16.dist-info/RECORD,,