@josephyan/qingflow-cli 0.2.0-beta.1008 → 0.2.0-beta.1011

package/src/qingflow_mcp/tools/resource_read_tools.py

@@ -96,6 +96,7 @@ class ResourceReadTools(ToolBase):
                 )
             )
         if system_view is not None:
+            export_capability = _view_export_capability_payload(supported=True)
             return self._run(
                 profile,
                 lambda session_profile, _context: {
@@ -106,11 +107,17 @@ class ResourceReadTools(ToolBase):
                         {
                             "code": "VIEW_APP_KEY_UNRESOLVED",
                             "message": f"view_get could not resolve app_key for system view `{view_id}`; keep using the app_key from the parent app context.",
-                        }
+                        },
+                        {
+                            "code": "VIEW_EXPORT_APP_CONTEXT_REQUIRED",
+                            "message": f"view_get supports exporting `{view_id}`, but the export call still needs the parent app context `app_key`.",
+                        },
                     ],
                     "verification": {
                         "view_exists": True,
                         "descriptor_only": True,
+                        "export_route_supported": export_capability["supported"],
+                        "export_permission_verified": export_capability["permission_verified"],
                     },
                     "data": {
                         "app_key": None,
@@ -120,15 +127,19 @@ class ResourceReadTools(ToolBase):
                         "view_type": system_view["view_type"],
                         "visible_columns": [],
                         "analysis_supported": system_view["analysis_supported"],
+                        "export_capability": export_capability,
                     },
                 },
             )
 
         def runner(session_profile, context):
+            export_capability = _view_export_capability_payload(supported=True)
             warnings: list[JSONObject] = []
             verification = {
                 "view_exists": True,
                 "questions_verified": True,
+                "export_route_supported": export_capability["supported"],
+                "export_permission_verified": export_capability["permission_verified"],
             }
             config = self.backend.request("GET", context, f"/view/{view_key}/viewConfig")
             base_info = self.backend.request("GET", context, f"/view/{view_key}/viewConfig/baseInfo")
@@ -165,6 +176,12 @@ class ResourceReadTools(ToolBase):
                         "message": f"view_get could not resolve app_key for `{view_id}` from view metadata; keep using the app_key from the parent app or portal context.",
                     }
                 )
+                warnings.append(
+                    {
+                        "code": "VIEW_EXPORT_APP_CONTEXT_REQUIRED",
+                        "message": f"view_get supports exporting `{view_id}`, but the export call still needs an explicit `app_key` from the parent app context.",
+                    }
+                )
             return {
                 "profile": profile,
                 "ws_id": session_profile.selected_ws_id,
@@ -186,6 +203,7 @@ class ResourceReadTools(ToolBase):
                         if str(item.get("queTitle") or item.get("title") or "").strip()
                     ],
                     "analysis_supported": _analysis_supported_for_view_type(raw_view_type or None),
+                    "export_capability": export_capability,
                 },
             }
 
@@ -464,6 +482,17 @@ def _lookup_system_view_descriptor(view_id: str) -> dict[str, Any] | None:
     return None
 
 
+def _view_export_capability_payload(*, supported: bool) -> JSONObject:
+    return {
+        "supported": supported,
+        "tool": "record_export_start",
+        "format": "xlsx",
+        "async": True,
+        "requires_app_key": True,
+        "permission_verified": False,
+    }
+
+
 def _normalize_view_type(view_type: Any) -> str | None:
     value = str(view_type or "").strip()
     if not value: