@qingflow-tech/qingflow-cli 1.1.48 → 1.1.50

package/src/qingflow_mcp/cli/formatters.py

@@ -8,7 +8,10 @@ from typing import Any, TextIO
 def emit_text_result(result: dict[str, Any], *, hint: str, stream: TextIO) -> None:
     text = _format_cancelled_result(result)
     if text is None:
-        if _is_failed_result(result) and hint != "task_action_execute":
+        if hint in _DATA_FORMAT_HINTS:
+            # 数据面失败也必须保留 field_errors 与列表型 hints，不能先走通用失败裁剪。
+            text = _format_data_result(result)
+        elif _is_failed_result(result) and hint != "task_action_execute":
             text = _format_failed_result(result)
         else:
             formatter = _FORMATTERS.get(hint, _format_generic)
@@ -90,6 +93,92 @@ def _format_generic(result: dict[str, Any]) -> str:
     return "\n".join(lines) + "\n"
 
 
+def _format_data_result(result: dict[str, Any]) -> str:
+    lines = [f"Status: {result.get('status') or ('success' if result.get('ok') is not False else 'failed')}"]
+    if result.get("format") == "csv":
+        files = result.get("files") if isinstance(result.get("files"), list) else []
+        lines.extend(
+            [
+                f"Local dir: {result.get('local_dir') or '-'}",
+                f"Files: {len(files)}",
+            ]
+        )
+        for item in files:
+            if isinstance(item, dict):
+                lines.append(
+                    f"- part {item.get('part')}: {item.get('local_path')} ({item.get('row_count')} rows)"
+                )
+        lines.extend(
+            [
+                f"Rows: {result.get('row_count')}",
+                f"Complete: {result.get('complete')}",
+                f"Truncated: {result.get('truncated')}",
+                f"Safe for final conclusion: {result.get('safe_for_final_conclusion')}",
+                f"Stopped reason: {result.get('stopped_reason') or '-'}",
+            ]
+        )
+    access = result.get("access") if isinstance(result.get("access"), dict) else {}
+    if access:
+        sources = access.get("scope_sources") if isinstance(access.get("scope_sources"), list) else []
+        lines.append(
+            f"Access: level={access.get('level') or '-'} / can_write={access.get('can_write')}"
+            f" / scope_sources={','.join(str(item) for item in sources) or '-'}"
+        )
+
+    records = result.get("records") if isinstance(result.get("records"), dict) else {}
+    if records:
+        items = records.get("items") if isinstance(records.get("items"), list) else []
+        lines.append(
+            "Pagination: "
+            f"page={records.get('page')} / requested_page_size={records.get('requested_page_size')} / "
+            f"page_size={records.get('page_size')} / total={records.get('total')} / "
+            f"has_more={records.get('has_more')} / returned={len(items)}"
+        )
+    record = result.get("record") if isinstance(result.get("record"), dict) else {}
+    if record:
+        lines.append(f"Record ID: {record.get('record_id') or '-'}")
+    items = result.get("items") if isinstance(result.get("items"), list) else []
+    if items:
+        lines.append(f"Items: {len(items)}")
+
+    for key, label in (
+        ("error_code", "Error Code"),
+        ("message", "Message"),
+        ("write_executed", "Write Executed"),
+        ("retry_safe", "Retry Safe"),
+    ):
+        if key in result:
+            lines.append(f"{label}: {result.get(key)}")
+
+    field_errors = result.get("field_errors") if isinstance(result.get("field_errors"), list) else []
+    if field_errors:
+        lines.append("Field Errors:")
+        _append_data_field_errors(lines, field_errors)
+    for index, item in enumerate(items):
+        if not isinstance(item, dict) or not isinstance(item.get("field_errors"), list):
+            continue
+        lines.append(f"Item {index} Field Errors:")
+        _append_data_field_errors(lines, item["field_errors"])
+
+    hints = result.get("hints") if isinstance(result.get("hints"), list) else []
+    lines.append(f"Hints: {len(hints)}")
+    for hint in hints:
+        if isinstance(hint, dict):
+            lines.append(f"- {hint.get('code') or '-'}: {hint.get('message') or '-'}")
+        else:
+            lines.append(f"- {hint}")
+    return "\n".join(lines) + "\n"
+
+
+def _append_data_field_errors(lines: list[str], field_errors: list[Any]) -> None:
+    for error in field_errors:
+        if isinstance(error, dict):
+            lines.append(
+                f"- {error.get('path') or '-'}: {error.get('message') or '-'}"
+                f" / fix_hint={error.get('fix_hint') or '-'}"
+            )
+
+
 def _format_whoami(result: dict[str, Any]) -> str:
     lines = [
         f"User: {result.get('nick_name') or '-'} ({result.get('email') or '-'})",
@@ -147,7 +236,11 @@ def _format_workspace_list(result: dict[str, Any]) -> str:
                 str(item.get("remark") or ""),
             ]
         )
-    return _render_titled_table("Workspaces", ["ws_id", "name", "remark"], rows)
+    text = _render_titled_table("Workspaces", ["ws_id", "name", "remark"], rows)
+    selected = result.get("selected_workspace")
+    if isinstance(selected, dict):
+        text += f"Selected Workspace: {selected.get('wsId')} / {selected.get('workspaceName') or '-'}\n"
+    return text
 
 
 def _format_workspace_get(result: dict[str, Any]) -> str:
@@ -191,9 +284,10 @@ def _format_app_items(result: dict[str, Any]) -> str:
                 str(item.get("app_key") or item.get("appKey") or ""),
                 str(item.get("app_name") or item.get("name") or item.get("title") or ""),
                 str(item.get("package_name") or item.get("tag_name") or ""),
+                str(item.get("uri") or ""),
             ]
         )
-    return _render_titled_table("Apps", ["app_key", "app_name", "package"], rows)
+    return _render_titled_table("Apps", ["app_key", "app_name", "package", "uri"], rows)
 
 
 def _format_app_get(result: dict[str, Any]) -> str:
@@ -201,6 +295,7 @@ def _format_app_get(result: dict[str, Any]) -> str:
     lines = [
         f"App: {data.get('app_name') or '-'}",
         f"App Key: {data.get('app_key') or '-'}",
+        f"URI: {data.get('uri') or '-'}",
         f"Can Create: {data.get('can_create')}",
     ]
     import_capability = data.get("import_capability")
@@ -224,7 +319,7 @@ def _format_app_get(result: dict[str, Any]) -> str:
     lines.append(f"Accessible Views: {len(views)}")
     for item in views[:10]:
         if isinstance(item, dict):
-            lines.append(f"- {item.get('view_id')}: {item.get('name')}")
+            lines.append(f"- {item.get('view_id')}: {item.get('name')} / {item.get('uri') or '-'}")
     _append_warnings(lines, result.get("warnings"))
     return "\n".join(lines) + "\n"
 
@@ -296,6 +391,7 @@ def _format_view_get(result: dict[str, Any]) -> str:
         f"View Key: {data.get('view_key') or '-'}",
         f"App Key: {data.get('app_key') or '-'}",
         f"View Type: {data.get('view_type') or '-'}",
+        f"URI: {data.get('uri') or '-'}",
         f"Analysis Supported: {data.get('analysis_supported')}",
     ]
     if export_capability:
@@ -356,11 +452,9 @@ def _format_record_list(result: dict[str, Any]) -> str:
         lines.append(f"- returned_count: {lookup.get('returned_count')}")
         lines.append(f"- truncated: {lookup.get('truncated')}")
     lines.append(f"Returned Records: {len(items)}")
-    for item in items[:10]:
+    for item in items:
         if isinstance(item, dict):
             lines.append(json.dumps(item, ensure_ascii=False))
-    if len(items) > 10:
-        lines.append(f"... {len(items) - 10} more")
     _append_warnings(lines, result.get("warnings"))
     _append_verification(lines, result.get("verification"))
     return "\n".join(lines) + "\n"
@@ -421,10 +515,11 @@ def _format_record_candidates(result: dict[str, Any]) -> str:
             f"page_size={pagination.get('page_size')} / "
             f"returned={pagination.get('returned_items')} / "
             f"total={pagination.get('reported_total')} / "
-            f"pages={pagination.get('page_amount')}"
+            f"pages={pagination.get('page_amount')} / "
+            f"has_more={pagination.get('has_more')}"
         )
     lines.append(f"Candidates: {len(items)}")
-    for item in items[:20]:
+    for item in items:
         if not isinstance(item, dict):
             lines.append(f"- {item}")
             continue
@@ -446,8 +541,6 @@ def _format_record_candidates(result: dict[str, Any]) -> str:
         if source_labels:
             parts.append("sources=" + ",".join(source_labels))
         lines.append("- " + " / ".join(parts))
-    if len(items) > 20:
-        lines.append(f"... {len(items) - 20} more")
     _append_warnings(lines, result.get("warnings"))
     _append_verification(lines, result.get("verification"))
     return "\n".join(lines) + "\n"
@@ -944,11 +1037,9 @@ def _format_task_associated_report_detail(result: dict[str, Any]) -> str:
         result_payload = data.get("result") if isinstance(data.get("result"), dict) else {}
         items = result_payload.get("items") if isinstance(result_payload.get("items"), list) else []
         lines.append(f"Returned Records: {len(items)}")
-        for item in items[:10]:
+        for item in items:
             if isinstance(item, dict):
                 lines.append(json.dumps(item, ensure_ascii=False))
-        if len(items) > 10:
-            lines.append(f"... {len(items) - 10} more")
     elif result_type == "chart_data":
         result_payload = data.get("result") if isinstance(data.get("result"), dict) else {}
         summary = result_payload.get("summary") if isinstance(result_payload.get("summary"), dict) else {}
@@ -956,11 +1047,9 @@ def _format_task_associated_report_detail(result: dict[str, Any]) -> str:
         if summary:
             lines.append(f"Summary: {json.dumps(summary, ensure_ascii=False)}")
         lines.append(f"Rows: {len(rows)}")
-        for row in rows[:10]:
+        for row in rows:
             if isinstance(row, dict):
                 lines.append(json.dumps(row, ensure_ascii=False))
-        if len(rows) > 10:
-            lines.append(f"... {len(rows) - 10} more")
     resolved_filters = context.get("resolved_filters") if isinstance(context.get("resolved_filters"), list) else []
     if resolved_filters:
         lines.append(f"Resolved Filters: {len(resolved_filters)}")
@@ -1175,6 +1264,9 @@ def _format_export_direct(result: dict[str, Any]) -> str:
 
 def _format_builder_summary(result: dict[str, Any]) -> str:
     lines = []
+    pagination = result.get("pagination")
+    if isinstance(pagination, dict):
+        lines.append("Pagination: " + json.dumps(pagination, ensure_ascii=False))
     emitted: set[str] = set()
     for key, label in (
         ("status", "Status"),
@@ -1184,6 +1276,7 @@ def _format_builder_summary(result: dict[str, Any]) -> str:
         ("view_key", "View Key"),
         ("chart_id", "Chart ID"),
         ("package_id", "Package ID"),
+        ("uri", "URI"),
         ("verified", "Verified"),
         ("write_executed", "Write Executed"),
         ("delete_executed", "Delete Executed"),
@@ -1216,16 +1309,27 @@ def _format_builder_summary(result: dict[str, Any]) -> str:
         "associations",
         "package_ids",
         "app_keys",
+        "resources",
     ):
         value = result.get(key)
         if not isinstance(value, list) and isinstance(data, dict):
             value = data.get(key)
         if isinstance(value, list):
             lines.append(f"{key}: {len(value)}")
-            for item in value[:8]:
+            visible_items = value if isinstance(pagination, dict) else value[:8]
+            for item in visible_items:
                 lines.append("- " + _builder_item_summary(item))
-            if len(value) > 8:
-                lines.append(f"... {len(value) - 8} more")
+            if len(value) > len(visible_items):
+                lines.append(f"... {len(value) - len(visible_items)} more")
+            if key == "apps":
+                uri_lines = [
+                    line
+                    for item in value
+                    for line in _builder_batch_item_uri_lines(item)
+                ]
+                if uri_lines:
+                    lines.append("Resource URIs:")
+                    lines.extend(f"- {line}" for line in uri_lines)
     components = result.get("components") if isinstance(result.get("components"), list) else []
     if components:
         lines.append("Component Refs:")
@@ -1294,6 +1398,7 @@ def _builder_item_summary(item: Any) -> str:
         "uid",
         "userId",
         "email",
+        "uri",
     )
     parts = [
         f"{key}={item.get(key)}"
@@ -1305,6 +1410,50 @@ def _builder_item_summary(item: Any) -> str:
     return " / ".join(parts) if parts else json.dumps(item, ensure_ascii=False)
 
 
+def _builder_batch_item_uri_lines(item: Any) -> list[str]:
+    if not isinstance(item, dict):
+        return []
+    item_status = str(item.get("status") or "").lower()
+    if item_status not in {"success", "partial_success"}:
+        return []
+    data = item.get("data") if isinstance(item.get("data"), dict) else item.get("result")
+    if not isinstance(data, dict) or not _builder_uri_is_confirmed(data, fallback_status=item_status):
+        return []
+    lines: list[str] = []
+    if data.get("uri"):
+        lines.append(f"URI: {data['uri']}")
+    views = data.get("views") if isinstance(data.get("views"), list) else []
+    for view in views:
+        if (
+            isinstance(view, dict)
+            and view.get("uri")
+            and _builder_uri_is_confirmed(view, fallback_status=item_status)
+        ):
+            lines.append(f"View URI: {view['uri']}")
+    return lines
+
+
+def _builder_uri_is_confirmed(value: dict[str, Any], *, fallback_status: str) -> bool:
+    status = str(value.get("status") or fallback_status).lower()
+    operation = str(value.get("operation") or "").lower()
+    return (
+        status in {"success", "partial_success", "unchanged", "verified"}
+        and operation
+        not in {
+            "failed",
+            "pending",
+            "planned",
+            "readback_pending",
+            "pending_readback",
+            "unknown",
+            "remove",
+            "removed",
+            "delete",
+            "deleted",
+        }
+    )
+
+
 def _format_file_upload_local(result: dict[str, Any]) -> str:
     lines = [
         f"Upload Kind: {result.get('upload_kind') or result.get('requested_upload_kind') or '-'}",
@@ -1567,7 +1716,7 @@ def _task_action_debug_lines(result: dict[str, Any]) -> list[str]:
 
 
 def _format_login_link(result: dict[str, Any]) -> str:
-    return f"登录链接：{result['url']}\n过期时间（Unix 毫秒）：{result['expires_at']}\n链接仅可使用一次，请勿泄露。\n"
+    return f"登录链接：{result['url']}\n过期时间（Unix 毫秒）：{result['expires_at']}\n链接只能使用一次，请勿泄露；仅在用户要求打开时才打开。\n"
 
 
 _FORMATTERS = {
@@ -1609,4 +1758,11 @@ _FORMATTERS = {
     "builder_summary": _format_builder_summary,
     "file_upload_local": _format_file_upload_local,
     "feedback_submit": _format_feedback_submit,
+    "data_query": _format_data_result,
+    "data_get": _format_data_result,
+    "data_insert": _format_data_result,
+    "data_update": _format_data_result,
+    "data_delete": _format_data_result,
 }
+
+_DATA_FORMAT_HINTS = {"data_query", "data_get", "data_insert", "data_update", "data_delete"}

package/src/qingflow_mcp/cli/main.py

@@ -2,11 +2,13 @@ from __future__ import annotations
 
 import argparse
 import json
+import os
 import sys
 from typing import Any, Callable, TextIO
 
 from ..errors import QingflowApiError, backend_code_value_int, message_looks_like_invalid_token
 from ..public_surface import cli_public_tool_spec_from_namespace
+from ..resource_uri import cli_resource_base_url
 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, get_cli_version_info
@@ -94,7 +96,8 @@ def run(
         context = context_factory()
         if not bool(args.json):
             _emit_cli_effective_context_notice(args, context, stream=err)
-        result = handler(args, context)
+        with cli_resource_base_url(os.getenv("QINGFLOW_BASE_URL") or ""):
+            result = handler(args, context)
     except SystemExit as exc:
         return int(exc.code or 0)
     except RuntimeError as exc:

package/src/qingflow_mcp/cli/pagination.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+from typing import Any, Callable
+
+from .commands.common import raise_config_error
+
+
+def collect_paginated_items(
+    fetch_page: Callable[[int, int], tuple[list[dict[str, Any]], dict[str, Any]]],
+    *,
+    id_key: str,
+    page_size: int = 100,
+) -> list[dict[str, Any]]:
+    items: list[dict[str, Any]] = []
+    seen: set[str] = set()
+    page = 1
+    fetched_count = 0
+    while True:
+        rows, pagination = fetch_page(page, page_size)
+        previous_count = len(items)
+        for row in rows:
+            if not isinstance(row, dict):
+                continue
+            key = str(row.get(id_key) or "")
+            if key and key not in seen:
+                seen.add(key)
+                items.append(row)
+        fetched_count += len(rows)
+        page_amount = pagination.get("page_amount")
+        total = pagination.get("reported_total")
+        if not rows:
+            break
+        if len(items) == previous_count:
+            raise_config_error("Pagination did not advance; the backend returned the same items again.")
+        if page_amount is not None:
+            if page >= int(page_amount):
+                break
+        elif total is not None:
+            if fetched_count >= int(total):
+                break
+        elif len(rows) < int(pagination.get("page_size") or page_size):
+            break
+        page += 1
+    return items

package/src/qingflow_mcp/config.py

@@ -285,6 +285,66 @@ def get_credit_meter_enabled() -> bool:
     return normalized in {"1", "true", "yes", "on"}
 
 
+# BEGIN temporary flow edit maintenance guard: remove this block when flow editing is restored.
+FLOW_EDIT_MAINTENANCE_NODE_THRESHOLD_DEFAULT = 5
+
+
+def get_flow_edit_maintenance_threshold() -> int | None:
+    """读取流程编辑维护闸门的当前节点数阈值。
+
+    配置键 flow_edit.maintenance_node_threshold / 环境变量
+    QINGFLOW_MCP_FLOW_EDIT_MAINTENANCE_THRESHOLD，默认 5；
+    取值 off|disabled|none（大小写不敏感）返回 None 表示闸门关闭
+    （评测批量等场景的逃生门）；解析失败或负数回退默认值 5。
+    """
+    value = get_config_value(
+        "flow_edit.maintenance_node_threshold",
+        env_var="QINGFLOW_MCP_FLOW_EDIT_MAINTENANCE_THRESHOLD",
+        default=FLOW_EDIT_MAINTENANCE_NODE_THRESHOLD_DEFAULT,
+    )
+    normalized = str(value if value is not None else "").strip().lower()
+    if normalized in {"off", "disabled", "none"}:
+        return None
+    try:
+        threshold = int(normalized)
+    except ValueError:
+        return FLOW_EDIT_MAINTENANCE_NODE_THRESHOLD_DEFAULT
+    return threshold if threshold >= 0 else FLOW_EDIT_MAINTENANCE_NODE_THRESHOLD_DEFAULT
+# END temporary flow edit maintenance guard.
+
+
+DEFAULT_HTTP_RETRY_ATTEMPTS = 3
+DEFAULT_HTTP_RETRY_BASE_SECONDS = 3.0
+
+
+def get_http_retry_attempts() -> int:
+    """传输层单请求最大尝试次数（含首次），≤1 视为不重试。"""
+    value = get_config_value(
+        "http.retry_attempts",
+        env_var="QINGFLOW_MCP_HTTP_RETRY_ATTEMPTS",
+        default=DEFAULT_HTTP_RETRY_ATTEMPTS,
+    )
+    try:
+        parsed = int(value)
+    except (ValueError, TypeError):
+        return DEFAULT_HTTP_RETRY_ATTEMPTS
+    return max(parsed, 1)
+
+
+def get_http_retry_base_seconds() -> float:
+    """传输层重试线性退避基数：第 n 次失败后等待 base × n 秒。"""
+    value = get_config_value(
+        "http.retry_base_seconds",
+        env_var="QINGFLOW_MCP_HTTP_RETRY_BASE_SECONDS",
+        default=DEFAULT_HTTP_RETRY_BASE_SECONDS,
+    )
+    try:
+        parsed = float(value)
+    except (ValueError, TypeError):
+        return DEFAULT_HTTP_RETRY_BASE_SECONDS
+    return parsed if parsed >= 0 else DEFAULT_HTTP_RETRY_BASE_SECONDS
+
+
 def get_credit_usage_base_url() -> str | None:
     value = get_config_value(
         "credit_meter.apaas.base_url",

package/src/qingflow_mcp/public_surface.py

@@ -40,6 +40,11 @@ USER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(USER_DOMAIN, "workspace_select", ("workspace_select",), ("workspace", "select")),
     PublicToolSpec(USER_DOMAIN, "app_list", ("app_list",), ("app", "list"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "app_get", ("app_get",), ("app", "get"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "data_query", ("data_query",), ("data", "query"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "data_get", ("data_get",), ("data", "get"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "data_insert", ("data_insert",), ("data", "insert"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "data_update", ("data_update",), ("data", "update"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "data_delete", ("data_delete",), ("data", "delete"), cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(USER_DOMAIN, "portal_list", ("portal_list",), ("portal", "list"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "portal_get", ("portal_get",), ("portal", "get"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "view_get", ("view_get",), ("view", "get"), cli_show_effective_context=True),
@@ -128,6 +133,7 @@ BUILDER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(BUILDER_DOMAIN, "auth_use_credential", ("auth_use_credential",), ("builder", "auth", "use-credential"), cli_public=False),
     PublicToolSpec(BUILDER_DOMAIN, "auth_whoami", ("auth_whoami",), ("builder", "auth", "whoami"), cli_public=False),
     PublicToolSpec(BUILDER_DOMAIN, "auth_logout", ("auth_logout",), ("builder", "auth", "logout"), cli_public=False),
+    PublicToolSpec(BUILDER_DOMAIN, "get_login_link", ("get_login_link",), mcp_public=True, cli_public=False),
     PublicToolSpec(BUILDER_DOMAIN, "workspace_list", ("workspace_list",), ("builder", "workspace", "list"), cli_public=False),
     PublicToolSpec(BUILDER_DOMAIN, "workspace_get", ("workspace_get",), ("builder", "workspace", "get"), cli_public=False),
     PublicToolSpec(BUILDER_DOMAIN, "file_upload_local", ("file_upload_local",), ("builder", "file", "upload-local"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
@@ -168,6 +174,9 @@ BUILDER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(BUILDER_DOMAIN, "chart_get", ("chart_get",), ("builder", "chart", "get"), has_contract=True, cli_show_effective_context=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_get_schema", ("app_flow_get_schema",), ("builder", "flow", "schema"), has_contract=True, cli_show_effective_context=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_get", ("app_flow_get",), ("builder", "flow", "get"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_flow_validate", ("app_flow_validate",), ("builder", "flow", "validate"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_flow_list_versions", ("app_flow_list_versions",), ("builder", "flow", "versions"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_flow_restore_version", ("app_flow_restore_version",), ("builder", "flow", "restore"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_flow_apply", ("app_flow_apply",), ("builder", "flow", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_views_apply", ("app_views_apply",), ("builder", "views", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(BUILDER_DOMAIN, "app_charts_apply", ("app_charts_apply",), ("builder", "charts", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),