@josephyan/qingflow-cli 0.2.0-beta.61 → 0.2.0-beta.63

package/README.md

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

package/package.json

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

package/src/qingflow_mcp/builder_facade/models.py

@@ -74,6 +74,23 @@ class PublicViewType(str, Enum):
     gantt = "gantt"
 
 
+class PublicButtonTriggerAction(str, Enum):
+    add_data = "addData"
+    link = "link"
+    qrobot = "qRobot"
+    wings = "wings"
+
+
+class PublicViewButtonType(str, Enum):
+    system = "SYSTEM"
+    custom = "CUSTOM"
+
+
+class PublicViewButtonConfigType(str, Enum):
+    top = "TOP"
+    detail = "DETAIL"
+
+
 class PublicChartType(str, Enum):
     target = "target"
     pie = "pie"
@@ -473,6 +490,7 @@ class ViewUpsertPatch(StrictModel):
     start_field: str | None = Field(default=None, validation_alias=AliasChoices("start_field", "startField"))
     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
 
     @model_validator(mode="before")
     @classmethod
@@ -514,6 +532,207 @@ class ViewUpsertPatch(StrictModel):
         return self
 
 
+class CustomButtonJudgeValuePatch(StrictModel):
+    id: int | str | None = None
+    value: Any | None = None
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "opt_id" in payload and "id" not in payload:
+            payload["id"] = payload.pop("opt_id")
+        if "member_id" in payload and "id" not in payload:
+            payload["id"] = payload.pop("member_id")
+        return payload
+
+
+class CustomButtonQuestionRefPatch(StrictModel):
+    que_id: int = Field(validation_alias=AliasChoices("que_id", "queId"))
+    que_title: str | None = Field(default=None, validation_alias=AliasChoices("que_title", "queTitle"))
+    que_type: int | None = Field(default=None, validation_alias=AliasChoices("que_type", "queType"))
+
+
+class CustomButtonMatchRulePatch(StrictModel):
+    que_id: int = Field(validation_alias=AliasChoices("que_id", "queId"))
+    que_title: str | None = Field(default=None, validation_alias=AliasChoices("que_title", "queTitle"))
+    que_type: int | None = Field(default=None, validation_alias=AliasChoices("que_type", "queType"))
+    date_type: int | None = Field(default=None, validation_alias=AliasChoices("date_type", "dateType"))
+    judge_type: int | None = Field(default=None, validation_alias=AliasChoices("judge_type", "judgeType"))
+    match_type: int | None = Field(default=None, validation_alias=AliasChoices("match_type", "matchType"))
+    judge_values: list[str] = Field(default_factory=list, validation_alias=AliasChoices("judge_values", "judgeValues"))
+    judge_que_type: int | None = Field(default=None, validation_alias=AliasChoices("judge_que_type", "judgeQueType"))
+    judge_que_id: int | None = Field(default=None, validation_alias=AliasChoices("judge_que_id", "judgeQueId"))
+    judge_que_detail: CustomButtonQuestionRefPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("judge_que_detail", "judgeQueDetail"),
+    )
+    judge_value_details: list[CustomButtonJudgeValuePatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("judge_value_details", "judgeValueDetails"),
+    )
+    path_value: str | None = Field(default=None, validation_alias=AliasChoices("path_value", "pathValue"))
+    table_update_type: int | None = Field(default=None, validation_alias=AliasChoices("table_update_type", "tableUpdateType"))
+    multi_value: bool | None = Field(default=None, validation_alias=AliasChoices("multi_value", "multiValue"))
+    add_rule: str | None = Field(default=None, validation_alias=AliasChoices("add_rule", "addRule"))
+    filter_condition: list[list["CustomButtonMatchRulePatch"]] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("filter_condition", "filterCondition"),
+    )
+    field_id_prefix: str | None = Field(default=None, validation_alias=AliasChoices("field_id_prefix", "fieldIdPrefix"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "judgeValue" in payload and "judge_values" not in payload and "judgeValues" not in payload:
+            payload["judge_values"] = [payload.pop("judgeValue")]
+        return payload
+
+
+class CustomButtonAddDataConfigPatch(StrictModel):
+    related_app_key: str | None = Field(default=None, validation_alias=AliasChoices("related_app_key", "relatedAppKey"))
+    related_app_name: str | None = Field(default=None, validation_alias=AliasChoices("related_app_name", "relatedAppName"))
+    que_relation: list[CustomButtonMatchRulePatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("que_relation", "queRelation"),
+    )
+
+
+class CustomButtonExternalQRobotConfigPatch(StrictModel):
+    external_qrobot_config_id: int | None = Field(
+        default=None,
+        validation_alias=AliasChoices("external_qrobot_config_id", "externalQRobotConfigId"),
+    )
+    triggered_text: str | None = Field(default=None, validation_alias=AliasChoices("triggered_text", "triggeredText"))
+
+
+class CustomButtonWingsConfigPatch(StrictModel):
+    wings_agent_id: int | None = Field(default=None, validation_alias=AliasChoices("wings_agent_id", "wingsAgentId"))
+    wings_agent_name: str | None = Field(default=None, validation_alias=AliasChoices("wings_agent_name", "wingsAgentName"))
+    bind_que_id_list: list[int] = Field(default_factory=list, validation_alias=AliasChoices("bind_que_id_list", "bindQueIdList"))
+    bind_file_que_id_list: list[int] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("bind_file_que_id_list", "bindFileQueIdList"),
+    )
+    default_prompt: str | None = Field(default=None, validation_alias=AliasChoices("default_prompt", "defaultPrompt"))
+    being_auto_send: bool | None = Field(default=None, validation_alias=AliasChoices("being_auto_send", "beingAutoSend"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        raw_agent_id = payload.get("wings_agent_id", payload.get("wingsAgentId"))
+        if isinstance(raw_agent_id, str) and raw_agent_id.strip().isdigit():
+            payload["wings_agent_id"] = int(raw_agent_id.strip())
+        return payload
+
+
+class CustomButtonPatch(StrictModel):
+    button_text: str = Field(validation_alias=AliasChoices("button_text", "buttonText"))
+    background_color: str = Field(validation_alias=AliasChoices("background_color", "backgroundColor"))
+    text_color: str = Field(validation_alias=AliasChoices("text_color", "textColor"))
+    button_icon: str = Field(validation_alias=AliasChoices("button_icon", "buttonIcon"))
+    trigger_action: PublicButtonTriggerAction = Field(validation_alias=AliasChoices("trigger_action", "triggerAction"))
+    trigger_link_url: str | None = Field(default=None, validation_alias=AliasChoices("trigger_link_url", "triggerLinkUrl"))
+    trigger_add_data_config: CustomButtonAddDataConfigPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("trigger_add_data_config", "triggerAddDataConfig"),
+    )
+    external_qrobot_config: CustomButtonExternalQRobotConfigPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices(
+            "external_qrobot_config",
+            "externalQrobotConfig",
+            "custom_button_external_qrobot_relation_vo",
+            "customButtonExternalQRobotRelationVO",
+        ),
+    )
+    trigger_wings_config: CustomButtonWingsConfigPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("trigger_wings_config", "triggerWingsConfig"),
+    )
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "CustomButtonPatch":
+        if self.trigger_action == PublicButtonTriggerAction.link and not str(self.trigger_link_url or "").strip():
+            raise ValueError("link buttons require trigger_link_url")
+        if self.trigger_action == PublicButtonTriggerAction.add_data and self.trigger_add_data_config is None:
+            raise ValueError("addData buttons require trigger_add_data_config")
+        if self.trigger_action == PublicButtonTriggerAction.qrobot and self.external_qrobot_config is None:
+            raise ValueError("qRobot buttons require external_qrobot_config")
+        if self.trigger_action == PublicButtonTriggerAction.wings and self.trigger_wings_config is None:
+            raise ValueError("wings buttons require trigger_wings_config")
+        return self
+
+
+class ViewButtonBindingPatch(StrictModel):
+    button_type: PublicViewButtonType = Field(validation_alias=AliasChoices("button_type", "buttonType"))
+    config_type: PublicViewButtonConfigType = Field(validation_alias=AliasChoices("config_type", "configType"))
+    button_id: int = Field(validation_alias=AliasChoices("button_id", "buttonId", "id"))
+    button_text: str | None = Field(default=None, validation_alias=AliasChoices("button_text", "buttonText"))
+    button_icon: str | None = Field(default=None, validation_alias=AliasChoices("button_icon", "buttonIcon"))
+    background_color: str | None = Field(default=None, validation_alias=AliasChoices("background_color", "backgroundColor"))
+    text_color: str | None = Field(default=None, validation_alias=AliasChoices("text_color", "textColor"))
+    trigger_action: str | None = Field(default=None, validation_alias=AliasChoices("trigger_action", "triggerAction"))
+    print_tpls: list[Any] = Field(default_factory=list, validation_alias=AliasChoices("print_tpls", "printTpls"))
+    being_main: bool = Field(default=False, validation_alias=AliasChoices("being_main", "beingMain"))
+    button_limit: list[list[ViewFilterRulePatch]] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("button_limit", "buttonLimit"),
+    )
+    button_formula: str | None = Field(default=None, validation_alias=AliasChoices("button_formula", "buttonFormula"))
+    button_formula_type: int = Field(default=1, validation_alias=AliasChoices("button_formula_type", "buttonFormulaType"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        raw_button_type = payload.get("button_type", payload.get("buttonType"))
+        if isinstance(raw_button_type, str):
+            normalized_type = raw_button_type.strip().lower()
+            if normalized_type == "system":
+                payload["button_type"] = "SYSTEM"
+            elif normalized_type == "custom":
+                payload["button_type"] = "CUSTOM"
+        raw_config_type = payload.get("config_type", payload.get("configType"))
+        if isinstance(raw_config_type, str):
+            normalized_config = raw_config_type.strip().lower()
+            if normalized_config == "top":
+                payload["config_type"] = "TOP"
+            elif normalized_config == "detail":
+                payload["config_type"] = "DETAIL"
+        raw_limits = payload.get("button_limit", payload.get("buttonLimit"))
+        if isinstance(raw_limits, list) and raw_limits and all(isinstance(item, dict) for item in raw_limits):
+            payload["button_limit"] = [raw_limits]
+        return payload
+
+    @model_validator(mode="after")
+    def validate_shape(self) -> "ViewButtonBindingPatch":
+        if self.button_type == PublicViewButtonType.system:
+            missing = [
+                field_name
+                for field_name, value in (
+                    ("button_icon", self.button_icon),
+                    ("background_color", self.background_color),
+                    ("text_color", self.text_color),
+                    ("trigger_action", self.trigger_action),
+                )
+                if not str(value or "").strip()
+            ]
+            if missing:
+                raise ValueError(f"system button bindings require {', '.join(missing)}")
+        return self
+
+
 class ChartFilterRulePatch(StrictModel):
     field_name: str = Field(validation_alias=AliasChoices("field_name", "fieldName", "field", "name"))
     operator: ViewFilterOperator = Field(validation_alias=AliasChoices("operator", "op"))
@@ -983,3 +1202,9 @@ def _normalize_public_relation_mode(value: Any) -> str | None:
         }
         return aliases.get(normalized, normalized or None)
     return None
+
+
+CustomButtonMatchRulePatch.model_rebuild()
+CustomButtonAddDataConfigPatch.model_rebuild()
+ViewButtonBindingPatch.model_rebuild()
+ViewUpsertPatch.model_rebuild()