microsoft-agents-hosting-core 0.6.0.dev9__tar.gz → 0.6.0.dev11__tar.gz

{microsoft_agents_hosting_core-0.6.0.dev9 → microsoft_agents_hosting_core-0.6.0.dev11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-core
-Version: 0.6.0.dev9
+Version: 0.6.0.dev11
 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.dev9
+Requires-Dist: microsoft-agents-activity==0.6.0.dev11
 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.dev9 → microsoft_agents_hosting_core-0.6.0.dev11}/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-0.6.0.dev11/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-0.6.0.dev11/microsoft_agents/hosting/core/errors/error_message.py

@@ -0,0 +1,64 @@
+# 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/#[error_code]
+    """
+
+    def __init__(
+        self,
+        message_template: str,
+        error_code: int,
+    ):
+        """
+        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
+        """
+        self.message_template = message_template
+        self.error_code = error_code
+        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.error_code}"
+        )
+
+    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-0.6.0.dev11/microsoft_agents/hosting/core/errors/error_resources.py

@@ -0,0 +1,173 @@
+# 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,
+    )
+
+    AgentApplicationRequired = ErrorMessage(
+        "start_agent_process: agent_application can't be None",
+        -63001,
+    )
+
+    RequestRequired = ErrorMessage(
+        "CloudAdapter.process: request can't be None",
+        -63002,
+    )
+
+    AgentRequired = ErrorMessage(
+        "CloudAdapter.process: agent can't be None",
+        -63003,
+    )
+
+    StreamAlreadyEnded = ErrorMessage(
+        "The stream has already ended.",
+        -63004,
+    )
+
+    TurnContextRequired = ErrorMessage(
+        "TurnContext cannot be None.",
+        -63005,
+    )
+
+    ActivityRequired = ErrorMessage(
+        "Activity cannot be None.",
+        -63006,
+    )
+
+    AppIdRequired = ErrorMessage(
+        "AppId cannot be empty or None.",
+        -63007,
+    )
+
+    InvalidActivityType = ErrorMessage(
+        "Invalid or missing activity type.",
+        -63008,
+    )
+
+    ConversationIdRequired = ErrorMessage(
+        "Conversation ID cannot be empty or None.",
+        -63009,
+    )
+
+    AuthHeaderRequired = ErrorMessage(
+        "Authorization header is required.",
+        -63010,
+    )
+
+    InvalidAuthHeader = ErrorMessage(
+        "Invalid authorization header format.",
+        -63011,
+    )
+
+    ClaimsIdentityRequired = ErrorMessage(
+        "ClaimsIdentity is required.",
+        -63012,
+    )
+
+    ChannelServiceRouteNotFound = ErrorMessage(
+        "Channel service route not found for: {0}",
+        -63013,
+    )
+
+    TokenExchangeRequired = ErrorMessage(
+        "Token exchange requires a token exchange resource.",
+        -63014,
+    )
+
+    MissingHttpClient = ErrorMessage(
+        "HTTP client is required.",
+        -63015,
+    )
+
+    InvalidBotFrameworkActivity = ErrorMessage(
+        "Invalid Bot Framework Activity format.",
+        -63016,
+    )
+
+    CredentialsRequired = ErrorMessage(
+        "Credentials are required for authentication.",
+        -63017,
+    )
+
+    # General/Validation Errors (-66000 to -66999)
+    InvalidConfiguration = ErrorMessage(
+        "Invalid configuration: {0}",
+        -66000,
+    )
+
+    RequiredParameterMissing = ErrorMessage(
+        "Required parameter missing: {0}",
+        -66001,
+    )
+
+    InvalidParameterValue = ErrorMessage(
+        "Invalid parameter value for {0}: {1}",
+        -66002,
+    )
+
+    OperationNotSupported = ErrorMessage(
+        "Operation not supported: {0}",
+        -66003,
+    )
+
+    ResourceNotFound = ErrorMessage(
+        "Resource not found: {0}",
+        -66004,
+    )
+
+    UnexpectedError = ErrorMessage(
+        "An unexpected error occurred: {0}",
+        -66005,
+    )
+
+    InvalidStateObject = ErrorMessage(
+        "Invalid state object: {0}",
+        -66006,
+    )
+
+    SerializationError = ErrorMessage(
+        "Serialization error: {0}",
+        -66007,
+    )
+
+    DeserializationError = ErrorMessage(
+        "Deserialization error: {0}",
+        -66008,
+    )
+
+    TimeoutError = ErrorMessage(
+        "Operation timed out: {0}",
+        -66009,
+    )
+
+    NetworkError = ErrorMessage(
+        "Network error occurred: {0}",
+        -66010,
+    )
+
+    def __init__(self):
+        """Initialize ErrorResources singleton."""
+        pass

{microsoft_agents_hosting_core-0.6.0.dev9 → microsoft_agents_hosting_core-0.6.0.dev11}/microsoft_agents_hosting_core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-core
-Version: 0.6.0.dev9
+Version: 0.6.0.dev11
 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.dev9
+Requires-Dist: microsoft-agents-activity==0.6.0.dev11
 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.dev9 → microsoft_agents_hosting_core-0.6.0.dev11}/microsoft_agents_hosting_core.egg-info/SOURCES.txt

@@ -80,6 +80,9 @@ microsoft_agents/hosting/core/connector/client/connector_client.py
 microsoft_agents/hosting/core/connector/client/user_token_client.py
 microsoft_agents/hosting/core/connector/teams/__init__.py
 microsoft_agents/hosting/core/connector/teams/teams_connector_client.py
+microsoft_agents/hosting/core/errors/__init__.py
+microsoft_agents/hosting/core/errors/error_message.py
+microsoft_agents/hosting/core/errors/error_resources.py
 microsoft_agents/hosting/core/state/__init__.py
 microsoft_agents/hosting/core/state/agent_state.py
 microsoft_agents/hosting/core/state/state_property_accessor.py

{microsoft_agents_hosting_core-0.6.0.dev9 → microsoft_agents_hosting_core-0.6.0.dev11}/microsoft_agents_hosting_core.egg-info/requires.txt

@@ -1,4 +1,4 @@
-microsoft-agents-activity==0.6.0.dev9
+microsoft-agents-activity==0.6.0.dev11
 pyjwt>=2.10.1
 isodate>=0.6.1
 azure-core>=1.30.0