@qingflow-tech/qingflow-app-user-mcp 1.0.6 → 1.0.7

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-user-mcp@1.0.6
+npm install @qingflow-tech/qingflow-app-user-mcp@1.0.7
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-user-mcp@1.0.6 qingflow-app-user-mcp
+npx -y -p @qingflow-tech/qingflow-app-user-mcp@1.0.7 qingflow-app-user-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-app-user-mcp",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Operational end-user MCP for Qingflow records, tasks, comments, and directory workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

package/src/qingflow_mcp/builder_facade/models.py

@@ -115,6 +115,13 @@ class PublicViewButtonType(str, Enum):
 class PublicViewButtonConfigType(str, Enum):
     top = "TOP"
     detail = "DETAIL"
+    list = "LIST"
+
+
+class PublicButtonPlacement(str, Enum):
+    header = "header"
+    detail = "detail"
+    list = "list"
 
 
 class PublicChartType(str, Enum):
@@ -739,6 +746,8 @@ class FieldPatch(StrictModel):
         default=None,
         validation_alias=AliasChoices("custom_button_text", "customButtonText", "custom_btn_text", "customBtnText"),
     )
+    as_data_title: bool | None = Field(default=None, validation_alias=AliasChoices("as_data_title", "asDataTitle"))
+    as_data_cover: bool | None = Field(default=None, validation_alias=AliasChoices("as_data_cover", "asDataCover"))
     subfields: list["FieldPatch"] = Field(default_factory=list)
 
     @model_validator(mode="after")
@@ -819,6 +828,8 @@ class FieldMutation(StrictModel):
         default=None,
         validation_alias=AliasChoices("custom_button_text", "customButtonText", "custom_btn_text", "customBtnText"),
     )
+    as_data_title: bool | None = Field(default=None, validation_alias=AliasChoices("as_data_title", "asDataTitle"))
+    as_data_cover: bool | None = Field(default=None, validation_alias=AliasChoices("as_data_cover", "asDataCover"))
     subfields: list[FieldPatch] | None = None
     subfield_updates: list["FieldUpdatePatch"] | None = Field(
         default=None,
@@ -1013,6 +1024,27 @@ class FlowTransitionPatch(StrictModel):
     target: str = Field(alias="to")
 
 
+class ViewQueryConditionsPatch(StrictModel):
+    enabled: bool = Field(default=True, validation_alias=AliasChoices("enabled", "queryConditionStatus", "status"))
+    exact: bool = Field(default=False, validation_alias=AliasChoices("exact", "queryConditionExact"))
+    hide_before_query: bool = Field(default=False, validation_alias=AliasChoices("hide_before_query", "hideBeforeQuery", "hideBeforeQueryCondition"))
+    rows: list[list[str | int]] = Field(default_factory=list, validation_alias=AliasChoices("rows", "fields", "queryCondition"))
+
+
+class ViewAssociatedResourcesPatch(StrictModel):
+    visible: bool = Field(default=True, validation_alias=AliasChoices("visible", "enabled", "asosChartVisible"))
+    limit_type: str | None = Field(default=None, validation_alias=AliasChoices("limit_type", "limitType"))
+    associated_item_ids: list[Any] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices(
+            "associated_item_ids",
+            "associatedItemIds",
+            "asosChartIdList",
+            "items",
+        ),
+    )
+
+
 class ViewUpsertPatch(StrictModel):
     name: str
     view_key: str | None = Field(default=None, validation_alias=AliasChoices("view_key", "viewKey"))
@@ -1025,6 +1057,17 @@ class ViewUpsertPatch(StrictModel):
     title_field: str | None = Field(default=None, validation_alias=AliasChoices("title_field", "titleField"))
     buttons: list["ViewButtonBindingPatch"] | None = None
     visibility: VisibilityPatch | None = None
+    query_conditions: ViewQueryConditionsPatch | None = Field(default=None, validation_alias=AliasChoices("query_conditions", "queryConditions", "query_condition", "queryCondition"))
+    associated_resources: ViewAssociatedResourcesPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices(
+            "associated_resources",
+            "associatedResources",
+            "associated_reports",
+            "associatedReports",
+            "asosChartConfig",
+        ),
+    )
 
     @model_validator(mode="before")
     @classmethod
@@ -1042,6 +1085,20 @@ class ViewUpsertPatch(StrictModel):
             payload["filters"] = payload.pop("filter_rules")
         if "filterRules" in payload and "filters" not in payload:
             payload["filters"] = payload.pop("filterRules")
+        if "queryConditions" in payload and "query_conditions" not in payload:
+            payload["query_conditions"] = payload.pop("queryConditions")
+        if "query_condition" in payload and "query_conditions" not in payload:
+            payload["query_conditions"] = payload.pop("query_condition")
+        if "queryCondition" in payload and "query_conditions" not in payload:
+            payload["query_conditions"] = payload.pop("queryCondition")
+        if "associatedResources" in payload and "associated_resources" not in payload:
+            payload["associated_resources"] = payload.pop("associatedResources")
+        if "associated_reports" in payload and "associated_resources" not in payload:
+            payload["associated_resources"] = payload.pop("associated_reports")
+        if "associatedReports" in payload and "associated_resources" not in payload:
+            payload["associated_resources"] = payload.pop("associatedReports")
+        if "asosChartConfig" in payload and "associated_resources" not in payload:
+            payload["associated_resources"] = payload.pop("asosChartConfig")
         raw_type = payload.get("type")
         if isinstance(raw_type, str):
             normalized = raw_type.strip().lower()
@@ -1128,13 +1185,29 @@ class CustomButtonMatchRulePatch(StrictModel):
         return payload
 
 
+class CustomButtonFieldMappingPatch(StrictModel):
+    source_field: Any = Field(validation_alias=AliasChoices("source_field", "sourceField", "source"))
+    target_field: Any = Field(validation_alias=AliasChoices("target_field", "targetField", "target"))
+
+
 class CustomButtonAddDataConfigPatch(StrictModel):
-    related_app_key: str | None = Field(default=None, validation_alias=AliasChoices("related_app_key", "relatedAppKey"))
+    related_app_key: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("related_app_key", "relatedAppKey", "target_app_key", "targetAppKey"),
+    )
     related_app_name: str | None = Field(default=None, validation_alias=AliasChoices("related_app_name", "relatedAppName"))
     que_relation: list[CustomButtonMatchRulePatch] = Field(
         default_factory=list,
         validation_alias=AliasChoices("que_relation", "queRelation"),
     )
+    field_mappings: list[CustomButtonFieldMappingPatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("field_mappings", "fieldMappings", "mappings"),
+    )
+    default_values: dict[str, Any] = Field(
+        default_factory=dict,
+        validation_alias=AliasChoices("default_values", "defaultValues", "defaults"),
+    )
 
 
 class CustomButtonExternalQRobotConfigPatch(StrictModel):
@@ -1241,6 +1314,184 @@ class CustomButtonPatch(StrictModel):
         return self
 
 
+class CustomButtonUpsertPatch(CustomButtonPatch):
+    button_id: int | None = Field(default=None, validation_alias=AliasChoices("button_id", "buttonId", "id"))
+    client_key: str | None = Field(default=None, validation_alias=AliasChoices("client_key", "clientKey"))
+
+
+class CustomButtonRemovePatch(StrictModel):
+    button_id: int | None = Field(default=None, validation_alias=AliasChoices("button_id", "buttonId", "id"))
+    button_text: str | None = Field(default=None, validation_alias=AliasChoices("button_text", "buttonText", "name"))
+
+    @model_validator(mode="after")
+    def validate_selector(self) -> "CustomButtonRemovePatch":
+        if self.button_id is None and not str(self.button_text or "").strip():
+            raise ValueError("remove_buttons[] requires button_id or button_text")
+        return self
+
+
+class CustomButtonViewButtonBindingPatch(StrictModel):
+    button_ref: Any = Field(validation_alias=AliasChoices("button_ref", "buttonRef", "button_id", "buttonId", "id"))
+    placement: PublicButtonPlacement = Field(default=PublicButtonPlacement.detail, validation_alias=AliasChoices("placement", "position"))
+    primary: bool = Field(default=False, validation_alias=AliasChoices("primary", "being_main", "beingMain"))
+    button_limit: list[list[ViewFilterRulePatch]] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("button_limit", "buttonLimit", "visible_when", "visibleWhen"),
+    )
+    button_formula: str | None = Field(default=None, validation_alias=AliasChoices("button_formula", "buttonFormula"))
+    button_formula_type: int = Field(default=1, validation_alias=AliasChoices("button_formula_type", "buttonFormulaType"))
+    print_tpls: list[Any] = Field(default_factory=list, validation_alias=AliasChoices("print_tpls", "printTpls"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        raw_placement = payload.get("placement", payload.get("position", payload.get("config_type", payload.get("configType"))))
+        if isinstance(raw_placement, str):
+            normalized = raw_placement.strip().lower()
+            if normalized in {"top", "header"}:
+                payload["placement"] = PublicButtonPlacement.header.value
+            elif normalized in {"detail", "data_detail"}:
+                payload["placement"] = PublicButtonPlacement.detail.value
+            elif normalized in {"list", "row", "row_action"}:
+                payload["placement"] = PublicButtonPlacement.list.value
+        raw_limits = payload.get("button_limit", payload.get("buttonLimit", payload.get("visible_when", payload.get("visibleWhen"))))
+        if isinstance(raw_limits, list) and raw_limits and all(isinstance(item, dict) for item in raw_limits):
+            payload["button_limit"] = [raw_limits]
+        return payload
+
+
+class CustomButtonViewConfigPatch(StrictModel):
+    view_key: str = Field(validation_alias=AliasChoices("view_key", "viewKey", "viewgraphKey", "viewGraphKey"))
+    mode: str = Field(default="merge", validation_alias=AliasChoices("mode", "apply_mode", "applyMode"))
+    buttons: list[CustomButtonViewButtonBindingPatch] = Field(default_factory=list)
+
+    @model_validator(mode="after")
+    def validate_mode(self) -> "CustomButtonViewConfigPatch":
+        normalized = str(self.mode or "").strip().lower()
+        if normalized not in {"merge", "replace"}:
+            raise ValueError("view_configs[].mode must be merge or replace")
+        self.mode = normalized
+        if normalized == "merge" and "buttons" not in getattr(self, "model_fields_set", set()):
+            raise ValueError("view_configs[] in merge mode requires buttons; pass buttons: [] or mode=replace to clear existing bindings")
+        return self
+
+
+class CustomButtonsApplyRequest(StrictModel):
+    app_key: str
+    upsert_buttons: list[CustomButtonUpsertPatch] = Field(default_factory=list)
+    remove_buttons: list[CustomButtonRemovePatch] = Field(default_factory=list)
+    view_configs: list[CustomButtonViewConfigPatch] = Field(default_factory=list)
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "buttons" in payload and "upsert_buttons" not in payload:
+            payload["upsert_buttons"] = payload.pop("buttons")
+        if "upsertButtons" in payload and "upsert_buttons" not in payload:
+            payload["upsert_buttons"] = payload.pop("upsertButtons")
+        if "removeButtons" in payload and "remove_buttons" not in payload:
+            payload["remove_buttons"] = payload.pop("removeButtons")
+        if "viewConfigs" in payload and "view_configs" not in payload:
+            payload["view_configs"] = payload.pop("viewConfigs")
+        return payload
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "CustomButtonsApplyRequest":
+        if not self.upsert_buttons and not self.remove_buttons and not self.view_configs:
+            raise ValueError("custom button apply requires at least one upsert, remove, or view config operation")
+        return self
+
+
+class AssociatedResourceUpsertPatch(StrictModel):
+    client_key: str | None = Field(default=None, validation_alias=AliasChoices("client_key", "clientKey"))
+    associated_item_id: int | None = Field(
+        default=None,
+        validation_alias=AliasChoices("associated_item_id", "associatedItemId", "asosChartId", "id"),
+    )
+    graph_type: str = Field(validation_alias=AliasChoices("graph_type", "graphType"))
+    target_app_key: str = Field(validation_alias=AliasChoices("target_app_key", "targetAppKey", "app_key", "appKey"))
+    chart_key: str | None = Field(default=None, validation_alias=AliasChoices("chart_key", "chartKey"))
+    view_key: str | None = Field(default=None, validation_alias=AliasChoices("view_key", "viewKey", "viewgraphKey", "viewGraphKey"))
+    report_source: str | None = Field(default=None, validation_alias=AliasChoices("report_source", "reportSource"))
+    source_type: str | None = Field(default=None, validation_alias=AliasChoices("source_type", "sourceType"))
+    match_rules: list[CustomButtonMatchRulePatch] = Field(default_factory=list, validation_alias=AliasChoices("match_rules", "matchRules"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "chart_id" in payload and "chart_key" not in payload and "chartKey" not in payload:
+            payload["chart_key"] = str(payload.pop("chart_id"))
+        raw_graph_type = str(payload.get("graph_type", payload.get("graphType", "")) or "").strip().lower()
+        raw_source_type = payload.get("source_type", payload.get("sourceType"))
+        has_report_source = "report_source" in payload or "reportSource" in payload
+        if isinstance(raw_source_type, str):
+            normalized_source = raw_source_type.strip().upper()
+            if normalized_source == "BI_QINGFLOW" and not has_report_source:
+                payload["report_source"] = "app"
+                payload.pop("source_type", None)
+                payload.pop("sourceType", None)
+            elif normalized_source == "BI_DATASET" and not has_report_source:
+                payload["report_source"] = "dataset"
+                payload.pop("source_type", None)
+                payload.pop("sourceType", None)
+            elif normalized_source == "QINGFLOW" and raw_graph_type in {"view", "viewgraph"}:
+                payload.pop("source_type", None)
+                payload.pop("sourceType", None)
+        return payload
+
+
+class AssociatedResourceViewConfigPatch(StrictModel):
+    view_key: str = Field(validation_alias=AliasChoices("view_key", "viewKey", "viewgraphKey", "viewGraphKey"))
+    visible: bool = Field(default=True, validation_alias=AliasChoices("visible", "enabled", "asosChartVisible"))
+    limit_type: str | None = Field(default=None, validation_alias=AliasChoices("limit_type", "limitType"))
+    associated_item_ids: list[Any] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("associated_item_ids", "associatedItemIds", "asosChartIdList"),
+    )
+    associated_item_refs: list[str] = Field(default_factory=list, validation_alias=AliasChoices("associated_item_refs", "associatedItemRefs", "refs"))
+
+
+class AssociatedResourcesApplyRequest(StrictModel):
+    app_key: str
+    upsert_resources: list[AssociatedResourceUpsertPatch] = Field(default_factory=list)
+    remove_associated_item_ids: list[int] = Field(default_factory=list)
+    reorder_associated_item_ids: list[int] = Field(default_factory=list)
+    view_configs: list[AssociatedResourceViewConfigPatch] = Field(default_factory=list)
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "upsertResources" in payload and "upsert_resources" not in payload:
+            payload["upsert_resources"] = payload.pop("upsertResources")
+        if "resources" in payload and "upsert_resources" not in payload:
+            payload["upsert_resources"] = payload.pop("resources")
+        if "removeAssociatedItemIds" in payload and "remove_associated_item_ids" not in payload:
+            payload["remove_associated_item_ids"] = payload.pop("removeAssociatedItemIds")
+        if "reorderAssociatedItemIds" in payload and "reorder_associated_item_ids" not in payload:
+            payload["reorder_associated_item_ids"] = payload.pop("reorderAssociatedItemIds")
+        if "viewConfigs" in payload and "view_configs" not in payload:
+            payload["view_configs"] = payload.pop("viewConfigs")
+        return payload
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "AssociatedResourcesApplyRequest":
+        if not self.upsert_resources and not self.remove_associated_item_ids and not self.reorder_associated_item_ids and not self.view_configs:
+            raise ValueError("associated resources apply requires at least one resource or view config operation")
+        return self
+
+
 class ViewButtonBindingPatch(StrictModel):
     button_type: PublicViewButtonType = Field(validation_alias=AliasChoices("button_type", "buttonType"))
     config_type: PublicViewButtonConfigType = Field(validation_alias=AliasChoices("config_type", "configType"))
@@ -1278,10 +1529,12 @@ class ViewButtonBindingPatch(StrictModel):
         raw_config_type = payload.get("config_type", payload.get("configType"))
         if isinstance(raw_config_type, str):
             normalized_config = raw_config_type.strip().lower()
-            if normalized_config == "top":
+            if normalized_config in {"top", "header"}:
                 payload["config_type"] = "TOP"
             elif normalized_config == "detail":
                 payload["config_type"] = "DETAIL"
+            elif normalized_config in {"list", "row", "row_action"}:
+                payload["config_type"] = "LIST"
         raw_limits = payload.get("button_limit", payload.get("buttonLimit"))
         if isinstance(raw_limits, list) and raw_limits and all(isinstance(item, dict) for item in raw_limits):
             payload["button_limit"] = [raw_limits]
@@ -1597,15 +1850,25 @@ class AppGetResponse(StrictModel):
     field_count: int = 0
     layout_section_count: int = 0
     view_count: int = 0
+    chart_count: int = 0
+    associated_resource_count: int = 0
+    custom_button_count: int = 0
     workflow_enabled: bool = False
+    counts: dict[str, int] = Field(default_factory=dict)
+    views: list[dict[str, Any]] = Field(default_factory=list)
+    charts: list[dict[str, Any]] = Field(default_factory=list)
+    associated_resources: list[dict[str, Any]] = Field(default_factory=list)
+    custom_buttons: list[dict[str, Any]] = Field(default_factory=list)
     verification_hints: list[str] = Field(default_factory=list)
     editability: dict[str, bool | None] = Field(default_factory=dict)
+    form_settings: dict[str, Any] = Field(default_factory=dict)
 
 
 class AppGetFieldsResponse(StrictModel):
     app_key: str
     fields: list[dict[str, Any]] = Field(default_factory=list)
     field_count: int = 0
+    form_settings: dict[str, Any] = Field(default_factory=dict)
 
 
 class AppGetLayoutResponse(StrictModel):
@@ -1681,6 +1944,7 @@ class ViewGetResponse(StrictModel):
     config: dict[str, Any] = Field(default_factory=dict)
     questions: list[dict[str, Any]] = Field(default_factory=list)
     associations: list[dict[str, Any]] = Field(default_factory=list)
+    associated_resources_config: dict[str, Any] = Field(default_factory=dict)
 
 
 class ChartGetResponse(StrictModel):
@@ -1879,7 +2143,10 @@ def _normalize_public_department_scope_mode(value: Any) -> str | None:
 
 
 CustomButtonMatchRulePatch.model_rebuild()
+CustomButtonFieldMappingPatch.model_rebuild()
 CustomButtonAddDataConfigPatch.model_rebuild()
+CustomButtonViewButtonBindingPatch.model_rebuild()
+CustomButtonViewConfigPatch.model_rebuild()
 CodeBlockAliasPathPatch.model_rebuild()
 ViewButtonBindingPatch.model_rebuild()
 ViewUpsertPatch.model_rebuild()