@josephyan/qingflow-app-user-mcp 1.0.9 → 1.1.2

package/src/qingflow_mcp/builder_facade/workflow_spec.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+from typing import Any
+
+from ..backend_client import BackendClient, BackendRequestContext
+from ..json_types import JSONObject, JSONValue
+
+WORKFLOW_SPEC_SCHEMA_PATH = "/api/workflow/spec/schema"
+WORKFLOW_SPEC_GET_PATH = "/api/workflow/spec"
+WORKFLOW_SPEC_APPLY_PATH = "/api/workflow/spec:apply"
+DEFAULT_SCHEMA_VERSION = "vnext-2026-06"
+
+
+def fetch_schema(
+    backend: BackendClient,
+    context: BackendRequestContext,
+    *,
+    schema_version: str | None = None,
+) -> JSONValue:
+    params: JSONObject = {}
+    if schema_version:
+        params["schemaVersion"] = schema_version
+    return backend.request(
+        "GET",
+        context,
+        WORKFLOW_SPEC_SCHEMA_PATH,
+        params=params or None,
+    )
+
+
+def fetch_spec(
+    backend: BackendClient,
+    context: BackendRequestContext,
+    *,
+    app_key: str,
+    version_id: str | None = None,
+) -> JSONValue:
+    params: JSONObject = {"appKey": app_key}
+    if version_id:
+        params["versionId"] = version_id
+    return backend.request("GET", context, WORKFLOW_SPEC_GET_PATH, params=params)
+
+
+def post_apply(
+    backend: BackendClient,
+    context: BackendRequestContext,
+    *,
+    apply_body: JSONObject,
+) -> JSONValue:
+    return backend.request("POST", context, WORKFLOW_SPEC_APPLY_PATH, json_body=apply_body)
+
+
+def verify_apply_response(
+    *,
+    input_spec: JSONObject,
+    apply_result: JSONObject,
+) -> tuple[JSONObject, list[dict[str, Any]], bool]:
+    warnings: list[dict[str, Any]] = []
+    applied_spec = apply_result.get("appliedSpec")
+    diff_summary = apply_result.get("diffSummary")
+    semantic_lint = apply_result.get("semanticLint") if isinstance(apply_result.get("semanticLint"), list) else []
+
+    verification: JSONObject = {
+        "applied_spec_available": isinstance(applied_spec, dict),
+        "version_snapshot_confirmed": False,
+    }
+
+    lint_errors = [
+        item
+        for item in semantic_lint
+        if isinstance(item, dict) and str(item.get("severity") or item.get("level") or "").upper() == "ERROR"
+    ]
+    if lint_errors:
+        verification["semantic_lint_error_count"] = len(lint_errors)
+        for item in lint_errors:
+            warnings.append(
+                {
+                    "code": item.get("code") or "SEMANTIC_LINT_ERROR",
+                    "message": item.get("message") or "workflow spec semantic lint error",
+                    "path": item.get("path"),
+                }
+            )
+
+    diff_failed = False
+    input_ids: set[str] = set()
+    if isinstance(input_spec, dict):
+        input_ids = {
+            str(node.get("id"))
+            for node in (input_spec.get("nodes") or [])
+            if isinstance(node, dict) and node.get("id") is not None
+        }
+    if isinstance(diff_summary, dict) and input_ids:
+        removed = diff_summary.get("nodes", {}).get("removed") if isinstance(diff_summary.get("nodes"), dict) else None
+        if isinstance(removed, list):
+            unexpected = [node_id for node_id in removed if str(node_id) in input_ids]
+            if unexpected:
+                diff_failed = True
+                verification["unexpected_removed_node_ids"] = unexpected
+
+    if isinstance(applied_spec, dict) and isinstance(input_spec, dict):
+        applied_ids = {
+            str(node.get("id"))
+            for node in (applied_spec.get("nodes") or [])
+            if isinstance(node, dict) and node.get("id") is not None
+        }
+        missing_input_ids = sorted(node_id for node_id in input_ids if node_id not in applied_ids)
+        if missing_input_ids and not diff_failed:
+            verification["missing_input_node_ids"] = missing_input_ids
+
+    verified = not lint_errors and not diff_failed and verification.get("applied_spec_available") is True
+    return verification, warnings, verified

package/src/qingflow_mcp/cli/commands/app.py

@@ -13,30 +13,17 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     app_subparsers = parser.add_subparsers(dest="app_command", required=True)
 
     list_parser = app_subparsers.add_parser("list", help="列出可见应用")
+    list_parser.add_argument("--query", default="", help="按关键词在可见应用列表中本地过滤")
+    list_parser.add_argument("--keyword", default="", help="兼容别名；建议使用 --query")
     list_parser.set_defaults(handler=_handle_list, format_hint="app_list")
 
-    search = app_subparsers.add_parser("search", help="搜索应用")
-    search.add_argument("--keyword", default="")
-    search.add_argument("--page", type=int, default=1)
-    search.add_argument("--page-size", type=int, default=50)
-    search.set_defaults(handler=_handle_search, format_hint="app_search")
-
     get = app_subparsers.add_parser("get", help="读取应用可访问视图与导入能力")
     get.add_argument("--app-key", help="不传时在交互终端中选择应用")
     get.set_defaults(handler=_handle_get, format_hint="app_get")
 
 
 def _handle_list(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.app.app_list(profile=args.profile)
-
-
-def _handle_search(args: argparse.Namespace, context: CliContext) -> dict:
-    return context.app.app_search(
-        profile=args.profile,
-        keyword=args.keyword,
-        page_num=args.page,
-        page_size=args.page_size,
-    )
+    return context.app.app_list(profile=args.profile, query=args.query, keyword=args.keyword)
 
 
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict: