microsoft · axelsrz · Apr 29, 2019 · Apr 12, 2019 · Apr 14, 2019 · Apr 15, 2019
diff --git a/libraries/botbuilder-ai/botbuilder/ai/__init__.py b/libraries/botbuilder-ai/botbuilder/ai/__init__.py
@@ -0,0 +1,6 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .about import __title__, __version__
+
+__all__ = ["__title__", "__version__"]
diff --git a/libraries/botbuilder-ai/botbuilder/ai/about.py b/libraries/botbuilder-ai/botbuilder/ai/about.py
@@ -0,0 +1,12 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+import os
+
+__title__ = 'botbuilder-ai'
+__version__ = os.environ["packageVersion"] if "packageVersion" in os.environ else "4.0.0.a6"
+__uri__ = 'https://www.github.com/Microsoft/botbuilder-python'
+__author__ = 'Microsoft'
+__description__ = 'Microsoft Bot Framework Bot Builder'
+__summary__ = 'Microsoft Bot Framework Bot Builder SDK for Python.'
+__license__ = 'MIT'
diff --git a/libraries/botbuilder-ai/botbuilder/ai/luis/__init__.py b/libraries/botbuilder-ai/botbuilder/ai/luis/__init__.py
@@ -0,0 +1,19 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .intent_score import IntentScore
+from .luis_application import LuisApplication
+from .luis_prediction_options import LuisPredictionOptions
+from .luis_telemetry_constants import LuisTelemetryConstants
+from .recognizer_result import RecognizerResult, TopIntent
+from .luis_recognizer import LuisRecognizer
+
+__all__ = [
+    "IntentScore",
+    "LuisApplication",
+    "LuisPredictionOptions",
+    "LuisRecognizer",
+    "LuisTelemetryConstants",
+    "RecognizerResult",
+    "TopIntent",
+]
diff --git a/libraries/botbuilder-ai/botbuilder/ai/luis/activity_util.py b/libraries/botbuilder-ai/botbuilder/ai/luis/activity_util.py
@@ -0,0 +1,69 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from datetime import datetime
+
+from botbuilder.schema import (
+    Activity,
+    ActivityTypes,
+    ChannelAccount,
+    ConversationAccount,
+)
+
+
+class ActivityUtil(object):
+    @staticmethod
+    def create_trace(
+        turn_activity: Activity,
+        name: str,
+        value: object = None,
+        value_type: str = None,
+        label: str = None,
+    ) -> Activity:
+        """Creates a trace activity based on this activity.
+
+        :param turn_activity:
+        :type turn_activity: Activity
+        :param name: The value to assign to the trace activity's <see cref="Activity.name"/> property.
+        :type name: str
+        :param value: The value to assign to the trace activity's <see cref="Activity.value"/> property., defaults to None
+        :param value: object, optional
+        :param value_type: The value to assign to the trace activity's <see cref="Activity.value_type"/> property, defaults to None
+        :param value_type: str, optional
+        :param label: The value to assign to the trace activity's <see cref="Activity.label"/> property, defaults to None
+        :param label: str, optional
+        :return: The created trace activity.
+        :rtype: Activity
+        """
+
+        from_property = (
+            ChannelAccount(
+                id=turn_activity.recipient.id, name=turn_activity.recipient.name
+            )
+            if turn_activity.recipient is not None
+            else ChannelAccount()
+        )
+        if value_type is None and value is not None:
+            value_type = type(value).__name__
+
+        reply = Activity(
+            type=ActivityTypes.trace,
+            timestamp=datetime.utcnow(),
+            from_property=from_property,
+            recipient=ChannelAccount(
+                id=turn_activity.from_property.id, name=turn_activity.from_property.name
+            ),
+            reply_to_id=turn_activity.id,
+            service_url=turn_activity.service_url,
+            channel_id=turn_activity.channel_id,
+            conversation=ConversationAccount(
+                is_group=turn_activity.conversation.is_group,
+                id=turn_activity.conversation.id,
+                name=turn_activity.conversation.name,
+            ),
+            name=name,
+            label=label,
+            value_type=value_type,
+            value=value,
+        )
+        return reply
diff --git a/libraries/botbuilder-ai/botbuilder/ai/luis/intent_score.py b/libraries/botbuilder-ai/botbuilder/ai/luis/intent_score.py
@@ -0,0 +1,58 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from typing import Dict
+
+
+class IntentScore(object):
+    """
+    Score plus any extra information about an intent.
+    """
+
+    def __init__(self, score: float = None, properties: Dict[str, object] = {}):
+        self._score: float = score
+        self._properties: Dict[str, object] = properties
+
+    @property
+    def score(self) -> float:
+        """Gets confidence in an intent.
+
+        :return: Confidence in an intent.
+        :rtype: float
+        """
+
+        return self._score
+
+    @score.setter
+    def score(self, value: float) -> None:
+        """Sets confidence in an intent.
+
+        :param value: Confidence in an intent.
+        :type value: float
+        :return:
+        :rtype: None
+        """
+
+        self._score = value
+
+    @property
+    def properties(self) -> Dict[str, object]:
+        """Gets any extra properties to include in the results.
+
+        :return: Any extra properties to include in the results.
+        :rtype: Dict[str, object]
+        """
+
+        return self._properties
+
+    @properties.setter
+    def properties(self, value: Dict[str, object]) -> None:
+        """Sets any extra properties to include in the results.
+
+        :param value: Any extra properties to include in the results.
+        :type value: Dict[str, object]
+        :return:
+        :rtype: None
+        """
+
+        self._properties = value
diff --git a/libraries/botbuilder-ai/botbuilder/ai/luis/luis_application.py b/libraries/botbuilder-ai/botbuilder/ai/luis/luis_application.py
@@ -0,0 +1,160 @@
+# Copyright (c) Microsoft. All rights reserved.
+# Licensed under the MIT license.
+
+from pathlib import PurePosixPath
+from typing import Tuple
+from urllib.parse import ParseResult, parse_qs, unquote, urlparse, urlunparse
+from uuid import UUID, uuid4
+
+
+class LuisApplication(object):
+    """
+    Data describing a LUIS application.
+    """
+
+    def __init__(self, application_id: str, endpoint_key: str, endpoint: str):
+        """Initializes a new instance of the <see cref="LuisApplication"/> class.
+
+        :param application_id: LUIS application ID.
+        :type application_id: str
+        :param endpoint_key: LUIS subscription or endpoint key.
+        :type endpoint_key: str
+        :param endpoint: LUIS endpoint to use like https://westus.api.cognitive.microsoft.com.
+        :type endpoint: str
+        :raises ValueError: 
+        :raises ValueError:
+        :raises ValueError:
+        """
+
+        _, valid = LuisApplication._try_parse_uuid4(application_id)
+        if not valid:
+            raise ValueError(f'"{application_id}" is not a valid LUIS application id.')
+
+        _, valid = LuisApplication._try_parse_uuid4(endpoint_key)
+        if not valid:
+            raise ValueError(f'"{endpoint_key}" is not a valid LUIS subscription key.')
+
+        if not endpoint or endpoint.isspace():
+            endpoint = "https://westus.api.cognitive.microsoft.com"
+
+        _, valid = LuisApplication._try_parse_url(endpoint)
+        if not valid:
+            raise ValueError(f'"{endpoint}" is not a valid LUIS endpoint.')
+
+        self._application_id = application_id
+        self._endpoint_key = endpoint_key
+        self._endpoint = endpoint
+
+    @classmethod
+    def from_application_endpoint(cls, application_endpoint: str):
+        """Initializes a new instance of the <see cref="LuisApplication"/> class.
+
+        :param application_endpoint: LUIS application endpoint.
+        :type application_endpoint: str
+        :return:
+        :rtype: LuisApplication
+        """
+        (application_id, endpoint_key, endpoint) = LuisApplication._parse(
+            application_endpoint
+        )
+        return cls(application_id, endpoint_key, endpoint)
+
+    @property
+    def application_id(self) -> str:
+        """Gets LUIS application ID.
+
+        :return: LUIS application ID.
+        :rtype: str
+        """
+
+        return self._application_id
+
+    @application_id.setter
+    def application_id(self, value: str) -> None:
+        """Sets LUIS application ID.
+
+        :param value: LUIS application ID.
+        :type value: str
+        :return:
+        :rtype: None
+        """
+
+        self._application_id = value
+
+    @property
+    def endpoint_key(self) -> str:
+        """Gets LUIS subscription or endpoint key.
+
+        :return: LUIS subscription or endpoint key.
+        :rtype: str
+        """
+
+        return self._endpoint_key
+
+    @endpoint_key.setter
+    def endpoint_key(self, value: str) -> None:
+        """Sets LUIS subscription or endpoint key.
+
+        :param value: LUIS subscription or endpoint key.
+        :type value: str
+        :return:
+        :rtype: None
+        """
+
+        self._endpoint_key = value
+
+    @property
+    def endpoint(self) -> str:
+        """Gets LUIS endpoint like https://westus.api.cognitive.microsoft.com.
+
+        :return: LUIS endpoint where application is hosted.
+        :rtype: str
+        """
+
+        return self._endpoint
+
+    @endpoint.setter
+    def endpoint(self, value: str) -> None:
+        """Sets LUIS endpoint like https://westus.api.cognitive.microsoft.com.
+
+        :param value: LUIS endpoint where application is hosted.
+        :type value: str
+        :return:
+        :rtype: None
+        """
+
+        self._endpoint = value
+
+    @staticmethod
+    def _parse(application_endpoint: str) -> Tuple[str, str, str]:
+        url, valid = LuisApplication._try_parse_url(application_endpoint)
+        if not valid:
+            raise ValueError(
+                f"{application_endpoint} is not a valid LUIS application endpoint."
+            )
+
+        segments = PurePosixPath(unquote(url.path)).parts
+        application_id = segments[-1] if segments else None
+        qs_parsed_result = parse_qs(url.query)
+        endpoint_key = qs_parsed_result.get("subscription-key", [None])[0]
+
+        parts_for_base_url = url.scheme, url.netloc, "", None, None, None
+        endpoint = urlunparse(parts_for_base_url)
+        return (application_id, endpoint_key, endpoint)
+
+    @staticmethod
+    def _try_parse_uuid4(uuid_string: str) -> Tuple[uuid4, bool]:
+        try:
+            uuid = UUID(uuid_string, version=4)
+        except (TypeError, ValueError):
+            return None, False
+
+        return uuid, True
+
+    @staticmethod
+    def _try_parse_url(url: str) -> Tuple[ParseResult, bool]:
+        try:
+            result = urlparse(url)
+            return result, True
+        except ValueError:
+            return None, False