fix(BA-5986): make ModelMountConfigInput.definition_path nullable (#11537)

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: seedspirit

changes/11537.fix.md

@@ -0,0 +1 @@
+Allow `ModelMountConfigInput.definition_path` to be omitted so the server auto-detects `model-definition.yaml` or `model-definition.yml` in the model vfolder

docs/manager/graphql-reference/supergraph.graphql

@@ -9558,7 +9558,7 @@ input ModelMountConfigInput
 {
   vfolderId: ID!
   mountDestination: String!
-  definitionPath: String!
+  definitionPath: String = null
 }
 
 """

docs/manager/graphql-reference/v2-schema.graphql

@@ -6337,7 +6337,7 @@ type ModelMountConfig {
 input ModelMountConfigInput {
   vfolderId: ID!
   mountDestination: String!
-  definitionPath: String!
+  definitionPath: String = null
 }
 
 """

src/ai/backend/common/dto/manager/deployment/request.py

@@ -238,7 +238,14 @@ class ModelMountConfigInput(BaseRequestModel):
 
     vfolder_id: VFolderUUID = Field(description="Model vfolder ID")
     mount_destination: str = Field(default="/models", description="Mount destination path")
-    definition_path: str = Field(description="Model definition file path within vfolder")
+    definition_path: str | None = Field(
+        default=None,
+        description=(
+            "Optional model definition file path within vfolder. "
+            "When omitted, the server auto-detects `model-definition.yaml` or "
+            "`model-definition.yml`."
+        ),
+    )
 
 
 class ModelRuntimeConfigInput(BaseRequestModel):

src/ai/backend/common/dto/manager/v2/deployment/request.py

@@ -202,7 +202,14 @@ class ModelMountConfigInput(BaseRequestModel):
 
     vfolder_id: VFolderUUID = Field(description="VFolder ID for the model")
     mount_destination: str = Field(description="Mount destination path inside container")
-    definition_path: str = Field(description="Path to model definition file")
+    definition_path: str | None = Field(
+        default=None,
+        description=(
+            "Optional path to the model definition file within the model vfolder. "
+            "When omitted, the server auto-detects `model-definition.yaml` or "
+            "`model-definition.yml`."
+        ),
+    )
 
 
 class ExtraVFolderMountInput(BaseRequestModel):

src/ai/backend/manager/api/gql/deployment/types/revision.py

@@ -787,7 +787,7 @@ class ModelRuntimeConfigInput(PydanticInputMixin[ModelRuntimeConfigInputDTO]):
 class ModelMountConfigInput(PydanticInputMixin[ModelMountConfigInputDTO]):
     vfolder_id: ID
     mount_destination: str
-    definition_path: str
+    definition_path: str | None = None
 
 
 @gql_pydantic_input(