Function collectBlockFieldIssues

apps/sim/serializer/index.ts:550–708

(
  block: BlockState,
  blockConfig: any,
  params: Record<string, any>
)

 * result. Single source of truth shared by both, so they can never drift.
 */
export function collectBlockFieldIssues(
  block: BlockState,
  blockConfig: any,
  params: Record<string, any>
): BlockFieldIssues {
  // Disabled blocks and trigger-mode blocks are not validated (mirrors runtime).
  if (block.enabled === false) {
    return { missingRequiredFields: [], inactiveModeValues: [] }
  }
  if (
    block.triggerMode === true ||
    blockConfig.category === 'triggers' ||
    params.triggerMode === true
  ) {
    return { missingRequiredFields: [], inactiveModeValues: [] }
  }

  const missingFields: string[] = []
  const displayAdvancedOptions = block.advancedMode ?? false
  const isTriggerContext = block.triggerMode ?? false
  const isTriggerCategory = blockConfig.category === 'triggers'
  const canonicalIndex = buildCanonicalIndex(blockConfig.subBlocks || [])
  const canonicalModeOverrides = block.data?.canonicalModes
  const allValues = buildSubBlockValues(block.subBlocks)

  // Get the tool configuration to check parameter visibility
  const toolAccess = blockConfig.tools?.access
  const currentToolId = toolAccess?.length > 0 ? selectToolId(blockConfig, params) : null
  const currentTool = currentToolId ? getTool(currentToolId) : null

  // Validate tool parameters (for blocks with tools).
  // Lookup contract: a tool param's value lives under its own paramId in `params`.
  // Block subBlocks align via either `id === paramId` or `canonicalParamId === paramId`.
  if (currentTool) {
    Object.entries(currentTool.params || {}).forEach(([paramId, paramConfig]: [string, any]) => {
      if (paramConfig.required && paramConfig.visibility === 'user-only') {
        const matchingConfigs =
          blockConfig.subBlocks?.filter(
            (sb: any) => sb.id === paramId || sb.canonicalParamId === paramId
          ) || []

        let shouldValidateParam = true

        if (matchingConfigs.length > 0) {
          shouldValidateParam = matchingConfigs.some((subBlockConfig: any) => {
            const includedByMode = shouldSerializeSubBlock(
              subBlockConfig,
              allValues,
              displayAdvancedOptions,
              isTriggerContext,
              isTriggerCategory,
              canonicalIndex,
              canonicalModeOverrides
            )

            const isRequired = (() => {
              if (!subBlockConfig.required) return false
              if (typeof subBlockConfig.required === 'boolean') return subBlockConfig.required