@josephyan/qingflow-cli 0.2.0-beta.72 → 0.2.0-beta.73

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-cli@0.2.0-beta.72
+npm install @josephyan/qingflow-cli@0.2.0-beta.73
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-cli@0.2.0-beta.72 qingflow
+npx -y -p @josephyan/qingflow-cli@0.2.0-beta.73 qingflow
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-cli",
-  "version": "0.2.0-beta.72",
+  "version": "0.2.0-beta.73",
   "description": "Human-friendly Qingflow command line interface for auth, record operations, import, tasks, and stable builder flows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

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

package/src/qingflow_mcp/builder_facade/models.py

@@ -187,7 +187,8 @@ class FlowConditionRulePatch(StrictModel):
             return value
         payload = dict(value)
         if "value" in payload and "values" not in payload:
-            payload["values"] = [payload.pop("value")]
+            raw_value = payload.pop("value")
+            payload["values"] = list(raw_value) if isinstance(raw_value, list) else [raw_value]
         raw_operator = payload.get("operator", payload.get("op"))
         if isinstance(raw_operator, str):
             normalized = raw_operator.strip().lower()
@@ -238,7 +239,8 @@ class ViewFilterRulePatch(StrictModel):
             return value
         payload = dict(value)
         if "value" in payload and "values" not in payload:
-            payload["values"] = [payload.pop("value")]
+            raw_value = payload.pop("value")
+            payload["values"] = list(raw_value) if isinstance(raw_value, list) else [raw_value]
         raw_operator = payload.get("operator", payload.get("op"))
         if isinstance(raw_operator, str):
             normalized = raw_operator.strip().lower()
@@ -1092,7 +1094,8 @@ class ChartFilterRulePatch(StrictModel):
             return value
         payload = dict(value)
         if "value" in payload and "values" not in payload:
-            payload["values"] = [payload.pop("value")]
+            raw_value = payload.pop("value")
+            payload["values"] = list(raw_value) if isinstance(raw_value, list) else [raw_value]
         raw_operator = payload.get("operator", payload.get("op"))
         if isinstance(raw_operator, str):
             normalized = raw_operator.strip().lower()

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

@@ -10,6 +10,34 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     parser = subparsers.add_parser("builder", aliases=["build"], help="稳定 builder 命令")
     builder_subparsers = parser.add_subparsers(dest="builder_command", required=True)
 
+    file_parser = builder_subparsers.add_parser("file", help="builder 侧文件上传")
+    file_subparsers = file_parser.add_subparsers(dest="builder_file_command", required=True)
+    file_upload_local = file_subparsers.add_parser("upload-local", help="上传本地文件并返回附件值")
+    file_upload_local.add_argument("--upload-kind", default="attachment")
+    file_upload_local.add_argument("--file-path", required=True)
+    file_upload_local.add_argument("--upload-mark")
+    file_upload_local.add_argument("--content-type")
+    file_upload_local.add_argument("--bucket-type")
+    file_upload_local.add_argument("--path-id", type=int)
+    file_upload_local.add_argument("--file-related-url")
+    file_upload_local.set_defaults(handler=_handle_file_upload_local, format_hint="generic")
+
+    feedback = builder_subparsers.add_parser("feedback", help="builder 侧反馈提交")
+    feedback_subparsers = feedback.add_subparsers(dest="builder_feedback_command", required=True)
+    feedback_submit = feedback_subparsers.add_parser("submit", help="提交 builder 能力反馈")
+    feedback_submit.add_argument("--category", required=True)
+    feedback_submit.add_argument("--title", required=True)
+    feedback_submit.add_argument("--description", required=True)
+    feedback_submit.add_argument("--expected-behavior")
+    feedback_submit.add_argument("--actual-behavior")
+    feedback_submit.add_argument("--impact-scope")
+    feedback_submit.add_argument("--tool-name")
+    feedback_submit.add_argument("--app-key")
+    feedback_submit.add_argument("--record-id")
+    feedback_submit.add_argument("--workflow-node-id")
+    feedback_submit.add_argument("--note")
+    feedback_submit.set_defaults(handler=_handle_feedback_submit, format_hint="generic")
+
     contract = builder_subparsers.add_parser("contract", help="读取 builder tool 合约")
     contract.add_argument("--tool-name", required=True)
     contract.set_defaults(handler=_handle_contract, format_hint="builder_summary")
@@ -215,6 +243,35 @@ def _handle_package_list(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.package_list(profile=args.profile, trial_status=args.trial_status)
 
 
+def _handle_file_upload_local(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.files.file_upload_local(
+        profile=args.profile,
+        upload_kind=args.upload_kind,
+        file_path=args.file_path,
+        upload_mark=args.upload_mark,
+        content_type=args.content_type,
+        bucket_type=args.bucket_type,
+        path_id=args.path_id,
+        file_related_url=args.file_related_url,
+    )
+
+
+def _handle_feedback_submit(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder_feedback.feedback_submit(
+        category=args.category,
+        title=args.title,
+        description=args.description,
+        expected_behavior=args.expected_behavior,
+        actual_behavior=args.actual_behavior,
+        impact_scope=args.impact_scope,
+        tool_name=args.tool_name,
+        app_key=args.app_key,
+        record_id=args.record_id,
+        workflow_node_id=args.workflow_node_id,
+        note=args.note,
+    )
+
+
 def _handle_contract(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.builder_tool_contract(tool_name=args.tool_name)
 

package/src/qingflow_mcp/cli/context.py

@@ -8,6 +8,8 @@ from ..tools.ai_builder_tools import AiBuilderTools
 from ..tools.app_tools import AppTools
 from ..tools.auth_tools import AuthTools
 from ..tools.code_block_tools import CodeBlockTools
+from ..tools.feedback_tools import FeedbackTools
+from ..tools.file_tools import FileTools
 from ..tools.import_tools import ImportTools
 from ..tools.record_tools import RecordTools
 from ..tools.resource_read_tools import ResourceReadTools
@@ -27,6 +29,8 @@ class CliContext:
     code_block: CodeBlockTools
     imports: ImportTools
     task: TaskContextTools
+    files: FileTools
+    builder_feedback: FeedbackTools
     builder: AiBuilderTools
 
     def close(self) -> None:
@@ -47,5 +51,7 @@ def build_cli_context() -> CliContext:
         code_block=CodeBlockTools(sessions, backend),
         imports=ImportTools(sessions, backend),
         task=TaskContextTools(sessions, backend),
+        files=FileTools(sessions, backend),
+        builder_feedback=FeedbackTools(backend, mcp_side="App Builder MCP"),
         builder=AiBuilderTools(sessions, backend),
     )

package/src/qingflow_mcp/response_trim.py

@@ -170,6 +170,14 @@ def resolve_cli_tool_name(args: Any) -> str | None:
     if command not in {"builder", "build"}:
         return None
     builder_command = getattr(args, "builder_command", None)
+    if builder_command == "file":
+        return {
+            "upload-local": _tool_key(BUILDER_DOMAIN, "file_upload_local"),
+        }.get(getattr(args, "builder_file_command", None))
+    if builder_command == "feedback":
+        return {
+            "submit": _tool_key(BUILDER_DOMAIN, "feedback_submit"),
+        }.get(getattr(args, "builder_feedback_command", None))
     if builder_command == "contract":
         return _tool_key(BUILDER_DOMAIN, "builder_tool_contract")
     if builder_command == "member":

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -1917,6 +1917,50 @@ def _public_error_message(error_code: str, error: QingflowApiError) -> str:
 
 
 _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
+    "file_upload_local": {
+        "allowed_keys": ["upload_kind", "file_path", "upload_mark", "content_type", "bucket_type", "path_id", "file_related_url"],
+        "aliases": {},
+        "allowed_values": {"upload_kind": ["attachment", "login"]},
+        "execution_notes": [
+            "returns upload metadata plus attachment-ready values for later builder or user writes",
+            "upload_kind=attachment may fall back to login upload info when the backend rejects attachment upload info",
+            "upload_mark is recommended for attachment uploads because it affects the remote storage path",
+        ],
+        "minimal_example": {
+            "profile": "default",
+            "upload_kind": "attachment",
+            "file_path": "/absolute/path/to/local-file.txt",
+            "upload_mark": "APP_KEY",
+        },
+    },
+    "feedback_submit": {
+        "allowed_keys": [
+            "category",
+            "title",
+            "description",
+            "expected_behavior",
+            "actual_behavior",
+            "impact_scope",
+            "tool_name",
+            "app_key",
+            "record_id",
+            "workflow_node_id",
+            "note",
+        ],
+        "aliases": {},
+        "allowed_values": {"category": ["bug", "missing_capability", "awkward_workflow", "ux", "docs"]},
+        "execution_notes": [
+            "submit feedback only after explicit user confirmation",
+            "use this when the current builder capability is unsupported or awkward after reasonable attempts",
+            "requires feedback qsource configuration but does not require Qingflow login or workspace selection",
+        ],
+        "minimal_example": {
+            "category": "missing_capability",
+            "title": "builder chart data read gap",
+            "description": "The current builder capability cannot satisfy the requested workflow.",
+            "tool_name": "chart_get",
+        },
+    },
     "package_list": {
         "allowed_keys": ["trial_status"],
         "aliases": {"trialStatus": "trial_status"},
@@ -2019,6 +2063,22 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "package_tag_id": 1001,
         },
     },
+    "app_release_edit_lock_if_mine": {
+        "allowed_keys": ["app_key", "lock_owner_email", "lock_owner_name"],
+        "aliases": {},
+        "allowed_values": {},
+        "execution_notes": [
+            "use this only after a builder write fails with APP_EDIT_LOCKED and the lock belongs to the current user",
+            "supply the lock owner details from the failed write result for a safe release attempt",
+            "after a successful release, retry the blocked builder write or publish verification call",
+        ],
+        "minimal_example": {
+            "profile": "default",
+            "app_key": "APP_KEY",
+            "lock_owner_email": "user@example.com",
+            "lock_owner_name": "当前用户",
+        },
+    },
     "app_custom_button_list": {
         "allowed_keys": ["app_key"],
         "aliases": {},
@@ -2475,6 +2535,9 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "view.buttons.button_type": ["SYSTEM", "CUSTOM"],
             "view.buttons.config_type": ["TOP", "DETAIL"],
         },
+        "execution_notes": [
+            "for multi-value operators such as in, pass values as a list; value may also be used as an alias when it already contains a list",
+        ],
         "minimal_example": {
             "profile": "default",
             "app_key": "APP_KEY",
@@ -2534,6 +2597,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "read back app_get_views after any failed or partial view apply",
             "view existence verification and saved-filter verification are separate; treat filters as unverified until verification.view_filters_verified is true",
             "buttons omitted preserves existing button config; buttons=[] clears all buttons; buttons=[...] replaces the full button config",
+            "for multi-value operators such as in, pass values as a list; value may also be used as an alias when it already contains a list",
         ],
         "minimal_example": {
             "profile": "default",
@@ -2779,6 +2843,21 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             },
         },
     },
+    "app_publish_verify": {
+        "allowed_keys": ["app_key", "expected_package_tag_id"],
+        "aliases": {},
+        "allowed_values": {},
+        "execution_notes": [
+            "verifies that the current app draft has been published and is readable through the builder surface",
+            "expected_package_tag_id is optional and adds an extra package consistency check",
+            "when verification fails because of an edit lock owned by the current user, retry after app_release_edit_lock_if_mine",
+        ],
+        "minimal_example": {
+            "profile": "default",
+            "app_key": "APP_KEY",
+            "expected_package_tag_id": 1001,
+        },
+    },
 }
 
 _PRIVATE_BUILDER_TOOL_CONTRACTS = {