@josephyan/qingflow-app-user-mcp 0.2.0-beta.997 → 0.2.0-beta.998

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-app-user-mcp@0.2.0-beta.997
+npm install @josephyan/qingflow-app-user-mcp@0.2.0-beta.998
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-app-user-mcp@0.2.0-beta.997 qingflow-app-user-mcp
+npx -y -p @josephyan/qingflow-app-user-mcp@0.2.0-beta.998 qingflow-app-user-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-app-user-mcp",
-  "version": "0.2.0-beta.997",
+  "version": "0.2.0-beta.998",
   "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 = "0.2.0b997"
+version = "0.2.0b998"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/__init__.py

@@ -5,7 +5,7 @@ from pathlib import Path
 
 __all__ = ["__version__"]
 
-_FALLBACK_VERSION = "0.2.0b997"
+_FALLBACK_VERSION = "0.2.0b998"
 
 
 def _resolve_local_pyproject_version() -> str | None:

package/src/qingflow_mcp/tools/task_context_tools.py

@@ -1148,53 +1148,61 @@ class TaskContextTools(ToolBase):
             "reported_total": matched_total,
         }
 
-    def _resolve_todo_task_locator(self, *, profile: str, task_id: Any) -> dict[str, Any]:
+    def _resolve_task_locator_by_task_id(self, *, profile: str, task_id: Any) -> dict[str, Any]:
         task_id_text = normalize_positive_id_text(task_id, field_name="task_id")
-        page = 1
+        searched_task_boxes = ("todo", "initiated", "cc", "done")
+        incomplete_task_boxes: list[str] = []
         page_size = 100
-        page_amount: int | None = None
-        while True:
-            response = self._list_normalized_task_items(
-                profile=profile,
-                task_box="todo",
-                flow_status="all",
-                app_key=None,
-                workflow_node_id=None,
-                query=None,
-                page=page,
-                page_size=page_size,
+        for task_box in searched_task_boxes:
+            page = 1
+            page_amount: int | None = None
+            while True:
+                response = self._list_normalized_task_items(
+                    profile=profile,
+                    task_box=task_box,
+                    flow_status="all",
+                    app_key=None,
+                    workflow_node_id=None,
+                    query=None,
+                    page=page,
+                    page_size=page_size,
+                )
+                items = response.get("items") if isinstance(response.get("items"), list) else []
+                for item in items:
+                    if not isinstance(item, dict) or not ids_equal(item.get("task_id"), task_id_text):
+                        continue
+                    app_key = str(item.get("app_key") or "").strip()
+                    record_id = stringify_backend_id(item.get("record_id"))
+                    workflow_node_id = int(item.get("workflow_node_id") or 0)
+                    if not app_key or record_id is None or workflow_node_id <= 0:
+                        incomplete_task_boxes.append(task_box)
+                        continue
+                    return {
+                        "task_id": task_id_text,
+                        "task_box": task_box,
+                        "app_key": app_key,
+                        "record_id": record_id,
+                        "workflow_node_id": workflow_node_id,
+                    }
+                if page_amount is None:
+                    coerced_page_amount = _coerce_count(response.get("page_amount"))
+                    if coerced_page_amount is not None and coerced_page_amount > 0:
+                        page_amount = coerced_page_amount
+                if page_amount is not None and page >= page_amount:
+                    break
+                if not items or len(items) < page_size:
+                    break
+                page += 1
+        if incomplete_task_boxes:
+            searched = ", ".join(incomplete_task_boxes)
+            raise_tool_error(
+                QingflowApiError.config_error(
+                    f"task_id={task_id_text} resolved to an incomplete task locator in task_box={searched}; please refresh the task list and retry"
+                )
             )
-            items = response.get("items") if isinstance(response.get("items"), list) else []
-            for item in items:
-                if not isinstance(item, dict) or not ids_equal(item.get("task_id"), task_id_text):
-                    continue
-                app_key = str(item.get("app_key") or "").strip()
-                record_id = stringify_backend_id(item.get("record_id"))
-                workflow_node_id = int(item.get("workflow_node_id") or 0)
-                if not app_key or record_id is None or workflow_node_id <= 0:
-                    raise_tool_error(
-                        QingflowApiError.config_error(
-                            f"task_id={task_id_text} resolved to an incomplete task locator; please refresh the todo list and retry"
-                        )
-                    )
-                return {
-                    "task_id": task_id_text,
-                    "app_key": app_key,
-                    "record_id": record_id,
-                    "workflow_node_id": workflow_node_id,
-                }
-            if page_amount is None:
-                coerced_page_amount = _coerce_count(response.get("page_amount"))
-                if coerced_page_amount is not None and coerced_page_amount > 0:
-                    page_amount = coerced_page_amount
-            if page_amount is not None and page >= page_amount:
-                break
-            if not items or len(items) < page_size:
-                break
-            page += 1
         raise_tool_error(
             QingflowApiError.config_error(
-                f"task_id={task_id_text} was not found in the current todo list; task context tools currently resolve actionable todo tasks by task_id"
+                f"task_id={task_id_text} was not found in the current visible task boxes (todo, initiated, cc, done)"
             )
         )
 
@@ -1212,7 +1220,7 @@ class TaskContextTools(ToolBase):
         resolved_record_id: int
         resolved_workflow_node_id: int
         if task_id_text is not None:
-            locator = self._resolve_todo_task_locator(profile=profile, task_id=task_id_text)
+            locator = self._resolve_task_locator_by_task_id(profile=profile, task_id=task_id_text)
             resolved_app_key = str(locator["app_key"])
             resolved_record_id = normalize_positive_id_int(locator["record_id"], field_name="record_id")
             resolved_workflow_node_id = int(locator["workflow_node_id"])