feat: Move ModelDeploymentCard to _internal (#6378)

Signed-off-by: tzulingk@nvidia.com <tzulingk@nvidia.com>

components/src/dynamo/frontend/vllm_processor.py

@@ -24,11 +24,11 @@ from vllm.v1.engine import EngineCoreOutput, EngineCoreRequest, FinishReason
 from vllm.v1.engine.input_processor import InputProcessor
 from vllm.v1.engine.output_processor import OutputProcessor, OutputProcessorOutput
 
+from dynamo._internal import ModelDeploymentCard
 from dynamo.frontend.frontend_args import FrontendConfig
 from dynamo.llm import (
     KvRouter,
     ModelCardInstanceId,
-    ModelDeploymentCard,
     PythonAsyncEngine,
     RouterConfig,
     RouterMode,

lib/bindings/python/rust/lib.rs

@@ -162,7 +162,7 @@ fn _core(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_class::<llm::entrypoint::RouterConfig>()?;
     m.add_class::<llm::entrypoint::KvRouterConfig>()?;
     m.add_class::<llm::kv::WorkerMetricsPublisher>()?;
-    m.add_class::<llm::model_card::ModelDeploymentCard>()?;
+    m.add_class::<llm::model_card::ModelDeploymentCard>()?; // Internal: only in _internal, not public API
     m.add_class::<llm::local_model::ModelRuntimeConfig>()?;
     m.add_class::<llm::preprocessor::MediaDecoder>()?;
     m.add_class::<llm::preprocessor::MediaFetcher>()?;

lib/bindings/python/src/dynamo/_internal/__init__.py

+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+"""
+Internal bindings for Dynamo components.
+
+These classes are used by internal Dynamo components (components/) and are not
+part of the stable public API. They may change without notice.
+
+For public APIs, use dynamo.runtime and dynamo.llm.
+"""
+
+# Re-export from _core
+from dynamo._core import ModelDeploymentCard as ModelDeploymentCard
+
+__all__ = [
+    "ModelDeploymentCard",
+]

lib/bindings/python/src/dynamo/_internal/__init__.pyi

+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+# Type stubs - re-export from _core
+from dynamo._core import ModelDeploymentCard as ModelDeploymentCard
+
+__all__ = [
+    "ModelDeploymentCard",
+]

lib/bindings/python/src/dynamo/_internal/py.typed

+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+# PEP 561 marker file indicating this package is typed

lib/bindings/python/src/dynamo/llm/__init__.py

@@ -17,7 +17,6 @@ from dynamo._core import LoRADownloader as LoRADownloader
 from dynamo._core import MediaDecoder as MediaDecoder
 from dynamo._core import MediaFetcher as MediaFetcher
 from dynamo._core import ModelCardInstanceId as ModelCardInstanceId
-from dynamo._core import ModelDeploymentCard as ModelDeploymentCard
 from dynamo._core import ModelInput as ModelInput
 from dynamo._core import ModelRuntimeConfig as ModelRuntimeConfig
 from dynamo._core import ModelType as ModelType

lib/bindings/python/src/dynamo/runtime/__init__.py

@@ -15,7 +15,6 @@ from dynamo._core import Component as Component
 from dynamo._core import Context as Context
 from dynamo._core import DistributedRuntime as DistributedRuntime
 from dynamo._core import Endpoint as Endpoint
-from dynamo._core import ModelDeploymentCard as ModelDeploymentCard
 from dynamo._core import Namespace as Namespace