NeonDaniel · Feb 3, 2026 · Mar 27, 2025 · Mar 27, 2025 · Apr 4, 2025 · Apr 4, 2025
diff --git a/.github/workflows/license_tests.yml b/.github/workflows/license_tests.yml
@@ -8,5 +8,3 @@ on:
 jobs:
   license_tests:
     uses: neongeckocom/.github/.github/workflows/license_tests.yml@master
-    with:
-      packages-exclude: '^(neon-data-models|dnspython).*'
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,88 +1,140 @@
 # Changelog
 
-## [0.0.0a11](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a11) (2025-02-07)
+## [0.0.2a17](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a17) (2026-01-30)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a10...0.0.0a11)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a16...0.0.2a17)
 
-**Implemented enhancements:**
+**Merged pull requests:**
+
+- Minor updates to prep release [\#32](https://github.com/NeonGeckoCom/neon-data-models/pull/32) ([NeonDaniel](https://github.com/NeonDaniel))
+
+## [0.0.2a16](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a16) (2026-01-28)
+
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a15...0.0.2a16)
+
+**Merged pull requests:**
+
+- Support more message roles in LLM requests [\#31](https://github.com/NeonGeckoCom/neon-data-models/pull/31) ([NeonDaniel](https://github.com/NeonDaniel))
+
+## [0.0.2a15](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a15) (2025-11-04)
+
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a14...0.0.2a15)
 
-- \[FEAT\] Skip system prompt if `persona=None` [\#9](https://github.com/NeonGeckoCom/neon-data-models/issues/9)
+**Merged pull requests:**
+
+- Refactor Chatbots messaging to match Klat [\#30](https://github.com/NeonGeckoCom/neon-data-models/pull/30) ([NeonDaniel](https://github.com/NeonDaniel))
+
+## [0.0.2a14](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a14) (2025-10-07)
+
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a13...0.0.2a14)
 
 **Merged pull requests:**
 
-- Add support for "vanilla" persona with unit tests [\#15](https://github.com/NeonGeckoCom/neon-data-models/pull/15) ([NeonDaniel](https://github.com/NeonDaniel))
+- Refactor UserMessage SIO model [\#29](https://github.com/NeonGeckoCom/neon-data-models/pull/29) ([NeonDaniel](https://github.com/NeonDaniel))
 
-## [0.0.0a10](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a10) (2025-02-06)
+## [0.0.2a13](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a13) (2025-10-07)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a9...0.0.0a10)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a12...0.0.2a13)
 
 **Merged pull requests:**
 
-- Update `llm` submodule and model docstrings [\#13](https://github.com/NeonGeckoCom/neon-data-models/pull/13) ([NeonDaniel](https://github.com/NeonDaniel))
+- Implement Models for Klat SocketIO events [\#11](https://github.com/NeonGeckoCom/neon-data-models/pull/11) ([NeonDaniel](https://github.com/NeonDaniel))
 
-## [0.0.0a9](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a9) (2025-02-06)
+## [0.0.2a12](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a12) (2025-09-25)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a8...0.0.0a9)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a11...0.0.2a12)
 
-## [0.0.0a8](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a8) (2025-02-02)
+**Merged pull requests:**
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a7...0.0.0a8)
+- Update ChatbotsMqRequest for backwards-compat [\#28](https://github.com/NeonGeckoCom/neon-data-models/pull/28) ([NeonDaniel](https://github.com/NeonDaniel))
 
-## [0.0.0a7](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a7) (2025-01-26)
+## [0.0.2a11](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a11) (2025-08-15)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a6...0.0.0a7)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a10...0.0.2a11)
 
-## [0.0.0a6](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a6) (2025-01-06)
+**Merged pull requests:**
+
+- Implement models for the Skill API [\#27](https://github.com/NeonGeckoCom/neon-data-models/pull/27) ([NeonDaniel](https://github.com/NeonDaniel))
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a5...0.0.0a6)
+## [0.0.2a10](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a10) (2025-08-07)
+
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a9...0.0.2a10)
 
 **Merged pull requests:**
 
-- Resolve issue with serializing default permissions [\#10](https://github.com/NeonGeckoCom/neon-data-models/pull/10) ([NeonDaniel](https://github.com/NeonDaniel))
+- Implement OpenAI Completion request/response models with unit tests [\#26](https://github.com/NeonGeckoCom/neon-data-models/pull/26) ([NeonDaniel](https://github.com/NeonDaniel))
 
-## [0.0.0a5](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a5) (2024-12-18)
+## [0.0.2a9](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a9) (2025-06-13)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a4...0.0.0a5)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a8...0.0.2a9)
 
 **Merged pull requests:**
 
-- Define data models for LLM interactions [\#4](https://github.com/NeonGeckoCom/neon-data-models/pull/4) ([NeonDaniel](https://github.com/NeonDaniel))
+- Specify `discussion_rounds` in new prompt model [\#23](https://github.com/NeonGeckoCom/neon-data-models/pull/23) ([NeonDaniel](https://github.com/NeonDaniel))
 
-## [0.0.0a4](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a4) (2024-11-21)
+## [0.0.2a8](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a8) (2025-06-13)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a3...0.0.0a4)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a7...0.0.2a8)
 
 **Merged pull requests:**
 
-- Update UserDbRequest models [\#3](https://github.com/NeonGeckoCom/neon-data-models/pull/3) ([NeonDaniel](https://github.com/NeonDaniel))
+- Update `chatbots` MQ models to improve validation and backwards-compat [\#21](https://github.com/NeonGeckoCom/neon-data-models/pull/21) ([NeonDaniel](https://github.com/NeonDaniel))
+
+## [0.0.2a7](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a7) (2025-05-31)
 
-## [0.0.0a3](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a3) (2024-11-19)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a6...0.0.2a7)
+
+**Merged pull requests:**
+
+- Add validator to make `LLMGetInferenceHttpRequest` more flexible [\#25](https://github.com/NeonGeckoCom/neon-data-models/pull/25) ([NeonDaniel](https://github.com/NeonDaniel))
+
+## [0.0.2a6](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a6) (2025-05-27)
+
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a5...0.0.2a6)
+
+**Merged pull requests:**
+
+- Update license tests to use default packages-exclude list [\#24](https://github.com/NeonGeckoCom/neon-data-models/pull/24) ([NeonDaniel](https://github.com/NeonDaniel))
+
+## [0.0.2a5](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a5) (2025-04-19)
+
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a4...0.0.2a5)
+
+**Merged pull requests:**
+
+- Fix type annotation for `user_profiles` context to match expected format [\#22](https://github.com/NeonGeckoCom/neon-data-models/pull/22) ([NeonDaniel](https://github.com/NeonDaniel))
+
+## [0.0.2a4](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a4) (2025-04-10)
+
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a3...0.0.2a4)
+
+**Merged pull requests:**
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a2...0.0.0a3)
+- Implement models for BrainForge service [\#8](https://github.com/NeonGeckoCom/neon-data-models/pull/8) ([NeonDaniel](https://github.com/NeonDaniel))
 
-**Implemented enhancements:**
+## [0.0.2a3](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a3) (2025-04-08)
 
-- \[FEAT\] Define range for user permissions [\#5](https://github.com/NeonGeckoCom/neon-data-models/issues/5)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a2...0.0.2a3)
 
 **Merged pull requests:**
 
-- Formally define and document Access Roles values [\#6](https://github.com/NeonGeckoCom/neon-data-models/pull/6) ([NeonDaniel](https://github.com/NeonDaniel))
+- Define gradio context used by `neon-iris` [\#20](https://github.com/NeonGeckoCom/neon-data-models/pull/20) ([NeonDaniel](https://github.com/NeonDaniel))
 
-## [0.0.0a2](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a2) (2024-11-19)
+## [0.0.2a2](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a2) (2025-04-04)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.0a1...0.0.0a2)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.2a1...0.0.2a2)
 
 **Merged pull requests:**
 
-- Update TokenConfig and add JWT models [\#2](https://github.com/NeonGeckoCom/neon-data-models/pull/2) ([NeonDaniel](https://github.com/NeonDaniel))
+- Implement MQ models for chatbots API [\#19](https://github.com/NeonGeckoCom/neon-data-models/pull/19) ([NeonDaniel](https://github.com/NeonDaniel))
 
-## [0.0.0a1](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.0a1) (2024-11-04)
+## [0.0.2a1](https://github.com/NeonGeckoCom/neon-data-models/tree/0.0.2a1) (2025-03-27)
 
-[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/ccd1aff89a6ecb260cd95851a177eb0db02a86f3...0.0.0a1)
+[Full Changelog](https://github.com/NeonGeckoCom/neon-data-models/compare/0.0.1...0.0.2a1)
 
 **Merged pull requests:**
 
-- Initial Implementation [\#1](https://github.com/NeonGeckoCom/neon-data-models/pull/1) ([NeonDaniel](https://github.com/NeonDaniel))
+- Implement models for Neon MQ API [\#18](https://github.com/NeonGeckoCom/neon-data-models/pull/18) ([NeonDaniel](https://github.com/NeonDaniel))
 
 
 

diff --git a/LICENSE.md b/LICENSE.md
@@ -1,6 +1,6 @@
 # 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.
+# Copyright 2008-2026 Neongecko.com Inc.
 # BSD-3
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
@@ -18,4 +18,4 @@ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
 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.
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/neon_data_models/__init__.py b/neon_data_models/__init__.py
@@ -1,6 +1,6 @@
 # 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.
+# Copyright 2008-2026 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:

diff --git a/neon_data_models/enum.py b/neon_data_models/enum.py
@@ -1,6 +1,6 @@
 # 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.
+# Copyright 2008-2026 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:
@@ -24,7 +24,7 @@
 # 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
+from enum import Enum, IntEnum
 
 
 class AccessRoles(IntEnum):
@@ -92,3 +92,34 @@ class Weekdays(IntEnum):
     FRI = 4
     SAT = 5
     SUN = 6
+
+
+class SubmindStatus(Enum):
+    """
+    Defines status of a submind in a particular conversation
+    """
+    BANNED = "banned"
+    ACTIVE = "active"
+
+
+class CcaiState(IntEnum):
+    """
+    Defines status of a conversation where a CCAI is operating
+    """
+    IDLE = 0  # No active prompt
+    RESP = 1  # Gathering responses to prompt
+    DISC = 2  # Discussing responses
+    VOTE = 3  # Voting on responses
+    PICK = 4  # Proctor will select response
+    WAIT = 5  # Bot is waiting for an invitation to participate
+
+
+class CcaiControl(Enum):
+    """
+    Defines control messages for a CCAI conversation
+    """
+    PROMPT_REGEX = r"^!PROMPT:"
+    SAVE_PROMPT_RESULTS = "!MSG:SAVE_PROMPT_RESULTS"
+    CREATE_PROMPT = "!MSG:CREATE_PROMPT"
+    START_AUTO_PROMPTS = "!START_AUTO_PROMPTS"
+    STOP_AUTO_PROMPTS = "!STOP_AUTO_PROMPTS"
diff --git a/neon_data_models/models/__init__.py b/neon_data_models/models/__init__.py
@@ -1,6 +1,6 @@
 # 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.
+# Copyright 2008-2026 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:

diff --git a/neon_data_models/models/api/__init__.py b/neon_data_models/models/api/__init__.py
@@ -1,6 +1,6 @@
 # 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.
+# Copyright 2008-2026 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:
@@ -28,3 +28,7 @@
 from neon_data_models.models.api.jwt import *
 from neon_data_models.models.api.llm import *
 from neon_data_models.models.api.mq import *
+from neon_data_models.models.api.messagebus import *
+from neon_data_models.models.api.klat import *
+from neon_data_models.models.api.chatbots import *
+from neon_data_models.models.api.http import *
diff --git a/neon_data_models/models/api/chatbots.py b/neon_data_models/models/api/chatbots.py
@@ -0,0 +1,55 @@
+# NEON AI (TM) SOFTWARE, Software Development Kit & Application Development System
+# All trademark and other rights reserved by their respective owners
+# Copyright 2008-2026 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 List, Optional
+from datetime import datetime, timezone
+from pydantic import Field
+from neon_data_models.models.base import BaseModel
+from neon_data_models.types import BotType
+
+
+class ConnectedSubmind(BaseModel):
+    service_name: str = Field(
+        description="Name of the submind service (not its UID)")
+    attached_cids: List[str] = Field(
+        default=[], alias="cids",
+        description="List of conversation IDs the submind is participating in")
+    version: Optional[str] = Field(
+        default=None,
+        description="Version of chatbot-core the submind is using")
+    supports_raw_conversation: bool = Field(
+        default=False,
+        description="True if the submind will handle all conversation shouts")
+    last_ping: datetime = Field(
+        default_factory=lambda: datetime.now(tz=timezone.utc),
+        description="Last time the submind pinged the observer")
+
+    bot_type: BotType = Field(
+        deprecated=True, default="submind",
+        description="Type of bot (always `submind` in this context)")
+
+
+__all__ = [ConnectedSubmind.__name__]
diff --git a/neon_data_models/models/api/http/__init__.py b/neon_data_models/models/api/http/__init__.py
@@ -0,0 +1,32 @@
+# 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.http.brainforge import *
+from neon_data_models.models.api.http.neon import *
+
+"""
+This module contains models for interacting via HANA (HTTP).
+"""