nemo-platform-plugin 0.1.0__py3-none-any.whl

nemo_platform/types/intake/exports/export_job.py

@@ -0,0 +1,76 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from ...._models import BaseModel
+from .job_status import JobStatus
+from .export_config import ExportConfig
+from .export_status_details import ExportStatusDetails
+
+__all__ = ["ExportJob"]
+
+
+class ExportJob(BaseModel):
+    """Export job tracking entry exports to external datastores.
+
+    Export jobs track the status of background export tasks.
+    """
+
+    id: str
+
+    config: ExportConfig
+    """Configuration for an export job.
+
+    Defines what entries to export and how to format them.
+    """
+
+    created_at: datetime
+
+    created_by: Optional[str] = None
+
+    entity_id: str
+    """Alias for id for backwards compatibility."""
+
+    parent: str
+    """Parent entity ID for nested entities."""
+
+    updated_at: datetime
+
+    updated_by: Optional[str] = None
+
+    workspace: str
+    """Workspace identifier"""
+
+    name: Optional[str] = None
+    """Entity name within the workspace"""
+
+    output_file_url: Optional[str] = None
+    """
+    The place where the exported file should be written (file://, hf://, nds://,
+    etc.)
+    """
+
+    project: Optional[str] = None
+    """The name of the project associated with this entity."""
+
+    status: Optional[JobStatus] = None
+    """Job status enum."""
+
+    status_details: Optional[ExportStatusDetails] = None
+    """Detailed status information for an export job."""

nemo_platform/types/intake/exports/export_job_filter_param.py

@@ -0,0 +1,50 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+from .job_status import JobStatus
+from ...shared_params.datetime_filter import DatetimeFilter
+
+__all__ = ["ExportJobFilterParam"]
+
+
+class ExportJobFilterParam(TypedDict, total=False):
+    """Filter for ExportJobs."""
+
+    id: str
+    """Filter by export job ID."""
+
+    created_at: DatetimeFilter
+    """Filter entities based on creation date."""
+
+    name: str
+    """Filter by export job name."""
+
+    output_file_url: str
+    """Filter by output file URL."""
+
+    status: JobStatus
+    """Job status enum."""
+
+    updated_at: DatetimeFilter
+    """Filter entities based on update date."""
+
+    workspace: str
+    """Filter by workspace id."""

nemo_platform/types/intake/exports/export_job_sort_field.py

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["ExportJobSortField"]
+
+ExportJobSortField: TypeAlias = Literal["created_at", "-created_at", "updated_at", "-updated_at", "status", "-status"]

nemo_platform/types/intake/exports/export_jobs_page.py

@@ -0,0 +1,37 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+
+from ...._models import BaseModel
+from .export_job import ExportJob
+from ...shared.pagination_data import PaginationData
+
+__all__ = ["ExportJobsPage"]
+
+
+class ExportJobsPage(BaseModel):
+    data: List[ExportJob]
+
+    filter: Optional[Dict[str, object]] = None
+    """Filtering information."""
+
+    pagination: Optional[PaginationData] = None
+    """Pagination information."""
+
+    sort: Optional[str] = None
+    """The field on which the results are sorted."""

nemo_platform/types/intake/exports/export_status_details.py

@@ -0,0 +1,35 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ...._models import BaseModel
+
+__all__ = ["ExportStatusDetails"]
+
+
+class ExportStatusDetails(BaseModel):
+    """Detailed status information for an export job."""
+
+    entries_count: Optional[int] = None
+    """Number of entries exported"""
+
+    error_message: Optional[str] = None
+    """Error message if the job failed"""
+
+    progress: Optional[float] = None
+    """Progress percentage (0-100)"""

nemo_platform/types/intake/exports/job_create_params.py

@@ -0,0 +1,40 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+from ..export_config_param_param import ExportConfigParamParam
+
+__all__ = ["JobCreateParams"]
+
+
+class JobCreateParams(TypedDict, total=False):
+    workspace: str
+
+    config: Required[ExportConfigParamParam]
+    """Input schema for export configuration.
+
+    Defines what entries to export and how to format them.
+    """
+
+    output_file_url: Required[str]
+    """
+    The place where the exported file should be written (file://, hf://, nds://,
+    etc.)
+    """

nemo_platform/types/intake/exports/job_list_params.py

@@ -0,0 +1,46 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+from .export_job_sort_field import ExportJobSortField
+from .export_job_filter_param import ExportJobFilterParam
+
+__all__ = ["JobListParams"]
+
+
+class JobListParams(TypedDict, total=False):
+    workspace: str
+
+    filter: ExportJobFilterParam
+    """
+    Filter export jobs by name, status, output_file_url, created_at, and updated_at.
+    """
+
+    page: int
+    """Page number."""
+
+    page_size: int
+    """Page size."""
+
+    sort: ExportJobSortField
+    """The field to sort by.
+
+    To sort in decreasing order, use `-` in front of the field name.
+    """

nemo_platform/types/intake/exports/job_status.py

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["JobStatus"]
+
+JobStatus: TypeAlias = Literal["pending", "running", "completed", "failed", "cancelled"]

nemo_platform/types/intake/flexible_entry_request.py

@@ -0,0 +1,63 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import TYPE_CHECKING, Dict, List
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+from .flexible_message import FlexibleMessage
+
+__all__ = ["FlexibleEntryRequest"]
+
+
+class FlexibleEntryRequest(BaseModel):
+    """Flexible entry request that accepts any object shape.
+
+    This flexibility enables the Intake service to store requests from various LLM providers
+    (OpenAI, Anthropic, NIM, etc.) and future model types (embeddings, multimodal, etc.)
+    without requiring schema updates.
+
+    Required fields: `messages` and `model`
+    Common optional fields: `temperature`, `max_tokens`, `top_p`, `tools`, `tool_choice`,
+    `stream`, `response_format`, etc.
+    """
+
+    messages: List[FlexibleMessage]
+    """A list of messages comprising the conversation.
+
+    Each message must have a valid role. Additional fields like `content`,
+    `tool_calls`, etc. are provider-specific.
+    """
+
+    model: str
+    """
+    The model identifier used for this request (e.g., 'gpt-4', 'llama-3-70b',
+    'claude-3-opus').
+    """
+
+    if TYPE_CHECKING:
+        # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a
+        # value to this field, so for compatibility we avoid doing it at runtime.
+        __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
+
+        # Stub to indicate that arbitrary properties are accepted.
+        # To access properties that are not valid identifiers you can use `getattr`, e.g.
+        # `getattr(obj, '$type')`
+        def __getattr__(self, attr: str) -> object: ...
+    else:
+        __pydantic_extra__: Dict[str, object]

nemo_platform/types/intake/flexible_entry_request_param.py

@@ -0,0 +1,51 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Required, TypedDict
+
+from .flexible_message_param import FlexibleMessageParam
+
+__all__ = ["FlexibleEntryRequestParam"]
+
+
+class FlexibleEntryRequestParam(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
+    """Flexible entry request that accepts any object shape.
+
+    This flexibility enables the Intake service to store requests from various LLM providers
+    (OpenAI, Anthropic, NIM, etc.) and future model types (embeddings, multimodal, etc.)
+    without requiring schema updates.
+
+    Required fields: `messages` and `model`
+    Common optional fields: `temperature`, `max_tokens`, `top_p`, `tools`, `tool_choice`,
+    `stream`, `response_format`, etc.
+    """
+
+    messages: Required[Iterable[FlexibleMessageParam]]
+    """A list of messages comprising the conversation.
+
+    Each message must have a valid role. Additional fields like `content`,
+    `tool_calls`, etc. are provider-specific.
+    """
+
+    model: Required[str]
+    """
+    The model identifier used for this request (e.g., 'gpt-4', 'llama-3-70b',
+    'claude-3-opus').
+    """

nemo_platform/types/intake/flexible_entry_response.py

@@ -0,0 +1,62 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import TYPE_CHECKING, Dict, List, Optional
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["FlexibleEntryResponse"]
+
+
+class FlexibleEntryResponse(BaseModel):
+    """Flexible entry response that accepts any object shape.
+
+    This flexibility enables the Intake service to store responses from various LLM providers
+    and future model types without requiring schema updates.
+
+    Required: either `choices` (successful response) or `error` (failed call).
+    Common optional fields: `id`, `created`, `model`, `usage`, `system_fingerprint`, etc.
+    """
+
+    choices: Optional[List[Dict[str, object]]] = None
+    """A list of response choices generated by the model.
+
+    Each choice typically contains a message object with role, content, and optional
+    tool_calls. The structure varies by provider but commonly includes fields like
+    `index`, `message`, and `finish_reason`.
+    """
+
+    error: Optional[Dict[str, object]] = None
+    """
+    Error envelope returned by the provider when the call failed (e.g., OpenAI's
+    `{message, type, code, param}` shape). Mutually exclusive with `choices`: a
+    response carries one or the other.
+    """
+
+    if TYPE_CHECKING:
+        # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a
+        # value to this field, so for compatibility we avoid doing it at runtime.
+        __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
+
+        # Stub to indicate that arbitrary properties are accepted.
+        # To access properties that are not valid identifiers you can use `getattr`, e.g.
+        # `getattr(obj, '$type')`
+        def __getattr__(self, attr: str) -> object: ...
+    else:
+        __pydantic_extra__: Dict[str, object]

nemo_platform/types/intake/flexible_entry_response_param.py

@@ -0,0 +1,49 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Iterable
+from typing_extensions import TypedDict
+
+__all__ = ["FlexibleEntryResponseParam"]
+
+
+class FlexibleEntryResponseParam(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
+    """Flexible entry response that accepts any object shape.
+
+    This flexibility enables the Intake service to store responses from various LLM providers
+    and future model types without requiring schema updates.
+
+    Required: either `choices` (successful response) or `error` (failed call).
+    Common optional fields: `id`, `created`, `model`, `usage`, `system_fingerprint`, etc.
+    """
+
+    choices: Iterable[Dict[str, object]]
+    """A list of response choices generated by the model.
+
+    Each choice typically contains a message object with role, content, and optional
+    tool_calls. The structure varies by provider but commonly includes fields like
+    `index`, `message`, and `finish_reason`.
+    """
+
+    error: Dict[str, object]
+    """
+    Error envelope returned by the provider when the call failed (e.g., OpenAI's
+    `{message, type, code, param}` shape). Mutually exclusive with `choices`: a
+    response carries one or the other.
+    """

nemo_platform/types/intake/flexible_message.py

@@ -0,0 +1,56 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import TYPE_CHECKING, Dict
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+from .message_role import MessageRole
+
+__all__ = ["FlexibleMessage"]
+
+
+class FlexibleMessage(BaseModel):
+    """
+    A flexible message model that requires a valid role field but allows any other fields.
+
+    This flexibility enables the Intake service to store messages from various LLM providers
+    and future model types without requiring schema updates. Additional fields like `content`,
+    `name`, `tool_calls`, `tool_call_id`, etc. are all accepted.
+
+    Examples of additional fields:
+    - `content`: The message text or content
+    - `name`: Name of the user or function
+    - `tool_calls`: Tool/function calls in the message
+    - `tool_call_id`: ID of the tool call being responded to
+    """
+
+    role: MessageRole
+    """Valid role values for entry request messages."""
+
+    if TYPE_CHECKING:
+        # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a
+        # value to this field, so for compatibility we avoid doing it at runtime.
+        __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
+
+        # Stub to indicate that arbitrary properties are accepted.
+        # To access properties that are not valid identifiers you can use `getattr`, e.g.
+        # `getattr(obj, '$type')`
+        def __getattr__(self, attr: str) -> object: ...
+    else:
+        __pydantic_extra__: Dict[str, object]

nemo_platform/types/intake/flexible_message_param.py

@@ -0,0 +1,43 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+from .message_role import MessageRole
+
+__all__ = ["FlexibleMessageParam"]
+
+
+class FlexibleMessageParam(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
+    """
+    A flexible message model that requires a valid role field but allows any other fields.
+
+    This flexibility enables the Intake service to store messages from various LLM providers
+    and future model types without requiring schema updates. Additional fields like `content`,
+    `name`, `tool_calls`, `tool_call_id`, etc. are all accepted.
+
+    Examples of additional fields:
+    - `content`: The message text or content
+    - `name`: Name of the user or function
+    - `tool_calls`: Tool/function calls in the message
+    - `tool_call_id`: ID of the tool call being responded to
+    """
+
+    role: Required[MessageRole]
+    """Valid role values for entry request messages."""