Function resolveBlockReference

apps/sim/executor/utils/block-reference.ts:209–249

(
  blockName: string,
  pathParts: string[],
  context: BlockReferenceContext,
  options: {
    allowLargeValueRefs?: boolean
    executionContext?: ResolutionContext['executionContext']
  } = {}
)

}

export function resolveBlockReference(
  blockName: string,
  pathParts: string[],
  context: BlockReferenceContext,
  options: {
    allowLargeValueRefs?: boolean
    executionContext?: ResolutionContext['executionContext']
  } = {}
): BlockReferenceResult | undefined {
  const normalizedName = normalizeName(blockName)
  const blockId = context.blockNameMapping[normalizedName]

  if (!blockId) {
    return undefined
  }

  const blockOutput = context.blockData[blockId]

  // When the block has not produced any output (e.g. it lives on a branched
  // path that wasn't taken), resolve the reference to undefined without
  // validating against the declared schema. Callers map this to an empty
  // value so that references to skipped blocks don't fail the workflow.
  if (blockOutput === undefined) {
    return { value: undefined, blockId }
  }

  if (pathParts.length === 0) {
    return { value: blockOutput, blockId }
  }

  const value = navigatePath(blockOutput, pathParts, options)

  const schema = context.blockOutputSchemas?.[blockId]
  if (value === undefined && schema) {
    if (!isPathInSchema(schema, pathParts)) {
      throw new InvalidFieldError(blockName, pathParts.join('.'), getSchemaFieldNames(schema))
    }
  }

  return { value, blockId }
}

export async function resolveBlockReferenceAsync(
  blockName: string,