@nocobase/plugin-flow-engine 2.1.0-alpha.40 → 2.1.0-alpha.46

package/dist/swagger/flow-surfaces.examples.d.ts

@@ -69,24 +69,19 @@ export declare const flowSurfaceExamples: {
                         username: string;
                         auto: boolean;
                         workContext: {
-                            type: string;
                             target: string;
                         }[];
                         tasks: {
                             title: string;
+                            prompt: string;
                             message: {
                                 system: string;
-                                user: string;
                                 workContext: {
-                                    type: string;
                                     target: string;
                                 }[];
                             };
                             autoSend: boolean;
-                            skillSettings: {
-                                skills: any[];
-                                tools: any[];
-                            };
+                            skillSettings: any;
                             model: any;
                             webSearch: boolean;
                         }[];
@@ -135,24 +130,19 @@ export declare const flowSurfaceExamples: {
                         username: string;
                         auto: boolean;
                         workContext: {
-                            type: string;
                             target: string;
                         }[];
                         tasks: {
                             title: string;
+                            prompt: string;
                             message: {
                                 system: string;
-                                user: string;
                                 workContext: {
-                                    type: string;
                                     target: string;
                                 }[];
                             };
                             autoSend: boolean;
-                            skillSettings: {
-                                skills: any[];
-                                tools: any[];
-                            };
+                            skillSettings: any;
                             model: any;
                             webSearch: boolean;
                         }[];
@@ -169,24 +159,19 @@ export declare const flowSurfaceExamples: {
                         username: string;
                         auto: boolean;
                         workContext: {
-                            type: string;
                             target: string;
                         }[];
                         tasks: {
                             title: string;
+                            prompt: string;
                             message: {
                                 system: string;
-                                user: string;
                                 workContext: {
-                                    type: string;
                                     target: string;
                                 }[];
                             };
                             autoSend: boolean;
-                            skillSettings: {
-                                skills: any[];
-                                tools: any[];
-                            };
+                            skillSettings: any;
                             model: any;
                             webSearch: boolean;
                         }[];
@@ -1271,24 +1256,19 @@ export declare const flowSurfaceExamples: {
             username: string;
             auto: boolean;
             workContext: {
-                type: string;
                 target: string;
             }[];
             tasks: {
                 title: string;
+                prompt: string;
                 message: {
                     system: string;
-                    user: string;
                     workContext: {
-                        type: string;
                         target: string;
                     }[];
                 };
                 autoSend: boolean;
-                skillSettings: {
-                    skills: any[];
-                    tools: any[];
-                };
+                skillSettings: any;
                 model: any;
                 webSearch: boolean;
             }[];
@@ -1404,24 +1384,19 @@ export declare const flowSurfaceExamples: {
             username: string;
             auto: boolean;
             workContext: {
-                type: string;
                 target: string;
             }[];
             tasks: {
                 title: string;
+                prompt: string;
                 message: {
                     system: string;
-                    user: string;
                     workContext: {
-                        type: string;
                         target: string;
                     }[];
                 };
                 autoSend: boolean;
-                skillSettings: {
-                    skills: any[];
-                    tools: any[];
-                };
+                skillSettings: any;
                 model: any;
                 webSearch: boolean;
             }[];
@@ -1628,10 +1603,9 @@ export declare const flowSurfaceExamples: {
         };
         tasks: {
             title: string;
+            prompt: string;
             message: {
-                user: string;
                 workContext: {
-                    type: string;
                     target: string;
                 }[];
             };

package/dist/swagger/flow-surfaces.examples.js

@@ -57,17 +57,17 @@ const makePublicBlockDefaultFilter = (items = [
 const makeAIEmployeeActionSettings = (target = "self") => ({
   username: "dex",
   auto: false,
-  workContext: [{ type: "flow-model", target }],
+  workContext: [{ target }],
   tasks: [
     {
       title: "Analyze current context",
+      prompt: "Analyze the current record and suggest next steps.",
       message: {
         system: "Use the current UI context.",
-        user: "Analyze the current record and suggest next steps.",
-        workContext: [{ type: "flow-model", target }]
+        workContext: [{ target }]
       },
       autoSend: false,
-      skillSettings: { skills: [], tools: [] },
+      skillSettings: null,
       model: null,
       webSearch: false
     }
@@ -1889,9 +1889,9 @@ const flowSurfaceExamples = {
     tasks: [
       {
         title: "Generate table insights",
+        prompt: "Summarize the current table and identify risks.",
         message: {
-          user: "Summarize the current table and identify risks.",
-          workContext: [{ type: "flow-model", target: "self" }]
+          workContext: [{ target: "self" }]
         },
         autoSend: true,
         webSearch: false

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"],
@@ -5352,10 +5470,9 @@ const schemas = {
       },
       workContext: {
         type: "array",
-        description: 'AIEmployeeButtonModel only. Public work context entries. Use `target: "self"` for the owning block/action context, or pass existing resolved Flow Model `uid` values in localized writes.',
+        description: 'AIEmployeeButtonModel only. Public work context entries. Use `target: "self"` for the owning block/action context, or pass existing resolved Flow Model `uid` values in localized writes. `type` is optional and defaults to `flow-model`.',
         items: {
           type: "object",
-          required: ["type"],
           anyOf: [{ required: ["uid"] }, { required: ["target"] }],
           properties: {
             type: {
@@ -5386,6 +5503,10 @@ const schemas = {
             title: {
               type: "string"
             },
+            prompt: {
+              type: "string",
+              description: "Alias for message.user. Do not send prompt together with message.user."
+            },
             message: {
               type: "object",
               properties: {
@@ -5399,7 +5520,6 @@ const schemas = {
                   type: "array",
                   items: {
                     type: "object",
-                    required: ["type"],
                     anyOf: [{ required: ["uid"] }, { required: ["target"] }],
                     properties: {
                       type: {
@@ -5428,6 +5548,7 @@ const schemas = {
             skillSettings: {
               type: "object",
               nullable: true,
+              description: "Task-level skill/tool override. Omit or use null to inherit the AI employee preset. Unversioned empty skills/tools arrays are normalized to null for compatibility; use skillsVersion/toolsVersion when intentionally disabling all skills/tools.",
               properties: {
                 skills: {
                   type: "array",
@@ -5935,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;
@@ -4461,7 +4573,6 @@ declare const _default: {
                         description: string;
                         items: {
                             type: string;
-                            required: string[];
                             anyOf: {
                                 required: string[];
                             }[];
@@ -4494,6 +4605,10 @@ declare const _default: {
                                 title: {
                                     type: string;
                                 };
+                                prompt: {
+                                    type: string;
+                                    description: string;
+                                };
                                 message: {
                                     type: string;
                                     properties: {
@@ -4507,7 +4622,6 @@ declare const _default: {
                                             type: string;
                                             items: {
                                                 type: string;
-                                                required: string[];
                                                 anyOf: {
                                                     required: string[];
                                                 }[];
@@ -4538,6 +4652,7 @@ declare const _default: {
                                 skillSettings: {
                                     type: string;
                                     nullable: boolean;
+                                    description: string;
                                     properties: {
                                         skills: {
                                             type: string;
@@ -5247,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-alpha.40",
+  "version": "2.1.0-alpha.46",
   "main": "./dist/server/index.js",
   "license": "Apache-2.0",
   "devDependencies": {
@@ -26,5 +26,5 @@
     "@nocobase/test": "2.x",
     "@nocobase/utils": "2.x"
   },
-  "gitHead": "e73f99dd0abefe847f2e50ff0fea1f41a82fd048"
+  "gitHead": "42b269944cdd1908d7a848c0af4936fe94c03bb7"
 }