@qingflow-tech/qingflow-cli 1.1.42 → 1.1.43-beta.1

package/src/qingflow_mcp/tools/app_tools.py

@@ -20,8 +20,11 @@ class AppTools(ToolBase):
     类型：应用元数据与配置工具。
     主要职责：
     1. 查询应用列表、读取应用详情；
-    2. 读取与更新应用基础配置、表单结构与发布状态；
-    3. 提供应用创建、删除、发布等管理能力。
+    2. 为声明式 AppForm 和 Solution 编排保留底层应用适配器；
+    3. 仅将应用列表与详情注册为本类的 MCP 入口。
+
+    TODO(deprecation): Remove the imperative app-form adapters after AppForm and Solution
+    no longer call them. They are implementation details and must not be registered as MCP tools.
     """
 
     def register(self, mcp: FastMCP) -> None:
@@ -34,58 +37,6 @@ class AppTools(ToolBase):
         def app_get(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
             return self.app_get(profile=profile, app_key=app_key)
 
-        @mcp.tool()
-        def app_get_base(profile: str = DEFAULT_PROFILE, app_key: str = "", include_raw: bool = False) -> JSONObject:
-            return self.app_get_base(profile=profile, app_key=app_key, include_raw=include_raw)
-
-        @mcp.tool(description=self._high_risk_tool_description(operation="update", target="app base settings"))
-        def app_update_base(profile: str = DEFAULT_PROFILE, app_key: str = "", payload: JSONObject | None = None) -> JSONObject:
-            return self.app_update_base(profile=profile, app_key=app_key, payload=payload or {})
-
-        @mcp.tool()
-        def app_get_form_schema(
-            profile: str = DEFAULT_PROFILE,
-            app_key: str = "",
-            form_type: int | str = 1,
-            being_draft: bool | None = None,
-            being_apply: bool | None = None,
-            audit_node_id: int | None = None,
-            include_raw: bool = False,
-        ) -> JSONObject:
-            return self.app_get_form_schema(
-                profile=profile,
-                app_key=app_key,
-                form_type=form_type,
-                being_draft=being_draft,
-                being_apply=being_apply,
-                audit_node_id=audit_node_id,
-                include_raw=include_raw,
-            )
-
-        @mcp.tool()
-        def app_get_edit_version_no(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
-            return self.app_get_edit_version_no(profile=profile, app_key=app_key)
-
-        @mcp.tool()
-        def app_edit_finished(profile: str = DEFAULT_PROFILE, app_key: str = "", payload: JSONObject | None = None) -> JSONObject:
-            return self.app_edit_finished(profile=profile, app_key=app_key, payload=payload or {})
-
-        @mcp.tool()
-        def app_create(profile: str = DEFAULT_PROFILE, payload: JSONObject | None = None) -> JSONObject:
-            return self.app_create(profile=profile, payload=payload or {})
-
-        @mcp.tool(description=self._high_risk_tool_description(operation="delete", target="app configuration"))
-        def app_delete(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
-            return self.app_delete(profile=profile, app_key=app_key)
-
-        @mcp.tool()
-        def app_publish(
-            profile: str = DEFAULT_PROFILE,
-            app_key: str = "",
-            payload: JSONObject | None = None,
-        ) -> JSONObject:
-            return self.app_publish(profile=profile, app_key=app_key, payload=payload or {})
-
     def app_list(self, *, profile: str, query: str = "", keyword: str = "", ship_auth: bool = False) -> JSONObject:
         """List current-user visible apps in the selected workspace."""
         def runner(session_profile, context):
@@ -294,7 +245,7 @@ class AppTools(ToolBase):
         return self._run(profile, runner, tool_name='应用详情')
 
     def app_get_base(self, *, profile: str, app_key: str, include_raw: bool = False) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         self._require_app_key(app_key)
 
         def runner(session_profile, context):
@@ -343,7 +294,7 @@ class AppTools(ToolBase):
         return self._run(profile, runner, tool_name='应用基础信息')
 
     def app_update_base(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
 
@@ -368,7 +319,7 @@ class AppTools(ToolBase):
         audit_node_id: int | None,
         include_raw: bool = False,
     ) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         self._require_app_key(app_key)
         resolved_form_type = _normalize_form_type(form_type)
 
@@ -398,7 +349,7 @@ class AppTools(ToolBase):
         return self._run(profile, runner, tool_name='应用表单结构')
 
     def app_get_edit_version_no(self, *, profile: str, app_key: str) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         self._require_app_key(app_key)
 
         def runner(session_profile, context):
@@ -446,7 +397,7 @@ class AppTools(ToolBase):
         return self._run(profile, runner, tool_name='更新应用流程配置')
 
     def app_update_form_schema(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
 
@@ -461,7 +412,7 @@ class AppTools(ToolBase):
         return self._run(profile, runner, tool_name='更新应用表单结构')
 
     def app_edit_finished(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
 
@@ -471,13 +422,19 @@ class AppTools(ToolBase):
 
         return self._run(profile, runner, tool_name='应用编辑完成')
 
-    def app_create(self, *, profile: str, payload: JSONObject) -> JSONObject:
-        """执行应用相关逻辑。"""
+    def app_create(
+        self,
+        *,
+        profile: str,
+        payload: JSONObject,
+        retry_without_qf_version: bool = True,
+    ) -> JSONObject:
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         body = self._require_dict(payload)
 
         def runner(session_profile, context):
             attempted_contexts = [context]
-            if context.qf_version is not None:
+            if retry_without_qf_version and context.qf_version is not None:
                 attempted_contexts.append(
                     BackendRequestContext(
                         base_url=context.base_url,
@@ -519,7 +476,7 @@ class AppTools(ToolBase):
         return self._run(profile, runner, tool_name='创建应用')
 
     def app_delete(self, *, profile: str, app_key: str) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for the declarative delete path pending deletion."""
         self._require_app_key(app_key)
 
         def runner(session_profile, context):
@@ -533,7 +490,7 @@ class AppTools(ToolBase):
         return self._run(profile, runner, tool_name='删除应用')
 
     def app_publish(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
-        """执行应用相关逻辑。"""
+        """Legacy low-level app-form adapter retained for internal callers pending deletion."""
         self._require_app_key(app_key)
         body = self._require_dict(payload)
 
@@ -543,6 +500,30 @@ class AppTools(ToolBase):
 
         return self._run(profile, runner, tool_name='发布应用')
 
+    def app_publish_raw(self, *, profile: str, app_key: str, payload: JSONObject) -> JSONObject:
+        """Legacy low-level publish adapter retained for internal callers pending deletion."""
+        self._require_app_key(app_key)
+        body = self._require_dict(payload)
+
+        def runner(session_profile, context):
+            response = self.backend.request_with_meta(
+                "POST",
+                context,
+                f"/app/{app_key}/publish",
+                json_body=body,
+                unwrap=False,
+            )
+            return {
+                "profile": profile,
+                "ws_id": session_profile.selected_ws_id,
+                "app_key": app_key,
+                "http_status": response.http_status,
+                "request_id": response.request_id,
+                "response": response.data,
+            }
+
+        return self._run(profile, runner, tool_name='发布应用')
+
     def _require_app_key(self, app_key: str) -> None:
         """执行内部辅助逻辑。"""
         if not app_key: