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

package/README.md

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

package/package.json

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

package/src/qingflow_mcp/builder_facade/models.py

@@ -24,6 +24,8 @@ class PublicFieldType(str, Enum):
     address = "address"
     attachment = "attachment"
     boolean = "boolean"
+    q_linker = "q_linker"
+    code_block = "code_block"
     relation = "relation"
     subtable = "subtable"
 
@@ -46,6 +48,10 @@ FIELD_TYPE_ALIASES: dict[str, PublicFieldType] = {
     "multi_select": PublicFieldType.multi_select,
     "multi-select": PublicFieldType.multi_select,
     "departments": PublicFieldType.department,
+    "qlinker": PublicFieldType.q_linker,
+    "q_linker": PublicFieldType.q_linker,
+    "codeblock": PublicFieldType.code_block,
+    "code_block": PublicFieldType.code_block,
 }
 
 FIELD_TYPE_ID_ALIASES: dict[int, PublicFieldType] = {
@@ -60,6 +66,8 @@ FIELD_TYPE_ID_ALIASES: dict[int, PublicFieldType] = {
     11: PublicFieldType.single_select,
     12: PublicFieldType.multi_select,
     13: PublicFieldType.attachment,
+    20: PublicFieldType.q_linker,
+    26: PublicFieldType.code_block,
     18: PublicFieldType.subtable,
     21: PublicFieldType.address,
     22: PublicFieldType.department,
@@ -281,6 +289,260 @@ class FieldSelector(StrictModel):
         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"))
+    alias_type: int = Field(default=1, validation_alias=AliasChoices("alias_type", "aliasType"))
+    alias_id: int | None = Field(default=None, validation_alias=AliasChoices("alias_id", "aliasId"))
+    sub_alias: list["CodeBlockAliasPathPatch"] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("sub_alias", "subAlias"),
+    )
+
+
+class CodeBlockConfigPatch(StrictModel):
+    config_mode: int = Field(default=1, validation_alias=AliasChoices("config_mode", "configMode"))
+    code_content: str = Field(default="", validation_alias=AliasChoices("code_content", "codeContent"))
+    being_hide_on_form: bool = Field(
+        default=False,
+        validation_alias=AliasChoices("being_hide_on_form", "beingHideOnForm"),
+    )
+    result_alias_path: list[CodeBlockAliasPathPatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("result_alias_path", "resultAliasPath", "alias_config", "aliasConfig"),
+    )
+
+
+class CodeBlockInputBindingPatch(StrictModel):
+    field: FieldSelector
+    var: str | None = None
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if isinstance(value, str):
+            return {"field": {"name": value}}
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        raw_field = payload.get("field")
+        if isinstance(raw_field, str):
+            payload["field"] = {"name": raw_field}
+        elif raw_field is None:
+            for key in ("field_name", "fieldName", "name", "title", "label"):
+                raw_value = payload.get(key)
+                if isinstance(raw_value, str) and raw_value.strip():
+                    payload["field"] = {"name": raw_value}
+                    break
+        return payload
+
+
+class QLinkerInputSource(str, Enum):
+    query_param = "query_param"
+    header = "header"
+    url_encoded = "url_encoded"
+    json_path = "json_path"
+
+
+class QLinkerKeyValuePatch(StrictModel):
+    key: str
+    value: str | None = None
+
+
+class QLinkerAliasPathPatch(StrictModel):
+    alias_name: str = Field(validation_alias=AliasChoices("alias_name", "aliasName"))
+    alias_path: str = Field(validation_alias=AliasChoices("alias_path", "aliasPath"))
+    alias_id: int | None = Field(default=None, validation_alias=AliasChoices("alias_id", "aliasId"))
+
+
+class RemoteLookupConfigPatch(StrictModel):
+    config_mode: int = Field(default=1, validation_alias=AliasChoices("config_mode", "configMode"))
+    url: str = ""
+    method: str = "GET"
+    headers: list[QLinkerKeyValuePatch] = Field(default_factory=list)
+    body_type: int = Field(default=1, validation_alias=AliasChoices("body_type", "bodyType"))
+    url_encoded_value: list[QLinkerKeyValuePatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("url_encoded_value", "urlEncodedValue"),
+    )
+    json_value: str | None = Field(default=None, validation_alias=AliasChoices("json_value", "jsonValue"))
+    xml_value: str | None = Field(default=None, validation_alias=AliasChoices("xml_value", "xmlValue"))
+    result_type: int = Field(default=1, validation_alias=AliasChoices("result_type", "resultType"))
+    result_format_path: list[QLinkerAliasPathPatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("result_format_path", "resultFormatPath"),
+    )
+    query_params: list[QLinkerKeyValuePatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("query_params", "queryParams"),
+    )
+    auto_trigger: bool | None = Field(default=None, validation_alias=AliasChoices("auto_trigger", "autoTrigger"))
+    custom_button_text_enabled: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text_enabled", "customButtonTextEnabled", "custom_btn_text_status", "customBtnTextStatus"),
+    )
+    custom_button_text: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text", "customButtonText", "custom_btn_text", "customBtnText"),
+    )
+    being_insert_value_directly: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("being_insert_value_directly", "beingInsertValueDirectly"),
+    )
+    being_hide_on_form: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("being_hide_on_form", "beingHideOnForm"),
+    )
+
+
+class QLinkerInputBindingPatch(StrictModel):
+    field: FieldSelector
+    key: str
+    source: QLinkerInputSource
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if isinstance(value, str):
+            return {"field": {"name": value}, "key": value, "source": QLinkerInputSource.query_param.value}
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        raw_field = payload.get("field")
+        if isinstance(raw_field, str):
+            payload["field"] = {"name": raw_field}
+        elif raw_field is None:
+            for key in ("field_name", "fieldName", "name", "title", "label"):
+                raw_value = payload.get(key)
+                if isinstance(raw_value, str) and raw_value.strip():
+                    payload["field"] = {"name": raw_value}
+                    break
+        raw_source = payload.get("source")
+        if isinstance(raw_source, str):
+            payload["source"] = raw_source.strip().lower()
+        return payload
+
+
+class QLinkerOutputBindingPatch(StrictModel):
+    alias: str
+    path: str
+    target_field: FieldSelector = Field(validation_alias=AliasChoices("target_field", "targetField"))
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "alias_name" in payload and "alias" not in payload:
+            payload["alias"] = payload.pop("alias_name")
+        if "aliasName" in payload and "alias" not in payload:
+            payload["alias"] = payload.pop("aliasName")
+        if "alias_path" in payload and "path" not in payload:
+            payload["path"] = payload.pop("alias_path")
+        if "aliasPath" in payload and "path" not in payload:
+            payload["path"] = payload.pop("aliasPath")
+        raw_target = payload.get("target_field", payload.get("targetField"))
+        if isinstance(raw_target, str):
+            payload["target_field"] = {"name": raw_target}
+        return payload
+
+
+class QLinkerRequestPatch(StrictModel):
+    url: str = ""
+    method: str = "GET"
+    headers: list[QLinkerKeyValuePatch] = Field(default_factory=list)
+    query_params: list[QLinkerKeyValuePatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("query_params", "queryParams"),
+    )
+    body_type: int = Field(default=1, validation_alias=AliasChoices("body_type", "bodyType"))
+    url_encoded_value: list[QLinkerKeyValuePatch] = Field(
+        default_factory=list,
+        validation_alias=AliasChoices("url_encoded_value", "urlEncodedValue"),
+    )
+    json_value: str | None = Field(default=None, validation_alias=AliasChoices("json_value", "jsonValue"))
+    xml_value: str | None = Field(default=None, validation_alias=AliasChoices("xml_value", "xmlValue"))
+    result_type: int = Field(default=1, validation_alias=AliasChoices("result_type", "resultType"))
+    auto_trigger: bool | None = Field(default=None, validation_alias=AliasChoices("auto_trigger", "autoTrigger"))
+    custom_button_text_enabled: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text_enabled", "customButtonTextEnabled", "custom_btn_text_status", "customBtnTextStatus"),
+    )
+    custom_button_text: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text", "customButtonText", "custom_btn_text", "customBtnText"),
+    )
+    being_insert_value_directly: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("being_insert_value_directly", "beingInsertValueDirectly"),
+    )
+    being_hide_on_form: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("being_hide_on_form", "beingHideOnForm"),
+    )
+
+
+class QLinkerBindingPatch(StrictModel):
+    inputs: list[QLinkerInputBindingPatch] = Field(default_factory=list)
+    request: QLinkerRequestPatch
+    outputs: list[QLinkerOutputBindingPatch] = Field(default_factory=list)
+
+
+class CodeBlockOutputBindingPatch(StrictModel):
+    alias: str
+    path: str
+    target_field: FieldSelector = Field(
+        validation_alias=AliasChoices("target_field", "targetField"),
+    )
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "alias_name" in payload and "alias" not in payload:
+            payload["alias"] = payload.pop("alias_name")
+        if "aliasName" in payload and "alias" not in payload:
+            payload["alias"] = payload.pop("aliasName")
+        if "alias_path" in payload and "path" not in payload:
+            payload["path"] = payload.pop("alias_path")
+        if "aliasPath" in payload and "path" not in payload:
+            payload["path"] = payload.pop("aliasPath")
+        raw_target = payload.get("target_field", payload.get("targetField"))
+        if isinstance(raw_target, str):
+            payload["target_field"] = {"name": raw_target}
+        return payload
+
+
+class CodeBlockBindingPatch(StrictModel):
+    inputs: list[CodeBlockInputBindingPatch] = Field(default_factory=list)
+    code: str = ""
+    auto_trigger: bool | None = Field(default=None, validation_alias=AliasChoices("auto_trigger", "autoTrigger"))
+    custom_button_text_enabled: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text_enabled", "customButtonTextEnabled", "custom_btn_text_status", "customBtnTextStatus"),
+    )
+    custom_button_text: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text", "customButtonText", "custom_btn_text", "customBtnText"),
+    )
+    outputs: list[CodeBlockOutputBindingPatch] = Field(default_factory=list)
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_aliases(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "code_content" in payload and "code" not in payload:
+            payload["code"] = payload.pop("code_content")
+        if "codeContent" in payload and "code" not in payload:
+            payload["code"] = payload.pop("codeContent")
+        return payload
+
+
 class FieldPatch(StrictModel):
     name: str = Field(validation_alias=AliasChoices("name", "title", "label"))
     type: PublicFieldType
@@ -291,6 +553,31 @@ class FieldPatch(StrictModel):
     display_field: FieldSelector | None = None
     visible_fields: list[FieldSelector] = Field(default_factory=list)
     relation_mode: PublicRelationMode | None = Field(default=None, validation_alias=AliasChoices("relation_mode", "relationMode", "selection_mode", "selectionMode"))
+    remote_lookup_config: RemoteLookupConfigPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("remote_lookup_config", "remoteLookupConfig"),
+    )
+    q_linker_binding: QLinkerBindingPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("q_linker_binding", "qLinkerBinding"),
+    )
+    code_block_config: CodeBlockConfigPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("code_block_config", "codeBlockConfig"),
+    )
+    code_block_binding: CodeBlockBindingPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("code_block_binding", "codeBlockBinding"),
+    )
+    auto_trigger: bool | None = Field(default=None, validation_alias=AliasChoices("auto_trigger", "autoTrigger"))
+    custom_button_text_enabled: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text_enabled", "customButtonTextEnabled", "custom_btn_text_status", "customBtnTextStatus"),
+    )
+    custom_button_text: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text", "customButtonText", "custom_btn_text", "customBtnText"),
+    )
     subfields: list["FieldPatch"] = Field(default_factory=list)
 
     @model_validator(mode="after")
@@ -301,6 +588,19 @@ class FieldPatch(StrictModel):
             raise ValueError("target_app_key is only allowed for relation fields")
         if self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields or self.relation_mode is not None):
             raise ValueError("display_field, visible_fields, and relation_mode are only allowed for relation fields")
+        if self.type != PublicFieldType.q_linker and (
+            self.remote_lookup_config is not None
+            or self.q_linker_binding is not None
+        ):
+            raise ValueError("remote_lookup_config and q_linker_binding are only allowed for q_linker fields")
+        if self.type != PublicFieldType.code_block and (
+            self.code_block_config is not None
+            or self.code_block_binding is not None
+            or self.auto_trigger is not None
+            or self.custom_button_text_enabled is not None
+            or self.custom_button_text is not None
+        ):
+            raise ValueError("code_block_config, code_block_binding, auto_trigger, custom_button_text_enabled, and custom_button_text are only allowed for code_block fields")
         if self.type == PublicFieldType.subtable and not self.subfields:
             raise ValueError("subtable field requires subfields")
         if self.type != PublicFieldType.subtable and self.subfields:
@@ -323,6 +623,31 @@ class FieldMutation(StrictModel):
     display_field: FieldSelector | None = None
     visible_fields: list[FieldSelector] | None = None
     relation_mode: PublicRelationMode | None = Field(default=None, validation_alias=AliasChoices("relation_mode", "relationMode", "selection_mode", "selectionMode"))
+    remote_lookup_config: RemoteLookupConfigPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("remote_lookup_config", "remoteLookupConfig"),
+    )
+    q_linker_binding: QLinkerBindingPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("q_linker_binding", "qLinkerBinding"),
+    )
+    code_block_config: CodeBlockConfigPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("code_block_config", "codeBlockConfig"),
+    )
+    code_block_binding: CodeBlockBindingPatch | None = Field(
+        default=None,
+        validation_alias=AliasChoices("code_block_binding", "codeBlockBinding"),
+    )
+    auto_trigger: bool | None = Field(default=None, validation_alias=AliasChoices("auto_trigger", "autoTrigger"))
+    custom_button_text_enabled: bool | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text_enabled", "customButtonTextEnabled", "custom_btn_text_status", "customBtnTextStatus"),
+    )
+    custom_button_text: str | None = Field(
+        default=None,
+        validation_alias=AliasChoices("custom_button_text", "customButtonText", "custom_btn_text", "customBtnText"),
+    )
     subfields: list[FieldPatch] | None = None
 
     @model_validator(mode="after")
@@ -331,6 +656,19 @@ class FieldMutation(StrictModel):
             raise ValueError("relation field requires target_app_key")
         if self.type is not None and self.type != PublicFieldType.relation and (self.display_field is not None or self.visible_fields or self.relation_mode is not None):
             raise ValueError("display_field, visible_fields, and relation_mode are only allowed for relation fields")
+        if self.type is not None and self.type != PublicFieldType.q_linker and (
+            self.remote_lookup_config is not None
+            or self.q_linker_binding is not None
+        ):
+            raise ValueError("remote_lookup_config and q_linker_binding are only allowed for q_linker fields")
+        if self.type is not None and self.type != PublicFieldType.code_block and (
+            self.code_block_config is not None
+            or self.code_block_binding is not None
+            or self.auto_trigger is not None
+            or self.custom_button_text_enabled is not None
+            or self.custom_button_text is not None
+        ):
+            raise ValueError("code_block_config, code_block_binding, auto_trigger, custom_button_text_enabled, and custom_button_text are only allowed for code_block fields")
         if self.type == PublicFieldType.subtable and not self.subfields:
             raise ValueError("subtable field requires subfields")
         return self
@@ -385,8 +723,9 @@ def _normalize_layout_rows(value: Any, *, columns: int | None = None) -> Any:
 
 
 class LayoutSectionPatch(StrictModel):
-    section_id: str | None = Field(default=None, validation_alias=AliasChoices("section_id", "sectionId"))
-    title: str
+    type: str | None = Field(default=None, validation_alias=AliasChoices("type", "kind", "block_type", "blockType"))
+    section_id: str | None = Field(default=None, validation_alias=AliasChoices("section_id", "sectionId", "paragraph_id", "paragraphId"))
+    title: str = Field(validation_alias=AliasChoices("title", "name", "paragraph_title", "paragraphTitle"))
     rows: list[list[Any]] = Field(default_factory=list)
 
     @model_validator(mode="before")
@@ -397,6 +736,10 @@ class LayoutSectionPatch(StrictModel):
         payload = dict(value)
         if "name" in payload and "title" not in payload:
             payload["title"] = payload.pop("name")
+        if "paragraph_title" in payload and "title" not in payload:
+            payload["title"] = payload.pop("paragraph_title")
+        if "paragraphTitle" in payload and "title" not in payload:
+            payload["title"] = payload.pop("paragraphTitle")
         shorthand: Any | None = None
         if "rows" not in payload:
             if "fields" in payload:
@@ -412,6 +755,8 @@ class LayoutSectionPatch(StrictModel):
 
     @model_validator(mode="after")
     def validate_rows(self) -> "LayoutSectionPatch":
+        if self.type is not None and str(self.type).strip().lower() != "paragraph":
+            raise ValueError("layout section type must be 'paragraph'")
         if not self.rows:
             raise ValueError("section rows must be a non-empty list")
         for row in self.rows:
@@ -1211,5 +1556,6 @@ def _normalize_public_relation_mode(value: Any) -> str | None:
 
 CustomButtonMatchRulePatch.model_rebuild()
 CustomButtonAddDataConfigPatch.model_rebuild()
+CodeBlockAliasPathPatch.model_rebuild()
 ViewButtonBindingPatch.model_rebuild()
 ViewUpsertPatch.model_rebuild()