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

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

@@ -157,6 +157,11 @@ const CALENDAR_READONLY_ACTION_MODEL_USES = /* @__PURE__ */ new Set([
   "CalendarTitleActionModel",
   "CalendarViewSelectActionModel"
 ]);
+const AI_EMPLOYEE_ACTION_USE = "AIEmployeeButtonModel";
+const AI_EMPLOYEE_DEFAULT_STYLE = {
+  size: 40,
+  mask: false
+};
 function resolveModelStepParamsOrLegacyObject(model, path, legacyValue) {
   if (import_lodash.default.has(model.stepParams, path)) {
     const value = import_lodash.default.get(model.stepParams, path);
@@ -528,6 +533,15 @@ function buildBlockTree(options) {
         popupSettings: eventPopupSettings
       })
     };
+  } else if (use === "CommentsBlockModel") {
+    model.subModels = {
+      items: [
+        {
+          uid: (0, import_utils.uid)(),
+          use: "CommentItemModel"
+        }
+      ]
+    };
   }
   return assignClientKeysToUids(model, {});
 }
@@ -775,6 +789,14 @@ function assignClientKeysToUids(spec, clientKeyToUid) {
 }
 function buildActionDefaults(options) {
   var _a, _b, _c;
+  if (options.use === AI_EMPLOYEE_ACTION_USE) {
+    return {
+      props: {
+        style: import_lodash.default.cloneDeep(AI_EMPLOYEE_DEFAULT_STYLE)
+      },
+      stepParams: {}
+    };
+  }
   const approvalDefaults = (0, import_approval.buildApprovalActionDefaults)(options.use);
   const readonlyCalendarAction = CALENDAR_READONLY_ACTION_MODEL_USES.has(options.use);
   const props = import_lodash.default.merge(
@@ -831,6 +853,15 @@ function buildActionDefaults(options) {
       }
     };
   }
+  if (options.use === "DeleteCommentActionModel") {
+    stepParams.deleteSettings = {
+      confirm: {
+        enable: true,
+        title: '{{t("Delete record")}}',
+        content: '{{t("Are you sure you want to delete it?")}}'
+      }
+    };
+  }
   if (options.use === "FormSubmitActionModel") {
     stepParams.submitSettings = {
       confirm: {
@@ -922,6 +953,18 @@ function inferActionDefaultProps(use, scope) {
       title: '{{t("Delete")}}',
       icon: "DeleteOutlined"
     },
+    EditCommentActionModel: {
+      type: "link",
+      title: '{{t("Edit")}}'
+    },
+    DeleteCommentActionModel: {
+      type: "link",
+      title: '{{t("Delete")}}'
+    },
+    QuoteReplyActionModel: {
+      type: "link",
+      title: '{{t("Quote reply", { ns: "comments" })}}'
+    },
     UpdateRecordActionModel: {
       type: "link",
       title: '{{t("Update record")}}',
@@ -939,6 +982,14 @@ function inferActionDefaultProps(use, scope) {
       title: '{{t("Refresh")}}',
       icon: "ReloadOutlined"
     },
+    RecordHistoryExpandActionModel: {
+      title: '{{t("Expand all")}}',
+      icon: "NodeExpandOutlined"
+    },
+    RecordHistoryCollapseActionModel: {
+      title: '{{t("Collapse all")}}',
+      icon: "NodeCollapseOutlined"
+    },
     ExpandCollapseActionModel: {
       icon: "DownOutlined"
     },
@@ -1070,7 +1121,9 @@ function inferActionDefaultProps(use, scope) {
   );
 }
 function applyContainerActionStyle(props, containerUse) {
-  if (["TableActionsColumnModel", "ListItemModel", "GridCardItemModel"].includes(String(containerUse || "").trim())) {
+  if (["TableActionsColumnModel", "ListItemModel", "GridCardItemModel", "CommentItemModel"].includes(
+    String(containerUse || "").trim()
+  )) {
     return {
       ...props,
       type: "link",

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

@@ -123,6 +123,8 @@ const DEFAULT_DIRECT_EVENTS = ["beforeRender"];
 const ACTION_DIRECT_EVENTS = ["click", "beforeRender"];
 const ACTION_OBJECT_EVENTS = ["click"];
 const GRID_LAYOUT_CAPABILITIES = { supported: true };
+const AI_EMPLOYEE_ACTION_USE = "AIEmployeeButtonModel";
+const AI_EMPLOYEE_FLOW_SURFACE_OWNER_PLUGIN = "@nocobase/plugin-ai";
 const RUN_JS_ALLOWED_PATHS = ["runJs.code", "runJs.version"];
 const OPEN_VIEW_ALLOWED_PATHS = [
   "openView.mode",
@@ -1451,6 +1453,39 @@ COMMENTS_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
     }
   }
 });
+const RECORD_HISTORY_BLOCK_CONTRACT = createContract({
+  editableDomains: ["props", "stepParams", "flowRegistry"],
+  props: [],
+  stepParams: ["resourceSettings", "recordHistorySettings", "cardSettings"],
+  flowRegistry: true,
+  eventCapabilities: {
+    direct: DEFAULT_DIRECT_EVENTS,
+    object: ["click"]
+  }
+});
+RECORD_HISTORY_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
+  resourceSettings: {
+    allowedPaths: ["init.dataSourceKey", "init.collectionName"],
+    eventBindingSteps: [],
+    pathSchemas: {
+      "init.dataSourceKey": STRING_SCHEMA,
+      "init.collectionName": STRING_SCHEMA
+    }
+  },
+  cardSettings: BLOCK_CARD_SETTINGS_GROUP,
+  recordHistorySettings: {
+    allowedPaths: ["sortOrder.order", "dataScope.filter", "expand.expand", "template.apply", "recordId.recordId"],
+    clearable: true,
+    eventBindingSteps: [],
+    pathSchemas: {
+      "sortOrder.order": STRING_SCHEMA,
+      "dataScope.filter": FILTER_GROUP_SCHEMA,
+      "expand.expand": BOOLEAN_SCHEMA,
+      "template.apply": STRING_SCHEMA,
+      "recordId.recordId": STRING_SCHEMA
+    }
+  }
+});
 const ACTION_COLUMN_CONTRACT = createContract({
   editableDomains: ["props", "stepParams", "flowRegistry"],
   props: ["title", "tooltip", "width", "fixed"],
@@ -2405,6 +2440,17 @@ JS_ITEM_ACTION_CONTRACT.domains.stepParams = groupedDomain({
   buttonSettings: ACTION_BUTTON_SETTINGS_GROUP,
   jsSettings: RUN_JS_SETTINGS_GROUP
 });
+const AI_EMPLOYEE_ACTION_CONTRACT = createContract({
+  editableDomains: ["props"],
+  props: ["aiEmployee", "context", "auto", "tasks", "style"]
+});
+AI_EMPLOYEE_ACTION_CONTRACT.domains.props = keyedDomain(["aiEmployee", "context", "auto", "tasks", "style"], "deep", {
+  aiEmployee: OBJECT_SCHEMA,
+  context: OBJECT_SCHEMA,
+  auto: BOOLEAN_SCHEMA,
+  tasks: ARRAY_SCHEMA,
+  style: OBJECT_SCHEMA
+});
 const APPROVAL_FORM_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["labelWidth", "labelWrap"],
@@ -2528,6 +2574,11 @@ APPROVAL_ACTION_CONTRACT.domains.stepParams = groupedDomain({
     }
   }
 });
+const COMMENT_ITEM_CONTRACT = createContract({
+  editableDomains: [],
+  props: [],
+  stepParams: []
+});
 const nodeContracts = /* @__PURE__ */ new Map();
 function registerNodeContract(use, contract) {
   nodeContracts.set(use, contract);
@@ -2571,6 +2622,8 @@ const NODE_CONTRACT_ENTRIES = [
   ["ActionPanelBlockModel", ACTION_PANEL_BLOCK_CONTRACT],
   ["MapBlockModel", MAP_BLOCK_CONTRACT],
   ["CommentsBlockModel", COMMENTS_BLOCK_CONTRACT],
+  ["CommentItemModel", COMMENT_ITEM_CONTRACT],
+  ["RecordHistoryBlockModel", RECORD_HISTORY_BLOCK_CONTRACT],
   ["TableActionsColumnModel", ACTION_COLUMN_CONTRACT],
   ["FormItemModel", FORM_ITEM_CONTRACT],
   ["FormAssociationItemModel", DETAILS_ITEM_CONTRACT],
@@ -2599,6 +2652,11 @@ const NODE_CONTRACT_ENTRIES = [
   ["KanbanCardViewActionModel", KANBAN_POPUP_ACTION_CONTRACT],
   ["AddChildActionModel", POPUP_ACTION_CONTRACT],
   ["DeleteActionModel", DELETE_ACTION_CONTRACT],
+  ["EditCommentActionModel", SIMPLE_ACTION_CONTRACT],
+  ["DeleteCommentActionModel", DELETE_ACTION_CONTRACT],
+  ["QuoteReplyActionModel", SIMPLE_ACTION_CONTRACT],
+  ["RecordHistoryExpandActionModel", SIMPLE_ACTION_CONTRACT],
+  ["RecordHistoryCollapseActionModel", SIMPLE_ACTION_CONTRACT],
   ["BulkDeleteActionModel", DELETE_ACTION_CONTRACT],
   ["UpdateRecordActionModel", UPDATE_RECORD_ACTION_CONTRACT],
   ["BulkEditActionModel", BULK_EDIT_ACTION_CONTRACT],
@@ -2633,6 +2691,7 @@ const NODE_CONTRACT_ENTRIES = [
   ["FilterFormJSActionModel", JS_ACTION_CONTRACT],
   ["JSItemActionModel", JS_ITEM_ACTION_CONTRACT],
   ["JSActionModel", JS_ACTION_CONTRACT],
+  [AI_EMPLOYEE_ACTION_USE, AI_EMPLOYEE_ACTION_CONTRACT],
   ["ApplyFormSubmitModel", APPROVAL_ACTION_CONTRACT],
   ["ApplyFormSaveDraftModel", APPROVAL_ACTION_CONTRACT],
   ["ApplyFormWithdrawModel", APPROVAL_ACTION_CONTRACT],
@@ -3046,6 +3105,7 @@ const COLLECTION_RESOURCE_REQUIRED = /* @__PURE__ */ new Set([
   "GridCardBlockModel",
   "MapBlockModel",
   "CommentsBlockModel",
+  "RecordHistoryBlockModel",
   ...import_approval.APPROVAL_FORM_BLOCK_USES,
   ...import_approval.APPROVAL_DETAILS_BLOCK_USES
 ]);
@@ -3118,7 +3178,10 @@ const actionRegistry = [
     scene: "collection",
     use: "FilterActionModel",
     ownerPlugin: CORE_FLOW_SURFACE_OWNER_PLUGIN,
-    allowedContainerUses: COLLECTION_BLOCK_AND_KANBAN_ACTION_CONTAINER_USES,
+    allowedContainerUses: [
+      ...COLLECTION_BLOCK_AND_KANBAN_ACTION_CONTAINER_USES,
+      ...import_action_scope.RECORD_HISTORY_BLOCK_ACTION_CONTAINER_USES
+    ],
     createSupported: true
   },
   {
@@ -3148,7 +3211,30 @@ const actionRegistry = [
     scene: "collection",
     use: "RefreshActionModel",
     ownerPlugin: CORE_FLOW_SURFACE_OWNER_PLUGIN,
-    allowedContainerUses: COLLECTION_BLOCK_AND_KANBAN_ACTION_CONTAINER_USES,
+    allowedContainerUses: [
+      ...COLLECTION_BLOCK_AND_KANBAN_ACTION_CONTAINER_USES,
+      ...import_action_scope.RECORD_HISTORY_BLOCK_ACTION_CONTAINER_USES
+    ],
+    createSupported: true
+  },
+  {
+    publicKey: "expandAll",
+    label: "Expand all",
+    scope: "block",
+    scene: "collection",
+    use: "RecordHistoryExpandActionModel",
+    ownerPlugin: "@nocobase/plugin-record-history",
+    allowedContainerUses: import_action_scope.RECORD_HISTORY_BLOCK_ACTION_CONTAINER_USES,
+    createSupported: true
+  },
+  {
+    publicKey: "collapseAll",
+    label: "Collapse all",
+    scope: "block",
+    scene: "collection",
+    use: "RecordHistoryCollapseActionModel",
+    ownerPlugin: "@nocobase/plugin-record-history",
+    allowedContainerUses: import_action_scope.RECORD_HISTORY_BLOCK_ACTION_CONTAINER_USES,
     createSupported: true
   },
   {
@@ -3331,6 +3417,16 @@ const actionRegistry = [
     allowedContainerUses: import_action_scope.COLLECTION_BLOCK_ACTION_CONTAINER_USES,
     createSupported: true
   },
+  {
+    publicKey: "aiEmployee",
+    label: "AI employee",
+    scope: "block",
+    scene: "collection",
+    use: AI_EMPLOYEE_ACTION_USE,
+    ownerPlugin: AI_EMPLOYEE_FLOW_SURFACE_OWNER_PLUGIN,
+    allowedContainerUses: COLLECTION_BLOCK_AND_KANBAN_ACTION_CONTAINER_USES,
+    createSupported: true
+  },
   {
     publicKey: "duplicate",
     label: "Duplicate",
@@ -3401,6 +3497,36 @@ const actionRegistry = [
     allowedContainerUses: import_action_scope.RECORD_ACTION_CONTAINER_USES,
     createSupported: true
   },
+  {
+    publicKey: "edit",
+    label: "Edit",
+    scope: "record",
+    scene: "record",
+    use: "EditCommentActionModel",
+    ownerPlugin: "@nocobase/plugin-comments",
+    allowedContainerUses: import_action_scope.COMMENT_RECORD_ACTION_CONTAINER_USES,
+    createSupported: true
+  },
+  {
+    publicKey: "delete",
+    label: "Delete",
+    scope: "record",
+    scene: "record",
+    use: "DeleteCommentActionModel",
+    ownerPlugin: "@nocobase/plugin-comments",
+    allowedContainerUses: import_action_scope.COMMENT_RECORD_ACTION_CONTAINER_USES,
+    createSupported: true
+  },
+  {
+    publicKey: "quoteReply",
+    label: "Quote reply",
+    scope: "record",
+    scene: "record",
+    use: "QuoteReplyActionModel",
+    ownerPlugin: "@nocobase/plugin-comments",
+    allowedContainerUses: import_action_scope.COMMENT_RECORD_ACTION_CONTAINER_USES,
+    createSupported: true
+  },
   {
     publicKey: "updateRecord",
     label: "Update record",
@@ -3451,6 +3577,16 @@ const actionRegistry = [
     allowedContainerUses: import_action_scope.RECORD_ACTION_CONTAINER_USES,
     createSupported: true
   },
+  {
+    publicKey: "aiEmployee",
+    label: "AI employee",
+    scope: "record",
+    scene: "record",
+    use: AI_EMPLOYEE_ACTION_USE,
+    ownerPlugin: AI_EMPLOYEE_FLOW_SURFACE_OWNER_PLUGIN,
+    allowedContainerUses: import_action_scope.RECORD_ACTION_CONTAINER_USES,
+    createSupported: true
+  },
   {
     publicKey: "submit",
     label: "Submit",
@@ -3491,6 +3627,16 @@ const actionRegistry = [
     allowedContainerUses: import_action_scope.FORM_ACTION_CONTAINER_USES,
     createSupported: true
   },
+  {
+    publicKey: "aiEmployee",
+    label: "AI employee",
+    scope: "form",
+    scene: "form",
+    use: AI_EMPLOYEE_ACTION_USE,
+    ownerPlugin: AI_EMPLOYEE_FLOW_SURFACE_OWNER_PLUGIN,
+    allowedContainerUses: import_action_scope.FORM_ACTION_CONTAINER_USES,
+    createSupported: true
+  },
   {
     publicKey: "submit",
     label: "Submit",

package/dist/server/flow-surfaces/chart-config.d.ts

@@ -36,63 +36,66 @@ export type ChartStyleValueSupport = {
     max?: number;
     description?: string;
 };
-export declare function deriveChartSemanticState(configure: any): Partial<{
-    query: Partial<{
-        mode: string;
-        sql: any;
-        sqlDatasource: any;
-    }> | Partial<{
-        mode: any;
-        resource: {
-            dataSourceKey: string;
-            collectionName: string;
-        };
-        measures: any;
-        dimensions: any;
-        filter: any;
-        sorting: Partial<{
-            field: any;
-            direction: string;
-            nulls: any;
-        }>[];
-        limit: any;
-        offset: any;
-    }>;
-    visual: Partial<{
-        mode: string;
-        raw: any;
-    }> | Partial<{
-        style?: Partial<{
-            legend: any;
-            tooltip: any;
-            label: any;
-            boundaryGap: any;
-            xAxisLabelRotate: any;
-            yAxisSplitLine: any;
-            smooth: any;
-            stack: any;
-            radiusInner: any;
-            radiusOuter: any;
-            labelType: any;
-            sort: any;
-            minSize: any;
-            maxSize: any;
-        }>;
-        mappings?: Partial<{
-            x: any;
-            y: any;
-            category: any;
-            value: any;
-            series: any;
-            size: any;
-        }>;
-        mode: string;
-        type: string;
+type DerivedChartResource = {
+    dataSourceKey: string;
+    collectionName: string;
+};
+type DerivedSqlChartQuery = {
+    mode: 'sql';
+    sql?: any;
+    sqlDatasource?: any;
+};
+type DerivedBuilderChartQuery = {
+    mode: 'builder';
+    resource?: DerivedChartResource | null;
+    measures?: any;
+    dimensions?: any;
+    filter?: any;
+    sorting?: any[];
+    limit?: any;
+    offset?: any;
+};
+type DerivedChartQuery = DerivedSqlChartQuery | DerivedBuilderChartQuery;
+type DerivedChartSemanticState = {
+    query?: DerivedChartQuery;
+    visual?: ReturnType<typeof deriveChartVisual>;
+    events?: ReturnType<typeof deriveChartEvents>;
+};
+declare function deriveChartVisual(configure: any): Partial<{
+    mode: string;
+    raw: any;
+}> | Partial<{
+    style?: Partial<{
+        legend: any;
+        tooltip: any;
+        label: any;
+        boundaryGap: any;
+        xAxisLabelRotate: any;
+        yAxisSplitLine: any;
+        smooth: any;
+        stack: any;
+        radiusInner: any;
+        radiusOuter: any;
+        labelType: any;
+        sort: any;
+        minSize: any;
+        maxSize: any;
     }>;
-    events: Partial<{
-        raw: any;
+    mappings?: Partial<{
+        x: any;
+        y: any;
+        category: any;
+        value: any;
+        series: any;
+        size: any;
     }>;
+    mode: string;
+    type: string;
+}>;
+declare function deriveChartEvents(configure: any): Partial<{
+    raw: any;
 }>;
+export declare function deriveChartSemanticState(configure: any): DerivedChartSemanticState;
 export declare function getChartBuilderResourceInit(configure: any): {
     dataSourceKey: string;
     collectionName: string;
@@ -119,3 +122,4 @@ export declare function canonicalizeChartConfigure(configure: any): Record<strin
 export declare function buildChartConfigureFromSemanticChanges(currentConfigure: any, changes: Record<string, any>): any;
 export declare function isChartBuilderQuery(configure: any): boolean;
 export declare function getChartVisualCommonStyleKeys(): string[];
+export {};

package/dist/server/flow-surfaces/chart-config.js

@@ -499,6 +499,19 @@ function normalizeChartDimension(input, index) {
     alias: normalizeOptionalTrimmedString(normalized.alias, `${label}.alias`)
   });
 }
+function normalizeBuilderCountMeasureFieldForRuntime(measure, dimensions) {
+  if (measure.aggregation !== "count" || measure.distinct || aliasOfFieldValue(measure.field) !== "id") {
+    return measure;
+  }
+  const fallbackDimension = import_lodash.default.castArray(dimensions || []).find((dimension) => aliasOfFieldValue(dimension == null ? void 0 : dimension.field));
+  if (!fallbackDimension) {
+    return measure;
+  }
+  return {
+    ...measure,
+    field: import_lodash.default.cloneDeep(fallbackDimension.field)
+  };
+}
 function normalizeChartSortingItem(input, index) {
   const label = `chart query.sorting[${index}]`;
   const normalized = ensurePlainObject(input, label);
@@ -846,15 +859,15 @@ function assertBuilderRuntimeCompatibleSorting(query, sorting) {
 }
 function normalizeBuilderQuery(query) {
   const resource = normalizeMergedChartResource(query, { required: true });
-  const measures = Array.isArray(query.measures) ? query.measures.map((item, index) => normalizeChartMeasure(item, index)) : (() => {
+  const dimensions = import_lodash.default.isUndefined(query.dimensions) ? void 0 : Array.isArray(query.dimensions) ? query.dimensions.map((item, index) => normalizeChartDimension(item, index)) : (() => {
+    throw new import_errors.FlowSurfaceBadRequestError("chart query.dimensions must be an array");
+  })();
+  const measures = Array.isArray(query.measures) ? query.measures.map((item, index) => normalizeChartMeasure(item, index)).map((measure) => normalizeBuilderCountMeasureFieldForRuntime(measure, dimensions)) : (() => {
     throw new import_errors.FlowSurfaceBadRequestError("chart query.measures must be an array");
   })();
   if (!measures.length) {
     throw new import_errors.FlowSurfaceBadRequestError("chart query.measures cannot be empty");
   }
-  const dimensions = import_lodash.default.isUndefined(query.dimensions) ? void 0 : Array.isArray(query.dimensions) ? query.dimensions.map((item, index) => normalizeChartDimension(item, index)) : (() => {
-    throw new import_errors.FlowSurfaceBadRequestError("chart query.dimensions must be an array");
-  })();
   const rawSorting = hasOwn(query, "sorting") ? query.sorting : query.orders;
   const sorting = import_lodash.default.isUndefined(rawSorting) ? void 0 : Array.isArray(rawSorting) ? rawSorting.map((item, index) => normalizeChartSortingItem(item, index)) : (() => {
     throw new import_errors.FlowSurfaceBadRequestError("chart query.sorting must be an array");
@@ -1128,7 +1141,7 @@ function deriveChartQuery(configure) {
     });
   }
   return buildDefinedObject({
-    mode: query.mode || "builder",
+    mode: "builder",
     resource: getChartBuilderResourceInit(configure),
     measures: import_lodash.default.cloneDeep(query.measures),
     dimensions: import_lodash.default.cloneDeep(query.dimensions),

package/dist/server/flow-surfaces/compose-compiler.d.ts

@@ -113,4 +113,4 @@ export declare function compileComposeExecutionPlan(input: {
     layout?: FlowSurfaceComposeObject;
 }): FlowSurfaceCompiledComposePlan;
 export declare function resolveComposeFieldContainerSource(blockSpec: Pick<FlowSurfaceComposeNormalizedBlockSpec, 'type'>): 'block' | 'item';
-export declare function resolveComposeTargetKey(targetKey: string, keyMap: Record<string, FlowSurfaceComposeTargetKey | undefined>, kind: 'field' | 'layout' | 'tree connectFields'): string;
+export declare function resolveComposeTargetKey(targetKey: string, keyMap: Record<string, FlowSurfaceComposeTargetKey | undefined>, kind: string): string;

package/dist/server/flow-surfaces/compose-runtime.d.ts

@@ -67,6 +67,7 @@ export type FlowSurfaceComposeRuntimeDeps = {
     createBlock: (payload: Record<string, unknown>, spec: FlowSurfaceComposeNormalizedBlockSpec) => Promise<FlowSurfaceComposeBlockResult>;
     applyNodeSettings?: (actionName: string, targetUid: string | undefined, settings?: FlowSurfaceComposeObject) => Promise<void>;
     resolveBlockSettings?: (settings: FlowSurfaceComposeObject, state: FlowSurfaceComposeRuntimeState, block: FlowSurfaceComposeRuntimeBlockState) => FlowSurfaceComposeObject | Promise<FlowSurfaceComposeObject>;
+    resolveActionSettings?: (settings: FlowSurfaceComposeObject, state: FlowSurfaceComposeRuntimeState, block: FlowSurfaceComposeRuntimeBlockState, action: FlowSurfaceComposeNormalizedActionSpec, actionName: string) => FlowSurfaceComposeObject | Promise<FlowSurfaceComposeObject>;
     createField: (payload: Record<string, unknown>, spec: FlowSurfaceComposeNormalizedFieldSpec, blockResult: FlowSurfaceComposeBlockResult) => Promise<FlowSurfaceComposeFieldResult | null>;
     applyFieldSettings?: (actionName: string, result: FlowSurfaceComposeFieldResult, settings?: FlowSurfaceComposeObject) => Promise<void>;
     onFieldError?: (input: {

package/dist/server/flow-surfaces/compose-runtime.js

@@ -225,18 +225,21 @@ async function applyBlockFieldLayouts(deps, state) {
 async function createActions(plan, deps, state) {
   for (const actionTask of plan.actions) {
     const block = requireBlockState(actionTask.blockKey, state);
+    const settings = await resolveComposeActionSettings(deps, state, block, actionTask.spec, "compose action");
+    const shouldPassSettingsDuringCreate = actionTask.spec.type === "aiEmployee" && hasInlineSettings(settings);
     const createdAction = await deps.createAction(
       {
         target: {
           uid: block.result.uid
         },
-        ...actionTask.payload
+        ...actionTask.payload,
+        ...shouldPassSettingsDuringCreate ? { settings } : {}
       },
       actionTask.spec,
       block.result
     );
-    if (deps.applyNodeSettings && hasInlineSettings(actionTask.spec.settings)) {
-      await deps.applyNodeSettings("compose action", createdAction.uid, actionTask.spec.settings);
+    if (deps.applyNodeSettings && hasInlineSettings(settings) && !shouldPassSettingsDuringCreate) {
+      await deps.applyNodeSettings("compose action", createdAction.uid, settings);
     }
     if (deps.applyActionPopup && shouldApplyActionPopupAfterEffect(actionTask.spec)) {
       await deps.applyActionPopup("compose action", createdAction.uid, actionTask.spec.popup);
@@ -248,12 +251,21 @@ async function createActions(plan, deps, state) {
 async function createRecordActions(plan, deps, state) {
   for (const recordActionTask of plan.recordActions) {
     const block = requireBlockState(recordActionTask.blockKey, state);
+    const settings = await resolveComposeActionSettings(
+      deps,
+      state,
+      block,
+      recordActionTask.spec,
+      "compose recordAction"
+    );
+    const shouldPassSettingsDuringCreate = recordActionTask.spec.type === "aiEmployee" && hasInlineSettings(settings);
     const createdAction = await deps.createRecordAction(
       {
         target: {
           uid: block.result.uid
         },
-        ...recordActionTask.payload
+        ...recordActionTask.payload,
+        ...shouldPassSettingsDuringCreate ? { settings } : {}
       },
       recordActionTask.spec,
       block.result
@@ -265,8 +277,8 @@ async function createRecordActions(plan, deps, state) {
         actionsColumnUid: createdAction.parentUid
       };
     }
-    if (deps.applyNodeSettings && hasInlineSettings(recordActionTask.spec.settings)) {
-      await deps.applyNodeSettings("compose recordAction", createdAction.uid, recordActionTask.spec.settings);
+    if (deps.applyNodeSettings && hasInlineSettings(settings) && !shouldPassSettingsDuringCreate) {
+      await deps.applyNodeSettings("compose recordAction", createdAction.uid, settings);
     }
     if (deps.applyActionPopup && shouldApplyActionPopupAfterEffect(recordActionTask.spec)) {
       await deps.applyActionPopup("compose recordAction", createdAction.uid, recordActionTask.spec.popup);
@@ -311,6 +323,12 @@ async function applyComposeLayout(plan, deps, state) {
     ...layoutPayload
   });
 }
+async function resolveComposeActionSettings(deps, state, block, action, actionName) {
+  if (!hasInlineSettings(action.settings)) {
+    return action.settings;
+  }
+  return deps.resolveActionSettings ? await deps.resolveActionSettings(action.settings || {}, state, block, action, actionName) : action.settings;
+}
 function requireBlockState(blockKey, state) {
   const matched = state.blocks.find((block) => block.spec.key === blockKey);
   if (!matched) {

package/dist/server/flow-surfaces/configure-options.js

@@ -395,9 +395,19 @@ const MAP_OPTIONS = {
 const COMMENTS_OPTIONS = {
   ...COMMON_BLOCK_HEADER_OPTIONS,
   resource: COMMON_RESOURCE,
-  pageSize: numberOption("Page size", { example: 20 }),
+  pageSize: numberOption("Page size", { enum: [5, 10, 20, 50, 100, 200], example: 20 }),
   dataScope: FILTER_GROUP
 };
+const RECORD_HISTORY_OPTIONS = {
+  ...COMMON_BLOCK_HEADER_OPTIONS,
+  resource: COMMON_RESOURCE,
+  sortOrder: objectOption("History sort order", { example: { order: "desc" } }),
+  dataScope: FILTER_GROUP,
+  expand: objectOption("Expansion state", { example: { expand: true } }),
+  template: objectOption('Record-history template binding. Only { apply: "current" } is public.', {
+    example: { apply: "current" }
+  })
+};
 const JS_BLOCK_OPTIONS = {
   title: stringOption("Title", { example: "Runtime Banner" }),
   description: stringOption("Description", { example: "Custom JS block" }),
@@ -619,6 +629,30 @@ const ACTION_EMAIL_OPTIONS = {
   emailFieldNames: arrayOption("Email field name list", { example: ["email"] }),
   defaultSelectAllRecords: booleanOption("Whether all records are selected by default", { example: false })
 };
+const ACTION_AI_EMPLOYEE_OPTIONS = {
+  username: stringOption("AI employee username", { example: "dex" }),
+  auto: booleanOption("Whether the single configured task is prepared automatically", { example: false }),
+  workContext: arrayOption("Top-level AI work context. Use target=self or a same-blueprint block key before write.", {
+    example: [{ type: "flow-model", target: "self" }]
+  }),
+  tasks: arrayOption("AI employee task definitions", {
+    example: [
+      {
+        title: "Analyze current record",
+        message: {
+          system: "Use the current UI context.",
+          user: "Analyze the current record and suggest next steps.",
+          workContext: [{ type: "flow-model", target: "self" }]
+        },
+        autoSend: false,
+        skillSettings: { skills: [], tools: [] },
+        model: null,
+        webSearch: false
+      }
+    ]
+  }),
+  style: objectOption("Avatar style", { example: { size: 40, mask: false } })
+};
 const CALENDAR_ACTION_POSITION_OPTIONS = {
   position: stringOption("Position", { enum: ["left", "right"], example: "left" })
 };
@@ -674,6 +708,8 @@ function getActionConfigureOptionsByUse(use) {
   const base = [ACTION_COMMON_OPTIONS];
   const merged = (...extra) => mergeOptions(...base, ...extra);
   switch (normalized) {
+    case "AIEmployeeButtonModel":
+      return mergeOptions(ACTION_AI_EMPLOYEE_OPTIONS);
     case "CalendarTodayActionModel":
       return merged(CALENDAR_ACTION_POSITION_OPTIONS, ACTION_LINKAGE_OPTIONS);
     case "CalendarNavActionModel":
@@ -840,6 +876,9 @@ function getConfigureOptionsForUse(use) {
     case "CommentsBlockModel":
       options = cloneOptions(COMMENTS_OPTIONS);
       break;
+    case "RecordHistoryBlockModel":
+      options = cloneOptions(RECORD_HISTORY_OPTIONS);
+      break;
     case "JSBlockModel":
       options = cloneOptions(JS_BLOCK_OPTIONS);
       break;