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

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -25,6 +25,7 @@ from ..builder_facade.models import (
     LayoutSectionPatch,
     PortalApplyRequest,
     PublicFieldType,
+    PublicRelationMode,
     PublicChartType,
     PublicViewType,
     SchemaPlanRequest,
@@ -1596,9 +1597,17 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "field.label": "field.name",
             "field.fields": "field.subfields",
             "field.type_id": "field.type",
+            "field.relationMode": "field.relation_mode",
+            "field.selection_mode": "field.relation_mode",
+            "field.selectionMode": "field.relation_mode",
+            "field.multiple": "field.relation_mode",
+            "field.allow_multiple": "field.relation_mode",
+            "field.optional_data_num": "field.relation_mode",
+            "field.optionalDataNum": "field.relation_mode",
         },
         "allowed_values": {
             "field.type": [member.value for member in PublicFieldType],
+            "field.relation_mode": [member.value for member in PublicRelationMode],
             "field_type_ids": sorted(FIELD_TYPE_ID_ALIASES.keys()),
         },
         "minimal_example": {
@@ -1610,6 +1619,22 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "update_fields": [],
             "remove_fields": [],
         },
+        "relation_example": {
+            "profile": "default",
+            "app_key": "APP_ITERATION",
+            "add_fields": [
+                {
+                    "name": "需求反馈引用",
+                    "type": "relation",
+                    "target_app_key": "APP_FEEDBACK",
+                    "relation_mode": "multiple",
+                    "display_field": {"name": "反馈标题"},
+                    "visible_fields": [{"name": "反馈标题"}, {"name": "优先级判断"}],
+                }
+            ],
+            "update_fields": [],
+            "remove_fields": [],
+        },
     },
     "app_schema_apply": {
         "allowed_keys": ["app_key", "package_tag_id", "app_name", "create_if_missing", "publish", "add_fields", "update_fields", "remove_fields"],
@@ -1620,14 +1645,23 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "field.label": "field.name",
             "field.fields": "field.subfields",
             "field.type_id": "field.type",
+            "field.relationMode": "field.relation_mode",
+            "field.selection_mode": "field.relation_mode",
+            "field.selectionMode": "field.relation_mode",
+            "field.multiple": "field.relation_mode",
+            "field.allow_multiple": "field.relation_mode",
+            "field.optional_data_num": "field.relation_mode",
+            "field.optionalDataNum": "field.relation_mode",
         },
         "allowed_values": {
             "field.type": [member.value for member in PublicFieldType],
+            "field.relation_mode": [member.value for member in PublicRelationMode],
             "field_type_ids": sorted(FIELD_TYPE_ID_ALIASES.keys()),
         },
         "execution_notes": [
             "multiple relation fields are backend-risky; read verification.relation_field_limit_verified and warnings before declaring the schema stable",
             "backend 49614 is normalized to MULTIPLE_RELATION_FIELDS_UNSUPPORTED with a workaround message",
+            "relation_mode=multiple maps to referenceConfig.optionalDataNum=0",
         ],
         "minimal_example": {
             "profile": "default",
@@ -1639,6 +1673,23 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "update_fields": [],
             "remove_fields": [],
         },
+        "relation_example": {
+            "profile": "default",
+            "app_key": "APP_ITERATION",
+            "publish": True,
+            "add_fields": [
+                {
+                    "name": "需求反馈引用",
+                    "type": "relation",
+                    "target_app_key": "APP_FEEDBACK",
+                    "relation_mode": "multiple",
+                    "display_field": {"name": "反馈标题"},
+                    "visible_fields": [{"name": "反馈标题"}, {"name": "优先级判断"}],
+                }
+            ],
+            "update_fields": [],
+            "remove_fields": [],
+        },
     },
     "app_layout_plan": {
         "allowed_keys": ["app_key", "mode", "sections", "preset"],

package/src/qingflow_mcp/tools/app_tools.py

@@ -268,6 +268,42 @@ class AppTools(ToolBase):
 
         return self._run(profile, runner)
 
+    def app_get_apply_base_info(self, *, profile: str, app_key: str, list_type: int) -> JSONObject:
+        self._require_app_key(app_key)
+        if not isinstance(list_type, int) or isinstance(list_type, bool) or list_type <= 0:
+            raise_tool_error(QingflowApiError.config_error("list_type must be a positive integer"))
+
+        def runner(session_profile, context):
+            result = self.backend.request("GET", context, f"/app/{app_key}/apply/baseInfo", params={"type": list_type})
+            return {
+                "profile": profile,
+                "ws_id": session_profile.selected_ws_id,
+                "app_key": app_key,
+                "list_type": list_type,
+                "result": result,
+            }
+
+        return self._run(profile, runner)
+
+    def app_update_apply_config(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+
+        def runner(session_profile, context):
+            result = self.backend.request("POST", context, f"/app/{app_key}/apply/config", json_body=body)
+            return self._attach_human_review_notice(
+                {
+                    "profile": profile,
+                    "ws_id": session_profile.selected_ws_id,
+                    "app_key": app_key,
+                    "result": result,
+                },
+                operation="update",
+                target="app apply list configuration",
+            )
+
+        return self._run(profile, runner)
+
     def app_update_form_schema(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
         self._require_app_key(app_key)
         body = self._require_dict(payload)

package/src/qingflow_mcp/tools/code_block_tools.py

@@ -149,7 +149,7 @@ class CodeBlockTools(RecordTools):
             run_result = self.backend.request(
                 "POST",
                 context,
-                f"/app/{app_key}/codeBlock/working",
+                f"/data/{app_key}/codeBlock/working",
                 json_body=run_body,
             )
             alias_results = _normalize_code_block_alias_results(run_result)
@@ -173,8 +173,22 @@ class CodeBlockTools(RecordTools):
                 }
                 if workflow_node_id is not None:
                     relation_body["auditNodeId"] = workflow_node_id
-                relation_result = self.backend.request("POST", context, "/que/actuator", json_body=relation_body)
-                relation_items = _relation_result_items(relation_result)
+                relation_route = "/data/que/actuator"
+                try:
+                    relation_result = self.backend.request("POST", context, relation_route, json_body=relation_body)
+                    relation_items = _relation_result_items(relation_result)
+                except QingflowApiError as exc:
+                    if exc.http_status != 404:
+                        raise
+                    relation_route = "/que/actuator"
+                    relation_result = self.backend.request("POST", context, relation_route, json_body=relation_body)
+                    relation_items = _relation_result_items(relation_result)
+                if not relation_items:
+                    # Keep compatibility with legacy runtime deployments and lightweight test doubles
+                    # that still stub the older relation-calculation route only.
+                    relation_route = "/que/actuator"
+                    relation_result = self.backend.request("POST", context, relation_route, json_body=relation_body)
+                    relation_items = _relation_result_items(relation_result)
                 relation_errors = _relation_result_errors(relation_items)
                 calculated_answers = _relation_result_answers(relation_items)
             write_result: JSONObject | None = None
@@ -256,6 +270,7 @@ class CodeBlockTools(RecordTools):
             if normalized_output_profile == "verbose":
                 response["debug"] = {
                     "run_body": run_body,
+                    "relation_route": relation_route if relation_target_fields else None,
                     "relation_result": relation_result,
                     "calculated_answers": calculated_answers,
                     "merged_answers": merged_answers,