@josephyan/qingflow-cli 0.2.0-beta.77 → 0.2.0-beta.79

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

@@ -89,8 +89,21 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     package_create.add_argument("--package-name", required=True)
     package_create.add_argument("--icon")
     package_create.add_argument("--color")
+    package_create.add_argument("--visibility-file")
     package_create.set_defaults(handler=_handle_package_create, format_hint="builder_summary")
 
+    package_get = package_subparsers.add_parser("get", help="读取应用包详情")
+    package_get.add_argument("--tag-id", type=int, required=True)
+    package_get.set_defaults(handler=_handle_package_get, format_hint="builder_summary")
+
+    package_update = package_subparsers.add_parser("update", help="更新应用包")
+    package_update.add_argument("--tag-id", type=int, required=True)
+    package_update.add_argument("--package-name")
+    package_update.add_argument("--icon")
+    package_update.add_argument("--color")
+    package_update.add_argument("--visibility-file")
+    package_update.set_defaults(handler=_handle_package_update, format_hint="builder_summary")
+
     package_attach_app = package_subparsers.add_parser("attach-app", help="将应用挂载到应用包")
     package_attach_app.add_argument("--tag-id", type=int, required=True)
     package_attach_app.add_argument("--app-key", required=True)
@@ -172,6 +185,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     portal_apply.add_argument("--package-tag-id", type=int)
     portal_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=True)
     portal_apply.add_argument("--sections-file", required=True)
+    portal_apply.add_argument("--visibility-file")
     portal_apply.add_argument("--auth-file")
     portal_apply.add_argument("--icon")
     portal_apply.add_argument("--color")
@@ -189,6 +203,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     schema_apply_apply.add_argument("--app-title", default="")
     schema_apply_apply.add_argument("--icon")
     schema_apply_apply.add_argument("--color")
+    schema_apply_apply.add_argument("--visibility-file")
     schema_apply_apply.add_argument("--create-if-missing", action="store_true")
     schema_apply_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=True)
     schema_apply_apply.add_argument("--add-fields-file")
@@ -339,6 +354,22 @@ def _handle_package_create(args: argparse.Namespace, context: CliContext) -> dic
         package_name=args.package_name,
         icon=args.icon,
         color=args.color,
+        visibility=load_object_arg(args.visibility_file, option_name="--visibility-file"),
+    )
+
+
+def _handle_package_get(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.package_get(profile=args.profile, tag_id=args.tag_id)
+
+
+def _handle_package_update(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.package_update(
+        profile=args.profile,
+        tag_id=args.tag_id,
+        package_name=args.package_name,
+        icon=args.icon,
+        color=args.color,
+        visibility=load_object_arg(args.visibility_file, option_name="--visibility-file"),
     )
 
 
@@ -477,6 +508,7 @@ def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
         app_title=args.app_title,
         icon=args.icon,
         color=args.color,
+        visibility=load_object_arg(args.visibility_file, option_name="--visibility-file"),
         create_if_missing=bool(args.create_if_missing),
         publish=bool(args.publish),
         add_fields=load_list_arg(args.add_fields_file, option_name="--add-fields-file"),
@@ -547,6 +579,7 @@ def _handle_portal_apply(args: argparse.Namespace, context: CliContext) -> dict:
         package_tag_id=args.package_tag_id,
         publish=bool(args.publish),
         sections=require_list_arg(args.sections_file, option_name="--sections-file"),
+        visibility=load_object_arg(args.visibility_file, option_name="--visibility-file"),
         auth=load_object_arg(args.auth_file, option_name="--auth-file"),
         icon=args.icon,
         color=args.color,

package/src/qingflow_mcp/cli/main.py

@@ -6,6 +6,7 @@ import sys
 from typing import Any, Callable, TextIO
 
 from ..errors import QingflowApiError
+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 .context import CliContext, build_cli_context
 from .formatters import emit_json_result, emit_text_result
@@ -49,6 +50,8 @@ def run(
         return 2
     context = context_factory()
     try:
+        if not bool(args.json):
+            _emit_cli_effective_context_notice(args, context, stream=err)
         result = handler(args, context)
     except RuntimeError as exc:
         payload = trim_error_response(_parse_error_payload(exc))
@@ -145,5 +148,31 @@ def _result_exit_code(result: dict[str, Any]) -> int:
     return 0
 
 
+def _emit_cli_effective_context_notice(args: argparse.Namespace, context: CliContext, *, stream: TextIO) -> None:
+    spec = cli_public_tool_spec_from_namespace(args)
+    if spec is None or not spec.cli_show_effective_context:
+        return
+    sessions = getattr(context, "sessions", None)
+    if sessions is None or not hasattr(sessions, "get_profile"):
+        return
+    profile_name = str(getattr(args, "profile", "default") or "default")
+    try:
+        session_profile = sessions.get_profile(profile_name)
+    except Exception:
+        session_profile = None
+    workspace_id = getattr(session_profile, "selected_ws_id", None) if session_profile is not None else None
+    workspace_name = getattr(session_profile, "selected_ws_name", None) if session_profile is not None else None
+    if workspace_id is None:
+        workspace_label = "(not selected)"
+    elif workspace_name:
+        workspace_label = f"{workspace_name} ({workspace_id})"
+    else:
+        workspace_label = str(workspace_id)
+    lines = [f"Context: profile={profile_name} workspace={workspace_label}"]
+    if spec.cli_context_write and profile_name == "default":
+        lines.append("Warning: using default profile for a workspace-sensitive write command")
+    stream.write("\n".join(lines) + "\n")
+
+
 if __name__ == "__main__":
     main()

package/src/qingflow_mcp/public_surface.py

@@ -17,6 +17,8 @@ class PublicToolSpec:
     mcp_public: bool = True
     cli_public: bool = True
     has_contract: bool = False
+    cli_show_effective_context: bool = False
+    cli_context_write: bool = False
 
     @property
     def trim_key(self) -> str:
@@ -34,13 +36,13 @@ USER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(USER_DOMAIN, "auth_logout", ("auth_logout",), ("auth", "logout")),
     PublicToolSpec(USER_DOMAIN, "workspace_list", ("workspace_list",), ("workspace", "list")),
     PublicToolSpec(USER_DOMAIN, "workspace_select", ("workspace_select",), ("workspace", "select")),
-    PublicToolSpec(USER_DOMAIN, "app_list", ("app_list",), ("app", "list")),
-    PublicToolSpec(USER_DOMAIN, "app_search", ("app_search",), ("app", "search")),
-    PublicToolSpec(USER_DOMAIN, "app_get", ("app_get",), ("app", "get")),
-    PublicToolSpec(USER_DOMAIN, "portal_list", ("portal_list",), ("portal", "list")),
-    PublicToolSpec(USER_DOMAIN, "portal_get", ("portal_get",), ("portal", "get")),
-    PublicToolSpec(USER_DOMAIN, "view_get", ("view_get",), ("view", "get")),
-    PublicToolSpec(USER_DOMAIN, "chart_get", ("chart_get",), ("chart", "get")),
+    PublicToolSpec(USER_DOMAIN, "app_list", ("app_list",), ("app", "list"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "app_search", ("app_search",), ("app", "search"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "app_get", ("app_get",), ("app", "get"), cli_show_effective_context=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),
+    PublicToolSpec(USER_DOMAIN, "chart_get", ("chart_get",), ("chart", "get"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "file_get_upload_info", ("file_get_upload_info",), cli_public=False),
     PublicToolSpec(USER_DOMAIN, "file_upload_local", ("file_upload_local",), cli_public=False),
     PublicToolSpec(USER_DOMAIN, "feedback_submit", ("feedback_submit",), cli_public=False),
@@ -78,22 +80,22 @@ USER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(USER_DOMAIN, "record_member_candidates", ("record_member_candidates",), cli_public=False),
     PublicToolSpec(USER_DOMAIN, "record_department_candidates", ("record_department_candidates",), cli_public=False),
     PublicToolSpec(USER_DOMAIN, "record_analyze", ("record_analyze",), ("record", "analyze")),
-    PublicToolSpec(USER_DOMAIN, "record_list", ("record_list",), ("record", "list")),
-    PublicToolSpec(USER_DOMAIN, "record_get", ("record_get_public",), ("record", "get")),
-    PublicToolSpec(USER_DOMAIN, "record_insert", ("record_insert_public",), ("record", "insert")),
-    PublicToolSpec(USER_DOMAIN, "record_update", ("record_update_public",), ("record", "update")),
-    PublicToolSpec(USER_DOMAIN, "record_delete", ("record_delete_public",), ("record", "delete")),
+    PublicToolSpec(USER_DOMAIN, "record_list", ("record_list",), ("record", "list"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "record_get", ("record_get_public",), ("record", "get"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "record_insert", ("record_insert_public",), ("record", "insert"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "record_update", ("record_update_public",), ("record", "update"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "record_delete", ("record_delete_public",), ("record", "delete"), cli_show_effective_context=True, cli_context_write=True),
     PublicToolSpec(USER_DOMAIN, "record_import_template_get", ("record_import_template_get",), ("import", "template")),
     PublicToolSpec(USER_DOMAIN, "record_import_verify", ("record_import_verify",), ("import", "verify")),
     PublicToolSpec(USER_DOMAIN, "record_import_repair_local", ("record_import_repair_local",), ("import", "repair")),
     PublicToolSpec(USER_DOMAIN, "record_import_start", ("record_import_start",), ("import", "start")),
     PublicToolSpec(USER_DOMAIN, "record_import_status_get", ("record_import_status_get",), ("import", "status")),
-    PublicToolSpec(USER_DOMAIN, "record_code_block_run", ("record_code_block_run",), ("record", "code-block-run")),
-    PublicToolSpec(USER_DOMAIN, "task_list", ("task_list",), ("task", "list")),
-    PublicToolSpec(USER_DOMAIN, "task_get", ("task_get",), ("task", "get")),
-    PublicToolSpec(USER_DOMAIN, "task_action_execute", ("task_action_execute",), ("task", "action")),
-    PublicToolSpec(USER_DOMAIN, "task_associated_report_detail_get", ("task_associated_report_detail_get",), cli_public=False),
-    PublicToolSpec(USER_DOMAIN, "task_workflow_log_get", ("task_workflow_log_get",), ("task", "log")),
+    PublicToolSpec(USER_DOMAIN, "record_code_block_run", ("record_code_block_run",), ("record", "code-block-run"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "task_list", ("task_list",), ("task", "list"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "task_get", ("task_get",), ("task", "get"), cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "task_action_execute", ("task_action_execute",), ("task", "action"), cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(USER_DOMAIN, "task_associated_report_detail_get", ("task_associated_report_detail_get",), cli_public=False, cli_show_effective_context=True),
+    PublicToolSpec(USER_DOMAIN, "task_workflow_log_get", ("task_workflow_log_get",), ("task", "log"), cli_show_effective_context=True),
     PublicToolSpec(USER_DOMAIN, "directory_search", ("directory_search",), cli_public=False),
     PublicToolSpec(USER_DOMAIN, "directory_list_internal_users", ("directory_list_internal_users",), cli_public=False),
     PublicToolSpec(USER_DOMAIN, "directory_list_all_internal_users", ("directory_list_all_internal_users",), cli_public=False),
@@ -111,42 +113,44 @@ BUILDER_PUBLIC_TOOL_SPECS: tuple[PublicToolSpec, ...] = (
     PublicToolSpec(BUILDER_DOMAIN, "auth_logout", ("auth_logout",), ("builder", "auth", "logout"), cli_public=False),
     PublicToolSpec(BUILDER_DOMAIN, "workspace_list", ("workspace_list",), ("builder", "workspace", "list"), cli_public=False),
     PublicToolSpec(BUILDER_DOMAIN, "workspace_select", ("workspace_select",), ("builder", "workspace", "select"), cli_public=False),
-    PublicToolSpec(BUILDER_DOMAIN, "file_upload_local", ("file_upload_local",), ("builder", "file", "upload-local"), has_contract=True),
+    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),
     PublicToolSpec(BUILDER_DOMAIN, "feedback_submit", ("feedback_submit",), ("builder", "feedback", "submit"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "package_list", ("package_list",), ("builder", "package", "list"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "package_resolve", ("package_resolve",), ("builder", "package", "resolve"), has_contract=True),
+    PublicToolSpec(BUILDER_DOMAIN, "package_list", ("package_list",), ("builder", "package", "list"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "package_resolve", ("package_resolve",), ("builder", "package", "resolve"), has_contract=True, cli_show_effective_context=True),
     PublicToolSpec(BUILDER_DOMAIN, "builder_tool_contract", ("builder_tool_contract",), ("builder", "contract"), has_contract=False),
-    PublicToolSpec(BUILDER_DOMAIN, "package_create", ("package_create",), ("builder", "package", "create"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "solution_install", ("solution_install",), ("builder", "solution", "install"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "member_search", ("member_search",), ("builder", "member", "search"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "role_search", ("role_search",), ("builder", "role", "search"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "role_create", ("role_create",), ("builder", "role", "create"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "package_attach_app", ("package_attach_app",), ("builder", "package", "attach-app"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_release_edit_lock_if_mine", ("app_release_edit_lock_if_mine",), ("builder", "app", "release-edit-lock-if-mine"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_resolve", ("app_resolve",), ("builder", "app", "resolve"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_list", ("app_custom_button_list",), ("builder", "button", "list"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_get", ("app_custom_button_get",), ("builder", "button", "get"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_create", ("app_custom_button_create",), ("builder", "button", "create"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_update", ("app_custom_button_update",), ("builder", "button", "update"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_delete", ("app_custom_button_delete",), ("builder", "button", "delete"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_get", ("app_get",), ("builder", "app", "get", "summary"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_get_fields", ("app_get_fields",), ("builder", "app", "get", "fields"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_repair_code_blocks", ("app_repair_code_blocks",), ("builder", "app", "repair-code-blocks"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_get_layout", ("app_get_layout",), ("builder", "app", "get", "layout"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_get_views", ("app_get_views",), ("builder", "app", "get", "views"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_get_flow", ("app_get_flow",), ("builder", "app", "get", "flow"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_get_charts", ("app_get_charts",), ("builder", "app", "get", "charts"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "portal_list", ("portal_list",), ("builder", "portal", "list"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "portal_get", ("portal_get",), ("builder", "portal", "get"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "view_get", ("view_get",), ("builder", "view", "get"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "chart_get", ("chart_get",), ("builder", "chart", "get"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_schema_apply", ("app_schema_apply",), ("builder", "schema", "apply"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_layout_apply", ("app_layout_apply",), ("builder", "layout", "apply"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_flow_apply", ("app_flow_apply",), ("builder", "flow", "apply"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_views_apply", ("app_views_apply",), ("builder", "views", "apply"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_charts_apply", ("app_charts_apply",), ("builder", "charts", "apply"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "portal_apply", ("portal_apply",), ("builder", "portal", "apply"), has_contract=True),
-    PublicToolSpec(BUILDER_DOMAIN, "app_publish_verify", ("app_publish_verify",), ("builder", "publish", "verify"), has_contract=True),
+    PublicToolSpec(BUILDER_DOMAIN, "package_create", ("package_create",), ("builder", "package", "create"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "package_get", ("package_get",), ("builder", "package", "get"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "package_update", ("package_update",), ("builder", "package", "update"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "solution_install", ("solution_install",), ("builder", "solution", "install"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "member_search", ("member_search",), ("builder", "member", "search"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "role_search", ("role_search",), ("builder", "role", "search"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "role_create", ("role_create",), ("builder", "role", "create"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "package_attach_app", ("package_attach_app",), ("builder", "package", "attach-app"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_release_edit_lock_if_mine", ("app_release_edit_lock_if_mine",), ("builder", "app", "release-edit-lock-if-mine"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_resolve", ("app_resolve",), ("builder", "app", "resolve"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_list", ("app_custom_button_list",), ("builder", "button", "list"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_get", ("app_custom_button_get",), ("builder", "button", "get"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_create", ("app_custom_button_create",), ("builder", "button", "create"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_update", ("app_custom_button_update",), ("builder", "button", "update"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_custom_button_delete", ("app_custom_button_delete",), ("builder", "button", "delete"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_get", ("app_get",), ("builder", "app", "get", "summary"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_get_fields", ("app_get_fields",), ("builder", "app", "get", "fields"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_repair_code_blocks", ("app_repair_code_blocks",), ("builder", "app", "repair-code-blocks"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_get_layout", ("app_get_layout",), ("builder", "app", "get", "layout"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_get_views", ("app_get_views",), ("builder", "app", "get", "views"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_get_flow", ("app_get_flow",), ("builder", "app", "get", "flow"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_get_charts", ("app_get_charts",), ("builder", "app", "get", "charts"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "portal_list", ("portal_list",), ("builder", "portal", "list"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "portal_get", ("portal_get",), ("builder", "portal", "get"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "view_get", ("view_get",), ("builder", "view", "get"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "chart_get", ("chart_get",), ("builder", "chart", "get"), has_contract=True, cli_show_effective_context=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_schema_apply", ("app_schema_apply",), ("builder", "schema", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_layout_apply", ("app_layout_apply",), ("builder", "layout", "apply"), 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),
+    PublicToolSpec(BUILDER_DOMAIN, "portal_apply", ("portal_apply",), ("builder", "portal", "apply"), has_contract=True, cli_show_effective_context=True, cli_context_write=True),
+    PublicToolSpec(BUILDER_DOMAIN, "app_publish_verify", ("app_publish_verify",), ("builder", "publish", "verify"), has_contract=True, cli_show_effective_context=True),
 )
 
 
@@ -195,6 +199,13 @@ def cli_trim_key_from_namespace(args: Namespace) -> str | None:
     return spec.trim_key if spec is not None else None
 
 
+def cli_public_tool_spec_from_namespace(args: Namespace) -> PublicToolSpec | None:
+    route = cli_route_from_namespace(args)
+    if route is None:
+        return None
+    return PUBLIC_TOOL_BY_CLI_ROUTE.get(route)
+
+
 def cli_route_from_namespace(args: Namespace) -> tuple[str, ...] | None:
     command = getattr(args, "command", None)
     if not isinstance(command, str) or not command:

package/src/qingflow_mcp/server_app_builder.py

@@ -197,8 +197,31 @@ def build_builder_server() -> FastMCP:
         package_name: str = "",
         icon: str | None = None,
         color: str | None = None,
+        visibility: dict | None = None,
     ) -> dict:
-        return ai_builder.package_create(profile=profile, package_name=package_name, icon=icon, color=color)
+        return ai_builder.package_create(profile=profile, package_name=package_name, icon=icon, color=color, visibility=visibility)
+
+    @server.tool()
+    def package_get(profile: str = DEFAULT_PROFILE, tag_id: int = 0) -> dict:
+        return ai_builder.package_get(profile=profile, tag_id=tag_id)
+
+    @server.tool()
+    def package_update(
+        profile: str = DEFAULT_PROFILE,
+        tag_id: int = 0,
+        package_name: str | None = None,
+        icon: str | None = None,
+        color: str | None = None,
+        visibility: dict | None = None,
+    ) -> dict:
+        return ai_builder.package_update(
+            profile=profile,
+            tag_id=tag_id,
+            package_name=package_name,
+            icon=icon,
+            color=color,
+            visibility=visibility,
+        )
 
     @server.tool()
     def solution_install(
@@ -388,6 +411,7 @@ def build_builder_server() -> FastMCP:
         app_title: str = "",
         icon: str = "",
         color: str = "",
+        visibility: dict | None = None,
         create_if_missing: bool = False,
         publish: bool = True,
         add_fields: list[dict] | None = None,
@@ -417,6 +441,7 @@ def build_builder_server() -> FastMCP:
             app_title=app_title,
             icon=icon,
             color=color,
+            visibility=visibility,
             create_if_missing=create_if_missing,
             publish=publish,
             add_fields=add_fields or [],
@@ -492,6 +517,7 @@ def build_builder_server() -> FastMCP:
         package_tag_id: int | None = None,
         publish: bool = True,
         sections: list[dict] | None = None,
+        visibility: dict | None = None,
         auth: dict | None = None,
         icon: str | None = None,
         color: str | None = None,
@@ -519,6 +545,7 @@ def build_builder_server() -> FastMCP:
             package_tag_id=package_tag_id,
             publish=publish,
             sections=sections or [],
+            visibility=visibility,
             auth=auth,
             icon=icon,
             color=color,