@josephyan/qingflow-cli 0.2.0-beta.55

package/src/qingflow_mcp/tools/view_tools.py

@@ -0,0 +1,280 @@
+from __future__ import annotations
+
+from mcp.server.fastmcp import FastMCP
+
+from ..config import DEFAULT_PROFILE
+from ..errors import QingflowApiError, raise_tool_error
+from ..json_types import JSONObject, JSONValue
+from .base import ToolBase
+
+
+class ViewTools(ToolBase):
+    def register(self, mcp: FastMCP) -> None:
+        @mcp.tool()
+        def view_list(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.view_list(profile=profile, app_key=app_key)
+
+        @mcp.tool()
+        def view_list_flat(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.view_list_flat(profile=profile, app_key=app_key)
+
+        @mcp.tool()
+        def view_get_config(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "") -> JSONObject:
+            return self.view_get_config(profile=profile, viewgraph_key=viewgraph_key)
+
+        @mcp.tool()
+        def view_get_base_info(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "", passcode: str | None = None) -> JSONObject:
+            return self.view_get_base_info(profile=profile, viewgraph_key=viewgraph_key, passcode=passcode)
+
+        @mcp.tool()
+        def view_list_questions(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "") -> JSONObject:
+            return self.view_list_questions(profile=profile, viewgraph_key=viewgraph_key)
+
+        @mcp.tool()
+        def view_list_associations(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "") -> JSONObject:
+            return self.view_list_associations(profile=profile, viewgraph_key=viewgraph_key)
+
+        @mcp.tool()
+        def view_board_get_lane_base_info(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "", page_num: int = 1, page_size: int = 20) -> JSONObject:
+            return self.view_board_get_lane_base_info(profile=profile, viewgraph_key=viewgraph_key, page_num=page_num, page_size=page_size)
+
+        @mcp.tool()
+        def view_get_future_nodes(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "", apply_id: int = 0, app_key: str = "") -> JSONObject:
+            return self.view_get_future_nodes(profile=profile, viewgraph_key=viewgraph_key, apply_id=apply_id, app_key=app_key)
+
+        @mcp.tool()
+        def view_get_workflow_status(profile: str = DEFAULT_PROFILE, viewgraph_key: str = "", row_record_id: int = 0) -> JSONObject:
+            return self.view_get_workflow_status(profile=profile, viewgraph_key=viewgraph_key, row_record_id=row_record_id)
+
+    def view_list(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/view/viewList", app_key=app_key)
+
+    def view_list_flat(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/view/views", app_key=app_key)
+
+    def view_reorder(self, *, profile: str, app_key: str, payload: list[JSONObject]) -> JSONObject:
+        self._require_app_key(app_key)
+        if not isinstance(payload, list) or not payload:
+            raise_tool_error(QingflowApiError.config_error("payload must be a non-empty array"))
+        return self._request(
+            profile,
+            "POST",
+            f"/app/{app_key}/view/ordinal",
+            app_key=app_key,
+            json_body=self._normalize_reorder_payload(payload),
+        )
+
+    def view_set_column_width(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/view/que/width", app_key=app_key, json_body=body)
+
+    def view_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
+        body = self._require_dict(payload)
+        app_key = str(body.get("appKey") or "")
+        return self._request(profile, "POST", "/view/viewConfig", app_key=app_key, json_body=body)
+
+    def view_get_config(self, *, profile: str, viewgraph_key: str) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/viewConfig", viewgraph_key=viewgraph_key)
+
+    def view_get_base_info(self, *, profile: str, viewgraph_key: str, passcode: str | None) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        params = {"pass": passcode} if passcode else None
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/viewConfig/baseInfo", viewgraph_key=viewgraph_key, params=params)
+
+    def view_update(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        body = self._require_dict(payload)
+        return self._request(
+            profile,
+            "POST",
+            f"/view/{viewgraph_key}/viewConfig",
+            viewgraph_key=viewgraph_key,
+            json_body=body,
+            risk_operation="update",
+            risk_target="view configuration",
+        )
+
+    def view_delete(self, *, profile: str, viewgraph_key: str) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        return self._request(
+            profile,
+            "DELETE",
+            f"/view/{viewgraph_key}",
+            viewgraph_key=viewgraph_key,
+            risk_operation="delete",
+            risk_target="view configuration",
+        )
+
+    def view_copy(self, *, profile: str, viewgraph_key: str) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        return self._request(profile, "POST", f"/view/{viewgraph_key}/copy", viewgraph_key=viewgraph_key)
+
+    def view_list_questions(self, *, profile: str, viewgraph_key: str) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/question", viewgraph_key=viewgraph_key)
+
+    def view_list_associations(self, *, profile: str, viewgraph_key: str) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/association", viewgraph_key=viewgraph_key)
+
+    def view_update_member_config(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        body = self._require_dict(payload)
+        return self._request(
+            profile,
+            "POST",
+            f"/view/{viewgraph_key}/member/config",
+            viewgraph_key=viewgraph_key,
+            json_body=body,
+            risk_operation="update",
+            risk_target="view member visibility",
+        )
+
+    def view_update_apply_config(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        body = self._require_dict(payload)
+        return self._request(
+            profile,
+            "POST",
+            f"/view/{viewgraph_key}/apply/config",
+            viewgraph_key=viewgraph_key,
+            json_body=body,
+            risk_operation="update",
+            risk_target="view apply visibility",
+        )
+
+    def view_board_set_lane_config(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        body = self._require_dict(payload)
+        return self._request(
+            profile,
+            "POST",
+            f"/view/{viewgraph_key}/lane/config",
+            viewgraph_key=viewgraph_key,
+            json_body=body,
+            risk_operation="update",
+            risk_target="board lane configuration",
+        )
+
+    def view_board_get_lane_base_info(self, *, profile: str, viewgraph_key: str, page_num: int, page_size: int) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        return self._request(
+            profile,
+            "GET",
+            f"/view/{viewgraph_key}/lane/baseInfo",
+            viewgraph_key=viewgraph_key,
+            params={"pageNum": page_num, "pageSize": page_size},
+        )
+
+    def view_gantt_switch_auto_calibration(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        body = self._require_dict(payload)
+        return self._request(
+            profile,
+            "PUT",
+            f"/view/gantt/{viewgraph_key}/auto/calibration",
+            viewgraph_key=viewgraph_key,
+            json_body=body,
+            risk_operation="update",
+            risk_target="gantt auto calibration settings",
+        )
+
+    def view_gantt_batch_update_time(self, *, profile: str, viewgraph_key: str, payload: JSONObject) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        body = self._require_dict(payload)
+        return self._request(
+            profile,
+            "PUT",
+            f"/view/gantt/{viewgraph_key}/batch/update",
+            viewgraph_key=viewgraph_key,
+            json_body=body,
+            risk_operation="update",
+            risk_target="gantt task timing",
+        )
+
+    def view_get_future_nodes(self, *, profile: str, viewgraph_key: str, apply_id: int, app_key: str) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        self._require_app_key(app_key)
+        self._require_positive("apply_id", apply_id)
+        return self._request(
+            profile,
+            "GET",
+            f"/view/{viewgraph_key}/auditNode/futureList/{apply_id}",
+            viewgraph_key=viewgraph_key,
+            app_key=app_key,
+            apply_id=apply_id,
+            params={"appKey": app_key},
+        )
+
+    def view_get_workflow_status(self, *, profile: str, viewgraph_key: str, row_record_id: int) -> JSONObject:
+        self._require_viewgraph_key(viewgraph_key)
+        self._require_positive("row_record_id", row_record_id)
+        return self._request(profile, "GET", f"/view/{viewgraph_key}/workflow/status/{row_record_id}", viewgraph_key=viewgraph_key, row_record_id=row_record_id)
+
+    def _request(
+        self,
+        profile: str,
+        method: str,
+        path: str,
+        *,
+        json_body: JSONValue = None,
+        params: JSONObject | None = None,
+        risk_operation: str | None = None,
+        risk_target: str | None = None,
+        **extra: JSONValue,
+    ) -> JSONObject:
+        def runner(session_profile, context):
+            result = self.backend.request(method, context, path, json_body=json_body, params=params)
+            response: JSONObject = {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
+            response.update(extra)
+            if risk_operation and risk_target:
+                return self._attach_human_review_notice(response, operation=risk_operation, target=risk_target)
+            return response
+
+        return self._run(profile, runner)
+
+    def _require_app_key(self, app_key: str) -> None:
+        if not app_key:
+            raise_tool_error(QingflowApiError.config_error("app_key is required"))
+
+    def _require_viewgraph_key(self, viewgraph_key: str) -> None:
+        if not viewgraph_key:
+            raise_tool_error(QingflowApiError.config_error("viewgraph_key is required"))
+
+    def _require_positive(self, field_name: str, value: int) -> None:
+        if value <= 0:
+            raise_tool_error(QingflowApiError.config_error(f"{field_name} must be positive"))
+
+    def _normalize_reorder_payload(self, payload: list[JSONObject]) -> list[JSONObject]:
+        first_item = payload[0]
+        if "ordinalType" in first_item and "viewKeyList" in first_item:
+            return payload
+        if "ordinalType" in first_item and "viewList" in first_item:
+            normalized_groups: list[JSONObject] = []
+            for group in payload:
+                view_list = group.get("viewList")
+                view_keys = [
+                    str(view.get("viewKey"))
+                    for view in view_list
+                    if isinstance(view_list, list) and isinstance(view, dict) and view.get("viewKey")
+                ]
+                if group.get("ordinalType") and view_keys:
+                    normalized_groups.append({"ordinalType": group["ordinalType"], "viewKeyList": view_keys})
+            if normalized_groups:
+                return normalized_groups
+        sorted_items = sorted(
+            payload,
+            key=lambda item: int(item.get("ordinal", payload.index(item))) if isinstance(item.get("ordinal"), int) else payload.index(item),
+        )
+        view_keys = [
+            str(item.get("viewgraphKey") or item.get("viewKey"))
+            for item in sorted_items
+            if item.get("viewgraphKey") or item.get("viewKey")
+        ]
+        if not view_keys:
+            raise_tool_error(QingflowApiError.config_error("payload must include viewgraphKey/viewKey or ordinalType/viewKeyList"))
+        return [{"ordinalType": "FIXED_VIEW_LIST", "viewKeyList": view_keys}]

package/src/qingflow_mcp/tools/workflow_tools.py

@@ -0,0 +1,312 @@
+from __future__ import annotations
+
+from mcp.server.fastmcp import FastMCP
+
+from ..backend_client import BackendRequestContext
+from ..config import DEFAULT_PROFILE
+from ..errors import QingflowApiError, raise_tool_error
+from ..json_types import JSONObject, JSONValue
+from .base import ToolBase
+
+
+class WorkflowTools(ToolBase):
+    def register(self, mcp: FastMCP) -> None:
+        @mcp.tool()
+        def workflow_list_nodes(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.workflow_list_nodes(profile=profile, app_key=app_key)
+
+        @mcp.tool()
+        def workflow_get_node_detail(profile: str = DEFAULT_PROFILE, app_key: str = "", audit_node_id: int = 0) -> JSONObject:
+            return self.workflow_get_node_detail(profile=profile, app_key=app_key, audit_node_id=audit_node_id)
+
+        @mcp.tool()
+        def workflow_get_global_settings(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.workflow_get_global_settings(profile=profile, app_key=app_key)
+
+        @mcp.tool()
+        def workflow_get_future_nodes(profile: str = DEFAULT_PROFILE, app_key: str = "", apply_id: int = 0) -> JSONObject:
+            return self.workflow_get_future_nodes(profile=profile, app_key=app_key, apply_id=apply_id)
+
+        @mcp.tool()
+        def workflow_get_future_nodes_app(
+            profile: str = DEFAULT_PROFILE,
+            app_key: str = "",
+            apply_id: int = 0,
+            role: int = 1,
+            audit_node_id: int | None = None,
+        ) -> JSONObject:
+            return self.workflow_get_future_nodes_app(
+                profile=profile,
+                app_key=app_key,
+                apply_id=apply_id,
+                role=role,
+                audit_node_id=audit_node_id,
+            )
+
+        @mcp.tool()
+        def workflow_get_qsource_active(profile: str = DEFAULT_PROFILE, app_key: str = "", qsource_id: int = 0) -> JSONObject:
+            return self.workflow_get_qsource_active(profile=profile, app_key=app_key, qsource_id=qsource_id)
+
+        @mcp.tool()
+        def workflow_get_qsource_passive(profile: str = DEFAULT_PROFILE, app_key: str = "", qsource_id: int = 0) -> JSONObject:
+            return self.workflow_get_qsource_passive(profile=profile, app_key=app_key, qsource_id=qsource_id)
+
+        @mcp.tool()
+        def workflow_get_editable_question_ids(profile: str = DEFAULT_PROFILE, app_key: str = "", audit_node_id: int = 0) -> JSONObject:
+            return self.workflow_get_editable_question_ids(profile=profile, app_key=app_key, audit_node_id=audit_node_id)
+
+        @mcp.tool()
+        def workflow_get_print_nodes(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
+            return self.workflow_get_print_nodes(profile=profile, app_key=app_key)
+
+    def workflow_list_nodes(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNodes", app_key=app_key)
+
+    def workflow_get_node_detail(self, *, profile: str, app_key: str, audit_node_id: int) -> JSONObject:
+        self._require_app_key(app_key)
+        self._require_positive("audit_node_id", audit_node_id)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNodes/{audit_node_id}", app_key=app_key, audit_node_id=audit_node_id)
+
+    def workflow_add_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request_with_post_fallbacks(
+            profile=profile,
+            app_key=app_key,
+            path=f"/app/{app_key}/auditNodes",
+            json_body=body,
+            alternate_paths=[f"/app/{app_key}/auditNode"],
+        )
+
+    def workflow_update_node(self, *, profile: str, app_key: str, audit_node_id: int, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        self._require_positive("audit_node_id", audit_node_id)
+        body = self._require_dict(payload)
+        return self._request_with_post_fallbacks(
+            profile=profile,
+            app_key=app_key,
+            path=f"/app/{app_key}/auditNodes/{audit_node_id}",
+            json_body=body,
+            alternate_paths=[f"/app/{app_key}/auditNode/{audit_node_id}"],
+            risk_operation="update",
+            risk_target="workflow node configuration",
+            audit_node_id=audit_node_id,
+        )
+
+    def workflow_delete_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow node configuration")
+
+    def workflow_copy_paste_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/copyAndPaste", app_key=app_key, json_body=body)
+
+    def workflow_cut_paste_node(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/cutAndPaste", app_key=app_key, json_body=body)
+
+    def workflow_create_sub_branch(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/subBranch", app_key=app_key, json_body=body)
+
+    def workflow_delete_sub_branch(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode/subBranch", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow branch configuration")
+
+    def workflow_get_global_settings(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/workflow/global/setting", app_key=app_key)
+
+    def workflow_update_global_settings(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request_with_post_fallbacks(
+            profile=profile,
+            app_key=app_key,
+            path=f"/app/{app_key}/workflow/global/setting",
+            json_body=body,
+            alternate_paths=[],
+            risk_operation="update",
+            risk_target="workflow global settings",
+        )
+
+    def workflow_publish(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request_with_post_fallbacks(
+            profile=profile,
+            app_key=app_key,
+            path=f"/app/{app_key}/publish",
+            json_body=body,
+            alternate_paths=[],
+        )
+
+    def workflow_get_future_nodes(self, *, profile: str, app_key: str, apply_id: int) -> JSONObject:
+        self._require_app_key(app_key)
+        self._require_positive("apply_id", apply_id)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/futureList/{apply_id}", app_key=app_key, apply_id=apply_id)
+
+    def workflow_get_future_nodes_app(
+        self,
+        *,
+        profile: str,
+        app_key: str,
+        apply_id: int,
+        role: int,
+        audit_node_id: int | None,
+    ) -> JSONObject:
+        self._require_app_key(app_key)
+        self._require_positive("apply_id", apply_id)
+        params: JSONObject = {"role": role}
+        if audit_node_id is not None:
+            self._require_positive("audit_node_id", audit_node_id)
+            params["auditNodeId"] = audit_node_id
+        return self._request(
+            profile,
+            "GET",
+            f"/app/{app_key}/auditNode/appFutureListV2/{apply_id}",
+            app_key=app_key,
+            apply_id=apply_id,
+            params=params,
+        )
+
+    def workflow_webhook_test(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/webhookTest", app_key=app_key, json_body=body)
+
+    def workflow_qsource_query(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/qSourceQuery", app_key=app_key, json_body=body)
+
+    def workflow_qsource_test(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/qSourceQueryTest", app_key=app_key, json_body=body)
+
+    def workflow_get_qsource_active(self, *, profile: str, app_key: str, qsource_id: int) -> JSONObject:
+        self._require_app_key(app_key)
+        self._require_positive("qsource_id", qsource_id)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/active/qsource", app_key=app_key, params={"qSourceId": qsource_id})
+
+    def workflow_upsert_qsource_active(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/active/qsource", app_key=app_key, json_body=body)
+
+    def workflow_get_qsource_passive(self, *, profile: str, app_key: str, qsource_id: int) -> JSONObject:
+        self._require_app_key(app_key)
+        self._require_positive("qsource_id", qsource_id)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/passive/qsource", app_key=app_key, params={"qSourceId": qsource_id})
+
+    def workflow_upsert_qsource_passive(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/passive/qsource", app_key=app_key, json_body=body)
+
+    def workflow_switch_qsource_status(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "POST", f"/app/{app_key}/auditNode/source/status", app_key=app_key, json_body=body)
+
+    def workflow_delete_qsource(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+        return self._request(profile, "DELETE", f"/app/{app_key}/auditNode/qsource", app_key=app_key, json_body=body, risk_operation="delete", risk_target="workflow qsource configuration")
+
+    def workflow_get_editable_question_ids(self, *, profile: str, app_key: str, audit_node_id: int) -> JSONObject:
+        self._require_app_key(app_key)
+        self._require_positive("audit_node_id", audit_node_id)
+        return self._request(
+            profile,
+            "GET",
+            f"/app/{app_key}/auditNode/{audit_node_id}/editableQueIds",
+            app_key=app_key,
+            audit_node_id=audit_node_id,
+        )
+
+    def workflow_get_print_nodes(self, *, profile: str, app_key: str) -> JSONObject:
+        self._require_app_key(app_key)
+        return self._request(profile, "GET", f"/app/{app_key}/auditNode/printNodes", app_key=app_key)
+
+    def _request(
+        self,
+        profile: str,
+        method: str,
+        path: str,
+        *,
+        app_key: str,
+        json_body: JSONValue = None,
+        params: JSONObject | None = None,
+        risk_operation: str | None = None,
+        risk_target: str | None = None,
+        **extra: JSONValue,
+    ) -> JSONObject:
+        def runner(session_profile, context):
+            result = self.backend.request(method, context, path, json_body=json_body, params=params)
+            response: JSONObject = {"profile": profile, "ws_id": session_profile.selected_ws_id, "app_key": app_key, "result": result}
+            response.update(extra)
+            if risk_operation and risk_target:
+                return self._attach_human_review_notice(response, operation=risk_operation, target=risk_target)
+            return response
+
+        return self._run(profile, runner)
+
+    def _request_with_post_fallbacks(
+        self,
+        *,
+        profile: str,
+        app_key: str,
+        path: str,
+        json_body: JSONObject,
+        alternate_paths: list[str],
+        risk_operation: str | None = None,
+        risk_target: str | None = None,
+        **extra: JSONValue,
+    ) -> JSONObject:
+        def runner(session_profile, context):
+            attempted_contexts = [context]
+            if context.qf_version is not None:
+                attempted_contexts.append(
+                    BackendRequestContext(
+                        base_url=context.base_url,
+                        token=context.token,
+                        ws_id=context.ws_id,
+                        qf_version=None,
+                        qf_version_source="workflow_retry_without_qf_version",
+                    )
+                )
+            paths = [path, *alternate_paths]
+            last_error: QingflowApiError | None = None
+            for call_context in attempted_contexts:
+                for candidate_path in paths:
+                    try:
+                        result = self.backend.request("POST", call_context, candidate_path, json_body=json_body)
+                        response: JSONObject = {"profile": profile, "ws_id": session_profile.selected_ws_id, "result": result}
+                        response.update(extra)
+                        if risk_operation and risk_target:
+                            return self._attach_human_review_notice(response, operation=risk_operation, target=risk_target)
+                        return response
+                    except QingflowApiError as error:
+                        last_error = error
+                        if error.http_status != 404:
+                            raise
+            assert last_error is not None
+            raise last_error
+
+        return self._run(profile, runner)
+
+    def _require_app_key(self, app_key: str) -> None:
+        if not app_key:
+            raise_tool_error(QingflowApiError.config_error("app_key is required"))
+
+    def _require_positive(self, field_name: str, value: int) -> None:
+        if value <= 0:
+            raise_tool_error(QingflowApiError.config_error(f"{field_name} must be positive"))