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

package/README.md

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

package/package.json

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

package/src/qingflow_mcp/__init__.py

@@ -2,4 +2,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.0b48"
+__version__ = "0.2.0b79"

package/src/qingflow_mcp/builder_facade/models.py

@@ -40,6 +40,18 @@ class PublicDepartmentScopeMode(str, Enum):
     custom = "custom"
 
 
+class PublicVisibilityMode(str, Enum):
+    workspace = "workspace"
+    everyone = "everyone"
+    specific = "specific"
+
+
+class PublicExternalVisibilityMode(str, Enum):
+    not_ = "not"
+    workspace = "workspace"
+    specific = "specific"
+
+
 FIELD_TYPE_ALIASES: dict[str, PublicFieldType] = {
     "textarea": PublicFieldType.long_text,
     "amount": PublicFieldType.amount,
@@ -291,7 +303,7 @@ class FieldSelector(StrictModel):
 
     @model_validator(mode="after")
     def validate_selector(self) -> "FieldSelector":
-        if not any((self.field_id, self.que_id, self.name)):
+        if self.field_id is None and self.que_id is None and self.name is None:
             raise ValueError("selector must include field_id, que_id, or name")
         return self
 
@@ -346,6 +358,93 @@ class DepartmentScopePatch(StrictModel):
         return self
 
 
+class VisibilitySelectorsPatch(StrictModel):
+    member_uids: list[int] = Field(default_factory=list, validation_alias=AliasChoices("member_uids", "memberUids"))
+    member_emails: list[str] = Field(default_factory=list, validation_alias=AliasChoices("member_emails", "memberEmails"))
+    member_names: list[str] = Field(default_factory=list, validation_alias=AliasChoices("member_names", "memberNames"))
+    dept_ids: list[int] = Field(default_factory=list, validation_alias=AliasChoices("dept_ids", "deptIds"))
+    dept_names: list[str] = Field(default_factory=list, validation_alias=AliasChoices("dept_names", "deptNames"))
+    role_ids: list[int] = Field(default_factory=list, validation_alias=AliasChoices("role_ids", "roleIds"))
+    role_names: list[str] = Field(default_factory=list, validation_alias=AliasChoices("role_names", "roleNames"))
+    include_sub_departs: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("include_sub_departs", "includeSubDeparts"),
+    )
+
+    def has_any_selector(self) -> bool:
+        return any(
+            (
+                self.member_uids,
+                self.member_emails,
+                self.member_names,
+                self.dept_ids,
+                self.dept_names,
+                self.role_ids,
+                self.role_names,
+            )
+        )
+
+
+class ExternalVisibilitySelectorsPatch(StrictModel):
+    member_ids: list[int] = Field(default_factory=list, validation_alias=AliasChoices("member_ids", "memberIds"))
+    member_emails: list[str] = Field(default_factory=list, validation_alias=AliasChoices("member_emails", "memberEmails"))
+    dept_ids: list[int] = Field(default_factory=list, validation_alias=AliasChoices("dept_ids", "deptIds"))
+
+    def has_any_selector(self) -> bool:
+        return any((self.member_ids, self.member_emails, self.dept_ids))
+
+
+class VisibilityPatch(StrictModel):
+    mode: PublicVisibilityMode | None = None
+    selectors: VisibilitySelectorsPatch = Field(default_factory=VisibilitySelectorsPatch)
+    external_mode: PublicExternalVisibilityMode | None = Field(
+        default=None,
+        validation_alias=AliasChoices("external_mode", "externalMode"),
+    )
+    external_selectors: ExternalVisibilitySelectorsPatch = Field(
+        default_factory=ExternalVisibilitySelectorsPatch,
+        validation_alias=AliasChoices("external_selectors", "externalSelectors"),
+    )
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        selectors = payload.get("selectors")
+        external_selectors = payload.get("external_selectors", payload.get("externalSelectors"))
+        if payload.get("mode") is None:
+            if isinstance(selectors, dict) and selectors:
+                payload["mode"] = PublicVisibilityMode.specific.value
+            else:
+                payload["mode"] = PublicVisibilityMode.workspace.value
+        if payload.get("mode") == PublicVisibilityMode.everyone.value and payload.get("external_mode", payload.get("externalMode")) is None:
+            payload["external_mode"] = PublicExternalVisibilityMode.workspace.value
+        if payload.get("external_mode", payload.get("externalMode")) is None:
+            if isinstance(external_selectors, dict) and external_selectors:
+                payload["external_mode"] = PublicExternalVisibilityMode.specific.value
+            else:
+                payload["external_mode"] = PublicExternalVisibilityMode.not_.value
+        return payload
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "VisibilityPatch":
+        if self.mode == PublicVisibilityMode.specific and not self.selectors.has_any_selector():
+            raise ValueError("specific visibility requires selectors")
+        if self.mode != PublicVisibilityMode.specific and self.selectors.has_any_selector():
+            raise ValueError("selectors are only allowed when mode=specific")
+        if self.mode == PublicVisibilityMode.everyone and self.external_mode != PublicExternalVisibilityMode.workspace:
+            raise ValueError("mode=everyone requires external_mode=workspace")
+        if self.mode == PublicVisibilityMode.everyone and self.external_selectors.has_any_selector():
+            raise ValueError("external_selectors are not allowed when mode=everyone")
+        if self.external_mode == PublicExternalVisibilityMode.specific and not self.external_selectors.has_any_selector():
+            raise ValueError("external_mode=specific requires external_selectors")
+        if self.external_mode != PublicExternalVisibilityMode.specific and self.external_selectors.has_any_selector():
+            raise ValueError("external_selectors are only allowed when external_mode=specific")
+        return self
+
+
 class CodeBlockAliasPathPatch(StrictModel):
     alias_name: str = Field(validation_alias=AliasChoices("alias_name", "aliasName"))
     alias_path: str = Field(validation_alias=AliasChoices("alias_path", "aliasPath"))
@@ -916,6 +1015,7 @@ class ViewUpsertPatch(StrictModel):
     end_field: str | None = Field(default=None, validation_alias=AliasChoices("end_field", "endField"))
     title_field: str | None = Field(default=None, validation_alias=AliasChoices("title_field", "titleField"))
     buttons: list["ViewButtonBindingPatch"] | None = None
+    visibility: VisibilityPatch | None = None
 
     @model_validator(mode="before")
     @classmethod
@@ -1237,6 +1337,7 @@ class ChartUpsertPatch(StrictModel):
     question_config: list[dict[str, Any]] = Field(default_factory=list)
     user_config: list[dict[str, Any]] = Field(default_factory=list)
     config: dict[str, Any] = Field(default_factory=dict)
+    visibility: VisibilityPatch | None = None
 
     @model_validator(mode="before")
     @classmethod
@@ -1413,6 +1514,7 @@ class PortalApplyRequest(StrictModel):
     package_tag_id: int | None = None
     publish: bool = True
     sections: list[PortalSectionPatch] = Field(default_factory=list)
+    visibility: VisibilityPatch | None = None
     auth: dict[str, Any] | None = None
     icon: str | None = None
     color: str | None = None
@@ -1428,6 +1530,8 @@ class PortalApplyRequest(StrictModel):
             raise ValueError("dash_name is required when creating a portal")
         if not self.sections:
             raise ValueError("portal apply requires a non-empty sections list")
+        if self.visibility is not None and self.auth is not None:
+            raise ValueError("visibility and auth cannot be provided together")
         return self
 
 
@@ -1438,6 +1542,7 @@ class AppGetResponse(StrictModel):
     app_key: str
     title: str | None = None
     app_icon: str | None = None
+    visibility: dict[str, Any] = Field(default_factory=dict)
     tag_ids: list[int] = Field(default_factory=list)
     publish_status: int | None = None
     field_count: int = 0
@@ -1512,6 +1617,7 @@ class PortalGetResponse(StrictModel):
     package_tag_ids: list[int] = Field(default_factory=list)
     dash_icon: str | None = None
     hide_copyright: bool | None = None
+    visibility: dict[str, Any] = Field(default_factory=dict)
     auth: dict[str, Any] = Field(default_factory=dict)
     config: dict[str, Any] = Field(default_factory=dict)
     dash_global_config: dict[str, Any] = Field(default_factory=dict)
@@ -1522,6 +1628,7 @@ class PortalGetResponse(StrictModel):
 class ViewGetResponse(StrictModel):
     view_key: str
     base_info: dict[str, Any] = Field(default_factory=dict)
+    visibility: dict[str, Any] = Field(default_factory=dict)
     config: dict[str, Any] = Field(default_factory=dict)
     questions: list[dict[str, Any]] = Field(default_factory=list)
     associations: list[dict[str, Any]] = Field(default_factory=list)
@@ -1530,6 +1637,7 @@ class ViewGetResponse(StrictModel):
 class ChartGetResponse(StrictModel):
     chart_id: str
     base: dict[str, Any] = Field(default_factory=dict)
+    visibility: dict[str, Any] = Field(default_factory=dict)
     config: dict[str, Any] = Field(default_factory=dict)
 
 
@@ -1539,6 +1647,7 @@ class SchemaPlanRequest(StrictModel):
     app_name: str = Field(default="", validation_alias=AliasChoices("app_name", "app_title", "title"))
     icon: str | None = None
     color: str | None = None
+    visibility: VisibilityPatch | None = None
     create_if_missing: bool = False
     add_fields: list[FieldPatch] = Field(default_factory=list)
     update_fields: list[FieldUpdatePatch] = Field(default_factory=list)