@nocobase/plugin-flow-engine 2.1.0-beta.35 → 2.1.0-beta.37

package/dist/server/flow-surfaces/authoring-validation.js

@@ -69,6 +69,8 @@ const FIELD_GRID_BLOCK_TYPES = /* @__PURE__ */ new Set(["createForm", "editForm"
 const DEFAULT_FORM_BEHAVIOR_REACTION_FORM_BLOCK_TYPES = /* @__PURE__ */ new Set(["createForm", "editForm"]);
 const SORTABLE_BLOCK_TYPES = /* @__PURE__ */ new Set(["table", "details", "list", "tree", "kanban", "gridCard", "map"]);
 const CHART_BLOCK_TYPES = /* @__PURE__ */ new Set(["chart"]);
+const COMMENTS_PAGE_SIZE_VALUES = /* @__PURE__ */ new Set([5, 10, 20, 50, 100, 200]);
+const RECORD_HISTORY_INTERNAL_COLLECTIONS = /* @__PURE__ */ new Set(["recordHistories", "recordFieldHistories"]);
 const ANT_DESIGN_ICON_NAMES = new Set(Object.keys(antDesignIconAsn || {}));
 const PUBLIC_BLOCK_TYPE_BY_MODEL_USE = {
   TableBlockModel: "table",
@@ -85,6 +87,7 @@ const PUBLIC_BLOCK_TYPE_BY_MODEL_USE = {
   ChartBlockModel: "chart",
   MapBlockModel: "map",
   CommentsBlockModel: "comments",
+  RecordHistoryBlockModel: "recordHistory",
   JSBlockModel: "jsBlock",
   MarkdownBlockModel: "markdown",
   IframeBlockModel: "iframe",
@@ -159,7 +162,8 @@ const TREE_CONNECT_TARGET_BLOCK_USES = /* @__PURE__ */ new Set([
   "GridCardBlockModel",
   "ChartBlockModel",
   "MapBlockModel",
-  "CommentsBlockModel"
+  "CommentsBlockModel",
+  "RecordHistoryBlockModel"
 ]);
 const HIDDEN_POPUP_SETTINGS_KEYS_BY_BLOCK_TYPE = {
   calendar: ["quickCreatePopup", "eventPopup"],
@@ -169,6 +173,7 @@ const SUPPORTED_DEFAULT_FILTER_OPERATORS = buildSupportedDefaultFilterOperators(
 const ACTION_TYPE_ALIASES = /* @__PURE__ */ new Map([
   ["addchild", "addChild"],
   ["addnew", "addNew"],
+  ["aiemployee", "aiEmployee"],
   ["bulkupdate", "bulkUpdate"],
   ["jsitem", "jsItem"],
   ["selectview", "selectView"],
@@ -192,6 +197,7 @@ const CALENDAR_ACTION_TYPE_ALIASES = /* @__PURE__ */ new Map([
 const KANBAN_ACTION_TYPE_ALIASES = /* @__PURE__ */ new Map([
   ["filter", "filter"],
   ["addnew", "addNew"],
+  ["aiemployee", "aiEmployee"],
   ["popup", "popup"],
   ["refresh", "refresh"],
   ["js", "js"],
@@ -283,7 +289,7 @@ async function collectFlowSurfaceAuthoringErrors(actionName, values, context = {
   collectDefaultsShapeErrors(values == null ? void 0 : values.defaults, "$.defaults", errors);
   collectDefaultCollectionFieldGroupSemanticErrors(values == null ? void 0 : values.defaults, validationContext, errors);
   collectDefaultFormBehaviorCompletenessErrors(actionName, values, validationContext, errors);
-  collectApplyBlueprintChartAssetErrors(actionName, values, errors);
+  collectApplyBlueprintChartAssetErrors(actionName, values, validationContext, errors);
   if (actionName === "configure") {
     await collectConfigureErrors(values, errors, validationContext);
     errors.push(...(0, import_runjs_authoring.collectRunJsAuthoringErrors)(actionName, values, validationContext));
@@ -422,13 +428,13 @@ function getAuthoringBlocks(actionName, values) {
   }
   return [];
 }
-function collectApplyBlueprintChartAssetErrors(actionName, values, errors) {
+function collectApplyBlueprintChartAssetErrors(actionName, values, context, errors) {
   var _a;
   if (actionName !== "applyBlueprint") {
     return;
   }
   const chartAssets = _.isPlainObject((_a = values == null ? void 0 : values.assets) == null ? void 0 : _a.charts) ? values.assets.charts : {};
-  collectChartAssetRegistryErrors(chartAssets, "$.assets.charts", errors);
+  collectChartAssetRegistryErrors(chartAssets, "$.assets.charts", context, errors);
   _.castArray((values == null ? void 0 : values.tabs) || []).forEach((tab, tabIndex) => {
     collectChartAssetBlockListErrors(tab == null ? void 0 : tab.blocks, `$.tabs[${tabIndex}].blocks`, chartAssets, errors);
   });
@@ -519,7 +525,7 @@ function collectChartBlockAssetReferenceErrors(block, path, chartAssets, errors)
     });
   }
 }
-function collectChartAssetRegistryErrors(charts, path, errors) {
+function collectChartAssetRegistryErrors(charts, path, context, errors) {
   if (!_.isPlainObject(charts)) {
     return;
   }
@@ -533,11 +539,11 @@ function collectChartAssetRegistryErrors(charts, path, errors) {
       });
       return;
     }
-    collectChartAssetQueryErrors(asset, assetPath, errors);
+    collectChartAssetQueryErrors(asset, assetPath, context, errors);
     collectChartAssetVisualErrors(asset, assetPath, errors);
   });
 }
-function collectChartAssetQueryErrors(asset, path, errors) {
+function collectChartAssetQueryErrors(asset, path, context, errors) {
   const query = asset.query;
   if (!_.isPlainObject(query)) {
     pushAuthoringError(errors, {
@@ -563,9 +569,9 @@ function collectChartAssetQueryErrors(asset, path, errors) {
     collectSqlChartAssetQueryErrors(query, path, errors);
     return;
   }
-  collectBuilderChartAssetQueryErrors(query, path, errors);
+  collectBuilderChartAssetQueryErrors(query, path, context, errors);
 }
-function collectBuilderChartAssetQueryErrors(query, path, errors) {
+function collectBuilderChartAssetQueryErrors(query, path, context, errors) {
   const resource = _.isPlainObject(query.resource) ? query.resource : null;
   if (!String((resource == null ? void 0 : resource.collectionName) || "").trim()) {
     pushAuthoringError(errors, {
@@ -588,6 +594,97 @@ function collectBuilderChartAssetQueryErrors(query, path, errors) {
     "chart-builder-query-forbidden-keys",
     errors
   );
+  collectBuilderChartAssetFieldErrors(query, path, context, errors);
+}
+function normalizeChartAssetFieldPath(input) {
+  if (Array.isArray(input)) {
+    return input.map((item) => String(item || "").trim()).filter(Boolean).join(".");
+  }
+  return String(input || "").trim();
+}
+function collectBuilderChartAssetFieldErrors(query, path, context, errors) {
+  const resource = _.isPlainObject(query.resource) ? query.resource : null;
+  const collectionName = String((resource == null ? void 0 : resource.collectionName) || "").trim();
+  if (!collectionName || typeof context.getCollection !== "function") {
+    return;
+  }
+  const dataSourceKey = String((resource == null ? void 0 : resource.dataSourceKey) || "main").trim() || "main";
+  const collection = context.getCollection(dataSourceKey, collectionName);
+  if (!collection) {
+    return;
+  }
+  const selections = [
+    ..._.castArray(query.measures || []).map((selection, index) => ({
+      selection,
+      fieldPath: `${path}.query.measures[${index}].field`
+    })),
+    ..._.castArray(query.dimensions || []).map((selection, index) => ({
+      selection,
+      fieldPath: `${path}.query.dimensions[${index}].field`
+    }))
+  ];
+  for (const item of selections) {
+    if (!_.isPlainObject(item.selection)) {
+      continue;
+    }
+    const fieldPath = normalizeChartAssetFieldPath(item.selection.field);
+    if (!fieldPath) {
+      continue;
+    }
+    const field = (0, import_service_helpers.resolveFieldFromCollection)(collection, fieldPath);
+    if (!field) {
+      if (collectionHasConcreteField(collection, fieldPath)) {
+        continue;
+      }
+      pushAuthoringError(errors, {
+        path: item.fieldPath,
+        ruleId: "chart-builder-query-field-unknown",
+        message: `flowSurfaces authoring ${item.fieldPath} references unknown field '${fieldPath}' on collection '${dataSourceKey}.${collectionName}'`,
+        details: {
+          fieldPath,
+          dataSourceKey,
+          collectionName
+        }
+      });
+      continue;
+    }
+    if (!fieldPath.includes(".") && (0, import_service_helpers.isAssociationField)(field)) {
+      const suggestion = resolveChartBuilderAssociationSubfieldSuggestion(
+        fieldPath,
+        field,
+        dataSourceKey,
+        context.getCollection
+      );
+      pushAuthoringError(errors, {
+        path: item.fieldPath,
+        ruleId: "chart-builder-query-association-field-requires-subfield",
+        message: `flowSurfaces authoring ${item.fieldPath} references association field '${fieldPath}' directly; use scalar subfield '${suggestion.suggestedFieldPath}' for builder charts`,
+        details: {
+          fieldPath,
+          dataSourceKey,
+          collectionName,
+          ...suggestion
+        }
+      });
+    }
+  }
+}
+function resolveChartBuilderAssociationSubfieldSuggestion(fieldPath, field, dataSourceKey, getCollection) {
+  try {
+    const resolved = (0, import_association_title_field.resolveAssociationSafeTitleField)(field, dataSourceKey, getCollection, { fieldPath });
+    const titleField = (resolved == null ? void 0 : resolved.fieldName) ? String(resolved.fieldName).trim() : "";
+    if (titleField) {
+      return {
+        suggestedFieldPath: `${fieldPath}.${titleField}`,
+        suggestedTitleField: titleField,
+        targetCollectionName: (0, import_service_helpers.getCollectionName)(resolved == null ? void 0 : resolved.targetCollection) || void 0
+      };
+    }
+  } catch {
+  }
+  return {
+    suggestedFieldPath: `${fieldPath}.<field>`
+  };
 }
 function collectSqlChartAssetQueryErrors(query, path, errors) {
   if (!String(query.sql || "").trim()) {
@@ -3089,6 +3186,8 @@ function collectBlockErrors(block, path, errors, localKeys, context) {
     context
   );
   collectSemanticBindingErrors(block, blockType, path, errors, context);
+  collectCommentsBlockErrors(block, blockType, path, errors, context);
+  collectRecordHistoryBlockErrors(block, blockType, path, errors, context);
   collectChartDisplayTitleErrors(block, blockType, path, errors);
   collectTreeTableExplicitFieldsErrors(block, blockType, path, errors, context);
   collectTreeConnectFieldsErrors((_a = block.settings) == null ? void 0 : _a.connectFields, `${path}.settings.connectFields`, errors);
@@ -3387,6 +3486,8 @@ async function collectConfigureErrors(values, errors, context) {
   collectSortingAliasErrors(changes, "$.changes", hostBlockType, errors);
   collectDefaultFilterErrors(changes.defaultFilter, "$.changes.defaultFilter", errors, changesBlock, context);
   collectSemanticBindingErrors(changesBlock, hostBlockType, "$.changes", errors, context);
+  collectCommentsBlockErrors(changesBlock, hostBlockType, "$.changes", errors, context);
+  collectRecordHistoryBlockErrors(changesBlock, hostBlockType, "$.changes", errors, context);
   collectChartDisplayTitleErrors(changes, hostBlockType, "$.changes", errors);
   collectGridCardSettingsErrors(changes, hostBlockType, "$.changes", errors, { directSettings: true });
   collectAssignValuesErrors(changes.assignValues, "$.changes.assignValues", errors, changesBlock, context);
@@ -4083,6 +4184,184 @@ function collectSemanticBindingErrors(block, blockType, blockPath, errors, conte
     });
   });
 }
+function collectCommentsBlockErrors(block, blockType, blockPath, errors, context) {
+  var _a;
+  if (blockType !== "comments") {
+    return;
+  }
+  const settings = _.isPlainObject(block.settings) ? block.settings : block;
+  const settingsPath = _.isPlainObject(block.settings) ? `${blockPath}.settings` : blockPath;
+  if (_.isPlainObject(settings) && hasOwnDefined(settings, "pageSize")) {
+    const pageSize = Number(settings.pageSize);
+    if (!COMMENTS_PAGE_SIZE_VALUES.has(pageSize)) {
+      pushAuthoringError(errors, {
+        path: `${settingsPath}.pageSize`,
+        ruleId: "comments-pageSize-unsupported",
+        message: `flowSurfaces authoring ${settingsPath}.pageSize must be one of ${Array.from(
+          COMMENTS_PAGE_SIZE_VALUES
+        ).join(", ")}`
+      });
+    }
+  }
+  const binding = getResourceBinding(block);
+  if (context.isPopupSurface) {
+    if (binding && binding !== "associatedrecords") {
+      const rawBinding = String(((_a = block == null ? void 0 : block.resource) == null ? void 0 : _a.binding) || (block == null ? void 0 : block.binding) || "").trim() || (binding === "currentrecord" ? "currentRecord" : binding);
+      pushAuthoringError(errors, {
+        path: `${blockPath}.resource.binding`,
+        ruleId: "comments-popup-binding-unsupported",
+        message: `flowSurfaces authoring ${blockPath} comments blocks in popups do not support resource.binding='${rawBinding}'; use resource.binding='associatedRecords'`
+      });
+      return;
+    }
+    if (binding === "associatedrecords") {
+      collectCommentsAssociationFieldErrors(block, blockPath, errors, context);
+    }
+    return;
+  }
+  if (binding === "associatedrecords" || binding === "currentrecord") {
+    pushAuthoringError(errors, {
+      path: `${blockPath}.resource.binding`,
+      ruleId: "comments-page-binding-unsupported",
+      message: `flowSurfaces authoring ${blockPath} comments blocks outside popups require a direct comment template collection resource`
+    });
+    return;
+  }
+  const collection = getBlockCollection(block, context);
+  if (collection && !isCommentTemplateCollection(collection)) {
+    pushAuthoringError(errors, {
+      path: `${blockPath}.resource.collectionName`,
+      ruleId: "comments-collection-template-required",
+      message: `flowSurfaces authoring ${blockPath} comments block requires a comment template collection`,
+      details: {
+        collection: (0, import_service_helpers.getCollectionName)(collection)
+      }
+    });
+  }
+}
+function collectCommentsAssociationFieldErrors(block, blockPath, errors, context) {
+  const associationFieldName = getResourceAssociationFieldName(block);
+  if (!associationFieldName || !context.getCollection) {
+    return;
+  }
+  const sourceCollectionName = String(context.currentCollectionName || context.hostCollectionName || "").trim();
+  if (!sourceCollectionName) {
+    return;
+  }
+  const dataSourceKey = getBlockDataSourceKey(block, context);
+  const sourceCollection = context.getCollection(dataSourceKey, sourceCollectionName);
+  const associationField = sourceCollection ? (0, import_service_helpers.resolveFieldFromCollection)(sourceCollection, (0, import_service_helpers.normalizeFieldPath)(associationFieldName)) : null;
+  if (!associationField || !(0, import_service_helpers.isAssociationField)(associationField)) {
+    return;
+  }
+  const fieldType = String((0, import_service_helpers.getFieldType)(associationField) || "").trim().toLowerCase();
+  const targetCollection = (0, import_service_helpers.resolveFieldTargetCollection)(
+    associationField,
+    dataSourceKey,
+    (nextDataSourceKey, collectionName) => {
+      var _a;
+      return (_a = context.getCollection) == null ? void 0 : _a.call(context, nextDataSourceKey, collectionName);
+    }
+  );
+  if ((fieldType === "hasmany" || fieldType === "belongstomany") && targetCollection && isCommentTemplateCollection(targetCollection)) {
+    return;
+  }
+  pushAuthoringError(errors, {
+    path: `${blockPath}.resource.associationField`,
+    ruleId: "comments-association-field-unsupported",
+    message: `flowSurfaces authoring ${blockPath} associationField '${associationFieldName}' is not available; comments popup blocks require a hasMany or belongsToMany associationField targeting a comment template collection`,
+    details: {
+      associationField: associationFieldName,
+      fieldType,
+      targetCollection: (0, import_service_helpers.getCollectionName)(targetCollection)
+    }
+  });
+}
+function collectRecordHistoryBlockErrors(block, blockType, blockPath, errors, context) {
+  if (blockType !== "recordHistory") {
+    return;
+  }
+  const settings = _.isPlainObject(block.settings) ? block.settings : block;
+  const settingsPath = _.isPlainObject(block.settings) ? `${blockPath}.settings` : blockPath;
+  collectRecordHistorySettingsErrors(settings, settingsPath, errors);
+  const binding = getResourceBinding(block);
+  if (binding === "associatedrecords") {
+    pushAuthoringError(errors, {
+      path: `${blockPath}.resource.binding`,
+      ruleId: "recordHistory-association-resource-unsupported",
+      message: `flowSurfaces authoring ${blockPath} recordHistory blocks do not support resource.binding='associatedRecords'`
+    });
+  }
+  if (binding === "currentrecord" && (!context.isPopupSurface || context.popupScene !== "one")) {
+    pushAuthoringError(errors, {
+      path: `${blockPath}.resource.binding`,
+      ruleId: "recordHistory-currentRecord-popup-required",
+      message: `flowSurfaces authoring ${blockPath} recordHistory resource.binding='currentRecord' is only supported in one-record popup/details scenes`
+    });
+  }
+  const collectionName = getBlockCollectionName(block, context);
+  if (!collectionName) {
+    return;
+  }
+  if (RECORD_HISTORY_INTERNAL_COLLECTIONS.has(collectionName)) {
+    pushAuthoringError(errors, {
+      path: `${blockPath}.resource.collectionName`,
+      ruleId: "recordHistory-internal-collection-unsupported",
+      message: `flowSurfaces authoring ${blockPath} recordHistory does not support internal collection '${collectionName}'`
+    });
+    return;
+  }
+  const collection = getBlockCollection(block, context);
+  if (!collection) {
+    return;
+  }
+  const filterTargetKey = getRecordHistoryDeclaredFilterTargetKey(collection);
+  if (!filterTargetKey || !collectionHasConcreteField(collection, filterTargetKey)) {
+    pushAuthoringError(errors, {
+      path: `${blockPath}.resource.collectionName`,
+      ruleId: "recordHistory-filterTargetKey-required",
+      message: `flowSurfaces authoring ${blockPath} recordHistory requires a real filterTargetKey`,
+      details: {
+        collection: collectionName,
+        filterTargetKey
+      }
+    });
+  }
+}
+function collectRecordHistorySettingsErrors(settings, settingsPath, errors) {
+  var _a;
+  if (!_.isPlainObject(settings)) {
+    return;
+  }
+  if (hasOwnDefined(settings, "sortOrder")) {
+    const order = String(((_a = settings.sortOrder) == null ? void 0 : _a.order) || "").trim();
+    if (!_.isPlainObject(settings.sortOrder) || order !== "asc" && order !== "desc") {
+      pushAuthoringError(errors, {
+        path: `${settingsPath}.sortOrder.order`,
+        ruleId: "recordHistory-sortOrder-unsupported",
+        message: `flowSurfaces authoring ${settingsPath}.sortOrder.order must be 'asc' or 'desc'`
+      });
+    }
+  }
+  if (hasOwnDefined(settings, "expand")) {
+    if (!_.isPlainObject(settings.expand) || typeof settings.expand.expand !== "boolean") {
+      pushAuthoringError(errors, {
+        path: `${settingsPath}.expand.expand`,
+        ruleId: "recordHistory-expand-invalid",
+        message: `flowSurfaces authoring ${settingsPath}.expand.expand must be a boolean`
+      });
+    }
+  }
+  if (hasOwnDefined(settings, "template")) {
+    if (!_.isPlainObject(settings.template) || settings.template.apply !== "current") {
+      pushAuthoringError(errors, {
+        path: `${settingsPath}.template.apply`,
+        ruleId: "recordHistory-template-unsupported",
+        message: `flowSurfaces authoring ${settingsPath}.template only supports apply='current'`
+      });
+    }
+  }
+}
 function collectChartDisplayTitleErrors(block, blockType, blockPath, errors) {
   if (blockType !== "chart" || !_.isPlainObject((block == null ? void 0 : block.settings) || block)) {
     return;
@@ -5350,10 +5629,39 @@ function getResourceBinding(block) {
   var _a;
   return String(((_a = block == null ? void 0 : block.resource) == null ? void 0 : _a.binding) || (block == null ? void 0 : block.binding) || "").trim().toLowerCase();
 }
+function getResourceAssociationFieldName(block) {
+  var _a, _b;
+  return String(
+    (block == null ? void 0 : block.associationField) || ((_a = block == null ? void 0 : block.resource) == null ? void 0 : _a.associationField) || ((_b = block == null ? void 0 : block.resource) == null ? void 0 : _b.associationPathName) || ""
+  ).trim();
+}
 function getFieldTargetName(field) {
   var _a;
   return String((field == null ? void 0 : field.target) || ((_a = field == null ? void 0 : field.options) == null ? void 0 : _a.target) || "").trim();
 }
+function isCommentTemplateCollection(collection) {
+  var _a;
+  return (collection == null ? void 0 : collection.template) === "comment" || ((_a = collection == null ? void 0 : collection.options) == null ? void 0 : _a.template) === "comment";
+}
+function getRecordHistoryDeclaredFilterTargetKey(collection) {
+  var _a, _b;
+  const raw = Array.isArray(collection == null ? void 0 : collection.filterTargetKey) ? collection.filterTargetKey[0] : !_.isUndefined(collection == null ? void 0 : collection.filterTargetKey) ? collection.filterTargetKey : Array.isArray((_a = collection == null ? void 0 : collection.options) == null ? void 0 : _a.filterTargetKey) ? collection.options.filterTargetKey[0] : (_b = collection == null ? void 0 : collection.options) == null ? void 0 : _b.filterTargetKey;
+  return String(raw || "").trim();
+}
+function collectionHasConcreteField(collection, fieldName) {
+  var _a, _b, _c, _d, _e, _f;
+  const normalized = String(fieldName || "").trim();
+  if (!normalized) {
+    return false;
+  }
+  const modelAttributes = (typeof ((_a = collection == null ? void 0 : collection.model) == null ? void 0 : _a.getAttributes) === "function" ? collection.model.getAttributes() : null) || ((_b = collection == null ? void 0 : collection.model) == null ? void 0 : _b.rawAttributes) || ((_c = collection == null ? void 0 : collection.model) == null ? void 0 : _c.attributes) || {};
+  const primaryKeyAttributes = _.castArray(
+    ((_d = collection == null ? void 0 : collection.model) == null ? void 0 : _d.primaryKeyAttributes) || ((_e = collection == null ? void 0 : collection.model) == null ? void 0 : _e.primaryKeyAttribute) || []
+  );
+  const modelAttribute = modelAttributes == null ? void 0 : modelAttributes[normalized];
+  const isModelPrimaryKey = primaryKeyAttributes.includes(normalized) || !!(modelAttribute == null ? void 0 : modelAttribute.primaryKey);
+  return !!((0, import_service_helpers.resolveFieldFromCollection)(collection, normalized) || ((_f = collection == null ? void 0 : collection.getField) == null ? void 0 : _f.call(collection, normalized)) || (0, import_service_helpers.getCollectionFields)(collection).some((field) => (0, import_service_helpers.getFieldName)(field) === normalized) || isModelPrimaryKey);
+}
 function collectDefaultFilterFieldPathError(rawFieldPath, path, block, context, errors) {
   const fieldPath = String(rawFieldPath || "").trim();
   if (!fieldPath || fieldPath.startsWith("$") || fieldPath.startsWith("{{")) {

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

@@ -67,6 +67,8 @@ const APPLY_BLUEPRINT_BLOCK_TYPE_ENUM = [
   "markdown",
   "iframe",
   "chart",
+  "comments",
+  "recordHistory",
   "actionPanel",
   "jsBlock",
   "tree"
@@ -169,7 +171,7 @@ const APPLY_BLUEPRINT_BLOCK_RESOURCE_SHORTHAND_KEYS = [
   "binding",
   "associationField"
 ];
-const APPLY_BLUEPRINT_RECORD_CAPABLE_BLOCK_TYPES = /* @__PURE__ */ new Set(["table", "details", "list", "gridCard"]);
+const APPLY_BLUEPRINT_RECORD_CAPABLE_BLOCK_TYPES = /* @__PURE__ */ new Set(["table", "details", "list", "gridCard", "comments"]);
 const APPLY_BLUEPRINT_FIELD_GRID_BLOCK_TYPES = /* @__PURE__ */ new Set(["createForm", "editForm", "details", "filterForm"]);
 const APPLY_BLUEPRINT_FIELD_GROUP_BLOCK_TYPES = /* @__PURE__ */ new Set(["createForm", "editForm", "details"]);
 const APPLY_BLUEPRINT_AUTO_PROMOTED_RECORD_ACTION_TYPES = /* @__PURE__ */ new Set([
@@ -182,6 +184,7 @@ const APPLY_BLUEPRINT_AUTO_PROMOTED_RECORD_ACTION_TYPES = /* @__PURE__ */ new Se
 const APPLY_BLUEPRINT_DEFAULT_POPUP_ACTION_TYPES = /* @__PURE__ */ new Set(["addNew", "addChild", "view", "edit"]);
 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";
+const AI_EMPLOYEE_ACTION_TYPE = "aiEmployee";
 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`);
@@ -1452,6 +1455,58 @@ function collectTreeConnectTargetKeys(settings, context) {
     return normalizedTarget;
   }).filter(Boolean);
 }
+function collectAIEmployeeWorkContextTargetKeys(value, context) {
+  if (import_lodash.default.isUndefined(value) || value === null) {
+    return [];
+  }
+  if (!Array.isArray(value)) {
+    (0, import_errors.throwBadRequest)(`${context} must be an array`);
+  }
+  return value.map((item, index) => {
+    if (!import_lodash.default.isPlainObject(item)) {
+      (0, import_errors.throwBadRequest)(`${context}[${index}] must be an object`);
+    }
+    if (!Object.prototype.hasOwnProperty.call(item, "target")) {
+      return "";
+    }
+    if (typeof item.target !== "string") {
+      (0, import_errors.throwBadRequest)(`${context}[${index}].target must be 'self' or a string block key`);
+    }
+    const normalizedTarget = item.target.trim();
+    if (!normalizedTarget || normalizedTarget === "self") {
+      return "";
+    }
+    return (0, import_service_utils.normalizeFlowSurfaceComposeKey)(normalizedTarget, `${context}[${index}].target`);
+  }).filter(Boolean);
+}
+function collectAIEmployeeActionSettingsTargetKeys(settings, context) {
+  if (!import_lodash.default.isPlainObject(settings)) {
+    return [];
+  }
+  const targets = [];
+  if (Object.prototype.hasOwnProperty.call(settings, "workContext")) {
+    targets.push(...collectAIEmployeeWorkContextTargetKeys(settings.workContext, `${context}.workContext`));
+  }
+  if (Object.prototype.hasOwnProperty.call(settings, "tasks")) {
+    if (!Array.isArray(settings.tasks)) {
+      (0, import_errors.throwBadRequest)(`${context}.tasks must be an array`);
+    }
+    settings.tasks.forEach((task, taskIndex) => {
+      if (!import_lodash.default.isPlainObject(task)) {
+        (0, import_errors.throwBadRequest)(`${context}.tasks[${taskIndex}] must be an object`);
+      }
+      if (import_lodash.default.isPlainObject(task.message) && Object.prototype.hasOwnProperty.call(task.message, "workContext")) {
+        targets.push(
+          ...collectAIEmployeeWorkContextTargetKeys(
+            task.message.workContext,
+            `${context}.tasks[${taskIndex}].message.workContext`
+          )
+        );
+      }
+    });
+  }
+  return targets;
+}
 function compileTreeConnectSettingsTargets(settings, localBlockKeys, context) {
   if (!import_lodash.default.isPlainObject(settings == null ? void 0 : settings.connectFields) || !Array.isArray(settings.connectFields.targets)) {
     return settings;
@@ -1472,6 +1527,73 @@ function compileTreeConnectSettingsTargets(settings, localBlockKeys, context) {
   });
   return nextSettings;
 }
+function compileAIEmployeeWorkContextTargets(value, localBlockKeys, context) {
+  if (import_lodash.default.isUndefined(value) || value === null) {
+    return [];
+  }
+  if (!Array.isArray(value)) {
+    (0, import_errors.throwBadRequest)(`${context} must be an array`);
+  }
+  return value.map((item, index) => {
+    if (!import_lodash.default.isPlainObject(item)) {
+      (0, import_errors.throwBadRequest)(`${context}[${index}] must be an object`);
+    }
+    if (!Object.prototype.hasOwnProperty.call(item, "target")) {
+      return item;
+    }
+    if (typeof item.target !== "string") {
+      (0, import_errors.throwBadRequest)(`${context}[${index}].target must be 'self' or a string block key`);
+    }
+    const normalizedTarget = item.target.trim();
+    if (!normalizedTarget || normalizedTarget === "self") {
+      return item;
+    }
+    return {
+      ...item,
+      target: resolveTargetBlockKey(item.target, localBlockKeys, `${context}[${index}].target`)
+    };
+  });
+}
+function compileAIEmployeeActionSettingsTargets(settings, localBlockKeys, context) {
+  if (!import_lodash.default.isPlainObject(settings)) {
+    return settings;
+  }
+  let nextSettings = settings;
+  if (Object.prototype.hasOwnProperty.call(settings, "workContext")) {
+    nextSettings = nextSettings === settings ? import_lodash.default.cloneDeep(settings) : nextSettings;
+    nextSettings.workContext = compileAIEmployeeWorkContextTargets(
+      settings.workContext,
+      localBlockKeys,
+      `${context}.settings.workContext`
+    );
+  }
+  if (Object.prototype.hasOwnProperty.call(settings, "tasks")) {
+    if (!Array.isArray(settings.tasks)) {
+      (0, import_errors.throwBadRequest)(`${context}.settings.tasks must be an array`);
+    }
+    nextSettings = nextSettings === settings ? import_lodash.default.cloneDeep(settings) : nextSettings;
+    nextSettings.tasks = settings.tasks.map((task, taskIndex) => {
+      if (!import_lodash.default.isPlainObject(task)) {
+        (0, import_errors.throwBadRequest)(`${context}.settings.tasks[${taskIndex}] must be an object`);
+      }
+      if (!import_lodash.default.isPlainObject(task.message) || !Object.prototype.hasOwnProperty.call(task.message, "workContext")) {
+        return task;
+      }
+      return {
+        ...task,
+        message: {
+          ...task.message,
+          workContext: compileAIEmployeeWorkContextTargets(
+            task.message.workContext,
+            localBlockKeys,
+            `${context}.settings.tasks[${taskIndex}].message.workContext`
+          )
+        }
+      };
+    });
+  }
+  return nextSettings;
+}
 function compileField(input, index, scopePrefix, assets, localBlockKeys, context, popupDefaultsMetadata, defaults, getCollection, popupOptions = {}) {
   if (typeof input === "string") {
     const fieldPath2 = (0, import_private_utils.assertNonEmptyString)(input, `${context}[${index}]`);
@@ -1549,7 +1671,7 @@ function compileField(input, index, scopePrefix, assets, localBlockKeys, context
     popup
   });
 }
-function compileAction(input, index, scopePrefix, assets, context, popupDefaultsMetadata, defaults, getCollection, options = {}) {
+function compileAction(input, index, scopePrefix, assets, localBlockKeys, context, popupDefaultsMetadata, defaults, getCollection, options = {}) {
   var _a, _b, _c, _d, _e, _f;
   const buildActionKey = (localKey2, isExplicit, keyContext) => {
     const key2 = (0, import_service_utils.normalizeFlowSurfaceComposeKey)((0, import_private_utils.buildScopedKey)(scopePrefix, localKey2), keyContext);
@@ -1589,9 +1711,12 @@ function compileAction(input, index, scopePrefix, assets, context, popupDefaults
   const localKey = (0, import_private_utils.normalizeBlueprintLocalKey)(input.key, `${type}_${index + 1}`, `${context}[${index}].key`);
   const key = buildActionKey(localKey, !!hasExplicitKey, `${context}[${index}].key`);
   let settings = resolveAssetSettings(input.settings, input, assets, `${context}[${index}]`);
-  if ((0, import_private_utils.readOptionalString)(input.title) && import_lodash.default.isUndefined(settings.title)) {
+  if (type !== AI_EMPLOYEE_ACTION_TYPE && (0, import_private_utils.readOptionalString)(input.title) && import_lodash.default.isUndefined(settings.title)) {
     settings.title = (0, import_private_utils.readOptionalString)(input.title);
   }
+  if (type === AI_EMPLOYEE_ACTION_TYPE) {
+    settings = compileAIEmployeeActionSettingsTargets(settings, localBlockKeys, `${context}[${index}]`);
+  }
   const popupResult = compilePopup(input.popup, `${key}.popup`, assets, `${context}[${index}].popup`, defaults, {
     ownerActionType: type,
     getCollection,
@@ -1734,6 +1859,19 @@ function compileBlocks(input, scopePrefix, assets, context, defaults, requiredEx
         (0, import_service_utils.normalizeFlowSurfaceComposeKey)(field.target, `${context}[${index}].fields[${fieldIndex}].target`)
       );
     });
+    const collectActionTargets = (items, slot) => {
+      items.forEach((action, actionIndex) => {
+        if (readApplyBlueprintActionType(action) !== AI_EMPLOYEE_ACTION_TYPE || !import_lodash.default.isPlainObject(action)) {
+          return;
+        }
+        collectAIEmployeeActionSettingsTargetKeys(
+          action.settings,
+          `${context}[${index}].${slot}[${actionIndex}]`
+        ).forEach((targetKey) => referencedBlockKeys.add(targetKey));
+      });
+    };
+    collectActionTargets(readOptionalItems(block.actions, `${context}[${index}].actions`), "actions");
+    collectActionTargets(readOptionalItems(block.recordActions, `${context}[${index}].recordActions`), "recordActions");
   });
   rawBlocks.forEach((block, index) => {
     if (!import_lodash.default.isPlainObject(block)) {
@@ -1876,6 +2014,7 @@ function compileBlocks(input, scopePrefix, assets, context, defaults, requiredEx
         actionIndex,
         key,
         assets,
+        blockKeysByLocalKey,
         `${blockContext}.actions`,
         popupDefaultsMetadata,
         defaults,
@@ -1900,6 +2039,7 @@ function compileBlocks(input, scopePrefix, assets, context, defaults, requiredEx
         actionIndex,
         key,
         assets,
+        blockKeysByLocalKey,
         `${blockContext}.recordActions`,
         popupDefaultsMetadata,
         defaults,

package/dist/server/flow-surfaces/blueprint/public-types.d.ts

@@ -170,7 +170,7 @@ export type FlowSurfaceApplyBlueprintActionObjectSpec = {
     chart?: string;
 };
 export type FlowSurfaceApplyBlueprintActionSpec = string | FlowSurfaceApplyBlueprintActionObjectSpec;
-export type FlowSurfaceApplyBlueprintBlockType = 'table' | 'createForm' | 'editForm' | 'details' | 'filterForm' | 'calendar' | 'kanban' | 'list' | 'gridCard' | 'markdown' | 'iframe' | 'chart' | 'actionPanel' | 'jsBlock' | 'tree';
+export type FlowSurfaceApplyBlueprintBlockType = 'table' | 'createForm' | 'editForm' | 'details' | 'filterForm' | 'calendar' | 'kanban' | 'list' | 'gridCard' | 'markdown' | 'iframe' | 'chart' | 'comments' | 'recordHistory' | 'actionPanel' | 'jsBlock' | 'tree';
 export type FlowSurfaceApplyBlueprintBlockSpec = {
     key?: string;
     type?: FlowSurfaceApplyBlueprintBlockType;