@nocobase/plugin-flow-engine 2.1.0-beta.43 → 2.1.0-beta.45

package/dist/swagger/flow-surfaces.js

@@ -203,6 +203,114 @@ function jsonContent(schema, example) {
     }
   };
 }
+function flowSurfaceErrorItemSchema() {
+  return {
+    type: "object",
+    properties: {
+      index: {
+        type: "integer",
+        description: "Optional 1-based position in an aggregate authoring errors[] response",
+        example: 1
+      },
+      code: {
+        type: "string",
+        description: "Stable machine-readable error code",
+        example: "FLOW_SURFACE_BAD_REQUEST"
+      },
+      message: {
+        type: "string",
+        description: "Human-readable error message for the caller"
+      },
+      status: {
+        type: "integer",
+        description: "HTTP status mapped from the FlowSurfaces error",
+        example: 400
+      },
+      type: {
+        type: "string",
+        description: "Error category such as bad_request, forbidden, conflict or internal_error",
+        example: "bad_request",
+        enum: ["bad_request", "forbidden", "conflict", "internal_error"]
+      },
+      path: {
+        type: "string",
+        description: "Optional JSON-path-like request location for validation errors",
+        example: "$.changes.titleField"
+      },
+      ruleId: {
+        type: "string",
+        description: "Optional stable machine-readable validation rule id",
+        example: "relation-titleField-unreadable"
+      },
+      details: {
+        type: "object",
+        description: "Optional structured context that helps callers repair the request",
+        additionalProperties: true,
+        example: {
+          action: "configure",
+          fieldPath: "manager",
+          titleField: "id",
+          targetCollection: "employees",
+          invalidReason: "id",
+          availableFields: ["nickname", "title"],
+          suggestion: "Use one of: nickname, title."
+        }
+      }
+    },
+    required: ["message", "type", "code", "status"],
+    additionalProperties: false
+  };
+}
+function flowSurfaceAggregateRepairDetailsSchema() {
+  return {
+    type: "object",
+    description: "Optional aggregate authoring repair contract. When present, callers should fix every listed child error before retrying the same write.",
+    properties: {
+      errorCount: {
+        type: "integer",
+        description: "Number of child errors in the aggregate response",
+        example: 2
+      },
+      mustFixAllErrorsBeforeRetry: {
+        type: "boolean",
+        example: true
+      },
+      retryPolicy: {
+        type: "string",
+        example: "fix_all_errors_before_retry_same_write"
+      },
+      sameWriteRetryRequired: {
+        type: "boolean",
+        example: true
+      },
+      agentInstruction: {
+        type: "string",
+        description: "Human-readable repair instruction for agentic callers"
+      },
+      requiredBlockPolicy: {
+        type: "object",
+        properties: {
+          requiredBlockTypes: {
+            type: "array",
+            items: {
+              type: "string"
+            }
+          },
+          fixStrategy: {
+            type: "string",
+            example: "repair_same_block_type"
+          },
+          doNotReplaceOrDrop: {
+            type: "boolean",
+            example: true
+          }
+        },
+        additionalProperties: true
+      }
+    },
+    additionalProperties: true
+  };
+}
 function requestBody(schemaName, example, description) {
   return {
     required: true,
@@ -5010,6 +5118,16 @@ const schemas = {
       type: {
         type: "string",
         enum: ["bad_request", "forbidden", "conflict", "internal_error"]
+      },
+      errorCount: {
+        type: "integer",
+        description: "Present for aggregate authoring failures and equal to errors.length"
+      },
+      details: flowSurfaceAggregateRepairDetailsSchema(),
+      errors: {
+        type: "array",
+        description: "Present for aggregate item failures; contains the structured child authoring errors",
+        items: flowSurfaceErrorItemSchema()
       }
     },
     required: ["message", "type", "code", "status"],
@@ -5938,59 +6056,20 @@ const schemas = {
       ]
     },
     properties: {
+      message: {
+        type: "string",
+        description: "Present for aggregate authoring failures and summarizes the full validation batch",
+        example: "flowSurfaces authoring validation failed with 2 error(s); fix all errors before retrying the same write"
+      },
+      errorCount: {
+        type: "integer",
+        description: "Present for aggregate authoring failures and equal to errors.length",
+        example: 2
+      },
+      details: flowSurfaceAggregateRepairDetailsSchema(),
       errors: {
         type: "array",
-        items: {
-          type: "object",
-          properties: {
-            code: {
-              type: "string",
-              description: "Stable machine-readable error code",
-              example: "FLOW_SURFACE_BAD_REQUEST"
-            },
-            message: {
-              type: "string",
-              description: "Human-readable error message for the caller"
-            },
-            status: {
-              type: "integer",
-              description: "HTTP status mapped from the FlowSurfaces error",
-              example: 400
-            },
-            type: {
-              type: "string",
-              description: "Error category such as bad_request, forbidden, conflict or internal_error",
-              example: "bad_request",
-              enum: ["bad_request", "forbidden", "conflict", "internal_error"]
-            },
-            path: {
-              type: "string",
-              description: "Optional JSON-path-like request location for validation errors",
-              example: "$.changes.titleField"
-            },
-            ruleId: {
-              type: "string",
-              description: "Optional stable machine-readable validation rule id",
-              example: "relation-titleField-unreadable"
-            },
-            details: {
-              type: "object",
-              description: "Optional structured context that helps callers repair the request",
-              additionalProperties: true,
-              example: {
-                action: "configure",
-                fieldPath: "manager",
-                titleField: "id",
-                targetCollection: "employees",
-                invalidReason: "id",
-                availableFields: ["nickname", "title"],
-                suggestion: "Use one of: nickname, title."
-              }
-            }
-          },
-          required: ["message", "type", "code", "status"],
-          additionalProperties: false
-        }
+        items: flowSurfaceErrorItemSchema()
       }
     },
     additionalProperties: true

package/dist/swagger/index.d.ts

@@ -4001,6 +4001,118 @@ declare const _default: {
                         type: string;
                         enum: string[];
                     };
+                    errorCount: {
+                        type: string;
+                        description: string;
+                    };
+                    details: {
+                        type: string;
+                        description: string;
+                        properties: {
+                            errorCount: {
+                                type: string;
+                                description: string;
+                                example: number;
+                            };
+                            mustFixAllErrorsBeforeRetry: {
+                                type: string;
+                                example: boolean;
+                            };
+                            retryPolicy: {
+                                type: string;
+                                example: string;
+                            };
+                            sameWriteRetryRequired: {
+                                type: string;
+                                example: boolean;
+                            };
+                            agentInstruction: {
+                                type: string;
+                                description: string;
+                            };
+                            requiredBlockPolicy: {
+                                type: string;
+                                properties: {
+                                    requiredBlockTypes: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    fixStrategy: {
+                                        type: string;
+                                        example: string;
+                                    };
+                                    doNotReplaceOrDrop: {
+                                        type: string;
+                                        example: boolean;
+                                    };
+                                };
+                                additionalProperties: boolean;
+                            };
+                        };
+                        additionalProperties: boolean;
+                    };
+                    errors: {
+                        type: string;
+                        description: string;
+                        items: {
+                            type: string;
+                            properties: {
+                                index: {
+                                    type: string;
+                                    description: string;
+                                    example: number;
+                                };
+                                code: {
+                                    type: string;
+                                    description: string;
+                                    example: string;
+                                };
+                                message: {
+                                    type: string;
+                                    description: string;
+                                };
+                                status: {
+                                    type: string;
+                                    description: string;
+                                    example: number;
+                                };
+                                type: {
+                                    type: string;
+                                    description: string;
+                                    example: string;
+                                    enum: string[];
+                                };
+                                path: {
+                                    type: string;
+                                    description: string;
+                                    example: string;
+                                };
+                                ruleId: {
+                                    type: string;
+                                    description: string;
+                                    example: string;
+                                };
+                                details: {
+                                    type: string;
+                                    description: string;
+                                    additionalProperties: boolean;
+                                    example: {
+                                        action: string;
+                                        fieldPath: string;
+                                        titleField: string;
+                                        targetCollection: string;
+                                        invalidReason: string;
+                                        availableFields: string[];
+                                        suggestion: string;
+                                    };
+                                };
+                            };
+                            required: string[];
+                            additionalProperties: boolean;
+                        };
+                    };
                 };
                 required: string[];
                 additionalProperties: boolean;
@@ -5250,11 +5362,74 @@ declare const _default: {
                     }[];
                 };
                 properties: {
+                    message: {
+                        type: string;
+                        description: string;
+                        example: string;
+                    };
+                    errorCount: {
+                        type: string;
+                        description: string;
+                        example: number;
+                    };
+                    details: {
+                        type: string;
+                        description: string;
+                        properties: {
+                            errorCount: {
+                                type: string;
+                                description: string;
+                                example: number;
+                            };
+                            mustFixAllErrorsBeforeRetry: {
+                                type: string;
+                                example: boolean;
+                            };
+                            retryPolicy: {
+                                type: string;
+                                example: string;
+                            };
+                            sameWriteRetryRequired: {
+                                type: string;
+                                example: boolean;
+                            };
+                            agentInstruction: {
+                                type: string;
+                                description: string;
+                            };
+                            requiredBlockPolicy: {
+                                type: string;
+                                properties: {
+                                    requiredBlockTypes: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    fixStrategy: {
+                                        type: string;
+                                        example: string;
+                                    };
+                                    doNotReplaceOrDrop: {
+                                        type: string;
+                                        example: boolean;
+                                    };
+                                };
+                                additionalProperties: boolean;
+                            };
+                        };
+                        additionalProperties: boolean;
+                    };
                     errors: {
                         type: string;
                         items: {
                             type: string;
                             properties: {
+                                index: {
+                                    type: string;
+                                    description: string;
+                                    example: number;
+                                };
                                 code: {
                                     type: string;
                                     description: string;

package/package.json

@@ -4,7 +4,7 @@
   "displayName.zh-CN": "前端流引擎",
   "description": "",
   "description.zh-CN": "",
-  "version": "2.1.0-beta.43",
+  "version": "2.1.0-beta.45",
   "main": "./dist/server/index.js",
   "license": "Apache-2.0",
   "devDependencies": {
@@ -26,5 +26,5 @@
     "@nocobase/test": "2.x",
     "@nocobase/utils": "2.x"
   },
-  "gitHead": "6d7750e2373bf2451d246de88cc1f62491685e18"
+  "gitHead": "42587115fc34c3eb01ef2b2549f1c998e5708318"
 }