@josephyan/qingflow-cli 0.2.0-beta.66 → 0.2.0-beta.67

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-cli",
-  "version": "0.2.0-beta.66",
+  "version": "0.2.0-beta.67",
   "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.0b66"
+version = "0.2.0b67"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/builder_facade/service.py

@@ -192,7 +192,11 @@ class AiBuilderFacade:
             )
         items = listing.get("items") if isinstance(listing.get("items"), list) else []
         matches = [
-            {"tag_id": item.get("tagId"), "tag_name": item.get("tagName")}
+            {
+                "tag_id": item.get("tagId"),
+                "tag_name": item.get("tagName"),
+                "tag_icon": str(item.get("tagIcon") or "").strip() or None,
+            }
             for item in items
             if isinstance(item, dict) and item.get("tagName") == requested and _coerce_positive_int(item.get("tagId")) is not None
         ]
@@ -226,12 +230,24 @@ class AiBuilderFacade:
             "verification": {},
             "tag_id": match["tag_id"],
             "tag_name": match["tag_name"],
+            "tag_icon": match.get("tag_icon"),
             "match_mode": "exact",
         }
 
-    def package_create(self, *, profile: str, package_name: str) -> JSONObject:
+    def package_create(
+        self,
+        *,
+        profile: str,
+        package_name: str,
+        icon: str | None = None,
+        color: str | None = None,
+    ) -> JSONObject:
         requested = str(package_name or "").strip()
-        normalized_args = {"package_name": requested}
+        normalized_args = {
+            "package_name": requested,
+            **({"icon": icon} if icon else {}),
+            **({"color": color} if color else {}),
+        }
         if not requested:
             return _failed(
                 "PACKAGE_NAME_REQUIRED",
@@ -239,6 +255,12 @@ class AiBuilderFacade:
                 normalized_args=normalized_args,
                 suggested_next_call=None,
             )
+        desired_tag_icon = encode_workspace_icon_with_defaults(
+            icon=icon,
+            color=color,
+            title=requested,
+            fallback_icon_name="files-folder",
+        )
         existing = self.package_resolve(profile=profile, package_name=requested)
         lookup_permission_blocked = None
         if existing.get("status") == "success":
@@ -257,6 +279,7 @@ class AiBuilderFacade:
                 "verification": {"existing_package_reused": True},
                 "tag_id": existing.get("tag_id"),
                 "tag_name": existing.get("tag_name"),
+                "tag_icon": existing.get("tag_icon"),
             }
         if existing.get("error_code") == "AMBIGUOUS_PACKAGE":
             return existing
@@ -271,7 +294,10 @@ class AiBuilderFacade:
         elif existing.get("error_code") not in {"PACKAGE_NOT_FOUND"}:
             return existing
         try:
-            created = self.packages.package_create(profile=profile, payload={"tagName": requested})
+            created = self.packages.package_create(
+                profile=profile,
+                payload={"tagName": requested, "tagIcon": desired_tag_icon},
+            )
         except (QingflowApiError, RuntimeError) as error:
             api_error = _coerce_api_error(error)
             return _failed_from_api_error(
@@ -282,16 +308,26 @@ class AiBuilderFacade:
                     "package_name": requested,
                     **({"lookup_permission_blocked": lookup_permission_blocked} if lookup_permission_blocked is not None else {}),
                 },
-                suggested_next_call={"tool_name": "package_create", "arguments": {"profile": profile, "package_name": requested}},
+                suggested_next_call={
+                    "tool_name": "package_create",
+                    "arguments": {
+                        "profile": profile,
+                        "package_name": requested,
+                        **({"icon": icon} if icon else {}),
+                        **({"color": color} if color else {}),
+                    },
+                },
             )
         result = created.get("result") if isinstance(created.get("result"), dict) else {}
         tag_id = _coerce_positive_int(result.get("tagId"))
         tag_name = str(result.get("tagName") or requested).strip() or requested
+        tag_icon = str(result.get("tagIcon") or desired_tag_icon or "").strip() or None
         if tag_id is None:
             resolved = self.package_resolve(profile=profile, package_name=requested)
             if resolved.get("status") == "success":
                 tag_id = _coerce_positive_int(resolved.get("tag_id"))
                 tag_name = str(resolved.get("tag_name") or tag_name)
+                tag_icon = str(resolved.get("tag_icon") or tag_icon or "").strip() or None
         verified = tag_id is not None
         return {
             "status": "success" if verified else "partial_success",
@@ -310,6 +346,7 @@ class AiBuilderFacade:
             "verification": {"tag_id_verified": verified},
             "tag_id": tag_id,
             "tag_name": tag_name,
+            "tag_icon": tag_icon,
         }
 
     def package_list(self, *, profile: str, trial_status: str = "all") -> JSONObject:

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

@@ -12,10 +12,20 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     package = builder_subparsers.add_parser("package", help="应用包")
     package_subparsers = package.add_subparsers(dest="builder_package_command", required=True)
+    package_list = package_subparsers.add_parser("list", help="列出应用包")
+    package_list.add_argument("--trial-status", default="all")
+    package_list.set_defaults(handler=_handle_package_list, format_hint="builder_summary")
+
     package_resolve = package_subparsers.add_parser("resolve", help="解析应用包")
     package_resolve.add_argument("--package-name", required=True)
     package_resolve.set_defaults(handler=_handle_package_resolve, format_hint="builder_summary")
 
+    package_create = package_subparsers.add_parser("create", help="创建应用包")
+    package_create.add_argument("--package-name", required=True)
+    package_create.add_argument("--icon")
+    package_create.add_argument("--color")
+    package_create.set_defaults(handler=_handle_package_create, format_hint="builder_summary")
+
     app = builder_subparsers.add_parser("app", help="应用")
     app_subparsers = app.add_subparsers(dest="builder_app_command", required=True)
 
@@ -119,10 +129,23 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     publish_verify_verify.set_defaults(handler=_handle_publish_verify, format_hint="builder_summary")
 
 
+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_package_resolve(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.package_resolve(profile=args.profile, package_name=args.package_name)
 
 
+def _handle_package_create(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.package_create(
+        profile=args.profile,
+        package_name=args.package_name,
+        icon=args.icon,
+        color=args.color,
+    )
+
+
 def _handle_app_resolve(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.app_resolve(
         profile=args.profile,

package/src/qingflow_mcp/server_app_builder.py

@@ -138,8 +138,13 @@ def build_builder_server() -> FastMCP:
         return ai_builder.builder_tool_contract(tool_name=tool_name)
 
     @server.tool()
-    def package_create(profile: str = DEFAULT_PROFILE, package_name: str = "") -> dict:
-        return ai_builder.package_create(profile=profile, package_name=package_name)
+    def package_create(
+        profile: str = DEFAULT_PROFILE,
+        package_name: str = "",
+        icon: str | None = None,
+        color: str | None = None,
+    ) -> dict:
+        return ai_builder.package_create(profile=profile, package_name=package_name, icon=icon, color=color)
 
     @server.tool()
     def member_search(

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -82,8 +82,13 @@ class AiBuilderTools(ToolBase):
             return self.builder_tool_contract(tool_name=tool_name)
 
         @mcp.tool()
-        def package_create(profile: str = DEFAULT_PROFILE, package_name: str = "") -> JSONObject:
-            return self.package_create(profile=profile, package_name=package_name)
+        def package_create(
+            profile: str = DEFAULT_PROFILE,
+            package_name: str = "",
+            icon: str | None = None,
+            color: str | None = None,
+        ) -> JSONObject:
+            return self.package_create(profile=profile, package_name=package_name, icon=icon, color=color)
 
         @mcp.tool()
         def member_search(
@@ -425,13 +430,32 @@ class AiBuilderTools(ToolBase):
             "contract": contract,
         }
 
-    def package_create(self, *, profile: str, package_name: str) -> JSONObject:
-        normalized_args = {"package_name": package_name}
+    def package_create(
+        self,
+        *,
+        profile: str,
+        package_name: str,
+        icon: str | None = None,
+        color: str | None = None,
+    ) -> JSONObject:
+        normalized_args = {
+            "package_name": package_name,
+            **({"icon": icon} if icon else {}),
+            **({"color": color} if color else {}),
+        }
         return _safe_tool_call(
-            lambda: self._facade.package_create(profile=profile, package_name=package_name),
+            lambda: self._facade.package_create(profile=profile, package_name=package_name, icon=icon, color=color),
             error_code="PACKAGE_CREATE_FAILED",
             normalized_args=normalized_args,
-            suggested_next_call={"tool_name": "package_create", "arguments": {"profile": profile, "package_name": package_name}},
+            suggested_next_call={
+                "tool_name": "package_create",
+                "arguments": {
+                    "profile": profile,
+                    "package_name": package_name,
+                    **({"icon": icon} if icon else {}),
+                    **({"color": color} if color else {}),
+                },
+            },
         )
 
     def member_search(
@@ -1708,6 +1732,39 @@ def _public_error_message(error_code: str, error: QingflowApiError) -> str:
 
 
 _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
+    "package_list": {
+        "allowed_keys": ["trial_status"],
+        "aliases": {"trialStatus": "trial_status"},
+        "allowed_values": {"trial_status": ["all", "trial", "formal"]},
+        "minimal_example": {
+            "profile": "default",
+            "trial_status": "all",
+        },
+    },
+    "package_resolve": {
+        "allowed_keys": ["package_name"],
+        "aliases": {"packageName": "package_name"},
+        "allowed_values": {},
+        "minimal_example": {
+            "profile": "default",
+            "package_name": "PLM（备用，施工中）",
+        },
+    },
+    "package_create": {
+        "allowed_keys": ["package_name", "icon", "color"],
+        "aliases": {
+            "packageName": "package_name",
+            "iconName": "icon",
+            "iconColor": "color",
+        },
+        "allowed_values": {},
+        "minimal_example": {
+            "profile": "default",
+            "package_name": "项目管理",
+            "icon": "files-folder",
+            "color": "azure",
+        },
+    },
     "member_search": {
         "allowed_keys": ["query", "page_num", "page_size", "contain_disable"],
         "aliases": {},

package/src/qingflow_mcp/tools/package_tools.py

@@ -200,6 +200,7 @@ class PackageTools(ToolBase):
         compact = {
             "tagId": result.get("tagId"),
             "tagName": result.get("tagName"),
+            "tagIcon": result.get("tagIcon") if result.get("tagIcon") is not None else permission_source.get("tagIcon"),
             "publishStatus": result.get("publishStatus") if result.get("publishStatus") is not None else permission_source.get("publishStatus"),
             "beingTrial": result.get("beingTrial"),
             "itemCount": len(tag_items),