@josephyan/qingflow-cli 1.1.15 → 1.1.17

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -49,6 +49,8 @@ from ..builder_facade.models import (
     ViewUpsertPatch,
     ViewsPreset,
     ViewsPlanRequest,
+    public_view_partial_payload,
+    public_view_upsert_payload,
 )
 from ..builder_facade.service import AiBuilderFacade, INTEGRATION_OUTPUT_TARGET_FIELD_TYPES
 from ..solution.compiler.icon_utils import (
@@ -2018,6 +2020,7 @@ class AiBuilderTools(ToolBase):
         profile: str,
         app_key: str,
         upsert_views: list[JSONObject] | None = None,
+        patch_views: list[JSONObject] | None = None,
         remove_views: list[str] | None = None,
         preset: str | None = None,
     ) -> JSONObject:
@@ -2036,6 +2039,7 @@ class AiBuilderTools(ToolBase):
                 {
                     "app_key": app_key,
                     "upsert_views": upsert_views or [],
+                    "patch_views": patch_views or [],
                     "remove_views": remove_views or [],
                     "preset": preset,
                 }
@@ -2052,6 +2056,7 @@ class AiBuilderTools(ToolBase):
                         "app_key": app_key,
                         "preset": "default_table",
                         "upsert_views": [],
+                        "patch_views": [],
                         "remove_views": [],
                     },
                 },
@@ -2059,8 +2064,24 @@ class AiBuilderTools(ToolBase):
         return _safe_tool_call(
             lambda: self._facade.app_views_plan(profile=profile, request=request),
             error_code="VIEWS_PLAN_FAILED",
-            normalized_args=request.model_dump(mode="json"),
-            suggested_next_call={"tool_name": "app_views_plan", "arguments": {"profile": profile, **request.model_dump(mode="json")}},
+            normalized_args={
+                "app_key": request.app_key,
+                "upsert_views": [public_view_upsert_payload(view) for view in request.upsert_views],
+                "patch_views": [public_view_partial_payload(patch) for patch in request.patch_views],
+                "remove_views": list(request.remove_views),
+                "preset": request.preset.value if request.preset is not None else None,
+            },
+            suggested_next_call={
+                "tool_name": "app_views_plan",
+                "arguments": {
+                    "profile": profile,
+                    "app_key": request.app_key,
+                    "upsert_views": [public_view_upsert_payload(view) for view in request.upsert_views],
+                    "patch_views": [public_view_partial_payload(patch) for patch in request.patch_views],
+                    "remove_views": list(request.remove_views),
+                    "preset": request.preset.value if request.preset is not None else None,
+                },
+            },
         )
 
     @tool_cn_name("应用结构应用")
@@ -2990,7 +3011,7 @@ class AiBuilderTools(ToolBase):
         )
         if reserved_failure is not None:
             return reserved_failure
-        if patch_views:
+        if patch_views or _view_payload_has_action_buttons(upsert_views=upsert_views, patch_views=patch_views):
             try:
                 parsed_views = [ViewUpsertPatch.model_validate(item) for item in (upsert_views or [])]
                 parsed_patch_views = [ViewPartialPatch.model_validate(item) for item in patch_views]
@@ -3016,8 +3037,8 @@ class AiBuilderTools(ToolBase):
             normalized_args = {
                 "app_key": app_key,
                 "publish": publish,
-                "upsert_views": [view.model_dump(mode="json") for view in parsed_views],
-                "patch_views": [patch.model_dump(mode="json") for patch in parsed_patch_views],
+                "upsert_views": [public_view_upsert_payload(view) for view in parsed_views],
+                "patch_views": [public_view_partial_payload(patch) for patch in parsed_patch_views],
                 "remove_views": list(remove_views or []),
             }
             return _safe_tool_call(
@@ -3072,7 +3093,8 @@ class AiBuilderTools(ToolBase):
         normalized_args = {
             "app_key": str(plan_args.get("app_key") or app_key),
             "publish": publish,
-            "upsert_views": [view.model_dump(mode="json") for view in parsed_views],
+            "upsert_views": [public_view_upsert_payload(view) for view in parsed_views],
+            "patch_views": [],
             "remove_views": list(plan_args.get("remove_views") or remove_views),
         }
         return _safe_tool_call(
@@ -4278,6 +4300,23 @@ def _reserved_system_view_name_failure(
     return None
 
 
+def _view_payload_has_action_buttons(
+    *,
+    upsert_views: list[JSONObject] | None = None,
+    patch_views: list[JSONObject] | None = None,
+) -> bool:
+    for item in upsert_views or []:
+        if isinstance(item, dict) and any(key in item for key in ("action_buttons", "actionButtons")):
+            return True
+    for item in patch_views or []:
+        if not isinstance(item, dict):
+            continue
+        raw_set = item.get("set")
+        if isinstance(raw_set, dict) and any(key in raw_set for key in ("action_buttons", "actionButtons")):
+            return True
+    return False
+
+
 def _config_failure(
     *,
     tool_name: str,
@@ -4986,6 +5025,15 @@ def _builder_view_resources(payload: JSONObject) -> list[JSONObject]:
                 message=message,
             )
         )
+    details = payload.get("details") if isinstance(payload.get("details"), dict) else {}
+    action_buttons_result = details.get("action_buttons_result") if isinstance(details, dict) else None
+    if isinstance(action_buttons_result, dict):
+        nested_payload = {
+            **action_buttons_result,
+            "app_key": payload.get("app_key"),
+            "app_name": payload.get("app_name"),
+        }
+        resources.extend(_builder_button_resources(nested_payload))
     return resources
 
 
@@ -6460,11 +6508,15 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "upsert_views[].columns",
             "upsert_views[].filters",
             "upsert_views[].buttons",
+            "upsert_views[].action_buttons",
+            "upsert_views[].action_buttons_mode",
             "upsert_views[].visibility",
             "upsert_views[].query_conditions",
             "patch_views[].view_key",
             "patch_views[].name",
             "patch_views[].set",
+            "patch_views[].set.action_buttons",
+            "patch_views[].set.action_buttons_mode",
             "patch_views[].unset",
         ],
         "aliases": {
@@ -6492,6 +6544,14 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "buttons[].buttonFormula": "buttons[].button_formula",
             "buttons[].buttonFormulaType": "buttons[].button_formula_type",
             "buttons[].printTpls": "buttons[].print_tpls",
+            "actionButtons": "action_buttons",
+            "actionButtonsMode": "action_buttons_mode",
+            "action_buttons[].button_text": "action_buttons[].text",
+            "action_buttons[].trigger_action": "action_buttons[].action",
+            "action_buttons[].trigger_link_url": "action_buttons[].url",
+            "action_buttons[].visibleWhen": "action_buttons[].visible_when",
+            "action_buttons[].fieldMappings": "action_buttons[].field_mappings",
+            "action_buttons[].defaultValues": "action_buttons[].default_values",
         },
         "allowed_values": {
             "preset": [member.value for member in ViewsPreset],
@@ -6499,6 +6559,9 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "view.filter.operator": [member.value for member in ViewFilterOperator],
             "view.buttons.button_type": ["SYSTEM", "CUSTOM"],
             "view.buttons.config_type": ["TOP", "DETAIL", "INSIDE"],
+            "view.action_buttons.action": ["add_data", "link", "qRobot", "wings"],
+            "view.action_buttons.placement": [member.value for member in PublicButtonPlacement],
+            "view.action_buttons_mode": ["merge", "replace"],
             **deepcopy(_VISIBILITY_ALLOWED_VALUES),
         },
         "execution_notes": [
@@ -6508,6 +6571,9 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "upsert_views[].query_conditions.rows is a layout matrix of query-panel supported field names; it is compiled to backend queryCondition queIds",
             "do not put relation/attachment/subtable/code_block/q_linker/address fields in query_conditions; use filters for fixed filters or app_associated_resources_apply.match_mappings for current-record relation/report matching",
             "use patch_views for partial parameter replacement on existing views; the tool reads current config, merges patch_views[].set/unset, then submits the backend full-save payload internally",
+            "business buttons should be declared with action_buttons on the target view; app_views_apply writes the view first, then compiles action_buttons through the custom button writer and binds them to the resulting view_key",
+            "action_buttons_mode defaults to merge; replace rewrites this view's custom button bindings, and replace plus action_buttons=[] clears this view's custom button bindings without deleting button bodies",
+            "legacy upsert_views[].buttons is a compatibility path for raw full replacement of existing view button config; do not use it as the normal agent path",
             "remove_views accepts a raw view_key or an exact unique view name; after DELETE the tool verifies deletion by single view_key readback, not by a full app view list",
             "deleted views return verification.by_view[].delete_executed, readback_status, and safe_to_retry_delete=false; if readback is pending, do not blindly repeat the delete",
             "do not create business views named 全部数据, 我的数据, 我发起的, 待办, 已办, or 抄送; these are built-in system/default views. Use business-specific names for new views, and pass the existing raw view_key or patch_views when changing a built-in view",
@@ -6538,6 +6604,27 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             ],
             "remove_views": [],
         },
+        "action_buttons_example": {
+            "profile": "default",
+            "app_key": "APP_KEY",
+            "upsert_views": [
+                {
+                    "name": "生产工单执行视图",
+                    "type": "table",
+                    "columns": ["工单编号", "产品", "状态", "负责人"],
+                    "action_buttons": [
+                        {
+                            "text": "开始生产",
+                            "action": "link",
+                            "url": "https://example.com/start",
+                            "placement": "list",
+                            "visible_when": [{"field_name": "状态", "operator": "eq", "value": "待排产"}],
+                        }
+                    ],
+                }
+            ],
+            "remove_views": [],
+        },
         "full_upsert_query_conditions_example": {
             "profile": "default",
             "app_key": "APP_KEY",
@@ -6595,11 +6682,15 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "upsert_views[].columns",
             "upsert_views[].filters",
             "upsert_views[].buttons",
+            "upsert_views[].action_buttons",
+            "upsert_views[].action_buttons_mode",
             "upsert_views[].visibility",
             "upsert_views[].query_conditions",
             "patch_views[].view_key",
             "patch_views[].name",
             "patch_views[].set",
+            "patch_views[].set.action_buttons",
+            "patch_views[].set.action_buttons_mode",
             "patch_views[].unset",
         ],
         "aliases": {
@@ -6627,12 +6718,23 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "buttons[].buttonFormula": "buttons[].button_formula",
             "buttons[].buttonFormulaType": "buttons[].button_formula_type",
             "buttons[].printTpls": "buttons[].print_tpls",
+            "actionButtons": "action_buttons",
+            "actionButtonsMode": "action_buttons_mode",
+            "action_buttons[].button_text": "action_buttons[].text",
+            "action_buttons[].trigger_action": "action_buttons[].action",
+            "action_buttons[].trigger_link_url": "action_buttons[].url",
+            "action_buttons[].visibleWhen": "action_buttons[].visible_when",
+            "action_buttons[].fieldMappings": "action_buttons[].field_mappings",
+            "action_buttons[].defaultValues": "action_buttons[].default_values",
         },
         "allowed_values": {
             "view.type": [member.value for member in PublicViewType],
             "view.filter.operator": [member.value for member in ViewFilterOperator],
             "view.buttons.button_type": ["SYSTEM", "CUSTOM"],
             "view.buttons.config_type": ["TOP", "DETAIL", "INSIDE"],
+            "view.action_buttons.action": ["add_data", "link", "qRobot", "wings"],
+            "view.action_buttons.placement": [member.value for member in PublicButtonPlacement],
+            "view.action_buttons_mode": ["merge", "replace"],
             **deepcopy(_VISIBILITY_ALLOWED_VALUES),
         },
         "execution_notes": [
@@ -6642,6 +6744,10 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "read back app_get after any failed or partial view apply",
             "view existence verification and saved-filter verification are separate; treat filters as unverified until verification.view_filters_verified is true",
             "buttons omitted preserves existing button config; buttons=[] clears all buttons; buttons=[...] replaces the full button config",
+            "business buttons should be declared with action_buttons on the target view; app_views_apply writes the view first, then compiles action_buttons through the custom button writer and binds them to the resulting view_key",
+            "patch_views[].set.action_buttons can add buttons to an existing view without rewriting columns/filters; action_buttons_mode defaults to merge, replace rewrites this view's custom button bindings, and replace plus action_buttons=[] clears bindings without deleting button bodies",
+            "publish=false with action_buttons is blocked as VIEW_ACTION_BUTTONS_REQUIRE_PUBLISH because the underlying custom button writer may publish after successful button writes",
+            "legacy upsert_views[].buttons is a compatibility path for raw full replacement of existing view button config; do not use it as the normal agent path",
             "upsert_views[].visibility may set per-view visibility; omit it to preserve an existing view's auth or default a new view to workspace/not",
             "filters are saved fixed filters that apply when the view opens; query_conditions configure the frontend query panel and only apply after a user enters query values",
             "upsert_views[].query_conditions.rows is a layout matrix of query-panel supported field names; it is compiled to backend queryCondition queIds",
@@ -6679,6 +6785,51 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             ],
             "remove_views": [],
         },
+        "action_buttons_example": {
+            "profile": "default",
+            "app_key": "APP_KEY",
+            "publish": True,
+            "upsert_views": [
+                {
+                    "name": "生产工单执行视图",
+                    "type": "table",
+                    "columns": ["工单编号", "产品", "状态", "负责人"],
+                    "action_buttons": [
+                        {
+                            "text": "开始生产",
+                            "action": "link",
+                            "url": "https://example.com/start",
+                            "placement": "list",
+                            "visible_when": [{"field_name": "状态", "operator": "eq", "value": "待排产"}],
+                        }
+                    ],
+                }
+            ],
+            "remove_views": [],
+        },
+        "action_buttons_patch_example": {
+            "profile": "default",
+            "app_key": "APP_KEY",
+            "publish": True,
+            "patch_views": [
+                {
+                    "view_key": "RAW_VIEW_KEY",
+                    "set": {
+                        "action_buttons": [
+                            {
+                                "text": "创建验收单",
+                                "action": "add_data",
+                                "target_app_key": "ARRIVAL_APP",
+                                "field_mappings": [{"source_field": "数据ID", "target_field": "关联工单"}],
+                                "default_values": {"状态": "待验收"},
+                                "placement": "detail",
+                            }
+                        ]
+                    },
+                }
+            ],
+            "remove_views": [],
+        },
         "full_upsert_query_conditions_example": {
             "profile": "default",
             "app_key": "APP_KEY",