neon-data-models 0.0.0a1__py3-none-any.whl

neon_data_models/__init__.py

@@ -0,0 +1,25 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

neon_data_models/enum.py

@@ -0,0 +1,83 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from enum import IntEnum
+
+
+class AccessRoles(IntEnum):
+    """
+    Defines access roles such that a larger value always corresponds to more
+    permissions. `0` equates to no permission, negative numbers correspond to
+    non-user roles. In this way, an activity can require, for example,
+    `permission > AccessRoles.GUEST` to grant access to all registered users,
+    admins, and owners.
+    """
+    NONE = 0
+    GUEST = 1
+    USER = 2
+    ADMIN = 3
+    OWNER = 4
+
+    NODE = -1
+
+
+class UserData(IntEnum):
+    """
+    Defines types of user data.
+    """
+    CACHES = 0
+    PROFILE = 1
+    TRANSCRIPTS = 2
+    LIKED_BRANDS = 3
+    DISLIKED_BRANDS = 4
+    ALL_DATA = 5
+    ALL_MEDIA = 6
+    UNITS_CONFIG = 7
+    LANGUAGE_CONFIG = 8
+
+
+class AlertType(IntEnum):
+    """
+    Defines kinds of alerts.
+    """
+    ALL = -1
+    ALARM = 0
+    TIMER = 1
+    REMINDER = 2
+    UNKNOWN = 99
+
+
+class Weekdays(IntEnum):
+    """
+    Defines weekdays as used in the Alerts skill.
+    """
+    MON = 0
+    TUE = 1
+    WED = 2
+    THU = 3
+    FRI = 4
+    SAT = 5
+    SUN = 6

neon_data_models/models/__init__.py

@@ -0,0 +1,25 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

neon_data_models/models/api/__init__.py

@@ -0,0 +1,28 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from neon_data_models.models.api.node_v1 import *
+from neon_data_models.models.api.mq import *

neon_data_models/models/api/mq.py

@@ -0,0 +1,40 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from typing import Literal, Optional
+from neon_data_models.models.base.contexts import MQContext
+from neon_data_models.models.user.database import User
+
+
+class UserDbRequest(MQContext):
+    operation: Literal["create", "read", "update", "delete"]
+    username: str
+    password: Optional[str] = None
+    access_token: Optional[str] = None
+    user: Optional[User] = None
+
+
+__all__ = [UserDbRequest.__name__]

neon_data_models/models/api/node_v1/__init__.py

@@ -0,0 +1,155 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from datetime import datetime, timedelta
+from pydantic import Field
+from typing import List, Literal, Optional, Annotated, Dict
+
+from neon_data_models.enum import UserData, AlertType, Weekdays
+from neon_data_models.models.base import BaseModel
+from neon_data_models.models.base.messagebus import BaseMessage, MessageContext
+
+
+class AudioInputData(BaseModel):
+    audio_data: str = Field(description="base64-encoded audio")
+    lang: str = Field(description="BCP-47 language code")
+
+
+class KlatResponse(BaseModel):
+    sentence: str = Field(description="Text response")
+    audio: Dict[Literal["male", "female"], Optional[str]] = Field(
+        description="Mapping of gender to b64-encoded audio")
+
+
+class AudioInputResponseData(BaseModel):
+    parser_data: dict
+    transcripts: List[str]
+    skills_recv: bool
+
+
+class NodeAudioInput(BaseMessage):
+    msg_type: Literal["neon.audio_input"] = "neon.audio_input"
+    data: AudioInputData
+
+
+class NodeTextInput(BaseMessage):
+    class UtteranceInputData(BaseModel):
+        utterances: List[str] = Field(description="List of input utterance(s)")
+        lang: str = Field(description="BCP-47 language")
+
+    msg_type: Literal["recognizer_loop:utterance"] = "recognizer_loop:utterance"
+    data: UtteranceInputData
+
+
+class NodeGetStt(BaseMessage):
+    msg_type: Literal["neon.get_stt"] = "neon.get_stt"
+    data: AudioInputData
+
+
+class NodeGetTts(BaseMessage):
+    class TextInputData(BaseModel):
+        text: str = Field(description="String text input")
+        lang: str = Field(description="BCP-47 language code")
+
+    msg_type: Literal["neon.get_tts"] = "neon.get_tts"
+    data: TextInputData
+
+
+class NodeKlatResponse(BaseMessage):
+    msg_type: Literal["klat.response"] = "klat.response"
+    data: Dict[str, KlatResponse] = Field(type=Dict[str, KlatResponse],
+                       description="dict of BCP-47 language: KlatResponse")
+
+
+class NodeAudioInputResponse(BaseMessage):
+    msg_type: Literal["neon.audio_input.response"] = "neon.audio_input.response"
+    data: AudioInputResponseData
+
+
+class NodeGetSttResponse(BaseMessage):
+    msg_type: Literal["neon.get_stt.response"] = "neon.get_stt.response"
+    data: AudioInputResponseData
+
+
+class NodeGetTtsResponse(BaseMessage):
+    msg_type: Literal["neon.get_tts.response"] = "neon.get_tts.response"
+    data: Dict[str, KlatResponse] = (
+        Field(type=Dict[str, KlatResponse],
+              description="dict of BCP-47 language: KlatResponse"))
+
+
+class CoreWWDetected(BaseMessage):
+    msg_type: Literal["neon.ww_detected"] = "neon.ww_detected"
+    # TODO: Define/implement schema in neon-speech service
+    data: dict
+
+
+class CoreIntentFailure(BaseMessage):
+    msg_type: Literal["complete_intent_failure"] = "complete_intent_failure"
+    data: dict  # Empty dict
+
+
+class CoreErrorResponse(BaseMessage):
+    class KlatErrorData(BaseModel):
+        error: str = "unknown error"
+        data: dict = {}
+
+    msg_type: Literal["klat.error"] = "klat.error"
+    data: KlatErrorData
+
+
+class CoreClearData(BaseMessage):
+    class ClearDataData(BaseModel):
+        username: str
+        data_to_remove: List[UserData]
+
+    msg_type: Literal["neon.clear_data"] = "neon.clear_data"
+    data: ClearDataData
+
+
+class CoreAlertExpired(BaseMessage):
+    class AlertData(BaseModel):
+        alert_type: AlertType
+        priority: Annotated[int, Field(gt=1, lt=10)]
+        alert_name: str
+        context: MessageContext
+        next_expiration_time: Optional[datetime]
+        repeat_frequency: Optional[timedelta]
+        repeat_days: Optional[List[Weekdays]]
+        end_repeat: Optional[datetime]
+        audio_file: Optional[str] = None
+        script_filename: Optional[str] = None
+
+    msg_type: Literal["neon.alert_expired"] = "neon.alert_expired"
+    data: AlertData
+
+
+__all__ = [NodeAudioInput.__name__, NodeTextInput.__name__, NodeGetStt.__name__,
+           NodeGetTts.__name__, NodeKlatResponse.__name__,
+           NodeAudioInputResponse.__name__, NodeGetSttResponse.__name__,
+           NodeGetTtsResponse.__name__, CoreWWDetected.__name__,
+           CoreIntentFailure.__name__, CoreErrorResponse.__name__,
+           CoreClearData.__name__, CoreAlertExpired.__name__]

neon_data_models/models/base/__init__.py

@@ -0,0 +1,33 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from os import environ
+from pydantic import ConfigDict, BaseModel as _BaseModel
+
+
+class BaseModel(_BaseModel):
+    model_config = ConfigDict(extra="allow" if environ.get(
+            "NEON_DATA_MODELS_ALLOW_EXTRA", "false") != "false" else "ignore")

neon_data_models/models/base/contexts.py

@@ -0,0 +1,98 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+from datetime import datetime, timedelta
+from typing import Literal, List, Optional
+
+from pydantic import Field
+
+from neon_data_models.models.base import BaseModel
+
+
+class SessionContext(BaseModel):
+    session_id: str = "default"
+    active_skills: List[str] = []
+    utterance_states: dict = {}
+    lang: Optional[str] = None
+    context: dict = {}
+    site_id: str = "unknown"
+    pipeline: List[str] = []
+    location: dict = {}
+    system_unit: Optional[Literal["imperial", "metric"]] = None
+    date_format: Optional[Literal["MDY", "YMD", "YDM", "DMY"]] = None
+    time: Optional[Literal[12, 24]] = None
+    is_recording: bool = False
+    is_speaking: bool = False
+    blacklisted_skills: List[str] = []
+    blacklisted_intents: List[str] = []
+
+    def model_dump(self, *args, **kwargs) -> dict:
+        # Override to explicitly exclude default `None` values so that upstream
+        # logic works to read values from global config
+        kwargs["exclude_none"] = True
+        return BaseModel.model_dump(self, *args, **kwargs)
+
+
+class TimingContext(BaseModel):
+    def __init__(self, **kwargs):
+        # Enables backwards-compat. with old context values
+        if transcribed := kwargs.pop("transcribed", None):
+            kwargs.setdefault("handle_utterance", transcribed)
+        if text_parsers := kwargs.pop("text_parsers", None):
+            kwargs.setdefault("transform_utterance", text_parsers)
+        BaseModel.__init__(self, **kwargs)
+
+    audio_begin: Optional[datetime] = None
+    audio_end: Optional[datetime] = None
+    client_sent: Optional[datetime] = None
+    gradio_sent: Optional[datetime] = None
+    handle_utterance: Optional[datetime] = None
+    response_sent: Optional[datetime] = None
+    speech_start: Optional[datetime] = None
+
+    get_stt: Optional[timedelta] = None
+    get_tts: Optional[timedelta] = None
+    iris_input_handling: Optional[timedelta] = None
+    mq_response_handler: Optional[timedelta] = None
+    mq_from_core: Optional[timedelta] = None
+    mq_from_client: Optional[timedelta] = None
+    mq_input_handler: Optional[timedelta] = None
+    client_to_core: Optional[timedelta] = None
+    client_from_core: Optional[timedelta] = None
+    save_transcript: Optional[timedelta] = None
+    transform_audio: Optional[timedelta] = None
+    transform_utterance: Optional[timedelta] = None
+    wait_in_queue: Optional[timedelta] = None
+
+
+class KlatContext(BaseModel):
+    sid: str
+    cid: str
+    title: Optional[str] = ""
+
+
+class MQContext(BaseModel):
+    routing_key: Optional[str] = None
+    message_id: str

neon_data_models/models/base/messagebus.py

@@ -0,0 +1,65 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from typing import Optional, List, Union
+from pydantic import ConfigDict, Field
+
+from neon_data_models.models.base import BaseModel
+from neon_data_models.models.base.contexts import (SessionContext, KlatContext,
+                                                   TimingContext, MQContext)
+from neon_data_models.models.client import NodeData
+from neon_data_models.models.user import NeonUserConfig
+
+
+class MessageContext(BaseModel):
+    model_config = ConfigDict(extra="allow")
+    session: Optional[SessionContext] = Field(description="Session Data",
+                                              default=None)
+    node_data: Optional[NodeData] = Field(description="Node Data", default=None)
+    timing: Optional[TimingContext] = Field(
+        description="User Interaction Timing Information", default=None)
+    user_profiles: Optional[List[NeonUserConfig]] = (
+        Field(description="List of relevant user profiles", default=None))
+    klat_data: Optional[KlatContext] = Field(
+        description="Klat context for Klat-generated messages", default=None)
+    mq: Optional[MQContext] = Field(
+        description="MQ context for messages traversing a RabbitMQ broker",
+        default=None)
+
+    username: str = "local"
+    # TODO: Consider refactoring client/client_name into a single dict
+    #  or merging with `node_data`
+    client_name: str = "unknown"
+    client: str = "unknown"
+    source: Union[str, List[str]] = "unknown"
+    destination: List[str] = ["skills"]
+    neon_should_respond: bool = True
+
+
+class BaseMessage(BaseModel):
+    msg_type: str
+    data: dict
+    context: MessageContext

neon_data_models/models/client/__init__.py

@@ -0,0 +1,27 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from neon_data_models.models.client.node import *

neon_data_models/models/client/node.py

@@ -0,0 +1,69 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from uuid import uuid4
+from pydantic import Field
+from typing import Optional, Dict
+from neon_data_models.models.base import BaseModel
+
+
+class NodeSoftware(BaseModel):
+    operating_system: str = ""
+    os_version: str = ""
+    neon_packages: Optional[Dict[str, str]] = None
+
+
+class NodeNetworking(BaseModel):
+    local_ip: str = ""
+    public_ip: str = ""
+    mac_address: str = ""
+
+
+class NodeLocation(BaseModel):
+    def __init__(self, **kwargs):
+        # Enables backwards-compat. with old coordinate values
+        if lat := kwargs.pop("lat", None):
+            kwargs.setdefault("latitude", lat)
+        if lon := kwargs.pop("lon", None):
+            kwargs.setdefault("longitude", lon)
+        BaseModel.__init__(self, **kwargs)
+    latitude: Optional[float] = None
+    longitude: Optional[float] = None
+    site_id: Optional[str] = None
+
+
+class NodeData(BaseModel):
+    device_id: str = Field(default_factory=lambda: str(uuid4()))
+    device_name: str = ""
+    device_description: str = ""
+    platform: str = ""
+    networking: NodeNetworking = NodeNetworking()
+    software: NodeSoftware = NodeSoftware()
+    location: NodeLocation = NodeLocation()
+
+
+__all__ = [NodeSoftware.__name__, NodeNetworking.__name__,
+           NodeLocation.__name__, NodeData.__name__]

neon_data_models/models/user/__init__.py

@@ -0,0 +1,28 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from neon_data_models.models.user.database import *
+from neon_data_models.models.user.neon_profile import *

neon_data_models/models/user/database.py

@@ -0,0 +1,162 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+from time import time
+from typing import Dict, Any, List, Literal, Optional
+from uuid import uuid4
+from neon_data_models.models.base import BaseModel
+from pydantic import Field
+from datetime import date
+
+from neon_data_models.enum import AccessRoles
+
+
+class _UserConfig(BaseModel):
+    first_name: str = ""
+    middle_name: str = ""
+    last_name: str = ""
+    preferred_name: str = ""
+    dob: Optional[date] = None
+    email: str = ""
+    avatar_url: str = Field(default="",
+                            description="Fully-qualified URI of a user avatar. "
+                                        "(i.e. `https://example.com/avatar.jpg")
+    about: str = ""
+    phone: str = ""
+
+
+class _LanguageConfig(BaseModel):
+    input_languages: List[str] = ["en-us"]
+    output_languages: List[str] = ["en-us"]
+
+
+class _UnitsConfig(BaseModel):
+    time: Literal[12, 24] = 12
+    date: Literal["MDY", "YMD", "YDM", "DMY"] = "MDY"
+    measure: Literal["imperial", "metric"] = "imperial"
+
+
+class _ResponseConfig(BaseModel):
+    hesitation: bool = False
+    limit_dialog: bool = False
+    tts_gender: Literal["male", "female"] = "female"
+    tts_speed_multiplier: float = 1.0
+
+
+class _LocationConfig(BaseModel):
+    latitude: Optional[float] = None
+    longitude: Optional[float] = None
+    name: Optional[str] = None
+    timezone: Optional[str] = None
+
+
+class _PrivacyConfig(BaseModel):
+    save_text: bool = True
+    save_audio: bool = False
+
+
+class NeonUserConfig(BaseModel):
+    """
+    Defines user configuration used in Neon Core.
+    """
+    skills: Dict[str, Dict[str, Any]] = {}
+    user: _UserConfig = _UserConfig()
+    # Former `speech` schema is replaced by `language` which is a more general
+    # format.
+    language: _LanguageConfig = _LanguageConfig()
+    units: _UnitsConfig = _UnitsConfig()
+    # Former `location` schema is replaced here with a minimal spec from which
+    # the remaining values may be calculated
+    location: _LocationConfig = _LocationConfig()
+    response_mode: _ResponseConfig = _ResponseConfig()
+    privacy: _PrivacyConfig = _PrivacyConfig()
+
+
+class KlatConfig(BaseModel):
+    """
+    Defines user configuration used in PyKlatChat.
+    """
+    is_tmp: bool = True
+    preferences: Dict[str, Any] = {}
+
+
+class BrainForgeConfig(BaseModel):
+    """
+    Defines configuration used in BrainForge LLM applications.
+    """
+    inference_access: Dict[str, Dict[str, List[str]]] = {}
+
+
+class PermissionsConfig(BaseModel):
+    """
+    Defines roles for supported projects/service families.
+    """
+    klat: AccessRoles = AccessRoles.NONE
+    core: AccessRoles = AccessRoles.NONE
+    diana: AccessRoles = AccessRoles.NONE
+    node: AccessRoles = AccessRoles.NONE
+    hub: AccessRoles = AccessRoles.NONE
+    llm: AccessRoles = AccessRoles.NONE
+
+    class Config:
+        use_enum_values = True
+
+
+class TokenConfig(BaseModel):
+    username: str
+    client_id: str
+    permissions: Dict[str, bool]
+    refresh_token: str
+    expiration: int = Field(
+        description="Unix timestamp of auth token expiration")
+    refresh_expiration: int = Field(
+        description="Unix timestamp of refresh token expiration")
+    token_name: str
+    creation_timestamp: int = Field(
+        description="Unix timestamp of auth token creation")
+    last_refresh_timestamp: int = Field(
+        description="Unix timestamp of last auth token refresh")
+    access_token: Optional[str] = None
+
+
+class User(BaseModel):
+    username: str
+    password_hash: Optional[str] = None
+    user_id: str = Field(default_factory=lambda: str(uuid4()))
+    created_timestamp: int = Field(default_factory=lambda: round(time()))
+    neon: NeonUserConfig = NeonUserConfig()
+    klat: KlatConfig = KlatConfig()
+    llm: BrainForgeConfig = BrainForgeConfig()
+    permissions: PermissionsConfig = PermissionsConfig()
+    tokens: Optional[List[TokenConfig]] = []
+
+    def __eq__(self, other):
+        return self.model_dump() == other.model_dump()
+
+
+__all__ = [NeonUserConfig.__name__, KlatConfig.__name__,
+           BrainForgeConfig.__name__, PermissionsConfig.__name__,
+           TokenConfig.__name__, User.__name__]

neon_data_models/models/user/neon_profile.py

@@ -0,0 +1,167 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+import pytz
+import datetime
+
+from typing import Optional, List, Literal
+
+from pydantic import Field
+
+from neon_data_models.models.base import BaseModel
+
+from neon_data_models.models.user.database import User
+
+
+class ProfileUser(BaseModel):
+    first_name: str = ""
+    middle_name: str = ""
+    last_name: str = ""
+    preferred_name: str = ""
+    full_name: str = ""
+    dob: str = "YYYY/MM/DD"
+    age: str = ""
+    email: str = ""
+    username: str = ""
+    password: str = ""
+    picture: str = Field(default="",
+                         description="Fully-qualified URI of a user avatar. "
+                                     "(i.e. `https://example.com/avatar.jpg")
+    about: str = ""
+    phone: str = ""
+    phone_verified: bool = False
+    email_verified: bool = False
+
+
+class ProfileSpeech(BaseModel):
+    stt_language: str = "en-us"
+    alt_languages: List[str] = ['en']
+    tts_language: str = "en-us"
+    tts_gender: str = "female"
+    neon_voice: Optional[str] = ''
+    secondary_tts_language: Optional[str] = ''
+    secondary_tts_gender: str = "male"
+    secondary_neon_voice: str = ''
+    speed_multiplier: float = 1.0
+
+
+class ProfileUnits(BaseModel):
+    time: Literal[12, 24] = 12
+    date: Literal["MDY", "YMD", "YDM", "DMY"] = "MDY"
+    measure: Literal["imperial", "metric"] = "imperial"
+
+
+class ProfileLocation(BaseModel):
+    lat: Optional[float] = None
+    lng: Optional[float] = None
+    city: Optional[str] = None
+    state: Optional[str] = None
+    country: Optional[str] = None
+    tz: Optional[str] = None
+    utc: Optional[float] = None
+
+
+class ProfileResponseMode(BaseModel):
+    speed_mode: str = "quick"
+    hesitation: bool = False
+    limit_dialog: bool = False
+
+
+class ProfilePrivacy(BaseModel):
+    save_audio: bool = False
+    save_text: bool = False
+
+
+class UserProfile(BaseModel):
+    user: ProfileUser = ProfileUser()
+    speech: ProfileSpeech = ProfileSpeech()
+    units: ProfileUnits = ProfileUnits()
+    location: ProfileLocation = ProfileLocation()
+    response_mode: ProfileResponseMode = ProfileResponseMode()
+    privacy: ProfilePrivacy = ProfilePrivacy()
+
+    @classmethod
+    def from_user_object(cls, user: User):
+        user_config = user.neon
+        today = datetime.date.today()
+        if user_config.user.dob:
+            dob = user_config.user.dob
+            age = str(today.year - dob.year - (
+                    (today.month, today.day) < (dob.month, dob.day)))
+            dob = dob.strftime("%Y/%m/%d")
+        else:
+            age = ""
+            dob = "YYYY/MM/DD"
+        full_name = " ".join((n for n in (user_config.user.first_name,
+                                          user_config.user.middle_name,
+                                          user_config.user.last_name) if n))
+        user = ProfileUser(about=user_config.user.about,
+                           age=age, dob=dob,
+                           email=user_config.user.email,
+                           email_verified=False,
+                           first_name=user_config.user.first_name,
+                           full_name=full_name,
+                           last_name=user_config.user.last_name,
+                           middle_name=user_config.user.middle_name,
+                           password=user.password_hash or "",
+                           phone=user_config.user.phone,
+                           phone_verified=False,
+                           picture=user_config.user.avatar_url,
+                           preferred_name=user_config.user.preferred_name,
+                           username=user.username
+                           )
+        alt_stt = [lang.split('-')[0] for lang in
+                   user_config.language.input_languages[1:]]
+        secondary_tts_lang = user_config.language.output_languages[1] if (
+                len(user_config.language.output_languages) > 1) else None
+        speech = ProfileSpeech(
+            alt_languages=alt_stt,
+            secondary_tts_gender=user_config.response_mode.tts_gender,
+            secondary_tts_language=secondary_tts_lang,
+            speed_multiplier=user_config.response_mode.tts_speed_multiplier,
+            stt_language=user_config.language.input_languages[0].split('-')[0],
+            tts_gender=user_config.response_mode.tts_gender,
+            tts_language=user_config.language.output_languages[0])
+        units = ProfileUnits(**user_config.units.model_dump())
+        utc_hours = (pytz.timezone(user_config.location.timezone or "UTC")
+                     .utcoffset(datetime.datetime.now()).total_seconds() / 3600)
+        # TODO: Get city, state, country from lat/lon
+        location = ProfileLocation(lat=user_config.location.latitude,
+                                   lng=user_config.location.longitude,
+                                   tz=user_config.location.timezone,
+                                   utc=utc_hours)
+        response_mode = ProfileResponseMode(
+            **user_config.response_mode.model_dump())
+        privacy = ProfilePrivacy(**user_config.privacy.model_dump())
+
+        return UserProfile(location=location, privacy=privacy,
+                           response_mode=response_mode, speech=speech,
+                           units=units, user=user)
+
+
+__all__ = [ProfileUser.__name__, ProfileSpeech.__name__, ProfileUnits.__name__,
+           ProfileLocation.__name__, ProfileResponseMode.__name__,
+           ProfilePrivacy.__name__, UserProfile.__name__]

neon_data_models/util.py

@@ -0,0 +1,52 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+import json
+
+from os import makedirs
+from os.path import join, dirname
+from typing import Optional
+from pydantic import BaseModel
+
+import neon_data_models.models
+
+
+def build_json_schema(output_path: Optional[str] = None):
+    """
+    Builds JSON schema for all Pydantic models in this module.
+    """
+    root_path = output_path or join(dirname(__file__), 'schema')
+    for obj in neon_data_models.models.__dict__.values():
+        try:
+            if issubclass(obj, BaseModel) and obj.__name__ != "BaseModel":
+                path_parts = obj.__module__.split('.')[2:]
+                out_path = join(root_path, *path_parts,
+                                f"{obj.__name__}.json")
+                makedirs(dirname(out_path), exist_ok=True)
+                with open(out_path, 'w+') as f:
+                    json.dump(obj.model_json_schema(), f, indent=2)
+        except TypeError:
+            pass

neon_data_models/version.py

@@ -0,0 +1,29 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Framework
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# Contributors: Daniel McKnight, Guy Daniels, Elon Gasper, Richard Leeds,
+# Regina Bloomstine, Casimiro Ferreira, Andrii Pernatii, Kirill Hrymailo
+# BSD-3 License
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS;  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+__version__ = "0.0.0a1"

neon_data_models-0.0.0a1.dist-info/LICENSE.md

@@ -0,0 +1,21 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2024 Neongecko.com Inc.
+# BSD-3
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
+following conditions are met:
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
+disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
+disclaimer in the documentation and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products
+derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

neon_data_models-0.0.0a1.dist-info/METADATA

@@ -0,0 +1,48 @@
+Metadata-Version: 2.1
+Name: neon-data-models
+Version: 0.0.0a1
+Summary: Pydantic models and associated JSON schema definitions
+Home-page: https://github.com/NeonGeckoCom/neon-data-models
+Author: NeonGecko
+Author-email: developers@neon.ai
+License: BSD-3-Clause
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: pydantic~=2.9
+Requires-Dist: pytz
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+
+## Neon Data Models
+This repository contains Pydantic models and JSON schemas for common data
+structures. The `models` module contains Pydantic models, organized by application.
+
+## Configuration
+To allow passing or handling parameters that are not explicitly defined in the
+models provided by this package, the `NEON_DATA_MODELS_ALLOW_EXTRA` envvar may
+be set to `true`. This is generally not necessary and helps to prevent sending
+extraneous data, but may help in cases where the server and client are using
+different revisions of this package.
+
+## Organization
+Models are broadly organized into the following categories.
+
+### API
+These schemas are used in API requests and responses. They are grouped by the
+applicable API (node, HANA, mq). Use these schemas for sending requests and
+parsing responses.
+
+### Client
+These schemas are specific to client applications (i.e. Nodes). Use these
+schemas for client-specific configuration.
+
+### User
+These schemas define user-specific data structures. Use these schemas for 
+user-specific configuration.
+
+### Messagebus
+These schemas define messages sent on the messagebus. Historically, messagebus
+events have not used any validation, so there is greater risk of Message objects
+failing validation than other schemas defined here. 

neon_data_models-0.0.0a1.dist-info/RECORD

@@ -0,0 +1,22 @@
+neon_data_models/__init__.py,sha256=8YnfV3nxHf8pBnppb9HpeYNqMg74ZaTbC4VV39k8BE4,1685
+neon_data_models/enum.py,sha256=D9q5wfgO6mDevkT_oefY_NDlCbVDKEFVmBRhoei3NwU,2744
+neon_data_models/util.py,sha256=bFr99qMIR3at8SIgtR97ywam1WdEV0mMb9xF8qQ0Rc4,2587
+neon_data_models/version.py,sha256=VxMmU2D4uripME5XfS253pLSL1yBv3sRDQS-pfJX4Uo,1856
+neon_data_models/models/__init__.py,sha256=8YnfV3nxHf8pBnppb9HpeYNqMg74ZaTbC4VV39k8BE4,1685
+neon_data_models/models/api/__init__.py,sha256=UBNvoSImNonGoUjibcyVd5sUJRLXxvRUpcIqin6TsIw,1781
+neon_data_models/models/api/mq.py,sha256=_pfGEKmEBDBOlBlgVFtNyCCyYUDkTCypErVbvTeZfvc,2094
+neon_data_models/models/api/node_v1/__init__.py,sha256=VUwr8fJm7usc7oJRZzqlHYFf3dy3NplDUvb5O9m0r6Y,5871
+neon_data_models/models/base/__init__.py,sha256=TmNCAU8blsOFN5BxoDN2aE2M1-Qn87RQ0D0F2tmKX_Y,1936
+neon_data_models/models/base/contexts.py,sha256=k5Da8nid-Ih7GUy28Czy7xxuqrDfa5NwzyuAD5hNo5A,4241
+neon_data_models/models/base/messagebus.py,sha256=NgRSeVre_TPY0vxNxk3k-5cvcz5QMap55xWM4wieJYg,3296
+neon_data_models/models/client/__init__.py,sha256=pPA3-qiv3FeXLWWGZ4LOFG1RzEX9jIjQo2rbJpWxkOQ,1736
+neon_data_models/models/client/node.py,sha256=HzOc-ixale1JamdZG5v4pgyP3HcpYY-_FNE2HH48SEY,2960
+neon_data_models/models/user/__init__.py,sha256=aYTi84ZtmIQltzqqfnerOQcbxQxU3eAbHRucHmVmLXo,1794
+neon_data_models/models/user/database.py,sha256=kL9VhECehNSdBrGnKcs51vtoJvbdjgcFqBxKNvNrdzM,5791
+neon_data_models/models/user/neon_profile.py,sha256=dxDJF7rqtSwtH4BfueAjsqiR1cLC9EJm_OaUj-tXo3w,7116
+neon_data_models-0.0.0a1.dist-info/LICENSE.md,sha256=Qu3UMcoPqNXAk71jELaebP8egnqVId7XImoX1Ejdozs,1626
+neon_data_models-0.0.0a1.dist-info/METADATA,sha256=FtrnX-gxQwlpCAjzDECUMJDDLYYYE0k_oVWrkRTsrok,1804
+neon_data_models-0.0.0a1.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
+neon_data_models-0.0.0a1.dist-info/top_level.txt,sha256=OY2pqFYhZRbKk-RL_Utz-RJRXyhaX26S5l7N9iWvArk,17
+neon_data_models-0.0.0a1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+neon_data_models-0.0.0a1.dist-info/RECORD,,

neon_data_models-0.0.0a1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.44.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

neon_data_models-0.0.0a1.dist-info/top_level.txt

@@ -0,0 +1 @@
+neon_data_models

neon_data_models-0.0.0a1.dist-info/zip-safe

@@ -0,0 +1 @@
+