microsoft-agents-hosting-core 0.6.0.dev8__py3-none-any.whl → 0.6.0.dev10__py3-none-any.whl

microsoft_agents/hosting/core/__init__.py

@@ -82,6 +82,9 @@ from .storage.store_item import StoreItem
 from .storage import Storage
 from .storage.memory_storage import MemoryStorage
 
+# Error Resources
+from .errors import error_resources, ErrorMessage, ErrorResources
+
 
 # Define the package's public interface
 __all__ = [
@@ -148,4 +151,7 @@ __all__ = [
     "MemoryStorage",
     "AgenticUserAuthorization",
     "Authorization",
+    "error_resources",
+    "ErrorMessage",
+    "ErrorResources",
 ]

microsoft_agents/hosting/core/errors/__init__.py

@@ -0,0 +1,17 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+"""
+Error resources for Microsoft Agents SDK.
+
+This module provides centralized error messages with error codes and help URLs
+following the pattern established in the C# SDK.
+"""
+
+from .error_message import ErrorMessage
+from .error_resources import ErrorResources
+
+# Singleton instance
+error_resources = ErrorResources()
+
+__all__ = ["ErrorMessage", "ErrorResources", "error_resources"]

microsoft_agents/hosting/core/errors/error_message.py

@@ -0,0 +1,68 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+"""
+ErrorMessage class for formatting error messages with error codes and help URLs.
+"""
+
+
+class ErrorMessage:
+    """
+    Represents a formatted error message with error code and help URL.
+
+    This class formats error messages according to the Microsoft Agents SDK pattern:
+    - Original error message
+    - Error Code: [negative number]
+    - Help URL: https://aka.ms/M365AgentsErrorCodes/#anchor
+    """
+
+    def __init__(
+        self,
+        message_template: str,
+        error_code: int,
+        help_url_anchor: str = "agentic-identity-with-the-m365-agents-sdk",
+    ):
+        """
+        Initialize an ErrorMessage.
+
+        :param message_template: The error message template (may include format placeholders)
+        :type message_template: str
+        :param error_code: The error code (should be negative)
+        :type error_code: int
+        :param help_url_anchor: The anchor for the help URL (defaults to agentic identity)
+        :type help_url_anchor: str
+        """
+        self.message_template = message_template
+        self.error_code = error_code
+        self.help_url_anchor = help_url_anchor
+        self.base_url = "https://aka.ms/M365AgentsErrorCodes"
+
+    def format(self, *args, **kwargs) -> str:
+        """
+        Format the error message with the provided arguments.
+
+        :param args: Positional arguments for string formatting
+        :param kwargs: Keyword arguments for string formatting
+        :return: Formatted error message with error code and help URL
+        :rtype: str
+        """
+        # Format the main message
+        if args or kwargs:
+            message = self.message_template.format(*args, **kwargs)
+        else:
+            message = self.message_template
+
+        # Append error code and help URL
+        return (
+            f"{message}\n\n"
+            f"Error Code: {self.error_code}\n"
+            f"Help URL: {self.base_url}/#{self.help_url_anchor}"
+        )
+
+    def __str__(self) -> str:
+        """Return the formatted error message without any arguments."""
+        return self.format()
+
+    def __repr__(self) -> str:
+        """Return a representation of the ErrorMessage."""
+        return f"ErrorMessage(code={self.error_code}, message='{self.message_template[:50]}...')"

microsoft_agents/hosting/core/errors/error_resources.py

@@ -0,0 +1,202 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+"""
+Hosting core error resources for Microsoft Agents SDK.
+
+This module contains error messages for hosting operations.
+Error codes are in the range -63000 to -63999 for hosting errors.
+General/validation errors are in the range -66000 to -66999.
+"""
+
+from .error_message import ErrorMessage
+
+
+class ErrorResources:
+    """
+    Error messages for hosting core operations.
+
+    Error codes are organized by range:
+    - -63000 to -63999: Hosting errors
+    - -66000 to -66999: General/validation errors
+    """
+
+    # Hosting Errors (-63000 to -63999)
+    AdapterRequired = ErrorMessage(
+        "start_agent_process: adapter can't be None",
+        -63000,
+        "hosting-configuration",
+    )
+
+    AgentApplicationRequired = ErrorMessage(
+        "start_agent_process: agent_application can't be None",
+        -63001,
+        "hosting-configuration",
+    )
+
+    RequestRequired = ErrorMessage(
+        "CloudAdapter.process: request can't be None",
+        -63002,
+        "hosting-configuration",
+    )
+
+    AgentRequired = ErrorMessage(
+        "CloudAdapter.process: agent can't be None",
+        -63003,
+        "hosting-configuration",
+    )
+
+    StreamAlreadyEnded = ErrorMessage(
+        "The stream has already ended.",
+        -63004,
+        "streaming",
+    )
+
+    TurnContextRequired = ErrorMessage(
+        "TurnContext cannot be None.",
+        -63005,
+        "hosting-configuration",
+    )
+
+    ActivityRequired = ErrorMessage(
+        "Activity cannot be None.",
+        -63006,
+        "hosting-configuration",
+    )
+
+    AppIdRequired = ErrorMessage(
+        "AppId cannot be empty or None.",
+        -63007,
+        "hosting-configuration",
+    )
+
+    InvalidActivityType = ErrorMessage(
+        "Invalid or missing activity type.",
+        -63008,
+        "hosting-configuration",
+    )
+
+    ConversationIdRequired = ErrorMessage(
+        "Conversation ID cannot be empty or None.",
+        -63009,
+        "hosting-configuration",
+    )
+
+    AuthHeaderRequired = ErrorMessage(
+        "Authorization header is required.",
+        -63010,
+        "hosting-configuration",
+    )
+
+    InvalidAuthHeader = ErrorMessage(
+        "Invalid authorization header format.",
+        -63011,
+        "hosting-configuration",
+    )
+
+    ClaimsIdentityRequired = ErrorMessage(
+        "ClaimsIdentity is required.",
+        -63012,
+        "hosting-configuration",
+    )
+
+    ChannelServiceRouteNotFound = ErrorMessage(
+        "Channel service route not found for: {0}",
+        -63013,
+        "hosting-configuration",
+    )
+
+    TokenExchangeRequired = ErrorMessage(
+        "Token exchange requires a token exchange resource.",
+        -63014,
+        "hosting-configuration",
+    )
+
+    MissingHttpClient = ErrorMessage(
+        "HTTP client is required.",
+        -63015,
+        "hosting-configuration",
+    )
+
+    InvalidBotFrameworkActivity = ErrorMessage(
+        "Invalid Bot Framework Activity format.",
+        -63016,
+        "hosting-configuration",
+    )
+
+    CredentialsRequired = ErrorMessage(
+        "Credentials are required for authentication.",
+        -63017,
+        "hosting-configuration",
+    )
+
+    # General/Validation Errors (-66000 to -66999)
+    InvalidConfiguration = ErrorMessage(
+        "Invalid configuration: {0}",
+        -66000,
+        "configuration",
+    )
+
+    RequiredParameterMissing = ErrorMessage(
+        "Required parameter missing: {0}",
+        -66001,
+        "configuration",
+    )
+
+    InvalidParameterValue = ErrorMessage(
+        "Invalid parameter value for {0}: {1}",
+        -66002,
+        "configuration",
+    )
+
+    OperationNotSupported = ErrorMessage(
+        "Operation not supported: {0}",
+        -66003,
+        "configuration",
+    )
+
+    ResourceNotFound = ErrorMessage(
+        "Resource not found: {0}",
+        -66004,
+        "configuration",
+    )
+
+    UnexpectedError = ErrorMessage(
+        "An unexpected error occurred: {0}",
+        -66005,
+        "configuration",
+    )
+
+    InvalidStateObject = ErrorMessage(
+        "Invalid state object: {0}",
+        -66006,
+        "configuration",
+    )
+
+    SerializationError = ErrorMessage(
+        "Serialization error: {0}",
+        -66007,
+        "configuration",
+    )
+
+    DeserializationError = ErrorMessage(
+        "Deserialization error: {0}",
+        -66008,
+        "configuration",
+    )
+
+    TimeoutError = ErrorMessage(
+        "Operation timed out: {0}",
+        -66009,
+        "configuration",
+    )
+
+    NetworkError = ErrorMessage(
+        "Network error occurred: {0}",
+        -66010,
+        "configuration",
+    )
+
+    def __init__(self):
+        """Initialize ErrorResources singleton."""
+        pass

{microsoft_agents_hosting_core-0.6.0.dev8.dist-info → microsoft_agents_hosting_core-0.6.0.dev10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-core
-Version: 0.6.0.dev8
+Version: 0.6.0.dev10
 Summary: Core library for Microsoft Agents
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,7 +15,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-activity==0.6.0.dev8
+Requires-Dist: microsoft-agents-activity==0.6.0.dev10
 Requires-Dist: pyjwt>=2.10.1
 Requires-Dist: isodate>=0.6.1
 Requires-Dist: azure-core>=1.30.0

{microsoft_agents_hosting_core-0.6.0.dev8.dist-info → microsoft_agents_hosting_core-0.6.0.dev10.dist-info}/RECORD

@@ -1,4 +1,4 @@
-microsoft_agents/hosting/core/__init__.py,sha256=EN6Et-e7n5n_nhXy5ZKNiRtjMfEgWkoNri_gk8KEYLw,4862
+microsoft_agents/hosting/core/__init__.py,sha256=jZ0551xg2RnMtHpAMD1AtXyDh0oPUSDYPe_S9QNdbtA,5012
 microsoft_agents/hosting/core/activity_handler.py,sha256=1hsSmVCnQLS44RK05v8j6mlmV38_JGmJTPR9LkogQuc,27779
 microsoft_agents/hosting/core/agent.py,sha256=K8v84y8ULP7rbcMKg8LxaM3haAq7f1oHFCLy3AAphQE,574
 microsoft_agents/hosting/core/card_factory.py,sha256=UDmPEpOk2SpEr9ShN9Q0CiaI_GTD3qjHgkDMOWinW9I,6926
@@ -76,6 +76,9 @@ microsoft_agents/hosting/core/connector/client/connector_client.py,sha256=9oF_x_
 microsoft_agents/hosting/core/connector/client/user_token_client.py,sha256=qxYxvdUcvYinCzaR4YiIucEEAb8TjYYtPsmXKZRbxv4,10536
 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
+microsoft_agents/hosting/core/errors/__init__.py,sha256=2BiNgN84UxPl1Q1kZuQ_a36S7sIwvHE4H6MTmgp6cCk,481
+microsoft_agents/hosting/core/errors/error_message.py,sha256=CPpzP-wkU6z8yz-d_hC0YyRriBQAyVqXczXPkDf95oo,2350
+microsoft_agents/hosting/core/errors/error_resources.py,sha256=ar1YoU65eH1OJnE_n6J2YG23UjO-a0cuY4XSUzzK_kU,4761
 microsoft_agents/hosting/core/state/__init__.py,sha256=yckKi1wg_86ng-DL9Q3R49QiWKvNjPkVNk6HClWgVrY,208
 microsoft_agents/hosting/core/state/agent_state.py,sha256=uboptWaC3VrSGTnXIzaO38XUqOT-ITW6EhJxuGMtKWs,13724
 microsoft_agents/hosting/core/state/state_property_accessor.py,sha256=kpiNnzkZ6el-oRITRbRkk1Faa_CPFxpJQdvSGxIJP70,1392
@@ -91,8 +94,8 @@ microsoft_agents/hosting/core/storage/transcript_info.py,sha256=5VN32j99tshChAff
 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.6.0.dev8.dist-info/licenses/LICENSE,sha256=ws_MuBL-SCEBqPBFl9_FqZkaaydIJmxHrJG2parhU4M,1141
-microsoft_agents_hosting_core-0.6.0.dev8.dist-info/METADATA,sha256=knnVIH8NGvVcCJvdg4ZwO-_ePNZe31XYplXWIIvQKD4,9242
-microsoft_agents_hosting_core-0.6.0.dev8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-microsoft_agents_hosting_core-0.6.0.dev8.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
-microsoft_agents_hosting_core-0.6.0.dev8.dist-info/RECORD,,
+microsoft_agents_hosting_core-0.6.0.dev10.dist-info/licenses/LICENSE,sha256=ws_MuBL-SCEBqPBFl9_FqZkaaydIJmxHrJG2parhU4M,1141
+microsoft_agents_hosting_core-0.6.0.dev10.dist-info/METADATA,sha256=bE1qzB2ZWcgIf-dJojy8Y3e4nImcPJQH1mBW9xvwUl4,9244
+microsoft_agents_hosting_core-0.6.0.dev10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microsoft_agents_hosting_core-0.6.0.dev10.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
+microsoft_agents_hosting_core-0.6.0.dev10.dist-info/RECORD,,