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

nemo_platform/types/inference/virtual_model.py

@@ -0,0 +1,91 @@
+# 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 List, Optional
+from datetime import datetime
+
+from ..._models import BaseModel
+from .middleware_call import MiddlewareCall
+from .virtual_model_inference_config import VirtualModelInferenceConfig
+
+__all__ = ["VirtualModel"]
+
+
+class VirtualModel(BaseModel):
+    """Logical inference route.
+
+    Maps a user-facing model name to an optional default model entity and
+    defines ordered middleware pipelines for the request, response, and
+    post-response phases.
+
+    When a caller sets ``model: "workspace/my-virtual-model"`` in an inference
+    request, IGW resolves the ``VirtualModel`` instead of a ``ModelEntity``
+    directly. If ``default_model_entity`` is set, IGW writes it into
+    ``request["model"]`` before the request middleware pipeline runs. Middleware
+    may mutate ``request["model"]`` freely. After the pipeline completes, IGW
+    reads ``request["model"]``, resolves it to a ``ModelProvider`` via the
+    ``ModelCache``, and proxies.
+
+    The ``ModelProviderReconciler`` auto-creates a passthrough ``VirtualModel``
+    for each discovered model (same workspace and name as the ``ModelEntity``,
+    empty middleware lists, ``default_model_entity`` pointing to that entity).
+    All existing inference requests continue to work without changes.
+    """
+
+    id: str
+
+    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"""
+
+    autoprovisioned: Optional[bool] = None
+    """Marks this VirtualModel as controller-managed.
+
+    The Models controller will delete it once no ModelProvider serves the matching
+    entity. Setting this manually opts the VirtualModel into that cleanup behavior.
+    """
+
+    default_model_entity: Optional[str] = None
+
+    models: Optional[List[VirtualModelInferenceConfig]] = None
+
+    name: Optional[str] = None
+    """Entity name within the workspace"""
+
+    override_proxy: Optional[str] = None
+
+    post_response_middleware: Optional[List[MiddlewareCall]] = None
+
+    project: Optional[str] = None
+    """The name of the project associated with this entity."""
+
+    request_middleware: Optional[List[MiddlewareCall]] = None
+
+    response_middleware: Optional[List[MiddlewareCall]] = None

nemo_platform/types/inference/virtual_model_create_params.py

@@ -0,0 +1,83 @@
+# 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 .middleware_call_param import MiddlewareCallParam
+from .virtual_model_inference_config_param import VirtualModelInferenceConfigParam
+
+__all__ = ["VirtualModelCreateParams"]
+
+
+class VirtualModelCreateParams(TypedDict, total=False):
+    workspace: str
+
+    name: Required[str]
+    """Name of the virtual model within the workspace. Must be unique per workspace."""
+
+    autoprovisioned: bool
+    """Marks this VirtualModel as controller-managed.
+
+    The Models controller will delete it once no ModelProvider serves the matching
+    entity. Setting this manually opts the VirtualModel into that cleanup behavior.
+    """
+
+    default_model_entity: str
+    """Model entity to route to, in "workspace/name" format.
+
+    Written into request["model"] before the request middleware pipeline runs. If
+    omitted, a request middleware plugin must handle backend routing itself. Set to
+    null to clear an existing value.
+    """
+
+    models: Iterable[VirtualModelInferenceConfigParam]
+    """Model entity references used by this VirtualModel.
+
+    A per-entry backend_format overrides the referenced ModelEntity backend_format
+    when IGW resolves the backend format for a request.
+    """
+
+    override_proxy: str
+    """
+    Plugin-provided proxy implementation for IGW to use instead of its default
+    aiohttp proxy. Format: "plugin-name.proxy-name". Leave unset to use the default
+    IGW proxy. Set to null to clear an existing value.
+    """
+
+    post_response_middleware: Iterable[MiddlewareCallParam]
+    """
+    Ordered list of middleware plugins invoked after the response has been returned
+    to the caller. Intended for fire-and-forget work (logging, analytics) that must
+    not block or modify the response.
+    """
+
+    request_middleware: Iterable[MiddlewareCallParam]
+    """Ordered list of middleware plugins applied before proxying to the backend.
+
+    Each entry is a MiddlewareCall with a "name" (plugin identifier) and optional
+    "config_type" and "config_id" fields that reference a stored plugin
+    configuration.
+    """
+
+    response_middleware: Iterable[MiddlewareCallParam]
+    """
+    Ordered list of middleware plugins applied after the backend response is
+    received, before returning it to the caller.
+    """

nemo_platform/types/inference/virtual_model_inference_config.py

@@ -0,0 +1,32 @@
+# 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
+from ..shared.backend_format import BackendFormat
+
+__all__ = ["VirtualModelInferenceConfig"]
+
+
+class VirtualModelInferenceConfig(BaseModel):
+    """Inference configuration for one model entity referenced by a VirtualModel."""
+
+    model: str
+
+    backend_format: Optional[BackendFormat] = None
+    """Inference backend API wire formats understood by IGW and middleware plugins."""

nemo_platform/types/inference/virtual_model_inference_config_param.py

@@ -0,0 +1,34 @@
+# 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 Optional
+from typing_extensions import Required, TypedDict
+
+from ..shared.backend_format import BackendFormat
+
+__all__ = ["VirtualModelInferenceConfigParam"]
+
+
+class VirtualModelInferenceConfigParam(TypedDict, total=False):
+    """Inference configuration for one model entity referenced by a VirtualModel."""
+
+    model: Required[str]
+
+    backend_format: Optional[BackendFormat]
+    """Inference backend API wire formats understood by IGW and middleware plugins."""

nemo_platform/types/inference/virtual_model_list_params.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 __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["VirtualModelListParams"]
+
+
+class VirtualModelListParams(TypedDict, total=False):
+    workspace: str
+
+    page: int
+    """Page number (1-indexed)."""
+
+    page_size: int
+    """Number of results per page."""
+
+    sort: str
+    """Sort field. Prefix with `-` for descending order."""

nemo_platform/types/inference/virtual_model_patch_params.py

@@ -0,0 +1,80 @@
+# 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 TypedDict
+
+from .middleware_call_param import MiddlewareCallParam
+from .virtual_model_inference_config_param import VirtualModelInferenceConfigParam
+
+__all__ = ["VirtualModelPatchParams"]
+
+
+class VirtualModelPatchParams(TypedDict, total=False):
+    workspace: str
+
+    autoprovisioned: bool
+    """Marks this VirtualModel as controller-managed.
+
+    The Models controller will delete it once no ModelProvider serves the matching
+    entity. Setting this manually opts the VirtualModel into that cleanup behavior.
+    """
+
+    default_model_entity: str
+    """Model entity to route to, in "workspace/name" format.
+
+    Written into request["model"] before the request middleware pipeline runs. If
+    omitted, a request middleware plugin must handle backend routing itself. Set to
+    null to clear an existing value.
+    """
+
+    models: Iterable[VirtualModelInferenceConfigParam]
+    """Model entity references used by this VirtualModel.
+
+    A per-entry backend_format overrides the referenced ModelEntity backend_format
+    when IGW resolves the backend format for a request.
+    """
+
+    override_proxy: str
+    """
+    Plugin-provided proxy implementation for IGW to use instead of its default
+    aiohttp proxy. Format: "plugin-name.proxy-name". Leave unset to use the default
+    IGW proxy. Set to null to clear an existing value.
+    """
+
+    post_response_middleware: Iterable[MiddlewareCallParam]
+    """
+    Ordered list of middleware plugins invoked after the response has been returned
+    to the caller. Intended for fire-and-forget work (logging, analytics) that must
+    not block or modify the response.
+    """
+
+    request_middleware: Iterable[MiddlewareCallParam]
+    """Ordered list of middleware plugins applied before proxying to the backend.
+
+    Each entry is a MiddlewareCall with a "name" (plugin identifier) and optional
+    "config_type" and "config_id" fields that reference a stored plugin
+    configuration.
+    """
+
+    response_middleware: Iterable[MiddlewareCallParam]
+    """
+    Ordered list of middleware plugins applied after the backend response is
+    received, before returning it to the caller.
+    """

nemo_platform/types/inference/virtual_models_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 .virtual_model import VirtualModel
+from ..shared.pagination_data import PaginationData
+
+__all__ = ["VirtualModelsPage"]
+
+
+class VirtualModelsPage(BaseModel):
+    data: List[VirtualModel]
+
+    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/__init__.py

@@ -0,0 +1,86 @@
+# 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 .app import App as App
+from .span import Span as Span
+from .entry import Entry as Entry
+from .trace import Trace as Trace
+from .usage import Usage as Usage
+from .apps_page import AppsPage as AppsPage
+from .span_kind import SpanKind as SpanKind
+from .entry_data import EntryData as EntryData
+from .spans_page import SpansPage as SpansPage
+from .entrys_page import EntrysPage as EntrysPage
+from .span_status import SpanStatus as SpanStatus
+from .traces_page import TracesPage as TracesPage
+from .usage_param import UsageParam as UsageParam
+from .user_rating import UserRating as UserRating
+from .message_role import MessageRole as MessageRole
+from .entry_context import EntryContext as EntryContext
+from .app_sort_field import AppSortField as AppSortField
+from .app_list_params import AppListParams as AppListParams
+from .span_sort_field import SpanSortField as SpanSortField
+from .thumb_direction import ThumbDirection as ThumbDirection
+from .app_filter_param import AppFilterParam as AppFilterParam
+from .app_patch_params import AppPatchParams as AppPatchParams
+from .entry_data_param import EntryDataParam as EntryDataParam
+from .entry_sort_field import EntrySortField as EntrySortField
+from .evaluator_result import EvaluatorResult as EvaluatorResult
+from .flexible_message import FlexibleMessage as FlexibleMessage
+from .span_list_params import SpanListParams as SpanListParams
+from .trace_sort_field import TraceSortField as TraceSortField
+from .app_create_params import AppCreateParams as AppCreateParams
+from .entry_list_params import EntryListParams as EntryListParams
+from .span_filter_param import SpanFilterParam as SpanFilterParam
+from .trace_list_params import TraceListParams as TraceListParams
+from .user_action_event import UserActionEvent as UserActionEvent
+from .user_rating_param import UserRatingParam as UserRatingParam
+from .entry_filter_param import EntryFilterParam as EntryFilterParam
+from .entry_patch_params import EntryPatchParams as EntryPatchParams
+from .float_filter_param import FloatFilterParam as FloatFilterParam
+from .trace_filter_param import TraceFilterParam as TraceFilterParam
+from .entry_context_param import EntryContextParam as EntryContextParam
+from .entry_create_params import EntryCreateParams as EntryCreateParams
+from .export_config_param import ExportConfigParam as ExportConfigParam
+from .user_feedback_event import UserFeedbackEvent as UserFeedbackEvent
+from .export_preview_params import ExportPreviewParams as ExportPreviewParams
+from .trace_retrieve_params import TraceRetrieveParams as TraceRetrieveParams
+from .evaluator_result_event import EvaluatorResultEvent as EvaluatorResultEvent
+from .evaluator_results_page import EvaluatorResultsPage as EvaluatorResultsPage
+from .flexible_entry_request import FlexibleEntryRequest as FlexibleEntryRequest
+from .flexible_message_param import FlexibleMessageParam as FlexibleMessageParam
+from .export_preview_response import ExportPreviewResponse as ExportPreviewResponse
+from .flexible_entry_response import FlexibleEntryResponse as FlexibleEntryResponse
+from .span_evaluation_context import SpanEvaluationContext as SpanEvaluationContext
+from .user_action_event_param import UserActionEventParam as UserActionEventParam
+from .evaluation_context_param import EvaluationContextParam as EvaluationContextParam
+from .export_config_param_param import ExportConfigParamParam as ExportConfigParamParam
+from .reviewer_annotation_event import ReviewerAnnotationEvent as ReviewerAnnotationEvent
+from .user_feedback_event_param import UserFeedbackEventParam as UserFeedbackEventParam
+from .entry_context_filter_param import EntryContextFilterParam as EntryContextFilterParam
+from .evaluator_result_data_type import EvaluatorResultDataType as EvaluatorResultDataType
+from .evaluator_result_sort_field import EvaluatorResultSortField as EvaluatorResultSortField
+from .evaluator_result_event_param import EvaluatorResultEventParam as EvaluatorResultEventParam
+from .evaluator_result_list_params import EvaluatorResultListParams as EvaluatorResultListParams
+from .flexible_entry_request_param import FlexibleEntryRequestParam as FlexibleEntryRequestParam
+from .evaluator_result_filter_param import EvaluatorResultFilterParam as EvaluatorResultFilterParam
+from .flexible_entry_response_param import FlexibleEntryResponseParam as FlexibleEntryResponseParam
+from .entry_user_rating_filter_param import EntryUserRatingFilterParam as EntryUserRatingFilterParam
+from .evaluator_result_create_params import EvaluatorResultCreateParams as EvaluatorResultCreateParams
+from .reviewer_annotation_event_param import ReviewerAnnotationEventParam as ReviewerAnnotationEventParam

nemo_platform/types/intake/app.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 typing import Optional
+from datetime import datetime
+
+from ..._models import BaseModel
+
+__all__ = ["App"]
+
+
+class App(BaseModel):
+    """Schema for App responses."""
+
+    id: str
+    """Unique identifier"""
+
+    name: str
+    """App name"""
+
+    workspace: str
+    """Workspace identifier"""
+
+    created_at: Optional[datetime] = None
+    """Creation timestamp"""
+
+    description: Optional[str] = None
+    """App description"""
+
+    locked: Optional[bool] = None
+    """Lock status"""
+
+    project: Optional[str] = None
+    """The name of the project associated with this app"""
+
+    updated_at: Optional[datetime] = None
+    """Last update timestamp"""

nemo_platform/types/intake/app_create_params.py

@@ -0,0 +1,38 @@
+# 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
+
+__all__ = ["AppCreateParams"]
+
+
+class AppCreateParams(TypedDict, total=False):
+    workspace: str
+
+    name: Required[str]
+    """App name (unique within workspace)"""
+
+    description: str
+    """App description"""
+
+    locked: bool
+    """If true, this record cannot be automatically updated when entries are ingested."""
+
+    project: str
+    """The name of the project associated with this app"""

nemo_platform/types/intake/app_filter_param.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 ..shared_params.datetime_filter import DatetimeFilter
+
+__all__ = ["AppFilterParam"]
+
+
+class AppFilterParam(TypedDict, total=False):
+    """Filter for Apps."""
+
+    created_at: DatetimeFilter
+    """Filter entities based on creation date."""
+
+    description: str
+    """Filter by app description."""
+
+    name: str
+    """Filter by app name."""
+
+    project: str
+    """Filter by project name."""
+
+    updated_at: DatetimeFilter
+    """Filter entities based on update date."""
+
+    workspace: str
+    """Filter by workspace id."""

nemo_platform/types/intake/app_list_params.py

@@ -0,0 +1,44 @@
+# 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 .app_sort_field import AppSortField
+from .app_filter_param import AppFilterParam
+
+__all__ = ["AppListParams"]
+
+
+class AppListParams(TypedDict, total=False):
+    workspace: str
+
+    filter: AppFilterParam
+    """Filter apps by name, description, project, created_at, and updated_at."""
+
+    page: int
+    """Page number."""
+
+    page_size: int
+    """Page size."""
+
+    sort: AppSortField
+    """The field to sort by.
+
+    To sort in decreasing order, use `-` in front of the field name.
+    """