@josephyan/qingflow-app-builder-mcp 0.2.0-beta.49 → 0.2.0-beta.50

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-builder-mcp@0.2.0-beta.49
+npm install @josephyan/qingflow-app-builder-mcp@0.2.0-beta.50
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-builder-mcp@0.2.0-beta.49 qingflow-app-builder-mcp
+npx -y -p @josephyan/qingflow-app-builder-mcp@0.2.0-beta.50 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-builder-mcp",
-  "version": "0.2.0-beta.49",
+  "version": "0.2.0-beta.50",
   "description": "Builder MCP for Qingflow app/package/system design and staged solution workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "0.2.0b49"
+version = "0.2.0b50"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/builder_facade/models.py

@@ -28,6 +28,11 @@ class PublicFieldType(str, Enum):
     subtable = "subtable"
 
 
+class PublicRelationMode(str, Enum):
+    single = "single"
+    multiple = "multiple"
+
+
 FIELD_TYPE_ALIASES: dict[str, PublicFieldType] = {
     "textarea": PublicFieldType.long_text,
     "amount": PublicFieldType.amount,
@@ -268,6 +273,7 @@ class FieldPatch(StrictModel):
     target_app_key: str | None = None
     display_field: FieldSelector | None = None
     visible_fields: list[FieldSelector] = Field(default_factory=list)
+    relation_mode: PublicRelationMode | None = Field(default=None, validation_alias=AliasChoices("relation_mode", "relationMode", "selection_mode", "selectionMode"))
     subfields: list["FieldPatch"] = Field(default_factory=list)
 
     @model_validator(mode="after")
@@ -276,8 +282,8 @@ class FieldPatch(StrictModel):
             raise ValueError("relation field requires target_app_key")
         if self.type != PublicFieldType.relation and self.target_app_key:
             raise ValueError("target_app_key is only allowed for relation fields")
-        if self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields):
-            raise ValueError("display_field and visible_fields are only allowed for relation fields")
+        if self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields or self.relation_mode is not None):
+            raise ValueError("display_field, visible_fields, and relation_mode are only allowed for relation fields")
         if self.type == PublicFieldType.subtable and not self.subfields:
             raise ValueError("subtable field requires subfields")
         if self.type != PublicFieldType.subtable and self.subfields:
@@ -299,14 +305,15 @@ class FieldMutation(StrictModel):
     target_app_key: str | None = None
     display_field: FieldSelector | None = None
     visible_fields: list[FieldSelector] | None = None
+    relation_mode: PublicRelationMode | None = Field(default=None, validation_alias=AliasChoices("relation_mode", "relationMode", "selection_mode", "selectionMode"))
     subfields: list[FieldPatch] | None = None
 
     @model_validator(mode="after")
     def validate_shape(self) -> "FieldMutation":
         if self.type == PublicFieldType.relation and not self.target_app_key:
             raise ValueError("relation field requires target_app_key")
-        if self.type is not None and self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields):
-            raise ValueError("display_field and visible_fields are only allowed for relation fields")
+        if self.type is not None and self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields or self.relation_mode is not None):
+            raise ValueError("display_field, visible_fields, and relation_mode are only allowed for relation fields")
         if self.type == PublicFieldType.subtable and not self.subfields:
             raise ValueError("subtable field requires subfields")
         return self
@@ -915,11 +922,30 @@ def _normalize_field_payload(value: Any) -> Any:
         normalized_from_id = FIELD_TYPE_ID_ALIASES.get(raw_type)
         if normalized_from_id is not None:
             payload["type"] = normalized_from_id.value
-            return payload
     if isinstance(raw_type, str):
         normalized = FIELD_TYPE_ALIASES.get(raw_type.strip().lower())
         if normalized is not None:
             payload["type"] = normalized.value
+    normalized_relation_mode = _normalize_public_relation_mode(
+        payload.get("relation_mode", payload.get("relationMode", payload.get("selection_mode", payload.get("selectionMode"))))
+    )
+    if normalized_relation_mode is None:
+        for alias_key in ("optional_data_num", "optionalDataNum", "multiple", "allow_multiple"):
+            if alias_key in payload:
+                normalized_relation_mode = _normalize_public_relation_mode(payload.get(alias_key))
+                break
+    if normalized_relation_mode is not None:
+        payload["relation_mode"] = normalized_relation_mode
+    for alias_key in (
+        "relationMode",
+        "selection_mode",
+        "selectionMode",
+        "optional_data_num",
+        "optionalDataNum",
+        "multiple",
+        "allow_multiple",
+    ):
+        payload.pop(alias_key, None)
     return payload
 
 
@@ -927,3 +953,33 @@ def _slugify_title(title: str) -> str:
     normalized = "".join(ch.lower() if ch.isalnum() else "_" for ch in str(title or ""))
     collapsed = "_".join(part for part in normalized.split("_") if part)
     return collapsed or "section"
+
+
+def _normalize_public_relation_mode(value: Any) -> str | None:
+    if value is None:
+        return None
+    if isinstance(value, bool):
+        return PublicRelationMode.multiple.value if value else PublicRelationMode.single.value
+    if isinstance(value, int):
+        if value == 0:
+            return PublicRelationMode.multiple.value
+        if value == 1:
+            return PublicRelationMode.single.value
+        return None
+    if isinstance(value, str):
+        normalized = value.strip().lower()
+        aliases = {
+            "single": PublicRelationMode.single.value,
+            "single_select": PublicRelationMode.single.value,
+            "single-select": PublicRelationMode.single.value,
+            "one": PublicRelationMode.single.value,
+            "1": PublicRelationMode.single.value,
+            "multiple": PublicRelationMode.multiple.value,
+            "multi": PublicRelationMode.multiple.value,
+            "multi_select": PublicRelationMode.multiple.value,
+            "multi-select": PublicRelationMode.multiple.value,
+            "many": PublicRelationMode.multiple.value,
+            "0": PublicRelationMode.multiple.value,
+        }
+        return aliases.get(normalized, normalized or None)
+    return None