microsoft-agents-activity 0.0.0__py3-none-any.whl

microsoft/agents/activity/teams/task_module_response_base.py

@@ -0,0 +1,17 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from pydantic import ConfigDict
+from ..agents_model import AgentsModel
+
+
+class TaskModuleResponseBase(AgentsModel):
+    """Base class for task module responses.
+
+    :param type: The type of response.
+    :type type: str
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    type: str = None

microsoft/agents/activity/teams/task_module_task_info.py

@@ -0,0 +1,30 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+from ..attachment import Attachment
+
+
+class TaskModuleTaskInfo(AgentsModel):
+    """Information about a task module task.
+
+    :param title: The title of the task module.
+    :type title: str
+    :param height: The height of the task module.
+    :type height: int
+    :param width: The width of the task module.
+    :type width: int
+    :param url: The URL of the task module.
+    :type url: str
+    :param card: The adaptive card for the task module.
+    :type card: object
+    """
+
+    title: str = None
+    height: object = None
+    width: object = None
+    url: str = None
+    card: Attachment = None
+    fallback_url: str = None
+    completion_bot_id: str = None

microsoft/agents/activity/teams/team_details.py

@@ -0,0 +1,29 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+
+class TeamDetails(AgentsModel):
+    """Details related to a team.
+
+    :param id: Unique identifier representing a team
+    :type id: str
+    :param name: Name of team.
+    :type name: str
+    :param aad_group_id: Azure Active Directory (AAD) Group Id for the team.
+    :type aad_group_id: str
+    :param channel_count: The count of channels in the team.
+    :type channel_count: int
+    :param member_count: The count of members in the team.
+    :type member_count: int
+    :param type: The team type
+    :type type: str
+    """
+
+    id: str = None
+    name: str = None
+    aad_group_id: str = None
+    channel_count: int = None
+    member_count: int = None
+    type: str = None

microsoft/agents/activity/teams/team_info.py

@@ -0,0 +1,20 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+
+class TeamInfo(AgentsModel):
+    """Describes a team.
+
+    :param id: Unique identifier representing a team
+    :type id: str
+    :param name: Name of team.
+    :type name: str
+    :param aad_group_id: Azure AD Teams group ID.
+    :type aad_group_id: str
+    """
+
+    id: str = None
+    name: str = None
+    aad_group_id: str = None

microsoft/agents/activity/teams/teams_batch_operation_response.py

@@ -0,0 +1,19 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .batch_operation_response import BatchOperationResponse
+
+
+class TeamsBatchOperationResponse(BatchOperationResponse):
+    """
+    :param operation_id: Unique identifier of the batch operation.
+    :type operation_id: str
+    :param body_as_text: The body of the request as text.
+    :type body_as_text: str
+    :param parsed_body: The parsed body of the request.
+    :type parsed_body: BatchOperationResponse
+    """
+
+    operation_id: str = None
+    body_as_text: str = None
+    parsed_body: BatchOperationResponse = None

microsoft/agents/activity/teams/teams_channel_account.py

@@ -0,0 +1,44 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from typing import Any
+from pydantic import ConfigDict
+from ..agents_model import AgentsModel
+
+
+class TeamsChannelAccount(AgentsModel):
+    """Teams channel account detailing user Azure Active Directory details.
+
+    :param id: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
+    :type id: str
+    :param name: Display friendly name
+    :type name: str
+    :param given_name: Given name part of the user name.
+    :type given_name: str
+    :param surname: Surname part of the user name.
+    :type surname: str
+    :param email: Email Id of the user.
+    :type email: str
+    :param user_principal_name: Unique user principal name.
+    :type user_principal_name: str
+    :param tenant_id: Tenant Id of the user.
+    :type tenant_id: str
+    :param user_role: User Role of the user.
+    :type user_role: str
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str = None
+    name: str = None
+    given_name: str = None
+    surname: str = None
+    email: str = None
+    user_principal_name: str = None
+    tenant_id: str = None
+    user_role: str = None
+
+    @property
+    def properties(self) -> dict[str, Any]:
+        """Returns the set of properties that are not None."""
+        return self.model_extra

microsoft/agents/activity/teams/teams_channel_data.py

@@ -0,0 +1,43 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+from typing import List
+from .channel_info import ChannelInfo
+from .team_info import TeamInfo
+from .notification_info import NotificationInfo
+from .tenant_info import TenantInfo
+from .teams_meeting_info import TeamsMeetingInfo
+from .teams_channel_data_settings import TeamsChannelDataSettings
+from .on_behalf_of import OnBehalfOf
+
+
+class TeamsChannelData(AgentsModel):
+    """Channel data specific to messages received in Microsoft Teams.
+
+    :param channel: Information about the channel in which the message was sent
+    :type channel: ChannelInfo
+    :param event_type: Type of event.
+    :type event_type: str
+    :param team: Information about the team in which the message was sent
+    :type team: TeamInfo
+    :param notification: Notification settings for the message
+    :type notification: NotificationInfo
+    :param tenant: Information about the tenant in which the message was sent
+    :type tenant: TenantInfo
+    :param meeting: Information about the meeting in which the message was sent
+    :type meeting: TeamsMeetingInfo
+    :param settings: Information about the settings in which the message was sent
+    :type settings: TeamsChannelDataSettings
+    :param on_behalf_of: The OnBehalfOf list for user attribution
+    :type on_behalf_of: List[OnBehalfOf]
+    """
+
+    channel: ChannelInfo = None
+    event_type: str = None
+    team: TeamInfo = None
+    notification: NotificationInfo = None
+    tenant: TenantInfo = None
+    meeting: TeamsMeetingInfo = None
+    settings: TeamsChannelDataSettings = None
+    on_behalf_of: List[OnBehalfOf] = None

microsoft/agents/activity/teams/teams_channel_data_settings.py

@@ -0,0 +1,15 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+from .channel_info import ChannelInfo
+
+
+class TeamsChannelDataSettings(AgentsModel):
+    """Represents the settings information for a Teams channel data.
+
+    :param selected_channel: Information about the selected Teams channel.
+    :type selected_channel: ChannelInfo
+    """
+
+    selected_channel: ChannelInfo = None

microsoft/agents/activity/teams/teams_meeting_info.py

@@ -0,0 +1,14 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+
+class TeamsMeetingInfo(AgentsModel):
+    """Describes a Teams Meeting.
+
+    :param id: Unique identifier representing a meeting
+    :type id: str
+    """
+
+    id: str = None

microsoft/agents/activity/teams/teams_meeting_member.py

@@ -0,0 +1,19 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+from .teams_channel_account import TeamsChannelAccount
+from .user_meeting_details import UserMeetingDetails
+
+
+class TeamsMeetingMember(AgentsModel):
+    """Data about the meeting participants.
+
+    :param user: The channel user data.
+    :type user: TeamsChannelAccount
+    :param meeting: The user meeting details.
+    :type meeting: UserMeetingDetails
+    """
+
+    user: TeamsChannelAccount = None
+    meeting: UserMeetingDetails = None

microsoft/agents/activity/teams/teams_meeting_participant.py

@@ -0,0 +1,24 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+from .teams_channel_account import TeamsChannelAccount
+from .meeting_participant_info import MeetingParticipantInfo
+from ..conversation_account import ConversationAccount
+
+
+class TeamsMeetingParticipant(AgentsModel):
+    """Teams participant channel account detailing user Azure Active Directory and meeting participant details.
+
+    :param user: Teams Channel Account information for this meeting participant
+    :type user: TeamsChannelAccount
+    :param meeting: Information specific to this participant in the specific meeting.
+    :type meeting: MeetingParticipantInfo
+    :param conversation: Conversation Account for the meeting.
+    :type conversation: ConversationAccount
+    """
+
+    user: TeamsChannelAccount = None
+    meeting: MeetingParticipantInfo = None
+    conversation: ConversationAccount = None

microsoft/agents/activity/teams/teams_member.py

@@ -0,0 +1,14 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+
+class TeamsMember(AgentsModel):
+    """Describes a member.
+
+    :param id: Unique identifier representing a member (user or channel).
+    :type id: str
+    """
+
+    id: str = None

microsoft/agents/activity/teams/teams_paged_members_result.py

@@ -0,0 +1,19 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+from typing import List
+from .teams_channel_account import TeamsChannelAccount
+
+
+class TeamsPagedMembersResult(AgentsModel):
+    """Page of members for Teams.
+
+    :param continuation_token: Paging token
+    :type continuation_token: str
+    :param members: The Teams Channel Accounts.
+    :type members: list[TeamsChannelAccount]
+    """
+
+    continuation_token: str = None
+    members: List[TeamsChannelAccount] = None

microsoft/agents/activity/teams/tenant_info.py

@@ -0,0 +1,14 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+
+class TenantInfo(AgentsModel):
+    """Describes a tenant.
+
+    :param id: Unique identifier representing a tenant
+    :type id: str
+    """
+
+    id: str = None

microsoft/agents/activity/teams/user_meeting_details.py

@@ -0,0 +1,17 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ..agents_model import AgentsModel
+
+
+class UserMeetingDetails(AgentsModel):
+    """Specific details of a user in a Teams meeting.
+
+    :param role: Role of the participant in the current meeting.
+    :type role: str
+    :param in_meeting: True, if the participant is in the meeting.
+    :type in_meeting: bool
+    """
+
+    role: str = None
+    in_meeting: bool = None

microsoft/agents/activity/text_format_types.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class TextFormatTypes(str, Enum):
+    markdown = "markdown"
+    plain = "plain"
+    xml = "xml"

microsoft/agents/activity/text_highlight.py

@@ -0,0 +1,16 @@
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class TextHighlight(AgentsModel):
+    """Refers to a substring of content within another field.
+
+    :param text: Defines the snippet of text to highlight
+    :type text: str
+    :param occurrence: Occurrence of the text field within the referenced
+     text, if multiple exist.
+    :type occurrence: int
+    """
+
+    text: NonEmptyString
+    occurrence: int

microsoft/agents/activity/thing.py

@@ -0,0 +1,15 @@
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class Thing(AgentsModel):
+    """Thing (entity type: "https://schema.org/Thing").
+
+    :param type: The type of the thing
+    :type type: str
+    :param name: The name of the thing
+    :type name: str
+    """
+
+    type: NonEmptyString = None
+    name: NonEmptyString = None

microsoft/agents/activity/thumbnail_card.py

@@ -0,0 +1,30 @@
+from .card_image import CardImage
+from .card_action import CardAction
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class ThumbnailCard(AgentsModel):
+    """A thumbnail card (card with a single, small thumbnail image).
+
+    :param title: Title of the card
+    :type title: str
+    :param subtitle: Subtitle of the card
+    :type subtitle: str
+    :param text: Text for the card
+    :type text: str
+    :param images: Array of images for the card
+    :type images: list[~microsoft.agents.protocols.models.CardImage]
+    :param buttons: Set of actions applicable to the current card
+    :type buttons: list[~microsoft.agents.protocols.models.CardAction]
+    :param tap: This action will be activated when user taps on the card
+     itself
+    :type tap: ~microsoft.agents.protocols.models.CardAction
+    """
+
+    title: NonEmptyString = None
+    subtitle: NonEmptyString = None
+    text: NonEmptyString = None
+    images: list[CardImage] = None
+    buttons: list[CardAction] = None
+    tap: CardAction = None

microsoft/agents/activity/thumbnail_url.py

@@ -0,0 +1,15 @@
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class ThumbnailUrl(AgentsModel):
+    """Thumbnail URL.
+
+    :param url: URL pointing to the thumbnail to use for media content
+    :type url: str
+    :param alt: HTML alt text to include on this thumbnail image
+    :type alt: str
+    """
+
+    url: NonEmptyString = None
+    alt: NonEmptyString = None

microsoft/agents/activity/token_exchange_invoke_request.py

@@ -0,0 +1,21 @@
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class TokenExchangeInvokeRequest(AgentsModel):
+    """TokenExchangeInvokeRequest.
+
+    :param id: The id from the OAuthCard.
+    :type id: str
+    :param connection_name: The connection name.
+    :type connection_name: str
+    :param token: The user token that can be exchanged.
+    :type token: str
+    :param properties: Extension data for overflow of properties.
+    :type properties: dict[str, object]
+    """
+
+    id: NonEmptyString = None
+    connection_name: NonEmptyString = None
+    token: NonEmptyString = None
+    properties: dict = None

microsoft/agents/activity/token_exchange_invoke_response.py

@@ -0,0 +1,21 @@
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class TokenExchangeInvokeResponse(AgentsModel):
+    """TokenExchangeInvokeResponse.
+
+    :param id: The id from the OAuthCard.
+    :type id: str
+    :param connection_name: The connection name.
+    :type connection_name: str
+    :param failure_detail: The details of why the token exchange failed.
+    :type failure_detail: str
+    :param properties: Extension data for overflow of properties.
+    :type properties: dict[str, object]
+    """
+
+    id: NonEmptyString = None
+    connection_name: NonEmptyString = None
+    failure_detail: NonEmptyString = None
+    properties: dict = None

microsoft/agents/activity/token_exchange_resource.py

@@ -0,0 +1,13 @@
+from .agents_model import AgentsModel
+
+from ._type_aliases import NonEmptyString
+
+
+class TokenExchangeResource(AgentsModel):
+    """
+    A type containing information for token exchange.
+    """
+
+    id: NonEmptyString = None
+    uri: NonEmptyString = None
+    provider_id: NonEmptyString = None

microsoft/agents/activity/token_exchange_state.py

@@ -0,0 +1,38 @@
+import base64
+import json
+from typing import Optional
+from pydantic import Field
+
+from .conversation_reference import ConversationReference
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class TokenExchangeState(AgentsModel):
+    """TokenExchangeState
+
+    :param connection_name: The connection name that was used.
+    :type connection_name: str
+    :param conversation: Gets or sets a reference to the conversation.
+    :type conversation: ~microsoft.agents.protocols.models.ConversationReference
+    :param relates_to: Gets or sets a reference to a related parent conversation for this token exchange.
+    :type relates_to: ~microsoft.agents.protocols.models.ConversationReference
+    :param agent_url: The URL of the agent messaging endpoint.
+    :type agent_url: str
+    :param ms_app_id: The agent's registered application ID.
+    :type ms_app_id: str
+    """
+
+    connection_name: NonEmptyString = None
+    conversation: ConversationReference = None
+    relates_to: Optional[ConversationReference] = None
+    agent_url: NonEmptyString = Field(None, alias="bot_url")
+    ms_app_id: NonEmptyString = None
+
+    def get_encoded_state(self) -> str:
+        """Returns the encoded state for the token exchange."""
+        return base64.b64encode(
+            json.dumps(
+                self.model_dump(by_alias=True, exclude_none=True, exclude_unset=True)
+            ).encode(encoding="UTF-8", errors="strict")
+        ).decode()

microsoft/agents/activity/token_post_resource.py

@@ -0,0 +1,11 @@
+from .agents_model import AgentsModel
+
+from ._type_aliases import NonEmptyString
+
+
+class TokenPostResource(AgentsModel):
+    """
+    A type containing information for token posting.
+    """
+
+    sas_url: NonEmptyString = None

microsoft/agents/activity/token_request.py

@@ -0,0 +1,16 @@
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class TokenRequest(AgentsModel):
+    """A request to receive a user token.
+
+    :param provider: The provider to request a user token from
+    :type provider: str
+    :param settings: A collection of settings for the specific provider for
+     this request
+    :type settings: dict[str, object]
+    """
+
+    provider: NonEmptyString = None
+    settings: dict = None

microsoft/agents/activity/token_response.py

@@ -0,0 +1,25 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class TokenResponse(AgentsModel):
+    """A response that includes a user token.
+
+    :param connection_name: The connection name
+    :type connection_name: str
+    :param token: The user token
+    :type token: str
+    :param expiration: Expiration for the token, in ISO 8601 format (e.g.
+     "2007-04-05T14:30Z")
+    :type expiration: str
+    :param channel_id: The channelId of the TokenResponse
+    :type channel_id: str
+    """
+
+    connection_name: NonEmptyString = None
+    token: NonEmptyString = None
+    expiration: NonEmptyString = None
+    channel_id: NonEmptyString = None

microsoft/agents/activity/token_status.py

@@ -0,0 +1,32 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+"""Models for token status operations."""
+
+from typing import Optional
+from pydantic import Field
+
+from .agents_model import AgentsModel
+from ._type_aliases import NonEmptyString
+
+
+class TokenStatus(AgentsModel):
+    """
+    The status of a user token.
+
+    :param channel_id: The channelId of the token status pertains to.
+    :type channel_id: str
+    :param connection_name: The name of the connection the token status pertains to.
+    :type connection_name: str
+    :param has_token: True if a token is stored for this ConnectionName.
+    :type has_token: bool
+    :param service_provider_display_name: The display name of the service provider for which this Token belongs to.
+    :type service_provider_display_name: str
+    """
+
+    channel_id: Optional[NonEmptyString] = Field(None, alias="channelId")
+    connection_name: Optional[NonEmptyString] = Field(None, alias="connectionName")
+    has_token: Optional[bool] = Field(None, alias="hasToken")
+    service_provider_display_name: Optional[NonEmptyString] = Field(
+        None, alias="serviceProviderDisplayName"
+    )

microsoft/agents/activity/transcript.py

@@ -0,0 +1,13 @@
+from .activity import Activity
+from .agents_model import AgentsModel
+
+
+class Transcript(AgentsModel):
+    """Transcript.
+
+    :param activities: A collection of Activities that conforms to the
+     Transcript schema.
+    :type activities: list[~microsoft.agents.protocols.models.Activity]
+    """
+
+    activities: list[Activity] = None