@qingflow-tech/qingflow-app-builder-mcp 1.0.31 → 1.0.33

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.31
+npm install @qingflow-tech/qingflow-app-builder-mcp@1.0.33
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.31 qingflow-app-builder-mcp
+npx -y -p @qingflow-tech/qingflow-app-builder-mcp@1.0.33 qingflow-app-builder-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-app-builder-mcp",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "description": "Builder MCP for Qingflow app/package/system design and staged solution workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

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

@@ -162,9 +162,6 @@ def _handle_action(args: argparse.Namespace, context: CliContext) -> dict:
     return context.task.task_action_execute(
         profile=args.profile,
         task_id=args.task_id,
-        app_key=args.app_key or "",
-        record_id=args.record_id or "",
-        workflow_node_id=int(args.workflow_node_id or 0),
         action=args.action,
         payload=payload,
         fields=fields,
@@ -225,9 +222,6 @@ def _run_task_workbench_task_loop(args: argparse.Namespace, context: CliContext)
         result = context.task.task_action_execute(
             profile=args.profile,
             task_id=args.task_id,
-            app_key=args.app_key or "",
-            record_id=args.record_id or "",
-            workflow_node_id=int(args.workflow_node_id or 0),
             action=args.action,
             payload=payload_selection,
             fields={},

package/src/qingflow_mcp/cli/main.py

@@ -9,6 +9,7 @@ from ..errors import QingflowApiError, backend_code_value_int, message_looks_lik
 from ..public_surface import cli_public_tool_spec_from_namespace
 from ..response_trim import resolve_cli_tool_name, trim_error_response, trim_public_response
 from ..tools.ai_builder_tools import _attach_builder_apply_envelope
+from ..version import get_cli_version
 from .context import CliContext, build_cli_context
 from .formatters import emit_json_result, emit_text_result
 from .commands import register_all_commands
@@ -34,7 +35,10 @@ def build_parser() -> argparse.ArgumentParser:
     parser = _QingflowArgumentParser(prog="qingflow", description="Qingflow CLI")
     parser.add_argument("--profile", default="default", help="会话 profile，默认 default")
     parser.add_argument("--json", action="store_true", help="输出 JSON")
+    parser.add_argument("--version", action="store_true", help="输出 Qingflow CLI 版本")
     subparsers = parser.add_subparsers(dest="command", required=True)
+    version_parser = subparsers.add_parser("version", help="输出 Qingflow CLI 版本")
+    version_parser.set_defaults(handler=_handle_version, format_hint="version")
     register_all_commands(subparsers)
     return parser
 
@@ -54,6 +58,8 @@ def run(
     err = stderr or sys.stderr
     parser = build_parser()
     normalized_argv = _normalize_global_args(list(argv) if argv is not None else sys.argv[1:])
+    if "--version" in normalized_argv:
+        return _emit_version(json_mode=_should_force_json_output_argv_for_version(normalized_argv), stdout=out)
     try:
         args = parser.parse_args(normalized_argv)
     except _CliArgumentError as exc:
@@ -76,6 +82,8 @@ def run(
     setattr(args, "_stdin", sys.stdin)
     setattr(args, "_stdout_stream", out)
     setattr(args, "_stderr_stream", err)
+    if getattr(args, "command", "") == "version":
+        return _emit_version(json_mode=bool(args.json), stdout=out)
     handler = getattr(args, "handler", None)
     if handler is None:
         parser.print_help(out)
@@ -111,6 +119,37 @@ def run(
     return exit_code
 
 
+def _handle_version(_args: argparse.Namespace, _context: CliContext) -> dict[str, Any]:
+    version = get_cli_version()
+    return {
+        "ok": True,
+        "status": "success",
+        "version": version,
+        "package": "@qingflow-tech/qingflow-cli",
+    }
+
+
+def _emit_version(*, json_mode: bool, stdout: TextIO) -> int:
+    version = get_cli_version()
+    if json_mode:
+        emit_json_result(
+            {
+                "ok": True,
+                "status": "success",
+                "version": version,
+                "package": "@qingflow-tech/qingflow-cli",
+            },
+            stream=stdout,
+        )
+    else:
+        stdout.write(f"{version}\n")
+    return 0
+
+
+def _should_force_json_output_argv_for_version(argv: list[str]) -> bool:
+    return "--json" in argv
+
+
 def _normalize_global_args(argv: list[str]) -> list[str]:
     global_args: list[str] = []
     remaining: list[str] = []
@@ -121,6 +160,10 @@ def _normalize_global_args(argv: list[str]) -> list[str]:
             global_args.append(token)
             index += 1
             continue
+        if token == "--version":
+            global_args.append(token)
+            index += 1
+            continue
         if token == "--profile":
             global_args.append(token)
             if index + 1 >= len(argv):

package/src/qingflow_mcp/server.py

@@ -186,7 +186,7 @@ Use `record_code_block_run` when the user wants to execute a form code-block fie
 - `task_list` returns task-card summaries keyed by `task_id`.
 - For detail reads and actions, pass the exact `task_id` from `task_list.data.items[].task_id`.
 - `task_id` is not a row number, list index, record id, or workflow node id.
-- Do not reconstruct task actions from `app_key + record_id + workflow_node_id` unless the user explicitly provides that full locator for troubleshooting.
+- `task_action_execute` only uses `task_id`; do not reconstruct or pass `app_key + record_id + workflow_node_id` for actions.
 - `task_workflow_log_get(task_id=...)` and `task_associated_report_detail_get(task_id=...)` are also supported for the current todo context.
 - Use `task_associated_report_detail_get` for associated view or report details.
 - Use `task_workflow_log_get` for the current task context workflow log page. For full record-level data/workflow logs, first choose an accessible view with `app_get`, then call `record_logs_get(app_key, record_id, view_id)` with that same explicit `view_id`.

package/src/qingflow_mcp/server_app_user.py

@@ -191,7 +191,7 @@ Use export only when the user explicitly asks to export/download/generate an Exc
 - `task_list` returns task-card summaries keyed by `task_id`.
 - For detail reads and actions, pass the exact `task_id` from `task_list.data.items[].task_id`.
 - `task_id` is not a row number, list index, record id, or workflow node id.
-- Do not reconstruct task actions from `app_key + record_id + workflow_node_id` unless the user explicitly provides that full locator for troubleshooting.
+- `task_action_execute` only uses `task_id`; do not reconstruct or pass `app_key + record_id + workflow_node_id` for actions.
 - `task_workflow_log_get(task_id=...)` and `task_associated_report_detail_get(task_id=...)` are also supported for the current todo context.
 - Use `task_associated_report_detail_get` for associated view or report details.
 - Use `task_workflow_log_get` for the current task context workflow log page. For full record-level data/workflow logs, first choose an accessible view with `app_get`, then call `record_logs_get(app_key, record_id, view_id)` with that same explicit `view_id`.

package/src/qingflow_mcp/tools/approval_tools.py

@@ -1055,7 +1055,7 @@ class ApprovalTools(ToolBase):
         if node_id is None:
             node_payload = dict(payload or {})
             node_id = self._extract_node_id(node_payload)
-        delegated = TaskContextTools(self.sessions, self.backend).task_action_execute(
+        delegated = TaskContextTools(self.sessions, self.backend)._task_action_execute_with_locator(
             profile=profile,
             app_key=app_key,
             record_id=record_id,

package/src/qingflow_mcp/tools/task_context_tools.py

@@ -126,9 +126,6 @@ class TaskContextTools(ToolBase):
             return self.task_action_execute(
                 profile=profile,
                 task_id=task_id,
-                app_key="",
-                record_id="",
-                workflow_node_id=0,
                 action=action,
                 payload=payload or {},
                 fields=fields or {},
@@ -317,9 +314,7 @@ class TaskContextTools(ToolBase):
         self,
         *,
         profile: str,
-        app_key: str,
-        record_id: Any,
-        workflow_node_id: int,
+        task_id: Any,
         fields: dict[str, Any] | None = None,
     ) -> dict[str, Any]:
         """执行任务相关逻辑。"""
@@ -328,9 +323,7 @@ class TaskContextTools(ToolBase):
             raise_tool_error(QingflowApiError.config_error("fields is required and must be non-empty for task_save_only"))
         return self.task_action_execute(
             profile=profile,
-            app_key=app_key,
-            record_id=record_id,
-            workflow_node_id=workflow_node_id,
+            task_id=task_id,
             action="save_only",
             payload={},
             fields=field_updates,
@@ -338,6 +331,34 @@ class TaskContextTools(ToolBase):
 
     @tool_cn_name("执行任务动作")
     def task_action_execute(
+        self,
+        *,
+        profile: str,
+        task_id: Any,
+        action: str,
+        payload: dict[str, Any],
+        fields: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """执行任务相关逻辑。"""
+        if task_id in (None, ""):
+            raise_tool_error(
+                QingflowApiError.config_error(
+                    "task_id is required for task_action_execute; get it from task_list.data.items[].task_id"
+                )
+            )
+
+        return self._task_action_execute_with_locator(
+            profile=profile,
+            task_id=task_id,
+            app_key="",
+            record_id="",
+            workflow_node_id=0,
+            action=action,
+            payload=payload,
+            fields=fields,
+        )
+
+    def _task_action_execute_with_locator(
         self,
         *,
         profile: str,
@@ -349,10 +370,8 @@ class TaskContextTools(ToolBase):
         payload: dict[str, Any],
         fields: dict[str, Any] | None = None,
     ) -> dict[str, Any]:
-        """执行任务相关逻辑。"""
         if task_id in (None, ""):
             normalize_positive_id_int(record_id, field_name="record_id")
-
         normalized_action = (action or "").strip().lower()
         if normalized_action not in {"approve", "reject", "rollback", "transfer", "urge", "save_only"}:
             raise_tool_error(
@@ -492,7 +511,7 @@ class TaskContextTools(ToolBase):
                     raise_tool_error(QingflowApiError.config_error(message))
                 raise_tool_error(
                     QingflowApiError.config_error(
-                        f"task action '{normalized_action}' is not currently available for app_key='{resolved_app_key}' record_id={record_id_text} workflow_node_id={resolved_workflow_node_id}"
+                        f"task action '{normalized_action}' is not currently available for task_id='{task_id_text}'"
                     )
                 )
             feedback_required_for = capabilities.get("action_constraints", {}).get("feedback_required_for") or []

package/src/qingflow_mcp/version.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import json
+from importlib import metadata
+from pathlib import Path
+
+
+def get_cli_version() -> str:
+    package_json_version = _find_package_json_version()
+    if package_json_version:
+        return package_json_version
+    try:
+        return metadata.version("qingflow-mcp")
+    except metadata.PackageNotFoundError:
+        return "0+local"
+
+
+def _find_package_json_version() -> str | None:
+    current = Path(__file__).resolve()
+    for parent in current.parents:
+        package_json = parent / "package.json"
+        if not package_json.exists():
+            continue
+        try:
+            payload = json.loads(package_json.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError):
+            continue
+        name = str(payload.get("name") or "")
+        version = str(payload.get("version") or "")
+        if version and name in {
+            "qingflow-mcp-workspace",
+            "@qingflow-tech/qingflow-cli",
+            "@qingflow-tech/qingflow-app-user-mcp",
+            "@qingflow-tech/qingflow-app-builder-mcp",
+            "@josephyan/qingflow-cli",
+            "@josephyan/qingflow-app-user-mcp",
+            "@josephyan/qingflow-app-builder-mcp",
+        }:
+            return version
+    return None