@josephyan/qingflow-cli 0.2.0-beta.999 → 1.0.5

package/src/qingflow_mcp/tools/resource_read_tools.py

@@ -96,6 +96,9 @@ class ResourceReadTools(ToolBase):
                 )
             )
         if system_view is not None:
+            export_capability = _view_export_capability_payload(
+                supported=_export_supported_for_view_type(system_view["view_type"])
+            )
             return self._run(
                 profile,
                 lambda session_profile, _context: {
@@ -106,11 +109,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,11 +129,13 @@ 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):
+            raw_view_type = None
             warnings: list[JSONObject] = []
             verification = {
                 "view_exists": True,
@@ -150,6 +161,11 @@ class ResourceReadTools(ToolBase):
                 str(base_info.get("viewgraphType") or "").strip()
                 or str(config.get("viewgraphType") or config.get("viewType") or "").strip()
             )
+            export_capability = _view_export_capability_payload(
+                supported=_export_supported_for_view_type(raw_view_type or None)
+            )
+            verification["export_route_supported"] = export_capability["supported"]
+            verification["export_permission_verified"] = export_capability["permission_verified"]
             resolved_app_key = str(base_info.get("appKey") or config.get("appKey") or "").strip() or None
             if not resolved_app_key:
                 resolved_app_key = self._resolve_app_key_from_view_form(context=context, view_key=view_key)
@@ -165,6 +181,13 @@ 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.",
                     }
                 )
+                if export_capability["supported"]:
+                    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 +209,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 +488,21 @@ 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 _export_supported_for_view_type(view_type: str | None) -> bool:
+    return _analysis_supported_for_view_type(view_type)
+
+
 def _normalize_view_type(view_type: Any) -> str | None:
     value = str(view_type or "").strip()
     if not value:

package/src/qingflow_mcp/tools/task_context_tools.py

@@ -1762,6 +1762,7 @@ class TaskContextTools(ToolBase):
                 "apply_time": record.get("apply_time"),
                 "last_update_time": record.get("last_update_time"),
                 "core_fields": self._task_record_core_fields(record.get("answers") or []),
+                "all_fields": self._task_record_all_fields(record.get("answers") or []),
             },
             "available_actions": available_actions,
             "editable_fields": [
@@ -1921,9 +1922,21 @@ class TaskContextTools(ToolBase):
         return None
 
     def _task_record_core_fields(self, answers: Any, *, limit: int = 12) -> dict[str, Any]:
+        return self._task_record_field_map(answers, limit=limit, truncate_text=160)
+
+    def _task_record_all_fields(self, answers: Any) -> dict[str, Any]:
+        return self._task_record_field_map(answers, limit=None, truncate_text=None)
+
+    def _task_record_field_map(
+        self,
+        answers: Any,
+        *,
+        limit: int | None,
+        truncate_text: int | None,
+    ) -> dict[str, Any]:
         if not isinstance(answers, list):
             return {}
-        core_fields: dict[str, Any] = {}
+        field_map: dict[str, Any] = {}
         for answer in answers:
             if not isinstance(answer, dict):
                 continue
@@ -1943,19 +1956,24 @@ class TaskContextTools(ToolBase):
                 value = values[0] if len(values) == 1 else values
             if value in (None, "", []):
                 continue
-            core_fields[str(title)] = self._compact_task_value(value)
-            if len(core_fields) >= limit:
+            field_map[str(title)] = self._compact_task_value(value, truncate_text=truncate_text)
+            if limit is not None and len(field_map) >= limit:
                 break
-        return core_fields
+        return field_map
 
-    def _compact_task_value(self, value: Any) -> Any:
+    def _compact_task_value(self, value: Any, *, truncate_text: int | None = 160) -> Any:
         if isinstance(value, list):
-            return [self._compact_task_value(item) for item in value[:8]]
+            items = [self._compact_task_value(item, truncate_text=truncate_text) for item in value]
+            if truncate_text is not None:
+                return items[:8]
+            return items
         text = re.sub(r"<[^>]+>", " ", str(value))
         text = re.sub(r"\s+", " ", text).strip()
-        if len(text) <= 160:
+        if truncate_text is None or len(text) <= truncate_text:
             return text
-        return text[:157].rstrip() + "..."
+        if truncate_text <= 3:
+            return text[:truncate_text]
+        return text[: truncate_text - 3].rstrip() + "..."
 
     def _compact_task_editable_field(self, field: dict[str, Any], update_schema: dict[str, Any]) -> dict[str, Any]:
         payload_template = update_schema.get("payload_template") if isinstance(update_schema.get("payload_template"), dict) else {}