@qingflow-tech/qingflow-cli 1.1.2 → 1.1.34

package/src/qingflow_mcp/tools/record_tools.py

@@ -14153,6 +14153,7 @@ class RecordTools(ToolBase):
         original_error: QingflowApiError,
     ) -> JSONObject:
         """执行内部辅助逻辑。"""
+        readback_error = _record_write_readback_error_payload(original_error)
         for page_num in range(1, VERIFY_TASK_FALLBACK_MAX_PAGES + 1):
             task_page = self.backend.request(
                 "POST",
@@ -14175,6 +14176,12 @@ class RecordTools(ToolBase):
                 candidate_apply_id = _coerce_count(item.get("rowRecordId") or item.get("recordId") or item.get("applyId"))
                 if candidate_apply_id != apply_id:
                     continue
+                warning: JSONObject = {
+                    "code": "WRITE_VERIFIED_VIA_TASK_BOX",
+                    "message": "Immediate field-level readback was unavailable; write was confirmed via the initiated task box fallback.",
+                    "readback_error": readback_error,
+                }
+                warning.update(_record_detail_error_warning_fields(original_error))
                 return {
                     "verified": True,
                     "verification_mode": "initiated_task_box",
@@ -14182,10 +14189,8 @@ class RecordTools(ToolBase):
                     "missing_fields": [],
                     "empty_fields": [],
                     "count_mismatches": [],
-                    "warnings": [{
-                        "code": "WRITE_VERIFIED_VIA_TASK_BOX",
-                        "message": "Field-level readback was blocked by browse permission; write was confirmed via the initiated task box instead.",
-                    }],
+                    "warnings": [warning],
+                    "readback_error": readback_error,
                     "task_match": {
                         "task_id": item.get("id") or item.get("taskId"),
                         "record_id": candidate_apply_id,
@@ -14204,14 +14209,12 @@ class RecordTools(ToolBase):
             "count_mismatches": [],
             "warnings": [{
                 "code": "WRITE_VERIFY_FALLBACK_FAILED",
-                "message": "Field-level readback was blocked by browse permission, and the record was not found in the initiated task box fallback.",
+                "message": "Immediate field-level readback was unavailable, and the record was not found in the initiated task box fallback.",
+                "readback_error": readback_error,
+                **_record_detail_error_warning_fields(original_error),
             }],
-            "original_error": {
-                "category": original_error.category,
-                "message": original_error.message,
-                "backend_code": original_error.backend_code,
-                "http_status": original_error.http_status,
-            },
+            "readback_error": readback_error,
+            "original_error": readback_error,
         }
 
     def _verify_subtable_write_result(
@@ -16266,6 +16269,15 @@ def _record_detail_error_warning_fields(exc: QingflowApiError) -> JSONObject:
     return payload
 
 
+def _record_write_readback_error_payload(exc: QingflowApiError) -> JSONObject:
+    payload: JSONObject = {
+        "category": exc.category,
+        "message": exc.message,
+    }
+    payload.update(_record_detail_error_warning_fields(exc))
+    return payload
+
+
 def _record_detail_refreshed_source_url(refresh_result: Any) -> str | None:
     if isinstance(refresh_result, dict):
         return _normalize_optional_text(refresh_result.get("source_url"))