@qingflow-tech/qingflow-app-user-mcp 1.0.9 → 1.0.11

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @qingflow-tech/qingflow-app-user-mcp@1.0.9
+npm install @qingflow-tech/qingflow-app-user-mcp@1.0.11
 ```
 
 Run:
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-app-user-mcp@1.0.9 qingflow-app-user-mcp
+npx -y -p @qingflow-tech/qingflow-app-user-mcp@1.0.11 qingflow-app-user-mcp
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-app-user-mcp",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Operational end-user MCP for Qingflow records, tasks, comments, and directory workflows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "1.0.9"
+version = "1.0.11"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/skills/qingflow-record-update/SKILL.md

@@ -35,6 +35,8 @@ metadata:
 13. Do not look for any extra context bucket in update schema; lookup behavior stays inline on the field definitions themselves
 14. When update context feels unstable, trust `record_update_schema_get`'s route-aware matched-view result over guessed `view_id` or remembered UI scope
 15. If single-record detail/readback matters, prefer `record_get` after the write and read top-level `fields[]`, `media_assets.items[].local_path`, `file_assets.items[].local_path`, `file_assets.items[].extraction.text_path`, and `semantic_context`; `record_get` follows the frontend storage cookie redirect path for Qingflow attachments, so prefer local paths over remote URLs; use `record_list(..., output_profile="normalized")` only for batch row-shaped normalized readback
+16. For batch updates, read top-level `mode`, `dry_run`, `total`, `succeeded`, `failed`, `needs_confirmation`, `updated_record_ids`, `write_executed`, `safe_to_retry`, `verification_status`, and `items[].row_number/status/record_id`
+17. If `write_executed=true`, do not blindly retry the whole batch; use `items[]` and `updated_record_ids` to decide whether only failed rows need repair
 
 ## Do Not
 

package/src/qingflow_mcp/builder_facade/models.py

@@ -1893,8 +1893,9 @@ class PortalComponentPositionPatch(StrictModel):
     pc_h: int = Field(default=8, validation_alias=AliasChoices("pc_h", "pcH", "h"))
     mobile_x: int = Field(default=0, validation_alias=AliasChoices("mobile_x", "mobileX"))
     mobile_y: int = Field(default=0, validation_alias=AliasChoices("mobile_y", "mobileY"))
-    mobile_w: int = Field(default=12, validation_alias=AliasChoices("mobile_w", "mobileW"))
+    mobile_w: int = Field(default=6, validation_alias=AliasChoices("mobile_w", "mobileW"))
     mobile_h: int = Field(default=8, validation_alias=AliasChoices("mobile_h", "mobileH"))
+    mobile_provided: bool = Field(default=False, exclude=True)
 
     @model_validator(mode="before")
     @classmethod
@@ -1904,6 +1905,8 @@ class PortalComponentPositionPatch(StrictModel):
         payload = dict(value)
         pc = payload.pop("pc", None)
         mobile = payload.pop("mobile", None)
+        mobile_keys = {"mobile_x", "mobileX", "mobile_y", "mobileY", "mobile_w", "mobileW", "mobile_h", "mobileH"}
+        mobile_provided = isinstance(mobile, dict) or any(key in payload for key in mobile_keys)
         if isinstance(pc, dict):
             if "pc_x" not in payload and "x" in pc:
                 payload["pc_x"] = pc.get("x")
@@ -1922,6 +1925,7 @@ class PortalComponentPositionPatch(StrictModel):
                 payload["mobile_w"] = mobile.get("cols")
             if "mobile_h" not in payload and "rows" in mobile:
                 payload["mobile_h"] = mobile.get("rows")
+        payload["mobile_provided"] = mobile_provided
         return payload
 
 
@@ -2003,9 +2007,10 @@ class PortalSectionPatch(StrictModel):
 class PortalApplyRequest(StrictModel):
     dash_key: str | None = None
     dash_name: str | None = None
-    package_tag_id: int | None = None
+    package_tag_id: int | None = Field(default=None, validation_alias=AliasChoices("package_tag_id", "packageTagId", "package_id", "packageId"))
     publish: bool = True
     sections: list[PortalSectionPatch] = Field(default_factory=list)
+    layout_preset: str | None = Field(default=None, validation_alias=AliasChoices("layout_preset", "layoutPreset"))
     visibility: VisibilityPatch | None = None
     auth: dict[str, Any] | None = None
     icon: str | None = None
@@ -2014,6 +2019,33 @@ class PortalApplyRequest(StrictModel):
     dash_global_config: dict[str, Any] | None = Field(default=None, validation_alias=AliasChoices("dash_global_config", "dashGlobalConfig"))
     config: dict[str, Any] = Field(default_factory=dict)
 
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_compat_payload(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+        payload = dict(value)
+        if "dash_name" not in payload and "dashName" not in payload and "name" in payload:
+            payload["dash_name"] = payload.pop("name")
+        if "sections" not in payload and "pages" in payload:
+            pages = payload.pop("pages")
+            if not isinstance(pages, list):
+                raise ValueError("portal pages must be a list")
+            if len(pages) != 1:
+                raise ValueError("portal_apply currently supports a single page; pass one page or flatten components into sections")
+            page = pages[0]
+            if not isinstance(page, dict):
+                raise ValueError("portal pages[0] must be an object")
+            components = page.get("components")
+            if not isinstance(components, list) or not components:
+                raise ValueError("portal pages[0].components must be a non-empty list")
+            payload["sections"] = components
+        if "theme" in payload:
+            payload.pop("theme")
+        if "type" in payload:
+            payload.pop("type")
+        return payload
+
     @model_validator(mode="after")
     def validate_shape(self) -> "PortalApplyRequest":
         if not self.dash_key and not self.package_tag_id:
@@ -2024,6 +2056,8 @@ class PortalApplyRequest(StrictModel):
             raise ValueError("portal apply requires a non-empty sections list when creating a portal")
         if self.visibility is not None and self.auth is not None:
             raise ValueError("visibility and auth cannot be provided together")
+        if self.layout_preset is not None and self.layout_preset not in {"auto", "dashboard_2col", "dashboard_3col"}:
+            raise ValueError("layout_preset must be one of: auto, dashboard_2col, dashboard_3col")
         return self
 
 
@@ -2034,8 +2068,11 @@ FieldUpdatePatch.model_rebuild()
 
 class AppGetResponse(StrictModel):
     app_key: str
+    app_name: str | None = None
+    name: str | None = None
     title: str | None = None
     app_icon: str | None = None
+    icon_config: dict[str, Any] = Field(default_factory=dict)
     visibility: dict[str, Any] = Field(default_factory=dict)
     tag_ids: list[int] = Field(default_factory=list)
     publish_status: int | None = None
@@ -2060,6 +2097,8 @@ class AppGetFieldsResponse(StrictModel):
     app_key: str
     fields: list[dict[str, Any]] = Field(default_factory=list)
     field_count: int = 0
+    chart_fields: list[dict[str, Any]] = Field(default_factory=list)
+    chart_field_count: int = 0
     form_settings: dict[str, Any] = Field(default_factory=dict)
 
 
@@ -2107,6 +2146,7 @@ class PortalReadSummaryResponse(StrictModel):
     dash_name: str | None = None
     package_tag_ids: list[int] = Field(default_factory=list)
     dash_icon: str | None = None
+    icon_config: dict[str, Any] = Field(default_factory=dict)
     hide_copyright: bool | None = None
     config_keys: list[str] = Field(default_factory=list)
     dash_global_config_keys: list[str] = Field(default_factory=list)
@@ -2120,6 +2160,7 @@ class PortalGetResponse(StrictModel):
     dash_name: str | None = None
     package_tag_ids: list[int] = Field(default_factory=list)
     dash_icon: str | None = None
+    icon_config: dict[str, Any] = Field(default_factory=dict)
     hide_copyright: bool | None = None
     visibility: dict[str, Any] = Field(default_factory=dict)
     auth: dict[str, Any] = Field(default_factory=dict)