@nocobase/plugin-flow-engine 2.1.0-alpha.16 → 2.1.0-alpha.18

package/dist/externalVersion.js

@@ -8,15 +8,15 @@
  */
 
 module.exports = {
-  "@nocobase/client": "2.1.0-alpha.16",
+  "@nocobase/client": "2.1.0-alpha.18",
   "lodash": "4.17.21",
-  "@nocobase/database": "2.1.0-alpha.16",
-  "@nocobase/data-source-manager": "2.1.0-alpha.16",
-  "@nocobase/resourcer": "2.1.0-alpha.16",
-  "@nocobase/utils": "2.1.0-alpha.16",
-  "@nocobase/cache": "2.1.0-alpha.16",
-  "@nocobase/plugin-localization": "2.1.0-alpha.16",
-  "@nocobase/server": "2.1.0-alpha.16",
-  "@nocobase/actions": "2.1.0-alpha.16",
-  "@nocobase/ai": "2.1.0-alpha.16"
+  "@nocobase/database": "2.1.0-alpha.18",
+  "@nocobase/data-source-manager": "2.1.0-alpha.18",
+  "@nocobase/resourcer": "2.1.0-alpha.18",
+  "@nocobase/utils": "2.1.0-alpha.18",
+  "@nocobase/cache": "2.1.0-alpha.18",
+  "@nocobase/plugin-localization": "2.1.0-alpha.18",
+  "@nocobase/server": "2.1.0-alpha.18",
+  "@nocobase/actions": "2.1.0-alpha.18",
+  "@nocobase/ai": "2.1.0-alpha.18"
 };

package/dist/node_modules/ses/package.json

@@ -1 +1 @@
-{"name":"ses","version":"1.14.0","description":"Hardened JavaScript for Fearless Cooperation","keywords":["lockdown","harden","Compartment","assert","security","confinement","isolation","object capabilities","ocaps","secure execution","third-party code","prototype pollution","supply-chain attack","plugin"],"author":"Agoric","license":"Apache-2.0","homepage":"https://github.com/Agoric/SES-shim/tree/master/packages/ses#readme","repository":{"type":"git","url":"git+https://github.com/endojs/endo.git","directory":"packages/ses"},"bugs":{"url":"https://github.com/endojs/endo/issues"},"type":"module","main":"./dist/ses.cjs","module":"./index.js","unpkg":"./dist/ses.umd.js","types":"./types.d.ts","exports":{".":{"import":{"types":"./types.d.ts","xs":"./src-xs/index.js","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./lockdown":{"import":{"types":"./types.d.ts","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./hermes":{"require":{"types":"./dist/types.d.cts","default":"./dist/ses-hermes.cjs"}},"./tools.js":"./tools.js","./assert-shim.js":"./assert-shim.js","./lockdown-shim.js":{"xs":"./src-xs/lockdown-shim.js","default":"./lockdown-shim.js"},"./compartment-shim.js":{"xs":"./src-xs/compartment-shim.js","default":"./compartment-shim.js"},"./console-shim.js":"./console-shim.js","./package.json":"./package.json"},"scripts":{"build:vanilla":"node scripts/bundle.js","build:hermes":"node scripts/bundle.js hermes","build":"yarn build:vanilla && yarn build:hermes","clean":"rm -rf dist","cover":"c8 ava","demo":"python3 -m http.server","lint":"yarn lint:types && yarn lint:eslint","lint-fix":"eslint --fix .","lint:eslint":"eslint .","lint:types":"tsc","prepare":"npm run clean && npm run build","qt":"ava","test":"tsd && ava","test:hermes":"./scripts/hermes-test.sh","test:xs":"xst dist/ses.umd.js test/_lockdown-safe.js && node scripts/generate-test-xs.js && xst tmp/test-xs.js && rm -rf tmp","postpack":"git clean -fX \"*.d.ts*\" \"*.d.cts*\" \"*.d.mts*\" \"*.tsbuildinfo\""},"dependencies":{"@endo/cache-map":"^1.1.0","@endo/env-options":"^1.1.11","@endo/immutable-arraybuffer":"^1.1.2"},"devDependencies":{"@babel/generator":"^7.26.3","@babel/parser":"~7.26.2","@babel/traverse":"~7.25.9","@babel/types":"~7.26.0","@endo/compartment-mapper":"^1.6.3","@endo/module-source":"^1.3.3","@endo/test262-runner":"^0.1.48","@types/babel__traverse":"^7.20.5","ava":"^6.1.3","babel-eslint":"^10.1.0","c8":"^7.14.0","core-js":"^3.31.0","eslint":"^8.57.1","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^9.1.0","eslint-plugin-eslint-comments":"^3.2.0","eslint-plugin-import":"^2.31.0","hermes-engine-cli":"^0.12.0","prettier":"^3.5.3","terser":"^5.16.6","tsd":"^0.31.2","typescript":"~5.8.3"},"files":["./*.d.ts","./*.js","./*.map","LICENSE*","SECURITY*","dist","lib","src","tools"],"publishConfig":{"access":"public"},"eslintConfig":{"extends":["plugin:@endo/ses"]},"ava":{"files":["test/**/*.test.*"],"timeout":"2m"},"typeCoverage":{"atLeast":81.17},"gitHead":"9815aea9541f241389d2135c6097a7442bdffa17","_lastModified":"2026-04-14T00:04:40.387Z"}
+{"name":"ses","version":"1.14.0","description":"Hardened JavaScript for Fearless Cooperation","keywords":["lockdown","harden","Compartment","assert","security","confinement","isolation","object capabilities","ocaps","secure execution","third-party code","prototype pollution","supply-chain attack","plugin"],"author":"Agoric","license":"Apache-2.0","homepage":"https://github.com/Agoric/SES-shim/tree/master/packages/ses#readme","repository":{"type":"git","url":"git+https://github.com/endojs/endo.git","directory":"packages/ses"},"bugs":{"url":"https://github.com/endojs/endo/issues"},"type":"module","main":"./dist/ses.cjs","module":"./index.js","unpkg":"./dist/ses.umd.js","types":"./types.d.ts","exports":{".":{"import":{"types":"./types.d.ts","xs":"./src-xs/index.js","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./lockdown":{"import":{"types":"./types.d.ts","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./hermes":{"require":{"types":"./dist/types.d.cts","default":"./dist/ses-hermes.cjs"}},"./tools.js":"./tools.js","./assert-shim.js":"./assert-shim.js","./lockdown-shim.js":{"xs":"./src-xs/lockdown-shim.js","default":"./lockdown-shim.js"},"./compartment-shim.js":{"xs":"./src-xs/compartment-shim.js","default":"./compartment-shim.js"},"./console-shim.js":"./console-shim.js","./package.json":"./package.json"},"scripts":{"build:vanilla":"node scripts/bundle.js","build:hermes":"node scripts/bundle.js hermes","build":"yarn build:vanilla && yarn build:hermes","clean":"rm -rf dist","cover":"c8 ava","demo":"python3 -m http.server","lint":"yarn lint:types && yarn lint:eslint","lint-fix":"eslint --fix .","lint:eslint":"eslint .","lint:types":"tsc","prepare":"npm run clean && npm run build","qt":"ava","test":"tsd && ava","test:hermes":"./scripts/hermes-test.sh","test:xs":"xst dist/ses.umd.js test/_lockdown-safe.js && node scripts/generate-test-xs.js && xst tmp/test-xs.js && rm -rf tmp","postpack":"git clean -fX \"*.d.ts*\" \"*.d.cts*\" \"*.d.mts*\" \"*.tsbuildinfo\""},"dependencies":{"@endo/cache-map":"^1.1.0","@endo/env-options":"^1.1.11","@endo/immutable-arraybuffer":"^1.1.2"},"devDependencies":{"@babel/generator":"^7.26.3","@babel/parser":"~7.26.2","@babel/traverse":"~7.25.9","@babel/types":"~7.26.0","@endo/compartment-mapper":"^1.6.3","@endo/module-source":"^1.3.3","@endo/test262-runner":"^0.1.48","@types/babel__traverse":"^7.20.5","ava":"^6.1.3","babel-eslint":"^10.1.0","c8":"^7.14.0","core-js":"^3.31.0","eslint":"^8.57.1","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^9.1.0","eslint-plugin-eslint-comments":"^3.2.0","eslint-plugin-import":"^2.31.0","hermes-engine-cli":"^0.12.0","prettier":"^3.5.3","terser":"^5.16.6","tsd":"^0.31.2","typescript":"~5.8.3"},"files":["./*.d.ts","./*.js","./*.map","LICENSE*","SECURITY*","dist","lib","src","tools"],"publishConfig":{"access":"public"},"eslintConfig":{"extends":["plugin:@endo/ses"]},"ava":{"files":["test/**/*.test.*"],"timeout":"2m"},"typeCoverage":{"atLeast":81.17},"gitHead":"9815aea9541f241389d2135c6097a7442bdffa17","_lastModified":"2026-04-17T05:12:19.380Z"}

package/dist/node_modules/zod/package.json

@@ -1 +1 @@
-{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-04-14T00:04:41.504Z"}
+{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-04-17T05:12:20.428Z"}

package/dist/server/flow-surfaces/blueprint/compile-blocks.js

@@ -117,15 +117,15 @@ const APPLY_BLUEPRINT_BLOCK_RESOURCE_SHORTHAND_KEYS = [
   "associationField"
 ];
 const APPLY_BLUEPRINT_RECORD_CAPABLE_BLOCK_TYPES = /* @__PURE__ */ new Set(["table", "details", "list", "gridCard"]);
-const APPLY_BLUEPRINT_RECORD_ACTION_TYPES = /* @__PURE__ */ new Set([
+const APPLY_BLUEPRINT_AUTO_PROMOTED_RECORD_ACTION_TYPES = /* @__PURE__ */ new Set([
   "view",
   "edit",
   "delete",
   "updateRecord",
-  "duplicate",
-  "addChild"
+  "duplicate"
 ]);
 const APPLY_BLUEPRINT_BLOCK_TYPES = new Set(APPLY_BLUEPRINT_BLOCK_TYPE_ENUM);
+const APPLY_BLUEPRINT_ADD_CHILD_RECORD_ACTION_ERROR = "type 'addChild' must be authored under recordActions and is only valid when the live target catalog.recordActions exposes it for a tree collection table with treeTable enabled";
 function assertNoBlockLevelLayout(input, context) {
   if (Object.prototype.hasOwnProperty.call(input, "layout")) {
     (0, import_errors.throwBadRequest)(`${context}.layout is not supported; layout is only allowed on tabs[] and popup`);
@@ -266,9 +266,12 @@ function splitApplyBlueprintBlockActionsByScope(block, context) {
   }
   const promotedRecordActions = [];
   const remainingActions = [];
-  rawActions.forEach((action) => {
+  rawActions.forEach((action, index) => {
     const actionType = readApplyBlueprintActionType(action);
-    if (actionType && APPLY_BLUEPRINT_RECORD_ACTION_TYPES.has(actionType)) {
+    if (actionType === "addChild") {
+      (0, import_errors.throwBadRequest)(`${context}.actions[${index}] ${APPLY_BLUEPRINT_ADD_CHILD_RECORD_ACTION_ERROR}`);
+    }
+    if (actionType && APPLY_BLUEPRINT_AUTO_PROMOTED_RECORD_ACTION_TYPES.has(actionType)) {
       promotedRecordActions.push(action);
       return;
     }
@@ -486,6 +489,14 @@ function compilePopup(popup, scopePrefix, assets, context, options = {}) {
   (0, import_private_utils.assertOnlyAllowedKeys)(popup, context, APPLY_BLUEPRINT_POPUP_ALLOWED_KEYS);
   const popupTitle = (0, import_private_utils.readOptionalString)(popup.title);
   const template = ensureOptionalTemplate(popup.template, `${context}.template`);
+  if (template) {
+    return {
+      popup: {
+        template
+      },
+      popupTitle
+    };
+  }
   const rawPopupBlocks = readOptionalItems(popup.blocks, `${context}.blocks`);
   const popupBlocks = options.ownerActionType === "edit" && rawPopupBlocks.length ? normalizeEditPopupBlocks(rawPopupBlocks, context) : rawPopupBlocks;
   const compiledBlocks = popupBlocks.length ? compileBlocks(

package/dist/server/flow-surfaces/payload-shape.js

@@ -53,9 +53,6 @@ function validateFlowSurfacePayloadShape(actionName, value, path) {
   if (import_lodash.default.isPlainObject(value.stepParams) && Object.prototype.hasOwnProperty.call(value.stepParams, import_key_registry.FLOW_SURFACE_INTERNAL_META_KEY)) {
     (0, import_errors.throwBadRequest)(`flowSurfaces ${actionName} ${path}.stepParams.${import_key_registry.FLOW_SURFACE_INTERNAL_META_KEY} is reserved`);
   }
-  if (import_lodash.default.isPlainObject(value.template) && (Object.prototype.hasOwnProperty.call(value, "mode") || Object.prototype.hasOwnProperty.call(value, "blocks") || Object.prototype.hasOwnProperty.call(value, "layout"))) {
-    (0, import_errors.throwBadRequest)(`flowSurfaces ${actionName} ${path} cannot mix template with local popup content`);
-  }
   Object.entries(value).forEach(([key, child]) => validateFlowSurfacePayloadShape(actionName, child, `${path}.${key}`));
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/server/flow-surfaces/service.d.ts

@@ -380,6 +380,7 @@ export declare class FlowSurfacesService {
     }>;
     private normalizeInlineSettings;
     private normalizeInlinePopup;
+    private buildInlinePopupTemplateOpenView;
     private peekInlineFieldSettingsOpenView;
     private assertOpenViewUidTarget;
     private normalizeFlowTemplateMode;
@@ -399,7 +400,6 @@ export declare class FlowSurfacesService {
     private buildDefaultFieldOpenView;
     private ensureLocalFieldPopupSurface;
     private applyInlineNodeSettings;
-    private assertInlinePopupTemplateConflict;
     private applyInlineFieldPopup;
     private applyInlineFieldSettings;
     private applyInlineStandaloneFieldSettings;
@@ -516,7 +516,16 @@ export declare class FlowSurfacesService {
     private resolveAddRecordActionCatalogItem;
     private resolveComposeBlockActionCatalogItem;
     private resolveComposeRecordActionCatalogItem;
-    private resolveRecordActionContainer;
+    private isAddChildCatalogItem;
+    private isTreeCollection;
+    private isTreeTableEnabled;
+    private resolveAddChildOwnerNode;
+    private resolveOwnerCollectionForAddChild;
+    private canUseAddChildOnOwnerNode;
+    private assertAddChildSupportedForOwnerNode;
+    private filterTargetRecordActions;
+    private inspectRecordActionContainer;
+    private materializeRecordActionContainer;
     private runBatchCreate;
     private normalizeComposeBlock;
     private normalizeComposeBlocks;

package/dist/server/flow-surfaces/service.js

@@ -684,7 +684,8 @@ class FlowSurfacesService {
     }
     if (catalogAnalysis.selectedSections.includes("recordActions")) {
       const availableRecordActions = node ? catalogAnalysis.recordActionContainerUse ? (0, import_catalog.getAvailableActionCatalogItems)(catalogAnalysis.recordActionContainerUse, "record", enabledPackages) : [] : (0, import_catalog.getAvailableActionCatalogItems)(void 0, "record", enabledPackages);
-      response.recordActions = availableRecordActions.map((item) => this.projectCatalogItem(item, expandFlags));
+      const filteredRecordActions = node ? await this.filterTargetRecordActions(availableRecordActions, node, options.transaction) : availableRecordActions;
+      response.recordActions = filteredRecordActions.map((item) => this.projectCatalogItem(item, expandFlags));
     }
     if (catalogAnalysis.selectedSections.includes("node")) {
       response.node = this.projectCatalogNode(node, resolved, expandFlags);
@@ -4837,7 +4838,7 @@ class FlowSurfacesService {
     const inlineSettings = this.normalizeInlineSettings("addRecordAction", values.settings);
     const inlinePopup = this.normalizeInlinePopup("addRecordAction", values.popup);
     const enabledPackages = await this.resolveEnabledPluginPackages(options);
-    const container = await this.resolveRecordActionContainer(target, options.transaction);
+    const container = await this.inspectRecordActionContainer(target, options.transaction);
     const actionCatalogItem = this.resolveAddRecordActionCatalogItem(
       {
         type: values.type,
@@ -4851,12 +4852,16 @@ class FlowSurfacesService {
     if (inlinePopup && !POPUP_ACTION_USES.has(actionCatalogItem.use)) {
       (0, import_errors.throwBadRequest)(`flowSurfaces addRecordAction type '${actionCatalogItem.key}' does not support popup`);
     }
+    if (this.isAddChildCatalogItem(actionCatalogItem)) {
+      await this.assertAddChildSupportedForOwnerNode(container.ownerNode, "addRecordAction", options.transaction);
+    }
     (0, import_action_scope.assertRequestedActionScope)({
       requestedScope: void 0,
       resolvedScope,
       containerUse: container.containerUse,
       context: "addRecordAction"
     });
+    const materializedContainer = await this.materializeRecordActionContainer(container, options.transaction);
     const resourceContext = container.ownerUid ? await this.locator.resolveCollectionContext(container.ownerUid, options.transaction).catch(() => null) : null;
     const action = (0, import_builder.buildActionTree)({
       use: actionCatalogItem.use,
@@ -4870,9 +4875,9 @@ class FlowSurfacesService {
     this.contractGuard.validateNodeTreeAgainstContract(action);
     const created = await this.repository.upsertModel(
       {
-        parentId: container.parentUid,
-        subKey: container.subKey,
-        subType: container.subType,
+        parentId: materializedContainer.parentUid,
+        subKey: materializedContainer.subKey,
+        subType: materializedContainer.subType,
         ...action
       },
       { transaction: options.transaction }
@@ -4882,8 +4887,8 @@ class FlowSurfacesService {
     await this.syncFlowTemplateUsagesForNodeTree(created, options.transaction);
     const result = {
       uid: created,
-      parentUid: container.parentUid,
-      subKey: container.subKey,
+      parentUid: materializedContainer.parentUid,
+      subKey: materializedContainer.subKey,
       scope: actionCatalogItem.scope,
       ...await this.collectComposeActionKeys(created, options.transaction)
     };
@@ -4962,6 +4967,13 @@ class FlowSurfacesService {
     }
     return popup;
   }
+  buildInlinePopupTemplateOpenView(popup) {
+    const normalizedTitle = import_lodash.default.isUndefined(popup == null ? void 0 : popup.title) || import_lodash.default.isNull(popup == null ? void 0 : popup.title) ? void 0 : String(popup.title).trim() || void 0;
+    return (0, import_service_utils.buildDefinedPayload)({
+      template: popup == null ? void 0 : popup.template,
+      title: normalizedTitle
+    });
+  }
   peekInlineFieldSettingsOpenView(settings, wrapperUse) {
     if (!settings || !Object.keys(settings).length) {
       return void 0;
@@ -5351,19 +5363,9 @@ class FlowSurfacesService {
       (0, import_service_utils.rethrowInlineConfigurationError)(error, `flowSurfaces ${actionName} settings invalid`);
     }
   }
-  assertInlinePopupTemplateConflict(actionName, popup) {
-    const forbiddenKeys = ["blocks", "layout", "mode"].filter((key) => !import_lodash.default.isUndefined(popup[key]));
-    if (forbiddenKeys.length) {
-      (0, import_errors.throwBadRequest)(
-        `flowSurfaces ${actionName} popup.template cannot be combined with ${forbiddenKeys.join(", ")}`,
-        "FLOW_SURFACE_TEMPLATE_POPUP_CONFLICT"
-      );
-    }
-  }
   async applyInlineFieldPopup(actionName, result, popup, options) {
     const fieldHostUid = result.fieldUid || result.uid;
     if (!import_lodash.default.isUndefined(popup == null ? void 0 : popup.template)) {
-      this.assertInlinePopupTemplateConflict(actionName, popup);
       Object.assign(
         result,
         await this.configureFieldNode(
@@ -5371,9 +5373,7 @@ class FlowSurfacesService {
             uid: fieldHostUid
           },
           {
-            openView: {
-              template: popup.template
-            }
+            openView: this.buildInlinePopupTemplateOpenView(popup)
           },
           {
             ...options,
@@ -5724,16 +5724,13 @@ class FlowSurfacesService {
       (0, import_errors.throwBadRequest)(`flowSurfaces ${actionName} popup cannot be combined with external openView.uid`);
     }
     if (popup && (0, import_default_action_popup.hasFlowSurfaceInlinePopupTemplate)(popup)) {
-      this.assertInlinePopupTemplateConflict(actionName, popup);
       await this.configureActionNode(
         {
           uid: actionUid
         },
         actionNode.use,
         {
-          openView: {
-            template: popup.template
-          }
+          openView: this.buildInlinePopupTemplateOpenView(popup)
         },
         {
           ...options,
@@ -6823,23 +6820,79 @@ class FlowSurfacesService {
       }
     );
   }
-  async resolveRecordActionContainer(target, transaction) {
+  isAddChildCatalogItem(item) {
+    return (item == null ? void 0 : item.key) === "addChild" || (item == null ? void 0 : item.use) === "AddChildActionModel";
+  }
+  isTreeCollection(collection) {
+    var _a;
+    return (collection == null ? void 0 : collection.template) === "tree" || ((_a = collection == null ? void 0 : collection.options) == null ? void 0 : _a.template) === "tree" || (collection == null ? void 0 : collection.tree) === true;
+  }
+  isTreeTableEnabled(node) {
+    var _a, _b;
+    return (node == null ? void 0 : node.use) === "TableBlockModel" && (((_a = node == null ? void 0 : node.props) == null ? void 0 : _a.treeTable) === true || ((_b = node == null ? void 0 : node.decoratorProps) == null ? void 0 : _b.treeTable) === true || import_lodash.default.get(node, ["stepParams", "tableSettings", "treeTable", "treeTable"]) === true);
+  }
+  async resolveAddChildOwnerNode(node, transaction) {
+    if (!(node == null ? void 0 : node.uid) || (node == null ? void 0 : node.use) !== "TableActionsColumnModel") {
+      return node;
+    }
+    const ownerUid = node.parentId || await this.locator.findParentUid(node.uid, transaction);
+    if (!ownerUid) {
+      return node;
+    }
+    return await this.repository.findModelById(ownerUid, {
+      transaction,
+      includeAsyncNode: true
+    }) || node;
+  }
+  async resolveOwnerCollectionForAddChild(node, transaction) {
+    var _a;
+    const ownerNode = await this.resolveAddChildOwnerNode(node, transaction);
+    const resourceInit = import_lodash.default.get(ownerNode, ["stepParams", "resourceSettings", "init"]) || ((ownerNode == null ? void 0 : ownerNode.uid) ? (_a = await this.locator.resolveCollectionContext(ownerNode.uid, transaction).catch(() => null)) == null ? void 0 : _a.resourceInit : null);
+    return this.resolveCollectionFromInit(resourceInit);
+  }
+  async canUseAddChildOnOwnerNode(node, transaction) {
+    const ownerNode = await this.resolveAddChildOwnerNode(node, transaction);
+    if ((ownerNode == null ? void 0 : ownerNode.use) !== "TableBlockModel" || !this.isTreeTableEnabled(ownerNode)) {
+      return false;
+    }
+    const collection = await this.resolveOwnerCollectionForAddChild(ownerNode, transaction);
+    return this.isTreeCollection(collection);
+  }
+  async assertAddChildSupportedForOwnerNode(node, context, transaction) {
+    if (await this.canUseAddChildOnOwnerNode(node, transaction)) {
+      return;
+    }
+    (0, import_errors.throwBadRequest)(
+      `flowSurfaces ${context} type 'addChild' only supports tables bound to tree collections with tree table enabled`
+    );
+  }
+  async filterTargetRecordActions(items, node, transaction) {
+    if (!items.some((item) => this.isAddChildCatalogItem(item))) {
+      return items;
+    }
+    if (await this.canUseAddChildOnOwnerNode(node, transaction)) {
+      return items;
+    }
+    return items.filter((item) => !this.isAddChildCatalogItem(item));
+  }
+  async inspectRecordActionContainer(target, transaction) {
     var _a, _b;
     const resolved = await this.locator.resolve(target, { transaction });
     const node = resolved.node || await this.repository.findModelById(resolved.uid, { transaction, includeAsyncNode: true });
     const use = node == null ? void 0 : node.use;
     if (use === "TableBlockModel") {
       return {
+        ownerNode: node,
         ownerUid: node.uid,
         ownerUse: use,
         containerUse: "TableActionsColumnModel",
-        parentUid: await this.ensureTableActionsColumn(node.uid, transaction),
         subKey: "actions",
         subType: "array"
       };
     }
     if (use === "DetailsBlockModel") {
       return {
+        ownerNode: node,
         ownerUid: node.uid,
         ownerUse: use,
         containerUse: use,
@@ -6857,6 +6910,7 @@ class FlowSurfacesService {
         );
       }
       return {
+        ownerNode: node,
         ownerUid: node.uid,
         ownerUse: use,
         containerUse: use === "ListBlockModel" ? "ListItemModel" : "GridCardItemModel",
@@ -6879,6 +6933,15 @@ class FlowSurfacesService {
       `flowSurfaces addRecordAction target '${use || resolved.uid}' is not a supported record action surface`
     );
   }
+  async materializeRecordActionContainer(container, transaction) {
+    if (container.ownerUse !== "TableBlockModel") {
+      return container;
+    }
+    return {
+      ...container,
+      parentUid: container.parentUid || await this.ensureTableActionsColumn(container.ownerUid, transaction)
+    };
+  }
   async runBatchCreate(options) {
     var _a, _b;
     const target = this.normalizeWriteTarget(options.actionName, (_a = options.values) == null ? void 0 : _a.target, options.values);

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

@@ -1771,6 +1771,7 @@ declare const _default: {
             FlowSurfaceApplyBlueprintActionSpec: {
                 oneOf: ({
                     type: string;
+                    enum: string[];
                     required?: undefined;
                     properties?: undefined;
                     additionalProperties?: undefined;
@@ -1804,11 +1805,13 @@ declare const _default: {
                         };
                     };
                     additionalProperties: boolean;
+                    enum?: undefined;
                 })[];
             };
             FlowSurfaceApplyBlueprintRecordActionSpec: {
                 oneOf: ({
                     type: string;
+                    enum: string[];
                     required?: undefined;
                     properties?: undefined;
                     additionalProperties?: undefined;
@@ -1842,6 +1845,7 @@ declare const _default: {
                         };
                     };
                     additionalProperties: boolean;
+                    enum?: undefined;
                 })[];
             };
             FlowSurfaceApplyBlueprintBlockSpec: {

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

@@ -909,6 +909,20 @@ export declare const flowSurfaceExamples: {
             }[];
         };
     };
+    addRecordAddChildAction: {
+        target: {
+            uid: string;
+        };
+        type: string;
+        settings: {
+            title: string;
+            openView: {
+                dataSourceKey: string;
+                collectionName: string;
+                mode: string;
+            };
+        };
+    };
     addRecordJsAction: {
         target: {
             uid: string;
@@ -1045,6 +1059,23 @@ export declare const flowSurfaceExamples: {
             popup?: undefined;
         })[];
     };
+    addRecordAddChildActions: {
+        target: {
+            uid: string;
+        };
+        recordActions: {
+            key: string;
+            type: string;
+            settings: {
+                title: string;
+                openView: {
+                    dataSourceKey: string;
+                    collectionName: string;
+                    mode: string;
+                };
+            };
+        }[];
+    };
     updateSettings: {
         target: {
             uid: string;

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

@@ -1058,6 +1058,20 @@ const flowSurfaceExamples = {
       ]
     }
   },
+  addRecordAddChildAction: {
+    target: {
+      uid: "tree-table-block-uid"
+    },
+    type: "addChild",
+    settings: {
+      title: "Add child category",
+      openView: {
+        dataSourceKey: "main",
+        collectionName: "categories",
+        mode: "drawer"
+      }
+    }
+  },
   addRecordJsAction: {
     target: {
       uid: "details-block-uid"
@@ -1203,6 +1217,25 @@ const flowSurfaceExamples = {
       }
     ]
   },
+  addRecordAddChildActions: {
+    target: {
+      uid: "tree-table-block-uid"
+    },
+    recordActions: [
+      {
+        key: "addChild",
+        type: "addChild",
+        settings: {
+          title: "Add child category",
+          openView: {
+            dataSourceKey: "main",
+            collectionName: "categories",
+            mode: "drawer"
+          }
+        }
+      }
+    ]
+  },
   updateSettings: {
     target: {
       uid: "table-block-uid"

package/dist/swagger/flow-surfaces.js

@@ -74,6 +74,7 @@ const ACTION_TYPE_ENUM = [
   "reset",
   "collapse"
 ];
+const APPLY_BLUEPRINT_ACTION_TYPE_ENUM = ACTION_TYPE_ENUM.filter((item) => item !== "addChild");
 const NON_RECORD_ACTION_TYPE_ENUM = [
   "filter",
   "addNew",
@@ -124,6 +125,8 @@ const APPLY_BLUEPRINT_BLOCK_TYPE_ENUM = [
   "actionPanel",
   "jsBlock"
 ];
+const ADD_CHILD_TREE_TABLE_NOTE = "`addChild` is only valid when the live target `catalog.recordActions` exposes it, which normally means a table bound to a tree collection with `treeTable` enabled.";
+const APPLY_BLUEPRINT_ADD_CHILD_NOTE = "`addChild` is not auto-promoted from `actions`; author it only under `recordActions`, and only when the live target `catalog.recordActions` exposes it for a tree table.";
 const REACTION_FINGERPRINT_DESCRIPTION = "Optional optimistic-concurrency fingerprint from `getReactionMeta.capabilities[].fingerprint`. When provided, the write fails with HTTP 409 if the current slot fingerprint no longer matches.";
 const REACTION_RULES_REPLACE_DESCRIPTION = "Full replacement payload for the resolved reaction slot. Pass `[]` to clear all rules from that slot.";
 const REACTION_LOCALIZED_FORM_TARGET_DESCRIPTION = "Reaction write target. Use the live block/action uid for localized edits. For form field-value and form field-linkage writes, keep passing the outer form block uid; the backend resolves the inner form-grid slot automatically.";
@@ -707,7 +710,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Add a field wrapper and inner field under a field container",
     description: valuesCompatibilityNote(
-      "Automatically derives the wrapper/inner-field combination from the container use and the field interface. It can also import a form template through `template`, using `reference` or `copy` mode for the target form grid. `fieldUse` is only kept as a compatibility check and is no longer an arbitrary creation entry. Direct add does not accept raw `wrapperProps` / `fieldProps` / `props` / `decoratorProps` / `stepParams` / `flowRegistry`. Use `settings` and reuse the public configuration semantics from `configure.changes` plus the catalog item/node `configureOptions`. Popup-capable fields can also pass `popup` directly to append a local popup subtree or `popup.template` to reuse a saved popup template in `reference` / `copy` mode. If local openView is enabled but no popup content is provided, the server fills in the popup page/tab/grid shell automatically."
+      "Automatically derives the wrapper/inner-field combination from the container use and the field interface. It can also import a form template through `template`, using `reference` or `copy` mode for the target form grid. `fieldUse` is only kept as a compatibility check and is no longer an arbitrary creation entry. Direct add does not accept raw `wrapperProps` / `fieldProps` / `props` / `decoratorProps` / `stepParams` / `flowRegistry`. Use `settings` and reuse the public configuration semantics from `configure.changes` plus the catalog item/node `configureOptions`. Popup-capable fields can also pass `popup` directly to append a local popup subtree or `popup.template` to reuse a saved popup template in `reference` / `copy` mode. When `popup.template` is present, `popup.title` still applies, while local `popup.mode` / `popup.blocks` / `popup.layout` are accepted but ignored. If local openView is enabled but no popup content is provided, the server fills in the popup page/tab/grid shell automatically."
     ),
     requestBody: {
       required: true,
@@ -745,7 +748,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Add a non-record action under an allowed block/form/filter-form/action-panel container",
     description: valuesCompatibilityNote(
-      "Only non-record actions that are public in the catalog and visible in the current container may be created. Typical cases include table block actions, form submit, filter-form reset, and action-panel actions. Use `addRecordAction` for record actions. Direct add does not accept raw `props` / `decoratorProps` / `stepParams` / `flowRegistry`. Use `settings` and reuse `configure.changes` plus the catalog item/node `configureOptions`. Popup-capable actions may also include `popup` directly to append a popup subtree or `popup.template` to reuse a saved popup template in `reference` / `copy` mode."
+      "Only non-record actions that are public in the catalog and visible in the current container may be created. Typical cases include table block actions, form submit, filter-form reset, and action-panel actions. Use `addRecordAction` for record actions. Direct add does not accept raw `props` / `decoratorProps` / `stepParams` / `flowRegistry`. Use `settings` and reuse `configure.changes` plus the catalog item/node `configureOptions`. Popup-capable actions may also include `popup` directly to append a popup subtree or `popup.template` to reuse a saved popup template in `reference` / `copy` mode. When `popup.template` is present, `popup.title` still applies, while local `popup.mode` / `popup.blocks` / `popup.layout` are accepted but ignored."
     ),
     requestBody: {
       required: true,
@@ -779,7 +782,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Add a record action under a record-capable owner target",
     description: valuesCompatibilityNote(
-      "Only record actions that are public in the catalog and visible in the current container may be created. The public target must be a record-capable owner target such as table/details/list/gridCard. Do not pass internal container uids such as a table actions column or a list/gridCard item. Direct add does not accept raw `props` / `decoratorProps` / `stepParams` / `flowRegistry`. Use `settings` and reuse `configure.changes` plus the catalog item/node `configureOptions`. Popup-capable actions may also include `popup` directly to append a popup subtree or `popup.template` to reuse a saved popup template in `reference` / `copy` mode."
+      `Only record actions that are public in the catalog and visible in the current container may be created. The public target must be a record-capable owner target such as table/details/list/gridCard. Do not pass internal container uids such as a table actions column or a list/gridCard item. ${ADD_CHILD_TREE_TABLE_NOTE} Direct add does not accept raw \`props\` / \`decoratorProps\` / \`stepParams\` / \`flowRegistry\`. Use \`settings\` and reuse \`configure.changes\` plus the catalog item/node \`configureOptions\`. Popup-capable actions may also include \`popup\` directly to append a popup subtree or \`popup.template\` to reuse a saved popup template in \`reference\` / \`copy\` mode. When \`popup.template\` is present, \`popup.title\` still applies, while local \`popup.mode\` / \`popup.blocks\` / \`popup.layout\` are accepted but ignored.`
     ),
     requestBody: {
       required: true,
@@ -791,6 +794,10 @@ const actionDocs = {
               summary: "Create a view action under a table record-action owner target",
               value: import_flow_surfaces.flowSurfaceExamples.addRecordAction
             },
+            addChild: {
+              summary: "Create an addChild record action on a tree table target",
+              value: import_flow_surfaces.flowSurfaceExamples.addRecordAddChildAction
+            },
             js: {
               summary: "Create a JS record action under a details block owner target",
               value: import_flow_surfaces.flowSurfaceExamples.addRecordJsAction
@@ -814,7 +821,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Add multiple fields sequentially under the same target",
     description: valuesCompatibilityNote(
-      "Creates multiple fields sequentially under the same target. The request may either import one shared `template` or create explicit `fields[]`. Each item may include `settings`, and popup-capable fields may also include `popup` directly for local popup content or `popup.template` to reuse a saved popup template in `reference` / `copy` mode. Raw `wrapperProps` / `fieldProps` / `props` / `decoratorProps` / `stepParams` / `flowRegistry` are not accepted. Partial-success semantics apply: a failure in one item does not roll back the others. Results are returned in input order as `index/key/ok/result/error`, and each `error` always includes `message/type/code/status`."
+      "Creates multiple fields sequentially under the same target. The request may either import one shared `template` or create explicit `fields[]`. Each item may include `settings`, and popup-capable fields may also include `popup` directly for local popup content or `popup.template` to reuse a saved popup template in `reference` / `copy` mode. When `popup.template` is present, `popup.title` still applies, while local `popup.mode` / `popup.blocks` / `popup.layout` are accepted but ignored. Raw `wrapperProps` / `fieldProps` / `props` / `decoratorProps` / `stepParams` / `flowRegistry` are not accepted. Partial-success semantics apply: a failure in one item does not roll back the others. Results are returned in input order as `index/key/ok/result/error`, and each `error` always includes `message/type/code/status`."
     ),
     requestBody: requestBody("FlowSurfaceAddFieldsRequest", import_flow_surfaces.flowSurfaceExamples.addFields),
     responses: responses("FlowSurfaceAddFieldsResult")
@@ -823,7 +830,7 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Add multiple non-record actions sequentially under the same target",
     description: valuesCompatibilityNote(
-      "Creates multiple non-record actions sequentially under the same target. Each item may include `settings`, and popup-capable actions may also include `popup`, but raw `props` / `decoratorProps` / `stepParams` / `flowRegistry` are not accepted. Partial-success semantics apply. Record actions do not belong to this entry and should use `addRecordActions` instead. Each failed item always returns an `error` with `message/type/code/status`."
+      "Creates multiple non-record actions sequentially under the same target. Each item may include `settings`, and popup-capable actions may also include `popup` directly for local popup content or `popup.template` to reuse a saved popup template in `reference` / `copy` mode. When `popup.template` is present, `popup.title` still applies, while local `popup.mode` / `popup.blocks` / `popup.layout` are accepted but ignored. Raw `props` / `decoratorProps` / `stepParams` / `flowRegistry` are not accepted. Partial-success semantics apply. Record actions do not belong to this entry and should use `addRecordActions` instead. Each failed item always returns an `error` with `message/type/code/status`."
     ),
     requestBody: requestBody("FlowSurfaceAddActionsRequest", import_flow_surfaces.flowSurfaceExamples.addActions),
     responses: responses("FlowSurfaceAddActionsResult")
@@ -832,9 +839,26 @@ const actionDocs = {
     tags: [FLOW_SURFACES_TAG],
     summary: "Add multiple record actions sequentially under the same record-capable owner target",
     description: valuesCompatibilityNote(
-      "Creates multiple record actions sequentially under the same target. The target must be a record-capable owner target, and the server resolves the canonical record-action container automatically. Do not pass internal container uids such as a table actions column or a list/gridCard item. Each item may include `settings`, and popup-capable actions may also include `popup`, but raw `props` / `decoratorProps` / `stepParams` / `flowRegistry` are not accepted. Partial-success semantics apply: a failure in one item does not roll back the others. Each failed item always returns an `error` with `message/type/code/status`."
+      `Creates multiple record actions sequentially under the same target. The target must be a record-capable owner target, and the server resolves the canonical record-action container automatically. Do not pass internal container uids such as a table actions column or a list/gridCard item. ${ADD_CHILD_TREE_TABLE_NOTE} Each item may include \`settings\`, and popup-capable actions may also include \`popup\` directly for local popup content or \`popup.template\` to reuse a saved popup template in \`reference\` / \`copy\` mode. When \`popup.template\` is present, \`popup.title\` still applies, while local \`popup.mode\` / \`popup.blocks\` / \`popup.layout\` are accepted but ignored. Raw \`props\` / \`decoratorProps\` / \`stepParams\` / \`flowRegistry\` are not accepted. Partial-success semantics apply: a failure in one item does not roll back the others. Each failed item always returns an \`error\` with \`message/type/code/status\`.`
     ),
-    requestBody: requestBody("FlowSurfaceAddRecordActionsRequest", import_flow_surfaces.flowSurfaceExamples.addRecordActions),
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: ref("FlowSurfaceAddRecordActionsRequest"),
+          examples: {
+            basic: {
+              summary: "Create multiple standard record actions under a table owner target",
+              value: import_flow_surfaces.flowSurfaceExamples.addRecordActions
+            },
+            addChild: {
+              summary: "Create addChild under a tree table owner target",
+              value: import_flow_surfaces.flowSurfaceExamples.addRecordAddChildActions
+            }
+          }
+        }
+      }
+    },
     responses: responses("FlowSurfaceAddRecordActionsResult")
   },
   updateSettings: {
@@ -3072,7 +3096,8 @@ const schemas = {
   FlowSurfaceApplyBlueprintActionSpec: {
     oneOf: [
       {
-        type: "string"
+        type: "string",
+        enum: APPLY_BLUEPRINT_ACTION_TYPE_ENUM
       },
       {
         type: "object",
@@ -3081,8 +3106,8 @@ const schemas = {
           key: { type: "string" },
           type: {
             type: "string",
-            enum: ACTION_TYPE_ENUM,
-            description: "Action type. On record-capable blocks (`table`, `details`, `list`, `gridCard`), record actions such as `view`, `edit`, `updateRecord`, and `delete` should normally be authored under `recordActions`; applyBlueprint also auto-promotes them from `actions` for convenience. For custom `edit` popups, include exactly one `editForm` block inside popup.blocks."
+            enum: APPLY_BLUEPRINT_ACTION_TYPE_ENUM,
+            description: `Action type. On record-capable blocks (\`table\`, \`details\`, \`list\`, \`gridCard\`), record actions such as \`view\`, \`edit\`, \`updateRecord\`, \`delete\`, and \`duplicate\` should normally be authored under \`recordActions\`; applyBlueprint also auto-promotes those common record actions from \`actions\` for convenience. ${APPLY_BLUEPRINT_ADD_CHILD_NOTE} For custom \`edit\` popups, include exactly one \`editForm\` block inside popup.blocks.`
           },
           title: { type: "string" },
           settings: ANY_OBJECT_SCHEMA,
@@ -3097,7 +3122,8 @@ const schemas = {
   FlowSurfaceApplyBlueprintRecordActionSpec: {
     oneOf: [
       {
-        type: "string"
+        type: "string",
+        enum: RECORD_ACTION_TYPE_ENUM
       },
       {
         type: "object",
@@ -3107,7 +3133,7 @@ const schemas = {
           type: {
             type: "string",
             enum: RECORD_ACTION_TYPE_ENUM,
-            description: "Record-action type for record-capable blocks such as `table`, `details`, `list`, and `gridCard`. For custom `edit` popups, include exactly one `editForm` block inside popup.blocks."
+            description: `Record-action type for record-capable blocks such as \`table\`, \`details\`, \`list\`, and \`gridCard\`. ${ADD_CHILD_TREE_TABLE_NOTE} For custom \`edit\` popups, include exactly one \`editForm\` block inside popup.blocks.`
           },
           title: { type: "string" },
           settings: ANY_OBJECT_SCHEMA,
@@ -3157,7 +3183,7 @@ const schemas = {
       },
       actions: {
         type: "array",
-        description: "Block-level actions. On record-capable blocks, `view`, `edit`, `updateRecord`, and `delete` should normally go to `recordActions`; applyBlueprint auto-promotes those common record actions when they are written here.",
+        description: `Block-level actions. On record-capable blocks, \`view\`, \`edit\`, \`updateRecord\`, \`delete\`, and \`duplicate\` should normally go to \`recordActions\`; applyBlueprint auto-promotes those common record actions when they are written here. ${APPLY_BLUEPRINT_ADD_CHILD_NOTE}`,
         items: ref("FlowSurfaceApplyBlueprintActionSpec")
       },
       recordActions: {

package/dist/swagger/index.d.ts

@@ -1771,6 +1771,7 @@ declare const _default: {
             FlowSurfaceApplyBlueprintActionSpec: {
                 oneOf: ({
                     type: string;
+                    enum: string[];
                     required?: undefined;
                     properties?: undefined;
                     additionalProperties?: undefined;
@@ -1804,11 +1805,13 @@ declare const _default: {
                         };
                     };
                     additionalProperties: boolean;
+                    enum?: undefined;
                 })[];
             };
             FlowSurfaceApplyBlueprintRecordActionSpec: {
                 oneOf: ({
                     type: string;
+                    enum: string[];
                     required?: undefined;
                     properties?: undefined;
                     additionalProperties?: undefined;
@@ -1842,6 +1845,7 @@ declare const _default: {
                         };
                     };
                     additionalProperties: boolean;
+                    enum?: undefined;
                 })[];
             };
             FlowSurfaceApplyBlueprintBlockSpec: {

package/package.json

@@ -4,7 +4,7 @@
   "displayName.zh-CN": "前端流引擎",
   "description": "",
   "description.zh-CN": "",
-  "version": "2.1.0-alpha.16",
+  "version": "2.1.0-alpha.18",
   "main": "./dist/server/index.js",
   "license": "Apache-2.0",
   "devDependencies": {
@@ -24,5 +24,5 @@
     "@nocobase/test": "2.x",
     "@nocobase/utils": "2.x"
   },
-  "gitHead": "14cf3dbdb9f0a9669602de4ad21a9464fa27c105"
+  "gitHead": "e75843d4c557117bbcced047b88ed11d601ff86d"
 }