@qingflow-tech/qingflow-app-user-mcp 1.0.28 → 1.0.30

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-user-mcp@1.0.28
+npm install @qingflow-tech/qingflow-app-user-mcp@1.0.30
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-user-mcp@1.0.28 qingflow-app-user-mcp
+npx -y -p @qingflow-tech/qingflow-app-user-mcp@1.0.30 qingflow-app-user-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-app-user-mcp",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "description": "Operational end-user MCP for Qingflow records, tasks, comments, and directory workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "1.0.28"
+version = "1.0.30"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/tools/record_tools.py

@@ -490,7 +490,6 @@ class RecordTools(ToolBase):
             record_id: str = "",
             columns: list[JSONObject | int] | None = None,
             view_id: str | None = None,
-            workflow_node_id: int | None = None,
             output_profile: str = "detail_context",
         ) -> JSONObject:
             return self.record_get_public(
@@ -499,7 +498,7 @@ class RecordTools(ToolBase):
                 record_id=record_id,
                 columns=columns or [],
                 view_id=view_id,
-                workflow_node_id=workflow_node_id,
+                workflow_node_id=None,
                 output_profile=output_profile,
             )
 

package/src/qingflow_mcp/tools/task_context_tools.py

@@ -38,6 +38,9 @@ from .record_tools import (
 from .task_tools import TaskTools, _task_page_amount, _task_page_items, _task_page_total
 
 
+TASK_LOCATOR_MAX_SCAN_PAGES_PER_BOX = 3
+
+
 class TaskContextTools(ToolBase):
     """任务上下文工具（中文名：任务上下文与审批执行）。
 
@@ -1252,6 +1255,7 @@ class TaskContextTools(ToolBase):
         searched_task_boxes = ("todo", "initiated", "cc", "done")
         incomplete_task_boxes: list[str] = []
         inaccessible_task_boxes: list[dict[str, Any]] = []
+        truncated_task_boxes: list[dict[str, Any]] = []
         page_size = 100
         for task_box in searched_task_boxes:
             page = 1
@@ -1305,6 +1309,16 @@ class TaskContextTools(ToolBase):
                     break
                 if not items or len(items) < page_size:
                     break
+                if page >= TASK_LOCATOR_MAX_SCAN_PAGES_PER_BOX:
+                    truncated_task_boxes.append(
+                        {
+                            "task_box": task_box,
+                            "max_pages": TASK_LOCATOR_MAX_SCAN_PAGES_PER_BOX,
+                            "page_size": page_size,
+                            "reported_page_amount": page_amount,
+                        }
+                    )
+                    break
                 page += 1
         if incomplete_task_boxes:
             searched = ", ".join(incomplete_task_boxes)
@@ -1325,6 +1339,19 @@ class TaskContextTools(ToolBase):
                     },
                 )
             )
+        if truncated_task_boxes:
+            raise_tool_error(
+                QingflowApiError.config_error(
+                    f"task_id={task_id_text} was not found in the first {TASK_LOCATOR_MAX_SCAN_PAGES_PER_BOX} pages of each visible task box. Rerun task_list with a query or the relevant page and pass the exact data.items[].task_id; do not guess task ids.",
+                    details={
+                        "task_id": task_id_text,
+                        "searched_task_boxes": list(searched_task_boxes),
+                        "truncated_task_boxes": truncated_task_boxes,
+                        "max_pages_per_task_box": TASK_LOCATOR_MAX_SCAN_PAGES_PER_BOX,
+                        "page_size": page_size,
+                    },
+                )
+            )
         raise_tool_error(
             QingflowApiError.config_error(
                 f"task_id={task_id_text} was not found in the current visible task boxes (todo, initiated, cc, done). Rerun task_list and pass data.items[].task_id; do not use the displayed row number or guess app_key/record_id/workflow_node_id."